Stacks
Stacks are the base frameworks for each application. They determine the project structure, development scripts, and which modules are available.
A stack is the foundation of each application in your project. When you add an app, you choose a stack — this determines the project structure, TypeScript config, development scripts, and which modules can be added on top.
Stacks are split into two types:
App stacks — full-featured frameworks for web and mobile applications:
- Next.js — React framework with SSR, Server Components, and App Router
- TanStack Start — Full-stack React framework with file-based routing
- Expo — React Native framework for mobile apps
Server stacks — backend runtimes for APIs and background services:
- Hono — Ultra-fast web framework with middleware, CORS, and error handling
- Node.js — Plain TypeScript runtime for workers, cron jobs, and Lambda handlers
How Stacks Work
Each stack provides:
- Templates — pre-configured project files (entry points, TypeScript config, framework config)
- Scripts — development and build commands declared in
package.json - Module compatibility — which libraries can be added (e.g., shadcn is available for Next.js but not Hono)
In a multi-app project, each app can use a different stack. create-faster automatically sets up Turborepo when you have 2+ apps.
Choosing a Stack
| Need | Stack |
|---|---|
| Web app with SSR | Next.js |
| Mobile app | Expo |
| Full-stack React | TanStack Start |
| REST/GraphQL API | Hono |
| Worker, cron, Lambda | Node.js |
Changing the port
The port of an app is 3000 plus its index among the apps. An app that listens on a port reads PORT to change it, for dev and start, and the generated README and AGENTS.md list the commands:
# Single repo
PORT=4000 npm run dev
# Turborepo: one app, from its directory
cd apps/web && PORT=4000 npm run devPORT set on the root dev or start of a Turborepo reaches every app (the generated turbo.json passes it through), so all of them would listen on the same port. With portless, the port is assigned by portless: pin it with PORTLESS_APP_PORT.
CLI Usage
# Single app
bunx create-faster myapp --app myapp:nextjs --pm bun
# Multi-app with different stacks
bunx create-faster my-saas \
--app web:nextjs:shadcn \
--app api:hono \
--app worker:node \
--pm bun
