Skip to content

AHMAD-JX/MindFlowAI-Productivity-Platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

MindFlow AI - Productivity Platform

A comprehensive AI-powered productivity platform built with Next.js and Node.js, featuring real-time chat with Gemini AI, image generation, code assistance, and more.

Home Home Home Home Home

πŸš€ Features

πŸ€– AI Chat Assistant

  • Real-time chat with Google Gemini AI
  • Conversation history management
  • Multiple chat modes (Creative, Balanced, Precise)
  • Message regeneration and copying

🎨 Image Generation

  • AI-powered image creation
  • Multiple art styles (Realistic, Artistic, Anime, Cartoon, Abstract)
  • Various image sizes and quality options
  • Gallery management and sharing

πŸ’» Code Assistant

  • AI code generation for multiple languages
  • Code debugging and optimization
  • Support for JavaScript, Python, TypeScript, React, and more
  • Code history and download functionality

πŸ‘€ User Management

  • Secure authentication system
  • User profile management
  • Activity statistics
  • Settings and preferences

πŸ› οΈ Tech Stack

Frontend -

  • Next.js 16 - React frameworks
  • TypeScript - Type safety
  • Tailwind CSS - Styling
  • Framer Motion - Animations
  • Lucide React - Icons
  • Google Generative AI - AI integration

Backend -

  • Node.js - Runtime environment
  • Express.js - Web framework
  • TypeScript - Type safety
  • JWT - Authentication
  • MongoDB - Database (planned)

πŸ“ Project Structure

MindFlow AI - Productivity Platform/
β”œβ”€β”€ frontend/                 # Next.js frontend application
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ app/             # App router pages
β”‚   β”‚   β”‚   β”œβ”€β”€ api/         # API routes
β”‚   β”‚   β”‚   β”œβ”€β”€ dashboard/   # Dashboard page
β”‚   β”‚   β”‚   β”œβ”€β”€ signin/      # Sign in page
β”‚   β”‚   β”‚   └── signup/      # Sign up page
β”‚   β”‚   β”œβ”€β”€ components/      # Reusable components
β”‚   β”‚   └── lib/            # Utility functions
β”‚   β”œβ”€β”€ public/             # Static assets
β”‚   └── package.json        # Frontend dependencies
β”œβ”€β”€ backend/                 # Node.js backend application
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ controllers/    # Route controllers
β”‚   β”‚   β”œβ”€β”€ middleware/     # Custom middleware
β”‚   β”‚   β”œβ”€β”€ models/         # Data models
β”‚   β”‚   β”œβ”€β”€ routes/         # API routes
β”‚   β”‚   └── utils/          # Utility functions
β”‚   └── package.json        # Backend dependencies
└── README.md               # Project documentation

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Google AI API key

Installation

  1. Clone the repository

    git clone https://github.com/AHMAD-JX/MindFlowAI-Productivity-Platform.git
    cd MindFlowAI-Productivity-Platform
  2. Install frontend dependencies

    cd frontend
    npm install
  3. Install backend dependencies

    cd ../backend
    npm install
  4. Set up environment variables

    Create .env.local in the frontend directory:

    GEMINI_API_KEY=your_gemini_api_key_here
    NEXT_PUBLIC_APP_URL=http://localhost:3000
  5. Start the development servers

    Frontend (Terminal 1):

    cd frontend
    npm run dev

    Backend (Terminal 2):

    cd backend
    npm run dev
  6. Open your browser Navigate to http://localhost:3000

πŸ”§ Configuration

Google Gemini API Setup

  1. Visit Google AI Studio
  2. Create a new API key
  3. Add the key to your .env.local file

Environment Variables

  • GEMINI_API_KEY - Your Google Gemini API key
  • NEXT_PUBLIC_APP_URL - Application URL

πŸ“± Usage

AI Chat

  1. Navigate to the Dashboard
  2. Select "AI Chat" from the sidebar
  3. Start a conversation with the AI assistant
  4. Use different modes for various response styles

Image Generation

  1. Go to "Image Generation" section
  2. Describe your desired image
  3. Choose style, size, and quality
  4. Generate and download your images

Code Assistant

  1. Access the "Code Assistant" section
  2. Describe the code you need
  3. Select programming language and complexity
  4. Generate, copy, or download the code

🎨 UI/UX Features

  • Modern Design - Clean, professional interface
  • Dark/Light Mode - Adaptive theming
  • Responsive Layout - Works on all devices
  • Smooth Animations - Enhanced user experience
  • Cursor AI Style - Familiar chat interface

πŸ”’ Security

  • JWT-based authentication
  • Secure API key handling
  • Input validation and sanitization
  • Error handling and logging

πŸš€ Deployment

Frontend (Vercel)

  1. Connect your GitHub repository to Vercel
  2. Set environment variables in Vercel dashboard
  3. Deploy automatically on push

Backend (Railway/Heroku)

  1. Connect your repository
  2. Set environment variables
  3. Deploy with automatic builds

🀝 Contributing

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

πŸ“„ License

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

πŸ‘¨β€πŸ’» Author

AHMAD JX

πŸ™ Acknowledgments

  • Google Gemini AI for powerful language models
  • Next.js team for the amazing framework
  • Tailwind CSS for beautiful styling
  • All open-source contributors

Built with ❀️ by AHMAD JX

About

πŸ’‘ AI Productivity Platform built with Next.js, TypeScript & Node.js, Express.js & MongoDB β€” includes Chat AI, Image Generator, Code Assistant, and more smart tools to boost creativity & workflow.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors