CodeSeed - AI-Powered Code Generation & Learning Platform

📋 Table of Contents

About CodeSeed
Project Structure
Quick Start
Deployment (Vercel + Render)
Installation
Usage
Features
Technology Stack
Contributing
License
Contact
Troubleshooting

🌱 About CodeSeed

CodeSeed is a full-stack AI-powered code generation and learning platform designed to help developers write better code faster. It combines state-of-the-art artificial intelligence with an intuitive web interface to assist developers in multiple ways:

What CodeSeed Does

Generates Code: Create code snippets in 9+ programming languages and frameworks
Explains Code: Get AI-powered explanations for code concepts
Manages Sessions: Maintain chat history and organize code artifacts
Previews Code: See syntax-highlighted code with live preview
Authenticates Users: Secure login with Google OAuth or email/password

Who It's For

👨‍💻 Developers learning new languages
🏢 Teams collaborating on code
🎓 Students studying programming
🚀 Developers prototyping ideas
🔍 Anyone looking to understand code better

📁 Project Structure

CodeSeed/
├── client/                          ← Frontend (React + Vite)
│   ├── public/
│   │   ├── images/
│   │   └── videos/
│   ├── src/
│   │   ├── components/              ← React components
│   │   ├── constants/               ← Configuration & static data
│   │   ├── context/                 ← Global state (AppContext)
│   │   ├── hooks/                   ← Custom React hooks
│   │   │   ├── useChatAPI.js       ← Chat API operations
│   │   │   └── useAuthAPI.js       ← Authentication API
│   │   ├── pages/                   ← Page components
│   │   │   ├── Chat.jsx            ← Main chat page
│   │   │   ├── Login.jsx           ← Login/signup page
│   │   │   ├── EmailVerify.jsx     ← Email verification
│   │   │   └── ResetPassword.jsx   ← Password reset
│   │   ├── utils/                   ← Utility functions
│   │   │   ├── chatHelpers.js
│   │   │   └── formValidation.js
│   │   ├── App.jsx                  ← Main app component
│   │   ├── index.css                ← Global styles
│   │   └── main.jsx                 ← Entry point
│   ├── package.json
│   ├── vite.config.js
│   ├── eslint.config.js
│   └── README.md                    ← Client-specific documentation
│
├── server/                          ← Backend (Node.js + Express)
│   ├── config/
│   │   ├── db.js                   ← Database configuration
│   ├── services/
│   │   └── emailService.js         ← Brevo email service
│   ├── controllers/
│   │   ├── authController.js       ← Auth logic
│   │   ├── chatController.js       ← Chat logic
│   │   └── userController.js       ← User logic
│   ├── middleware/
│   │   └── userAuth.js             ← Authentication middleware
│   ├── models/
│   │   ├── chatModel.js            ← Chat database model
│   │   └── userModel.js            ← User database model
│   ├── routes/
│   │   ├── authRoutes.js           ← Auth endpoints
│   │   ├── chatRoutes.js           ← Chat endpoints
│   │   └── userRoutes.js           ← User endpoints
│   ├── server.js                    ← Main server file
│   ├── package.json
│   └── .env                         ← Environment variables
│
├── ARCHITECTURE.md                  ← Architecture documentation
├── PROJECT_ORGANIZATION.md          ← File organization guide
├── SETUP_GUIDE.md                   ← Detailed setup guide
└── README.md                        ← This file

🚀 Quick Start

Get CodeSeed running in 5 minutes:

# 1. Clone the repository
git clone <repository-url>
cd CodeSeed

# 2. Install server dependencies
cd server
npm install

# 3. Create server .env file
# Copy .env.example to .env and update with your credentials

# 4. Start server (from server directory)
npm start
# Server running at http://localhost:5000

# 5. In another terminal, install client dependencies
cd ../client
npm install

# 6. Create client .env.local file
# VITE_BACKEND_URL=http://localhost:5000
# VITE_GOOGLE_CLIENT_ID=your_google_client_id

