website-xp-phone 1.5.0

package/.astro/content-assets.mjs

@@ -0,0 +1 @@
+export default new Map();

package/.astro/content-modules.mjs

@@ -0,0 +1 @@
+export default new Map();

package/.astro/content.d.ts

@@ -0,0 +1,199 @@
+declare module 'astro:content' {
+	export interface RenderResult {
+		Content: import('astro/runtime/server/index.js').AstroComponentFactory;
+		headings: import('astro').MarkdownHeading[];
+		remarkPluginFrontmatter: Record<string, any>;
+	}
+	interface Render {
+		'.md': Promise<RenderResult>;
+	}
+
+	export interface RenderedContent {
+		html: string;
+		metadata?: {
+			imagePaths: Array<string>;
+			[key: string]: unknown;
+		};
+	}
+}
+
+declare module 'astro:content' {
+	type Flatten<T> = T extends { [K: string]: infer U } ? U : never;
+
+	export type CollectionKey = keyof AnyEntryMap;
+	export type CollectionEntry<C extends CollectionKey> = Flatten<AnyEntryMap[C]>;
+
+	export type ContentCollectionKey = keyof ContentEntryMap;
+	export type DataCollectionKey = keyof DataEntryMap;
+
+	type AllValuesOf<T> = T extends any ? T[keyof T] : never;
+	type ValidContentEntrySlug<C extends keyof ContentEntryMap> = AllValuesOf<
+		ContentEntryMap[C]
+	>['slug'];
+
+	export type ReferenceDataEntry<
+		C extends CollectionKey,
+		E extends keyof DataEntryMap[C] = string,
+	> = {
+		collection: C;
+		id: E;
+	};
+	export type ReferenceContentEntry<
+		C extends keyof ContentEntryMap,
+		E extends ValidContentEntrySlug<C> | (string & {}) = string,
+	> = {
+		collection: C;
+		slug: E;
+	};
+	export type ReferenceLiveEntry<C extends keyof LiveContentConfig['collections']> = {
+		collection: C;
+		id: string;
+	};
+
+	/** @deprecated Use `getEntry` instead. */
+	export function getEntryBySlug<
+		C extends keyof ContentEntryMap,
+		E extends ValidContentEntrySlug<C> | (string & {}),
+	>(
+		collection: C,
+		// Note that this has to accept a regular string too, for SSR
+		entrySlug: E,
+	): E extends ValidContentEntrySlug<C>
+		? Promise<CollectionEntry<C>>
+		: Promise<CollectionEntry<C> | undefined>;
+
+	/** @deprecated Use `getEntry` instead. */
+	export function getDataEntryById<C extends keyof DataEntryMap, E extends keyof DataEntryMap[C]>(
+		collection: C,
+		entryId: E,
+	): Promise<CollectionEntry<C>>;
+
+	export function getCollection<C extends keyof AnyEntryMap, E extends CollectionEntry<C>>(
+		collection: C,
+		filter?: (entry: CollectionEntry<C>) => entry is E,
+	): Promise<E[]>;
+	export function getCollection<C extends keyof AnyEntryMap>(
+		collection: C,
+		filter?: (entry: CollectionEntry<C>) => unknown,
+	): Promise<CollectionEntry<C>[]>;
+
+	export function getLiveCollection<C extends keyof LiveContentConfig['collections']>(
+		collection: C,
+		filter?: LiveLoaderCollectionFilterType<C>,
+	): Promise<
+		import('astro').LiveDataCollectionResult<LiveLoaderDataType<C>, LiveLoaderErrorType<C>>
+	>;
+
+	export function getEntry<
+		C extends keyof ContentEntryMap,
+		E extends ValidContentEntrySlug<C> | (string & {}),
+	>(
+		entry: ReferenceContentEntry<C, E>,
+	): E extends ValidContentEntrySlug<C>
+		? Promise<CollectionEntry<C>>
+		: Promise<CollectionEntry<C> | undefined>;
+	export function getEntry<
+		C extends keyof DataEntryMap,
+		E extends keyof DataEntryMap[C] | (string & {}),
+	>(
+		entry: ReferenceDataEntry<C, E>,
+	): E extends keyof DataEntryMap[C]
+		? Promise<DataEntryMap[C][E]>
+		: Promise<CollectionEntry<C> | undefined>;
+	export function getEntry<
+		C extends keyof ContentEntryMap,
+		E extends ValidContentEntrySlug<C> | (string & {}),
+	>(
+		collection: C,
+		slug: E,
+	): E extends ValidContentEntrySlug<C>
+		? Promise<CollectionEntry<C>>
+		: Promise<CollectionEntry<C> | undefined>;
+	export function getEntry<
+		C extends keyof DataEntryMap,
+		E extends keyof DataEntryMap[C] | (string & {}),
+	>(
+		collection: C,
+		id: E,
+	): E extends keyof DataEntryMap[C]
+		? string extends keyof DataEntryMap[C]
+			? Promise<DataEntryMap[C][E]> | undefined
+			: Promise<DataEntryMap[C][E]>
+		: Promise<CollectionEntry<C> | undefined>;
+	export function getLiveEntry<C extends keyof LiveContentConfig['collections']>(
+		collection: C,
+		filter: string | LiveLoaderEntryFilterType<C>,
+	): Promise<import('astro').LiveDataEntryResult<LiveLoaderDataType<C>, LiveLoaderErrorType<C>>>;
+
+	/** Resolve an array of entry references from the same collection */
+	export function getEntries<C extends keyof ContentEntryMap>(
+		entries: ReferenceContentEntry<C, ValidContentEntrySlug<C>>[],
+	): Promise<CollectionEntry<C>[]>;
+	export function getEntries<C extends keyof DataEntryMap>(
+		entries: ReferenceDataEntry<C, keyof DataEntryMap[C]>[],
+	): Promise<CollectionEntry<C>[]>;
+
+	export function render<C extends keyof AnyEntryMap>(
+		entry: AnyEntryMap[C][string],
+	): Promise<RenderResult>;
+
+	export function reference<C extends keyof AnyEntryMap>(
+		collection: C,
+	): import('astro/zod').ZodEffects<
+		import('astro/zod').ZodString,
+		C extends keyof ContentEntryMap
+			? ReferenceContentEntry<C, ValidContentEntrySlug<C>>
+			: ReferenceDataEntry<C, keyof DataEntryMap[C]>
+	>;
+	// Allow generic `string` to avoid excessive type errors in the config
+	// if `dev` is not running to update as you edit.
+	// Invalid collection names will be caught at build time.
+	export function reference<C extends string>(
+		collection: C,
+	): import('astro/zod').ZodEffects<import('astro/zod').ZodString, never>;
+
+	type ReturnTypeOrOriginal<T> = T extends (...args: any[]) => infer R ? R : T;
+	type InferEntrySchema<C extends keyof AnyEntryMap> = import('astro/zod').infer<
+		ReturnTypeOrOriginal<Required<ContentConfig['collections'][C]>['schema']>
+	>;
+
+	type ContentEntryMap = {
+		
+	};
+
+	type DataEntryMap = {
+		
+	};
+
+	type AnyEntryMap = ContentEntryMap & DataEntryMap;
+
+	type ExtractLoaderTypes<T> = T extends import('astro/loaders').LiveLoader<
+		infer TData,
+		infer TEntryFilter,
+		infer TCollectionFilter,
+		infer TError
+	>
+		? { data: TData; entryFilter: TEntryFilter; collectionFilter: TCollectionFilter; error: TError }
+		: { data: never; entryFilter: never; collectionFilter: never; error: never };
+	type ExtractDataType<T> = ExtractLoaderTypes<T>['data'];
+	type ExtractEntryFilterType<T> = ExtractLoaderTypes<T>['entryFilter'];
+	type ExtractCollectionFilterType<T> = ExtractLoaderTypes<T>['collectionFilter'];
+	type ExtractErrorType<T> = ExtractLoaderTypes<T>['error'];
+
+	type LiveLoaderDataType<C extends keyof LiveContentConfig['collections']> =
+		LiveContentConfig['collections'][C]['schema'] extends undefined
+			? ExtractDataType<LiveContentConfig['collections'][C]['loader']>
+			: import('astro/zod').infer<
+					Exclude<LiveContentConfig['collections'][C]['schema'], undefined>
+				>;
+	type LiveLoaderEntryFilterType<C extends keyof LiveContentConfig['collections']> =
+		ExtractEntryFilterType<LiveContentConfig['collections'][C]['loader']>;
+	type LiveLoaderCollectionFilterType<C extends keyof LiveContentConfig['collections']> =
+		ExtractCollectionFilterType<LiveContentConfig['collections'][C]['loader']>;
+	type LiveLoaderErrorType<C extends keyof LiveContentConfig['collections']> = ExtractErrorType<
+		LiveContentConfig['collections'][C]['loader']
+	>;
+
+	export type ContentConfig = typeof import("../src/content.config.mjs");
+	export type LiveContentConfig = never;
+}

