DecisionFlow 🧠

A powerful AI-powered decision-making tool that helps you make smarter choices through structured analysis, brainstorming, and intelligent insights. Pure frontend, privacy-first, works offline.

✨ Features

🎯 Decision Making Tools

• SWOT Analysis - Comprehensive strengths, weaknesses, opportunities, and threats analysis
• Decision Matrix - Multi-criteria decision analysis with weighted scoring
• Pros & Cons - Simple yet effective comparison framework
• Decision Trees - Visual decision flow mapping
• Cost-Benefit Analysis - Financial impact assessment

🤖 AI Integration

• Smart Analysis - AI-powered insights and recommendations
• Multiple AI Providers - Support for OpenAI, Anthropic, DeepSeek, and custom endpoints
• Intelligent Suggestions - Context-aware decision guidance
• Natural Language Processing - Convert thoughts into structured analysis

🧠 Brainstorming & Collaboration

• Mind Mapping - Visual idea organization
• Brainstorming Sessions - Structured creative thinking
• Idea Evaluation - Systematic idea assessment
• Team Collaboration - Share and collaborate on decisions

📊 Visualization & Export

• Interactive Charts - Beautiful data visualizations with D3.js and Recharts
• PDF Export - Professional decision reports
• Project Management - Save, organize, and track decision history
• Import/Export - Backup and restore your decision data

🔒 Privacy & Security

• 100% Client-Side - All data stays on your device
• Offline Capable - Works without internet connection
• No Server Required - Zero backend dependencies
• Local Storage - Your decisions remain private

🚀 Quick Start

Prerequisites

• Node.js 16+
• npm or yarn

Installation

1. Clone the repository

   git clone https://github.com/Drinkwang/DecisionFlow.git
   cd DecisionFlow

2. Install dependencies

   npm install

3. Start development server

   npm run dev

4. Open your browser Navigate to http://localhost:5173

One-Click Start (Windows)

Simply double-click start.bat to automatically start the application!

🛠️ Tech Stack

• Frontend: React 18 + TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS
• State Management: Zustand
• Routing: React Router
• Charts: D3.js + Recharts
• Icons: Lucide React
• PDF Generation: jsPDF
• File Handling: JSZip

📱 Usage

1. Configure AI (Optional)

• Go to Settings → AI Configuration
• Add your API key for OpenAI, Anthropic, or DeepSeek
• Or use the tool without AI for basic decision-making

2. Create a Decision

• Navigate to Decision Methods
• Choose your preferred analysis framework
• Fill in the details and criteria

3. Get AI Insights

• Use the AI Analysis feature for intelligent recommendations
• Generate structured insights based on your input

4. Brainstorm Ideas

• Use the Brainstorming module for creative thinking
• Organize ideas with mind mapping tools

5. Export & Share

• Export decisions as PDF reports
• Save projects for future reference
• Import/export data as ZIP files

🏗️ Architecture

DecisionFlow follows a pure frontend architecture:

• No Backend Required - Runs entirely in the browser
• Modular Design - Clean separation of concerns
• Component-Based - Reusable React components
• Type-Safe - Full TypeScript coverage
• Responsive - Works on desktop and mobile

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

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

• Icons by Lucide
• Charts powered by D3.js and Recharts
• UI components inspired by modern design systems

📞 Support

• 🐛 Report Issues
• 💡 Request Features
• 📖 Documentation

---

Make better decisions, faster. 🎯
_{Built with ❤️ for better decision-making}