• 🎯 Overview
• ✨ Features
• 🛠️ Tech Stack
• 🚀 Quick Start
• 📱 Usage Guide
• 🎨 Screenshots
• 🔮 Roadmap
• 🤝 Contributing
• 👨‍💻 Author
• 📄 License

FeedbackFlow is a comprehensive feedback collection platform designed to bridge the gap between feedback providers and recipients. Built with modern web technologies, it enables seamless anonymous feedback collection, AI-powered suggestions, and easy integration into personal portfolios and professional websites.

• Students and developers lack simple tools to collect user feedback on their projects
• Existing feedback solutions are either too complex or too basic
• No easy way to showcase received feedback on personal websites

FeedbackFlow provides a personalized feedback collection system with:

• One-click setup - Get your unique feedback URL instantly
• AI-powered assistance - Smart suggestions help users write better feedback
• Seamless integration - Embeddable widgets for any website
• Export capabilities - Download and use your feedback data anywhere

• 🌐 Public Profile URLs - Unique, shareable links for feedback collection
• 🤖 AI-Powered Suggestions - Intelligent feedback prompts using Cohere AI
• 👤 Anonymous Collection - Optional anonymous feedback submission
• 📊 Export Functionality - Download feedback data in multiple formats
• 🎨 Embeddable Widgets - Showcase feedback on your website
• 🔐 Secure Authentication - NextAuth.js powered user management

• 📈 Analytics Dashboard - Track feedback trends and insights
• 🎯 Feedback Categories - Organize feedback by type and purpose
• 👥 Team Collaboration - Multi-user feedback management
• 🎨 Custom Branding - Personalize your feedback pages
• 📱 Mobile App - Native mobile experience
• ⚡ Real-time Notifications - Instant feedback alerts

Node.js >= 18.0.0
MongoDB (local or cloud)
Yarn or npm package manager

1. Clone the repository

   git clone https://github.com/Unknownmaster0/feedback-flow.git
   cd feedback-flow

2. Install dependencies

   yarn install
   # or
   npm install

3. Environment Setup Create a .env.local file in the root directory:

   # Database
   MONGODB_URI=your_mongodb_connection_string
   
   # Authentication
   NEXTAUTH_URL=http://localhost:3000
   NEXTAUTH_SECRET=your_super_secret_key
   
   # AI Integration
   COHERE_API_KEY=your_cohere_api_key
   
   # Email (Optional)
   EMAIL_SERVER_USER=your_email@example.com
   EMAIL_SERVER_PASSWORD=your_email_password
   EMAIL_SERVER_HOST=smtp.gmail.com
   EMAIL_SERVER_PORT=587
   EMAIL_FROM=noreply@feedbackflow.com

4. Start the development server

   yarn dev
   # or
   npm run dev

5. Open your browser Navigate to http://localhost:3000

# Build and run with Docker
docker-compose up --build

# Or use the provided Dockerfile
docker build -t feedbackflow .
docker run -p 3000:3000 feedbackflow

1. Sign Up - Create your account using email or OAuth providers
2. Get Your URL - Receive your unique feedback collection link
3. Share Your Link - Add it to your portfolio, email signature, or social media
4. Receive Feedback - Monitor incoming feedback in your dashboard

1. Visit a Profile - Click on any public profile or use a shared link
2. Write Feedback - Use the rich text editor or AI suggestions
3. Choose Privacy - Send anonymously or with your name
4. Submit - Your feedback is delivered instantly

<!-- Add to your website -->
<div id="feedbackflow-widget" data-user="your-username"></div>
<script src="https://feedback-app-pi-two.vercel.app/embed.js"></script>

• JSON Format - For developers and integrations
• CSV Format - For spreadsheets and analysis
• PDF Reports - For presentations and portfolios

• User authentication and profiles
• Feedback collection and display
• AI-powered suggestions
• Basic export functionality
• Responsive web design

• Advanced analytics dashboard
• Feedback categorization and tagging
• Custom branding options
• Team collaboration features
• API for third-party integrations

• Mobile application (React Native)
• Enterprise features and pricing
• Advanced AI insights and sentiment analysis
• White-label solutions
• International localization

• Performance optimizations
• Security enhancements
• User experience improvements
• Feature requests from community

We welcome contributions from the community! Here's how you can help:

Found a bug? Please create an issue with:

• Clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Screenshots if applicable

Have an idea? Open an issue with:

• Detailed feature description
• Use case and benefits
• Mockups or examples (if available)

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Add tests if applicable
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

• Follow TypeScript best practices
• Use ESLint and Prettier for code formatting
• Write meaningful commit messages
• Add documentation for new features
• Ensure responsive design compatibility

• Cohere AI - For powering our intelligent feedback suggestions
• Vercel - For seamless deployment and hosting
• Radix UI - For beautiful, accessible UI components
• Next.js Team - For the amazing React framework
• Open Source Community - For inspiration and support

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

MIT License

Copyright (c) 2025 Sagar Singh