Website | Repository

Koyeb Control Panel

Source code of the Koyeb control panel, accessible at app.koyeb.com.

The control panel is a React application powered by TypeScript, Vite and Tailwind CSS. It uses TanStack Router for routing, TanStack Query for data fetching, and WorkOS AuthKit for authentication.

Getting started

Prerequisites:

• Node.js (we recommend nvm to manage versions)
• pnpm (npm i -g pnpm)

pnpm install
pnpm run dev

The dev server starts on localhost:8000.

Minimal `.env` file

VITE_ENVIRONMENT=development
PROXY_API_URL=https://app.koyeb.com
VITE_WORK_OS_API_HOST=auth.koyeb.com
VITE_WORK_OS_CLIENT_ID=client_01JZ7TR12M399YV1D6XFHXP1K6

Scripts

Script	Description
pnpm dev	Start the Vite dev server
pnpm build	Production build
pnpm preview	Preview the production build locally
pnpm test	Run unit tests (Vitest)
pnpm e2e	Run end-to-end tests (Playwright)
pnpm lint	Run ESLint with type-checked rules
pnpm storybook	Start Storybook on port 6006
pnpm api-codegen	Regenerate API types from the OpenAPI spec

Documentation

Architecture

• Application Structure
• Core Libraries
• Entrypoint / App Initialization
• Config / Environment Variables
• Data Model

UI

• Routing
• Styles / Design System
• Form Handling / Validation
• Toast Notifications
• Translations
• Storage

Data

• Authentication
• Queries
• API Calls

Integrations

• WorkOS
• Stripe
• GitHub App
• Discourse / Canny SSO
• Seon

Observability

• Error Handling / Reporting
• Analytics / Event Tracking
• Feature Flags

Tooling

• Build / Vite Plugins
• Type Checking / Linting
• Tests
• Storybook
• CI / CD

License

Apache 2.0