Overview

One Schema. Every Output.

QUESTPIE is a backend-first TypeScript framework where you define your data schema once, and codegen + introspection project it into typed runtimes, APIs, and frontends.

Define collections, routes, jobs, and hooks as plain files. Codegen wires them into a type-safe runtime. The admin panel, client SDK, and OpenAPI spec are all projections of the same schema — not separate definitions.

How It Works

import { collection } from "#questpie/factories";

export default collection("posts").fields(({ f }) => ({
	title: f.text(255).required(),
	body: f.textarea().localized(),
	cover: f.upload({ to: "assets", mimeTypes: ["image/*"] }),
	author: f.relation("users"),
	status: f.select([
		{ value: "draft", label: "Draft" },
		{ value: "published", label: "Published" },
	]),
	publishedAt: f.date(),
}));

This single file defines:

• Database schema — Drizzle table with correct column types
• API validation — Zod schemas for create/update
• Query operators — Type-safe where, orderBy, with
• Client types — End-to-end TypeScript from server to frontend
• Admin UI — Form fields, list columns, filters (when @questpie/admin is installed)

Package Architecture

Documentation Sections

• Start Here — What is QUESTPIE, installation, first app, project structure
• Build Your Backend — Data modeling, rules, business logic, architecture
• Admin Workspace — Admin panel setup, views, blocks, actions
• Client Integration — Client SDK, TanStack Query, realtime, HTTP adapters
• Production — Database, auth, storage, email, queue, deployment
• Extend — Custom fields, views, plugins, modules
• Examples — TanStack Barbershop end-to-end walkthrough
• API Reference — Complete API reference

Canonical Example

All code examples in these docs come from the TanStack Barbershop — a real booking app with 7 collections, server routes, background jobs, email templates, and a full admin dashboard.