# 7. Start client (from client directory)
npm run dev
# Client running at http://localhost:5173

☁️ Deployment (Vercel + Render)

Deploy frontend on Vercel (client/) and backend on Render (server/).

Full deployment instructions: see DEPLOYMENT.md
Render blueprint file included: render.yaml
Vercel SPA routing config included: client/vercel.json

🔧 Installation

Prerequisites

For Both Client & Server:

Node.js v16 or higher
npm or yarn package manager
Git

For Server:

MongoDB database (local or MongoDB Atlas)
SMTP service for emails (or configure with your provider)
Google OAuth credentials (for Google login feature)

Detailed Setup

1. Clone Repository

git clone <repository-url>
cd CodeSeed

2. Backend Setup

cd server

# Install dependencies
npm install

# Create .env file
cp .env.example .env

# Update .env with your configuration:
# - MONGODB_URI=your_mongodb_connection_string
# - PORT=5000
# - JWT_SECRET=your_jwt_secret_key
# - BREVO_API_KEY=your_brevo_api_key
# - BREVO_SENDER_EMAIL=verified_sender_email
# - APP_NAME=CodeSeed
# - GOOGLE_CLIENT_ID=your_google_client_id
# - GOOGLE_CLIENT_SECRET=your_google_client_secret

# Start the server
npm start
# Or for development with auto-reload:
npm run dev

Server will be available at http://localhost:5000

3. Frontend Setup

# Navigate to client directory
cd ../client

# Install dependencies
npm install

# Create .env.local file
echo "VITE_BACKEND_URL=http://localhost:5000" > .env.local
echo "VITE_GOOGLE_CLIENT_ID=your_google_client_id" >> .env.local

# Start development server
npm run dev

Client will be available at http://localhost:5173

4. Environment Variables Reference

Server (.env)

# Database
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/codeseed

# Server
PORT=5000
NODE_ENV=development

# JWT
JWT_SECRET=your_secret_key_here
JWT_EXPIRE=7d

# Email (Brevo Transactional API)
BREVO_API_KEY=your_brevo_api_key
BREVO_SENDER_EMAIL=verified_sender_email
APP_NAME=CodeSeed

# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

# AI Service (if using external API)
OPENAI_API_KEY=your_openai_key

Client (.env.local)

# Backend API
VITE_BACKEND_URL=http://localhost:5000

# Google OAuth
VITE_GOOGLE_CLIENT_ID=your_google_client_id

💻 Usage

Starting the Development Environment

Terminal 1 - Backend:

cd server
npm run dev
# Server running at http://localhost:5000

Terminal 2 - Frontend:

cd client
npm run dev
# Client running at http://localhost:5173

Building for Production

Backend:

cd server
npm start

Frontend:

cd client
npm run build
# Creates optimized build in dist/

Running Tests

# Client tests
cd client
npm run test

# Server tests (if configured)
cd server
npm run test

Linting

# Client
cd client
npm run lint

# Auto-fix linting issues
npm run lint -- --fix

Usage Examples

Creating a Chat

Click "New Chat" in the sidebar
Select a programming language
Ask a question or request code
View AI response with code artifacts
Click code to preview in the right panel

Using Code Preview

Click any code artifact from AI response
View syntax-highlighted code
Change language if needed
Copy to clipboard or close panel

Managing Chats

View all chats in sidebar
Click to open previous chat
Hover to rename or delete
Search through history

Authenticating

Go to login page
Choose between Email or Google OAuth
Create account or login
Verify email (if using email auth)
Start creating chats

✨ Features

Chat Interface

✅ Multi-turn conversations
✅ Chat history management
✅ Rename and delete chats
✅ Real-time message streaming
✅ Loading animations

Code Generation

✅ Support for 9+ programming languages
✅ Multiple framework support
✅ Code syntax highlighting
✅ Live code preview
✅ Copy to clipboard

