Mindmap-powered idea management system with AI assistance.
Ideabank helps you capture, connect, and develop your ideas visually using mindmaps. Instead of linear notes, see how your ideas relate to each other.
- Visual Mindmap — Interactive node-based graph for idea visualization
- Connect Ideas — Link concepts with relationships (parent, related, causes, inspires)
- AI Expand — Let AI help develop your ideas into sub-concepts
- Smart Search — Find ideas by keyword, tag, or connection
- Tags — Organize ideas with custom labels
- Export — Download as PNG, PDF, or JSON
- Node.js 20+
- Docker (for PostgreSQL)
- npm or yarn
# Clone
git clone https://github.com/khamalismadie/ideabank.git
cd ideabank
# Install dependencies
npm install
# Start PostgreSQL
docker-compose up -d
# Setup environment
cp .env.example .env.local
# Setup database
npm run db:push
npm run db:seed
# Start dev server
npm run dev| Command | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Build for production |
npm run start |
Start production server |
npm run lint |
Run ESLint |
npm run typecheck |
Run TypeScript compiler |
npm test |
Run tests |
npm run test:watch |
Run tests in watch mode |
npm run db:push |
Push schema to database |
npm run db:seed |
Seed database with sample data |
npm run db:studio |
Open Prisma Studio |
- Frontend: Next.js 14 + React 18 + React Flow
- Backend: Next.js API Routes
- Database: PostgreSQL 16 + Prisma ORM
- Validation: Zod
- Logging: Pino
- AI: OpenAI / Claude API (optional)
- Testing: Vitest
ideabank/
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── api/ # API routes
│ │ │ ├── health/ # Health check
│ │ │ ├── ideas/ # Idea CRUD
│ │ │ ├── connections/
│ │ │ ├── tags/
│ │ │ └── mindmap/
│ │ ├── layout.tsx
│ │ └── page.tsx
│ └── lib/ # Shared utilities
│ ├── prisma.ts # Prisma client
│ ├── validate.ts # Zod schemas
│ ├── errors.ts # Error handling
│ └── logger.ts # Logging
├── prisma/
│ ├── schema.prisma # Database schema
│ └── seed.ts # Seed script
├── docs/ # Documentation
├── .github/ # CI/CD, templates
└── docker-compose.yml # Local PostgreSQL
GET /api/health
GET /api/ideas # List ideas (supports ?search, ?tagId, ?page, ?limit)
POST /api/ideas # Create idea
GET /api/ideas/:id # Get idea
PUT /api/ideas/:id # Update idea
DELETE /api/ideas/:id # Delete idea
GET /api/connections # List connections
POST /api/connections # Create connection
DELETE /api/connections/:id # Delete connection
GET /api/tags # List tags
POST /api/tags # Create tag
PUT /api/tags/:id # Update tag
DELETE /api/tags/:id # Delete tag
GET /api/tags/:id/ideas # Get ideas by tag
GET /api/mindmap # Get full graph (nodes + edges)
Full API spec: PRD.md
- Architecture - System design and decisions
- Deployment - Vercel, Docker, Railway, self-hosted
- Environment Variables - All configuration options
- Troubleshooting - Common issues and solutions
| Project | Description |
|---|---|
| Component Atlas | Interactive visual map for React codebases — dependency graphs, re-render heatmaps, bundle size analysis |
| PromptKit | Auto-selects and applies prompting frameworks from 56 options for structured AI prompts |
Contributions are welcome! Please read CONTRIBUTING.md first.
To report security vulnerabilities, please see SECURITY.md.