Introduction
Architecture, API, auth, deployment, and example documentation for the vend1k personal starter.
The vend1k personal starter is a Turborepo-powered monorepo combining a Hono backend API with multiple Next.js frontends, wired together with end-to-end type safety, a shared design system, and credential-based authentication.
These docs cover how the workspace is organized, how the pieces fit together, and how to extend them.
Guides
Workspace Architecture
How the Turborepo monorepo is structured and why.
Hono Backend API
The single source of truth for data, auth, and business logic.
Better Auth Security
Credential-based email/password auth with Postgres sessions.
UI Core Components
The shared @vend1k/ui design system and theming.
User Management Portal
The standalone customer-facing portal app.
Admin Panel Console
The internal administration console.
Deployment & Orchestration
Containerized builds and reverse-proxy routing.
Examples
Chat Walkthrough
Real-time messaging over SSE / WebSockets.
Kanban Board
Drag-and-drop workflow board with optimistic updates.
Notifications Center
Toasts and a persistent notification drawer.
Forms with TanStack Form
Type-safe forms validated with Zod.
Data Tables
Server-paginated, filterable tables with URL state.