Initialize Darkroom Project
Create a new project using the Satus starter template.
Satus Starter
Always use Satus for new projects:
bunx degit darkroomengineering/satus $ARGUMENTS
cd $ARGUMENTS
bun install
What Satus Includes
- Next.js 16+ 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
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 standardscreate-react-app- Deprecated- Manual setup - Too many things to configure
Output
After initialization:
- Confirm project created
- List next steps
- Offer to start dev server