website

A minimal Remix application starter with a home page and an auth page.

Starter Shape

• app/controllers/home.tsx owns the home page.
• app/controllers/auth.tsx owns the auth page.
• app/routes.ts defines the route contract.
• app/router.ts wires routes to handlers.
• app/ui/ holds the shared document and layout wrappers.
• app/utils/render.tsx centralizes HTML response rendering.

Growing The App

• Start with flat route files and only introduce route folders when a route needs multiple actions or route-owned modules.
• Add directories like app/data/, app/middleware/, public/, or test/ when the app actually needs them.
• Move shared UI into app/ui/ once more than one route needs it.

Commands

npm i
npm run build
npm run start
npm test
npm run typecheck

Vercel

This app uses Remix 3 with a custom fetch-router server, so Vercel should use the Other framework preset rather than the Remix preset.

• api/index.ts adapts the app router to a Vercel Node.js Function.
• vercel.json sets framework to null, runs pnpm run build, and rewrites all requests to the function.
• Node.js should run on 24.x.