package/.astro/data-store.json

@@ -0,0 +1 @@
+[["Map",1,2],"meta::meta",["Map",3,4,5,6],"astro-version","5.16.15","astro-config-digest","{\"root\":{},\"srcDir\":{},\"publicDir\":{},\"outDir\":{},\"cacheDir\":{},\"compressHTML\":true,\"base\":\"/\",\"trailingSlash\":\"ignore\",\"output\":\"static\",\"scopedStyleStrategy\":\"attribute\",\"build\":{\"format\":\"directory\",\"client\":{},\"server\":{},\"assets\":\"_astro\",\"serverEntry\":\"entry.mjs\",\"redirects\":true,\"inlineStylesheets\":\"auto\",\"concurrency\":1},\"server\":{\"open\":false,\"host\":true,\"port\":8086,\"streaming\":true,\"allowedHosts\":[]},\"redirects\":{},\"image\":{\"endpoint\":{\"route\":\"/_image\"},\"service\":{\"entrypoint\":\"astro/assets/services/sharp\",\"config\":{}},\"domains\":[],\"remotePatterns\":[],\"responsiveStyles\":false},\"devToolbar\":{\"enabled\":true},\"markdown\":{\"syntaxHighlight\":{\"type\":\"shiki\",\"excludeLangs\":[\"math\"]},\"shikiConfig\":{\"langs\":[],\"langAlias\":{},\"theme\":\"github-dark\",\"themes\":{},\"wrap\":false,\"transformers\":[]},\"remarkPlugins\":[],\"rehypePlugins\":[],\"remarkRehype\":{},\"gfm\":true,\"smartypants\":true},\"security\":{\"checkOrigin\":true,\"allowedDomains\":[]},\"env\":{\"schema\":{},\"validateSecrets\":false},\"experimental\":{\"clientPrerender\":false,\"contentIntellisense\":false,\"headingIdCompat\":false,\"preserveScriptOrder\":false,\"liveContentCollections\":false,\"csp\":false,\"staticImportMetaEnv\":false,\"chromeDevtoolsWorkspace\":false,\"failOnPrerenderConflict\":false,\"svgo\":false},\"legacy\":{\"collections\":false}}"]

