🎨 Doodle AI

Turn any photo into a playful hand-drawn doodle avatar — powered by AI.

🌐 Live Demo • ✨ Skills • 🚀 Quick Start • 🤝 Contributing

---

What is Doodle AI?

Doodle AI is a conversational creative studio that turns your photos into hand-drawn doodle art. Chat with an AI agent, attach a photo, pick a skill — and get a unique doodle avatar, collage, sticker sheet, or gift image in seconds.

Try it now: doodleai.art — 5 free credits on signup, no credit card needed.

---

✨ Skills

Every generation style is a pluggable Skill. Drop in a SKILL.md file and you've added a new creative mode.

+ more coming: Emotional Modes, Seasonal Pack, and community-contributed skills.

---

🖼️ Sample Outputs

---

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│  Browser (Astro 5 SSG + client scripts)             │
│  Chat → Prompt Composer → Skill Picker → Canvas     │
└────────────────────────┬────────────────────────────┘
                         │ POST /api/chat
┌────────────────────────▼────────────────────────────┐
│  Cloudflare Worker (doodleai-agent)                  │
│  Mastra Agent → picks skill → calls generate tool   │
│  Credits: 1/gen, 5 free on signup, refund on fail   │
└────────────────────────┬────────────────────────────┘
                         │ PicX API
┌────────────────────────▼────────────────────────────┐
│  PicX Studio — image generation + CDN hosting       │
│  Permanent URL returned immediately                  │
└─────────────────────────────────────────────────────┘

---

🚀 Quick Start

git clone https://github.com/Type-Think-AI/doodle-ai.git
cd doodle-ai
pnpm install
cp .dev.vars.example .dev.vars
# Fill in: OPENROUTER_API_KEY, PICX_API_KEY, GOOGLE_CLIENT_ID/SECRET, BETTER_AUTH_SECRET
pnpm dev:local

Open http://localhost:4321 — local D1/KV, no Cloudflare account needed.

Environment variables

---

🛠️ Adding a New Skill

Every skill is a self-contained directory under src/mastra/skills/:

src/mastra/skills/your-skill/
├── SKILL.md          # Metadata + agent instructions
└── references/       # Optional supporting docs

1. Create your SKILL.md with frontmatter (id, displayName, category, etc.)
2. Add the generation mode to src/lib/doodle-constants.ts
3. Add the prompt branch in src/mastra/tools/generate-doodle.ts
4. Run pnpm build — the loader validates everything and fails with a helpful message if anything is missing

The build catches broken skills before they can reach production.

---

📁 Project Structure

src/
├── mastra/          # Agent, skills (SKILL.md), and generation tool
├── pages/           # Astro routes (/, /c/[id], /skills/, /settings, /api/*)
├── components/      # UI: Sidebar, Composer, Canvas, Footer, Navbar
├── scripts/app/     # Client controllers (chat, sidebar, media-picker)
├── lib/             # Auth, credits, content, admin queries
├── content/         # Editorial articles (keyword-first URLs)
├── db/              # Drizzle schema (D1)
└── styles/          # Global CSS layers

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Good first issues:

• Add a new skill (just a SKILL.md + prompt branch)
• Improve an existing article in src/content/articles/
• Fix a bug from the issues tab

# Validate your changes
pnpm exec tsc --noEmit
pnpm build
pnpm lint

---

🗺️ Roadmap

• 12 generation skills (avatar, collage, stickers, pet, couple, chibi, crayon, faceless, gift, mood, surprise, full-body)
• tldraw infinite canvas for generated images
• Multiplayer roadmap board (Durable Objects)
• Team workspaces and shared credits
• SEO: keyword-first URLs, JSON-LD, FAQ schema, llms.txt
• Stripe checkout for credit packs
• User-created custom skills
• Video generation (provider-neutral adapter)
• WhatsApp + Discord channel connectors
• Character continuity across generations

---

📄 License

MIT © 2026 Type-Think-AI

---

→ Try Doodle AI free