Overview
Project scaffolding for every language and runtime in the usetheo ecosystem.
TheoCreate is the fastest way to start a project that will land on production. Pick a stack, answer two or three questions, and walk away with a deployable repository — best practices wired in, no boilerplate cleanup.
It is the bridge between TheoCode (which writes code) and Theo PaaS (which ships it). The scaffold lands in a shape both already understand.
Install
Run the canonical command. No global install required.
npm create theo@latestDetects pnpm, yarn, and bun automatically and proxies to the right
package manager for your project.
Available templates
Node.js
Express, Fastify, Hono, or vanilla. ESM-first, TypeScript strict.
Next.js
App Router, Tailwind 4, server components — the same stack the usetheo site runs on.
Go
chi-based HTTP service with structured logging and graceful shutdown.
Python
FastAPI service with uv-managed dependencies and pytest preconfigured.
Rust
axum service, sqlx, tracing — production-grade defaults.
Java
Spring Boot 3 with Gradle, JUnit 5, and a health endpoint.
Ruby
Rails 8 API mode with RSpec and good_job.
PHP
Laravel 11 with Pest tests and an OpenAPI generator.
Monorepo
pnpm + Turborepo scaffold with apps and packages already wired.
Quick start
# 1. Scaffold the project
npm create theo@latest my-service
# 2. Pick the stack you want
# (Node.js · Next.js · Go · Python · Rust · Java · Ruby · PHP · Monorepo)
# 3. Walk into the project
cd my-service
# 4. Run it
pnpm devThe output is a normal repository with a normal package.json (or go.mod,
pyproject.toml, etc.). No proprietary layer, no hidden runtime.
What every template ships with
- A health check endpoint that Theo PaaS recognizes out of the box.
- A
Dockerfilealigned with the standard usetheo deploy contract. - A
CHANGELOG.mdseeded with the Keep a Changelog format. - Tests configured and green from minute one.
- ESM, strict TypeScript (where applicable), and a working linter.
TheoCreate never asks you to install Theo PaaS. The templates run on any infrastructure that supports containers — locally, on Fly, on AWS, on Cloudflare, anywhere.
Where to go next
Pair with TheoCode
Open the project in TheoCode and let the agent extend the scaffold from your first prompt.
Going AI-agent first?
TheoKit is the Next.js framework for full-stack AI agents — TheoCreate scaffolds a TheoKit project as one of its options.
Ship it
Run `theo deploy` from the project root and Theo PaaS hands you a live URL.