package/.astro/settings.json

@@ -0,0 +1,8 @@
+{
+	"_variables": {
+		"lastUpdateCheck": 1773132643874
+	},
+	"devToolbar": {
+		"enabled": false
+	}
+}

package/.astro/types.d.ts

@@ -0,0 +1 @@
+/// <reference types="astro/client" />

package/.devcontainer/devcontainer.json

@@ -0,0 +1,23 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/debian
+{
+	"name": "Debian",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/base:bullseye",
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	"features": {
+		"ghcr.io/devcontainers/features/node:1": {
+			"version": "latest",
+			"nvmVersion": "latest"
+		},
+		"ghcr.io/devcontainers-community/npm-features/typescript:1": {
+			"version": "latest"
+		}
+	}
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+	// Configure tool-specific properties.
+	// "customizations": {},
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

package/.env.firebase.example

@@ -0,0 +1,8 @@
+# Frontend Firebase config (from Firebase Project Settings -> Your apps -> Web app)
+VITE_FIREBASE_API_KEY=
+VITE_FIREBASE_AUTH_DOMAIN=
+VITE_FIREBASE_PROJECT_ID=
+VITE_FIREBASE_STORAGE_BUCKET=
+VITE_FIREBASE_MESSAGING_SENDER_ID=
+VITE_FIREBASE_APP_ID=
+VITE_FIREBASE_MEASUREMENT_ID=

package/.firebaserc

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "akinevz-store"
+  }
+}

