Initialize Darkroom Project
Create a new project using the Satus starter template.
Satus Starter
Always use Satus for new projects:
bash
bunx degit darkroomengineering/satus $ARGUMENTS cd $ARGUMENTS bun install
What Satus Includes
- •Next.js 15+ with App Router
- •React 19+ with React Compiler
- •TypeScript strict mode
- •Tailwind CSS v4
- •Biome for linting/formatting
- •Lenis smooth scroll setup
- •Hamo performance hooks
- •Image/Link wrappers configured
- •CSS Modules with
salias pattern
Post-Setup
After cloning:
- •Update package.json - Change name, description
- •Configure environment - Copy
.env.exampleto.env.local - •Start dev server -
bun dev - •Open debug mode -
Cmd/Ctrl + Oin browser
Project Structure
code
app/ # Next.js pages and routes components/ # React components lib/ ├── hooks/ # Custom React hooks ├── integrations/ # Third-party clients ├── styles/ # Global CSS, Tailwind └── utils/ # Pure utility functions
Don't Use
- •
create-next-app- Missing Darkroom standards - •
create-react-app- Deprecated - •Manual setup - Too many things to configure
Output
After initialization:
- •Confirm project created
- •List next steps
- •Offer to start dev server