Skip to content

hyperdrift-io/own-stack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

own-stack

A server-rendered React stack you own — no Next.js. Assembled from small pieces you control instead of one framework that owns you.

This is a minimal, runnable reference: every claim below is something this repo actually does.

The stack

Concern Choice Why
Rendering Waku (React Server Components) SSG · SSR · file-based routing, minimal surface. "Next without Next."
Data + mutations RSC + server functions Server Components await typed functions directly; server actions handle mutations. End-to-end types with no tRPC, no API schema, no codegen.
Styling Pure semantic CSS One stylesheet, style the primitives. No Tailwind, no CSS-in-JS.
Auth Better Auth (designated layer) Framework-agnostic, lives in your app. See Honest frontier below.

Whole stack: 5 production dependencies. The complete demo app is ~400 lines across 15 files.

What it demonstrates

  • / — a static (SSG) page; HTML at build time, with one small client island.
  • /feed — a dynamic (SSR) page that awaits a typed server function directly. No API route, no client island.
  • /guestbook — a typed server action (mutation). The function signature is the contract; no API route.
  • /search — a client island that fetches typed data by calling a server function directly. The job people give TanStack Query / SWR, with no query library, no API route, no tRPC, no cache to sync.
  • /dashboard — the honest frontier: where Better Auth would live, and why it isn't wired yet.

The UI is colour-coded by execution boundary: cyan runs on the server, amber marks a 'use client' island — the only JavaScript that ships. Pure semantic CSS, no Tailwind.

Run it

pnpm install
pnpm dev      # http://localhost:3000
pnpm build && pnpm start

Install it as an app

A manifest + a ~30-line service worker make it an installable PWA: on a phone, Add to Home Screen launches it standalone — its own icon, no browser chrome. Because the stack is server-rendered and light, the experience is hard to tell from native. Verified installable (service worker active, manifest valid, zero Chrome installability errors). No Workbox, no PWA plugin.

Honest frontier: auth

Better Auth is framework-agnostic and clean. The friction today is Waku-beta's API ergonomics: mounting an arbitrary request handler doesn't work via a file convention — it needs Waku's programmatic createApi. So in this young framework, the API/auth layer is where you still wire the plumbing yourself, unlike Next where auth is a documented drop-in. That gap is the price of owning the stack while the RSC ecosystem is still young — and it's closing fast.


Built by Hyperdrift. Doctrine: own your stack, prefer subtraction, no lock-in.

About

A server-rendered React stack you own — no Next.js. Waku (RSC) + typed server functions + pure CSS.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors