🧠 Brainstormers - AI-Powered Brainstorming Tool

---

✨ Features

🎯 Structured Brainstorming Methods

• Big Mind Mapping - Expand ideas across a wide scope for maximum idea generation
• Reverse Brainstorming - Identify potential problems to reveal innovative solutions
• Role Storming - Adopt different perspectives for diverse insights
• SCAMPER - Apply systematic creative thinking techniques
• Six Thinking Hats - Examine ideas from six different angles
• Starbursting - Generate comprehensive questions using 5W1H

🚀 Modern Tech Stack

• Frontend: Next.js 15 with App Router, React 19, TypeScript
• Styling: Tailwind CSS with custom animations
• UI Components: Radix UI primitives with shadcn/ui
• State Management: Zustand for global state
• AI Integration: OpenAI GPT models with streaming support
• Markdown: React Markdown for rich content display

💡 Key Features

• 🌊 Real-time streaming responses from AI
• 🎨 Beautiful UI with smooth animations and transitions
• 📱 Fully responsive design for all devices
• 🔐 Secure API key management
• 📊 Session history tracking
• 🎯 Structured output with organized idea trees
• 🌙 Dark mode support (coming soon)

🛠️ Installation

Prerequisites

• Node.js 18+ and npm/yarn/pnpm
• OpenAI API key (Get one here)

Quick Start

1. Clone the repository

   git clone https://github.com/Azzedde/brainstormers
   cd brainstormers
   

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install
   

3. Set up environment variables

   cp .env.example .env.local
   

   Add your OpenAI API key to .env.local:

   OPENAI_API_KEY=your-api-key-here
   

4. Run the development server

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev
   

5. Open your browser

   Navigate to http://localhost:3000

📖 Usage Guide

Getting Started

1. Initial Setup: On first visit, you'll be prompted to enter your OpenAI API key
2. Choose a Method: Select from six different brainstorming techniques
3. Enter Your Topic: Describe what you want to brainstorm about
4. Get AI-Powered Ideas: Receive structured, method-specific brainstorming results
5. Explore and Expand: Dive deeper into generated ideas with follow-up questions

Brainstorming Methods Explained

🗺️ Big Mind Mapping

Best for: Initial exploration, broad idea generation

• Generates multiple main branches of ideas
• Each branch expands into detailed sub-ideas
• Perfect for starting new projects

🔄 Reverse Brainstorming

Best for: Problem-solving, risk identification

• Identifies ways to cause the problem
• Flips negative aspects into solutions
• Great for debugging and improvement

🎭 Role Storming

Best for: User experience, stakeholder analysis

• Views topic from different personas
• Generates perspective-specific insights
• Ideal for product development

🔧 SCAMPER

Best for: Product innovation, creative solutions

• Systematic approach using 7 techniques
• Substitute, Combine, Adapt, Modify, Put to another use, Eliminate, Reverse
• Excellent for iterating on existing ideas

🎩 Six Thinking Hats

Best for: Comprehensive analysis, team decisions

• White: Facts and data
• Red: Emotions and intuition
• Black: Risks and caution
• Yellow: Benefits and optimism
• Green: Creativity and alternatives
• Blue: Process and control

⭐ Starbursting

Best for: Planning, thorough exploration

• Generates questions using Who, What, Where, When, Why, How
• Provides detailed answers to each question
• Perfect for project planning

🚀 Deployment

Deploy on Vercel

The easiest way to deploy your Brainstormers app:

1. Click the button above
2. Add your OPENAI_API_KEY in environment variables
3. Deploy!

Manual Deployment

1. Build the application

   npm run build
   

2. Start the production server

   npm start
   

🔧 Configuration

Environment Variables

Variable	Description	Required
OPENAI_API_KEY	Your OpenAI API key	Yes
NEXT_PUBLIC_APP_URL	Your app's URL (for production)	No

Customization

• Styling: Modify src/app/globals.css and Tailwind config
• Methods: Add new brainstorming methods in src/lib/brainstorm/methods.ts
• Prompts: Customize AI prompts in src/lib/brainstorm/prompts.ts

📊 Cost Efficiency

• Average session cost: ~$0.01-0.02
• Optimized prompts for minimal token usage
• Streaming responses for better UX without extra cost

🗺️ Roadmap

• Local LLM support (Ollama integration)
• Export brainstorming results (PDF, Markdown)
• Collaborative brainstorming sessions
• Custom brainstorming method builder
• Integration with note-taking apps
• Mobile app (React Native)
• Voice input support
• Multi-language support

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Inspired by proven brainstorming methodologies
• Built with amazing open-source tools
• Special thanks to the AI/ML community

📞 Contact & Support

• GitHub Issues: Report bugs or request features
• Discussions: Join the conversation

---