GitGuide Frontend (Next.js)
Next.js app for GitGuide — create projects from GitHub URLs, browse the AI-generated roadmap, chat with a repo-aware assistant, and use a Monaco-based workspace UI backed by Docker workspaces.
Tech stack (frontend)
- Next.js 16 (App Router) + React 19 + TypeScript
- Clerk authentication
- Tailwind CSS + Radix UI primitives
- Monaco Editor (
@monaco-editor/react) for the in-browser editor
Local development
Prerequisites
- Node.js 18+
- Backend running locally (see repo root
LOCAL_SETUP.md)
Install + run
cd frontend-nextjs
npm install
npm run dev
Frontend runs on http://localhost:3000.
Backend URLs (local)
In dev, the app is designed to connect to:
- Main API:
http://localhost:8000 - Workspaces API:
http://localhost:8002
See QUICK_START_LOCAL.md and LOCAL_BACKEND_CONNECTION.md for details.
Environment variables
Create frontend-nextjs/.env.local:
NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_WORKSPACE_API_BASE_URL=http://localhost:8002
WORKSPACE_API_BASE_URL=http://localhost:8002
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_key
CLERK_SECRET_KEY=your_key
Useful scripts
npm run dev
npm run build
npm start
npm test
Code map (high level)
app/dashboard— project list + creation UIapp/project/[projectId]— roadmap view for a projectapp/components/roadmap— roadmap UI (days, concepts, tasks, kanban)app/components/workspace— editor + file explorer UI (Phase 0)app/api/*— proxy routes to backend servicesapp/lib/*— typed API clients used by server/client components