Authentication

✅ Google OAuth integration
✅ Email/password authentication
✅ Email verification
✅ Password reset
✅ Secure session management

User Experience

✅ Dark/light theme toggle
✅ Responsive design (mobile-friendly)
✅ User settings modal
✅ Toast notifications
✅ Smooth animations

Code Organization

✅ Modular component structure
✅ Custom hooks for API operations
✅ Centralized configuration
✅ Utility functions for common tasks
✅ Clean separation of concerns

🛠️ Technology Stack

Frontend

React 18 - UI library
Vite - Build tool and dev server
Tailwind CSS - Utility-first CSS framework
React Router - Client-side routing
Lucide React - Icon library
React Toastify - Toast notifications
date-fns - Date formatting
Google Identity Services - OAuth

Backend

Node.js - Runtime environment
Express.js - Web framework
MongoDB - NoSQL database
Mongoose - MongoDB ODM
JWT - Authentication tokens
Brevo Transactional Email API - Email service
Bcryptjs - Password hashing
CORS - Cross-origin requests
Dotenv - Environment variables

Development Tools

ESLint - Code linting
Prettier - Code formatting (optional)
Hot Module Replacement - Live reload
MongoDB Compass - Database GUI
Postman - API testing

🤝 Contributing

We welcome contributions! Here's how to get started:

Before Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Read CONTRIBUTING.md if available

Contribution Process

Make your changes
- Follow existing code style
- Keep components modular
- Add comments for complex logic
- Update documentation

Test your changes

# For client changes
cd client
npm run dev
npm run lint

# For server changes
cd server
npm run dev

Commit with clear messages

git commit -m "feat: add amazing feature"
git commit -m "fix: resolve issue #123"
git commit -m "docs: update README"

