Introduction

Welcome to the Beztack docs. This project is a production-ready TypeScript monorepo focused on fast delivery, clear architecture, and maintainable defaults.

Tech Stack

We're using cutting-edge technologies to deliver the best developer and user experience:

• Monorepo: Nx + pnpm for efficient workspace management.
• Frontend: React 19 + Vite + Tailwind CSS v4 + shadcn/ui in apps/ui.
• Backend: Nitro with file-based routing in apps/api.
• Landing + Docs: Next.js + Fumadocs in apps/docs.
• Auth: Better Auth with admin, organization, and twoFactor plugins.
• Payments: Provider-agnostic adapter pattern supporting Polar and MercadoPago.
• Database: Drizzle ORM + PostgreSQL in @beztack/db.
• Email: React Email + Resend in @beztack/email.
• Environment: T3 Env + Zod for centralized env validation in @beztack/env.
• AI: Vercel AI SDK + Amazon Bedrock in @beztack/ai.
• OCR: Tesseract.js in @beztack/ocr.
• URL State: nuqs in @beztack/state.
• CLI Tooling: Template Sync commands to plan, inspect, apply, and rollback template updates.

Project Structure

The repo is organized into apps and shared packages:

• apps/ui — React 19 SPA with TanStack Query, React Router v7, and i18next.
• apps/api — Nitro REST API with unified payment routes (/api/subscriptions/*) and admin routes (/api/admin/plans/*).
• apps/docs — Next.js landing page and documentation with Fumadocs.
• packages/ — 10 shared packages covering database, payments, email, env validation, AI, OCR, state management, and CLI tooling.

Check out the sidebar sections to dive deeper into each aspect of Beztack development.