OpenSana Docs

Repository Structure

Understand how the OpenSana monorepo is organized.

Main Applications

  • apps/web: Next.js app plus Convex backend
  • apps/cli: CLI bridge and one-shot commands
  • apps/docs: this documentation site

Supporting Areas

  • docs/specs: internal behavior specifications
  • docs/features: implementation plans and historical notes
  • playground/*: experiments and prototypes
  • .devcontainer: containerized development environment

Architectural Split

  • the web app owns the product UI and backend behavior
  • the CLI owns local runtime execution and terminal workflows
  • the docs app owns public documentation

This separation is important when deciding where new code and new documentation should live.

Local Development

Run the web app, Convex backend, docs app, and supporting tools locally.

Web App Architecture

A high-level map of the Next.js application and frontend domain boundaries.

On this page

Main ApplicationsSupporting AreasArchitectural Split