ColorDreamer is a magical web application that generates custom children's coloring books using AI. It creates theme-based storylines and high-quality black-and-white line art, compiling them into a downloadable PDF.

• 🎨 AI Image Generation: Creates consistent, thick-line coloring pages.
• 🤖 Multi-Model Support: Works with Google Gemini, OpenAI, Anthropic (Claude), and Ollama (Local).
• 📄 PDF Export: Compiles pages into a print-ready A4 PDF.
• 💬 Creative Chat: Built-in AI assistant to help brainstorm themes.
• 🌍 Multi-language: Supports English, Chinese, Japanese, Korean, Russian, German, and French.

• Node.js (v18 or higher)
• npm or yarn

1. Install Dependencies

   npm install
   

2. Start Dev Server

   npm run dev
   

   Open http://localhost:5173 to view the app.

The app supports multiple AI providers. You can configure them in the Settings (⚙️) menu within the app.

• Google Gemini (Default): Requires an API Key from Google AI Studio.
• OpenAI: Requires an API Key.
• Anthropic: Requires an API Key.
• Ollama (Local):
  • Must be running locally on port 11434.
  • CORS Setup: You must allow browser requests by running Ollama with the OLLAMA_ORIGINS environment variable:

    OLLAMA_ORIGINS="*" ollama serve
    

This project is set up as a standard Vite React app, which makes it very easy to deploy to Vercel or Netlify.

1. Push your code to a Git repository (GitHub/GitLab).
2. Import the project in Vercel/Netlify.
3. The build settings should be detected automatically:
   • Framework: Vite
   • Build Command: npm run build
   • Output Directory: dist
4. Click Deploy.

To build the static files for a traditional web server:

npm run build

The output files will be in the dist folder. Upload these files to your web server (Nginx, Apache, etc.).

• src/: Source code (conceptually root in this setup)
• components/: UI Components (ChatBot, Settings, etc.)
• services/: API logic for Gemini, OpenAI, etc.
• utils/: Helper functions (PDF generation).
• locales.ts: Translation strings.

MIT