Kinisi is a mobile-responsive web application that builds personalized, adaptive exercise programs using user input and generative AI. The platform guides users through an intake survey, generates a personalized assessment, and creates a tailored exercise program with scheduling.

• User authentication (email/password)
• Intake survey with dynamic form generation
• AI-generated personalized assessments
• Custom exercise program generation
• Session scheduling with calendar integration
• Chat-based feedback for program refinement

• Frontend: Next.js 15 with TypeScript
• Styling: Tailwind CSS
• Authentication: Supabase Auth
• Database: Supabase PostgreSQL
• AI/LLM: OpenAI GPT-3.5 Turbo (configurable) via LangChain
• Deployment: Vercel

• Node.js 20+
• pnpm
• Supabase account
• OpenAI API key

1. Clone the repository:

   git clone https://github.com/jakebutler/Kinisi.git
   cd Kinisi

2. Install dependencies:

   pnpm install

3. Set up environment variables: Create a .env.local (or .env) file in the repo root with at least:

   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Run the development server:

   pnpm dev

5. Open http://localhost:3000 in your browser.

These are required for authentication, secure registration, and email confirmation.

# Supabase (client)
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=

# Supabase (server)
SUPABASE_SERVICE_ROLE_KEY=

# Secure registration
ACCESS_CODE=

# Email (Resend)
RESEND_API_KEY=
EMAIL_FROM= "Your App <[email protected]>"

# Site URL (used for email confirmation redirect)
NEXT_PUBLIC_SITE_URL= "http://localhost:3000"

Notes:

• EMAIL_FROM should be a verified sender to avoid delivery issues.
• Confirmation emails redirect to ${NEXT_PUBLIC_SITE_URL}/survey after verification.
• For local dev, .env.local is recommended. In production, configure these in your hosting provider.

• Generic error messages returned to clients; full error details are logged server-side only.
• Strict input validation and safe narrowing of unknown types (avoid any).
• Narrowed database selects and minimal response payloads.
• Client requests only include required fields; unnecessary headers/bodies removed.

Kinisi/
├── app/                     # App Router (API routes under app/api/**)
│   ├── login/               # Login page
│   ├── register/            # Registration page
│   ├── forgot-password/     # Password reset
│   ├── dashboard/           # Protected dashboard
│   └── api/                 # Next.js API routes
├── components/              # Reusable components
│   ├── context/             # React context providers
│   ├── dashboard/           # Dashboard UI
│   ├── home/                # Landing page sections
│   └── program/             # Program actions & calendar UI
├── utils/                   # Utilities (Supabase client, chains, helpers)
├── types/                   # Shared TypeScript types
├── e2e/                     # Playwright E2E tests
├── __tests__/               # Jest unit/integration tests
├── public/                  # Static files
└── supabase/                # DB migrations and local dev tooling

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is private and confidential. Unauthorized copying, distribution, or modification is prohibited.