Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getmaito.com/llms.txt

Use this file to discover all available pages before exploring further.

Local Development

Requirements

  • Bun 1.3.5 or newer
  • Node.js 20.19.0 or newer
  • PostgreSQL for local backend/database work

Install

bun install

Run The Workspace

bun run dev
The root development command runs the main workspace while excluding services that are normally started explicitly, such as the desktop app, schedule worker, CLI, and MCP server.

Focused Commands

bun run app:build
bun run web:build
bun run mcp:dev
bun run mcp:run
bun run start:schedule-worker
bun run webhooks:run

Checks

bun run check-types
bun run build
bun run lint
Focused package tests:
cd packages/backend && bun test
cd packages/social-publish && bun test
cd packages/app-services && bun test

Database

The database package uses Drizzle with PostgreSQL.
cd packages/db
DATABASE_URL=postgresql://user:password@localhost:5432/maito bun run push
Use a disposable local database for development. Do not point local migration or push commands at production.