This project is governed by the DEFRAG Universal Charter and the Technical Addendum. All philosophy, architecture, and engineering standards are defined there.

1. Clone the repository
2. Install dependencies:

   npm install

3. Configure environment variables:
   • Copy .env.example to .env and fill in your Supabase, Stripe, and Modal.com credentials.
4. Run the development server:

   npm run dev

5. Open the dashboard: http://localhost:3000/dashboard

• Frontend: Deploy to Vercel. Set all environment variables in the Vercel dashboard.
• Backend (Python): Deploy FastAPI service to Railway, Render, or Modal.com. Ensure Swiss Ephemeris binaries are available.
• Database: Supabase (PostgreSQL). Apply schema from /supabase/migrations.

• DEFRAG Universal Charter
• Technical Addendum
• IDE Agent Handover

• New developers: Read the SSOT and Addendum before coding.
• Users: Log in, input your birth data, and explore your dashboard.

• For issues, open a GitHub issue or email [email protected]
• Feedback: Use the feedback widget in the dashboard footer.

• See the Charter for privacy, liability, and terms.

This is a category-defining platform. Build and operate with precision.