package/.gitattributes

@@ -0,0 +1,2 @@
+* text=auto
+*.zip filter=lfs diff=lfs merge=lfs -text

package/.github/copilot-instructions.md

@@ -0,0 +1,131 @@
+# GitHub Copilot Instructions
+
+## Project Overview
+Personal website built with **Astro 5 + React 19**, using a JSON-to-HTML transformation architecture with Windows XP aesthetic (xp.css). The site features a fixed Windows XP-style menu bar at the top of every page and renders nested, interactive "window" components styled as Windows 98/XP UI elements.
+
+## Core Architecture Pattern: JSON → Components → Astro
+
+### Content Declaration (JSON-first)
+- **Home page**: `src/sections.json` - nested sections with heading/content structure
+- **Addons page**: `src/addons.json` - addon listings with status, links, and descriptions
+- JSON structure supports recursive nesting: strings, arrays, or nested objects with `heading`/`content`
+
+### Component Hierarchy
+```
+Astro Pages (.astro)
+  ├─ Load JSON (sections.json / addons.json)
+  ├─ Pass to React components with client:load
+  └─ React Components (.tsx)
+      ├─ Section.tsx - renders nested sections as XP windows
+      ├─ Addon.tsx - renders addons with copy-to-clipboard
+      ├─ Page.tsx - orchestrates Section/Addon arrays
+      └─ SectionProvider - manages localStorage state
+```
+
+**Critical**: `.astro` files are server-rendered; use `client:load` for React interactivity.
+
+## Component-Specific Patterns
+
+### MenuBar Component (`src/components/MenuBar.astro`)
+- **Fixed position**: Always visible at top of every page (Windows XP menu bar style)
+- **Auto-discovery**: Automatically finds all `.astro` pages in `src/pages/` via `Astro.glob()`
+- **Custom links**: Use `additionalLinks` prop to add non-page links (PDFs, external URLs)
+- **Manual override**: Pass `links` prop to manually specify all menu items
+- **Label mapping**: Default labels defined in `src/utils/menuItems.ts` (home → '/', addons → '/addons/', etc.)
+- **Keyboard shortcuts**: Each menu item's first letter is underlined and acts as keyboard shortcut
+- **Styling**: Uses gradient background (`#f0f0f0` to `#e0e0e0`) with subtle shadow
+- **Pattern**: Must be placed first in `<body>` tag before other content
+- **Accessibility**: Uses proper ARIA roles (`menubar`, `menuitem`)
+- **Mobile**: Horizontal scrolling on small screens with touch-friendly targets
+
+### Section Component (`src/components/Section.tsx`)
+- **Recursive rendering**: `content` can contain more `SectionProps` objects
+- **Collapse/expand state**: First render shows "OK" button; tracks expansion in localStorage via `SectionContext`
+- **Window controls**: Minimize (no-op), Maximize (modal overlay if `depth > 0`), Close (plays sound)
+- **Sound effect**: `playSound()` loads `/crunchy_kick.ogg` on close
+
+### Addon Component (`src/components/Addon.tsx`)
+- Extends `SectionProps` with `status`, `text`, `link` fields
+- `CopyToClipboardButton` uses `navigator.clipboard` + `react-toastify`
+- Supports same window-style UI as Section
+
+### Page Component (`src/components/Page.tsx`)
+- `PageContent`: Wraps sections in `SectionProvider` for context
+- `PageWithAddons`: Similar but for addons, no provider needed
+
+## Development Workflow
+
+### Local Development
+```bash
+npm run dev          # Starts on port 8086 (see astro.config.mjs)
+npm run build        # Production build
+npm run preview      # Preview production build
+npm run lint         # Run ESLint
+```
+
+**Dev container note**: Uses polling for file watching (see `vite.server.watch.usePolling` in astro.config.mjs) - necessary for containerized environments.
+
+### Port Configuration
+- Default: `8086` (configured in astro.config.mjs)
+- Host: `true` (accessible from outside container)
+
+## Styling Guidelines
+
+### XP.css Integration
+- External CDN: `https://unpkg.com/xp.css@0.2.3/dist/98.css`
+- **Loading pattern**: All pages wait for xp.css to load before showing content (see `DOMContentLoaded` script in pages)
+- Load state class: `styles-loaded` added to `<body>` when ready
+
+### Custom Overrides (`src/styles/main.css`)
+- Menu bar styles: Fixed position at top, XP-style gradient background
+- Remove window borders on top-level `.page > .window` (avoid double borders)
+- Title bar text forced to `#eee` for readability
+- Body padding-top: `24px` (accounts for fixed menu bar height)
+- CSS variables: `--background-color`, `--border-size`, `--gap-size`
+- **Mobile responsive**: Menu bar scrolls horizontally on screens ≤768px with larger touch targets
+
+**Pattern**: Never override xp.css directly; use higher-specificity selectors or `!important` sparingly.
+
+## State Management
+
+### SectionContext (`src/components/SectionContext.tsx`)
+- Tracks expanded sections via `Set<string>`
+- Persists "what is kine" expansion to localStorage key `expandedWhatIsKine`
+- **Usage**: Wrap components in `<SectionProvider>`, access via `useSectionContext()`
+
+## File Conventions
+
+### Static Assets
+- Addons text files: `public/addons/*.txt` (referenced as `/addons/filename.txt`)
+- Audio: `public/*.ogg` files for UI sounds
+- Images: `public/*.png` for metadata (og:image)
+
+### TypeScript
+- Strict mode enabled (`astro/tsconfigs/strict`)
+- JSX: `react-jsx` with `jsxImportSource: "react"`
+- Type exports: Use `type` keyword (`export type SectionProps`)
+
+## Key Dependencies
+
+- **Astro**: 5.x - use Astro pages for routes, React for interactivity
+- **React**: 19.x - use `client:load` directive in Astro files
+- **xp.css**: 0.2.6 (npm) + 0.2.3 (CDN) - Windows XP styling
+- **react-toastify**: Clipboard notifications
+
+## Common Tasks
+
+### Adding a new page
+1. Create `.astro` file in `src/pages/` (auto-routes)
+2. Import content, styles
+3. Include xp.css load script
+4. Add `<MenuBar />` first in `<body>` (auto-discovers pages)
+5. Use `client:load` for React components
+6. **Optional**: Update `src/utils/menuItems.ts` to customize label and order
+
+### Adding content
+- **Home page**: Edit `src/sections.json`
+- **Addons page**: Edit `src/addons.json`, add text file to `public/addons/`
+
+### Modifying window behavior
+- Sound effects: Update `playSound()` in Section.tsx/Addon.tsx
+- Window controls logic: See `handleMaximize`, `handleClose`, `handleExpand`

