✨ Features

• 32×32 canvas — the classic pixel art grid size
• 16-color palette — black, white, red, orange, yellow, green, blue, purple, pink, brown, gray, cyan, magenta, dark green, navy, silver
• Click to paint — left-click draws with the selected color
• Right-click to erase — instantly sets pixels to white
• Pen size toggle — 1px, 2px, or 4px brushes
• Fill bucket — flood-fill algorithm (BFS) for coloring contiguous areas
• Undo — up to 20 levels of undo history (Ctrl+Z / ⌘+Z)
• Clear canvas — reset everything with one click
• Export as PNG — downloads a clean 32×32 PNG (no grid lines)
• Grid lines toggle — show or hide the pixel grid
• Dark theme — deep blue-purple background with orange accent
• Responsive — works on desktop and mobile (touch support)
• Keyboard shortcuts — P pen, E eraser, G fill, 1/2/4 pen size, Ctrl+Z undo
• Zero dependencies — single HTML file, no CDN, no build tools
• GitHub Pages ready — just push and publish

🚀 Usage

1. Open index.html in any modern browser.
2. Select a color from the palette.
3. Click on the canvas to paint.
4. Right-click (or use the eraser tool) to remove pixels.
5. Toggle tools: Pen ✏️, Eraser 🧹, Fill 🪣.
6. Adjust pen size with the 1px / 2px / 4px buttons.
7. Hit Undo ↩️ to step back (up to 20 steps).
8. Export your masterpiece with Export PNG 📥.

⌨️ Keyboard Shortcuts

🧠 Architecture

flowchart LR
    A[User Input] --> B{Input Type}
    B -->|Mouse Click| C[getCanvasCoords]
    B -->|Touch Event| C
    B -->|Keyboard| D[onKeyDown]
    C --> E[gridX, gridY]
    E --> F{Current Tool}
    F -->|Pen| G[Paint: set pixel to currentColor]
    F -->|Eraser| H[Erase: set pixel to white]
    F -->|Fill| I[Flood Fill BFS]
    G --> J[render canvas]
    H --> J
    I --> J
    D --> K{Shortcut}
    K -->|P/E/G| L[setTool]
    K -->|1/2/4| M[setPenSize]
    K -->|Ctrl+Z| N[undo]
    J --> O[ctx.clearRect]
    O --> P[Loop: fillRect per pixel]
    P --> Q[Optional: draw grid lines]
    N --> R[Restore snapshot from undoStack]
    R --> J
    S[Export PNG] --> T[Create 32×32 offscreen canvas]
    T --> U[fillRect each pixel at 1×1]
    U --> V[canvas.toDataURL -> download link]

📁 Project Structure

pixel-art/
├── index.html   ← Self-contained editor (HTML + CSS + JS)
├── README.md    ← This file
└── LICENSE      ← MIT

🛠️ Development

This is a single HTML file with everything inlined. No build step required.

# Clone the repository
git clone https://github.com/soumendrak/pixel-art.git
cd pixel-art
# Open locally
open index.html
# or: xdg-open index.html
# or: python3 -m http.server 8000  # then visit http://localhost:8000

Making changes

All the code lives in index.html:

• CSS — in the <style> block (dark theme, responsive layout)
• JavaScript — in the <script> block (drawing engine, flood fill, undo system, event handling)
• HTML — semantic layout with ARIA-friendly controls

🌐 Deployment to GitHub Pages

1. Push this repository to GitHub.
2. Go to Settings > Pages.
3. Select the main branch as the source.
4. Your editor will be live at https://soumendrak.github.io/pixel-art/.

📄 License

MIT © 2026 — See LICENSE for details.

_{Made with 🧡 — zero frameworks, infinite pixels.}