README.md

---
title: MindSpark
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
app_port: 7860
---

# 🧠 MindSpark (AI Notebook)

**MindSpark** is a next-generation AI-powered note-taking and project management platform that transforms your complex ideas into structured, actionable, and detailed project plans.

Powered by Google Gemini models (Gemini 2.5 Flash, Gemini 3 Flash Preview, and Image), this platform takes a simple idea and turns it into a professional workflow.

---

## 🎯 Purpose of the Application

Whether you want to write a novel, develop a new mobile app, start a business, or design an RPG game, you might not know "where to start." **The main goal of MindSpark is to eliminate this starting barrier and act as your "Board of Directors" while bringing your vision to life.**

You just express your idea (or tell it with your voice). MindSpark:
1. **Breaks down** the steps needed to reach your goal.
2. Assigns a **Virtual Agent** (e.g., Database Architect, Fiction Writer, UI/UX Designer) for each step as an expert in that task.
3. Produces the **text, code, or vision image** you need through these agents in seconds.

---

## ✨ Key Features

### 🕵️‍♂️ Dynamic Expert Agent Mechanism
A virtual team of experts is automatically established based on your project type. Tasks don't just stay as a list; they are assigned to agents with roles like *System Architect*, *Content Strategist*, or *Art Director*. You can see which agent took on that job in each note.

### 🪄 Prompt Boost & Voice Input
Struggling to express your idea?
- **Voice to Text:** Just record your idea by speaking. AI transcribes it.
- **Boost:** Transform a short sentence like "I want to make a game" into a rich, technical, and creative command with one click.

### 📦 Automatic Content and Asset Generation
AI generates content planned for each step:
- **Text:** Detailed tutorials, stories, strategies.
- **Code:** Actionable software architectures and code blocks.
- **Image:** High-quality AI-drawn concept art that Comic solidifies your idea.

### ☁️ Cloud Sync and Offline Support
- Log in with your Google account and sync all your projects to the cloud via **Firebase**.
- Even when working offline, your browser memory (Local Storage) keeps your projects safe.

### 📋 Drag, Drop, and Manage
Change the priorities of tasks (steps) with drag-and-drop, mark completed ones, add new tags, files, or audio recordings.

### 📥 Export
Download your massive project file as a highly readable **PDF** document or a developer-friendly **Markdown (.md)** file.

---

## 🚀 How It Works?

1. **Ignite Your Idea:** Type or speak "I want to design a sci-fi base desktop board game" in the box on the main screen.
2. **AI Planning:** The intelligence behind it divides this huge idea into logical steps (e.g., Universe rules, Characters, Game mechanics, Design, etc.) and assigns them to agents.
3. **Production:** MindSpark writes text, generates code, and draws images sequentially according to the content of each step.
4. **Iteration:** Review the results, add your own notes, redraw images by giving feedback, or add new steps.

---

## 🛠️ Tech Stack
* **Frontend:** React 19, TypeScript, Vite
* **Styling & UI:** Tailwind CSS, Framer Motion (Animations), Lucide React (Icons)
* **AI:** `@google/genai` (Gemini 2.5 Flash, Gemini 3 Preview, Gemini 3 Flash Image)
* **Backend / Database:** Firebase (Auth, Firestore)
* **Desktop & File Capabilities:** Vite PWA, dnd-kit (Drag-and-Drop), html2pdf.js / jspdf (PDF Export)

---

## ⚖️ License
This project is licensed under the **MIT License**. 

**What does this mean?**
- You can use, modify, and distribute this project freely.
- The original copyright notice and permission notice must be included in all copies or substantial portions of the software.

---

> *Big ideas deserve great starts. With MindSpark, none of your ideas will remain just a dream.*