DogSprite
No description available
Ask AI about DogSprite
Powered by Claude Β· Grounded in docs
I know everything about DogSprite. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
DogSprite
Free, offline, ultra-lightweight pixel art editor for artists & game devs.
Works in your browser. No accounts. No cloud. No install. Just pixels.
dogsprite.org Β |Β Buy Me a Coffee Β |Β Author
What is DogSprite?
DogSprite is a 100% free, offline pixel art sprite editor that runs entirely in your browser. No servers, no subscriptions, no data collection. Your art stays on your machine.
Privacy note: The hosted version at dogsprite.org includes Vercel Analytics for anonymous page view counts (no cookies, no personal data). All drawing, saving, and exporting happens 100% locally β no art data ever leaves your browser.
Built for pixel artists, indie game developers, and anyone who wants a fast, focused tool without the bloat.
Features
- Multi-tab workspace β work on multiple sprites like browser tabs
- Full drawing toolkit β brush, eraser, fill, line, rect, color picker
- Pixel-perfect mode β clean corners, no staircase artifacts
- Stroke stabilizer β smooth freehand lines with adjustable smoothing
- Symmetry painting β horizontal, vertical, or both axes with draggable guides
- Ghost frames (onion skin) β see past/future frames while animating
- Pressure-sensitive β full support for drawing tablets (Wacom, iPad, etc.)
- Layer system β add, duplicate, merge, reorder, opacity, visibility
- Animation timeline β frame management, linked cels, adjustable durations
- Multi-format export β PNG, GIF, spritesheets with Aseprite-compatible JSON
- Session recovery β automatic snapshots, never lose your work
- Import/Export β .dogsprite projects, Aseprite/LibreSprite spritesheet import
- 3,500+ sprite templates β built-in library with live color customization
- Dark & light themes
- Keyboard shortcuts β full shortcut system with in-app reference
- Multi-language β English, Spanish, Japanese
Quick Start
Use it online (recommended)
Go to dogsprite.org β no install needed.
Run locally
git clone https://github.com/systemcrash92/DogSprite.git
cd DogSprite
npm install
npm run dev
Open http://localhost:3000.
Tech Stack
| Technology | Purpose |
|---|---|
| Next.js 16 | App framework |
| React 19 | UI components |
| TypeScript | Type safety |
| Zustand v5 | State management |
| HTML5 Canvas | Pixel rendering |
| TailwindCSS v4 | Styling |
| gifenc | Client-side GIF encoding |
Zero external APIs. Everything runs in your browser.
Project Structure
src/
βββ app/ # Next.js app router
βββ components/ # React components (canvas, editor, tools, palette, layers, timeline)
βββ stores/ # Zustand stores (project, canvas, tool, layer, timeline, palette, history, UI)
βββ lib/ # Core logic (canvas engine, drawing tools, export, AI mock)
βββ hooks/ # Custom hooks (shortcuts, animation, autosave)
βββ types/ # TypeScript interfaces
βββ constants/ # Configuration constants
mcp-server/ # MCP pixel art server (template generation pipeline)
.claude/ # Claude Code agent architecture (agents, skills, rules)
MCP Pixel Art Server
DogSprite includes a built-in MCP (Model Context Protocol) server β an AI-powered pixel art toolkit with 3,900+ hand-crafted sprite templates and 46 drawing tools.
What is MCP?
MCP is an open protocol that lets AI assistants (like Claude, Cursor, Windsurf, etc.) use external tools. DogSprite's MCP server gives any MCP-compatible AI the ability to:
- Draw pixel art β create sprites, set pixels, draw lines/rects/ellipses, fill areas
- Use 3,900+ templates β pre-made sprites in DB16 palette (characters, items, UI, environments, effects, vehicles, and more)
- Layer management β add/merge/reorder layers, set opacity
- Auto-shading β material-aware shadows and highlights
- Export β PNG output of finished sprites
Quick Start
-
Install dependencies:
cd mcp-server npm install npm run build -
Configure your AI tool β add this to your MCP config (e.g.
.mcp.json, Claude Desktop settings, or Cursor config):{ "mcpServers": { "dogsprite-pixel-art": { "command": "node", "args": ["mcp-server/dist/index.js"] } } } -
Ask your AI to draw β example prompts:
- "Draw a fire sword template" β renders
fire_sword_16instantly - "List all food templates" β shows 140+ food/consumable sprites
- "Create a 16x16 health potion with custom colors"
- "Create a 32x32 dungeon torch with shading"
- "Draw a fire sword template" β renders
Template Categories
| Category | Count | Size |
|---|---|---|
| Characters & NPCs | 100+ | 16x16 |
| Food & Consumables | 140+ | 16x16 |
| Buildings & Structures | 100+ | 16x16 |
| UI Elements | 100+ | 16x16 |
| Effects & Particles | 100+ | 16x16 |
| Vehicles & Transport | 100+ | 16x16 |
| Modern & Retro Tech | 200+ | 16x16 |
| Dungeon Creatures | 100+ | 32x32 |
| RPG UI Kit | 100+ | 32x32 |
| ...and 25+ more categories |
All templates use the DB16 palette (16 colors) with professional colored selout outlines and material-aware shading.
MCP Tools (46 commands)
The server exposes 46 tools grouped by category:
| Group | Tools | What they do |
|---|---|---|
| Canvas | create_sprite, resize_sprite, crop_to_content | Create and manage sprites |
| Drawing | set_pixels, draw_line, draw_rect, draw_ellipse, fill_area, draw_smooth_shape | Place pixels and shapes |
| Layers | add_layer, set_active_layer, merge_layers, clear_layer | Layer management |
| Colors | set_palette, replace_color, color_swap, color_ramp, hsb_adjust, invert_colors | Color operations |
| Transform | mirror_horizontal, mirror_vertical, flip_layer, rotate_layer, shift_pixels, copy_region | Transform pixels |
| Effects | auto_shade, auto_highlight, outline_layer, drop_shadow, dither, anti_alias, gradient_fill | Shading and effects |
| Templates | draw_template, list_templates | Browse and render 3,900+ templates |
| Export | export_png, get_preview, get_canvas_state, analyze_sprite | Preview and export |
| Quality | validate_sprite_quality, get_drawing_guide, palette_extract, palette_reduce | Quality checks |
Creating Your Own Templates
The template generator converts ASCII grids or DSL draw commands into TypeScript template files:
cd mcp-server
npx tsx scripts/templateGenerator.ts scripts/batches/my_batch.ts 2>/dev/null > src/templates/myTemplates.ts
See memory/template-quality-guide.md for the full quality guide and .claude/README.md for the AI agent architecture.
Contributing
Contributions are welcome! Whether it's bug fixes, new features, translations, or template designs.
- Fork the repo
- Create your branch (
git checkout -b feature/my-feature) - Commit your changes
- Push and open a Pull Request
Please keep it friendly, keep it local-first.
Support the Project
DogSprite is free and open source. If it helps your workflow, consider supporting development:
Credits
Created by SETO
- Website: setodev.com
- Editor: dogsprite.org
License
MIT License β free for personal and commercial use.
Made with pixels and passion for the game dev community