Push to your fork
```
git push origin feature/amazing-feature
```
Open a Pull Request
- Describe your changes clearly
- Link related issues (#123)
- Request review from maintainers

Code Standards

Frontend (React/JavaScript):

Use functional components with hooks
Keep components under 300 lines
Extract logic into custom hooks
Use meaningful variable names
Follow existing file structure
Use Tailwind CSS for styling

Backend (Node.js/JavaScript):

Follow RESTful API conventions
Use async/await for promises
Add error handling
Validate input data
Add JSDoc comments for functions
Use environment variables for config

Reporting Issues

Found a bug? Please open an issue with:

Clear description of the issue
Steps to reproduce
Expected vs actual behavior
Screenshots (if applicable)
Your environment (OS, Node version, browser)
Error messages/logs

Feature Requests

Have an idea? Please open an issue with:

Clear description of the feature
Why it would be useful
Implementation approach (if known)
Related features or issues

📄 License

This project is licensed under the MIT License.

MIT License Terms

You are free to:

✅ Use commercially
✅ Modify the code
✅ Distribute the code
✅ Use privately

With conditions:

Include the original license notice
State any changes made to the code

See the LICENSE file for full details.

📧 Contact

Have questions or feedback? Reach out!

Maintainer Email: luckypatil577r@gmail.com

Feel free to contact me about:

💡 Feature requests and suggestions
🐛 Bug reports
❓ Questions about the codebase
💬 General feedback
🤝 Collaboration opportunities
📚 Documentation improvements

🐛 Troubleshooting

Common Issues

Issue: "Cannot connect to backend"

Solution:

Ensure server is running (npm run dev in server directory)
Check if PORT 5000 is available
Verify VITE_BACKEND_URL in client .env.local
Check browser console for specific errors

Issue: "MongoDB connection failed"

Solution:

Verify MongoDB is running
Check MONGODB_URI in server .env
Ensure IP whitelist in MongoDB Atlas (if using cloud)
Check network connectivity

Issue: "Google OAuth not working"

Solution:

Verify VITE_GOOGLE_CLIENT_ID in client .env.local
Check redirect URI in Google Cloud Console
Ensure Google APIs are enabled
Clear browser cache and cookies

Issue: "Port already in use"

Solution:

# Find process using port
netstat -ano | findstr :5000  # Windows
lsof -i :5000                  # Mac/Linux

# Kill the process
taskkill /PID <PID> /F        # Windows
kill -9 <PID>                 # Mac/Linux

Issue: "CORS errors"

Solution:

Ensure CORS is enabled in server
Check allowed origins in server config
Verify client URL matches backend config
Clear browser cache

Issue: "Email verification not working"

Solution:

Check Brevo configuration in .env
Verify BREVO_API_KEY and BREVO_SENDER_EMAIL
Verify sender email is approved in Brevo
Look for error logs in server terminal

Getting Help

Check existing issues on GitHub
Review error messages in browser console
Check server logs in terminal
Email maintainer with detailed description
Include error screenshots and environment details

📚 Documentation

Client Documentation - Frontend setup and usage
ARCHITECTURE.md - System architecture overview
PROJECT_ORGANIZATION.md - File structure details
SETUP_GUIDE.md - Detailed setup instructions

🎯 Roadmap

Short Term (Q1 2026)

Team collaboration features
Advanced code analysis
Improved chat persistence

Medium Term (Q2-Q3 2026)

Mobile app (React Native)
VS Code extension
Code snippet marketplace

Long Term (Q4 2026+)

Real-time collaborative editing
Custom AI model training
API documentation generator

📊 Statistics

Frontend: ~200 lines per component (average)
Backend: RESTful API with 20+ endpoints
Database: MongoDB with 2 main collections
Languages Supported: 9+ programming languages
Total Project Size: ~50KB minified (client)

🙏 Acknowledgments

Built with React and Node.js
Styled with Tailwind CSS
Icons from Lucide React
Database with MongoDB
Powered by AI for code generation
Thanks to all contributors and users

📝 Version History

Version	Date	Changes
1.0.0	Jan 2026	Initial release

⭐ Show Your Support

If you find CodeSeed helpful, please:

⭐ Star this repository
🔗 Share with friends
💬 Provide feedback
🤝 Contribute improvements

Happy coding with CodeSeed! 🚀

📞 Quick Links

Last Updated: January 2026 Maintained by Lucky Patil (luckypatil577r@gmail.com)

Name		Name	Last commit message	Last commit date
Latest commit History 111 Commits
client		client
server		server
README.md		README.md
render.yaml		render.yaml

Folders and files

Latest commit

History

Repository files navigation

CodeSeed - AI-Powered Code Generation & Learning Platform

📋 Table of Contents

🌱 About CodeSeed

What CodeSeed Does

Who It's For

📁 Project Structure

🚀 Quick Start

☁️ Deployment (Vercel + Render)

🔧 Installation

Prerequisites

Detailed Setup

1. Clone Repository

2. Backend Setup

3. Frontend Setup

4. Environment Variables Reference

💻 Usage

Starting the Development Environment

Building for Production

Running Tests

Linting

Usage Examples

Creating a Chat

Using Code Preview

Managing Chats

Authenticating

✨ Features

Chat Interface

Code Generation

Authentication

User Experience

Code Organization

🛠️ Technology Stack

Frontend

Backend

Development Tools

🤝 Contributing

Before Contributing

Contribution Process

Code Standards

Reporting Issues

Feature Requests

📄 License

MIT License Terms

📧 Contact

🐛 Troubleshooting

Common Issues

Issue: "Cannot connect to backend"

Issue: "MongoDB connection failed"

Issue: "Google OAuth not working"

Issue: "Port already in use"

Issue: "CORS errors"

Issue: "Email verification not working"

Getting Help

📚 Documentation

🎯 Roadmap

📊 Statistics

🙏 Acknowledgments

📝 Version History

⭐ Show Your Support

📞 Quick Links

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages