Files
codeboard/README.md
Vectry 993bb08dff
All checks were successful
Deploy CodeBoard / deploy (push) Successful in 32s
docs: add subscription features, pricing tiers, API keys, and getting started sections to README
2026-02-11 00:34:45 +00:00

3.5 KiB

CodeBoard

Codebase → Onboarding Docs Generator. Paste a GitHub repo URL, get interactive developer onboarding documentation in minutes.

Live at codeboard.vectry.tech

Getting Started

  1. Register at codeboard.vectry.tech/register with your email and password.
  2. Log in to access the dashboard, generation history, and settings.
  3. Paste a GitHub URL and generate interactive onboarding documentation.

Registration is required for full access. Unauthenticated visitors can view the landing page, but generating documentation, viewing your dashboard, and browsing generation history all require a logged-in account.

Plans and Pricing

CodeBoard offers three billing tiers. One generation equals one documentation build from a repository URL.

Plan Price Generations Highlights
Free $0 15 per day Public repos, architecture diagrams, interactive docs
Starter $5 / month 1,000 per month Generation history, API key access, priority support
Pro $20 / month 100,000 per month Full history, multiple API keys, dedicated support, custom integrations

Manage your subscription in Settings > Billing from the dashboard.

API Keys (Programmatic Access)

Paid plans (Starter and Pro) include API key access for programmatic diagram and documentation generation.

  1. Navigate to Settings > API Keys in the dashboard.
  2. Create a new key and copy it immediately -- it is shown only once.
  3. Include the key in your requests:
curl -X POST https://codeboard.vectry.tech/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"repoUrl": "https://github.com/owner/repo"}'

Each successful API call counts as one generation against your plan's quota.

Generation History

All generated documentation is saved to your account. From the dashboard you can:

  • Browse past generations per repository.
  • Compare documentation versions side-by-side to track codebase changes over time.
  • Re-open any previous generation by its unique link.

History is per-user -- each account maintains its own generation records.

Architecture

codeboard/
├── apps/
│   ├── web/         # Next.js 14 frontend + API routes
│   └── worker/      # BullMQ job processor
├── packages/
│   ├── shared/      # TypeScript types
│   ├── parser/      # Babel-based AST parser (JS/TS) + regex (Python)
│   ├── llm/         # OpenAI/Anthropic abstraction + prompt pipeline
│   ├── diagrams/    # Mermaid diagram generators
│   └── database/    # Prisma schema + client

Quick Start

# Install dependencies
npm install

# Build all packages
npm run build

# Start with Docker
docker compose up

Development

# Run dev server (all workspaces)
npm run dev

# Build
npm run build

Tech Stack

  • Frontend: Next.js 14, React 18, Tailwind CSS 4
  • Backend: BullMQ workers, Redis pub/sub for real-time progress
  • Parser: @babel/parser for JS/TS, regex-based for Python
  • LLM: Provider abstraction (OpenAI GPT-4o / Anthropic Claude)
  • Diagrams: Mermaid.js auto-generated architecture & dependency graphs
  • Database: PostgreSQL + Prisma
  • Queue: Redis + BullMQ
  • Deployment: Docker multi-stage builds

License

MIT


Built by Vectry — Engineering AI into your workflow.