Welcome! This guide walks you through the fastest way to stand up Stack Dyno locally and understand how the pieces connect.

1. Install prerequisites

• Node.js 20+ (nvm install 20 && nvm use 20).
• Python 3.11 for the FastAPI backend (used by the frontend-user app).
• Google Cloud CLI (optional, but recommended if you plan to connect a billing export later).

git clone https://github.com/stackdyno/stack-dyno-react.git
cd stack-dyno-react/website
npm install
npm run dev

2. Explore the apps

You can run each package in its own terminal and the Chakra UI theme keeps them visually consistent.

3. Update the basics

1. Swap the hero text in website/src/App.tsx.
2. Replace /public/img/stack_dyno_logo.png with your brand.
3. Update DemoForm.tsx with your Formspree or CRM endpoint.

4. Share with the team

• Commit changes to a feature branch.
• Deploy to your preferred static host (Cloud Storage, Netlify, or Vercel).
• Send the /docs/getting-started link so teammates have the same ramp plan.

You now have the baseline required to layer in live data, automation, and customer-specific stories.

---