https://github.com/bettertyped/hype-stack
🚀 Fasted fullstack monorepo template in the world, built with vite, oxc, tsgo, pnpm. E2E typesafety, builds to Desktop and Web application.
https://github.com/bettertyped/hype-stack
Last synced: 24 days ago
JSON representation
🚀 Fasted fullstack monorepo template in the world, built with vite, oxc, tsgo, pnpm. E2E typesafety, builds to Desktop and Web application.
- Host: GitHub
- URL: https://github.com/bettertyped/hype-stack
- Owner: BetterTyped
- Created: 2026-05-03T20:32:44.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-26T19:14:09.000Z (about 1 month ago)
- Last Synced: 2026-05-26T21:12:15.922Z (about 1 month ago)
- Language: TypeScript
- Homepage:
- Size: 8.12 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
The starting point for web + desktop apps.
Fully typed. AI-ready. Production-grade architecture.
A clean, empty full-stack template.
Add features as you need them — one command at a time.
Get started:
```bash
npx @hype-stack/cli create
```
## What Is Hype Stack?
Hype Stack is a **modern full-stack template** — not a boilerplate packed with someone else's opinions. You get a clean, empty project with rock-solid architecture and tooling already wired up. No demo features to rip out. No dead code to clean up.
Build whatever you want from day one.
## How It Works
Hype Stack follows the same model as [shadcn/ui](https://ui.shadcn.com) — but for full-stack features.
1. **Scaffold** your project with the CLI
2. **Add packs** when you need them — auth, orgs, realtime, storage, desktop, and more
3. Each pack drops production-ready code **into your codebase** — you own it, you modify it
```bash
npx @hype-stack/cli create # Create a new project
npx @hype-stack/cli add auth # Add authentication pack
npx @hype-stack/cli add orgs # Add organizations & RBAC pack
```
No lock-in. No runtime dependency. Just code in your repo.
## Preview
## What You Get Out of the Box
The template ships with **zero features** and **everything you need to build them**:
- **Monorepo** — frontend, backend, and shared packages in one repo
- **End-to-end types** — frontend imports backend contracts directly, no codegen
- **Rust-powered tooling** — OXC linting, formatting, Vite 8 HMR in milliseconds
- **AI-native structure** — vertical architecture with Cursor rules and agent skills
- **Desktop-ready** — Electron Forge pre-configured for macOS, Windows, and Linux
- **Testing setup** — Vitest, React Testing Library, Playwright E2E ready to go
## Available Packs
Need features? Add them with a single command. Each pack installs production-grade, fully-typed code directly into your project.
| Pack | What it adds |
| ---- | ------------ |
| **Auth** | Email/password, OAuth, email verification, password reset, sessions |
| **Organizations** | Multi-org support, invitations, org switching |
| **RBAC** | Role-based access control, permission gates on routes and UI |
| **Realtime** | Typed WebSocket events, live notifications |
| **Storage** | S3-compatible file uploads with validation |
| **Desktop** | macOS signing, Windows installers, Linux packages, auto-update |
| **Observability** | Sentry error tracking, PostHog analytics, structured logging |
> Packs are purchased separately. Run `npx @hype-stack/cli packs` to browse what's available.
## Why Hype Stack?
### Clean Slate, Not a Gutting Job
Most templates give you a demo app and expect you to delete half of it. Hype Stack gives you an empty project with the hard parts already solved — monorepo wiring, type bridges, tooling, CI.
### Built for AI Agents
The codebase follows a [vertical architecture](https://tkdodo.eu/blog/the-vertical-codebase) — each feature owns its routes, UI, data access, types, and tests. Bundled Cursor rules and agent skills teach LLMs exactly how to add features and follow conventions. Fast tooling gives agents sub-second feedback loops.
### Zero-Codegen Type Safety
No OpenAPI specs. No code generators. The frontend imports `@hype-stack/backend` as a workspace dependency. HTTP routes and WebSocket events flow through a typed bridge — change a backend response, and TypeScript catches every mismatched consumer instantly.
### One Codebase, Every Platform
Same React app runs as a web SPA and an Electron desktop app. One `VITE_APP_TYPE` flag controls the split. Desktop builds are ready when you are.
## Architecture
```
┌─────────────────────────────────────────────────┐
│ pnpm monorepo │
├─────────────────┬───────────────────────────────┤
│ apps/frontend │ apps/backend │
│ ───────────── │ ──────────── │
│ React 19 │ Hono │
│ TanStack Router│ Prisma + Kysely │
│ HyperFetch SDK │ Zod validation │
│ Electron Forge │ Typed WebSockets │
│ shadcn/ui │ │
├─────────────────┴───────────────────────────────┤
│ packages/enums — shared permissions & config │
└─────────────────────────────────────────────────┘
```
## Tech Stack
| Layer | Technology |
| ---------- | --------------------------------------------------------- |
| Frontend | React 19, TanStack Router, Tailwind v4, shadcn/ui, Motion |
| Backend | Hono, Prisma, Kysely, Zod |
| Desktop | Electron Forge (macOS, Windows, Linux) |
| Database | PostgreSQL 17 + pgvector |
| Cache | Valkey (Redis-compatible) |
| Tooling | Nx, Vite 8, OXC, pnpm, TypeScript 6 |
## Quick Start
```bash
# Create a new project
npx @hype-stack/cli create
# Start infrastructure
cd apps/backend && docker compose up -d && cd ../..
# Run migrations
pnpm --filter backend exec prisma migrate deploy
pnpm --filter backend exec prisma generate
# Launch everything
pnpm dev
```
> Web app runs on Vite. Backend on Hono. Both hot-reload instantly.
## Development
### Docker Services
```bash
cd apps/backend
docker compose up -d
```
| Service | Port | Purpose |
| -------------- | ---- | ----------------------------------- |
| Postgres | 5436 | Database (PostgreSQL 17 + pgvector) |
| Valkey | 6381 | Cache |
| RustFS | 9000 | S3-compatible object storage |
| RustFS Console | 9001 | Storage web UI |
### Commands
```bash
pnpm dev # Start frontend + backend with hot-reload
pnpm build # Production build
pnpm lint # OXC linting
pnpm format # OXC formatting
pnpm typecheck # Full type checking
pnpm test # Run all tests
```
### Testing
```bash
cd apps/backend
pnpm test:setup # Start test containers + migrate + generate
pnpm test # Run tests
pnpm test:clean # Tear down test infrastructure
```
## Our Sponsors
---
Start empty. Add what you need. Ship fast.
Hype Stack gives you the architecture — you choose the features.
## License
[MIT](https://github.com/BetterTyped/hype-stack/blob/main/License.md)