Sprite Dust

Editor local de pixel art e VFX editáveis para jogos.

---

PORTUGUÊS

Sobre

Sprite Dust é uma aplicação web local para desenhar sprites, criar efeitos visuais e montar animações frame-by-frame. O editor combina canvas PixiJS, estado imutável em TypeScript e presets procedurais que geram documentos editáveis.

O projeto não inclui modelo de IA. A geração de VFX é procedural: parâmetros entram em vfx-core, que retorna um PixelDocument com frames, layers e pixels editáveis.

Recursos

• Canvas PixiJS client-only para edição manual de pixel art.
• Ferramentas: Pencil, Eraser, Fill, Picker, Move, Select, Line e Rectangle.
• Brush size 1-16, interpolação de strokes e undo por stroke inteiro.
• Zoom visual de 50% a 800% sem alterar o tamanho real do documento.
• Timeline com seleção múltipla, intervalo por Shift, duplicação, remoção, reorder e duração por frame.
• Layers com visibilidade, lock, opacidade, rename, multi-seleção, reorder e transformação.
• Onion skin para revisar movimento entre frames.
• Presets editáveis: explosion, slash, aura e projectile trail.
• Exportação: spritesheet PNG, ZIP de frames PNG, frame ativo PNG, GIF e .pixelvfx.json.
• Autosave local com recuperação de rascunho.
• Servidor MCP stdio para agentes gerarem projetos sem abrir a UI.

Requisitos

• Node.js >=22
• npm

Começo rápido

npm install
npm run dev

Estrutura do projeto

• apps/web — interface Next.js App Router, React, Tailwind CSS e PixiJS.
• apps/mcp — servidor MCP stdio para geração por agentes.
• packages/pixel-core — documento editável, frames, layers, pixels e operações imutáveis.
• packages/vfx-core — presets procedurais que geram PixelDocument editável.
• packages/export-core — exportação browser-side para PNG, ZIP, GIF e projeto JSON.

Licença

Sprite Dust é publicado sob a Licença MIT.

---

ENGLISH

About

Sprite Dust is a local web application for drawing sprites, creating visual effects, and building frame-by-frame animations. The editor combines a PixiJS canvas, immutable TypeScript state, and procedural presets that generate editable documents.

The project does not include an AI model. VFX generation is procedural: parameters go into vfx-core, which returns a PixelDocument with editable frames, layers, and pixels.

Features

• Client-only PixiJS canvas for manual pixel art editing.
• Tools: Pencil, Eraser, Fill, Picker, Move, Select, Line, and Rectangle.
• Brush size 1-16, stroke interpolation, and per-stroke undo.
• Zoom 50% to 800% without changing document size.
• Timeline with multi-select, Shift range, duplicate, remove, reorder, and per-frame duration.
• Layers with visibility, lock, opacity, rename, multi-select, reorder, and transform operations.
• Onion skin for reviewing motion between frames.
• Editable presets: explosion, slash, aura, and projectile trail.
• Export: spritesheet PNG, frame ZIP, active frame PNG, GIF, and .pixelvfx.json.
• Local autosave with draft recovery.
• MCP stdio server for agents to generate editable projects without opening the UI.

Requirements

• Node.js >=22
• npm

Quick Start

npm install
npm run dev

Project Structure

• apps/web — Next.js App Router, React, Tailwind CSS, and PixiJS.
• apps/mcp — MCP stdio server for agent-based generation.
• packages/pixel-core — editable document, frames, layers, pixels, and immutable operations.
• packages/vfx-core — procedural presets that generate editable PixelDocuments.
• packages/export-core — browser-side export to PNG, ZIP, GIF, and JSON project.

License

Sprite Dust is published under the MIT License.