init repo

2026-06-23 11:27:05 +01:00
commit 2253b54077
37 changed files with 2382 additions and 0 deletions
@@ -0,0 +1,23 @@
+node_modules
+
+# Output
+.output
+.vercel
+.netlify
+.wrangler
+/.svelte-kit
+/build
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Env
+.env
+.env.*
+!.env.example
+!.env.test
+
+# Vite
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
@@ -0,0 +1 @@
+engine-strict=true
@@ -0,0 +1,3 @@
+{
+	"recommendations": ["svelte.svelte-vscode", "esbenp.prettier-vscode", "bradlc.vscode-tailwindcss"]
+}
@@ -0,0 +1,5 @@
+{
+	"files.associations": {
+		"*.css": "tailwindcss"
+	}
+}
@@ -0,0 +1,106 @@
+## Project Configuration
+
+- **Language**: TypeScript
+- **Package Manager**: pnpm
+- **Add-ons**: prettier, tailwindcss, sveltekit-adapter, experimental
+
+---
+
+# FamChore v2 — AI Agent Reference
+
+## Stack
+- SvelteKit (SSR frontend) + Hono proxy (same container, port :3001)
+- PocketBase (separate Coolify service at `pb.chores.app.com`, :8090)
+- Stripe one-time donations
+- Coolify CRON → `GET /api/weekly-cron`
+- Deployment: Coolify, Cloudflare DNS
+
+## Auth
+
+| Role | Auth | Session |
+|---|---|---|
+| Super admin (me) | PB email+pass | 24hr JWT |
+| Fam admin | PB email+pass | 24hr JWT, scoped to own fam |
+| Member | Invite code + device token | localStorage, no expiry |
+
+## PB Collections (all scoped by `famId`)
+
+- `fams` — name, slug, inviteCode, stripeCustomerId, featureFlags
+- `members` — famId, name, color, deviceToken(hashed), deviceTokenHint
+- `chore_templates` — famId, name, defaultValue, defaultFrequency
+- `assigned_chores` — famId, memberId, templateId, frequency, value
+- `completions` — famId, memberId, assignedChoreId, date
+- `weekly_history` — famId, memberId, weekStart, pointsEarned, moneyEarned
+- `rewards` — famId, memberId, source, label, value, claimed, claimedAt
+- `monthly_bonuses` — famId, month, prizeType, prizeValue, winnerMemberId
+- `settings` — famId, pointsThreshold, weeklyBonus, webhookUrl
+
+## Routes
+
+```
+/                    Landing (SaaS marketing)
+/admin               Admin panel - statistic dashboard, and any donations made
+/join/:code          Member invite code
+/{fam}               Fam dashboard
+/{fam}/admin         Admin panel
+/{fam}/:username     Member kanban (?token= for auth)
+/api/*               Hono proxy (webhooks, CRON)
+```
+
+## Data Flow
+
+- **Chore toggle:** Browser → PB SDK directly (auth via device token or admin JWT)
+- **Admin CRUD:** Browser → PB SDK (admin JWT)
+- **Reward creation:** After completion toggle, SvelteKit server creates reward if threshold met
+- **Weekly CRON:** Coolify → `GET /api/weekly-cron` on Hono → Hono queries PB, computes summaries, upserts weekly_history
+- **Strip donate:** Browser → Hono `/api/stripe/create-checkout` → Stripe → Hono webhook → update fam
+- **WhatsApp:** Deferred — Hono CRON handler has pluggable notification interface
+
+## Conventions
+
+- Every collection query includes `famId = @request.auth.famId` filter
+- Super admin bypasses famId filter (access via PB admin API)
+- `deviceToken` stored as SHA-256 hash; never log raw tokens
+- Environment: `PB_URL`, `PB_ADMIN_EMAIL`, `PB_ADMIN_PASSWORD`, `STRIPE_SECRET_KEY`, `DONATION_MODAL_INTERVAL`
+- Seed via JSON dump (portable for dev)
+- Monorepo: SvelteKit in `/src`, Hono in `/proxy`, two Dockerfiles
+
+## Build Phases (must validate each before next)
+
+### Phase 1 — Infrastructure
+1.1 Scaffold SvelteKit + Hono monorepo
+1.2 Write Dockerfiles (frontend + backend, correct port mapping)
+1.3 Deploy PocketBase on Coolify → validate data persists
+1.4 Deploy SvelteKit+Hono on Coolify → validate routing
+1.5 Validate Hono `/api/*` reachable, env vars injected
+1.6 Validate SvelteKit↔PB connectivity (admin API read/write)
+
+### Phase 2 — Backend Core
+2.1 Create PB collections via schema/migration
+2.2 Super admin seed + fam signup flow
+2.3 Fam admin login (email/pass → 24hr JWT)
+2.4 Invite code generation + member join flow
+2.5 Device token auth + route guards
+2.6 PB realtime SSE subscriptions from FE
+2.7 Remote functions (PB SDK client helpers)
+
+### Phase 3 — Backend Data Streams
+3.1 Chore template CRUD + assignment grid (admin)
+3.2 Completion toggle (member → PB direct)
+3.3 Weekly progress + history computation
+3.4 Reward auto-creation on threshold
+3.5 Reward claim flow + admin CRUD
+3.6 Monthly bonus evaluation
+3.7 CRON handler (Coolify → Hono)
+3.8 Stripe checkout + webhook
+3.9 Notification interface (WhatsApp deferred)
+
+### Phase 4 — Frontend App
+4.1 Member kanban (3-column, live SSE updates)
+4.2 Admin dashboard (weekly overview, chart)
+4.3 Admin panel (members, chores, rewards, settings)
+4.4 Landing page (SaaS marketing)
+4.5 Super admin stats dashboard
+4.6 Donation modal
+4.7 QR invite code
+4.8 Polish (loading, empty, error states, responsive)
@@ -0,0 +1,385 @@
+# FamChore v2 — Architecture & Developer Reference
+
+## Overview
+
+Multi-tenant chore tracking SaaS. Families ("fams") are isolated tenant groups. Fam admins use email/password. Members join via invite code + device token (no password). Super admin (you) can see everything.
+
+**Demo reference:** Current prototype at `/home/threejjjs/development/famchore/`
+
+---
+
+## 1. Stack
+
+| Component | Role | Deploy | Port |
+|---|---|---|---|
+| SvelteKit | SSR frontend, all UI | Coolify Docker (chores.app.com) | :3000 |
+| Hono proxy | Stripe, CRON, webhooks | Same container as SvelteKit, proxied via `/api/*` | :3001 (internal) |
+| PocketBase | DB, auth, realtime, storage, Admin UI | Coolify Docker (pb.chores.app.com) | :8090 |
+
+### Deployment Topology
+
+```
+chores.app.com ────┬──► SvelteKit (:3000)
+                    │      └── /api/* ──► Hono proxy (:3001)
+                    │
+pb.chores.app.com ──► PocketBase (:8090)
+                     │      Admin UI at /_
+                     │      Volume: /pb_data (persistence + backups)
+                     │
+stripe.com ─────────► Hono /api/stripe/webhook
+```
+
+---
+
+## 2. Auth Model
+
+### 2.1 Roles & Methods
+
+| Role | Auth | Session | Scope | PB Entity |
+|---|---|---|---|---|
+| **Super admin** (you) | PB email + password | 24hr JWT | All collections, all fams | PB `users` (set via seed) |
+| **Fam admin** | PB email + password | 24hr JWT | Their fam only | PB `users` |
+| **Member** | Invite code + device token | localStorage, no expiry | Own data only | `members` collection |
+
+### 2.2 Member Auth Flow
+
+1. Fam admin generates invite code → stored on `fams.inviteCode`
+2. Admin shares as text (`chores.app.com/join/XYZ123`) or QR code
+3. Member opens link, enters name, browser generates `crypto.randomUUID()` as device token
+4. PB API creates `members` record with SHA-256 hashed token
+5. Device token stored in `localStorage`, sent as `X-Device-Token` header
+6. If token lost → admin regenerates invite code, member re-registers
+7. Admin can revoke access by deleting member record
+
+### 2.3 PB Auth Rules (row-level security)
+
+Every collection has `famId` field. PB rule pattern:
+
+```
+famId = @request.auth.famId
+```
+
+Super admin bypasses via admin API (PB superuser credentials).
+
+---
+
+## 3. Data Model
+
+All collections live in PocketBase. Every tenant-scoped collection includes `famId` (relation to `fams`).
+
+### `fams`
+| Field | Type | Notes |
+|---|---|---|
+| `id` | auto | PB default |
+| `name` | text | Display name |
+| `slug` | text | URL segment, unique |
+| `inviteCode` | text | Short alphanumeric, regeneratable |
+| `stripeCustomerId` | text? | Set after first donation |
+| `featureFlags` | json | `{ "monthlyBonus": true }` |
+| `created` | auto | |
+
+### `members`
+| Field | Type | Notes |
+|---|---|---|
+| `famId` | relation→fams | |
+| `name` | text | |
+| `color` | text | Hex |
+| `deviceToken` | text | SHA-256 hash of raw token |
+| `deviceTokenHint` | text | First 8 chars of raw token (for admin display) |
+| `pointsThreshold` | number? | Override fam default |
+| `weeklyBonus` | number? | Override fam default |
+| `created` | auto | |
+
+### `chore_templates`
+| Field | Type | Notes |
+|---|---|---|
+| `famId` | relation→fams | |
+| `name` | text | |
+| `description` | text | |
+| `defaultFrequency` | select | `daily` or `weekly` |
+| `defaultType` | select | `points` or `money` |
+| `defaultValue` | number | |
+
+### `assigned_chores`
+| Field | Type | Notes |
+|---|---|---|
+| `famId` | relation→fams | |
+| `memberId` | relation→members | |
+| `templateId` | relation→chore_templates | |
+| `frequency` | select | |
+| `type` | select | |
+| `value` | number | |
+| `customName` | text? | |
+
+### `completions`
+| Field | Type | Notes |
+|---|---|---|
+| `famId` | relation→fams | |
+| `memberId` | relation→members | |
+| `assignedChoreId` | relation→assigned_chores | |
+| `date` | date | ISO date |
+| `completedAt` | auto | |
+
+### `rewards`
+| Field | Type | Notes |
+|---|---|---|
+| `famId` | relation→fams | |
+| `memberId` | relation→members | |
+| `source` | select | `weekly_bonus`, `monthly_bonus`, `custom` |
+| `label` | text | |
+| `value` | number | |
+| `weekStart` | date? | |
+| `month` | text? | "2026-06" |
+| `claimed` | bool | |
+| `claimedAt` | auto? | |
+
+### `weekly_history`
+| Field | Type |
+|---|---|
+| `famId` | relation→fams |
+| `memberId` | relation→members |
+| `weekStart` | date |
+| `pointsEarned` | number |
+| `moneyEarned` | number |
+| `choresCompleted` | number |
+| `bonusEarned` | number |
+
+### `monthly_bonuses`
+| Field | Type | Notes |
+|---|---|---|
+| `famId` | relation→fams | |
+| `month` | text | "2026-06" |
+| `prizeType` | select | `cash`, `string` |
+| `prizeValue` | text | |
+| `winnerMemberId` | relation→members? | Nullable until computed |
+| `pointsScored` | number? | |
+| `claimed` | bool | |
+
+### `settings` (singleton per fam)
+| Field | Type | Notes |
+|---|---|---|
+| `famId` | relation→fams | Unique |
+| `pointsThreshold` | number | Default: 100 |
+| `weeklyBonus` | number | Default: 2 (e.g. £2) |
+| `webhookUrl` | text? | N8N/notification URL |
+
+---
+
+## 4. Routes
+
+### SvelteKit
+
+```
+/                          Landing page (SaaS marketing)
+/join/:code                Member invite code + name entry
+
+/{fam}                     Fam dashboard (weekly overview)
+/{fam}/admin               Admin panel
+/{fam}/admin/chores        Chore template CRUD + assignment grid
+/{fam}/admin/rewards       Reward management, claim history
+/{fam}/admin/settings      Thresholds, webhook, invite code, features
+
+/{fam}/:username           Member kanban
+  ?token=<deviceToken>     Auto-auth via query param (from QR/share)
+```
+
+### Hono proxy (`/api/*`)
+
+```
+/api/stripe/create-checkout    Create Stripe Checkout Session
+/api/stripe/webhook            Stripe event webhook
+/api/weekly-cron               Coolify CRON target
+```
+
+---
+
+## 5. Data Flow
+
+### 5.1 Chore Toggle
+
+```
+User clicks checkbox
+  → Browser → PB SDK (direct, auth= device token or admin JWT)
+    → PB inserts/deletes completion
+      → PB realtime SSE push to all subscribers
+        → UI updates (kanban card, progress bar, money counter)
+          → If weekly threshold crossed:
+            → SvelteKit server handler creates Reward (weekly_bonus)
+```
+
+### 5.2 Weekly CRON
+
+Triggered by Coolify CRON job → `GET /api/weekly-cron`:
+
+```
+Hono receives request
+  → Queries all fams
+  → For each fam:
+    → Compute weekly summaries per member (completions tally)
+    → Upsert weekly_history records
+    → Evaluate monthly bonus (end-of-month)
+    → If webhookUrl set on fam settings:
+      → POST summary to webhook (pluggable — WhatsApp later)
+  → Returns 200
+```
+
+### 5.3 Stripe Donation
+
+```
+User clicks "Donate" on landing or modal
+  → Hono /api/stripe/create-checkout
+    → Creates Stripe Checkout Session
+    → Returns session.url → redirect user to Stripe
+  → Stripe redirects back to app
+  → Stripe webhook → Hono /api/stripe/webhook
+    → Updates fam.stripeCustomerId
+    → Sets fam.featureFlags.donated = true (or similar)
+```
+
+### 5.4 Admin CRUD
+
+All admin operations go through PB admin API (Hono proxy or `+page.server.ts`). This ensures:
+- Server-side validation of famId
+- Audit trail option
+- Consistent error handling
+
+---
+
+## 6. Project Structure
+
+```
+/chores
+  /src                     SvelteKit app
+    /lib
+      /components           Shared UI components
+      /stores               Svelte stores (auth, current fam)
+      /pb                   PB SDK client helpers
+    /routes                 SvelteKit file-based routing
+    /hooks.server.ts        Auth hooks, PB client init
+  /proxy                    Hono proxy
+    /src
+      /routes               Stripe webhook, CRON handler
+      /services             PB admin client, notification service
+    package.json
+  /seed                     JSON dump files for PB collections
+  /pb                       PB collection schema definitions
+  package.json              Workspace root
+  Dockerfile.frontend       SvelteKit + Hono build
+  Dockerfile.backend        PocketBase (custom, or use official image)
+  coolify.json              Coolify deployment config (optional)
+  AGENTS.md                 AI reference (this file's sibling)
+  ARCHITECTURE.md           This document
+```
+
+---
+
+## 7. Environment Variables
+
+### Frontend + Hono container
+```
+PUBLIC_PB_URL=https://pb.chores.app.com
+PB_ADMIN_EMAIL=admin@chores.app
+PB_ADMIN_PASSWORD=<super-admin-password>
+STRIPE_SECRET_KEY=sk_live_xxx
+STRIPE_WEBHOOK_SECRET=whsec_xxx
+DONATION_MODAL_INTERVAL=30
+```
+
+### PocketBase container
+```
+PB_SUPERUSER_EMAIL=you@email.com
+PB_SUPERUSER_PASSWORD=<your-password>
+```
+
+---
+
+## 8. Implementation Phases
+
+### Phase 0 — Infrastructure (2-4 hrs)
+- [ ] Deploy PocketBase on Coolify (`pb.chores.app.com`)
+  - Official `pocketbase/pocketbase` image
+  - Mount `/pb_data` volume
+  - Set super admin env vars
+  - Test: visit `pb.chores.app.com/_/`, login, data persists after restart
+- [ ] Scaffold monorepo with SvelteKit + Hono
+- [ ] Create Dockerfiles
+- [ ] Deploy to Coolify (`chores.app.com`)
+- [ ] Cloudflare DNS for both
+
+### Phase 1 — Auth (4-6 hrs)
+- [ ] Create PB collections: `fams`, `members`, `settings`
+- [ ] Super admin seed script
+- [ ] Fam signup → PB user + fam record
+- [ ] Fam admin login (24hr JWT)
+- [ ] Invite code generation
+- [ ] Member join page (`/join/:code`)
+- [ ] Device token auth
+- [ ] Route guards
+- [ ] Seed data (1 fam + 3 members + chores matching demo)
+
+### Phase 2 — Core Chore Tracking (6-8 hrs)
+- [ ] PB collections: `chore_templates`, `assigned_chores`, `completions`, `weekly_history`
+- [ ] Admin chore CRUD
+- [ ] Admin chore assignment grid
+- [ ] Member kanban (3 columns: Daily Pending, Weekly Pending, Completed)
+- [ ] Completion toggle
+- [ ] Realtime updates (PB SSE)
+- [ ] Weekly progress + chart
+- [ ] Admin dashboard
+
+### Phase 3 — Rewards + Claims (3-4 hrs)
+- [ ] PB collection: `rewards`
+- [ ] Auto-create weekly bonus reward on threshold
+- [ ] Claim section with visual feedback
+- [ ] Admin reward CRUD
+- [ ] Monthly bonus (set prize → compute winner → create reward)
+- [ ] Pluggable notification interface in CRON handler
+
+### Phase 4 — SaaS (4-6 hrs)
+- [ ] Landing page (hero, features, CTA)
+- [ ] Stripe one-time checkout (Hono)
+- [ ] Donation modal (triggered after N admin page loads)
+- [ ] Feature flags (checked in routes via settings)
+- [ ] Super admin dashboard (stats, all-fams view, feature toggles)
+
+### Phase 5 — Polish (ongoing)
+- [ ] QR invite code
+- [ ] PB backup scheduler
+- [ ] Error/loading/empty states
+- [ ] Responsive mobile layout
+- [ ] Accessibility
+
+---
+
+## 9. Key Conventions
+
+- **`famId` on every query** — PB auth rules enforce `famId = @request.auth.famId`
+- **PB SDK client-side for members** — Browser talks to PB directly for toggles, reads. PB auth rules handle security.
+- **PB admin API server-side for admins** — Hono proxy or SvelteKit server handlers for admin CRUD.
+- **Device tokens as SHA-256** — Never store or log raw tokens.
+- **JSON dump for seed data** — Portable, version-controllable, restorable via PB backup CLI.
+- **All collection schema files in `/pb/`** — Tracked in git, used for CI/CD schema migration.
+- **Notifications via pluggable interface** — Hono CRON handler has `NotificationService` interface; WhatsApp is one implementation (deferred).
+
+---
+
+## 10. Open / Deferred
+
+- **WhatsApp notifications** — Will be implemented as a `NotificationService` plugin for the weekly CRON handler. N8N or Twilio, TBD.
+- **Subscription payments** — Currently one-time donation only. Subscription model can be added later via Stripe webhooks.
+- **Member re-auth on new device** — Current design requires admin to regenerate invite code. Could add "re-issue link" feature in admin panel.
+- **Multi-language** — Not yet scoped. All text in English for now.
+
+---
+
+## 11. Reference: Current Prototype
+
+The existing HonoJS prototype at `/home/threejjjs/development/famchore/` contains the reference logic for:
+- Weekly bonus calculation (`src/services.ts` → `checkWeeklyBonus`)
+- Monthly bonus evaluation
+- Reward claim flow
+- Chore toggle event delegation
+- Chart/stat formatting
+- Date/timezone helpers
+
+Refer to `src/types.ts` for the original type definitions, and `src/views/` for the Alpine.js template structure that maps to the new SvelteKit components.
@@ -0,0 +1,42 @@
+# sv
+
+Everything you need to build a Svelte project, powered by [`sv`](https://github.com/sveltejs/cli).
+
+## Creating a project
+
+If you're seeing this, you've probably already done this step. Congrats!
+
+```sh
+# create a new project
+npx sv create my-app
+```
+
+To recreate this project with the same configuration:
+
+```sh
+# recreate this project
+pnpm dlx sv@0.16.1 create --template minimal --types ts --add prettier tailwindcss="plugins:none" sveltekit-adapter="adapter:node" experimental="versions:kit+features:async,remoteFunctions,explicitEnvironmentVariables,handleRenderingErrors" --install pnpm .
+```
+
+## Developing
+
+Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server:
+
+```sh
+npm run dev
+
+# or start the server and open the app in a new browser tab
+npm run dev -- --open
+```
+
+## Building
+
+To create a production version of your app:
+
+```sh
+npm run build
+```
+
+You can preview the production build with `npm run preview`.
+
+> To deploy your app, you may need to install an [adapter](https://svelte.dev/docs/kit/adapters) for your target environment.
@@ -0,0 +1 @@
+export const PROXY_PORT = 3456;
@@ -0,0 +1,9 @@
+# Package Managers
+package-lock.json
+pnpm-lock.yaml
+yarn.lock
+bun.lock
+bun.lockb
+
+# Miscellaneous
+/static/
@@ -0,0 +1,16 @@
+{
+	"useTabs": true,
+	"singleQuote": true,
+	"trailingComma": "none",
+	"printWidth": 100,
+	"plugins": ["prettier-plugin-svelte", "prettier-plugin-tailwindcss"],
+	"overrides": [
+		{
+			"files": "*.svelte",
+			"options": {
+				"parser": "svelte"
+			}
+		}
+	],
+	"tailwindStylesheet": "./src/routes/layout.css"
+}
@@ -0,0 +1,3 @@
+// this file is generated — do not edit it
+
+/// <reference types="@sveltejs/kit" />
@@ -0,0 +1,9 @@
+// See https://svelte.dev/docs/kit/environment-variables for more information
+
+declare module '$app/env/private' {
+	// no private environment variables were defined
+}
+
+declare module '$app/env/public' {
+	// no public environment variables were defined
+}
@@ -0,0 +1,29 @@
+export { matchers } from './matchers.js';
+
+export const nodes = [
+	() => import('./nodes/0'),
+	() => import('./nodes/1'),
+	() => import('./nodes/2')
+];
+
+export const server_loads = [];
+
+export const dictionary = {
+		"/": [2]
+	};
+
+export const hooks = {
+	handleError: (({ error }) => { console.error(error) }),
+	
+	reroute: (() => {}),
+	transport: {}
+};
+
+export const decoders = Object.fromEntries(Object.entries(hooks.transport).map(([k, v]) => [k, v.decode]));
+export const encoders = Object.fromEntries(Object.entries(hooks.transport).map(([k, v]) => [k, v.encode]));
+
+export const hash = false;
+
+export const decode = (type, value) => decoders[type](value);
+
+export { default as root } from '../root.js';
@@ -0,0 +1 @@
+export const matchers = {};
@@ -0,0 +1 @@
+export { default as component } from "../../../../src/routes/+layout.svelte";
@@ -0,0 +1 @@
+export { default as component } from "../../../../node_modules/.pnpm/@sveltejs+kit@3.0.0-next.4_@sveltejs+vite-plugin-svelte@7.1.2_svelte@5.56.3_vite@8.0.16_8dfd504a6c74c36e5d149ff76188a39d/node_modules/@sveltejs/kit/src/runtime/components/error.svelte";
@@ -0,0 +1 @@
+export { default as component } from "../../../../src/routes/+page.svelte";
@@ -0,0 +1,3 @@
+import { asClassComponent } from 'svelte/legacy';
+import Root from './root.svelte';
+export default asClassComponent(Root);
@@ -0,0 +1,75 @@
+<!-- This file is generated by @sveltejs/kit — do not edit it! -->
+<svelte:options runes={true} />
+<script>
+	import { setContext, onMount, tick } from 'svelte';
+	import { browser } from '$app/env';
+
+	// stores
+	let { stores, page, constructors, components = [], form, errors = [], error, data_0 = null, data_1 = null } = $props();
+	let data = $derived({'0': data_0, '1': data_1})
+
+	if (browser) {
+		$effect.pre(() => stores.page.set(page));
+	} else {
+		// svelte-ignore state_referenced_locally
+		setContext('__svelte__', stores);
+		// svelte-ignore state_referenced_locally
+		stores.page.set(page);
+	}
+
+	$effect(() => {
+		stores;page;constructors;components;form;errors;error;data_0;data_1;
+		stores.page.notify();
+	});
+
+	let mounted = $state(false);
+	let navigated = $state(false);
+	let title = $state(null);
+
+	onMount(() => {
+		const unsubscribe = stores.page.subscribe(() => {
+			if (mounted) {
+				navigated = true;
+				tick().then(() => {
+					title = document.title || 'untitled page';
+				});
+			}
+		});
+
+		mounted = true;
+		return unsubscribe;
+	});
+
+	const Pyramid_1 = $derived(constructors[1]);
+</script>
+
+{#snippet pyramid(depth)}
+	{@const Pyramid = constructors[depth]}
+	{#snippet failed(error)}
+		{@const ErrorPage = errors[depth]}
+		<ErrorPage {error} />
+	{/snippet}
+	<svelte:boundary failed={errors[depth] ? failed : undefined}>
+		{#if constructors[depth + 1]}
+			{@const d = data[depth]}
+			<!-- svelte-ignore binding_property_non_reactive -->
+			<Pyramid bind:this={components[depth]} data={d} {form} params={page.params}>
+				{@render pyramid(depth + 1)}
+			</Pyramid>
+		{:else}
+			{@const d = data[depth]}
+			<!-- svelte-ignore binding_property_non_reactive -->
+			<Pyramid bind:this={components[depth]} data={d} {form} params={page.params} {error} />
+		{/if}
+	</svelte:boundary>
+{/snippet}
+
+{@render pyramid(0)}
+
+{#if mounted}
+	<div id="svelte-announcer" aria-live="assertive" aria-atomic="true" style="position: absolute; left: 0; top: 0; clip: rect(0 0 0 0); clip-path: inset(50%); overflow: hidden; white-space: nowrap; width: 1px; height: 1px">
+		{#if navigated}
+			{title}
+		{/if}
+	</div>
+{/if}
@@ -0,0 +1,52 @@
+
+import root from '../root.js';
+import { set_building, set_prerendering } from '$app/env/internal';
+import { set_assets } from '$app/paths/internal/server';
+import { set_manifest, set_read_implementation } from '__sveltekit/server';
+import { set_env } from '__sveltekit/env';
+
+export const options = {
+	app_template_contains_nonce: false,
+	async: true,
+	csp: {"mode":"auto","directives":{"upgrade-insecure-requests":false,"block-all-mixed-content":false},"reportOnly":{"upgrade-insecure-requests":false,"block-all-mixed-content":false}},
+	csrf_check_origin: true,
+	csrf_trusted_origins: [],
+	embedded: false,
+	hash_routing: false,
+	hooks: null, // added lazily, via `get_hooks`
+	link_header_preload: false,
+	root,
+	service_worker: false,
+	service_worker_options: undefined,
+	server_error_boundaries: true,
+	templates: {
+		app: ({ head, body, assets, nonce, env }) => "<!doctype html>\n<html lang=\"en\">\n\t<head>\n\t\t<meta charset=\"utf-8\" />\n\t\t<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n\t\t<meta name=\"text-scale\" content=\"scale\" />\n\t\t" + head + "\n\t</head>\n\t<body data-sveltekit-preload-data=\"hover\">\n\t\t<div style=\"display: contents\">" + body + "</div>\n\t</body>\n</html>\n",
+		error: ({ status, message }) => "<!doctype html>\n<html lang=\"en\">\n\t<head>\n\t\t<meta charset=\"utf-8\" />\n\t\t<title>" + message + "</title>\n\n\t\t<style>\n\t\t\tbody {\n\t\t\t\t--bg: white;\n\t\t\t\t--fg: #222;\n\t\t\t\t--divider: #ccc;\n\t\t\t\tbackground: var(--bg);\n\t\t\t\tcolor: var(--fg);\n\t\t\t\tfont-family:\n\t\t\t\t\tsystem-ui,\n\t\t\t\t\t-apple-system,\n\t\t\t\t\tBlinkMacSystemFont,\n\t\t\t\t\t'Segoe UI',\n\t\t\t\t\tRoboto,\n\t\t\t\t\tOxygen,\n\t\t\t\t\tUbuntu,\n\t\t\t\t\tCantarell,\n\t\t\t\t\t'Open Sans',\n\t\t\t\t\t'Helvetica Neue',\n\t\t\t\t\tsans-serif;\n\t\t\t\tdisplay: flex;\n\t\t\t\talign-items: center;\n\t\t\t\tjustify-content: center;\n\t\t\t\theight: 100vh;\n\t\t\t\tmargin: 0;\n\t\t\t}\n\n\t\t\t.error {\n\t\t\t\tdisplay: flex;\n\t\t\t\talign-items: center;\n\t\t\t\tmax-width: 32rem;\n\t\t\t\tmargin: 0 1rem;\n\t\t\t}\n\n\t\t\t.status {\n\t\t\t\tfont-weight: 200;\n\t\t\t\tfont-size: 3rem;\n\t\t\t\tline-height: 1;\n\t\t\t\tposition: relative;\n\t\t\t\ttop: -0.05rem;\n\t\t\t}\n\n\t\t\t.message {\n\t\t\t\tborder-left: 1px solid var(--divider);\n\t\t\t\tpadding: 0 0 0 1rem;\n\t\t\t\tmargin: 0 0 0 1rem;\n\t\t\t\tmin-height: 2.5rem;\n\t\t\t\tdisplay: flex;\n\t\t\t\talign-items: center;\n\t\t\t}\n\n\t\t\t.message h1 {\n\t\t\t\tfont-weight: 400;\n\t\t\t\tfont-size: 1em;\n\t\t\t\tmargin: 0;\n\t\t\t}\n\n\t\t\t@media (prefers-color-scheme: dark) {\n\t\t\t\tbody {\n\t\t\t\t\t--bg: #222;\n\t\t\t\t\t--fg: #ddd;\n\t\t\t\t\t--divider: #666;\n\t\t\t\t}\n\t\t\t}\n\t\t</style>\n\t</head>\n\t<body>\n\t\t<div class=\"error\">\n\t\t\t<span class=\"status\">" + status + "</span>\n\t\t\t<div class=\"message\">\n\t\t\t\t<h1>" + message + "</h1>\n\t\t\t</div>\n\t\t</div>\n\t</body>\n</html>\n"
+	},
+	version_hash: "3gjt3w"
+};
+
+export async function get_hooks() {
+	let handle;
+	let handleFetch;
+	let handleError;
+	let handleValidationError;
+	let init;
+	
+
+	let reroute;
+	let transport;
+	
+
+	return {
+		handle,
+		handleFetch,
+		handleError,
+		handleValidationError,
+		init,
+		reroute,
+		transport
+	};
+}
+
+export { set_assets, set_building, set_env, set_manifest, set_prerendering, set_read_implementation };
@@ -0,0 +1,43 @@
+
+// this file is generated — do not edit it
+
+
+declare module "svelte/elements" {
+	export interface HTMLAttributes<T> {
+		'data-sveltekit-keepfocus'?: true | false | '' | undefined | null;
+		'data-sveltekit-noscroll'?: true | false | '' | undefined | null;
+		'data-sveltekit-preload-code'?:
+			| true
+			| false
+			| ''
+			| 'eager'
+			| 'viewport'
+			| 'hover'
+			| 'tap'
+			| undefined
+			| null;
+		'data-sveltekit-preload-data'?: true | false | '' | 'hover' | 'tap' | undefined | null;
+		'data-sveltekit-reload'?: true | false | '' | undefined | null;
+		'data-sveltekit-replacestate'?: true | false | '' | undefined | null;
+	}
+}
+
+export {};
+
+
+declare module "$app/types" {
+	type MatcherParam<M> = M extends (param : string) => param is (infer U extends string) ? U : string;
+
+	export interface AppTypes {
+		RouteId(): "/";
+		RouteParams(): {
+			
+		};
+		LayoutParams(): {
+			"/": Record<string, never>
+		};
+		Pathname(): "/";
+		ResolvedPathname(): `${"" | `/${string}`}${ReturnType<AppTypes['Pathname']>}`;
+		Asset(): "/robots.txt" | string & {};
+	}
+}
@@ -0,0 +1,60 @@
+{
+	"compilerOptions": {
+		"paths": {
+			"$lib": [
+				"../src/lib"
+			],
+			"$lib/*": [
+				"../src/lib/*"
+			],
+			"$app/types": [
+				"./types/index.d.ts"
+			]
+		},
+		"rootDirs": [
+			"..",
+			"./types"
+		],
+		"verbatimModuleSyntax": true,
+		"isolatedModules": true,
+		"lib": [
+			"esnext",
+			"DOM",
+			"DOM.Iterable"
+		],
+		"moduleResolution": "bundler",
+		"module": "esnext",
+		"noEmit": true,
+		"target": "esnext",
+		"types": [
+			"node"
+		]
+	},
+	"include": [
+		"ambient.d.ts",
+		"env.d.ts",
+		"non-ambient.d.ts",
+		"./types/**/$types.d.ts",
+		"../svelte.config.js",
+		"../vite.config.js",
+		"../vite.config.ts",
+		"../src/**/*.js",
+		"../src/**/*.ts",
+		"../src/**/*.svelte",
+		"../test/**/*.js",
+		"../test/**/*.ts",
+		"../test/**/*.svelte",
+		"../tests/**/*.js",
+		"../tests/**/*.ts",
+		"../tests/**/*.svelte"
+	],
+	"exclude": [
+		"../node_modules/**",
+		"../src/service-worker.js",
+		"../src/service-worker/**/*.js",
+		"../src/service-worker.ts",
+		"../src/service-worker/**/*.ts",
+		"../src/service-worker.d.ts",
+		"../src/service-worker/**/*.d.ts"
+	]
+}
@@ -0,0 +1,3 @@
+{
+	"/": []
+}
@@ -0,0 +1,23 @@
+import type * as Kit from '@sveltejs/kit';
+
+type Expand<T> = T extends infer O ? { [K in keyof O]: O[K] } : never;
+type MatcherParam<M> = M extends (param : string) => param is (infer U extends string) ? U : string;
+type RouteParams = {  };
+type RouteId = '/';
+type MaybeWithVoid<T> = {} extends T ? T | void : T;
+export type RequiredKeys<T> = { [K in keyof T]-?: {} extends { [P in K]: T[K] } ? never : K; }[keyof T];
+type OutputDataShape<T> = MaybeWithVoid<Omit<App.PageData, RequiredKeys<T>> & Partial<Pick<App.PageData, keyof T & keyof App.PageData>> & Record<string, any>>
+type EnsureDefined<T> = T extends null | undefined ? {} : T;
+type OptionalUnion<U extends Record<string, any>, A extends keyof U = U extends U ? keyof U : never> = U extends unknown ? { [P in Exclude<A, keyof U>]?: never } & U : never;
+export type Snapshot<T = any> = Kit.Snapshot<T>;
+type PageParentData = EnsureDefined<LayoutData>;
+type LayoutRouteId = RouteId | "/" | null
+type LayoutParams = RouteParams & {  }
+type LayoutParentData = EnsureDefined<{}>;
+
+export type PageServerData = null;
+export type PageData = Expand<PageParentData>;
+export type PageProps = { params: RouteParams; data: PageData }
+export type LayoutServerData = null;
+export type LayoutData = Expand<LayoutParentData>;
+export type LayoutProps = { params: LayoutParams; data: LayoutData; children: import("svelte").Snippet }
@@ -0,0 +1,31 @@
+{
+	"name": "famchamp",
+	"private": true,
+	"version": "0.0.1",
+	"type": "module",
+	"scripts": {
+		"dev": "vite dev",
+		"build": "vite build",
+		"preview": "vite preview",
+		"prepare": "svelte-kit sync || echo ''",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"lint": "prettier --check .",
+		"format": "prettier --write ."
+	},
+	"devDependencies": {
+		"@sveltejs/adapter-node": "next",
+		"@sveltejs/kit": "next",
+		"@sveltejs/vite-plugin-svelte": "^7.1.2",
+		"@tailwindcss/vite": "^4.3.0",
+		"@types/node": "^26.0.0",
+		"prettier": "^3.8.3",
+		"prettier-plugin-svelte": "^4.1.0",
+		"prettier-plugin-tailwindcss": "^0.8.0",
+		"svelte": "^5.56.1",
+		"svelte-check": "^4.6.0",
+		"tailwindcss": "^4.3.0",
+		"typescript": "^6.0.3",
+		"vite": "^8.0.16"
+	}
+}
@@ -0,0 +1,13 @@
+// See https://svelte.dev/docs/kit/types#app.d.ts
+// for information about these interfaces
+declare global {
+	namespace App {
+		// interface Error {}
+		// interface Locals {}
+		// interface PageData {}
+		// interface PageState {}
+		// interface Platform {}
+	}
+}
+
+export {};
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		<meta name="text-scale" content="scale" />
+		%sveltekit.head%
+	</head>
+	<body data-sveltekit-preload-data="hover">
+		<div style="display: contents">%sveltekit.body%</div>
+	</body>
+</html>
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="107" height="128" viewBox="0 0 107 128"><title>svelte-logo</title><path d="M94.157 22.819c-10.4-14.885-30.94-19.297-45.792-9.835L22.282 29.608A29.92 29.92 0 0 0 8.764 49.65a31.5 31.5 0 0 0 3.108 20.231 30 30 0 0 0-4.477 11.183 31.9 31.9 0 0 0 5.448 24.116c10.402 14.887 30.942 19.297 45.791 9.835l26.083-16.624A29.92 29.92 0 0 0 98.235 78.35a31.53 31.53 0 0 0-3.105-20.232 30 30 0 0 0 4.474-11.182 31.88 31.88 0 0 0-5.447-24.116" style="fill:#ff3e00"/><path d="M45.817 106.582a20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.503 18 18 0 0 1 .624-2.435l.49-1.498 1.337.981a33.6 33.6 0 0 0 10.203 5.098l.97.294-.09.968a5.85 5.85 0 0 0 1.052 3.878 6.24 6.24 0 0 0 6.695 2.485 5.8 5.8 0 0 0 1.603-.704L69.27 76.28a5.43 5.43 0 0 0 2.45-3.631 5.8 5.8 0 0 0-.987-4.371 6.24 6.24 0 0 0-6.698-2.487 5.7 5.7 0 0 0-1.6.704l-9.953 6.345a19 19 0 0 1-5.296 2.326 20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.502 17.99 17.99 0 0 1 8.13-12.052l26.081-16.623a19 19 0 0 1 5.3-2.329 20.72 20.72 0 0 1 22.237 8.243 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-.624 2.435l-.49 1.498-1.337-.98a33.6 33.6 0 0 0-10.203-5.1l-.97-.294.09-.968a5.86 5.86 0 0 0-1.052-3.878 6.24 6.24 0 0 0-6.696-2.485 5.8 5.8 0 0 0-1.602.704L37.73 51.72a5.42 5.42 0 0 0-2.449 3.63 5.79 5.79 0 0 0 .986 4.372 6.24 6.24 0 0 0 6.698 2.486 5.8 5.8 0 0 0 1.602-.704l9.952-6.342a19 19 0 0 1 5.295-2.328 20.72 20.72 0 0 1 22.237 8.242 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-8.13 12.053l-26.081 16.622a19 19 0 0 1-5.3 2.328" style="fill:#fff"/></svg>
@@ -0,0 +1 @@
+// place files you want to import through the `$lib` alias in this folder.
@@ -0,0 +1,9 @@
+<script lang="ts">
+	import './layout.css';
+	import favicon from '$lib/assets/favicon.svg';
+
+	let { children } = $props();
+</script>
+
+<svelte:head><link rel="icon" href={favicon} /></svelte:head>
+{@render children()}
@@ -0,0 +1,2 @@
+<h1>Welcome to SvelteKit</h1>
+<p>Visit <a href="https://svelte.dev/docs/kit">svelte.dev/docs/kit</a> to read the documentation</p>
@@ -0,0 +1 @@
+@import 'tailwindcss';
@@ -0,0 +1,3 @@
+# allow crawling everything by default
+User-agent: *
+Disallow:
@@ -0,0 +1,20 @@
+{
+	"extends": "./.svelte-kit/tsconfig.json",
+	"compilerOptions": {
+		"rewriteRelativeImportExtensions": true,
+		"allowJs": true,
+		"checkJs": true,
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+		"sourceMap": true,
+		"strict": true,
+		"moduleResolution": "bundler"
+	}
+	// Path aliases are handled by https://svelte.dev/docs/kit/configuration#alias
+	// except $lib which is handled by https://svelte.dev/docs/kit/configuration#files
+	//
+	// To make changes to top-level options such as include and exclude, we recommend extending
+	// the generated config; see https://svelte.dev/docs/kit/configuration#typescript
+}
@@ -0,0 +1,29 @@
+import tailwindcss from '@tailwindcss/vite';
+import adapter from '@sveltejs/adapter-node';
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+import { PROXY_PORT } from '../config';
+
+export default defineConfig({
+	plugins: [
+		tailwindcss(),
+		sveltekit({
+			compilerOptions: {
+				// Force runes mode for the project, except for libraries. Can be removed in svelte 6.
+				runes: ({ filename }) =>
+					filename.split(/[/\\]/).includes('node_modules') ? undefined : true,
+				experimental: { async: true }
+			},
+			adapter: adapter(),
+			experimental: { remoteFunctions: true, handleRenderingErrors: true }
+		})
+	],
+	server: {
+		proxy: {
+			'/api': {
+				target: `http://localhost:${PROXY_PORT}`,
+				changeOrigin: true
+			}
+		}
+	}
+});
@@ -0,0 +1,7 @@
+packages:
+  - 'frontend'
+  - 'proxy'
+
+onlyBuiltDependencies:
+  - '@tailwindcss/oxide'
+  - esbuild
				`@@ -0,0 +1 @@`
				`export { default as component } from "../../../../src/routes/+layout.svelte";`
				`@@ -0,0 +1 @@`
				<svg xmlns="http://www.w3.org/2000/svg" width="107" height="128" viewBox="0 0 107 128"><title>svelte-logo</title><path d="M94.157 22.819c-10.4-14.885-30.94-19.297-45.792-9.835L22.282 29.608A29.92 29.92 0 0 0 8.764 49.65a31.5 31.5 0 0 0 3.108 20.231 30 30 0 0 0-4.477 11.183 31.9 31.9 0 0 0 5.448 24.116c10.402 14.887 30.942 19.297 45.791 9.835l26.083-16.624A29.92 29.92 0 0 0 98.235 78.35a31.53 31.53 0 0 0-3.105-20.232 30 30 0 0 0 4.474-11.182 31.88 31.88 0 0 0-5.447-24.116" style="fill:#ff3e00"/><path d="M45.817 106.582a20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.503 18 18 0 0 1 .624-2.435l.49-1.498 1.337.981a33.6 33.6 0 0 0 10.203 5.098l.97.294-.09.968a5.85 5.85 0 0 0 1.052 3.878 6.24 6.24 0 0 0 6.695 2.485 5.8 5.8 0 0 0 1.603-.704L69.27 76.28a5.43 5.43 0 0 0 2.45-3.631 5.8 5.8 0 0 0-.987-4.371 6.24 6.24 0 0 0-6.698-2.487 5.7 5.7 0 0 0-1.6.704l-9.953 6.345a19 19 0 0 1-5.296 2.326 20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.502 17.99 17.99 0 0 1 8.13-12.052l26.081-16.623a19 19 0 0 1 5.3-2.329 20.72 20.72 0 0 1 22.237 8.243 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-.624 2.435l-.49 1.498-1.337-.98a33.6 33.6 0 0 0-10.203-5.1l-.97-.294.09-.968a5.86 5.86 0 0 0-1.052-3.878 6.24 6.24 0 0 0-6.696-2.485 5.8 5.8 0 0 0-1.602.704L37.73 51.72a5.42 5.42 0 0 0-2.449 3.63 5.79 5.79 0 0 0 .986 4.372 6.24 6.24 0 0 0 6.698 2.486 5.8 5.8 0 0 0 1.602-.704l9.952-6.342a19 19 0 0 1 5.295-2.328 20.72 20.72 0 0 1 22.237 8.242 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-8.13 12.053l-26.081 16.622a19 19 0 0 1-5.3 2.328" style="fill:#fff"/></svg>
				`@@ -0,0 +1 @@`
				// place files you want to import through the `$lib` alias in this folder.