Skip to content

Repository files navigation

LearnOS

AI agent-powered course production studio. Turn a course idea into a complete, high-quality course using specialised AI agents.

Stack

  • Next.js 15 (App Router, TypeScript)
  • Tailwind CSS 4 + shadcn-style components
  • Supabase (Auth, PostgreSQL, Storage, RLS)
  • DeepSeek API (primary text generation)
  • Vercel (deployment target)

Getting Started

Prerequisites

Environment

Copy .env.example to .env.local and fill in values:

cp .env.example .env.local

Install & Run

npm install
npm run dev

Open http://localhost:3000.

Build

npm run build
npm run typecheck

Project Structure

src/
  app/              # Next.js routes (auth, dashboard, API)
  components/       # UI, layout, feature components
  lib/
    agents/         # Agent registry, orchestrator, validators
    ai-providers/   # DeepSeek integration
    project-memory/ # Project context loading/saving
    supabase/       # Supabase clients
    usage/          # Credits and cost tracking
  types/            # TypeScript types
supabase/migrations # Database migrations
docs/               # Product & technical documentation

Supabase

  • Project ID: ggqppeztbigsnngvxsym
  • Region: eu-west-3
  • Migrations are in supabase/migrations/
  • Apply via Supabase MCP or supabase db push

Development Roadmap

See docs/10_DEVELOPMENT_ROADMAP_b564.md for the full phased plan.

Phase Status Description
0 — Setup ✅ Done Project scaffold, DB schema, auth
1 — SaaS Shell ✅ Done Dashboard, projects, design system (login → create project verified)
2 — Strategy ✅ Done Setup wizard, setup-answers API, strategy UI with generate/approve/edit wired to Command Centre
3 — Curriculum ⏳ Pending Curriculum Designer, module/lesson UI
4 — Lessons ⏳ Pending Lesson editor, Lesson Writer
5 — Resources ⏳ Pending Quizzes, worksheets, resources
6 — Review ⏳ Pending Review Centre
7 — Launch/Export ⏳ Pending Launch Studio, Markdown/PDF export
8 — Credits ⏳ Pending Usage dashboard, credit controls

Documentation

Full product documentation is in the docs/ folder. Start with docs/00_READ_ME_FIRST_5af0.md.

Autonomous Agent Development

See AGENTS.md for instructions on how cloud agents should continue building this project.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages