Capture thoughts, find clarity. An AI-powered second brain that structures your mess.
MindFlow is a modern note-taking application designed to help you organize chaotic thoughts into structured, actionable insights. Powered by AI, it transforms raw, unstructured text into clean, organized notes while providing intelligent search and retrieval capabilities.
- AI-Powered Formatting: Automatically structures messy notes into clean Markdown with proper hierarchy
- Multiple Note Types: Support for raw notes, formatted notes, and AI-generated summaries
- Auto-Tagging: Intelligent hashtag generation for easy categorization and discovery
- Pin & Archive: Keep important notes at the top or archive them for later reference
- Second Brain Chat: Ask questions about your notes using RAG (Retrieval-Augmented Generation)
- Intelligent Context: The AI understands your notes and provides accurate, contextual answers
- Natural Language: Query your notes conversationally without worrying about exact keywords
- Dark & Light Themes: Choose between Mocha (dark) and Latte (light) themes
- Smooth Animations: Framer Motion-powered transitions for a polished feel
- Mobile-First Design: Optimized for mobile devices with gesture support
- Responsive Layout: Works seamlessly on all screen sizes
- Privacy-First: All notes are stored locally in your browser—no cloud sync required
- Persistent Data: Your notes survive browser refreshes and sessions
- Easy Export: Clear all data whenever you want with one click
- Language Preservation: The AI respects your note's original language
- No Forced Translation: Content stays in Spanish, English, or any language you use
- Node.js 16+ and npm/pnpm
- Modern web browser (Chrome, Firefox, Safari, Edge)
-
Clone the repository
git clone https://github.com/yourusername/mindflow.git cd mindflow -
Install dependencies
npm install # or pnpm install -
Set up environment variables Create a
.envfile in the root directory:VITE_API_ENDPOINT=https://enter.pollinations.ai/api/generate/v1/chat/completions VITE_API_KEY=your_api_key_here
-
Start the development server
npm run dev
-
Open in your browser Navigate to
http://localhost:3000(or the URL shown in your terminal)
npm run buildThe optimized build will be created in the dist/ directory.
npm run previewmindflow/
├── components/ # React components
│ ├── ChatInterface.tsx # AI chat interface
│ ├── NoteCard.tsx # Individual note display
│ ├── NoteInput.tsx # Note creation/editing
│ ├── Settings.tsx # Settings panel
│ └── ConfirmationModal.tsx # Confirmation dialogs
├── services/ # Business logic
│ ├── ai.ts # AI service & API calls
│ └── storage.ts # Local storage management
├── App.tsx # Main application component
├── types.ts # TypeScript type definitions
├── index.tsx # Application entry point
└── vite.config.ts # Vite configuration
| Layer | Technology |
|---|---|
| Framework | React 19 |
| Build Tool | Vite 6 |
| Language | TypeScript 5.8 |
| Styling | Tailwind CSS |
| Animations | Framer Motion |
| UI Icons | Lucide React |
| Markdown | React Markdown + Remark GFM |
| AI API | Pollinations (Gemini) |
- Tap the + button in the Notes tab
- Write your thoughts (messy or organized)
- Choose a format:
- Raw: Keep your text as-is
- Formatted: Let AI structure it into Markdown
- Summary: Generate a concise summary
- The app automatically generates relevant tags
- Revert to original text if needed with the undo button
- Edit formatted notes anytime
- Go to the Ask AI tab
- Type your question naturally
- The AI searches your notes and provides contextual answers
- Swipe Right: Pin a note to keep it at the top
- Swipe Left: Delete a note
- Archive: Hide notes without deleting them
- Edit: Tap a note to modify its content
- Toggle between Dark and Light themes
- Clear all notes and start fresh
- View app information
MindFlow uses the Pollinations API for AI features. To set it up:
- Get an API key from Pollinations
- Add it to your
.envfile asVITE_API_KEY - Optionally customize the API endpoint with
VITE_API_ENDPOINT
- Theme Colors: Modify Tailwind CSS variables in your CSS files
- AI Behavior: Adjust temperature and prompts in
services/ai.ts - Storage: Configure localStorage limits in
services/storage.ts
- ✅ Chrome/Edge (latest)
- ✅ Firefox (latest)
- ✅ Safari (latest)
- ✅ Mobile browsers (iOS Safari, Chrome Mobile)
Contributions are welcome! To contribute:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Issues: Report bugs on GitHub Issues
- Discussions: Share ideas and feedback in GitHub Discussions
- Email: [mail@aegis-plus.my.id]
- Built with React and Vite
- AI powered by Pollinations
- Icons from Lucide React
- Animations with Framer Motion
Made with ❤️ to help you organize your thoughts