OpenForge

A unified, real-time, AI-assisted platform that fundamentally redefines open-source collaboration.

Project Structure

This is a monorepo containing:

• Frontend: Next.js application with React, TypeScript, TailwindCSS, and ShadCN UI
• Backend: FastAPI application with Python

openforge/
├── frontend/          # Next.js frontend application
├── backend/           # FastAPI backend application
├── PRD.md            # Product Requirements Document
├── AI_REPLICATION_GUIDE.md  # Design system documentation
├── GITHUB_TOKEN_SETUP.md    # GitHub authentication setup guide
└── README.md         # This file

Tech Stack

This is a full-stack monorepo with separate frontend and backend applications:

• Frontend: Next.js application with React, TypeScript, TailwindCSS, and ShadCN UI
• Backend: FastAPI application with Python and MongoDB

For detailed tech stack information and setup instructions, see:

• Frontend README
• Backend README

Getting Started

Prerequisites

• Node.js 18+ and npm 9+ (for frontend)
• Python 3.12+ (for backend)
• uv - Python package manager (for backend)
• MongoDB (for backend development)

Quick Start

1. Frontend Setup: See frontend/README.md
2. Backend Setup: See backend/README.md

Development Scripts

Root Level

npm run dev:frontend    # Start frontend dev server
npm run dev:backend     # Start backend dev server
npm run build:frontend  # Build frontend for production
npm run lint:frontend   # Lint frontend code

For more detailed development scripts, see the respective README files:

• Frontend Development Scripts
• Backend Development Scripts

Documentation

• PRD.md - Product Requirements Document
• GITHUB_TOKEN_SETUP.md - GitHub authentication and token setup guide
• DASHBOARD_METRICS_CHANGES.md - Dashboard metrics implementation details
• AI_REPLICATION_GUIDE.md - Design system documentation

Features

• ✅ User authentication with Clerk
• ✅ GitHub repository creation with openforge-demo topic
• ✅ Dashboard with metrics tracking
• ✅ Project management (create, join, star projects)
• 🔄 Real-time collaboration (WebSockets) - Coming soon
• 🔄 In-browser IDE (Monaco Editor) - Coming soon
• 🔄 AI integration - Coming soon

See PRD.md for detailed requirements.

Contributing

This is a personal project. See the PRD for feature requirements and architecture decisions.

License

[Your License Here]