package/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "npm" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

package/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: Website CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  verify:
+    name: Lint, Test, Build, Audit
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build site
+        run: npm run build
+
+      - name: Audit dependencies
+        run: npm run check:audit

package/.github/workflows/deploy-admin.yml

@@ -0,0 +1,48 @@
+name: Deploy Admin to Cloud Run
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - admin/**
+      - .github/workflows/deploy-admin.yml
+  workflow_dispatch:
+
+env:
+  REGION: europe-west1
+  SERVICE: admin
+  IMAGE: europe-west1-docker.pkg.dev/${{ secrets.GCP_PROJECT_ID }}/admin/app
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Authenticate to Google Cloud
+        uses: google-github-actions/auth@v3
+        with:
+          credentials_json: ${{ secrets.GCP_SA_KEY }}
+
+      - name: Setup gcloud
+        uses: google-github-actions/setup-gcloud@v3
+
+      - name: Configure Docker auth
+        run: gcloud auth configure-docker ${{ env.REGION }}-docker.pkg.dev --quiet
+
+      - name: Build and push image
+        run: |
+          docker build -t ${{ env.IMAGE }}:${{ github.sha }} ./admin
+          docker push ${{ env.IMAGE }}:${{ github.sha }}
+
+      - name: Deploy to Cloud Run
+        run: |
+          gcloud run deploy ${{ env.SERVICE }} \
+            --image ${{ env.IMAGE }}:${{ github.sha }} \
+            --region ${{ env.REGION }} \
+            --platform managed \
+            --allow-unauthenticated \
+            --port 8080

package/.github/workflows/static.yml

@@ -0,0 +1,43 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  # push:
+  #   branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Upload entire repository
+          path: '.'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.gitmodules

@@ -0,0 +1,5 @@
+[submodule "resume-pandoc"]
+	path = resume-pandoc
+	url = https://github.com/john-bokma/resume-pandoc.git
+[submodule "public/xp.css"]
+	path = public/xp.css

package/FIREBASE_SETUP.md

@@ -0,0 +1,69 @@
+# Firebase Resume Interest Setup (Spark Tier)
+
+This setup records resume interest email + timestamp + user agent directly into Firestore and keeps Firebase Analytics events on the frontend.
+
+## 1) One-time prerequisites
+
+From website root:
+
+```bash
+npx firebase login
+```
+
+## 2) Create/select Firebase project
+
+1. Go to Firebase Console.
+2. Create a project (or select existing).
+3. Enable Firestore Database (Native mode).
+4. Enable Google Analytics for the project (recommended for event visibility).
+
+## 3) Register web app and copy env values
+
+1. In Firebase Console -> Project Settings -> General -> Your apps -> Add Web app.
+2. Copy config values into local env file:
+   cp .env.firebase.example .env.local
+3. Fill all `VITE_FIREBASE_*` values.
+
+## 4) Deploy Firestore security rules
+
+From website root:
+
+```bash
+npx firebase use <your-project-id>
+npx firebase deploy --only firestore:rules
+```
+
+## 5) Run and verify locally
+
+From website root:
+
+```bash
+npm run dev
+```
+
+Open `/resume`, use **Share Interest Email**, and submit a test email.
+
+## 6) Verify data landing
+
+1. Firestore collection: `resume_interest`
+2. Fields written:
+   - `email`
+   - `source`
+   - `userAgent`
+   - `createdAt`
+
+## 7) Analytics events from frontend
+
+The client logs these GA/Firebase Analytics events when configured:
+
+- `resume_page_view`
+- `resume_open_click`
+- `resume_interest_submit`
+- `resume_interest_submit_failed`
+
+## Notes
+
+- No route gate is required.
+- Spark-compatible mode does not collect server-side IP.
+- Writes are validated by strict Firestore rules in `firestore.rules`.
+- Add a brief privacy notice on the resume page if collecting personal data.