---
title: "Getting Started"
description: "Welcome to MastraKit — the AI-first agent platform boilerplate"
source: /docs
---


What is MastraKit? [#what-is-mastrakit]

MastraKit is a production-ready monorepo boilerplate for building AI agent platforms. Users interact via web chat, ChatGPT/Claude Desktop, or MCP clients. The AI agent IS the product.

Architecture [#architecture]

Your project ships with 5 services, each deployed as a Cloudflare Worker:

| Service      | Purpose                                       | Port |
| ------------ | --------------------------------------------- | ---- |
| **Web**      | TanStack Start + React 19 frontend, chat UI   | 3000 |
| **API**      | Hono REST API, business logic, Stripe billing | 3001 |
| **Auth**     | Better Auth, JWT, organization management     | 4333 |
| **Mastra**   | AI agent, tools, MCP server                   | 4111 |
| **Metering** | Usage tracking, credit ledger                 | 4222 |

Each service has its own Turso (LibSQL) database. Multi-tenancy is built in — all queries filter by organization.

Quick Start [#quick-start]

The fastest path from license to running project:

1. **[Get a License](/docs/license)** — Purchase your license key
2. **[Prerequisites](/docs/prerequisites)** — Install the required tools
3. **[Scaffold](/docs/scaffold)** — Create your project with `npx mastrakit`
4. **[Local Development](/docs/local-development)** — Run the stack locally (with or without a tunnel)
5. **[Configure Secrets](/docs/secrets)** — Set up API keys and credentials
6. **[Deploy](/docs/deploy)** — Deploy to Cloudflare Workers
7. **[GitHub & CI/CD](/docs/github)** — Set up environments, workflows, and Conductor

Key Technologies [#key-technologies]

* **Frontend:** TanStack Start, React 19, TailwindCSS, Radix UI
* **Backend:** Hono (Cloudflare Workers), Drizzle ORM
* **AI:** Mastra framework, Anthropic/OpenAI, MCP protocol
* **Auth:** Better Auth with JWT, social login (Google, GitHub)
* **Database:** Turso (LibSQL) with database branching
* **Payments:** Stripe (subscriptions + credit packages)
* **CI/CD:** GitHub Actions, Conductor workspace automation