Merge pull request #1 from wesleylhandy/001-skitso-platform

Initialize Skitso Platform MVP

Author: wesleylhandy

.cursor/rules/specify-rules.mdc

@@ -0,0 +1,29 @@
+# skitso Development Guidelines
+
+Auto-generated from all feature plans. Last updated: 2026-01-19
+
+## Active Technologies
+
+- (001-skitso-platform)
+
+## Project Structure
+
+```text
+src/
+tests/
+```
+
+## Commands
+
+# Add commands for 
+
+## Code Style
+
+: Follow standard conventions
+
+## Recent Changes
+
+- 001-skitso-platform: Added
+
+<!-- MANUAL ADDITIONS START -->
+<!-- MANUAL ADDITIONS END -->

.env.example

@@ -0,0 +1,40 @@
+# OpenAI API Configuration
+OPENAI_API_KEY=your_openai_api_key_here
+OPENAI_MODEL_CHARACTER=gpt-5-mini
+OPENAI_MODEL_SCRIPT=gpt-5-mini
+OPENAI_MODEL_IMAGE_PROMPT=gpt-image-1.5
+
+# Application URL
+# Used for generating shareable session links (e.g., https://skitso.app/join/F1NMp8GR)
+# Development: http://localhost:3000
+# Production: https://skitso.app (or your production domain)
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+
+# PartyKit Configuration
+# Local development: Use localhost:1999 (PartyKit dev server default port)
+# Production: Use your deployed PartyKit host URL (e.g., https://skitso.[username].partykit.dev)
+# NEXT_PUBLIC_PARTYKIT_HOST=localhost:1999
+# NEXT_PUBLIC_PARTYKIT_HOST=https://skitso.[username].partykit.dev
+
+# PartyKit Token (CI/CD only - not needed for local development)
+# Generate using: npx partykit token generate
+# Store in GitHub Secrets for automated deployments
+# PARTYKIT_TOKEN=your_partykit_token_here
+
+# Cloudinary (character image storage: upload 512x512, compress, delete on room close)
+# Get credentials: https://console.cloudinary.com → API Keys
+# Required for Cloudinary; images fall back to data URLs / DALL·E URLs if unset.
+CLOUDINARY_CLOUD_NAME=your_cloud_name
+CLOUDINARY_API_KEY=your_api_key
+CLOUDINARY_API_SECRET=your_api_secret
+# Root folder (default: skitso). Match the folder in your upload preset.
+# SessionIds are subfolders: root/sessionId (e.g. skitso/abc123/char-0).
+# CLOUDINARY_ROOT_FOLDER=skitso
+# Upload preset from Console → Upload → Upload presets. Preset defines root folder;
+# we use root/sessionId for each room. Set folder = "skitso" (or same as ROOT_FOLDER) in preset.
+# CLOUDINARY_UPLOAD_PRESET=your_preset
+
+# Internal API secret (PartyKit → Next.js delete-session hook)
+# When a session expires, PartyKit calls POST /api/cloudinary/delete-session.
+# Set a random string; use the same value in Next.js and PartyKit env.
+# INTERNAL_API_SECRET=your_random_secret

.github/workflows/deploy-partykit.yml

@@ -0,0 +1,39 @@
+name: Deploy PartyKit Server
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "parties/**"
+      - "partykit.json"
+      - ".github/workflows/deploy-partykit.yml"
+
+jobs:
+  deploy:
+    name: Deploy to PartyKit
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Deploy to PartyKit
+        run: npx partykit deploy
+        env:
+          PARTYKIT_LOGIN: ${{ secrets.PARTYKIT_LOGIN }}
+          PARTYKIT_TOKEN: ${{ secrets.PARTYKIT_TOKEN }}
+
+      - name: Deployment status
+        run: |
+          echo "✅ PartyKit server deployed successfully"
+          echo "PartyKit host: https://skitso.${{ secrets.PARTYKIT_LOGIN }}.partykit.dev"

.gitignore

@@ -66,4 +66,7 @@ next-env.d.ts
 packages/database/prisma/migrations/
 
 # specstory
-.specstory
+.specstory
+
+# partykit
+.partykit/

.specify/memory/constitution.md

@@ -14,7 +14,7 @@ Follow-up TODOs: None
 
 # Skitso Project Constitution
 
-**Version:** 1.0.0  
+**Version:** 1.0.1  
 **Ratification Date:** 2025-01-27  
 **Last Amended:** 2025-01-27
 
@@ -152,7 +152,7 @@ This constitution establishes the foundational principles, technical standards,
 - **Framework:** Next.js 16+ (App Router) deployed on Vercel
 - **Styling:** Tailwind CSS v4 with CSS Variables for theming
 - **State Management:** Jotai with `atomWithStorage` for persistence
-- **AI Engine:** OpenAI API (GPT-4o for scripts/archetypes, DALL-E 3 for character art)
+- **AI Engine:** OpenAI API (GPT-4o for scripts/archetypes, gpt-image-1.5 for character art)
 - **Database/ORM (Post-MVP):** PostgreSQL with Prisma (schema migration ready)
 - **Type Safety:** TypeScript 5+ with strict mode
 
@@ -190,6 +190,7 @@ VibeContext MUST support at minimum:
 - `INDIE_A24`: Cinematic, artistic, nuanced dialogue
 - `SITCOM_STUDIO`: Classic TV comedy timing and structure
 - `BRAINROT_THEATER`: Absurdist, meme-heavy, chaotic energy
+- `QUIET_STUDIO`: Professional minimalist, anti-cringe, clean productivity tool
 
 ---
 
@@ -214,6 +215,7 @@ VibeContext MUST support at minimum:
 
 ### Version History
 
+- **1.0.1** (2025-01-27): Added QUIET_STUDIO to VibeContext types (constitution alignment fix)
 - **1.0.0** (2025-01-27): Initial constitution ratification
 
 ---