diff --git a/.agents/skills/agent-memory-mcp/SKILL.md b/.agents/skills/agent-memory-mcp/SKILL.md
new file mode 100644
index 0000000..45d9651
--- /dev/null
+++ b/.agents/skills/agent-memory-mcp/SKILL.md
@@ -0,0 +1,82 @@
+---
+name: agent-memory-mcp
+author: Amit Rathiesh
+description: A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions).
+---
+
+# Agent Memory Skill
+
+This skill provides a persistent, searchable memory bank that automatically syncs with project documentation. It runs as an MCP server to allow reading/writing/searching of long-term memories.
+
+## Prerequisites
+
+- Node.js (v18+)
+
+## Setup
+
+1. **Clone the Repository**:
+   Clone the `agentMemory` project into your agent's workspace or a parallel directory:
+
+   ```bash
+   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
+   ```
+
+2. **Install Dependencies**:
+
+   ```bash
+   cd .agent/skills/agent-memory
+   npm install
+   npm run compile
+   ```
+
+3. **Start the MCP Server**:
+   Use the helper script to activate the memory bank for your current project:
+
+   ```bash
+   npm run start-server <project_id> <absolute_path_to_target_workspace>
+   ```
+
+   _Example for current directory:_
+
+   ```bash
+   npm run start-server my-project $(pwd)
+   ```
+
+## Capabilities (MCP Tools)
+
+### `memory_search`
+
+Search for memories by query, type, or tags.
+
+- **Args**: `query` (string), `type?` (string), `tags?` (string[])
+- **Usage**: "Find all authentication patterns" -> `memory_search({ query: "authentication", type: "pattern" })`
+
+### `memory_write`
+
+Record new knowledge or decisions.
+
+- **Args**: `key` (string), `type` (string), `content` (string), `tags?` (string[])
+- **Usage**: "Save this architecture decision" -> `memory_write({ key: "auth-v1", type: "decision", content: "..." })`
+
+### `memory_read`
+
+Retrieve specific memory content by key.
+
+- **Args**: `key` (string)
+- **Usage**: "Get the auth design" -> `memory_read({ key: "auth-v1" })`
+
+### `memory_stats`
+
+View analytics on memory usage.
+
+- **Usage**: "Show memory statistics" -> `memory_stats({})`
+
+## Dashboard
+
+This skill includes a standalone dashboard to visualize memory usage.
+
+```bash
+npm run start-dashboard <absolute_path_to_target_workspace>
+```
+
+Access at: `http://localhost:3333`
diff --git a/.agents/skills/agent-memory-systems/SKILL.md b/.agents/skills/agent-memory-systems/SKILL.md
new file mode 100644
index 0000000..ee79118
--- /dev/null
+++ b/.agents/skills/agent-memory-systems/SKILL.md
@@ -0,0 +1,67 @@
+---
+name: agent-memory-systems
+description: "Memory is the cornerstone of intelligent agents. Without it, every interaction starts from zero. This skill covers the architecture of agent memory: short-term (context window), long-term (vector stores), and the cognitive architectures that organize them.  Key insight: Memory isn't just storage - it's retrieval. A million stored facts mean nothing if you can't find the right one. Chunking, embedding, and retrieval strategies determine whether your agent remembers or forgets.  The field is fragm"
+source: vibeship-spawner-skills (Apache 2.0)
+---
+
+# Agent Memory Systems
+
+You are a cognitive architect who understands that memory makes agents intelligent.
+You've built memory systems for agents handling millions of interactions. You know
+that the hard part isn't storing - it's retrieving the right memory at the right time.
+
+Your core insight: Memory failures look like intelligence failures. When an agent
+"forgets" or gives inconsistent answers, it's almost always a retrieval problem,
+not a storage problem. You obsess over chunking strategies, embedding quality,
+and
+
+## Capabilities
+
+- agent-memory
+- long-term-memory
+- short-term-memory
+- working-memory
+- episodic-memory
+- semantic-memory
+- procedural-memory
+- memory-retrieval
+- memory-formation
+- memory-decay
+
+## Patterns
+
+### Memory Type Architecture
+
+Choosing the right memory type for different information
+
+### Vector Store Selection Pattern
+
+Choosing the right vector database for your use case
+
+### Chunking Strategy Pattern
+
+Breaking documents into retrievable chunks
+
+## Anti-Patterns
+
+### ❌ Store Everything Forever
+
+### ❌ Chunk Without Testing Retrieval
+
+### ❌ Single Memory Type for All Data
+
+## ⚠️ Sharp Edges
+
+| Issue | Severity | Solution |
+|-------|----------|----------|
+| Issue | critical | ## Contextual Chunking (Anthropic's approach) |
+| Issue | high | ## Test different sizes |
+| Issue | high | ## Always filter by metadata first |
+| Issue | high | ## Add temporal scoring |
+| Issue | medium | ## Detect conflicts on storage |
+| Issue | medium | ## Budget tokens for different memory types |
+| Issue | medium | ## Track embedding model in metadata |
+
+## Related Skills
+
+Works well with: `autonomous-agents`, `multi-agent-orchestration`, `llm-architect`, `agent-tool-builder`
diff --git a/.agents/skills/caveman/SKILL.md b/.agents/skills/caveman/SKILL.md
new file mode 100644
index 0000000..85770a3
--- /dev/null
+++ b/.agents/skills/caveman/SKILL.md
@@ -0,0 +1,49 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode. Cuts token usage ~75% by dropping
+  filler, articles, and pleasantries while keeping full technical accuracy.
+  Use when user says "caveman mode", "talk like caveman", "use caveman",
+  "less tokens", "be brief", or invokes /caveman.
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode".
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough.
+
+Technical terms stay exact. Code blocks unchanged. Errors quoted exact.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+### Examples
+
+**"Why React component re-render?"**
+
+> Inline obj prop -> new ref -> re-render. `useMemo`.
+
+**"Explain database connection pooling."**
+
+> Pool = reuse DB conn. Skip handshake -> fast under load.
+
+## Auto-Clarity Exception
+
+Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
+
+Example -- destructive op:
+
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+>
+> ```sql
+> DROP TABLE users;
+> ```
+>
+> Caveman resume. Verify backup exist first.
diff --git a/.agents/skills/changelog-automation/SKILL.md b/.agents/skills/changelog-automation/SKILL.md
new file mode 100644
index 0000000..0c05a4e
--- /dev/null
+++ b/.agents/skills/changelog-automation/SKILL.md
@@ -0,0 +1,580 @@
+---
+name: changelog-automation
+description: Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.
+---
+
+# Changelog Automation
+
+Patterns and tools for automating changelog generation, release notes, and version management following industry standards.
+
+## When to Use This Skill
+
+- Setting up automated changelog generation
+- Implementing Conventional Commits
+- Creating release note workflows
+- Standardizing commit message formats
+- Generating GitHub/GitLab release notes
+- Managing semantic versioning
+
+## Core Concepts
+
+### 1. Keep a Changelog Format
+
+```markdown
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- New feature X
+
+## [1.2.0] - 2024-01-15
+
+### Added
+
+- User profile avatars
+- Dark mode support
+
+### Changed
+
+- Improved loading performance by 40%
+
+### Deprecated
+
+- Old authentication API (use v2)
+
+### Removed
+
+- Legacy payment gateway
+
+### Fixed
+
+- Login timeout issue (#123)
+
+### Security
+
+- Updated dependencies for CVE-2024-1234
+
+[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
+```
+
+### 2. Conventional Commits
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+| Type       | Description      | Changelog Section  |
+| ---------- | ---------------- | ------------------ |
+| `feat`     | New feature      | Added              |
+| `fix`      | Bug fix          | Fixed              |
+| `docs`     | Documentation    | (usually excluded) |
+| `style`    | Formatting       | (usually excluded) |
+| `refactor` | Code restructure | Changed            |
+| `perf`     | Performance      | Changed            |
+| `test`     | Tests            | (usually excluded) |
+| `chore`    | Maintenance      | (usually excluded) |
+| `ci`       | CI changes       | (usually excluded) |
+| `build`    | Build system     | (usually excluded) |
+| `revert`   | Revert commit    | Removed            |
+
+### 3. Semantic Versioning
+
+```
+MAJOR.MINOR.PATCH
+
+MAJOR: Breaking changes (feat! or BREAKING CHANGE)
+MINOR: New features (feat)
+PATCH: Bug fixes (fix)
+```
+
+## Implementation
+
+### Method 1: Conventional Changelog (Node.js)
+
+```bash
+# Install tools
+npm install -D @commitlint/cli @commitlint/config-conventional
+npm install -D husky
+npm install -D standard-version
+# or
+npm install -D semantic-release
+
+# Setup commitlint
+cat > commitlint.config.js << 'EOF'
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',
+        'fix',
+        'docs',
+        'style',
+        'refactor',
+        'perf',
+        'test',
+        'chore',
+        'ci',
+        'build',
+        'revert',
+      ],
+    ],
+    'subject-case': [2, 'never', ['start-case', 'pascal-case', 'upper-case']],
+    'subject-max-length': [2, 'always', 72],
+  },
+};
+EOF
+
+# Setup husky
+npx husky init
+echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg
+```
+
+### Method 2: standard-version Configuration
+
+```javascript
+// .versionrc.js
+module.exports = {
+  types: [
+    { type: "feat", section: "Features" },
+    { type: "fix", section: "Bug Fixes" },
+    { type: "perf", section: "Performance Improvements" },
+    { type: "revert", section: "Reverts" },
+    { type: "docs", section: "Documentation", hidden: true },
+    { type: "style", section: "Styles", hidden: true },
+    { type: "chore", section: "Miscellaneous", hidden: true },
+    { type: "refactor", section: "Code Refactoring", hidden: true },
+    { type: "test", section: "Tests", hidden: true },
+    { type: "build", section: "Build System", hidden: true },
+    { type: "ci", section: "CI/CD", hidden: true },
+  ],
+  commitUrlFormat: "{{host}}/{{owner}}/{{repository}}/commit/{{hash}}",
+  compareUrlFormat:
+    "{{host}}/{{owner}}/{{repository}}/compare/{{previousTag}}...{{currentTag}}",
+  issueUrlFormat: "{{host}}/{{owner}}/{{repository}}/issues/{{id}}",
+  userUrlFormat: "{{host}}/{{user}}",
+  releaseCommitMessageFormat: "chore(release): {{currentTag}}",
+  scripts: {
+    prebump: 'echo "Running prebump"',
+    postbump: 'echo "Running postbump"',
+    prechangelog: 'echo "Running prechangelog"',
+    postchangelog: 'echo "Running postchangelog"',
+  },
+};
+```
+
+```json
+// package.json scripts
+{
+  "scripts": {
+    "release": "standard-version",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:patch": "standard-version --release-as patch",
+    "release:dry": "standard-version --dry-run"
+  }
+}
+```
+
+### Method 3: semantic-release (Full Automation)
+
+```javascript
+// release.config.js
+module.exports = {
+  branches: [
+    "main",
+    { name: "beta", prerelease: true },
+    { name: "alpha", prerelease: true },
+  ],
+  plugins: [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    [
+      "@semantic-release/changelog",
+      {
+        changelogFile: "CHANGELOG.md",
+      },
+    ],
+    [
+      "@semantic-release/npm",
+      {
+        npmPublish: true,
+      },
+    ],
+    [
+      "@semantic-release/github",
+      {
+        assets: ["dist/**/*.js", "dist/**/*.css"],
+      },
+    ],
+    [
+      "@semantic-release/git",
+      {
+        assets: ["CHANGELOG.md", "package.json"],
+        message:
+          "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}",
+      },
+    ],
+  ],
+};
+```
+
+### Method 4: GitHub Actions Workflow
+
+```yaml
+# .github/workflows/release.yml
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      release_type:
+        description: "Release type"
+        required: true
+        default: "patch"
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - run: npm ci
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Run semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release
+
+  # Alternative: manual release with standard-version
+  manual-release:
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - run: npm ci
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version and generate changelog
+        run: npx standard-version --release-as ${{ inputs.release_type }}
+
+      - name: Push changes
+        run: git push --follow-tags origin main
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          body_path: RELEASE_NOTES.md
+          generate_release_notes: true
+```
+
+### Method 5: git-cliff (Rust-based, Fast)
+
+```toml
+# cliff.toml
+[changelog]
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+"""
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [Unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {% for commit in commits %}
+        - {% if commit.scope %}**{{ commit.scope }}:** {% endif %}\
+            {{ commit.message | upper_first }}\
+            {% if commit.github.pr_number %} ([#{{ commit.github.pr_number }}](https://github.com/owner/repo/pull/{{ commit.github.pr_number }})){% endif %}\
+    {% endfor %}
+{% endfor %}
+"""
+footer = """
+{% for release in releases -%}
+    {% if release.version -%}
+        {% if release.previous.version -%}
+            [{{ release.version | trim_start_matches(pat="v") }}]: \
+                https://github.com/owner/repo/compare/{{ release.previous.version }}...{{ release.version }}
+        {% endif -%}
+    {% else -%}
+        [unreleased]: https://github.com/owner/repo/compare/{{ release.previous.version }}...HEAD
+    {% endif -%}
+{% endfor %}
+"""
+trim = true
+
+[git]
+conventional_commits = true
+filter_unconventional = true
+split_commits = false
+commit_parsers = [
+    { message = "^feat", group = "Features" },
+    { message = "^fix", group = "Bug Fixes" },
+    { message = "^doc", group = "Documentation" },
+    { message = "^perf", group = "Performance" },
+    { message = "^refactor", group = "Refactoring" },
+    { message = "^style", group = "Styling" },
+    { message = "^test", group = "Testing" },
+    { message = "^chore\\(release\\)", skip = true },
+    { message = "^chore", group = "Miscellaneous" },
+]
+filter_commits = false
+tag_pattern = "v[0-9]*"
+skip_tags = ""
+ignore_tags = ""
+topo_order = false
+sort_commits = "oldest"
+
+[github]
+owner = "owner"
+repo = "repo"
+```
+
+```bash
+# Generate changelog
+git cliff -o CHANGELOG.md
+
+# Generate for specific range
+git cliff v1.0.0..v2.0.0 -o RELEASE_NOTES.md
+
+# Preview without writing
+git cliff --unreleased --dry-run
+```
+
+### Method 6: Python (commitizen)
+
+```toml
+# pyproject.toml
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "1.0.0"
+version_files = [
+    "pyproject.toml:version",
+    "src/__init__.py:__version__",
+]
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_incremental = true
+changelog_start_rev = "v0.1.0"
+
+[tool.commitizen.customize]
+message_template = "{{change_type}}{% if scope %}({{scope}}){% endif %}: {{message}}"
+schema = "<type>(<scope>): <subject>"
+schema_pattern = "^(feat|fix|docs|style|refactor|perf|test|chore)(\\(\\w+\\))?:\\s.*"
+bump_pattern = "^(feat|fix|perf|refactor)"
+bump_map = {"feat" = "MINOR", "fix" = "PATCH", "perf" = "PATCH", "refactor" = "PATCH"}
+```
+
+```bash
+# Install
+pip install commitizen
+
+# Create commit interactively
+cz commit
+
+# Bump version and update changelog
+cz bump --changelog
+
+# Check commits
+cz check --rev-range HEAD~5..HEAD
+```
+
+## Release Notes Templates
+
+### GitHub Release Template
+
+```markdown
+## What's Changed
+
+### 🚀 Features
+
+{{ range .Features }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+### 🐛 Bug Fixes
+
+{{ range .Fixes }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+### 📚 Documentation
+
+{{ range .Docs }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+### 🔧 Maintenance
+
+{{ range .Chores }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+## New Contributors
+
+{{ range .NewContributors }}
+
+- @{{ .Username }} made their first contribution in #{{ .PR }}
+  {{ end }}
+
+**Full Changelog**: https://github.com/owner/repo/compare/v{{ .Previous }}...v{{ .Current }}
+```
+
+### Internal Release Notes
+
+```markdown
+# Release v2.1.0 - January 15, 2024
+
+## Summary
+
+This release introduces dark mode support and improves checkout performance
+by 40%. It also includes important security updates.
+
+## Highlights
+
+### 🌙 Dark Mode
+
+Users can now switch to dark mode from settings. The preference is
+automatically saved and synced across devices.
+
+### ⚡ Performance
+
+- Checkout flow is 40% faster
+- Reduced bundle size by 15%
+
+## Breaking Changes
+
+None in this release.
+
+## Upgrade Guide
+
+No special steps required. Standard deployment process applies.
+
+## Known Issues
+
+- Dark mode may flicker on initial load (fix scheduled for v2.1.1)
+
+## Dependencies Updated
+
+| Package | From    | To      | Reason                   |
+| ------- | ------- | ------- | ------------------------ |
+| react   | 18.2.0  | 18.3.0  | Performance improvements |
+| lodash  | 4.17.20 | 4.17.21 | Security patch           |
+```
+
+## Commit Message Examples
+
+```bash
+# Feature with scope
+feat(auth): add OAuth2 support for Google login
+
+# Bug fix with issue reference
+fix(checkout): resolve race condition in payment processing
+
+Closes #123
+
+# Breaking change
+feat(api)!: change user endpoint response format
+
+BREAKING CHANGE: The user endpoint now returns `userId` instead of `id`.
+Migration guide: Update all API consumers to use the new field name.
+
+# Multiple paragraphs
+fix(database): handle connection timeouts gracefully
+
+Previously, connection timeouts would cause the entire request to fail
+without retry. This change implements exponential backoff with up to
+3 retries before failing.
+
+The timeout threshold has been increased from 5s to 10s based on p99
+latency analysis.
+
+Fixes #456
+Reviewed-by: @alice
+```
+
+## Best Practices
+
+### Do's
+
+- **Follow Conventional Commits** - Enables automation
+- **Write clear messages** - Future you will thank you
+- **Reference issues** - Link commits to tickets
+- **Use scopes consistently** - Define team conventions
+- **Automate releases** - Reduce manual errors
+
+### Don'ts
+
+- **Don't mix changes** - One logical change per commit
+- **Don't skip validation** - Use commitlint
+- **Don't manual edit** - Generated changelogs only
+- **Don't forget breaking changes** - Mark with `!` or footer
+- **Don't ignore CI** - Validate commits in pipeline
+
+## Resources
+
+- [Keep a Changelog](https://keepachangelog.com/)
+- [Conventional Commits](https://www.conventionalcommits.org/)
+- [Semantic Versioning](https://semver.org/)
+- [semantic-release](https://semantic-release.gitbook.io/)
+- [git-cliff](https://git-cliff.org/)
diff --git a/.agents/skills/changelog-generator/SKILL.md b/.agents/skills/changelog-generator/SKILL.md
new file mode 100644
index 0000000..72919de
--- /dev/null
+++ b/.agents/skills/changelog-generator/SKILL.md
@@ -0,0 +1,104 @@
+---
+name: changelog-generator
+description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+---
+
+# Changelog Generator
+
+This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
+
+## When to Use This Skill
+
+- Preparing release notes for a new version
+- Creating weekly or monthly product update summaries
+- Documenting changes for customers
+- Writing changelog entries for app store submissions
+- Generating update notifications
+- Creating internal release documentation
+- Maintaining a public changelog/product updates page
+
+## What This Skill Does
+
+1. **Scans Git History**: Analyzes commits from a specific time period or between versions
+2. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
+3. **Translates Technical → User-Friendly**: Converts developer commits into customer language
+4. **Formats Professionally**: Creates clean, structured changelog entries
+5. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.)
+6. **Follows Best Practices**: Applies changelog guidelines and your brand voice
+
+## How to Use
+
+### Basic Usage
+
+From your project repository:
+
+```
+Create a changelog from commits since last release
+```
+
+```
+Generate changelog for all commits from the past week
+```
+
+```
+Create release notes for version 2.5.0
+```
+
+### With Specific Date Range
+
+```
+Create a changelog for all commits between March 1 and March 15
+```
+
+### With Custom Guidelines
+
+```
+Create a changelog for commits since v2.4.0, using my changelog 
+guidelines from CHANGELOG_STYLE.md
+```
+
+## Example
+
+**User**: "Create a changelog for commits from the past 7 days"
+
+**Output**:
+```markdown
+# Updates - Week of March 10, 2024
+
+## ✨ New Features
+
+- **Team Workspaces**: Create separate workspaces for different 
+  projects. Invite team members and keep everything organized.
+
+- **Keyboard Shortcuts**: Press ? to see all available shortcuts. 
+  Navigate faster without touching your mouse.
+
+## 🔧 Improvements
+
+- **Faster Sync**: Files now sync 2x faster across devices
+- **Better Search**: Search now includes file contents, not just titles
+
+## 🐛 Fixes
+
+- Fixed issue where large images wouldn't upload
+- Resolved timezone confusion in scheduled posts
+- Corrected notification badge count
+```
+
+**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter
+
+## Tips
+
+- Run from your git repository root
+- Specify date ranges for focused changelogs
+- Use your CHANGELOG_STYLE.md for consistent formatting
+- Review and adjust the generated changelog before publishing
+- Save output directly to CHANGELOG.md
+
+## Related Use Cases
+
+- Creating GitHub release notes
+- Writing app store update descriptions
+- Generating email updates for users
+- Creating social media announcement posts
+
diff --git a/.agents/skills/code-review-checklist/SKILL.md b/.agents/skills/code-review-checklist/SKILL.md
new file mode 100644
index 0000000..a00a47b
--- /dev/null
+++ b/.agents/skills/code-review-checklist/SKILL.md
@@ -0,0 +1,444 @@
+---
+name: code-review-checklist
+description: "Comprehensive checklist for conducting thorough code reviews covering functionality, security, performance, and maintainability"
+---
+
+# Code Review Checklist
+
+## Overview
+
+Provide a systematic checklist for conducting thorough code reviews. This skill helps reviewers ensure code quality, catch bugs, identify security issues, and maintain consistency across the codebase.
+
+## When to Use This Skill
+
+- Use when reviewing pull requests
+- Use when conducting code audits
+- Use when establishing code review standards for a team
+- Use when training new developers on code review practices
+- Use when you want to ensure nothing is missed in reviews
+- Use when creating code review documentation
+
+## How It Works
+
+### Step 1: Understand the Context
+
+Before reviewing code, I'll help you understand:
+- What problem does this code solve?
+- What are the requirements?
+- What files were changed and why?
+- Are there related issues or tickets?
+- What's the testing strategy?
+
+### Step 2: Review Functionality
+
+Check if the code works correctly:
+- Does it solve the stated problem?
+- Are edge cases handled?
+- Is error handling appropriate?
+- Are there any logical errors?
+- Does it match the requirements?
+
+### Step 3: Review Code Quality
+
+Assess code maintainability:
+- Is the code readable and clear?
+- Are names descriptive?
+- Is it properly structured?
+- Are functions/methods focused?
+- Is there unnecessary complexity?
+
+### Step 4: Review Security
+
+Check for security issues:
+- Are inputs validated?
+- Is sensitive data protected?
+- Are there SQL injection risks?
+- Is authentication/authorization correct?
+- Are dependencies secure?
+
+### Step 5: Review Performance
+
+Look for performance issues:
+- Are there unnecessary loops?
+- Is database access optimized?
+- Are there memory leaks?
+- Is caching used appropriately?
+- Are there N+1 query problems?
+
+### Step 6: Review Tests
+
+Verify test coverage:
+- Are there tests for new code?
+- Do tests cover edge cases?
+- Are tests meaningful?
+- Do all tests pass?
+- Is test coverage adequate?
+
+## Examples
+
+### Example 1: Functionality Review Checklist
+
+```markdown
+## Functionality Review
+
+### Requirements
+- [ ] Code solves the stated problem
+- [ ] All acceptance criteria are met
+- [ ] Edge cases are handled
+- [ ] Error cases are handled
+- [ ] User input is validated
+
+### Logic
+- [ ] No logical errors or bugs
+- [ ] Conditions are correct (no off-by-one errors)
+- [ ] Loops terminate correctly
+- [ ] Recursion has proper base cases
+- [ ] State management is correct
+
+### Error Handling
+- [ ] Errors are caught appropriately
+- [ ] Error messages are clear and helpful
+- [ ] Errors don't expose sensitive information
+- [ ] Failed operations are rolled back
+- [ ] Logging is appropriate
+
+### Example Issues to Catch:
+
+**❌ Bad - Missing validation:**
+\`\`\`javascript
+function createUser(email, password) {
+  // No validation!
+  return db.users.create({ email, password });
+}
+\`\`\`
+
+**✅ Good - Proper validation:**
+\`\`\`javascript
+function createUser(email, password) {
+  if (!email || !isValidEmail(email)) {
+    throw new Error('Invalid email address');
+  }
+  if (!password || password.length < 8) {
+    throw new Error('Password must be at least 8 characters');
+  }
+  return db.users.create({ email, password });
+}
+\`\`\`
+```
+
+### Example 2: Security Review Checklist
+
+```markdown
+## Security Review
+
+### Input Validation
+- [ ] All user inputs are validated
+- [ ] SQL injection is prevented (use parameterized queries)
+- [ ] XSS is prevented (escape output)
+- [ ] CSRF protection is in place
+- [ ] File uploads are validated (type, size, content)
+
+### Authentication & Authorization
+- [ ] Authentication is required where needed
+- [ ] Authorization checks are present
+- [ ] Passwords are hashed (never stored plain text)
+- [ ] Sessions are managed securely
+- [ ] Tokens expire appropriately
+
+### Data Protection
+- [ ] Sensitive data is encrypted
+- [ ] API keys are not hardcoded
+- [ ] Environment variables are used for secrets
+- [ ] Personal data follows privacy regulations
+- [ ] Database credentials are secure
+
+### Dependencies
+- [ ] No known vulnerable dependencies
+- [ ] Dependencies are up to date
+- [ ] Unnecessary dependencies are removed
+- [ ] Dependency versions are pinned
+
+### Example Issues to Catch:
+
+**❌ Bad - SQL injection risk:**
+\`\`\`javascript
+const query = \`SELECT * FROM users WHERE email = '\${email}'\`;
+db.query(query);
+\`\`\`
+
+**✅ Good - Parameterized query:**
+\`\`\`javascript
+const query = 'SELECT * FROM users WHERE email = $1';
+db.query(query, [email]);
+\`\`\`
+
+**❌ Bad - Hardcoded secret:**
+\`\`\`javascript
+const API_KEY = 'sk_live_abc123xyz';
+\`\`\`
+
+**✅ Good - Environment variable:**
+\`\`\`javascript
+const API_KEY = process.env.API_KEY;
+if (!API_KEY) {
+  throw new Error('API_KEY environment variable is required');
+}
+\`\`\`
+```
+
+### Example 3: Code Quality Review Checklist
+
+```markdown
+## Code Quality Review
+
+### Readability
+- [ ] Code is easy to understand
+- [ ] Variable names are descriptive
+- [ ] Function names explain what they do
+- [ ] Complex logic has comments
+- [ ] Magic numbers are replaced with constants
+
+### Structure
+- [ ] Functions are small and focused
+- [ ] Code follows DRY principle (Don't Repeat Yourself)
+- [ ] Proper separation of concerns
+- [ ] Consistent code style
+- [ ] No dead code or commented-out code
+
+### Maintainability
+- [ ] Code is modular and reusable
+- [ ] Dependencies are minimal
+- [ ] Changes are backwards compatible
+- [ ] Breaking changes are documented
+- [ ] Technical debt is noted
+
+### Example Issues to Catch:
+
+**❌ Bad - Unclear naming:**
+\`\`\`javascript
+function calc(a, b, c) {
+  return a * b + c;
+}
+\`\`\`
+
+**✅ Good - Descriptive naming:**
+\`\`\`javascript
+function calculateTotalPrice(quantity, unitPrice, tax) {
+  return quantity * unitPrice + tax;
+}
+\`\`\`
+
+**❌ Bad - Function doing too much:**
+\`\`\`javascript
+function processOrder(order) {
+  // Validate order
+  if (!order.items) throw new Error('No items');
+  
+  // Calculate total
+  let total = 0;
+  for (let item of order.items) {
+    total += item.price * item.quantity;
+  }
+  
+  // Apply discount
+  if (order.coupon) {
+    total *= 0.9;
+  }
+  
+  // Process payment
+  const payment = stripe.charge(total);
+  
+  // Send email
+  sendEmail(order.email, 'Order confirmed');
+  
+  // Update inventory
+  updateInventory(order.items);
+  
+  return { orderId: order.id, total };
+}
+\`\`\`
+
+**✅ Good - Separated concerns:**
+\`\`\`javascript
+function processOrder(order) {
+  validateOrder(order);
+  const total = calculateOrderTotal(order);
+  const payment = processPayment(total);
+  sendOrderConfirmation(order.email);
+  updateInventory(order.items);
+  
+  return { orderId: order.id, total };
+}
+\`\`\`
+```
+
+## Best Practices
+
+### ✅ Do This
+
+- **Review Small Changes** - Smaller PRs are easier to review thoroughly
+- **Check Tests First** - Verify tests pass and cover new code
+- **Run the Code** - Test it locally when possible
+- **Ask Questions** - Don't assume, ask for clarification
+- **Be Constructive** - Suggest improvements, don't just criticize
+- **Focus on Important Issues** - Don't nitpick minor style issues
+- **Use Automated Tools** - Linters, formatters, security scanners
+- **Review Documentation** - Check if docs are updated
+- **Consider Performance** - Think about scale and efficiency
+- **Check for Regressions** - Ensure existing functionality still works
+
+### ❌ Don't Do This
+
+- **Don't Approve Without Reading** - Actually review the code
+- **Don't Be Vague** - Provide specific feedback with examples
+- **Don't Ignore Security** - Security issues are critical
+- **Don't Skip Tests** - Untested code will cause problems
+- **Don't Be Rude** - Be respectful and professional
+- **Don't Rubber Stamp** - Every review should add value
+- **Don't Review When Tired** - You'll miss important issues
+- **Don't Forget Context** - Understand the bigger picture
+
+## Complete Review Checklist
+
+### Pre-Review
+- [ ] Read the PR description and linked issues
+- [ ] Understand what problem is being solved
+- [ ] Check if tests pass in CI/CD
+- [ ] Pull the branch and run it locally
+
+### Functionality
+- [ ] Code solves the stated problem
+- [ ] Edge cases are handled
+- [ ] Error handling is appropriate
+- [ ] User input is validated
+- [ ] No logical errors
+
+### Security
+- [ ] No SQL injection vulnerabilities
+- [ ] No XSS vulnerabilities
+- [ ] Authentication/authorization is correct
+- [ ] Sensitive data is protected
+- [ ] No hardcoded secrets
+
+### Performance
+- [ ] No unnecessary database queries
+- [ ] No N+1 query problems
+- [ ] Efficient algorithms used
+- [ ] No memory leaks
+- [ ] Caching used appropriately
+
+### Code Quality
+- [ ] Code is readable and clear
+- [ ] Names are descriptive
+- [ ] Functions are focused and small
+- [ ] No code duplication
+- [ ] Follows project conventions
+
+### Tests
+- [ ] New code has tests
+- [ ] Tests cover edge cases
+- [ ] Tests are meaningful
+- [ ] All tests pass
+- [ ] Test coverage is adequate
+
+### Documentation
+- [ ] Code comments explain why, not what
+- [ ] API documentation is updated
+- [ ] README is updated if needed
+- [ ] Breaking changes are documented
+- [ ] Migration guide provided if needed
+
+### Git
+- [ ] Commit messages are clear
+- [ ] No merge conflicts
+- [ ] Branch is up to date with main
+- [ ] No unnecessary files committed
+- [ ] .gitignore is properly configured
+
+## Common Pitfalls
+
+### Problem: Missing Edge Cases
+**Symptoms:** Code works for happy path but fails on edge cases
+**Solution:** Ask "What if...?" questions
+- What if the input is null?
+- What if the array is empty?
+- What if the user is not authenticated?
+- What if the network request fails?
+
+### Problem: Security Vulnerabilities
+**Symptoms:** Code exposes security risks
+**Solution:** Use security checklist
+- Run security scanners (npm audit, Snyk)
+- Check OWASP Top 10
+- Validate all inputs
+- Use parameterized queries
+- Never trust user input
+
+### Problem: Poor Test Coverage
+**Symptoms:** New code has no tests or inadequate tests
+**Solution:** Require tests for all new code
+- Unit tests for functions
+- Integration tests for features
+- Edge case tests
+- Error case tests
+
+### Problem: Unclear Code
+**Symptoms:** Reviewer can't understand what code does
+**Solution:** Request improvements
+- Better variable names
+- Explanatory comments
+- Smaller functions
+- Clear structure
+
+## Review Comment Templates
+
+### Requesting Changes
+```markdown
+**Issue:** [Describe the problem]
+
+**Current code:**
+\`\`\`javascript
+// Show problematic code
+\`\`\`
+
+**Suggested fix:**
+\`\`\`javascript
+// Show improved code
+\`\`\`
+
+**Why:** [Explain why this is better]
+```
+
+### Asking Questions
+```markdown
+**Question:** [Your question]
+
+**Context:** [Why you're asking]
+
+**Suggestion:** [If you have one]
+```
+
+### Praising Good Code
+```markdown
+**Nice!** [What you liked]
+
+This is great because [explain why]
+```
+
+## Related Skills
+
+- `@requesting-code-review` - Prepare code for review
+- `@receiving-code-review` - Handle review feedback
+- `@systematic-debugging` - Debug issues found in review
+- `@test-driven-development` - Ensure code has tests
+
+## Additional Resources
+
+- [Google Code Review Guidelines](https://google.github.io/eng-practices/review/)
+- [OWASP Top 10](https://owasp.org/www-project-top-ten/)
+- [Code Review Best Practices](https://github.com/thoughtbot/guides/tree/main/code-review)
+- [How to Review Code](https://www.kevinlondon.com/2015/05/05/code-review-best-practices.html)
+
+---
+
+**Pro Tip:** Use a checklist template for every review to ensure consistency and thoroughness. Customize it for your team's specific needs!
diff --git a/.agents/skills/code-review/SKILL.md b/.agents/skills/code-review/SKILL.md
new file mode 100644
index 0000000..621007b
--- /dev/null
+++ b/.agents/skills/code-review/SKILL.md
@@ -0,0 +1,102 @@
+---
+name: code-review
+description: Perform code reviews following Sentry engineering practices. Use when reviewing pull requests, examining code changes, or providing feedback on code quality. Covers security, performance, testing, and design review.
+---
+
+# Sentry Code Review
+
+Follow these guidelines when reviewing code for Sentry projects.
+
+## Review Checklist
+
+### Identifying Problems
+
+Look for these issues in code changes:
+
+- **Runtime errors**: Potential exceptions, null pointer issues, out-of-bounds access
+- **Performance**: Unbounded O(n²) operations, N+1 queries, unnecessary allocations
+- **Side effects**: Unintended behavioral changes affecting other components
+- **Backwards compatibility**: Breaking API changes without migration path
+- **ORM queries**: Complex Django ORM with unexpected query performance
+- **Security vulnerabilities**: Injection, XSS, access control gaps, secrets exposure
+
+### Design Assessment
+
+- Do component interactions make logical sense?
+- Does the change align with existing project architecture?
+- Are there conflicts with current requirements or goals?
+
+### Test Coverage
+
+Every PR should have appropriate test coverage:
+
+- Functional tests for business logic
+- Integration tests for component interactions
+- End-to-end tests for critical user paths
+
+Verify tests cover actual requirements and edge cases. Avoid excessive branching or looping in test code.
+
+### Long-Term Impact
+
+Flag for senior engineer review when changes involve:
+
+- Database schema modifications
+- API contract changes
+- New framework or library adoption
+- Performance-critical code paths
+- Security-sensitive functionality
+
+## Feedback Guidelines
+
+### Tone
+
+- Be polite and empathetic
+- Provide actionable suggestions, not vague criticism
+- Phrase as questions when uncertain: "Have you considered...?"
+
+### Approval
+
+- Approve when only minor issues remain
+- Don't block PRs for stylistic preferences
+- Remember: the goal is risk reduction, not perfect code
+
+## Common Patterns to Flag
+
+### Python/Django
+
+```python
+# Bad: N+1 query
+for user in users:
+    print(user.profile.name)  # Separate query per user
+
+# Good: Prefetch related
+users = User.objects.prefetch_related('profile')
+```
+
+### TypeScript/React
+
+```typescript
+// Bad: Missing dependency in useEffect
+useEffect(() => {
+  fetchData(userId);
+}, []);  // userId not in deps
+
+// Good: Include all dependencies
+useEffect(() => {
+  fetchData(userId);
+}, [userId]);
+```
+
+### Security
+
+```python
+# Bad: SQL injection risk
+cursor.execute(f"SELECT * FROM users WHERE id = {user_id}")
+
+# Good: Parameterized query
+cursor.execute("SELECT * FROM users WHERE id = %s", [user_id])
+```
+
+## References
+
+- [Sentry Code Review Guidelines](https://develop.sentry.dev/engineering-practices/code-review/)
diff --git a/.agents/skills/code-reviewer/SKILL.md b/.agents/skills/code-reviewer/SKILL.md
new file mode 100644
index 0000000..ad7b451
--- /dev/null
+++ b/.agents/skills/code-reviewer/SKILL.md
@@ -0,0 +1,209 @@
+---
+name: code-reviewer
+description: Comprehensive code review skill for TypeScript, JavaScript, Python, Swift, Kotlin, Go. Includes automated code analysis, best practice checking, security scanning, and review checklist generation. Use when reviewing pull requests, providing code feedback, identifying issues, or ensuring code quality standards.
+---
+
+# Code Reviewer
+
+Complete toolkit for code reviewer with modern tools and best practices.
+
+## Quick Start
+
+### Main Capabilities
+
+This skill provides three core capabilities through automated scripts:
+
+```bash
+# Script 1: Pr Analyzer
+python scripts/pr_analyzer.py [options]
+
+# Script 2: Code Quality Checker
+python scripts/code_quality_checker.py [options]
+
+# Script 3: Review Report Generator
+python scripts/review_report_generator.py [options]
+```
+
+## Core Capabilities
+
+### 1. Pr Analyzer
+
+Automated tool for pr analyzer tasks.
+
+**Features:**
+- Automated scaffolding
+- Best practices built-in
+- Configurable templates
+- Quality checks
+
+**Usage:**
+```bash
+python scripts/pr_analyzer.py <project-path> [options]
+```
+
+### 2. Code Quality Checker
+
+Comprehensive analysis and optimization tool.
+
+**Features:**
+- Deep analysis
+- Performance metrics
+- Recommendations
+- Automated fixes
+
+**Usage:**
+```bash
+python scripts/code_quality_checker.py <target-path> [--verbose]
+```
+
+### 3. Review Report Generator
+
+Advanced tooling for specialized tasks.
+
+**Features:**
+- Expert-level automation
+- Custom configurations
+- Integration ready
+- Production-grade output
+
+**Usage:**
+```bash
+python scripts/review_report_generator.py [arguments] [options]
+```
+
+## Reference Documentation
+
+### Code Review Checklist
+
+Comprehensive guide available in `references/code_review_checklist.md`:
+
+- Detailed patterns and practices
+- Code examples
+- Best practices
+- Anti-patterns to avoid
+- Real-world scenarios
+
+### Coding Standards
+
+Complete workflow documentation in `references/coding_standards.md`:
+
+- Step-by-step processes
+- Optimization strategies
+- Tool integrations
+- Performance tuning
+- Troubleshooting guide
+
+### Common Antipatterns
+
+Technical reference guide in `references/common_antipatterns.md`:
+
+- Technology stack details
+- Configuration examples
+- Integration patterns
+- Security considerations
+- Scalability guidelines
+
+## Tech Stack
+
+**Languages:** TypeScript, JavaScript, Python, Go, Swift, Kotlin
+**Frontend:** React, Next.js, React Native, Flutter
+**Backend:** Node.js, Express, GraphQL, REST APIs
+**Database:** PostgreSQL, Prisma, NeonDB, Supabase
+**DevOps:** Docker, Kubernetes, Terraform, GitHub Actions, CircleCI
+**Cloud:** AWS, GCP, Azure
+
+## Development Workflow
+
+### 1. Setup and Configuration
+
+```bash
+# Install dependencies
+npm install
+# or
+pip install -r requirements.txt
+
+# Configure environment
+cp .env.example .env
+```
+
+### 2. Run Quality Checks
+
+```bash
+# Use the analyzer script
+python scripts/code_quality_checker.py .
+
+# Review recommendations
+# Apply fixes
+```
+
+### 3. Implement Best Practices
+
+Follow the patterns and practices documented in:
+- `references/code_review_checklist.md`
+- `references/coding_standards.md`
+- `references/common_antipatterns.md`
+
+## Best Practices Summary
+
+### Code Quality
+- Follow established patterns
+- Write comprehensive tests
+- Document decisions
+- Review regularly
+
+### Performance
+- Measure before optimizing
+- Use appropriate caching
+- Optimize critical paths
+- Monitor in production
+
+### Security
+- Validate all inputs
+- Use parameterized queries
+- Implement proper authentication
+- Keep dependencies updated
+
+### Maintainability
+- Write clear code
+- Use consistent naming
+- Add helpful comments
+- Keep it simple
+
+## Common Commands
+
+```bash
+# Development
+npm run dev
+npm run build
+npm run test
+npm run lint
+
+# Analysis
+python scripts/code_quality_checker.py .
+python scripts/review_report_generator.py --analyze
+
+# Deployment
+docker build -t app:latest .
+docker-compose up -d
+kubectl apply -f k8s/
+```
+
+## Troubleshooting
+
+### Common Issues
+
+Check the comprehensive troubleshooting section in `references/common_antipatterns.md`.
+
+### Getting Help
+
+- Review reference documentation
+- Check script output messages
+- Consult tech stack documentation
+- Review error logs
+
+## Resources
+
+- Pattern Reference: `references/code_review_checklist.md`
+- Workflow Guide: `references/coding_standards.md`
+- Technical Guide: `references/common_antipatterns.md`
+- Tool Scripts: `scripts/` directory
diff --git a/.agents/skills/code-reviewer/references/code_review_checklist.md b/.agents/skills/code-reviewer/references/code_review_checklist.md
new file mode 100644
index 0000000..30a0f7a
--- /dev/null
+++ b/.agents/skills/code-reviewer/references/code_review_checklist.md
@@ -0,0 +1,103 @@
+# Code Review Checklist
+
+## Overview
+
+This reference guide provides comprehensive information for code reviewer.
+
+## Patterns and Practices
+
+### Pattern 1: Best Practice Implementation
+
+**Description:**
+Detailed explanation of the pattern.
+
+**When to Use:**
+- Scenario 1
+- Scenario 2
+- Scenario 3
+
+**Implementation:**
+```typescript
+// Example code implementation
+export class Example {
+  // Implementation details
+}
+```
+
+**Benefits:**
+- Benefit 1
+- Benefit 2
+- Benefit 3
+
+**Trade-offs:**
+- Consider 1
+- Consider 2
+- Consider 3
+
+### Pattern 2: Advanced Technique
+
+**Description:**
+Another important pattern for code reviewer.
+
+**Implementation:**
+```typescript
+// Advanced example
+async function advancedExample() {
+  // Code here
+}
+```
+
+## Guidelines
+
+### Code Organization
+- Clear structure
+- Logical separation
+- Consistent naming
+- Proper documentation
+
+### Performance Considerations
+- Optimization strategies
+- Bottleneck identification
+- Monitoring approaches
+- Scaling techniques
+
+### Security Best Practices
+- Input validation
+- Authentication
+- Authorization
+- Data protection
+
+## Common Patterns
+
+### Pattern A
+Implementation details and examples.
+
+### Pattern B
+Implementation details and examples.
+
+### Pattern C
+Implementation details and examples.
+
+## Anti-Patterns to Avoid
+
+### Anti-Pattern 1
+What not to do and why.
+
+### Anti-Pattern 2
+What not to do and why.
+
+## Tools and Resources
+
+### Recommended Tools
+- Tool 1: Purpose
+- Tool 2: Purpose
+- Tool 3: Purpose
+
+### Further Reading
+- Resource 1
+- Resource 2
+- Resource 3
+
+## Conclusion
+
+Key takeaways for using this reference guide effectively.
diff --git a/.agents/skills/code-reviewer/references/coding_standards.md b/.agents/skills/code-reviewer/references/coding_standards.md
new file mode 100644
index 0000000..b36bb6c
--- /dev/null
+++ b/.agents/skills/code-reviewer/references/coding_standards.md
@@ -0,0 +1,103 @@
+# Coding Standards
+
+## Overview
+
+This reference guide provides comprehensive information for code reviewer.
+
+## Patterns and Practices
+
+### Pattern 1: Best Practice Implementation
+
+**Description:**
+Detailed explanation of the pattern.
+
+**When to Use:**
+- Scenario 1
+- Scenario 2
+- Scenario 3
+
+**Implementation:**
+```typescript
+// Example code implementation
+export class Example {
+  // Implementation details
+}
+```
+
+**Benefits:**
+- Benefit 1
+- Benefit 2
+- Benefit 3
+
+**Trade-offs:**
+- Consider 1
+- Consider 2
+- Consider 3
+
+### Pattern 2: Advanced Technique
+
+**Description:**
+Another important pattern for code reviewer.
+
+**Implementation:**
+```typescript
+// Advanced example
+async function advancedExample() {
+  // Code here
+}
+```
+
+## Guidelines
+
+### Code Organization
+- Clear structure
+- Logical separation
+- Consistent naming
+- Proper documentation
+
+### Performance Considerations
+- Optimization strategies
+- Bottleneck identification
+- Monitoring approaches
+- Scaling techniques
+
+### Security Best Practices
+- Input validation
+- Authentication
+- Authorization
+- Data protection
+
+## Common Patterns
+
+### Pattern A
+Implementation details and examples.
+
+### Pattern B
+Implementation details and examples.
+
+### Pattern C
+Implementation details and examples.
+
+## Anti-Patterns to Avoid
+
+### Anti-Pattern 1
+What not to do and why.
+
+### Anti-Pattern 2
+What not to do and why.
+
+## Tools and Resources
+
+### Recommended Tools
+- Tool 1: Purpose
+- Tool 2: Purpose
+- Tool 3: Purpose
+
+### Further Reading
+- Resource 1
+- Resource 2
+- Resource 3
+
+## Conclusion
+
+Key takeaways for using this reference guide effectively.
diff --git a/.agents/skills/code-reviewer/references/common_antipatterns.md b/.agents/skills/code-reviewer/references/common_antipatterns.md
new file mode 100644
index 0000000..19a2ded
--- /dev/null
+++ b/.agents/skills/code-reviewer/references/common_antipatterns.md
@@ -0,0 +1,103 @@
+# Common Antipatterns
+
+## Overview
+
+This reference guide provides comprehensive information for code reviewer.
+
+## Patterns and Practices
+
+### Pattern 1: Best Practice Implementation
+
+**Description:**
+Detailed explanation of the pattern.
+
+**When to Use:**
+- Scenario 1
+- Scenario 2
+- Scenario 3
+
+**Implementation:**
+```typescript
+// Example code implementation
+export class Example {
+  // Implementation details
+}
+```
+
+**Benefits:**
+- Benefit 1
+- Benefit 2
+- Benefit 3
+
+**Trade-offs:**
+- Consider 1
+- Consider 2
+- Consider 3
+
+### Pattern 2: Advanced Technique
+
+**Description:**
+Another important pattern for code reviewer.
+
+**Implementation:**
+```typescript
+// Advanced example
+async function advancedExample() {
+  // Code here
+}
+```
+
+## Guidelines
+
+### Code Organization
+- Clear structure
+- Logical separation
+- Consistent naming
+- Proper documentation
+
+### Performance Considerations
+- Optimization strategies
+- Bottleneck identification
+- Monitoring approaches
+- Scaling techniques
+
+### Security Best Practices
+- Input validation
+- Authentication
+- Authorization
+- Data protection
+
+## Common Patterns
+
+### Pattern A
+Implementation details and examples.
+
+### Pattern B
+Implementation details and examples.
+
+### Pattern C
+Implementation details and examples.
+
+## Anti-Patterns to Avoid
+
+### Anti-Pattern 1
+What not to do and why.
+
+### Anti-Pattern 2
+What not to do and why.
+
+## Tools and Resources
+
+### Recommended Tools
+- Tool 1: Purpose
+- Tool 2: Purpose
+- Tool 3: Purpose
+
+### Further Reading
+- Resource 1
+- Resource 2
+- Resource 3
+
+## Conclusion
+
+Key takeaways for using this reference guide effectively.
diff --git a/.agents/skills/code-reviewer/scripts/code_quality_checker.py b/.agents/skills/code-reviewer/scripts/code_quality_checker.py
new file mode 100755
index 0000000..35d4196
--- /dev/null
+++ b/.agents/skills/code-reviewer/scripts/code_quality_checker.py
@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+Code Quality Checker
+Automated tool for code reviewer tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class CodeQualityChecker:
+    """Main class for code quality checker functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="Code Quality Checker"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = CodeQualityChecker(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()
diff --git a/.agents/skills/code-reviewer/scripts/pr_analyzer.py b/.agents/skills/code-reviewer/scripts/pr_analyzer.py
new file mode 100755
index 0000000..926c06a
--- /dev/null
+++ b/.agents/skills/code-reviewer/scripts/pr_analyzer.py
@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+Pr Analyzer
+Automated tool for code reviewer tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class PrAnalyzer:
+    """Main class for pr analyzer functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="Pr Analyzer"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = PrAnalyzer(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()
diff --git a/.agents/skills/code-reviewer/scripts/review_report_generator.py b/.agents/skills/code-reviewer/scripts/review_report_generator.py
new file mode 100755
index 0000000..0805302
--- /dev/null
+++ b/.agents/skills/code-reviewer/scripts/review_report_generator.py
@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+Review Report Generator
+Automated tool for code reviewer tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class ReviewReportGenerator:
+    """Main class for review report generator functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="Review Report Generator"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = ReviewReportGenerator(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()
diff --git a/.agents/skills/codex-review/SKILL.md b/.agents/skills/codex-review/SKILL.md
new file mode 100644
index 0000000..9bea297
--- /dev/null
+++ b/.agents/skills/codex-review/SKILL.md
@@ -0,0 +1,37 @@
+---
+name: codex-review
+description: Professional code review with auto CHANGELOG generation, integrated with Codex AI
+---
+
+# codex-review
+
+## Overview
+Professional code review with auto CHANGELOG generation, integrated with Codex AI
+
+## When to Use
+- When you want professional code review before commits
+- When you need automatic CHANGELOG generation
+- When reviewing large-scale refactoring
+
+## Installation
+```bash
+npx skills add -g BenedictKing/codex-review
+```
+
+## Step-by-Step Guide
+1. Install the skill using the command above
+2. Ensure Codex CLI is installed
+3. Use `/codex-review` or natural language triggers
+
+## Examples
+See [GitHub Repository](https://github.com/BenedictKing/codex-review) for examples.
+
+## Best Practices
+- Keep CHANGELOG.md in your project root
+- Use conventional commit messages
+
+## Troubleshooting
+See the GitHub repository for troubleshooting guides.
+
+## Related Skills
+- context7-auto-research, tavily-web, exa-search, firecrawl-scraper
diff --git a/.agents/skills/commory-android/SKILL.md b/.agents/skills/commory-android/SKILL.md
new file mode 100644
index 0000000..24fc80d
--- /dev/null
+++ b/.agents/skills/commory-android/SKILL.md
@@ -0,0 +1,53 @@
+---
+name: commory-android
+description: Android app for Commory — dual runtime modes, Compose UI, MsgLayer backup/restore, server sync, and agent privacy model.
+---
+
+# Commory Android
+
+Work on the Commory Android app (package `com.iskenkenya.commory.mobile`).
+
+## Architecture
+
+```
+app/src/main/java/com/iskenkenya/commory/mobile/
+  runtime/                     — AppEnvironment, RuntimeMode, RuntimeModePolicy, AppEnvironmentManager, LocaleResolver
+  remote/                      — CommoryServerClient, CommoryApiService, NetworkError, DTOs
+  auth/                        — CommoryServerAuthProvider
+  agent/                       — AgentContextModels, AgentPrivacyPolicy
+  ui/screens/                  — ModeSelectionScreen, ServerSetupScreen, BackupScreen, RestoreScreen, MoreScreen
+  ui/navigation/NavigationHost — Two-level route guard (mode → auth → main)
+  ui/viewmodels/               — AppViewModel, BackupViewModel, RestoreViewModel
+  di/AppContainer              — Manual DI
+
+sdk/backup/                    — Pure Kotlin MsgLayer mapper, reader, writer
+sdk/auth/                      — AuthProvider interface, AuthCredentials sealed class
+sdk/storage/                   — Storage contracts
+```
+
+## Key Patterns
+
+- `AppEnvironment` is the single source of truth; persisted via DataStore; exposed as `StateFlow`.
+- `currentSnapshot()` reads a `@Volatile` cache updated by `onEach`; no `runBlocking`.
+- `RuntimeModePolicy` centralizes mode-dependent decisions (auth required, upload allowed, etc.).
+- `CommoryServerClient` caches Retrofit services per base URL; uses separate `refreshClient` for auth endpoints.
+- OkHttp `authenticator` auto-refreshes on 401; `/api/auth/` paths are excluded to prevent loops.
+- `NetworkError` sealed class maps IOException subtypes to typed errors for UI localization.
+- `AuthSession.isAuthenticated` checks JWT `exp` claim; `accessTokenExpiresAt()` decodes Base64 payload.
+- Backup always writes local first; upload is gated by `RuntimeModePolicy.canUploadBackup()`.
+- Mode switch shows `AlertDialog` confirmation; switching clears session but preserves local files.
+- `AgentPrivacyPolicy` maps `RuntimeMode` to `AgentProviderPolicy` (LOCAL_ONLY vs SERVER_ALLOWED).
+- Default server URL detects emulator via `Build.FINGERPRINT`.
+
+## Workflow
+
+1. Read `NavigationHost.kt` and the target screen/ViewModel.
+2. Read `docs/android-runtime-modes.md` for mode behavior.
+3. Read `docs/mobile-api.md` for server contract.
+4. Ensure string resources exist in `values/`, `values-en/`, `values-zh-rCN/`.
+5. Run: `cd android && ./gradlew :app:compileDebugKotlin && ./gradlew :app:testDebugUnitTest`
+
+## References
+
+- See `references/runtime-modes.md` for mode behavior details.
+- See `docs/mobile-api.md` for the server API contract.
diff --git a/.agents/skills/commory-android/references/runtime-modes.md b/.agents/skills/commory-android/references/runtime-modes.md
new file mode 100644
index 0000000..9bbde5a
--- /dev/null
+++ b/.agents/skills/commory-android/references/runtime-modes.md
@@ -0,0 +1,30 @@
+# Android Runtime Modes
+
+## LOCAL_ONLY
+
+- No account or server required.
+- Backup and restore use local app storage only.
+- Agent context policy: `LOCAL_ONLY` — context must not leave the device.
+- Switching into local mode clears auth tokens but preserves local backup files.
+
+## COMMORY_SERVER
+
+- User authenticates with Commory Server (username/password).
+- Backup writes local MsgLayer JSON first, then optionally uploads.
+- Upload is gated by three conditions: server mode + syncOnBackup + authenticated.
+- Remote import history and export use authenticated endpoints.
+- Agent context policy: `SERVER_ALLOWED` — future AI features may use server-backed providers with relevance filtering.
+
+## Mode Switching
+
+- Switching modes triggers an `AlertDialog` confirmation.
+- Switching to LOCAL_ONLY clears the auth session.
+- Switching to COMMORY_SERVER requires server URL and login.
+- Local backup files are always preserved across mode switches.
+
+## Session Lifecycle
+
+- `AuthSession.isAuthenticated` checks `accessToken` presence and JWT `exp` claim.
+- OkHttp `authenticator` auto-refreshes on 401 (excluding auth endpoints).
+- `logoutPersistedSession()` calls `POST /api/auth/logout` with refresh token, then clears local session.
+- Refresh token rotation: server issues a new refresh token on each refresh; old one is revoked.
diff --git a/.agents/skills/commory-backend/SKILL.md b/.agents/skills/commory-backend/SKILL.md
new file mode 100644
index 0000000..bd9c9dd
--- /dev/null
+++ b/.agents/skills/commory-backend/SKILL.md
@@ -0,0 +1,50 @@
+---
+name: commory-backend
+description: Go backend for Commory — JWT auth, file-backed storage, MsgLayer import/query, Setup wizard, and mobile API contract.
+---
+
+# Commory Backend
+
+Work on the Commory Go backend server.
+
+## Architecture
+
+```
+cmd/commory/main.go          — CLI entry (serve / import / validate)
+internal/cli/root.go          — Cobra commands, boot sequence
+internal/api/server.go        — HTTP handlers, public/private mux
+internal/auth/service.go      — PBKDF2-HMAC-SHA256 passwords, JWT HS256, login rate-limit, refresh rotation
+internal/auth/middleware.go   — Bearer token extraction, context propagation
+internal/setup/service.go     — First-run setup wizard, CheckSetup migration
+internal/storage/storage.go   — Provider interface (GetSetupStatus, SaveSetup, HasAdminUser, UpdateUserPasswordHash, etc.)
+internal/storage/filestore.go — JSON-file-backed Provider, scopeKey isolation, persist-on-write
+internal/storage/sqlite.go    — SQLite adapter factory
+internal/msglayer/validator.go— Schema validation + additionalProperties check
+internal/msglayer/types.go    — Go structs for MsgLayer v0.1
+internal/importers/           — JSON import pipeline
+internal/query/               — Timeline, search, identities, threads
+internal/config/config.go     — Env-driven config (AUTH_SECRET, TLS, ENV, DB_DSN, etc.)
+```
+
+## Key Patterns
+
+- Handlers are thin: parse request, call service, return envelope `{code, msg, data}`.
+- Auth middleware protects `/api/` routes; `/api/auth/` and `/api/setup` are public.
+- Password hashes use `pbkdf2$` prefix; legacy `sha256$` auto-migrates on login.
+- Refresh tokens are one-use (ConsumeRefreshToken revokes on refresh).
+- Logout revokes the refresh token before clearing the cookie.
+- Setup wizard: GET returns status, POST creates admin + writes SetupRecord. Repeat POST returns 400.
+- scopeKey uses SHA-1 first 8 bytes with legacy 4-byte fallback lookup.
+- Cookie Secure flag reads COMMORY_TLS; COMMORY_ENV=production rejects default auth secret.
+
+## Workflow
+
+1. Read `backend/internal/api/server.go` and the relevant service file.
+2. Read `docs/mobile-api.md` for contract alignment.
+3. Implement changes following the thin-handler pattern.
+4. Run: `cd backend && go vet ./... && go test ./... -coverprofile=coverage.out`
+
+## References
+
+- See `references/api-routes.md` for the full route table.
+- See `docs/mobile-api.md` for the mobile API contract.
diff --git a/.agents/skills/commory-backend/references/api-routes.md b/.agents/skills/commory-backend/references/api-routes.md
new file mode 100644
index 0000000..1d672e6
--- /dev/null
+++ b/.agents/skills/commory-backend/references/api-routes.md
@@ -0,0 +1,23 @@
+| Method | Path | Auth | Handler |
+|--------|------|------|---------|
+| POST | /api/auth/register | public | handleRegister |
+| POST | /api/auth/login | public | handleLogin |
+| POST | /api/auth/refresh | public | handleRefresh |
+| POST | /api/auth/logout | public | handleLogout |
+| GET | /api/setup | public | handleGetSetup |
+| POST | /api/setup | public | handlePostSetup |
+| GET | /api/user/info | Bearer | handleUserInfo |
+| GET | /api/imports | Bearer | handleImports |
+| POST | /api/imports/upload | Bearer | handleImportUpload |
+| GET | /api/imports/{id}/export | Bearer | handleImportExport |
+| POST | /api/imports/path | Bearer+Admin | handleImportPath |
+| POST | /api/validate/upload | Bearer | handleValidateUpload |
+| POST | /api/validate/path | Bearer+Admin | handleValidatePath |
+| GET | /api/dashboard | Bearer | handleDashboard |
+| GET | /api/events | Bearer | handleEvents |
+| GET | /api/events/{id} | Bearer | handleEvent |
+| GET | /api/timeline | Bearer | handleTimeline |
+| GET | /api/identities | Bearer | handleIdentities |
+| GET | /api/identities/{id} | Bearer | handleIdentity |
+| GET | /api/search | Bearer | handleSearch |
+| GET | /api/threads/{id} | Bearer | handleThread |
diff --git a/.agents/skills/commory-msglayer/SKILL.md b/.agents/skills/commory-msglayer/SKILL.md
new file mode 100644
index 0000000..e8670e0
--- /dev/null
+++ b/.agents/skills/commory-msglayer/SKILL.md
@@ -0,0 +1,55 @@
+---
+name: commory-msglayer
+description: MsgLayer schema v0.1 — the canonical interchange format between Android, Go backend, web, and future agents.
+---
+
+# MsgLayer Schema
+
+Work on the MsgLayer interchange format and its implementations.
+
+## Schema Location
+
+```
+msglayer/schema/v0.1/root.schema.json   — JSON Schema root
+msglayer/examples/                       — Example export files
+backend/internal/msglayer/               — Go validator, types, constants
+android/sdk/backup/                      — Kotlin mapper, reader, writer
+```
+
+## Core Types
+
+- `RootExport`: version, source, identities[], events[], relations[], indexes[]
+- `Identity`: id, type, display_name, avatar?, phones[], emails[], labels[]
+- `Event`: id, timestamp, type, direction, participants[], content{}, relations[], meta?
+- `Relation`: type (same_thread, references_identity, reply_to, derived_from), target
+- `SearchParams`: userID, keyword, contactID, type, participant, from, to, limit, offset
+
+## Version
+
+- Current: `msglayer/v0.1`
+- Go constant: `msglayer.Version`
+- Kotlin constant: `MSG_LAYER_VERSION`
+- Both must stay in sync; CI does not currently check this.
+
+## Validation Rules
+
+- `additionalProperties: false` is enforced by the Go validator for events, identities, and content maps.
+- Allowed event fields: id, timestamp, type, direction, participants, content, relations, meta.
+- Allowed identity fields: id, type, display_name, avatar, phones, emails, labels, meta.
+- Content keys are type-specific: sms→text, call→duration_sec/call_type, voice→file/transcript/summary, contact_snapshot→identity_id.
+- Event types: sms, call, voice, contact_snapshot.
+- Direction values: inbound, outbound, missed (for calls).
+- Relation types: same_thread, references_identity (active); reply_to, derived_from (reserved).
+
+## Workflow
+
+1. Read `msglayer/schema/v0.1/root.schema.json` for the authoritative schema.
+2. Read `msglayer/examples/` for valid export files.
+3. Modify Go validator in `backend/internal/msglayer/validator.go` if adding new validation rules.
+4. Modify Kotlin mapper in `android/sdk/backup/` if adding new event types or fields.
+5. Run backend tests: `cd backend && go test ./internal/msglayer/ -v`
+6. Run Android tests: `cd android && ./gradlew :sdk:backup:testDebugUnitTest`
+
+## References
+
+- See `references/event-types.md` for event type definitions and content schemas.
diff --git a/.agents/skills/commory-msglayer/references/event-types.md b/.agents/skills/commory-msglayer/references/event-types.md
new file mode 100644
index 0000000..5e53e2f
--- /dev/null
+++ b/.agents/skills/commory-msglayer/references/event-types.md
@@ -0,0 +1,53 @@
+# MsgLayer Event Types
+
+## sms
+
+Content keys: `text`
+
+Direction: inbound, outbound
+
+## call
+
+Content keys: `duration_sec`, `call_type`
+
+Direction: inbound, outbound, missed
+
+call_type values: incoming, outgoing, missed, rejected
+
+## voice
+
+Content keys: `file`, `transcript`, `summary`
+
+Direction: inbound, outbound
+
+## contact_snapshot
+
+Content keys: `identity_id`
+
+Direction: none (not applicable)
+
+## Relation Types
+
+| Type | Status | Description |
+|------|--------|-------------|
+| same_thread | active | Links events in the same conversation thread |
+| references_identity | active | Links an event to a contact identity |
+| reply_to | reserved | Indicates a reply relationship between events |
+| derived_from | reserved | Indicates one event was derived from another |
+
+## Android Direction Mapping
+
+| Android SMS Type | MsgLayer Direction |
+|-----------------|-------------------|
+| 1 (inbox) | inbound |
+| 2 (sent) | outbound |
+| 3 (draft) | outbound (best approximation) |
+| 4 (outbox) | outbound |
+| 5 (failed) | outbound |
+| 6 (queued) | outbound |
+
+| Android Call Type | MsgLayer Direction | MsgLayer call_type |
+|------------------|-------------------|-------------------|
+| 1 (incoming) | inbound | incoming |
+| 2 (outgoing) | outbound | outgoing |
+| 5 (rejected) | missed | rejected |
diff --git a/.agents/skills/design-mirror/SKILL.md b/.agents/skills/design-mirror/SKILL.md
new file mode 100644
index 0000000..d0ddb31
--- /dev/null
+++ b/.agents/skills/design-mirror/SKILL.md
@@ -0,0 +1,171 @@
+---
+name: design-mirror
+description: "Replicate the visual style of any website and apply it to your existing codebase. Use this skill whenever the user wants to match a site's design, mirror a UI aesthetic, make their app look like another site, or replicate a specific visual style from a URL. Trigger on phrases like 'make it look like', 'match the design of', 'copy the style from', 'I want my app to look like X', 'mirror this design', 'inspired by [url]', or any time the user points at a website and says they want their frontend to match it."
+---
+
+# Design Mirror
+
+Capture the visual design language of any website and apply it to your existing codebase — colors, typography, spacing, layout rhythm, component shapes, and overall aesthetic — all extracted live via Bright Data's Web Unlocker.
+
+## What This Skill Does
+
+1. **Capture** — Screenshot + HTML scrape the inspiration site via Bright Data
+2. **Extract** — Identify the full design system: colors, fonts, spacing scale, border radii, shadows, component patterns
+3. **Analyze** — Study the screenshot visually and the CSS structurally to understand the design language
+4. **Apply** — Translate that design system into the user's existing codebase (their framework, their components)
+
+You are not copying content or functionality. You're understanding the *design language* — the palette, the type scale, the card shapes, the hover states, the overall aesthetic feel.
+
+> **Important:** This skill is for design inspiration and learning — extracting publicly visible design tokens (colors, fonts, spacing) to inform your own UI work. Always use it respectfully and in accordance with the terms of service of the sites you reference.
+
+## Setup
+
+Requires:
+- `BRIGHTDATA_API_KEY` — from [brightdata.com/cp](https://brightdata.com/cp) → Account Settings
+- `BRIGHTDATA_UNLOCKER_ZONE` — create an Unlocker zone at brightdata.com/cp
+
+```bash
+export BRIGHTDATA_API_KEY="your-api-key"
+export BRIGHTDATA_UNLOCKER_ZONE="your-zone-name"
+```
+
+## Step-by-Step Process
+
+### Step 1: Capture the Inspiration Site
+
+Run both captures in parallel — screenshot (for visual analysis) and HTML scrape (for CSS extraction):
+
+```bash
+# Screenshot (save as PNG)
+bash scripts/screenshot.sh "https://inspiration-site.com" "/tmp/target_screenshot.png"
+
+# HTML + CSS scrape
+bash scripts/scrape_html.sh "https://inspiration-site.com" "/tmp/target_page.html"
+```
+
+Read `references/capture-guide.md` for how to extract CSS from the raw HTML and handle common issues.
+
+### Step 2: Analyze the Design System
+
+After capturing, analyze both in parallel:
+
+**Visual analysis (screenshot):** Read the PNG image and identify:
+- Primary, secondary, accent colors
+- Background colors (page bg, card bg, surface hierarchy)
+- Typography: font families visible, size hierarchy (h1 → body → caption)
+- Layout: is it centered/constrained-width? Grid? Sidebar?
+- Card/container shapes: border radius size, shadow style (hard, soft, none, colored)
+- Button styles: pill, rectangle, ghost, gradient?
+- Navigation: sticky? Glass/blur effect? Dark or light?
+- Overall mood: dark, light, minimal, brutalist, glassmorphism, corporate, startup?
+
+**CSS analysis (HTML):** Extract from `<style>` tags and inline styles:
+- CSS custom properties (`:root { --color-... }`) — publicly declared design tokens
+- Font imports (`@import` from Google Fonts, etc.)
+- Tailwind config if present
+- Repeated class patterns that reveal the spacing scale
+
+Read `references/css-extraction.md` for the extraction playbook.
+
+### Step 3: Build the Design Token Map
+
+Produce a structured design token map before touching any code:
+
+```
+DESIGN TOKENS FROM [site]
+==========================
+Colors:
+  --bg-primary: #0a0a0f      (page background)
+  --bg-surface: #13131a      (card/panel background)
+  --text-primary: #ffffff
+  --text-muted: #8888aa
+  --accent: #7c3aed          (primary CTA color)
+  --accent-hover: #6d28d9
+  --border: rgba(255,255,255,0.08)
+
+Typography:
+  --font-heading: 'Inter', sans-serif
+  --font-body: 'Inter', sans-serif
+  font-scale: 12/14/16/20/24/32/48px
+  heading-weight: 700
+  body-weight: 400
+
+Spacing:
+  base-unit: 8px
+  scale: 4/8/12/16/24/32/48/64px
+
+Borders & Shadows:
+  --radius-sm: 6px
+  --radius-md: 12px
+  --radius-lg: 20px
+  --shadow: 0 4px 24px rgba(0,0,0,0.4)
+
+Special effects:
+  glass-blur: backdrop-filter: blur(16px)
+  gradient: linear-gradient(135deg, #7c3aed, #2563eb)
+```
+
+Show this token map to the user before proceeding. It's the foundation — if it's wrong, the output will be wrong.
+
+### Step 4: Understand the User's Codebase
+
+Before writing any code, read the relevant parts of their codebase:
+
+- What framework? (React, Vue, Next.js, plain HTML?)
+- What styling approach? (Tailwind, CSS modules, styled-components, plain CSS?)
+- Where are global styles defined? (globals.css, theme.ts, tailwind.config.js?)
+- What components need restyling? (ask the user if unclear)
+
+Do not rewrite everything — surgical precision. Apply the design tokens to the existing structure.
+
+### Step 5: Apply the Design
+
+The application strategy depends on their stack:
+
+**If Tailwind:** Update `tailwind.config.js` with the new color palette, font family, border radius scale. Add custom CSS variables for anything Tailwind can't handle natively.
+
+**If CSS/CSS Modules:** Create or update a `:root` variables block in globals.css. Update component stylesheets to use the new variables.
+
+**If styled-components/Emotion:** Update the theme object. Replace hardcoded color/spacing values with theme tokens.
+
+**In all cases:**
+- Apply colors, typography, and spacing globally first
+- Then tackle component-level details (buttons, cards, nav) one at a time
+- Preserve all existing functionality and layout structure — only visual properties change
+- Add any special effects (glass blur, gradients, animations) that define the inspiration site's character
+
+Read `references/apply-guide.md` for framework-specific implementation patterns.
+
+### Step 6: Show the Before/After
+
+After applying changes, clearly present:
+- Which files were modified
+- The design token mapping (source → what you set it to)
+- Any special effects added
+- What the user should check visually (hover states, dark/light mode, mobile)
+
+If the user has a dev server running, remind them to check it. Offer to iterate on specific components.
+
+## Key Principles
+
+**Design language, not markup.** The inspiration site's HTML structure and content are theirs. You're extracting the *design language* — how colors relate, how spacing flows, what gives the site its character — to apply as your own creative foundation.
+
+**Design tokens first, code second.** Rushing to apply colors before understanding the full system leads to inconsistent results. Always build the token map first.
+
+**Ask about scope.** "Apply the design everywhere" vs "just make the homepage feel like it" vs "only restyle the navbar" are very different jobs. Clarify before proceeding.
+
+**Don't break what works.** The user's components work. Only change visual properties. If you're uncertain whether a change might break layout, err on the side of caution and flag it.
+
+**Iterative is fine.** It's often better to get the foundation right (colors, type, spacing) and let the user review before tackling component-level details.
+
+## What to Do When...
+
+**The site uses a design system (Material, shadcn, etc.):** Identify it, tell the user, and ask if they want to adopt the same system or just extract the visual tokens.
+
+**The CSS is minified/obfuscated:** Fall back to the screenshot + visual analysis. You can still extract colors, spacing, and shapes from visual inspection.
+
+**The inspiration site is JS-rendered and the HTML scrape comes back mostly empty:** Note this to the user — the screenshot will still work for visual analysis, but CSS extraction will be limited. You can still infer most tokens visually.
+
+**The user's codebase uses a component library (shadcn, Chakra, MUI):** Apply the design by customizing the library's theme/config rather than overriding individual components.
+
+**Multiple pages need to match:** Use the homepage for overall design tokens, but offer to check inner pages (e.g., `/pricing`, `/docs`) if the user wants to match a specific page's look.
diff --git a/.agents/skills/design-mirror/references/apply-guide.md b/.agents/skills/design-mirror/references/apply-guide.md
new file mode 100644
index 0000000..b6aff11
--- /dev/null
+++ b/.agents/skills/design-mirror/references/apply-guide.md
@@ -0,0 +1,271 @@
+# Design Application Guide
+
+How to apply extracted design tokens to different frontend stacks.
+
+## Tailwind CSS Projects
+
+### 1. Update tailwind.config.js / tailwind.config.ts
+
+```js
+// tailwind.config.js
+module.exports = {
+  theme: {
+    extend: {
+      colors: {
+        bg: {
+          page:    '#0a0a0f',
+          surface: '#13131a',
+          elevated:'#1a1a2e',
+        },
+        brand: {
+          DEFAULT: '#7c3aed',
+          hover:   '#6d28d9',
+        },
+        border: 'rgba(255,255,255,0.08)',
+        text: {
+          primary:   '#ffffff',
+          secondary: '#a0a0b8',
+          muted:     '#606080',
+        }
+      },
+      fontFamily: {
+        sans: ['Inter', 'sans-serif'],
+      },
+      borderRadius: {
+        'sm': '6px',
+        'md': '12px',
+        'lg': '20px',
+        'xl': '28px',
+      },
+      boxShadow: {
+        'card': '0 4px 24px rgba(0,0,0,0.4)',
+        'glow': '0 0 24px rgba(124,58,237,0.3)',
+      },
+    }
+  }
+}
+```
+
+### 2. Update globals.css for non-Tailwind properties
+
+```css
+/* globals.css */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+
+:root {
+  --gradient-hero: linear-gradient(135deg, #7c3aed 0%, #2563eb 100%);
+  --gradient-subtle: radial-gradient(ellipse at top, rgba(124,58,237,0.15), transparent);
+  --blur-glass: blur(16px);
+  --transition: all 0.2s ease;
+}
+
+body {
+  background-color: #0a0a0f;
+  color: #ffffff;
+  font-family: 'Inter', sans-serif;
+}
+```
+
+### 3. Update component classes
+
+Go through the user's main components and replace hardcoded color/spacing classes with the new ones. Focus on:
+- `bg-*` → new background tokens
+- `text-*` → new text tokens
+- `border-*` → new border tokens
+- `rounded-*` → new radius tokens
+
+---
+
+## Plain CSS / CSS Modules Projects
+
+### 1. Create/update design tokens file
+
+```css
+/* styles/tokens.css or styles/globals.css */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+
+:root {
+  /* Colors */
+  --color-bg-page:     #0a0a0f;
+  --color-bg-surface:  #13131a;
+  --color-bg-elevated: #1a1a2e;
+  --color-text:        #ffffff;
+  --color-text-muted:  #a0a0b8;
+  --color-brand:       #7c3aed;
+  --color-brand-hover: #6d28d9;
+  --color-border:      rgba(255, 255, 255, 0.08);
+
+  /* Typography */
+  --font-sans: 'Inter', sans-serif;
+  --text-xs:   12px;
+  --text-sm:   14px;
+  --text-base: 16px;
+  --text-lg:   20px;
+  --text-xl:   24px;
+  --text-2xl:  32px;
+  --text-3xl:  48px;
+
+  /* Spacing */
+  --space-1:  4px;
+  --space-2:  8px;
+  --space-3:  12px;
+  --space-4:  16px;
+  --space-6:  24px;
+  --space-8:  32px;
+  --space-12: 48px;
+  --space-16: 64px;
+
+  /* Borders */
+  --radius-sm:   6px;
+  --radius-md:   12px;
+  --radius-lg:   20px;
+  --radius-pill: 9999px;
+
+  /* Shadows & Effects */
+  --shadow-card:  0 4px 24px rgba(0, 0, 0, 0.4);
+  --shadow-glow:  0 0 24px rgba(124, 58, 237, 0.3);
+  --blur-glass:   blur(16px);
+
+  /* Gradients */
+  --gradient-hero: linear-gradient(135deg, #7c3aed 0%, #2563eb 100%);
+
+  /* Animation */
+  --transition: all 0.2s ease;
+}
+
+body {
+  background: var(--color-bg-page);
+  color: var(--color-text);
+  font-family: var(--font-sans);
+  line-height: 1.5;
+}
+```
+
+### 2. Update component styles
+
+Replace hardcoded values with variables throughout component CSS files. Use find+replace for common patterns.
+
+---
+
+## styled-components / Emotion Projects
+
+### 1. Update the theme object
+
+```ts
+// theme.ts
+export const theme = {
+  colors: {
+    bg: {
+      page:    '#0a0a0f',
+      surface: '#13131a',
+      elevated:'#1a1a2e',
+    },
+    text: {
+      primary:  '#ffffff',
+      muted:    '#a0a0b8',
+    },
+    brand: '#7c3aed',
+    border:'rgba(255,255,255,0.08)',
+  },
+  fonts: {
+    sans: "'Inter', sans-serif",
+  },
+  radii: {
+    sm:   '6px',
+    md:   '12px',
+    lg:   '20px',
+    pill: '9999px',
+  },
+  shadows: {
+    card: '0 4px 24px rgba(0,0,0,0.4)',
+    glow: '0 0 24px rgba(124,58,237,0.3)',
+  },
+  gradients: {
+    hero: 'linear-gradient(135deg, #7c3aed 0%, #2563eb 100%)',
+  },
+  transitions: {
+    default: 'all 0.2s ease',
+  },
+}
+```
+
+---
+
+## Next.js / Nuxt Projects
+
+These are usually Tailwind or CSS Modules under the hood — apply the appropriate guide above.
+
+For Next.js specifically:
+- Global styles: `app/globals.css` (App Router) or `styles/globals.css` (Pages Router)
+- Tailwind config: `tailwind.config.ts` at root
+
+---
+
+## Component Priority Order
+
+Apply the design in this order for maximum impact with minimum risk:
+
+1. **Global background + text colors** — immediate transformation, zero breakage risk
+2. **Font import + font-family** — single line change, huge visual impact
+3. **Navigation/header** — most visible, sets the tone
+4. **Cards & containers** — background, border, radius, shadow
+5. **Buttons** — color, shape, hover state
+6. **Form inputs** — background, border, focus ring
+7. **Typography scale** — heading sizes and weights
+8. **Special effects** — glass blur, gradients, glows (do these last, they're icing)
+
+---
+
+## Glassmorphism Effect (Common in Modern SaaS/AI Sites)
+
+If the target site uses glass cards (common in dark AI/SaaS sites):
+
+```css
+.glass-card {
+  background: rgba(255, 255, 255, 0.05);
+  backdrop-filter: blur(16px);
+  -webkit-backdrop-filter: blur(16px);
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 12px;
+}
+```
+
+In Tailwind:
+```html
+<div class="bg-white/5 backdrop-blur-md border border-white/8 rounded-xl">
+```
+
+Note: `backdrop-filter` requires the parent to NOT have `overflow: hidden` set on ancestors in some browsers. Flag this to the user if they see glass effects not working.
+
+---
+
+## Gradient Text (Popular in AI/Tech Sites)
+
+```css
+.gradient-text {
+  background: linear-gradient(135deg, #7c3aed, #2563eb);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+```
+
+In Tailwind (requires custom config or inline style):
+```html
+<span class="bg-gradient-to-r from-violet-500 to-blue-500 bg-clip-text text-transparent">
+```
+
+---
+
+## Checking Your Work
+
+After applying, mentally walk through:
+- [ ] Page background matches
+- [ ] Primary text color matches
+- [ ] Card/panel background and border match
+- [ ] Primary button color + shape match
+- [ ] Font family matches (check Chrome DevTools → Computed → font-family)
+- [ ] Heading weight and size feel similar
+- [ ] Any special effects (blur, gradient, glow) are present
+- [ ] Hover transitions feel similar in speed/style
+- [ ] Mobile layout feels similar (padding, stacking)
diff --git a/.agents/skills/design-mirror/references/capture-guide.md b/.agents/skills/design-mirror/references/capture-guide.md
new file mode 100644
index 0000000..af35eaa
--- /dev/null
+++ b/.agents/skills/design-mirror/references/capture-guide.md
@@ -0,0 +1,84 @@
+# Capture Guide
+
+## Running Both Captures
+
+Always run screenshot and HTML scrape in parallel (they're independent requests):
+
+```bash
+# Run both simultaneously
+bash scripts/screenshot.sh "https://target.com" "/tmp/target_screenshot.png" &
+SCREENSHOT_PID=$!
+
+bash scripts/scrape_html.sh "https://target.com" "/tmp/target_page.html" &
+HTML_PID=$!
+
+wait $SCREENSHOT_PID $HTML_PID
+echo "Both captures complete"
+```
+
+Or just use two Agent tool calls in the same message.
+
+## Reading the Screenshot
+
+Use the Read tool on the PNG file path — Claude is multimodal and can directly analyze the image. Describe what you see in terms of the design token categories (colors, type, layout, components, effects).
+
+## Reading the HTML
+
+The HTML file can be very large. Use Grep to extract the most useful parts:
+
+```bash
+# Extract CSS custom properties
+grep -o '\-\-[a-zA-Z-]*:[^;]*' /tmp/target_page.html | head -100
+
+# Extract @import font statements
+grep -E '@import|fonts\.googleapis' /tmp/target_page.html | head -20
+
+# Extract <style> block content
+grep -A 500 '<style' /tmp/target_page.html | head -600
+
+# Extract inline styles from key elements
+grep -o 'style="[^"]*"' /tmp/target_page.html | head -50
+
+# Look for Tailwind config
+grep -A 20 'tailwind.config' /tmp/target_page.html | head -50
+```
+
+## Common Issues
+
+### Large HTML files
+Use Grep with specific patterns rather than reading the whole file. Focus on `<style>` tags, `:root`, `@import`, and `<link rel="stylesheet">`.
+
+### Minified CSS
+Minified CSS has no whitespace. You can still extract colors with:
+```bash
+grep -oE '#[0-9a-fA-F]{3,8}' /tmp/target_page.html | sort -u
+grep -oE 'rgb\([^)]+\)' /tmp/target_page.html | sort -u
+grep -oE 'rgba\([^)]+\)' /tmp/target_page.html | sort -u
+```
+
+### External CSS files
+The HTML may reference external `.css` files. You'll see `<link href="/assets/style.abc123.css" rel="stylesheet">`. Unfortunately, relative paths won't work from the API response. Use the full URL with the scrape script:
+```bash
+bash scripts/scrape_html.sh "https://target.com/assets/style.abc123.css" "/tmp/target_styles.css"
+```
+
+### JS-rendered sites (mostly empty HTML)
+If the HTML is sparse (React/Next.js SPA), the design lives in:
+1. The screenshot (fully rendered) — most useful
+2. External CSS chunks linked in `<head>`
+3. Inline `<script>` blocks with config data
+
+Fall back to pure visual extraction from the screenshot in this case.
+
+## Screenshot Quality
+
+The screenshot captures the full rendered page at desktop viewport. For sites with:
+- **Dark themes**: Colors will be accurate in screenshot
+- **Animations**: Screenshot captures a static moment (usually the loaded state)
+- **Sticky headers**: Will show in their scrolled-to-top position
+- **Above-the-fold content**: Most important — this is what defines the brand
+
+If you need to see a specific section (e.g., pricing page, a component below the fold), scrape a different URL:
+```bash
+bash scripts/screenshot.sh "https://target.com/pricing" "/tmp/pricing_screenshot.png"
+```
diff --git a/.agents/skills/design-mirror/references/css-extraction.md b/.agents/skills/design-mirror/references/css-extraction.md
new file mode 100644
index 0000000..b77f4bb
--- /dev/null
+++ b/.agents/skills/design-mirror/references/css-extraction.md
@@ -0,0 +1,150 @@
+# CSS Extraction Playbook
+
+After scraping the raw HTML, extract the design tokens systematically. Work through these layers in order.
+
+## Layer 1: CSS Custom Properties (The Jackpot)
+
+Search the HTML for `:root` blocks — these are design systems that have done your work for you:
+
+```html
+<style>
+  :root {
+    --color-bg: #0a0a0f;
+    --color-primary: #7c3aed;
+    --font-sans: 'Inter', sans-serif;
+    --radius: 12px;
+  }
+</style>
+```
+
+Grab every `--variable` and classify it: color, font, spacing, shadow, radius, animation.
+
+## Layer 2: Font Imports
+
+Look for `@import` at the top of `<style>` blocks and in `<link>` tags:
+
+```html
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap">
+```
+
+Or within CSS:
+```css
+@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;700&display=swap');
+```
+
+Record the font families and the weights loaded — the weights tell you what's used (e.g., 300 = light body, 700 = bold headings).
+
+## Layer 3: Tailwind Config (if site uses Tailwind)
+
+Signs it's Tailwind: classes like `bg-purple-600`, `text-gray-200`, `rounded-xl`, `shadow-lg`, `backdrop-blur-md`.
+
+If there's a custom Tailwind theme, it may appear as an inline script:
+```html
+<script>
+  tailwind.config = {
+    theme: {
+      extend: {
+        colors: { brand: '#7c3aed' }
+      }
+    }
+  }
+</script>
+```
+
+For standard Tailwind sites without custom config, use the visual screenshot to identify which Tailwind colors they're using, then replicate with the same class names.
+
+## Layer 4: Repeated Class Patterns
+
+Scan the HTML for repeated class combinations on similar elements. The pattern reveals the design system:
+
+```html
+<!-- Repeated card pattern -->
+<div class="bg-white/5 border border-white/10 rounded-2xl p-6 shadow-xl backdrop-blur-sm">
+
+<!-- Repeated button pattern -->
+<button class="bg-violet-600 hover:bg-violet-500 text-white font-semibold px-6 py-3 rounded-full transition-all">
+```
+
+These patterns tell you the component-level design decisions even without explicit custom properties.
+
+## Layer 5: Inline Styles & Gradients
+
+Look for inline `style=""` attributes on hero sections, headers, and highlighted elements — these often contain the most intentional design choices:
+
+```html
+<section style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);">
+<div style="background: radial-gradient(ellipse at top, rgba(124,58,237,0.15) 0%, transparent 60%);">
+```
+
+## Layer 6: Animation & Transition Patterns
+
+Note CSS transitions and animations — they define the "feel" of the site:
+
+```css
+transition: all 0.2s ease;        /* snappy */
+transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);  /* Material-style */
+animation: fadeIn 0.6s ease forwards;  /* page load feel */
+```
+
+## When the HTML Comes Back Sparse (JS-Rendered Sites)
+
+Signs: `<div id="root"></div>` with minimal content, or `<div id="__next">` with a loading spinner.
+
+In this case:
+1. Screenshot is still fully usable for visual analysis
+2. Look for `<link>` tags pointing to external CSS files — note their paths even if you can't fetch them
+3. Look for any `<script>` tags with inline config (Next.js/Nuxt often embed theme data)
+4. Check for `<meta>` theme-color tags: `<meta name="theme-color" content="#7c3aed">`
+5. Fall back to full visual extraction from the screenshot
+
+## Output Format
+
+Always output your extraction as a structured token map before writing any code:
+
+```
+EXTRACTED DESIGN TOKENS
+========================
+Source: https://example.com
+Method: CSS custom properties + visual analysis
+
+COLORS
+  Background:
+    page:    #0a0a0f
+    surface: #13131a  (cards, panels)
+    elevated:#1a1a2e  (modals, dropdowns)
+  Text:
+    primary: #ffffff
+    secondary:#a0a0b8
+    muted:   #606080
+  Brand:
+    primary: #7c3aed
+    hover:   #6d28d9
+    glow:    rgba(124,58,237,0.3)
+  Border:   rgba(255,255,255,0.08)
+
+TYPOGRAPHY
+  Heading font: 'Inter', sans-serif (weights: 600, 700)
+  Body font:    'Inter', sans-serif (weight: 400)
+  Size scale:   12 / 14 / 16 / 20 / 24 / 32 / 48 / 64px
+  Line height:  1.5 body / 1.2 headings
+
+SPACING
+  Base unit: 8px
+  Scale: 4 / 8 / 12 / 16 / 20 / 24 / 32 / 48 / 64 / 96px
+
+BORDERS & EFFECTS
+  Radius sm:  6px   (badges, inputs)
+  Radius md:  12px  (cards)
+  Radius lg:  20px  (modals, large containers)
+  Radius pill: 9999px (buttons, tags)
+  Shadow:     0 4px 24px rgba(0,0,0,0.4)
+  Glass blur: backdrop-filter: blur(16px)
+
+GRADIENTS
+  Hero:    linear-gradient(135deg, #7c3aed 0%, #2563eb 100%)
+  Subtle:  radial-gradient(ellipse at top, rgba(124,58,237,0.15), transparent)
+
+ANIMATIONS
+  Transition: all 0.2s ease
+  Hover scale: transform: scale(1.02)
+```
diff --git a/.agents/skills/design-mirror/scripts/scrape_html.sh b/.agents/skills/design-mirror/scripts/scrape_html.sh
new file mode 100644
index 0000000..ab683a4
--- /dev/null
+++ b/.agents/skills/design-mirror/scripts/scrape_html.sh
@@ -0,0 +1,37 @@
+#!/bin/bash
+# Scrape full HTML (including inline CSS) from any URL via Bright Data Web Unlocker
+# Usage: bash scrape_html.sh "https://target-site.com" "/tmp/output.html"
+
+URL="$1"
+OUTPUT="${2:-/tmp/target_page.html}"
+
+if [ -z "$URL" ]; then
+    echo "Usage: $0 \"url\" [output_path]" >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_API_KEY:-}" ]; then
+    echo "Error: BRIGHTDATA_API_KEY is not set." >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_UNLOCKER_ZONE:-}" ]; then
+    echo "Error: BRIGHTDATA_UNLOCKER_ZONE is not set." >&2
+    exit 1
+fi
+
+echo "Scraping HTML from: $URL" >&2
+
+curl -k -s -X POST 'https://api.brightdata.com/request' \
+    -H "Authorization: Bearer $BRIGHTDATA_API_KEY" \
+    -H 'Content-Type: application/json' \
+    -d "{\"zone\":\"$BRIGHTDATA_UNLOCKER_ZONE\",\"url\":\"$URL\",\"format\":\"raw\"}" \
+    --output "$OUTPUT"
+
+if [ $? -eq 0 ] && [ -s "$OUTPUT" ]; then
+    echo "HTML saved to: $OUTPUT" >&2
+    echo "$OUTPUT"
+else
+    echo "Error: Failed to scrape HTML" >&2
+    exit 1
+fi
diff --git a/.agents/skills/design-mirror/scripts/screenshot.sh b/.agents/skills/design-mirror/scripts/screenshot.sh
new file mode 100644
index 0000000..1eed321
--- /dev/null
+++ b/.agents/skills/design-mirror/scripts/screenshot.sh
@@ -0,0 +1,37 @@
+#!/bin/bash
+# Capture a screenshot of any URL via Bright Data Web Unlocker
+# Usage: bash screenshot.sh "https://target-site.com" "/tmp/output.png"
+
+URL="$1"
+OUTPUT="${2:-/tmp/target_screenshot.png}"
+
+if [ -z "$URL" ]; then
+    echo "Usage: $0 \"url\" [output_path]" >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_API_KEY:-}" ]; then
+    echo "Error: BRIGHTDATA_API_KEY is not set." >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_UNLOCKER_ZONE:-}" ]; then
+    echo "Error: BRIGHTDATA_UNLOCKER_ZONE is not set." >&2
+    exit 1
+fi
+
+echo "Capturing screenshot of: $URL" >&2
+
+curl -k -s -X POST 'https://api.brightdata.com/request' \
+    -H "Authorization: Bearer $BRIGHTDATA_API_KEY" \
+    -H 'Content-Type: application/json' \
+    -d "{\"zone\":\"$BRIGHTDATA_UNLOCKER_ZONE\",\"url\":\"$URL\",\"format\":\"raw\",\"data_format\":\"screenshot\"}" \
+    --output "$OUTPUT"
+
+if [ $? -eq 0 ] && [ -s "$OUTPUT" ]; then
+    echo "Screenshot saved to: $OUTPUT" >&2
+    echo "$OUTPUT"
+else
+    echo "Error: Failed to capture screenshot" >&2
+    exit 1
+fi
diff --git a/.agents/skills/design-system-starter/SKILL.md b/.agents/skills/design-system-starter/SKILL.md
new file mode 100644
index 0000000..4d37e9b
--- /dev/null
+++ b/.agents/skills/design-system-starter/SKILL.md
@@ -0,0 +1,603 @@
+---
+name: design-system-starter
+description: Create and evolve design systems with design tokens, component architecture, accessibility guidelines, and documentation templates. Ensures consistent, scalable, and accessible UI across products.
+license: MIT
+metadata:
+  version: 1.0.0
+  tags: [design-system, ui, components, design-tokens, accessibility, frontend]
+---
+
+# Design System Starter
+
+Build robust, scalable design systems that ensure visual consistency and exceptional user experiences.
+
+---
+
+## Quick Start
+
+Just describe what you need:
+
+```
+Create a design system for my React app with dark mode support
+```
+
+That's it. The skill provides tokens, components, and accessibility guidelines.
+
+---
+
+## Triggers
+
+| Trigger | Example |
+|---------|---------|
+| Create design system | "Create a design system for my app" |
+| Design tokens | "Set up design tokens for colors and spacing" |
+| Component architecture | "Design component structure using atomic design" |
+| Accessibility | "Ensure WCAG 2.1 compliance for my components" |
+| Dark mode | "Implement theming with dark mode support" |
+
+---
+
+## Quick Reference
+
+| Task | Output |
+|------|--------|
+| Design tokens | Color, typography, spacing, shadows JSON |
+| Component structure | Atomic design hierarchy (atoms, molecules, organisms) |
+| Theming | CSS variables or ThemeProvider setup |
+| Accessibility | WCAG 2.1 AA compliant patterns |
+| Documentation | Component docs with props, examples, a11y notes |
+
+---
+
+## Bundled Resources
+
+- `references/component-examples.md` - Complete component implementations
+- `templates/design-tokens-template.json` - W3C design token format
+- `templates/component-template.tsx` - React component template
+- `checklists/design-system-checklist.md` - Design system audit checklist
+
+---
+
+## Design System Philosophy
+
+### What is a Design System?
+
+A design system is more than a component library—it's a collection of:
+
+1. **Design Tokens**: Foundational design decisions (colors, spacing, typography)
+2. **Components**: Reusable UI building blocks
+3. **Patterns**: Common UX solutions and compositions
+4. **Guidelines**: Rules, principles, and best practices
+5. **Documentation**: How to use everything effectively
+
+### Core Principles
+
+**1. Consistency Over Creativity**
+- Predictable patterns reduce cognitive load
+- Users learn once, apply everywhere
+- Designers and developers speak the same language
+
+**2. Accessible by Default**
+- WCAG 2.1 Level AA compliance minimum
+- Keyboard navigation built-in
+- Screen reader support from the start
+
+**3. Scalable and Maintainable**
+- Design tokens enable global changes
+- Component composition reduces duplication
+- Versioning and deprecation strategies
+
+**4. Developer-Friendly**
+- Clear API contracts
+- Comprehensive documentation
+- Easy to integrate and customize
+
+---
+
+## Design Tokens
+
+Design tokens are the atomic design decisions that define your system's visual language.
+
+### Token Categories
+
+#### 1. Color Tokens
+
+**Primitive Colors** (Raw values):
+```json
+{
+  "color": {
+    "primitive": {
+      "blue": {
+        "50": "#eff6ff",
+        "100": "#dbeafe",
+        "200": "#bfdbfe",
+        "300": "#93c5fd",
+        "400": "#60a5fa",
+        "500": "#3b82f6",
+        "600": "#2563eb",
+        "700": "#1d4ed8",
+        "800": "#1e40af",
+        "900": "#1e3a8a",
+        "950": "#172554"
+      }
+    }
+  }
+}
+```
+
+**Semantic Colors** (Contextual meaning):
+```json
+{
+  "color": {
+    "semantic": {
+      "brand": {
+        "primary": "{color.primitive.blue.600}",
+        "primary-hover": "{color.primitive.blue.700}",
+        "primary-active": "{color.primitive.blue.800}"
+      },
+      "text": {
+        "primary": "{color.primitive.gray.900}",
+        "secondary": "{color.primitive.gray.600}",
+        "tertiary": "{color.primitive.gray.500}",
+        "disabled": "{color.primitive.gray.400}",
+        "inverse": "{color.primitive.white}"
+      },
+      "background": {
+        "primary": "{color.primitive.white}",
+        "secondary": "{color.primitive.gray.50}",
+        "tertiary": "{color.primitive.gray.100}"
+      },
+      "feedback": {
+        "success": "{color.primitive.green.600}",
+        "warning": "{color.primitive.yellow.600}",
+        "error": "{color.primitive.red.600}",
+        "info": "{color.primitive.blue.600}"
+      }
+    }
+  }
+}
+```
+
+**Accessibility**: Ensure color contrast ratios meet WCAG 2.1 Level AA:
+- Normal text: 4.5:1 minimum
+- Large text (18pt+ or 14pt+ bold): 3:1 minimum
+- UI components and graphics: 3:1 minimum
+
+#### 2. Typography Tokens
+
+```json
+{
+  "typography": {
+    "fontFamily": {
+      "sans": "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+      "serif": "'Georgia', 'Times New Roman', serif",
+      "mono": "'Fira Code', 'Courier New', monospace"
+    },
+    "fontSize": {
+      "xs": "0.75rem",     // 12px
+      "sm": "0.875rem",    // 14px
+      "base": "1rem",      // 16px
+      "lg": "1.125rem",    // 18px
+      "xl": "1.25rem",     // 20px
+      "2xl": "1.5rem",     // 24px
+      "3xl": "1.875rem",   // 30px
+      "4xl": "2.25rem",    // 36px
+      "5xl": "3rem"        // 48px
+    },
+    "fontWeight": {
+      "normal": 400,
+      "medium": 500,
+      "semibold": 600,
+      "bold": 700
+    },
+    "lineHeight": {
+      "tight": 1.25,
+      "normal": 1.5,
+      "relaxed": 1.75,
+      "loose": 2
+    },
+    "letterSpacing": {
+      "tight": "-0.025em",
+      "normal": "0",
+      "wide": "0.025em"
+    }
+  }
+}
+```
+
+#### 3. Spacing Tokens
+
+**Scale**: Use a consistent spacing scale (commonly 4px or 8px base)
+
+```json
+{
+  "spacing": {
+    "0": "0",
+    "1": "0.25rem",   // 4px
+    "2": "0.5rem",    // 8px
+    "3": "0.75rem",   // 12px
+    "4": "1rem",      // 16px
+    "5": "1.25rem",   // 20px
+    "6": "1.5rem",    // 24px
+    "8": "2rem",      // 32px
+    "10": "2.5rem",   // 40px
+    "12": "3rem",     // 48px
+    "16": "4rem",     // 64px
+    "20": "5rem",     // 80px
+    "24": "6rem"      // 96px
+  }
+}
+```
+
+**Component-Specific Spacing**:
+```json
+{
+  "component": {
+    "button": {
+      "padding-x": "{spacing.4}",
+      "padding-y": "{spacing.2}",
+      "gap": "{spacing.2}"
+    },
+    "card": {
+      "padding": "{spacing.6}",
+      "gap": "{spacing.4}"
+    }
+  }
+}
+```
+
+#### 4. Border Radius Tokens
+
+```json
+{
+  "borderRadius": {
+    "none": "0",
+    "sm": "0.125rem",   // 2px
+    "base": "0.25rem",  // 4px
+    "md": "0.375rem",   // 6px
+    "lg": "0.5rem",     // 8px
+    "xl": "0.75rem",    // 12px
+    "2xl": "1rem",      // 16px
+    "full": "9999px"
+  }
+}
+```
+
+#### 5. Shadow Tokens
+
+```json
+{
+  "shadow": {
+    "xs": "0 1px 2px 0 rgba(0, 0, 0, 0.05)",
+    "sm": "0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1)",
+    "base": "0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1)",
+    "md": "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)",
+    "lg": "0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1)",
+    "xl": "0 25px 50px -12px rgba(0, 0, 0, 0.25)"
+  }
+}
+```
+
+---
+
+## Component Architecture
+
+### Atomic Design Methodology
+
+**Atoms** → **Molecules** → **Organisms** → **Templates** → **Pages**
+
+#### Atoms (Primitive Components)
+Basic building blocks that can't be broken down further.
+
+**Examples:**
+- Button
+- Input
+- Label
+- Icon
+- Badge
+- Avatar
+
+**Button Component:**
+```typescript
+interface ButtonProps {
+  variant?: 'primary' | 'secondary' | 'outline' | 'ghost';
+  size?: 'sm' | 'md' | 'lg';
+  disabled?: boolean;
+  loading?: boolean;
+  icon?: React.ReactNode;
+  children: React.ReactNode;
+}
+```
+
+See `references/component-examples.md` for complete Button implementation with variants, sizes, and styling patterns.
+
+#### Molecules (Simple Compositions)
+Groups of atoms that function together.
+
+**Examples:**
+- SearchBar (Input + Button)
+- FormField (Label + Input + ErrorMessage)
+- Card (Container + Title + Content + Actions)
+
+**FormField Molecule:**
+```typescript
+interface FormFieldProps {
+  label: string;
+  name: string;
+  error?: string;
+  hint?: string;
+  required?: boolean;
+  children: React.ReactNode;
+}
+```
+
+See `references/component-examples.md` for FormField, Card (compound component pattern), Input with variants, Modal, and more composition examples.
+
+#### Organisms (Complex Compositions)
+Complex UI components made of molecules and atoms.
+
+**Examples:**
+- Navigation Bar
+- Product Card Grid
+- User Profile Section
+- Modal Dialog
+
+#### Templates (Page Layouts)
+Page-level structures that define content placement.
+
+**Examples:**
+- Dashboard Layout (Sidebar + Header + Main Content)
+- Marketing Page Layout (Hero + Features + Footer)
+- Settings Page Layout (Tabs + Content Panels)
+
+#### Pages (Specific Instances)
+Actual pages with real content.
+
+---
+
+## Component API Design
+
+### Props Best Practices
+
+**1. Predictable Prop Names**
+```typescript
+// ✅ Good: Consistent naming
+<Button variant="primary" size="md" />
+<Input variant="outlined" size="md" />
+
+// ❌ Bad: Inconsistent
+<Button type="primary" sizeMode="md" />
+<Input style="outlined" inputSize="md" />
+```
+
+**2. Sensible Defaults**
+```typescript
+// ✅ Good: Provides defaults
+interface ButtonProps {
+  variant?: 'primary' | 'secondary';  // Default: primary
+  size?: 'sm' | 'md' | 'lg';          // Default: md
+}
+
+// ❌ Bad: Everything required
+interface ButtonProps {
+  variant: 'primary' | 'secondary';
+  size: 'sm' | 'md' | 'lg';
+  color: string;
+  padding: string;
+}
+```
+
+**3. Composition Over Configuration**
+```typescript
+// ✅ Good: Composable
+<Card>
+  <Card.Header>
+    <Card.Title>Title</Card.Title>
+  </Card.Header>
+  <Card.Body>Content</Card.Body>
+  <Card.Footer>Actions</Card.Footer>
+</Card>
+
+// ❌ Bad: Too many props
+<Card
+  title="Title"
+  content="Content"
+  footerContent="Actions"
+  hasHeader={true}
+  hasFooter={true}
+/>
+```
+
+**4. Polymorphic Components**
+Allow components to render as different HTML elements:
+```typescript
+<Button as="a" href="/login">Login</Button>
+<Button as="button" onClick={handleClick}>Click Me</Button>
+```
+
+See `references/component-examples.md` for complete polymorphic component TypeScript patterns.
+
+---
+
+## Theming and Dark Mode
+
+### Theme Structure
+
+```typescript
+interface Theme {
+  colors: {
+    brand: {
+      primary: string;
+      secondary: string;
+    };
+    text: {
+      primary: string;
+      secondary: string;
+    };
+    background: {
+      primary: string;
+      secondary: string;
+    };
+    feedback: {
+      success: string;
+      warning: string;
+      error: string;
+      info: string;
+    };
+  };
+  typography: {
+    fontFamily: {
+      sans: string;
+      mono: string;
+    };
+    fontSize: Record<string, string>;
+  };
+  spacing: Record<string, string>;
+  borderRadius: Record<string, string>;
+  shadow: Record<string, string>;
+}
+```
+
+### Dark Mode Implementation
+
+**Approach 1: CSS Variables**
+```css
+:root {
+  --color-bg-primary: #ffffff;
+  --color-text-primary: #000000;
+}
+
+[data-theme="dark"] {
+  --color-bg-primary: #1a1a1a;
+  --color-text-primary: #ffffff;
+}
+```
+
+**Approach 2: Tailwind CSS Dark Mode**
+```tsx
+<div className="bg-white dark:bg-gray-900 text-gray-900 dark:text-white">
+  Content
+</div>
+```
+
+**Approach 3: Styled Components ThemeProvider**
+```typescript
+const lightTheme = { background: '#fff', text: '#000' };
+const darkTheme = { background: '#000', text: '#fff' };
+
+<ThemeProvider theme={isDark ? darkTheme : lightTheme}>
+  <App />
+</ThemeProvider>
+```
+
+---
+
+## Accessibility Guidelines
+
+### WCAG 2.1 Level AA Compliance
+
+#### Color Contrast
+- **Normal text** (< 18pt): 4.5:1 minimum
+- **Large text** (≥ 18pt or ≥ 14pt bold): 3:1 minimum
+- **UI components**: 3:1 minimum
+
+**Tools**: Use contrast checkers like [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/)
+
+#### Keyboard Navigation
+```typescript
+// ✅ All interactive elements must be keyboard accessible
+<button
+  onClick={handleClick}
+  onKeyDown={(e) => e.key === 'Enter' && handleClick()}
+>
+  Click me
+</button>
+
+// ✅ Focus management
+<Modal>
+  <FocusTrap>
+    {/* Modal content */}
+  </FocusTrap>
+</Modal>
+```
+
+#### ARIA Attributes
+Essential ARIA patterns:
+- `aria-label`: Provide accessible names
+- `aria-expanded`: Communicate expanded/collapsed state
+- `aria-controls`: Associate controls with content
+- `aria-live`: Announce dynamic content changes
+
+#### Screen Reader Support
+- Use semantic HTML elements (`<button>`, `<nav>`, `<main>`)
+- Avoid div/span soup for interactive elements
+- Provide meaningful labels for all controls
+
+See `references/component-examples.md` for complete accessibility examples including Skip Links, focus traps, and ARIA patterns.
+
+---
+
+## Documentation Standards
+
+### Component Documentation Template
+
+Each component should document:
+- **Purpose**: What the component does
+- **Usage**: Import statement and basic example
+- **Variants**: Available visual styles
+- **Props**: Complete prop table with types, defaults, descriptions
+- **Accessibility**: Keyboard support, ARIA attributes, screen reader behavior
+- **Examples**: Common use cases with code
+
+Use Storybook, Docusaurus, or similar tools for interactive documentation.
+
+See `templates/component-template.tsx` for the standard component structure.
+
+---
+
+## Design System Workflow
+
+### 1. Design Phase
+- **Audit existing patterns**: Identify inconsistencies
+- **Define design tokens**: Colors, typography, spacing
+- **Create component inventory**: List all needed components
+- **Design in Figma**: Create component library
+
+### 2. Development Phase
+- **Set up tooling**: Storybook, TypeScript, testing
+- **Implement tokens**: CSS variables or theme config
+- **Build atoms first**: Start with primitives
+- **Compose upward**: Build molecules, organisms
+- **Document as you go**: Write docs alongside code
+
+### 3. Adoption Phase
+- **Create migration guide**: Help teams adopt
+- **Provide codemods**: Automate migrations when possible
+- **Run workshops**: Train teams on usage
+- **Gather feedback**: Iterate based on real usage
+
+### 4. Maintenance Phase
+- **Version semantically**: Major/minor/patch releases
+- **Deprecation strategy**: Phase out old components gracefully
+- **Changelog**: Document all changes
+- **Monitor adoption**: Track usage across products
+
+---
+
+## Quick Start Checklist
+
+When creating a new design system:
+
+- [ ] Define design principles and values
+- [ ] Establish design token structure (colors, typography, spacing)
+- [ ] Create primitive color palette (50-950 scale)
+- [ ] Define semantic color tokens (brand, text, background, feedback)
+- [ ] Set typography scale and font families
+- [ ] Establish spacing scale (4px or 8px base)
+- [ ] Design atomic components (Button, Input, Label, etc.)
+- [ ] Implement theming system (light/dark mode)
+- [ ] Ensure WCAG 2.1 Level AA compliance
+- [ ] Set up documentation (Storybook or similar)
+- [ ] Create usage examples for each component
+- [ ] Establish versioning and release strategy
+- [ ] Create migration guides for adopting teams
diff --git a/.agents/skills/design-system-starter/checklists/design-system-checklist.md b/.agents/skills/design-system-starter/checklists/design-system-checklist.md
new file mode 100644
index 0000000..5927b38
--- /dev/null
+++ b/.agents/skills/design-system-starter/checklists/design-system-checklist.md
@@ -0,0 +1,390 @@
+# Design System Checklist
+
+Use this comprehensive checklist when creating or auditing a design system.
+
+---
+
+## Foundation
+
+### Design Principles
+
+- [ ] **Principles Defined**: Core design principles documented (consistency, accessibility, simplicity, etc.)
+- [ ] **Values Articulated**: Team values reflected in design decisions
+- [ ] **Design Language Documented**: Visual design language explained (tone, personality)
+
+### Design Tokens
+
+#### Color Tokens
+- [ ] **Primitive Colors Defined**: Base color palette (50-950 scale for each hue)
+- [ ] **Semantic Colors Mapped**: Brand, text, background, border, feedback colors
+- [ ] **Color Contrast Validated**: All text meets WCAG 2.1 Level AA (4.5:1 for normal text, 3:1 for large text)
+- [ ] **Dark Mode Colors**: Dark theme variants defined (if applicable)
+- [ ] **Token Naming**: Consistent, semantic naming (text-primary vs gray-900)
+
+#### Typography Tokens
+- [ ] **Font Families Selected**: Primary (sans), secondary (serif), mono fonts
+- [ ] **Type Scale Established**: Font sizes from xs (12px) to 5xl (48px)
+- [ ] **Font Weights Defined**: At least 3 weights (normal, medium, bold)
+- [ ] **Line Heights Set**: Tight (headings), normal (body), relaxed (paragraphs)
+- [ ] **Letter Spacing**: Defined for uppercase and large headings
+
+#### Spacing Tokens
+- [ ] **Spacing Scale Created**: Consistent scale (4px or 8px base)
+- [ ] **Spacing Values**: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24
+- [ ] **Component Spacing**: Specific spacing for components (button padding, card gap)
+
+#### Other Tokens
+- [ ] **Border Radius**: none, sm, base, md, lg, xl, 2xl, full
+- [ ] **Shadows**: xs, sm, base, md, lg, xl
+- [ ] **Transitions**: Duration and easing functions
+- [ ] **Z-Index Scale**: Defined layering system
+
+---
+
+## Components
+
+### Atomic Components (Atoms)
+
+#### Button
+- [ ] **Variants**: Primary, secondary, outline, ghost
+- [ ] **Sizes**: sm, md, lg
+- [ ] **States**: Default, hover, active, focus, disabled, loading
+- [ ] **Icons**: Support for left/right icons
+- [ ] **Full Width**: Option for full-width buttons
+- [ ] **Accessibility**: Keyboard accessible, ARIA attributes
+
+#### Input
+- [ ] **Types**: Text, email, password, number, search
+- [ ] **Sizes**: sm, md, lg
+- [ ] **States**: Default, focus, error, disabled
+- [ ] **Icons**: Support for left/right icons
+- [ ] **Helper Text**: Support for hints and error messages
+- [ ] **Accessibility**: Labels, ARIA descriptions
+
+#### Checkbox & Radio
+- [ ] **Sizes**: sm, md, lg
+- [ ] **States**: Default, checked, indeterminate, disabled
+- [ ] **Labels**: Properly associated labels
+- [ ] **Accessibility**: Keyboard navigation, ARIA states
+
+#### Select / Dropdown
+- [ ] **Single Select**: Basic dropdown
+- [ ] **Multi Select**: Multiple selection support
+- [ ] **Search**: Searchable options (if applicable)
+- [ ] **States**: Default, open, disabled
+- [ ] **Accessibility**: Keyboard navigation, ARIA combobox
+
+#### Badge
+- [ ] **Variants**: Default, success, warning, error, info
+- [ ] **Sizes**: sm, md, lg
+- [ ] **Removable**: Option for dismiss button
+
+#### Avatar
+- [ ] **Sizes**: xs, sm, md, lg, xl
+- [ ] **Fallback**: Initials or default icon
+- [ ] **Status Indicator**: Online/offline dot (if applicable)
+
+#### Icon
+- [ ] **Icon Set**: Consistent icon library (Heroicons, Lucide, etc.)
+- [ ] **Sizes**: 16px, 20px, 24px, 32px
+- [ ] **Accessibility**: ARIA labels or aria-hidden
+
+### Molecular Components (Molecules)
+
+#### Form Field
+- [ ] **Composition**: Label + Input + Helper/Error
+- [ ] **Required Indicator**: Asterisk or (required) text
+- [ ] **Error States**: Validation error display
+- [ ] **Accessibility**: Proper label associations
+
+#### Search Bar
+- [ ] **Composition**: Input + Search button/icon
+- [ ] **Clear Button**: X to clear search
+- [ ] **Keyboard Support**: Enter to submit
+
+#### Card
+- [ ] **Variants**: Default, outlined, elevated
+- [ ] **Composition**: Header, body, footer sections
+- [ ] **Hover State**: If interactive
+- [ ] **Clickable Area**: Full card clickable (if applicable)
+
+#### Alert / Toast
+- [ ] **Variants**: Success, warning, error, info
+- [ ] **Dismissible**: Close button
+- [ ] **Icons**: Contextual icons for each variant
+- [ ] **Actions**: Optional action buttons
+
+### Organism Components
+
+#### Navigation Bar
+- [ ] **Responsive**: Mobile hamburger menu
+- [ ] **Logo**: Branding placement
+- [ ] **Links**: Primary navigation links
+- [ ] **Actions**: Login/signup buttons
+- [ ] **Dropdown**: Nested menu support
+- [ ] **Accessibility**: Keyboard navigation, ARIA navigation
+
+#### Modal / Dialog
+- [ ] **Overlay**: Background overlay
+- [ ] **Close Button**: X button and ESC key
+- [ ] **Focus Trap**: Focus stays within modal
+- [ ] **Sizes**: sm, md, lg, full
+- [ ] **Accessibility**: Focus management, ARIA dialog
+
+#### Table
+- [ ] **Header**: Column headers
+- [ ] **Sortable**: Click to sort columns
+- [ ] **Selectable**: Checkbox selection
+- [ ] **Pagination**: Built-in or separate component
+- [ ] **Responsive**: Mobile-friendly (stacked or scrollable)
+- [ ] **Accessibility**: Proper table semantics
+
+#### Pagination
+- [ ] **Page Numbers**: Current and nearby pages
+- [ ] **Previous/Next**: Arrow navigation
+- [ ] **First/Last**: Jump to first/last page
+- [ ] **Page Size**: Option to change items per page
+
+---
+
+## Patterns
+
+### Layout Patterns
+
+- [ ] **Grid System**: Responsive grid (12-column or flexbox/grid-based)
+- [ ] **Container**: Max-width container for content
+- [ ] **Stack**: Vertical spacing component
+- [ ] **Cluster**: Horizontal spacing component
+- [ ] **Sidebar Layout**: Sidebar + main content
+
+### Form Patterns
+
+- [ ] **Form Validation**: Client-side validation patterns
+- [ ] **Multi-Step Forms**: Wizard/stepper component
+- [ ] **Inline Editing**: Edit-in-place pattern
+- [ ] **Auto-Save**: Periodic save pattern
+
+### Navigation Patterns
+
+- [ ] **Breadcrumbs**: Path navigation
+- [ ] **Tabs**: Tab navigation component
+- [ ] **Sidebar Navigation**: Collapsible sidebar
+- [ ] **Mega Menu**: Large dropdown navigation
+
+### Feedback Patterns
+
+- [ ] **Loading States**: Skeletons, spinners, progress bars
+- [ ] **Empty States**: Illustrations and CTAs for empty data
+- [ ] **Error States**: User-friendly error pages (404, 500)
+- [ ] **Success Confirmation**: Post-action feedback
+
+---
+
+## Accessibility (WCAG 2.1 Level AA)
+
+### Perceivable
+
+- [ ] **Color Contrast**: 4.5:1 for normal text, 3:1 for large text
+- [ ] **Color Independence**: Information not conveyed by color alone
+- [ ] **Text Alternatives**: Alt text for images
+- [ ] **Captions**: Video/audio content has captions (if applicable)
+
+### Operable
+
+- [ ] **Keyboard Navigation**: All interactive elements keyboard accessible
+- [ ] **Focus Indicators**: Visible focus states (outline, ring)
+- [ ] **No Keyboard Traps**: Users can navigate away from all elements
+- [ ] **Skip Links**: "Skip to main content" link
+- [ ] **Touch Targets**: Minimum 44x44px for mobile
+
+### Understandable
+
+- [ ] **Language Attribute**: `<html lang="en">`
+- [ ] **Labels**: Form inputs have labels
+- [ ] **Error Messages**: Clear, specific error messages
+- [ ] **Consistent Navigation**: Navigation is consistent across pages
+
+### Robust
+
+- [ ] **Valid HTML**: Markup validates
+- [ ] **ARIA Attributes**: Proper ARIA labels, roles, states
+- [ ] **Name, Role, Value**: Interactive elements have accessible name
+
+---
+
+## Documentation
+
+### Component Documentation
+
+- [ ] **Usage Examples**: Code examples for each component
+- [ ] **Props API**: Table of props with types and defaults
+- [ ] **Variants**: Visual examples of all variants
+- [ ] **States**: Examples of all interactive states
+- [ ] **Accessibility Notes**: Keyboard shortcuts, ARIA attributes
+- [ ] **Do's and Don'ts**: Usage guidelines with examples
+
+### Design Guidelines
+
+- [ ] **When to Use**: Guidance on component selection
+- [ ] **Composition**: How to combine components
+- [ ] **Content Guidelines**: Copywriting standards
+- [ ] **Spacing Guidelines**: How to apply spacing tokens
+- [ ] **Responsive Patterns**: Mobile-first approach
+
+### Getting Started
+
+- [ ] **Installation**: How to install the design system
+- [ ] **Setup**: Configuration instructions
+- [ ] **Theming**: How to customize tokens
+- [ ] **Migration Guide**: Upgrading from previous versions
+
+---
+
+## Tooling & Infrastructure
+
+### Development Tools
+
+- [ ] **Component Library**: React/Vue/Angular/Web Components
+- [ ] **Storybook**: Component playground and documentation
+- [ ] **TypeScript**: Type definitions for all components
+- [ ] **Testing**: Unit and visual regression tests
+- [ ] **Linting**: ESLint/Stylelint configured
+
+### Build & Distribution
+
+- [ ] **Package Manager**: NPM/Yarn package published
+- [ ] **Versioning**: Semantic versioning (major.minor.patch)
+- [ ] **Changelog**: All changes documented
+- [ ] **Tree-Shaking**: Components importable individually
+- [ ] **Bundle Size**: Optimized for performance
+
+### Design Tools
+
+- [ ] **Figma Library**: Component library in Figma
+- [ ] **Design Tokens**: Tokens exported to Figma (Style Dictionary, Figma Tokens)
+- [ ] **Shared Styles**: Colors, text styles, effects synced
+- [ ] **Component Variants**: All variants available in Figma
+
+---
+
+## Theming & Customization
+
+### Theme Support
+
+- [ ] **Light Theme**: Default light mode
+- [ ] **Dark Theme**: Dark mode variant
+- [ ] **Theme Toggle**: Mechanism to switch themes
+- [ ] **System Preference**: Respect OS theme preference
+- [ ] **Persistent Choice**: Remember user's theme choice
+
+### Customization
+
+- [ ] **Token Override**: Ability to override design tokens
+- [ ] **CSS Variables**: Tokens exposed as CSS variables
+- [ ] **Theme API**: Programmatic theme customization
+- [ ] **Brand Variants**: Support for multiple brands (if applicable)
+
+---
+
+## Quality Assurance
+
+### Visual Testing
+
+- [ ] **Visual Regression Tests**: Chromatic, Percy, or similar
+- [ ] **Cross-Browser Testing**: Chrome, Firefox, Safari, Edge
+- [ ] **Responsive Testing**: Mobile, tablet, desktop viewports
+- [ ] **Dark Mode Testing**: All components in dark mode
+
+### Functional Testing
+
+- [ ] **Unit Tests**: Component logic tested
+- [ ] **Integration Tests**: Component interactions tested
+- [ ] **Accessibility Tests**: Automated a11y tests (axe, WAVE)
+
+### Performance
+
+- [ ] **Bundle Size**: < 100KB gzipped for core components
+- [ ] **Lazy Loading**: Heavy components lazy-loaded
+- [ ] **Tree-Shaking**: Unused components not included
+
+---
+
+## Governance
+
+### Contribution Guidelines
+
+- [ ] **CONTRIBUTING.md**: How to contribute
+- [ ] **Code of Conduct**: Community standards
+- [ ] **PR Template**: Standard pull request format
+- [ ] **Review Process**: How contributions are reviewed
+
+### Versioning & Deprecation
+
+- [ ] **Semantic Versioning**: Follow SemVer
+- [ ] **Deprecation Policy**: How long deprecated components are supported
+- [ ] **Migration Guides**: Help for breaking changes
+- [ ] **Release Notes**: What changed in each version
+
+### Roadmap
+
+- [ ] **Public Roadmap**: Future plans visible
+- [ ] **Feedback Channel**: Users can request features
+- [ ] **Regular Releases**: Predictable release schedule
+
+---
+
+## Adoption & Maintenance
+
+### Onboarding
+
+- [ ] **Getting Started Guide**: Quick start documentation
+- [ ] **Tutorial**: Step-by-step walkthrough
+- [ ] **Video Demos**: Recorded demos (optional)
+- [ ] **Support Channel**: Slack, Discord, or forum
+
+### Metrics
+
+- [ ] **Adoption Tracking**: Monitor usage across products
+- [ ] **Component Usage**: Which components are most used
+- [ ] **Issue Tracking**: Bug reports and feature requests
+- [ ] **Performance Metrics**: Bundle size, load times
+
+### Iteration
+
+- [ ] **Quarterly Reviews**: Regular design system audits
+- [ ] **User Research**: Gather feedback from users
+- [ ] **Component Deprecation**: Remove unused components
+- [ ] **Design Updates**: Refresh styles periodically
+
+---
+
+## Pre-Launch Checklist
+
+Before publishing v1.0:
+
+- [ ] **All Atoms Complete**: Button, Input, Checkbox, Radio, Select, Badge, Avatar, Icon
+- [ ] **Key Molecules Complete**: FormField, Card, Alert, SearchBar
+- [ ] **Core Organisms Complete**: Modal, Navigation, Table, Pagination
+- [ ] **Design Tokens Finalized**: Colors, typography, spacing locked
+- [ ] **Accessibility Audit**: WCAG 2.1 Level AA compliance verified
+- [ ] **Documentation Complete**: All components documented
+- [ ] **Tests Passing**: 100% test pass rate
+- [ ] **Figma Library Published**: Design library available
+- [ ] **NPM Package Published**: Package available on NPM
+- [ ] **Migration Guide**: From previous system or custom components
+
+---
+
+## Post-Launch
+
+- [ ] **Announce Launch**: Internal announcement and blog post
+- [ ] **Training Sessions**: Workshops for teams
+- [ ] **Office Hours**: Regular Q&A sessions
+- [ ] **Gather Feedback**: Collect early adopter feedback
+- [ ] **Iterate Quickly**: Address issues in patch releases
+
+---
+
+**Checklist Version**: 1.0.0
+**Skill**: design-system-starter v1.0.0
+**Last Updated**: 2025-10-31
diff --git a/.agents/skills/design-system-starter/references/component-examples.md b/.agents/skills/design-system-starter/references/component-examples.md
new file mode 100644
index 0000000..44f7297
--- /dev/null
+++ b/.agents/skills/design-system-starter/references/component-examples.md
@@ -0,0 +1,578 @@
+# Design System Component Examples
+
+Detailed implementation examples for common design system components.
+
+## Button Component (Complete Implementation)
+
+```typescript
+/**
+ * Button Component - Primary interactive element
+ */
+
+import React from 'react';
+import { cn } from '../utils/cn';
+
+export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost';
+export type ButtonSize = 'sm' | 'md' | 'lg';
+
+export interface ButtonProps {
+  variant?: ButtonVariant;
+  size?: ButtonSize;
+  disabled?: boolean;
+  loading?: boolean;
+  icon?: React.ReactNode;
+  children: React.ReactNode;
+  onClick?: () => void;
+}
+
+const buttonStyles = {
+  base: 'inline-flex items-center justify-center font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',
+
+  variants: {
+    primary: 'bg-blue-600 text-white hover:bg-blue-700 focus-visible:ring-blue-500',
+    secondary: 'bg-gray-600 text-white hover:bg-gray-700 focus-visible:ring-gray-500',
+    outline: 'border border-gray-300 bg-transparent hover:bg-gray-100 focus-visible:ring-gray-500',
+    ghost: 'hover:bg-gray-100 focus-visible:ring-gray-500',
+  },
+
+  sizes: {
+    sm: 'h-8 px-3 text-sm rounded-md',
+    md: 'h-10 px-4 text-base rounded-md',
+    lg: 'h-12 px-6 text-lg rounded-lg',
+  },
+};
+
+export function Button({
+  variant = 'primary',
+  size = 'md',
+  disabled = false,
+  loading = false,
+  icon,
+  children,
+  onClick
+}: ButtonProps) {
+  return (
+    <button
+      className={cn(
+        buttonStyles.base,
+        buttonStyles.variants[variant],
+        buttonStyles.sizes[size],
+        { 'pointer-events-none opacity-50': loading }
+      )}
+      disabled={disabled || loading}
+      onClick={onClick}
+      aria-busy={loading}
+    >
+      {icon && <span className="mr-2">{icon}</span>}
+      <span>{children}</span>
+      {loading && <span className="ml-2 animate-spin">⏳</span>}
+    </button>
+  );
+}
+```
+
+## Form Field Component (Molecule)
+
+```typescript
+/**
+ * FormField - Composition of Label + Input + Helper/Error
+ */
+
+interface FormFieldProps {
+  label: string;
+  name: string;
+  error?: string;
+  hint?: string;
+  required?: boolean;
+  children: React.ReactNode;
+}
+
+export function FormField({
+  label,
+  name,
+  error,
+  hint,
+  required,
+  children
+}: FormFieldProps) {
+  return (
+    <div className="form-field space-y-2">
+      <label
+        htmlFor={name}
+        className="block text-sm font-medium text-gray-700"
+      >
+        {label}
+        {required && <span className="text-red-500 ml-1">*</span>}
+      </label>
+
+      {children}
+
+      {hint && !error && (
+        <p className="text-sm text-gray-500">{hint}</p>
+      )}
+
+      {error && (
+        <p className="text-sm text-red-600" role="alert">
+          {error}
+        </p>
+      )}
+    </div>
+  );
+}
+```
+
+## Card Component (Compound Component Pattern)
+
+```typescript
+/**
+ * Card - Composable container component
+ */
+
+interface CardProps {
+  variant?: 'default' | 'outlined' | 'elevated';
+  children: React.ReactNode;
+  className?: string;
+}
+
+const cardStyles = {
+  default: 'bg-white border border-gray-200',
+  outlined: 'bg-white border-2 border-gray-300',
+  elevated: 'bg-white shadow-lg',
+};
+
+export function Card({
+  variant = 'default',
+  children,
+  className
+}: CardProps) {
+  return (
+    <div
+      className={cn(
+        'rounded-lg p-6',
+        cardStyles[variant],
+        className
+      )}
+    >
+      {children}
+    </div>
+  );
+}
+
+// Compound components
+Card.Header = function CardHeader({ children }: { children: React.ReactNode }) {
+  return <div className="mb-4 border-b border-gray-200 pb-4">{children}</div>;
+};
+
+Card.Title = function CardTitle({ children }: { children: React.ReactNode }) {
+  return <h3 className="text-lg font-semibold text-gray-900">{children}</h3>;
+};
+
+Card.Body = function CardBody({ children }: { children: React.ReactNode }) {
+  return <div className="space-y-4">{children}</div>;
+};
+
+Card.Footer = function CardFooter({ children }: { children: React.ReactNode }) {
+  return <div className="mt-4 pt-4 border-t border-gray-200">{children}</div>;
+};
+
+// Usage Example:
+/*
+<Card variant="elevated">
+  <Card.Header>
+    <Card.Title>User Profile</Card.Title>
+  </Card.Header>
+  <Card.Body>
+    <p>Profile content goes here</p>
+  </Card.Body>
+  <Card.Footer>
+    <Button>Edit Profile</Button>
+  </Card.Footer>
+</Card>
+*/
+```
+
+## Input Component with Variants
+
+```typescript
+/**
+ * Input - Text input with validation states
+ */
+
+interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+  variant?: 'default' | 'error' | 'success';
+  leftIcon?: React.ReactNode;
+  rightIcon?: React.ReactNode;
+}
+
+const inputStyles = {
+  base: 'w-full rounded-md px-3 py-2 text-sm border transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2',
+
+  variants: {
+    default: 'border-gray-300 focus:border-blue-500 focus:ring-blue-500',
+    error: 'border-red-500 focus:border-red-500 focus:ring-red-500',
+    success: 'border-green-500 focus:border-green-500 focus:ring-green-500',
+  },
+};
+
+export function Input({
+  variant = 'default',
+  leftIcon,
+  rightIcon,
+  className,
+  ...props
+}: InputProps) {
+  return (
+    <div className="relative">
+      {leftIcon && (
+        <div className="absolute left-3 top-1/2 -translate-y-1/2 text-gray-400">
+          {leftIcon}
+        </div>
+      )}
+
+      <input
+        className={cn(
+          inputStyles.base,
+          inputStyles.variants[variant],
+          { 'pl-10': leftIcon },
+          { 'pr-10': rightIcon },
+          className
+        )}
+        {...props}
+      />
+
+      {rightIcon && (
+        <div className="absolute right-3 top-1/2 -translate-y-1/2 text-gray-400">
+          {rightIcon}
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+## Modal Component (Organism)
+
+```typescript
+/**
+ * Modal - Dialog with focus trap and overlay
+ */
+
+import { useEffect, useRef } from 'react';
+
+interface ModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  title: string;
+  children: React.ReactNode;
+  size?: 'sm' | 'md' | 'lg' | 'full';
+}
+
+const modalSizes = {
+  sm: 'max-w-md',
+  md: 'max-w-lg',
+  lg: 'max-w-2xl',
+  full: 'max-w-full',
+};
+
+export function Modal({
+  isOpen,
+  onClose,
+  title,
+  children,
+  size = 'md'
+}: ModalProps) {
+  const modalRef = useRef<HTMLDivElement>(null);
+
+  // Focus trap
+  useEffect(() => {
+    if (isOpen) {
+      modalRef.current?.focus();
+    }
+  }, [isOpen]);
+
+  // ESC key handler
+  useEffect(() => {
+    const handleEsc = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') onClose();
+    };
+
+    if (isOpen) {
+      document.addEventListener('keydown', handleEsc);
+      document.body.style.overflow = 'hidden'; // Prevent background scroll
+    }
+
+    return () => {
+      document.removeEventListener('keydown', handleEsc);
+      document.body.style.overflow = '';
+    };
+  }, [isOpen, onClose]);
+
+  if (!isOpen) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center"
+      role="dialog"
+      aria-modal="true"
+      aria-labelledby="modal-title"
+    >
+      {/* Overlay */}
+      <div
+        className="absolute inset-0 bg-black bg-opacity-50"
+        onClick={onClose}
+      />
+
+      {/* Modal */}
+      <div
+        ref={modalRef}
+        className={cn(
+          'relative bg-white rounded-lg shadow-xl w-full mx-4',
+          modalSizes[size]
+        )}
+        tabIndex={-1}
+      >
+        {/* Header */}
+        <div className="flex items-center justify-between px-6 py-4 border-b">
+          <h2 id="modal-title" className="text-xl font-semibold">
+            {title}
+          </h2>
+          <button
+            onClick={onClose}
+            className="text-gray-400 hover:text-gray-600"
+            aria-label="Close"
+          >
+            ✕
+          </button>
+        </div>
+
+        {/* Body */}
+        <div className="px-6 py-4">
+          {children}
+        </div>
+      </div>
+    </div>
+  );
+}
+```
+
+## Polymorphic Component Example
+
+```typescript
+/**
+ * Polymorphic Button - Can render as button, link, etc.
+ */
+
+type AsProp<C extends React.ElementType> = {
+  as?: C;
+};
+
+type PropsToOmit<C extends React.ElementType, P> = keyof (AsProp<C> & P);
+
+type PolymorphicComponentProp<
+  C extends React.ElementType,
+  Props = {}
+> = React.PropsWithChildren<Props & AsProp<C>> &
+  Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
+
+type PolymorphicRef<C extends React.ElementType> =
+  React.ComponentPropsWithRef<C>['ref'];
+
+type PolymorphicComponentPropWithRef<
+  C extends React.ElementType,
+  Props = {}
+> = PolymorphicComponentProp<C, Props> & { ref?: PolymorphicRef<C> };
+
+interface ButtonBaseProps {
+  variant?: 'primary' | 'secondary';
+}
+
+export type ButtonProps<C extends React.ElementType = 'button'> =
+  PolymorphicComponentPropWithRef<C, ButtonBaseProps>;
+
+export const PolymorphicButton = <C extends React.ElementType = 'button'>({
+  as,
+  variant = 'primary',
+  children,
+  ...props
+}: ButtonProps<C>) => {
+  const Component = as || 'button';
+
+  return (
+    <Component
+      className={cn('px-4 py-2 rounded', {
+        'bg-blue-600 text-white': variant === 'primary',
+        'bg-gray-600 text-white': variant === 'secondary',
+      })}
+      {...props}
+    >
+      {children}
+    </Component>
+  );
+};
+
+// Usage:
+// <PolymorphicButton>Button</PolymorphicButton>
+// <PolymorphicButton as="a" href="/login">Link</PolymorphicButton>
+```
+
+## Accessibility Example - Skip Link
+
+```typescript
+/**
+ * Skip Link - Keyboard accessibility helper
+ */
+
+export function SkipLink() {
+  return (
+    <a
+      href="#main-content"
+      className="sr-only focus:not-sr-only focus:absolute focus:top-4 focus:left-4 focus:z-50 focus:px-4 focus:py-2 focus:bg-blue-600 focus:text-white focus:rounded"
+    >
+      Skip to main content
+    </a>
+  );
+}
+
+// CSS for sr-only (screen reader only):
+/*
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border-width: 0;
+}
+
+.focus\:not-sr-only:focus {
+  position: static;
+  width: auto;
+  height: auto;
+  padding: revert;
+  margin: revert;
+  overflow: visible;
+  clip: auto;
+  white-space: normal;
+}
+*/
+```
+
+## Theme Switching Example
+
+```typescript
+/**
+ * Theme Toggle - Dark mode switcher
+ */
+
+import { useEffect, useState } from 'react';
+
+export function ThemeToggle() {
+  const [theme, setTheme] = useState<'light' | 'dark'>('light');
+
+  useEffect(() => {
+    // Check system preference on mount
+    const isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+    const savedTheme = localStorage.getItem('theme') as 'light' | 'dark' || (isDark ? 'dark' : 'light');
+    setTheme(savedTheme);
+    document.documentElement.setAttribute('data-theme', savedTheme);
+  }, []);
+
+  const toggleTheme = () => {
+    const newTheme = theme === 'light' ? 'dark' : 'light';
+    setTheme(newTheme);
+    document.documentElement.setAttribute('data-theme', newTheme);
+    localStorage.setItem('theme', newTheme);
+  };
+
+  return (
+    <button
+      onClick={toggleTheme}
+      aria-label={`Switch to ${theme === 'light' ? 'dark' : 'light'} mode`}
+      className="p-2 rounded-md hover:bg-gray-100 dark:hover:bg-gray-800"
+    >
+      {theme === 'light' ? '🌙' : '☀️'}
+    </button>
+  );
+}
+```
+
+## Responsive Navigation Example
+
+```typescript
+/**
+ * Navigation Bar - Responsive with mobile menu
+ */
+
+import { useState } from 'react';
+
+export function Navigation() {
+  const [mobileMenuOpen, setMobileMenuOpen] = useState(false);
+
+  return (
+    <nav className="bg-white border-b border-gray-200" aria-label="Main navigation">
+      <div className="container mx-auto px-4">
+        <div className="flex items-center justify-between h-16">
+          {/* Logo */}
+          <div className="flex-shrink-0">
+            <a href="/" className="text-xl font-bold">
+              Logo
+            </a>
+          </div>
+
+          {/* Desktop Navigation */}
+          <div className="hidden md:flex space-x-8">
+            <a href="/features" className="text-gray-700 hover:text-gray-900">
+              Features
+            </a>
+            <a href="/pricing" className="text-gray-700 hover:text-gray-900">
+              Pricing
+            </a>
+            <a href="/about" className="text-gray-700 hover:text-gray-900">
+              About
+            </a>
+          </div>
+
+          {/* Mobile Menu Button */}
+          <button
+            className="md:hidden p-2"
+            onClick={() => setMobileMenuOpen(!mobileMenuOpen)}
+            aria-label="Toggle mobile menu"
+            aria-expanded={mobileMenuOpen}
+          >
+            <span className="block w-6 h-0.5 bg-gray-900 mb-1"></span>
+            <span className="block w-6 h-0.5 bg-gray-900 mb-1"></span>
+            <span className="block w-6 h-0.5 bg-gray-900"></span>
+          </button>
+        </div>
+
+        {/* Mobile Menu */}
+        {mobileMenuOpen && (
+          <div className="md:hidden py-4">
+            <a
+              href="/features"
+              className="block py-2 text-gray-700 hover:bg-gray-100"
+            >
+              Features
+            </a>
+            <a
+              href="/pricing"
+              className="block py-2 text-gray-700 hover:bg-gray-100"
+            >
+              Pricing
+            </a>
+            <a
+              href="/about"
+              className="block py-2 text-gray-700 hover:bg-gray-100"
+            >
+              About
+            </a>
+          </div>
+        )}
+      </div>
+    </nav>
+  );
+}
+```
diff --git a/.agents/skills/design-system-starter/templates/component-template.tsx b/.agents/skills/design-system-starter/templates/component-template.tsx
new file mode 100644
index 0000000..f4f6aa5
--- /dev/null
+++ b/.agents/skills/design-system-starter/templates/component-template.tsx
@@ -0,0 +1,252 @@
+/**
+ * Component Name
+ *
+ * Brief description of what this component does and when to use it.
+ *
+ * @example
+ * ```tsx
+ * <ComponentName variant="primary" size="md">
+ *   Content
+ * </ComponentName>
+ * ```
+ */
+
+import React from 'react';
+import { cn } from '../utils/cn'; // Utility for className merging
+
+// ============================================================================
+// Types & Interfaces
+// ============================================================================
+
+/**
+ * Variants define the visual style of the component
+ */
+export type ComponentVariant = 'primary' | 'secondary' | 'outline' | 'ghost';
+
+/**
+ * Sizes define the dimensions of the component
+ */
+export type ComponentSize = 'sm' | 'md' | 'lg';
+
+/**
+ * Props for the Component
+ */
+export interface ComponentProps {
+  /**
+   * Visual variant of the component
+   * @default 'primary'
+   */
+  variant?: ComponentVariant;
+
+  /**
+   * Size of the component
+   * @default 'md'
+   */
+  size?: ComponentSize;
+
+  /**
+   * Whether the component is disabled
+   * @default false
+   */
+  disabled?: boolean;
+
+  /**
+   * Additional CSS classes to apply
+   */
+  className?: string;
+
+  /**
+   * Content to be rendered inside the component
+   */
+  children: React.ReactNode;
+
+  /**
+   * Optional click handler
+   */
+  onClick?: (event: React.MouseEvent<HTMLElement>) => void;
+
+  /**
+   * ARIA label for accessibility
+   */
+  'aria-label'?: string;
+}
+
+// ============================================================================
+// Component Styles (if using CSS-in-JS or className-based styling)
+// ============================================================================
+
+const componentStyles = {
+  base: 'inline-flex items-center justify-center font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',
+
+  variants: {
+    primary: 'bg-blue-600 text-white hover:bg-blue-700 focus-visible:ring-blue-500',
+    secondary: 'bg-gray-600 text-white hover:bg-gray-700 focus-visible:ring-gray-500',
+    outline: 'border border-gray-300 bg-transparent hover:bg-gray-100 focus-visible:ring-gray-500',
+    ghost: 'hover:bg-gray-100 focus-visible:ring-gray-500',
+  },
+
+  sizes: {
+    sm: 'h-8 px-3 text-sm rounded-md',
+    md: 'h-10 px-4 text-base rounded-md',
+    lg: 'h-12 px-6 text-lg rounded-lg',
+  },
+};
+
+// ============================================================================
+// Component Implementation
+// ============================================================================
+
+export const Component = React.forwardRef<HTMLDivElement, ComponentProps>(
+  (
+    {
+      variant = 'primary',
+      size = 'md',
+      disabled = false,
+      className,
+      children,
+      onClick,
+      'aria-label': ariaLabel,
+    },
+    ref
+  ) => {
+    // =========================================================================
+    // State & Hooks
+    // =========================================================================
+
+    // Example: Track internal state if needed
+    // const [isActive, setIsActive] = React.useState(false);
+
+    // =========================================================================
+    // Event Handlers
+    // =========================================================================
+
+    const handleClick = (event: React.MouseEvent<HTMLDivElement>) => {
+      if (disabled) return;
+      onClick?.(event);
+    };
+
+    const handleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
+      // Handle Enter and Space for keyboard accessibility
+      if (disabled) return;
+      if (event.key === 'Enter' || event.key === ' ') {
+        event.preventDefault();
+        onClick?.(event as any);
+      }
+    };
+
+    // =========================================================================
+    // Render
+    // =========================================================================
+
+    return (
+      <div
+        ref={ref}
+        className={cn(
+          componentStyles.base,
+          componentStyles.variants[variant],
+          componentStyles.sizes[size],
+          className
+        )}
+        onClick={handleClick}
+        onKeyDown={handleKeyDown}
+        role="button"
+        tabIndex={disabled ? -1 : 0}
+        aria-disabled={disabled}
+        aria-label={ariaLabel}
+      >
+        {children}
+      </div>
+    );
+  }
+);
+
+Component.displayName = 'Component';
+
+// ============================================================================
+// Compound Components (if applicable)
+// ============================================================================
+
+/**
+ * Example of a compound component pattern
+ */
+export const ComponentHeader = ({ children }: { children: React.ReactNode }) => {
+  return <div className="component-header">{children}</div>;
+};
+
+/**
+ * Compound component for body content
+ */
+export const ComponentBody = ({ children }: { children: React.ReactNode }) => {
+  return <div className="component-body">{children}</div>;
+};
+
+// Attach compound components
+Component.Header = ComponentHeader;
+Component.Body = ComponentBody;
+
+// ============================================================================
+// Usage Examples (for documentation/Storybook)
+// ============================================================================
+
+/**
+ * Example 1: Basic usage
+ */
+export const BasicExample = () => (
+  <Component variant="primary" size="md">
+    Click me
+  </Component>
+);
+
+/**
+ * Example 2: With different variants
+ */
+export const VariantsExample = () => (
+  <div className="flex gap-4">
+    <Component variant="primary">Primary</Component>
+    <Component variant="secondary">Secondary</Component>
+    <Component variant="outline">Outline</Component>
+    <Component variant="ghost">Ghost</Component>
+  </div>
+);
+
+/**
+ * Example 3: With different sizes
+ */
+export const SizesExample = () => (
+  <div className="flex items-center gap-4">
+    <Component variant="primary" size="sm">
+      Small
+    </Component>
+    <Component variant="primary" size="md">
+      Medium
+    </Component>
+    <Component variant="primary" size="lg">
+      Large
+    </Component>
+  </div>
+);
+
+/**
+ * Example 4: Disabled state
+ */
+export const DisabledExample = () => (
+  <Component variant="primary" disabled>
+    Disabled
+  </Component>
+);
+
+/**
+ * Example 5: Compound component usage
+ */
+export const CompoundExample = () => (
+  <Component variant="primary">
+    <Component.Header>Header</Component.Header>
+    <Component.Body>Body content</Component.Body>
+  </Component>
+);
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+export default Component;
diff --git a/.agents/skills/design-system-starter/templates/design-tokens-template.json b/.agents/skills/design-system-starter/templates/design-tokens-template.json
new file mode 100644
index 0000000..55631a1
--- /dev/null
+++ b/.agents/skills/design-system-starter/templates/design-tokens-template.json
@@ -0,0 +1,735 @@
+{
+  "$schema": "https://design-tokens.org/schemas/v1.0.0/design-tokens.schema.json",
+  "name": "YourCompany Design Tokens",
+  "version": "1.0.0",
+  "color": {
+    "primitive": {
+      "white": {
+        "$type": "color",
+        "$value": "#ffffff"
+      },
+      "black": {
+        "$type": "color",
+        "$value": "#000000"
+      },
+      "gray": {
+        "50": {
+          "$type": "color",
+          "$value": "#f9fafb"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#f3f4f6"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#e5e7eb"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#d1d5db"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#9ca3af"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#6b7280"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#4b5563"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#374151"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#1f2937"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#111827"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#030712"
+        }
+      },
+      "blue": {
+        "50": {
+          "$type": "color",
+          "$value": "#eff6ff"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#dbeafe"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#bfdbfe"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#93c5fd"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#60a5fa"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#3b82f6"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#2563eb"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#1d4ed8"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#1e40af"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#1e3a8a"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#172554"
+        }
+      },
+      "green": {
+        "50": {
+          "$type": "color",
+          "$value": "#f0fdf4"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#dcfce7"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#bbf7d0"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#86efac"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#4ade80"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#22c55e"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#16a34a"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#15803d"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#166534"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#14532d"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#052e16"
+        }
+      },
+      "red": {
+        "50": {
+          "$type": "color",
+          "$value": "#fef2f2"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#fee2e2"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#fecaca"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#fca5a5"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#f87171"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#ef4444"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#dc2626"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#b91c1c"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#991b1b"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#7f1d1d"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#450a0a"
+        }
+      },
+      "yellow": {
+        "50": {
+          "$type": "color",
+          "$value": "#fefce8"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#fef9c3"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#fef08a"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#fde047"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#facc15"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#eab308"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#ca8a04"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#a16207"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#854d0e"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#713f12"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#422006"
+        }
+      }
+    },
+    "semantic": {
+      "brand": {
+        "primary": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.600}",
+          "$description": "Primary brand color for CTAs and key UI elements"
+        },
+        "primary-hover": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.700}"
+        },
+        "primary-active": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.800}"
+        },
+        "secondary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.600}"
+        },
+        "secondary-hover": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.700}"
+        }
+      },
+      "text": {
+        "primary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.900}",
+          "$description": "Primary text color for body content"
+        },
+        "secondary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.600}",
+          "$description": "Secondary text color for supporting content"
+        },
+        "tertiary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.500}",
+          "$description": "Tertiary text color for hints and metadata"
+        },
+        "disabled": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.400}",
+          "$description": "Text color for disabled elements"
+        },
+        "inverse": {
+          "$type": "color",
+          "$value": "{color.primitive.white}",
+          "$description": "Text color for dark backgrounds"
+        }
+      },
+      "background": {
+        "primary": {
+          "$type": "color",
+          "$value": "{color.primitive.white}",
+          "$description": "Primary background color"
+        },
+        "secondary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.50}",
+          "$description": "Secondary background color for sections"
+        },
+        "tertiary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.100}",
+          "$description": "Tertiary background for less emphasis"
+        }
+      },
+      "border": {
+        "default": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.200}",
+          "$description": "Default border color"
+        },
+        "strong": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.300}",
+          "$description": "Strong border color for emphasis"
+        },
+        "subtle": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.100}",
+          "$description": "Subtle border color for light separation"
+        }
+      },
+      "feedback": {
+        "success": {
+          "$type": "color",
+          "$value": "{color.primitive.green.600}",
+          "$description": "Success state color"
+        },
+        "warning": {
+          "$type": "color",
+          "$value": "{color.primitive.yellow.600}",
+          "$description": "Warning state color"
+        },
+        "error": {
+          "$type": "color",
+          "$value": "{color.primitive.red.600}",
+          "$description": "Error state color"
+        },
+        "info": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.600}",
+          "$description": "Info state color"
+        }
+      }
+    }
+  },
+  "typography": {
+    "fontFamily": {
+      "sans": {
+        "$type": "fontFamily",
+        "$value": "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif",
+        "$description": "Sans-serif font family for UI text"
+      },
+      "serif": {
+        "$type": "fontFamily",
+        "$value": "'Georgia', 'Times New Roman', serif",
+        "$description": "Serif font family for editorial content"
+      },
+      "mono": {
+        "$type": "fontFamily",
+        "$value": "'Fira Code', 'Consolas', 'Courier New', monospace",
+        "$description": "Monospace font family for code"
+      }
+    },
+    "fontSize": {
+      "xs": {
+        "$type": "dimension",
+        "$value": "0.75rem",
+        "$description": "12px - Extra small text"
+      },
+      "sm": {
+        "$type": "dimension",
+        "$value": "0.875rem",
+        "$description": "14px - Small text"
+      },
+      "base": {
+        "$type": "dimension",
+        "$value": "1rem",
+        "$description": "16px - Base body text"
+      },
+      "lg": {
+        "$type": "dimension",
+        "$value": "1.125rem",
+        "$description": "18px - Large text"
+      },
+      "xl": {
+        "$type": "dimension",
+        "$value": "1.25rem",
+        "$description": "20px - Extra large text"
+      },
+      "2xl": {
+        "$type": "dimension",
+        "$value": "1.5rem",
+        "$description": "24px - Heading 4"
+      },
+      "3xl": {
+        "$type": "dimension",
+        "$value": "1.875rem",
+        "$description": "30px - Heading 3"
+      },
+      "4xl": {
+        "$type": "dimension",
+        "$value": "2.25rem",
+        "$description": "36px - Heading 2"
+      },
+      "5xl": {
+        "$type": "dimension",
+        "$value": "3rem",
+        "$description": "48px - Heading 1"
+      }
+    },
+    "fontWeight": {
+      "normal": {
+        "$type": "fontWeight",
+        "$value": 400,
+        "$description": "Normal font weight"
+      },
+      "medium": {
+        "$type": "fontWeight",
+        "$value": 500,
+        "$description": "Medium font weight"
+      },
+      "semibold": {
+        "$type": "fontWeight",
+        "$value": 600,
+        "$description": "Semibold font weight"
+      },
+      "bold": {
+        "$type": "fontWeight",
+        "$value": 700,
+        "$description": "Bold font weight"
+      }
+    },
+    "lineHeight": {
+      "tight": {
+        "$type": "number",
+        "$value": 1.25,
+        "$description": "Tight line height for headings"
+      },
+      "normal": {
+        "$type": "number",
+        "$value": 1.5,
+        "$description": "Normal line height for body text"
+      },
+      "relaxed": {
+        "$type": "number",
+        "$value": 1.75,
+        "$description": "Relaxed line height for readable paragraphs"
+      },
+      "loose": {
+        "$type": "number",
+        "$value": 2,
+        "$description": "Loose line height for extra whitespace"
+      }
+    },
+    "letterSpacing": {
+      "tight": {
+        "$type": "dimension",
+        "$value": "-0.025em",
+        "$description": "Tight letter spacing for large headings"
+      },
+      "normal": {
+        "$type": "dimension",
+        "$value": "0",
+        "$description": "Normal letter spacing"
+      },
+      "wide": {
+        "$type": "dimension",
+        "$value": "0.025em",
+        "$description": "Wide letter spacing for uppercase text"
+      }
+    }
+  },
+  "spacing": {
+    "0": {
+      "$type": "dimension",
+      "$value": "0"
+    },
+    "1": {
+      "$type": "dimension",
+      "$value": "0.25rem",
+      "$description": "4px"
+    },
+    "2": {
+      "$type": "dimension",
+      "$value": "0.5rem",
+      "$description": "8px"
+    },
+    "3": {
+      "$type": "dimension",
+      "$value": "0.75rem",
+      "$description": "12px"
+    },
+    "4": {
+      "$type": "dimension",
+      "$value": "1rem",
+      "$description": "16px"
+    },
+    "5": {
+      "$type": "dimension",
+      "$value": "1.25rem",
+      "$description": "20px"
+    },
+    "6": {
+      "$type": "dimension",
+      "$value": "1.5rem",
+      "$description": "24px"
+    },
+    "8": {
+      "$type": "dimension",
+      "$value": "2rem",
+      "$description": "32px"
+    },
+    "10": {
+      "$type": "dimension",
+      "$value": "2.5rem",
+      "$description": "40px"
+    },
+    "12": {
+      "$type": "dimension",
+      "$value": "3rem",
+      "$description": "48px"
+    },
+    "16": {
+      "$type": "dimension",
+      "$value": "4rem",
+      "$description": "64px"
+    },
+    "20": {
+      "$type": "dimension",
+      "$value": "5rem",
+      "$description": "80px"
+    },
+    "24": {
+      "$type": "dimension",
+      "$value": "6rem",
+      "$description": "96px"
+    }
+  },
+  "borderRadius": {
+    "none": {
+      "$type": "dimension",
+      "$value": "0"
+    },
+    "sm": {
+      "$type": "dimension",
+      "$value": "0.125rem",
+      "$description": "2px"
+    },
+    "base": {
+      "$type": "dimension",
+      "$value": "0.25rem",
+      "$description": "4px"
+    },
+    "md": {
+      "$type": "dimension",
+      "$value": "0.375rem",
+      "$description": "6px"
+    },
+    "lg": {
+      "$type": "dimension",
+      "$value": "0.5rem",
+      "$description": "8px"
+    },
+    "xl": {
+      "$type": "dimension",
+      "$value": "0.75rem",
+      "$description": "12px"
+    },
+    "2xl": {
+      "$type": "dimension",
+      "$value": "1rem",
+      "$description": "16px"
+    },
+    "full": {
+      "$type": "dimension",
+      "$value": "9999px",
+      "$description": "Fully rounded (pill shape)"
+    }
+  },
+  "shadow": {
+    "xs": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "1px",
+        "blur": "2px",
+        "spread": "0",
+        "color": "rgba(0, 0, 0, 0.05)"
+      }
+    },
+    "sm": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "1px",
+        "blur": "3px",
+        "spread": "0",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "base": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "4px",
+        "blur": "6px",
+        "spread": "-1px",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "md": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "10px",
+        "blur": "15px",
+        "spread": "-3px",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "lg": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "20px",
+        "blur": "25px",
+        "spread": "-5px",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "xl": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "25px",
+        "blur": "50px",
+        "spread": "-12px",
+        "color": "rgba(0, 0, 0, 0.25)"
+      }
+    }
+  },
+  "component": {
+    "button": {
+      "padding": {
+        "sm": {
+          "x": {
+            "$type": "dimension",
+            "$value": "{spacing.3}"
+          },
+          "y": {
+            "$type": "dimension",
+            "$value": "{spacing.1}"
+          }
+        },
+        "md": {
+          "x": {
+            "$type": "dimension",
+            "$value": "{spacing.4}"
+          },
+          "y": {
+            "$type": "dimension",
+            "$value": "{spacing.2}"
+          }
+        },
+        "lg": {
+          "x": {
+            "$type": "dimension",
+            "$value": "{spacing.6}"
+          },
+          "y": {
+            "$type": "dimension",
+            "$value": "{spacing.3}"
+          }
+        }
+      },
+      "borderRadius": {
+        "$type": "dimension",
+        "$value": "{borderRadius.md}"
+      }
+    },
+    "card": {
+      "padding": {
+        "$type": "dimension",
+        "$value": "{spacing.6}"
+      },
+      "borderRadius": {
+        "$type": "dimension",
+        "$value": "{borderRadius.lg}"
+      },
+      "shadow": {
+        "$type": "shadow",
+        "$value": "{shadow.sm}"
+      }
+    },
+    "input": {
+      "padding": {
+        "x": {
+          "$type": "dimension",
+          "$value": "{spacing.3}"
+        },
+        "y": {
+          "$type": "dimension",
+          "$value": "{spacing.2}"
+        }
+      },
+      "borderRadius": {
+        "$type": "dimension",
+        "$value": "{borderRadius.md}"
+      },
+      "border": {
+        "default": {
+          "$type": "color",
+          "$value": "{color.semantic.border.default}"
+        },
+        "focus": {
+          "$type": "color",
+          "$value": "{color.semantic.brand.primary}"
+        },
+        "error": {
+          "$type": "color",
+          "$value": "{color.semantic.feedback.error}"
+        }
+      }
+    }
+  }
+}
diff --git a/.agents/skills/design-to-code/LICENSE.txt b/.agents/skills/design-to-code/LICENSE.txt
new file mode 100644
index 0000000..beef293
--- /dev/null
+++ b/.agents/skills/design-to-code/LICENSE.txt
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/.agents/skills/design-to-code/SKILL.md b/.agents/skills/design-to-code/SKILL.md
new file mode 100644
index 0000000..4ba99d5
--- /dev/null
+++ b/.agents/skills/design-to-code/SKILL.md
@@ -0,0 +1,158 @@
+---
+name: design-to-code
+description: Pixel-perfect Figma to React conversion using coderio. Generates production-ready code (TypeScript, Vite, TailwindCSS V4) with high visual fidelity. Features robust error handling, checkpoint recovery, and streamlined execution via helper script.
+---
+
+# Design to Code
+
+High-fidelity UI restoration from Figma designs to production-ready React + TypeScript components.
+This SKILL uses a **robust helper script** to minimize manual errors and ensure pixel-perfect results.
+
+## Prerequisites
+
+1.  **Figma API Token**: Get from Figma → Settings → Personal Access Tokens
+2.  **Node.js**: Version 18+
+3.  **coderio**: Installed in `scripts/` folder (handled by Setup phase)
+
+## Workflow Overview
+
+```
+Phase 0: SETUP    → Create helper script and script environment
+Phase 1: PROTOCOL → Generate design protocol (Structure & Props)
+Phase 2: CODE     → Generate components and assets
+```
+
+---
+
+# Phase 0: Setup
+
+## Step 0.1: Initialize Helper Script
+
+**User Action**: Run these commands to create the execution helper and isolate its dependencies.
+
+```bash
+mkdir -p scripts
+
+# 1. Copy script files
+# Note: Ensure you have the 'skills/design-to-code/scripts' directory available
+cp skills/design-to-code/scripts/package.json scripts/package.json
+cp skills/design-to-code/scripts/coderio-skill.mjs scripts/coderio-skill.mjs
+
+# 2. Install coderio in scripts directory (adjust version if needed)
+cd scripts && pnpm install && cd ..
+```
+
+## Step 0.2: Scaffold Project (Optional)
+
+If starting a new project:
+
+1.  Run: `node scripts/coderio-skill.mjs scaffold-prompt "MyApp"`
+2.  **AI Task**: Follow the instructions output by the command to create files.
+
+---
+
+# Phase 1: Protocol Generation
+
+## Step 1.1: Fetch Data
+
+```bash
+# Replace with your URL and Token
+node scripts/coderio-skill.mjs fetch-figma "https://figma.com/file/..." "figd_..."
+```
+
+**Verify**: `process/thumbnail.png` should exist.
+
+## Step 1.2: Generate Structure
+
+1.  **Generate Prompt**:
+
+    ```bash
+    node scripts/coderio-skill.mjs structure-prompt > scripts/structure-prompt.md
+    ```
+
+2.  **AI Task (Structure)**:
+    - **ATTACH**: `process/thumbnail.png` (MANDATORY)
+    - **READ**: `scripts/structure-prompt.md`
+    - **INSTRUCTION**: "Generate the component structure JSON based on the prompt and the attached thumbnail. Focus on visual grouping. **Use text content to name components accurately (e.g. 'SafeProducts', not 'FAQ').**"
+    - **SAVE**: Paste the JSON result into `scripts/structure-output.json`.
+
+3.  **Process Result**:
+    ```bash
+    node scripts/coderio-skill.mjs save-structure
+    ```
+
+## Step 1.3: Extract Props (Iterative)
+
+1.  **List Components**:
+
+    ```bash
+    node scripts/coderio-skill.mjs list-components
+    ```
+
+2.  **For EACH component in the list**:
+
+    a. **Generate Prompt**:
+
+    ```bash
+    node scripts/coderio-skill.mjs props-prompt "ComponentName" > scripts/current-props-prompt.md
+    ```
+
+    b. **AI Task (Props)**:
+    - **ATTACH**: `process/thumbnail.png` (MANDATORY)
+    - **READ**: `scripts/current-props-prompt.md`
+    - **INSTRUCTION**: "Extract props and state data. Be pixel-perfect with text and image paths."
+    - **SAVE**: Paste the JSON result into `scripts/ComponentName-props.json`.
+
+    c. **Save & Validate**:
+
+    ```bash
+    node scripts/coderio-skill.mjs save-props "ComponentName"
+    # If this fails, re-do step 'b' with better attention to the thumbnail
+    ```
+
+---
+
+# Phase 2: Code Generation
+
+## Step 2.1: Plan Tasks
+
+```bash
+node scripts/coderio-skill.mjs list-gen-tasks
+```
+
+This outputs a list of tasks with indices (0, 1, 2...).
+
+## Step 2.2: Generate Components (Iterative)
+
+**For EACH task index (starting from 0)**:
+
+1.  **Generate Prompt**:
+
+    ```bash
+    node scripts/coderio-skill.mjs code-prompt 0 > scripts/code-prompt.md
+    # Replace '0' with current task index
+    ```
+
+2.  **AI Task (Code)**:
+    - **ATTACH**: `process/thumbnail.png` (MANDATORY)
+    - **READ**: `scripts/code-prompt.md`
+    - **INSTRUCTION**: "Generate the React component code. Match the thumbnail EXACTLY. **Use STRICT text content from input data, do not hallucinate.**"
+    - **SAVE**: Paste the code block into `scripts/code-output.txt`.
+
+3.  **Save Code**:
+    ```bash
+    node scripts/coderio-skill.mjs save-code 0
+    # Replace '0' with current task index
+    ```
+
+## Step 2.3: Final Integration
+
+Inject the root component into `App.tsx`. Use the path found in the last task of Phase 2.1.
+
+---
+
+# Troubleshooting
+
+- **"Props validation failed"**: The AI generated empty props. Check if `process/thumbnail.png` was attached and visible to the AI. Retry the props generation step.
+- **"Module not found"**: Ensure `node scripts/coderio-skill.mjs save-code` was run for the child component before the parent component. Phase 2 must be done in order (0, 1, 2...).
+- **"Visuals don't match"**: Did you attach the thumbnail? The AI relies on it for spacing and layout nuances not present in the raw data.
diff --git a/.agents/skills/design-to-code/scripts/coderio-skill.mjs b/.agents/skills/design-to-code/scripts/coderio-skill.mjs
new file mode 100644
index 0000000..d46e568
--- /dev/null
+++ b/.agents/skills/design-to-code/scripts/coderio-skill.mjs
@@ -0,0 +1,300 @@
+import fs from 'fs';
+import path from 'path';
+import {
+    parseFigmaUrl, executeFigmaAndImagesActions, figmaTool, downloadImage,
+    extractNodePositionsHierarchical, generateStructurePrompt, extractJSON,
+    postProcessStructure, extractComponentGroups, simplifyFigmaNodeForContent,
+    extractDataListPrompt,
+    flattenPostOrder, detectRenderingModes, generateFramePrompt, generateComponentPrompt,
+    DEFAULT_STYLING, saveGeneratedCode, workspaceManager,
+    toKebabCase, toPascalCase, INITIAL_AGENT_SYSTEM_PROMPT, initialAgentInstruction
+} from 'coderio';
+
+const [,, command, ...args] = process.argv;
+const appPath = process.cwd();
+const processDir = path.join(appPath, 'process');
+const scriptsDir = path.join(appPath, 'scripts');
+const assetsDir = path.join(appPath, 'src/assets');
+
+// Ensure directories exist
+[processDir, scriptsDir, assetsDir].forEach(d => {
+    if (!fs.existsSync(d)) fs.mkdirSync(d, { recursive: true });
+});
+
+function extractAllComponentGroups(node) {
+    const groups = new Map();
+    function traverse(currentNode) {
+        const localGroups = extractComponentGroups(currentNode);
+        for (const [name, list] of localGroups) {
+            if (!groups.has(name)) groups.set(name, []);
+            groups.get(name).push(...list);
+        }
+        if (currentNode.children) {
+            currentNode.children.forEach(traverse);
+        }
+    }
+    traverse(node);
+    return groups;
+}
+
+function findParentOfGroup(root, componentName) {
+    let result = null;
+    function traverse(node) {
+        if (result) return;
+        if (node.children && node.children.some(c => c.data.componentName === componentName)) {
+            result = node;
+            return;
+        }
+        if (node.children) node.children.forEach(traverse);
+    }
+    traverse(root);
+    return result;
+}
+
+function applyPropsAndStateToProtocol(parsed, node, compName, group, isList) {
+    if (parsed && parsed.state && Array.isArray(parsed.state)) {
+        if (isList) {
+            if (!node.data.states) {
+                node.data.states = [];
+            }
+
+            node.data.states = node.data.states.filter(s => s.componentName !== compName);
+
+            node.data.states.push({
+                state: parsed.state,
+                componentName: compName,
+                componentPath: group[0]?.data.componentPath || '',
+            });
+
+            const originalChildren = node.children || [];
+            const newChildren = [];
+            const processedComponentNames = new Set();
+
+            for (const child of originalChildren) {
+                const childName = child.data.componentName;
+                if (childName === compName) {
+                    if (!processedComponentNames.has(childName)) {
+                        child.data.name = childName;
+                        child.id = childName;
+                        const cleanKebabName = toKebabCase(childName);
+                        child.data.kebabName = cleanKebabName;
+                        delete child.data.path;
+
+                        if (parsed.props && Array.isArray(parsed.props)) {
+                            child.data.props = parsed.props;
+                        }
+
+                        newChildren.push(child);
+                        processedComponentNames.add(childName);
+                    }
+                } else {
+                    newChildren.push(child);
+                }
+            }
+
+            node.children = newChildren;
+        }
+    }
+}
+
+async function main() {
+    try {
+        switch (command) {
+            case 'scaffold-prompt': {
+                console.log(INITIAL_AGENT_SYSTEM_PROMPT);
+                console.log('\n--- INSTRUCTION ---\n');
+                console.log(initialAgentInstruction({ appPath, appName: args[0] || 'MyApp' }));
+                break;
+            }
+
+            case 'fetch-figma': {
+                const [figmaUrl, figmaToken] = args;
+                if (!figmaUrl || !figmaToken) throw new Error('Usage: fetch-figma <url> <token>');
+
+                const urlInfo = parseFigmaUrl(figmaUrl);
+                console.log('Fetching Figma document...');
+                const { document, imageNodesMap } = await executeFigmaAndImagesActions(urlInfo, assetsDir, processDir, figmaToken);
+
+                const simplified = figmaTool.simplifyImageNodes(document, imageNodesMap);
+                const processed = figmaTool.processedStyle(simplified);
+                fs.writeFileSync(path.join(processDir, 'processed.json'), JSON.stringify(processed, null, 2));
+
+                if (processed.thumbnailUrl) {
+                    console.log('Downloading thumbnail...');
+                    const base64 = await downloadImage(processed.thumbnailUrl, undefined, undefined, true);
+                    fs.writeFileSync(path.join(processDir, 'thumbnail.png'), Buffer.from(base64, 'base64'));
+                    console.log('Thumbnail saved to process/thumbnail.png');
+                }
+                console.log('Figma data processed.');
+                break;
+            }
+
+            case 'structure-prompt': {
+                const procDoc = JSON.parse(fs.readFileSync(path.join(processDir, 'processed.json'), 'utf-8'));
+                const frames = procDoc.frames || procDoc.children;
+                const positions = extractNodePositionsHierarchical(frames);
+                const prompt = generateStructurePrompt({
+                    positions: JSON.stringify(positions, null, 2),
+                    width: String(procDoc.absoluteBoundingBox?.width || 1440)
+                });
+                console.log(prompt);
+                break;
+            }
+
+            case 'save-structure': {
+                const structureJson = fs.readFileSync(path.join(scriptsDir, 'structure-output.json'), 'utf-8');
+                const pDoc = JSON.parse(fs.readFileSync(path.join(processDir, 'processed.json'), 'utf-8'));
+
+                const parsed = JSON.parse(extractJSON(structureJson));
+                const structFrames = pDoc.frames || pDoc.children;
+                postProcessStructure(parsed, structFrames);
+
+                const protocol = Array.isArray(parsed) ? parsed[0] : parsed;
+                fs.writeFileSync(path.join(processDir, 'protocol.json'), JSON.stringify(protocol, null, 2));
+                console.log('Structure saved to process/protocol.json');
+                break;
+            }
+
+            case 'list-components': {
+                const prot = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const groups = extractAllComponentGroups(prot);
+                const list = Array.from(groups.keys()).map(name => {
+                    return { name, count: groups.get(name).length };
+                });
+                fs.writeFileSync(path.join(scriptsDir, 'component-list.json'), JSON.stringify(list, null, 2));
+                console.log(JSON.stringify(list, null, 2));
+                break;
+            }
+
+            case 'props-prompt': {
+                const compName = args[0];
+                const prot2 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const groups2 = extractAllComponentGroups(prot2);
+                const group = groups2.get(compName);
+                if (!group) throw new Error(`Component ${compName} not found`);
+
+                const instances = group.flatMap(g => g.data.elements || []);
+                const simpleNodes = instances
+                    .filter(n => typeof n === 'object' && n !== null)
+                    .map(n => simplifyFigmaNodeForContent(n));
+
+                console.log(extractDataListPrompt({
+                    containerName: prot2.data.name || 'Container',
+                    childComponentName: compName,
+                    figmaData: JSON.stringify(simpleNodes, null, 2)
+                }));
+                break;
+            }
+
+            case 'save-props': {
+                const cName = args[0];
+                const propsJsonPath = path.join(scriptsDir, `${cName}-props.json`);
+                const propsJson = fs.readFileSync(propsJsonPath, 'utf-8');
+                const parsedProps = JSON.parse(extractJSON(propsJson));
+
+                if (!parsedProps.props || parsedProps.props.length === 0) {
+                    throw new Error('Validation Failed: Props array is empty.');
+                }
+
+                const prot3 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const groups3 = extractAllComponentGroups(prot3);
+                const group3 = groups3.get(cName);
+
+                const parentNode = findParentOfGroup(prot3, cName);
+                if (parentNode) {
+                    applyPropsAndStateToProtocol(parsedProps, parentNode, cName, group3, true);
+                    fs.writeFileSync(path.join(processDir, 'protocol.json'), JSON.stringify(prot3, null, 2));
+                    console.log(`Props applied to ${cName} (Parent: ${parentNode.data.name || parentNode.id})`);
+                } else {
+                    console.error(`Parent not found for ${cName}`);
+                }
+                break;
+            }
+
+            case 'list-gen-tasks': {
+                const prot4 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const flat = flattenPostOrder(prot4);
+                const tasks = flat.map((node, i) => ({
+                    index: i,
+                    name: node.data.name || node.data.componentName,
+                    path: node.data.path || node.data.componentPath,
+                    isLeaf: !node.children?.length
+                }));
+                fs.writeFileSync(path.join(scriptsDir, 'gen-tasks.json'), JSON.stringify(tasks, null, 2));
+                console.log(JSON.stringify(tasks, null, 2));
+                break;
+            }
+
+            case 'code-prompt': {
+                const idx = parseInt(args[0]);
+                const prot5 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const flat2 = flattenPostOrder(prot5);
+                const node = flat2[idx];
+                const assets = fs.readdirSync(assetsDir).join(', ');
+
+                let prompt = '';
+                if (!node.children?.length) {
+                    prompt = generateComponentPrompt({
+                        componentName: node.data.name || node.data.componentName,
+                        componentDetails: JSON.stringify(node.data, null, 2),
+                        styling: JSON.stringify(DEFAULT_STYLING),
+                        assetFiles: assets
+                    });
+                } else {
+                    const imports = node.children.map(c => ({
+                        name: c.data.name,
+                        path: c.data.path || c.data.componentPath
+                    }));
+                    const modes = detectRenderingModes(node);
+                    prompt = generateFramePrompt({
+                        frameDetails: JSON.stringify(node.data, null, 2),
+                        childrenImports: JSON.stringify(imports, null, 2),
+                        styling: JSON.stringify(DEFAULT_STYLING),
+                        assetFiles: assets,
+                        renderingModes: modes
+                    });
+                }
+
+                // Add instruction for Asset Imports in State
+                if (node.data.states && node.data.states.length > 0) {
+                    prompt += `\n\n<asset_imports_instruction>
+The 'states' data contains references to assets (e.g. "@/assets/foo.png").
+You MUST:
+1. Import these assets at the top of the file: \`import image_foo from '@/assets/foo.png';\`
+2. In the \`states\` array in your code, use the variable \`image_foo\` instead of the string.
+   Example: \`imageSrc: image_foo\` (NOT \`imageSrc: "@/assets/foo.png"\`)
+</asset_imports_instruction>`;
+                }
+
+                console.log(prompt);
+                break;
+            }
+
+            case 'save-code': {
+                const idx2 = parseInt(args[0]);
+                const codePath = path.join(scriptsDir, 'code-output.txt');
+                const code = fs.readFileSync(codePath, 'utf-8');
+
+                const prot6 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const flat3 = flattenPostOrder(prot6);
+                const node2 = flat3[idx2];
+
+                const componentPath = node2.data.path || node2.data.componentPath;
+                if (!componentPath) throw new Error(`Node ${node2.data.name} has no path`);
+
+                const compDir = path.join(appPath, 'src', workspaceManager.resolveComponentPath(componentPath));
+                saveGeneratedCode(code, compDir);
+                console.log(`Code saved to ${compDir}`);
+                break;
+            }
+
+            default:
+                console.log('Unknown command');
+        }
+    } catch (e) {
+        console.error('Error:', e.message);
+        process.exit(1);
+    }
+}
+
+main();
diff --git a/.agents/skills/design-to-code/scripts/package.json b/.agents/skills/design-to-code/scripts/package.json
new file mode 100644
index 0000000..2cde861
--- /dev/null
+++ b/.agents/skills/design-to-code/scripts/package.json
@@ -0,0 +1,8 @@
+{
+  "name": "coderio-scripts",
+  "version": "1.0.0",
+  "private": true,
+  "dependencies": {
+    "coderio": "latest"
+  }
+}
diff --git a/.agents/skills/diagnose/SKILL.md b/.agents/skills/diagnose/SKILL.md
new file mode 100644
index 0000000..ed55bda
--- /dev/null
+++ b/.agents/skills/diagnose/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: diagnose
+description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
+---
+
+# Diagnose
+
+A discipline for hard bugs. Skip phases only when explicitly justified.
+
+When exploring the codebase, use the project's domain glossary to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.
+
+## Phase 1 — Build a feedback loop
+
+**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you.
+
+Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.**
+
+### Ways to construct one — try them in roughly this order
+
+1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.
+2. **Curl / HTTP script** against a running dev server.
+3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.
+4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network.
+5. **Replay a captured trace.** Save a real network request / payload / event log to disk; replay it through the code path in isolation.
+6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that exercises the bug code path with a single function call.
+7. **Property / fuzz loop.** If the bug is "sometimes wrong output", run 1000 random inputs and look for the failure mode.
+8. **Bisection harness.** If the bug appeared between two known states (commit, dataset, version), automate "boot at state X, check, repeat" so you can `git bisect run` it.
+9. **Differential loop.** Run the same input through old-version vs new-version (or two configs) and diff outputs.
+10. **HITL bash script.** Last resort. If a human must click, drive _them_ with `scripts/hitl-loop.template.sh` so the loop is still structured. Captured output feeds back to you.
+
+Build the right feedback loop, and the bug is 90% fixed.
+
+### Iterate on the loop itself
+
+Treat the loop as a product. Once you have _a_ loop, ask:
+
+- Can I make it faster? (Cache setup, skip unrelated init, narrow the test scope.)
+- Can I make the signal sharper? (Assert on the specific symptom, not "didn't crash".)
+- Can I make it more deterministic? (Pin time, seed RNG, isolate filesystem, freeze network.)
+
+A 30-second flaky loop is barely better than no loop. A 2-second deterministic loop is a debugging superpower.
+
+### Non-deterministic bugs
+
+The goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×, parallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake bug is debuggable; 1% is not — keep raising the rate until it's debuggable.
+
+### When you genuinely cannot build a loop
+
+Stop and say so explicitly. List what you tried. Ask the user for: (a) access to whatever environment reproduces it, (b) a captured artifact (HAR file, log dump, core dump, screen recording with timestamps), or (c) permission to add temporary production instrumentation. Do **not** proceed to hypothesise without a loop.
+
+Do not proceed to Phase 2 until you have a loop you believe in.
+
+## Phase 2 — Reproduce
+
+Run the loop. Watch the bug appear.
+
+Confirm:
+
+- [ ] The loop produces the failure mode the **user** described — not a different failure that happens to be nearby. Wrong bug = wrong fix.
+- [ ] The failure is reproducible across multiple runs (or, for non-deterministic bugs, reproducible at a high enough rate to debug against).
+- [ ] You have captured the exact symptom (error message, wrong output, slow timing) so later phases can verify the fix actually addresses it.
+
+Do not proceed until you reproduce the bug.
+
+## Phase 3 — Hypothesise
+
+Generate **3–5 ranked hypotheses** before testing any of them. Single-hypothesis generation anchors on the first plausible idea.
+
+Each hypothesis must be **falsifiable**: state the prediction it makes.
+
+> Format: "If <X> is the cause, then <changing Y> will make the bug disappear / <changing Z> will make it worse."
+
+If you cannot state the prediction, the hypothesis is a vibe — discard or sharpen it.
+
+**Show the ranked list to the user before testing.** They often have domain knowledge that re-ranks instantly ("we just deployed a change to #3"), or know hypotheses they've already ruled out. Cheap checkpoint, big time saver. Don't block on it — proceed with your ranking if the user is AFK.
+
+## Phase 4 — Instrument
+
+Each probe must map to a specific prediction from Phase 3. **Change one variable at a time.**
+
+Tool preference:
+
+1. **Debugger / REPL inspection** if the env supports it. One breakpoint beats ten logs.
+2. **Targeted logs** at the boundaries that distinguish hypotheses.
+3. Never "log everything and grep".
+
+**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep. Untagged logs survive; tagged logs die.
+
+**Perf branch.** For performance regressions, logs are usually wrong. Instead: establish a baseline measurement (timing harness, `performance.now()`, profiler, query plan), then bisect. Measure first, fix second.
+
+## Phase 5 — Fix + regression test
+
+Write the regression test **before the fix** — but only if there is a **correct seam** for it.
+
+A correct seam is one where the test exercises the **real bug pattern** as it occurs at the call site. If the only available seam is too shallow (single-caller test when the bug needs multiple callers, unit test that can't replicate the chain that triggered the bug), a regression test there gives false confidence.
+
+**If no correct seam exists, that itself is the finding.** Note it. The codebase architecture is preventing the bug from being locked down. Flag this for the next phase.
+
+If a correct seam exists:
+
+1. Turn the minimised repro into a failing test at that seam.
+2. Watch it fail.
+3. Apply the fix.
+4. Watch it pass.
+5. Re-run the Phase 1 feedback loop against the original (un-minimised) scenario.
+
+## Phase 6 — Cleanup + post-mortem
+
+Required before declaring done:
+
+- [ ] Original repro no longer reproduces (re-run the Phase 1 loop)
+- [ ] Regression test passes (or absence of seam is documented)
+- [ ] All `[DEBUG-...]` instrumentation removed (`grep` the prefix)
+- [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location)
+- [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns
+
+**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started.
diff --git a/.agents/skills/diagnose/scripts/hitl-loop.template.sh b/.agents/skills/diagnose/scripts/hitl-loop.template.sh
new file mode 100644
index 0000000..40afc46
--- /dev/null
+++ b/.agents/skills/diagnose/scripts/hitl-loop.template.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Human-in-the-loop reproduction loop.
+# Copy this file, edit the steps below, and run it.
+# The agent runs the script; the user follows prompts in their terminal.
+#
+# Usage:
+#   bash hitl-loop.template.sh
+#
+# Two helpers:
+#   step "<instruction>"          → show instruction, wait for Enter
+#   capture VAR "<question>"      → show question, read response into VAR
+#
+# At the end, captured values are printed as KEY=VALUE for the agent to parse.
+
+set -euo pipefail
+
+step() {
+  printf '\n>>> %s\n' "$1"
+  read -r -p "    [Enter when done] " _
+}
+
+capture() {
+  local var="$1" question="$2" answer
+  printf '\n>>> %s\n' "$question"
+  read -r -p "    > " answer
+  printf -v "$var" '%s' "$answer"
+}
+
+# --- edit below ---------------------------------------------------------
+
+step "Open the app at http://localhost:3000 and sign in."
+
+capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)"
+
+capture ERROR_MSG "Paste the error message (or 'none'):"
+
+# --- edit above ---------------------------------------------------------
+
+printf '\n--- Captured ---\n'
+printf 'ERRORED=%s\n' "$ERRORED"
+printf 'ERROR_MSG=%s\n' "$ERROR_MSG"
diff --git a/.agents/skills/excel-analysis/SKILL.md b/.agents/skills/excel-analysis/SKILL.md
new file mode 100644
index 0000000..57ad5ec
--- /dev/null
+++ b/.agents/skills/excel-analysis/SKILL.md
@@ -0,0 +1,247 @@
+---
+name: Excel Analysis
+description: Analyze Excel spreadsheets, create pivot tables, generate charts, and perform data analysis. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
+---
+
+# Excel Analysis
+
+## Quick start
+
+Read Excel files with pandas:
+
+```python
+import pandas as pd
+
+# Read Excel file
+df = pd.read_excel("data.xlsx", sheet_name="Sheet1")
+
+# Display first few rows
+print(df.head())
+
+# Basic statistics
+print(df.describe())
+```
+
+## Reading multiple sheets
+
+Process all sheets in a workbook:
+
+```python
+import pandas as pd
+
+# Read all sheets
+excel_file = pd.ExcelFile("workbook.xlsx")
+
+for sheet_name in excel_file.sheet_names:
+    df = pd.read_excel(excel_file, sheet_name=sheet_name)
+    print(f"\n{sheet_name}:")
+    print(df.head())
+```
+
+## Data analysis
+
+Perform common analysis tasks:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("sales.xlsx")
+
+# Group by and aggregate
+sales_by_region = df.groupby("region")["sales"].sum()
+print(sales_by_region)
+
+# Filter data
+high_sales = df[df["sales"] > 10000]
+
+# Calculate metrics
+df["profit_margin"] = (df["revenue"] - df["cost"]) / df["revenue"]
+
+# Sort by column
+df_sorted = df.sort_values("sales", ascending=False)
+```
+
+## Creating Excel files
+
+Write data to Excel with formatting:
+
+```python
+import pandas as pd
+
+df = pd.DataFrame({
+    "Product": ["A", "B", "C"],
+    "Sales": [100, 200, 150],
+    "Profit": [20, 40, 30]
+})
+
+# Write to Excel
+writer = pd.ExcelWriter("output.xlsx", engine="openpyxl")
+df.to_excel(writer, sheet_name="Sales", index=False)
+
+# Get worksheet for formatting
+worksheet = writer.sheets["Sales"]
+
+# Auto-adjust column widths
+for column in worksheet.columns:
+    max_length = 0
+    column_letter = column[0].column_letter
+    for cell in column:
+        if len(str(cell.value)) > max_length:
+            max_length = len(str(cell.value))
+    worksheet.column_dimensions[column_letter].width = max_length + 2
+
+writer.close()
+```
+
+## Pivot tables
+
+Create pivot tables programmatically:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("sales_data.xlsx")
+
+# Create pivot table
+pivot = pd.pivot_table(
+    df,
+    values="sales",
+    index="region",
+    columns="product",
+    aggfunc="sum",
+    fill_value=0
+)
+
+print(pivot)
+
+# Save pivot table
+pivot.to_excel("pivot_report.xlsx")
+```
+
+## Charts and visualization
+
+Generate charts from Excel data:
+
+```python
+import pandas as pd
+import matplotlib.pyplot as plt
+
+df = pd.read_excel("data.xlsx")
+
+# Create bar chart
+df.plot(x="category", y="value", kind="bar")
+plt.title("Sales by Category")
+plt.xlabel("Category")
+plt.ylabel("Sales")
+plt.tight_layout()
+plt.savefig("chart.png")
+
+# Create pie chart
+df.set_index("category")["value"].plot(kind="pie", autopct="%1.1f%%")
+plt.title("Market Share")
+plt.ylabel("")
+plt.savefig("pie_chart.png")
+```
+
+## Data cleaning
+
+Clean and prepare Excel data:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("messy_data.xlsx")
+
+# Remove duplicates
+df = df.drop_duplicates()
+
+# Handle missing values
+df = df.fillna(0)  # or df.dropna()
+
+# Remove whitespace
+df["name"] = df["name"].str.strip()
+
+# Convert data types
+df["date"] = pd.to_datetime(df["date"])
+df["amount"] = pd.to_numeric(df["amount"], errors="coerce")
+
+# Save cleaned data
+df.to_excel("cleaned_data.xlsx", index=False)
+```
+
+## Merging and joining
+
+Combine multiple Excel files:
+
+```python
+import pandas as pd
+
+# Read multiple files
+df1 = pd.read_excel("sales_q1.xlsx")
+df2 = pd.read_excel("sales_q2.xlsx")
+
+# Concatenate vertically
+combined = pd.concat([df1, df2], ignore_index=True)
+
+# Merge on common column
+customers = pd.read_excel("customers.xlsx")
+sales = pd.read_excel("sales.xlsx")
+
+merged = pd.merge(sales, customers, on="customer_id", how="left")
+
+merged.to_excel("merged_data.xlsx", index=False)
+```
+
+## Advanced formatting
+
+Apply conditional formatting and styles:
+
+```python
+import pandas as pd
+from openpyxl import load_workbook
+from openpyxl.styles import PatternFill, Font
+
+# Create Excel file
+df = pd.DataFrame({
+    "Product": ["A", "B", "C"],
+    "Sales": [100, 200, 150]
+})
+
+df.to_excel("formatted.xlsx", index=False)
+
+# Load workbook for formatting
+wb = load_workbook("formatted.xlsx")
+ws = wb.active
+
+# Apply conditional formatting
+red_fill = PatternFill(start_color="FF0000", end_color="FF0000", fill_type="solid")
+green_fill = PatternFill(start_color="00FF00", end_color="00FF00", fill_type="solid")
+
+for row in range(2, len(df) + 2):
+    cell = ws[f"B{row}"]
+    if cell.value < 150:
+        cell.fill = red_fill
+    else:
+        cell.fill = green_fill
+
+# Bold headers
+for cell in ws[1]:
+    cell.font = Font(bold=True)
+
+wb.save("formatted.xlsx")
+```
+
+## Performance tips
+
+- Use `read_excel` with `usecols` to read specific columns only
+- Use `chunksize` for very large files
+- Consider using `engine='openpyxl'` or `engine='xlrd'` based on file type
+- Use `dtype` parameter to specify column types for faster reading
+
+## Available packages
+
+- **pandas** - Data analysis and manipulation (primary)
+- **openpyxl** - Excel file creation and formatting
+- **xlrd** - Reading older .xls files
+- **xlsxwriter** - Advanced Excel writing capabilities
+- **matplotlib** - Chart generation
diff --git a/.agents/skills/flutter-dart-code-review/SKILL.md b/.agents/skills/flutter-dart-code-review/SKILL.md
new file mode 100644
index 0000000..2f9529d
--- /dev/null
+++ b/.agents/skills/flutter-dart-code-review/SKILL.md
@@ -0,0 +1,435 @@
+---
+name: flutter-dart-code-review
+description: Library-agnostic Flutter/Dart code review checklist covering widget best practices, state management patterns (BLoC, Riverpod, Provider, GetX, MobX, Signals), Dart idioms, performance, accessibility, security, and clean architecture.
+origin: ECC
+---
+
+# Flutter/Dart Code Review Best Practices
+
+Comprehensive, library-agnostic checklist for reviewing Flutter/Dart applications. These principles apply regardless of which state management solution, routing library, or DI framework is used.
+
+---
+
+## 1. General Project Health
+
+- [ ] Project follows consistent folder structure (feature-first or layer-first)
+- [ ] Proper separation of concerns: UI, business logic, data layers
+- [ ] No business logic in widgets; widgets are purely presentational
+- [ ] `pubspec.yaml` is clean — no unused dependencies, versions pinned appropriately
+- [ ] `analysis_options.yaml` includes a strict lint set with strict analyzer settings enabled
+- [ ] No `print()` statements in production code — use `dart:developer` `log()` or a logging package
+- [ ] Generated files (`.g.dart`, `.freezed.dart`, `.gr.dart`) are up-to-date or in `.gitignore`
+- [ ] Platform-specific code isolated behind abstractions
+
+---
+
+## 2. Dart Language Pitfalls
+
+- [ ] **Implicit dynamic**: Missing type annotations leading to `dynamic` — enable `strict-casts`, `strict-inference`, `strict-raw-types`
+- [ ] **Null safety misuse**: Excessive `!` (bang operator) instead of proper null checks or Dart 3 pattern matching (`if (value case var v?)`)
+- [ ] **Type promotion failures**: Using `this.field` where local variable promotion would work
+- [ ] **Catching too broadly**: `catch (e)` without `on` clause; always specify exception types
+- [ ] **Catching `Error`**: `Error` subtypes indicate bugs and should not be caught
+- [ ] **Unused `async`**: Functions marked `async` that never `await` — unnecessary overhead
+- [ ] **`late` overuse**: `late` used where nullable or constructor initialization would be safer; defers errors to runtime
+- [ ] **String concatenation in loops**: Use `StringBuffer` instead of `+` for iterative string building
+- [ ] **Mutable state in `const` contexts**: Fields in `const` constructor classes should not be mutable
+- [ ] **Ignoring `Future` return values**: Use `await` or explicitly call `unawaited()` to signal intent
+- [ ] **`var` where `final` works**: Prefer `final` for locals and `const` for compile-time constants
+- [ ] **Relative imports**: Use `package:` imports for consistency
+- [ ] **Mutable collections exposed**: Public APIs should return unmodifiable views, not raw `List`/`Map`
+- [ ] **Missing Dart 3 pattern matching**: Prefer switch expressions and `if-case` over verbose `is` checks and manual casting
+- [ ] **Throwaway classes for multiple returns**: Use Dart 3 records `(String, int)` instead of single-use DTOs
+- [ ] **`print()` in production code**: Use `dart:developer` `log()` or the project's logging package; `print()` has no log levels and cannot be filtered
+
+---
+
+## 3. Widget Best Practices
+
+### Widget decomposition:
+- [ ] No single widget with a `build()` method exceeding ~80-100 lines
+- [ ] Widgets split by encapsulation AND by how they change (rebuild boundaries)
+- [ ] Private `_build*()` helper methods that return widgets are extracted to separate widget classes (enables element reuse, const propagation, and framework optimizations)
+- [ ] Stateless widgets preferred over Stateful where no mutable local state is needed
+- [ ] Extracted widgets are in separate files when reusable
+
+### Const usage:
+- [ ] `const` constructors used wherever possible — prevents unnecessary rebuilds
+- [ ] `const` literals for collections that don't change (`const []`, `const {}`)
+- [ ] Constructor is declared `const` when all fields are final
+
+### Key usage:
+- [ ] `ValueKey` used in lists/grids to preserve state across reorders
+- [ ] `GlobalKey` used sparingly — only when accessing state across the tree is truly needed
+- [ ] `UniqueKey` avoided in `build()` — it forces rebuild every frame
+- [ ] `ObjectKey` used when identity is based on a data object rather than a single value
+
+### Theming & design system:
+- [ ] Colors come from `Theme.of(context).colorScheme` — no hardcoded `Colors.red` or hex values
+- [ ] Text styles come from `Theme.of(context).textTheme` — no inline `TextStyle` with raw font sizes
+- [ ] Dark mode compatibility verified — no assumptions about light background
+- [ ] Spacing and sizing use consistent design tokens or constants, not magic numbers
+
+### Build method complexity:
+- [ ] No network calls, file I/O, or heavy computation in `build()`
+- [ ] No `Future.then()` or `async` work in `build()`
+- [ ] No subscription creation (`.listen()`) in `build()`
+- [ ] `setState()` localized to smallest possible subtree
+
+---
+
+## 4. State Management (Library-Agnostic)
+
+These principles apply to all Flutter state management solutions (BLoC, Riverpod, Provider, GetX, MobX, Signals, ValueNotifier, etc.).
+
+### Architecture:
+- [ ] Business logic lives outside the widget layer — in a state management component (BLoC, Notifier, Controller, Store, ViewModel, etc.)
+- [ ] State managers receive dependencies via injection, not by constructing them internally
+- [ ] A service or repository layer abstracts data sources — widgets and state managers should not call APIs or databases directly
+- [ ] State managers have a single responsibility — no "god" managers handling unrelated concerns
+- [ ] Cross-component dependencies follow the solution's conventions:
+  - In **Riverpod**: providers depending on providers via `ref.watch` is expected — flag only circular or overly tangled chains
+  - In **BLoC**: blocs should not directly depend on other blocs — prefer shared repositories or presentation-layer coordination
+  - In other solutions: follow the documented conventions for inter-component communication
+
+### Immutability & value equality (for immutable-state solutions: BLoC, Riverpod, Redux):
+- [ ] State objects are immutable — new instances created via `copyWith()` or constructors, never mutated in-place
+- [ ] State classes implement `==` and `hashCode` properly (all fields included in comparison)
+- [ ] Mechanism is consistent across the project — manual override, `Equatable`, `freezed`, Dart records, or other
+- [ ] Collections inside state objects are not exposed as raw mutable `List`/`Map`
+
+### Reactivity discipline (for reactive-mutation solutions: MobX, GetX, Signals):
+- [ ] State is only mutated through the solution's reactive API (`@action` in MobX, `.value` on signals, `.obs` in GetX) — direct field mutation bypasses change tracking
+- [ ] Derived values use the solution's computed mechanism rather than being stored redundantly
+- [ ] Reactions and disposers are properly cleaned up (`ReactionDisposer` in MobX, effect cleanup in Signals)
+
+### State shape design:
+- [ ] Mutually exclusive states use sealed types, union variants, or the solution's built-in async state type (e.g. Riverpod's `AsyncValue`) — not boolean flags (`isLoading`, `isError`, `hasData`)
+- [ ] Every async operation models loading, success, and error as distinct states
+- [ ] All state variants are handled exhaustively in UI — no silently ignored cases
+- [ ] Error states carry error information for display; loading states don't carry stale data
+- [ ] Nullable data is not used as a loading indicator — states are explicit
+
+```dart
+// BAD — boolean flag soup allows impossible states
+class UserState {
+  bool isLoading = false;
+  bool hasError = false; // isLoading && hasError is representable!
+  User? user;
+}
+
+// GOOD (immutable approach) — sealed types make impossible states unrepresentable
+sealed class UserState {}
+class UserInitial extends UserState {}
+class UserLoading extends UserState {}
+class UserLoaded extends UserState {
+  final User user;
+  const UserLoaded(this.user);
+}
+class UserError extends UserState {
+  final String message;
+  const UserError(this.message);
+}
+
+// GOOD (reactive approach) — observable enum + data, mutations via reactivity API
+// enum UserStatus { initial, loading, loaded, error }
+// Use your solution's observable/signal to wrap status and data separately
+```
+
+### Rebuild optimization:
+- [ ] State consumer widgets (Builder, Consumer, Observer, Obx, Watch, etc.) scoped as narrow as possible
+- [ ] Selectors used to rebuild only when specific fields change — not on every state emission
+- [ ] `const` widgets used to stop rebuild propagation through the tree
+- [ ] Computed/derived state is calculated reactively, not stored redundantly
+
+### Subscriptions & disposal:
+- [ ] All manual subscriptions (`.listen()`) are cancelled in `dispose()` / `close()`
+- [ ] Stream controllers are closed when no longer needed
+- [ ] Timers are cancelled in disposal lifecycle
+- [ ] Framework-managed lifecycle is preferred over manual subscription (declarative builders over `.listen()`)
+- [ ] `mounted` check before `setState` in async callbacks
+- [ ] `BuildContext` not used after `await` without checking `context.mounted` (Flutter 3.7+) — stale context causes crashes
+- [ ] No navigation, dialogs, or scaffold messages after async gaps without verifying the widget is still mounted
+- [ ] `BuildContext` never stored in singletons, state managers, or static fields
+
+### Local vs global state:
+- [ ] Ephemeral UI state (checkbox, slider, animation) uses local state (`setState`, `ValueNotifier`)
+- [ ] Shared state is lifted only as high as needed — not over-globalized
+- [ ] Feature-scoped state is properly disposed when the feature is no longer active
+
+---
+
+## 5. Performance
+
+### Unnecessary rebuilds:
+- [ ] `setState()` not called at root widget level — localize state changes
+- [ ] `const` widgets used to stop rebuild propagation
+- [ ] `RepaintBoundary` used around complex subtrees that repaint independently
+- [ ] `AnimatedBuilder` child parameter used for subtrees independent of animation
+
+### Expensive operations in build():
+- [ ] No sorting, filtering, or mapping large collections in `build()` — compute in state management layer
+- [ ] No regex compilation in `build()`
+- [ ] `MediaQuery.of(context)` usage is specific (e.g., `MediaQuery.sizeOf(context)`)
+
+### Image optimization:
+- [ ] Network images use caching (any caching solution appropriate for the project)
+- [ ] Appropriate image resolution for target device (no loading 4K images for thumbnails)
+- [ ] `Image.asset` with `cacheWidth`/`cacheHeight` to decode at display size
+- [ ] Placeholder and error widgets provided for network images
+
+### Lazy loading:
+- [ ] `ListView.builder` / `GridView.builder` used instead of `ListView(children: [...])` for large or dynamic lists (concrete constructors are fine for small, static lists)
+- [ ] Pagination implemented for large data sets
+- [ ] Deferred loading (`deferred as`) used for heavy libraries in web builds
+
+### Other:
+- [ ] `Opacity` widget avoided in animations — use `AnimatedOpacity` or `FadeTransition`
+- [ ] Clipping avoided in animations — pre-clip images
+- [ ] `operator ==` not overridden on widgets — use `const` constructors instead
+- [ ] Intrinsic dimension widgets (`IntrinsicHeight`, `IntrinsicWidth`) used sparingly (extra layout pass)
+
+---
+
+## 6. Testing
+
+### Test types and expectations:
+- [ ] **Unit tests**: Cover all business logic (state managers, repositories, utility functions)
+- [ ] **Widget tests**: Cover individual widget behavior, interactions, and visual output
+- [ ] **Integration tests**: Cover critical user flows end-to-end
+- [ ] **Golden tests**: Pixel-perfect comparisons for design-critical UI components
+
+### Coverage targets:
+- [ ] Aim for 80%+ line coverage on business logic
+- [ ] All state transitions have corresponding tests (loading → success, loading → error, retry, etc.)
+- [ ] Edge cases tested: empty states, error states, loading states, boundary values
+
+### Test isolation:
+- [ ] External dependencies (API clients, databases, services) are mocked or faked
+- [ ] Each test file tests exactly one class/unit
+- [ ] Tests verify behavior, not implementation details
+- [ ] Stubs define only the behavior needed for each test (minimal stubbing)
+- [ ] No shared mutable state between test cases
+
+### Widget test quality:
+- [ ] `pumpWidget` and `pump` used correctly for async operations
+- [ ] `find.byType`, `find.text`, `find.byKey` used appropriately
+- [ ] No flaky tests depending on timing — use `pumpAndSettle` or explicit `pump(Duration)`
+- [ ] Tests run in CI and failures block merges
+
+---
+
+## 7. Accessibility
+
+### Semantic widgets:
+- [ ] `Semantics` widget used to provide screen reader labels where automatic labels are insufficient
+- [ ] `ExcludeSemantics` used for purely decorative elements
+- [ ] `MergeSemantics` used to combine related widgets into a single accessible element
+- [ ] Images have `semanticLabel` property set
+
+### Screen reader support:
+- [ ] All interactive elements are focusable and have meaningful descriptions
+- [ ] Focus order is logical (follows visual reading order)
+
+### Visual accessibility:
+- [ ] Contrast ratio >= 4.5:1 for text against background
+- [ ] Tappable targets are at least 48x48 pixels
+- [ ] Color is not the sole indicator of state (use icons/text alongside)
+- [ ] Text scales with system font size settings
+
+### Interaction accessibility:
+- [ ] No no-op `onPressed` callbacks — every button does something or is disabled
+- [ ] Error fields suggest corrections
+- [ ] Context does not change unexpectedly while user is inputting data
+
+---
+
+## 8. Platform-Specific Concerns
+
+### iOS/Android differences:
+- [ ] Platform-adaptive widgets used where appropriate
+- [ ] Back navigation handled correctly (Android back button, iOS swipe-to-go-back)
+- [ ] Status bar and safe area handled via `SafeArea` widget
+- [ ] Platform-specific permissions declared in `AndroidManifest.xml` and `Info.plist`
+
+### Responsive design:
+- [ ] `LayoutBuilder` or `MediaQuery` used for responsive layouts
+- [ ] Breakpoints defined consistently (phone, tablet, desktop)
+- [ ] Text doesn't overflow on small screens — use `Flexible`, `Expanded`, `FittedBox`
+- [ ] Landscape orientation tested or explicitly locked
+- [ ] Web-specific: mouse/keyboard interactions supported, hover states present
+
+---
+
+## 9. Security
+
+### Secure storage:
+- [ ] Sensitive data (tokens, credentials) stored using platform-secure storage (Keychain on iOS, EncryptedSharedPreferences on Android)
+- [ ] Never store secrets in plaintext storage
+- [ ] Biometric authentication gating considered for sensitive operations
+
+### API key handling:
+- [ ] API keys NOT hardcoded in Dart source — use `--dart-define`, `.env` files excluded from VCS, or compile-time configuration
+- [ ] Secrets not committed to git — check `.gitignore`
+- [ ] Backend proxy used for truly secret keys (client should never hold server secrets)
+
+### Input validation:
+- [ ] All user input validated before sending to API
+- [ ] Form validation uses proper validation patterns
+- [ ] No raw SQL or string interpolation of user input
+- [ ] Deep link URLs validated and sanitized before navigation
+
+### Network security:
+- [ ] HTTPS enforced for all API calls
+- [ ] Certificate pinning considered for high-security apps
+- [ ] Authentication tokens refreshed and expired properly
+- [ ] No sensitive data logged or printed
+
+---
+
+## 10. Package/Dependency Review
+
+### Evaluating pub.dev packages:
+- [ ] Check **pub points score** (aim for 130+/160)
+- [ ] Check **likes** and **popularity** as community signals
+- [ ] Verify the publisher is **verified** on pub.dev
+- [ ] Check last publish date — stale packages (>1 year) are a risk
+- [ ] Review open issues and response time from maintainers
+- [ ] Check license compatibility with your project
+- [ ] Verify platform support covers your targets
+
+### Version constraints:
+- [ ] Use caret syntax (`^1.2.3`) for dependencies — allows compatible updates
+- [ ] Pin exact versions only when absolutely necessary
+- [ ] Run `flutter pub outdated` regularly to track stale dependencies
+- [ ] No dependency overrides in production `pubspec.yaml` — only for temporary fixes with a comment/issue link
+- [ ] Minimize transitive dependency count — each dependency is an attack surface
+
+### Monorepo-specific (melos/workspace):
+- [ ] Internal packages import only from public API — no `package:other/src/internal.dart` (breaks Dart package encapsulation)
+- [ ] Internal package dependencies use workspace resolution, not hardcoded `path: ../../` relative strings
+- [ ] All sub-packages share or inherit root `analysis_options.yaml`
+
+---
+
+## 11. Navigation and Routing
+
+### General principles (apply to any routing solution):
+- [ ] One routing approach used consistently — no mixing imperative `Navigator.push` with a declarative router
+- [ ] Route arguments are typed — no `Map<String, dynamic>` or `Object?` casting
+- [ ] Route paths defined as constants, enums, or generated — no magic strings scattered in code
+- [ ] Auth guards/redirects centralized — not duplicated across individual screens
+- [ ] Deep links configured for both Android and iOS
+- [ ] Deep link URLs validated and sanitized before navigation
+- [ ] Navigation state is testable — route changes can be verified in tests
+- [ ] Back behavior is correct on all platforms
+
+---
+
+## 12. Error Handling
+
+### Framework error handling:
+- [ ] `FlutterError.onError` overridden to capture framework errors (build, layout, paint)
+- [ ] `PlatformDispatcher.instance.onError` set for async errors not caught by Flutter
+- [ ] `ErrorWidget.builder` customized for release mode (user-friendly instead of red screen)
+- [ ] Global error capture wrapper around `runApp` (e.g., `runZonedGuarded`, Sentry/Crashlytics wrapper)
+
+### Error reporting:
+- [ ] Error reporting service integrated (Firebase Crashlytics, Sentry, or equivalent)
+- [ ] Non-fatal errors reported with stack traces
+- [ ] State management error observer wired to error reporting (e.g., BlocObserver, ProviderObserver, or equivalent for your solution)
+- [ ] User-identifiable info (user ID) attached to error reports for debugging
+
+### Graceful degradation:
+- [ ] API errors result in user-friendly error UI, not crashes
+- [ ] Retry mechanisms for transient network failures
+- [ ] Offline state handled gracefully
+- [ ] Error states in state management carry error info for display
+- [ ] Raw exceptions (network, parsing) are mapped to user-friendly, localized messages before reaching the UI — never show raw exception strings to users
+
+---
+
+## 13. Internationalization (l10n)
+
+### Setup:
+- [ ] Localization solution configured (Flutter's built-in ARB/l10n, easy_localization, or equivalent)
+- [ ] Supported locales declared in app configuration
+
+### Content:
+- [ ] All user-visible strings use the localization system — no hardcoded strings in widgets
+- [ ] Template file includes descriptions/context for translators
+- [ ] ICU message syntax used for plurals, genders, selects
+- [ ] Placeholders defined with types
+- [ ] No missing keys across locales
+
+### Code review:
+- [ ] Localization accessor used consistently throughout the project
+- [ ] Date, time, number, and currency formatting is locale-aware
+- [ ] Text directionality (RTL) supported if targeting Arabic, Hebrew, etc.
+- [ ] No string concatenation for localized text — use parameterized messages
+
+---
+
+## 14. Dependency Injection
+
+### Principles (apply to any DI approach):
+- [ ] Classes depend on abstractions (interfaces), not concrete implementations at layer boundaries
+- [ ] Dependencies provided externally via constructor, DI framework, or provider graph — not created internally
+- [ ] Registration distinguishes lifetime: singleton vs factory vs lazy singleton
+- [ ] Environment-specific bindings (dev/staging/prod) use configuration, not runtime `if` checks
+- [ ] No circular dependencies in the DI graph
+- [ ] Service locator calls (if used) are not scattered throughout business logic
+
+---
+
+## 15. Static Analysis
+
+### Configuration:
+- [ ] `analysis_options.yaml` present with strict settings enabled
+- [ ] Strict analyzer settings: `strict-casts: true`, `strict-inference: true`, `strict-raw-types: true`
+- [ ] A comprehensive lint rule set is included (very_good_analysis, flutter_lints, or custom strict rules)
+- [ ] All sub-packages in monorepos inherit or share the root analysis options
+
+### Enforcement:
+- [ ] No unresolved analyzer warnings in committed code
+- [ ] Lint suppressions (`// ignore:`) are justified with comments explaining why
+- [ ] `flutter analyze` runs in CI and failures block merges
+
+### Key rules to verify regardless of lint package:
+- [ ] `prefer_const_constructors` — performance in widget trees
+- [ ] `avoid_print` — use proper logging
+- [ ] `unawaited_futures` — prevent fire-and-forget async bugs
+- [ ] `prefer_final_locals` — immutability at variable level
+- [ ] `always_declare_return_types` — explicit contracts
+- [ ] `avoid_catches_without_on_clauses` — specific error handling
+- [ ] `always_use_package_imports` — consistent import style
+
+---
+
+## State Management Quick Reference
+
+The table below maps universal principles to their implementation in popular solutions. Use this to adapt review rules to whichever solution the project uses.
+
+| Principle | BLoC/Cubit | Riverpod | Provider | GetX | MobX | Signals | Built-in |
+|-----------|-----------|----------|----------|------|------|---------|----------|
+| State container | `Bloc`/`Cubit` | `Notifier`/`AsyncNotifier` | `ChangeNotifier` | `GetxController` | `Store` | `signal()` | `StatefulWidget` |
+| UI consumer | `BlocBuilder` | `ConsumerWidget` | `Consumer` | `Obx`/`GetBuilder` | `Observer` | `Watch` | `setState` |
+| Selector | `BlocSelector`/`buildWhen` | `ref.watch(p.select(...))` | `Selector` | N/A | computed | `computed()` | N/A |
+| Side effects | `BlocListener` | `ref.listen` | `Consumer` callback | `ever()`/`once()` | `reaction` | `effect()` | callbacks |
+| Disposal | auto via `BlocProvider` | `.autoDispose` | auto via `Provider` | `onClose()` | `ReactionDisposer` | manual | `dispose()` |
+| Testing | `blocTest()` | `ProviderContainer` | `ChangeNotifier` directly | `Get.put` in test | store directly | signal directly | widget test |
+
+---
+
+## Sources
+
+- [Effective Dart: Style](https://dart.dev/effective-dart/style)
+- [Effective Dart: Usage](https://dart.dev/effective-dart/usage)
+- [Effective Dart: Design](https://dart.dev/effective-dart/design)
+- [Flutter Performance Best Practices](https://docs.flutter.dev/perf/best-practices)
+- [Flutter Testing Overview](https://docs.flutter.dev/testing/overview)
+- [Flutter Accessibility](https://docs.flutter.dev/ui/accessibility-and-internationalization/accessibility)
+- [Flutter Internationalization](https://docs.flutter.dev/ui/accessibility-and-internationalization/internationalization)
+- [Flutter Navigation and Routing](https://docs.flutter.dev/ui/navigation)
+- [Flutter Error Handling](https://docs.flutter.dev/testing/errors)
+- [Flutter State Management Options](https://docs.flutter.dev/data-and-backend/state-mgmt/options)
diff --git a/.agents/skills/flutter-development/SKILL.md b/.agents/skills/flutter-development/SKILL.md
new file mode 100644
index 0000000..4ca2a37
--- /dev/null
+++ b/.agents/skills/flutter-development/SKILL.md
@@ -0,0 +1,316 @@
+---
+name: flutter-development
+description: Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.
+---
+
+# Flutter Development
+
+## Overview
+
+Create high-performance, visually stunning mobile applications using Flutter with Dart language. Master widget composition, state management patterns, navigation, and API integration.
+
+## When to Use
+
+- Building iOS and Android apps with native performance
+- Designing custom UIs with Flutter's widget system
+- Implementing complex animations and visual effects
+- Rapid app development with hot reload
+- Creating consistent UX across platforms
+
+## Instructions
+
+### 1. **Project Structure & Navigation**
+
+```dart
+// pubspec.yaml
+name: my_flutter_app
+version: 1.0.0
+
+dependencies:
+  flutter:
+    sdk: flutter
+  provider: ^6.0.0
+  http: ^1.1.0
+  go_router: ^12.0.0
+
+// main.dart with GoRouter navigation
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+
+void main() {
+  runApp(const MyApp());
+}
+
+class MyApp extends StatelessWidget {
+  const MyApp({Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp.router(
+      title: 'Flutter App',
+      theme: ThemeData(primarySwatch: Colors.blue, useMaterial3: true),
+      routerConfig: _router,
+    );
+  }
+}
+
+final GoRouter _router = GoRouter(
+  routes: <RouteBase>[
+    GoRoute(
+      path: '/',
+      builder: (context, state) => const HomeScreen(),
+      routes: [
+        GoRoute(
+          path: 'details/:id',
+          builder: (context, state) => DetailsScreen(
+            itemId: state.pathParameters['id']!
+          ),
+        ),
+      ],
+    ),
+    GoRoute(
+      path: '/profile',
+      builder: (context, state) => const ProfileScreen(),
+    ),
+  ],
+);
+```
+
+### 2. **State Management with Provider**
+
+```dart
+import 'package:flutter/material.dart';
+import 'package:http/http.dart' as http;
+import 'dart:convert';
+
+class User {
+  final String id;
+  final String name;
+  final String email;
+
+  User({required this.id, required this.name, required this.email});
+
+  factory User.fromJson(Map<String, dynamic> json) {
+    return User(
+      id: json['id'],
+      name: json['name'],
+      email: json['email'],
+    );
+  }
+}
+
+class UserProvider extends ChangeNotifier {
+  User? _user;
+  bool _isLoading = false;
+  String? _error;
+
+  User? get user => _user;
+  bool get isLoading => _isLoading;
+  String? get error => _error;
+
+  Future<void> fetchUser(String userId) async {
+    _isLoading = true;
+    _error = null;
+    notifyListeners();
+
+    try {
+      final response = await http.get(
+        Uri.parse('https://api.example.com/users/$userId'),
+        headers: {'Content-Type': 'application/json'},
+      );
+
+      if (response.statusCode == 200) {
+        _user = User.fromJson(jsonDecode(response.body));
+      } else {
+        _error = 'Failed to fetch user';
+      }
+    } catch (e) {
+      _error = 'Error: ${e.toString()}';
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+
+  void logout() {
+    _user = null;
+    notifyListeners();
+  }
+}
+
+class ItemsProvider extends ChangeNotifier {
+  List<Map<String, dynamic>> _items = [];
+
+  List<Map<String, dynamic>> get items => _items;
+
+  Future<void> fetchItems() async {
+    try {
+      final response = await http.get(
+        Uri.parse('https://api.example.com/items'),
+      );
+
+      if (response.statusCode == 200) {
+        _items = List<Map<String, dynamic>>.from(
+          jsonDecode(response.body) as List
+        );
+        notifyListeners();
+      }
+    } catch (e) {
+      print('Error fetching items: $e');
+    }
+  }
+}
+```
+
+### 3. **Screens with Provider Integration**
+
+```dart
+class HomeScreen extends StatefulWidget {
+  const HomeScreen({Key? key}) : super(key: key);
+
+  @override
+  State<HomeScreen> createState() => _HomeScreenState();
+}
+
+class _HomeScreenState extends State<HomeScreen> {
+  @override
+  void initState() {
+    super.initState();
+    Future.microtask(() {
+      Provider.of<ItemsProvider>(context, listen: false).fetchItems();
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Home Feed')),
+      body: Consumer<ItemsProvider>(
+        builder: (context, itemsProvider, child) {
+          if (itemsProvider.items.isEmpty) {
+            return const Center(child: Text('No items found'));
+          }
+          return ListView.builder(
+            itemCount: itemsProvider.items.length,
+            itemBuilder: (context, index) {
+              final item = itemsProvider.items[index];
+              return ItemCard(item: item);
+            },
+          );
+        },
+      ),
+    );
+  }
+}
+
+class ItemCard extends StatelessWidget {
+  final Map<String, dynamic> item;
+
+  const ItemCard({required this.item, Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Card(
+      margin: const EdgeInsets.all(8),
+      child: ListTile(
+        title: Text(item['title'] ?? 'Untitled'),
+        subtitle: Text(item['description'] ?? ''),
+        trailing: const Icon(Icons.arrow_forward),
+        onTap: () => context.go('/details/${item['id']}'),
+      ),
+    );
+  }
+}
+
+class DetailsScreen extends StatelessWidget {
+  final String itemId;
+
+  const DetailsScreen({required this.itemId, Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Details')),
+      body: Center(
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            Text('Item ID: $itemId', style: const TextStyle(fontSize: 18)),
+            const SizedBox(height: 16),
+            ElevatedButton(
+              onPressed: () => context.pop(),
+              child: const Text('Go Back'),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class ProfileScreen extends StatelessWidget {
+  const ProfileScreen({Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Profile')),
+      body: Consumer<UserProvider>(
+        builder: (context, userProvider, child) {
+          if (userProvider.isLoading) {
+            return const Center(child: CircularProgressIndicator());
+          }
+          if (userProvider.error != null) {
+            return Center(child: Text('Error: ${userProvider.error}'));
+          }
+          final user = userProvider.user;
+          if (user == null) {
+            return const Center(child: Text('No user data'));
+          }
+          return Padding(
+            padding: const EdgeInsets.all(16),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Text('Name: ${user.name}', style: const TextStyle(fontSize: 18)),
+                Text('Email: ${user.email}', style: const TextStyle(fontSize: 16)),
+                const SizedBox(height: 16),
+                ElevatedButton(
+                  onPressed: () => userProvider.logout(),
+                  child: const Text('Logout'),
+                ),
+              ],
+            ),
+          );
+        },
+      ),
+    );
+  }
+}
+```
+
+## Best Practices
+
+### ✅ DO
+- Use widgets for every UI element
+- Implement proper state management
+- Use const constructors where possible
+- Dispose resources in state lifecycle
+- Test on multiple device sizes
+- Use meaningful widget names
+- Implement error handling
+- Use responsive design patterns
+- Test on both iOS and Android
+- Document custom widgets
+
+### ❌ DON'T
+- Build entire screens in build() method
+- Use setState for complex state logic
+- Make network calls in build()
+- Ignore platform differences
+- Create overly nested widget trees
+- Hardcode strings
+- Ignore performance warnings
+- Skip testing
+- Forget to handle edge cases
+- Deploy without thorough testing
diff --git a/.agents/skills/flutter-expert/SKILL.md b/.agents/skills/flutter-expert/SKILL.md
new file mode 100644
index 0000000..4692d36
--- /dev/null
+++ b/.agents/skills/flutter-expert/SKILL.md
@@ -0,0 +1,200 @@
+---
+name: flutter-expert
+description: Master Flutter development with Dart 3, advanced widgets, and
+  multi-platform deployment. Handles state management, animations, testing, and
+  performance optimization for mobile, web, desktop, and embedded platforms. Use
+  PROACTIVELY for Flutter architecture, UI implementation, or cross-platform
+  features.
+metadata:
+  model: inherit
+---
+
+## Use this skill when
+
+- Working on flutter expert tasks or workflows
+- Needing guidance, best practices, or checklists for flutter expert
+
+## Do not use this skill when
+
+- The task is unrelated to flutter expert
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a Flutter expert specializing in high-performance, multi-platform applications with deep knowledge of the Flutter 2025 ecosystem.
+
+## Purpose
+Expert Flutter developer specializing in Flutter 3.x+, Dart 3.x, and comprehensive multi-platform development. Masters advanced widget composition, performance optimization, and platform-specific integrations while maintaining a unified codebase across mobile, web, desktop, and embedded platforms.
+
+## Capabilities
+
+### Core Flutter Mastery
+- Flutter 3.x multi-platform architecture (mobile, web, desktop, embedded)
+- Widget composition patterns and custom widget creation
+- Impeller rendering engine optimization (replacing Skia)
+- Flutter Engine customization and platform embedding
+- Advanced widget lifecycle management and optimization
+- Custom render objects and painting techniques
+- Material Design 3 and Cupertino design system implementation
+- Accessibility-first widget development with semantic annotations
+
+### Dart Language Expertise
+- Dart 3.x advanced features (patterns, records, sealed classes)
+- Null safety mastery and migration strategies
+- Asynchronous programming with Future, Stream, and Isolate
+- FFI (Foreign Function Interface) for C/C++ integration
+- Extension methods and advanced generic programming
+- Mixins and composition patterns for code reuse
+- Meta-programming with annotations and code generation
+- Memory management and garbage collection optimization
+
+### State Management Excellence
+- **Riverpod 2.x**: Modern provider pattern with compile-time safety
+- **Bloc/Cubit**: Business logic components with event-driven architecture
+- **GetX**: Reactive state management with dependency injection
+- **Provider**: Foundation pattern for simple state sharing
+- **Stacked**: MVVM architecture with service locator pattern
+- **MobX**: Reactive state management with observables
+- **Redux**: Predictable state containers for complex apps
+- Custom state management solutions and hybrid approaches
+
+### Architecture Patterns
+- Clean Architecture with well-defined layer separation
+- Feature-driven development with modular code organization
+- MVVM, MVP, and MVI patterns for presentation layer
+- Repository pattern for data abstraction and caching
+- Dependency injection with GetIt, Injectable, and Riverpod
+- Modular monolith architecture for scalable applications
+- Event-driven architecture with domain events
+- CQRS pattern for complex business logic separation
+
+### Platform Integration Mastery
+- **iOS Integration**: Swift platform channels, Cupertino widgets, App Store optimization
+- **Android Integration**: Kotlin platform channels, Material Design 3, Play Store compliance
+- **Web Platform**: PWA configuration, web-specific optimizations, responsive design
+- **Desktop Platforms**: Windows, macOS, and Linux native features
+- **Embedded Systems**: Custom embedder development and IoT integration
+- Platform channel creation and bidirectional communication
+- Native plugin development and maintenance
+- Method channel, event channel, and basic message channel usage
+
+### Performance Optimization
+- Impeller rendering engine optimization and migration strategies
+- Widget rebuilds minimization with const constructors and keys
+- Memory profiling with Flutter DevTools and custom metrics
+- Image optimization, caching, and lazy loading strategies
+- List virtualization for large datasets with Slivers
+- Isolate usage for CPU-intensive tasks and background processing
+- Build optimization and app bundle size reduction
+- Frame rendering optimization for 60/120fps performance
+
+### Advanced UI & UX Implementation
+- Custom animations with AnimationController and Tween
+- Implicit animations for smooth user interactions
+- Hero animations and shared element transitions
+- Rive and Lottie integration for complex animations
+- Custom painters for complex graphics and charts
+- Responsive design with LayoutBuilder and MediaQuery
+- Adaptive design patterns for multiple form factors
+- Custom themes and design system implementation
+
+### Testing Strategies
+- Comprehensive unit testing with mockito and fake implementations
+- Widget testing with testWidgets and golden file testing
+- Integration testing with Patrol and custom test drivers
+- Performance testing and benchmark creation
+- Accessibility testing with semantic finder
+- Test coverage analysis and reporting
+- Continuous testing in CI/CD pipelines
+- Device farm testing and cloud-based testing solutions
+
+### Data Management & Persistence
+- Local databases with SQLite, Hive, and ObjectBox
+- Drift (formerly Moor) for type-safe database operations
+- SharedPreferences and Secure Storage for app preferences
+- File system operations and document management
+- Cloud storage integration (Firebase, AWS, Google Cloud)
+- Offline-first architecture with synchronization patterns
+- GraphQL integration with Ferry or Artemis
+- REST API integration with Dio and custom interceptors
+
+### DevOps & Deployment
+- CI/CD pipelines with Codemagic, GitHub Actions, and Bitrise
+- Automated testing and deployment workflows
+- Flavors and environment-specific configurations
+- Code signing and certificate management for all platforms
+- App store deployment automation for multiple platforms
+- Over-the-air updates and dynamic feature delivery
+- Performance monitoring and crash reporting integration
+- Analytics implementation and user behavior tracking
+
+### Security & Compliance
+- Secure storage implementation with native keychain integration
+- Certificate pinning and network security best practices
+- Biometric authentication with local_auth plugin
+- Code obfuscation and security hardening techniques
+- GDPR compliance and privacy-first development
+- API security and authentication token management
+- Runtime security and tampering detection
+- Penetration testing and vulnerability assessment
+
+### Advanced Features
+- Machine Learning integration with TensorFlow Lite
+- Computer vision and image processing capabilities
+- Augmented Reality with ARCore and ARKit integration
+- IoT device connectivity and BLE protocol implementation
+- Real-time features with WebSockets and Firebase
+- Background processing and notification handling
+- Deep linking and dynamic link implementation
+- Internationalization and localization best practices
+
+## Behavioral Traits
+- Prioritizes widget composition over inheritance
+- Implements const constructors for optimal performance
+- Uses keys strategically for widget identity management
+- Maintains platform awareness while maximizing code reuse
+- Tests widgets in isolation with comprehensive coverage
+- Profiles performance on real devices across all platforms
+- Follows Material Design 3 and platform-specific guidelines
+- Implements comprehensive error handling and user feedback
+- Considers accessibility throughout the development process
+- Documents code with clear examples and widget usage patterns
+
+## Knowledge Base
+- Flutter 2025 roadmap and upcoming features
+- Dart language evolution and experimental features
+- Impeller rendering engine architecture and optimization
+- Platform-specific API updates and deprecations
+- Performance optimization techniques and profiling tools
+- Modern app architecture patterns and best practices
+- Cross-platform development trade-offs and solutions
+- Accessibility standards and inclusive design principles
+- App store requirements and optimization strategies
+- Emerging technologies integration (AR, ML, IoT)
+
+## Response Approach
+1. **Analyze requirements** for optimal Flutter architecture
+2. **Recommend state management** solution based on complexity
+3. **Provide platform-optimized code** with performance considerations
+4. **Include comprehensive testing** strategies and examples
+5. **Consider accessibility** and inclusive design from the start
+6. **Optimize for performance** across all target platforms
+7. **Plan deployment strategies** for multiple app stores
+8. **Address security and privacy** requirements proactively
+
+## Example Interactions
+- "Architect a Flutter app with clean architecture and Riverpod"
+- "Implement complex animations with custom painters and controllers"
+- "Create a responsive design that adapts to mobile, tablet, and desktop"
+- "Optimize Flutter web performance for production deployment"
+- "Integrate native iOS/Android features with platform channels"
+- "Set up comprehensive testing strategy with golden files"
+- "Implement offline-first data sync with conflict resolution"
+- "Create accessible widgets following Material Design 3 guidelines"
+
+Always use null safety with Dart 3 features. Include comprehensive error handling, loading states, and accessibility annotations.
diff --git a/.agents/skills/frontend-design/LICENSE.txt b/.agents/skills/frontend-design/LICENSE.txt
new file mode 100644
index 0000000..f433b1a
--- /dev/null
+++ b/.agents/skills/frontend-design/LICENSE.txt
@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
diff --git a/.agents/skills/frontend-design/SKILL.md b/.agents/skills/frontend-design/SKILL.md
new file mode 100644
index 0000000..8a5fa03
--- /dev/null
+++ b/.agents/skills/frontend-design/SKILL.md
@@ -0,0 +1,42 @@
+---
+name: frontend-design
+description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
+license: Complete terms in LICENSE.txt
+---
+
+This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.
+
+The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints.
+
+## Design Thinking
+
+Before coding, understand the context and commit to a BOLD aesthetic direction:
+- **Purpose**: What problem does this interface solve? Who uses it?
+- **Tone**: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc. There are so many flavors to choose from. Use these for inspiration but design one that is true to the aesthetic direction.
+- **Constraints**: Technical requirements (framework, performance, accessibility).
+- **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember?
+
+**CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.
+
+Then implement working code (HTML/CSS/JS, React, Vue, etc.) that is:
+- Production-grade and functional
+- Visually striking and memorable
+- Cohesive with a clear aesthetic point-of-view
+- Meticulously refined in every detail
+
+## Frontend Aesthetics Guidelines
+
+Focus on:
+- **Typography**: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics; unexpected, characterful font choices. Pair a distinctive display font with a refined body font.
+- **Color & Theme**: Commit to a cohesive aesthetic. Use CSS variables for consistency. Dominant colors with sharp accents outperform timid, evenly-distributed palettes.
+- **Motion**: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for HTML. Use Motion library for React when available. Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions. Use scroll-triggering and hover states that surprise.
+- **Spatial Composition**: Unexpected layouts. Asymmetry. Overlap. Diagonal flow. Grid-breaking elements. Generous negative space OR controlled density.
+- **Backgrounds & Visual Details**: Create atmosphere and depth rather than defaulting to solid colors. Add contextual effects and textures that match the overall aesthetic. Apply creative forms like gradient meshes, noise textures, geometric patterns, layered transparencies, dramatic shadows, decorative borders, custom cursors, and grain overlays.
+
+NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white backgrounds), predictable layouts and component patterns, and cookie-cutter design that lacks context-specific character.
+
+Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics. NEVER converge on common choices (Space Grotesk, for example) across generations.
+
+**IMPORTANT**: Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details. Elegance comes from executing the vision well.
+
+Remember: Codex is capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision.
diff --git a/.agents/skills/grill-me/SKILL.md b/.agents/skills/grill-me/SKILL.md
new file mode 100644
index 0000000..bd04394
--- /dev/null
+++ b/.agents/skills/grill-me/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: grill-me
+description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
+---
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
diff --git a/.agents/skills/grill-with-docs/ADR-FORMAT.md b/.agents/skills/grill-with-docs/ADR-FORMAT.md
new file mode 100644
index 0000000..da7e78e
--- /dev/null
+++ b/.agents/skills/grill-with-docs/ADR-FORMAT.md
@@ -0,0 +1,47 @@
+# ADR Format
+
+ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
+
+Create the `docs/adr/` directory lazily — only when the first ADR is needed.
+
+## Template
+
+```md
+# {Short title of the decision}
+
+{1-3 sentences: what's the context, what did we decide, and why.}
+```
+
+That's it. An ADR can be a single paragraph. The value is in recording *that* a decision was made and *why* — not in filling out sections.
+
+## Optional sections
+
+Only include these when they add genuine value. Most ADRs won't need them.
+
+- **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited
+- **Considered Options** — only when the rejected alternatives are worth remembering
+- **Consequences** — only when non-obvious downstream effects need to be called out
+
+## Numbering
+
+Scan `docs/adr/` for the highest existing number and increment by one.
+
+## When to offer an ADR
+
+All three of these must be true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing."
+
+### What qualifies
+
+- **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres."
+- **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP."
+- **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out.
+- **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s.
+- **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate.
+- **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract."
+- **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months.
diff --git a/.agents/skills/grill-with-docs/CONTEXT-FORMAT.md b/.agents/skills/grill-with-docs/CONTEXT-FORMAT.md
new file mode 100644
index 0000000..ddfa247
--- /dev/null
+++ b/.agents/skills/grill-with-docs/CONTEXT-FORMAT.md
@@ -0,0 +1,77 @@
+# CONTEXT.md Format
+
+## Structure
+
+```md
+# {Context Name}
+
+{One or two sentence description of what this context is and why it exists.}
+
+## Language
+
+**Order**:
+{A concise description of the term}
+_Avoid_: Purchase, transaction
+
+**Invoice**:
+A request for payment sent to a customer after delivery.
+_Avoid_: Bill, payment request
+
+**Customer**:
+A person or organization that places orders.
+_Avoid_: Client, buyer, account
+
+## Relationships
+
+- An **Order** produces one or more **Invoices**
+- An **Invoice** belongs to exactly one **Customer**
+
+## Example dialogue
+
+> **Dev:** "When a **Customer** places an **Order**, do we create the **Invoice** immediately?"
+> **Domain expert:** "No — an **Invoice** is only generated once a **Fulfillment** is confirmed."
+
+## Flagged ambiguities
+
+- "account" was used to mean both **Customer** and **User** — resolved: these are distinct concepts.
+```
+
+## Rules
+
+- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others as aliases to avoid.
+- **Flag conflicts explicitly.** If a term is used ambiguously, call it out in "Flagged ambiguities" with a clear resolution.
+- **Keep definitions tight.** One sentence max. Define what it IS, not what it does.
+- **Show relationships.** Use bold term names and express cardinality where obvious.
+- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
+- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
+- **Write an example dialogue.** A conversation between a dev and a domain expert that demonstrates how the terms interact naturally and clarifies boundaries between related concepts.
+
+## Single vs multi-context repos
+
+**Single context (most repos):** One `CONTEXT.md` at the repo root.
+
+**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
+
+```md
+# Context Map
+
+## Contexts
+
+- [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders
+- [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments
+- [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping
+
+## Relationships
+
+- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
+- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
+- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
+```
+
+The skill infers which structure applies:
+
+- If `CONTEXT-MAP.md` exists, read it to find contexts
+- If only a root `CONTEXT.md` exists, single context
+- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
+
+When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
diff --git a/.agents/skills/grill-with-docs/SKILL.md b/.agents/skills/grill-with-docs/SKILL.md
new file mode 100644
index 0000000..5ea0aa9
--- /dev/null
+++ b/.agents/skills/grill-with-docs/SKILL.md
@@ -0,0 +1,88 @@
+---
+name: grill-with-docs
+description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
+---
+
+<what-to-do>
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time, waiting for feedback on each question before continuing.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
+
+</what-to-do>
+
+<supporting-info>
+
+## Domain awareness
+
+During codebase exploration, also look for existing documentation:
+
+### File structure
+
+Most repos have a single context:
+
+```
+/
+├── CONTEXT.md
+├── docs/
+│   └── adr/
+│       ├── 0001-event-sourced-orders.md
+│       └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/
+│   └── adr/                          ← system-wide decisions
+├── src/
+│   ├── ordering/
+│   │   ├── CONTEXT.md
+│   │   └── docs/adr/                 ← context-specific decisions
+│   └── billing/
+│       ├── CONTEXT.md
+│       └── docs/adr/
+```
+
+Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
+
+## During the session
+
+### Challenge against the glossary
+
+When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"
+
+### Sharpen fuzzy language
+
+When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things."
+
+### Discuss concrete scenarios
+
+When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
+
+### Cross-reference with code
+
+When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible — which is right?"
+
+### Update CONTEXT.md inline
+
+When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
+
+`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
+
+### Offer ADRs sparingly
+
+Only offer to create an ADR when all three are true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will wonder "why did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md).
+
+</supporting-info>
diff --git a/.agents/skills/handoff/SKILL.md b/.agents/skills/handoff/SKILL.md
new file mode 100644
index 0000000..28bfb3a
--- /dev/null
+++ b/.agents/skills/handoff/SKILL.md
@@ -0,0 +1,13 @@
+---
+name: handoff
+description: Compact the current conversation into a handoff document for another agent to pick up.
+argument-hint: "What will the next session be used for?"
+---
+
+Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it).
+
+Suggest the skills to be used, if any, by the next session.
+
+Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+
+If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
diff --git a/.agents/skills/improve-codebase-architecture/DEEPENING.md b/.agents/skills/improve-codebase-architecture/DEEPENING.md
new file mode 100644
index 0000000..ecaf5d7
--- /dev/null
+++ b/.agents/skills/improve-codebase-architecture/DEEPENING.md
@@ -0,0 +1,37 @@
+# Deepening
+
+How to deepen a cluster of shallow modules safely, given its dependencies. Assumes the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**.
+
+## Dependency categories
+
+When assessing a candidate for deepening, classify its dependencies. The category determines how the deepened module is tested across its seam.
+
+### 1. In-process
+
+Pure computation, in-memory state, no I/O. Always deepenable — merge the modules and test through the new interface directly. No adapter needed.
+
+### 2. Local-substitutable
+
+Dependencies that have local test stand-ins (PGLite for Postgres, in-memory filesystem). Deepenable if the stand-in exists. The deepened module is tested with the stand-in running in the test suite. The seam is internal; no port at the module's external interface.
+
+### 3. Remote but owned (Ports & Adapters)
+
+Your own services across a network boundary (microservices, internal APIs). Define a **port** (interface) at the seam. The deep module owns the logic; the transport is injected as an **adapter**. Tests use an in-memory adapter. Production uses an HTTP/gRPC/queue adapter.
+
+Recommendation shape: *"Define a port at the seam, implement an HTTP adapter for production and an in-memory adapter for testing, so the logic sits in one deep module even though it's deployed across a network."*
+
+### 4. True external (Mock)
+
+Third-party services (Stripe, Twilio, etc.) you don't control. The deepened module takes the external dependency as an injected port; tests provide a mock adapter.
+
+## Seam discipline
+
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a port unless at least two adapters are justified (typically production + test). A single-adapter seam is just indirection.
+- **Internal seams vs external seams.** A deep module can have internal seams (private to its implementation, used by its own tests) as well as the external seam at its interface. Don't expose internal seams through the interface just because tests use them.
+
+## Testing strategy: replace, don't layer
+
+- Old unit tests on shallow modules become waste once tests at the deepened module's interface exist — delete them.
+- Write new tests at the deepened module's interface. The **interface is the test surface**.
+- Tests assert on observable outcomes through the interface, not internal state.
+- Tests should survive internal refactors — they describe behaviour, not implementation. If a test has to change when the implementation changes, it's testing past the interface.
diff --git a/.agents/skills/improve-codebase-architecture/INTERFACE-DESIGN.md b/.agents/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
new file mode 100644
index 0000000..3197723
--- /dev/null
+++ b/.agents/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
@@ -0,0 +1,44 @@
+# Interface Design
+
+When the user wants to explore alternative interfaces for a chosen deepening candidate, use this parallel sub-agent pattern. Based on "Design It Twice" (Ousterhout) — your first idea is unlikely to be the best.
+
+Uses the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**, **leverage**.
+
+## Process
+
+### 1. Frame the problem space
+
+Before spawning sub-agents, write a user-facing explanation of the problem space for the chosen candidate:
+
+- The constraints any new interface would need to satisfy
+- The dependencies it would rely on, and which category they fall into (see [DEEPENING.md](DEEPENING.md))
+- A rough illustrative code sketch to ground the constraints — not a proposal, just a way to make the constraints concrete
+
+Show this to the user, then immediately proceed to Step 2. The user reads and thinks while the sub-agents work in parallel.
+
+### 2. Spawn sub-agents
+
+Spawn 3+ sub-agents in parallel using the Agent tool. Each must produce a **radically different** interface for the deepened module.
+
+Prompt each sub-agent with a separate technical brief (file paths, coupling details, dependency category from [DEEPENING.md](DEEPENING.md), what sits behind the seam). The brief is independent of the user-facing problem-space explanation in Step 1. Give each agent a different design constraint:
+
+- Agent 1: "Minimize the interface — aim for 1–3 entry points max. Maximise leverage per entry point."
+- Agent 2: "Maximise flexibility — support many use cases and extension."
+- Agent 3: "Optimise for the most common caller — make the default case trivial."
+- Agent 4 (if applicable): "Design around ports & adapters for cross-seam dependencies."
+
+Include both [LANGUAGE.md](LANGUAGE.md) vocabulary and CONTEXT.md vocabulary in the brief so each sub-agent names things consistently with the architecture language and the project's domain language.
+
+Each sub-agent outputs:
+
+1. Interface (types, methods, params — plus invariants, ordering, error modes)
+2. Usage example showing how callers use it
+3. What the implementation hides behind the seam
+4. Dependency strategy and adapters (see [DEEPENING.md](DEEPENING.md))
+5. Trade-offs — where leverage is high, where it's thin
+
+### 3. Present and compare
+
+Present designs sequentially so the user can absorb each one, then compare them in prose. Contrast by **depth** (leverage at the interface), **locality** (where change concentrates), and **seam placement**.
+
+After comparing, give your own recommendation: which design you think is strongest and why. If elements from different designs would combine well, propose a hybrid. Be opinionated — the user wants a strong read, not a menu.
diff --git a/.agents/skills/improve-codebase-architecture/LANGUAGE.md b/.agents/skills/improve-codebase-architecture/LANGUAGE.md
new file mode 100644
index 0000000..530c276
--- /dev/null
+++ b/.agents/skills/improve-codebase-architecture/LANGUAGE.md
@@ -0,0 +1,53 @@
+# Language
+
+Shared vocabulary for every suggestion this skill makes. Use these terms exactly — don't substitute "component," "service," "API," or "boundary." Consistent language is the whole point.
+
+## Terms
+
+**Module**
+Anything with an interface and an implementation. Deliberately scale-agnostic — applies equally to a function, class, package, or tier-spanning slice.
+_Avoid_: unit, component, service.
+
+**Interface**
+Everything a caller must know to use the module correctly. Includes the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics.
+_Avoid_: API, signature (too narrow — those refer only to the type-level surface).
+
+**Implementation**
+What's inside a module — its body of code. Distinct from **Adapter**: a thing can be a small adapter with a large implementation (a Postgres repo) or a large adapter with a small implementation (an in-memory fake). Reach for "adapter" when the seam is the topic; "implementation" otherwise.
+
+**Depth**
+Leverage at the interface — the amount of behaviour a caller (or test) can exercise per unit of interface they have to learn. A module is **deep** when a large amount of behaviour sits behind a small interface. A module is **shallow** when the interface is nearly as complex as the implementation.
+
+**Seam** _(from Michael Feathers)_
+A place where you can alter behaviour without editing in that place. The *location* at which a module's interface lives. Choosing where to put the seam is its own design decision, distinct from what goes behind it.
+_Avoid_: boundary (overloaded with DDD's bounded context).
+
+**Adapter**
+A concrete thing that satisfies an interface at a seam. Describes *role* (what slot it fills), not substance (what's inside).
+
+**Leverage**
+What callers get from depth. More capability per unit of interface they have to learn. One implementation pays back across N call sites and M tests.
+
+**Locality**
+What maintainers get from depth. Change, bugs, knowledge, and verification concentrate at one place rather than spreading across callers. Fix once, fixed everywhere.
+
+## Principles
+
+- **Depth is a property of the interface, not the implementation.** A deep module can be internally composed of small, mockable, swappable parts — they just aren't part of the interface. A module can have **internal seams** (private to its implementation, used by its own tests) as well as the **external seam** at its interface.
+- **The deletion test.** Imagine deleting the module. If complexity vanishes, the module wasn't hiding anything (it was a pass-through). If complexity reappears across N callers, the module was earning its keep.
+- **The interface is the test surface.** Callers and tests cross the same seam. If you want to test *past* the interface, the module is probably the wrong shape.
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a seam unless something actually varies across it.
+
+## Relationships
+
+- A **Module** has exactly one **Interface** (the surface it presents to callers and tests).
+- **Depth** is a property of a **Module**, measured against its **Interface**.
+- A **Seam** is where a **Module**'s **Interface** lives.
+- An **Adapter** sits at a **Seam** and satisfies the **Interface**.
+- **Depth** produces **Leverage** for callers and **Locality** for maintainers.
+
+## Rejected framings
+
+- **Depth as ratio of implementation-lines to interface-lines** (Ousterhout): rewards padding the implementation. We use depth-as-leverage instead.
+- **"Interface" as the TypeScript `interface` keyword or a class's public methods**: too narrow — interface here includes every fact a caller must know.
+- **"Boundary"**: overloaded with DDD's bounded context. Say **seam** or **interface**.
diff --git a/.agents/skills/improve-codebase-architecture/SKILL.md b/.agents/skills/improve-codebase-architecture/SKILL.md
new file mode 100644
index 0000000..05984a6
--- /dev/null
+++ b/.agents/skills/improve-codebase-architecture/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: improve-codebase-architecture
+description: Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
+---
+
+# Improve Codebase Architecture
+
+Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
+
+## Glossary
+
+Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).
+
+- **Module** — anything with an interface and an implementation (function, class, package, slice).
+- **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
+- **Implementation** — the code inside.
+- **Depth** — leverage at the interface: a lot of behaviour behind a small interface. **Deep** = high leverage. **Shallow** = interface nearly as complex as the implementation.
+- **Seam** — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.")
+- **Adapter** — a concrete thing satisfying an interface at a seam.
+- **Leverage** — what callers get from depth.
+- **Locality** — what maintainers get from depth: change, bugs, knowledge concentrated in one place.
+
+Key principles (see [LANGUAGE.md](LANGUAGE.md) for the full list):
+
+- **Deletion test**: imagine deleting the module. If complexity vanishes, it was a pass-through. If complexity reappears across N callers, it was earning its keep.
+- **The interface is the test surface.**
+- **One adapter = hypothetical seam. Two adapters = real seam.**
+
+This skill is _informed_ by the project's domain model. The domain language gives names to good seams; ADRs record decisions the skill should not re-litigate.
+
+## Process
+
+### 1. Explore
+
+Read the project's domain glossary and any ADRs in the area you're touching first.
+
+Then use the Agent tool with `subagent_type=Explore` to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction:
+
+- Where does understanding one concept require bouncing between many small modules?
+- Where are modules **shallow** — interface nearly as complex as the implementation?
+- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no **locality**)?
+- Where do tightly-coupled modules leak across their seams?
+- Which parts of the codebase are untested, or hard to test through their current interface?
+
+Apply the **deletion test** to anything you suspect is shallow: would deleting it concentrate complexity, or just move it? A "yes, concentrates" is the signal you want.
+
+### 2. Present candidates
+
+Present a numbered list of deepening opportunities. For each candidate:
+
+- **Files** — which files/modules are involved
+- **Problem** — why the current architecture is causing friction
+- **Solution** — plain English description of what would change
+- **Benefits** — explained in terms of locality and leverage, and also in how tests would improve
+
+**Use CONTEXT.md vocabulary for the domain, and [LANGUAGE.md](LANGUAGE.md) vocabulary for the architecture.** If `CONTEXT.md` defines "Order," talk about "the Order intake module" — not "the FooBarHandler," and not "the Order service."
+
+**ADR conflicts**: if a candidate contradicts an existing ADR, only surface it when the friction is real enough to warrant revisiting the ADR. Mark it clearly (e.g. _"contradicts ADR-0007 — but worth reopening because…"_). Don't list every theoretical refactor an ADR forbids.
+
+Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
+
+### 3. Grilling loop
+
+Once the user picks a candidate, drop into a grilling conversation. Walk the design tree with them — constraints, dependencies, the shape of the deepened module, what sits behind the seam, what tests survive.
+
+Side effects happen inline as decisions crystallize:
+
+- **Naming a deepened module after a concept not in `CONTEXT.md`?** Add the term to `CONTEXT.md` — same discipline as `/grill-with-docs` (see [CONTEXT-FORMAT.md](../grill-with-docs/CONTEXT-FORMAT.md)). Create the file lazily if it doesn't exist.
+- **Sharpening a fuzzy term during the conversation?** Update `CONTEXT.md` right there.
+- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer to avoid re-suggesting the same thing — skip ephemeral reasons ("not worth it right now") and self-evident ones. See [ADR-FORMAT.md](../grill-with-docs/ADR-FORMAT.md).
+- **Want to explore alternative interfaces for the deepened module?** See [INTERFACE-DESIGN.md](INTERFACE-DESIGN.md).
diff --git a/.agents/skills/mobile-android-design/SKILL.md b/.agents/skills/mobile-android-design/SKILL.md
new file mode 100644
index 0000000..316f16b
--- /dev/null
+++ b/.agents/skills/mobile-android-design/SKILL.md
@@ -0,0 +1,440 @@
+---
+name: mobile-android-design
+description: Master Material Design 3 and Jetpack Compose patterns for building native Android apps. Use when designing Android interfaces, implementing Compose UI, or following Google's Material Design guidelines.
+---
+
+# Android Mobile Design
+
+Master Material Design 3 (Material You) and Jetpack Compose to build modern, adaptive Android applications that integrate seamlessly with the Android ecosystem.
+
+## When to Use This Skill
+
+- Designing Android app interfaces following Material Design 3
+- Building Jetpack Compose UI and layouts
+- Implementing Android navigation patterns (Navigation Compose)
+- Creating adaptive layouts for phones, tablets, and foldables
+- Using Material 3 theming with dynamic colors
+- Building accessible Android interfaces
+- Implementing Android-specific gestures and interactions
+- Designing for different screen configurations
+
+## Core Concepts
+
+### 1. Material Design 3 Principles
+
+**Personalization**: Dynamic color adapts UI to user's wallpaper
+**Accessibility**: Tonal palettes ensure sufficient color contrast
+**Large Screens**: Responsive layouts for tablets and foldables
+
+**Material Components:**
+
+- Cards, Buttons, FABs, Chips
+- Navigation (rail, drawer, bottom nav)
+- Text fields, Dialogs, Sheets
+- Lists, Menus, Progress indicators
+
+### 2. Jetpack Compose Layout System
+
+**Column and Row:**
+
+```kotlin
+// Vertical arrangement with alignment
+Column(
+    modifier = Modifier.padding(16.dp),
+    verticalArrangement = Arrangement.spacedBy(12.dp),
+    horizontalAlignment = Alignment.Start
+) {
+    Text(
+        text = "Title",
+        style = MaterialTheme.typography.headlineSmall
+    )
+    Text(
+        text = "Subtitle",
+        style = MaterialTheme.typography.bodyMedium,
+        color = MaterialTheme.colorScheme.onSurfaceVariant
+    )
+}
+
+// Horizontal arrangement with weight
+Row(
+    modifier = Modifier.fillMaxWidth(),
+    horizontalArrangement = Arrangement.SpaceBetween,
+    verticalAlignment = Alignment.CenterVertically
+) {
+    Icon(Icons.Default.Star, contentDescription = null)
+    Text("Featured")
+    Spacer(modifier = Modifier.weight(1f))
+    TextButton(onClick = {}) {
+        Text("View All")
+    }
+}
+```
+
+**Lazy Lists and Grids:**
+
+```kotlin
+// Lazy column with sticky headers
+LazyColumn {
+    items.groupBy { it.category }.forEach { (category, categoryItems) ->
+        stickyHeader {
+            Text(
+                text = category,
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .background(MaterialTheme.colorScheme.surface)
+                    .padding(16.dp),
+                style = MaterialTheme.typography.titleMedium
+            )
+        }
+        items(categoryItems) { item ->
+            ItemRow(item = item)
+        }
+    }
+}
+
+// Adaptive grid
+LazyVerticalGrid(
+    columns = GridCells.Adaptive(minSize = 150.dp),
+    contentPadding = PaddingValues(16.dp),
+    horizontalArrangement = Arrangement.spacedBy(12.dp),
+    verticalArrangement = Arrangement.spacedBy(12.dp)
+) {
+    items(items) { item ->
+        ItemCard(item = item)
+    }
+}
+```
+
+### 3. Navigation Patterns
+
+**Bottom Navigation:**
+
+```kotlin
+@Composable
+fun MainScreen() {
+    val navController = rememberNavController()
+
+    Scaffold(
+        bottomBar = {
+            NavigationBar {
+                val navBackStackEntry by navController.currentBackStackEntryAsState()
+                val currentDestination = navBackStackEntry?.destination
+
+                NavigationDestination.entries.forEach { destination ->
+                    NavigationBarItem(
+                        icon = { Icon(destination.icon, contentDescription = null) },
+                        label = { Text(destination.label) },
+                        selected = currentDestination?.hierarchy?.any {
+                            it.route == destination.route
+                        } == true,
+                        onClick = {
+                            navController.navigate(destination.route) {
+                                popUpTo(navController.graph.findStartDestination().id) {
+                                    saveState = true
+                                }
+                                launchSingleTop = true
+                                restoreState = true
+                            }
+                        }
+                    )
+                }
+            }
+        }
+    ) { innerPadding ->
+        NavHost(
+            navController = navController,
+            startDestination = NavigationDestination.Home.route,
+            modifier = Modifier.padding(innerPadding)
+        ) {
+            composable(NavigationDestination.Home.route) { HomeScreen() }
+            composable(NavigationDestination.Search.route) { SearchScreen() }
+            composable(NavigationDestination.Profile.route) { ProfileScreen() }
+        }
+    }
+}
+```
+
+**Navigation Drawer:**
+
+```kotlin
+@Composable
+fun DrawerNavigation() {
+    val drawerState = rememberDrawerState(DrawerValue.Closed)
+    val scope = rememberCoroutineScope()
+
+    ModalNavigationDrawer(
+        drawerState = drawerState,
+        drawerContent = {
+            ModalDrawerSheet {
+                Spacer(Modifier.height(12.dp))
+                Text(
+                    "App Name",
+                    modifier = Modifier.padding(16.dp),
+                    style = MaterialTheme.typography.titleLarge
+                )
+                HorizontalDivider()
+
+                NavigationDrawerItem(
+                    icon = { Icon(Icons.Default.Home, null) },
+                    label = { Text("Home") },
+                    selected = true,
+                    onClick = { scope.launch { drawerState.close() } }
+                )
+                NavigationDrawerItem(
+                    icon = { Icon(Icons.Default.Settings, null) },
+                    label = { Text("Settings") },
+                    selected = false,
+                    onClick = { }
+                )
+            }
+        }
+    ) {
+        Scaffold(
+            topBar = {
+                TopAppBar(
+                    title = { Text("Home") },
+                    navigationIcon = {
+                        IconButton(onClick = { scope.launch { drawerState.open() } }) {
+                            Icon(Icons.Default.Menu, contentDescription = "Menu")
+                        }
+                    }
+                )
+            }
+        ) { innerPadding ->
+            Content(modifier = Modifier.padding(innerPadding))
+        }
+    }
+}
+```
+
+### 4. Material 3 Theming
+
+**Color Scheme:**
+
+```kotlin
+// Dynamic color (Android 12+)
+val dynamicColorScheme = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+    val context = LocalContext.current
+    if (darkTheme) dynamicDarkColorScheme(context)
+    else dynamicLightColorScheme(context)
+} else {
+    if (darkTheme) DarkColorScheme else LightColorScheme
+}
+
+// Custom color scheme
+private val LightColorScheme = lightColorScheme(
+    primary = Color(0xFF6750A4),
+    onPrimary = Color.White,
+    primaryContainer = Color(0xFFEADDFF),
+    onPrimaryContainer = Color(0xFF21005D),
+    secondary = Color(0xFF625B71),
+    onSecondary = Color.White,
+    tertiary = Color(0xFF7D5260),
+    onTertiary = Color.White,
+    surface = Color(0xFFFFFBFE),
+    onSurface = Color(0xFF1C1B1F),
+)
+```
+
+**Typography:**
+
+```kotlin
+val AppTypography = Typography(
+    displayLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 57.sp,
+        lineHeight = 64.sp
+    ),
+    headlineMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 28.sp,
+        lineHeight = 36.sp
+    ),
+    titleLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 22.sp,
+        lineHeight = 28.sp
+    ),
+    bodyLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 16.sp,
+        lineHeight = 24.sp
+    ),
+    labelMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 12.sp,
+        lineHeight = 16.sp
+    )
+)
+```
+
+### 5. Component Examples
+
+**Cards:**
+
+```kotlin
+@Composable
+fun FeatureCard(
+    title: String,
+    description: String,
+    imageUrl: String,
+    onClick: () -> Unit
+) {
+    Card(
+        onClick = onClick,
+        modifier = Modifier.fillMaxWidth(),
+        shape = RoundedCornerShape(16.dp),
+        colors = CardDefaults.cardColors(
+            containerColor = MaterialTheme.colorScheme.surfaceVariant
+        )
+    ) {
+        Column {
+            AsyncImage(
+                model = imageUrl,
+                contentDescription = null,
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .height(180.dp),
+                contentScale = ContentScale.Crop
+            )
+            Column(modifier = Modifier.padding(16.dp)) {
+                Text(
+                    text = title,
+                    style = MaterialTheme.typography.titleMedium
+                )
+                Spacer(modifier = Modifier.height(8.dp))
+                Text(
+                    text = description,
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant
+                )
+            }
+        }
+    }
+}
+```
+
+**Buttons:**
+
+```kotlin
+// Filled button (primary action)
+Button(onClick = { }) {
+    Text("Continue")
+}
+
+// Filled tonal button (secondary action)
+FilledTonalButton(onClick = { }) {
+    Icon(Icons.Default.Add, null)
+    Spacer(Modifier.width(8.dp))
+    Text("Add Item")
+}
+
+// Outlined button
+OutlinedButton(onClick = { }) {
+    Text("Cancel")
+}
+
+// Text button
+TextButton(onClick = { }) {
+    Text("Learn More")
+}
+
+// FAB
+FloatingActionButton(
+    onClick = { },
+    containerColor = MaterialTheme.colorScheme.primaryContainer,
+    contentColor = MaterialTheme.colorScheme.onPrimaryContainer
+) {
+    Icon(Icons.Default.Add, contentDescription = "Add")
+}
+```
+
+## Quick Start Component
+
+```kotlin
+@Composable
+fun ItemListCard(
+    item: Item,
+    onItemClick: () -> Unit,
+    modifier: Modifier = Modifier
+) {
+    Card(
+        onClick = onItemClick,
+        modifier = modifier.fillMaxWidth(),
+        shape = RoundedCornerShape(12.dp)
+    ) {
+        Row(
+            modifier = Modifier
+                .padding(16.dp)
+                .fillMaxWidth(),
+            verticalAlignment = Alignment.CenterVertically
+        ) {
+            Box(
+                modifier = Modifier
+                    .size(48.dp)
+                    .clip(CircleShape)
+                    .background(MaterialTheme.colorScheme.primaryContainer),
+                contentAlignment = Alignment.Center
+            ) {
+                Icon(
+                    imageVector = Icons.Default.Star,
+                    contentDescription = null,
+                    tint = MaterialTheme.colorScheme.onPrimaryContainer
+                )
+            }
+
+            Spacer(modifier = Modifier.width(16.dp))
+
+            Column(modifier = Modifier.weight(1f)) {
+                Text(
+                    text = item.title,
+                    style = MaterialTheme.typography.titleMedium
+                )
+                Text(
+                    text = item.subtitle,
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant
+                )
+            }
+
+            Icon(
+                imageVector = Icons.Default.ChevronRight,
+                contentDescription = null,
+                tint = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+        }
+    }
+}
+```
+
+## Best Practices
+
+1. **Use Material Theme**: Access colors via `MaterialTheme.colorScheme` for automatic dark mode support
+2. **Support Dynamic Color**: Enable dynamic color on Android 12+ for personalization
+3. **Adaptive Layouts**: Use `WindowSizeClass` for responsive designs
+4. **Content Descriptions**: Add `contentDescription` to all interactive elements
+5. **Touch Targets**: Minimum 48dp touch targets for accessibility
+6. **State Hoisting**: Hoist state to make components reusable and testable
+7. **Remember Properly**: Use `remember` and `rememberSaveable` appropriately
+8. **Preview Annotations**: Add `@Preview` with different configurations
+
+## Common Issues
+
+- **Recomposition Issues**: Avoid passing unstable lambdas; use `remember`
+- **State Loss**: Use `rememberSaveable` for configuration changes
+- **Performance**: Use `LazyColumn` instead of `Column` for long lists
+- **Theme Leaks**: Ensure `MaterialTheme` wraps all composables
+- **Navigation Crashes**: Handle back press and deep links properly
+- **Memory Leaks**: Cancel coroutines in `DisposableEffect`
+
+## Resources
+
+- [Material Design 3](https://m3.material.io/)
+- [Jetpack Compose Documentation](https://developer.android.com/jetpack/compose)
+- [Compose Samples](https://github.com/android/compose-samples)
+- [Material 3 Compose](https://developer.android.com/jetpack/compose/designsystems/material3)
diff --git a/.agents/skills/mobile-android-design/references/android-navigation.md b/.agents/skills/mobile-android-design/references/android-navigation.md
new file mode 100644
index 0000000..2d77dec
--- /dev/null
+++ b/.agents/skills/mobile-android-design/references/android-navigation.md
@@ -0,0 +1,698 @@
+# Android Navigation Patterns
+
+## Navigation Compose Basics
+
+### Setup and Dependencies
+
+```kotlin
+// build.gradle.kts
+dependencies {
+    implementation("androidx.navigation:navigation-compose:2.7.7")
+    // For type-safe navigation (recommended)
+    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3")
+}
+```
+
+### Basic Navigation
+
+```kotlin
+@Serializable
+object Home
+
+@Serializable
+data class Detail(val itemId: String)
+
+@Serializable
+object Settings
+
+@Composable
+fun AppNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(
+        navController = navController,
+        startDestination = Home
+    ) {
+        composable<Home> {
+            HomeScreen(
+                onItemClick = { itemId ->
+                    navController.navigate(Detail(itemId))
+                },
+                onSettingsClick = {
+                    navController.navigate(Settings)
+                }
+            )
+        }
+
+        composable<Detail> { backStackEntry ->
+            val detail: Detail = backStackEntry.toRoute()
+            DetailScreen(
+                itemId = detail.itemId,
+                onBack = { navController.popBackStack() }
+            )
+        }
+
+        composable<Settings> {
+            SettingsScreen(
+                onBack = { navController.popBackStack() }
+            )
+        }
+    }
+}
+```
+
+### Navigation with Arguments
+
+```kotlin
+// Type-safe routes with arguments
+@Serializable
+data class ProductDetail(
+    val productId: String,
+    val category: String,
+    val fromSearch: Boolean = false
+)
+
+@Serializable
+data class UserProfile(
+    val userId: Long
+)
+
+@Composable
+fun NavigationWithArgs() {
+    val navController = rememberNavController()
+
+    NavHost(navController = navController, startDestination = Home) {
+        composable<Home> {
+            HomeScreen(
+                onProductClick = { productId, category ->
+                    navController.navigate(
+                        ProductDetail(
+                            productId = productId,
+                            category = category,
+                            fromSearch = false
+                        )
+                    )
+                }
+            )
+        }
+
+        composable<ProductDetail> { backStackEntry ->
+            val args: ProductDetail = backStackEntry.toRoute()
+            ProductDetailScreen(
+                productId = args.productId,
+                category = args.category,
+                showBackToSearch = args.fromSearch
+            )
+        }
+
+        composable<UserProfile> { backStackEntry ->
+            val args: UserProfile = backStackEntry.toRoute()
+            UserProfileScreen(userId = args.userId)
+        }
+    }
+}
+```
+
+## Bottom Navigation
+
+### Standard Implementation
+
+```kotlin
+enum class BottomNavDestination(
+    val route: Any,
+    val icon: ImageVector,
+    val label: String
+) {
+    HOME(Home, Icons.Default.Home, "Home"),
+    SEARCH(Search, Icons.Default.Search, "Search"),
+    FAVORITES(Favorites, Icons.Default.Favorite, "Favorites"),
+    PROFILE(Profile, Icons.Default.Person, "Profile")
+}
+
+@Composable
+fun MainScreenWithBottomNav() {
+    val navController = rememberNavController()
+    val navBackStackEntry by navController.currentBackStackEntryAsState()
+    val currentDestination = navBackStackEntry?.destination
+
+    Scaffold(
+        bottomBar = {
+            NavigationBar {
+                BottomNavDestination.entries.forEach { destination ->
+                    NavigationBarItem(
+                        icon = {
+                            Icon(destination.icon, contentDescription = destination.label)
+                        },
+                        label = { Text(destination.label) },
+                        selected = currentDestination?.hasRoute(destination.route::class) == true,
+                        onClick = {
+                            navController.navigate(destination.route) {
+                                // Pop up to start destination to avoid building up stack
+                                popUpTo(navController.graph.findStartDestination().id) {
+                                    saveState = true
+                                }
+                                // Avoid multiple copies of same destination
+                                launchSingleTop = true
+                                // Restore state when reselecting
+                                restoreState = true
+                            }
+                        }
+                    )
+                }
+            }
+        }
+    ) { innerPadding ->
+        NavHost(
+            navController = navController,
+            startDestination = Home,
+            modifier = Modifier.padding(innerPadding)
+        ) {
+            composable<Home> { HomeScreen() }
+            composable<Search> { SearchScreen() }
+            composable<Favorites> { FavoritesScreen() }
+            composable<Profile> { ProfileScreen() }
+        }
+    }
+}
+```
+
+### Bottom Nav with Badges
+
+```kotlin
+@Composable
+fun BottomNavWithBadges(
+    cartCount: Int,
+    notificationCount: Int
+) {
+    NavigationBar {
+        NavigationBarItem(
+            icon = { Icon(Icons.Default.Home, null) },
+            label = { Text("Home") },
+            selected = true,
+            onClick = { }
+        )
+
+        NavigationBarItem(
+            icon = {
+                BadgedBox(
+                    badge = {
+                        if (cartCount > 0) {
+                            Badge { Text("$cartCount") }
+                        }
+                    }
+                ) {
+                    Icon(Icons.Default.ShoppingCart, null)
+                }
+            },
+            label = { Text("Cart") },
+            selected = false,
+            onClick = { }
+        )
+
+        NavigationBarItem(
+            icon = {
+                BadgedBox(
+                    badge = {
+                        if (notificationCount > 0) {
+                            Badge {
+                                Text(
+                                    if (notificationCount > 99) "99+"
+                                    else "$notificationCount"
+                                )
+                            }
+                        }
+                    }
+                ) {
+                    Icon(Icons.Default.Notifications, null)
+                }
+            },
+            label = { Text("Alerts") },
+            selected = false,
+            onClick = { }
+        )
+    }
+}
+```
+
+## Navigation Drawer
+
+### Modal Navigation Drawer
+
+```kotlin
+@Composable
+fun ModalDrawerNavigation() {
+    val drawerState = rememberDrawerState(initialValue = DrawerValue.Closed)
+    val scope = rememberCoroutineScope()
+    var selectedItem by remember { mutableStateOf(0) }
+
+    val items = listOf(
+        DrawerItem(Icons.Default.Home, "Home"),
+        DrawerItem(Icons.Default.Settings, "Settings"),
+        DrawerItem(Icons.Default.Info, "About"),
+        DrawerItem(Icons.Default.Help, "Help")
+    )
+
+    ModalNavigationDrawer(
+        drawerState = drawerState,
+        drawerContent = {
+            ModalDrawerSheet {
+                // Header
+                Box(
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .height(180.dp)
+                        .background(MaterialTheme.colorScheme.primaryContainer),
+                    contentAlignment = Alignment.BottomStart
+                ) {
+                    Column(modifier = Modifier.padding(16.dp)) {
+                        AsyncImage(
+                            model = "avatar_url",
+                            contentDescription = "Profile",
+                            modifier = Modifier
+                                .size(64.dp)
+                                .clip(CircleShape)
+                        )
+                        Spacer(Modifier.height(8.dp))
+                        Text(
+                            "John Doe",
+                            style = MaterialTheme.typography.titleMedium
+                        )
+                        Text(
+                            "john@example.com",
+                            style = MaterialTheme.typography.bodySmall
+                        )
+                    }
+                }
+
+                Spacer(Modifier.height(12.dp))
+
+                // Navigation items
+                items.forEachIndexed { index, item ->
+                    NavigationDrawerItem(
+                        icon = { Icon(item.icon, contentDescription = null) },
+                        label = { Text(item.label) },
+                        selected = index == selectedItem,
+                        onClick = {
+                            selectedItem = index
+                            scope.launch { drawerState.close() }
+                        },
+                        modifier = Modifier.padding(NavigationDrawerItemDefaults.ItemPadding)
+                    )
+                }
+
+                Spacer(Modifier.weight(1f))
+
+                // Footer
+                HorizontalDivider()
+                NavigationDrawerItem(
+                    icon = { Icon(Icons.Default.Logout, null) },
+                    label = { Text("Sign Out") },
+                    selected = false,
+                    onClick = { },
+                    modifier = Modifier.padding(NavigationDrawerItemDefaults.ItemPadding)
+                )
+                Spacer(Modifier.height(12.dp))
+            }
+        }
+    ) {
+        Scaffold(
+            topBar = {
+                TopAppBar(
+                    title = { Text(items[selectedItem].label) },
+                    navigationIcon = {
+                        IconButton(onClick = { scope.launch { drawerState.open() } }) {
+                            Icon(Icons.Default.Menu, "Open drawer")
+                        }
+                    }
+                )
+            }
+        ) { padding ->
+            Content(modifier = Modifier.padding(padding))
+        }
+    }
+}
+
+data class DrawerItem(val icon: ImageVector, val label: String)
+```
+
+### Permanent Navigation Drawer (Tablets)
+
+```kotlin
+@Composable
+fun PermanentDrawerLayout() {
+    PermanentNavigationDrawer(
+        drawerContent = {
+            PermanentDrawerSheet(
+                modifier = Modifier.width(240.dp)
+            ) {
+                Spacer(Modifier.height(12.dp))
+                Text(
+                    "App Name",
+                    modifier = Modifier.padding(16.dp),
+                    style = MaterialTheme.typography.titleLarge
+                )
+                HorizontalDivider()
+
+                drawerItems.forEach { item ->
+                    NavigationDrawerItem(
+                        icon = { Icon(item.icon, null) },
+                        label = { Text(item.label) },
+                        selected = item == selectedItem,
+                        onClick = { selectedItem = item },
+                        modifier = Modifier.padding(horizontal = 12.dp)
+                    )
+                }
+            }
+        }
+    ) {
+        // Main content takes remaining space
+        MainContent()
+    }
+}
+```
+
+## Navigation Rail
+
+```kotlin
+@Composable
+fun NavigationRailLayout() {
+    var selectedItem by remember { mutableStateOf(0) }
+
+    Row(modifier = Modifier.fillMaxSize()) {
+        NavigationRail(
+            header = {
+                FloatingActionButton(
+                    onClick = { },
+                    elevation = FloatingActionButtonDefaults.bottomAppBarFabElevation()
+                ) {
+                    Icon(Icons.Default.Add, "Create")
+                }
+            }
+        ) {
+            Spacer(Modifier.weight(1f))
+
+            railItems.forEachIndexed { index, item ->
+                NavigationRailItem(
+                    icon = { Icon(item.icon, null) },
+                    label = { Text(item.label) },
+                    selected = selectedItem == index,
+                    onClick = { selectedItem = index }
+                )
+            }
+
+            Spacer(Modifier.weight(1f))
+        }
+
+        // Main content
+        Box(
+            modifier = Modifier
+                .weight(1f)
+                .fillMaxHeight()
+        ) {
+            when (selectedItem) {
+                0 -> HomeContent()
+                1 -> SearchContent()
+                2 -> ProfileContent()
+            }
+        }
+    }
+}
+```
+
+## Deep Linking
+
+### Basic Deep Link Setup
+
+```kotlin
+// In AndroidManifest.xml
+// <intent-filter>
+//     <action android:name="android.intent.action.VIEW" />
+//     <category android:name="android.intent.category.DEFAULT" />
+//     <category android:name="android.intent.category.BROWSABLE" />
+//     <data android:scheme="myapp" />
+//     <data android:scheme="https" android:host="myapp.com" />
+// </intent-filter>
+
+@Composable
+fun DeepLinkNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(
+        navController = navController,
+        startDestination = Home
+    ) {
+        composable<Home> {
+            HomeScreen()
+        }
+
+        composable<ProductDetail>(
+            deepLinks = listOf(
+                navDeepLink<ProductDetail>(
+                    basePath = "https://myapp.com/product"
+                ),
+                navDeepLink<ProductDetail>(
+                    basePath = "myapp://product"
+                )
+            )
+        ) { backStackEntry ->
+            val args: ProductDetail = backStackEntry.toRoute()
+            ProductDetailScreen(productId = args.productId)
+        }
+
+        composable<UserProfile>(
+            deepLinks = listOf(
+                navDeepLink<UserProfile>(
+                    basePath = "https://myapp.com/user"
+                )
+            )
+        ) { backStackEntry ->
+            val args: UserProfile = backStackEntry.toRoute()
+            UserProfileScreen(userId = args.userId)
+        }
+    }
+}
+```
+
+### Handling Intent in Activity
+
+```kotlin
+class MainActivity : ComponentActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        setContent {
+            AppTheme {
+                val navController = rememberNavController()
+
+                // Handle deep link from intent
+                LaunchedEffect(Unit) {
+                    intent?.data?.let { uri ->
+                        navController.handleDeepLink(intent)
+                    }
+                }
+
+                AppNavigation(navController = navController)
+            }
+        }
+    }
+
+    override fun onNewIntent(intent: Intent) {
+        super.onNewIntent(intent)
+        // Handle new intents when activity is already running
+        setIntent(intent)
+    }
+}
+```
+
+## Nested Navigation
+
+```kotlin
+@Composable
+fun NestedNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(navController = navController, startDestination = MainGraph) {
+        // Main graph with bottom navigation
+        navigation<MainGraph>(startDestination = Home) {
+            composable<Home> {
+                HomeScreen(
+                    onItemClick = { navController.navigate(Detail(it)) }
+                )
+            }
+            composable<Search> { SearchScreen() }
+            composable<Profile> {
+                ProfileScreen(
+                    onSettingsClick = { navController.navigate(SettingsGraph) }
+                )
+            }
+        }
+
+        // Nested detail graph
+        composable<Detail> { backStackEntry ->
+            val args: Detail = backStackEntry.toRoute()
+            DetailScreen(itemId = args.itemId)
+        }
+
+        // Separate settings graph (full screen, no bottom nav)
+        navigation<SettingsGraph>(startDestination = SettingsMain) {
+            composable<SettingsMain> {
+                SettingsScreen(
+                    onAccountClick = { navController.navigate(AccountSettings) },
+                    onNotificationsClick = { navController.navigate(NotificationSettings) }
+                )
+            }
+            composable<AccountSettings> { AccountSettingsScreen() }
+            composable<NotificationSettings> { NotificationSettingsScreen() }
+        }
+    }
+}
+
+@Serializable object MainGraph
+@Serializable object SettingsGraph
+@Serializable object SettingsMain
+@Serializable object AccountSettings
+@Serializable object NotificationSettings
+```
+
+## Navigation State Management
+
+### ViewModel Integration
+
+```kotlin
+@HiltViewModel
+class NavigationViewModel @Inject constructor(
+    private val savedStateHandle: SavedStateHandle
+) : ViewModel() {
+
+    private val _navigationEvents = MutableSharedFlow<NavigationEvent>()
+    val navigationEvents = _navigationEvents.asSharedFlow()
+
+    fun navigateToDetail(itemId: String) {
+        viewModelScope.launch {
+            _navigationEvents.emit(NavigationEvent.NavigateToDetail(itemId))
+        }
+    }
+
+    fun navigateBack() {
+        viewModelScope.launch {
+            _navigationEvents.emit(NavigationEvent.NavigateBack)
+        }
+    }
+}
+
+sealed class NavigationEvent {
+    data class NavigateToDetail(val itemId: String) : NavigationEvent()
+    object NavigateBack : NavigationEvent()
+}
+
+@Composable
+fun NavigationHandler(
+    navController: NavHostController,
+    viewModel: NavigationViewModel = hiltViewModel()
+) {
+    LaunchedEffect(Unit) {
+        viewModel.navigationEvents.collect { event ->
+            when (event) {
+                is NavigationEvent.NavigateToDetail -> {
+                    navController.navigate(Detail(event.itemId))
+                }
+                NavigationEvent.NavigateBack -> {
+                    navController.popBackStack()
+                }
+            }
+        }
+    }
+}
+```
+
+### Back Handler
+
+```kotlin
+@Composable
+fun ScreenWithBackHandler(
+    onBack: () -> Unit
+) {
+    var showExitDialog by remember { mutableStateOf(false) }
+
+    // Intercept back press
+    BackHandler {
+        showExitDialog = true
+    }
+
+    if (showExitDialog) {
+        AlertDialog(
+            onDismissRequest = { showExitDialog = false },
+            title = { Text("Exit App?") },
+            text = { Text("Are you sure you want to exit?") },
+            confirmButton = {
+                TextButton(onClick = onBack) {
+                    Text("Exit")
+                }
+            },
+            dismissButton = {
+                TextButton(onClick = { showExitDialog = false }) {
+                    Text("Cancel")
+                }
+            }
+        )
+    }
+
+    // Screen content
+    Content()
+}
+```
+
+## Navigation Animations
+
+```kotlin
+@Composable
+fun AnimatedNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(
+        navController = navController,
+        startDestination = Home,
+        enterTransition = {
+            slideIntoContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Left,
+                animationSpec = tween(300)
+            )
+        },
+        exitTransition = {
+            slideOutOfContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Left,
+                animationSpec = tween(300)
+            )
+        },
+        popEnterTransition = {
+            slideIntoContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Right,
+                animationSpec = tween(300)
+            )
+        },
+        popExitTransition = {
+            slideOutOfContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Right,
+                animationSpec = tween(300)
+            )
+        }
+    ) {
+        composable<Home> {
+            HomeScreen()
+        }
+
+        composable<Detail>(
+            // Custom transition for specific route
+            enterTransition = {
+                fadeIn(animationSpec = tween(500)) +
+                    scaleIn(initialScale = 0.9f, animationSpec = tween(500))
+            },
+            exitTransition = {
+                fadeOut(animationSpec = tween(500))
+            }
+        ) {
+            DetailScreen()
+        }
+    }
+}
+```
diff --git a/.agents/skills/mobile-android-design/references/compose-components.md b/.agents/skills/mobile-android-design/references/compose-components.md
new file mode 100644
index 0000000..3d6ace0
--- /dev/null
+++ b/.agents/skills/mobile-android-design/references/compose-components.md
@@ -0,0 +1,796 @@
+# Jetpack Compose Component Library
+
+## Lists and Collections
+
+### Basic LazyColumn
+
+```kotlin
+@Composable
+fun ItemList(
+    items: List<Item>,
+    onItemClick: (Item) -> Unit,
+    modifier: Modifier = Modifier
+) {
+    LazyColumn(
+        modifier = modifier.fillMaxSize(),
+        contentPadding = PaddingValues(16.dp),
+        verticalArrangement = Arrangement.spacedBy(8.dp)
+    ) {
+        items(
+            items = items,
+            key = { it.id }
+        ) { item ->
+            ItemRow(
+                item = item,
+                onClick = { onItemClick(item) }
+            )
+        }
+    }
+}
+```
+
+### Pull to Refresh
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun RefreshableList(
+    items: List<Item>,
+    isRefreshing: Boolean,
+    onRefresh: () -> Unit
+) {
+    val pullToRefreshState = rememberPullToRefreshState()
+
+    PullToRefreshBox(
+        state = pullToRefreshState,
+        isRefreshing = isRefreshing,
+        onRefresh = onRefresh
+    ) {
+        LazyColumn(
+            modifier = Modifier.fillMaxSize()
+        ) {
+            items(items) { item ->
+                ItemRow(item = item)
+            }
+        }
+    }
+}
+```
+
+### Swipe to Dismiss
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun SwipeableItem(
+    item: Item,
+    onDelete: () -> Unit
+) {
+    val dismissState = rememberSwipeToDismissBoxState(
+        confirmValueChange = { value ->
+            if (value == SwipeToDismissBoxValue.EndToStart) {
+                onDelete()
+                true
+            } else {
+                false
+            }
+        }
+    )
+
+    SwipeToDismissBox(
+        state = dismissState,
+        backgroundContent = {
+            Box(
+                modifier = Modifier
+                    .fillMaxSize()
+                    .background(MaterialTheme.colorScheme.errorContainer)
+                    .padding(horizontal = 20.dp),
+                contentAlignment = Alignment.CenterEnd
+            ) {
+                Icon(
+                    Icons.Default.Delete,
+                    contentDescription = "Delete",
+                    tint = MaterialTheme.colorScheme.onErrorContainer
+                )
+            }
+        }
+    ) {
+        ItemRow(item = item)
+    }
+}
+```
+
+### Sticky Headers
+
+```kotlin
+@OptIn(ExperimentalFoundationApi::class)
+@Composable
+fun GroupedList(
+    groups: Map<String, List<Item>>
+) {
+    LazyColumn {
+        groups.forEach { (header, items) ->
+            stickyHeader {
+                Surface(
+                    modifier = Modifier.fillMaxWidth(),
+                    color = MaterialTheme.colorScheme.surfaceVariant
+                ) {
+                    Text(
+                        text = header,
+                        modifier = Modifier.padding(16.dp),
+                        style = MaterialTheme.typography.titleSmall,
+                        color = MaterialTheme.colorScheme.onSurfaceVariant
+                    )
+                }
+            }
+            items(items, key = { it.id }) { item ->
+                ItemRow(item = item)
+            }
+        }
+    }
+}
+```
+
+## Forms and Input
+
+### Text Fields
+
+```kotlin
+@Composable
+fun LoginForm(
+    onLogin: (email: String, password: String) -> Unit
+) {
+    var email by rememberSaveable { mutableStateOf("") }
+    var password by rememberSaveable { mutableStateOf("") }
+    var passwordVisible by rememberSaveable { mutableStateOf(false) }
+    var emailError by remember { mutableStateOf<String?>(null) }
+
+    Column(
+        modifier = Modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        OutlinedTextField(
+            value = email,
+            onValueChange = {
+                email = it
+                emailError = if (it.isValidEmail()) null else "Invalid email"
+            },
+            label = { Text("Email") },
+            placeholder = { Text("name@example.com") },
+            leadingIcon = { Icon(Icons.Default.Email, null) },
+            isError = emailError != null,
+            supportingText = emailError?.let { { Text(it) } },
+            keyboardOptions = KeyboardOptions(
+                keyboardType = KeyboardType.Email,
+                imeAction = ImeAction.Next
+            ),
+            singleLine = true,
+            modifier = Modifier.fillMaxWidth()
+        )
+
+        OutlinedTextField(
+            value = password,
+            onValueChange = { password = it },
+            label = { Text("Password") },
+            leadingIcon = { Icon(Icons.Default.Lock, null) },
+            trailingIcon = {
+                IconButton(onClick = { passwordVisible = !passwordVisible }) {
+                    Icon(
+                        if (passwordVisible) Icons.Default.VisibilityOff
+                        else Icons.Default.Visibility,
+                        contentDescription = "Toggle password visibility"
+                    )
+                }
+            },
+            visualTransformation = if (passwordVisible)
+                VisualTransformation.None
+            else
+                PasswordVisualTransformation(),
+            keyboardOptions = KeyboardOptions(
+                keyboardType = KeyboardType.Password,
+                imeAction = ImeAction.Done
+            ),
+            singleLine = true,
+            modifier = Modifier.fillMaxWidth()
+        )
+
+        Button(
+            onClick = { onLogin(email, password) },
+            modifier = Modifier.fillMaxWidth(),
+            enabled = email.isNotEmpty() && password.isNotEmpty() && emailError == null
+        ) {
+            Text("Sign In")
+        }
+    }
+}
+```
+
+### Search Bar
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun SearchableScreen(
+    items: List<Item>,
+    onItemClick: (Item) -> Unit
+) {
+    var query by rememberSaveable { mutableStateOf("") }
+    var expanded by rememberSaveable { mutableStateOf(false) }
+
+    val filteredItems = remember(query, items) {
+        if (query.isEmpty()) items
+        else items.filter { it.name.contains(query, ignoreCase = true) }
+    }
+
+    SearchBar(
+        query = query,
+        onQueryChange = { query = it },
+        onSearch = { expanded = false },
+        active = expanded,
+        onActiveChange = { expanded = it },
+        placeholder = { Text("Search items") },
+        leadingIcon = { Icon(Icons.Default.Search, null) },
+        trailingIcon = {
+            if (query.isNotEmpty()) {
+                IconButton(onClick = { query = "" }) {
+                    Icon(Icons.Default.Clear, "Clear search")
+                }
+            }
+        },
+        modifier = Modifier
+            .fillMaxWidth()
+            .padding(horizontal = if (expanded) 0.dp else 16.dp)
+    ) {
+        LazyColumn(
+            modifier = Modifier.fillMaxWidth(),
+            contentPadding = PaddingValues(16.dp)
+        ) {
+            items(filteredItems) { item ->
+                ListItem(
+                    headlineContent = { Text(item.name) },
+                    supportingContent = { Text(item.description) },
+                    modifier = Modifier.clickable {
+                        onItemClick(item)
+                        expanded = false
+                    }
+                )
+            }
+        }
+    }
+}
+```
+
+### Selection Controls
+
+```kotlin
+@Composable
+fun SettingsScreen() {
+    var notificationsEnabled by rememberSaveable { mutableStateOf(true) }
+    var selectedOption by rememberSaveable { mutableStateOf(0) }
+    var expandedDropdown by remember { mutableStateOf(false) }
+    var selectedLanguage by rememberSaveable { mutableStateOf("English") }
+    val languages = listOf("English", "Spanish", "French", "German")
+
+    Column {
+        // Switch
+        ListItem(
+            headlineContent = { Text("Enable Notifications") },
+            supportingContent = { Text("Receive push notifications") },
+            trailingContent = {
+                Switch(
+                    checked = notificationsEnabled,
+                    onCheckedChange = { notificationsEnabled = it }
+                )
+            }
+        )
+
+        HorizontalDivider()
+
+        // Radio buttons
+        Column {
+            Text(
+                "Theme",
+                modifier = Modifier.padding(16.dp),
+                style = MaterialTheme.typography.titleSmall
+            )
+            listOf("System", "Light", "Dark").forEachIndexed { index, option ->
+                Row(
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .selectable(
+                            selected = selectedOption == index,
+                            onClick = { selectedOption = index },
+                            role = Role.RadioButton
+                        )
+                        .padding(horizontal = 16.dp, vertical = 12.dp),
+                    verticalAlignment = Alignment.CenterVertically
+                ) {
+                    RadioButton(
+                        selected = selectedOption == index,
+                        onClick = null
+                    )
+                    Spacer(Modifier.width(16.dp))
+                    Text(option)
+                }
+            }
+        }
+
+        HorizontalDivider()
+
+        // Dropdown
+        ExposedDropdownMenuBox(
+            expanded = expandedDropdown,
+            onExpandedChange = { expandedDropdown = it },
+            modifier = Modifier.padding(16.dp)
+        ) {
+            OutlinedTextField(
+                value = selectedLanguage,
+                onValueChange = {},
+                readOnly = true,
+                label = { Text("Language") },
+                trailingIcon = { ExposedDropdownMenuDefaults.TrailingIcon(expanded = expandedDropdown) },
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .menuAnchor()
+            )
+            ExposedDropdownMenu(
+                expanded = expandedDropdown,
+                onDismissRequest = { expandedDropdown = false }
+            ) {
+                languages.forEach { language ->
+                    DropdownMenuItem(
+                        text = { Text(language) },
+                        onClick = {
+                            selectedLanguage = language
+                            expandedDropdown = false
+                        },
+                        contentPadding = ExposedDropdownMenuDefaults.ItemContentPadding
+                    )
+                }
+            }
+        }
+    }
+}
+```
+
+## Dialogs and Bottom Sheets
+
+### Alert Dialog
+
+```kotlin
+@Composable
+fun DeleteConfirmationDialog(
+    itemName: String,
+    onConfirm: () -> Unit,
+    onDismiss: () -> Unit
+) {
+    AlertDialog(
+        onDismissRequest = onDismiss,
+        icon = {
+            Icon(
+                Icons.Default.Warning,
+                contentDescription = null,
+                tint = MaterialTheme.colorScheme.error
+            )
+        },
+        title = {
+            Text("Delete Item?")
+        },
+        text = {
+            Text("Are you sure you want to delete \"$itemName\"? This action cannot be undone.")
+        },
+        confirmButton = {
+            TextButton(
+                onClick = onConfirm,
+                colors = ButtonDefaults.textButtonColors(
+                    contentColor = MaterialTheme.colorScheme.error
+                )
+            ) {
+                Text("Delete")
+            }
+        },
+        dismissButton = {
+            TextButton(onClick = onDismiss) {
+                Text("Cancel")
+            }
+        }
+    )
+}
+```
+
+### Modal Bottom Sheet
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun OptionsBottomSheet(
+    onDismiss: () -> Unit,
+    onOptionSelected: (String) -> Unit
+) {
+    val sheetState = rememberModalBottomSheetState()
+
+    ModalBottomSheet(
+        onDismissRequest = onDismiss,
+        sheetState = sheetState,
+        dragHandle = { BottomSheetDefaults.DragHandle() }
+    ) {
+        Column(
+            modifier = Modifier
+                .fillMaxWidth()
+                .padding(bottom = 32.dp)
+        ) {
+            Text(
+                "Options",
+                modifier = Modifier.padding(horizontal = 16.dp, vertical = 8.dp),
+                style = MaterialTheme.typography.titleMedium
+            )
+
+            listOf(
+                Triple(Icons.Default.Share, "Share", "share"),
+                Triple(Icons.Default.Edit, "Edit", "edit"),
+                Triple(Icons.Default.FileCopy, "Duplicate", "duplicate"),
+                Triple(Icons.Default.Delete, "Delete", "delete")
+            ).forEach { (icon, label, action) ->
+                ListItem(
+                    headlineContent = { Text(label) },
+                    leadingContent = {
+                        Icon(
+                            icon,
+                            contentDescription = null,
+                            tint = if (action == "delete")
+                                MaterialTheme.colorScheme.error
+                            else
+                                MaterialTheme.colorScheme.onSurfaceVariant
+                        )
+                    },
+                    modifier = Modifier.clickable { onOptionSelected(action) }
+                )
+            }
+        }
+    }
+}
+```
+
+### Date and Time Pickers
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun DateTimePickerExample() {
+    var showDatePicker by remember { mutableStateOf(false) }
+    var showTimePicker by remember { mutableStateOf(false) }
+    val datePickerState = rememberDatePickerState()
+    val timePickerState = rememberTimePickerState()
+
+    Column(modifier = Modifier.padding(16.dp)) {
+        OutlinedButton(onClick = { showDatePicker = true }) {
+            Icon(Icons.Default.CalendarToday, null)
+            Spacer(Modifier.width(8.dp))
+            Text(
+                datePickerState.selectedDateMillis?.let {
+                    SimpleDateFormat("MMM dd, yyyy", Locale.getDefault())
+                        .format(Date(it))
+                } ?: "Select Date"
+            )
+        }
+
+        Spacer(Modifier.height(16.dp))
+
+        OutlinedButton(onClick = { showTimePicker = true }) {
+            Icon(Icons.Default.Schedule, null)
+            Spacer(Modifier.width(8.dp))
+            Text(
+                String.format("%02d:%02d", timePickerState.hour, timePickerState.minute)
+            )
+        }
+    }
+
+    if (showDatePicker) {
+        DatePickerDialog(
+            onDismissRequest = { showDatePicker = false },
+            confirmButton = {
+                TextButton(onClick = { showDatePicker = false }) {
+                    Text("OK")
+                }
+            },
+            dismissButton = {
+                TextButton(onClick = { showDatePicker = false }) {
+                    Text("Cancel")
+                }
+            }
+        ) {
+            DatePicker(state = datePickerState)
+        }
+    }
+
+    if (showTimePicker) {
+        AlertDialog(
+            onDismissRequest = { showTimePicker = false },
+            confirmButton = {
+                TextButton(onClick = { showTimePicker = false }) {
+                    Text("OK")
+                }
+            },
+            dismissButton = {
+                TextButton(onClick = { showTimePicker = false }) {
+                    Text("Cancel")
+                }
+            },
+            text = {
+                TimePicker(state = timePickerState)
+            }
+        )
+    }
+}
+```
+
+## Loading States
+
+### Progress Indicators
+
+```kotlin
+@Composable
+fun LoadingStates() {
+    Column(
+        modifier = Modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(24.dp)
+    ) {
+        // Indeterminate circular
+        CircularProgressIndicator()
+
+        // Determinate circular
+        CircularProgressIndicator(
+            progress = { 0.7f },
+            strokeWidth = 4.dp
+        )
+
+        // Indeterminate linear
+        LinearProgressIndicator(modifier = Modifier.fillMaxWidth())
+
+        // Determinate linear
+        LinearProgressIndicator(
+            progress = { 0.7f },
+            modifier = Modifier.fillMaxWidth()
+        )
+    }
+}
+```
+
+### Skeleton Loading
+
+```kotlin
+@Composable
+fun SkeletonLoader(
+    modifier: Modifier = Modifier
+) {
+    val infiniteTransition = rememberInfiniteTransition(label = "skeleton")
+    val alpha by infiniteTransition.animateFloat(
+        initialValue = 0.3f,
+        targetValue = 0.7f,
+        animationSpec = infiniteRepeatable(
+            animation = tween(1000, easing = LinearEasing),
+            repeatMode = RepeatMode.Reverse
+        ),
+        label = "alpha"
+    )
+
+    Column(
+        modifier = modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(12.dp)
+    ) {
+        repeat(5) {
+            Row(
+                verticalAlignment = Alignment.CenterVertically,
+                horizontalArrangement = Arrangement.spacedBy(12.dp)
+            ) {
+                Box(
+                    modifier = Modifier
+                        .size(48.dp)
+                        .clip(CircleShape)
+                        .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = alpha))
+                )
+                Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
+                    Box(
+                        modifier = Modifier
+                            .height(16.dp)
+                            .fillMaxWidth(0.7f)
+                            .clip(RoundedCornerShape(4.dp))
+                            .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = alpha))
+                    )
+                    Box(
+                        modifier = Modifier
+                            .height(12.dp)
+                            .fillMaxWidth(0.5f)
+                            .clip(RoundedCornerShape(4.dp))
+                            .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = alpha))
+                    )
+                }
+            }
+        }
+    }
+}
+```
+
+### Content Loading Pattern
+
+```kotlin
+@Composable
+fun <T> AsyncContent(
+    state: AsyncState<T>,
+    onRetry: () -> Unit,
+    content: @Composable (T) -> Unit
+) {
+    when (state) {
+        is AsyncState.Loading -> {
+            Box(
+                modifier = Modifier.fillMaxSize(),
+                contentAlignment = Alignment.Center
+            ) {
+                CircularProgressIndicator()
+            }
+        }
+        is AsyncState.Success -> {
+            content(state.data)
+        }
+        is AsyncState.Error -> {
+            Column(
+                modifier = Modifier
+                    .fillMaxSize()
+                    .padding(32.dp),
+                horizontalAlignment = Alignment.CenterHorizontally,
+                verticalArrangement = Arrangement.Center
+            ) {
+                Icon(
+                    Icons.Default.Error,
+                    contentDescription = null,
+                    modifier = Modifier.size(64.dp),
+                    tint = MaterialTheme.colorScheme.error
+                )
+                Spacer(Modifier.height(16.dp))
+                Text(
+                    "Something went wrong",
+                    style = MaterialTheme.typography.titleMedium
+                )
+                Spacer(Modifier.height(8.dp))
+                Text(
+                    state.message,
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant,
+                    textAlign = TextAlign.Center
+                )
+                Spacer(Modifier.height(24.dp))
+                Button(onClick = onRetry) {
+                    Text("Try Again")
+                }
+            }
+        }
+    }
+}
+
+sealed class AsyncState<out T> {
+    object Loading : AsyncState<Nothing>()
+    data class Success<T>(val data: T) : AsyncState<T>()
+    data class Error(val message: String) : AsyncState<Nothing>()
+}
+```
+
+## Animations
+
+### Animated Visibility
+
+```kotlin
+@Composable
+fun ExpandableCard(
+    title: String,
+    content: String
+) {
+    var expanded by rememberSaveable { mutableStateOf(false) }
+
+    Card(
+        modifier = Modifier.fillMaxWidth()
+    ) {
+        Column(
+            modifier = Modifier
+                .clickable { expanded = !expanded }
+                .padding(16.dp)
+        ) {
+            Row(
+                modifier = Modifier.fillMaxWidth(),
+                horizontalArrangement = Arrangement.SpaceBetween,
+                verticalAlignment = Alignment.CenterVertically
+            ) {
+                Text(title, style = MaterialTheme.typography.titleMedium)
+                Icon(
+                    if (expanded) Icons.Default.ExpandLess else Icons.Default.ExpandMore,
+                    contentDescription = if (expanded) "Collapse" else "Expand"
+                )
+            }
+
+            AnimatedVisibility(
+                visible = expanded,
+                enter = expandVertically() + fadeIn(),
+                exit = shrinkVertically() + fadeOut()
+            ) {
+                Text(
+                    text = content,
+                    modifier = Modifier.padding(top = 12.dp),
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant
+                )
+            }
+        }
+    }
+}
+```
+
+### Animated Content
+
+```kotlin
+@Composable
+fun AnimatedCounter(count: Int) {
+    AnimatedContent(
+        targetState = count,
+        transitionSpec = {
+            if (targetState > initialState) {
+                slideInVertically { -it } + fadeIn() togetherWith
+                    slideOutVertically { it } + fadeOut()
+            } else {
+                slideInVertically { it } + fadeIn() togetherWith
+                    slideOutVertically { -it } + fadeOut()
+            }.using(SizeTransform(clip = false))
+        },
+        label = "counter"
+    ) { targetCount ->
+        Text(
+            text = "$targetCount",
+            style = MaterialTheme.typography.displayMedium
+        )
+    }
+}
+```
+
+### Gesture-Based Animation
+
+```kotlin
+@Composable
+fun SwipeableCard(
+    onSwipeLeft: () -> Unit,
+    onSwipeRight: () -> Unit,
+    content: @Composable () -> Unit
+) {
+    var offsetX by remember { mutableFloatStateOf(0f) }
+    val animatedOffset by animateFloatAsState(
+        targetValue = offsetX,
+        animationSpec = spring(dampingRatio = Spring.DampingRatioMediumBouncy),
+        label = "offset"
+    )
+
+    Card(
+        modifier = Modifier
+            .fillMaxWidth()
+            .offset { IntOffset(animatedOffset.roundToInt(), 0) }
+            .pointerInput(Unit) {
+                detectHorizontalDragGestures(
+                    onDragEnd = {
+                        when {
+                            offsetX > 200f -> {
+                                onSwipeRight()
+                                offsetX = 0f
+                            }
+                            offsetX < -200f -> {
+                                onSwipeLeft()
+                                offsetX = 0f
+                            }
+                            else -> offsetX = 0f
+                        }
+                    },
+                    onHorizontalDrag = { _, dragAmount ->
+                        offsetX += dragAmount
+                    }
+                )
+            }
+    ) {
+        content()
+    }
+}
+```
diff --git a/.agents/skills/mobile-android-design/references/material3-theming.md b/.agents/skills/mobile-android-design/references/material3-theming.md
new file mode 100644
index 0000000..bc8b130
--- /dev/null
+++ b/.agents/skills/mobile-android-design/references/material3-theming.md
@@ -0,0 +1,604 @@
+# Material Design 3 Theming
+
+## Color System
+
+### Dynamic Color (Material You)
+
+```kotlin
+@Composable
+fun AppTheme(
+    darkTheme: Boolean = isSystemInDarkTheme(),
+    dynamicColor: Boolean = true,
+    content: @Composable () -> Unit
+) {
+    val colorScheme = when {
+        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
+            val context = LocalContext.current
+            if (darkTheme) dynamicDarkColorScheme(context)
+            else dynamicLightColorScheme(context)
+        }
+        darkTheme -> DarkColorScheme
+        else -> LightColorScheme
+    }
+
+    MaterialTheme(
+        colorScheme = colorScheme,
+        typography = AppTypography,
+        shapes = AppShapes,
+        content = content
+    )
+}
+```
+
+### Custom Color Scheme
+
+```kotlin
+// Define color palette
+val md_theme_light_primary = Color(0xFF6750A4)
+val md_theme_light_onPrimary = Color(0xFFFFFFFF)
+val md_theme_light_primaryContainer = Color(0xFFEADDFF)
+val md_theme_light_onPrimaryContainer = Color(0xFF21005D)
+val md_theme_light_secondary = Color(0xFF625B71)
+val md_theme_light_onSecondary = Color(0xFFFFFFFF)
+val md_theme_light_secondaryContainer = Color(0xFFE8DEF8)
+val md_theme_light_onSecondaryContainer = Color(0xFF1D192B)
+val md_theme_light_tertiary = Color(0xFF7D5260)
+val md_theme_light_onTertiary = Color(0xFFFFFFFF)
+val md_theme_light_tertiaryContainer = Color(0xFFFFD8E4)
+val md_theme_light_onTertiaryContainer = Color(0xFF31111D)
+val md_theme_light_error = Color(0xFFB3261E)
+val md_theme_light_onError = Color(0xFFFFFFFF)
+val md_theme_light_errorContainer = Color(0xFFF9DEDC)
+val md_theme_light_onErrorContainer = Color(0xFF410E0B)
+val md_theme_light_background = Color(0xFFFFFBFE)
+val md_theme_light_onBackground = Color(0xFF1C1B1F)
+val md_theme_light_surface = Color(0xFFFFFBFE)
+val md_theme_light_onSurface = Color(0xFF1C1B1F)
+val md_theme_light_surfaceVariant = Color(0xFFE7E0EC)
+val md_theme_light_onSurfaceVariant = Color(0xFF49454F)
+val md_theme_light_outline = Color(0xFF79747E)
+val md_theme_light_outlineVariant = Color(0xFFCAC4D0)
+
+val LightColorScheme = lightColorScheme(
+    primary = md_theme_light_primary,
+    onPrimary = md_theme_light_onPrimary,
+    primaryContainer = md_theme_light_primaryContainer,
+    onPrimaryContainer = md_theme_light_onPrimaryContainer,
+    secondary = md_theme_light_secondary,
+    onSecondary = md_theme_light_onSecondary,
+    secondaryContainer = md_theme_light_secondaryContainer,
+    onSecondaryContainer = md_theme_light_onSecondaryContainer,
+    tertiary = md_theme_light_tertiary,
+    onTertiary = md_theme_light_onTertiary,
+    tertiaryContainer = md_theme_light_tertiaryContainer,
+    onTertiaryContainer = md_theme_light_onTertiaryContainer,
+    error = md_theme_light_error,
+    onError = md_theme_light_onError,
+    errorContainer = md_theme_light_errorContainer,
+    onErrorContainer = md_theme_light_onErrorContainer,
+    background = md_theme_light_background,
+    onBackground = md_theme_light_onBackground,
+    surface = md_theme_light_surface,
+    onSurface = md_theme_light_onSurface,
+    surfaceVariant = md_theme_light_surfaceVariant,
+    onSurfaceVariant = md_theme_light_onSurfaceVariant,
+    outline = md_theme_light_outline,
+    outlineVariant = md_theme_light_outlineVariant
+)
+
+// Dark colors follow the same pattern
+val DarkColorScheme = darkColorScheme(
+    primary = md_theme_dark_primary,
+    // ... other colors
+)
+```
+
+### Color Roles Usage
+
+```kotlin
+@Composable
+fun ColorRolesExample() {
+    Column(
+        modifier = Modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        // Primary - Key actions, FABs
+        Button(onClick = { }) {
+            Text("Primary Action")
+        }
+
+        // Primary Container - Less prominent containers
+        Surface(
+            color = MaterialTheme.colorScheme.primaryContainer,
+            shape = RoundedCornerShape(12.dp)
+        ) {
+            Text(
+                "Primary Container",
+                modifier = Modifier.padding(16.dp),
+                color = MaterialTheme.colorScheme.onPrimaryContainer
+            )
+        }
+
+        // Secondary - Less prominent actions
+        FilledTonalButton(onClick = { }) {
+            Text("Secondary Action")
+        }
+
+        // Tertiary - Contrast accents
+        Badge(
+            containerColor = MaterialTheme.colorScheme.tertiaryContainer,
+            contentColor = MaterialTheme.colorScheme.onTertiaryContainer
+        ) {
+            Text("New")
+        }
+
+        // Error - Destructive actions
+        Button(
+            onClick = { },
+            colors = ButtonDefaults.buttonColors(
+                containerColor = MaterialTheme.colorScheme.error
+            )
+        ) {
+            Text("Delete")
+        }
+
+        // Surface variants
+        Surface(
+            color = MaterialTheme.colorScheme.surfaceVariant,
+            shape = RoundedCornerShape(8.dp)
+        ) {
+            Text(
+                "Surface Variant",
+                modifier = Modifier.padding(16.dp),
+                color = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+        }
+    }
+}
+```
+
+### Extended Colors
+
+```kotlin
+// Custom semantic colors beyond M3 defaults
+data class ExtendedColors(
+    val success: Color,
+    val onSuccess: Color,
+    val successContainer: Color,
+    val onSuccessContainer: Color,
+    val warning: Color,
+    val onWarning: Color,
+    val warningContainer: Color,
+    val onWarningContainer: Color
+)
+
+val LocalExtendedColors = staticCompositionLocalOf {
+    ExtendedColors(
+        success = Color(0xFF4CAF50),
+        onSuccess = Color.White,
+        successContainer = Color(0xFFE8F5E9),
+        onSuccessContainer = Color(0xFF1B5E20),
+        warning = Color(0xFFFF9800),
+        onWarning = Color.White,
+        warningContainer = Color(0xFFFFF3E0),
+        onWarningContainer = Color(0xFFE65100)
+    )
+}
+
+@Composable
+fun AppTheme(
+    content: @Composable () -> Unit
+) {
+    val extendedColors = ExtendedColors(
+        // ... define colors based on light/dark theme
+    )
+
+    CompositionLocalProvider(
+        LocalExtendedColors provides extendedColors
+    ) {
+        MaterialTheme(
+            colorScheme = colorScheme,
+            content = content
+        )
+    }
+}
+
+// Usage
+@Composable
+fun SuccessBanner() {
+    val extendedColors = LocalExtendedColors.current
+
+    Surface(
+        color = extendedColors.successContainer,
+        shape = RoundedCornerShape(8.dp)
+    ) {
+        Row(
+            modifier = Modifier.padding(16.dp),
+            horizontalArrangement = Arrangement.spacedBy(12.dp)
+        ) {
+            Icon(
+                Icons.Default.CheckCircle,
+                contentDescription = null,
+                tint = extendedColors.success
+            )
+            Text(
+                "Operation successful!",
+                color = extendedColors.onSuccessContainer
+            )
+        }
+    }
+}
+```
+
+## Typography
+
+### Material 3 Type Scale
+
+```kotlin
+val AppTypography = Typography(
+    // Display styles - Hero text, large numerals
+    displayLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 57.sp,
+        lineHeight = 64.sp,
+        letterSpacing = (-0.25).sp
+    ),
+    displayMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 45.sp,
+        lineHeight = 52.sp,
+        letterSpacing = 0.sp
+    ),
+    displaySmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 36.sp,
+        lineHeight = 44.sp,
+        letterSpacing = 0.sp
+    ),
+
+    // Headline styles - High emphasis, short text
+    headlineLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 32.sp,
+        lineHeight = 40.sp,
+        letterSpacing = 0.sp
+    ),
+    headlineMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 28.sp,
+        lineHeight = 36.sp,
+        letterSpacing = 0.sp
+    ),
+    headlineSmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 24.sp,
+        lineHeight = 32.sp,
+        letterSpacing = 0.sp
+    ),
+
+    // Title styles - Medium emphasis headers
+    titleLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 22.sp,
+        lineHeight = 28.sp,
+        letterSpacing = 0.sp
+    ),
+    titleMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 16.sp,
+        lineHeight = 24.sp,
+        letterSpacing = 0.15.sp
+    ),
+    titleSmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 14.sp,
+        lineHeight = 20.sp,
+        letterSpacing = 0.1.sp
+    ),
+
+    // Body styles - Long-form text
+    bodyLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 16.sp,
+        lineHeight = 24.sp,
+        letterSpacing = 0.5.sp
+    ),
+    bodyMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 14.sp,
+        lineHeight = 20.sp,
+        letterSpacing = 0.25.sp
+    ),
+    bodySmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 12.sp,
+        lineHeight = 16.sp,
+        letterSpacing = 0.4.sp
+    ),
+
+    // Label styles - Buttons, chips, navigation
+    labelLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 14.sp,
+        lineHeight = 20.sp,
+        letterSpacing = 0.1.sp
+    ),
+    labelMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 12.sp,
+        lineHeight = 16.sp,
+        letterSpacing = 0.5.sp
+    ),
+    labelSmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 11.sp,
+        lineHeight = 16.sp,
+        letterSpacing = 0.5.sp
+    )
+)
+```
+
+### Custom Fonts
+
+```kotlin
+// Load custom fonts
+val Inter = FontFamily(
+    Font(R.font.inter_regular, FontWeight.Normal),
+    Font(R.font.inter_medium, FontWeight.Medium),
+    Font(R.font.inter_semibold, FontWeight.SemiBold),
+    Font(R.font.inter_bold, FontWeight.Bold)
+)
+
+val AppTypography = Typography(
+    displayLarge = TextStyle(
+        fontFamily = Inter,
+        fontWeight = FontWeight.Normal,
+        fontSize = 57.sp,
+        lineHeight = 64.sp
+    ),
+    // Apply to all styles...
+)
+
+// Variable fonts (Android 12+)
+val InterVariable = FontFamily(
+    Font(
+        R.font.inter_variable,
+        variationSettings = FontVariation.Settings(
+            FontVariation.weight(400)
+        )
+    )
+)
+```
+
+## Shape System
+
+### Material 3 Shapes
+
+```kotlin
+val AppShapes = Shapes(
+    // Extra small - Chips, small buttons
+    extraSmall = RoundedCornerShape(4.dp),
+
+    // Small - Text fields, small cards
+    small = RoundedCornerShape(8.dp),
+
+    // Medium - Cards, dialogs
+    medium = RoundedCornerShape(12.dp),
+
+    // Large - Large cards, bottom sheets
+    large = RoundedCornerShape(16.dp),
+
+    // Extra large - Full-screen dialogs
+    extraLarge = RoundedCornerShape(28.dp)
+)
+```
+
+### Custom Shape Usage
+
+```kotlin
+@Composable
+fun ShapedComponents() {
+    Column(
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        // Small shape for text field
+        OutlinedTextField(
+            value = "",
+            onValueChange = {},
+            shape = MaterialTheme.shapes.small,
+            label = { Text("Input") }
+        )
+
+        // Medium shape for cards
+        Card(
+            shape = MaterialTheme.shapes.medium
+        ) {
+            Text("Card content", modifier = Modifier.padding(16.dp))
+        }
+
+        // Large shape for prominent containers
+        Surface(
+            shape = MaterialTheme.shapes.large,
+            color = MaterialTheme.colorScheme.primaryContainer
+        ) {
+            Text("Featured", modifier = Modifier.padding(24.dp))
+        }
+
+        // Custom asymmetric shape
+        Surface(
+            shape = RoundedCornerShape(
+                topStart = 24.dp,
+                topEnd = 24.dp,
+                bottomStart = 0.dp,
+                bottomEnd = 0.dp
+            ),
+            color = MaterialTheme.colorScheme.surface
+        ) {
+            Text("Bottom sheet style", modifier = Modifier.padding(16.dp))
+        }
+    }
+}
+```
+
+## Elevation and Shadows
+
+### Tonal Elevation
+
+```kotlin
+@Composable
+fun ElevationExample() {
+    Column(
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        // Level 0 - No elevation
+        Surface(
+            tonalElevation = 0.dp,
+            shadowElevation = 0.dp
+        ) {
+            Text("Level 0", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 1 - Low emphasis surfaces
+        Surface(
+            tonalElevation = 1.dp,
+            shadowElevation = 1.dp
+        ) {
+            Text("Level 1", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 2 - Cards, switches
+        Surface(
+            tonalElevation = 3.dp,
+            shadowElevation = 2.dp
+        ) {
+            Text("Level 2", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 3 - Navigation components
+        Surface(
+            tonalElevation = 6.dp,
+            shadowElevation = 4.dp
+        ) {
+            Text("Level 3", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 4 - Navigation rail
+        Surface(
+            tonalElevation = 8.dp,
+            shadowElevation = 6.dp
+        ) {
+            Text("Level 4", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 5 - FAB
+        Surface(
+            tonalElevation = 12.dp,
+            shadowElevation = 8.dp
+        ) {
+            Text("Level 5", modifier = Modifier.padding(16.dp))
+        }
+    }
+}
+```
+
+## Responsive Design
+
+### Window Size Classes
+
+```kotlin
+@Composable
+fun AdaptiveLayout() {
+    val windowSizeClass = calculateWindowSizeClass(LocalContext.current as Activity)
+
+    when (windowSizeClass.widthSizeClass) {
+        WindowWidthSizeClass.Compact -> {
+            // Phone portrait - Single column, bottom nav
+            CompactLayout()
+        }
+        WindowWidthSizeClass.Medium -> {
+            // Tablet portrait, phone landscape - Navigation rail
+            MediumLayout()
+        }
+        WindowWidthSizeClass.Expanded -> {
+            // Tablet landscape, desktop - Navigation drawer, multi-pane
+            ExpandedLayout()
+        }
+    }
+}
+
+@Composable
+fun CompactLayout() {
+    Scaffold(
+        bottomBar = { NavigationBar { /* items */ } }
+    ) { padding ->
+        Content(modifier = Modifier.padding(padding))
+    }
+}
+
+@Composable
+fun MediumLayout() {
+    Row {
+        NavigationRail { /* items */ }
+        Content(modifier = Modifier.weight(1f))
+    }
+}
+
+@Composable
+fun ExpandedLayout() {
+    PermanentNavigationDrawer(
+        drawerContent = {
+            PermanentDrawerSheet { /* items */ }
+        }
+    ) {
+        Row {
+            ListPane(modifier = Modifier.weight(0.4f))
+            DetailPane(modifier = Modifier.weight(0.6f))
+        }
+    }
+}
+```
+
+### Foldable Support
+
+```kotlin
+@Composable
+fun FoldableAwareLayout() {
+    val foldingFeature = LocalFoldingFeature.current
+
+    when {
+        foldingFeature?.state == FoldingFeature.State.HALF_OPENED -> {
+            // Device is half-folded (tabletop mode)
+            TwoHingeLayout(
+                top = { CameraPreview() },
+                bottom = { CameraControls() }
+            )
+        }
+        foldingFeature?.orientation == FoldingFeature.Orientation.VERTICAL -> {
+            // Vertical fold (book mode)
+            TwoPaneLayout(
+                first = { NavigationPane() },
+                second = { ContentPane() }
+            )
+        }
+        else -> {
+            // Regular or fully opened
+            SinglePaneLayout()
+        }
+    }
+}
+```
diff --git a/.agents/skills/mobile-app-debugging/SKILL.md b/.agents/skills/mobile-app-debugging/SKILL.md
new file mode 100644
index 0000000..04e0672
--- /dev/null
+++ b/.agents/skills/mobile-app-debugging/SKILL.md
@@ -0,0 +1,254 @@
+---
+name: mobile-app-debugging
+description: Debug issues specific to mobile applications including platform-specific problems, device constraints, and connectivity issues.
+---
+
+# Mobile App Debugging
+
+## Overview
+
+Mobile app debugging addresses platform-specific issues, device hardware limitations, and mobile-specific network conditions.
+
+## When to Use
+
+- App crashes on mobile
+- Performance issues on device
+- Platform-specific bugs
+- Network connectivity issues
+- Device-specific problems
+
+## Instructions
+
+### 1. **iOS Debugging**
+
+```yaml
+Xcode Debugging:
+
+Attach Debugger:
+  - Xcode → Run on device
+  - Set breakpoints in code
+  - Step through execution
+  - View variables
+  - Console logs
+
+View Logs:
+  - Xcode → Window → Devices & Simulators
+  - Select device → View Device Logs
+  - Filter by app name
+  - Check system logs for crashes
+
+Inspect Memory:
+  - Xcode → Debug → View Memory Graph
+  - Identify retain cycles
+  - Check object count
+  - Monitor allocation growth
+
+---
+
+Common iOS Issues:
+
+App Crash (SIGABRT):
+  Cause: Exception in Objective-C
+  Solution: Check console for error message
+  Debug: Set breakpoint on exception
+
+Memory Warning (SIGKILL):
+  Cause: Too much memory usage
+  Solution: Reduce memory footprint
+  Optimize: Image caching, data structures
+
+Networking:
+  Issue: Network requests fail on device
+  Check: Network connectivity status
+  Solution: Implement Network Link Conditioner
+  Test: Throttle network in Xcode
+```
+
+### 2. **Android Debugging**
+
+```yaml
+Android Studio:
+
+Attach Debugger:
+  - Run → Debug
+  - Set breakpoints
+  - Step through code
+  - Watch variables
+  - Evaluate expressions
+
+Logcat:
+  - Displays all app logs
+  - Filter by tag
+  - Filter by process
+  - Show errors and warnings
+
+Device Monitor:
+  - Memory profiler
+  - CPU profiler
+  - Network profiler
+  - Battery usage
+
+---
+
+Common Android Issues:
+
+App Crash (ANR):
+  Cause: Long-running operation on main thread
+  Solution: Move to background thread
+  Example: Use AsyncTask or coroutines
+
+Memory Leak:
+  Cause: Activity not garbage collected
+  Solution: Clear references in onDestroy
+  Debug: Android Profiler shows retained objects
+
+Networking:
+  Issue: Network requests timeout
+  Check: Network connectivity
+  Solution: Implement timeout and retry
+  Test: Simulate poor network
+```
+
+### 3. **Cross-Platform Issues**
+
+```yaml
+React Native Debugging:
+
+Console Logs:
+  - Run app with: react-native run-android
+  - View logs: adb logcat | grep ReactNativeJS
+  - Or use remote debugger
+
+Remote Debugging:
+  - Shake device → Enable Remote Debugging
+  - Chrome DevTools debugging
+  - Set breakpoints in JS
+  - Inspect state
+
+Performance:
+  - Perf Monitor: Shake → Perf Monitor
+  - Shows FPS, RAM, Bridge traffic
+  - Identify frame drops
+  - Check excessive bridge calls
+
+---
+
+Flutter Debugging:
+
+Device Logs:
+  flutter logs
+  Shows all device and app output
+
+Debugging:
+  flutter run --debug
+  Set breakpoints in IDE
+  Step through code
+
+Hot Reload:
+  Useful for rapid iteration
+  Hot restart for full reload
+  Useful for debugging UI changes
+
+---
+
+Common Mobile Issues:
+
+Network Connectivity:
+  Issue: App works on WiFi, fails on cellular
+  Solution: Test on both networks
+  Debug: Use network throttler
+  Implement: Retry logic, offline support
+
+Device Specific:
+  Issue: Works on simulator, fails on device
+  Solution: Always test on real device
+  Causes:
+    - Memory constraints
+    - Performance differences
+    - Platform differences
+    - Screen size issues
+
+Battery/Memory:
+  Issue: Excessive battery drain
+  Debug: Use power profiler
+  Optimize: Reduce background work
+  Monitor: Location tracking, networking
+```
+
+### 4. **Mobile Testing & Debugging Checklist**
+
+```yaml
+Device Testing:
+
+[ ] Test on both iOS and Android
+[ ] Test on old and new devices
+[ ] Test with poor network (3G throttle)
+[ ] Test in airplane mode
+[ ] Test with low battery
+[ ] Test with low memory
+[ ] Test with location disabled
+[ ] Test with notifications disabled
+[ ] Test rotation changes
+[ ] Test while backgrounded
+
+Performance:
+
+[ ] <16ms per frame (60 FPS)
+[ ] Memory usage <100MB
+[ ] Battery drain acceptable
+[ ] Network requests efficient
+[ ] Background tasks minimal
+
+Networking:
+
+[ ] Works on WiFi
+[ ] Works on cellular
+[ ] Handles network timeouts
+[ ] Handles offline mode
+[ ] Retries failed requests
+[ ] Shows loading indicators
+[ ] Shows error messages
+
+UI/UX:
+
+[ ] Responsive touch targets (44x44 min)
+[ ] Readable text (16pt minimum)
+[ ] Colors accessible
+[ ] Orientation changes handled
+[ ] Keyboard shows/hides correctly
+[ ] Safe areas respected (notches)
+
+---
+
+Tools:
+
+Testing Devices:
+  - iOS: iPhone SE (small), iPhone 12/13 (modern)
+  - Android: Pixel 4 (standard), Pixel 6 (new)
+  - Virtual: Simulators for iteration
+
+Device Management:
+  - TestFlight (iOS)
+  - Google Play Beta (Android)
+  - Firebase Test Lab
+  - BrowserStack
+
+Monitoring:
+  - Crashlytics
+  - Firebase Analytics
+  - App Performance Monitoring
+  - Custom event tracking
+```
+
+## Key Points
+
+- Always test on real devices
+- Simulate poor network conditions
+- Monitor memory and CPU
+- Test on old and new devices
+- Use platform-specific debugging tools
+- Check device logs for crashes
+- Test network edge cases
+- Monitor battery/memory impact
+- Use profilers to identify bottlenecks
+- Implement proper error handling
diff --git a/.agents/skills/mobile-app-testing/SKILL.md b/.agents/skills/mobile-app-testing/SKILL.md
new file mode 100644
index 0000000..00b5cc0
--- /dev/null
+++ b/.agents/skills/mobile-app-testing/SKILL.md
@@ -0,0 +1,344 @@
+---
+name: mobile-app-testing
+description: Comprehensive mobile app testing strategies for iOS and Android. Covers unit tests, UI tests, integration tests, performance testing, and test automation with Detox, Appium, and XCTest.
+---
+
+# Mobile App Testing
+
+## Overview
+
+Implement comprehensive testing strategies for mobile applications including unit tests, UI tests, integration tests, and performance testing.
+
+## When to Use
+
+- Creating reliable mobile applications with test coverage
+- Automating UI testing across iOS and Android
+- Performance testing and optimization
+- Integration testing with backend services
+- Regression testing before releases
+
+## Instructions
+
+### 1. **React Native Testing with Jest & Detox**
+
+```javascript
+// Unit test with Jest
+import { calculate } from '../utils/math';
+
+describe('Math utilities', () => {
+  test('should add two numbers', () => {
+    expect(calculate.add(2, 3)).toBe(5);
+  });
+
+  test('should handle negative numbers', () => {
+    expect(calculate.add(-2, 3)).toBe(1);
+  });
+});
+
+// Component unit test
+import React from 'react';
+import { render, screen } from '@testing-library/react-native';
+import { UserProfile } from '../components/UserProfile';
+
+describe('UserProfile Component', () => {
+  test('renders user name correctly', () => {
+    const mockUser = { id: '1', name: 'John Doe', email: 'john@example.com' };
+    render(<UserProfile user={mockUser} />);
+
+    expect(screen.getByText('John Doe')).toBeTruthy();
+  });
+
+  test('handles missing user gracefully', () => {
+    render(<UserProfile user={null} />);
+    expect(screen.getByText(/no user data/i)).toBeTruthy();
+  });
+});
+
+// E2E Testing with Detox
+describe('Login Flow E2E Test', () => {
+  beforeAll(async () => {
+    await device.launchApp();
+  });
+
+  beforeEach(async () => {
+    await device.reloadReactNative();
+  });
+
+  it('should login successfully with valid credentials', async () => {
+    await waitFor(element(by.id('emailInput')))
+      .toBeVisible()
+      .withTimeout(5000);
+
+    await element(by.id('emailInput')).typeText('user@example.com');
+    await element(by.id('passwordInput')).typeText('password123');
+    await element(by.id('loginButton')).multiTap();
+
+    await waitFor(element(by.text('Home Feed')))
+      .toBeVisible()
+      .withTimeout(5000);
+  });
+
+  it('should show error with invalid credentials', async () => {
+    await element(by.id('emailInput')).typeText('invalid@example.com');
+    await element(by.id('passwordInput')).typeText('wrongpass');
+    await element(by.id('loginButton')).multiTap();
+
+    await waitFor(element(by.text(/invalid credentials/i)))
+      .toBeVisible()
+      .withTimeout(5000);
+  });
+
+  it('should navigate between tabs', async () => {
+    await element(by.id('profileTab')).tap();
+    await waitFor(element(by.text('Profile')))
+      .toBeVisible()
+      .withTimeout(2000);
+
+    await element(by.id('homeTab')).tap();
+    await waitFor(element(by.text('Home Feed')))
+      .toBeVisible()
+      .withTimeout(2000);
+  });
+});
+```
+
+### 2. **iOS Testing with XCTest**
+
+```swift
+import XCTest
+@testable import MyApp
+
+class UserViewModelTests: XCTestCase {
+  var viewModel: UserViewModel!
+  var mockNetworkService: MockNetworkService!
+
+  override func setUp() {
+    super.setUp()
+    mockNetworkService = MockNetworkService()
+    viewModel = UserViewModel(networkService: mockNetworkService)
+  }
+
+  func testFetchUserSuccess() async {
+    let expectedUser = User(id: UUID(), name: "John", email: "john@example.com")
+    mockNetworkService.mockUser = expectedUser
+
+    await viewModel.fetchUser(id: expectedUser.id)
+
+    XCTAssertEqual(viewModel.user?.name, "John")
+    XCTAssertNil(viewModel.errorMessage)
+    XCTAssertFalse(viewModel.isLoading)
+  }
+
+  func testFetchUserFailure() async {
+    mockNetworkService.shouldFail = true
+
+    await viewModel.fetchUser(id: UUID())
+
+    XCTAssertNil(viewModel.user)
+    XCTAssertNotNil(viewModel.errorMessage)
+    XCTAssertFalse(viewModel.isLoading)
+  }
+}
+
+class MockNetworkService: NetworkService {
+  var mockUser: User?
+  var shouldFail = false
+
+  override func fetch<T: Decodable>(
+    _: T.Type,
+    from endpoint: String
+  ) async throws -> T {
+    if shouldFail {
+      throw NetworkError.unknown
+    }
+    return mockUser as! T
+  }
+}
+
+// UI Test
+class LoginUITests: XCTestCase {
+  override func setUp() {
+    super.setUp()
+    continueAfterFailure = false
+    XCUIApplication().launch()
+  }
+
+  func testLoginFlow() {
+    let app = XCUIApplication()
+
+    let emailTextField = app.textFields["emailInput"]
+    let passwordTextField = app.secureTextFields["passwordInput"]
+    let loginButton = app.buttons["loginButton"]
+
+    emailTextField.tap()
+    emailTextField.typeText("user@example.com")
+
+    passwordTextField.tap()
+    passwordTextField.typeText("password123")
+
+    loginButton.tap()
+
+    let homeText = app.staticTexts["Home Feed"]
+    XCTAssertTrue(homeText.waitForExistence(timeout: 5))
+  }
+
+  func testNavigationBetweenTabs() {
+    let app = XCUIApplication()
+    let profileTab = app.tabBars.buttons["Profile"]
+    let homeTab = app.tabBars.buttons["Home"]
+
+    profileTab.tap()
+    XCTAssertTrue(app.staticTexts["Profile"].exists)
+
+    homeTab.tap()
+    XCTAssertTrue(app.staticTexts["Home"].exists)
+  }
+}
+```
+
+### 3. **Android Testing with Espresso**
+
+```kotlin
+@RunWith(AndroidJUnit4::class)
+class UserViewModelTest {
+  private lateinit var viewModel: UserViewModel
+  private val mockApiService = mock<ApiService>()
+
+  @Before
+  fun setUp() {
+    viewModel = UserViewModel(mockApiService)
+  }
+
+  @Test
+  fun fetchUserSuccess() = runTest {
+    val expectedUser = User("1", "John", "john@example.com")
+    `when`(mockApiService.getUser("1")).thenReturn(expectedUser)
+
+    viewModel.fetchUser("1")
+
+    assertEquals(expectedUser.name, viewModel.user.value?.name)
+    assertEquals(null, viewModel.errorMessage.value)
+  }
+
+  @Test
+  fun fetchUserFailure() = runTest {
+    `when`(mockApiService.getUser("1"))
+      .thenThrow(IOException("Network error"))
+
+    viewModel.fetchUser("1")
+
+    assertEquals(null, viewModel.user.value)
+    assertNotNull(viewModel.errorMessage.value)
+  }
+}
+
+// UI Test with Espresso
+@RunWith(AndroidJUnit4::class)
+class LoginActivityTest {
+  @get:Rule
+  val activityRule = ActivityScenarioRule(LoginActivity::class.java)
+
+  @Test
+  fun testLoginWithValidCredentials() {
+    onView(withId(R.id.emailInput))
+      .perform(typeText("user@example.com"))
+
+    onView(withId(R.id.passwordInput))
+      .perform(typeText("password123"))
+
+    onView(withId(R.id.loginButton))
+      .perform(click())
+
+    onView(withText("Home"))
+      .check(matches(isDisplayed()))
+  }
+
+  @Test
+  fun testLoginWithInvalidCredentials() {
+    onView(withId(R.id.emailInput))
+      .perform(typeText("invalid@example.com"))
+
+    onView(withId(R.id.passwordInput))
+      .perform(typeText("wrongpassword"))
+
+    onView(withId(R.id.loginButton))
+      .perform(click())
+
+    onView(withText(containsString("Invalid credentials")))
+      .check(matches(isDisplayed()))
+  }
+
+  @Test
+  fun testNavigationBetweenTabs() {
+    onView(withId(R.id.profileTab)).perform(click())
+    onView(withText("Profile")).check(matches(isDisplayed()))
+
+    onView(withId(R.id.homeTab)).perform(click())
+    onView(withText("Home")).check(matches(isDisplayed()))
+  }
+}
+```
+
+### 4. **Performance Testing**
+
+```swift
+import XCTest
+
+class PerformanceTests: XCTestCase {
+  func testListRenderingPerformance() {
+    let viewModel = ItemsViewModel()
+    viewModel.items = (0..<1000).map { i in
+      Item(id: UUID(), title: "Item \(i)", price: Double(i))
+    }
+
+    measure {
+      _ = viewModel.items.filter { $0.price > 50 }
+    }
+  }
+
+  func testNetworkResponseTime() {
+    let networkService = NetworkService()
+
+    measure {
+      let expectation = XCTestExpectation(description: "Fetch user")
+
+      Task {
+        do {
+          _ = try await networkService.fetch(User.self, from: "/users/test")
+          expectation.fulfill()
+        } catch {
+          XCTFail("Network request failed")
+        }
+      }
+
+      wait(for: [expectation], timeout: 10)
+    }
+  }
+}
+```
+
+## Best Practices
+
+### ✅ DO
+- Write tests for business logic first
+- Use dependency injection for testability
+- Mock external API calls
+- Test both success and failure paths
+- Automate UI testing for critical flows
+- Run tests on real devices
+- Measure performance on target devices
+- Keep tests isolated and independent
+- Use meaningful test names
+- Maintain >80% code coverage
+
+### ❌ DON'T
+- Skip testing UI-critical flows
+- Use hardcoded test data
+- Ignore performance regressions
+- Test implementation details
+- Make tests flaky or unreliable
+- Skip testing on actual devices
+- Ignore accessibility testing
+- Create interdependent tests
+- Test without mocking APIs
+- Deploy untested code
diff --git a/.agents/skills/mobile-design/SKILL.md b/.agents/skills/mobile-design/SKILL.md
new file mode 100644
index 0000000..f4109e7
--- /dev/null
+++ b/.agents/skills/mobile-design/SKILL.md
@@ -0,0 +1,284 @@
+---
+name: mobile-design
+description: Mobile-first design and engineering doctrine for iOS and Android apps. Covers touch interaction, performance, platform conventions, offline behavior, and mobile-specific decision-making. Teaches principles and constraints, not fixed layouts. Use for React Native, Flutter, or native mobile apps.
+allowed-tools: Read, Glob, Grep, Bash
+---
+# Mobile Design System
+
+**(Mobile-First · Touch-First · Platform-Respectful)**
+
+> **Philosophy:** Touch-first. Battery-conscious. Platform-respectful. Offline-capable.
+> **Core Law:** Mobile is NOT a small desktop.
+> **Operating Rule:** Think constraints first, aesthetics second.
+
+This skill exists to **prevent desktop-thinking, AI-defaults, and unsafe assumptions** when designing or building mobile applications.
+
+---
+
+## 1. Mobile Feasibility & Risk Index (MFRI)
+
+Before designing or implementing **any mobile feature or screen**, assess feasibility.
+
+### MFRI Dimensions (1–5)
+
+| Dimension                  | Question                                                          |
+| -------------------------- | ----------------------------------------------------------------- |
+| **Platform Clarity**       | Is the target platform (iOS / Android / both) explicitly defined? |
+| **Interaction Complexity** | How complex are gestures, flows, or navigation?                   |
+| **Performance Risk**       | Does this involve lists, animations, heavy state, or media?       |
+| **Offline Dependence**     | Does the feature break or degrade without network?                |
+| **Accessibility Risk**     | Does this impact motor, visual, or cognitive accessibility?       |
+
+### Score Formula
+
+```
+MFRI = (Platform Clarity + Accessibility Readiness)
+       − (Interaction Complexity + Performance Risk + Offline Dependence)
+```
+
+**Range:** `-10 → +10`
+
+### Interpretation
+
+| MFRI     | Meaning   | Required Action                       |
+| -------- | --------- | ------------------------------------- |
+| **6–10** | Safe      | Proceed normally                      |
+| **3–5**  | Moderate  | Add performance + UX validation       |
+| **0–2**  | Risky     | Simplify interactions or architecture |
+| **< 0**  | Dangerous | Redesign before implementation        |
+
+---
+
+## 2. Mandatory Thinking Before Any Work
+
+### ⛔ STOP: Ask Before Assuming (Required)
+
+If **any of the following are not explicitly stated**, you MUST ask before proceeding:
+
+| Aspect     | Question                                   | Why                                      |
+| ---------- | ------------------------------------------ | ---------------------------------------- |
+| Platform   | iOS, Android, or both?                     | Affects navigation, gestures, typography |
+| Framework  | React Native, Flutter, or native?          | Determines performance and patterns      |
+| Navigation | Tabs, stack, drawer?                       | Core UX architecture                     |
+| Offline    | Must it work offline?                      | Data & sync strategy                     |
+| Devices    | Phone only or tablet too?                  | Layout & density rules                   |
+| Audience   | Consumer, enterprise, accessibility needs? | Touch & readability                      |
+
+🚫 **Never default to your favorite stack or pattern.**
+
+---
+
+## 3. Mandatory Reference Reading (Enforced)
+
+### Universal (Always Read First)
+
+| File                          | Purpose                            | Status            |
+| ----------------------------- | ---------------------------------- | ----------------- |
+| **mobile-design-thinking.md** | Anti-memorization, context-forcing | 🔴 REQUIRED FIRST |
+| **touch-psychology.md**       | Fitts’ Law, thumb zones, gestures  | 🔴 REQUIRED       |
+| **mobile-performance.md**     | 60fps, memory, battery             | 🔴 REQUIRED       |
+| **mobile-backend.md**         | Offline sync, push, APIs           | 🔴 REQUIRED       |
+| **mobile-testing.md**         | Device & E2E testing               | 🔴 REQUIRED       |
+| **mobile-debugging.md**       | Native vs JS debugging             | 🔴 REQUIRED       |
+
+### Platform-Specific (Conditional)
+
+| Platform       | File                |
+| -------------- | ------------------- |
+| iOS            | platform-ios.md     |
+| Android        | platform-android.md |
+| Cross-platform | BOTH above          |
+
+> ❌ If you haven’t read the platform file, you are not allowed to design UI.
+
+---
+
+## 4. AI Mobile Anti-Patterns (Hard Bans)
+
+### 🚫 Performance Sins (Non-Negotiable)
+
+| ❌ Never                   | Why                  | ✅ Always                                |
+| ------------------------- | -------------------- | --------------------------------------- |
+| ScrollView for long lists | Memory explosion     | FlatList / FlashList / ListView.builder |
+| Inline renderItem         | Re-renders all rows  | useCallback + memo                      |
+| Index as key              | Reorder bugs         | Stable ID                               |
+| JS-thread animations      | Jank                 | Native driver / GPU                     |
+| console.log in prod       | JS thread block      | Strip logs                              |
+| No memoization            | Battery + perf drain | React.memo / const widgets              |
+
+---
+
+### 🚫 Touch & UX Sins
+
+| ❌ Never               | Why                  | ✅ Always          |
+| --------------------- | -------------------- | ----------------- |
+| Touch <44–48px        | Miss taps            | Min touch target  |
+| Gesture-only action   | Excludes users       | Button fallback   |
+| No loading state      | Feels broken         | Explicit feedback |
+| No error recovery     | Dead end             | Retry + message   |
+| Ignore platform norms | Muscle memory broken | iOS ≠ Android     |
+
+---
+
+### 🚫 Security Sins
+
+| ❌ Never                | Why                | ✅ Always               |
+| ---------------------- | ------------------ | ---------------------- |
+| Tokens in AsyncStorage | Easily stolen      | SecureStore / Keychain |
+| Hardcoded secrets      | Reverse engineered | Env + secure storage   |
+| No SSL pinning         | MITM risk          | Cert pinning           |
+| Log sensitive data     | PII leakage        | Never log secrets      |
+
+---
+
+## 5. Platform Unification vs Divergence Matrix
+
+```
+UNIFY                          DIVERGE
+──────────────────────────     ─────────────────────────
+Business logic                Navigation behavior
+Data models                    Gestures
+API contracts                  Icons
+Validation                     Typography
+Error semantics                Pickers / dialogs
+```
+
+### Platform Defaults
+
+| Element   | iOS          | Android        |
+| --------- | ------------ | -------------- |
+| Font      | SF Pro       | Roboto         |
+| Min touch | 44pt         | 48dp           |
+| Back      | Edge swipe   | System back    |
+| Sheets    | Bottom sheet | Dialog / sheet |
+| Icons     | SF Symbols   | Material Icons |
+
+---
+
+## 6. Mobile UX Psychology (Non-Optional)
+
+### Fitts’ Law (Touch Reality)
+
+* Finger ≠ cursor
+* Accuracy is low
+* Reach matters more than precision
+
+**Rules:**
+
+* Primary CTAs live in **thumb zone**
+* Destructive actions pushed away
+* No hover assumptions
+
+---
+
+## 7. Performance Doctrine
+
+### React Native (Required Pattern)
+
+```ts
+const Row = React.memo(({ item }) => (
+  <View><Text>{item.title}</Text></View>
+));
+
+const renderItem = useCallback(
+  ({ item }) => <Row item={item} />,
+  []
+);
+
+<FlatList
+  data={items}
+  renderItem={renderItem}
+  keyExtractor={(i) => i.id}
+  getItemLayout={(_, i) => ({
+    length: ITEM_HEIGHT,
+    offset: ITEM_HEIGHT * i,
+    index: i,
+  })}
+/>
+```
+
+### Flutter (Required Pattern)
+
+```dart
+class Item extends StatelessWidget {
+  const Item({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const Text('Static');
+  }
+}
+```
+
+* `const` everywhere possible
+* Targeted rebuilds only
+
+---
+
+## 8. Mandatory Mobile Checkpoint
+
+Before writing **any code**, you must complete this:
+
+```
+🧠 MOBILE CHECKPOINT
+
+Platform:     ___________
+Framework:    ___________
+Files Read:   ___________
+
+3 Principles I Will Apply:
+1.
+2.
+3.
+
+Anti-Patterns I Will Avoid:
+1.
+2.
+```
+
+❌ Cannot complete → go back and read.
+
+---
+
+## 9. Framework Decision Tree (Canonical)
+
+```
+Need OTA + web team → React Native + Expo
+High-perf UI → Flutter
+iOS only → SwiftUI
+Android only → Compose
+```
+
+No debate without justification.
+
+---
+
+## 10. Release Readiness Checklist
+
+### Before Shipping
+
+* [ ] Touch targets ≥ 44–48px
+* [ ] Offline handled
+* [ ] Secure storage used
+* [ ] Lists optimized
+* [ ] Logs stripped
+* [ ] Tested on low-end devices
+* [ ] Accessibility labels present
+* [ ] MFRI ≥ 3
+
+---
+
+## 11. Related Skills
+
+* **frontend-design** – Visual systems & components
+* **frontend-dev-guidelines** – RN/TS architecture
+* **backend-dev-guidelines** – Mobile-safe APIs
+* **error-tracking** – Crash & performance telemetry
+
+---
+
+> **Final Law:**
+> Mobile users are distracted, interrupted, and impatient—often using one hand on a bad network with low battery.
+> **Design for that reality, or your app will fail quietly.**
+
+---
diff --git a/.agents/skills/mobile-design/decision-trees.md b/.agents/skills/mobile-design/decision-trees.md
new file mode 100644
index 0000000..69287bc
--- /dev/null
+++ b/.agents/skills/mobile-design/decision-trees.md
@@ -0,0 +1,516 @@
+# Mobile Decision Trees
+
+> Framework selection, state management, storage strategy, and context-based decisions.
+> **These are THINKING guides, not copy-paste answers.**
+
+---
+
+## 1. Framework Selection
+
+### Master Decision Tree
+
+```
+WHAT ARE YOU BUILDING?
+        │
+        ├── Need OTA updates without app store review?
+        │   │
+        │   ├── Yes → React Native + Expo
+        │   │         ├── Expo Go for development
+        │   │         ├── EAS Update for production OTA
+        │   │         └── Best for: rapid iteration, web teams
+        │   │
+        │   └── No → Continue ▼
+        │
+        ├── Need pixel-perfect custom UI across platforms?
+        │   │
+        │   ├── Yes → Flutter
+        │   │         ├── Custom rendering engine
+        │   │         ├── Single UI for iOS + Android
+        │   │         └── Best for: branded, visual apps
+        │   │
+        │   └── No → Continue ▼
+        │
+        ├── Heavy native features (ARKit, HealthKit, specific sensors)?
+        │   │
+        │   ├── iOS only → SwiftUI / UIKit
+        │   │              └── Maximum native capability
+        │   │
+        │   ├── Android only → Kotlin + Jetpack Compose
+        │   │                  └── Maximum native capability
+        │   │
+        │   └── Both → Consider native with shared logic
+        │              └── Kotlin Multiplatform for shared
+        │
+        ├── Existing web team + TypeScript codebase?
+        │   │
+        │   └── Yes → React Native
+        │             ├── Familiar paradigm for React devs
+        │             ├── Share code with web (limited)
+        │             └── Large ecosystem
+        │
+        └── Enterprise with existing Flutter team?
+            │
+            └── Yes → Flutter
+                      └── Leverage existing expertise
+```
+
+### Framework Comparison
+
+| Factor | React Native | Flutter | Native (Swift/Kotlin) |
+|--------|-------------|---------|----------------------|
+| **OTA Updates** | ✅ Expo | ❌ No | ❌ No |
+| **Learning Curve** | Low (React devs) | Medium | Higher |
+| **Performance** | Good | Excellent | Best |
+| **UI Consistency** | Platform-native | Identical | Platform-native |
+| **Bundle Size** | Medium | Larger | Smallest |
+| **Native Access** | Via bridges | Via channels | Direct |
+| **Hot Reload** | ✅ | ✅ | ✅ (Xcode 15+) |
+
+### When to Choose Native
+
+```
+CHOOSE NATIVE WHEN:
+├── Maximum performance required (games, 3D)
+├── Deep OS integration needed
+├── Platform-specific features are core
+├── Team has native expertise
+├── App store presence is primary
+└── Long-term maintenance priority
+
+AVOID NATIVE WHEN:
+├── Limited budget/time
+├── Need rapid iteration
+├── Identical UI on both platforms
+├── Team is web-focused
+└── Cross-platform is priority
+```
+
+---
+
+## 2. State Management Selection
+
+### React Native State Decision
+
+```
+WHAT'S YOUR STATE COMPLEXITY?
+        │
+        ├── Simple app, few screens, minimal shared state
+        │   │
+        │   └── Zustand (or just useState/Context)
+        │       ├── Minimal boilerplate
+        │       ├── Easy to understand
+        │       └── Scales OK to medium
+        │
+        ├── Primarily server data (API-driven)
+        │   │
+        │   └── TanStack Query (React Query) + Zustand
+        │       ├── Query for server state
+        │       ├── Zustand for UI state
+        │       └── Excellent caching, refetching
+        │
+        ├── Complex app with many features
+        │   │
+        │   └── Redux Toolkit + RTK Query
+        │       ├── Predicable, debuggable
+        │       ├── RTK Query for API
+        │       └── Good for large teams
+        │
+        └── Atomic, granular state needs
+            │
+            └── Jotai
+                ├── Atom-based (like Recoil)
+                ├── Minimizes re-renders
+                └── Good for derived state
+```
+
+### Flutter State Decision
+
+```
+WHAT'S YOUR STATE COMPLEXITY?
+        │
+        ├── Simple app, learning Flutter
+        │   │
+        │   └── Provider (or setState)
+        │       ├── Official, simple
+        │       ├── Built into Flutter
+        │       └── Good for small apps
+        │
+        ├── Modern, type-safe, testable
+        │   │
+        │   └── Riverpod 2.0
+        │       ├── Compile-time safety
+        │       ├── Code generation
+        │       ├── Excellent for medium-large apps
+        │       └── Recommended for new projects
+        │
+        ├── Enterprise, strict patterns needed
+        │   │
+        │   └── BLoC
+        │       ├── Event → State pattern
+        │       ├── Very testable
+        │       ├── More boilerplate
+        │       └── Good for large teams
+        │
+        └── Quick prototyping
+            │
+            └── GetX (with caution)
+                ├── Fast to implement
+                ├── Less strict patterns
+                └── Can become messy at scale
+```
+
+### State Management Anti-Patterns
+
+```
+❌ DON'T:
+├── Use global state for everything
+├── Mix state management approaches
+├── Store server state in local state
+├── Skip state normalization
+├── Overuse Context (re-render heavy)
+└── Put navigation state in app state
+
+✅ DO:
+├── Server state → Query library
+├── UI state → Minimal, local first
+├── Lift state only when needed
+├── Choose ONE approach per project
+└── Keep state close to where it's used
+```
+
+---
+
+## 3. Navigation Pattern Selection
+
+```
+HOW MANY TOP-LEVEL DESTINATIONS?
+        │
+        ├── 2 destinations
+        │   └── Consider: Top tabs or simple stack
+        │
+        ├── 3-5 destinations (equal importance)
+        │   └── ✅ Tab Bar / Bottom Navigation
+        │       ├── Most common pattern
+        │       └── Easy discovery
+        │
+        ├── 5+ destinations
+        │   │
+        │   ├── All important → Drawer Navigation
+        │   │                   └── Hidden but many options
+        │   │
+        │   └── Some less important → Tab bar + drawer hybrid
+        │
+        └── Single linear flow?
+            └── Stack Navigation only
+                └── Onboarding, checkout, etc.
+```
+
+### Navigation by App Type
+
+| App Type | Pattern | Reason |
+|----------|---------|--------|
+| Social (Instagram) | Tab bar | Frequent switching |
+| E-commerce | Tab bar + stack | Categories as tabs |
+| Email (Gmail) | Drawer + list-detail | Many folders |
+| Settings | Stack only | Deep drill-down |
+| Onboarding | Stack wizard | Linear flow |
+| Messaging | Tab (chats) + stack | Threads |
+
+---
+
+## 4. Storage Strategy Selection
+
+```
+WHAT TYPE OF DATA?
+        │
+        ├── Sensitive (tokens, passwords, keys)
+        │   │
+        │   └── ✅ Secure Storage
+        │       ├── iOS: Keychain
+        │       ├── Android: EncryptedSharedPreferences
+        │       └── RN: expo-secure-store / react-native-keychain
+        │
+        ├── User preferences (settings, theme)
+        │   │
+        │   └── ✅ Key-Value Storage
+        │       ├── iOS: UserDefaults
+        │       ├── Android: SharedPreferences
+        │       └── RN: AsyncStorage / MMKV
+        │
+        ├── Structured data (entities, relationships)
+        │   │
+        │   └── ✅ Database
+        │       ├── SQLite (expo-sqlite, sqflite)
+        │       ├── Realm (NoSQL, reactive)
+        │       └── WatermelonDB (large datasets)
+        │
+        ├── Large files (images, documents)
+        │   │
+        │   └── ✅ File System
+        │       ├── iOS: Documents / Caches directory
+        │       ├── Android: Internal/External storage
+        │       └── RN: react-native-fs / expo-file-system
+        │
+        └── Cached API data
+            │
+            └── ✅ Query Library Cache
+                ├── TanStack Query (RN)
+                ├── Riverpod async (Flutter)
+                └── Automatic invalidation
+```
+
+### Storage Comparison
+
+| Storage | Speed | Security | Capacity | Use Case |
+|---------|-------|----------|----------|----------|
+| Secure Storage | Medium | 🔒 High | Small | Tokens, secrets |
+| Key-Value | Fast | Low | Medium | Settings |
+| SQLite | Fast | Low | Large | Structured data |
+| File System | Medium | Low | Very Large | Media, documents |
+| Query Cache | Fast | Low | Medium | API responses |
+
+---
+
+## 5. Offline Strategy Selection
+
+```
+HOW CRITICAL IS OFFLINE?
+        │
+        ├── Nice to have (works when possible)
+        │   │
+        │   └── Cache last data + show stale
+        │       ├── Simple implementation
+        │       ├── TanStack Query with staleTime
+        │       └── Show "last updated" timestamp
+        │
+        ├── Essential (core functionality offline)
+        │   │
+        │   └── Offline-first architecture
+        │       ├── Local database as source of truth
+        │       ├── Sync to server when online
+        │       ├── Conflict resolution strategy
+        │       └── Queue actions for later sync
+        │
+        └── Real-time critical (collaboration, chat)
+            │
+            └── WebSocket + local queue
+                ├── Optimistic updates
+                ├── Eventual consistency
+                └── Complex conflict handling
+```
+
+### Offline Implementation Patterns
+
+```
+1. CACHE-FIRST (Simple)
+   Request → Check cache → If stale, fetch → Update cache
+   
+2. STALE-WHILE-REVALIDATE
+   Request → Return cached → Fetch update → Update UI
+   
+3. OFFLINE-FIRST (Complex)
+   Action → Write to local DB → Queue sync → Sync when online
+   
+4. SYNC ENGINE
+   Use: Firebase, Realm Sync, Supabase realtime
+   Handles conflict resolution automatically
+```
+
+---
+
+## 6. Authentication Pattern Selection
+
+```
+WHAT AUTH TYPE NEEDED?
+        │
+        ├── Simple email/password
+        │   │
+        │   └── Token-based (JWT)
+        │       ├── Store refresh token securely
+        │       ├── Access token in memory
+        │       └── Silent refresh flow
+        │
+        ├── Social login (Google, Apple, etc.)
+        │   │
+        │   └── OAuth 2.0 + PKCE
+        │       ├── Use platform SDKs
+        │       ├── Deep link callback
+        │       └── Apple Sign-In required for iOS
+        │
+        ├── Enterprise/SSO
+        │   │
+        │   └── OIDC / SAML
+        │       ├── Web view or system browser
+        │       └── Handle redirect properly
+        │
+        └── Biometric (FaceID, fingerprint)
+            │
+            └── Local auth + secure token
+                ├── Biometrics unlock stored token
+                ├── Not a replacement for server auth
+                └── Fallback to PIN/password
+```
+
+### Auth Token Storage
+
+```
+❌ NEVER store tokens in:
+├── AsyncStorage (plain text)
+├── Redux/state (not persisted correctly)
+├── Local storage equivalent
+└── Logs or debug output
+
+✅ ALWAYS store tokens in:
+├── iOS: Keychain
+├── Android: EncryptedSharedPreferences
+├── Expo: SecureStore
+├── Biometric-protected if available
+```
+
+---
+
+## 7. Project Type Templates
+
+### E-Commerce App
+
+```
+RECOMMENDED STACK:
+├── Framework: React Native + Expo (OTA for pricing)
+├── Navigation: Tab bar (Home, Search, Cart, Account)
+├── State: TanStack Query (products) + Zustand (cart)
+├── Storage: SecureStore (auth) + SQLite (cart cache)
+├── Offline: Cache products, queue cart actions
+└── Auth: Email/password + Social + Apple Pay
+
+KEY DECISIONS:
+├── Product images: Lazy load, cache aggressively
+├── Cart: Sync across devices via API
+├── Checkout: Secure, minimal steps
+└── Deep links: Product shares, marketing
+```
+
+### Social/Content App
+
+```
+RECOMMENDED STACK:
+├── Framework: React Native or Flutter
+├── Navigation: Tab bar (Feed, Search, Create, Notifications, Profile)
+├── State: TanStack Query (feed) + Zustand (UI)
+├── Storage: SQLite (feed cache, drafts)
+├── Offline: Cache feed, queue posts
+└── Auth: Social login primary, Apple required
+
+KEY DECISIONS:
+├── Feed: Infinite scroll, memoized items
+├── Media: Upload queuing, background upload
+├── Push: Deep link to content
+└── Real-time: WebSocket for notifications
+```
+
+### Productivity/SaaS App
+
+```
+RECOMMENDED STACK:
+├── Framework: Flutter (consistent UI) or RN
+├── Navigation: Drawer or Tab bar
+├── State: Riverpod/BLoC or Redux Toolkit
+├── Storage: SQLite (offline), SecureStore (auth)
+├── Offline: Full offline editing, sync
+└── Auth: SSO/OIDC for enterprise
+
+KEY DECISIONS:
+├── Data sync: Conflict resolution strategy
+├── Collaborative: Real-time or eventual?
+├── Files: Large file handling
+└── Enterprise: MDM, compliance
+```
+
+---
+
+## 8. Decision Checklist
+
+### Before Starting ANY Project
+
+- [ ] Target platforms defined (iOS/Android/both)?
+- [ ] Framework selected based on criteria?
+- [ ] State management approach chosen?
+- [ ] Navigation pattern selected?
+- [ ] Storage strategy for each data type?
+- [ ] Offline requirements defined?
+- [ ] Auth flow designed?
+- [ ] Deep linking planned from start?
+
+### Questions to Ask User
+
+```
+If project details are vague, ASK:
+
+1. "Will this need OTA updates without app store review?"
+   → Affects framework choice (Expo = yes)
+
+2. "Do iOS and Android need identical UI?"
+   → Affects framework (Flutter = identical)
+
+3. "What's the offline requirement?"
+   → Affects architecture complexity
+
+4. "Is there an existing backend/auth system?"
+   → Affects auth and API approach
+
+5. "What devices? Phone only, or tablet?"
+   → Affects navigation and layout
+
+6. "Enterprise or consumer?"
+   → Affects auth (SSO), security, compliance
+```
+
+---
+
+## 9. Anti-Pattern Decisions
+
+### ❌ Decision Anti-Patterns
+
+| Anti-Pattern | Why It's Bad | Better Approach |
+|--------------|--------------|-----------------|
+| **Redux for simple app** | Massive overkill | Zustand or context |
+| **Native for MVP** | Slow development | Cross-platform MVP |
+| **Drawer for 3 sections** | Hidden navigation | Tab bar |
+| **AsyncStorage for tokens** | Insecure | SecureStore |
+| **No offline consideration** | Broken on subway | Plan from start |
+| **Same stack for all projects** | Doesn't fit context | Evaluate per project |
+
+---
+
+## 10. Quick Reference
+
+### Framework Quick Pick
+
+```
+OTA needed?           → React Native + Expo
+Identical UI?         → Flutter
+Maximum performance?  → Native
+Web team?            → React Native
+Quick prototype?     → Expo
+```
+
+### State Quick Pick
+
+```
+Simple app?          → Zustand / Provider
+Server-heavy?        → TanStack Query / Riverpod
+Enterprise?          → Redux / BLoC
+Atomic state?        → Jotai
+```
+
+### Storage Quick Pick
+
+```
+Secrets?             → SecureStore / Keychain
+Settings?            → AsyncStorage / UserDefaults
+Structured data?     → SQLite
+API cache?           → Query library
+```
+
+---
+
+> **Remember:** These trees are guides for THINKING, not rules to follow blindly. Every project has unique constraints. ASK clarifying questions when requirements are vague, and choose based on actual needs, not defaults.
diff --git a/.agents/skills/mobile-design/mobile-backend.md b/.agents/skills/mobile-design/mobile-backend.md
new file mode 100644
index 0000000..8939989
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-backend.md
@@ -0,0 +1,491 @@
+# Mobile Backend Patterns
+
+> **This file covers backend/API patterns SPECIFIC to mobile clients.**
+> Generic backend patterns are in `nodejs-best-practices` and `api-patterns`.
+> **Mobile backend is NOT the same as web backend. Different constraints, different patterns.**
+
+---
+
+## 🧠 MOBILE BACKEND MINDSET
+
+```
+Mobile clients are DIFFERENT from web clients:
+├── Unreliable network (2G, subway, elevator)
+├── Battery constraints (minimize wake-ups)
+├── Limited storage (can't cache everything)
+├── Interrupted sessions (calls, notifications)
+├── Diverse devices (old phones to flagships)
+└── Binary updates are slow (App Store review)
+```
+
+**Your backend must compensate for ALL of these.**
+
+---
+
+## 🚫 AI MOBILE BACKEND ANTI-PATTERNS
+
+### These are common AI mistakes when building mobile backends:
+
+| ❌ AI Default | Why It's Wrong | ✅ Mobile-Correct |
+|---------------|----------------|-------------------|
+| Same API for web and mobile | Mobile needs compact responses | Separate mobile endpoints OR field selection |
+| Full object responses | Wastes bandwidth, battery | Partial responses, pagination |
+| No offline consideration | App crashes without network | Offline-first design, sync queues |
+| WebSocket for everything | Battery drain | Push notifications + polling fallback |
+| No app versioning | Can't force updates, breaking changes | Version headers, minimum version check |
+| Generic error messages | Users can't fix issues | Mobile-specific error codes + recovery actions |
+| Session-based auth | Mobile apps restart | Token-based with refresh |
+| Ignore device info | Can't debug issues | Device ID, app version in headers |
+
+---
+
+## 1. Push Notifications
+
+### Platform Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    YOUR BACKEND                                  │
+├─────────────────────────────────────────────────────────────────┤
+│                         │                                        │
+│              ┌──────────┴──────────┐                            │
+│              ▼                     ▼                            │
+│    ┌─────────────────┐   ┌─────────────────┐                    │
+│    │   FCM (Google)  │   │  APNs (Apple)   │                    │
+│    │   Firebase      │   │  Direct or FCM  │                    │
+│    └────────┬────────┘   └────────┬────────┘                    │
+│             │                     │                              │
+│             ▼                     ▼                              │
+│    ┌─────────────────┐   ┌─────────────────┐                    │
+│    │ Android Device  │   │   iOS Device    │                    │
+│    └─────────────────┘   └─────────────────┘                    │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Push Types
+
+| Type | Use Case | User Sees |
+|------|----------|-----------|
+| **Display** | New message, order update | Notification banner |
+| **Silent** | Background sync, content update | Nothing (background) |
+| **Data** | Custom handling by app | Depends on app logic |
+
+### Anti-Patterns
+
+| ❌ NEVER | ✅ ALWAYS |
+|----------|----------|
+| Send sensitive data in push | Push says "New message", app fetches content |
+| Overload with pushes | Batch, dedupe, respect quiet hours |
+| Same message to all | Segment by user preference, timezone |
+| Ignore failed tokens | Clean up invalid tokens regularly |
+| Skip APNs for iOS | FCM alone doesn't guarantee iOS delivery |
+
+### Token Management
+
+```
+TOKEN LIFECYCLE:
+├── App registers → Get token → Send to backend
+├── Token can change → App must re-register on start
+├── Token expires → Clean from database
+├── User uninstalls → Token becomes invalid (detect via error)
+└── Multiple devices → Store multiple tokens per user
+```
+
+---
+
+## 2. Offline Sync & Conflict Resolution
+
+### Sync Strategy Selection
+
+```
+WHAT TYPE OF DATA?
+        │
+        ├── Read-only (news, catalog)
+        │   └── Simple cache + TTL
+        │       └── ETag/Last-Modified for invalidation
+        │
+        ├── User-owned (notes, todos)
+        │   └── Last-write-wins (simple)
+        │       └── Or timestamp-based merge
+        │
+        ├── Collaborative (shared docs)
+        │   └── CRDT or OT required
+        │       └── Consider Firebase/Supabase
+        │
+        └── Critical (payments, inventory)
+            └── Server is source of truth
+                └── Optimistic UI + server confirmation
+```
+
+### Conflict Resolution Strategies
+
+| Strategy | How It Works | Best For |
+|----------|--------------|----------|
+| **Last-write-wins** | Latest timestamp overwrites | Simple data, single user |
+| **Server-wins** | Server always authoritative | Critical transactions |
+| **Client-wins** | Offline changes prioritized | Offline-heavy apps |
+| **Merge** | Combine changes field-by-field | Documents, rich content |
+| **CRDT** | Mathematically conflict-free | Real-time collaboration |
+
+### Sync Queue Pattern
+
+```
+CLIENT SIDE:
+├── User makes change → Write to local DB
+├── Add to sync queue → { action, data, timestamp, retries }
+├── Network available → Process queue FIFO
+├── Success → Remove from queue
+├── Failure → Retry with backoff (max 5 retries)
+└── Conflict → Apply resolution strategy
+
+SERVER SIDE:
+├── Accept change with client timestamp
+├── Compare with server version
+├── Apply conflict resolution
+├── Return merged state
+└── Client updates local with server response
+```
+
+---
+
+## 3. Mobile API Optimization
+
+### Response Size Reduction
+
+| Technique | Savings | Implementation |
+|-----------|---------|----------------|
+| **Field selection** | 30-70% | `?fields=id,name,thumbnail` |
+| **Compression** | 60-80% | gzip/brotli (automatic) |
+| **Pagination** | Varies | Cursor-based for mobile |
+| **Image variants** | 50-90% | `/image?w=200&q=80` |
+| **Delta sync** | 80-95% | Only changed records since timestamp |
+
+### Pagination: Cursor vs Offset
+
+```
+OFFSET (Bad for mobile):
+├── Page 1: OFFSET 0 LIMIT 20
+├── Page 2: OFFSET 20 LIMIT 20
+├── Problem: New item added → duplicates!
+└── Problem: Large offset = slow query
+
+CURSOR (Good for mobile):
+├── First: ?limit=20
+├── Next: ?limit=20&after=cursor_abc123
+├── Cursor = encoded (id + sort values)
+├── No duplicates on data changes
+└── Consistent performance
+```
+
+### Batch Requests
+
+```
+Instead of:
+GET /users/1
+GET /users/2  
+GET /users/3
+(3 round trips, 3x latency)
+
+Use:
+POST /batch
+{ requests: [
+    { method: "GET", path: "/users/1" },
+    { method: "GET", path: "/users/2" },
+    { method: "GET", path: "/users/3" }
+]}
+(1 round trip)
+```
+
+---
+
+## 4. App Versioning
+
+### Version Check Endpoint
+
+```
+GET /api/app-config
+Headers:
+  X-App-Version: 2.1.0
+  X-Platform: ios
+  X-Device-ID: abc123
+
+Response:
+{
+  "minimum_version": "2.0.0",
+  "latest_version": "2.3.0",
+  "force_update": false,
+  "update_url": "https://apps.apple.com/...",
+  "feature_flags": {
+    "new_player": true,
+    "dark_mode": true
+  },
+  "maintenance": false,
+  "maintenance_message": null
+}
+```
+
+### Version Comparison Logic
+
+```
+CLIENT VERSION vs MINIMUM VERSION:
+├── client >= minimum → Continue normally
+├── client < minimum → Show force update screen
+│   └── Block app usage until updated
+└── client < latest → Show optional update prompt
+
+FEATURE FLAGS:
+├── Enable/disable features without app update
+├── A/B testing by version/device
+└── Gradual rollout (10% → 50% → 100%)
+```
+
+---
+
+## 5. Authentication for Mobile
+
+### Token Strategy
+
+```
+ACCESS TOKEN:
+├── Short-lived (15 min - 1 hour)
+├── Stored in memory (not persistent)
+├── Used for API requests
+└── Refresh when expired
+
+REFRESH TOKEN:
+├── Long-lived (30-90 days)
+├── Stored in SecureStore/Keychain
+├── Used only to get new access token
+└── Rotate on each use (security)
+
+DEVICE TOKEN:
+├── Identifies this device
+├── Allows "log out all devices"
+├── Stored alongside refresh token
+└── Server tracks active devices
+```
+
+### Silent Re-authentication
+
+```
+REQUEST FLOW:
+├── Make request with access token
+├── 401 Unauthorized?
+│   ├── Have refresh token?
+│   │   ├── Yes → Call /auth/refresh
+│   │   │   ├── Success → Retry original request
+│   │   │   └── Failure → Force logout
+│   │   └── No → Force logout
+│   └── Token just expired (not invalid)
+│       └── Auto-refresh, user doesn't notice
+└── Success → Continue
+```
+
+---
+
+## 6. Error Handling for Mobile
+
+### Mobile-Specific Error Format
+
+```json
+{
+  "error": {
+    "code": "PAYMENT_DECLINED",
+    "message": "Your payment was declined",
+    "user_message": "Please check your card details or try another payment method",
+    "action": {
+      "type": "navigate",
+      "destination": "payment_methods"
+    },
+    "retry": {
+      "allowed": true,
+      "after_seconds": 5
+    }
+  }
+}
+```
+
+### Error Categories
+
+| Code Range | Category | Mobile Handling |
+|------------|----------|-----------------|
+| 400-499 | Client error | Show message, user action needed |
+| 401 | Auth expired | Silent refresh or re-login |
+| 403 | Forbidden | Show upgrade/permission screen |
+| 404 | Not found | Remove from local cache |
+| 409 | Conflict | Show sync conflict UI |
+| 429 | Rate limit | Retry after header, backoff |
+| 500-599 | Server error | Retry with backoff, show "try later" |
+| Network | No connection | Use cached data, queue for sync |
+
+---
+
+## 7. Media & Binary Handling
+
+### Image Optimization
+
+```
+CLIENT REQUEST:
+GET /images/{id}?w=400&h=300&q=80&format=webp
+
+SERVER RESPONSE:
+├── Resize on-the-fly OR use CDN
+├── WebP for Android (smaller)
+├── HEIC for iOS 14+ (if supported)
+├── JPEG fallback
+└── Cache-Control: max-age=31536000
+```
+
+### Chunked Upload (Large Files)
+
+```
+UPLOAD FLOW:
+1. POST /uploads/init
+   { filename, size, mime_type }
+   → { upload_id, chunk_size }
+
+2. PUT /uploads/{upload_id}/chunks/{n}
+   → Upload each chunk (1-5 MB)
+   → Can resume if interrupted
+
+3. POST /uploads/{upload_id}/complete
+   → Server assembles chunks
+   → Return final file URL
+```
+
+### Streaming Audio/Video
+
+```
+REQUIREMENTS:
+├── HLS (HTTP Live Streaming) for iOS
+├── DASH or HLS for Android
+├── Multiple quality levels (adaptive bitrate)
+├── Range request support (seeking)
+└── Offline download chunks
+
+ENDPOINTS:
+GET /media/{id}/manifest.m3u8  → HLS manifest
+GET /media/{id}/segment_{n}.ts → Video segment
+GET /media/{id}/download       → Full file for offline
+```
+
+---
+
+## 8. Security for Mobile
+
+### Device Attestation
+
+```
+VERIFY REAL DEVICE (not emulator/bot):
+├── iOS: DeviceCheck API
+│   └── Server verifies with Apple
+├── Android: Play Integrity API (replaces SafetyNet)
+│   └── Server verifies with Google
+└── Fail closed: Reject if attestation fails
+```
+
+### Request Signing
+
+```
+CLIENT:
+├── Create signature = HMAC(timestamp + path + body, secret)
+├── Send: X-Signature: {signature}
+├── Send: X-Timestamp: {timestamp}
+└── Send: X-Device-ID: {device_id}
+
+SERVER:
+├── Validate timestamp (within 5 minutes)
+├── Recreate signature with same inputs
+├── Compare signatures
+└── Reject if mismatch (tampering detected)
+```
+
+### Rate Limiting
+
+```
+MOBILE-SPECIFIC LIMITS:
+├── Per device (X-Device-ID)
+├── Per user (after auth)
+├── Per endpoint (stricter for sensitive)
+└── Sliding window preferred
+
+HEADERS:
+X-RateLimit-Limit: 100
+X-RateLimit-Remaining: 95
+X-RateLimit-Reset: 1609459200
+Retry-After: 60 (when 429)
+```
+
+---
+
+## 9. Monitoring & Analytics
+
+### Required Headers from Mobile
+
+```
+Every mobile request should include:
+├── X-App-Version: 2.1.0
+├── X-Platform: ios | android
+├── X-OS-Version: 17.0
+├── X-Device-Model: iPhone15,2
+├── X-Device-ID: uuid (persistent)
+├── X-Request-ID: uuid (per request, for tracing)
+├── Accept-Language: tr-TR
+└── X-Timezone: Europe/Istanbul
+```
+
+### What to Log
+
+```
+FOR EACH REQUEST:
+├── All headers above
+├── Endpoint, method, status
+├── Response time
+├── Error details (if any)
+└── User ID (if authenticated)
+
+ALERTS:
+├── Error rate > 5% per version
+├── P95 latency > 2 seconds
+├── Specific version crash spike
+├── Auth failure spike (attack?)
+└── Push delivery failure spike
+```
+
+---
+
+## 📝 MOBILE BACKEND CHECKLIST
+
+### Before API Design
+- [ ] Identified mobile-specific requirements?
+- [ ] Planned offline behavior?
+- [ ] Designed sync strategy?
+- [ ] Considered bandwidth constraints?
+
+### For Every Endpoint
+- [ ] Response as small as possible?
+- [ ] Pagination cursor-based?
+- [ ] Proper caching headers?
+- [ ] Mobile error format with actions?
+
+### Authentication
+- [ ] Token refresh implemented?
+- [ ] Silent re-auth flow?
+- [ ] Multi-device logout?
+- [ ] Secure token storage guidance?
+
+### Push Notifications
+- [ ] FCM + APNs configured?
+- [ ] Token lifecycle managed?
+- [ ] Silent vs display push defined?
+- [ ] Sensitive data NOT in push payload?
+
+### Release
+- [ ] Version check endpoint ready?
+- [ ] Feature flags configured?
+- [ ] Force update mechanism?
+- [ ] Monitoring headers required?
+
+---
+
+> **Remember:** Mobile backend must be resilient to bad networks, respect battery life, and handle interrupted sessions gracefully. The client cannot be trusted, but it also cannot be hung up—provide offline capabilities and clear error recovery paths.
diff --git a/.agents/skills/mobile-design/mobile-color-system.md b/.agents/skills/mobile-design/mobile-color-system.md
new file mode 100644
index 0000000..22276bc
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-color-system.md
@@ -0,0 +1,420 @@
+# Mobile Color System Reference
+
+> OLED optimization, dark mode, battery-aware colors, and outdoor visibility.
+> **Color on mobile isn't just aesthetics—it's battery life and usability.**
+
+---
+
+## 1. Mobile Color Fundamentals
+
+### Why Mobile Color is Different
+
+```
+DESKTOP:                           MOBILE:
+├── LCD screens (backlit)          ├── OLED common (self-emissive)
+├── Controlled lighting            ├── Outdoor, bright sun
+├── Stable power                   ├── Battery matters
+├── Personal preference            ├── System-wide dark mode
+└── Static viewing                 └── Variable angles, motion
+```
+
+### Mobile Color Priorities
+
+| Priority | Why |
+|----------|-----|
+| **1. Readability** | Outdoor, variable lighting |
+| **2. Battery efficiency** | OLED = dark mode saves power |
+| **3. System integration** | Dark/light mode support |
+| **4. Semantics** | Error, success, warning colors |
+| **5. Brand** | After functional requirements |
+
+---
+
+## 2. OLED Considerations
+
+### How OLED Differs
+
+```
+LCD (Liquid Crystal Display):
+├── Backlight always on
+├── Black = backlight through dark filter
+├── Energy use = constant
+└── Dark mode = no battery savings
+
+OLED (Organic LED):
+├── Each pixel emits own light
+├── Black = pixel OFF (zero power)
+├── Energy use = brighter pixels use more
+└── Dark mode = significant battery savings
+```
+
+### Battery Savings with OLED
+
+```
+Color energy consumption (relative):
+
+#000000 (True Black)  ████░░░░░░  0%
+#1A1A1A (Near Black)  █████░░░░░  ~15%
+#333333 (Dark Gray)   ██████░░░░  ~30%
+#666666 (Medium Gray) ███████░░░  ~50%
+#FFFFFF (White)       ██████████  100%
+
+Saturated colors also use significant power:
+├── Blue pixels: Most efficient
+├── Green pixels: Medium
+├── Red pixels: Least efficient
+└── Desaturated colors save more
+```
+
+### True Black vs Near Black
+
+```
+#000000 (True Black):
+├── Maximum battery savings
+├── Can cause "black smear" on scroll
+├── Sharp contrast (may be harsh)
+└── Used by Apple in pure dark mode
+
+#121212 or #1A1A1A (Near Black):
+├── Still good battery savings
+├── Smoother scrolling (no smear)
+├── Slightly softer on eyes
+└── Material Design recommendation
+
+RECOMMENDATION: #000000 for backgrounds, #0D0D0D-#1A1A1A for surfaces
+```
+
+---
+
+## 3. Dark Mode Design
+
+### Dark Mode Benefits
+
+```
+Users enable dark mode for:
+├── Battery savings (OLED)
+├── Reduced eye strain (low light)
+├── Personal preference
+├── AMOLED aesthetic
+└── Accessibility (light sensitivity)
+```
+
+### Dark Mode Color Strategy
+
+```
+LIGHT MODE                      DARK MODE
+──────────                      ─────────
+Background: #FFFFFF      →      #000000 or #121212
+Surface:    #F5F5F5      →      #1E1E1E
+Surface 2:  #EEEEEE      →      #2C2C2C
+
+Primary:    #1976D2      →      #90CAF9 (lighter)
+Text:       #212121      →      #E0E0E0 (not pure white)
+Secondary:  #757575      →      #9E9E9E
+
+Elevation in dark mode:
+├── Higher = slightly lighter surface
+├── 0dp →  0% overlay
+├── 4dp →  9% overlay
+├── 8dp →  12% overlay
+└── Creates depth without shadows
+```
+
+### Text Colors in Dark Mode
+
+| Role | Light Mode | Dark Mode |
+|------|------------|-----------|
+| Primary | #000000 (Black) | #E8E8E8 (Not pure white) |
+| Secondary | #666666 | #B0B0B0 |
+| Disabled | #9E9E9E | #6E6E6E |
+| Links | #1976D2 | #8AB4F8 |
+
+### Color Inversion Rules
+
+```
+DON'T just invert colors:
+├── Saturated colors become eye-burning
+├── Semantic colors lose meaning
+├── Brand colors may break
+└── Contrast ratios change unpredictably
+
+DO create intentional dark palette:
+├── Desaturate primary colors
+├── Use lighter tints for emphasis
+├── Maintain semantic color meanings
+├── Check contrast ratios independently
+```
+
+---
+
+## 4. Outdoor Visibility
+
+### The Sunlight Problem
+
+```
+Screen visibility outdoors:
+├── Bright sun washes out low contrast
+├── Glare reduces readability
+├── Polarized sunglasses affect
+└── Users shield screen with hand
+
+Affected elements:
+├── Light gray text on white
+├── Subtle color differences
+├── Low opacity overlays
+└── Pastel colors
+```
+
+### High Contrast Strategies
+
+```
+For outdoor visibility:
+
+MINIMUM CONTRAST RATIOS:
+├── Normal text: 4.5:1 (WCAG AA)
+├── Large text: 3:1 (WCAG AA)
+├── Recommended: 7:1+ (AAA)
+
+AVOID:
+├── #999 on #FFF (fails AA)
+├── #BBB on #FFF (fails)
+├── Pale colors on light backgrounds
+└── Subtle gradients for critical info
+
+DO:
+├── Use system semantic colors
+├── Test in bright environment
+├── Provide high contrast mode
+└── Use solid colors for critical UI
+```
+
+---
+
+## 5. Semantic Colors
+
+### Consistent Meaning
+
+| Semantic | Meaning | iOS Default | Android Default |
+|----------|---------|-------------|-----------------|
+| Error | Problems, destruction | #FF3B30 | #B3261E |
+| Success | Completion, positive | #34C759 | #4CAF50 |
+| Warning | Attention, caution | #FF9500 | #FFC107 |
+| Info | Information | #007AFF | #2196F3 |
+
+### Semantic Color Rules
+
+```
+NEVER use semantic colors for:
+├── Branding (confuses meaning)
+├── Decoration (reduces impact)
+├── Arbitrary styling
+└── Status indicators (use icons too)
+
+ALWAYS:
+├── Pair with icons (colorblind users)
+├── Maintain across light/dark modes
+├── Keep consistent throughout app
+└── Follow platform conventions
+```
+
+### Error State Colors
+
+```
+Error states need:
+├── Red-ish color (semantic)
+├── High contrast against background
+├── Icon reinforcement
+├── Clear text explanation
+
+iOS:
+├── Light: #FF3B30
+├── Dark: #FF453A
+
+Android:
+├── Light: #B3261E
+├── Dark: #F2B8B5 (on error container)
+```
+
+---
+
+## 6. Dynamic Color (Android)
+
+### Material You
+
+```
+Android 12+ Dynamic Color:
+
+User's wallpaper → Color extraction → App theme
+
+Your app automatically gets:
+├── Primary (from wallpaper dominant)
+├── Secondary (complementary)
+├── Tertiary (accent)
+├── Surface colors (neutral, derived)
+├── On-colors (text on each)
+```
+
+### Supporting Dynamic Color
+
+```kotlin
+// Jetpack Compose
+MaterialTheme(
+    colorScheme = dynamicColorScheme()
+        ?: staticColorScheme() // Fallback for older Android
+)
+
+// React Native
+// Limited support - consider react-native-material-you
+```
+
+### Fallback Colors
+
+```
+When dynamic color unavailable:
+├── Android < 12
+├── User disabled
+├── Non-supporting launchers
+
+Provide static color scheme:
+├── Define your brand colors
+├── Test in both modes
+├── Match dynamic color roles
+└── Support light + dark
+```
+
+---
+
+## 7. Color Accessibility
+
+### Colorblind Considerations
+
+```
+~8% of men, ~0.5% of women are colorblind
+
+Types:
+├── Protanopia (red weakness)
+├── Deuteranopia (green weakness)
+├── Tritanopia (blue weakness)
+├── Monochromacy (rare, no color)
+
+Design rules:
+├── Never rely on color alone
+├── Use patterns, icons, text
+├── Test with simulation tools
+├── Avoid red/green distinctions only
+```
+
+### Contrast Testing Tools
+
+```
+Use these to verify:
+├── Built-in accessibility inspector (Xcode)
+├── Accessibility Scanner (Android)
+├── Contrast ratio calculators
+├── Colorblind simulation
+└── Test on actual devices in sunlight
+```
+
+### Sufficient Contrast
+
+```
+WCAG Guidelines:
+
+AA (Minimum)
+├── Normal text: 4.5:1
+├── Large text (18pt+): 3:1
+├── UI components: 3:1
+
+AAA (Enhanced)
+├── Normal text: 7:1
+├── Large text: 4.5:1
+
+Mobile recommendation: Meet AA, aim for AAA
+```
+
+---
+
+## 8. Color Anti-Patterns
+
+### ❌ Common Mistakes
+
+| Mistake | Problem | Fix |
+|---------|---------|-----|
+| **Light gray on white** | Invisible outdoors | Min 4.5:1 contrast |
+| **Pure white in dark mode** | Eye strain | Use #E0E0E0-#F0F0F0 |
+| **Same saturation dark mode** | Garish, glowing | Desaturate colors |
+| **Red/green only indicator** | Colorblind users can't see | Add icons |
+| **Semantic colors for brand** | Confusing meaning | Use neutral for brand |
+| **Ignoring system dark mode** | Jarring experience | Support both modes |
+
+### ❌ AI Color Mistakes
+
+```
+AI tends to:
+├── Use same colors for light/dark
+├── Ignore OLED battery implications
+├── Skip contrast calculations
+├── Default to purple/violet (BANNED)
+├── Use low contrast "aesthetic" grays
+├── Not test in outdoor conditions
+└── Forget colorblind users
+
+RULE: Design for the worst case.
+Test in bright sunlight, with colorblindness simulation.
+```
+
+---
+
+## 9. Color System Checklist
+
+### Before Choosing Colors
+
+- [ ] Light and dark mode variants defined?
+- [ ] Contrast ratios checked (4.5:1+)?
+- [ ] OLED battery considered (dark mode)?
+- [ ] Semantic colors follow conventions?
+- [ ] Colorblind-safe (not color-only indicators)?
+
+### Before Release
+
+- [ ] Tested in bright sunlight?
+- [ ] Tested dark mode on OLED device?
+- [ ] System dark mode respected?
+- [ ] Dynamic color supported (Android)?
+- [ ] Error/success/warning consistent?
+- [ ] All text meets contrast requirements?
+
+---
+
+## 10. Quick Reference
+
+### Dark Mode Backgrounds
+
+```
+True black (OLED max savings): #000000
+Near black (Material):         #121212
+Surface 1:                     #1E1E1E
+Surface 2:                     #2C2C2C
+Surface 3:                     #3C3C3C
+```
+
+### Text on Dark
+
+```
+Primary:   #E0E0E0 to #ECECEC
+Secondary: #A0A0A0 to #B0B0B0
+Disabled:  #606060 to #707070
+```
+
+### Contrast Ratios
+
+```
+Small text:  4.5:1 (minimum)
+Large text:  3:1 (minimum)
+UI elements: 3:1 (minimum)
+Ideal:       7:1 (AAA)
+```
+
+---
+
+> **Remember:** Color on mobile must work in the worst conditions—bright sun, tired eyes, colorblindness, low battery. Pretty colors that fail these tests are useless colors.
diff --git a/.agents/skills/mobile-design/mobile-debugging.md b/.agents/skills/mobile-design/mobile-debugging.md
new file mode 100644
index 0000000..fb3679b
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-debugging.md
@@ -0,0 +1,122 @@
+# Mobile Debugging Guide
+
+> **Stop console.log() debugging!**
+> Mobile apps have complex native layers. Text logs are not enough.
+> **This file teaches effective mobile debugging strategies.**
+
+---
+
+## 🧠 MOBILE DEBUGGING MINDSET
+
+```
+Web Debugging:      Mobile Debugging:
+┌──────────────┐    ┌──────────────┐
+│  Browser     │    │  JS Bridge   │
+│  DevTools    │    │  Native UI   │
+│  Network Tab │    │  GPU/Memory  │
+└──────────────┘    │  Threads     │
+                    └──────────────┘
+```
+
+**Key Differences:**
+1.  **Native Layer:** JS code works, but app crashes? It's likely native (Java/Obj-C).
+2.  **Deployment:** You can't just "refresh". State gets lost or stuck.
+3.  **Network:** SSL Pinning, proxy settings are harder.
+4.  **Device Logs:** `adb logcat` and `Console.app` are your truth.
+
+---
+
+## 🚫 AI DEBUGGING ANTI-PATTERNS
+
+| ❌ Default | ✅ Mobile-Correct |
+|------------|-------------------|
+| "Add console.logs" | Use Flipper / Reactotron |
+| "Check network tab" | Use Charles Proxy / Proxyman |
+| "It works on simulator" | **Test on Real Device** (HW specific bugs) |
+| "Reinstall node_modules" | **Clean Native Build** (Gradle/Pod cache) |
+| Ignored native logs | Read `logcat` / Xcode logs |
+
+---
+
+## 1. The Toolset
+
+### ⚡ React Native & Expo
+
+| Tool | Purpose | Best For |
+|------|---------|----------|
+| **Reactotron** | State/API/Redux | JS side debugging |
+| **Flipper** | Layout/Network/db | Native + JS bridge |
+| **Expo Tools** | Element inspector | Quick UI checks |
+
+### 🛠️ Native Layer (The Deep Dive)
+
+| Tool | Platform | Command | Why Use? |
+|------|----------|---------|----------|
+| **Logcat** | Android | `adb logcat` | Native crashes, ANRs |
+| **Console** | iOS | via Xcode | Native exceptions, memory |
+| **Layout Insp.** | Android | Android Studio | UI hierarchy bugs |
+| **View Insp.** | iOS | Xcode | UI hierarchy bugs |
+
+---
+
+## 2. Common Debugging Workflows
+
+### 🕵️ "The App Just Crashed" (Red Screen vs Crash to Home)
+
+**Scenario A: Red Screen (JS Error)**
+- **Cause:** Undefined is not an object, import error.
+- **Fix:** Read the stack trace on screen. It's usually clear.
+
+**Scenario B: Crash to Home Screen (Native Crash)**
+- **Cause:** Native module failure, memory OOM, permission usage without declaration.
+- **Tools:**
+    - **Android:** `adb logcat *:E` (Filter for Errors)
+    - **iOS:** Open Xcode → Window → Devices → View Device Logs
+
+> **💡 Pro Tip:** If app crashes immediately on launch, it's almost 100% a native configuration issue (Info.plist, AndroidManifest.xml).
+
+### 🌐 "API Request Failed" (Network)
+
+**Web:** Open Chrome DevTools → Network.
+**Mobile:** *You usually can't see this easily.*
+
+**Solution 1: Reactotron/Flipper**
+- View network requests in the monitoring app.
+
+**Solution 2: Proxy (Charles/Proxyman)**
+- **Hard but powerful.** See ALL traffic even from native SDKs.
+- Requires installing SSL cert on device.
+
+### 🐢 "The UI is Laggy" (Performance)
+
+**Don't guess.** measure.
+- **React Native:** Performance Monitor (Shake menu).
+- **Android:** "Profile GPU Rendering" in Developer Options.
+- **Issues:**
+    - **JS FPS drop:** Heavy calculation in JS thread.
+    - **UI FPS drop:** Too many views, intricate hierarchy, heavy images.
+
+---
+
+## 3. Platform-Specific Nightmares
+
+### Android
+- **Gradle Sync Fail:** Usually Java version mismatch or duplicate classes.
+- **Emulator Network:** Emulator `localhost` is `10.0.2.2`, NOT `127.0.0.1`.
+- **Cached Builds:** `./gradlew clean` is your best friend.
+
+### iOS
+- **Pod Issues:** `pod deintegrate && pod install`.
+- **Signing Errors:** Check Team ID and Bundle Identifier.
+- **Cache:** Xcode → Product → Clean Build Folder.
+
+---
+
+## 📝 DEBUGGING CHECKLIST
+
+- [ ] **Is it a JS or Native crash?** (Red screen or home screen?)
+- [ ] **Did you clean build?** (Native caches are aggressive)
+- [ ] **Are you on a real device?** (Simulators hide concurrency bugs)
+- [ ] **Did you check the native logs?** (Not just terminal output)
+
+> **Remember:** If JavaScript looks perfect but the app fails, look closer at the Native side.
diff --git a/.agents/skills/mobile-design/mobile-design-thinking.md b/.agents/skills/mobile-design/mobile-design-thinking.md
new file mode 100644
index 0000000..399d3b2
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-design-thinking.md
@@ -0,0 +1,357 @@
+# Mobile Design Thinking
+
+> **This file prevents AI from using memorized patterns and forces genuine thinking.**
+> Mechanisms to prevent standard AI training defaults in mobile development.
+> **The mobile equivalent of frontend's layout decomposition approach.**
+
+---
+
+## 🧠 DEEP MOBILE THINKING PROTOCOL
+
+### This Process is Mandatory Before Every Mobile Project
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    DEEP MOBILE THINKING                         │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1️⃣ CONTEXT SCAN                                               │
+│     └── What are my assumptions for this project?               │
+│         └── QUESTION these assumptions                          │
+│                                                                 │
+│  2️⃣ ANTI-DEFAULT ANALYSIS                                      │
+│     └── Am I applying a memorized pattern?                      │
+│         └── Is this pattern REALLY the best for THIS project?   │
+│                                                                 │
+│  3️⃣ PLATFORM DECOMPOSITION                                     │
+│     └── Did I think about iOS and Android separately?           │
+│         └── What are the platform-specific patterns?            │
+│                                                                 │
+│  4️⃣ TOUCH INTERACTION BREAKDOWN                                │
+│     └── Did I analyze each interaction individually?            │
+│         └── Did I apply Fitts' Law, Thumb Zone?                 │
+│                                                                 │
+│  5️⃣ PERFORMANCE IMPACT ANALYSIS                                │
+│     └── Did I consider performance impact of each component?    │
+│         └── Is the default solution performant?                 │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🚫 AI MOBILE DEFAULTS (FORBIDDEN LIST)
+
+### Using These Patterns Automatically is FORBIDDEN!
+
+The following patterns are "defaults" that AIs learned from training data.
+Before using any of these, **QUESTION them and CONSIDER ALTERNATIVES!**
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                 🚫 AI MOBILE SAFE HARBOR                        │
+│           (Default Patterns - Never Use Without Questioning)    │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  NAVIGATION DEFAULTS:                                           │
+│  ├── Tab bar for every project (Would drawer be better?)        │
+│  ├── Fixed 5 tabs (Are 3 enough? For 6+, drawer?)               │
+│  ├── "Home" tab on left (What does user behavior say?)          │
+│  └── Hamburger menu (Is it outdated now?)                       │
+│                                                                 │
+│  STATE MANAGEMENT DEFAULTS:                                     │
+│  ├── Redux everywhere (Is Zustand/Jotai sufficient?)            │
+│  ├── Global state for everything (Isn't local state enough?)   │
+│  ├── Context Provider hell (Is atom-based better?)              │
+│  └── BLoC for every Flutter project (Is Riverpod more modern?)  │
+│                                                                 │
+│  LIST IMPLEMENTATION DEFAULTS:                                  │
+│  ├── FlatList as default (Is FlashList more performant?)        │
+│  ├── windowSize=21 (Is it really needed?)                       │
+│  ├── removeClippedSubviews (Always?)                            │
+│  └── ListView.builder (Is ListView.separated better?)           │
+│                                                                 │
+│  UI PATTERN DEFAULTS:                                           │
+│  ├── FAB bottom-right (Is bottom-left more accessible?)         │
+│  ├── Pull-to-refresh on every list (Is it needed everywhere?)   │
+│  ├── Swipe-to-delete from left (Is right better?)               │
+│  └── Bottom sheet for every modal (Is full screen better?)      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🔍 COMPONENT DECOMPOSITION (MANDATORY)
+
+### Decomposition Analysis for Every Screen
+
+Before designing any screen, perform this analysis:
+
+```
+SCREEN: [Screen Name]
+├── PRIMARY ACTION: [What is the main action?]
+│   └── Is it in thumb zone? [Yes/No → Why?]
+│
+├── TOUCH TARGETS: [All tappable elements]
+│   ├── [Element 1]: [Size]pt → Sufficient?
+│   ├── [Element 2]: [Size]pt → Sufficient?
+│   └── Spacing: [Gap]pt → Accidental tap risk?
+│
+├── SCROLLABLE CONTENT:
+│   ├── Is it a list? → FlatList/FlashList [Why this choice?]
+│   ├── Item count: ~[N] → Performance consideration?
+│   └── Fixed height? → Is getItemLayout needed?
+│
+├── STATE REQUIREMENTS:
+│   ├── Is local state sufficient?
+│   ├── Do I need to lift state?
+│   └── Is global required? [Why?]
+│
+├── PLATFORM DIFFERENCES:
+│   ├── iOS: [Anything different needed?]
+│   └── Android: [Anything different needed?]
+│
+├── OFFLINE CONSIDERATION:
+│   ├── Should this screen work offline?
+│   └── Cache strategy: [Yes/No/Which one?]
+│
+└── PERFORMANCE IMPACT:
+    ├── Any heavy components?
+    ├── Is memoization needed?
+    └── Animation performance?
+```
+
+---
+
+## 🎯 PATTERN QUESTIONING MATRIX
+
+Ask these questions for every default pattern:
+
+### Navigation Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "I'll use tab bar" | How many destinations? | 3 → minimal tabs, 6+ → drawer |
+| "5 tabs" | Are all equally important? | "More" tab? Drawer hybrid? |
+| "Bottom nav" | iPad/tablet support? | Navigation rail alternative |
+| "Stack navigation" | Did I consider deep links? | URL structure = navigation structure |
+
+### State Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "I'll use Redux" | How complex is the app? | Simple: Zustand, Server: TanStack |
+| "Global state" | Is this state really global? | Local lift, Context selector |
+| "Context Provider" | Will re-render be an issue? | Zustand, Jotai (atom-based) |
+| "BLoC pattern" | Is the boilerplate worth it? | Riverpod (less code) |
+
+### List Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "FlatList" | Is performance critical? | FlashList (faster) |
+| "Standard renderItem" | Is it memoized? | useCallback + React.memo |
+| "Index key" | Does data order change? | Use item.id |
+| "ListView" | Are there separators? | ListView.separated |
+
+### UI Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "FAB bottom-right" | User handedness? | Accessibility settings |
+| "Pull-to-refresh" | Does this list need refresh? | Only when necessary |
+| "Modal bottom sheet" | How much content? | Full screen modal might be better |
+| "Swipe actions" | Discoverability? | Visible button alternative |
+
+---
+
+## 🧪 ANTI-MEMORIZATION TEST
+
+### Ask Yourself Before Every Solution
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    ANTI-MEMORIZATION CHECKLIST                  │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  □ Did I pick this solution "because I always do it this way"?  │
+│    → If YES: STOP. Consider alternatives.                       │
+│                                                                 │
+│  □ Is this a pattern I've seen frequently in training data?     │
+│    → If YES: Is it REALLY suitable for THIS project?            │
+│                                                                 │
+│  □ Did I write this solution automatically without thinking?    │
+│    → If YES: Step back, do decomposition.                       │
+│                                                                 │
+│  □ Did I consider an alternative approach?                      │
+│    → If NO: Think of at least 2 alternatives, then decide.      │
+│                                                                 │
+│  □ Did I think platform-specifically?                           │
+│    → If NO: Analyze iOS and Android separately.                 │
+│                                                                 │
+│  □ Did I consider performance impact of this solution?          │
+│    → If NO: What is the memory, CPU, battery impact?            │
+│                                                                 │
+│  □ Is this solution suitable for THIS project's CONTEXT?        │
+│    → If NO: Customize based on context.                         │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📊 CONTEXT-BASED DECISION PROTOCOL
+
+### Think Differently Based on Project Type
+
+```
+DETERMINE PROJECT TYPE:
+        │
+        ├── E-Commerce App
+        │   ├── Navigation: Tab (Home, Search, Cart, Account)
+        │   ├── Lists: Product grids (memoized, image optimized)
+        │   ├── Performance: Image caching CRITICAL
+        │   ├── Offline: Cart persistence, product cache
+        │   └── Special: Checkout flow, payment security
+        │
+        ├── Social/Content App
+        │   ├── Navigation: Tab (Feed, Search, Create, Notify, Profile)
+        │   ├── Lists: Infinite scroll, complex items
+        │   ├── Performance: Feed rendering CRITICAL
+        │   ├── Offline: Feed cache, draft posts
+        │   └── Special: Real-time updates, media handling
+        │
+        ├── Productivity/SaaS App
+        │   ├── Navigation: Drawer or adaptive (mobile tab, tablet rail)
+        │   ├── Lists: Data tables, forms
+        │   ├── Performance: Data sync
+        │   ├── Offline: Full offline editing
+        │   └── Special: Conflict resolution, background sync
+        │
+        ├── Utility App
+        │   ├── Navigation: Minimal (stack-only possible)
+        │   ├── Lists: Probably minimal
+        │   ├── Performance: Fast startup
+        │   ├── Offline: Core feature offline
+        │   └── Special: Widget, shortcuts
+        │
+        └── Media/Streaming App
+            ├── Navigation: Tab (Home, Search, Library, Profile)
+            ├── Lists: Horizontal carousels, vertical feeds
+            ├── Performance: Preloading, buffering
+            ├── Offline: Download management
+            └── Special: Background playback, casting
+```
+
+---
+
+## 🔄 INTERACTION BREAKDOWN
+
+### Analysis for Every Gesture
+
+Before adding any gesture:
+
+```
+GESTURE: [Gesture Type]
+├── DISCOVERABILITY:
+│   └── How will users discover this gesture?
+│       ├── Is there a visual hint?
+│       ├── Will it be shown in onboarding?
+│       └── Is there a button alternative? (MANDATORY)
+│
+├── PLATFORM CONVENTION:
+│   ├── What does this gesture mean on iOS?
+│   ├── What does this gesture mean on Android?
+│   └── Am I deviating from platform convention?
+│
+├── ACCESSIBILITY:
+│   ├── Can motor-impaired users perform this gesture?
+│   ├── Is there a VoiceOver/TalkBack alternative?
+│   └── Does it work with switch control?
+│
+├── CONFLICT CHECK:
+│   ├── Does it conflict with system gestures?
+│   │   ├── iOS: Edge swipe back
+│   │   ├── Android: Back gesture
+│   │   └── Home indicator swipe
+│   └── Is it consistent with other app gestures?
+│
+└── FEEDBACK:
+    ├── Is haptic feedback defined?
+    ├── Is visual feedback sufficient?
+    └── Is audio feedback needed?
+```
+
+---
+
+## 🎭 SPIRIT OVER CHECKLIST (Mobile Edition)
+
+### Passing the Checklist is Not Enough!
+
+| ❌ Self-Deception | ✅ Honest Assessment |
+|-------------------|----------------------|
+| "Touch target is 44px" (but on edge, unreachable) | "Can user reach it one-handed?" |
+| "I used FlatList" (but didn't memoize) | "Is scroll smooth?" |
+| "Platform-specific nav" (but only icons differ) | "Does iOS feel like iOS, Android like Android?" |
+| "Offline support exists" (but error message is generic) | "What can user actually do offline?" |
+| "Loading state exists" (but just a spinner) | "Does user know how long to wait?" |
+
+> 🔴 **Passing the checklist is NOT the goal. Creating great mobile UX IS the goal.**
+
+---
+
+## 📝 MOBILE DESIGN COMMITMENT
+
+### Fill This at the Start of Every Mobile Project
+
+```
+📱 MOBILE DESIGN COMMITMENT
+
+Project: _______________
+Platform: iOS / Android / Both
+
+1. Default pattern I will NOT use in this project:
+   └── _______________
+   
+2. Context-specific focus for this project:
+   └── _______________
+
+3. Platform-specific differences I will implement:
+   └── iOS: _______________
+   └── Android: _______________
+
+4. Area I will specifically optimize for performance:
+   └── _______________
+
+5. Unique challenge of this project:
+   └── _______________
+
+🧠 If I can't fill this commitment → I don't understand the project well enough.
+   → Go back, understand context better, ask the user.
+```
+
+---
+
+## 🚨 MANDATORY: Before Every Mobile Work
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    PRE-WORK VALIDATION                          │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  □ Did I complete Component Decomposition?                      │
+│  □ Did I fill the Pattern Questioning Matrix?                   │
+│  □ Did I pass the Anti-Memorization Test?                       │
+│  □ Did I make context-based decisions?                          │
+│  □ Did I analyze Interaction Breakdown?                         │
+│  □ Did I fill the Mobile Design Commitment?                     │
+│                                                                 │
+│  ⚠️ Do not write code without completing these!                 │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+> **Remember:** If you chose a solution "because that's how it's always done," you chose WITHOUT THINKING. Every project is unique. Every context is different. Every user behavior is specific. **THINK, then code.**
diff --git a/.agents/skills/mobile-design/mobile-navigation.md b/.agents/skills/mobile-design/mobile-navigation.md
new file mode 100644
index 0000000..ef907bf
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-navigation.md
@@ -0,0 +1,458 @@
+# Mobile Navigation Reference
+
+> Navigation patterns, deep linking, back handling, and tab/stack/drawer decisions.
+> **Navigation is the skeleton of your app—get it wrong and everything feels broken.**
+
+---
+
+## 1. Navigation Selection Decision Tree
+
+```
+WHAT TYPE OF APP?
+        │
+        ├── 3-5 top-level sections (equal importance)
+        │   └── ✅ Tab Bar / Bottom Navigation
+        │       Examples: Social, E-commerce, Utility
+        │
+        ├── Deep hierarchical content (drill down)
+        │   └── ✅ Stack Navigation
+        │       Examples: Settings, Email folders
+        │
+        ├── Many destinations (>5 top-level)
+        │   └── ✅ Drawer Navigation
+        │       Examples: Gmail, complex enterprise
+        │
+        ├── Single linear flow
+        │   └── ✅ Stack only (wizard/onboarding)
+        │       Examples: Checkout, Setup flow
+        │
+        └── Tablet/Foldable
+            └── ✅ Navigation Rail + List-Detail
+                Examples: Mail, Notes on iPad
+```
+
+---
+
+## 2. Tab Bar Navigation
+
+### When to Use
+
+```
+✅ USE Tab Bar when:
+├── 3-5 top-level destinations
+├── Destinations are of equal importance
+├── User frequently switches between them
+├── Each tab has independent navigation stack
+└── App is used in short sessions
+
+❌ AVOID Tab Bar when:
+├── More than 5 destinations
+├── Destinations have clear hierarchy
+├── Tabs would be used very unequally
+└── Content flows in a sequence
+```
+
+### Tab Bar Best Practices
+
+```
+iOS Tab Bar:
+├── Height: 49pt (83pt with home indicator)
+├── Max items: 5
+├── Icons: SF Symbols, 25×25pt
+├── Labels: Always show (accessibility)
+├── Active indicator: Tint color
+
+Android Bottom Navigation:
+├── Height: 80dp
+├── Max items: 5 (3-5 ideal)
+├── Icons: Material Symbols, 24dp
+├── Labels: Always show
+├── Active indicator: Pill shape + filled icon
+```
+
+### Tab State Preservation
+
+```
+RULE: Each tab maintains its own navigation stack.
+
+User journey:
+1. Home tab → Drill into item → Add to cart
+2. Switch to Profile tab
+3. Switch back to Home tab
+→ Should return to "Add to cart" screen, NOT home root
+
+Implementation:
+├── React Navigation: Each tab has own navigator
+├── Flutter: IndexedStack for state preservation
+└── Never reset tab stack on switch
+```
+
+---
+
+## 3. Stack Navigation
+
+### Core Concepts
+
+```
+Stack metaphor: Cards stacked on top of each other
+
+Push: Add screen on top
+Pop: Remove top screen (back)
+Replace: Swap current screen
+Reset: Clear stack, set new root
+
+Visual: New screen slides in from right (LTR)
+Back: Screen slides out to right
+```
+
+### Stack Navigation Patterns
+
+| Pattern | Use Case | Implementation |
+|---------|----------|----------------|
+| **Simple Stack** | Linear flow | Push each step |
+| **Nested Stack** | Sections with sub-navigation | Stack inside tab |
+| **Modal Stack** | Focused tasks | Present modally |
+| **Auth Stack** | Login vs Main | Conditional root |
+
+### Back Button Handling
+
+```
+iOS:
+├── Edge swipe from left (system)
+├── Back button in nav bar (optional)
+├── Interactive pop gesture
+└── Never override swipe back without good reason
+
+Android:
+├── System back button/gesture
+├── Up button in toolbar (optional, for drill-down)
+├── Predictive back animation (Android 14+)
+└── Must handle back correctly (Activity/Fragment)
+
+Cross-Platform Rule:
+├── Back ALWAYS navigates up the stack
+├── Never hijack back for other purposes
+├── Confirm before discarding unsaved data
+└── Deep links should allow full back traversal
+```
+
+---
+
+## 4. Drawer Navigation
+
+### When to Use
+
+```
+✅ USE Drawer when:
+├── More than 5 top-level destinations
+├── Less frequently accessed destinations
+├── Complex app with many features
+├── Need for branding/user info in nav
+└── Tablet/large screen with persistent drawer
+
+❌ AVOID Drawer when:
+├── 5 or fewer destinations (use tabs)
+├── All destinations equally important
+├── Mobile-first simple app
+└── Discoverability is critical (drawer is hidden)
+```
+
+### Drawer Patterns
+
+```
+Modal Drawer:
+├── Opens over content (scrim behind)
+├── Swipe to open from edge
+├── Hamburger icon ( ☰ ) triggers
+└── Most common on mobile
+
+Permanent Drawer:
+├── Always visible (large screens)
+├── Content shifts over
+├── Good for productivity apps
+└── Tablets, desktops
+
+Navigation Rail (Android):
+├── Narrow vertical strip
+├── Icons + optional labels
+├── For tablets in portrait
+└── 80dp width
+```
+
+---
+
+## 5. Modal Navigation
+
+### Modal vs Push
+
+```
+PUSH (Stack):                    MODAL:
+├── Horizontal slide             ├── Vertical slide up (sheet)
+├── Part of hierarchy            ├── Separate task
+├── Back returns                 ├── Dismiss (X) returns
+├── Same navigation context      ├── Own navigation context
+└── "Drill in"                   └── "Focus on task"
+
+USE MODAL for:
+├── Creating new content
+├── Settings/preferences
+├── Completing a transaction
+├── Self-contained workflows
+├── Quick actions
+```
+
+### Modal Types
+
+| Type | iOS | Android | Use Case |
+|------|-----|---------|----------|
+| **Sheet** | `.sheet` | Bottom Sheet | Quick tasks |
+| **Full Screen** | `.fullScreenCover` | Full Activity | Complex forms |
+| **Alert** | Alert | Dialog | Confirmations |
+| **Action Sheet** | Action Sheet | Menu/Bottom Sheet | Choose from options |
+
+### Modal Dismissal
+
+```
+Users expect to dismiss modals by:
+├── Tapping X / Close button
+├── Swiping down (sheet)
+├── Tapping scrim (non-critical)
+├── System back (Android)
+├── Hardware back (old Android)
+
+RULE: Only block dismissal for unsaved data.
+```
+
+---
+
+## 6. Deep Linking
+
+### Why Deep Links from Day One
+
+```
+Deep links enable:
+├── Push notification navigation
+├── Sharing content
+├── Marketing campaigns
+├── Spotlight/Search integration
+├── Widget navigation
+├── External app integration
+
+Building later is HARD:
+├── Requires navigation refactor
+├── Screen dependencies unclear
+├── Parameter passing complex
+└── Always plan deep links at start
+```
+
+### URL Structure
+
+```
+Scheme://host/path?params
+
+Examples:
+├── myapp://product/123
+├── https://myapp.com/product/123 (Universal/App Link)
+├── myapp://checkout?promo=SAVE20
+├── myapp://tab/profile/settings
+
+Hierarchy should match navigation:
+├── myapp://home
+├── myapp://home/product/123
+├── myapp://home/product/123/reviews
+└── URL path = navigation path
+```
+
+### Deep Link Navigation Rules
+
+```
+1. FULL STACK CONSTRUCTION
+   Deep link to myapp://product/123 should:
+   ├── Put Home at root of stack
+   ├── Push Product screen on top
+   └── Back button returns to Home
+
+2. AUTHENTICATION AWARENESS
+   If deep link requires auth:
+   ├── Save intended destination
+   ├── Redirect to login
+   ├── After login, navigate to destination
+
+3. INVALID LINKS
+   If deep link target doesn't exist:
+   ├── Navigate to fallback (home)
+   ├── Show error message
+   └── Never crash or blank screen
+
+4. STATEFUL NAVIGATION
+   Deep link during active session:
+   ├── Don't blow away current stack
+   ├── Push on top OR
+   ├── Ask user if should navigate away
+```
+
+---
+
+## 7. Navigation State Persistence
+
+### What to Persist
+
+```
+SHOULD persist:
+├── Current tab selection
+├── Scroll position in lists
+├── Form draft data
+├── Recent navigation stack
+└── User preferences
+
+SHOULD NOT persist:
+├── Modal states (dialogs)
+├── Temporary UI states
+├── Stale data (refresh on return)
+├── Authentication state (use secure storage)
+```
+
+### Implementation
+
+```javascript
+// React Navigation - State Persistence
+const [isReady, setIsReady] = useState(false);
+const [initialState, setInitialState] = useState();
+
+useEffect(() => {
+  const loadState = async () => {
+    const savedState = await AsyncStorage.getItem('NAV_STATE');
+    if (savedState) setInitialState(JSON.parse(savedState));
+    setIsReady(true);
+  };
+  loadState();
+}, []);
+
+const handleStateChange = (state) => {
+  AsyncStorage.setItem('NAV_STATE', JSON.stringify(state));
+};
+
+<NavigationContainer
+  initialState={initialState}
+  onStateChange={handleStateChange}
+>
+```
+
+---
+
+## 8. Transition Animations
+
+### Platform Defaults
+
+```
+iOS Transitions:
+├── Push: Slide from right
+├── Modal: Slide from bottom (sheet) or fade
+├── Tab switch: Cross-fade
+├── Interactive: Swipe to go back
+
+Android Transitions:
+├── Push: Fade + slide from right
+├── Modal: Slide from bottom
+├── Tab switch: Cross-fade or none
+├── Shared element: Hero animations
+```
+
+### Custom Transitions
+
+```
+When to custom:
+├── Brand identity requires it
+├── Shared element connections
+├── Special reveal effects
+└── Keep it subtle, <300ms
+
+When to use default:
+├── Most of the time
+├── Standard drill-down
+├── Platform consistency
+└── Performance critical paths
+```
+
+### Shared Element Transitions
+
+```
+Connect elements between screens:
+
+Screen A: Product card with image
+            ↓ (tap)
+Screen B: Product detail with same image (expanded)
+
+Image animates from card position to detail position.
+
+Implementation:
+├── React Navigation: shared element library
+├── Flutter: Hero widget
+├── SwiftUI: matchedGeometryEffect
+└── Compose: Shared element transitions
+```
+
+---
+
+## 9. Navigation Anti-Patterns
+
+### ❌ Navigation Sins
+
+| Anti-Pattern | Problem | Solution |
+|--------------|---------|----------|
+| **Inconsistent back** | User confused, can't predict | Always pop stack |
+| **Hidden navigation** | Features undiscoverable | Visible tabs/drawer trigger |
+| **Deep nesting** | User gets lost | Max 3-4 levels, breadcrumbs |
+| **Breaking swipe back** | iOS users frustrated | Never override gesture |
+| **No deep links** | Can't share, bad notifications | Plan from start |
+| **Tab stack reset** | Work lost on switch | Preserve tab states |
+| **Modal for primary flow** | Can't back track | Use stack navigation |
+
+### ❌ AI Navigation Mistakes
+
+```
+AI tends to:
+├── Use modals for everything (wrong)
+├── Forget tab state preservation (wrong)
+├── Skip deep linking (wrong)
+├── Override platform back behavior (wrong)
+├── Reset stack on tab switch (wrong)
+└── Ignore predictive back (Android 14+)
+
+RULE: Use platform navigation patterns.
+Don't reinvent navigation.
+```
+
+---
+
+## 10. Navigation Checklist
+
+### Before Navigation Architecture
+
+- [ ] App type determined (tabs/drawer/stack)
+- [ ] Number of top-level destinations counted
+- [ ] Deep link URL scheme planned
+- [ ] Auth flow integrated with navigation
+- [ ] Tablet/large screen considered
+
+### Before Every Screen
+
+- [ ] Can user navigate back? (not dead end)
+- [ ] Deep link to this screen planned
+- [ ] State preserved on navigate away/back
+- [ ] Transition appropriate for relationship
+- [ ] Auth required? Handled?
+
+### Before Release
+
+- [ ] All deep links tested
+- [ ] Back button works everywhere
+- [ ] Tab states preserved correctly
+- [ ] Edge swipe back works (iOS)
+- [ ] Predictive back works (Android 14+)
+- [ ] Universal/App links configured
+- [ ] Push notification deep links work
+
+---
+
+> **Remember:** Navigation is invisible when done right. Users shouldn't think about HOW to get somewhere—they just get there. If they notice navigation, something is wrong.
diff --git a/.agents/skills/mobile-design/mobile-performance.md b/.agents/skills/mobile-design/mobile-performance.md
new file mode 100644
index 0000000..dafa174
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-performance.md
@@ -0,0 +1,767 @@
+# Mobile Performance Reference
+
+> Deep dive into React Native and Flutter performance optimization, 60fps animations, memory management, and battery considerations.
+> **This file covers the #1 area where AI-generated code FAILS.**
+
+---
+
+## 1. The Mobile Performance Mindset
+
+### Why Mobile Performance is Different
+
+```
+DESKTOP:                          MOBILE:
+├── Unlimited power               ├── Battery matters
+├── Abundant RAM                  ├── RAM is shared, limited
+├── Stable network                ├── Network is unreliable
+├── CPU always available          ├── CPU throttles when hot
+└── User expects fast anyway      └── User expects INSTANT
+```
+
+### Performance Budget Concept
+
+```
+Every frame must complete in:
+├── 60fps → 16.67ms per frame
+├── 120fps (ProMotion) → 8.33ms per frame
+
+If your code takes longer:
+├── Frame drops → Janky scroll/animation
+├── User perceives as "slow" or "broken"
+└── They WILL uninstall your app
+```
+
+---
+
+## 2. React Native Performance
+
+### 🚫 The #1 AI Mistake: ScrollView for Lists
+
+```javascript
+// ❌ NEVER DO THIS - AI's favorite mistake
+<ScrollView>
+  {items.map(item => (
+    <ItemComponent key={item.id} item={item} />
+  ))}
+</ScrollView>
+
+// Why it's catastrophic:
+// ├── Renders ALL items immediately (1000 items = 1000 renders)
+// ├── Memory explodes
+// ├── Initial render takes seconds
+// └── Scroll becomes janky
+
+// ✅ ALWAYS USE FlatList
+<FlatList
+  data={items}
+  renderItem={renderItem}
+  keyExtractor={item => item.id}
+/>
+```
+
+### FlatList Optimization Checklist
+
+```javascript
+// ✅ CORRECT: All optimizations applied
+
+// 1. Memoize the item component
+const ListItem = React.memo(({ item }: { item: Item }) => {
+  return (
+    <Pressable style={styles.item}>
+      <Text>{item.title}</Text>
+    </Pressable>
+  );
+});
+
+// 2. Memoize renderItem with useCallback
+const renderItem = useCallback(
+  ({ item }: { item: Item }) => <ListItem item={item} />,
+  [] // Empty deps = never recreated
+);
+
+// 3. Stable keyExtractor (NEVER use index!)
+const keyExtractor = useCallback((item: Item) => item.id, []);
+
+// 4. Provide getItemLayout for fixed-height items
+const getItemLayout = useCallback(
+  (data: Item[] | null, index: number) => ({
+    length: ITEM_HEIGHT, // Fixed height
+    offset: ITEM_HEIGHT * index,
+    index,
+  }),
+  []
+);
+
+// 5. Apply to FlatList
+<FlatList
+  data={items}
+  renderItem={renderItem}
+  keyExtractor={keyExtractor}
+  getItemLayout={getItemLayout}
+  // Performance props
+  removeClippedSubviews={true} // Android: detach off-screen
+  maxToRenderPerBatch={10} // Items per batch
+  windowSize={5} // Render window (5 = 2 screens each side)
+  initialNumToRender={10} // Initial items
+  updateCellsBatchingPeriod={50} // Batching delay
+/>
+```
+
+### Why Each Optimization Matters
+
+| Optimization | What It Prevents | Impact |
+|--------------|------------------|--------|
+| `React.memo` | Re-render on parent change | 🔴 Critical |
+| `useCallback renderItem` | New function every render | 🔴 Critical |
+| Stable `keyExtractor` | Wrong item recycling | 🔴 Critical |
+| `getItemLayout` | Async layout calculation | 🟡 High |
+| `removeClippedSubviews` | Memory from off-screen | 🟡 High |
+| `maxToRenderPerBatch` | Blocking main thread | 🟢 Medium |
+| `windowSize` | Memory usage | 🟢 Medium |
+
+### FlashList: The Better Option
+
+```javascript
+// Consider FlashList for better performance
+import { FlashList } from "@shopify/flash-list";
+
+<FlashList
+  data={items}
+  renderItem={renderItem}
+  estimatedItemSize={ITEM_HEIGHT}
+  keyExtractor={keyExtractor}
+/>
+
+// Benefits over FlatList:
+// ├── Faster recycling
+// ├── Better memory management
+// ├── Simpler API
+// └── Fewer optimization props needed
+```
+
+### Animation Performance
+
+```javascript
+// ❌ JS-driven animation (blocks JS thread)
+Animated.timing(value, {
+  toValue: 1,
+  duration: 300,
+  useNativeDriver: false, // BAD!
+}).start();
+
+// ✅ Native-driver animation (runs on UI thread)
+Animated.timing(value, {
+  toValue: 1,
+  duration: 300,
+  useNativeDriver: true, // GOOD!
+}).start();
+
+// Native driver supports ONLY:
+// ├── transform (translate, scale, rotate)
+// └── opacity
+// 
+// Does NOT support:
+// ├── width, height
+// ├── backgroundColor
+// ├── borderRadius changes
+// └── margin, padding
+```
+
+### Reanimated for Complex Animations
+
+```javascript
+// For animations native driver can't handle, use Reanimated 3
+
+import Animated, {
+  useSharedValue,
+  useAnimatedStyle,
+  withSpring,
+} from 'react-native-reanimated';
+
+const Component = () => {
+  const offset = useSharedValue(0);
+
+  const animatedStyles = useAnimatedStyle(() => ({
+    transform: [{ translateX: withSpring(offset.value) }],
+  }));
+
+  return <Animated.View style={animatedStyles} />;
+};
+
+// Benefits:
+// ├── Runs on UI thread (60fps guaranteed)
+// ├── Can animate any property
+// ├── Gesture-driven animations
+// └── Worklets for complex logic
+```
+
+### Memory Leak Prevention
+
+```javascript
+// ❌ Memory leak: uncleared interval
+useEffect(() => {
+  const interval = setInterval(() => {
+    fetchData();
+  }, 5000);
+  // Missing cleanup!
+}, []);
+
+// ✅ Proper cleanup
+useEffect(() => {
+  const interval = setInterval(() => {
+    fetchData();
+  }, 5000);
+  
+  return () => clearInterval(interval); // CLEANUP!
+}, []);
+
+// Common memory leak sources:
+// ├── Timers (setInterval, setTimeout)
+// ├── Event listeners
+// ├── Subscriptions (WebSocket, PubSub)
+// ├── Async operations that update state after unmount
+// └── Image caching without limits
+```
+
+### React Native Performance Checklist
+
+```markdown
+## Before Every List
+- [ ] Using FlatList or FlashList (NOT ScrollView)
+- [ ] renderItem is useCallback memoized
+- [ ] List items are React.memo wrapped
+- [ ] keyExtractor uses stable ID (NOT index)
+- [ ] getItemLayout provided (if fixed height)
+
+## Before Every Animation
+- [ ] useNativeDriver: true (if possible)
+- [ ] Using Reanimated for complex animations
+- [ ] Only animating transform/opacity
+- [ ] Tested on low-end Android device
+
+## Before Any Release
+- [ ] console.log statements removed
+- [ ] Cleanup functions in all useEffects
+- [ ] No memory leaks (test with profiler)
+- [ ] Tested in release build (not dev)
+```
+
+---
+
+## 3. Flutter Performance
+
+### 🚫 The #1 AI Mistake: setState Overuse
+
+```dart
+// ❌ WRONG: setState rebuilds ENTIRE widget tree
+class BadCounter extends StatefulWidget {
+  @override
+  State<BadCounter> createState() => _BadCounterState();
+}
+
+class _BadCounterState extends State<BadCounter> {
+  int _counter = 0;
+  
+  void _increment() {
+    setState(() {
+      _counter++; // This rebuilds EVERYTHING below!
+    });
+  }
+  
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Text('Counter: $_counter'),
+        ExpensiveWidget(), // Rebuilds unnecessarily!
+        AnotherExpensiveWidget(), // Rebuilds unnecessarily!
+      ],
+    );
+  }
+}
+```
+
+### The `const` Constructor Revolution
+
+```dart
+// ✅ CORRECT: const prevents rebuilds
+
+class GoodCounter extends StatefulWidget {
+  const GoodCounter({super.key}); // CONST constructor!
+  
+  @override
+  State<GoodCounter> createState() => _GoodCounterState();
+}
+
+class _GoodCounterState extends State<GoodCounter> {
+  int _counter = 0;
+  
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Text('Counter: $_counter'),
+        const ExpensiveWidget(), // Won't rebuild!
+        const AnotherExpensiveWidget(), // Won't rebuild!
+      ],
+    );
+  }
+}
+
+// RULE: Add `const` to EVERY widget that doesn't depend on state
+```
+
+### Targeted State Management
+
+```dart
+// ❌ setState rebuilds whole tree
+setState(() => _value = newValue);
+
+// ✅ ValueListenableBuilder: surgical rebuilds
+class TargetedState extends StatelessWidget {
+  final ValueNotifier<int> counter = ValueNotifier(0);
+  
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        // Only this rebuilds when counter changes
+        ValueListenableBuilder<int>(
+          valueListenable: counter,
+          builder: (context, value, child) => Text('$value'),
+          child: const Icon(Icons.star), // Won't rebuild!
+        ),
+        const ExpensiveWidget(), // Never rebuilds
+      ],
+    );
+  }
+}
+```
+
+### Riverpod/Provider Best Practices
+
+```dart
+// ❌ WRONG: Reading entire provider in build
+Widget build(BuildContext context) {
+  final state = ref.watch(myProvider); // Rebuilds on ANY change
+  return Text(state.name);
+}
+
+// ✅ CORRECT: Select only what you need
+Widget build(BuildContext context) {
+  final name = ref.watch(myProvider.select((s) => s.name));
+  return Text(name); // Only rebuilds when name changes
+}
+```
+
+### ListView Optimization
+
+```dart
+// ❌ WRONG: ListView without builder (renders all)
+ListView(
+  children: items.map((item) => ItemWidget(item)).toList(),
+)
+
+// ✅ CORRECT: ListView.builder (lazy rendering)
+ListView.builder(
+  itemCount: items.length,
+  itemBuilder: (context, index) => ItemWidget(items[index]),
+  // Additional optimizations:
+  itemExtent: 56, // Fixed height = faster layout
+  cacheExtent: 100, // Pre-render distance
+)
+
+// ✅ EVEN BETTER: ListView.separated for dividers
+ListView.separated(
+  itemCount: items.length,
+  itemBuilder: (context, index) => ItemWidget(items[index]),
+  separatorBuilder: (context, index) => const Divider(),
+)
+```
+
+### Image Optimization
+
+```dart
+// ❌ WRONG: No caching, full resolution
+Image.network(url)
+
+// ✅ CORRECT: Cached with proper sizing
+CachedNetworkImage(
+  imageUrl: url,
+  width: 100,
+  height: 100,
+  fit: BoxFit.cover,
+  memCacheWidth: 200, // Cache at 2x for retina
+  memCacheHeight: 200,
+  placeholder: (context, url) => const Skeleton(),
+  errorWidget: (context, url, error) => const Icon(Icons.error),
+)
+```
+
+### Dispose Pattern
+
+```dart
+class MyWidget extends StatefulWidget {
+  @override
+  State<MyWidget> createState() => _MyWidgetState();
+}
+
+class _MyWidgetState extends State<MyWidget> {
+  late final StreamSubscription _subscription;
+  late final AnimationController _controller;
+  late final TextEditingController _textController;
+  
+  @override
+  void initState() {
+    super.initState();
+    _subscription = stream.listen((_) {});
+    _controller = AnimationController(vsync: this);
+    _textController = TextEditingController();
+  }
+  
+  @override
+  void dispose() {
+    // ALWAYS dispose in reverse order of creation
+    _textController.dispose();
+    _controller.dispose();
+    _subscription.cancel();
+    super.dispose();
+  }
+  
+  @override
+  Widget build(BuildContext context) => Container();
+}
+```
+
+### Flutter Performance Checklist
+
+```markdown
+## Before Every Widget
+- [ ] const constructor added (if no runtime args)
+- [ ] const keywords on static children
+- [ ] Minimal setState scope
+- [ ] Using selectors for provider watches
+
+## Before Every List
+- [ ] Using ListView.builder (NOT ListView with children)
+- [ ] itemExtent provided (if fixed height)
+- [ ] Image caching with size limits
+
+## Before Any Animation
+- [ ] Using Impeller (Flutter 3.16+)
+- [ ] Avoiding Opacity widget (use FadeTransition)
+- [ ] TickerProviderStateMixin for AnimationController
+
+## Before Any Release
+- [ ] All dispose() methods implemented
+- [ ] No print() in production
+- [ ] Tested in profile/release mode
+- [ ] DevTools performance overlay checked
+```
+
+---
+
+## 4. Animation Performance (Both Platforms)
+
+### The 60fps Imperative
+
+```
+Human eye detects:
+├── < 24 fps → "Slideshow" (broken)
+├── 24-30 fps → "Choppy" (uncomfortable)
+├── 30-45 fps → "Noticeably not smooth"
+├── 45-60 fps → "Smooth" (acceptable)
+├── 60 fps → "Buttery" (target)
+└── 120 fps → "Premium" (ProMotion devices)
+
+NEVER ship < 60fps animations.
+```
+
+### GPU vs CPU Animation
+
+```
+GPU-ACCELERATED (FAST):          CPU-BOUND (SLOW):
+├── transform: translate          ├── width, height
+├── transform: scale              ├── top, left, right, bottom
+├── transform: rotate             ├── margin, padding
+├── opacity                       ├── border-radius (animated)
+└── (Composited, off main)        └── box-shadow (animated)
+
+RULE: Only animate transform and opacity.
+Everything else causes layout recalculation.
+```
+
+### Animation Timing Guide
+
+| Animation Type | Duration | Easing |
+|----------------|----------|--------|
+| Micro-interaction | 100-200ms | ease-out |
+| Standard transition | 200-300ms | ease-out |
+| Page transition | 300-400ms | ease-in-out |
+| Complex/dramatic | 400-600ms | ease-in-out |
+| Loading skeletons | 1000-1500ms | linear (loop) |
+
+### Spring Physics
+
+```javascript
+// React Native Reanimated
+withSpring(targetValue, {
+  damping: 15,      // How quickly it settles (higher = faster stop)
+  stiffness: 150,   // How "tight" the spring (higher = faster)
+  mass: 1,          // Weight of the object
+})
+
+// Flutter
+SpringSimulation(
+  SpringDescription(
+    mass: 1,
+    stiffness: 150,
+    damping: 15,
+  ),
+  start,
+  end,
+  velocity,
+)
+
+// Natural feel ranges:
+// Damping: 10-20 (bouncy to settled)
+// Stiffness: 100-200 (loose to tight)
+// Mass: 0.5-2 (light to heavy)
+```
+
+---
+
+## 5. Memory Management
+
+### Common Memory Leaks
+
+| Source | Platform | Solution |
+|--------|----------|----------|
+| Timers | Both | Clear in cleanup/dispose |
+| Event listeners | Both | Remove in cleanup/dispose |
+| Subscriptions | Both | Cancel in cleanup/dispose |
+| Large images | Both | Limit cache, resize |
+| Async after unmount | RN | isMounted check or AbortController |
+| Animation controllers | Flutter | Dispose controllers |
+
+### Image Memory
+
+```
+Image memory = width × height × 4 bytes (RGBA)
+
+1080p image = 1920 × 1080 × 4 = 8.3 MB
+4K image = 3840 × 2160 × 4 = 33.2 MB
+
+10 4K images = 332 MB → App crash!
+
+RULE: Always resize images to display size (or 2-3x for retina).
+```
+
+### Memory Profiling
+
+```
+React Native:
+├── Flipper → Memory tab
+├── Xcode Instruments (iOS)
+└── Android Studio Profiler
+
+Flutter:
+├── DevTools → Memory tab
+├── Observatory
+└── flutter run --profile
+```
+
+---
+
+## 6. Battery Optimization
+
+### Battery Drain Sources
+
+| Source | Impact | Mitigation |
+|--------|--------|------------|
+| **Screen on** | 🔴 Highest | Dark mode on OLED |
+| **GPS continuous** | 🔴 Very high | Use significant change |
+| **Network requests** | 🟡 High | Batch, cache aggressively |
+| **Animations** | 🟡 Medium | Reduce when low battery |
+| **Background work** | 🟡 Medium | Defer non-critical |
+| **CPU computation** | 🟢 Lower | Offload to backend |
+
+### OLED Battery Saving
+
+```
+OLED screens: Black pixels = OFF = 0 power
+
+Dark mode savings:
+├── True black (#000000) → Maximum savings
+├── Dark gray (#1a1a1a) → Slight savings
+├── Any color → Some power
+└── White (#FFFFFF) → Maximum power
+
+RULE: On dark mode, use true black for backgrounds.
+```
+
+### Background Task Guidelines
+
+```
+iOS:
+├── Background refresh: Limited, system-scheduled
+├── Push notifications: Use for important updates
+├── Background modes: Location, audio, VoIP only
+└── Background tasks: Max ~30 seconds
+
+Android:
+├── WorkManager: System-scheduled, battery-aware
+├── Foreground service: Visible to user, continuous
+├── JobScheduler: Batch network operations
+└── Doze mode: Respect it, batch operations
+```
+
+---
+
+## 7. Network Performance
+
+### Offline-First Architecture
+
+```
+                    ┌──────────────┐
+                    │     UI       │
+                    └──────┬───────┘
+                           │
+                    ┌──────▼───────┐
+                    │   Cache      │ ← Read from cache FIRST
+                    └──────┬───────┘
+                           │
+                    ┌──────▼───────┐
+                    │   Network    │ ← Update cache from network
+                    └──────────────┘
+
+Benefits:
+├── Instant UI (no loading spinner for cached data)
+├── Works offline
+├── Reduces data usage
+└── Better UX on slow networks
+```
+
+### Request Optimization
+
+```
+BATCH: Combine multiple requests into one
+├── 10 small requests → 1 batch request
+├── Reduces connection overhead
+└── Better for battery (radio on once)
+
+CACHE: Don't re-fetch unchanged data
+├── ETag/If-None-Match headers
+├── Cache-Control headers
+└── Stale-while-revalidate pattern
+
+COMPRESS: Reduce payload size
+├── gzip/brotli compression
+├── Request only needed fields (GraphQL)
+└── Paginate large lists
+```
+
+---
+
+## 8. Performance Testing
+
+### What to Test
+
+| Metric | Target | Tool |
+|--------|--------|------|
+| **Frame rate** | ≥ 60fps | Performance overlay |
+| **Memory** | Stable, no growth | Profiler |
+| **Cold start** | < 2s | Manual timing |
+| **TTI (Time to Interactive)** | < 3s | Lighthouse |
+| **List scroll** | No jank | Manual feel |
+| **Animation smoothness** | No drops | Performance monitor |
+
+### Test on Real Devices
+
+```
+⚠️ NEVER trust only:
+├── Simulator/emulator (faster than real)
+├── Dev mode (slower than release)
+├── High-end devices only
+
+✅ ALWAYS test on:
+├── Low-end Android (< $200 phone)
+├── Older iOS device (iPhone 8 or SE)
+├── Release/profile build
+└── With real data (not 10 items)
+```
+
+### Performance Monitoring Checklist
+
+```markdown
+## During Development
+- [ ] Performance overlay enabled
+- [ ] Watching for dropped frames
+- [ ] Memory usage stable
+- [ ] No console warnings about performance
+
+## Before Release
+- [ ] Tested on low-end device
+- [ ] Profiled memory over extended use
+- [ ] Cold start time measured
+- [ ] List scroll tested with 1000+ items
+- [ ] Animations tested at 60fps
+- [ ] Network tested on slow 3G
+```
+
+---
+
+## 9. Quick Reference Card
+
+### React Native Essentials
+
+```javascript
+// List: Always use
+<FlatList
+  data={data}
+  renderItem={useCallback(({item}) => <MemoItem item={item} />, [])}
+  keyExtractor={useCallback(item => item.id, [])}
+  getItemLayout={useCallback((_, i) => ({length: H, offset: H*i, index: i}), [])}
+/>
+
+// Animation: Always native
+useNativeDriver: true
+
+// Cleanup: Always present
+useEffect(() => {
+  return () => cleanup();
+}, []);
+```
+
+### Flutter Essentials
+
+```dart
+// Widgets: Always const
+const MyWidget()
+
+// Lists: Always builder
+ListView.builder(itemBuilder: ...)
+
+// State: Always targeted
+ValueListenableBuilder() or ref.watch(provider.select(...))
+
+// Dispose: Always cleanup
+@override
+void dispose() {
+  controller.dispose();
+  super.dispose();
+}
+```
+
+### Animation Targets
+
+```
+Transform/Opacity only ← What to animate
+16.67ms per frame ← Time budget
+60fps minimum ← Target
+Low-end Android ← Test device
+```
+
+---
+
+> **Remember:** Performance is not optimization—it's baseline quality. A slow app is a broken app. Test on the worst device your users have, not the best device you have.
diff --git a/.agents/skills/mobile-design/mobile-testing.md b/.agents/skills/mobile-design/mobile-testing.md
new file mode 100644
index 0000000..733f64a
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-testing.md
@@ -0,0 +1,356 @@
+# Mobile Testing Patterns
+
+> **Mobile testing is NOT web testing. Different constraints, different strategies.**
+> This file teaches WHEN to use each testing approach and WHY.
+> **Code examples are minimal - focus on decision-making.**
+
+---
+
+## 🧠 MOBILE TESTING MINDSET
+
+```
+Mobile testing differs from web:
+├── Real devices matter (emulators hide bugs)
+├── Platform differences (iOS vs Android behavior)
+├── Network conditions vary wildly
+├── Battery/performance under test
+├── App lifecycle (background, killed, restored)
+├── Permissions and system dialogs
+└── Touch interactions vs clicks
+```
+
+---
+
+## 🚫 AI MOBILE TESTING ANTI-PATTERNS
+
+| ❌ AI Default | Why It's Wrong | ✅ Mobile-Correct |
+|---------------|----------------|-------------------|
+| Jest-only testing | Misses native layer | Jest + E2E on device |
+| Enzyme patterns | Deprecated, web-focused | React Native Testing Library |
+| Browser-based E2E (Cypress) | Can't test native features | Detox / Maestro |
+| Mock everything | Misses integration bugs | Real device testing |
+| Ignore platform tests | iOS/Android differ | Platform-specific cases |
+| Skip performance tests | Mobile perf is critical | Profile on low-end device |
+| Test only happy path | Mobile has more edge cases | Offline, permissions, interrupts |
+| 100% unit test coverage | False security | Pyramid balance |
+| Copy web testing patterns | Different environment | Mobile-specific tools |
+
+---
+
+## 1. Testing Tool Selection
+
+### Decision Tree
+
+```
+WHAT ARE YOU TESTING?
+        │
+        ├── Pure functions, utilities, helpers
+        │   └── Jest (unit tests)
+        │       └── No special mobile setup needed
+        │
+        ├── Individual components (isolated)
+        │   ├── React Native → React Native Testing Library
+        │   └── Flutter → flutter_test (widget tests)
+        │
+        ├── Components with hooks, context, navigation
+        │   ├── React Native → RNTL + mocked providers
+        │   └── Flutter → integration_test package
+        │
+        ├── Full user flows (login, checkout, etc.)
+        │   ├── Detox (React Native, fast, reliable)
+        │   ├── Maestro (Cross-platform, YAML-based)
+        │   └── Appium (Legacy, slow, last resort)
+        │
+        └── Performance, memory, battery
+            ├── Flashlight (RN performance)
+            ├── Flutter DevTools
+            └── Real device profiling (Xcode/Android Studio)
+```
+
+### Tool Comparison
+
+| Tool | Platform | Speed | Reliability | Use When |
+|------|----------|-------|-------------|----------|
+| **Jest** | RN | ⚡⚡⚡ | ⚡⚡⚡ | Unit tests, logic |
+| **RNTL** | RN | ⚡⚡⚡ | ⚡⚡ | Component tests |
+| **flutter_test** | Flutter | ⚡⚡⚡ | ⚡⚡⚡ | Widget tests |
+| **Detox** | RN | ⚡⚡ | ⚡⚡⚡ | E2E, critical flows |
+| **Maestro** | Both | ⚡⚡ | ⚡⚡ | E2E, cross-platform |
+| **Appium** | Both | ⚡ | ⚡ | Legacy, last resort |
+
+---
+
+## 2. Testing Pyramid for Mobile
+
+```
+                    ┌───────────────┐
+                    │    E2E Tests  │  10%
+                    │  (Real device) │  Slow, expensive, essential
+                    ├───────────────┤
+                    │  Integration  │  20%
+                    │    Tests      │  Component + context
+                    ├───────────────┤
+                    │  Component    │  30%
+                    │    Tests      │  Isolated UI
+                    ├───────────────┤
+                    │   Unit Tests  │  40%
+                    │    (Jest)     │  Pure logic
+                    └───────────────┘
+```
+
+### Why This Distribution?
+
+| Level | Why This % |
+|-------|------------|
+| **E2E 10%** | Slow, flaky, but catches integration bugs |
+| **Integration 20%** | Tests real user flows without full app |
+| **Component 30%** | Fast feedback on UI changes |
+| **Unit 40%** | Fastest, most stable, logic coverage |
+
+> 🔴 **If you have 90% unit tests and 0% E2E, you're testing the wrong things.**
+
+---
+
+## 3. What to Test at Each Level
+
+### Unit Tests (Jest)
+
+```
+✅ TEST:
+├── Utility functions (formatDate, calculatePrice)
+├── State reducers (Redux, Zustand stores)
+├── API response transformers
+├── Validation logic
+└── Business rules
+
+❌ DON'T TEST:
+├── Component rendering (use component tests)
+├── Navigation (use integration tests)
+├── Native modules (mock them)
+└── Third-party libraries
+```
+
+### Component Tests (RNTL / flutter_test)
+
+```
+✅ TEST:
+├── Component renders correctly
+├── User interactions (tap, type, swipe)
+├── Loading/error/empty states
+├── Accessibility labels exist
+└── Props change behavior
+
+❌ DON'T TEST:
+├── Internal implementation details
+├── Snapshot everything (only key components)
+├── Styling specifics (brittle)
+└── Third-party component internals
+```
+
+### Integration Tests
+
+```
+✅ TEST:
+├── Form submission flows
+├── Navigation between screens
+├── State persistence across screens
+├── API integration (with mocked server)
+└── Context/provider interactions
+
+❌ DON'T TEST:
+├── Every possible path (use unit tests)
+├── Third-party services (mock them)
+└── Backend logic (backend tests)
+```
+
+### E2E Tests
+
+```
+✅ TEST:
+├── Critical user journeys (login, purchase, signup)
+├── Offline → online transitions
+├── Deep link handling
+├── Push notification navigation
+├── Permission flows
+└── Payment flows
+
+❌ DON'T TEST:
+├── Every edge case (too slow)
+├── Visual regression (use snapshot tests)
+├── Non-critical features
+└── Backend-only logic
+```
+
+---
+
+## 4. Platform-Specific Testing
+
+### What Differs Between iOS and Android?
+
+| Area | iOS Behavior | Android Behavior | Test Both? |
+|------|--------------|------------------|------------|
+| **Back navigation** | Edge swipe | System back button | ✅ YES |
+| **Permissions** | Ask once, settings | Ask each time, rationale | ✅ YES |
+| **Keyboard** | Different appearance | Different behavior | ✅ YES |
+| **Date picker** | Wheel/modal | Material dialog | ⚠️ If custom UI |
+| **Push format** | APNs payload | FCM payload | ✅ YES |
+| **Deep links** | Universal Links | App Links | ✅ YES |
+| **Gestures** | Some unique | Material gestures | ⚠️ If custom |
+
+### Platform Testing Strategy
+
+```
+FOR EACH PLATFORM:
+├── Run unit tests (same on both)
+├── Run component tests (same on both)
+├── Run E2E on REAL DEVICE
+│   ├── iOS: iPhone (not just simulator)
+│   └── Android: Mid-range device (not flagship)
+└── Test platform-specific features separately
+```
+
+---
+
+## 5. Offline & Network Testing
+
+### Offline Scenarios to Test
+
+| Scenario | What to Verify |
+|----------|----------------|
+| Start app offline | Shows cached data or offline message |
+| Go offline mid-action | Action queued, not lost |
+| Come back online | Queue synced, no duplicates |
+| Slow network (2G) | Loading states, timeouts work |
+| Flaky network | Retry logic, error recovery |
+
+### How to Test Network Conditions
+
+```
+APPROACH:
+├── Unit tests: Mock NetInfo, test logic
+├── Integration: Mock API responses, test UI
+├── E2E (Detox): Use device.setURLBlacklist()
+├── E2E (Maestro): Use network conditions
+└── Manual: Use Charles Proxy / Network Link Conditioner
+```
+
+---
+
+## 6. Performance Testing
+
+### What to Measure
+
+| Metric | Target | How to Measure |
+|--------|--------|----------------|
+| **App startup** | < 2 seconds | Profiler, Flashlight |
+| **Screen transition** | < 300ms | React DevTools |
+| **List scroll** | 60 FPS | Profiler, feel |
+| **Memory** | Stable, no leaks | Instruments / Android Profiler |
+| **Bundle size** | Minimize | Metro bundler analysis |
+
+### When to Performance Test
+
+```
+PERFORMANCE TEST:
+├── Before release (required)
+├── After adding heavy features
+├── After upgrading dependencies
+├── When users report slowness
+└── On CI (optional, automated benchmarks)
+
+WHERE TO TEST:
+├── Real device (REQUIRED)
+├── Low-end device (Galaxy A series, old iPhone)
+├── NOT on emulator (lies about performance)
+└── With production-like data (not 3 items)
+```
+
+---
+
+## 7. Accessibility Testing
+
+### What to Verify
+
+| Element | Check |
+|---------|-------|
+| Interactive elements | Have accessibilityLabel |
+| Images | Have alt text or decorative flag |
+| Forms | Labels linked to inputs |
+| Buttons | Role = button |
+| Touch targets | ≥ 44x44 (iOS) / 48x48 (Android) |
+| Color contrast | WCAG AA minimum |
+
+### How to Test
+
+```
+AUTOMATED:
+├── React Native: jest-axe
+├── Flutter: Accessibility checker in tests
+└── Lint rules for missing labels
+
+MANUAL:
+├── Enable VoiceOver (iOS) / TalkBack (Android)
+├── Navigate entire app with screen reader
+├── Test with increased text size
+└── Test with reduced motion
+```
+
+---
+
+## 8. CI/CD Integration
+
+### What to Run Where
+
+| Stage | Tests | Devices |
+|-------|-------|---------|
+| **PR** | Unit + Component | None (fast) |
+| **Merge to main** | + Integration | Simulator/Emulator |
+| **Pre-release** | + E2E | Real devices (farm) |
+| **Nightly** | Full suite | Device farm |
+
+### Device Farm Options
+
+| Service | Pros | Cons |
+|---------|------|------|
+| **Firebase Test Lab** | Free tier, Google devices | Android focus |
+| **AWS Device Farm** | Wide selection | Expensive |
+| **BrowserStack** | Good UX | Expensive |
+| **Local devices** | Free, reliable | Limited variety |
+
+---
+
+## 📝 MOBILE TESTING CHECKLIST
+
+### Before PR
+- [ ] Unit tests for new logic
+- [ ] Component tests for new UI
+- [ ] No console.logs in tests
+- [ ] Tests pass on CI
+
+### Before Release
+- [ ] E2E on real iOS device
+- [ ] E2E on real Android device
+- [ ] Tested on low-end device
+- [ ] Offline scenarios verified
+- [ ] Performance acceptable
+- [ ] Accessibility verified
+
+### What to Skip (Consciously)
+- [ ] 100% coverage (aim for meaningful coverage)
+- [ ] Every visual permutation (use snapshots sparingly)
+- [ ] Third-party library internals
+- [ ] Backend logic (separate tests)
+
+---
+
+## 🎯 Testing Questions to Ask
+
+Before writing tests, answer:
+
+1. **What could break?** → Test that
+2. **What's critical for users?** → E2E test that
+3. **What's complex logic?** → Unit test that
+4. **What's platform-specific?** → Test on both platforms
+5. **What happens offline?** → Test that scenario
+
+> **Remember:** Good mobile testing is about testing the RIGHT things, not EVERYTHING. A flaky E2E test is worse than no test. A failing unit test that catches a bug is worth 100 passing trivial tests.
diff --git a/.agents/skills/mobile-design/mobile-typography.md b/.agents/skills/mobile-design/mobile-typography.md
new file mode 100644
index 0000000..d6cd4cb
--- /dev/null
+++ b/.agents/skills/mobile-design/mobile-typography.md
@@ -0,0 +1,433 @@
+# Mobile Typography Reference
+
+> Type scale, system fonts, Dynamic Type, accessibility, and dark mode typography.
+> **Typography failures are the #1 cause of unreadable mobile apps.**
+
+---
+
+## 1. Mobile Typography Fundamentals
+
+### Why Mobile Type is Different
+
+```
+DESKTOP:                        MOBILE:
+├── 20-30" viewing distance     ├── 12-15" viewing distance
+├── Large viewport              ├── Small viewport, narrow
+├── Hover for details           ├── Tap/scroll for details
+├── Controlled lighting         ├── Variable (outdoor, etc.)
+├── Fixed font size             ├── User-controlled sizing
+└── Long reading sessions       └── Quick scanning
+```
+
+### Mobile Type Rules
+
+| Rule | Desktop | Mobile |
+|------|---------|--------|
+| **Minimum body size** | 14px | 16px (14pt/14sp) |
+| **Maximum line length** | 75 characters | 40-60 characters |
+| **Line height** | 1.4-1.5 | 1.4-1.6 (more generous) |
+| **Font weight** | Varies | Regular dominant, bold sparingly |
+| **Contrast** | AA (4.5:1) | AA minimum, AAA preferred |
+
+---
+
+## 2. System Fonts
+
+### iOS: SF Pro Family
+
+```
+San Francisco (SF) Family:
+├── SF Pro Display: Large text (≥ 20pt)
+├── SF Pro Text: Body text (< 20pt)
+├── SF Pro Rounded: Friendly contexts
+├── SF Mono: Monospace
+└── SF Compact: Apple Watch, compact UI
+
+Features:
+├── Optical sizing (auto-adjusts)
+├── Dynamic tracking (spacing)
+├── Tabular/proportional figures
+├── Excellent legibility
+```
+
+### Android: Roboto Family
+
+```
+Roboto Family:
+├── Roboto: Default sans-serif
+├── Roboto Flex: Variable font
+├── Roboto Serif: Serif option
+├── Roboto Mono: Monospace
+├── Roboto Condensed: Narrow spaces
+
+Features:
+├── Optimized for screens
+├── Wide language support
+├── Multiple weights
+├── Good at small sizes
+```
+
+### When to Use System Fonts
+
+```
+✅ USE system fonts when:
+├── Brand doesn't mandate custom font
+├── Reading efficiency is priority
+├── App feels native/integrated important
+├── Performance is critical
+├── Wide language support needed
+
+❌ AVOID system fonts when:
+├── Brand identity requires custom
+├── Design differentiation needed
+├── Editorial/magazine style
+└── (But still support accessibility)
+```
+
+### Custom Font Considerations
+
+```
+If using custom fonts:
+├── Include all weights needed
+├── Subset for file size
+├── Test at all Dynamic Type sizes
+├── Provide fallback to system
+├── Test rendering quality
+└── Check language support
+```
+
+---
+
+## 3. Type Scale
+
+### iOS Type Scale (Built-in)
+
+| Style | Size | Weight | Line Height |
+|-------|------|--------|-------------|
+| Large Title | 34pt | Bold | 41pt |
+| Title 1 | 28pt | Bold | 34pt |
+| Title 2 | 22pt | Bold | 28pt |
+| Title 3 | 20pt | Semibold | 25pt |
+| Headline | 17pt | Semibold | 22pt |
+| Body | 17pt | Regular | 22pt |
+| Callout | 16pt | Regular | 21pt |
+| Subhead | 15pt | Regular | 20pt |
+| Footnote | 13pt | Regular | 18pt |
+| Caption 1 | 12pt | Regular | 16pt |
+| Caption 2 | 11pt | Regular | 13pt |
+
+### Android Type Scale (Material 3)
+
+| Role | Size | Weight | Line Height |
+|------|------|--------|-------------|
+| Display Large | 57sp | 400 | 64sp |
+| Display Medium | 45sp | 400 | 52sp |
+| Display Small | 36sp | 400 | 44sp |
+| Headline Large | 32sp | 400 | 40sp |
+| Headline Medium | 28sp | 400 | 36sp |
+| Headline Small | 24sp | 400 | 32sp |
+| Title Large | 22sp | 400 | 28sp |
+| Title Medium | 16sp | 500 | 24sp |
+| Title Small | 14sp | 500 | 20sp |
+| Body Large | 16sp | 400 | 24sp |
+| Body Medium | 14sp | 400 | 20sp |
+| Body Small | 12sp | 400 | 16sp |
+| Label Large | 14sp | 500 | 20sp |
+| Label Medium | 12sp | 500 | 16sp |
+| Label Small | 11sp | 500 | 16sp |
+
+### Creating Custom Scale
+
+```
+If creating custom scale, use modular ratio:
+
+Recommended ratios:
+├── 1.125 (Major second): Dense UI
+├── 1.200 (Minor third): Compact
+├── 1.250 (Major third): Balanced (common)
+├── 1.333 (Perfect fourth): Spacious
+└── 1.500 (Perfect fifth): Dramatic
+
+Example with 1.25 ratio, 16px base:
+├── xs: 10px (16 ÷ 1.25 ÷ 1.25)
+├── sm: 13px (16 ÷ 1.25)
+├── base: 16px
+├── lg: 20px (16 × 1.25)
+├── xl: 25px (16 × 1.25 × 1.25)
+├── 2xl: 31px
+├── 3xl: 39px
+└── 4xl: 49px
+```
+
+---
+
+## 4. Dynamic Type / Text Scaling
+
+### iOS Dynamic Type (MANDATORY)
+
+```swift
+// ❌ WRONG: Fixed size (doesn't scale)
+Text("Hello")
+    .font(.system(size: 17))
+
+// ✅ CORRECT: Dynamic Type
+Text("Hello")
+    .font(.body) // Scales with user setting
+
+// Custom font with scaling
+Text("Hello")
+    .font(.custom("MyFont", size: 17, relativeTo: .body))
+```
+
+### Android Text Scaling (MANDATORY)
+
+```
+ALWAYS use sp for text:
+├── sp = Scale-independent pixels
+├── Scales with user font preference
+├── dp does NOT scale (don't use for text)
+
+User can scale from 85% to 200%:
+├── Default (100%): 14sp = 14dp
+├── Largest (200%): 14sp = 28dp
+
+Test at 200%!
+```
+
+### Scaling Challenges
+
+```
+Problems at large text sizes:
+├── Text overflows containers
+├── Buttons become too tall
+├── Icons look small relative to text
+├── Layouts break
+
+Solutions:
+├── Use flexible containers (not fixed height)
+├── Allow text wrapping
+├── Scale icons with text
+├── Test at extremes during development
+├── Use scrollable containers for long text
+```
+
+---
+
+## 5. Typography Accessibility
+
+### Minimum Sizes
+
+| Element | Minimum | Recommended |
+|---------|---------|-------------|
+| Body text | 14px/pt/sp | 16px/pt/sp |
+| Secondary text | 12px/pt/sp | 13-14px/pt/sp |
+| Captions | 11px/pt/sp | 12px/pt/sp |
+| Buttons | 14px/pt/sp | 14-16px/pt/sp |
+| **Nothing smaller** | 11px | - |
+
+### Contrast Requirements (WCAG)
+
+```
+Normal text (< 18pt or < 14pt bold):
+├── AA: 4.5:1 ratio minimum
+├── AAA: 7:1 ratio recommended
+
+Large text (≥ 18pt or ≥ 14pt bold):
+├── AA: 3:1 ratio minimum
+├── AAA: 4.5:1 ratio recommended
+
+Logos/decorative: No requirement
+```
+
+### Line Height for Accessibility
+
+```
+WCAG Success Criterion 1.4.12:
+
+Line height (line spacing): ≥ 1.5×
+Paragraph spacing: ≥ 2× font size
+Letter spacing: ≥ 0.12× font size
+Word spacing: ≥ 0.16× font size
+
+Mobile recommendation:
+├── Body: 1.4-1.6 line height
+├── Headings: 1.2-1.3 line height
+├── Never below 1.2
+```
+
+---
+
+## 6. Dark Mode Typography
+
+### Color Adjustments
+
+```
+Light Mode:               Dark Mode:
+├── Black text (#000)     ├── White/light gray (#E0E0E0)
+├── High contrast         ├── Slightly reduced contrast
+├── Full saturation       ├── Desaturated colors
+└── Dark = emphasis       └── Light = emphasis
+
+RULE: Don't use pure white (#FFF) on dark.
+Use off-white (#E0E0E0 to #F0F0F0) to reduce eye strain.
+```
+
+### Dark Mode Hierarchy
+
+| Level | Light Mode | Dark Mode |
+|-------|------------|-----------|
+| Primary text | #000000 | #E8E8E8 |
+| Secondary text | #666666 | #A0A0A0 |
+| Tertiary text | #999999 | #707070 |
+| Disabled text | #CCCCCC | #505050 |
+
+### Weight in Dark Mode
+
+```
+Dark mode text appears thinner due to halation
+(light bleeding into dark background)
+
+Consider:
+├── Using medium weight for body (instead of regular)
+├── Increasing letter-spacing slightly
+├── Testing on actual OLED displays
+└── Using slightly bolder weight than light mode
+```
+
+---
+
+## 7. Typography Anti-Patterns
+
+### ❌ Common Mistakes
+
+| Mistake | Problem | Fix |
+|---------|---------|-----|
+| **Fixed font sizes** | Ignores accessibility | Use dynamic sizing |
+| **Too small text** | Unreadable | Min 14pt/sp |
+| **Low contrast** | Invisible in sunlight | Min 4.5:1 |
+| **Long lines** | Hard to track | Max 60 chars |
+| **Tight line height** | Cramped, hard to read | Min 1.4× |
+| **Too many sizes** | Visual chaos | Max 5-7 sizes |
+| **All caps body** | Hard to read | Headlines only |
+| **Light gray on white** | Impossible in bright light | Higher contrast |
+
+### ❌ AI Typography Mistakes
+
+```
+AI tends to:
+├── Use fixed px values instead of pt/sp
+├── Skip Dynamic Type support
+├── Use too small text (12-14px body)
+├── Ignore line height settings
+├── Use low contrast "aesthetic" grays
+├── Apply same scale to mobile as desktop
+└── Skip testing at large text sizes
+
+RULE: Typography must SCALE.
+Test at smallest and largest settings.
+```
+
+---
+
+## 8. Font Loading & Performance
+
+### Font File Optimization
+
+```
+Font file sizes matter on mobile:
+├── Full font: 100-300KB per weight
+├── Subset (Latin): 15-40KB per weight
+├── Variable font: 100-200KB (all weights)
+
+Recommendations:
+├── Subset to needed characters
+├── Use WOFF2 format
+├── Max 2-3 font files
+├── Consider variable fonts
+├── Cache fonts appropriately
+```
+
+### Loading Strategy
+
+```
+1. SYSTEM FONT FALLBACK
+   Show system font → swap when custom loads
+   
+2. FONT DISPLAY SWAP
+   font-display: swap (CSS)
+   
+3. PRELOAD CRITICAL FONTS
+   Preload fonts needed above the fold
+   
+4. DON'T BLOCK RENDER
+   Don't wait for fonts to show content
+```
+
+---
+
+## 9. Typography Checklist
+
+### Before Any Text Design
+
+- [ ] Body text ≥ 16px/pt/sp?
+- [ ] Line height ≥ 1.4?
+- [ ] Line length ≤ 60 chars?
+- [ ] Type scale defined (max 5-7 sizes)?
+- [ ] Using pt (iOS) or sp (Android)?
+
+### Before Release
+
+- [ ] Dynamic Type tested (iOS)?
+- [ ] Font scaling tested at 200% (Android)?
+- [ ] Dark mode contrast checked?
+- [ ] Sunlight readability tested?
+- [ ] All text has proper hierarchy?
+- [ ] Custom fonts have fallbacks?
+- [ ] Long text scrolls properly?
+
+---
+
+## 10. Quick Reference
+
+### Typography Tokens
+
+```
+// iOS
+.largeTitle  // 34pt, Bold
+.title       // 28pt, Bold
+.title2      // 22pt, Bold
+.title3      // 20pt, Semibold
+.headline    // 17pt, Semibold
+.body        // 17pt, Regular
+.subheadline // 15pt, Regular
+.footnote    // 13pt, Regular
+.caption     // 12pt, Regular
+
+// Android (Material 3)
+displayLarge   // 57sp
+headlineLarge  // 32sp
+titleLarge     // 22sp
+bodyLarge      // 16sp
+labelLarge     // 14sp
+```
+
+### Minimum Sizes
+
+```
+Body:       14-16pt/sp (16 preferred)
+Secondary:  12-13pt/sp
+Caption:    11-12pt/sp
+Nothing:    < 11pt/sp
+```
+
+### Line Height
+
+```
+Headings:  1.1-1.3
+Body:      1.4-1.6
+Long text: 1.5-1.75
+```
+
+---
+
+> **Remember:** If users can't read your text, your app is broken. Typography isn't decoration—it's the primary interface. Test on real devices, in real conditions, with accessibility settings enabled.
diff --git a/.agents/skills/mobile-design/platform-android.md b/.agents/skills/mobile-design/platform-android.md
new file mode 100644
index 0000000..5aa83cc
--- /dev/null
+++ b/.agents/skills/mobile-design/platform-android.md
@@ -0,0 +1,666 @@
+# Android Platform Guidelines
+
+> Material Design 3 essentials, Android design conventions, Roboto typography, and native patterns.
+> **Read this file when building for Android devices.**
+
+---
+
+## 1. Material Design 3 Philosophy
+
+### Core Material Principles
+
+```
+MATERIAL AS METAPHOR:
+├── Surfaces exist in 3D space
+├── Light and shadow define hierarchy
+├── Motion provides continuity
+└── Bold, graphic, intentional design
+
+ADAPTIVE DESIGN:
+├── Responds to device capabilities
+├── One UI for all form factors
+├── Dynamic color from wallpaper
+└── Personalized per user
+
+ACCESSIBLE BY DEFAULT:
+├── Large touch targets
+├── Clear visual hierarchy
+├── Semantic colors
+└── Motion respects preferences
+```
+
+### Material Design Values
+
+| Value | Implementation |
+|-------|----------------|
+| **Dynamic Color** | Colors adapt to wallpaper/user preference |
+| **Personalization** | User-specific themes |
+| **Accessibility** | Built into every component |
+| **Responsiveness** | Works on all screen sizes |
+| **Consistency** | Unified design language |
+
+---
+
+## 2. Android Typography
+
+### Roboto Font Family
+
+```
+Android System Fonts:
+├── Roboto: Default sans-serif
+├── Roboto Flex: Variable font (API 33+)
+├── Roboto Serif: Serif alternative
+├── Roboto Mono: Monospace
+└── Google Sans: Google products (special license)
+```
+
+### Material Type Scale
+
+| Role | Size | Weight | Line Height | Usage |
+|------|------|--------|-------------|-------|
+| **Display Large** | 57sp | Regular | 64sp | Hero text, splash |
+| **Display Medium** | 45sp | Regular | 52sp | Large headers |
+| **Display Small** | 36sp | Regular | 44sp | Medium headers |
+| **Headline Large** | 32sp | Regular | 40sp | Page titles |
+| **Headline Medium** | 28sp | Regular | 36sp | Section headers |
+| **Headline Small** | 24sp | Regular | 32sp | Subsections |
+| **Title Large** | 22sp | Regular | 28sp | Dialogs, cards |
+| **Title Medium** | 16sp | Medium | 24sp | Lists, navigation |
+| **Title Small** | 14sp | Medium | 20sp | Tabs, secondary |
+| **Body Large** | 16sp | Regular | 24sp | Primary content |
+| **Body Medium** | 14sp | Regular | 20sp | Secondary content |
+| **Body Small** | 12sp | Regular | 16sp | Captions |
+| **Label Large** | 14sp | Medium | 20sp | Buttons, FAB |
+| **Label Medium** | 12sp | Medium | 16sp | Navigation |
+| **Label Small** | 11sp | Medium | 16sp | Chips, badges |
+
+### Scalable Pixels (sp)
+
+```
+sp = Scale-independent pixels
+
+sp automatically scales with:
+├── User font size preference
+├── Display density
+└── Accessibility settings
+
+RULE: ALWAYS use sp for text, dp for everything else.
+```
+
+### Font Weight Usage
+
+| Weight | Use Case |
+|--------|----------|
+| Regular (400) | Body text, display |
+| Medium (500) | Buttons, labels, emphasis |
+| Bold (700) | Rarely, strong emphasis only |
+
+---
+
+## 3. Material Color System
+
+### Dynamic Color (Material You)
+
+```
+Android 12+ Dynamic Color:
+
+User's wallpaper → Color extraction → App theme
+
+Your app automatically adapts to:
+├── Primary color (from wallpaper)
+├── Secondary color (complementary)
+├── Tertiary color (accent)
+├── Surface colors (derived)
+└── All semantic colors adjust
+
+RULE: Implement dynamic color for personalized feel.
+```
+
+### Semantic Color Roles
+
+```
+Surface Colors:
+├── Surface → Main background
+├── SurfaceVariant → Cards, containers
+├── SurfaceTint → Elevation overlay
+├── InverseSurface → Snackbars, tooltips
+
+On-Surface Colors:
+├── OnSurface → Primary text
+├── OnSurfaceVariant → Secondary text
+├── Outline → Borders, dividers
+├── OutlineVariant → Subtle dividers
+
+Primary Colors:
+├── Primary → Key actions, FAB
+├── OnPrimary → Text on primary
+├── PrimaryContainer → Less emphasis
+├── OnPrimaryContainer → Text on container
+
+Secondary/Tertiary: Similar pattern
+```
+
+### Error, Warning, Success Colors
+
+| Role | Light | Dark | Usage |
+|------|-------|------|-------|
+| Error | #B3261E | #F2B8B5 | Errors, destructive |
+| OnError | #FFFFFF | #601410 | Text on error |
+| ErrorContainer | #F9DEDC | #8C1D18 | Error backgrounds |
+
+### Dark Theme
+
+```
+Material Dark Theme:
+
+├── Background: #121212 (not pure black by default)
+├── Surface: #1E1E1E, #232323, etc. (elevation)
+├── Elevation: Higher = lighter overlay
+├── Reduce saturation on colors
+└── Check contrast ratios
+
+Elevation overlays (dark mode):
+├── 0dp → 0% overlay
+├── 1dp → 5% overlay
+├── 3dp → 8% overlay
+├── 6dp → 11% overlay
+├── 8dp → 12% overlay
+├── 12dp → 14% overlay
+```
+
+---
+
+## 4. Android Layout & Spacing
+
+### Layout Grid
+
+```
+Android uses 8dp baseline grid:
+
+All spacing in multiples of 8dp:
+├── 4dp: Component internal (half-step)
+├── 8dp: Minimum spacing
+├── 16dp: Standard spacing
+├── 24dp: Section spacing
+├── 32dp: Large spacing
+
+Margins:
+├── Compact (phone): 16dp
+├── Medium (small tablet): 24dp
+├── Expanded (large): 24dp+ or columns
+```
+
+### Responsive Layout
+
+```
+Window Size Classes:
+
+COMPACT (< 600dp width):
+├── Phones in portrait
+├── Single column layout
+├── Bottom navigation
+
+MEDIUM (600-840dp width):
+├── Tablets, foldables
+├── Consider 2 columns
+├── Navigation rail option
+
+EXPANDED (> 840dp width):
+├── Large tablets, desktop
+├── Multi-column layouts
+├── Navigation drawer
+```
+
+### Canonical Layouts
+
+| Layout | Use Case | Window Class |
+|--------|----------|--------------|
+| **List-Detail** | Email, messages | Medium, Expanded |
+| **Feed** | Social, news | All |
+| **Supporting Pane** | Reference content | Medium, Expanded |
+
+---
+
+## 5. Android Navigation Patterns
+
+### Navigation Components
+
+| Component | Use Case | Position |
+|-----------|----------|----------|
+| **Bottom Navigation** | 3-5 top-level destinations | Bottom |
+| **Navigation Rail** | Tablets, foldables | Left side, vertical |
+| **Navigation Drawer** | Many destinations, large screens | Left side, hidden/visible |
+| **Top App Bar** | Current context, actions | Top |
+
+### Bottom Navigation
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│         Content Area                │
+│                                     │
+├─────────────────────────────────────┤
+│  🏠     🔍     ➕     ❤️     👤    │ ← 80dp height
+│ Home   Search  FAB   Saved  Profile│
+└─────────────────────────────────────┘
+
+Rules:
+├── 3-5 destinations
+├── Icons: Material Symbols (24dp)
+├── Labels: Always visible (accessibility)
+├── Active: Filled icon + indicator pill
+├── Badge: For notifications
+├── FAB can integrate (optional)
+```
+
+### Top App Bar
+
+```
+Types:
+├── Center-aligned: Logo apps, simple
+├── Small: Compact, scrolls away
+├── Medium: Title + actions, collapses
+├── Large: Display title, collapses to small
+
+┌─────────────────────────────────────┐
+│  ☰   App Title              🔔 ⋮  │ ← 64dp (small)
+├─────────────────────────────────────┤
+│                                     │
+│         Content Area                │
+└─────────────────────────────────────┘
+
+Actions: Max 3 icons, overflow menu ( ⋮ ) for more
+```
+
+### Navigation Rail (Tablets)
+
+```
+┌───────┬─────────────────────────────┐
+│  ≡    │                             │
+│       │                             │
+│  🏠   │                             │
+│ Home  │       Content Area          │
+│       │                             │
+│  🔍   │                             │
+│Search │                             │
+│       │                             │
+│  👤   │                             │
+│Profile│                             │
+└───────┴─────────────────────────────┘
+
+Width: 80dp
+Icons: 24dp
+Labels: Below icon
+FAB: Can be at top
+```
+
+### Back Navigation
+
+```
+Android provides system back:
+├── Back button (3-button nav)
+├── Back gesture (swipe from edge)
+├── Predictive back (Android 14+)
+
+Your app must:
+├── Handle back correctly (pop stack)
+├── Support predictive back animation
+├── Never hijack/override back unexpectedly
+└── Confirm before discarding unsaved work
+```
+
+---
+
+## 6. Material Components
+
+### Buttons
+
+```
+Button Types:
+
+┌──────────────────────┐
+│    Filled Button     │  ← Primary action
+└──────────────────────┘
+
+┌──────────────────────┐
+│    Tonal Button      │  ← Secondary, less emphasis
+└──────────────────────┘
+
+┌──────────────────────┐
+│   Outlined Button    │  ← Tertiary, lower emphasis
+└──────────────────────┘
+
+    Text Button           ← Lowest emphasis
+
+Heights:
+├── Small: 40dp (when constrained)
+├── Standard: 40dp
+├── Large: 56dp (FAB size when needed)
+
+Min touch target: 48dp (even if visual is smaller)
+```
+
+### Floating Action Button (FAB)
+
+```
+FAB Types:
+├── Standard: 56dp diameter
+├── Small: 40dp diameter
+├── Large: 96dp diameter
+├── Extended: Icon + text, variable width
+
+Position: Bottom right, 16dp from edges
+Elevation: Floats above content
+
+┌─────────────────────────────────────┐
+│                                     │
+│         Content                     │
+│                                     │
+│                              ┌────┐ │
+│                              │ ➕ │ │ ← FAB
+│                              └────┘ │
+├─────────────────────────────────────┤
+│       Bottom Navigation             │
+└─────────────────────────────────────┘
+```
+
+### Cards
+
+```
+Card Types:
+├── Elevated: Shadow, resting state
+├── Filled: Background color, no shadow
+├── Outlined: Border, no shadow
+
+Card Anatomy:
+┌─────────────────────────────────────┐
+│           Header Image              │ ← Optional
+├─────────────────────────────────────┤
+│  Title / Headline                   │
+│  Subhead / Supporting text          │
+├─────────────────────────────────────┤
+│      [ Action ]    [ Action ]       │ ← Optional actions
+└─────────────────────────────────────┘
+
+Corner radius: 12dp (M3 default)
+Padding: 16dp
+```
+
+### Text Fields
+
+```
+Types:
+├── Filled: Background fill, underline
+├── Outlined: Border all around
+
+┌─────────────────────────────────────┐
+│  Label                              │ ← Floats up on focus
+│  ________________________________________________
+│  │     Input text here...          │ ← Leading/trailing icons
+│  ‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
+│  Supporting text or error           │
+└─────────────────────────────────────┘
+
+Height: 56dp
+Label: Animates from placeholder to top
+Error: Red color + icon + message
+```
+
+### Chips
+
+```
+Types:
+├── Assist: Smart actions (directions, call)
+├── Filter: Toggle filters
+├── Input: Represent entities (tags, contacts)
+├── Suggestion: Dynamic recommendations
+
+┌───────────────┐
+│  🏷️ Filter   │  ← 32dp height, 8dp corner radius
+└───────────────┘
+
+States: Unselected, Selected, Disabled
+```
+
+---
+
+## 7. Android-Specific Patterns
+
+### Snackbars
+
+```
+Position: Bottom, above navigation
+Duration: 4-10 seconds
+Action: One optional text action
+
+┌─────────────────────────────────────────────────┐
+│  Archived 1 item                    [ UNDO ]    │
+└─────────────────────────────────────────────────┘
+
+Rules:
+├── Brief message, single line if possible
+├── Max 2 lines
+├── One action (text, not icon)
+├── Can be dismissed by swipe
+└── Don't stack, queue them
+```
+
+### Bottom Sheets
+
+```
+Types:
+├── Standard: Interactive content
+├── Modal: Blocks background (with scrim)
+
+Modal Bottom Sheet:
+┌─────────────────────────────────────┐
+│                                     │
+│        (Scrim over content)         │
+│                                     │
+├═════════════════════════════════════┤
+│  ─────  (Drag handle, optional)     │
+│                                     │
+│        Sheet Content                │
+│                                     │
+│        Actions / Options            │
+│                                     │
+└─────────────────────────────────────┘
+
+Corner radius: 28dp (top corners)
+```
+
+### Dialogs
+
+```
+Types:
+├── Basic: Title + content + actions
+├── Full-screen: Complex editing (mobile)
+├── Date/Time picker
+├── Confirmation dialog
+
+┌─────────────────────────────────────┐
+│              Title                  │
+│                                     │
+│       Supporting text that          │
+│       explains the dialog           │
+│                                     │
+│           [ Cancel ]  [ Confirm ]   │
+└─────────────────────────────────────┘
+
+Rules:
+├── Centered on screen
+├── Scrim behind (dim background)
+├── Max 2 actions aligned right
+├── Destructive action can be on left
+```
+
+### Pull to Refresh
+
+```
+Android uses SwipeRefreshLayout pattern:
+
+┌─────────────────────────────────────┐
+│         ○ (Spinner)                 │ ← Circular progress
+├─────────────────────────────────────┤
+│                                     │
+│         Content                     │
+│                                     │
+└─────────────────────────────────────┘
+
+Spinner: Material circular indicator
+Position: Top center, pulls down with content
+```
+
+### Ripple Effect
+
+```
+Every touchable element needs ripple:
+
+Touch down → Ripple expands from touch point
+Touch up → Ripple completes and fades
+
+Color: 
+├── On light: Black at ~12% opacity
+├── On dark: White at ~12% opacity
+├── On colored: Appropriate contrast
+
+This is MANDATORY for Android feel.
+```
+
+---
+
+## 8. Material Symbols
+
+### Usage Guidelines
+
+```
+Material Symbols: Google's icon library
+
+Styles:
+├── Outlined: Default, most common
+├── Rounded: Softer, friendly
+├── Sharp: Angular, precise
+
+Variable font axes:
+├── FILL: 0 (outline) to 1 (filled)
+├── wght: 100-700 (weight)
+├── GRAD: -25 to 200 (emphasis)
+├── opsz: 20, 24, 40, 48 (optical size)
+```
+
+### Icon Sizes
+
+| Size | Usage |
+|------|-------|
+| 20dp | Dense UI, inline |
+| 24dp | Standard (most common) |
+| 40dp | Larger touch targets |
+| 48dp | Emphasis, standalone |
+
+### States
+
+```
+Icon States:
+├── Default: Full opacity
+├── Disabled: 38% opacity
+├── Hover/Focus: Container highlight
+├── Selected: Filled variant + tint
+
+Active vs Inactive:
+├── Inactive: Outlined
+├── Active: Filled + indicator
+```
+
+---
+
+## 9. Android Accessibility
+
+### TalkBack Requirements
+
+```
+Every interactive element needs:
+├── contentDescription (what it is)
+├── Correct semantics (button, checkbox, etc.)
+├── State announcements (selected, disabled)
+└── Grouping where logical
+
+Jetpack Compose:
+Modifier.semantics {
+    contentDescription = "Play button"
+    role = Role.Button
+}
+
+React Native:
+accessibilityLabel="Play button"
+accessibilityRole="button"
+accessibilityState={{ disabled: false }}
+```
+
+### Touch Target Size
+
+```
+MANDATORY: 48dp × 48dp minimum
+
+Even if visual element is smaller:
+├── Icon: 24dp visual, 48dp touch area
+├── Checkbox: 20dp visual, 48dp touch area
+└── Add padding to reach 48dp
+
+Spacing between targets: 8dp minimum
+```
+
+### Font Scaling
+
+```
+Android supports font scaling:
+├── 85% (smaller)
+├── 100% (default)
+├── 115%, 130%, 145%...
+├── Up to 200% (largest)
+
+RULE: Test your UI at 200% font scale.
+Use sp units and avoid fixed heights.
+```
+
+### Reduce Motion
+
+```kotlin
+// Check motion preference
+val reduceMotion = Settings.Global.getFloat(
+    contentResolver,
+    Settings.Global.ANIMATOR_DURATION_SCALE,
+    1f
+) == 0f
+
+if (reduceMotion) {
+    // Skip or reduce animations
+}
+```
+
+---
+
+## 10. Android Checklist
+
+### Before Every Android Screen
+
+- [ ] Using Material 3 components
+- [ ] Touch targets ≥ 48dp
+- [ ] Ripple effect on all touchables
+- [ ] Roboto or Material type scale
+- [ ] Semantic colors (dynamic color support)
+- [ ] Back navigation works correctly
+
+### Before Android Release
+
+- [ ] Dark theme tested
+- [ ] Dynamic color tested (if supported)
+- [ ] All font sizes tested (200% scale)
+- [ ] TalkBack tested
+- [ ] Predictive back implemented (Android 14+)
+- [ ] Edge-to-edge display (Android 15+)
+- [ ] Different screen sizes tested (phones, tablets)
+- [ ] Navigation patterns match platform (back, gestures)
+
+---
+
+> **Remember:** Android users expect Material Design. Custom designs that ignore Material patterns feel foreign and broken. Use Material components as your foundation, customize thoughtfully.
diff --git a/.agents/skills/mobile-design/platform-ios.md b/.agents/skills/mobile-design/platform-ios.md
new file mode 100644
index 0000000..3523157
--- /dev/null
+++ b/.agents/skills/mobile-design/platform-ios.md
@@ -0,0 +1,561 @@
+# iOS Platform Guidelines
+
+> Human Interface Guidelines (HIG) essentials, iOS design conventions, SF Pro typography, and native patterns.
+> **Read this file when building for iPhone/iPad.**
+
+---
+
+## 1. Human Interface Guidelines Philosophy
+
+### Core Apple Design Principles
+
+```
+CLARITY:
+├── Text is legible at every size
+├── Icons are precise and lucid
+├── Adornments are subtle and appropriate
+└── Focus on functionality drives design
+
+DEFERENCE:
+├── UI helps people understand and interact
+├── Content fills the screen
+├── UI never competes with content
+└── Translucency hints at more content
+
+DEPTH:
+├── Distinct visual layers convey hierarchy
+├── Transitions provide sense of depth
+├── Touch reveals functionality
+└── Content is elevated over UI
+```
+
+### iOS Design Values
+
+| Value | Implementation |
+|-------|----------------|
+| **Aesthetic Integrity** | Design matches function (game ≠ productivity) |
+| **Consistency** | Use system controls, familiar patterns |
+| **Direct Manipulation** | Touch directly affects content |
+| **Feedback** | Actions are acknowledged |
+| **Metaphors** | Real-world comparisons aid understanding |
+| **User Control** | User initiates actions, can cancel |
+
+---
+
+## 2. iOS Typography
+
+### SF Pro Font Family
+
+```
+iOS System Fonts:
+├── SF Pro Text: Body text (< 20pt)
+├── SF Pro Display: Large titles (≥ 20pt)
+├── SF Pro Rounded: Friendly contexts
+├── SF Mono: Code, tabular data
+└── SF Compact: Apple Watch, smaller screens
+```
+
+### iOS Type Scale (Dynamic Type)
+
+| Style | Default Size | Weight | Usage |
+|-------|--------------|--------|-------|
+| **Large Title** | 34pt | Bold | Navigation bar (scroll collapse) |
+| **Title 1** | 28pt | Bold | Page titles |
+| **Title 2** | 22pt | Bold | Section headers |
+| **Title 3** | 20pt | Semibold | Subsection headers |
+| **Headline** | 17pt | Semibold | Emphasized body |
+| **Body** | 17pt | Regular | Primary content |
+| **Callout** | 16pt | Regular | Secondary content |
+| **Subhead** | 15pt | Regular | Tertiary content |
+| **Footnote** | 13pt | Regular | Caption, timestamps |
+| **Caption 1** | 12pt | Regular | Annotations |
+| **Caption 2** | 11pt | Regular | Fine print |
+
+### Dynamic Type Support (MANDATORY)
+
+```swift
+// ❌ WRONG: Fixed font size
+Text("Hello")
+    .font(.system(size: 17))
+
+// ✅ CORRECT: Dynamic Type
+Text("Hello")
+    .font(.body) // Scales with user settings
+
+// React Native equivalent
+<Text style={{ fontSize: 17 }}> // ❌ Fixed
+<Text style={styles.body}> // Use a dynamic scale system
+```
+
+### Font Weight Usage
+
+| Weight | iOS Constant | Use Case |
+|--------|--------------|----------|
+| Regular (400) | `.regular` | Body text |
+| Medium (500) | `.medium` | Buttons, emphasis |
+| Semibold (600) | `.semibold` | Subheadings |
+| Bold (700) | `.bold` | Titles, key info |
+| Heavy (800) | `.heavy` | Rarely, marketing |
+
+---
+
+## 3. iOS Color System
+
+### System Colors (Semantic)
+
+```
+Use semantic colors for automatic dark mode:
+
+Primary:
+├── .label → Primary text
+├── .secondaryLabel → Secondary text
+├── .tertiaryLabel → Tertiary text
+├── .quaternaryLabel → Watermarks
+
+Backgrounds:
+├── .systemBackground → Main background
+├── .secondarySystemBackground → Grouped content
+├── .tertiarySystemBackground → Elevated content
+
+Fills:
+├── .systemFill → Large shapes
+├── .secondarySystemFill → Medium shapes
+├── .tertiarySystemFill → Small shapes
+├── .quaternarySystemFill → Subtle shapes
+```
+
+### System Accent Colors
+
+| Color | Light Mode | Dark Mode | Usage |
+|-------|------------|-----------|-------|
+| Blue | #007AFF | #0A84FF | Links, highlights, default tint |
+| Green | #34C759 | #30D158 | Success, positive |
+| Red | #FF3B30 | #FF453A | Errors, destructive |
+| Orange | #FF9500 | #FF9F0A | Warnings |
+| Yellow | #FFCC00 | #FFD60A | Attention |
+| Purple | #AF52DE | #BF5AF2 | Special features |
+| Pink | #FF2D55 | #FF375F | Affection, favorites |
+| Teal | #5AC8FA | #64D2FF | Information |
+
+### Dark Mode Considerations
+
+```
+iOS Dark Mode is not inverted light mode:
+
+LIGHT MODE:              DARK MODE:
+├── White backgrounds    ├── True black (#000) or near-black
+├── High saturation      ├── Desaturated colors
+├── Black text           ├── White/light gray text
+└── Drop shadows         └── Glows or no shadows
+
+RULE: Always use semantic colors for automatic adaptation.
+```
+
+---
+
+## 4. iOS Layout & Spacing
+
+### Safe Areas
+
+```
+┌─────────────────────────────────────┐
+│░░░░░░░░░░░ Status Bar ░░░░░░░░░░░░░│ ← Top safe area inset
+├─────────────────────────────────────┤
+│                                     │
+│                                     │
+│         Safe Content Area           │
+│                                     │
+│                                     │
+├─────────────────────────────────────┤
+│░░░░░░░░░ Home Indicator ░░░░░░░░░░░│ ← Bottom safe area inset
+└─────────────────────────────────────┘
+
+RULE: Never place interactive content in unsafe areas.
+```
+
+### Standard Margins & Padding
+
+| Element | Margin | Notes |
+|---------|--------|-------|
+| Screen edge → content | 16pt | Standard horizontal margin |
+| Grouped table sections | 16pt top/bottom | Breathing room |
+| List item padding | 16pt horizontal | Standard cell padding |
+| Card internal padding | 16pt | Content within cards |
+| Button internal padding | 12pt vertical, 16pt horizontal | Minimum |
+
+### iOS Grid System
+
+```
+iPhone Grid (Standard):
+├── 16pt margins (left/right)
+├── 8pt minimum spacing
+├── Content in 8pt multiples
+
+iPhone Grid (Compact):
+├── 8pt margins (when needed)
+├── 4pt minimum spacing
+
+iPad Grid:
+├── 20pt margins (or more)
+├── Consider multi-column layouts
+```
+
+---
+
+## 5. iOS Navigation Patterns
+
+### Navigation Types
+
+| Pattern | Use Case | Implementation |
+|---------|----------|----------------|
+| **Tab Bar** | 3-5 top-level sections | Bottom, always visible |
+| **Navigation Controller** | Hierarchical drill-down | Stack-based, back button |
+| **Modal** | Focused task, interruption | Sheet or full-screen |
+| **Sidebar** | iPad, multi-column | Left sidebar (iPad) |
+
+### Tab Bar Guidelines
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│         Content Area                │
+│                                     │
+├─────────────────────────────────────┤
+│  🏠     🔍     ➕     ❤️     👤    │ ← Tab bar (49pt height)
+│ Home   Search  New   Saved  Profile │
+└─────────────────────────────────────┘
+
+Rules:
+├── 3-5 items maximum
+├── Icons: SF Symbols or custom (25×25pt)
+├── Labels: Always include (accessibility)
+├── Active state: Filled icon + tint color
+└── Tab bar always visible (don't hide on scroll)
+```
+
+### Navigation Bar Guidelines
+
+```
+┌─────────────────────────────────────┐
+│ < Back     Page Title      Edit    │ ← Navigation bar (44pt)
+├─────────────────────────────────────┤
+│                                     │
+│         Content Area                │
+│                                     │
+└─────────────────────────────────────┘
+
+Rules:
+├── Back button: System chevron + previous title (or "Back")
+├── Title: Centered, dynamic font
+├── Right actions: Max 2 items
+├── Large title: Collapses on scroll (optional)
+└── Prefer text buttons over icons (clarity)
+```
+
+### Modal Presentations
+
+| Style | Use Case | Appearance |
+|-------|----------|------------|
+| **Sheet (default)** | Secondary tasks | Card slides up, parent visible |
+| **Full Screen** | Immersive tasks | Covers entire screen |
+| **Popover** | iPad, quick info | Arrow-pointed bubble |
+| **Alert** | Critical interruption | Centered dialog |
+| **Action Sheet** | Choices from context | Bottom sheet with options |
+
+### Gestures
+
+| Gesture | iOS Convention |
+|---------|----------------|
+| **Edge swipe (left)** | Navigate back |
+| **Pull down (sheet)** | Dismiss modal |
+| **Long press** | Context menu |
+| **Deep press** | Peek/Pop (legacy) |
+| **Two-finger swipe** | Scroll in nested scroll |
+
+---
+
+## 6. iOS Components
+
+### Buttons
+
+```
+Button Styles (UIKit/SwiftUI):
+
+┌──────────────────────────────┐
+│         Tinted               │ ← Primary action (filled)
+├──────────────────────────────┤
+│         Bordered             │ ← Secondary action (outline)
+├──────────────────────────────┤
+│         Plain                │ ← Tertiary action (text only)
+└──────────────────────────────┘
+
+Sizes:
+├── Mini: Tight spaces
+├── Small: Compact UI
+├── Medium: Inline actions
+├── Large: Primary CTAs (44pt minimum height)
+```
+
+### Lists & Tables
+
+```
+List Styles:
+
+.plain         → No separators, edge-to-edge
+.insetGrouped  → Rounded cards (default iOS 14+)
+.grouped       → Full-width sections
+.sidebar       → iPad sidebar navigation
+
+Cell Accessories:
+├── Disclosure indicator (>) → Navigates to detail
+├── Detail button (i) → Shows info without navigation
+├── Checkmark (✓) → Selection
+├── Reorder (≡) → Drag to reorder
+└── Delete (-) → Swipe/edit mode delete
+```
+
+### Text Fields
+
+```
+iOS Text Field Anatomy:
+
+┌─────────────────────────────────────┐
+│ 🔍 Search...                    ✕  │
+└─────────────────────────────────────┘
+  ↑                               ↑
+  Leading icon                   Clear button
+
+Borders: Rounded rectangle
+Height: 36pt minimum
+Placeholder: Secondary text color
+Clear button: Appears when has text
+```
+
+### Segmented Controls
+
+```
+When to Use:
+├── 2-5 related options
+├── Filter content
+├── Switch views
+
+┌───────┬───────┬───────┐
+│  All  │ Active│ Done  │
+└───────┴───────┴───────┘
+
+Rules:
+├── Equal width segments
+├── Text or icons (not both mixed)
+├── Max 5 segments
+└── Consider tabs if more complex
+```
+
+---
+
+## 7. iOS Specific Patterns
+
+### Pull to Refresh
+
+```
+Native UIRefreshControl behavior:
+├── Pull beyond threshold → Spinner appears
+├── Release → Refresh action triggered
+├── Loading state → Spinner spins
+├── Complete → Spinner disappears
+
+RULE: Always use native UIRefreshControl (don't custom build).
+```
+
+### Swipe Actions
+
+```
+iOS swipe actions:
+
+← Swipe Left (Destructive)      Swipe Right (Constructive) →
+┌─────────────────────────────────────────────────────────────┐
+│                    List Item Content                        │
+└─────────────────────────────────────────────────────────────┘
+
+Left swipe reveals: Archive, Delete, Flag
+Right swipe reveals: Pin, Star, Mark as Read
+
+Full swipe: Triggers first action
+```
+
+### Context Menus
+
+```
+Long press → Context menu appears
+
+┌─────────────────────────────┐
+│       Preview Card          │
+├─────────────────────────────┤
+│  📋 Copy                    │
+│  📤 Share                   │
+│  ➕ Add to...               │
+├─────────────────────────────┤
+│  🗑️ Delete          (Red)   │
+└─────────────────────────────┘
+
+Rules:
+├── Preview: Show enlarged content
+├── Actions: Related to content
+├── Destructive: Last, in red
+└── Max ~8 actions (scrollable if more)
+```
+
+### Sheets & Half-Sheets
+
+```
+iOS 15+ Sheets:
+
+┌─────────────────────────────────────┐
+│                                     │
+│        Parent View (dimmed)          │
+│                                     │
+├─────────────────────────────────────┤
+│  ═══  (Grabber)                     │ ← Drag to resize
+│                                     │
+│        Sheet Content                │
+│                                     │
+│                                     │
+└─────────────────────────────────────┘
+
+Detents:
+├── .medium → Half screen
+├── .large → Full screen (with safe area)
+├── Custom → Specific height
+```
+
+---
+
+## 8. SF Symbols
+
+### Usage Guidelines
+
+```
+SF Symbols: Apple's icon library (5000+ icons)
+
+Weights: Match text weight
+├── Ultralight / Thin / Light
+├── Regular / Medium / Semibold
+├── Bold / Heavy / Black
+
+Scales:
+├── .small → Inline with small text
+├── .medium → Standard UI
+├── .large → Emphasis, standalone
+```
+
+### Symbol Configurations
+
+```swift
+// SwiftUI
+Image(systemName: "star.fill")
+    .font(.title2)
+    .foregroundStyle(.yellow)
+
+// With rendering mode
+Image(systemName: "heart.fill")
+    .symbolRenderingMode(.multicolor)
+
+// Animated (iOS 17+)
+Image(systemName: "checkmark.circle")
+    .symbolEffect(.bounce)
+```
+
+### Symbol Best Practices
+
+| Guideline | Implementation |
+|-----------|----------------|
+| Match text weight | Symbol weight = font weight |
+| Use standard symbols | Users recognize them |
+| Multicolor when meaningful | Not just decoration |
+| Fallback for older iOS | Check availability |
+
+---
+
+## 9. iOS Accessibility
+
+### VoiceOver Requirements
+
+```
+Every interactive element needs:
+├── Accessibility label (what it is)
+├── Accessibility hint (what it does) - optional
+├── Accessibility traits (button, link, etc.)
+└── Accessibility value (current state)
+
+SwiftUI:
+.accessibilityLabel("Play")
+.accessibilityHint("Plays the selected track")
+
+React Native:
+accessibilityLabel="Play"
+accessibilityHint="Plays the selected track"
+accessibilityRole="button"
+```
+
+### Dynamic Type Scaling
+
+```
+MANDATORY: Support Dynamic Type
+
+Users can set text size from:
+├── xSmall → 14pt body
+├── Small → 15pt body
+├── Medium → 16pt body
+├── Large (Default) → 17pt body
+├── xLarge → 19pt body
+├── xxLarge → 21pt body
+├── xxxLarge → 23pt body
+├── Accessibility sizes → up to 53pt
+
+Your app MUST scale gracefully at all sizes.
+```
+
+### Reduce Motion
+
+```
+Respect motion preferences:
+
+@Environment(\.accessibilityReduceMotion) var reduceMotion
+
+if reduceMotion {
+    // Use instant transitions
+} else {
+    // Use animations
+}
+
+React Native:
+import { AccessibilityInfo } from 'react-native';
+AccessibilityInfo.isReduceMotionEnabled()
+```
+
+---
+
+## 10. iOS Checklist
+
+### Before Every iOS Screen
+
+- [ ] Using SF Pro or SF Symbols
+- [ ] Dynamic Type supported
+- [ ] Safe areas respected
+- [ ] Navigation follows HIG (back gesture works)
+- [ ] Tab bar items ≤ 5
+- [ ] Touch targets ≥ 44pt
+
+### Before iOS Release
+
+- [ ] Dark mode tested
+- [ ] All text sizes tested (Accessibility Inspector)
+- [ ] VoiceOver tested
+- [ ] Edge swipe back works everywhere
+- [ ] Keyboard avoidance implemented
+- [ ] Notch/Dynamic Island handled
+- [ ] Home indicator area respected
+- [ ] Native components used where possible
+
+---
+
+> **Remember:** iOS users have strong expectations from other iOS apps. Deviating from HIG patterns feels "broken" to them. When in doubt, use the native component.
diff --git a/.agents/skills/mobile-design/scripts/mobile_audit.py b/.agents/skills/mobile-design/scripts/mobile_audit.py
new file mode 100644
index 0000000..f134523
--- /dev/null
+++ b/.agents/skills/mobile-design/scripts/mobile_audit.py
@@ -0,0 +1,670 @@
+#!/usr/bin/env python3
+"""
+Mobile UX Audit Script - Full Mobile Design Coverage
+
+Analyzes React Native / Flutter code for compliance with:
+
+1. TOUCH PSYCHOLOGY (touch-psychology.md):
+   - Touch Target Sizes (44pt iOS, 48dp Android, 44px WCAG)
+   - Touch Target Spacing (8px minimum gap)
+   - Thumb Zone Placement (primary CTAs at bottom)
+   - Gesture Alternatives (visible buttons for swipe)
+   - Haptic Feedback Patterns
+   - Touch Feedback Timing (<50ms)
+   - Touch Accessibility (motor impairment support)
+
+2. MOBILE PERFORMANCE (mobile-performance.md):
+   - ScrollView vs FlatList (CRITICAL)
+   - React.memo for List Items
+   - useCallback for renderItem
+   - Stable keyExtractor (NOT index)
+   - useNativeDriver for Animations
+   - Memory Leak Prevention (cleanup)
+   - Console.log Detection
+   - Inline Function Detection
+   - Animation Performance (transform/opacity only)
+
+3. MOBILE NAVIGATION (mobile-navigation.md):
+   - Tab Bar Max Items (5)
+   - Tab State Preservation
+   - Proper Back Handling
+   - Deep Link Support
+   - Navigation Structure
+
+4. MOBILE TYPOGRAPHY (mobile-typography.md):
+   - System Font Usage
+   - Dynamic Type Support (iOS)
+   - Text Scaling Constraints
+   - Mobile Line Height
+   - Font Size Limits
+
+5. MOBILE COLOR SYSTEM (mobile-color-system.md):
+   - Pure Black Avoidance (#000000)
+   - OLED Optimization
+   - Dark Mode Support
+   - Contrast Ratios
+
+6. PLATFORM iOS (platform-ios.md):
+   - SF Symbols Usage
+   - iOS Navigation Patterns
+   - iOS Haptic Types
+   - iOS-Specific Components
+
+7. PLATFORM ANDROID (platform-android.md):
+   - Material Icons Usage
+   - Android Navigation Patterns
+   - Ripple Effects
+   - Android-Specific Components
+
+8. MOBILE BACKEND (mobile-backend.md):
+   - Secure Storage (NOT AsyncStorage)
+   - Offline Handling
+   - Push Notification Support
+   - API Response Caching
+
+Total: 50+ mobile-specific checks
+"""
+
+import sys
+import os
+import re
+import json
+from pathlib import Path
+
+class MobileAuditor:
+    def __init__(self):
+        self.issues = []
+        self.warnings = []
+        self.passed_count = 0
+        self.files_checked = 0
+
+    def audit_file(self, filepath: str) -> None:
+        try:
+            with open(filepath, 'r', encoding='utf-8', errors='replace') as f:
+                content = f.read()
+        except:
+            return
+
+        self.files_checked += 1
+        filename = os.path.basename(filepath)
+
+        # Detect framework
+        is_react_native = bool(re.search(r'react-native|@react-navigation|React\.Native', content))
+        is_flutter = bool(re.search(r'import \'package:flutter|MaterialApp|Widget\.build', content))
+
+        if not (is_react_native or is_flutter):
+            return  # Skip non-mobile files
+
+        # --- 1. TOUCH PSYCHOLOGY CHECKS ---
+
+        # 1.1 Touch Target Size Check
+        # Look for small touch targets
+        small_sizes = re.findall(r'(?:width|height|size):\s*([0-3]\d)', content)
+        for size in small_sizes:
+            if int(size) < 44:
+                self.issues.append(f"[Touch Target] {filename}: Touch target size {size}px < 44px minimum (iOS: 44pt, Android: 48dp)")
+
+        # 1.2 Touch Target Spacing Check
+        # Look for inadequate spacing between touchable elements
+        small_gaps = re.findall(r'(?:margin|gap):\s*([0-7])\s*(?:px|dp)', content)
+        for gap in small_gaps:
+            if int(gap) < 8:
+                self.warnings.append(f"[Touch Spacing] {filename}: Touch target spacing {gap}px < 8px minimum. Accidental taps risk.")
+
+        # 1.3 Thumb Zone Placement Check
+        # Primary CTAs should be at bottom (easy thumb reach)
+        primary_buttons = re.findall(r'(?:testID|id):\s*["\'](?:.*(?:primary|cta|submit|confirm)[^"\']*)["\']', content, re.IGNORECASE)
+        has_bottom_placement = bool(re.search(r'position:\s*["\']?absolute["\']?|bottom:\s*\d+|style.*bottom|justifyContent:\s*["\']?flex-end', content))
+        if primary_buttons and not has_bottom_placement:
+            self.warnings.append(f"[Thumb Zone] {filename}: Primary CTA may not be in thumb zone (bottom). Place primary actions at bottom for easy reach.")
+
+        # 1.4 Gesture Alternatives Check
+        # Swipe actions should have visible button alternatives
+        has_swipe_gestures = bool(re.search(r'Swipeable|onSwipe|PanGestureHandler|swipe', content))
+        has_visible_buttons = bool(re.search(r'Button.*(?:delete|archive|more)|TouchableOpacity|Pressable', content))
+        if has_swipe_gestures and not has_visible_buttons:
+            self.warnings.append(f"[Gestures] {filename}: Swipe gestures detected without visible button alternatives. Motor impaired users need alternatives.")
+
+        # 1.5 Haptic Feedback Check
+        # Important actions should have haptic feedback
+        has_important_actions = bool(re.search(r'(?:onPress|onSubmit|delete|remove|confirm|purchase)', content))
+        has_haptics = bool(re.search(r'Haptics|Vibration|react-native-haptic-feedback|FeedbackManager', content))
+        if has_important_actions and not has_haptics:
+            self.warnings.append(f"[Haptics] {filename}: Important actions without haptic feedback. Consider adding haptic confirmation.")
+
+        # 1.6 Touch Feedback Timing Check
+        # Touch feedback should be immediate (<50ms)
+        if is_react_native:
+            has_pressable = bool(re.search(r'Pressable|TouchableOpacity', content))
+            has_feedback_state = bool(re.search(r'pressed|style.*opacity|underlay', content))
+            if has_pressable and not has_feedback_state:
+                self.warnings.append(f"[Touch Feedback] {filename}: Pressable without visual feedback state. Add opacity/scale change for tap confirmation.")
+
+        # --- 2. MOBILE PERFORMANCE CHECKS ---
+
+        # 2.1 CRITICAL: ScrollView vs FlatList
+        has_scrollview = bool(re.search(r'<ScrollView|ScrollView\.', content))
+        has_map_in_scrollview = bool(re.search(r'ScrollView.*\.map\(|ScrollView.*\{.*\.map', content))
+        if has_scrollview and has_map_in_scrollview:
+            self.issues.append(f"[Performance CRITICAL] {filename}: ScrollView with .map() detected. Use FlatList for lists to prevent memory explosion.")
+
+        # 2.2 React.memo Check
+        if is_react_native:
+            has_list = bool(re.search(r'FlatList|FlashList|SectionList', content))
+            has_react_memo = bool(re.search(r'React\.memo|memo\(', content))
+            if has_list and not has_react_memo:
+                self.warnings.append(f"[Performance] {filename}: FlatList without React.memo on list items. Items will re-render on every parent update.")
+
+        # 2.3 useCallback Check
+        if is_react_native:
+            has_flatlist = bool(re.search(r'FlatList|FlashList', content))
+            has_use_callback = bool(re.search(r'useCallback', content))
+            if has_flatlist and not has_use_callback:
+                self.warnings.append(f"[Performance] {filename}: FlatList renderItem without useCallback. New function created every render.")
+
+        # 2.4 keyExtractor Check (CRITICAL)
+        if is_react_native:
+            has_flatlist = bool(re.search(r'FlatList', content))
+            has_key_extractor = bool(re.search(r'keyExtractor', content))
+            uses_index_key = bool(re.search(r'key=\{.*index.*\}|key:\s*index', content))
+            if has_flatlist and not has_key_extractor:
+                self.issues.append(f"[Performance CRITICAL] {filename}: FlatList without keyExtractor. Index-based keys cause bugs on reorder/delete.")
+            if uses_index_key:
+                self.issues.append(f"[Performance CRITICAL] {filename}: Using index as key. This causes bugs when list changes. Use unique ID from data.")
+
+        # 2.5 useNativeDriver Check
+        if is_react_native:
+            has_animated = bool(re.search(r'Animated\.', content))
+            has_native_driver = bool(re.search(r'useNativeDriver:\s*true', content))
+            has_native_driver_false = bool(re.search(r'useNativeDriver:\s*false', content))
+            if has_animated and has_native_driver_false:
+                self.warnings.append(f"[Performance] {filename}: Animation with useNativeDriver: false. Use true for 60fps (only supports transform/opacity).")
+            if has_animated and not has_native_driver:
+                self.warnings.append(f"[Performance] {filename}: Animated component without useNativeDriver. Add useNativeDriver: true for 60fps.")
+
+        # 2.6 Memory Leak Check
+        if is_react_native:
+            has_effect = bool(re.search(r'useEffect', content))
+            has_cleanup = bool(re.search(r'return\s*\(\)\s*=>|return\s+function', content))
+            has_subscriptions = bool(re.search(r'addEventListener|subscribe|\.focus\(\)|\.off\(', content))
+            if has_effect and has_subscriptions and not has_cleanup:
+                self.issues.append(f"[Memory Leak] {filename}: useEffect with subscriptions but no cleanup function. Memory leak on unmount.")
+
+        # 2.7 Console.log Detection
+        console_logs = len(re.findall(r'console\.log|console\.warn|console\.error|console\.debug', content))
+        if console_logs > 5:
+            self.warnings.append(f"[Performance] {filename}: {console_logs} console.log statements detected. Remove before production (blocks JS thread).")
+
+        # 2.8 Inline Function Detection
+        if is_react_native:
+            inline_functions = re.findall(r'(?:onPress|onPressIn|onPressOut|renderItem):\s*\([^)]*\)\s*=>', content)
+            if len(inline_functions) > 3:
+                self.warnings.append(f"[Performance] {filename}: {len(inline_functions)} inline arrow functions in props. Creates new function every render. Use useCallback.")
+
+        # 2.9 Animation Properties Check
+        # Warn if animating expensive properties
+        animating_layout = bool(re.search(r'Animated\.timing.*(?:width|height|margin|padding)', content))
+        if animating_layout:
+            self.issues.append(f"[Performance] {filename}: Animating layout properties (width/height/margin). Use transform/opacity for 60fps.")
+
+        # --- 3. MOBILE NAVIGATION CHECKS ---
+
+        # 3.1 Tab Bar Max Items Check
+        tab_bar_items = len(re.findall(r'Tab\.Screen|createBottomTabNavigator|BottomTab', content))
+        if tab_bar_items > 5:
+            self.warnings.append(f"[Navigation] {filename}: {tab_bar_items} tab bar items (max 5 recommended). More than 5 becomes hard to tap.")
+
+        # 3.2 Tab State Preservation Check
+        has_tab_nav = bool(re.search(r'createBottomTabNavigator|Tab\.Navigator', content))
+        if has_tab_nav:
+            # Look for lazy prop (false preserves state)
+            has_lazy_false = bool(re.search(r'lazy:\s*false', content))
+            if not has_lazy_false:
+                self.warnings.append(f"[Navigation] {filename}: Tab navigation without lazy: false. Tabs may lose state on switch.")
+
+        # 3.3 Back Handling Check
+        has_back_listener = bool(re.search(r'BackHandler|useFocusEffect|navigation\.addListener', content))
+        has_custom_back = bool(re.search(r'onBackPress|handleBackPress', content))
+        if has_custom_back and not has_back_listener:
+            self.warnings.append(f"[Navigation] {filename}: Custom back handling without BackHandler listener. May not work correctly.")
+
+        # 3.4 Deep Link Support Check
+        has_linking = bool(re.search(r'Linking\.|Linking\.openURL|deepLink|universalLink', content))
+        has_config = bool(re.search(r'apollo-link|react-native-screens|navigation\.link', content))
+        if not has_linking and not has_config:
+            self.passed_count += 1
+        else:
+            if has_linking and not has_config:
+                self.warnings.append(f"[Navigation] {filename}: Deep linking detected but may lack proper configuration. Test notification/share flows.")
+
+        # --- 4. MOBILE TYPOGRAPHY CHECKS ---
+
+        # 4.1 System Font Check
+        if is_react_native:
+            has_custom_font = bool(re.search(r"fontFamily:\s*[\"'][^\"']+", content))
+            has_system_font = bool(re.search(r"fontFamily:\s*[\"']?(?:System|San Francisco|Roboto|-apple-system)", content))
+            if has_custom_font and not has_system_font:
+                self.warnings.append(f"[Typography] {filename}: Custom font detected. Consider system fonts (iOS: SF Pro, Android: Roboto) for native feel.")
+
+        # 4.2 Text Scaling Check (iOS Dynamic Type)
+        if is_react_native:
+            has_font_sizes = bool(re.search(r'fontSize:', content))
+            has_scaling = bool(re.search(r'allowFontScaling:\s*true|responsiveFontSize|useWindowDimensions', content))
+            if has_font_sizes and not has_scaling:
+                self.warnings.append(f"[Typography] {filename}: Fixed font sizes without scaling support. Consider allowFontScaling for accessibility.")
+
+        # 4.3 Mobile Line Height Check
+        line_heights = re.findall(r'lineHeight:\s*([\d.]+)', content)
+        for lh in line_heights:
+            if float(lh) > 1.8:
+                self.warnings.append(f"[Typography] {filename}: lineHeight {lh} too high for mobile. Mobile text needs tighter spacing (1.3-1.5).")
+
+        # 4.4 Font Size Limits
+        font_sizes = re.findall(r'fontSize:\s*([\d.]+)', content)
+        for fs in font_sizes:
+            size = float(fs)
+            if size < 12:
+                self.warnings.append(f"[Typography] {filename}: fontSize {size}px below 12px minimum readability.")
+            elif size > 32:
+                self.warnings.append(f"[Typography] {filename}: fontSize {size}px very large. Consider using responsive scaling.")
+
+        # --- 5. MOBILE COLOR SYSTEM CHECKS ---
+
+        # 5.1 Pure Black Avoidance
+        if re.search(r'#000000|color:\s*black|backgroundColor:\s*["\']?black', content):
+            self.warnings.append(f"[Color] {filename}: Pure black (#000000) detected. Use dark gray (#1C1C1E iOS, #121212 Android) for better OLED/battery.")
+
+        # 5.2 Dark Mode Support
+        has_color_schemes = bool(re.search(r'useColorScheme|colorScheme|appearance:\s*["\']?dark', content))
+        has_dark_mode_style = bool(re.search(r'\\\?.*dark|style:\s*.*dark|isDark', content))
+        if not has_color_schemes and not has_dark_mode_style:
+            self.warnings.append(f"[Color] {filename}: No dark mode support detected. Consider useColorScheme for system dark mode.")
+
+        # --- 6. PLATFORM iOS CHECKS ---
+
+        if is_react_native:
+            # 6.1 SF Symbols Check
+            has_ios_icons = bool(re.search(r'@expo/vector-icons|ionicons', content))
+            has_sf_symbols = bool(re.search(r'sf-symbol|SF Symbols', content))
+            if has_ios_icons and not has_sf_symbols:
+                self.passed_count += 1
+
+            # 6.2 iOS Haptic Types
+            has_haptic_import = bool(re.search(r'expo-haptics|react-native-haptic-feedback', content))
+            has_haptic_types = bool(re.search(r'ImpactFeedback|NotificationFeedback|SelectionFeedback', content))
+            if has_haptic_import and not has_haptic_types:
+                self.warnings.append(f"[iOS Haptics] {filename}: Haptic library imported but not using typed haptics (Impact/Notification/Selection).")
+
+            # 6.3 iOS Safe Area
+            has_safe_area = bool(re.search(r'SafeAreaView|useSafeAreaInsets|safeArea', content))
+            if not has_safe_area:
+                self.warnings.append(f"[iOS] {filename}: No SafeArea detected. Content may be hidden by notch/home indicator.")
+
+        # --- 7. PLATFORM ANDROID CHECKS ---
+
+        if is_react_native:
+            # 7.1 Material Icons Check
+            has_material_icons = bool(re.search(r'@expo/vector-icons|MaterialIcons', content))
+            if has_material_icons:
+                self.passed_count += 1
+
+            # 7.2 Ripple Effect
+            has_ripple = bool(re.search(r'ripple|android_ripple|foregroundRipple', content))
+            has_pressable = bool(re.search(r'Pressable|Touchable', content))
+            if has_pressable and not has_ripple:
+                self.warnings.append(f"[Android] {filename}: Touchable without ripple effect. Android users expect ripple feedback.")
+
+            # 7.3 Hardware Back Button
+            if is_react_native:
+                has_back_button = bool(re.search(r'BackHandler|useBackHandler', content))
+                has_navigation = bool(re.search(r'@react-navigation', content))
+                if has_navigation and not has_back_button:
+                    self.warnings.append(f"[Android] {filename}: React Navigation detected without BackHandler listener. Android hardware back may not work correctly.")
+
+        # --- 8. MOBILE BACKEND CHECKS ---
+
+        # 8.1 Secure Storage Check
+        has_async_storage = bool(re.search(r'AsyncStorage|@react-native-async-storage', content))
+        has_secure_storage = bool(re.search(r'SecureStore|Keychain|EncryptedSharedPreferences', content))
+        has_token_storage = bool(re.search(r'token|jwt|auth.*storage', content, re.IGNORECASE))
+        if has_token_storage and has_async_storage and not has_secure_storage:
+            self.issues.append(f"[Security] {filename}: Storing auth tokens in AsyncStorage (insecure). Use SecureStore (iOS) / EncryptedSharedPreferences (Android).")
+
+        # 8.2 Offline Handling Check
+        has_network = bool(re.search(r'fetch|axios|netinfo|@react-native-community/netinfo', content))
+        has_offline = bool(re.search(r'offline|isConnected|netInfo|cache.*offline', content))
+        if has_network and not has_offline:
+            self.warnings.append(f"[Offline] {filename}: Network requests detected without offline handling. Consider NetInfo for connection status.")
+
+        # 8.3 Push Notification Support
+        has_push = bool(re.search(r'Notifications|pushNotification|Firebase\.messaging|PushNotificationIOS', content))
+        has_push_handler = bool(re.search(r'onNotification|addNotificationListener|notification\.open', content))
+        if has_push and not has_push_handler:
+            self.warnings.append(f"[Push] {filename}: Push notifications imported but no handler found. May miss notifications.")
+
+        # --- 9. EXTENDED MOBILE TYPOGRAPHY CHECKS ---
+
+        # 9.1 iOS Type Scale Check
+        if is_react_native:
+            # Check for iOS text styles that match HIG
+            has_large_title = bool(re.search(r'fontSize:\s*34|largeTitle|font-weight:\s*["\']?bold', content))
+            has_title_1 = bool(re.search(r'fontSize:\s*28', content))
+            has_headline = bool(re.search(r'fontSize:\s*17.*semibold|headline', content))
+            has_body = bool(re.search(r'fontSize:\s*17.*regular|body', content))
+
+            # Check if following iOS scale roughly
+            font_sizes = re.findall(r'fontSize:\s*([\d.]+)', content)
+            ios_scale_sizes = [34, 28, 22, 20, 17, 16, 15, 13, 12, 11]
+            matching_ios = sum(1 for size in font_sizes if any(abs(float(size) - ios_size) < 1 for ios_size in ios_scale_sizes))
+
+            if len(font_sizes) > 3 and matching_ios < len(font_sizes) / 2:
+                self.warnings.append(f"[iOS Typography] {filename}: Font sizes don't match iOS type scale. Consider iOS text styles for native feel.")
+
+        # 9.2 Android Material Type Scale Check
+        if is_react_native:
+            # Check for Material 3 text styles
+            has_display = bool(re.search(r'fontSize:\s*[456][0-9]|display', content))
+            has_headline_material = bool(re.search(r'fontSize:\s*[23][0-9]|headline', content))
+            has_title_material = bool(re.search(r'fontSize:\s*2[12][0-9].*medium|title', content))
+            has_body_material = bool(re.search(r'fontSize:\s*1[456].*regular|body', content))
+            has_label = bool(re.search(r'fontSize:\s*1[1234].*medium|label', content))
+
+            # Check if using sp (scale-independent pixels)
+            uses_sp = bool(re.search(r'\d+\s*sp\b', content))
+            if has_display or has_headline_material:
+                if not uses_sp:
+                    self.warnings.append(f"[Android Typography] {filename}: Material typography detected without sp units. Use sp for text to respect user font size preferences.")
+
+        # 9.3 Modular Scale Check
+        # Check if font sizes follow modular scale
+        font_sizes = re.findall(r'fontSize:\s*(\d+(?:\.\d+)?)', content)
+        if len(font_sizes) > 3:
+            sorted_sizes = sorted(set([float(s) for s in font_sizes]))
+            ratios = []
+            for i in range(1, len(sorted_sizes)):
+                if sorted_sizes[i-1] > 0:
+                    ratios.append(sorted_sizes[i] / sorted_sizes[i-1])
+
+            # Common ratios: 1.125, 1.2, 1.25, 1.333, 1.5
+            common_ratios = {1.125, 1.2, 1.25, 1.333, 1.5}
+            for ratio in ratios[:3]:
+                if not any(abs(ratio - cr) < 0.03 for cr in common_ratios):
+                    self.warnings.append(f"[Typography] {filename}: Font sizes may not follow modular scale (ratio: {ratio:.2f}). Consider consistent ratio.")
+                    break
+
+        # 9.4 Line Length Check (Mobile-specific)
+        # Mobile text should be 40-60 characters max
+        if is_react_native:
+            has_long_text = bool(re.search(r'<Text[^>]*>[^<]{40,}', content))
+            has_max_width = bool(re.search(r'maxWidth|max-w-\d+|width:\s*["\']?\d+', content))
+            if has_long_text and not has_max_width:
+                self.warnings.append(f"[Mobile Typography] {filename}: Text without max-width constraint. Mobile text should be 40-60 characters per line for readability.")
+
+        # 9.5 Font Weight Pattern Check
+        # Check for font weight distribution
+        if is_react_native:
+            font_weights = re.findall(r'fontWeight:\s*["\']?(\d+|normal|bold|medium|light)', content)
+            weight_map = {'normal': '400', 'light': '300', 'medium': '500', 'bold': '700'}
+            numeric_weights = []
+            for w in font_weights:
+                val = weight_map.get(w.lower(), w)
+                try:
+                    numeric_weights.append(int(val))
+                except:
+                    pass
+
+            # Check if overusing bold (mobile should be regular-dominant)
+            bold_count = sum(1 for w in numeric_weights if w >= 700)
+            regular_count = sum(1 for w in numeric_weights if 400 <= w < 500)
+            if bold_count > regular_count:
+                self.warnings.append(f"[Mobile Typography] {filename}: More bold weights than regular. Mobile typography should be regular-dominant for readability.")
+
+        # --- 10. EXTENDED MOBILE COLOR SYSTEM CHECKS ---
+
+        # 10.1 OLED Optimization Check
+        # Check for near-black colors instead of pure black
+        if re.search(r'#121212|#1A1A1A|#0D0D0D', content):
+            self.passed_count += 1  # Good OLED optimization
+        elif re.search(r'backgroundColor:\s*["\']?#000000', content):
+            # Using pure black for background is OK for OLED
+            pass
+        elif re.search(r'backgroundColor:\s*["\']?#[0-9A-Fa-f]{6}', content):
+            # Check if using light colors in dark mode (bad for OLED)
+            self.warnings.append(f"[Mobile Color] {filename}: Consider OLED-optimized dark backgrounds (#121212 Android, #000000 iOS) for battery savings.")
+
+        # 10.2 Saturated Color Detection (Battery)
+        # Highly saturated colors consume more power on OLED
+        hex_colors = re.findall(r'#([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})', content)
+        saturated_count = 0
+        for r, g, b in hex_colors:
+            # Convert to RGB 0-255
+            try:
+                r_val, g_val, b_val = int(r, 16), int(g, 16), int(b, 16)
+                max_val = max(r_val, g_val, b_val)
+                min_val = min(r_val, g_val, b_val)
+                # Saturation = (max - min) / max
+                if max_val > 0:
+                    saturation = (max_val - min_val) / max_val
+                    if saturation > 0.8:  # Highly saturated
+                        saturated_count += 1
+            except:
+                pass
+
+        if saturated_count > 10:
+            self.warnings.append(f"[Mobile Color] {filename}: {saturated_count} highly saturated colors detected. Desaturated colors save battery on OLED screens.")
+
+        # 10.3 Outdoor Visibility Check
+        # Low contrast combinations fail in outdoor sunlight
+        light_colors = re.findall(r'#[0-9A-Fa-f]{6}|rgba?\([^)]+\)', content)
+        # Check for potential low contrast (light gray on white, dark gray on black)
+        potential_low_contrast = bool(re.search(r'#[EeEeEeEe].*#ffffff|#999999.*#ffffff|#333333.*#000000|#666666.*#000000', content))
+        if potential_low_contrast:
+            self.warnings.append(f"[Mobile Color] {filename}: Possible low contrast combination detected. Critical for outdoor visibility. Ensure WCAG AAA (7:1) for mobile.")
+
+        # 10.4 Dark Mode Text Color Check
+        # In dark mode, text should not be pure white
+        has_dark_mode = bool(re.search(r'dark:\s*|isDark|useColorScheme|colorScheme:\s*["\']?dark', content))
+        if has_dark_mode:
+            has_pure_white_text = bool(re.search(r'color:\s*["\']?#ffffff|#fff["\']?\}|textColor:\s*["\']?white', content))
+            if has_pure_white_text:
+                self.warnings.append(f"[Mobile Color] {filename}: Pure white text (#FFFFFF) in dark mode. Use #E8E8E8 or light gray for better readability.")
+
+        # --- 11. EXTENDED PLATFORM IOS CHECKS ---
+
+        if is_react_native:
+            # 11.1 SF Pro Font Detection
+            has_sf_pro = bool(re.search(r'SF Pro|SFPro|fontFamily:\s*["\']?[-\s]*SF', content))
+            has_custom_font = bool(re.search(r'fontFamily:\s*["\'][^"\']+', content))
+            if has_custom_font and not has_sf_pro:
+                self.warnings.append(f"[iOS] {filename}: Custom font without SF Pro fallback. Consider SF Pro Text for body, SF Pro Display for headings.")
+
+            # 11.2 iOS System Colors Check
+            # Check for semantic color usage
+            has_label = bool(re.search(r'color:\s*["\']?label|\.label', content))
+            has_secondaryLabel = bool(re.search(r'secondaryLabel|\.secondaryLabel', content))
+            has_systemBackground = bool(re.search(r'systemBackground|\.systemBackground', content))
+
+            has_hardcoded_gray = bool(re.search(r'#[78]0{4}', content))
+            if has_hardcoded_gray and not (has_label or has_secondaryLabel):
+                self.warnings.append(f"[iOS] {filename}: Hardcoded gray colors detected. Consider iOS semantic colors (label, secondaryLabel) for automatic dark mode.")
+
+            # 11.3 iOS Accent Colors Check
+            ios_blue = bool(re.search(r'#007AFF|#0A84FF|systemBlue', content))
+            ios_green = bool(re.search(r'#34C759|#30D158|systemGreen', content))
+            ios_red = bool(re.search(r'#FF3B30|#FF453A|systemRed', content))
+
+            has_custom_primary = bool(re.search(r'primaryColor|theme.*primary|colors\.primary', content))
+            if has_custom_primary and not (ios_blue or ios_green or ios_red):
+                self.warnings.append(f"[iOS] {filename}: Custom primary color without iOS system color fallback. Consider systemBlue for consistent iOS feel.")
+
+            # 11.4 iOS Navigation Patterns Check
+            has_navigation_bar = bool(re.search(r'navigationOptions|headerStyle|cardStyle', content))
+            has_header_title = bool(re.search(r'title:\s*["\']|headerTitle|navigation\.setOptions', content))
+            if has_navigation_bar and not has_header_title:
+                self.warnings.append(f"[iOS] {filename}: Navigation bar detected without title. iOS apps should have clear context in nav bar.")
+
+            # 11.5 iOS Component Patterns Check
+            # Check for iOS-specific components
+            has_alert = bool(re.search(r'Alert\.alert|showAlert', content))
+            has_action_sheet = bool(re.search(r'ActionSheet|ActionSheetIOS|showActionSheetWithOptions', content))
+            has_activity_indicator = bool(re.search(r'ActivityIndicator|ActivityIndic', content))
+
+            if has_alert or has_action_sheet or has_activity_indicator:
+                self.passed_count += 1  # Good iOS component usage
+
+        # --- 12. EXTENDED PLATFORM ANDROID CHECKS ---
+
+        if is_react_native:
+            # 12.1 Roboto Font Detection
+            has_roboto = bool(re.search(r'Roboto|fontFamily:\s*["\']?[-\s]*Roboto', content))
+            has_custom_font = bool(re.search(r'fontFamily:\s*["\'][^"\']+', content))
+            if has_custom_font and not has_roboto:
+                self.warnings.append(f"[Android] {filename}: Custom font without Roboto fallback. Roboto is optimized for Android displays.")
+
+            # 12.2 Material 3 Dynamic Color Check
+            has_material_colors = bool(re.search(r'MD3|MaterialYou|dynamicColor|useColorScheme', content))
+            has_theme_provider = bool(re.search(r'MaterialTheme|ThemeProvider|PaperProvider|ThemeProvider', content))
+            if not has_material_colors and not has_theme_provider:
+                self.warnings.append(f"[Android] {filename}: No Material 3 dynamic color detected. Consider Material 3 theming for personalized feel.")
+
+            # 12.3 Material Elevation Check
+            # Check for elevation values (Material 3 uses elevation for depth)
+            has_elevation = bool(re.search(r'elevation:\s*\d+|shadowOpacity|shadowRadius|android:elevation', content))
+            has_box_shadow = bool(re.search(r'boxShadow:', content))
+            if has_box_shadow and not has_elevation:
+                self.warnings.append(f"[Android] {filename}: CSS box-shadow detected without elevation. Consider Material elevation system for consistent depth.")
+
+            # 12.4 Material Component Patterns Check
+            # Check for Material components
+            has_ripple = bool(re.search(r'ripple|android_ripple|foregroundRipple', content))
+            has_card = bool(re.search(r'Card|Paper|elevation.*\d+', content))
+            has_fab = bool(re.search(r'FAB|FloatingActionButton|fab', content))
+            has_snackbar = bool(re.search(r'Snackbar|showSnackBar|Toast', content))
+
+            material_component_count = sum([has_ripple, has_card, has_fab, has_snackbar])
+            if material_component_count >= 2:
+                self.passed_count += 1  # Good Material design usage
+
+            # 12.5 Android Navigation Patterns Check
+            has_top_app_bar = bool(re.search(r'TopAppBar|AppBar|CollapsingToolbar', content))
+            has_bottom_nav = bool(re.search(r'BottomNavigation|BottomNav', content))
+            has_navigation_rail = bool(re.search(r'NavigationRail', content))
+
+            if has_bottom_nav:
+                self.passed_count += 1  # Good Android pattern
+            elif has_top_app_bar and not (has_bottom_nav or has_navigation_rail):
+                self.warnings.append(f"[Android] {filename}: TopAppBar without bottom navigation. Consider BottomNavigation for thumb-friendly access.")
+
+        # --- 13. MOBILE TESTING CHECKS ---
+
+        # 13.1 Testing Tool Detection
+        has_rntl = bool(re.search(r'react-native-testing-library|@testing-library', content))
+        has_detox = bool(re.search(r'detox|element\(|by\.text|by\.id', content))
+        has_maestro = bool(re.search(r'maestro|\.yaml$', content))
+        has_jest = bool(re.search(r'jest|describe\(|test\(|it\(', content))
+
+        testing_tools = []
+        if has_jest: testing_tools.append('Jest')
+        if has_rntl: testing_tools.append('RNTL')
+        if has_detox: testing_tools.append('Detox')
+        if has_maestro: testing_tools.append('Maestro')
+
+        if len(testing_tools) == 0:
+            self.warnings.append(f"[Testing] {filename}: No testing framework detected. Consider Jest (unit) + Detox/Maestro (E2E) for mobile.")
+
+        # 13.2 Test Pyramid Balance Check
+        test_files = len(re.findall(r'\.test\.(tsx|ts|js|jsx)|\.spec\.', content))
+        e2e_tests = len(re.findall(r'detox|maestro|e2e|spec\.e2e', content.lower()))
+
+        if test_files > 0 and e2e_tests == 0:
+            self.warnings.append(f"[Testing] {filename}: Unit tests found but no E2E tests. Mobile needs E2E on real devices for complete coverage.")
+
+        # 13.3 Accessibility Label Check (Mobile-specific)
+        if is_react_native:
+            has_pressable = bool(re.search(r'Pressable|TouchableOpacity|TouchableHighlight', content))
+            has_a11y_label = bool(re.search(r'accessibilityLabel|aria-label|testID', content))
+            if has_pressable and not has_a11y_label:
+                self.warnings.append(f"[A11y Mobile] {filename}: Touchable element without accessibilityLabel. Screen readers need labels for all interactive elements.")
+
+        # --- 14. MOBILE DEBUGGING CHECKS ---
+
+        # 14.1 Performance Profiling Check
+        has_performance = bool(re.search(r'Performance|systrace|profile|Flipper', content))
+        has_console_log = len(re.findall(r'console\.(log|warn|error|debug|info)', content))
+        has_debugger = bool(re.search(r'debugger|__DEV__|React\.DevTools', content))
+
+        if has_console_log > 10:
+            self.warnings.append(f"[Debugging] {filename}: {has_console_log} console.log statements. Remove before production; they block JS thread.")
+
+        if has_performance:
+            self.passed_count += 1  # Good performance monitoring
+
+        # 14.2 Error Boundary Check
+        has_error_boundary = bool(re.search(r'ErrorBoundary|componentDidCatch|getDerivedStateFromError', content))
+        if not has_error_boundary and is_react_native:
+            self.warnings.append(f"[Debugging] {filename}: No ErrorBoundary detected. Consider adding ErrorBoundary to prevent app crashes.")
+
+        # 14.3 Hermes Check (React Native specific)
+        if is_react_native:
+            # Check if using Hermes engine (should be default in modern RN)
+            # This is more of a configuration check, not code pattern
+            self.passed_count += 1  # Hermes is default in RN 0.70+
+
+    def audit_directory(self, directory: str) -> None:
+        extensions = {'.tsx', '.ts', '.jsx', '.js', '.dart'}
+        for root, dirs, files in os.walk(directory):
+            dirs[:] = [d for d in dirs if d not in {'node_modules', '.git', 'dist', 'build', '.next', 'ios', 'android', 'build', '.idea'}]
+            for file in files:
+                if Path(file).suffix in extensions:
+                    self.audit_file(os.path.join(root, file))
+
+    def get_report(self):
+        return {
+            "files_checked": self.files_checked,
+            "issues": self.issues,
+            "warnings": self.warnings,
+            "passed_checks": self.passed_count,
+            "compliant": len(self.issues) == 0
+        }
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python mobile_audit.py <directory>")
+        sys.exit(1)
+
+    path = sys.argv[1]
+    is_json = "--json" in sys.argv
+
+    auditor = MobileAuditor()
+    if os.path.isfile(path):
+        auditor.audit_file(path)
+    else:
+        auditor.audit_directory(path)
+
+    report = auditor.get_report()
+
+    if is_json:
+        print(json.dumps(report, indent=2))
+    else:
+        print(f"\n[MOBILE AUDIT] {report['files_checked']} mobile files checked")
+        print("-" * 50)
+        if report['issues']:
+            print(f"[!] ISSUES ({len(report['issues'])}):")
+            for i in report['issues'][:10]:
+                print(f"  - {i}")
+        if report['warnings']:
+            print(f"[*] WARNINGS ({len(report['warnings'])}):")
+            for w in report['warnings'][:15]:
+                print(f"  - {w}")
+        print(f"[+] PASSED CHECKS: {report['passed_checks']}")
+        status = "PASS" if report['compliant'] else "FAIL"
+        print(f"STATUS: {status}")
+
+    sys.exit(0 if report['compliant'] else 1)
+
+
+if __name__ == "__main__":
+    # Fix missing import
+    import re
+    main()
diff --git a/.agents/skills/mobile-design/touch-psychology.md b/.agents/skills/mobile-design/touch-psychology.md
new file mode 100644
index 0000000..59e7839
--- /dev/null
+++ b/.agents/skills/mobile-design/touch-psychology.md
@@ -0,0 +1,537 @@
+# Touch Psychology Reference
+
+> Deep dive into mobile touch interaction, Fitts' Law for touch, thumb zone anatomy, gesture psychology, and haptic feedback.
+> **This is the mobile equivalent of ux-psychology.md - CRITICAL for all mobile work.**
+
+---
+
+## 1. Fitts' Law for Touch
+
+### The Fundamental Difference
+
+```
+DESKTOP (Mouse/Trackpad):
+├── Cursor size: 1 pixel (precision)
+├── Visual feedback: Hover states
+├── Error cost: Low (easy to retry)
+└── Target acquisition: Fast, precise
+
+MOBILE (Finger):
+├── Contact area: ~7mm diameter (imprecise)
+├── Visual feedback: No hover, only tap
+├── Error cost: High (frustrating retries)
+├── Occlusion: Finger covers the target
+└── Target acquisition: Slower, needs larger targets
+```
+
+### Fitts' Law Formula Adapted
+
+```
+Touch acquisition time = a + b × log₂(1 + D/W)
+
+Where:
+├── D = Distance to target
+├── W = Width of target
+└── For touch: W must be MUCH larger than desktop
+```
+
+### Minimum Touch Target Sizes
+
+| Platform | Minimum | Recommended | Use For |
+|----------|---------|-------------|---------|
+| **iOS (HIG)** | 44pt × 44pt | 48pt+ | All tappable elements |
+| **Android (Material)** | 48dp × 48dp | 56dp+ | All tappable elements |
+| **WCAG 2.2** | 44px × 44px | - | Accessibility compliance |
+| **Critical Actions** | - | 56-64px | Primary CTAs, destructive actions |
+
+### Visual Size vs Hit Area
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│    ┌─────────────────────────┐      │
+│    │                         │      │
+│    │    [  BUTTON  ]         │ ← Visual: 36px
+│    │                         │      │
+│    └─────────────────────────┘      │
+│                                     │ ← Hit area: 48px (padding extends)
+└─────────────────────────────────────┘
+
+✅ CORRECT: Visual can be smaller if hit area is minimum 44-48px
+❌ WRONG: Making hit area same as small visual element
+```
+
+### Application Rules
+
+| Element | Visual Size | Hit Area |
+|---------|-------------|----------|
+| Icon buttons | 24-32px | 44-48px (padding) |
+| Text links | Any | 44px height minimum |
+| List items | Full width | 48-56px height |
+| Checkboxes/Radio | 20-24px | 44-48px tap area |
+| Close/X buttons | 24px | 44px minimum |
+| Tab bar items | Icon 24-28px | Full tab width, 49px height (iOS) |
+
+---
+
+## 2. Thumb Zone Anatomy
+
+### One-Handed Phone Usage
+
+```
+Research shows: 49% of users hold phone one-handed.
+
+┌─────────────────────────────────────┐
+│                                     │
+│  ┌─────────────────────────────┐    │
+│  │       HARD TO REACH         │    │ ← Status bar, top nav
+│  │      (requires stretch)     │    │    Put: Back, menu, settings
+│  │                             │    │
+│  ├─────────────────────────────┤    │
+│  │                             │    │
+│  │       OK TO REACH           │    │ ← Content area
+│  │      (comfortable)          │    │    Put: Secondary actions, content
+│  │                             │    │
+│  ├─────────────────────────────┤    │
+│  │                             │    │
+│  │       EASY TO REACH         │    │ ← Tab bar, FAB zone
+│  │      (thumb's arc)          │    │    Put: PRIMARY CTAs!
+│  │                             │    │
+│  └─────────────────────────────┘    │
+│                                     │
+│          [    HOME    ]             │
+└─────────────────────────────────────┘
+```
+
+### Thumb Arc (Right-Handed User)
+
+```
+Right hand holding phone:
+
+┌───────────────────────────────┐
+│  STRETCH      STRETCH    OK   │
+│                               │
+│  STRETCH        OK       EASY │
+│                               │
+│    OK          EASY      EASY │
+│                               │
+│   EASY         EASY      EASY │
+└───────────────────────────────┘
+
+Left hand is mirrored.
+→ Design for BOTH hands or assume right-dominant
+```
+
+### Placement Guidelines
+
+| Element Type | Ideal Position | Reason |
+|--------------|----------------|--------|
+| **Primary CTA** | Bottom center/right | Easy thumb reach |
+| **Tab bar** | Bottom | Natural thumb position |
+| **FAB** | Bottom right | Easy for right hand |
+| **Navigation** | Top (stretch) | Less frequent use |
+| **Destructive actions** | Top left | Hard to reach = harder to accidentally tap |
+| **Dismiss/Cancel** | Top left | Convention + safety |
+| **Confirm/Done** | Top right or bottom | Convention |
+
+### Large Phone Considerations (>6")
+
+```
+On large phones, top 40% becomes "dead zone" for one-handed use.
+
+Solutions:
+├── Reachability features (iOS)
+├── Pull-down interfaces (drawer pulls content down)
+├── Bottom sheet navigation
+├── Floating action buttons
+└── Gesture-based alternatives to top actions
+```
+
+---
+
+## 3. Touch vs Click Psychology
+
+### Expectation Differences
+
+| Aspect | Click (Desktop) | Touch (Mobile) |
+|--------|-----------------|----------------|
+| **Feedback timing** | Can wait 100ms | Expect instant (<50ms) |
+| **Visual feedback** | Hover → Click | Immediate tap response |
+| **Error tolerance** | Easy retry | Frustrating, feels broken |
+| **Precision** | High | Low |
+| **Context menu** | Right-click | Long press |
+| **Cancel action** | ESC key | Swipe away, outside tap |
+
+### Touch Feedback Requirements
+
+```
+Tap → Immediate visual change (< 50ms)
+├── Highlight state (background color change)
+├── Scale down slightly (0.95-0.98)
+├── Ripple effect (Android Material)
+├── Haptic feedback for confirmation
+└── Never nothing!
+
+Loading → Show within 100ms
+├── If action takes > 100ms
+├── Show spinner/progress
+├── Disable button (prevent double tap)
+└── Optimistic UI when possible
+```
+
+### The "Fat Finger" Problem
+
+```
+Problem: Finger occludes target during tap
+├── User can't see exactly where they're tapping
+├── Visual feedback appears UNDER finger
+└── Increases error rate
+
+Solutions:
+├── Show feedback ABOVE touch point (tooltips)
+├── Use cursor-like offset for precision tasks
+├── Magnification loupe for text selection
+└── Large enough targets that precision doesn't matter
+```
+
+---
+
+## 4. Gesture Psychology
+
+### Gesture Discoverability Problem
+
+```
+Problem: Gestures are INVISIBLE.
+├── User must discover/remember them
+├── No hover/visual hint
+├── Different mental model than tap
+└── Many users never discover gestures
+
+Solution: Always provide visible alternative
+├── Swipe to delete → Also show delete button or menu
+├── Pull to refresh → Also show refresh button
+├── Pinch to zoom → Also show zoom controls
+└── Gestures as shortcuts, not only way
+```
+
+### Common Gesture Conventions
+
+| Gesture | Universal Meaning | Usage |
+|---------|-------------------|-------|
+| **Tap** | Select, activate | Primary action |
+| **Double tap** | Zoom in, like/favorite | Quick action |
+| **Long press** | Context menu, selection mode | Secondary options |
+| **Swipe horizontal** | Navigation, delete, actions | List actions |
+| **Swipe down** | Refresh, dismiss | Pull to refresh |
+| **Pinch** | Zoom in/out | Maps, images |
+| **Two-finger scroll** | Scroll within scroll | Nested scrolls |
+
+### Gesture Affordance Design
+
+```
+Swipe actions need visual hints:
+
+┌─────────────────────────────────────────┐
+│  ┌───┐                                  │
+│  │ ≡ │  Item with hidden actions...   → │ ← Edge hint (partial color)
+│  └───┘                                  │
+└─────────────────────────────────────────┘
+
+✅ Good: Slight color peek at edge suggesting swipe
+✅ Good: Drag handle icon ( ≡ ) suggesting reorder
+✅ Good: Onboarding tooltip explaining gesture
+❌ Bad: Hidden gestures with no visual affordance
+```
+
+### Platform Gesture Differences
+
+| Gesture | iOS | Android |
+|---------|-----|---------|
+| **Back** | Edge swipe from left | System back button/gesture |
+| **Share** | Action sheet | Share sheet |
+| **Context menu** | Long press / Force touch | Long press |
+| **Dismiss modal** | Swipe down | Back button or swipe |
+| **Delete in list** | Swipe left, tap delete | Swipe left, immediate or undo |
+
+---
+
+## 5. Haptic Feedback Patterns
+
+### Why Haptics Matter
+
+```
+Haptics provide:
+├── Confirmation without looking
+├── Richer, more premium feel
+├── Accessibility (blind users)
+├── Reduced error rate
+└── Emotional satisfaction
+
+Without haptics:
+├── Feels "cheap" or web-like
+├── User unsure if action registered
+└── Missed opportunity for delight
+```
+
+### iOS Haptic Types
+
+| Type | Intensity | Use Case |
+|------|-----------|----------|
+| `selection` | Light | Picker scroll, toggle, selection |
+| `light` | Light | Minor actions, hover equivalent |
+| `medium` | Medium | Standard tap confirmation |
+| `heavy` | Strong | Important completed, drop |
+| `success` | Pattern | Task completed successfully |
+| `warning` | Pattern | Warning, attention needed |
+| `error` | Pattern | Error occurred |
+
+### Android Haptic Types
+
+| Type | Use Case |
+|------|----------|
+| `CLICK` | Standard tap feedback |
+| `HEAVY_CLICK` | Important actions |
+| `DOUBLE_CLICK` | Confirm actions |
+| `TICK` | Scroll/scrub feedback |
+| `LONG_PRESS` | Long press activation |
+| `REJECT` | Error/invalid action |
+
+### Haptic Usage Guidelines
+
+```
+✅ DO use haptics for:
+├── Button taps
+├── Toggle switches
+├── Picker/slider values
+├── Pull to refresh trigger
+├── Successful action completion
+├── Errors and warnings
+├── Swipe action thresholds
+└── Important state changes
+
+❌ DON'T use haptics for:
+├── Every scroll position
+├── Every list item
+├── Background events
+├── Passive displays
+└── Too frequently (haptic fatigue)
+```
+
+### Haptic Intensity Mapping
+
+| Action Importance | Haptic Level | Example |
+|-------------------|--------------|---------|
+| Minor/Browsing | Light / None | Scrolling, hovering |
+| Standard Action | Medium / Selection | Tap, toggle |
+| Significant Action | Heavy / Success | Complete, confirm |
+| Critical/Destructive | Heavy / Warning | Delete, payment |
+| Error | Error pattern | Failed action |
+
+---
+
+## 6. Mobile Cognitive Load
+
+### How Mobile Differs from Desktop
+
+| Factor | Desktop | Mobile | Implication |
+|--------|---------|--------|-------------|
+| **Attention** | Focused sessions | Interrupted constantly | Design for micro-sessions |
+| **Context** | Controlled environment | Anywhere, any condition | Handle bad lighting, noise |
+| **Multitasking** | Multiple windows | One app visible | Complete task in-app |
+| **Input speed** | Fast (keyboard) | Slow (touch typing) | Minimize input, smart defaults |
+| **Error recovery** | Easy (undo, back) | Harder (no keyboard shortcuts) | Prevent errors, easy recovery |
+
+### Reducing Mobile Cognitive Load
+
+```
+1. ONE PRIMARY ACTION per screen
+   └── Clear what to do next
+   
+2. PROGRESSIVE DISCLOSURE
+   └── Show only what's needed now
+   
+3. SMART DEFAULTS
+   └── Pre-fill what you can
+   
+4. CHUNKING
+   └── Break long forms into steps
+   
+5. RECOGNITION over RECALL
+   └── Show options, don't make user remember
+   
+6. CONTEXT PERSISTENCE
+   └── Save state on interrupt/background
+```
+
+### Miller's Law for Mobile
+
+```
+Desktop: 7±2 items in working memory
+Mobile: Reduce to 5±1 (more distractions)
+
+Navigation: Max 5 tab bar items
+Options: Max 5 per menu level
+Steps: Max 5 visible steps in progress
+```
+
+### Hick's Law for Mobile
+
+```
+More choices = slower decisions
+
+Mobile impact: Even worse than desktop
+├── Smaller screen = less overview
+├── Scrolling required = items forgotten
+├── Interruptions = lost context
+└── Decision fatigue faster
+
+Solution: Progressive disclosure
+├── Start with 3-5 options
+├── "More" for additional
+├── Smart ordering (most used first)
+└── Previous selections remembered
+```
+
+---
+
+## 7. Touch Accessibility
+
+### Motor Impairment Considerations
+
+```
+Users with motor impairments may:
+├── Have tremors (need larger targets)
+├── Use assistive devices (different input method)
+├── Have limited reach (one-handed necessity)
+├── Need more time (avoid timeouts)
+└── Make accidental touches (need confirmation)
+
+Design responses:
+├── Generous touch targets (48dp+)
+├── Adjustable timing for gestures
+├── Undo for destructive actions
+├── Switch control support
+└── Voice control support
+```
+
+### Touch Target Spacing (A11y)
+
+```
+WCAG 2.2 Success Criterion 2.5.8:
+
+Touch targets MUST have:
+├── Width: ≥ 44px
+├── Height: ≥ 44px
+├── Spacing: ≥ 8px from adjacent targets
+
+OR the target is:
+├── Inline (within text)
+├── User-controlled (user can resize)
+├── Essential (no alternative design)
+```
+
+### Accessible Touch Patterns
+
+| Pattern | Accessible Implementation |
+|---------|---------------------------|
+| Swipe actions | Provide menu alternative |
+| Drag and drop | Provide select + move option |
+| Pinch zoom | Provide zoom buttons |
+| Force touch | Provide long press alternative |
+| Shake gesture | Provide button alternative |
+
+---
+
+## 8. Emotion in Touch
+
+### The Premium Feel
+
+```
+What makes touch feel "premium":
+├── Instant response (< 50ms)
+├── Appropriate haptic feedback
+├── Smooth 60fps animations
+├── Correct resistance/physics
+├── Sound feedback (when appropriate)
+└── Attention to spring physics
+```
+
+### Emotional Touch Feedback
+
+| Emotion | Touch Response |
+|---------|----------------|
+| Success | Haptic success + confetti/check |
+| Error | Haptic error + shake animation |
+| Warning | Haptic warning + attention color |
+| Delight | Unexpected smooth animation |
+| Power | Heavy haptic on significant action |
+
+### Trust Building Through Touch
+
+```
+Trust signals in touch interactions:
+├── Consistent behavior (same action = same response)
+├── Reliable feedback (never fails silently)
+├── Secure feel for sensitive actions
+├── Professional animations (not janky)
+└── No accidental actions (confirmation for destructive)
+```
+
+---
+
+## 9. Touch Psychology Checklist
+
+### Before Every Screen
+
+- [ ] **All touch targets ≥ 44-48px?**
+- [ ] **Primary CTA in thumb zone?**
+- [ ] **Destructive actions require confirmation?**
+- [ ] **Gesture alternatives exist (visible buttons)?**
+- [ ] **Haptic feedback on important actions?**
+- [ ] **Immediate visual feedback on tap?**
+- [ ] **Loading states for actions > 100ms?**
+
+### Before Release
+
+- [ ] **Tested on smallest supported device?**
+- [ ] **Tested one-handed on large phone?**
+- [ ] **All gestures have visible alternatives?**
+- [ ] **Haptics work correctly (test on device)?**
+- [ ] **Touch targets tested with accessibility settings?**
+- [ ] **No tiny close buttons or icons?**
+
+---
+
+## 10. Quick Reference Card
+
+### Touch Target Sizes
+
+```
+                     iOS        Android     WCAG
+Minimum:           44pt       48dp       44px
+Recommended:       48pt+      56dp+      -
+Spacing:           8pt+       8dp+       8px+
+```
+
+### Thumb Zone Actions
+
+```
+TOP:      Navigation, settings, back (infrequent)
+MIDDLE:   Content, secondary actions
+BOTTOM:   Primary CTA, tab bar, FAB (frequent)
+```
+
+### Haptic Selection
+
+```
+Light:    Selection, toggle, minor
+Medium:   Tap, standard action
+Heavy:    Confirm, complete, drop
+Success:  Task done
+Error:    Failed action
+Warning:  Attention needed
+```
+
+---
+
+> **Remember:** Every touch is a conversation between user and device. Make it feel natural, responsive, and respectful of human fingers—not precise cursor points.
diff --git a/.agents/skills/mobile-developer/SKILL.md b/.agents/skills/mobile-developer/SKILL.md
new file mode 100644
index 0000000..e9d4a02
--- /dev/null
+++ b/.agents/skills/mobile-developer/SKILL.md
@@ -0,0 +1,205 @@
+---
+name: mobile-developer
+description: Develop React Native, Flutter, or native mobile apps with modern
+  architecture patterns. Masters cross-platform development, native
+  integrations, offline sync, and app store optimization. Use PROACTIVELY for
+  mobile features, cross-platform code, or app optimization.
+metadata:
+  model: inherit
+---
+
+## Use this skill when
+
+- Working on mobile developer tasks or workflows
+- Needing guidance, best practices, or checklists for mobile developer
+
+## Do not use this skill when
+
+- The task is unrelated to mobile developer
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a mobile development expert specializing in cross-platform and native mobile application development.
+
+## Purpose
+Expert mobile developer specializing in React Native, Flutter, and native iOS/Android development. Masters modern mobile architecture patterns, performance optimization, and platform-specific integrations while maintaining code reusability across platforms.
+
+## Capabilities
+
+### Cross-Platform Development
+- React Native with New Architecture (Fabric renderer, TurboModules, JSI)
+- Flutter with latest Dart 3.x features and Material Design 3
+- Expo SDK 50+ with development builds and EAS services
+- Ionic with Capacitor for web-to-mobile transitions
+- .NET MAUI for enterprise cross-platform solutions
+- Xamarin migration strategies to modern alternatives
+- PWA-to-native conversion strategies
+
+### React Native Expertise
+- New Architecture migration and optimization
+- Hermes JavaScript engine configuration
+- Metro bundler optimization and custom transformers
+- React Native 0.74+ features and performance improvements
+- Flipper and React Native debugger integration
+- Code splitting and bundle optimization techniques
+- Native module creation with Swift/Kotlin
+- Brownfield integration with existing native apps
+
+### Flutter & Dart Mastery
+- Flutter 3.x multi-platform support (mobile, web, desktop, embedded)
+- Dart 3 null safety and advanced language features
+- Custom render engines and platform channels
+- Flutter Engine customization and optimization
+- Impeller rendering engine migration from Skia
+- Flutter Web and desktop deployment strategies
+- Plugin development and FFI integration
+- State management with Riverpod, Bloc, and Provider
+
+### Native Development Integration
+- Swift/SwiftUI for iOS-specific features and optimizations
+- Kotlin/Compose for Android-specific implementations
+- Platform-specific UI guidelines (Human Interface Guidelines, Material Design)
+- Native performance profiling and memory management
+- Core Data, SQLite, and Room database integrations
+- Camera, sensors, and hardware API access
+- Background processing and app lifecycle management
+
+### Architecture & Design Patterns
+- Clean Architecture implementation for mobile apps
+- MVVM, MVP, and MVI architectural patterns
+- Dependency injection with Hilt, Dagger, or GetIt
+- Repository pattern for data abstraction
+- State management patterns (Redux, BLoC, MVI)
+- Modular architecture and feature-based organization
+- Microservices integration and API design
+- Offline-first architecture with conflict resolution
+
+### Performance Optimization
+- Startup time optimization and cold launch improvements
+- Memory management and leak prevention
+- Battery optimization and background execution
+- Network efficiency and request optimization
+- Image loading and caching strategies
+- List virtualization for large datasets
+- Animation performance and 60fps maintenance
+- Code splitting and lazy loading patterns
+
+### Data Management & Sync
+- Offline-first data synchronization patterns
+- SQLite, Realm, and Hive database implementations
+- GraphQL with Apollo Client or Relay
+- REST API integration with caching strategies
+- Real-time data sync with WebSockets or Firebase
+- Conflict resolution and operational transforms
+- Data encryption and security best practices
+- Background sync and delta synchronization
+
+### Platform Services & Integrations
+- Push notifications (FCM, APNs) with rich media
+- Deep linking and universal links implementation
+- Social authentication (Google, Apple, Facebook)
+- Payment integration (Stripe, Apple Pay, Google Pay)
+- Maps integration (Google Maps, Apple MapKit)
+- Camera and media processing capabilities
+- Biometric authentication and secure storage
+- Analytics and crash reporting integration
+
+### Testing Strategies
+- Unit testing with Jest, Dart test, and XCTest
+- Widget/component testing frameworks
+- Integration testing with Detox, Maestro, or Patrol
+- UI testing and visual regression testing
+- Device farm testing (Firebase Test Lab, Bitrise)
+- Performance testing and profiling
+- Accessibility testing and compliance
+- Automated testing in CI/CD pipelines
+
+### DevOps & Deployment
+- CI/CD pipelines with Bitrise, GitHub Actions, or Codemagic
+- Fastlane for automated deployments and screenshots
+- App Store Connect and Google Play Console automation
+- Code signing and certificate management
+- Over-the-air (OTA) updates with CodePush or EAS Update
+- Beta testing with TestFlight and Internal App Sharing
+- Crash monitoring with Sentry, Bugsnag, or Firebase Crashlytics
+- Performance monitoring and APM tools
+
+### Security & Compliance
+- Mobile app security best practices (OWASP MASVS)
+- Certificate pinning and network security
+- Biometric authentication implementation
+- Secure storage and keychain integration
+- Code obfuscation and anti-tampering techniques
+- GDPR and privacy compliance implementation
+- App Transport Security (ATS) configuration
+- Runtime Application Self-Protection (RASP)
+
+### App Store Optimization
+- App Store Connect and Google Play Console mastery
+- Metadata optimization and ASO best practices
+- Screenshots and preview video creation
+- A/B testing for store listings
+- Review management and response strategies
+- App bundle optimization and APK size reduction
+- Dynamic delivery and feature modules
+- Privacy nutrition labels and data disclosure
+
+### Advanced Mobile Features
+- Augmented Reality (ARKit, ARCore) integration
+- Machine Learning on-device with Core ML and ML Kit
+- IoT device connectivity and BLE protocols
+- Wearable app development (Apple Watch, Wear OS)
+- Widget development for home screen integration
+- Live Activities and Dynamic Island implementation
+- Background app refresh and silent notifications
+- App Clips and Instant Apps development
+
+## Behavioral Traits
+- Prioritizes user experience across all platforms
+- Balances code reuse with platform-specific optimizations
+- Implements comprehensive error handling and offline capabilities
+- Follows platform-specific design guidelines religiously
+- Considers performance implications of every architectural decision
+- Writes maintainable, testable mobile code
+- Keeps up with platform updates and deprecations
+- Implements proper analytics and monitoring
+- Considers accessibility from the development phase
+- Plans for internationalization and localization
+
+## Knowledge Base
+- React Native New Architecture and latest releases
+- Flutter roadmap and Dart language evolution
+- iOS SDK updates and SwiftUI advancements
+- Android Jetpack libraries and Kotlin evolution
+- Mobile security standards and compliance requirements
+- App store guidelines and review processes
+- Mobile performance optimization techniques
+- Cross-platform development trade-offs and decisions
+- Mobile UX patterns and platform conventions
+- Emerging mobile technologies and trends
+
+## Response Approach
+1. **Assess platform requirements** and cross-platform opportunities
+2. **Recommend optimal architecture** based on app complexity and team skills
+3. **Provide platform-specific implementations** when necessary
+4. **Include performance optimization** strategies from the start
+5. **Consider offline scenarios** and error handling
+6. **Implement proper testing strategies** for quality assurance
+7. **Plan deployment and distribution** workflows
+8. **Address security and compliance** requirements
+
+## Example Interactions
+- "Architect a cross-platform e-commerce app with offline capabilities"
+- "Migrate React Native app to New Architecture with TurboModules"
+- "Implement biometric authentication across iOS and Android"
+- "Optimize Flutter app performance for 60fps animations"
+- "Set up CI/CD pipeline for automated app store deployments"
+- "Create native modules for camera processing in React Native"
+- "Implement real-time chat with offline message queueing"
+- "Design offline-first data sync with conflict resolution"
diff --git a/.agents/skills/mobile-first-design/SKILL.md b/.agents/skills/mobile-first-design/SKILL.md
new file mode 100644
index 0000000..0aaa431
--- /dev/null
+++ b/.agents/skills/mobile-first-design/SKILL.md
@@ -0,0 +1,305 @@
+---
+name: mobile-first-design
+description: Design for mobile devices first, then scale up to larger screens. Create responsive interfaces that work seamlessly across all device sizes.
+---
+
+# Mobile-First Design
+
+## Overview
+
+Mobile-first design prioritizes small screens as the starting point, ensuring core functionality works on all devices while leveraging larger screens for enhanced experience.
+
+## When to Use
+
+- Web application design
+- Responsive website creation
+- Feature prioritization
+- Performance optimization
+- Progressive enhancement
+- Cross-device experience design
+
+## Instructions
+
+### 1. **Mobile-First Principles**
+
+```yaml
+Mobile-First Approach:
+
+Step 1: Design for Mobile (320px - 480px)
+  - Constrained space forces priorities
+  - Focus on essential content and actions
+  - Single column layout
+  - Touch-friendly interactive elements
+
+Step 2: Enhance for Tablet (768px - 1024px)
+  - Add secondary content
+  - Multi-column layouts possible
+  - Optimize spacing and readability
+  - Take advantage of hover states
+
+Step 3: Optimize for Desktop (1200px+)
+  - Full-featured experience
+  - Advanced layouts
+  - Rich interactions
+  - Multiple columns and sidebars
+
+---
+
+## Responsive Breakpoints:
+
+Mobile: 320px - 480px
+  - iPhone SE, older phones
+  - Strict space constraints
+  - Touch-only interaction
+
+Tablet: 481px - 768px
+  - iPad mini, tablets
+  - More space available
+  - Touch + keyboard/mouse
+
+Large Tablet/Small Desktop: 769px - 1024px
+  - iPad Pro, small laptops
+  - Transitional breakpoint
+  - Both touch and pointer
+
+Desktop: 1025px - 1440px
+  - Standard laptops
+  - Full feature set
+  - Hover states enabled
+
+Large Desktop: 1441px+
+  - Ultrawide monitors
+  - Consider max-width container
+  - Avoid stretching too wide
+
+---
+
+## Mobile Design Patterns:
+
+Navigation:
+  Mobile: Hamburger menu, bottom tabs
+  Tablet: Side drawer
+  Desktop: Horizontal menu bar
+
+Forms:
+  Mobile: Single column, large touch targets (48px)
+  Tablet: 2 columns if space allows
+  Desktop: Multi-column, side-by-side labels
+
+Content Layout:
+  Mobile: Full width, single column
+  Tablet: 1-2 columns
+  Desktop: Multi-column, sidebar
+
+Images:
+  Mobile: Full width
+  Tablet: Full or constrained width
+  Desktop: Constrained width, may use columns
+```
+
+### 2. **Responsive Design Implementation**
+
+```python
+# Implement responsive CSS and layouts
+
+class ResponsiveDesign:
+    def create_responsive_grid(self, mobile_cols=1):
+        """CSS Grid responsive structure"""
+        return {
+            'mobile': {
+                'columns': 1,
+                'gap': '16px',
+                'breakpoint': 'max-width: 480px'
+            },
+            'tablet': {
+                'columns': 2,
+                'gap': '24px',
+                'breakpoint': '481px - 768px'
+            },
+            'desktop': {
+                'columns': 3,
+                'gap': '32px',
+                'breakpoint': 'min-width: 769px'
+            }
+        }
+
+    def responsive_typography(self):
+        """Fluid font sizes"""
+        return {
+            'h1': {
+                'mobile': '24px',
+                'tablet': '32px',
+                'desktop': '48px',
+                'line_height': {
+                    'mobile': '1.2',
+                    'desktop': '1.3'
+                }
+            },
+            'body': {
+                'mobile': '14px',
+                'tablet': '16px',
+                'desktop': '16px',
+                'line_height': '1.6'
+            }
+        }
+
+    def responsive_spacing(self):
+        """Adaptive padding and margins"""
+        return {
+            'container_padding': {
+                'mobile': '16px',
+                'tablet': '24px',
+                'desktop': '32px'
+            },
+            'section_margin': {
+                'mobile': '24px',
+                'desktop': '48px'
+            },
+            'touch_target_size': '44px minimum (Apple)'
+        }
+
+    def touch_friendly_design(self):
+        """Mobile interaction optimization"""
+        return {
+            'button_size': '44px x 44px minimum',
+            'touch_target_spacing': '8px minimum between',
+            'form_input_height': '44px + 16px padding',
+            'scrolling_area': 'Full width swipe friendly',
+            'modal_height': 'Max 85vh, scrollable',
+            'keyboard_awareness': 'Account for software keyboard'
+        }
+```
+
+### 3. **Mobile Performance**
+
+```yaml
+Mobile Performance Optimization:
+
+Image Optimization:
+  - Responsive images (srcset, picture element)
+  - WebP format with fallback
+  - Lazy loading for below-fold
+  - Compress ruthlessly
+  - Serve appropriately sized images
+
+Metric Goals:
+  - Mobile: <3 second First Contentful Paint
+  - Mobile: <4 second Largest Contentful Paint
+  - Mobile: < 100 Cumulative Layout Shift
+
+Bundle Size:
+  - Mobile: <100KB JavaScript (gzipped)
+  - Mobile: <50KB CSS (gzipped)
+  - Critical CSS inline
+
+Network:
+  - Minimize requests (combine files)
+  - Enable gzip compression
+  - Use CDN for assets
+  - Cache aggressively
+
+---
+
+Testing Devices:
+
+Physical Devices:
+  - iPhone SE (320px baseline)
+  - iPhone 13 Pro (390px)
+  - Samsung S21 (360px)
+  - iPad (768px)
+
+Emulation:
+  - Chrome DevTools device mode
+  - Responsive design mode
+  - Test orientation changes
+
+Real Device Testing:
+  - Test on actual devices
+  - Check touch interactions
+  - Verify performance
+  - Test with slow network
+```
+
+### 4. **Progressive Enhancement**
+
+```yaml
+Progressive Enhancement Strategy:
+
+Layer 1: Core Content (HTML)
+  - Semantic HTML
+  - Works without CSS or JavaScript
+  - Text content readable
+  - Forms functional
+
+Layer 2: Enhanced (CSS)
+  - Visual design
+  - Layout and spacing
+  - Colors and typography
+  - Responsive design
+
+Layer 3: Interactive (JavaScript)
+  - Progressive loading
+  - Form enhancements
+  - Smooth interactions
+  - Offline functionality
+  - Push notifications
+
+Fallback Approach:
+  - Input: range slider → Text input fallback
+  - Video: HTML5 video → Link to download
+  - Map: Interactive map → Static image link
+  - Single-page app → Server-side rendering
+
+---
+
+Testing Strategy:
+
+1. Disable JavaScript
+   - Core content still accessible
+   - Forms still submit
+   - Links work
+
+2. Slow 3G Network
+   - Page loads
+   - Critical content visible
+   - Non-critical lazy loads
+
+3. No Styles (CSS disabled)
+   - Content readable
+   - Text size appropriate
+   - Contrast sufficient
+```
+
+## Best Practices
+
+### ✅ DO
+- Design for smallest screen first
+- Test on real mobile devices
+- Use responsive images
+- Optimize for mobile performance
+- Make touch targets 44x44px minimum
+- Stack content vertically on mobile
+- Use hamburger menu on mobile
+- Hide non-essential content on mobile
+- Test with slow networks
+- Progressive enhancement approach
+
+### ❌ DON'T
+- Assume all mobile users have fast networks
+- Use desktop-only patterns on mobile
+- Ignore touch interaction needs
+- Make buttons too small
+- Forget about landscape orientation
+- Over-complicate mobile layout
+- Ignore mobile performance
+- Assume no keyboard (iPad users)
+- Skip mobile user testing
+- Forget about notches and safe areas
+
+## Mobile-First Design Tips
+
+- Use max-width containers (max 1200px typical)
+- Test on oldest iPhone SE (320px) for baseline
+- Implement touch-friendly spacing (48px minimum)
+- Use flexible layouts over fixed widths
+- Test with slow 3G network simulation
diff --git a/.agents/skills/mobile-ios-design/SKILL.md b/.agents/skills/mobile-ios-design/SKILL.md
new file mode 100644
index 0000000..1f622bf
--- /dev/null
+++ b/.agents/skills/mobile-ios-design/SKILL.md
@@ -0,0 +1,272 @@
+---
+name: mobile-ios-design
+description: Master iOS Human Interface Guidelines and SwiftUI patterns for building native iOS apps. Use when designing iOS interfaces, implementing SwiftUI views, or ensuring apps follow Apple's design principles.
+---
+
+# iOS Mobile Design
+
+Master iOS Human Interface Guidelines (HIG) and SwiftUI patterns to build polished, native iOS applications that feel at home on Apple platforms.
+
+## When to Use This Skill
+
+- Designing iOS app interfaces following Apple HIG
+- Building SwiftUI views and layouts
+- Implementing iOS navigation patterns (NavigationStack, TabView, sheets)
+- Creating adaptive layouts for iPhone and iPad
+- Using SF Symbols and system typography
+- Building accessible iOS interfaces
+- Implementing iOS-specific gestures and interactions
+- Designing for Dynamic Type and Dark Mode
+
+## Core Concepts
+
+### 1. Human Interface Guidelines Principles
+
+**Clarity**: Content is legible, icons are precise, adornments are subtle
+**Deference**: UI helps users understand content without competing with it
+**Depth**: Visual layers and motion convey hierarchy and enable navigation
+
+**Platform Considerations:**
+
+- **iOS**: Touch-first, compact displays, portrait orientation
+- **iPadOS**: Larger canvas, multitasking, pointer support
+- **visionOS**: Spatial computing, eye/hand input
+
+### 2. SwiftUI Layout System
+
+**Stack-Based Layouts:**
+
+```swift
+// Vertical stack with alignment
+VStack(alignment: .leading, spacing: 12) {
+    Text("Title")
+        .font(.headline)
+    Text("Subtitle")
+        .font(.subheadline)
+        .foregroundStyle(.secondary)
+}
+
+// Horizontal stack with flexible spacing
+HStack {
+    Image(systemName: "star.fill")
+    Text("Featured")
+    Spacer()
+    Text("View All")
+        .foregroundStyle(.blue)
+}
+```
+
+**Grid Layouts:**
+
+```swift
+// Adaptive grid that fills available width
+LazyVGrid(columns: [
+    GridItem(.adaptive(minimum: 150, maximum: 200))
+], spacing: 16) {
+    ForEach(items) { item in
+        ItemCard(item: item)
+    }
+}
+
+// Fixed column grid
+LazyVGrid(columns: [
+    GridItem(.flexible()),
+    GridItem(.flexible()),
+    GridItem(.flexible())
+], spacing: 12) {
+    ForEach(items) { item in
+        ItemThumbnail(item: item)
+    }
+}
+```
+
+### 3. Navigation Patterns
+
+**NavigationStack (iOS 16+):**
+
+```swift
+struct ContentView: View {
+    @State private var path = NavigationPath()
+
+    var body: some View {
+        NavigationStack(path: $path) {
+            List(items) { item in
+                NavigationLink(value: item) {
+                    ItemRow(item: item)
+                }
+            }
+            .navigationTitle("Items")
+            .navigationDestination(for: Item.self) { item in
+                ItemDetailView(item: item)
+            }
+        }
+    }
+}
+```
+
+**TabView:**
+
+```swift
+struct MainTabView: View {
+    @State private var selectedTab = 0
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            HomeView()
+                .tabItem {
+                    Label("Home", systemImage: "house")
+                }
+                .tag(0)
+
+            SearchView()
+                .tabItem {
+                    Label("Search", systemImage: "magnifyingglass")
+                }
+                .tag(1)
+
+            ProfileView()
+                .tabItem {
+                    Label("Profile", systemImage: "person")
+                }
+                .tag(2)
+        }
+    }
+}
+```
+
+### 4. System Integration
+
+**SF Symbols:**
+
+```swift
+// Basic symbol
+Image(systemName: "heart.fill")
+    .foregroundStyle(.red)
+
+// Symbol with rendering mode
+Image(systemName: "cloud.sun.fill")
+    .symbolRenderingMode(.multicolor)
+
+// Variable symbol (iOS 16+)
+Image(systemName: "speaker.wave.3.fill", variableValue: volume)
+
+// Symbol effect (iOS 17+)
+Image(systemName: "bell.fill")
+    .symbolEffect(.bounce, value: notificationCount)
+```
+
+**Dynamic Type:**
+
+```swift
+// Use semantic fonts
+Text("Headline")
+    .font(.headline)
+
+Text("Body text that scales with user preferences")
+    .font(.body)
+
+// Custom font that respects Dynamic Type
+Text("Custom")
+    .font(.custom("Avenir", size: 17, relativeTo: .body))
+```
+
+### 5. Visual Design
+
+**Colors and Materials:**
+
+```swift
+// Semantic colors that adapt to light/dark mode
+Text("Primary")
+    .foregroundStyle(.primary)
+Text("Secondary")
+    .foregroundStyle(.secondary)
+
+// System materials for blur effects
+Rectangle()
+    .fill(.ultraThinMaterial)
+    .frame(height: 100)
+
+// Vibrant materials for overlays
+Text("Overlay")
+    .padding()
+    .background(.regularMaterial, in: RoundedRectangle(cornerRadius: 12))
+```
+
+**Shadows and Depth:**
+
+```swift
+// Standard card shadow
+RoundedRectangle(cornerRadius: 16)
+    .fill(.background)
+    .shadow(color: .black.opacity(0.1), radius: 8, y: 4)
+
+// Elevated appearance
+.shadow(radius: 2, y: 1)
+.shadow(radius: 8, y: 4)
+```
+
+## Quick Start Component
+
+```swift
+import SwiftUI
+
+struct FeatureCard: View {
+    let title: String
+    let description: String
+    let systemImage: String
+
+    var body: some View {
+        HStack(spacing: 16) {
+            Image(systemName: systemImage)
+                .font(.title)
+                .foregroundStyle(.blue)
+                .frame(width: 44, height: 44)
+                .background(.blue.opacity(0.1), in: Circle())
+
+            VStack(alignment: .leading, spacing: 4) {
+                Text(title)
+                    .font(.headline)
+                Text(description)
+                    .font(.subheadline)
+                    .foregroundStyle(.secondary)
+                    .lineLimit(2)
+            }
+
+            Spacer()
+
+            Image(systemName: "chevron.right")
+                .foregroundStyle(.tertiary)
+        }
+        .padding()
+        .background(.background, in: RoundedRectangle(cornerRadius: 12))
+        .shadow(color: .black.opacity(0.05), radius: 4, y: 2)
+    }
+}
+```
+
+## Best Practices
+
+1. **Use Semantic Colors**: Always use `.primary`, `.secondary`, `.background` for automatic light/dark mode support
+2. **Embrace SF Symbols**: Use system symbols for consistency and automatic accessibility
+3. **Support Dynamic Type**: Use semantic fonts (`.body`, `.headline`) instead of fixed sizes
+4. **Add Accessibility**: Include `.accessibilityLabel()` and `.accessibilityHint()` modifiers
+5. **Use Safe Areas**: Respect `safeAreaInset` and avoid hardcoded padding at screen edges
+6. **Implement State Restoration**: Use `@SceneStorage` for preserving user state
+7. **Support iPad Multitasking**: Design for split view and slide over
+8. **Test on Device**: Simulator doesn't capture full haptic and performance experience
+
+## Common Issues
+
+- **Layout Breaking**: Use `.fixedSize()` sparingly; prefer flexible layouts
+- **Performance Issues**: Use `LazyVStack`/`LazyHStack` for long scrolling lists
+- **Navigation Bugs**: Ensure `NavigationLink` values are `Hashable`
+- **Dark Mode Problems**: Avoid hardcoded colors; use semantic or asset catalog colors
+- **Accessibility Failures**: Test with VoiceOver enabled
+- **Memory Leaks**: Watch for strong reference cycles in closures
+
+## Resources
+
+- [Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/)
+- [SwiftUI Documentation](https://developer.apple.com/documentation/swiftui)
+- [SF Symbols App](https://developer.apple.com/sf-symbols/)
+- [WWDC SwiftUI Sessions](https://developer.apple.com/videos/swiftui/)
diff --git a/.agents/skills/mobile-ios-design/references/hig-patterns.md b/.agents/skills/mobile-ios-design/references/hig-patterns.md
new file mode 100644
index 0000000..978ec41
--- /dev/null
+++ b/.agents/skills/mobile-ios-design/references/hig-patterns.md
@@ -0,0 +1,529 @@
+# iOS Human Interface Guidelines Patterns
+
+## Layout and Spacing
+
+### Standard Margins and Padding
+
+```swift
+// System standard margins
+private let standardMargin: CGFloat = 16
+private let compactMargin: CGFloat = 8
+private let largeMargin: CGFloat = 24
+
+// Content insets following HIG
+extension EdgeInsets {
+    static let standard = EdgeInsets(top: 16, leading: 16, bottom: 16, trailing: 16)
+    static let listRow = EdgeInsets(top: 12, leading: 16, bottom: 12, trailing: 16)
+    static let card = EdgeInsets(top: 16, leading: 16, bottom: 16, trailing: 16)
+}
+```
+
+### Safe Area Handling
+
+```swift
+struct SafeAreaAwareView: View {
+    var body: some View {
+        ScrollView {
+            LazyVStack(spacing: 16) {
+                ForEach(items) { item in
+                    ItemRow(item: item)
+                }
+            }
+            .padding(.horizontal)
+        }
+        .safeAreaInset(edge: .bottom) {
+            // Floating action area
+            HStack {
+                Button("Cancel") { }
+                    .buttonStyle(.bordered)
+                Spacer()
+                Button("Confirm") { }
+                    .buttonStyle(.borderedProminent)
+            }
+            .padding()
+            .background(.regularMaterial)
+        }
+    }
+}
+```
+
+### Adaptive Layouts
+
+```swift
+struct AdaptiveGridView: View {
+    @Environment(\.horizontalSizeClass) private var sizeClass
+
+    private var columns: [GridItem] {
+        switch sizeClass {
+        case .compact:
+            return [GridItem(.flexible())]
+        case .regular:
+            return [
+                GridItem(.flexible()),
+                GridItem(.flexible()),
+                GridItem(.flexible())
+            ]
+        default:
+            return [GridItem(.flexible())]
+        }
+    }
+
+    var body: some View {
+        ScrollView {
+            LazyVGrid(columns: columns, spacing: 16) {
+                ForEach(items) { item in
+                    ItemCard(item: item)
+                }
+            }
+            .padding()
+        }
+    }
+}
+```
+
+## Typography Hierarchy
+
+### System Font Styles
+
+```swift
+// HIG-compliant typography scale
+struct Typography {
+    // Titles
+    static let largeTitle = Font.largeTitle.weight(.bold)      // 34pt bold
+    static let title = Font.title.weight(.semibold)            // 28pt semibold
+    static let title2 = Font.title2.weight(.semibold)          // 22pt semibold
+    static let title3 = Font.title3.weight(.semibold)          // 20pt semibold
+
+    // Headlines and body
+    static let headline = Font.headline                         // 17pt semibold
+    static let body = Font.body                                 // 17pt regular
+    static let callout = Font.callout                          // 16pt regular
+
+    // Supporting text
+    static let subheadline = Font.subheadline                  // 15pt regular
+    static let footnote = Font.footnote                        // 13pt regular
+    static let caption = Font.caption                          // 12pt regular
+    static let caption2 = Font.caption2                        // 11pt regular
+}
+```
+
+### Custom Font with Dynamic Type
+
+```swift
+extension Font {
+    static func customBody(_ name: String) -> Font {
+        .custom(name, size: 17, relativeTo: .body)
+    }
+
+    static func customHeadline(_ name: String) -> Font {
+        .custom(name, size: 17, relativeTo: .headline)
+            .weight(.semibold)
+    }
+}
+
+// Usage
+Text("Custom styled text")
+    .font(.customBody("Avenir Next"))
+```
+
+## Color System
+
+### Semantic Colors
+
+```swift
+// Use semantic colors for automatic light/dark mode support
+extension Color {
+    // Labels
+    static let primaryLabel = Color.primary
+    static let secondaryLabel = Color.secondary
+    static let tertiaryLabel = Color(uiColor: .tertiaryLabel)
+
+    // Backgrounds
+    static let systemBackground = Color(uiColor: .systemBackground)
+    static let secondaryBackground = Color(uiColor: .secondarySystemBackground)
+    static let groupedBackground = Color(uiColor: .systemGroupedBackground)
+
+    // Fills
+    static let primaryFill = Color(uiColor: .systemFill)
+    static let secondaryFill = Color(uiColor: .secondarySystemFill)
+
+    // Separators
+    static let separator = Color(uiColor: .separator)
+    static let opaqueSeparator = Color(uiColor: .opaqueSeparator)
+}
+```
+
+### Tint Colors
+
+```swift
+// App-wide tint color
+struct AppColors {
+    static let primary = Color.blue
+    static let secondary = Color.purple
+    static let success = Color.green
+    static let warning = Color.orange
+    static let error = Color.red
+
+    // Semantic tints
+    static let interactive = Color.accentColor
+    static let destructive = Color.red
+}
+
+// Apply tint to views
+ContentView()
+    .tint(AppColors.primary)
+```
+
+## Navigation Patterns
+
+### Hierarchical Navigation
+
+```swift
+struct MasterDetailView: View {
+    @State private var selectedItem: Item?
+    @Environment(\.horizontalSizeClass) private var sizeClass
+
+    var body: some View {
+        NavigationSplitView {
+            // Sidebar
+            List(items, selection: $selectedItem) { item in
+                NavigationLink(value: item) {
+                    ItemRow(item: item)
+                }
+            }
+            .navigationTitle("Items")
+            .toolbar {
+                ToolbarItem(placement: .primaryAction) {
+                    Button("Add", systemImage: "plus") { }
+                }
+            }
+        } detail: {
+            // Detail view
+            if let item = selectedItem {
+                ItemDetailView(item: item)
+            } else {
+                ContentUnavailableView(
+                    "Select an Item",
+                    systemImage: "sidebar.leading"
+                )
+            }
+        }
+        .navigationSplitViewStyle(.balanced)
+    }
+}
+```
+
+### Tab-Based Navigation
+
+```swift
+struct MainTabView: View {
+    @State private var selectedTab: Tab = .home
+
+    enum Tab: String, CaseIterable {
+        case home, explore, notifications, profile
+
+        var title: String {
+            rawValue.capitalized
+        }
+
+        var systemImage: String {
+            switch self {
+            case .home: return "house"
+            case .explore: return "magnifyingglass"
+            case .notifications: return "bell"
+            case .profile: return "person"
+            }
+        }
+    }
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            ForEach(Tab.allCases, id: \.self) { tab in
+                NavigationStack {
+                    tabContent(for: tab)
+                }
+                .tabItem {
+                    Label(tab.title, systemImage: tab.systemImage)
+                }
+                .tag(tab)
+            }
+        }
+    }
+
+    @ViewBuilder
+    private func tabContent(for tab: Tab) -> some View {
+        switch tab {
+        case .home:
+            HomeView()
+        case .explore:
+            ExploreView()
+        case .notifications:
+            NotificationsView()
+        case .profile:
+            ProfileView()
+        }
+    }
+}
+```
+
+## Toolbar Patterns
+
+### Standard Toolbar Items
+
+```swift
+struct ContentView: View {
+    @State private var isEditing = false
+
+    var body: some View {
+        NavigationStack {
+            List { /* content */ }
+            .navigationTitle("Items")
+            .toolbar {
+                // Leading items
+                ToolbarItem(placement: .topBarLeading) {
+                    EditButton()
+                }
+
+                // Trailing items
+                ToolbarItemGroup(placement: .topBarTrailing) {
+                    Button("Filter", systemImage: "line.3.horizontal.decrease.circle") { }
+                    Button("Add", systemImage: "plus") { }
+                }
+
+                // Bottom bar
+                ToolbarItemGroup(placement: .bottomBar) {
+                    Button("Archive", systemImage: "archivebox") { }
+                    Spacer()
+                    Text("\(itemCount) items")
+                        .font(.footnote)
+                        .foregroundStyle(.secondary)
+                    Spacer()
+                    Button("Share", systemImage: "square.and.arrow.up") { }
+                }
+            }
+            .toolbarBackground(.visible, for: .bottomBar)
+        }
+    }
+}
+```
+
+### Search Integration
+
+```swift
+struct SearchableView: View {
+    @State private var searchText = ""
+    @State private var searchScope: SearchScope = .all
+    @State private var isSearching = false
+
+    enum SearchScope: String, CaseIterable {
+        case all, titles, content
+    }
+
+    var body: some View {
+        NavigationStack {
+            List(filteredItems) { item in
+                ItemRow(item: item)
+            }
+            .navigationTitle("Library")
+            .searchable(
+                text: $searchText,
+                isPresented: $isSearching,
+                placement: .navigationBarDrawer(displayMode: .always)
+            )
+            .searchScopes($searchScope) {
+                ForEach(SearchScope.allCases, id: \.self) { scope in
+                    Text(scope.rawValue.capitalized).tag(scope)
+                }
+            }
+        }
+    }
+}
+```
+
+## Feedback Patterns
+
+### Haptic Feedback
+
+```swift
+struct HapticFeedback {
+    static func impact(_ style: UIImpactFeedbackGenerator.FeedbackStyle = .medium) {
+        let generator = UIImpactFeedbackGenerator(style: style)
+        generator.impactOccurred()
+    }
+
+    static func notification(_ type: UINotificationFeedbackGenerator.FeedbackType) {
+        let generator = UINotificationFeedbackGenerator()
+        generator.notificationOccurred(type)
+    }
+
+    static func selection() {
+        let generator = UISelectionFeedbackGenerator()
+        generator.selectionChanged()
+    }
+}
+
+// Usage
+Button("Submit") {
+    HapticFeedback.notification(.success)
+    submit()
+}
+```
+
+### Visual Feedback
+
+```swift
+struct FeedbackButton: View {
+    let title: String
+    let action: () -> Void
+
+    @State private var showSuccess = false
+
+    var body: some View {
+        Button(title) {
+            action()
+            withAnimation {
+                showSuccess = true
+            }
+            DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
+                withAnimation {
+                    showSuccess = false
+                }
+            }
+        }
+        .overlay(alignment: .trailing) {
+            if showSuccess {
+                Image(systemName: "checkmark.circle.fill")
+                    .foregroundStyle(.green)
+                    .transition(.scale.combined(with: .opacity))
+            }
+        }
+    }
+}
+```
+
+## Accessibility
+
+### VoiceOver Support
+
+```swift
+struct AccessibleCard: View {
+    let item: Item
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            Text(item.title)
+                .font(.headline)
+            Text(item.subtitle)
+                .font(.subheadline)
+                .foregroundStyle(.secondary)
+
+            HStack {
+                Image(systemName: "star.fill")
+                Text("\(item.rating, specifier: "%.1f")")
+            }
+        }
+        .padding()
+        .accessibilityElement(children: .combine)
+        .accessibilityLabel("\(item.title), \(item.subtitle)")
+        .accessibilityValue("Rating: \(item.rating) stars")
+        .accessibilityHint("Double tap to view details")
+        .accessibilityAddTraits(.isButton)
+    }
+}
+```
+
+### Dynamic Type Support
+
+```swift
+struct DynamicTypeView: View {
+    @Environment(\.dynamicTypeSize) private var dynamicTypeSize
+
+    var body: some View {
+        Group {
+            if dynamicTypeSize.isAccessibilitySize {
+                // Stack vertically for accessibility sizes
+                VStack(alignment: .leading, spacing: 12) {
+                    leadingContent
+                    trailingContent
+                }
+            } else {
+                // Side-by-side for standard sizes
+                HStack {
+                    leadingContent
+                    Spacer()
+                    trailingContent
+                }
+            }
+        }
+    }
+
+    var leadingContent: some View {
+        Label("Items", systemImage: "folder")
+    }
+
+    var trailingContent: some View {
+        Text("12")
+            .foregroundStyle(.secondary)
+    }
+}
+```
+
+## Error Handling UI
+
+### Error States
+
+```swift
+struct ErrorView: View {
+    let error: Error
+    let retryAction: () async -> Void
+
+    var body: some View {
+        ContentUnavailableView {
+            Label("Unable to Load", systemImage: "exclamationmark.triangle")
+        } description: {
+            Text(error.localizedDescription)
+        } actions: {
+            Button("Try Again") {
+                Task {
+                    await retryAction()
+                }
+            }
+            .buttonStyle(.borderedProminent)
+        }
+    }
+}
+```
+
+### Empty States
+
+```swift
+struct EmptyStateView: View {
+    let title: String
+    let description: String
+    let systemImage: String
+    let action: (() -> Void)?
+    let actionTitle: String?
+
+    var body: some View {
+        ContentUnavailableView {
+            Label(title, systemImage: systemImage)
+        } description: {
+            Text(description)
+        } actions: {
+            if let action, let actionTitle {
+                Button(actionTitle, action: action)
+                    .buttonStyle(.borderedProminent)
+            }
+        }
+    }
+}
+
+// Usage
+EmptyStateView(
+    title: "No Photos",
+    description: "Take your first photo to get started.",
+    systemImage: "camera",
+    action: { showCamera = true },
+    actionTitle: "Take Photo"
+)
+```
diff --git a/.agents/skills/mobile-ios-design/references/ios-navigation.md b/.agents/skills/mobile-ios-design/references/ios-navigation.md
new file mode 100644
index 0000000..db3e537
--- /dev/null
+++ b/.agents/skills/mobile-ios-design/references/ios-navigation.md
@@ -0,0 +1,564 @@
+# iOS Navigation Patterns
+
+## NavigationStack (iOS 16+)
+
+### Basic Navigation
+
+```swift
+struct BasicNavigationView: View {
+    var body: some View {
+        NavigationStack {
+            List(items) { item in
+                NavigationLink(item.title, value: item)
+            }
+            .navigationTitle("Items")
+            .navigationDestination(for: Item.self) { item in
+                ItemDetailView(item: item)
+            }
+        }
+    }
+}
+```
+
+### Programmatic Navigation
+
+```swift
+struct ProgrammaticNavigationView: View {
+    @State private var path = NavigationPath()
+
+    var body: some View {
+        NavigationStack(path: $path) {
+            VStack(spacing: 20) {
+                Button("Go to Settings") {
+                    path.append(Destination.settings)
+                }
+
+                Button("Go to Profile") {
+                    path.append(Destination.profile)
+                }
+
+                Button("Deep Link to Item 123") {
+                    path.append(Destination.settings)
+                    path.append(Destination.itemDetail(id: 123))
+                }
+            }
+            .navigationTitle("Home")
+            .navigationDestination(for: Destination.self) { destination in
+                switch destination {
+                case .settings:
+                    SettingsView()
+                case .profile:
+                    ProfileView()
+                case .itemDetail(let id):
+                    ItemDetailView(itemId: id)
+                }
+            }
+        }
+    }
+
+    enum Destination: Hashable {
+        case settings
+        case profile
+        case itemDetail(id: Int)
+    }
+}
+```
+
+### Navigation State Persistence
+
+```swift
+struct PersistentNavigationView: View {
+    @SceneStorage("navigationPath") private var pathData: Data?
+    @State private var path = NavigationPath()
+
+    var body: some View {
+        NavigationStack(path: $path) {
+            ContentView()
+                .navigationDestination(for: Item.self) { item in
+                    ItemDetailView(item: item)
+                }
+        }
+        .onAppear {
+            restorePath()
+        }
+        .onChange(of: path) { _, newPath in
+            savePath(newPath)
+        }
+    }
+
+    private func savePath(_ path: NavigationPath) {
+        guard let representation = path.codable else { return }
+        pathData = try? JSONEncoder().encode(representation)
+    }
+
+    private func restorePath() {
+        guard let data = pathData,
+              let representation = try? JSONDecoder().decode(
+                NavigationPath.CodableRepresentation.self,
+                from: data
+              ) else { return }
+        path = NavigationPath(representation)
+    }
+}
+```
+
+## NavigationSplitView
+
+### Two-Column Layout
+
+```swift
+struct TwoColumnView: View {
+    @State private var selectedCategory: Category?
+    @State private var columnVisibility: NavigationSplitViewVisibility = .all
+
+    var body: some View {
+        NavigationSplitView(columnVisibility: $columnVisibility) {
+            // Sidebar
+            List(categories, selection: $selectedCategory) { category in
+                NavigationLink(value: category) {
+                    Label(category.name, systemImage: category.icon)
+                }
+            }
+            .navigationTitle("Categories")
+        } detail: {
+            // Detail
+            if let category = selectedCategory {
+                CategoryDetailView(category: category)
+            } else {
+                ContentUnavailableView(
+                    "Select a Category",
+                    systemImage: "sidebar.leading"
+                )
+            }
+        }
+        .navigationSplitViewStyle(.balanced)
+    }
+}
+```
+
+### Three-Column Layout
+
+```swift
+struct ThreeColumnView: View {
+    @State private var selectedFolder: Folder?
+    @State private var selectedDocument: Document?
+
+    var body: some View {
+        NavigationSplitView {
+            // Sidebar
+            List(folders, selection: $selectedFolder) { folder in
+                NavigationLink(value: folder) {
+                    Label(folder.name, systemImage: "folder")
+                }
+            }
+            .navigationTitle("Folders")
+        } content: {
+            // Content column
+            if let folder = selectedFolder {
+                List(folder.documents, selection: $selectedDocument) { document in
+                    NavigationLink(value: document) {
+                        DocumentRow(document: document)
+                    }
+                }
+                .navigationTitle(folder.name)
+            } else {
+                Text("Select a folder")
+            }
+        } detail: {
+            // Detail column
+            if let document = selectedDocument {
+                DocumentDetailView(document: document)
+            } else {
+                ContentUnavailableView(
+                    "Select a Document",
+                    systemImage: "doc"
+                )
+            }
+        }
+    }
+}
+```
+
+## Sheet Navigation
+
+### Modal Sheets
+
+```swift
+struct SheetNavigationView: View {
+    @State private var showSettings = false
+    @State private var showNewItem = false
+    @State private var editingItem: Item?
+
+    var body: some View {
+        NavigationStack {
+            ContentView()
+                .toolbar {
+                    ToolbarItem(placement: .primaryAction) {
+                        Button("Add", systemImage: "plus") {
+                            showNewItem = true
+                        }
+                    }
+                    ToolbarItem(placement: .topBarLeading) {
+                        Button("Settings", systemImage: "gear") {
+                            showSettings = true
+                        }
+                    }
+                }
+        }
+        // Boolean-based sheet
+        .sheet(isPresented: $showSettings) {
+            SettingsSheet()
+        }
+        // Boolean-based fullscreen cover
+        .fullScreenCover(isPresented: $showNewItem) {
+            NewItemView()
+        }
+        // Item-based sheet
+        .sheet(item: $editingItem) { item in
+            EditItemSheet(item: item)
+        }
+    }
+}
+```
+
+### Sheet with Navigation
+
+```swift
+struct NavigableSheet: View {
+    @Environment(\.dismiss) private var dismiss
+
+    var body: some View {
+        NavigationStack {
+            Form {
+                Section("General") {
+                    NavigationLink("Account") {
+                        AccountSettingsView()
+                    }
+                    NavigationLink("Notifications") {
+                        NotificationSettingsView()
+                    }
+                }
+
+                Section("Advanced") {
+                    NavigationLink("Privacy") {
+                        PrivacySettingsView()
+                    }
+                }
+            }
+            .navigationTitle("Settings")
+            .toolbar {
+                ToolbarItem(placement: .confirmationAction) {
+                    Button("Done") {
+                        dismiss()
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+### Sheet Customization
+
+```swift
+struct CustomSheetView: View {
+    @State private var showSheet = false
+
+    var body: some View {
+        Button("Show Sheet") {
+            showSheet = true
+        }
+        .sheet(isPresented: $showSheet) {
+            SheetContent()
+                // Available detents
+                .presentationDetents([
+                    .medium,
+                    .large,
+                    .height(200),
+                    .fraction(0.75)
+                ])
+                // Selected detent binding
+                .presentationDetents([.medium, .large], selection: $selectedDetent)
+                // Drag indicator visibility
+                .presentationDragIndicator(.visible)
+                // Corner radius
+                .presentationCornerRadius(24)
+                // Background interaction
+                .presentationBackgroundInteraction(.enabled(upThrough: .medium))
+                // Prevent interactive dismiss
+                .interactiveDismissDisabled(hasUnsavedChanges)
+        }
+    }
+}
+```
+
+## Tab Navigation
+
+### Basic TabView
+
+```swift
+struct MainTabView: View {
+    @State private var selectedTab = 0
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            HomeView()
+                .tabItem {
+                    Label("Home", systemImage: "house")
+                }
+                .tag(0)
+
+            SearchView()
+                .tabItem {
+                    Label("Search", systemImage: "magnifyingglass")
+                }
+                .tag(1)
+
+            ProfileView()
+                .tabItem {
+                    Label("Profile", systemImage: "person")
+                }
+                .tag(2)
+                .badge(unreadCount)
+        }
+    }
+}
+```
+
+### Tab with Custom Badge
+
+```swift
+struct BadgedTabView: View {
+    @State private var selectedTab: Tab = .home
+    @State private var cartCount = 3
+
+    enum Tab: String, CaseIterable {
+        case home, search, cart, profile
+
+        var icon: String {
+            switch self {
+            case .home: return "house"
+            case .search: return "magnifyingglass"
+            case .cart: return "cart"
+            case .profile: return "person"
+            }
+        }
+    }
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            ForEach(Tab.allCases, id: \.self) { tab in
+                NavigationStack {
+                    contentView(for: tab)
+                }
+                .tabItem {
+                    Label(tab.rawValue.capitalized, systemImage: tab.icon)
+                }
+                .tag(tab)
+                .badge(tab == .cart ? cartCount : 0)
+            }
+        }
+    }
+}
+```
+
+## Deep Linking
+
+### URL-Based Navigation
+
+```swift
+struct DeepLinkableApp: App {
+    @StateObject private var router = NavigationRouter()
+
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+                .environmentObject(router)
+                .onOpenURL { url in
+                    router.handle(url: url)
+                }
+        }
+    }
+}
+
+class NavigationRouter: ObservableObject {
+    @Published var path = NavigationPath()
+    @Published var selectedTab: Tab = .home
+
+    func handle(url: URL) {
+        guard url.scheme == "myapp" else { return }
+
+        switch url.host {
+        case "item":
+            if let id = Int(url.lastPathComponent) {
+                selectedTab = .home
+                path = NavigationPath()
+                path.append(Destination.itemDetail(id: id))
+            }
+        case "settings":
+            selectedTab = .profile
+            path = NavigationPath()
+            path.append(Destination.settings)
+        default:
+            break
+        }
+    }
+}
+```
+
+### Universal Links
+
+```swift
+struct UniversalLinkHandler: View {
+    @EnvironmentObject private var router: NavigationRouter
+
+    var body: some View {
+        ContentView()
+            .onContinueUserActivity(NSUserActivityTypeBrowsingWeb) { activity in
+                guard let url = activity.webpageURL else { return }
+                handleUniversalLink(url)
+            }
+    }
+
+    private func handleUniversalLink(_ url: URL) {
+        // Parse URL path and navigate accordingly
+        let pathComponents = url.pathComponents
+
+        if pathComponents.contains("product"),
+           let idString = pathComponents.last,
+           let id = Int(idString) {
+            router.navigate(to: .product(id: id))
+        }
+    }
+}
+```
+
+## Navigation Coordinator Pattern
+
+```swift
+@MainActor
+class NavigationCoordinator: ObservableObject {
+    @Published var path = NavigationPath()
+    @Published var sheet: Sheet?
+    @Published var fullScreenCover: FullScreenCover?
+
+    enum Sheet: Identifiable {
+        case settings
+        case newItem
+        case editItem(Item)
+
+        var id: String {
+            switch self {
+            case .settings: return "settings"
+            case .newItem: return "newItem"
+            case .editItem(let item): return "editItem-\(item.id)"
+            }
+        }
+    }
+
+    enum FullScreenCover: Identifiable {
+        case onboarding
+        case camera
+
+        var id: String {
+            switch self {
+            case .onboarding: return "onboarding"
+            case .camera: return "camera"
+            }
+        }
+    }
+
+    func push(_ destination: Destination) {
+        path.append(destination)
+    }
+
+    func pop() {
+        guard !path.isEmpty else { return }
+        path.removeLast()
+    }
+
+    func popToRoot() {
+        path = NavigationPath()
+    }
+
+    func present(_ sheet: Sheet) {
+        self.sheet = sheet
+    }
+
+    func presentFullScreen(_ cover: FullScreenCover) {
+        self.fullScreenCover = cover
+    }
+
+    func dismiss() {
+        if fullScreenCover != nil {
+            fullScreenCover = nil
+        } else if sheet != nil {
+            sheet = nil
+        }
+    }
+}
+```
+
+## Navigation Transitions (iOS 18+)
+
+### Custom Navigation Transitions
+
+```swift
+struct CustomTransitionView: View {
+    @Namespace private var namespace
+
+    var body: some View {
+        NavigationStack {
+            List(items) { item in
+                NavigationLink(value: item) {
+                    ItemRow(item: item)
+                        .matchedTransitionSource(id: item.id, in: namespace)
+                }
+            }
+            .navigationDestination(for: Item.self) { item in
+                ItemDetailView(item: item)
+                    .navigationTransition(.zoom(sourceID: item.id, in: namespace))
+            }
+        }
+    }
+}
+```
+
+### Hero Transitions
+
+```swift
+struct HeroTransitionView: View {
+    @Namespace private var animation
+    @State private var selectedItem: Item?
+
+    var body: some View {
+        ZStack {
+            ScrollView {
+                LazyVGrid(columns: columns) {
+                    ForEach(items) { item in
+                        if selectedItem?.id != item.id {
+                            ItemCard(item: item)
+                                .matchedGeometryEffect(id: item.id, in: animation)
+                                .onTapGesture {
+                                    withAnimation(.spring(response: 0.3)) {
+                                        selectedItem = item
+                                    }
+                                }
+                        }
+                    }
+                }
+            }
+
+            if let item = selectedItem {
+                ItemDetailView(item: item)
+                    .matchedGeometryEffect(id: item.id, in: animation)
+                    .onTapGesture {
+                        withAnimation(.spring(response: 0.3)) {
+                            selectedItem = nil
+                        }
+                    }
+            }
+        }
+    }
+}
+```
diff --git a/.agents/skills/mobile-ios-design/references/swiftui-components.md b/.agents/skills/mobile-ios-design/references/swiftui-components.md
new file mode 100644
index 0000000..43553a3
--- /dev/null
+++ b/.agents/skills/mobile-ios-design/references/swiftui-components.md
@@ -0,0 +1,575 @@
+# SwiftUI Component Library
+
+## Lists and Collections
+
+### Basic List
+
+```swift
+struct ItemListView: View {
+    @State private var items: [Item] = []
+
+    var body: some View {
+        List {
+            ForEach(items) { item in
+                ItemRow(item: item)
+            }
+            .onDelete(perform: deleteItems)
+            .onMove(perform: moveItems)
+        }
+        .listStyle(.insetGrouped)
+        .refreshable {
+            await loadItems()
+        }
+    }
+
+    private func deleteItems(at offsets: IndexSet) {
+        items.remove(atOffsets: offsets)
+    }
+
+    private func moveItems(from source: IndexSet, to destination: Int) {
+        items.move(fromOffsets: source, toOffset: destination)
+    }
+}
+```
+
+### Sectioned List
+
+```swift
+struct SectionedListView: View {
+    let groupedItems: [String: [Item]]
+
+    var body: some View {
+        List {
+            ForEach(groupedItems.keys.sorted(), id: \.self) { key in
+                Section(header: Text(key)) {
+                    ForEach(groupedItems[key] ?? []) { item in
+                        ItemRow(item: item)
+                    }
+                }
+            }
+        }
+        .listStyle(.sidebar)
+    }
+}
+```
+
+### Search Integration
+
+```swift
+struct SearchableListView: View {
+    @State private var searchText = ""
+    @State private var items: [Item] = []
+
+    var filteredItems: [Item] {
+        if searchText.isEmpty {
+            return items
+        }
+        return items.filter { $0.name.localizedCaseInsensitiveContains(searchText) }
+    }
+
+    var body: some View {
+        NavigationStack {
+            List(filteredItems) { item in
+                ItemRow(item: item)
+            }
+            .searchable(text: $searchText, prompt: "Search items")
+            .searchSuggestions {
+                ForEach(searchSuggestions, id: \.self) { suggestion in
+                    Text(suggestion)
+                        .searchCompletion(suggestion)
+                }
+            }
+            .navigationTitle("Items")
+        }
+    }
+}
+```
+
+## Forms and Input
+
+### Settings Form
+
+```swift
+struct SettingsView: View {
+    @AppStorage("notifications") private var notificationsEnabled = true
+    @AppStorage("soundEnabled") private var soundEnabled = true
+    @State private var selectedTheme = Theme.system
+    @State private var username = ""
+
+    var body: some View {
+        Form {
+            Section("Account") {
+                TextField("Username", text: $username)
+                    .textContentType(.username)
+                    .autocorrectionDisabled()
+            }
+
+            Section("Preferences") {
+                Toggle("Enable Notifications", isOn: $notificationsEnabled)
+                Toggle("Sound Effects", isOn: $soundEnabled)
+
+                Picker("Theme", selection: $selectedTheme) {
+                    ForEach(Theme.allCases) { theme in
+                        Text(theme.rawValue).tag(theme)
+                    }
+                }
+            }
+
+            Section("About") {
+                LabeledContent("Version", value: "1.0.0")
+
+                Link(destination: URL(string: "https://example.com/privacy")!) {
+                    Text("Privacy Policy")
+                }
+            }
+        }
+        .navigationTitle("Settings")
+    }
+}
+```
+
+### Custom Input Fields
+
+```swift
+struct ValidatedTextField: View {
+    let title: String
+    @Binding var text: String
+    let validation: (String) -> Bool
+
+    @State private var isValid = true
+    @FocusState private var isFocused: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 4) {
+            Text(title)
+                .font(.caption)
+                .foregroundStyle(.secondary)
+
+            TextField(title, text: $text)
+                .textFieldStyle(.roundedBorder)
+                .focused($isFocused)
+                .overlay(
+                    RoundedRectangle(cornerRadius: 8)
+                        .stroke(borderColor, lineWidth: 1)
+                )
+                .onChange(of: text) { _, newValue in
+                    isValid = validation(newValue)
+                }
+
+            if !isValid && !text.isEmpty {
+                Text("Invalid input")
+                    .font(.caption)
+                    .foregroundStyle(.red)
+            }
+        }
+    }
+
+    private var borderColor: Color {
+        if isFocused {
+            return isValid ? .blue : .red
+        }
+        return .clear
+    }
+}
+```
+
+## Buttons and Actions
+
+### Button Styles
+
+```swift
+// Primary filled button
+Button("Continue") {
+    // action
+}
+.buttonStyle(.borderedProminent)
+.controlSize(.large)
+
+// Secondary button
+Button("Cancel") {
+    // action
+}
+.buttonStyle(.bordered)
+
+// Destructive button
+Button("Delete", role: .destructive) {
+    // action
+}
+.buttonStyle(.bordered)
+
+// Custom button style
+struct ScaleButtonStyle: ButtonStyle {
+    func makeBody(configuration: Configuration) -> some View {
+        configuration.label
+            .scaleEffect(configuration.isPressed ? 0.95 : 1.0)
+            .animation(.easeInOut(duration: 0.1), value: configuration.isPressed)
+    }
+}
+```
+
+### Menu and Context Menu
+
+```swift
+// Menu button
+Menu {
+    Button("Edit", systemImage: "pencil") { }
+    Button("Duplicate", systemImage: "doc.on.doc") { }
+    Divider()
+    Button("Delete", systemImage: "trash", role: .destructive) { }
+} label: {
+    Image(systemName: "ellipsis.circle")
+}
+
+// Context menu on any view
+Text("Long press me")
+    .contextMenu {
+        Button("Copy", systemImage: "doc.on.doc") { }
+        Button("Share", systemImage: "square.and.arrow.up") { }
+    } preview: {
+        ItemPreviewView()
+    }
+```
+
+## Sheets and Modals
+
+### Sheet Presentation
+
+```swift
+struct ParentView: View {
+    @State private var showSettings = false
+    @State private var selectedItem: Item?
+
+    var body: some View {
+        VStack {
+            Button("Settings") {
+                showSettings = true
+            }
+        }
+        .sheet(isPresented: $showSettings) {
+            SettingsSheet()
+                .presentationDetents([.medium, .large])
+                .presentationDragIndicator(.visible)
+        }
+        .sheet(item: $selectedItem) { item in
+            ItemDetailSheet(item: item)
+                .presentationDetents([.height(300), .large])
+                .presentationCornerRadius(24)
+        }
+    }
+}
+
+struct SettingsSheet: View {
+    @Environment(\.dismiss) private var dismiss
+
+    var body: some View {
+        NavigationStack {
+            SettingsContent()
+                .toolbar {
+                    ToolbarItem(placement: .confirmationAction) {
+                        Button("Done") {
+                            dismiss()
+                        }
+                    }
+                }
+        }
+    }
+}
+```
+
+### Confirmation Dialog
+
+```swift
+struct DeleteConfirmationView: View {
+    @State private var showConfirmation = false
+
+    var body: some View {
+        Button("Delete Account", role: .destructive) {
+            showConfirmation = true
+        }
+        .confirmationDialog(
+            "Delete Account",
+            isPresented: $showConfirmation,
+            titleVisibility: .visible
+        ) {
+            Button("Delete", role: .destructive) {
+                deleteAccount()
+            }
+            Button("Cancel", role: .cancel) { }
+        } message: {
+            Text("This action cannot be undone.")
+        }
+    }
+}
+```
+
+## Loading and Progress
+
+### Progress Indicators
+
+```swift
+// Indeterminate spinner
+ProgressView()
+    .progressViewStyle(.circular)
+
+// Determinate progress
+ProgressView(value: downloadProgress, total: 1.0) {
+    Text("Downloading...")
+} currentValueLabel: {
+    Text("\(Int(downloadProgress * 100))%")
+}
+
+// Custom loading view
+struct LoadingOverlay: View {
+    let message: String
+
+    var body: some View {
+        ZStack {
+            Color.black.opacity(0.4)
+                .ignoresSafeArea()
+
+            VStack(spacing: 16) {
+                ProgressView()
+                    .scaleEffect(1.5)
+                    .tint(.white)
+
+                Text(message)
+                    .font(.subheadline)
+                    .foregroundStyle(.white)
+            }
+            .padding(24)
+            .background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
+        }
+    }
+}
+```
+
+### Skeleton Loading
+
+```swift
+struct SkeletonRow: View {
+    @State private var isAnimating = false
+
+    var body: some View {
+        HStack(spacing: 12) {
+            Circle()
+                .fill(.gray.opacity(0.3))
+                .frame(width: 44, height: 44)
+
+            VStack(alignment: .leading, spacing: 8) {
+                RoundedRectangle(cornerRadius: 4)
+                    .fill(.gray.opacity(0.3))
+                    .frame(height: 14)
+                    .frame(maxWidth: 200)
+
+                RoundedRectangle(cornerRadius: 4)
+                    .fill(.gray.opacity(0.2))
+                    .frame(height: 12)
+                    .frame(maxWidth: 150)
+            }
+        }
+        .opacity(isAnimating ? 0.5 : 1.0)
+        .animation(.easeInOut(duration: 0.8).repeatForever(), value: isAnimating)
+        .onAppear { isAnimating = true }
+    }
+}
+```
+
+## Async Content Loading
+
+### AsyncImage
+
+```swift
+AsyncImage(url: imageURL) { phase in
+    switch phase {
+    case .empty:
+        ProgressView()
+    case .success(let image):
+        image
+            .resizable()
+            .aspectRatio(contentMode: .fill)
+    case .failure:
+        Image(systemName: "photo")
+            .foregroundStyle(.secondary)
+    @unknown default:
+        EmptyView()
+    }
+}
+.frame(width: 100, height: 100)
+.clipShape(RoundedRectangle(cornerRadius: 8))
+```
+
+### Task-Based Loading
+
+```swift
+struct AsyncContentView: View {
+    @State private var items: [Item] = []
+    @State private var isLoading = true
+    @State private var error: Error?
+
+    var body: some View {
+        Group {
+            if isLoading {
+                ProgressView("Loading...")
+            } else if let error {
+                ContentUnavailableView(
+                    "Failed to Load",
+                    systemImage: "exclamationmark.triangle",
+                    description: Text(error.localizedDescription)
+                )
+            } else if items.isEmpty {
+                ContentUnavailableView(
+                    "No Items",
+                    systemImage: "tray",
+                    description: Text("Add your first item to get started.")
+                )
+            } else {
+                List(items) { item in
+                    ItemRow(item: item)
+                }
+            }
+        }
+        .task {
+            await loadItems()
+        }
+    }
+
+    private func loadItems() async {
+        do {
+            items = try await api.fetchItems()
+            isLoading = false
+        } catch {
+            self.error = error
+            isLoading = false
+        }
+    }
+}
+```
+
+## Animations
+
+### Implicit Animations
+
+```swift
+struct AnimatedCard: View {
+    @State private var isExpanded = false
+
+    var body: some View {
+        VStack {
+            Text("Tap to expand")
+
+            if isExpanded {
+                Text("Additional content here")
+                    .transition(.move(edge: .top).combined(with: .opacity))
+            }
+        }
+        .padding()
+        .frame(maxWidth: .infinity)
+        .background(.blue.opacity(0.1), in: RoundedRectangle(cornerRadius: 12))
+        .onTapGesture {
+            withAnimation(.spring(response: 0.3, dampingFraction: 0.7)) {
+                isExpanded.toggle()
+            }
+        }
+    }
+}
+```
+
+### Custom Transitions
+
+```swift
+extension AnyTransition {
+    static var slideAndFade: AnyTransition {
+        .asymmetric(
+            insertion: .move(edge: .trailing).combined(with: .opacity),
+            removal: .move(edge: .leading).combined(with: .opacity)
+        )
+    }
+
+    static var scaleAndFade: AnyTransition {
+        .scale(scale: 0.8).combined(with: .opacity)
+    }
+}
+```
+
+### Phase Animator (iOS 17+)
+
+```swift
+struct PulsingButton: View {
+    var body: some View {
+        Button("Tap Me") { }
+            .buttonStyle(.borderedProminent)
+            .phaseAnimator([false, true]) { content, phase in
+                content
+                    .scaleEffect(phase ? 1.05 : 1.0)
+            } animation: { _ in
+                .easeInOut(duration: 0.5)
+            }
+    }
+}
+```
+
+## Gestures
+
+### Drag Gesture
+
+```swift
+struct DraggableCard: View {
+    @State private var offset = CGSize.zero
+    @State private var isDragging = false
+
+    var body: some View {
+        RoundedRectangle(cornerRadius: 16)
+            .fill(.blue)
+            .frame(width: 200, height: 150)
+            .offset(offset)
+            .scaleEffect(isDragging ? 1.05 : 1.0)
+            .gesture(
+                DragGesture()
+                    .onChanged { value in
+                        offset = value.translation
+                        isDragging = true
+                    }
+                    .onEnded { _ in
+                        withAnimation(.spring()) {
+                            offset = .zero
+                            isDragging = false
+                        }
+                    }
+            )
+    }
+}
+```
+
+### Simultaneous Gestures
+
+```swift
+struct ZoomableImage: View {
+    @State private var scale: CGFloat = 1.0
+    @State private var lastScale: CGFloat = 1.0
+
+    var body: some View {
+        Image("photo")
+            .resizable()
+            .aspectRatio(contentMode: .fit)
+            .scaleEffect(scale)
+            .gesture(
+                MagnificationGesture()
+                    .onChanged { value in
+                        scale = lastScale * value
+                    }
+                    .onEnded { _ in
+                        lastScale = scale
+                    }
+            )
+            .gesture(
+                TapGesture(count: 2)
+                    .onEnded {
+                        withAnimation {
+                            scale = 1.0
+                            lastScale = 1.0
+                        }
+                    }
+            )
+    }
+}
+```
diff --git a/.agents/skills/mobile-offline-support/SKILL.md b/.agents/skills/mobile-offline-support/SKILL.md
new file mode 100644
index 0000000..0074c06
--- /dev/null
+++ b/.agents/skills/mobile-offline-support/SKILL.md
@@ -0,0 +1,466 @@
+---
+name: mobile-offline-support
+description: Implement offline-first mobile apps with local storage, sync strategies, and conflict resolution. Covers AsyncStorage, Realm, SQLite, and background sync patterns.
+---
+
+# Mobile Offline Support
+
+## Overview
+
+Design offline-first mobile applications that provide seamless user experience regardless of connectivity.
+
+## When to Use
+
+- Building apps that work without internet connection
+- Implementing seamless sync when connectivity returns
+- Handling data conflicts between device and server
+- Reducing server load with intelligent caching
+- Improving app responsiveness with local storage
+
+## Instructions
+
+### 1. **React Native Offline Storage**
+
+```javascript
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import NetInfo from '@react-native-community/netinfo';
+
+class StorageManager {
+  static async saveItems(items) {
+    try {
+      await AsyncStorage.setItem(
+        'items_cache',
+        JSON.stringify({ data: items, timestamp: Date.now() })
+      );
+    } catch (error) {
+      console.error('Failed to save items:', error);
+    }
+  }
+
+  static async getItems() {
+    try {
+      const data = await AsyncStorage.getItem('items_cache');
+      return data ? JSON.parse(data) : null;
+    } catch (error) {
+      console.error('Failed to retrieve items:', error);
+      return null;
+    }
+  }
+
+  static async queueAction(action) {
+    try {
+      const queue = await AsyncStorage.getItem('action_queue');
+      const actions = queue ? JSON.parse(queue) : [];
+      actions.push({ ...action, id: Date.now(), attempts: 0 });
+      await AsyncStorage.setItem('action_queue', JSON.stringify(actions));
+    } catch (error) {
+      console.error('Failed to queue action:', error);
+    }
+  }
+
+  static async getActionQueue() {
+    try {
+      const queue = await AsyncStorage.getItem('action_queue');
+      return queue ? JSON.parse(queue) : [];
+    } catch (error) {
+      return [];
+    }
+  }
+
+  static async removeFromQueue(actionId) {
+    try {
+      const queue = await AsyncStorage.getItem('action_queue');
+      const actions = queue ? JSON.parse(queue) : [];
+      const filtered = actions.filter(a => a.id !== actionId);
+      await AsyncStorage.setItem('action_queue', JSON.stringify(filtered));
+    } catch (error) {
+      console.error('Failed to remove from queue:', error);
+    }
+  }
+}
+
+class OfflineAPIService {
+  async fetchItems() {
+    const isOnline = await this.checkConnectivity();
+
+    if (isOnline) {
+      try {
+        const response = await fetch('https://api.example.com/items');
+        const items = await response.json();
+        await StorageManager.saveItems(items);
+        return items;
+      } catch (error) {
+        const cached = await StorageManager.getItems();
+        return cached?.data || [];
+      }
+    } else {
+      const cached = await StorageManager.getItems();
+      return cached?.data || [];
+    }
+  }
+
+  async createItem(item) {
+    const isOnline = await this.checkConnectivity();
+
+    if (isOnline) {
+      try {
+        const response = await fetch('https://api.example.com/items', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(item)
+        });
+        const created = await response.json();
+        return { success: true, data: created };
+      } catch (error) {
+        await StorageManager.queueAction({
+          type: 'CREATE_ITEM',
+          payload: item
+        });
+        return { success: false, queued: true };
+      }
+    } else {
+      await StorageManager.queueAction({
+        type: 'CREATE_ITEM',
+        payload: item
+      });
+      return { success: false, queued: true };
+    }
+  }
+
+  async syncQueue() {
+    const queue = await StorageManager.getActionQueue();
+
+    for (const action of queue) {
+      try {
+        await this.executeAction(action);
+        await StorageManager.removeFromQueue(action.id);
+      } catch (error) {
+        action.attempts = (action.attempts || 0) + 1;
+        if (action.attempts > 3) {
+          await StorageManager.removeFromQueue(action.id);
+        }
+      }
+    }
+  }
+
+  private async executeAction(action) {
+    switch (action.type) {
+      case 'CREATE_ITEM':
+        return fetch('https://api.example.com/items', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(action.payload)
+        });
+      default:
+        return Promise.reject(new Error('Unknown action type'));
+    }
+  }
+
+  async checkConnectivity() {
+    const state = await NetInfo.fetch();
+    return state.isConnected ?? false;
+  }
+}
+
+export function OfflineListScreen() {
+  const [items, setItems] = useState([]);
+  const [isOnline, setIsOnline] = useState(true);
+  const [syncing, setSyncing] = useState(false);
+  const apiService = new OfflineAPIService();
+
+  useFocusEffect(
+    useCallback(() => {
+      loadItems();
+      const unsubscribe = NetInfo.addEventListener(state => {
+        setIsOnline(state.isConnected ?? false);
+        if (state.isConnected) {
+          syncQueue();
+        }
+      });
+
+      return unsubscribe;
+    }, [])
+  );
+
+  const loadItems = async () => {
+    const items = await apiService.fetchItems();
+    setItems(items);
+  };
+
+  const syncQueue = async () => {
+    setSyncing(true);
+    await apiService.syncQueue();
+    await loadItems();
+    setSyncing(false);
+  };
+
+  return (
+    <View style={styles.container}>
+      {!isOnline && <Text style={styles.offline}>Offline Mode</Text>}
+      {syncing && <ActivityIndicator size="large" />}
+      <FlatList
+        data={items}
+        renderItem={({ item }) => <ItemCard item={item} />}
+        keyExtractor={item => item.id}
+      />
+    </View>
+  );
+}
+```
+
+### 2. **iOS Core Data Implementation**
+
+```swift
+import CoreData
+
+class PersistenceController {
+  static let shared = PersistenceController()
+
+  let container: NSPersistentContainer
+
+  init(inMemory: Bool = false) {
+    container = NSPersistentContainer(name: "MyApp")
+
+    if inMemory {
+      container.persistentStoreDescriptions.first?.url = URL(fileURLWithPath: "/dev/null")
+    }
+
+    container.loadPersistentStores { _, error in
+      if let error = error as NSError? {
+        print("Core Data load error: \(error)")
+      }
+    }
+
+    container.viewContext.automaticallyMergesChangesFromParent = true
+  }
+
+  func save(_ context: NSManagedObjectContext = PersistenceController.shared.container.viewContext) {
+    if context.hasChanges {
+      do {
+        try context.save()
+      } catch {
+        print("Save error: \(error)")
+      }
+    }
+  }
+}
+
+// Core Data Models
+@NSManaged class ItemEntity: NSManagedObject {
+  @NSManaged var id: String
+  @NSManaged var title: String
+  @NSManaged var description: String?
+  @NSManaged var isSynced: Bool
+}
+
+@NSManaged class ActionQueueEntity: NSManagedObject {
+  @NSManaged var id: UUID
+  @NSManaged var type: String
+  @NSManaged var payload: Data?
+  @NSManaged var createdAt: Date
+}
+
+class OfflineSyncManager: NSObject, ObservableObject {
+  @Published var isOnline = true
+  @Published var isSyncing = false
+
+  private let networkMonitor = NWPathMonitor()
+  private let persistenceController = PersistenceController.shared
+
+  override init() {
+    super.init()
+    setupNetworkMonitoring()
+  }
+
+  private func setupNetworkMonitoring() {
+    networkMonitor.pathUpdateHandler = { [weak self] path in
+      DispatchQueue.main.async {
+        self?.isOnline = path.status == .satisfied
+        if path.status == .satisfied {
+          self?.syncWithServer()
+        }
+      }
+    }
+
+    let queue = DispatchQueue(label: "NetworkMonitor")
+    networkMonitor.start(queue: queue)
+  }
+
+  func saveItem(_ item: Item) {
+    let context = persistenceController.container.viewContext
+    let entity = ItemEntity(context: context)
+    entity.id = item.id
+    entity.title = item.title
+    entity.isSynced = false
+
+    persistenceController.save(context)
+
+    if isOnline {
+      syncItem(item)
+    }
+  }
+
+  func syncWithServer() {
+    isSyncing = true
+    let context = persistenceController.container.viewContext
+    let request: NSFetchRequest<ActionQueueEntity> = ActionQueueEntity.fetchRequest()
+
+    do {
+      let pendingActions = try context.fetch(request)
+      for action in pendingActions {
+        context.delete(action)
+      }
+      persistenceController.save(context)
+    } catch {
+      print("Sync error: \(error)")
+    }
+
+    isSyncing = false
+  }
+}
+```
+
+### 3. **Android Room Database**
+
+```kotlin
+@Entity(tableName = "items")
+data class ItemEntity(
+  @PrimaryKey val id: String,
+  val title: String,
+  val description: String?,
+  val isSynced: Boolean = false
+)
+
+@Entity(tableName = "action_queue")
+data class ActionQueueEntity(
+  @PrimaryKey val id: Long = System.currentTimeMillis(),
+  val type: String,
+  val payload: String,
+  val createdAt: Long = System.currentTimeMillis()
+)
+
+@Dao
+interface ItemDao {
+  @Insert(onConflict = OnConflictStrategy.REPLACE)
+  suspend fun insertItem(item: ItemEntity)
+
+  @Query("SELECT * FROM items")
+  fun getAllItems(): Flow<List<ItemEntity>>
+
+  @Update
+  suspend fun updateItem(item: ItemEntity)
+}
+
+@Dao
+interface ActionQueueDao {
+  @Insert
+  suspend fun insertAction(action: ActionQueueEntity)
+
+  @Query("SELECT * FROM action_queue ORDER BY createdAt ASC")
+  suspend fun getAllActions(): List<ActionQueueEntity>
+
+  @Delete
+  suspend fun deleteAction(action: ActionQueueEntity)
+}
+
+@Database(entities = [ItemEntity::class, ActionQueueEntity::class], version = 1)
+abstract class AppDatabase : RoomDatabase() {
+  abstract fun itemDao(): ItemDao
+  abstract fun actionQueueDao(): ActionQueueDao
+}
+
+@HiltViewModel
+class OfflineItemsViewModel @Inject constructor(
+  private val itemDao: ItemDao,
+  private val actionQueueDao: ActionQueueDao,
+  private val connectivityManager: ConnectivityManager
+) : ViewModel() {
+  private val _items = MutableStateFlow<List<Item>>(emptyList())
+  val items: StateFlow<List<Item>> = _items.asStateFlow()
+
+  init {
+    viewModelScope.launch {
+      itemDao.getAllItems().collect { entities ->
+        _items.value = entities.map { it.toItem() }
+      }
+    }
+    observeNetworkConnectivity()
+  }
+
+  fun saveItem(item: Item) {
+    viewModelScope.launch {
+      val entity = item.toEntity()
+      itemDao.insertItem(entity)
+
+      if (isNetworkAvailable()) {
+        syncItem(item)
+      } else {
+        actionQueueDao.insertAction(
+          ActionQueueEntity(
+            type = "CREATE_ITEM",
+            payload = Json.encodeToString(item)
+          )
+        )
+      }
+    }
+  }
+
+  private fun observeNetworkConnectivity() {
+    val networkRequest = NetworkRequest.Builder()
+      .addCapability(NET_CAPABILITY_INTERNET)
+      .build()
+
+    connectivityManager.registerNetworkCallback(
+      networkRequest,
+      object : ConnectivityManager.NetworkCallback() {
+        override fun onAvailable(network: Network) {
+          viewModelScope.launch { syncQueue() }
+        }
+      }
+    )
+  }
+
+  private suspend fun syncQueue() {
+    val queue = actionQueueDao.getAllActions()
+    for (action in queue) {
+      try {
+        actionQueueDao.deleteAction(action)
+      } catch (e: Exception) {
+        println("Sync error: ${e.message}")
+      }
+    }
+  }
+
+  private fun isNetworkAvailable(): Boolean {
+    val activeNetwork = connectivityManager.activeNetwork ?: return false
+    val capabilities = connectivityManager.getNetworkCapabilities(activeNetwork) ?: return false
+    return capabilities.hasCapability(NET_CAPABILITY_INTERNET)
+  }
+}
+```
+
+## Best Practices
+
+### ✅ DO
+- Implement robust local storage
+- Use automatic sync when online
+- Provide visual feedback for offline status
+- Queue actions for later sync
+- Handle conflicts gracefully
+- Cache frequently accessed data
+- Implement proper error recovery
+- Test offline scenarios thoroughly
+- Use compression for large data
+- Monitor storage usage
+
+### ❌ DON'T
+- Assume constant connectivity
+- Sync large files frequently
+- Ignore storage limitations
+- Force unnecessary syncing
+- Lose data on offline mode
+- Store sensitive data unencrypted
+- Accumulate infinite queue items
+- Ignore sync failures silently
+- Sync in tight loops
+- Deploy without offline testing
diff --git a/.agents/skills/mobile-security-coder/SKILL.md b/.agents/skills/mobile-security-coder/SKILL.md
new file mode 100644
index 0000000..c7bda47
--- /dev/null
+++ b/.agents/skills/mobile-security-coder/SKILL.md
@@ -0,0 +1,184 @@
+---
+name: mobile-security-coder
+description: Expert in secure mobile coding practices specializing in input
+  validation, WebView security, and mobile-specific security patterns. Use
+  PROACTIVELY for mobile security implementations or mobile security code
+  reviews.
+metadata:
+  model: sonnet
+---
+
+## Use this skill when
+
+- Working on mobile security coder tasks or workflows
+- Needing guidance, best practices, or checklists for mobile security coder
+
+## Do not use this skill when
+
+- The task is unrelated to mobile security coder
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a mobile security coding expert specializing in secure mobile development practices, mobile-specific vulnerabilities, and secure mobile architecture patterns.
+
+## Purpose
+Expert mobile security developer with comprehensive knowledge of mobile security practices, platform-specific vulnerabilities, and secure mobile application development. Masters input validation, WebView security, secure data storage, and mobile authentication patterns. Specializes in building security-first mobile applications that protect sensitive data and resist mobile-specific attack vectors.
+
+## When to Use vs Security Auditor
+- **Use this agent for**: Hands-on mobile security coding, implementation of secure mobile patterns, mobile-specific vulnerability fixes, WebView security configuration, mobile authentication implementation
+- **Use security-auditor for**: High-level security audits, compliance assessments, DevSecOps pipeline design, threat modeling, security architecture reviews, penetration testing planning
+- **Key difference**: This agent focuses on writing secure mobile code, while security-auditor focuses on auditing and assessing security posture
+
+## Capabilities
+
+### General Secure Coding Practices
+- **Input validation and sanitization**: Mobile-specific input validation, touch input security, gesture validation
+- **Injection attack prevention**: SQL injection in mobile databases, NoSQL injection, command injection in mobile contexts
+- **Error handling security**: Secure error messages on mobile, crash reporting security, debug information protection
+- **Sensitive data protection**: Mobile data classification, secure storage patterns, memory protection
+- **Secret management**: Mobile credential storage, keychain/keystore integration, biometric-protected secrets
+- **Output encoding**: Context-aware encoding for mobile UI, WebView content encoding, push notification security
+
+### Mobile Data Storage Security
+- **Secure local storage**: SQLite encryption, Core Data protection, Realm security configuration
+- **Keychain and Keystore**: Secure credential storage, biometric authentication integration, key derivation
+- **File system security**: Secure file operations, directory permissions, temporary file cleanup
+- **Cache security**: Secure caching strategies, cache encryption, sensitive data exclusion
+- **Backup security**: Backup exclusion for sensitive files, encrypted backup handling, cloud backup protection
+- **Memory protection**: Memory dump prevention, secure memory allocation, buffer overflow protection
+
+### WebView Security Implementation
+- **URL allowlisting**: Trusted domain restrictions, URL validation, protocol enforcement (HTTPS)
+- **JavaScript controls**: JavaScript disabling by default, selective JavaScript enabling, script injection prevention
+- **Content Security Policy**: CSP implementation in WebViews, script-src restrictions, unsafe-inline prevention
+- **Cookie and session management**: Secure cookie handling, session isolation, cross-WebView security
+- **File access restrictions**: Local file access prevention, asset loading security, sandboxing
+- **User agent security**: Custom user agent strings, fingerprinting prevention, privacy protection
+- **Data cleanup**: Regular WebView cache and cookie clearing, session data cleanup, temporary file removal
+
+### HTTPS and Network Security
+- **TLS enforcement**: HTTPS-only communication, certificate pinning, SSL/TLS configuration
+- **Certificate validation**: Certificate chain validation, self-signed certificate rejection, CA trust management
+- **Man-in-the-middle protection**: Certificate pinning implementation, network security monitoring
+- **Protocol security**: HTTP Strict Transport Security, secure protocol selection, downgrade protection
+- **Network error handling**: Secure network error messages, connection failure handling, retry security
+- **Proxy and VPN detection**: Network environment validation, security policy enforcement
+
+### Mobile Authentication and Authorization
+- **Biometric authentication**: Touch ID, Face ID, fingerprint authentication, fallback mechanisms
+- **Multi-factor authentication**: TOTP integration, hardware token support, SMS-based 2FA security
+- **OAuth implementation**: Mobile OAuth flows, PKCE implementation, deep link security
+- **JWT handling**: Secure token storage, token refresh mechanisms, token validation
+- **Session management**: Mobile session lifecycle, background/foreground transitions, session timeout
+- **Device binding**: Device fingerprinting, hardware-based authentication, root/jailbreak detection
+
+### Platform-Specific Security
+- **iOS security**: Keychain Services, App Transport Security, iOS permission model, sandboxing
+- **Android security**: Android Keystore, Network Security Config, permission handling, ProGuard/R8 obfuscation
+- **Cross-platform considerations**: React Native security, Flutter security, Xamarin security patterns
+- **Native module security**: Bridge security, native code validation, memory safety
+- **Permission management**: Runtime permissions, privacy permissions, location/camera access security
+- **App lifecycle security**: Background/foreground transitions, app state protection, memory clearing
+
+### API and Backend Communication
+- **API security**: Mobile API authentication, rate limiting, request validation
+- **Request/response validation**: Schema validation, data type enforcement, size limits
+- **Secure headers**: Mobile-specific security headers, CORS handling, content type validation
+- **Error response handling**: Secure error messages, information leakage prevention, debug mode protection
+- **Offline synchronization**: Secure data sync, conflict resolution security, cached data protection
+- **Push notification security**: Secure notification handling, payload encryption, token management
+
+### Code Protection and Obfuscation
+- **Code obfuscation**: ProGuard, R8, iOS obfuscation, symbol stripping
+- **Anti-tampering**: Runtime application self-protection (RASP), integrity checks, debugger detection
+- **Root/jailbreak detection**: Device security validation, security policy enforcement, graceful degradation
+- **Binary protection**: Anti-reverse engineering, packing, dynamic analysis prevention
+- **Asset protection**: Resource encryption, embedded asset security, intellectual property protection
+- **Debug protection**: Debug mode detection, development feature disabling, production hardening
+
+### Mobile-Specific Vulnerabilities
+- **Deep link security**: URL scheme validation, intent filter security, parameter sanitization
+- **WebView vulnerabilities**: JavaScript bridge security, file scheme access, universal XSS prevention
+- **Data leakage**: Log sanitization, screenshot protection, memory dump prevention
+- **Side-channel attacks**: Timing attack prevention, cache-based attacks, acoustic/electromagnetic leakage
+- **Physical device security**: Screen recording prevention, screenshot blocking, shoulder surfing protection
+- **Backup and recovery**: Secure backup handling, recovery key management, data restoration security
+
+### Cross-Platform Security
+- **React Native security**: Bridge security, native module validation, JavaScript thread protection
+- **Flutter security**: Platform channel security, native plugin validation, Dart VM protection
+- **Xamarin security**: Managed/native interop security, assembly protection, runtime security
+- **Cordova/PhoneGap**: Plugin security, WebView configuration, native bridge protection
+- **Unity mobile**: Asset bundle security, script compilation security, native plugin integration
+- **Progressive Web Apps**: PWA security on mobile, service worker security, web manifest validation
+
+### Privacy and Compliance
+- **Data privacy**: GDPR compliance, CCPA compliance, data minimization, consent management
+- **Location privacy**: Location data protection, precise location limiting, background location security
+- **Biometric data**: Biometric template protection, privacy-preserving authentication, data retention
+- **Personal data handling**: PII protection, data encryption, access logging, data deletion
+- **Third-party SDKs**: SDK privacy assessment, data sharing controls, vendor security validation
+- **Analytics privacy**: Privacy-preserving analytics, data anonymization, opt-out mechanisms
+
+### Testing and Validation
+- **Security testing**: Mobile penetration testing, SAST/DAST for mobile, dynamic analysis
+- **Runtime protection**: Runtime application self-protection, behavior monitoring, anomaly detection
+- **Vulnerability scanning**: Dependency scanning, known vulnerability detection, patch management
+- **Code review**: Security-focused code review, static analysis integration, peer review processes
+- **Compliance testing**: Security standard compliance, regulatory requirement validation, audit preparation
+- **User acceptance testing**: Security scenario testing, social engineering resistance, user education
+
+## Behavioral Traits
+- Validates and sanitizes all inputs including touch gestures and sensor data
+- Enforces HTTPS-only communication with certificate pinning
+- Implements comprehensive WebView security with JavaScript disabled by default
+- Uses secure storage mechanisms with encryption and biometric protection
+- Applies platform-specific security features and follows security guidelines
+- Implements defense-in-depth with multiple security layers
+- Protects against mobile-specific threats like root/jailbreak detection
+- Considers privacy implications in all data handling operations
+- Uses secure coding practices for cross-platform development
+- Maintains security throughout the mobile app lifecycle
+
+## Knowledge Base
+- Mobile security frameworks and best practices (OWASP MASVS)
+- Platform-specific security features (iOS/Android security models)
+- WebView security configuration and CSP implementation
+- Mobile authentication and biometric integration patterns
+- Secure data storage and encryption techniques
+- Network security and certificate pinning implementation
+- Mobile-specific vulnerability patterns and prevention
+- Cross-platform security considerations
+- Privacy regulations and compliance requirements
+- Mobile threat landscape and attack vectors
+
+## Response Approach
+1. **Assess mobile security requirements** including platform constraints and threat model
+2. **Implement input validation** with mobile-specific considerations and touch input security
+3. **Configure WebView security** with HTTPS enforcement and JavaScript controls
+4. **Set up secure data storage** with encryption and platform-specific protection mechanisms
+5. **Implement authentication** with biometric integration and multi-factor support
+6. **Configure network security** with certificate pinning and HTTPS enforcement
+7. **Apply code protection** with obfuscation and anti-tampering measures
+8. **Handle privacy compliance** with data protection and consent management
+9. **Test security controls** with mobile-specific testing tools and techniques
+
+## Example Interactions
+- "Implement secure WebView configuration with HTTPS enforcement and CSP"
+- "Set up biometric authentication with secure fallback mechanisms"
+- "Create secure local storage with encryption for sensitive user data"
+- "Implement certificate pinning for API communication security"
+- "Configure deep link security with URL validation and parameter sanitization"
+- "Set up root/jailbreak detection with graceful security degradation"
+- "Implement secure cross-platform data sharing between native and WebView"
+- "Create privacy-compliant analytics with data minimization and consent"
+- "Implement secure React Native bridge communication with input validation"
+- "Configure Flutter platform channel security with message validation"
+- "Set up secure Xamarin native interop with assembly protection"
+- "Implement secure Cordova plugin communication with sandboxing"
diff --git a/.agents/skills/pressure-testing/SKILL.md b/.agents/skills/pressure-testing/SKILL.md
new file mode 100644
index 0000000..c7b7313
--- /dev/null
+++ b/.agents/skills/pressure-testing/SKILL.md
@@ -0,0 +1,60 @@
+---
+name: pressure-testing
+description: Standardize VisionFlow load, pressure, capacity, and soak testing across Docker, PgBouncer, BullMQ, Redis, workflow execution, and tietiezhi batch generation. Use when an agent needs to run or document high-concurrency validation, 2C4G simulations, multi-user submit tests, workflow stress tests, throughput investigations, OSS cleanup for test runs, or performance reporting and tuning guidance.
+---
+
+# Pressure Testing
+
+Use this skill to run VisionFlow pressure tests in the repo's supported way instead of inventing an ad hoc flow.
+
+## Pick the right harness
+
+- Use `tests/harness/tietiezhi-concurrency-lab.ts` for `/api/generate/batch`, submit-plane, Redis/BullMQ/DB/PgBouncer, and `tietiezhi` mock upstream validation.
+- Use `scripts/ops/workflow-1000-load.ts` for multi-user workflow execution, workflow cloning, and workflow node route validation.
+- Use `scripts/ops/precheck-2c4g-load.ps1` before either harness when Docker, Redis, PgBouncer, or LAN PostgreSQL might be the blocker.
+
+Read [`references/commands.md`](./references/commands.md) for exact commands. Read [`references/reporting.md`](./references/reporting.md) before declaring the run successful.
+
+## Follow the standard workflow
+
+1. Run the precheck script from PowerShell and confirm Docker API, Redis host port, PgBouncer host port, and LAN PostgreSQL are all reachable.
+2. Start Docker with the repo-supported Compose stack. Use the base Compose plus `docker-compose.local.yml` for normal local runs. Add `docker-compose.low-resource.yml` only when simulating the temporary 2C4G profile.
+3. Run a smoke stage first. Do not jump directly to the largest matrix.
+4. Ramp through the matrix in ascending order. Keep `--stop-on-fail` enabled so the harness stops once it finds a real platform or routing failure.
+5. Save the generated JSON and Markdown reports under `logs/测试服并发性能日志/<runId>/`.
+6. Do a run-scoped OSS cleanup only after checking that the report matches the current run.
+7. Write the final recommendation as "highest stable stage" and "recommended production ceiling", where the ceiling is usually 60%-70% of the highest stable stage.
+
+## Enforce the repo rules
+
+- Use Docker for pressure tests. Do not use `pnpm dev` as the main test surface.
+- Use `--apply-config` for tietiezhi batch runs when validating platform capacity; it writes the 20-minute execution policy and unified `capacity.providerCallConcurrency` profile before publishing hot reload.
+- The tietiezhi harness must not keep shorter local wait windows: submit tracker, generation tracker, and drain timeout default to the same 20-minute budget. If a run reports `generation_failed_force_timeout`, first verify the harness was run with the current defaults before treating it as a platform timeout.
+- For local tietiezhi runs, `--prepare-local-users` raises test users' `featureBatchLimit` to at least `max(1000, capacity-provider-call, max batch)`, so product membership slots do not masquerade as platform capacity failures.
+- Keep image stress tests on `model=tietiezhi` and `vendor=tietiezhi`. Treat Gemini image generation during these runs as a routing failure.
+- Keep `--skip-matting` enabled for the tietiezhi harness. Matting tunnel noise is not part of the target benchmark.
+- Treat host-side Redis metrics as `127.0.0.1:6379` unless `LOAD_REDIS_URL` or `--queue-redis-url` explicitly overrides it. Do not inherit stale `.env` values like `localhost:16379`.
+- Scale with multiple containers and processes, not `worker_threads`. The supported pattern is `--scale visionflow=2 --scale worker=2` and then tuning worker concurrency.
+- Keep OSS cleanup scoped to the current run. Never mass-delete historical test assets.
+- If you touch docs while adjusting this workflow, update `README*.md`, `DEPLOY*.md`, and `CHANGELOG*.md` together.
+
+## Classify failures correctly
+
+- Treat these as platform failures:
+  - queue `503` caused by local platform saturation or admission behavior
+  - Prisma pool timeouts
+  - balance freeze conflict snowballs
+  - workflow orphaning or BullMQ stage failures caused by local logic
+  - Gemini image calls, matting calls, or non-`tietiezhi` routing during a `tietiezhi` batch test
+- Treat these as infra or upstream blockers unless the repo changed them:
+  - Docker API or named pipe access issues
+  - LAN PostgreSQL unreachability
+  - Redis host port blocked before the test starts
+  - `tietiezhi` returning bad images, 1x1 placeholders, or upstream 5xx/timeout noise
+- If the harness stops because target IPM was missed but platform errors stayed at zero, record it as a capacity ceiling, not a correctness failure.
+
+## Use the references deliberately
+
+- Read [`references/commands.md`](./references/commands.md) when you need the exact precheck, startup, smoke, matrix, or cleanup commands.
+- Read [`references/reporting.md`](./references/reporting.md) when you need acceptance criteria, report contents, failure taxonomy, or recommendation format.
+- Read `docker/README.md` only when you need the Compose details behind the command matrix; do not re-derive the stack from scratch.
diff --git a/.agents/skills/pressure-testing/references/commands.md b/.agents/skills/pressure-testing/references/commands.md
new file mode 100644
index 0000000..40dcc3a
--- /dev/null
+++ b/.agents/skills/pressure-testing/references/commands.md
@@ -0,0 +1,95 @@
+# Pressure Testing Command Matrix
+
+## 1. Precheck
+
+Run this from the repo root before any Docker-based pressure test:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts/ops/precheck-2c4g-load.ps1 -ComposeEnvFile docker/.env -PsqlPath "C:\Program Files\PostgreSQL\18\bin\psql.exe"
+```
+
+Expected checks:
+
+- Docker API and current context
+- merged low-resource Compose config
+- host Redis port for metrics
+- PgBouncer host port
+- LAN PostgreSQL reachability through `psql`
+
+## 2. Start Docker
+
+### Standard local stack
+
+```powershell
+cd docker
+docker compose --env-file .env -f docker-compose.yml -f docker-compose.local.yml up -d --build visionflow worker redis caddy pgbouncer
+```
+
+### Temporary 2C4G simulation
+
+```powershell
+cd docker
+docker compose --env-file .env -f docker-compose.yml -f docker-compose.local.yml -f docker-compose.low-resource.yml up -d --build --scale visionflow=2 --scale worker=2 visionflow worker redis caddy pgbouncer
+```
+
+Use the low-resource overlay only for the temporary 2C4G simulation. It is not the main deployment entry.
+
+## 3. Tietiezhi batch harness
+
+### Smoke
+
+```powershell
+pnpm ops:tietiezhi-load -- --apply-config --users-list=10 --batch-size-list=30 --concurrency-list=10 --model=tietiezhi --vendor=tietiezhi --skip-matting --stop-on-fail --metrics-interval-ms=5000
+```
+
+### Main matrix
+
+```powershell
+pnpm ops:tietiezhi-load -- --apply-config --users-list=10,20,40 --batch-size-list=30,50,100 --concurrency-list=10,20,50,100,250,500,1000 --model=tietiezhi --vendor=tietiezhi --skip-matting --stop-on-fail --metrics-interval-ms=5000 --cleanup-oss
+```
+
+`--apply-config` writes the 20-minute execution policy and unified capacity profile. The harness also uses 20 minutes for submit/generation/drain tracking by default and raises local test users' batch/concurrency slots to at least `max(1000, capacity-provider-call, max batch)`.
+
+### Safe cleanup pass
+
+Run dry-run first if the last stage was exploratory or if object storage is shared:
+
+```powershell
+pnpm ops:tietiezhi-load -- --apply-config --users-list=10 --batch-size-list=30 --concurrency-list=10 --model=tietiezhi --vendor=tietiezhi --skip-matting --cleanup-oss --cleanup-dry-run=true
+```
+
+Switch `--cleanup-dry-run=false` only after confirming the run-scoped object list.
+
+## 4. Workflow harness
+
+### Smoke
+
+```powershell
+pnpm ops:workflow-load -- --low-resource-profile=2c4g --clone-workflows --concurrency-list=50 --requests=50 --users-limit=10 --user-pool-size=30 --apply-config
+```
+
+### Main matrix
+
+```powershell
+pnpm ops:workflow-load -- --low-resource-profile=2c4g --clone-workflows --concurrency-list=50,100,250,500,1000 --requests=1000 --users-limit=60 --user-pool-size=180 --apply-config --cleanup-oss --cleanup-dry-run=false
+```
+
+Use the default three workflow IDs unless the task explicitly requests a different set:
+
+- `cmobdcmms000dyt64ajrz0x7q`
+- `cmobdcjdd000byt64nwmntj5t`
+- `cmobdcg710009yt640g3nsyk8`
+
+The workflow harness already forces image-generation nodes to `tietiezhi/tietiezhi` and clones workflows per run when `--clone-workflows` is enabled.
+
+## 5. Required static checks when the load tooling changes
+
+Run these from the repo root when the harness, Docker stack, or pressure-test routing changes:
+
+```powershell
+pnpm typecheck
+pnpm lint
+RUN_DB_TESTS=1 pnpm exec vitest run src/lib/__tests__/balance-concurrency.test.ts --reporter=dot
+```
+
+Run `pnpm swagger:sync` only if the change also touched API behavior or Swagger annotations.
diff --git a/.agents/skills/pressure-testing/references/reporting.md b/.agents/skills/pressure-testing/references/reporting.md
new file mode 100644
index 0000000..109ff18
--- /dev/null
+++ b/.agents/skills/pressure-testing/references/reporting.md
@@ -0,0 +1,87 @@
+# Pressure Testing Reporting and Acceptance
+
+## Always capture
+
+- `runId`
+- Docker profile used and replica counts for `visionflow` and `worker`
+- user matrix, batch-size matrix, and concurrency matrix
+- submit latency `p50/p95/p99`
+- end-to-end latency `p50/p95/p99`
+- planned requests, accepted requests, accepted rate
+- planned images, success images, failed images, unresolved images
+- `429` count, `503` count, throttle rate
+- Redis memory and key queue stats
+- BullMQ `waiting/active/failed/delayed`
+- DB connection pressure and PgBouncer reachability or stats
+- container CPU, memory, restart count
+- route validation counts for `model/vendor`
+- OSS cleanup results: matched objects, deleted, skipped, errors
+
+## Artifact locations
+
+Write artifacts under:
+
+```text
+logs/测试服并发性能日志/<runId>/
+```
+
+At minimum keep:
+
+- one JSON report
+- one Markdown summary
+- any extra reconciliation or cleanup output produced by the harness
+
+## Pass / fail rules
+
+### Platform pass
+
+- no platform-side queue `503` misreport
+- no Prisma pool timeout
+- no balance-freeze conflict snowball
+- no workflow orphaning caused by local logic
+- no Gemini image calls during `tietiezhi` batch tests
+- no matting calls during `tietiezhi` batch tests
+- no non-`tietiezhi` image route mismatch
+
+### Platform fail
+
+- local admission or queue logic fails before upstream becomes the limiter
+- BullMQ or workflow stage logic fails under normal load
+- run reports show route mismatch or forbidden model/vendor usage
+- OSS cleanup deletes outside the current run
+
+### Capacity ceiling, not correctness fail
+
+- target IPM is missed
+- higher stages are slower
+- the harness stops because `stop-on-fail` hit a throughput threshold
+- platform-side correctness signals stay green
+
+Record these as "maximum stable stage reached X" and "recommended production ceiling Y".
+
+### Infra or upstream blocker
+
+- Docker API unavailable
+- LAN PostgreSQL unavailable
+- Redis host metrics port unreachable before the run starts
+- `tietiezhi` upstream returns 5xx, timeouts, or unusable images such as 1x1 placeholders
+
+Do not mix these with platform regressions.
+
+## Recommendation format
+
+State the result in this order:
+
+1. highest stable scenario
+2. why the next scenario failed or was stopped
+3. recommended production ceiling, usually 60%-70% of the highest stable scenario
+4. recommended replica count, worker concurrency, PgBouncer pool settings, and Redis memory budget
+
+Example shape:
+
+```text
+最高稳定档：20 users × batch 50 × concurrency 100
+停止原因：40 users × batch 50 × concurrency 250 开始出现上游 tietiezhi 5xx，平台侧指标仍稳定
+推荐生产档：20 users × batch 50 × concurrency 60-70
+建议配置：visionflow=2, worker=2, provider-call=128/worker, PgBouncer default_pool=50, Redis maxmemory=896MB
+```
diff --git a/.agents/skills/prototype/LOGIC.md b/.agents/skills/prototype/LOGIC.md
new file mode 100644
index 0000000..526ecb1
--- /dev/null
+++ b/.agents/skills/prototype/LOGIC.md
@@ -0,0 +1,79 @@
+# Logic Prototype
+
+A tiny interactive terminal app that lets the user drive a state model by hand. Use this when the question is about **business logic, state transitions, or data shape** — the kind of thing that looks reasonable on paper but only feels wrong once you push it through real cases.
+
+## When this is the right shape
+
+- "I'm not sure if this state machine handles the edge case where X then Y."
+- "Does this data model actually let me represent the case where..."
+- "I want to feel out what the API should look like before writing it."
+- Anything where the user wants to **press buttons and watch state change**.
+
+If the question is "what should this look like" — wrong branch. Use [UI.md](UI.md).
+
+## Process
+
+### 1. State the question
+
+Before writing code, write down what state model and what question you're prototyping. One paragraph, in the prototype's README or a comment at the top of the file. A logic prototype that answers the wrong question is pure waste — make the question explicit so it can be checked later, whether the user is watching now or returning to it AFK.
+
+### 2. Pick the language
+
+Use whatever the host project uses. If the project has no obvious runtime (e.g. a docs repo), ask.
+
+Match the project's existing conventions for tooling — don't add a new package manager or runtime just for the prototype.
+
+### 3. Isolate the logic in a portable module
+
+Put the actual logic — the bit that's answering the question — behind a small, pure interface that could be lifted out and dropped into the real codebase later. The TUI around it is throwaway; the logic module shouldn't be.
+
+The right shape depends on the question:
+
+- **A pure reducer** — `(state, action) => state`. Good when actions are discrete events and state is a single value.
+- **A state machine** — explicit states and transitions. Good when "which actions are even legal right now" is part of the question.
+- **A small set of pure functions** over a plain data type. Good when there's no implicit current state — just transformations.
+- **A class or module with a clear method surface** when the logic genuinely owns ongoing internal state.
+
+Pick whichever shape best fits the question being asked, *not* whichever is easiest to wire to a TUI. Keep it pure: no I/O, no terminal code, no `console.log` for control flow. The TUI imports it and calls into it; nothing flows the other direction.
+
+This is what makes the prototype useful past its own lifetime. When the question's been answered, the validated reducer / machine / function set can be lifted into the real module — the TUI shell gets deleted.
+
+### 4. Build the smallest TUI that exposes the state
+
+Build it as a **lightweight TUI** — on every tick, clear the screen (`console.clear()` / `print("\033[2J\033[H")` / equivalent) and re-render the whole frame. The user should always see one stable view, not an ever-growing scrollback.
+
+Each frame has two parts, in this order:
+
+1. **Current state**, pretty-printed and diff-friendly (one field per line, or formatted JSON). Use **bold** for field names or section headers and **dim** for less important context (timestamps, IDs, derived values). Native ANSI escape codes are fine — `\x1b[1m` bold, `\x1b[2m` dim, `\x1b[0m` reset. No need to pull in a styling library unless one is already in the project.
+2. **Keyboard shortcuts**, listed at the bottom: `[a] add user  [d] delete user  [t] tick clock  [q] quit`. Bold the key, dim the description, or vice-versa — whatever reads cleanly.
+
+Behaviour:
+
+1. **Initialise state** — a single in-memory object/struct. Render the first frame on start.
+2. **Read one keystroke (or one line)** at a time, dispatch to a handler that mutates state.
+3. **Re-render** the full frame after every action — don't append, replace.
+4. **Loop until quit.**
+
+The whole frame should fit on one screen.
+
+### 5. Make it runnable in one command
+
+Add a script to the project's existing task runner (`package.json` scripts, `Makefile`, `justfile`, `pyproject.toml`). The user should run `pnpm run <prototype-name>` or equivalent — never need to remember a path.
+
+If the host project has no task runner, just put the command at the top of the prototype's README.
+
+### 6. Hand it over
+
+Give the user the run command. They'll drive it themselves; the interesting moments are when they say "wait, that shouldn't be possible" or "huh, I assumed X would be different" — those are the bugs in the _idea_, which is the whole point. If they want new actions added, add them. Prototypes evolve.
+
+### 7. Capture the answer
+
+When the prototype has done its job, the answer to the question is the only thing worth keeping. If the user is around, ask what it taught them. If not, leave a `NOTES.md` next to the prototype so the answer can be filled in (or filled in by you, if you've watched the session) before the prototype gets deleted.
+
+## Anti-patterns
+
+- **Don't add tests.** A prototype that needs tests is no longer a prototype.
+- **Don't wire it to the real database.** Use an in-memory store unless the question is specifically about persistence.
+- **Don't generalise.** No "what if we wanted to support X later." The prototype answers one question.
+- **Don't blur the logic and the TUI together.** If the reducer / state machine references `console.log`, prompts, or terminal escape codes, it's no longer portable. Keep the TUI as a thin shell over a pure module.
+- **Don't ship the TUI shell into production.** The shell is optimised for being driven by hand from a terminal. The logic module behind it is the bit worth keeping.
diff --git a/.agents/skills/prototype/SKILL.md b/.agents/skills/prototype/SKILL.md
new file mode 100644
index 0000000..64f3e61
--- /dev/null
+++ b/.agents/skills/prototype/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: prototype
+description: Build a throwaway prototype to flesh out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".
+---
+
+# Prototype
+
+A prototype is **throwaway code that answers a question**. The question decides the shape.
+
+## Pick a branch
+
+Identify which question is being answered — from the user's prompt, the surrounding code, or by asking if the user is around:
+
+- **"Does this logic / state model feel right?"** → [LOGIC.md](LOGIC.md). Build a tiny interactive terminal app that pushes the state machine through cases that are hard to reason about on paper.
+- **"What should this look like?"** → [UI.md](UI.md). Generate several radically different UI variations on a single route, switchable via a URL search param and a floating bottom bar.
+
+The two branches produce very different artifacts — getting this wrong wastes the whole prototype. If the question is genuinely ambiguous and the user isn't reachable, default to whichever branch better matches the surrounding code (a backend module → logic; a page or component → UI) and state the assumption at the top of the prototype.
+
+## Rules that apply to both
+
+1. **Throwaway from day one, and clearly marked as such.** Locate the prototype code close to where it will actually be used (next to the module or page it's prototyping for) so context is obvious — but name it so a casual reader can see it's a prototype, not production. For throwaway UI routes, obey whatever routing convention the project already uses; don't invent a new top-level structure.
+2. **One command to run.** Whatever the project's existing task runner supports — `pnpm <name>`, `python <path>`, `bun <path>`, etc. The user must be able to start it without thinking.
+3. **No persistence by default.** State lives in memory. Persistence is the thing the prototype is _checking_, not something it should depend on. If the question explicitly involves a database, hit a scratch DB or a local file with a clear "PROTOTYPE — wipe me" name.
+4. **Skip the polish.** No tests, no error handling beyond what makes the prototype _runnable_, no abstractions. The point is to learn something fast and then delete it.
+5. **Surface the state.** After every action (logic) or on every variant switch (UI), print or render the full relevant state so the user can see what changed.
+6. **Delete or absorb when done.** When the prototype has answered its question, either delete it or fold the validated decision into the real code — don't leave it rotting in the repo.
+
+## When done
+
+The _answer_ is the only thing worth keeping from a prototype. Capture it somewhere durable (commit message, ADR, issue, or a `NOTES.md` next to the prototype) along with the question it was answering. If the user is around, that capture is a quick conversation; if not, leave the placeholder so they (or you, on the next pass) can fill in the verdict before deleting the prototype.
diff --git a/.agents/skills/prototype/UI.md b/.agents/skills/prototype/UI.md
new file mode 100644
index 0000000..f3b6e64
--- /dev/null
+++ b/.agents/skills/prototype/UI.md
@@ -0,0 +1,112 @@
+# UI Prototype
+
+Generate **several radically different UI variations** on a single route, switchable from a floating bottom bar. The user flips between variants in the browser, picks one (or steals bits from each), then throws the rest away.
+
+If the question is about logic/state rather than what something looks like — wrong branch. Use [LOGIC.md](LOGIC.md).
+
+## When this is the right shape
+
+- "What should this page look like?"
+- "I want to see a few options for this dashboard before committing."
+- "Try a different layout for the settings screen."
+- Any time the user would otherwise spend a day picking between three vague mockups in their head.
+
+## Two sub-shapes — strongly prefer sub-shape A
+
+A UI prototype is much easier to judge when it's **butting up against the rest of the app** — real header, real sidebar, real data, real density. A throwaway route on its own is a vacuum: every variant looks fine in isolation. Default to sub-shape A whenever there's a plausible existing page to host the variants. Only reach for sub-shape B if the prototype genuinely has no nearby home.
+
+### Sub-shape A — adjustment to an existing page (preferred)
+
+The route already exists. Variants are rendered **on the same route**, gated by a `?variant=` URL search param. The existing data fetching, params, and auth all stay — only the rendering swaps. This is the default; pick it unless there's a specific reason not to.
+
+If the prototype is for something that doesn't yet have a page but *would naturally live inside one* (a new section of the dashboard, a new card on the settings screen, a new step in an existing flow) — that's still sub-shape A. Mount the variants inside the host page.
+
+### Sub-shape B — a new page (last resort)
+
+Only use this when the thing being prototyped genuinely has no existing page to live inside — e.g. an entirely new top-level surface, or a flow that can't be embedded anywhere sensible.
+
+Create a **throwaway route** following whatever routing convention the project already uses — don't invent a new top-level structure. Name it so it's obviously a prototype (e.g. include the word `prototype` in the path or filename). Same `?variant=` pattern.
+
+Before committing to sub-shape B, sanity-check: is there really no existing page this could be embedded in? An empty route hides design problems that a populated one would expose.
+
+In both sub-shapes the floating bottom bar is identical.
+
+## Process
+
+### 1. State the question and pick N
+
+Default to **3 variants**. More than 5 stops being radically different and starts being noise — cap there.
+
+Write down the plan in one line, in the prototype's location or a top-of-file comment:
+
+> "Three variants of the settings page, switchable via `?variant=`, on the existing `/settings` route."
+
+This works whether the user is here to push back or not.
+
+### 2. Generate radically different variants
+
+Draft each variant. Hold each one to:
+
+- The page's purpose and the data it has access to.
+- The project's component library / styling system (TailwindCSS, shadcn, MUI, plain CSS, whatever).
+- A clear exported component name, e.g. `VariantA`, `VariantB`, `VariantC`.
+
+Variants must be **structurally different** — different layout, different information hierarchy, different primary affordance, not just different colours. Three slightly-tweaked card grids isn't a UI prototype, it's wallpaper. If two drafts come out too similar, redo one with explicit "do not use a card grid" guidance.
+
+### 3. Wire them together
+
+Create a single switcher component on the route:
+
+```tsx
+// pseudo-code — adapt to the project's framework
+const variant = searchParams.get('variant') ?? 'A';
+return (
+  <>
+    {variant === 'A' && <VariantA {...data} />}
+    {variant === 'B' && <VariantB {...data} />}
+    {variant === 'C' && <VariantC {...data} />}
+    <PrototypeSwitcher variants={['A','B','C']} current={variant} />
+  </>
+);
+```
+
+For sub-shape A (existing page): keep all the existing data fetching above the switcher; only the rendered subtree changes per variant.
+
+For sub-shape B (new page): the throwaway route under `/prototype/<name>` mounts the same switcher.
+
+### 4. Build the floating switcher
+
+A small fixed-position bar at the bottom-centre of the screen with three pieces:
+
+- **Left arrow** — cycles to the previous variant (wraps around).
+- **Variant label** — shows the current variant key and, if the variant exports a name, that name too. e.g. `B — Sidebar layout`.
+- **Right arrow** — cycles forward (wraps around).
+
+Behaviour:
+
+- Clicking an arrow updates the URL search param (use the framework's router — `router.replace` on Next, `navigate` on React Router, etc) so the variant is shareable and reload-stable.
+- Keyboard: `←` and `→` arrow keys also cycle. Don't intercept arrow keys when an `<input>`, `<textarea>`, or `[contenteditable]` is focused.
+- Visually distinct from the page (e.g. high-contrast pill, subtle shadow) so it's obviously not part of the design being evaluated.
+- Hidden in production builds — gate on `process.env.NODE_ENV !== 'production'` or an equivalent check, so a stray prototype merge can't ship the bar to users.
+
+Put the switcher in a single shared component so both sub-shapes can reuse it. Locate it wherever shared UI lives in the project.
+
+### 5. Hand it over
+
+Surface the URL (and the `?variant=` keys). The user will flip through whenever they get to it. The interesting feedback is usually **"I want the header from B with the sidebar from C"** — that's the actual design they want.
+
+### 6. Capture the answer and clean up
+
+Once a variant has won, write down which one and why (commit message, ADR, issue, or a `NOTES.md` next to the prototype if running AFK and the user hasn't responded yet). Then:
+
+- **Sub-shape A** — delete the losing variants and the switcher; fold the winner into the existing page.
+- **Sub-shape B** — promote the winning variant to a real route, delete the throwaway route and the switcher.
+
+Don't leave variant components or the switcher lying around. They rot fast and confuse the next reader.
+
+## Anti-patterns
+
+- **Variants that differ only in colour or copy.** That's a tweak, not a prototype. Real variants disagree about structure.
+- **Sharing too much code between variants.** A shared `<Header>` is fine; a shared `<Layout>` defeats the point. Each variant should be free to throw out the layout.
+- **Wiring variants to real mutations.** Read-only prototypes are fine. If a variant needs to mutate, point it at a stub — the question is "what should this look like", not "does the backend work".
+- **Promoting the prototype directly to production.** The variant code was written under prototype constraints (no tests, minimal error handling). Rewrite it properly when you fold it in.
diff --git a/.agents/skills/react-best-practices/SKILL.md b/.agents/skills/react-best-practices/SKILL.md
new file mode 100644
index 0000000..1ad7750
--- /dev/null
+++ b/.agents/skills/react-best-practices/SKILL.md
@@ -0,0 +1,136 @@
+---
+name: vercel-react-best-practices
+description: React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
+license: MIT
+metadata:
+  author: vercel
+  version: "1.0.0"
+---
+
+# Vercel React Best Practices
+
+Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains 57 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
+
+## When to Apply
+
+Reference these guidelines when:
+- Writing new React components or Next.js pages
+- Implementing data fetching (client or server-side)
+- Reviewing code for performance issues
+- Refactoring existing React/Next.js code
+- Optimizing bundle size or load times
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Prefix |
+|----------|----------|--------|--------|
+| 1 | Eliminating Waterfalls | CRITICAL | `async-` |
+| 2 | Bundle Size Optimization | CRITICAL | `bundle-` |
+| 3 | Server-Side Performance | HIGH | `server-` |
+| 4 | Client-Side Data Fetching | MEDIUM-HIGH | `client-` |
+| 5 | Re-render Optimization | MEDIUM | `rerender-` |
+| 6 | Rendering Performance | MEDIUM | `rendering-` |
+| 7 | JavaScript Performance | LOW-MEDIUM | `js-` |
+| 8 | Advanced Patterns | LOW | `advanced-` |
+
+## Quick Reference
+
+### 1. Eliminating Waterfalls (CRITICAL)
+
+- `async-defer-await` - Move await into branches where actually used
+- `async-parallel` - Use Promise.all() for independent operations
+- `async-dependencies` - Use better-all for partial dependencies
+- `async-api-routes` - Start promises early, await late in API routes
+- `async-suspense-boundaries` - Use Suspense to stream content
+
+### 2. Bundle Size Optimization (CRITICAL)
+
+- `bundle-barrel-imports` - Import directly, avoid barrel files
+- `bundle-dynamic-imports` - Use next/dynamic for heavy components
+- `bundle-defer-third-party` - Load analytics/logging after hydration
+- `bundle-conditional` - Load modules only when feature is activated
+- `bundle-preload` - Preload on hover/focus for perceived speed
+
+### 3. Server-Side Performance (HIGH)
+
+- `server-auth-actions` - Authenticate server actions like API routes
+- `server-cache-react` - Use React.cache() for per-request deduplication
+- `server-cache-lru` - Use LRU cache for cross-request caching
+- `server-dedup-props` - Avoid duplicate serialization in RSC props
+- `server-serialization` - Minimize data passed to client components
+- `server-parallel-fetching` - Restructure components to parallelize fetches
+- `server-after-nonblocking` - Use after() for non-blocking operations
+
+### 4. Client-Side Data Fetching (MEDIUM-HIGH)
+
+- `client-swr-dedup` - Use SWR for automatic request deduplication
+- `client-event-listeners` - Deduplicate global event listeners
+- `client-passive-event-listeners` - Use passive listeners for scroll
+- `client-localstorage-schema` - Version and minimize localStorage data
+
+### 5. Re-render Optimization (MEDIUM)
+
+- `rerender-defer-reads` - Don't subscribe to state only used in callbacks
+- `rerender-memo` - Extract expensive work into memoized components
+- `rerender-memo-with-default-value` - Hoist default non-primitive props
+- `rerender-dependencies` - Use primitive dependencies in effects
+- `rerender-derived-state` - Subscribe to derived booleans, not raw values
+- `rerender-derived-state-no-effect` - Derive state during render, not effects
+- `rerender-functional-setstate` - Use functional setState for stable callbacks
+- `rerender-lazy-state-init` - Pass function to useState for expensive values
+- `rerender-simple-expression-in-memo` - Avoid memo for simple primitives
+- `rerender-move-effect-to-event` - Put interaction logic in event handlers
+- `rerender-transitions` - Use startTransition for non-urgent updates
+- `rerender-use-ref-transient-values` - Use refs for transient frequent values
+
+### 6. Rendering Performance (MEDIUM)
+
+- `rendering-animate-svg-wrapper` - Animate div wrapper, not SVG element
+- `rendering-content-visibility` - Use content-visibility for long lists
+- `rendering-hoist-jsx` - Extract static JSX outside components
+- `rendering-svg-precision` - Reduce SVG coordinate precision
+- `rendering-hydration-no-flicker` - Use inline script for client-only data
+- `rendering-hydration-suppress-warning` - Suppress expected mismatches
+- `rendering-activity` - Use Activity component for show/hide
+- `rendering-conditional-render` - Use ternary, not && for conditionals
+- `rendering-usetransition-loading` - Prefer useTransition for loading state
+
+### 7. JavaScript Performance (LOW-MEDIUM)
+
+- `js-batch-dom-css` - Group CSS changes via classes or cssText
+- `js-index-maps` - Build Map for repeated lookups
+- `js-cache-property-access` - Cache object properties in loops
+- `js-cache-function-results` - Cache function results in module-level Map
+- `js-cache-storage` - Cache localStorage/sessionStorage reads
+- `js-combine-iterations` - Combine multiple filter/map into one loop
+- `js-length-check-first` - Check array length before expensive comparison
+- `js-early-exit` - Return early from functions
+- `js-hoist-regexp` - Hoist RegExp creation outside loops
+- `js-min-max-loop` - Use loop for min/max instead of sort
+- `js-set-map-lookups` - Use Set/Map for O(1) lookups
+- `js-tosorted-immutable` - Use toSorted() for immutability
+
+### 8. Advanced Patterns (LOW)
+
+- `advanced-event-handler-refs` - Store event handlers in refs
+- `advanced-init-once` - Initialize app once per app load
+- `advanced-use-latest` - useLatest for stable callback refs
+
+## How to Use
+
+Read individual rule files for detailed explanations and code examples:
+
+```
+rules/async-parallel.md
+rules/bundle-barrel-imports.md
+```
+
+Each rule file contains:
+- Brief explanation of why it matters
+- Incorrect code example with explanation
+- Correct code example with explanation
+- Additional context and references
+
+## Full Compiled Document
+
+For the complete guide with all rules expanded: `AGENTS.md`
diff --git a/.agents/skills/react-best-practices/metadata.json b/.agents/skills/react-best-practices/metadata.json
new file mode 100644
index 0000000..3bec38b
--- /dev/null
+++ b/.agents/skills/react-best-practices/metadata.json
@@ -0,0 +1,15 @@
+{
+  "version": "1.0.0",
+  "organization": "Vercel Engineering",
+  "date": "January 2026",
+  "abstract": "Comprehensive performance optimization guide for React and Next.js applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (eliminating waterfalls, reducing bundle size) to incremental (advanced patterns). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics to guide automated refactoring and code generation.",
+  "references": [
+    "https://react.dev",
+    "https://nextjs.org",
+    "https://swr.vercel.app",
+    "https://github.com/shuding/better-all",
+    "https://github.com/isaacs/node-lru-cache",
+    "https://vercel.com/blog/how-we-optimized-package-imports-in-next-js",
+    "https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast"
+  ]
+}
diff --git a/.agents/skills/react-best-practices/rules/_sections.md b/.agents/skills/react-best-practices/rules/_sections.md
new file mode 100644
index 0000000..4d20c14
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/_sections.md
@@ -0,0 +1,46 @@
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Eliminating Waterfalls (async)
+
+**Impact:** CRITICAL  
+**Description:** Waterfalls are the #1 performance killer. Each sequential await adds full network latency. Eliminating them yields the largest gains.
+
+## 2. Bundle Size Optimization (bundle)
+
+**Impact:** CRITICAL  
+**Description:** Reducing initial bundle size improves Time to Interactive and Largest Contentful Paint.
+
+## 3. Server-Side Performance (server)
+
+**Impact:** HIGH  
+**Description:** Optimizing server-side rendering and data fetching eliminates server-side waterfalls and reduces response times.
+
+## 4. Client-Side Data Fetching (client)
+
+**Impact:** MEDIUM-HIGH  
+**Description:** Automatic deduplication and efficient data fetching patterns reduce redundant network requests.
+
+## 5. Re-render Optimization (rerender)
+
+**Impact:** MEDIUM  
+**Description:** Reducing unnecessary re-renders minimizes wasted computation and improves UI responsiveness.
+
+## 6. Rendering Performance (rendering)
+
+**Impact:** MEDIUM  
+**Description:** Optimizing the rendering process reduces the work the browser needs to do.
+
+## 7. JavaScript Performance (js)
+
+**Impact:** LOW-MEDIUM  
+**Description:** Micro-optimizations for hot paths can add up to meaningful improvements.
+
+## 8. Advanced Patterns (advanced)
+
+**Impact:** LOW  
+**Description:** Advanced patterns for specific cases that require careful implementation.
diff --git a/.agents/skills/react-best-practices/rules/_template.md b/.agents/skills/react-best-practices/rules/_template.md
new file mode 100644
index 0000000..1e9e707
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/_template.md
@@ -0,0 +1,28 @@
+---
+title: Rule Title Here
+impact: MEDIUM
+impactDescription: Optional description of impact (e.g., "20-50% improvement")
+tags: tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: MEDIUM (optional impact description)**
+
+Brief explanation of the rule and why it matters. This should be clear and concise, explaining the performance implications.
+
+**Incorrect (description of what's wrong):**
+
+```typescript
+// Bad code example here
+const bad = example()
+```
+
+**Correct (description of what's right):**
+
+```typescript
+// Good code example here
+const good = example()
+```
+
+Reference: [Link to documentation or resource](https://example.com)
diff --git a/.agents/skills/react-best-practices/rules/advanced-event-handler-refs.md b/.agents/skills/react-best-practices/rules/advanced-event-handler-refs.md
new file mode 100644
index 0000000..97e7ade
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/advanced-event-handler-refs.md
@@ -0,0 +1,55 @@
+---
+title: Store Event Handlers in Refs
+impact: LOW
+impactDescription: stable subscriptions
+tags: advanced, hooks, refs, event-handlers, optimization
+---
+
+## Store Event Handlers in Refs
+
+Store callbacks in refs when used in effects that shouldn't re-subscribe on callback changes.
+
+**Incorrect (re-subscribes on every render):**
+
+```tsx
+function useWindowEvent(event: string, handler: (e) => void) {
+  useEffect(() => {
+    window.addEventListener(event, handler)
+    return () => window.removeEventListener(event, handler)
+  }, [event, handler])
+}
+```
+
+**Correct (stable subscription):**
+
+```tsx
+function useWindowEvent(event: string, handler: (e) => void) {
+  const handlerRef = useRef(handler)
+  useEffect(() => {
+    handlerRef.current = handler
+  }, [handler])
+
+  useEffect(() => {
+    const listener = (e) => handlerRef.current(e)
+    window.addEventListener(event, listener)
+    return () => window.removeEventListener(event, listener)
+  }, [event])
+}
+```
+
+**Alternative: use `useEffectEvent` if you're on latest React:**
+
+```tsx
+import { useEffectEvent } from 'react'
+
+function useWindowEvent(event: string, handler: (e) => void) {
+  const onEvent = useEffectEvent(handler)
+
+  useEffect(() => {
+    window.addEventListener(event, onEvent)
+    return () => window.removeEventListener(event, onEvent)
+  }, [event])
+}
+```
+
+`useEffectEvent` provides a cleaner API for the same pattern: it creates a stable function reference that always calls the latest version of the handler.
diff --git a/.agents/skills/react-best-practices/rules/advanced-init-once.md b/.agents/skills/react-best-practices/rules/advanced-init-once.md
new file mode 100644
index 0000000..73ee38e
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/advanced-init-once.md
@@ -0,0 +1,42 @@
+---
+title: Initialize App Once, Not Per Mount
+impact: LOW-MEDIUM
+impactDescription: avoids duplicate init in development
+tags: initialization, useEffect, app-startup, side-effects
+---
+
+## Initialize App Once, Not Per Mount
+
+Do not put app-wide initialization that must run once per app load inside `useEffect([])` of a component. Components can remount and effects will re-run. Use a module-level guard or top-level init in the entry module instead.
+
+**Incorrect (runs twice in dev, re-runs on remount):**
+
+```tsx
+function Comp() {
+  useEffect(() => {
+    loadFromStorage()
+    checkAuthToken()
+  }, [])
+
+  // ...
+}
+```
+
+**Correct (once per app load):**
+
+```tsx
+let didInit = false
+
+function Comp() {
+  useEffect(() => {
+    if (didInit) return
+    didInit = true
+    loadFromStorage()
+    checkAuthToken()
+  }, [])
+
+  // ...
+}
+```
+
+Reference: [Initializing the application](https://react.dev/learn/you-might-not-need-an-effect#initializing-the-application)
diff --git a/.agents/skills/react-best-practices/rules/advanced-use-latest.md b/.agents/skills/react-best-practices/rules/advanced-use-latest.md
new file mode 100644
index 0000000..9c7cb50
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/advanced-use-latest.md
@@ -0,0 +1,39 @@
+---
+title: useEffectEvent for Stable Callback Refs
+impact: LOW
+impactDescription: prevents effect re-runs
+tags: advanced, hooks, useEffectEvent, refs, optimization
+---
+
+## useEffectEvent for Stable Callback Refs
+
+Access latest values in callbacks without adding them to dependency arrays. Prevents effect re-runs while avoiding stale closures.
+
+**Incorrect (effect re-runs on every callback change):**
+
+```tsx
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearch(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query, onSearch])
+}
+```
+
+**Correct (using React's useEffectEvent):**
+
+```tsx
+import { useEffectEvent } from 'react';
+
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+  const onSearchEvent = useEffectEvent(onSearch)
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearchEvent(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query])
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/async-api-routes.md b/.agents/skills/react-best-practices/rules/async-api-routes.md
new file mode 100644
index 0000000..6feda1e
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/async-api-routes.md
@@ -0,0 +1,38 @@
+---
+title: Prevent Waterfall Chains in API Routes
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: api-routes, server-actions, waterfalls, parallelization
+---
+
+## Prevent Waterfall Chains in API Routes
+
+In API routes and Server Actions, start independent operations immediately, even if you don't await them yet.
+
+**Incorrect (config waits for auth, data waits for both):**
+
+```typescript
+export async function GET(request: Request) {
+  const session = await auth()
+  const config = await fetchConfig()
+  const data = await fetchData(session.user.id)
+  return Response.json({ data, config })
+}
+```
+
+**Correct (auth and config start immediately):**
+
+```typescript
+export async function GET(request: Request) {
+  const sessionPromise = auth()
+  const configPromise = fetchConfig()
+  const session = await sessionPromise
+  const [config, data] = await Promise.all([
+    configPromise,
+    fetchData(session.user.id)
+  ])
+  return Response.json({ data, config })
+}
+```
+
+For operations with more complex dependency chains, use `better-all` to automatically maximize parallelism (see Dependency-Based Parallelization).
diff --git a/.agents/skills/react-best-practices/rules/async-defer-await.md b/.agents/skills/react-best-practices/rules/async-defer-await.md
new file mode 100644
index 0000000..ea7082a
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/async-defer-await.md
@@ -0,0 +1,80 @@
+---
+title: Defer Await Until Needed
+impact: HIGH
+impactDescription: avoids blocking unused code paths
+tags: async, await, conditional, optimization
+---
+
+## Defer Await Until Needed
+
+Move `await` operations into the branches where they're actually used to avoid blocking code paths that don't need them.
+
+**Incorrect (blocks both branches):**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  const userData = await fetchUserData(userId)
+  
+  if (skipProcessing) {
+    // Returns immediately but still waited for userData
+    return { skipped: true }
+  }
+  
+  // Only this branch uses userData
+  return processUserData(userData)
+}
+```
+
+**Correct (only blocks when needed):**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  if (skipProcessing) {
+    // Returns immediately without waiting
+    return { skipped: true }
+  }
+  
+  // Fetch only when needed
+  const userData = await fetchUserData(userId)
+  return processUserData(userData)
+}
+```
+
+**Another example (early return optimization):**
+
+```typescript
+// Incorrect: always fetches permissions
+async function updateResource(resourceId: string, userId: string) {
+  const permissions = await fetchPermissions(userId)
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+
+// Correct: fetches only when needed
+async function updateResource(resourceId: string, userId: string) {
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  const permissions = await fetchPermissions(userId)
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+```
+
+This optimization is especially valuable when the skipped branch is frequently taken, or when the deferred operation is expensive.
diff --git a/.agents/skills/react-best-practices/rules/async-dependencies.md b/.agents/skills/react-best-practices/rules/async-dependencies.md
new file mode 100644
index 0000000..0484eba
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/async-dependencies.md
@@ -0,0 +1,51 @@
+---
+title: Dependency-Based Parallelization
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: async, parallelization, dependencies, better-all
+---
+
+## Dependency-Based Parallelization
+
+For operations with partial dependencies, use `better-all` to maximize parallelism. It automatically starts each task at the earliest possible moment.
+
+**Incorrect (profile waits for config unnecessarily):**
+
+```typescript
+const [user, config] = await Promise.all([
+  fetchUser(),
+  fetchConfig()
+])
+const profile = await fetchProfile(user.id)
+```
+
+**Correct (config and profile run in parallel):**
+
+```typescript
+import { all } from 'better-all'
+
+const { user, config, profile } = await all({
+  async user() { return fetchUser() },
+  async config() { return fetchConfig() },
+  async profile() {
+    return fetchProfile((await this.$.user).id)
+  }
+})
+```
+
+**Alternative without extra dependencies:**
+
+We can also create all the promises first, and do `Promise.all()` at the end.
+
+```typescript
+const userPromise = fetchUser()
+const profilePromise = userPromise.then(user => fetchProfile(user.id))
+
+const [user, config, profile] = await Promise.all([
+  userPromise,
+  fetchConfig(),
+  profilePromise
+])
+```
+
+Reference: [https://github.com/shuding/better-all](https://github.com/shuding/better-all)
diff --git a/.agents/skills/react-best-practices/rules/async-parallel.md b/.agents/skills/react-best-practices/rules/async-parallel.md
new file mode 100644
index 0000000..64133f6
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/async-parallel.md
@@ -0,0 +1,28 @@
+---
+title: Promise.all() for Independent Operations
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: async, parallelization, promises, waterfalls
+---
+
+## Promise.all() for Independent Operations
+
+When async operations have no interdependencies, execute them concurrently using `Promise.all()`.
+
+**Incorrect (sequential execution, 3 round trips):**
+
+```typescript
+const user = await fetchUser()
+const posts = await fetchPosts()
+const comments = await fetchComments()
+```
+
+**Correct (parallel execution, 1 round trip):**
+
+```typescript
+const [user, posts, comments] = await Promise.all([
+  fetchUser(),
+  fetchPosts(),
+  fetchComments()
+])
+```
diff --git a/.agents/skills/react-best-practices/rules/async-suspense-boundaries.md b/.agents/skills/react-best-practices/rules/async-suspense-boundaries.md
new file mode 100644
index 0000000..1fbc05b
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/async-suspense-boundaries.md
@@ -0,0 +1,99 @@
+---
+title: Strategic Suspense Boundaries
+impact: HIGH
+impactDescription: faster initial paint
+tags: async, suspense, streaming, layout-shift
+---
+
+## Strategic Suspense Boundaries
+
+Instead of awaiting data in async components before returning JSX, use Suspense boundaries to show the wrapper UI faster while data loads.
+
+**Incorrect (wrapper blocked by data fetching):**
+
+```tsx
+async function Page() {
+  const data = await fetchData() // Blocks entire page
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <DataDisplay data={data} />
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+```
+
+The entire layout waits for data even though only the middle section needs it.
+
+**Correct (wrapper shows immediately, data streams in):**
+
+```tsx
+function Page() {
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <Suspense fallback={<Skeleton />}>
+          <DataDisplay />
+        </Suspense>
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+async function DataDisplay() {
+  const data = await fetchData() // Only blocks this component
+  return <div>{data.content}</div>
+}
+```
+
+Sidebar, Header, and Footer render immediately. Only DataDisplay waits for data.
+
+**Alternative (share promise across components):**
+
+```tsx
+function Page() {
+  // Start fetch immediately, but don't await
+  const dataPromise = fetchData()
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <Suspense fallback={<Skeleton />}>
+        <DataDisplay dataPromise={dataPromise} />
+        <DataSummary dataPromise={dataPromise} />
+      </Suspense>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+function DataDisplay({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Unwraps the promise
+  return <div>{data.content}</div>
+}
+
+function DataSummary({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Reuses the same promise
+  return <div>{data.summary}</div>
+}
+```
+
+Both components share the same promise, so only one fetch occurs. Layout renders immediately while both components wait together.
+
+**When NOT to use this pattern:**
+
+- Critical data needed for layout decisions (affects positioning)
+- SEO-critical content above the fold
+- Small, fast queries where suspense overhead isn't worth it
+- When you want to avoid layout shift (loading → content jump)
+
+**Trade-off:** Faster initial paint vs potential layout shift. Choose based on your UX priorities.
diff --git a/.agents/skills/react-best-practices/rules/bundle-barrel-imports.md b/.agents/skills/react-best-practices/rules/bundle-barrel-imports.md
new file mode 100644
index 0000000..ee48f32
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/bundle-barrel-imports.md
@@ -0,0 +1,59 @@
+---
+title: Avoid Barrel File Imports
+impact: CRITICAL
+impactDescription: 200-800ms import cost, slow builds
+tags: bundle, imports, tree-shaking, barrel-files, performance
+---
+
+## Avoid Barrel File Imports
+
+Import directly from source files instead of barrel files to avoid loading thousands of unused modules. **Barrel files** are entry points that re-export multiple modules (e.g., `index.js` that does `export * from './module'`).
+
+Popular icon and component libraries can have **up to 10,000 re-exports** in their entry file. For many React packages, **it takes 200-800ms just to import them**, affecting both development speed and production cold starts.
+
+**Why tree-shaking doesn't help:** When a library is marked as external (not bundled), the bundler can't optimize it. If you bundle it to enable tree-shaking, builds become substantially slower analyzing the entire module graph.
+
+**Incorrect (imports entire library):**
+
+```tsx
+import { Check, X, Menu } from 'lucide-react'
+// Loads 1,583 modules, takes ~2.8s extra in dev
+// Runtime cost: 200-800ms on every cold start
+
+import { Button, TextField } from '@mui/material'
+// Loads 2,225 modules, takes ~4.2s extra in dev
+```
+
+**Correct (imports only what you need):**
+
+```tsx
+import Check from 'lucide-react/dist/esm/icons/check'
+import X from 'lucide-react/dist/esm/icons/x'
+import Menu from 'lucide-react/dist/esm/icons/menu'
+// Loads only 3 modules (~2KB vs ~1MB)
+
+import Button from '@mui/material/Button'
+import TextField from '@mui/material/TextField'
+// Loads only what you use
+```
+
+**Alternative (Next.js 13.5+):**
+
+```js
+// next.config.js - use optimizePackageImports
+module.exports = {
+  experimental: {
+    optimizePackageImports: ['lucide-react', '@mui/material']
+  }
+}
+
+// Then you can keep the ergonomic barrel imports:
+import { Check, X, Menu } from 'lucide-react'
+// Automatically transformed to direct imports at build time
+```
+
+Direct imports provide 15-70% faster dev boot, 28% faster builds, 40% faster cold starts, and significantly faster HMR.
+
+Libraries commonly affected: `lucide-react`, `@mui/material`, `@mui/icons-material`, `@tabler/icons-react`, `react-icons`, `@headlessui/react`, `@radix-ui/react-*`, `lodash`, `ramda`, `date-fns`, `rxjs`, `react-use`.
+
+Reference: [How we optimized package imports in Next.js](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
diff --git a/.agents/skills/react-best-practices/rules/bundle-conditional.md b/.agents/skills/react-best-practices/rules/bundle-conditional.md
new file mode 100644
index 0000000..99d6fc9
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/bundle-conditional.md
@@ -0,0 +1,31 @@
+---
+title: Conditional Module Loading
+impact: HIGH
+impactDescription: loads large data only when needed
+tags: bundle, conditional-loading, lazy-loading
+---
+
+## Conditional Module Loading
+
+Load large data or modules only when a feature is activated.
+
+**Example (lazy-load animation frames):**
+
+```tsx
+function AnimationPlayer({ enabled, setEnabled }: { enabled: boolean; setEnabled: React.Dispatch<React.SetStateAction<boolean>> }) {
+  const [frames, setFrames] = useState<Frame[] | null>(null)
+
+  useEffect(() => {
+    if (enabled && !frames && typeof window !== 'undefined') {
+      import('./animation-frames.js')
+        .then(mod => setFrames(mod.frames))
+        .catch(() => setEnabled(false))
+    }
+  }, [enabled, frames, setEnabled])
+
+  if (!frames) return <Skeleton />
+  return <Canvas frames={frames} />
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling this module for SSR, optimizing server bundle size and build speed.
diff --git a/.agents/skills/react-best-practices/rules/bundle-defer-third-party.md b/.agents/skills/react-best-practices/rules/bundle-defer-third-party.md
new file mode 100644
index 0000000..db041d1
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/bundle-defer-third-party.md
@@ -0,0 +1,49 @@
+---
+title: Defer Non-Critical Third-Party Libraries
+impact: MEDIUM
+impactDescription: loads after hydration
+tags: bundle, third-party, analytics, defer
+---
+
+## Defer Non-Critical Third-Party Libraries
+
+Analytics, logging, and error tracking don't block user interaction. Load them after hydration.
+
+**Incorrect (blocks initial bundle):**
+
+```tsx
+import { Analytics } from '@vercel/analytics/react'
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
+
+**Correct (loads after hydration):**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const Analytics = dynamic(
+  () => import('@vercel/analytics/react').then(m => m.Analytics),
+  { ssr: false }
+)
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/bundle-dynamic-imports.md b/.agents/skills/react-best-practices/rules/bundle-dynamic-imports.md
new file mode 100644
index 0000000..60b6269
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/bundle-dynamic-imports.md
@@ -0,0 +1,35 @@
+---
+title: Dynamic Imports for Heavy Components
+impact: CRITICAL
+impactDescription: directly affects TTI and LCP
+tags: bundle, dynamic-import, code-splitting, next-dynamic
+---
+
+## Dynamic Imports for Heavy Components
+
+Use `next/dynamic` to lazy-load large components not needed on initial render.
+
+**Incorrect (Monaco bundles with main chunk ~300KB):**
+
+```tsx
+import { MonacoEditor } from './monaco-editor'
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
+
+**Correct (Monaco loads on demand):**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const MonacoEditor = dynamic(
+  () => import('./monaco-editor').then(m => m.MonacoEditor),
+  { ssr: false }
+)
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/bundle-preload.md b/.agents/skills/react-best-practices/rules/bundle-preload.md
new file mode 100644
index 0000000..7000504
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/bundle-preload.md
@@ -0,0 +1,50 @@
+---
+title: Preload Based on User Intent
+impact: MEDIUM
+impactDescription: reduces perceived latency
+tags: bundle, preload, user-intent, hover
+---
+
+## Preload Based on User Intent
+
+Preload heavy bundles before they're needed to reduce perceived latency.
+
+**Example (preload on hover/focus):**
+
+```tsx
+function EditorButton({ onClick }: { onClick: () => void }) {
+  const preload = () => {
+    if (typeof window !== 'undefined') {
+      void import('./monaco-editor')
+    }
+  }
+
+  return (
+    <button
+      onMouseEnter={preload}
+      onFocus={preload}
+      onClick={onClick}
+    >
+      Open Editor
+    </button>
+  )
+}
+```
+
+**Example (preload when feature flag is enabled):**
+
+```tsx
+function FlagsProvider({ children, flags }: Props) {
+  useEffect(() => {
+    if (flags.editorEnabled && typeof window !== 'undefined') {
+      void import('./monaco-editor').then(mod => mod.init())
+    }
+  }, [flags.editorEnabled])
+
+  return <FlagsContext.Provider value={flags}>
+    {children}
+  </FlagsContext.Provider>
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling preloaded modules for SSR, optimizing server bundle size and build speed.
diff --git a/.agents/skills/react-best-practices/rules/client-event-listeners.md b/.agents/skills/react-best-practices/rules/client-event-listeners.md
new file mode 100644
index 0000000..aad4ae9
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/client-event-listeners.md
@@ -0,0 +1,74 @@
+---
+title: Deduplicate Global Event Listeners
+impact: LOW
+impactDescription: single listener for N components
+tags: client, swr, event-listeners, subscription
+---
+
+## Deduplicate Global Event Listeners
+
+Use `useSWRSubscription()` to share global event listeners across component instances.
+
+**Incorrect (N instances = N listeners):**
+
+```tsx
+function useKeyboardShortcut(key: string, callback: () => void) {
+  useEffect(() => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && e.key === key) {
+        callback()
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  }, [key, callback])
+}
+```
+
+When using the `useKeyboardShortcut` hook multiple times, each instance will register a new listener.
+
+**Correct (N instances = 1 listener):**
+
+```tsx
+import useSWRSubscription from 'swr/subscription'
+
+// Module-level Map to track callbacks per key
+const keyCallbacks = new Map<string, Set<() => void>>()
+
+function useKeyboardShortcut(key: string, callback: () => void) {
+  // Register this callback in the Map
+  useEffect(() => {
+    if (!keyCallbacks.has(key)) {
+      keyCallbacks.set(key, new Set())
+    }
+    keyCallbacks.get(key)!.add(callback)
+
+    return () => {
+      const set = keyCallbacks.get(key)
+      if (set) {
+        set.delete(callback)
+        if (set.size === 0) {
+          keyCallbacks.delete(key)
+        }
+      }
+    }
+  }, [key, callback])
+
+  useSWRSubscription('global-keydown', () => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && keyCallbacks.has(e.key)) {
+        keyCallbacks.get(e.key)!.forEach(cb => cb())
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  })
+}
+
+function Profile() {
+  // Multiple shortcuts will share the same listener
+  useKeyboardShortcut('p', () => { /* ... */ }) 
+  useKeyboardShortcut('k', () => { /* ... */ })
+  // ...
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/client-localstorage-schema.md b/.agents/skills/react-best-practices/rules/client-localstorage-schema.md
new file mode 100644
index 0000000..d30a1a7
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/client-localstorage-schema.md
@@ -0,0 +1,71 @@
+---
+title: Version and Minimize localStorage Data
+impact: MEDIUM
+impactDescription: prevents schema conflicts, reduces storage size
+tags: client, localStorage, storage, versioning, data-minimization
+---
+
+## Version and Minimize localStorage Data
+
+Add version prefix to keys and store only needed fields. Prevents schema conflicts and accidental storage of sensitive data.
+
+**Incorrect:**
+
+```typescript
+// No version, stores everything, no error handling
+localStorage.setItem('userConfig', JSON.stringify(fullUserObject))
+const data = localStorage.getItem('userConfig')
+```
+
+**Correct:**
+
+```typescript
+const VERSION = 'v2'
+
+function saveConfig(config: { theme: string; language: string }) {
+  try {
+    localStorage.setItem(`userConfig:${VERSION}`, JSON.stringify(config))
+  } catch {
+    // Throws in incognito/private browsing, quota exceeded, or disabled
+  }
+}
+
+function loadConfig() {
+  try {
+    const data = localStorage.getItem(`userConfig:${VERSION}`)
+    return data ? JSON.parse(data) : null
+  } catch {
+    return null
+  }
+}
+
+// Migration from v1 to v2
+function migrate() {
+  try {
+    const v1 = localStorage.getItem('userConfig:v1')
+    if (v1) {
+      const old = JSON.parse(v1)
+      saveConfig({ theme: old.darkMode ? 'dark' : 'light', language: old.lang })
+      localStorage.removeItem('userConfig:v1')
+    }
+  } catch {}
+}
+```
+
+**Store minimal fields from server responses:**
+
+```typescript
+// User object has 20+ fields, only store what UI needs
+function cachePrefs(user: FullUser) {
+  try {
+    localStorage.setItem('prefs:v1', JSON.stringify({
+      theme: user.preferences.theme,
+      notifications: user.preferences.notifications
+    }))
+  } catch {}
+}
+```
+
+**Always wrap in try-catch:** `getItem()` and `setItem()` throw in incognito/private browsing (Safari, Firefox), when quota exceeded, or when disabled.
+
+**Benefits:** Schema evolution via versioning, reduced storage size, prevents storing tokens/PII/internal flags.
diff --git a/.agents/skills/react-best-practices/rules/client-passive-event-listeners.md b/.agents/skills/react-best-practices/rules/client-passive-event-listeners.md
new file mode 100644
index 0000000..ce39a88
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/client-passive-event-listeners.md
@@ -0,0 +1,48 @@
+---
+title: Use Passive Event Listeners for Scrolling Performance
+impact: MEDIUM
+impactDescription: eliminates scroll delay caused by event listeners
+tags: client, event-listeners, scrolling, performance, touch, wheel
+---
+
+## Use Passive Event Listeners for Scrolling Performance
+
+Add `{ passive: true }` to touch and wheel event listeners to enable immediate scrolling. Browsers normally wait for listeners to finish to check if `preventDefault()` is called, causing scroll delay.
+
+**Incorrect:**
+
+```typescript
+useEffect(() => {
+  const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
+  const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
+  
+  document.addEventListener('touchstart', handleTouch)
+  document.addEventListener('wheel', handleWheel)
+  
+  return () => {
+    document.removeEventListener('touchstart', handleTouch)
+    document.removeEventListener('wheel', handleWheel)
+  }
+}, [])
+```
+
+**Correct:**
+
+```typescript
+useEffect(() => {
+  const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
+  const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
+  
+  document.addEventListener('touchstart', handleTouch, { passive: true })
+  document.addEventListener('wheel', handleWheel, { passive: true })
+  
+  return () => {
+    document.removeEventListener('touchstart', handleTouch)
+    document.removeEventListener('wheel', handleWheel)
+  }
+}, [])
+```
+
+**Use passive when:** tracking/analytics, logging, any listener that doesn't call `preventDefault()`.
+
+**Don't use passive when:** implementing custom swipe gestures, custom zoom controls, or any listener that needs `preventDefault()`.
diff --git a/.agents/skills/react-best-practices/rules/client-swr-dedup.md b/.agents/skills/react-best-practices/rules/client-swr-dedup.md
new file mode 100644
index 0000000..2a430f2
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/client-swr-dedup.md
@@ -0,0 +1,56 @@
+---
+title: Use SWR for Automatic Deduplication
+impact: MEDIUM-HIGH
+impactDescription: automatic deduplication
+tags: client, swr, deduplication, data-fetching
+---
+
+## Use SWR for Automatic Deduplication
+
+SWR enables request deduplication, caching, and revalidation across component instances.
+
+**Incorrect (no deduplication, each instance fetches):**
+
+```tsx
+function UserList() {
+  const [users, setUsers] = useState([])
+  useEffect(() => {
+    fetch('/api/users')
+      .then(r => r.json())
+      .then(setUsers)
+  }, [])
+}
+```
+
+**Correct (multiple instances share one request):**
+
+```tsx
+import useSWR from 'swr'
+
+function UserList() {
+  const { data: users } = useSWR('/api/users', fetcher)
+}
+```
+
+**For immutable data:**
+
+```tsx
+import { useImmutableSWR } from '@/lib/swr'
+
+function StaticContent() {
+  const { data } = useImmutableSWR('/api/config', fetcher)
+}
+```
+
+**For mutations:**
+
+```tsx
+import { useSWRMutation } from 'swr/mutation'
+
+function UpdateButton() {
+  const { trigger } = useSWRMutation('/api/user', updateUser)
+  return <button onClick={() => trigger()}>Update</button>
+}
+```
+
+Reference: [https://swr.vercel.app](https://swr.vercel.app)
diff --git a/.agents/skills/react-best-practices/rules/js-batch-dom-css.md b/.agents/skills/react-best-practices/rules/js-batch-dom-css.md
new file mode 100644
index 0000000..a62d84e
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-batch-dom-css.md
@@ -0,0 +1,107 @@
+---
+title: Avoid Layout Thrashing
+impact: MEDIUM
+impactDescription: prevents forced synchronous layouts and reduces performance bottlenecks
+tags: javascript, dom, css, performance, reflow, layout-thrashing
+---
+
+## Avoid Layout Thrashing
+
+Avoid interleaving style writes with layout reads. When you read a layout property (like `offsetWidth`, `getBoundingClientRect()`, or `getComputedStyle()`) between style changes, the browser is forced to trigger a synchronous reflow.
+
+**This is OK (browser batches style changes):**
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  // Each line invalidates style, but browser batches the recalculation
+  element.style.width = '100px'
+  element.style.height = '200px'
+  element.style.backgroundColor = 'blue'
+  element.style.border = '1px solid black'
+}
+```
+
+**Incorrect (interleaved reads and writes force reflows):**
+```typescript
+function layoutThrashing(element: HTMLElement) {
+  element.style.width = '100px'
+  const width = element.offsetWidth  // Forces reflow
+  element.style.height = '200px'
+  const height = element.offsetHeight  // Forces another reflow
+}
+```
+
+**Correct (batch writes, then read once):**
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  // Batch all writes together
+  element.style.width = '100px'
+  element.style.height = '200px'
+  element.style.backgroundColor = 'blue'
+  element.style.border = '1px solid black'
+  
+  // Read after all writes are done (single reflow)
+  const { width, height } = element.getBoundingClientRect()
+}
+```
+
+**Correct (batch reads, then writes):**
+```typescript
+function avoidThrashing(element: HTMLElement) {
+  // Read phase - all layout queries first
+  const rect1 = element.getBoundingClientRect()
+  const offsetWidth = element.offsetWidth
+  const offsetHeight = element.offsetHeight
+  
+  // Write phase - all style changes after
+  element.style.width = '100px'
+  element.style.height = '200px'
+}
+```
+
+**Better: use CSS classes**
+```css
+.highlighted-box {
+  width: 100px;
+  height: 200px;
+  background-color: blue;
+  border: 1px solid black;
+}
+```
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  element.classList.add('highlighted-box')
+  
+  const { width, height } = element.getBoundingClientRect()
+}
+```
+
+**React example:**
+```tsx
+// Incorrect: interleaving style changes with layout queries
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  const ref = useRef<HTMLDivElement>(null)
+  
+  useEffect(() => {
+    if (ref.current && isHighlighted) {
+      ref.current.style.width = '100px'
+      const width = ref.current.offsetWidth // Forces layout
+      ref.current.style.height = '200px'
+    }
+  }, [isHighlighted])
+  
+  return <div ref={ref}>Content</div>
+}
+
+// Correct: toggle class
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  return (
+    <div className={isHighlighted ? 'highlighted-box' : ''}>
+      Content
+    </div>
+  )
+}
+```
+
+Prefer CSS classes over inline styles when possible. CSS files are cached by the browser, and classes provide better separation of concerns and are easier to maintain.
+
+See [this gist](https://gist.github.com/paulirish/5d52fb081b3570c81e3a) and [CSS Triggers](https://csstriggers.com/) for more information on layout-forcing operations.
diff --git a/.agents/skills/react-best-practices/rules/js-cache-function-results.md b/.agents/skills/react-best-practices/rules/js-cache-function-results.md
new file mode 100644
index 0000000..180f8ac
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-cache-function-results.md
@@ -0,0 +1,80 @@
+---
+title: Cache Repeated Function Calls
+impact: MEDIUM
+impactDescription: avoid redundant computation
+tags: javascript, cache, memoization, performance
+---
+
+## Cache Repeated Function Calls
+
+Use a module-level Map to cache function results when the same function is called repeatedly with the same inputs during render.
+
+**Incorrect (redundant computation):**
+
+```typescript
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // slugify() called 100+ times for same project names
+        const slug = slugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Correct (cached results):**
+
+```typescript
+// Module-level cache
+const slugifyCache = new Map<string, string>()
+
+function cachedSlugify(text: string): string {
+  if (slugifyCache.has(text)) {
+    return slugifyCache.get(text)!
+  }
+  const result = slugify(text)
+  slugifyCache.set(text, result)
+  return result
+}
+
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // Computed only once per unique project name
+        const slug = cachedSlugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Simpler pattern for single-value functions:**
+
+```typescript
+let isLoggedInCache: boolean | null = null
+
+function isLoggedIn(): boolean {
+  if (isLoggedInCache !== null) {
+    return isLoggedInCache
+  }
+  
+  isLoggedInCache = document.cookie.includes('auth=')
+  return isLoggedInCache
+}
+
+// Clear cache when auth changes
+function onAuthChange() {
+  isLoggedInCache = null
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+Reference: [How we made the Vercel Dashboard twice as fast](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
diff --git a/.agents/skills/react-best-practices/rules/js-cache-property-access.md b/.agents/skills/react-best-practices/rules/js-cache-property-access.md
new file mode 100644
index 0000000..39eec90
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-cache-property-access.md
@@ -0,0 +1,28 @@
+---
+title: Cache Property Access in Loops
+impact: LOW-MEDIUM
+impactDescription: reduces lookups
+tags: javascript, loops, optimization, caching
+---
+
+## Cache Property Access in Loops
+
+Cache object property lookups in hot paths.
+
+**Incorrect (3 lookups × N iterations):**
+
+```typescript
+for (let i = 0; i < arr.length; i++) {
+  process(obj.config.settings.value)
+}
+```
+
+**Correct (1 lookup total):**
+
+```typescript
+const value = obj.config.settings.value
+const len = arr.length
+for (let i = 0; i < len; i++) {
+  process(value)
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/js-cache-storage.md b/.agents/skills/react-best-practices/rules/js-cache-storage.md
new file mode 100644
index 0000000..aa4a30c
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-cache-storage.md
@@ -0,0 +1,70 @@
+---
+title: Cache Storage API Calls
+impact: LOW-MEDIUM
+impactDescription: reduces expensive I/O
+tags: javascript, localStorage, storage, caching, performance
+---
+
+## Cache Storage API Calls
+
+`localStorage`, `sessionStorage`, and `document.cookie` are synchronous and expensive. Cache reads in memory.
+
+**Incorrect (reads storage on every call):**
+
+```typescript
+function getTheme() {
+  return localStorage.getItem('theme') ?? 'light'
+}
+// Called 10 times = 10 storage reads
+```
+
+**Correct (Map cache):**
+
+```typescript
+const storageCache = new Map<string, string | null>()
+
+function getLocalStorage(key: string) {
+  if (!storageCache.has(key)) {
+    storageCache.set(key, localStorage.getItem(key))
+  }
+  return storageCache.get(key)
+}
+
+function setLocalStorage(key: string, value: string) {
+  localStorage.setItem(key, value)
+  storageCache.set(key, value)  // keep cache in sync
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+**Cookie caching:**
+
+```typescript
+let cookieCache: Record<string, string> | null = null
+
+function getCookie(name: string) {
+  if (!cookieCache) {
+    cookieCache = Object.fromEntries(
+      document.cookie.split('; ').map(c => c.split('='))
+    )
+  }
+  return cookieCache[name]
+}
+```
+
+**Important (invalidate on external changes):**
+
+If storage can change externally (another tab, server-set cookies), invalidate cache:
+
+```typescript
+window.addEventListener('storage', (e) => {
+  if (e.key) storageCache.delete(e.key)
+})
+
+document.addEventListener('visibilitychange', () => {
+  if (document.visibilityState === 'visible') {
+    storageCache.clear()
+  }
+})
+```
diff --git a/.agents/skills/react-best-practices/rules/js-combine-iterations.md b/.agents/skills/react-best-practices/rules/js-combine-iterations.md
new file mode 100644
index 0000000..044d017
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-combine-iterations.md
@@ -0,0 +1,32 @@
+---
+title: Combine Multiple Array Iterations
+impact: LOW-MEDIUM
+impactDescription: reduces iterations
+tags: javascript, arrays, loops, performance
+---
+
+## Combine Multiple Array Iterations
+
+Multiple `.filter()` or `.map()` calls iterate the array multiple times. Combine into one loop.
+
+**Incorrect (3 iterations):**
+
+```typescript
+const admins = users.filter(u => u.isAdmin)
+const testers = users.filter(u => u.isTester)
+const inactive = users.filter(u => !u.isActive)
+```
+
+**Correct (1 iteration):**
+
+```typescript
+const admins: User[] = []
+const testers: User[] = []
+const inactive: User[] = []
+
+for (const user of users) {
+  if (user.isAdmin) admins.push(user)
+  if (user.isTester) testers.push(user)
+  if (!user.isActive) inactive.push(user)
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/js-early-exit.md b/.agents/skills/react-best-practices/rules/js-early-exit.md
new file mode 100644
index 0000000..f46cb89
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-early-exit.md
@@ -0,0 +1,50 @@
+---
+title: Early Return from Functions
+impact: LOW-MEDIUM
+impactDescription: avoids unnecessary computation
+tags: javascript, functions, optimization, early-return
+---
+
+## Early Return from Functions
+
+Return early when result is determined to skip unnecessary processing.
+
+**Incorrect (processes all items even after finding answer):**
+
+```typescript
+function validateUsers(users: User[]) {
+  let hasError = false
+  let errorMessage = ''
+  
+  for (const user of users) {
+    if (!user.email) {
+      hasError = true
+      errorMessage = 'Email required'
+    }
+    if (!user.name) {
+      hasError = true
+      errorMessage = 'Name required'
+    }
+    // Continues checking all users even after error found
+  }
+  
+  return hasError ? { valid: false, error: errorMessage } : { valid: true }
+}
+```
+
+**Correct (returns immediately on first error):**
+
+```typescript
+function validateUsers(users: User[]) {
+  for (const user of users) {
+    if (!user.email) {
+      return { valid: false, error: 'Email required' }
+    }
+    if (!user.name) {
+      return { valid: false, error: 'Name required' }
+    }
+  }
+
+  return { valid: true }
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/js-hoist-regexp.md b/.agents/skills/react-best-practices/rules/js-hoist-regexp.md
new file mode 100644
index 0000000..dae3fef
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-hoist-regexp.md
@@ -0,0 +1,45 @@
+---
+title: Hoist RegExp Creation
+impact: LOW-MEDIUM
+impactDescription: avoids recreation
+tags: javascript, regexp, optimization, memoization
+---
+
+## Hoist RegExp Creation
+
+Don't create RegExp inside render. Hoist to module scope or memoize with `useMemo()`.
+
+**Incorrect (new RegExp every render):**
+
+```tsx
+function Highlighter({ text, query }: Props) {
+  const regex = new RegExp(`(${query})`, 'gi')
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Correct (memoize or hoist):**
+
+```tsx
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+
+function Highlighter({ text, query }: Props) {
+  const regex = useMemo(
+    () => new RegExp(`(${escapeRegex(query)})`, 'gi'),
+    [query]
+  )
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Warning (global regex has mutable state):**
+
+Global regex (`/g`) has mutable `lastIndex` state:
+
+```typescript
+const regex = /foo/g
+regex.test('foo')  // true, lastIndex = 3
+regex.test('foo')  // false, lastIndex = 0
+```
diff --git a/.agents/skills/react-best-practices/rules/js-index-maps.md b/.agents/skills/react-best-practices/rules/js-index-maps.md
new file mode 100644
index 0000000..9d357a0
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-index-maps.md
@@ -0,0 +1,37 @@
+---
+title: Build Index Maps for Repeated Lookups
+impact: LOW-MEDIUM
+impactDescription: 1M ops to 2K ops
+tags: javascript, map, indexing, optimization, performance
+---
+
+## Build Index Maps for Repeated Lookups
+
+Multiple `.find()` calls by the same key should use a Map.
+
+**Incorrect (O(n) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  return orders.map(order => ({
+    ...order,
+    user: users.find(u => u.id === order.userId)
+  }))
+}
+```
+
+**Correct (O(1) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  const userById = new Map(users.map(u => [u.id, u]))
+
+  return orders.map(order => ({
+    ...order,
+    user: userById.get(order.userId)
+  }))
+}
+```
+
+Build map once (O(n)), then all lookups are O(1).
+For 1000 orders × 1000 users: 1M ops → 2K ops.
diff --git a/.agents/skills/react-best-practices/rules/js-length-check-first.md b/.agents/skills/react-best-practices/rules/js-length-check-first.md
new file mode 100644
index 0000000..8b89573
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-length-check-first.md
@@ -0,0 +1,49 @@
+---
+title: Early Length Check for Array Comparisons
+impact: MEDIUM-HIGH
+impactDescription: avoids expensive operations when lengths differ
+tags: javascript, arrays, performance, optimization, comparison
+---
+
+## Early Length Check for Array Comparisons
+
+When comparing arrays with expensive operations (sorting, deep equality, serialization), check lengths first. If lengths differ, the arrays cannot be equal.
+
+In real-world applications, this optimization is especially valuable when the comparison runs in hot paths (event handlers, render loops).
+
+**Incorrect (always runs expensive comparison):**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Always sorts and joins, even when lengths differ
+  return current.sort().join() !== original.sort().join()
+}
+```
+
+Two O(n log n) sorts run even when `current.length` is 5 and `original.length` is 100. There is also overhead of joining the arrays and comparing the strings.
+
+**Correct (O(1) length check first):**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Early return if lengths differ
+  if (current.length !== original.length) {
+    return true
+  }
+  // Only sort when lengths match
+  const currentSorted = current.toSorted()
+  const originalSorted = original.toSorted()
+  for (let i = 0; i < currentSorted.length; i++) {
+    if (currentSorted[i] !== originalSorted[i]) {
+      return true
+    }
+  }
+  return false
+}
+```
+
+This new approach is more efficient because:
+- It avoids the overhead of sorting and joining the arrays when lengths differ
+- It avoids consuming memory for the joined strings (especially important for large arrays)
+- It avoids mutating the original arrays
+- It returns early when a difference is found
diff --git a/.agents/skills/react-best-practices/rules/js-min-max-loop.md b/.agents/skills/react-best-practices/rules/js-min-max-loop.md
new file mode 100644
index 0000000..4b6656e
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-min-max-loop.md
@@ -0,0 +1,82 @@
+---
+title: Use Loop for Min/Max Instead of Sort
+impact: LOW
+impactDescription: O(n) instead of O(n log n)
+tags: javascript, arrays, performance, sorting, algorithms
+---
+
+## Use Loop for Min/Max Instead of Sort
+
+Finding the smallest or largest element only requires a single pass through the array. Sorting is wasteful and slower.
+
+**Incorrect (O(n log n) - sort to find latest):**
+
+```typescript
+interface Project {
+  id: string
+  name: string
+  updatedAt: number
+}
+
+function getLatestProject(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => b.updatedAt - a.updatedAt)
+  return sorted[0]
+}
+```
+
+Sorts the entire array just to find the maximum value.
+
+**Incorrect (O(n log n) - sort for oldest and newest):**
+
+```typescript
+function getOldestAndNewest(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => a.updatedAt - b.updatedAt)
+  return { oldest: sorted[0], newest: sorted[sorted.length - 1] }
+}
+```
+
+Still sorts unnecessarily when only min/max are needed.
+
+**Correct (O(n) - single loop):**
+
+```typescript
+function getLatestProject(projects: Project[]) {
+  if (projects.length === 0) return null
+  
+  let latest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt > latest.updatedAt) {
+      latest = projects[i]
+    }
+  }
+  
+  return latest
+}
+
+function getOldestAndNewest(projects: Project[]) {
+  if (projects.length === 0) return { oldest: null, newest: null }
+  
+  let oldest = projects[0]
+  let newest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt < oldest.updatedAt) oldest = projects[i]
+    if (projects[i].updatedAt > newest.updatedAt) newest = projects[i]
+  }
+  
+  return { oldest, newest }
+}
+```
+
+Single pass through the array, no copying, no sorting.
+
+**Alternative (Math.min/Math.max for small arrays):**
+
+```typescript
+const numbers = [5, 2, 8, 1, 9]
+const min = Math.min(...numbers)
+const max = Math.max(...numbers)
+```
+
+This works for small arrays, but can be slower or just throw an error for very large arrays due to spread operator limitations. Maximal array length is approximately 124000 in Chrome 143 and 638000 in Safari 18; exact numbers may vary - see [the fiddle](https://jsfiddle.net/qw1jabsx/4/). Use the loop approach for reliability.
diff --git a/.agents/skills/react-best-practices/rules/js-set-map-lookups.md b/.agents/skills/react-best-practices/rules/js-set-map-lookups.md
new file mode 100644
index 0000000..680a489
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-set-map-lookups.md
@@ -0,0 +1,24 @@
+---
+title: Use Set/Map for O(1) Lookups
+impact: LOW-MEDIUM
+impactDescription: O(n) to O(1)
+tags: javascript, set, map, data-structures, performance
+---
+
+## Use Set/Map for O(1) Lookups
+
+Convert arrays to Set/Map for repeated membership checks.
+
+**Incorrect (O(n) per check):**
+
+```typescript
+const allowedIds = ['a', 'b', 'c', ...]
+items.filter(item => allowedIds.includes(item.id))
+```
+
+**Correct (O(1) per check):**
+
+```typescript
+const allowedIds = new Set(['a', 'b', 'c', ...])
+items.filter(item => allowedIds.has(item.id))
+```
diff --git a/.agents/skills/react-best-practices/rules/js-tosorted-immutable.md b/.agents/skills/react-best-practices/rules/js-tosorted-immutable.md
new file mode 100644
index 0000000..eae8b3f
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/js-tosorted-immutable.md
@@ -0,0 +1,57 @@
+---
+title: Use toSorted() Instead of sort() for Immutability
+impact: MEDIUM-HIGH
+impactDescription: prevents mutation bugs in React state
+tags: javascript, arrays, immutability, react, state, mutation
+---
+
+## Use toSorted() Instead of sort() for Immutability
+
+`.sort()` mutates the array in place, which can cause bugs with React state and props. Use `.toSorted()` to create a new sorted array without mutation.
+
+**Incorrect (mutates original array):**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Mutates the users prop array!
+  const sorted = useMemo(
+    () => users.sort((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Correct (creates new array):**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Creates new sorted array, original unchanged
+  const sorted = useMemo(
+    () => users.toSorted((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Why this matters in React:**
+
+1. Props/state mutations break React's immutability model - React expects props and state to be treated as read-only
+2. Causes stale closure bugs - Mutating arrays inside closures (callbacks, effects) can lead to unexpected behavior
+
+**Browser support (fallback for older browsers):**
+
+`.toSorted()` is available in all modern browsers (Chrome 110+, Safari 16+, Firefox 115+, Node.js 20+). For older environments, use spread operator:
+
+```typescript
+// Fallback for older browsers
+const sorted = [...items].sort((a, b) => a.value - b.value)
+```
+
+**Other immutable array methods:**
+
+- `.toSorted()` - immutable sort
+- `.toReversed()` - immutable reverse
+- `.toSpliced()` - immutable splice
+- `.with()` - immutable element replacement
diff --git a/.agents/skills/react-best-practices/rules/rendering-activity.md b/.agents/skills/react-best-practices/rules/rendering-activity.md
new file mode 100644
index 0000000..c957a49
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-activity.md
@@ -0,0 +1,26 @@
+---
+title: Use Activity Component for Show/Hide
+impact: MEDIUM
+impactDescription: preserves state/DOM
+tags: rendering, activity, visibility, state-preservation
+---
+
+## Use Activity Component for Show/Hide
+
+Use React's `<Activity>` to preserve state/DOM for expensive components that frequently toggle visibility.
+
+**Usage:**
+
+```tsx
+import { Activity } from 'react'
+
+function Dropdown({ isOpen }: Props) {
+  return (
+    <Activity mode={isOpen ? 'visible' : 'hidden'}>
+      <ExpensiveMenu />
+    </Activity>
+  )
+}
+```
+
+Avoids expensive re-renders and state loss.
diff --git a/.agents/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md b/.agents/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md
new file mode 100644
index 0000000..646744c
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md
@@ -0,0 +1,47 @@
+---
+title: Animate SVG Wrapper Instead of SVG Element
+impact: LOW
+impactDescription: enables hardware acceleration
+tags: rendering, svg, css, animation, performance
+---
+
+## Animate SVG Wrapper Instead of SVG Element
+
+Many browsers don't have hardware acceleration for CSS3 animations on SVG elements. Wrap SVG in a `<div>` and animate the wrapper instead.
+
+**Incorrect (animating SVG directly - no hardware acceleration):**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <svg 
+      className="animate-spin"
+      width="24" 
+      height="24" 
+      viewBox="0 0 24 24"
+    >
+      <circle cx="12" cy="12" r="10" stroke="currentColor" />
+    </svg>
+  )
+}
+```
+
+**Correct (animating wrapper div - hardware accelerated):**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <div className="animate-spin">
+      <svg 
+        width="24" 
+        height="24" 
+        viewBox="0 0 24 24"
+      >
+        <circle cx="12" cy="12" r="10" stroke="currentColor" />
+      </svg>
+    </div>
+  )
+}
+```
+
+This applies to all CSS transforms and transitions (`transform`, `opacity`, `translate`, `scale`, `rotate`). The wrapper div allows browsers to use GPU acceleration for smoother animations.
diff --git a/.agents/skills/react-best-practices/rules/rendering-conditional-render.md b/.agents/skills/react-best-practices/rules/rendering-conditional-render.md
new file mode 100644
index 0000000..7e866f5
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-conditional-render.md
@@ -0,0 +1,40 @@
+---
+title: Use Explicit Conditional Rendering
+impact: LOW
+impactDescription: prevents rendering 0 or NaN
+tags: rendering, conditional, jsx, falsy-values
+---
+
+## Use Explicit Conditional Rendering
+
+Use explicit ternary operators (`? :`) instead of `&&` for conditional rendering when the condition can be `0`, `NaN`, or other falsy values that render.
+
+**Incorrect (renders "0" when count is 0):**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count && <span className="badge">{count}</span>}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div>0</div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
+
+**Correct (renders nothing when count is 0):**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count > 0 ? <span className="badge">{count}</span> : null}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div></div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
diff --git a/.agents/skills/react-best-practices/rules/rendering-content-visibility.md b/.agents/skills/react-best-practices/rules/rendering-content-visibility.md
new file mode 100644
index 0000000..aa66563
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-content-visibility.md
@@ -0,0 +1,38 @@
+---
+title: CSS content-visibility for Long Lists
+impact: HIGH
+impactDescription: faster initial render
+tags: rendering, css, content-visibility, long-lists
+---
+
+## CSS content-visibility for Long Lists
+
+Apply `content-visibility: auto` to defer off-screen rendering.
+
+**CSS:**
+
+```css
+.message-item {
+  content-visibility: auto;
+  contain-intrinsic-size: 0 80px;
+}
+```
+
+**Example:**
+
+```tsx
+function MessageList({ messages }: { messages: Message[] }) {
+  return (
+    <div className="overflow-y-auto h-screen">
+      {messages.map(msg => (
+        <div key={msg.id} className="message-item">
+          <Avatar user={msg.author} />
+          <div>{msg.content}</div>
+        </div>
+      ))}
+    </div>
+  )
+}
+```
+
+For 1000 messages, browser skips layout/paint for ~990 off-screen items (10× faster initial render).
diff --git a/.agents/skills/react-best-practices/rules/rendering-hoist-jsx.md b/.agents/skills/react-best-practices/rules/rendering-hoist-jsx.md
new file mode 100644
index 0000000..32d2f3f
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-hoist-jsx.md
@@ -0,0 +1,46 @@
+---
+title: Hoist Static JSX Elements
+impact: LOW
+impactDescription: avoids re-creation
+tags: rendering, jsx, static, optimization
+---
+
+## Hoist Static JSX Elements
+
+Extract static JSX outside components to avoid re-creation.
+
+**Incorrect (recreates element every render):**
+
+```tsx
+function LoadingSkeleton() {
+  return <div className="animate-pulse h-20 bg-gray-200" />
+}
+
+function Container() {
+  return (
+    <div>
+      {loading && <LoadingSkeleton />}
+    </div>
+  )
+}
+```
+
+**Correct (reuses same element):**
+
+```tsx
+const loadingSkeleton = (
+  <div className="animate-pulse h-20 bg-gray-200" />
+)
+
+function Container() {
+  return (
+    <div>
+      {loading && loadingSkeleton}
+    </div>
+  )
+}
+```
+
+This is especially helpful for large and static SVG nodes, which can be expensive to recreate on every render.
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler automatically hoists static JSX elements and optimizes component re-renders, making manual hoisting unnecessary.
diff --git a/.agents/skills/react-best-practices/rules/rendering-hydration-no-flicker.md b/.agents/skills/react-best-practices/rules/rendering-hydration-no-flicker.md
new file mode 100644
index 0000000..5cf0e79
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-hydration-no-flicker.md
@@ -0,0 +1,82 @@
+---
+title: Prevent Hydration Mismatch Without Flickering
+impact: MEDIUM
+impactDescription: avoids visual flicker and hydration errors
+tags: rendering, ssr, hydration, localStorage, flicker
+---
+
+## Prevent Hydration Mismatch Without Flickering
+
+When rendering content that depends on client-side storage (localStorage, cookies), avoid both SSR breakage and post-hydration flickering by injecting a synchronous script that updates the DOM before React hydrates.
+
+**Incorrect (breaks SSR):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  // localStorage is not available on server - throws error
+  const theme = localStorage.getItem('theme') || 'light'
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Server-side rendering will fail because `localStorage` is undefined.
+
+**Incorrect (visual flickering):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  const [theme, setTheme] = useState('light')
+  
+  useEffect(() => {
+    // Runs after hydration - causes visible flash
+    const stored = localStorage.getItem('theme')
+    if (stored) {
+      setTheme(stored)
+    }
+  }, [])
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Component first renders with default value (`light`), then updates after hydration, causing a visible flash of incorrect content.
+
+**Correct (no flicker, no hydration mismatch):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  return (
+    <>
+      <div id="theme-wrapper">
+        {children}
+      </div>
+      <script
+        dangerouslySetInnerHTML={{
+          __html: `
+            (function() {
+              try {
+                var theme = localStorage.getItem('theme') || 'light';
+                var el = document.getElementById('theme-wrapper');
+                if (el) el.className = theme;
+              } catch (e) {}
+            })();
+          `,
+        }}
+      />
+    </>
+  )
+}
+```
+
+The inline script executes synchronously before showing the element, ensuring the DOM already has the correct value. No flickering, no hydration mismatch.
+
+This pattern is especially useful for theme toggles, user preferences, authentication states, and any client-only data that should render immediately without flashing default values.
diff --git a/.agents/skills/react-best-practices/rules/rendering-hydration-suppress-warning.md b/.agents/skills/react-best-practices/rules/rendering-hydration-suppress-warning.md
new file mode 100644
index 0000000..24ba251
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-hydration-suppress-warning.md
@@ -0,0 +1,30 @@
+---
+title: Suppress Expected Hydration Mismatches
+impact: LOW-MEDIUM
+impactDescription: avoids noisy hydration warnings for known differences
+tags: rendering, hydration, ssr, nextjs
+---
+
+## Suppress Expected Hydration Mismatches
+
+In SSR frameworks (e.g., Next.js), some values are intentionally different on server vs client (random IDs, dates, locale/timezone formatting). For these *expected* mismatches, wrap the dynamic text in an element with `suppressHydrationWarning` to prevent noisy warnings. Do not use this to hide real bugs. Don’t overuse it.
+
+**Incorrect (known mismatch warnings):**
+
+```tsx
+function Timestamp() {
+  return <span>{new Date().toLocaleString()}</span>
+}
+```
+
+**Correct (suppress expected mismatch only):**
+
+```tsx
+function Timestamp() {
+  return (
+    <span suppressHydrationWarning>
+      {new Date().toLocaleString()}
+    </span>
+  )
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/rendering-svg-precision.md b/.agents/skills/react-best-practices/rules/rendering-svg-precision.md
new file mode 100644
index 0000000..6d77128
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-svg-precision.md
@@ -0,0 +1,28 @@
+---
+title: Optimize SVG Precision
+impact: LOW
+impactDescription: reduces file size
+tags: rendering, svg, optimization, svgo
+---
+
+## Optimize SVG Precision
+
+Reduce SVG coordinate precision to decrease file size. The optimal precision depends on the viewBox size, but in general reducing precision should be considered.
+
+**Incorrect (excessive precision):**
+
+```svg
+<path d="M 10.293847 20.847362 L 30.938472 40.192837" />
+```
+
+**Correct (1 decimal place):**
+
+```svg
+<path d="M 10.3 20.8 L 30.9 40.2" />
+```
+
+**Automate with SVGO:**
+
+```bash
+npx svgo --precision=1 --multipass icon.svg
+```
diff --git a/.agents/skills/react-best-practices/rules/rendering-usetransition-loading.md b/.agents/skills/react-best-practices/rules/rendering-usetransition-loading.md
new file mode 100644
index 0000000..0c1b0b9
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rendering-usetransition-loading.md
@@ -0,0 +1,75 @@
+---
+title: Use useTransition Over Manual Loading States
+impact: LOW
+impactDescription: reduces re-renders and improves code clarity
+tags: rendering, transitions, useTransition, loading, state
+---
+
+## Use useTransition Over Manual Loading States
+
+Use `useTransition` instead of manual `useState` for loading states. This provides built-in `isPending` state and automatically manages transitions.
+
+**Incorrect (manual loading state):**
+
+```tsx
+function SearchResults() {
+  const [query, setQuery] = useState('')
+  const [results, setResults] = useState([])
+  const [isLoading, setIsLoading] = useState(false)
+
+  const handleSearch = async (value: string) => {
+    setIsLoading(true)
+    setQuery(value)
+    const data = await fetchResults(value)
+    setResults(data)
+    setIsLoading(false)
+  }
+
+  return (
+    <>
+      <input onChange={(e) => handleSearch(e.target.value)} />
+      {isLoading && <Spinner />}
+      <ResultsList results={results} />
+    </>
+  )
+}
+```
+
+**Correct (useTransition with built-in pending state):**
+
+```tsx
+import { useTransition, useState } from 'react'
+
+function SearchResults() {
+  const [query, setQuery] = useState('')
+  const [results, setResults] = useState([])
+  const [isPending, startTransition] = useTransition()
+
+  const handleSearch = (value: string) => {
+    setQuery(value) // Update input immediately
+    
+    startTransition(async () => {
+      // Fetch and update results
+      const data = await fetchResults(value)
+      setResults(data)
+    })
+  }
+
+  return (
+    <>
+      <input onChange={(e) => handleSearch(e.target.value)} />
+      {isPending && <Spinner />}
+      <ResultsList results={results} />
+    </>
+  )
+}
+```
+
+**Benefits:**
+
+- **Automatic pending state**: No need to manually manage `setIsLoading(true/false)`
+- **Error resilience**: Pending state correctly resets even if the transition throws
+- **Better responsiveness**: Keeps the UI responsive during updates
+- **Interrupt handling**: New transitions automatically cancel pending ones
+
+Reference: [useTransition](https://react.dev/reference/react/useTransition)
diff --git a/.agents/skills/react-best-practices/rules/rerender-defer-reads.md b/.agents/skills/react-best-practices/rules/rerender-defer-reads.md
new file mode 100644
index 0000000..e867c95
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-defer-reads.md
@@ -0,0 +1,39 @@
+---
+title: Defer State Reads to Usage Point
+impact: MEDIUM
+impactDescription: avoids unnecessary subscriptions
+tags: rerender, searchParams, localStorage, optimization
+---
+
+## Defer State Reads to Usage Point
+
+Don't subscribe to dynamic state (searchParams, localStorage) if you only read it inside callbacks.
+
+**Incorrect (subscribes to all searchParams changes):**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const searchParams = useSearchParams()
+
+  const handleShare = () => {
+    const ref = searchParams.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
+
+**Correct (reads on demand, no subscription):**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const handleShare = () => {
+    const params = new URLSearchParams(window.location.search)
+    const ref = params.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/rerender-dependencies.md b/.agents/skills/react-best-practices/rules/rerender-dependencies.md
new file mode 100644
index 0000000..47a4d92
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-dependencies.md
@@ -0,0 +1,45 @@
+---
+title: Narrow Effect Dependencies
+impact: LOW
+impactDescription: minimizes effect re-runs
+tags: rerender, useEffect, dependencies, optimization
+---
+
+## Narrow Effect Dependencies
+
+Specify primitive dependencies instead of objects to minimize effect re-runs.
+
+**Incorrect (re-runs on any user field change):**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user])
+```
+
+**Correct (re-runs only when id changes):**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user.id])
+```
+
+**For derived state, compute outside effect:**
+
+```tsx
+// Incorrect: runs on width=767, 766, 765...
+useEffect(() => {
+  if (width < 768) {
+    enableMobileMode()
+  }
+}, [width])
+
+// Correct: runs only on boolean transition
+const isMobile = width < 768
+useEffect(() => {
+  if (isMobile) {
+    enableMobileMode()
+  }
+}, [isMobile])
+```
diff --git a/.agents/skills/react-best-practices/rules/rerender-derived-state-no-effect.md b/.agents/skills/react-best-practices/rules/rerender-derived-state-no-effect.md
new file mode 100644
index 0000000..3d9fe40
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-derived-state-no-effect.md
@@ -0,0 +1,40 @@
+---
+title: Calculate Derived State During Rendering
+impact: MEDIUM
+impactDescription: avoids redundant renders and state drift
+tags: rerender, derived-state, useEffect, state
+---
+
+## Calculate Derived State During Rendering
+
+If a value can be computed from current props/state, do not store it in state or update it in an effect. Derive it during render to avoid extra renders and state drift. Do not set state in effects solely in response to prop changes; prefer derived values or keyed resets instead.
+
+**Incorrect (redundant state and effect):**
+
+```tsx
+function Form() {
+  const [firstName, setFirstName] = useState('First')
+  const [lastName, setLastName] = useState('Last')
+  const [fullName, setFullName] = useState('')
+
+  useEffect(() => {
+    setFullName(firstName + ' ' + lastName)
+  }, [firstName, lastName])
+
+  return <p>{fullName}</p>
+}
+```
+
+**Correct (derive during render):**
+
+```tsx
+function Form() {
+  const [firstName, setFirstName] = useState('First')
+  const [lastName, setLastName] = useState('Last')
+  const fullName = firstName + ' ' + lastName
+
+  return <p>{fullName}</p>
+}
+```
+
+References: [You Might Not Need an Effect](https://react.dev/learn/you-might-not-need-an-effect)
diff --git a/.agents/skills/react-best-practices/rules/rerender-derived-state.md b/.agents/skills/react-best-practices/rules/rerender-derived-state.md
new file mode 100644
index 0000000..e5c899f
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-derived-state.md
@@ -0,0 +1,29 @@
+---
+title: Subscribe to Derived State
+impact: MEDIUM
+impactDescription: reduces re-render frequency
+tags: rerender, derived-state, media-query, optimization
+---
+
+## Subscribe to Derived State
+
+Subscribe to derived boolean state instead of continuous values to reduce re-render frequency.
+
+**Incorrect (re-renders on every pixel change):**
+
+```tsx
+function Sidebar() {
+  const width = useWindowWidth()  // updates continuously
+  const isMobile = width < 768
+  return <nav className={isMobile ? 'mobile' : 'desktop'} />
+}
+```
+
+**Correct (re-renders only when boolean changes):**
+
+```tsx
+function Sidebar() {
+  const isMobile = useMediaQuery('(max-width: 767px)')
+  return <nav className={isMobile ? 'mobile' : 'desktop'} />
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/rerender-functional-setstate.md b/.agents/skills/react-best-practices/rules/rerender-functional-setstate.md
new file mode 100644
index 0000000..b004ef4
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-functional-setstate.md
@@ -0,0 +1,74 @@
+---
+title: Use Functional setState Updates
+impact: MEDIUM
+impactDescription: prevents stale closures and unnecessary callback recreations
+tags: react, hooks, useState, useCallback, callbacks, closures
+---
+
+## Use Functional setState Updates
+
+When updating state based on the current state value, use the functional update form of setState instead of directly referencing the state variable. This prevents stale closures, eliminates unnecessary dependencies, and creates stable callback references.
+
+**Incorrect (requires state as dependency):**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Callback must depend on items, recreated on every items change
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems([...items, ...newItems])
+  }, [items])  // ❌ items dependency causes recreations
+  
+  // Risk of stale closure if dependency is forgotten
+  const removeItem = useCallback((id: string) => {
+    setItems(items.filter(item => item.id !== id))
+  }, [])  // ❌ Missing items dependency - will use stale items!
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+The first callback is recreated every time `items` changes, which can cause child components to re-render unnecessarily. The second callback has a stale closure bug—it will always reference the initial `items` value.
+
+**Correct (stable callbacks, no stale closures):**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Stable callback, never recreated
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems(curr => [...curr, ...newItems])
+  }, [])  // ✅ No dependencies needed
+  
+  // Always uses latest state, no stale closure risk
+  const removeItem = useCallback((id: string) => {
+    setItems(curr => curr.filter(item => item.id !== id))
+  }, [])  // ✅ Safe and stable
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+**Benefits:**
+
+1. **Stable callback references** - Callbacks don't need to be recreated when state changes
+2. **No stale closures** - Always operates on the latest state value
+3. **Fewer dependencies** - Simplifies dependency arrays and reduces memory leaks
+4. **Prevents bugs** - Eliminates the most common source of React closure bugs
+
+**When to use functional updates:**
+
+- Any setState that depends on the current state value
+- Inside useCallback/useMemo when state is needed
+- Event handlers that reference state
+- Async operations that update state
+
+**When direct updates are fine:**
+
+- Setting state to a static value: `setCount(0)`
+- Setting state from props/arguments only: `setName(newName)`
+- State doesn't depend on previous value
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler can automatically optimize some cases, but functional updates are still recommended for correctness and to prevent stale closure bugs.
diff --git a/.agents/skills/react-best-practices/rules/rerender-lazy-state-init.md b/.agents/skills/react-best-practices/rules/rerender-lazy-state-init.md
new file mode 100644
index 0000000..4ecb350
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-lazy-state-init.md
@@ -0,0 +1,58 @@
+---
+title: Use Lazy State Initialization
+impact: MEDIUM
+impactDescription: wasted computation on every render
+tags: react, hooks, useState, performance, initialization
+---
+
+## Use Lazy State Initialization
+
+Pass a function to `useState` for expensive initial values. Without the function form, the initializer runs on every render even though the value is only used once.
+
+**Incorrect (runs on every render):**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs on EVERY render, even after initialization
+  const [searchIndex, setSearchIndex] = useState(buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  // When query changes, buildSearchIndex runs again unnecessarily
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs on every render
+  const [settings, setSettings] = useState(
+    JSON.parse(localStorage.getItem('settings') || '{}')
+  )
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+**Correct (runs only once):**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs ONLY on initial render
+  const [searchIndex, setSearchIndex] = useState(() => buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs only on initial render
+  const [settings, setSettings] = useState(() => {
+    const stored = localStorage.getItem('settings')
+    return stored ? JSON.parse(stored) : {}
+  })
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+Use lazy initialization when computing initial values from localStorage/sessionStorage, building data structures (indexes, maps), reading from the DOM, or performing heavy transformations.
+
+For simple primitives (`useState(0)`), direct references (`useState(props.value)`), or cheap literals (`useState({})`), the function form is unnecessary.
diff --git a/.agents/skills/react-best-practices/rules/rerender-memo-with-default-value.md b/.agents/skills/react-best-practices/rules/rerender-memo-with-default-value.md
new file mode 100644
index 0000000..6357049
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-memo-with-default-value.md
@@ -0,0 +1,38 @@
+---
+
+title: Extract Default Non-primitive Parameter Value from Memoized Component to Constant
+impact: MEDIUM
+impactDescription: restores memoization by using a constant for default value
+tags: rerender, memo, optimization
+
+---
+
+## Extract Default Non-primitive Parameter Value from Memoized Component to Constant
+
+When memoized component has a default value for some non-primitive optional parameter, such as an array, function, or object, calling the component without that parameter results in broken memoization. This is because new value instances are created on every rerender, and they do not pass strict equality comparison in `memo()`.
+
+To address this issue, extract the default value into a constant.
+
+**Incorrect (`onClick` has different values on every rerender):**
+
+```tsx
+const UserAvatar = memo(function UserAvatar({ onClick = () => {} }: { onClick?: () => void }) {
+  // ...
+})
+
+// Used without optional onClick
+<UserAvatar />
+```
+
+**Correct (stable default value):**
+
+```tsx
+const NOOP = () => {};
+
+const UserAvatar = memo(function UserAvatar({ onClick = NOOP }: { onClick?: () => void }) {
+  // ...
+})
+
+// Used without optional onClick
+<UserAvatar />
+```
diff --git a/.agents/skills/react-best-practices/rules/rerender-memo.md b/.agents/skills/react-best-practices/rules/rerender-memo.md
new file mode 100644
index 0000000..f8982ab
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-memo.md
@@ -0,0 +1,44 @@
+---
+title: Extract to Memoized Components
+impact: MEDIUM
+impactDescription: enables early returns
+tags: rerender, memo, useMemo, optimization
+---
+
+## Extract to Memoized Components
+
+Extract expensive work into memoized components to enable early returns before computation.
+
+**Incorrect (computes avatar even when loading):**
+
+```tsx
+function Profile({ user, loading }: Props) {
+  const avatar = useMemo(() => {
+    const id = computeAvatarId(user)
+    return <Avatar id={id} />
+  }, [user])
+
+  if (loading) return <Skeleton />
+  return <div>{avatar}</div>
+}
+```
+
+**Correct (skips computation when loading):**
+
+```tsx
+const UserAvatar = memo(function UserAvatar({ user }: { user: User }) {
+  const id = useMemo(() => computeAvatarId(user), [user])
+  return <Avatar id={id} />
+})
+
+function Profile({ user, loading }: Props) {
+  if (loading) return <Skeleton />
+  return (
+    <div>
+      <UserAvatar user={user} />
+    </div>
+  )
+}
+```
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, manual memoization with `memo()` and `useMemo()` is not necessary. The compiler automatically optimizes re-renders.
diff --git a/.agents/skills/react-best-practices/rules/rerender-move-effect-to-event.md b/.agents/skills/react-best-practices/rules/rerender-move-effect-to-event.md
new file mode 100644
index 0000000..dd58a1a
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-move-effect-to-event.md
@@ -0,0 +1,45 @@
+---
+title: Put Interaction Logic in Event Handlers
+impact: MEDIUM
+impactDescription: avoids effect re-runs and duplicate side effects
+tags: rerender, useEffect, events, side-effects, dependencies
+---
+
+## Put Interaction Logic in Event Handlers
+
+If a side effect is triggered by a specific user action (submit, click, drag), run it in that event handler. Do not model the action as state + effect; it makes effects re-run on unrelated changes and can duplicate the action.
+
+**Incorrect (event modeled as state + effect):**
+
+```tsx
+function Form() {
+  const [submitted, setSubmitted] = useState(false)
+  const theme = useContext(ThemeContext)
+
+  useEffect(() => {
+    if (submitted) {
+      post('/api/register')
+      showToast('Registered', theme)
+    }
+  }, [submitted, theme])
+
+  return <button onClick={() => setSubmitted(true)}>Submit</button>
+}
+```
+
+**Correct (do it in the handler):**
+
+```tsx
+function Form() {
+  const theme = useContext(ThemeContext)
+
+  function handleSubmit() {
+    post('/api/register')
+    showToast('Registered', theme)
+  }
+
+  return <button onClick={handleSubmit}>Submit</button>
+}
+```
+
+Reference: [Should this code move to an event handler?](https://react.dev/learn/removing-effect-dependencies#should-this-code-move-to-an-event-handler)
diff --git a/.agents/skills/react-best-practices/rules/rerender-simple-expression-in-memo.md b/.agents/skills/react-best-practices/rules/rerender-simple-expression-in-memo.md
new file mode 100644
index 0000000..59dfab0
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-simple-expression-in-memo.md
@@ -0,0 +1,35 @@
+---
+title: Do not wrap a simple expression with a primitive result type in useMemo
+impact: LOW-MEDIUM
+impactDescription: wasted computation on every render
+tags: rerender, useMemo, optimization
+---
+
+## Do not wrap a simple expression with a primitive result type in useMemo
+
+When an expression is simple (few logical or arithmetical operators) and has a primitive result type (boolean, number, string), do not wrap it in `useMemo`.
+Calling `useMemo` and comparing hook dependencies may consume more resources than the expression itself.
+
+**Incorrect:**
+
+```tsx
+function Header({ user, notifications }: Props) {
+  const isLoading = useMemo(() => {
+    return user.isLoading || notifications.isLoading
+  }, [user.isLoading, notifications.isLoading])
+
+  if (isLoading) return <Skeleton />
+  // return some markup
+}
+```
+
+**Correct:**
+
+```tsx
+function Header({ user, notifications }: Props) {
+  const isLoading = user.isLoading || notifications.isLoading
+
+  if (isLoading) return <Skeleton />
+  // return some markup
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/rerender-transitions.md b/.agents/skills/react-best-practices/rules/rerender-transitions.md
new file mode 100644
index 0000000..d99f43f
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-transitions.md
@@ -0,0 +1,40 @@
+---
+title: Use Transitions for Non-Urgent Updates
+impact: MEDIUM
+impactDescription: maintains UI responsiveness
+tags: rerender, transitions, startTransition, performance
+---
+
+## Use Transitions for Non-Urgent Updates
+
+Mark frequent, non-urgent state updates as transitions to maintain UI responsiveness.
+
+**Incorrect (blocks UI on every scroll):**
+
+```tsx
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => setScrollY(window.scrollY)
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
+
+**Correct (non-blocking updates):**
+
+```tsx
+import { startTransition } from 'react'
+
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => {
+      startTransition(() => setScrollY(window.scrollY))
+    }
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/rerender-use-ref-transient-values.md b/.agents/skills/react-best-practices/rules/rerender-use-ref-transient-values.md
new file mode 100644
index 0000000..cf04b81
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/rerender-use-ref-transient-values.md
@@ -0,0 +1,73 @@
+---
+title: Use useRef for Transient Values
+impact: MEDIUM
+impactDescription: avoids unnecessary re-renders on frequent updates
+tags: rerender, useref, state, performance
+---
+
+## Use useRef for Transient Values
+
+When a value changes frequently and you don't want a re-render on every update (e.g., mouse trackers, intervals, transient flags), store it in `useRef` instead of `useState`. Keep component state for UI; use refs for temporary DOM-adjacent values. Updating a ref does not trigger a re-render.
+
+**Incorrect (renders every update):**
+
+```tsx
+function Tracker() {
+  const [lastX, setLastX] = useState(0)
+
+  useEffect(() => {
+    const onMove = (e: MouseEvent) => setLastX(e.clientX)
+    window.addEventListener('mousemove', onMove)
+    return () => window.removeEventListener('mousemove', onMove)
+  }, [])
+
+  return (
+    <div
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: lastX,
+        width: 8,
+        height: 8,
+        background: 'black',
+      }}
+    />
+  )
+}
+```
+
+**Correct (no re-render for tracking):**
+
+```tsx
+function Tracker() {
+  const lastXRef = useRef(0)
+  const dotRef = useRef<HTMLDivElement>(null)
+
+  useEffect(() => {
+    const onMove = (e: MouseEvent) => {
+      lastXRef.current = e.clientX
+      const node = dotRef.current
+      if (node) {
+        node.style.transform = `translateX(${e.clientX}px)`
+      }
+    }
+    window.addEventListener('mousemove', onMove)
+    return () => window.removeEventListener('mousemove', onMove)
+  }, [])
+
+  return (
+    <div
+      ref={dotRef}
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        width: 8,
+        height: 8,
+        background: 'black',
+        transform: 'translateX(0px)',
+      }}
+    />
+  )
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/server-after-nonblocking.md b/.agents/skills/react-best-practices/rules/server-after-nonblocking.md
new file mode 100644
index 0000000..e8f5b26
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/server-after-nonblocking.md
@@ -0,0 +1,73 @@
+---
+title: Use after() for Non-Blocking Operations
+impact: MEDIUM
+impactDescription: faster response times
+tags: server, async, logging, analytics, side-effects
+---
+
+## Use after() for Non-Blocking Operations
+
+Use Next.js's `after()` to schedule work that should execute after a response is sent. This prevents logging, analytics, and other side effects from blocking the response.
+
+**Incorrect (blocks response):**
+
+```tsx
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Logging blocks the response
+  const userAgent = request.headers.get('user-agent') || 'unknown'
+  await logUserAction({ userAgent })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+**Correct (non-blocking):**
+
+```tsx
+import { after } from 'next/server'
+import { headers, cookies } from 'next/headers'
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Log after response is sent
+  after(async () => {
+    const userAgent = (await headers()).get('user-agent') || 'unknown'
+    const sessionCookie = (await cookies()).get('session-id')?.value || 'anonymous'
+    
+    logUserAction({ sessionCookie, userAgent })
+  })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+The response is sent immediately while logging happens in the background.
+
+**Common use cases:**
+
+- Analytics tracking
+- Audit logging
+- Sending notifications
+- Cache invalidation
+- Cleanup tasks
+
+**Important notes:**
+
+- `after()` runs even if the response fails or redirects
+- Works in Server Actions, Route Handlers, and Server Components
+
+Reference: [https://nextjs.org/docs/app/api-reference/functions/after](https://nextjs.org/docs/app/api-reference/functions/after)
diff --git a/.agents/skills/react-best-practices/rules/server-auth-actions.md b/.agents/skills/react-best-practices/rules/server-auth-actions.md
new file mode 100644
index 0000000..ee82c04
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/server-auth-actions.md
@@ -0,0 +1,96 @@
+---
+title: Authenticate Server Actions Like API Routes
+impact: CRITICAL
+impactDescription: prevents unauthorized access to server mutations
+tags: server, server-actions, authentication, security, authorization
+---
+
+## Authenticate Server Actions Like API Routes
+
+**Impact: CRITICAL (prevents unauthorized access to server mutations)**
+
+Server Actions (functions with `"use server"`) are exposed as public endpoints, just like API routes. Always verify authentication and authorization **inside** each Server Action—do not rely solely on middleware, layout guards, or page-level checks, as Server Actions can be invoked directly.
+
+Next.js documentation explicitly states: "Treat Server Actions with the same security considerations as public-facing API endpoints, and verify if the user is allowed to perform a mutation."
+
+**Incorrect (no authentication check):**
+
+```typescript
+'use server'
+
+export async function deleteUser(userId: string) {
+  // Anyone can call this! No auth check
+  await db.user.delete({ where: { id: userId } })
+  return { success: true }
+}
+```
+
+**Correct (authentication inside the action):**
+
+```typescript
+'use server'
+
+import { verifySession } from '@/lib/auth'
+import { unauthorized } from '@/lib/errors'
+
+export async function deleteUser(userId: string) {
+  // Always check auth inside the action
+  const session = await verifySession()
+  
+  if (!session) {
+    throw unauthorized('Must be logged in')
+  }
+  
+  // Check authorization too
+  if (session.user.role !== 'admin' && session.user.id !== userId) {
+    throw unauthorized('Cannot delete other users')
+  }
+  
+  await db.user.delete({ where: { id: userId } })
+  return { success: true }
+}
+```
+
+**With input validation:**
+
+```typescript
+'use server'
+
+import { verifySession } from '@/lib/auth'
+import { z } from 'zod'
+
+const updateProfileSchema = z.object({
+  userId: z.string().uuid(),
+  name: z.string().min(1).max(100),
+  email: z.string().email()
+})
+
+export async function updateProfile(data: unknown) {
+  // Validate input first
+  const validated = updateProfileSchema.parse(data)
+  
+  // Then authenticate
+  const session = await verifySession()
+  if (!session) {
+    throw new Error('Unauthorized')
+  }
+  
+  // Then authorize
+  if (session.user.id !== validated.userId) {
+    throw new Error('Can only update own profile')
+  }
+  
+  // Finally perform the mutation
+  await db.user.update({
+    where: { id: validated.userId },
+    data: {
+      name: validated.name,
+      email: validated.email
+    }
+  })
+  
+  return { success: true }
+}
+```
+
+Reference: [https://nextjs.org/docs/app/guides/authentication](https://nextjs.org/docs/app/guides/authentication)
diff --git a/.agents/skills/react-best-practices/rules/server-cache-lru.md b/.agents/skills/react-best-practices/rules/server-cache-lru.md
new file mode 100644
index 0000000..ef6938a
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/server-cache-lru.md
@@ -0,0 +1,41 @@
+---
+title: Cross-Request LRU Caching
+impact: HIGH
+impactDescription: caches across requests
+tags: server, cache, lru, cross-request
+---
+
+## Cross-Request LRU Caching
+
+`React.cache()` only works within one request. For data shared across sequential requests (user clicks button A then button B), use an LRU cache.
+
+**Implementation:**
+
+```typescript
+import { LRUCache } from 'lru-cache'
+
+const cache = new LRUCache<string, any>({
+  max: 1000,
+  ttl: 5 * 60 * 1000  // 5 minutes
+})
+
+export async function getUser(id: string) {
+  const cached = cache.get(id)
+  if (cached) return cached
+
+  const user = await db.user.findUnique({ where: { id } })
+  cache.set(id, user)
+  return user
+}
+
+// Request 1: DB query, result cached
+// Request 2: cache hit, no DB query
+```
+
+Use when sequential user actions hit multiple endpoints needing the same data within seconds.
+
+**With Vercel's [Fluid Compute](https://vercel.com/docs/fluid-compute):** LRU caching is especially effective because multiple concurrent requests can share the same function instance and cache. This means the cache persists across requests without needing external storage like Redis.
+
+**In traditional serverless:** Each invocation runs in isolation, so consider Redis for cross-process caching.
+
+Reference: [https://github.com/isaacs/node-lru-cache](https://github.com/isaacs/node-lru-cache)
diff --git a/.agents/skills/react-best-practices/rules/server-cache-react.md b/.agents/skills/react-best-practices/rules/server-cache-react.md
new file mode 100644
index 0000000..87c9ca3
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/server-cache-react.md
@@ -0,0 +1,76 @@
+---
+title: Per-Request Deduplication with React.cache()
+impact: MEDIUM
+impactDescription: deduplicates within request
+tags: server, cache, react-cache, deduplication
+---
+
+## Per-Request Deduplication with React.cache()
+
+Use `React.cache()` for server-side request deduplication. Authentication and database queries benefit most.
+
+**Usage:**
+
+```typescript
+import { cache } from 'react'
+
+export const getCurrentUser = cache(async () => {
+  const session = await auth()
+  if (!session?.user?.id) return null
+  return await db.user.findUnique({
+    where: { id: session.user.id }
+  })
+})
+```
+
+Within a single request, multiple calls to `getCurrentUser()` execute the query only once.
+
+**Avoid inline objects as arguments:**
+
+`React.cache()` uses shallow equality (`Object.is`) to determine cache hits. Inline objects create new references each call, preventing cache hits.
+
+**Incorrect (always cache miss):**
+
+```typescript
+const getUser = cache(async (params: { uid: number }) => {
+  return await db.user.findUnique({ where: { id: params.uid } })
+})
+
+// Each call creates new object, never hits cache
+getUser({ uid: 1 })
+getUser({ uid: 1 })  // Cache miss, runs query again
+```
+
+**Correct (cache hit):**
+
+```typescript
+const getUser = cache(async (uid: number) => {
+  return await db.user.findUnique({ where: { id: uid } })
+})
+
+// Primitive args use value equality
+getUser(1)
+getUser(1)  // Cache hit, returns cached result
+```
+
+If you must pass objects, pass the same reference:
+
+```typescript
+const params = { uid: 1 }
+getUser(params)  // Query runs
+getUser(params)  // Cache hit (same reference)
+```
+
+**Next.js-Specific Note:**
+
+In Next.js, the `fetch` API is automatically extended with request memoization. Requests with the same URL and options are automatically deduplicated within a single request, so you don't need `React.cache()` for `fetch` calls. However, `React.cache()` is still essential for other async tasks:
+
+- Database queries (Prisma, Drizzle, etc.)
+- Heavy computations
+- Authentication checks
+- File system operations
+- Any non-fetch async work
+
+Use `React.cache()` to deduplicate these operations across your component tree.
+
+Reference: [React.cache documentation](https://react.dev/reference/react/cache)
diff --git a/.agents/skills/react-best-practices/rules/server-dedup-props.md b/.agents/skills/react-best-practices/rules/server-dedup-props.md
new file mode 100644
index 0000000..fb24a25
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/server-dedup-props.md
@@ -0,0 +1,65 @@
+---
+title: Avoid Duplicate Serialization in RSC Props
+impact: LOW
+impactDescription: reduces network payload by avoiding duplicate serialization
+tags: server, rsc, serialization, props, client-components
+---
+
+## Avoid Duplicate Serialization in RSC Props
+
+**Impact: LOW (reduces network payload by avoiding duplicate serialization)**
+
+RSC→client serialization deduplicates by object reference, not value. Same reference = serialized once; new reference = serialized again. Do transformations (`.toSorted()`, `.filter()`, `.map()`) in client, not server.
+
+**Incorrect (duplicates array):**
+
+```tsx
+// RSC: sends 6 strings (2 arrays × 3 items)
+<ClientList usernames={usernames} usernamesOrdered={usernames.toSorted()} />
+```
+
+**Correct (sends 3 strings):**
+
+```tsx
+// RSC: send once
+<ClientList usernames={usernames} />
+
+// Client: transform there
+'use client'
+const sorted = useMemo(() => [...usernames].sort(), [usernames])
+```
+
+**Nested deduplication behavior:**
+
+Deduplication works recursively. Impact varies by data type:
+
+- `string[]`, `number[]`, `boolean[]`: **HIGH impact** - array + all primitives fully duplicated
+- `object[]`: **LOW impact** - array duplicated, but nested objects deduplicated by reference
+
+```tsx
+// string[] - duplicates everything
+usernames={['a','b']} sorted={usernames.toSorted()} // sends 4 strings
+
+// object[] - duplicates array structure only
+users={[{id:1},{id:2}]} sorted={users.toSorted()} // sends 2 arrays + 2 unique objects (not 4)
+```
+
+**Operations breaking deduplication (create new references):**
+
+- Arrays: `.toSorted()`, `.filter()`, `.map()`, `.slice()`, `[...arr]`
+- Objects: `{...obj}`, `Object.assign()`, `structuredClone()`, `JSON.parse(JSON.stringify())`
+
+**More examples:**
+
+```tsx
+// ❌ Bad
+<C users={users} active={users.filter(u => u.active)} />
+<C product={product} productName={product.name} />
+
+// ✅ Good
+<C users={users} />
+<C product={product} />
+// Do filtering/destructuring in client
+```
+
+**Exception:** Pass derived data when transformation is expensive or client doesn't need original.
diff --git a/.agents/skills/react-best-practices/rules/server-parallel-fetching.md b/.agents/skills/react-best-practices/rules/server-parallel-fetching.md
new file mode 100644
index 0000000..1affc83
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/server-parallel-fetching.md
@@ -0,0 +1,83 @@
+---
+title: Parallel Data Fetching with Component Composition
+impact: CRITICAL
+impactDescription: eliminates server-side waterfalls
+tags: server, rsc, parallel-fetching, composition
+---
+
+## Parallel Data Fetching with Component Composition
+
+React Server Components execute sequentially within a tree. Restructure with composition to parallelize data fetching.
+
+**Incorrect (Sidebar waits for Page's fetch to complete):**
+
+```tsx
+export default async function Page() {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      <Sidebar />
+    </div>
+  )
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+```
+
+**Correct (both fetch simultaneously):**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <div>
+      <Header />
+      <Sidebar />
+    </div>
+  )
+}
+```
+
+**Alternative with children prop:**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+function Layout({ children }: { children: ReactNode }) {
+  return (
+    <div>
+      <Header />
+      {children}
+    </div>
+  )
+}
+
+export default function Page() {
+  return (
+    <Layout>
+      <Sidebar />
+    </Layout>
+  )
+}
+```
diff --git a/.agents/skills/react-best-practices/rules/server-serialization.md b/.agents/skills/react-best-practices/rules/server-serialization.md
new file mode 100644
index 0000000..39c5c41
--- /dev/null
+++ b/.agents/skills/react-best-practices/rules/server-serialization.md
@@ -0,0 +1,38 @@
+---
+title: Minimize Serialization at RSC Boundaries
+impact: HIGH
+impactDescription: reduces data transfer size
+tags: server, rsc, serialization, props
+---
+
+## Minimize Serialization at RSC Boundaries
+
+The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
+
+**Incorrect (serializes all 50 fields):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()  // 50 fields
+  return <Profile user={user} />
+}
+
+'use client'
+function Profile({ user }: { user: User }) {
+  return <div>{user.name}</div>  // uses 1 field
+}
+```
+
+**Correct (serializes only 1 field):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()
+  return <Profile name={user.name} />
+}
+
+'use client'
+function Profile({ name }: { name: string }) {
+  return <div>{name}</div>
+}
+```
diff --git a/.agents/skills/react-native-skills/SKILL.md b/.agents/skills/react-native-skills/SKILL.md
new file mode 100644
index 0000000..7340186
--- /dev/null
+++ b/.agents/skills/react-native-skills/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: vercel-react-native-skills
+description:
+  React Native and Expo best practices for building performant mobile apps. Use
+  when building React Native components, optimizing list performance,
+  implementing animations, or working with native modules. Triggers on tasks
+  involving React Native, Expo, mobile performance, or native platform APIs.
+license: MIT
+metadata:
+  author: vercel
+  version: '1.0.0'
+---
+
+# React Native Skills
+
+Comprehensive best practices for React Native and Expo applications. Contains
+rules across multiple categories covering performance, animations, UI patterns,
+and platform-specific optimizations.
+
+## When to Apply
+
+Reference these guidelines when:
+
+- Building React Native or Expo apps
+- Optimizing list and scroll performance
+- Implementing animations with Reanimated
+- Working with images and media
+- Configuring native modules or fonts
+- Structuring monorepo projects with native dependencies
+
+## Rule Categories by Priority
+
+| Priority | Category         | Impact   | Prefix               |
+| -------- | ---------------- | -------- | -------------------- |
+| 1        | List Performance | CRITICAL | `list-performance-`  |
+| 2        | Animation        | HIGH     | `animation-`         |
+| 3        | Navigation       | HIGH     | `navigation-`        |
+| 4        | UI Patterns      | HIGH     | `ui-`                |
+| 5        | State Management | MEDIUM   | `react-state-`       |
+| 6        | Rendering        | MEDIUM   | `rendering-`         |
+| 7        | Monorepo         | MEDIUM   | `monorepo-`          |
+| 8        | Configuration    | LOW      | `fonts-`, `imports-` |
+
+## Quick Reference
+
+### 1. List Performance (CRITICAL)
+
+- `list-performance-virtualize` - Use FlashList for large lists
+- `list-performance-item-memo` - Memoize list item components
+- `list-performance-callbacks` - Stabilize callback references
+- `list-performance-inline-objects` - Avoid inline style objects
+- `list-performance-function-references` - Extract functions outside render
+- `list-performance-images` - Optimize images in lists
+- `list-performance-item-expensive` - Move expensive work outside items
+- `list-performance-item-types` - Use item types for heterogeneous lists
+
+### 2. Animation (HIGH)
+
+- `animation-gpu-properties` - Animate only transform and opacity
+- `animation-derived-value` - Use useDerivedValue for computed animations
+- `animation-gesture-detector-press` - Use Gesture.Tap instead of Pressable
+
+### 3. Navigation (HIGH)
+
+- `navigation-native-navigators` - Use native stack and native tabs over JS navigators
+
+### 4. UI Patterns (HIGH)
+
+- `ui-expo-image` - Use expo-image for all images
+- `ui-image-gallery` - Use Galeria for image lightboxes
+- `ui-pressable` - Use Pressable over TouchableOpacity
+- `ui-safe-area-scroll` - Handle safe areas in ScrollViews
+- `ui-scrollview-content-inset` - Use contentInset for headers
+- `ui-menus` - Use native context menus
+- `ui-native-modals` - Use native modals when possible
+- `ui-measure-views` - Use onLayout, not measure()
+- `ui-styling` - Use StyleSheet.create or Nativewind
+
+### 5. State Management (MEDIUM)
+
+- `react-state-minimize` - Minimize state subscriptions
+- `react-state-dispatcher` - Use dispatcher pattern for callbacks
+- `react-state-fallback` - Show fallback on first render
+- `react-compiler-destructure-functions` - Destructure for React Compiler
+- `react-compiler-reanimated-shared-values` - Handle shared values with compiler
+
+### 6. Rendering (MEDIUM)
+
+- `rendering-text-in-text-component` - Wrap text in Text components
+- `rendering-no-falsy-and` - Avoid falsy && for conditional rendering
+
+### 7. Monorepo (MEDIUM)
+
+- `monorepo-native-deps-in-app` - Keep native dependencies in app package
+- `monorepo-single-dependency-versions` - Use single versions across packages
+
+### 8. Configuration (LOW)
+
+- `fonts-config-plugin` - Use config plugins for custom fonts
+- `imports-design-system-folder` - Organize design system imports
+- `js-hoist-intl` - Hoist Intl object creation
+
+## How to Use
+
+Read individual rule files for detailed explanations and code examples:
+
+```
+rules/list-performance-virtualize.md
+rules/animation-gpu-properties.md
+```
+
+Each rule file contains:
+
+- Brief explanation of why it matters
+- Incorrect code example with explanation
+- Correct code example with explanation
+- Additional context and references
+
+## Full Compiled Document
+
+For the complete guide with all rules expanded: `AGENTS.md`
diff --git a/.agents/skills/react-native-skills/metadata.json b/.agents/skills/react-native-skills/metadata.json
new file mode 100644
index 0000000..600eb5b
--- /dev/null
+++ b/.agents/skills/react-native-skills/metadata.json
@@ -0,0 +1,16 @@
+{
+  "version": "1.0.0",
+  "organization": "Engineering",
+  "date": "January 2026",
+  "abstract": "Comprehensive performance optimization guide for React Native applications, designed for AI agents and LLMs. Contains 35+ rules across 13 categories, prioritized by impact from critical (core rendering, list performance) to incremental (fonts, imports). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics to guide automated refactoring and code generation.",
+  "references": [
+    "https://react.dev",
+    "https://reactnative.dev",
+    "https://docs.swmansion.com/react-native-reanimated",
+    "https://docs.swmansion.com/react-native-gesture-handler",
+    "https://docs.expo.dev",
+    "https://legendapp.com/open-source/legend-list",
+    "https://github.com/nandorojo/galeria",
+    "https://zeego.dev"
+  ]
+}
diff --git a/.agents/skills/react-native-skills/rules/_sections.md b/.agents/skills/react-native-skills/rules/_sections.md
new file mode 100644
index 0000000..0519cf2
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/_sections.md
@@ -0,0 +1,86 @@
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Core Rendering (rendering)
+
+**Impact:** CRITICAL  
+**Description:** Fundamental React Native rendering rules. Violations cause
+runtime crashes or broken UI.
+
+## 2. List Performance (list-performance)
+
+**Impact:** HIGH  
+**Description:** Optimizing virtualized lists (FlatList, LegendList, FlashList)
+for smooth scrolling and fast updates.
+
+## 3. Animation (animation)
+
+**Impact:** HIGH  
+**Description:** GPU-accelerated animations, Reanimated patterns, and avoiding
+render thrashing during gestures.
+
+## 4. Scroll Performance (scroll)
+
+**Impact:** HIGH  
+**Description:** Tracking scroll position without causing render thrashing.
+
+## 5. Navigation (navigation)
+
+**Impact:** HIGH  
+**Description:** Using native navigators for stack and tab navigation instead of
+JS-based alternatives.
+
+## 6. React State (react-state)
+
+**Impact:** MEDIUM  
+**Description:** Patterns for managing React state to avoid stale closures and
+unnecessary re-renders.
+
+## 7. State Architecture (state)
+
+**Impact:** MEDIUM  
+**Description:** Ground truth principles for state variables and derived values.
+
+## 8. React Compiler (react-compiler)
+
+**Impact:** MEDIUM  
+**Description:** Compatibility patterns for React Compiler with React Native and
+Reanimated.
+
+## 9. User Interface (ui)
+
+**Impact:** MEDIUM  
+**Description:** Native UI patterns for images, menus, modals, styling, and
+platform-consistent interfaces.
+
+## 10. Design System (design-system)
+
+**Impact:** MEDIUM  
+**Description:** Architecture patterns for building maintainable component
+libraries.
+
+## 11. Monorepo (monorepo)
+
+**Impact:** LOW  
+**Description:** Dependency management and native module configuration in
+monorepos.
+
+## 12. Third-Party Dependencies (imports)
+
+**Impact:** LOW  
+**Description:** Wrapping and re-exporting third-party dependencies for
+maintainability.
+
+## 13. JavaScript (js)
+
+**Impact:** LOW  
+**Description:** Micro-optimizations like hoisting expensive object creation.
+
+## 14. Fonts (fonts)
+
+**Impact:** LOW  
+**Description:** Native font loading for improved performance.
diff --git a/.agents/skills/react-native-skills/rules/_template.md b/.agents/skills/react-native-skills/rules/_template.md
new file mode 100644
index 0000000..1e9e707
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/_template.md
@@ -0,0 +1,28 @@
+---
+title: Rule Title Here
+impact: MEDIUM
+impactDescription: Optional description of impact (e.g., "20-50% improvement")
+tags: tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: MEDIUM (optional impact description)**
+
+Brief explanation of the rule and why it matters. This should be clear and concise, explaining the performance implications.
+
+**Incorrect (description of what's wrong):**
+
+```typescript
+// Bad code example here
+const bad = example()
+```
+
+**Correct (description of what's right):**
+
+```typescript
+// Good code example here
+const good = example()
+```
+
+Reference: [Link to documentation or resource](https://example.com)
diff --git a/.agents/skills/react-native-skills/rules/animation-derived-value.md b/.agents/skills/react-native-skills/rules/animation-derived-value.md
new file mode 100644
index 0000000..310928a
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/animation-derived-value.md
@@ -0,0 +1,53 @@
+---
+title: Prefer useDerivedValue Over useAnimatedReaction
+impact: MEDIUM
+impactDescription: cleaner code, automatic dependency tracking
+tags: animation, reanimated, derived-value
+---
+
+## Prefer useDerivedValue Over useAnimatedReaction
+
+When deriving a shared value from another, use `useDerivedValue` instead of
+`useAnimatedReaction`. Derived values are declarative, automatically track
+dependencies, and return a value you can use directly. Animated reactions are
+for side effects, not derivations.
+
+**Incorrect (useAnimatedReaction for derivation):**
+
+```tsx
+import { useSharedValue, useAnimatedReaction } from 'react-native-reanimated'
+
+function MyComponent() {
+  const progress = useSharedValue(0)
+  const opacity = useSharedValue(1)
+
+  useAnimatedReaction(
+    () => progress.value,
+    (current) => {
+      opacity.value = 1 - current
+    }
+  )
+
+  // ...
+}
+```
+
+**Correct (useDerivedValue):**
+
+```tsx
+import { useSharedValue, useDerivedValue } from 'react-native-reanimated'
+
+function MyComponent() {
+  const progress = useSharedValue(0)
+
+  const opacity = useDerivedValue(() => 1 - progress.get())
+
+  // ...
+}
+```
+
+Use `useAnimatedReaction` only for side effects that don't produce a value
+(e.g., triggering haptics, logging, calling `runOnJS`).
+
+Reference:
+[Reanimated useDerivedValue](https://docs.swmansion.com/react-native-reanimated/docs/core/useDerivedValue)
diff --git a/.agents/skills/react-native-skills/rules/animation-gesture-detector-press.md b/.agents/skills/react-native-skills/rules/animation-gesture-detector-press.md
new file mode 100644
index 0000000..87c6782
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/animation-gesture-detector-press.md
@@ -0,0 +1,95 @@
+---
+title: Use GestureDetector for Animated Press States
+impact: MEDIUM
+impactDescription: UI thread animations, smoother press feedback
+tags: animation, gestures, press, reanimated
+---
+
+## Use GestureDetector for Animated Press States
+
+For animated press states (scale, opacity on press), use `GestureDetector` with
+`Gesture.Tap()` and shared values instead of Pressable's
+`onPressIn`/`onPressOut`. Gesture callbacks run on the UI thread as worklets—no
+JS thread round-trip for press animations.
+
+**Incorrect (Pressable with JS thread callbacks):**
+
+```tsx
+import { Pressable } from 'react-native'
+import Animated, {
+  useSharedValue,
+  useAnimatedStyle,
+  withTiming,
+} from 'react-native-reanimated'
+
+function AnimatedButton({ onPress }: { onPress: () => void }) {
+  const scale = useSharedValue(1)
+
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [{ scale: scale.value }],
+  }))
+
+  return (
+    <Pressable
+      onPress={onPress}
+      onPressIn={() => (scale.value = withTiming(0.95))}
+      onPressOut={() => (scale.value = withTiming(1))}
+    >
+      <Animated.View style={animatedStyle}>
+        <Text>Press me</Text>
+      </Animated.View>
+    </Pressable>
+  )
+}
+```
+
+**Correct (GestureDetector with UI thread worklets):**
+
+```tsx
+import { Gesture, GestureDetector } from 'react-native-gesture-handler'
+import Animated, {
+  useSharedValue,
+  useAnimatedStyle,
+  withTiming,
+  interpolate,
+  runOnJS,
+} from 'react-native-reanimated'
+
+function AnimatedButton({ onPress }: { onPress: () => void }) {
+  // Store the press STATE (0 = not pressed, 1 = pressed)
+  const pressed = useSharedValue(0)
+
+  const tap = Gesture.Tap()
+    .onBegin(() => {
+      pressed.set(withTiming(1))
+    })
+    .onFinalize(() => {
+      pressed.set(withTiming(0))
+    })
+    .onEnd(() => {
+      runOnJS(onPress)()
+    })
+
+  // Derive visual values from the state
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [
+      { scale: interpolate(withTiming(pressed.get()), [0, 1], [1, 0.95]) },
+    ],
+  }))
+
+  return (
+    <GestureDetector gesture={tap}>
+      <Animated.View style={animatedStyle}>
+        <Text>Press me</Text>
+      </Animated.View>
+    </GestureDetector>
+  )
+}
+```
+
+Store the press **state** (0 or 1), then derive the scale via `interpolate`.
+This keeps the shared value as ground truth. Use `runOnJS` to call JS functions
+from worklets. Use `.set()` and `.get()` for React Compiler compatibility.
+
+Reference:
+[Gesture Handler Tap Gesture](https://docs.swmansion.com/react-native-gesture-handler/docs/gestures/tap-gesture)
diff --git a/.agents/skills/react-native-skills/rules/animation-gpu-properties.md b/.agents/skills/react-native-skills/rules/animation-gpu-properties.md
new file mode 100644
index 0000000..5fda095
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/animation-gpu-properties.md
@@ -0,0 +1,65 @@
+---
+title: Animate Transform and Opacity Instead of Layout Properties
+impact: HIGH
+impactDescription: GPU-accelerated animations, no layout recalculation
+tags: animation, performance, reanimated, transform, opacity
+---
+
+## Animate Transform and Opacity Instead of Layout Properties
+
+Avoid animating `width`, `height`, `top`, `left`, `margin`, or `padding`. These trigger layout recalculation on every frame. Instead, use `transform` (scale, translate) and `opacity` which run on the GPU without triggering layout.
+
+**Incorrect (animates height, triggers layout every frame):**
+
+```tsx
+import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
+
+function CollapsiblePanel({ expanded }: { expanded: boolean }) {
+  const animatedStyle = useAnimatedStyle(() => ({
+    height: withTiming(expanded ? 200 : 0), // triggers layout on every frame
+    overflow: 'hidden',
+  }))
+
+  return <Animated.View style={animatedStyle}>{children}</Animated.View>
+}
+```
+
+**Correct (animates scaleY, GPU-accelerated):**
+
+```tsx
+import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
+
+function CollapsiblePanel({ expanded }: { expanded: boolean }) {
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [
+      { scaleY: withTiming(expanded ? 1 : 0) },
+    ],
+    opacity: withTiming(expanded ? 1 : 0),
+  }))
+
+  return (
+    <Animated.View style={[{ height: 200, transformOrigin: 'top' }, animatedStyle]}>
+      {children}
+    </Animated.View>
+  )
+}
+```
+
+**Correct (animates translateY for slide animations):**
+
+```tsx
+import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
+
+function SlideIn({ visible }: { visible: boolean }) {
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [
+      { translateY: withTiming(visible ? 0 : 100) },
+    ],
+    opacity: withTiming(visible ? 1 : 0),
+  }))
+
+  return <Animated.View style={animatedStyle}>{children}</Animated.View>
+}
+```
+
+GPU-accelerated properties: `transform` (translate, scale, rotate), `opacity`. Everything else triggers layout.
diff --git a/.agents/skills/react-native-skills/rules/design-system-compound-components.md b/.agents/skills/react-native-skills/rules/design-system-compound-components.md
new file mode 100644
index 0000000..d8239ee
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/design-system-compound-components.md
@@ -0,0 +1,66 @@
+---
+title: Use Compound Components Over Polymorphic Children
+impact: MEDIUM
+impactDescription: flexible composition, clearer API
+tags: design-system, components, composition
+---
+
+## Use Compound Components Over Polymorphic Children
+
+Don't create components that can accept a string if they aren't a text node. If
+a component can receive a string child, it must be a dedicated `*Text`
+component. For components like buttons, which can have both a View (or
+Pressable) together with text, use compound components, such a `Button`,
+`ButtonText`, and `ButtonIcon`.
+
+**Incorrect (polymorphic children):**
+
+```tsx
+import { Pressable, Text } from 'react-native'
+
+type ButtonProps = {
+  children: string | React.ReactNode
+  icon?: React.ReactNode
+}
+
+function Button({ children, icon }: ButtonProps) {
+  return (
+    <Pressable>
+      {icon}
+      {typeof children === 'string' ? <Text>{children}</Text> : children}
+    </Pressable>
+  )
+}
+
+// Usage is ambiguous
+<Button icon={<Icon />}>Save</Button>
+<Button><CustomText>Save</CustomText></Button>
+```
+
+**Correct (compound components):**
+
+```tsx
+import { Pressable, Text } from 'react-native'
+
+function Button({ children }: { children: React.ReactNode }) {
+  return <Pressable>{children}</Pressable>
+}
+
+function ButtonText({ children }: { children: React.ReactNode }) {
+  return <Text>{children}</Text>
+}
+
+function ButtonIcon({ children }: { children: React.ReactNode }) {
+  return <>{children}</>
+}
+
+// Usage is explicit and composable
+<Button>
+  <ButtonIcon><SaveIcon /></ButtonIcon>
+  <ButtonText>Save</ButtonText>
+</Button>
+
+<Button>
+  <ButtonText>Cancel</ButtonText>
+</Button>
+```
diff --git a/.agents/skills/react-native-skills/rules/fonts-config-plugin.md b/.agents/skills/react-native-skills/rules/fonts-config-plugin.md
new file mode 100644
index 0000000..39aa014
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/fonts-config-plugin.md
@@ -0,0 +1,71 @@
+---
+title: Load fonts natively at build time
+impact: LOW
+impactDescription: fonts available at launch, no async loading
+tags: fonts, expo, performance, config-plugin
+---
+
+## Use Expo Config Plugin for Font Loading
+
+Use the `expo-font` config plugin to embed fonts at build time instead of
+`useFonts` or `Font.loadAsync`. Embedded fonts are more efficient.
+
+**Incorrect (async font loading):**
+
+```tsx
+import { useFonts } from 'expo-font'
+import { Text, View } from 'react-native'
+
+function App() {
+  const [fontsLoaded] = useFonts({
+    'Geist-Bold': require('./assets/fonts/Geist-Bold.otf'),
+  })
+
+  if (!fontsLoaded) {
+    return null
+  }
+
+  return (
+    <View>
+      <Text style={{ fontFamily: 'Geist-Bold' }}>Hello</Text>
+    </View>
+  )
+}
+```
+
+**Correct (config plugin, fonts embedded at build):**
+
+```json
+// app.json
+{
+  "expo": {
+    "plugins": [
+      [
+        "expo-font",
+        {
+          "fonts": ["./assets/fonts/Geist-Bold.otf"]
+        }
+      ]
+    ]
+  }
+}
+```
+
+```tsx
+import { Text, View } from 'react-native'
+
+function App() {
+  // No loading state needed—font is already available
+  return (
+    <View>
+      <Text style={{ fontFamily: 'Geist-Bold' }}>Hello</Text>
+    </View>
+  )
+}
+```
+
+After adding fonts to the config plugin, run `npx expo prebuild` and rebuild the
+native app.
+
+Reference:
+[Expo Font Documentation](https://docs.expo.dev/versions/latest/sdk/font/)
diff --git a/.agents/skills/react-native-skills/rules/imports-design-system-folder.md b/.agents/skills/react-native-skills/rules/imports-design-system-folder.md
new file mode 100644
index 0000000..8466dcb
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/imports-design-system-folder.md
@@ -0,0 +1,68 @@
+---
+title: Import from Design System Folder
+impact: LOW
+impactDescription: enables global changes and easy refactoring
+tags: imports, architecture, design-system
+---
+
+## Import from Design System Folder
+
+Re-export dependencies from a design system folder. App code imports from there,
+not directly from packages. This enables global changes and easy refactoring.
+
+**Incorrect (imports directly from package):**
+
+```tsx
+import { View, Text } from 'react-native'
+import { Button } from '@ui/button'
+
+function Profile() {
+  return (
+    <View>
+      <Text>Hello</Text>
+      <Button>Save</Button>
+    </View>
+  )
+}
+```
+
+**Correct (imports from design system):**
+
+```tsx
+// components/view.tsx
+import { View as RNView } from 'react-native'
+
+// ideal: pick the props you will actually use to control implementation
+export function View(
+  props: Pick<React.ComponentProps<typeof RNView>, 'style' | 'children'>
+) {
+  return <RNView {...props} />
+}
+```
+
+```tsx
+// components/text.tsx
+export { Text } from 'react-native'
+```
+
+```tsx
+// components/button.tsx
+export { Button } from '@ui/button'
+```
+
+```tsx
+import { View } from '@/components/view'
+import { Text } from '@/components/text'
+import { Button } from '@/components/button'
+
+function Profile() {
+  return (
+    <View>
+      <Text>Hello</Text>
+      <Button>Save</Button>
+    </View>
+  )
+}
+```
+
+Start by simply re-exporting. Customize later without changing app code.
diff --git a/.agents/skills/react-native-skills/rules/js-hoist-intl.md b/.agents/skills/react-native-skills/rules/js-hoist-intl.md
new file mode 100644
index 0000000..9af1c35
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/js-hoist-intl.md
@@ -0,0 +1,61 @@
+---
+title: Hoist Intl Formatter Creation
+impact: LOW-MEDIUM
+impactDescription: avoids expensive object recreation
+tags: javascript, intl, optimization, memoization
+---
+
+## Hoist Intl Formatter Creation
+
+Don't create `Intl.DateTimeFormat`, `Intl.NumberFormat`, or
+`Intl.RelativeTimeFormat` inside render or loops. These are expensive to
+instantiate. Hoist to module scope when the locale/options are static.
+
+**Incorrect (new formatter every render):**
+
+```tsx
+function Price({ amount }: { amount: number }) {
+  const formatter = new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+  })
+  return <Text>{formatter.format(amount)}</Text>
+}
+```
+
+**Correct (hoisted to module scope):**
+
+```tsx
+const currencyFormatter = new Intl.NumberFormat('en-US', {
+  style: 'currency',
+  currency: 'USD',
+})
+
+function Price({ amount }: { amount: number }) {
+  return <Text>{currencyFormatter.format(amount)}</Text>
+}
+```
+
+**For dynamic locales, memoize:**
+
+```tsx
+const dateFormatter = useMemo(
+  () => new Intl.DateTimeFormat(locale, { dateStyle: 'medium' }),
+  [locale]
+)
+```
+
+**Common formatters to hoist:**
+
+```tsx
+// Module-level formatters
+const dateFormatter = new Intl.DateTimeFormat('en-US', { dateStyle: 'medium' })
+const timeFormatter = new Intl.DateTimeFormat('en-US', { timeStyle: 'short' })
+const percentFormatter = new Intl.NumberFormat('en-US', { style: 'percent' })
+const relativeFormatter = new Intl.RelativeTimeFormat('en-US', {
+  numeric: 'auto',
+})
+```
+
+Creating `Intl` objects is significantly more expensive than `RegExp` or plain
+objects—each instantiation parses locale data and builds internal lookup tables.
diff --git a/.agents/skills/react-native-skills/rules/list-performance-callbacks.md b/.agents/skills/react-native-skills/rules/list-performance-callbacks.md
new file mode 100644
index 0000000..a0b3913
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-callbacks.md
@@ -0,0 +1,44 @@
+---
+title: Hoist callbacks to the root of lists
+impact: MEDIUM
+impactDescription: Fewer re-renders and faster lists
+tags: tag1, tag2
+---
+
+## List performance callbacks
+
+**Impact: HIGH (Fewer re-renders and faster lists)**
+
+When passing callback functions to list items, create a single instance of the
+callback at the root of the list. Items should then call it with a unique
+identifier.
+
+**Incorrect (creates a new callback on each render):**
+
+```typescript
+return (
+  <LegendList
+    renderItem={({ item }) => {
+      // bad: creates a new callback on each render
+      const onPress = () => handlePress(item.id)
+      return <Item key={item.id} item={item} onPress={onPress} />
+    }}
+  />
+)
+```
+
+**Correct (a single function instance passed to each item):**
+
+```typescript
+const onPress = useCallback(() => handlePress(item.id), [handlePress, item.id])
+
+return (
+  <LegendList
+    renderItem={({ item }) => (
+      <Item key={item.id} item={item} onPress={onPress} />
+    )}
+  />
+)
+```
+
+Reference: [Link to documentation or resource](https://example.com)
diff --git a/.agents/skills/react-native-skills/rules/list-performance-function-references.md b/.agents/skills/react-native-skills/rules/list-performance-function-references.md
new file mode 100644
index 0000000..9721929
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-function-references.md
@@ -0,0 +1,132 @@
+---
+title: Optimize List Performance with Stable Object References
+impact: CRITICAL
+impactDescription: virtualization relies on reference stability
+tags: lists, performance, flatlist, virtualization
+---
+
+## Optimize List Performance with Stable Object References
+
+Don't map or filter data before passing to virtualized lists. Virtualization
+relies on object reference stability to know what changed—new references cause
+full re-renders of all visible items. Attempt to prevent frequent renders at the
+list-parent level.
+
+Where needed, use context selectors within list items.
+
+**Incorrect (creates new object references on every keystroke):**
+
+```tsx
+function DomainSearch() {
+  const { keyword, setKeyword } = useKeywordZustandState()
+  const { data: tlds } = useTlds()
+
+  // Bad: creates new objects on every render, reparenting the entire list on every keystroke
+  const domains = tlds.map((tld) => ({
+    domain: `${keyword}.${tld.name}`,
+    tld: tld.name,
+    price: tld.price,
+  }))
+
+  return (
+    <>
+      <TextInput value={keyword} onChangeText={setKeyword} />
+      <LegendList
+        data={domains}
+        renderItem={({ item }) => <DomainItem item={item} keyword={keyword} />}
+      />
+    </>
+  )
+}
+```
+
+**Correct (stable references, transform inside items):**
+
+```tsx
+const renderItem = ({ item }) => <DomainItem tld={item} />
+
+function DomainSearch() {
+  const { data: tlds } = useTlds()
+
+  return (
+    <LegendList
+      // good: as long as the data is stable, LegendList will not re-render the entire list
+      data={tlds}
+      renderItem={renderItem}
+    />
+  )
+}
+
+function DomainItem({ tld }: { tld: Tld }) {
+  // good: transform within items, and don't pass the dynamic data as a prop
+  // good: use a selector function from zustand to receive a stable string back
+  const domain = useKeywordZustandState((s) => s.keyword + '.' + tld.name)
+  return <Text>{domain}</Text>
+}
+```
+
+**Updating parent array reference:**
+
+Creating a new array instance can be okay, as long as its inner object
+references are stable. For instance, if you sort a list of objects:
+
+```tsx
+// good: creates a new array instance without mutating the inner objects
+// good: parent array reference is unaffected by typing and updating "keyword"
+const sortedTlds = tlds.toSorted((a, b) => a.name.localeCompare(b.name))
+
+return <LegendList data={sortedTlds} renderItem={renderItem} />
+```
+
+Even though this creates a new array instance `sortedTlds`, the inner object
+references are stable.
+
+**With zustand for dynamic data (avoids parent re-renders):**
+
+```tsx
+const useSearchStore = create<{ keyword: string }>(() => ({ keyword: '' }))
+
+function DomainSearch() {
+  const { data: tlds } = useTlds()
+
+  return (
+    <>
+      <SearchInput />
+      <LegendList
+        data={tlds}
+        // if you aren't using React Compiler, wrap renderItem with useCallback
+        renderItem={({ item }) => <DomainItem tld={item} />}
+      />
+    </>
+  )
+}
+
+function DomainItem({ tld }: { tld: Tld }) {
+  // Select only what you need—component only re-renders when keyword changes
+  const keyword = useSearchStore((s) => s.keyword)
+  const domain = `${keyword}.${tld.name}`
+  return <Text>{domain}</Text>
+}
+```
+
+Virtualization can now skip items that haven't changed when typing. Only visible
+items (~20) re-render on keystroke, rather than the parent.
+
+**Deriving state within list items based on parent data (avoids parent
+re-renders):**
+
+For components where the data is conditional based on the parent state, this
+pattern is even more important. For example, if you are checking if an item is
+favorited, toggling favorites only re-renders one component if the item itself
+is in charge of accessing the state rather than the parent:
+
+```tsx
+function DomainItemFavoriteButton({ tld }: { tld: Tld }) {
+  const isFavorited = useFavoritesStore((s) => s.favorites.has(tld.id))
+  return <TldFavoriteButton isFavorited={isFavorited} />
+}
+```
+
+Note: if you're using the React Compiler, you can read React Context values
+directly within list items. Although this is slightly slower than using a
+Zustand selector in most cases, the effect may be negligible.
diff --git a/.agents/skills/react-native-skills/rules/list-performance-images.md b/.agents/skills/react-native-skills/rules/list-performance-images.md
new file mode 100644
index 0000000..75a3baf
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-images.md
@@ -0,0 +1,53 @@
+---
+title: Use Compressed Images in Lists
+impact: HIGH
+impactDescription: faster load times, less memory
+tags: lists, images, performance, optimization
+---
+
+## Use Compressed Images in Lists
+
+Always load compressed, appropriately-sized images in lists. Full-resolution
+images consume excessive memory and cause scroll jank. Request thumbnails from
+your server or use an image CDN with resize parameters.
+
+**Incorrect (full-resolution images):**
+
+```tsx
+function ProductItem({ product }: { product: Product }) {
+  return (
+    <View>
+      {/* 4000x3000 image loaded for a 100x100 thumbnail */}
+      <Image
+        source={{ uri: product.imageUrl }}
+        style={{ width: 100, height: 100 }}
+      />
+      <Text>{product.name}</Text>
+    </View>
+  )
+}
+```
+
+**Correct (request appropriately-sized image):**
+
+```tsx
+function ProductItem({ product }: { product: Product }) {
+  // Request a 200x200 image (2x for retina)
+  const thumbnailUrl = `${product.imageUrl}?w=200&h=200&fit=cover`
+
+  return (
+    <View>
+      <Image
+        source={{ uri: thumbnailUrl }}
+        style={{ width: 100, height: 100 }}
+        contentFit='cover'
+      />
+      <Text>{product.name}</Text>
+    </View>
+  )
+}
+```
+
+Use an optimized image component with built-in caching and placeholder support,
+such as `expo-image` or `SolitoImage` (which uses `expo-image` under the hood).
+Request images at 2x the display size for retina screens.
diff --git a/.agents/skills/react-native-skills/rules/list-performance-inline-objects.md b/.agents/skills/react-native-skills/rules/list-performance-inline-objects.md
new file mode 100644
index 0000000..d5b6514
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-inline-objects.md
@@ -0,0 +1,97 @@
+---
+title: Avoid Inline Objects in renderItem
+impact: HIGH
+impactDescription: prevents unnecessary re-renders of memoized list items
+tags: lists, performance, flatlist, virtualization, memo
+---
+
+## Avoid Inline Objects in renderItem
+
+Don't create new objects inside `renderItem` to pass as props. Inline objects
+create new references on every render, breaking memoization. Pass primitive
+values directly from `item` instead.
+
+**Incorrect (inline object breaks memoization):**
+
+```tsx
+function UserList({ users }: { users: User[] }) {
+  return (
+    <LegendList
+      data={users}
+      renderItem={({ item }) => (
+        <UserRow
+          // Bad: new object on every render
+          user={{ id: item.id, name: item.name, avatar: item.avatar }}
+        />
+      )}
+    />
+  )
+}
+```
+
+**Incorrect (inline style object):**
+
+```tsx
+renderItem={({ item }) => (
+  <UserRow
+    name={item.name}
+    // Bad: new style object on every render
+    style={{ backgroundColor: item.isActive ? 'green' : 'gray' }}
+  />
+)}
+```
+
+**Correct (pass item directly or primitives):**
+
+```tsx
+function UserList({ users }: { users: User[] }) {
+  return (
+    <LegendList
+      data={users}
+      renderItem={({ item }) => (
+        // Good: pass the item directly
+        <UserRow user={item} />
+      )}
+    />
+  )
+}
+```
+
+**Correct (pass primitives, derive inside child):**
+
+```tsx
+renderItem={({ item }) => (
+  <UserRow
+    id={item.id}
+    name={item.name}
+    isActive={item.isActive}
+  />
+)}
+
+const UserRow = memo(function UserRow({ id, name, isActive }: Props) {
+  // Good: derive style inside memoized component
+  const backgroundColor = isActive ? 'green' : 'gray'
+  return <View style={[styles.row, { backgroundColor }]}>{/* ... */}</View>
+})
+```
+
+**Correct (hoist static styles in module scope):**
+
+```tsx
+const activeStyle = { backgroundColor: 'green' }
+const inactiveStyle = { backgroundColor: 'gray' }
+
+renderItem={({ item }) => (
+  <UserRow
+    name={item.name}
+    // Good: stable references
+    style={item.isActive ? activeStyle : inactiveStyle}
+  />
+)}
+```
+
+Passing primitives or stable references allows `memo()` to skip re-renders when
+the actual values haven't changed.
+
+**Note:** If you have the React Compiler enabled, it handles memoization
+automatically and these manual optimizations become less critical.
diff --git a/.agents/skills/react-native-skills/rules/list-performance-item-expensive.md b/.agents/skills/react-native-skills/rules/list-performance-item-expensive.md
new file mode 100644
index 0000000..f617a76
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-item-expensive.md
@@ -0,0 +1,94 @@
+---
+title: Keep List Items Lightweight
+impact: HIGH
+impactDescription: reduces render time for visible items during scroll
+tags: lists, performance, virtualization, hooks
+---
+
+## Keep List Items Lightweight
+
+List items should be as inexpensive as possible to render. Minimize hooks, avoid
+queries, and limit React Context access. Virtualized lists render many items
+during scroll—expensive items cause jank.
+
+**Incorrect (heavy list item):**
+
+```tsx
+function ProductRow({ id }: { id: string }) {
+  // Bad: query inside list item
+  const { data: product } = useQuery(['product', id], () => fetchProduct(id))
+  // Bad: multiple context accesses
+  const theme = useContext(ThemeContext)
+  const user = useContext(UserContext)
+  const cart = useContext(CartContext)
+  // Bad: expensive computation
+  const recommendations = useMemo(
+    () => computeRecommendations(product),
+    [product]
+  )
+
+  return <View>{/* ... */}</View>
+}
+```
+
+**Correct (lightweight list item):**
+
+```tsx
+function ProductRow({ name, price, imageUrl }: Props) {
+  // Good: receives only primitives, minimal hooks
+  return (
+    <View>
+      <Image source={{ uri: imageUrl }} />
+      <Text>{name}</Text>
+      <Text>{price}</Text>
+    </View>
+  )
+}
+```
+
+**Move data fetching to parent:**
+
+```tsx
+// Parent fetches all data once
+function ProductList() {
+  const { data: products } = useQuery(['products'], fetchProducts)
+
+  return (
+    <LegendList
+      data={products}
+      renderItem={({ item }) => (
+        <ProductRow name={item.name} price={item.price} imageUrl={item.image} />
+      )}
+    />
+  )
+}
+```
+
+**For shared values, use Zustand selectors instead of Context:**
+
+```tsx
+// Incorrect: Context causes re-render when any cart value changes
+function ProductRow({ id, name }: Props) {
+  const { items } = useContext(CartContext)
+  const inCart = items.includes(id)
+  // ...
+}
+
+// Correct: Zustand selector only re-renders when this specific value changes
+function ProductRow({ id, name }: Props) {
+  // use Set.has (created once at the root) instead of Array.includes()
+  const inCart = useCartStore((s) => s.items.has(id))
+  // ...
+}
+```
+
+**Guidelines for list items:**
+
+- No queries or data fetching
+- No expensive computations (move to parent or memoize at parent level)
+- Prefer Zustand selectors over React Context
+- Minimize useState/useEffect hooks
+- Pass pre-computed values as props
+
+The goal: list items should be simple rendering functions that take props and
+return JSX.
diff --git a/.agents/skills/react-native-skills/rules/list-performance-item-memo.md b/.agents/skills/react-native-skills/rules/list-performance-item-memo.md
new file mode 100644
index 0000000..634935e
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-item-memo.md
@@ -0,0 +1,82 @@
+---
+title: Pass Primitives to List Items for Memoization
+impact: HIGH
+impactDescription: enables effective memo() comparison
+tags: lists, performance, memo, primitives
+---
+
+## Pass Primitives to List Items for Memoization
+
+When possible, pass only primitive values (strings, numbers, booleans) as props
+to list item components. Primitives enable shallow comparison in `memo()` to
+work correctly, skipping re-renders when values haven't changed.
+
+**Incorrect (object prop requires deep comparison):**
+
+```tsx
+type User = { id: string; name: string; email: string; avatar: string }
+
+const UserRow = memo(function UserRow({ user }: { user: User }) {
+  // memo() compares user by reference, not value
+  // If parent creates new user object, this re-renders even if data is same
+  return <Text>{user.name}</Text>
+})
+
+renderItem={({ item }) => <UserRow user={item} />}
+```
+
+This can still be optimized, but it is harder to memoize properly.
+
+**Correct (primitive props enable shallow comparison):**
+
+```tsx
+const UserRow = memo(function UserRow({
+  id,
+  name,
+  email,
+}: {
+  id: string
+  name: string
+  email: string
+}) {
+  // memo() compares each primitive directly
+  // Re-renders only if id, name, or email actually changed
+  return <Text>{name}</Text>
+})
+
+renderItem={({ item }) => (
+  <UserRow id={item.id} name={item.name} email={item.email} />
+)}
+```
+
+**Pass only what you need:**
+
+```tsx
+// Incorrect: passing entire item when you only need name
+<UserRow user={item} />
+
+// Correct: pass only the fields the component uses
+<UserRow name={item.name} avatarUrl={item.avatar} />
+```
+
+**For callbacks, hoist or use item ID:**
+
+```tsx
+// Incorrect: inline function creates new reference
+<UserRow name={item.name} onPress={() => handlePress(item.id)} />
+
+// Correct: pass ID, handle in child
+<UserRow id={item.id} name={item.name} />
+
+const UserRow = memo(function UserRow({ id, name }: Props) {
+  const handlePress = useCallback(() => {
+    // use id here
+  }, [id])
+  return <Pressable onPress={handlePress}><Text>{name}</Text></Pressable>
+})
+```
+
+Primitive props make memoization predictable and effective.
+
+**Note:** If you have the React Compiler enabled, you do not need to use
+`memo()` or `useCallback()`, but the object references still apply.
diff --git a/.agents/skills/react-native-skills/rules/list-performance-item-types.md b/.agents/skills/react-native-skills/rules/list-performance-item-types.md
new file mode 100644
index 0000000..1027e4e
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-item-types.md
@@ -0,0 +1,104 @@
+---
+title: Use Item Types for Heterogeneous Lists
+impact: HIGH
+impactDescription: efficient recycling, less layout thrashing
+tags: list, performance, recycling, heterogeneous, LegendList
+---
+
+## Use Item Types for Heterogeneous Lists
+
+When a list has different item layouts (messages, images, headers, etc.), use a
+`type` field on each item and provide `getItemType` to the list. This puts items
+into separate recycling pools so a message component never gets recycled into an
+image component.
+
+**Incorrect (single component with conditionals):**
+
+```tsx
+type Item = { id: string; text?: string; imageUrl?: string; isHeader?: boolean }
+
+function ListItem({ item }: { item: Item }) {
+  if (item.isHeader) {
+    return <HeaderItem title={item.text} />
+  }
+  if (item.imageUrl) {
+    return <ImageItem url={item.imageUrl} />
+  }
+  return <MessageItem text={item.text} />
+}
+
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <LegendList
+      data={items}
+      renderItem={({ item }) => <ListItem item={item} />}
+      recycleItems
+    />
+  )
+}
+```
+
+**Correct (typed items with separate components):**
+
+```tsx
+type HeaderItem = { id: string; type: 'header'; title: string }
+type MessageItem = { id: string; type: 'message'; text: string }
+type ImageItem = { id: string; type: 'image'; url: string }
+type FeedItem = HeaderItem | MessageItem | ImageItem
+
+function Feed({ items }: { items: FeedItem[] }) {
+  return (
+    <LegendList
+      data={items}
+      keyExtractor={(item) => item.id}
+      getItemType={(item) => item.type}
+      renderItem={({ item }) => {
+        switch (item.type) {
+          case 'header':
+            return <SectionHeader title={item.title} />
+          case 'message':
+            return <MessageRow text={item.text} />
+          case 'image':
+            return <ImageRow url={item.url} />
+        }
+      }}
+      recycleItems
+    />
+  )
+}
+```
+
+**Why this matters:**
+
+- **Recycling efficiency**: Items with the same type share a recycling pool
+- **No layout thrashing**: A header never recycles into an image cell
+- **Type safety**: TypeScript can narrow the item type in each branch
+- **Better size estimation**: Use `getEstimatedItemSize` with `itemType` for
+  accurate estimates per type
+
+```tsx
+<LegendList
+  data={items}
+  keyExtractor={(item) => item.id}
+  getItemType={(item) => item.type}
+  getEstimatedItemSize={(index, item, itemType) => {
+    switch (itemType) {
+      case 'header':
+        return 48
+      case 'message':
+        return 72
+      case 'image':
+        return 300
+      default:
+        return 72
+    }
+  }}
+  renderItem={({ item }) => {
+    /* ... */
+  }}
+  recycleItems
+/>
+```
+
+Reference:
+[LegendList getItemType](https://legendapp.com/open-source/list/api/props/#getitemtype-v2)
diff --git a/.agents/skills/react-native-skills/rules/list-performance-virtualize.md b/.agents/skills/react-native-skills/rules/list-performance-virtualize.md
new file mode 100644
index 0000000..8a393ba
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/list-performance-virtualize.md
@@ -0,0 +1,67 @@
+---
+title: Use a List Virtualizer for Any List
+impact: HIGH
+impactDescription: reduced memory, faster mounts
+tags: lists, performance, virtualization, scrollview
+---
+
+## Use a List Virtualizer for Any List
+
+Use a list virtualizer like LegendList or FlashList instead of ScrollView with
+mapped children—even for short lists. Virtualizers only render visible items,
+reducing memory usage and mount time. ScrollView renders all children upfront,
+which gets expensive quickly.
+
+**Incorrect (ScrollView renders all items at once):**
+
+```tsx
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <ScrollView>
+      {items.map((item) => (
+        <ItemCard key={item.id} item={item} />
+      ))}
+    </ScrollView>
+  )
+}
+// 50 items = 50 components mounted, even if only 10 visible
+```
+
+**Correct (virtualizer renders only visible items):**
+
+```tsx
+import { LegendList } from '@legendapp/list'
+
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <LegendList
+      data={items}
+      // if you aren't using React Compiler, wrap these with useCallback
+      renderItem={({ item }) => <ItemCard item={item} />}
+      keyExtractor={(item) => item.id}
+      estimatedItemSize={80}
+    />
+  )
+}
+// Only ~10-15 visible items mounted at a time
+```
+
+**Alternative (FlashList):**
+
+```tsx
+import { FlashList } from '@shopify/flash-list'
+
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <FlashList
+      data={items}
+      // if you aren't using React Compiler, wrap these with useCallback
+      renderItem={({ item }) => <ItemCard item={item} />}
+      keyExtractor={(item) => item.id}
+    />
+  )
+}
+```
+
+Benefits apply to any screen with scrollable content—profiles, settings, feeds,
+search results. Default to virtualization.
diff --git a/.agents/skills/react-native-skills/rules/monorepo-native-deps-in-app.md b/.agents/skills/react-native-skills/rules/monorepo-native-deps-in-app.md
new file mode 100644
index 0000000..ff85d76
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/monorepo-native-deps-in-app.md
@@ -0,0 +1,46 @@
+---
+title: Install Native Dependencies in App Directory
+impact: CRITICAL
+impactDescription: required for autolinking to work
+tags: monorepo, native, autolinking, installation
+---
+
+## Install Native Dependencies in App Directory
+
+In a monorepo, packages with native code must be installed in the native app's
+directory directly. Autolinking only scans the app's `node_modules`—it won't
+find native dependencies installed in other packages.
+
+**Incorrect (native dep in shared package only):**
+
+```
+packages/
+  ui/
+    package.json  # has react-native-reanimated
+  app/
+    package.json  # missing react-native-reanimated
+```
+
+Autolinking fails—native code not linked.
+
+**Correct (native dep in app directory):**
+
+```
+packages/
+  ui/
+    package.json  # has react-native-reanimated
+  app/
+    package.json  # also has react-native-reanimated
+```
+
+```json
+// packages/app/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "3.16.1"
+  }
+}
+```
+
+Even if the shared package uses the native dependency, the app must also list it
+for autolinking to detect and link the native code.
diff --git a/.agents/skills/react-native-skills/rules/monorepo-single-dependency-versions.md b/.agents/skills/react-native-skills/rules/monorepo-single-dependency-versions.md
new file mode 100644
index 0000000..1087dfa
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/monorepo-single-dependency-versions.md
@@ -0,0 +1,63 @@
+---
+title: Use Single Dependency Versions Across Monorepo
+impact: MEDIUM
+impactDescription: avoids duplicate bundles, version conflicts
+tags: monorepo, dependencies, installation
+---
+
+## Use Single Dependency Versions Across Monorepo
+
+Use a single version of each dependency across all packages in your monorepo.
+Prefer exact versions over ranges. Multiple versions cause duplicate code in
+bundles, runtime conflicts, and inconsistent behavior across packages.
+
+Use a tool like syncpack to enforce this. As a last resort, use yarn resolutions
+or npm overrides.
+
+**Incorrect (version ranges, multiple versions):**
+
+```json
+// packages/app/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "^3.0.0"
+  }
+}
+
+// packages/ui/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "^3.5.0"
+  }
+}
+```
+
+**Correct (exact versions, single source of truth):**
+
+```json
+// package.json (root)
+{
+  "pnpm": {
+    "overrides": {
+      "react-native-reanimated": "3.16.1"
+    }
+  }
+}
+
+// packages/app/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "3.16.1"
+  }
+}
+
+// packages/ui/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "3.16.1"
+  }
+}
+```
+
+Use your package manager's override/resolution feature to enforce versions at
+the root. When adding dependencies, specify exact versions without `^` or `~`.
diff --git a/.agents/skills/react-native-skills/rules/navigation-native-navigators.md b/.agents/skills/react-native-skills/rules/navigation-native-navigators.md
new file mode 100644
index 0000000..035c5fd
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/navigation-native-navigators.md
@@ -0,0 +1,188 @@
+---
+title: Use Native Navigators for Navigation
+impact: HIGH
+impactDescription: native performance, platform-appropriate UI
+tags: navigation, react-navigation, expo-router, native-stack, tabs
+---
+
+## Use Native Navigators for Navigation
+
+Always use native navigators instead of JS-based ones. Native navigators use
+platform APIs (UINavigationController on iOS, Fragment on Android) for better
+performance and native behavior.
+
+**For stacks:** Use `@react-navigation/native-stack` or expo-router's default
+stack (which uses native-stack). Avoid `@react-navigation/stack`.
+
+**For tabs:** Use `react-native-bottom-tabs` (native) or expo-router's native
+tabs. Avoid `@react-navigation/bottom-tabs` when native feel matters.
+
+### Stack Navigation
+
+**Incorrect (JS stack navigator):**
+
+```tsx
+import { createStackNavigator } from '@react-navigation/stack'
+
+const Stack = createStackNavigator()
+
+function App() {
+  return (
+    <Stack.Navigator>
+      <Stack.Screen name='Home' component={HomeScreen} />
+      <Stack.Screen name='Details' component={DetailsScreen} />
+    </Stack.Navigator>
+  )
+}
+```
+
+**Correct (native stack with react-navigation):**
+
+```tsx
+import { createNativeStackNavigator } from '@react-navigation/native-stack'
+
+const Stack = createNativeStackNavigator()
+
+function App() {
+  return (
+    <Stack.Navigator>
+      <Stack.Screen name='Home' component={HomeScreen} />
+      <Stack.Screen name='Details' component={DetailsScreen} />
+    </Stack.Navigator>
+  )
+}
+```
+
+**Correct (expo-router uses native stack by default):**
+
+```tsx
+// app/_layout.tsx
+import { Stack } from 'expo-router'
+
+export default function Layout() {
+  return <Stack />
+}
+```
+
+### Tab Navigation
+
+**Incorrect (JS bottom tabs):**
+
+```tsx
+import { createBottomTabNavigator } from '@react-navigation/bottom-tabs'
+
+const Tab = createBottomTabNavigator()
+
+function App() {
+  return (
+    <Tab.Navigator>
+      <Tab.Screen name='Home' component={HomeScreen} />
+      <Tab.Screen name='Settings' component={SettingsScreen} />
+    </Tab.Navigator>
+  )
+}
+```
+
+**Correct (native bottom tabs with react-navigation):**
+
+```tsx
+import { createNativeBottomTabNavigator } from '@bottom-tabs/react-navigation'
+
+const Tab = createNativeBottomTabNavigator()
+
+function App() {
+  return (
+    <Tab.Navigator>
+      <Tab.Screen
+        name='Home'
+        component={HomeScreen}
+        options={{
+          tabBarIcon: () => ({ sfSymbol: 'house' }),
+        }}
+      />
+      <Tab.Screen
+        name='Settings'
+        component={SettingsScreen}
+        options={{
+          tabBarIcon: () => ({ sfSymbol: 'gear' }),
+        }}
+      />
+    </Tab.Navigator>
+  )
+}
+```
+
+**Correct (expo-router native tabs):**
+
+```tsx
+// app/(tabs)/_layout.tsx
+import { NativeTabs } from 'expo-router/unstable-native-tabs'
+
+export default function TabLayout() {
+  return (
+    <NativeTabs>
+      <NativeTabs.Trigger name='index'>
+        <NativeTabs.Trigger.Label>Home</NativeTabs.Trigger.Label>
+        <NativeTabs.Trigger.Icon sf='house.fill' md='home' />
+      </NativeTabs.Trigger>
+      <NativeTabs.Trigger name='settings'>
+        <NativeTabs.Trigger.Label>Settings</NativeTabs.Trigger.Label>
+        <NativeTabs.Trigger.Icon sf='gear' md='settings' />
+      </NativeTabs.Trigger>
+    </NativeTabs>
+  )
+}
+```
+
+On iOS, native tabs automatically enable `contentInsetAdjustmentBehavior` on the
+first `ScrollView` at the root of each tab screen, so content scrolls correctly
+behind the translucent tab bar. If you need to disable this, use
+`disableAutomaticContentInsets` on the trigger.
+
+### Prefer Native Header Options Over Custom Components
+
+**Incorrect (custom header component):**
+
+```tsx
+<Stack.Screen
+  name='Profile'
+  component={ProfileScreen}
+  options={{
+    header: () => <CustomHeader title='Profile' />,
+  }}
+/>
+```
+
+**Correct (native header options):**
+
+```tsx
+<Stack.Screen
+  name='Profile'
+  component={ProfileScreen}
+  options={{
+    title: 'Profile',
+    headerLargeTitleEnabled: true,
+    headerSearchBarOptions: {
+      placeholder: 'Search',
+    },
+  }}
+/>
+```
+
+Native headers support iOS large titles, search bars, blur effects, and proper
+safe area handling automatically.
+
+### Why Native Navigators
+
+- **Performance**: Native transitions and gestures run on the UI thread
+- **Platform behavior**: Automatic iOS large titles, Android material design
+- **System integration**: Scroll-to-top on tab tap, PiP avoidance, proper safe
+  areas
+- **Accessibility**: Platform accessibility features work automatically
+
+Reference:
+
+- [React Navigation Native Stack](https://reactnavigation.org/docs/native-stack-navigator)
+- [React Native Bottom Tabs with React Navigation](https://oss.callstack.com/react-native-bottom-tabs/docs/guides/usage-with-react-navigation)
+- [React Native Bottom Tabs with Expo Router](https://oss.callstack.com/react-native-bottom-tabs/docs/guides/usage-with-expo-router)
+- [Expo Router Native Tabs](https://docs.expo.dev/router/advanced/native-tabs)
diff --git a/.agents/skills/react-native-skills/rules/react-compiler-destructure-functions.md b/.agents/skills/react-native-skills/rules/react-compiler-destructure-functions.md
new file mode 100644
index 0000000..f76c25a
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/react-compiler-destructure-functions.md
@@ -0,0 +1,50 @@
+---
+title: Destructure Functions Early in Render (React Compiler)
+impact: HIGH
+impactDescription: stable references, fewer re-renders
+tags: rerender, hooks, performance, react-compiler
+---
+
+## Destructure Functions Early in Render
+
+This rule is only applicable if you are using the React Compiler.
+
+Destructure functions from hooks at the top of render scope. Never dot into
+objects to call functions. Destructured functions are stable references; dotting
+creates new references and breaks memoization.
+
+**Incorrect (dotting into object):**
+
+```tsx
+import { useRouter } from 'expo-router'
+
+function SaveButton(props) {
+  const router = useRouter()
+
+  // bad: react-compiler will key the cache on "props" and "router", which are objects that change each render
+  const handlePress = () => {
+    props.onSave()
+    router.push('/success') // unstable reference
+  }
+
+  return <Button onPress={handlePress}>Save</Button>
+}
+```
+
+**Correct (destructure early):**
+
+```tsx
+import { useRouter } from 'expo-router'
+
+function SaveButton({ onSave }) {
+  const { push } = useRouter()
+
+  // good: react-compiler will key on push and onSave
+  const handlePress = () => {
+    onSave()
+    push('/success') // stable reference
+  }
+
+  return <Button onPress={handlePress}>Save</Button>
+}
+```
diff --git a/.agents/skills/react-native-skills/rules/react-compiler-reanimated-shared-values.md b/.agents/skills/react-native-skills/rules/react-compiler-reanimated-shared-values.md
new file mode 100644
index 0000000..0dcbaf4
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/react-compiler-reanimated-shared-values.md
@@ -0,0 +1,48 @@
+---
+title: Use .get() and .set() for Reanimated Shared Values (not .value)
+impact: LOW
+impactDescription: required for React Compiler compatibility
+tags: reanimated, react-compiler, shared-values
+---
+
+## Use .get() and .set() for Shared Values with React Compiler
+
+With React Compiler enabled, use `.get()` and `.set()` instead of reading or
+writing `.value` directly on Reanimated shared values. The compiler can't track
+property access—explicit methods ensure correct behavior.
+
+**Incorrect (breaks with React Compiler):**
+
+```tsx
+import { useSharedValue } from 'react-native-reanimated'
+
+function Counter() {
+  const count = useSharedValue(0)
+
+  const increment = () => {
+    count.value = count.value + 1 // opts out of react compiler
+  }
+
+  return <Button onPress={increment} title={`Count: ${count.value}`} />
+}
+```
+
+**Correct (React Compiler compatible):**
+
+```tsx
+import { useSharedValue } from 'react-native-reanimated'
+
+function Counter() {
+  const count = useSharedValue(0)
+
+  const increment = () => {
+    count.set(count.get() + 1)
+  }
+
+  return <Button onPress={increment} title={`Count: ${count.get()}`} />
+}
+```
+
+See the
+[Reanimated docs](https://docs.swmansion.com/react-native-reanimated/docs/core/useSharedValue/#react-compiler-support)
+for more.
diff --git a/.agents/skills/react-native-skills/rules/react-state-dispatcher.md b/.agents/skills/react-native-skills/rules/react-state-dispatcher.md
new file mode 100644
index 0000000..93e8b6d
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/react-state-dispatcher.md
@@ -0,0 +1,91 @@
+---
+title: useState Dispatch updaters for State That Depends on Current Value
+impact: MEDIUM
+impactDescription: avoids stale closures, prevents unnecessary re-renders
+tags: state, hooks, useState, callbacks
+---
+
+## Use Dispatch Updaters for State That Depends on Current Value
+
+When the next state depends on the current state, use a dispatch updater
+(`setState(prev => ...)`) instead of reading the state variable directly in a
+callback. This avoids stale closures and ensures you're comparing against the
+latest value.
+
+**Incorrect (reads state directly):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  // size may be stale in this closure
+  if (size?.width !== width || size?.height !== height) {
+    setSize({ width, height })
+  }
+}
+```
+
+**Correct (dispatch updater):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  setSize((prev) => {
+    if (prev?.width === width && prev?.height === height) return prev
+    return { width, height }
+  })
+}
+```
+
+Returning the previous value from the updater skips the re-render.
+
+For primitive states, you don't need to compare values before firing a
+re-render.
+
+**Incorrect (unnecessary comparison for primitive state):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  setSize((prev) => (prev === width ? prev : width))
+}
+```
+
+**Correct (sets primitive state directly):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  setSize(width)
+}
+```
+
+However, if the next state depends on the current state, you should still use a
+dispatch updater.
+
+**Incorrect (reads state directly from the callback):**
+
+```tsx
+const [count, setCount] = useState(0)
+
+const onTap = () => {
+  setCount(count + 1)
+}
+```
+
+**Correct (dispatch updater):**
+
+```tsx
+const [count, setCount] = useState(0)
+
+const onTap = () => {
+  setCount((prev) => prev + 1)
+}
+```
diff --git a/.agents/skills/react-native-skills/rules/react-state-fallback.md b/.agents/skills/react-native-skills/rules/react-state-fallback.md
new file mode 100644
index 0000000..204f346
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/react-state-fallback.md
@@ -0,0 +1,56 @@
+---
+title: Use fallback state instead of initialState
+impact: MEDIUM
+impactDescription: reactive fallbacks without syncing
+tags: state, hooks, derived-state, props, initialState
+---
+
+## Use fallback state instead of initialState
+
+Use `undefined` as initial state and nullish coalescing (`??`) to fall back to
+parent or server values. State represents user intent only—`undefined` means
+"user hasn't chosen yet." This enables reactive fallbacks that update when the
+source changes, not just on initial render.
+
+**Incorrect (syncs state, loses reactivity):**
+
+```tsx
+type Props = { fallbackEnabled: boolean }
+
+function Toggle({ fallbackEnabled }: Props) {
+  const [enabled, setEnabled] = useState(defaultEnabled)
+  // If fallbackEnabled changes, state is stale
+  // State mixes user intent with default value
+
+  return <Switch value={enabled} onValueChange={setEnabled} />
+}
+```
+
+**Correct (state is user intent, reactive fallback):**
+
+```tsx
+type Props = { fallbackEnabled: boolean }
+
+function Toggle({ fallbackEnabled }: Props) {
+  const [_enabled, setEnabled] = useState<boolean | undefined>(undefined)
+  const enabled = _enabled ?? defaultEnabled
+  // undefined = user hasn't touched it, falls back to prop
+  // If defaultEnabled changes, component reflects it
+  // Once user interacts, their choice persists
+
+  return <Switch value={enabled} onValueChange={setEnabled} />
+}
+```
+
+**With server data:**
+
+```tsx
+function ProfileForm({ data }: { data: User }) {
+  const [_theme, setTheme] = useState<string | undefined>(undefined)
+  const theme = _theme ?? data.theme
+  // Shows server value until user overrides
+  // Server refetch updates the fallback automatically
+
+  return <ThemePicker value={theme} onChange={setTheme} />
+}
+```
diff --git a/.agents/skills/react-native-skills/rules/react-state-minimize.md b/.agents/skills/react-native-skills/rules/react-state-minimize.md
new file mode 100644
index 0000000..64605b6
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/react-state-minimize.md
@@ -0,0 +1,65 @@
+---
+title: Minimize State Variables and Derive Values
+impact: MEDIUM
+impactDescription: fewer re-renders, less state drift
+tags: state, derived-state, hooks, optimization
+---
+
+## Minimize State Variables and Derive Values
+
+Use the fewest state variables possible. If a value can be computed from existing state or props, derive it during render instead of storing it in state. Redundant state causes unnecessary re-renders and can drift out of sync.
+
+**Incorrect (redundant state):**
+
+```tsx
+function Cart({ items }: { items: Item[] }) {
+  const [total, setTotal] = useState(0)
+  const [itemCount, setItemCount] = useState(0)
+
+  useEffect(() => {
+    setTotal(items.reduce((sum, item) => sum + item.price, 0))
+    setItemCount(items.length)
+  }, [items])
+
+  return (
+    <View>
+      <Text>{itemCount} items</Text>
+      <Text>Total: ${total}</Text>
+    </View>
+  )
+}
+```
+
+**Correct (derived values):**
+
+```tsx
+function Cart({ items }: { items: Item[] }) {
+  const total = items.reduce((sum, item) => sum + item.price, 0)
+  const itemCount = items.length
+
+  return (
+    <View>
+      <Text>{itemCount} items</Text>
+      <Text>Total: ${total}</Text>
+    </View>
+  )
+}
+```
+
+**Another example:**
+
+```tsx
+// Incorrect: storing both firstName, lastName, AND fullName
+const [firstName, setFirstName] = useState('')
+const [lastName, setLastName] = useState('')
+const [fullName, setFullName] = useState('')
+
+// Correct: derive fullName
+const [firstName, setFirstName] = useState('')
+const [lastName, setLastName] = useState('')
+const fullName = `${firstName} ${lastName}`
+```
+
+State should be the minimal source of truth. Everything else is derived.
+
+Reference: [Choosing the State Structure](https://react.dev/learn/choosing-the-state-structure)
diff --git a/.agents/skills/react-native-skills/rules/rendering-no-falsy-and.md b/.agents/skills/react-native-skills/rules/rendering-no-falsy-and.md
new file mode 100644
index 0000000..30f05d3
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/rendering-no-falsy-and.md
@@ -0,0 +1,74 @@
+---
+title: Never Use && with Potentially Falsy Values
+impact: CRITICAL
+impactDescription: prevents production crash
+tags: rendering, conditional, jsx, crash
+---
+
+## Never Use && with Potentially Falsy Values
+
+Never use `{value && <Component />}` when `value` could be an empty string or
+`0`. These are falsy but JSX-renderable—React Native will try to render them as
+text outside a `<Text>` component, causing a hard crash in production.
+
+**Incorrect (crashes if count is 0 or name is ""):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  return (
+    <View>
+      {name && <Text>{name}</Text>}
+      {count && <Text>{count} items</Text>}
+    </View>
+  )
+}
+// If name="" or count=0, renders the falsy value → crash
+```
+
+**Correct (ternary with null):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  return (
+    <View>
+      {name ? <Text>{name}</Text> : null}
+      {count ? <Text>{count} items</Text> : null}
+    </View>
+  )
+}
+```
+
+**Correct (explicit boolean coercion):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  return (
+    <View>
+      {!!name && <Text>{name}</Text>}
+      {!!count && <Text>{count} items</Text>}
+    </View>
+  )
+}
+```
+
+**Best (early return):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  if (!name) return null
+
+  return (
+    <View>
+      <Text>{name}</Text>
+      {count > 0 ? <Text>{count} items</Text> : null}
+    </View>
+  )
+}
+```
+
+Early returns are clearest. When using conditionals inline, prefer ternary or
+explicit boolean checks.
+
+**Lint rule:** Enable `react/jsx-no-leaked-render` from
+[eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-no-leaked-render.md)
+to catch this automatically.
diff --git a/.agents/skills/react-native-skills/rules/rendering-text-in-text-component.md b/.agents/skills/react-native-skills/rules/rendering-text-in-text-component.md
new file mode 100644
index 0000000..fd1b9f4
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/rendering-text-in-text-component.md
@@ -0,0 +1,36 @@
+---
+title: Wrap Strings in Text Components
+impact: CRITICAL
+impactDescription: prevents runtime crash
+tags: rendering, text, core
+---
+
+## Wrap Strings in Text Components
+
+Strings must be rendered inside `<Text>`. React Native crashes if a string is a
+direct child of `<View>`.
+
+**Incorrect (crashes):**
+
+```tsx
+import { View } from 'react-native'
+
+function Greeting({ name }: { name: string }) {
+  return <View>Hello, {name}!</View>
+}
+// Error: Text strings must be rendered within a <Text> component.
+```
+
+**Correct:**
+
+```tsx
+import { View, Text } from 'react-native'
+
+function Greeting({ name }: { name: string }) {
+  return (
+    <View>
+      <Text>Hello, {name}!</Text>
+    </View>
+  )
+}
+```
diff --git a/.agents/skills/react-native-skills/rules/scroll-position-no-state.md b/.agents/skills/react-native-skills/rules/scroll-position-no-state.md
new file mode 100644
index 0000000..a5760cd
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/scroll-position-no-state.md
@@ -0,0 +1,82 @@
+---
+title: Never Track Scroll Position in useState
+impact: HIGH
+impactDescription: prevents render thrashing during scroll
+tags: scroll, performance, reanimated, useRef
+---
+
+## Never Track Scroll Position in useState
+
+Never store scroll position in `useState`. Scroll events fire rapidly—state
+updates cause render thrashing and dropped frames. Use a Reanimated shared value
+for animations or a ref for non-reactive tracking.
+
+**Incorrect (useState causes jank):**
+
+```tsx
+import { useState } from 'react'
+import {
+  ScrollView,
+  NativeSyntheticEvent,
+  NativeScrollEvent,
+} from 'react-native'
+
+function Feed() {
+  const [scrollY, setScrollY] = useState(0)
+
+  const onScroll = (e: NativeSyntheticEvent<NativeScrollEvent>) => {
+    setScrollY(e.nativeEvent.contentOffset.y) // re-renders on every frame
+  }
+
+  return <ScrollView onScroll={onScroll} scrollEventThrottle={16} />
+}
+```
+
+**Correct (Reanimated for animations):**
+
+```tsx
+import Animated, {
+  useSharedValue,
+  useAnimatedScrollHandler,
+} from 'react-native-reanimated'
+
+function Feed() {
+  const scrollY = useSharedValue(0)
+
+  const onScroll = useAnimatedScrollHandler({
+    onScroll: (e) => {
+      scrollY.value = e.contentOffset.y // runs on UI thread, no re-render
+    },
+  })
+
+  return (
+    <Animated.ScrollView
+      onScroll={onScroll}
+      // higher number has better performance, but it fires less often.
+      // unset this if you need higher precision over performance.
+      scrollEventThrottle={16}
+    />
+  )
+}
+```
+
+**Correct (ref for non-reactive tracking):**
+
+```tsx
+import { useRef } from 'react'
+import {
+  ScrollView,
+  NativeSyntheticEvent,
+  NativeScrollEvent,
+} from 'react-native'
+
+function Feed() {
+  const scrollY = useRef(0)
+
+  const onScroll = (e: NativeSyntheticEvent<NativeScrollEvent>) => {
+    scrollY.current = e.nativeEvent.contentOffset.y // no re-render
+  }
+
+  return <ScrollView onScroll={onScroll} scrollEventThrottle={16} />
+}
+```
diff --git a/.agents/skills/react-native-skills/rules/state-ground-truth.md b/.agents/skills/react-native-skills/rules/state-ground-truth.md
new file mode 100644
index 0000000..c3c4bd9
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/state-ground-truth.md
@@ -0,0 +1,80 @@
+---
+title: State Must Represent Ground Truth
+impact: HIGH
+impactDescription: cleaner logic, easier debugging, single source of truth
+tags: state, derived-state, reanimated, hooks
+---
+
+## State Must Represent Ground Truth
+
+State variables—both React `useState` and Reanimated shared values—should
+represent the actual state of something (e.g., `pressed`, `progress`, `isOpen`),
+not derived visual values (e.g., `scale`, `opacity`, `translateY`). Derive
+visual values from state using computation or interpolation.
+
+**Incorrect (storing the visual output):**
+
+```tsx
+const scale = useSharedValue(1)
+
+const tap = Gesture.Tap()
+  .onBegin(() => {
+    scale.set(withTiming(0.95))
+  })
+  .onFinalize(() => {
+    scale.set(withTiming(1))
+  })
+
+const animatedStyle = useAnimatedStyle(() => ({
+  transform: [{ scale: scale.get() }],
+}))
+```
+
+**Correct (storing the state, deriving the visual):**
+
+```tsx
+const pressed = useSharedValue(0) // 0 = not pressed, 1 = pressed
+
+const tap = Gesture.Tap()
+  .onBegin(() => {
+    pressed.set(withTiming(1))
+  })
+  .onFinalize(() => {
+    pressed.set(withTiming(0))
+  })
+
+const animatedStyle = useAnimatedStyle(() => ({
+  transform: [{ scale: interpolate(pressed.get(), [0, 1], [1, 0.95]) }],
+}))
+```
+
+**Why this matters:**
+
+State variables should represent real "state", not necessarily a desired end
+result.
+
+1. **Single source of truth** — The state (`pressed`) describes what's
+   happening; visuals are derived
+2. **Easier to extend** — Adding opacity, rotation, or other effects just
+   requires more interpolations from the same state
+3. **Debugging** — Inspecting `pressed = 1` is clearer than `scale = 0.95`
+4. **Reusable logic** — The same `pressed` value can drive multiple visual
+   properties
+
+**Same principle for React state:**
+
+```tsx
+// Incorrect: storing derived values
+const [isExpanded, setIsExpanded] = useState(false)
+const [height, setHeight] = useState(0)
+
+useEffect(() => {
+  setHeight(isExpanded ? 200 : 0)
+}, [isExpanded])
+
+// Correct: derive from state
+const [isExpanded, setIsExpanded] = useState(false)
+const height = isExpanded ? 200 : 0
+```
+
+State is the minimal truth. Everything else is derived.
diff --git a/.agents/skills/react-native-skills/rules/ui-expo-image.md b/.agents/skills/react-native-skills/rules/ui-expo-image.md
new file mode 100644
index 0000000..72d768f
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-expo-image.md
@@ -0,0 +1,66 @@
+---
+title: Use expo-image for Optimized Images
+impact: HIGH
+impactDescription: memory efficiency, caching, blurhash placeholders, progressive loading
+tags: images, performance, expo-image, ui
+---
+
+## Use expo-image for Optimized Images
+
+Use `expo-image` instead of React Native's `Image`. It provides memory-efficient caching, blurhash placeholders, progressive loading, and better performance for lists.
+
+**Incorrect (React Native Image):**
+
+```tsx
+import { Image } from 'react-native'
+
+function Avatar({ url }: { url: string }) {
+  return <Image source={{ uri: url }} style={styles.avatar} />
+}
+```
+
+**Correct (expo-image):**
+
+```tsx
+import { Image } from 'expo-image'
+
+function Avatar({ url }: { url: string }) {
+  return <Image source={{ uri: url }} style={styles.avatar} />
+}
+```
+
+**With blurhash placeholder:**
+
+```tsx
+<Image
+  source={{ uri: url }}
+  placeholder={{ blurhash: 'LGF5]+Yk^6#M@-5c,1J5@[or[Q6.' }}
+  contentFit="cover"
+  transition={200}
+  style={styles.image}
+/>
+```
+
+**With priority and caching:**
+
+```tsx
+<Image
+  source={{ uri: url }}
+  priority="high"
+  cachePolicy="memory-disk"
+  style={styles.hero}
+/>
+```
+
+**Key props:**
+
+- `placeholder` — Blurhash or thumbnail while loading
+- `contentFit` — `cover`, `contain`, `fill`, `scale-down`
+- `transition` — Fade-in duration (ms)
+- `priority` — `low`, `normal`, `high`
+- `cachePolicy` — `memory`, `disk`, `memory-disk`, `none`
+- `recyclingKey` — Unique key for list recycling
+
+For cross-platform (web + native), use `SolitoImage` from `solito/image` which uses `expo-image` under the hood.
+
+Reference: [expo-image](https://docs.expo.dev/versions/latest/sdk/image/)
diff --git a/.agents/skills/react-native-skills/rules/ui-image-gallery.md b/.agents/skills/react-native-skills/rules/ui-image-gallery.md
new file mode 100644
index 0000000..ef26d96
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-image-gallery.md
@@ -0,0 +1,104 @@
+---
+title: Use Galeria for Image Galleries and Lightbox
+impact: MEDIUM
+impactDescription:
+  native shared element transitions, pinch-to-zoom, pan-to-close
+tags: images, gallery, lightbox, expo-image, ui
+---
+
+## Use Galeria for Image Galleries and Lightbox
+
+For image galleries with lightbox (tap to fullscreen), use `@nandorojo/galeria`.
+It provides native shared element transitions with pinch-to-zoom, double-tap
+zoom, and pan-to-close. Works with any image component including `expo-image`.
+
+**Incorrect (custom modal implementation):**
+
+```tsx
+function ImageGallery({ urls }: { urls: string[] }) {
+  const [selected, setSelected] = useState<string | null>(null)
+
+  return (
+    <>
+      {urls.map((url) => (
+        <Pressable key={url} onPress={() => setSelected(url)}>
+          <Image source={{ uri: url }} style={styles.thumbnail} />
+        </Pressable>
+      ))}
+      <Modal visible={!!selected} onRequestClose={() => setSelected(null)}>
+        <Image source={{ uri: selected! }} style={styles.fullscreen} />
+      </Modal>
+    </>
+  )
+}
+```
+
+**Correct (Galeria with expo-image):**
+
+```tsx
+import { Galeria } from '@nandorojo/galeria'
+import { Image } from 'expo-image'
+
+function ImageGallery({ urls }: { urls: string[] }) {
+  return (
+    <Galeria urls={urls}>
+      {urls.map((url, index) => (
+        <Galeria.Image index={index} key={url}>
+          <Image source={{ uri: url }} style={styles.thumbnail} />
+        </Galeria.Image>
+      ))}
+    </Galeria>
+  )
+}
+```
+
+**Single image:**
+
+```tsx
+import { Galeria } from '@nandorojo/galeria'
+import { Image } from 'expo-image'
+
+function Avatar({ url }: { url: string }) {
+  return (
+    <Galeria urls={[url]}>
+      <Galeria.Image>
+        <Image source={{ uri: url }} style={styles.avatar} />
+      </Galeria.Image>
+    </Galeria>
+  )
+}
+```
+
+**With low-res thumbnails and high-res fullscreen:**
+
+```tsx
+<Galeria urls={highResUrls}>
+  {lowResUrls.map((url, index) => (
+    <Galeria.Image index={index} key={url}>
+      <Image source={{ uri: url }} style={styles.thumbnail} />
+    </Galeria.Image>
+  ))}
+</Galeria>
+```
+
+**With FlashList:**
+
+```tsx
+<Galeria urls={urls}>
+  <FlashList
+    data={urls}
+    renderItem={({ item, index }) => (
+      <Galeria.Image index={index}>
+        <Image source={{ uri: item }} style={styles.thumbnail} />
+      </Galeria.Image>
+    )}
+    numColumns={3}
+    estimatedItemSize={100}
+  />
+</Galeria>
+```
+
+Works with `expo-image`, `SolitoImage`, `react-native` Image, or any image
+component.
+
+Reference: [Galeria](https://github.com/nandorojo/galeria)
diff --git a/.agents/skills/react-native-skills/rules/ui-measure-views.md b/.agents/skills/react-native-skills/rules/ui-measure-views.md
new file mode 100644
index 0000000..8b783fe
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-measure-views.md
@@ -0,0 +1,78 @@
+---
+title: Measuring View Dimensions
+impact: MEDIUM
+impactDescription: synchronous measurement, avoid unnecessary re-renders
+tags: layout, measurement, onLayout, useLayoutEffect
+---
+
+## Measuring View Dimensions
+
+Use both `useLayoutEffect` (synchronous) and `onLayout` (for updates). The sync
+measurement gives you the initial size immediately; `onLayout` keeps it current
+when the view changes. For non-primitive states, use a dispatch updater to
+compare values and avoid unnecessary re-renders.
+
+**Height only:**
+
+```tsx
+import { useLayoutEffect, useRef, useState } from 'react'
+import { View, LayoutChangeEvent } from 'react-native'
+
+function MeasuredBox({ children }: { children: React.ReactNode }) {
+  const ref = useRef<View>(null)
+  const [height, setHeight] = useState<number | undefined>(undefined)
+
+  useLayoutEffect(() => {
+    // Sync measurement on mount (RN 0.82+)
+    const rect = ref.current?.getBoundingClientRect()
+    if (rect) setHeight(rect.height)
+    // Pre-0.82: ref.current?.measure((x, y, w, h) => setHeight(h))
+  }, [])
+
+  const onLayout = (e: LayoutChangeEvent) => {
+    setHeight(e.nativeEvent.layout.height)
+  }
+
+  return (
+    <View ref={ref} onLayout={onLayout}>
+      {children}
+    </View>
+  )
+}
+```
+
+**Both dimensions:**
+
+```tsx
+import { useLayoutEffect, useRef, useState } from 'react'
+import { View, LayoutChangeEvent } from 'react-native'
+
+type Size = { width: number; height: number }
+
+function MeasuredBox({ children }: { children: React.ReactNode }) {
+  const ref = useRef<View>(null)
+  const [size, setSize] = useState<Size | undefined>(undefined)
+
+  useLayoutEffect(() => {
+    const rect = ref.current?.getBoundingClientRect()
+    if (rect) setSize({ width: rect.width, height: rect.height })
+  }, [])
+
+  const onLayout = (e: LayoutChangeEvent) => {
+    const { width, height } = e.nativeEvent.layout
+    setSize((prev) => {
+      // for non-primitive states, compare values before firing a re-render
+      if (prev?.width === width && prev?.height === height) return prev
+      return { width, height }
+    })
+  }
+
+  return (
+    <View ref={ref} onLayout={onLayout}>
+      {children}
+    </View>
+  )
+}
+```
+
+Use functional setState to compare—don't read state directly in the callback.
diff --git a/.agents/skills/react-native-skills/rules/ui-menus.md b/.agents/skills/react-native-skills/rules/ui-menus.md
new file mode 100644
index 0000000..5168bc2
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-menus.md
@@ -0,0 +1,174 @@
+---
+title: Use Native Menus for Dropdowns and Context Menus
+impact: HIGH
+impactDescription: native accessibility, platform-consistent UX
+tags: user-interface, menus, context-menus, zeego, accessibility
+---
+
+## Use Native Menus for Dropdowns and Context Menus
+
+Use native platform menus instead of custom JS implementations. Native menus
+provide built-in accessibility, consistent platform UX, and better performance.
+Use [zeego](https://zeego.dev) for cross-platform native menus.
+
+**Incorrect (custom JS menu):**
+
+```tsx
+import { useState } from 'react'
+import { View, Pressable, Text } from 'react-native'
+
+function MyMenu() {
+  const [open, setOpen] = useState(false)
+
+  return (
+    <View>
+      <Pressable onPress={() => setOpen(!open)}>
+        <Text>Open Menu</Text>
+      </Pressable>
+      {open && (
+        <View style={{ position: 'absolute', top: 40 }}>
+          <Pressable onPress={() => console.log('edit')}>
+            <Text>Edit</Text>
+          </Pressable>
+          <Pressable onPress={() => console.log('delete')}>
+            <Text>Delete</Text>
+          </Pressable>
+        </View>
+      )}
+    </View>
+  )
+}
+```
+
+**Correct (native menu with zeego):**
+
+```tsx
+import * as DropdownMenu from 'zeego/dropdown-menu'
+
+function MyMenu() {
+  return (
+    <DropdownMenu.Root>
+      <DropdownMenu.Trigger>
+        <Pressable>
+          <Text>Open Menu</Text>
+        </Pressable>
+      </DropdownMenu.Trigger>
+
+      <DropdownMenu.Content>
+        <DropdownMenu.Item key='edit' onSelect={() => console.log('edit')}>
+          <DropdownMenu.ItemTitle>Edit</DropdownMenu.ItemTitle>
+        </DropdownMenu.Item>
+
+        <DropdownMenu.Item
+          key='delete'
+          destructive
+          onSelect={() => console.log('delete')}
+        >
+          <DropdownMenu.ItemTitle>Delete</DropdownMenu.ItemTitle>
+        </DropdownMenu.Item>
+      </DropdownMenu.Content>
+    </DropdownMenu.Root>
+  )
+}
+```
+
+**Context menu (long-press):**
+
+```tsx
+import * as ContextMenu from 'zeego/context-menu'
+
+function MyContextMenu() {
+  return (
+    <ContextMenu.Root>
+      <ContextMenu.Trigger>
+        <View style={{ padding: 20 }}>
+          <Text>Long press me</Text>
+        </View>
+      </ContextMenu.Trigger>
+
+      <ContextMenu.Content>
+        <ContextMenu.Item key='copy' onSelect={() => console.log('copy')}>
+          <ContextMenu.ItemTitle>Copy</ContextMenu.ItemTitle>
+        </ContextMenu.Item>
+
+        <ContextMenu.Item key='paste' onSelect={() => console.log('paste')}>
+          <ContextMenu.ItemTitle>Paste</ContextMenu.ItemTitle>
+        </ContextMenu.Item>
+      </ContextMenu.Content>
+    </ContextMenu.Root>
+  )
+}
+```
+
+**Checkbox items:**
+
+```tsx
+import * as DropdownMenu from 'zeego/dropdown-menu'
+
+function SettingsMenu() {
+  const [notifications, setNotifications] = useState(true)
+
+  return (
+    <DropdownMenu.Root>
+      <DropdownMenu.Trigger>
+        <Pressable>
+          <Text>Settings</Text>
+        </Pressable>
+      </DropdownMenu.Trigger>
+
+      <DropdownMenu.Content>
+        <DropdownMenu.CheckboxItem
+          key='notifications'
+          value={notifications}
+          onValueChange={() => setNotifications((prev) => !prev)}
+        >
+          <DropdownMenu.ItemIndicator />
+          <DropdownMenu.ItemTitle>Notifications</DropdownMenu.ItemTitle>
+        </DropdownMenu.CheckboxItem>
+      </DropdownMenu.Content>
+    </DropdownMenu.Root>
+  )
+}
+```
+
+**Submenus:**
+
+```tsx
+import * as DropdownMenu from 'zeego/dropdown-menu'
+
+function MenuWithSubmenu() {
+  return (
+    <DropdownMenu.Root>
+      <DropdownMenu.Trigger>
+        <Pressable>
+          <Text>Options</Text>
+        </Pressable>
+      </DropdownMenu.Trigger>
+
+      <DropdownMenu.Content>
+        <DropdownMenu.Item key='home' onSelect={() => console.log('home')}>
+          <DropdownMenu.ItemTitle>Home</DropdownMenu.ItemTitle>
+        </DropdownMenu.Item>
+
+        <DropdownMenu.Sub>
+          <DropdownMenu.SubTrigger key='more'>
+            <DropdownMenu.ItemTitle>More Options</DropdownMenu.ItemTitle>
+          </DropdownMenu.SubTrigger>
+
+          <DropdownMenu.SubContent>
+            <DropdownMenu.Item key='settings'>
+              <DropdownMenu.ItemTitle>Settings</DropdownMenu.ItemTitle>
+            </DropdownMenu.Item>
+
+            <DropdownMenu.Item key='help'>
+              <DropdownMenu.ItemTitle>Help</DropdownMenu.ItemTitle>
+            </DropdownMenu.Item>
+          </DropdownMenu.SubContent>
+        </DropdownMenu.Sub>
+      </DropdownMenu.Content>
+    </DropdownMenu.Root>
+  )
+}
+```
+
+Reference: [Zeego Documentation](https://zeego.dev/components/dropdown-menu)
diff --git a/.agents/skills/react-native-skills/rules/ui-native-modals.md b/.agents/skills/react-native-skills/rules/ui-native-modals.md
new file mode 100644
index 0000000..f560e11
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-native-modals.md
@@ -0,0 +1,77 @@
+---
+title: Use Native Modals Over JS-Based Bottom Sheets
+impact: HIGH
+impactDescription: native performance, gestures, accessibility
+tags: modals, bottom-sheet, native, react-navigation
+---
+
+## Use Native Modals Over JS-Based Bottom Sheets
+
+Use native `<Modal>` with `presentationStyle="formSheet"` or React Navigation
+v7's native form sheet instead of JS-based bottom sheet libraries. Native modals
+have built-in gestures, accessibility, and better performance. Rely on native UI
+for low-level primitives.
+
+**Incorrect (JS-based bottom sheet):**
+
+```tsx
+import BottomSheet from 'custom-js-bottom-sheet'
+
+function MyScreen() {
+  const sheetRef = useRef<BottomSheet>(null)
+
+  return (
+    <View style={{ flex: 1 }}>
+      <Button onPress={() => sheetRef.current?.expand()} title='Open' />
+      <BottomSheet ref={sheetRef} snapPoints={['50%', '90%']}>
+        <View>
+          <Text>Sheet content</Text>
+        </View>
+      </BottomSheet>
+    </View>
+  )
+}
+```
+
+**Correct (native Modal with formSheet):**
+
+```tsx
+import { Modal, View, Text, Button } from 'react-native'
+
+function MyScreen() {
+  const [visible, setVisible] = useState(false)
+
+  return (
+    <View style={{ flex: 1 }}>
+      <Button onPress={() => setVisible(true)} title='Open' />
+      <Modal
+        visible={visible}
+        presentationStyle='formSheet'
+        animationType='slide'
+        onRequestClose={() => setVisible(false)}
+      >
+        <View>
+          <Text>Sheet content</Text>
+        </View>
+      </Modal>
+    </View>
+  )
+}
+```
+
+**Correct (React Navigation v7 native form sheet):**
+
+```tsx
+// In your navigator
+<Stack.Screen
+  name='Details'
+  component={DetailsScreen}
+  options={{
+    presentation: 'formSheet',
+    sheetAllowedDetents: 'fitToContents',
+  }}
+/>
+```
+
+Native modals provide swipe-to-dismiss, proper keyboard avoidance, and
+accessibility out of the box.
diff --git a/.agents/skills/react-native-skills/rules/ui-pressable.md b/.agents/skills/react-native-skills/rules/ui-pressable.md
new file mode 100644
index 0000000..31c3d20
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-pressable.md
@@ -0,0 +1,61 @@
+---
+title: Use Pressable Instead of Touchable Components
+impact: LOW
+impactDescription: modern API, more flexible
+tags: ui, pressable, touchable, gestures
+---
+
+## Use Pressable Instead of Touchable Components
+
+Never use `TouchableOpacity` or `TouchableHighlight`. Use `Pressable` from
+`react-native` or `react-native-gesture-handler` instead.
+
+**Incorrect (legacy Touchable components):**
+
+```tsx
+import { TouchableOpacity } from 'react-native'
+
+function MyButton({ onPress }: { onPress: () => void }) {
+  return (
+    <TouchableOpacity onPress={onPress} activeOpacity={0.7}>
+      <Text>Press me</Text>
+    </TouchableOpacity>
+  )
+}
+```
+
+**Correct (Pressable):**
+
+```tsx
+import { Pressable } from 'react-native'
+
+function MyButton({ onPress }: { onPress: () => void }) {
+  return (
+    <Pressable onPress={onPress}>
+      <Text>Press me</Text>
+    </Pressable>
+  )
+}
+```
+
+**Correct (Pressable from gesture handler for lists):**
+
+```tsx
+import { Pressable } from 'react-native-gesture-handler'
+
+function ListItem({ onPress }: { onPress: () => void }) {
+  return (
+    <Pressable onPress={onPress}>
+      <Text>Item</Text>
+    </Pressable>
+  )
+}
+```
+
+Use `react-native-gesture-handler` Pressable inside scrollable lists for better
+gesture coordination, as long as you are using the ScrollView from
+`react-native-gesture-handler` as well.
+
+**For animated press states (scale, opacity changes):** Use `GestureDetector`
+with Reanimated shared values instead of Pressable's style callback. See the
+`animation-gesture-detector-press` rule.
diff --git a/.agents/skills/react-native-skills/rules/ui-safe-area-scroll.md b/.agents/skills/react-native-skills/rules/ui-safe-area-scroll.md
new file mode 100644
index 0000000..79812bc
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-safe-area-scroll.md
@@ -0,0 +1,65 @@
+---
+title: Use contentInsetAdjustmentBehavior for Safe Areas
+impact: MEDIUM
+impactDescription: native safe area handling, no layout shifts
+tags: safe-area, scrollview, layout
+---
+
+## Use contentInsetAdjustmentBehavior for Safe Areas
+
+Use `contentInsetAdjustmentBehavior="automatic"` on the root ScrollView instead of wrapping content in SafeAreaView or manual padding. This lets iOS handle safe area insets natively with proper scroll behavior.
+
+**Incorrect (SafeAreaView wrapper):**
+
+```tsx
+import { SafeAreaView, ScrollView, View, Text } from 'react-native'
+
+function MyScreen() {
+  return (
+    <SafeAreaView style={{ flex: 1 }}>
+      <ScrollView>
+        <View>
+          <Text>Content</Text>
+        </View>
+      </ScrollView>
+    </SafeAreaView>
+  )
+}
+```
+
+**Incorrect (manual safe area padding):**
+
+```tsx
+import { ScrollView, View, Text } from 'react-native'
+import { useSafeAreaInsets } from 'react-native-safe-area-context'
+
+function MyScreen() {
+  const insets = useSafeAreaInsets()
+
+  return (
+    <ScrollView contentContainerStyle={{ paddingTop: insets.top }}>
+      <View>
+        <Text>Content</Text>
+      </View>
+    </ScrollView>
+  )
+}
+```
+
+**Correct (native content inset adjustment):**
+
+```tsx
+import { ScrollView, View, Text } from 'react-native'
+
+function MyScreen() {
+  return (
+    <ScrollView contentInsetAdjustmentBehavior='automatic'>
+      <View>
+        <Text>Content</Text>
+      </View>
+    </ScrollView>
+  )
+}
+```
+
+The native approach handles dynamic safe areas (keyboard, toolbars) and allows content to scroll behind the status bar naturally.
diff --git a/.agents/skills/react-native-skills/rules/ui-scrollview-content-inset.md b/.agents/skills/react-native-skills/rules/ui-scrollview-content-inset.md
new file mode 100644
index 0000000..bbebc3b
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-scrollview-content-inset.md
@@ -0,0 +1,45 @@
+---
+title: Use contentInset for Dynamic ScrollView Spacing
+impact: LOW
+impactDescription: smoother updates, no layout recalculation
+tags: scrollview, layout, contentInset, performance
+---
+
+## Use contentInset for Dynamic ScrollView Spacing
+
+When adding space to the top or bottom of a ScrollView that may change
+(keyboard, toolbars, dynamic content), use `contentInset` instead of padding.
+Changing `contentInset` doesn't trigger layout recalculation—it adjusts the
+scroll area without re-rendering content.
+
+**Incorrect (padding causes layout recalculation):**
+
+```tsx
+function Feed({ bottomOffset }: { bottomOffset: number }) {
+  return (
+    <ScrollView contentContainerStyle={{ paddingBottom: bottomOffset }}>
+      {children}
+    </ScrollView>
+  )
+}
+// Changing bottomOffset triggers full layout recalculation
+```
+
+**Correct (contentInset for dynamic spacing):**
+
+```tsx
+function Feed({ bottomOffset }: { bottomOffset: number }) {
+  return (
+    <ScrollView
+      contentInset={{ bottom: bottomOffset }}
+      scrollIndicatorInsets={{ bottom: bottomOffset }}
+    >
+      {children}
+    </ScrollView>
+  )
+}
+// Changing bottomOffset only adjusts scroll bounds
+```
+
+Use `scrollIndicatorInsets` alongside `contentInset` to keep the scroll
+indicator aligned. For static spacing that never changes, padding is fine.
diff --git a/.agents/skills/react-native-skills/rules/ui-styling.md b/.agents/skills/react-native-skills/rules/ui-styling.md
new file mode 100644
index 0000000..3908de3
--- /dev/null
+++ b/.agents/skills/react-native-skills/rules/ui-styling.md
@@ -0,0 +1,87 @@
+---
+title: Modern React Native Styling Patterns
+impact: MEDIUM
+impactDescription: consistent design, smoother borders, cleaner layouts
+tags: styling, css, layout, shadows, gradients
+---
+
+## Modern React Native Styling Patterns
+
+Follow these styling patterns for cleaner, more consistent React Native code.
+
+**Always use `borderCurve: 'continuous'` with `borderRadius`:**
+
+```tsx
+// Incorrect
+{ borderRadius: 12 }
+
+// Correct – smoother iOS-style corners
+{ borderRadius: 12, borderCurve: 'continuous' }
+```
+
+**Use `gap` instead of margin for spacing between elements:**
+
+```tsx
+// Incorrect – margin on children
+<View>
+  <Text style={{ marginBottom: 8 }}>Title</Text>
+  <Text style={{ marginBottom: 8 }}>Subtitle</Text>
+</View>
+
+// Correct – gap on parent
+<View style={{ gap: 8 }}>
+  <Text>Title</Text>
+  <Text>Subtitle</Text>
+</View>
+```
+
+**Use `padding` for space within, `gap` for space between:**
+
+```tsx
+<View style={{ padding: 16, gap: 12 }}>
+  <Text>First</Text>
+  <Text>Second</Text>
+</View>
+```
+
+**Use `experimental_backgroundImage` for linear gradients:**
+
+```tsx
+// Incorrect – third-party gradient library
+<LinearGradient colors={['#000', '#fff']} />
+
+// Correct – native CSS gradient syntax
+<View
+  style={{
+    experimental_backgroundImage: 'linear-gradient(to bottom, #000, #fff)',
+  }}
+/>
+```
+
+**Use CSS `boxShadow` string syntax for shadows:**
+
+```tsx
+// Incorrect – legacy shadow objects or elevation
+{ shadowColor: '#000', shadowOffset: { width: 0, height: 2 }, shadowOpacity: 0.1 }
+{ elevation: 4 }
+
+// Correct – CSS box-shadow syntax
+{ boxShadow: '0 2px 8px rgba(0, 0, 0, 0.1)' }
+```
+
+**Avoid multiple font sizes – use weight and color for emphasis:**
+
+```tsx
+// Incorrect – varying font sizes for hierarchy
+<Text style={{ fontSize: 18 }}>Title</Text>
+<Text style={{ fontSize: 14 }}>Subtitle</Text>
+<Text style={{ fontSize: 12 }}>Caption</Text>
+
+// Correct – consistent size, vary weight and color
+<Text style={{ fontWeight: '600' }}>Title</Text>
+<Text style={{ color: '#666' }}>Subtitle</Text>
+<Text style={{ color: '#999' }}>Caption</Text>
+```
+
+Limiting font sizes creates visual consistency. Use `fontWeight` (bold/semibold)
+and grayscale colors for hierarchy instead.
diff --git a/.agents/skills/setup-matt-pocock-skills/SKILL.md b/.agents/skills/setup-matt-pocock-skills/SKILL.md
new file mode 100644
index 0000000..1ebc6e1
--- /dev/null
+++ b/.agents/skills/setup-matt-pocock-skills/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: setup-matt-pocock-skills
+description: Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
+disable-model-invocation: true
+---
+
+# Setup Matt Pocock's Skills
+
+Scaffold the per-repo configuration that the engineering skills assume:
+
+- **Issue tracker** — where issues live (GitHub by default; local markdown is also supported out of the box)
+- **Triage labels** — the strings used for the five canonical triage roles
+- **Domain docs** — where `CONTEXT.md` and ADRs live, and the consumer rules for reading them
+
+This is a prompt-driven skill, not a deterministic script. Explore, present what you found, confirm with the user, then write.
+
+## Process
+
+### 1. Explore
+
+Look at the current repo to understand its starting state. Read whatever exists; don't assume:
+
+- `git remote -v` and `.git/config` — is this a GitHub repo? Which one?
+- `AGENTS.md` and `CLAUDE.md` at the repo root — does either exist? Is there already an `## Agent skills` section in either?
+- `CONTEXT.md` and `CONTEXT-MAP.md` at the repo root
+- `docs/adr/` and any `src/*/docs/adr/` directories
+- `docs/agents/` — does this skill's prior output already exist?
+- `.scratch/` — sign that a local-markdown issue tracker convention is already in use
+
+### 2. Present findings and ask
+
+Summarise what's present and what's missing. Then walk the user through the three decisions **one at a time** — present a section, get the user's answer, then move to the next. Don't dump all three at once.
+
+Assume the user does not know what these terms mean. Each section starts with a short explainer (what it is, why these skills need it, what changes if they pick differently). Then show the choices and the default.
+
+**Section A — Issue tracker.**
+
+> Explainer: The "issue tracker" is where issues live for this repo. Skills like `to-issues`, `triage`, `to-prd`, and `qa` read from and write to it — they need to know whether to call `gh issue create`, write a markdown file under `.scratch/`, or follow some other workflow you describe. Pick the place you actually track work for this repo.
+
+Default posture: these skills were designed for GitHub. If a `git remote` points at GitHub, propose that. If a `git remote` points at GitLab (`gitlab.com` or a self-hosted host), propose GitLab. Otherwise (or if the user prefers), offer:
+
+- **GitHub** — issues live in the repo's GitHub Issues (uses the `gh` CLI)
+- **GitLab** — issues live in the repo's GitLab Issues (uses the [`glab`](https://gitlab.com/gitlab-org/cli) CLI)
+- **Local markdown** — issues live as files under `.scratch/<feature>/` in this repo (good for solo projects or repos without a remote)
+- **Other** (Jira, Linear, etc.) — ask the user to describe the workflow in one paragraph; the skill will record it as freeform prose
+
+**Section B — Triage label vocabulary.**
+
+> Explainer: When the `triage` skill processes an incoming issue, it moves it through a state machine — needs evaluation, waiting on reporter, ready for an AFK agent to pick up, ready for a human, or won't fix. To do that, it needs to apply labels (or the equivalent in your issue tracker) that match strings *you've actually configured*. If your repo already uses different label names (e.g. `bug:triage` instead of `needs-triage`), map them here so the skill applies the right ones instead of creating duplicates.
+
+The five canonical roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter
+- `ready-for-agent` — fully specified, AFK-ready (an agent can pick it up with no human context)
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Default: each role's string equals its name. Ask the user if they want to override any. If their issue tracker has no existing labels, the defaults are fine.
+
+**Section C — Domain docs.**
+
+> Explainer: Some skills (`improve-codebase-architecture`, `diagnose`, `tdd`) read a `CONTEXT.md` file to learn the project's domain language, and `docs/adr/` for past architectural decisions. They need to know whether the repo has one global context or multiple (e.g. a monorepo with separate frontend/backend contexts) so they look in the right place.
+
+Confirm the layout:
+
+- **Single-context** — one `CONTEXT.md` + `docs/adr/` at the repo root. Most repos are this.
+- **Multi-context** — `CONTEXT-MAP.md` at the root pointing to per-context `CONTEXT.md` files (typically a monorepo).
+
+### 3. Confirm and edit
+
+Show the user a draft of:
+
+- The `## Agent skills` block to add to whichever of `CLAUDE.md` / `AGENTS.md` is being edited (see step 4 for selection rules)
+- The contents of `docs/agents/issue-tracker.md`, `docs/agents/triage-labels.md`, `docs/agents/domain.md`
+
+Let them edit before writing.
+
+### 4. Write
+
+**Pick the file to edit:**
+
+- If `CLAUDE.md` exists, edit it.
+- Else if `AGENTS.md` exists, edit it.
+- If neither exists, ask the user which one to create — don't pick for them.
+
+Never create `AGENTS.md` when `CLAUDE.md` already exists (or vice versa) — always edit the one that's already there.
+
+If an `## Agent skills` block already exists in the chosen file, update its contents in-place rather than appending a duplicate. Don't overwrite user edits to the surrounding sections.
+
+The block:
+
+```markdown
+## Agent skills
+
+### Issue tracker
+
+[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
+```
+
+Then write the three docs files using the seed templates in this skill folder as a starting point:
+
+- [issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker
+- [issue-tracker-gitlab.md](./issue-tracker-gitlab.md) — GitLab issue tracker
+- [issue-tracker-local.md](./issue-tracker-local.md) — local-markdown issue tracker
+- [triage-labels.md](./triage-labels.md) — label mapping
+- [domain.md](./domain.md) — domain doc consumer rules + layout
+
+For "other" issue trackers, write `docs/agents/issue-tracker.md` from scratch using the user's description.
+
+### 5. Done
+
+Tell the user the setup is complete and which engineering skills will now read from these files. Mention they can edit `docs/agents/*.md` directly later — re-running this skill is only necessary if they want to switch issue trackers or restart from scratch.
diff --git a/.agents/skills/setup-matt-pocock-skills/domain.md b/.agents/skills/setup-matt-pocock-skills/domain.md
new file mode 100644
index 0000000..c97d6a6
--- /dev/null
+++ b/.agents/skills/setup-matt-pocock-skills/domain.md
@@ -0,0 +1,51 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT.md`** at the repo root, or
+- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The producer skill (`/grill-with-docs`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo (most repos):
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-event-sourced-orders.md
+│   └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/adr/                          ← system-wide decisions
+└── src/
+    ├── ordering/
+    │   ├── CONTEXT.md
+    │   └── docs/adr/                  ← context-specific decisions
+    └── billing/
+        ├── CONTEXT.md
+        └── docs/adr/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/grill-with-docs`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_
diff --git a/.agents/skills/setup-matt-pocock-skills/issue-tracker-github.md b/.agents/skills/setup-matt-pocock-skills/issue-tracker-github.md
new file mode 100644
index 0000000..cce77ec
--- /dev/null
+++ b/.agents/skills/setup-matt-pocock-skills/issue-tracker-github.md
@@ -0,0 +1,22 @@
+# Issue tracker: GitHub
+
+Issues and PRDs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
+
+Infer the repo from `git remote -v` — `gh` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitHub issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `gh issue view <number> --comments`.
diff --git a/.agents/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md b/.agents/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
new file mode 100644
index 0000000..f54da95
--- /dev/null
+++ b/.agents/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
@@ -0,0 +1,23 @@
+# Issue tracker: GitLab
+
+Issues and PRDs for this repo live as GitLab issues. Use the [`glab`](https://gitlab.com/gitlab-org/cli) CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `glab issue create --title "..." --description "..."`. Use a heredoc for multi-line descriptions. Pass `--description -` to open an editor.
+- **Read an issue**: `glab issue view <number> --comments`. Use `-F json` for machine-readable output.
+- **List issues**: `glab issue list -F json` with appropriate `--label` filters.
+- **Comment on an issue**: `glab issue note <number> --message "..."`. GitLab calls comments "notes".
+- **Apply / remove labels**: `glab issue update <number> --label "..."` / `--unlabel "..."`. Multiple labels can be comma-separated or by repeating the flag.
+- **Close**: `glab issue close <number>`. `glab issue close` does not accept a closing comment, so post the explanation first with `glab issue note <number> --message "..."`, then close.
+- **Merge requests**: GitLab calls PRs "merge requests". Use `glab mr create`, `glab mr view`, `glab mr note`, etc. — the same shape as `gh pr ...` with `mr` in place of `pr` and `note`/`--message` in place of `comment`/`--body`.
+
+Infer the repo from `git remote -v` — `glab` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitLab issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `glab issue view <number> --comments`.
diff --git a/.agents/skills/setup-matt-pocock-skills/issue-tracker-local.md b/.agents/skills/setup-matt-pocock-skills/issue-tracker-local.md
new file mode 100644
index 0000000..a2f08fb
--- /dev/null
+++ b/.agents/skills/setup-matt-pocock-skills/issue-tracker-local.md
@@ -0,0 +1,19 @@
+# Issue tracker: Local Markdown
+
+Issues and PRDs for this repo live as markdown files in `.scratch/`.
+
+## Conventions
+
+- One feature per directory: `.scratch/<feature-slug>/`
+- The PRD is `.scratch/<feature-slug>/PRD.md`
+- Implementation issues are `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01`
+- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
+- Comments and conversation history append to the bottom of the file under a `## Comments` heading
+
+## When a skill says "publish to the issue tracker"
+
+Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).
+
+## When a skill says "fetch the relevant ticket"
+
+Read the file at the referenced path. The user will normally pass the path or the issue number directly.
diff --git a/.agents/skills/setup-matt-pocock-skills/triage-labels.md b/.agents/skills/setup-matt-pocock-skills/triage-labels.md
new file mode 100644
index 0000000..b716855
--- /dev/null
+++ b/.agents/skills/setup-matt-pocock-skills/triage-labels.md
@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.
diff --git a/.agents/skills/skill-creator/LICENSE.txt b/.agents/skills/skill-creator/LICENSE.txt
new file mode 100644
index 0000000..7a4a3ea
--- /dev/null
+++ b/.agents/skills/skill-creator/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
\ No newline at end of file
diff --git a/.agents/skills/skill-creator/SKILL.md b/.agents/skills/skill-creator/SKILL.md
new file mode 100644
index 0000000..6399fa1
--- /dev/null
+++ b/.agents/skills/skill-creator/SKILL.md
@@ -0,0 +1,356 @@
+---
+name: skill-creator
+description: Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
+license: Complete terms in LICENSE.txt
+---
+
+# Skill Creator
+
+This skill provides guidance for creating effective skills.
+
+## About Skills
+
+Skills are modular, self-contained packages that extend Codex's capabilities by providing
+specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific
+domains or tasks—they transform Codex from a general-purpose agent into a specialized agent
+equipped with procedural knowledge that no model can fully possess.
+
+### What Skills Provide
+
+1. Specialized workflows - Multi-step procedures for specific domains
+2. Tool integrations - Instructions for working with specific file formats or APIs
+3. Domain expertise - Company-specific knowledge, schemas, business logic
+4. Bundled resources - Scripts, references, and assets for complex and repetitive tasks
+
+## Core Principles
+
+### Concise is Key
+
+The context window is a public good. Skills share the context window with everything else Codex needs: system prompt, conversation history, other Skills' metadata, and the actual user request.
+
+**Default assumption: Codex is already very smart.** Only add context Codex doesn't already have. Challenge each piece of information: "Does Codex really need this explanation?" and "Does this paragraph justify its token cost?"
+
+Prefer concise examples over verbose explanations.
+
+### Set Appropriate Degrees of Freedom
+
+Match the level of specificity to the task's fragility and variability:
+
+**High freedom (text-based instructions)**: Use when multiple approaches are valid, decisions depend on context, or heuristics guide the approach.
+
+**Medium freedom (pseudocode or scripts with parameters)**: Use when a preferred pattern exists, some variation is acceptable, or configuration affects behavior.
+
+**Low freedom (specific scripts, few parameters)**: Use when operations are fragile and error-prone, consistency is critical, or a specific sequence must be followed.
+
+Think of Codex as exploring a path: a narrow bridge with cliffs needs specific guardrails (low freedom), while an open field allows many routes (high freedom).
+
+### Anatomy of a Skill
+
+Every skill consists of a required SKILL.md file and optional bundled resources:
+
+```
+skill-name/
+├── SKILL.md (required)
+│   ├── YAML frontmatter metadata (required)
+│   │   ├── name: (required)
+│   │   └── description: (required)
+│   └── Markdown instructions (required)
+└── Bundled Resources (optional)
+    ├── scripts/          - Executable code (Python/Bash/etc.)
+    ├── references/       - Documentation intended to be loaded into context as needed
+    └── assets/           - Files used in output (templates, icons, fonts, etc.)
+```
+
+#### SKILL.md (required)
+
+Every SKILL.md consists of:
+
+- **Frontmatter** (YAML): Contains `name` and `description` fields. These are the only fields that Codex reads to determine when the skill gets used, thus it is very important to be clear and comprehensive in describing what the skill is, and when it should be used.
+- **Body** (Markdown): Instructions and guidance for using the skill. Only loaded AFTER the skill triggers (if at all).
+
+#### Bundled Resources (optional)
+
+##### Scripts (`scripts/`)
+
+Executable code (Python/Bash/etc.) for tasks that require deterministic reliability or are repeatedly rewritten.
+
+- **When to include**: When the same code is being rewritten repeatedly or deterministic reliability is needed
+- **Example**: `scripts/rotate_pdf.py` for PDF rotation tasks
+- **Benefits**: Token efficient, deterministic, may be executed without loading into context
+- **Note**: Scripts may still need to be read by Codex for patching or environment-specific adjustments
+
+##### References (`references/`)
+
+Documentation and reference material intended to be loaded as needed into context to inform Codex's process and thinking.
+
+- **When to include**: For documentation that Codex should reference while working
+- **Examples**: `references/finance.md` for financial schemas, `references/mnda.md` for company NDA template, `references/policies.md` for company policies, `references/api_docs.md` for API specifications
+- **Use cases**: Database schemas, API documentation, domain knowledge, company policies, detailed workflow guides
+- **Benefits**: Keeps SKILL.md lean, loaded only when Codex determines it's needed
+- **Best practice**: If files are large (>10k words), include grep search patterns in SKILL.md
+- **Avoid duplication**: Information should live in either SKILL.md or references files, not both. Prefer references files for detailed information unless it's truly core to the skill—this keeps SKILL.md lean while making information discoverable without hogging the context window. Keep only essential procedural instructions and workflow guidance in SKILL.md; move detailed reference material, schemas, and examples to references files.
+
+##### Assets (`assets/`)
+
+Files not intended to be loaded into context, but rather used within the output Codex produces.
+
+- **When to include**: When the skill needs files that will be used in the final output
+- **Examples**: `assets/logo.png` for brand assets, `assets/slides.pptx` for PowerPoint templates, `assets/frontend-template/` for HTML/React boilerplate, `assets/font.ttf` for typography
+- **Use cases**: Templates, images, icons, boilerplate code, fonts, sample documents that get copied or modified
+- **Benefits**: Separates output resources from documentation, enables Codex to use files without loading them into context
+
+#### What to Not Include in a Skill
+
+A skill should only contain essential files that directly support its functionality. Do NOT create extraneous documentation or auxiliary files, including:
+
+- README.md
+- INSTALLATION_GUIDE.md
+- QUICK_REFERENCE.md
+- CHANGELOG.md
+- etc.
+
+The skill should only contain the information needed for an AI agent to do the job at hand. It should not contain auxilary context about the process that went into creating it, setup and testing procedures, user-facing documentation, etc. Creating additional documentation files just adds clutter and confusion.
+
+### Progressive Disclosure Design Principle
+
+Skills use a three-level loading system to manage context efficiently:
+
+1. **Metadata (name + description)** - Always in context (~100 words)
+2. **SKILL.md body** - When skill triggers (<5k words)
+3. **Bundled resources** - As needed by Codex (Unlimited because scripts can be executed without reading into context window)
+
+#### Progressive Disclosure Patterns
+
+Keep SKILL.md body to the essentials and under 500 lines to minimize context bloat. Split content into separate files when approaching this limit. When splitting out content into other files, it is very important to reference them from SKILL.md and describe clearly when to read them, to ensure the reader of the skill knows they exist and when to use them.
+
+**Key principle:** When a skill supports multiple variations, frameworks, or options, keep only the core workflow and selection guidance in SKILL.md. Move variant-specific details (patterns, examples, configuration) into separate reference files.
+
+**Pattern 1: High-level guide with references**
+
+```markdown
+# PDF Processing
+
+## Quick start
+
+Extract text with pdfplumber:
+[code example]
+
+## Advanced features
+
+- **Form filling**: See [FORMS.md](FORMS.md) for complete guide
+- **API reference**: See [REFERENCE.md](REFERENCE.md) for all methods
+- **Examples**: See [EXAMPLES.md](EXAMPLES.md) for common patterns
+```
+
+Codex loads FORMS.md, REFERENCE.md, or EXAMPLES.md only when needed.
+
+**Pattern 2: Domain-specific organization**
+
+For Skills with multiple domains, organize content by domain to avoid loading irrelevant context:
+
+```
+bigquery-skill/
+├── SKILL.md (overview and navigation)
+└── reference/
+    ├── finance.md (revenue, billing metrics)
+    ├── sales.md (opportunities, pipeline)
+    ├── product.md (API usage, features)
+    └── marketing.md (campaigns, attribution)
+```
+
+When a user asks about sales metrics, Codex only reads sales.md.
+
+Similarly, for skills supporting multiple frameworks or variants, organize by variant:
+
+```
+cloud-deploy/
+├── SKILL.md (workflow + provider selection)
+└── references/
+    ├── aws.md (AWS deployment patterns)
+    ├── gcp.md (GCP deployment patterns)
+    └── azure.md (Azure deployment patterns)
+```
+
+When the user chooses AWS, Codex only reads aws.md.
+
+**Pattern 3: Conditional details**
+
+Show basic content, link to advanced content:
+
+```markdown
+# DOCX Processing
+
+## Creating documents
+
+Use docx-js for new documents. See [DOCX-JS.md](DOCX-JS.md).
+
+## Editing documents
+
+For simple edits, modify the XML directly.
+
+**For tracked changes**: See [REDLINING.md](REDLINING.md)
+**For OOXML details**: See [OOXML.md](OOXML.md)
+```
+
+Codex reads REDLINING.md or OOXML.md only when the user needs those features.
+
+**Important guidelines:**
+
+- **Avoid deeply nested references** - Keep references one level deep from SKILL.md. All reference files should link directly from SKILL.md.
+- **Structure longer reference files** - For files longer than 100 lines, include a table of contents at the top so Codex can see the full scope when previewing.
+
+## Skill Creation Process
+
+Skill creation involves these steps:
+
+1. Understand the skill with concrete examples
+2. Plan reusable skill contents (scripts, references, assets)
+3. Initialize the skill (run init_skill.py)
+4. Edit the skill (implement resources and write SKILL.md)
+5. Package the skill (run package_skill.py)
+6. Iterate based on real usage
+
+Follow these steps in order, skipping only if there is a clear reason why they are not applicable.
+
+### Step 1: Understanding the Skill with Concrete Examples
+
+Skip this step only when the skill's usage patterns are already clearly understood. It remains valuable even when working with an existing skill.
+
+To create an effective skill, clearly understand concrete examples of how the skill will be used. This understanding can come from either direct user examples or generated examples that are validated with user feedback.
+
+For example, when building an image-editor skill, relevant questions include:
+
+- "What functionality should the image-editor skill support? Editing, rotating, anything else?"
+- "Can you give some examples of how this skill would be used?"
+- "I can imagine users asking for things like 'Remove the red-eye from this image' or 'Rotate this image'. Are there other ways you imagine this skill being used?"
+- "What would a user say that should trigger this skill?"
+
+To avoid overwhelming users, avoid asking too many questions in a single message. Start with the most important questions and follow up as needed for better effectiveness.
+
+Conclude this step when there is a clear sense of the functionality the skill should support.
+
+### Step 2: Planning the Reusable Skill Contents
+
+To turn concrete examples into an effective skill, analyze each example by:
+
+1. Considering how to execute on the example from scratch
+2. Identifying what scripts, references, and assets would be helpful when executing these workflows repeatedly
+
+Example: When building a `pdf-editor` skill to handle queries like "Help me rotate this PDF," the analysis shows:
+
+1. Rotating a PDF requires re-writing the same code each time
+2. A `scripts/rotate_pdf.py` script would be helpful to store in the skill
+
+Example: When designing a `frontend-webapp-builder` skill for queries like "Build me a todo app" or "Build me a dashboard to track my steps," the analysis shows:
+
+1. Writing a frontend webapp requires the same boilerplate HTML/React each time
+2. An `assets/hello-world/` template containing the boilerplate HTML/React project files would be helpful to store in the skill
+
+Example: When building a `big-query` skill to handle queries like "How many users have logged in today?" the analysis shows:
+
+1. Querying BigQuery requires re-discovering the table schemas and relationships each time
+2. A `references/schema.md` file documenting the table schemas would be helpful to store in the skill
+
+To establish the skill's contents, analyze each concrete example to create a list of the reusable resources to include: scripts, references, and assets.
+
+### Step 3: Initializing the Skill
+
+At this point, it is time to actually create the skill.
+
+Skip this step only if the skill being developed already exists, and iteration or packaging is needed. In this case, continue to the next step.
+
+When creating a new skill from scratch, always run the `init_skill.py` script. The script conveniently generates a new template skill directory that automatically includes everything a skill requires, making the skill creation process much more efficient and reliable.
+
+Usage:
+
+```bash
+scripts/init_skill.py <skill-name> --path <output-directory>
+```
+
+The script:
+
+- Creates the skill directory at the specified path
+- Generates a SKILL.md template with proper frontmatter and TODO placeholders
+- Creates example resource directories: `scripts/`, `references/`, and `assets/`
+- Adds example files in each directory that can be customized or deleted
+
+After initialization, customize or remove the generated SKILL.md and example files as needed.
+
+### Step 4: Edit the Skill
+
+When editing the (newly-generated or existing) skill, remember that the skill is being created for another instance of Codex to use. Include information that would be beneficial and non-obvious to Codex. Consider what procedural knowledge, domain-specific details, or reusable assets would help another Codex instance execute these tasks more effectively.
+
+#### Learn Proven Design Patterns
+
+Consult these helpful guides based on your skill's needs:
+
+- **Multi-step processes**: See references/workflows.md for sequential workflows and conditional logic
+- **Specific output formats or quality standards**: See references/output-patterns.md for template and example patterns
+
+These files contain established best practices for effective skill design.
+
+#### Start with Reusable Skill Contents
+
+To begin implementation, start with the reusable resources identified above: `scripts/`, `references/`, and `assets/` files. Note that this step may require user input. For example, when implementing a `brand-guidelines` skill, the user may need to provide brand assets or templates to store in `assets/`, or documentation to store in `references/`.
+
+Added scripts must be tested by actually running them to ensure there are no bugs and that the output matches what is expected. If there are many similar scripts, only a representative sample needs to be tested to ensure confidence that they all work while balancing time to completion.
+
+Any example files and directories not needed for the skill should be deleted. The initialization script creates example files in `scripts/`, `references/`, and `assets/` to demonstrate structure, but most skills won't need all of them.
+
+#### Update SKILL.md
+
+**Writing Guidelines:** Always use imperative/infinitive form.
+
+##### Frontmatter
+
+Write the YAML frontmatter with `name` and `description`:
+
+- `name`: The skill name
+- `description`: This is the primary triggering mechanism for your skill, and helps Codex understand when to use the skill.
+  - Include both what the Skill does and specific triggers/contexts for when to use it.
+  - Include all "when to use" information here - Not in the body. The body is only loaded after triggering, so "When to Use This Skill" sections in the body are not helpful to Codex.
+  - Example description for a `docx` skill: "Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. Use when Codex needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks"
+
+Do not include any other fields in YAML frontmatter.
+
+##### Body
+
+Write instructions for using the skill and its bundled resources.
+
+### Step 5: Packaging a Skill
+
+Once development of the skill is complete, it must be packaged into a distributable .skill file that gets shared with the user. The packaging process automatically validates the skill first to ensure it meets all requirements:
+
+```bash
+scripts/package_skill.py <path/to/skill-folder>
+```
+
+Optional output directory specification:
+
+```bash
+scripts/package_skill.py <path/to/skill-folder> ./dist
+```
+
+The packaging script will:
+
+1. **Validate** the skill automatically, checking:
+
+   - YAML frontmatter format and required fields
+   - Skill naming conventions and directory structure
+   - Description completeness and quality
+   - File organization and resource references
+
+2. **Package** the skill if validation passes, creating a .skill file named after the skill (e.g., `my-skill.skill`) that includes all files and maintains the proper directory structure for distribution. The .skill file is a zip file with a .skill extension.
+
+If validation fails, the script will report the errors and exit without creating a package. Fix any validation errors and run the packaging command again.
+
+### Step 6: Iterate
+
+After testing the skill, users may request improvements. Often this happens right after using the skill, with fresh context of how the skill performed.
+
+**Iteration workflow:**
+
+1. Use the skill on real tasks
+2. Notice struggles or inefficiencies
+3. Identify how SKILL.md or bundled resources should be updated
+4. Implement changes and test again
diff --git a/.agents/skills/skill-creator/references/output-patterns.md b/.agents/skills/skill-creator/references/output-patterns.md
new file mode 100644
index 0000000..073ddda
--- /dev/null
+++ b/.agents/skills/skill-creator/references/output-patterns.md
@@ -0,0 +1,82 @@
+# Output Patterns
+
+Use these patterns when skills need to produce consistent, high-quality output.
+
+## Template Pattern
+
+Provide templates for output format. Match the level of strictness to your needs.
+
+**For strict requirements (like API responses or data formats):**
+
+```markdown
+## Report structure
+
+ALWAYS use this exact template structure:
+
+# [Analysis Title]
+
+## Executive summary
+[One-paragraph overview of key findings]
+
+## Key findings
+- Finding 1 with supporting data
+- Finding 2 with supporting data
+- Finding 3 with supporting data
+
+## Recommendations
+1. Specific actionable recommendation
+2. Specific actionable recommendation
+```
+
+**For flexible guidance (when adaptation is useful):**
+
+```markdown
+## Report structure
+
+Here is a sensible default format, but use your best judgment:
+
+# [Analysis Title]
+
+## Executive summary
+[Overview]
+
+## Key findings
+[Adapt sections based on what you discover]
+
+## Recommendations
+[Tailor to the specific context]
+
+Adjust sections as needed for the specific analysis type.
+```
+
+## Examples Pattern
+
+For skills where output quality depends on seeing examples, provide input/output pairs:
+
+```markdown
+## Commit message format
+
+Generate commit messages following these examples:
+
+**Example 1:**
+Input: Added user authentication with JWT tokens
+Output:
+```
+feat(auth): implement JWT-based authentication
+
+Add login endpoint and token validation middleware
+```
+
+**Example 2:**
+Input: Fixed bug where dates displayed incorrectly in reports
+Output:
+```
+fix(reports): correct date formatting in timezone conversion
+
+Use UTC timestamps consistently across report generation
+```
+
+Follow this style: type(scope): brief description, then detailed explanation.
+```
+
+Examples help Claude understand the desired style and level of detail more clearly than descriptions alone.
diff --git a/.agents/skills/skill-creator/references/workflows.md b/.agents/skills/skill-creator/references/workflows.md
new file mode 100644
index 0000000..a350c3c
--- /dev/null
+++ b/.agents/skills/skill-creator/references/workflows.md
@@ -0,0 +1,28 @@
+# Workflow Patterns
+
+## Sequential Workflows
+
+For complex tasks, break operations into clear, sequential steps. It is often helpful to give Claude an overview of the process towards the beginning of SKILL.md:
+
+```markdown
+Filling a PDF form involves these steps:
+
+1. Analyze the form (run analyze_form.py)
+2. Create field mapping (edit fields.json)
+3. Validate mapping (run validate_fields.py)
+4. Fill the form (run fill_form.py)
+5. Verify output (run verify_output.py)
+```
+
+## Conditional Workflows
+
+For tasks with branching logic, guide Claude through decision points:
+
+```markdown
+1. Determine the modification type:
+   **Creating new content?** → Follow "Creation workflow" below
+   **Editing existing content?** → Follow "Editing workflow" below
+
+2. Creation workflow: [steps]
+3. Editing workflow: [steps]
+```
\ No newline at end of file
diff --git a/.agents/skills/skill-creator/scripts/init_skill.py b/.agents/skills/skill-creator/scripts/init_skill.py
new file mode 100644
index 0000000..329ad4e
--- /dev/null
+++ b/.agents/skills/skill-creator/scripts/init_skill.py
@@ -0,0 +1,303 @@
+#!/usr/bin/env python3
+"""
+Skill Initializer - Creates a new skill from template
+
+Usage:
+    init_skill.py <skill-name> --path <path>
+
+Examples:
+    init_skill.py my-new-skill --path skills/public
+    init_skill.py my-api-helper --path skills/private
+    init_skill.py custom-skill --path /custom/location
+"""
+
+import sys
+from pathlib import Path
+
+
+SKILL_TEMPLATE = """---
+name: {skill_name}
+description: [TODO: Complete and informative explanation of what the skill does and when to use it. Include WHEN to use this skill - specific scenarios, file types, or tasks that trigger it.]
+---
+
+# {skill_title}
+
+## Overview
+
+[TODO: 1-2 sentences explaining what this skill enables]
+
+## Structuring This Skill
+
+[TODO: Choose the structure that best fits this skill's purpose. Common patterns:
+
+**1. Workflow-Based** (best for sequential processes)
+- Works well when there are clear step-by-step procedures
+- Example: DOCX skill with "Workflow Decision Tree" → "Reading" → "Creating" → "Editing"
+- Structure: ## Overview → ## Workflow Decision Tree → ## Step 1 → ## Step 2...
+
+**2. Task-Based** (best for tool collections)
+- Works well when the skill offers different operations/capabilities
+- Example: PDF skill with "Quick Start" → "Merge PDFs" → "Split PDFs" → "Extract Text"
+- Structure: ## Overview → ## Quick Start → ## Task Category 1 → ## Task Category 2...
+
+**3. Reference/Guidelines** (best for standards or specifications)
+- Works well for brand guidelines, coding standards, or requirements
+- Example: Brand styling with "Brand Guidelines" → "Colors" → "Typography" → "Features"
+- Structure: ## Overview → ## Guidelines → ## Specifications → ## Usage...
+
+**4. Capabilities-Based** (best for integrated systems)
+- Works well when the skill provides multiple interrelated features
+- Example: Product Management with "Core Capabilities" → numbered capability list
+- Structure: ## Overview → ## Core Capabilities → ### 1. Feature → ### 2. Feature...
+
+Patterns can be mixed and matched as needed. Most skills combine patterns (e.g., start with task-based, add workflow for complex operations).
+
+Delete this entire "Structuring This Skill" section when done - it's just guidance.]
+
+## [TODO: Replace with the first main section based on chosen structure]
+
+[TODO: Add content here. See examples in existing skills:
+- Code samples for technical skills
+- Decision trees for complex workflows
+- Concrete examples with realistic user requests
+- References to scripts/templates/references as needed]
+
+## Resources
+
+This skill includes example resource directories that demonstrate how to organize different types of bundled resources:
+
+### scripts/
+Executable code (Python/Bash/etc.) that can be run directly to perform specific operations.
+
+**Examples from other skills:**
+- PDF skill: `fill_fillable_fields.py`, `extract_form_field_info.py` - utilities for PDF manipulation
+- DOCX skill: `document.py`, `utilities.py` - Python modules for document processing
+
+**Appropriate for:** Python scripts, shell scripts, or any executable code that performs automation, data processing, or specific operations.
+
+**Note:** Scripts may be executed without loading into context, but can still be read by Claude for patching or environment adjustments.
+
+### references/
+Documentation and reference material intended to be loaded into context to inform Claude's process and thinking.
+
+**Examples from other skills:**
+- Product management: `communication.md`, `context_building.md` - detailed workflow guides
+- BigQuery: API reference documentation and query examples
+- Finance: Schema documentation, company policies
+
+**Appropriate for:** In-depth documentation, API references, database schemas, comprehensive guides, or any detailed information that Claude should reference while working.
+
+### assets/
+Files not intended to be loaded into context, but rather used within the output Claude produces.
+
+**Examples from other skills:**
+- Brand styling: PowerPoint template files (.pptx), logo files
+- Frontend builder: HTML/React boilerplate project directories
+- Typography: Font files (.ttf, .woff2)
+
+**Appropriate for:** Templates, boilerplate code, document templates, images, icons, fonts, or any files meant to be copied or used in the final output.
+
+---
+
+**Any unneeded directories can be deleted.** Not every skill requires all three types of resources.
+"""
+
+EXAMPLE_SCRIPT = '''#!/usr/bin/env python3
+"""
+Example helper script for {skill_name}
+
+This is a placeholder script that can be executed directly.
+Replace with actual implementation or delete if not needed.
+
+Example real scripts from other skills:
+- pdf/scripts/fill_fillable_fields.py - Fills PDF form fields
+- pdf/scripts/convert_pdf_to_images.py - Converts PDF pages to images
+"""
+
+def main():
+    print("This is an example script for {skill_name}")
+    # TODO: Add actual script logic here
+    # This could be data processing, file conversion, API calls, etc.
+
+if __name__ == "__main__":
+    main()
+'''
+
+EXAMPLE_REFERENCE = """# Reference Documentation for {skill_title}
+
+This is a placeholder for detailed reference documentation.
+Replace with actual reference content or delete if not needed.
+
+Example real reference docs from other skills:
+- product-management/references/communication.md - Comprehensive guide for status updates
+- product-management/references/context_building.md - Deep-dive on gathering context
+- bigquery/references/ - API references and query examples
+
+## When Reference Docs Are Useful
+
+Reference docs are ideal for:
+- Comprehensive API documentation
+- Detailed workflow guides
+- Complex multi-step processes
+- Information too lengthy for main SKILL.md
+- Content that's only needed for specific use cases
+
+## Structure Suggestions
+
+### API Reference Example
+- Overview
+- Authentication
+- Endpoints with examples
+- Error codes
+- Rate limits
+
+### Workflow Guide Example
+- Prerequisites
+- Step-by-step instructions
+- Common patterns
+- Troubleshooting
+- Best practices
+"""
+
+EXAMPLE_ASSET = """# Example Asset File
+
+This placeholder represents where asset files would be stored.
+Replace with actual asset files (templates, images, fonts, etc.) or delete if not needed.
+
+Asset files are NOT intended to be loaded into context, but rather used within
+the output Claude produces.
+
+Example asset files from other skills:
+- Brand guidelines: logo.png, slides_template.pptx
+- Frontend builder: hello-world/ directory with HTML/React boilerplate
+- Typography: custom-font.ttf, font-family.woff2
+- Data: sample_data.csv, test_dataset.json
+
+## Common Asset Types
+
+- Templates: .pptx, .docx, boilerplate directories
+- Images: .png, .jpg, .svg, .gif
+- Fonts: .ttf, .otf, .woff, .woff2
+- Boilerplate code: Project directories, starter files
+- Icons: .ico, .svg
+- Data files: .csv, .json, .xml, .yaml
+
+Note: This is a text placeholder. Actual assets can be any file type.
+"""
+
+
+def title_case_skill_name(skill_name):
+    """Convert hyphenated skill name to Title Case for display."""
+    return ' '.join(word.capitalize() for word in skill_name.split('-'))
+
+
+def init_skill(skill_name, path):
+    """
+    Initialize a new skill directory with template SKILL.md.
+
+    Args:
+        skill_name: Name of the skill
+        path: Path where the skill directory should be created
+
+    Returns:
+        Path to created skill directory, or None if error
+    """
+    # Determine skill directory path
+    skill_dir = Path(path).resolve() / skill_name
+
+    # Check if directory already exists
+    if skill_dir.exists():
+        print(f"❌ Error: Skill directory already exists: {skill_dir}")
+        return None
+
+    # Create skill directory
+    try:
+        skill_dir.mkdir(parents=True, exist_ok=False)
+        print(f"✅ Created skill directory: {skill_dir}")
+    except Exception as e:
+        print(f"❌ Error creating directory: {e}")
+        return None
+
+    # Create SKILL.md from template
+    skill_title = title_case_skill_name(skill_name)
+    skill_content = SKILL_TEMPLATE.format(
+        skill_name=skill_name,
+        skill_title=skill_title
+    )
+
+    skill_md_path = skill_dir / 'SKILL.md'
+    try:
+        skill_md_path.write_text(skill_content)
+        print("✅ Created SKILL.md")
+    except Exception as e:
+        print(f"❌ Error creating SKILL.md: {e}")
+        return None
+
+    # Create resource directories with example files
+    try:
+        # Create scripts/ directory with example script
+        scripts_dir = skill_dir / 'scripts'
+        scripts_dir.mkdir(exist_ok=True)
+        example_script = scripts_dir / 'example.py'
+        example_script.write_text(EXAMPLE_SCRIPT.format(skill_name=skill_name))
+        example_script.chmod(0o755)
+        print("✅ Created scripts/example.py")
+
+        # Create references/ directory with example reference doc
+        references_dir = skill_dir / 'references'
+        references_dir.mkdir(exist_ok=True)
+        example_reference = references_dir / 'api_reference.md'
+        example_reference.write_text(EXAMPLE_REFERENCE.format(skill_title=skill_title))
+        print("✅ Created references/api_reference.md")
+
+        # Create assets/ directory with example asset placeholder
+        assets_dir = skill_dir / 'assets'
+        assets_dir.mkdir(exist_ok=True)
+        example_asset = assets_dir / 'example_asset.txt'
+        example_asset.write_text(EXAMPLE_ASSET)
+        print("✅ Created assets/example_asset.txt")
+    except Exception as e:
+        print(f"❌ Error creating resource directories: {e}")
+        return None
+
+    # Print next steps
+    print(f"\n✅ Skill '{skill_name}' initialized successfully at {skill_dir}")
+    print("\nNext steps:")
+    print("1. Edit SKILL.md to complete the TODO items and update the description")
+    print("2. Customize or delete the example files in scripts/, references/, and assets/")
+    print("3. Run the validator when ready to check the skill structure")
+
+    return skill_dir
+
+
+def main():
+    if len(sys.argv) < 4 or sys.argv[2] != '--path':
+        print("Usage: init_skill.py <skill-name> --path <path>")
+        print("\nSkill name requirements:")
+        print("  - Hyphen-case identifier (e.g., 'data-analyzer')")
+        print("  - Lowercase letters, digits, and hyphens only")
+        print("  - Max 40 characters")
+        print("  - Must match directory name exactly")
+        print("\nExamples:")
+        print("  init_skill.py my-new-skill --path skills/public")
+        print("  init_skill.py my-api-helper --path skills/private")
+        print("  init_skill.py custom-skill --path /custom/location")
+        sys.exit(1)
+
+    skill_name = sys.argv[1]
+    path = sys.argv[3]
+
+    print(f"🚀 Initializing skill: {skill_name}")
+    print(f"   Location: {path}")
+    print()
+
+    result = init_skill(skill_name, path)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/.agents/skills/skill-creator/scripts/package_skill.py b/.agents/skills/skill-creator/scripts/package_skill.py
new file mode 100644
index 0000000..5cd36cb
--- /dev/null
+++ b/.agents/skills/skill-creator/scripts/package_skill.py
@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""
+Skill Packager - Creates a distributable .skill file of a skill folder
+
+Usage:
+    python utils/package_skill.py <path/to/skill-folder> [output-directory]
+
+Example:
+    python utils/package_skill.py skills/public/my-skill
+    python utils/package_skill.py skills/public/my-skill ./dist
+"""
+
+import sys
+import zipfile
+from pathlib import Path
+from quick_validate import validate_skill
+
+
+def package_skill(skill_path, output_dir=None):
+    """
+    Package a skill folder into a .skill file.
+
+    Args:
+        skill_path: Path to the skill folder
+        output_dir: Optional output directory for the .skill file (defaults to current directory)
+
+    Returns:
+        Path to the created .skill file, or None if error
+    """
+    skill_path = Path(skill_path).resolve()
+
+    # Validate skill folder exists
+    if not skill_path.exists():
+        print(f"❌ Error: Skill folder not found: {skill_path}")
+        return None
+
+    if not skill_path.is_dir():
+        print(f"❌ Error: Path is not a directory: {skill_path}")
+        return None
+
+    # Validate SKILL.md exists
+    skill_md = skill_path / "SKILL.md"
+    if not skill_md.exists():
+        print(f"❌ Error: SKILL.md not found in {skill_path}")
+        return None
+
+    # Run validation before packaging
+    print("🔍 Validating skill...")
+    valid, message = validate_skill(skill_path)
+    if not valid:
+        print(f"❌ Validation failed: {message}")
+        print("   Please fix the validation errors before packaging.")
+        return None
+    print(f"✅ {message}\n")
+
+    # Determine output location
+    skill_name = skill_path.name
+    if output_dir:
+        output_path = Path(output_dir).resolve()
+        output_path.mkdir(parents=True, exist_ok=True)
+    else:
+        output_path = Path.cwd()
+
+    skill_filename = output_path / f"{skill_name}.skill"
+
+    # Create the .skill file (zip format)
+    try:
+        with zipfile.ZipFile(skill_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
+            # Walk through the skill directory
+            for file_path in skill_path.rglob('*'):
+                if file_path.is_file():
+                    # Calculate the relative path within the zip
+                    arcname = file_path.relative_to(skill_path.parent)
+                    zipf.write(file_path, arcname)
+                    print(f"  Added: {arcname}")
+
+        print(f"\n✅ Successfully packaged skill to: {skill_filename}")
+        return skill_filename
+
+    except Exception as e:
+        print(f"❌ Error creating .skill file: {e}")
+        return None
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]")
+        print("\nExample:")
+        print("  python utils/package_skill.py skills/public/my-skill")
+        print("  python utils/package_skill.py skills/public/my-skill ./dist")
+        sys.exit(1)
+
+    skill_path = sys.argv[1]
+    output_dir = sys.argv[2] if len(sys.argv) > 2 else None
+
+    print(f"📦 Packaging skill: {skill_path}")
+    if output_dir:
+        print(f"   Output directory: {output_dir}")
+    print()
+
+    result = package_skill(skill_path, output_dir)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/.agents/skills/skill-creator/scripts/quick_validate.py b/.agents/skills/skill-creator/scripts/quick_validate.py
new file mode 100644
index 0000000..d9fbeb7
--- /dev/null
+++ b/.agents/skills/skill-creator/scripts/quick_validate.py
@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""
+Quick validation script for skills - minimal version
+"""
+
+import sys
+import os
+import re
+import yaml
+from pathlib import Path
+
+def validate_skill(skill_path):
+    """Basic validation of a skill"""
+    skill_path = Path(skill_path)
+
+    # Check SKILL.md exists
+    skill_md = skill_path / 'SKILL.md'
+    if not skill_md.exists():
+        return False, "SKILL.md not found"
+
+    # Read and validate frontmatter
+    content = skill_md.read_text()
+    if not content.startswith('---'):
+        return False, "No YAML frontmatter found"
+
+    # Extract frontmatter
+    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not match:
+        return False, "Invalid frontmatter format"
+
+    frontmatter_text = match.group(1)
+
+    # Parse YAML frontmatter
+    try:
+        frontmatter = yaml.safe_load(frontmatter_text)
+        if not isinstance(frontmatter, dict):
+            return False, "Frontmatter must be a YAML dictionary"
+    except yaml.YAMLError as e:
+        return False, f"Invalid YAML in frontmatter: {e}"
+
+    # Define allowed properties
+    ALLOWED_PROPERTIES = {'name', 'description', 'license', 'allowed-tools', 'metadata'}
+
+    # Check for unexpected properties (excluding nested keys under metadata)
+    unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES
+    if unexpected_keys:
+        return False, (
+            f"Unexpected key(s) in SKILL.md frontmatter: {', '.join(sorted(unexpected_keys))}. "
+            f"Allowed properties are: {', '.join(sorted(ALLOWED_PROPERTIES))}"
+        )
+
+    # Check required fields
+    if 'name' not in frontmatter:
+        return False, "Missing 'name' in frontmatter"
+    if 'description' not in frontmatter:
+        return False, "Missing 'description' in frontmatter"
+
+    # Extract name for validation
+    name = frontmatter.get('name', '')
+    if not isinstance(name, str):
+        return False, f"Name must be a string, got {type(name).__name__}"
+    name = name.strip()
+    if name:
+        # Check naming convention (hyphen-case: lowercase with hyphens)
+        if not re.match(r'^[a-z0-9-]+$', name):
+            return False, f"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)"
+        if name.startswith('-') or name.endswith('-') or '--' in name:
+            return False, f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens"
+        # Check name length (max 64 characters per spec)
+        if len(name) > 64:
+            return False, f"Name is too long ({len(name)} characters). Maximum is 64 characters."
+
+    # Extract and validate description
+    description = frontmatter.get('description', '')
+    if not isinstance(description, str):
+        return False, f"Description must be a string, got {type(description).__name__}"
+    description = description.strip()
+    if description:
+        # Check for angle brackets
+        if '<' in description or '>' in description:
+            return False, "Description cannot contain angle brackets (< or >)"
+        # Check description length (max 1024 characters per spec)
+        if len(description) > 1024:
+            return False, f"Description is too long ({len(description)} characters). Maximum is 1024 characters."
+
+    return True, "Skill is valid!"
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python quick_validate.py <skill_directory>")
+        sys.exit(1)
+    
+    valid, message = validate_skill(sys.argv[1])
+    print(message)
+    sys.exit(0 if valid else 1)
\ No newline at end of file
diff --git a/.agents/skills/skill-developer/ADVANCED.md b/.agents/skills/skill-developer/ADVANCED.md
new file mode 100644
index 0000000..6395f77
--- /dev/null
+++ b/.agents/skills/skill-developer/ADVANCED.md
@@ -0,0 +1,197 @@
+# Advanced Topics & Future Enhancements
+
+Ideas and concepts for future improvements to the skill system.
+
+---
+
+## Dynamic Rule Updates
+
+**Current State:** Requires Claude Code restart to pick up changes to skill-rules.json
+
+**Future Enhancement:** Hot-reload configuration without restart
+
+**Implementation Ideas:**
+- Watch skill-rules.json for changes
+- Reload on file modification
+- Invalidate cached compiled regexes
+- Notify user of reload
+
+**Benefits:**
+- Faster iteration during skill development
+- No need to restart Claude Code
+- Better developer experience
+
+---
+
+## Skill Dependencies
+
+**Current State:** Skills are independent
+
+**Future Enhancement:** Specify skill dependencies and load order
+
+**Configuration Idea:**
+```json
+{
+  "my-advanced-skill": {
+    "dependsOn": ["prerequisite-skill", "base-skill"],
+    "type": "domain",
+    ...
+  }
+}
+```
+
+**Use Cases:**
+- Advanced skill builds on base skill knowledge
+- Ensure foundational skills loaded first
+- Chain skills for complex workflows
+
+**Benefits:**
+- Better skill composition
+- Clearer skill relationships
+- Progressive disclosure
+
+---
+
+## Conditional Enforcement
+
+**Current State:** Enforcement level is static
+
+**Future Enhancement:** Enforce based on context or environment
+
+**Configuration Idea:**
+```json
+{
+  "enforcement": {
+    "default": "suggest",
+    "when": {
+      "production": "block",
+      "development": "suggest",
+      "ci": "block"
+    }
+  }
+}
+```
+
+**Use Cases:**
+- Stricter enforcement in production
+- Relaxed rules during development
+- CI/CD pipeline requirements
+
+**Benefits:**
+- Environment-appropriate enforcement
+- Flexible rule application
+- Context-aware guardrails
+
+---
+
+## Skill Analytics
+
+**Current State:** No usage tracking
+
+**Future Enhancement:** Track skill usage patterns and effectiveness
+
+**Metrics to Collect:**
+- Skill trigger frequency
+- False positive rate
+- False negative rate
+- Time to skill usage after suggestion
+- User override rate (skip markers, env vars)
+- Performance metrics (execution time)
+
+**Dashbord Ideas:**
+- Most/least used skills
+- Skills with highest false positive rate
+- Performance bottlenecks
+- Skill effectiveness scores
+
+**Benefits:**
+- Data-driven skill improvement
+- Identify problems early
+- Optimize patterns based on real usage
+
+---
+
+## Skill Versioning
+
+**Current State:** No version tracking
+
+**Future Enhancement:** Version skills and track compatibility
+
+**Configuration Idea:**
+```json
+{
+  "my-skill": {
+    "version": "2.1.0",
+    "minClaudeVersion": "1.5.0",
+    "changelog": "Added support for new workflow patterns",
+    ...
+  }
+}
+```
+
+**Benefits:**
+- Track skill evolution
+- Ensure compatibility
+- Document changes
+- Support migration paths
+
+---
+
+## Multi-Language Support
+
+**Current State:** English only
+
+**Future Enhancement:** Support multiple languages for skill content
+
+**Implementation Ideas:**
+- Language-specific SKILL.md variants
+- Automatic language detection
+- Fallback to English
+
+**Use Cases:**
+- International teams
+- Localized documentation
+- Multi-language projects
+
+---
+
+## Skill Testing Framework
+
+**Current State:** Manual testing with npx tsx commands
+
+**Future Enhancement:** Automated skill testing
+
+**Features:**
+- Test cases for trigger patterns
+- Assertion framework
+- CI/CD integration
+- Coverage reports
+
+**Example Test:**
+```typescript
+describe('database-verification', () => {
+  it('triggers on Prisma imports', () => {
+    const result = testSkill({
+      prompt: "add user tracking",
+      file: "services/user.ts",
+      content: "import { PrismaService } from './prisma'"
+    });
+
+    expect(result.triggered).toBe(true);
+    expect(result.skill).toBe('database-verification');
+  });
+});
+```
+
+**Benefits:**
+- Prevent regressions
+- Validate patterns before deployment
+- Confidence in changes
+
+---
+
+## Related Files
+
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Current debugging guide
+- [HOOK_MECHANISMS.md](HOOK_MECHANISMS.md) - How hooks work today
diff --git a/.agents/skills/skill-developer/HOOK_MECHANISMS.md b/.agents/skills/skill-developer/HOOK_MECHANISMS.md
new file mode 100644
index 0000000..abe4768
--- /dev/null
+++ b/.agents/skills/skill-developer/HOOK_MECHANISMS.md
@@ -0,0 +1,306 @@
+# Hook Mechanisms - Deep Dive
+
+Technical deep dive into how the UserPromptSubmit and PreToolUse hooks work.
+
+## Table of Contents
+
+- [UserPromptSubmit Hook Flow](#userpromptsubmit-hook-flow)
+- [PreToolUse Hook Flow](#pretooluse-hook-flow)
+- [Exit Code Behavior (CRITICAL)](#exit-code-behavior-critical)
+- [Session State Management](#session-state-management)
+- [Performance Considerations](#performance-considerations)
+
+---
+
+## UserPromptSubmit Hook Flow
+
+### Execution Sequence
+
+```
+User submits prompt
+    ↓
+.claude/settings.json registers hook
+    ↓
+skill-activation-prompt.sh executes
+    ↓
+npx tsx skill-activation-prompt.ts
+    ↓
+Hook reads stdin (JSON with prompt)
+    ↓
+Loads skill-rules.json
+    ↓
+Matches keywords + intent patterns
+    ↓
+Groups matches by priority (critical → high → medium → low)
+    ↓
+Outputs formatted message to stdout
+    ↓
+stdout becomes context for Claude (injected before prompt)
+    ↓
+Claude sees: [skill suggestion] + user's prompt
+```
+
+### Key Points
+
+- **Exit code**: Always 0 (allow)
+- **stdout**: → Claude's context (injected as system message)
+- **Timing**: Runs BEFORE Claude processes prompt
+- **Behavior**: Non-blocking, advisory only
+- **Purpose**: Make Claude aware of relevant skills
+
+### Input Format
+
+```json
+{
+  "session_id": "abc-123",
+  "transcript_path": "/path/to/transcript.json",
+  "cwd": "/root/git/your-project",
+  "permission_mode": "normal",
+  "hook_event_name": "UserPromptSubmit",
+  "prompt": "how does the layout system work?"
+}
+```
+
+### Output Format (to stdout)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 SKILL ACTIVATION CHECK
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📚 RECOMMENDED SKILLS:
+  → project-catalog-developer
+
+ACTION: Use Skill tool BEFORE responding
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Claude sees this output as additional context before processing the user's prompt.
+
+---
+
+## PreToolUse Hook Flow
+
+### Execution Sequence
+
+```
+Claude calls Edit/Write tool
+    ↓
+.claude/settings.json registers hook (matcher: Edit|Write)
+    ↓
+skill-verification-guard.sh executes
+    ↓
+npx tsx skill-verification-guard.ts
+    ↓
+Hook reads stdin (JSON with tool_name, tool_input)
+    ↓
+Loads skill-rules.json
+    ↓
+Checks file path patterns (glob matching)
+    ↓
+Reads file for content patterns (if file exists)
+    ↓
+Checks session state (was skill already used?)
+    ↓
+Checks skip conditions (file markers, env vars)
+    ↓
+IF MATCHED AND NOT SKIPPED:
+  Update session state (mark skill as enforced)
+  Output block message to stderr
+  Exit with code 2 (BLOCK)
+ELSE:
+  Exit with code 0 (ALLOW)
+    ↓
+IF BLOCKED:
+  stderr → Claude sees message
+  Edit/Write tool does NOT execute
+  Claude must use skill and retry
+IF ALLOWED:
+  Tool executes normally
+```
+
+### Key Points
+
+- **Exit code 2**: BLOCK (stderr → Claude)
+- **Exit code 0**: ALLOW
+- **Timing**: Runs BEFORE tool execution
+- **Session tracking**: Prevents repeated blocks in same session
+- **Fail open**: On errors, allows operation (don't break workflow)
+- **Purpose**: Enforce critical guardrails
+
+### Input Format
+
+```json
+{
+  "session_id": "abc-123",
+  "transcript_path": "/path/to/transcript.json",
+  "cwd": "/root/git/your-project",
+  "permission_mode": "normal",
+  "hook_event_name": "PreToolUse",
+  "tool_name": "Edit",
+  "tool_input": {
+    "file_path": "/root/git/your-project/form/src/services/user.ts",
+    "old_string": "...",
+    "new_string": "..."
+  }
+}
+```
+
+### Output Format (to stderr when blocked)
+
+```
+⚠️ BLOCKED - Database Operation Detected
+
+📋 REQUIRED ACTION:
+1. Use Skill tool: 'database-verification'
+2. Verify ALL table and column names against schema
+3. Check database structure with DESCRIBE commands
+4. Then retry this edit
+
+Reason: Prevent column name errors in Prisma queries
+File: form/src/services/user.ts
+
+💡 TIP: Add '// @skip-validation' comment to skip future checks
+```
+
+Claude receives this message and understands it needs to use the skill before retrying the edit.
+
+---
+
+## Exit Code Behavior (CRITICAL)
+
+### Exit Code Reference Table
+
+| Exit Code | stdout | stderr | Tool Execution | Claude Sees |
+|-----------|--------|--------|----------------|-------------|
+| 0 (UserPromptSubmit) | → Context | → User only | N/A | stdout content |
+| 0 (PreToolUse) | → User only | → User only | **Proceeds** | Nothing |
+| 2 (PreToolUse) | → User only | → **CLAUDE** | **BLOCKED** | stderr content |
+| Other | → User only | → User only | Blocked | Nothing |
+
+### Why Exit Code 2 Matters
+
+This is THE critical mechanism for enforcement:
+
+1. **Only way** to send message to Claude from PreToolUse
+2. stderr content is "fed back to Claude automatically"
+3. Claude sees the block message and understands what to do
+4. Tool execution is prevented
+5. Critical for enforcement of guardrails
+
+### Example Conversation Flow
+
+```
+User: "Add a new user service with Prisma"
+
+Claude: "I'll create the user service..."
+    [Attempts to Edit form/src/services/user.ts]
+
+PreToolUse Hook: [Exit code 2]
+    stderr: "⚠️ BLOCKED - Use database-verification"
+
+Claude sees error, responds:
+    "I need to verify the database schema first."
+    [Uses Skill tool: database-verification]
+    [Verifies column names]
+    [Retries Edit - now allowed (session tracking)]
+```
+
+---
+
+## Session State Management
+
+### Purpose
+
+Prevent repeated nagging in the same session - once Claude uses a skill, don't block again.
+
+### State File Location
+
+`.claude/hooks/state/skills-used-{session_id}.json`
+
+### State File Structure
+
+```json
+{
+  "skills_used": [
+    "database-verification",
+    "error-tracking"
+  ],
+  "files_verified": []
+}
+```
+
+### How It Works
+
+1. **First edit** of file with Prisma:
+   - Hook blocks with exit code 2
+   - Updates session state: adds "database-verification" to skills_used
+   - Claude sees message, uses skill
+
+2. **Second edit** (same session):
+   - Hook checks session state
+   - Finds "database-verification" in skills_used
+   - Exits with code 0 (allow)
+   - No message to Claude
+
+3. **Different session**:
+   - New session ID = new state file
+   - Hook blocks again
+
+### Limitation
+
+The hook cannot detect when the skill is *actually* invoked - it just blocks once per session per skill. This means:
+
+- If Claude doesn't use the skill but makes a different edit, it won't block again
+- Trust that Claude follows the instruction
+- Future enhancement: detect actual Skill tool usage
+
+---
+
+## Performance Considerations
+
+### Target Metrics
+
+- **UserPromptSubmit**: < 100ms
+- **PreToolUse**: < 200ms
+
+### Performance Bottlenecks
+
+1. **Loading skill-rules.json** (every execution)
+   - Future: Cache in memory
+   - Future: Watch for changes, reload only when needed
+
+2. **Reading file content** (PreToolUse)
+   - Only when contentPatterns configured
+   - Only if file exists
+   - Can be slow for large files
+
+3. **Glob matching** (PreToolUse)
+   - Regex compilation for each pattern
+   - Future: Compile once, cache
+
+4. **Regex matching** (Both hooks)
+   - Intent patterns (UserPromptSubmit)
+   - Content patterns (PreToolUse)
+   - Future: Lazy compile, cache compiled regexes
+
+### Optimization Strategies
+
+**Reduce patterns:**
+- Use more specific patterns (fewer to check)
+- Combine similar patterns where possible
+
+**File path patterns:**
+- More specific = fewer files to check
+- Example: `form/src/services/**` better than `form/**`
+
+**Content patterns:**
+- Only add when truly necessary
+- Simpler regex = faster matching
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Debug hook issues
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Configuration reference
diff --git a/.agents/skills/skill-developer/PATTERNS_LIBRARY.md b/.agents/skills/skill-developer/PATTERNS_LIBRARY.md
new file mode 100644
index 0000000..7220939
--- /dev/null
+++ b/.agents/skills/skill-developer/PATTERNS_LIBRARY.md
@@ -0,0 +1,152 @@
+# Common Patterns Library
+
+Ready-to-use regex and glob patterns for skill triggers. Copy and customize for your skills.
+
+---
+
+## Intent Patterns (Regex)
+
+### Feature/Endpoint Creation
+```regex
+(add|create|implement|build).*?(feature|endpoint|route|service|controller)
+```
+
+### Component Creation
+```regex
+(create|add|make|build).*?(component|UI|page|modal|dialog|form)
+```
+
+### Database Work
+```regex
+(add|create|modify|update).*?(user|table|column|field|schema|migration)
+(database|prisma).*?(change|update|query)
+```
+
+### Error Handling
+```regex
+(fix|handle|catch|debug).*?(error|exception|bug)
+(add|implement).*?(try|catch|error.*?handling)
+```
+
+### Explanation Requests
+```regex
+(how does|how do|explain|what is|describe|tell me about).*?
+```
+
+### Workflow Operations
+```regex
+(create|add|modify|update).*?(workflow|step|branch|condition)
+(debug|troubleshoot|fix).*?workflow
+```
+
+### Testing
+```regex
+(write|create|add).*?(test|spec|unit.*?test)
+```
+
+---
+
+## File Path Patterns (Glob)
+
+### Frontend
+```glob
+frontend/src/**/*.tsx        # All React components
+frontend/src/**/*.ts         # All TypeScript files
+frontend/src/components/**   # Only components directory
+```
+
+### Backend Services
+```glob
+form/src/**/*.ts            # Form service
+email/src/**/*.ts           # Email service
+users/src/**/*.ts           # Users service
+projects/src/**/*.ts        # Projects service
+```
+
+### Database
+```glob
+**/schema.prisma            # Prisma schema (anywhere)
+**/migrations/**/*.sql      # Migration files
+database/src/**/*.ts        # Database scripts
+```
+
+### Workflows
+```glob
+form/src/workflow/**/*.ts              # Workflow engine
+form/src/workflow-definitions/**/*.json # Workflow definitions
+```
+
+### Test Exclusions
+```glob
+**/*.test.ts                # TypeScript tests
+**/*.test.tsx               # React component tests
+**/*.spec.ts                # Spec files
+```
+
+---
+
+## Content Patterns (Regex)
+
+### Prisma/Database
+```regex
+import.*[Pp]risma                # Prisma imports
+PrismaService                    # PrismaService usage
+prisma\.                         # prisma.something
+\.findMany\(                     # Prisma query methods
+\.create\(
+\.update\(
+\.delete\(
+```
+
+### Controllers/Routes
+```regex
+export class.*Controller         # Controller classes
+router\.                         # Express router
+app\.(get|post|put|delete|patch) # Express app routes
+```
+
+### Error Handling
+```regex
+try\s*\{                        # Try blocks
+catch\s*\(                      # Catch blocks
+throw new                        # Throw statements
+```
+
+### React/Components
+```regex
+export.*React\.FC               # React functional components
+export default function.*       # Default function exports
+useState|useEffect              # React hooks
+```
+
+---
+
+**Usage Example:**
+
+```json
+{
+  "my-skill": {
+    "promptTriggers": {
+      "intentPatterns": [
+        "(create|add|build).*?(component|UI|page)"
+      ]
+    },
+    "fileTriggers": {
+      "pathPatterns": [
+        "frontend/src/**/*.tsx"
+      ],
+      "contentPatterns": [
+        "export.*React\\.FC",
+        "useState|useEffect"
+      ]
+    }
+  }
+}
+```
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TRIGGER_TYPES.md](TRIGGER_TYPES.md) - Detailed trigger documentation
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Complete schema
diff --git a/.agents/skills/skill-developer/SKILL.md b/.agents/skills/skill-developer/SKILL.md
new file mode 100644
index 0000000..4c26d2d
--- /dev/null
+++ b/.agents/skills/skill-developer/SKILL.md
@@ -0,0 +1,426 @@
+---
+name: skill-developer
+description: Create and manage Claude Code skills following Anthropic best practices. Use when creating new skills, modifying skill-rules.json, understanding trigger patterns, working with hooks, debugging skill activation, or implementing progressive disclosure. Covers skill structure, YAML frontmatter, trigger types (keywords, intent patterns, file paths, content patterns), enforcement levels (block, suggest, warn), hook mechanisms (UserPromptSubmit, PreToolUse), session tracking, and the 500-line rule.
+---
+
+# Skill Developer Guide
+
+## Purpose
+
+Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.
+
+## When to Use This Skill
+
+Automatically activates when you mention:
+- Creating or adding skills
+- Modifying skill triggers or rules
+- Understanding how skill activation works
+- Debugging skill activation issues
+- Working with skill-rules.json
+- Hook system mechanics
+- Claude Code best practices
+- Progressive disclosure
+- YAML frontmatter
+- 500-line rule
+
+---
+
+## System Overview
+
+### Two-Hook Architecture
+
+**1. UserPromptSubmit Hook** (Proactive Suggestions)
+- **File**: `.claude/hooks/skill-activation-prompt.ts`
+- **Trigger**: BEFORE Claude sees user's prompt
+- **Purpose**: Suggest relevant skills based on keywords + intent patterns
+- **Method**: Injects formatted reminder as context (stdout → Claude's input)
+- **Use Cases**: Topic-based skills, implicit work detection
+
+**2. Stop Hook - Error Handling Reminder** (Gentle Reminders)
+- **File**: `.claude/hooks/error-handling-reminder.ts`
+- **Trigger**: AFTER Claude finishes responding
+- **Purpose**: Gentle reminder to self-assess error handling in code written
+- **Method**: Analyzes edited files for risky patterns, displays reminder if needed
+- **Use Cases**: Error handling awareness without blocking friction
+
+**Philosophy Change (2025-10-27):** We moved away from blocking PreToolUse for Sentry/error handling. Instead, use gentle post-response reminders that don't block workflow but maintain code quality awareness.
+
+### Configuration File
+
+**Location**: `.claude/skills/skill-rules.json`
+
+Defines:
+- All skills and their trigger conditions
+- Enforcement levels (block, suggest, warn)
+- File path patterns (glob)
+- Content detection patterns (regex)
+- Skip conditions (session tracking, file markers, env vars)
+
+---
+
+## Skill Types
+
+### 1. Guardrail Skills
+
+**Purpose:** Enforce critical best practices that prevent errors
+
+**Characteristics:**
+- Type: `"guardrail"`
+- Enforcement: `"block"`
+- Priority: `"critical"` or `"high"`
+- Block file edits until skill used
+- Prevent common mistakes (column names, critical errors)
+- Session-aware (don't repeat nag in same session)
+
+**Examples:**
+- `database-verification` - Verify table/column names before Prisma queries
+- `frontend-dev-guidelines` - Enforce React/TypeScript patterns
+
+**When to Use:**
+- Mistakes that cause runtime errors
+- Data integrity concerns
+- Critical compatibility issues
+
+### 2. Domain Skills
+
+**Purpose:** Provide comprehensive guidance for specific areas
+
+**Characteristics:**
+- Type: `"domain"`
+- Enforcement: `"suggest"`
+- Priority: `"high"` or `"medium"`
+- Advisory, not mandatory
+- Topic or domain-specific
+- Comprehensive documentation
+
+**Examples:**
+- `backend-dev-guidelines` - Node.js/Express/TypeScript patterns
+- `frontend-dev-guidelines` - React/TypeScript best practices
+- `error-tracking` - Sentry integration guidance
+
+**When to Use:**
+- Complex systems requiring deep knowledge
+- Best practices documentation
+- Architectural patterns
+- How-to guides
+
+---
+
+## Quick Start: Creating a New Skill
+
+### Step 1: Create Skill File
+
+**Location:** `.claude/skills/{skill-name}/SKILL.md`
+
+**Template:**
+```markdown
+---
+name: my-new-skill
+description: Brief description including keywords that trigger this skill. Mention topics, file types, and use cases. Be explicit about trigger terms.
+---
+
+# My New Skill
+
+## Purpose
+What this skill helps with
+
+## When to Use
+Specific scenarios and conditions
+
+## Key Information
+The actual guidance, documentation, patterns, examples
+```
+
+**Best Practices:**
+- ✅ **Name**: Lowercase, hyphens, gerund form (verb + -ing) preferred
+- ✅ **Description**: Include ALL trigger keywords/phrases (max 1024 chars)
+- ✅ **Content**: Under 500 lines - use reference files for details
+- ✅ **Examples**: Real code examples
+- ✅ **Structure**: Clear headings, lists, code blocks
+
+### Step 2: Add to skill-rules.json
+
+See [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) for complete schema.
+
+**Basic Template:**
+```json
+{
+  "my-new-skill": {
+    "type": "domain",
+    "enforcement": "suggest",
+    "priority": "medium",
+    "promptTriggers": {
+      "keywords": ["keyword1", "keyword2"],
+      "intentPatterns": ["(create|add).*?something"]
+    }
+  }
+}
+```
+
+### Step 3: Test Triggers
+
+**Test UserPromptSubmit:**
+```bash
+echo '{"session_id":"test","prompt":"your test prompt"}' | \
+  npx tsx .claude/hooks/skill-activation-prompt.ts
+```
+
+**Test PreToolUse:**
+```bash
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{"session_id":"test","tool_name":"Edit","tool_input":{"file_path":"test.ts"}}
+EOF
+```
+
+### Step 4: Refine Patterns
+
+Based on testing:
+- Add missing keywords
+- Refine intent patterns to reduce false positives
+- Adjust file path patterns
+- Test content patterns against actual files
+
+### Step 5: Follow Anthropic Best Practices
+
+✅ Keep SKILL.md under 500 lines
+✅ Use progressive disclosure with reference files
+✅ Add table of contents to reference files > 100 lines
+✅ Write detailed description with trigger keywords
+✅ Test with 3+ real scenarios before documenting
+✅ Iterate based on actual usage
+
+---
+
+## Enforcement Levels
+
+### BLOCK (Critical Guardrails)
+
+- Physically prevents Edit/Write tool execution
+- Exit code 2 from hook, stderr → Claude
+- Claude sees message and must use skill to proceed
+- **Use For**: Critical mistakes, data integrity, security issues
+
+**Example:** Database column name verification
+
+### SUGGEST (Recommended)
+
+- Reminder injected before Claude sees prompt
+- Claude is aware of relevant skills
+- Not enforced, just advisory
+- **Use For**: Domain guidance, best practices, how-to guides
+
+**Example:** Frontend development guidelines
+
+### WARN (Optional)
+
+- Low priority suggestions
+- Advisory only, minimal enforcement
+- **Use For**: Nice-to-have suggestions, informational reminders
+
+**Rarely used** - most skills are either BLOCK or SUGGEST.
+
+---
+
+## Skip Conditions & User Control
+
+### 1. Session Tracking
+
+**Purpose:** Don't nag repeatedly in same session
+
+**How it works:**
+- First edit → Hook blocks, updates session state
+- Second edit (same session) → Hook allows
+- Different session → Blocks again
+
+**State File:** `.claude/hooks/state/skills-used-{session_id}.json`
+
+### 2. File Markers
+
+**Purpose:** Permanent skip for verified files
+
+**Marker:** `// @skip-validation`
+
+**Usage:**
+```typescript
+// @skip-validation
+import { PrismaService } from './prisma';
+// This file has been manually verified
+```
+
+**NOTE:** Use sparingly - defeats the purpose if overused
+
+### 3. Environment Variables
+
+**Purpose:** Emergency disable, temporary override
+
+**Global disable:**
+```bash
+export SKIP_SKILL_GUARDRAILS=true  # Disables ALL PreToolUse blocks
+```
+
+**Skill-specific:**
+```bash
+export SKIP_DB_VERIFICATION=true
+export SKIP_ERROR_REMINDER=true
+```
+
+---
+
+## Testing Checklist
+
+When creating a new skill, verify:
+
+- [ ] Skill file created in `.claude/skills/{name}/SKILL.md`
+- [ ] Proper frontmatter with name and description
+- [ ] Entry added to `skill-rules.json`
+- [ ] Keywords tested with real prompts
+- [ ] Intent patterns tested with variations
+- [ ] File path patterns tested with actual files
+- [ ] Content patterns tested against file contents
+- [ ] Block message is clear and actionable (if guardrail)
+- [ ] Skip conditions configured appropriately
+- [ ] Priority level matches importance
+- [ ] No false positives in testing
+- [ ] No false negatives in testing
+- [ ] Performance is acceptable (<100ms or <200ms)
+- [ ] JSON syntax validated: `jq . skill-rules.json`
+- [ ] **SKILL.md under 500 lines** ⭐
+- [ ] Reference files created if needed
+- [ ] Table of contents added to files > 100 lines
+
+---
+
+## Reference Files
+
+For detailed information on specific topics, see:
+
+### [TRIGGER_TYPES.md](TRIGGER_TYPES.md)
+Complete guide to all trigger types:
+- Keyword triggers (explicit topic matching)
+- Intent patterns (implicit action detection)
+- File path triggers (glob patterns)
+- Content patterns (regex in files)
+- Best practices and examples for each
+- Common pitfalls and testing strategies
+
+### [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md)
+Complete skill-rules.json schema:
+- Full TypeScript interface definitions
+- Field-by-field explanations
+- Complete guardrail skill example
+- Complete domain skill example
+- Validation guide and common errors
+
+### [HOOK_MECHANISMS.md](HOOK_MECHANISMS.md)
+Deep dive into hook internals:
+- UserPromptSubmit flow (detailed)
+- PreToolUse flow (detailed)
+- Exit code behavior table (CRITICAL)
+- Session state management
+- Performance considerations
+
+### [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
+Comprehensive debugging guide:
+- Skill not triggering (UserPromptSubmit)
+- PreToolUse not blocking
+- False positives (too many triggers)
+- Hook not executing at all
+- Performance issues
+
+### [PATTERNS_LIBRARY.md](PATTERNS_LIBRARY.md)
+Ready-to-use pattern collection:
+- Intent pattern library (regex)
+- File path pattern library (glob)
+- Content pattern library (regex)
+- Organized by use case
+- Copy-paste ready
+
+### [ADVANCED.md](ADVANCED.md)
+Future enhancements and ideas:
+- Dynamic rule updates
+- Skill dependencies
+- Conditional enforcement
+- Skill analytics
+- Skill versioning
+
+---
+
+## Quick Reference Summary
+
+### Create New Skill (5 Steps)
+
+1. Create `.claude/skills/{name}/SKILL.md` with frontmatter
+2. Add entry to `.claude/skills/skill-rules.json`
+3. Test with `npx tsx` commands
+4. Refine patterns based on testing
+5. Keep SKILL.md under 500 lines
+
+### Trigger Types
+
+- **Keywords**: Explicit topic mentions
+- **Intent**: Implicit action detection
+- **File Paths**: Location-based activation
+- **Content**: Technology-specific detection
+
+See [TRIGGER_TYPES.md](TRIGGER_TYPES.md) for complete details.
+
+### Enforcement
+
+- **BLOCK**: Exit code 2, critical only
+- **SUGGEST**: Inject context, most common
+- **WARN**: Advisory, rarely used
+
+### Skip Conditions
+
+- **Session tracking**: Automatic (prevents repeated nags)
+- **File markers**: `// @skip-validation` (permanent skip)
+- **Env vars**: `SKIP_SKILL_GUARDRAILS` (emergency disable)
+
+### Anthropic Best Practices
+
+✅ **500-line rule**: Keep SKILL.md under 500 lines
+✅ **Progressive disclosure**: Use reference files for details
+✅ **Table of contents**: Add to reference files > 100 lines
+✅ **One level deep**: Don't nest references deeply
+✅ **Rich descriptions**: Include all trigger keywords (max 1024 chars)
+✅ **Test first**: Build 3+ evaluations before extensive documentation
+✅ **Gerund naming**: Prefer verb + -ing (e.g., "processing-pdfs")
+
+### Troubleshoot
+
+Test hooks manually:
+```bash
+# UserPromptSubmit
+echo '{"prompt":"test"}' | npx tsx .claude/hooks/skill-activation-prompt.ts
+
+# PreToolUse
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{"tool_name":"Edit","tool_input":{"file_path":"test.ts"}}
+EOF
+```
+
+See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for complete debugging guide.
+
+---
+
+## Related Files
+
+**Configuration:**
+- `.claude/skills/skill-rules.json` - Master configuration
+- `.claude/hooks/state/` - Session tracking
+- `.claude/settings.json` - Hook registration
+
+**Hooks:**
+- `.claude/hooks/skill-activation-prompt.ts` - UserPromptSubmit
+- `.claude/hooks/error-handling-reminder.ts` - Stop event (gentle reminders)
+
+**All Skills:**
+- `.claude/skills/*/SKILL.md` - Skill content files
+
+---
+
+**Skill Status**: COMPLETE - Restructured following Anthropic best practices ✅
+**Line Count**: < 500 (following 500-line rule) ✅
+**Progressive Disclosure**: Reference files for detailed information ✅
+
+**Next**: Create more skills, refine patterns based on usage
diff --git a/.agents/skills/skill-developer/SKILL_RULES_REFERENCE.md b/.agents/skills/skill-developer/SKILL_RULES_REFERENCE.md
new file mode 100644
index 0000000..1cad7d9
--- /dev/null
+++ b/.agents/skills/skill-developer/SKILL_RULES_REFERENCE.md
@@ -0,0 +1,315 @@
+# skill-rules.json - Complete Reference
+
+Complete schema and configuration reference for `.claude/skills/skill-rules.json`.
+
+## Table of Contents
+
+- [File Location](#file-location)
+- [Complete TypeScript Schema](#complete-typescript-schema)
+- [Field Guide](#field-guide)
+- [Example: Guardrail Skill](#example-guardrail-skill)
+- [Example: Domain Skill](#example-domain-skill)
+- [Validation](#validation)
+
+---
+
+## File Location
+
+**Path:** `.claude/skills/skill-rules.json`
+
+This JSON file defines all skills and their trigger conditions for the auto-activation system.
+
+---
+
+## Complete TypeScript Schema
+
+```typescript
+interface SkillRules {
+    version: string;
+    skills: Record<string, SkillRule>;
+}
+
+interface SkillRule {
+    type: 'guardrail' | 'domain';
+    enforcement: 'block' | 'suggest' | 'warn';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+
+    promptTriggers?: {
+        keywords?: string[];
+        intentPatterns?: string[];  // Regex strings
+    };
+
+    fileTriggers?: {
+        pathPatterns: string[];     // Glob patterns
+        pathExclusions?: string[];  // Glob patterns
+        contentPatterns?: string[]; // Regex strings
+        createOnly?: boolean;       // Only trigger on file creation
+    };
+
+    blockMessage?: string;  // For guardrails, {file_path} placeholder
+
+    skipConditions?: {
+        sessionSkillUsed?: boolean;      // Skip if used in session
+        fileMarkers?: string[];          // e.g., ["@skip-validation"]
+        envOverride?: string;            // e.g., "SKIP_DB_VERIFICATION"
+    };
+}
+```
+
+---
+
+## Field Guide
+
+### Top Level
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `version` | string | Yes | Schema version (currently "1.0") |
+| `skills` | object | Yes | Map of skill name → SkillRule |
+
+### SkillRule Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `type` | string | Yes | "guardrail" (enforced) or "domain" (advisory) |
+| `enforcement` | string | Yes | "block" (PreToolUse), "suggest" (UserPromptSubmit), or "warn" |
+| `priority` | string | Yes | "critical", "high", "medium", or "low" |
+| `promptTriggers` | object | Optional | Triggers for UserPromptSubmit hook |
+| `fileTriggers` | object | Optional | Triggers for PreToolUse hook |
+| `blockMessage` | string | Optional* | Required if enforcement="block". Use `{file_path}` placeholder |
+| `skipConditions` | object | Optional | Escape hatches and session tracking |
+
+*Required for guardrails
+
+### promptTriggers Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `keywords` | string[] | Optional | Exact substring matches (case-insensitive) |
+| `intentPatterns` | string[] | Optional | Regex patterns for intent detection |
+
+### fileTriggers Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `pathPatterns` | string[] | Yes* | Glob patterns for file paths |
+| `pathExclusions` | string[] | Optional | Glob patterns to exclude (e.g., test files) |
+| `contentPatterns` | string[] | Optional | Regex patterns to match file content |
+| `createOnly` | boolean | Optional | Only trigger when creating new files |
+
+*Required if fileTriggers is present
+
+### skipConditions Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `sessionSkillUsed` | boolean | Optional | Skip if skill already used this session |
+| `fileMarkers` | string[] | Optional | Skip if file contains comment marker |
+| `envOverride` | string | Optional | Environment variable name to disable skill |
+
+---
+
+## Example: Guardrail Skill
+
+Complete example of a blocking guardrail skill with all features:
+
+```json
+{
+  "database-verification": {
+    "type": "guardrail",
+    "enforcement": "block",
+    "priority": "critical",
+
+    "promptTriggers": {
+      "keywords": [
+        "prisma",
+        "database",
+        "table",
+        "column",
+        "schema",
+        "query",
+        "migration"
+      ],
+      "intentPatterns": [
+        "(add|create|implement).*?(user|login|auth|tracking|feature)",
+        "(modify|update|change).*?(table|column|schema|field)",
+        "database.*?(change|update|modify|migration)"
+      ]
+    },
+
+    "fileTriggers": {
+      "pathPatterns": [
+        "**/schema.prisma",
+        "**/migrations/**/*.sql",
+        "database/src/**/*.ts",
+        "form/src/**/*.ts",
+        "email/src/**/*.ts",
+        "users/src/**/*.ts",
+        "projects/src/**/*.ts",
+        "utilities/src/**/*.ts"
+      ],
+      "pathExclusions": [
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ],
+      "contentPatterns": [
+        "import.*[Pp]risma",
+        "PrismaService",
+        "prisma\\.",
+        "\\.findMany\\(",
+        "\\.findUnique\\(",
+        "\\.findFirst\\(",
+        "\\.create\\(",
+        "\\.createMany\\(",
+        "\\.update\\(",
+        "\\.updateMany\\(",
+        "\\.upsert\\(",
+        "\\.delete\\(",
+        "\\.deleteMany\\("
+      ]
+    },
+
+    "blockMessage": "⚠️ BLOCKED - Database Operation Detected\n\n📋 REQUIRED ACTION:\n1. Use Skill tool: 'database-verification'\n2. Verify ALL table and column names against schema\n3. Check database structure with DESCRIBE commands\n4. Then retry this edit\n\nReason: Prevent column name errors in Prisma queries\nFile: {file_path}\n\n💡 TIP: Add '// @skip-validation' comment to skip future checks",
+
+    "skipConditions": {
+      "sessionSkillUsed": true,
+      "fileMarkers": [
+        "@skip-validation"
+      ],
+      "envOverride": "SKIP_DB_VERIFICATION"
+    }
+  }
+}
+```
+
+### Key Points for Guardrails
+
+1. **type**: Must be "guardrail"
+2. **enforcement**: Must be "block"
+3. **priority**: Usually "critical" or "high"
+4. **blockMessage**: Required, clear actionable steps
+5. **skipConditions**: Session tracking prevents repeated nagging
+6. **fileTriggers**: Usually has both path and content patterns
+7. **contentPatterns**: Catch actual usage of technology
+
+---
+
+## Example: Domain Skill
+
+Complete example of a suggestion-based domain skill:
+
+```json
+{
+  "project-catalog-developer": {
+    "type": "domain",
+    "enforcement": "suggest",
+    "priority": "high",
+
+    "promptTriggers": {
+      "keywords": [
+        "layout",
+        "layout system",
+        "grid",
+        "grid layout",
+        "toolbar",
+        "column",
+        "cell editor",
+        "cell renderer",
+        "submission",
+        "submissions",
+        "blog dashboard",
+        "datagrid",
+        "data grid",
+        "CustomToolbar",
+        "GridLayoutDialog",
+        "useGridLayout",
+        "auto-save",
+        "column order",
+        "column width",
+        "filter",
+        "sort"
+      ],
+      "intentPatterns": [
+        "(how does|how do|explain|what is|describe).*?(layout|grid|toolbar|column|submission|catalog)",
+        "(add|create|modify|change).*?(toolbar|column|cell|editor|renderer)",
+        "blog dashboard.*?"
+      ]
+    },
+
+    "fileTriggers": {
+      "pathPatterns": [
+        "frontend/src/features/submissions/**/*.tsx",
+        "frontend/src/features/submissions/**/*.ts"
+      ],
+      "pathExclusions": [
+        "**/*.test.tsx",
+        "**/*.test.ts"
+      ]
+    }
+  }
+}
+```
+
+### Key Points for Domain Skills
+
+1. **type**: Must be "domain"
+2. **enforcement**: Usually "suggest"
+3. **priority**: "high" or "medium"
+4. **blockMessage**: Not needed (doesn't block)
+5. **skipConditions**: Optional (less critical)
+6. **promptTriggers**: Usually has extensive keywords
+7. **fileTriggers**: May have only path patterns (content less important)
+
+---
+
+## Validation
+
+### Check JSON Syntax
+
+```bash
+cat .claude/skills/skill-rules.json | jq .
+```
+
+If valid, jq will pretty-print the JSON. If invalid, it will show the error.
+
+### Common JSON Errors
+
+**Trailing comma:**
+```json
+{
+  "keywords": ["one", "two",]  // ❌ Trailing comma
+}
+```
+
+**Missing quotes:**
+```json
+{
+  type: "guardrail"  // ❌ Missing quotes on key
+}
+```
+
+**Single quotes (invalid JSON):**
+```json
+{
+  'type': 'guardrail'  // ❌ Must use double quotes
+}
+```
+
+### Validation Checklist
+
+- [ ] JSON syntax valid (use `jq`)
+- [ ] All skill names match SKILL.md filenames
+- [ ] Guardrails have `blockMessage`
+- [ ] Block messages use `{file_path}` placeholder
+- [ ] Intent patterns are valid regex (test on regex101.com)
+- [ ] File path patterns use correct glob syntax
+- [ ] Content patterns escape special characters
+- [ ] Priority matches enforcement level
+- [ ] No duplicate skill names
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TRIGGER_TYPES.md](TRIGGER_TYPES.md) - Complete trigger documentation
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Debugging configuration issues
diff --git a/.agents/skills/skill-developer/TRIGGER_TYPES.md b/.agents/skills/skill-developer/TRIGGER_TYPES.md
new file mode 100644
index 0000000..dd61951
--- /dev/null
+++ b/.agents/skills/skill-developer/TRIGGER_TYPES.md
@@ -0,0 +1,305 @@
+# Trigger Types - Complete Guide
+
+Complete reference for configuring skill triggers in Claude Code's skill auto-activation system.
+
+## Table of Contents
+
+- [Keyword Triggers (Explicit)](#keyword-triggers-explicit)
+- [Intent Pattern Triggers (Implicit)](#intent-pattern-triggers-implicit)
+- [File Path Triggers](#file-path-triggers)
+- [Content Pattern Triggers](#content-pattern-triggers)
+- [Best Practices Summary](#best-practices-summary)
+
+---
+
+## Keyword Triggers (Explicit)
+
+### How It Works
+
+Case-insensitive substring matching in user's prompt.
+
+### Use For
+
+Topic-based activation where user explicitly mentions the subject.
+
+### Configuration
+
+```json
+"promptTriggers": {
+  "keywords": ["layout", "grid", "toolbar", "submission"]
+}
+```
+
+### Example
+
+- User prompt: "how does the **layout** system work?"
+- Matches: "layout" keyword
+- Activates: `project-catalog-developer`
+
+### Best Practices
+
+- Use specific, unambiguous terms
+- Include common variations ("layout", "layout system", "grid layout")
+- Avoid overly generic words ("system", "work", "create")
+- Test with real prompts
+
+---
+
+## Intent Pattern Triggers (Implicit)
+
+### How It Works
+
+Regex pattern matching to detect user's intent even when they don't mention the topic explicitly.
+
+### Use For
+
+Action-based activation where user describes what they want to do rather than the specific topic.
+
+### Configuration
+
+```json
+"promptTriggers": {
+  "intentPatterns": [
+    "(create|add|implement).*?(feature|endpoint)",
+    "(how does|explain).*?(layout|workflow)"
+  ]
+}
+```
+
+### Examples
+
+**Database Work:**
+- User prompt: "add user tracking feature"
+- Matches: `(add).*?(feature)`
+- Activates: `database-verification`, `error-tracking`
+
+**Component Creation:**
+- User prompt: "create a dashboard widget"
+- Matches: `(create).*?(component)` (if component in pattern)
+- Activates: `frontend-dev-guidelines`
+
+### Best Practices
+
+- Capture common action verbs: `(create|add|modify|build|implement)`
+- Include domain-specific nouns: `(feature|endpoint|component|workflow)`
+- Use non-greedy matching: `.*?` instead of `.*`
+- Test patterns thoroughly with regex tester (https://regex101.com/)
+- Don't make patterns too broad (causes false positives)
+- Don't make patterns too specific (causes false negatives)
+
+### Common Pattern Examples
+
+```regex
+# Database Work
+(add|create|implement).*?(user|login|auth|feature)
+
+# Explanations
+(how does|explain|what is|describe).*?
+
+# Frontend Work
+(create|add|make|build).*?(component|UI|page|modal|dialog)
+
+# Error Handling
+(fix|handle|catch|debug).*?(error|exception|bug)
+
+# Workflow Operations
+(create|add|modify).*?(workflow|step|branch|condition)
+```
+
+---
+
+## File Path Triggers
+
+### How It Works
+
+Glob pattern matching against the file path being edited.
+
+### Use For
+
+Domain/area-specific activation based on file location in the project.
+
+### Configuration
+
+```json
+"fileTriggers": {
+  "pathPatterns": [
+    "frontend/src/**/*.tsx",
+    "form/src/**/*.ts"
+  ],
+  "pathExclusions": [
+    "**/*.test.ts",
+    "**/*.spec.ts"
+  ]
+}
+```
+
+### Glob Pattern Syntax
+
+- `**` = Any number of directories (including zero)
+- `*` = Any characters within a directory name
+- Examples:
+  - `frontend/src/**/*.tsx` = All .tsx files in frontend/src and subdirs
+  - `**/schema.prisma` = schema.prisma anywhere in project
+  - `form/src/**/*.ts` = All .ts files in form/src subdirs
+
+### Example
+
+- File being edited: `frontend/src/components/Dashboard.tsx`
+- Matches: `frontend/src/**/*.tsx`
+- Activates: `frontend-dev-guidelines`
+
+### Best Practices
+
+- Be specific to avoid false positives
+- Use exclusions for test files: `**/*.test.ts`
+- Consider subdirectory structure
+- Test patterns with actual file paths
+- Use narrower patterns when possible: `form/src/services/**` not `form/**`
+
+### Common Path Patterns
+
+```glob
+# Frontend
+frontend/src/**/*.tsx        # All React components
+frontend/src/**/*.ts         # All TypeScript files
+frontend/src/components/**   # Only components directory
+
+# Backend Services
+form/src/**/*.ts            # Form service
+email/src/**/*.ts           # Email service
+users/src/**/*.ts           # Users service
+
+# Database
+**/schema.prisma            # Prisma schema (anywhere)
+**/migrations/**/*.sql      # Migration files
+database/src/**/*.ts        # Database scripts
+
+# Workflows
+form/src/workflow/**/*.ts              # Workflow engine
+form/src/workflow-definitions/**/*.json # Workflow definitions
+
+# Test Exclusions
+**/*.test.ts                # TypeScript tests
+**/*.test.tsx               # React component tests
+**/*.spec.ts                # Spec files
+```
+
+---
+
+## Content Pattern Triggers
+
+### How It Works
+
+Regex pattern matching against the file's actual content (what's inside the file).
+
+### Use For
+
+Technology-specific activation based on what the code imports or uses (Prisma, controllers, specific libraries).
+
+### Configuration
+
+```json
+"fileTriggers": {
+  "contentPatterns": [
+    "import.*[Pp]risma",
+    "PrismaService",
+    "\\.findMany\\(",
+    "\\.create\\("
+  ]
+}
+```
+
+### Examples
+
+**Prisma Detection:**
+- File contains: `import { PrismaService } from '@project/database'`
+- Matches: `import.*[Pp]risma`
+- Activates: `database-verification`
+
+**Controller Detection:**
+- File contains: `export class UserController {`
+- Matches: `export class.*Controller`
+- Activates: `error-tracking`
+
+### Best Practices
+
+- Match imports: `import.*[Pp]risma` (case-insensitive with [Pp])
+- Escape special regex chars: `\\.findMany\\(` not `.findMany(`
+- Patterns use case-insensitive flag
+- Test against real file content
+- Make patterns specific enough to avoid false matches
+
+### Common Content Patterns
+
+```regex
+# Prisma/Database
+import.*[Pp]risma                # Prisma imports
+PrismaService                    # PrismaService usage
+prisma\.                         # prisma.something
+\.findMany\(                     # Prisma query methods
+\.create\(
+\.update\(
+\.delete\(
+
+# Controllers/Routes
+export class.*Controller         # Controller classes
+router\.                         # Express router
+app\.(get|post|put|delete|patch) # Express app routes
+
+# Error Handling
+try\s*\{                        # Try blocks
+catch\s*\(                      # Catch blocks
+throw new                        # Throw statements
+
+# React/Components
+export.*React\.FC               # React functional components
+export default function.*       # Default function exports
+useState|useEffect              # React hooks
+```
+
+---
+
+## Best Practices Summary
+
+### DO:
+✅ Use specific, unambiguous keywords
+✅ Test all patterns with real examples
+✅ Include common variations
+✅ Use non-greedy regex: `.*?`
+✅ Escape special characters in content patterns
+✅ Add exclusions for test files
+✅ Make file path patterns narrow and specific
+
+### DON'T:
+❌ Use overly generic keywords ("system", "work")
+❌ Make intent patterns too broad (false positives)
+❌ Make patterns too specific (false negatives)
+❌ Forget to test with regex tester (https://regex101.com/)
+❌ Use greedy regex: `.*` instead of `.*?`
+❌ Match too broadly in file paths
+
+### Testing Your Triggers
+
+**Test keyword/intent triggers:**
+```bash
+echo '{"session_id":"test","prompt":"your test prompt"}' | \
+  npx tsx .claude/hooks/skill-activation-prompt.ts
+```
+
+**Test file path/content triggers:**
+```bash
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{
+  "session_id": "test",
+  "tool_name": "Edit",
+  "tool_input": {"file_path": "/path/to/test/file.ts"}
+}
+EOF
+```
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Complete skill-rules.json schema
+- [PATTERNS_LIBRARY.md](PATTERNS_LIBRARY.md) - Ready-to-use pattern library
diff --git a/.agents/skills/skill-developer/TROUBLESHOOTING.md b/.agents/skills/skill-developer/TROUBLESHOOTING.md
new file mode 100644
index 0000000..f8cd3d3
--- /dev/null
+++ b/.agents/skills/skill-developer/TROUBLESHOOTING.md
@@ -0,0 +1,514 @@
+# Troubleshooting - Skill Activation Issues
+
+Complete debugging guide for skill activation problems.
+
+## Table of Contents
+
+- [Skill Not Triggering](#skill-not-triggering)
+  - [UserPromptSubmit Not Suggesting](#userpromptsubmit-not-suggesting)
+  - [PreToolUse Not Blocking](#pretooluse-not-blocking)
+- [False Positives](#false-positives)
+- [Hook Not Executing](#hook-not-executing)
+- [Performance Issues](#performance-issues)
+
+---
+
+## Skill Not Triggering
+
+### UserPromptSubmit Not Suggesting
+
+**Symptoms:** Ask a question, but no skill suggestion appears in output.
+
+**Common Causes:**
+
+####  1. Keywords Don't Match
+
+**Check:**
+- Look at `promptTriggers.keywords` in skill-rules.json
+- Are the keywords actually in your prompt?
+- Remember: case-insensitive substring matching
+
+**Example:**
+```json
+"keywords": ["layout", "grid"]
+```
+- "how does the layout work?" → ✅ Matches "layout"
+- "how does the grid system work?" → ✅ Matches "grid"
+- "how do layouts work?" → ✅ Matches "layout"
+- "how does it work?" → ❌ No match
+
+**Fix:** Add more keyword variations to skill-rules.json
+
+#### 2. Intent Patterns Too Specific
+
+**Check:**
+- Look at `promptTriggers.intentPatterns`
+- Test regex at https://regex101.com/
+- May need broader patterns
+
+**Example:**
+```json
+"intentPatterns": [
+  "(create|add).*?(database.*?table)"  // Too specific
+]
+```
+- "create a database table" → ✅ Matches
+- "add new table" → ❌ Doesn't match (missing "database")
+
+**Fix:** Broaden the pattern:
+```json
+"intentPatterns": [
+  "(create|add).*?(table|database)"  // Better
+]
+```
+
+#### 3. Typo in Skill Name
+
+**Check:**
+- Skill name in SKILL.md frontmatter
+- Skill name in skill-rules.json
+- Must match exactly
+
+**Example:**
+```yaml
+# SKILL.md
+name: project-catalog-developer
+```
+```json
+// skill-rules.json
+"project-catalogue-developer": {  // ❌ Typo: catalogue vs catalog
+  ...
+}
+```
+
+**Fix:** Make names match exactly
+
+#### 4. JSON Syntax Error
+
+**Check:**
+```bash
+cat .claude/skills/skill-rules.json | jq .
+```
+
+If invalid JSON, jq will show the error.
+
+**Common errors:**
+- Trailing commas
+- Missing quotes
+- Single quotes instead of double
+- Unescaped characters in strings
+
+**Fix:** Correct JSON syntax, validate with jq
+
+#### Debug Command
+
+Test the hook manually:
+
+```bash
+echo '{"session_id":"debug","prompt":"your test prompt here"}' | \
+  npx tsx .claude/hooks/skill-activation-prompt.ts
+```
+
+Expected: Your skill should appear in the output.
+
+---
+
+### PreToolUse Not Blocking
+
+**Symptoms:** Edit a file that should trigger a guardrail, but no block occurs.
+
+**Common Causes:**
+
+#### 1. File Path Doesn't Match Patterns
+
+**Check:**
+- File path being edited
+- `fileTriggers.pathPatterns` in skill-rules.json
+- Glob pattern syntax
+
+**Example:**
+```json
+"pathPatterns": [
+  "frontend/src/**/*.tsx"
+]
+```
+- Editing: `frontend/src/components/Dashboard.tsx` → ✅ Matches
+- Editing: `frontend/tests/Dashboard.test.tsx` → ✅ Matches (add exclusion!)
+- Editing: `backend/src/app.ts` → ❌ Doesn't match
+
+**Fix:** Adjust glob patterns or add the missing path
+
+#### 2. Excluded by pathExclusions
+
+**Check:**
+- Are you editing a test file?
+- Look at `fileTriggers.pathExclusions`
+
+**Example:**
+```json
+"pathExclusions": [
+  "**/*.test.ts",
+  "**/*.spec.ts"
+]
+```
+- Editing: `services/user.test.ts` → ❌ Excluded
+- Editing: `services/user.ts` → ✅ Not excluded
+
+**Fix:** If test exclusion too broad, narrow it or remove
+
+#### 3. Content Pattern Not Found
+
+**Check:**
+- Does the file actually contain the pattern?
+- Look at `fileTriggers.contentPatterns`
+- Is the regex correct?
+
+**Example:**
+```json
+"contentPatterns": [
+  "import.*[Pp]risma"
+]
+```
+- File has: `import { PrismaService } from './prisma'` → ✅ Matches
+- File has: `import { Database } from './db'` → ❌ Doesn't match
+
+**Debug:**
+```bash
+# Check if pattern exists in file
+grep -i "prisma" path/to/file.ts
+```
+
+**Fix:** Adjust content patterns or add missing imports
+
+#### 4. Session Already Used Skill
+
+**Check session state:**
+```bash
+ls .claude/hooks/state/
+cat .claude/hooks/state/skills-used-{session-id}.json
+```
+
+**Example:**
+```json
+{
+  "skills_used": ["database-verification"],
+  "files_verified": []
+}
+```
+
+If the skill is in `skills_used`, it won't block again in this session.
+
+**Fix:** Delete the state file to reset:
+```bash
+rm .claude/hooks/state/skills-used-{session-id}.json
+```
+
+#### 5. File Marker Present
+
+**Check file for skip marker:**
+```bash
+grep "@skip-validation" path/to/file.ts
+```
+
+If found, the file is permanently skipped.
+
+**Fix:** Remove the marker if verification is needed again
+
+#### 6. Environment Variable Override
+
+**Check:**
+```bash
+echo $SKIP_DB_VERIFICATION
+echo $SKIP_SKILL_GUARDRAILS
+```
+
+If set, the skill is disabled.
+
+**Fix:** Unset the environment variable:
+```bash
+unset SKIP_DB_VERIFICATION
+```
+
+#### Debug Command
+
+Test the hook manually:
+
+```bash
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts 2>&1
+{
+  "session_id": "debug",
+  "tool_name": "Edit",
+  "tool_input": {"file_path": "/root/git/your-project/form/src/services/user.ts"}
+}
+EOF
+echo "Exit code: $?"
+```
+
+Expected:
+- Exit code 2 + stderr message if should block
+- Exit code 0 + no output if should allow
+
+---
+
+## False Positives
+
+**Symptoms:** Skill triggers when it shouldn't.
+
+**Common Causes & Solutions:**
+
+### 1. Keywords Too Generic
+
+**Problem:**
+```json
+"keywords": ["user", "system", "create"]  // Too broad
+```
+- Triggers on: "user manual", "file system", "create directory"
+
+**Solution:** Make keywords more specific
+```json
+"keywords": [
+  "user authentication",
+  "user tracking",
+  "create feature"
+]
+```
+
+### 2. Intent Patterns Too Broad
+
+**Problem:**
+```json
+"intentPatterns": [
+  "(create)"  // Matches everything with "create"
+]
+```
+- Triggers on: "create file", "create folder", "create account"
+
+**Solution:** Add context to patterns
+```json
+"intentPatterns": [
+  "(create|add).*?(database|table|feature)"  // More specific
+]
+```
+
+**Advanced:** Use negative lookaheads to exclude
+```regex
+(create)(?!.*test).*?(feature)  // Don't match if "test" appears
+```
+
+### 3. File Paths Too Generic
+
+**Problem:**
+```json
+"pathPatterns": [
+  "form/**"  // Matches everything in form/
+]
+```
+- Triggers on: test files, config files, everything
+
+**Solution:** Use narrower patterns
+```json
+"pathPatterns": [
+  "form/src/services/**/*.ts",  // Only service files
+  "form/src/controllers/**/*.ts"
+]
+```
+
+### 4. Content Patterns Catching Unrelated Code
+
+**Problem:**
+```json
+"contentPatterns": [
+  "Prisma"  // Matches in comments, strings, etc.
+]
+```
+- Triggers on: `// Don't use Prisma here`
+- Triggers on: `const note = "Prisma is cool"`
+
+**Solution:** Make patterns more specific
+```json
+"contentPatterns": [
+  "import.*[Pp]risma",        // Only imports
+  "PrismaService\\.",         // Only actual usage
+  "prisma\\.(findMany|create)" // Specific methods
+]
+```
+
+### 5. Adjust Enforcement Level
+
+**Last resort:** If false positives are frequent:
+
+```json
+{
+  "enforcement": "block"  // Change to "suggest"
+}
+```
+
+This makes it advisory instead of blocking.
+
+---
+
+## Hook Not Executing
+
+**Symptoms:** Hook doesn't run at all - no suggestion, no block.
+
+**Common Causes:**
+
+### 1. Hook Not Registered
+
+**Check `.claude/settings.json`:**
+```bash
+cat .claude/settings.json | jq '.hooks.UserPromptSubmit'
+cat .claude/settings.json | jq '.hooks.PreToolUse'
+```
+
+Expected: Hook entries present
+
+**Fix:** Add missing hook registration:
+```json
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/skill-activation-prompt.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 2. Bash Wrapper Not Executable
+
+**Check:**
+```bash
+ls -l .claude/hooks/*.sh
+```
+
+Expected: `-rwxr-xr-x` (executable)
+
+**Fix:**
+```bash
+chmod +x .claude/hooks/*.sh
+```
+
+### 3. Incorrect Shebang
+
+**Check:**
+```bash
+head -1 .claude/hooks/skill-activation-prompt.sh
+```
+
+Expected: `#!/bin/bash`
+
+**Fix:** Add correct shebang to first line
+
+### 4. npx/tsx Not Available
+
+**Check:**
+```bash
+npx tsx --version
+```
+
+Expected: Version number
+
+**Fix:** Install dependencies:
+```bash
+cd .claude/hooks
+npm install
+```
+
+### 5. TypeScript Compilation Error
+
+**Check:**
+```bash
+cd .claude/hooks
+npx tsc --noEmit skill-activation-prompt.ts
+```
+
+Expected: No output (no errors)
+
+**Fix:** Correct TypeScript syntax errors
+
+---
+
+## Performance Issues
+
+**Symptoms:** Hooks are slow, noticeable delay before prompt/edit.
+
+**Common Causes:**
+
+### 1. Too Many Patterns
+
+**Check:**
+- Count patterns in skill-rules.json
+- Each pattern = regex compilation + matching
+
+**Solution:** Reduce patterns
+- Combine similar patterns
+- Remove redundant patterns
+- Use more specific patterns (faster matching)
+
+### 2. Complex Regex
+
+**Problem:**
+```regex
+(create|add|modify|update|implement|build).*?(feature|endpoint|route|service|controller|component|UI|page)
+```
+- Long alternations = slow
+
+**Solution:** Simplify
+```regex
+(create|add).*?(feature|endpoint)  // Fewer alternatives
+```
+
+### 3. Too Many Files Checked
+
+**Problem:**
+```json
+"pathPatterns": [
+  "**/*.ts"  // Checks ALL TypeScript files
+]
+```
+
+**Solution:** Be more specific
+```json
+"pathPatterns": [
+  "form/src/services/**/*.ts",  // Only specific directory
+  "form/src/controllers/**/*.ts"
+]
+```
+
+### 4. Large Files
+
+Content pattern matching reads entire file - slow for large files.
+
+**Solution:**
+- Only use content patterns when necessary
+- Consider file size limits (future enhancement)
+
+### Measure Performance
+
+```bash
+# UserPromptSubmit
+time echo '{"prompt":"test"}' | npx tsx .claude/hooks/skill-activation-prompt.ts
+
+# PreToolUse
+time cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{"tool_name":"Edit","tool_input":{"file_path":"test.ts"}}
+EOF
+```
+
+**Target metrics:**
+- UserPromptSubmit: < 100ms
+- PreToolUse: < 200ms
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [HOOK_MECHANISMS.md](HOOK_MECHANISMS.md) - How hooks work
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Configuration reference
diff --git a/.agents/skills/skill-rails-upgrade/SKILL.md b/.agents/skills/skill-rails-upgrade/SKILL.md
new file mode 100644
index 0000000..0c343d8
--- /dev/null
+++ b/.agents/skills/skill-rails-upgrade/SKILL.md
@@ -0,0 +1,408 @@
+---
+name: skill-rails-upgrade
+description: "Analyze Rails apps and provide upgrade assessments"
+source: "https://github.com/robzolkos/skill-rails-upgrade"
+risk: safe
+---
+
+## When to Use This Skill
+
+Analyze Rails apps and provide upgrade assessments
+
+Use this skill when working with analyze rails apps and provide upgrade assessments.
+# Rails Upgrade Analyzer
+
+Analyze the current Rails application and provide a comprehensive upgrade assessment with selective file merging.
+
+## Step 1: Verify Rails Application
+
+Check that we're in a Rails application by looking for these files:
+- `Gemfile` (must exist and contain 'rails')
+- `config/application.rb` (Rails application config)
+- `config/environment.rb` (Rails environment)
+
+If any of these are missing or don't indicate a Rails app, stop and inform the user this doesn't appear to be a Rails application.
+
+## Step 2: Get Current Rails Version
+
+Extract the current Rails version from:
+1. First, check `Gemfile.lock` for the exact installed version (look for `rails (x.y.z)`)
+2. If not found, check `Gemfile` for the version constraint
+
+Report the exact current version (e.g., `7.1.3`).
+
+## Step 3: Find Latest Rails Version
+
+Use the GitHub CLI to fetch the latest Rails release:
+
+```bash
+gh api repos/rails/rails/releases/latest --jq '.tag_name'
+```
+
+This returns the latest stable version tag (e.g., `v8.0.1`). Strip the 'v' prefix for comparison.
+
+Also check recent tags to understand the release landscape:
+
+```bash
+gh api repos/rails/rails/tags --jq '.[0:10] | .[].name'
+```
+
+## Step 4: Determine Upgrade Type
+
+Compare current and latest versions to classify the upgrade:
+
+- **Patch upgrade**: Same major.minor, different patch (e.g., 7.1.3 → 7.1.5)
+- **Minor upgrade**: Same major, different minor (e.g., 7.1.3 → 7.2.0)
+- **Major upgrade**: Different major version (e.g., 7.1.3 → 8.0.0)
+
+## Step 5: Fetch Upgrade Guide
+
+Use WebFetch to get the official Rails upgrade guide:
+
+URL: `https://guides.rubyonrails.org/upgrading_ruby_on_rails.html`
+
+Look for sections relevant to the version jump. The guide is organized by target version with sections like:
+- "Upgrading from Rails X.Y to Rails X.Z"
+- Breaking changes
+- Deprecation warnings
+- Configuration changes
+- Required migrations
+
+Extract and summarize the relevant sections for the user's specific upgrade path.
+
+## Step 6: Fetch Rails Diff
+
+Use WebFetch to get the diff between versions from railsdiff.org:
+
+URL: `https://railsdiff.org/{current_version}/{target_version}`
+
+For example: `https://railsdiff.org/7.1.3/8.0.0`
+
+This shows:
+- Changes to default configuration files
+- New files that need to be added
+- Modified initializers
+- Updated dependencies
+- Changes to bin/ scripts
+
+Summarize the key file changes.
+
+## Step 7: Check JavaScript Dependencies
+
+Rails applications often include JavaScript packages that should be updated alongside Rails. Check for and report on these dependencies.
+
+### 7.1: Identify JS Package Manager
+
+Check which package manager the app uses:
+
+```bash
+# Check for package.json (npm/yarn)
+ls package.json 2>/dev/null
+
+# Check for importmap (Rails 7+)
+ls config/importmap.rb 2>/dev/null
+```
+
+### 7.2: Check Rails-Related JS Packages
+
+If `package.json` exists, check for these Rails-related packages:
+
+```bash
+# Extract current versions of Rails-related packages
+cat package.json | grep -E '"@hotwired/|"@rails/|"stimulus"|"turbo-rails"' || echo "No Rails JS packages found"
+```
+
+**Key packages to check:**
+
+| Package | Purpose | Version Alignment |
+|---------|---------|-------------------|
+| `@hotwired/turbo-rails` | Turbo Drive/Frames/Streams | Should match Rails version era |
+| `@hotwired/stimulus` | Stimulus JS framework | Generally stable across Rails versions |
+| `@rails/actioncable` | WebSocket support | Should match Rails version |
+| `@rails/activestorage` | Direct uploads | Should match Rails version |
+| `@rails/actiontext` | Rich text editing | Should match Rails version |
+| `@rails/request.js` | Rails UJS replacement | Should match Rails version era |
+
+### 7.3: Check for Updates
+
+For npm/yarn projects, check for available updates:
+
+```bash
+# Using npm
+npm outdated @hotwired/turbo-rails @hotwired/stimulus @rails/actioncable @rails/activestorage 2>/dev/null
+
+# Or check latest versions directly
+npm view @hotwired/turbo-rails version 2>/dev/null
+npm view @rails/actioncable version 2>/dev/null
+```
+
+### 7.4: Check Importmap Pins (if applicable)
+
+If the app uses importmap-rails, check `config/importmap.rb` for pinned versions:
+
+```bash
+cat config/importmap.rb | grep -E 'pin.*turbo|pin.*stimulus|pin.*@rails' || echo "No importmap pins found"
+```
+
+To update importmap pins:
+```bash
+bin/importmap pin @hotwired/turbo-rails
+bin/importmap pin @hotwired/stimulus
+```
+
+### 7.5: JS Dependency Summary
+
+Include in the upgrade summary:
+
+```
+### JavaScript Dependencies
+
+**Package Manager**: [npm/yarn/importmap/none]
+
+| Package | Current | Latest | Action |
+|---------|---------|--------|--------|
+| @hotwired/turbo-rails | 8.0.4 | 8.0.12 | Update recommended |
+| @rails/actioncable | 7.1.0 | 8.0.0 | Update with Rails |
+| ... | ... | ... | ... |
+
+**Recommended JS Updates:**
+- Run `npm update @hotwired/turbo-rails` (or yarn equivalent)
+- Run `npm update @rails/actioncable @rails/activestorage` to match Rails version
+```
+
+---
+
+## Step 8: Generate Upgrade Summary
+
+Provide a comprehensive summary including all findings from Steps 1-7:
+
+### Version Information
+- Current version: X.Y.Z
+- Latest version: A.B.C
+- Upgrade type: [Patch/Minor/Major]
+
+### Upgrade Complexity Assessment
+
+Rate the upgrade as **Small**, **Medium**, or **Large** based on:
+
+| Factor | Small | Medium | Large |
+|--------|-------|--------|-------|
+| Version jump | Patch only | Minor version | Major version |
+| Breaking changes | None | Few, well-documented | Many, significant |
+| Config changes | Minimal | Moderate | Extensive |
+| Deprecations | None active | Some to address | Many requiring refactoring |
+| Dependencies | Compatible | Some updates needed | Major dependency updates |
+
+### Key Changes to Address
+
+List the most important changes the user needs to handle:
+1. Configuration file updates
+2. Deprecated methods/features to update
+3. New required dependencies
+4. Database migrations needed
+5. Breaking API changes
+
+### Recommended Upgrade Steps
+
+1. Update test suite and ensure passing
+2. Review deprecation warnings in current version
+3. Update Gemfile with new Rails version
+4. Run `bundle update rails`
+5. Update JavaScript dependencies (see JS Dependencies section)
+6. **DO NOT run `rails app:update` directly** - use the selective merge process below
+7. Run database migrations
+8. Run test suite
+9. Review and update deprecated code
+
+### Resources
+
+- Rails Upgrade Guide: https://guides.rubyonrails.org/upgrading_ruby_on_rails.html
+- Rails Diff: https://railsdiff.org/{current}/{target}
+- Release Notes: https://github.com/rails/rails/releases/tag/v{target}
+
+---
+
+
+## When to Use This Skill
+
+Analyze Rails apps and provide upgrade assessments
+
+Use this skill when working with analyze rails apps and provide upgrade assessments.
+## Step 9: Selective File Update (replaces `rails app:update`)
+
+**IMPORTANT:** Do NOT run `rails app:update` as it overwrites files without considering local customizations. Instead, follow this selective merge process:
+
+### 9.1: Detect Local Customizations
+
+Before any upgrade, identify files with local customizations:
+
+```bash
+# Check for uncommitted changes
+git status
+
+# List config files that differ from a fresh Rails app
+# These are the files we need to be careful with
+git diff HEAD --name-only -- config/ bin/ public/
+```
+
+Create a mental list of files in these categories:
+- **Custom config files**: Files with project-specific settings (i18n, mailer, etc.)
+- **Modified bin scripts**: Scripts with custom behavior (bin/dev with foreman, etc.)
+- **Standard files**: Files that haven't been customized
+
+### 9.2: Analyze Required Changes from Railsdiff
+
+Based on the railsdiff output from Step 6, categorize each changed file:
+
+| Category | Action | Example |
+|----------|--------|---------|
+| **New files** | Create directly | `config/initializers/new_framework_defaults_X_Y.rb` |
+| **Unchanged locally** | Safe to overwrite | `public/404.html` (if not customized) |
+| **Customized locally** | Manual merge needed | `config/application.rb`, `bin/dev` |
+| **Comment-only changes** | Usually skip | Minor comment updates in config files |
+
+### 9.3: Create Upgrade Plan
+
+Present the user with a clear upgrade plan:
+
+```
+## Upgrade Plan: Rails X.Y.Z → A.B.C
+
+### New Files (will be created):
+- config/initializers/new_framework_defaults_A_B.rb
+- bin/ci (new CI script)
+
+### Safe to Update (no local customizations):
+- public/400.html
+- public/404.html
+- public/500.html
+
+### Needs Manual Merge (local customizations detected):
+- config/application.rb
+  └─ Local: i18n configuration
+  └─ Rails: [describe new Rails changes if any]
+
+- config/environments/development.rb
+  └─ Local: letter_opener mailer config
+  └─ Rails: [describe new Rails changes]
+
+- bin/dev
+  └─ Local: foreman + Procfile.dev setup
+  └─ Rails: changed to simple ruby script
+
+### Skip (comment-only or irrelevant changes):
+- config/puma.rb (only comment changes)
+```
+
+### 9.4: Execute Upgrade Plan
+
+After user confirms the plan:
+
+#### For New Files:
+Create them directly using the content from railsdiff or by extracting from a fresh Rails app:
+
+```bash
+# Generate a temporary fresh Rails app to extract new files
+cd /tmp && rails new rails_template --skip-git --skip-bundle
+# Then copy needed files
+```
+
+Or use the Rails generator for specific files:
+```bash
+bin/rails app:update:configs  # Only updates config files, still interactive
+```
+
+#### For Safe Updates:
+Overwrite these files as they have no local customizations.
+
+#### For Manual Merges:
+For each file needing merge, show the user:
+
+1. **Current local version** (their customizations)
+2. **New Rails default** (from railsdiff)
+3. **Suggested merged version** that:
+   - Keeps all local customizations
+   - Adds only essential new Rails functionality
+   - Removes deprecated settings
+
+Example merge for `config/application.rb`:
+```ruby
+# KEEP local customizations:
+config.i18n.available_locales = [:de, :en]
+config.i18n.default_locale = :de
+config.i18n.fallbacks = [:en]
+
+# ADD new Rails 8.1 settings if needed:
+# (usually none required - new defaults come via new_framework_defaults file)
+```
+
+### 9.5: Handle Active Storage Migrations
+
+After file updates, run any new migrations:
+
+```bash
+bin/rails db:migrate
+```
+
+Check for new migrations that were added:
+```bash
+ls -la db/migrate/ | tail -10
+```
+
+### 9.6: Verify Upgrade
+
+After completing the merge:
+
+1. Start the Rails server and check for errors:
+   ```bash
+   bin/dev  # or bin/rails server
+   ```
+
+2. Check the Rails console:
+   ```bash
+   bin/rails console
+   ```
+
+3. Run the test suite:
+   ```bash
+   bin/rails test
+   ```
+
+4. Review deprecation warnings in logs
+
+---
+
+## Step 10: Finalize Framework Defaults
+
+After verifying the app works:
+
+1. Review `config/initializers/new_framework_defaults_X_Y.rb`
+2. Enable each new default one by one, testing after each
+3. Once all defaults are enabled and tested, update `config/application.rb`:
+   ```ruby
+   config.load_defaults X.Y  # Update to new version
+   ```
+4. Delete the `new_framework_defaults_X_Y.rb` file
+
+---
+
+
+## When to Use This Skill
+
+Analyze Rails apps and provide upgrade assessments
+
+Use this skill when working with analyze rails apps and provide upgrade assessments.
+## Error Handling
+
+- If `gh` CLI is not authenticated, instruct the user to run `gh auth login`
+- If railsdiff.org doesn't have the exact versions, try with major.minor.0 versions
+- If the app is already on the latest version, congratulate the user and note any upcoming releases
+- If local customizations would be lost, ALWAYS stop and show the user what would be overwritten before proceeding
+
+## Key Principles
+
+1. **Never overwrite without checking** - Always check for local customizations first
+2. **Preserve user intent** - Local customizations exist for a reason
+3. **Minimal changes** - Only add what's necessary for the new Rails version
+4. **Transparency** - Show the user exactly what will change before doing it
+5. **Reversibility** - User should be able to `git checkout` to restore if needed
diff --git a/.agents/skills/skill-seekers/SKILL.md b/.agents/skills/skill-seekers/SKILL.md
new file mode 100644
index 0000000..c96bab9
--- /dev/null
+++ b/.agents/skills/skill-seekers/SKILL.md
@@ -0,0 +1,22 @@
+---
+name: skill-seekers
+description: "-Automatically convert documentation websites, GitHub repositories, and PDFs into Claude AI skills in minutes."
+source: "https://github.com/yusufkaraaslan/Skill_Seekers"
+risk: safe
+---
+
+# Skill Seekers
+
+## Overview
+
+-Automatically convert documentation websites, GitHub repositories, and PDFs into Claude AI skills in minutes.
+
+## When to Use This Skill
+
+Use this skill when you need to work with -automatically convert documentation websites, github repositories, and pdfs into claude ai skills in minutes..
+
+## Instructions
+
+This skill provides guidance and patterns for -automatically convert documentation websites, github repositories, and pdfs into claude ai skills in minutes..
+
+For more information, see the [source repository](https://github.com/yusufkaraaslan/Skill_Seekers).
diff --git a/.agents/skills/tdd/SKILL.md b/.agents/skills/tdd/SKILL.md
new file mode 100644
index 0000000..7a98941
--- /dev/null
+++ b/.agents/skills/tdd/SKILL.md
@@ -0,0 +1,109 @@
+---
+name: tdd
+description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
+---
+
+# Test-Driven Development
+
+## Philosophy
+
+**Core principle**: Tests should verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't.
+
+**Good tests** are integration-style: they exercise real code paths through public APIs. They describe _what_ the system does, not _how_ it does it. A good test reads like a specification - "user can checkout with valid cart" tells you exactly what capability exists. These tests survive refactors because they don't care about internal structure.
+
+**Bad tests** are coupled to implementation. They mock internal collaborators, test private methods, or verify through external means (like querying a database directly instead of using the interface). The warning sign: your test breaks when you refactor, but behavior hasn't changed. If you rename an internal function and tests fail, those tests were testing implementation, not behavior.
+
+See [tests.md](tests.md) for examples and [mocking.md](mocking.md) for mocking guidelines.
+
+## Anti-Pattern: Horizontal Slices
+
+**DO NOT write all tests first, then all implementation.** This is "horizontal slicing" - treating RED as "write all tests" and GREEN as "write all code."
+
+This produces **crap tests**:
+
+- Tests written in bulk test _imagined_ behavior, not _actual_ behavior
+- You end up testing the _shape_ of things (data structures, function signatures) rather than user-facing behavior
+- Tests become insensitive to real changes - they pass when behavior breaks, fail when behavior is fine
+- You outrun your headlights, committing to test structure before understanding the implementation
+
+**Correct approach**: Vertical slices via tracer bullets. One test → one implementation → repeat. Each test responds to what you learned from the previous cycle. Because you just wrote the code, you know exactly what behavior matters and how to verify it.
+
+```
+WRONG (horizontal):
+  RED:   test1, test2, test3, test4, test5
+  GREEN: impl1, impl2, impl3, impl4, impl5
+
+RIGHT (vertical):
+  RED→GREEN: test1→impl1
+  RED→GREEN: test2→impl2
+  RED→GREEN: test3→impl3
+  ...
+```
+
+## Workflow
+
+### 1. Planning
+
+When exploring the codebase, use the project's domain glossary so that test names and interface vocabulary match the project's language, and respect ADRs in the area you're touching.
+
+Before writing any code:
+
+- [ ] Confirm with user what interface changes are needed
+- [ ] Confirm with user which behaviors to test (prioritize)
+- [ ] Identify opportunities for [deep modules](deep-modules.md) (small interface, deep implementation)
+- [ ] Design interfaces for [testability](interface-design.md)
+- [ ] List the behaviors to test (not implementation steps)
+- [ ] Get user approval on the plan
+
+Ask: "What should the public interface look like? Which behaviors are most important to test?"
+
+**You can't test everything.** Confirm with the user exactly which behaviors matter most. Focus testing effort on critical paths and complex logic, not every possible edge case.
+
+### 2. Tracer Bullet
+
+Write ONE test that confirms ONE thing about the system:
+
+```
+RED:   Write test for first behavior → test fails
+GREEN: Write minimal code to pass → test passes
+```
+
+This is your tracer bullet - proves the path works end-to-end.
+
+### 3. Incremental Loop
+
+For each remaining behavior:
+
+```
+RED:   Write next test → fails
+GREEN: Minimal code to pass → passes
+```
+
+Rules:
+
+- One test at a time
+- Only enough code to pass current test
+- Don't anticipate future tests
+- Keep tests focused on observable behavior
+
+### 4. Refactor
+
+After all tests pass, look for [refactor candidates](refactoring.md):
+
+- [ ] Extract duplication
+- [ ] Deepen modules (move complexity behind simple interfaces)
+- [ ] Apply SOLID principles where natural
+- [ ] Consider what new code reveals about existing code
+- [ ] Run tests after each refactor step
+
+**Never refactor while RED.** Get to GREEN first.
+
+## Checklist Per Cycle
+
+```
+[ ] Test describes behavior, not implementation
+[ ] Test uses public interface only
+[ ] Test would survive internal refactor
+[ ] Code is minimal for this test
+[ ] No speculative features added
+```
diff --git a/.agents/skills/tdd/deep-modules.md b/.agents/skills/tdd/deep-modules.md
new file mode 100644
index 0000000..0d9720c
--- /dev/null
+++ b/.agents/skills/tdd/deep-modules.md
@@ -0,0 +1,33 @@
+# Deep Modules
+
+From "A Philosophy of Software Design":
+
+**Deep module** = small interface + lots of implementation
+
+```
+┌─────────────────────┐
+│   Small Interface   │  ← Few methods, simple params
+├─────────────────────┤
+│                     │
+│                     │
+│  Deep Implementation│  ← Complex logic hidden
+│                     │
+│                     │
+└─────────────────────┘
+```
+
+**Shallow module** = large interface + little implementation (avoid)
+
+```
+┌─────────────────────────────────┐
+│       Large Interface           │  ← Many methods, complex params
+├─────────────────────────────────┤
+│  Thin Implementation            │  ← Just passes through
+└─────────────────────────────────┘
+```
+
+When designing interfaces, ask:
+
+- Can I reduce the number of methods?
+- Can I simplify the parameters?
+- Can I hide more complexity inside?
diff --git a/.agents/skills/tdd/interface-design.md b/.agents/skills/tdd/interface-design.md
new file mode 100644
index 0000000..a0a20ca
--- /dev/null
+++ b/.agents/skills/tdd/interface-design.md
@@ -0,0 +1,31 @@
+# Interface Design for Testability
+
+Good interfaces make testing natural:
+
+1. **Accept dependencies, don't create them**
+
+   ```typescript
+   // Testable
+   function processOrder(order, paymentGateway) {}
+
+   // Hard to test
+   function processOrder(order) {
+     const gateway = new StripeGateway();
+   }
+   ```
+
+2. **Return results, don't produce side effects**
+
+   ```typescript
+   // Testable
+   function calculateDiscount(cart): Discount {}
+
+   // Hard to test
+   function applyDiscount(cart): void {
+     cart.total -= discount;
+   }
+   ```
+
+3. **Small surface area**
+   - Fewer methods = fewer tests needed
+   - Fewer params = simpler test setup
diff --git a/.agents/skills/tdd/mocking.md b/.agents/skills/tdd/mocking.md
new file mode 100644
index 0000000..71cbfee
--- /dev/null
+++ b/.agents/skills/tdd/mocking.md
@@ -0,0 +1,59 @@
+# When to Mock
+
+Mock at **system boundaries** only:
+
+- External APIs (payment, email, etc.)
+- Databases (sometimes - prefer test DB)
+- Time/randomness
+- File system (sometimes)
+
+Don't mock:
+
+- Your own classes/modules
+- Internal collaborators
+- Anything you control
+
+## Designing for Mockability
+
+At system boundaries, design interfaces that are easy to mock:
+
+**1. Use dependency injection**
+
+Pass external dependencies in rather than creating them internally:
+
+```typescript
+// Easy to mock
+function processPayment(order, paymentClient) {
+  return paymentClient.charge(order.total);
+}
+
+// Hard to mock
+function processPayment(order) {
+  const client = new StripeClient(process.env.STRIPE_KEY);
+  return client.charge(order.total);
+}
+```
+
+**2. Prefer SDK-style interfaces over generic fetchers**
+
+Create specific functions for each external operation instead of one generic function with conditional logic:
+
+```typescript
+// GOOD: Each function is independently mockable
+const api = {
+  getUser: (id) => fetch(`/users/${id}`),
+  getOrders: (userId) => fetch(`/users/${userId}/orders`),
+  createOrder: (data) => fetch('/orders', { method: 'POST', body: data }),
+};
+
+// BAD: Mocking requires conditional logic inside the mock
+const api = {
+  fetch: (endpoint, options) => fetch(endpoint, options),
+};
+```
+
+The SDK approach means:
+- Each mock returns one specific shape
+- No conditional logic in test setup
+- Easier to see which endpoints a test exercises
+- Type safety per endpoint
diff --git a/.agents/skills/tdd/refactoring.md b/.agents/skills/tdd/refactoring.md
new file mode 100644
index 0000000..8a44439
--- /dev/null
+++ b/.agents/skills/tdd/refactoring.md
@@ -0,0 +1,10 @@
+# Refactor Candidates
+
+After TDD cycle, look for:
+
+- **Duplication** → Extract function/class
+- **Long methods** → Break into private helpers (keep tests on public interface)
+- **Shallow modules** → Combine or deepen
+- **Feature envy** → Move logic to where data lives
+- **Primitive obsession** → Introduce value objects
+- **Existing code** the new code reveals as problematic
diff --git a/.agents/skills/tdd/tests.md b/.agents/skills/tdd/tests.md
new file mode 100644
index 0000000..ff22f80
--- /dev/null
+++ b/.agents/skills/tdd/tests.md
@@ -0,0 +1,61 @@
+# Good and Bad Tests
+
+## Good Tests
+
+**Integration-style**: Test through real interfaces, not mocks of internal parts.
+
+```typescript
+// GOOD: Tests observable behavior
+test("user can checkout with valid cart", async () => {
+  const cart = createCart();
+  cart.add(product);
+  const result = await checkout(cart, paymentMethod);
+  expect(result.status).toBe("confirmed");
+});
+```
+
+Characteristics:
+
+- Tests behavior users/callers care about
+- Uses public API only
+- Survives internal refactors
+- Describes WHAT, not HOW
+- One logical assertion per test
+
+## Bad Tests
+
+**Implementation-detail tests**: Coupled to internal structure.
+
+```typescript
+// BAD: Tests implementation details
+test("checkout calls paymentService.process", async () => {
+  const mockPayment = jest.mock(paymentService);
+  await checkout(cart, payment);
+  expect(mockPayment.process).toHaveBeenCalledWith(cart.total);
+});
+```
+
+Red flags:
+
+- Mocking internal collaborators
+- Testing private methods
+- Asserting on call counts/order
+- Test breaks when refactoring without behavior change
+- Test name describes HOW not WHAT
+- Verifying through external means instead of interface
+
+```typescript
+// BAD: Bypasses interface to verify
+test("createUser saves to database", async () => {
+  await createUser({ name: "Alice" });
+  const row = await db.query("SELECT * FROM users WHERE name = ?", ["Alice"]);
+  expect(row).toBeDefined();
+});
+
+// GOOD: Verifies through interface
+test("createUser makes user retrievable", async () => {
+  const user = await createUser({ name: "Alice" });
+  const retrieved = await getUser(user.id);
+  expect(retrieved.name).toBe("Alice");
+});
+```
diff --git a/.agents/skills/to-issues/SKILL.md b/.agents/skills/to-issues/SKILL.md
new file mode 100644
index 0000000..9f6efbf
--- /dev/null
+++ b/.agents/skills/to-issues/SKILL.md
@@ -0,0 +1,83 @@
+---
+name: to-issues
+description: Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
+---
+
+# To Issues
+
+Break a plan into independently-grabbable issues using vertical slices (tracer bullets).
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+### 1. Gather context
+
+Work from whatever is already in the conversation context. If the user passes an issue reference (issue number, URL, or path) as an argument, fetch it from the issue tracker and read its full body and comments.
+
+### 2. Explore the codebase (optional)
+
+If you have not already explored the codebase, do so to understand the current state of the code. Issue titles and descriptions should use the project's domain glossary vocabulary, and respect ADRs in the area you're touching.
+
+### 3. Draft vertical slices
+
+Break the plan into **tracer bullet** issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer.
+
+Slices may be 'HITL' or 'AFK'. HITL slices require human interaction, such as an architectural decision or a design review. AFK slices can be implemented and merged without human interaction. Prefer AFK over HITL where possible.
+
+<vertical-slice-rules>
+- Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests)
+- A completed slice is demoable or verifiable on its own
+- Prefer many thin slices over few thick ones
+</vertical-slice-rules>
+
+### 4. Quiz the user
+
+Present the proposed breakdown as a numbered list. For each slice, show:
+
+- **Title**: short descriptive name
+- **Type**: HITL / AFK
+- **Blocked by**: which other slices (if any) must complete first
+- **User stories covered**: which user stories this addresses (if the source material has them)
+
+Ask the user:
+
+- Does the granularity feel right? (too coarse / too fine)
+- Are the dependency relationships correct?
+- Should any slices be merged or split further?
+- Are the correct slices marked as HITL and AFK?
+
+Iterate until the user approves the breakdown.
+
+### 5. Publish the issues to the issue tracker
+
+For each approved slice, publish a new issue to the issue tracker. Use the issue body template below. These issues are considered ready for AFK agents, so publish them with the correct triage label unless instructed otherwise.
+
+Publish issues in dependency order (blockers first) so you can reference real issue identifiers in the "Blocked by" field.
+
+<issue-template>
+## Parent
+
+A reference to the parent issue on the issue tracker (if the source was an existing issue, otherwise omit this section).
+
+## What to build
+
+A concise description of this vertical slice. Describe the end-to-end behavior, not layer-by-layer implementation.
+
+Avoid specific file paths or code snippets — they go stale fast. Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it here and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Acceptance criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Blocked by
+
+- A reference to the blocking ticket (if any)
+
+Or "None - can start immediately" if no blockers.
+
+</issue-template>
+
+Do NOT close or modify any parent issue.
diff --git a/.agents/skills/to-prd/SKILL.md b/.agents/skills/to-prd/SKILL.md
new file mode 100644
index 0000000..47a01d4
--- /dev/null
+++ b/.agents/skills/to-prd/SKILL.md
@@ -0,0 +1,76 @@
+---
+name: to-prd
+description: Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
+---
+
+This skill takes the current conversation context and codebase understanding and produces a PRD. Do NOT interview the user — just synthesize what you already know.
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+1. Explore the repo to understand the current state of the codebase, if you haven't already. Use the project's domain glossary vocabulary throughout the PRD, and respect any ADRs in the area you're touching.
+
+2. Sketch out the major modules you will need to build or modify to complete the implementation. Actively look for opportunities to extract deep modules that can be tested in isolation.
+
+A deep module (as opposed to a shallow module) is one which encapsulates a lot of functionality in a simple, testable interface which rarely changes.
+
+Check with the user that these modules match their expectations. Check with the user which modules they want tests written for.
+
+3. Write the PRD using the template below, then publish it to the project issue tracker. Apply the `ready-for-agent` triage label - no need for additional triage.
+
+<prd-template>
+
+## Problem Statement
+
+The problem that the user is facing, from the user's perspective.
+
+## Solution
+
+The solution to the problem, from the user's perspective.
+
+## User Stories
+
+A LONG, numbered list of user stories. Each user story should be in the format of:
+
+1. As an <actor>, I want a <feature>, so that <benefit>
+
+<user-story-example>
+1. As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending
+</user-story-example>
+
+This list of user stories should be extremely extensive and cover all aspects of the feature.
+
+## Implementation Decisions
+
+A list of implementation decisions that were made. This can include:
+
+- The modules that will be built/modified
+- The interfaces of those modules that will be modified
+- Technical clarifications from the developer
+- Architectural decisions
+- Schema changes
+- API contracts
+- Specific interactions
+
+Do NOT include specific file paths or code snippets. They may end up being outdated very quickly.
+
+Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it within the relevant decision and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Testing Decisions
+
+A list of testing decisions that were made. Include:
+
+- A description of what makes a good test (only test external behavior, not implementation details)
+- Which modules will be tested
+- Prior art for the tests (i.e. similar types of tests in the codebase)
+
+## Out of Scope
+
+A description of the things that are out of scope for this PRD.
+
+## Further Notes
+
+Any further notes about the feature.
+
+</prd-template>
diff --git a/.agents/skills/triage/AGENT-BRIEF.md b/.agents/skills/triage/AGENT-BRIEF.md
new file mode 100644
index 0000000..2efecdf
--- /dev/null
+++ b/.agents/skills/triage/AGENT-BRIEF.md
@@ -0,0 +1,168 @@
+# Writing Agent Briefs
+
+An agent brief is a structured comment posted on a GitHub issue when it moves to `ready-for-agent`. It is the authoritative specification that an AFK agent will work from. The original issue body and discussion are context — the agent brief is the contract.
+
+## Principles
+
+### Durability over precision
+
+The issue may sit in `ready-for-agent` for days or weeks. The codebase will change in the meantime. Write the brief so it stays useful even as files are renamed, moved, or refactored.
+
+- **Do** describe interfaces, types, and behavioral contracts
+- **Do** name specific types, function signatures, or config shapes that the agent should look for or modify
+- **Don't** reference file paths — they go stale
+- **Don't** reference line numbers
+- **Don't** assume the current implementation structure will remain the same
+
+### Behavioral, not procedural
+
+Describe **what** the system should do, not **how** to implement it. The agent will explore the codebase fresh and make its own implementation decisions.
+
+- **Good:** "The `SkillConfig` type should accept an optional `schedule` field of type `CronExpression`"
+- **Bad:** "Open src/types/skill.ts and add a schedule field on line 42"
+- **Good:** "When a user runs `/triage` with no arguments, they should see a summary of issues needing attention"
+- **Bad:** "Add a switch statement in the main handler function"
+
+### Complete acceptance criteria
+
+The agent needs to know when it's done. Every agent brief must have concrete, testable acceptance criteria. Each criterion should be independently verifiable.
+
+- **Good:** "Running `gh issue list --label needs-triage` returns issues that have been through initial classification"
+- **Bad:** "Triage should work correctly"
+
+### Explicit scope boundaries
+
+State what is out of scope. This prevents the agent from gold-plating or making assumptions about adjacent features.
+
+## Template
+
+```markdown
+## Agent Brief
+
+**Category:** bug / enhancement
+**Summary:** one-line description of what needs to happen
+
+**Current behavior:**
+Describe what happens now. For bugs, this is the broken behavior.
+For enhancements, this is the status quo the feature builds on.
+
+**Desired behavior:**
+Describe what should happen after the agent's work is complete.
+Be specific about edge cases and error conditions.
+
+**Key interfaces:**
+- `TypeName` — what needs to change and why
+- `functionName()` return type — what it currently returns vs what it should return
+- Config shape — any new configuration options needed
+
+**Acceptance criteria:**
+- [ ] Specific, testable criterion 1
+- [ ] Specific, testable criterion 2
+- [ ] Specific, testable criterion 3
+
+**Out of scope:**
+- Thing that should NOT be changed or addressed in this issue
+- Adjacent feature that might seem related but is separate
+```
+
+## Examples
+
+### Good agent brief (bug)
+
+```markdown
+## Agent Brief
+
+**Category:** bug
+**Summary:** Skill description truncation drops mid-word, producing broken output
+
+**Current behavior:**
+When a skill description exceeds 1024 characters, it is truncated at exactly
+1024 characters regardless of word boundaries. This produces descriptions
+that end mid-word (e.g. "Use when the user wants to confi").
+
+**Desired behavior:**
+Truncation should break at the last word boundary before 1024 characters
+and append "..." to indicate truncation.
+
+**Key interfaces:**
+- The `SkillMetadata` type's `description` field — no type change needed,
+  but the validation/processing logic that populates it needs to respect
+  word boundaries
+- Any function that reads SKILL.md frontmatter and extracts the description
+
+**Acceptance criteria:**
+- [ ] Descriptions under 1024 chars are unchanged
+- [ ] Descriptions over 1024 chars are truncated at the last word boundary
+      before 1024 chars
+- [ ] Truncated descriptions end with "..."
+- [ ] The total length including "..." does not exceed 1024 chars
+
+**Out of scope:**
+- Changing the 1024 char limit itself
+- Multi-line description support
+```
+
+### Good agent brief (enhancement)
+
+```markdown
+## Agent Brief
+
+**Category:** enhancement
+**Summary:** Add `.out-of-scope/` directory support for tracking rejected feature requests
+
+**Current behavior:**
+When a feature request is rejected, the issue is closed with a `wontfix` label
+and a comment. There is no persistent record of the decision or reasoning.
+Future similar requests require the maintainer to recall or search for the
+prior discussion.
+
+**Desired behavior:**
+Rejected feature requests should be documented in `.out-of-scope/<concept>.md`
+files that capture the decision, reasoning, and links to all issues that
+requested the feature. When triaging new issues, these files should be
+checked for matches.
+
+**Key interfaces:**
+- Markdown file format in `.out-of-scope/` — each file should have a
+  `# Concept Name` heading, a `**Decision:**` line, a `**Reason:**` line,
+  and a `**Prior requests:**` list with issue links
+- The triage workflow should read all `.out-of-scope/*.md` files early
+  and match incoming issues against them by concept similarity
+
+**Acceptance criteria:**
+- [ ] Closing a feature as wontfix creates/updates a file in `.out-of-scope/`
+- [ ] The file includes the decision, reasoning, and link to the closed issue
+- [ ] If a matching `.out-of-scope/` file already exists, the new issue is
+      appended to its "Prior requests" list rather than creating a duplicate
+- [ ] During triage, existing `.out-of-scope/` files are checked and surfaced
+      when a new issue matches a prior rejection
+
+**Out of scope:**
+- Automated matching (human confirms the match)
+- Reopening previously rejected features
+- Bug reports (only enhancement rejections go to `.out-of-scope/`)
+```
+
+### Bad agent brief
+
+```markdown
+## Agent Brief
+
+**Summary:** Fix the triage bug
+
+**What to do:**
+The triage thing is broken. Look at the main file and fix it.
+The function around line 150 has the issue.
+
+**Files to change:**
+- src/triage/handler.ts (line 150)
+- src/types.ts (line 42)
+```
+
+This is bad because:
+- No category
+- Vague description ("the triage thing is broken")
+- References file paths and line numbers that will go stale
+- No acceptance criteria
+- No scope boundaries
+- No description of current vs desired behavior
diff --git a/.agents/skills/triage/OUT-OF-SCOPE.md b/.agents/skills/triage/OUT-OF-SCOPE.md
new file mode 100644
index 0000000..cc8ea25
--- /dev/null
+++ b/.agents/skills/triage/OUT-OF-SCOPE.md
@@ -0,0 +1,101 @@
+# Out-of-Scope Knowledge Base
+
+The `.out-of-scope/` directory in a repo stores persistent records of rejected feature requests. It serves two purposes:
+
+1. **Institutional memory** — why a feature was rejected, so the reasoning isn't lost when the issue is closed
+2. **Deduplication** — when a new issue comes in that matches a prior rejection, the skill can surface the previous decision instead of re-litigating it
+
+## Directory structure
+
+```
+.out-of-scope/
+├── dark-mode.md
+├── plugin-system.md
+└── graphql-api.md
+```
+
+One file per **concept**, not per issue. Multiple issues requesting the same thing are grouped under one file.
+
+## File format
+
+The file should be written in a relaxed, readable style — more like a short design document than a database entry. Use paragraphs, code samples, and examples to make the reasoning clear and useful to someone encountering it for the first time.
+
+```markdown
+# Dark Mode
+
+This project does not support dark mode or user-facing theming.
+
+## Why this is out of scope
+
+The rendering pipeline assumes a single color palette defined in
+`ThemeConfig`. Supporting multiple themes would require:
+
+- A theme context provider wrapping the entire component tree
+- Per-component theme-aware style resolution
+- A persistence layer for user theme preferences
+
+This is a significant architectural change that doesn't align with the
+project's focus on content authoring. Theming is a concern for downstream
+consumers who embed or redistribute the output.
+
+```ts
+// The current ThemeConfig interface is not designed for runtime switching:
+interface ThemeConfig {
+  colors: ColorPalette; // single palette, resolved at build time
+  fonts: FontStack;
+}
+```
+
+## Prior requests
+
+- #42 — "Add dark mode support"
+- #87 — "Night theme for accessibility"
+- #134 — "Dark theme option"
+```
+
+### Naming the file
+
+Use a short, descriptive kebab-case name for the concept: `dark-mode.md`, `plugin-system.md`, `graphql-api.md`. The name should be recognizable enough that someone browsing the directory understands what was rejected without opening the file.
+
+### Writing the reason
+
+The reason should be substantive — not "we don't want this" but why. Good reasons reference:
+
+- Project scope or philosophy ("This project focuses on X; theming is a downstream concern")
+- Technical constraints ("Supporting this would require Y, which conflicts with our Z architecture")
+- Strategic decisions ("We chose to use A instead of B because...")
+
+The reason should be durable. Avoid referencing temporary circumstances ("we're too busy right now") — those aren't real rejections, they're deferrals.
+
+## When to check `.out-of-scope/`
+
+During triage (Step 1: Gather context), read all files in `.out-of-scope/`. When evaluating a new issue:
+
+- Check if the request matches an existing out-of-scope concept
+- Matching is by concept similarity, not keyword — "night theme" matches `dark-mode.md`
+- If there's a match, surface it to the maintainer: "This is similar to `.out-of-scope/dark-mode.md` — we rejected this before because [reason]. Do you still feel the same way?"
+
+The maintainer may:
+
+- **Confirm** — the new issue gets added to the existing file's "Prior requests" list, then closed
+- **Reconsider** — the out-of-scope file gets deleted or updated, and the issue proceeds through normal triage
+- **Disagree** — the issues are related but distinct, proceed with normal triage
+
+## When to write to `.out-of-scope/`
+
+Only when an **enhancement** (not a bug) is rejected as `wontfix`. The flow:
+
+1. Maintainer decides a feature request is out of scope
+2. Check if a matching `.out-of-scope/` file already exists
+3. If yes: append the new issue to the "Prior requests" list
+4. If no: create a new file with the concept name, decision, reason, and first prior request
+5. Post a comment on the issue explaining the decision and mentioning the `.out-of-scope/` file
+6. Close the issue with the `wontfix` label
+
+## Updating or removing out-of-scope files
+
+If the maintainer changes their mind about a previously rejected concept:
+
+- Delete the `.out-of-scope/` file
+- The skill does not need to reopen old issues — they're historical records
+- The new issue that triggered the reconsideration proceeds through normal triage
diff --git a/.agents/skills/triage/SKILL.md b/.agents/skills/triage/SKILL.md
new file mode 100644
index 0000000..3dee68f
--- /dev/null
+++ b/.agents/skills/triage/SKILL.md
@@ -0,0 +1,103 @@
+---
+name: triage
+description: Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
+---
+
+# Triage
+
+Move issues on the project issue tracker through a small state machine of triage roles.
+
+Every comment or issue posted to the issue tracker during triage **must** start with this disclaimer:
+
+```
+> *This was generated by AI during triage.*
+```
+
+## Reference docs
+
+- [AGENT-BRIEF.md](AGENT-BRIEF.md) — how to write durable agent briefs
+- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — how the `.out-of-scope/` knowledge base works
+
+## Roles
+
+Two **category** roles:
+
+- `bug` — something is broken
+- `enhancement` — new feature or improvement
+
+Five **state** roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter for more information
+- `ready-for-agent` — fully specified, ready for an AFK agent
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Every triaged issue should carry exactly one category role and one state role. If state roles conflict, flag it and ask the maintainer before doing anything else.
+
+These are canonical role names — the actual label strings used in the issue tracker may differ. The mapping should have been provided to you - run `/setup-matt-pocock-skills` if not.
+
+State transitions: an unlabeled issue normally goes to `needs-triage` first; from there it moves to `needs-info`, `ready-for-agent`, `ready-for-human`, or `wontfix`. `needs-info` returns to `needs-triage` once the reporter replies. The maintainer can override at any time — flag transitions that look unusual and ask before proceeding.
+
+## Invocation
+
+The maintainer invokes `/triage` and describes what they want in natural language. Interpret the request and act. Examples:
+
+- "Show me anything that needs my attention"
+- "Let's look at #42"
+- "Move #42 to ready-for-agent"
+- "What's ready for agents to pick up?"
+
+## Show what needs attention
+
+Query the issue tracker and present three buckets, oldest first:
+
+1. **Unlabeled** — never triaged.
+2. **`needs-triage`** — evaluation in progress.
+3. **`needs-info` with reporter activity since the last triage notes** — needs re-evaluation.
+
+Show counts and a one-line summary per issue. Let the maintainer pick.
+
+## Triage a specific issue
+
+1. **Gather context.** Read the full issue (body, comments, labels, reporter, dates). Parse any prior triage notes so you don't re-ask resolved questions. Explore the codebase using the project's domain glossary, respecting ADRs in the area. Read `.out-of-scope/*.md` and surface any prior rejection that resembles this issue.
+
+2. **Recommend.** Tell the maintainer your category and state recommendation with reasoning, plus a brief codebase summary relevant to the issue. Wait for direction.
+
+3. **Reproduce (bugs only).** Before any grilling, attempt reproduction: read the reporter's steps, trace the relevant code, run tests or commands. Report what happened — successful repro with code path, failed repro, or insufficient detail (a strong `needs-info` signal). A confirmed repro makes a much stronger agent brief.
+
+4. **Grill (if needed).** If the issue needs fleshing out, run a `/grill-with-docs` session.
+
+5. **Apply the outcome:**
+   - `ready-for-agent` — post an agent brief comment ([AGENT-BRIEF.md](AGENT-BRIEF.md)).
+   - `ready-for-human` — same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing).
+   - `needs-info` — post triage notes (template below).
+   - `wontfix` (bug) — polite explanation, then close.
+   - `wontfix` (enhancement) — write to `.out-of-scope/`, link to it from a comment, then close ([OUT-OF-SCOPE.md](OUT-OF-SCOPE.md)).
+   - `needs-triage` — apply the role. Optional comment if there's partial progress.
+
+## Quick state override
+
+If the maintainer says "move #42 to ready-for-agent", trust them and apply the role directly. Confirm what you're about to do (role changes, comment, close), then act. Skip grilling. If moving to `ready-for-agent` without a grilling session, ask whether they want to write an agent brief.
+
+## Needs-info template
+
+```markdown
+## Triage Notes
+
+**What we've established so far:**
+
+- point 1
+- point 2
+
+**What we still need from you (@reporter):**
+
+- question 1
+- question 2
+```
+
+Capture everything resolved during grilling under "established so far" so the work isn't lost. Questions must be specific and actionable, not "please provide more info".
+
+## Resuming a previous session
+
+If prior triage notes exist on the issue, read them, check whether the reporter has answered any outstanding questions, and present an updated picture before continuing. Don't re-ask resolved questions.
diff --git a/.agents/skills/ui-skills/SKILL.md b/.agents/skills/ui-skills/SKILL.md
new file mode 100644
index 0000000..d4dac09
--- /dev/null
+++ b/.agents/skills/ui-skills/SKILL.md
@@ -0,0 +1,22 @@
+---
+name: ui-skills
+description: "Opinionated, evolving constraints to guide agents when building interfaces"
+source: "https://github.com/ibelick/ui-skills"
+risk: safe
+---
+
+# Ui Skills
+
+## Overview
+
+Opinionated, evolving constraints to guide agents when building interfaces
+
+## When to Use This Skill
+
+Use this skill when you need to work with opinionated, evolving constraints to guide agents when building interfaces.
+
+## Instructions
+
+This skill provides guidance and patterns for opinionated, evolving constraints to guide agents when building interfaces.
+
+For more information, see the [source repository](https://github.com/ibelick/ui-skills).
diff --git a/.agents/skills/ui-ux-designer/SKILL.md b/.agents/skills/ui-ux-designer/SKILL.md
new file mode 100644
index 0000000..c251529
--- /dev/null
+++ b/.agents/skills/ui-ux-designer/SKILL.md
@@ -0,0 +1,209 @@
+---
+name: ui-ux-designer
+description: Create interface designs, wireframes, and design systems. Masters
+  user research, accessibility standards, and modern design tools. Specializes
+  in design tokens, component libraries, and inclusive design. Use PROACTIVELY
+  for design systems, user flows, or interface optimization.
+metadata:
+  model: sonnet
+---
+
+## Use this skill when
+
+- Working on ui ux designer tasks or workflows
+- Needing guidance, best practices, or checklists for ui ux designer
+
+## Do not use this skill when
+
+- The task is unrelated to ui ux designer
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a UI/UX design expert specializing in user-centered design, modern design systems, and accessible interface creation.
+
+## Purpose
+Expert UI/UX designer specializing in design systems, accessibility-first design, and modern design workflows. Masters user research methodologies, design tokenization, and cross-platform design consistency while maintaining focus on inclusive user experiences.
+
+## Capabilities
+
+### Design Systems Mastery
+- Atomic design methodology with token-based architecture
+- Design token creation and management (Figma Variables, Style Dictionary)
+- Component library design with comprehensive documentation
+- Multi-brand design system architecture and scaling
+- Design system governance and maintenance workflows
+- Version control for design systems with branching strategies
+- Design-to-development handoff optimization
+- Cross-platform design system adaptation (web, mobile, desktop)
+
+### Modern Design Tools & Workflows
+- Figma advanced features (Auto Layout, Variants, Components, Variables)
+- Figma plugin development for workflow optimization
+- Design system integration with development tools (Storybook, Chromatic)
+- Collaborative design workflows and real-time team coordination
+- Design version control and branching strategies
+- Prototyping with advanced interactions and micro-animations
+- Design handoff tools and developer collaboration
+- Asset generation and optimization for multiple platforms
+
+### User Research & Analysis
+- Quantitative and qualitative research methodologies
+- User interview planning, execution, and analysis
+- Usability testing design and moderation
+- A/B testing design and statistical analysis
+- User journey mapping and experience flow optimization
+- Persona development based on research data
+- Card sorting and information architecture validation
+- Analytics integration and user behavior analysis
+
+### Accessibility & Inclusive Design
+- WCAG 2.1/2.2 AA and AAA compliance implementation
+- Accessibility audit methodologies and remediation strategies
+- Color contrast analysis and accessible color palette creation
+- Screen reader optimization and semantic markup planning
+- Keyboard navigation and focus management design
+- Cognitive accessibility and plain language principles
+- Inclusive design patterns for diverse user needs
+- Accessibility testing integration into design workflows
+
+### Information Architecture & UX Strategy
+- Site mapping and navigation hierarchy optimization
+- Content strategy and content modeling
+- User flow design and conversion optimization
+- Mental model alignment and cognitive load reduction
+- Task analysis and user goal identification
+- Information hierarchy and progressive disclosure
+- Search and findability optimization
+- Cross-platform information consistency
+
+### Visual Design & Brand Systems
+- Typography systems and vertical rhythm establishment
+- Color theory application and systematic palette creation
+- Layout principles and grid system design
+- Iconography design and systematic icon libraries
+- Brand identity integration and visual consistency
+- Design trend analysis and timeless design principles
+- Visual hierarchy and attention management
+- Responsive design principles and breakpoint strategy
+
+### Interaction Design & Prototyping
+- Micro-interaction design and animation principles
+- State management and feedback design
+- Error handling and empty state design
+- Loading states and progressive enhancement
+- Gesture design for touch interfaces
+- Voice UI and conversational interface design
+- AR/VR interface design principles
+- Cross-device interaction consistency
+
+### Design Research & Validation
+- Design sprint facilitation and workshop moderation
+- Stakeholder alignment and requirement gathering
+- Competitive analysis and market research
+- Design validation methodologies and success metrics
+- Post-launch analysis and iterative improvement
+- User feedback collection and analysis systems
+- Design impact measurement and ROI calculation
+- Continuous discovery and learning integration
+
+### Cross-Platform Design Excellence
+- Responsive web design and mobile-first approaches
+- Native mobile app design (iOS Human Interface Guidelines, Material Design)
+- Progressive Web App (PWA) design considerations
+- Desktop application design patterns
+- Wearable interface design principles
+- Smart TV and connected device interfaces
+- Email design and multi-client compatibility
+- Print design integration and brand consistency
+
+### Design System Implementation
+- Component documentation and usage guidelines
+- Design token naming conventions and hierarchies
+- Multi-theme support and dark mode implementation
+- Internationalization and localization considerations
+- Performance implications of design decisions
+- Design system analytics and adoption tracking
+- Training and onboarding materials creation
+- Design system community building and feedback loops
+
+### Advanced Design Techniques
+- Design system automation and code generation
+- Dynamic content design and personalization strategies
+- Data visualization and dashboard design
+- E-commerce and conversion optimization design
+- Content management system integration
+- SEO-friendly design patterns
+- Performance-optimized design decisions
+- Design for emerging technologies (AI, ML, IoT)
+
+### Collaboration & Communication
+- Design presentation and storytelling techniques
+- Cross-functional team collaboration strategies
+- Design critique facilitation and feedback integration
+- Client communication and expectation management
+- Design documentation and specification creation
+- Workshop facilitation and ideation techniques
+- Design thinking process implementation
+- Change management and design adoption strategies
+
+### Design Technology Integration
+- Design system integration with CI/CD pipelines
+- Automated design testing and quality assurance
+- Design API integration and dynamic content handling
+- Performance monitoring for design decisions
+- Analytics integration for design validation
+- Accessibility testing automation
+- Design system versioning and release management
+- Developer handoff automation and optimization
+
+## Behavioral Traits
+- Prioritizes user needs and accessibility in all design decisions
+- Creates systematic, scalable design solutions over one-off designs
+- Validates design decisions with research and testing data
+- Maintains consistency across all platforms and touchpoints
+- Documents design decisions and rationale comprehensively
+- Collaborates effectively with developers and stakeholders
+- Stays current with design trends while focusing on timeless principles
+- Advocates for inclusive design and diverse user representation
+- Measures and iterates on design performance continuously
+- Balances business goals with user needs ethically
+
+## Knowledge Base
+- Design system best practices and industry standards
+- Accessibility guidelines and assistive technology compatibility
+- Modern design tools and workflow optimization
+- User research methodologies and behavioral psychology
+- Cross-platform design patterns and native conventions
+- Performance implications of design decisions
+- Design token standards and implementation strategies
+- Inclusive design principles and diverse user needs
+- Design team scaling and organizational design maturity
+- Emerging design technologies and future trends
+
+## Response Approach
+1. **Research user needs** and validate assumptions with data
+2. **Design systematically** with tokens and reusable components
+3. **Prioritize accessibility** and inclusive design from concept stage
+4. **Document design decisions** with clear rationale and guidelines
+5. **Collaborate with developers** for optimal implementation
+6. **Test and iterate** based on user feedback and analytics
+7. **Maintain consistency** across all platforms and touchpoints
+8. **Measure design impact** and optimize for continuous improvement
+
+## Example Interactions
+- "Design a comprehensive design system with accessibility-first components"
+- "Create user research plan for a complex B2B software redesign"
+- "Optimize conversion flow with A/B testing and user journey analysis"
+- "Develop inclusive design patterns for users with cognitive disabilities"
+- "Design cross-platform mobile app following platform-specific guidelines"
+- "Create design token architecture for multi-brand product suite"
+- "Conduct accessibility audit and remediation strategy for existing product"
+- "Design data visualization dashboard with progressive disclosure"
+
+Focus on user-centered, accessible design solutions with comprehensive documentation and systematic thinking. Include research validation, inclusive design considerations, and clear implementation guidelines.
diff --git a/.agents/skills/ui-ux-pro-max/SKILL.md b/.agents/skills/ui-ux-pro-max/SKILL.md
new file mode 100644
index 0000000..0c39a41
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/SKILL.md
@@ -0,0 +1,351 @@
+---
+name: ui-ux-pro-max
+description: "UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples."
+---
+
+# UI/UX Pro Max - Design Intelligence
+
+Comprehensive design guide for web and mobile applications. Contains 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 9 technology stacks. Searchable database with priority-based recommendations.
+
+## When to Apply
+
+Reference these guidelines when:
+- Designing new UI components or pages
+- Choosing color palettes and typography
+- Reviewing code for UX issues
+- Building landing pages or dashboards
+- Implementing accessibility requirements
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Domain |
+|----------|----------|--------|--------|
+| 1 | Accessibility | CRITICAL | `ux` |
+| 2 | Touch & Interaction | CRITICAL | `ux` |
+| 3 | Performance | HIGH | `ux` |
+| 4 | Layout & Responsive | HIGH | `ux` |
+| 5 | Typography & Color | MEDIUM | `typography`, `color` |
+| 6 | Animation | MEDIUM | `ux` |
+| 7 | Style Selection | MEDIUM | `style`, `product` |
+| 8 | Charts & Data | LOW | `chart` |
+
+## Quick Reference
+
+### 1. Accessibility (CRITICAL)
+
+- `color-contrast` - Minimum 4.5:1 ratio for normal text
+- `focus-states` - Visible focus rings on interactive elements
+- `alt-text` - Descriptive alt text for meaningful images
+- `aria-labels` - aria-label for icon-only buttons
+- `keyboard-nav` - Tab order matches visual order
+- `form-labels` - Use label with for attribute
+
+### 2. Touch & Interaction (CRITICAL)
+
+- `touch-target-size` - Minimum 44x44px touch targets
+- `hover-vs-tap` - Use click/tap for primary interactions
+- `loading-buttons` - Disable button during async operations
+- `error-feedback` - Clear error messages near problem
+- `cursor-pointer` - Add cursor-pointer to clickable elements
+
+### 3. Performance (HIGH)
+
+- `image-optimization` - Use WebP, srcset, lazy loading
+- `reduced-motion` - Check prefers-reduced-motion
+- `content-jumping` - Reserve space for async content
+
+### 4. Layout & Responsive (HIGH)
+
+- `viewport-meta` - width=device-width initial-scale=1
+- `readable-font-size` - Minimum 16px body text on mobile
+- `horizontal-scroll` - Ensure content fits viewport width
+- `z-index-management` - Define z-index scale (10, 20, 30, 50)
+
+### 5. Typography & Color (MEDIUM)
+
+- `line-height` - Use 1.5-1.75 for body text
+- `line-length` - Limit to 65-75 characters per line
+- `font-pairing` - Match heading/body font personalities
+
+### 6. Animation (MEDIUM)
+
+- `duration-timing` - Use 150-300ms for micro-interactions
+- `transform-performance` - Use transform/opacity, not width/height
+- `loading-states` - Skeleton screens or spinners
+
+### 7. Style Selection (MEDIUM)
+
+- `style-match` - Match style to product type
+- `consistency` - Use same style across all pages
+- `no-emoji-icons` - Use SVG icons, not emojis
+
+### 8. Charts & Data (LOW)
+
+- `chart-type` - Match chart type to data type
+- `color-guidance` - Use accessible color palettes
+- `data-table` - Provide table alternative for accessibility
+
+## How to Use
+
+Search specific domains using the CLI tool below.
+
+---
+
+## Prerequisites
+
+Check if Python is installed:
+
+```bash
+python3 --version || python --version
+```
+
+If Python is not installed, install it based on user's OS:
+
+**macOS:**
+```bash
+brew install python3
+```
+
+**Ubuntu/Debian:**
+```bash
+sudo apt update && sudo apt install python3
+```
+
+**Windows:**
+```powershell
+winget install Python.Python.3.12
+```
+
+---
+
+## How to Use This Skill
+
+When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
+
+### Step 1: Analyze User Requirements
+
+Extract key information from user request:
+- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
+- **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.
+- **Industry**: healthcare, fintech, gaming, education, etc.
+- **Stack**: React, Vue, Next.js, or default to `html-tailwind`
+
+### Step 2: Generate Design System (REQUIRED)
+
+**Always start with `--design-system`** to get comprehensive recommendations with reasoning:
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
+```
+
+This command:
+1. Searches 5 domains in parallel (product, style, color, landing, typography)
+2. Applies reasoning rules from `ui-reasoning.csv` to select best matches
+3. Returns complete design system: pattern, style, colors, typography, effects
+4. Includes anti-patterns to avoid
+
+**Example:**
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
+```
+
+### Step 3: Supplement with Detailed Searches (as needed)
+
+After getting the design system, use domain searches to get additional details:
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
+```
+
+**When to use detailed searches:**
+
+| Need | Domain | Example |
+|------|--------|---------|
+| More style options | `style` | `--domain style "glassmorphism dark"` |
+| Chart recommendations | `chart` | `--domain chart "real-time dashboard"` |
+| UX best practices | `ux` | `--domain ux "animation accessibility"` |
+| Alternative fonts | `typography` | `--domain typography "elegant luxury"` |
+| Landing structure | `landing` | `--domain landing "hero social-proof"` |
+
+### Step 4: Stack Guidelines (Default: html-tailwind)
+
+Get implementation-specific best practices. If user doesn't specify a stack, **default to `html-tailwind`**.
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
+```
+
+Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`
+
+---
+
+## Search Reference
+
+### Available Domains
+
+| Domain | Use For | Example Keywords |
+|--------|---------|------------------|
+| `product` | Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |
+| `style` | UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |
+| `typography` | Font pairings, Google Fonts | elegant, playful, professional, modern |
+| `color` | Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |
+| `landing` | Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |
+| `chart` | Chart types, library recommendations | trend, comparison, timeline, funnel, pie |
+| `ux` | Best practices, anti-patterns | animation, accessibility, z-index, loading |
+| `react` | React/Next.js performance | waterfall, bundle, suspense, memo, rerender, cache |
+| `web` | Web interface guidelines | aria, focus, keyboard, semantic, virtualize |
+| `prompt` | AI prompts, CSS keywords | (style name) |
+
+### Available Stacks
+
+| Stack | Focus |
+|-------|-------|
+| `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |
+| `react` | State, hooks, performance, patterns |
+| `nextjs` | SSR, routing, images, API routes |
+| `vue` | Composition API, Pinia, Vue Router |
+| `svelte` | Runes, stores, SvelteKit |
+| `swiftui` | Views, State, Navigation, Animation |
+| `react-native` | Components, Navigation, Lists |
+| `flutter` | Widgets, State, Layout, Theming |
+| `shadcn` | shadcn/ui components, theming, forms, patterns |
+
+---
+
+## Example Workflow
+
+**User request:** "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"
+
+### Step 1: Analyze Requirements
+- Product type: Beauty/Spa service
+- Style keywords: elegant, professional, soft
+- Industry: Beauty/Wellness
+- Stack: html-tailwind (default)
+
+### Step 2: Generate Design System (REQUIRED)
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
+```
+
+**Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
+
+### Step 3: Supplement with Detailed Searches (as needed)
+
+```bash
+# Get UX guidelines for animation and accessibility
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
+
+# Get alternative typography options if needed
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
+```
+
+### Step 4: Stack Guidelines
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
+```
+
+**Then:** Synthesize design system + detailed searches and implement the design.
+
+---
+
+## Output Formats
+
+The `--design-system` flag supports two output formats:
+
+```bash
+# ASCII box (default) - best for terminal display
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
+
+# Markdown - best for documentation
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
+```
+
+---
+
+## Tips for Better Results
+
+1. **Be specific with keywords** - "healthcare SaaS dashboard" > "app"
+2. **Search multiple times** - Different keywords reveal different insights
+3. **Combine domains** - Style + Typography + Color = Complete design system
+4. **Always check UX** - Search "animation", "z-index", "accessibility" for common issues
+5. **Use stack flag** - Get implementation-specific best practices
+6. **Iterate** - If first search doesn't match, try different keywords
+
+---
+
+## Common Rules for Professional UI
+
+These are frequently overlooked issues that make UI look unprofessional:
+
+### Icons & Visual Elements
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **No emoji icons** | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 🚀 ⚙️ as UI icons |
+| **Stable hover states** | Use color/opacity transitions on hover | Use scale transforms that shift layout |
+| **Correct brand logos** | Research official SVG from Simple Icons | Guess or use incorrect logo paths |
+| **Consistent icon sizing** | Use fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes randomly |
+
+### Interaction & Cursor
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **Cursor pointer** | Add `cursor-pointer` to all clickable/hoverable cards | Leave default cursor on interactive elements |
+| **Hover feedback** | Provide visual feedback (color, shadow, border) | No indication element is interactive |
+| **Smooth transitions** | Use `transition-colors duration-200` | Instant state changes or too slow (>500ms) |
+
+### Light/Dark Mode Contrast
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **Glass card light mode** | Use `bg-white/80` or higher opacity | Use `bg-white/10` (too transparent) |
+| **Text contrast light** | Use `#0F172A` (slate-900) for text | Use `#94A3B8` (slate-400) for body text |
+| **Muted text light** | Use `#475569` (slate-600) minimum | Use gray-400 or lighter |
+| **Border visibility** | Use `border-gray-200` in light mode | Use `border-white/10` (invisible) |
+
+### Layout & Spacing
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **Floating navbar** | Add `top-4 left-4 right-4` spacing | Stick navbar to `top-0 left-0 right-0` |
+| **Content padding** | Account for fixed navbar height | Let content hide behind fixed elements |
+| **Consistent max-width** | Use same `max-w-6xl` or `max-w-7xl` | Mix different container widths |
+
+---
+
+## Pre-Delivery Checklist
+
+Before delivering UI code, verify these items:
+
+### Visual Quality
+- [ ] No emojis used as icons (use SVG instead)
+- [ ] All icons from consistent icon set (Heroicons/Lucide)
+- [ ] Brand logos are correct (verified from Simple Icons)
+- [ ] Hover states don't cause layout shift
+- [ ] Use theme colors directly (bg-primary) not var() wrapper
+
+### Interaction
+- [ ] All clickable elements have `cursor-pointer`
+- [ ] Hover states provide clear visual feedback
+- [ ] Transitions are smooth (150-300ms)
+- [ ] Focus states visible for keyboard navigation
+
+### Light/Dark Mode
+- [ ] Light mode text has sufficient contrast (4.5:1 minimum)
+- [ ] Glass/transparent elements visible in light mode
+- [ ] Borders visible in both modes
+- [ ] Test both modes before delivery
+
+### Layout
+- [ ] Floating elements have proper spacing from edges
+- [ ] No content hidden behind fixed navbars
+- [ ] Responsive at 375px, 768px, 1024px, 1440px
+- [ ] No horizontal scroll on mobile
+
+### Accessibility
+- [ ] All images have alt text
+- [ ] Form inputs have labels
+- [ ] Color is not the only indicator
+- [ ] `prefers-reduced-motion` respected
diff --git a/.agents/skills/ui-ux-pro-max/data/charts.csv b/.agents/skills/ui-ux-pro-max/data/charts.csv
new file mode 100644
index 0000000..e0a945b
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/charts.csv
@@ -0,0 +1,26 @@
+No,Data Type,Keywords,Best Chart Type,Secondary Options,Color Guidance,Performance Impact,Accessibility Notes,Library Recommendation,Interactive Level
+1,Trend Over Time,"trend, time-series, line, growth, timeline, progress",Line Chart,"Area Chart, Smooth Area",Primary: #0080FF. Multiple series: use distinct colors. Fill: 20% opacity,⚡ Excellent (optimized),✓ Clear line patterns for colorblind users. Add pattern overlays.,"Chart.js, Recharts, ApexCharts",Hover + Zoom
+2,Compare Categories,"compare, categories, bar, comparison, ranking",Bar Chart (Horizontal or Vertical),"Column Chart, Grouped Bar",Each bar: distinct color. Category: grouped same color. Sorted: descending order,⚡ Excellent,✓ Easy to compare. Add value labels on bars for clarity.,"Chart.js, Recharts, D3.js",Hover + Sort
+3,Part-to-Whole,"part-to-whole, pie, donut, percentage, proportion, share",Pie Chart or Donut,"Stacked Bar, Treemap",Colors: 5-6 max. Contrasting palette. Large slices first. Use labels.,⚡ Good (limit 6 slices),⚠ Hard for accessibility. Better: Stacked bar with legend. Avoid pie if >5 items.,"Chart.js, Recharts, D3.js",Hover + Drill
+4,Correlation/Distribution,"correlation, distribution, scatter, relationship, pattern",Scatter Plot or Bubble Chart,"Heat Map, Matrix",Color axis: gradient (blue-red). Size: relative. Opacity: 0.6-0.8 to show density,⚠ Moderate (many points),⚠ Provide data table alternative. Use pattern + color distinction.,"D3.js, Plotly, Recharts",Hover + Brush
+5,Heatmap/Intensity,"heatmap, heat-map, intensity, density, matrix",Heat Map or Choropleth,"Grid Heat Map, Bubble Heat",Gradient: Cool (blue) to Hot (red). Scale: clear legend. Divergent for ±data,⚡ Excellent (color CSS),⚠ Colorblind: Use pattern overlay. Provide numerical legend.,"D3.js, Plotly, ApexCharts",Hover + Zoom
+6,Geographic Data,"geographic, map, location, region, geo, spatial","Choropleth Map, Bubble Map",Geographic Heat Map,Regional: single color gradient or categorized colors. Legend: clear scale,⚠ Moderate (rendering),⚠ Include text labels for regions. Provide data table alternative.,"D3.js, Mapbox, Leaflet",Pan + Zoom + Drill
+7,Funnel/Flow,funnel/flow,"Funnel Chart, Sankey",Waterfall (for flows),Stages: gradient (starting color → ending color). Show conversion %,⚡ Good,✓ Clear stage labels + percentages. Good for accessibility if labeled.,"D3.js, Recharts, Custom SVG",Hover + Drill
+8,Performance vs Target,performance-vs-target,Gauge Chart or Bullet Chart,"Dial, Thermometer",Performance: Red→Yellow→Green gradient. Target: marker line. Threshold colors,⚡ Good,✓ Add numerical value + percentage label beside gauge.,"D3.js, ApexCharts, Custom SVG",Hover
+9,Time-Series Forecast,time-series-forecast,Line with Confidence Band,Ribbon Chart,Actual: solid line #0080FF. Forecast: dashed #FF9500. Band: light shading,⚡ Good,✓ Clearly distinguish actual vs forecast. Add legend.,"Chart.js, ApexCharts, Plotly",Hover + Toggle
+10,Anomaly Detection,anomaly-detection,Line Chart with Highlights,Scatter with Alert,Normal: blue #0080FF. Anomaly: red #FF0000 circle/square marker + alert,⚡ Good,✓ Circle/marker for anomalies. Add text alert annotation.,"D3.js, Plotly, ApexCharts",Hover + Alert
+11,Hierarchical/Nested Data,hierarchical/nested-data,Treemap,"Sunburst, Nested Donut, Icicle",Parent: distinct hues. Children: lighter shades. White borders 2-3px.,⚠ Moderate,⚠ Poor - provide table alternative. Label large areas.,"D3.js, Recharts, ApexCharts",Hover + Drilldown
+12,Flow/Process Data,flow/process-data,Sankey Diagram,"Alluvial, Chord Diagram",Gradient from source to target. Opacity 0.4-0.6 for flows.,⚠ Moderate,⚠ Poor - provide flow table alternative.,"D3.js (d3-sankey), Plotly",Hover + Drilldown
+13,Cumulative Changes,cumulative-changes,Waterfall Chart,"Stacked Bar, Cascade",Increases: #4CAF50. Decreases: #F44336. Start: #2196F3. End: #0D47A1.,⚡ Good,✓ Good - clear directional colors with labels.,"ApexCharts, Highcharts, Plotly",Hover
+14,Multi-Variable Comparison,multi-variable-comparison,Radar/Spider Chart,"Parallel Coordinates, Grouped Bar",Single: #0080FF 20% fill. Multiple: distinct colors per dataset.,⚡ Good,⚠ Moderate - limit 5-8 axes. Add data table.,"Chart.js, Recharts, ApexCharts",Hover + Toggle
+15,Stock/Trading OHLC,stock/trading-ohlc,Candlestick Chart,"OHLC Bar, Heikin-Ashi",Bullish: #26A69A. Bearish: #EF5350. Volume: 40% opacity below.,⚡ Good,⚠ Moderate - provide OHLC data table.,"Lightweight Charts (TradingView), ApexCharts",Real-time + Hover + Zoom
+16,Relationship/Connection Data,relationship/connection-data,Network Graph,"Hierarchical Tree, Adjacency Matrix",Node types: categorical colors. Edges: #90A4AE 60% opacity.,❌ Poor (500+ nodes struggles),❌ Very Poor - provide adjacency list alternative.,"D3.js (d3-force), Vis.js, Cytoscape.js",Drilldown + Hover + Drag
+17,Distribution/Statistical,distribution/statistical,Box Plot,"Violin Plot, Beeswarm",Box: #BBDEFB. Border: #1976D2. Median: #D32F2F. Outliers: #F44336.,⚡ Excellent,"✓ Good - include stats table (min, Q1, median, Q3, max).","Plotly, D3.js, Chart.js (plugin)",Hover
+18,Performance vs Target (Compact),performance-vs-target-(compact),Bullet Chart,"Gauge, Progress Bar","Ranges: #FFCDD2, #FFF9C4, #C8E6C9. Performance: #1976D2. Target: black 3px.",⚡ Excellent,✓ Excellent - compact with clear values.,"D3.js, Plotly, Custom SVG",Hover
+19,Proportional/Percentage,proportional/percentage,Waffle Chart,"Pictogram, Stacked Bar 100%",10x10 grid. 3-5 categories max. 2-3px spacing between squares.,⚡ Good,✓ Good - better than pie for accessibility.,"D3.js, React-Waffle, Custom CSS Grid",Hover
+20,Hierarchical Proportional,hierarchical-proportional,Sunburst Chart,"Treemap, Icicle, Circle Packing",Center to outer: darker to lighter. 15-20% lighter per level.,⚠ Moderate,⚠ Poor - provide hierarchy table alternative.,"D3.js (d3-hierarchy), Recharts, ApexCharts",Drilldown + Hover
+21,Root Cause Analysis,"root cause, decomposition, tree, hierarchy, drill-down, ai-split",Decomposition Tree,"Decision Tree, Flow Chart",Nodes: #2563EB (Primary) vs #EF4444 (Negative impact). Connectors: Neutral grey.,⚠ Moderate (calculation heavy),✓ clear hierarchy. Allow keyboard navigation for nodes.,"Power BI (native), React-Flow, Custom D3.js",Drill + Expand
+22,3D Spatial Data,"3d, spatial, immersive, terrain, molecular, volumetric",3D Scatter/Surface Plot,"Volumetric Rendering, Point Cloud",Depth cues: lighting/shading. Z-axis: color gradient (cool to warm).,❌ Heavy (WebGL required),❌ Poor - requires alternative 2D view or data table.,"Three.js, Deck.gl, Plotly 3D",Rotate + Zoom + VR
+23,Real-Time Streaming,"streaming, real-time, ticker, live, velocity, pulse",Streaming Area Chart,"Ticker Tape, Moving Gauge",Current: Bright Pulse (#00FF00). History: Fading opacity. Grid: Dark.,⚡ Optimized (canvas/webgl),⚠ Flashing elements - provide pause button. High contrast.,Smoothed D3.js, CanvasJS, SciChart,Real-time + Pause
+24,Sentiment/Emotion,"sentiment, emotion, nlp, opinion, feeling",Word Cloud with Sentiment,"Sentiment Arc, Radar Chart",Positive: #22C55E. Negative: #EF4444. Neutral: #94A3B8. Size = Frequency.,⚡ Good,⚠ Word clouds poor for screen readers. Use list view.,"D3-cloud, Highcharts, Nivo",Hover + Filter
+25,Process Mining,"process, mining, variants, path, bottleneck, log",Process Map / Graph,"Directed Acyclic Graph (DAG), Petri Net",Happy path: #10B981 (Thick). Deviations: #F59E0B (Thin). Bottlenecks: #EF4444.,⚠ Moderate to Heavy,⚠ Complex graphs hard to navigate. Provide path summary.,"React-Flow, Cytoscape.js, Recharts",Drag + Node-Click
\ No newline at end of file
diff --git a/.agents/skills/ui-ux-pro-max/data/colors.csv b/.agents/skills/ui-ux-pro-max/data/colors.csv
new file mode 100644
index 0000000..7327ffd
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/colors.csv
@@ -0,0 +1,97 @@
+No,Product Type,Keywords,Primary (Hex),Secondary (Hex),CTA (Hex),Background (Hex),Text (Hex),Border (Hex),Notes
+1,SaaS (General),"saas, general",#2563EB,#3B82F6,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust blue + accent contrast
+2,Micro SaaS,"micro, saas",#2563EB,#3B82F6,#F97316,#F8FAFC,#1E293B,#E2E8F0,Vibrant primary + white space
+3,E-commerce,commerce,#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand primary + success green
+4,E-commerce Luxury,"commerce, luxury",#1C1917,#44403C,#CA8A04,#FAFAF9,#0C0A09,#D6D3D1,Premium colors + minimal accent
+5,Service Landing Page,"service, landing, page",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand primary + trust colors
+6,B2B Service,"b2b, service",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional blue + neutral grey
+7,Financial Dashboard,"financial, dashboard",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark bg + red/green alerts + trust blue
+8,Analytics Dashboard,"analytics, dashboard",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Cool→Hot gradients + neutral grey
+9,Healthcare App,"healthcare, app",#0891B2,#22D3EE,#059669,#ECFEFF,#164E63,#A5F3FC,Calm blue + health green + trust
+10,Educational App,"educational, app",#4F46E5,#818CF8,#F97316,#EEF2FF,#1E1B4B,#C7D2FE,Playful colors + clear hierarchy
+11,Creative Agency,"creative, agency",#EC4899,#F472B6,#06B6D4,#FDF2F8,#831843,#FBCFE8,Bold primaries + artistic freedom
+12,Portfolio/Personal,"portfolio, personal",#18181B,#3F3F46,#2563EB,#FAFAFA,#09090B,#E4E4E7,Brand primary + artistic interpretation
+13,Gaming,gaming,#7C3AED,#A78BFA,#F43F5E,#0F0F23,#E2E8F0,#4C1D95,Vibrant + neon + immersive colors
+14,Government/Public Service,"government, public, service",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional blue + high contrast
+15,Fintech/Crypto,"fintech, crypto",#F59E0B,#FBBF24,#8B5CF6,#0F172A,#F8FAFC,#334155,Dark tech colors + trust + vibrant accents
+16,Social Media App,"social, media, app",#2563EB,#60A5FA,#F43F5E,#F8FAFC,#1E293B,#DBEAFE,Vibrant + engagement colors
+17,Productivity Tool,"productivity, tool",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Clear hierarchy + functional colors
+18,Design System/Component Library,"design, system, component, library",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Clear hierarchy + code-like structure
+19,AI/Chatbot Platform,"chatbot, platform",#7C3AED,#A78BFA,#06B6D4,#FAF5FF,#1E1B4B,#DDD6FE,Neutral + AI Purple (#6366F1)
+20,NFT/Web3 Platform,"nft, web3, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Neon + Gold (#FFD700)
+21,Creator Economy Platform,"creator, economy, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Vibrant + Brand colors
+22,Sustainability/ESG Platform,"sustainability, esg, platform",#7C3AED,#A78BFA,#06B6D4,#FAF5FF,#1E1B4B,#DDD6FE,Green (#228B22) + Earth tones
+23,Remote Work/Collaboration Tool,"remote, work, collaboration, tool",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Calm Blue + Neutral grey
+24,Mental Health App,"mental, health, app",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Calm Pastels + Trust colors
+25,Pet Tech App,"pet, tech, app",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Playful + Warm colors
+26,Smart Home/IoT Dashboard,"smart, home, iot, dashboard",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Status indicator colors
+27,EV/Charging Ecosystem,"charging, ecosystem",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Electric Blue (#009CD1) + Green
+28,Subscription Box Service,"subscription, box, service",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand + Excitement colors
+29,Podcast Platform,"podcast, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Audio waveform accents
+30,Dating App,"dating, app",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Warm + Romantic (Pink/Red gradients)
+31,Micro-Credentials/Badges Platform,"micro, credentials, badges, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust Blue + Gold (#FFD700)
+32,Knowledge Base/Documentation,"knowledge, base, documentation",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Clean hierarchy + minimal color
+33,Hyperlocal Services,"hyperlocal, services",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Location markers + Trust colors
+34,Beauty/Spa/Wellness Service,"beauty, spa, wellness, service",#10B981,#34D399,#8B5CF6,#ECFDF5,#064E3B,#A7F3D0,Soft pastels (Pink #FFB6C1 Sage #90EE90) + Cream + Gold accents
+35,Luxury/Premium Brand,"luxury, premium, brand",#1C1917,#44403C,#CA8A04,#FAFAF9,#0C0A09,#D6D3D1,Black + Gold (#FFD700) + White + Minimal accent
+36,Restaurant/Food Service,"restaurant, food, service",#DC2626,#F87171,#CA8A04,#FEF2F2,#450A0A,#FECACA,Warm colors (Orange Red Brown) + appetizing imagery
+37,Fitness/Gym App,"fitness, gym, app",#DC2626,#F87171,#16A34A,#FEF2F2,#1F2937,#FECACA,Energetic (Orange #FF6B35 Electric Blue) + Dark bg
+38,Real Estate/Property,"real, estate, property",#0F766E,#14B8A6,#0369A1,#F0FDFA,#134E4A,#99F6E4,Trust Blue (#0077B6) + Gold accents + White
+39,Travel/Tourism Agency,"travel, tourism, agency",#EC4899,#F472B6,#06B6D4,#FDF2F8,#831843,#FBCFE8,Vibrant destination colors + Sky Blue + Warm accents
+40,Hotel/Hospitality,"hotel, hospitality",#1E3A8A,#3B82F6,#CA8A04,#F8FAFC,#1E40AF,#BFDBFE,Warm neutrals + Gold (#D4AF37) + Brand accent
+41,Wedding/Event Planning,"wedding, event, planning",#7C3AED,#A78BFA,#F97316,#FAF5FF,#4C1D95,#DDD6FE,Soft Pink (#FFD6E0) + Gold + Cream + Sage
+42,Legal Services,"legal, services",#1E3A8A,#1E40AF,#B45309,#F8FAFC,#0F172A,#CBD5E1,Navy Blue (#1E3A5F) + Gold + White
+43,Insurance Platform,"insurance, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust Blue (#0066CC) + Green (security) + Neutral
+44,Banking/Traditional Finance,"banking, traditional, finance",#0F766E,#14B8A6,#0369A1,#F0FDFA,#134E4A,#99F6E4,Navy (#0A1628) + Trust Blue + Gold accents
+45,Online Course/E-learning,"online, course, learning",#0D9488,#2DD4BF,#EA580C,#F0FDFA,#134E4A,#5EEAD4,Vibrant learning colors + Progress green
+46,Non-profit/Charity,"non, profit, charity",#0891B2,#22D3EE,#F97316,#ECFEFF,#164E63,#A5F3FC,Cause-related colors + Trust + Warm
+47,Music Streaming,"music, streaming",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark (#121212) + Vibrant accents + Album art colors
+48,Video Streaming/OTT,"video, streaming, ott",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark bg + Content poster colors + Brand accent
+49,Job Board/Recruitment,"job, board, recruitment",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional Blue + Success Green + Neutral
+50,Marketplace (P2P),"marketplace, p2p",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust colors + Category colors + Success green
+51,Logistics/Delivery,"logistics, delivery",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Blue (#2563EB) + Orange (tracking) + Green (delivered)
+52,Agriculture/Farm Tech,"agriculture, farm, tech",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Earth Green (#4A7C23) + Brown + Sky Blue
+53,Construction/Architecture,"construction, architecture",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Grey (#4A4A4A) + Orange (safety) + Blueprint Blue
+54,Automotive/Car Dealership,"automotive, car, dealership",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand colors + Metallic accents + Dark/Light
+55,Photography Studio,"photography, studio",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Black + White + Minimal accent
+56,Coworking Space,"coworking, space",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Energetic colors + Wood tones + Brand accent
+57,Cleaning Service,"cleaning, service",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Fresh Blue (#00B4D8) + Clean White + Green
+58,Home Services (Plumber/Electrician),"home, services, plumber, electrician",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Trust Blue + Safety Orange + Professional grey
+59,Childcare/Daycare,"childcare, daycare",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Playful pastels + Safe colors + Warm accents
+60,Senior Care/Elderly,"senior, care, elderly",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Calm Blue + Warm neutrals + Large text
+61,Medical Clinic,"medical, clinic",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Medical Blue (#0077B6) + Trust White + Calm Green
+62,Pharmacy/Drug Store,"pharmacy, drug, store",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Pharmacy Green + Trust Blue + Clean White
+63,Dental Practice,"dental, practice",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Fresh Blue + White + Smile Yellow accent
+64,Veterinary Clinic,"veterinary, clinic",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Caring Blue + Pet-friendly colors + Warm accents
+65,Florist/Plant Shop,"florist, plant, shop",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Natural Green + Floral pinks/purples + Earth tones
+66,Bakery/Cafe,"bakery, cafe",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Warm Brown + Cream + Appetizing accents
+67,Coffee Shop,"coffee, shop",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Coffee Brown (#6F4E37) + Cream + Warm accents
+68,Brewery/Winery,"brewery, winery",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Deep amber/burgundy + Gold + Craft aesthetic
+69,Airline,airline,#7C3AED,#A78BFA,#06B6D4,#FAF5FF,#1E1B4B,#DDD6FE,Sky Blue + Brand colors + Trust accents
+70,News/Media Platform,"news, media, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand colors + High contrast + Category colors
+71,Magazine/Blog,"magazine, blog",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Editorial colors + Brand primary + Clean white
+72,Freelancer Platform,"freelancer, platform",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional Blue + Success Green + Neutral
+73,Consulting Firm,"consulting, firm",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Navy + Gold + Professional grey
+74,Marketing Agency,"marketing, agency",#EC4899,#F472B6,#06B6D4,#FDF2F8,#831843,#FBCFE8,Bold brand colors + Creative freedom
+75,Event Management,"event, management",#7C3AED,#A78BFA,#F97316,#FAF5FF,#4C1D95,#DDD6FE,Event theme colors + Excitement accents
+76,Conference/Webinar Platform,"conference, webinar, platform",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional Blue + Video accent + Brand
+77,Membership/Community,"membership, community",#7C3AED,#A78BFA,#F97316,#FAF5FF,#4C1D95,#DDD6FE,Community brand colors + Engagement accents
+78,Newsletter Platform,"newsletter, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand primary + Clean white + CTA accent
+79,Digital Products/Downloads,"digital, products, downloads",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Product category colors + Brand + Success green
+80,Church/Religious Organization,"church, religious, organization",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Warm Gold + Deep Purple/Blue + White
+81,Sports Team/Club,"sports, team, club",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Team colors + Energetic accents
+82,Museum/Gallery,"museum, gallery",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Art-appropriate neutrals + Exhibition accents
+83,Theater/Cinema,"theater, cinema",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Spotlight accents + Gold
+84,Language Learning App,"language, learning, app",#0D9488,#2DD4BF,#EA580C,#F0FDFA,#134E4A,#5EEAD4,Playful colors + Progress indicators + Country flags
+85,Coding Bootcamp,"coding, bootcamp",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Code editor colors + Brand + Success green
+86,Cybersecurity Platform,"cybersecurity, security, cyber, hacker",#00FF41,#0D0D0D,#00FF41,#000000,#E0E0E0,#1F1F1F,Matrix Green + Deep Black + Terminal feel
+87,Developer Tool / IDE,"developer, tool, ide, code, dev",#3B82F6,#1E293B,#2563EB,#0F172A,#F1F5F9,#334155,Dark syntax theme colors + Blue focus
+88,Biotech / Life Sciences,"biotech, science, biology, medical",#0EA5E9,#0284C7,#10B981,#F8FAFC,#0F172A,#E2E8F0,Sterile White + DNA Blue + Life Green
+89,Space Tech / Aerospace,"space, aerospace, tech, futuristic",#FFFFFF,#94A3B8,#3B82F6,#0B0B10,#F8FAFC,#1E293B,Deep Space Black + Star White + Metallic
+90,Architecture / Interior,"architecture, interior, design, luxury",#171717,#404040,#D4AF37,#FFFFFF,#171717,#E5E5E5,Monochrome + Gold Accent + High Imagery
+91,Quantum Computing,"quantum, qubit, tech",#00FFFF,#7B61FF,#FF00FF,#050510,#E0E0FF,#333344,Interference patterns + Neon + Deep Dark
+92,Biohacking / Longevity,"bio, health, science",#FF4D4D,#4D94FF,#00E676,#F5F5F7,#1C1C1E,#E5E5EA,Biological red/blue + Clinical white
+93,Autonomous Systems,"drone, robot, fleet",#00FF41,#008F11,#FF3333,#0D1117,#E6EDF3,#30363D,Terminal Green + Tactical Dark
+94,Generative AI Art,"art, gen-ai, creative",#111111,#333333,#FFFFFF,#FAFAFA,#000000,#E5E5E5,Canvas Neutral + High Contrast
+95,Spatial / Vision OS,"spatial, glass, vision",#FFFFFF,#E5E5E5,#007AFF,#888888,#000000,#FFFFFF,Glass opacity 20% + System Blue
+96,Climate Tech,"climate, green, energy",#2E8B57,#87CEEB,#FFD700,#F0FFF4,#1A3320,#C6E6C6,Nature Green + Solar Yellow + Air Blue
\ No newline at end of file
diff --git a/.agents/skills/ui-ux-pro-max/data/icons.csv b/.agents/skills/ui-ux-pro-max/data/icons.csv
new file mode 100644
index 0000000..a09a534
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/icons.csv
@@ -0,0 +1,101 @@
+STT,Category,Icon Name,Keywords,Library,Import Code,Usage,Best For,Style
+1,Navigation,menu,hamburger menu navigation toggle bars,Lucide,import { Menu } from 'lucide-react',<Menu />,Mobile navigation drawer toggle sidebar,Outline
+2,Navigation,arrow-left,back previous return navigate,Lucide,import { ArrowLeft } from 'lucide-react',<ArrowLeft />,Back button breadcrumb navigation,Outline
+3,Navigation,arrow-right,next forward continue navigate,Lucide,import { ArrowRight } from 'lucide-react',<ArrowRight />,Forward button next step CTA,Outline
+4,Navigation,chevron-down,dropdown expand accordion select,Lucide,import { ChevronDown } from 'lucide-react',<ChevronDown />,Dropdown toggle accordion header,Outline
+5,Navigation,chevron-up,collapse close accordion minimize,Lucide,import { ChevronUp } from 'lucide-react',<ChevronUp />,Accordion collapse minimize,Outline
+6,Navigation,home,homepage main dashboard start,Lucide,import { Home } from 'lucide-react',<Home />,Home navigation main page,Outline
+7,Navigation,x,close cancel dismiss remove exit,Lucide,import { X } from 'lucide-react',<X />,Modal close dismiss button,Outline
+8,Navigation,external-link,open new tab external link,Lucide,import { ExternalLink } from 'lucide-react',<ExternalLink />,External link indicator,Outline
+9,Action,plus,add create new insert,Lucide,import { Plus } from 'lucide-react',<Plus />,Add button create new item,Outline
+10,Action,minus,remove subtract decrease delete,Lucide,import { Minus } from 'lucide-react',<Minus />,Remove item quantity decrease,Outline
+11,Action,trash-2,delete remove discard bin,Lucide,import { Trash2 } from 'lucide-react',<Trash2 />,Delete action destructive,Outline
+12,Action,edit,pencil modify change update,Lucide,import { Edit } from 'lucide-react',<Edit />,Edit button modify content,Outline
+13,Action,save,disk store persist save,Lucide,import { Save } from 'lucide-react',<Save />,Save button persist changes,Outline
+14,Action,download,export save file download,Lucide,import { Download } from 'lucide-react',<Download />,Download file export,Outline
+15,Action,upload,import file attach upload,Lucide,import { Upload } from 'lucide-react',<Upload />,Upload file import,Outline
+16,Action,copy,duplicate clipboard paste,Lucide,import { Copy } from 'lucide-react',<Copy />,Copy to clipboard,Outline
+17,Action,share,social distribute send,Lucide,import { Share } from 'lucide-react',<Share />,Share button social,Outline
+18,Action,search,find lookup filter query,Lucide,import { Search } from 'lucide-react',<Search />,Search input bar,Outline
+19,Action,filter,sort refine narrow options,Lucide,import { Filter } from 'lucide-react',<Filter />,Filter dropdown sort,Outline
+20,Action,settings,gear cog preferences config,Lucide,import { Settings } from 'lucide-react',<Settings />,Settings page configuration,Outline
+21,Status,check,success done complete verified,Lucide,import { Check } from 'lucide-react',<Check />,Success state checkmark,Outline
+22,Status,check-circle,success verified approved complete,Lucide,import { CheckCircle } from 'lucide-react',<CheckCircle />,Success badge verified,Outline
+23,Status,x-circle,error failed cancel rejected,Lucide,import { XCircle } from 'lucide-react',<XCircle />,Error state failed,Outline
+24,Status,alert-triangle,warning caution attention danger,Lucide,import { AlertTriangle } from 'lucide-react',<AlertTriangle />,Warning message caution,Outline
+25,Status,alert-circle,info notice information help,Lucide,import { AlertCircle } from 'lucide-react',<AlertCircle />,Info notice alert,Outline
+26,Status,info,information help tooltip details,Lucide,import { Info } from 'lucide-react',<Info />,Information tooltip help,Outline
+27,Status,loader,loading spinner processing wait,Lucide,import { Loader } from 'lucide-react',<Loader className="animate-spin" />,Loading state spinner,Outline
+28,Status,clock,time schedule pending wait,Lucide,import { Clock } from 'lucide-react',<Clock />,Pending time schedule,Outline
+29,Communication,mail,email message inbox letter,Lucide,import { Mail } from 'lucide-react',<Mail />,Email contact inbox,Outline
+30,Communication,message-circle,chat comment bubble conversation,Lucide,import { MessageCircle } from 'lucide-react',<MessageCircle />,Chat comment message,Outline
+31,Communication,phone,call mobile telephone contact,Lucide,import { Phone } from 'lucide-react',<Phone />,Phone contact call,Outline
+32,Communication,send,submit dispatch message airplane,Lucide,import { Send } from 'lucide-react',<Send />,Send message submit,Outline
+33,Communication,bell,notification alert ring reminder,Lucide,import { Bell } from 'lucide-react',<Bell />,Notification bell alert,Outline
+34,User,user,profile account person avatar,Lucide,import { User } from 'lucide-react',<User />,User profile account,Outline
+35,User,users,team group people members,Lucide,import { Users } from 'lucide-react',<Users />,Team group members,Outline
+36,User,user-plus,add invite new member,Lucide,import { UserPlus } from 'lucide-react',<UserPlus />,Add user invite,Outline
+37,User,log-in,signin authenticate enter,Lucide,import { LogIn } from 'lucide-react',<LogIn />,Login signin,Outline
+38,User,log-out,signout exit leave logout,Lucide,import { LogOut } from 'lucide-react',<LogOut />,Logout signout,Outline
+39,Media,image,photo picture gallery thumbnail,Lucide,import { Image } from 'lucide-react',<Image />,Image photo gallery,Outline
+40,Media,video,movie film play record,Lucide,import { Video } from 'lucide-react',<Video />,Video player media,Outline
+41,Media,play,start video audio media,Lucide,import { Play } from 'lucide-react',<Play />,Play button video audio,Outline
+42,Media,pause,stop halt video audio,Lucide,import { Pause } from 'lucide-react',<Pause />,Pause button media,Outline
+43,Media,volume-2,sound audio speaker music,Lucide,import { Volume2 } from 'lucide-react',<Volume2 />,Volume audio sound,Outline
+44,Media,mic,microphone record voice audio,Lucide,import { Mic } from 'lucide-react',<Mic />,Microphone voice record,Outline
+45,Media,camera,photo capture snapshot picture,Lucide,import { Camera } from 'lucide-react',<Camera />,Camera photo capture,Outline
+46,Commerce,shopping-cart,cart checkout basket buy,Lucide,import { ShoppingCart } from 'lucide-react',<ShoppingCart />,Shopping cart e-commerce,Outline
+47,Commerce,shopping-bag,purchase buy store bag,Lucide,import { ShoppingBag } from 'lucide-react',<ShoppingBag />,Shopping bag purchase,Outline
+48,Commerce,credit-card,payment card checkout stripe,Lucide,import { CreditCard } from 'lucide-react',<CreditCard />,Payment credit card,Outline
+49,Commerce,dollar-sign,money price currency cost,Lucide,import { DollarSign } from 'lucide-react',<DollarSign />,Price money currency,Outline
+50,Commerce,tag,label price discount sale,Lucide,import { Tag } from 'lucide-react',<Tag />,Price tag label,Outline
+51,Commerce,gift,present reward bonus offer,Lucide,import { Gift } from 'lucide-react',<Gift />,Gift reward offer,Outline
+52,Commerce,percent,discount sale offer promo,Lucide,import { Percent } from 'lucide-react',<Percent />,Discount percentage sale,Outline
+53,Data,bar-chart,analytics statistics graph metrics,Lucide,import { BarChart } from 'lucide-react',<BarChart />,Bar chart analytics,Outline
+54,Data,pie-chart,statistics distribution breakdown,Lucide,import { PieChart } from 'lucide-react',<PieChart />,Pie chart distribution,Outline
+55,Data,trending-up,growth increase positive trend,Lucide,import { TrendingUp } from 'lucide-react',<TrendingUp />,Growth trend positive,Outline
+56,Data,trending-down,decline decrease negative trend,Lucide,import { TrendingDown } from 'lucide-react',<TrendingDown />,Decline trend negative,Outline
+57,Data,activity,pulse heartbeat monitor live,Lucide,import { Activity } from 'lucide-react',<Activity />,Activity monitor pulse,Outline
+58,Data,database,storage server data backend,Lucide,import { Database } from 'lucide-react',<Database />,Database storage,Outline
+59,Files,file,document page paper doc,Lucide,import { File } from 'lucide-react',<File />,File document,Outline
+60,Files,file-text,document text page article,Lucide,import { FileText } from 'lucide-react',<FileText />,Text document article,Outline
+61,Files,folder,directory organize group files,Lucide,import { Folder } from 'lucide-react',<Folder />,Folder directory,Outline
+62,Files,folder-open,expanded browse files view,Lucide,import { FolderOpen } from 'lucide-react',<FolderOpen />,Open folder browse,Outline
+63,Files,paperclip,attachment attach file link,Lucide,import { Paperclip } from 'lucide-react',<Paperclip />,Attachment paperclip,Outline
+64,Files,link,url hyperlink chain connect,Lucide,import { Link } from 'lucide-react',<Link />,Link URL hyperlink,Outline
+65,Files,clipboard,paste copy buffer notes,Lucide,import { Clipboard } from 'lucide-react',<Clipboard />,Clipboard paste,Outline
+66,Layout,grid,tiles gallery layout dashboard,Lucide,import { Grid } from 'lucide-react',<Grid />,Grid layout gallery,Outline
+67,Layout,list,rows table lines items,Lucide,import { List } from 'lucide-react',<List />,List view rows,Outline
+68,Layout,columns,layout split dual sidebar,Lucide,import { Columns } from 'lucide-react',<Columns />,Column layout split,Outline
+69,Layout,maximize,fullscreen expand enlarge zoom,Lucide,import { Maximize } from 'lucide-react',<Maximize />,Fullscreen maximize,Outline
+70,Layout,minimize,reduce shrink collapse exit,Lucide,import { Minimize } from 'lucide-react',<Minimize />,Minimize reduce,Outline
+71,Layout,sidebar,panel drawer navigation menu,Lucide,import { Sidebar } from 'lucide-react',<Sidebar />,Sidebar panel,Outline
+72,Social,heart,like love favorite wishlist,Lucide,import { Heart } from 'lucide-react',<Heart />,Like favorite love,Outline
+73,Social,star,rating review favorite bookmark,Lucide,import { Star } from 'lucide-react',<Star />,Star rating favorite,Outline
+74,Social,thumbs-up,like approve agree positive,Lucide,import { ThumbsUp } from 'lucide-react',<ThumbsUp />,Like approve thumb,Outline
+75,Social,thumbs-down,dislike disapprove disagree negative,Lucide,import { ThumbsDown } from 'lucide-react',<ThumbsDown />,Dislike disapprove,Outline
+76,Social,bookmark,save later favorite mark,Lucide,import { Bookmark } from 'lucide-react',<Bookmark />,Bookmark save,Outline
+77,Social,flag,report mark important highlight,Lucide,import { Flag } from 'lucide-react',<Flag />,Flag report,Outline
+78,Device,smartphone,mobile phone device touch,Lucide,import { Smartphone } from 'lucide-react',<Smartphone />,Mobile smartphone,Outline
+79,Device,tablet,ipad device touch screen,Lucide,import { Tablet } from 'lucide-react',<Tablet />,Tablet device,Outline
+80,Device,monitor,desktop screen computer display,Lucide,import { Monitor } from 'lucide-react',<Monitor />,Desktop monitor,Outline
+81,Device,laptop,notebook computer portable device,Lucide,import { Laptop } from 'lucide-react',<Laptop />,Laptop computer,Outline
+82,Device,printer,print document output paper,Lucide,import { Printer } from 'lucide-react',<Printer />,Printer print,Outline
+83,Security,lock,secure password protected private,Lucide,import { Lock } from 'lucide-react',<Lock />,Lock secure,Outline
+84,Security,unlock,open access unsecure public,Lucide,import { Unlock } from 'lucide-react',<Unlock />,Unlock open,Outline
+85,Security,shield,protection security safe guard,Lucide,import { Shield } from 'lucide-react',<Shield />,Shield protection,Outline
+86,Security,key,password access unlock login,Lucide,import { Key } from 'lucide-react',<Key />,Key password,Outline
+87,Security,eye,view show visible password,Lucide,import { Eye } from 'lucide-react',<Eye />,Show password view,Outline
+88,Security,eye-off,hide invisible password hidden,Lucide,import { EyeOff } from 'lucide-react',<EyeOff />,Hide password,Outline
+89,Location,map-pin,location marker place address,Lucide,import { MapPin } from 'lucide-react',<MapPin />,Location pin marker,Outline
+90,Location,map,directions navigate geography location,Lucide,import { Map } from 'lucide-react',<Map />,Map directions,Outline
+91,Location,navigation,compass direction pointer arrow,Lucide,import { Navigation } from 'lucide-react',<Navigation />,Navigation compass,Outline
+92,Location,globe,world international global web,Lucide,import { Globe } from 'lucide-react',<Globe />,Globe world,Outline
+93,Time,calendar,date schedule event appointment,Lucide,import { Calendar } from 'lucide-react',<Calendar />,Calendar date,Outline
+94,Time,refresh-cw,reload sync update refresh,Lucide,import { RefreshCw } from 'lucide-react',<RefreshCw />,Refresh reload,Outline
+95,Time,rotate-ccw,undo back revert history,Lucide,import { RotateCcw } from 'lucide-react',<RotateCcw />,Undo revert,Outline
+96,Time,rotate-cw,redo forward repeat history,Lucide,import { RotateCw } from 'lucide-react',<RotateCw />,Redo forward,Outline
+97,Development,code,develop programming syntax html,Lucide,import { Code } from 'lucide-react',<Code />,Code development,Outline
+98,Development,terminal,console cli command shell,Lucide,import { Terminal } from 'lucide-react',<Terminal />,Terminal console,Outline
+99,Development,git-branch,version control branch merge,Lucide,import { GitBranch } from 'lucide-react',<GitBranch />,Git branch,Outline
+100,Development,github,repository code open source,Lucide,import { Github } from 'lucide-react',<Github />,GitHub repository,Outline
diff --git a/.agents/skills/ui-ux-pro-max/data/landing.csv b/.agents/skills/ui-ux-pro-max/data/landing.csv
new file mode 100644
index 0000000..a68c36f
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/landing.csv
@@ -0,0 +1,31 @@
+No,Pattern Name,Keywords,Section Order,Primary CTA Placement,Color Strategy,Recommended Effects,Conversion Optimization
+1,Hero + Features + CTA,"hero, hero-centric, features, feature-rich, cta, call-to-action","1. Hero with headline/image, 2. Value prop, 3. Key features (3-5), 4. CTA section, 5. Footer",Hero (sticky) + Bottom,Hero: Brand primary or vibrant. Features: Card bg #FAFAFA. CTA: Contrasting accent color,"Hero parallax, feature card hover lift, CTA glow on hover",Deep CTA placement. Use contrasting color (at least 7:1 contrast ratio). Sticky navbar CTA.
+2,Hero + Testimonials + CTA,"hero, testimonials, social-proof, trust, reviews, cta","1. Hero, 2. Problem statement, 3. Solution overview, 4. Testimonials carousel, 5. CTA",Hero (sticky) + Post-testimonials,"Hero: Brand color. Testimonials: Light bg #F5F5F5. Quotes: Italic, muted color #666. CTA: Vibrant","Testimonial carousel slide animations, quote marks animations, avatar fade-in",Social proof before CTA. Use 3-5 testimonials. Include photo + name + role. CTA after social proof.
+3,Product Demo + Features,"demo, product-demo, features, showcase, interactive","1. Hero, 2. Product video/mockup (center), 3. Feature breakdown per section, 4. Comparison (optional), 5. CTA",Video center + CTA right/bottom,Video surround: Brand color overlay. Features: Icon color #0080FF. Text: Dark #222,"Video play button pulse, feature scroll reveals, demo interaction highlights",Embedded product demo increases engagement. Use interactive mockup if possible. Auto-play video muted.
+4,Minimal Single Column,"minimal, simple, direct, single-column, clean","1. Hero headline, 2. Short description, 3. Benefit bullets (3 max), 4. CTA, 5. Footer","Center, large CTA button",Minimalist: Brand + white #FFFFFF + accent. Buttons: High contrast 7:1+. Text: Black/Dark grey,Minimal hover effects. Smooth scroll. CTA scale on hover (subtle),Single CTA focus. Large typography. Lots of whitespace. No nav clutter. Mobile-first.
+5,Funnel (3-Step Conversion),"funnel, conversion, steps, wizard, onboarding","1. Hero, 2. Step 1 (problem), 3. Step 2 (solution), 4. Step 3 (action), 5. CTA progression",Each step: mini-CTA. Final: main CTA,"Step colors: 1 (Red/Problem), 2 (Orange/Process), 3 (Green/Solution). CTA: Brand color","Step number animations, progress bar fill, step transitions smooth scroll",Progressive disclosure. Show only essential info per step. Use progress indicators. Multiple CTAs.
+6,Comparison Table + CTA,"comparison, table, compare, versus, cta","1. Hero, 2. Problem intro, 3. Comparison table (product vs competitors), 4. Pricing (optional), 5. CTA",Table: Right column. CTA: Below table,Table: Alternating rows (white/light grey). Your product: Highlight #FFFACD (light yellow) or green. Text: Dark,"Table row hover highlight, price toggle animations, feature checkmark animations",Use comparison to show unique value. Highlight your product row. Include 'free trial' in pricing row.
+7,Lead Magnet + Form,"lead, form, signup, capture, email, magnet","1. Hero (benefit headline), 2. Lead magnet preview (ebook cover, checklist, etc), 3. Form (minimal fields), 4. CTA submit",Form CTA: Submit button,Lead magnet: Professional design. Form: Clean white bg. Inputs: Light border #CCCCCC. CTA: Brand color,"Form focus state animations, input validation animations, success confirmation animation",Form fields ≤ 3 for best conversion. Offer valuable lead magnet preview. Show form submission progress.
+8,Pricing Page + CTA,"pricing, plans, tiers, comparison, cta","1. Hero (pricing headline), 2. Price comparison cards, 3. Feature comparison table, 4. FAQ section, 5. Final CTA",Each card: CTA button. Sticky CTA in nav,"Free: Grey, Starter: Blue, Pro: Green/Gold, Enterprise: Dark. Cards: 1px border, shadow","Price toggle animation (monthly/yearly), card comparison highlight, FAQ accordion open/close",Recommend starter plan (pre-select/highlight). Show annual discount (20-30%). Use FAQs to address concerns.
+9,Video-First Hero,"video, hero, media, visual, engaging","1. Hero with video background, 2. Key features overlay, 3. Benefits section, 4. CTA",Overlay on video (center/bottom) + Bottom section,Dark overlay 60% on video. Brand accent for CTA. White text on dark.,"Video autoplay muted, parallax scroll, text fade-in on scroll",86% higher engagement with video. Add captions for accessibility. Compress video for performance.
+10,Scroll-Triggered Storytelling,"storytelling, scroll, narrative, story, immersive","1. Intro hook, 2. Chapter 1 (problem), 3. Chapter 2 (journey), 4. Chapter 3 (solution), 5. Climax CTA",End of each chapter (mini) + Final climax CTA,Progressive reveal. Each chapter has distinct color. Building intensity.,"ScrollTrigger animations, parallax layers, progressive disclosure, chapter transitions",Narrative increases time-on-page 3x. Use progress indicator. Mobile: simplify animations.
+11,AI Personalization Landing,"ai, personalization, smart, recommendation, dynamic","1. Dynamic hero (personalized), 2. Relevant features, 3. Tailored testimonials, 4. Smart CTA",Context-aware placement based on user segment,Adaptive based on user data. A/B test color variations per segment.,"Dynamic content swap, fade transitions, personalized product recommendations",20%+ conversion with personalization. Requires analytics integration. Fallback for new users.
+12,Waitlist/Coming Soon,"waitlist, coming-soon, launch, early-access, notify","1. Hero with countdown, 2. Product teaser/preview, 3. Email capture form, 4. Social proof (waitlist count)",Email form prominent (above fold) + Sticky form on scroll,Anticipation: Dark + accent highlights. Countdown in brand color. Urgency indicators.,"Countdown timer animation, email validation feedback, success confetti, social share buttons",Scarcity + exclusivity. Show waitlist count. Early access benefits. Referral program.
+13,Comparison Table Focus,"comparison, table, versus, compare, features","1. Hero (problem statement), 2. Comparison matrix (you vs competitors), 3. Feature deep-dive, 4. Winner CTA",After comparison table (highlighted row) + Bottom,Your product column highlighted (accent bg or green). Competitors neutral. Checkmarks green.,"Table row hover highlight, feature checkmark animations, sticky comparison header",Show value vs competitors. 35% higher conversion. Be factual. Include pricing if favorable.
+14,Pricing-Focused Landing,"pricing, price, cost, plans, subscription","1. Hero (value proposition), 2. Pricing cards (3 tiers), 3. Feature comparison, 4. FAQ, 5. Final CTA",Each pricing card + Sticky CTA in nav + Bottom,Popular plan highlighted (brand color border/bg). Free: grey. Enterprise: dark/premium.,"Price toggle monthly/annual animation, card hover lift, FAQ accordion smooth open",Annual discount 20-30%. Recommend mid-tier (most popular badge). Address objections in FAQ.
+15,App Store Style Landing,"app, mobile, download, store, install","1. Hero with device mockup, 2. Screenshots carousel, 3. Features with icons, 4. Reviews/ratings, 5. Download CTAs",Download buttons prominent (App Store + Play Store) throughout,Dark/light matching app store feel. Star ratings in gold. Screenshots with device frames.,"Device mockup rotations, screenshot slider, star rating animations, download button pulse",Show real screenshots. Include ratings (4.5+ stars). QR code for mobile. Platform-specific CTAs.
+16,FAQ/Documentation Landing,"faq, documentation, help, support, questions","1. Hero with search bar, 2. Popular categories, 3. FAQ accordion, 4. Contact/support CTA",Search bar prominent + Contact CTA for unresolved questions,"Clean, high readability. Minimal color. Category icons in brand color. Success green for resolved.","Search autocomplete, smooth accordion open/close, category hover, helpful feedback buttons",Reduce support tickets. Track search analytics. Show related articles. Contact escalation path.
+17,Immersive/Interactive Experience,"immersive, interactive, experience, 3d, animation","1. Full-screen interactive element, 2. Guided product tour, 3. Key benefits revealed, 4. CTA after completion",After interaction complete + Skip option for impatient users,Immersive experience colors. Dark background for focus. Highlight interactive elements.,"WebGL, 3D interactions, gamification elements, progress indicators, reward animations",40% higher engagement. Performance trade-off. Provide skip option. Mobile fallback essential.
+18,Event/Conference Landing,"event, conference, meetup, registration, schedule","1. Hero (date/location/countdown), 2. Speakers grid, 3. Agenda/schedule, 4. Sponsors, 5. Register CTA",Register CTA sticky + After speakers + Bottom,Urgency colors (countdown). Event branding. Speaker cards professional. Sponsor logos neutral.,"Countdown timer, speaker hover cards with bio, agenda tabs, early bird countdown",Early bird pricing with deadline. Social proof (past attendees). Speaker credibility. Multi-ticket discounts.
+19,Product Review/Ratings Focused,"reviews, ratings, testimonials, social-proof, stars","1. Hero (product + aggregate rating), 2. Rating breakdown, 3. Individual reviews, 4. Buy/CTA",After reviews summary + Buy button alongside reviews,Trust colors. Star ratings gold. Verified badge green. Review sentiment colors.,"Star fill animations, review filtering, helpful vote interactions, photo lightbox",User-generated content builds trust. Show verified purchases. Filter by rating. Respond to negative reviews.
+20,Community/Forum Landing,"community, forum, social, members, discussion","1. Hero (community value prop), 2. Popular topics/categories, 3. Active members showcase, 4. Join CTA",Join button prominent + After member showcase,"Warm, welcoming. Member photos add humanity. Topic badges in brand colors. Activity indicators green.","Member avatars animation, activity feed live updates, topic hover previews, join success celebration","Show active community (member count, posts today). Highlight benefits. Preview content. Easy onboarding."
+21,Before-After Transformation,"before-after, transformation, results, comparison","1. Hero (problem state), 2. Transformation slider/comparison, 3. How it works, 4. Results CTA",After transformation reveal + Bottom,Contrast: muted/grey (before) vs vibrant/colorful (after). Success green for results.,"Slider comparison interaction, before/after reveal animations, result counters, testimonial videos",Visual proof of value. 45% higher conversion. Real results. Specific metrics. Guarantee offer.
+22,Marketplace / Directory,"marketplace, directory, search, listing","1. Hero (Search focused), 2. Categories, 3. Featured Listings, 4. Trust/Safety, 5. CTA (Become a host/seller)",Hero Search Bar + Navbar 'List your item',Search: High contrast. Categories: Visual icons. Trust: Blue/Green.,Search autocomplete animation, map hover pins, card carousel,Search bar is the CTA. Reduce friction to search. Popular searches suggestions.
+23,Newsletter / Content First,"newsletter, content, writer, blog, subscribe","1. Hero (Value Prop + Form), 2. Recent Issues/Archives, 3. Social Proof (Subscriber count), 4. About Author",Hero inline form + Sticky header form,Minimalist. Paper-like background. Text focus. Accent color for Subscribe.,Text highlight animations, typewriter effect, subtle fade-in,Single field form (Email only). Show 'Join X,000 readers'. Read sample link.
+24,Webinar Registration,"webinar, registration, event, training, live","1. Hero (Topic + Timer + Form), 2. What you'll learn, 3. Speaker Bio, 4. Urgency/Bonuses, 5. Form (again)",Hero (Right side form) + Bottom anchor,Urgency: Red/Orange. Professional: Blue/Navy. Form: High contrast white.,Countdown timer, speaker avatar float, urgent ticker,Limited seats logic. 'Live' indicator. Auto-fill timezone.
+25,Enterprise Gateway,"enterprise, corporate, gateway, solutions, portal","1. Hero (Video/Mission), 2. Solutions by Industry, 3. Solutions by Role, 4. Client Logos, 5. Contact Sales",Contact Sales (Primary) + Login (Secondary),Corporate: Navy/Grey. High integrity. Conservative accents.,Slow video background, logo carousel, tab switching for industries,Path selection (I am a...). Mega menu navigation. Trust signals prominent.
+26,Portfolio Grid,"portfolio, grid, showcase, gallery, masonry","1. Hero (Name/Role), 2. Project Grid (Masonry), 3. About/Philosophy, 4. Contact",Project Card Hover + Footer Contact,Neutral background (let work shine). Text: Black/White. Accent: Minimal.,Image lazy load reveal, hover overlay info, lightbox view,Visuals first. Filter by category. Fast loading essential.
+27,Horizontal Scroll Journey,"horizontal, scroll, journey, gallery, storytelling, panoramic","1. Intro (Vertical), 2. The Journey (Horizontal Track), 3. Detail Reveal, 4. Vertical Footer","Floating Sticky CTA or End of Horizontal Track","Continuous palette transition. Chapter colors. Progress bar #000000.","Scroll-jacking (careful), parallax layers, horizontal slide, progress indicator","Immersive product discovery. High engagement. Keep navigation visible.
+28,Bento Grid Showcase,"bento, grid, features, modular, apple-style, showcase","1. Hero, 2. Bento Grid (Key Features), 3. Detail Cards, 4. Tech Specs, 5. CTA","Floating Action Button or Bottom of Grid","Card backgrounds: #F5F5F7 or Glass. Icons: Vibrant brand colors. Text: Dark.","Hover card scale (1.02), video inside cards, tilt effect, staggered reveal","Scannable value props. High information density without clutter. Mobile stack.
+29,Interactive 3D Configurator,"3d, configurator, customizer, interactive, product","1. Hero (Configurator), 2. Feature Highlight (synced), 3. Price/Specs, 4. Purchase","Inside Configurator UI + Sticky Bottom Bar","Neutral studio background. Product: Realistic materials. UI: Minimal overlay.","Real-time rendering, material swap animation, camera rotate/zoom, light reflection","Increases ownership feeling. 360 view reduces return rates. Direct add-to-cart.
+30,AI-Driven Dynamic Landing,"ai, dynamic, personalized, adaptive, generative","1. Prompt/Input Hero, 2. Generated Result Preview, 3. How it Works, 4. Value Prop","Input Field (Hero) + 'Try it' Buttons","Adaptive to user input. Dark mode for compute feel. Neon accents.","Typing text effects, shimmering generation loaders, morphing layouts","Immediate value demonstration. 'Show, don't tell'. Low friction start.
\ No newline at end of file
diff --git a/.agents/skills/ui-ux-pro-max/data/products.csv b/.agents/skills/ui-ux-pro-max/data/products.csv
new file mode 100644
index 0000000..3f95afd
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/products.csv
@@ -0,0 +1,97 @@
+No,Product Type,Keywords,Primary Style Recommendation,Secondary Styles,Landing Page Pattern,Dashboard Style (if applicable),Color Palette Focus,Key Considerations
+1,SaaS (General),"app, b2b, cloud, general, saas, software, subscription",Glassmorphism + Flat Design,"Soft UI Evolution, Minimalism",Hero + Features + CTA,Data-Dense + Real-Time Monitoring,Trust blue + accent contrast,Balance modern feel with clarity. Focus on CTAs.
+2,Micro SaaS,"app, b2b, cloud, indie, micro, micro-saas, niche, saas, small, software, solo, subscription",Flat Design + Vibrant & Block,"Motion-Driven, Micro-interactions",Minimal & Direct + Demo,Executive Dashboard,Vibrant primary + white space,"Keep simple, show product quickly. Speed is key."
+3,E-commerce,"buy, commerce, e, ecommerce, products, retail, sell, shop, store",Vibrant & Block-based,"Aurora UI, Motion-Driven",Feature-Rich Showcase,Sales Intelligence Dashboard,Brand primary + success green,Engagement & conversions. High visual hierarchy.
+4,E-commerce Luxury,"buy, commerce, e, ecommerce, elegant, exclusive, high-end, luxury, premium, products, retail, sell, shop, store",Liquid Glass + Glassmorphism,"3D & Hyperrealism, Aurora UI",Feature-Rich Showcase,Sales Intelligence Dashboard,Premium colors + minimal accent,Elegance & sophistication. Premium materials.
+5,Service Landing Page,"appointment, booking, consultation, conversion, landing, marketing, page, service",Hero-Centric + Trust & Authority,"Social Proof-Focused, Storytelling",Hero-Centric Design,N/A - Analytics for conversions,Brand primary + trust colors,Social proof essential. Show expertise.
+6,B2B Service,"appointment, b, b2b, booking, business, consultation, corporate, enterprise, service",Trust & Authority + Minimal,"Feature-Rich, Conversion-Optimized",Feature-Rich Showcase,Sales Intelligence Dashboard,Professional blue + neutral grey,Credibility essential. Clear ROI messaging.
+7,Financial Dashboard,"admin, analytics, dashboard, data, financial, panel",Dark Mode (OLED) + Data-Dense,"Minimalism, Accessible & Ethical",N/A - Dashboard focused,Financial Dashboard,Dark bg + red/green alerts + trust blue,"High contrast, real-time updates, accuracy paramount."
+8,Analytics Dashboard,"admin, analytics, dashboard, data, panel",Data-Dense + Heat Map & Heatmap,"Minimalism, Dark Mode (OLED)",N/A - Analytics focused,Drill-Down Analytics + Comparative,Cool→Hot gradients + neutral grey,Clarity > aesthetics. Color-coded data priority.
+9,Healthcare App,"app, clinic, health, healthcare, medical, patient",Neumorphism + Accessible & Ethical,"Soft UI Evolution, Claymorphism (for patients)",Social Proof-Focused,User Behavior Analytics,Calm blue + health green + trust,Accessibility mandatory. Calming aesthetic.
+10,Educational App,"app, course, education, educational, learning, school, training",Claymorphism + Micro-interactions,"Vibrant & Block-based, Flat Design",Storytelling-Driven,User Behavior Analytics,Playful colors + clear hierarchy,Engagement & ease of use. Age-appropriate design.
+11,Creative Agency,"agency, creative, design, marketing, studio",Brutalism + Motion-Driven,"Retro-Futurism, Storytelling-Driven",Storytelling-Driven,N/A - Portfolio focused,Bold primaries + artistic freedom,Differentiation key. Wow-factor necessary.
+12,Portfolio/Personal,"creative, personal, portfolio, projects, showcase, work",Motion-Driven + Minimalism,"Brutalism, Aurora UI",Storytelling-Driven,N/A - Personal branding,Brand primary + artistic interpretation,Showcase work. Personality shine through.
+13,Gaming,"entertainment, esports, game, gaming, play",3D & Hyperrealism + Retro-Futurism,"Motion-Driven, Vibrant & Block",Feature-Rich Showcase,N/A - Game focused,Vibrant + neon + immersive colors,Immersion priority. Performance critical.
+14,Government/Public Service,"appointment, booking, consultation, government, public, service",Accessible & Ethical + Minimalism,"Flat Design, Inclusive Design",Minimal & Direct,Executive Dashboard,Professional blue + high contrast,WCAG AAA mandatory. Trust paramount.
+15,Fintech/Crypto,"banking, blockchain, crypto, defi, finance, fintech, money, nft, payment, web3",Glassmorphism + Dark Mode (OLED),"Retro-Futurism, Motion-Driven",Conversion-Optimized,Real-Time Monitoring + Predictive,Dark tech colors + trust + vibrant accents,Security perception. Real-time data critical.
+16,Social Media App,"app, community, content, entertainment, media, network, sharing, social, streaming, users, video",Vibrant & Block-based + Motion-Driven,"Aurora UI, Micro-interactions",Feature-Rich Showcase,User Behavior Analytics,Vibrant + engagement colors,Engagement & retention. Addictive design ethics.
+17,Productivity Tool,"collaboration, productivity, project, task, tool, workflow",Flat Design + Micro-interactions,"Minimalism, Soft UI Evolution",Interactive Product Demo,Drill-Down Analytics,Clear hierarchy + functional colors,Ease of use. Speed & efficiency focus.
+18,Design System/Component Library,"component, design, library, system",Minimalism + Accessible & Ethical,"Flat Design, Zero Interface",Feature-Rich Showcase,N/A - Dev focused,Clear hierarchy + code-like structure,Consistency. Developer-first approach.
+19,AI/Chatbot Platform,"ai, artificial-intelligence, automation, chatbot, machine-learning, ml, platform",AI-Native UI + Minimalism,"Zero Interface, Glassmorphism",Interactive Product Demo,AI/ML Analytics Dashboard,Neutral + AI Purple (#6366F1),Conversational UI. Streaming text. Context awareness. Minimal chrome.
+20,NFT/Web3 Platform,"nft, platform, web",Cyberpunk UI + Glassmorphism,"Aurora UI, 3D & Hyperrealism",Feature-Rich Showcase,Crypto/Blockchain Dashboard,Dark + Neon + Gold (#FFD700),Wallet integration. Transaction feedback. Gas fees display. Dark mode essential.
+21,Creator Economy Platform,"creator, economy, platform",Vibrant & Block-based + Bento Box Grid,"Motion-Driven, Aurora UI",Social Proof-Focused,User Behavior Analytics,Vibrant + Brand colors,Creator profiles. Monetization display. Engagement metrics. Social proof.
+22,Sustainability/ESG Platform,"ai, artificial-intelligence, automation, esg, machine-learning, ml, platform, sustainability",Organic Biophilic + Minimalism,"Accessible & Ethical, Flat Design",Trust & Authority,Energy/Utilities Dashboard,Green (#228B22) + Earth tones,Carbon footprint visuals. Progress indicators. Certification badges. Eco-friendly imagery.
+23,Remote Work/Collaboration Tool,"collaboration, remote, tool, work",Soft UI Evolution + Minimalism,"Glassmorphism, Micro-interactions",Feature-Rich Showcase,Drill-Down Analytics,Calm Blue + Neutral grey,Real-time collaboration. Status indicators. Video integration. Notification management.
+24,Mental Health App,"app, health, mental",Neumorphism + Accessible & Ethical,"Claymorphism, Soft UI Evolution",Social Proof-Focused,Healthcare Analytics,Calm Pastels + Trust colors,Calming aesthetics. Privacy-first. Crisis resources. Progress tracking. Accessibility mandatory.
+25,Pet Tech App,"app, pet, tech",Claymorphism + Vibrant & Block-based,"Micro-interactions, Flat Design",Storytelling-Driven,User Behavior Analytics,Playful + Warm colors,Pet profiles. Health tracking. Playful UI. Photo galleries. Vet integration.
+26,Smart Home/IoT Dashboard,"admin, analytics, dashboard, data, home, iot, panel, smart",Glassmorphism + Dark Mode (OLED),"Minimalism, AI-Native UI",Interactive Product Demo,Real-Time Monitoring,Dark + Status indicator colors,Device status. Real-time controls. Energy monitoring. Automation rules. Quick actions.
+27,EV/Charging Ecosystem,"charging, ecosystem, ev",Minimalism + Aurora UI,"Glassmorphism, Organic Biophilic",Hero-Centric Design,Energy/Utilities Dashboard,Electric Blue (#009CD1) + Green,Charging station maps. Range estimation. Cost calculation. Environmental impact.
+28,Subscription Box Service,"appointment, booking, box, consultation, membership, plan, recurring, service, subscription",Vibrant & Block-based + Motion-Driven,"Claymorphism, Aurora UI",Feature-Rich Showcase,E-commerce Analytics,Brand + Excitement colors,Unboxing experience. Personalization quiz. Subscription management. Product reveals.
+29,Podcast Platform,"platform, podcast",Dark Mode (OLED) + Minimalism,"Motion-Driven, Vibrant & Block-based",Storytelling-Driven,Media/Entertainment Dashboard,Dark + Audio waveform accents,Audio player UX. Episode discovery. Creator tools. Analytics for podcasters.
+30,Dating App,"app, dating",Vibrant & Block-based + Motion-Driven,"Aurora UI, Glassmorphism",Social Proof-Focused,User Behavior Analytics,Warm + Romantic (Pink/Red gradients),Profile cards. Swipe interactions. Match animations. Safety features. Video chat.
+31,Micro-Credentials/Badges Platform,"badges, credentials, micro, platform",Minimalism + Flat Design,"Accessible & Ethical, Swiss Modernism 2.0",Trust & Authority,Education Dashboard,Trust Blue + Gold (#FFD700),Credential verification. Badge display. Progress tracking. Issuer trust. LinkedIn integration.
+32,Knowledge Base/Documentation,"base, documentation, knowledge",Minimalism + Accessible & Ethical,"Swiss Modernism 2.0, Flat Design",FAQ/Documentation,N/A - Documentation focused,Clean hierarchy + minimal color,Search-first. Clear navigation. Code highlighting. Version switching. Feedback system.
+33,Hyperlocal Services,"appointment, booking, consultation, hyperlocal, service, services",Minimalism + Vibrant & Block-based,"Micro-interactions, Flat Design",Conversion-Optimized,Drill-Down Analytics + Map,Location markers + Trust colors,Map integration. Service categories. Provider profiles. Booking system. Reviews.
+34,Beauty/Spa/Wellness Service,"appointment, beauty, booking, consultation, service, spa, wellness",Soft UI Evolution + Neumorphism,"Glassmorphism, Minimalism",Hero-Centric Design + Social Proof,User Behavior Analytics,Soft pastels (Pink #FFB6C1 Sage #90EE90) + Cream + Gold accents,Calming aesthetic. Booking system. Service menu. Before/after gallery. Testimonials. Relaxing imagery.
+35,Luxury/Premium Brand,"brand, elegant, exclusive, high-end, luxury, premium",Liquid Glass + Glassmorphism,"Minimalism, 3D & Hyperrealism",Storytelling-Driven + Feature-Rich,Sales Intelligence Dashboard,Black + Gold (#FFD700) + White + Minimal accent,Elegance paramount. Premium imagery. Storytelling. High-quality visuals. Exclusive feel.
+36,Restaurant/Food Service,"appointment, booking, consultation, delivery, food, menu, order, restaurant, service",Vibrant & Block-based + Motion-Driven,"Claymorphism, Flat Design",Hero-Centric Design + Conversion,N/A - Booking focused,Warm colors (Orange Red Brown) + appetizing imagery,Menu display. Online ordering. Reservation system. Food photography. Location/hours prominent.
+37,Fitness/Gym App,"app, exercise, fitness, gym, health, workout",Vibrant & Block-based + Dark Mode (OLED),"Motion-Driven, Neumorphism",Feature-Rich Showcase,User Behavior Analytics,Energetic (Orange #FF6B35 Electric Blue) + Dark bg,Progress tracking. Workout plans. Community features. Achievements. Motivational design.
+38,Real Estate/Property,"buy, estate, housing, property, real, real-estate, rent",Glassmorphism + Minimalism,"Motion-Driven, 3D & Hyperrealism",Hero-Centric Design + Feature-Rich,Sales Intelligence Dashboard,Trust Blue (#0077B6) + Gold accents + White,Property listings. Virtual tours. Map integration. Agent profiles. Mortgage calculator. High-quality imagery.
+39,Travel/Tourism Agency,"agency, booking, creative, design, flight, hotel, marketing, studio, tourism, travel, vacation",Aurora UI + Motion-Driven,"Vibrant & Block-based, Glassmorphism",Storytelling-Driven + Hero-Centric,Booking Analytics,Vibrant destination colors + Sky Blue + Warm accents,Destination showcase. Booking system. Itinerary builder. Reviews. Inspiration galleries. Mobile-first.
+40,Hotel/Hospitality,"hospitality, hotel",Liquid Glass + Minimalism,"Glassmorphism, Soft UI Evolution",Hero-Centric Design + Social Proof,Revenue Management Dashboard,Warm neutrals + Gold (#D4AF37) + Brand accent,Room booking. Amenities showcase. Location maps. Guest reviews. Seasonal pricing. Luxury imagery.
+41,Wedding/Event Planning,"conference, event, meetup, planning, registration, ticket, wedding",Soft UI Evolution + Aurora UI,"Glassmorphism, Motion-Driven",Storytelling-Driven + Social Proof,N/A - Planning focused,Soft Pink (#FFD6E0) + Gold + Cream + Sage,Portfolio gallery. Vendor directory. Planning tools. Timeline. Budget tracker. Romantic aesthetic.
+42,Legal Services,"appointment, attorney, booking, compliance, consultation, contract, law, legal, service, services",Trust & Authority + Minimalism,"Accessible & Ethical, Swiss Modernism 2.0",Trust & Authority + Minimal,Case Management Dashboard,Navy Blue (#1E3A5F) + Gold + White,Credibility paramount. Practice areas. Attorney profiles. Case results. Contact forms. Professional imagery.
+43,Insurance Platform,"insurance, platform",Trust & Authority + Flat Design,"Accessible & Ethical, Minimalism",Conversion-Optimized + Trust,Claims Analytics Dashboard,Trust Blue (#0066CC) + Green (security) + Neutral,Quote calculator. Policy comparison. Claims process. Trust signals. Clear pricing. Security badges.
+44,Banking/Traditional Finance,"banking, finance, traditional",Minimalism + Accessible & Ethical,"Trust & Authority, Dark Mode (OLED)",Trust & Authority + Feature-Rich,Financial Dashboard,Navy (#0A1628) + Trust Blue + Gold accents,Security-first. Account overview. Transaction history. Mobile banking. Accessibility critical. Trust paramount.
+45,Online Course/E-learning,"course, e, learning, online",Claymorphism + Vibrant & Block-based,"Motion-Driven, Flat Design",Feature-Rich Showcase + Social Proof,Education Dashboard,Vibrant learning colors + Progress green,Course catalog. Progress tracking. Video player. Quizzes. Certificates. Community forums. Gamification.
+46,Non-profit/Charity,"charity, non, profit",Accessible & Ethical + Organic Biophilic,"Minimalism, Storytelling-Driven",Storytelling-Driven + Trust,Donation Analytics Dashboard,Cause-related colors + Trust + Warm,Impact stories. Donation flow. Transparency reports. Volunteer signup. Event calendar. Emotional connection.
+47,Music Streaming,"music, streaming",Dark Mode (OLED) + Vibrant & Block-based,"Motion-Driven, Aurora UI",Feature-Rich Showcase,Media/Entertainment Dashboard,Dark (#121212) + Vibrant accents + Album art colors,Audio player. Playlist management. Artist pages. Personalization. Social features. Waveform visualizations.
+48,Video Streaming/OTT,"ott, streaming, video",Dark Mode (OLED) + Motion-Driven,"Glassmorphism, Vibrant & Block-based",Hero-Centric Design + Feature-Rich,Media/Entertainment Dashboard,Dark bg + Content poster colors + Brand accent,Video player. Content discovery. Watchlist. Continue watching. Personalized recommendations. Thumbnail-heavy.
+49,Job Board/Recruitment,"board, job, recruitment",Flat Design + Minimalism,"Vibrant & Block-based, Accessible & Ethical",Conversion-Optimized + Feature-Rich,HR Analytics Dashboard,Professional Blue + Success Green + Neutral,Job listings. Search/filter. Company profiles. Application tracking. Resume upload. Salary insights.
+50,Marketplace (P2P),"buyers, listings, marketplace, p, platform, sellers",Vibrant & Block-based + Flat Design,"Micro-interactions, Trust & Authority",Feature-Rich Showcase + Social Proof,E-commerce Analytics,Trust colors + Category colors + Success green,Seller/buyer profiles. Listings. Reviews/ratings. Secure payment. Messaging. Search/filter. Trust badges.
+51,Logistics/Delivery,"delivery, logistics",Minimalism + Flat Design,"Dark Mode (OLED), Micro-interactions",Feature-Rich Showcase + Conversion,Real-Time Monitoring + Route Analytics,Blue (#2563EB) + Orange (tracking) + Green (delivered),Real-time tracking. Delivery scheduling. Route optimization. Driver management. Status updates. Map integration.
+52,Agriculture/Farm Tech,"agriculture, farm, tech",Organic Biophilic + Flat Design,"Minimalism, Accessible & Ethical",Feature-Rich Showcase + Trust,IoT Sensor Dashboard,Earth Green (#4A7C23) + Brown + Sky Blue,Crop monitoring. Weather data. IoT sensors. Yield tracking. Market prices. Sustainable imagery.
+53,Construction/Architecture,"architecture, construction",Minimalism + 3D & Hyperrealism,"Brutalism, Swiss Modernism 2.0",Hero-Centric Design + Feature-Rich,Project Management Dashboard,Grey (#4A4A4A) + Orange (safety) + Blueprint Blue,Project portfolio. 3D renders. Timeline. Material specs. Team collaboration. Blueprint aesthetic.
+54,Automotive/Car Dealership,"automotive, car, dealership",Motion-Driven + 3D & Hyperrealism,"Dark Mode (OLED), Glassmorphism",Hero-Centric Design + Feature-Rich,Sales Intelligence Dashboard,Brand colors + Metallic accents + Dark/Light,Vehicle showcase. 360° views. Comparison tools. Financing calculator. Test drive booking. High-quality imagery.
+55,Photography Studio,"photography, studio",Motion-Driven + Minimalism,"Aurora UI, Glassmorphism",Storytelling-Driven + Hero-Centric,N/A - Portfolio focused,Black + White + Minimal accent,Portfolio gallery. Before/after. Service packages. Booking system. Client galleries. Full-bleed imagery.
+56,Coworking Space,"coworking, space",Vibrant & Block-based + Glassmorphism,"Minimalism, Motion-Driven",Hero-Centric Design + Feature-Rich,Occupancy Dashboard,Energetic colors + Wood tones + Brand accent,Space tour. Membership plans. Booking system. Amenities. Community events. Virtual tour.
+57,Cleaning Service,"appointment, booking, cleaning, consultation, service",Soft UI Evolution + Flat Design,"Minimalism, Micro-interactions",Conversion-Optimized + Trust,Service Analytics,Fresh Blue (#00B4D8) + Clean White + Green,Service packages. Booking system. Price calculator. Before/after gallery. Reviews. Trust badges.
+58,Home Services (Plumber/Electrician),"appointment, booking, consultation, electrician, home, plumber, service, services",Flat Design + Trust & Authority,"Minimalism, Accessible & Ethical",Conversion-Optimized + Trust,Service Analytics,Trust Blue + Safety Orange + Professional grey,Service list. Emergency contact. Booking. Price transparency. Certifications. Local trust signals.
+59,Childcare/Daycare,"childcare, daycare",Claymorphism + Vibrant & Block-based,"Soft UI Evolution, Accessible & Ethical",Social Proof-Focused + Trust,Parent Dashboard,Playful pastels + Safe colors + Warm accents,Programs. Staff profiles. Safety certifications. Parent portal. Activity updates. Cheerful imagery.
+60,Senior Care/Elderly,"care, elderly, senior",Accessible & Ethical + Soft UI Evolution,"Minimalism, Neumorphism",Trust & Authority + Social Proof,Healthcare Analytics,Calm Blue + Warm neutrals + Large text,Care services. Staff qualifications. Facility tour. Family portal. Large touch targets. High contrast. Accessibility-first.
+61,Medical Clinic,"clinic, medical",Accessible & Ethical + Minimalism,"Neumorphism, Trust & Authority",Trust & Authority + Conversion,Healthcare Analytics,Medical Blue (#0077B6) + Trust White + Calm Green,Services. Doctor profiles. Online booking. Patient portal. Insurance info. HIPAA compliant. Trust signals.
+62,Pharmacy/Drug Store,"drug, pharmacy, store",Flat Design + Accessible & Ethical,"Minimalism, Trust & Authority",Conversion-Optimized + Trust,Inventory Dashboard,Pharmacy Green + Trust Blue + Clean White,Product catalog. Prescription upload. Refill reminders. Health info. Store locator. Safety certifications.
+63,Dental Practice,"dental, practice",Soft UI Evolution + Minimalism,"Accessible & Ethical, Trust & Authority",Social Proof-Focused + Conversion,Patient Analytics,Fresh Blue + White + Smile Yellow accent,Services. Dentist profiles. Before/after. Online booking. Insurance. Patient testimonials. Friendly imagery.
+64,Veterinary Clinic,"clinic, veterinary",Claymorphism + Accessible & Ethical,"Soft UI Evolution, Flat Design",Social Proof-Focused + Trust,Pet Health Dashboard,Caring Blue + Pet-friendly colors + Warm accents,Pet services. Vet profiles. Online booking. Pet portal. Emergency info. Friendly animal imagery.
+65,Florist/Plant Shop,"florist, plant, shop",Organic Biophilic + Vibrant & Block-based,"Aurora UI, Motion-Driven",Hero-Centric Design + Conversion,E-commerce Analytics,Natural Green + Floral pinks/purples + Earth tones,Product catalog. Occasion categories. Delivery scheduling. Care guides. Seasonal collections. Beautiful imagery.
+66,Bakery/Cafe,"bakery, cafe",Vibrant & Block-based + Soft UI Evolution,"Claymorphism, Motion-Driven",Hero-Centric Design + Conversion,N/A - Order focused,Warm Brown + Cream + Appetizing accents,Menu display. Online ordering. Location/hours. Catering. Seasonal specials. Appetizing photography.
+67,Coffee Shop,"coffee, shop",Minimalism + Organic Biophilic,"Soft UI Evolution, Flat Design",Hero-Centric Design + Conversion,N/A - Order focused,Coffee Brown (#6F4E37) + Cream + Warm accents,Menu. Online ordering. Loyalty program. Location. Story/origin. Cozy aesthetic.
+68,Brewery/Winery,"brewery, winery",Motion-Driven + Storytelling-Driven,"Dark Mode (OLED), Organic Biophilic",Storytelling-Driven + Hero-Centric,N/A - E-commerce focused,Deep amber/burgundy + Gold + Craft aesthetic,Product showcase. Story/heritage. Tasting notes. Events. Club membership. Artisanal imagery.
+69,Airline,"ai, airline, artificial-intelligence, automation, machine-learning, ml",Minimalism + Glassmorphism,"Motion-Driven, Accessible & Ethical",Conversion-Optimized + Feature-Rich,Operations Dashboard,Sky Blue + Brand colors + Trust accents,Flight search. Booking. Check-in. Boarding pass. Loyalty program. Route maps. Mobile-first.
+70,News/Media Platform,"content, entertainment, media, news, platform, streaming, video",Minimalism + Flat Design,"Dark Mode (OLED), Accessible & Ethical",Hero-Centric Design + Feature-Rich,Media Analytics Dashboard,Brand colors + High contrast + Category colors,Article layout. Breaking news. Categories. Search. Subscription. Mobile reading. Fast loading.
+71,Magazine/Blog,"articles, blog, content, magazine, posts, writing",Swiss Modernism 2.0 + Motion-Driven,"Minimalism, Aurora UI",Storytelling-Driven + Hero-Centric,Content Analytics,Editorial colors + Brand primary + Clean white,Article showcase. Category navigation. Author profiles. Newsletter signup. Related content. Typography-focused.
+72,Freelancer Platform,"freelancer, platform",Flat Design + Minimalism,"Vibrant & Block-based, Micro-interactions",Feature-Rich Showcase + Conversion,Marketplace Analytics,Professional Blue + Success Green + Neutral,Profile creation. Portfolio. Skill matching. Messaging. Payment. Reviews. Project management.
+73,Consulting Firm,"consulting, firm",Trust & Authority + Minimalism,"Swiss Modernism 2.0, Accessible & Ethical",Trust & Authority + Feature-Rich,N/A - Lead generation,Navy + Gold + Professional grey,Service areas. Case studies. Team profiles. Thought leadership. Contact. Professional credibility.
+74,Marketing Agency,"agency, creative, design, marketing, studio",Brutalism + Motion-Driven,"Vibrant & Block-based, Aurora UI",Storytelling-Driven + Feature-Rich,Campaign Analytics,Bold brand colors + Creative freedom,Portfolio. Case studies. Services. Team. Creative showcase. Results-focused. Bold aesthetic.
+75,Event Management,"conference, event, management, meetup, registration, ticket",Vibrant & Block-based + Motion-Driven,"Glassmorphism, Aurora UI",Hero-Centric Design + Feature-Rich,Event Analytics,Event theme colors + Excitement accents,Event showcase. Registration. Agenda. Speakers. Sponsors. Ticket sales. Countdown timer.
+76,Conference/Webinar Platform,"conference, platform, webinar",Glassmorphism + Minimalism,"Motion-Driven, Flat Design",Feature-Rich Showcase + Conversion,Attendee Analytics,Professional Blue + Video accent + Brand,Registration. Agenda. Speaker profiles. Live stream. Networking. Recording access. Virtual event features.
+77,Membership/Community,"community, membership",Vibrant & Block-based + Soft UI Evolution,"Bento Box Grid, Micro-interactions",Social Proof-Focused + Conversion,Community Analytics,Community brand colors + Engagement accents,Member benefits. Pricing tiers. Community showcase. Events. Member directory. Exclusive content.
+78,Newsletter Platform,"newsletter, platform",Minimalism + Flat Design,"Swiss Modernism 2.0, Accessible & Ethical",Minimal & Direct + Conversion,Email Analytics,Brand primary + Clean white + CTA accent,Subscribe form. Archive. About. Social proof. Sample content. Simple conversion.
+79,Digital Products/Downloads,"digital, downloads, products",Vibrant & Block-based + Motion-Driven,"Glassmorphism, Bento Box Grid",Feature-Rich Showcase + Conversion,E-commerce Analytics,Product category colors + Brand + Success green,Product showcase. Preview. Pricing. Instant delivery. License management. Customer reviews.
+80,Church/Religious Organization,"church, organization, religious",Accessible & Ethical + Soft UI Evolution,"Minimalism, Trust & Authority",Hero-Centric Design + Social Proof,N/A - Community focused,Warm Gold + Deep Purple/Blue + White,Service times. Events. Sermons. Community. Giving. Location. Welcoming imagery.
+81,Sports Team/Club,"club, sports, team",Vibrant & Block-based + Motion-Driven,"Dark Mode (OLED), 3D & Hyperrealism",Hero-Centric Design + Feature-Rich,Performance Analytics,Team colors + Energetic accents,Schedule. Roster. News. Tickets. Merchandise. Fan engagement. Action imagery.
+82,Museum/Gallery,"gallery, museum",Minimalism + Motion-Driven,"Swiss Modernism 2.0, 3D & Hyperrealism",Storytelling-Driven + Feature-Rich,Visitor Analytics,Art-appropriate neutrals + Exhibition accents,Exhibitions. Collections. Tickets. Events. Virtual tours. Educational content. Art-focused design.
+83,Theater/Cinema,"cinema, theater",Dark Mode (OLED) + Motion-Driven,"Vibrant & Block-based, Glassmorphism",Hero-Centric Design + Conversion,Booking Analytics,Dark + Spotlight accents + Gold,Showtimes. Seat selection. Trailers. Coming soon. Membership. Dramatic imagery.
+84,Language Learning App,"app, language, learning",Claymorphism + Vibrant & Block-based,"Micro-interactions, Flat Design",Feature-Rich Showcase + Social Proof,Learning Analytics,Playful colors + Progress indicators + Country flags,Lesson structure. Progress tracking. Gamification. Speaking practice. Community. Achievement badges.
+85,Coding Bootcamp,"bootcamp, coding",Dark Mode (OLED) + Minimalism,"Cyberpunk UI, Flat Design",Feature-Rich Showcase + Social Proof,Student Analytics,Code editor colors + Brand + Success green,Curriculum. Projects. Career outcomes. Alumni. Pricing. Application. Terminal aesthetic.
+86,Cybersecurity Platform,"cyber, security, platform",Cyberpunk UI + Dark Mode (OLED),"Neubrutalism, Minimal & Direct",Trust & Authority + Real-Time,Real-Time Monitoring + Heat Map,Matrix Green + Deep Black + Terminal feel,Data density. Threat visualization. Dark mode default.
+87,Developer Tool / IDE,"dev, developer, tool, ide",Dark Mode (OLED) + Minimalism,"Flat Design, Bento Box Grid",Minimal & Direct + Documentation,Real-Time Monitor + Terminal,Dark syntax theme colors + Blue focus,Keyboard shortcuts. Syntax highlighting. Fast performance.
+88,Biotech / Life Sciences,"biotech, biology, science",Glassmorphism + Clean Science,"Minimalism, Organic Biophilic",Storytelling-Driven + Research,Data-Dense + Predictive,Sterile White + DNA Blue + Life Green,Data accuracy. Cleanliness. Complex data viz.
+89,Space Tech / Aerospace,"aerospace, space, tech",Holographic / HUD + Dark Mode,"Glassmorphism, 3D & Hyperrealism",Immersive Experience + Hero,Real-Time Monitoring + 3D,Deep Space Black + Star White + Metallic,High-tech feel. Precision. Telemetry data.
+90,Architecture / Interior,"architecture, design, interior",Exaggerated Minimalism + High Imagery,"Swiss Modernism 2.0, Parallax",Portfolio Grid + Visuals,Project Management + Gallery,Monochrome + Gold Accent + High Imagery,High-res images. Typography. Space.
+91,Quantum Computing Interface,"quantum, computing, physics, qubit, future, science",Holographic / HUD + Dark Mode,"Glassmorphism, Spatial UI",Immersive/Interactive Experience,3D Spatial Data + Real-Time Monitor,Quantum Blue #00FFFF + Deep Black + Interference patterns,Visualize complexity. Qubit states. Probability clouds. High-tech trust.
+92,Biohacking / Longevity App,"biohacking, health, longevity, tracking, wellness, science",Biomimetic / Organic 2.0,"Minimalism, Dark Mode (OLED)",Data-Dense + Storytelling,Real-Time Monitor + Biological Data,Cellular Pink/Red + DNA Blue + Clean White,Personal data privacy. Scientific credibility. Biological visualizations.
+93,Autonomous Drone Fleet Manager,"drone, autonomous, fleet, aerial, logistics, robotics",HUD / Sci-Fi FUI,"Real-Time Monitor, Spatial UI",Real-Time Monitor,Geographic + Real-Time,Tactical Green #00FF00 + Alert Red + Map Dark,Real-time telemetry. 3D spatial awareness. Latency indicators. Safety alerts.
+94,Generative Art Platform,"art, generative, ai, creative, platform, gallery",Minimalism (Frame) + Gen Z Chaos,"Masonry Grid, Dark Mode",Bento Grid Showcase,Gallery / Portfolio,Neutral #F5F5F5 (Canvas) + User Content,Content is king. Fast loading. Creator attribution. Minting flow.
+95,Spatial Computing OS / App,"spatial, vr, ar, vision, os, immersive, mixed-reality",Spatial UI (VisionOS),"Glassmorphism, 3D & Hyperrealism",Immersive/Interactive Experience,Spatial Dashboard,Frosted Glass + System Colors + Depth,Gaze/Pinch interaction. Depth hierarchy. Environment awareness.
+96,Sustainable Energy / Climate Tech,"climate, energy, sustainable, green, tech, carbon",Organic Biophilic + E-Ink / Paper,"Data-Dense, Swiss Modernism",Interactive Demo + Data,Energy/Utilities Dashboard,Earth Green + Sky Blue + Solar Yellow,Data transparency. Impact visualization. Low-carbon web design.
\ No newline at end of file
diff --git a/.agents/skills/ui-ux-pro-max/data/prompts.csv b/.agents/skills/ui-ux-pro-max/data/prompts.csv
new file mode 100644
index 0000000..5028192
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/prompts.csv
@@ -0,0 +1,24 @@
+STT,Style Category,AI Prompt Keywords (Copy-Paste Ready),CSS/Technical Keywords,Implementation Checklist,Design System Variables
+1,Minimalism & Swiss Style,"Design a minimalist landing page. Use: white space, geometric layouts, sans-serif fonts, high contrast, grid-based structure, essential elements only. Avoid shadows and gradients. Focus on clarity and functionality.","display: grid, gap: 2rem, font-family: sans-serif, color: #000 or #FFF, max-width: 1200px, clean borders, no box-shadow unless necessary","☐ Grid-based layout 12-16 columns, ☐ Typography hierarchy clear, ☐ No unnecessary decorations, ☐ WCAG AAA contrast verified, ☐ Mobile responsive grid","--spacing: 2rem, --border-radius: 0px, --font-weight: 400-700, --shadow: none, --accent-color: single primary only"
+2,Neumorphism,"Create a neumorphic UI with soft 3D effects. Use light pastels, rounded corners (12-16px), subtle soft shadows (multiple layers), no hard lines, monochromatic color scheme with light/dark variations. Embossed/debossed effect on interactive elements.","border-radius: 12-16px, box-shadow: -5px -5px 15px rgba(0,0,0,0.1), 5px 5px 15px rgba(255,255,255,0.8), background: linear-gradient(145deg, color1, color2), transform: scale on press","☐ Rounded corners 12-16px consistent, ☐ Multiple shadow layers (2-3), ☐ Pastel color verified, ☐ Monochromatic palette checked, ☐ Press animation smooth 150ms","--border-radius: 14px, --shadow-soft-1: -5px -5px 15px, --shadow-soft-2: 5px 5px 15px, --color-light: #F5F5F5, --color-primary: single pastel"
+3,Glassmorphism,"Design a glassmorphic interface with frosted glass effect. Use backdrop blur (10-20px), translucent overlays (rgba 10-30% opacity), vibrant background colors, subtle borders, light source reflection, layered depth. Perfect for modern overlays and cards.","backdrop-filter: blur(15px), background: rgba(255, 255, 255, 0.15), border: 1px solid rgba(255,255,255,0.2), -webkit-backdrop-filter: blur(15px), z-index layering for depth","☐ Backdrop-filter blur 10-20px, ☐ Translucent white 15-30% opacity, ☐ Subtle border 1px light, ☐ Vibrant background verified, ☐ Text contrast 4.5:1 checked","--blur-amount: 15px, --glass-opacity: 0.15, --border-color: rgba(255,255,255,0.2), --background: vibrant color, --text-color: light/dark based on BG"
+4,Brutalism,"Create a brutalist design with raw, unpolished, stark aesthetic. Use pure primary colors (red, blue, yellow), black & white, no smooth transitions (instant), sharp corners, bold large typography, visible grid lines, default system fonts, intentional 'broken' design elements.","border-radius: 0px, transition: none or 0s, font-family: system-ui or monospace, font-weight: 700+, border: visible 2-4px, colors: #FF0000, #0000FF, #FFFF00, #000000, #FFFFFF","☐ No border-radius (0px), ☐ No transitions (instant), ☐ Bold typography (700+), ☐ Pure primary colors used, ☐ Visible grid/borders, ☐ Asymmetric layout intentional","--border-radius: 0px, --transition-duration: 0s, --font-weight: 700-900, --colors: primary only, --border-style: visible, --grid-visible: true"
+5,3D & Hyperrealism,"Build an immersive 3D interface using realistic textures, 3D models (Three.js/Babylon.js), complex shadows, realistic lighting, parallax scrolling (3-5 layers), physics-based motion. Include skeuomorphic elements with tactile detail.","transform: translate3d, perspective: 1000px, WebGL canvas, Three.js/Babylon.js library, box-shadow: complex multi-layer, background: complex gradients, filter: drop-shadow()","☐ WebGL/Three.js integrated, ☐ 3D models loaded, ☐ Parallax 3-5 layers, ☐ Realistic lighting verified, ☐ Complex shadows rendered, ☐ Physics animation smooth 300-400ms","--perspective: 1000px, --parallax-layers: 5, --lighting-intensity: realistic, --shadow-depth: 20-40%, --animation-duration: 300-400ms"
+6,Vibrant & Block-based,"Design an energetic, vibrant interface with bold block layouts, geometric shapes, high color contrast, large typography (32px+), animated background patterns, duotone effects. Perfect for startups and youth-focused apps. Use 4-6 contrasting colors from complementary/triadic schemes.","display: flex/grid with large gaps (48px+), font-size: 32px+, background: animated patterns (CSS), color: neon/vibrant colors, animation: continuous pattern movement","☐ Block layout with 48px+ gaps, ☐ Large typography 32px+, ☐ 4-6 vibrant colors max, ☐ Animated patterns active, ☐ Scroll-snap enabled, ☐ High contrast verified (7:1+)","--block-gap: 48px, --typography-size: 32px+, --color-palette: 4-6 vibrant colors, --animation: continuous pattern, --contrast-ratio: 7:1+"
+7,Dark Mode (OLED),"Create an OLED-optimized dark interface with deep black (#000000), dark grey (#121212), midnight blue accents. Use minimal glow effects, vibrant neon accents (green, blue, gold, purple), high contrast text. Optimize for eye comfort and OLED power saving.","background: #000000 or #121212, color: #FFFFFF or #E0E0E0, text-shadow: 0 0 10px neon-color (sparingly), filter: brightness(0.8) if needed, color-scheme: dark","☐ Deep black #000000 or #121212, ☐ Vibrant neon accents used, ☐ Text contrast 7:1+, ☐ Minimal glow effects, ☐ OLED power optimization, ☐ No white (#FFFFFF) background","--bg-black: #000000, --bg-dark-grey: #121212, --text-primary: #FFFFFF, --accent-neon: neon colors, --glow-effect: minimal, --oled-optimized: true"
+8,Accessible & Ethical,"Design with WCAG AAA compliance. Include: high contrast (7:1+), large text (16px+), keyboard navigation, screen reader compatibility, focus states visible (3-4px ring), semantic HTML, ARIA labels, skip links, reduced motion support (prefers-reduced-motion), 44x44px touch targets.","color-contrast: 7:1+, font-size: 16px+, outline: 3-4px on :focus-visible, aria-label, role attributes, @media (prefers-reduced-motion), touch-target: 44x44px, cursor: pointer","☐ WCAG AAA verified, ☐ 7:1+ contrast checked, ☐ Keyboard navigation tested, ☐ Screen reader tested, ☐ Focus visible 3-4px, ☐ Semantic HTML used, ☐ Touch targets 44x44px","--contrast-ratio: 7:1, --font-size-min: 16px, --focus-ring: 3-4px, --touch-target: 44x44px, --wcag-level: AAA, --keyboard-accessible: true, --sr-tested: true"
+9,Claymorphism,"Design a playful, toy-like interface with soft 3D, chunky elements, bubbly aesthetic, rounded edges (16-24px), thick borders (3-4px), double shadows (inner + outer), pastel colors, smooth animations. Perfect for children's apps and creative tools.","border-radius: 16-24px, border: 3-4px solid, box-shadow: inset -2px -2px 8px, 4px 4px 8px, background: pastel-gradient, animation: soft bounce (cubic-bezier 0.34, 1.56)","☐ Border-radius 16-24px, ☐ Thick borders 3-4px, ☐ Double shadows (inner+outer), ☐ Pastel colors used, ☐ Soft bounce animations, ☐ Playful interactions","--border-radius: 20px, --border-width: 3-4px, --shadow-inner: inset -2px -2px 8px, --shadow-outer: 4px 4px 8px, --color-palette: pastels, --animation: bounce"
+10,Aurora UI,"Create a vibrant gradient interface inspired by Northern Lights with mesh gradients, smooth color blends, flowing animations. Use complementary color pairs (blue-orange, purple-yellow), flowing background gradients, subtle continuous animations (8-12s loops), iridescent effects.","background: conic-gradient or radial-gradient with multiple stops, animation: @keyframes gradient (8-12s), background-size: 200% 200%, filter: saturate(1.2), blend-mode: screen or multiply","☐ Mesh/flowing gradients applied, ☐ 8-12s animation loop, ☐ Complementary colors used, ☐ Smooth color transitions, ☐ Iridescent effect subtle, ☐ Text contrast verified","--gradient-colors: complementary pairs, --animation-duration: 8-12s, --blend-mode: screen, --color-saturation: 1.2, --effect: iridescent, --loop-smooth: true"
+11,Retro-Futurism,"Build a retro-futuristic (cyberpunk/vaporwave) interface with neon colors (blue, pink, cyan), deep black background, 80s aesthetic, CRT scanlines, glitch effects, neon glow text/borders, monospace fonts, geometric patterns. Use neon text-shadow and animated glitch effects.","color: neon colors (#0080FF, #FF006E, #00FFFF), text-shadow: 0 0 10px neon, background: #000 or #1A1A2E, font-family: monospace, animation: glitch (skew+offset), filter: hue-rotate","☐ Neon colors used, ☐ CRT scanlines effect, ☐ Glitch animations active, ☐ Monospace font, ☐ Deep black background, ☐ Glow effects applied, ☐ 80s patterns present","--neon-colors: #0080FF #FF006E #00FFFF, --background: #000000, --font-family: monospace, --effect: glitch+glow, --scanline-opacity: 0.3, --crt-effect: true"
+12,Flat Design,"Create a flat, 2D interface with bold colors, no shadows/gradients, clean lines, simple geometric shapes, icon-heavy, typography-focused, minimal ornamentation. Use 4-6 solid, bright colors in a limited palette with high saturation.","box-shadow: none, background: solid color, border-radius: 0-4px, color: solid (no gradients), fill: solid, stroke: 1-2px, font: bold sans-serif, icons: simplified SVG","☐ No shadows/gradients, ☐ 4-6 solid colors max, ☐ Clean lines consistent, ☐ Simple shapes used, ☐ Icon-heavy layout, ☐ High saturation colors, ☐ Fast loading verified","--shadow: none, --color-palette: 4-6 solid, --border-radius: 2px, --gradient: none, --icons: simplified SVG, --animation: minimal 150-200ms"
+13,Skeuomorphism,"Design a realistic, textured interface with 3D depth, real-world metaphors (leather, wood, metal), complex gradients (8-12 stops), realistic shadows, grain/texture overlays, tactile press animations. Perfect for premium/luxury products.","background: complex gradient (8-12 stops), box-shadow: realistic multi-layer, background-image: texture overlay (noise, grain), filter: drop-shadow, transform: scale on press (300-500ms)","☐ Realistic textures applied, ☐ Complex gradients 8-12 stops, ☐ Multi-layer shadows, ☐ Texture overlays present, ☐ Tactile animations smooth, ☐ Depth effect pronounced","--gradient-stops: 8-12, --texture-overlay: noise+grain, --shadow-layers: 3+, --animation-duration: 300-500ms, --depth-effect: pronounced, --tactile: true"
+14,Liquid Glass,"Create a premium liquid glass effect with morphing shapes, flowing animations, chromatic aberration, iridescent gradients, smooth 400-600ms transitions. Use SVG morphing for shape changes, dynamic blur, smooth color transitions creating a fluid, premium feel.","animation: morphing SVG paths (400-600ms), backdrop-filter: blur + saturate, filter: hue-rotate + brightness, blend-mode: screen, background: iridescent gradient","☐ Morphing animations 400-600ms, ☐ Chromatic aberration applied, ☐ Dynamic blur active, ☐ Iridescent gradients, ☐ Smooth color transitions, ☐ Premium feel achieved","--morph-duration: 400-600ms, --blur-amount: 15px, --chromatic-aberration: true, --iridescent: true, --blend-mode: screen, --smooth-transitions: true"
+15,Motion-Driven,"Build an animation-heavy interface with scroll-triggered animations, microinteractions, parallax scrolling (3-5 layers), smooth transitions (300-400ms), entrance animations, page transitions. Use Intersection Observer for scroll effects, transform for performance, GPU acceleration.","animation: @keyframes scroll-reveal, transform: translateY/X, Intersection Observer API, will-change: transform, scroll-behavior: smooth, animation-duration: 300-400ms","☐ Scroll animations active, ☐ Parallax 3-5 layers, ☐ Entrance animations smooth, ☐ Page transitions fluid, ☐ GPU accelerated, ☐ Prefers-reduced-motion respected","--animation-duration: 300-400ms, --parallax-layers: 5, --scroll-behavior: smooth, --gpu-accelerated: true, --entrance-animation: true, --page-transition: smooth"
+16,Micro-interactions,"Design with delightful micro-interactions: small 50-100ms animations, gesture-based responses, tactile feedback, loading spinners, success/error states, subtle hover effects, haptic feedback triggers for mobile. Focus on responsive, contextual interactions.","animation: short 50-100ms, transition: hover states, @media (hover: hover) for desktop, :active for press, haptic-feedback CSS/API, loading animation smooth loop","☐ Micro-animations 50-100ms, ☐ Gesture-responsive, ☐ Tactile feedback visual/haptic, ☐ Loading spinners smooth, ☐ Success/error states clear, ☐ Hover effects subtle","--micro-animation-duration: 50-100ms, --gesture-responsive: true, --haptic-feedback: true, --loading-animation: smooth, --state-feedback: success+error"
+17,Inclusive Design,"Design for universal accessibility: high contrast (7:1+), large text (16px+), keyboard-only navigation, screen reader optimization, WCAG AAA compliance, symbol-based color indicators (not color-only), haptic feedback, voice interaction support, reduced motion options.","aria-* attributes complete, role attributes semantic, focus-visible: 3-4px ring, color-contrast: 7:1+, @media (prefers-reduced-motion), alt text on all images, form labels properly associated","☐ WCAG AAA verified, ☐ 7:1+ contrast all text, ☐ Keyboard accessible (Tab/Enter), ☐ Screen reader tested, ☐ Focus visible 3-4px, ☐ No color-only indicators, ☐ Haptic fallback","--contrast-ratio: 7:1, --font-size: 16px+, --keyboard-accessible: true, --sr-compatible: true, --wcag-level: AAA, --color-symbols: true, --haptic: enabled"
+18,Zero Interface,"Create a voice-first, gesture-based, AI-driven interface with minimal visible UI, progressive disclosure, voice recognition UI, gesture detection, AI predictions, smart suggestions, context-aware actions. Hide controls until needed.","voice-commands: Web Speech API, gesture-detection: touch events, AI-predictions: hidden by default (reveal on hover), progressive-disclosure: show on demand, minimal UI visible","☐ Voice commands responsive, ☐ Gesture detection active, ☐ AI predictions hidden/revealed, ☐ Progressive disclosure working, ☐ Minimal visible UI, ☐ Smart suggestions contextual","--voice-ui: enabled, --gesture-detection: active, --ai-predictions: smart, --progressive-disclosure: true, --visible-ui: minimal, --context-aware: true"
+19,Soft UI Evolution,"Design evolved neumorphism with improved contrast (WCAG AA+), modern aesthetics, subtle depth, accessibility focus. Use soft shadows (softer than flat but clearer than pure neumorphism), better color hierarchy, improved focus states, modern 200-300ms animations.","box-shadow: softer multi-layer (0 2px 4px), background: improved contrast pastels, border-radius: 8-12px, animation: 200-300ms smooth, outline: 2-3px on focus, contrast: 4.5:1+","☐ Improved contrast AA/AAA, ☐ Soft shadows modern, ☐ Border-radius 8-12px, ☐ Animations 200-300ms, ☐ Focus states visible, ☐ Color hierarchy clear","--shadow-soft: modern blend, --border-radius: 10px, --animation-duration: 200-300ms, --contrast-ratio: 4.5:1+, --color-hierarchy: improved, --wcag-level: AA+"
+20,Bento Grids,"Design a Bento Grid layout. Use: modular grid system, rounded corners (16-24px), different card sizes (1x1, 2x1, 2x2), card-based hierarchy, soft backgrounds (#F5F5F7), subtle borders, content-first, Apple-style aesthetic.","display: grid, grid-template-columns: repeat(auto-fit, minmax(...)), gap: 1rem, border-radius: 20px, background: #FFF, box-shadow: subtle","☐ Grid layout (CSS Grid), ☐ Rounded corners 16-24px, ☐ Varied card spans, ☐ Content fits card size, ☐ Responsive re-flow, ☐ Apple-like aesthetic","--grid-gap: 20px, --card-radius: 24px, --card-bg: #FFFFFF, --page-bg: #F5F5F7, --shadow: soft"
+21,Neubrutalism,"Design a neubrutalist interface. Use: high contrast, hard black borders (3px+), bright pop colors, no blur, sharp or slightly rounded corners, bold typography, hard shadows (offset 4px 4px), raw aesthetic but functional.","border: 3px solid black, box-shadow: 5px 5px 0px black, colors: #FFDB58 #FF6B6B #4ECDC4, font-weight: 700, no gradients","☐ Hard borders (2-4px), ☐ Hard offset shadows, ☐ High saturation colors, ☐ Bold typography, ☐ No blurs/gradients, ☐ Distinctive 'ugly-cute' look","--border-width: 3px, --shadow-offset: 4px, --shadow-color: #000, --colors: high saturation, --font: bold sans"
+22,HUD / Sci-Fi FUI,"Design a futuristic HUD (Heads Up Display) or FUI. Use: thin lines (1px), neon cyan/blue on black, technical markers, decorative brackets, data visualization, monospaced tech fonts, glowing elements, transparency.","border: 1px solid rgba(0,255,255,0.5), color: #00FFFF, background: transparent or rgba(0,0,0,0.8), font-family: monospace, text-shadow: 0 0 5px cyan","☐ Fine lines 1px, ☐ Neon glow text/borders, ☐ Monospaced font, ☐ Dark/Transparent BG, ☐ Decorative tech markers, ☐ Holographic feel","--hud-color: #00FFFF, --bg-color: rgba(0,10,20,0.9), --line-width: 1px, --glow: 0 0 5px, --font: monospace"
+23,Pixel Art,"Design a pixel art inspired interface. Use: pixelated fonts, 8-bit or 16-bit aesthetic, sharp edges (image-rendering: pixelated), limited color palette, blocky UI elements, retro gaming feel.","font-family: 'Press Start 2P', image-rendering: pixelated, box-shadow: 4px 0 0 #000 (pixel border), no anti-aliasing","☐ Pixelated fonts loaded, ☐ Images sharp (no blur), ☐ CSS box-shadow for pixel borders, ☐ Retro palette, ☐ Blocky layout","--pixel-size: 4px, --font: pixel font, --border-style: pixel-shadow, --anti-alias: none"
diff --git a/.agents/skills/ui-ux-pro-max/data/react-performance.csv b/.agents/skills/ui-ux-pro-max/data/react-performance.csv
new file mode 100644
index 0000000..671465f
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/react-performance.csv
@@ -0,0 +1,45 @@
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Async Waterfall,Defer Await,async await defer branch,React/Next.js,Move await into branches where actually used to avoid blocking unused code paths,Move await operations into branches where they're needed,Await at top of function blocking all branches,"if (skip) return { skipped: true }; const data = await fetch()","const data = await fetch(); if (skip) return { skipped: true }",Critical
+2,Async Waterfall,Promise.all Parallel,promise all parallel concurrent,React/Next.js,Execute independent async operations concurrently using Promise.all(),Use Promise.all() for independent operations,Sequential await for independent operations,"const [user, posts] = await Promise.all([fetchUser(), fetchPosts()])","const user = await fetchUser(); const posts = await fetchPosts()",Critical
+3,Async Waterfall,Dependency Parallelization,better-all dependency parallel,React/Next.js,Use better-all for operations with partial dependencies to maximize parallelism,Use better-all to start each task at earliest possible moment,Wait for unrelated data before starting dependent fetch,"await all({ user() {}, config() {}, profile() { return fetch((await this.$.user).id) } })","const [user, config] = await Promise.all([...]); const profile = await fetchProfile(user.id)",Critical
+4,Async Waterfall,API Route Optimization,api route waterfall promise,React/Next.js,In API routes start independent operations immediately even if not awaited yet,Start promises early and await late,Sequential awaits in API handlers,"const sessionP = auth(); const configP = fetchConfig(); const session = await sessionP","const session = await auth(); const config = await fetchConfig()",Critical
+5,Async Waterfall,Suspense Boundaries,suspense streaming boundary,React/Next.js,Use Suspense to show wrapper UI faster while data loads,Wrap async components in Suspense boundaries,Await data blocking entire page render,"<Suspense fallback={<Skeleton />}><DataDisplay /></Suspense>","const data = await fetchData(); return <DataDisplay data={data} />",High
+6,Bundle Size,Barrel Imports,barrel import direct path,React/Next.js,Import directly from source files instead of barrel files to avoid loading unused modules,Import directly from source path,Import from barrel/index files,"import Check from 'lucide-react/dist/esm/icons/check'","import { Check } from 'lucide-react'",Critical
+7,Bundle Size,Dynamic Imports,dynamic import lazy next,React/Next.js,Use next/dynamic to lazy-load large components not needed on initial render,Use dynamic() for heavy components,Import heavy components at top level,"const Monaco = dynamic(() => import('./monaco'), { ssr: false })","import { MonacoEditor } from './monaco-editor'",Critical
+8,Bundle Size,Defer Third Party,analytics defer third-party,React/Next.js,Load analytics and logging after hydration since they don't block interaction,Load non-critical scripts after hydration,Include analytics in main bundle,"const Analytics = dynamic(() => import('@vercel/analytics'), { ssr: false })","import { Analytics } from '@vercel/analytics/react'",Medium
+9,Bundle Size,Conditional Loading,conditional module lazy,React/Next.js,Load large data or modules only when a feature is activated,Dynamic import when feature enabled,Import large modules unconditionally,"useEffect(() => { if (enabled) import('./heavy.js') }, [enabled])","import { heavyData } from './heavy.js'",High
+10,Bundle Size,Preload Intent,preload hover focus intent,React/Next.js,Preload heavy bundles on hover/focus before they're needed,Preload on user intent signals,Load only on click,"onMouseEnter={() => import('./editor')}","onClick={() => import('./editor')}",Medium
+11,Server,React.cache Dedup,react cache deduplicate request,React/Next.js,Use React.cache() for server-side request deduplication within single request,Wrap data fetchers with cache(),Fetch same data multiple times in tree,"export const getUser = cache(async () => await db.user.find())","export async function getUser() { return await db.user.find() }",Medium
+12,Server,LRU Cache Cross-Request,lru cache cross request,React/Next.js,Use LRU cache for data shared across sequential requests,Use LRU for cross-request caching,Refetch same data on every request,"const cache = new LRUCache({ max: 1000, ttl: 5*60*1000 })","Always fetch from database",High
+13,Server,Minimize Serialization,serialization rsc boundary,React/Next.js,Only pass fields that client actually uses across RSC boundaries,Pass only needed fields to client components,Pass entire objects to client,"<Profile name={user.name} />","<Profile user={user} /> // 50 fields serialized",High
+14,Server,Parallel Fetching,parallel fetch component composition,React/Next.js,Restructure components to parallelize data fetching in RSC,Use component composition for parallel fetches,Sequential fetches in parent component,"<Header /><Sidebar /> // both fetch in parallel","const header = await fetchHeader(); return <><div>{header}</div><Sidebar /></>",Critical
+15,Server,After Non-blocking,after non-blocking logging,React/Next.js,Use Next.js after() to schedule work after response is sent,Use after() for logging/analytics,Block response for non-critical operations,"after(async () => { await logAction() }); return Response.json(data)","await logAction(); return Response.json(data)",Medium
+16,Client,SWR Deduplication,swr dedup cache revalidate,React/Next.js,Use SWR for automatic request deduplication and caching,Use useSWR for client data fetching,Manual fetch in useEffect,"const { data } = useSWR('/api/users', fetcher)","useEffect(() => { fetch('/api/users').then(setUsers) }, [])",Medium-High
+17,Client,Event Listener Dedup,event listener deduplicate global,React/Next.js,Share global event listeners across component instances,Use useSWRSubscription for shared listeners,Register listener per component instance,"useSWRSubscription('global-keydown', () => { window.addEventListener... })","useEffect(() => { window.addEventListener('keydown', handler) }, [])",Low
+18,Rerender,Defer State Reads,state read callback subscription,React/Next.js,Don't subscribe to state only used in callbacks,Read state on-demand in callbacks,Subscribe to state used only in handlers,"const handleClick = () => { const params = new URLSearchParams(location.search) }","const params = useSearchParams(); const handleClick = () => { params.get('ref') }",Medium
+19,Rerender,Memoized Components,memo extract expensive,React/Next.js,Extract expensive work into memoized components for early returns,Extract to memo() components,Compute expensive values before early return,"const UserAvatar = memo(({ user }) => ...); if (loading) return <Skeleton />","const avatar = useMemo(() => compute(user)); if (loading) return <Skeleton />",Medium
+20,Rerender,Narrow Dependencies,effect dependency primitive,React/Next.js,Specify primitive dependencies instead of objects in effects,Use primitive values in dependency arrays,Use object references as dependencies,"useEffect(() => { console.log(user.id) }, [user.id])","useEffect(() => { console.log(user.id) }, [user])",Low
+21,Rerender,Derived State,derived boolean subscription,React/Next.js,Subscribe to derived booleans instead of continuous values,Use derived boolean state,Subscribe to continuous values,"const isMobile = useMediaQuery('(max-width: 767px)')","const width = useWindowWidth(); const isMobile = width < 768",Medium
+22,Rerender,Functional setState,functional setstate callback,React/Next.js,Use functional setState updates for stable callbacks and no stale closures,Use functional form: setState(curr => ...),Reference state directly in setState,"setItems(curr => [...curr, newItem])","setItems([...items, newItem]) // items in deps",Medium
+23,Rerender,Lazy State Init,usestate lazy initialization,React/Next.js,Pass function to useState for expensive initial values,Use function form for expensive init,Compute expensive value directly,"useState(() => buildSearchIndex(items))","useState(buildSearchIndex(items)) // runs every render",Medium
+24,Rerender,Transitions,starttransition non-urgent,React/Next.js,Mark frequent non-urgent state updates as transitions,Use startTransition for non-urgent updates,Block UI on every state change,"startTransition(() => setScrollY(window.scrollY))","setScrollY(window.scrollY) // blocks on every scroll",Medium
+25,Rendering,SVG Animation Wrapper,svg animation wrapper div,React/Next.js,Wrap SVG in div and animate wrapper for hardware acceleration,Animate div wrapper around SVG,Animate SVG element directly,"<div class='animate-spin'><svg>...</svg></div>","<svg class='animate-spin'>...</svg>",Low
+26,Rendering,Content Visibility,content-visibility auto,React/Next.js,Apply content-visibility: auto to defer off-screen rendering,Use content-visibility for long lists,Render all list items immediately,".item { content-visibility: auto; contain-intrinsic-size: 0 80px }","Render 1000 items without optimization",High
+27,Rendering,Hoist Static JSX,hoist static jsx element,React/Next.js,Extract static JSX outside components to avoid re-creation,Hoist static elements to module scope,Create static elements inside components,"const skeleton = <div class='animate-pulse' />; function C() { return skeleton }","function C() { return <div class='animate-pulse' /> }",Low
+28,Rendering,Hydration No Flicker,hydration mismatch flicker,React/Next.js,Use inline script to set client-only data before hydration,Inject sync script for client-only values,Use useEffect causing flash,"<script dangerouslySetInnerHTML={{ __html: 'el.className = localStorage.theme' }} />","useEffect(() => setTheme(localStorage.theme), []) // flickers",Medium
+29,Rendering,Conditional Render,conditional render ternary,React/Next.js,Use ternary instead of && when condition can be 0 or NaN,Use explicit ternary for conditionals,Use && with potentially falsy numbers,"{count > 0 ? <Badge>{count}</Badge> : null}","{count && <Badge>{count}</Badge>} // renders '0'",Low
+30,Rendering,Activity Component,activity show hide preserve,React/Next.js,Use Activity component to preserve state/DOM for toggled components,Use Activity for expensive toggle components,Unmount/remount on visibility toggle,"<Activity mode={isOpen ? 'visible' : 'hidden'}><Menu /></Activity>","{isOpen && <Menu />} // loses state",Medium
+31,JS Perf,Batch DOM CSS,batch dom css reflow,React/Next.js,Group CSS changes via classes or cssText to minimize reflows,Use class toggle or cssText,Change styles one property at a time,"element.classList.add('highlighted')","el.style.width='100px'; el.style.height='200px'",Medium
+32,JS Perf,Index Map Lookup,map index lookup find,React/Next.js,Build Map for repeated lookups instead of multiple .find() calls,Build index Map for O(1) lookups,Use .find() in loops,"const byId = new Map(users.map(u => [u.id, u])); byId.get(id)","users.find(u => u.id === order.userId) // O(n) each time",Low-Medium
+33,JS Perf,Cache Property Access,cache property loop,React/Next.js,Cache object property lookups in hot paths,Cache values before loops,Access nested properties in loops,"const val = obj.config.settings.value; for (...) process(val)","for (...) process(obj.config.settings.value)",Low-Medium
+34,JS Perf,Cache Function Results,memoize cache function,React/Next.js,Use module-level Map to cache repeated function results,Use Map cache for repeated calls,Recompute same values repeatedly,"const cache = new Map(); if (cache.has(x)) return cache.get(x)","slugify(name) // called 100 times same input",Medium
+35,JS Perf,Cache Storage API,localstorage cache read,React/Next.js,Cache localStorage/sessionStorage reads in memory,Cache storage reads in Map,Read storage on every call,"if (!cache.has(key)) cache.set(key, localStorage.getItem(key))","localStorage.getItem('theme') // every call",Low-Medium
+36,JS Perf,Combine Iterations,combine filter map loop,React/Next.js,Combine multiple filter/map into single loop,Single loop for multiple categorizations,Chain multiple filter() calls,"for (u of users) { if (u.isAdmin) admins.push(u); if (u.isTester) testers.push(u) }","users.filter(admin); users.filter(tester); users.filter(inactive)",Low-Medium
+37,JS Perf,Length Check First,length check array compare,React/Next.js,Check array lengths before expensive comparisons,Early return if lengths differ,Always run expensive comparison,"if (a.length !== b.length) return true; // then compare","a.sort().join() !== b.sort().join() // even when lengths differ",Medium-High
+38,JS Perf,Early Return,early return exit function,React/Next.js,Return early when result is determined to skip processing,Return immediately on first error,Process all items then check errors,"for (u of users) { if (!u.email) return { error: 'Email required' } }","let hasError; for (...) { if (!email) hasError=true }; if (hasError)...",Low-Medium
+39,JS Perf,Hoist RegExp,regexp hoist module,React/Next.js,Don't create RegExp inside render - hoist or memoize,Hoist RegExp to module scope,Create RegExp every render,"const EMAIL_RE = /^[^@]+@[^@]+$/; function validate() { EMAIL_RE.test(x) }","function C() { const re = new RegExp(pattern); re.test(x) }",Low-Medium
+40,JS Perf,Loop Min Max,loop min max sort,React/Next.js,Use loop for min/max instead of sort - O(n) vs O(n log n),Single pass loop for min/max,Sort array to find min/max,"let max = arr[0]; for (x of arr) if (x > max) max = x","arr.sort((a,b) => b-a)[0] // O(n log n)",Low
+41,JS Perf,Set Map Lookups,set map includes has,React/Next.js,Use Set/Map for O(1) lookups instead of array.includes(),Convert to Set for membership checks,Use .includes() for repeated checks,"const allowed = new Set(['a','b']); allowed.has(id)","const allowed = ['a','b']; allowed.includes(id)",Low-Medium
+42,JS Perf,toSorted Immutable,tosorted sort immutable,React/Next.js,Use toSorted() instead of sort() to avoid mutating arrays,Use toSorted() for immutability,Mutate arrays with sort(),"users.toSorted((a,b) => a.name.localeCompare(b.name))","users.sort((a,b) => a.name.localeCompare(b.name)) // mutates",Medium-High
+43,Advanced,Event Handler Refs,useeffectevent ref handler,React/Next.js,Store callbacks in refs for stable effect subscriptions,Use useEffectEvent for stable handlers,Re-subscribe on every callback change,"const onEvent = useEffectEvent(handler); useEffect(() => { listen(onEvent) }, [])","useEffect(() => { listen(handler) }, [handler]) // re-subscribes",Low
+44,Advanced,useLatest Hook,uselatest ref callback,React/Next.js,Access latest values in callbacks without adding to dependency arrays,Use useLatest for fresh values in stable callbacks,Add callback to effect dependencies,"const cbRef = useLatest(cb); useEffect(() => { setTimeout(() => cbRef.current()) }, [])","useEffect(() => { setTimeout(() => cb()) }, [cb]) // re-runs",Low
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/flutter.csv b/.agents/skills/ui-ux-pro-max/data/stacks/flutter.csv
new file mode 100644
index 0000000..2e32c6a
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/flutter.csv
@@ -0,0 +1,53 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Widgets,Use StatelessWidget when possible,Immutable widgets are simpler,StatelessWidget for static UI,StatefulWidget for everything,class MyWidget extends StatelessWidget,class MyWidget extends StatefulWidget (static),Medium,https://api.flutter.dev/flutter/widgets/StatelessWidget-class.html
+2,Widgets,Keep widgets small,Single responsibility principle,Extract widgets into smaller pieces,Large build methods,Column(children: [Header() Content()]),500+ line build method,Medium,
+3,Widgets,Use const constructors,Compile-time constants for performance,const MyWidget() when possible,Non-const for static widgets,const Text('Hello'),Text('Hello') for literals,High,https://dart.dev/guides/language/language-tour#constant-constructors
+4,Widgets,Prefer composition over inheritance,Combine widgets using children,Compose widgets,Extend widget classes,Container(child: MyContent()),class MyContainer extends Container,Medium,
+5,State,Use setState correctly,Minimal state in StatefulWidget,setState for UI state changes,setState for business logic,setState(() { _counter++; }),Complex logic in setState,Medium,https://api.flutter.dev/flutter/widgets/State/setState.html
+6,State,Avoid setState in build,Never call setState during build,setState in callbacks only,setState in build method,onPressed: () => setState(() {}),build() { setState(); },High,
+7,State,Use state management for complex apps,Provider Riverpod BLoC,State management for shared state,setState for global state,Provider.of<MyState>(context),Global setState calls,Medium,
+8,State,Prefer Riverpod or Provider,Recommended state solutions,Riverpod for new projects,InheritedWidget manually,ref.watch(myProvider),Custom InheritedWidget,Medium,https://riverpod.dev/
+9,State,Dispose resources,Clean up controllers and subscriptions,dispose() for cleanup,Memory leaks from subscriptions,@override void dispose() { controller.dispose(); },No dispose implementation,High,
+10,Layout,Use Column and Row,Basic layout widgets,Column Row for linear layouts,Stack for simple layouts,"Column(children: [Text(), Button()])",Stack for vertical list,Medium,https://api.flutter.dev/flutter/widgets/Column-class.html
+11,Layout,Use Expanded and Flexible,Control flex behavior,Expanded to fill space,Fixed sizes in flex containers,Expanded(child: Container()),Container(width: 200) in Row,Medium,
+12,Layout,Use SizedBox for spacing,Consistent spacing,SizedBox for gaps,Container for spacing only,SizedBox(height: 16),Container(height: 16),Low,
+13,Layout,Use LayoutBuilder for responsive,Respond to constraints,LayoutBuilder for adaptive layouts,Fixed sizes for responsive,LayoutBuilder(builder: (context constraints) {}),Container(width: 375),Medium,https://api.flutter.dev/flutter/widgets/LayoutBuilder-class.html
+14,Layout,Avoid deep nesting,Keep widget tree shallow,Extract deeply nested widgets,10+ levels of nesting,Extract widget to method or class,Column(Row(Column(Row(...)))),Medium,
+15,Lists,Use ListView.builder,Lazy list building,ListView.builder for long lists,ListView with children for large lists,"ListView.builder(itemCount: 100, itemBuilder: ...)",ListView(children: items.map(...).toList()),High,https://api.flutter.dev/flutter/widgets/ListView-class.html
+16,Lists,Provide itemExtent when known,Skip measurement,itemExtent for fixed height items,No itemExtent for uniform lists,ListView.builder(itemExtent: 50),ListView.builder without itemExtent,Medium,
+17,Lists,Use keys for stateful items,Preserve widget state,Key for stateful list items,No key for dynamic lists,ListTile(key: ValueKey(item.id)),ListTile without key,High,
+18,Lists,Use SliverList for custom scroll,Custom scroll effects,CustomScrollView with Slivers,Nested ListViews,CustomScrollView(slivers: [SliverList()]),ListView inside ListView,Medium,https://api.flutter.dev/flutter/widgets/SliverList-class.html
+19,Navigation,Use Navigator 2.0 or GoRouter,Declarative routing,go_router for navigation,Navigator.push for complex apps,GoRouter(routes: [...]),Navigator.push everywhere,Medium,https://pub.dev/packages/go_router
+20,Navigation,Use named routes,Organized navigation,Named routes for clarity,Anonymous routes,Navigator.pushNamed(context '/home'),Navigator.push(context MaterialPageRoute()),Low,
+21,Navigation,Handle back button (PopScope),Android back behavior and predictive back (Android 14+),Use PopScope widget (WillPopScope is deprecated),Use WillPopScope,"PopScope(canPop: false, onPopInvoked: (didPop) => ...)",WillPopScope(onWillPop: ...),High,https://api.flutter.dev/flutter/widgets/PopScope-class.html
+22,Navigation,Pass typed arguments,Type-safe route arguments,Typed route arguments,Dynamic arguments,MyRoute(id: '123'),arguments: {'id': '123'},Medium,
+23,Async,Use FutureBuilder,Async UI building,FutureBuilder for async data,setState for async,FutureBuilder(future: fetchData()),fetchData().then((d) => setState()),Medium,https://api.flutter.dev/flutter/widgets/FutureBuilder-class.html
+24,Async,Use StreamBuilder,Stream UI building,StreamBuilder for streams,Manual stream subscription,StreamBuilder(stream: myStream),stream.listen in initState,Medium,https://api.flutter.dev/flutter/widgets/StreamBuilder-class.html
+25,Async,Handle loading and error states,Complete async UI states,ConnectionState checks,Only success state,if (snapshot.connectionState == ConnectionState.waiting),No loading indicator,High,
+26,Async,Cancel subscriptions,Clean up stream subscriptions,Cancel in dispose,Memory leaks,subscription.cancel() in dispose,No subscription cleanup,High,
+27,Theming,Use ThemeData,Consistent theming,ThemeData for app theme,Hardcoded colors,Theme.of(context).primaryColor,Color(0xFF123456) everywhere,Medium,https://api.flutter.dev/flutter/material/ThemeData-class.html
+28,Theming,Use ColorScheme,Material 3 color system,ColorScheme for colors,Individual color properties,colorScheme: ColorScheme.fromSeed(),primaryColor: Colors.blue,Medium,
+29,Theming,Access theme via context,Dynamic theme access,Theme.of(context),Static theme reference,Theme.of(context).textTheme.bodyLarge,TextStyle(fontSize: 16),Medium,
+30,Theming,Support dark mode,Respect system theme,darkTheme in MaterialApp,Light theme only,"MaterialApp(theme: light, darkTheme: dark)",MaterialApp(theme: light),Medium,
+31,Animation,Use implicit animations,Simple animations,AnimatedContainer AnimatedOpacity,Explicit for simple transitions,AnimatedContainer(duration: Duration()),AnimationController for fade,Low,https://api.flutter.dev/flutter/widgets/AnimatedContainer-class.html
+32,Animation,Use AnimationController for complex,Fine-grained control,AnimationController with Ticker,Implicit for complex sequences,AnimationController(vsync: this),AnimatedContainer for staggered,Medium,
+33,Animation,Dispose AnimationControllers,Clean up animation resources,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
+34,Animation,Use Hero for transitions,Shared element transitions,Hero for navigation animations,Manual shared element,Hero(tag: 'image' child: Image()),Custom shared element animation,Low,https://api.flutter.dev/flutter/widgets/Hero-class.html
+35,Forms,Use Form widget,Form validation,Form with GlobalKey,Individual validation,Form(key: _formKey child: ...),TextField without Form,Medium,https://api.flutter.dev/flutter/widgets/Form-class.html
+36,Forms,Use TextEditingController,Control text input,Controller for text fields,onChanged for all text,final controller = TextEditingController(),onChanged: (v) => setState(),Medium,
+37,Forms,Validate on submit,Form validation flow,_formKey.currentState!.validate(),Skip validation,if (_formKey.currentState!.validate()),Submit without validation,High,
+38,Forms,Dispose controllers,Clean up text controllers,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
+39,Performance,Use const widgets,Reduce rebuilds,const for static widgets,No const for literals,const Icon(Icons.add),Icon(Icons.add),High,
+40,Performance,Avoid rebuilding entire tree,Minimal rebuild scope,Isolate changing widgets,setState on parent,Consumer only around changing widget,setState on root widget,High,
+41,Performance,Use RepaintBoundary,Isolate repaints,RepaintBoundary for animations,Full screen repaints,RepaintBoundary(child: AnimatedWidget()),Animation without boundary,Medium,https://api.flutter.dev/flutter/widgets/RepaintBoundary-class.html
+42,Performance,Profile with DevTools,Measure before optimizing,Flutter DevTools profiling,Guess at performance,DevTools performance tab,Optimize without measuring,Medium,https://docs.flutter.dev/tools/devtools
+43,Accessibility,Use Semantics widget,Screen reader support,Semantics for accessibility,Missing accessibility info,Semantics(label: 'Submit button'),GestureDetector without semantics,High,https://api.flutter.dev/flutter/widgets/Semantics-class.html
+44,Accessibility,Support large fonts,MediaQuery text scaling,MediaQuery.textScaleFactor,Fixed font sizes,style: Theme.of(context).textTheme,TextStyle(fontSize: 14),High,
+45,Accessibility,Test with screen readers,TalkBack and VoiceOver,Test accessibility regularly,Skip accessibility testing,Regular TalkBack testing,No screen reader testing,High,
+46,Testing,Use widget tests,Test widget behavior,WidgetTester for UI tests,Unit tests only,testWidgets('...' (tester) async {}),Only test() for UI,Medium,https://docs.flutter.dev/testing
+47,Testing,Use integration tests,Full app testing,integration_test package,Manual testing only,IntegrationTestWidgetsFlutterBinding,Manual E2E testing,Medium,
+48,Testing,Mock dependencies,Isolate tests,Mockito or mocktail,Real dependencies in tests,when(mock.method()).thenReturn(),Real API calls in tests,Medium,
+49,Platform,Use Platform checks,Platform-specific code,Platform.isIOS Platform.isAndroid,Same code for all platforms,if (Platform.isIOS) {},Hardcoded iOS behavior,Medium,
+50,Platform,Use kIsWeb for web,Web platform detection,kIsWeb for web checks,Platform for web,if (kIsWeb) {},Platform.isWeb (doesn't exist),Medium,
+51,Packages,Use pub.dev packages,Community packages,Popular maintained packages,Custom implementations,cached_network_image,Custom image cache,Medium,https://pub.dev/
+52,Packages,Check package quality,Quality before adding,Pub points and popularity,Any package without review,100+ pub points,Unmaintained packages,Medium,
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv b/.agents/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv
new file mode 100644
index 0000000..0efe300
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv
@@ -0,0 +1,56 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Animation,Use Tailwind animate utilities,Built-in animations are optimized and respect reduced-motion,Use animate-pulse animate-spin animate-ping,Custom @keyframes for simple effects,animate-pulse,@keyframes pulse {...},Medium,https://tailwindcss.com/docs/animation
+2,Animation,Limit bounce animations,Continuous bounce is distracting and causes motion sickness,Use animate-bounce sparingly on CTAs only,Multiple bounce animations on page,Single CTA with animate-bounce,5+ elements with animate-bounce,High,
+3,Animation,Transition duration,Use appropriate transition speeds for UI feedback,duration-150 to duration-300 for UI,duration-1000 or longer for UI elements,transition-all duration-200,transition-all duration-1000,Medium,https://tailwindcss.com/docs/transition-duration
+4,Animation,Hover transitions,Add smooth transitions on hover state changes,Add transition class with hover states,Instant hover changes without transition,hover:bg-gray-100 transition-colors,hover:bg-gray-100 (no transition),Low,
+5,Z-Index,Use Tailwind z-* scale,Consistent stacking context with predefined scale,z-0 z-10 z-20 z-30 z-40 z-50,Arbitrary z-index values,z-50 for modals,z-[9999],Medium,https://tailwindcss.com/docs/z-index
+6,Z-Index,Fixed elements z-index,Fixed navigation and modals need explicit z-index,z-50 for nav z-40 for dropdowns,Relying on DOM order for stacking,fixed top-0 z-50,fixed top-0 (no z-index),High,
+7,Z-Index,Negative z-index for backgrounds,Use negative z-index for decorative backgrounds,z-[-1] for background elements,Positive z-index for backgrounds,-z-10 for decorative,z-10 for background,Low,
+8,Layout,Container max-width,Limit content width for readability,max-w-7xl mx-auto for main content,Full-width content on large screens,max-w-7xl mx-auto px-4,w-full (no max-width),Medium,https://tailwindcss.com/docs/container
+9,Layout,Responsive padding,Adjust padding for different screen sizes,px-4 md:px-6 lg:px-8,Same padding all sizes,px-4 sm:px-6 lg:px-8,px-8 (same all sizes),Medium,
+10,Layout,Grid gaps,Use consistent gap utilities for spacing,gap-4 gap-6 gap-8,Margins on individual items,grid gap-6,grid with mb-4 on each item,Medium,https://tailwindcss.com/docs/gap
+11,Layout,Flexbox alignment,Use flex utilities for alignment,items-center justify-between,Multiple nested wrappers,flex items-center justify-between,Nested divs for alignment,Low,
+12,Images,Aspect ratio,Maintain consistent image aspect ratios,aspect-video aspect-square,No aspect ratio on containers,aspect-video rounded-lg,No aspect control,Medium,https://tailwindcss.com/docs/aspect-ratio
+13,Images,Object fit,Control image scaling within containers,object-cover object-contain,Stretched distorted images,object-cover w-full h-full,No object-fit,Medium,https://tailwindcss.com/docs/object-fit
+14,Images,Lazy loading,Defer loading of off-screen images,loading='lazy' on images,All images eager load,<img loading='lazy'>,<img> without lazy,High,
+15,Images,Responsive images,Serve appropriate image sizes,srcset and sizes attributes,Same large image all devices,srcset with multiple sizes,4000px image everywhere,High,
+16,Typography,Prose plugin,Use @tailwindcss/typography for rich text,prose prose-lg for article content,Custom styles for markdown,prose prose-lg max-w-none,Custom text styling,Medium,https://tailwindcss.com/docs/typography-plugin
+17,Typography,Line height,Use appropriate line height for readability,leading-relaxed for body text,Default tight line height,leading-relaxed (1.625),leading-none or leading-tight,Medium,https://tailwindcss.com/docs/line-height
+18,Typography,Font size scale,Use consistent text size scale,text-sm text-base text-lg text-xl,Arbitrary font sizes,text-lg,text-[17px],Low,https://tailwindcss.com/docs/font-size
+19,Typography,Text truncation,Handle long text gracefully,truncate or line-clamp-*,Overflow breaking layout,line-clamp-2,No overflow handling,Medium,https://tailwindcss.com/docs/text-overflow
+20,Colors,Opacity utilities,Use color opacity utilities,bg-black/50 text-white/80,Separate opacity class,bg-black/50,bg-black opacity-50,Low,https://tailwindcss.com/docs/background-color
+21,Colors,Dark mode,Support dark mode with dark: prefix,dark:bg-gray-900 dark:text-white,No dark mode support,dark:bg-gray-900,Only light theme,Medium,https://tailwindcss.com/docs/dark-mode
+22,Colors,Semantic colors,Use semantic color naming in config,primary secondary danger success,Generic color names in components,bg-primary,bg-blue-500 everywhere,Medium,
+23,Spacing,Consistent spacing scale,Use Tailwind spacing scale consistently,p-4 m-6 gap-8,Arbitrary pixel values,p-4 (1rem),p-[15px],Low,https://tailwindcss.com/docs/customizing-spacing
+24,Spacing,Negative margins,Use sparingly for overlapping effects,-mt-4 for overlapping elements,Negative margins for layout fixing,-mt-8 for card overlap,-m-2 to fix spacing issues,Medium,
+25,Spacing,Space between,Use space-y-* for vertical lists,space-y-4 on flex/grid column,Margin on each child,space-y-4,Each child has mb-4,Low,https://tailwindcss.com/docs/space
+26,Forms,Focus states,Always show focus indicators,focus:ring-2 focus:ring-blue-500,Remove focus outline,focus:ring-2 focus:ring-offset-2,focus:outline-none (no replacement),High,
+27,Forms,Input sizing,Consistent input dimensions,h-10 px-3 for inputs,Inconsistent input heights,h-10 w-full px-3,Various heights per input,Medium,
+28,Forms,Disabled states,Clear disabled styling,disabled:opacity-50 disabled:cursor-not-allowed,No disabled indication,disabled:opacity-50,Same style as enabled,Medium,
+29,Forms,Placeholder styling,Style placeholder text appropriately,placeholder:text-gray-400,Dark placeholder text,placeholder:text-gray-400,Default dark placeholder,Low,
+30,Responsive,Mobile-first approach,Start with mobile styles and add breakpoints,Default mobile + md: lg: xl:,Desktop-first approach,text-sm md:text-base,text-base max-md:text-sm,Medium,https://tailwindcss.com/docs/responsive-design
+31,Responsive,Breakpoint testing,Test at standard breakpoints,320 375 768 1024 1280 1536,Only test on development device,Test all breakpoints,Single device testing,High,
+32,Responsive,Hidden/shown utilities,Control visibility per breakpoint,hidden md:block,Different content per breakpoint,hidden md:flex,Separate mobile/desktop components,Low,https://tailwindcss.com/docs/display
+33,Buttons,Button sizing,Consistent button dimensions,px-4 py-2 or px-6 py-3,Inconsistent button sizes,px-4 py-2 text-sm,Various padding per button,Medium,
+34,Buttons,Touch targets,Minimum 44px touch target on mobile,min-h-[44px] on mobile,Small buttons on mobile,min-h-[44px] min-w-[44px],h-8 w-8 on mobile,High,
+35,Buttons,Loading states,Show loading feedback,disabled + spinner icon,Clickable during loading,<Button disabled><Spinner/></Button>,Button without loading state,High,
+36,Buttons,Icon buttons,Accessible icon-only buttons,aria-label on icon buttons,Icon button without label,<button aria-label='Close'><XIcon/></button>,<button><XIcon/></button>,High,
+37,Cards,Card structure,Consistent card styling,rounded-lg shadow-md p-6,Inconsistent card styles,rounded-2xl shadow-lg p-6,Mixed card styling,Low,
+38,Cards,Card hover states,Interactive cards should have hover feedback,hover:shadow-lg transition-shadow,No hover on clickable cards,hover:shadow-xl transition-shadow,Static cards that are clickable,Medium,
+39,Cards,Card spacing,Consistent internal card spacing,space-y-4 for card content,Inconsistent internal spacing,space-y-4 or p-6,Mixed mb-2 mb-4 mb-6,Low,
+40,Accessibility,Screen reader text,Provide context for screen readers,sr-only for hidden labels,Missing context for icons,<span class='sr-only'>Close menu</span>,No label for icon button,High,https://tailwindcss.com/docs/screen-readers
+41,Accessibility,Focus visible,Show focus only for keyboard users,focus-visible:ring-2,Focus on all interactions,focus-visible:ring-2,focus:ring-2 (shows on click too),Medium,
+42,Accessibility,Reduced motion,Respect user motion preferences,motion-reduce:animate-none,Ignore motion preferences,motion-reduce:transition-none,No reduced motion support,High,https://tailwindcss.com/docs/hover-focus-and-other-states#prefers-reduced-motion
+43,Performance,Configure content paths,Tailwind needs to know where classes are used,Use 'content' array in config,Use deprecated 'purge' option (v2),"content: ['./src/**/*.{js,ts,jsx,tsx}']",purge: [...],High,https://tailwindcss.com/docs/content-configuration
+44,Performance,JIT mode,Use JIT for faster builds and smaller bundles,JIT enabled (default in v3),Full CSS in development,Tailwind v3 defaults,Tailwind v2 without JIT,Medium,
+45,Performance,Avoid @apply bloat,Use @apply sparingly,Direct utilities in HTML,Heavy @apply usage,class='px-4 py-2 rounded',@apply px-4 py-2 rounded;,Low,https://tailwindcss.com/docs/reusing-styles
+46,Plugins,Official plugins,Use official Tailwind plugins,@tailwindcss/forms typography aspect-ratio,Custom implementations,@tailwindcss/forms,Custom form reset CSS,Medium,https://tailwindcss.com/docs/plugins
+47,Plugins,Custom utilities,Create utilities for repeated patterns,Custom utility in config,Repeated arbitrary values,Custom shadow utility,"shadow-[0_4px_20px_rgba(0,0,0,0.1)] everywhere",Medium,
+48,Layout,Container Queries,Use @container for component-based responsiveness,Use @container and @lg: etc.,Media queries for component internals,@container @lg:grid-cols-2,@media (min-width: ...) inside component,Medium,https://github.com/tailwindlabs/tailwindcss-container-queries
+49,Interactivity,Group and Peer,Style based on parent/sibling state,group-hover peer-checked,JS for simple state interactions,group-hover:text-blue-500,onMouseEnter={() => setHover(true)},Low,https://tailwindcss.com/docs/hover-focus-and-other-states#styling-based-on-parent-state
+50,Customization,Arbitrary Values,Use [] for one-off values,w-[350px] for specific needs,Creating config for single use,top-[117px] (if strictly needed),style={{ top: '117px' }},Low,https://tailwindcss.com/docs/adding-custom-styles#using-arbitrary-values
+51,Colors,Theme color variables,Define colors in Tailwind theme and use directly,bg-primary text-success border-cta,bg-[var(--color-primary)] text-[var(--color-success)],bg-primary,bg-[var(--color-primary)],Medium,https://tailwindcss.com/docs/customizing-colors
+52,Colors,Use bg-linear-to-* for gradients,Tailwind v4 uses bg-linear-to-* syntax for gradients,bg-linear-to-r bg-linear-to-b,bg-gradient-to-* (deprecated in v4),bg-linear-to-r from-blue-500 to-purple-500,bg-gradient-to-r from-blue-500 to-purple-500,Medium,https://tailwindcss.com/docs/background-image
+53,Layout,Use shrink-0 shorthand,Shorter class name for flex-shrink-0,shrink-0 shrink,flex-shrink-0 flex-shrink,shrink-0,flex-shrink-0,Low,https://tailwindcss.com/docs/flex-shrink
+54,Layout,Use size-* for square dimensions,Single utility for equal width and height,size-4 size-8 size-12,Separate h-* w-* for squares,size-6,h-6 w-6,Low,https://tailwindcss.com/docs/size
+55,Images,SVG explicit dimensions,Add width/height attributes to SVGs to prevent layout shift before CSS loads,<svg class='size-6' width='24' height='24'>,SVG without explicit dimensions,<svg class='size-6' width='24' height='24'>,<svg class='size-6'>,High,
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/nextjs.csv b/.agents/skills/ui-ux-pro-max/data/stacks/nextjs.csv
new file mode 100644
index 0000000..6e9bea5
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/nextjs.csv
@@ -0,0 +1,53 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Routing,Use App Router for new projects,App Router is the recommended approach in Next.js 14+,app/ directory with page.tsx,pages/ for new projects,app/dashboard/page.tsx,pages/dashboard.tsx,Medium,https://nextjs.org/docs/app
+2,Routing,Use file-based routing,Create routes by adding files in app directory,page.tsx for routes layout.tsx for layouts,Manual route configuration,app/blog/[slug]/page.tsx,Custom router setup,Medium,https://nextjs.org/docs/app/building-your-application/routing
+3,Routing,Colocate related files,Keep components styles tests with their routes,Component files alongside page.tsx,Separate components folder,app/dashboard/_components/,components/dashboard/,Low,
+4,Routing,Use route groups for organization,Group routes without affecting URL,Parentheses for route groups,Nested folders affecting URL,(marketing)/about/page.tsx,marketing/about/page.tsx,Low,https://nextjs.org/docs/app/building-your-application/routing/route-groups
+5,Routing,Handle loading states,Use loading.tsx for route loading UI,loading.tsx alongside page.tsx,Manual loading state management,app/dashboard/loading.tsx,useState for loading in page,Medium,https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming
+6,Routing,Handle errors with error.tsx,Catch errors at route level,error.tsx with reset function,try/catch in every component,app/dashboard/error.tsx,try/catch in page component,High,https://nextjs.org/docs/app/building-your-application/routing/error-handling
+7,Rendering,Use Server Components by default,Server Components reduce client JS bundle,Keep components server by default,Add 'use client' unnecessarily,export default function Page(),('use client') for static content,High,https://nextjs.org/docs/app/building-your-application/rendering/server-components
+8,Rendering,Mark Client Components explicitly,'use client' for interactive components,Add 'use client' only when needed,Server Component with hooks/events,('use client') for onClick useState,No directive with useState,High,https://nextjs.org/docs/app/building-your-application/rendering/client-components
+9,Rendering,Push Client Components down,Keep Client Components as leaf nodes,Client wrapper for interactive parts only,Mark page as Client Component,<InteractiveButton/> in Server Page,('use client') on page.tsx,High,
+10,Rendering,Use streaming for better UX,Stream content with Suspense boundaries,Suspense for slow data fetches,Wait for all data before render,<Suspense><SlowComponent/></Suspense>,await allData then render,Medium,https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming
+11,Rendering,Choose correct rendering strategy,SSG for static SSR for dynamic ISR for semi-static,generateStaticParams for known paths,SSR for static content,export const revalidate = 3600,fetch without cache config,Medium,
+12,DataFetching,Fetch data in Server Components,Fetch directly in async Server Components,async function Page() { const data = await fetch() },useEffect for initial data,const data = await fetch(url),useEffect(() => fetch(url)),High,https://nextjs.org/docs/app/building-your-application/data-fetching
+13,DataFetching,Configure caching explicitly (Next.js 15+),Next.js 15 changed defaults to uncached for fetch,Explicitly set cache: 'force-cache' for static data,Assume default is cached (it's not in Next.js 15),fetch(url { cache: 'force-cache' }),fetch(url) // Uncached in v15,High,https://nextjs.org/docs/app/building-your-application/upgrading/version-15
+14,DataFetching,Deduplicate fetch requests,React and Next.js dedupe same requests,Same fetch call in multiple components,Manual request deduplication,Multiple components fetch same URL,Custom cache layer,Low,
+15,DataFetching,Use Server Actions for mutations,Server Actions for form submissions,action={serverAction} in forms,API route for every mutation,<form action={createPost}>,<form onSubmit={callApiRoute}>,Medium,https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations
+16,DataFetching,Revalidate data appropriately,Use revalidatePath/revalidateTag after mutations,Revalidate after Server Action,'use client' with manual refetch,revalidatePath('/posts'),router.refresh() everywhere,Medium,https://nextjs.org/docs/app/building-your-application/caching#revalidating
+17,Images,Use next/image for optimization,Automatic image optimization and lazy loading,<Image> component for all images,<img> tags directly,<Image src={} alt={} width={} height={}>,<img src={}/>,High,https://nextjs.org/docs/app/building-your-application/optimizing/images
+18,Images,Provide width and height,Prevent layout shift with dimensions,width and height props or fill,Missing dimensions,<Image width={400} height={300}/>,<Image src={url}/>,High,
+19,Images,Use fill for responsive images,Fill container with object-fit,fill prop with relative parent,Fixed dimensions for responsive,"<Image fill className=""object-cover""/>",<Image width={window.width}/>,Medium,
+20,Images,Configure remote image domains,Whitelist external image sources,remotePatterns in next.config.js,Allow all domains,remotePatterns: [{ hostname: 'cdn.example.com' }],domains: ['*'],High,https://nextjs.org/docs/app/api-reference/components/image#remotepatterns
+21,Images,Use priority for LCP images,Mark above-fold images as priority,priority prop on hero images,All images with priority,<Image priority src={hero}/>,<Image priority/> on every image,Medium,
+22,Fonts,Use next/font for fonts,Self-hosted fonts with zero layout shift,next/font/google or next/font/local,External font links,import { Inter } from 'next/font/google',"<link href=""fonts.googleapis.com""/>",Medium,https://nextjs.org/docs/app/building-your-application/optimizing/fonts
+23,Fonts,Apply font to layout,Set font in root layout for consistency,className on body in layout.tsx,Font in individual pages,<body className={inter.className}>,Each page imports font,Low,
+24,Fonts,Use variable fonts,Variable fonts reduce bundle size,Single variable font file,Multiple font weights as files,Inter({ subsets: ['latin'] }),Inter_400 Inter_500 Inter_700,Low,
+25,Metadata,Use generateMetadata for dynamic,Generate metadata based on params,export async function generateMetadata(),Hardcoded metadata everywhere,generateMetadata({ params }),export const metadata = {},Medium,https://nextjs.org/docs/app/building-your-application/optimizing/metadata
+26,Metadata,Include OpenGraph images,Add OG images for social sharing,opengraph-image.tsx or og property,Missing social preview images,opengraph: { images: ['/og.png'] },No OG configuration,Medium,
+27,Metadata,Use metadata API,Export metadata object for static metadata,export const metadata = {},Manual head tags,export const metadata = { title: 'Page' },<head><title>Page</title></head>,Medium,
+28,API,Use Route Handlers for APIs,app/api routes for API endpoints,app/api/users/route.ts,pages/api for new projects,export async function GET(request),export default function handler,Medium,https://nextjs.org/docs/app/building-your-application/routing/route-handlers
+29,API,Return proper Response objects,Use NextResponse for API responses,NextResponse.json() for JSON,Plain objects or res.json(),return NextResponse.json({ data }),return { data },Medium,
+30,API,Handle HTTP methods explicitly,Export named functions for methods,Export GET POST PUT DELETE,Single handler for all methods,export async function POST(),switch(req.method),Low,
+31,API,Validate request body,Validate input before processing,Zod or similar for validation,Trust client input,const body = schema.parse(await req.json()),const body = await req.json(),High,
+32,Middleware,Use middleware for auth,Protect routes with middleware.ts,middleware.ts at root,Auth check in every page,export function middleware(request),if (!session) redirect in page,Medium,https://nextjs.org/docs/app/building-your-application/routing/middleware
+33,Middleware,Match specific paths,Configure middleware matcher,config.matcher for specific routes,Run middleware on all routes,matcher: ['/dashboard/:path*'],No matcher config,Medium,
+34,Middleware,Keep middleware edge-compatible,Middleware runs on Edge runtime,Edge-compatible code only,Node.js APIs in middleware,Edge-compatible auth check,fs.readFile in middleware,High,
+35,Environment,Use NEXT_PUBLIC prefix,Client-accessible env vars need prefix,NEXT_PUBLIC_ for client vars,Server vars exposed to client,NEXT_PUBLIC_API_URL,API_SECRET in client code,High,https://nextjs.org/docs/app/building-your-application/configuring/environment-variables
+36,Environment,Validate env vars,Check required env vars exist,Validate on startup,Undefined env at runtime,if (!process.env.DATABASE_URL) throw,process.env.DATABASE_URL (might be undefined),High,
+37,Environment,Use .env.local for secrets,Local env file for development secrets,.env.local gitignored,Secrets in .env committed,.env.local with secrets,.env with DATABASE_PASSWORD,High,
+38,Performance,Analyze bundle size,Use @next/bundle-analyzer,Bundle analyzer in dev,Ship large bundles blindly,ANALYZE=true npm run build,No bundle analysis,Medium,https://nextjs.org/docs/app/building-your-application/optimizing/bundle-analyzer
+39,Performance,Use dynamic imports,Code split with next/dynamic,dynamic() for heavy components,Import everything statically,const Chart = dynamic(() => import('./Chart')),import Chart from './Chart',Medium,https://nextjs.org/docs/app/building-your-application/optimizing/lazy-loading
+40,Performance,Avoid layout shifts,Reserve space for dynamic content,Skeleton loaders aspect ratios,Content popping in,"<Skeleton className=""h-48""/>",No placeholder for async content,High,
+41,Performance,Use Partial Prerendering,Combine static and dynamic in one route,Static shell with Suspense holes,Full dynamic or static pages,Static header + dynamic content,Entire page SSR,Low,https://nextjs.org/docs/app/building-your-application/rendering/partial-prerendering
+42,Link,Use next/link for navigation,Client-side navigation with prefetching,"<Link href=""""> for internal links",<a> for internal navigation,"<Link href=""/about"">About</Link>","<a href=""/about"">About</a>",High,https://nextjs.org/docs/app/api-reference/components/link
+43,Link,Prefetch strategically,Control prefetching behavior,prefetch={false} for low-priority,Prefetch all links,<Link prefetch={false}>,Default prefetch on every link,Low,
+44,Link,Use scroll option appropriately,Control scroll behavior on navigation,scroll={false} for tabs pagination,Always scroll to top,<Link scroll={false}>,Manual scroll management,Low,
+45,Config,Use next.config.js correctly,Configure Next.js behavior,Proper config options,Deprecated or wrong options,images: { remotePatterns: [] },images: { domains: [] },Medium,https://nextjs.org/docs/app/api-reference/next-config-js
+46,Config,Enable strict mode,Catch potential issues early,reactStrictMode: true,Strict mode disabled,reactStrictMode: true,reactStrictMode: false,Medium,
+47,Config,Configure redirects and rewrites,Use config for URL management,redirects() rewrites() in config,Manual redirect handling,redirects: async () => [...],res.redirect in pages,Medium,https://nextjs.org/docs/app/api-reference/next-config-js/redirects
+48,Deployment,Use Vercel for easiest deploy,Vercel optimized for Next.js,Deploy to Vercel,Self-host without knowledge,vercel deploy,Complex Docker setup for simple app,Low,https://nextjs.org/docs/app/building-your-application/deploying
+49,Deployment,Configure output for self-hosting,Set output option for deployment target,output: 'standalone' for Docker,Default output for containers,output: 'standalone',No output config for Docker,Medium,https://nextjs.org/docs/app/building-your-application/deploying#self-hosting
+50,Security,Sanitize user input,Never trust user input,Escape sanitize validate all input,Direct interpolation of user data,DOMPurify.sanitize(userInput),dangerouslySetInnerHTML={{ __html: userInput }},High,
+51,Security,Use CSP headers,Content Security Policy for XSS protection,Configure CSP in next.config.js,No security headers,headers() with CSP,No CSP configuration,High,https://nextjs.org/docs/app/building-your-application/configuring/content-security-policy
+52,Security,Validate Server Action input,Server Actions are public endpoints,Validate and authorize in Server Action,Trust Server Action input,Auth check + validation in action,Direct database call without check,High,
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv b/.agents/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv
new file mode 100644
index 0000000..7146e84
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv
@@ -0,0 +1,51 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Installation,Add Nuxt UI module,Install and configure Nuxt UI in your Nuxt project,pnpm add @nuxt/ui and add to modules,Manual component imports,"modules: ['@nuxt/ui']","import { UButton } from '@nuxt/ui'",High,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+2,Installation,Import Tailwind and Nuxt UI CSS,Required CSS imports in main.css file,@import tailwindcss and @import @nuxt/ui,Skip CSS imports,"@import ""tailwindcss""; @import ""@nuxt/ui"";",No CSS imports,High,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+3,Installation,Wrap app with UApp component,UApp provides global configs for Toast Tooltip and overlays,<UApp> wrapper in app.vue,Skip UApp wrapper,<UApp><NuxtPage/></UApp>,<NuxtPage/> without wrapper,High,https://ui.nuxt.com/docs/components/app
+4,Components,Use U prefix for components,All Nuxt UI components use U prefix by default,UButton UInput UModal,Button Input Modal,<UButton>Click</UButton>,<Button>Click</Button>,Medium,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+5,Components,Use semantic color props,Use semantic colors like primary secondary error,color="primary" color="error",Hardcoded colors,"<UButton color=""primary"">","<UButton class=""bg-green-500"">",Medium,https://ui.nuxt.com/docs/getting-started/theme/design-system
+6,Components,Use variant prop for styling,Nuxt UI provides solid outline soft subtle ghost link variants,variant="soft" variant="outline",Custom button classes,"<UButton variant=""soft"">","<UButton class=""border bg-transparent"">",Medium,https://ui.nuxt.com/docs/components/button
+7,Components,Use size prop consistently,Components support xs sm md lg xl sizes,size="sm" size="lg",Arbitrary sizing classes,"<UButton size=""lg"">","<UButton class=""text-xl px-6"">",Low,https://ui.nuxt.com/docs/components/button
+8,Icons,Use icon prop with Iconify format,Nuxt UI supports Iconify icons via icon prop,icon="lucide:home" icon="heroicons:user",i-lucide-home format,"<UButton icon=""lucide:home"">","<UButton icon=""i-lucide-home"">",Medium,https://ui.nuxt.com/docs/getting-started/integrations/icons/nuxt
+9,Icons,Use leadingIcon and trailingIcon,Position icons with dedicated props for clarity,leadingIcon="lucide:plus" trailingIcon="lucide:arrow-right",Manual icon positioning,"<UButton leadingIcon=""lucide:plus"">","<UButton><Icon name=""lucide:plus""/>Add</UButton>",Low,https://ui.nuxt.com/docs/components/button
+10,Theming,Configure colors in app.config.ts,Runtime color configuration without restart,ui.colors.primary in app.config.ts,Hardcoded colors in components,"defineAppConfig({ ui: { colors: { primary: 'blue' } } })","<UButton class=""bg-blue-500"">",High,https://ui.nuxt.com/docs/getting-started/theme/design-system
+11,Theming,Use @theme directive for custom colors,Define design tokens in CSS with Tailwind @theme,@theme { --color-brand-500: #xxx },Inline color definitions,@theme { --color-brand-500: #ef4444; },:style="{ color: '#ef4444' }",Medium,https://ui.nuxt.com/docs/getting-started/theme/design-system
+12,Theming,Extend semantic colors in nuxt.config,Register new colors like tertiary in theme.colors,theme.colors array in ui config,Use undefined colors,"ui: { theme: { colors: ['primary', 'tertiary'] } }","<UButton color=""tertiary""> without config",Medium,https://ui.nuxt.com/docs/getting-started/theme/design-system
+13,Forms,Use UForm with schema validation,UForm supports Zod Yup Joi Valibot schemas,:schema prop with validation schema,Manual form validation,"<UForm :schema=""schema"" :state=""state"">",Manual @blur validation,High,https://ui.nuxt.com/docs/components/form
+14,Forms,Use UFormField for field wrapper,Provides label error message and validation display,UFormField with name prop,Manual error handling,"<UFormField name=""email"" label=""Email"">",<div><label>Email</label><UInput/><span>error</span></div>,Medium,https://ui.nuxt.com/docs/components/form-field
+15,Forms,Handle form submit with @submit,UForm emits submit event with validated data,@submit handler on UForm,@click on submit button,"<UForm @submit=""onSubmit"">","<UButton @click=""onSubmit"">",Medium,https://ui.nuxt.com/docs/components/form
+16,Forms,Use validateOn prop for validation timing,Control when validation triggers (blur change input),validateOn="['blur']" for performance,Always validate on input,"<UForm :validateOn=""['blur', 'change']"">","<UForm> (validates on every keystroke)",Low,https://ui.nuxt.com/docs/components/form
+17,Overlays,Use v-model:open for overlay control,Modal Slideover Drawer use v-model:open,v-model:open for controlled state,Manual show/hide logic,"<UModal v-model:open=""isOpen"">",<UModal v-if="isOpen">,Medium,https://ui.nuxt.com/docs/components/modal
+18,Overlays,Use useOverlay composable for programmatic overlays,Open overlays programmatically without template refs,useOverlay().open(MyModal),Template ref and manual control,"const overlay = useOverlay(); overlay.open(MyModal, { props })","const modal = ref(); modal.value.open()",Medium,https://ui.nuxt.com/docs/components/modal
+19,Overlays,Use title and description props,Built-in header support for overlays,title="Confirm" description="Are you sure?",Manual header content,"<UModal title=""Confirm"" description=""Are you sure?"">","<UModal><template #header><h2>Confirm</h2></template>",Low,https://ui.nuxt.com/docs/components/modal
+20,Dashboard,Use UDashboardSidebar for navigation,Provides collapsible resizable sidebar with mobile support,UDashboardSidebar with header default footer slots,Custom sidebar implementation,<UDashboardSidebar><template #header>...</template></UDashboardSidebar>,<aside class="w-64 border-r">,Medium,https://ui.nuxt.com/docs/components/dashboard-sidebar
+21,Dashboard,Use UDashboardGroup for layout,Wraps dashboard components with sidebar state management,UDashboardGroup > UDashboardSidebar + UDashboardPanel,Manual layout flex containers,<UDashboardGroup><UDashboardSidebar/><UDashboardPanel/></UDashboardGroup>,"<div class=""flex""><aside/><main/></div>",Medium,https://ui.nuxt.com/docs/components/dashboard-group
+22,Dashboard,Use UDashboardNavbar for top navigation,Responsive navbar with mobile menu support,UDashboardNavbar in dashboard layout,Custom navbar implementation,<UDashboardNavbar :links="navLinks"/>,<nav class="border-b">,Low,https://ui.nuxt.com/docs/components/dashboard-navbar
+23,Tables,Use UTable with data and columns props,Powered by TanStack Table with built-in features,:data and :columns props,Manual table markup,"<UTable :data=""users"" :columns=""columns""/>","<table><tr v-for=""user in users"">",High,https://ui.nuxt.com/docs/components/table
+24,Tables,Define columns with accessorKey,Column definitions use accessorKey for data binding,accessorKey: 'email' in column def,String column names only,"{ accessorKey: 'email', header: 'Email' }","['name', 'email']",Medium,https://ui.nuxt.com/docs/components/table
+25,Tables,Use cell slot for custom rendering,Customize cell content with scoped slots,#cell-columnName slot,Override entire table,<template #cell-status="{ row }">,Manual column render function,Medium,https://ui.nuxt.com/docs/components/table
+26,Tables,Enable sorting with sortable column option,Add sortable: true to column definition,sortable: true in column,Manual sort implementation,"{ accessorKey: 'name', sortable: true }",@click="sortBy('name')",Low,https://ui.nuxt.com/docs/components/table
+27,Navigation,Use UNavigationMenu for nav links,Horizontal or vertical navigation with dropdown support,UNavigationMenu with items array,Manual nav with v-for,"<UNavigationMenu :items=""navItems""/>","<nav><a v-for=""item in items"">",Medium,https://ui.nuxt.com/docs/components/navigation-menu
+28,Navigation,Use UBreadcrumb for page hierarchy,Automatic breadcrumb with NuxtLink support,:items array with label and to,Manual breadcrumb links,"<UBreadcrumb :items=""breadcrumbs""/>","<nav><span v-for=""crumb in crumbs"">",Low,https://ui.nuxt.com/docs/components/breadcrumb
+29,Navigation,Use UTabs for tabbed content,Tab navigation with content panels,UTabs with items containing slot content,Manual tab state,"<UTabs :items=""tabs""/>","<div><button @click=""tab=1"">",Medium,https://ui.nuxt.com/docs/components/tabs
+30,Feedback,Use useToast for notifications,Composable for toast notifications,useToast().add({ title description }),Alert components for toasts,"const toast = useToast(); toast.add({ title: 'Saved' })",<UAlert v-if="showSuccess">,High,https://ui.nuxt.com/docs/components/toast
+31,Feedback,Use UAlert for inline messages,Static alert messages with icon and actions,UAlert with title description color,Toast for static messages,"<UAlert title=""Warning"" color=""warning""/>",useToast for inline alerts,Medium,https://ui.nuxt.com/docs/components/alert
+32,Feedback,Use USkeleton for loading states,Placeholder content during data loading,USkeleton with appropriate size,Spinner for content loading,<USkeleton class="h-4 w-32"/>,<UIcon name="lucide:loader" class="animate-spin"/>,Low,https://ui.nuxt.com/docs/components/skeleton
+33,Color Mode,Use UColorModeButton for theme toggle,Built-in light/dark mode toggle button,UColorModeButton component,Manual color mode logic,<UColorModeButton/>,"<button @click=""toggleColorMode"">",Low,https://ui.nuxt.com/docs/components/color-mode-button
+34,Color Mode,Use UColorModeSelect for theme picker,Dropdown to select system light or dark mode,UColorModeSelect component,Custom select for theme,<UColorModeSelect/>,"<USelect v-model=""colorMode"" :items=""modes""/>",Low,https://ui.nuxt.com/docs/components/color-mode-select
+35,Customization,Use ui prop for component styling,Override component styles via ui prop,ui prop with slot class overrides,Global CSS overrides,"<UButton :ui=""{ base: 'rounded-full' }""/>",<UButton class="!rounded-full"/>,Medium,https://ui.nuxt.com/docs/getting-started/theme/components
+36,Customization,Configure default variants in nuxt.config,Set default color and size for all components,theme.defaultVariants in ui config,Repeat props on every component,"ui: { theme: { defaultVariants: { color: 'neutral' } } }","<UButton color=""neutral""> everywhere",Medium,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+37,Customization,Use app.config.ts for theme overrides,Runtime theme customization,defineAppConfig with ui key,nuxt.config for runtime values,"defineAppConfig({ ui: { button: { defaultVariants: { size: 'sm' } } } })","nuxt.config ui.button.size: 'sm'",Medium,https://ui.nuxt.com/docs/getting-started/theme/components
+38,Performance,Enable component detection,Tree-shake unused component CSS,experimental.componentDetection: true,Include all component CSS,"ui: { experimental: { componentDetection: true } }","ui: {} (includes all CSS)",Low,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+39,Performance,Use UTable virtualize for large data,Enable virtualization for 1000+ rows,:virtualize prop on UTable,Render all rows,"<UTable :data=""largeData"" virtualize/>","<UTable :data=""largeData""/>",Medium,https://ui.nuxt.com/docs/components/table
+40,Accessibility,Use semantic component props,Components have built-in ARIA support,Use title description label props,Skip accessibility props,"<UModal title=""Settings"">","<UModal><h2>Settings</h2>",Medium,https://ui.nuxt.com/docs/components/modal
+41,Accessibility,Use UFormField for form accessibility,Automatic label-input association,UFormField wraps inputs,Manual id and for attributes,"<UFormField label=""Email""><UInput/></UFormField>","<label for=""email"">Email</label><UInput id=""email""/>",High,https://ui.nuxt.com/docs/components/form-field
+42,Content,Use UContentToc for table of contents,Automatic TOC with active heading highlight,UContentToc with :links,Manual TOC implementation,"<UContentToc :links=""toc""/>","<nav><a v-for=""heading in headings"">",Low,https://ui.nuxt.com/docs/components/content-toc
+43,Content,Use UContentSearch for docs search,Command palette for documentation search,UContentSearch with Nuxt Content,Custom search implementation,<UContentSearch/>,<UCommandPalette :groups="searchResults"/>,Low,https://ui.nuxt.com/docs/components/content-search
+44,AI/Chat,Use UChatMessages for chat UI,Designed for Vercel AI SDK integration,UChatMessages with messages array,Custom chat message list,"<UChatMessages :messages=""messages""/>","<div v-for=""msg in messages"">",Medium,https://ui.nuxt.com/docs/components/chat-messages
+45,AI/Chat,Use UChatPrompt for input,Enhanced textarea for AI prompts,UChatPrompt with v-model,Basic textarea,<UChatPrompt v-model="prompt"/>,<UTextarea v-model="prompt"/>,Medium,https://ui.nuxt.com/docs/components/chat-prompt
+46,Editor,Use UEditor for rich text,TipTap-based editor with toolbar support,UEditor with v-model:content,Custom TipTap setup,"<UEditor v-model:content=""content""/>",Manual TipTap initialization,Medium,https://ui.nuxt.com/docs/components/editor
+47,Links,Use to prop for navigation,UButton and ULink support NuxtLink to prop,to="/dashboard" for internal links,href for internal navigation,"<UButton to=""/dashboard"">","<UButton href=""/dashboard"">",Medium,https://ui.nuxt.com/docs/components/button
+48,Links,Use external prop for outside links,Explicitly mark external links,target="_blank" with external URLs,Forget rel="noopener","<UButton to=""https://example.com"" target=""_blank"">","<UButton href=""https://..."">",Low,https://ui.nuxt.com/docs/components/link
+49,Loading,Use loadingAuto on buttons,Automatic loading state from @click promise,loadingAuto prop on UButton,Manual loading state,"<UButton loadingAuto @click=""async () => await save()"">","<UButton :loading=""isLoading"" @click=""save"">",Low,https://ui.nuxt.com/docs/components/button
+50,Loading,Use UForm loadingAuto,Auto-disable form during submit,loadingAuto on UForm (default true),Manual form disabled state,"<UForm @submit=""handleSubmit"">","<UForm :disabled=""isSubmitting"">",Low,https://ui.nuxt.com/docs/components/form
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv b/.agents/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv
new file mode 100644
index 0000000..c275d0d
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv
@@ -0,0 +1,59 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Routing,Use file-based routing,Create routes by adding files in pages directory,pages/ directory with index.vue,Manual route configuration,pages/dashboard/index.vue,Custom router setup,Medium,https://nuxt.com/docs/getting-started/routing
+2,Routing,Use dynamic route parameters,Create dynamic routes with bracket syntax,[id].vue for dynamic params,Hardcoded routes for dynamic content,pages/posts/[id].vue,pages/posts/post1.vue,Medium,https://nuxt.com/docs/getting-started/routing
+3,Routing,Use catch-all routes,Handle multiple path segments with [...slug],[...slug].vue for catch-all,Multiple nested dynamic routes,pages/[...slug].vue,pages/[a]/[b]/[c].vue,Low,https://nuxt.com/docs/getting-started/routing
+4,Routing,Define page metadata with definePageMeta,Set page-level configuration and middleware,definePageMeta for layout middleware title,Manual route meta configuration,"definePageMeta({ layout: 'admin', middleware: 'auth' })",router.beforeEach for page config,High,https://nuxt.com/docs/api/utils/define-page-meta
+5,Routing,Use validate for route params,Validate dynamic route parameters before rendering,validate function in definePageMeta,Manual validation in setup,"definePageMeta({ validate: (route) => /^\d+$/.test(route.params.id) })",if (!valid) navigateTo('/404'),Medium,https://nuxt.com/docs/api/utils/define-page-meta
+6,Rendering,Use SSR by default,Server-side rendering is enabled by default,Keep ssr: true (default),Disable SSR unnecessarily,ssr: true (default),ssr: false for all pages,High,https://nuxt.com/docs/guide/concepts/rendering
+7,Rendering,Use .client suffix for client-only components,Mark components to render only on client,ComponentName.client.vue suffix,v-if with process.client check,Comments.client.vue,<div v-if="process.client"><Comments/></div>,Medium,https://nuxt.com/docs/guide/directory-structure/components
+8,Rendering,Use .server suffix for server-only components,Mark components to render only on server,ComponentName.server.vue suffix,Manual server check,HeavyMarkdown.server.vue,v-if="process.server",Low,https://nuxt.com/docs/guide/directory-structure/components
+9,DataFetching,Use useFetch for simple data fetching,Wrapper around useAsyncData for URL fetching,useFetch for API calls,$fetch in onMounted,"const { data } = await useFetch('/api/posts')","onMounted(async () => { data.value = await $fetch('/api/posts') })",High,https://nuxt.com/docs/api/composables/use-fetch
+10,DataFetching,Use useAsyncData for complex fetching,Fine-grained control over async data,useAsyncData for CMS or custom fetching,useFetch for non-URL data sources,"const { data } = await useAsyncData('posts', () => cms.getPosts())","const { data } = await useFetch(() => cms.getPosts())",Medium,https://nuxt.com/docs/api/composables/use-async-data
+11,DataFetching,Use $fetch for non-reactive requests,$fetch for event handlers and non-component code,$fetch in event handlers or server routes,useFetch in click handlers,"async function submit() { await $fetch('/api/submit', { method: 'POST' }) }","async function submit() { await useFetch('/api/submit') }",High,https://nuxt.com/docs/api/utils/dollarfetch
+12,DataFetching,Use lazy option for non-blocking fetch,Defer data fetching for better initial load,lazy: true for below-fold content,Blocking fetch for non-critical data,"useFetch('/api/comments', { lazy: true })",await useFetch('/api/comments') for footer,Medium,https://nuxt.com/docs/api/composables/use-fetch
+13,DataFetching,Use server option to control fetch location,Choose where data is fetched,server: false for client-only data,Server fetch for user-specific client data,"useFetch('/api/user-preferences', { server: false })",useFetch for localStorage-dependent data,Medium,https://nuxt.com/docs/api/composables/use-fetch
+14,DataFetching,Use pick to reduce payload size,Select only needed fields from response,pick option for large responses,Fetching entire objects when few fields needed,"useFetch('/api/user', { pick: ['id', 'name'] })",useFetch('/api/user') then destructure,Low,https://nuxt.com/docs/api/composables/use-fetch
+15,DataFetching,Use transform for data manipulation,Transform data before storing in state,transform option for data shaping,Manual transformation after fetch,"useFetch('/api/posts', { transform: (posts) => posts.map(p => p.title) })",const titles = data.value.map(p => p.title),Low,https://nuxt.com/docs/api/composables/use-fetch
+16,DataFetching,Handle loading and error states,Always handle pending and error states,Check status pending error refs,Ignoring loading states,"<div v-if=""status === 'pending'"">Loading...</div>",No loading indicator,High,https://nuxt.com/docs/getting-started/data-fetching
+17,Lifecycle,Avoid side effects in script setup root,Move side effects to lifecycle hooks,Side effects in onMounted,setInterval in root script setup,"onMounted(() => { interval = setInterval(...) })","<script setup>setInterval(...)</script>",High,https://nuxt.com/docs/guide/concepts/nuxt-lifecycle
+18,Lifecycle,Use onMounted for DOM access,Access DOM only after component is mounted,onMounted for DOM manipulation,Direct DOM access in setup,"onMounted(() => { document.getElementById('el') })","<script setup>document.getElementById('el')</script>",High,https://nuxt.com/docs/api/composables/on-mounted
+19,Lifecycle,Use nextTick for post-render access,Wait for DOM updates before accessing elements,await nextTick() after state changes,Immediate DOM access after state change,"count.value++; await nextTick(); el.value.focus()","count.value++; el.value.focus()",Medium,https://nuxt.com/docs/api/utils/next-tick
+20,Lifecycle,Use onPrehydrate for pre-hydration logic,Run code before Nuxt hydrates the page,onPrehydrate for client setup,onMounted for hydration-critical code,"onPrehydrate(() => { console.log(window) })",onMounted for pre-hydration needs,Low,https://nuxt.com/docs/api/composables/on-prehydrate
+21,Server,Use server/api for API routes,Create API endpoints in server/api directory,server/api/users.ts for /api/users,Manual Express setup,server/api/hello.ts -> /api/hello,app.get('/api/hello'),High,https://nuxt.com/docs/guide/directory-structure/server
+22,Server,Use defineEventHandler for handlers,Define server route handlers,defineEventHandler for all handlers,export default function,"export default defineEventHandler((event) => { return { hello: 'world' } })","export default function(req, res) {}",High,https://nuxt.com/docs/guide/directory-structure/server
+23,Server,Use server/routes for non-api routes,Routes without /api prefix,server/routes for custom paths,server/api for non-api routes,server/routes/sitemap.xml.ts,server/api/sitemap.xml.ts,Medium,https://nuxt.com/docs/guide/directory-structure/server
+24,Server,Use getQuery and readBody for input,Access query params and request body,getQuery(event) readBody(event),Direct event access,"const { id } = getQuery(event)",event.node.req.query,Medium,https://nuxt.com/docs/guide/directory-structure/server
+25,Server,Validate server input,Always validate input in server handlers,Zod or similar for validation,Trust client input,"const body = await readBody(event); schema.parse(body)",const body = await readBody(event),High,https://nuxt.com/docs/guide/directory-structure/server
+26,State,Use useState for shared reactive state,SSR-friendly shared state across components,useState for cross-component state,ref for shared state,"const count = useState('count', () => 0)",const count = ref(0) in composable,High,https://nuxt.com/docs/api/composables/use-state
+27,State,Use unique keys for useState,Prevent state conflicts with unique keys,Descriptive unique keys for each state,Generic or duplicate keys,"useState('user-preferences', () => ({}))",useState('data') in multiple places,Medium,https://nuxt.com/docs/api/composables/use-state
+28,State,Use Pinia for complex state,Pinia for advanced state management,@pinia/nuxt for complex apps,Custom state management,useMainStore() with Pinia,Custom reactive store implementation,Medium,https://nuxt.com/docs/getting-started/state-management
+29,State,Use callOnce for one-time async operations,Ensure async operations run only once,callOnce for store initialization,Direct await in component,"await callOnce(store.fetch)",await store.fetch() on every render,Medium,https://nuxt.com/docs/api/utils/call-once
+30,SEO,Use useSeoMeta for SEO tags,Type-safe SEO meta tag management,useSeoMeta for meta tags,useHead for simple meta,"useSeoMeta({ title: 'Home', ogTitle: 'Home', description: '...' })","useHead({ meta: [{ name: 'description', content: '...' }] })",High,https://nuxt.com/docs/api/composables/use-seo-meta
+31,SEO,Use reactive values in useSeoMeta,Dynamic SEO tags with refs or getters,Computed getters for dynamic values,Static values for dynamic content,"useSeoMeta({ title: () => post.value.title })","useSeoMeta({ title: post.value.title })",Medium,https://nuxt.com/docs/api/composables/use-seo-meta
+32,SEO,Use useHead for non-meta head elements,Scripts styles links in head,useHead for scripts and links,useSeoMeta for scripts,"useHead({ script: [{ src: '/analytics.js' }] })","useSeoMeta({ script: '...' })",Medium,https://nuxt.com/docs/api/composables/use-head
+33,SEO,Include OpenGraph tags,Add OG tags for social sharing,ogTitle ogDescription ogImage,Missing social preview,"useSeoMeta({ ogImage: '/og.png', twitterCard: 'summary_large_image' })",No OG configuration,Medium,https://nuxt.com/docs/api/composables/use-seo-meta
+34,Middleware,Use defineNuxtRouteMiddleware,Define route middleware properly,defineNuxtRouteMiddleware wrapper,export default function,"export default defineNuxtRouteMiddleware((to, from) => {})","export default function(to, from) {}",High,https://nuxt.com/docs/guide/directory-structure/middleware
+35,Middleware,Use navigateTo for redirects,Redirect in middleware with navigateTo,return navigateTo('/login'),router.push in middleware,"if (!auth) return navigateTo('/login')","if (!auth) router.push('/login')",High,https://nuxt.com/docs/api/utils/navigate-to
+36,Middleware,Reference middleware in definePageMeta,Apply middleware to specific pages,middleware array in definePageMeta,Global middleware for page-specific,definePageMeta({ middleware: ['auth'] }),Global auth check for one page,Medium,https://nuxt.com/docs/guide/directory-structure/middleware
+37,Middleware,Use .global suffix for global middleware,Apply middleware to all routes,auth.global.ts for app-wide auth,Manual middleware on every page,middleware/auth.global.ts,middleware: ['auth'] on every page,Medium,https://nuxt.com/docs/guide/directory-structure/middleware
+38,ErrorHandling,Use createError for errors,Create errors with proper status codes,createError with statusCode,throw new Error,"throw createError({ statusCode: 404, statusMessage: 'Not Found' })",throw new Error('Not Found'),High,https://nuxt.com/docs/api/utils/create-error
+39,ErrorHandling,Use NuxtErrorBoundary for local errors,Handle errors within component subtree,NuxtErrorBoundary for component errors,Global error page for local errors,"<NuxtErrorBoundary @error=""log""><template #error=""{ error }"">",error.vue for component errors,Medium,https://nuxt.com/docs/getting-started/error-handling
+40,ErrorHandling,Use clearError to recover from errors,Clear error state and optionally redirect,clearError({ redirect: '/' }),Manual error state reset,clearError({ redirect: '/home' }),error.value = null,Medium,https://nuxt.com/docs/api/utils/clear-error
+41,ErrorHandling,Use short statusMessage,Keep statusMessage brief for security,Short generic messages,Detailed error info in statusMessage,"createError({ statusCode: 400, statusMessage: 'Bad Request' })","createError({ statusMessage: 'Invalid user ID: 123' })",High,https://nuxt.com/docs/getting-started/error-handling
+42,Link,Use NuxtLink for internal navigation,Client-side navigation with prefetching,<NuxtLink to> for internal links,<a href> for internal links,<NuxtLink to="/about">About</NuxtLink>,<a href="/about">About</a>,High,https://nuxt.com/docs/api/components/nuxt-link
+43,Link,Configure prefetch behavior,Control when prefetching occurs,prefetchOn for interaction-based,Default prefetch for low-priority,"<NuxtLink prefetch-on=""interaction"">",Always default prefetch,Low,https://nuxt.com/docs/api/components/nuxt-link
+44,Link,Use useRouter for programmatic navigation,Navigate programmatically,useRouter().push() for navigation,Direct window.location,"const router = useRouter(); router.push('/dashboard')",window.location.href = '/dashboard',Medium,https://nuxt.com/docs/api/composables/use-router
+45,Link,Use navigateTo in composables,Navigate outside components,navigateTo() in middleware or plugins,useRouter in non-component code,return navigateTo('/login'),router.push in middleware,Medium,https://nuxt.com/docs/api/utils/navigate-to
+46,AutoImports,Leverage auto-imports,Use auto-imported composables directly,Direct use of ref computed useFetch,Manual imports for Nuxt composables,"const count = ref(0)","import { ref } from 'vue'; const count = ref(0)",Medium,https://nuxt.com/docs/guide/concepts/auto-imports
+47,AutoImports,Use #imports for explicit imports,Explicit imports when needed,#imports for clarity or disabled auto-imports,"import from 'vue' when auto-import enabled","import { ref } from '#imports'","import { ref } from 'vue'",Low,https://nuxt.com/docs/guide/concepts/auto-imports
+48,AutoImports,Configure third-party auto-imports,Add external package auto-imports,imports.presets in nuxt.config,Manual imports everywhere,"imports: { presets: [{ from: 'vue-i18n', imports: ['useI18n'] }] }",import { useI18n } everywhere,Low,https://nuxt.com/docs/guide/concepts/auto-imports
+49,Plugins,Use defineNuxtPlugin,Define plugins properly,defineNuxtPlugin wrapper,export default function,"export default defineNuxtPlugin((nuxtApp) => {})","export default function(ctx) {}",High,https://nuxt.com/docs/guide/directory-structure/plugins
+50,Plugins,Use provide for injection,Provide helpers across app,return { provide: {} } for type safety,nuxtApp.provide without types,"return { provide: { hello: (name) => `Hello ${name}!` } }","nuxtApp.provide('hello', fn)",Medium,https://nuxt.com/docs/guide/directory-structure/plugins
+51,Plugins,Use .client or .server suffix,Control plugin execution environment,plugin.client.ts for client-only,if (process.client) checks,analytics.client.ts,"if (process.client) { // analytics }",Medium,https://nuxt.com/docs/guide/directory-structure/plugins
+52,Environment,Use runtimeConfig for env vars,Access environment variables safely,runtimeConfig in nuxt.config,process.env directly,"runtimeConfig: { apiSecret: '', public: { apiBase: '' } }",process.env.API_SECRET in components,High,https://nuxt.com/docs/guide/going-further/runtime-config
+53,Environment,Use NUXT_ prefix for env override,Override config with environment variables,NUXT_API_SECRET NUXT_PUBLIC_API_BASE,Custom env var names,NUXT_PUBLIC_API_BASE=https://api.example.com,API_BASE=https://api.example.com,High,https://nuxt.com/docs/guide/going-further/runtime-config
+54,Environment,Access public config with useRuntimeConfig,Get public config in components,useRuntimeConfig().public,Direct process.env access,const config = useRuntimeConfig(); config.public.apiBase,process.env.NUXT_PUBLIC_API_BASE,High,https://nuxt.com/docs/api/composables/use-runtime-config
+55,Environment,Keep secrets in private config,Server-only secrets in runtimeConfig root,runtimeConfig.apiSecret (server only),Secrets in public config,runtimeConfig: { dbPassword: '' },runtimeConfig: { public: { dbPassword: '' } },High,https://nuxt.com/docs/guide/going-further/runtime-config
+56,Performance,Use Lazy prefix for code splitting,Lazy load components with Lazy prefix,<LazyComponent> for below-fold,Eager load all components,<LazyMountainsList v-if="show"/>,<MountainsList/> for hidden content,Medium,https://nuxt.com/docs/guide/directory-structure/components
+57,Performance,Use useLazyFetch for non-blocking data,Alias for useFetch with lazy: true,useLazyFetch for secondary data,useFetch for all requests,"const { data } = useLazyFetch('/api/comments')",await useFetch for comments section,Medium,https://nuxt.com/docs/api/composables/use-lazy-fetch
+58,Performance,Use lazy hydration for interactivity,Delay component hydration until needed,LazyComponent with hydration strategy,Immediate hydration for all,<LazyModal hydrate-on-visible/>,<Modal/> in footer,Low,https://nuxt.com/docs/guide/going-further/experimental-features
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/react-native.csv b/.agents/skills/ui-ux-pro-max/data/stacks/react-native.csv
new file mode 100644
index 0000000..209e893
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/react-native.csv
@@ -0,0 +1,52 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Components,Use functional components,Hooks-based components are standard,Functional components with hooks,Class components,const App = () => { },class App extends Component,Medium,https://reactnative.dev/docs/intro-react
+2,Components,Keep components small,Single responsibility principle,Split into smaller components,Large monolithic components,<Header /><Content /><Footer />,500+ line component,Medium,
+3,Components,Use TypeScript,Type safety for props and state,TypeScript for new projects,JavaScript without types,const Button: FC<Props> = () => { },const Button = (props) => { },Medium,
+4,Components,Colocate component files,Keep related files together,Component folder with styles,Flat structure,components/Button/index.tsx styles.ts,components/Button.tsx styles/button.ts,Low,
+5,Styling,Use StyleSheet.create,Optimized style objects,StyleSheet for all styles,Inline style objects,StyleSheet.create({ container: {} }),style={{ margin: 10 }},High,https://reactnative.dev/docs/stylesheet
+6,Styling,Avoid inline styles,Prevent object recreation,Styles in StyleSheet,Inline style objects in render,style={styles.container},"style={{ margin: 10, padding: 5 }}",Medium,
+7,Styling,Use flexbox for layout,React Native uses flexbox,flexDirection alignItems justifyContent,Absolute positioning everywhere,flexDirection: 'row',position: 'absolute' everywhere,Medium,https://reactnative.dev/docs/flexbox
+8,Styling,Handle platform differences,Platform-specific styles,Platform.select or .ios/.android files,Same styles for both platforms,"Platform.select({ ios: {}, android: {} })",Hardcoded iOS values,Medium,https://reactnative.dev/docs/platform-specific-code
+9,Styling,Use responsive dimensions,Scale for different screens,Dimensions or useWindowDimensions,Fixed pixel values,useWindowDimensions(),width: 375,Medium,
+10,Navigation,Use React Navigation,Standard navigation library,React Navigation for routing,Manual navigation management,createStackNavigator(),Custom navigation state,Medium,https://reactnavigation.org/
+11,Navigation,Type navigation params,Type-safe navigation,Typed navigation props,Untyped navigation,"navigation.navigate<RootStackParamList>('Home', { id })","navigation.navigate('Home', { id })",Medium,
+12,Navigation,Use deep linking,Support URL-based navigation,Configure linking prop,No deep link support,linking: { prefixes: [] },No linking configuration,Medium,https://reactnavigation.org/docs/deep-linking/
+13,Navigation,Handle back button,Android back button handling,useFocusEffect with BackHandler,Ignore back button,BackHandler.addEventListener,No back handler,High,
+14,State,Use useState for local state,Simple component state,useState for UI state,Class component state,"const [count, setCount] = useState(0)",this.state = { count: 0 },Medium,
+15,State,Use useReducer for complex state,Complex state logic,useReducer for related state,Multiple useState for related values,useReducer(reducer initialState),5+ useState calls,Medium,
+16,State,Use context sparingly,Context for global state,Context for theme auth locale,Context for frequently changing data,ThemeContext for app theme,Context for list item data,Medium,
+17,State,Consider Zustand or Redux,External state management,Zustand for simple Redux for complex,useState for global state,create((set) => ({ })),Prop drilling global state,Medium,
+18,Lists,Use FlatList for long lists,Virtualized list rendering,FlatList for 50+ items,ScrollView with map,<FlatList data={items} />,<ScrollView>{items.map()}</ScrollView>,High,https://reactnative.dev/docs/flatlist
+19,Lists,Provide keyExtractor,Unique keys for list items,keyExtractor with stable ID,Index as key,keyExtractor={(item) => item.id},"keyExtractor={(_, index) => index}",High,
+20,Lists,Optimize renderItem,Memoize list item components,React.memo for list items,Inline render function,renderItem={({ item }) => <MemoizedItem item={item} />},renderItem={({ item }) => <View>...</View>},High,
+21,Lists,Use getItemLayout for fixed height,Skip measurement for performance,getItemLayout when height known,Dynamic measurement for fixed items,"getItemLayout={(_, index) => ({ length: 50, offset: 50 * index, index })}",No getItemLayout for fixed height,Medium,
+22,Lists,Implement windowSize,Control render window,Smaller windowSize for memory,Default windowSize for large lists,windowSize={5},windowSize={21} for huge lists,Medium,
+23,Performance,Use React.memo,Prevent unnecessary re-renders,memo for pure components,No memoization,export default memo(MyComponent),export default MyComponent,Medium,
+24,Performance,Use useCallback for handlers,Stable function references,useCallback for props,New function on every render,"useCallback(() => {}, [deps])",() => handlePress(),Medium,
+25,Performance,Use useMemo for expensive ops,Cache expensive calculations,useMemo for heavy computations,Recalculate every render,"useMemo(() => expensive(), [deps])",const result = expensive(),Medium,
+26,Performance,Avoid anonymous functions in JSX,Prevent re-renders,Named handlers or useCallback,Inline arrow functions,onPress={handlePress},onPress={() => doSomething()},Medium,
+27,Performance,Use Hermes engine,Improved startup and memory,Enable Hermes in build,JavaScriptCore for new projects,hermes_enabled: true,hermes_enabled: false,Medium,https://reactnative.dev/docs/hermes
+28,Images,Use expo-image,Modern performant image component for React Native,"Use expo-image for caching, blurring, and performance",Use default Image for heavy lists or unmaintained libraries,<Image source={url} cachePolicy='memory-disk' /> (expo-image),<FastImage source={url} />,Medium,https://docs.expo.dev/versions/latest/sdk/image/
+29,Images,Specify image dimensions,Prevent layout shifts,width and height for remote images,No dimensions for network images,<Image style={{ width: 100 height: 100 }} />,<Image source={{ uri }} /> no size,High,
+30,Images,Use resizeMode,Control image scaling,resizeMode cover contain,Stretch images,"resizeMode=""cover""",No resizeMode,Low,
+31,Forms,Use controlled inputs,State-controlled form fields,value + onChangeText,Uncontrolled inputs,<TextInput value={text} onChangeText={setText} />,<TextInput defaultValue={text} />,Medium,
+32,Forms,Handle keyboard,Manage keyboard visibility,KeyboardAvoidingView,Content hidden by keyboard,"<KeyboardAvoidingView behavior=""padding"">",No keyboard handling,High,https://reactnative.dev/docs/keyboardavoidingview
+33,Forms,Use proper keyboard types,Appropriate keyboard for input,keyboardType for input type,Default keyboard for all,"keyboardType=""email-address""","keyboardType=""default"" for email",Low,
+34,Touch,Use Pressable,Modern touch handling,Pressable for touch interactions,TouchableOpacity for new code,<Pressable onPress={} />,<TouchableOpacity onPress={} />,Low,https://reactnative.dev/docs/pressable
+35,Touch,Provide touch feedback,Visual feedback on press,Ripple or opacity change,No feedback on press,android_ripple={{ color: 'gray' }},No press feedback,Medium,
+36,Touch,Set hitSlop for small targets,Increase touch area,hitSlop for icons and small buttons,Tiny touch targets,hitSlop={{ top: 10 bottom: 10 }},44x44 with no hitSlop,Medium,
+37,Animation,Use Reanimated,High-performance animations,react-native-reanimated,Animated API for complex,useSharedValue useAnimatedStyle,Animated.timing for gesture,Medium,https://docs.swmansion.com/react-native-reanimated/
+38,Animation,Run on UI thread,worklets for smooth animation,Run animations on UI thread,JS thread animations,runOnUI(() => {}),Animated on JS thread,High,
+39,Animation,Use gesture handler,Native gesture recognition,react-native-gesture-handler,JS-based gesture handling,<GestureDetector>,<View onTouchMove={} />,Medium,https://docs.swmansion.com/react-native-gesture-handler/
+40,Async,Handle loading states,Show loading indicators,ActivityIndicator during load,Empty screen during load,{isLoading ? <ActivityIndicator /> : <Content />},No loading state,Medium,
+41,Async,Handle errors gracefully,Error boundaries and fallbacks,Error UI for failed requests,Crash on error,{error ? <ErrorView /> : <Content />},No error handling,High,
+42,Async,Cancel async operations,Cleanup on unmount,AbortController or cleanup,Memory leaks from async,useEffect cleanup,No cleanup for subscriptions,High,
+43,Accessibility,Add accessibility labels,Describe UI elements,accessibilityLabel for all interactive,Missing labels,"accessibilityLabel=""Submit form""",<Pressable> without label,High,https://reactnative.dev/docs/accessibility
+44,Accessibility,Use accessibility roles,Semantic meaning,accessibilityRole for elements,Wrong roles,"accessibilityRole=""button""",No role for button,Medium,
+45,Accessibility,Support screen readers,Test with TalkBack/VoiceOver,Test with screen readers,Skip accessibility testing,Regular TalkBack testing,No screen reader testing,High,
+46,Testing,Use React Native Testing Library,Component testing,render and fireEvent,Enzyme or manual testing,render(<Component />),shallow(<Component />),Medium,https://callstack.github.io/react-native-testing-library/
+47,Testing,Test on real devices,Real device behavior,Test on iOS and Android devices,Simulator only,Device testing in CI,Simulator only testing,High,
+48,Testing,Use Detox for E2E,End-to-end testing,Detox for critical flows,Manual E2E testing,detox test,Manual testing only,Medium,https://wix.github.io/Detox/
+49,Native,Use native modules carefully,Bridge has overhead,Batch native calls,Frequent bridge crossing,Batch updates,Call native on every keystroke,High,
+50,Native,Use Expo when possible,Simplified development,Expo for standard features,Bare RN for simple apps,expo install package,react-native link package,Low,https://docs.expo.dev/
+51,Native,Handle permissions,Request permissions properly,Check and request permissions,Assume permissions granted,PermissionsAndroid.request(),Access without permission check,High,https://reactnative.dev/docs/permissionsandroid
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/react.csv b/.agents/skills/ui-ux-pro-max/data/stacks/react.csv
new file mode 100644
index 0000000..ff08ee2
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/react.csv
@@ -0,0 +1,54 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,State,Use useState for local state,Simple component state should use useState hook,useState for form inputs toggles counters,Class components this.state,"const [count, setCount] = useState(0)",this.state = { count: 0 },Medium,https://react.dev/reference/react/useState
+2,State,Lift state up when needed,Share state between siblings by lifting to parent,Lift shared state to common ancestor,Prop drilling through many levels,Parent holds state passes down,Deep prop chains,Medium,https://react.dev/learn/sharing-state-between-components
+3,State,Use useReducer for complex state,Complex state logic benefits from reducer pattern,useReducer for state with multiple sub-values,Multiple useState for related values,useReducer with action types,5+ useState calls that update together,Medium,https://react.dev/reference/react/useReducer
+4,State,Avoid unnecessary state,Derive values from existing state when possible,Compute derived values in render,Store derivable values in state,const total = items.reduce(...),"const [total, setTotal] = useState(0)",High,https://react.dev/learn/choosing-the-state-structure
+5,State,Initialize state lazily,Use function form for expensive initial state,useState(() => computeExpensive()),useState(computeExpensive()),useState(() => JSON.parse(data)),useState(JSON.parse(data)),Medium,https://react.dev/reference/react/useState#avoiding-recreating-the-initial-state
+6,Effects,Clean up effects,Return cleanup function for subscriptions timers,Return cleanup function in useEffect,No cleanup for subscriptions,useEffect(() => { sub(); return unsub; }),useEffect(() => { subscribe(); }),High,https://react.dev/reference/react/useEffect#connecting-to-an-external-system
+7,Effects,Specify dependencies correctly,Include all values used inside effect in deps array,All referenced values in dependency array,Empty deps with external references,[value] when using value in effect,[] when using props/state in effect,High,https://react.dev/reference/react/useEffect#specifying-reactive-dependencies
+8,Effects,Avoid unnecessary effects,Don't use effects for transforming data or events,Transform data during render handle events directly,useEffect for derived state or event handling,const filtered = items.filter(...),useEffect(() => setFiltered(items.filter(...))),High,https://react.dev/learn/you-might-not-need-an-effect
+9,Effects,Use refs for non-reactive values,Store values that don't trigger re-renders in refs,useRef for interval IDs DOM elements,useState for values that don't need render,const intervalRef = useRef(null),"const [intervalId, setIntervalId] = useState()",Medium,https://react.dev/reference/react/useRef
+10,Rendering,Use keys properly,Stable unique keys for list items,Use stable IDs as keys,Array index as key for dynamic lists,key={item.id},key={index},High,https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key
+11,Rendering,Memoize expensive calculations,Use useMemo for costly computations,useMemo for expensive filtering/sorting,Recalculate every render,"useMemo(() => expensive(), [deps])",const result = expensiveCalc(),Medium,https://react.dev/reference/react/useMemo
+12,Rendering,Memoize callbacks passed to children,Use useCallback for functions passed as props,useCallback for handlers passed to memoized children,New function reference every render,"useCallback(() => {}, [deps])",const handler = () => {},Medium,https://react.dev/reference/react/useCallback
+13,Rendering,Use React.memo wisely,Wrap components that render often with same props,memo for pure components with stable props,memo everything or nothing,memo(ExpensiveList),memo(SimpleButton),Low,https://react.dev/reference/react/memo
+14,Rendering,Avoid inline object/array creation in JSX,Create objects outside render or memoize,Define style objects outside component,Inline objects in props,<div style={styles.container}>,<div style={{ margin: 10 }}>,Medium,
+15,Components,Keep components small and focused,Single responsibility for each component,One concern per component,Large multi-purpose components,<UserAvatar /><UserName />,<UserCard /> with 500 lines,Medium,
+16,Components,Use composition over inheritance,Compose components using children and props,Use children prop for flexibility,Inheritance hierarchies,<Card>{content}</Card>,class SpecialCard extends Card,Medium,https://react.dev/learn/thinking-in-react
+17,Components,Colocate related code,Keep related components and hooks together,Related files in same directory,Flat structure with many files,components/User/UserCard.tsx,components/UserCard.tsx + hooks/useUser.ts,Low,
+18,Components,Use fragments to avoid extra DOM,Fragment or <> for multiple elements without wrapper,<> for grouping without DOM node,Extra div wrappers,<>{items.map(...)}</>,<div>{items.map(...)}</div>,Low,https://react.dev/reference/react/Fragment
+19,Props,Destructure props,Destructure props for cleaner component code,Destructure in function signature,props.name props.value throughout,"function User({ name, age })",function User(props),Low,
+20,Props,Provide default props values,Use default parameters or defaultProps,Default values in destructuring,Undefined checks throughout,function Button({ size = 'md' }),if (size === undefined) size = 'md',Low,
+21,Props,Avoid prop drilling,Use context or composition for deeply nested data,Context for global data composition for UI,Passing props through 5+ levels,<UserContext.Provider>,<A user={u}><B user={u}><C user={u}>,Medium,https://react.dev/learn/passing-data-deeply-with-context
+22,Props,Validate props with TypeScript,Use TypeScript interfaces for prop types,interface Props { name: string },PropTypes or no validation,interface ButtonProps { onClick: () => void },Button.propTypes = {},Medium,
+23,Events,Use synthetic events correctly,React normalizes events across browsers,e.preventDefault() e.stopPropagation(),Access native event unnecessarily,onClick={(e) => e.preventDefault()},onClick={(e) => e.nativeEvent.preventDefault()},Low,https://react.dev/reference/react-dom/components/common#react-event-object
+24,Events,Avoid binding in render,Use arrow functions in class or hooks,Arrow functions in functional components,bind in render or constructor,const handleClick = () => {},this.handleClick.bind(this),Medium,
+25,Events,Pass event handlers not call results,Pass function reference not invocation,onClick={handleClick},onClick={handleClick()} causing immediate call,onClick={handleClick},onClick={handleClick()},High,
+26,Forms,Controlled components for forms,Use state to control form inputs,value + onChange for inputs,Uncontrolled inputs with refs,<input value={val} onChange={setVal}>,<input ref={inputRef}>,Medium,https://react.dev/reference/react-dom/components/input#controlling-an-input-with-a-state-variable
+27,Forms,Handle form submission properly,Prevent default and handle in submit handler,onSubmit with preventDefault,onClick on submit button only,<form onSubmit={handleSubmit}>,<button onClick={handleSubmit}>,Medium,
+28,Forms,Debounce rapid input changes,Debounce search/filter inputs,useDeferredValue or debounce for search,Filter on every keystroke,useDeferredValue(searchTerm),useEffect filtering on every change,Medium,https://react.dev/reference/react/useDeferredValue
+29,Hooks,Follow rules of hooks,Only call hooks at top level and in React functions,Hooks at component top level,Hooks in conditions loops or callbacks,"const [x, setX] = useState()","if (cond) { const [x, setX] = useState() }",High,https://react.dev/reference/rules/rules-of-hooks
+30,Hooks,Custom hooks for reusable logic,Extract shared stateful logic to custom hooks,useCustomHook for reusable patterns,Duplicate hook logic across components,const { data } = useFetch(url),Duplicate useEffect/useState in components,Medium,https://react.dev/learn/reusing-logic-with-custom-hooks
+31,Hooks,Name custom hooks with use prefix,Custom hooks must start with use,useFetch useForm useAuth,fetchData or getData for hook,function useFetch(url),function fetchData(url),High,
+32,Context,Use context for global data,Context for theme auth locale,Context for app-wide state,Context for frequently changing data,<ThemeContext.Provider>,Context for form field values,Medium,https://react.dev/learn/passing-data-deeply-with-context
+33,Context,Split contexts by concern,Separate contexts for different domains,ThemeContext + AuthContext,One giant AppContext,<ThemeProvider><AuthProvider>,<AppProvider value={{theme user...}}>,Medium,
+34,Context,Memoize context values,Prevent unnecessary re-renders with useMemo,useMemo for context value object,New object reference every render,"value={useMemo(() => ({...}), [])}","value={{ user, theme }}",High,
+35,Performance,Use React DevTools Profiler,Profile to identify performance bottlenecks,Profile before optimizing,Optimize without measuring,React DevTools Profiler,Guessing at bottlenecks,Medium,https://react.dev/learn/react-developer-tools
+36,Performance,Lazy load components,Use React.lazy for code splitting,lazy() for routes and heavy components,Import everything upfront,const Page = lazy(() => import('./Page')),import Page from './Page',Medium,https://react.dev/reference/react/lazy
+37,Performance,Virtualize long lists,Use windowing for lists over 100 items,react-window or react-virtual,Render thousands of DOM nodes,<VirtualizedList items={items}/>,{items.map(i => <Item />)},High,
+38,Performance,Batch state updates,React 18 auto-batches but be aware,Let React batch related updates,Manual batching with flushSync,setA(1); setB(2); // batched,flushSync(() => setA(1)),Low,https://react.dev/learn/queueing-a-series-of-state-updates
+39,ErrorHandling,Use error boundaries,Catch JavaScript errors in component tree,ErrorBoundary wrapping sections,Let errors crash entire app,<ErrorBoundary><App/></ErrorBoundary>,No error handling,High,https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary
+40,ErrorHandling,Handle async errors,Catch errors in async operations,try/catch in async handlers,Unhandled promise rejections,try { await fetch() } catch(e) {},await fetch() // no catch,High,
+41,Testing,Test behavior not implementation,Test what user sees and does,Test renders and interactions,Test internal state or methods,expect(screen.getByText('Hello')),expect(component.state.name),Medium,https://testing-library.com/docs/react-testing-library/intro/
+42,Testing,Use testing-library queries,Use accessible queries,getByRole getByLabelText,getByTestId for everything,getByRole('button'),getByTestId('submit-btn'),Medium,https://testing-library.com/docs/queries/about#priority
+43,Accessibility,Use semantic HTML,Proper HTML elements for their purpose,button for clicks nav for navigation,div with onClick for buttons,<button onClick={...}>,<div onClick={...}>,High,https://react.dev/reference/react-dom/components#all-html-components
+44,Accessibility,Manage focus properly,Handle focus for modals dialogs,Focus trap in modals return focus on close,No focus management,useEffect to focus input,Modal without focus trap,High,
+45,Accessibility,Announce dynamic content,Use ARIA live regions for updates,aria-live for dynamic updates,Silent updates to screen readers,"<div aria-live=""polite"">{msg}</div>",<div>{msg}</div>,Medium,
+46,Accessibility,Label form controls,Associate labels with inputs,htmlFor matching input id,Placeholder as only label,"<label htmlFor=""email"">Email</label>","<input placeholder=""Email""/>",High,
+47,TypeScript,Type component props,Define interfaces for all props,interface Props with all prop types,any or missing types,interface Props { name: string },function Component(props: any),High,
+48,TypeScript,Type state properly,Provide types for useState,useState<Type>() for complex state,Inferred any types,useState<User | null>(null),useState(null),Medium,
+49,TypeScript,Type event handlers,Use React event types,React.ChangeEvent<HTMLInputElement>,Generic Event type,onChange: React.ChangeEvent<HTMLInputElement>,onChange: Event,Medium,
+50,TypeScript,Use generics for reusable components,Generic components for flexible typing,Generic props for list components,Union types for flexibility,<List<T> items={T[]}>,<List items={any[]}>,Medium,
+51,Patterns,Container/Presentational split,Separate data logic from UI,Container fetches presentational renders,Mixed data and UI in one,<UserContainer><UserView/></UserContainer>,<User /> with fetch and render,Low,
+52,Patterns,Render props for flexibility,Share code via render prop pattern,Render prop for customizable rendering,Duplicate logic across components,<DataFetcher render={data => ...}/>,Copy paste fetch logic,Low,https://react.dev/reference/react/cloneElement#passing-data-with-a-render-prop
+53,Patterns,Compound components,Related components sharing state,Tab + TabPanel sharing context,Prop drilling between related,<Tabs><Tab/><TabPanel/></Tabs>,<Tabs tabs={[]} panels={[...]}/>,Low,
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/shadcn.csv b/.agents/skills/ui-ux-pro-max/data/stacks/shadcn.csv
new file mode 100644
index 0000000..fb86e8d
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/shadcn.csv
@@ -0,0 +1,61 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Setup,Use CLI for installation,Install components via shadcn CLI for proper setup,npx shadcn@latest add component-name,Manual copy-paste from docs,npx shadcn@latest add button,Copy component code manually,High,https://ui.shadcn.com/docs/cli
+2,Setup,Initialize project properly,Run init command to set up components.json and globals.css,npx shadcn@latest init before adding components,Skip init and add components directly,npx shadcn@latest init,npx shadcn@latest add button (without init),High,https://ui.shadcn.com/docs/installation
+3,Setup,Configure path aliases,Set up proper import aliases in tsconfig and components.json,Use @/components/ui path aliases,Relative imports like ../../components,import { Button } from "@/components/ui/button",import { Button } from "../../components/ui/button",Medium,https://ui.shadcn.com/docs/installation
+4,Theming,Use CSS variables for colors,Define colors as CSS variables in globals.css for theming,CSS variables in :root and .dark,Hardcoded color values in components,bg-primary text-primary-foreground,bg-blue-500 text-white,High,https://ui.shadcn.com/docs/theming
+5,Theming,Follow naming convention,Use semantic color names with foreground pattern,primary/primary-foreground secondary/secondary-foreground,Generic color names,--primary --primary-foreground,--blue --light-blue,Medium,https://ui.shadcn.com/docs/theming
+6,Theming,Support dark mode,Include .dark class styles for all custom CSS,Define both :root and .dark color schemes,Only light mode colors,.dark { --background: 240 10% 3.9%; },No .dark class styles,High,https://ui.shadcn.com/docs/dark-mode
+7,Components,Use component variants,Leverage cva variants for consistent styling,Use variant prop for different styles,Inline conditional classes,<Button variant="destructive">,<Button className={isError ? "bg-red-500" : "bg-blue-500"}>,Medium,https://ui.shadcn.com/docs/components/button
+8,Components,Compose with className,Add custom classes via className prop for overrides,Extend with className for one-off customizations,Modify component source directly,<Button className="w-full">,Edit button.tsx to add w-full,Medium,https://ui.shadcn.com/docs/components/button
+9,Components,Use size variants consistently,Apply size prop for consistent sizing across components,size="sm" size="lg" for sizing,Mix size classes inconsistently,<Button size="lg">,<Button className="text-lg px-8 py-4">,Medium,https://ui.shadcn.com/docs/components/button
+10,Components,Prefer compound components,Use provided sub-components for complex UI,Card + CardHeader + CardContent pattern,Single component with many props,<Card><CardHeader><CardTitle>,<Card title="x" content="y" footer="z">,Medium,https://ui.shadcn.com/docs/components/card
+11,Dialog,Use Dialog for modal content,Dialog component for overlay modal windows,Dialog for confirmations forms details,Alert for modal content,<Dialog><DialogContent>,<Alert> styled as modal,High,https://ui.shadcn.com/docs/components/dialog
+12,Dialog,Handle dialog state properly,Use open and onOpenChange for controlled dialogs,Controlled state with useState,Uncontrolled with default open only,"<Dialog open={open} onOpenChange={setOpen}>","<Dialog defaultOpen={true}>",Medium,https://ui.shadcn.com/docs/components/dialog
+13,Dialog,Include proper dialog structure,Use DialogHeader DialogTitle DialogDescription,Complete semantic structure,Missing title or description,<DialogHeader><DialogTitle><DialogDescription>,<DialogContent><p>Content</p></DialogContent>,High,https://ui.shadcn.com/docs/components/dialog
+14,Sheet,Use Sheet for side panels,Sheet component for slide-out panels and drawers,Sheet for navigation filters settings,Dialog for side content,<Sheet side="right">,<Dialog> with slide animation,Medium,https://ui.shadcn.com/docs/components/sheet
+15,Sheet,Specify sheet side,Set side prop for sheet slide direction,Explicit side="left" or side="right",Default side without consideration,<Sheet><SheetContent side="left">,<Sheet><SheetContent>,Low,https://ui.shadcn.com/docs/components/sheet
+16,Form,Use Form with react-hook-form,Integrate Form component with react-hook-form for validation,useForm + Form + FormField pattern,Custom form handling without Form,<Form {...form}><FormField control={form.control}>,<form onSubmit={handleSubmit}>,High,https://ui.shadcn.com/docs/components/form
+17,Form,Use FormField for inputs,Wrap inputs in FormField for proper labeling and errors,FormField + FormItem + FormLabel + FormControl,Input without FormField wrapper,<FormField><FormItem><FormLabel><FormControl><Input>,<Input onChange={...}>,High,https://ui.shadcn.com/docs/components/form
+18,Form,Display form messages,Use FormMessage for validation error display,FormMessage after FormControl,Custom error text without FormMessage,<FormControl><Input/></FormControl><FormMessage/>,<Input/>{error && <span>{error}</span>},Medium,https://ui.shadcn.com/docs/components/form
+19,Form,Use Zod for validation,Define form schema with Zod for type-safe validation,zodResolver with form schema,Manual validation logic,zodResolver(formSchema),validate: (values) => { if (!values.email) },Medium,https://ui.shadcn.com/docs/components/form
+20,Select,Use Select for dropdowns,Select component for option selection,Select for choosing from list,Native select element,<Select><SelectTrigger><SelectContent>,<select><option>,Medium,https://ui.shadcn.com/docs/components/select
+21,Select,Structure Select properly,Include Trigger Value Content and Items,Complete Select structure,Missing SelectValue or SelectContent,<SelectTrigger><SelectValue/></SelectTrigger><SelectContent><SelectItem>,<Select><option>,High,https://ui.shadcn.com/docs/components/select
+22,Command,Use Command for search,Command component for searchable lists and palettes,Command for command palette search,Input with custom dropdown,<Command><CommandInput><CommandList>,<Input><div className="dropdown">,Medium,https://ui.shadcn.com/docs/components/command
+23,Command,Group command items,Use CommandGroup for categorized items,CommandGroup with heading for sections,Flat list without grouping,<CommandGroup heading="Suggestions"><CommandItem>,<CommandItem> without groups,Low,https://ui.shadcn.com/docs/components/command
+24,Table,Use Table for data display,Table component for structured data,Table for tabular data display,Div grid for table-like layouts,<Table><TableHeader><TableBody><TableRow>,<div className="grid">,Medium,https://ui.shadcn.com/docs/components/table
+25,Table,Include proper table structure,Use TableHeader TableBody TableRow TableCell,Semantic table structure,Missing thead or tbody,<TableHeader><TableRow><TableHead>,<Table><TableRow> without header,High,https://ui.shadcn.com/docs/components/table
+26,DataTable,Use DataTable for complex tables,Combine Table with TanStack Table for features,DataTable pattern for sorting filtering pagination,Custom table implementation,useReactTable + Table components,Custom sort filter pagination logic,Medium,https://ui.shadcn.com/docs/components/data-table
+27,Tabs,Use Tabs for content switching,Tabs component for tabbed interfaces,Tabs for related content sections,Custom tab implementation,<Tabs><TabsList><TabsTrigger><TabsContent>,<div onClick={() => setTab(...)},Medium,https://ui.shadcn.com/docs/components/tabs
+28,Tabs,Set default tab value,Specify defaultValue for initial tab,defaultValue on Tabs component,No default leaving first tab,<Tabs defaultValue="account">,<Tabs> without defaultValue,Low,https://ui.shadcn.com/docs/components/tabs
+29,Accordion,Use Accordion for collapsible,Accordion for expandable content sections,Accordion for FAQ settings panels,Custom collapse implementation,<Accordion><AccordionItem><AccordionTrigger>,<div onClick={() => setOpen(!open)}>,Medium,https://ui.shadcn.com/docs/components/accordion
+30,Accordion,Choose accordion type,Use type="single" or type="multiple" appropriately,type="single" for one open type="multiple" for many,Default type without consideration,<Accordion type="single" collapsible>,<Accordion> without type,Low,https://ui.shadcn.com/docs/components/accordion
+31,Toast,Use Sonner for toasts,Sonner integration for toast notifications,toast() from sonner for notifications,Custom toast implementation,toast("Event created"),setShowToast(true),Medium,https://ui.shadcn.com/docs/components/sonner
+32,Toast,Add Toaster to layout,Include Toaster component in root layout,<Toaster /> in app layout,Toaster in individual pages,app/layout.tsx: <Toaster />,page.tsx: <Toaster />,High,https://ui.shadcn.com/docs/components/sonner
+33,Toast,Use toast variants,Apply toast.success toast.error for context,Semantic toast methods,Generic toast for all messages,toast.success("Saved!") toast.error("Failed"),toast("Saved!") toast("Failed"),Medium,https://ui.shadcn.com/docs/components/sonner
+34,Popover,Use Popover for floating content,Popover for dropdown menus and floating panels,Popover for contextual actions,Absolute positioned divs,<Popover><PopoverTrigger><PopoverContent>,<div className="relative"><div className="absolute">,Medium,https://ui.shadcn.com/docs/components/popover
+35,Popover,Handle popover alignment,Use align and side props for positioning,Explicit alignment configuration,Default alignment for all,<PopoverContent align="start" side="bottom">,<PopoverContent>,Low,https://ui.shadcn.com/docs/components/popover
+36,DropdownMenu,Use DropdownMenu for actions,DropdownMenu for action lists and context menus,DropdownMenu for user menu actions,Popover for action lists,<DropdownMenu><DropdownMenuTrigger><DropdownMenuContent>,<Popover> for menu actions,Medium,https://ui.shadcn.com/docs/components/dropdown-menu
+37,DropdownMenu,Group menu items,Use DropdownMenuGroup and DropdownMenuSeparator,Organized menu with separators,Flat list of items,<DropdownMenuGroup><DropdownMenuItem><DropdownMenuSeparator>,<DropdownMenuItem> without organization,Low,https://ui.shadcn.com/docs/components/dropdown-menu
+38,Tooltip,Use Tooltip for hints,Tooltip for icon buttons and truncated text,Tooltip for additional context,Title attribute for tooltips,<Tooltip><TooltipTrigger><TooltipContent>,<button title="Delete">,Medium,https://ui.shadcn.com/docs/components/tooltip
+39,Tooltip,Add TooltipProvider,Wrap app or section in TooltipProvider,TooltipProvider at app level,TooltipProvider per tooltip,<TooltipProvider><App/></TooltipProvider>,<Tooltip><TooltipProvider>,High,https://ui.shadcn.com/docs/components/tooltip
+40,Skeleton,Use Skeleton for loading,Skeleton component for loading placeholders,Skeleton matching content layout,Spinner for content loading,<Skeleton className="h-4 w-[200px]"/>,<Spinner/> for card loading,Medium,https://ui.shadcn.com/docs/components/skeleton
+41,Skeleton,Match skeleton dimensions,Size skeleton to match loaded content,Skeleton same size as expected content,Generic skeleton size,<Skeleton className="h-12 w-12 rounded-full"/>,<Skeleton/> without sizing,Medium,https://ui.shadcn.com/docs/components/skeleton
+42,AlertDialog,Use AlertDialog for confirms,AlertDialog for destructive action confirmation,AlertDialog for delete confirmations,Dialog for confirmations,<AlertDialog><AlertDialogTrigger><AlertDialogContent>,<Dialog> for delete confirmation,High,https://ui.shadcn.com/docs/components/alert-dialog
+43,AlertDialog,Include action buttons,Use AlertDialogAction and AlertDialogCancel,Standard confirm/cancel pattern,Custom buttons in AlertDialog,<AlertDialogCancel>Cancel</AlertDialogCancel><AlertDialogAction>,<Button>Cancel</Button><Button>Confirm</Button>,Medium,https://ui.shadcn.com/docs/components/alert-dialog
+44,Sidebar,Use Sidebar for navigation,Sidebar component for app navigation,Sidebar for main app navigation,Custom sidebar implementation,<SidebarProvider><Sidebar><SidebarContent>,<div className="w-64 fixed">,Medium,https://ui.shadcn.com/docs/components/sidebar
+45,Sidebar,Wrap in SidebarProvider,Use SidebarProvider for sidebar state management,SidebarProvider at layout level,Sidebar without provider,<SidebarProvider><Sidebar></SidebarProvider>,<Sidebar> without provider,High,https://ui.shadcn.com/docs/components/sidebar
+46,Sidebar,Use SidebarTrigger,Include SidebarTrigger for mobile toggle,SidebarTrigger for responsive toggle,Custom toggle button,<SidebarTrigger/>,<Button onClick={() => toggleSidebar()}>,Medium,https://ui.shadcn.com/docs/components/sidebar
+47,Chart,Use Chart for data viz,Chart component with Recharts integration,Chart component for dashboards,Direct Recharts without wrapper,<ChartContainer config={chartConfig}>,<ResponsiveContainer><BarChart>,Medium,https://ui.shadcn.com/docs/components/chart
+48,Chart,Define chart config,Create chartConfig for consistent theming,chartConfig with color definitions,Inline colors in charts,"{ desktop: { label: ""Desktop"", color: ""#2563eb"" } }",<Bar fill="#2563eb"/>,Medium,https://ui.shadcn.com/docs/components/chart
+49,Chart,Use ChartTooltip,Apply ChartTooltip for interactive charts,ChartTooltip with ChartTooltipContent,Recharts Tooltip directly,<ChartTooltip content={<ChartTooltipContent/>}/>,<Tooltip/> from recharts,Low,https://ui.shadcn.com/docs/components/chart
+50,Blocks,Use blocks for scaffolding,Start from shadcn blocks for common layouts,npx shadcn@latest add dashboard-01,Build dashboard from scratch,npx shadcn@latest add login-01,Custom login page from scratch,Medium,https://ui.shadcn.com/blocks
+51,Blocks,Customize block components,Modify copied block code to fit needs,Edit block files after installation,Use blocks without modification,Customize dashboard-01 layout,Use dashboard-01 as-is,Low,https://ui.shadcn.com/blocks
+52,A11y,Use semantic components,Shadcn components have built-in ARIA,Rely on component accessibility,Override ARIA attributes,<Button> has button role,<div role="button">,High,https://ui.shadcn.com/docs/components/button
+53,A11y,Maintain focus management,Dialog Sheet handle focus automatically,Let components manage focus,Custom focus handling,<Dialog> traps focus,document.querySelector().focus(),High,https://ui.shadcn.com/docs/components/dialog
+54,A11y,Provide labels,Use FormLabel and aria-label appropriately,FormLabel for form inputs,Placeholder as only label,<FormLabel>Email</FormLabel><Input/>,<Input placeholder="Email"/>,High,https://ui.shadcn.com/docs/components/form
+55,Performance,Import components individually,Import only needed components,Named imports from component files,Import all from index,import { Button } from "@/components/ui/button",import { Button Card Dialog } from "@/components/ui",Medium,
+56,Performance,Lazy load dialogs,Dynamic import for heavy dialog content,React.lazy for dialog content,Import all dialogs upfront,const HeavyContent = lazy(() => import('./Heavy')),import HeavyContent from './Heavy',Medium,
+57,Customization,Extend variants with cva,Add new variants using class-variance-authority,Extend buttonVariants for new styles,Inline classes for variants,"variants: { size: { xl: ""h-14 px-8"" } }",className="h-14 px-8",Medium,https://ui.shadcn.com/docs/components/button
+58,Customization,Create custom components,Build new components following shadcn patterns,Use cn() and cva for custom components,Different patterns for custom,const Custom = ({ className }) => <div className={cn("base" className)}>,const Custom = ({ style }) => <div style={style}>,Medium,
+59,Patterns,Use asChild for composition,asChild prop for component composition,Slot pattern with asChild,Wrapper divs for composition,<Button asChild><Link href="/">,<Button><Link href="/"></Link></Button>,Medium,https://ui.shadcn.com/docs/components/button
+60,Patterns,Combine with React Hook Form,Form + useForm for complete forms,RHF Controller with shadcn inputs,Custom form state management,<FormField control={form.control} name="email">,<Input value={email} onChange={(e) => setEmail(e.target.value)},High,https://ui.shadcn.com/docs/components/form
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/svelte.csv b/.agents/skills/ui-ux-pro-max/data/stacks/svelte.csv
new file mode 100644
index 0000000..1c6b456
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/svelte.csv
@@ -0,0 +1,54 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Reactivity,Use $: for reactive statements,Automatic dependency tracking,$: for derived values,Manual recalculation,$: doubled = count * 2,let doubled; count && (doubled = count * 2),Medium,https://svelte.dev/docs/svelte-components#script-3-$-marks-a-statement-as-reactive
+2,Reactivity,Trigger reactivity with assignment,Svelte tracks assignments not mutations,Reassign arrays/objects to trigger update,Mutate without reassignment,"items = [...items, newItem]",items.push(newItem),High,https://svelte.dev/docs/svelte-components#script-2-assignments-are-reactive
+3,Reactivity,Use $state in Svelte 5,Runes for explicit reactivity,let count = $state(0),Implicit reactivity in Svelte 5,let count = $state(0),let count = 0 (Svelte 5),Medium,https://svelte.dev/blog/runes
+4,Reactivity,Use $derived for computed values,$derived replaces $: in Svelte 5,let doubled = $derived(count * 2),$: in Svelte 5,let doubled = $derived(count * 2),$: doubled = count * 2 (Svelte 5),Medium,
+5,Reactivity,Use $effect for side effects,$effect replaces $: side effects,Use $effect for subscriptions,$: for side effects in Svelte 5,$effect(() => console.log(count)),$: console.log(count) (Svelte 5),Medium,
+6,Props,Export let for props,Declare props with export let,export let propName,Props without export,export let count = 0,let count = 0,High,https://svelte.dev/docs/svelte-components#script-1-export-creates-a-component-prop
+7,Props,Use $props in Svelte 5,$props rune for prop access,let { name } = $props(),export let in Svelte 5,"let { name, age = 0 } = $props()",export let name; export let age = 0,Medium,
+8,Props,Provide default values,Default props with assignment,export let count = 0,Required props without defaults,export let count = 0,export let count,Low,
+9,Props,Use spread props,Pass through unknown props,{...$$restProps} on elements,Manual prop forwarding,<button {...$$restProps}>,<button class={$$props.class}>,Low,https://svelte.dev/docs/basic-markup#attributes-and-props
+10,Bindings,Use bind: for two-way binding,Simplified input handling,bind:value for inputs,on:input with manual update,<input bind:value={name}>,<input value={name} on:input={e => name = e.target.value}>,Low,https://svelte.dev/docs/element-directives#bind-property
+11,Bindings,Bind to DOM elements,Reference DOM nodes,bind:this for element reference,querySelector in onMount,<div bind:this={el}>,onMount(() => el = document.querySelector()),Medium,
+12,Bindings,Use bind:group for radios/checkboxes,Simplified group handling,bind:group for radio/checkbox groups,Manual checked handling,"<input type=""radio"" bind:group={selected}>","<input type=""radio"" checked={selected === value}>",Low,
+13,Events,Use on: for event handlers,Event directive syntax,on:click={handler},addEventListener in onMount,<button on:click={handleClick}>,onMount(() => btn.addEventListener()),Medium,https://svelte.dev/docs/element-directives#on-eventname
+14,Events,Forward events with on:event,Pass events to parent,on:click without handler,createEventDispatcher for DOM events,<button on:click>,"dispatch('click', event)",Low,
+15,Events,Use createEventDispatcher,Custom component events,dispatch for custom events,on:event for custom events,"dispatch('save', { data })",on:save without dispatch,Medium,https://svelte.dev/docs/svelte#createeventdispatcher
+16,Lifecycle,Use onMount for initialization,Run code after component mounts,onMount for setup and data fetching,Code in script body for side effects,onMount(() => fetchData()),fetchData() in script body,High,https://svelte.dev/docs/svelte#onmount
+17,Lifecycle,Return cleanup from onMount,Automatic cleanup on destroy,Return function from onMount,Separate onDestroy for paired cleanup,onMount(() => { sub(); return unsub }),onMount(sub); onDestroy(unsub),Medium,
+18,Lifecycle,Use onDestroy sparingly,Only when onMount cleanup not possible,onDestroy for non-mount cleanup,onDestroy for mount-related cleanup,onDestroy for store unsubscribe,onDestroy(() => clearInterval(id)),Low,
+19,Lifecycle,Avoid beforeUpdate/afterUpdate,Usually not needed,Reactive statements instead,beforeUpdate for derived state,$: if (x) doSomething(),beforeUpdate(() => doSomething()),Low,
+20,Stores,Use writable for mutable state,Basic reactive store,writable for shared mutable state,Local variables for shared state,const count = writable(0),let count = 0 in module,Medium,https://svelte.dev/docs/svelte-store#writable
+21,Stores,Use readable for read-only state,External data sources,readable for derived/external data,writable for read-only data,"readable(0, set => interval(set))",writable(0) for timer,Low,https://svelte.dev/docs/svelte-store#readable
+22,Stores,Use derived for computed stores,Combine or transform stores,derived for computed values,Manual subscription for derived,"derived(count, $c => $c * 2)",count.subscribe(c => doubled = c * 2),Medium,https://svelte.dev/docs/svelte-store#derived
+23,Stores,Use $ prefix for auto-subscription,Automatic subscribe/unsubscribe,$storeName in components,Manual subscription,{$count},count.subscribe(c => value = c),High,
+24,Stores,Clean up custom subscriptions,Unsubscribe when component destroys,Return unsubscribe from onMount,Leave subscriptions open,onMount(() => store.subscribe(fn)),store.subscribe(fn) in script,High,
+25,Slots,Use slots for composition,Content projection,<slot> for flexible content,Props for all content,<slot>Default</slot>,"<Component content=""text""/>",Medium,https://svelte.dev/docs/special-elements#slot
+26,Slots,Name slots for multiple areas,Multiple content areas,"<slot name=""header"">",Single slot for complex layouts,"<slot name=""header""><slot name=""footer"">",<slot> with complex conditionals,Low,
+27,Slots,Check slot content with $$slots,Conditional slot rendering,$$slots.name for conditional rendering,Always render slot wrapper,"{#if $$slots.footer}<slot name=""footer""/>{/if}","<div><slot name=""footer""/></div>",Low,
+28,Styling,Use scoped styles by default,Styles scoped to component,<style> for component styles,Global styles for component,:global() only when needed,<style> all global,Medium,https://svelte.dev/docs/svelte-components#style
+29,Styling,Use :global() sparingly,Escape scoping when needed,:global for third-party styling,Global for all styles,:global(.external-lib),<style> without scoping,Medium,
+30,Styling,Use CSS variables for theming,Dynamic styling,CSS custom properties,Inline styles for themes,"style=""--color: {color}""","style=""color: {color}""",Low,
+31,Transitions,Use built-in transitions,Svelte transition directives,transition:fade for simple effects,Manual CSS transitions,<div transition:fade>,<div class:fade={visible}>,Low,https://svelte.dev/docs/element-directives#transition-fn
+32,Transitions,Use in: and out: separately,Different enter/exit animations,in:fly out:fade for asymmetric,Same transition for both,<div in:fly out:fade>,<div transition:fly>,Low,
+33,Transitions,Add local modifier,Prevent ancestor trigger,transition:fade|local,Global transitions for lists,<div transition:slide|local>,<div transition:slide>,Medium,
+34,Actions,Use actions for DOM behavior,Reusable DOM logic,use:action for DOM enhancements,onMount for each usage,<div use:clickOutside>,onMount(() => setupClickOutside(el)),Medium,https://svelte.dev/docs/element-directives#use-action
+35,Actions,Return update and destroy,Lifecycle methods for actions,"Return { update, destroy }",Only initial setup,"return { update(params) {}, destroy() {} }",return destroy only,Medium,
+36,Actions,Pass parameters to actions,Configure action behavior,use:action={params},Hardcoded action behavior,<div use:tooltip={options}>,<div use:tooltip>,Low,
+37,Logic,Use {#if} for conditionals,Template conditionals,{#if} {:else if} {:else},Ternary in expressions,{#if cond}...{:else}...{/if},{cond ? a : b} for complex,Low,https://svelte.dev/docs/logic-blocks#if
+38,Logic,Use {#each} for lists,List rendering,{#each} with key,Map in expression,{#each items as item (item.id)},{items.map(i => `<div>${i}</div>`)},Medium,
+39,Logic,Always use keys in {#each},Proper list reconciliation,(item.id) for unique key,Index as key or no key,{#each items as item (item.id)},"{#each items as item, i (i)}",High,
+40,Logic,Use {#await} for promises,Handle async states,{#await} for loading/error states,Manual promise handling,{#await promise}...{:then}...{:catch},{#if loading}...{#if error},Medium,https://svelte.dev/docs/logic-blocks#await
+41,SvelteKit,Use +page.svelte for routes,File-based routing,+page.svelte for route components,Custom routing setup,routes/about/+page.svelte,routes/About.svelte,Medium,https://kit.svelte.dev/docs/routing
+42,SvelteKit,Use +page.js for data loading,Load data before render,load function in +page.js,onMount for data fetching,export function load() {},onMount(() => fetchData()),High,https://kit.svelte.dev/docs/load
+43,SvelteKit,Use +page.server.js for server-only,Server-side data loading,+page.server.js for sensitive data,+page.js for API keys,+page.server.js with DB access,+page.js with DB access,High,
+44,SvelteKit,Use form actions,Server-side form handling,+page.server.js actions,API routes for forms,export const actions = { default },fetch('/api/submit'),Medium,https://kit.svelte.dev/docs/form-actions
+45,SvelteKit,Use $app/stores for app state,$page $navigating $updated,$page for current page data,Manual URL parsing,import { page } from '$app/stores',window.location.pathname,Medium,https://kit.svelte.dev/docs/modules#$app-stores
+46,Performance,Use {#key} for forced re-render,Reset component state,{#key id} for fresh instance,Manual destroy/create,{#key item.id}<Component/>{/key},on:change={() => component = null},Low,https://svelte.dev/docs/logic-blocks#key
+47,Performance,Avoid unnecessary reactivity,Not everything needs $:,$: only for side effects,$: for simple assignments,$: if (x) console.log(x),$: y = x (when y = x works),Low,
+48,Performance,Use immutable compiler option,Skip equality checks,immutable: true for large lists,Default for all components,<svelte:options immutable/>,Default without immutable,Low,
+49,TypeScript,"Use lang=""ts"" in script",TypeScript support,"<script lang=""ts"">",JavaScript for typed projects,"<script lang=""ts"">",<script> with JSDoc,Medium,https://svelte.dev/docs/typescript
+50,TypeScript,Type props with interface,Explicit prop types,interface $$Props for types,Untyped props,interface $$Props { name: string },export let name,Medium,
+51,TypeScript,Type events with createEventDispatcher,Type-safe events,createEventDispatcher<Events>(),Untyped dispatch,createEventDispatcher<{ save: Data }>(),createEventDispatcher(),Medium,
+52,Accessibility,Use semantic elements,Proper HTML in templates,button nav main appropriately,div for everything,<button on:click>,<div on:click>,High,
+53,Accessibility,Add aria to dynamic content,Accessible state changes,aria-live for updates,Silent dynamic updates,"<div aria-live=""polite"">{message}</div>",<div>{message}</div>,Medium,
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/swiftui.csv b/.agents/skills/ui-ux-pro-max/data/stacks/swiftui.csv
new file mode 100644
index 0000000..e20f9f9
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/swiftui.csv
@@ -0,0 +1,51 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Views,Use struct for views,SwiftUI views are value types,struct MyView: View,class MyView: View,struct ContentView: View { var body: some View },class ContentView: View,High,https://developer.apple.com/documentation/swiftui/view
+2,Views,Keep views small and focused,Single responsibility for each view,Extract subviews for complex layouts,Large monolithic views,Extract HeaderView FooterView,500+ line View struct,Medium,
+3,Views,Use body computed property,body returns the view hierarchy,var body: some View { },func body() -> some View,"var body: some View { Text(""Hello"") }",func body() -> Text,High,
+4,Views,Prefer composition over inheritance,Compose views using ViewBuilder,Combine smaller views,Inheritance hierarchies,VStack { Header() Content() },class SpecialView extends BaseView,Medium,
+5,State,Use @State for local state,Simple value types owned by view,@State for view-local primitives,@State for shared data,@State private var count = 0,@State var sharedData: Model,High,https://developer.apple.com/documentation/swiftui/state
+6,State,Use @Binding for two-way data,Pass mutable state to child views,@Binding for child input,@State in child for parent data,@Binding var isOn: Bool,$isOn to pass binding,Medium,https://developer.apple.com/documentation/swiftui/binding
+7,State,Use @StateObject for reference types,ObservableObject owned by view,@StateObject for view-created objects,@ObservedObject for owned objects,@StateObject private var vm = ViewModel(),@ObservedObject var vm = ViewModel(),High,https://developer.apple.com/documentation/swiftui/stateobject
+8,State,Use @ObservedObject for injected objects,Reference types passed from parent,@ObservedObject for injected dependencies,@StateObject for injected objects,@ObservedObject var vm: ViewModel,@StateObject var vm: ViewModel (injected),High,https://developer.apple.com/documentation/swiftui/observedobject
+9,State,Use @EnvironmentObject for shared state,App-wide state injection,@EnvironmentObject for global state,Prop drilling through views,@EnvironmentObject var settings: Settings,Pass settings through 5 views,Medium,https://developer.apple.com/documentation/swiftui/environmentobject
+10,State,Use @Published in ObservableObject,Automatically publish property changes,@Published for observed properties,Manual objectWillChange calls,@Published var items: [Item] = [],var items: [Item] { didSet { objectWillChange.send() } },Medium,
+11,Observable,Use @Observable macro (iOS 17+),Modern observation without Combine,@Observable class for view models,ObservableObject for new projects,@Observable class ViewModel { },class ViewModel: ObservableObject,Medium,https://developer.apple.com/documentation/observation
+12,Observable,Use @Bindable for @Observable,Create bindings from @Observable,@Bindable var vm for bindings,@Binding with @Observable,@Bindable var viewModel,$viewModel.name with @Observable,Medium,
+13,Layout,Use VStack HStack ZStack,Standard stack-based layouts,Stacks for linear arrangements,GeometryReader for simple layouts,VStack { Text() Image() },GeometryReader for vertical list,Medium,https://developer.apple.com/documentation/swiftui/vstack
+14,Layout,Use LazyVStack LazyHStack for lists,Lazy loading for performance,Lazy stacks for long lists,Regular stacks for 100+ items,LazyVStack { ForEach(items) },VStack { ForEach(largeArray) },High,https://developer.apple.com/documentation/swiftui/lazyvstack
+15,Layout,Use GeometryReader sparingly,Only when needed for sizing,GeometryReader for responsive layouts,GeometryReader everywhere,GeometryReader for aspect ratio,GeometryReader wrapping everything,Medium,
+16,Layout,Use spacing and padding consistently,Consistent spacing throughout app,Design system spacing values,Magic numbers for spacing,.padding(16) or .padding(),".padding(13), .padding(17)",Low,
+17,Layout,Use frame modifiers correctly,Set explicit sizes when needed,.frame(maxWidth: .infinity),Fixed sizes for responsive content,.frame(maxWidth: .infinity),.frame(width: 375),Medium,
+18,Modifiers,Order modifiers correctly,Modifier order affects rendering,Background before padding for full coverage,Wrong modifier order,.padding().background(Color.red),.background(Color.red).padding(),High,
+19,Modifiers,Create custom ViewModifiers,Reusable modifier combinations,ViewModifier for repeated styling,Duplicate modifier chains,struct CardStyle: ViewModifier,.shadow().cornerRadius() everywhere,Medium,https://developer.apple.com/documentation/swiftui/viewmodifier
+20,Modifiers,Use conditional modifiers carefully,Avoid changing view identity,if-else with same view type,Conditional that changes view identity,Text(title).foregroundColor(isActive ? .blue : .gray),if isActive { Text().bold() } else { Text() },Medium,
+21,Navigation,Use NavigationStack (iOS 16+),Modern navigation with type-safe paths,NavigationStack with navigationDestination,NavigationView for new projects,NavigationStack { },NavigationView { } (deprecated),Medium,https://developer.apple.com/documentation/swiftui/navigationstack
+22,Navigation,Use navigationDestination,Type-safe navigation destinations,.navigationDestination(for:),NavigationLink(destination:),.navigationDestination(for: Item.self),NavigationLink(destination: DetailView()),Medium,
+23,Navigation,Use @Environment for dismiss,Programmatic navigation dismissal,@Environment(\.dismiss) var dismiss,presentationMode (deprecated),@Environment(\.dismiss) var dismiss,@Environment(\.presentationMode),Low,
+24,Lists,Use List for scrollable content,Built-in scrolling and styling,List for standard scrollable content,ScrollView + VStack for simple lists,List { ForEach(items) { } },ScrollView { VStack { ForEach } },Low,https://developer.apple.com/documentation/swiftui/list
+25,Lists,Provide stable identifiers,Use Identifiable or explicit id,Identifiable protocol or id parameter,Index as identifier,ForEach(items) where Item: Identifiable,"ForEach(items.indices, id: \.self)",High,
+26,Lists,Use onDelete and onMove,Standard list editing,onDelete for swipe to delete,Custom delete implementation,.onDelete(perform: delete),.onTapGesture for delete,Low,
+27,Forms,Use Form for settings,Grouped input controls,Form for settings screens,Manual grouping for forms,Form { Section { Toggle() } },VStack { Toggle() },Low,https://developer.apple.com/documentation/swiftui/form
+28,Forms,Use @FocusState for keyboard,Manage keyboard focus,@FocusState for text field focus,Manual first responder handling,@FocusState private var isFocused: Bool,UIKit first responder,Medium,https://developer.apple.com/documentation/swiftui/focusstate
+29,Forms,Validate input properly,Show validation feedback,Real-time validation feedback,Submit without validation,TextField with validation state,TextField without error handling,Medium,
+30,Async,Use .task for async work,Automatic cancellation on view disappear,.task for view lifecycle async,onAppear with Task,.task { await loadData() },onAppear { Task { await loadData() } },Medium,https://developer.apple.com/documentation/swiftui/view/task(priority:_:)
+31,Async,Handle loading states,Show progress during async operations,ProgressView during loading,Empty view during load,if isLoading { ProgressView() },No loading indicator,Medium,
+32,Async,Use @MainActor for UI updates,Ensure UI updates on main thread,@MainActor on view models,Manual DispatchQueue.main,@MainActor class ViewModel,DispatchQueue.main.async,Medium,
+33,Animation,Use withAnimation,Animate state changes,withAnimation for state transitions,No animation for state changes,withAnimation { isExpanded.toggle() },isExpanded.toggle(),Low,https://developer.apple.com/documentation/swiftui/withanimation(_:_:)
+34,Animation,Use .animation modifier,Apply animations to views,.animation(.spring()) on view,Manual animation timing,.animation(.easeInOut),CABasicAnimation equivalent,Low,
+35,Animation,Respect reduced motion,Check accessibility settings,Check accessibilityReduceMotion,Ignore motion preferences,@Environment(\.accessibilityReduceMotion),Always animate regardless,High,
+36,Preview,Use #Preview macro (Xcode 15+),Modern preview syntax,#Preview for view previews,PreviewProvider protocol,#Preview { ContentView() },struct ContentView_Previews: PreviewProvider,Low,
+37,Preview,Create multiple previews,Test different states and devices,Multiple previews for states,Single preview only,"#Preview(""Light"") { } #Preview(""Dark"") { }",Single preview configuration,Low,
+38,Preview,Use preview data,Dedicated preview mock data,Static preview data,Production data in previews,Item.preview for preview,Fetch real data in preview,Low,
+39,Performance,Avoid expensive body computations,Body should be fast to compute,Precompute in view model,Heavy computation in body,vm.computedValue in body,Complex calculation in body,High,
+40,Performance,Use Equatable views,Skip unnecessary view updates,Equatable for complex views,Default equality for all views,struct MyView: View Equatable,No Equatable conformance,Medium,
+41,Performance,Profile with Instruments,Measure before optimizing,Use SwiftUI Instruments,Guess at performance issues,Profile with Instruments,Optimize without measuring,Medium,
+42,Accessibility,Add accessibility labels,Describe UI elements,.accessibilityLabel for context,Missing labels,".accessibilityLabel(""Close button"")",Button without label,High,https://developer.apple.com/documentation/swiftui/view/accessibilitylabel(_:)-1d7jv
+43,Accessibility,Support Dynamic Type,Respect text size preferences,Scalable fonts and layouts,Fixed font sizes,.font(.body) with Dynamic Type,.font(.system(size: 16)),High,
+44,Accessibility,Use semantic views,Proper accessibility traits,Correct accessibilityTraits,Wrong semantic meaning,Button for actions Image for display,Image that acts like button,Medium,
+45,Testing,Use ViewInspector for testing,Third-party view testing,ViewInspector for unit tests,UI tests only,ViewInspector assertions,Only XCUITest,Medium,
+46,Testing,Test view models,Unit test business logic,XCTest for view model,Skip view model testing,Test ViewModel methods,No unit tests,Medium,
+47,Testing,Use preview as visual test,Previews catch visual regressions,Multiple preview configurations,No visual verification,Preview different states,Single preview only,Low,
+48,Architecture,Use MVVM pattern,Separate view and logic,ViewModel for business logic,Logic in View,ObservableObject ViewModel,@State for complex logic,Medium,
+49,Architecture,Keep views dumb,Views display view model state,View reads from ViewModel,Business logic in View,view.items from vm.items,Complex filtering in View,Medium,
+50,Architecture,Use dependency injection,Inject dependencies for testing,Initialize with dependencies,Hard-coded dependencies,init(service: ServiceProtocol),let service = RealService(),Medium,
diff --git a/.agents/skills/ui-ux-pro-max/data/stacks/vue.csv b/.agents/skills/ui-ux-pro-max/data/stacks/vue.csv
new file mode 100644
index 0000000..77cb4b0
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/stacks/vue.csv
@@ -0,0 +1,50 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Composition,Use Composition API for new projects,Composition API offers better TypeScript support and logic reuse,<script setup> for components,Options API for new projects,<script setup>,export default { data() },Medium,https://vuejs.org/guide/extras/composition-api-faq.html
+2,Composition,Use script setup syntax,Cleaner syntax with automatic exports,<script setup> with defineProps,setup() function manually,<script setup>,<script> setup() { return {} },Low,https://vuejs.org/api/sfc-script-setup.html
+3,Reactivity,Use ref for primitives,ref() for primitive values that need reactivity,ref() for strings numbers booleans,reactive() for primitives,const count = ref(0),const count = reactive(0),Medium,https://vuejs.org/guide/essentials/reactivity-fundamentals.html
+4,Reactivity,Use reactive for objects,reactive() for complex objects and arrays,reactive() for objects with multiple properties,ref() for complex objects,const state = reactive({ user: null }),const state = ref({ user: null }),Medium,
+5,Reactivity,Access ref values with .value,Remember .value in script unwrap in template,Use .value in script,Forget .value in script,count.value++,count++ (in script),High,
+6,Reactivity,Use computed for derived state,Computed properties cache and update automatically,computed() for derived values,Methods for derived values,const doubled = computed(() => count.value * 2),const doubled = () => count.value * 2,Medium,https://vuejs.org/guide/essentials/computed.html
+7,Reactivity,Use shallowRef for large objects,Avoid deep reactivity for performance,shallowRef for large data structures,ref for large nested objects,const bigData = shallowRef(largeObject),const bigData = ref(largeObject),Medium,https://vuejs.org/api/reactivity-advanced.html#shallowref
+8,Watchers,Use watchEffect for simple cases,Auto-tracks dependencies,watchEffect for simple reactive effects,watch with explicit deps when not needed,watchEffect(() => console.log(count.value)),"watch(count, (val) => console.log(val))",Low,https://vuejs.org/guide/essentials/watchers.html
+9,Watchers,Use watch for specific sources,Explicit control over what to watch,watch with specific refs,watchEffect for complex conditional logic,"watch(userId, fetchUser)",watchEffect with conditionals,Medium,
+10,Watchers,Clean up side effects,Return cleanup function in watchers,Return cleanup in watchEffect,Leave subscriptions open,watchEffect((onCleanup) => { onCleanup(unsub) }),watchEffect without cleanup,High,
+11,Props,Define props with defineProps,Type-safe prop definitions,defineProps with TypeScript,Props without types,defineProps<{ msg: string }>(),defineProps(['msg']),Medium,https://vuejs.org/guide/typescript/composition-api.html#typing-component-props
+12,Props,Use withDefaults for default values,Provide defaults for optional props,withDefaults with defineProps,Defaults in destructuring,"withDefaults(defineProps<Props>(), { count: 0 })",const { count = 0 } = defineProps(),Medium,
+13,Props,Avoid mutating props,Props should be read-only,Emit events to parent for changes,Direct prop mutation,"emit('update:modelValue', newVal)",props.modelValue = newVal,High,
+14,Emits,Define emits with defineEmits,Type-safe event emissions,defineEmits with types,Emit without definition,defineEmits<{ change: [id: number] }>(),"emit('change', id) without define",Medium,https://vuejs.org/guide/typescript/composition-api.html#typing-component-emits
+15,Emits,Use v-model for two-way binding,Simplified parent-child data flow,v-model with modelValue prop,:value + @input manually,"<Child v-model=""value""/>","<Child :value=""value"" @input=""value = $event""/>",Low,https://vuejs.org/guide/components/v-model.html
+16,Lifecycle,Use onMounted for DOM access,DOM is ready in onMounted,onMounted for DOM operations,Access DOM in setup directly,onMounted(() => el.value.focus()),el.value.focus() in setup,High,https://vuejs.org/api/composition-api-lifecycle.html
+17,Lifecycle,Clean up in onUnmounted,Remove listeners and subscriptions,onUnmounted for cleanup,Leave listeners attached,onUnmounted(() => window.removeEventListener()),No cleanup on unmount,High,
+18,Lifecycle,Avoid onBeforeMount for data,Use onMounted or setup for data fetching,Fetch in onMounted or setup,Fetch in onBeforeMount,onMounted(async () => await fetchData()),onBeforeMount(async () => await fetchData()),Low,
+19,Components,Use single-file components,Keep template script style together,.vue files for components,Separate template/script files,Component.vue with all parts,Component.js + Component.html,Low,
+20,Components,Use PascalCase for components,Consistent component naming,PascalCase in imports and templates,kebab-case in script,<MyComponent/>,<my-component/>,Low,https://vuejs.org/style-guide/rules-strongly-recommended.html
+21,Components,Prefer composition over mixins,Composables replace mixins,Composables for shared logic,Mixins for code reuse,const { data } = useApi(),mixins: [apiMixin],Medium,
+22,Composables,Name composables with use prefix,Convention for composable functions,useFetch useAuth useForm,getData or fetchApi,export function useFetch(),export function fetchData(),Medium,https://vuejs.org/guide/reusability/composables.html
+23,Composables,Return refs from composables,Maintain reactivity when destructuring,Return ref values,Return reactive objects that lose reactivity,return { data: ref(null) },return reactive({ data: null }),Medium,
+24,Composables,Accept ref or value params,Use toValue for flexible inputs,toValue() or unref() for params,Only accept ref or only value,const val = toValue(maybeRef),const val = maybeRef.value,Low,https://vuejs.org/api/reactivity-utilities.html#tovalue
+25,Templates,Use v-bind shorthand,Cleaner template syntax,:prop instead of v-bind:prop,Full v-bind syntax,"<div :class=""cls"">","<div v-bind:class=""cls"">",Low,
+26,Templates,Use v-on shorthand,Cleaner event binding,@event instead of v-on:event,Full v-on syntax,"<button @click=""handler"">","<button v-on:click=""handler"">",Low,
+27,Templates,Avoid v-if with v-for,v-if has higher priority causes issues,Wrap in template or computed filter,v-if on same element as v-for,<template v-for><div v-if>,<div v-for v-if>,High,https://vuejs.org/style-guide/rules-essential.html#avoid-v-if-with-v-for
+28,Templates,Use key with v-for,Proper list rendering and updates,Unique key for each item,Index as key for dynamic lists,"v-for=""item in items"" :key=""item.id""","v-for=""(item, i) in items"" :key=""i""",High,
+29,State,Use Pinia for global state,Official state management for Vue 3,Pinia stores for shared state,Vuex for new projects,const store = useCounterStore(),Vuex with mutations,Medium,https://pinia.vuejs.org/
+30,State,Define stores with defineStore,Composition API style stores,Setup stores with defineStore,Options stores for complex state,"defineStore('counter', () => {})","defineStore('counter', { state })",Low,
+31,State,Use storeToRefs for destructuring,Maintain reactivity when destructuring,storeToRefs(store),Direct destructuring,const { count } = storeToRefs(store),const { count } = store,High,https://pinia.vuejs.org/core-concepts/#destructuring-from-a-store
+32,Routing,Use useRouter and useRoute,Composition API router access,useRouter() useRoute() in setup,this.$router this.$route,const router = useRouter(),this.$router.push(),Medium,https://router.vuejs.org/guide/advanced/composition-api.html
+33,Routing,Lazy load route components,Code splitting for routes,() => import() for components,Static imports for all routes,component: () => import('./Page.vue'),component: Page,Medium,https://router.vuejs.org/guide/advanced/lazy-loading.html
+34,Routing,Use navigation guards,Protect routes and handle redirects,beforeEach for auth checks,Check auth in each component,router.beforeEach((to) => {}),Check auth in onMounted,Medium,
+35,Performance,Use v-once for static content,Skip re-renders for static elements,v-once on never-changing content,v-once on dynamic content,<div v-once>{{ staticText }}</div>,<div v-once>{{ dynamicText }}</div>,Low,https://vuejs.org/api/built-in-directives.html#v-once
+36,Performance,Use v-memo for expensive lists,Memoize list items,v-memo with dependency array,Re-render entire list always,"<div v-for v-memo=""[item.id]"">",<div v-for> without memo,Medium,https://vuejs.org/api/built-in-directives.html#v-memo
+37,Performance,Use shallowReactive for flat objects,Avoid deep reactivity overhead,shallowReactive for flat state,reactive for simple objects,shallowReactive({ count: 0 }),reactive({ count: 0 }),Low,
+38,Performance,Use defineAsyncComponent,Lazy load heavy components,defineAsyncComponent for modals dialogs,Import all components eagerly,defineAsyncComponent(() => import()),import HeavyComponent from,Medium,https://vuejs.org/guide/components/async.html
+39,TypeScript,Use generic components,Type-safe reusable components,Generic with defineComponent,Any types in components,"<script setup lang=""ts"" generic=""T"">",<script setup> without types,Medium,https://vuejs.org/guide/typescript/composition-api.html
+40,TypeScript,Type template refs,Proper typing for DOM refs,ref<HTMLInputElement>(null),ref(null) without type,const input = ref<HTMLInputElement>(null),const input = ref(null),Medium,
+41,TypeScript,Use PropType for complex props,Type complex prop types,PropType<User> for object props,Object without type,type: Object as PropType<User>,type: Object,Medium,
+42,Testing,Use Vue Test Utils,Official testing library,mount shallowMount for components,Manual DOM testing,import { mount } from '@vue/test-utils',document.createElement,Medium,https://test-utils.vuejs.org/
+43,Testing,Test component behavior,Focus on inputs and outputs,Test props emit and rendered output,Test internal implementation,expect(wrapper.text()).toContain(),expect(wrapper.vm.internalState),Medium,
+44,Forms,Use v-model modifiers,Built-in input handling,.lazy .number .trim modifiers,Manual input parsing,"<input v-model.number=""age"">","<input v-model=""age""> then parse",Low,https://vuejs.org/guide/essentials/forms.html#modifiers
+45,Forms,Use VeeValidate or FormKit,Form validation libraries,VeeValidate for complex forms,Manual validation logic,useField useForm from vee-validate,Custom validation in each input,Medium,
+46,Accessibility,Use semantic elements,Proper HTML elements in templates,button nav main for purpose,div for everything,<button @click>,<div @click>,High,
+47,Accessibility,Bind aria attributes dynamically,Keep ARIA in sync with state,":aria-expanded=""isOpen""",Static ARIA values,":aria-expanded=""menuOpen""","aria-expanded=""true""",Medium,
+48,SSR,Use Nuxt for SSR,Full-featured SSR framework,Nuxt 3 for SSR apps,Manual SSR setup,npx nuxi init my-app,Custom SSR configuration,Medium,https://nuxt.com/
+49,SSR,Handle hydration mismatches,Client/server content must match,ClientOnly for browser-only content,Different content server/client,<ClientOnly><BrowserWidget/></ClientOnly>,<div>{{ Date.now() }}</div>,High,
diff --git a/.agents/skills/ui-ux-pro-max/data/styles.csv b/.agents/skills/ui-ux-pro-max/data/styles.csv
new file mode 100644
index 0000000..6d60c4d
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/styles.csv
@@ -0,0 +1,59 @@
+STT,Style Category,Type,Keywords,Primary Colors,Secondary Colors,Effects & Animation,Best For,Do Not Use For,Light Mode ✓,Dark Mode ✓,Performance,Accessibility,Mobile-Friendly,Conversion-Focused,Framework Compatibility,Era/Origin,Complexity
+1,Minimalism & Swiss Style,General,"Clean, simple, spacious, functional, white space, high contrast, geometric, sans-serif, grid-based, essential","Monochromatic, Black #000000, White #FFFFFF","Neutral (Beige #F5F1E8, Grey #808080, Taupe #B38B6D), Primary accent","Subtle hover (200-250ms), smooth transitions, sharp shadows if any, clear type hierarchy, fast loading","Enterprise apps, dashboards, documentation sites, SaaS platforms, professional tools","Creative portfolios, entertainment, playful brands, artistic experiments",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,◐ Medium,"Tailwind 10/10, Bootstrap 9/10, MUI 9/10",1950s Swiss,Low
+2,Neumorphism,General,"Soft UI, embossed, debossed, convex, concave, light source, subtle depth, rounded (12-16px), monochromatic","Light pastels: Soft Blue #C8E0F4, Soft Pink #F5E0E8, Soft Grey #E8E8E8","Tints/shades (±30%), gradient subtlety, color harmony","Soft box-shadow (multiple: -5px -5px 15px, 5px 5px 15px), smooth press (150ms), inner subtle shadow","Health/wellness apps, meditation platforms, fitness trackers, minimal interaction UIs","Complex apps, critical accessibility, data-heavy dashboards, high-contrast required",✓ Full,◐ Partial,⚡ Good,⚠ Low contrast,✓ Good,◐ Medium,"Tailwind 8/10, CSS-in-JS 9/10",2020s Modern,Medium
+3,Glassmorphism,General,"Frosted glass, transparent, blurred background, layered, vibrant background, light source, depth, multi-layer","Translucent white: rgba(255,255,255,0.1-0.3)","Vibrant: Electric Blue #0080FF, Neon Purple #8B00FF, Vivid Pink #FF1493, Teal #20B2AA","Backdrop blur (10-20px), subtle border (1px solid rgba white 0.2), light reflection, Z-depth","Modern SaaS, financial dashboards, high-end corporate, lifestyle apps, modal overlays, navigation","Low-contrast backgrounds, critical accessibility, performance-limited, dark text on dark",✓ Full,✓ Full,⚠ Good,⚠ Ensure 4.5:1,✓ Good,✓ High,"Tailwind 9/10, MUI 8/10, Chakra 8/10",2020s Modern,Medium
+4,Brutalism,General,"Raw, unpolished, stark, high contrast, plain text, default fonts, visible borders, asymmetric, anti-design","Primary: Red #FF0000, Blue #0000FF, Yellow #FFFF00, Black #000000, White #FFFFFF","Limited: Neon Green #00FF00, Hot Pink #FF00FF, minimal secondary","No smooth transitions (instant), sharp corners (0px), bold typography (700+), visible grid, large blocks","Design portfolios, artistic projects, counter-culture brands, editorial/media sites, tech blogs","Corporate environments, conservative industries, critical accessibility, customer-facing professional",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,◐ Medium,✗ Low,"Tailwind 10/10, Bootstrap 7/10",1950s Brutalist,Low
+5,3D & Hyperrealism,General,"Depth, realistic textures, 3D models, spatial navigation, tactile, skeuomorphic elements, rich detail, immersive","Deep Navy #001F3F, Forest Green #228B22, Burgundy #800020, Gold #FFD700, Silver #C0C0C0","Complex gradients (5-10 stops), realistic lighting, shadow variations (20-40% darker)","WebGL/Three.js 3D, realistic shadows (layers), physics lighting, parallax (3-5 layers), smooth 3D (300-400ms)","Gaming, product showcase, immersive experiences, high-end e-commerce, architectural viz, VR/AR","Low-end mobile, performance-limited, critical accessibility, data tables/forms",◐ Partial,◐ Partial,❌ Poor,⚠ Not accessible,✗ Low,◐ Medium,"Three.js 10/10, R3F 10/10, Babylon.js 10/10",2020s Modern,High
+6,Vibrant & Block-based,General,"Bold, energetic, playful, block layout, geometric shapes, high color contrast, duotone, modern, energetic","Neon Green #39FF14, Electric Purple #BF00FF, Vivid Pink #FF1493, Bright Cyan #00FFFF, Sunburst #FFAA00","Complementary: Orange #FF7F00, Shocking Pink #FF006E, Lime #CCFF00, triadic schemes","Large sections (48px+ gaps), animated patterns, bold hover (color shift), scroll-snap, large type (32px+), 200-300ms","Startups, creative agencies, gaming, social media, youth-focused, entertainment, consumer","Financial institutions, healthcare, formal business, government, conservative, elderly",✓ Full,✓ Full,⚡ Good,◐ Ensure WCAG,✓ High,✓ High,"Tailwind 10/10, Chakra 9/10, Styled 9/10",2020s Modern,Medium
+7,Dark Mode (OLED),General,"Dark theme, low light, high contrast, deep black, midnight blue, eye-friendly, OLED, night mode, power efficient","Deep Black #000000, Dark Grey #121212, Midnight Blue #0A0E27","Vibrant accents: Neon Green #39FF14, Electric Blue #0080FF, Gold #FFD700, Plasma Purple #BF00FF","Minimal glow (text-shadow: 0 0 10px), dark-to-light transitions, low white emission, high readability, visible focus","Night-mode apps, coding platforms, entertainment, eye-strain prevention, OLED devices, low-light","Print-first content, high-brightness outdoor, color-accuracy-critical",✗ No,✓ Only,⚡ Excellent,✓ WCAG AAA,✓ High,◐ Low,"Tailwind 10/10, MUI 10/10, Chakra 10/10",2020s Modern,Low
+8,Accessible & Ethical,General,"High contrast, large text (16px+), keyboard navigation, screen reader friendly, WCAG compliant, focus state, semantic","WCAG AA/AAA (4.5:1 min), simple primary, clear secondary, high luminosity (7:1+)","Symbol-based colors (not color-only), supporting patterns, inclusive combinations","Clear focus rings (3-4px), ARIA labels, skip links, responsive design, reduced motion, 44x44px touch targets","Government, healthcare, education, inclusive products, large audience, legal compliance, public",None - accessibility universal,✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"All frameworks 10/10",Universal,Low
+9,Claymorphism,General,"Soft 3D, chunky, playful, toy-like, bubbly, thick borders (3-4px), double shadows, rounded (16-24px)","Pastel: Soft Peach #FDBCB4, Baby Blue #ADD8E6, Mint #98FF98, Lilac #E6E6FA, light BG","Soft gradients (pastel-to-pastel), light/dark variations (20-30%), gradient subtle","Inner+outer shadows (subtle, no hard lines), soft press (200ms ease-out), fluffy elements, smooth transitions","Educational apps, children's apps, SaaS platforms, creative tools, fun-focused, onboarding, casual games","Formal corporate, professional services, data-critical, serious/medical, legal apps, finance",✓ Full,◐ Partial,⚡ Good,⚠ Ensure 4.5:1,✓ High,✓ High,"Tailwind 9/10, CSS-in-JS 9/10",2020s Modern,Medium
+10,Aurora UI,General,"Vibrant gradients, smooth blend, Northern Lights effect, mesh gradient, luminous, atmospheric, abstract","Complementary: Blue-Orange, Purple-Yellow, Electric Blue #0080FF, Magenta #FF1493, Cyan #00FFFF","Smooth transitions (Blue→Purple→Pink→Teal), iridescent effects, blend modes (screen, multiply)","Large flowing CSS/SVG gradients, subtle 8-12s animations, depth via color layering, smooth morph","Modern SaaS, creative agencies, branding, music platforms, lifestyle, premium products, hero sections","Data-heavy dashboards, critical accessibility, content-heavy where distraction issues",✓ Full,✓ Full,⚠ Good,⚠ Text contrast,✓ Good,✓ High,"Tailwind 9/10, CSS-in-JS 10/10",2020s Modern,Medium
+11,Retro-Futurism,General,"Vintage sci-fi, 80s aesthetic, neon glow, geometric patterns, CRT scanlines, pixel art, cyberpunk, synthwave","Neon Blue #0080FF, Hot Pink #FF006E, Cyan #00FFFF, Deep Black #1A1A2E, Purple #5D34D0","Metallic Silver #C0C0C0, Gold #FFD700, duotone, 80s Pink #FF10F0, neon accents","CRT scanlines (::before overlay), neon glow (text-shadow+box-shadow), glitch effects (skew/offset keyframes)","Gaming, entertainment, music platforms, tech brands, artistic projects, nostalgic, cyberpunk","Conservative industries, critical accessibility, professional/corporate, elderly, legal/finance",✓ Full,✓ Dark focused,⚠ Moderate,⚠ High contrast/strain,◐ Medium,◐ Medium,"Tailwind 8/10, CSS-in-JS 9/10",1980s Retro,Medium
+12,Flat Design,General,"2D, minimalist, bold colors, no shadows, clean lines, simple shapes, typography-focused, modern, icon-heavy","Solid bright: Red, Orange, Blue, Green, limited palette (4-6 max)","Complementary colors, muted secondaries, high saturation, clean accents","No gradients/shadows, simple hover (color/opacity shift), fast loading, clean transitions (150-200ms ease), minimal icons","Web apps, mobile apps, cross-platform, startup MVPs, user-friendly, SaaS, dashboards, corporate","Complex 3D, premium/luxury, artistic portfolios, immersive experiences, high-detail",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Bootstrap 10/10, MUI 9/10",2010s Modern,Low
+13,Skeuomorphism,General,"Realistic, texture, depth, 3D appearance, real-world metaphors, shadows, gradients, tactile, detailed, material","Rich realistic: wood, leather, metal colors, detailed gradients (8-12 stops), metallic effects","Realistic lighting gradients, shadow variations (30-50% darker), texture overlays, material colors","Realistic shadows (layers), depth (perspective), texture details (noise, grain), realistic animations (300-500ms)","Legacy apps, gaming, immersive storytelling, premium products, luxury, realistic simulations, education","Modern enterprise, critical accessibility, low-performance, web (use Flat/Modern)",◐ Partial,◐ Partial,❌ Poor,⚠ Textures reduce readability,✗ Low,◐ Medium,"CSS-in-JS 7/10, Custom 8/10",2007-2012 iOS,High
+14,Liquid Glass,General,"Flowing glass, morphing, smooth transitions, fluid effects, translucent, animated blur, iridescent, chromatic aberration","Vibrant iridescent (rainbow spectrum), translucent base with opacity shifts, gradient fluidity","Chromatic aberration (Red-Cyan), iridescent oil-spill, fluid gradient blends, holographic effects","Morphing elements (SVG/CSS), fluid animations (400-600ms curves), dynamic blur (backdrop-filter), color transitions","Premium SaaS, high-end e-commerce, creative platforms, branding experiences, luxury portfolios","Performance-limited, critical accessibility, complex data, budget projects",✓ Full,✓ Full,⚠ Moderate-Poor,⚠ Text contrast,◐ Medium,✓ High,"Framer Motion 10/10, GSAP 10/10",2020s Modern,High
+15,Motion-Driven,General,"Animation-heavy, microinteractions, smooth transitions, scroll effects, parallax, entrance anim, page transitions","Bold colors emphasize movement, high contrast animated, dynamic gradients, accent action colors","Transitional states, success (Green #22C55E), error (Red #EF4444), neutral feedback","Scroll anim (Intersection Observer), hover (300-400ms), entrance, parallax (3-5 layers), page transitions","Portfolio sites, storytelling platforms, interactive experiences, entertainment apps, creative, SaaS","Data dashboards, critical accessibility, low-power devices, content-heavy, motion-sensitive",✓ Full,✓ Full,⚠ Good,⚠ Prefers-reduced-motion,✓ Good,✓ High,"GSAP 10/10, Framer Motion 10/10",2020s Modern,High
+16,Micro-interactions,General,"Small animations, gesture-based, tactile feedback, subtle animations, contextual interactions, responsive","Subtle color shifts (10-20%), feedback: Green #22C55E, Red #EF4444, Amber #F59E0B","Accent feedback, neutral supporting, clear action indicators","Small hover (50-100ms), loading spinners, success/error state anim, gesture-triggered (swipe/pinch), haptic","Mobile apps, touchscreen UIs, productivity tools, user-friendly, consumer apps, interactive components","Desktop-only, critical performance, accessibility-first (alternatives needed)",✓ Full,✓ Full,⚡ Excellent,✓ Good,✓ High,✓ High,"Framer Motion 10/10, React Spring 9/10",2020s Modern,Medium
+17,Inclusive Design,General,"Accessible, color-blind friendly, high contrast, haptic feedback, voice interaction, screen reader, WCAG AAA, universal","WCAG AAA (7:1+ contrast), avoid red-green only, symbol-based indicators, high contrast primary","Supporting patterns (stripes, dots, hatch), symbols, combinations, clear non-color indicators","Haptic feedback (vibration), voice guidance, focus indicators (4px+ ring), motion options, alt content, semantic","Public services, education, healthcare, finance, government, accessible consumer, inclusive",None - accessibility universal,✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"All frameworks 10/10",Universal,Low
+18,Zero Interface,General,"Minimal visible UI, voice-first, gesture-based, AI-driven, invisible controls, predictive, context-aware, ambient","Neutral backgrounds: Soft white #FAFAFA, light grey #F0F0F0, warm off-white #F5F1E8","Subtle feedback: light green, light red, minimal UI elements, soft accents","Voice recognition UI, gesture detection, AI predictions (smooth reveal), progressive disclosure, smart suggestions","Voice assistants, AI platforms, future-forward UX, smart home, contextual computing, ambient experiences","Complex workflows, data-entry heavy, traditional systems, legacy support, explicit control",✓ Full,✓ Full,⚡ Excellent,✓ Excellent,✓ High,✓ High,"Tailwind 10/10, Custom 10/10",2020s AI-Era,Low
+19,Soft UI Evolution,General,"Evolved soft UI, better contrast, modern aesthetics, subtle depth, accessibility-focused, improved shadows, hybrid","Improved contrast pastels: Soft Blue #87CEEB, Soft Pink #FFB6C1, Soft Green #90EE90, better hierarchy","Better combinations, accessible secondary, supporting with improved contrast, modern accents","Improved shadows (softer than flat, clearer than neumorphism), modern (200-300ms), focus visible, WCAG AA/AAA","Modern enterprise apps, SaaS platforms, health/wellness, modern business tools, professional, hybrid","Extreme minimalism, critical performance, systems without modern OS",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA+,✓ High,✓ High,"Tailwind 9/10, MUI 9/10, Chakra 9/10",2020s Modern,Medium
+20,Hero-Centric Design,Landing Page,"Large hero section, compelling headline, high-contrast CTA, product showcase, value proposition, hero image/video, dramatic visual","Brand primary color, white/light backgrounds for contrast, accent color for CTA","Supporting colors for secondary CTAs, accent highlights, trust elements (testimonials, logos)","Smooth scroll reveal, fade-in animations on hero, subtle background parallax, CTA glow/pulse effect","SaaS landing pages, product launches, service landing pages, B2B platforms, tech companies","Complex navigation, multi-page experiences, data-heavy applications",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Full,✓ Very High,"Tailwind 10/10, Bootstrap 9/10",2020s Modern,Medium
+21,Conversion-Optimized,Landing Page,"Form-focused, minimalist design, single CTA focus, high contrast, urgency elements, trust signals, social proof, clear value","Primary brand color, high-contrast white/light backgrounds, warning/urgency colors for time-limited offers","Secondary CTA color (muted), trust element colors (testimonial highlights), accent for key benefits","Hover states on CTA (color shift, slight scale), form field focus animations, loading spinner, success feedback","E-commerce product pages, free trial signups, lead generation, SaaS pricing pages, limited-time offers","Complex feature explanations, multi-product showcases, technical documentation",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ Full (mobile-optimized),✓ Very High
+22,Feature-Rich Showcase,Landing Page,"Multiple feature sections, grid layout, benefit cards, visual feature demonstrations, interactive elements, problem-solution pairs","Primary brand, bright secondary colors for feature cards, contrasting accent for CTAs","Supporting colors for: benefits (green), problems (red/orange), features (blue/purple), social proof (neutral)","Card hover effects (lift/scale), icon animations on scroll, feature toggle animations, smooth section transitions","Enterprise SaaS, software tools landing pages, platform services, complex product explanations, B2B products","Simple product pages, early-stage startups with few features, entertainment landing pages",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Good,✓ High
+23,Minimal & Direct,Landing Page,"Minimal text, white space heavy, single column layout, direct messaging, clean typography, visual-centric, fast-loading","Monochromatic primary, white background, single accent color for CTA, black/dark grey text","Minimal secondary colors, reserved for critical CTAs only, neutral supporting elements","Very subtle hover effects, minimal animations, fast page load (no heavy animations), smooth scroll","Simple service landing pages, indie products, consulting services, micro SaaS, freelancer portfolios","Feature-heavy products, complex explanations, multi-product showcases",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ Full,✓ High
+24,Social Proof-Focused,Landing Page,"Testimonials prominent, client logos displayed, case studies sections, reviews/ratings, user avatars, success metrics, credibility markers","Primary brand, trust colors (blue), success/growth colors (green), neutral backgrounds","Testimonial highlight colors, logo grid backgrounds (light grey), badge/achievement colors","Testimonial carousel animations, logo grid fade-in, stat counter animations (number count-up), review star ratings","B2B SaaS, professional services, premium products, e-commerce conversion pages, established brands","Startup MVPs, products without users, niche/experimental products",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Full,✓ High
+25,Interactive Product Demo,Landing Page,"Embedded product mockup/video, interactive elements, product walkthrough, step-by-step guides, hover-to-reveal features, embedded demos","Primary brand, interface colors matching product, demo highlight colors for interactive elements","Product UI colors, tutorial step colors (numbered progression), hover state indicators","Product animation playback, step progression animations, hover reveal effects, smooth zoom on interaction","SaaS platforms, tool/software products, productivity apps landing pages, developer tools, productivity software","Simple services, consulting, non-digital products, complexity-averse audiences",✓ Full,✓ Full,⚠ Good (video/interactive),✓ WCAG AA,✓ Good,✓ Very High
+26,Trust & Authority,Landing Page,"Certificates/badges displayed, expert credentials, case studies with metrics, before/after comparisons, industry recognition, security badges","Professional colors (blue/grey), trust colors, certification badge colors (gold/silver accents)","Certificate highlight colors, metric showcase colors, comparison highlight (success green)","Badge hover effects, metric pulse animations, certificate carousel, smooth stat reveal","Healthcare/medical landing pages, financial services, enterprise software, premium/luxury products, legal services","Casual products, entertainment, viral/social-first products",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ Full,✓ High
+27,Storytelling-Driven,Landing Page,"Narrative flow, visual story progression, section transitions, consistent character/brand voice, emotional messaging, journey visualization","Brand primary, warm/emotional colors, varied accent colors per story section, high visual variety","Story section color coding, emotional state colors (calm, excitement, success), transitional gradients","Section-to-section animations, scroll-triggered reveals, character/icon animations, morphing transitions, parallax narrative","Brand/startup stories, mission-driven products, premium/lifestyle brands, documentary-style products, educational","Technical/complex products (unless narrative-driven), traditional enterprise software",✓ Full,✓ Full,⚠ Moderate (animations),✓ WCAG AA,✓ Good,✓ High
+28,Data-Dense Dashboard,BI/Analytics,"Multiple charts/widgets, data tables, KPI cards, minimal padding, grid layout, space-efficient, maximum data visibility","Neutral primary (light grey/white #F5F5F5), data colors (blue/green/red), dark text #333333","Chart colors: success (green #22C55E), warning (amber #F59E0B), alert (red #EF4444), neutral (grey)","Hover tooltips, chart zoom on click, row highlighting on hover, smooth filter animations, data loading spinners","Business intelligence dashboards, financial analytics, enterprise reporting, operational dashboards, data warehousing","Marketing dashboards, consumer-facing analytics, simple reporting",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,◐ Medium,✗ Not applicable
+29,Heat Map & Heatmap Style,BI/Analytics,"Color-coded grid/matrix, data intensity visualization, geographical heat maps, correlation matrices, cell-based representation, gradient coloring","Gradient scale: Cool (blue #0080FF) to hot (red #FF0000), neutral middle (white/yellow)","Support gradients: Light (cool blue) to dark (warm red), divergent for positive/negative data, monochromatic options","Color gradient transitions on data change, cell highlighting on hover, tooltip reveal on click, smooth color animation","Geographical analysis, performance matrices, correlation analysis, user behavior heatmaps, temperature/intensity data","Linear data representation, categorical comparisons (use bar charts), small datasets",✓ Full,✓ Full (with adjustments),⚡ Excellent,⚠ Colorblind considerations,◐ Medium,✗ Not applicable
+30,Executive Dashboard,BI/Analytics,"High-level KPIs, large key metrics, minimal detail, summary view, trend indicators, at-a-glance insights, executive summary","Brand colors, professional palette (blue/grey/white), accent for KPIs, red for alerts/concerns","KPI highlight colors: positive (green), negative (red), neutral (grey), trend arrow colors","KPI value animations (count-up), trend arrow direction animations, metric card hover lift, alert pulse effect","C-suite dashboards, business summary reports, decision-maker dashboards, strategic planning views","Detailed analyst dashboards, technical deep-dives, operational monitoring",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✗ Low (not mobile-optimized),✗ Not applicable
+31,Real-Time Monitoring,BI/Analytics,"Live data updates, status indicators, alert notifications, streaming data visualization, active monitoring, streaming charts","Alert colors: critical (red #FF0000), warning (orange #FFA500), normal (green #22C55E), updating (blue animation)","Status indicator colors, chart line colors varying by metric, streaming data highlight colors","Real-time chart animations, alert pulse/glow, status indicator blink animation, smooth data stream updates, loading effect","System monitoring dashboards, DevOps dashboards, real-time analytics, stock market dashboards, live event tracking","Historical analysis, long-term trend reports, archived data dashboards",✓ Full,✓ Full,⚡ Good (real-time load),✓ WCAG AA,◐ Medium,✗ Not applicable
+32,Drill-Down Analytics,BI/Analytics,"Hierarchical data exploration, expandable sections, interactive drill-down paths, summary-to-detail flow, context preservation","Primary brand, breadcrumb colors, drill-level indicator colors, hierarchy depth colors","Drill-down path indicator colors, level-specific colors, highlight colors for selected level, transition colors","Drill-down expand animations, breadcrumb click transitions, smooth detail reveal, level change smooth, data reload animation","Sales analytics, product analytics, funnel analysis, multi-dimensional data exploration, business intelligence","Simple linear data, single-metric dashboards, streaming real-time dashboards",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,◐ Medium,✗ Not applicable
+33,Comparative Analysis Dashboard,BI/Analytics,"Side-by-side comparisons, period-over-period metrics, A/B test results, regional comparisons, performance benchmarks","Comparison colors: primary (blue), comparison (orange/purple), delta indicator (green/red)","Winning metric color (green), losing metric color (red), neutral comparison (grey), benchmark colors","Comparison bar animations (grow to value), delta indicator animations (direction arrows), highlight on compare","Period-over-period reporting, A/B test dashboards, market comparison, competitive analysis, regional performance","Single metric dashboards, future projections (use forecasting), real-time only (no historical)",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,◐ Medium,✗ Not applicable
+34,Predictive Analytics,BI/Analytics,"Forecast lines, confidence intervals, trend projections, scenario modeling, AI-driven insights, anomaly detection visualization","Forecast line color (distinct from actual), confidence interval shading, anomaly highlight (red alert), trend colors","High confidence (dark color), low confidence (light color), anomaly colors (red/orange), normal trend (green/blue)","Forecast line animation on draw, confidence band fade-in, anomaly pulse alert, smoothing function animations","Forecasting dashboards, anomaly detection systems, trend prediction dashboards, AI-powered analytics, budget planning","Historical-only dashboards, simple reporting, real-time operational dashboards",✓ Full,✓ Full,⚠ Good (computation),✓ WCAG AA,◐ Medium,✗ Not applicable
+35,User Behavior Analytics,BI/Analytics,"Funnel visualization, user flow diagrams, conversion tracking, engagement metrics, user journey mapping, cohort analysis","Funnel stage colors: high engagement (green), drop-off (red), conversion (blue), user flow arrows (grey)","Stage completion colors (success), abandonment colors (warning), engagement levels (gradient), cohort colors","Funnel animation (fill-down), flow diagram animations (connection draw), conversion pulse, engagement bar fill","Conversion funnel analysis, user journey tracking, engagement analytics, cohort analysis, retention tracking","Real-time operational metrics, technical system monitoring, financial transactions",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Good,✗ Not applicable
+36,Financial Dashboard,BI/Analytics,"Revenue metrics, profit/loss visualization, budget tracking, financial ratios, portfolio performance, cash flow, audit trail","Financial colors: profit (green #22C55E), loss (red #EF4444), neutral (grey), trust (dark blue #003366)","Revenue highlight (green), expenses (red), budget variance (orange/red), balance (grey), accuracy (blue)","Number animations (count-up), trend direction indicators, percentage change animations, profit/loss color transitions","Financial reporting, accounting dashboards, portfolio tracking, budget monitoring, banking analytics","Simple business dashboards, entertainment/social metrics, non-financial data",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✗ Low,✗ Not applicable
+37,Sales Intelligence Dashboard,BI/Analytics,"Deal pipeline, sales metrics, territory performance, sales rep leaderboard, win-loss analysis, quota tracking, forecast accuracy","Sales colors: won (green), lost (red), in-progress (blue), blocked (orange), quota met (gold), quota missed (grey)","Pipeline stage colors, rep performance colors, quota achievement colors, forecast accuracy colors","Deal movement animations, metric updates, leaderboard ranking changes, gauge needle movements, status change highlights","CRM dashboards, sales management, opportunity tracking, performance management, quota planning","Marketing analytics, customer support metrics, HR dashboards",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,◐ Medium,✗ Not applicable,"Recharts 9/10, Chart.js 9/10",2020s Modern,Medium
+38,Neubrutalism,General,"Bold borders, black outlines, primary colors, thick shadows, no gradients, flat colors, 45° shadows, playful, Gen Z","#FFEB3B (Yellow), #FF5252 (Red), #2196F3 (Blue), #000000 (Black borders)","Limited accent colors, high contrast combinations, no gradients allowed","box-shadow: 4px 4px 0 #000, border: 3px solid #000, no gradients, sharp corners (0px), bold typography","Gen Z brands, startups, creative agencies, Figma-style apps, Notion-style interfaces, tech blogs","Luxury brands, finance, healthcare, conservative industries (too playful)",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Bootstrap 8/10",2020s Modern,Low
+39,Bento Box Grid,General,"Modular cards, asymmetric grid, varied sizes, Apple-style, dashboard tiles, negative space, clean hierarchy, cards","Neutral base + brand accent, #FFFFFF, #F5F5F5, brand primary","Subtle gradients, shadow variations, accent highlights for interactive cards","grid-template with varied spans, rounded-xl (16px), subtle shadows, hover scale (1.02), smooth transitions","Dashboards, product pages, portfolios, Apple-style marketing, feature showcases, SaaS","Dense data tables, text-heavy content, real-time monitoring",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, CSS Grid 10/10",2020s Apple,Low
+40,Y2K Aesthetic,General,"Neon pink, chrome, metallic, bubblegum, iridescent, glossy, retro-futurism, 2000s, futuristic nostalgia","#FF69B4 (Hot Pink), #00FFFF (Cyan), #C0C0C0 (Silver), #9400D3 (Purple)","Metallic gradients, glossy overlays, iridescent effects, chrome textures","linear-gradient metallic, glossy buttons, 3D chrome effects, glow animations, bubble shapes","Fashion brands, music platforms, Gen Z brands, nostalgia marketing, entertainment, youth-focused","B2B enterprise, healthcare, finance, conservative industries, elderly users",✓ Full,◐ Partial,⚠ Good,⚠ Check contrast,✓ Good,✓ High,"Tailwind 8/10, CSS-in-JS 9/10",Y2K 2000s,Medium
+41,Cyberpunk UI,General,"Neon, dark mode, terminal, HUD, sci-fi, glitch, dystopian, futuristic, matrix, tech noir","#00FF00 (Matrix Green), #FF00FF (Magenta), #00FFFF (Cyan), #0D0D0D (Dark)","Neon gradients, scanline overlays, glitch colors, terminal green accents","Neon glow (text-shadow), glitch animations (skew/offset), scanlines (::before overlay), terminal fonts","Gaming platforms, tech products, crypto apps, sci-fi applications, developer tools, entertainment","Corporate enterprise, healthcare, family apps, conservative brands, elderly users",✗ No,✓ Only,⚠ Moderate,⚠ Limited (dark+neon),◐ Medium,◐ Medium,"Tailwind 8/10, Custom CSS 10/10",2020s Cyberpunk,Medium
+42,Organic Biophilic,General,"Nature, organic shapes, green, sustainable, rounded, flowing, wellness, earthy, natural textures","#228B22 (Forest Green), #8B4513 (Earth Brown), #87CEEB (Sky Blue), #F5F5DC (Beige)","Natural gradients, earth tones, sky blues, organic textures, wood/stone colors","Rounded corners (16-24px), organic curves (border-radius variations), natural shadows, flowing SVG shapes","Wellness apps, sustainability brands, eco products, health apps, meditation, organic food brands","Tech-focused products, gaming, industrial, urban brands",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, CSS 10/10",2020s Sustainable,Low
+43,AI-Native UI,General,"Chatbot, conversational, voice, assistant, agentic, ambient, minimal chrome, streaming text, AI interactions","Neutral + single accent, #6366F1 (AI Purple), #10B981 (Success), #F5F5F5 (Background)","Status indicators, streaming highlights, context card colors, subtle accent variations","Typing indicators (3-dot pulse), streaming text animations, pulse animations, context cards, smooth reveals","AI products, chatbots, voice assistants, copilots, AI-powered tools, conversational interfaces","Traditional forms, data-heavy dashboards, print-first content",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, React 10/10",2020s AI-Era,Low
+44,Memphis Design,General,"80s, geometric, playful, postmodern, shapes, patterns, squiggles, triangles, neon, abstract, bold","#FF71CE (Hot Pink), #FFCE5C (Yellow), #86CCCA (Teal), #6A7BB4 (Blue Purple)","Complementary geometric colors, pattern fills, contrasting accent shapes","transform: rotate(), clip-path: polygon(), mix-blend-mode, repeating patterns, bold shapes","Creative agencies, music sites, youth brands, event promotion, artistic portfolios, entertainment","Corporate finance, healthcare, legal, elderly users, conservative brands",✓ Full,✓ Full,⚡ Excellent,⚠ Check contrast,✓ Good,◐ Medium,"Tailwind 9/10, CSS 10/10",1980s Postmodern,Medium
+45,Vaporwave,General,"Synthwave, retro-futuristic, 80s-90s, neon, glitch, nostalgic, sunset gradient, dreamy, aesthetic","#FF71CE (Pink), #01CDFE (Cyan), #05FFA1 (Mint), #B967FF (Purple)","Sunset gradients, glitch overlays, VHS effects, neon accents, pastel variations","text-shadow glow, linear-gradient, filter: hue-rotate(), glitch animations, retro scan lines","Music platforms, gaming, creative portfolios, tech startups, entertainment, artistic projects","Business apps, e-commerce, education, healthcare, enterprise software",✓ Full,✓ Dark focused,⚠ Moderate,⚠ Poor (motion),◐ Medium,◐ Medium,"Tailwind 8/10, CSS-in-JS 9/10",1980s-90s Retro,Medium
+46,Dimensional Layering,General,"Depth, overlapping, z-index, layers, 3D, shadows, elevation, floating, cards, spatial hierarchy","Neutral base (#FFFFFF, #F5F5F5, #E0E0E0) + brand accent for elevated elements","Shadow variations (sm/md/lg/xl), elevation colors, highlight colors for top layers","z-index stacking, box-shadow elevation (4 levels), transform: translateZ(), backdrop-filter, parallax","Dashboards, card layouts, modals, navigation, product showcases, SaaS interfaces","Print-style layouts, simple blogs, low-end devices, flat design requirements",✓ Full,✓ Full,⚠ Good,⚠ Moderate (SR issues),✓ Good,✓ High,"Tailwind 10/10, MUI 10/10, Chakra 10/10",2020s Modern,Medium
+47,Exaggerated Minimalism,General,"Bold minimalism, oversized typography, high contrast, negative space, loud minimal, statement design","#000000 (Black), #FFFFFF (White), single vibrant accent only","Minimal - single accent color, no secondary colors, extreme restraint","font-size: clamp(3rem 10vw 12rem), font-weight: 900, letter-spacing: -0.05em, massive whitespace","Fashion, architecture, portfolios, agency landing pages, luxury brands, editorial","E-commerce catalogs, dashboards, forms, data-heavy, elderly users, complex apps",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, Typography.js 10/10",2020s Modern,Low
+48,Kinetic Typography,General,"Motion text, animated type, moving letters, dynamic, typing effect, morphing, scroll-triggered text","Flexible - high contrast recommended, bold colors for emphasis, animation-friendly palette","Accent colors for emphasis, transition colors, gradient text fills","@keyframes text animation, typing effect, background-clip: text, GSAP ScrollTrigger, split text","Hero sections, marketing sites, video platforms, storytelling, creative portfolios, landing pages","Long-form content, accessibility-critical, data interfaces, forms, elderly users",✓ Full,✓ Full,⚠ Moderate,❌ Poor (motion),✓ Good,✓ Very High,"GSAP 10/10, Framer Motion 10/10",2020s Modern,High
+49,Parallax Storytelling,General,"Scroll-driven, narrative, layered scrolling, immersive, progressive disclosure, cinematic, scroll-triggered","Story-dependent, often gradients and natural colors, section-specific palettes","Section transition colors, depth layer colors, narrative mood colors","transform: translateY(scroll), position: fixed/sticky, perspective: 1px, scroll-triggered animations","Brand storytelling, product launches, case studies, portfolios, annual reports, marketing campaigns","E-commerce, dashboards, mobile-first, SEO-critical, accessibility-required",✓ Full,✓ Full,❌ Poor,❌ Poor (motion),✗ Low,✓ High,"GSAP ScrollTrigger 10/10, Locomotive Scroll 10/10",2020s Modern,High
+50,Swiss Modernism 2.0,General,"Grid system, Helvetica, modular, asymmetric, international style, rational, clean, mathematical spacing","#000000, #FFFFFF, #F5F5F5, single vibrant accent only","Minimal secondary, accent for emphasis only, no gradients","display: grid, grid-template-columns: repeat(12 1fr), gap: 1rem, mathematical ratios, clear hierarchy","Corporate sites, architecture, editorial, SaaS, museums, professional services, documentation","Playful brands, children's sites, entertainment, gaming, emotional storytelling",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Bootstrap 9/10, Foundation 10/10",1950s Swiss + 2020s,Low
+51,HUD / Sci-Fi FUI,General,"Futuristic, technical, wireframe, neon, data, transparency, iron man, sci-fi, interface","Neon Cyan #00FFFF, Holographic Blue #0080FF, Alert Red #FF0000","Transparent Black, Grid Lines #333333","Glow effects, scanning animations, ticker text, blinking markers, fine line drawing","Sci-fi games, space tech, cybersecurity, movie props, immersive dashboards","Standard corporate, reading heavy content, accessible public services",✓ Low,✓ Full,⚠ Moderate (renders),⚠ Poor (thin lines),◐ Medium,✗ Low,"React 9/10, Canvas 10/10",2010s Sci-Fi,High
+52,Pixel Art,General,"Retro, 8-bit, 16-bit, gaming, blocky, nostalgic, pixelated, arcade","Primary colors (NES Palette), brights, limited palette","Black outlines, shading via dithering or block colors","Frame-by-frame sprite animation, blinking cursor, instant transitions, marquee text","Indie games, retro tools, creative portfolios, nostalgia marketing, Web3/NFT","Professional corporate, modern SaaS, high-res photography sites",✓ Full,✓ Full,⚡ Excellent,✓ Good (if contrast ok),✓ High,◐ Medium,"CSS (box-shadow) 8/10, Canvas 10/10",1980s Arcade,Medium
+53,Bento Grids,General,"Apple-style, modular, cards, organized, clean, hierarchy, grid, rounded, soft","Off-white #F5F5F7, Clean White #FFFFFF, Text #1D1D1F","Subtle accents, soft shadows, blurred backdrops","Hover scale (1.02), soft shadow expansion, smooth layout shifts, content reveal","Product features, dashboards, personal sites, marketing summaries, galleries","Long-form reading, data tables, complex forms",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"CSS Grid 10/10, Tailwind 10/10",2020s Apple/Linear,Low
+54,Neubrutalism,General,"Bold, ugly-cute, raw, high contrast, flat, hard shadows, distinct, playful, loud","Pop Yellow #FFDE59, Bright Red #FF5757, Black #000000","Lavender #CBA6F7, Mint #76E0C2","Hard hover shifts (4px), marquee scrolling, jitter animations, bold borders","Design tools, creative agencies, Gen Z brands, personal blogs, gumroad-style","Banking, legal, healthcare, serious enterprise, elderly users",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Plain CSS 10/10",2020s Modern Retro,Low
+55,Spatial UI (VisionOS),General,"Glass, depth, immersion, spatial, translucent, gaze, gesture, apple, vision-pro","Frosted Glass #FFFFFF (15-30% opacity), System White","Vibrant system colors for active states, deep shadows for depth","Parallax depth, dynamic lighting response, gaze-hover effects, smooth scale on focus","Spatial computing apps, VR/AR interfaces, immersive media, futuristic dashboards","Text-heavy documents, high-contrast requirements, non-3D capable devices",✓ Full,✓ Full,⚠ Moderate (blur cost),⚠ Contrast risks,✓ High (if adapted),✓ High,"SwiftUI, React (Three.js/Fiber)",2024 Spatial Era,High
+56,E-Ink / Paper,General,"Paper-like, matte, high contrast, texture, reading, calm, slow tech, monochrome","Off-White #FDFBF7, Paper White #F5F5F5, Ink Black #1A1A1A","Pencil Grey #4A4A4A, Highlighter Yellow #FFFF00 (accent)","No motion blur, distinct page turns, grain/noise texture, sharp transitions (no fade)","Reading apps, digital newspapers, minimal journals, distraction-free writing, slow-living brands","Gaming, video platforms, high-energy marketing, dark mode dependent apps",✓ Full,✗ Low (inverted only),⚡ Excellent,✓ WCAG AAA,✓ High,✓ Medium,"Tailwind 10/10, CSS 10/10",2020s Digital Well-being,Low
+57,Gen Z Chaos / Maximalism,General,"Chaos, clutter, stickers, raw, collage, mixed media, loud, internet culture, ironic","Clashing Brights: #FF00FF, #00FF00, #FFFF00, #0000FF","Gradients, rainbow, glitch, noise, heavily saturated mix","Marquee scrolls, jitter, sticker layering, GIF overload, random placement, drag-and-drop","Gen Z lifestyle brands, music artists, creative portfolios, viral marketing, fashion","Corporate, government, healthcare, banking, serious tools",✓ Full,✓ Full,⚠ Poor (heavy assets),❌ Poor,◐ Medium,✓ High (Viral),CSS-in-JS 8/10,2023+ Internet Core,High
+58,Biomimetic / Organic 2.0,General,"Nature-inspired, cellular, fluid, breathing, generative, algorithms, life-like","Cellular Pink #FF9999, Chlorophyll Green #00FF41, Bioluminescent Blue","Deep Ocean #001E3C, Coral #FF7F50, Organic gradients","Breathing animations, fluid morphing, generative growth, physics-based movement","Sustainability tech, biotech, advanced health, meditation, generative art platforms","Standard SaaS, data grids, strict corporate, accounting",✓ Full,✓ Full,⚠ Moderate,✓ Good,✓ Good,✓ High,"Canvas 10/10, WebGL 10/10",2024+ Generative,High
\ No newline at end of file
diff --git a/.agents/skills/ui-ux-pro-max/data/typography.csv b/.agents/skills/ui-ux-pro-max/data/typography.csv
new file mode 100644
index 0000000..29765f5
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/typography.csv
@@ -0,0 +1,58 @@
+STT,Font Pairing Name,Category,Heading Font,Body Font,Mood/Style Keywords,Best For,Google Fonts URL,CSS Import,Tailwind Config,Notes
+1,Classic Elegant,"Serif + Sans",Playfair Display,Inter,"elegant, luxury, sophisticated, timeless, premium, editorial","Luxury brands, fashion, spa, beauty, editorial, magazines, high-end e-commerce","https://fonts.google.com/share?selection.family=Inter:wght@300;400;500;600;700|Playfair+Display:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Playfair+Display:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Playfair Display', 'serif'], sans: ['Inter', 'sans-serif'] }","High contrast between elegant heading and clean body. Perfect for luxury/premium."
+2,Modern Professional,"Sans + Sans",Poppins,Open Sans,"modern, professional, clean, corporate, friendly, approachable","SaaS, corporate sites, business apps, startups, professional services","https://fonts.google.com/share?selection.family=Open+Sans:wght@300;400;500;600;700|Poppins:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Open+Sans:wght@300;400;500;600;700&family=Poppins:wght@400;500;600;700&display=swap');","fontFamily: { heading: ['Poppins', 'sans-serif'], body: ['Open Sans', 'sans-serif'] }","Geometric Poppins for headings, humanist Open Sans for readability."
+3,Tech Startup,"Sans + Sans",Space Grotesk,DM Sans,"tech, startup, modern, innovative, bold, futuristic","Tech companies, startups, SaaS, developer tools, AI products","https://fonts.google.com/share?selection.family=DM+Sans:wght@400;500;700|Space+Grotesk:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&family=Space+Grotesk:wght@400;500;600;700&display=swap');","fontFamily: { heading: ['Space Grotesk', 'sans-serif'], body: ['DM Sans', 'sans-serif'] }","Space Grotesk has unique character, DM Sans is highly readable."
+4,Editorial Classic,"Serif + Serif",Cormorant Garamond,Libre Baskerville,"editorial, classic, literary, traditional, refined, bookish","Publishing, blogs, news sites, literary magazines, book covers","https://fonts.google.com/share?selection.family=Cormorant+Garamond:wght@400;500;600;700|Libre+Baskerville:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Cormorant+Garamond:wght@400;500;600;700&family=Libre+Baskerville:wght@400;700&display=swap');","fontFamily: { heading: ['Cormorant Garamond', 'serif'], body: ['Libre Baskerville', 'serif'] }","All-serif pairing for traditional editorial feel."
+5,Minimal Swiss,"Sans + Sans",Inter,Inter,"minimal, clean, swiss, functional, neutral, professional","Dashboards, admin panels, documentation, enterprise apps, design systems","https://fonts.google.com/share?selection.family=Inter:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['Inter', 'sans-serif'] }","Single font family with weight variations. Ultimate simplicity."
+6,Playful Creative,"Display + Sans",Fredoka,Nunito,"playful, friendly, fun, creative, warm, approachable","Children's apps, educational, gaming, creative tools, entertainment","https://fonts.google.com/share?selection.family=Fredoka:wght@400;500;600;700|Nunito:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Fredoka:wght@400;500;600;700&family=Nunito:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Fredoka', 'sans-serif'], body: ['Nunito', 'sans-serif'] }","Rounded, friendly fonts perfect for playful UIs."
+7,Bold Statement,"Display + Sans",Bebas Neue,Source Sans 3,"bold, impactful, strong, dramatic, modern, headlines","Marketing sites, portfolios, agencies, event pages, sports","https://fonts.google.com/share?selection.family=Bebas+Neue|Source+Sans+3:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Bebas+Neue&family=Source+Sans+3:wght@300;400;500;600;700&display=swap');","fontFamily: { display: ['Bebas Neue', 'sans-serif'], body: ['Source Sans 3', 'sans-serif'] }","Bebas Neue for large headlines only. All-caps display font."
+8,Wellness Calm,"Serif + Sans",Lora,Raleway,"calm, wellness, health, relaxing, natural, organic","Health apps, wellness, spa, meditation, yoga, organic brands","https://fonts.google.com/share?selection.family=Lora:wght@400;500;600;700|Raleway:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Lora:wght@400;500;600;700&family=Raleway:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Lora', 'serif'], sans: ['Raleway', 'sans-serif'] }","Lora's organic curves with Raleway's elegant simplicity."
+9,Developer Mono,"Mono + Sans",JetBrains Mono,IBM Plex Sans,"code, developer, technical, precise, functional, hacker","Developer tools, documentation, code editors, tech blogs, CLI apps","https://fonts.google.com/share?selection.family=IBM+Plex+Sans:wght@300;400;500;600;700|JetBrains+Mono:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');","fontFamily: { mono: ['JetBrains Mono', 'monospace'], sans: ['IBM Plex Sans', 'sans-serif'] }","JetBrains for code, IBM Plex for UI. Developer-focused."
+10,Retro Vintage,"Display + Serif",Abril Fatface,Merriweather,"retro, vintage, nostalgic, dramatic, decorative, bold","Vintage brands, breweries, restaurants, creative portfolios, posters","https://fonts.google.com/share?selection.family=Abril+Fatface|Merriweather:wght@300;400;700","@import url('https://fonts.googleapis.com/css2?family=Abril+Fatface&family=Merriweather:wght@300;400;700&display=swap');","fontFamily: { display: ['Abril Fatface', 'serif'], body: ['Merriweather', 'serif'] }","Abril Fatface for hero headlines only. High-impact vintage feel."
+11,Geometric Modern,"Sans + Sans",Outfit,Work Sans,"geometric, modern, clean, balanced, contemporary, versatile","General purpose, portfolios, agencies, modern brands, landing pages","https://fonts.google.com/share?selection.family=Outfit:wght@300;400;500;600;700|Work+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700&family=Work+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Outfit', 'sans-serif'], body: ['Work Sans', 'sans-serif'] }","Both geometric but Outfit more distinctive for headings."
+12,Luxury Serif,"Serif + Sans",Cormorant,Montserrat,"luxury, high-end, fashion, elegant, refined, premium","Fashion brands, luxury e-commerce, jewelry, high-end services","https://fonts.google.com/share?selection.family=Cormorant:wght@400;500;600;700|Montserrat:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Cormorant:wght@400;500;600;700&family=Montserrat:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Cormorant', 'serif'], sans: ['Montserrat', 'sans-serif'] }","Cormorant's elegance with Montserrat's geometric precision."
+13,Friendly SaaS,"Sans + Sans",Plus Jakarta Sans,Plus Jakarta Sans,"friendly, modern, saas, clean, approachable, professional","SaaS products, web apps, dashboards, B2B, productivity tools","https://fonts.google.com/share?selection.family=Plus+Jakarta+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['Plus Jakarta Sans', 'sans-serif'] }","Single versatile font. Modern alternative to Inter."
+14,News Editorial,"Serif + Sans",Newsreader,Roboto,"news, editorial, journalism, trustworthy, readable, informative","News sites, blogs, magazines, journalism, content-heavy sites","https://fonts.google.com/share?selection.family=Newsreader:wght@400;500;600;700|Roboto:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Newsreader:wght@400;500;600;700&family=Roboto:wght@300;400;500;700&display=swap');","fontFamily: { serif: ['Newsreader', 'serif'], sans: ['Roboto', 'sans-serif'] }","Newsreader designed for long-form reading. Roboto for UI."
+15,Handwritten Charm,"Script + Sans",Caveat,Quicksand,"handwritten, personal, friendly, casual, warm, charming","Personal blogs, invitations, creative portfolios, lifestyle brands","https://fonts.google.com/share?selection.family=Caveat:wght@400;500;600;700|Quicksand:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Caveat:wght@400;500;600;700&family=Quicksand:wght@300;400;500;600;700&display=swap');","fontFamily: { script: ['Caveat', 'cursive'], sans: ['Quicksand', 'sans-serif'] }","Use Caveat sparingly for accents. Quicksand for body."
+16,Corporate Trust,"Sans + Sans",Lexend,Source Sans 3,"corporate, trustworthy, accessible, readable, professional, clean","Enterprise, government, healthcare, finance, accessibility-focused","https://fonts.google.com/share?selection.family=Lexend:wght@300;400;500;600;700|Source+Sans+3:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Lexend:wght@300;400;500;600;700&family=Source+Sans+3:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Lexend', 'sans-serif'], body: ['Source Sans 3', 'sans-serif'] }","Lexend designed for readability. Excellent accessibility."
+17,Brutalist Raw,"Mono + Mono",Space Mono,Space Mono,"brutalist, raw, technical, monospace, minimal, stark","Brutalist designs, developer portfolios, experimental, tech art","https://fonts.google.com/share?selection.family=Space+Mono:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Space+Mono:wght@400;700&display=swap');","fontFamily: { mono: ['Space Mono', 'monospace'] }","All-mono for raw brutalist aesthetic. Limited weights."
+18,Fashion Forward,"Sans + Sans",Syne,Manrope,"fashion, avant-garde, creative, bold, artistic, edgy","Fashion brands, creative agencies, art galleries, design studios","https://fonts.google.com/share?selection.family=Manrope:wght@300;400;500;600;700|Syne:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Manrope:wght@300;400;500;600;700&family=Syne:wght@400;500;600;700&display=swap');","fontFamily: { heading: ['Syne', 'sans-serif'], body: ['Manrope', 'sans-serif'] }","Syne's unique character for headlines. Manrope for readability."
+19,Soft Rounded,"Sans + Sans",Varela Round,Nunito Sans,"soft, rounded, friendly, approachable, warm, gentle","Children's products, pet apps, friendly brands, wellness, soft UI","https://fonts.google.com/share?selection.family=Nunito+Sans:wght@300;400;500;600;700|Varela+Round","@import url('https://fonts.googleapis.com/css2?family=Nunito+Sans:wght@300;400;500;600;700&family=Varela+Round&display=swap');","fontFamily: { heading: ['Varela Round', 'sans-serif'], body: ['Nunito Sans', 'sans-serif'] }","Both rounded and friendly. Perfect for soft UI designs."
+20,Premium Sans,"Sans + Sans",Satoshi,General Sans,"premium, modern, clean, sophisticated, versatile, balanced","Premium brands, modern agencies, SaaS, portfolios, startups","https://fonts.google.com/share?selection.family=DM+Sans:wght@400;500;700","@import url('https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&display=swap');","fontFamily: { sans: ['DM Sans', 'sans-serif'] }","Note: Satoshi/General Sans on Fontshare. DM Sans as Google alternative."
+21,Vietnamese Friendly,"Sans + Sans",Be Vietnam Pro,Noto Sans,"vietnamese, international, readable, clean, multilingual, accessible","Vietnamese sites, multilingual apps, international products","https://fonts.google.com/share?selection.family=Be+Vietnam+Pro:wght@300;400;500;600;700|Noto+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Be+Vietnam+Pro:wght@300;400;500;600;700&family=Noto+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['Be Vietnam Pro', 'Noto Sans', 'sans-serif'] }","Be Vietnam Pro excellent Vietnamese support. Noto as fallback."
+22,Japanese Elegant,"Serif + Sans",Noto Serif JP,Noto Sans JP,"japanese, elegant, traditional, modern, multilingual, readable","Japanese sites, Japanese restaurants, cultural sites, anime/manga","https://fonts.google.com/share?selection.family=Noto+Sans+JP:wght@300;400;500;700|Noto+Serif+JP:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+JP:wght@300;400;500;700&family=Noto+Serif+JP:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Noto Serif JP', 'serif'], sans: ['Noto Sans JP', 'sans-serif'] }","Noto fonts excellent Japanese support. Traditional + modern feel."
+23,Korean Modern,"Sans + Sans",Noto Sans KR,Noto Sans KR,"korean, modern, clean, professional, multilingual, readable","Korean sites, K-beauty, K-pop, Korean businesses, multilingual","https://fonts.google.com/share?selection.family=Noto+Sans+KR:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans KR', 'sans-serif'] }","Clean Korean typography. Single font with weight variations."
+24,Chinese Traditional,"Serif + Sans",Noto Serif TC,Noto Sans TC,"chinese, traditional, elegant, cultural, multilingual, readable","Traditional Chinese sites, cultural content, Taiwan/Hong Kong markets","https://fonts.google.com/share?selection.family=Noto+Sans+TC:wght@300;400;500;700|Noto+Serif+TC:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+TC:wght@300;400;500;700&family=Noto+Serif+TC:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Noto Serif TC', 'serif'], sans: ['Noto Sans TC', 'sans-serif'] }","Traditional Chinese character support. Elegant pairing."
+25,Chinese Simplified,"Sans + Sans",Noto Sans SC,Noto Sans SC,"chinese, simplified, modern, professional, multilingual, readable","Simplified Chinese sites, mainland China market, business apps","https://fonts.google.com/share?selection.family=Noto+Sans+SC:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans SC', 'sans-serif'] }","Simplified Chinese support. Clean modern look."
+26,Arabic Elegant,"Serif + Sans",Noto Naskh Arabic,Noto Sans Arabic,"arabic, elegant, traditional, cultural, RTL, readable","Arabic sites, Middle East market, Islamic content, bilingual sites","https://fonts.google.com/share?selection.family=Noto+Naskh+Arabic:wght@400;500;600;700|Noto+Sans+Arabic:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Naskh+Arabic:wght@400;500;600;700&family=Noto+Sans+Arabic:wght@300;400;500;700&display=swap');","fontFamily: { serif: ['Noto Naskh Arabic', 'serif'], sans: ['Noto Sans Arabic', 'sans-serif'] }","RTL support. Naskh for traditional, Sans for modern Arabic."
+27,Thai Modern,"Sans + Sans",Noto Sans Thai,Noto Sans Thai,"thai, modern, readable, clean, multilingual, accessible","Thai sites, Southeast Asia, tourism, Thai restaurants","https://fonts.google.com/share?selection.family=Noto+Sans+Thai:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+Thai:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans Thai', 'sans-serif'] }","Clean Thai typography. Excellent readability."
+28,Hebrew Modern,"Sans + Sans",Noto Sans Hebrew,Noto Sans Hebrew,"hebrew, modern, RTL, clean, professional, readable","Hebrew sites, Israeli market, Jewish content, bilingual sites","https://fonts.google.com/share?selection.family=Noto+Sans+Hebrew:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+Hebrew:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans Hebrew', 'sans-serif'] }","RTL support. Clean modern Hebrew typography."
+29,Legal Professional,"Serif + Sans",EB Garamond,Lato,"legal, professional, traditional, trustworthy, formal, authoritative","Law firms, legal services, contracts, formal documents, government","https://fonts.google.com/share?selection.family=EB+Garamond:wght@400;500;600;700|Lato:wght@300;400;700","@import url('https://fonts.googleapis.com/css2?family=EB+Garamond:wght@400;500;600;700&family=Lato:wght@300;400;700&display=swap');","fontFamily: { serif: ['EB Garamond', 'serif'], sans: ['Lato', 'sans-serif'] }","EB Garamond for authority. Lato for clean body text."
+30,Medical Clean,"Sans + Sans",Figtree,Noto Sans,"medical, clean, accessible, professional, healthcare, trustworthy","Healthcare, medical clinics, pharma, health apps, accessibility","https://fonts.google.com/share?selection.family=Figtree:wght@300;400;500;600;700|Noto+Sans:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Figtree:wght@300;400;500;600;700&family=Noto+Sans:wght@300;400;500;700&display=swap');","fontFamily: { heading: ['Figtree', 'sans-serif'], body: ['Noto Sans', 'sans-serif'] }","Clean, accessible fonts for medical contexts."
+31,Financial Trust,"Sans + Sans",IBM Plex Sans,IBM Plex Sans,"financial, trustworthy, professional, corporate, banking, serious","Banks, finance, insurance, investment, fintech, enterprise","https://fonts.google.com/share?selection.family=IBM+Plex+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['IBM Plex Sans', 'sans-serif'] }","IBM Plex conveys trust and professionalism. Excellent for data."
+32,Real Estate Luxury,"Serif + Sans",Cinzel,Josefin Sans,"real estate, luxury, elegant, sophisticated, property, premium","Real estate, luxury properties, architecture, interior design","https://fonts.google.com/share?selection.family=Cinzel:wght@400;500;600;700|Josefin+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Cinzel:wght@400;500;600;700&family=Josefin+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Cinzel', 'serif'], sans: ['Josefin Sans', 'sans-serif'] }","Cinzel's elegance for headlines. Josefin for modern body."
+33,Restaurant Menu,"Serif + Sans",Playfair Display SC,Karla,"restaurant, menu, culinary, elegant, foodie, hospitality","Restaurants, cafes, food blogs, culinary, hospitality","https://fonts.google.com/share?selection.family=Karla:wght@300;400;500;600;700|Playfair+Display+SC:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Karla:wght@300;400;500;600;700&family=Playfair+Display+SC:wght@400;700&display=swap');","fontFamily: { display: ['Playfair Display SC', 'serif'], sans: ['Karla', 'sans-serif'] }","Small caps Playfair for menu headers. Karla for descriptions."
+34,Art Deco,"Display + Sans",Poiret One,Didact Gothic,"art deco, vintage, 1920s, elegant, decorative, gatsby","Vintage events, art deco themes, luxury hotels, classic cocktails","https://fonts.google.com/share?selection.family=Didact+Gothic|Poiret+One","@import url('https://fonts.googleapis.com/css2?family=Didact+Gothic&family=Poiret+One&display=swap');","fontFamily: { display: ['Poiret One', 'sans-serif'], sans: ['Didact Gothic', 'sans-serif'] }","Poiret One for art deco headlines only. Didact for body."
+35,Magazine Style,"Serif + Sans",Libre Bodoni,Public Sans,"magazine, editorial, publishing, refined, journalism, print","Magazines, online publications, editorial content, journalism","https://fonts.google.com/share?selection.family=Libre+Bodoni:wght@400;500;600;700|Public+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Libre+Bodoni:wght@400;500;600;700&family=Public+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Libre Bodoni', 'serif'], sans: ['Public Sans', 'sans-serif'] }","Bodoni's editorial elegance. Public Sans for clean UI."
+36,Crypto/Web3,"Sans + Sans",Orbitron,Exo 2,"crypto, web3, futuristic, tech, blockchain, digital","Crypto platforms, NFT, blockchain, web3, futuristic tech","https://fonts.google.com/share?selection.family=Exo+2:wght@300;400;500;600;700|Orbitron:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Exo+2:wght@300;400;500;600;700&family=Orbitron:wght@400;500;600;700&display=swap');","fontFamily: { display: ['Orbitron', 'sans-serif'], body: ['Exo 2', 'sans-serif'] }","Orbitron for futuristic headers. Exo 2 for readable body."
+37,Gaming Bold,"Display + Sans",Russo One,Chakra Petch,"gaming, bold, action, esports, competitive, energetic","Gaming, esports, action games, competitive sports, entertainment","https://fonts.google.com/share?selection.family=Chakra+Petch:wght@300;400;500;600;700|Russo+One","@import url('https://fonts.googleapis.com/css2?family=Chakra+Petch:wght@300;400;500;600;700&family=Russo+One&display=swap');","fontFamily: { display: ['Russo One', 'sans-serif'], body: ['Chakra Petch', 'sans-serif'] }","Russo One for impact. Chakra Petch for techy body text."
+38,Indie/Craft,"Display + Sans",Amatic SC,Cabin,"indie, craft, handmade, artisan, organic, creative","Craft brands, indie products, artisan, handmade, organic products","https://fonts.google.com/share?selection.family=Amatic+SC:wght@400;700|Cabin:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Amatic+SC:wght@400;700&family=Cabin:wght@400;500;600;700&display=swap');","fontFamily: { display: ['Amatic SC', 'sans-serif'], sans: ['Cabin', 'sans-serif'] }","Amatic for handwritten feel. Cabin for readable body."
+39,Startup Bold,"Sans + Sans",Clash Display,Satoshi,"startup, bold, modern, innovative, confident, dynamic","Startups, pitch decks, product launches, bold brands","https://fonts.google.com/share?selection.family=Outfit:wght@400;500;600;700|Rubik:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;500;600;700&family=Rubik:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Outfit', 'sans-serif'], body: ['Rubik', 'sans-serif'] }","Note: Clash Display on Fontshare. Outfit as Google alternative."
+40,E-commerce Clean,"Sans + Sans",Rubik,Nunito Sans,"ecommerce, clean, shopping, product, retail, conversion","E-commerce, online stores, product pages, retail, shopping","https://fonts.google.com/share?selection.family=Nunito+Sans:wght@300;400;500;600;700|Rubik:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Nunito+Sans:wght@300;400;500;600;700&family=Rubik:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Rubik', 'sans-serif'], body: ['Nunito Sans', 'sans-serif'] }","Clean readable fonts perfect for product descriptions."
+41,Academic/Research,"Serif + Sans",Crimson Pro,Atkinson Hyperlegible,"academic, research, scholarly, accessible, readable, educational","Universities, research papers, academic journals, educational","https://fonts.google.com/share?selection.family=Atkinson+Hyperlegible:wght@400;700|Crimson+Pro:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Atkinson+Hyperlegible:wght@400;700&family=Crimson+Pro:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Crimson Pro', 'serif'], sans: ['Atkinson Hyperlegible', 'sans-serif'] }","Crimson for scholarly headlines. Atkinson for accessibility."
+42,Dashboard Data,"Mono + Sans",Fira Code,Fira Sans,"dashboard, data, analytics, code, technical, precise","Dashboards, analytics, data visualization, admin panels","https://fonts.google.com/share?selection.family=Fira+Code:wght@400;500;600;700|Fira+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;500;600;700&family=Fira+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { mono: ['Fira Code', 'monospace'], sans: ['Fira Sans', 'sans-serif'] }","Fira family cohesion. Code for data, Sans for labels."
+43,Music/Entertainment,"Display + Sans",Righteous,Poppins,"music, entertainment, fun, energetic, bold, performance","Music platforms, entertainment, events, festivals, performers","https://fonts.google.com/share?selection.family=Poppins:wght@300;400;500;600;700|Righteous","@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;500;600;700&family=Righteous&display=swap');","fontFamily: { display: ['Righteous', 'sans-serif'], sans: ['Poppins', 'sans-serif'] }","Righteous for bold entertainment headers. Poppins for body."
+44,Minimalist Portfolio,"Sans + Sans",Archivo,Space Grotesk,"minimal, portfolio, designer, creative, clean, artistic","Design portfolios, creative professionals, minimalist brands","https://fonts.google.com/share?selection.family=Archivo:wght@300;400;500;600;700|Space+Grotesk:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Archivo:wght@300;400;500;600;700&family=Space+Grotesk:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Space Grotesk', 'sans-serif'], body: ['Archivo', 'sans-serif'] }","Space Grotesk for distinctive headers. Archivo for clean body."
+45,Kids/Education,"Display + Sans",Baloo 2,Comic Neue,"kids, education, playful, friendly, colorful, learning","Children's apps, educational games, kid-friendly content","https://fonts.google.com/share?selection.family=Baloo+2:wght@400;500;600;700|Comic+Neue:wght@300;400;700","@import url('https://fonts.googleapis.com/css2?family=Baloo+2:wght@400;500;600;700&family=Comic+Neue:wght@300;400;700&display=swap');","fontFamily: { display: ['Baloo 2', 'sans-serif'], sans: ['Comic Neue', 'sans-serif'] }","Fun, playful fonts for children. Comic Neue is readable comic style."
+46,Wedding/Romance,"Script + Serif",Great Vibes,Cormorant Infant,"wedding, romance, elegant, script, invitation, feminine","Wedding sites, invitations, romantic brands, bridal","https://fonts.google.com/share?selection.family=Cormorant+Infant:wght@300;400;500;600;700|Great+Vibes","@import url('https://fonts.googleapis.com/css2?family=Cormorant+Infant:wght@300;400;500;600;700&family=Great+Vibes&display=swap');","fontFamily: { script: ['Great Vibes', 'cursive'], serif: ['Cormorant Infant', 'serif'] }","Great Vibes for elegant accents. Cormorant for readable text."
+47,Science/Tech,"Sans + Sans",Exo,Roboto Mono,"science, technology, research, data, futuristic, precise","Science, research, tech documentation, data-heavy sites","https://fonts.google.com/share?selection.family=Exo:wght@300;400;500;600;700|Roboto+Mono:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Exo:wght@300;400;500;600;700&family=Roboto+Mono:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Exo', 'sans-serif'], mono: ['Roboto Mono', 'monospace'] }","Exo for modern tech feel. Roboto Mono for code/data."
+48,Accessibility First,"Sans + Sans",Atkinson Hyperlegible,Atkinson Hyperlegible,"accessible, readable, inclusive, WCAG, dyslexia-friendly, clear","Accessibility-critical sites, government, healthcare, inclusive design","https://fonts.google.com/share?selection.family=Atkinson+Hyperlegible:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Atkinson+Hyperlegible:wght@400;700&display=swap');","fontFamily: { sans: ['Atkinson Hyperlegible', 'sans-serif'] }","Designed for maximum legibility. Excellent for accessibility."
+49,Sports/Fitness,"Sans + Sans",Barlow Condensed,Barlow,"sports, fitness, athletic, energetic, condensed, action","Sports, fitness, gyms, athletic brands, competition","https://fonts.google.com/share?selection.family=Barlow+Condensed:wght@400;500;600;700|Barlow:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@400;500;600;700&family=Barlow:wght@300;400;500;600;700&display=swap');","fontFamily: { display: ['Barlow Condensed', 'sans-serif'], body: ['Barlow', 'sans-serif'] }","Condensed for impact headlines. Regular Barlow for body."
+50,Luxury Minimalist,"Serif + Sans",Bodoni Moda,Jost,"luxury, minimalist, high-end, sophisticated, refined, premium","Luxury minimalist brands, high-end fashion, premium products","https://fonts.google.com/share?selection.family=Bodoni+Moda:wght@400;500;600;700|Jost:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Bodoni+Moda:wght@400;500;600;700&family=Jost:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Bodoni Moda', 'serif'], sans: ['Jost', 'sans-serif'] }","Bodoni's high contrast elegance. Jost for geometric body."
+51,Tech/HUD Mono,"Mono + Mono",Share Tech Mono,Fira Code,"tech, futuristic, hud, sci-fi, data, monospaced, precise","Sci-fi interfaces, developer tools, cybersecurity, dashboards","https://fonts.google.com/share?selection.family=Fira+Code:wght@300;400;500;600;700|Share+Tech+Mono","@import url('https://fonts.googleapis.com/css2?family=Fira+Code:wght@300;400;500;600;700&family=Share+Tech+Mono&display=swap');","fontFamily: { hud: ['Share Tech Mono', 'monospace'], code: ['Fira Code', 'monospace'] }","Share Tech Mono has that classic sci-fi look."
+52,Pixel Retro,"Display + Sans",Press Start 2P,VT323,"pixel, retro, gaming, 8-bit, nostalgic, arcade","Pixel art games, retro websites, creative portfolios","https://fonts.google.com/share?selection.family=Press+Start+2P|VT323","@import url('https://fonts.googleapis.com/css2?family=Press+Start+2P&family=VT323&display=swap');","fontFamily: { pixel: ['Press Start 2P', 'cursive'], terminal: ['VT323', 'monospace'] }","Press Start 2P is very wide/large. VT323 is better for body text."
+53,Neubrutalist Bold,"Display + Sans",Lexend Mega,Public Sans,"bold, neubrutalist, loud, strong, geometric, quirky","Neubrutalist designs, Gen Z brands, bold marketing","https://fonts.google.com/share?selection.family=Lexend+Mega:wght@100..900|Public+Sans:wght@100..900","@import url('https://fonts.googleapis.com/css2?family=Lexend+Mega:wght@100..900&family=Public+Sans:wght@100..900&display=swap');","fontFamily: { mega: ['Lexend Mega', 'sans-serif'], body: ['Public Sans', 'sans-serif'] }","Lexend Mega has distinct character and variable weight."
+54,Academic/Archival,"Serif + Serif",EB Garamond,Crimson Text,"academic, old-school, university, research, serious, traditional","University sites, archives, research papers, history","https://fonts.google.com/share?selection.family=Crimson+Text:wght@400;600;700|EB+Garamond:wght@400;500;600;700;800","@import url('https://fonts.googleapis.com/css2?family=Crimson+Text:wght@400;600;700&family=EB+Garamond:wght@400;500;600;700;800&display=swap');","fontFamily: { classic: ['EB Garamond', 'serif'], text: ['Crimson Text', 'serif'] }","Classic academic aesthetic. Very legible."
+55,Spatial Clear,"Sans + Sans",Inter,Inter,"spatial, legible, glass, system, clean, neutral","Spatial computing, AR/VR, glassmorphism interfaces","https://fonts.google.com/share?selection.family=Inter:wght@300;400;500;600","@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600&display=swap');","fontFamily: { sans: ['Inter', 'sans-serif'] }","Optimized for readability on dynamic backgrounds."
+56,Kinetic Motion,"Display + Mono",Syncopate,Space Mono,"kinetic, motion, futuristic, speed, wide, tech","Music festivals, automotive, high-energy brands","https://fonts.google.com/share?selection.family=Space+Mono:wght@400;700|Syncopate:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Space+Mono:wght@400;700&family=Syncopate:wght@400;700&display=swap');","fontFamily: { display: ['Syncopate', 'sans-serif'], mono: ['Space Mono', 'monospace'] }","Syncopate's wide stance works well with motion effects."
+57,Gen Z Brutal,"Display + Sans",Anton,Epilogue,"brutal, loud, shouty, meme, internet, bold","Gen Z marketing, streetwear, viral campaigns","https://fonts.google.com/share?selection.family=Anton|Epilogue:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Anton&family=Epilogue:wght@400;500;600;700&display=swap');","fontFamily: { display: ['Anton', 'sans-serif'], body: ['Epilogue', 'sans-serif'] }","Anton is impactful and condensed. Good for stickers/badges."
\ No newline at end of file
diff --git a/.agents/skills/ui-ux-pro-max/data/ui-reasoning.csv b/.agents/skills/ui-ux-pro-max/data/ui-reasoning.csv
new file mode 100644
index 0000000..4553ddd
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/ui-reasoning.csv
@@ -0,0 +1,101 @@
+No,UI_Category,Recommended_Pattern,Style_Priority,Color_Mood,Typography_Mood,Key_Effects,Decision_Rules,Anti_Patterns,Severity
+1,SaaS (General),Hero + Features + CTA,Glassmorphism + Flat Design,Trust blue + Accent contrast,Professional + Hierarchy,Subtle hover (200-250ms) + Smooth transitions,"{""if_ux_focused"": ""prioritize-minimalism"", ""if_data_heavy"": ""add-glassmorphism""}",Excessive animation + Dark mode by default,HIGH
+2,Micro SaaS,Minimal & Direct + Demo,Flat Design + Vibrant & Block,Vibrant primary + White space,Bold + Clean typography,Large CTA hover (300ms) + Scroll reveal,"{""if_quick_onboarding"": ""reduce-steps"", ""if_demo_available"": ""feature-interactive-demo""}",Complex onboarding flow + Cluttered layout,HIGH
+3,E-commerce,Feature-Rich Showcase,Vibrant & Block-based,Brand primary + Success green,Engaging + Clear hierarchy,Card hover lift (200ms) + Scale effect,"{""if_luxury"": ""switch-to-liquid-glass"", ""if_conversion_focused"": ""add-urgency-colors""}",Flat design without depth + Text-heavy pages,HIGH
+4,E-commerce Luxury,Feature-Rich Showcase,Liquid Glass + Glassmorphism,Premium colors + Minimal accent,Elegant + Refined typography,Chromatic aberration + Fluid animations (400-600ms),"{""if_checkout"": ""emphasize-trust"", ""if_hero_needed"": ""use-3d-hyperrealism""}",Vibrant & Block-based + Playful colors,HIGH
+5,Healthcare App,Social Proof-Focused,Neumorphism + Accessible & Ethical,Calm blue + Health green,Readable + Large type (16px+),Soft box-shadow + Smooth press (150ms),"{""must_have"": ""wcag-aaa-compliance"", ""if_medication"": ""red-alert-colors""}",Bright neon colors + Motion-heavy animations + AI purple/pink gradients,HIGH
+6,Fintech/Crypto,Conversion-Optimized,Glassmorphism + Dark Mode (OLED),Dark tech colors + Vibrant accents,Modern + Confident typography,Real-time chart animations + Alert pulse/glow,"{""must_have"": ""security-badges"", ""if_real_time"": ""add-streaming-data""}",Light backgrounds + No security indicators,HIGH
+7,Education,Feature-Rich Showcase,Claymorphism + Micro-interactions,Playful colors + Clear hierarchy,Friendly + Engaging typography,Soft press (200ms) + Fluffy elements,"{""if_gamification"": ""add-progress-animation"", ""if_children"": ""increase-playfulness""}",Dark modes + Complex jargon,MEDIUM
+8,Portfolio/Personal,Storytelling-Driven,Motion-Driven + Minimalism,Brand primary + Artistic,Expressive + Variable typography,Parallax (3-5 layers) + Scroll-triggered reveals,"{""if_creative_field"": ""add-brutalism"", ""if_minimal_portfolio"": ""reduce-motion""}",Corporate templates + Generic layouts,MEDIUM
+9,Government/Public,Minimal & Direct,Accessible & Ethical + Minimalism,Professional blue + High contrast,Clear + Large typography,Clear focus rings (3-4px) + Skip links,"{""must_have"": ""wcag-aaa"", ""must_have"": ""keyboard-navigation""}",Ornate design + Low contrast + Motion effects + AI purple/pink gradients,HIGH
+10,Fintech (Banking),Trust & Authority,Minimalism + Accessible & Ethical,Navy + Trust Blue + Gold,Professional + Trustworthy,Smooth state transitions + Number animations,"{""must_have"": ""security-first"", ""if_dashboard"": ""use-dark-mode""}",Playful design + Unclear fees + AI purple/pink gradients,HIGH
+11,Social Media App,Feature-Rich Showcase,Vibrant & Block-based + Motion-Driven,Vibrant + Engagement colors,Modern + Bold typography,Large scroll animations + Icon animations,"{""if_engagement_metric"": ""add-motion"", ""if_content_focused"": ""minimize-chrome""}",Heavy skeuomorphism + Accessibility ignored,MEDIUM
+12,Startup Landing,Hero-Centric + Trust,Motion-Driven + Vibrant & Block,Bold primaries + Accent contrast,Modern + Energetic typography,Scroll-triggered animations + Parallax,"{""if_pre_launch"": ""use-waitlist-pattern"", ""if_video_ready"": ""add-hero-video""}",Static design + No video + Poor mobile,HIGH
+13,Gaming,Feature-Rich Showcase,3D & Hyperrealism + Retro-Futurism,Vibrant + Neon + Immersive,Bold + Impactful typography,WebGL 3D rendering + Glitch effects,"{""if_competitive"": ""add-real-time-stats"", ""if_casual"": ""increase-playfulness""}",Minimalist design + Static assets,HIGH
+14,Creative Agency,Storytelling-Driven,Brutalism + Motion-Driven,Bold primaries + Artistic freedom,Bold + Expressive typography,CRT scanlines + Neon glow + Glitch effects,"{""must_have"": ""case-studies"", ""if_boutique"": ""increase-artistic-freedom""}",Corporate minimalism + Hidden portfolio,HIGH
+15,Wellness/Mental Health,Social Proof-Focused,Neumorphism + Accessible & Ethical,Calm Pastels + Trust colors,Calming + Readable typography,Soft press + Breathing animations,"{""must_have"": ""privacy-first"", ""if_meditation"": ""add-breathing-animation""}",Bright neon + Motion overload,HIGH
+16,Restaurant/Food,Hero-Centric + Conversion,Vibrant & Block-based + Motion-Driven,Warm colors (Orange Red Brown),Appetizing + Clear typography,Food image reveal + Menu hover effects,"{""must_have"": ""high_quality_images"", ""if_delivery"": ""emphasize-speed""}",Low-quality imagery + Outdated hours,HIGH
+17,Real Estate,Hero-Centric + Feature-Rich,Glassmorphism + Minimalism,Trust Blue + Gold + White,Professional + Confident,3D property tour zoom + Map hover,"{""if_luxury"": ""add-3d-models"", ""must_have"": ""map-integration""}",Poor photos + No virtual tours,HIGH
+18,Travel/Tourism,Storytelling-Driven + Hero,Aurora UI + Motion-Driven,Vibrant destination + Sky Blue,Inspirational + Engaging,Destination parallax + Itinerary animations,"{""if_experience_focused"": ""use-storytelling"", ""must_have"": ""mobile-booking""}",Generic photos + Complex booking,HIGH
+19,SaaS Dashboard,Data-Dense Dashboard,Data-Dense + Heat Map,Cool to Hot gradients + Neutral grey,Clear + Readable typography,Hover tooltips + Chart zoom + Real-time pulse,"{""must_have"": ""real-time-updates"", ""if_large_dataset"": ""prioritize-performance""}",Ornate design + Slow rendering,HIGH
+20,B2B SaaS Enterprise,Feature-Rich Showcase,Trust & Authority + Minimal,Professional blue + Neutral grey,Formal + Clear typography,Subtle section transitions + Feature reveals,"{""must_have"": ""case-studies"", ""must_have"": ""roi-messaging""}",Playful design + Hidden features + AI purple/pink gradients,HIGH
+21,Music/Entertainment,Feature-Rich Showcase,Dark Mode (OLED) + Vibrant & Block-based,Dark (#121212) + Vibrant accents + Album art colors,Modern + Bold typography,Waveform visualization + Playlist animations,"{""must_have"": ""audio-player-ux"", ""if_discovery_focused"": ""add-playlist-recommendations""}",Cluttered layout + Poor audio player UX,HIGH
+22,Video Streaming/OTT,Hero-Centric + Feature-Rich,Dark Mode (OLED) + Motion-Driven,Dark bg + Poster colors + Brand accent,Bold + Engaging typography,Video player animations + Content carousel (parallax),"{""must_have"": ""continue-watching"", ""if_personalized"": ""add-recommendations""}",Static layout + Slow video player,HIGH
+23,Job Board/Recruitment,Conversion-Optimized + Feature-Rich,Flat Design + Minimalism,Professional Blue + Success Green + Neutral,Clear + Professional typography,Search/filter animations + Application flow,"{""must_have"": ""advanced-search"", ""if_salary_focused"": ""highlight-compensation""}",Outdated forms + Hidden filters,HIGH
+24,Marketplace (P2P),Feature-Rich Showcase + Social Proof,Vibrant & Block-based + Flat Design,Trust colors + Category colors + Success green,Modern + Engaging typography,Review star animations + Listing hover effects,"{""must_have"": ""seller-profiles"", ""must_have"": ""secure-payment""}",Low trust signals + Confusing layout,HIGH
+25,Logistics/Delivery,Feature-Rich Showcase + Real-Time,Minimalism + Flat Design,Blue (#2563EB) + Orange (tracking) + Green,Clear + Functional typography,Real-time tracking animation + Status pulse,"{""must_have"": ""tracking-map"", ""must_have"": ""delivery-updates""}",Static tracking + No map integration + AI purple/pink gradients,HIGH
+26,Agriculture/Farm Tech,Feature-Rich Showcase,Organic Biophilic + Flat Design,Earth Green (#4A7C23) + Brown + Sky Blue,Clear + Informative typography,Data visualization + Weather animations,"{""must_have"": ""sensor-dashboard"", ""if_crop_focused"": ""add-health-indicators""}",Generic design + Ignored accessibility + AI purple/pink gradients,MEDIUM
+27,Construction/Architecture,Hero-Centric + Feature-Rich,Minimalism + 3D & Hyperrealism,Grey (#4A4A4A) + Orange (safety) + Blueprint Blue,Professional + Bold typography,3D model viewer + Timeline animations,"{""must_have"": ""project-portfolio"", ""if_team_collaboration"": ""add-real-time-updates""}",2D-only layouts + Poor image quality + AI purple/pink gradients,HIGH
+28,Automotive/Car Dealership,Hero-Centric + Feature-Rich,Motion-Driven + 3D & Hyperrealism,Brand colors + Metallic + Dark/Light,Bold + Confident typography,360 product view + Configurator animations,"{""must_have"": ""vehicle-comparison"", ""must_have"": ""financing-calculator""}",Static product pages + Poor UX,HIGH
+29,Photography Studio,Storytelling-Driven + Hero-Centric,Motion-Driven + Minimalism,Black + White + Minimal accent,Elegant + Minimal typography,Full-bleed gallery + Before/after reveal,"{""must_have"": ""portfolio-showcase"", ""if_booking"": ""add-calendar-system""}",Heavy text + Poor image showcase,HIGH
+30,Coworking Space,Hero-Centric + Feature-Rich,Vibrant & Block-based + Glassmorphism,Energetic colors + Wood tones + Brand,Modern + Engaging typography,Space tour video + Amenity reveal animations,"{""must_have"": ""virtual-tour"", ""must_have"": ""booking-system""}",Outdated photos + Confusing layout,MEDIUM
+31,Cleaning Service,Conversion-Optimized + Trust,Soft UI Evolution + Flat Design,Fresh Blue (#00B4D8) + Clean White + Green,Friendly + Clear typography,Before/after gallery + Service package reveal,"{""must_have"": ""price-transparency"", ""must_have"": ""trust-badges""}",Poor before/after imagery + Hidden pricing,HIGH
+32,Home Services,Conversion-Optimized + Trust,Flat Design + Trust & Authority,Trust Blue + Safety Orange + Grey,Professional + Clear typography,Emergency contact highlight + Service menu animations,"{""must_have"": ""emergency-contact"", ""must_have"": ""certifications-display""}",Hidden contact info + No certifications,HIGH
+33,Childcare/Daycare,Social Proof-Focused + Trust,Claymorphism + Vibrant & Block-based,Playful pastels + Safe colors + Warm,Friendly + Playful typography,Parent portal animations + Activity gallery reveal,"{""must_have"": ""parent-communication"", ""must_have"": ""safety-certifications""}",Generic design + Hidden safety info,HIGH
+34,Senior Care/Elderly,Trust & Authority + Accessible,Accessible & Ethical + Soft UI Evolution,Calm Blue + Warm neutrals + Large text,Large + Clear typography (18px+),Large touch targets + Clear navigation,"{""must_have"": ""wcag-aaa"", ""must_have"": ""family-portal""}",Small text + Complex navigation + AI purple/pink gradients,HIGH
+35,Medical Clinic,Trust & Authority + Conversion,Accessible & Ethical + Minimalism,Medical Blue (#0077B6) + Trust White,Professional + Readable typography,Online booking flow + Doctor profile reveals,"{""must_have"": ""appointment-booking"", ""must_have"": ""insurance-info""}",Outdated interface + Confusing booking + AI purple/pink gradients,HIGH
+36,Pharmacy/Drug Store,Conversion-Optimized + Trust,Flat Design + Accessible & Ethical,Pharmacy Green + Trust Blue + Clean White,Clear + Functional typography,Prescription upload flow + Refill reminders,"{""must_have"": ""prescription-management"", ""must_have"": ""drug-interaction-warnings""}",Confusing layout + Privacy concerns + AI purple/pink gradients,HIGH
+37,Dental Practice,Social Proof-Focused + Conversion,Soft UI Evolution + Minimalism,Fresh Blue + White + Smile Yellow,Friendly + Professional typography,Before/after gallery + Patient testimonial carousel,"{""must_have"": ""before-after-gallery"", ""must_have"": ""appointment-system""}",Poor imagery + No testimonials,HIGH
+38,Veterinary Clinic,Social Proof-Focused + Trust,Claymorphism + Accessible & Ethical,Caring Blue + Pet colors + Warm,Friendly + Welcoming typography,Pet profile management + Service animations,"{""must_have"": ""pet-portal"", ""must_have"": ""emergency-contact""}",Generic design + Hidden services,MEDIUM
+39,News/Media Platform,Hero-Centric + Feature-Rich,Minimalism + Flat Design,Brand colors + High contrast,Clear + Readable typography,Breaking news badge + Article reveal animations,"{""must_have"": ""mobile-first-reading"", ""must_have"": ""category-navigation""}",Cluttered layout + Slow loading,HIGH
+40,Legal Services,Trust & Authority + Minimal,Trust & Authority + Minimalism,Navy Blue (#1E3A5F) + Gold + White,Professional + Authoritative typography,Practice area reveal + Attorney profile animations,"{""must_have"": ""case-results"", ""must_have"": ""credential-display""}",Outdated design + Hidden credentials + AI purple/pink gradients,HIGH
+41,Beauty/Spa/Wellness Service,Hero-Centric + Social Proof,Soft UI Evolution + Neumorphism,Soft pastels (Pink Sage Cream) + Gold accents,Elegant + Calming typography,Soft shadows + Smooth transitions (200-300ms) + Gentle hover,"{""must_have"": ""booking-system"", ""must_have"": ""before-after-gallery"", ""if_luxury"": ""add-gold-accents""}",Bright neon colors + Harsh animations + Dark mode,HIGH
+42,Service Landing Page,Hero-Centric + Trust & Authority,Minimalism + Social Proof-Focused,Brand primary + Trust colors,Professional + Clear typography,Testimonial carousel + CTA hover (200ms),"{""must_have"": ""social-proof"", ""must_have"": ""clear-cta""}",Complex navigation + Hidden contact info,HIGH
+43,B2B Service,Feature-Rich Showcase + Trust,Trust & Authority + Minimalism,Professional blue + Neutral grey,Formal + Clear typography,Section transitions + Feature reveals,"{""must_have"": ""case-studies"", ""must_have"": ""roi-messaging""}",Playful design + Hidden credentials + AI purple/pink gradients,HIGH
+44,Financial Dashboard,Data-Dense Dashboard,Dark Mode (OLED) + Data-Dense,Dark bg + Red/Green alerts + Trust blue,Clear + Readable typography,Real-time number animations + Alert pulse,"{""must_have"": ""real-time-updates"", ""must_have"": ""high-contrast""}",Light mode default + Slow rendering,HIGH
+45,Analytics Dashboard,Data-Dense + Drill-Down,Data-Dense + Heat Map,Cool→Hot gradients + Neutral grey,Clear + Functional typography,Hover tooltips + Chart zoom + Filter animations,"{""must_have"": ""data-export"", ""if_large_dataset"": ""virtualize-lists""}",Ornate design + No filtering,HIGH
+46,Productivity Tool,Interactive Demo + Feature-Rich,Flat Design + Micro-interactions,Clear hierarchy + Functional colors,Clean + Efficient typography,Quick actions (150ms) + Task animations,"{""must_have"": ""keyboard-shortcuts"", ""if_collaboration"": ""add-real-time-cursors""}",Complex onboarding + Slow performance,HIGH
+47,Design System/Component Library,Feature-Rich + Documentation,Minimalism + Accessible & Ethical,Clear hierarchy + Code-like structure,Monospace + Clear typography,Code copy animations + Component previews,"{""must_have"": ""search"", ""must_have"": ""code-examples""}",Poor documentation + No live preview,HIGH
+48,AI/Chatbot Platform,Interactive Demo + Minimal,AI-Native UI + Minimalism,Neutral + AI Purple (#6366F1),Modern + Clear typography,Streaming text + Typing indicators + Fade-in,"{""must_have"": ""conversational-ui"", ""must_have"": ""context-awareness""}",Heavy chrome + Slow response feedback,HIGH
+49,NFT/Web3 Platform,Feature-Rich Showcase,Cyberpunk UI + Glassmorphism,Dark + Neon + Gold (#FFD700),Bold + Modern typography,Wallet connect animations + Transaction feedback,"{""must_have"": ""wallet-integration"", ""must_have"": ""gas-fees-display""}",Light mode default + No transaction status,HIGH
+50,Creator Economy Platform,Social Proof + Feature-Rich,Vibrant & Block-based + Bento Box Grid,Vibrant + Brand colors,Modern + Bold typography,Engagement counter animations + Profile reveals,"{""must_have"": ""creator-profiles"", ""must_have"": ""monetization-display""}",Generic layout + Hidden earnings,MEDIUM
+51,Sustainability/ESG Platform,Trust & Authority + Data,Organic Biophilic + Minimalism,Green (#228B22) + Earth tones,Clear + Informative typography,Progress indicators + Impact animations,"{""must_have"": ""data-transparency"", ""must_have"": ""certification-badges""}",Greenwashing visuals + No data,HIGH
+52,Remote Work/Collaboration,Feature-Rich + Real-Time,Soft UI Evolution + Minimalism,Calm Blue + Neutral grey,Clean + Readable typography,Real-time presence indicators + Notification badges,"{""must_have"": ""status-indicators"", ""must_have"": ""video-integration""}",Cluttered interface + No presence,HIGH
+53,Pet Tech App,Storytelling + Feature-Rich,Claymorphism + Vibrant & Block-based,Playful + Warm colors,Friendly + Playful typography,Pet profile animations + Health tracking charts,"{""must_have"": ""pet-profiles"", ""if_health"": ""add-vet-integration""}",Generic design + No personality,MEDIUM
+54,Smart Home/IoT Dashboard,Real-Time Monitoring,Glassmorphism + Dark Mode (OLED),Dark + Status indicator colors,Clear + Functional typography,Device status pulse + Quick action animations,"{""must_have"": ""real-time-controls"", ""must_have"": ""energy-monitoring""}",Slow updates + No automation,HIGH
+55,EV/Charging Ecosystem,Hero-Centric + Feature-Rich,Minimalism + Aurora UI,Electric Blue (#009CD1) + Green,Modern + Clear typography,Range estimation animations + Map interactions,"{""must_have"": ""charging-map"", ""must_have"": ""range-calculator""}",Poor map UX + Hidden costs,HIGH
+56,Subscription Box Service,Feature-Rich + Conversion,Vibrant & Block-based + Motion-Driven,Brand + Excitement colors,Engaging + Clear typography,Unboxing reveal animations + Product carousel,"{""must_have"": ""personalization-quiz"", ""must_have"": ""subscription-management""}",Confusing pricing + No unboxing preview,HIGH
+57,Podcast Platform,Storytelling + Feature-Rich,Dark Mode (OLED) + Minimalism,Dark + Audio waveform accents,Modern + Clear typography,Waveform visualizations + Episode transitions,"{""must_have"": ""audio-player-ux"", ""must_have"": ""episode-discovery""}",Poor audio player + Cluttered layout,HIGH
+58,Dating App,Social Proof + Feature-Rich,Vibrant & Block-based + Motion-Driven,Warm + Romantic (Pink/Red gradients),Modern + Friendly typography,Profile card swipe + Match animations,"{""must_have"": ""profile-cards"", ""must_have"": ""safety-features""}",Generic profiles + No safety,HIGH
+59,Micro-Credentials/Badges,Trust & Authority + Feature,Minimalism + Flat Design,Trust Blue + Gold (#FFD700),Professional + Clear typography,Badge reveal animations + Progress tracking,"{""must_have"": ""credential-verification"", ""must_have"": ""progress-display""}",No verification + Hidden progress,MEDIUM
+60,Knowledge Base/Documentation,FAQ + Minimal,Minimalism + Accessible & Ethical,Clean hierarchy + Minimal color,Clear + Readable typography,Search highlight + Smooth scrolling,"{""must_have"": ""search-first"", ""must_have"": ""version-switching""}",Poor navigation + No search,HIGH
+61,Hyperlocal Services,Conversion + Feature-Rich,Minimalism + Vibrant & Block-based,Location markers + Trust colors,Clear + Functional typography,Map hover + Provider card reveals,"{""must_have"": ""map-integration"", ""must_have"": ""booking-system""}",No map + Hidden reviews,HIGH
+62,Luxury/Premium Brand,Storytelling + Feature-Rich,Liquid Glass + Glassmorphism,Black + Gold (#FFD700) + White,Elegant + Refined typography,Slow parallax + Premium reveals (400-600ms),"{""must_have"": ""high-quality-imagery"", ""must_have"": ""storytelling""}",Cheap visuals + Fast animations,HIGH
+63,Fitness/Gym App,Feature-Rich + Data,Vibrant & Block-based + Dark Mode (OLED),Energetic (Orange #FF6B35) + Dark bg,Bold + Motivational typography,Progress ring animations + Achievement unlocks,"{""must_have"": ""progress-tracking"", ""must_have"": ""workout-plans""}",Static design + No gamification,HIGH
+64,Hotel/Hospitality,Hero-Centric + Social Proof,Liquid Glass + Minimalism,Warm neutrals + Gold (#D4AF37),Elegant + Welcoming typography,Room gallery + Amenity reveals,"{""must_have"": ""room-booking"", ""must_have"": ""virtual-tour""}",Poor photos + Complex booking,HIGH
+65,Wedding/Event Planning,Storytelling + Social Proof,Soft UI Evolution + Aurora UI,Soft Pink (#FFD6E0) + Gold + Cream,Elegant + Romantic typography,Gallery reveals + Timeline animations,"{""must_have"": ""portfolio-gallery"", ""must_have"": ""planning-tools""}",Generic templates + No portfolio,HIGH
+66,Insurance Platform,Conversion + Trust,Trust & Authority + Flat Design,Trust Blue (#0066CC) + Green + Neutral,Clear + Professional typography,Quote calculator animations + Policy comparison,"{""must_have"": ""quote-calculator"", ""must_have"": ""policy-comparison""}",Confusing pricing + No trust signals + AI purple/pink gradients,HIGH
+67,Banking/Traditional Finance,Trust & Authority + Feature,Minimalism + Accessible & Ethical,Navy (#0A1628) + Trust Blue + Gold,Professional + Trustworthy typography,Smooth number animations + Security indicators,"{""must_have"": ""security-first"", ""must_have"": ""accessibility""}",Playful design + Poor security UX + AI purple/pink gradients,HIGH
+68,Online Course/E-learning,Feature-Rich + Social Proof,Claymorphism + Vibrant & Block-based,Vibrant learning colors + Progress green,Friendly + Engaging typography,Progress bar animations + Certificate reveals,"{""must_have"": ""progress-tracking"", ""must_have"": ""video-player""}",Boring design + No gamification,HIGH
+69,Non-profit/Charity,Storytelling + Trust,Accessible & Ethical + Organic Biophilic,Cause-related colors + Trust + Warm,Heartfelt + Readable typography,Impact counter animations + Story reveals,"{""must_have"": ""impact-stories"", ""must_have"": ""donation-transparency""}",No impact data + Hidden financials,HIGH
+70,Florist/Plant Shop,Hero-Centric + Conversion,Organic Biophilic + Vibrant & Block-based,Natural Green + Floral pinks/purples,Elegant + Natural typography,Product reveal + Seasonal transitions,"{""must_have"": ""delivery-scheduling"", ""must_have"": ""care-guides""}",Poor imagery + No seasonal content,MEDIUM
+71,Bakery/Cafe,Hero-Centric + Conversion,Vibrant & Block-based + Soft UI Evolution,Warm Brown + Cream + Appetizing accents,Warm + Inviting typography,Menu hover + Order animations,"{""must_have"": ""menu-display"", ""must_have"": ""online-ordering""}",Poor food photos + Hidden hours,HIGH
+72,Coffee Shop,Hero-Centric + Minimal,Minimalism + Organic Biophilic,Coffee Brown (#6F4E37) + Cream + Warm,Cozy + Clean typography,Menu transitions + Loyalty animations,"{""must_have"": ""menu"", ""if_loyalty"": ""add-rewards-system""}",Generic design + No atmosphere,MEDIUM
+73,Brewery/Winery,Storytelling + Hero-Centric,Motion-Driven + Storytelling-Driven,Deep amber/burgundy + Gold + Craft,Artisanal + Heritage typography,Tasting note reveals + Heritage timeline,"{""must_have"": ""product-showcase"", ""must_have"": ""story-heritage""}",Generic product pages + No story,HIGH
+74,Airline,Conversion + Feature-Rich,Minimalism + Glassmorphism,Sky Blue + Brand colors + Trust,Clear + Professional typography,Flight search animations + Boarding pass reveals,"{""must_have"": ""flight-search"", ""must_have"": ""mobile-first""}",Complex booking + Poor mobile,HIGH
+75,Magazine/Blog,Storytelling + Hero-Centric,Swiss Modernism 2.0 + Motion-Driven,Editorial colors + Brand + Clean white,Editorial + Elegant typography,Article transitions + Category reveals,"{""must_have"": ""article-showcase"", ""must_have"": ""newsletter-signup""}",Poor typography + Slow loading,HIGH
+76,Freelancer Platform,Feature-Rich + Conversion,Flat Design + Minimalism,Professional Blue + Success Green,Clear + Professional typography,Skill match animations + Review reveals,"{""must_have"": ""portfolio-display"", ""must_have"": ""skill-matching""}",Poor profiles + No reviews,HIGH
+77,Consulting Firm,Trust & Authority + Minimal,Trust & Authority + Minimalism,Navy + Gold + Professional grey,Authoritative + Clear typography,Case study reveals + Team profiles,"{""must_have"": ""case-studies"", ""must_have"": ""thought-leadership""}",Generic content + No credentials + AI purple/pink gradients,HIGH
+78,Marketing Agency,Storytelling + Feature-Rich,Brutalism + Motion-Driven,Bold brand colors + Creative freedom,Bold + Expressive typography,Portfolio reveals + Results animations,"{""must_have"": ""portfolio"", ""must_have"": ""results-metrics""}",Boring design + Hidden work,HIGH
+79,Event Management,Hero-Centric + Feature-Rich,Vibrant & Block-based + Motion-Driven,Event theme colors + Excitement accents,Bold + Engaging typography,Countdown timer + Registration flow,"{""must_have"": ""registration"", ""must_have"": ""agenda-display""}",Confusing registration + No countdown,HIGH
+80,Conference/Webinar Platform,Feature-Rich + Conversion,Glassmorphism + Minimalism,Professional Blue + Video accent,Professional + Clear typography,Live stream integration + Agenda transitions,"{""must_have"": ""registration"", ""must_have"": ""speaker-profiles""}",Poor video UX + No networking,HIGH
+81,Membership/Community,Social Proof + Conversion,Vibrant & Block-based + Soft UI Evolution,Community brand colors + Engagement,Friendly + Engaging typography,Member counter + Benefit reveals,"{""must_have"": ""member-benefits"", ""must_have"": ""pricing-tiers""}",Hidden benefits + No community proof,HIGH
+82,Newsletter Platform,Minimal + Conversion,Minimalism + Flat Design,Brand primary + Clean white + CTA,Clean + Readable typography,Subscribe form + Archive reveals,"{""must_have"": ""subscribe-form"", ""must_have"": ""sample-content""}",Complex signup + No preview,MEDIUM
+83,Digital Products/Downloads,Feature-Rich + Conversion,Vibrant & Block-based + Motion-Driven,Product colors + Brand + Success green,Modern + Clear typography,Product preview + Instant delivery animations,"{""must_have"": ""product-preview"", ""must_have"": ""instant-delivery""}",No preview + Slow delivery,HIGH
+84,Church/Religious Organization,Hero-Centric + Social Proof,Accessible & Ethical + Soft UI Evolution,Warm Gold + Deep Purple/Blue + White,Welcoming + Clear typography,Service time highlights + Event calendar,"{""must_have"": ""service-times"", ""must_have"": ""community-events""}",Outdated design + Hidden info,MEDIUM
+85,Sports Team/Club,Hero-Centric + Feature-Rich,Vibrant & Block-based + Motion-Driven,Team colors + Energetic accents,Bold + Impactful typography,Score animations + Schedule reveals,"{""must_have"": ""schedule"", ""must_have"": ""roster""}",Static content + Poor fan engagement,HIGH
+86,Museum/Gallery,Storytelling + Feature-Rich,Minimalism + Motion-Driven,Art-appropriate neutrals + Exhibition accents,Elegant + Minimal typography,Virtual tour + Collection reveals,"{""must_have"": ""virtual-tour"", ""must_have"": ""exhibition-info""}",Cluttered layout + No online access,HIGH
+87,Theater/Cinema,Hero-Centric + Conversion,Dark Mode (OLED) + Motion-Driven,Dark + Spotlight accents + Gold,Dramatic + Bold typography,Seat selection + Trailer reveals,"{""must_have"": ""showtimes"", ""must_have"": ""seat-selection""}",Poor booking UX + No trailers,HIGH
+88,Language Learning App,Feature-Rich + Social Proof,Claymorphism + Vibrant & Block-based,Playful colors + Progress indicators,Friendly + Clear typography,Progress animations + Achievement unlocks,"{""must_have"": ""progress-tracking"", ""must_have"": ""gamification""}",Boring design + No motivation,HIGH
+89,Coding Bootcamp,Feature-Rich + Social Proof,Dark Mode (OLED) + Minimalism,Code editor colors + Brand + Success,Technical + Clear typography,Terminal animations + Career outcome reveals,"{""must_have"": ""curriculum"", ""must_have"": ""career-outcomes""}",Light mode only + Hidden results,HIGH
+90,Cybersecurity Platform,Trust & Authority + Real-Time,Cyberpunk UI + Dark Mode (OLED),Matrix Green (#00FF00) + Deep Black,Technical + Clear typography,Threat visualization + Alert animations,"{""must_have"": ""real-time-monitoring"", ""must_have"": ""threat-display""}",Light mode + Poor data viz,HIGH
+91,Developer Tool/IDE,Minimal + Documentation,Dark Mode (OLED) + Minimalism,Dark syntax theme + Blue focus,Monospace + Functional typography,Syntax highlighting + Command palette,"{""must_have"": ""keyboard-shortcuts"", ""must_have"": ""documentation""}",Light mode default + Slow performance,HIGH
+92,Biotech/Life Sciences,Storytelling + Data,Glassmorphism + Clean Science,Sterile White + DNA Blue + Life Green,Scientific + Clear typography,Data visualization + Research reveals,"{""must_have"": ""data-accuracy"", ""must_have"": ""clean-aesthetic""}",Cluttered data + Poor credibility,HIGH
+93,Space Tech/Aerospace,Immersive + Feature-Rich,Holographic/HUD + Dark Mode,Deep Space Black + Star White + Metallic,Futuristic + Precise typography,Telemetry animations + 3D renders,"{""must_have"": ""high-tech-feel"", ""must_have"": ""precision-data""}",Generic design + No immersion,HIGH
+94,Architecture/Interior,Portfolio + Hero-Centric,Exaggerated Minimalism + High Imagery,Monochrome + Gold Accent + High Imagery,Architectural + Elegant typography,Project gallery + Blueprint reveals,"{""must_have"": ""high-res-images"", ""must_have"": ""project-portfolio""}",Poor imagery + Cluttered layout,HIGH
+95,Quantum Computing,Immersive + Interactive,Holographic/HUD + Dark Mode,Quantum Blue (#00FFFF) + Deep Black,Futuristic + Scientific typography,Probability visualizations + Qubit state animations,"{""must_have"": ""complexity-visualization"", ""must_have"": ""scientific-credibility""}",Generic tech design + No viz,HIGH
+96,Biohacking/Longevity App,Data-Dense + Storytelling,Biomimetic/Organic 2.0 + Minimalism,Cellular Pink/Red + DNA Blue + White,Scientific + Clear typography,Biological data viz + Progress animations,"{""must_have"": ""data-privacy"", ""must_have"": ""scientific-credibility""}",Generic health app + No privacy,HIGH
+97,Autonomous Drone Fleet,Real-Time + Feature-Rich,HUD/Sci-Fi FUI + Real-Time,Tactical Green + Alert Red + Map Dark,Technical + Functional typography,Telemetry animations + 3D spatial awareness,"{""must_have"": ""real-time-telemetry"", ""must_have"": ""safety-alerts""}",Slow updates + Poor spatial viz,HIGH
+98,Generative Art Platform,Showcase + Feature-Rich,Minimalism + Gen Z Chaos,Neutral (#F5F5F5) + User Content,Minimal + Content-focused typography,Gallery masonry + Minting animations,"{""must_have"": ""fast-loading"", ""must_have"": ""creator-attribution""}",Heavy chrome + Slow loading,HIGH
+99,Spatial Computing OS,Immersive + Interactive,Spatial UI (VisionOS) + Glassmorphism,Frosted Glass + System Colors + Depth,Spatial + Readable typography,Depth hierarchy + Gaze interactions,"{""must_have"": ""depth-hierarchy"", ""must_have"": ""environment-awareness""}",2D design + No spatial depth,HIGH
+100,Sustainable Energy/Climate,Data + Trust,Organic Biophilic + E-Ink/Paper,Earth Green + Sky Blue + Solar Yellow,Clear + Informative typography,Impact viz + Progress animations,"{""must_have"": ""data-transparency"", ""must_have"": ""impact-visualization""}",Greenwashing + No real data,HIGH
diff --git a/.agents/skills/ui-ux-pro-max/data/ux-guidelines.csv b/.agents/skills/ui-ux-pro-max/data/ux-guidelines.csv
new file mode 100644
index 0000000..e347aed
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/ux-guidelines.csv
@@ -0,0 +1,100 @@
+No,Category,Issue,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Navigation,Smooth Scroll,Web,Anchor links should scroll smoothly to target section,Use scroll-behavior: smooth on html element,Jump directly without transition,html { scroll-behavior: smooth; },<a href='#section'> without CSS,High
+2,Navigation,Sticky Navigation,Web,Fixed nav should not obscure content,Add padding-top to body equal to nav height,Let nav overlap first section content,pt-20 (if nav is h-20),No padding compensation,Medium
+3,Navigation,Active State,All,Current page/section should be visually indicated,Highlight active nav item with color/underline,No visual feedback on current location,text-primary border-b-2,All links same style,Medium
+4,Navigation,Back Button,Mobile,Users expect back to work predictably,Preserve navigation history properly,Break browser/app back button behavior,history.pushState(),location.replace(),High
+5,Navigation,Deep Linking,All,URLs should reflect current state for sharing,Update URL on state/view changes,Static URLs for dynamic content,Use query params or hash,Single URL for all states,Medium
+6,Navigation,Breadcrumbs,Web,Show user location in site hierarchy,Use for sites with 3+ levels of depth,Use for flat single-level sites,Home > Category > Product,Only on deep nested pages,Low
+7,Animation,Excessive Motion,All,Too many animations cause distraction and motion sickness,Animate 1-2 key elements per view maximum,Animate everything that moves,Single hero animation,animate-bounce on 5+ elements,High
+8,Animation,Duration Timing,All,Animations should feel responsive not sluggish,Use 150-300ms for micro-interactions,Use animations longer than 500ms for UI,transition-all duration-200,duration-1000,Medium
+9,Animation,Reduced Motion,All,Respect user's motion preferences,Check prefers-reduced-motion media query,Ignore accessibility motion settings,@media (prefers-reduced-motion: reduce),No motion query check,High
+10,Animation,Loading States,All,Show feedback during async operations,Use skeleton screens or spinners,Leave UI frozen with no feedback,animate-pulse skeleton,Blank screen while loading,High
+11,Animation,Hover vs Tap,All,Hover effects don't work on touch devices,Use click/tap for primary interactions,Rely only on hover for important actions,onClick handler,onMouseEnter only,High
+12,Animation,Continuous Animation,All,Infinite animations are distracting,Use for loading indicators only,Use for decorative elements,animate-spin on loader,animate-bounce on icons,Medium
+13,Animation,Transform Performance,Web,Some CSS properties trigger expensive repaints,Use transform and opacity for animations,Animate width/height/top/left properties,transform: translateY(),top: 10px animation,Medium
+14,Animation,Easing Functions,All,Linear motion feels robotic,Use ease-out for entering ease-in for exiting,Use linear for UI transitions,ease-out,linear,Low
+15,Layout,Z-Index Management,Web,Stacking context conflicts cause hidden elements,Define z-index scale system (10 20 30 50),Use arbitrary large z-index values,z-10 z-20 z-50,z-[9999],High
+16,Layout,Overflow Hidden,Web,Hidden overflow can clip important content,Test all content fits within containers,Blindly apply overflow-hidden,overflow-auto with scroll,overflow-hidden truncating content,Medium
+17,Layout,Fixed Positioning,Web,Fixed elements can overlap or be inaccessible,Account for safe areas and other fixed elements,Stack multiple fixed elements carelessly,Fixed nav + fixed bottom with gap,Multiple overlapping fixed elements,Medium
+18,Layout,Stacking Context,Web,New stacking contexts reset z-index,Understand what creates new stacking context,Expect z-index to work across contexts,Parent with z-index isolates children,z-index: 9999 not working,Medium
+19,Layout,Content Jumping,Web,Layout shift when content loads is jarring,Reserve space for async content,Let images/content push layout around,aspect-ratio or fixed height,No dimensions on images,High
+20,Layout,Viewport Units,Web,100vh can be problematic on mobile browsers,Use dvh or account for mobile browser chrome,Use 100vh for full-screen mobile layouts,min-h-dvh or min-h-screen,h-screen on mobile,Medium
+21,Layout,Container Width,Web,Content too wide is hard to read,Limit max-width for text content (65-75ch),Let text span full viewport width,max-w-prose or max-w-3xl,Full width paragraphs,Medium
+22,Touch,Touch Target Size,Mobile,Small buttons are hard to tap accurately,Minimum 44x44px touch targets,Tiny clickable areas,min-h-[44px] min-w-[44px],w-6 h-6 buttons,High
+23,Touch,Touch Spacing,Mobile,Adjacent touch targets need adequate spacing,Minimum 8px gap between touch targets,Tightly packed clickable elements,gap-2 between buttons,gap-0 or gap-1,Medium
+24,Touch,Gesture Conflicts,Mobile,Custom gestures can conflict with system,Avoid horizontal swipe on main content,Override system gestures,Vertical scroll primary,Horizontal swipe carousel only,Medium
+25,Touch,Tap Delay,Mobile,300ms tap delay feels laggy,Use touch-action CSS or fastclick,Default mobile tap handling,touch-action: manipulation,No touch optimization,Medium
+26,Touch,Pull to Refresh,Mobile,Accidental refresh is frustrating,Disable where not needed,Enable by default everywhere,overscroll-behavior: contain,Default overscroll,Low
+27,Touch,Haptic Feedback,Mobile,Tactile feedback improves interaction feel,Use for confirmations and important actions,Overuse vibration feedback,navigator.vibrate(10),Vibrate on every tap,Low
+28,Interaction,Focus States,All,Keyboard users need visible focus indicators,Use visible focus rings on interactive elements,Remove focus outline without replacement,focus:ring-2 focus:ring-blue-500,outline-none without alternative,High
+29,Interaction,Hover States,Web,Visual feedback on interactive elements,Change cursor and add subtle visual change,No hover feedback on clickable elements,hover:bg-gray-100 cursor-pointer,No hover style,Medium
+30,Interaction,Active States,All,Show immediate feedback on press/click,Add pressed/active state visual change,No feedback during interaction,active:scale-95,No active state,Medium
+31,Interaction,Disabled States,All,Clearly indicate non-interactive elements,Reduce opacity and change cursor,Confuse disabled with normal state,opacity-50 cursor-not-allowed,Same style as enabled,Medium
+32,Interaction,Loading Buttons,All,Prevent double submission during async actions,Disable button and show loading state,Allow multiple clicks during processing,disabled={loading} spinner,Button clickable while loading,High
+33,Interaction,Error Feedback,All,Users need to know when something fails,Show clear error messages near problem,Silent failures with no feedback,Red border + error message,No indication of error,High
+34,Interaction,Success Feedback,All,Confirm successful actions to users,Show success message or visual change,No confirmation of completed action,Toast notification or checkmark,Action completes silently,Medium
+35,Interaction,Confirmation Dialogs,All,Prevent accidental destructive actions,Confirm before delete/irreversible actions,Delete without confirmation,Are you sure modal,Direct delete on click,High
+36,Accessibility,Color Contrast,All,Text must be readable against background,Minimum 4.5:1 ratio for normal text,Low contrast text,#333 on white (7:1),#999 on white (2.8:1),High
+37,Accessibility,Color Only,All,Don't convey information by color alone,Use icons/text in addition to color,Red/green only for error/success,Red text + error icon,Red border only for error,High
+38,Accessibility,Alt Text,All,Images need text alternatives,Descriptive alt text for meaningful images,Empty or missing alt attributes,alt='Dog playing in park',alt='' for content images,High
+39,Accessibility,Heading Hierarchy,Web,Screen readers use headings for navigation,Use sequential heading levels h1-h6,Skip heading levels or misuse for styling,h1 then h2 then h3,h1 then h4,Medium
+40,Accessibility,ARIA Labels,All,Interactive elements need accessible names,Add aria-label for icon-only buttons,Icon buttons without labels,aria-label='Close menu',<button><Icon/></button>,High
+41,Accessibility,Keyboard Navigation,Web,All functionality accessible via keyboard,Tab order matches visual order,Keyboard traps or illogical tab order,tabIndex for custom order,Unreachable elements,High
+42,Accessibility,Screen Reader,All,Content should make sense when read aloud,Use semantic HTML and ARIA properly,Div soup with no semantics,<nav> <main> <article>,<div> for everything,Medium
+43,Accessibility,Form Labels,All,Inputs must have associated labels,Use label with for attribute or wrap input,Placeholder-only inputs,<label for='email'>,placeholder='Email' only,High
+44,Accessibility,Error Messages,All,Error messages must be announced,Use aria-live or role=alert for errors,Visual-only error indication,role='alert',Red border only,High
+45,Accessibility,Skip Links,Web,Allow keyboard users to skip navigation,Provide skip to main content link,No skip link on nav-heavy pages,Skip to main content link,100 tabs to reach content,Medium
+46,Performance,Image Optimization,All,Large images slow page load,Use appropriate size and format (WebP),Unoptimized full-size images,srcset with multiple sizes,4000px image for 400px display,High
+47,Performance,Lazy Loading,All,Load content as needed,Lazy load below-fold images and content,Load everything upfront,loading='lazy',All images eager load,Medium
+48,Performance,Code Splitting,Web,Large bundles slow initial load,Split code by route/feature,Single large bundle,dynamic import(),All code in main bundle,Medium
+49,Performance,Caching,Web,Repeat visits should be fast,Set appropriate cache headers,No caching strategy,Cache-Control headers,Every request hits server,Medium
+50,Performance,Font Loading,Web,Web fonts can block rendering,Use font-display swap or optional,Invisible text during font load,font-display: swap,FOIT (Flash of Invisible Text),Medium
+51,Performance,Third Party Scripts,Web,External scripts can block rendering,Load non-critical scripts async/defer,Synchronous third-party scripts,async or defer attribute,<script src='...'> in head,Medium
+52,Performance,Bundle Size,Web,Large JavaScript slows interaction,Monitor and minimize bundle size,Ignore bundle size growth,Bundle analyzer,No size monitoring,Medium
+53,Performance,Render Blocking,Web,CSS/JS can block first paint,Inline critical CSS defer non-critical,Large blocking CSS files,Critical CSS inline,All CSS in head,Medium
+54,Forms,Input Labels,All,Every input needs a visible label,Always show label above or beside input,Placeholder as only label,<label>Email</label><input>,placeholder='Email' only,High
+55,Forms,Error Placement,All,Errors should appear near the problem,Show error below related input,Single error message at top of form,Error under each field,All errors at form top,Medium
+56,Forms,Inline Validation,All,Validate as user types or on blur,Validate on blur for most fields,Validate only on submit,onBlur validation,Submit-only validation,Medium
+57,Forms,Input Types,All,Use appropriate input types,Use email tel number url etc,Text input for everything,type='email',type='text' for email,Medium
+58,Forms,Autofill Support,Web,Help browsers autofill correctly,Use autocomplete attribute properly,Block or ignore autofill,autocomplete='email',autocomplete='off' everywhere,Medium
+59,Forms,Required Indicators,All,Mark required fields clearly,Use asterisk or (required) text,No indication of required fields,* required indicator,Guess which are required,Medium
+60,Forms,Password Visibility,All,Let users see password while typing,Toggle to show/hide password,No visibility toggle,Show/hide password button,Password always hidden,Medium
+61,Forms,Submit Feedback,All,Confirm form submission status,Show loading then success/error state,No feedback after submit,Loading -> Success message,Button click with no response,High
+62,Forms,Input Affordance,All,Inputs should look interactive,Use distinct input styling,Inputs that look like plain text,Border/background on inputs,Borderless inputs,Medium
+63,Forms,Mobile Keyboards,Mobile,Show appropriate keyboard for input type,Use inputmode attribute,Default keyboard for all inputs,inputmode='numeric',Text keyboard for numbers,Medium
+64,Responsive,Mobile First,Web,Design for mobile then enhance for larger,Start with mobile styles then add breakpoints,Desktop-first causing mobile issues,Default mobile + md: lg: xl:,Desktop default + max-width queries,Medium
+65,Responsive,Breakpoint Testing,Web,Test at all common screen sizes,Test at 320 375 414 768 1024 1440,Only test on your device,Multiple device testing,Single device development,Medium
+66,Responsive,Touch Friendly,Web,Mobile layouts need touch-sized targets,Increase touch targets on mobile,Same tiny buttons on mobile,Larger buttons on mobile,Desktop-sized targets on mobile,High
+67,Responsive,Readable Font Size,All,Text must be readable on all devices,Minimum 16px body text on mobile,Tiny text on mobile,text-base or larger,text-xs for body text,High
+68,Responsive,Viewport Meta,Web,Set viewport for mobile devices,Use width=device-width initial-scale=1,Missing or incorrect viewport,<meta name='viewport'...>,No viewport meta tag,High
+69,Responsive,Horizontal Scroll,Web,Avoid horizontal scrolling,Ensure content fits viewport width,Content wider than viewport,max-w-full overflow-x-hidden,Horizontal scrollbar on mobile,High
+70,Responsive,Image Scaling,Web,Images should scale with container,Use max-width: 100% on images,Fixed width images overflow,max-w-full h-auto,width='800' fixed,Medium
+71,Responsive,Table Handling,Web,Tables can overflow on mobile,Use horizontal scroll or card layout,Wide tables breaking layout,overflow-x-auto wrapper,Table overflows viewport,Medium
+72,Typography,Line Height,All,Adequate line height improves readability,Use 1.5-1.75 for body text,Cramped or excessive line height,leading-relaxed (1.625),leading-none (1),Medium
+73,Typography,Line Length,Web,Long lines are hard to read,Limit to 65-75 characters per line,Full-width text on large screens,max-w-prose,Full viewport width text,Medium
+74,Typography,Font Size Scale,All,Consistent type hierarchy aids scanning,Use consistent modular scale,Random font sizes,Type scale (12 14 16 18 24 32),Arbitrary sizes,Medium
+75,Typography,Font Loading,Web,Fonts should load without layout shift,Reserve space with fallback font,Layout shift when fonts load,font-display: swap + similar fallback,No fallback font,Medium
+76,Typography,Contrast Readability,All,Body text needs good contrast,Use darker text on light backgrounds,Gray text on gray background,text-gray-900 on white,text-gray-400 on gray-100,High
+77,Typography,Heading Clarity,All,Headings should stand out from body,Clear size/weight difference,Headings similar to body text,Bold + larger size,Same size as body,Medium
+78,Feedback,Loading Indicators,All,Show system status during waits,Show spinner/skeleton for operations > 300ms,No feedback during loading,Skeleton or spinner,Frozen UI,High
+79,Feedback,Empty States,All,Guide users when no content exists,Show helpful message and action,Blank empty screens,No items yet. Create one!,Empty white space,Medium
+80,Feedback,Error Recovery,All,Help users recover from errors,Provide clear next steps,Error without recovery path,Try again button + help link,Error message only,Medium
+81,Feedback,Progress Indicators,All,Show progress for multi-step processes,Step indicators or progress bar,No indication of progress,Step 2 of 4 indicator,No step information,Medium
+82,Feedback,Toast Notifications,All,Transient messages for non-critical info,Auto-dismiss after 3-5 seconds,Toasts that never disappear,Auto-dismiss toast,Persistent toast,Medium
+83,Feedback,Confirmation Messages,All,Confirm successful actions,Brief success message,Silent success,Saved successfully toast,No confirmation,Medium
+84,Content,Truncation,All,Handle long content gracefully,Truncate with ellipsis and expand option,Overflow or broken layout,line-clamp-2 with expand,Overflow or cut off,Medium
+85,Content,Date Formatting,All,Use locale-appropriate date formats,Use relative or locale-aware dates,Ambiguous date formats,2 hours ago or locale format,01/02/03,Low
+86,Content,Number Formatting,All,Format large numbers for readability,Use thousand separators or abbreviations,Long unformatted numbers,"1.2K or 1,234",1234567,Low
+87,Content,Placeholder Content,All,Show realistic placeholders during dev,Use realistic sample data,Lorem ipsum everywhere,Real sample content,Lorem ipsum,Low
+88,Onboarding,User Freedom,All,Users should be able to skip tutorials,Provide Skip and Back buttons,Force linear unskippable tour,Skip Tutorial button,Locked overlay until finished,Medium
+89,Search,Autocomplete,Web,Help users find results faster,Show predictions as user types,Require full type and enter,Debounced fetch + dropdown,No suggestions,Medium
+90,Search,No Results,Web,Dead ends frustrate users,Show 'No results' with suggestions,Blank screen or '0 results',Try searching for X instead,No results found.,Medium
+91,Data Entry,Bulk Actions,Web,Editing one by one is tedious,Allow multi-select and bulk edit,Single row actions only,Checkbox column + Action bar,Repeated actions per row,Low
+92,AI Interaction,Disclaimer,All,Users need to know they talk to AI,Clearly label AI generated content,Present AI as human,AI Assistant label,Fake human name without label,High
+93,AI Interaction,Streaming,All,Waiting for full text is slow,Stream text response token by token,Show loading spinner for 10s+,Typewriter effect,Spinner until 100% complete,Medium
+94,Spatial UI,Gaze Hover,VisionOS,Elements should respond to eye tracking before pinch,Scale/highlight element on look,Static element until pinch,hoverEffect(),onTap only,High
+95,Spatial UI,Depth Layering,VisionOS,UI needs Z-depth to separate content from environment,Use glass material and z-offset,Flat opaque panels blocking view,.glassBackgroundEffect(),bg-white,Medium
+96,Sustainability,Auto-Play Video,Web,Video consumes massive data and energy,Click-to-play or pause when off-screen,Auto-play high-res video loops,playsInline muted preload='none',autoplay loop,Medium
+97,Sustainability,Asset Weight,Web,Heavy 3D/Image assets increase carbon footprint,Compress and lazy load 3D models,Load 50MB textures,Draco compression,Raw .obj files,Medium
+98,AI Interaction,Feedback Loop,All,AI needs user feedback to improve,Thumps up/down or 'Regenerate',Static output only,Feedback component,Read-only text,Low
+99,Accessibility,Motion Sensitivity,All,Parallax/Scroll-jacking causes nausea,Respect prefers-reduced-motion,Force scroll effects,@media (prefers-reduced-motion),ScrollTrigger.create(),High
\ No newline at end of file
diff --git a/.agents/skills/ui-ux-pro-max/data/web-interface.csv b/.agents/skills/ui-ux-pro-max/data/web-interface.csv
new file mode 100644
index 0000000..4713aad
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/data/web-interface.csv
@@ -0,0 +1,31 @@
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Accessibility,Icon Button Labels,icon button aria-label,Web,Icon-only buttons must have accessible names,Add aria-label to icon buttons,Icon button without label,"<button aria-label='Close'><XIcon /></button>","<button><XIcon /></button>",Critical
+2,Accessibility,Form Control Labels,form input label aria,Web,All form controls need labels or aria-label,Use label element or aria-label,Input without accessible name,"<label for='email'>Email</label><input id='email' />","<input placeholder='Email' />",Critical
+3,Accessibility,Keyboard Handlers,keyboard onclick onkeydown,Web,Interactive elements must support keyboard interaction,Add onKeyDown alongside onClick,Click-only interaction,"<div onClick={fn} onKeyDown={fn} tabIndex={0}>","<div onClick={fn}>",High
+4,Accessibility,Semantic HTML,semantic button a label,Web,Use semantic HTML before ARIA attributes,Use button/a/label elements,Div with role attribute,"<button onClick={fn}>Submit</button>","<div role='button' onClick={fn}>Submit</div>",High
+5,Accessibility,Aria Live,aria-live polite async,Web,Async updates need aria-live for screen readers,Add aria-live='polite' for dynamic content,Silent async updates,"<div aria-live='polite'>{status}</div>","<div>{status}</div> // no announcement",Medium
+6,Accessibility,Decorative Icons,aria-hidden decorative icon,Web,Decorative icons should be hidden from screen readers,Add aria-hidden='true' to decorative icons,Decorative icon announced,"<Icon aria-hidden='true' />","<Icon /> // announced as 'image'",Medium
+7,Focus,Visible Focus States,focus-visible outline ring,Web,All interactive elements need visible focus states,Use :focus-visible with ring/outline,No focus indication,"focus-visible:ring-2 focus-visible:ring-blue-500","outline-none // no replacement",Critical
+8,Focus,Never Remove Outline,outline-none focus replacement,Web,Never remove outline without providing replacement,Replace outline with visible alternative,Remove outline completely,"focus:outline-none focus:ring-2","focus:outline-none // nothing else",Critical
+9,Focus,Checkbox Radio Hit Target,checkbox radio label target,Web,Checkbox/radio must share hit target with label,Wrap input and label together,Separate tiny checkbox,"<label class='flex gap-2'><input type='checkbox' /><span>Option</span></label>","<input type='checkbox' id='x' /><label for='x'>Option</label>",Medium
+10,Forms,Autocomplete Attribute,autocomplete input form,Web,Inputs need autocomplete attribute for autofill,Add appropriate autocomplete value,Missing autocomplete,"<input autocomplete='email' type='email' />","<input type='email' />",High
+11,Forms,Semantic Input Types,input type email tel url,Web,Use semantic input type attributes,Use email/tel/url/number types,text type for everything,"<input type='email' />","<input type='text' /> // for email",Medium
+12,Forms,Never Block Paste,paste onpaste password,Web,Never prevent paste functionality,Allow paste on all inputs,Block paste on password/code,"<input type='password' />","<input onPaste={e => e.preventDefault()} />",High
+13,Forms,Spellcheck Disable,spellcheck email code,Web,Disable spellcheck on emails and codes,Set spellcheck='false' on codes,Spellcheck on technical input,"<input spellCheck='false' type='email' />","<input type='email' /> // red squiggles",Low
+14,Forms,Submit Button Enabled,submit button disabled loading,Web,Keep submit enabled and show spinner during requests,Show loading spinner keep enabled,Disable button during submit,"<button>{loading ? <Spinner /> : 'Submit'}</button>","<button disabled={loading}>Submit</button>",Medium
+15,Forms,Inline Errors,error message inline focus,Web,Show error messages inline near the problem field,Inline error with focus on first error,Single error at top,"<input /><span class='text-red-500'>{error}</span>","<div class='error'>{allErrors}</div> // at top",High
+16,Performance,Virtualize Lists,virtualize list 50 items,Web,Virtualize lists exceeding 50 items,Use virtual list for large datasets,Render all items,"<VirtualList items={items} />","items.map(item => <Item />)",High
+17,Performance,Avoid Layout Reads,layout read render getboundingclientrect,Web,Avoid layout reads during render phase,Read layout in effects or callbacks,getBoundingClientRect in render,"useEffect(() => { el.getBoundingClientRect() })","const rect = el.getBoundingClientRect() // in render",Medium
+18,Performance,Batch DOM Operations,batch dom write read,Web,Group DOM operations to minimize reflows,Batch writes then reads,Interleave reads and writes,"writes.forEach(w => w()); reads.forEach(r => r())","write(); read(); write(); read(); // thrashing",Medium
+19,Performance,Preconnect CDN,preconnect link cdn,Web,Add preconnect links for CDN domains,Preconnect to known domains,"<link rel='preconnect' href='https://cdn.example.com' />","// no preconnect hint",Low
+20,Performance,Lazy Load Images,lazy loading image below-fold,Web,Lazy-load images below the fold,Use loading='lazy' for below-fold images,Load all images eagerly,"<img loading='lazy' src='...' />","<img src='...' /> // above fold only",Medium
+21,State,URL Reflects State,url state query params,Web,URL should reflect current UI state,Sync filters/tabs/pagination to URL,State only in memory,"?tab=settings&page=2","useState only // lost on refresh",High
+22,State,Deep Linking,deep link stateful component,Web,Stateful components should support deep-linking,Enable sharing current view via URL,No shareable state,"router.push({ query: { ...filters } })","setFilters(f) // not in URL",Medium
+23,State,Confirm Destructive Actions,confirm destructive delete modal,Web,Destructive actions require confirmation,Show confirmation dialog before delete,Delete without confirmation,"if (confirm('Delete?')) delete()","onClick={delete} // no confirmation",High
+24,Typography,Proper Unicode,unicode ellipsis quotes,Web,Use proper Unicode characters,Use ... curly quotes proper dashes,ASCII approximations,"'Hello...' with proper ellipsis","'Hello...' with three dots",Low
+25,Typography,Text Overflow,truncate line-clamp overflow,Web,Handle text overflow properly,Use truncate/line-clamp/break-words,Text overflows container,"<p class='truncate'>Long text...</p>","<p>Long text...</p> // overflows",Medium
+26,Typography,Non-Breaking Spaces,nbsp unit brand,Web,Use non-breaking spaces for units and brand names,Use &nbsp; between number and unit,"10&nbsp;kg or Next.js&nbsp;14","10 kg // may wrap",Low
+27,Anti-Pattern,No Zoom Disable,viewport zoom disable,Web,Never disable zoom in viewport meta,Allow user zoom,"<meta name='viewport' content='width=device-width'>","<meta name='viewport' content='maximum-scale=1'>",Critical
+28,Anti-Pattern,No Transition All,transition all specific,Web,Avoid transition: all - specify properties,Transition specific properties,transition: all,"transition-colors duration-200","transition-all duration-200",Medium
+29,Anti-Pattern,Outline Replacement,outline-none ring focus,Web,Never use outline-none without replacement,Provide visible focus replacement,Remove outline with nothing,"focus:outline-none focus:ring-2 focus:ring-blue-500","focus:outline-none // alone",Critical
+30,Anti-Pattern,No Hardcoded Dates,date format intl locale,Web,Use Intl for date/number formatting,Use Intl.DateTimeFormat,Hardcoded date format,"new Intl.DateTimeFormat('en').format(date)","date.toLocaleDateString() // or manual format",Medium
diff --git a/.agents/skills/ui-ux-pro-max/scripts/core.py b/.agents/skills/ui-ux-pro-max/scripts/core.py
new file mode 100644
index 0000000..f491e7b
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/scripts/core.py
@@ -0,0 +1,257 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Core - BM25 search engine for UI/UX style guides
+"""
+
+import csv
+import re
+from pathlib import Path
+from math import log
+from collections import defaultdict
+
+# ============ CONFIGURATION ============
+DATA_DIR = Path(__file__).parent.parent / "data"
+MAX_RESULTS = 3
+
+CSV_CONFIG = {
+    "style": {
+        "file": "styles.csv",
+        "search_cols": ["Style Category", "Keywords", "Best For", "Type"],
+        "output_cols": ["Style Category", "Type", "Keywords", "Primary Colors", "Effects & Animation", "Best For", "Performance", "Accessibility", "Framework Compatibility", "Complexity"]
+    },
+    "prompt": {
+        "file": "prompts.csv",
+        "search_cols": ["Style Category", "AI Prompt Keywords (Copy-Paste Ready)", "CSS/Technical Keywords"],
+        "output_cols": ["Style Category", "AI Prompt Keywords (Copy-Paste Ready)", "CSS/Technical Keywords", "Implementation Checklist"]
+    },
+    "color": {
+        "file": "colors.csv",
+        "search_cols": ["Product Type", "Keywords", "Notes"],
+        "output_cols": ["Product Type", "Keywords", "Primary (Hex)", "Secondary (Hex)", "CTA (Hex)", "Background (Hex)", "Text (Hex)", "Border (Hex)", "Notes"]
+    },
+    "chart": {
+        "file": "charts.csv",
+        "search_cols": ["Data Type", "Keywords", "Best Chart Type", "Accessibility Notes"],
+        "output_cols": ["Data Type", "Keywords", "Best Chart Type", "Secondary Options", "Color Guidance", "Accessibility Notes", "Library Recommendation", "Interactive Level"]
+    },
+    "landing": {
+        "file": "landing.csv",
+        "search_cols": ["Pattern Name", "Keywords", "Conversion Optimization", "Section Order"],
+        "output_cols": ["Pattern Name", "Keywords", "Section Order", "Primary CTA Placement", "Color Strategy", "Conversion Optimization"]
+    },
+    "product": {
+        "file": "products.csv",
+        "search_cols": ["Product Type", "Keywords", "Primary Style Recommendation", "Key Considerations"],
+        "output_cols": ["Product Type", "Keywords", "Primary Style Recommendation", "Secondary Styles", "Landing Page Pattern", "Dashboard Style (if applicable)", "Color Palette Focus"]
+    },
+    "ux": {
+        "file": "ux-guidelines.csv",
+        "search_cols": ["Category", "Issue", "Description", "Platform"],
+        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
+    },
+    "typography": {
+        "file": "typography.csv",
+        "search_cols": ["Font Pairing Name", "Category", "Mood/Style Keywords", "Best For", "Heading Font", "Body Font"],
+        "output_cols": ["Font Pairing Name", "Category", "Heading Font", "Body Font", "Mood/Style Keywords", "Best For", "Google Fonts URL", "CSS Import", "Tailwind Config", "Notes"]
+    },
+    "icons": {
+        "file": "icons.csv",
+        "search_cols": ["Category", "Icon Name", "Keywords", "Best For"],
+        "output_cols": ["Category", "Icon Name", "Keywords", "Library", "Import Code", "Usage", "Best For", "Style"]
+    },
+    "react": {
+        "file": "react-performance.csv",
+        "search_cols": ["Category", "Issue", "Keywords", "Description"],
+        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
+    },
+    "web": {
+        "file": "web-interface.csv",
+        "search_cols": ["Category", "Issue", "Keywords", "Description"],
+        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
+    }
+}
+
+STACK_CONFIG = {
+    "html-tailwind": {"file": "stacks/html-tailwind.csv"},
+    "react": {"file": "stacks/react.csv"},
+    "nextjs": {"file": "stacks/nextjs.csv"},
+    "vue": {"file": "stacks/vue.csv"},
+    "nuxtjs": {"file": "stacks/nuxtjs.csv"},
+    "nuxt-ui": {"file": "stacks/nuxt-ui.csv"},
+    "svelte": {"file": "stacks/svelte.csv"},
+    "swiftui": {"file": "stacks/swiftui.csv"},
+    "react-native": {"file": "stacks/react-native.csv"},
+    "flutter": {"file": "stacks/flutter.csv"},
+    "shadcn": {"file": "stacks/shadcn.csv"}
+}
+
+# Common columns for all stacks
+_STACK_COLS = {
+    "search_cols": ["Category", "Guideline", "Description", "Do", "Don't"],
+    "output_cols": ["Category", "Guideline", "Description", "Do", "Don't", "Code Good", "Code Bad", "Severity", "Docs URL"]
+}
+
+AVAILABLE_STACKS = list(STACK_CONFIG.keys())
+
+
+# ============ BM25 IMPLEMENTATION ============
+class BM25:
+    """BM25 ranking algorithm for text search"""
+
+    def __init__(self, k1=1.5, b=0.75):
+        self.k1 = k1
+        self.b = b
+        self.corpus = []
+        self.doc_lengths = []
+        self.avgdl = 0
+        self.idf = {}
+        self.doc_freqs = defaultdict(int)
+        self.N = 0
+
+    def tokenize(self, text):
+        """Lowercase, split, remove punctuation, filter short words"""
+        text = re.sub(r'[^\w\s]', ' ', str(text).lower())
+        return [w for w in text.split() if len(w) > 2]
+
+    def fit(self, documents):
+        """Build BM25 index from documents"""
+        self.corpus = [self.tokenize(doc) for doc in documents]
+        self.N = len(self.corpus)
+        if self.N == 0:
+            return
+        self.doc_lengths = [len(doc) for doc in self.corpus]
+        self.avgdl = sum(self.doc_lengths) / self.N
+
+        for doc in self.corpus:
+            seen = set()
+            for word in doc:
+                if word not in seen:
+                    self.doc_freqs[word] += 1
+                    seen.add(word)
+
+        for word, freq in self.doc_freqs.items():
+            self.idf[word] = log((self.N - freq + 0.5) / (freq + 0.5) + 1)
+
+    def score(self, query):
+        """Score all documents against query"""
+        query_tokens = self.tokenize(query)
+        scores = []
+
+        for idx, doc in enumerate(self.corpus):
+            score = 0
+            doc_len = self.doc_lengths[idx]
+            term_freqs = defaultdict(int)
+            for word in doc:
+                term_freqs[word] += 1
+
+            for token in query_tokens:
+                if token in self.idf:
+                    tf = term_freqs[token]
+                    idf = self.idf[token]
+                    numerator = tf * (self.k1 + 1)
+                    denominator = tf + self.k1 * (1 - self.b + self.b * doc_len / self.avgdl)
+                    score += idf * numerator / denominator
+
+            scores.append((idx, score))
+
+        return sorted(scores, key=lambda x: x[1], reverse=True)
+
+
+# ============ SEARCH FUNCTIONS ============
+def _load_csv(filepath):
+    """Load CSV and return list of dicts"""
+    with open(filepath, 'r', encoding='utf-8') as f:
+        return list(csv.DictReader(f))
+
+
+def _search_csv(filepath, search_cols, output_cols, query, max_results):
+    """Core search function using BM25"""
+    if not filepath.exists():
+        return []
+
+    data = _load_csv(filepath)
+
+    # Build documents from search columns
+    documents = [" ".join(str(row.get(col, "")) for col in search_cols) for row in data]
+
+    # BM25 search
+    bm25 = BM25()
+    bm25.fit(documents)
+    ranked = bm25.score(query)
+
+    # Get top results with score > 0
+    results = []
+    for idx, score in ranked[:max_results]:
+        if score > 0:
+            row = data[idx]
+            results.append({col: row.get(col, "") for col in output_cols if col in row})
+
+    return results
+
+
+def detect_domain(query):
+    """Auto-detect the most relevant domain from query"""
+    query_lower = query.lower()
+
+    domain_keywords = {
+        "color": ["color", "palette", "hex", "#", "rgb"],
+        "chart": ["chart", "graph", "visualization", "trend", "bar", "pie", "scatter", "heatmap", "funnel"],
+        "landing": ["landing", "page", "cta", "conversion", "hero", "testimonial", "pricing", "section"],
+        "product": ["saas", "ecommerce", "e-commerce", "fintech", "healthcare", "gaming", "portfolio", "crypto", "dashboard"],
+        "prompt": ["prompt", "css", "implementation", "variable", "checklist", "tailwind"],
+        "style": ["style", "design", "ui", "minimalism", "glassmorphism", "neumorphism", "brutalism", "dark mode", "flat", "aurora"],
+        "ux": ["ux", "usability", "accessibility", "wcag", "touch", "scroll", "animation", "keyboard", "navigation", "mobile"],
+        "typography": ["font", "typography", "heading", "serif", "sans"],
+        "icons": ["icon", "icons", "lucide", "heroicons", "symbol", "glyph", "pictogram", "svg icon"],
+        "react": ["react", "next.js", "nextjs", "suspense", "memo", "usecallback", "useeffect", "rerender", "bundle", "waterfall", "barrel", "dynamic import", "rsc", "server component"],
+        "web": ["aria", "focus", "outline", "semantic", "virtualize", "autocomplete", "form", "input type", "preconnect"]
+    }
+
+    scores = {domain: sum(1 for kw in keywords if kw in query_lower) for domain, keywords in domain_keywords.items()}
+    best = max(scores, key=scores.get)
+    return best if scores[best] > 0 else "style"
+
+
+def search(query, domain=None, max_results=MAX_RESULTS):
+    """Main search function with auto-domain detection"""
+    if domain is None:
+        domain = detect_domain(query)
+
+    config = CSV_CONFIG.get(domain, CSV_CONFIG["style"])
+    filepath = DATA_DIR / config["file"]
+
+    if not filepath.exists():
+        return {"error": f"File not found: {filepath}", "domain": domain}
+
+    results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results)
+
+    return {
+        "domain": domain,
+        "query": query,
+        "file": config["file"],
+        "count": len(results),
+        "results": results
+    }
+
+
+def search_stack(query, stack, max_results=MAX_RESULTS):
+    """Search stack-specific guidelines"""
+    if stack not in STACK_CONFIG:
+        return {"error": f"Unknown stack: {stack}. Available: {', '.join(AVAILABLE_STACKS)}"}
+
+    filepath = DATA_DIR / STACK_CONFIG[stack]["file"]
+
+    if not filepath.exists():
+        return {"error": f"Stack file not found: {filepath}", "stack": stack}
+
+    results = _search_csv(filepath, _STACK_COLS["search_cols"], _STACK_COLS["output_cols"], query, max_results)
+
+    return {
+        "domain": "stack",
+        "stack": stack,
+        "query": query,
+        "file": STACK_CONFIG[stack]["file"],
+        "count": len(results),
+        "results": results
+    }
diff --git a/.agents/skills/ui-ux-pro-max/scripts/design_system.py b/.agents/skills/ui-ux-pro-max/scripts/design_system.py
new file mode 100644
index 0000000..4e19b52
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/scripts/design_system.py
@@ -0,0 +1,487 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Design System Generator - Aggregates search results and applies reasoning
+to generate comprehensive design system recommendations.
+
+Usage:
+    from design_system import generate_design_system
+    result = generate_design_system("SaaS dashboard", "My Project")
+"""
+
+import csv
+import json
+from pathlib import Path
+from core import search, DATA_DIR
+
+
+# ============ CONFIGURATION ============
+REASONING_FILE = "ui-reasoning.csv"
+
+SEARCH_CONFIG = {
+    "product": {"max_results": 1},
+    "style": {"max_results": 3},
+    "color": {"max_results": 2},
+    "landing": {"max_results": 2},
+    "typography": {"max_results": 2}
+}
+
+
+# ============ DESIGN SYSTEM GENERATOR ============
+class DesignSystemGenerator:
+    """Generates design system recommendations from aggregated searches."""
+
+    def __init__(self):
+        self.reasoning_data = self._load_reasoning()
+
+    def _load_reasoning(self) -> list:
+        """Load reasoning rules from CSV."""
+        filepath = DATA_DIR / REASONING_FILE
+        if not filepath.exists():
+            return []
+        with open(filepath, 'r', encoding='utf-8') as f:
+            return list(csv.DictReader(f))
+
+    def _multi_domain_search(self, query: str, style_priority: list = None) -> dict:
+        """Execute searches across multiple domains."""
+        results = {}
+        for domain, config in SEARCH_CONFIG.items():
+            if domain == "style" and style_priority:
+                # For style, also search with priority keywords
+                priority_query = " ".join(style_priority[:2]) if style_priority else query
+                combined_query = f"{query} {priority_query}"
+                results[domain] = search(combined_query, domain, config["max_results"])
+            else:
+                results[domain] = search(query, domain, config["max_results"])
+        return results
+
+    def _find_reasoning_rule(self, category: str) -> dict:
+        """Find matching reasoning rule for a category."""
+        category_lower = category.lower()
+
+        # Try exact match first
+        for rule in self.reasoning_data:
+            if rule.get("UI_Category", "").lower() == category_lower:
+                return rule
+
+        # Try partial match
+        for rule in self.reasoning_data:
+            ui_cat = rule.get("UI_Category", "").lower()
+            if ui_cat in category_lower or category_lower in ui_cat:
+                return rule
+
+        # Try keyword match
+        for rule in self.reasoning_data:
+            ui_cat = rule.get("UI_Category", "").lower()
+            keywords = ui_cat.replace("/", " ").replace("-", " ").split()
+            if any(kw in category_lower for kw in keywords):
+                return rule
+
+        return {}
+
+    def _apply_reasoning(self, category: str, search_results: dict) -> dict:
+        """Apply reasoning rules to search results."""
+        rule = self._find_reasoning_rule(category)
+
+        if not rule:
+            return {
+                "pattern": "Hero + Features + CTA",
+                "style_priority": ["Minimalism", "Flat Design"],
+                "color_mood": "Professional",
+                "typography_mood": "Clean",
+                "key_effects": "Subtle hover transitions",
+                "anti_patterns": "",
+                "decision_rules": {},
+                "severity": "MEDIUM"
+            }
+
+        # Parse decision rules JSON
+        decision_rules = {}
+        try:
+            decision_rules = json.loads(rule.get("Decision_Rules", "{}"))
+        except json.JSONDecodeError:
+            pass
+
+        return {
+            "pattern": rule.get("Recommended_Pattern", ""),
+            "style_priority": [s.strip() for s in rule.get("Style_Priority", "").split("+")],
+            "color_mood": rule.get("Color_Mood", ""),
+            "typography_mood": rule.get("Typography_Mood", ""),
+            "key_effects": rule.get("Key_Effects", ""),
+            "anti_patterns": rule.get("Anti_Patterns", ""),
+            "decision_rules": decision_rules,
+            "severity": rule.get("Severity", "MEDIUM")
+        }
+
+    def _select_best_match(self, results: list, priority_keywords: list) -> dict:
+        """Select best matching result based on priority keywords."""
+        if not results:
+            return {}
+
+        if not priority_keywords:
+            return results[0]
+
+        # First: try exact style name match
+        for priority in priority_keywords:
+            priority_lower = priority.lower().strip()
+            for result in results:
+                style_name = result.get("Style Category", "").lower()
+                if priority_lower in style_name or style_name in priority_lower:
+                    return result
+
+        # Second: score by keyword match in all fields
+        scored = []
+        for result in results:
+            result_str = str(result).lower()
+            score = 0
+            for kw in priority_keywords:
+                kw_lower = kw.lower().strip()
+                # Higher score for style name match
+                if kw_lower in result.get("Style Category", "").lower():
+                    score += 10
+                # Lower score for keyword field match
+                elif kw_lower in result.get("Keywords", "").lower():
+                    score += 3
+                # Even lower for other field matches
+                elif kw_lower in result_str:
+                    score += 1
+            scored.append((score, result))
+
+        scored.sort(key=lambda x: x[0], reverse=True)
+        return scored[0][1] if scored and scored[0][0] > 0 else results[0]
+
+    def _extract_results(self, search_result: dict) -> list:
+        """Extract results list from search result dict."""
+        return search_result.get("results", [])
+
+    def generate(self, query: str, project_name: str = None) -> dict:
+        """Generate complete design system recommendation."""
+        # Step 1: First search product to get category
+        product_result = search(query, "product", 1)
+        product_results = product_result.get("results", [])
+        category = "General"
+        if product_results:
+            category = product_results[0].get("Product Type", "General")
+
+        # Step 2: Get reasoning rules for this category
+        reasoning = self._apply_reasoning(category, {})
+        style_priority = reasoning.get("style_priority", [])
+
+        # Step 3: Multi-domain search with style priority hints
+        search_results = self._multi_domain_search(query, style_priority)
+        search_results["product"] = product_result  # Reuse product search
+
+        # Step 4: Select best matches from each domain using priority
+        style_results = self._extract_results(search_results.get("style", {}))
+        color_results = self._extract_results(search_results.get("color", {}))
+        typography_results = self._extract_results(search_results.get("typography", {}))
+        landing_results = self._extract_results(search_results.get("landing", {}))
+
+        best_style = self._select_best_match(style_results, reasoning.get("style_priority", []))
+        best_color = color_results[0] if color_results else {}
+        best_typography = typography_results[0] if typography_results else {}
+        best_landing = landing_results[0] if landing_results else {}
+
+        # Step 5: Build final recommendation
+        # Combine effects from both reasoning and style search
+        style_effects = best_style.get("Effects & Animation", "")
+        reasoning_effects = reasoning.get("key_effects", "")
+        combined_effects = style_effects if style_effects else reasoning_effects
+
+        return {
+            "project_name": project_name or query.upper(),
+            "category": category,
+            "pattern": {
+                "name": best_landing.get("Pattern Name", reasoning.get("pattern", "Hero + Features + CTA")),
+                "sections": best_landing.get("Section Order", "Hero > Features > CTA"),
+                "cta_placement": best_landing.get("Primary CTA Placement", "Above fold"),
+                "color_strategy": best_landing.get("Color Strategy", ""),
+                "conversion": best_landing.get("Conversion Optimization", "")
+            },
+            "style": {
+                "name": best_style.get("Style Category", "Minimalism"),
+                "type": best_style.get("Type", "General"),
+                "effects": style_effects,
+                "keywords": best_style.get("Keywords", ""),
+                "best_for": best_style.get("Best For", ""),
+                "performance": best_style.get("Performance", ""),
+                "accessibility": best_style.get("Accessibility", "")
+            },
+            "colors": {
+                "primary": best_color.get("Primary (Hex)", "#2563EB"),
+                "secondary": best_color.get("Secondary (Hex)", "#3B82F6"),
+                "cta": best_color.get("CTA (Hex)", "#F97316"),
+                "background": best_color.get("Background (Hex)", "#F8FAFC"),
+                "text": best_color.get("Text (Hex)", "#1E293B"),
+                "notes": best_color.get("Notes", "")
+            },
+            "typography": {
+                "heading": best_typography.get("Heading Font", "Inter"),
+                "body": best_typography.get("Body Font", "Inter"),
+                "mood": best_typography.get("Mood/Style Keywords", reasoning.get("typography_mood", "")),
+                "best_for": best_typography.get("Best For", ""),
+                "google_fonts_url": best_typography.get("Google Fonts URL", ""),
+                "css_import": best_typography.get("CSS Import", "")
+            },
+            "key_effects": combined_effects,
+            "anti_patterns": reasoning.get("anti_patterns", ""),
+            "decision_rules": reasoning.get("decision_rules", {}),
+            "severity": reasoning.get("severity", "MEDIUM")
+        }
+
+
+# ============ OUTPUT FORMATTERS ============
+BOX_WIDTH = 90  # Wider box for more content
+
+def format_ascii_box(design_system: dict) -> str:
+    """Format design system as ASCII box with emojis (MCP-style)."""
+    project = design_system.get("project_name", "PROJECT")
+    pattern = design_system.get("pattern", {})
+    style = design_system.get("style", {})
+    colors = design_system.get("colors", {})
+    typography = design_system.get("typography", {})
+    effects = design_system.get("key_effects", "")
+    anti_patterns = design_system.get("anti_patterns", "")
+
+    def wrap_text(text: str, prefix: str, width: int) -> list:
+        """Wrap long text into multiple lines."""
+        if not text:
+            return []
+        words = text.split()
+        lines = []
+        current_line = prefix
+        for word in words:
+            if len(current_line) + len(word) + 1 <= width - 2:
+                current_line += (" " if current_line != prefix else "") + word
+            else:
+                if current_line != prefix:
+                    lines.append(current_line)
+                current_line = prefix + word
+        if current_line != prefix:
+            lines.append(current_line)
+        return lines
+
+    # Build sections from pattern
+    sections = pattern.get("sections", "").split(">")
+    sections = [s.strip() for s in sections if s.strip()]
+
+    # Build output lines
+    lines = []
+    w = BOX_WIDTH - 1
+
+    lines.append("+" + "-" * w + "+")
+    lines.append(f"|  TARGET: {project} - RECOMMENDED DESIGN SYSTEM".ljust(BOX_WIDTH) + "|")
+    lines.append("+" + "-" * w + "+")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Pattern section
+    lines.append(f"|  PATTERN: {pattern.get('name', '')}".ljust(BOX_WIDTH) + "|")
+    if pattern.get('conversion'):
+        lines.append(f"|     Conversion: {pattern.get('conversion', '')}".ljust(BOX_WIDTH) + "|")
+    if pattern.get('cta_placement'):
+        lines.append(f"|     CTA: {pattern.get('cta_placement', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append("|     Sections:".ljust(BOX_WIDTH) + "|")
+    for i, section in enumerate(sections, 1):
+        lines.append(f"|       {i}. {section}".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Style section
+    lines.append(f"|  STYLE: {style.get('name', '')}".ljust(BOX_WIDTH) + "|")
+    if style.get("keywords"):
+        for line in wrap_text(f"Keywords: {style.get('keywords', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if style.get("best_for"):
+        for line in wrap_text(f"Best For: {style.get('best_for', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if style.get("performance") or style.get("accessibility"):
+        perf_a11y = f"Performance: {style.get('performance', '')} | Accessibility: {style.get('accessibility', '')}"
+        lines.append(f"|     {perf_a11y}".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Colors section
+    lines.append("|  COLORS:".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Primary:    {colors.get('primary', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Secondary:  {colors.get('secondary', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     CTA:        {colors.get('cta', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Background: {colors.get('background', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Text:       {colors.get('text', '')}".ljust(BOX_WIDTH) + "|")
+    if colors.get("notes"):
+        for line in wrap_text(f"Notes: {colors.get('notes', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Typography section
+    lines.append(f"|  TYPOGRAPHY: {typography.get('heading', '')} / {typography.get('body', '')}".ljust(BOX_WIDTH) + "|")
+    if typography.get("mood"):
+        for line in wrap_text(f"Mood: {typography.get('mood', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if typography.get("best_for"):
+        for line in wrap_text(f"Best For: {typography.get('best_for', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if typography.get("google_fonts_url"):
+        lines.append(f"|     Google Fonts: {typography.get('google_fonts_url', '')}".ljust(BOX_WIDTH) + "|")
+    if typography.get("css_import"):
+        lines.append(f"|     CSS Import: {typography.get('css_import', '')[:70]}...".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Key Effects section
+    if effects:
+        lines.append("|  KEY EFFECTS:".ljust(BOX_WIDTH) + "|")
+        for line in wrap_text(effects, "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+        lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Anti-patterns section
+    if anti_patterns:
+        lines.append("|  AVOID (Anti-patterns):".ljust(BOX_WIDTH) + "|")
+        for line in wrap_text(anti_patterns, "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+        lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Pre-Delivery Checklist section
+    lines.append("|  PRE-DELIVERY CHECKLIST:".ljust(BOX_WIDTH) + "|")
+    checklist_items = [
+        "[ ] No emojis as icons (use SVG: Heroicons/Lucide)",
+        "[ ] cursor-pointer on all clickable elements",
+        "[ ] Hover states with smooth transitions (150-300ms)",
+        "[ ] Light mode: text contrast 4.5:1 minimum",
+        "[ ] Focus states visible for keyboard nav",
+        "[ ] prefers-reduced-motion respected",
+        "[ ] Responsive: 375px, 768px, 1024px, 1440px"
+    ]
+    for item in checklist_items:
+        lines.append(f"|     {item}".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    lines.append("+" + "-" * w + "+")
+
+    return "\n".join(lines)
+
+
+def format_markdown(design_system: dict) -> str:
+    """Format design system as markdown."""
+    project = design_system.get("project_name", "PROJECT")
+    pattern = design_system.get("pattern", {})
+    style = design_system.get("style", {})
+    colors = design_system.get("colors", {})
+    typography = design_system.get("typography", {})
+    effects = design_system.get("key_effects", "")
+    anti_patterns = design_system.get("anti_patterns", "")
+
+    lines = []
+    lines.append(f"## Design System: {project}")
+    lines.append("")
+
+    # Pattern section
+    lines.append("### Pattern")
+    lines.append(f"- **Name:** {pattern.get('name', '')}")
+    if pattern.get('conversion'):
+        lines.append(f"- **Conversion Focus:** {pattern.get('conversion', '')}")
+    if pattern.get('cta_placement'):
+        lines.append(f"- **CTA Placement:** {pattern.get('cta_placement', '')}")
+    if pattern.get('color_strategy'):
+        lines.append(f"- **Color Strategy:** {pattern.get('color_strategy', '')}")
+    lines.append(f"- **Sections:** {pattern.get('sections', '')}")
+    lines.append("")
+
+    # Style section
+    lines.append("### Style")
+    lines.append(f"- **Name:** {style.get('name', '')}")
+    if style.get('keywords'):
+        lines.append(f"- **Keywords:** {style.get('keywords', '')}")
+    if style.get('best_for'):
+        lines.append(f"- **Best For:** {style.get('best_for', '')}")
+    if style.get('performance') or style.get('accessibility'):
+        lines.append(f"- **Performance:** {style.get('performance', '')} | **Accessibility:** {style.get('accessibility', '')}")
+    lines.append("")
+
+    # Colors section
+    lines.append("### Colors")
+    lines.append(f"| Role | Hex |")
+    lines.append(f"|------|-----|")
+    lines.append(f"| Primary | {colors.get('primary', '')} |")
+    lines.append(f"| Secondary | {colors.get('secondary', '')} |")
+    lines.append(f"| CTA | {colors.get('cta', '')} |")
+    lines.append(f"| Background | {colors.get('background', '')} |")
+    lines.append(f"| Text | {colors.get('text', '')} |")
+    if colors.get("notes"):
+        lines.append(f"\n*Notes: {colors.get('notes', '')}*")
+    lines.append("")
+
+    # Typography section
+    lines.append("### Typography")
+    lines.append(f"- **Heading:** {typography.get('heading', '')}")
+    lines.append(f"- **Body:** {typography.get('body', '')}")
+    if typography.get("mood"):
+        lines.append(f"- **Mood:** {typography.get('mood', '')}")
+    if typography.get("best_for"):
+        lines.append(f"- **Best For:** {typography.get('best_for', '')}")
+    if typography.get("google_fonts_url"):
+        lines.append(f"- **Google Fonts:** {typography.get('google_fonts_url', '')}")
+    if typography.get("css_import"):
+        lines.append(f"- **CSS Import:**")
+        lines.append(f"```css")
+        lines.append(f"{typography.get('css_import', '')}")
+        lines.append(f"```")
+    lines.append("")
+
+    # Key Effects section
+    if effects:
+        lines.append("### Key Effects")
+        lines.append(f"{effects}")
+        lines.append("")
+
+    # Anti-patterns section
+    if anti_patterns:
+        lines.append("### Avoid (Anti-patterns)")
+        lines.append(f"- {anti_patterns.replace(' + ', '\n- ')}")
+        lines.append("")
+
+    # Pre-Delivery Checklist section
+    lines.append("### Pre-Delivery Checklist")
+    lines.append("- [ ] No emojis as icons (use SVG: Heroicons/Lucide)")
+    lines.append("- [ ] cursor-pointer on all clickable elements")
+    lines.append("- [ ] Hover states with smooth transitions (150-300ms)")
+    lines.append("- [ ] Light mode: text contrast 4.5:1 minimum")
+    lines.append("- [ ] Focus states visible for keyboard nav")
+    lines.append("- [ ] prefers-reduced-motion respected")
+    lines.append("- [ ] Responsive: 375px, 768px, 1024px, 1440px")
+    lines.append("")
+
+    return "\n".join(lines)
+
+
+# ============ MAIN ENTRY POINT ============
+def generate_design_system(query: str, project_name: str = None, output_format: str = "ascii") -> str:
+    """
+    Main entry point for design system generation.
+
+    Args:
+        query: Search query (e.g., "SaaS dashboard", "e-commerce luxury")
+        project_name: Optional project name for output header
+        output_format: "ascii" (default) or "markdown"
+
+    Returns:
+        Formatted design system string
+    """
+    generator = DesignSystemGenerator()
+    design_system = generator.generate(query, project_name)
+
+    if output_format == "markdown":
+        return format_markdown(design_system)
+    return format_ascii_box(design_system)
+
+
+# ============ CLI SUPPORT ============
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Generate Design System")
+    parser.add_argument("query", help="Search query (e.g., 'SaaS dashboard')")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format")
+
+    args = parser.parse_args()
+
+    result = generate_design_system(args.query, args.project_name, args.format)
+    print(result)
diff --git a/.agents/skills/ui-ux-pro-max/scripts/search.py b/.agents/skills/ui-ux-pro-max/scripts/search.py
new file mode 100644
index 0000000..00a38df
--- /dev/null
+++ b/.agents/skills/ui-ux-pro-max/scripts/search.py
@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+"""
+
+import argparse
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(args.query, args.project_name, args.format)
+        print(result)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
diff --git a/.agents/skills/ui-visual-validator/SKILL.md b/.agents/skills/ui-visual-validator/SKILL.md
new file mode 100644
index 0000000..0306b19
--- /dev/null
+++ b/.agents/skills/ui-visual-validator/SKILL.md
@@ -0,0 +1,214 @@
+---
+name: ui-visual-validator
+description: Rigorous visual validation expert specializing in UI testing,
+  design system compliance, and accessibility verification. Masters screenshot
+  analysis, visual regression testing, and component validation. Use PROACTIVELY
+  to verify UI modifications have achieved their intended goals through
+  comprehensive visual analysis.
+metadata:
+  model: sonnet
+---
+
+## Use this skill when
+
+- Working on ui visual validator tasks or workflows
+- Needing guidance, best practices, or checklists for ui visual validator
+
+## Do not use this skill when
+
+- The task is unrelated to ui visual validator
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are an experienced UI visual validation expert specializing in comprehensive visual testing and design verification through rigorous analysis methodologies.
+
+## Purpose
+
+Expert visual validation specialist focused on verifying UI modifications, design system compliance, and accessibility implementation through systematic visual analysis. Masters modern visual testing tools, automated regression testing, and human-centered design verification.
+
+## Core Principles
+
+- Default assumption: The modification goal has NOT been achieved until proven otherwise
+- Be highly critical and look for flaws, inconsistencies, or incomplete implementations
+- Ignore any code hints or implementation details - base judgments solely on visual evidence
+- Only accept clear, unambiguous visual proof that goals have been met
+- Apply accessibility standards and inclusive design principles to all evaluations
+
+## Capabilities
+
+### Visual Analysis Mastery
+
+- Screenshot analysis with pixel-perfect precision
+- Visual diff detection and change identification
+- Cross-browser and cross-device visual consistency verification
+- Responsive design validation across multiple breakpoints
+- Dark mode and theme consistency analysis
+- Animation and interaction state validation
+- Loading state and error state verification
+- Accessibility visual compliance assessment
+
+### Modern Visual Testing Tools
+
+- **Chromatic**: Visual regression testing for Storybook components
+- **Percy**: Cross-browser visual testing and screenshot comparison
+- **Applitools**: AI-powered visual testing and validation
+- **BackstopJS**: Automated visual regression testing framework
+- **Playwright Visual Comparisons**: Cross-browser visual testing
+- **Cypress Visual Testing**: End-to-end visual validation
+- **Jest Image Snapshot**: Component-level visual regression testing
+- **Storybook Visual Testing**: Isolated component validation
+
+### Design System Validation
+
+- Component library compliance verification
+- Design token implementation accuracy
+- Brand consistency and style guide adherence
+- Typography system implementation validation
+- Color palette and contrast ratio verification
+- Spacing and layout system compliance
+- Icon usage and visual consistency checking
+- Multi-brand design system validation
+
+### Accessibility Visual Verification
+
+- WCAG 2.1/2.2 visual compliance assessment
+- Color contrast ratio validation and measurement
+- Focus indicator visibility and design verification
+- Text scaling and readability assessment
+- Visual hierarchy and information architecture validation
+- Alternative text and semantic structure verification
+- Keyboard navigation visual feedback assessment
+- Screen reader compatible design verification
+
+### Cross-Platform Visual Consistency
+
+- Responsive design breakpoint validation
+- Mobile-first design implementation verification
+- Native app vs web consistency checking
+- Progressive Web App (PWA) visual compliance
+- Email client compatibility visual testing
+- Print stylesheet and layout verification
+- Device-specific adaptation validation
+- Platform-specific design guideline compliance
+
+### Automated Visual Testing Integration
+
+- CI/CD pipeline visual testing integration
+- GitHub Actions automated screenshot comparison
+- Visual regression testing in pull request workflows
+- Automated accessibility scanning and reporting
+- Performance impact visual analysis
+- Component library visual documentation generation
+- Multi-environment visual consistency testing
+- Automated design token compliance checking
+
+### Manual Visual Inspection Techniques
+
+- Systematic visual audit methodologies
+- Edge case and boundary condition identification
+- User flow visual consistency verification
+- Error handling and edge state validation
+- Loading and transition state analysis
+- Interactive element visual feedback assessment
+- Form validation and user feedback verification
+- Progressive disclosure and information architecture validation
+
+### Visual Quality Assurance
+
+- Pixel-perfect implementation verification
+- Image optimization and visual quality assessment
+- Typography rendering and font loading validation
+- Animation smoothness and performance verification
+- Visual hierarchy and readability assessment
+- Brand guideline compliance checking
+- Design specification accuracy verification
+- Cross-team design implementation consistency
+
+## Analysis Process
+
+1. **Objective Description First**: Describe exactly what is observed in the visual evidence without making assumptions
+2. **Goal Verification**: Compare each visual element against the stated modification goals systematically
+3. **Measurement Validation**: For changes involving rotation, position, size, or alignment, verify through visual measurement
+4. **Reverse Validation**: Actively look for evidence that the modification failed rather than succeeded
+5. **Critical Assessment**: Challenge whether apparent differences are actually the intended differences
+6. **Accessibility Evaluation**: Assess visual accessibility compliance and inclusive design implementation
+7. **Cross-Platform Consistency**: Verify visual consistency across different platforms and devices
+8. **Edge Case Analysis**: Examine edge cases, error states, and boundary conditions
+
+## Mandatory Verification Checklist
+
+- [ ] Have I described the actual visual content objectively?
+- [ ] Have I avoided inferring effects from code changes?
+- [ ] For rotations: Have I confirmed aspect ratio changes?
+- [ ] For positioning: Have I verified coordinate differences?
+- [ ] For sizing: Have I confirmed dimensional changes?
+- [ ] Have I validated color contrast ratios meet WCAG standards?
+- [ ] Have I checked focus indicators and keyboard navigation visuals?
+- [ ] Have I verified responsive breakpoint behavior?
+- [ ] Have I assessed loading states and transitions?
+- [ ] Have I validated error handling and edge cases?
+- [ ] Have I confirmed design system token compliance?
+- [ ] Have I actively searched for failure evidence?
+- [ ] Have I questioned whether 'different' equals 'correct'?
+
+## Advanced Validation Techniques
+
+- **Pixel Diff Analysis**: Precise change detection through pixel-level comparison
+- **Layout Shift Detection**: Cumulative Layout Shift (CLS) visual assessment
+- **Animation Frame Analysis**: Frame-by-frame animation validation
+- **Cross-Browser Matrix Testing**: Systematic multi-browser visual verification
+- **Accessibility Overlay Testing**: Visual validation with accessibility overlays
+- **High Contrast Mode Testing**: Visual validation in high contrast environments
+- **Reduced Motion Testing**: Animation and motion accessibility validation
+- **Print Preview Validation**: Print stylesheet and layout verification
+
+## Output Requirements
+
+- Start with 'From the visual evidence, I observe...'
+- Provide detailed visual measurements when relevant
+- Clearly state whether goals are achieved, partially achieved, or not achieved
+- If uncertain, explicitly state uncertainty and request clarification
+- Never declare success without concrete visual evidence
+- Include accessibility assessment in all evaluations
+- Provide specific remediation recommendations for identified issues
+- Document edge cases and boundary conditions observed
+
+## Behavioral Traits
+
+- Maintains skeptical approach until visual proof is provided
+- Applies systematic methodology to all visual assessments
+- Considers accessibility and inclusive design in every evaluation
+- Documents findings with precise, measurable observations
+- Challenges assumptions and validates against stated objectives
+- Provides constructive feedback for design and development improvement
+- Stays current with visual testing tools and methodologies
+- Advocates for comprehensive visual quality assurance practices
+
+## Forbidden Behaviors
+
+- Assuming code changes automatically produce visual results
+- Quick conclusions without thorough systematic analysis
+- Accepting 'looks different' as 'looks correct'
+- Using expectation to replace direct observation
+- Ignoring accessibility implications in visual assessment
+- Overlooking edge cases or error states
+- Making assumptions about user behavior from visual evidence alone
+
+## Example Interactions
+
+- "Validate that the new button component meets accessibility contrast requirements"
+- "Verify that the responsive navigation collapses correctly at mobile breakpoints"
+- "Confirm that the loading spinner animation displays smoothly across browsers"
+- "Assess whether the error message styling follows the design system guidelines"
+- "Validate that the modal overlay properly blocks interaction with background elements"
+- "Verify that the dark theme implementation maintains visual hierarchy"
+- "Confirm that form validation states provide clear visual feedback"
+- "Assess whether the data table maintains readability across different screen sizes"
+
+Your role is to be the final gatekeeper ensuring UI modifications actually work as intended through uncompromising visual verification with accessibility and inclusive design considerations at the forefront.
diff --git a/.agents/skills/vue-best-practices/SKILL.md b/.agents/skills/vue-best-practices/SKILL.md
new file mode 100644
index 0000000..94516e4
--- /dev/null
+++ b/.agents/skills/vue-best-practices/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: vue-best-practices
+description: Vue 3 and Vue.js best practices for TypeScript, vue-tsc, and Volar. This skill should be used when writing, reviewing, or refactoring Vue components to ensure correct typing patterns. Triggers on tasks involving Vue components, props extraction, wrapper components, template type checking, or Volar configuration.
+license: MIT
+metadata:
+  author: hyf0
+  version: "8.0.0"
+---
+
+## Capability Rules
+
+| Rule | Keywords | Description |
+|------|----------|-------------|
+| [extract-component-props](rules/extract-component-props.md) | get props type, wrapper component, extend props, inherit props, ComponentProps | Extract types from .vue components |
+| [vue-tsc-strict-templates](rules/vue-tsc-strict-templates.md) | undefined component, template error, strictTemplates | Catch undefined components in templates |
+| [fallthrough-attributes](rules/fallthrough-attributes.md) | fallthrough, $attrs, wrapper component | Type-check fallthrough attributes |
+| [strict-css-modules](rules/strict-css-modules.md) | css modules, $style, typo | Catch CSS module class typos |
+| [data-attributes-config](rules/data-attributes-config.md) | data-*, strictTemplates, attribute | Allow data-* attributes |
+| [volar-3-breaking-changes](rules/volar-3-breaking-changes.md) | volar, vue-language-server, editor | Fix Volar 3.0 upgrade issues |
+| [module-resolution-bundler](rules/module-resolution-bundler.md) | cannot find module, @vue/tsconfig, moduleResolution | Fix module resolution errors |
+| [define-model-update-event](rules/define-model-update-event.md) | defineModel, update event, undefined | Fix model update errors |
+| [with-defaults-union-types](rules/with-defaults-union-types.md) | withDefaults, union type, default | Fix union type defaults |
+| [deep-watch-numeric](rules/deep-watch-numeric.md) | watch, deep, array, Vue 3.5 | Efficient array watching |
+| [vue-directive-comments](rules/vue-directive-comments.md) | @vue-ignore, @vue-skip, template | Control template type checking |
+| [vue-router-typed-params](rules/vue-router-typed-params.md) | route params, typed router, unplugin | Fix route params typing |
+
+## Efficiency Rules
+
+| Rule | Keywords | Description |
+|------|----------|-------------|
+| [hmr-vue-ssr](rules/hmr-vue-ssr.md) | hmr, ssr, hot reload | Fix HMR in SSR apps |
+| [pinia-store-mocking](rules/pinia-store-mocking.md) | pinia, mock, vitest, store | Mock Pinia stores |
+
+## Reference
+
+- [Vue Language Tools](https://github.com/vuejs/language-tools)
+- [vue-component-type-helpers](https://github.com/vuejs/language-tools/tree/master/packages/component-type-helpers)
+- [Vue 3 Documentation](https://vuejs.org/)
diff --git a/.agents/skills/vue-best-practices/rules/codeactions-save-performance.md b/.agents/skills/vue-best-practices/rules/codeactions-save-performance.md
new file mode 100644
index 0000000..03ea819
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/codeactions-save-performance.md
@@ -0,0 +1,79 @@
+---
+title: Fix Slow Save Times with Code Actions Setting
+impact: HIGH
+impactDescription: fixes 30-60 second save delays in large Vue projects
+type: capability
+tags: performance, save-time, vscode, code-actions, volar
+---
+
+# Fix Slow Save Times with Code Actions Setting
+
+**Impact: HIGH** - fixes 30-60 second save delays in large Vue projects
+
+In large Vue projects, saving files can take 30-60+ seconds due to VSCode's code actions triggering expensive TypeScript state synchronization.
+
+## Problem
+
+Symptoms:
+- Save operation takes 30+ seconds
+- Editor becomes unresponsive during save
+- CPU spikes when saving Vue files
+- Happens more in larger projects
+
+## Root Cause
+
+VSCode emits document change events multiple times during save cycles. Each event triggers Volar to synchronize with TypeScript, causing expensive re-computation.
+
+## Solution
+
+Disable code actions or limit their timeout:
+
+**Option 1: Disable code actions (fastest)**
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.enabled": false
+}
+```
+
+**Option 2: Limit code action time**
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.savingTimeLimit": 1000
+}
+```
+
+**Option 3: Disable specific code actions**
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.enabled": true,
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": "never"
+  }
+}
+```
+
+## VSCode Version Requirement
+
+VSCode 1.81.0+ includes fixes that reduce save time issues. Upgrade if using an older version.
+
+## Additional Optimizations
+
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.enabled": false,
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {},
+  "[vue]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "Vue.volar"
+  }
+}
+```
+
+## Reference
+
+- [Vue Language Tools Discussion #2740](https://github.com/vuejs/language-tools/discussions/2740)
diff --git a/.agents/skills/vue-best-practices/rules/data-attributes-config.md b/.agents/skills/vue-best-practices/rules/data-attributes-config.md
new file mode 100644
index 0000000..60c4630
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/data-attributes-config.md
@@ -0,0 +1,74 @@
+---
+title: Allow Data Attributes with Strict Templates
+impact: MEDIUM
+impactDescription: fixes data-testid and data-* attribute errors in strict mode
+type: capability
+tags: dataAttributes, vueCompilerOptions, strictTemplates, data-testid, testing
+---
+
+# Allow Data Attributes with Strict Templates
+
+**Impact: MEDIUM** - fixes data-testid and data-* attribute errors in strict mode
+
+With `strictTemplates` enabled, `data-*` attributes on components cause type errors. Use the `dataAttributes` option to allow specific patterns.
+
+## Problem
+
+```vue
+<template>
+  <!-- Error: Property 'data-testid' does not exist on type... -->
+  <MyComponent data-testid="submit-button" />
+
+  <!-- Error: Property 'data-cy' does not exist on type... -->
+  <MyComponent data-cy="login-form" />
+</template>
+```
+
+## Solution
+
+Configure `dataAttributes` to allow specific patterns:
+
+```json
+// tsconfig.json or tsconfig.app.json
+{
+  "vueCompilerOptions": {
+    "strictTemplates": true,
+    "dataAttributes": ["data-*"]
+  }
+}
+```
+
+Now all `data-*` attributes are allowed on any component.
+
+## Specific Patterns
+
+You can be more selective:
+
+```json
+{
+  "vueCompilerOptions": {
+    "dataAttributes": [
+      "data-testid",
+      "data-cy",
+      "data-test-*"
+    ]
+  }
+}
+```
+
+This only allows the specified patterns, not all data attributes.
+
+## Common Testing Attributes
+
+For testing libraries, allow their specific attributes:
+
+| Library | Attribute | Pattern |
+|---------|-----------|---------|
+| Testing Library | `data-testid` | `"data-testid"` |
+| Cypress | `data-cy` | `"data-cy"` |
+| Playwright | `data-testid` | `"data-testid"` |
+| Generic | All data attributes | `"data-*"` |
+
+## Reference
+
+- [Vue Language Tools Wiki - Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
diff --git a/.agents/skills/vue-best-practices/rules/deep-watch-numeric.md b/.agents/skills/vue-best-practices/rules/deep-watch-numeric.md
new file mode 100644
index 0000000..ee2d502
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/deep-watch-numeric.md
@@ -0,0 +1,97 @@
+---
+title: Vue 3.5+ Deep Watch Numeric Depth
+impact: MEDIUM
+impactDescription: enables efficient array mutation watching with numeric deep option
+type: capability
+tags: watch, deep, vue-3.5, array, mutation, performance
+---
+
+# Vue 3.5+ Deep Watch Numeric Depth
+
+**Impact: MEDIUM** - enables efficient array mutation watching with numeric deep option
+
+Vue 3.5 introduced `deep: number` for watch depth control. This allows watching array mutations without the performance cost of deep traversal.
+
+## Symptoms
+
+- Array mutations not triggering watch callback
+- Deep watch causing performance issues on large nested objects
+- Unaware of new Vue 3.5 feature
+
+> **Note:** TypeScript error "Type 'number' is not assignable to type 'boolean'" no longer occurs with Vue 3.5+ and current TypeScript versions. The types now correctly support numeric `deep` values.
+
+## The Feature
+
+```typescript
+// Vue 3.5+ only
+watch(items, (newVal) => {
+  // Triggered on array mutations (push, pop, splice, etc.)
+}, { deep: 1 })
+```
+
+| deep value | Behavior |
+|------------|----------|
+| `true` | Full recursive traversal (original behavior) |
+| `false` | Only reference changes |
+| `1` | One level deep - array mutations, not nested objects |
+| `2` | Two levels deep |
+| `n` | N levels deep |
+
+## Fix
+
+**Step 1: Ensure Vue 3.5+**
+```bash
+npm install vue@^3.5.0
+```
+
+**Step 2: Use numeric depth**
+```typescript
+import { watch, ref } from 'vue'
+
+const items = ref([{ id: 1, data: { nested: 'value' } }])
+
+// Watch array mutations only (push, pop, etc.)
+watch(items, (newItems) => {
+  console.log('Array mutated')
+}, { deep: 1 })
+
+// Won't trigger on: items.value[0].data.nested = 'new'
+// Will trigger on: items.value.push(newItem)
+```
+
+## Performance Comparison
+
+```typescript
+const largeNestedData = ref({ /* deeply nested structure */ })
+
+// SLOW - traverses entire structure
+watch(largeNestedData, handler, { deep: true })
+
+// FAST - only watches top-level changes
+watch(largeNestedData, handler, { deep: 1 })
+
+// FASTEST - only reference changes
+watch(largeNestedData, handler, { deep: false })
+```
+
+## Alternative: watchEffect for Selective Tracking
+
+```typescript
+// Only tracks properties actually accessed
+watchEffect(() => {
+  // Only re-runs when items.value.length or first item changes
+  console.log(items.value.length, items.value[0]?.id)
+})
+```
+
+## TypeScript Note
+
+If TypeScript complains about numeric deep, ensure:
+1. Vue version is 3.5+
+2. TypeScript version is current (types are included with `vue` package)
+3. tsconfig targets correct node_modules types
+
+## Reference
+
+- [Vue Watchers Docs](https://vuejs.org/guide/essentials/watchers.html)
+- [Vue 3.5 Release Notes](https://blog.vuejs.org/posts/vue-3-5)
diff --git a/.agents/skills/vue-best-practices/rules/define-model-update-event.md b/.agents/skills/vue-best-practices/rules/define-model-update-event.md
new file mode 100644
index 0000000..2f4d5af
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/define-model-update-event.md
@@ -0,0 +1,79 @@
+---
+title: defineModel Fires Update Event with Undefined
+impact: MEDIUM
+impactDescription: fixes runtime errors from unexpected undefined in model updates
+type: capability
+tags: defineModel, v-model, update-event, undefined, vue-3.5
+---
+
+# defineModel Fires Update Event with Undefined
+
+**Impact: MEDIUM** - fixes runtime errors from unexpected undefined in model updates
+
+> **Version Note:** This issue may be resolved in Vue 3.5+. Testing with Vue 3.5.26 could not reproduce the double emission with `undefined`. If you're on Vue 3.5+, verify the issue exists in your specific scenario before applying workarounds.
+
+Components using `defineModel` may fire the `@update:model-value` event with `undefined` in certain edge cases. TypeScript types don't always reflect this behavior, potentially causing runtime errors when the parent expects a non-nullable value.
+
+## Symptoms
+
+- Parent component receives `undefined` unexpectedly
+- Runtime error: "Cannot read property of undefined"
+- Type mismatch between expected `T` and received `T | undefined`
+- Issue appears when clearing/resetting the model value
+
+## Root Cause
+
+`defineModel` returns `Ref<T | undefined>` by default, even when `T` is non-nullable. The update event can fire with `undefined` when:
+- Component unmounts
+- Model is explicitly cleared
+- Internal state resets
+
+## Fix
+
+**Option 1: Use required option (Vue 3.5+)**
+```typescript
+// Returns Ref<Item> instead of Ref<Item | undefined>
+const model = defineModel<Item>({ required: true })
+```
+
+**Option 2: Type parent handler to accept undefined**
+```vue
+<template>
+  <MyComponent
+    v-model="item"
+    @update:model-value="handleUpdate"
+  />
+</template>
+
+<script setup lang="ts">
+// Handle both value and undefined
+const handleUpdate = (value: Item | undefined) => {
+  if (value !== undefined) {
+    item.value = value
+  }
+}
+</script>
+```
+
+**Option 3: Use default value in defineModel**
+```typescript
+const model = defineModel<string>({ default: '' })
+```
+
+## Type Declaration Pattern
+
+```typescript
+// In child component
+interface Props {
+  modelValue: Item
+}
+const model = defineModel<Item>({ required: true })
+
+// Emits will be typed as (value: Item) not (value: Item | undefined)
+```
+
+## Reference
+
+- [vuejs/core#12817](https://github.com/vuejs/core/issues/12817)
+- [vuejs/core#10103](https://github.com/vuejs/core/issues/10103)
+- [defineModel docs](https://vuejs.org/api/sfc-script-setup.html#definemodel)
diff --git a/.agents/skills/vue-best-practices/rules/duplicate-plugin-detection.md b/.agents/skills/vue-best-practices/rules/duplicate-plugin-detection.md
new file mode 100644
index 0000000..3fbbb99
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/duplicate-plugin-detection.md
@@ -0,0 +1,102 @@
+---
+title: Duplicate Vue Plugin Detection
+impact: MEDIUM
+impactDescription: fixes cryptic build errors from Vue plugin registered twice
+type: capability
+tags: vite, plugin, vue, duplicate, config, inline
+---
+
+# Duplicate Vue Plugin Detection
+
+**Impact: MEDIUM** - fixes cryptic build errors from Vue plugin registered twice
+
+When using Vite's JavaScript API, if the Vue plugin is loaded in `vite.config.js` and specified again in `inlineConfig`, it gets registered twice, causing cryptic build errors.
+
+## Symptoms
+
+- Build produces unexpected output or fails silently
+- "Cannot read property of undefined" during build
+- Different build behavior between CLI and JavaScript API
+- Vue components render incorrectly after build
+
+## Root Cause
+
+Vite doesn't deduplicate plugins by name when merging configs. The Vue plugin's internal state gets corrupted when registered twice.
+
+## Fix
+
+**Option 1: Use configFile: false with inline plugins**
+```typescript
+import { build } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+await build({
+  configFile: false,  // Don't load vite.config.js
+  plugins: [vue()],
+  // ... rest of config
+})
+```
+
+**Option 2: Don't specify plugins in inlineConfig**
+```typescript
+// vite.config.js already has vue plugin
+import { build } from 'vite'
+
+await build({
+  // Don't add vue plugin here - it's in vite.config.js
+  root: './src',
+  build: { outDir: '../dist' }
+})
+```
+
+**Option 3: Filter out Vue plugin before merging**
+```typescript
+import { build, loadConfigFromFile } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+const { config } = await loadConfigFromFile({ command: 'build', mode: 'production' })
+
+// Remove existing Vue plugin
+const filteredPlugins = config.plugins?.filter(
+  p => !p || (Array.isArray(p) ? false : p.name !== 'vite:vue')
+) || []
+
+await build({
+  ...config,
+  plugins: [...filteredPlugins, vue({ /* your options */ })]
+})
+```
+
+## Detection Script
+
+Add this to debug plugin registration:
+```typescript
+// vite.config.ts
+export default defineConfig({
+  plugins: [
+    vue(),
+    {
+      name: 'debug-plugins',
+      configResolved(config) {
+        const vuePlugins = config.plugins.filter(p => p.name?.includes('vue'))
+        if (vuePlugins.length > 1) {
+          console.warn('WARNING: Multiple Vue plugins detected:', vuePlugins.map(p => p.name))
+        }
+      }
+    }
+  ]
+})
+```
+
+## Common Scenarios
+
+| Scenario | Solution |
+|----------|----------|
+| Using `vite.createServer()` | Use `configFile: false` |
+| Build script with custom config | Don't duplicate plugins |
+| Monorepo with shared config | Check for plugin inheritance |
+
+## Reference
+
+- [Vite Issue #5335](https://github.com/vitejs/vite/issues/5335)
+- [Vite JavaScript API](https://vite.dev/guide/api-javascript.html)
diff --git a/.agents/skills/vue-best-practices/rules/extract-component-props.md b/.agents/skills/vue-best-practices/rules/extract-component-props.md
new file mode 100644
index 0000000..a94c70c
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/extract-component-props.md
@@ -0,0 +1,57 @@
+---
+title: Extract Component Props
+impact: HIGH
+impactDescription: extract props, emits, slots types from .vue components
+type: capability
+tags: typescript, props, emits, slots, vue-component-type-helpers, wrapper, ComponentProps
+---
+
+# Extract Component Props
+
+**Impact: HIGH** - extract props, emits, slots types from .vue components
+
+Use `vue-component-type-helpers` to extract types from `.vue` components:
+
+```bash
+npm install -D vue-component-type-helpers
+```
+
+```typescript
+import type { ComponentProps, ComponentEmit, ComponentSlots, ComponentExposed } from 'vue-component-type-helpers'
+import MyButton from './MyButton.vue'
+
+type Props = ComponentProps<typeof MyButton>
+type Emits = ComponentEmit<typeof MyButton>
+type Slots = ComponentSlots<typeof MyButton>
+type Exposed = ComponentExposed<typeof MyButton>
+```
+
+## Wrapper Component Pattern
+
+```typescript
+import type { ComponentProps } from 'vue-component-type-helpers'
+import BaseButton from './BaseButton.vue'
+
+type BaseProps = ComponentProps<typeof BaseButton>
+
+interface Props extends BaseProps {
+  size: 'sm' | 'md' | 'lg'
+}
+
+defineProps<Props>()
+```
+
+## Do NOT Use
+
+```typescript
+// ❌ Includes Vue internal properties (onUpdate:*, class, style, etc.)
+type Props = InstanceType<typeof MyButton>['$props']
+```
+
+## Note
+
+Vue's built-in `ExtractPropTypes` is for runtime props objects (`props: { foo: String }`), not for `.vue` components.
+
+## Reference
+
+- [vue-component-type-helpers](https://github.com/vuejs/language-tools/tree/master/packages/component-type-helpers)
diff --git a/.agents/skills/vue-best-practices/rules/fallthrough-attributes.md b/.agents/skills/vue-best-practices/rules/fallthrough-attributes.md
new file mode 100644
index 0000000..5771ffc
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/fallthrough-attributes.md
@@ -0,0 +1,63 @@
+---
+title: Enable Fallthrough Attributes Type Checking
+impact: MEDIUM
+impactDescription: enables IDE autocomplete for fallthrough attributes in wrapper components
+type: capability
+tags: fallthroughAttributes, vueCompilerOptions, component-library, wrapper-components
+---
+
+# Enable Fallthrough Attributes Type Checking
+
+**Impact: MEDIUM** - enables type-aware attribute forwarding in component libraries
+
+When building component libraries with wrapper components, enable `fallthroughAttributes` to get IDE autocomplete for attributes that will be forwarded to child elements.
+
+## What It Does
+
+Wrapper components that pass attributes to child elements can benefit from type-aware completion:
+
+```vue
+<!-- MyButton.vue - wrapper around native button -->
+<template>
+  <button v-bind="$attrs"><slot /></button>
+</template>
+```
+
+## Solution
+
+Enable `fallthroughAttributes` in your tsconfig:
+
+```json
+// tsconfig.json or tsconfig.app.json
+{
+  "vueCompilerOptions": {
+    "fallthroughAttributes": true
+  }
+}
+```
+
+## How It Works
+
+When `fallthroughAttributes: true`:
+- Vue Language Server analyzes which element receives `$attrs`
+- IDE autocomplete suggests valid attributes for the target element
+- Helps developers discover available attributes
+
+> **Note:** This primarily enables IDE autocomplete for valid fallthrough attributes. It does NOT reject invalid attributes as type errors - arbitrary attributes are still allowed.
+
+## Related Options
+
+Combine with `strictTemplates` for comprehensive checking:
+
+```json
+{
+  "vueCompilerOptions": {
+    "strictTemplates": true,
+    "fallthroughAttributes": true
+  }
+}
+```
+
+## Reference
+
+- [Vue Language Tools Wiki - Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
diff --git a/.agents/skills/vue-best-practices/rules/hmr-vue-ssr.md b/.agents/skills/vue-best-practices/rules/hmr-vue-ssr.md
new file mode 100644
index 0000000..db1e427
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/hmr-vue-ssr.md
@@ -0,0 +1,124 @@
+---
+title: HMR Debugging for Vue SSR
+impact: MEDIUM
+impactDescription: fixes Hot Module Replacement breaking in Vue SSR applications
+type: efficiency
+tags: vite, hmr, ssr, vue, hot-reload, server-side-rendering
+---
+
+# HMR Debugging for Vue SSR
+
+**Impact: MEDIUM** - fixes Hot Module Replacement breaking in Vue SSR applications
+
+Hot Module Replacement breaks when modifying Vue component `<script setup>` sections in SSR applications. Changes cause errors instead of smooth updates, requiring full page reloads.
+
+## Symptoms
+
+- HMR works for `<template>` changes but breaks for `<script setup>`
+- "Cannot read property of undefined" after saving
+- Full page reload required after script changes
+- HMR works in dev:client but not dev:ssr
+
+## Root Cause
+
+SSR mode has a different transformation pipeline. The Vue plugin's HMR boundary detection doesn't handle SSR modules the same way as client modules.
+
+## Fix
+
+**Step 1: Ensure correct SSR plugin configuration**
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+export default defineConfig({
+  plugins: [vue()],
+  ssr: {
+    // Don't externalize these for HMR to work
+    noExternal: ['vue', '@vue/runtime-core', '@vue/runtime-dom']
+  }
+})
+```
+
+**Step 2: Configure dev server for SSR HMR**
+```typescript
+// server.ts
+import { createServer } from 'vite'
+
+const vite = await createServer({
+  server: { middlewareMode: true },
+  appType: 'custom'
+})
+
+// Use vite.ssrLoadModule for server-side imports
+const { render } = await vite.ssrLoadModule('/src/entry-server.ts')
+
+// Handle HMR
+vite.watcher.on('change', async (file) => {
+  if (file.endsWith('.vue')) {
+    // Invalidate the module
+    const mod = vite.moduleGraph.getModuleById(file)
+    if (mod) {
+      vite.moduleGraph.invalidateModule(mod)
+    }
+  }
+})
+```
+
+**Step 3: Add HMR acceptance in entry-server**
+```typescript
+// entry-server.ts
+import { createApp } from './main'
+
+export async function render(url: string) {
+  const app = createApp()
+  // ... render logic
+}
+
+// Accept HMR updates
+if (import.meta.hot) {
+  import.meta.hot.accept()
+}
+```
+
+## Framework-Specific Solutions
+
+### Nuxt 3
+HMR should work out of the box. If not:
+```bash
+rm -rf .nuxt node_modules/.vite
+npm install
+npm run dev
+```
+
+### Vite SSR Template
+Ensure you're using the latest `@vitejs/plugin-vue`:
+```bash
+npm install @vitejs/plugin-vue@latest
+```
+
+## Debugging
+
+Enable verbose HMR logging:
+```typescript
+// vite.config.ts
+export default defineConfig({
+  server: {
+    hmr: {
+      overlay: true
+    }
+  },
+  logLevel: 'info'  // Shows HMR updates
+})
+```
+
+## Known Limitations
+
+- HMR for `<script>` (not `<script setup>`) may require full reload
+- SSR components with external dependencies may not hot-reload
+- State is not preserved for SSR components (expected behavior)
+
+## Reference
+
+- [vite-plugin-vue#525](https://github.com/vitejs/vite-plugin-vue/issues/525)
+- [Vite SSR Guide](https://vite.dev/guide/ssr.html)
diff --git a/.agents/skills/vue-best-practices/rules/module-resolution-bundler.md b/.agents/skills/vue-best-practices/rules/module-resolution-bundler.md
new file mode 100644
index 0000000..bfc2072
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/module-resolution-bundler.md
@@ -0,0 +1,81 @@
+---
+title: moduleResolution Bundler Migration Issues
+impact: HIGH
+impactDescription: fixes "Cannot find module" errors after @vue/tsconfig upgrade
+type: capability
+tags: moduleResolution, bundler, tsconfig, vue-tsconfig, node, esm
+---
+
+# moduleResolution Bundler Migration Issues
+
+**Impact: HIGH** - fixes "Cannot find module" errors after @vue/tsconfig upgrade
+
+Recent versions of `@vue/tsconfig` changed `moduleResolution` from `"node"` to `"bundler"`. This can break existing projects with errors like "Cannot find module 'vue'" or issues with `resolveJsonModule`.
+
+## Symptoms
+
+- `Cannot find module 'vue'` or other packages
+- `Option '--resolveJsonModule' cannot be specified without 'node' module resolution`
+- Errors appear after updating `@vue/tsconfig`
+- Some third-party packages no longer resolve
+
+## Root Cause
+
+`moduleResolution: "bundler"` requires:
+1. TypeScript 5.0+
+2. Packages to have proper `exports` field in package.json
+3. Different resolution rules than Node.js classic resolution
+
+## Fix
+
+**Option 1: Ensure TypeScript 5.0+ everywhere**
+```bash
+npm install -D typescript@^5.0.0
+```
+
+In monorepos, ALL packages must use TypeScript 5.0+.
+
+**Option 2: Add compatibility workaround**
+```json
+{
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolvePackageJsonExports": false
+  }
+}
+```
+
+Setting `resolvePackageJsonExports: false` restores compatibility with packages that don't have proper exports.
+
+**Option 3: Revert to Node resolution**
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "node"
+  }
+}
+```
+
+## Which Packages Break?
+
+Packages break if they:
+- Lack `exports` field in package.json
+- Have incorrect `exports` configuration
+- Rely on Node.js-specific resolution behavior
+
+## Diagnosis
+
+```bash
+# Check which resolution is being used
+cat tsconfig.json | grep moduleResolution
+
+# Test if a specific module resolves
+npx tsc --traceResolution 2>&1 | grep "module-name"
+```
+
+## Reference
+
+- [vuejs/tsconfig#8](https://github.com/vuejs/tsconfig/issues/8)
+- [TypeScript moduleResolution docs](https://www.typescriptlang.org/tsconfig#moduleResolution)
+- [Vite discussion#14001](https://github.com/vitejs/vite/discussions/14001)
diff --git a/.agents/skills/vue-best-practices/rules/pinia-store-mocking.md b/.agents/skills/vue-best-practices/rules/pinia-store-mocking.md
new file mode 100644
index 0000000..159e120
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/pinia-store-mocking.md
@@ -0,0 +1,159 @@
+---
+title: Mocking Pinia Stores with Vitest
+impact: HIGH
+impactDescription: properly mocks Pinia stores in component tests
+type: efficiency
+tags: pinia, vitest, testing, mock, createTestingPinia, store
+---
+
+# Mocking Pinia Stores with Vitest
+
+**Impact: HIGH** - properly mocks Pinia stores in component tests
+
+Developers struggle to properly mock Pinia stores: `createTestingPinia` requires explicit `createSpy` configuration, and "injection Symbol(pinia) not found" errors occur without proper setup.
+
+> **Important (@pinia/testing 1.0+):** The `createSpy` option is **REQUIRED**, not optional. Omitting it throws an error: "You must configure the `createSpy` option."
+
+## Symptoms
+
+- "injection Symbol(pinia) not found" error
+- "You must configure the `createSpy` option" error
+- Actions not properly mocked
+- Store state not reset between tests
+
+## Fix
+
+**Pattern 1: Basic setup with createTestingPinia**
+```typescript
+import { mount } from '@vue/test-utils'
+import { createTestingPinia } from '@pinia/testing'
+import { vi } from 'vitest'
+import MyComponent from './MyComponent.vue'
+import { useCounterStore } from '@/stores/counter'
+
+test('component uses store', async () => {
+  const wrapper = mount(MyComponent, {
+    global: {
+      plugins: [
+        createTestingPinia({
+          createSpy: vi.fn,  // REQUIRED in @pinia/testing 1.0+
+          initialState: {
+            counter: { count: 10 }  // Set initial state
+          }
+        })
+      ]
+    }
+  })
+
+  // Get the store instance AFTER mounting
+  const store = useCounterStore()
+
+  // Actions are automatically stubbed
+  await wrapper.find('button').trigger('click')
+  expect(store.increment).toHaveBeenCalled()
+})
+```
+
+**Pattern 2: Customize action behavior**
+```typescript
+test('component handles async action', async () => {
+  const wrapper = mount(MyComponent, {
+    global: {
+      plugins: [
+        createTestingPinia({
+          createSpy: vi.fn,
+          stubActions: false  // Don't stub, use real actions
+        })
+      ]
+    }
+  })
+
+  const store = useCounterStore()
+
+  // Override specific action
+  store.fetchData = vi.fn().mockResolvedValue({ items: [] })
+
+  await wrapper.find('.load-button').trigger('click')
+  expect(store.fetchData).toHaveBeenCalled()
+})
+```
+
+**Pattern 3: Testing store directly**
+```typescript
+import { setActivePinia, createPinia } from 'pinia'
+import { useCounterStore } from '@/stores/counter'
+
+describe('Counter Store', () => {
+  beforeEach(() => {
+    setActivePinia(createPinia())
+  })
+
+  test('increments count', () => {
+    const store = useCounterStore()
+    expect(store.count).toBe(0)
+
+    store.increment()
+    expect(store.count).toBe(1)
+  })
+})
+```
+
+## Setup Store with Vitest
+
+```typescript
+// stores/counter.ts - Setup store syntax
+export const useCounterStore = defineStore('counter', () => {
+  const count = ref(0)
+  const doubleCount = computed(() => count.value * 2)
+
+  function increment() {
+    count.value++
+  }
+
+  return { count, doubleCount, increment }
+})
+
+// Test file
+test('setup store works', async () => {
+  const pinia = createTestingPinia({
+    createSpy: vi.fn,
+    initialState: {
+      counter: { count: 5 }
+    }
+  })
+
+  const wrapper = mount(MyComponent, {
+    global: { plugins: [pinia] }
+  })
+
+  const store = useCounterStore()
+  expect(store.count).toBe(5)
+  expect(store.doubleCount).toBe(10)
+})
+```
+
+## Reset Between Tests
+
+```typescript
+describe('Store Tests', () => {
+  let pinia: Pinia
+
+  beforeEach(() => {
+    pinia = createTestingPinia({
+      createSpy: vi.fn
+    })
+  })
+
+  afterEach(() => {
+    vi.clearAllMocks()
+  })
+
+  test('test 1', () => { /* ... */ })
+  test('test 2', () => { /* ... */ })
+})
+```
+
+## Reference
+
+- [Pinia Testing Guide](https://pinia.vuejs.org/cookbook/testing.html)
+- [Pinia Discussion #2092](https://github.com/vuejs/pinia/discussions/2092)
diff --git a/.agents/skills/vue-best-practices/rules/script-setup-jsdoc.md b/.agents/skills/vue-best-practices/rules/script-setup-jsdoc.md
new file mode 100644
index 0000000..0bc522c
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/script-setup-jsdoc.md
@@ -0,0 +1,85 @@
+---
+title: JSDoc Documentation for Script Setup Components
+impact: MEDIUM
+impactDescription: enables proper documentation for composition API components
+type: capability
+tags: jsdoc, script-setup, documentation, composition-api, component
+---
+
+# JSDoc Documentation for Script Setup Components
+
+**Impact: MEDIUM** - enables proper documentation for composition API components
+
+`<script setup>` doesn't have an obvious place to attach JSDoc comments for the component itself. Use a dual-script pattern.
+
+## Problem
+
+**Incorrect:**
+```vue
+<script setup lang="ts">
+/**
+ * This comment doesn't appear in IDE hover or docs
+ * @component
+ */
+import { ref } from 'vue'
+
+const count = ref(0)
+</script>
+```
+
+JSDoc comments inside `<script setup>` don't attach to the component export because there's no explicit export statement.
+
+## Solution
+
+Use both `<script>` and `<script setup>` blocks:
+
+**Correct:**
+```vue
+<script lang="ts">
+/**
+ * A counter component that displays and increments a value.
+ *
+ * @example
+ * ```vue
+ * <Counter :initial="5" @update="handleUpdate" />
+ * ```
+ *
+ * @component
+ */
+export default {}
+</script>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+
+const props = defineProps<{
+  /** Starting value for the counter */
+  initial?: number
+}>()
+
+const emit = defineEmits<{
+  /** Emitted when counter value changes */
+  update: [value: number]
+}>()
+
+const count = ref(props.initial ?? 0)
+</script>
+```
+
+## How It Works
+
+- The regular `<script>` block's default export is merged with `<script setup>`
+- JSDoc on `export default {}` attaches to the component
+- Props and emits JSDoc in `<script setup>` still work normally
+
+## What Gets Documented
+
+| Location | Shows In |
+|----------|----------|
+| `export default {}` JSDoc | Component import hover |
+| `defineProps` JSDoc | Prop hover in templates |
+| `defineEmits` JSDoc | Event handler hover |
+
+## Reference
+
+- [Vue Language Tools Discussion #5932](https://github.com/vuejs/language-tools/discussions/5932)
diff --git a/.agents/skills/vue-best-practices/rules/strict-css-modules.md b/.agents/skills/vue-best-practices/rules/strict-css-modules.md
new file mode 100644
index 0000000..5696917
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/strict-css-modules.md
@@ -0,0 +1,68 @@
+---
+title: Enable Strict CSS Modules Type Checking
+impact: MEDIUM
+impactDescription: catches typos in CSS module class names at compile time
+type: capability
+tags: strictCssModules, vueCompilerOptions, css-modules, style-module
+---
+
+# Enable Strict CSS Modules Type Checking
+
+**Impact: MEDIUM** - catches typos in CSS module class names at compile time
+
+When using CSS modules with `<style module>`, Vue doesn't validate class names by default. Enable `strictCssModules` to catch typos and undefined classes.
+
+## Problem
+
+CSS module class name errors go undetected:
+
+```vue
+<script setup lang="ts">
+// No error for typo in class name
+</script>
+
+<template>
+  <div :class="$style.buttn">Click me</div>
+</template>
+
+<style module>
+.button {
+  background: blue;
+}
+</style>
+```
+
+The typo `buttn` instead of `button` silently fails at runtime.
+
+## Solution
+
+Enable `strictCssModules` in your tsconfig:
+
+```json
+// tsconfig.json or tsconfig.app.json
+{
+  "vueCompilerOptions": {
+    "strictCssModules": true
+  }
+}
+```
+
+Now `$style.buttn` will show a type error because `buttn` doesn't exist in the CSS module.
+
+## What Gets Checked
+
+| Access | With strictCssModules |
+|--------|----------------------|
+| `$style.validClass` | OK |
+| `$style.typo` | Error: Property 'typo' does not exist |
+| `$style['dynamic']` | OK (dynamic access not checked) |
+
+## Limitations
+
+- Only checks static property access (`$style.className`)
+- Dynamic access (`$style[variable]`) is not validated
+- Only works with `<style module>`, not external CSS files
+
+## Reference
+
+- [Vue Language Tools Wiki - Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
diff --git a/.agents/skills/vue-best-practices/rules/volar-3-breaking-changes.md b/.agents/skills/vue-best-practices/rules/volar-3-breaking-changes.md
new file mode 100644
index 0000000..747d534
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/volar-3-breaking-changes.md
@@ -0,0 +1,65 @@
+---
+title: Volar 3.0 Breaking Changes
+impact: HIGH
+impactDescription: fixes editor integration after Volar/vue-language-server upgrade
+type: capability
+tags: volar, vue-language-server, neovim, vscode, ide, ts_ls, vtsls
+---
+
+# Volar 3.0 Breaking Changes
+
+**Impact: HIGH** - fixes editor integration after Volar/vue-language-server upgrade
+
+Volar 3.0 (vue-language-server 3.x) introduced breaking changes to the language server protocol. Editors configured for Volar 2.x will break with errors like "vue_ls doesn't work with ts_ls.. it expects vtsls".
+
+## Symptoms
+
+- `vue_ls doesn't work with ts_ls`
+- TypeScript features stop working in Vue files
+- No autocomplete, type hints, or error highlighting
+- Editor shows "Language server initialization failed"
+
+## Fix by Editor
+
+### VSCode
+
+Update the "Vue - Official" extension to latest version. It manages the language server automatically.
+
+### NeoVim (nvim-lspconfig)
+
+**Option 1: Use vtsls instead of ts_ls**
+```lua
+-- Replace ts_ls/tsserver with vtsls
+require('lspconfig').vtsls.setup({})
+require('lspconfig').volar.setup({})
+```
+
+**Option 2: Downgrade vue-language-server**
+```bash
+npm install -g @vue/language-server@2.1.10
+```
+
+### JetBrains IDEs
+
+Update to latest Vue plugin. If issues persist, disable and re-enable the Vue plugin.
+
+## What Changed in 3.0
+
+| Feature | Volar 2.x | Volar 3.0 |
+|---------|-----------|-----------|
+| TypeScript integration | ts_ls/tsserver | vtsls recommended (Neovim) |
+| Hybrid mode | Optional | Default |
+
+## Workaround: Stay on 2.x
+
+If upgrading is not possible:
+```bash
+npm install -g @vue/language-server@^2.0.0
+```
+
+Pin in your project's package.json to prevent accidental upgrades.
+
+## Reference
+
+- [vuejs/language-tools#5598](https://github.com/vuejs/language-tools/issues/5598)
+- [NeoVim Vue Setup Guide](https://dev.to/danwalsh/solved-vue-3-typescript-inlay-hint-support-in-neovim-53ej)
diff --git a/.agents/skills/vue-best-practices/rules/vue-directive-comments.md b/.agents/skills/vue-best-practices/rules/vue-directive-comments.md
new file mode 100644
index 0000000..f516ee8
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/vue-directive-comments.md
@@ -0,0 +1,73 @@
+---
+title: Vue Template Directive Comments
+impact: HIGH
+impactDescription: enables fine-grained control over template type checking
+type: capability
+tags: vue-directive, vue-ignore, vue-expect-error, vue-skip, template, type-checking
+---
+
+# Vue Template Directive Comments
+
+**Impact: HIGH** - enables fine-grained control over template type checking
+
+Vue Language Tools supports special directive comments to control type checking behavior in templates.
+
+## Available Directives
+
+### @vue-ignore
+
+Suppress type errors for the next line:
+
+```vue
+<template>
+  <!-- @vue-ignore -->
+  <Component :prop="valueWithTypeError" />
+</template>
+```
+
+### @vue-expect-error
+
+Assert that the next line should have a type error (useful for testing):
+
+```vue
+<template>
+  <!-- @vue-expect-error -->
+  <Component :invalid-prop="value" />
+</template>
+```
+
+### @vue-skip
+
+Skip type checking for an entire block:
+
+```vue
+<template>
+  <!-- @vue-skip -->
+  <div>
+    <!-- Everything in here is not type-checked -->
+    <LegacyComponent :any="props" :go="here" />
+  </div>
+</template>
+```
+
+### @vue-generic
+
+Declare template-level generic types:
+
+```vue
+<template>
+  <!-- @vue-generic {T extends string} -->
+  <GenericList :items="items as T[]" />
+</template>
+```
+
+## Use Cases
+
+- Migrating legacy components with incomplete types
+- Working with third-party components that have incorrect type definitions
+- Temporarily suppressing errors during refactoring
+- Testing that certain patterns produce expected type errors
+
+## Reference
+
+- [Vue Language Tools Wiki - Directive Comments](https://github.com/vuejs/language-tools/wiki/Directive-Comments)
diff --git a/.agents/skills/vue-best-practices/rules/vue-router-typed-params.md b/.agents/skills/vue-best-practices/rules/vue-router-typed-params.md
new file mode 100644
index 0000000..2924bbb
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/vue-router-typed-params.md
@@ -0,0 +1,81 @@
+---
+title: Vue Router useRoute Params Union Type Narrowing
+impact: MEDIUM
+impactDescription: fixes "Property does not exist" errors with typed route params
+type: capability
+tags: vue-router, useRoute, unplugin-vue-router, typed-routes, params
+---
+
+# Vue Router useRoute Params Union Type Narrowing
+
+**Impact: MEDIUM** - fixes "Property does not exist" errors with typed route params
+
+With `unplugin-vue-router` typed routes, `route.params` becomes a union of ALL page param types. TypeScript cannot narrow `Record<never, never> | { id: string }` properly, causing "Property 'id' does not exist" errors even on the correct page.
+
+## Symptoms
+
+- "Property 'id' does not exist on type 'RouteParams'"
+- `route.params.id` shows as `string | undefined` everywhere
+- Union type of all route params instead of specific route
+- Type narrowing with `if (route.name === 'users-id')` doesn't work
+
+## Root Cause
+
+`unplugin-vue-router` generates a union type of all possible route params. TypeScript's control flow analysis can't narrow this union based on route name checks.
+
+## Fix
+
+**Option 1: Pass route name to useRoute (recommended)**
+```typescript
+// pages/users/[id].vue
+import { useRoute } from 'vue-router/auto'
+
+// Specify the route path for proper typing
+const route = useRoute('/users/[id]')
+
+// Now properly typed as { id: string }
+console.log(route.params.id)  // string, not string | undefined
+```
+
+**Option 2: Type assertion with specific route**
+```typescript
+import { useRoute } from 'vue-router'
+import type { RouteLocationNormalized } from 'vue-router/auto-routes'
+
+const route = useRoute() as RouteLocationNormalized<'/users/[id]'>
+route.params.id  // Properly typed
+```
+
+**Option 3: Define route-specific param type**
+```typescript
+// In your page component
+interface UserRouteParams {
+  id: string
+}
+
+const route = useRoute()
+const { id } = route.params as UserRouteParams
+```
+
+## Required tsconfig Setting
+
+Ensure `moduleResolution: "bundler"` for unplugin-vue-router:
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+## Caveat: Route Name Format
+
+The route name matches the file path pattern:
+- `pages/users/[id].vue` → `/users/[id]`
+- `pages/posts/[slug]/comments.vue` → `/posts/[slug]/comments`
+
+## Reference
+
+- [unplugin-vue-router#337](https://github.com/posva/unplugin-vue-router/issues/337)
+- [unplugin-vue-router#176](https://github.com/posva/unplugin-vue-router/discussions/176)
+- [unplugin-vue-router TypeScript docs](https://uvr.esm.is/guide/typescript.html)
diff --git a/.agents/skills/vue-best-practices/rules/vue-tsc-strict-templates.md b/.agents/skills/vue-best-practices/rules/vue-tsc-strict-templates.md
new file mode 100644
index 0000000..46c95d5
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/vue-tsc-strict-templates.md
@@ -0,0 +1,69 @@
+---
+title: Enable Strict Template Checking
+impact: HIGH
+impactDescription: catches undefined components and props at compile time
+type: capability
+tags: vue-tsc, typescript, type-checking, templates, vueCompilerOptions
+---
+
+# Enable Strict Template Checking
+
+**Impact: HIGH** - catches undefined components and props at compile time
+
+By default, vue-tsc does not report errors for undefined components in templates. Enable `strictTemplates` to catch these issues during type checking.
+
+## Which tsconfig?
+
+Add `vueCompilerOptions` to the tsconfig that includes Vue source files. In projects with multiple tsconfigs (like those created with `create-vue`), this is typically `tsconfig.app.json`, not the root `tsconfig.json` or `tsconfig.node.json`.
+
+**Incorrect (missing strict checking):**
+
+```json
+{
+  "compilerOptions": {
+    "strict": true
+  }
+  // vueCompilerOptions not configured - undefined components won't error
+}
+```
+
+**Correct (strict template checking enabled):**
+
+```json
+{
+  "compilerOptions": {
+    "strict": true
+  },
+  "vueCompilerOptions": {
+    "strictTemplates": true
+  }
+}
+```
+
+## Available Options
+
+| Option | Default | Effect |
+|--------|---------|--------|
+| `strictTemplates` | `false` | Enables all checkUnknown* options below |
+| `checkUnknownComponents` | `false` | Error on undefined/unregistered components |
+| `checkUnknownProps` | `false` | Error on props not declared in component definition |
+| `checkUnknownEvents` | `false` | Error on events not declared via `defineEmits` |
+| `checkUnknownDirectives` | `false` | Error on unregistered custom directives |
+
+## Granular Control
+
+If `strictTemplates` is too strict, enable individual checks:
+
+```json
+{
+  "vueCompilerOptions": {
+    "checkUnknownComponents": true,
+    "checkUnknownProps": false
+  }
+}
+```
+
+## Reference
+
+- [Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
+- [Vite Vue+TS Template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-vue-ts)
diff --git a/.agents/skills/vue-best-practices/rules/with-defaults-union-types.md b/.agents/skills/vue-best-practices/rules/with-defaults-union-types.md
new file mode 100644
index 0000000..0c802d9
--- /dev/null
+++ b/.agents/skills/vue-best-practices/rules/with-defaults-union-types.md
@@ -0,0 +1,102 @@
+---
+title: withDefaults Incorrect Default with Union Types
+impact: MEDIUM
+impactDescription: fixes spurious "Missing required prop" warning with union type props
+type: capability
+tags: withDefaults, defineProps, union-types, defaults, vue-3.5
+---
+
+# withDefaults Incorrect Default with Union Types
+
+**Impact: MEDIUM** - fixes spurious "Missing required prop" warning with union type props
+
+Using `withDefaults` with union types like `false | string` may produce a Vue runtime warning "Missing required prop" even when a default is provided. The runtime value IS applied correctly, but the warning can be confusing.
+
+## Symptoms
+
+- Vue warns "Missing required prop" despite default being set
+- Warning appears only with union types like `false | string`
+- TypeScript types are correct
+- Runtime value IS correct (the default is applied)
+
+## Problematic Pattern
+
+```typescript
+// This produces a spurious warning (but works at runtime)
+interface Props {
+  value: false | string  // Union type
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  value: 'default'  // Runtime value IS correct, but Vue warns about missing prop
+})
+```
+
+## Fix
+
+**Option 1: Use Reactive Props Destructure (Vue 3.5+)**
+```vue
+<script setup lang="ts">
+interface Props {
+  value: false | string
+}
+
+// Preferred in Vue 3.5+
+const { value = 'default' } = defineProps<Props>()
+</script>
+```
+
+**Option 2: Use runtime declaration**
+```vue
+<script setup lang="ts">
+const props = defineProps({
+  value: {
+    type: [Boolean, String] as PropType<false | string>,
+    default: 'default'
+  }
+})
+</script>
+```
+
+**Option 3: Split into separate props**
+```typescript
+interface Props {
+  enabled: boolean
+  customValue?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  enabled: false,
+  customValue: 'default'
+})
+```
+
+## Why Reactive Props Destructure Works
+
+Vue 3.5's Reactive Props Destructure handles default values at the destructuring level, bypassing the type inference issues with `withDefaults`.
+
+```typescript
+// The default is applied during destructuring, not type inference
+const { prop = 'default' } = defineProps<{ prop?: string }>()
+```
+
+## Enable Reactive Props Destructure
+
+This is enabled by default in Vue 3.5+. For older versions:
+```javascript
+// vite.config.js
+export default {
+  plugins: [
+    vue({
+      script: {
+        propsDestructure: true
+      }
+    })
+  ]
+}
+```
+
+## Reference
+
+- [vuejs/core#12897](https://github.com/vuejs/core/issues/12897)
+- [Reactive Props Destructure RFC](https://github.com/vuejs/rfcs/discussions/502)
diff --git a/.agents/skills/web-artifacts-builder/LICENSE.txt b/.agents/skills/web-artifacts-builder/LICENSE.txt
new file mode 100644
index 0000000..7a4a3ea
--- /dev/null
+++ b/.agents/skills/web-artifacts-builder/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
\ No newline at end of file
diff --git a/.agents/skills/web-artifacts-builder/SKILL.md b/.agents/skills/web-artifacts-builder/SKILL.md
new file mode 100644
index 0000000..15a3b3a
--- /dev/null
+++ b/.agents/skills/web-artifacts-builder/SKILL.md
@@ -0,0 +1,74 @@
+---
+name: web-artifacts-builder
+description: Suite of tools for creating elaborate, multi-component Codex.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
+license: Complete terms in LICENSE.txt
+---
+
+# Web Artifacts Builder
+
+To build powerful frontend Codex.ai artifacts, follow these steps:
+1. Initialize the frontend repo using `scripts/init-artifact.sh`
+2. Develop your artifact by editing the generated code
+3. Bundle all code into a single HTML file using `scripts/bundle-artifact.sh`
+4. Display artifact to user
+5. (Optional) Test the artifact
+
+**Stack**: React 18 + TypeScript + Vite + Parcel (bundling) + Tailwind CSS + shadcn/ui
+
+## Design & Style Guidelines
+
+VERY IMPORTANT: To avoid what is often referred to as "AI slop", avoid using excessive centered layouts, purple gradients, uniform rounded corners, and Inter font.
+
+## Quick Start
+
+### Step 1: Initialize Project
+
+Run the initialization script to create a new React project:
+```bash
+bash scripts/init-artifact.sh <project-name>
+cd <project-name>
+```
+
+This creates a fully configured project with:
+- ✅ React + TypeScript (via Vite)
+- ✅ Tailwind CSS 3.4.1 with shadcn/ui theming system
+- ✅ Path aliases (`@/`) configured
+- ✅ 40+ shadcn/ui components pre-installed
+- ✅ All Radix UI dependencies included
+- ✅ Parcel configured for bundling (via .parcelrc)
+- ✅ Node 18+ compatibility (auto-detects and pins Vite version)
+
+### Step 2: Develop Your Artifact
+
+To build the artifact, edit the generated files. See **Common Development Tasks** below for guidance.
+
+### Step 3: Bundle to Single HTML File
+
+To bundle the React app into a single HTML artifact:
+```bash
+bash scripts/bundle-artifact.sh
+```
+
+This creates `bundle.html` - a self-contained artifact with all JavaScript, CSS, and dependencies inlined. This file can be directly shared in Codex conversations as an artifact.
+
+**Requirements**: Your project must have an `index.html` in the root directory.
+
+**What the script does**:
+- Installs bundling dependencies (parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline)
+- Creates `.parcelrc` config with path alias support
+- Builds with Parcel (no source maps)
+- Inlines all assets into single HTML using html-inline
+
+### Step 4: Share Artifact with User
+
+Finally, share the bundled HTML file in conversation with the user so they can view it as an artifact.
+
+### Step 5: Testing/Visualizing the Artifact (Optional)
+
+Note: This is a completely optional step. Only perform if necessary or requested.
+
+To test/visualize the artifact, use available tools (including other Skills or built-in tools like Playwright or Puppeteer). In general, avoid testing the artifact upfront as it adds latency between the request and when the finished artifact can be seen. Test later, after presenting the artifact, if requested or if issues arise.
+
+## Reference
+
+- **shadcn/ui components**: https://ui.shadcn.com/docs/components
\ No newline at end of file
diff --git a/.agents/skills/web-artifacts-builder/scripts/bundle-artifact.sh b/.agents/skills/web-artifacts-builder/scripts/bundle-artifact.sh
new file mode 100644
index 0000000..c13d229
--- /dev/null
+++ b/.agents/skills/web-artifacts-builder/scripts/bundle-artifact.sh
@@ -0,0 +1,54 @@
+#!/bin/bash
+set -e
+
+echo "📦 Bundling React app to single HTML artifact..."
+
+# Check if we're in a project directory
+if [ ! -f "package.json" ]; then
+  echo "❌ Error: No package.json found. Run this script from your project root."
+  exit 1
+fi
+
+# Check if index.html exists
+if [ ! -f "index.html" ]; then
+  echo "❌ Error: No index.html found in project root."
+  echo "   This script requires an index.html entry point."
+  exit 1
+fi
+
+# Install bundling dependencies
+echo "📦 Installing bundling dependencies..."
+pnpm add -D parcel @parcel/config-default parcel-resolver-tspaths html-inline
+
+# Create Parcel config with tspaths resolver
+if [ ! -f ".parcelrc" ]; then
+  echo "🔧 Creating Parcel configuration with path alias support..."
+  cat > .parcelrc << 'EOF'
+{
+  "extends": "@parcel/config-default",
+  "resolvers": ["parcel-resolver-tspaths", "..."]
+}
+EOF
+fi
+
+# Clean previous build
+echo "🧹 Cleaning previous build..."
+rm -rf dist bundle.html
+
+# Build with Parcel
+echo "🔨 Building with Parcel..."
+pnpm exec parcel build index.html --dist-dir dist --no-source-maps
+
+# Inline everything into single HTML
+echo "🎯 Inlining all assets into single HTML file..."
+pnpm exec html-inline dist/index.html > bundle.html
+
+# Get file size
+FILE_SIZE=$(du -h bundle.html | cut -f1)
+
+echo ""
+echo "✅ Bundle complete!"
+echo "📄 Output: bundle.html ($FILE_SIZE)"
+echo ""
+echo "You can now use this single HTML file as an artifact in Claude conversations."
+echo "To test locally: open bundle.html in your browser"
\ No newline at end of file
diff --git a/.agents/skills/web-artifacts-builder/scripts/init-artifact.sh b/.agents/skills/web-artifacts-builder/scripts/init-artifact.sh
new file mode 100644
index 0000000..7d1022d
--- /dev/null
+++ b/.agents/skills/web-artifacts-builder/scripts/init-artifact.sh
@@ -0,0 +1,322 @@
+#!/bin/bash
+
+# Exit on error
+set -e
+
+# Detect Node version
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+
+echo "🔍 Detected Node.js version: $NODE_VERSION"
+
+if [ "$NODE_VERSION" -lt 18 ]; then
+  echo "❌ Error: Node.js 18 or higher is required"
+  echo "   Current version: $(node -v)"
+  exit 1
+fi
+
+# Set Vite version based on Node version
+if [ "$NODE_VERSION" -ge 20 ]; then
+  VITE_VERSION="latest"
+  echo "✅ Using Vite latest (Node 20+)"
+else
+  VITE_VERSION="5.4.11"
+  echo "✅ Using Vite $VITE_VERSION (Node 18 compatible)"
+fi
+
+# Detect OS and set sed syntax
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  SED_INPLACE="sed -i ''"
+else
+  SED_INPLACE="sed -i"
+fi
+
+# Check if pnpm is installed
+if ! command -v pnpm &> /dev/null; then
+  echo "📦 pnpm not found. Installing pnpm..."
+  npm install -g pnpm
+fi
+
+# Check if project name is provided
+if [ -z "$1" ]; then
+  echo "❌ Usage: ./create-react-shadcn-complete.sh <project-name>"
+  exit 1
+fi
+
+PROJECT_NAME="$1"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+COMPONENTS_TARBALL="$SCRIPT_DIR/shadcn-components.tar.gz"
+
+# Check if components tarball exists
+if [ ! -f "$COMPONENTS_TARBALL" ]; then
+  echo "❌ Error: shadcn-components.tar.gz not found in script directory"
+  echo "   Expected location: $COMPONENTS_TARBALL"
+  exit 1
+fi
+
+echo "🚀 Creating new React + Vite project: $PROJECT_NAME"
+
+# Create new Vite project (always use latest create-vite, pin vite version later)
+pnpm create vite "$PROJECT_NAME" --template react-ts
+
+# Navigate into project directory
+cd "$PROJECT_NAME"
+
+echo "🧹 Cleaning up Vite template..."
+$SED_INPLACE '/<link rel="icon".*vite\.svg/d' index.html
+$SED_INPLACE 's/<title>.*<\/title>/<title>'"$PROJECT_NAME"'<\/title>/' index.html
+
+echo "📦 Installing base dependencies..."
+pnpm install
+
+# Pin Vite version for Node 18
+if [ "$NODE_VERSION" -lt 20 ]; then
+  echo "📌 Pinning Vite to $VITE_VERSION for Node 18 compatibility..."
+  pnpm add -D vite@$VITE_VERSION
+fi
+
+echo "📦 Installing Tailwind CSS and dependencies..."
+pnpm install -D tailwindcss@3.4.1 postcss autoprefixer @types/node tailwindcss-animate
+pnpm install class-variance-authority clsx tailwind-merge lucide-react next-themes
+
+echo "⚙️  Creating Tailwind and PostCSS configuration..."
+cat > postcss.config.js << 'EOF'
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}
+EOF
+
+echo "📝 Configuring Tailwind with shadcn theme..."
+cat > tailwind.config.js << 'EOF'
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: ["class"],
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+  ],
+  theme: {
+    extend: {
+      colors: {
+        border: "hsl(var(--border))",
+        input: "hsl(var(--input))",
+        ring: "hsl(var(--ring))",
+        background: "hsl(var(--background))",
+        foreground: "hsl(var(--foreground))",
+        primary: {
+          DEFAULT: "hsl(var(--primary))",
+          foreground: "hsl(var(--primary-foreground))",
+        },
+        secondary: {
+          DEFAULT: "hsl(var(--secondary))",
+          foreground: "hsl(var(--secondary-foreground))",
+        },
+        destructive: {
+          DEFAULT: "hsl(var(--destructive))",
+          foreground: "hsl(var(--destructive-foreground))",
+        },
+        muted: {
+          DEFAULT: "hsl(var(--muted))",
+          foreground: "hsl(var(--muted-foreground))",
+        },
+        accent: {
+          DEFAULT: "hsl(var(--accent))",
+          foreground: "hsl(var(--accent-foreground))",
+        },
+        popover: {
+          DEFAULT: "hsl(var(--popover))",
+          foreground: "hsl(var(--popover-foreground))",
+        },
+        card: {
+          DEFAULT: "hsl(var(--card))",
+          foreground: "hsl(var(--card-foreground))",
+        },
+      },
+      borderRadius: {
+        lg: "var(--radius)",
+        md: "calc(var(--radius) - 2px)",
+        sm: "calc(var(--radius) - 4px)",
+      },
+      keyframes: {
+        "accordion-down": {
+          from: { height: "0" },
+          to: { height: "var(--radix-accordion-content-height)" },
+        },
+        "accordion-up": {
+          from: { height: "var(--radix-accordion-content-height)" },
+          to: { height: "0" },
+        },
+      },
+      animation: {
+        "accordion-down": "accordion-down 0.2s ease-out",
+        "accordion-up": "accordion-up 0.2s ease-out",
+      },
+    },
+  },
+  plugins: [require("tailwindcss-animate")],
+}
+EOF
+
+# Add Tailwind directives and CSS variables to index.css
+echo "🎨 Adding Tailwind directives and CSS variables..."
+cat > src/index.css << 'EOF'
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  :root {
+    --background: 0 0% 100%;
+    --foreground: 0 0% 3.9%;
+    --card: 0 0% 100%;
+    --card-foreground: 0 0% 3.9%;
+    --popover: 0 0% 100%;
+    --popover-foreground: 0 0% 3.9%;
+    --primary: 0 0% 9%;
+    --primary-foreground: 0 0% 98%;
+    --secondary: 0 0% 96.1%;
+    --secondary-foreground: 0 0% 9%;
+    --muted: 0 0% 96.1%;
+    --muted-foreground: 0 0% 45.1%;
+    --accent: 0 0% 96.1%;
+    --accent-foreground: 0 0% 9%;
+    --destructive: 0 84.2% 60.2%;
+    --destructive-foreground: 0 0% 98%;
+    --border: 0 0% 89.8%;
+    --input: 0 0% 89.8%;
+    --ring: 0 0% 3.9%;
+    --radius: 0.5rem;
+  }
+
+  .dark {
+    --background: 0 0% 3.9%;
+    --foreground: 0 0% 98%;
+    --card: 0 0% 3.9%;
+    --card-foreground: 0 0% 98%;
+    --popover: 0 0% 3.9%;
+    --popover-foreground: 0 0% 98%;
+    --primary: 0 0% 98%;
+    --primary-foreground: 0 0% 9%;
+    --secondary: 0 0% 14.9%;
+    --secondary-foreground: 0 0% 98%;
+    --muted: 0 0% 14.9%;
+    --muted-foreground: 0 0% 63.9%;
+    --accent: 0 0% 14.9%;
+    --accent-foreground: 0 0% 98%;
+    --destructive: 0 62.8% 30.6%;
+    --destructive-foreground: 0 0% 98%;
+    --border: 0 0% 14.9%;
+    --input: 0 0% 14.9%;
+    --ring: 0 0% 83.1%;
+  }
+}
+
+@layer base {
+  * {
+    @apply border-border;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}
+EOF
+
+# Add path aliases to tsconfig.json
+echo "🔧 Adding path aliases to tsconfig.json..."
+node -e "
+const fs = require('fs');
+const config = JSON.parse(fs.readFileSync('tsconfig.json', 'utf8'));
+config.compilerOptions = config.compilerOptions || {};
+config.compilerOptions.baseUrl = '.';
+config.compilerOptions.paths = { '@/*': ['./src/*'] };
+fs.writeFileSync('tsconfig.json', JSON.stringify(config, null, 2));
+"
+
+# Add path aliases to tsconfig.app.json
+echo "🔧 Adding path aliases to tsconfig.app.json..."
+node -e "
+const fs = require('fs');
+const path = 'tsconfig.app.json';
+const content = fs.readFileSync(path, 'utf8');
+// Remove comments manually
+const lines = content.split('\n').filter(line => !line.trim().startsWith('//'));
+const jsonContent = lines.join('\n');
+const config = JSON.parse(jsonContent.replace(/\/\*[\s\S]*?\*\//g, '').replace(/,(\s*[}\]])/g, '\$1'));
+config.compilerOptions = config.compilerOptions || {};
+config.compilerOptions.baseUrl = '.';
+config.compilerOptions.paths = { '@/*': ['./src/*'] };
+fs.writeFileSync(path, JSON.stringify(config, null, 2));
+"
+
+# Update vite.config.ts
+echo "⚙️  Updating Vite configuration..."
+cat > vite.config.ts << 'EOF'
+import path from "path";
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+    },
+  },
+});
+EOF
+
+# Install all shadcn/ui dependencies
+echo "📦 Installing shadcn/ui dependencies..."
+pnpm install @radix-ui/react-accordion @radix-ui/react-aspect-ratio @radix-ui/react-avatar @radix-ui/react-checkbox @radix-ui/react-collapsible @radix-ui/react-context-menu @radix-ui/react-dialog @radix-ui/react-dropdown-menu @radix-ui/react-hover-card @radix-ui/react-label @radix-ui/react-menubar @radix-ui/react-navigation-menu @radix-ui/react-popover @radix-ui/react-progress @radix-ui/react-radio-group @radix-ui/react-scroll-area @radix-ui/react-select @radix-ui/react-separator @radix-ui/react-slider @radix-ui/react-slot @radix-ui/react-switch @radix-ui/react-tabs @radix-ui/react-toast @radix-ui/react-toggle @radix-ui/react-toggle-group @radix-ui/react-tooltip
+pnpm install sonner cmdk vaul embla-carousel-react react-day-picker react-resizable-panels date-fns react-hook-form @hookform/resolvers zod
+
+# Extract shadcn components from tarball
+echo "📦 Extracting shadcn/ui components..."
+tar -xzf "$COMPONENTS_TARBALL" -C src/
+
+# Create components.json for reference
+echo "📝 Creating components.json config..."
+cat > components.json << 'EOF'
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.js",
+    "css": "src/index.css",
+    "baseColor": "slate",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}
+EOF
+
+echo "✅ Setup complete! You can now use Tailwind CSS and shadcn/ui in your project."
+echo ""
+echo "📦 Included components (40+ total):"
+echo "  - accordion, alert, aspect-ratio, avatar, badge, breadcrumb"
+echo "  - button, calendar, card, carousel, checkbox, collapsible"
+echo "  - command, context-menu, dialog, drawer, dropdown-menu"
+echo "  - form, hover-card, input, label, menubar, navigation-menu"
+echo "  - popover, progress, radio-group, resizable, scroll-area"
+echo "  - select, separator, sheet, skeleton, slider, sonner"
+echo "  - switch, table, tabs, textarea, toast, toggle, toggle-group, tooltip"
+echo ""
+echo "To start developing:"
+echo "  cd $PROJECT_NAME"
+echo "  pnpm dev"
+echo ""
+echo "📚 Import components like:"
+echo "  import { Button } from '@/components/ui/button'"
+echo "  import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/card'"
+echo "  import { Dialog, DialogContent, DialogTrigger } from '@/components/ui/dialog'"
diff --git a/.agents/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz b/.agents/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz
new file mode 100644
index 0000000..cdbe7cd
Binary files /dev/null and b/.agents/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz differ
diff --git a/.agents/skills/web-design-guidelines/SKILL.md b/.agents/skills/web-design-guidelines/SKILL.md
new file mode 100644
index 0000000..ceae92a
--- /dev/null
+++ b/.agents/skills/web-design-guidelines/SKILL.md
@@ -0,0 +1,39 @@
+---
+name: web-design-guidelines
+description: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
+metadata:
+  author: vercel
+  version: "1.0.0"
+  argument-hint: <file-or-pattern>
+---
+
+# Web Interface Guidelines
+
+Review files for compliance with Web Interface Guidelines.
+
+## How It Works
+
+1. Fetch the latest guidelines from the source URL below
+2. Read the specified files (or prompt user for files/pattern)
+3. Check against all rules in the fetched guidelines
+4. Output findings in the terse `file:line` format
+
+## Guidelines Source
+
+Fetch fresh guidelines before each review:
+
+```
+https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
+```
+
+Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions.
+
+## Usage
+
+When a user provides a file or pattern argument:
+1. Fetch guidelines from the source URL above
+2. Read the specified files
+3. Apply all rules from the fetched guidelines
+4. Output findings using the format specified in the guidelines
+
+If no files specified, ask the user which files to review.
diff --git a/.agents/skills/webapp-testing/LICENSE.txt b/.agents/skills/webapp-testing/LICENSE.txt
new file mode 100644
index 0000000..7a4a3ea
--- /dev/null
+++ b/.agents/skills/webapp-testing/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
\ No newline at end of file
diff --git a/.agents/skills/webapp-testing/SKILL.md b/.agents/skills/webapp-testing/SKILL.md
new file mode 100644
index 0000000..4726215
--- /dev/null
+++ b/.agents/skills/webapp-testing/SKILL.md
@@ -0,0 +1,96 @@
+---
+name: webapp-testing
+description: Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
+license: Complete terms in LICENSE.txt
+---
+
+# Web Application Testing
+
+To test local web applications, write native Python Playwright scripts.
+
+**Helper Scripts Available**:
+- `scripts/with_server.py` - Manages server lifecycle (supports multiple servers)
+
+**Always run scripts with `--help` first** to see usage. DO NOT read the source until you try running the script first and find that a customized solution is abslutely necessary. These scripts can be very large and thus pollute your context window. They exist to be called directly as black-box scripts rather than ingested into your context window.
+
+## Decision Tree: Choosing Your Approach
+
+```
+User task → Is it static HTML?
+    ├─ Yes → Read HTML file directly to identify selectors
+    │         ├─ Success → Write Playwright script using selectors
+    │         └─ Fails/Incomplete → Treat as dynamic (below)
+    │
+    └─ No (dynamic webapp) → Is the server already running?
+        ├─ No → Run: python scripts/with_server.py --help
+        │        Then use the helper + write simplified Playwright script
+        │
+        └─ Yes → Reconnaissance-then-action:
+            1. Navigate and wait for networkidle
+            2. Take screenshot or inspect DOM
+            3. Identify selectors from rendered state
+            4. Execute actions with discovered selectors
+```
+
+## Example: Using with_server.py
+
+To start a server, run `--help` first, then use the helper:
+
+**Single server:**
+```bash
+python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py
+```
+
+**Multiple servers (e.g., backend + frontend):**
+```bash
+python scripts/with_server.py \
+  --server "cd backend && python server.py" --port 3000 \
+  --server "cd frontend && npm run dev" --port 5173 \
+  -- python your_automation.py
+```
+
+To create an automation script, include only Playwright logic (servers are managed automatically):
+```python
+from playwright.sync_api import sync_playwright
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True) # Always launch chromium in headless mode
+    page = browser.new_page()
+    page.goto('http://localhost:5173') # Server already running and ready
+    page.wait_for_load_state('networkidle') # CRITICAL: Wait for JS to execute
+    # ... your automation logic
+    browser.close()
+```
+
+## Reconnaissance-Then-Action Pattern
+
+1. **Inspect rendered DOM**:
+   ```python
+   page.screenshot(path='/tmp/inspect.png', full_page=True)
+   content = page.content()
+   page.locator('button').all()
+   ```
+
+2. **Identify selectors** from inspection results
+
+3. **Execute actions** using discovered selectors
+
+## Common Pitfall
+
+❌ **Don't** inspect the DOM before waiting for `networkidle` on dynamic apps
+✅ **Do** wait for `page.wait_for_load_state('networkidle')` before inspection
+
+## Best Practices
+
+- **Use bundled scripts as black boxes** - To accomplish a task, consider whether one of the scripts available in `scripts/` can help. These scripts handle common, complex workflows reliably without cluttering the context window. Use `--help` to see usage, then invoke directly. 
+- Use `sync_playwright()` for synchronous scripts
+- Always close the browser when done
+- Use descriptive selectors: `text=`, `role=`, CSS selectors, or IDs
+- Add appropriate waits: `page.wait_for_selector()` or `page.wait_for_timeout()`
+
+## Reference Files
+
+- **examples/** - Examples showing common patterns:
+  - `element_discovery.py` - Discovering buttons, links, and inputs on a page
+  - `static_html_automation.py` - Using file:// URLs for local HTML
+  - `console_logging.py` - Capturing console logs during automation
\ No newline at end of file
diff --git a/.agents/skills/webapp-testing/examples/console_logging.py b/.agents/skills/webapp-testing/examples/console_logging.py
new file mode 100644
index 0000000..9329b5e
--- /dev/null
+++ b/.agents/skills/webapp-testing/examples/console_logging.py
@@ -0,0 +1,35 @@
+from playwright.sync_api import sync_playwright
+
+# Example: Capturing console logs during browser automation
+
+url = 'http://localhost:5173'  # Replace with your URL
+
+console_logs = []
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page(viewport={'width': 1920, 'height': 1080})
+
+    # Set up console log capture
+    def handle_console_message(msg):
+        console_logs.append(f"[{msg.type}] {msg.text}")
+        print(f"Console: [{msg.type}] {msg.text}")
+
+    page.on("console", handle_console_message)
+
+    # Navigate to page
+    page.goto(url)
+    page.wait_for_load_state('networkidle')
+
+    # Interact with the page (triggers console logs)
+    page.click('text=Dashboard')
+    page.wait_for_timeout(1000)
+
+    browser.close()
+
+# Save console logs to file
+with open('/mnt/user-data/outputs/console.log', 'w') as f:
+    f.write('\n'.join(console_logs))
+
+print(f"\nCaptured {len(console_logs)} console messages")
+print(f"Logs saved to: /mnt/user-data/outputs/console.log")
\ No newline at end of file
diff --git a/.agents/skills/webapp-testing/examples/element_discovery.py b/.agents/skills/webapp-testing/examples/element_discovery.py
new file mode 100644
index 0000000..917ba72
--- /dev/null
+++ b/.agents/skills/webapp-testing/examples/element_discovery.py
@@ -0,0 +1,40 @@
+from playwright.sync_api import sync_playwright
+
+# Example: Discovering buttons and other elements on a page
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page()
+
+    # Navigate to page and wait for it to fully load
+    page.goto('http://localhost:5173')
+    page.wait_for_load_state('networkidle')
+
+    # Discover all buttons on the page
+    buttons = page.locator('button').all()
+    print(f"Found {len(buttons)} buttons:")
+    for i, button in enumerate(buttons):
+        text = button.inner_text() if button.is_visible() else "[hidden]"
+        print(f"  [{i}] {text}")
+
+    # Discover links
+    links = page.locator('a[href]').all()
+    print(f"\nFound {len(links)} links:")
+    for link in links[:5]:  # Show first 5
+        text = link.inner_text().strip()
+        href = link.get_attribute('href')
+        print(f"  - {text} -> {href}")
+
+    # Discover input fields
+    inputs = page.locator('input, textarea, select').all()
+    print(f"\nFound {len(inputs)} input fields:")
+    for input_elem in inputs:
+        name = input_elem.get_attribute('name') or input_elem.get_attribute('id') or "[unnamed]"
+        input_type = input_elem.get_attribute('type') or 'text'
+        print(f"  - {name} ({input_type})")
+
+    # Take screenshot for visual reference
+    page.screenshot(path='/tmp/page_discovery.png', full_page=True)
+    print("\nScreenshot saved to /tmp/page_discovery.png")
+
+    browser.close()
\ No newline at end of file
diff --git a/.agents/skills/webapp-testing/examples/static_html_automation.py b/.agents/skills/webapp-testing/examples/static_html_automation.py
new file mode 100644
index 0000000..90bbedc
--- /dev/null
+++ b/.agents/skills/webapp-testing/examples/static_html_automation.py
@@ -0,0 +1,33 @@
+from playwright.sync_api import sync_playwright
+import os
+
+# Example: Automating interaction with static HTML files using file:// URLs
+
+html_file_path = os.path.abspath('path/to/your/file.html')
+file_url = f'file://{html_file_path}'
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page(viewport={'width': 1920, 'height': 1080})
+
+    # Navigate to local HTML file
+    page.goto(file_url)
+
+    # Take screenshot
+    page.screenshot(path='/mnt/user-data/outputs/static_page.png', full_page=True)
+
+    # Interact with elements
+    page.click('text=Click Me')
+    page.fill('#name', 'John Doe')
+    page.fill('#email', 'john@example.com')
+
+    # Submit form
+    page.click('button[type="submit"]')
+    page.wait_for_timeout(500)
+
+    # Take final screenshot
+    page.screenshot(path='/mnt/user-data/outputs/after_submit.png', full_page=True)
+
+    browser.close()
+
+print("Static HTML automation completed!")
\ No newline at end of file
diff --git a/.agents/skills/webapp-testing/scripts/with_server.py b/.agents/skills/webapp-testing/scripts/with_server.py
new file mode 100644
index 0000000..431f2eb
--- /dev/null
+++ b/.agents/skills/webapp-testing/scripts/with_server.py
@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""
+Start one or more servers, wait for them to be ready, run a command, then clean up.
+
+Usage:
+    # Single server
+    python scripts/with_server.py --server "npm run dev" --port 5173 -- python automation.py
+    python scripts/with_server.py --server "npm start" --port 3000 -- python test.py
+
+    # Multiple servers
+    python scripts/with_server.py \
+      --server "cd backend && python server.py" --port 3000 \
+      --server "cd frontend && npm run dev" --port 5173 \
+      -- python test.py
+"""
+
+import subprocess
+import socket
+import time
+import sys
+import argparse
+
+def is_server_ready(port, timeout=30):
+    """Wait for server to be ready by polling the port."""
+    start_time = time.time()
+    while time.time() - start_time < timeout:
+        try:
+            with socket.create_connection(('localhost', port), timeout=1):
+                return True
+        except (socket.error, ConnectionRefusedError):
+            time.sleep(0.5)
+    return False
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Run command with one or more servers')
+    parser.add_argument('--server', action='append', dest='servers', required=True, help='Server command (can be repeated)')
+    parser.add_argument('--port', action='append', dest='ports', type=int, required=True, help='Port for each server (must match --server count)')
+    parser.add_argument('--timeout', type=int, default=30, help='Timeout in seconds per server (default: 30)')
+    parser.add_argument('command', nargs=argparse.REMAINDER, help='Command to run after server(s) ready')
+
+    args = parser.parse_args()
+
+    # Remove the '--' separator if present
+    if args.command and args.command[0] == '--':
+        args.command = args.command[1:]
+
+    if not args.command:
+        print("Error: No command specified to run")
+        sys.exit(1)
+
+    # Parse server configurations
+    if len(args.servers) != len(args.ports):
+        print("Error: Number of --server and --port arguments must match")
+        sys.exit(1)
+
+    servers = []
+    for cmd, port in zip(args.servers, args.ports):
+        servers.append({'cmd': cmd, 'port': port})
+
+    server_processes = []
+
+    try:
+        # Start all servers
+        for i, server in enumerate(servers):
+            print(f"Starting server {i+1}/{len(servers)}: {server['cmd']}")
+
+            # Use shell=True to support commands with cd and &&
+            process = subprocess.Popen(
+                server['cmd'],
+                shell=True,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE
+            )
+            server_processes.append(process)
+
+            # Wait for this server to be ready
+            print(f"Waiting for server on port {server['port']}...")
+            if not is_server_ready(server['port'], timeout=args.timeout):
+                raise RuntimeError(f"Server failed to start on port {server['port']} within {args.timeout}s")
+
+            print(f"Server ready on port {server['port']}")
+
+        print(f"\nAll {len(servers)} server(s) ready")
+
+        # Run the command
+        print(f"Running: {' '.join(args.command)}\n")
+        result = subprocess.run(args.command)
+        sys.exit(result.returncode)
+
+    finally:
+        # Clean up all servers
+        print(f"\nStopping {len(server_processes)} server(s)...")
+        for i, process in enumerate(server_processes):
+            try:
+                process.terminate()
+                process.wait(timeout=5)
+            except subprocess.TimeoutExpired:
+                process.kill()
+                process.wait()
+            print(f"Server {i+1} stopped")
+        print("All servers stopped")
+
+
+if __name__ == '__main__':
+    main()
\ No newline at end of file
diff --git a/.agents/skills/write-a-skill/SKILL.md b/.agents/skills/write-a-skill/SKILL.md
new file mode 100644
index 0000000..7339c8a
--- /dev/null
+++ b/.agents/skills/write-a-skill/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: write-a-skill
+description: Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
+---
+
+# Writing Skills
+
+## Process
+
+1. **Gather requirements** - ask user about:
+   - What task/domain does the skill cover?
+   - What specific use cases should it handle?
+   - Does it need executable scripts or just instructions?
+   - Any reference materials to include?
+
+2. **Draft the skill** - create:
+   - SKILL.md with concise instructions
+   - Additional reference files if content exceeds 500 lines
+   - Utility scripts if deterministic operations needed
+
+3. **Review with user** - present draft and ask:
+   - Does this cover your use cases?
+   - Anything missing or unclear?
+   - Should any section be more/less detailed?
+
+## Skill Structure
+
+```
+skill-name/
+├── SKILL.md           # Main instructions (required)
+├── REFERENCE.md       # Detailed docs (if needed)
+├── EXAMPLES.md        # Usage examples (if needed)
+└── scripts/           # Utility scripts (if needed)
+    └── helper.js
+```
+
+## SKILL.md Template
+
+```md
+---
+name: skill-name
+description: Brief description of capability. Use when [specific triggers].
+---
+
+# Skill Name
+
+## Quick start
+
+[Minimal working example]
+
+## Workflows
+
+[Step-by-step processes with checklists for complex tasks]
+
+## Advanced features
+
+[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
+```
+
+## Description Requirements
+
+The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
+
+**Goal**: Give your agent just enough info to know:
+
+1. What capability this skill provides
+2. When/why to trigger it (specific keywords, contexts, file types)
+
+**Format**:
+
+- Max 1024 chars
+- Write in third person
+- First sentence: what it does
+- Second sentence: "Use when [specific triggers]"
+
+**Good example**:
+
+```
+Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
+```
+
+**Bad example**:
+
+```
+Helps with documents.
+```
+
+The bad example gives your agent no way to distinguish this from other document skills.
+
+## When to Add Scripts
+
+Add utility scripts when:
+
+- Operation is deterministic (validation, formatting)
+- Same code would be generated repeatedly
+- Errors need explicit handling
+
+Scripts save tokens and improve reliability vs generated code.
+
+## When to Split Files
+
+Split into separate files when:
+
+- SKILL.md exceeds 100 lines
+- Content has distinct domains (finance vs sales schemas)
+- Advanced features are rarely needed
+
+## Review Checklist
+
+After drafting, verify:
+
+- [ ] Description includes triggers ("Use when...")
+- [ ] SKILL.md under 100 lines
+- [ ] No time-sensitive info
+- [ ] Consistent terminology
+- [ ] Concrete examples included
+- [ ] References one level deep
diff --git a/.agents/skills/zoom-out/SKILL.md b/.agents/skills/zoom-out/SKILL.md
new file mode 100644
index 0000000..1e7a5dc
--- /dev/null
+++ b/.agents/skills/zoom-out/SKILL.md
@@ -0,0 +1,7 @@
+---
+name: zoom-out
+description: Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
+disable-model-invocation: true
+---
+
+I don't know this area of code well. Go up a layer of abstraction. Give me a map of all the relevant modules and callers, using the project's domain glossary vocabulary.
diff --git a/.claude/skills/agent-memory-mcp/SKILL.md b/.claude/skills/agent-memory-mcp/SKILL.md
new file mode 100644
index 0000000..45d9651
--- /dev/null
+++ b/.claude/skills/agent-memory-mcp/SKILL.md
@@ -0,0 +1,82 @@
+---
+name: agent-memory-mcp
+author: Amit Rathiesh
+description: A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions).
+---
+
+# Agent Memory Skill
+
+This skill provides a persistent, searchable memory bank that automatically syncs with project documentation. It runs as an MCP server to allow reading/writing/searching of long-term memories.
+
+## Prerequisites
+
+- Node.js (v18+)
+
+## Setup
+
+1. **Clone the Repository**:
+   Clone the `agentMemory` project into your agent's workspace or a parallel directory:
+
+   ```bash
+   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
+   ```
+
+2. **Install Dependencies**:
+
+   ```bash
+   cd .agent/skills/agent-memory
+   npm install
+   npm run compile
+   ```
+
+3. **Start the MCP Server**:
+   Use the helper script to activate the memory bank for your current project:
+
+   ```bash
+   npm run start-server <project_id> <absolute_path_to_target_workspace>
+   ```
+
+   _Example for current directory:_
+
+   ```bash
+   npm run start-server my-project $(pwd)
+   ```
+
+## Capabilities (MCP Tools)
+
+### `memory_search`
+
+Search for memories by query, type, or tags.
+
+- **Args**: `query` (string), `type?` (string), `tags?` (string[])
+- **Usage**: "Find all authentication patterns" -> `memory_search({ query: "authentication", type: "pattern" })`
+
+### `memory_write`
+
+Record new knowledge or decisions.
+
+- **Args**: `key` (string), `type` (string), `content` (string), `tags?` (string[])
+- **Usage**: "Save this architecture decision" -> `memory_write({ key: "auth-v1", type: "decision", content: "..." })`
+
+### `memory_read`
+
+Retrieve specific memory content by key.
+
+- **Args**: `key` (string)
+- **Usage**: "Get the auth design" -> `memory_read({ key: "auth-v1" })`
+
+### `memory_stats`
+
+View analytics on memory usage.
+
+- **Usage**: "Show memory statistics" -> `memory_stats({})`
+
+## Dashboard
+
+This skill includes a standalone dashboard to visualize memory usage.
+
+```bash
+npm run start-dashboard <absolute_path_to_target_workspace>
+```
+
+Access at: `http://localhost:3333`
diff --git a/.claude/skills/agent-memory-systems/SKILL.md b/.claude/skills/agent-memory-systems/SKILL.md
new file mode 100644
index 0000000..ee79118
--- /dev/null
+++ b/.claude/skills/agent-memory-systems/SKILL.md
@@ -0,0 +1,67 @@
+---
+name: agent-memory-systems
+description: "Memory is the cornerstone of intelligent agents. Without it, every interaction starts from zero. This skill covers the architecture of agent memory: short-term (context window), long-term (vector stores), and the cognitive architectures that organize them.  Key insight: Memory isn't just storage - it's retrieval. A million stored facts mean nothing if you can't find the right one. Chunking, embedding, and retrieval strategies determine whether your agent remembers or forgets.  The field is fragm"
+source: vibeship-spawner-skills (Apache 2.0)
+---
+
+# Agent Memory Systems
+
+You are a cognitive architect who understands that memory makes agents intelligent.
+You've built memory systems for agents handling millions of interactions. You know
+that the hard part isn't storing - it's retrieving the right memory at the right time.
+
+Your core insight: Memory failures look like intelligence failures. When an agent
+"forgets" or gives inconsistent answers, it's almost always a retrieval problem,
+not a storage problem. You obsess over chunking strategies, embedding quality,
+and
+
+## Capabilities
+
+- agent-memory
+- long-term-memory
+- short-term-memory
+- working-memory
+- episodic-memory
+- semantic-memory
+- procedural-memory
+- memory-retrieval
+- memory-formation
+- memory-decay
+
+## Patterns
+
+### Memory Type Architecture
+
+Choosing the right memory type for different information
+
+### Vector Store Selection Pattern
+
+Choosing the right vector database for your use case
+
+### Chunking Strategy Pattern
+
+Breaking documents into retrievable chunks
+
+## Anti-Patterns
+
+### ❌ Store Everything Forever
+
+### ❌ Chunk Without Testing Retrieval
+
+### ❌ Single Memory Type for All Data
+
+## ⚠️ Sharp Edges
+
+| Issue | Severity | Solution |
+|-------|----------|----------|
+| Issue | critical | ## Contextual Chunking (Anthropic's approach) |
+| Issue | high | ## Test different sizes |
+| Issue | high | ## Always filter by metadata first |
+| Issue | high | ## Add temporal scoring |
+| Issue | medium | ## Detect conflicts on storage |
+| Issue | medium | ## Budget tokens for different memory types |
+| Issue | medium | ## Track embedding model in metadata |
+
+## Related Skills
+
+Works well with: `autonomous-agents`, `multi-agent-orchestration`, `llm-architect`, `agent-tool-builder`
diff --git a/.claude/skills/caveman/SKILL.md b/.claude/skills/caveman/SKILL.md
new file mode 100644
index 0000000..85770a3
--- /dev/null
+++ b/.claude/skills/caveman/SKILL.md
@@ -0,0 +1,49 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode. Cuts token usage ~75% by dropping
+  filler, articles, and pleasantries while keeping full technical accuracy.
+  Use when user says "caveman mode", "talk like caveman", "use caveman",
+  "less tokens", "be brief", or invokes /caveman.
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode".
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough.
+
+Technical terms stay exact. Code blocks unchanged. Errors quoted exact.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+### Examples
+
+**"Why React component re-render?"**
+
+> Inline obj prop -> new ref -> re-render. `useMemo`.
+
+**"Explain database connection pooling."**
+
+> Pool = reuse DB conn. Skip handshake -> fast under load.
+
+## Auto-Clarity Exception
+
+Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
+
+Example -- destructive op:
+
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+>
+> ```sql
+> DROP TABLE users;
+> ```
+>
+> Caveman resume. Verify backup exist first.
diff --git a/.claude/skills/changelog-automation/SKILL.md b/.claude/skills/changelog-automation/SKILL.md
new file mode 100644
index 0000000..0c05a4e
--- /dev/null
+++ b/.claude/skills/changelog-automation/SKILL.md
@@ -0,0 +1,580 @@
+---
+name: changelog-automation
+description: Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.
+---
+
+# Changelog Automation
+
+Patterns and tools for automating changelog generation, release notes, and version management following industry standards.
+
+## When to Use This Skill
+
+- Setting up automated changelog generation
+- Implementing Conventional Commits
+- Creating release note workflows
+- Standardizing commit message formats
+- Generating GitHub/GitLab release notes
+- Managing semantic versioning
+
+## Core Concepts
+
+### 1. Keep a Changelog Format
+
+```markdown
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- New feature X
+
+## [1.2.0] - 2024-01-15
+
+### Added
+
+- User profile avatars
+- Dark mode support
+
+### Changed
+
+- Improved loading performance by 40%
+
+### Deprecated
+
+- Old authentication API (use v2)
+
+### Removed
+
+- Legacy payment gateway
+
+### Fixed
+
+- Login timeout issue (#123)
+
+### Security
+
+- Updated dependencies for CVE-2024-1234
+
+[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
+```
+
+### 2. Conventional Commits
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+| Type       | Description      | Changelog Section  |
+| ---------- | ---------------- | ------------------ |
+| `feat`     | New feature      | Added              |
+| `fix`      | Bug fix          | Fixed              |
+| `docs`     | Documentation    | (usually excluded) |
+| `style`    | Formatting       | (usually excluded) |
+| `refactor` | Code restructure | Changed            |
+| `perf`     | Performance      | Changed            |
+| `test`     | Tests            | (usually excluded) |
+| `chore`    | Maintenance      | (usually excluded) |
+| `ci`       | CI changes       | (usually excluded) |
+| `build`    | Build system     | (usually excluded) |
+| `revert`   | Revert commit    | Removed            |
+
+### 3. Semantic Versioning
+
+```
+MAJOR.MINOR.PATCH
+
+MAJOR: Breaking changes (feat! or BREAKING CHANGE)
+MINOR: New features (feat)
+PATCH: Bug fixes (fix)
+```
+
+## Implementation
+
+### Method 1: Conventional Changelog (Node.js)
+
+```bash
+# Install tools
+npm install -D @commitlint/cli @commitlint/config-conventional
+npm install -D husky
+npm install -D standard-version
+# or
+npm install -D semantic-release
+
+# Setup commitlint
+cat > commitlint.config.js << 'EOF'
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',
+        'fix',
+        'docs',
+        'style',
+        'refactor',
+        'perf',
+        'test',
+        'chore',
+        'ci',
+        'build',
+        'revert',
+      ],
+    ],
+    'subject-case': [2, 'never', ['start-case', 'pascal-case', 'upper-case']],
+    'subject-max-length': [2, 'always', 72],
+  },
+};
+EOF
+
+# Setup husky
+npx husky init
+echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg
+```
+
+### Method 2: standard-version Configuration
+
+```javascript
+// .versionrc.js
+module.exports = {
+  types: [
+    { type: "feat", section: "Features" },
+    { type: "fix", section: "Bug Fixes" },
+    { type: "perf", section: "Performance Improvements" },
+    { type: "revert", section: "Reverts" },
+    { type: "docs", section: "Documentation", hidden: true },
+    { type: "style", section: "Styles", hidden: true },
+    { type: "chore", section: "Miscellaneous", hidden: true },
+    { type: "refactor", section: "Code Refactoring", hidden: true },
+    { type: "test", section: "Tests", hidden: true },
+    { type: "build", section: "Build System", hidden: true },
+    { type: "ci", section: "CI/CD", hidden: true },
+  ],
+  commitUrlFormat: "{{host}}/{{owner}}/{{repository}}/commit/{{hash}}",
+  compareUrlFormat:
+    "{{host}}/{{owner}}/{{repository}}/compare/{{previousTag}}...{{currentTag}}",
+  issueUrlFormat: "{{host}}/{{owner}}/{{repository}}/issues/{{id}}",
+  userUrlFormat: "{{host}}/{{user}}",
+  releaseCommitMessageFormat: "chore(release): {{currentTag}}",
+  scripts: {
+    prebump: 'echo "Running prebump"',
+    postbump: 'echo "Running postbump"',
+    prechangelog: 'echo "Running prechangelog"',
+    postchangelog: 'echo "Running postchangelog"',
+  },
+};
+```
+
+```json
+// package.json scripts
+{
+  "scripts": {
+    "release": "standard-version",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:patch": "standard-version --release-as patch",
+    "release:dry": "standard-version --dry-run"
+  }
+}
+```
+
+### Method 3: semantic-release (Full Automation)
+
+```javascript
+// release.config.js
+module.exports = {
+  branches: [
+    "main",
+    { name: "beta", prerelease: true },
+    { name: "alpha", prerelease: true },
+  ],
+  plugins: [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    [
+      "@semantic-release/changelog",
+      {
+        changelogFile: "CHANGELOG.md",
+      },
+    ],
+    [
+      "@semantic-release/npm",
+      {
+        npmPublish: true,
+      },
+    ],
+    [
+      "@semantic-release/github",
+      {
+        assets: ["dist/**/*.js", "dist/**/*.css"],
+      },
+    ],
+    [
+      "@semantic-release/git",
+      {
+        assets: ["CHANGELOG.md", "package.json"],
+        message:
+          "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}",
+      },
+    ],
+  ],
+};
+```
+
+### Method 4: GitHub Actions Workflow
+
+```yaml
+# .github/workflows/release.yml
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      release_type:
+        description: "Release type"
+        required: true
+        default: "patch"
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - run: npm ci
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Run semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release
+
+  # Alternative: manual release with standard-version
+  manual-release:
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - run: npm ci
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version and generate changelog
+        run: npx standard-version --release-as ${{ inputs.release_type }}
+
+      - name: Push changes
+        run: git push --follow-tags origin main
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          body_path: RELEASE_NOTES.md
+          generate_release_notes: true
+```
+
+### Method 5: git-cliff (Rust-based, Fast)
+
+```toml
+# cliff.toml
+[changelog]
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+"""
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [Unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | upper_first }}
+    {% for commit in commits %}
+        - {% if commit.scope %}**{{ commit.scope }}:** {% endif %}\
+            {{ commit.message | upper_first }}\
+            {% if commit.github.pr_number %} ([#{{ commit.github.pr_number }}](https://github.com/owner/repo/pull/{{ commit.github.pr_number }})){% endif %}\
+    {% endfor %}
+{% endfor %}
+"""
+footer = """
+{% for release in releases -%}
+    {% if release.version -%}
+        {% if release.previous.version -%}
+            [{{ release.version | trim_start_matches(pat="v") }}]: \
+                https://github.com/owner/repo/compare/{{ release.previous.version }}...{{ release.version }}
+        {% endif -%}
+    {% else -%}
+        [unreleased]: https://github.com/owner/repo/compare/{{ release.previous.version }}...HEAD
+    {% endif -%}
+{% endfor %}
+"""
+trim = true
+
+[git]
+conventional_commits = true
+filter_unconventional = true
+split_commits = false
+commit_parsers = [
+    { message = "^feat", group = "Features" },
+    { message = "^fix", group = "Bug Fixes" },
+    { message = "^doc", group = "Documentation" },
+    { message = "^perf", group = "Performance" },
+    { message = "^refactor", group = "Refactoring" },
+    { message = "^style", group = "Styling" },
+    { message = "^test", group = "Testing" },
+    { message = "^chore\\(release\\)", skip = true },
+    { message = "^chore", group = "Miscellaneous" },
+]
+filter_commits = false
+tag_pattern = "v[0-9]*"
+skip_tags = ""
+ignore_tags = ""
+topo_order = false
+sort_commits = "oldest"
+
+[github]
+owner = "owner"
+repo = "repo"
+```
+
+```bash
+# Generate changelog
+git cliff -o CHANGELOG.md
+
+# Generate for specific range
+git cliff v1.0.0..v2.0.0 -o RELEASE_NOTES.md
+
+# Preview without writing
+git cliff --unreleased --dry-run
+```
+
+### Method 6: Python (commitizen)
+
+```toml
+# pyproject.toml
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "1.0.0"
+version_files = [
+    "pyproject.toml:version",
+    "src/__init__.py:__version__",
+]
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_incremental = true
+changelog_start_rev = "v0.1.0"
+
+[tool.commitizen.customize]
+message_template = "{{change_type}}{% if scope %}({{scope}}){% endif %}: {{message}}"
+schema = "<type>(<scope>): <subject>"
+schema_pattern = "^(feat|fix|docs|style|refactor|perf|test|chore)(\\(\\w+\\))?:\\s.*"
+bump_pattern = "^(feat|fix|perf|refactor)"
+bump_map = {"feat" = "MINOR", "fix" = "PATCH", "perf" = "PATCH", "refactor" = "PATCH"}
+```
+
+```bash
+# Install
+pip install commitizen
+
+# Create commit interactively
+cz commit
+
+# Bump version and update changelog
+cz bump --changelog
+
+# Check commits
+cz check --rev-range HEAD~5..HEAD
+```
+
+## Release Notes Templates
+
+### GitHub Release Template
+
+```markdown
+## What's Changed
+
+### 🚀 Features
+
+{{ range .Features }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+### 🐛 Bug Fixes
+
+{{ range .Fixes }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+### 📚 Documentation
+
+{{ range .Docs }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+### 🔧 Maintenance
+
+{{ range .Chores }}
+
+- {{ .Title }} by @{{ .Author }} in #{{ .PR }}
+  {{ end }}
+
+## New Contributors
+
+{{ range .NewContributors }}
+
+- @{{ .Username }} made their first contribution in #{{ .PR }}
+  {{ end }}
+
+**Full Changelog**: https://github.com/owner/repo/compare/v{{ .Previous }}...v{{ .Current }}
+```
+
+### Internal Release Notes
+
+```markdown
+# Release v2.1.0 - January 15, 2024
+
+## Summary
+
+This release introduces dark mode support and improves checkout performance
+by 40%. It also includes important security updates.
+
+## Highlights
+
+### 🌙 Dark Mode
+
+Users can now switch to dark mode from settings. The preference is
+automatically saved and synced across devices.
+
+### ⚡ Performance
+
+- Checkout flow is 40% faster
+- Reduced bundle size by 15%
+
+## Breaking Changes
+
+None in this release.
+
+## Upgrade Guide
+
+No special steps required. Standard deployment process applies.
+
+## Known Issues
+
+- Dark mode may flicker on initial load (fix scheduled for v2.1.1)
+
+## Dependencies Updated
+
+| Package | From    | To      | Reason                   |
+| ------- | ------- | ------- | ------------------------ |
+| react   | 18.2.0  | 18.3.0  | Performance improvements |
+| lodash  | 4.17.20 | 4.17.21 | Security patch           |
+```
+
+## Commit Message Examples
+
+```bash
+# Feature with scope
+feat(auth): add OAuth2 support for Google login
+
+# Bug fix with issue reference
+fix(checkout): resolve race condition in payment processing
+
+Closes #123
+
+# Breaking change
+feat(api)!: change user endpoint response format
+
+BREAKING CHANGE: The user endpoint now returns `userId` instead of `id`.
+Migration guide: Update all API consumers to use the new field name.
+
+# Multiple paragraphs
+fix(database): handle connection timeouts gracefully
+
+Previously, connection timeouts would cause the entire request to fail
+without retry. This change implements exponential backoff with up to
+3 retries before failing.
+
+The timeout threshold has been increased from 5s to 10s based on p99
+latency analysis.
+
+Fixes #456
+Reviewed-by: @alice
+```
+
+## Best Practices
+
+### Do's
+
+- **Follow Conventional Commits** - Enables automation
+- **Write clear messages** - Future you will thank you
+- **Reference issues** - Link commits to tickets
+- **Use scopes consistently** - Define team conventions
+- **Automate releases** - Reduce manual errors
+
+### Don'ts
+
+- **Don't mix changes** - One logical change per commit
+- **Don't skip validation** - Use commitlint
+- **Don't manual edit** - Generated changelogs only
+- **Don't forget breaking changes** - Mark with `!` or footer
+- **Don't ignore CI** - Validate commits in pipeline
+
+## Resources
+
+- [Keep a Changelog](https://keepachangelog.com/)
+- [Conventional Commits](https://www.conventionalcommits.org/)
+- [Semantic Versioning](https://semver.org/)
+- [semantic-release](https://semantic-release.gitbook.io/)
+- [git-cliff](https://git-cliff.org/)
diff --git a/.claude/skills/changelog-generator/SKILL.md b/.claude/skills/changelog-generator/SKILL.md
new file mode 100644
index 0000000..72919de
--- /dev/null
+++ b/.claude/skills/changelog-generator/SKILL.md
@@ -0,0 +1,104 @@
+---
+name: changelog-generator
+description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+---
+
+# Changelog Generator
+
+This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
+
+## When to Use This Skill
+
+- Preparing release notes for a new version
+- Creating weekly or monthly product update summaries
+- Documenting changes for customers
+- Writing changelog entries for app store submissions
+- Generating update notifications
+- Creating internal release documentation
+- Maintaining a public changelog/product updates page
+
+## What This Skill Does
+
+1. **Scans Git History**: Analyzes commits from a specific time period or between versions
+2. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
+3. **Translates Technical → User-Friendly**: Converts developer commits into customer language
+4. **Formats Professionally**: Creates clean, structured changelog entries
+5. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.)
+6. **Follows Best Practices**: Applies changelog guidelines and your brand voice
+
+## How to Use
+
+### Basic Usage
+
+From your project repository:
+
+```
+Create a changelog from commits since last release
+```
+
+```
+Generate changelog for all commits from the past week
+```
+
+```
+Create release notes for version 2.5.0
+```
+
+### With Specific Date Range
+
+```
+Create a changelog for all commits between March 1 and March 15
+```
+
+### With Custom Guidelines
+
+```
+Create a changelog for commits since v2.4.0, using my changelog 
+guidelines from CHANGELOG_STYLE.md
+```
+
+## Example
+
+**User**: "Create a changelog for commits from the past 7 days"
+
+**Output**:
+```markdown
+# Updates - Week of March 10, 2024
+
+## ✨ New Features
+
+- **Team Workspaces**: Create separate workspaces for different 
+  projects. Invite team members and keep everything organized.
+
+- **Keyboard Shortcuts**: Press ? to see all available shortcuts. 
+  Navigate faster without touching your mouse.
+
+## 🔧 Improvements
+
+- **Faster Sync**: Files now sync 2x faster across devices
+- **Better Search**: Search now includes file contents, not just titles
+
+## 🐛 Fixes
+
+- Fixed issue where large images wouldn't upload
+- Resolved timezone confusion in scheduled posts
+- Corrected notification badge count
+```
+
+**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter
+
+## Tips
+
+- Run from your git repository root
+- Specify date ranges for focused changelogs
+- Use your CHANGELOG_STYLE.md for consistent formatting
+- Review and adjust the generated changelog before publishing
+- Save output directly to CHANGELOG.md
+
+## Related Use Cases
+
+- Creating GitHub release notes
+- Writing app store update descriptions
+- Generating email updates for users
+- Creating social media announcement posts
+
diff --git a/.claude/skills/code-review-checklist/SKILL.md b/.claude/skills/code-review-checklist/SKILL.md
new file mode 100644
index 0000000..a00a47b
--- /dev/null
+++ b/.claude/skills/code-review-checklist/SKILL.md
@@ -0,0 +1,444 @@
+---
+name: code-review-checklist
+description: "Comprehensive checklist for conducting thorough code reviews covering functionality, security, performance, and maintainability"
+---
+
+# Code Review Checklist
+
+## Overview
+
+Provide a systematic checklist for conducting thorough code reviews. This skill helps reviewers ensure code quality, catch bugs, identify security issues, and maintain consistency across the codebase.
+
+## When to Use This Skill
+
+- Use when reviewing pull requests
+- Use when conducting code audits
+- Use when establishing code review standards for a team
+- Use when training new developers on code review practices
+- Use when you want to ensure nothing is missed in reviews
+- Use when creating code review documentation
+
+## How It Works
+
+### Step 1: Understand the Context
+
+Before reviewing code, I'll help you understand:
+- What problem does this code solve?
+- What are the requirements?
+- What files were changed and why?
+- Are there related issues or tickets?
+- What's the testing strategy?
+
+### Step 2: Review Functionality
+
+Check if the code works correctly:
+- Does it solve the stated problem?
+- Are edge cases handled?
+- Is error handling appropriate?
+- Are there any logical errors?
+- Does it match the requirements?
+
+### Step 3: Review Code Quality
+
+Assess code maintainability:
+- Is the code readable and clear?
+- Are names descriptive?
+- Is it properly structured?
+- Are functions/methods focused?
+- Is there unnecessary complexity?
+
+### Step 4: Review Security
+
+Check for security issues:
+- Are inputs validated?
+- Is sensitive data protected?
+- Are there SQL injection risks?
+- Is authentication/authorization correct?
+- Are dependencies secure?
+
+### Step 5: Review Performance
+
+Look for performance issues:
+- Are there unnecessary loops?
+- Is database access optimized?
+- Are there memory leaks?
+- Is caching used appropriately?
+- Are there N+1 query problems?
+
+### Step 6: Review Tests
+
+Verify test coverage:
+- Are there tests for new code?
+- Do tests cover edge cases?
+- Are tests meaningful?
+- Do all tests pass?
+- Is test coverage adequate?
+
+## Examples
+
+### Example 1: Functionality Review Checklist
+
+```markdown
+## Functionality Review
+
+### Requirements
+- [ ] Code solves the stated problem
+- [ ] All acceptance criteria are met
+- [ ] Edge cases are handled
+- [ ] Error cases are handled
+- [ ] User input is validated
+
+### Logic
+- [ ] No logical errors or bugs
+- [ ] Conditions are correct (no off-by-one errors)
+- [ ] Loops terminate correctly
+- [ ] Recursion has proper base cases
+- [ ] State management is correct
+
+### Error Handling
+- [ ] Errors are caught appropriately
+- [ ] Error messages are clear and helpful
+- [ ] Errors don't expose sensitive information
+- [ ] Failed operations are rolled back
+- [ ] Logging is appropriate
+
+### Example Issues to Catch:
+
+**❌ Bad - Missing validation:**
+\`\`\`javascript
+function createUser(email, password) {
+  // No validation!
+  return db.users.create({ email, password });
+}
+\`\`\`
+
+**✅ Good - Proper validation:**
+\`\`\`javascript
+function createUser(email, password) {
+  if (!email || !isValidEmail(email)) {
+    throw new Error('Invalid email address');
+  }
+  if (!password || password.length < 8) {
+    throw new Error('Password must be at least 8 characters');
+  }
+  return db.users.create({ email, password });
+}
+\`\`\`
+```
+
+### Example 2: Security Review Checklist
+
+```markdown
+## Security Review
+
+### Input Validation
+- [ ] All user inputs are validated
+- [ ] SQL injection is prevented (use parameterized queries)
+- [ ] XSS is prevented (escape output)
+- [ ] CSRF protection is in place
+- [ ] File uploads are validated (type, size, content)
+
+### Authentication & Authorization
+- [ ] Authentication is required where needed
+- [ ] Authorization checks are present
+- [ ] Passwords are hashed (never stored plain text)
+- [ ] Sessions are managed securely
+- [ ] Tokens expire appropriately
+
+### Data Protection
+- [ ] Sensitive data is encrypted
+- [ ] API keys are not hardcoded
+- [ ] Environment variables are used for secrets
+- [ ] Personal data follows privacy regulations
+- [ ] Database credentials are secure
+
+### Dependencies
+- [ ] No known vulnerable dependencies
+- [ ] Dependencies are up to date
+- [ ] Unnecessary dependencies are removed
+- [ ] Dependency versions are pinned
+
+### Example Issues to Catch:
+
+**❌ Bad - SQL injection risk:**
+\`\`\`javascript
+const query = \`SELECT * FROM users WHERE email = '\${email}'\`;
+db.query(query);
+\`\`\`
+
+**✅ Good - Parameterized query:**
+\`\`\`javascript
+const query = 'SELECT * FROM users WHERE email = $1';
+db.query(query, [email]);
+\`\`\`
+
+**❌ Bad - Hardcoded secret:**
+\`\`\`javascript
+const API_KEY = 'sk_live_abc123xyz';
+\`\`\`
+
+**✅ Good - Environment variable:**
+\`\`\`javascript
+const API_KEY = process.env.API_KEY;
+if (!API_KEY) {
+  throw new Error('API_KEY environment variable is required');
+}
+\`\`\`
+```
+
+### Example 3: Code Quality Review Checklist
+
+```markdown
+## Code Quality Review
+
+### Readability
+- [ ] Code is easy to understand
+- [ ] Variable names are descriptive
+- [ ] Function names explain what they do
+- [ ] Complex logic has comments
+- [ ] Magic numbers are replaced with constants
+
+### Structure
+- [ ] Functions are small and focused
+- [ ] Code follows DRY principle (Don't Repeat Yourself)
+- [ ] Proper separation of concerns
+- [ ] Consistent code style
+- [ ] No dead code or commented-out code
+
+### Maintainability
+- [ ] Code is modular and reusable
+- [ ] Dependencies are minimal
+- [ ] Changes are backwards compatible
+- [ ] Breaking changes are documented
+- [ ] Technical debt is noted
+
+### Example Issues to Catch:
+
+**❌ Bad - Unclear naming:**
+\`\`\`javascript
+function calc(a, b, c) {
+  return a * b + c;
+}
+\`\`\`
+
+**✅ Good - Descriptive naming:**
+\`\`\`javascript
+function calculateTotalPrice(quantity, unitPrice, tax) {
+  return quantity * unitPrice + tax;
+}
+\`\`\`
+
+**❌ Bad - Function doing too much:**
+\`\`\`javascript
+function processOrder(order) {
+  // Validate order
+  if (!order.items) throw new Error('No items');
+  
+  // Calculate total
+  let total = 0;
+  for (let item of order.items) {
+    total += item.price * item.quantity;
+  }
+  
+  // Apply discount
+  if (order.coupon) {
+    total *= 0.9;
+  }
+  
+  // Process payment
+  const payment = stripe.charge(total);
+  
+  // Send email
+  sendEmail(order.email, 'Order confirmed');
+  
+  // Update inventory
+  updateInventory(order.items);
+  
+  return { orderId: order.id, total };
+}
+\`\`\`
+
+**✅ Good - Separated concerns:**
+\`\`\`javascript
+function processOrder(order) {
+  validateOrder(order);
+  const total = calculateOrderTotal(order);
+  const payment = processPayment(total);
+  sendOrderConfirmation(order.email);
+  updateInventory(order.items);
+  
+  return { orderId: order.id, total };
+}
+\`\`\`
+```
+
+## Best Practices
+
+### ✅ Do This
+
+- **Review Small Changes** - Smaller PRs are easier to review thoroughly
+- **Check Tests First** - Verify tests pass and cover new code
+- **Run the Code** - Test it locally when possible
+- **Ask Questions** - Don't assume, ask for clarification
+- **Be Constructive** - Suggest improvements, don't just criticize
+- **Focus on Important Issues** - Don't nitpick minor style issues
+- **Use Automated Tools** - Linters, formatters, security scanners
+- **Review Documentation** - Check if docs are updated
+- **Consider Performance** - Think about scale and efficiency
+- **Check for Regressions** - Ensure existing functionality still works
+
+### ❌ Don't Do This
+
+- **Don't Approve Without Reading** - Actually review the code
+- **Don't Be Vague** - Provide specific feedback with examples
+- **Don't Ignore Security** - Security issues are critical
+- **Don't Skip Tests** - Untested code will cause problems
+- **Don't Be Rude** - Be respectful and professional
+- **Don't Rubber Stamp** - Every review should add value
+- **Don't Review When Tired** - You'll miss important issues
+- **Don't Forget Context** - Understand the bigger picture
+
+## Complete Review Checklist
+
+### Pre-Review
+- [ ] Read the PR description and linked issues
+- [ ] Understand what problem is being solved
+- [ ] Check if tests pass in CI/CD
+- [ ] Pull the branch and run it locally
+
+### Functionality
+- [ ] Code solves the stated problem
+- [ ] Edge cases are handled
+- [ ] Error handling is appropriate
+- [ ] User input is validated
+- [ ] No logical errors
+
+### Security
+- [ ] No SQL injection vulnerabilities
+- [ ] No XSS vulnerabilities
+- [ ] Authentication/authorization is correct
+- [ ] Sensitive data is protected
+- [ ] No hardcoded secrets
+
+### Performance
+- [ ] No unnecessary database queries
+- [ ] No N+1 query problems
+- [ ] Efficient algorithms used
+- [ ] No memory leaks
+- [ ] Caching used appropriately
+
+### Code Quality
+- [ ] Code is readable and clear
+- [ ] Names are descriptive
+- [ ] Functions are focused and small
+- [ ] No code duplication
+- [ ] Follows project conventions
+
+### Tests
+- [ ] New code has tests
+- [ ] Tests cover edge cases
+- [ ] Tests are meaningful
+- [ ] All tests pass
+- [ ] Test coverage is adequate
+
+### Documentation
+- [ ] Code comments explain why, not what
+- [ ] API documentation is updated
+- [ ] README is updated if needed
+- [ ] Breaking changes are documented
+- [ ] Migration guide provided if needed
+
+### Git
+- [ ] Commit messages are clear
+- [ ] No merge conflicts
+- [ ] Branch is up to date with main
+- [ ] No unnecessary files committed
+- [ ] .gitignore is properly configured
+
+## Common Pitfalls
+
+### Problem: Missing Edge Cases
+**Symptoms:** Code works for happy path but fails on edge cases
+**Solution:** Ask "What if...?" questions
+- What if the input is null?
+- What if the array is empty?
+- What if the user is not authenticated?
+- What if the network request fails?
+
+### Problem: Security Vulnerabilities
+**Symptoms:** Code exposes security risks
+**Solution:** Use security checklist
+- Run security scanners (npm audit, Snyk)
+- Check OWASP Top 10
+- Validate all inputs
+- Use parameterized queries
+- Never trust user input
+
+### Problem: Poor Test Coverage
+**Symptoms:** New code has no tests or inadequate tests
+**Solution:** Require tests for all new code
+- Unit tests for functions
+- Integration tests for features
+- Edge case tests
+- Error case tests
+
+### Problem: Unclear Code
+**Symptoms:** Reviewer can't understand what code does
+**Solution:** Request improvements
+- Better variable names
+- Explanatory comments
+- Smaller functions
+- Clear structure
+
+## Review Comment Templates
+
+### Requesting Changes
+```markdown
+**Issue:** [Describe the problem]
+
+**Current code:**
+\`\`\`javascript
+// Show problematic code
+\`\`\`
+
+**Suggested fix:**
+\`\`\`javascript
+// Show improved code
+\`\`\`
+
+**Why:** [Explain why this is better]
+```
+
+### Asking Questions
+```markdown
+**Question:** [Your question]
+
+**Context:** [Why you're asking]
+
+**Suggestion:** [If you have one]
+```
+
+### Praising Good Code
+```markdown
+**Nice!** [What you liked]
+
+This is great because [explain why]
+```
+
+## Related Skills
+
+- `@requesting-code-review` - Prepare code for review
+- `@receiving-code-review` - Handle review feedback
+- `@systematic-debugging` - Debug issues found in review
+- `@test-driven-development` - Ensure code has tests
+
+## Additional Resources
+
+- [Google Code Review Guidelines](https://google.github.io/eng-practices/review/)
+- [OWASP Top 10](https://owasp.org/www-project-top-ten/)
+- [Code Review Best Practices](https://github.com/thoughtbot/guides/tree/main/code-review)
+- [How to Review Code](https://www.kevinlondon.com/2015/05/05/code-review-best-practices.html)
+
+---
+
+**Pro Tip:** Use a checklist template for every review to ensure consistency and thoroughness. Customize it for your team's specific needs!
diff --git a/.claude/skills/code-review/SKILL.md b/.claude/skills/code-review/SKILL.md
new file mode 100644
index 0000000..621007b
--- /dev/null
+++ b/.claude/skills/code-review/SKILL.md
@@ -0,0 +1,102 @@
+---
+name: code-review
+description: Perform code reviews following Sentry engineering practices. Use when reviewing pull requests, examining code changes, or providing feedback on code quality. Covers security, performance, testing, and design review.
+---
+
+# Sentry Code Review
+
+Follow these guidelines when reviewing code for Sentry projects.
+
+## Review Checklist
+
+### Identifying Problems
+
+Look for these issues in code changes:
+
+- **Runtime errors**: Potential exceptions, null pointer issues, out-of-bounds access
+- **Performance**: Unbounded O(n²) operations, N+1 queries, unnecessary allocations
+- **Side effects**: Unintended behavioral changes affecting other components
+- **Backwards compatibility**: Breaking API changes without migration path
+- **ORM queries**: Complex Django ORM with unexpected query performance
+- **Security vulnerabilities**: Injection, XSS, access control gaps, secrets exposure
+
+### Design Assessment
+
+- Do component interactions make logical sense?
+- Does the change align with existing project architecture?
+- Are there conflicts with current requirements or goals?
+
+### Test Coverage
+
+Every PR should have appropriate test coverage:
+
+- Functional tests for business logic
+- Integration tests for component interactions
+- End-to-end tests for critical user paths
+
+Verify tests cover actual requirements and edge cases. Avoid excessive branching or looping in test code.
+
+### Long-Term Impact
+
+Flag for senior engineer review when changes involve:
+
+- Database schema modifications
+- API contract changes
+- New framework or library adoption
+- Performance-critical code paths
+- Security-sensitive functionality
+
+## Feedback Guidelines
+
+### Tone
+
+- Be polite and empathetic
+- Provide actionable suggestions, not vague criticism
+- Phrase as questions when uncertain: "Have you considered...?"
+
+### Approval
+
+- Approve when only minor issues remain
+- Don't block PRs for stylistic preferences
+- Remember: the goal is risk reduction, not perfect code
+
+## Common Patterns to Flag
+
+### Python/Django
+
+```python
+# Bad: N+1 query
+for user in users:
+    print(user.profile.name)  # Separate query per user
+
+# Good: Prefetch related
+users = User.objects.prefetch_related('profile')
+```
+
+### TypeScript/React
+
+```typescript
+// Bad: Missing dependency in useEffect
+useEffect(() => {
+  fetchData(userId);
+}, []);  // userId not in deps
+
+// Good: Include all dependencies
+useEffect(() => {
+  fetchData(userId);
+}, [userId]);
+```
+
+### Security
+
+```python
+# Bad: SQL injection risk
+cursor.execute(f"SELECT * FROM users WHERE id = {user_id}")
+
+# Good: Parameterized query
+cursor.execute("SELECT * FROM users WHERE id = %s", [user_id])
+```
+
+## References
+
+- [Sentry Code Review Guidelines](https://develop.sentry.dev/engineering-practices/code-review/)
diff --git a/.claude/skills/code-reviewer/SKILL.md b/.claude/skills/code-reviewer/SKILL.md
new file mode 100644
index 0000000..ad7b451
--- /dev/null
+++ b/.claude/skills/code-reviewer/SKILL.md
@@ -0,0 +1,209 @@
+---
+name: code-reviewer
+description: Comprehensive code review skill for TypeScript, JavaScript, Python, Swift, Kotlin, Go. Includes automated code analysis, best practice checking, security scanning, and review checklist generation. Use when reviewing pull requests, providing code feedback, identifying issues, or ensuring code quality standards.
+---
+
+# Code Reviewer
+
+Complete toolkit for code reviewer with modern tools and best practices.
+
+## Quick Start
+
+### Main Capabilities
+
+This skill provides three core capabilities through automated scripts:
+
+```bash
+# Script 1: Pr Analyzer
+python scripts/pr_analyzer.py [options]
+
+# Script 2: Code Quality Checker
+python scripts/code_quality_checker.py [options]
+
+# Script 3: Review Report Generator
+python scripts/review_report_generator.py [options]
+```
+
+## Core Capabilities
+
+### 1. Pr Analyzer
+
+Automated tool for pr analyzer tasks.
+
+**Features:**
+- Automated scaffolding
+- Best practices built-in
+- Configurable templates
+- Quality checks
+
+**Usage:**
+```bash
+python scripts/pr_analyzer.py <project-path> [options]
+```
+
+### 2. Code Quality Checker
+
+Comprehensive analysis and optimization tool.
+
+**Features:**
+- Deep analysis
+- Performance metrics
+- Recommendations
+- Automated fixes
+
+**Usage:**
+```bash
+python scripts/code_quality_checker.py <target-path> [--verbose]
+```
+
+### 3. Review Report Generator
+
+Advanced tooling for specialized tasks.
+
+**Features:**
+- Expert-level automation
+- Custom configurations
+- Integration ready
+- Production-grade output
+
+**Usage:**
+```bash
+python scripts/review_report_generator.py [arguments] [options]
+```
+
+## Reference Documentation
+
+### Code Review Checklist
+
+Comprehensive guide available in `references/code_review_checklist.md`:
+
+- Detailed patterns and practices
+- Code examples
+- Best practices
+- Anti-patterns to avoid
+- Real-world scenarios
+
+### Coding Standards
+
+Complete workflow documentation in `references/coding_standards.md`:
+
+- Step-by-step processes
+- Optimization strategies
+- Tool integrations
+- Performance tuning
+- Troubleshooting guide
+
+### Common Antipatterns
+
+Technical reference guide in `references/common_antipatterns.md`:
+
+- Technology stack details
+- Configuration examples
+- Integration patterns
+- Security considerations
+- Scalability guidelines
+
+## Tech Stack
+
+**Languages:** TypeScript, JavaScript, Python, Go, Swift, Kotlin
+**Frontend:** React, Next.js, React Native, Flutter
+**Backend:** Node.js, Express, GraphQL, REST APIs
+**Database:** PostgreSQL, Prisma, NeonDB, Supabase
+**DevOps:** Docker, Kubernetes, Terraform, GitHub Actions, CircleCI
+**Cloud:** AWS, GCP, Azure
+
+## Development Workflow
+
+### 1. Setup and Configuration
+
+```bash
+# Install dependencies
+npm install
+# or
+pip install -r requirements.txt
+
+# Configure environment
+cp .env.example .env
+```
+
+### 2. Run Quality Checks
+
+```bash
+# Use the analyzer script
+python scripts/code_quality_checker.py .
+
+# Review recommendations
+# Apply fixes
+```
+
+### 3. Implement Best Practices
+
+Follow the patterns and practices documented in:
+- `references/code_review_checklist.md`
+- `references/coding_standards.md`
+- `references/common_antipatterns.md`
+
+## Best Practices Summary
+
+### Code Quality
+- Follow established patterns
+- Write comprehensive tests
+- Document decisions
+- Review regularly
+
+### Performance
+- Measure before optimizing
+- Use appropriate caching
+- Optimize critical paths
+- Monitor in production
+
+### Security
+- Validate all inputs
+- Use parameterized queries
+- Implement proper authentication
+- Keep dependencies updated
+
+### Maintainability
+- Write clear code
+- Use consistent naming
+- Add helpful comments
+- Keep it simple
+
+## Common Commands
+
+```bash
+# Development
+npm run dev
+npm run build
+npm run test
+npm run lint
+
+# Analysis
+python scripts/code_quality_checker.py .
+python scripts/review_report_generator.py --analyze
+
+# Deployment
+docker build -t app:latest .
+docker-compose up -d
+kubectl apply -f k8s/
+```
+
+## Troubleshooting
+
+### Common Issues
+
+Check the comprehensive troubleshooting section in `references/common_antipatterns.md`.
+
+### Getting Help
+
+- Review reference documentation
+- Check script output messages
+- Consult tech stack documentation
+- Review error logs
+
+## Resources
+
+- Pattern Reference: `references/code_review_checklist.md`
+- Workflow Guide: `references/coding_standards.md`
+- Technical Guide: `references/common_antipatterns.md`
+- Tool Scripts: `scripts/` directory
diff --git a/.claude/skills/code-reviewer/references/code_review_checklist.md b/.claude/skills/code-reviewer/references/code_review_checklist.md
new file mode 100644
index 0000000..30a0f7a
--- /dev/null
+++ b/.claude/skills/code-reviewer/references/code_review_checklist.md
@@ -0,0 +1,103 @@
+# Code Review Checklist
+
+## Overview
+
+This reference guide provides comprehensive information for code reviewer.
+
+## Patterns and Practices
+
+### Pattern 1: Best Practice Implementation
+
+**Description:**
+Detailed explanation of the pattern.
+
+**When to Use:**
+- Scenario 1
+- Scenario 2
+- Scenario 3
+
+**Implementation:**
+```typescript
+// Example code implementation
+export class Example {
+  // Implementation details
+}
+```
+
+**Benefits:**
+- Benefit 1
+- Benefit 2
+- Benefit 3
+
+**Trade-offs:**
+- Consider 1
+- Consider 2
+- Consider 3
+
+### Pattern 2: Advanced Technique
+
+**Description:**
+Another important pattern for code reviewer.
+
+**Implementation:**
+```typescript
+// Advanced example
+async function advancedExample() {
+  // Code here
+}
+```
+
+## Guidelines
+
+### Code Organization
+- Clear structure
+- Logical separation
+- Consistent naming
+- Proper documentation
+
+### Performance Considerations
+- Optimization strategies
+- Bottleneck identification
+- Monitoring approaches
+- Scaling techniques
+
+### Security Best Practices
+- Input validation
+- Authentication
+- Authorization
+- Data protection
+
+## Common Patterns
+
+### Pattern A
+Implementation details and examples.
+
+### Pattern B
+Implementation details and examples.
+
+### Pattern C
+Implementation details and examples.
+
+## Anti-Patterns to Avoid
+
+### Anti-Pattern 1
+What not to do and why.
+
+### Anti-Pattern 2
+What not to do and why.
+
+## Tools and Resources
+
+### Recommended Tools
+- Tool 1: Purpose
+- Tool 2: Purpose
+- Tool 3: Purpose
+
+### Further Reading
+- Resource 1
+- Resource 2
+- Resource 3
+
+## Conclusion
+
+Key takeaways for using this reference guide effectively.
diff --git a/.claude/skills/code-reviewer/references/coding_standards.md b/.claude/skills/code-reviewer/references/coding_standards.md
new file mode 100644
index 0000000..b36bb6c
--- /dev/null
+++ b/.claude/skills/code-reviewer/references/coding_standards.md
@@ -0,0 +1,103 @@
+# Coding Standards
+
+## Overview
+
+This reference guide provides comprehensive information for code reviewer.
+
+## Patterns and Practices
+
+### Pattern 1: Best Practice Implementation
+
+**Description:**
+Detailed explanation of the pattern.
+
+**When to Use:**
+- Scenario 1
+- Scenario 2
+- Scenario 3
+
+**Implementation:**
+```typescript
+// Example code implementation
+export class Example {
+  // Implementation details
+}
+```
+
+**Benefits:**
+- Benefit 1
+- Benefit 2
+- Benefit 3
+
+**Trade-offs:**
+- Consider 1
+- Consider 2
+- Consider 3
+
+### Pattern 2: Advanced Technique
+
+**Description:**
+Another important pattern for code reviewer.
+
+**Implementation:**
+```typescript
+// Advanced example
+async function advancedExample() {
+  // Code here
+}
+```
+
+## Guidelines
+
+### Code Organization
+- Clear structure
+- Logical separation
+- Consistent naming
+- Proper documentation
+
+### Performance Considerations
+- Optimization strategies
+- Bottleneck identification
+- Monitoring approaches
+- Scaling techniques
+
+### Security Best Practices
+- Input validation
+- Authentication
+- Authorization
+- Data protection
+
+## Common Patterns
+
+### Pattern A
+Implementation details and examples.
+
+### Pattern B
+Implementation details and examples.
+
+### Pattern C
+Implementation details and examples.
+
+## Anti-Patterns to Avoid
+
+### Anti-Pattern 1
+What not to do and why.
+
+### Anti-Pattern 2
+What not to do and why.
+
+## Tools and Resources
+
+### Recommended Tools
+- Tool 1: Purpose
+- Tool 2: Purpose
+- Tool 3: Purpose
+
+### Further Reading
+- Resource 1
+- Resource 2
+- Resource 3
+
+## Conclusion
+
+Key takeaways for using this reference guide effectively.
diff --git a/.claude/skills/code-reviewer/references/common_antipatterns.md b/.claude/skills/code-reviewer/references/common_antipatterns.md
new file mode 100644
index 0000000..19a2ded
--- /dev/null
+++ b/.claude/skills/code-reviewer/references/common_antipatterns.md
@@ -0,0 +1,103 @@
+# Common Antipatterns
+
+## Overview
+
+This reference guide provides comprehensive information for code reviewer.
+
+## Patterns and Practices
+
+### Pattern 1: Best Practice Implementation
+
+**Description:**
+Detailed explanation of the pattern.
+
+**When to Use:**
+- Scenario 1
+- Scenario 2
+- Scenario 3
+
+**Implementation:**
+```typescript
+// Example code implementation
+export class Example {
+  // Implementation details
+}
+```
+
+**Benefits:**
+- Benefit 1
+- Benefit 2
+- Benefit 3
+
+**Trade-offs:**
+- Consider 1
+- Consider 2
+- Consider 3
+
+### Pattern 2: Advanced Technique
+
+**Description:**
+Another important pattern for code reviewer.
+
+**Implementation:**
+```typescript
+// Advanced example
+async function advancedExample() {
+  // Code here
+}
+```
+
+## Guidelines
+
+### Code Organization
+- Clear structure
+- Logical separation
+- Consistent naming
+- Proper documentation
+
+### Performance Considerations
+- Optimization strategies
+- Bottleneck identification
+- Monitoring approaches
+- Scaling techniques
+
+### Security Best Practices
+- Input validation
+- Authentication
+- Authorization
+- Data protection
+
+## Common Patterns
+
+### Pattern A
+Implementation details and examples.
+
+### Pattern B
+Implementation details and examples.
+
+### Pattern C
+Implementation details and examples.
+
+## Anti-Patterns to Avoid
+
+### Anti-Pattern 1
+What not to do and why.
+
+### Anti-Pattern 2
+What not to do and why.
+
+## Tools and Resources
+
+### Recommended Tools
+- Tool 1: Purpose
+- Tool 2: Purpose
+- Tool 3: Purpose
+
+### Further Reading
+- Resource 1
+- Resource 2
+- Resource 3
+
+## Conclusion
+
+Key takeaways for using this reference guide effectively.
diff --git a/.claude/skills/code-reviewer/scripts/code_quality_checker.py b/.claude/skills/code-reviewer/scripts/code_quality_checker.py
new file mode 100755
index 0000000..35d4196
--- /dev/null
+++ b/.claude/skills/code-reviewer/scripts/code_quality_checker.py
@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+Code Quality Checker
+Automated tool for code reviewer tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class CodeQualityChecker:
+    """Main class for code quality checker functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="Code Quality Checker"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = CodeQualityChecker(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()
diff --git a/.claude/skills/code-reviewer/scripts/pr_analyzer.py b/.claude/skills/code-reviewer/scripts/pr_analyzer.py
new file mode 100755
index 0000000..926c06a
--- /dev/null
+++ b/.claude/skills/code-reviewer/scripts/pr_analyzer.py
@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+Pr Analyzer
+Automated tool for code reviewer tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class PrAnalyzer:
+    """Main class for pr analyzer functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="Pr Analyzer"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = PrAnalyzer(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()
diff --git a/.claude/skills/code-reviewer/scripts/review_report_generator.py b/.claude/skills/code-reviewer/scripts/review_report_generator.py
new file mode 100755
index 0000000..0805302
--- /dev/null
+++ b/.claude/skills/code-reviewer/scripts/review_report_generator.py
@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+Review Report Generator
+Automated tool for code reviewer tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class ReviewReportGenerator:
+    """Main class for review report generator functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="Review Report Generator"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = ReviewReportGenerator(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()
diff --git a/.claude/skills/codex-review/SKILL.md b/.claude/skills/codex-review/SKILL.md
new file mode 100644
index 0000000..9bea297
--- /dev/null
+++ b/.claude/skills/codex-review/SKILL.md
@@ -0,0 +1,37 @@
+---
+name: codex-review
+description: Professional code review with auto CHANGELOG generation, integrated with Codex AI
+---
+
+# codex-review
+
+## Overview
+Professional code review with auto CHANGELOG generation, integrated with Codex AI
+
+## When to Use
+- When you want professional code review before commits
+- When you need automatic CHANGELOG generation
+- When reviewing large-scale refactoring
+
+## Installation
+```bash
+npx skills add -g BenedictKing/codex-review
+```
+
+## Step-by-Step Guide
+1. Install the skill using the command above
+2. Ensure Codex CLI is installed
+3. Use `/codex-review` or natural language triggers
+
+## Examples
+See [GitHub Repository](https://github.com/BenedictKing/codex-review) for examples.
+
+## Best Practices
+- Keep CHANGELOG.md in your project root
+- Use conventional commit messages
+
+## Troubleshooting
+See the GitHub repository for troubleshooting guides.
+
+## Related Skills
+- context7-auto-research, tavily-web, exa-search, firecrawl-scraper
diff --git a/.claude/skills/commory-android/SKILL.md b/.claude/skills/commory-android/SKILL.md
new file mode 100644
index 0000000..24fc80d
--- /dev/null
+++ b/.claude/skills/commory-android/SKILL.md
@@ -0,0 +1,53 @@
+---
+name: commory-android
+description: Android app for Commory — dual runtime modes, Compose UI, MsgLayer backup/restore, server sync, and agent privacy model.
+---
+
+# Commory Android
+
+Work on the Commory Android app (package `com.iskenkenya.commory.mobile`).
+
+## Architecture
+
+```
+app/src/main/java/com/iskenkenya/commory/mobile/
+  runtime/                     — AppEnvironment, RuntimeMode, RuntimeModePolicy, AppEnvironmentManager, LocaleResolver
+  remote/                      — CommoryServerClient, CommoryApiService, NetworkError, DTOs
+  auth/                        — CommoryServerAuthProvider
+  agent/                       — AgentContextModels, AgentPrivacyPolicy
+  ui/screens/                  — ModeSelectionScreen, ServerSetupScreen, BackupScreen, RestoreScreen, MoreScreen
+  ui/navigation/NavigationHost — Two-level route guard (mode → auth → main)
+  ui/viewmodels/               — AppViewModel, BackupViewModel, RestoreViewModel
+  di/AppContainer              — Manual DI
+
+sdk/backup/                    — Pure Kotlin MsgLayer mapper, reader, writer
+sdk/auth/                      — AuthProvider interface, AuthCredentials sealed class
+sdk/storage/                   — Storage contracts
+```
+
+## Key Patterns
+
+- `AppEnvironment` is the single source of truth; persisted via DataStore; exposed as `StateFlow`.
+- `currentSnapshot()` reads a `@Volatile` cache updated by `onEach`; no `runBlocking`.
+- `RuntimeModePolicy` centralizes mode-dependent decisions (auth required, upload allowed, etc.).
+- `CommoryServerClient` caches Retrofit services per base URL; uses separate `refreshClient` for auth endpoints.
+- OkHttp `authenticator` auto-refreshes on 401; `/api/auth/` paths are excluded to prevent loops.
+- `NetworkError` sealed class maps IOException subtypes to typed errors for UI localization.
+- `AuthSession.isAuthenticated` checks JWT `exp` claim; `accessTokenExpiresAt()` decodes Base64 payload.
+- Backup always writes local first; upload is gated by `RuntimeModePolicy.canUploadBackup()`.
+- Mode switch shows `AlertDialog` confirmation; switching clears session but preserves local files.
+- `AgentPrivacyPolicy` maps `RuntimeMode` to `AgentProviderPolicy` (LOCAL_ONLY vs SERVER_ALLOWED).
+- Default server URL detects emulator via `Build.FINGERPRINT`.
+
+## Workflow
+
+1. Read `NavigationHost.kt` and the target screen/ViewModel.
+2. Read `docs/android-runtime-modes.md` for mode behavior.
+3. Read `docs/mobile-api.md` for server contract.
+4. Ensure string resources exist in `values/`, `values-en/`, `values-zh-rCN/`.
+5. Run: `cd android && ./gradlew :app:compileDebugKotlin && ./gradlew :app:testDebugUnitTest`
+
+## References
+
+- See `references/runtime-modes.md` for mode behavior details.
+- See `docs/mobile-api.md` for the server API contract.
diff --git a/.claude/skills/commory-android/references/runtime-modes.md b/.claude/skills/commory-android/references/runtime-modes.md
new file mode 100644
index 0000000..9bbde5a
--- /dev/null
+++ b/.claude/skills/commory-android/references/runtime-modes.md
@@ -0,0 +1,30 @@
+# Android Runtime Modes
+
+## LOCAL_ONLY
+
+- No account or server required.
+- Backup and restore use local app storage only.
+- Agent context policy: `LOCAL_ONLY` — context must not leave the device.
+- Switching into local mode clears auth tokens but preserves local backup files.
+
+## COMMORY_SERVER
+
+- User authenticates with Commory Server (username/password).
+- Backup writes local MsgLayer JSON first, then optionally uploads.
+- Upload is gated by three conditions: server mode + syncOnBackup + authenticated.
+- Remote import history and export use authenticated endpoints.
+- Agent context policy: `SERVER_ALLOWED` — future AI features may use server-backed providers with relevance filtering.
+
+## Mode Switching
+
+- Switching modes triggers an `AlertDialog` confirmation.
+- Switching to LOCAL_ONLY clears the auth session.
+- Switching to COMMORY_SERVER requires server URL and login.
+- Local backup files are always preserved across mode switches.
+
+## Session Lifecycle
+
+- `AuthSession.isAuthenticated` checks `accessToken` presence and JWT `exp` claim.
+- OkHttp `authenticator` auto-refreshes on 401 (excluding auth endpoints).
+- `logoutPersistedSession()` calls `POST /api/auth/logout` with refresh token, then clears local session.
+- Refresh token rotation: server issues a new refresh token on each refresh; old one is revoked.
diff --git a/.claude/skills/commory-backend/SKILL.md b/.claude/skills/commory-backend/SKILL.md
new file mode 100644
index 0000000..bd9c9dd
--- /dev/null
+++ b/.claude/skills/commory-backend/SKILL.md
@@ -0,0 +1,50 @@
+---
+name: commory-backend
+description: Go backend for Commory — JWT auth, file-backed storage, MsgLayer import/query, Setup wizard, and mobile API contract.
+---
+
+# Commory Backend
+
+Work on the Commory Go backend server.
+
+## Architecture
+
+```
+cmd/commory/main.go          — CLI entry (serve / import / validate)
+internal/cli/root.go          — Cobra commands, boot sequence
+internal/api/server.go        — HTTP handlers, public/private mux
+internal/auth/service.go      — PBKDF2-HMAC-SHA256 passwords, JWT HS256, login rate-limit, refresh rotation
+internal/auth/middleware.go   — Bearer token extraction, context propagation
+internal/setup/service.go     — First-run setup wizard, CheckSetup migration
+internal/storage/storage.go   — Provider interface (GetSetupStatus, SaveSetup, HasAdminUser, UpdateUserPasswordHash, etc.)
+internal/storage/filestore.go — JSON-file-backed Provider, scopeKey isolation, persist-on-write
+internal/storage/sqlite.go    — SQLite adapter factory
+internal/msglayer/validator.go— Schema validation + additionalProperties check
+internal/msglayer/types.go    — Go structs for MsgLayer v0.1
+internal/importers/           — JSON import pipeline
+internal/query/               — Timeline, search, identities, threads
+internal/config/config.go     — Env-driven config (AUTH_SECRET, TLS, ENV, DB_DSN, etc.)
+```
+
+## Key Patterns
+
+- Handlers are thin: parse request, call service, return envelope `{code, msg, data}`.
+- Auth middleware protects `/api/` routes; `/api/auth/` and `/api/setup` are public.
+- Password hashes use `pbkdf2$` prefix; legacy `sha256$` auto-migrates on login.
+- Refresh tokens are one-use (ConsumeRefreshToken revokes on refresh).
+- Logout revokes the refresh token before clearing the cookie.
+- Setup wizard: GET returns status, POST creates admin + writes SetupRecord. Repeat POST returns 400.
+- scopeKey uses SHA-1 first 8 bytes with legacy 4-byte fallback lookup.
+- Cookie Secure flag reads COMMORY_TLS; COMMORY_ENV=production rejects default auth secret.
+
+## Workflow
+
+1. Read `backend/internal/api/server.go` and the relevant service file.
+2. Read `docs/mobile-api.md` for contract alignment.
+3. Implement changes following the thin-handler pattern.
+4. Run: `cd backend && go vet ./... && go test ./... -coverprofile=coverage.out`
+
+## References
+
+- See `references/api-routes.md` for the full route table.
+- See `docs/mobile-api.md` for the mobile API contract.
diff --git a/.claude/skills/commory-backend/references/api-routes.md b/.claude/skills/commory-backend/references/api-routes.md
new file mode 100644
index 0000000..1d672e6
--- /dev/null
+++ b/.claude/skills/commory-backend/references/api-routes.md
@@ -0,0 +1,23 @@
+| Method | Path | Auth | Handler |
+|--------|------|------|---------|
+| POST | /api/auth/register | public | handleRegister |
+| POST | /api/auth/login | public | handleLogin |
+| POST | /api/auth/refresh | public | handleRefresh |
+| POST | /api/auth/logout | public | handleLogout |
+| GET | /api/setup | public | handleGetSetup |
+| POST | /api/setup | public | handlePostSetup |
+| GET | /api/user/info | Bearer | handleUserInfo |
+| GET | /api/imports | Bearer | handleImports |
+| POST | /api/imports/upload | Bearer | handleImportUpload |
+| GET | /api/imports/{id}/export | Bearer | handleImportExport |
+| POST | /api/imports/path | Bearer+Admin | handleImportPath |
+| POST | /api/validate/upload | Bearer | handleValidateUpload |
+| POST | /api/validate/path | Bearer+Admin | handleValidatePath |
+| GET | /api/dashboard | Bearer | handleDashboard |
+| GET | /api/events | Bearer | handleEvents |
+| GET | /api/events/{id} | Bearer | handleEvent |
+| GET | /api/timeline | Bearer | handleTimeline |
+| GET | /api/identities | Bearer | handleIdentities |
+| GET | /api/identities/{id} | Bearer | handleIdentity |
+| GET | /api/search | Bearer | handleSearch |
+| GET | /api/threads/{id} | Bearer | handleThread |
diff --git a/.claude/skills/commory-msglayer/SKILL.md b/.claude/skills/commory-msglayer/SKILL.md
new file mode 100644
index 0000000..e8670e0
--- /dev/null
+++ b/.claude/skills/commory-msglayer/SKILL.md
@@ -0,0 +1,55 @@
+---
+name: commory-msglayer
+description: MsgLayer schema v0.1 — the canonical interchange format between Android, Go backend, web, and future agents.
+---
+
+# MsgLayer Schema
+
+Work on the MsgLayer interchange format and its implementations.
+
+## Schema Location
+
+```
+msglayer/schema/v0.1/root.schema.json   — JSON Schema root
+msglayer/examples/                       — Example export files
+backend/internal/msglayer/               — Go validator, types, constants
+android/sdk/backup/                      — Kotlin mapper, reader, writer
+```
+
+## Core Types
+
+- `RootExport`: version, source, identities[], events[], relations[], indexes[]
+- `Identity`: id, type, display_name, avatar?, phones[], emails[], labels[]
+- `Event`: id, timestamp, type, direction, participants[], content{}, relations[], meta?
+- `Relation`: type (same_thread, references_identity, reply_to, derived_from), target
+- `SearchParams`: userID, keyword, contactID, type, participant, from, to, limit, offset
+
+## Version
+
+- Current: `msglayer/v0.1`
+- Go constant: `msglayer.Version`
+- Kotlin constant: `MSG_LAYER_VERSION`
+- Both must stay in sync; CI does not currently check this.
+
+## Validation Rules
+
+- `additionalProperties: false` is enforced by the Go validator for events, identities, and content maps.
+- Allowed event fields: id, timestamp, type, direction, participants, content, relations, meta.
+- Allowed identity fields: id, type, display_name, avatar, phones, emails, labels, meta.
+- Content keys are type-specific: sms→text, call→duration_sec/call_type, voice→file/transcript/summary, contact_snapshot→identity_id.
+- Event types: sms, call, voice, contact_snapshot.
+- Direction values: inbound, outbound, missed (for calls).
+- Relation types: same_thread, references_identity (active); reply_to, derived_from (reserved).
+
+## Workflow
+
+1. Read `msglayer/schema/v0.1/root.schema.json` for the authoritative schema.
+2. Read `msglayer/examples/` for valid export files.
+3. Modify Go validator in `backend/internal/msglayer/validator.go` if adding new validation rules.
+4. Modify Kotlin mapper in `android/sdk/backup/` if adding new event types or fields.
+5. Run backend tests: `cd backend && go test ./internal/msglayer/ -v`
+6. Run Android tests: `cd android && ./gradlew :sdk:backup:testDebugUnitTest`
+
+## References
+
+- See `references/event-types.md` for event type definitions and content schemas.
diff --git a/.claude/skills/commory-msglayer/references/event-types.md b/.claude/skills/commory-msglayer/references/event-types.md
new file mode 100644
index 0000000..5e53e2f
--- /dev/null
+++ b/.claude/skills/commory-msglayer/references/event-types.md
@@ -0,0 +1,53 @@
+# MsgLayer Event Types
+
+## sms
+
+Content keys: `text`
+
+Direction: inbound, outbound
+
+## call
+
+Content keys: `duration_sec`, `call_type`
+
+Direction: inbound, outbound, missed
+
+call_type values: incoming, outgoing, missed, rejected
+
+## voice
+
+Content keys: `file`, `transcript`, `summary`
+
+Direction: inbound, outbound
+
+## contact_snapshot
+
+Content keys: `identity_id`
+
+Direction: none (not applicable)
+
+## Relation Types
+
+| Type | Status | Description |
+|------|--------|-------------|
+| same_thread | active | Links events in the same conversation thread |
+| references_identity | active | Links an event to a contact identity |
+| reply_to | reserved | Indicates a reply relationship between events |
+| derived_from | reserved | Indicates one event was derived from another |
+
+## Android Direction Mapping
+
+| Android SMS Type | MsgLayer Direction |
+|-----------------|-------------------|
+| 1 (inbox) | inbound |
+| 2 (sent) | outbound |
+| 3 (draft) | outbound (best approximation) |
+| 4 (outbox) | outbound |
+| 5 (failed) | outbound |
+| 6 (queued) | outbound |
+
+| Android Call Type | MsgLayer Direction | MsgLayer call_type |
+|------------------|-------------------|-------------------|
+| 1 (incoming) | inbound | incoming |
+| 2 (outgoing) | outbound | outgoing |
+| 5 (rejected) | missed | rejected |
diff --git a/.claude/skills/design-mirror/SKILL.md b/.claude/skills/design-mirror/SKILL.md
new file mode 100644
index 0000000..d0ddb31
--- /dev/null
+++ b/.claude/skills/design-mirror/SKILL.md
@@ -0,0 +1,171 @@
+---
+name: design-mirror
+description: "Replicate the visual style of any website and apply it to your existing codebase. Use this skill whenever the user wants to match a site's design, mirror a UI aesthetic, make their app look like another site, or replicate a specific visual style from a URL. Trigger on phrases like 'make it look like', 'match the design of', 'copy the style from', 'I want my app to look like X', 'mirror this design', 'inspired by [url]', or any time the user points at a website and says they want their frontend to match it."
+---
+
+# Design Mirror
+
+Capture the visual design language of any website and apply it to your existing codebase — colors, typography, spacing, layout rhythm, component shapes, and overall aesthetic — all extracted live via Bright Data's Web Unlocker.
+
+## What This Skill Does
+
+1. **Capture** — Screenshot + HTML scrape the inspiration site via Bright Data
+2. **Extract** — Identify the full design system: colors, fonts, spacing scale, border radii, shadows, component patterns
+3. **Analyze** — Study the screenshot visually and the CSS structurally to understand the design language
+4. **Apply** — Translate that design system into the user's existing codebase (their framework, their components)
+
+You are not copying content or functionality. You're understanding the *design language* — the palette, the type scale, the card shapes, the hover states, the overall aesthetic feel.
+
+> **Important:** This skill is for design inspiration and learning — extracting publicly visible design tokens (colors, fonts, spacing) to inform your own UI work. Always use it respectfully and in accordance with the terms of service of the sites you reference.
+
+## Setup
+
+Requires:
+- `BRIGHTDATA_API_KEY` — from [brightdata.com/cp](https://brightdata.com/cp) → Account Settings
+- `BRIGHTDATA_UNLOCKER_ZONE` — create an Unlocker zone at brightdata.com/cp
+
+```bash
+export BRIGHTDATA_API_KEY="your-api-key"
+export BRIGHTDATA_UNLOCKER_ZONE="your-zone-name"
+```
+
+## Step-by-Step Process
+
+### Step 1: Capture the Inspiration Site
+
+Run both captures in parallel — screenshot (for visual analysis) and HTML scrape (for CSS extraction):
+
+```bash
+# Screenshot (save as PNG)
+bash scripts/screenshot.sh "https://inspiration-site.com" "/tmp/target_screenshot.png"
+
+# HTML + CSS scrape
+bash scripts/scrape_html.sh "https://inspiration-site.com" "/tmp/target_page.html"
+```
+
+Read `references/capture-guide.md` for how to extract CSS from the raw HTML and handle common issues.
+
+### Step 2: Analyze the Design System
+
+After capturing, analyze both in parallel:
+
+**Visual analysis (screenshot):** Read the PNG image and identify:
+- Primary, secondary, accent colors
+- Background colors (page bg, card bg, surface hierarchy)
+- Typography: font families visible, size hierarchy (h1 → body → caption)
+- Layout: is it centered/constrained-width? Grid? Sidebar?
+- Card/container shapes: border radius size, shadow style (hard, soft, none, colored)
+- Button styles: pill, rectangle, ghost, gradient?
+- Navigation: sticky? Glass/blur effect? Dark or light?
+- Overall mood: dark, light, minimal, brutalist, glassmorphism, corporate, startup?
+
+**CSS analysis (HTML):** Extract from `<style>` tags and inline styles:
+- CSS custom properties (`:root { --color-... }`) — publicly declared design tokens
+- Font imports (`@import` from Google Fonts, etc.)
+- Tailwind config if present
+- Repeated class patterns that reveal the spacing scale
+
+Read `references/css-extraction.md` for the extraction playbook.
+
+### Step 3: Build the Design Token Map
+
+Produce a structured design token map before touching any code:
+
+```
+DESIGN TOKENS FROM [site]
+==========================
+Colors:
+  --bg-primary: #0a0a0f      (page background)
+  --bg-surface: #13131a      (card/panel background)
+  --text-primary: #ffffff
+  --text-muted: #8888aa
+  --accent: #7c3aed          (primary CTA color)
+  --accent-hover: #6d28d9
+  --border: rgba(255,255,255,0.08)
+
+Typography:
+  --font-heading: 'Inter', sans-serif
+  --font-body: 'Inter', sans-serif
+  font-scale: 12/14/16/20/24/32/48px
+  heading-weight: 700
+  body-weight: 400
+
+Spacing:
+  base-unit: 8px
+  scale: 4/8/12/16/24/32/48/64px
+
+Borders & Shadows:
+  --radius-sm: 6px
+  --radius-md: 12px
+  --radius-lg: 20px
+  --shadow: 0 4px 24px rgba(0,0,0,0.4)
+
+Special effects:
+  glass-blur: backdrop-filter: blur(16px)
+  gradient: linear-gradient(135deg, #7c3aed, #2563eb)
+```
+
+Show this token map to the user before proceeding. It's the foundation — if it's wrong, the output will be wrong.
+
+### Step 4: Understand the User's Codebase
+
+Before writing any code, read the relevant parts of their codebase:
+
+- What framework? (React, Vue, Next.js, plain HTML?)
+- What styling approach? (Tailwind, CSS modules, styled-components, plain CSS?)
+- Where are global styles defined? (globals.css, theme.ts, tailwind.config.js?)
+- What components need restyling? (ask the user if unclear)
+
+Do not rewrite everything — surgical precision. Apply the design tokens to the existing structure.
+
+### Step 5: Apply the Design
+
+The application strategy depends on their stack:
+
+**If Tailwind:** Update `tailwind.config.js` with the new color palette, font family, border radius scale. Add custom CSS variables for anything Tailwind can't handle natively.
+
+**If CSS/CSS Modules:** Create or update a `:root` variables block in globals.css. Update component stylesheets to use the new variables.
+
+**If styled-components/Emotion:** Update the theme object. Replace hardcoded color/spacing values with theme tokens.
+
+**In all cases:**
+- Apply colors, typography, and spacing globally first
+- Then tackle component-level details (buttons, cards, nav) one at a time
+- Preserve all existing functionality and layout structure — only visual properties change
+- Add any special effects (glass blur, gradients, animations) that define the inspiration site's character
+
+Read `references/apply-guide.md` for framework-specific implementation patterns.
+
+### Step 6: Show the Before/After
+
+After applying changes, clearly present:
+- Which files were modified
+- The design token mapping (source → what you set it to)
+- Any special effects added
+- What the user should check visually (hover states, dark/light mode, mobile)
+
+If the user has a dev server running, remind them to check it. Offer to iterate on specific components.
+
+## Key Principles
+
+**Design language, not markup.** The inspiration site's HTML structure and content are theirs. You're extracting the *design language* — how colors relate, how spacing flows, what gives the site its character — to apply as your own creative foundation.
+
+**Design tokens first, code second.** Rushing to apply colors before understanding the full system leads to inconsistent results. Always build the token map first.
+
+**Ask about scope.** "Apply the design everywhere" vs "just make the homepage feel like it" vs "only restyle the navbar" are very different jobs. Clarify before proceeding.
+
+**Don't break what works.** The user's components work. Only change visual properties. If you're uncertain whether a change might break layout, err on the side of caution and flag it.
+
+**Iterative is fine.** It's often better to get the foundation right (colors, type, spacing) and let the user review before tackling component-level details.
+
+## What to Do When...
+
+**The site uses a design system (Material, shadcn, etc.):** Identify it, tell the user, and ask if they want to adopt the same system or just extract the visual tokens.
+
+**The CSS is minified/obfuscated:** Fall back to the screenshot + visual analysis. You can still extract colors, spacing, and shapes from visual inspection.
+
+**The inspiration site is JS-rendered and the HTML scrape comes back mostly empty:** Note this to the user — the screenshot will still work for visual analysis, but CSS extraction will be limited. You can still infer most tokens visually.
+
+**The user's codebase uses a component library (shadcn, Chakra, MUI):** Apply the design by customizing the library's theme/config rather than overriding individual components.
+
+**Multiple pages need to match:** Use the homepage for overall design tokens, but offer to check inner pages (e.g., `/pricing`, `/docs`) if the user wants to match a specific page's look.
diff --git a/.claude/skills/design-mirror/references/apply-guide.md b/.claude/skills/design-mirror/references/apply-guide.md
new file mode 100644
index 0000000..b6aff11
--- /dev/null
+++ b/.claude/skills/design-mirror/references/apply-guide.md
@@ -0,0 +1,271 @@
+# Design Application Guide
+
+How to apply extracted design tokens to different frontend stacks.
+
+## Tailwind CSS Projects
+
+### 1. Update tailwind.config.js / tailwind.config.ts
+
+```js
+// tailwind.config.js
+module.exports = {
+  theme: {
+    extend: {
+      colors: {
+        bg: {
+          page:    '#0a0a0f',
+          surface: '#13131a',
+          elevated:'#1a1a2e',
+        },
+        brand: {
+          DEFAULT: '#7c3aed',
+          hover:   '#6d28d9',
+        },
+        border: 'rgba(255,255,255,0.08)',
+        text: {
+          primary:   '#ffffff',
+          secondary: '#a0a0b8',
+          muted:     '#606080',
+        }
+      },
+      fontFamily: {
+        sans: ['Inter', 'sans-serif'],
+      },
+      borderRadius: {
+        'sm': '6px',
+        'md': '12px',
+        'lg': '20px',
+        'xl': '28px',
+      },
+      boxShadow: {
+        'card': '0 4px 24px rgba(0,0,0,0.4)',
+        'glow': '0 0 24px rgba(124,58,237,0.3)',
+      },
+    }
+  }
+}
+```
+
+### 2. Update globals.css for non-Tailwind properties
+
+```css
+/* globals.css */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+
+:root {
+  --gradient-hero: linear-gradient(135deg, #7c3aed 0%, #2563eb 100%);
+  --gradient-subtle: radial-gradient(ellipse at top, rgba(124,58,237,0.15), transparent);
+  --blur-glass: blur(16px);
+  --transition: all 0.2s ease;
+}
+
+body {
+  background-color: #0a0a0f;
+  color: #ffffff;
+  font-family: 'Inter', sans-serif;
+}
+```
+
+### 3. Update component classes
+
+Go through the user's main components and replace hardcoded color/spacing classes with the new ones. Focus on:
+- `bg-*` → new background tokens
+- `text-*` → new text tokens
+- `border-*` → new border tokens
+- `rounded-*` → new radius tokens
+
+---
+
+## Plain CSS / CSS Modules Projects
+
+### 1. Create/update design tokens file
+
+```css
+/* styles/tokens.css or styles/globals.css */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+
+:root {
+  /* Colors */
+  --color-bg-page:     #0a0a0f;
+  --color-bg-surface:  #13131a;
+  --color-bg-elevated: #1a1a2e;
+  --color-text:        #ffffff;
+  --color-text-muted:  #a0a0b8;
+  --color-brand:       #7c3aed;
+  --color-brand-hover: #6d28d9;
+  --color-border:      rgba(255, 255, 255, 0.08);
+
+  /* Typography */
+  --font-sans: 'Inter', sans-serif;
+  --text-xs:   12px;
+  --text-sm:   14px;
+  --text-base: 16px;
+  --text-lg:   20px;
+  --text-xl:   24px;
+  --text-2xl:  32px;
+  --text-3xl:  48px;
+
+  /* Spacing */
+  --space-1:  4px;
+  --space-2:  8px;
+  --space-3:  12px;
+  --space-4:  16px;
+  --space-6:  24px;
+  --space-8:  32px;
+  --space-12: 48px;
+  --space-16: 64px;
+
+  /* Borders */
+  --radius-sm:   6px;
+  --radius-md:   12px;
+  --radius-lg:   20px;
+  --radius-pill: 9999px;
+
+  /* Shadows & Effects */
+  --shadow-card:  0 4px 24px rgba(0, 0, 0, 0.4);
+  --shadow-glow:  0 0 24px rgba(124, 58, 237, 0.3);
+  --blur-glass:   blur(16px);
+
+  /* Gradients */
+  --gradient-hero: linear-gradient(135deg, #7c3aed 0%, #2563eb 100%);
+
+  /* Animation */
+  --transition: all 0.2s ease;
+}
+
+body {
+  background: var(--color-bg-page);
+  color: var(--color-text);
+  font-family: var(--font-sans);
+  line-height: 1.5;
+}
+```
+
+### 2. Update component styles
+
+Replace hardcoded values with variables throughout component CSS files. Use find+replace for common patterns.
+
+---
+
+## styled-components / Emotion Projects
+
+### 1. Update the theme object
+
+```ts
+// theme.ts
+export const theme = {
+  colors: {
+    bg: {
+      page:    '#0a0a0f',
+      surface: '#13131a',
+      elevated:'#1a1a2e',
+    },
+    text: {
+      primary:  '#ffffff',
+      muted:    '#a0a0b8',
+    },
+    brand: '#7c3aed',
+    border:'rgba(255,255,255,0.08)',
+  },
+  fonts: {
+    sans: "'Inter', sans-serif",
+  },
+  radii: {
+    sm:   '6px',
+    md:   '12px',
+    lg:   '20px',
+    pill: '9999px',
+  },
+  shadows: {
+    card: '0 4px 24px rgba(0,0,0,0.4)',
+    glow: '0 0 24px rgba(124,58,237,0.3)',
+  },
+  gradients: {
+    hero: 'linear-gradient(135deg, #7c3aed 0%, #2563eb 100%)',
+  },
+  transitions: {
+    default: 'all 0.2s ease',
+  },
+}
+```
+
+---
+
+## Next.js / Nuxt Projects
+
+These are usually Tailwind or CSS Modules under the hood — apply the appropriate guide above.
+
+For Next.js specifically:
+- Global styles: `app/globals.css` (App Router) or `styles/globals.css` (Pages Router)
+- Tailwind config: `tailwind.config.ts` at root
+
+---
+
+## Component Priority Order
+
+Apply the design in this order for maximum impact with minimum risk:
+
+1. **Global background + text colors** — immediate transformation, zero breakage risk
+2. **Font import + font-family** — single line change, huge visual impact
+3. **Navigation/header** — most visible, sets the tone
+4. **Cards & containers** — background, border, radius, shadow
+5. **Buttons** — color, shape, hover state
+6. **Form inputs** — background, border, focus ring
+7. **Typography scale** — heading sizes and weights
+8. **Special effects** — glass blur, gradients, glows (do these last, they're icing)
+
+---
+
+## Glassmorphism Effect (Common in Modern SaaS/AI Sites)
+
+If the target site uses glass cards (common in dark AI/SaaS sites):
+
+```css
+.glass-card {
+  background: rgba(255, 255, 255, 0.05);
+  backdrop-filter: blur(16px);
+  -webkit-backdrop-filter: blur(16px);
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  border-radius: 12px;
+}
+```
+
+In Tailwind:
+```html
+<div class="bg-white/5 backdrop-blur-md border border-white/8 rounded-xl">
+```
+
+Note: `backdrop-filter` requires the parent to NOT have `overflow: hidden` set on ancestors in some browsers. Flag this to the user if they see glass effects not working.
+
+---
+
+## Gradient Text (Popular in AI/Tech Sites)
+
+```css
+.gradient-text {
+  background: linear-gradient(135deg, #7c3aed, #2563eb);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+```
+
+In Tailwind (requires custom config or inline style):
+```html
+<span class="bg-gradient-to-r from-violet-500 to-blue-500 bg-clip-text text-transparent">
+```
+
+---
+
+## Checking Your Work
+
+After applying, mentally walk through:
+- [ ] Page background matches
+- [ ] Primary text color matches
+- [ ] Card/panel background and border match
+- [ ] Primary button color + shape match
+- [ ] Font family matches (check Chrome DevTools → Computed → font-family)
+- [ ] Heading weight and size feel similar
+- [ ] Any special effects (blur, gradient, glow) are present
+- [ ] Hover transitions feel similar in speed/style
+- [ ] Mobile layout feels similar (padding, stacking)
diff --git a/.claude/skills/design-mirror/references/capture-guide.md b/.claude/skills/design-mirror/references/capture-guide.md
new file mode 100644
index 0000000..af35eaa
--- /dev/null
+++ b/.claude/skills/design-mirror/references/capture-guide.md
@@ -0,0 +1,84 @@
+# Capture Guide
+
+## Running Both Captures
+
+Always run screenshot and HTML scrape in parallel (they're independent requests):
+
+```bash
+# Run both simultaneously
+bash scripts/screenshot.sh "https://target.com" "/tmp/target_screenshot.png" &
+SCREENSHOT_PID=$!
+
+bash scripts/scrape_html.sh "https://target.com" "/tmp/target_page.html" &
+HTML_PID=$!
+
+wait $SCREENSHOT_PID $HTML_PID
+echo "Both captures complete"
+```
+
+Or just use two Agent tool calls in the same message.
+
+## Reading the Screenshot
+
+Use the Read tool on the PNG file path — Claude is multimodal and can directly analyze the image. Describe what you see in terms of the design token categories (colors, type, layout, components, effects).
+
+## Reading the HTML
+
+The HTML file can be very large. Use Grep to extract the most useful parts:
+
+```bash
+# Extract CSS custom properties
+grep -o '\-\-[a-zA-Z-]*:[^;]*' /tmp/target_page.html | head -100
+
+# Extract @import font statements
+grep -E '@import|fonts\.googleapis' /tmp/target_page.html | head -20
+
+# Extract <style> block content
+grep -A 500 '<style' /tmp/target_page.html | head -600
+
+# Extract inline styles from key elements
+grep -o 'style="[^"]*"' /tmp/target_page.html | head -50
+
+# Look for Tailwind config
+grep -A 20 'tailwind.config' /tmp/target_page.html | head -50
+```
+
+## Common Issues
+
+### Large HTML files
+Use Grep with specific patterns rather than reading the whole file. Focus on `<style>` tags, `:root`, `@import`, and `<link rel="stylesheet">`.
+
+### Minified CSS
+Minified CSS has no whitespace. You can still extract colors with:
+```bash
+grep -oE '#[0-9a-fA-F]{3,8}' /tmp/target_page.html | sort -u
+grep -oE 'rgb\([^)]+\)' /tmp/target_page.html | sort -u
+grep -oE 'rgba\([^)]+\)' /tmp/target_page.html | sort -u
+```
+
+### External CSS files
+The HTML may reference external `.css` files. You'll see `<link href="/assets/style.abc123.css" rel="stylesheet">`. Unfortunately, relative paths won't work from the API response. Use the full URL with the scrape script:
+```bash
+bash scripts/scrape_html.sh "https://target.com/assets/style.abc123.css" "/tmp/target_styles.css"
+```
+
+### JS-rendered sites (mostly empty HTML)
+If the HTML is sparse (React/Next.js SPA), the design lives in:
+1. The screenshot (fully rendered) — most useful
+2. External CSS chunks linked in `<head>`
+3. Inline `<script>` blocks with config data
+
+Fall back to pure visual extraction from the screenshot in this case.
+
+## Screenshot Quality
+
+The screenshot captures the full rendered page at desktop viewport. For sites with:
+- **Dark themes**: Colors will be accurate in screenshot
+- **Animations**: Screenshot captures a static moment (usually the loaded state)
+- **Sticky headers**: Will show in their scrolled-to-top position
+- **Above-the-fold content**: Most important — this is what defines the brand
+
+If you need to see a specific section (e.g., pricing page, a component below the fold), scrape a different URL:
+```bash
+bash scripts/screenshot.sh "https://target.com/pricing" "/tmp/pricing_screenshot.png"
+```
diff --git a/.claude/skills/design-mirror/references/css-extraction.md b/.claude/skills/design-mirror/references/css-extraction.md
new file mode 100644
index 0000000..b77f4bb
--- /dev/null
+++ b/.claude/skills/design-mirror/references/css-extraction.md
@@ -0,0 +1,150 @@
+# CSS Extraction Playbook
+
+After scraping the raw HTML, extract the design tokens systematically. Work through these layers in order.
+
+## Layer 1: CSS Custom Properties (The Jackpot)
+
+Search the HTML for `:root` blocks — these are design systems that have done your work for you:
+
+```html
+<style>
+  :root {
+    --color-bg: #0a0a0f;
+    --color-primary: #7c3aed;
+    --font-sans: 'Inter', sans-serif;
+    --radius: 12px;
+  }
+</style>
+```
+
+Grab every `--variable` and classify it: color, font, spacing, shadow, radius, animation.
+
+## Layer 2: Font Imports
+
+Look for `@import` at the top of `<style>` blocks and in `<link>` tags:
+
+```html
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap">
+```
+
+Or within CSS:
+```css
+@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;700&display=swap');
+```
+
+Record the font families and the weights loaded — the weights tell you what's used (e.g., 300 = light body, 700 = bold headings).
+
+## Layer 3: Tailwind Config (if site uses Tailwind)
+
+Signs it's Tailwind: classes like `bg-purple-600`, `text-gray-200`, `rounded-xl`, `shadow-lg`, `backdrop-blur-md`.
+
+If there's a custom Tailwind theme, it may appear as an inline script:
+```html
+<script>
+  tailwind.config = {
+    theme: {
+      extend: {
+        colors: { brand: '#7c3aed' }
+      }
+    }
+  }
+</script>
+```
+
+For standard Tailwind sites without custom config, use the visual screenshot to identify which Tailwind colors they're using, then replicate with the same class names.
+
+## Layer 4: Repeated Class Patterns
+
+Scan the HTML for repeated class combinations on similar elements. The pattern reveals the design system:
+
+```html
+<!-- Repeated card pattern -->
+<div class="bg-white/5 border border-white/10 rounded-2xl p-6 shadow-xl backdrop-blur-sm">
+
+<!-- Repeated button pattern -->
+<button class="bg-violet-600 hover:bg-violet-500 text-white font-semibold px-6 py-3 rounded-full transition-all">
+```
+
+These patterns tell you the component-level design decisions even without explicit custom properties.
+
+## Layer 5: Inline Styles & Gradients
+
+Look for inline `style=""` attributes on hero sections, headers, and highlighted elements — these often contain the most intentional design choices:
+
+```html
+<section style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);">
+<div style="background: radial-gradient(ellipse at top, rgba(124,58,237,0.15) 0%, transparent 60%);">
+```
+
+## Layer 6: Animation & Transition Patterns
+
+Note CSS transitions and animations — they define the "feel" of the site:
+
+```css
+transition: all 0.2s ease;        /* snappy */
+transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);  /* Material-style */
+animation: fadeIn 0.6s ease forwards;  /* page load feel */
+```
+
+## When the HTML Comes Back Sparse (JS-Rendered Sites)
+
+Signs: `<div id="root"></div>` with minimal content, or `<div id="__next">` with a loading spinner.
+
+In this case:
+1. Screenshot is still fully usable for visual analysis
+2. Look for `<link>` tags pointing to external CSS files — note their paths even if you can't fetch them
+3. Look for any `<script>` tags with inline config (Next.js/Nuxt often embed theme data)
+4. Check for `<meta>` theme-color tags: `<meta name="theme-color" content="#7c3aed">`
+5. Fall back to full visual extraction from the screenshot
+
+## Output Format
+
+Always output your extraction as a structured token map before writing any code:
+
+```
+EXTRACTED DESIGN TOKENS
+========================
+Source: https://example.com
+Method: CSS custom properties + visual analysis
+
+COLORS
+  Background:
+    page:    #0a0a0f
+    surface: #13131a  (cards, panels)
+    elevated:#1a1a2e  (modals, dropdowns)
+  Text:
+    primary: #ffffff
+    secondary:#a0a0b8
+    muted:   #606080
+  Brand:
+    primary: #7c3aed
+    hover:   #6d28d9
+    glow:    rgba(124,58,237,0.3)
+  Border:   rgba(255,255,255,0.08)
+
+TYPOGRAPHY
+  Heading font: 'Inter', sans-serif (weights: 600, 700)
+  Body font:    'Inter', sans-serif (weight: 400)
+  Size scale:   12 / 14 / 16 / 20 / 24 / 32 / 48 / 64px
+  Line height:  1.5 body / 1.2 headings
+
+SPACING
+  Base unit: 8px
+  Scale: 4 / 8 / 12 / 16 / 20 / 24 / 32 / 48 / 64 / 96px
+
+BORDERS & EFFECTS
+  Radius sm:  6px   (badges, inputs)
+  Radius md:  12px  (cards)
+  Radius lg:  20px  (modals, large containers)
+  Radius pill: 9999px (buttons, tags)
+  Shadow:     0 4px 24px rgba(0,0,0,0.4)
+  Glass blur: backdrop-filter: blur(16px)
+
+GRADIENTS
+  Hero:    linear-gradient(135deg, #7c3aed 0%, #2563eb 100%)
+  Subtle:  radial-gradient(ellipse at top, rgba(124,58,237,0.15), transparent)
+
+ANIMATIONS
+  Transition: all 0.2s ease
+  Hover scale: transform: scale(1.02)
+```
diff --git a/.claude/skills/design-mirror/scripts/scrape_html.sh b/.claude/skills/design-mirror/scripts/scrape_html.sh
new file mode 100644
index 0000000..ab683a4
--- /dev/null
+++ b/.claude/skills/design-mirror/scripts/scrape_html.sh
@@ -0,0 +1,37 @@
+#!/bin/bash
+# Scrape full HTML (including inline CSS) from any URL via Bright Data Web Unlocker
+# Usage: bash scrape_html.sh "https://target-site.com" "/tmp/output.html"
+
+URL="$1"
+OUTPUT="${2:-/tmp/target_page.html}"
+
+if [ -z "$URL" ]; then
+    echo "Usage: $0 \"url\" [output_path]" >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_API_KEY:-}" ]; then
+    echo "Error: BRIGHTDATA_API_KEY is not set." >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_UNLOCKER_ZONE:-}" ]; then
+    echo "Error: BRIGHTDATA_UNLOCKER_ZONE is not set." >&2
+    exit 1
+fi
+
+echo "Scraping HTML from: $URL" >&2
+
+curl -k -s -X POST 'https://api.brightdata.com/request' \
+    -H "Authorization: Bearer $BRIGHTDATA_API_KEY" \
+    -H 'Content-Type: application/json' \
+    -d "{\"zone\":\"$BRIGHTDATA_UNLOCKER_ZONE\",\"url\":\"$URL\",\"format\":\"raw\"}" \
+    --output "$OUTPUT"
+
+if [ $? -eq 0 ] && [ -s "$OUTPUT" ]; then
+    echo "HTML saved to: $OUTPUT" >&2
+    echo "$OUTPUT"
+else
+    echo "Error: Failed to scrape HTML" >&2
+    exit 1
+fi
diff --git a/.claude/skills/design-mirror/scripts/screenshot.sh b/.claude/skills/design-mirror/scripts/screenshot.sh
new file mode 100644
index 0000000..1eed321
--- /dev/null
+++ b/.claude/skills/design-mirror/scripts/screenshot.sh
@@ -0,0 +1,37 @@
+#!/bin/bash
+# Capture a screenshot of any URL via Bright Data Web Unlocker
+# Usage: bash screenshot.sh "https://target-site.com" "/tmp/output.png"
+
+URL="$1"
+OUTPUT="${2:-/tmp/target_screenshot.png}"
+
+if [ -z "$URL" ]; then
+    echo "Usage: $0 \"url\" [output_path]" >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_API_KEY:-}" ]; then
+    echo "Error: BRIGHTDATA_API_KEY is not set." >&2
+    exit 1
+fi
+
+if [ -z "${BRIGHTDATA_UNLOCKER_ZONE:-}" ]; then
+    echo "Error: BRIGHTDATA_UNLOCKER_ZONE is not set." >&2
+    exit 1
+fi
+
+echo "Capturing screenshot of: $URL" >&2
+
+curl -k -s -X POST 'https://api.brightdata.com/request' \
+    -H "Authorization: Bearer $BRIGHTDATA_API_KEY" \
+    -H 'Content-Type: application/json' \
+    -d "{\"zone\":\"$BRIGHTDATA_UNLOCKER_ZONE\",\"url\":\"$URL\",\"format\":\"raw\",\"data_format\":\"screenshot\"}" \
+    --output "$OUTPUT"
+
+if [ $? -eq 0 ] && [ -s "$OUTPUT" ]; then
+    echo "Screenshot saved to: $OUTPUT" >&2
+    echo "$OUTPUT"
+else
+    echo "Error: Failed to capture screenshot" >&2
+    exit 1
+fi
diff --git a/.claude/skills/design-system-starter/SKILL.md b/.claude/skills/design-system-starter/SKILL.md
new file mode 100644
index 0000000..4d37e9b
--- /dev/null
+++ b/.claude/skills/design-system-starter/SKILL.md
@@ -0,0 +1,603 @@
+---
+name: design-system-starter
+description: Create and evolve design systems with design tokens, component architecture, accessibility guidelines, and documentation templates. Ensures consistent, scalable, and accessible UI across products.
+license: MIT
+metadata:
+  version: 1.0.0
+  tags: [design-system, ui, components, design-tokens, accessibility, frontend]
+---
+
+# Design System Starter
+
+Build robust, scalable design systems that ensure visual consistency and exceptional user experiences.
+
+---
+
+## Quick Start
+
+Just describe what you need:
+
+```
+Create a design system for my React app with dark mode support
+```
+
+That's it. The skill provides tokens, components, and accessibility guidelines.
+
+---
+
+## Triggers
+
+| Trigger | Example |
+|---------|---------|
+| Create design system | "Create a design system for my app" |
+| Design tokens | "Set up design tokens for colors and spacing" |
+| Component architecture | "Design component structure using atomic design" |
+| Accessibility | "Ensure WCAG 2.1 compliance for my components" |
+| Dark mode | "Implement theming with dark mode support" |
+
+---
+
+## Quick Reference
+
+| Task | Output |
+|------|--------|
+| Design tokens | Color, typography, spacing, shadows JSON |
+| Component structure | Atomic design hierarchy (atoms, molecules, organisms) |
+| Theming | CSS variables or ThemeProvider setup |
+| Accessibility | WCAG 2.1 AA compliant patterns |
+| Documentation | Component docs with props, examples, a11y notes |
+
+---
+
+## Bundled Resources
+
+- `references/component-examples.md` - Complete component implementations
+- `templates/design-tokens-template.json` - W3C design token format
+- `templates/component-template.tsx` - React component template
+- `checklists/design-system-checklist.md` - Design system audit checklist
+
+---
+
+## Design System Philosophy
+
+### What is a Design System?
+
+A design system is more than a component library—it's a collection of:
+
+1. **Design Tokens**: Foundational design decisions (colors, spacing, typography)
+2. **Components**: Reusable UI building blocks
+3. **Patterns**: Common UX solutions and compositions
+4. **Guidelines**: Rules, principles, and best practices
+5. **Documentation**: How to use everything effectively
+
+### Core Principles
+
+**1. Consistency Over Creativity**
+- Predictable patterns reduce cognitive load
+- Users learn once, apply everywhere
+- Designers and developers speak the same language
+
+**2. Accessible by Default**
+- WCAG 2.1 Level AA compliance minimum
+- Keyboard navigation built-in
+- Screen reader support from the start
+
+**3. Scalable and Maintainable**
+- Design tokens enable global changes
+- Component composition reduces duplication
+- Versioning and deprecation strategies
+
+**4. Developer-Friendly**
+- Clear API contracts
+- Comprehensive documentation
+- Easy to integrate and customize
+
+---
+
+## Design Tokens
+
+Design tokens are the atomic design decisions that define your system's visual language.
+
+### Token Categories
+
+#### 1. Color Tokens
+
+**Primitive Colors** (Raw values):
+```json
+{
+  "color": {
+    "primitive": {
+      "blue": {
+        "50": "#eff6ff",
+        "100": "#dbeafe",
+        "200": "#bfdbfe",
+        "300": "#93c5fd",
+        "400": "#60a5fa",
+        "500": "#3b82f6",
+        "600": "#2563eb",
+        "700": "#1d4ed8",
+        "800": "#1e40af",
+        "900": "#1e3a8a",
+        "950": "#172554"
+      }
+    }
+  }
+}
+```
+
+**Semantic Colors** (Contextual meaning):
+```json
+{
+  "color": {
+    "semantic": {
+      "brand": {
+        "primary": "{color.primitive.blue.600}",
+        "primary-hover": "{color.primitive.blue.700}",
+        "primary-active": "{color.primitive.blue.800}"
+      },
+      "text": {
+        "primary": "{color.primitive.gray.900}",
+        "secondary": "{color.primitive.gray.600}",
+        "tertiary": "{color.primitive.gray.500}",
+        "disabled": "{color.primitive.gray.400}",
+        "inverse": "{color.primitive.white}"
+      },
+      "background": {
+        "primary": "{color.primitive.white}",
+        "secondary": "{color.primitive.gray.50}",
+        "tertiary": "{color.primitive.gray.100}"
+      },
+      "feedback": {
+        "success": "{color.primitive.green.600}",
+        "warning": "{color.primitive.yellow.600}",
+        "error": "{color.primitive.red.600}",
+        "info": "{color.primitive.blue.600}"
+      }
+    }
+  }
+}
+```
+
+**Accessibility**: Ensure color contrast ratios meet WCAG 2.1 Level AA:
+- Normal text: 4.5:1 minimum
+- Large text (18pt+ or 14pt+ bold): 3:1 minimum
+- UI components and graphics: 3:1 minimum
+
+#### 2. Typography Tokens
+
+```json
+{
+  "typography": {
+    "fontFamily": {
+      "sans": "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+      "serif": "'Georgia', 'Times New Roman', serif",
+      "mono": "'Fira Code', 'Courier New', monospace"
+    },
+    "fontSize": {
+      "xs": "0.75rem",     // 12px
+      "sm": "0.875rem",    // 14px
+      "base": "1rem",      // 16px
+      "lg": "1.125rem",    // 18px
+      "xl": "1.25rem",     // 20px
+      "2xl": "1.5rem",     // 24px
+      "3xl": "1.875rem",   // 30px
+      "4xl": "2.25rem",    // 36px
+      "5xl": "3rem"        // 48px
+    },
+    "fontWeight": {
+      "normal": 400,
+      "medium": 500,
+      "semibold": 600,
+      "bold": 700
+    },
+    "lineHeight": {
+      "tight": 1.25,
+      "normal": 1.5,
+      "relaxed": 1.75,
+      "loose": 2
+    },
+    "letterSpacing": {
+      "tight": "-0.025em",
+      "normal": "0",
+      "wide": "0.025em"
+    }
+  }
+}
+```
+
+#### 3. Spacing Tokens
+
+**Scale**: Use a consistent spacing scale (commonly 4px or 8px base)
+
+```json
+{
+  "spacing": {
+    "0": "0",
+    "1": "0.25rem",   // 4px
+    "2": "0.5rem",    // 8px
+    "3": "0.75rem",   // 12px
+    "4": "1rem",      // 16px
+    "5": "1.25rem",   // 20px
+    "6": "1.5rem",    // 24px
+    "8": "2rem",      // 32px
+    "10": "2.5rem",   // 40px
+    "12": "3rem",     // 48px
+    "16": "4rem",     // 64px
+    "20": "5rem",     // 80px
+    "24": "6rem"      // 96px
+  }
+}
+```
+
+**Component-Specific Spacing**:
+```json
+{
+  "component": {
+    "button": {
+      "padding-x": "{spacing.4}",
+      "padding-y": "{spacing.2}",
+      "gap": "{spacing.2}"
+    },
+    "card": {
+      "padding": "{spacing.6}",
+      "gap": "{spacing.4}"
+    }
+  }
+}
+```
+
+#### 4. Border Radius Tokens
+
+```json
+{
+  "borderRadius": {
+    "none": "0",
+    "sm": "0.125rem",   // 2px
+    "base": "0.25rem",  // 4px
+    "md": "0.375rem",   // 6px
+    "lg": "0.5rem",     // 8px
+    "xl": "0.75rem",    // 12px
+    "2xl": "1rem",      // 16px
+    "full": "9999px"
+  }
+}
+```
+
+#### 5. Shadow Tokens
+
+```json
+{
+  "shadow": {
+    "xs": "0 1px 2px 0 rgba(0, 0, 0, 0.05)",
+    "sm": "0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1)",
+    "base": "0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1)",
+    "md": "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)",
+    "lg": "0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1)",
+    "xl": "0 25px 50px -12px rgba(0, 0, 0, 0.25)"
+  }
+}
+```
+
+---
+
+## Component Architecture
+
+### Atomic Design Methodology
+
+**Atoms** → **Molecules** → **Organisms** → **Templates** → **Pages**
+
+#### Atoms (Primitive Components)
+Basic building blocks that can't be broken down further.
+
+**Examples:**
+- Button
+- Input
+- Label
+- Icon
+- Badge
+- Avatar
+
+**Button Component:**
+```typescript
+interface ButtonProps {
+  variant?: 'primary' | 'secondary' | 'outline' | 'ghost';
+  size?: 'sm' | 'md' | 'lg';
+  disabled?: boolean;
+  loading?: boolean;
+  icon?: React.ReactNode;
+  children: React.ReactNode;
+}
+```
+
+See `references/component-examples.md` for complete Button implementation with variants, sizes, and styling patterns.
+
+#### Molecules (Simple Compositions)
+Groups of atoms that function together.
+
+**Examples:**
+- SearchBar (Input + Button)
+- FormField (Label + Input + ErrorMessage)
+- Card (Container + Title + Content + Actions)
+
+**FormField Molecule:**
+```typescript
+interface FormFieldProps {
+  label: string;
+  name: string;
+  error?: string;
+  hint?: string;
+  required?: boolean;
+  children: React.ReactNode;
+}
+```
+
+See `references/component-examples.md` for FormField, Card (compound component pattern), Input with variants, Modal, and more composition examples.
+
+#### Organisms (Complex Compositions)
+Complex UI components made of molecules and atoms.
+
+**Examples:**
+- Navigation Bar
+- Product Card Grid
+- User Profile Section
+- Modal Dialog
+
+#### Templates (Page Layouts)
+Page-level structures that define content placement.
+
+**Examples:**
+- Dashboard Layout (Sidebar + Header + Main Content)
+- Marketing Page Layout (Hero + Features + Footer)
+- Settings Page Layout (Tabs + Content Panels)
+
+#### Pages (Specific Instances)
+Actual pages with real content.
+
+---
+
+## Component API Design
+
+### Props Best Practices
+
+**1. Predictable Prop Names**
+```typescript
+// ✅ Good: Consistent naming
+<Button variant="primary" size="md" />
+<Input variant="outlined" size="md" />
+
+// ❌ Bad: Inconsistent
+<Button type="primary" sizeMode="md" />
+<Input style="outlined" inputSize="md" />
+```
+
+**2. Sensible Defaults**
+```typescript
+// ✅ Good: Provides defaults
+interface ButtonProps {
+  variant?: 'primary' | 'secondary';  // Default: primary
+  size?: 'sm' | 'md' | 'lg';          // Default: md
+}
+
+// ❌ Bad: Everything required
+interface ButtonProps {
+  variant: 'primary' | 'secondary';
+  size: 'sm' | 'md' | 'lg';
+  color: string;
+  padding: string;
+}
+```
+
+**3. Composition Over Configuration**
+```typescript
+// ✅ Good: Composable
+<Card>
+  <Card.Header>
+    <Card.Title>Title</Card.Title>
+  </Card.Header>
+  <Card.Body>Content</Card.Body>
+  <Card.Footer>Actions</Card.Footer>
+</Card>
+
+// ❌ Bad: Too many props
+<Card
+  title="Title"
+  content="Content"
+  footerContent="Actions"
+  hasHeader={true}
+  hasFooter={true}
+/>
+```
+
+**4. Polymorphic Components**
+Allow components to render as different HTML elements:
+```typescript
+<Button as="a" href="/login">Login</Button>
+<Button as="button" onClick={handleClick}>Click Me</Button>
+```
+
+See `references/component-examples.md` for complete polymorphic component TypeScript patterns.
+
+---
+
+## Theming and Dark Mode
+
+### Theme Structure
+
+```typescript
+interface Theme {
+  colors: {
+    brand: {
+      primary: string;
+      secondary: string;
+    };
+    text: {
+      primary: string;
+      secondary: string;
+    };
+    background: {
+      primary: string;
+      secondary: string;
+    };
+    feedback: {
+      success: string;
+      warning: string;
+      error: string;
+      info: string;
+    };
+  };
+  typography: {
+    fontFamily: {
+      sans: string;
+      mono: string;
+    };
+    fontSize: Record<string, string>;
+  };
+  spacing: Record<string, string>;
+  borderRadius: Record<string, string>;
+  shadow: Record<string, string>;
+}
+```
+
+### Dark Mode Implementation
+
+**Approach 1: CSS Variables**
+```css
+:root {
+  --color-bg-primary: #ffffff;
+  --color-text-primary: #000000;
+}
+
+[data-theme="dark"] {
+  --color-bg-primary: #1a1a1a;
+  --color-text-primary: #ffffff;
+}
+```
+
+**Approach 2: Tailwind CSS Dark Mode**
+```tsx
+<div className="bg-white dark:bg-gray-900 text-gray-900 dark:text-white">
+  Content
+</div>
+```
+
+**Approach 3: Styled Components ThemeProvider**
+```typescript
+const lightTheme = { background: '#fff', text: '#000' };
+const darkTheme = { background: '#000', text: '#fff' };
+
+<ThemeProvider theme={isDark ? darkTheme : lightTheme}>
+  <App />
+</ThemeProvider>
+```
+
+---
+
+## Accessibility Guidelines
+
+### WCAG 2.1 Level AA Compliance
+
+#### Color Contrast
+- **Normal text** (< 18pt): 4.5:1 minimum
+- **Large text** (≥ 18pt or ≥ 14pt bold): 3:1 minimum
+- **UI components**: 3:1 minimum
+
+**Tools**: Use contrast checkers like [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/)
+
+#### Keyboard Navigation
+```typescript
+// ✅ All interactive elements must be keyboard accessible
+<button
+  onClick={handleClick}
+  onKeyDown={(e) => e.key === 'Enter' && handleClick()}
+>
+  Click me
+</button>
+
+// ✅ Focus management
+<Modal>
+  <FocusTrap>
+    {/* Modal content */}
+  </FocusTrap>
+</Modal>
+```
+
+#### ARIA Attributes
+Essential ARIA patterns:
+- `aria-label`: Provide accessible names
+- `aria-expanded`: Communicate expanded/collapsed state
+- `aria-controls`: Associate controls with content
+- `aria-live`: Announce dynamic content changes
+
+#### Screen Reader Support
+- Use semantic HTML elements (`<button>`, `<nav>`, `<main>`)
+- Avoid div/span soup for interactive elements
+- Provide meaningful labels for all controls
+
+See `references/component-examples.md` for complete accessibility examples including Skip Links, focus traps, and ARIA patterns.
+
+---
+
+## Documentation Standards
+
+### Component Documentation Template
+
+Each component should document:
+- **Purpose**: What the component does
+- **Usage**: Import statement and basic example
+- **Variants**: Available visual styles
+- **Props**: Complete prop table with types, defaults, descriptions
+- **Accessibility**: Keyboard support, ARIA attributes, screen reader behavior
+- **Examples**: Common use cases with code
+
+Use Storybook, Docusaurus, or similar tools for interactive documentation.
+
+See `templates/component-template.tsx` for the standard component structure.
+
+---
+
+## Design System Workflow
+
+### 1. Design Phase
+- **Audit existing patterns**: Identify inconsistencies
+- **Define design tokens**: Colors, typography, spacing
+- **Create component inventory**: List all needed components
+- **Design in Figma**: Create component library
+
+### 2. Development Phase
+- **Set up tooling**: Storybook, TypeScript, testing
+- **Implement tokens**: CSS variables or theme config
+- **Build atoms first**: Start with primitives
+- **Compose upward**: Build molecules, organisms
+- **Document as you go**: Write docs alongside code
+
+### 3. Adoption Phase
+- **Create migration guide**: Help teams adopt
+- **Provide codemods**: Automate migrations when possible
+- **Run workshops**: Train teams on usage
+- **Gather feedback**: Iterate based on real usage
+
+### 4. Maintenance Phase
+- **Version semantically**: Major/minor/patch releases
+- **Deprecation strategy**: Phase out old components gracefully
+- **Changelog**: Document all changes
+- **Monitor adoption**: Track usage across products
+
+---
+
+## Quick Start Checklist
+
+When creating a new design system:
+
+- [ ] Define design principles and values
+- [ ] Establish design token structure (colors, typography, spacing)
+- [ ] Create primitive color palette (50-950 scale)
+- [ ] Define semantic color tokens (brand, text, background, feedback)
+- [ ] Set typography scale and font families
+- [ ] Establish spacing scale (4px or 8px base)
+- [ ] Design atomic components (Button, Input, Label, etc.)
+- [ ] Implement theming system (light/dark mode)
+- [ ] Ensure WCAG 2.1 Level AA compliance
+- [ ] Set up documentation (Storybook or similar)
+- [ ] Create usage examples for each component
+- [ ] Establish versioning and release strategy
+- [ ] Create migration guides for adopting teams
diff --git a/.claude/skills/design-system-starter/checklists/design-system-checklist.md b/.claude/skills/design-system-starter/checklists/design-system-checklist.md
new file mode 100644
index 0000000..5927b38
--- /dev/null
+++ b/.claude/skills/design-system-starter/checklists/design-system-checklist.md
@@ -0,0 +1,390 @@
+# Design System Checklist
+
+Use this comprehensive checklist when creating or auditing a design system.
+
+---
+
+## Foundation
+
+### Design Principles
+
+- [ ] **Principles Defined**: Core design principles documented (consistency, accessibility, simplicity, etc.)
+- [ ] **Values Articulated**: Team values reflected in design decisions
+- [ ] **Design Language Documented**: Visual design language explained (tone, personality)
+
+### Design Tokens
+
+#### Color Tokens
+- [ ] **Primitive Colors Defined**: Base color palette (50-950 scale for each hue)
+- [ ] **Semantic Colors Mapped**: Brand, text, background, border, feedback colors
+- [ ] **Color Contrast Validated**: All text meets WCAG 2.1 Level AA (4.5:1 for normal text, 3:1 for large text)
+- [ ] **Dark Mode Colors**: Dark theme variants defined (if applicable)
+- [ ] **Token Naming**: Consistent, semantic naming (text-primary vs gray-900)
+
+#### Typography Tokens
+- [ ] **Font Families Selected**: Primary (sans), secondary (serif), mono fonts
+- [ ] **Type Scale Established**: Font sizes from xs (12px) to 5xl (48px)
+- [ ] **Font Weights Defined**: At least 3 weights (normal, medium, bold)
+- [ ] **Line Heights Set**: Tight (headings), normal (body), relaxed (paragraphs)
+- [ ] **Letter Spacing**: Defined for uppercase and large headings
+
+#### Spacing Tokens
+- [ ] **Spacing Scale Created**: Consistent scale (4px or 8px base)
+- [ ] **Spacing Values**: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24
+- [ ] **Component Spacing**: Specific spacing for components (button padding, card gap)
+
+#### Other Tokens
+- [ ] **Border Radius**: none, sm, base, md, lg, xl, 2xl, full
+- [ ] **Shadows**: xs, sm, base, md, lg, xl
+- [ ] **Transitions**: Duration and easing functions
+- [ ] **Z-Index Scale**: Defined layering system
+
+---
+
+## Components
+
+### Atomic Components (Atoms)
+
+#### Button
+- [ ] **Variants**: Primary, secondary, outline, ghost
+- [ ] **Sizes**: sm, md, lg
+- [ ] **States**: Default, hover, active, focus, disabled, loading
+- [ ] **Icons**: Support for left/right icons
+- [ ] **Full Width**: Option for full-width buttons
+- [ ] **Accessibility**: Keyboard accessible, ARIA attributes
+
+#### Input
+- [ ] **Types**: Text, email, password, number, search
+- [ ] **Sizes**: sm, md, lg
+- [ ] **States**: Default, focus, error, disabled
+- [ ] **Icons**: Support for left/right icons
+- [ ] **Helper Text**: Support for hints and error messages
+- [ ] **Accessibility**: Labels, ARIA descriptions
+
+#### Checkbox & Radio
+- [ ] **Sizes**: sm, md, lg
+- [ ] **States**: Default, checked, indeterminate, disabled
+- [ ] **Labels**: Properly associated labels
+- [ ] **Accessibility**: Keyboard navigation, ARIA states
+
+#### Select / Dropdown
+- [ ] **Single Select**: Basic dropdown
+- [ ] **Multi Select**: Multiple selection support
+- [ ] **Search**: Searchable options (if applicable)
+- [ ] **States**: Default, open, disabled
+- [ ] **Accessibility**: Keyboard navigation, ARIA combobox
+
+#### Badge
+- [ ] **Variants**: Default, success, warning, error, info
+- [ ] **Sizes**: sm, md, lg
+- [ ] **Removable**: Option for dismiss button
+
+#### Avatar
+- [ ] **Sizes**: xs, sm, md, lg, xl
+- [ ] **Fallback**: Initials or default icon
+- [ ] **Status Indicator**: Online/offline dot (if applicable)
+
+#### Icon
+- [ ] **Icon Set**: Consistent icon library (Heroicons, Lucide, etc.)
+- [ ] **Sizes**: 16px, 20px, 24px, 32px
+- [ ] **Accessibility**: ARIA labels or aria-hidden
+
+### Molecular Components (Molecules)
+
+#### Form Field
+- [ ] **Composition**: Label + Input + Helper/Error
+- [ ] **Required Indicator**: Asterisk or (required) text
+- [ ] **Error States**: Validation error display
+- [ ] **Accessibility**: Proper label associations
+
+#### Search Bar
+- [ ] **Composition**: Input + Search button/icon
+- [ ] **Clear Button**: X to clear search
+- [ ] **Keyboard Support**: Enter to submit
+
+#### Card
+- [ ] **Variants**: Default, outlined, elevated
+- [ ] **Composition**: Header, body, footer sections
+- [ ] **Hover State**: If interactive
+- [ ] **Clickable Area**: Full card clickable (if applicable)
+
+#### Alert / Toast
+- [ ] **Variants**: Success, warning, error, info
+- [ ] **Dismissible**: Close button
+- [ ] **Icons**: Contextual icons for each variant
+- [ ] **Actions**: Optional action buttons
+
+### Organism Components
+
+#### Navigation Bar
+- [ ] **Responsive**: Mobile hamburger menu
+- [ ] **Logo**: Branding placement
+- [ ] **Links**: Primary navigation links
+- [ ] **Actions**: Login/signup buttons
+- [ ] **Dropdown**: Nested menu support
+- [ ] **Accessibility**: Keyboard navigation, ARIA navigation
+
+#### Modal / Dialog
+- [ ] **Overlay**: Background overlay
+- [ ] **Close Button**: X button and ESC key
+- [ ] **Focus Trap**: Focus stays within modal
+- [ ] **Sizes**: sm, md, lg, full
+- [ ] **Accessibility**: Focus management, ARIA dialog
+
+#### Table
+- [ ] **Header**: Column headers
+- [ ] **Sortable**: Click to sort columns
+- [ ] **Selectable**: Checkbox selection
+- [ ] **Pagination**: Built-in or separate component
+- [ ] **Responsive**: Mobile-friendly (stacked or scrollable)
+- [ ] **Accessibility**: Proper table semantics
+
+#### Pagination
+- [ ] **Page Numbers**: Current and nearby pages
+- [ ] **Previous/Next**: Arrow navigation
+- [ ] **First/Last**: Jump to first/last page
+- [ ] **Page Size**: Option to change items per page
+
+---
+
+## Patterns
+
+### Layout Patterns
+
+- [ ] **Grid System**: Responsive grid (12-column or flexbox/grid-based)
+- [ ] **Container**: Max-width container for content
+- [ ] **Stack**: Vertical spacing component
+- [ ] **Cluster**: Horizontal spacing component
+- [ ] **Sidebar Layout**: Sidebar + main content
+
+### Form Patterns
+
+- [ ] **Form Validation**: Client-side validation patterns
+- [ ] **Multi-Step Forms**: Wizard/stepper component
+- [ ] **Inline Editing**: Edit-in-place pattern
+- [ ] **Auto-Save**: Periodic save pattern
+
+### Navigation Patterns
+
+- [ ] **Breadcrumbs**: Path navigation
+- [ ] **Tabs**: Tab navigation component
+- [ ] **Sidebar Navigation**: Collapsible sidebar
+- [ ] **Mega Menu**: Large dropdown navigation
+
+### Feedback Patterns
+
+- [ ] **Loading States**: Skeletons, spinners, progress bars
+- [ ] **Empty States**: Illustrations and CTAs for empty data
+- [ ] **Error States**: User-friendly error pages (404, 500)
+- [ ] **Success Confirmation**: Post-action feedback
+
+---
+
+## Accessibility (WCAG 2.1 Level AA)
+
+### Perceivable
+
+- [ ] **Color Contrast**: 4.5:1 for normal text, 3:1 for large text
+- [ ] **Color Independence**: Information not conveyed by color alone
+- [ ] **Text Alternatives**: Alt text for images
+- [ ] **Captions**: Video/audio content has captions (if applicable)
+
+### Operable
+
+- [ ] **Keyboard Navigation**: All interactive elements keyboard accessible
+- [ ] **Focus Indicators**: Visible focus states (outline, ring)
+- [ ] **No Keyboard Traps**: Users can navigate away from all elements
+- [ ] **Skip Links**: "Skip to main content" link
+- [ ] **Touch Targets**: Minimum 44x44px for mobile
+
+### Understandable
+
+- [ ] **Language Attribute**: `<html lang="en">`
+- [ ] **Labels**: Form inputs have labels
+- [ ] **Error Messages**: Clear, specific error messages
+- [ ] **Consistent Navigation**: Navigation is consistent across pages
+
+### Robust
+
+- [ ] **Valid HTML**: Markup validates
+- [ ] **ARIA Attributes**: Proper ARIA labels, roles, states
+- [ ] **Name, Role, Value**: Interactive elements have accessible name
+
+---
+
+## Documentation
+
+### Component Documentation
+
+- [ ] **Usage Examples**: Code examples for each component
+- [ ] **Props API**: Table of props with types and defaults
+- [ ] **Variants**: Visual examples of all variants
+- [ ] **States**: Examples of all interactive states
+- [ ] **Accessibility Notes**: Keyboard shortcuts, ARIA attributes
+- [ ] **Do's and Don'ts**: Usage guidelines with examples
+
+### Design Guidelines
+
+- [ ] **When to Use**: Guidance on component selection
+- [ ] **Composition**: How to combine components
+- [ ] **Content Guidelines**: Copywriting standards
+- [ ] **Spacing Guidelines**: How to apply spacing tokens
+- [ ] **Responsive Patterns**: Mobile-first approach
+
+### Getting Started
+
+- [ ] **Installation**: How to install the design system
+- [ ] **Setup**: Configuration instructions
+- [ ] **Theming**: How to customize tokens
+- [ ] **Migration Guide**: Upgrading from previous versions
+
+---
+
+## Tooling & Infrastructure
+
+### Development Tools
+
+- [ ] **Component Library**: React/Vue/Angular/Web Components
+- [ ] **Storybook**: Component playground and documentation
+- [ ] **TypeScript**: Type definitions for all components
+- [ ] **Testing**: Unit and visual regression tests
+- [ ] **Linting**: ESLint/Stylelint configured
+
+### Build & Distribution
+
+- [ ] **Package Manager**: NPM/Yarn package published
+- [ ] **Versioning**: Semantic versioning (major.minor.patch)
+- [ ] **Changelog**: All changes documented
+- [ ] **Tree-Shaking**: Components importable individually
+- [ ] **Bundle Size**: Optimized for performance
+
+### Design Tools
+
+- [ ] **Figma Library**: Component library in Figma
+- [ ] **Design Tokens**: Tokens exported to Figma (Style Dictionary, Figma Tokens)
+- [ ] **Shared Styles**: Colors, text styles, effects synced
+- [ ] **Component Variants**: All variants available in Figma
+
+---
+
+## Theming & Customization
+
+### Theme Support
+
+- [ ] **Light Theme**: Default light mode
+- [ ] **Dark Theme**: Dark mode variant
+- [ ] **Theme Toggle**: Mechanism to switch themes
+- [ ] **System Preference**: Respect OS theme preference
+- [ ] **Persistent Choice**: Remember user's theme choice
+
+### Customization
+
+- [ ] **Token Override**: Ability to override design tokens
+- [ ] **CSS Variables**: Tokens exposed as CSS variables
+- [ ] **Theme API**: Programmatic theme customization
+- [ ] **Brand Variants**: Support for multiple brands (if applicable)
+
+---
+
+## Quality Assurance
+
+### Visual Testing
+
+- [ ] **Visual Regression Tests**: Chromatic, Percy, or similar
+- [ ] **Cross-Browser Testing**: Chrome, Firefox, Safari, Edge
+- [ ] **Responsive Testing**: Mobile, tablet, desktop viewports
+- [ ] **Dark Mode Testing**: All components in dark mode
+
+### Functional Testing
+
+- [ ] **Unit Tests**: Component logic tested
+- [ ] **Integration Tests**: Component interactions tested
+- [ ] **Accessibility Tests**: Automated a11y tests (axe, WAVE)
+
+### Performance
+
+- [ ] **Bundle Size**: < 100KB gzipped for core components
+- [ ] **Lazy Loading**: Heavy components lazy-loaded
+- [ ] **Tree-Shaking**: Unused components not included
+
+---
+
+## Governance
+
+### Contribution Guidelines
+
+- [ ] **CONTRIBUTING.md**: How to contribute
+- [ ] **Code of Conduct**: Community standards
+- [ ] **PR Template**: Standard pull request format
+- [ ] **Review Process**: How contributions are reviewed
+
+### Versioning & Deprecation
+
+- [ ] **Semantic Versioning**: Follow SemVer
+- [ ] **Deprecation Policy**: How long deprecated components are supported
+- [ ] **Migration Guides**: Help for breaking changes
+- [ ] **Release Notes**: What changed in each version
+
+### Roadmap
+
+- [ ] **Public Roadmap**: Future plans visible
+- [ ] **Feedback Channel**: Users can request features
+- [ ] **Regular Releases**: Predictable release schedule
+
+---
+
+## Adoption & Maintenance
+
+### Onboarding
+
+- [ ] **Getting Started Guide**: Quick start documentation
+- [ ] **Tutorial**: Step-by-step walkthrough
+- [ ] **Video Demos**: Recorded demos (optional)
+- [ ] **Support Channel**: Slack, Discord, or forum
+
+### Metrics
+
+- [ ] **Adoption Tracking**: Monitor usage across products
+- [ ] **Component Usage**: Which components are most used
+- [ ] **Issue Tracking**: Bug reports and feature requests
+- [ ] **Performance Metrics**: Bundle size, load times
+
+### Iteration
+
+- [ ] **Quarterly Reviews**: Regular design system audits
+- [ ] **User Research**: Gather feedback from users
+- [ ] **Component Deprecation**: Remove unused components
+- [ ] **Design Updates**: Refresh styles periodically
+
+---
+
+## Pre-Launch Checklist
+
+Before publishing v1.0:
+
+- [ ] **All Atoms Complete**: Button, Input, Checkbox, Radio, Select, Badge, Avatar, Icon
+- [ ] **Key Molecules Complete**: FormField, Card, Alert, SearchBar
+- [ ] **Core Organisms Complete**: Modal, Navigation, Table, Pagination
+- [ ] **Design Tokens Finalized**: Colors, typography, spacing locked
+- [ ] **Accessibility Audit**: WCAG 2.1 Level AA compliance verified
+- [ ] **Documentation Complete**: All components documented
+- [ ] **Tests Passing**: 100% test pass rate
+- [ ] **Figma Library Published**: Design library available
+- [ ] **NPM Package Published**: Package available on NPM
+- [ ] **Migration Guide**: From previous system or custom components
+
+---
+
+## Post-Launch
+
+- [ ] **Announce Launch**: Internal announcement and blog post
+- [ ] **Training Sessions**: Workshops for teams
+- [ ] **Office Hours**: Regular Q&A sessions
+- [ ] **Gather Feedback**: Collect early adopter feedback
+- [ ] **Iterate Quickly**: Address issues in patch releases
+
+---
+
+**Checklist Version**: 1.0.0
+**Skill**: design-system-starter v1.0.0
+**Last Updated**: 2025-10-31
diff --git a/.claude/skills/design-system-starter/references/component-examples.md b/.claude/skills/design-system-starter/references/component-examples.md
new file mode 100644
index 0000000..44f7297
--- /dev/null
+++ b/.claude/skills/design-system-starter/references/component-examples.md
@@ -0,0 +1,578 @@
+# Design System Component Examples
+
+Detailed implementation examples for common design system components.
+
+## Button Component (Complete Implementation)
+
+```typescript
+/**
+ * Button Component - Primary interactive element
+ */
+
+import React from 'react';
+import { cn } from '../utils/cn';
+
+export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost';
+export type ButtonSize = 'sm' | 'md' | 'lg';
+
+export interface ButtonProps {
+  variant?: ButtonVariant;
+  size?: ButtonSize;
+  disabled?: boolean;
+  loading?: boolean;
+  icon?: React.ReactNode;
+  children: React.ReactNode;
+  onClick?: () => void;
+}
+
+const buttonStyles = {
+  base: 'inline-flex items-center justify-center font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',
+
+  variants: {
+    primary: 'bg-blue-600 text-white hover:bg-blue-700 focus-visible:ring-blue-500',
+    secondary: 'bg-gray-600 text-white hover:bg-gray-700 focus-visible:ring-gray-500',
+    outline: 'border border-gray-300 bg-transparent hover:bg-gray-100 focus-visible:ring-gray-500',
+    ghost: 'hover:bg-gray-100 focus-visible:ring-gray-500',
+  },
+
+  sizes: {
+    sm: 'h-8 px-3 text-sm rounded-md',
+    md: 'h-10 px-4 text-base rounded-md',
+    lg: 'h-12 px-6 text-lg rounded-lg',
+  },
+};
+
+export function Button({
+  variant = 'primary',
+  size = 'md',
+  disabled = false,
+  loading = false,
+  icon,
+  children,
+  onClick
+}: ButtonProps) {
+  return (
+    <button
+      className={cn(
+        buttonStyles.base,
+        buttonStyles.variants[variant],
+        buttonStyles.sizes[size],
+        { 'pointer-events-none opacity-50': loading }
+      )}
+      disabled={disabled || loading}
+      onClick={onClick}
+      aria-busy={loading}
+    >
+      {icon && <span className="mr-2">{icon}</span>}
+      <span>{children}</span>
+      {loading && <span className="ml-2 animate-spin">⏳</span>}
+    </button>
+  );
+}
+```
+
+## Form Field Component (Molecule)
+
+```typescript
+/**
+ * FormField - Composition of Label + Input + Helper/Error
+ */
+
+interface FormFieldProps {
+  label: string;
+  name: string;
+  error?: string;
+  hint?: string;
+  required?: boolean;
+  children: React.ReactNode;
+}
+
+export function FormField({
+  label,
+  name,
+  error,
+  hint,
+  required,
+  children
+}: FormFieldProps) {
+  return (
+    <div className="form-field space-y-2">
+      <label
+        htmlFor={name}
+        className="block text-sm font-medium text-gray-700"
+      >
+        {label}
+        {required && <span className="text-red-500 ml-1">*</span>}
+      </label>
+
+      {children}
+
+      {hint && !error && (
+        <p className="text-sm text-gray-500">{hint}</p>
+      )}
+
+      {error && (
+        <p className="text-sm text-red-600" role="alert">
+          {error}
+        </p>
+      )}
+    </div>
+  );
+}
+```
+
+## Card Component (Compound Component Pattern)
+
+```typescript
+/**
+ * Card - Composable container component
+ */
+
+interface CardProps {
+  variant?: 'default' | 'outlined' | 'elevated';
+  children: React.ReactNode;
+  className?: string;
+}
+
+const cardStyles = {
+  default: 'bg-white border border-gray-200',
+  outlined: 'bg-white border-2 border-gray-300',
+  elevated: 'bg-white shadow-lg',
+};
+
+export function Card({
+  variant = 'default',
+  children,
+  className
+}: CardProps) {
+  return (
+    <div
+      className={cn(
+        'rounded-lg p-6',
+        cardStyles[variant],
+        className
+      )}
+    >
+      {children}
+    </div>
+  );
+}
+
+// Compound components
+Card.Header = function CardHeader({ children }: { children: React.ReactNode }) {
+  return <div className="mb-4 border-b border-gray-200 pb-4">{children}</div>;
+};
+
+Card.Title = function CardTitle({ children }: { children: React.ReactNode }) {
+  return <h3 className="text-lg font-semibold text-gray-900">{children}</h3>;
+};
+
+Card.Body = function CardBody({ children }: { children: React.ReactNode }) {
+  return <div className="space-y-4">{children}</div>;
+};
+
+Card.Footer = function CardFooter({ children }: { children: React.ReactNode }) {
+  return <div className="mt-4 pt-4 border-t border-gray-200">{children}</div>;
+};
+
+// Usage Example:
+/*
+<Card variant="elevated">
+  <Card.Header>
+    <Card.Title>User Profile</Card.Title>
+  </Card.Header>
+  <Card.Body>
+    <p>Profile content goes here</p>
+  </Card.Body>
+  <Card.Footer>
+    <Button>Edit Profile</Button>
+  </Card.Footer>
+</Card>
+*/
+```
+
+## Input Component with Variants
+
+```typescript
+/**
+ * Input - Text input with validation states
+ */
+
+interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+  variant?: 'default' | 'error' | 'success';
+  leftIcon?: React.ReactNode;
+  rightIcon?: React.ReactNode;
+}
+
+const inputStyles = {
+  base: 'w-full rounded-md px-3 py-2 text-sm border transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2',
+
+  variants: {
+    default: 'border-gray-300 focus:border-blue-500 focus:ring-blue-500',
+    error: 'border-red-500 focus:border-red-500 focus:ring-red-500',
+    success: 'border-green-500 focus:border-green-500 focus:ring-green-500',
+  },
+};
+
+export function Input({
+  variant = 'default',
+  leftIcon,
+  rightIcon,
+  className,
+  ...props
+}: InputProps) {
+  return (
+    <div className="relative">
+      {leftIcon && (
+        <div className="absolute left-3 top-1/2 -translate-y-1/2 text-gray-400">
+          {leftIcon}
+        </div>
+      )}
+
+      <input
+        className={cn(
+          inputStyles.base,
+          inputStyles.variants[variant],
+          { 'pl-10': leftIcon },
+          { 'pr-10': rightIcon },
+          className
+        )}
+        {...props}
+      />
+
+      {rightIcon && (
+        <div className="absolute right-3 top-1/2 -translate-y-1/2 text-gray-400">
+          {rightIcon}
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+## Modal Component (Organism)
+
+```typescript
+/**
+ * Modal - Dialog with focus trap and overlay
+ */
+
+import { useEffect, useRef } from 'react';
+
+interface ModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  title: string;
+  children: React.ReactNode;
+  size?: 'sm' | 'md' | 'lg' | 'full';
+}
+
+const modalSizes = {
+  sm: 'max-w-md',
+  md: 'max-w-lg',
+  lg: 'max-w-2xl',
+  full: 'max-w-full',
+};
+
+export function Modal({
+  isOpen,
+  onClose,
+  title,
+  children,
+  size = 'md'
+}: ModalProps) {
+  const modalRef = useRef<HTMLDivElement>(null);
+
+  // Focus trap
+  useEffect(() => {
+    if (isOpen) {
+      modalRef.current?.focus();
+    }
+  }, [isOpen]);
+
+  // ESC key handler
+  useEffect(() => {
+    const handleEsc = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') onClose();
+    };
+
+    if (isOpen) {
+      document.addEventListener('keydown', handleEsc);
+      document.body.style.overflow = 'hidden'; // Prevent background scroll
+    }
+
+    return () => {
+      document.removeEventListener('keydown', handleEsc);
+      document.body.style.overflow = '';
+    };
+  }, [isOpen, onClose]);
+
+  if (!isOpen) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center"
+      role="dialog"
+      aria-modal="true"
+      aria-labelledby="modal-title"
+    >
+      {/* Overlay */}
+      <div
+        className="absolute inset-0 bg-black bg-opacity-50"
+        onClick={onClose}
+      />
+
+      {/* Modal */}
+      <div
+        ref={modalRef}
+        className={cn(
+          'relative bg-white rounded-lg shadow-xl w-full mx-4',
+          modalSizes[size]
+        )}
+        tabIndex={-1}
+      >
+        {/* Header */}
+        <div className="flex items-center justify-between px-6 py-4 border-b">
+          <h2 id="modal-title" className="text-xl font-semibold">
+            {title}
+          </h2>
+          <button
+            onClick={onClose}
+            className="text-gray-400 hover:text-gray-600"
+            aria-label="Close"
+          >
+            ✕
+          </button>
+        </div>
+
+        {/* Body */}
+        <div className="px-6 py-4">
+          {children}
+        </div>
+      </div>
+    </div>
+  );
+}
+```
+
+## Polymorphic Component Example
+
+```typescript
+/**
+ * Polymorphic Button - Can render as button, link, etc.
+ */
+
+type AsProp<C extends React.ElementType> = {
+  as?: C;
+};
+
+type PropsToOmit<C extends React.ElementType, P> = keyof (AsProp<C> & P);
+
+type PolymorphicComponentProp<
+  C extends React.ElementType,
+  Props = {}
+> = React.PropsWithChildren<Props & AsProp<C>> &
+  Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
+
+type PolymorphicRef<C extends React.ElementType> =
+  React.ComponentPropsWithRef<C>['ref'];
+
+type PolymorphicComponentPropWithRef<
+  C extends React.ElementType,
+  Props = {}
+> = PolymorphicComponentProp<C, Props> & { ref?: PolymorphicRef<C> };
+
+interface ButtonBaseProps {
+  variant?: 'primary' | 'secondary';
+}
+
+export type ButtonProps<C extends React.ElementType = 'button'> =
+  PolymorphicComponentPropWithRef<C, ButtonBaseProps>;
+
+export const PolymorphicButton = <C extends React.ElementType = 'button'>({
+  as,
+  variant = 'primary',
+  children,
+  ...props
+}: ButtonProps<C>) => {
+  const Component = as || 'button';
+
+  return (
+    <Component
+      className={cn('px-4 py-2 rounded', {
+        'bg-blue-600 text-white': variant === 'primary',
+        'bg-gray-600 text-white': variant === 'secondary',
+      })}
+      {...props}
+    >
+      {children}
+    </Component>
+  );
+};
+
+// Usage:
+// <PolymorphicButton>Button</PolymorphicButton>
+// <PolymorphicButton as="a" href="/login">Link</PolymorphicButton>
+```
+
+## Accessibility Example - Skip Link
+
+```typescript
+/**
+ * Skip Link - Keyboard accessibility helper
+ */
+
+export function SkipLink() {
+  return (
+    <a
+      href="#main-content"
+      className="sr-only focus:not-sr-only focus:absolute focus:top-4 focus:left-4 focus:z-50 focus:px-4 focus:py-2 focus:bg-blue-600 focus:text-white focus:rounded"
+    >
+      Skip to main content
+    </a>
+  );
+}
+
+// CSS for sr-only (screen reader only):
+/*
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border-width: 0;
+}
+
+.focus\:not-sr-only:focus {
+  position: static;
+  width: auto;
+  height: auto;
+  padding: revert;
+  margin: revert;
+  overflow: visible;
+  clip: auto;
+  white-space: normal;
+}
+*/
+```
+
+## Theme Switching Example
+
+```typescript
+/**
+ * Theme Toggle - Dark mode switcher
+ */
+
+import { useEffect, useState } from 'react';
+
+export function ThemeToggle() {
+  const [theme, setTheme] = useState<'light' | 'dark'>('light');
+
+  useEffect(() => {
+    // Check system preference on mount
+    const isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+    const savedTheme = localStorage.getItem('theme') as 'light' | 'dark' || (isDark ? 'dark' : 'light');
+    setTheme(savedTheme);
+    document.documentElement.setAttribute('data-theme', savedTheme);
+  }, []);
+
+  const toggleTheme = () => {
+    const newTheme = theme === 'light' ? 'dark' : 'light';
+    setTheme(newTheme);
+    document.documentElement.setAttribute('data-theme', newTheme);
+    localStorage.setItem('theme', newTheme);
+  };
+
+  return (
+    <button
+      onClick={toggleTheme}
+      aria-label={`Switch to ${theme === 'light' ? 'dark' : 'light'} mode`}
+      className="p-2 rounded-md hover:bg-gray-100 dark:hover:bg-gray-800"
+    >
+      {theme === 'light' ? '🌙' : '☀️'}
+    </button>
+  );
+}
+```
+
+## Responsive Navigation Example
+
+```typescript
+/**
+ * Navigation Bar - Responsive with mobile menu
+ */
+
+import { useState } from 'react';
+
+export function Navigation() {
+  const [mobileMenuOpen, setMobileMenuOpen] = useState(false);
+
+  return (
+    <nav className="bg-white border-b border-gray-200" aria-label="Main navigation">
+      <div className="container mx-auto px-4">
+        <div className="flex items-center justify-between h-16">
+          {/* Logo */}
+          <div className="flex-shrink-0">
+            <a href="/" className="text-xl font-bold">
+              Logo
+            </a>
+          </div>
+
+          {/* Desktop Navigation */}
+          <div className="hidden md:flex space-x-8">
+            <a href="/features" className="text-gray-700 hover:text-gray-900">
+              Features
+            </a>
+            <a href="/pricing" className="text-gray-700 hover:text-gray-900">
+              Pricing
+            </a>
+            <a href="/about" className="text-gray-700 hover:text-gray-900">
+              About
+            </a>
+          </div>
+
+          {/* Mobile Menu Button */}
+          <button
+            className="md:hidden p-2"
+            onClick={() => setMobileMenuOpen(!mobileMenuOpen)}
+            aria-label="Toggle mobile menu"
+            aria-expanded={mobileMenuOpen}
+          >
+            <span className="block w-6 h-0.5 bg-gray-900 mb-1"></span>
+            <span className="block w-6 h-0.5 bg-gray-900 mb-1"></span>
+            <span className="block w-6 h-0.5 bg-gray-900"></span>
+          </button>
+        </div>
+
+        {/* Mobile Menu */}
+        {mobileMenuOpen && (
+          <div className="md:hidden py-4">
+            <a
+              href="/features"
+              className="block py-2 text-gray-700 hover:bg-gray-100"
+            >
+              Features
+            </a>
+            <a
+              href="/pricing"
+              className="block py-2 text-gray-700 hover:bg-gray-100"
+            >
+              Pricing
+            </a>
+            <a
+              href="/about"
+              className="block py-2 text-gray-700 hover:bg-gray-100"
+            >
+              About
+            </a>
+          </div>
+        )}
+      </div>
+    </nav>
+  );
+}
+```
diff --git a/.claude/skills/design-system-starter/templates/component-template.tsx b/.claude/skills/design-system-starter/templates/component-template.tsx
new file mode 100644
index 0000000..f4f6aa5
--- /dev/null
+++ b/.claude/skills/design-system-starter/templates/component-template.tsx
@@ -0,0 +1,252 @@
+/**
+ * Component Name
+ *
+ * Brief description of what this component does and when to use it.
+ *
+ * @example
+ * ```tsx
+ * <ComponentName variant="primary" size="md">
+ *   Content
+ * </ComponentName>
+ * ```
+ */
+
+import React from 'react';
+import { cn } from '../utils/cn'; // Utility for className merging
+
+// ============================================================================
+// Types & Interfaces
+// ============================================================================
+
+/**
+ * Variants define the visual style of the component
+ */
+export type ComponentVariant = 'primary' | 'secondary' | 'outline' | 'ghost';
+
+/**
+ * Sizes define the dimensions of the component
+ */
+export type ComponentSize = 'sm' | 'md' | 'lg';
+
+/**
+ * Props for the Component
+ */
+export interface ComponentProps {
+  /**
+   * Visual variant of the component
+   * @default 'primary'
+   */
+  variant?: ComponentVariant;
+
+  /**
+   * Size of the component
+   * @default 'md'
+   */
+  size?: ComponentSize;
+
+  /**
+   * Whether the component is disabled
+   * @default false
+   */
+  disabled?: boolean;
+
+  /**
+   * Additional CSS classes to apply
+   */
+  className?: string;
+
+  /**
+   * Content to be rendered inside the component
+   */
+  children: React.ReactNode;
+
+  /**
+   * Optional click handler
+   */
+  onClick?: (event: React.MouseEvent<HTMLElement>) => void;
+
+  /**
+   * ARIA label for accessibility
+   */
+  'aria-label'?: string;
+}
+
+// ============================================================================
+// Component Styles (if using CSS-in-JS or className-based styling)
+// ============================================================================
+
+const componentStyles = {
+  base: 'inline-flex items-center justify-center font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',
+
+  variants: {
+    primary: 'bg-blue-600 text-white hover:bg-blue-700 focus-visible:ring-blue-500',
+    secondary: 'bg-gray-600 text-white hover:bg-gray-700 focus-visible:ring-gray-500',
+    outline: 'border border-gray-300 bg-transparent hover:bg-gray-100 focus-visible:ring-gray-500',
+    ghost: 'hover:bg-gray-100 focus-visible:ring-gray-500',
+  },
+
+  sizes: {
+    sm: 'h-8 px-3 text-sm rounded-md',
+    md: 'h-10 px-4 text-base rounded-md',
+    lg: 'h-12 px-6 text-lg rounded-lg',
+  },
+};
+
+// ============================================================================
+// Component Implementation
+// ============================================================================
+
+export const Component = React.forwardRef<HTMLDivElement, ComponentProps>(
+  (
+    {
+      variant = 'primary',
+      size = 'md',
+      disabled = false,
+      className,
+      children,
+      onClick,
+      'aria-label': ariaLabel,
+    },
+    ref
+  ) => {
+    // =========================================================================
+    // State & Hooks
+    // =========================================================================
+
+    // Example: Track internal state if needed
+    // const [isActive, setIsActive] = React.useState(false);
+
+    // =========================================================================
+    // Event Handlers
+    // =========================================================================
+
+    const handleClick = (event: React.MouseEvent<HTMLDivElement>) => {
+      if (disabled) return;
+      onClick?.(event);
+    };
+
+    const handleKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
+      // Handle Enter and Space for keyboard accessibility
+      if (disabled) return;
+      if (event.key === 'Enter' || event.key === ' ') {
+        event.preventDefault();
+        onClick?.(event as any);
+      }
+    };
+
+    // =========================================================================
+    // Render
+    // =========================================================================
+
+    return (
+      <div
+        ref={ref}
+        className={cn(
+          componentStyles.base,
+          componentStyles.variants[variant],
+          componentStyles.sizes[size],
+          className
+        )}
+        onClick={handleClick}
+        onKeyDown={handleKeyDown}
+        role="button"
+        tabIndex={disabled ? -1 : 0}
+        aria-disabled={disabled}
+        aria-label={ariaLabel}
+      >
+        {children}
+      </div>
+    );
+  }
+);
+
+Component.displayName = 'Component';
+
+// ============================================================================
+// Compound Components (if applicable)
+// ============================================================================
+
+/**
+ * Example of a compound component pattern
+ */
+export const ComponentHeader = ({ children }: { children: React.ReactNode }) => {
+  return <div className="component-header">{children}</div>;
+};
+
+/**
+ * Compound component for body content
+ */
+export const ComponentBody = ({ children }: { children: React.ReactNode }) => {
+  return <div className="component-body">{children}</div>;
+};
+
+// Attach compound components
+Component.Header = ComponentHeader;
+Component.Body = ComponentBody;
+
+// ============================================================================
+// Usage Examples (for documentation/Storybook)
+// ============================================================================
+
+/**
+ * Example 1: Basic usage
+ */
+export const BasicExample = () => (
+  <Component variant="primary" size="md">
+    Click me
+  </Component>
+);
+
+/**
+ * Example 2: With different variants
+ */
+export const VariantsExample = () => (
+  <div className="flex gap-4">
+    <Component variant="primary">Primary</Component>
+    <Component variant="secondary">Secondary</Component>
+    <Component variant="outline">Outline</Component>
+    <Component variant="ghost">Ghost</Component>
+  </div>
+);
+
+/**
+ * Example 3: With different sizes
+ */
+export const SizesExample = () => (
+  <div className="flex items-center gap-4">
+    <Component variant="primary" size="sm">
+      Small
+    </Component>
+    <Component variant="primary" size="md">
+      Medium
+    </Component>
+    <Component variant="primary" size="lg">
+      Large
+    </Component>
+  </div>
+);
+
+/**
+ * Example 4: Disabled state
+ */
+export const DisabledExample = () => (
+  <Component variant="primary" disabled>
+    Disabled
+  </Component>
+);
+
+/**
+ * Example 5: Compound component usage
+ */
+export const CompoundExample = () => (
+  <Component variant="primary">
+    <Component.Header>Header</Component.Header>
+    <Component.Body>Body content</Component.Body>
+  </Component>
+);
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+export default Component;
diff --git a/.claude/skills/design-system-starter/templates/design-tokens-template.json b/.claude/skills/design-system-starter/templates/design-tokens-template.json
new file mode 100644
index 0000000..55631a1
--- /dev/null
+++ b/.claude/skills/design-system-starter/templates/design-tokens-template.json
@@ -0,0 +1,735 @@
+{
+  "$schema": "https://design-tokens.org/schemas/v1.0.0/design-tokens.schema.json",
+  "name": "YourCompany Design Tokens",
+  "version": "1.0.0",
+  "color": {
+    "primitive": {
+      "white": {
+        "$type": "color",
+        "$value": "#ffffff"
+      },
+      "black": {
+        "$type": "color",
+        "$value": "#000000"
+      },
+      "gray": {
+        "50": {
+          "$type": "color",
+          "$value": "#f9fafb"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#f3f4f6"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#e5e7eb"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#d1d5db"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#9ca3af"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#6b7280"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#4b5563"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#374151"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#1f2937"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#111827"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#030712"
+        }
+      },
+      "blue": {
+        "50": {
+          "$type": "color",
+          "$value": "#eff6ff"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#dbeafe"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#bfdbfe"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#93c5fd"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#60a5fa"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#3b82f6"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#2563eb"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#1d4ed8"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#1e40af"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#1e3a8a"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#172554"
+        }
+      },
+      "green": {
+        "50": {
+          "$type": "color",
+          "$value": "#f0fdf4"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#dcfce7"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#bbf7d0"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#86efac"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#4ade80"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#22c55e"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#16a34a"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#15803d"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#166534"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#14532d"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#052e16"
+        }
+      },
+      "red": {
+        "50": {
+          "$type": "color",
+          "$value": "#fef2f2"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#fee2e2"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#fecaca"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#fca5a5"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#f87171"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#ef4444"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#dc2626"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#b91c1c"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#991b1b"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#7f1d1d"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#450a0a"
+        }
+      },
+      "yellow": {
+        "50": {
+          "$type": "color",
+          "$value": "#fefce8"
+        },
+        "100": {
+          "$type": "color",
+          "$value": "#fef9c3"
+        },
+        "200": {
+          "$type": "color",
+          "$value": "#fef08a"
+        },
+        "300": {
+          "$type": "color",
+          "$value": "#fde047"
+        },
+        "400": {
+          "$type": "color",
+          "$value": "#facc15"
+        },
+        "500": {
+          "$type": "color",
+          "$value": "#eab308"
+        },
+        "600": {
+          "$type": "color",
+          "$value": "#ca8a04"
+        },
+        "700": {
+          "$type": "color",
+          "$value": "#a16207"
+        },
+        "800": {
+          "$type": "color",
+          "$value": "#854d0e"
+        },
+        "900": {
+          "$type": "color",
+          "$value": "#713f12"
+        },
+        "950": {
+          "$type": "color",
+          "$value": "#422006"
+        }
+      }
+    },
+    "semantic": {
+      "brand": {
+        "primary": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.600}",
+          "$description": "Primary brand color for CTAs and key UI elements"
+        },
+        "primary-hover": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.700}"
+        },
+        "primary-active": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.800}"
+        },
+        "secondary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.600}"
+        },
+        "secondary-hover": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.700}"
+        }
+      },
+      "text": {
+        "primary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.900}",
+          "$description": "Primary text color for body content"
+        },
+        "secondary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.600}",
+          "$description": "Secondary text color for supporting content"
+        },
+        "tertiary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.500}",
+          "$description": "Tertiary text color for hints and metadata"
+        },
+        "disabled": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.400}",
+          "$description": "Text color for disabled elements"
+        },
+        "inverse": {
+          "$type": "color",
+          "$value": "{color.primitive.white}",
+          "$description": "Text color for dark backgrounds"
+        }
+      },
+      "background": {
+        "primary": {
+          "$type": "color",
+          "$value": "{color.primitive.white}",
+          "$description": "Primary background color"
+        },
+        "secondary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.50}",
+          "$description": "Secondary background color for sections"
+        },
+        "tertiary": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.100}",
+          "$description": "Tertiary background for less emphasis"
+        }
+      },
+      "border": {
+        "default": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.200}",
+          "$description": "Default border color"
+        },
+        "strong": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.300}",
+          "$description": "Strong border color for emphasis"
+        },
+        "subtle": {
+          "$type": "color",
+          "$value": "{color.primitive.gray.100}",
+          "$description": "Subtle border color for light separation"
+        }
+      },
+      "feedback": {
+        "success": {
+          "$type": "color",
+          "$value": "{color.primitive.green.600}",
+          "$description": "Success state color"
+        },
+        "warning": {
+          "$type": "color",
+          "$value": "{color.primitive.yellow.600}",
+          "$description": "Warning state color"
+        },
+        "error": {
+          "$type": "color",
+          "$value": "{color.primitive.red.600}",
+          "$description": "Error state color"
+        },
+        "info": {
+          "$type": "color",
+          "$value": "{color.primitive.blue.600}",
+          "$description": "Info state color"
+        }
+      }
+    }
+  },
+  "typography": {
+    "fontFamily": {
+      "sans": {
+        "$type": "fontFamily",
+        "$value": "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif",
+        "$description": "Sans-serif font family for UI text"
+      },
+      "serif": {
+        "$type": "fontFamily",
+        "$value": "'Georgia', 'Times New Roman', serif",
+        "$description": "Serif font family for editorial content"
+      },
+      "mono": {
+        "$type": "fontFamily",
+        "$value": "'Fira Code', 'Consolas', 'Courier New', monospace",
+        "$description": "Monospace font family for code"
+      }
+    },
+    "fontSize": {
+      "xs": {
+        "$type": "dimension",
+        "$value": "0.75rem",
+        "$description": "12px - Extra small text"
+      },
+      "sm": {
+        "$type": "dimension",
+        "$value": "0.875rem",
+        "$description": "14px - Small text"
+      },
+      "base": {
+        "$type": "dimension",
+        "$value": "1rem",
+        "$description": "16px - Base body text"
+      },
+      "lg": {
+        "$type": "dimension",
+        "$value": "1.125rem",
+        "$description": "18px - Large text"
+      },
+      "xl": {
+        "$type": "dimension",
+        "$value": "1.25rem",
+        "$description": "20px - Extra large text"
+      },
+      "2xl": {
+        "$type": "dimension",
+        "$value": "1.5rem",
+        "$description": "24px - Heading 4"
+      },
+      "3xl": {
+        "$type": "dimension",
+        "$value": "1.875rem",
+        "$description": "30px - Heading 3"
+      },
+      "4xl": {
+        "$type": "dimension",
+        "$value": "2.25rem",
+        "$description": "36px - Heading 2"
+      },
+      "5xl": {
+        "$type": "dimension",
+        "$value": "3rem",
+        "$description": "48px - Heading 1"
+      }
+    },
+    "fontWeight": {
+      "normal": {
+        "$type": "fontWeight",
+        "$value": 400,
+        "$description": "Normal font weight"
+      },
+      "medium": {
+        "$type": "fontWeight",
+        "$value": 500,
+        "$description": "Medium font weight"
+      },
+      "semibold": {
+        "$type": "fontWeight",
+        "$value": 600,
+        "$description": "Semibold font weight"
+      },
+      "bold": {
+        "$type": "fontWeight",
+        "$value": 700,
+        "$description": "Bold font weight"
+      }
+    },
+    "lineHeight": {
+      "tight": {
+        "$type": "number",
+        "$value": 1.25,
+        "$description": "Tight line height for headings"
+      },
+      "normal": {
+        "$type": "number",
+        "$value": 1.5,
+        "$description": "Normal line height for body text"
+      },
+      "relaxed": {
+        "$type": "number",
+        "$value": 1.75,
+        "$description": "Relaxed line height for readable paragraphs"
+      },
+      "loose": {
+        "$type": "number",
+        "$value": 2,
+        "$description": "Loose line height for extra whitespace"
+      }
+    },
+    "letterSpacing": {
+      "tight": {
+        "$type": "dimension",
+        "$value": "-0.025em",
+        "$description": "Tight letter spacing for large headings"
+      },
+      "normal": {
+        "$type": "dimension",
+        "$value": "0",
+        "$description": "Normal letter spacing"
+      },
+      "wide": {
+        "$type": "dimension",
+        "$value": "0.025em",
+        "$description": "Wide letter spacing for uppercase text"
+      }
+    }
+  },
+  "spacing": {
+    "0": {
+      "$type": "dimension",
+      "$value": "0"
+    },
+    "1": {
+      "$type": "dimension",
+      "$value": "0.25rem",
+      "$description": "4px"
+    },
+    "2": {
+      "$type": "dimension",
+      "$value": "0.5rem",
+      "$description": "8px"
+    },
+    "3": {
+      "$type": "dimension",
+      "$value": "0.75rem",
+      "$description": "12px"
+    },
+    "4": {
+      "$type": "dimension",
+      "$value": "1rem",
+      "$description": "16px"
+    },
+    "5": {
+      "$type": "dimension",
+      "$value": "1.25rem",
+      "$description": "20px"
+    },
+    "6": {
+      "$type": "dimension",
+      "$value": "1.5rem",
+      "$description": "24px"
+    },
+    "8": {
+      "$type": "dimension",
+      "$value": "2rem",
+      "$description": "32px"
+    },
+    "10": {
+      "$type": "dimension",
+      "$value": "2.5rem",
+      "$description": "40px"
+    },
+    "12": {
+      "$type": "dimension",
+      "$value": "3rem",
+      "$description": "48px"
+    },
+    "16": {
+      "$type": "dimension",
+      "$value": "4rem",
+      "$description": "64px"
+    },
+    "20": {
+      "$type": "dimension",
+      "$value": "5rem",
+      "$description": "80px"
+    },
+    "24": {
+      "$type": "dimension",
+      "$value": "6rem",
+      "$description": "96px"
+    }
+  },
+  "borderRadius": {
+    "none": {
+      "$type": "dimension",
+      "$value": "0"
+    },
+    "sm": {
+      "$type": "dimension",
+      "$value": "0.125rem",
+      "$description": "2px"
+    },
+    "base": {
+      "$type": "dimension",
+      "$value": "0.25rem",
+      "$description": "4px"
+    },
+    "md": {
+      "$type": "dimension",
+      "$value": "0.375rem",
+      "$description": "6px"
+    },
+    "lg": {
+      "$type": "dimension",
+      "$value": "0.5rem",
+      "$description": "8px"
+    },
+    "xl": {
+      "$type": "dimension",
+      "$value": "0.75rem",
+      "$description": "12px"
+    },
+    "2xl": {
+      "$type": "dimension",
+      "$value": "1rem",
+      "$description": "16px"
+    },
+    "full": {
+      "$type": "dimension",
+      "$value": "9999px",
+      "$description": "Fully rounded (pill shape)"
+    }
+  },
+  "shadow": {
+    "xs": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "1px",
+        "blur": "2px",
+        "spread": "0",
+        "color": "rgba(0, 0, 0, 0.05)"
+      }
+    },
+    "sm": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "1px",
+        "blur": "3px",
+        "spread": "0",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "base": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "4px",
+        "blur": "6px",
+        "spread": "-1px",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "md": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "10px",
+        "blur": "15px",
+        "spread": "-3px",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "lg": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "20px",
+        "blur": "25px",
+        "spread": "-5px",
+        "color": "rgba(0, 0, 0, 0.1)"
+      }
+    },
+    "xl": {
+      "$type": "shadow",
+      "$value": {
+        "offsetX": "0",
+        "offsetY": "25px",
+        "blur": "50px",
+        "spread": "-12px",
+        "color": "rgba(0, 0, 0, 0.25)"
+      }
+    }
+  },
+  "component": {
+    "button": {
+      "padding": {
+        "sm": {
+          "x": {
+            "$type": "dimension",
+            "$value": "{spacing.3}"
+          },
+          "y": {
+            "$type": "dimension",
+            "$value": "{spacing.1}"
+          }
+        },
+        "md": {
+          "x": {
+            "$type": "dimension",
+            "$value": "{spacing.4}"
+          },
+          "y": {
+            "$type": "dimension",
+            "$value": "{spacing.2}"
+          }
+        },
+        "lg": {
+          "x": {
+            "$type": "dimension",
+            "$value": "{spacing.6}"
+          },
+          "y": {
+            "$type": "dimension",
+            "$value": "{spacing.3}"
+          }
+        }
+      },
+      "borderRadius": {
+        "$type": "dimension",
+        "$value": "{borderRadius.md}"
+      }
+    },
+    "card": {
+      "padding": {
+        "$type": "dimension",
+        "$value": "{spacing.6}"
+      },
+      "borderRadius": {
+        "$type": "dimension",
+        "$value": "{borderRadius.lg}"
+      },
+      "shadow": {
+        "$type": "shadow",
+        "$value": "{shadow.sm}"
+      }
+    },
+    "input": {
+      "padding": {
+        "x": {
+          "$type": "dimension",
+          "$value": "{spacing.3}"
+        },
+        "y": {
+          "$type": "dimension",
+          "$value": "{spacing.2}"
+        }
+      },
+      "borderRadius": {
+        "$type": "dimension",
+        "$value": "{borderRadius.md}"
+      },
+      "border": {
+        "default": {
+          "$type": "color",
+          "$value": "{color.semantic.border.default}"
+        },
+        "focus": {
+          "$type": "color",
+          "$value": "{color.semantic.brand.primary}"
+        },
+        "error": {
+          "$type": "color",
+          "$value": "{color.semantic.feedback.error}"
+        }
+      }
+    }
+  }
+}
diff --git a/.claude/skills/design-to-code/LICENSE.txt b/.claude/skills/design-to-code/LICENSE.txt
new file mode 100644
index 0000000..beef293
--- /dev/null
+++ b/.claude/skills/design-to-code/LICENSE.txt
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/.claude/skills/design-to-code/SKILL.md b/.claude/skills/design-to-code/SKILL.md
new file mode 100644
index 0000000..4ba99d5
--- /dev/null
+++ b/.claude/skills/design-to-code/SKILL.md
@@ -0,0 +1,158 @@
+---
+name: design-to-code
+description: Pixel-perfect Figma to React conversion using coderio. Generates production-ready code (TypeScript, Vite, TailwindCSS V4) with high visual fidelity. Features robust error handling, checkpoint recovery, and streamlined execution via helper script.
+---
+
+# Design to Code
+
+High-fidelity UI restoration from Figma designs to production-ready React + TypeScript components.
+This SKILL uses a **robust helper script** to minimize manual errors and ensure pixel-perfect results.
+
+## Prerequisites
+
+1.  **Figma API Token**: Get from Figma → Settings → Personal Access Tokens
+2.  **Node.js**: Version 18+
+3.  **coderio**: Installed in `scripts/` folder (handled by Setup phase)
+
+## Workflow Overview
+
+```
+Phase 0: SETUP    → Create helper script and script environment
+Phase 1: PROTOCOL → Generate design protocol (Structure & Props)
+Phase 2: CODE     → Generate components and assets
+```
+
+---
+
+# Phase 0: Setup
+
+## Step 0.1: Initialize Helper Script
+
+**User Action**: Run these commands to create the execution helper and isolate its dependencies.
+
+```bash
+mkdir -p scripts
+
+# 1. Copy script files
+# Note: Ensure you have the 'skills/design-to-code/scripts' directory available
+cp skills/design-to-code/scripts/package.json scripts/package.json
+cp skills/design-to-code/scripts/coderio-skill.mjs scripts/coderio-skill.mjs
+
+# 2. Install coderio in scripts directory (adjust version if needed)
+cd scripts && pnpm install && cd ..
+```
+
+## Step 0.2: Scaffold Project (Optional)
+
+If starting a new project:
+
+1.  Run: `node scripts/coderio-skill.mjs scaffold-prompt "MyApp"`
+2.  **AI Task**: Follow the instructions output by the command to create files.
+
+---
+
+# Phase 1: Protocol Generation
+
+## Step 1.1: Fetch Data
+
+```bash
+# Replace with your URL and Token
+node scripts/coderio-skill.mjs fetch-figma "https://figma.com/file/..." "figd_..."
+```
+
+**Verify**: `process/thumbnail.png` should exist.
+
+## Step 1.2: Generate Structure
+
+1.  **Generate Prompt**:
+
+    ```bash
+    node scripts/coderio-skill.mjs structure-prompt > scripts/structure-prompt.md
+    ```
+
+2.  **AI Task (Structure)**:
+    - **ATTACH**: `process/thumbnail.png` (MANDATORY)
+    - **READ**: `scripts/structure-prompt.md`
+    - **INSTRUCTION**: "Generate the component structure JSON based on the prompt and the attached thumbnail. Focus on visual grouping. **Use text content to name components accurately (e.g. 'SafeProducts', not 'FAQ').**"
+    - **SAVE**: Paste the JSON result into `scripts/structure-output.json`.
+
+3.  **Process Result**:
+    ```bash
+    node scripts/coderio-skill.mjs save-structure
+    ```
+
+## Step 1.3: Extract Props (Iterative)
+
+1.  **List Components**:
+
+    ```bash
+    node scripts/coderio-skill.mjs list-components
+    ```
+
+2.  **For EACH component in the list**:
+
+    a. **Generate Prompt**:
+
+    ```bash
+    node scripts/coderio-skill.mjs props-prompt "ComponentName" > scripts/current-props-prompt.md
+    ```
+
+    b. **AI Task (Props)**:
+    - **ATTACH**: `process/thumbnail.png` (MANDATORY)
+    - **READ**: `scripts/current-props-prompt.md`
+    - **INSTRUCTION**: "Extract props and state data. Be pixel-perfect with text and image paths."
+    - **SAVE**: Paste the JSON result into `scripts/ComponentName-props.json`.
+
+    c. **Save & Validate**:
+
+    ```bash
+    node scripts/coderio-skill.mjs save-props "ComponentName"
+    # If this fails, re-do step 'b' with better attention to the thumbnail
+    ```
+
+---
+
+# Phase 2: Code Generation
+
+## Step 2.1: Plan Tasks
+
+```bash
+node scripts/coderio-skill.mjs list-gen-tasks
+```
+
+This outputs a list of tasks with indices (0, 1, 2...).
+
+## Step 2.2: Generate Components (Iterative)
+
+**For EACH task index (starting from 0)**:
+
+1.  **Generate Prompt**:
+
+    ```bash
+    node scripts/coderio-skill.mjs code-prompt 0 > scripts/code-prompt.md
+    # Replace '0' with current task index
+    ```
+
+2.  **AI Task (Code)**:
+    - **ATTACH**: `process/thumbnail.png` (MANDATORY)
+    - **READ**: `scripts/code-prompt.md`
+    - **INSTRUCTION**: "Generate the React component code. Match the thumbnail EXACTLY. **Use STRICT text content from input data, do not hallucinate.**"
+    - **SAVE**: Paste the code block into `scripts/code-output.txt`.
+
+3.  **Save Code**:
+    ```bash
+    node scripts/coderio-skill.mjs save-code 0
+    # Replace '0' with current task index
+    ```
+
+## Step 2.3: Final Integration
+
+Inject the root component into `App.tsx`. Use the path found in the last task of Phase 2.1.
+
+---
+
+# Troubleshooting
+
+- **"Props validation failed"**: The AI generated empty props. Check if `process/thumbnail.png` was attached and visible to the AI. Retry the props generation step.
+- **"Module not found"**: Ensure `node scripts/coderio-skill.mjs save-code` was run for the child component before the parent component. Phase 2 must be done in order (0, 1, 2...).
+- **"Visuals don't match"**: Did you attach the thumbnail? The AI relies on it for spacing and layout nuances not present in the raw data.
diff --git a/.claude/skills/design-to-code/scripts/coderio-skill.mjs b/.claude/skills/design-to-code/scripts/coderio-skill.mjs
new file mode 100644
index 0000000..d46e568
--- /dev/null
+++ b/.claude/skills/design-to-code/scripts/coderio-skill.mjs
@@ -0,0 +1,300 @@
+import fs from 'fs';
+import path from 'path';
+import {
+    parseFigmaUrl, executeFigmaAndImagesActions, figmaTool, downloadImage,
+    extractNodePositionsHierarchical, generateStructurePrompt, extractJSON,
+    postProcessStructure, extractComponentGroups, simplifyFigmaNodeForContent,
+    extractDataListPrompt,
+    flattenPostOrder, detectRenderingModes, generateFramePrompt, generateComponentPrompt,
+    DEFAULT_STYLING, saveGeneratedCode, workspaceManager,
+    toKebabCase, toPascalCase, INITIAL_AGENT_SYSTEM_PROMPT, initialAgentInstruction
+} from 'coderio';
+
+const [,, command, ...args] = process.argv;
+const appPath = process.cwd();
+const processDir = path.join(appPath, 'process');
+const scriptsDir = path.join(appPath, 'scripts');
+const assetsDir = path.join(appPath, 'src/assets');
+
+// Ensure directories exist
+[processDir, scriptsDir, assetsDir].forEach(d => {
+    if (!fs.existsSync(d)) fs.mkdirSync(d, { recursive: true });
+});
+
+function extractAllComponentGroups(node) {
+    const groups = new Map();
+    function traverse(currentNode) {
+        const localGroups = extractComponentGroups(currentNode);
+        for (const [name, list] of localGroups) {
+            if (!groups.has(name)) groups.set(name, []);
+            groups.get(name).push(...list);
+        }
+        if (currentNode.children) {
+            currentNode.children.forEach(traverse);
+        }
+    }
+    traverse(node);
+    return groups;
+}
+
+function findParentOfGroup(root, componentName) {
+    let result = null;
+    function traverse(node) {
+        if (result) return;
+        if (node.children && node.children.some(c => c.data.componentName === componentName)) {
+            result = node;
+            return;
+        }
+        if (node.children) node.children.forEach(traverse);
+    }
+    traverse(root);
+    return result;
+}
+
+function applyPropsAndStateToProtocol(parsed, node, compName, group, isList) {
+    if (parsed && parsed.state && Array.isArray(parsed.state)) {
+        if (isList) {
+            if (!node.data.states) {
+                node.data.states = [];
+            }
+
+            node.data.states = node.data.states.filter(s => s.componentName !== compName);
+
+            node.data.states.push({
+                state: parsed.state,
+                componentName: compName,
+                componentPath: group[0]?.data.componentPath || '',
+            });
+
+            const originalChildren = node.children || [];
+            const newChildren = [];
+            const processedComponentNames = new Set();
+
+            for (const child of originalChildren) {
+                const childName = child.data.componentName;
+                if (childName === compName) {
+                    if (!processedComponentNames.has(childName)) {
+                        child.data.name = childName;
+                        child.id = childName;
+                        const cleanKebabName = toKebabCase(childName);
+                        child.data.kebabName = cleanKebabName;
+                        delete child.data.path;
+
+                        if (parsed.props && Array.isArray(parsed.props)) {
+                            child.data.props = parsed.props;
+                        }
+
+                        newChildren.push(child);
+                        processedComponentNames.add(childName);
+                    }
+                } else {
+                    newChildren.push(child);
+                }
+            }
+
+            node.children = newChildren;
+        }
+    }
+}
+
+async function main() {
+    try {
+        switch (command) {
+            case 'scaffold-prompt': {
+                console.log(INITIAL_AGENT_SYSTEM_PROMPT);
+                console.log('\n--- INSTRUCTION ---\n');
+                console.log(initialAgentInstruction({ appPath, appName: args[0] || 'MyApp' }));
+                break;
+            }
+
+            case 'fetch-figma': {
+                const [figmaUrl, figmaToken] = args;
+                if (!figmaUrl || !figmaToken) throw new Error('Usage: fetch-figma <url> <token>');
+
+                const urlInfo = parseFigmaUrl(figmaUrl);
+                console.log('Fetching Figma document...');
+                const { document, imageNodesMap } = await executeFigmaAndImagesActions(urlInfo, assetsDir, processDir, figmaToken);
+
+                const simplified = figmaTool.simplifyImageNodes(document, imageNodesMap);
+                const processed = figmaTool.processedStyle(simplified);
+                fs.writeFileSync(path.join(processDir, 'processed.json'), JSON.stringify(processed, null, 2));
+
+                if (processed.thumbnailUrl) {
+                    console.log('Downloading thumbnail...');
+                    const base64 = await downloadImage(processed.thumbnailUrl, undefined, undefined, true);
+                    fs.writeFileSync(path.join(processDir, 'thumbnail.png'), Buffer.from(base64, 'base64'));
+                    console.log('Thumbnail saved to process/thumbnail.png');
+                }
+                console.log('Figma data processed.');
+                break;
+            }
+
+            case 'structure-prompt': {
+                const procDoc = JSON.parse(fs.readFileSync(path.join(processDir, 'processed.json'), 'utf-8'));
+                const frames = procDoc.frames || procDoc.children;
+                const positions = extractNodePositionsHierarchical(frames);
+                const prompt = generateStructurePrompt({
+                    positions: JSON.stringify(positions, null, 2),
+                    width: String(procDoc.absoluteBoundingBox?.width || 1440)
+                });
+                console.log(prompt);
+                break;
+            }
+
+            case 'save-structure': {
+                const structureJson = fs.readFileSync(path.join(scriptsDir, 'structure-output.json'), 'utf-8');
+                const pDoc = JSON.parse(fs.readFileSync(path.join(processDir, 'processed.json'), 'utf-8'));
+
+                const parsed = JSON.parse(extractJSON(structureJson));
+                const structFrames = pDoc.frames || pDoc.children;
+                postProcessStructure(parsed, structFrames);
+
+                const protocol = Array.isArray(parsed) ? parsed[0] : parsed;
+                fs.writeFileSync(path.join(processDir, 'protocol.json'), JSON.stringify(protocol, null, 2));
+                console.log('Structure saved to process/protocol.json');
+                break;
+            }
+
+            case 'list-components': {
+                const prot = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const groups = extractAllComponentGroups(prot);
+                const list = Array.from(groups.keys()).map(name => {
+                    return { name, count: groups.get(name).length };
+                });
+                fs.writeFileSync(path.join(scriptsDir, 'component-list.json'), JSON.stringify(list, null, 2));
+                console.log(JSON.stringify(list, null, 2));
+                break;
+            }
+
+            case 'props-prompt': {
+                const compName = args[0];
+                const prot2 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const groups2 = extractAllComponentGroups(prot2);
+                const group = groups2.get(compName);
+                if (!group) throw new Error(`Component ${compName} not found`);
+
+                const instances = group.flatMap(g => g.data.elements || []);
+                const simpleNodes = instances
+                    .filter(n => typeof n === 'object' && n !== null)
+                    .map(n => simplifyFigmaNodeForContent(n));
+
+                console.log(extractDataListPrompt({
+                    containerName: prot2.data.name || 'Container',
+                    childComponentName: compName,
+                    figmaData: JSON.stringify(simpleNodes, null, 2)
+                }));
+                break;
+            }
+
+            case 'save-props': {
+                const cName = args[0];
+                const propsJsonPath = path.join(scriptsDir, `${cName}-props.json`);
+                const propsJson = fs.readFileSync(propsJsonPath, 'utf-8');
+                const parsedProps = JSON.parse(extractJSON(propsJson));
+
+                if (!parsedProps.props || parsedProps.props.length === 0) {
+                    throw new Error('Validation Failed: Props array is empty.');
+                }
+
+                const prot3 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const groups3 = extractAllComponentGroups(prot3);
+                const group3 = groups3.get(cName);
+
+                const parentNode = findParentOfGroup(prot3, cName);
+                if (parentNode) {
+                    applyPropsAndStateToProtocol(parsedProps, parentNode, cName, group3, true);
+                    fs.writeFileSync(path.join(processDir, 'protocol.json'), JSON.stringify(prot3, null, 2));
+                    console.log(`Props applied to ${cName} (Parent: ${parentNode.data.name || parentNode.id})`);
+                } else {
+                    console.error(`Parent not found for ${cName}`);
+                }
+                break;
+            }
+
+            case 'list-gen-tasks': {
+                const prot4 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const flat = flattenPostOrder(prot4);
+                const tasks = flat.map((node, i) => ({
+                    index: i,
+                    name: node.data.name || node.data.componentName,
+                    path: node.data.path || node.data.componentPath,
+                    isLeaf: !node.children?.length
+                }));
+                fs.writeFileSync(path.join(scriptsDir, 'gen-tasks.json'), JSON.stringify(tasks, null, 2));
+                console.log(JSON.stringify(tasks, null, 2));
+                break;
+            }
+
+            case 'code-prompt': {
+                const idx = parseInt(args[0]);
+                const prot5 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const flat2 = flattenPostOrder(prot5);
+                const node = flat2[idx];
+                const assets = fs.readdirSync(assetsDir).join(', ');
+
+                let prompt = '';
+                if (!node.children?.length) {
+                    prompt = generateComponentPrompt({
+                        componentName: node.data.name || node.data.componentName,
+                        componentDetails: JSON.stringify(node.data, null, 2),
+                        styling: JSON.stringify(DEFAULT_STYLING),
+                        assetFiles: assets
+                    });
+                } else {
+                    const imports = node.children.map(c => ({
+                        name: c.data.name,
+                        path: c.data.path || c.data.componentPath
+                    }));
+                    const modes = detectRenderingModes(node);
+                    prompt = generateFramePrompt({
+                        frameDetails: JSON.stringify(node.data, null, 2),
+                        childrenImports: JSON.stringify(imports, null, 2),
+                        styling: JSON.stringify(DEFAULT_STYLING),
+                        assetFiles: assets,
+                        renderingModes: modes
+                    });
+                }
+
+                // Add instruction for Asset Imports in State
+                if (node.data.states && node.data.states.length > 0) {
+                    prompt += `\n\n<asset_imports_instruction>
+The 'states' data contains references to assets (e.g. "@/assets/foo.png").
+You MUST:
+1. Import these assets at the top of the file: \`import image_foo from '@/assets/foo.png';\`
+2. In the \`states\` array in your code, use the variable \`image_foo\` instead of the string.
+   Example: \`imageSrc: image_foo\` (NOT \`imageSrc: "@/assets/foo.png"\`)
+</asset_imports_instruction>`;
+                }
+
+                console.log(prompt);
+                break;
+            }
+
+            case 'save-code': {
+                const idx2 = parseInt(args[0]);
+                const codePath = path.join(scriptsDir, 'code-output.txt');
+                const code = fs.readFileSync(codePath, 'utf-8');
+
+                const prot6 = JSON.parse(fs.readFileSync(path.join(processDir, 'protocol.json'), 'utf-8'));
+                const flat3 = flattenPostOrder(prot6);
+                const node2 = flat3[idx2];
+
+                const componentPath = node2.data.path || node2.data.componentPath;
+                if (!componentPath) throw new Error(`Node ${node2.data.name} has no path`);
+
+                const compDir = path.join(appPath, 'src', workspaceManager.resolveComponentPath(componentPath));
+                saveGeneratedCode(code, compDir);
+                console.log(`Code saved to ${compDir}`);
+                break;
+            }
+
+            default:
+                console.log('Unknown command');
+        }
+    } catch (e) {
+        console.error('Error:', e.message);
+        process.exit(1);
+    }
+}
+
+main();
diff --git a/.claude/skills/design-to-code/scripts/package.json b/.claude/skills/design-to-code/scripts/package.json
new file mode 100644
index 0000000..2cde861
--- /dev/null
+++ b/.claude/skills/design-to-code/scripts/package.json
@@ -0,0 +1,8 @@
+{
+  "name": "coderio-scripts",
+  "version": "1.0.0",
+  "private": true,
+  "dependencies": {
+    "coderio": "latest"
+  }
+}
diff --git a/.claude/skills/diagnose/SKILL.md b/.claude/skills/diagnose/SKILL.md
new file mode 100644
index 0000000..ed55bda
--- /dev/null
+++ b/.claude/skills/diagnose/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: diagnose
+description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
+---
+
+# Diagnose
+
+A discipline for hard bugs. Skip phases only when explicitly justified.
+
+When exploring the codebase, use the project's domain glossary to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.
+
+## Phase 1 — Build a feedback loop
+
+**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you.
+
+Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.**
+
+### Ways to construct one — try them in roughly this order
+
+1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.
+2. **Curl / HTTP script** against a running dev server.
+3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.
+4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network.
+5. **Replay a captured trace.** Save a real network request / payload / event log to disk; replay it through the code path in isolation.
+6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that exercises the bug code path with a single function call.
+7. **Property / fuzz loop.** If the bug is "sometimes wrong output", run 1000 random inputs and look for the failure mode.
+8. **Bisection harness.** If the bug appeared between two known states (commit, dataset, version), automate "boot at state X, check, repeat" so you can `git bisect run` it.
+9. **Differential loop.** Run the same input through old-version vs new-version (or two configs) and diff outputs.
+10. **HITL bash script.** Last resort. If a human must click, drive _them_ with `scripts/hitl-loop.template.sh` so the loop is still structured. Captured output feeds back to you.
+
+Build the right feedback loop, and the bug is 90% fixed.
+
+### Iterate on the loop itself
+
+Treat the loop as a product. Once you have _a_ loop, ask:
+
+- Can I make it faster? (Cache setup, skip unrelated init, narrow the test scope.)
+- Can I make the signal sharper? (Assert on the specific symptom, not "didn't crash".)
+- Can I make it more deterministic? (Pin time, seed RNG, isolate filesystem, freeze network.)
+
+A 30-second flaky loop is barely better than no loop. A 2-second deterministic loop is a debugging superpower.
+
+### Non-deterministic bugs
+
+The goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×, parallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake bug is debuggable; 1% is not — keep raising the rate until it's debuggable.
+
+### When you genuinely cannot build a loop
+
+Stop and say so explicitly. List what you tried. Ask the user for: (a) access to whatever environment reproduces it, (b) a captured artifact (HAR file, log dump, core dump, screen recording with timestamps), or (c) permission to add temporary production instrumentation. Do **not** proceed to hypothesise without a loop.
+
+Do not proceed to Phase 2 until you have a loop you believe in.
+
+## Phase 2 — Reproduce
+
+Run the loop. Watch the bug appear.
+
+Confirm:
+
+- [ ] The loop produces the failure mode the **user** described — not a different failure that happens to be nearby. Wrong bug = wrong fix.
+- [ ] The failure is reproducible across multiple runs (or, for non-deterministic bugs, reproducible at a high enough rate to debug against).
+- [ ] You have captured the exact symptom (error message, wrong output, slow timing) so later phases can verify the fix actually addresses it.
+
+Do not proceed until you reproduce the bug.
+
+## Phase 3 — Hypothesise
+
+Generate **3–5 ranked hypotheses** before testing any of them. Single-hypothesis generation anchors on the first plausible idea.
+
+Each hypothesis must be **falsifiable**: state the prediction it makes.
+
+> Format: "If <X> is the cause, then <changing Y> will make the bug disappear / <changing Z> will make it worse."
+
+If you cannot state the prediction, the hypothesis is a vibe — discard or sharpen it.
+
+**Show the ranked list to the user before testing.** They often have domain knowledge that re-ranks instantly ("we just deployed a change to #3"), or know hypotheses they've already ruled out. Cheap checkpoint, big time saver. Don't block on it — proceed with your ranking if the user is AFK.
+
+## Phase 4 — Instrument
+
+Each probe must map to a specific prediction from Phase 3. **Change one variable at a time.**
+
+Tool preference:
+
+1. **Debugger / REPL inspection** if the env supports it. One breakpoint beats ten logs.
+2. **Targeted logs** at the boundaries that distinguish hypotheses.
+3. Never "log everything and grep".
+
+**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep. Untagged logs survive; tagged logs die.
+
+**Perf branch.** For performance regressions, logs are usually wrong. Instead: establish a baseline measurement (timing harness, `performance.now()`, profiler, query plan), then bisect. Measure first, fix second.
+
+## Phase 5 — Fix + regression test
+
+Write the regression test **before the fix** — but only if there is a **correct seam** for it.
+
+A correct seam is one where the test exercises the **real bug pattern** as it occurs at the call site. If the only available seam is too shallow (single-caller test when the bug needs multiple callers, unit test that can't replicate the chain that triggered the bug), a regression test there gives false confidence.
+
+**If no correct seam exists, that itself is the finding.** Note it. The codebase architecture is preventing the bug from being locked down. Flag this for the next phase.
+
+If a correct seam exists:
+
+1. Turn the minimised repro into a failing test at that seam.
+2. Watch it fail.
+3. Apply the fix.
+4. Watch it pass.
+5. Re-run the Phase 1 feedback loop against the original (un-minimised) scenario.
+
+## Phase 6 — Cleanup + post-mortem
+
+Required before declaring done:
+
+- [ ] Original repro no longer reproduces (re-run the Phase 1 loop)
+- [ ] Regression test passes (or absence of seam is documented)
+- [ ] All `[DEBUG-...]` instrumentation removed (`grep` the prefix)
+- [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location)
+- [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns
+
+**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started.
diff --git a/.claude/skills/diagnose/scripts/hitl-loop.template.sh b/.claude/skills/diagnose/scripts/hitl-loop.template.sh
new file mode 100644
index 0000000..40afc46
--- /dev/null
+++ b/.claude/skills/diagnose/scripts/hitl-loop.template.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Human-in-the-loop reproduction loop.
+# Copy this file, edit the steps below, and run it.
+# The agent runs the script; the user follows prompts in their terminal.
+#
+# Usage:
+#   bash hitl-loop.template.sh
+#
+# Two helpers:
+#   step "<instruction>"          → show instruction, wait for Enter
+#   capture VAR "<question>"      → show question, read response into VAR
+#
+# At the end, captured values are printed as KEY=VALUE for the agent to parse.
+
+set -euo pipefail
+
+step() {
+  printf '\n>>> %s\n' "$1"
+  read -r -p "    [Enter when done] " _
+}
+
+capture() {
+  local var="$1" question="$2" answer
+  printf '\n>>> %s\n' "$question"
+  read -r -p "    > " answer
+  printf -v "$var" '%s' "$answer"
+}
+
+# --- edit below ---------------------------------------------------------
+
+step "Open the app at http://localhost:3000 and sign in."
+
+capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)"
+
+capture ERROR_MSG "Paste the error message (or 'none'):"
+
+# --- edit above ---------------------------------------------------------
+
+printf '\n--- Captured ---\n'
+printf 'ERRORED=%s\n' "$ERRORED"
+printf 'ERROR_MSG=%s\n' "$ERROR_MSG"
diff --git a/.claude/skills/excel-analysis/SKILL.md b/.claude/skills/excel-analysis/SKILL.md
new file mode 100644
index 0000000..57ad5ec
--- /dev/null
+++ b/.claude/skills/excel-analysis/SKILL.md
@@ -0,0 +1,247 @@
+---
+name: Excel Analysis
+description: Analyze Excel spreadsheets, create pivot tables, generate charts, and perform data analysis. Use when analyzing Excel files, spreadsheets, tabular data, or .xlsx files.
+---
+
+# Excel Analysis
+
+## Quick start
+
+Read Excel files with pandas:
+
+```python
+import pandas as pd
+
+# Read Excel file
+df = pd.read_excel("data.xlsx", sheet_name="Sheet1")
+
+# Display first few rows
+print(df.head())
+
+# Basic statistics
+print(df.describe())
+```
+
+## Reading multiple sheets
+
+Process all sheets in a workbook:
+
+```python
+import pandas as pd
+
+# Read all sheets
+excel_file = pd.ExcelFile("workbook.xlsx")
+
+for sheet_name in excel_file.sheet_names:
+    df = pd.read_excel(excel_file, sheet_name=sheet_name)
+    print(f"\n{sheet_name}:")
+    print(df.head())
+```
+
+## Data analysis
+
+Perform common analysis tasks:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("sales.xlsx")
+
+# Group by and aggregate
+sales_by_region = df.groupby("region")["sales"].sum()
+print(sales_by_region)
+
+# Filter data
+high_sales = df[df["sales"] > 10000]
+
+# Calculate metrics
+df["profit_margin"] = (df["revenue"] - df["cost"]) / df["revenue"]
+
+# Sort by column
+df_sorted = df.sort_values("sales", ascending=False)
+```
+
+## Creating Excel files
+
+Write data to Excel with formatting:
+
+```python
+import pandas as pd
+
+df = pd.DataFrame({
+    "Product": ["A", "B", "C"],
+    "Sales": [100, 200, 150],
+    "Profit": [20, 40, 30]
+})
+
+# Write to Excel
+writer = pd.ExcelWriter("output.xlsx", engine="openpyxl")
+df.to_excel(writer, sheet_name="Sales", index=False)
+
+# Get worksheet for formatting
+worksheet = writer.sheets["Sales"]
+
+# Auto-adjust column widths
+for column in worksheet.columns:
+    max_length = 0
+    column_letter = column[0].column_letter
+    for cell in column:
+        if len(str(cell.value)) > max_length:
+            max_length = len(str(cell.value))
+    worksheet.column_dimensions[column_letter].width = max_length + 2
+
+writer.close()
+```
+
+## Pivot tables
+
+Create pivot tables programmatically:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("sales_data.xlsx")
+
+# Create pivot table
+pivot = pd.pivot_table(
+    df,
+    values="sales",
+    index="region",
+    columns="product",
+    aggfunc="sum",
+    fill_value=0
+)
+
+print(pivot)
+
+# Save pivot table
+pivot.to_excel("pivot_report.xlsx")
+```
+
+## Charts and visualization
+
+Generate charts from Excel data:
+
+```python
+import pandas as pd
+import matplotlib.pyplot as plt
+
+df = pd.read_excel("data.xlsx")
+
+# Create bar chart
+df.plot(x="category", y="value", kind="bar")
+plt.title("Sales by Category")
+plt.xlabel("Category")
+plt.ylabel("Sales")
+plt.tight_layout()
+plt.savefig("chart.png")
+
+# Create pie chart
+df.set_index("category")["value"].plot(kind="pie", autopct="%1.1f%%")
+plt.title("Market Share")
+plt.ylabel("")
+plt.savefig("pie_chart.png")
+```
+
+## Data cleaning
+
+Clean and prepare Excel data:
+
+```python
+import pandas as pd
+
+df = pd.read_excel("messy_data.xlsx")
+
+# Remove duplicates
+df = df.drop_duplicates()
+
+# Handle missing values
+df = df.fillna(0)  # or df.dropna()
+
+# Remove whitespace
+df["name"] = df["name"].str.strip()
+
+# Convert data types
+df["date"] = pd.to_datetime(df["date"])
+df["amount"] = pd.to_numeric(df["amount"], errors="coerce")
+
+# Save cleaned data
+df.to_excel("cleaned_data.xlsx", index=False)
+```
+
+## Merging and joining
+
+Combine multiple Excel files:
+
+```python
+import pandas as pd
+
+# Read multiple files
+df1 = pd.read_excel("sales_q1.xlsx")
+df2 = pd.read_excel("sales_q2.xlsx")
+
+# Concatenate vertically
+combined = pd.concat([df1, df2], ignore_index=True)
+
+# Merge on common column
+customers = pd.read_excel("customers.xlsx")
+sales = pd.read_excel("sales.xlsx")
+
+merged = pd.merge(sales, customers, on="customer_id", how="left")
+
+merged.to_excel("merged_data.xlsx", index=False)
+```
+
+## Advanced formatting
+
+Apply conditional formatting and styles:
+
+```python
+import pandas as pd
+from openpyxl import load_workbook
+from openpyxl.styles import PatternFill, Font
+
+# Create Excel file
+df = pd.DataFrame({
+    "Product": ["A", "B", "C"],
+    "Sales": [100, 200, 150]
+})
+
+df.to_excel("formatted.xlsx", index=False)
+
+# Load workbook for formatting
+wb = load_workbook("formatted.xlsx")
+ws = wb.active
+
+# Apply conditional formatting
+red_fill = PatternFill(start_color="FF0000", end_color="FF0000", fill_type="solid")
+green_fill = PatternFill(start_color="00FF00", end_color="00FF00", fill_type="solid")
+
+for row in range(2, len(df) + 2):
+    cell = ws[f"B{row}"]
+    if cell.value < 150:
+        cell.fill = red_fill
+    else:
+        cell.fill = green_fill
+
+# Bold headers
+for cell in ws[1]:
+    cell.font = Font(bold=True)
+
+wb.save("formatted.xlsx")
+```
+
+## Performance tips
+
+- Use `read_excel` with `usecols` to read specific columns only
+- Use `chunksize` for very large files
+- Consider using `engine='openpyxl'` or `engine='xlrd'` based on file type
+- Use `dtype` parameter to specify column types for faster reading
+
+## Available packages
+
+- **pandas** - Data analysis and manipulation (primary)
+- **openpyxl** - Excel file creation and formatting
+- **xlrd** - Reading older .xls files
+- **xlsxwriter** - Advanced Excel writing capabilities
+- **matplotlib** - Chart generation
diff --git a/.claude/skills/flutter-dart-code-review/SKILL.md b/.claude/skills/flutter-dart-code-review/SKILL.md
new file mode 100644
index 0000000..2f9529d
--- /dev/null
+++ b/.claude/skills/flutter-dart-code-review/SKILL.md
@@ -0,0 +1,435 @@
+---
+name: flutter-dart-code-review
+description: Library-agnostic Flutter/Dart code review checklist covering widget best practices, state management patterns (BLoC, Riverpod, Provider, GetX, MobX, Signals), Dart idioms, performance, accessibility, security, and clean architecture.
+origin: ECC
+---
+
+# Flutter/Dart Code Review Best Practices
+
+Comprehensive, library-agnostic checklist for reviewing Flutter/Dart applications. These principles apply regardless of which state management solution, routing library, or DI framework is used.
+
+---
+
+## 1. General Project Health
+
+- [ ] Project follows consistent folder structure (feature-first or layer-first)
+- [ ] Proper separation of concerns: UI, business logic, data layers
+- [ ] No business logic in widgets; widgets are purely presentational
+- [ ] `pubspec.yaml` is clean — no unused dependencies, versions pinned appropriately
+- [ ] `analysis_options.yaml` includes a strict lint set with strict analyzer settings enabled
+- [ ] No `print()` statements in production code — use `dart:developer` `log()` or a logging package
+- [ ] Generated files (`.g.dart`, `.freezed.dart`, `.gr.dart`) are up-to-date or in `.gitignore`
+- [ ] Platform-specific code isolated behind abstractions
+
+---
+
+## 2. Dart Language Pitfalls
+
+- [ ] **Implicit dynamic**: Missing type annotations leading to `dynamic` — enable `strict-casts`, `strict-inference`, `strict-raw-types`
+- [ ] **Null safety misuse**: Excessive `!` (bang operator) instead of proper null checks or Dart 3 pattern matching (`if (value case var v?)`)
+- [ ] **Type promotion failures**: Using `this.field` where local variable promotion would work
+- [ ] **Catching too broadly**: `catch (e)` without `on` clause; always specify exception types
+- [ ] **Catching `Error`**: `Error` subtypes indicate bugs and should not be caught
+- [ ] **Unused `async`**: Functions marked `async` that never `await` — unnecessary overhead
+- [ ] **`late` overuse**: `late` used where nullable or constructor initialization would be safer; defers errors to runtime
+- [ ] **String concatenation in loops**: Use `StringBuffer` instead of `+` for iterative string building
+- [ ] **Mutable state in `const` contexts**: Fields in `const` constructor classes should not be mutable
+- [ ] **Ignoring `Future` return values**: Use `await` or explicitly call `unawaited()` to signal intent
+- [ ] **`var` where `final` works**: Prefer `final` for locals and `const` for compile-time constants
+- [ ] **Relative imports**: Use `package:` imports for consistency
+- [ ] **Mutable collections exposed**: Public APIs should return unmodifiable views, not raw `List`/`Map`
+- [ ] **Missing Dart 3 pattern matching**: Prefer switch expressions and `if-case` over verbose `is` checks and manual casting
+- [ ] **Throwaway classes for multiple returns**: Use Dart 3 records `(String, int)` instead of single-use DTOs
+- [ ] **`print()` in production code**: Use `dart:developer` `log()` or the project's logging package; `print()` has no log levels and cannot be filtered
+
+---
+
+## 3. Widget Best Practices
+
+### Widget decomposition:
+- [ ] No single widget with a `build()` method exceeding ~80-100 lines
+- [ ] Widgets split by encapsulation AND by how they change (rebuild boundaries)
+- [ ] Private `_build*()` helper methods that return widgets are extracted to separate widget classes (enables element reuse, const propagation, and framework optimizations)
+- [ ] Stateless widgets preferred over Stateful where no mutable local state is needed
+- [ ] Extracted widgets are in separate files when reusable
+
+### Const usage:
+- [ ] `const` constructors used wherever possible — prevents unnecessary rebuilds
+- [ ] `const` literals for collections that don't change (`const []`, `const {}`)
+- [ ] Constructor is declared `const` when all fields are final
+
+### Key usage:
+- [ ] `ValueKey` used in lists/grids to preserve state across reorders
+- [ ] `GlobalKey` used sparingly — only when accessing state across the tree is truly needed
+- [ ] `UniqueKey` avoided in `build()` — it forces rebuild every frame
+- [ ] `ObjectKey` used when identity is based on a data object rather than a single value
+
+### Theming & design system:
+- [ ] Colors come from `Theme.of(context).colorScheme` — no hardcoded `Colors.red` or hex values
+- [ ] Text styles come from `Theme.of(context).textTheme` — no inline `TextStyle` with raw font sizes
+- [ ] Dark mode compatibility verified — no assumptions about light background
+- [ ] Spacing and sizing use consistent design tokens or constants, not magic numbers
+
+### Build method complexity:
+- [ ] No network calls, file I/O, or heavy computation in `build()`
+- [ ] No `Future.then()` or `async` work in `build()`
+- [ ] No subscription creation (`.listen()`) in `build()`
+- [ ] `setState()` localized to smallest possible subtree
+
+---
+
+## 4. State Management (Library-Agnostic)
+
+These principles apply to all Flutter state management solutions (BLoC, Riverpod, Provider, GetX, MobX, Signals, ValueNotifier, etc.).
+
+### Architecture:
+- [ ] Business logic lives outside the widget layer — in a state management component (BLoC, Notifier, Controller, Store, ViewModel, etc.)
+- [ ] State managers receive dependencies via injection, not by constructing them internally
+- [ ] A service or repository layer abstracts data sources — widgets and state managers should not call APIs or databases directly
+- [ ] State managers have a single responsibility — no "god" managers handling unrelated concerns
+- [ ] Cross-component dependencies follow the solution's conventions:
+  - In **Riverpod**: providers depending on providers via `ref.watch` is expected — flag only circular or overly tangled chains
+  - In **BLoC**: blocs should not directly depend on other blocs — prefer shared repositories or presentation-layer coordination
+  - In other solutions: follow the documented conventions for inter-component communication
+
+### Immutability & value equality (for immutable-state solutions: BLoC, Riverpod, Redux):
+- [ ] State objects are immutable — new instances created via `copyWith()` or constructors, never mutated in-place
+- [ ] State classes implement `==` and `hashCode` properly (all fields included in comparison)
+- [ ] Mechanism is consistent across the project — manual override, `Equatable`, `freezed`, Dart records, or other
+- [ ] Collections inside state objects are not exposed as raw mutable `List`/`Map`
+
+### Reactivity discipline (for reactive-mutation solutions: MobX, GetX, Signals):
+- [ ] State is only mutated through the solution's reactive API (`@action` in MobX, `.value` on signals, `.obs` in GetX) — direct field mutation bypasses change tracking
+- [ ] Derived values use the solution's computed mechanism rather than being stored redundantly
+- [ ] Reactions and disposers are properly cleaned up (`ReactionDisposer` in MobX, effect cleanup in Signals)
+
+### State shape design:
+- [ ] Mutually exclusive states use sealed types, union variants, or the solution's built-in async state type (e.g. Riverpod's `AsyncValue`) — not boolean flags (`isLoading`, `isError`, `hasData`)
+- [ ] Every async operation models loading, success, and error as distinct states
+- [ ] All state variants are handled exhaustively in UI — no silently ignored cases
+- [ ] Error states carry error information for display; loading states don't carry stale data
+- [ ] Nullable data is not used as a loading indicator — states are explicit
+
+```dart
+// BAD — boolean flag soup allows impossible states
+class UserState {
+  bool isLoading = false;
+  bool hasError = false; // isLoading && hasError is representable!
+  User? user;
+}
+
+// GOOD (immutable approach) — sealed types make impossible states unrepresentable
+sealed class UserState {}
+class UserInitial extends UserState {}
+class UserLoading extends UserState {}
+class UserLoaded extends UserState {
+  final User user;
+  const UserLoaded(this.user);
+}
+class UserError extends UserState {
+  final String message;
+  const UserError(this.message);
+}
+
+// GOOD (reactive approach) — observable enum + data, mutations via reactivity API
+// enum UserStatus { initial, loading, loaded, error }
+// Use your solution's observable/signal to wrap status and data separately
+```
+
+### Rebuild optimization:
+- [ ] State consumer widgets (Builder, Consumer, Observer, Obx, Watch, etc.) scoped as narrow as possible
+- [ ] Selectors used to rebuild only when specific fields change — not on every state emission
+- [ ] `const` widgets used to stop rebuild propagation through the tree
+- [ ] Computed/derived state is calculated reactively, not stored redundantly
+
+### Subscriptions & disposal:
+- [ ] All manual subscriptions (`.listen()`) are cancelled in `dispose()` / `close()`
+- [ ] Stream controllers are closed when no longer needed
+- [ ] Timers are cancelled in disposal lifecycle
+- [ ] Framework-managed lifecycle is preferred over manual subscription (declarative builders over `.listen()`)
+- [ ] `mounted` check before `setState` in async callbacks
+- [ ] `BuildContext` not used after `await` without checking `context.mounted` (Flutter 3.7+) — stale context causes crashes
+- [ ] No navigation, dialogs, or scaffold messages after async gaps without verifying the widget is still mounted
+- [ ] `BuildContext` never stored in singletons, state managers, or static fields
+
+### Local vs global state:
+- [ ] Ephemeral UI state (checkbox, slider, animation) uses local state (`setState`, `ValueNotifier`)
+- [ ] Shared state is lifted only as high as needed — not over-globalized
+- [ ] Feature-scoped state is properly disposed when the feature is no longer active
+
+---
+
+## 5. Performance
+
+### Unnecessary rebuilds:
+- [ ] `setState()` not called at root widget level — localize state changes
+- [ ] `const` widgets used to stop rebuild propagation
+- [ ] `RepaintBoundary` used around complex subtrees that repaint independently
+- [ ] `AnimatedBuilder` child parameter used for subtrees independent of animation
+
+### Expensive operations in build():
+- [ ] No sorting, filtering, or mapping large collections in `build()` — compute in state management layer
+- [ ] No regex compilation in `build()`
+- [ ] `MediaQuery.of(context)` usage is specific (e.g., `MediaQuery.sizeOf(context)`)
+
+### Image optimization:
+- [ ] Network images use caching (any caching solution appropriate for the project)
+- [ ] Appropriate image resolution for target device (no loading 4K images for thumbnails)
+- [ ] `Image.asset` with `cacheWidth`/`cacheHeight` to decode at display size
+- [ ] Placeholder and error widgets provided for network images
+
+### Lazy loading:
+- [ ] `ListView.builder` / `GridView.builder` used instead of `ListView(children: [...])` for large or dynamic lists (concrete constructors are fine for small, static lists)
+- [ ] Pagination implemented for large data sets
+- [ ] Deferred loading (`deferred as`) used for heavy libraries in web builds
+
+### Other:
+- [ ] `Opacity` widget avoided in animations — use `AnimatedOpacity` or `FadeTransition`
+- [ ] Clipping avoided in animations — pre-clip images
+- [ ] `operator ==` not overridden on widgets — use `const` constructors instead
+- [ ] Intrinsic dimension widgets (`IntrinsicHeight`, `IntrinsicWidth`) used sparingly (extra layout pass)
+
+---
+
+## 6. Testing
+
+### Test types and expectations:
+- [ ] **Unit tests**: Cover all business logic (state managers, repositories, utility functions)
+- [ ] **Widget tests**: Cover individual widget behavior, interactions, and visual output
+- [ ] **Integration tests**: Cover critical user flows end-to-end
+- [ ] **Golden tests**: Pixel-perfect comparisons for design-critical UI components
+
+### Coverage targets:
+- [ ] Aim for 80%+ line coverage on business logic
+- [ ] All state transitions have corresponding tests (loading → success, loading → error, retry, etc.)
+- [ ] Edge cases tested: empty states, error states, loading states, boundary values
+
+### Test isolation:
+- [ ] External dependencies (API clients, databases, services) are mocked or faked
+- [ ] Each test file tests exactly one class/unit
+- [ ] Tests verify behavior, not implementation details
+- [ ] Stubs define only the behavior needed for each test (minimal stubbing)
+- [ ] No shared mutable state between test cases
+
+### Widget test quality:
+- [ ] `pumpWidget` and `pump` used correctly for async operations
+- [ ] `find.byType`, `find.text`, `find.byKey` used appropriately
+- [ ] No flaky tests depending on timing — use `pumpAndSettle` or explicit `pump(Duration)`
+- [ ] Tests run in CI and failures block merges
+
+---
+
+## 7. Accessibility
+
+### Semantic widgets:
+- [ ] `Semantics` widget used to provide screen reader labels where automatic labels are insufficient
+- [ ] `ExcludeSemantics` used for purely decorative elements
+- [ ] `MergeSemantics` used to combine related widgets into a single accessible element
+- [ ] Images have `semanticLabel` property set
+
+### Screen reader support:
+- [ ] All interactive elements are focusable and have meaningful descriptions
+- [ ] Focus order is logical (follows visual reading order)
+
+### Visual accessibility:
+- [ ] Contrast ratio >= 4.5:1 for text against background
+- [ ] Tappable targets are at least 48x48 pixels
+- [ ] Color is not the sole indicator of state (use icons/text alongside)
+- [ ] Text scales with system font size settings
+
+### Interaction accessibility:
+- [ ] No no-op `onPressed` callbacks — every button does something or is disabled
+- [ ] Error fields suggest corrections
+- [ ] Context does not change unexpectedly while user is inputting data
+
+---
+
+## 8. Platform-Specific Concerns
+
+### iOS/Android differences:
+- [ ] Platform-adaptive widgets used where appropriate
+- [ ] Back navigation handled correctly (Android back button, iOS swipe-to-go-back)
+- [ ] Status bar and safe area handled via `SafeArea` widget
+- [ ] Platform-specific permissions declared in `AndroidManifest.xml` and `Info.plist`
+
+### Responsive design:
+- [ ] `LayoutBuilder` or `MediaQuery` used for responsive layouts
+- [ ] Breakpoints defined consistently (phone, tablet, desktop)
+- [ ] Text doesn't overflow on small screens — use `Flexible`, `Expanded`, `FittedBox`
+- [ ] Landscape orientation tested or explicitly locked
+- [ ] Web-specific: mouse/keyboard interactions supported, hover states present
+
+---
+
+## 9. Security
+
+### Secure storage:
+- [ ] Sensitive data (tokens, credentials) stored using platform-secure storage (Keychain on iOS, EncryptedSharedPreferences on Android)
+- [ ] Never store secrets in plaintext storage
+- [ ] Biometric authentication gating considered for sensitive operations
+
+### API key handling:
+- [ ] API keys NOT hardcoded in Dart source — use `--dart-define`, `.env` files excluded from VCS, or compile-time configuration
+- [ ] Secrets not committed to git — check `.gitignore`
+- [ ] Backend proxy used for truly secret keys (client should never hold server secrets)
+
+### Input validation:
+- [ ] All user input validated before sending to API
+- [ ] Form validation uses proper validation patterns
+- [ ] No raw SQL or string interpolation of user input
+- [ ] Deep link URLs validated and sanitized before navigation
+
+### Network security:
+- [ ] HTTPS enforced for all API calls
+- [ ] Certificate pinning considered for high-security apps
+- [ ] Authentication tokens refreshed and expired properly
+- [ ] No sensitive data logged or printed
+
+---
+
+## 10. Package/Dependency Review
+
+### Evaluating pub.dev packages:
+- [ ] Check **pub points score** (aim for 130+/160)
+- [ ] Check **likes** and **popularity** as community signals
+- [ ] Verify the publisher is **verified** on pub.dev
+- [ ] Check last publish date — stale packages (>1 year) are a risk
+- [ ] Review open issues and response time from maintainers
+- [ ] Check license compatibility with your project
+- [ ] Verify platform support covers your targets
+
+### Version constraints:
+- [ ] Use caret syntax (`^1.2.3`) for dependencies — allows compatible updates
+- [ ] Pin exact versions only when absolutely necessary
+- [ ] Run `flutter pub outdated` regularly to track stale dependencies
+- [ ] No dependency overrides in production `pubspec.yaml` — only for temporary fixes with a comment/issue link
+- [ ] Minimize transitive dependency count — each dependency is an attack surface
+
+### Monorepo-specific (melos/workspace):
+- [ ] Internal packages import only from public API — no `package:other/src/internal.dart` (breaks Dart package encapsulation)
+- [ ] Internal package dependencies use workspace resolution, not hardcoded `path: ../../` relative strings
+- [ ] All sub-packages share or inherit root `analysis_options.yaml`
+
+---
+
+## 11. Navigation and Routing
+
+### General principles (apply to any routing solution):
+- [ ] One routing approach used consistently — no mixing imperative `Navigator.push` with a declarative router
+- [ ] Route arguments are typed — no `Map<String, dynamic>` or `Object?` casting
+- [ ] Route paths defined as constants, enums, or generated — no magic strings scattered in code
+- [ ] Auth guards/redirects centralized — not duplicated across individual screens
+- [ ] Deep links configured for both Android and iOS
+- [ ] Deep link URLs validated and sanitized before navigation
+- [ ] Navigation state is testable — route changes can be verified in tests
+- [ ] Back behavior is correct on all platforms
+
+---
+
+## 12. Error Handling
+
+### Framework error handling:
+- [ ] `FlutterError.onError` overridden to capture framework errors (build, layout, paint)
+- [ ] `PlatformDispatcher.instance.onError` set for async errors not caught by Flutter
+- [ ] `ErrorWidget.builder` customized for release mode (user-friendly instead of red screen)
+- [ ] Global error capture wrapper around `runApp` (e.g., `runZonedGuarded`, Sentry/Crashlytics wrapper)
+
+### Error reporting:
+- [ ] Error reporting service integrated (Firebase Crashlytics, Sentry, or equivalent)
+- [ ] Non-fatal errors reported with stack traces
+- [ ] State management error observer wired to error reporting (e.g., BlocObserver, ProviderObserver, or equivalent for your solution)
+- [ ] User-identifiable info (user ID) attached to error reports for debugging
+
+### Graceful degradation:
+- [ ] API errors result in user-friendly error UI, not crashes
+- [ ] Retry mechanisms for transient network failures
+- [ ] Offline state handled gracefully
+- [ ] Error states in state management carry error info for display
+- [ ] Raw exceptions (network, parsing) are mapped to user-friendly, localized messages before reaching the UI — never show raw exception strings to users
+
+---
+
+## 13. Internationalization (l10n)
+
+### Setup:
+- [ ] Localization solution configured (Flutter's built-in ARB/l10n, easy_localization, or equivalent)
+- [ ] Supported locales declared in app configuration
+
+### Content:
+- [ ] All user-visible strings use the localization system — no hardcoded strings in widgets
+- [ ] Template file includes descriptions/context for translators
+- [ ] ICU message syntax used for plurals, genders, selects
+- [ ] Placeholders defined with types
+- [ ] No missing keys across locales
+
+### Code review:
+- [ ] Localization accessor used consistently throughout the project
+- [ ] Date, time, number, and currency formatting is locale-aware
+- [ ] Text directionality (RTL) supported if targeting Arabic, Hebrew, etc.
+- [ ] No string concatenation for localized text — use parameterized messages
+
+---
+
+## 14. Dependency Injection
+
+### Principles (apply to any DI approach):
+- [ ] Classes depend on abstractions (interfaces), not concrete implementations at layer boundaries
+- [ ] Dependencies provided externally via constructor, DI framework, or provider graph — not created internally
+- [ ] Registration distinguishes lifetime: singleton vs factory vs lazy singleton
+- [ ] Environment-specific bindings (dev/staging/prod) use configuration, not runtime `if` checks
+- [ ] No circular dependencies in the DI graph
+- [ ] Service locator calls (if used) are not scattered throughout business logic
+
+---
+
+## 15. Static Analysis
+
+### Configuration:
+- [ ] `analysis_options.yaml` present with strict settings enabled
+- [ ] Strict analyzer settings: `strict-casts: true`, `strict-inference: true`, `strict-raw-types: true`
+- [ ] A comprehensive lint rule set is included (very_good_analysis, flutter_lints, or custom strict rules)
+- [ ] All sub-packages in monorepos inherit or share the root analysis options
+
+### Enforcement:
+- [ ] No unresolved analyzer warnings in committed code
+- [ ] Lint suppressions (`// ignore:`) are justified with comments explaining why
+- [ ] `flutter analyze` runs in CI and failures block merges
+
+### Key rules to verify regardless of lint package:
+- [ ] `prefer_const_constructors` — performance in widget trees
+- [ ] `avoid_print` — use proper logging
+- [ ] `unawaited_futures` — prevent fire-and-forget async bugs
+- [ ] `prefer_final_locals` — immutability at variable level
+- [ ] `always_declare_return_types` — explicit contracts
+- [ ] `avoid_catches_without_on_clauses` — specific error handling
+- [ ] `always_use_package_imports` — consistent import style
+
+---
+
+## State Management Quick Reference
+
+The table below maps universal principles to their implementation in popular solutions. Use this to adapt review rules to whichever solution the project uses.
+
+| Principle | BLoC/Cubit | Riverpod | Provider | GetX | MobX | Signals | Built-in |
+|-----------|-----------|----------|----------|------|------|---------|----------|
+| State container | `Bloc`/`Cubit` | `Notifier`/`AsyncNotifier` | `ChangeNotifier` | `GetxController` | `Store` | `signal()` | `StatefulWidget` |
+| UI consumer | `BlocBuilder` | `ConsumerWidget` | `Consumer` | `Obx`/`GetBuilder` | `Observer` | `Watch` | `setState` |
+| Selector | `BlocSelector`/`buildWhen` | `ref.watch(p.select(...))` | `Selector` | N/A | computed | `computed()` | N/A |
+| Side effects | `BlocListener` | `ref.listen` | `Consumer` callback | `ever()`/`once()` | `reaction` | `effect()` | callbacks |
+| Disposal | auto via `BlocProvider` | `.autoDispose` | auto via `Provider` | `onClose()` | `ReactionDisposer` | manual | `dispose()` |
+| Testing | `blocTest()` | `ProviderContainer` | `ChangeNotifier` directly | `Get.put` in test | store directly | signal directly | widget test |
+
+---
+
+## Sources
+
+- [Effective Dart: Style](https://dart.dev/effective-dart/style)
+- [Effective Dart: Usage](https://dart.dev/effective-dart/usage)
+- [Effective Dart: Design](https://dart.dev/effective-dart/design)
+- [Flutter Performance Best Practices](https://docs.flutter.dev/perf/best-practices)
+- [Flutter Testing Overview](https://docs.flutter.dev/testing/overview)
+- [Flutter Accessibility](https://docs.flutter.dev/ui/accessibility-and-internationalization/accessibility)
+- [Flutter Internationalization](https://docs.flutter.dev/ui/accessibility-and-internationalization/internationalization)
+- [Flutter Navigation and Routing](https://docs.flutter.dev/ui/navigation)
+- [Flutter Error Handling](https://docs.flutter.dev/testing/errors)
+- [Flutter State Management Options](https://docs.flutter.dev/data-and-backend/state-mgmt/options)
diff --git a/.claude/skills/flutter-development/SKILL.md b/.claude/skills/flutter-development/SKILL.md
new file mode 100644
index 0000000..4ca2a37
--- /dev/null
+++ b/.claude/skills/flutter-development/SKILL.md
@@ -0,0 +1,316 @@
+---
+name: flutter-development
+description: Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.
+---
+
+# Flutter Development
+
+## Overview
+
+Create high-performance, visually stunning mobile applications using Flutter with Dart language. Master widget composition, state management patterns, navigation, and API integration.
+
+## When to Use
+
+- Building iOS and Android apps with native performance
+- Designing custom UIs with Flutter's widget system
+- Implementing complex animations and visual effects
+- Rapid app development with hot reload
+- Creating consistent UX across platforms
+
+## Instructions
+
+### 1. **Project Structure & Navigation**
+
+```dart
+// pubspec.yaml
+name: my_flutter_app
+version: 1.0.0
+
+dependencies:
+  flutter:
+    sdk: flutter
+  provider: ^6.0.0
+  http: ^1.1.0
+  go_router: ^12.0.0
+
+// main.dart with GoRouter navigation
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+
+void main() {
+  runApp(const MyApp());
+}
+
+class MyApp extends StatelessWidget {
+  const MyApp({Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp.router(
+      title: 'Flutter App',
+      theme: ThemeData(primarySwatch: Colors.blue, useMaterial3: true),
+      routerConfig: _router,
+    );
+  }
+}
+
+final GoRouter _router = GoRouter(
+  routes: <RouteBase>[
+    GoRoute(
+      path: '/',
+      builder: (context, state) => const HomeScreen(),
+      routes: [
+        GoRoute(
+          path: 'details/:id',
+          builder: (context, state) => DetailsScreen(
+            itemId: state.pathParameters['id']!
+          ),
+        ),
+      ],
+    ),
+    GoRoute(
+      path: '/profile',
+      builder: (context, state) => const ProfileScreen(),
+    ),
+  ],
+);
+```
+
+### 2. **State Management with Provider**
+
+```dart
+import 'package:flutter/material.dart';
+import 'package:http/http.dart' as http;
+import 'dart:convert';
+
+class User {
+  final String id;
+  final String name;
+  final String email;
+
+  User({required this.id, required this.name, required this.email});
+
+  factory User.fromJson(Map<String, dynamic> json) {
+    return User(
+      id: json['id'],
+      name: json['name'],
+      email: json['email'],
+    );
+  }
+}
+
+class UserProvider extends ChangeNotifier {
+  User? _user;
+  bool _isLoading = false;
+  String? _error;
+
+  User? get user => _user;
+  bool get isLoading => _isLoading;
+  String? get error => _error;
+
+  Future<void> fetchUser(String userId) async {
+    _isLoading = true;
+    _error = null;
+    notifyListeners();
+
+    try {
+      final response = await http.get(
+        Uri.parse('https://api.example.com/users/$userId'),
+        headers: {'Content-Type': 'application/json'},
+      );
+
+      if (response.statusCode == 200) {
+        _user = User.fromJson(jsonDecode(response.body));
+      } else {
+        _error = 'Failed to fetch user';
+      }
+    } catch (e) {
+      _error = 'Error: ${e.toString()}';
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+
+  void logout() {
+    _user = null;
+    notifyListeners();
+  }
+}
+
+class ItemsProvider extends ChangeNotifier {
+  List<Map<String, dynamic>> _items = [];
+
+  List<Map<String, dynamic>> get items => _items;
+
+  Future<void> fetchItems() async {
+    try {
+      final response = await http.get(
+        Uri.parse('https://api.example.com/items'),
+      );
+
+      if (response.statusCode == 200) {
+        _items = List<Map<String, dynamic>>.from(
+          jsonDecode(response.body) as List
+        );
+        notifyListeners();
+      }
+    } catch (e) {
+      print('Error fetching items: $e');
+    }
+  }
+}
+```
+
+### 3. **Screens with Provider Integration**
+
+```dart
+class HomeScreen extends StatefulWidget {
+  const HomeScreen({Key? key}) : super(key: key);
+
+  @override
+  State<HomeScreen> createState() => _HomeScreenState();
+}
+
+class _HomeScreenState extends State<HomeScreen> {
+  @override
+  void initState() {
+    super.initState();
+    Future.microtask(() {
+      Provider.of<ItemsProvider>(context, listen: false).fetchItems();
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Home Feed')),
+      body: Consumer<ItemsProvider>(
+        builder: (context, itemsProvider, child) {
+          if (itemsProvider.items.isEmpty) {
+            return const Center(child: Text('No items found'));
+          }
+          return ListView.builder(
+            itemCount: itemsProvider.items.length,
+            itemBuilder: (context, index) {
+              final item = itemsProvider.items[index];
+              return ItemCard(item: item);
+            },
+          );
+        },
+      ),
+    );
+  }
+}
+
+class ItemCard extends StatelessWidget {
+  final Map<String, dynamic> item;
+
+  const ItemCard({required this.item, Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Card(
+      margin: const EdgeInsets.all(8),
+      child: ListTile(
+        title: Text(item['title'] ?? 'Untitled'),
+        subtitle: Text(item['description'] ?? ''),
+        trailing: const Icon(Icons.arrow_forward),
+        onTap: () => context.go('/details/${item['id']}'),
+      ),
+    );
+  }
+}
+
+class DetailsScreen extends StatelessWidget {
+  final String itemId;
+
+  const DetailsScreen({required this.itemId, Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Details')),
+      body: Center(
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            Text('Item ID: $itemId', style: const TextStyle(fontSize: 18)),
+            const SizedBox(height: 16),
+            ElevatedButton(
+              onPressed: () => context.pop(),
+              child: const Text('Go Back'),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class ProfileScreen extends StatelessWidget {
+  const ProfileScreen({Key? key}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Profile')),
+      body: Consumer<UserProvider>(
+        builder: (context, userProvider, child) {
+          if (userProvider.isLoading) {
+            return const Center(child: CircularProgressIndicator());
+          }
+          if (userProvider.error != null) {
+            return Center(child: Text('Error: ${userProvider.error}'));
+          }
+          final user = userProvider.user;
+          if (user == null) {
+            return const Center(child: Text('No user data'));
+          }
+          return Padding(
+            padding: const EdgeInsets.all(16),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Text('Name: ${user.name}', style: const TextStyle(fontSize: 18)),
+                Text('Email: ${user.email}', style: const TextStyle(fontSize: 16)),
+                const SizedBox(height: 16),
+                ElevatedButton(
+                  onPressed: () => userProvider.logout(),
+                  child: const Text('Logout'),
+                ),
+              ],
+            ),
+          );
+        },
+      ),
+    );
+  }
+}
+```
+
+## Best Practices
+
+### ✅ DO
+- Use widgets for every UI element
+- Implement proper state management
+- Use const constructors where possible
+- Dispose resources in state lifecycle
+- Test on multiple device sizes
+- Use meaningful widget names
+- Implement error handling
+- Use responsive design patterns
+- Test on both iOS and Android
+- Document custom widgets
+
+### ❌ DON'T
+- Build entire screens in build() method
+- Use setState for complex state logic
+- Make network calls in build()
+- Ignore platform differences
+- Create overly nested widget trees
+- Hardcode strings
+- Ignore performance warnings
+- Skip testing
+- Forget to handle edge cases
+- Deploy without thorough testing
diff --git a/.claude/skills/flutter-expert/SKILL.md b/.claude/skills/flutter-expert/SKILL.md
new file mode 100644
index 0000000..4692d36
--- /dev/null
+++ b/.claude/skills/flutter-expert/SKILL.md
@@ -0,0 +1,200 @@
+---
+name: flutter-expert
+description: Master Flutter development with Dart 3, advanced widgets, and
+  multi-platform deployment. Handles state management, animations, testing, and
+  performance optimization for mobile, web, desktop, and embedded platforms. Use
+  PROACTIVELY for Flutter architecture, UI implementation, or cross-platform
+  features.
+metadata:
+  model: inherit
+---
+
+## Use this skill when
+
+- Working on flutter expert tasks or workflows
+- Needing guidance, best practices, or checklists for flutter expert
+
+## Do not use this skill when
+
+- The task is unrelated to flutter expert
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a Flutter expert specializing in high-performance, multi-platform applications with deep knowledge of the Flutter 2025 ecosystem.
+
+## Purpose
+Expert Flutter developer specializing in Flutter 3.x+, Dart 3.x, and comprehensive multi-platform development. Masters advanced widget composition, performance optimization, and platform-specific integrations while maintaining a unified codebase across mobile, web, desktop, and embedded platforms.
+
+## Capabilities
+
+### Core Flutter Mastery
+- Flutter 3.x multi-platform architecture (mobile, web, desktop, embedded)
+- Widget composition patterns and custom widget creation
+- Impeller rendering engine optimization (replacing Skia)
+- Flutter Engine customization and platform embedding
+- Advanced widget lifecycle management and optimization
+- Custom render objects and painting techniques
+- Material Design 3 and Cupertino design system implementation
+- Accessibility-first widget development with semantic annotations
+
+### Dart Language Expertise
+- Dart 3.x advanced features (patterns, records, sealed classes)
+- Null safety mastery and migration strategies
+- Asynchronous programming with Future, Stream, and Isolate
+- FFI (Foreign Function Interface) for C/C++ integration
+- Extension methods and advanced generic programming
+- Mixins and composition patterns for code reuse
+- Meta-programming with annotations and code generation
+- Memory management and garbage collection optimization
+
+### State Management Excellence
+- **Riverpod 2.x**: Modern provider pattern with compile-time safety
+- **Bloc/Cubit**: Business logic components with event-driven architecture
+- **GetX**: Reactive state management with dependency injection
+- **Provider**: Foundation pattern for simple state sharing
+- **Stacked**: MVVM architecture with service locator pattern
+- **MobX**: Reactive state management with observables
+- **Redux**: Predictable state containers for complex apps
+- Custom state management solutions and hybrid approaches
+
+### Architecture Patterns
+- Clean Architecture with well-defined layer separation
+- Feature-driven development with modular code organization
+- MVVM, MVP, and MVI patterns for presentation layer
+- Repository pattern for data abstraction and caching
+- Dependency injection with GetIt, Injectable, and Riverpod
+- Modular monolith architecture for scalable applications
+- Event-driven architecture with domain events
+- CQRS pattern for complex business logic separation
+
+### Platform Integration Mastery
+- **iOS Integration**: Swift platform channels, Cupertino widgets, App Store optimization
+- **Android Integration**: Kotlin platform channels, Material Design 3, Play Store compliance
+- **Web Platform**: PWA configuration, web-specific optimizations, responsive design
+- **Desktop Platforms**: Windows, macOS, and Linux native features
+- **Embedded Systems**: Custom embedder development and IoT integration
+- Platform channel creation and bidirectional communication
+- Native plugin development and maintenance
+- Method channel, event channel, and basic message channel usage
+
+### Performance Optimization
+- Impeller rendering engine optimization and migration strategies
+- Widget rebuilds minimization with const constructors and keys
+- Memory profiling with Flutter DevTools and custom metrics
+- Image optimization, caching, and lazy loading strategies
+- List virtualization for large datasets with Slivers
+- Isolate usage for CPU-intensive tasks and background processing
+- Build optimization and app bundle size reduction
+- Frame rendering optimization for 60/120fps performance
+
+### Advanced UI & UX Implementation
+- Custom animations with AnimationController and Tween
+- Implicit animations for smooth user interactions
+- Hero animations and shared element transitions
+- Rive and Lottie integration for complex animations
+- Custom painters for complex graphics and charts
+- Responsive design with LayoutBuilder and MediaQuery
+- Adaptive design patterns for multiple form factors
+- Custom themes and design system implementation
+
+### Testing Strategies
+- Comprehensive unit testing with mockito and fake implementations
+- Widget testing with testWidgets and golden file testing
+- Integration testing with Patrol and custom test drivers
+- Performance testing and benchmark creation
+- Accessibility testing with semantic finder
+- Test coverage analysis and reporting
+- Continuous testing in CI/CD pipelines
+- Device farm testing and cloud-based testing solutions
+
+### Data Management & Persistence
+- Local databases with SQLite, Hive, and ObjectBox
+- Drift (formerly Moor) for type-safe database operations
+- SharedPreferences and Secure Storage for app preferences
+- File system operations and document management
+- Cloud storage integration (Firebase, AWS, Google Cloud)
+- Offline-first architecture with synchronization patterns
+- GraphQL integration with Ferry or Artemis
+- REST API integration with Dio and custom interceptors
+
+### DevOps & Deployment
+- CI/CD pipelines with Codemagic, GitHub Actions, and Bitrise
+- Automated testing and deployment workflows
+- Flavors and environment-specific configurations
+- Code signing and certificate management for all platforms
+- App store deployment automation for multiple platforms
+- Over-the-air updates and dynamic feature delivery
+- Performance monitoring and crash reporting integration
+- Analytics implementation and user behavior tracking
+
+### Security & Compliance
+- Secure storage implementation with native keychain integration
+- Certificate pinning and network security best practices
+- Biometric authentication with local_auth plugin
+- Code obfuscation and security hardening techniques
+- GDPR compliance and privacy-first development
+- API security and authentication token management
+- Runtime security and tampering detection
+- Penetration testing and vulnerability assessment
+
+### Advanced Features
+- Machine Learning integration with TensorFlow Lite
+- Computer vision and image processing capabilities
+- Augmented Reality with ARCore and ARKit integration
+- IoT device connectivity and BLE protocol implementation
+- Real-time features with WebSockets and Firebase
+- Background processing and notification handling
+- Deep linking and dynamic link implementation
+- Internationalization and localization best practices
+
+## Behavioral Traits
+- Prioritizes widget composition over inheritance
+- Implements const constructors for optimal performance
+- Uses keys strategically for widget identity management
+- Maintains platform awareness while maximizing code reuse
+- Tests widgets in isolation with comprehensive coverage
+- Profiles performance on real devices across all platforms
+- Follows Material Design 3 and platform-specific guidelines
+- Implements comprehensive error handling and user feedback
+- Considers accessibility throughout the development process
+- Documents code with clear examples and widget usage patterns
+
+## Knowledge Base
+- Flutter 2025 roadmap and upcoming features
+- Dart language evolution and experimental features
+- Impeller rendering engine architecture and optimization
+- Platform-specific API updates and deprecations
+- Performance optimization techniques and profiling tools
+- Modern app architecture patterns and best practices
+- Cross-platform development trade-offs and solutions
+- Accessibility standards and inclusive design principles
+- App store requirements and optimization strategies
+- Emerging technologies integration (AR, ML, IoT)
+
+## Response Approach
+1. **Analyze requirements** for optimal Flutter architecture
+2. **Recommend state management** solution based on complexity
+3. **Provide platform-optimized code** with performance considerations
+4. **Include comprehensive testing** strategies and examples
+5. **Consider accessibility** and inclusive design from the start
+6. **Optimize for performance** across all target platforms
+7. **Plan deployment strategies** for multiple app stores
+8. **Address security and privacy** requirements proactively
+
+## Example Interactions
+- "Architect a Flutter app with clean architecture and Riverpod"
+- "Implement complex animations with custom painters and controllers"
+- "Create a responsive design that adapts to mobile, tablet, and desktop"
+- "Optimize Flutter web performance for production deployment"
+- "Integrate native iOS/Android features with platform channels"
+- "Set up comprehensive testing strategy with golden files"
+- "Implement offline-first data sync with conflict resolution"
+- "Create accessible widgets following Material Design 3 guidelines"
+
+Always use null safety with Dart 3 features. Include comprehensive error handling, loading states, and accessibility annotations.
diff --git a/.claude/skills/frontend-design/LICENSE.txt b/.claude/skills/frontend-design/LICENSE.txt
new file mode 100644
index 0000000..f433b1a
--- /dev/null
+++ b/.claude/skills/frontend-design/LICENSE.txt
@@ -0,0 +1,177 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
diff --git a/.claude/skills/frontend-design/SKILL.md b/.claude/skills/frontend-design/SKILL.md
new file mode 100644
index 0000000..8a5fa03
--- /dev/null
+++ b/.claude/skills/frontend-design/SKILL.md
@@ -0,0 +1,42 @@
+---
+name: frontend-design
+description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
+license: Complete terms in LICENSE.txt
+---
+
+This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.
+
+The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints.
+
+## Design Thinking
+
+Before coding, understand the context and commit to a BOLD aesthetic direction:
+- **Purpose**: What problem does this interface solve? Who uses it?
+- **Tone**: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc. There are so many flavors to choose from. Use these for inspiration but design one that is true to the aesthetic direction.
+- **Constraints**: Technical requirements (framework, performance, accessibility).
+- **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember?
+
+**CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.
+
+Then implement working code (HTML/CSS/JS, React, Vue, etc.) that is:
+- Production-grade and functional
+- Visually striking and memorable
+- Cohesive with a clear aesthetic point-of-view
+- Meticulously refined in every detail
+
+## Frontend Aesthetics Guidelines
+
+Focus on:
+- **Typography**: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics; unexpected, characterful font choices. Pair a distinctive display font with a refined body font.
+- **Color & Theme**: Commit to a cohesive aesthetic. Use CSS variables for consistency. Dominant colors with sharp accents outperform timid, evenly-distributed palettes.
+- **Motion**: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for HTML. Use Motion library for React when available. Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions. Use scroll-triggering and hover states that surprise.
+- **Spatial Composition**: Unexpected layouts. Asymmetry. Overlap. Diagonal flow. Grid-breaking elements. Generous negative space OR controlled density.
+- **Backgrounds & Visual Details**: Create atmosphere and depth rather than defaulting to solid colors. Add contextual effects and textures that match the overall aesthetic. Apply creative forms like gradient meshes, noise textures, geometric patterns, layered transparencies, dramatic shadows, decorative borders, custom cursors, and grain overlays.
+
+NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white backgrounds), predictable layouts and component patterns, and cookie-cutter design that lacks context-specific character.
+
+Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics. NEVER converge on common choices (Space Grotesk, for example) across generations.
+
+**IMPORTANT**: Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details. Elegance comes from executing the vision well.
+
+Remember: Codex is capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision.
diff --git a/.claude/skills/grill-me/SKILL.md b/.claude/skills/grill-me/SKILL.md
new file mode 100644
index 0000000..bd04394
--- /dev/null
+++ b/.claude/skills/grill-me/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: grill-me
+description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
+---
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
diff --git a/.claude/skills/grill-with-docs/ADR-FORMAT.md b/.claude/skills/grill-with-docs/ADR-FORMAT.md
new file mode 100644
index 0000000..da7e78e
--- /dev/null
+++ b/.claude/skills/grill-with-docs/ADR-FORMAT.md
@@ -0,0 +1,47 @@
+# ADR Format
+
+ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
+
+Create the `docs/adr/` directory lazily — only when the first ADR is needed.
+
+## Template
+
+```md
+# {Short title of the decision}
+
+{1-3 sentences: what's the context, what did we decide, and why.}
+```
+
+That's it. An ADR can be a single paragraph. The value is in recording *that* a decision was made and *why* — not in filling out sections.
+
+## Optional sections
+
+Only include these when they add genuine value. Most ADRs won't need them.
+
+- **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited
+- **Considered Options** — only when the rejected alternatives are worth remembering
+- **Consequences** — only when non-obvious downstream effects need to be called out
+
+## Numbering
+
+Scan `docs/adr/` for the highest existing number and increment by one.
+
+## When to offer an ADR
+
+All three of these must be true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing."
+
+### What qualifies
+
+- **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres."
+- **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP."
+- **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out.
+- **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s.
+- **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate.
+- **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract."
+- **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months.
diff --git a/.claude/skills/grill-with-docs/CONTEXT-FORMAT.md b/.claude/skills/grill-with-docs/CONTEXT-FORMAT.md
new file mode 100644
index 0000000..ddfa247
--- /dev/null
+++ b/.claude/skills/grill-with-docs/CONTEXT-FORMAT.md
@@ -0,0 +1,77 @@
+# CONTEXT.md Format
+
+## Structure
+
+```md
+# {Context Name}
+
+{One or two sentence description of what this context is and why it exists.}
+
+## Language
+
+**Order**:
+{A concise description of the term}
+_Avoid_: Purchase, transaction
+
+**Invoice**:
+A request for payment sent to a customer after delivery.
+_Avoid_: Bill, payment request
+
+**Customer**:
+A person or organization that places orders.
+_Avoid_: Client, buyer, account
+
+## Relationships
+
+- An **Order** produces one or more **Invoices**
+- An **Invoice** belongs to exactly one **Customer**
+
+## Example dialogue
+
+> **Dev:** "When a **Customer** places an **Order**, do we create the **Invoice** immediately?"
+> **Domain expert:** "No — an **Invoice** is only generated once a **Fulfillment** is confirmed."
+
+## Flagged ambiguities
+
+- "account" was used to mean both **Customer** and **User** — resolved: these are distinct concepts.
+```
+
+## Rules
+
+- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others as aliases to avoid.
+- **Flag conflicts explicitly.** If a term is used ambiguously, call it out in "Flagged ambiguities" with a clear resolution.
+- **Keep definitions tight.** One sentence max. Define what it IS, not what it does.
+- **Show relationships.** Use bold term names and express cardinality where obvious.
+- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
+- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
+- **Write an example dialogue.** A conversation between a dev and a domain expert that demonstrates how the terms interact naturally and clarifies boundaries between related concepts.
+
+## Single vs multi-context repos
+
+**Single context (most repos):** One `CONTEXT.md` at the repo root.
+
+**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
+
+```md
+# Context Map
+
+## Contexts
+
+- [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders
+- [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments
+- [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping
+
+## Relationships
+
+- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
+- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
+- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
+```
+
+The skill infers which structure applies:
+
+- If `CONTEXT-MAP.md` exists, read it to find contexts
+- If only a root `CONTEXT.md` exists, single context
+- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
+
+When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
diff --git a/.claude/skills/grill-with-docs/SKILL.md b/.claude/skills/grill-with-docs/SKILL.md
new file mode 100644
index 0000000..5ea0aa9
--- /dev/null
+++ b/.claude/skills/grill-with-docs/SKILL.md
@@ -0,0 +1,88 @@
+---
+name: grill-with-docs
+description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
+---
+
+<what-to-do>
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time, waiting for feedback on each question before continuing.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
+
+</what-to-do>
+
+<supporting-info>
+
+## Domain awareness
+
+During codebase exploration, also look for existing documentation:
+
+### File structure
+
+Most repos have a single context:
+
+```
+/
+├── CONTEXT.md
+├── docs/
+│   └── adr/
+│       ├── 0001-event-sourced-orders.md
+│       └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/
+│   └── adr/                          ← system-wide decisions
+├── src/
+│   ├── ordering/
+│   │   ├── CONTEXT.md
+│   │   └── docs/adr/                 ← context-specific decisions
+│   └── billing/
+│       ├── CONTEXT.md
+│       └── docs/adr/
+```
+
+Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
+
+## During the session
+
+### Challenge against the glossary
+
+When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"
+
+### Sharpen fuzzy language
+
+When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things."
+
+### Discuss concrete scenarios
+
+When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
+
+### Cross-reference with code
+
+When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible — which is right?"
+
+### Update CONTEXT.md inline
+
+When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
+
+`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
+
+### Offer ADRs sparingly
+
+Only offer to create an ADR when all three are true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will wonder "why did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md).
+
+</supporting-info>
diff --git a/.claude/skills/handoff/SKILL.md b/.claude/skills/handoff/SKILL.md
new file mode 100644
index 0000000..28bfb3a
--- /dev/null
+++ b/.claude/skills/handoff/SKILL.md
@@ -0,0 +1,13 @@
+---
+name: handoff
+description: Compact the current conversation into a handoff document for another agent to pick up.
+argument-hint: "What will the next session be used for?"
+---
+
+Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it).
+
+Suggest the skills to be used, if any, by the next session.
+
+Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+
+If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
diff --git a/.claude/skills/improve-codebase-architecture/DEEPENING.md b/.claude/skills/improve-codebase-architecture/DEEPENING.md
new file mode 100644
index 0000000..ecaf5d7
--- /dev/null
+++ b/.claude/skills/improve-codebase-architecture/DEEPENING.md
@@ -0,0 +1,37 @@
+# Deepening
+
+How to deepen a cluster of shallow modules safely, given its dependencies. Assumes the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**.
+
+## Dependency categories
+
+When assessing a candidate for deepening, classify its dependencies. The category determines how the deepened module is tested across its seam.
+
+### 1. In-process
+
+Pure computation, in-memory state, no I/O. Always deepenable — merge the modules and test through the new interface directly. No adapter needed.
+
+### 2. Local-substitutable
+
+Dependencies that have local test stand-ins (PGLite for Postgres, in-memory filesystem). Deepenable if the stand-in exists. The deepened module is tested with the stand-in running in the test suite. The seam is internal; no port at the module's external interface.
+
+### 3. Remote but owned (Ports & Adapters)
+
+Your own services across a network boundary (microservices, internal APIs). Define a **port** (interface) at the seam. The deep module owns the logic; the transport is injected as an **adapter**. Tests use an in-memory adapter. Production uses an HTTP/gRPC/queue adapter.
+
+Recommendation shape: *"Define a port at the seam, implement an HTTP adapter for production and an in-memory adapter for testing, so the logic sits in one deep module even though it's deployed across a network."*
+
+### 4. True external (Mock)
+
+Third-party services (Stripe, Twilio, etc.) you don't control. The deepened module takes the external dependency as an injected port; tests provide a mock adapter.
+
+## Seam discipline
+
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a port unless at least two adapters are justified (typically production + test). A single-adapter seam is just indirection.
+- **Internal seams vs external seams.** A deep module can have internal seams (private to its implementation, used by its own tests) as well as the external seam at its interface. Don't expose internal seams through the interface just because tests use them.
+
+## Testing strategy: replace, don't layer
+
+- Old unit tests on shallow modules become waste once tests at the deepened module's interface exist — delete them.
+- Write new tests at the deepened module's interface. The **interface is the test surface**.
+- Tests assert on observable outcomes through the interface, not internal state.
+- Tests should survive internal refactors — they describe behaviour, not implementation. If a test has to change when the implementation changes, it's testing past the interface.
diff --git a/.claude/skills/improve-codebase-architecture/INTERFACE-DESIGN.md b/.claude/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
new file mode 100644
index 0000000..3197723
--- /dev/null
+++ b/.claude/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
@@ -0,0 +1,44 @@
+# Interface Design
+
+When the user wants to explore alternative interfaces for a chosen deepening candidate, use this parallel sub-agent pattern. Based on "Design It Twice" (Ousterhout) — your first idea is unlikely to be the best.
+
+Uses the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**, **leverage**.
+
+## Process
+
+### 1. Frame the problem space
+
+Before spawning sub-agents, write a user-facing explanation of the problem space for the chosen candidate:
+
+- The constraints any new interface would need to satisfy
+- The dependencies it would rely on, and which category they fall into (see [DEEPENING.md](DEEPENING.md))
+- A rough illustrative code sketch to ground the constraints — not a proposal, just a way to make the constraints concrete
+
+Show this to the user, then immediately proceed to Step 2. The user reads and thinks while the sub-agents work in parallel.
+
+### 2. Spawn sub-agents
+
+Spawn 3+ sub-agents in parallel using the Agent tool. Each must produce a **radically different** interface for the deepened module.
+
+Prompt each sub-agent with a separate technical brief (file paths, coupling details, dependency category from [DEEPENING.md](DEEPENING.md), what sits behind the seam). The brief is independent of the user-facing problem-space explanation in Step 1. Give each agent a different design constraint:
+
+- Agent 1: "Minimize the interface — aim for 1–3 entry points max. Maximise leverage per entry point."
+- Agent 2: "Maximise flexibility — support many use cases and extension."
+- Agent 3: "Optimise for the most common caller — make the default case trivial."
+- Agent 4 (if applicable): "Design around ports & adapters for cross-seam dependencies."
+
+Include both [LANGUAGE.md](LANGUAGE.md) vocabulary and CONTEXT.md vocabulary in the brief so each sub-agent names things consistently with the architecture language and the project's domain language.
+
+Each sub-agent outputs:
+
+1. Interface (types, methods, params — plus invariants, ordering, error modes)
+2. Usage example showing how callers use it
+3. What the implementation hides behind the seam
+4. Dependency strategy and adapters (see [DEEPENING.md](DEEPENING.md))
+5. Trade-offs — where leverage is high, where it's thin
+
+### 3. Present and compare
+
+Present designs sequentially so the user can absorb each one, then compare them in prose. Contrast by **depth** (leverage at the interface), **locality** (where change concentrates), and **seam placement**.
+
+After comparing, give your own recommendation: which design you think is strongest and why. If elements from different designs would combine well, propose a hybrid. Be opinionated — the user wants a strong read, not a menu.
diff --git a/.claude/skills/improve-codebase-architecture/LANGUAGE.md b/.claude/skills/improve-codebase-architecture/LANGUAGE.md
new file mode 100644
index 0000000..530c276
--- /dev/null
+++ b/.claude/skills/improve-codebase-architecture/LANGUAGE.md
@@ -0,0 +1,53 @@
+# Language
+
+Shared vocabulary for every suggestion this skill makes. Use these terms exactly — don't substitute "component," "service," "API," or "boundary." Consistent language is the whole point.
+
+## Terms
+
+**Module**
+Anything with an interface and an implementation. Deliberately scale-agnostic — applies equally to a function, class, package, or tier-spanning slice.
+_Avoid_: unit, component, service.
+
+**Interface**
+Everything a caller must know to use the module correctly. Includes the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics.
+_Avoid_: API, signature (too narrow — those refer only to the type-level surface).
+
+**Implementation**
+What's inside a module — its body of code. Distinct from **Adapter**: a thing can be a small adapter with a large implementation (a Postgres repo) or a large adapter with a small implementation (an in-memory fake). Reach for "adapter" when the seam is the topic; "implementation" otherwise.
+
+**Depth**
+Leverage at the interface — the amount of behaviour a caller (or test) can exercise per unit of interface they have to learn. A module is **deep** when a large amount of behaviour sits behind a small interface. A module is **shallow** when the interface is nearly as complex as the implementation.
+
+**Seam** _(from Michael Feathers)_
+A place where you can alter behaviour without editing in that place. The *location* at which a module's interface lives. Choosing where to put the seam is its own design decision, distinct from what goes behind it.
+_Avoid_: boundary (overloaded with DDD's bounded context).
+
+**Adapter**
+A concrete thing that satisfies an interface at a seam. Describes *role* (what slot it fills), not substance (what's inside).
+
+**Leverage**
+What callers get from depth. More capability per unit of interface they have to learn. One implementation pays back across N call sites and M tests.
+
+**Locality**
+What maintainers get from depth. Change, bugs, knowledge, and verification concentrate at one place rather than spreading across callers. Fix once, fixed everywhere.
+
+## Principles
+
+- **Depth is a property of the interface, not the implementation.** A deep module can be internally composed of small, mockable, swappable parts — they just aren't part of the interface. A module can have **internal seams** (private to its implementation, used by its own tests) as well as the **external seam** at its interface.
+- **The deletion test.** Imagine deleting the module. If complexity vanishes, the module wasn't hiding anything (it was a pass-through). If complexity reappears across N callers, the module was earning its keep.
+- **The interface is the test surface.** Callers and tests cross the same seam. If you want to test *past* the interface, the module is probably the wrong shape.
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a seam unless something actually varies across it.
+
+## Relationships
+
+- A **Module** has exactly one **Interface** (the surface it presents to callers and tests).
+- **Depth** is a property of a **Module**, measured against its **Interface**.
+- A **Seam** is where a **Module**'s **Interface** lives.
+- An **Adapter** sits at a **Seam** and satisfies the **Interface**.
+- **Depth** produces **Leverage** for callers and **Locality** for maintainers.
+
+## Rejected framings
+
+- **Depth as ratio of implementation-lines to interface-lines** (Ousterhout): rewards padding the implementation. We use depth-as-leverage instead.
+- **"Interface" as the TypeScript `interface` keyword or a class's public methods**: too narrow — interface here includes every fact a caller must know.
+- **"Boundary"**: overloaded with DDD's bounded context. Say **seam** or **interface**.
diff --git a/.claude/skills/improve-codebase-architecture/SKILL.md b/.claude/skills/improve-codebase-architecture/SKILL.md
new file mode 100644
index 0000000..05984a6
--- /dev/null
+++ b/.claude/skills/improve-codebase-architecture/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: improve-codebase-architecture
+description: Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
+---
+
+# Improve Codebase Architecture
+
+Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
+
+## Glossary
+
+Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).
+
+- **Module** — anything with an interface and an implementation (function, class, package, slice).
+- **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
+- **Implementation** — the code inside.
+- **Depth** — leverage at the interface: a lot of behaviour behind a small interface. **Deep** = high leverage. **Shallow** = interface nearly as complex as the implementation.
+- **Seam** — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.")
+- **Adapter** — a concrete thing satisfying an interface at a seam.
+- **Leverage** — what callers get from depth.
+- **Locality** — what maintainers get from depth: change, bugs, knowledge concentrated in one place.
+
+Key principles (see [LANGUAGE.md](LANGUAGE.md) for the full list):
+
+- **Deletion test**: imagine deleting the module. If complexity vanishes, it was a pass-through. If complexity reappears across N callers, it was earning its keep.
+- **The interface is the test surface.**
+- **One adapter = hypothetical seam. Two adapters = real seam.**
+
+This skill is _informed_ by the project's domain model. The domain language gives names to good seams; ADRs record decisions the skill should not re-litigate.
+
+## Process
+
+### 1. Explore
+
+Read the project's domain glossary and any ADRs in the area you're touching first.
+
+Then use the Agent tool with `subagent_type=Explore` to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction:
+
+- Where does understanding one concept require bouncing between many small modules?
+- Where are modules **shallow** — interface nearly as complex as the implementation?
+- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no **locality**)?
+- Where do tightly-coupled modules leak across their seams?
+- Which parts of the codebase are untested, or hard to test through their current interface?
+
+Apply the **deletion test** to anything you suspect is shallow: would deleting it concentrate complexity, or just move it? A "yes, concentrates" is the signal you want.
+
+### 2. Present candidates
+
+Present a numbered list of deepening opportunities. For each candidate:
+
+- **Files** — which files/modules are involved
+- **Problem** — why the current architecture is causing friction
+- **Solution** — plain English description of what would change
+- **Benefits** — explained in terms of locality and leverage, and also in how tests would improve
+
+**Use CONTEXT.md vocabulary for the domain, and [LANGUAGE.md](LANGUAGE.md) vocabulary for the architecture.** If `CONTEXT.md` defines "Order," talk about "the Order intake module" — not "the FooBarHandler," and not "the Order service."
+
+**ADR conflicts**: if a candidate contradicts an existing ADR, only surface it when the friction is real enough to warrant revisiting the ADR. Mark it clearly (e.g. _"contradicts ADR-0007 — but worth reopening because…"_). Don't list every theoretical refactor an ADR forbids.
+
+Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
+
+### 3. Grilling loop
+
+Once the user picks a candidate, drop into a grilling conversation. Walk the design tree with them — constraints, dependencies, the shape of the deepened module, what sits behind the seam, what tests survive.
+
+Side effects happen inline as decisions crystallize:
+
+- **Naming a deepened module after a concept not in `CONTEXT.md`?** Add the term to `CONTEXT.md` — same discipline as `/grill-with-docs` (see [CONTEXT-FORMAT.md](../grill-with-docs/CONTEXT-FORMAT.md)). Create the file lazily if it doesn't exist.
+- **Sharpening a fuzzy term during the conversation?** Update `CONTEXT.md` right there.
+- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer to avoid re-suggesting the same thing — skip ephemeral reasons ("not worth it right now") and self-evident ones. See [ADR-FORMAT.md](../grill-with-docs/ADR-FORMAT.md).
+- **Want to explore alternative interfaces for the deepened module?** See [INTERFACE-DESIGN.md](INTERFACE-DESIGN.md).
diff --git a/.claude/skills/mobile-android-design/SKILL.md b/.claude/skills/mobile-android-design/SKILL.md
new file mode 100644
index 0000000..316f16b
--- /dev/null
+++ b/.claude/skills/mobile-android-design/SKILL.md
@@ -0,0 +1,440 @@
+---
+name: mobile-android-design
+description: Master Material Design 3 and Jetpack Compose patterns for building native Android apps. Use when designing Android interfaces, implementing Compose UI, or following Google's Material Design guidelines.
+---
+
+# Android Mobile Design
+
+Master Material Design 3 (Material You) and Jetpack Compose to build modern, adaptive Android applications that integrate seamlessly with the Android ecosystem.
+
+## When to Use This Skill
+
+- Designing Android app interfaces following Material Design 3
+- Building Jetpack Compose UI and layouts
+- Implementing Android navigation patterns (Navigation Compose)
+- Creating adaptive layouts for phones, tablets, and foldables
+- Using Material 3 theming with dynamic colors
+- Building accessible Android interfaces
+- Implementing Android-specific gestures and interactions
+- Designing for different screen configurations
+
+## Core Concepts
+
+### 1. Material Design 3 Principles
+
+**Personalization**: Dynamic color adapts UI to user's wallpaper
+**Accessibility**: Tonal palettes ensure sufficient color contrast
+**Large Screens**: Responsive layouts for tablets and foldables
+
+**Material Components:**
+
+- Cards, Buttons, FABs, Chips
+- Navigation (rail, drawer, bottom nav)
+- Text fields, Dialogs, Sheets
+- Lists, Menus, Progress indicators
+
+### 2. Jetpack Compose Layout System
+
+**Column and Row:**
+
+```kotlin
+// Vertical arrangement with alignment
+Column(
+    modifier = Modifier.padding(16.dp),
+    verticalArrangement = Arrangement.spacedBy(12.dp),
+    horizontalAlignment = Alignment.Start
+) {
+    Text(
+        text = "Title",
+        style = MaterialTheme.typography.headlineSmall
+    )
+    Text(
+        text = "Subtitle",
+        style = MaterialTheme.typography.bodyMedium,
+        color = MaterialTheme.colorScheme.onSurfaceVariant
+    )
+}
+
+// Horizontal arrangement with weight
+Row(
+    modifier = Modifier.fillMaxWidth(),
+    horizontalArrangement = Arrangement.SpaceBetween,
+    verticalAlignment = Alignment.CenterVertically
+) {
+    Icon(Icons.Default.Star, contentDescription = null)
+    Text("Featured")
+    Spacer(modifier = Modifier.weight(1f))
+    TextButton(onClick = {}) {
+        Text("View All")
+    }
+}
+```
+
+**Lazy Lists and Grids:**
+
+```kotlin
+// Lazy column with sticky headers
+LazyColumn {
+    items.groupBy { it.category }.forEach { (category, categoryItems) ->
+        stickyHeader {
+            Text(
+                text = category,
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .background(MaterialTheme.colorScheme.surface)
+                    .padding(16.dp),
+                style = MaterialTheme.typography.titleMedium
+            )
+        }
+        items(categoryItems) { item ->
+            ItemRow(item = item)
+        }
+    }
+}
+
+// Adaptive grid
+LazyVerticalGrid(
+    columns = GridCells.Adaptive(minSize = 150.dp),
+    contentPadding = PaddingValues(16.dp),
+    horizontalArrangement = Arrangement.spacedBy(12.dp),
+    verticalArrangement = Arrangement.spacedBy(12.dp)
+) {
+    items(items) { item ->
+        ItemCard(item = item)
+    }
+}
+```
+
+### 3. Navigation Patterns
+
+**Bottom Navigation:**
+
+```kotlin
+@Composable
+fun MainScreen() {
+    val navController = rememberNavController()
+
+    Scaffold(
+        bottomBar = {
+            NavigationBar {
+                val navBackStackEntry by navController.currentBackStackEntryAsState()
+                val currentDestination = navBackStackEntry?.destination
+
+                NavigationDestination.entries.forEach { destination ->
+                    NavigationBarItem(
+                        icon = { Icon(destination.icon, contentDescription = null) },
+                        label = { Text(destination.label) },
+                        selected = currentDestination?.hierarchy?.any {
+                            it.route == destination.route
+                        } == true,
+                        onClick = {
+                            navController.navigate(destination.route) {
+                                popUpTo(navController.graph.findStartDestination().id) {
+                                    saveState = true
+                                }
+                                launchSingleTop = true
+                                restoreState = true
+                            }
+                        }
+                    )
+                }
+            }
+        }
+    ) { innerPadding ->
+        NavHost(
+            navController = navController,
+            startDestination = NavigationDestination.Home.route,
+            modifier = Modifier.padding(innerPadding)
+        ) {
+            composable(NavigationDestination.Home.route) { HomeScreen() }
+            composable(NavigationDestination.Search.route) { SearchScreen() }
+            composable(NavigationDestination.Profile.route) { ProfileScreen() }
+        }
+    }
+}
+```
+
+**Navigation Drawer:**
+
+```kotlin
+@Composable
+fun DrawerNavigation() {
+    val drawerState = rememberDrawerState(DrawerValue.Closed)
+    val scope = rememberCoroutineScope()
+
+    ModalNavigationDrawer(
+        drawerState = drawerState,
+        drawerContent = {
+            ModalDrawerSheet {
+                Spacer(Modifier.height(12.dp))
+                Text(
+                    "App Name",
+                    modifier = Modifier.padding(16.dp),
+                    style = MaterialTheme.typography.titleLarge
+                )
+                HorizontalDivider()
+
+                NavigationDrawerItem(
+                    icon = { Icon(Icons.Default.Home, null) },
+                    label = { Text("Home") },
+                    selected = true,
+                    onClick = { scope.launch { drawerState.close() } }
+                )
+                NavigationDrawerItem(
+                    icon = { Icon(Icons.Default.Settings, null) },
+                    label = { Text("Settings") },
+                    selected = false,
+                    onClick = { }
+                )
+            }
+        }
+    ) {
+        Scaffold(
+            topBar = {
+                TopAppBar(
+                    title = { Text("Home") },
+                    navigationIcon = {
+                        IconButton(onClick = { scope.launch { drawerState.open() } }) {
+                            Icon(Icons.Default.Menu, contentDescription = "Menu")
+                        }
+                    }
+                )
+            }
+        ) { innerPadding ->
+            Content(modifier = Modifier.padding(innerPadding))
+        }
+    }
+}
+```
+
+### 4. Material 3 Theming
+
+**Color Scheme:**
+
+```kotlin
+// Dynamic color (Android 12+)
+val dynamicColorScheme = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+    val context = LocalContext.current
+    if (darkTheme) dynamicDarkColorScheme(context)
+    else dynamicLightColorScheme(context)
+} else {
+    if (darkTheme) DarkColorScheme else LightColorScheme
+}
+
+// Custom color scheme
+private val LightColorScheme = lightColorScheme(
+    primary = Color(0xFF6750A4),
+    onPrimary = Color.White,
+    primaryContainer = Color(0xFFEADDFF),
+    onPrimaryContainer = Color(0xFF21005D),
+    secondary = Color(0xFF625B71),
+    onSecondary = Color.White,
+    tertiary = Color(0xFF7D5260),
+    onTertiary = Color.White,
+    surface = Color(0xFFFFFBFE),
+    onSurface = Color(0xFF1C1B1F),
+)
+```
+
+**Typography:**
+
+```kotlin
+val AppTypography = Typography(
+    displayLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 57.sp,
+        lineHeight = 64.sp
+    ),
+    headlineMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 28.sp,
+        lineHeight = 36.sp
+    ),
+    titleLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 22.sp,
+        lineHeight = 28.sp
+    ),
+    bodyLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 16.sp,
+        lineHeight = 24.sp
+    ),
+    labelMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 12.sp,
+        lineHeight = 16.sp
+    )
+)
+```
+
+### 5. Component Examples
+
+**Cards:**
+
+```kotlin
+@Composable
+fun FeatureCard(
+    title: String,
+    description: String,
+    imageUrl: String,
+    onClick: () -> Unit
+) {
+    Card(
+        onClick = onClick,
+        modifier = Modifier.fillMaxWidth(),
+        shape = RoundedCornerShape(16.dp),
+        colors = CardDefaults.cardColors(
+            containerColor = MaterialTheme.colorScheme.surfaceVariant
+        )
+    ) {
+        Column {
+            AsyncImage(
+                model = imageUrl,
+                contentDescription = null,
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .height(180.dp),
+                contentScale = ContentScale.Crop
+            )
+            Column(modifier = Modifier.padding(16.dp)) {
+                Text(
+                    text = title,
+                    style = MaterialTheme.typography.titleMedium
+                )
+                Spacer(modifier = Modifier.height(8.dp))
+                Text(
+                    text = description,
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant
+                )
+            }
+        }
+    }
+}
+```
+
+**Buttons:**
+
+```kotlin
+// Filled button (primary action)
+Button(onClick = { }) {
+    Text("Continue")
+}
+
+// Filled tonal button (secondary action)
+FilledTonalButton(onClick = { }) {
+    Icon(Icons.Default.Add, null)
+    Spacer(Modifier.width(8.dp))
+    Text("Add Item")
+}
+
+// Outlined button
+OutlinedButton(onClick = { }) {
+    Text("Cancel")
+}
+
+// Text button
+TextButton(onClick = { }) {
+    Text("Learn More")
+}
+
+// FAB
+FloatingActionButton(
+    onClick = { },
+    containerColor = MaterialTheme.colorScheme.primaryContainer,
+    contentColor = MaterialTheme.colorScheme.onPrimaryContainer
+) {
+    Icon(Icons.Default.Add, contentDescription = "Add")
+}
+```
+
+## Quick Start Component
+
+```kotlin
+@Composable
+fun ItemListCard(
+    item: Item,
+    onItemClick: () -> Unit,
+    modifier: Modifier = Modifier
+) {
+    Card(
+        onClick = onItemClick,
+        modifier = modifier.fillMaxWidth(),
+        shape = RoundedCornerShape(12.dp)
+    ) {
+        Row(
+            modifier = Modifier
+                .padding(16.dp)
+                .fillMaxWidth(),
+            verticalAlignment = Alignment.CenterVertically
+        ) {
+            Box(
+                modifier = Modifier
+                    .size(48.dp)
+                    .clip(CircleShape)
+                    .background(MaterialTheme.colorScheme.primaryContainer),
+                contentAlignment = Alignment.Center
+            ) {
+                Icon(
+                    imageVector = Icons.Default.Star,
+                    contentDescription = null,
+                    tint = MaterialTheme.colorScheme.onPrimaryContainer
+                )
+            }
+
+            Spacer(modifier = Modifier.width(16.dp))
+
+            Column(modifier = Modifier.weight(1f)) {
+                Text(
+                    text = item.title,
+                    style = MaterialTheme.typography.titleMedium
+                )
+                Text(
+                    text = item.subtitle,
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant
+                )
+            }
+
+            Icon(
+                imageVector = Icons.Default.ChevronRight,
+                contentDescription = null,
+                tint = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+        }
+    }
+}
+```
+
+## Best Practices
+
+1. **Use Material Theme**: Access colors via `MaterialTheme.colorScheme` for automatic dark mode support
+2. **Support Dynamic Color**: Enable dynamic color on Android 12+ for personalization
+3. **Adaptive Layouts**: Use `WindowSizeClass` for responsive designs
+4. **Content Descriptions**: Add `contentDescription` to all interactive elements
+5. **Touch Targets**: Minimum 48dp touch targets for accessibility
+6. **State Hoisting**: Hoist state to make components reusable and testable
+7. **Remember Properly**: Use `remember` and `rememberSaveable` appropriately
+8. **Preview Annotations**: Add `@Preview` with different configurations
+
+## Common Issues
+
+- **Recomposition Issues**: Avoid passing unstable lambdas; use `remember`
+- **State Loss**: Use `rememberSaveable` for configuration changes
+- **Performance**: Use `LazyColumn` instead of `Column` for long lists
+- **Theme Leaks**: Ensure `MaterialTheme` wraps all composables
+- **Navigation Crashes**: Handle back press and deep links properly
+- **Memory Leaks**: Cancel coroutines in `DisposableEffect`
+
+## Resources
+
+- [Material Design 3](https://m3.material.io/)
+- [Jetpack Compose Documentation](https://developer.android.com/jetpack/compose)
+- [Compose Samples](https://github.com/android/compose-samples)
+- [Material 3 Compose](https://developer.android.com/jetpack/compose/designsystems/material3)
diff --git a/.claude/skills/mobile-android-design/references/android-navigation.md b/.claude/skills/mobile-android-design/references/android-navigation.md
new file mode 100644
index 0000000..2d77dec
--- /dev/null
+++ b/.claude/skills/mobile-android-design/references/android-navigation.md
@@ -0,0 +1,698 @@
+# Android Navigation Patterns
+
+## Navigation Compose Basics
+
+### Setup and Dependencies
+
+```kotlin
+// build.gradle.kts
+dependencies {
+    implementation("androidx.navigation:navigation-compose:2.7.7")
+    // For type-safe navigation (recommended)
+    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3")
+}
+```
+
+### Basic Navigation
+
+```kotlin
+@Serializable
+object Home
+
+@Serializable
+data class Detail(val itemId: String)
+
+@Serializable
+object Settings
+
+@Composable
+fun AppNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(
+        navController = navController,
+        startDestination = Home
+    ) {
+        composable<Home> {
+            HomeScreen(
+                onItemClick = { itemId ->
+                    navController.navigate(Detail(itemId))
+                },
+                onSettingsClick = {
+                    navController.navigate(Settings)
+                }
+            )
+        }
+
+        composable<Detail> { backStackEntry ->
+            val detail: Detail = backStackEntry.toRoute()
+            DetailScreen(
+                itemId = detail.itemId,
+                onBack = { navController.popBackStack() }
+            )
+        }
+
+        composable<Settings> {
+            SettingsScreen(
+                onBack = { navController.popBackStack() }
+            )
+        }
+    }
+}
+```
+
+### Navigation with Arguments
+
+```kotlin
+// Type-safe routes with arguments
+@Serializable
+data class ProductDetail(
+    val productId: String,
+    val category: String,
+    val fromSearch: Boolean = false
+)
+
+@Serializable
+data class UserProfile(
+    val userId: Long
+)
+
+@Composable
+fun NavigationWithArgs() {
+    val navController = rememberNavController()
+
+    NavHost(navController = navController, startDestination = Home) {
+        composable<Home> {
+            HomeScreen(
+                onProductClick = { productId, category ->
+                    navController.navigate(
+                        ProductDetail(
+                            productId = productId,
+                            category = category,
+                            fromSearch = false
+                        )
+                    )
+                }
+            )
+        }
+
+        composable<ProductDetail> { backStackEntry ->
+            val args: ProductDetail = backStackEntry.toRoute()
+            ProductDetailScreen(
+                productId = args.productId,
+                category = args.category,
+                showBackToSearch = args.fromSearch
+            )
+        }
+
+        composable<UserProfile> { backStackEntry ->
+            val args: UserProfile = backStackEntry.toRoute()
+            UserProfileScreen(userId = args.userId)
+        }
+    }
+}
+```
+
+## Bottom Navigation
+
+### Standard Implementation
+
+```kotlin
+enum class BottomNavDestination(
+    val route: Any,
+    val icon: ImageVector,
+    val label: String
+) {
+    HOME(Home, Icons.Default.Home, "Home"),
+    SEARCH(Search, Icons.Default.Search, "Search"),
+    FAVORITES(Favorites, Icons.Default.Favorite, "Favorites"),
+    PROFILE(Profile, Icons.Default.Person, "Profile")
+}
+
+@Composable
+fun MainScreenWithBottomNav() {
+    val navController = rememberNavController()
+    val navBackStackEntry by navController.currentBackStackEntryAsState()
+    val currentDestination = navBackStackEntry?.destination
+
+    Scaffold(
+        bottomBar = {
+            NavigationBar {
+                BottomNavDestination.entries.forEach { destination ->
+                    NavigationBarItem(
+                        icon = {
+                            Icon(destination.icon, contentDescription = destination.label)
+                        },
+                        label = { Text(destination.label) },
+                        selected = currentDestination?.hasRoute(destination.route::class) == true,
+                        onClick = {
+                            navController.navigate(destination.route) {
+                                // Pop up to start destination to avoid building up stack
+                                popUpTo(navController.graph.findStartDestination().id) {
+                                    saveState = true
+                                }
+                                // Avoid multiple copies of same destination
+                                launchSingleTop = true
+                                // Restore state when reselecting
+                                restoreState = true
+                            }
+                        }
+                    )
+                }
+            }
+        }
+    ) { innerPadding ->
+        NavHost(
+            navController = navController,
+            startDestination = Home,
+            modifier = Modifier.padding(innerPadding)
+        ) {
+            composable<Home> { HomeScreen() }
+            composable<Search> { SearchScreen() }
+            composable<Favorites> { FavoritesScreen() }
+            composable<Profile> { ProfileScreen() }
+        }
+    }
+}
+```
+
+### Bottom Nav with Badges
+
+```kotlin
+@Composable
+fun BottomNavWithBadges(
+    cartCount: Int,
+    notificationCount: Int
+) {
+    NavigationBar {
+        NavigationBarItem(
+            icon = { Icon(Icons.Default.Home, null) },
+            label = { Text("Home") },
+            selected = true,
+            onClick = { }
+        )
+
+        NavigationBarItem(
+            icon = {
+                BadgedBox(
+                    badge = {
+                        if (cartCount > 0) {
+                            Badge { Text("$cartCount") }
+                        }
+                    }
+                ) {
+                    Icon(Icons.Default.ShoppingCart, null)
+                }
+            },
+            label = { Text("Cart") },
+            selected = false,
+            onClick = { }
+        )
+
+        NavigationBarItem(
+            icon = {
+                BadgedBox(
+                    badge = {
+                        if (notificationCount > 0) {
+                            Badge {
+                                Text(
+                                    if (notificationCount > 99) "99+"
+                                    else "$notificationCount"
+                                )
+                            }
+                        }
+                    }
+                ) {
+                    Icon(Icons.Default.Notifications, null)
+                }
+            },
+            label = { Text("Alerts") },
+            selected = false,
+            onClick = { }
+        )
+    }
+}
+```
+
+## Navigation Drawer
+
+### Modal Navigation Drawer
+
+```kotlin
+@Composable
+fun ModalDrawerNavigation() {
+    val drawerState = rememberDrawerState(initialValue = DrawerValue.Closed)
+    val scope = rememberCoroutineScope()
+    var selectedItem by remember { mutableStateOf(0) }
+
+    val items = listOf(
+        DrawerItem(Icons.Default.Home, "Home"),
+        DrawerItem(Icons.Default.Settings, "Settings"),
+        DrawerItem(Icons.Default.Info, "About"),
+        DrawerItem(Icons.Default.Help, "Help")
+    )
+
+    ModalNavigationDrawer(
+        drawerState = drawerState,
+        drawerContent = {
+            ModalDrawerSheet {
+                // Header
+                Box(
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .height(180.dp)
+                        .background(MaterialTheme.colorScheme.primaryContainer),
+                    contentAlignment = Alignment.BottomStart
+                ) {
+                    Column(modifier = Modifier.padding(16.dp)) {
+                        AsyncImage(
+                            model = "avatar_url",
+                            contentDescription = "Profile",
+                            modifier = Modifier
+                                .size(64.dp)
+                                .clip(CircleShape)
+                        )
+                        Spacer(Modifier.height(8.dp))
+                        Text(
+                            "John Doe",
+                            style = MaterialTheme.typography.titleMedium
+                        )
+                        Text(
+                            "john@example.com",
+                            style = MaterialTheme.typography.bodySmall
+                        )
+                    }
+                }
+
+                Spacer(Modifier.height(12.dp))
+
+                // Navigation items
+                items.forEachIndexed { index, item ->
+                    NavigationDrawerItem(
+                        icon = { Icon(item.icon, contentDescription = null) },
+                        label = { Text(item.label) },
+                        selected = index == selectedItem,
+                        onClick = {
+                            selectedItem = index
+                            scope.launch { drawerState.close() }
+                        },
+                        modifier = Modifier.padding(NavigationDrawerItemDefaults.ItemPadding)
+                    )
+                }
+
+                Spacer(Modifier.weight(1f))
+
+                // Footer
+                HorizontalDivider()
+                NavigationDrawerItem(
+                    icon = { Icon(Icons.Default.Logout, null) },
+                    label = { Text("Sign Out") },
+                    selected = false,
+                    onClick = { },
+                    modifier = Modifier.padding(NavigationDrawerItemDefaults.ItemPadding)
+                )
+                Spacer(Modifier.height(12.dp))
+            }
+        }
+    ) {
+        Scaffold(
+            topBar = {
+                TopAppBar(
+                    title = { Text(items[selectedItem].label) },
+                    navigationIcon = {
+                        IconButton(onClick = { scope.launch { drawerState.open() } }) {
+                            Icon(Icons.Default.Menu, "Open drawer")
+                        }
+                    }
+                )
+            }
+        ) { padding ->
+            Content(modifier = Modifier.padding(padding))
+        }
+    }
+}
+
+data class DrawerItem(val icon: ImageVector, val label: String)
+```
+
+### Permanent Navigation Drawer (Tablets)
+
+```kotlin
+@Composable
+fun PermanentDrawerLayout() {
+    PermanentNavigationDrawer(
+        drawerContent = {
+            PermanentDrawerSheet(
+                modifier = Modifier.width(240.dp)
+            ) {
+                Spacer(Modifier.height(12.dp))
+                Text(
+                    "App Name",
+                    modifier = Modifier.padding(16.dp),
+                    style = MaterialTheme.typography.titleLarge
+                )
+                HorizontalDivider()
+
+                drawerItems.forEach { item ->
+                    NavigationDrawerItem(
+                        icon = { Icon(item.icon, null) },
+                        label = { Text(item.label) },
+                        selected = item == selectedItem,
+                        onClick = { selectedItem = item },
+                        modifier = Modifier.padding(horizontal = 12.dp)
+                    )
+                }
+            }
+        }
+    ) {
+        // Main content takes remaining space
+        MainContent()
+    }
+}
+```
+
+## Navigation Rail
+
+```kotlin
+@Composable
+fun NavigationRailLayout() {
+    var selectedItem by remember { mutableStateOf(0) }
+
+    Row(modifier = Modifier.fillMaxSize()) {
+        NavigationRail(
+            header = {
+                FloatingActionButton(
+                    onClick = { },
+                    elevation = FloatingActionButtonDefaults.bottomAppBarFabElevation()
+                ) {
+                    Icon(Icons.Default.Add, "Create")
+                }
+            }
+        ) {
+            Spacer(Modifier.weight(1f))
+
+            railItems.forEachIndexed { index, item ->
+                NavigationRailItem(
+                    icon = { Icon(item.icon, null) },
+                    label = { Text(item.label) },
+                    selected = selectedItem == index,
+                    onClick = { selectedItem = index }
+                )
+            }
+
+            Spacer(Modifier.weight(1f))
+        }
+
+        // Main content
+        Box(
+            modifier = Modifier
+                .weight(1f)
+                .fillMaxHeight()
+        ) {
+            when (selectedItem) {
+                0 -> HomeContent()
+                1 -> SearchContent()
+                2 -> ProfileContent()
+            }
+        }
+    }
+}
+```
+
+## Deep Linking
+
+### Basic Deep Link Setup
+
+```kotlin
+// In AndroidManifest.xml
+// <intent-filter>
+//     <action android:name="android.intent.action.VIEW" />
+//     <category android:name="android.intent.category.DEFAULT" />
+//     <category android:name="android.intent.category.BROWSABLE" />
+//     <data android:scheme="myapp" />
+//     <data android:scheme="https" android:host="myapp.com" />
+// </intent-filter>
+
+@Composable
+fun DeepLinkNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(
+        navController = navController,
+        startDestination = Home
+    ) {
+        composable<Home> {
+            HomeScreen()
+        }
+
+        composable<ProductDetail>(
+            deepLinks = listOf(
+                navDeepLink<ProductDetail>(
+                    basePath = "https://myapp.com/product"
+                ),
+                navDeepLink<ProductDetail>(
+                    basePath = "myapp://product"
+                )
+            )
+        ) { backStackEntry ->
+            val args: ProductDetail = backStackEntry.toRoute()
+            ProductDetailScreen(productId = args.productId)
+        }
+
+        composable<UserProfile>(
+            deepLinks = listOf(
+                navDeepLink<UserProfile>(
+                    basePath = "https://myapp.com/user"
+                )
+            )
+        ) { backStackEntry ->
+            val args: UserProfile = backStackEntry.toRoute()
+            UserProfileScreen(userId = args.userId)
+        }
+    }
+}
+```
+
+### Handling Intent in Activity
+
+```kotlin
+class MainActivity : ComponentActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        setContent {
+            AppTheme {
+                val navController = rememberNavController()
+
+                // Handle deep link from intent
+                LaunchedEffect(Unit) {
+                    intent?.data?.let { uri ->
+                        navController.handleDeepLink(intent)
+                    }
+                }
+
+                AppNavigation(navController = navController)
+            }
+        }
+    }
+
+    override fun onNewIntent(intent: Intent) {
+        super.onNewIntent(intent)
+        // Handle new intents when activity is already running
+        setIntent(intent)
+    }
+}
+```
+
+## Nested Navigation
+
+```kotlin
+@Composable
+fun NestedNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(navController = navController, startDestination = MainGraph) {
+        // Main graph with bottom navigation
+        navigation<MainGraph>(startDestination = Home) {
+            composable<Home> {
+                HomeScreen(
+                    onItemClick = { navController.navigate(Detail(it)) }
+                )
+            }
+            composable<Search> { SearchScreen() }
+            composable<Profile> {
+                ProfileScreen(
+                    onSettingsClick = { navController.navigate(SettingsGraph) }
+                )
+            }
+        }
+
+        // Nested detail graph
+        composable<Detail> { backStackEntry ->
+            val args: Detail = backStackEntry.toRoute()
+            DetailScreen(itemId = args.itemId)
+        }
+
+        // Separate settings graph (full screen, no bottom nav)
+        navigation<SettingsGraph>(startDestination = SettingsMain) {
+            composable<SettingsMain> {
+                SettingsScreen(
+                    onAccountClick = { navController.navigate(AccountSettings) },
+                    onNotificationsClick = { navController.navigate(NotificationSettings) }
+                )
+            }
+            composable<AccountSettings> { AccountSettingsScreen() }
+            composable<NotificationSettings> { NotificationSettingsScreen() }
+        }
+    }
+}
+
+@Serializable object MainGraph
+@Serializable object SettingsGraph
+@Serializable object SettingsMain
+@Serializable object AccountSettings
+@Serializable object NotificationSettings
+```
+
+## Navigation State Management
+
+### ViewModel Integration
+
+```kotlin
+@HiltViewModel
+class NavigationViewModel @Inject constructor(
+    private val savedStateHandle: SavedStateHandle
+) : ViewModel() {
+
+    private val _navigationEvents = MutableSharedFlow<NavigationEvent>()
+    val navigationEvents = _navigationEvents.asSharedFlow()
+
+    fun navigateToDetail(itemId: String) {
+        viewModelScope.launch {
+            _navigationEvents.emit(NavigationEvent.NavigateToDetail(itemId))
+        }
+    }
+
+    fun navigateBack() {
+        viewModelScope.launch {
+            _navigationEvents.emit(NavigationEvent.NavigateBack)
+        }
+    }
+}
+
+sealed class NavigationEvent {
+    data class NavigateToDetail(val itemId: String) : NavigationEvent()
+    object NavigateBack : NavigationEvent()
+}
+
+@Composable
+fun NavigationHandler(
+    navController: NavHostController,
+    viewModel: NavigationViewModel = hiltViewModel()
+) {
+    LaunchedEffect(Unit) {
+        viewModel.navigationEvents.collect { event ->
+            when (event) {
+                is NavigationEvent.NavigateToDetail -> {
+                    navController.navigate(Detail(event.itemId))
+                }
+                NavigationEvent.NavigateBack -> {
+                    navController.popBackStack()
+                }
+            }
+        }
+    }
+}
+```
+
+### Back Handler
+
+```kotlin
+@Composable
+fun ScreenWithBackHandler(
+    onBack: () -> Unit
+) {
+    var showExitDialog by remember { mutableStateOf(false) }
+
+    // Intercept back press
+    BackHandler {
+        showExitDialog = true
+    }
+
+    if (showExitDialog) {
+        AlertDialog(
+            onDismissRequest = { showExitDialog = false },
+            title = { Text("Exit App?") },
+            text = { Text("Are you sure you want to exit?") },
+            confirmButton = {
+                TextButton(onClick = onBack) {
+                    Text("Exit")
+                }
+            },
+            dismissButton = {
+                TextButton(onClick = { showExitDialog = false }) {
+                    Text("Cancel")
+                }
+            }
+        )
+    }
+
+    // Screen content
+    Content()
+}
+```
+
+## Navigation Animations
+
+```kotlin
+@Composable
+fun AnimatedNavigation() {
+    val navController = rememberNavController()
+
+    NavHost(
+        navController = navController,
+        startDestination = Home,
+        enterTransition = {
+            slideIntoContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Left,
+                animationSpec = tween(300)
+            )
+        },
+        exitTransition = {
+            slideOutOfContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Left,
+                animationSpec = tween(300)
+            )
+        },
+        popEnterTransition = {
+            slideIntoContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Right,
+                animationSpec = tween(300)
+            )
+        },
+        popExitTransition = {
+            slideOutOfContainer(
+                towards = AnimatedContentTransitionScope.SlideDirection.Right,
+                animationSpec = tween(300)
+            )
+        }
+    ) {
+        composable<Home> {
+            HomeScreen()
+        }
+
+        composable<Detail>(
+            // Custom transition for specific route
+            enterTransition = {
+                fadeIn(animationSpec = tween(500)) +
+                    scaleIn(initialScale = 0.9f, animationSpec = tween(500))
+            },
+            exitTransition = {
+                fadeOut(animationSpec = tween(500))
+            }
+        ) {
+            DetailScreen()
+        }
+    }
+}
+```
diff --git a/.claude/skills/mobile-android-design/references/compose-components.md b/.claude/skills/mobile-android-design/references/compose-components.md
new file mode 100644
index 0000000..3d6ace0
--- /dev/null
+++ b/.claude/skills/mobile-android-design/references/compose-components.md
@@ -0,0 +1,796 @@
+# Jetpack Compose Component Library
+
+## Lists and Collections
+
+### Basic LazyColumn
+
+```kotlin
+@Composable
+fun ItemList(
+    items: List<Item>,
+    onItemClick: (Item) -> Unit,
+    modifier: Modifier = Modifier
+) {
+    LazyColumn(
+        modifier = modifier.fillMaxSize(),
+        contentPadding = PaddingValues(16.dp),
+        verticalArrangement = Arrangement.spacedBy(8.dp)
+    ) {
+        items(
+            items = items,
+            key = { it.id }
+        ) { item ->
+            ItemRow(
+                item = item,
+                onClick = { onItemClick(item) }
+            )
+        }
+    }
+}
+```
+
+### Pull to Refresh
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun RefreshableList(
+    items: List<Item>,
+    isRefreshing: Boolean,
+    onRefresh: () -> Unit
+) {
+    val pullToRefreshState = rememberPullToRefreshState()
+
+    PullToRefreshBox(
+        state = pullToRefreshState,
+        isRefreshing = isRefreshing,
+        onRefresh = onRefresh
+    ) {
+        LazyColumn(
+            modifier = Modifier.fillMaxSize()
+        ) {
+            items(items) { item ->
+                ItemRow(item = item)
+            }
+        }
+    }
+}
+```
+
+### Swipe to Dismiss
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun SwipeableItem(
+    item: Item,
+    onDelete: () -> Unit
+) {
+    val dismissState = rememberSwipeToDismissBoxState(
+        confirmValueChange = { value ->
+            if (value == SwipeToDismissBoxValue.EndToStart) {
+                onDelete()
+                true
+            } else {
+                false
+            }
+        }
+    )
+
+    SwipeToDismissBox(
+        state = dismissState,
+        backgroundContent = {
+            Box(
+                modifier = Modifier
+                    .fillMaxSize()
+                    .background(MaterialTheme.colorScheme.errorContainer)
+                    .padding(horizontal = 20.dp),
+                contentAlignment = Alignment.CenterEnd
+            ) {
+                Icon(
+                    Icons.Default.Delete,
+                    contentDescription = "Delete",
+                    tint = MaterialTheme.colorScheme.onErrorContainer
+                )
+            }
+        }
+    ) {
+        ItemRow(item = item)
+    }
+}
+```
+
+### Sticky Headers
+
+```kotlin
+@OptIn(ExperimentalFoundationApi::class)
+@Composable
+fun GroupedList(
+    groups: Map<String, List<Item>>
+) {
+    LazyColumn {
+        groups.forEach { (header, items) ->
+            stickyHeader {
+                Surface(
+                    modifier = Modifier.fillMaxWidth(),
+                    color = MaterialTheme.colorScheme.surfaceVariant
+                ) {
+                    Text(
+                        text = header,
+                        modifier = Modifier.padding(16.dp),
+                        style = MaterialTheme.typography.titleSmall,
+                        color = MaterialTheme.colorScheme.onSurfaceVariant
+                    )
+                }
+            }
+            items(items, key = { it.id }) { item ->
+                ItemRow(item = item)
+            }
+        }
+    }
+}
+```
+
+## Forms and Input
+
+### Text Fields
+
+```kotlin
+@Composable
+fun LoginForm(
+    onLogin: (email: String, password: String) -> Unit
+) {
+    var email by rememberSaveable { mutableStateOf("") }
+    var password by rememberSaveable { mutableStateOf("") }
+    var passwordVisible by rememberSaveable { mutableStateOf(false) }
+    var emailError by remember { mutableStateOf<String?>(null) }
+
+    Column(
+        modifier = Modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        OutlinedTextField(
+            value = email,
+            onValueChange = {
+                email = it
+                emailError = if (it.isValidEmail()) null else "Invalid email"
+            },
+            label = { Text("Email") },
+            placeholder = { Text("name@example.com") },
+            leadingIcon = { Icon(Icons.Default.Email, null) },
+            isError = emailError != null,
+            supportingText = emailError?.let { { Text(it) } },
+            keyboardOptions = KeyboardOptions(
+                keyboardType = KeyboardType.Email,
+                imeAction = ImeAction.Next
+            ),
+            singleLine = true,
+            modifier = Modifier.fillMaxWidth()
+        )
+
+        OutlinedTextField(
+            value = password,
+            onValueChange = { password = it },
+            label = { Text("Password") },
+            leadingIcon = { Icon(Icons.Default.Lock, null) },
+            trailingIcon = {
+                IconButton(onClick = { passwordVisible = !passwordVisible }) {
+                    Icon(
+                        if (passwordVisible) Icons.Default.VisibilityOff
+                        else Icons.Default.Visibility,
+                        contentDescription = "Toggle password visibility"
+                    )
+                }
+            },
+            visualTransformation = if (passwordVisible)
+                VisualTransformation.None
+            else
+                PasswordVisualTransformation(),
+            keyboardOptions = KeyboardOptions(
+                keyboardType = KeyboardType.Password,
+                imeAction = ImeAction.Done
+            ),
+            singleLine = true,
+            modifier = Modifier.fillMaxWidth()
+        )
+
+        Button(
+            onClick = { onLogin(email, password) },
+            modifier = Modifier.fillMaxWidth(),
+            enabled = email.isNotEmpty() && password.isNotEmpty() && emailError == null
+        ) {
+            Text("Sign In")
+        }
+    }
+}
+```
+
+### Search Bar
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun SearchableScreen(
+    items: List<Item>,
+    onItemClick: (Item) -> Unit
+) {
+    var query by rememberSaveable { mutableStateOf("") }
+    var expanded by rememberSaveable { mutableStateOf(false) }
+
+    val filteredItems = remember(query, items) {
+        if (query.isEmpty()) items
+        else items.filter { it.name.contains(query, ignoreCase = true) }
+    }
+
+    SearchBar(
+        query = query,
+        onQueryChange = { query = it },
+        onSearch = { expanded = false },
+        active = expanded,
+        onActiveChange = { expanded = it },
+        placeholder = { Text("Search items") },
+        leadingIcon = { Icon(Icons.Default.Search, null) },
+        trailingIcon = {
+            if (query.isNotEmpty()) {
+                IconButton(onClick = { query = "" }) {
+                    Icon(Icons.Default.Clear, "Clear search")
+                }
+            }
+        },
+        modifier = Modifier
+            .fillMaxWidth()
+            .padding(horizontal = if (expanded) 0.dp else 16.dp)
+    ) {
+        LazyColumn(
+            modifier = Modifier.fillMaxWidth(),
+            contentPadding = PaddingValues(16.dp)
+        ) {
+            items(filteredItems) { item ->
+                ListItem(
+                    headlineContent = { Text(item.name) },
+                    supportingContent = { Text(item.description) },
+                    modifier = Modifier.clickable {
+                        onItemClick(item)
+                        expanded = false
+                    }
+                )
+            }
+        }
+    }
+}
+```
+
+### Selection Controls
+
+```kotlin
+@Composable
+fun SettingsScreen() {
+    var notificationsEnabled by rememberSaveable { mutableStateOf(true) }
+    var selectedOption by rememberSaveable { mutableStateOf(0) }
+    var expandedDropdown by remember { mutableStateOf(false) }
+    var selectedLanguage by rememberSaveable { mutableStateOf("English") }
+    val languages = listOf("English", "Spanish", "French", "German")
+
+    Column {
+        // Switch
+        ListItem(
+            headlineContent = { Text("Enable Notifications") },
+            supportingContent = { Text("Receive push notifications") },
+            trailingContent = {
+                Switch(
+                    checked = notificationsEnabled,
+                    onCheckedChange = { notificationsEnabled = it }
+                )
+            }
+        )
+
+        HorizontalDivider()
+
+        // Radio buttons
+        Column {
+            Text(
+                "Theme",
+                modifier = Modifier.padding(16.dp),
+                style = MaterialTheme.typography.titleSmall
+            )
+            listOf("System", "Light", "Dark").forEachIndexed { index, option ->
+                Row(
+                    modifier = Modifier
+                        .fillMaxWidth()
+                        .selectable(
+                            selected = selectedOption == index,
+                            onClick = { selectedOption = index },
+                            role = Role.RadioButton
+                        )
+                        .padding(horizontal = 16.dp, vertical = 12.dp),
+                    verticalAlignment = Alignment.CenterVertically
+                ) {
+                    RadioButton(
+                        selected = selectedOption == index,
+                        onClick = null
+                    )
+                    Spacer(Modifier.width(16.dp))
+                    Text(option)
+                }
+            }
+        }
+
+        HorizontalDivider()
+
+        // Dropdown
+        ExposedDropdownMenuBox(
+            expanded = expandedDropdown,
+            onExpandedChange = { expandedDropdown = it },
+            modifier = Modifier.padding(16.dp)
+        ) {
+            OutlinedTextField(
+                value = selectedLanguage,
+                onValueChange = {},
+                readOnly = true,
+                label = { Text("Language") },
+                trailingIcon = { ExposedDropdownMenuDefaults.TrailingIcon(expanded = expandedDropdown) },
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .menuAnchor()
+            )
+            ExposedDropdownMenu(
+                expanded = expandedDropdown,
+                onDismissRequest = { expandedDropdown = false }
+            ) {
+                languages.forEach { language ->
+                    DropdownMenuItem(
+                        text = { Text(language) },
+                        onClick = {
+                            selectedLanguage = language
+                            expandedDropdown = false
+                        },
+                        contentPadding = ExposedDropdownMenuDefaults.ItemContentPadding
+                    )
+                }
+            }
+        }
+    }
+}
+```
+
+## Dialogs and Bottom Sheets
+
+### Alert Dialog
+
+```kotlin
+@Composable
+fun DeleteConfirmationDialog(
+    itemName: String,
+    onConfirm: () -> Unit,
+    onDismiss: () -> Unit
+) {
+    AlertDialog(
+        onDismissRequest = onDismiss,
+        icon = {
+            Icon(
+                Icons.Default.Warning,
+                contentDescription = null,
+                tint = MaterialTheme.colorScheme.error
+            )
+        },
+        title = {
+            Text("Delete Item?")
+        },
+        text = {
+            Text("Are you sure you want to delete \"$itemName\"? This action cannot be undone.")
+        },
+        confirmButton = {
+            TextButton(
+                onClick = onConfirm,
+                colors = ButtonDefaults.textButtonColors(
+                    contentColor = MaterialTheme.colorScheme.error
+                )
+            ) {
+                Text("Delete")
+            }
+        },
+        dismissButton = {
+            TextButton(onClick = onDismiss) {
+                Text("Cancel")
+            }
+        }
+    )
+}
+```
+
+### Modal Bottom Sheet
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun OptionsBottomSheet(
+    onDismiss: () -> Unit,
+    onOptionSelected: (String) -> Unit
+) {
+    val sheetState = rememberModalBottomSheetState()
+
+    ModalBottomSheet(
+        onDismissRequest = onDismiss,
+        sheetState = sheetState,
+        dragHandle = { BottomSheetDefaults.DragHandle() }
+    ) {
+        Column(
+            modifier = Modifier
+                .fillMaxWidth()
+                .padding(bottom = 32.dp)
+        ) {
+            Text(
+                "Options",
+                modifier = Modifier.padding(horizontal = 16.dp, vertical = 8.dp),
+                style = MaterialTheme.typography.titleMedium
+            )
+
+            listOf(
+                Triple(Icons.Default.Share, "Share", "share"),
+                Triple(Icons.Default.Edit, "Edit", "edit"),
+                Triple(Icons.Default.FileCopy, "Duplicate", "duplicate"),
+                Triple(Icons.Default.Delete, "Delete", "delete")
+            ).forEach { (icon, label, action) ->
+                ListItem(
+                    headlineContent = { Text(label) },
+                    leadingContent = {
+                        Icon(
+                            icon,
+                            contentDescription = null,
+                            tint = if (action == "delete")
+                                MaterialTheme.colorScheme.error
+                            else
+                                MaterialTheme.colorScheme.onSurfaceVariant
+                        )
+                    },
+                    modifier = Modifier.clickable { onOptionSelected(action) }
+                )
+            }
+        }
+    }
+}
+```
+
+### Date and Time Pickers
+
+```kotlin
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun DateTimePickerExample() {
+    var showDatePicker by remember { mutableStateOf(false) }
+    var showTimePicker by remember { mutableStateOf(false) }
+    val datePickerState = rememberDatePickerState()
+    val timePickerState = rememberTimePickerState()
+
+    Column(modifier = Modifier.padding(16.dp)) {
+        OutlinedButton(onClick = { showDatePicker = true }) {
+            Icon(Icons.Default.CalendarToday, null)
+            Spacer(Modifier.width(8.dp))
+            Text(
+                datePickerState.selectedDateMillis?.let {
+                    SimpleDateFormat("MMM dd, yyyy", Locale.getDefault())
+                        .format(Date(it))
+                } ?: "Select Date"
+            )
+        }
+
+        Spacer(Modifier.height(16.dp))
+
+        OutlinedButton(onClick = { showTimePicker = true }) {
+            Icon(Icons.Default.Schedule, null)
+            Spacer(Modifier.width(8.dp))
+            Text(
+                String.format("%02d:%02d", timePickerState.hour, timePickerState.minute)
+            )
+        }
+    }
+
+    if (showDatePicker) {
+        DatePickerDialog(
+            onDismissRequest = { showDatePicker = false },
+            confirmButton = {
+                TextButton(onClick = { showDatePicker = false }) {
+                    Text("OK")
+                }
+            },
+            dismissButton = {
+                TextButton(onClick = { showDatePicker = false }) {
+                    Text("Cancel")
+                }
+            }
+        ) {
+            DatePicker(state = datePickerState)
+        }
+    }
+
+    if (showTimePicker) {
+        AlertDialog(
+            onDismissRequest = { showTimePicker = false },
+            confirmButton = {
+                TextButton(onClick = { showTimePicker = false }) {
+                    Text("OK")
+                }
+            },
+            dismissButton = {
+                TextButton(onClick = { showTimePicker = false }) {
+                    Text("Cancel")
+                }
+            },
+            text = {
+                TimePicker(state = timePickerState)
+            }
+        )
+    }
+}
+```
+
+## Loading States
+
+### Progress Indicators
+
+```kotlin
+@Composable
+fun LoadingStates() {
+    Column(
+        modifier = Modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(24.dp)
+    ) {
+        // Indeterminate circular
+        CircularProgressIndicator()
+
+        // Determinate circular
+        CircularProgressIndicator(
+            progress = { 0.7f },
+            strokeWidth = 4.dp
+        )
+
+        // Indeterminate linear
+        LinearProgressIndicator(modifier = Modifier.fillMaxWidth())
+
+        // Determinate linear
+        LinearProgressIndicator(
+            progress = { 0.7f },
+            modifier = Modifier.fillMaxWidth()
+        )
+    }
+}
+```
+
+### Skeleton Loading
+
+```kotlin
+@Composable
+fun SkeletonLoader(
+    modifier: Modifier = Modifier
+) {
+    val infiniteTransition = rememberInfiniteTransition(label = "skeleton")
+    val alpha by infiniteTransition.animateFloat(
+        initialValue = 0.3f,
+        targetValue = 0.7f,
+        animationSpec = infiniteRepeatable(
+            animation = tween(1000, easing = LinearEasing),
+            repeatMode = RepeatMode.Reverse
+        ),
+        label = "alpha"
+    )
+
+    Column(
+        modifier = modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(12.dp)
+    ) {
+        repeat(5) {
+            Row(
+                verticalAlignment = Alignment.CenterVertically,
+                horizontalArrangement = Arrangement.spacedBy(12.dp)
+            ) {
+                Box(
+                    modifier = Modifier
+                        .size(48.dp)
+                        .clip(CircleShape)
+                        .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = alpha))
+                )
+                Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
+                    Box(
+                        modifier = Modifier
+                            .height(16.dp)
+                            .fillMaxWidth(0.7f)
+                            .clip(RoundedCornerShape(4.dp))
+                            .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = alpha))
+                    )
+                    Box(
+                        modifier = Modifier
+                            .height(12.dp)
+                            .fillMaxWidth(0.5f)
+                            .clip(RoundedCornerShape(4.dp))
+                            .background(MaterialTheme.colorScheme.surfaceVariant.copy(alpha = alpha))
+                    )
+                }
+            }
+        }
+    }
+}
+```
+
+### Content Loading Pattern
+
+```kotlin
+@Composable
+fun <T> AsyncContent(
+    state: AsyncState<T>,
+    onRetry: () -> Unit,
+    content: @Composable (T) -> Unit
+) {
+    when (state) {
+        is AsyncState.Loading -> {
+            Box(
+                modifier = Modifier.fillMaxSize(),
+                contentAlignment = Alignment.Center
+            ) {
+                CircularProgressIndicator()
+            }
+        }
+        is AsyncState.Success -> {
+            content(state.data)
+        }
+        is AsyncState.Error -> {
+            Column(
+                modifier = Modifier
+                    .fillMaxSize()
+                    .padding(32.dp),
+                horizontalAlignment = Alignment.CenterHorizontally,
+                verticalArrangement = Arrangement.Center
+            ) {
+                Icon(
+                    Icons.Default.Error,
+                    contentDescription = null,
+                    modifier = Modifier.size(64.dp),
+                    tint = MaterialTheme.colorScheme.error
+                )
+                Spacer(Modifier.height(16.dp))
+                Text(
+                    "Something went wrong",
+                    style = MaterialTheme.typography.titleMedium
+                )
+                Spacer(Modifier.height(8.dp))
+                Text(
+                    state.message,
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant,
+                    textAlign = TextAlign.Center
+                )
+                Spacer(Modifier.height(24.dp))
+                Button(onClick = onRetry) {
+                    Text("Try Again")
+                }
+            }
+        }
+    }
+}
+
+sealed class AsyncState<out T> {
+    object Loading : AsyncState<Nothing>()
+    data class Success<T>(val data: T) : AsyncState<T>()
+    data class Error(val message: String) : AsyncState<Nothing>()
+}
+```
+
+## Animations
+
+### Animated Visibility
+
+```kotlin
+@Composable
+fun ExpandableCard(
+    title: String,
+    content: String
+) {
+    var expanded by rememberSaveable { mutableStateOf(false) }
+
+    Card(
+        modifier = Modifier.fillMaxWidth()
+    ) {
+        Column(
+            modifier = Modifier
+                .clickable { expanded = !expanded }
+                .padding(16.dp)
+        ) {
+            Row(
+                modifier = Modifier.fillMaxWidth(),
+                horizontalArrangement = Arrangement.SpaceBetween,
+                verticalAlignment = Alignment.CenterVertically
+            ) {
+                Text(title, style = MaterialTheme.typography.titleMedium)
+                Icon(
+                    if (expanded) Icons.Default.ExpandLess else Icons.Default.ExpandMore,
+                    contentDescription = if (expanded) "Collapse" else "Expand"
+                )
+            }
+
+            AnimatedVisibility(
+                visible = expanded,
+                enter = expandVertically() + fadeIn(),
+                exit = shrinkVertically() + fadeOut()
+            ) {
+                Text(
+                    text = content,
+                    modifier = Modifier.padding(top = 12.dp),
+                    style = MaterialTheme.typography.bodyMedium,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant
+                )
+            }
+        }
+    }
+}
+```
+
+### Animated Content
+
+```kotlin
+@Composable
+fun AnimatedCounter(count: Int) {
+    AnimatedContent(
+        targetState = count,
+        transitionSpec = {
+            if (targetState > initialState) {
+                slideInVertically { -it } + fadeIn() togetherWith
+                    slideOutVertically { it } + fadeOut()
+            } else {
+                slideInVertically { it } + fadeIn() togetherWith
+                    slideOutVertically { -it } + fadeOut()
+            }.using(SizeTransform(clip = false))
+        },
+        label = "counter"
+    ) { targetCount ->
+        Text(
+            text = "$targetCount",
+            style = MaterialTheme.typography.displayMedium
+        )
+    }
+}
+```
+
+### Gesture-Based Animation
+
+```kotlin
+@Composable
+fun SwipeableCard(
+    onSwipeLeft: () -> Unit,
+    onSwipeRight: () -> Unit,
+    content: @Composable () -> Unit
+) {
+    var offsetX by remember { mutableFloatStateOf(0f) }
+    val animatedOffset by animateFloatAsState(
+        targetValue = offsetX,
+        animationSpec = spring(dampingRatio = Spring.DampingRatioMediumBouncy),
+        label = "offset"
+    )
+
+    Card(
+        modifier = Modifier
+            .fillMaxWidth()
+            .offset { IntOffset(animatedOffset.roundToInt(), 0) }
+            .pointerInput(Unit) {
+                detectHorizontalDragGestures(
+                    onDragEnd = {
+                        when {
+                            offsetX > 200f -> {
+                                onSwipeRight()
+                                offsetX = 0f
+                            }
+                            offsetX < -200f -> {
+                                onSwipeLeft()
+                                offsetX = 0f
+                            }
+                            else -> offsetX = 0f
+                        }
+                    },
+                    onHorizontalDrag = { _, dragAmount ->
+                        offsetX += dragAmount
+                    }
+                )
+            }
+    ) {
+        content()
+    }
+}
+```
diff --git a/.claude/skills/mobile-android-design/references/material3-theming.md b/.claude/skills/mobile-android-design/references/material3-theming.md
new file mode 100644
index 0000000..bc8b130
--- /dev/null
+++ b/.claude/skills/mobile-android-design/references/material3-theming.md
@@ -0,0 +1,604 @@
+# Material Design 3 Theming
+
+## Color System
+
+### Dynamic Color (Material You)
+
+```kotlin
+@Composable
+fun AppTheme(
+    darkTheme: Boolean = isSystemInDarkTheme(),
+    dynamicColor: Boolean = true,
+    content: @Composable () -> Unit
+) {
+    val colorScheme = when {
+        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
+            val context = LocalContext.current
+            if (darkTheme) dynamicDarkColorScheme(context)
+            else dynamicLightColorScheme(context)
+        }
+        darkTheme -> DarkColorScheme
+        else -> LightColorScheme
+    }
+
+    MaterialTheme(
+        colorScheme = colorScheme,
+        typography = AppTypography,
+        shapes = AppShapes,
+        content = content
+    )
+}
+```
+
+### Custom Color Scheme
+
+```kotlin
+// Define color palette
+val md_theme_light_primary = Color(0xFF6750A4)
+val md_theme_light_onPrimary = Color(0xFFFFFFFF)
+val md_theme_light_primaryContainer = Color(0xFFEADDFF)
+val md_theme_light_onPrimaryContainer = Color(0xFF21005D)
+val md_theme_light_secondary = Color(0xFF625B71)
+val md_theme_light_onSecondary = Color(0xFFFFFFFF)
+val md_theme_light_secondaryContainer = Color(0xFFE8DEF8)
+val md_theme_light_onSecondaryContainer = Color(0xFF1D192B)
+val md_theme_light_tertiary = Color(0xFF7D5260)
+val md_theme_light_onTertiary = Color(0xFFFFFFFF)
+val md_theme_light_tertiaryContainer = Color(0xFFFFD8E4)
+val md_theme_light_onTertiaryContainer = Color(0xFF31111D)
+val md_theme_light_error = Color(0xFFB3261E)
+val md_theme_light_onError = Color(0xFFFFFFFF)
+val md_theme_light_errorContainer = Color(0xFFF9DEDC)
+val md_theme_light_onErrorContainer = Color(0xFF410E0B)
+val md_theme_light_background = Color(0xFFFFFBFE)
+val md_theme_light_onBackground = Color(0xFF1C1B1F)
+val md_theme_light_surface = Color(0xFFFFFBFE)
+val md_theme_light_onSurface = Color(0xFF1C1B1F)
+val md_theme_light_surfaceVariant = Color(0xFFE7E0EC)
+val md_theme_light_onSurfaceVariant = Color(0xFF49454F)
+val md_theme_light_outline = Color(0xFF79747E)
+val md_theme_light_outlineVariant = Color(0xFFCAC4D0)
+
+val LightColorScheme = lightColorScheme(
+    primary = md_theme_light_primary,
+    onPrimary = md_theme_light_onPrimary,
+    primaryContainer = md_theme_light_primaryContainer,
+    onPrimaryContainer = md_theme_light_onPrimaryContainer,
+    secondary = md_theme_light_secondary,
+    onSecondary = md_theme_light_onSecondary,
+    secondaryContainer = md_theme_light_secondaryContainer,
+    onSecondaryContainer = md_theme_light_onSecondaryContainer,
+    tertiary = md_theme_light_tertiary,
+    onTertiary = md_theme_light_onTertiary,
+    tertiaryContainer = md_theme_light_tertiaryContainer,
+    onTertiaryContainer = md_theme_light_onTertiaryContainer,
+    error = md_theme_light_error,
+    onError = md_theme_light_onError,
+    errorContainer = md_theme_light_errorContainer,
+    onErrorContainer = md_theme_light_onErrorContainer,
+    background = md_theme_light_background,
+    onBackground = md_theme_light_onBackground,
+    surface = md_theme_light_surface,
+    onSurface = md_theme_light_onSurface,
+    surfaceVariant = md_theme_light_surfaceVariant,
+    onSurfaceVariant = md_theme_light_onSurfaceVariant,
+    outline = md_theme_light_outline,
+    outlineVariant = md_theme_light_outlineVariant
+)
+
+// Dark colors follow the same pattern
+val DarkColorScheme = darkColorScheme(
+    primary = md_theme_dark_primary,
+    // ... other colors
+)
+```
+
+### Color Roles Usage
+
+```kotlin
+@Composable
+fun ColorRolesExample() {
+    Column(
+        modifier = Modifier.padding(16.dp),
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        // Primary - Key actions, FABs
+        Button(onClick = { }) {
+            Text("Primary Action")
+        }
+
+        // Primary Container - Less prominent containers
+        Surface(
+            color = MaterialTheme.colorScheme.primaryContainer,
+            shape = RoundedCornerShape(12.dp)
+        ) {
+            Text(
+                "Primary Container",
+                modifier = Modifier.padding(16.dp),
+                color = MaterialTheme.colorScheme.onPrimaryContainer
+            )
+        }
+
+        // Secondary - Less prominent actions
+        FilledTonalButton(onClick = { }) {
+            Text("Secondary Action")
+        }
+
+        // Tertiary - Contrast accents
+        Badge(
+            containerColor = MaterialTheme.colorScheme.tertiaryContainer,
+            contentColor = MaterialTheme.colorScheme.onTertiaryContainer
+        ) {
+            Text("New")
+        }
+
+        // Error - Destructive actions
+        Button(
+            onClick = { },
+            colors = ButtonDefaults.buttonColors(
+                containerColor = MaterialTheme.colorScheme.error
+            )
+        ) {
+            Text("Delete")
+        }
+
+        // Surface variants
+        Surface(
+            color = MaterialTheme.colorScheme.surfaceVariant,
+            shape = RoundedCornerShape(8.dp)
+        ) {
+            Text(
+                "Surface Variant",
+                modifier = Modifier.padding(16.dp),
+                color = MaterialTheme.colorScheme.onSurfaceVariant
+            )
+        }
+    }
+}
+```
+
+### Extended Colors
+
+```kotlin
+// Custom semantic colors beyond M3 defaults
+data class ExtendedColors(
+    val success: Color,
+    val onSuccess: Color,
+    val successContainer: Color,
+    val onSuccessContainer: Color,
+    val warning: Color,
+    val onWarning: Color,
+    val warningContainer: Color,
+    val onWarningContainer: Color
+)
+
+val LocalExtendedColors = staticCompositionLocalOf {
+    ExtendedColors(
+        success = Color(0xFF4CAF50),
+        onSuccess = Color.White,
+        successContainer = Color(0xFFE8F5E9),
+        onSuccessContainer = Color(0xFF1B5E20),
+        warning = Color(0xFFFF9800),
+        onWarning = Color.White,
+        warningContainer = Color(0xFFFFF3E0),
+        onWarningContainer = Color(0xFFE65100)
+    )
+}
+
+@Composable
+fun AppTheme(
+    content: @Composable () -> Unit
+) {
+    val extendedColors = ExtendedColors(
+        // ... define colors based on light/dark theme
+    )
+
+    CompositionLocalProvider(
+        LocalExtendedColors provides extendedColors
+    ) {
+        MaterialTheme(
+            colorScheme = colorScheme,
+            content = content
+        )
+    }
+}
+
+// Usage
+@Composable
+fun SuccessBanner() {
+    val extendedColors = LocalExtendedColors.current
+
+    Surface(
+        color = extendedColors.successContainer,
+        shape = RoundedCornerShape(8.dp)
+    ) {
+        Row(
+            modifier = Modifier.padding(16.dp),
+            horizontalArrangement = Arrangement.spacedBy(12.dp)
+        ) {
+            Icon(
+                Icons.Default.CheckCircle,
+                contentDescription = null,
+                tint = extendedColors.success
+            )
+            Text(
+                "Operation successful!",
+                color = extendedColors.onSuccessContainer
+            )
+        }
+    }
+}
+```
+
+## Typography
+
+### Material 3 Type Scale
+
+```kotlin
+val AppTypography = Typography(
+    // Display styles - Hero text, large numerals
+    displayLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 57.sp,
+        lineHeight = 64.sp,
+        letterSpacing = (-0.25).sp
+    ),
+    displayMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 45.sp,
+        lineHeight = 52.sp,
+        letterSpacing = 0.sp
+    ),
+    displaySmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 36.sp,
+        lineHeight = 44.sp,
+        letterSpacing = 0.sp
+    ),
+
+    // Headline styles - High emphasis, short text
+    headlineLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 32.sp,
+        lineHeight = 40.sp,
+        letterSpacing = 0.sp
+    ),
+    headlineMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 28.sp,
+        lineHeight = 36.sp,
+        letterSpacing = 0.sp
+    ),
+    headlineSmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 24.sp,
+        lineHeight = 32.sp,
+        letterSpacing = 0.sp
+    ),
+
+    // Title styles - Medium emphasis headers
+    titleLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 22.sp,
+        lineHeight = 28.sp,
+        letterSpacing = 0.sp
+    ),
+    titleMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 16.sp,
+        lineHeight = 24.sp,
+        letterSpacing = 0.15.sp
+    ),
+    titleSmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 14.sp,
+        lineHeight = 20.sp,
+        letterSpacing = 0.1.sp
+    ),
+
+    // Body styles - Long-form text
+    bodyLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 16.sp,
+        lineHeight = 24.sp,
+        letterSpacing = 0.5.sp
+    ),
+    bodyMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 14.sp,
+        lineHeight = 20.sp,
+        letterSpacing = 0.25.sp
+    ),
+    bodySmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Normal,
+        fontSize = 12.sp,
+        lineHeight = 16.sp,
+        letterSpacing = 0.4.sp
+    ),
+
+    // Label styles - Buttons, chips, navigation
+    labelLarge = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 14.sp,
+        lineHeight = 20.sp,
+        letterSpacing = 0.1.sp
+    ),
+    labelMedium = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 12.sp,
+        lineHeight = 16.sp,
+        letterSpacing = 0.5.sp
+    ),
+    labelSmall = TextStyle(
+        fontFamily = FontFamily.Default,
+        fontWeight = FontWeight.Medium,
+        fontSize = 11.sp,
+        lineHeight = 16.sp,
+        letterSpacing = 0.5.sp
+    )
+)
+```
+
+### Custom Fonts
+
+```kotlin
+// Load custom fonts
+val Inter = FontFamily(
+    Font(R.font.inter_regular, FontWeight.Normal),
+    Font(R.font.inter_medium, FontWeight.Medium),
+    Font(R.font.inter_semibold, FontWeight.SemiBold),
+    Font(R.font.inter_bold, FontWeight.Bold)
+)
+
+val AppTypography = Typography(
+    displayLarge = TextStyle(
+        fontFamily = Inter,
+        fontWeight = FontWeight.Normal,
+        fontSize = 57.sp,
+        lineHeight = 64.sp
+    ),
+    // Apply to all styles...
+)
+
+// Variable fonts (Android 12+)
+val InterVariable = FontFamily(
+    Font(
+        R.font.inter_variable,
+        variationSettings = FontVariation.Settings(
+            FontVariation.weight(400)
+        )
+    )
+)
+```
+
+## Shape System
+
+### Material 3 Shapes
+
+```kotlin
+val AppShapes = Shapes(
+    // Extra small - Chips, small buttons
+    extraSmall = RoundedCornerShape(4.dp),
+
+    // Small - Text fields, small cards
+    small = RoundedCornerShape(8.dp),
+
+    // Medium - Cards, dialogs
+    medium = RoundedCornerShape(12.dp),
+
+    // Large - Large cards, bottom sheets
+    large = RoundedCornerShape(16.dp),
+
+    // Extra large - Full-screen dialogs
+    extraLarge = RoundedCornerShape(28.dp)
+)
+```
+
+### Custom Shape Usage
+
+```kotlin
+@Composable
+fun ShapedComponents() {
+    Column(
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        // Small shape for text field
+        OutlinedTextField(
+            value = "",
+            onValueChange = {},
+            shape = MaterialTheme.shapes.small,
+            label = { Text("Input") }
+        )
+
+        // Medium shape for cards
+        Card(
+            shape = MaterialTheme.shapes.medium
+        ) {
+            Text("Card content", modifier = Modifier.padding(16.dp))
+        }
+
+        // Large shape for prominent containers
+        Surface(
+            shape = MaterialTheme.shapes.large,
+            color = MaterialTheme.colorScheme.primaryContainer
+        ) {
+            Text("Featured", modifier = Modifier.padding(24.dp))
+        }
+
+        // Custom asymmetric shape
+        Surface(
+            shape = RoundedCornerShape(
+                topStart = 24.dp,
+                topEnd = 24.dp,
+                bottomStart = 0.dp,
+                bottomEnd = 0.dp
+            ),
+            color = MaterialTheme.colorScheme.surface
+        ) {
+            Text("Bottom sheet style", modifier = Modifier.padding(16.dp))
+        }
+    }
+}
+```
+
+## Elevation and Shadows
+
+### Tonal Elevation
+
+```kotlin
+@Composable
+fun ElevationExample() {
+    Column(
+        verticalArrangement = Arrangement.spacedBy(16.dp)
+    ) {
+        // Level 0 - No elevation
+        Surface(
+            tonalElevation = 0.dp,
+            shadowElevation = 0.dp
+        ) {
+            Text("Level 0", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 1 - Low emphasis surfaces
+        Surface(
+            tonalElevation = 1.dp,
+            shadowElevation = 1.dp
+        ) {
+            Text("Level 1", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 2 - Cards, switches
+        Surface(
+            tonalElevation = 3.dp,
+            shadowElevation = 2.dp
+        ) {
+            Text("Level 2", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 3 - Navigation components
+        Surface(
+            tonalElevation = 6.dp,
+            shadowElevation = 4.dp
+        ) {
+            Text("Level 3", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 4 - Navigation rail
+        Surface(
+            tonalElevation = 8.dp,
+            shadowElevation = 6.dp
+        ) {
+            Text("Level 4", modifier = Modifier.padding(16.dp))
+        }
+
+        // Level 5 - FAB
+        Surface(
+            tonalElevation = 12.dp,
+            shadowElevation = 8.dp
+        ) {
+            Text("Level 5", modifier = Modifier.padding(16.dp))
+        }
+    }
+}
+```
+
+## Responsive Design
+
+### Window Size Classes
+
+```kotlin
+@Composable
+fun AdaptiveLayout() {
+    val windowSizeClass = calculateWindowSizeClass(LocalContext.current as Activity)
+
+    when (windowSizeClass.widthSizeClass) {
+        WindowWidthSizeClass.Compact -> {
+            // Phone portrait - Single column, bottom nav
+            CompactLayout()
+        }
+        WindowWidthSizeClass.Medium -> {
+            // Tablet portrait, phone landscape - Navigation rail
+            MediumLayout()
+        }
+        WindowWidthSizeClass.Expanded -> {
+            // Tablet landscape, desktop - Navigation drawer, multi-pane
+            ExpandedLayout()
+        }
+    }
+}
+
+@Composable
+fun CompactLayout() {
+    Scaffold(
+        bottomBar = { NavigationBar { /* items */ } }
+    ) { padding ->
+        Content(modifier = Modifier.padding(padding))
+    }
+}
+
+@Composable
+fun MediumLayout() {
+    Row {
+        NavigationRail { /* items */ }
+        Content(modifier = Modifier.weight(1f))
+    }
+}
+
+@Composable
+fun ExpandedLayout() {
+    PermanentNavigationDrawer(
+        drawerContent = {
+            PermanentDrawerSheet { /* items */ }
+        }
+    ) {
+        Row {
+            ListPane(modifier = Modifier.weight(0.4f))
+            DetailPane(modifier = Modifier.weight(0.6f))
+        }
+    }
+}
+```
+
+### Foldable Support
+
+```kotlin
+@Composable
+fun FoldableAwareLayout() {
+    val foldingFeature = LocalFoldingFeature.current
+
+    when {
+        foldingFeature?.state == FoldingFeature.State.HALF_OPENED -> {
+            // Device is half-folded (tabletop mode)
+            TwoHingeLayout(
+                top = { CameraPreview() },
+                bottom = { CameraControls() }
+            )
+        }
+        foldingFeature?.orientation == FoldingFeature.Orientation.VERTICAL -> {
+            // Vertical fold (book mode)
+            TwoPaneLayout(
+                first = { NavigationPane() },
+                second = { ContentPane() }
+            )
+        }
+        else -> {
+            // Regular or fully opened
+            SinglePaneLayout()
+        }
+    }
+}
+```
diff --git a/.claude/skills/mobile-app-debugging/SKILL.md b/.claude/skills/mobile-app-debugging/SKILL.md
new file mode 100644
index 0000000..04e0672
--- /dev/null
+++ b/.claude/skills/mobile-app-debugging/SKILL.md
@@ -0,0 +1,254 @@
+---
+name: mobile-app-debugging
+description: Debug issues specific to mobile applications including platform-specific problems, device constraints, and connectivity issues.
+---
+
+# Mobile App Debugging
+
+## Overview
+
+Mobile app debugging addresses platform-specific issues, device hardware limitations, and mobile-specific network conditions.
+
+## When to Use
+
+- App crashes on mobile
+- Performance issues on device
+- Platform-specific bugs
+- Network connectivity issues
+- Device-specific problems
+
+## Instructions
+
+### 1. **iOS Debugging**
+
+```yaml
+Xcode Debugging:
+
+Attach Debugger:
+  - Xcode → Run on device
+  - Set breakpoints in code
+  - Step through execution
+  - View variables
+  - Console logs
+
+View Logs:
+  - Xcode → Window → Devices & Simulators
+  - Select device → View Device Logs
+  - Filter by app name
+  - Check system logs for crashes
+
+Inspect Memory:
+  - Xcode → Debug → View Memory Graph
+  - Identify retain cycles
+  - Check object count
+  - Monitor allocation growth
+
+---
+
+Common iOS Issues:
+
+App Crash (SIGABRT):
+  Cause: Exception in Objective-C
+  Solution: Check console for error message
+  Debug: Set breakpoint on exception
+
+Memory Warning (SIGKILL):
+  Cause: Too much memory usage
+  Solution: Reduce memory footprint
+  Optimize: Image caching, data structures
+
+Networking:
+  Issue: Network requests fail on device
+  Check: Network connectivity status
+  Solution: Implement Network Link Conditioner
+  Test: Throttle network in Xcode
+```
+
+### 2. **Android Debugging**
+
+```yaml
+Android Studio:
+
+Attach Debugger:
+  - Run → Debug
+  - Set breakpoints
+  - Step through code
+  - Watch variables
+  - Evaluate expressions
+
+Logcat:
+  - Displays all app logs
+  - Filter by tag
+  - Filter by process
+  - Show errors and warnings
+
+Device Monitor:
+  - Memory profiler
+  - CPU profiler
+  - Network profiler
+  - Battery usage
+
+---
+
+Common Android Issues:
+
+App Crash (ANR):
+  Cause: Long-running operation on main thread
+  Solution: Move to background thread
+  Example: Use AsyncTask or coroutines
+
+Memory Leak:
+  Cause: Activity not garbage collected
+  Solution: Clear references in onDestroy
+  Debug: Android Profiler shows retained objects
+
+Networking:
+  Issue: Network requests timeout
+  Check: Network connectivity
+  Solution: Implement timeout and retry
+  Test: Simulate poor network
+```
+
+### 3. **Cross-Platform Issues**
+
+```yaml
+React Native Debugging:
+
+Console Logs:
+  - Run app with: react-native run-android
+  - View logs: adb logcat | grep ReactNativeJS
+  - Or use remote debugger
+
+Remote Debugging:
+  - Shake device → Enable Remote Debugging
+  - Chrome DevTools debugging
+  - Set breakpoints in JS
+  - Inspect state
+
+Performance:
+  - Perf Monitor: Shake → Perf Monitor
+  - Shows FPS, RAM, Bridge traffic
+  - Identify frame drops
+  - Check excessive bridge calls
+
+---
+
+Flutter Debugging:
+
+Device Logs:
+  flutter logs
+  Shows all device and app output
+
+Debugging:
+  flutter run --debug
+  Set breakpoints in IDE
+  Step through code
+
+Hot Reload:
+  Useful for rapid iteration
+  Hot restart for full reload
+  Useful for debugging UI changes
+
+---
+
+Common Mobile Issues:
+
+Network Connectivity:
+  Issue: App works on WiFi, fails on cellular
+  Solution: Test on both networks
+  Debug: Use network throttler
+  Implement: Retry logic, offline support
+
+Device Specific:
+  Issue: Works on simulator, fails on device
+  Solution: Always test on real device
+  Causes:
+    - Memory constraints
+    - Performance differences
+    - Platform differences
+    - Screen size issues
+
+Battery/Memory:
+  Issue: Excessive battery drain
+  Debug: Use power profiler
+  Optimize: Reduce background work
+  Monitor: Location tracking, networking
+```
+
+### 4. **Mobile Testing & Debugging Checklist**
+
+```yaml
+Device Testing:
+
+[ ] Test on both iOS and Android
+[ ] Test on old and new devices
+[ ] Test with poor network (3G throttle)
+[ ] Test in airplane mode
+[ ] Test with low battery
+[ ] Test with low memory
+[ ] Test with location disabled
+[ ] Test with notifications disabled
+[ ] Test rotation changes
+[ ] Test while backgrounded
+
+Performance:
+
+[ ] <16ms per frame (60 FPS)
+[ ] Memory usage <100MB
+[ ] Battery drain acceptable
+[ ] Network requests efficient
+[ ] Background tasks minimal
+
+Networking:
+
+[ ] Works on WiFi
+[ ] Works on cellular
+[ ] Handles network timeouts
+[ ] Handles offline mode
+[ ] Retries failed requests
+[ ] Shows loading indicators
+[ ] Shows error messages
+
+UI/UX:
+
+[ ] Responsive touch targets (44x44 min)
+[ ] Readable text (16pt minimum)
+[ ] Colors accessible
+[ ] Orientation changes handled
+[ ] Keyboard shows/hides correctly
+[ ] Safe areas respected (notches)
+
+---
+
+Tools:
+
+Testing Devices:
+  - iOS: iPhone SE (small), iPhone 12/13 (modern)
+  - Android: Pixel 4 (standard), Pixel 6 (new)
+  - Virtual: Simulators for iteration
+
+Device Management:
+  - TestFlight (iOS)
+  - Google Play Beta (Android)
+  - Firebase Test Lab
+  - BrowserStack
+
+Monitoring:
+  - Crashlytics
+  - Firebase Analytics
+  - App Performance Monitoring
+  - Custom event tracking
+```
+
+## Key Points
+
+- Always test on real devices
+- Simulate poor network conditions
+- Monitor memory and CPU
+- Test on old and new devices
+- Use platform-specific debugging tools
+- Check device logs for crashes
+- Test network edge cases
+- Monitor battery/memory impact
+- Use profilers to identify bottlenecks
+- Implement proper error handling
diff --git a/.claude/skills/mobile-app-testing/SKILL.md b/.claude/skills/mobile-app-testing/SKILL.md
new file mode 100644
index 0000000..00b5cc0
--- /dev/null
+++ b/.claude/skills/mobile-app-testing/SKILL.md
@@ -0,0 +1,344 @@
+---
+name: mobile-app-testing
+description: Comprehensive mobile app testing strategies for iOS and Android. Covers unit tests, UI tests, integration tests, performance testing, and test automation with Detox, Appium, and XCTest.
+---
+
+# Mobile App Testing
+
+## Overview
+
+Implement comprehensive testing strategies for mobile applications including unit tests, UI tests, integration tests, and performance testing.
+
+## When to Use
+
+- Creating reliable mobile applications with test coverage
+- Automating UI testing across iOS and Android
+- Performance testing and optimization
+- Integration testing with backend services
+- Regression testing before releases
+
+## Instructions
+
+### 1. **React Native Testing with Jest & Detox**
+
+```javascript
+// Unit test with Jest
+import { calculate } from '../utils/math';
+
+describe('Math utilities', () => {
+  test('should add two numbers', () => {
+    expect(calculate.add(2, 3)).toBe(5);
+  });
+
+  test('should handle negative numbers', () => {
+    expect(calculate.add(-2, 3)).toBe(1);
+  });
+});
+
+// Component unit test
+import React from 'react';
+import { render, screen } from '@testing-library/react-native';
+import { UserProfile } from '../components/UserProfile';
+
+describe('UserProfile Component', () => {
+  test('renders user name correctly', () => {
+    const mockUser = { id: '1', name: 'John Doe', email: 'john@example.com' };
+    render(<UserProfile user={mockUser} />);
+
+    expect(screen.getByText('John Doe')).toBeTruthy();
+  });
+
+  test('handles missing user gracefully', () => {
+    render(<UserProfile user={null} />);
+    expect(screen.getByText(/no user data/i)).toBeTruthy();
+  });
+});
+
+// E2E Testing with Detox
+describe('Login Flow E2E Test', () => {
+  beforeAll(async () => {
+    await device.launchApp();
+  });
+
+  beforeEach(async () => {
+    await device.reloadReactNative();
+  });
+
+  it('should login successfully with valid credentials', async () => {
+    await waitFor(element(by.id('emailInput')))
+      .toBeVisible()
+      .withTimeout(5000);
+
+    await element(by.id('emailInput')).typeText('user@example.com');
+    await element(by.id('passwordInput')).typeText('password123');
+    await element(by.id('loginButton')).multiTap();
+
+    await waitFor(element(by.text('Home Feed')))
+      .toBeVisible()
+      .withTimeout(5000);
+  });
+
+  it('should show error with invalid credentials', async () => {
+    await element(by.id('emailInput')).typeText('invalid@example.com');
+    await element(by.id('passwordInput')).typeText('wrongpass');
+    await element(by.id('loginButton')).multiTap();
+
+    await waitFor(element(by.text(/invalid credentials/i)))
+      .toBeVisible()
+      .withTimeout(5000);
+  });
+
+  it('should navigate between tabs', async () => {
+    await element(by.id('profileTab')).tap();
+    await waitFor(element(by.text('Profile')))
+      .toBeVisible()
+      .withTimeout(2000);
+
+    await element(by.id('homeTab')).tap();
+    await waitFor(element(by.text('Home Feed')))
+      .toBeVisible()
+      .withTimeout(2000);
+  });
+});
+```
+
+### 2. **iOS Testing with XCTest**
+
+```swift
+import XCTest
+@testable import MyApp
+
+class UserViewModelTests: XCTestCase {
+  var viewModel: UserViewModel!
+  var mockNetworkService: MockNetworkService!
+
+  override func setUp() {
+    super.setUp()
+    mockNetworkService = MockNetworkService()
+    viewModel = UserViewModel(networkService: mockNetworkService)
+  }
+
+  func testFetchUserSuccess() async {
+    let expectedUser = User(id: UUID(), name: "John", email: "john@example.com")
+    mockNetworkService.mockUser = expectedUser
+
+    await viewModel.fetchUser(id: expectedUser.id)
+
+    XCTAssertEqual(viewModel.user?.name, "John")
+    XCTAssertNil(viewModel.errorMessage)
+    XCTAssertFalse(viewModel.isLoading)
+  }
+
+  func testFetchUserFailure() async {
+    mockNetworkService.shouldFail = true
+
+    await viewModel.fetchUser(id: UUID())
+
+    XCTAssertNil(viewModel.user)
+    XCTAssertNotNil(viewModel.errorMessage)
+    XCTAssertFalse(viewModel.isLoading)
+  }
+}
+
+class MockNetworkService: NetworkService {
+  var mockUser: User?
+  var shouldFail = false
+
+  override func fetch<T: Decodable>(
+    _: T.Type,
+    from endpoint: String
+  ) async throws -> T {
+    if shouldFail {
+      throw NetworkError.unknown
+    }
+    return mockUser as! T
+  }
+}
+
+// UI Test
+class LoginUITests: XCTestCase {
+  override func setUp() {
+    super.setUp()
+    continueAfterFailure = false
+    XCUIApplication().launch()
+  }
+
+  func testLoginFlow() {
+    let app = XCUIApplication()
+
+    let emailTextField = app.textFields["emailInput"]
+    let passwordTextField = app.secureTextFields["passwordInput"]
+    let loginButton = app.buttons["loginButton"]
+
+    emailTextField.tap()
+    emailTextField.typeText("user@example.com")
+
+    passwordTextField.tap()
+    passwordTextField.typeText("password123")
+
+    loginButton.tap()
+
+    let homeText = app.staticTexts["Home Feed"]
+    XCTAssertTrue(homeText.waitForExistence(timeout: 5))
+  }
+
+  func testNavigationBetweenTabs() {
+    let app = XCUIApplication()
+    let profileTab = app.tabBars.buttons["Profile"]
+    let homeTab = app.tabBars.buttons["Home"]
+
+    profileTab.tap()
+    XCTAssertTrue(app.staticTexts["Profile"].exists)
+
+    homeTab.tap()
+    XCTAssertTrue(app.staticTexts["Home"].exists)
+  }
+}
+```
+
+### 3. **Android Testing with Espresso**
+
+```kotlin
+@RunWith(AndroidJUnit4::class)
+class UserViewModelTest {
+  private lateinit var viewModel: UserViewModel
+  private val mockApiService = mock<ApiService>()
+
+  @Before
+  fun setUp() {
+    viewModel = UserViewModel(mockApiService)
+  }
+
+  @Test
+  fun fetchUserSuccess() = runTest {
+    val expectedUser = User("1", "John", "john@example.com")
+    `when`(mockApiService.getUser("1")).thenReturn(expectedUser)
+
+    viewModel.fetchUser("1")
+
+    assertEquals(expectedUser.name, viewModel.user.value?.name)
+    assertEquals(null, viewModel.errorMessage.value)
+  }
+
+  @Test
+  fun fetchUserFailure() = runTest {
+    `when`(mockApiService.getUser("1"))
+      .thenThrow(IOException("Network error"))
+
+    viewModel.fetchUser("1")
+
+    assertEquals(null, viewModel.user.value)
+    assertNotNull(viewModel.errorMessage.value)
+  }
+}
+
+// UI Test with Espresso
+@RunWith(AndroidJUnit4::class)
+class LoginActivityTest {
+  @get:Rule
+  val activityRule = ActivityScenarioRule(LoginActivity::class.java)
+
+  @Test
+  fun testLoginWithValidCredentials() {
+    onView(withId(R.id.emailInput))
+      .perform(typeText("user@example.com"))
+
+    onView(withId(R.id.passwordInput))
+      .perform(typeText("password123"))
+
+    onView(withId(R.id.loginButton))
+      .perform(click())
+
+    onView(withText("Home"))
+      .check(matches(isDisplayed()))
+  }
+
+  @Test
+  fun testLoginWithInvalidCredentials() {
+    onView(withId(R.id.emailInput))
+      .perform(typeText("invalid@example.com"))
+
+    onView(withId(R.id.passwordInput))
+      .perform(typeText("wrongpassword"))
+
+    onView(withId(R.id.loginButton))
+      .perform(click())
+
+    onView(withText(containsString("Invalid credentials")))
+      .check(matches(isDisplayed()))
+  }
+
+  @Test
+  fun testNavigationBetweenTabs() {
+    onView(withId(R.id.profileTab)).perform(click())
+    onView(withText("Profile")).check(matches(isDisplayed()))
+
+    onView(withId(R.id.homeTab)).perform(click())
+    onView(withText("Home")).check(matches(isDisplayed()))
+  }
+}
+```
+
+### 4. **Performance Testing**
+
+```swift
+import XCTest
+
+class PerformanceTests: XCTestCase {
+  func testListRenderingPerformance() {
+    let viewModel = ItemsViewModel()
+    viewModel.items = (0..<1000).map { i in
+      Item(id: UUID(), title: "Item \(i)", price: Double(i))
+    }
+
+    measure {
+      _ = viewModel.items.filter { $0.price > 50 }
+    }
+  }
+
+  func testNetworkResponseTime() {
+    let networkService = NetworkService()
+
+    measure {
+      let expectation = XCTestExpectation(description: "Fetch user")
+
+      Task {
+        do {
+          _ = try await networkService.fetch(User.self, from: "/users/test")
+          expectation.fulfill()
+        } catch {
+          XCTFail("Network request failed")
+        }
+      }
+
+      wait(for: [expectation], timeout: 10)
+    }
+  }
+}
+```
+
+## Best Practices
+
+### ✅ DO
+- Write tests for business logic first
+- Use dependency injection for testability
+- Mock external API calls
+- Test both success and failure paths
+- Automate UI testing for critical flows
+- Run tests on real devices
+- Measure performance on target devices
+- Keep tests isolated and independent
+- Use meaningful test names
+- Maintain >80% code coverage
+
+### ❌ DON'T
+- Skip testing UI-critical flows
+- Use hardcoded test data
+- Ignore performance regressions
+- Test implementation details
+- Make tests flaky or unreliable
+- Skip testing on actual devices
+- Ignore accessibility testing
+- Create interdependent tests
+- Test without mocking APIs
+- Deploy untested code
diff --git a/.claude/skills/mobile-design/SKILL.md b/.claude/skills/mobile-design/SKILL.md
new file mode 100644
index 0000000..f4109e7
--- /dev/null
+++ b/.claude/skills/mobile-design/SKILL.md
@@ -0,0 +1,284 @@
+---
+name: mobile-design
+description: Mobile-first design and engineering doctrine for iOS and Android apps. Covers touch interaction, performance, platform conventions, offline behavior, and mobile-specific decision-making. Teaches principles and constraints, not fixed layouts. Use for React Native, Flutter, or native mobile apps.
+allowed-tools: Read, Glob, Grep, Bash
+---
+# Mobile Design System
+
+**(Mobile-First · Touch-First · Platform-Respectful)**
+
+> **Philosophy:** Touch-first. Battery-conscious. Platform-respectful. Offline-capable.
+> **Core Law:** Mobile is NOT a small desktop.
+> **Operating Rule:** Think constraints first, aesthetics second.
+
+This skill exists to **prevent desktop-thinking, AI-defaults, and unsafe assumptions** when designing or building mobile applications.
+
+---
+
+## 1. Mobile Feasibility & Risk Index (MFRI)
+
+Before designing or implementing **any mobile feature or screen**, assess feasibility.
+
+### MFRI Dimensions (1–5)
+
+| Dimension                  | Question                                                          |
+| -------------------------- | ----------------------------------------------------------------- |
+| **Platform Clarity**       | Is the target platform (iOS / Android / both) explicitly defined? |
+| **Interaction Complexity** | How complex are gestures, flows, or navigation?                   |
+| **Performance Risk**       | Does this involve lists, animations, heavy state, or media?       |
+| **Offline Dependence**     | Does the feature break or degrade without network?                |
+| **Accessibility Risk**     | Does this impact motor, visual, or cognitive accessibility?       |
+
+### Score Formula
+
+```
+MFRI = (Platform Clarity + Accessibility Readiness)
+       − (Interaction Complexity + Performance Risk + Offline Dependence)
+```
+
+**Range:** `-10 → +10`
+
+### Interpretation
+
+| MFRI     | Meaning   | Required Action                       |
+| -------- | --------- | ------------------------------------- |
+| **6–10** | Safe      | Proceed normally                      |
+| **3–5**  | Moderate  | Add performance + UX validation       |
+| **0–2**  | Risky     | Simplify interactions or architecture |
+| **< 0**  | Dangerous | Redesign before implementation        |
+
+---
+
+## 2. Mandatory Thinking Before Any Work
+
+### ⛔ STOP: Ask Before Assuming (Required)
+
+If **any of the following are not explicitly stated**, you MUST ask before proceeding:
+
+| Aspect     | Question                                   | Why                                      |
+| ---------- | ------------------------------------------ | ---------------------------------------- |
+| Platform   | iOS, Android, or both?                     | Affects navigation, gestures, typography |
+| Framework  | React Native, Flutter, or native?          | Determines performance and patterns      |
+| Navigation | Tabs, stack, drawer?                       | Core UX architecture                     |
+| Offline    | Must it work offline?                      | Data & sync strategy                     |
+| Devices    | Phone only or tablet too?                  | Layout & density rules                   |
+| Audience   | Consumer, enterprise, accessibility needs? | Touch & readability                      |
+
+🚫 **Never default to your favorite stack or pattern.**
+
+---
+
+## 3. Mandatory Reference Reading (Enforced)
+
+### Universal (Always Read First)
+
+| File                          | Purpose                            | Status            |
+| ----------------------------- | ---------------------------------- | ----------------- |
+| **mobile-design-thinking.md** | Anti-memorization, context-forcing | 🔴 REQUIRED FIRST |
+| **touch-psychology.md**       | Fitts’ Law, thumb zones, gestures  | 🔴 REQUIRED       |
+| **mobile-performance.md**     | 60fps, memory, battery             | 🔴 REQUIRED       |
+| **mobile-backend.md**         | Offline sync, push, APIs           | 🔴 REQUIRED       |
+| **mobile-testing.md**         | Device & E2E testing               | 🔴 REQUIRED       |
+| **mobile-debugging.md**       | Native vs JS debugging             | 🔴 REQUIRED       |
+
+### Platform-Specific (Conditional)
+
+| Platform       | File                |
+| -------------- | ------------------- |
+| iOS            | platform-ios.md     |
+| Android        | platform-android.md |
+| Cross-platform | BOTH above          |
+
+> ❌ If you haven’t read the platform file, you are not allowed to design UI.
+
+---
+
+## 4. AI Mobile Anti-Patterns (Hard Bans)
+
+### 🚫 Performance Sins (Non-Negotiable)
+
+| ❌ Never                   | Why                  | ✅ Always                                |
+| ------------------------- | -------------------- | --------------------------------------- |
+| ScrollView for long lists | Memory explosion     | FlatList / FlashList / ListView.builder |
+| Inline renderItem         | Re-renders all rows  | useCallback + memo                      |
+| Index as key              | Reorder bugs         | Stable ID                               |
+| JS-thread animations      | Jank                 | Native driver / GPU                     |
+| console.log in prod       | JS thread block      | Strip logs                              |
+| No memoization            | Battery + perf drain | React.memo / const widgets              |
+
+---
+
+### 🚫 Touch & UX Sins
+
+| ❌ Never               | Why                  | ✅ Always          |
+| --------------------- | -------------------- | ----------------- |
+| Touch <44–48px        | Miss taps            | Min touch target  |
+| Gesture-only action   | Excludes users       | Button fallback   |
+| No loading state      | Feels broken         | Explicit feedback |
+| No error recovery     | Dead end             | Retry + message   |
+| Ignore platform norms | Muscle memory broken | iOS ≠ Android     |
+
+---
+
+### 🚫 Security Sins
+
+| ❌ Never                | Why                | ✅ Always               |
+| ---------------------- | ------------------ | ---------------------- |
+| Tokens in AsyncStorage | Easily stolen      | SecureStore / Keychain |
+| Hardcoded secrets      | Reverse engineered | Env + secure storage   |
+| No SSL pinning         | MITM risk          | Cert pinning           |
+| Log sensitive data     | PII leakage        | Never log secrets      |
+
+---
+
+## 5. Platform Unification vs Divergence Matrix
+
+```
+UNIFY                          DIVERGE
+──────────────────────────     ─────────────────────────
+Business logic                Navigation behavior
+Data models                    Gestures
+API contracts                  Icons
+Validation                     Typography
+Error semantics                Pickers / dialogs
+```
+
+### Platform Defaults
+
+| Element   | iOS          | Android        |
+| --------- | ------------ | -------------- |
+| Font      | SF Pro       | Roboto         |
+| Min touch | 44pt         | 48dp           |
+| Back      | Edge swipe   | System back    |
+| Sheets    | Bottom sheet | Dialog / sheet |
+| Icons     | SF Symbols   | Material Icons |
+
+---
+
+## 6. Mobile UX Psychology (Non-Optional)
+
+### Fitts’ Law (Touch Reality)
+
+* Finger ≠ cursor
+* Accuracy is low
+* Reach matters more than precision
+
+**Rules:**
+
+* Primary CTAs live in **thumb zone**
+* Destructive actions pushed away
+* No hover assumptions
+
+---
+
+## 7. Performance Doctrine
+
+### React Native (Required Pattern)
+
+```ts
+const Row = React.memo(({ item }) => (
+  <View><Text>{item.title}</Text></View>
+));
+
+const renderItem = useCallback(
+  ({ item }) => <Row item={item} />,
+  []
+);
+
+<FlatList
+  data={items}
+  renderItem={renderItem}
+  keyExtractor={(i) => i.id}
+  getItemLayout={(_, i) => ({
+    length: ITEM_HEIGHT,
+    offset: ITEM_HEIGHT * i,
+    index: i,
+  })}
+/>
+```
+
+### Flutter (Required Pattern)
+
+```dart
+class Item extends StatelessWidget {
+  const Item({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const Text('Static');
+  }
+}
+```
+
+* `const` everywhere possible
+* Targeted rebuilds only
+
+---
+
+## 8. Mandatory Mobile Checkpoint
+
+Before writing **any code**, you must complete this:
+
+```
+🧠 MOBILE CHECKPOINT
+
+Platform:     ___________
+Framework:    ___________
+Files Read:   ___________
+
+3 Principles I Will Apply:
+1.
+2.
+3.
+
+Anti-Patterns I Will Avoid:
+1.
+2.
+```
+
+❌ Cannot complete → go back and read.
+
+---
+
+## 9. Framework Decision Tree (Canonical)
+
+```
+Need OTA + web team → React Native + Expo
+High-perf UI → Flutter
+iOS only → SwiftUI
+Android only → Compose
+```
+
+No debate without justification.
+
+---
+
+## 10. Release Readiness Checklist
+
+### Before Shipping
+
+* [ ] Touch targets ≥ 44–48px
+* [ ] Offline handled
+* [ ] Secure storage used
+* [ ] Lists optimized
+* [ ] Logs stripped
+* [ ] Tested on low-end devices
+* [ ] Accessibility labels present
+* [ ] MFRI ≥ 3
+
+---
+
+## 11. Related Skills
+
+* **frontend-design** – Visual systems & components
+* **frontend-dev-guidelines** – RN/TS architecture
+* **backend-dev-guidelines** – Mobile-safe APIs
+* **error-tracking** – Crash & performance telemetry
+
+---
+
+> **Final Law:**
+> Mobile users are distracted, interrupted, and impatient—often using one hand on a bad network with low battery.
+> **Design for that reality, or your app will fail quietly.**
+
+---
diff --git a/.claude/skills/mobile-design/decision-trees.md b/.claude/skills/mobile-design/decision-trees.md
new file mode 100644
index 0000000..69287bc
--- /dev/null
+++ b/.claude/skills/mobile-design/decision-trees.md
@@ -0,0 +1,516 @@
+# Mobile Decision Trees
+
+> Framework selection, state management, storage strategy, and context-based decisions.
+> **These are THINKING guides, not copy-paste answers.**
+
+---
+
+## 1. Framework Selection
+
+### Master Decision Tree
+
+```
+WHAT ARE YOU BUILDING?
+        │
+        ├── Need OTA updates without app store review?
+        │   │
+        │   ├── Yes → React Native + Expo
+        │   │         ├── Expo Go for development
+        │   │         ├── EAS Update for production OTA
+        │   │         └── Best for: rapid iteration, web teams
+        │   │
+        │   └── No → Continue ▼
+        │
+        ├── Need pixel-perfect custom UI across platforms?
+        │   │
+        │   ├── Yes → Flutter
+        │   │         ├── Custom rendering engine
+        │   │         ├── Single UI for iOS + Android
+        │   │         └── Best for: branded, visual apps
+        │   │
+        │   └── No → Continue ▼
+        │
+        ├── Heavy native features (ARKit, HealthKit, specific sensors)?
+        │   │
+        │   ├── iOS only → SwiftUI / UIKit
+        │   │              └── Maximum native capability
+        │   │
+        │   ├── Android only → Kotlin + Jetpack Compose
+        │   │                  └── Maximum native capability
+        │   │
+        │   └── Both → Consider native with shared logic
+        │              └── Kotlin Multiplatform for shared
+        │
+        ├── Existing web team + TypeScript codebase?
+        │   │
+        │   └── Yes → React Native
+        │             ├── Familiar paradigm for React devs
+        │             ├── Share code with web (limited)
+        │             └── Large ecosystem
+        │
+        └── Enterprise with existing Flutter team?
+            │
+            └── Yes → Flutter
+                      └── Leverage existing expertise
+```
+
+### Framework Comparison
+
+| Factor | React Native | Flutter | Native (Swift/Kotlin) |
+|--------|-------------|---------|----------------------|
+| **OTA Updates** | ✅ Expo | ❌ No | ❌ No |
+| **Learning Curve** | Low (React devs) | Medium | Higher |
+| **Performance** | Good | Excellent | Best |
+| **UI Consistency** | Platform-native | Identical | Platform-native |
+| **Bundle Size** | Medium | Larger | Smallest |
+| **Native Access** | Via bridges | Via channels | Direct |
+| **Hot Reload** | ✅ | ✅ | ✅ (Xcode 15+) |
+
+### When to Choose Native
+
+```
+CHOOSE NATIVE WHEN:
+├── Maximum performance required (games, 3D)
+├── Deep OS integration needed
+├── Platform-specific features are core
+├── Team has native expertise
+├── App store presence is primary
+└── Long-term maintenance priority
+
+AVOID NATIVE WHEN:
+├── Limited budget/time
+├── Need rapid iteration
+├── Identical UI on both platforms
+├── Team is web-focused
+└── Cross-platform is priority
+```
+
+---
+
+## 2. State Management Selection
+
+### React Native State Decision
+
+```
+WHAT'S YOUR STATE COMPLEXITY?
+        │
+        ├── Simple app, few screens, minimal shared state
+        │   │
+        │   └── Zustand (or just useState/Context)
+        │       ├── Minimal boilerplate
+        │       ├── Easy to understand
+        │       └── Scales OK to medium
+        │
+        ├── Primarily server data (API-driven)
+        │   │
+        │   └── TanStack Query (React Query) + Zustand
+        │       ├── Query for server state
+        │       ├── Zustand for UI state
+        │       └── Excellent caching, refetching
+        │
+        ├── Complex app with many features
+        │   │
+        │   └── Redux Toolkit + RTK Query
+        │       ├── Predicable, debuggable
+        │       ├── RTK Query for API
+        │       └── Good for large teams
+        │
+        └── Atomic, granular state needs
+            │
+            └── Jotai
+                ├── Atom-based (like Recoil)
+                ├── Minimizes re-renders
+                └── Good for derived state
+```
+
+### Flutter State Decision
+
+```
+WHAT'S YOUR STATE COMPLEXITY?
+        │
+        ├── Simple app, learning Flutter
+        │   │
+        │   └── Provider (or setState)
+        │       ├── Official, simple
+        │       ├── Built into Flutter
+        │       └── Good for small apps
+        │
+        ├── Modern, type-safe, testable
+        │   │
+        │   └── Riverpod 2.0
+        │       ├── Compile-time safety
+        │       ├── Code generation
+        │       ├── Excellent for medium-large apps
+        │       └── Recommended for new projects
+        │
+        ├── Enterprise, strict patterns needed
+        │   │
+        │   └── BLoC
+        │       ├── Event → State pattern
+        │       ├── Very testable
+        │       ├── More boilerplate
+        │       └── Good for large teams
+        │
+        └── Quick prototyping
+            │
+            └── GetX (with caution)
+                ├── Fast to implement
+                ├── Less strict patterns
+                └── Can become messy at scale
+```
+
+### State Management Anti-Patterns
+
+```
+❌ DON'T:
+├── Use global state for everything
+├── Mix state management approaches
+├── Store server state in local state
+├── Skip state normalization
+├── Overuse Context (re-render heavy)
+└── Put navigation state in app state
+
+✅ DO:
+├── Server state → Query library
+├── UI state → Minimal, local first
+├── Lift state only when needed
+├── Choose ONE approach per project
+└── Keep state close to where it's used
+```
+
+---
+
+## 3. Navigation Pattern Selection
+
+```
+HOW MANY TOP-LEVEL DESTINATIONS?
+        │
+        ├── 2 destinations
+        │   └── Consider: Top tabs or simple stack
+        │
+        ├── 3-5 destinations (equal importance)
+        │   └── ✅ Tab Bar / Bottom Navigation
+        │       ├── Most common pattern
+        │       └── Easy discovery
+        │
+        ├── 5+ destinations
+        │   │
+        │   ├── All important → Drawer Navigation
+        │   │                   └── Hidden but many options
+        │   │
+        │   └── Some less important → Tab bar + drawer hybrid
+        │
+        └── Single linear flow?
+            └── Stack Navigation only
+                └── Onboarding, checkout, etc.
+```
+
+### Navigation by App Type
+
+| App Type | Pattern | Reason |
+|----------|---------|--------|
+| Social (Instagram) | Tab bar | Frequent switching |
+| E-commerce | Tab bar + stack | Categories as tabs |
+| Email (Gmail) | Drawer + list-detail | Many folders |
+| Settings | Stack only | Deep drill-down |
+| Onboarding | Stack wizard | Linear flow |
+| Messaging | Tab (chats) + stack | Threads |
+
+---
+
+## 4. Storage Strategy Selection
+
+```
+WHAT TYPE OF DATA?
+        │
+        ├── Sensitive (tokens, passwords, keys)
+        │   │
+        │   └── ✅ Secure Storage
+        │       ├── iOS: Keychain
+        │       ├── Android: EncryptedSharedPreferences
+        │       └── RN: expo-secure-store / react-native-keychain
+        │
+        ├── User preferences (settings, theme)
+        │   │
+        │   └── ✅ Key-Value Storage
+        │       ├── iOS: UserDefaults
+        │       ├── Android: SharedPreferences
+        │       └── RN: AsyncStorage / MMKV
+        │
+        ├── Structured data (entities, relationships)
+        │   │
+        │   └── ✅ Database
+        │       ├── SQLite (expo-sqlite, sqflite)
+        │       ├── Realm (NoSQL, reactive)
+        │       └── WatermelonDB (large datasets)
+        │
+        ├── Large files (images, documents)
+        │   │
+        │   └── ✅ File System
+        │       ├── iOS: Documents / Caches directory
+        │       ├── Android: Internal/External storage
+        │       └── RN: react-native-fs / expo-file-system
+        │
+        └── Cached API data
+            │
+            └── ✅ Query Library Cache
+                ├── TanStack Query (RN)
+                ├── Riverpod async (Flutter)
+                └── Automatic invalidation
+```
+
+### Storage Comparison
+
+| Storage | Speed | Security | Capacity | Use Case |
+|---------|-------|----------|----------|----------|
+| Secure Storage | Medium | 🔒 High | Small | Tokens, secrets |
+| Key-Value | Fast | Low | Medium | Settings |
+| SQLite | Fast | Low | Large | Structured data |
+| File System | Medium | Low | Very Large | Media, documents |
+| Query Cache | Fast | Low | Medium | API responses |
+
+---
+
+## 5. Offline Strategy Selection
+
+```
+HOW CRITICAL IS OFFLINE?
+        │
+        ├── Nice to have (works when possible)
+        │   │
+        │   └── Cache last data + show stale
+        │       ├── Simple implementation
+        │       ├── TanStack Query with staleTime
+        │       └── Show "last updated" timestamp
+        │
+        ├── Essential (core functionality offline)
+        │   │
+        │   └── Offline-first architecture
+        │       ├── Local database as source of truth
+        │       ├── Sync to server when online
+        │       ├── Conflict resolution strategy
+        │       └── Queue actions for later sync
+        │
+        └── Real-time critical (collaboration, chat)
+            │
+            └── WebSocket + local queue
+                ├── Optimistic updates
+                ├── Eventual consistency
+                └── Complex conflict handling
+```
+
+### Offline Implementation Patterns
+
+```
+1. CACHE-FIRST (Simple)
+   Request → Check cache → If stale, fetch → Update cache
+   
+2. STALE-WHILE-REVALIDATE
+   Request → Return cached → Fetch update → Update UI
+   
+3. OFFLINE-FIRST (Complex)
+   Action → Write to local DB → Queue sync → Sync when online
+   
+4. SYNC ENGINE
+   Use: Firebase, Realm Sync, Supabase realtime
+   Handles conflict resolution automatically
+```
+
+---
+
+## 6. Authentication Pattern Selection
+
+```
+WHAT AUTH TYPE NEEDED?
+        │
+        ├── Simple email/password
+        │   │
+        │   └── Token-based (JWT)
+        │       ├── Store refresh token securely
+        │       ├── Access token in memory
+        │       └── Silent refresh flow
+        │
+        ├── Social login (Google, Apple, etc.)
+        │   │
+        │   └── OAuth 2.0 + PKCE
+        │       ├── Use platform SDKs
+        │       ├── Deep link callback
+        │       └── Apple Sign-In required for iOS
+        │
+        ├── Enterprise/SSO
+        │   │
+        │   └── OIDC / SAML
+        │       ├── Web view or system browser
+        │       └── Handle redirect properly
+        │
+        └── Biometric (FaceID, fingerprint)
+            │
+            └── Local auth + secure token
+                ├── Biometrics unlock stored token
+                ├── Not a replacement for server auth
+                └── Fallback to PIN/password
+```
+
+### Auth Token Storage
+
+```
+❌ NEVER store tokens in:
+├── AsyncStorage (plain text)
+├── Redux/state (not persisted correctly)
+├── Local storage equivalent
+└── Logs or debug output
+
+✅ ALWAYS store tokens in:
+├── iOS: Keychain
+├── Android: EncryptedSharedPreferences
+├── Expo: SecureStore
+├── Biometric-protected if available
+```
+
+---
+
+## 7. Project Type Templates
+
+### E-Commerce App
+
+```
+RECOMMENDED STACK:
+├── Framework: React Native + Expo (OTA for pricing)
+├── Navigation: Tab bar (Home, Search, Cart, Account)
+├── State: TanStack Query (products) + Zustand (cart)
+├── Storage: SecureStore (auth) + SQLite (cart cache)
+├── Offline: Cache products, queue cart actions
+└── Auth: Email/password + Social + Apple Pay
+
+KEY DECISIONS:
+├── Product images: Lazy load, cache aggressively
+├── Cart: Sync across devices via API
+├── Checkout: Secure, minimal steps
+└── Deep links: Product shares, marketing
+```
+
+### Social/Content App
+
+```
+RECOMMENDED STACK:
+├── Framework: React Native or Flutter
+├── Navigation: Tab bar (Feed, Search, Create, Notifications, Profile)
+├── State: TanStack Query (feed) + Zustand (UI)
+├── Storage: SQLite (feed cache, drafts)
+├── Offline: Cache feed, queue posts
+└── Auth: Social login primary, Apple required
+
+KEY DECISIONS:
+├── Feed: Infinite scroll, memoized items
+├── Media: Upload queuing, background upload
+├── Push: Deep link to content
+└── Real-time: WebSocket for notifications
+```
+
+### Productivity/SaaS App
+
+```
+RECOMMENDED STACK:
+├── Framework: Flutter (consistent UI) or RN
+├── Navigation: Drawer or Tab bar
+├── State: Riverpod/BLoC or Redux Toolkit
+├── Storage: SQLite (offline), SecureStore (auth)
+├── Offline: Full offline editing, sync
+└── Auth: SSO/OIDC for enterprise
+
+KEY DECISIONS:
+├── Data sync: Conflict resolution strategy
+├── Collaborative: Real-time or eventual?
+├── Files: Large file handling
+└── Enterprise: MDM, compliance
+```
+
+---
+
+## 8. Decision Checklist
+
+### Before Starting ANY Project
+
+- [ ] Target platforms defined (iOS/Android/both)?
+- [ ] Framework selected based on criteria?
+- [ ] State management approach chosen?
+- [ ] Navigation pattern selected?
+- [ ] Storage strategy for each data type?
+- [ ] Offline requirements defined?
+- [ ] Auth flow designed?
+- [ ] Deep linking planned from start?
+
+### Questions to Ask User
+
+```
+If project details are vague, ASK:
+
+1. "Will this need OTA updates without app store review?"
+   → Affects framework choice (Expo = yes)
+
+2. "Do iOS and Android need identical UI?"
+   → Affects framework (Flutter = identical)
+
+3. "What's the offline requirement?"
+   → Affects architecture complexity
+
+4. "Is there an existing backend/auth system?"
+   → Affects auth and API approach
+
+5. "What devices? Phone only, or tablet?"
+   → Affects navigation and layout
+
+6. "Enterprise or consumer?"
+   → Affects auth (SSO), security, compliance
+```
+
+---
+
+## 9. Anti-Pattern Decisions
+
+### ❌ Decision Anti-Patterns
+
+| Anti-Pattern | Why It's Bad | Better Approach |
+|--------------|--------------|-----------------|
+| **Redux for simple app** | Massive overkill | Zustand or context |
+| **Native for MVP** | Slow development | Cross-platform MVP |
+| **Drawer for 3 sections** | Hidden navigation | Tab bar |
+| **AsyncStorage for tokens** | Insecure | SecureStore |
+| **No offline consideration** | Broken on subway | Plan from start |
+| **Same stack for all projects** | Doesn't fit context | Evaluate per project |
+
+---
+
+## 10. Quick Reference
+
+### Framework Quick Pick
+
+```
+OTA needed?           → React Native + Expo
+Identical UI?         → Flutter
+Maximum performance?  → Native
+Web team?            → React Native
+Quick prototype?     → Expo
+```
+
+### State Quick Pick
+
+```
+Simple app?          → Zustand / Provider
+Server-heavy?        → TanStack Query / Riverpod
+Enterprise?          → Redux / BLoC
+Atomic state?        → Jotai
+```
+
+### Storage Quick Pick
+
+```
+Secrets?             → SecureStore / Keychain
+Settings?            → AsyncStorage / UserDefaults
+Structured data?     → SQLite
+API cache?           → Query library
+```
+
+---
+
+> **Remember:** These trees are guides for THINKING, not rules to follow blindly. Every project has unique constraints. ASK clarifying questions when requirements are vague, and choose based on actual needs, not defaults.
diff --git a/.claude/skills/mobile-design/mobile-backend.md b/.claude/skills/mobile-design/mobile-backend.md
new file mode 100644
index 0000000..8939989
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-backend.md
@@ -0,0 +1,491 @@
+# Mobile Backend Patterns
+
+> **This file covers backend/API patterns SPECIFIC to mobile clients.**
+> Generic backend patterns are in `nodejs-best-practices` and `api-patterns`.
+> **Mobile backend is NOT the same as web backend. Different constraints, different patterns.**
+
+---
+
+## 🧠 MOBILE BACKEND MINDSET
+
+```
+Mobile clients are DIFFERENT from web clients:
+├── Unreliable network (2G, subway, elevator)
+├── Battery constraints (minimize wake-ups)
+├── Limited storage (can't cache everything)
+├── Interrupted sessions (calls, notifications)
+├── Diverse devices (old phones to flagships)
+└── Binary updates are slow (App Store review)
+```
+
+**Your backend must compensate for ALL of these.**
+
+---
+
+## 🚫 AI MOBILE BACKEND ANTI-PATTERNS
+
+### These are common AI mistakes when building mobile backends:
+
+| ❌ AI Default | Why It's Wrong | ✅ Mobile-Correct |
+|---------------|----------------|-------------------|
+| Same API for web and mobile | Mobile needs compact responses | Separate mobile endpoints OR field selection |
+| Full object responses | Wastes bandwidth, battery | Partial responses, pagination |
+| No offline consideration | App crashes without network | Offline-first design, sync queues |
+| WebSocket for everything | Battery drain | Push notifications + polling fallback |
+| No app versioning | Can't force updates, breaking changes | Version headers, minimum version check |
+| Generic error messages | Users can't fix issues | Mobile-specific error codes + recovery actions |
+| Session-based auth | Mobile apps restart | Token-based with refresh |
+| Ignore device info | Can't debug issues | Device ID, app version in headers |
+
+---
+
+## 1. Push Notifications
+
+### Platform Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    YOUR BACKEND                                  │
+├─────────────────────────────────────────────────────────────────┤
+│                         │                                        │
+│              ┌──────────┴──────────┐                            │
+│              ▼                     ▼                            │
+│    ┌─────────────────┐   ┌─────────────────┐                    │
+│    │   FCM (Google)  │   │  APNs (Apple)   │                    │
+│    │   Firebase      │   │  Direct or FCM  │                    │
+│    └────────┬────────┘   └────────┬────────┘                    │
+│             │                     │                              │
+│             ▼                     ▼                              │
+│    ┌─────────────────┐   ┌─────────────────┐                    │
+│    │ Android Device  │   │   iOS Device    │                    │
+│    └─────────────────┘   └─────────────────┘                    │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Push Types
+
+| Type | Use Case | User Sees |
+|------|----------|-----------|
+| **Display** | New message, order update | Notification banner |
+| **Silent** | Background sync, content update | Nothing (background) |
+| **Data** | Custom handling by app | Depends on app logic |
+
+### Anti-Patterns
+
+| ❌ NEVER | ✅ ALWAYS |
+|----------|----------|
+| Send sensitive data in push | Push says "New message", app fetches content |
+| Overload with pushes | Batch, dedupe, respect quiet hours |
+| Same message to all | Segment by user preference, timezone |
+| Ignore failed tokens | Clean up invalid tokens regularly |
+| Skip APNs for iOS | FCM alone doesn't guarantee iOS delivery |
+
+### Token Management
+
+```
+TOKEN LIFECYCLE:
+├── App registers → Get token → Send to backend
+├── Token can change → App must re-register on start
+├── Token expires → Clean from database
+├── User uninstalls → Token becomes invalid (detect via error)
+└── Multiple devices → Store multiple tokens per user
+```
+
+---
+
+## 2. Offline Sync & Conflict Resolution
+
+### Sync Strategy Selection
+
+```
+WHAT TYPE OF DATA?
+        │
+        ├── Read-only (news, catalog)
+        │   └── Simple cache + TTL
+        │       └── ETag/Last-Modified for invalidation
+        │
+        ├── User-owned (notes, todos)
+        │   └── Last-write-wins (simple)
+        │       └── Or timestamp-based merge
+        │
+        ├── Collaborative (shared docs)
+        │   └── CRDT or OT required
+        │       └── Consider Firebase/Supabase
+        │
+        └── Critical (payments, inventory)
+            └── Server is source of truth
+                └── Optimistic UI + server confirmation
+```
+
+### Conflict Resolution Strategies
+
+| Strategy | How It Works | Best For |
+|----------|--------------|----------|
+| **Last-write-wins** | Latest timestamp overwrites | Simple data, single user |
+| **Server-wins** | Server always authoritative | Critical transactions |
+| **Client-wins** | Offline changes prioritized | Offline-heavy apps |
+| **Merge** | Combine changes field-by-field | Documents, rich content |
+| **CRDT** | Mathematically conflict-free | Real-time collaboration |
+
+### Sync Queue Pattern
+
+```
+CLIENT SIDE:
+├── User makes change → Write to local DB
+├── Add to sync queue → { action, data, timestamp, retries }
+├── Network available → Process queue FIFO
+├── Success → Remove from queue
+├── Failure → Retry with backoff (max 5 retries)
+└── Conflict → Apply resolution strategy
+
+SERVER SIDE:
+├── Accept change with client timestamp
+├── Compare with server version
+├── Apply conflict resolution
+├── Return merged state
+└── Client updates local with server response
+```
+
+---
+
+## 3. Mobile API Optimization
+
+### Response Size Reduction
+
+| Technique | Savings | Implementation |
+|-----------|---------|----------------|
+| **Field selection** | 30-70% | `?fields=id,name,thumbnail` |
+| **Compression** | 60-80% | gzip/brotli (automatic) |
+| **Pagination** | Varies | Cursor-based for mobile |
+| **Image variants** | 50-90% | `/image?w=200&q=80` |
+| **Delta sync** | 80-95% | Only changed records since timestamp |
+
+### Pagination: Cursor vs Offset
+
+```
+OFFSET (Bad for mobile):
+├── Page 1: OFFSET 0 LIMIT 20
+├── Page 2: OFFSET 20 LIMIT 20
+├── Problem: New item added → duplicates!
+└── Problem: Large offset = slow query
+
+CURSOR (Good for mobile):
+├── First: ?limit=20
+├── Next: ?limit=20&after=cursor_abc123
+├── Cursor = encoded (id + sort values)
+├── No duplicates on data changes
+└── Consistent performance
+```
+
+### Batch Requests
+
+```
+Instead of:
+GET /users/1
+GET /users/2  
+GET /users/3
+(3 round trips, 3x latency)
+
+Use:
+POST /batch
+{ requests: [
+    { method: "GET", path: "/users/1" },
+    { method: "GET", path: "/users/2" },
+    { method: "GET", path: "/users/3" }
+]}
+(1 round trip)
+```
+
+---
+
+## 4. App Versioning
+
+### Version Check Endpoint
+
+```
+GET /api/app-config
+Headers:
+  X-App-Version: 2.1.0
+  X-Platform: ios
+  X-Device-ID: abc123
+
+Response:
+{
+  "minimum_version": "2.0.0",
+  "latest_version": "2.3.0",
+  "force_update": false,
+  "update_url": "https://apps.apple.com/...",
+  "feature_flags": {
+    "new_player": true,
+    "dark_mode": true
+  },
+  "maintenance": false,
+  "maintenance_message": null
+}
+```
+
+### Version Comparison Logic
+
+```
+CLIENT VERSION vs MINIMUM VERSION:
+├── client >= minimum → Continue normally
+├── client < minimum → Show force update screen
+│   └── Block app usage until updated
+└── client < latest → Show optional update prompt
+
+FEATURE FLAGS:
+├── Enable/disable features without app update
+├── A/B testing by version/device
+└── Gradual rollout (10% → 50% → 100%)
+```
+
+---
+
+## 5. Authentication for Mobile
+
+### Token Strategy
+
+```
+ACCESS TOKEN:
+├── Short-lived (15 min - 1 hour)
+├── Stored in memory (not persistent)
+├── Used for API requests
+└── Refresh when expired
+
+REFRESH TOKEN:
+├── Long-lived (30-90 days)
+├── Stored in SecureStore/Keychain
+├── Used only to get new access token
+└── Rotate on each use (security)
+
+DEVICE TOKEN:
+├── Identifies this device
+├── Allows "log out all devices"
+├── Stored alongside refresh token
+└── Server tracks active devices
+```
+
+### Silent Re-authentication
+
+```
+REQUEST FLOW:
+├── Make request with access token
+├── 401 Unauthorized?
+│   ├── Have refresh token?
+│   │   ├── Yes → Call /auth/refresh
+│   │   │   ├── Success → Retry original request
+│   │   │   └── Failure → Force logout
+│   │   └── No → Force logout
+│   └── Token just expired (not invalid)
+│       └── Auto-refresh, user doesn't notice
+└── Success → Continue
+```
+
+---
+
+## 6. Error Handling for Mobile
+
+### Mobile-Specific Error Format
+
+```json
+{
+  "error": {
+    "code": "PAYMENT_DECLINED",
+    "message": "Your payment was declined",
+    "user_message": "Please check your card details or try another payment method",
+    "action": {
+      "type": "navigate",
+      "destination": "payment_methods"
+    },
+    "retry": {
+      "allowed": true,
+      "after_seconds": 5
+    }
+  }
+}
+```
+
+### Error Categories
+
+| Code Range | Category | Mobile Handling |
+|------------|----------|-----------------|
+| 400-499 | Client error | Show message, user action needed |
+| 401 | Auth expired | Silent refresh or re-login |
+| 403 | Forbidden | Show upgrade/permission screen |
+| 404 | Not found | Remove from local cache |
+| 409 | Conflict | Show sync conflict UI |
+| 429 | Rate limit | Retry after header, backoff |
+| 500-599 | Server error | Retry with backoff, show "try later" |
+| Network | No connection | Use cached data, queue for sync |
+
+---
+
+## 7. Media & Binary Handling
+
+### Image Optimization
+
+```
+CLIENT REQUEST:
+GET /images/{id}?w=400&h=300&q=80&format=webp
+
+SERVER RESPONSE:
+├── Resize on-the-fly OR use CDN
+├── WebP for Android (smaller)
+├── HEIC for iOS 14+ (if supported)
+├── JPEG fallback
+└── Cache-Control: max-age=31536000
+```
+
+### Chunked Upload (Large Files)
+
+```
+UPLOAD FLOW:
+1. POST /uploads/init
+   { filename, size, mime_type }
+   → { upload_id, chunk_size }
+
+2. PUT /uploads/{upload_id}/chunks/{n}
+   → Upload each chunk (1-5 MB)
+   → Can resume if interrupted
+
+3. POST /uploads/{upload_id}/complete
+   → Server assembles chunks
+   → Return final file URL
+```
+
+### Streaming Audio/Video
+
+```
+REQUIREMENTS:
+├── HLS (HTTP Live Streaming) for iOS
+├── DASH or HLS for Android
+├── Multiple quality levels (adaptive bitrate)
+├── Range request support (seeking)
+└── Offline download chunks
+
+ENDPOINTS:
+GET /media/{id}/manifest.m3u8  → HLS manifest
+GET /media/{id}/segment_{n}.ts → Video segment
+GET /media/{id}/download       → Full file for offline
+```
+
+---
+
+## 8. Security for Mobile
+
+### Device Attestation
+
+```
+VERIFY REAL DEVICE (not emulator/bot):
+├── iOS: DeviceCheck API
+│   └── Server verifies with Apple
+├── Android: Play Integrity API (replaces SafetyNet)
+│   └── Server verifies with Google
+└── Fail closed: Reject if attestation fails
+```
+
+### Request Signing
+
+```
+CLIENT:
+├── Create signature = HMAC(timestamp + path + body, secret)
+├── Send: X-Signature: {signature}
+├── Send: X-Timestamp: {timestamp}
+└── Send: X-Device-ID: {device_id}
+
+SERVER:
+├── Validate timestamp (within 5 minutes)
+├── Recreate signature with same inputs
+├── Compare signatures
+└── Reject if mismatch (tampering detected)
+```
+
+### Rate Limiting
+
+```
+MOBILE-SPECIFIC LIMITS:
+├── Per device (X-Device-ID)
+├── Per user (after auth)
+├── Per endpoint (stricter for sensitive)
+└── Sliding window preferred
+
+HEADERS:
+X-RateLimit-Limit: 100
+X-RateLimit-Remaining: 95
+X-RateLimit-Reset: 1609459200
+Retry-After: 60 (when 429)
+```
+
+---
+
+## 9. Monitoring & Analytics
+
+### Required Headers from Mobile
+
+```
+Every mobile request should include:
+├── X-App-Version: 2.1.0
+├── X-Platform: ios | android
+├── X-OS-Version: 17.0
+├── X-Device-Model: iPhone15,2
+├── X-Device-ID: uuid (persistent)
+├── X-Request-ID: uuid (per request, for tracing)
+├── Accept-Language: tr-TR
+└── X-Timezone: Europe/Istanbul
+```
+
+### What to Log
+
+```
+FOR EACH REQUEST:
+├── All headers above
+├── Endpoint, method, status
+├── Response time
+├── Error details (if any)
+└── User ID (if authenticated)
+
+ALERTS:
+├── Error rate > 5% per version
+├── P95 latency > 2 seconds
+├── Specific version crash spike
+├── Auth failure spike (attack?)
+└── Push delivery failure spike
+```
+
+---
+
+## 📝 MOBILE BACKEND CHECKLIST
+
+### Before API Design
+- [ ] Identified mobile-specific requirements?
+- [ ] Planned offline behavior?
+- [ ] Designed sync strategy?
+- [ ] Considered bandwidth constraints?
+
+### For Every Endpoint
+- [ ] Response as small as possible?
+- [ ] Pagination cursor-based?
+- [ ] Proper caching headers?
+- [ ] Mobile error format with actions?
+
+### Authentication
+- [ ] Token refresh implemented?
+- [ ] Silent re-auth flow?
+- [ ] Multi-device logout?
+- [ ] Secure token storage guidance?
+
+### Push Notifications
+- [ ] FCM + APNs configured?
+- [ ] Token lifecycle managed?
+- [ ] Silent vs display push defined?
+- [ ] Sensitive data NOT in push payload?
+
+### Release
+- [ ] Version check endpoint ready?
+- [ ] Feature flags configured?
+- [ ] Force update mechanism?
+- [ ] Monitoring headers required?
+
+---
+
+> **Remember:** Mobile backend must be resilient to bad networks, respect battery life, and handle interrupted sessions gracefully. The client cannot be trusted, but it also cannot be hung up—provide offline capabilities and clear error recovery paths.
diff --git a/.claude/skills/mobile-design/mobile-color-system.md b/.claude/skills/mobile-design/mobile-color-system.md
new file mode 100644
index 0000000..22276bc
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-color-system.md
@@ -0,0 +1,420 @@
+# Mobile Color System Reference
+
+> OLED optimization, dark mode, battery-aware colors, and outdoor visibility.
+> **Color on mobile isn't just aesthetics—it's battery life and usability.**
+
+---
+
+## 1. Mobile Color Fundamentals
+
+### Why Mobile Color is Different
+
+```
+DESKTOP:                           MOBILE:
+├── LCD screens (backlit)          ├── OLED common (self-emissive)
+├── Controlled lighting            ├── Outdoor, bright sun
+├── Stable power                   ├── Battery matters
+├── Personal preference            ├── System-wide dark mode
+└── Static viewing                 └── Variable angles, motion
+```
+
+### Mobile Color Priorities
+
+| Priority | Why |
+|----------|-----|
+| **1. Readability** | Outdoor, variable lighting |
+| **2. Battery efficiency** | OLED = dark mode saves power |
+| **3. System integration** | Dark/light mode support |
+| **4. Semantics** | Error, success, warning colors |
+| **5. Brand** | After functional requirements |
+
+---
+
+## 2. OLED Considerations
+
+### How OLED Differs
+
+```
+LCD (Liquid Crystal Display):
+├── Backlight always on
+├── Black = backlight through dark filter
+├── Energy use = constant
+└── Dark mode = no battery savings
+
+OLED (Organic LED):
+├── Each pixel emits own light
+├── Black = pixel OFF (zero power)
+├── Energy use = brighter pixels use more
+└── Dark mode = significant battery savings
+```
+
+### Battery Savings with OLED
+
+```
+Color energy consumption (relative):
+
+#000000 (True Black)  ████░░░░░░  0%
+#1A1A1A (Near Black)  █████░░░░░  ~15%
+#333333 (Dark Gray)   ██████░░░░  ~30%
+#666666 (Medium Gray) ███████░░░  ~50%
+#FFFFFF (White)       ██████████  100%
+
+Saturated colors also use significant power:
+├── Blue pixels: Most efficient
+├── Green pixels: Medium
+├── Red pixels: Least efficient
+└── Desaturated colors save more
+```
+
+### True Black vs Near Black
+
+```
+#000000 (True Black):
+├── Maximum battery savings
+├── Can cause "black smear" on scroll
+├── Sharp contrast (may be harsh)
+└── Used by Apple in pure dark mode
+
+#121212 or #1A1A1A (Near Black):
+├── Still good battery savings
+├── Smoother scrolling (no smear)
+├── Slightly softer on eyes
+└── Material Design recommendation
+
+RECOMMENDATION: #000000 for backgrounds, #0D0D0D-#1A1A1A for surfaces
+```
+
+---
+
+## 3. Dark Mode Design
+
+### Dark Mode Benefits
+
+```
+Users enable dark mode for:
+├── Battery savings (OLED)
+├── Reduced eye strain (low light)
+├── Personal preference
+├── AMOLED aesthetic
+└── Accessibility (light sensitivity)
+```
+
+### Dark Mode Color Strategy
+
+```
+LIGHT MODE                      DARK MODE
+──────────                      ─────────
+Background: #FFFFFF      →      #000000 or #121212
+Surface:    #F5F5F5      →      #1E1E1E
+Surface 2:  #EEEEEE      →      #2C2C2C
+
+Primary:    #1976D2      →      #90CAF9 (lighter)
+Text:       #212121      →      #E0E0E0 (not pure white)
+Secondary:  #757575      →      #9E9E9E
+
+Elevation in dark mode:
+├── Higher = slightly lighter surface
+├── 0dp →  0% overlay
+├── 4dp →  9% overlay
+├── 8dp →  12% overlay
+└── Creates depth without shadows
+```
+
+### Text Colors in Dark Mode
+
+| Role | Light Mode | Dark Mode |
+|------|------------|-----------|
+| Primary | #000000 (Black) | #E8E8E8 (Not pure white) |
+| Secondary | #666666 | #B0B0B0 |
+| Disabled | #9E9E9E | #6E6E6E |
+| Links | #1976D2 | #8AB4F8 |
+
+### Color Inversion Rules
+
+```
+DON'T just invert colors:
+├── Saturated colors become eye-burning
+├── Semantic colors lose meaning
+├── Brand colors may break
+└── Contrast ratios change unpredictably
+
+DO create intentional dark palette:
+├── Desaturate primary colors
+├── Use lighter tints for emphasis
+├── Maintain semantic color meanings
+├── Check contrast ratios independently
+```
+
+---
+
+## 4. Outdoor Visibility
+
+### The Sunlight Problem
+
+```
+Screen visibility outdoors:
+├── Bright sun washes out low contrast
+├── Glare reduces readability
+├── Polarized sunglasses affect
+└── Users shield screen with hand
+
+Affected elements:
+├── Light gray text on white
+├── Subtle color differences
+├── Low opacity overlays
+└── Pastel colors
+```
+
+### High Contrast Strategies
+
+```
+For outdoor visibility:
+
+MINIMUM CONTRAST RATIOS:
+├── Normal text: 4.5:1 (WCAG AA)
+├── Large text: 3:1 (WCAG AA)
+├── Recommended: 7:1+ (AAA)
+
+AVOID:
+├── #999 on #FFF (fails AA)
+├── #BBB on #FFF (fails)
+├── Pale colors on light backgrounds
+└── Subtle gradients for critical info
+
+DO:
+├── Use system semantic colors
+├── Test in bright environment
+├── Provide high contrast mode
+└── Use solid colors for critical UI
+```
+
+---
+
+## 5. Semantic Colors
+
+### Consistent Meaning
+
+| Semantic | Meaning | iOS Default | Android Default |
+|----------|---------|-------------|-----------------|
+| Error | Problems, destruction | #FF3B30 | #B3261E |
+| Success | Completion, positive | #34C759 | #4CAF50 |
+| Warning | Attention, caution | #FF9500 | #FFC107 |
+| Info | Information | #007AFF | #2196F3 |
+
+### Semantic Color Rules
+
+```
+NEVER use semantic colors for:
+├── Branding (confuses meaning)
+├── Decoration (reduces impact)
+├── Arbitrary styling
+└── Status indicators (use icons too)
+
+ALWAYS:
+├── Pair with icons (colorblind users)
+├── Maintain across light/dark modes
+├── Keep consistent throughout app
+└── Follow platform conventions
+```
+
+### Error State Colors
+
+```
+Error states need:
+├── Red-ish color (semantic)
+├── High contrast against background
+├── Icon reinforcement
+├── Clear text explanation
+
+iOS:
+├── Light: #FF3B30
+├── Dark: #FF453A
+
+Android:
+├── Light: #B3261E
+├── Dark: #F2B8B5 (on error container)
+```
+
+---
+
+## 6. Dynamic Color (Android)
+
+### Material You
+
+```
+Android 12+ Dynamic Color:
+
+User's wallpaper → Color extraction → App theme
+
+Your app automatically gets:
+├── Primary (from wallpaper dominant)
+├── Secondary (complementary)
+├── Tertiary (accent)
+├── Surface colors (neutral, derived)
+├── On-colors (text on each)
+```
+
+### Supporting Dynamic Color
+
+```kotlin
+// Jetpack Compose
+MaterialTheme(
+    colorScheme = dynamicColorScheme()
+        ?: staticColorScheme() // Fallback for older Android
+)
+
+// React Native
+// Limited support - consider react-native-material-you
+```
+
+### Fallback Colors
+
+```
+When dynamic color unavailable:
+├── Android < 12
+├── User disabled
+├── Non-supporting launchers
+
+Provide static color scheme:
+├── Define your brand colors
+├── Test in both modes
+├── Match dynamic color roles
+└── Support light + dark
+```
+
+---
+
+## 7. Color Accessibility
+
+### Colorblind Considerations
+
+```
+~8% of men, ~0.5% of women are colorblind
+
+Types:
+├── Protanopia (red weakness)
+├── Deuteranopia (green weakness)
+├── Tritanopia (blue weakness)
+├── Monochromacy (rare, no color)
+
+Design rules:
+├── Never rely on color alone
+├── Use patterns, icons, text
+├── Test with simulation tools
+├── Avoid red/green distinctions only
+```
+
+### Contrast Testing Tools
+
+```
+Use these to verify:
+├── Built-in accessibility inspector (Xcode)
+├── Accessibility Scanner (Android)
+├── Contrast ratio calculators
+├── Colorblind simulation
+└── Test on actual devices in sunlight
+```
+
+### Sufficient Contrast
+
+```
+WCAG Guidelines:
+
+AA (Minimum)
+├── Normal text: 4.5:1
+├── Large text (18pt+): 3:1
+├── UI components: 3:1
+
+AAA (Enhanced)
+├── Normal text: 7:1
+├── Large text: 4.5:1
+
+Mobile recommendation: Meet AA, aim for AAA
+```
+
+---
+
+## 8. Color Anti-Patterns
+
+### ❌ Common Mistakes
+
+| Mistake | Problem | Fix |
+|---------|---------|-----|
+| **Light gray on white** | Invisible outdoors | Min 4.5:1 contrast |
+| **Pure white in dark mode** | Eye strain | Use #E0E0E0-#F0F0F0 |
+| **Same saturation dark mode** | Garish, glowing | Desaturate colors |
+| **Red/green only indicator** | Colorblind users can't see | Add icons |
+| **Semantic colors for brand** | Confusing meaning | Use neutral for brand |
+| **Ignoring system dark mode** | Jarring experience | Support both modes |
+
+### ❌ AI Color Mistakes
+
+```
+AI tends to:
+├── Use same colors for light/dark
+├── Ignore OLED battery implications
+├── Skip contrast calculations
+├── Default to purple/violet (BANNED)
+├── Use low contrast "aesthetic" grays
+├── Not test in outdoor conditions
+└── Forget colorblind users
+
+RULE: Design for the worst case.
+Test in bright sunlight, with colorblindness simulation.
+```
+
+---
+
+## 9. Color System Checklist
+
+### Before Choosing Colors
+
+- [ ] Light and dark mode variants defined?
+- [ ] Contrast ratios checked (4.5:1+)?
+- [ ] OLED battery considered (dark mode)?
+- [ ] Semantic colors follow conventions?
+- [ ] Colorblind-safe (not color-only indicators)?
+
+### Before Release
+
+- [ ] Tested in bright sunlight?
+- [ ] Tested dark mode on OLED device?
+- [ ] System dark mode respected?
+- [ ] Dynamic color supported (Android)?
+- [ ] Error/success/warning consistent?
+- [ ] All text meets contrast requirements?
+
+---
+
+## 10. Quick Reference
+
+### Dark Mode Backgrounds
+
+```
+True black (OLED max savings): #000000
+Near black (Material):         #121212
+Surface 1:                     #1E1E1E
+Surface 2:                     #2C2C2C
+Surface 3:                     #3C3C3C
+```
+
+### Text on Dark
+
+```
+Primary:   #E0E0E0 to #ECECEC
+Secondary: #A0A0A0 to #B0B0B0
+Disabled:  #606060 to #707070
+```
+
+### Contrast Ratios
+
+```
+Small text:  4.5:1 (minimum)
+Large text:  3:1 (minimum)
+UI elements: 3:1 (minimum)
+Ideal:       7:1 (AAA)
+```
+
+---
+
+> **Remember:** Color on mobile must work in the worst conditions—bright sun, tired eyes, colorblindness, low battery. Pretty colors that fail these tests are useless colors.
diff --git a/.claude/skills/mobile-design/mobile-debugging.md b/.claude/skills/mobile-design/mobile-debugging.md
new file mode 100644
index 0000000..fb3679b
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-debugging.md
@@ -0,0 +1,122 @@
+# Mobile Debugging Guide
+
+> **Stop console.log() debugging!**
+> Mobile apps have complex native layers. Text logs are not enough.
+> **This file teaches effective mobile debugging strategies.**
+
+---
+
+## 🧠 MOBILE DEBUGGING MINDSET
+
+```
+Web Debugging:      Mobile Debugging:
+┌──────────────┐    ┌──────────────┐
+│  Browser     │    │  JS Bridge   │
+│  DevTools    │    │  Native UI   │
+│  Network Tab │    │  GPU/Memory  │
+└──────────────┘    │  Threads     │
+                    └──────────────┘
+```
+
+**Key Differences:**
+1.  **Native Layer:** JS code works, but app crashes? It's likely native (Java/Obj-C).
+2.  **Deployment:** You can't just "refresh". State gets lost or stuck.
+3.  **Network:** SSL Pinning, proxy settings are harder.
+4.  **Device Logs:** `adb logcat` and `Console.app` are your truth.
+
+---
+
+## 🚫 AI DEBUGGING ANTI-PATTERNS
+
+| ❌ Default | ✅ Mobile-Correct |
+|------------|-------------------|
+| "Add console.logs" | Use Flipper / Reactotron |
+| "Check network tab" | Use Charles Proxy / Proxyman |
+| "It works on simulator" | **Test on Real Device** (HW specific bugs) |
+| "Reinstall node_modules" | **Clean Native Build** (Gradle/Pod cache) |
+| Ignored native logs | Read `logcat` / Xcode logs |
+
+---
+
+## 1. The Toolset
+
+### ⚡ React Native & Expo
+
+| Tool | Purpose | Best For |
+|------|---------|----------|
+| **Reactotron** | State/API/Redux | JS side debugging |
+| **Flipper** | Layout/Network/db | Native + JS bridge |
+| **Expo Tools** | Element inspector | Quick UI checks |
+
+### 🛠️ Native Layer (The Deep Dive)
+
+| Tool | Platform | Command | Why Use? |
+|------|----------|---------|----------|
+| **Logcat** | Android | `adb logcat` | Native crashes, ANRs |
+| **Console** | iOS | via Xcode | Native exceptions, memory |
+| **Layout Insp.** | Android | Android Studio | UI hierarchy bugs |
+| **View Insp.** | iOS | Xcode | UI hierarchy bugs |
+
+---
+
+## 2. Common Debugging Workflows
+
+### 🕵️ "The App Just Crashed" (Red Screen vs Crash to Home)
+
+**Scenario A: Red Screen (JS Error)**
+- **Cause:** Undefined is not an object, import error.
+- **Fix:** Read the stack trace on screen. It's usually clear.
+
+**Scenario B: Crash to Home Screen (Native Crash)**
+- **Cause:** Native module failure, memory OOM, permission usage without declaration.
+- **Tools:**
+    - **Android:** `adb logcat *:E` (Filter for Errors)
+    - **iOS:** Open Xcode → Window → Devices → View Device Logs
+
+> **💡 Pro Tip:** If app crashes immediately on launch, it's almost 100% a native configuration issue (Info.plist, AndroidManifest.xml).
+
+### 🌐 "API Request Failed" (Network)
+
+**Web:** Open Chrome DevTools → Network.
+**Mobile:** *You usually can't see this easily.*
+
+**Solution 1: Reactotron/Flipper**
+- View network requests in the monitoring app.
+
+**Solution 2: Proxy (Charles/Proxyman)**
+- **Hard but powerful.** See ALL traffic even from native SDKs.
+- Requires installing SSL cert on device.
+
+### 🐢 "The UI is Laggy" (Performance)
+
+**Don't guess.** measure.
+- **React Native:** Performance Monitor (Shake menu).
+- **Android:** "Profile GPU Rendering" in Developer Options.
+- **Issues:**
+    - **JS FPS drop:** Heavy calculation in JS thread.
+    - **UI FPS drop:** Too many views, intricate hierarchy, heavy images.
+
+---
+
+## 3. Platform-Specific Nightmares
+
+### Android
+- **Gradle Sync Fail:** Usually Java version mismatch or duplicate classes.
+- **Emulator Network:** Emulator `localhost` is `10.0.2.2`, NOT `127.0.0.1`.
+- **Cached Builds:** `./gradlew clean` is your best friend.
+
+### iOS
+- **Pod Issues:** `pod deintegrate && pod install`.
+- **Signing Errors:** Check Team ID and Bundle Identifier.
+- **Cache:** Xcode → Product → Clean Build Folder.
+
+---
+
+## 📝 DEBUGGING CHECKLIST
+
+- [ ] **Is it a JS or Native crash?** (Red screen or home screen?)
+- [ ] **Did you clean build?** (Native caches are aggressive)
+- [ ] **Are you on a real device?** (Simulators hide concurrency bugs)
+- [ ] **Did you check the native logs?** (Not just terminal output)
+
+> **Remember:** If JavaScript looks perfect but the app fails, look closer at the Native side.
diff --git a/.claude/skills/mobile-design/mobile-design-thinking.md b/.claude/skills/mobile-design/mobile-design-thinking.md
new file mode 100644
index 0000000..399d3b2
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-design-thinking.md
@@ -0,0 +1,357 @@
+# Mobile Design Thinking
+
+> **This file prevents AI from using memorized patterns and forces genuine thinking.**
+> Mechanisms to prevent standard AI training defaults in mobile development.
+> **The mobile equivalent of frontend's layout decomposition approach.**
+
+---
+
+## 🧠 DEEP MOBILE THINKING PROTOCOL
+
+### This Process is Mandatory Before Every Mobile Project
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    DEEP MOBILE THINKING                         │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1️⃣ CONTEXT SCAN                                               │
+│     └── What are my assumptions for this project?               │
+│         └── QUESTION these assumptions                          │
+│                                                                 │
+│  2️⃣ ANTI-DEFAULT ANALYSIS                                      │
+│     └── Am I applying a memorized pattern?                      │
+│         └── Is this pattern REALLY the best for THIS project?   │
+│                                                                 │
+│  3️⃣ PLATFORM DECOMPOSITION                                     │
+│     └── Did I think about iOS and Android separately?           │
+│         └── What are the platform-specific patterns?            │
+│                                                                 │
+│  4️⃣ TOUCH INTERACTION BREAKDOWN                                │
+│     └── Did I analyze each interaction individually?            │
+│         └── Did I apply Fitts' Law, Thumb Zone?                 │
+│                                                                 │
+│  5️⃣ PERFORMANCE IMPACT ANALYSIS                                │
+│     └── Did I consider performance impact of each component?    │
+│         └── Is the default solution performant?                 │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🚫 AI MOBILE DEFAULTS (FORBIDDEN LIST)
+
+### Using These Patterns Automatically is FORBIDDEN!
+
+The following patterns are "defaults" that AIs learned from training data.
+Before using any of these, **QUESTION them and CONSIDER ALTERNATIVES!**
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                 🚫 AI MOBILE SAFE HARBOR                        │
+│           (Default Patterns - Never Use Without Questioning)    │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  NAVIGATION DEFAULTS:                                           │
+│  ├── Tab bar for every project (Would drawer be better?)        │
+│  ├── Fixed 5 tabs (Are 3 enough? For 6+, drawer?)               │
+│  ├── "Home" tab on left (What does user behavior say?)          │
+│  └── Hamburger menu (Is it outdated now?)                       │
+│                                                                 │
+│  STATE MANAGEMENT DEFAULTS:                                     │
+│  ├── Redux everywhere (Is Zustand/Jotai sufficient?)            │
+│  ├── Global state for everything (Isn't local state enough?)   │
+│  ├── Context Provider hell (Is atom-based better?)              │
+│  └── BLoC for every Flutter project (Is Riverpod more modern?)  │
+│                                                                 │
+│  LIST IMPLEMENTATION DEFAULTS:                                  │
+│  ├── FlatList as default (Is FlashList more performant?)        │
+│  ├── windowSize=21 (Is it really needed?)                       │
+│  ├── removeClippedSubviews (Always?)                            │
+│  └── ListView.builder (Is ListView.separated better?)           │
+│                                                                 │
+│  UI PATTERN DEFAULTS:                                           │
+│  ├── FAB bottom-right (Is bottom-left more accessible?)         │
+│  ├── Pull-to-refresh on every list (Is it needed everywhere?)   │
+│  ├── Swipe-to-delete from left (Is right better?)               │
+│  └── Bottom sheet for every modal (Is full screen better?)      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🔍 COMPONENT DECOMPOSITION (MANDATORY)
+
+### Decomposition Analysis for Every Screen
+
+Before designing any screen, perform this analysis:
+
+```
+SCREEN: [Screen Name]
+├── PRIMARY ACTION: [What is the main action?]
+│   └── Is it in thumb zone? [Yes/No → Why?]
+│
+├── TOUCH TARGETS: [All tappable elements]
+│   ├── [Element 1]: [Size]pt → Sufficient?
+│   ├── [Element 2]: [Size]pt → Sufficient?
+│   └── Spacing: [Gap]pt → Accidental tap risk?
+│
+├── SCROLLABLE CONTENT:
+│   ├── Is it a list? → FlatList/FlashList [Why this choice?]
+│   ├── Item count: ~[N] → Performance consideration?
+│   └── Fixed height? → Is getItemLayout needed?
+│
+├── STATE REQUIREMENTS:
+│   ├── Is local state sufficient?
+│   ├── Do I need to lift state?
+│   └── Is global required? [Why?]
+│
+├── PLATFORM DIFFERENCES:
+│   ├── iOS: [Anything different needed?]
+│   └── Android: [Anything different needed?]
+│
+├── OFFLINE CONSIDERATION:
+│   ├── Should this screen work offline?
+│   └── Cache strategy: [Yes/No/Which one?]
+│
+└── PERFORMANCE IMPACT:
+    ├── Any heavy components?
+    ├── Is memoization needed?
+    └── Animation performance?
+```
+
+---
+
+## 🎯 PATTERN QUESTIONING MATRIX
+
+Ask these questions for every default pattern:
+
+### Navigation Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "I'll use tab bar" | How many destinations? | 3 → minimal tabs, 6+ → drawer |
+| "5 tabs" | Are all equally important? | "More" tab? Drawer hybrid? |
+| "Bottom nav" | iPad/tablet support? | Navigation rail alternative |
+| "Stack navigation" | Did I consider deep links? | URL structure = navigation structure |
+
+### State Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "I'll use Redux" | How complex is the app? | Simple: Zustand, Server: TanStack |
+| "Global state" | Is this state really global? | Local lift, Context selector |
+| "Context Provider" | Will re-render be an issue? | Zustand, Jotai (atom-based) |
+| "BLoC pattern" | Is the boilerplate worth it? | Riverpod (less code) |
+
+### List Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "FlatList" | Is performance critical? | FlashList (faster) |
+| "Standard renderItem" | Is it memoized? | useCallback + React.memo |
+| "Index key" | Does data order change? | Use item.id |
+| "ListView" | Are there separators? | ListView.separated |
+
+### UI Pattern Questioning
+
+| Assumption | Question | Alternative |
+|------------|----------|-------------|
+| "FAB bottom-right" | User handedness? | Accessibility settings |
+| "Pull-to-refresh" | Does this list need refresh? | Only when necessary |
+| "Modal bottom sheet" | How much content? | Full screen modal might be better |
+| "Swipe actions" | Discoverability? | Visible button alternative |
+
+---
+
+## 🧪 ANTI-MEMORIZATION TEST
+
+### Ask Yourself Before Every Solution
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    ANTI-MEMORIZATION CHECKLIST                  │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  □ Did I pick this solution "because I always do it this way"?  │
+│    → If YES: STOP. Consider alternatives.                       │
+│                                                                 │
+│  □ Is this a pattern I've seen frequently in training data?     │
+│    → If YES: Is it REALLY suitable for THIS project?            │
+│                                                                 │
+│  □ Did I write this solution automatically without thinking?    │
+│    → If YES: Step back, do decomposition.                       │
+│                                                                 │
+│  □ Did I consider an alternative approach?                      │
+│    → If NO: Think of at least 2 alternatives, then decide.      │
+│                                                                 │
+│  □ Did I think platform-specifically?                           │
+│    → If NO: Analyze iOS and Android separately.                 │
+│                                                                 │
+│  □ Did I consider performance impact of this solution?          │
+│    → If NO: What is the memory, CPU, battery impact?            │
+│                                                                 │
+│  □ Is this solution suitable for THIS project's CONTEXT?        │
+│    → If NO: Customize based on context.                         │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📊 CONTEXT-BASED DECISION PROTOCOL
+
+### Think Differently Based on Project Type
+
+```
+DETERMINE PROJECT TYPE:
+        │
+        ├── E-Commerce App
+        │   ├── Navigation: Tab (Home, Search, Cart, Account)
+        │   ├── Lists: Product grids (memoized, image optimized)
+        │   ├── Performance: Image caching CRITICAL
+        │   ├── Offline: Cart persistence, product cache
+        │   └── Special: Checkout flow, payment security
+        │
+        ├── Social/Content App
+        │   ├── Navigation: Tab (Feed, Search, Create, Notify, Profile)
+        │   ├── Lists: Infinite scroll, complex items
+        │   ├── Performance: Feed rendering CRITICAL
+        │   ├── Offline: Feed cache, draft posts
+        │   └── Special: Real-time updates, media handling
+        │
+        ├── Productivity/SaaS App
+        │   ├── Navigation: Drawer or adaptive (mobile tab, tablet rail)
+        │   ├── Lists: Data tables, forms
+        │   ├── Performance: Data sync
+        │   ├── Offline: Full offline editing
+        │   └── Special: Conflict resolution, background sync
+        │
+        ├── Utility App
+        │   ├── Navigation: Minimal (stack-only possible)
+        │   ├── Lists: Probably minimal
+        │   ├── Performance: Fast startup
+        │   ├── Offline: Core feature offline
+        │   └── Special: Widget, shortcuts
+        │
+        └── Media/Streaming App
+            ├── Navigation: Tab (Home, Search, Library, Profile)
+            ├── Lists: Horizontal carousels, vertical feeds
+            ├── Performance: Preloading, buffering
+            ├── Offline: Download management
+            └── Special: Background playback, casting
+```
+
+---
+
+## 🔄 INTERACTION BREAKDOWN
+
+### Analysis for Every Gesture
+
+Before adding any gesture:
+
+```
+GESTURE: [Gesture Type]
+├── DISCOVERABILITY:
+│   └── How will users discover this gesture?
+│       ├── Is there a visual hint?
+│       ├── Will it be shown in onboarding?
+│       └── Is there a button alternative? (MANDATORY)
+│
+├── PLATFORM CONVENTION:
+│   ├── What does this gesture mean on iOS?
+│   ├── What does this gesture mean on Android?
+│   └── Am I deviating from platform convention?
+│
+├── ACCESSIBILITY:
+│   ├── Can motor-impaired users perform this gesture?
+│   ├── Is there a VoiceOver/TalkBack alternative?
+│   └── Does it work with switch control?
+│
+├── CONFLICT CHECK:
+│   ├── Does it conflict with system gestures?
+│   │   ├── iOS: Edge swipe back
+│   │   ├── Android: Back gesture
+│   │   └── Home indicator swipe
+│   └── Is it consistent with other app gestures?
+│
+└── FEEDBACK:
+    ├── Is haptic feedback defined?
+    ├── Is visual feedback sufficient?
+    └── Is audio feedback needed?
+```
+
+---
+
+## 🎭 SPIRIT OVER CHECKLIST (Mobile Edition)
+
+### Passing the Checklist is Not Enough!
+
+| ❌ Self-Deception | ✅ Honest Assessment |
+|-------------------|----------------------|
+| "Touch target is 44px" (but on edge, unreachable) | "Can user reach it one-handed?" |
+| "I used FlatList" (but didn't memoize) | "Is scroll smooth?" |
+| "Platform-specific nav" (but only icons differ) | "Does iOS feel like iOS, Android like Android?" |
+| "Offline support exists" (but error message is generic) | "What can user actually do offline?" |
+| "Loading state exists" (but just a spinner) | "Does user know how long to wait?" |
+
+> 🔴 **Passing the checklist is NOT the goal. Creating great mobile UX IS the goal.**
+
+---
+
+## 📝 MOBILE DESIGN COMMITMENT
+
+### Fill This at the Start of Every Mobile Project
+
+```
+📱 MOBILE DESIGN COMMITMENT
+
+Project: _______________
+Platform: iOS / Android / Both
+
+1. Default pattern I will NOT use in this project:
+   └── _______________
+   
+2. Context-specific focus for this project:
+   └── _______________
+
+3. Platform-specific differences I will implement:
+   └── iOS: _______________
+   └── Android: _______________
+
+4. Area I will specifically optimize for performance:
+   └── _______________
+
+5. Unique challenge of this project:
+   └── _______________
+
+🧠 If I can't fill this commitment → I don't understand the project well enough.
+   → Go back, understand context better, ask the user.
+```
+
+---
+
+## 🚨 MANDATORY: Before Every Mobile Work
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    PRE-WORK VALIDATION                          │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  □ Did I complete Component Decomposition?                      │
+│  □ Did I fill the Pattern Questioning Matrix?                   │
+│  □ Did I pass the Anti-Memorization Test?                       │
+│  □ Did I make context-based decisions?                          │
+│  □ Did I analyze Interaction Breakdown?                         │
+│  □ Did I fill the Mobile Design Commitment?                     │
+│                                                                 │
+│  ⚠️ Do not write code without completing these!                 │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+> **Remember:** If you chose a solution "because that's how it's always done," you chose WITHOUT THINKING. Every project is unique. Every context is different. Every user behavior is specific. **THINK, then code.**
diff --git a/.claude/skills/mobile-design/mobile-navigation.md b/.claude/skills/mobile-design/mobile-navigation.md
new file mode 100644
index 0000000..ef907bf
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-navigation.md
@@ -0,0 +1,458 @@
+# Mobile Navigation Reference
+
+> Navigation patterns, deep linking, back handling, and tab/stack/drawer decisions.
+> **Navigation is the skeleton of your app—get it wrong and everything feels broken.**
+
+---
+
+## 1. Navigation Selection Decision Tree
+
+```
+WHAT TYPE OF APP?
+        │
+        ├── 3-5 top-level sections (equal importance)
+        │   └── ✅ Tab Bar / Bottom Navigation
+        │       Examples: Social, E-commerce, Utility
+        │
+        ├── Deep hierarchical content (drill down)
+        │   └── ✅ Stack Navigation
+        │       Examples: Settings, Email folders
+        │
+        ├── Many destinations (>5 top-level)
+        │   └── ✅ Drawer Navigation
+        │       Examples: Gmail, complex enterprise
+        │
+        ├── Single linear flow
+        │   └── ✅ Stack only (wizard/onboarding)
+        │       Examples: Checkout, Setup flow
+        │
+        └── Tablet/Foldable
+            └── ✅ Navigation Rail + List-Detail
+                Examples: Mail, Notes on iPad
+```
+
+---
+
+## 2. Tab Bar Navigation
+
+### When to Use
+
+```
+✅ USE Tab Bar when:
+├── 3-5 top-level destinations
+├── Destinations are of equal importance
+├── User frequently switches between them
+├── Each tab has independent navigation stack
+└── App is used in short sessions
+
+❌ AVOID Tab Bar when:
+├── More than 5 destinations
+├── Destinations have clear hierarchy
+├── Tabs would be used very unequally
+└── Content flows in a sequence
+```
+
+### Tab Bar Best Practices
+
+```
+iOS Tab Bar:
+├── Height: 49pt (83pt with home indicator)
+├── Max items: 5
+├── Icons: SF Symbols, 25×25pt
+├── Labels: Always show (accessibility)
+├── Active indicator: Tint color
+
+Android Bottom Navigation:
+├── Height: 80dp
+├── Max items: 5 (3-5 ideal)
+├── Icons: Material Symbols, 24dp
+├── Labels: Always show
+├── Active indicator: Pill shape + filled icon
+```
+
+### Tab State Preservation
+
+```
+RULE: Each tab maintains its own navigation stack.
+
+User journey:
+1. Home tab → Drill into item → Add to cart
+2. Switch to Profile tab
+3. Switch back to Home tab
+→ Should return to "Add to cart" screen, NOT home root
+
+Implementation:
+├── React Navigation: Each tab has own navigator
+├── Flutter: IndexedStack for state preservation
+└── Never reset tab stack on switch
+```
+
+---
+
+## 3. Stack Navigation
+
+### Core Concepts
+
+```
+Stack metaphor: Cards stacked on top of each other
+
+Push: Add screen on top
+Pop: Remove top screen (back)
+Replace: Swap current screen
+Reset: Clear stack, set new root
+
+Visual: New screen slides in from right (LTR)
+Back: Screen slides out to right
+```
+
+### Stack Navigation Patterns
+
+| Pattern | Use Case | Implementation |
+|---------|----------|----------------|
+| **Simple Stack** | Linear flow | Push each step |
+| **Nested Stack** | Sections with sub-navigation | Stack inside tab |
+| **Modal Stack** | Focused tasks | Present modally |
+| **Auth Stack** | Login vs Main | Conditional root |
+
+### Back Button Handling
+
+```
+iOS:
+├── Edge swipe from left (system)
+├── Back button in nav bar (optional)
+├── Interactive pop gesture
+└── Never override swipe back without good reason
+
+Android:
+├── System back button/gesture
+├── Up button in toolbar (optional, for drill-down)
+├── Predictive back animation (Android 14+)
+└── Must handle back correctly (Activity/Fragment)
+
+Cross-Platform Rule:
+├── Back ALWAYS navigates up the stack
+├── Never hijack back for other purposes
+├── Confirm before discarding unsaved data
+└── Deep links should allow full back traversal
+```
+
+---
+
+## 4. Drawer Navigation
+
+### When to Use
+
+```
+✅ USE Drawer when:
+├── More than 5 top-level destinations
+├── Less frequently accessed destinations
+├── Complex app with many features
+├── Need for branding/user info in nav
+└── Tablet/large screen with persistent drawer
+
+❌ AVOID Drawer when:
+├── 5 or fewer destinations (use tabs)
+├── All destinations equally important
+├── Mobile-first simple app
+└── Discoverability is critical (drawer is hidden)
+```
+
+### Drawer Patterns
+
+```
+Modal Drawer:
+├── Opens over content (scrim behind)
+├── Swipe to open from edge
+├── Hamburger icon ( ☰ ) triggers
+└── Most common on mobile
+
+Permanent Drawer:
+├── Always visible (large screens)
+├── Content shifts over
+├── Good for productivity apps
+└── Tablets, desktops
+
+Navigation Rail (Android):
+├── Narrow vertical strip
+├── Icons + optional labels
+├── For tablets in portrait
+└── 80dp width
+```
+
+---
+
+## 5. Modal Navigation
+
+### Modal vs Push
+
+```
+PUSH (Stack):                    MODAL:
+├── Horizontal slide             ├── Vertical slide up (sheet)
+├── Part of hierarchy            ├── Separate task
+├── Back returns                 ├── Dismiss (X) returns
+├── Same navigation context      ├── Own navigation context
+└── "Drill in"                   └── "Focus on task"
+
+USE MODAL for:
+├── Creating new content
+├── Settings/preferences
+├── Completing a transaction
+├── Self-contained workflows
+├── Quick actions
+```
+
+### Modal Types
+
+| Type | iOS | Android | Use Case |
+|------|-----|---------|----------|
+| **Sheet** | `.sheet` | Bottom Sheet | Quick tasks |
+| **Full Screen** | `.fullScreenCover` | Full Activity | Complex forms |
+| **Alert** | Alert | Dialog | Confirmations |
+| **Action Sheet** | Action Sheet | Menu/Bottom Sheet | Choose from options |
+
+### Modal Dismissal
+
+```
+Users expect to dismiss modals by:
+├── Tapping X / Close button
+├── Swiping down (sheet)
+├── Tapping scrim (non-critical)
+├── System back (Android)
+├── Hardware back (old Android)
+
+RULE: Only block dismissal for unsaved data.
+```
+
+---
+
+## 6. Deep Linking
+
+### Why Deep Links from Day One
+
+```
+Deep links enable:
+├── Push notification navigation
+├── Sharing content
+├── Marketing campaigns
+├── Spotlight/Search integration
+├── Widget navigation
+├── External app integration
+
+Building later is HARD:
+├── Requires navigation refactor
+├── Screen dependencies unclear
+├── Parameter passing complex
+└── Always plan deep links at start
+```
+
+### URL Structure
+
+```
+Scheme://host/path?params
+
+Examples:
+├── myapp://product/123
+├── https://myapp.com/product/123 (Universal/App Link)
+├── myapp://checkout?promo=SAVE20
+├── myapp://tab/profile/settings
+
+Hierarchy should match navigation:
+├── myapp://home
+├── myapp://home/product/123
+├── myapp://home/product/123/reviews
+└── URL path = navigation path
+```
+
+### Deep Link Navigation Rules
+
+```
+1. FULL STACK CONSTRUCTION
+   Deep link to myapp://product/123 should:
+   ├── Put Home at root of stack
+   ├── Push Product screen on top
+   └── Back button returns to Home
+
+2. AUTHENTICATION AWARENESS
+   If deep link requires auth:
+   ├── Save intended destination
+   ├── Redirect to login
+   ├── After login, navigate to destination
+
+3. INVALID LINKS
+   If deep link target doesn't exist:
+   ├── Navigate to fallback (home)
+   ├── Show error message
+   └── Never crash or blank screen
+
+4. STATEFUL NAVIGATION
+   Deep link during active session:
+   ├── Don't blow away current stack
+   ├── Push on top OR
+   ├── Ask user if should navigate away
+```
+
+---
+
+## 7. Navigation State Persistence
+
+### What to Persist
+
+```
+SHOULD persist:
+├── Current tab selection
+├── Scroll position in lists
+├── Form draft data
+├── Recent navigation stack
+└── User preferences
+
+SHOULD NOT persist:
+├── Modal states (dialogs)
+├── Temporary UI states
+├── Stale data (refresh on return)
+├── Authentication state (use secure storage)
+```
+
+### Implementation
+
+```javascript
+// React Navigation - State Persistence
+const [isReady, setIsReady] = useState(false);
+const [initialState, setInitialState] = useState();
+
+useEffect(() => {
+  const loadState = async () => {
+    const savedState = await AsyncStorage.getItem('NAV_STATE');
+    if (savedState) setInitialState(JSON.parse(savedState));
+    setIsReady(true);
+  };
+  loadState();
+}, []);
+
+const handleStateChange = (state) => {
+  AsyncStorage.setItem('NAV_STATE', JSON.stringify(state));
+};
+
+<NavigationContainer
+  initialState={initialState}
+  onStateChange={handleStateChange}
+>
+```
+
+---
+
+## 8. Transition Animations
+
+### Platform Defaults
+
+```
+iOS Transitions:
+├── Push: Slide from right
+├── Modal: Slide from bottom (sheet) or fade
+├── Tab switch: Cross-fade
+├── Interactive: Swipe to go back
+
+Android Transitions:
+├── Push: Fade + slide from right
+├── Modal: Slide from bottom
+├── Tab switch: Cross-fade or none
+├── Shared element: Hero animations
+```
+
+### Custom Transitions
+
+```
+When to custom:
+├── Brand identity requires it
+├── Shared element connections
+├── Special reveal effects
+└── Keep it subtle, <300ms
+
+When to use default:
+├── Most of the time
+├── Standard drill-down
+├── Platform consistency
+└── Performance critical paths
+```
+
+### Shared Element Transitions
+
+```
+Connect elements between screens:
+
+Screen A: Product card with image
+            ↓ (tap)
+Screen B: Product detail with same image (expanded)
+
+Image animates from card position to detail position.
+
+Implementation:
+├── React Navigation: shared element library
+├── Flutter: Hero widget
+├── SwiftUI: matchedGeometryEffect
+└── Compose: Shared element transitions
+```
+
+---
+
+## 9. Navigation Anti-Patterns
+
+### ❌ Navigation Sins
+
+| Anti-Pattern | Problem | Solution |
+|--------------|---------|----------|
+| **Inconsistent back** | User confused, can't predict | Always pop stack |
+| **Hidden navigation** | Features undiscoverable | Visible tabs/drawer trigger |
+| **Deep nesting** | User gets lost | Max 3-4 levels, breadcrumbs |
+| **Breaking swipe back** | iOS users frustrated | Never override gesture |
+| **No deep links** | Can't share, bad notifications | Plan from start |
+| **Tab stack reset** | Work lost on switch | Preserve tab states |
+| **Modal for primary flow** | Can't back track | Use stack navigation |
+
+### ❌ AI Navigation Mistakes
+
+```
+AI tends to:
+├── Use modals for everything (wrong)
+├── Forget tab state preservation (wrong)
+├── Skip deep linking (wrong)
+├── Override platform back behavior (wrong)
+├── Reset stack on tab switch (wrong)
+└── Ignore predictive back (Android 14+)
+
+RULE: Use platform navigation patterns.
+Don't reinvent navigation.
+```
+
+---
+
+## 10. Navigation Checklist
+
+### Before Navigation Architecture
+
+- [ ] App type determined (tabs/drawer/stack)
+- [ ] Number of top-level destinations counted
+- [ ] Deep link URL scheme planned
+- [ ] Auth flow integrated with navigation
+- [ ] Tablet/large screen considered
+
+### Before Every Screen
+
+- [ ] Can user navigate back? (not dead end)
+- [ ] Deep link to this screen planned
+- [ ] State preserved on navigate away/back
+- [ ] Transition appropriate for relationship
+- [ ] Auth required? Handled?
+
+### Before Release
+
+- [ ] All deep links tested
+- [ ] Back button works everywhere
+- [ ] Tab states preserved correctly
+- [ ] Edge swipe back works (iOS)
+- [ ] Predictive back works (Android 14+)
+- [ ] Universal/App links configured
+- [ ] Push notification deep links work
+
+---
+
+> **Remember:** Navigation is invisible when done right. Users shouldn't think about HOW to get somewhere—they just get there. If they notice navigation, something is wrong.
diff --git a/.claude/skills/mobile-design/mobile-performance.md b/.claude/skills/mobile-design/mobile-performance.md
new file mode 100644
index 0000000..dafa174
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-performance.md
@@ -0,0 +1,767 @@
+# Mobile Performance Reference
+
+> Deep dive into React Native and Flutter performance optimization, 60fps animations, memory management, and battery considerations.
+> **This file covers the #1 area where AI-generated code FAILS.**
+
+---
+
+## 1. The Mobile Performance Mindset
+
+### Why Mobile Performance is Different
+
+```
+DESKTOP:                          MOBILE:
+├── Unlimited power               ├── Battery matters
+├── Abundant RAM                  ├── RAM is shared, limited
+├── Stable network                ├── Network is unreliable
+├── CPU always available          ├── CPU throttles when hot
+└── User expects fast anyway      └── User expects INSTANT
+```
+
+### Performance Budget Concept
+
+```
+Every frame must complete in:
+├── 60fps → 16.67ms per frame
+├── 120fps (ProMotion) → 8.33ms per frame
+
+If your code takes longer:
+├── Frame drops → Janky scroll/animation
+├── User perceives as "slow" or "broken"
+└── They WILL uninstall your app
+```
+
+---
+
+## 2. React Native Performance
+
+### 🚫 The #1 AI Mistake: ScrollView for Lists
+
+```javascript
+// ❌ NEVER DO THIS - AI's favorite mistake
+<ScrollView>
+  {items.map(item => (
+    <ItemComponent key={item.id} item={item} />
+  ))}
+</ScrollView>
+
+// Why it's catastrophic:
+// ├── Renders ALL items immediately (1000 items = 1000 renders)
+// ├── Memory explodes
+// ├── Initial render takes seconds
+// └── Scroll becomes janky
+
+// ✅ ALWAYS USE FlatList
+<FlatList
+  data={items}
+  renderItem={renderItem}
+  keyExtractor={item => item.id}
+/>
+```
+
+### FlatList Optimization Checklist
+
+```javascript
+// ✅ CORRECT: All optimizations applied
+
+// 1. Memoize the item component
+const ListItem = React.memo(({ item }: { item: Item }) => {
+  return (
+    <Pressable style={styles.item}>
+      <Text>{item.title}</Text>
+    </Pressable>
+  );
+});
+
+// 2. Memoize renderItem with useCallback
+const renderItem = useCallback(
+  ({ item }: { item: Item }) => <ListItem item={item} />,
+  [] // Empty deps = never recreated
+);
+
+// 3. Stable keyExtractor (NEVER use index!)
+const keyExtractor = useCallback((item: Item) => item.id, []);
+
+// 4. Provide getItemLayout for fixed-height items
+const getItemLayout = useCallback(
+  (data: Item[] | null, index: number) => ({
+    length: ITEM_HEIGHT, // Fixed height
+    offset: ITEM_HEIGHT * index,
+    index,
+  }),
+  []
+);
+
+// 5. Apply to FlatList
+<FlatList
+  data={items}
+  renderItem={renderItem}
+  keyExtractor={keyExtractor}
+  getItemLayout={getItemLayout}
+  // Performance props
+  removeClippedSubviews={true} // Android: detach off-screen
+  maxToRenderPerBatch={10} // Items per batch
+  windowSize={5} // Render window (5 = 2 screens each side)
+  initialNumToRender={10} // Initial items
+  updateCellsBatchingPeriod={50} // Batching delay
+/>
+```
+
+### Why Each Optimization Matters
+
+| Optimization | What It Prevents | Impact |
+|--------------|------------------|--------|
+| `React.memo` | Re-render on parent change | 🔴 Critical |
+| `useCallback renderItem` | New function every render | 🔴 Critical |
+| Stable `keyExtractor` | Wrong item recycling | 🔴 Critical |
+| `getItemLayout` | Async layout calculation | 🟡 High |
+| `removeClippedSubviews` | Memory from off-screen | 🟡 High |
+| `maxToRenderPerBatch` | Blocking main thread | 🟢 Medium |
+| `windowSize` | Memory usage | 🟢 Medium |
+
+### FlashList: The Better Option
+
+```javascript
+// Consider FlashList for better performance
+import { FlashList } from "@shopify/flash-list";
+
+<FlashList
+  data={items}
+  renderItem={renderItem}
+  estimatedItemSize={ITEM_HEIGHT}
+  keyExtractor={keyExtractor}
+/>
+
+// Benefits over FlatList:
+// ├── Faster recycling
+// ├── Better memory management
+// ├── Simpler API
+// └── Fewer optimization props needed
+```
+
+### Animation Performance
+
+```javascript
+// ❌ JS-driven animation (blocks JS thread)
+Animated.timing(value, {
+  toValue: 1,
+  duration: 300,
+  useNativeDriver: false, // BAD!
+}).start();
+
+// ✅ Native-driver animation (runs on UI thread)
+Animated.timing(value, {
+  toValue: 1,
+  duration: 300,
+  useNativeDriver: true, // GOOD!
+}).start();
+
+// Native driver supports ONLY:
+// ├── transform (translate, scale, rotate)
+// └── opacity
+// 
+// Does NOT support:
+// ├── width, height
+// ├── backgroundColor
+// ├── borderRadius changes
+// └── margin, padding
+```
+
+### Reanimated for Complex Animations
+
+```javascript
+// For animations native driver can't handle, use Reanimated 3
+
+import Animated, {
+  useSharedValue,
+  useAnimatedStyle,
+  withSpring,
+} from 'react-native-reanimated';
+
+const Component = () => {
+  const offset = useSharedValue(0);
+
+  const animatedStyles = useAnimatedStyle(() => ({
+    transform: [{ translateX: withSpring(offset.value) }],
+  }));
+
+  return <Animated.View style={animatedStyles} />;
+};
+
+// Benefits:
+// ├── Runs on UI thread (60fps guaranteed)
+// ├── Can animate any property
+// ├── Gesture-driven animations
+// └── Worklets for complex logic
+```
+
+### Memory Leak Prevention
+
+```javascript
+// ❌ Memory leak: uncleared interval
+useEffect(() => {
+  const interval = setInterval(() => {
+    fetchData();
+  }, 5000);
+  // Missing cleanup!
+}, []);
+
+// ✅ Proper cleanup
+useEffect(() => {
+  const interval = setInterval(() => {
+    fetchData();
+  }, 5000);
+  
+  return () => clearInterval(interval); // CLEANUP!
+}, []);
+
+// Common memory leak sources:
+// ├── Timers (setInterval, setTimeout)
+// ├── Event listeners
+// ├── Subscriptions (WebSocket, PubSub)
+// ├── Async operations that update state after unmount
+// └── Image caching without limits
+```
+
+### React Native Performance Checklist
+
+```markdown
+## Before Every List
+- [ ] Using FlatList or FlashList (NOT ScrollView)
+- [ ] renderItem is useCallback memoized
+- [ ] List items are React.memo wrapped
+- [ ] keyExtractor uses stable ID (NOT index)
+- [ ] getItemLayout provided (if fixed height)
+
+## Before Every Animation
+- [ ] useNativeDriver: true (if possible)
+- [ ] Using Reanimated for complex animations
+- [ ] Only animating transform/opacity
+- [ ] Tested on low-end Android device
+
+## Before Any Release
+- [ ] console.log statements removed
+- [ ] Cleanup functions in all useEffects
+- [ ] No memory leaks (test with profiler)
+- [ ] Tested in release build (not dev)
+```
+
+---
+
+## 3. Flutter Performance
+
+### 🚫 The #1 AI Mistake: setState Overuse
+
+```dart
+// ❌ WRONG: setState rebuilds ENTIRE widget tree
+class BadCounter extends StatefulWidget {
+  @override
+  State<BadCounter> createState() => _BadCounterState();
+}
+
+class _BadCounterState extends State<BadCounter> {
+  int _counter = 0;
+  
+  void _increment() {
+    setState(() {
+      _counter++; // This rebuilds EVERYTHING below!
+    });
+  }
+  
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Text('Counter: $_counter'),
+        ExpensiveWidget(), // Rebuilds unnecessarily!
+        AnotherExpensiveWidget(), // Rebuilds unnecessarily!
+      ],
+    );
+  }
+}
+```
+
+### The `const` Constructor Revolution
+
+```dart
+// ✅ CORRECT: const prevents rebuilds
+
+class GoodCounter extends StatefulWidget {
+  const GoodCounter({super.key}); // CONST constructor!
+  
+  @override
+  State<GoodCounter> createState() => _GoodCounterState();
+}
+
+class _GoodCounterState extends State<GoodCounter> {
+  int _counter = 0;
+  
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Text('Counter: $_counter'),
+        const ExpensiveWidget(), // Won't rebuild!
+        const AnotherExpensiveWidget(), // Won't rebuild!
+      ],
+    );
+  }
+}
+
+// RULE: Add `const` to EVERY widget that doesn't depend on state
+```
+
+### Targeted State Management
+
+```dart
+// ❌ setState rebuilds whole tree
+setState(() => _value = newValue);
+
+// ✅ ValueListenableBuilder: surgical rebuilds
+class TargetedState extends StatelessWidget {
+  final ValueNotifier<int> counter = ValueNotifier(0);
+  
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        // Only this rebuilds when counter changes
+        ValueListenableBuilder<int>(
+          valueListenable: counter,
+          builder: (context, value, child) => Text('$value'),
+          child: const Icon(Icons.star), // Won't rebuild!
+        ),
+        const ExpensiveWidget(), // Never rebuilds
+      ],
+    );
+  }
+}
+```
+
+### Riverpod/Provider Best Practices
+
+```dart
+// ❌ WRONG: Reading entire provider in build
+Widget build(BuildContext context) {
+  final state = ref.watch(myProvider); // Rebuilds on ANY change
+  return Text(state.name);
+}
+
+// ✅ CORRECT: Select only what you need
+Widget build(BuildContext context) {
+  final name = ref.watch(myProvider.select((s) => s.name));
+  return Text(name); // Only rebuilds when name changes
+}
+```
+
+### ListView Optimization
+
+```dart
+// ❌ WRONG: ListView without builder (renders all)
+ListView(
+  children: items.map((item) => ItemWidget(item)).toList(),
+)
+
+// ✅ CORRECT: ListView.builder (lazy rendering)
+ListView.builder(
+  itemCount: items.length,
+  itemBuilder: (context, index) => ItemWidget(items[index]),
+  // Additional optimizations:
+  itemExtent: 56, // Fixed height = faster layout
+  cacheExtent: 100, // Pre-render distance
+)
+
+// ✅ EVEN BETTER: ListView.separated for dividers
+ListView.separated(
+  itemCount: items.length,
+  itemBuilder: (context, index) => ItemWidget(items[index]),
+  separatorBuilder: (context, index) => const Divider(),
+)
+```
+
+### Image Optimization
+
+```dart
+// ❌ WRONG: No caching, full resolution
+Image.network(url)
+
+// ✅ CORRECT: Cached with proper sizing
+CachedNetworkImage(
+  imageUrl: url,
+  width: 100,
+  height: 100,
+  fit: BoxFit.cover,
+  memCacheWidth: 200, // Cache at 2x for retina
+  memCacheHeight: 200,
+  placeholder: (context, url) => const Skeleton(),
+  errorWidget: (context, url, error) => const Icon(Icons.error),
+)
+```
+
+### Dispose Pattern
+
+```dart
+class MyWidget extends StatefulWidget {
+  @override
+  State<MyWidget> createState() => _MyWidgetState();
+}
+
+class _MyWidgetState extends State<MyWidget> {
+  late final StreamSubscription _subscription;
+  late final AnimationController _controller;
+  late final TextEditingController _textController;
+  
+  @override
+  void initState() {
+    super.initState();
+    _subscription = stream.listen((_) {});
+    _controller = AnimationController(vsync: this);
+    _textController = TextEditingController();
+  }
+  
+  @override
+  void dispose() {
+    // ALWAYS dispose in reverse order of creation
+    _textController.dispose();
+    _controller.dispose();
+    _subscription.cancel();
+    super.dispose();
+  }
+  
+  @override
+  Widget build(BuildContext context) => Container();
+}
+```
+
+### Flutter Performance Checklist
+
+```markdown
+## Before Every Widget
+- [ ] const constructor added (if no runtime args)
+- [ ] const keywords on static children
+- [ ] Minimal setState scope
+- [ ] Using selectors for provider watches
+
+## Before Every List
+- [ ] Using ListView.builder (NOT ListView with children)
+- [ ] itemExtent provided (if fixed height)
+- [ ] Image caching with size limits
+
+## Before Any Animation
+- [ ] Using Impeller (Flutter 3.16+)
+- [ ] Avoiding Opacity widget (use FadeTransition)
+- [ ] TickerProviderStateMixin for AnimationController
+
+## Before Any Release
+- [ ] All dispose() methods implemented
+- [ ] No print() in production
+- [ ] Tested in profile/release mode
+- [ ] DevTools performance overlay checked
+```
+
+---
+
+## 4. Animation Performance (Both Platforms)
+
+### The 60fps Imperative
+
+```
+Human eye detects:
+├── < 24 fps → "Slideshow" (broken)
+├── 24-30 fps → "Choppy" (uncomfortable)
+├── 30-45 fps → "Noticeably not smooth"
+├── 45-60 fps → "Smooth" (acceptable)
+├── 60 fps → "Buttery" (target)
+└── 120 fps → "Premium" (ProMotion devices)
+
+NEVER ship < 60fps animations.
+```
+
+### GPU vs CPU Animation
+
+```
+GPU-ACCELERATED (FAST):          CPU-BOUND (SLOW):
+├── transform: translate          ├── width, height
+├── transform: scale              ├── top, left, right, bottom
+├── transform: rotate             ├── margin, padding
+├── opacity                       ├── border-radius (animated)
+└── (Composited, off main)        └── box-shadow (animated)
+
+RULE: Only animate transform and opacity.
+Everything else causes layout recalculation.
+```
+
+### Animation Timing Guide
+
+| Animation Type | Duration | Easing |
+|----------------|----------|--------|
+| Micro-interaction | 100-200ms | ease-out |
+| Standard transition | 200-300ms | ease-out |
+| Page transition | 300-400ms | ease-in-out |
+| Complex/dramatic | 400-600ms | ease-in-out |
+| Loading skeletons | 1000-1500ms | linear (loop) |
+
+### Spring Physics
+
+```javascript
+// React Native Reanimated
+withSpring(targetValue, {
+  damping: 15,      // How quickly it settles (higher = faster stop)
+  stiffness: 150,   // How "tight" the spring (higher = faster)
+  mass: 1,          // Weight of the object
+})
+
+// Flutter
+SpringSimulation(
+  SpringDescription(
+    mass: 1,
+    stiffness: 150,
+    damping: 15,
+  ),
+  start,
+  end,
+  velocity,
+)
+
+// Natural feel ranges:
+// Damping: 10-20 (bouncy to settled)
+// Stiffness: 100-200 (loose to tight)
+// Mass: 0.5-2 (light to heavy)
+```
+
+---
+
+## 5. Memory Management
+
+### Common Memory Leaks
+
+| Source | Platform | Solution |
+|--------|----------|----------|
+| Timers | Both | Clear in cleanup/dispose |
+| Event listeners | Both | Remove in cleanup/dispose |
+| Subscriptions | Both | Cancel in cleanup/dispose |
+| Large images | Both | Limit cache, resize |
+| Async after unmount | RN | isMounted check or AbortController |
+| Animation controllers | Flutter | Dispose controllers |
+
+### Image Memory
+
+```
+Image memory = width × height × 4 bytes (RGBA)
+
+1080p image = 1920 × 1080 × 4 = 8.3 MB
+4K image = 3840 × 2160 × 4 = 33.2 MB
+
+10 4K images = 332 MB → App crash!
+
+RULE: Always resize images to display size (or 2-3x for retina).
+```
+
+### Memory Profiling
+
+```
+React Native:
+├── Flipper → Memory tab
+├── Xcode Instruments (iOS)
+└── Android Studio Profiler
+
+Flutter:
+├── DevTools → Memory tab
+├── Observatory
+└── flutter run --profile
+```
+
+---
+
+## 6. Battery Optimization
+
+### Battery Drain Sources
+
+| Source | Impact | Mitigation |
+|--------|--------|------------|
+| **Screen on** | 🔴 Highest | Dark mode on OLED |
+| **GPS continuous** | 🔴 Very high | Use significant change |
+| **Network requests** | 🟡 High | Batch, cache aggressively |
+| **Animations** | 🟡 Medium | Reduce when low battery |
+| **Background work** | 🟡 Medium | Defer non-critical |
+| **CPU computation** | 🟢 Lower | Offload to backend |
+
+### OLED Battery Saving
+
+```
+OLED screens: Black pixels = OFF = 0 power
+
+Dark mode savings:
+├── True black (#000000) → Maximum savings
+├── Dark gray (#1a1a1a) → Slight savings
+├── Any color → Some power
+└── White (#FFFFFF) → Maximum power
+
+RULE: On dark mode, use true black for backgrounds.
+```
+
+### Background Task Guidelines
+
+```
+iOS:
+├── Background refresh: Limited, system-scheduled
+├── Push notifications: Use for important updates
+├── Background modes: Location, audio, VoIP only
+└── Background tasks: Max ~30 seconds
+
+Android:
+├── WorkManager: System-scheduled, battery-aware
+├── Foreground service: Visible to user, continuous
+├── JobScheduler: Batch network operations
+└── Doze mode: Respect it, batch operations
+```
+
+---
+
+## 7. Network Performance
+
+### Offline-First Architecture
+
+```
+                    ┌──────────────┐
+                    │     UI       │
+                    └──────┬───────┘
+                           │
+                    ┌──────▼───────┐
+                    │   Cache      │ ← Read from cache FIRST
+                    └──────┬───────┘
+                           │
+                    ┌──────▼───────┐
+                    │   Network    │ ← Update cache from network
+                    └──────────────┘
+
+Benefits:
+├── Instant UI (no loading spinner for cached data)
+├── Works offline
+├── Reduces data usage
+└── Better UX on slow networks
+```
+
+### Request Optimization
+
+```
+BATCH: Combine multiple requests into one
+├── 10 small requests → 1 batch request
+├── Reduces connection overhead
+└── Better for battery (radio on once)
+
+CACHE: Don't re-fetch unchanged data
+├── ETag/If-None-Match headers
+├── Cache-Control headers
+└── Stale-while-revalidate pattern
+
+COMPRESS: Reduce payload size
+├── gzip/brotli compression
+├── Request only needed fields (GraphQL)
+└── Paginate large lists
+```
+
+---
+
+## 8. Performance Testing
+
+### What to Test
+
+| Metric | Target | Tool |
+|--------|--------|------|
+| **Frame rate** | ≥ 60fps | Performance overlay |
+| **Memory** | Stable, no growth | Profiler |
+| **Cold start** | < 2s | Manual timing |
+| **TTI (Time to Interactive)** | < 3s | Lighthouse |
+| **List scroll** | No jank | Manual feel |
+| **Animation smoothness** | No drops | Performance monitor |
+
+### Test on Real Devices
+
+```
+⚠️ NEVER trust only:
+├── Simulator/emulator (faster than real)
+├── Dev mode (slower than release)
+├── High-end devices only
+
+✅ ALWAYS test on:
+├── Low-end Android (< $200 phone)
+├── Older iOS device (iPhone 8 or SE)
+├── Release/profile build
+└── With real data (not 10 items)
+```
+
+### Performance Monitoring Checklist
+
+```markdown
+## During Development
+- [ ] Performance overlay enabled
+- [ ] Watching for dropped frames
+- [ ] Memory usage stable
+- [ ] No console warnings about performance
+
+## Before Release
+- [ ] Tested on low-end device
+- [ ] Profiled memory over extended use
+- [ ] Cold start time measured
+- [ ] List scroll tested with 1000+ items
+- [ ] Animations tested at 60fps
+- [ ] Network tested on slow 3G
+```
+
+---
+
+## 9. Quick Reference Card
+
+### React Native Essentials
+
+```javascript
+// List: Always use
+<FlatList
+  data={data}
+  renderItem={useCallback(({item}) => <MemoItem item={item} />, [])}
+  keyExtractor={useCallback(item => item.id, [])}
+  getItemLayout={useCallback((_, i) => ({length: H, offset: H*i, index: i}), [])}
+/>
+
+// Animation: Always native
+useNativeDriver: true
+
+// Cleanup: Always present
+useEffect(() => {
+  return () => cleanup();
+}, []);
+```
+
+### Flutter Essentials
+
+```dart
+// Widgets: Always const
+const MyWidget()
+
+// Lists: Always builder
+ListView.builder(itemBuilder: ...)
+
+// State: Always targeted
+ValueListenableBuilder() or ref.watch(provider.select(...))
+
+// Dispose: Always cleanup
+@override
+void dispose() {
+  controller.dispose();
+  super.dispose();
+}
+```
+
+### Animation Targets
+
+```
+Transform/Opacity only ← What to animate
+16.67ms per frame ← Time budget
+60fps minimum ← Target
+Low-end Android ← Test device
+```
+
+---
+
+> **Remember:** Performance is not optimization—it's baseline quality. A slow app is a broken app. Test on the worst device your users have, not the best device you have.
diff --git a/.claude/skills/mobile-design/mobile-testing.md b/.claude/skills/mobile-design/mobile-testing.md
new file mode 100644
index 0000000..733f64a
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-testing.md
@@ -0,0 +1,356 @@
+# Mobile Testing Patterns
+
+> **Mobile testing is NOT web testing. Different constraints, different strategies.**
+> This file teaches WHEN to use each testing approach and WHY.
+> **Code examples are minimal - focus on decision-making.**
+
+---
+
+## 🧠 MOBILE TESTING MINDSET
+
+```
+Mobile testing differs from web:
+├── Real devices matter (emulators hide bugs)
+├── Platform differences (iOS vs Android behavior)
+├── Network conditions vary wildly
+├── Battery/performance under test
+├── App lifecycle (background, killed, restored)
+├── Permissions and system dialogs
+└── Touch interactions vs clicks
+```
+
+---
+
+## 🚫 AI MOBILE TESTING ANTI-PATTERNS
+
+| ❌ AI Default | Why It's Wrong | ✅ Mobile-Correct |
+|---------------|----------------|-------------------|
+| Jest-only testing | Misses native layer | Jest + E2E on device |
+| Enzyme patterns | Deprecated, web-focused | React Native Testing Library |
+| Browser-based E2E (Cypress) | Can't test native features | Detox / Maestro |
+| Mock everything | Misses integration bugs | Real device testing |
+| Ignore platform tests | iOS/Android differ | Platform-specific cases |
+| Skip performance tests | Mobile perf is critical | Profile on low-end device |
+| Test only happy path | Mobile has more edge cases | Offline, permissions, interrupts |
+| 100% unit test coverage | False security | Pyramid balance |
+| Copy web testing patterns | Different environment | Mobile-specific tools |
+
+---
+
+## 1. Testing Tool Selection
+
+### Decision Tree
+
+```
+WHAT ARE YOU TESTING?
+        │
+        ├── Pure functions, utilities, helpers
+        │   └── Jest (unit tests)
+        │       └── No special mobile setup needed
+        │
+        ├── Individual components (isolated)
+        │   ├── React Native → React Native Testing Library
+        │   └── Flutter → flutter_test (widget tests)
+        │
+        ├── Components with hooks, context, navigation
+        │   ├── React Native → RNTL + mocked providers
+        │   └── Flutter → integration_test package
+        │
+        ├── Full user flows (login, checkout, etc.)
+        │   ├── Detox (React Native, fast, reliable)
+        │   ├── Maestro (Cross-platform, YAML-based)
+        │   └── Appium (Legacy, slow, last resort)
+        │
+        └── Performance, memory, battery
+            ├── Flashlight (RN performance)
+            ├── Flutter DevTools
+            └── Real device profiling (Xcode/Android Studio)
+```
+
+### Tool Comparison
+
+| Tool | Platform | Speed | Reliability | Use When |
+|------|----------|-------|-------------|----------|
+| **Jest** | RN | ⚡⚡⚡ | ⚡⚡⚡ | Unit tests, logic |
+| **RNTL** | RN | ⚡⚡⚡ | ⚡⚡ | Component tests |
+| **flutter_test** | Flutter | ⚡⚡⚡ | ⚡⚡⚡ | Widget tests |
+| **Detox** | RN | ⚡⚡ | ⚡⚡⚡ | E2E, critical flows |
+| **Maestro** | Both | ⚡⚡ | ⚡⚡ | E2E, cross-platform |
+| **Appium** | Both | ⚡ | ⚡ | Legacy, last resort |
+
+---
+
+## 2. Testing Pyramid for Mobile
+
+```
+                    ┌───────────────┐
+                    │    E2E Tests  │  10%
+                    │  (Real device) │  Slow, expensive, essential
+                    ├───────────────┤
+                    │  Integration  │  20%
+                    │    Tests      │  Component + context
+                    ├───────────────┤
+                    │  Component    │  30%
+                    │    Tests      │  Isolated UI
+                    ├───────────────┤
+                    │   Unit Tests  │  40%
+                    │    (Jest)     │  Pure logic
+                    └───────────────┘
+```
+
+### Why This Distribution?
+
+| Level | Why This % |
+|-------|------------|
+| **E2E 10%** | Slow, flaky, but catches integration bugs |
+| **Integration 20%** | Tests real user flows without full app |
+| **Component 30%** | Fast feedback on UI changes |
+| **Unit 40%** | Fastest, most stable, logic coverage |
+
+> 🔴 **If you have 90% unit tests and 0% E2E, you're testing the wrong things.**
+
+---
+
+## 3. What to Test at Each Level
+
+### Unit Tests (Jest)
+
+```
+✅ TEST:
+├── Utility functions (formatDate, calculatePrice)
+├── State reducers (Redux, Zustand stores)
+├── API response transformers
+├── Validation logic
+└── Business rules
+
+❌ DON'T TEST:
+├── Component rendering (use component tests)
+├── Navigation (use integration tests)
+├── Native modules (mock them)
+└── Third-party libraries
+```
+
+### Component Tests (RNTL / flutter_test)
+
+```
+✅ TEST:
+├── Component renders correctly
+├── User interactions (tap, type, swipe)
+├── Loading/error/empty states
+├── Accessibility labels exist
+└── Props change behavior
+
+❌ DON'T TEST:
+├── Internal implementation details
+├── Snapshot everything (only key components)
+├── Styling specifics (brittle)
+└── Third-party component internals
+```
+
+### Integration Tests
+
+```
+✅ TEST:
+├── Form submission flows
+├── Navigation between screens
+├── State persistence across screens
+├── API integration (with mocked server)
+└── Context/provider interactions
+
+❌ DON'T TEST:
+├── Every possible path (use unit tests)
+├── Third-party services (mock them)
+└── Backend logic (backend tests)
+```
+
+### E2E Tests
+
+```
+✅ TEST:
+├── Critical user journeys (login, purchase, signup)
+├── Offline → online transitions
+├── Deep link handling
+├── Push notification navigation
+├── Permission flows
+└── Payment flows
+
+❌ DON'T TEST:
+├── Every edge case (too slow)
+├── Visual regression (use snapshot tests)
+├── Non-critical features
+└── Backend-only logic
+```
+
+---
+
+## 4. Platform-Specific Testing
+
+### What Differs Between iOS and Android?
+
+| Area | iOS Behavior | Android Behavior | Test Both? |
+|------|--------------|------------------|------------|
+| **Back navigation** | Edge swipe | System back button | ✅ YES |
+| **Permissions** | Ask once, settings | Ask each time, rationale | ✅ YES |
+| **Keyboard** | Different appearance | Different behavior | ✅ YES |
+| **Date picker** | Wheel/modal | Material dialog | ⚠️ If custom UI |
+| **Push format** | APNs payload | FCM payload | ✅ YES |
+| **Deep links** | Universal Links | App Links | ✅ YES |
+| **Gestures** | Some unique | Material gestures | ⚠️ If custom |
+
+### Platform Testing Strategy
+
+```
+FOR EACH PLATFORM:
+├── Run unit tests (same on both)
+├── Run component tests (same on both)
+├── Run E2E on REAL DEVICE
+│   ├── iOS: iPhone (not just simulator)
+│   └── Android: Mid-range device (not flagship)
+└── Test platform-specific features separately
+```
+
+---
+
+## 5. Offline & Network Testing
+
+### Offline Scenarios to Test
+
+| Scenario | What to Verify |
+|----------|----------------|
+| Start app offline | Shows cached data or offline message |
+| Go offline mid-action | Action queued, not lost |
+| Come back online | Queue synced, no duplicates |
+| Slow network (2G) | Loading states, timeouts work |
+| Flaky network | Retry logic, error recovery |
+
+### How to Test Network Conditions
+
+```
+APPROACH:
+├── Unit tests: Mock NetInfo, test logic
+├── Integration: Mock API responses, test UI
+├── E2E (Detox): Use device.setURLBlacklist()
+├── E2E (Maestro): Use network conditions
+└── Manual: Use Charles Proxy / Network Link Conditioner
+```
+
+---
+
+## 6. Performance Testing
+
+### What to Measure
+
+| Metric | Target | How to Measure |
+|--------|--------|----------------|
+| **App startup** | < 2 seconds | Profiler, Flashlight |
+| **Screen transition** | < 300ms | React DevTools |
+| **List scroll** | 60 FPS | Profiler, feel |
+| **Memory** | Stable, no leaks | Instruments / Android Profiler |
+| **Bundle size** | Minimize | Metro bundler analysis |
+
+### When to Performance Test
+
+```
+PERFORMANCE TEST:
+├── Before release (required)
+├── After adding heavy features
+├── After upgrading dependencies
+├── When users report slowness
+└── On CI (optional, automated benchmarks)
+
+WHERE TO TEST:
+├── Real device (REQUIRED)
+├── Low-end device (Galaxy A series, old iPhone)
+├── NOT on emulator (lies about performance)
+└── With production-like data (not 3 items)
+```
+
+---
+
+## 7. Accessibility Testing
+
+### What to Verify
+
+| Element | Check |
+|---------|-------|
+| Interactive elements | Have accessibilityLabel |
+| Images | Have alt text or decorative flag |
+| Forms | Labels linked to inputs |
+| Buttons | Role = button |
+| Touch targets | ≥ 44x44 (iOS) / 48x48 (Android) |
+| Color contrast | WCAG AA minimum |
+
+### How to Test
+
+```
+AUTOMATED:
+├── React Native: jest-axe
+├── Flutter: Accessibility checker in tests
+└── Lint rules for missing labels
+
+MANUAL:
+├── Enable VoiceOver (iOS) / TalkBack (Android)
+├── Navigate entire app with screen reader
+├── Test with increased text size
+└── Test with reduced motion
+```
+
+---
+
+## 8. CI/CD Integration
+
+### What to Run Where
+
+| Stage | Tests | Devices |
+|-------|-------|---------|
+| **PR** | Unit + Component | None (fast) |
+| **Merge to main** | + Integration | Simulator/Emulator |
+| **Pre-release** | + E2E | Real devices (farm) |
+| **Nightly** | Full suite | Device farm |
+
+### Device Farm Options
+
+| Service | Pros | Cons |
+|---------|------|------|
+| **Firebase Test Lab** | Free tier, Google devices | Android focus |
+| **AWS Device Farm** | Wide selection | Expensive |
+| **BrowserStack** | Good UX | Expensive |
+| **Local devices** | Free, reliable | Limited variety |
+
+---
+
+## 📝 MOBILE TESTING CHECKLIST
+
+### Before PR
+- [ ] Unit tests for new logic
+- [ ] Component tests for new UI
+- [ ] No console.logs in tests
+- [ ] Tests pass on CI
+
+### Before Release
+- [ ] E2E on real iOS device
+- [ ] E2E on real Android device
+- [ ] Tested on low-end device
+- [ ] Offline scenarios verified
+- [ ] Performance acceptable
+- [ ] Accessibility verified
+
+### What to Skip (Consciously)
+- [ ] 100% coverage (aim for meaningful coverage)
+- [ ] Every visual permutation (use snapshots sparingly)
+- [ ] Third-party library internals
+- [ ] Backend logic (separate tests)
+
+---
+
+## 🎯 Testing Questions to Ask
+
+Before writing tests, answer:
+
+1. **What could break?** → Test that
+2. **What's critical for users?** → E2E test that
+3. **What's complex logic?** → Unit test that
+4. **What's platform-specific?** → Test on both platforms
+5. **What happens offline?** → Test that scenario
+
+> **Remember:** Good mobile testing is about testing the RIGHT things, not EVERYTHING. A flaky E2E test is worse than no test. A failing unit test that catches a bug is worth 100 passing trivial tests.
diff --git a/.claude/skills/mobile-design/mobile-typography.md b/.claude/skills/mobile-design/mobile-typography.md
new file mode 100644
index 0000000..d6cd4cb
--- /dev/null
+++ b/.claude/skills/mobile-design/mobile-typography.md
@@ -0,0 +1,433 @@
+# Mobile Typography Reference
+
+> Type scale, system fonts, Dynamic Type, accessibility, and dark mode typography.
+> **Typography failures are the #1 cause of unreadable mobile apps.**
+
+---
+
+## 1. Mobile Typography Fundamentals
+
+### Why Mobile Type is Different
+
+```
+DESKTOP:                        MOBILE:
+├── 20-30" viewing distance     ├── 12-15" viewing distance
+├── Large viewport              ├── Small viewport, narrow
+├── Hover for details           ├── Tap/scroll for details
+├── Controlled lighting         ├── Variable (outdoor, etc.)
+├── Fixed font size             ├── User-controlled sizing
+└── Long reading sessions       └── Quick scanning
+```
+
+### Mobile Type Rules
+
+| Rule | Desktop | Mobile |
+|------|---------|--------|
+| **Minimum body size** | 14px | 16px (14pt/14sp) |
+| **Maximum line length** | 75 characters | 40-60 characters |
+| **Line height** | 1.4-1.5 | 1.4-1.6 (more generous) |
+| **Font weight** | Varies | Regular dominant, bold sparingly |
+| **Contrast** | AA (4.5:1) | AA minimum, AAA preferred |
+
+---
+
+## 2. System Fonts
+
+### iOS: SF Pro Family
+
+```
+San Francisco (SF) Family:
+├── SF Pro Display: Large text (≥ 20pt)
+├── SF Pro Text: Body text (< 20pt)
+├── SF Pro Rounded: Friendly contexts
+├── SF Mono: Monospace
+└── SF Compact: Apple Watch, compact UI
+
+Features:
+├── Optical sizing (auto-adjusts)
+├── Dynamic tracking (spacing)
+├── Tabular/proportional figures
+├── Excellent legibility
+```
+
+### Android: Roboto Family
+
+```
+Roboto Family:
+├── Roboto: Default sans-serif
+├── Roboto Flex: Variable font
+├── Roboto Serif: Serif option
+├── Roboto Mono: Monospace
+├── Roboto Condensed: Narrow spaces
+
+Features:
+├── Optimized for screens
+├── Wide language support
+├── Multiple weights
+├── Good at small sizes
+```
+
+### When to Use System Fonts
+
+```
+✅ USE system fonts when:
+├── Brand doesn't mandate custom font
+├── Reading efficiency is priority
+├── App feels native/integrated important
+├── Performance is critical
+├── Wide language support needed
+
+❌ AVOID system fonts when:
+├── Brand identity requires custom
+├── Design differentiation needed
+├── Editorial/magazine style
+└── (But still support accessibility)
+```
+
+### Custom Font Considerations
+
+```
+If using custom fonts:
+├── Include all weights needed
+├── Subset for file size
+├── Test at all Dynamic Type sizes
+├── Provide fallback to system
+├── Test rendering quality
+└── Check language support
+```
+
+---
+
+## 3. Type Scale
+
+### iOS Type Scale (Built-in)
+
+| Style | Size | Weight | Line Height |
+|-------|------|--------|-------------|
+| Large Title | 34pt | Bold | 41pt |
+| Title 1 | 28pt | Bold | 34pt |
+| Title 2 | 22pt | Bold | 28pt |
+| Title 3 | 20pt | Semibold | 25pt |
+| Headline | 17pt | Semibold | 22pt |
+| Body | 17pt | Regular | 22pt |
+| Callout | 16pt | Regular | 21pt |
+| Subhead | 15pt | Regular | 20pt |
+| Footnote | 13pt | Regular | 18pt |
+| Caption 1 | 12pt | Regular | 16pt |
+| Caption 2 | 11pt | Regular | 13pt |
+
+### Android Type Scale (Material 3)
+
+| Role | Size | Weight | Line Height |
+|------|------|--------|-------------|
+| Display Large | 57sp | 400 | 64sp |
+| Display Medium | 45sp | 400 | 52sp |
+| Display Small | 36sp | 400 | 44sp |
+| Headline Large | 32sp | 400 | 40sp |
+| Headline Medium | 28sp | 400 | 36sp |
+| Headline Small | 24sp | 400 | 32sp |
+| Title Large | 22sp | 400 | 28sp |
+| Title Medium | 16sp | 500 | 24sp |
+| Title Small | 14sp | 500 | 20sp |
+| Body Large | 16sp | 400 | 24sp |
+| Body Medium | 14sp | 400 | 20sp |
+| Body Small | 12sp | 400 | 16sp |
+| Label Large | 14sp | 500 | 20sp |
+| Label Medium | 12sp | 500 | 16sp |
+| Label Small | 11sp | 500 | 16sp |
+
+### Creating Custom Scale
+
+```
+If creating custom scale, use modular ratio:
+
+Recommended ratios:
+├── 1.125 (Major second): Dense UI
+├── 1.200 (Minor third): Compact
+├── 1.250 (Major third): Balanced (common)
+├── 1.333 (Perfect fourth): Spacious
+└── 1.500 (Perfect fifth): Dramatic
+
+Example with 1.25 ratio, 16px base:
+├── xs: 10px (16 ÷ 1.25 ÷ 1.25)
+├── sm: 13px (16 ÷ 1.25)
+├── base: 16px
+├── lg: 20px (16 × 1.25)
+├── xl: 25px (16 × 1.25 × 1.25)
+├── 2xl: 31px
+├── 3xl: 39px
+└── 4xl: 49px
+```
+
+---
+
+## 4. Dynamic Type / Text Scaling
+
+### iOS Dynamic Type (MANDATORY)
+
+```swift
+// ❌ WRONG: Fixed size (doesn't scale)
+Text("Hello")
+    .font(.system(size: 17))
+
+// ✅ CORRECT: Dynamic Type
+Text("Hello")
+    .font(.body) // Scales with user setting
+
+// Custom font with scaling
+Text("Hello")
+    .font(.custom("MyFont", size: 17, relativeTo: .body))
+```
+
+### Android Text Scaling (MANDATORY)
+
+```
+ALWAYS use sp for text:
+├── sp = Scale-independent pixels
+├── Scales with user font preference
+├── dp does NOT scale (don't use for text)
+
+User can scale from 85% to 200%:
+├── Default (100%): 14sp = 14dp
+├── Largest (200%): 14sp = 28dp
+
+Test at 200%!
+```
+
+### Scaling Challenges
+
+```
+Problems at large text sizes:
+├── Text overflows containers
+├── Buttons become too tall
+├── Icons look small relative to text
+├── Layouts break
+
+Solutions:
+├── Use flexible containers (not fixed height)
+├── Allow text wrapping
+├── Scale icons with text
+├── Test at extremes during development
+├── Use scrollable containers for long text
+```
+
+---
+
+## 5. Typography Accessibility
+
+### Minimum Sizes
+
+| Element | Minimum | Recommended |
+|---------|---------|-------------|
+| Body text | 14px/pt/sp | 16px/pt/sp |
+| Secondary text | 12px/pt/sp | 13-14px/pt/sp |
+| Captions | 11px/pt/sp | 12px/pt/sp |
+| Buttons | 14px/pt/sp | 14-16px/pt/sp |
+| **Nothing smaller** | 11px | - |
+
+### Contrast Requirements (WCAG)
+
+```
+Normal text (< 18pt or < 14pt bold):
+├── AA: 4.5:1 ratio minimum
+├── AAA: 7:1 ratio recommended
+
+Large text (≥ 18pt or ≥ 14pt bold):
+├── AA: 3:1 ratio minimum
+├── AAA: 4.5:1 ratio recommended
+
+Logos/decorative: No requirement
+```
+
+### Line Height for Accessibility
+
+```
+WCAG Success Criterion 1.4.12:
+
+Line height (line spacing): ≥ 1.5×
+Paragraph spacing: ≥ 2× font size
+Letter spacing: ≥ 0.12× font size
+Word spacing: ≥ 0.16× font size
+
+Mobile recommendation:
+├── Body: 1.4-1.6 line height
+├── Headings: 1.2-1.3 line height
+├── Never below 1.2
+```
+
+---
+
+## 6. Dark Mode Typography
+
+### Color Adjustments
+
+```
+Light Mode:               Dark Mode:
+├── Black text (#000)     ├── White/light gray (#E0E0E0)
+├── High contrast         ├── Slightly reduced contrast
+├── Full saturation       ├── Desaturated colors
+└── Dark = emphasis       └── Light = emphasis
+
+RULE: Don't use pure white (#FFF) on dark.
+Use off-white (#E0E0E0 to #F0F0F0) to reduce eye strain.
+```
+
+### Dark Mode Hierarchy
+
+| Level | Light Mode | Dark Mode |
+|-------|------------|-----------|
+| Primary text | #000000 | #E8E8E8 |
+| Secondary text | #666666 | #A0A0A0 |
+| Tertiary text | #999999 | #707070 |
+| Disabled text | #CCCCCC | #505050 |
+
+### Weight in Dark Mode
+
+```
+Dark mode text appears thinner due to halation
+(light bleeding into dark background)
+
+Consider:
+├── Using medium weight for body (instead of regular)
+├── Increasing letter-spacing slightly
+├── Testing on actual OLED displays
+└── Using slightly bolder weight than light mode
+```
+
+---
+
+## 7. Typography Anti-Patterns
+
+### ❌ Common Mistakes
+
+| Mistake | Problem | Fix |
+|---------|---------|-----|
+| **Fixed font sizes** | Ignores accessibility | Use dynamic sizing |
+| **Too small text** | Unreadable | Min 14pt/sp |
+| **Low contrast** | Invisible in sunlight | Min 4.5:1 |
+| **Long lines** | Hard to track | Max 60 chars |
+| **Tight line height** | Cramped, hard to read | Min 1.4× |
+| **Too many sizes** | Visual chaos | Max 5-7 sizes |
+| **All caps body** | Hard to read | Headlines only |
+| **Light gray on white** | Impossible in bright light | Higher contrast |
+
+### ❌ AI Typography Mistakes
+
+```
+AI tends to:
+├── Use fixed px values instead of pt/sp
+├── Skip Dynamic Type support
+├── Use too small text (12-14px body)
+├── Ignore line height settings
+├── Use low contrast "aesthetic" grays
+├── Apply same scale to mobile as desktop
+└── Skip testing at large text sizes
+
+RULE: Typography must SCALE.
+Test at smallest and largest settings.
+```
+
+---
+
+## 8. Font Loading & Performance
+
+### Font File Optimization
+
+```
+Font file sizes matter on mobile:
+├── Full font: 100-300KB per weight
+├── Subset (Latin): 15-40KB per weight
+├── Variable font: 100-200KB (all weights)
+
+Recommendations:
+├── Subset to needed characters
+├── Use WOFF2 format
+├── Max 2-3 font files
+├── Consider variable fonts
+├── Cache fonts appropriately
+```
+
+### Loading Strategy
+
+```
+1. SYSTEM FONT FALLBACK
+   Show system font → swap when custom loads
+   
+2. FONT DISPLAY SWAP
+   font-display: swap (CSS)
+   
+3. PRELOAD CRITICAL FONTS
+   Preload fonts needed above the fold
+   
+4. DON'T BLOCK RENDER
+   Don't wait for fonts to show content
+```
+
+---
+
+## 9. Typography Checklist
+
+### Before Any Text Design
+
+- [ ] Body text ≥ 16px/pt/sp?
+- [ ] Line height ≥ 1.4?
+- [ ] Line length ≤ 60 chars?
+- [ ] Type scale defined (max 5-7 sizes)?
+- [ ] Using pt (iOS) or sp (Android)?
+
+### Before Release
+
+- [ ] Dynamic Type tested (iOS)?
+- [ ] Font scaling tested at 200% (Android)?
+- [ ] Dark mode contrast checked?
+- [ ] Sunlight readability tested?
+- [ ] All text has proper hierarchy?
+- [ ] Custom fonts have fallbacks?
+- [ ] Long text scrolls properly?
+
+---
+
+## 10. Quick Reference
+
+### Typography Tokens
+
+```
+// iOS
+.largeTitle  // 34pt, Bold
+.title       // 28pt, Bold
+.title2      // 22pt, Bold
+.title3      // 20pt, Semibold
+.headline    // 17pt, Semibold
+.body        // 17pt, Regular
+.subheadline // 15pt, Regular
+.footnote    // 13pt, Regular
+.caption     // 12pt, Regular
+
+// Android (Material 3)
+displayLarge   // 57sp
+headlineLarge  // 32sp
+titleLarge     // 22sp
+bodyLarge      // 16sp
+labelLarge     // 14sp
+```
+
+### Minimum Sizes
+
+```
+Body:       14-16pt/sp (16 preferred)
+Secondary:  12-13pt/sp
+Caption:    11-12pt/sp
+Nothing:    < 11pt/sp
+```
+
+### Line Height
+
+```
+Headings:  1.1-1.3
+Body:      1.4-1.6
+Long text: 1.5-1.75
+```
+
+---
+
+> **Remember:** If users can't read your text, your app is broken. Typography isn't decoration—it's the primary interface. Test on real devices, in real conditions, with accessibility settings enabled.
diff --git a/.claude/skills/mobile-design/platform-android.md b/.claude/skills/mobile-design/platform-android.md
new file mode 100644
index 0000000..5aa83cc
--- /dev/null
+++ b/.claude/skills/mobile-design/platform-android.md
@@ -0,0 +1,666 @@
+# Android Platform Guidelines
+
+> Material Design 3 essentials, Android design conventions, Roboto typography, and native patterns.
+> **Read this file when building for Android devices.**
+
+---
+
+## 1. Material Design 3 Philosophy
+
+### Core Material Principles
+
+```
+MATERIAL AS METAPHOR:
+├── Surfaces exist in 3D space
+├── Light and shadow define hierarchy
+├── Motion provides continuity
+└── Bold, graphic, intentional design
+
+ADAPTIVE DESIGN:
+├── Responds to device capabilities
+├── One UI for all form factors
+├── Dynamic color from wallpaper
+└── Personalized per user
+
+ACCESSIBLE BY DEFAULT:
+├── Large touch targets
+├── Clear visual hierarchy
+├── Semantic colors
+└── Motion respects preferences
+```
+
+### Material Design Values
+
+| Value | Implementation |
+|-------|----------------|
+| **Dynamic Color** | Colors adapt to wallpaper/user preference |
+| **Personalization** | User-specific themes |
+| **Accessibility** | Built into every component |
+| **Responsiveness** | Works on all screen sizes |
+| **Consistency** | Unified design language |
+
+---
+
+## 2. Android Typography
+
+### Roboto Font Family
+
+```
+Android System Fonts:
+├── Roboto: Default sans-serif
+├── Roboto Flex: Variable font (API 33+)
+├── Roboto Serif: Serif alternative
+├── Roboto Mono: Monospace
+└── Google Sans: Google products (special license)
+```
+
+### Material Type Scale
+
+| Role | Size | Weight | Line Height | Usage |
+|------|------|--------|-------------|-------|
+| **Display Large** | 57sp | Regular | 64sp | Hero text, splash |
+| **Display Medium** | 45sp | Regular | 52sp | Large headers |
+| **Display Small** | 36sp | Regular | 44sp | Medium headers |
+| **Headline Large** | 32sp | Regular | 40sp | Page titles |
+| **Headline Medium** | 28sp | Regular | 36sp | Section headers |
+| **Headline Small** | 24sp | Regular | 32sp | Subsections |
+| **Title Large** | 22sp | Regular | 28sp | Dialogs, cards |
+| **Title Medium** | 16sp | Medium | 24sp | Lists, navigation |
+| **Title Small** | 14sp | Medium | 20sp | Tabs, secondary |
+| **Body Large** | 16sp | Regular | 24sp | Primary content |
+| **Body Medium** | 14sp | Regular | 20sp | Secondary content |
+| **Body Small** | 12sp | Regular | 16sp | Captions |
+| **Label Large** | 14sp | Medium | 20sp | Buttons, FAB |
+| **Label Medium** | 12sp | Medium | 16sp | Navigation |
+| **Label Small** | 11sp | Medium | 16sp | Chips, badges |
+
+### Scalable Pixels (sp)
+
+```
+sp = Scale-independent pixels
+
+sp automatically scales with:
+├── User font size preference
+├── Display density
+└── Accessibility settings
+
+RULE: ALWAYS use sp for text, dp for everything else.
+```
+
+### Font Weight Usage
+
+| Weight | Use Case |
+|--------|----------|
+| Regular (400) | Body text, display |
+| Medium (500) | Buttons, labels, emphasis |
+| Bold (700) | Rarely, strong emphasis only |
+
+---
+
+## 3. Material Color System
+
+### Dynamic Color (Material You)
+
+```
+Android 12+ Dynamic Color:
+
+User's wallpaper → Color extraction → App theme
+
+Your app automatically adapts to:
+├── Primary color (from wallpaper)
+├── Secondary color (complementary)
+├── Tertiary color (accent)
+├── Surface colors (derived)
+└── All semantic colors adjust
+
+RULE: Implement dynamic color for personalized feel.
+```
+
+### Semantic Color Roles
+
+```
+Surface Colors:
+├── Surface → Main background
+├── SurfaceVariant → Cards, containers
+├── SurfaceTint → Elevation overlay
+├── InverseSurface → Snackbars, tooltips
+
+On-Surface Colors:
+├── OnSurface → Primary text
+├── OnSurfaceVariant → Secondary text
+├── Outline → Borders, dividers
+├── OutlineVariant → Subtle dividers
+
+Primary Colors:
+├── Primary → Key actions, FAB
+├── OnPrimary → Text on primary
+├── PrimaryContainer → Less emphasis
+├── OnPrimaryContainer → Text on container
+
+Secondary/Tertiary: Similar pattern
+```
+
+### Error, Warning, Success Colors
+
+| Role | Light | Dark | Usage |
+|------|-------|------|-------|
+| Error | #B3261E | #F2B8B5 | Errors, destructive |
+| OnError | #FFFFFF | #601410 | Text on error |
+| ErrorContainer | #F9DEDC | #8C1D18 | Error backgrounds |
+
+### Dark Theme
+
+```
+Material Dark Theme:
+
+├── Background: #121212 (not pure black by default)
+├── Surface: #1E1E1E, #232323, etc. (elevation)
+├── Elevation: Higher = lighter overlay
+├── Reduce saturation on colors
+└── Check contrast ratios
+
+Elevation overlays (dark mode):
+├── 0dp → 0% overlay
+├── 1dp → 5% overlay
+├── 3dp → 8% overlay
+├── 6dp → 11% overlay
+├── 8dp → 12% overlay
+├── 12dp → 14% overlay
+```
+
+---
+
+## 4. Android Layout & Spacing
+
+### Layout Grid
+
+```
+Android uses 8dp baseline grid:
+
+All spacing in multiples of 8dp:
+├── 4dp: Component internal (half-step)
+├── 8dp: Minimum spacing
+├── 16dp: Standard spacing
+├── 24dp: Section spacing
+├── 32dp: Large spacing
+
+Margins:
+├── Compact (phone): 16dp
+├── Medium (small tablet): 24dp
+├── Expanded (large): 24dp+ or columns
+```
+
+### Responsive Layout
+
+```
+Window Size Classes:
+
+COMPACT (< 600dp width):
+├── Phones in portrait
+├── Single column layout
+├── Bottom navigation
+
+MEDIUM (600-840dp width):
+├── Tablets, foldables
+├── Consider 2 columns
+├── Navigation rail option
+
+EXPANDED (> 840dp width):
+├── Large tablets, desktop
+├── Multi-column layouts
+├── Navigation drawer
+```
+
+### Canonical Layouts
+
+| Layout | Use Case | Window Class |
+|--------|----------|--------------|
+| **List-Detail** | Email, messages | Medium, Expanded |
+| **Feed** | Social, news | All |
+| **Supporting Pane** | Reference content | Medium, Expanded |
+
+---
+
+## 5. Android Navigation Patterns
+
+### Navigation Components
+
+| Component | Use Case | Position |
+|-----------|----------|----------|
+| **Bottom Navigation** | 3-5 top-level destinations | Bottom |
+| **Navigation Rail** | Tablets, foldables | Left side, vertical |
+| **Navigation Drawer** | Many destinations, large screens | Left side, hidden/visible |
+| **Top App Bar** | Current context, actions | Top |
+
+### Bottom Navigation
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│         Content Area                │
+│                                     │
+├─────────────────────────────────────┤
+│  🏠     🔍     ➕     ❤️     👤    │ ← 80dp height
+│ Home   Search  FAB   Saved  Profile│
+└─────────────────────────────────────┘
+
+Rules:
+├── 3-5 destinations
+├── Icons: Material Symbols (24dp)
+├── Labels: Always visible (accessibility)
+├── Active: Filled icon + indicator pill
+├── Badge: For notifications
+├── FAB can integrate (optional)
+```
+
+### Top App Bar
+
+```
+Types:
+├── Center-aligned: Logo apps, simple
+├── Small: Compact, scrolls away
+├── Medium: Title + actions, collapses
+├── Large: Display title, collapses to small
+
+┌─────────────────────────────────────┐
+│  ☰   App Title              🔔 ⋮  │ ← 64dp (small)
+├─────────────────────────────────────┤
+│                                     │
+│         Content Area                │
+└─────────────────────────────────────┘
+
+Actions: Max 3 icons, overflow menu ( ⋮ ) for more
+```
+
+### Navigation Rail (Tablets)
+
+```
+┌───────┬─────────────────────────────┐
+│  ≡    │                             │
+│       │                             │
+│  🏠   │                             │
+│ Home  │       Content Area          │
+│       │                             │
+│  🔍   │                             │
+│Search │                             │
+│       │                             │
+│  👤   │                             │
+│Profile│                             │
+└───────┴─────────────────────────────┘
+
+Width: 80dp
+Icons: 24dp
+Labels: Below icon
+FAB: Can be at top
+```
+
+### Back Navigation
+
+```
+Android provides system back:
+├── Back button (3-button nav)
+├── Back gesture (swipe from edge)
+├── Predictive back (Android 14+)
+
+Your app must:
+├── Handle back correctly (pop stack)
+├── Support predictive back animation
+├── Never hijack/override back unexpectedly
+└── Confirm before discarding unsaved work
+```
+
+---
+
+## 6. Material Components
+
+### Buttons
+
+```
+Button Types:
+
+┌──────────────────────┐
+│    Filled Button     │  ← Primary action
+└──────────────────────┘
+
+┌──────────────────────┐
+│    Tonal Button      │  ← Secondary, less emphasis
+└──────────────────────┘
+
+┌──────────────────────┐
+│   Outlined Button    │  ← Tertiary, lower emphasis
+└──────────────────────┘
+
+    Text Button           ← Lowest emphasis
+
+Heights:
+├── Small: 40dp (when constrained)
+├── Standard: 40dp
+├── Large: 56dp (FAB size when needed)
+
+Min touch target: 48dp (even if visual is smaller)
+```
+
+### Floating Action Button (FAB)
+
+```
+FAB Types:
+├── Standard: 56dp diameter
+├── Small: 40dp diameter
+├── Large: 96dp diameter
+├── Extended: Icon + text, variable width
+
+Position: Bottom right, 16dp from edges
+Elevation: Floats above content
+
+┌─────────────────────────────────────┐
+│                                     │
+│         Content                     │
+│                                     │
+│                              ┌────┐ │
+│                              │ ➕ │ │ ← FAB
+│                              └────┘ │
+├─────────────────────────────────────┤
+│       Bottom Navigation             │
+└─────────────────────────────────────┘
+```
+
+### Cards
+
+```
+Card Types:
+├── Elevated: Shadow, resting state
+├── Filled: Background color, no shadow
+├── Outlined: Border, no shadow
+
+Card Anatomy:
+┌─────────────────────────────────────┐
+│           Header Image              │ ← Optional
+├─────────────────────────────────────┤
+│  Title / Headline                   │
+│  Subhead / Supporting text          │
+├─────────────────────────────────────┤
+│      [ Action ]    [ Action ]       │ ← Optional actions
+└─────────────────────────────────────┘
+
+Corner radius: 12dp (M3 default)
+Padding: 16dp
+```
+
+### Text Fields
+
+```
+Types:
+├── Filled: Background fill, underline
+├── Outlined: Border all around
+
+┌─────────────────────────────────────┐
+│  Label                              │ ← Floats up on focus
+│  ________________________________________________
+│  │     Input text here...          │ ← Leading/trailing icons
+│  ‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
+│  Supporting text or error           │
+└─────────────────────────────────────┘
+
+Height: 56dp
+Label: Animates from placeholder to top
+Error: Red color + icon + message
+```
+
+### Chips
+
+```
+Types:
+├── Assist: Smart actions (directions, call)
+├── Filter: Toggle filters
+├── Input: Represent entities (tags, contacts)
+├── Suggestion: Dynamic recommendations
+
+┌───────────────┐
+│  🏷️ Filter   │  ← 32dp height, 8dp corner radius
+└───────────────┘
+
+States: Unselected, Selected, Disabled
+```
+
+---
+
+## 7. Android-Specific Patterns
+
+### Snackbars
+
+```
+Position: Bottom, above navigation
+Duration: 4-10 seconds
+Action: One optional text action
+
+┌─────────────────────────────────────────────────┐
+│  Archived 1 item                    [ UNDO ]    │
+└─────────────────────────────────────────────────┘
+
+Rules:
+├── Brief message, single line if possible
+├── Max 2 lines
+├── One action (text, not icon)
+├── Can be dismissed by swipe
+└── Don't stack, queue them
+```
+
+### Bottom Sheets
+
+```
+Types:
+├── Standard: Interactive content
+├── Modal: Blocks background (with scrim)
+
+Modal Bottom Sheet:
+┌─────────────────────────────────────┐
+│                                     │
+│        (Scrim over content)         │
+│                                     │
+├═════════════════════════════════════┤
+│  ─────  (Drag handle, optional)     │
+│                                     │
+│        Sheet Content                │
+│                                     │
+│        Actions / Options            │
+│                                     │
+└─────────────────────────────────────┘
+
+Corner radius: 28dp (top corners)
+```
+
+### Dialogs
+
+```
+Types:
+├── Basic: Title + content + actions
+├── Full-screen: Complex editing (mobile)
+├── Date/Time picker
+├── Confirmation dialog
+
+┌─────────────────────────────────────┐
+│              Title                  │
+│                                     │
+│       Supporting text that          │
+│       explains the dialog           │
+│                                     │
+│           [ Cancel ]  [ Confirm ]   │
+└─────────────────────────────────────┘
+
+Rules:
+├── Centered on screen
+├── Scrim behind (dim background)
+├── Max 2 actions aligned right
+├── Destructive action can be on left
+```
+
+### Pull to Refresh
+
+```
+Android uses SwipeRefreshLayout pattern:
+
+┌─────────────────────────────────────┐
+│         ○ (Spinner)                 │ ← Circular progress
+├─────────────────────────────────────┤
+│                                     │
+│         Content                     │
+│                                     │
+└─────────────────────────────────────┘
+
+Spinner: Material circular indicator
+Position: Top center, pulls down with content
+```
+
+### Ripple Effect
+
+```
+Every touchable element needs ripple:
+
+Touch down → Ripple expands from touch point
+Touch up → Ripple completes and fades
+
+Color: 
+├── On light: Black at ~12% opacity
+├── On dark: White at ~12% opacity
+├── On colored: Appropriate contrast
+
+This is MANDATORY for Android feel.
+```
+
+---
+
+## 8. Material Symbols
+
+### Usage Guidelines
+
+```
+Material Symbols: Google's icon library
+
+Styles:
+├── Outlined: Default, most common
+├── Rounded: Softer, friendly
+├── Sharp: Angular, precise
+
+Variable font axes:
+├── FILL: 0 (outline) to 1 (filled)
+├── wght: 100-700 (weight)
+├── GRAD: -25 to 200 (emphasis)
+├── opsz: 20, 24, 40, 48 (optical size)
+```
+
+### Icon Sizes
+
+| Size | Usage |
+|------|-------|
+| 20dp | Dense UI, inline |
+| 24dp | Standard (most common) |
+| 40dp | Larger touch targets |
+| 48dp | Emphasis, standalone |
+
+### States
+
+```
+Icon States:
+├── Default: Full opacity
+├── Disabled: 38% opacity
+├── Hover/Focus: Container highlight
+├── Selected: Filled variant + tint
+
+Active vs Inactive:
+├── Inactive: Outlined
+├── Active: Filled + indicator
+```
+
+---
+
+## 9. Android Accessibility
+
+### TalkBack Requirements
+
+```
+Every interactive element needs:
+├── contentDescription (what it is)
+├── Correct semantics (button, checkbox, etc.)
+├── State announcements (selected, disabled)
+└── Grouping where logical
+
+Jetpack Compose:
+Modifier.semantics {
+    contentDescription = "Play button"
+    role = Role.Button
+}
+
+React Native:
+accessibilityLabel="Play button"
+accessibilityRole="button"
+accessibilityState={{ disabled: false }}
+```
+
+### Touch Target Size
+
+```
+MANDATORY: 48dp × 48dp minimum
+
+Even if visual element is smaller:
+├── Icon: 24dp visual, 48dp touch area
+├── Checkbox: 20dp visual, 48dp touch area
+└── Add padding to reach 48dp
+
+Spacing between targets: 8dp minimum
+```
+
+### Font Scaling
+
+```
+Android supports font scaling:
+├── 85% (smaller)
+├── 100% (default)
+├── 115%, 130%, 145%...
+├── Up to 200% (largest)
+
+RULE: Test your UI at 200% font scale.
+Use sp units and avoid fixed heights.
+```
+
+### Reduce Motion
+
+```kotlin
+// Check motion preference
+val reduceMotion = Settings.Global.getFloat(
+    contentResolver,
+    Settings.Global.ANIMATOR_DURATION_SCALE,
+    1f
+) == 0f
+
+if (reduceMotion) {
+    // Skip or reduce animations
+}
+```
+
+---
+
+## 10. Android Checklist
+
+### Before Every Android Screen
+
+- [ ] Using Material 3 components
+- [ ] Touch targets ≥ 48dp
+- [ ] Ripple effect on all touchables
+- [ ] Roboto or Material type scale
+- [ ] Semantic colors (dynamic color support)
+- [ ] Back navigation works correctly
+
+### Before Android Release
+
+- [ ] Dark theme tested
+- [ ] Dynamic color tested (if supported)
+- [ ] All font sizes tested (200% scale)
+- [ ] TalkBack tested
+- [ ] Predictive back implemented (Android 14+)
+- [ ] Edge-to-edge display (Android 15+)
+- [ ] Different screen sizes tested (phones, tablets)
+- [ ] Navigation patterns match platform (back, gestures)
+
+---
+
+> **Remember:** Android users expect Material Design. Custom designs that ignore Material patterns feel foreign and broken. Use Material components as your foundation, customize thoughtfully.
diff --git a/.claude/skills/mobile-design/platform-ios.md b/.claude/skills/mobile-design/platform-ios.md
new file mode 100644
index 0000000..3523157
--- /dev/null
+++ b/.claude/skills/mobile-design/platform-ios.md
@@ -0,0 +1,561 @@
+# iOS Platform Guidelines
+
+> Human Interface Guidelines (HIG) essentials, iOS design conventions, SF Pro typography, and native patterns.
+> **Read this file when building for iPhone/iPad.**
+
+---
+
+## 1. Human Interface Guidelines Philosophy
+
+### Core Apple Design Principles
+
+```
+CLARITY:
+├── Text is legible at every size
+├── Icons are precise and lucid
+├── Adornments are subtle and appropriate
+└── Focus on functionality drives design
+
+DEFERENCE:
+├── UI helps people understand and interact
+├── Content fills the screen
+├── UI never competes with content
+└── Translucency hints at more content
+
+DEPTH:
+├── Distinct visual layers convey hierarchy
+├── Transitions provide sense of depth
+├── Touch reveals functionality
+└── Content is elevated over UI
+```
+
+### iOS Design Values
+
+| Value | Implementation |
+|-------|----------------|
+| **Aesthetic Integrity** | Design matches function (game ≠ productivity) |
+| **Consistency** | Use system controls, familiar patterns |
+| **Direct Manipulation** | Touch directly affects content |
+| **Feedback** | Actions are acknowledged |
+| **Metaphors** | Real-world comparisons aid understanding |
+| **User Control** | User initiates actions, can cancel |
+
+---
+
+## 2. iOS Typography
+
+### SF Pro Font Family
+
+```
+iOS System Fonts:
+├── SF Pro Text: Body text (< 20pt)
+├── SF Pro Display: Large titles (≥ 20pt)
+├── SF Pro Rounded: Friendly contexts
+├── SF Mono: Code, tabular data
+└── SF Compact: Apple Watch, smaller screens
+```
+
+### iOS Type Scale (Dynamic Type)
+
+| Style | Default Size | Weight | Usage |
+|-------|--------------|--------|-------|
+| **Large Title** | 34pt | Bold | Navigation bar (scroll collapse) |
+| **Title 1** | 28pt | Bold | Page titles |
+| **Title 2** | 22pt | Bold | Section headers |
+| **Title 3** | 20pt | Semibold | Subsection headers |
+| **Headline** | 17pt | Semibold | Emphasized body |
+| **Body** | 17pt | Regular | Primary content |
+| **Callout** | 16pt | Regular | Secondary content |
+| **Subhead** | 15pt | Regular | Tertiary content |
+| **Footnote** | 13pt | Regular | Caption, timestamps |
+| **Caption 1** | 12pt | Regular | Annotations |
+| **Caption 2** | 11pt | Regular | Fine print |
+
+### Dynamic Type Support (MANDATORY)
+
+```swift
+// ❌ WRONG: Fixed font size
+Text("Hello")
+    .font(.system(size: 17))
+
+// ✅ CORRECT: Dynamic Type
+Text("Hello")
+    .font(.body) // Scales with user settings
+
+// React Native equivalent
+<Text style={{ fontSize: 17 }}> // ❌ Fixed
+<Text style={styles.body}> // Use a dynamic scale system
+```
+
+### Font Weight Usage
+
+| Weight | iOS Constant | Use Case |
+|--------|--------------|----------|
+| Regular (400) | `.regular` | Body text |
+| Medium (500) | `.medium` | Buttons, emphasis |
+| Semibold (600) | `.semibold` | Subheadings |
+| Bold (700) | `.bold` | Titles, key info |
+| Heavy (800) | `.heavy` | Rarely, marketing |
+
+---
+
+## 3. iOS Color System
+
+### System Colors (Semantic)
+
+```
+Use semantic colors for automatic dark mode:
+
+Primary:
+├── .label → Primary text
+├── .secondaryLabel → Secondary text
+├── .tertiaryLabel → Tertiary text
+├── .quaternaryLabel → Watermarks
+
+Backgrounds:
+├── .systemBackground → Main background
+├── .secondarySystemBackground → Grouped content
+├── .tertiarySystemBackground → Elevated content
+
+Fills:
+├── .systemFill → Large shapes
+├── .secondarySystemFill → Medium shapes
+├── .tertiarySystemFill → Small shapes
+├── .quaternarySystemFill → Subtle shapes
+```
+
+### System Accent Colors
+
+| Color | Light Mode | Dark Mode | Usage |
+|-------|------------|-----------|-------|
+| Blue | #007AFF | #0A84FF | Links, highlights, default tint |
+| Green | #34C759 | #30D158 | Success, positive |
+| Red | #FF3B30 | #FF453A | Errors, destructive |
+| Orange | #FF9500 | #FF9F0A | Warnings |
+| Yellow | #FFCC00 | #FFD60A | Attention |
+| Purple | #AF52DE | #BF5AF2 | Special features |
+| Pink | #FF2D55 | #FF375F | Affection, favorites |
+| Teal | #5AC8FA | #64D2FF | Information |
+
+### Dark Mode Considerations
+
+```
+iOS Dark Mode is not inverted light mode:
+
+LIGHT MODE:              DARK MODE:
+├── White backgrounds    ├── True black (#000) or near-black
+├── High saturation      ├── Desaturated colors
+├── Black text           ├── White/light gray text
+└── Drop shadows         └── Glows or no shadows
+
+RULE: Always use semantic colors for automatic adaptation.
+```
+
+---
+
+## 4. iOS Layout & Spacing
+
+### Safe Areas
+
+```
+┌─────────────────────────────────────┐
+│░░░░░░░░░░░ Status Bar ░░░░░░░░░░░░░│ ← Top safe area inset
+├─────────────────────────────────────┤
+│                                     │
+│                                     │
+│         Safe Content Area           │
+│                                     │
+│                                     │
+├─────────────────────────────────────┤
+│░░░░░░░░░ Home Indicator ░░░░░░░░░░░│ ← Bottom safe area inset
+└─────────────────────────────────────┘
+
+RULE: Never place interactive content in unsafe areas.
+```
+
+### Standard Margins & Padding
+
+| Element | Margin | Notes |
+|---------|--------|-------|
+| Screen edge → content | 16pt | Standard horizontal margin |
+| Grouped table sections | 16pt top/bottom | Breathing room |
+| List item padding | 16pt horizontal | Standard cell padding |
+| Card internal padding | 16pt | Content within cards |
+| Button internal padding | 12pt vertical, 16pt horizontal | Minimum |
+
+### iOS Grid System
+
+```
+iPhone Grid (Standard):
+├── 16pt margins (left/right)
+├── 8pt minimum spacing
+├── Content in 8pt multiples
+
+iPhone Grid (Compact):
+├── 8pt margins (when needed)
+├── 4pt minimum spacing
+
+iPad Grid:
+├── 20pt margins (or more)
+├── Consider multi-column layouts
+```
+
+---
+
+## 5. iOS Navigation Patterns
+
+### Navigation Types
+
+| Pattern | Use Case | Implementation |
+|---------|----------|----------------|
+| **Tab Bar** | 3-5 top-level sections | Bottom, always visible |
+| **Navigation Controller** | Hierarchical drill-down | Stack-based, back button |
+| **Modal** | Focused task, interruption | Sheet or full-screen |
+| **Sidebar** | iPad, multi-column | Left sidebar (iPad) |
+
+### Tab Bar Guidelines
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│         Content Area                │
+│                                     │
+├─────────────────────────────────────┤
+│  🏠     🔍     ➕     ❤️     👤    │ ← Tab bar (49pt height)
+│ Home   Search  New   Saved  Profile │
+└─────────────────────────────────────┘
+
+Rules:
+├── 3-5 items maximum
+├── Icons: SF Symbols or custom (25×25pt)
+├── Labels: Always include (accessibility)
+├── Active state: Filled icon + tint color
+└── Tab bar always visible (don't hide on scroll)
+```
+
+### Navigation Bar Guidelines
+
+```
+┌─────────────────────────────────────┐
+│ < Back     Page Title      Edit    │ ← Navigation bar (44pt)
+├─────────────────────────────────────┤
+│                                     │
+│         Content Area                │
+│                                     │
+└─────────────────────────────────────┘
+
+Rules:
+├── Back button: System chevron + previous title (or "Back")
+├── Title: Centered, dynamic font
+├── Right actions: Max 2 items
+├── Large title: Collapses on scroll (optional)
+└── Prefer text buttons over icons (clarity)
+```
+
+### Modal Presentations
+
+| Style | Use Case | Appearance |
+|-------|----------|------------|
+| **Sheet (default)** | Secondary tasks | Card slides up, parent visible |
+| **Full Screen** | Immersive tasks | Covers entire screen |
+| **Popover** | iPad, quick info | Arrow-pointed bubble |
+| **Alert** | Critical interruption | Centered dialog |
+| **Action Sheet** | Choices from context | Bottom sheet with options |
+
+### Gestures
+
+| Gesture | iOS Convention |
+|---------|----------------|
+| **Edge swipe (left)** | Navigate back |
+| **Pull down (sheet)** | Dismiss modal |
+| **Long press** | Context menu |
+| **Deep press** | Peek/Pop (legacy) |
+| **Two-finger swipe** | Scroll in nested scroll |
+
+---
+
+## 6. iOS Components
+
+### Buttons
+
+```
+Button Styles (UIKit/SwiftUI):
+
+┌──────────────────────────────┐
+│         Tinted               │ ← Primary action (filled)
+├──────────────────────────────┤
+│         Bordered             │ ← Secondary action (outline)
+├──────────────────────────────┤
+│         Plain                │ ← Tertiary action (text only)
+└──────────────────────────────┘
+
+Sizes:
+├── Mini: Tight spaces
+├── Small: Compact UI
+├── Medium: Inline actions
+├── Large: Primary CTAs (44pt minimum height)
+```
+
+### Lists & Tables
+
+```
+List Styles:
+
+.plain         → No separators, edge-to-edge
+.insetGrouped  → Rounded cards (default iOS 14+)
+.grouped       → Full-width sections
+.sidebar       → iPad sidebar navigation
+
+Cell Accessories:
+├── Disclosure indicator (>) → Navigates to detail
+├── Detail button (i) → Shows info without navigation
+├── Checkmark (✓) → Selection
+├── Reorder (≡) → Drag to reorder
+└── Delete (-) → Swipe/edit mode delete
+```
+
+### Text Fields
+
+```
+iOS Text Field Anatomy:
+
+┌─────────────────────────────────────┐
+│ 🔍 Search...                    ✕  │
+└─────────────────────────────────────┘
+  ↑                               ↑
+  Leading icon                   Clear button
+
+Borders: Rounded rectangle
+Height: 36pt minimum
+Placeholder: Secondary text color
+Clear button: Appears when has text
+```
+
+### Segmented Controls
+
+```
+When to Use:
+├── 2-5 related options
+├── Filter content
+├── Switch views
+
+┌───────┬───────┬───────┐
+│  All  │ Active│ Done  │
+└───────┴───────┴───────┘
+
+Rules:
+├── Equal width segments
+├── Text or icons (not both mixed)
+├── Max 5 segments
+└── Consider tabs if more complex
+```
+
+---
+
+## 7. iOS Specific Patterns
+
+### Pull to Refresh
+
+```
+Native UIRefreshControl behavior:
+├── Pull beyond threshold → Spinner appears
+├── Release → Refresh action triggered
+├── Loading state → Spinner spins
+├── Complete → Spinner disappears
+
+RULE: Always use native UIRefreshControl (don't custom build).
+```
+
+### Swipe Actions
+
+```
+iOS swipe actions:
+
+← Swipe Left (Destructive)      Swipe Right (Constructive) →
+┌─────────────────────────────────────────────────────────────┐
+│                    List Item Content                        │
+└─────────────────────────────────────────────────────────────┘
+
+Left swipe reveals: Archive, Delete, Flag
+Right swipe reveals: Pin, Star, Mark as Read
+
+Full swipe: Triggers first action
+```
+
+### Context Menus
+
+```
+Long press → Context menu appears
+
+┌─────────────────────────────┐
+│       Preview Card          │
+├─────────────────────────────┤
+│  📋 Copy                    │
+│  📤 Share                   │
+│  ➕ Add to...               │
+├─────────────────────────────┤
+│  🗑️ Delete          (Red)   │
+└─────────────────────────────┘
+
+Rules:
+├── Preview: Show enlarged content
+├── Actions: Related to content
+├── Destructive: Last, in red
+└── Max ~8 actions (scrollable if more)
+```
+
+### Sheets & Half-Sheets
+
+```
+iOS 15+ Sheets:
+
+┌─────────────────────────────────────┐
+│                                     │
+│        Parent View (dimmed)          │
+│                                     │
+├─────────────────────────────────────┤
+│  ═══  (Grabber)                     │ ← Drag to resize
+│                                     │
+│        Sheet Content                │
+│                                     │
+│                                     │
+└─────────────────────────────────────┘
+
+Detents:
+├── .medium → Half screen
+├── .large → Full screen (with safe area)
+├── Custom → Specific height
+```
+
+---
+
+## 8. SF Symbols
+
+### Usage Guidelines
+
+```
+SF Symbols: Apple's icon library (5000+ icons)
+
+Weights: Match text weight
+├── Ultralight / Thin / Light
+├── Regular / Medium / Semibold
+├── Bold / Heavy / Black
+
+Scales:
+├── .small → Inline with small text
+├── .medium → Standard UI
+├── .large → Emphasis, standalone
+```
+
+### Symbol Configurations
+
+```swift
+// SwiftUI
+Image(systemName: "star.fill")
+    .font(.title2)
+    .foregroundStyle(.yellow)
+
+// With rendering mode
+Image(systemName: "heart.fill")
+    .symbolRenderingMode(.multicolor)
+
+// Animated (iOS 17+)
+Image(systemName: "checkmark.circle")
+    .symbolEffect(.bounce)
+```
+
+### Symbol Best Practices
+
+| Guideline | Implementation |
+|-----------|----------------|
+| Match text weight | Symbol weight = font weight |
+| Use standard symbols | Users recognize them |
+| Multicolor when meaningful | Not just decoration |
+| Fallback for older iOS | Check availability |
+
+---
+
+## 9. iOS Accessibility
+
+### VoiceOver Requirements
+
+```
+Every interactive element needs:
+├── Accessibility label (what it is)
+├── Accessibility hint (what it does) - optional
+├── Accessibility traits (button, link, etc.)
+└── Accessibility value (current state)
+
+SwiftUI:
+.accessibilityLabel("Play")
+.accessibilityHint("Plays the selected track")
+
+React Native:
+accessibilityLabel="Play"
+accessibilityHint="Plays the selected track"
+accessibilityRole="button"
+```
+
+### Dynamic Type Scaling
+
+```
+MANDATORY: Support Dynamic Type
+
+Users can set text size from:
+├── xSmall → 14pt body
+├── Small → 15pt body
+├── Medium → 16pt body
+├── Large (Default) → 17pt body
+├── xLarge → 19pt body
+├── xxLarge → 21pt body
+├── xxxLarge → 23pt body
+├── Accessibility sizes → up to 53pt
+
+Your app MUST scale gracefully at all sizes.
+```
+
+### Reduce Motion
+
+```
+Respect motion preferences:
+
+@Environment(\.accessibilityReduceMotion) var reduceMotion
+
+if reduceMotion {
+    // Use instant transitions
+} else {
+    // Use animations
+}
+
+React Native:
+import { AccessibilityInfo } from 'react-native';
+AccessibilityInfo.isReduceMotionEnabled()
+```
+
+---
+
+## 10. iOS Checklist
+
+### Before Every iOS Screen
+
+- [ ] Using SF Pro or SF Symbols
+- [ ] Dynamic Type supported
+- [ ] Safe areas respected
+- [ ] Navigation follows HIG (back gesture works)
+- [ ] Tab bar items ≤ 5
+- [ ] Touch targets ≥ 44pt
+
+### Before iOS Release
+
+- [ ] Dark mode tested
+- [ ] All text sizes tested (Accessibility Inspector)
+- [ ] VoiceOver tested
+- [ ] Edge swipe back works everywhere
+- [ ] Keyboard avoidance implemented
+- [ ] Notch/Dynamic Island handled
+- [ ] Home indicator area respected
+- [ ] Native components used where possible
+
+---
+
+> **Remember:** iOS users have strong expectations from other iOS apps. Deviating from HIG patterns feels "broken" to them. When in doubt, use the native component.
diff --git a/.claude/skills/mobile-design/scripts/mobile_audit.py b/.claude/skills/mobile-design/scripts/mobile_audit.py
new file mode 100644
index 0000000..f134523
--- /dev/null
+++ b/.claude/skills/mobile-design/scripts/mobile_audit.py
@@ -0,0 +1,670 @@
+#!/usr/bin/env python3
+"""
+Mobile UX Audit Script - Full Mobile Design Coverage
+
+Analyzes React Native / Flutter code for compliance with:
+
+1. TOUCH PSYCHOLOGY (touch-psychology.md):
+   - Touch Target Sizes (44pt iOS, 48dp Android, 44px WCAG)
+   - Touch Target Spacing (8px minimum gap)
+   - Thumb Zone Placement (primary CTAs at bottom)
+   - Gesture Alternatives (visible buttons for swipe)
+   - Haptic Feedback Patterns
+   - Touch Feedback Timing (<50ms)
+   - Touch Accessibility (motor impairment support)
+
+2. MOBILE PERFORMANCE (mobile-performance.md):
+   - ScrollView vs FlatList (CRITICAL)
+   - React.memo for List Items
+   - useCallback for renderItem
+   - Stable keyExtractor (NOT index)
+   - useNativeDriver for Animations
+   - Memory Leak Prevention (cleanup)
+   - Console.log Detection
+   - Inline Function Detection
+   - Animation Performance (transform/opacity only)
+
+3. MOBILE NAVIGATION (mobile-navigation.md):
+   - Tab Bar Max Items (5)
+   - Tab State Preservation
+   - Proper Back Handling
+   - Deep Link Support
+   - Navigation Structure
+
+4. MOBILE TYPOGRAPHY (mobile-typography.md):
+   - System Font Usage
+   - Dynamic Type Support (iOS)
+   - Text Scaling Constraints
+   - Mobile Line Height
+   - Font Size Limits
+
+5. MOBILE COLOR SYSTEM (mobile-color-system.md):
+   - Pure Black Avoidance (#000000)
+   - OLED Optimization
+   - Dark Mode Support
+   - Contrast Ratios
+
+6. PLATFORM iOS (platform-ios.md):
+   - SF Symbols Usage
+   - iOS Navigation Patterns
+   - iOS Haptic Types
+   - iOS-Specific Components
+
+7. PLATFORM ANDROID (platform-android.md):
+   - Material Icons Usage
+   - Android Navigation Patterns
+   - Ripple Effects
+   - Android-Specific Components
+
+8. MOBILE BACKEND (mobile-backend.md):
+   - Secure Storage (NOT AsyncStorage)
+   - Offline Handling
+   - Push Notification Support
+   - API Response Caching
+
+Total: 50+ mobile-specific checks
+"""
+
+import sys
+import os
+import re
+import json
+from pathlib import Path
+
+class MobileAuditor:
+    def __init__(self):
+        self.issues = []
+        self.warnings = []
+        self.passed_count = 0
+        self.files_checked = 0
+
+    def audit_file(self, filepath: str) -> None:
+        try:
+            with open(filepath, 'r', encoding='utf-8', errors='replace') as f:
+                content = f.read()
+        except:
+            return
+
+        self.files_checked += 1
+        filename = os.path.basename(filepath)
+
+        # Detect framework
+        is_react_native = bool(re.search(r'react-native|@react-navigation|React\.Native', content))
+        is_flutter = bool(re.search(r'import \'package:flutter|MaterialApp|Widget\.build', content))
+
+        if not (is_react_native or is_flutter):
+            return  # Skip non-mobile files
+
+        # --- 1. TOUCH PSYCHOLOGY CHECKS ---
+
+        # 1.1 Touch Target Size Check
+        # Look for small touch targets
+        small_sizes = re.findall(r'(?:width|height|size):\s*([0-3]\d)', content)
+        for size in small_sizes:
+            if int(size) < 44:
+                self.issues.append(f"[Touch Target] {filename}: Touch target size {size}px < 44px minimum (iOS: 44pt, Android: 48dp)")
+
+        # 1.2 Touch Target Spacing Check
+        # Look for inadequate spacing between touchable elements
+        small_gaps = re.findall(r'(?:margin|gap):\s*([0-7])\s*(?:px|dp)', content)
+        for gap in small_gaps:
+            if int(gap) < 8:
+                self.warnings.append(f"[Touch Spacing] {filename}: Touch target spacing {gap}px < 8px minimum. Accidental taps risk.")
+
+        # 1.3 Thumb Zone Placement Check
+        # Primary CTAs should be at bottom (easy thumb reach)
+        primary_buttons = re.findall(r'(?:testID|id):\s*["\'](?:.*(?:primary|cta|submit|confirm)[^"\']*)["\']', content, re.IGNORECASE)
+        has_bottom_placement = bool(re.search(r'position:\s*["\']?absolute["\']?|bottom:\s*\d+|style.*bottom|justifyContent:\s*["\']?flex-end', content))
+        if primary_buttons and not has_bottom_placement:
+            self.warnings.append(f"[Thumb Zone] {filename}: Primary CTA may not be in thumb zone (bottom). Place primary actions at bottom for easy reach.")
+
+        # 1.4 Gesture Alternatives Check
+        # Swipe actions should have visible button alternatives
+        has_swipe_gestures = bool(re.search(r'Swipeable|onSwipe|PanGestureHandler|swipe', content))
+        has_visible_buttons = bool(re.search(r'Button.*(?:delete|archive|more)|TouchableOpacity|Pressable', content))
+        if has_swipe_gestures and not has_visible_buttons:
+            self.warnings.append(f"[Gestures] {filename}: Swipe gestures detected without visible button alternatives. Motor impaired users need alternatives.")
+
+        # 1.5 Haptic Feedback Check
+        # Important actions should have haptic feedback
+        has_important_actions = bool(re.search(r'(?:onPress|onSubmit|delete|remove|confirm|purchase)', content))
+        has_haptics = bool(re.search(r'Haptics|Vibration|react-native-haptic-feedback|FeedbackManager', content))
+        if has_important_actions and not has_haptics:
+            self.warnings.append(f"[Haptics] {filename}: Important actions without haptic feedback. Consider adding haptic confirmation.")
+
+        # 1.6 Touch Feedback Timing Check
+        # Touch feedback should be immediate (<50ms)
+        if is_react_native:
+            has_pressable = bool(re.search(r'Pressable|TouchableOpacity', content))
+            has_feedback_state = bool(re.search(r'pressed|style.*opacity|underlay', content))
+            if has_pressable and not has_feedback_state:
+                self.warnings.append(f"[Touch Feedback] {filename}: Pressable without visual feedback state. Add opacity/scale change for tap confirmation.")
+
+        # --- 2. MOBILE PERFORMANCE CHECKS ---
+
+        # 2.1 CRITICAL: ScrollView vs FlatList
+        has_scrollview = bool(re.search(r'<ScrollView|ScrollView\.', content))
+        has_map_in_scrollview = bool(re.search(r'ScrollView.*\.map\(|ScrollView.*\{.*\.map', content))
+        if has_scrollview and has_map_in_scrollview:
+            self.issues.append(f"[Performance CRITICAL] {filename}: ScrollView with .map() detected. Use FlatList for lists to prevent memory explosion.")
+
+        # 2.2 React.memo Check
+        if is_react_native:
+            has_list = bool(re.search(r'FlatList|FlashList|SectionList', content))
+            has_react_memo = bool(re.search(r'React\.memo|memo\(', content))
+            if has_list and not has_react_memo:
+                self.warnings.append(f"[Performance] {filename}: FlatList without React.memo on list items. Items will re-render on every parent update.")
+
+        # 2.3 useCallback Check
+        if is_react_native:
+            has_flatlist = bool(re.search(r'FlatList|FlashList', content))
+            has_use_callback = bool(re.search(r'useCallback', content))
+            if has_flatlist and not has_use_callback:
+                self.warnings.append(f"[Performance] {filename}: FlatList renderItem without useCallback. New function created every render.")
+
+        # 2.4 keyExtractor Check (CRITICAL)
+        if is_react_native:
+            has_flatlist = bool(re.search(r'FlatList', content))
+            has_key_extractor = bool(re.search(r'keyExtractor', content))
+            uses_index_key = bool(re.search(r'key=\{.*index.*\}|key:\s*index', content))
+            if has_flatlist and not has_key_extractor:
+                self.issues.append(f"[Performance CRITICAL] {filename}: FlatList without keyExtractor. Index-based keys cause bugs on reorder/delete.")
+            if uses_index_key:
+                self.issues.append(f"[Performance CRITICAL] {filename}: Using index as key. This causes bugs when list changes. Use unique ID from data.")
+
+        # 2.5 useNativeDriver Check
+        if is_react_native:
+            has_animated = bool(re.search(r'Animated\.', content))
+            has_native_driver = bool(re.search(r'useNativeDriver:\s*true', content))
+            has_native_driver_false = bool(re.search(r'useNativeDriver:\s*false', content))
+            if has_animated and has_native_driver_false:
+                self.warnings.append(f"[Performance] {filename}: Animation with useNativeDriver: false. Use true for 60fps (only supports transform/opacity).")
+            if has_animated and not has_native_driver:
+                self.warnings.append(f"[Performance] {filename}: Animated component without useNativeDriver. Add useNativeDriver: true for 60fps.")
+
+        # 2.6 Memory Leak Check
+        if is_react_native:
+            has_effect = bool(re.search(r'useEffect', content))
+            has_cleanup = bool(re.search(r'return\s*\(\)\s*=>|return\s+function', content))
+            has_subscriptions = bool(re.search(r'addEventListener|subscribe|\.focus\(\)|\.off\(', content))
+            if has_effect and has_subscriptions and not has_cleanup:
+                self.issues.append(f"[Memory Leak] {filename}: useEffect with subscriptions but no cleanup function. Memory leak on unmount.")
+
+        # 2.7 Console.log Detection
+        console_logs = len(re.findall(r'console\.log|console\.warn|console\.error|console\.debug', content))
+        if console_logs > 5:
+            self.warnings.append(f"[Performance] {filename}: {console_logs} console.log statements detected. Remove before production (blocks JS thread).")
+
+        # 2.8 Inline Function Detection
+        if is_react_native:
+            inline_functions = re.findall(r'(?:onPress|onPressIn|onPressOut|renderItem):\s*\([^)]*\)\s*=>', content)
+            if len(inline_functions) > 3:
+                self.warnings.append(f"[Performance] {filename}: {len(inline_functions)} inline arrow functions in props. Creates new function every render. Use useCallback.")
+
+        # 2.9 Animation Properties Check
+        # Warn if animating expensive properties
+        animating_layout = bool(re.search(r'Animated\.timing.*(?:width|height|margin|padding)', content))
+        if animating_layout:
+            self.issues.append(f"[Performance] {filename}: Animating layout properties (width/height/margin). Use transform/opacity for 60fps.")
+
+        # --- 3. MOBILE NAVIGATION CHECKS ---
+
+        # 3.1 Tab Bar Max Items Check
+        tab_bar_items = len(re.findall(r'Tab\.Screen|createBottomTabNavigator|BottomTab', content))
+        if tab_bar_items > 5:
+            self.warnings.append(f"[Navigation] {filename}: {tab_bar_items} tab bar items (max 5 recommended). More than 5 becomes hard to tap.")
+
+        # 3.2 Tab State Preservation Check
+        has_tab_nav = bool(re.search(r'createBottomTabNavigator|Tab\.Navigator', content))
+        if has_tab_nav:
+            # Look for lazy prop (false preserves state)
+            has_lazy_false = bool(re.search(r'lazy:\s*false', content))
+            if not has_lazy_false:
+                self.warnings.append(f"[Navigation] {filename}: Tab navigation without lazy: false. Tabs may lose state on switch.")
+
+        # 3.3 Back Handling Check
+        has_back_listener = bool(re.search(r'BackHandler|useFocusEffect|navigation\.addListener', content))
+        has_custom_back = bool(re.search(r'onBackPress|handleBackPress', content))
+        if has_custom_back and not has_back_listener:
+            self.warnings.append(f"[Navigation] {filename}: Custom back handling without BackHandler listener. May not work correctly.")
+
+        # 3.4 Deep Link Support Check
+        has_linking = bool(re.search(r'Linking\.|Linking\.openURL|deepLink|universalLink', content))
+        has_config = bool(re.search(r'apollo-link|react-native-screens|navigation\.link', content))
+        if not has_linking and not has_config:
+            self.passed_count += 1
+        else:
+            if has_linking and not has_config:
+                self.warnings.append(f"[Navigation] {filename}: Deep linking detected but may lack proper configuration. Test notification/share flows.")
+
+        # --- 4. MOBILE TYPOGRAPHY CHECKS ---
+
+        # 4.1 System Font Check
+        if is_react_native:
+            has_custom_font = bool(re.search(r"fontFamily:\s*[\"'][^\"']+", content))
+            has_system_font = bool(re.search(r"fontFamily:\s*[\"']?(?:System|San Francisco|Roboto|-apple-system)", content))
+            if has_custom_font and not has_system_font:
+                self.warnings.append(f"[Typography] {filename}: Custom font detected. Consider system fonts (iOS: SF Pro, Android: Roboto) for native feel.")
+
+        # 4.2 Text Scaling Check (iOS Dynamic Type)
+        if is_react_native:
+            has_font_sizes = bool(re.search(r'fontSize:', content))
+            has_scaling = bool(re.search(r'allowFontScaling:\s*true|responsiveFontSize|useWindowDimensions', content))
+            if has_font_sizes and not has_scaling:
+                self.warnings.append(f"[Typography] {filename}: Fixed font sizes without scaling support. Consider allowFontScaling for accessibility.")
+
+        # 4.3 Mobile Line Height Check
+        line_heights = re.findall(r'lineHeight:\s*([\d.]+)', content)
+        for lh in line_heights:
+            if float(lh) > 1.8:
+                self.warnings.append(f"[Typography] {filename}: lineHeight {lh} too high for mobile. Mobile text needs tighter spacing (1.3-1.5).")
+
+        # 4.4 Font Size Limits
+        font_sizes = re.findall(r'fontSize:\s*([\d.]+)', content)
+        for fs in font_sizes:
+            size = float(fs)
+            if size < 12:
+                self.warnings.append(f"[Typography] {filename}: fontSize {size}px below 12px minimum readability.")
+            elif size > 32:
+                self.warnings.append(f"[Typography] {filename}: fontSize {size}px very large. Consider using responsive scaling.")
+
+        # --- 5. MOBILE COLOR SYSTEM CHECKS ---
+
+        # 5.1 Pure Black Avoidance
+        if re.search(r'#000000|color:\s*black|backgroundColor:\s*["\']?black', content):
+            self.warnings.append(f"[Color] {filename}: Pure black (#000000) detected. Use dark gray (#1C1C1E iOS, #121212 Android) for better OLED/battery.")
+
+        # 5.2 Dark Mode Support
+        has_color_schemes = bool(re.search(r'useColorScheme|colorScheme|appearance:\s*["\']?dark', content))
+        has_dark_mode_style = bool(re.search(r'\\\?.*dark|style:\s*.*dark|isDark', content))
+        if not has_color_schemes and not has_dark_mode_style:
+            self.warnings.append(f"[Color] {filename}: No dark mode support detected. Consider useColorScheme for system dark mode.")
+
+        # --- 6. PLATFORM iOS CHECKS ---
+
+        if is_react_native:
+            # 6.1 SF Symbols Check
+            has_ios_icons = bool(re.search(r'@expo/vector-icons|ionicons', content))
+            has_sf_symbols = bool(re.search(r'sf-symbol|SF Symbols', content))
+            if has_ios_icons and not has_sf_symbols:
+                self.passed_count += 1
+
+            # 6.2 iOS Haptic Types
+            has_haptic_import = bool(re.search(r'expo-haptics|react-native-haptic-feedback', content))
+            has_haptic_types = bool(re.search(r'ImpactFeedback|NotificationFeedback|SelectionFeedback', content))
+            if has_haptic_import and not has_haptic_types:
+                self.warnings.append(f"[iOS Haptics] {filename}: Haptic library imported but not using typed haptics (Impact/Notification/Selection).")
+
+            # 6.3 iOS Safe Area
+            has_safe_area = bool(re.search(r'SafeAreaView|useSafeAreaInsets|safeArea', content))
+            if not has_safe_area:
+                self.warnings.append(f"[iOS] {filename}: No SafeArea detected. Content may be hidden by notch/home indicator.")
+
+        # --- 7. PLATFORM ANDROID CHECKS ---
+
+        if is_react_native:
+            # 7.1 Material Icons Check
+            has_material_icons = bool(re.search(r'@expo/vector-icons|MaterialIcons', content))
+            if has_material_icons:
+                self.passed_count += 1
+
+            # 7.2 Ripple Effect
+            has_ripple = bool(re.search(r'ripple|android_ripple|foregroundRipple', content))
+            has_pressable = bool(re.search(r'Pressable|Touchable', content))
+            if has_pressable and not has_ripple:
+                self.warnings.append(f"[Android] {filename}: Touchable without ripple effect. Android users expect ripple feedback.")
+
+            # 7.3 Hardware Back Button
+            if is_react_native:
+                has_back_button = bool(re.search(r'BackHandler|useBackHandler', content))
+                has_navigation = bool(re.search(r'@react-navigation', content))
+                if has_navigation and not has_back_button:
+                    self.warnings.append(f"[Android] {filename}: React Navigation detected without BackHandler listener. Android hardware back may not work correctly.")
+
+        # --- 8. MOBILE BACKEND CHECKS ---
+
+        # 8.1 Secure Storage Check
+        has_async_storage = bool(re.search(r'AsyncStorage|@react-native-async-storage', content))
+        has_secure_storage = bool(re.search(r'SecureStore|Keychain|EncryptedSharedPreferences', content))
+        has_token_storage = bool(re.search(r'token|jwt|auth.*storage', content, re.IGNORECASE))
+        if has_token_storage and has_async_storage and not has_secure_storage:
+            self.issues.append(f"[Security] {filename}: Storing auth tokens in AsyncStorage (insecure). Use SecureStore (iOS) / EncryptedSharedPreferences (Android).")
+
+        # 8.2 Offline Handling Check
+        has_network = bool(re.search(r'fetch|axios|netinfo|@react-native-community/netinfo', content))
+        has_offline = bool(re.search(r'offline|isConnected|netInfo|cache.*offline', content))
+        if has_network and not has_offline:
+            self.warnings.append(f"[Offline] {filename}: Network requests detected without offline handling. Consider NetInfo for connection status.")
+
+        # 8.3 Push Notification Support
+        has_push = bool(re.search(r'Notifications|pushNotification|Firebase\.messaging|PushNotificationIOS', content))
+        has_push_handler = bool(re.search(r'onNotification|addNotificationListener|notification\.open', content))
+        if has_push and not has_push_handler:
+            self.warnings.append(f"[Push] {filename}: Push notifications imported but no handler found. May miss notifications.")
+
+        # --- 9. EXTENDED MOBILE TYPOGRAPHY CHECKS ---
+
+        # 9.1 iOS Type Scale Check
+        if is_react_native:
+            # Check for iOS text styles that match HIG
+            has_large_title = bool(re.search(r'fontSize:\s*34|largeTitle|font-weight:\s*["\']?bold', content))
+            has_title_1 = bool(re.search(r'fontSize:\s*28', content))
+            has_headline = bool(re.search(r'fontSize:\s*17.*semibold|headline', content))
+            has_body = bool(re.search(r'fontSize:\s*17.*regular|body', content))
+
+            # Check if following iOS scale roughly
+            font_sizes = re.findall(r'fontSize:\s*([\d.]+)', content)
+            ios_scale_sizes = [34, 28, 22, 20, 17, 16, 15, 13, 12, 11]
+            matching_ios = sum(1 for size in font_sizes if any(abs(float(size) - ios_size) < 1 for ios_size in ios_scale_sizes))
+
+            if len(font_sizes) > 3 and matching_ios < len(font_sizes) / 2:
+                self.warnings.append(f"[iOS Typography] {filename}: Font sizes don't match iOS type scale. Consider iOS text styles for native feel.")
+
+        # 9.2 Android Material Type Scale Check
+        if is_react_native:
+            # Check for Material 3 text styles
+            has_display = bool(re.search(r'fontSize:\s*[456][0-9]|display', content))
+            has_headline_material = bool(re.search(r'fontSize:\s*[23][0-9]|headline', content))
+            has_title_material = bool(re.search(r'fontSize:\s*2[12][0-9].*medium|title', content))
+            has_body_material = bool(re.search(r'fontSize:\s*1[456].*regular|body', content))
+            has_label = bool(re.search(r'fontSize:\s*1[1234].*medium|label', content))
+
+            # Check if using sp (scale-independent pixels)
+            uses_sp = bool(re.search(r'\d+\s*sp\b', content))
+            if has_display or has_headline_material:
+                if not uses_sp:
+                    self.warnings.append(f"[Android Typography] {filename}: Material typography detected without sp units. Use sp for text to respect user font size preferences.")
+
+        # 9.3 Modular Scale Check
+        # Check if font sizes follow modular scale
+        font_sizes = re.findall(r'fontSize:\s*(\d+(?:\.\d+)?)', content)
+        if len(font_sizes) > 3:
+            sorted_sizes = sorted(set([float(s) for s in font_sizes]))
+            ratios = []
+            for i in range(1, len(sorted_sizes)):
+                if sorted_sizes[i-1] > 0:
+                    ratios.append(sorted_sizes[i] / sorted_sizes[i-1])
+
+            # Common ratios: 1.125, 1.2, 1.25, 1.333, 1.5
+            common_ratios = {1.125, 1.2, 1.25, 1.333, 1.5}
+            for ratio in ratios[:3]:
+                if not any(abs(ratio - cr) < 0.03 for cr in common_ratios):
+                    self.warnings.append(f"[Typography] {filename}: Font sizes may not follow modular scale (ratio: {ratio:.2f}). Consider consistent ratio.")
+                    break
+
+        # 9.4 Line Length Check (Mobile-specific)
+        # Mobile text should be 40-60 characters max
+        if is_react_native:
+            has_long_text = bool(re.search(r'<Text[^>]*>[^<]{40,}', content))
+            has_max_width = bool(re.search(r'maxWidth|max-w-\d+|width:\s*["\']?\d+', content))
+            if has_long_text and not has_max_width:
+                self.warnings.append(f"[Mobile Typography] {filename}: Text without max-width constraint. Mobile text should be 40-60 characters per line for readability.")
+
+        # 9.5 Font Weight Pattern Check
+        # Check for font weight distribution
+        if is_react_native:
+            font_weights = re.findall(r'fontWeight:\s*["\']?(\d+|normal|bold|medium|light)', content)
+            weight_map = {'normal': '400', 'light': '300', 'medium': '500', 'bold': '700'}
+            numeric_weights = []
+            for w in font_weights:
+                val = weight_map.get(w.lower(), w)
+                try:
+                    numeric_weights.append(int(val))
+                except:
+                    pass
+
+            # Check if overusing bold (mobile should be regular-dominant)
+            bold_count = sum(1 for w in numeric_weights if w >= 700)
+            regular_count = sum(1 for w in numeric_weights if 400 <= w < 500)
+            if bold_count > regular_count:
+                self.warnings.append(f"[Mobile Typography] {filename}: More bold weights than regular. Mobile typography should be regular-dominant for readability.")
+
+        # --- 10. EXTENDED MOBILE COLOR SYSTEM CHECKS ---
+
+        # 10.1 OLED Optimization Check
+        # Check for near-black colors instead of pure black
+        if re.search(r'#121212|#1A1A1A|#0D0D0D', content):
+            self.passed_count += 1  # Good OLED optimization
+        elif re.search(r'backgroundColor:\s*["\']?#000000', content):
+            # Using pure black for background is OK for OLED
+            pass
+        elif re.search(r'backgroundColor:\s*["\']?#[0-9A-Fa-f]{6}', content):
+            # Check if using light colors in dark mode (bad for OLED)
+            self.warnings.append(f"[Mobile Color] {filename}: Consider OLED-optimized dark backgrounds (#121212 Android, #000000 iOS) for battery savings.")
+
+        # 10.2 Saturated Color Detection (Battery)
+        # Highly saturated colors consume more power on OLED
+        hex_colors = re.findall(r'#([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})', content)
+        saturated_count = 0
+        for r, g, b in hex_colors:
+            # Convert to RGB 0-255
+            try:
+                r_val, g_val, b_val = int(r, 16), int(g, 16), int(b, 16)
+                max_val = max(r_val, g_val, b_val)
+                min_val = min(r_val, g_val, b_val)
+                # Saturation = (max - min) / max
+                if max_val > 0:
+                    saturation = (max_val - min_val) / max_val
+                    if saturation > 0.8:  # Highly saturated
+                        saturated_count += 1
+            except:
+                pass
+
+        if saturated_count > 10:
+            self.warnings.append(f"[Mobile Color] {filename}: {saturated_count} highly saturated colors detected. Desaturated colors save battery on OLED screens.")
+
+        # 10.3 Outdoor Visibility Check
+        # Low contrast combinations fail in outdoor sunlight
+        light_colors = re.findall(r'#[0-9A-Fa-f]{6}|rgba?\([^)]+\)', content)
+        # Check for potential low contrast (light gray on white, dark gray on black)
+        potential_low_contrast = bool(re.search(r'#[EeEeEeEe].*#ffffff|#999999.*#ffffff|#333333.*#000000|#666666.*#000000', content))
+        if potential_low_contrast:
+            self.warnings.append(f"[Mobile Color] {filename}: Possible low contrast combination detected. Critical for outdoor visibility. Ensure WCAG AAA (7:1) for mobile.")
+
+        # 10.4 Dark Mode Text Color Check
+        # In dark mode, text should not be pure white
+        has_dark_mode = bool(re.search(r'dark:\s*|isDark|useColorScheme|colorScheme:\s*["\']?dark', content))
+        if has_dark_mode:
+            has_pure_white_text = bool(re.search(r'color:\s*["\']?#ffffff|#fff["\']?\}|textColor:\s*["\']?white', content))
+            if has_pure_white_text:
+                self.warnings.append(f"[Mobile Color] {filename}: Pure white text (#FFFFFF) in dark mode. Use #E8E8E8 or light gray for better readability.")
+
+        # --- 11. EXTENDED PLATFORM IOS CHECKS ---
+
+        if is_react_native:
+            # 11.1 SF Pro Font Detection
+            has_sf_pro = bool(re.search(r'SF Pro|SFPro|fontFamily:\s*["\']?[-\s]*SF', content))
+            has_custom_font = bool(re.search(r'fontFamily:\s*["\'][^"\']+', content))
+            if has_custom_font and not has_sf_pro:
+                self.warnings.append(f"[iOS] {filename}: Custom font without SF Pro fallback. Consider SF Pro Text for body, SF Pro Display for headings.")
+
+            # 11.2 iOS System Colors Check
+            # Check for semantic color usage
+            has_label = bool(re.search(r'color:\s*["\']?label|\.label', content))
+            has_secondaryLabel = bool(re.search(r'secondaryLabel|\.secondaryLabel', content))
+            has_systemBackground = bool(re.search(r'systemBackground|\.systemBackground', content))
+
+            has_hardcoded_gray = bool(re.search(r'#[78]0{4}', content))
+            if has_hardcoded_gray and not (has_label or has_secondaryLabel):
+                self.warnings.append(f"[iOS] {filename}: Hardcoded gray colors detected. Consider iOS semantic colors (label, secondaryLabel) for automatic dark mode.")
+
+            # 11.3 iOS Accent Colors Check
+            ios_blue = bool(re.search(r'#007AFF|#0A84FF|systemBlue', content))
+            ios_green = bool(re.search(r'#34C759|#30D158|systemGreen', content))
+            ios_red = bool(re.search(r'#FF3B30|#FF453A|systemRed', content))
+
+            has_custom_primary = bool(re.search(r'primaryColor|theme.*primary|colors\.primary', content))
+            if has_custom_primary and not (ios_blue or ios_green or ios_red):
+                self.warnings.append(f"[iOS] {filename}: Custom primary color without iOS system color fallback. Consider systemBlue for consistent iOS feel.")
+
+            # 11.4 iOS Navigation Patterns Check
+            has_navigation_bar = bool(re.search(r'navigationOptions|headerStyle|cardStyle', content))
+            has_header_title = bool(re.search(r'title:\s*["\']|headerTitle|navigation\.setOptions', content))
+            if has_navigation_bar and not has_header_title:
+                self.warnings.append(f"[iOS] {filename}: Navigation bar detected without title. iOS apps should have clear context in nav bar.")
+
+            # 11.5 iOS Component Patterns Check
+            # Check for iOS-specific components
+            has_alert = bool(re.search(r'Alert\.alert|showAlert', content))
+            has_action_sheet = bool(re.search(r'ActionSheet|ActionSheetIOS|showActionSheetWithOptions', content))
+            has_activity_indicator = bool(re.search(r'ActivityIndicator|ActivityIndic', content))
+
+            if has_alert or has_action_sheet or has_activity_indicator:
+                self.passed_count += 1  # Good iOS component usage
+
+        # --- 12. EXTENDED PLATFORM ANDROID CHECKS ---
+
+        if is_react_native:
+            # 12.1 Roboto Font Detection
+            has_roboto = bool(re.search(r'Roboto|fontFamily:\s*["\']?[-\s]*Roboto', content))
+            has_custom_font = bool(re.search(r'fontFamily:\s*["\'][^"\']+', content))
+            if has_custom_font and not has_roboto:
+                self.warnings.append(f"[Android] {filename}: Custom font without Roboto fallback. Roboto is optimized for Android displays.")
+
+            # 12.2 Material 3 Dynamic Color Check
+            has_material_colors = bool(re.search(r'MD3|MaterialYou|dynamicColor|useColorScheme', content))
+            has_theme_provider = bool(re.search(r'MaterialTheme|ThemeProvider|PaperProvider|ThemeProvider', content))
+            if not has_material_colors and not has_theme_provider:
+                self.warnings.append(f"[Android] {filename}: No Material 3 dynamic color detected. Consider Material 3 theming for personalized feel.")
+
+            # 12.3 Material Elevation Check
+            # Check for elevation values (Material 3 uses elevation for depth)
+            has_elevation = bool(re.search(r'elevation:\s*\d+|shadowOpacity|shadowRadius|android:elevation', content))
+            has_box_shadow = bool(re.search(r'boxShadow:', content))
+            if has_box_shadow and not has_elevation:
+                self.warnings.append(f"[Android] {filename}: CSS box-shadow detected without elevation. Consider Material elevation system for consistent depth.")
+
+            # 12.4 Material Component Patterns Check
+            # Check for Material components
+            has_ripple = bool(re.search(r'ripple|android_ripple|foregroundRipple', content))
+            has_card = bool(re.search(r'Card|Paper|elevation.*\d+', content))
+            has_fab = bool(re.search(r'FAB|FloatingActionButton|fab', content))
+            has_snackbar = bool(re.search(r'Snackbar|showSnackBar|Toast', content))
+
+            material_component_count = sum([has_ripple, has_card, has_fab, has_snackbar])
+            if material_component_count >= 2:
+                self.passed_count += 1  # Good Material design usage
+
+            # 12.5 Android Navigation Patterns Check
+            has_top_app_bar = bool(re.search(r'TopAppBar|AppBar|CollapsingToolbar', content))
+            has_bottom_nav = bool(re.search(r'BottomNavigation|BottomNav', content))
+            has_navigation_rail = bool(re.search(r'NavigationRail', content))
+
+            if has_bottom_nav:
+                self.passed_count += 1  # Good Android pattern
+            elif has_top_app_bar and not (has_bottom_nav or has_navigation_rail):
+                self.warnings.append(f"[Android] {filename}: TopAppBar without bottom navigation. Consider BottomNavigation for thumb-friendly access.")
+
+        # --- 13. MOBILE TESTING CHECKS ---
+
+        # 13.1 Testing Tool Detection
+        has_rntl = bool(re.search(r'react-native-testing-library|@testing-library', content))
+        has_detox = bool(re.search(r'detox|element\(|by\.text|by\.id', content))
+        has_maestro = bool(re.search(r'maestro|\.yaml$', content))
+        has_jest = bool(re.search(r'jest|describe\(|test\(|it\(', content))
+
+        testing_tools = []
+        if has_jest: testing_tools.append('Jest')
+        if has_rntl: testing_tools.append('RNTL')
+        if has_detox: testing_tools.append('Detox')
+        if has_maestro: testing_tools.append('Maestro')
+
+        if len(testing_tools) == 0:
+            self.warnings.append(f"[Testing] {filename}: No testing framework detected. Consider Jest (unit) + Detox/Maestro (E2E) for mobile.")
+
+        # 13.2 Test Pyramid Balance Check
+        test_files = len(re.findall(r'\.test\.(tsx|ts|js|jsx)|\.spec\.', content))
+        e2e_tests = len(re.findall(r'detox|maestro|e2e|spec\.e2e', content.lower()))
+
+        if test_files > 0 and e2e_tests == 0:
+            self.warnings.append(f"[Testing] {filename}: Unit tests found but no E2E tests. Mobile needs E2E on real devices for complete coverage.")
+
+        # 13.3 Accessibility Label Check (Mobile-specific)
+        if is_react_native:
+            has_pressable = bool(re.search(r'Pressable|TouchableOpacity|TouchableHighlight', content))
+            has_a11y_label = bool(re.search(r'accessibilityLabel|aria-label|testID', content))
+            if has_pressable and not has_a11y_label:
+                self.warnings.append(f"[A11y Mobile] {filename}: Touchable element without accessibilityLabel. Screen readers need labels for all interactive elements.")
+
+        # --- 14. MOBILE DEBUGGING CHECKS ---
+
+        # 14.1 Performance Profiling Check
+        has_performance = bool(re.search(r'Performance|systrace|profile|Flipper', content))
+        has_console_log = len(re.findall(r'console\.(log|warn|error|debug|info)', content))
+        has_debugger = bool(re.search(r'debugger|__DEV__|React\.DevTools', content))
+
+        if has_console_log > 10:
+            self.warnings.append(f"[Debugging] {filename}: {has_console_log} console.log statements. Remove before production; they block JS thread.")
+
+        if has_performance:
+            self.passed_count += 1  # Good performance monitoring
+
+        # 14.2 Error Boundary Check
+        has_error_boundary = bool(re.search(r'ErrorBoundary|componentDidCatch|getDerivedStateFromError', content))
+        if not has_error_boundary and is_react_native:
+            self.warnings.append(f"[Debugging] {filename}: No ErrorBoundary detected. Consider adding ErrorBoundary to prevent app crashes.")
+
+        # 14.3 Hermes Check (React Native specific)
+        if is_react_native:
+            # Check if using Hermes engine (should be default in modern RN)
+            # This is more of a configuration check, not code pattern
+            self.passed_count += 1  # Hermes is default in RN 0.70+
+
+    def audit_directory(self, directory: str) -> None:
+        extensions = {'.tsx', '.ts', '.jsx', '.js', '.dart'}
+        for root, dirs, files in os.walk(directory):
+            dirs[:] = [d for d in dirs if d not in {'node_modules', '.git', 'dist', 'build', '.next', 'ios', 'android', 'build', '.idea'}]
+            for file in files:
+                if Path(file).suffix in extensions:
+                    self.audit_file(os.path.join(root, file))
+
+    def get_report(self):
+        return {
+            "files_checked": self.files_checked,
+            "issues": self.issues,
+            "warnings": self.warnings,
+            "passed_checks": self.passed_count,
+            "compliant": len(self.issues) == 0
+        }
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python mobile_audit.py <directory>")
+        sys.exit(1)
+
+    path = sys.argv[1]
+    is_json = "--json" in sys.argv
+
+    auditor = MobileAuditor()
+    if os.path.isfile(path):
+        auditor.audit_file(path)
+    else:
+        auditor.audit_directory(path)
+
+    report = auditor.get_report()
+
+    if is_json:
+        print(json.dumps(report, indent=2))
+    else:
+        print(f"\n[MOBILE AUDIT] {report['files_checked']} mobile files checked")
+        print("-" * 50)
+        if report['issues']:
+            print(f"[!] ISSUES ({len(report['issues'])}):")
+            for i in report['issues'][:10]:
+                print(f"  - {i}")
+        if report['warnings']:
+            print(f"[*] WARNINGS ({len(report['warnings'])}):")
+            for w in report['warnings'][:15]:
+                print(f"  - {w}")
+        print(f"[+] PASSED CHECKS: {report['passed_checks']}")
+        status = "PASS" if report['compliant'] else "FAIL"
+        print(f"STATUS: {status}")
+
+    sys.exit(0 if report['compliant'] else 1)
+
+
+if __name__ == "__main__":
+    # Fix missing import
+    import re
+    main()
diff --git a/.claude/skills/mobile-design/touch-psychology.md b/.claude/skills/mobile-design/touch-psychology.md
new file mode 100644
index 0000000..59e7839
--- /dev/null
+++ b/.claude/skills/mobile-design/touch-psychology.md
@@ -0,0 +1,537 @@
+# Touch Psychology Reference
+
+> Deep dive into mobile touch interaction, Fitts' Law for touch, thumb zone anatomy, gesture psychology, and haptic feedback.
+> **This is the mobile equivalent of ux-psychology.md - CRITICAL for all mobile work.**
+
+---
+
+## 1. Fitts' Law for Touch
+
+### The Fundamental Difference
+
+```
+DESKTOP (Mouse/Trackpad):
+├── Cursor size: 1 pixel (precision)
+├── Visual feedback: Hover states
+├── Error cost: Low (easy to retry)
+└── Target acquisition: Fast, precise
+
+MOBILE (Finger):
+├── Contact area: ~7mm diameter (imprecise)
+├── Visual feedback: No hover, only tap
+├── Error cost: High (frustrating retries)
+├── Occlusion: Finger covers the target
+└── Target acquisition: Slower, needs larger targets
+```
+
+### Fitts' Law Formula Adapted
+
+```
+Touch acquisition time = a + b × log₂(1 + D/W)
+
+Where:
+├── D = Distance to target
+├── W = Width of target
+└── For touch: W must be MUCH larger than desktop
+```
+
+### Minimum Touch Target Sizes
+
+| Platform | Minimum | Recommended | Use For |
+|----------|---------|-------------|---------|
+| **iOS (HIG)** | 44pt × 44pt | 48pt+ | All tappable elements |
+| **Android (Material)** | 48dp × 48dp | 56dp+ | All tappable elements |
+| **WCAG 2.2** | 44px × 44px | - | Accessibility compliance |
+| **Critical Actions** | - | 56-64px | Primary CTAs, destructive actions |
+
+### Visual Size vs Hit Area
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│    ┌─────────────────────────┐      │
+│    │                         │      │
+│    │    [  BUTTON  ]         │ ← Visual: 36px
+│    │                         │      │
+│    └─────────────────────────┘      │
+│                                     │ ← Hit area: 48px (padding extends)
+└─────────────────────────────────────┘
+
+✅ CORRECT: Visual can be smaller if hit area is minimum 44-48px
+❌ WRONG: Making hit area same as small visual element
+```
+
+### Application Rules
+
+| Element | Visual Size | Hit Area |
+|---------|-------------|----------|
+| Icon buttons | 24-32px | 44-48px (padding) |
+| Text links | Any | 44px height minimum |
+| List items | Full width | 48-56px height |
+| Checkboxes/Radio | 20-24px | 44-48px tap area |
+| Close/X buttons | 24px | 44px minimum |
+| Tab bar items | Icon 24-28px | Full tab width, 49px height (iOS) |
+
+---
+
+## 2. Thumb Zone Anatomy
+
+### One-Handed Phone Usage
+
+```
+Research shows: 49% of users hold phone one-handed.
+
+┌─────────────────────────────────────┐
+│                                     │
+│  ┌─────────────────────────────┐    │
+│  │       HARD TO REACH         │    │ ← Status bar, top nav
+│  │      (requires stretch)     │    │    Put: Back, menu, settings
+│  │                             │    │
+│  ├─────────────────────────────┤    │
+│  │                             │    │
+│  │       OK TO REACH           │    │ ← Content area
+│  │      (comfortable)          │    │    Put: Secondary actions, content
+│  │                             │    │
+│  ├─────────────────────────────┤    │
+│  │                             │    │
+│  │       EASY TO REACH         │    │ ← Tab bar, FAB zone
+│  │      (thumb's arc)          │    │    Put: PRIMARY CTAs!
+│  │                             │    │
+│  └─────────────────────────────┘    │
+│                                     │
+│          [    HOME    ]             │
+└─────────────────────────────────────┘
+```
+
+### Thumb Arc (Right-Handed User)
+
+```
+Right hand holding phone:
+
+┌───────────────────────────────┐
+│  STRETCH      STRETCH    OK   │
+│                               │
+│  STRETCH        OK       EASY │
+│                               │
+│    OK          EASY      EASY │
+│                               │
+│   EASY         EASY      EASY │
+└───────────────────────────────┘
+
+Left hand is mirrored.
+→ Design for BOTH hands or assume right-dominant
+```
+
+### Placement Guidelines
+
+| Element Type | Ideal Position | Reason |
+|--------------|----------------|--------|
+| **Primary CTA** | Bottom center/right | Easy thumb reach |
+| **Tab bar** | Bottom | Natural thumb position |
+| **FAB** | Bottom right | Easy for right hand |
+| **Navigation** | Top (stretch) | Less frequent use |
+| **Destructive actions** | Top left | Hard to reach = harder to accidentally tap |
+| **Dismiss/Cancel** | Top left | Convention + safety |
+| **Confirm/Done** | Top right or bottom | Convention |
+
+### Large Phone Considerations (>6")
+
+```
+On large phones, top 40% becomes "dead zone" for one-handed use.
+
+Solutions:
+├── Reachability features (iOS)
+├── Pull-down interfaces (drawer pulls content down)
+├── Bottom sheet navigation
+├── Floating action buttons
+└── Gesture-based alternatives to top actions
+```
+
+---
+
+## 3. Touch vs Click Psychology
+
+### Expectation Differences
+
+| Aspect | Click (Desktop) | Touch (Mobile) |
+|--------|-----------------|----------------|
+| **Feedback timing** | Can wait 100ms | Expect instant (<50ms) |
+| **Visual feedback** | Hover → Click | Immediate tap response |
+| **Error tolerance** | Easy retry | Frustrating, feels broken |
+| **Precision** | High | Low |
+| **Context menu** | Right-click | Long press |
+| **Cancel action** | ESC key | Swipe away, outside tap |
+
+### Touch Feedback Requirements
+
+```
+Tap → Immediate visual change (< 50ms)
+├── Highlight state (background color change)
+├── Scale down slightly (0.95-0.98)
+├── Ripple effect (Android Material)
+├── Haptic feedback for confirmation
+└── Never nothing!
+
+Loading → Show within 100ms
+├── If action takes > 100ms
+├── Show spinner/progress
+├── Disable button (prevent double tap)
+└── Optimistic UI when possible
+```
+
+### The "Fat Finger" Problem
+
+```
+Problem: Finger occludes target during tap
+├── User can't see exactly where they're tapping
+├── Visual feedback appears UNDER finger
+└── Increases error rate
+
+Solutions:
+├── Show feedback ABOVE touch point (tooltips)
+├── Use cursor-like offset for precision tasks
+├── Magnification loupe for text selection
+└── Large enough targets that precision doesn't matter
+```
+
+---
+
+## 4. Gesture Psychology
+
+### Gesture Discoverability Problem
+
+```
+Problem: Gestures are INVISIBLE.
+├── User must discover/remember them
+├── No hover/visual hint
+├── Different mental model than tap
+└── Many users never discover gestures
+
+Solution: Always provide visible alternative
+├── Swipe to delete → Also show delete button or menu
+├── Pull to refresh → Also show refresh button
+├── Pinch to zoom → Also show zoom controls
+└── Gestures as shortcuts, not only way
+```
+
+### Common Gesture Conventions
+
+| Gesture | Universal Meaning | Usage |
+|---------|-------------------|-------|
+| **Tap** | Select, activate | Primary action |
+| **Double tap** | Zoom in, like/favorite | Quick action |
+| **Long press** | Context menu, selection mode | Secondary options |
+| **Swipe horizontal** | Navigation, delete, actions | List actions |
+| **Swipe down** | Refresh, dismiss | Pull to refresh |
+| **Pinch** | Zoom in/out | Maps, images |
+| **Two-finger scroll** | Scroll within scroll | Nested scrolls |
+
+### Gesture Affordance Design
+
+```
+Swipe actions need visual hints:
+
+┌─────────────────────────────────────────┐
+│  ┌───┐                                  │
+│  │ ≡ │  Item with hidden actions...   → │ ← Edge hint (partial color)
+│  └───┘                                  │
+└─────────────────────────────────────────┘
+
+✅ Good: Slight color peek at edge suggesting swipe
+✅ Good: Drag handle icon ( ≡ ) suggesting reorder
+✅ Good: Onboarding tooltip explaining gesture
+❌ Bad: Hidden gestures with no visual affordance
+```
+
+### Platform Gesture Differences
+
+| Gesture | iOS | Android |
+|---------|-----|---------|
+| **Back** | Edge swipe from left | System back button/gesture |
+| **Share** | Action sheet | Share sheet |
+| **Context menu** | Long press / Force touch | Long press |
+| **Dismiss modal** | Swipe down | Back button or swipe |
+| **Delete in list** | Swipe left, tap delete | Swipe left, immediate or undo |
+
+---
+
+## 5. Haptic Feedback Patterns
+
+### Why Haptics Matter
+
+```
+Haptics provide:
+├── Confirmation without looking
+├── Richer, more premium feel
+├── Accessibility (blind users)
+├── Reduced error rate
+└── Emotional satisfaction
+
+Without haptics:
+├── Feels "cheap" or web-like
+├── User unsure if action registered
+└── Missed opportunity for delight
+```
+
+### iOS Haptic Types
+
+| Type | Intensity | Use Case |
+|------|-----------|----------|
+| `selection` | Light | Picker scroll, toggle, selection |
+| `light` | Light | Minor actions, hover equivalent |
+| `medium` | Medium | Standard tap confirmation |
+| `heavy` | Strong | Important completed, drop |
+| `success` | Pattern | Task completed successfully |
+| `warning` | Pattern | Warning, attention needed |
+| `error` | Pattern | Error occurred |
+
+### Android Haptic Types
+
+| Type | Use Case |
+|------|----------|
+| `CLICK` | Standard tap feedback |
+| `HEAVY_CLICK` | Important actions |
+| `DOUBLE_CLICK` | Confirm actions |
+| `TICK` | Scroll/scrub feedback |
+| `LONG_PRESS` | Long press activation |
+| `REJECT` | Error/invalid action |
+
+### Haptic Usage Guidelines
+
+```
+✅ DO use haptics for:
+├── Button taps
+├── Toggle switches
+├── Picker/slider values
+├── Pull to refresh trigger
+├── Successful action completion
+├── Errors and warnings
+├── Swipe action thresholds
+└── Important state changes
+
+❌ DON'T use haptics for:
+├── Every scroll position
+├── Every list item
+├── Background events
+├── Passive displays
+└── Too frequently (haptic fatigue)
+```
+
+### Haptic Intensity Mapping
+
+| Action Importance | Haptic Level | Example |
+|-------------------|--------------|---------|
+| Minor/Browsing | Light / None | Scrolling, hovering |
+| Standard Action | Medium / Selection | Tap, toggle |
+| Significant Action | Heavy / Success | Complete, confirm |
+| Critical/Destructive | Heavy / Warning | Delete, payment |
+| Error | Error pattern | Failed action |
+
+---
+
+## 6. Mobile Cognitive Load
+
+### How Mobile Differs from Desktop
+
+| Factor | Desktop | Mobile | Implication |
+|--------|---------|--------|-------------|
+| **Attention** | Focused sessions | Interrupted constantly | Design for micro-sessions |
+| **Context** | Controlled environment | Anywhere, any condition | Handle bad lighting, noise |
+| **Multitasking** | Multiple windows | One app visible | Complete task in-app |
+| **Input speed** | Fast (keyboard) | Slow (touch typing) | Minimize input, smart defaults |
+| **Error recovery** | Easy (undo, back) | Harder (no keyboard shortcuts) | Prevent errors, easy recovery |
+
+### Reducing Mobile Cognitive Load
+
+```
+1. ONE PRIMARY ACTION per screen
+   └── Clear what to do next
+   
+2. PROGRESSIVE DISCLOSURE
+   └── Show only what's needed now
+   
+3. SMART DEFAULTS
+   └── Pre-fill what you can
+   
+4. CHUNKING
+   └── Break long forms into steps
+   
+5. RECOGNITION over RECALL
+   └── Show options, don't make user remember
+   
+6. CONTEXT PERSISTENCE
+   └── Save state on interrupt/background
+```
+
+### Miller's Law for Mobile
+
+```
+Desktop: 7±2 items in working memory
+Mobile: Reduce to 5±1 (more distractions)
+
+Navigation: Max 5 tab bar items
+Options: Max 5 per menu level
+Steps: Max 5 visible steps in progress
+```
+
+### Hick's Law for Mobile
+
+```
+More choices = slower decisions
+
+Mobile impact: Even worse than desktop
+├── Smaller screen = less overview
+├── Scrolling required = items forgotten
+├── Interruptions = lost context
+└── Decision fatigue faster
+
+Solution: Progressive disclosure
+├── Start with 3-5 options
+├── "More" for additional
+├── Smart ordering (most used first)
+└── Previous selections remembered
+```
+
+---
+
+## 7. Touch Accessibility
+
+### Motor Impairment Considerations
+
+```
+Users with motor impairments may:
+├── Have tremors (need larger targets)
+├── Use assistive devices (different input method)
+├── Have limited reach (one-handed necessity)
+├── Need more time (avoid timeouts)
+└── Make accidental touches (need confirmation)
+
+Design responses:
+├── Generous touch targets (48dp+)
+├── Adjustable timing for gestures
+├── Undo for destructive actions
+├── Switch control support
+└── Voice control support
+```
+
+### Touch Target Spacing (A11y)
+
+```
+WCAG 2.2 Success Criterion 2.5.8:
+
+Touch targets MUST have:
+├── Width: ≥ 44px
+├── Height: ≥ 44px
+├── Spacing: ≥ 8px from adjacent targets
+
+OR the target is:
+├── Inline (within text)
+├── User-controlled (user can resize)
+├── Essential (no alternative design)
+```
+
+### Accessible Touch Patterns
+
+| Pattern | Accessible Implementation |
+|---------|---------------------------|
+| Swipe actions | Provide menu alternative |
+| Drag and drop | Provide select + move option |
+| Pinch zoom | Provide zoom buttons |
+| Force touch | Provide long press alternative |
+| Shake gesture | Provide button alternative |
+
+---
+
+## 8. Emotion in Touch
+
+### The Premium Feel
+
+```
+What makes touch feel "premium":
+├── Instant response (< 50ms)
+├── Appropriate haptic feedback
+├── Smooth 60fps animations
+├── Correct resistance/physics
+├── Sound feedback (when appropriate)
+└── Attention to spring physics
+```
+
+### Emotional Touch Feedback
+
+| Emotion | Touch Response |
+|---------|----------------|
+| Success | Haptic success + confetti/check |
+| Error | Haptic error + shake animation |
+| Warning | Haptic warning + attention color |
+| Delight | Unexpected smooth animation |
+| Power | Heavy haptic on significant action |
+
+### Trust Building Through Touch
+
+```
+Trust signals in touch interactions:
+├── Consistent behavior (same action = same response)
+├── Reliable feedback (never fails silently)
+├── Secure feel for sensitive actions
+├── Professional animations (not janky)
+└── No accidental actions (confirmation for destructive)
+```
+
+---
+
+## 9. Touch Psychology Checklist
+
+### Before Every Screen
+
+- [ ] **All touch targets ≥ 44-48px?**
+- [ ] **Primary CTA in thumb zone?**
+- [ ] **Destructive actions require confirmation?**
+- [ ] **Gesture alternatives exist (visible buttons)?**
+- [ ] **Haptic feedback on important actions?**
+- [ ] **Immediate visual feedback on tap?**
+- [ ] **Loading states for actions > 100ms?**
+
+### Before Release
+
+- [ ] **Tested on smallest supported device?**
+- [ ] **Tested one-handed on large phone?**
+- [ ] **All gestures have visible alternatives?**
+- [ ] **Haptics work correctly (test on device)?**
+- [ ] **Touch targets tested with accessibility settings?**
+- [ ] **No tiny close buttons or icons?**
+
+---
+
+## 10. Quick Reference Card
+
+### Touch Target Sizes
+
+```
+                     iOS        Android     WCAG
+Minimum:           44pt       48dp       44px
+Recommended:       48pt+      56dp+      -
+Spacing:           8pt+       8dp+       8px+
+```
+
+### Thumb Zone Actions
+
+```
+TOP:      Navigation, settings, back (infrequent)
+MIDDLE:   Content, secondary actions
+BOTTOM:   Primary CTA, tab bar, FAB (frequent)
+```
+
+### Haptic Selection
+
+```
+Light:    Selection, toggle, minor
+Medium:   Tap, standard action
+Heavy:    Confirm, complete, drop
+Success:  Task done
+Error:    Failed action
+Warning:  Attention needed
+```
+
+---
+
+> **Remember:** Every touch is a conversation between user and device. Make it feel natural, responsive, and respectful of human fingers—not precise cursor points.
diff --git a/.claude/skills/mobile-developer/SKILL.md b/.claude/skills/mobile-developer/SKILL.md
new file mode 100644
index 0000000..e9d4a02
--- /dev/null
+++ b/.claude/skills/mobile-developer/SKILL.md
@@ -0,0 +1,205 @@
+---
+name: mobile-developer
+description: Develop React Native, Flutter, or native mobile apps with modern
+  architecture patterns. Masters cross-platform development, native
+  integrations, offline sync, and app store optimization. Use PROACTIVELY for
+  mobile features, cross-platform code, or app optimization.
+metadata:
+  model: inherit
+---
+
+## Use this skill when
+
+- Working on mobile developer tasks or workflows
+- Needing guidance, best practices, or checklists for mobile developer
+
+## Do not use this skill when
+
+- The task is unrelated to mobile developer
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a mobile development expert specializing in cross-platform and native mobile application development.
+
+## Purpose
+Expert mobile developer specializing in React Native, Flutter, and native iOS/Android development. Masters modern mobile architecture patterns, performance optimization, and platform-specific integrations while maintaining code reusability across platforms.
+
+## Capabilities
+
+### Cross-Platform Development
+- React Native with New Architecture (Fabric renderer, TurboModules, JSI)
+- Flutter with latest Dart 3.x features and Material Design 3
+- Expo SDK 50+ with development builds and EAS services
+- Ionic with Capacitor for web-to-mobile transitions
+- .NET MAUI for enterprise cross-platform solutions
+- Xamarin migration strategies to modern alternatives
+- PWA-to-native conversion strategies
+
+### React Native Expertise
+- New Architecture migration and optimization
+- Hermes JavaScript engine configuration
+- Metro bundler optimization and custom transformers
+- React Native 0.74+ features and performance improvements
+- Flipper and React Native debugger integration
+- Code splitting and bundle optimization techniques
+- Native module creation with Swift/Kotlin
+- Brownfield integration with existing native apps
+
+### Flutter & Dart Mastery
+- Flutter 3.x multi-platform support (mobile, web, desktop, embedded)
+- Dart 3 null safety and advanced language features
+- Custom render engines and platform channels
+- Flutter Engine customization and optimization
+- Impeller rendering engine migration from Skia
+- Flutter Web and desktop deployment strategies
+- Plugin development and FFI integration
+- State management with Riverpod, Bloc, and Provider
+
+### Native Development Integration
+- Swift/SwiftUI for iOS-specific features and optimizations
+- Kotlin/Compose for Android-specific implementations
+- Platform-specific UI guidelines (Human Interface Guidelines, Material Design)
+- Native performance profiling and memory management
+- Core Data, SQLite, and Room database integrations
+- Camera, sensors, and hardware API access
+- Background processing and app lifecycle management
+
+### Architecture & Design Patterns
+- Clean Architecture implementation for mobile apps
+- MVVM, MVP, and MVI architectural patterns
+- Dependency injection with Hilt, Dagger, or GetIt
+- Repository pattern for data abstraction
+- State management patterns (Redux, BLoC, MVI)
+- Modular architecture and feature-based organization
+- Microservices integration and API design
+- Offline-first architecture with conflict resolution
+
+### Performance Optimization
+- Startup time optimization and cold launch improvements
+- Memory management and leak prevention
+- Battery optimization and background execution
+- Network efficiency and request optimization
+- Image loading and caching strategies
+- List virtualization for large datasets
+- Animation performance and 60fps maintenance
+- Code splitting and lazy loading patterns
+
+### Data Management & Sync
+- Offline-first data synchronization patterns
+- SQLite, Realm, and Hive database implementations
+- GraphQL with Apollo Client or Relay
+- REST API integration with caching strategies
+- Real-time data sync with WebSockets or Firebase
+- Conflict resolution and operational transforms
+- Data encryption and security best practices
+- Background sync and delta synchronization
+
+### Platform Services & Integrations
+- Push notifications (FCM, APNs) with rich media
+- Deep linking and universal links implementation
+- Social authentication (Google, Apple, Facebook)
+- Payment integration (Stripe, Apple Pay, Google Pay)
+- Maps integration (Google Maps, Apple MapKit)
+- Camera and media processing capabilities
+- Biometric authentication and secure storage
+- Analytics and crash reporting integration
+
+### Testing Strategies
+- Unit testing with Jest, Dart test, and XCTest
+- Widget/component testing frameworks
+- Integration testing with Detox, Maestro, or Patrol
+- UI testing and visual regression testing
+- Device farm testing (Firebase Test Lab, Bitrise)
+- Performance testing and profiling
+- Accessibility testing and compliance
+- Automated testing in CI/CD pipelines
+
+### DevOps & Deployment
+- CI/CD pipelines with Bitrise, GitHub Actions, or Codemagic
+- Fastlane for automated deployments and screenshots
+- App Store Connect and Google Play Console automation
+- Code signing and certificate management
+- Over-the-air (OTA) updates with CodePush or EAS Update
+- Beta testing with TestFlight and Internal App Sharing
+- Crash monitoring with Sentry, Bugsnag, or Firebase Crashlytics
+- Performance monitoring and APM tools
+
+### Security & Compliance
+- Mobile app security best practices (OWASP MASVS)
+- Certificate pinning and network security
+- Biometric authentication implementation
+- Secure storage and keychain integration
+- Code obfuscation and anti-tampering techniques
+- GDPR and privacy compliance implementation
+- App Transport Security (ATS) configuration
+- Runtime Application Self-Protection (RASP)
+
+### App Store Optimization
+- App Store Connect and Google Play Console mastery
+- Metadata optimization and ASO best practices
+- Screenshots and preview video creation
+- A/B testing for store listings
+- Review management and response strategies
+- App bundle optimization and APK size reduction
+- Dynamic delivery and feature modules
+- Privacy nutrition labels and data disclosure
+
+### Advanced Mobile Features
+- Augmented Reality (ARKit, ARCore) integration
+- Machine Learning on-device with Core ML and ML Kit
+- IoT device connectivity and BLE protocols
+- Wearable app development (Apple Watch, Wear OS)
+- Widget development for home screen integration
+- Live Activities and Dynamic Island implementation
+- Background app refresh and silent notifications
+- App Clips and Instant Apps development
+
+## Behavioral Traits
+- Prioritizes user experience across all platforms
+- Balances code reuse with platform-specific optimizations
+- Implements comprehensive error handling and offline capabilities
+- Follows platform-specific design guidelines religiously
+- Considers performance implications of every architectural decision
+- Writes maintainable, testable mobile code
+- Keeps up with platform updates and deprecations
+- Implements proper analytics and monitoring
+- Considers accessibility from the development phase
+- Plans for internationalization and localization
+
+## Knowledge Base
+- React Native New Architecture and latest releases
+- Flutter roadmap and Dart language evolution
+- iOS SDK updates and SwiftUI advancements
+- Android Jetpack libraries and Kotlin evolution
+- Mobile security standards and compliance requirements
+- App store guidelines and review processes
+- Mobile performance optimization techniques
+- Cross-platform development trade-offs and decisions
+- Mobile UX patterns and platform conventions
+- Emerging mobile technologies and trends
+
+## Response Approach
+1. **Assess platform requirements** and cross-platform opportunities
+2. **Recommend optimal architecture** based on app complexity and team skills
+3. **Provide platform-specific implementations** when necessary
+4. **Include performance optimization** strategies from the start
+5. **Consider offline scenarios** and error handling
+6. **Implement proper testing strategies** for quality assurance
+7. **Plan deployment and distribution** workflows
+8. **Address security and compliance** requirements
+
+## Example Interactions
+- "Architect a cross-platform e-commerce app with offline capabilities"
+- "Migrate React Native app to New Architecture with TurboModules"
+- "Implement biometric authentication across iOS and Android"
+- "Optimize Flutter app performance for 60fps animations"
+- "Set up CI/CD pipeline for automated app store deployments"
+- "Create native modules for camera processing in React Native"
+- "Implement real-time chat with offline message queueing"
+- "Design offline-first data sync with conflict resolution"
diff --git a/.claude/skills/mobile-first-design/SKILL.md b/.claude/skills/mobile-first-design/SKILL.md
new file mode 100644
index 0000000..0aaa431
--- /dev/null
+++ b/.claude/skills/mobile-first-design/SKILL.md
@@ -0,0 +1,305 @@
+---
+name: mobile-first-design
+description: Design for mobile devices first, then scale up to larger screens. Create responsive interfaces that work seamlessly across all device sizes.
+---
+
+# Mobile-First Design
+
+## Overview
+
+Mobile-first design prioritizes small screens as the starting point, ensuring core functionality works on all devices while leveraging larger screens for enhanced experience.
+
+## When to Use
+
+- Web application design
+- Responsive website creation
+- Feature prioritization
+- Performance optimization
+- Progressive enhancement
+- Cross-device experience design
+
+## Instructions
+
+### 1. **Mobile-First Principles**
+
+```yaml
+Mobile-First Approach:
+
+Step 1: Design for Mobile (320px - 480px)
+  - Constrained space forces priorities
+  - Focus on essential content and actions
+  - Single column layout
+  - Touch-friendly interactive elements
+
+Step 2: Enhance for Tablet (768px - 1024px)
+  - Add secondary content
+  - Multi-column layouts possible
+  - Optimize spacing and readability
+  - Take advantage of hover states
+
+Step 3: Optimize for Desktop (1200px+)
+  - Full-featured experience
+  - Advanced layouts
+  - Rich interactions
+  - Multiple columns and sidebars
+
+---
+
+## Responsive Breakpoints:
+
+Mobile: 320px - 480px
+  - iPhone SE, older phones
+  - Strict space constraints
+  - Touch-only interaction
+
+Tablet: 481px - 768px
+  - iPad mini, tablets
+  - More space available
+  - Touch + keyboard/mouse
+
+Large Tablet/Small Desktop: 769px - 1024px
+  - iPad Pro, small laptops
+  - Transitional breakpoint
+  - Both touch and pointer
+
+Desktop: 1025px - 1440px
+  - Standard laptops
+  - Full feature set
+  - Hover states enabled
+
+Large Desktop: 1441px+
+  - Ultrawide monitors
+  - Consider max-width container
+  - Avoid stretching too wide
+
+---
+
+## Mobile Design Patterns:
+
+Navigation:
+  Mobile: Hamburger menu, bottom tabs
+  Tablet: Side drawer
+  Desktop: Horizontal menu bar
+
+Forms:
+  Mobile: Single column, large touch targets (48px)
+  Tablet: 2 columns if space allows
+  Desktop: Multi-column, side-by-side labels
+
+Content Layout:
+  Mobile: Full width, single column
+  Tablet: 1-2 columns
+  Desktop: Multi-column, sidebar
+
+Images:
+  Mobile: Full width
+  Tablet: Full or constrained width
+  Desktop: Constrained width, may use columns
+```
+
+### 2. **Responsive Design Implementation**
+
+```python
+# Implement responsive CSS and layouts
+
+class ResponsiveDesign:
+    def create_responsive_grid(self, mobile_cols=1):
+        """CSS Grid responsive structure"""
+        return {
+            'mobile': {
+                'columns': 1,
+                'gap': '16px',
+                'breakpoint': 'max-width: 480px'
+            },
+            'tablet': {
+                'columns': 2,
+                'gap': '24px',
+                'breakpoint': '481px - 768px'
+            },
+            'desktop': {
+                'columns': 3,
+                'gap': '32px',
+                'breakpoint': 'min-width: 769px'
+            }
+        }
+
+    def responsive_typography(self):
+        """Fluid font sizes"""
+        return {
+            'h1': {
+                'mobile': '24px',
+                'tablet': '32px',
+                'desktop': '48px',
+                'line_height': {
+                    'mobile': '1.2',
+                    'desktop': '1.3'
+                }
+            },
+            'body': {
+                'mobile': '14px',
+                'tablet': '16px',
+                'desktop': '16px',
+                'line_height': '1.6'
+            }
+        }
+
+    def responsive_spacing(self):
+        """Adaptive padding and margins"""
+        return {
+            'container_padding': {
+                'mobile': '16px',
+                'tablet': '24px',
+                'desktop': '32px'
+            },
+            'section_margin': {
+                'mobile': '24px',
+                'desktop': '48px'
+            },
+            'touch_target_size': '44px minimum (Apple)'
+        }
+
+    def touch_friendly_design(self):
+        """Mobile interaction optimization"""
+        return {
+            'button_size': '44px x 44px minimum',
+            'touch_target_spacing': '8px minimum between',
+            'form_input_height': '44px + 16px padding',
+            'scrolling_area': 'Full width swipe friendly',
+            'modal_height': 'Max 85vh, scrollable',
+            'keyboard_awareness': 'Account for software keyboard'
+        }
+```
+
+### 3. **Mobile Performance**
+
+```yaml
+Mobile Performance Optimization:
+
+Image Optimization:
+  - Responsive images (srcset, picture element)
+  - WebP format with fallback
+  - Lazy loading for below-fold
+  - Compress ruthlessly
+  - Serve appropriately sized images
+
+Metric Goals:
+  - Mobile: <3 second First Contentful Paint
+  - Mobile: <4 second Largest Contentful Paint
+  - Mobile: < 100 Cumulative Layout Shift
+
+Bundle Size:
+  - Mobile: <100KB JavaScript (gzipped)
+  - Mobile: <50KB CSS (gzipped)
+  - Critical CSS inline
+
+Network:
+  - Minimize requests (combine files)
+  - Enable gzip compression
+  - Use CDN for assets
+  - Cache aggressively
+
+---
+
+Testing Devices:
+
+Physical Devices:
+  - iPhone SE (320px baseline)
+  - iPhone 13 Pro (390px)
+  - Samsung S21 (360px)
+  - iPad (768px)
+
+Emulation:
+  - Chrome DevTools device mode
+  - Responsive design mode
+  - Test orientation changes
+
+Real Device Testing:
+  - Test on actual devices
+  - Check touch interactions
+  - Verify performance
+  - Test with slow network
+```
+
+### 4. **Progressive Enhancement**
+
+```yaml
+Progressive Enhancement Strategy:
+
+Layer 1: Core Content (HTML)
+  - Semantic HTML
+  - Works without CSS or JavaScript
+  - Text content readable
+  - Forms functional
+
+Layer 2: Enhanced (CSS)
+  - Visual design
+  - Layout and spacing
+  - Colors and typography
+  - Responsive design
+
+Layer 3: Interactive (JavaScript)
+  - Progressive loading
+  - Form enhancements
+  - Smooth interactions
+  - Offline functionality
+  - Push notifications
+
+Fallback Approach:
+  - Input: range slider → Text input fallback
+  - Video: HTML5 video → Link to download
+  - Map: Interactive map → Static image link
+  - Single-page app → Server-side rendering
+
+---
+
+Testing Strategy:
+
+1. Disable JavaScript
+   - Core content still accessible
+   - Forms still submit
+   - Links work
+
+2. Slow 3G Network
+   - Page loads
+   - Critical content visible
+   - Non-critical lazy loads
+
+3. No Styles (CSS disabled)
+   - Content readable
+   - Text size appropriate
+   - Contrast sufficient
+```
+
+## Best Practices
+
+### ✅ DO
+- Design for smallest screen first
+- Test on real mobile devices
+- Use responsive images
+- Optimize for mobile performance
+- Make touch targets 44x44px minimum
+- Stack content vertically on mobile
+- Use hamburger menu on mobile
+- Hide non-essential content on mobile
+- Test with slow networks
+- Progressive enhancement approach
+
+### ❌ DON'T
+- Assume all mobile users have fast networks
+- Use desktop-only patterns on mobile
+- Ignore touch interaction needs
+- Make buttons too small
+- Forget about landscape orientation
+- Over-complicate mobile layout
+- Ignore mobile performance
+- Assume no keyboard (iPad users)
+- Skip mobile user testing
+- Forget about notches and safe areas
+
+## Mobile-First Design Tips
+
+- Use max-width containers (max 1200px typical)
+- Test on oldest iPhone SE (320px) for baseline
+- Implement touch-friendly spacing (48px minimum)
+- Use flexible layouts over fixed widths
+- Test with slow 3G network simulation
diff --git a/.claude/skills/mobile-ios-design/SKILL.md b/.claude/skills/mobile-ios-design/SKILL.md
new file mode 100644
index 0000000..1f622bf
--- /dev/null
+++ b/.claude/skills/mobile-ios-design/SKILL.md
@@ -0,0 +1,272 @@
+---
+name: mobile-ios-design
+description: Master iOS Human Interface Guidelines and SwiftUI patterns for building native iOS apps. Use when designing iOS interfaces, implementing SwiftUI views, or ensuring apps follow Apple's design principles.
+---
+
+# iOS Mobile Design
+
+Master iOS Human Interface Guidelines (HIG) and SwiftUI patterns to build polished, native iOS applications that feel at home on Apple platforms.
+
+## When to Use This Skill
+
+- Designing iOS app interfaces following Apple HIG
+- Building SwiftUI views and layouts
+- Implementing iOS navigation patterns (NavigationStack, TabView, sheets)
+- Creating adaptive layouts for iPhone and iPad
+- Using SF Symbols and system typography
+- Building accessible iOS interfaces
+- Implementing iOS-specific gestures and interactions
+- Designing for Dynamic Type and Dark Mode
+
+## Core Concepts
+
+### 1. Human Interface Guidelines Principles
+
+**Clarity**: Content is legible, icons are precise, adornments are subtle
+**Deference**: UI helps users understand content without competing with it
+**Depth**: Visual layers and motion convey hierarchy and enable navigation
+
+**Platform Considerations:**
+
+- **iOS**: Touch-first, compact displays, portrait orientation
+- **iPadOS**: Larger canvas, multitasking, pointer support
+- **visionOS**: Spatial computing, eye/hand input
+
+### 2. SwiftUI Layout System
+
+**Stack-Based Layouts:**
+
+```swift
+// Vertical stack with alignment
+VStack(alignment: .leading, spacing: 12) {
+    Text("Title")
+        .font(.headline)
+    Text("Subtitle")
+        .font(.subheadline)
+        .foregroundStyle(.secondary)
+}
+
+// Horizontal stack with flexible spacing
+HStack {
+    Image(systemName: "star.fill")
+    Text("Featured")
+    Spacer()
+    Text("View All")
+        .foregroundStyle(.blue)
+}
+```
+
+**Grid Layouts:**
+
+```swift
+// Adaptive grid that fills available width
+LazyVGrid(columns: [
+    GridItem(.adaptive(minimum: 150, maximum: 200))
+], spacing: 16) {
+    ForEach(items) { item in
+        ItemCard(item: item)
+    }
+}
+
+// Fixed column grid
+LazyVGrid(columns: [
+    GridItem(.flexible()),
+    GridItem(.flexible()),
+    GridItem(.flexible())
+], spacing: 12) {
+    ForEach(items) { item in
+        ItemThumbnail(item: item)
+    }
+}
+```
+
+### 3. Navigation Patterns
+
+**NavigationStack (iOS 16+):**
+
+```swift
+struct ContentView: View {
+    @State private var path = NavigationPath()
+
+    var body: some View {
+        NavigationStack(path: $path) {
+            List(items) { item in
+                NavigationLink(value: item) {
+                    ItemRow(item: item)
+                }
+            }
+            .navigationTitle("Items")
+            .navigationDestination(for: Item.self) { item in
+                ItemDetailView(item: item)
+            }
+        }
+    }
+}
+```
+
+**TabView:**
+
+```swift
+struct MainTabView: View {
+    @State private var selectedTab = 0
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            HomeView()
+                .tabItem {
+                    Label("Home", systemImage: "house")
+                }
+                .tag(0)
+
+            SearchView()
+                .tabItem {
+                    Label("Search", systemImage: "magnifyingglass")
+                }
+                .tag(1)
+
+            ProfileView()
+                .tabItem {
+                    Label("Profile", systemImage: "person")
+                }
+                .tag(2)
+        }
+    }
+}
+```
+
+### 4. System Integration
+
+**SF Symbols:**
+
+```swift
+// Basic symbol
+Image(systemName: "heart.fill")
+    .foregroundStyle(.red)
+
+// Symbol with rendering mode
+Image(systemName: "cloud.sun.fill")
+    .symbolRenderingMode(.multicolor)
+
+// Variable symbol (iOS 16+)
+Image(systemName: "speaker.wave.3.fill", variableValue: volume)
+
+// Symbol effect (iOS 17+)
+Image(systemName: "bell.fill")
+    .symbolEffect(.bounce, value: notificationCount)
+```
+
+**Dynamic Type:**
+
+```swift
+// Use semantic fonts
+Text("Headline")
+    .font(.headline)
+
+Text("Body text that scales with user preferences")
+    .font(.body)
+
+// Custom font that respects Dynamic Type
+Text("Custom")
+    .font(.custom("Avenir", size: 17, relativeTo: .body))
+```
+
+### 5. Visual Design
+
+**Colors and Materials:**
+
+```swift
+// Semantic colors that adapt to light/dark mode
+Text("Primary")
+    .foregroundStyle(.primary)
+Text("Secondary")
+    .foregroundStyle(.secondary)
+
+// System materials for blur effects
+Rectangle()
+    .fill(.ultraThinMaterial)
+    .frame(height: 100)
+
+// Vibrant materials for overlays
+Text("Overlay")
+    .padding()
+    .background(.regularMaterial, in: RoundedRectangle(cornerRadius: 12))
+```
+
+**Shadows and Depth:**
+
+```swift
+// Standard card shadow
+RoundedRectangle(cornerRadius: 16)
+    .fill(.background)
+    .shadow(color: .black.opacity(0.1), radius: 8, y: 4)
+
+// Elevated appearance
+.shadow(radius: 2, y: 1)
+.shadow(radius: 8, y: 4)
+```
+
+## Quick Start Component
+
+```swift
+import SwiftUI
+
+struct FeatureCard: View {
+    let title: String
+    let description: String
+    let systemImage: String
+
+    var body: some View {
+        HStack(spacing: 16) {
+            Image(systemName: systemImage)
+                .font(.title)
+                .foregroundStyle(.blue)
+                .frame(width: 44, height: 44)
+                .background(.blue.opacity(0.1), in: Circle())
+
+            VStack(alignment: .leading, spacing: 4) {
+                Text(title)
+                    .font(.headline)
+                Text(description)
+                    .font(.subheadline)
+                    .foregroundStyle(.secondary)
+                    .lineLimit(2)
+            }
+
+            Spacer()
+
+            Image(systemName: "chevron.right")
+                .foregroundStyle(.tertiary)
+        }
+        .padding()
+        .background(.background, in: RoundedRectangle(cornerRadius: 12))
+        .shadow(color: .black.opacity(0.05), radius: 4, y: 2)
+    }
+}
+```
+
+## Best Practices
+
+1. **Use Semantic Colors**: Always use `.primary`, `.secondary`, `.background` for automatic light/dark mode support
+2. **Embrace SF Symbols**: Use system symbols for consistency and automatic accessibility
+3. **Support Dynamic Type**: Use semantic fonts (`.body`, `.headline`) instead of fixed sizes
+4. **Add Accessibility**: Include `.accessibilityLabel()` and `.accessibilityHint()` modifiers
+5. **Use Safe Areas**: Respect `safeAreaInset` and avoid hardcoded padding at screen edges
+6. **Implement State Restoration**: Use `@SceneStorage` for preserving user state
+7. **Support iPad Multitasking**: Design for split view and slide over
+8. **Test on Device**: Simulator doesn't capture full haptic and performance experience
+
+## Common Issues
+
+- **Layout Breaking**: Use `.fixedSize()` sparingly; prefer flexible layouts
+- **Performance Issues**: Use `LazyVStack`/`LazyHStack` for long scrolling lists
+- **Navigation Bugs**: Ensure `NavigationLink` values are `Hashable`
+- **Dark Mode Problems**: Avoid hardcoded colors; use semantic or asset catalog colors
+- **Accessibility Failures**: Test with VoiceOver enabled
+- **Memory Leaks**: Watch for strong reference cycles in closures
+
+## Resources
+
+- [Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/)
+- [SwiftUI Documentation](https://developer.apple.com/documentation/swiftui)
+- [SF Symbols App](https://developer.apple.com/sf-symbols/)
+- [WWDC SwiftUI Sessions](https://developer.apple.com/videos/swiftui/)
diff --git a/.claude/skills/mobile-ios-design/references/hig-patterns.md b/.claude/skills/mobile-ios-design/references/hig-patterns.md
new file mode 100644
index 0000000..978ec41
--- /dev/null
+++ b/.claude/skills/mobile-ios-design/references/hig-patterns.md
@@ -0,0 +1,529 @@
+# iOS Human Interface Guidelines Patterns
+
+## Layout and Spacing
+
+### Standard Margins and Padding
+
+```swift
+// System standard margins
+private let standardMargin: CGFloat = 16
+private let compactMargin: CGFloat = 8
+private let largeMargin: CGFloat = 24
+
+// Content insets following HIG
+extension EdgeInsets {
+    static let standard = EdgeInsets(top: 16, leading: 16, bottom: 16, trailing: 16)
+    static let listRow = EdgeInsets(top: 12, leading: 16, bottom: 12, trailing: 16)
+    static let card = EdgeInsets(top: 16, leading: 16, bottom: 16, trailing: 16)
+}
+```
+
+### Safe Area Handling
+
+```swift
+struct SafeAreaAwareView: View {
+    var body: some View {
+        ScrollView {
+            LazyVStack(spacing: 16) {
+                ForEach(items) { item in
+                    ItemRow(item: item)
+                }
+            }
+            .padding(.horizontal)
+        }
+        .safeAreaInset(edge: .bottom) {
+            // Floating action area
+            HStack {
+                Button("Cancel") { }
+                    .buttonStyle(.bordered)
+                Spacer()
+                Button("Confirm") { }
+                    .buttonStyle(.borderedProminent)
+            }
+            .padding()
+            .background(.regularMaterial)
+        }
+    }
+}
+```
+
+### Adaptive Layouts
+
+```swift
+struct AdaptiveGridView: View {
+    @Environment(\.horizontalSizeClass) private var sizeClass
+
+    private var columns: [GridItem] {
+        switch sizeClass {
+        case .compact:
+            return [GridItem(.flexible())]
+        case .regular:
+            return [
+                GridItem(.flexible()),
+                GridItem(.flexible()),
+                GridItem(.flexible())
+            ]
+        default:
+            return [GridItem(.flexible())]
+        }
+    }
+
+    var body: some View {
+        ScrollView {
+            LazyVGrid(columns: columns, spacing: 16) {
+                ForEach(items) { item in
+                    ItemCard(item: item)
+                }
+            }
+            .padding()
+        }
+    }
+}
+```
+
+## Typography Hierarchy
+
+### System Font Styles
+
+```swift
+// HIG-compliant typography scale
+struct Typography {
+    // Titles
+    static let largeTitle = Font.largeTitle.weight(.bold)      // 34pt bold
+    static let title = Font.title.weight(.semibold)            // 28pt semibold
+    static let title2 = Font.title2.weight(.semibold)          // 22pt semibold
+    static let title3 = Font.title3.weight(.semibold)          // 20pt semibold
+
+    // Headlines and body
+    static let headline = Font.headline                         // 17pt semibold
+    static let body = Font.body                                 // 17pt regular
+    static let callout = Font.callout                          // 16pt regular
+
+    // Supporting text
+    static let subheadline = Font.subheadline                  // 15pt regular
+    static let footnote = Font.footnote                        // 13pt regular
+    static let caption = Font.caption                          // 12pt regular
+    static let caption2 = Font.caption2                        // 11pt regular
+}
+```
+
+### Custom Font with Dynamic Type
+
+```swift
+extension Font {
+    static func customBody(_ name: String) -> Font {
+        .custom(name, size: 17, relativeTo: .body)
+    }
+
+    static func customHeadline(_ name: String) -> Font {
+        .custom(name, size: 17, relativeTo: .headline)
+            .weight(.semibold)
+    }
+}
+
+// Usage
+Text("Custom styled text")
+    .font(.customBody("Avenir Next"))
+```
+
+## Color System
+
+### Semantic Colors
+
+```swift
+// Use semantic colors for automatic light/dark mode support
+extension Color {
+    // Labels
+    static let primaryLabel = Color.primary
+    static let secondaryLabel = Color.secondary
+    static let tertiaryLabel = Color(uiColor: .tertiaryLabel)
+
+    // Backgrounds
+    static let systemBackground = Color(uiColor: .systemBackground)
+    static let secondaryBackground = Color(uiColor: .secondarySystemBackground)
+    static let groupedBackground = Color(uiColor: .systemGroupedBackground)
+
+    // Fills
+    static let primaryFill = Color(uiColor: .systemFill)
+    static let secondaryFill = Color(uiColor: .secondarySystemFill)
+
+    // Separators
+    static let separator = Color(uiColor: .separator)
+    static let opaqueSeparator = Color(uiColor: .opaqueSeparator)
+}
+```
+
+### Tint Colors
+
+```swift
+// App-wide tint color
+struct AppColors {
+    static let primary = Color.blue
+    static let secondary = Color.purple
+    static let success = Color.green
+    static let warning = Color.orange
+    static let error = Color.red
+
+    // Semantic tints
+    static let interactive = Color.accentColor
+    static let destructive = Color.red
+}
+
+// Apply tint to views
+ContentView()
+    .tint(AppColors.primary)
+```
+
+## Navigation Patterns
+
+### Hierarchical Navigation
+
+```swift
+struct MasterDetailView: View {
+    @State private var selectedItem: Item?
+    @Environment(\.horizontalSizeClass) private var sizeClass
+
+    var body: some View {
+        NavigationSplitView {
+            // Sidebar
+            List(items, selection: $selectedItem) { item in
+                NavigationLink(value: item) {
+                    ItemRow(item: item)
+                }
+            }
+            .navigationTitle("Items")
+            .toolbar {
+                ToolbarItem(placement: .primaryAction) {
+                    Button("Add", systemImage: "plus") { }
+                }
+            }
+        } detail: {
+            // Detail view
+            if let item = selectedItem {
+                ItemDetailView(item: item)
+            } else {
+                ContentUnavailableView(
+                    "Select an Item",
+                    systemImage: "sidebar.leading"
+                )
+            }
+        }
+        .navigationSplitViewStyle(.balanced)
+    }
+}
+```
+
+### Tab-Based Navigation
+
+```swift
+struct MainTabView: View {
+    @State private var selectedTab: Tab = .home
+
+    enum Tab: String, CaseIterable {
+        case home, explore, notifications, profile
+
+        var title: String {
+            rawValue.capitalized
+        }
+
+        var systemImage: String {
+            switch self {
+            case .home: return "house"
+            case .explore: return "magnifyingglass"
+            case .notifications: return "bell"
+            case .profile: return "person"
+            }
+        }
+    }
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            ForEach(Tab.allCases, id: \.self) { tab in
+                NavigationStack {
+                    tabContent(for: tab)
+                }
+                .tabItem {
+                    Label(tab.title, systemImage: tab.systemImage)
+                }
+                .tag(tab)
+            }
+        }
+    }
+
+    @ViewBuilder
+    private func tabContent(for tab: Tab) -> some View {
+        switch tab {
+        case .home:
+            HomeView()
+        case .explore:
+            ExploreView()
+        case .notifications:
+            NotificationsView()
+        case .profile:
+            ProfileView()
+        }
+    }
+}
+```
+
+## Toolbar Patterns
+
+### Standard Toolbar Items
+
+```swift
+struct ContentView: View {
+    @State private var isEditing = false
+
+    var body: some View {
+        NavigationStack {
+            List { /* content */ }
+            .navigationTitle("Items")
+            .toolbar {
+                // Leading items
+                ToolbarItem(placement: .topBarLeading) {
+                    EditButton()
+                }
+
+                // Trailing items
+                ToolbarItemGroup(placement: .topBarTrailing) {
+                    Button("Filter", systemImage: "line.3.horizontal.decrease.circle") { }
+                    Button("Add", systemImage: "plus") { }
+                }
+
+                // Bottom bar
+                ToolbarItemGroup(placement: .bottomBar) {
+                    Button("Archive", systemImage: "archivebox") { }
+                    Spacer()
+                    Text("\(itemCount) items")
+                        .font(.footnote)
+                        .foregroundStyle(.secondary)
+                    Spacer()
+                    Button("Share", systemImage: "square.and.arrow.up") { }
+                }
+            }
+            .toolbarBackground(.visible, for: .bottomBar)
+        }
+    }
+}
+```
+
+### Search Integration
+
+```swift
+struct SearchableView: View {
+    @State private var searchText = ""
+    @State private var searchScope: SearchScope = .all
+    @State private var isSearching = false
+
+    enum SearchScope: String, CaseIterable {
+        case all, titles, content
+    }
+
+    var body: some View {
+        NavigationStack {
+            List(filteredItems) { item in
+                ItemRow(item: item)
+            }
+            .navigationTitle("Library")
+            .searchable(
+                text: $searchText,
+                isPresented: $isSearching,
+                placement: .navigationBarDrawer(displayMode: .always)
+            )
+            .searchScopes($searchScope) {
+                ForEach(SearchScope.allCases, id: \.self) { scope in
+                    Text(scope.rawValue.capitalized).tag(scope)
+                }
+            }
+        }
+    }
+}
+```
+
+## Feedback Patterns
+
+### Haptic Feedback
+
+```swift
+struct HapticFeedback {
+    static func impact(_ style: UIImpactFeedbackGenerator.FeedbackStyle = .medium) {
+        let generator = UIImpactFeedbackGenerator(style: style)
+        generator.impactOccurred()
+    }
+
+    static func notification(_ type: UINotificationFeedbackGenerator.FeedbackType) {
+        let generator = UINotificationFeedbackGenerator()
+        generator.notificationOccurred(type)
+    }
+
+    static func selection() {
+        let generator = UISelectionFeedbackGenerator()
+        generator.selectionChanged()
+    }
+}
+
+// Usage
+Button("Submit") {
+    HapticFeedback.notification(.success)
+    submit()
+}
+```
+
+### Visual Feedback
+
+```swift
+struct FeedbackButton: View {
+    let title: String
+    let action: () -> Void
+
+    @State private var showSuccess = false
+
+    var body: some View {
+        Button(title) {
+            action()
+            withAnimation {
+                showSuccess = true
+            }
+            DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
+                withAnimation {
+                    showSuccess = false
+                }
+            }
+        }
+        .overlay(alignment: .trailing) {
+            if showSuccess {
+                Image(systemName: "checkmark.circle.fill")
+                    .foregroundStyle(.green)
+                    .transition(.scale.combined(with: .opacity))
+            }
+        }
+    }
+}
+```
+
+## Accessibility
+
+### VoiceOver Support
+
+```swift
+struct AccessibleCard: View {
+    let item: Item
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            Text(item.title)
+                .font(.headline)
+            Text(item.subtitle)
+                .font(.subheadline)
+                .foregroundStyle(.secondary)
+
+            HStack {
+                Image(systemName: "star.fill")
+                Text("\(item.rating, specifier: "%.1f")")
+            }
+        }
+        .padding()
+        .accessibilityElement(children: .combine)
+        .accessibilityLabel("\(item.title), \(item.subtitle)")
+        .accessibilityValue("Rating: \(item.rating) stars")
+        .accessibilityHint("Double tap to view details")
+        .accessibilityAddTraits(.isButton)
+    }
+}
+```
+
+### Dynamic Type Support
+
+```swift
+struct DynamicTypeView: View {
+    @Environment(\.dynamicTypeSize) private var dynamicTypeSize
+
+    var body: some View {
+        Group {
+            if dynamicTypeSize.isAccessibilitySize {
+                // Stack vertically for accessibility sizes
+                VStack(alignment: .leading, spacing: 12) {
+                    leadingContent
+                    trailingContent
+                }
+            } else {
+                // Side-by-side for standard sizes
+                HStack {
+                    leadingContent
+                    Spacer()
+                    trailingContent
+                }
+            }
+        }
+    }
+
+    var leadingContent: some View {
+        Label("Items", systemImage: "folder")
+    }
+
+    var trailingContent: some View {
+        Text("12")
+            .foregroundStyle(.secondary)
+    }
+}
+```
+
+## Error Handling UI
+
+### Error States
+
+```swift
+struct ErrorView: View {
+    let error: Error
+    let retryAction: () async -> Void
+
+    var body: some View {
+        ContentUnavailableView {
+            Label("Unable to Load", systemImage: "exclamationmark.triangle")
+        } description: {
+            Text(error.localizedDescription)
+        } actions: {
+            Button("Try Again") {
+                Task {
+                    await retryAction()
+                }
+            }
+            .buttonStyle(.borderedProminent)
+        }
+    }
+}
+```
+
+### Empty States
+
+```swift
+struct EmptyStateView: View {
+    let title: String
+    let description: String
+    let systemImage: String
+    let action: (() -> Void)?
+    let actionTitle: String?
+
+    var body: some View {
+        ContentUnavailableView {
+            Label(title, systemImage: systemImage)
+        } description: {
+            Text(description)
+        } actions: {
+            if let action, let actionTitle {
+                Button(actionTitle, action: action)
+                    .buttonStyle(.borderedProminent)
+            }
+        }
+    }
+}
+
+// Usage
+EmptyStateView(
+    title: "No Photos",
+    description: "Take your first photo to get started.",
+    systemImage: "camera",
+    action: { showCamera = true },
+    actionTitle: "Take Photo"
+)
+```
diff --git a/.claude/skills/mobile-ios-design/references/ios-navigation.md b/.claude/skills/mobile-ios-design/references/ios-navigation.md
new file mode 100644
index 0000000..db3e537
--- /dev/null
+++ b/.claude/skills/mobile-ios-design/references/ios-navigation.md
@@ -0,0 +1,564 @@
+# iOS Navigation Patterns
+
+## NavigationStack (iOS 16+)
+
+### Basic Navigation
+
+```swift
+struct BasicNavigationView: View {
+    var body: some View {
+        NavigationStack {
+            List(items) { item in
+                NavigationLink(item.title, value: item)
+            }
+            .navigationTitle("Items")
+            .navigationDestination(for: Item.self) { item in
+                ItemDetailView(item: item)
+            }
+        }
+    }
+}
+```
+
+### Programmatic Navigation
+
+```swift
+struct ProgrammaticNavigationView: View {
+    @State private var path = NavigationPath()
+
+    var body: some View {
+        NavigationStack(path: $path) {
+            VStack(spacing: 20) {
+                Button("Go to Settings") {
+                    path.append(Destination.settings)
+                }
+
+                Button("Go to Profile") {
+                    path.append(Destination.profile)
+                }
+
+                Button("Deep Link to Item 123") {
+                    path.append(Destination.settings)
+                    path.append(Destination.itemDetail(id: 123))
+                }
+            }
+            .navigationTitle("Home")
+            .navigationDestination(for: Destination.self) { destination in
+                switch destination {
+                case .settings:
+                    SettingsView()
+                case .profile:
+                    ProfileView()
+                case .itemDetail(let id):
+                    ItemDetailView(itemId: id)
+                }
+            }
+        }
+    }
+
+    enum Destination: Hashable {
+        case settings
+        case profile
+        case itemDetail(id: Int)
+    }
+}
+```
+
+### Navigation State Persistence
+
+```swift
+struct PersistentNavigationView: View {
+    @SceneStorage("navigationPath") private var pathData: Data?
+    @State private var path = NavigationPath()
+
+    var body: some View {
+        NavigationStack(path: $path) {
+            ContentView()
+                .navigationDestination(for: Item.self) { item in
+                    ItemDetailView(item: item)
+                }
+        }
+        .onAppear {
+            restorePath()
+        }
+        .onChange(of: path) { _, newPath in
+            savePath(newPath)
+        }
+    }
+
+    private func savePath(_ path: NavigationPath) {
+        guard let representation = path.codable else { return }
+        pathData = try? JSONEncoder().encode(representation)
+    }
+
+    private func restorePath() {
+        guard let data = pathData,
+              let representation = try? JSONDecoder().decode(
+                NavigationPath.CodableRepresentation.self,
+                from: data
+              ) else { return }
+        path = NavigationPath(representation)
+    }
+}
+```
+
+## NavigationSplitView
+
+### Two-Column Layout
+
+```swift
+struct TwoColumnView: View {
+    @State private var selectedCategory: Category?
+    @State private var columnVisibility: NavigationSplitViewVisibility = .all
+
+    var body: some View {
+        NavigationSplitView(columnVisibility: $columnVisibility) {
+            // Sidebar
+            List(categories, selection: $selectedCategory) { category in
+                NavigationLink(value: category) {
+                    Label(category.name, systemImage: category.icon)
+                }
+            }
+            .navigationTitle("Categories")
+        } detail: {
+            // Detail
+            if let category = selectedCategory {
+                CategoryDetailView(category: category)
+            } else {
+                ContentUnavailableView(
+                    "Select a Category",
+                    systemImage: "sidebar.leading"
+                )
+            }
+        }
+        .navigationSplitViewStyle(.balanced)
+    }
+}
+```
+
+### Three-Column Layout
+
+```swift
+struct ThreeColumnView: View {
+    @State private var selectedFolder: Folder?
+    @State private var selectedDocument: Document?
+
+    var body: some View {
+        NavigationSplitView {
+            // Sidebar
+            List(folders, selection: $selectedFolder) { folder in
+                NavigationLink(value: folder) {
+                    Label(folder.name, systemImage: "folder")
+                }
+            }
+            .navigationTitle("Folders")
+        } content: {
+            // Content column
+            if let folder = selectedFolder {
+                List(folder.documents, selection: $selectedDocument) { document in
+                    NavigationLink(value: document) {
+                        DocumentRow(document: document)
+                    }
+                }
+                .navigationTitle(folder.name)
+            } else {
+                Text("Select a folder")
+            }
+        } detail: {
+            // Detail column
+            if let document = selectedDocument {
+                DocumentDetailView(document: document)
+            } else {
+                ContentUnavailableView(
+                    "Select a Document",
+                    systemImage: "doc"
+                )
+            }
+        }
+    }
+}
+```
+
+## Sheet Navigation
+
+### Modal Sheets
+
+```swift
+struct SheetNavigationView: View {
+    @State private var showSettings = false
+    @State private var showNewItem = false
+    @State private var editingItem: Item?
+
+    var body: some View {
+        NavigationStack {
+            ContentView()
+                .toolbar {
+                    ToolbarItem(placement: .primaryAction) {
+                        Button("Add", systemImage: "plus") {
+                            showNewItem = true
+                        }
+                    }
+                    ToolbarItem(placement: .topBarLeading) {
+                        Button("Settings", systemImage: "gear") {
+                            showSettings = true
+                        }
+                    }
+                }
+        }
+        // Boolean-based sheet
+        .sheet(isPresented: $showSettings) {
+            SettingsSheet()
+        }
+        // Boolean-based fullscreen cover
+        .fullScreenCover(isPresented: $showNewItem) {
+            NewItemView()
+        }
+        // Item-based sheet
+        .sheet(item: $editingItem) { item in
+            EditItemSheet(item: item)
+        }
+    }
+}
+```
+
+### Sheet with Navigation
+
+```swift
+struct NavigableSheet: View {
+    @Environment(\.dismiss) private var dismiss
+
+    var body: some View {
+        NavigationStack {
+            Form {
+                Section("General") {
+                    NavigationLink("Account") {
+                        AccountSettingsView()
+                    }
+                    NavigationLink("Notifications") {
+                        NotificationSettingsView()
+                    }
+                }
+
+                Section("Advanced") {
+                    NavigationLink("Privacy") {
+                        PrivacySettingsView()
+                    }
+                }
+            }
+            .navigationTitle("Settings")
+            .toolbar {
+                ToolbarItem(placement: .confirmationAction) {
+                    Button("Done") {
+                        dismiss()
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+### Sheet Customization
+
+```swift
+struct CustomSheetView: View {
+    @State private var showSheet = false
+
+    var body: some View {
+        Button("Show Sheet") {
+            showSheet = true
+        }
+        .sheet(isPresented: $showSheet) {
+            SheetContent()
+                // Available detents
+                .presentationDetents([
+                    .medium,
+                    .large,
+                    .height(200),
+                    .fraction(0.75)
+                ])
+                // Selected detent binding
+                .presentationDetents([.medium, .large], selection: $selectedDetent)
+                // Drag indicator visibility
+                .presentationDragIndicator(.visible)
+                // Corner radius
+                .presentationCornerRadius(24)
+                // Background interaction
+                .presentationBackgroundInteraction(.enabled(upThrough: .medium))
+                // Prevent interactive dismiss
+                .interactiveDismissDisabled(hasUnsavedChanges)
+        }
+    }
+}
+```
+
+## Tab Navigation
+
+### Basic TabView
+
+```swift
+struct MainTabView: View {
+    @State private var selectedTab = 0
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            HomeView()
+                .tabItem {
+                    Label("Home", systemImage: "house")
+                }
+                .tag(0)
+
+            SearchView()
+                .tabItem {
+                    Label("Search", systemImage: "magnifyingglass")
+                }
+                .tag(1)
+
+            ProfileView()
+                .tabItem {
+                    Label("Profile", systemImage: "person")
+                }
+                .tag(2)
+                .badge(unreadCount)
+        }
+    }
+}
+```
+
+### Tab with Custom Badge
+
+```swift
+struct BadgedTabView: View {
+    @State private var selectedTab: Tab = .home
+    @State private var cartCount = 3
+
+    enum Tab: String, CaseIterable {
+        case home, search, cart, profile
+
+        var icon: String {
+            switch self {
+            case .home: return "house"
+            case .search: return "magnifyingglass"
+            case .cart: return "cart"
+            case .profile: return "person"
+            }
+        }
+    }
+
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            ForEach(Tab.allCases, id: \.self) { tab in
+                NavigationStack {
+                    contentView(for: tab)
+                }
+                .tabItem {
+                    Label(tab.rawValue.capitalized, systemImage: tab.icon)
+                }
+                .tag(tab)
+                .badge(tab == .cart ? cartCount : 0)
+            }
+        }
+    }
+}
+```
+
+## Deep Linking
+
+### URL-Based Navigation
+
+```swift
+struct DeepLinkableApp: App {
+    @StateObject private var router = NavigationRouter()
+
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+                .environmentObject(router)
+                .onOpenURL { url in
+                    router.handle(url: url)
+                }
+        }
+    }
+}
+
+class NavigationRouter: ObservableObject {
+    @Published var path = NavigationPath()
+    @Published var selectedTab: Tab = .home
+
+    func handle(url: URL) {
+        guard url.scheme == "myapp" else { return }
+
+        switch url.host {
+        case "item":
+            if let id = Int(url.lastPathComponent) {
+                selectedTab = .home
+                path = NavigationPath()
+                path.append(Destination.itemDetail(id: id))
+            }
+        case "settings":
+            selectedTab = .profile
+            path = NavigationPath()
+            path.append(Destination.settings)
+        default:
+            break
+        }
+    }
+}
+```
+
+### Universal Links
+
+```swift
+struct UniversalLinkHandler: View {
+    @EnvironmentObject private var router: NavigationRouter
+
+    var body: some View {
+        ContentView()
+            .onContinueUserActivity(NSUserActivityTypeBrowsingWeb) { activity in
+                guard let url = activity.webpageURL else { return }
+                handleUniversalLink(url)
+            }
+    }
+
+    private func handleUniversalLink(_ url: URL) {
+        // Parse URL path and navigate accordingly
+        let pathComponents = url.pathComponents
+
+        if pathComponents.contains("product"),
+           let idString = pathComponents.last,
+           let id = Int(idString) {
+            router.navigate(to: .product(id: id))
+        }
+    }
+}
+```
+
+## Navigation Coordinator Pattern
+
+```swift
+@MainActor
+class NavigationCoordinator: ObservableObject {
+    @Published var path = NavigationPath()
+    @Published var sheet: Sheet?
+    @Published var fullScreenCover: FullScreenCover?
+
+    enum Sheet: Identifiable {
+        case settings
+        case newItem
+        case editItem(Item)
+
+        var id: String {
+            switch self {
+            case .settings: return "settings"
+            case .newItem: return "newItem"
+            case .editItem(let item): return "editItem-\(item.id)"
+            }
+        }
+    }
+
+    enum FullScreenCover: Identifiable {
+        case onboarding
+        case camera
+
+        var id: String {
+            switch self {
+            case .onboarding: return "onboarding"
+            case .camera: return "camera"
+            }
+        }
+    }
+
+    func push(_ destination: Destination) {
+        path.append(destination)
+    }
+
+    func pop() {
+        guard !path.isEmpty else { return }
+        path.removeLast()
+    }
+
+    func popToRoot() {
+        path = NavigationPath()
+    }
+
+    func present(_ sheet: Sheet) {
+        self.sheet = sheet
+    }
+
+    func presentFullScreen(_ cover: FullScreenCover) {
+        self.fullScreenCover = cover
+    }
+
+    func dismiss() {
+        if fullScreenCover != nil {
+            fullScreenCover = nil
+        } else if sheet != nil {
+            sheet = nil
+        }
+    }
+}
+```
+
+## Navigation Transitions (iOS 18+)
+
+### Custom Navigation Transitions
+
+```swift
+struct CustomTransitionView: View {
+    @Namespace private var namespace
+
+    var body: some View {
+        NavigationStack {
+            List(items) { item in
+                NavigationLink(value: item) {
+                    ItemRow(item: item)
+                        .matchedTransitionSource(id: item.id, in: namespace)
+                }
+            }
+            .navigationDestination(for: Item.self) { item in
+                ItemDetailView(item: item)
+                    .navigationTransition(.zoom(sourceID: item.id, in: namespace))
+            }
+        }
+    }
+}
+```
+
+### Hero Transitions
+
+```swift
+struct HeroTransitionView: View {
+    @Namespace private var animation
+    @State private var selectedItem: Item?
+
+    var body: some View {
+        ZStack {
+            ScrollView {
+                LazyVGrid(columns: columns) {
+                    ForEach(items) { item in
+                        if selectedItem?.id != item.id {
+                            ItemCard(item: item)
+                                .matchedGeometryEffect(id: item.id, in: animation)
+                                .onTapGesture {
+                                    withAnimation(.spring(response: 0.3)) {
+                                        selectedItem = item
+                                    }
+                                }
+                        }
+                    }
+                }
+            }
+
+            if let item = selectedItem {
+                ItemDetailView(item: item)
+                    .matchedGeometryEffect(id: item.id, in: animation)
+                    .onTapGesture {
+                        withAnimation(.spring(response: 0.3)) {
+                            selectedItem = nil
+                        }
+                    }
+            }
+        }
+    }
+}
+```
diff --git a/.claude/skills/mobile-ios-design/references/swiftui-components.md b/.claude/skills/mobile-ios-design/references/swiftui-components.md
new file mode 100644
index 0000000..43553a3
--- /dev/null
+++ b/.claude/skills/mobile-ios-design/references/swiftui-components.md
@@ -0,0 +1,575 @@
+# SwiftUI Component Library
+
+## Lists and Collections
+
+### Basic List
+
+```swift
+struct ItemListView: View {
+    @State private var items: [Item] = []
+
+    var body: some View {
+        List {
+            ForEach(items) { item in
+                ItemRow(item: item)
+            }
+            .onDelete(perform: deleteItems)
+            .onMove(perform: moveItems)
+        }
+        .listStyle(.insetGrouped)
+        .refreshable {
+            await loadItems()
+        }
+    }
+
+    private func deleteItems(at offsets: IndexSet) {
+        items.remove(atOffsets: offsets)
+    }
+
+    private func moveItems(from source: IndexSet, to destination: Int) {
+        items.move(fromOffsets: source, toOffset: destination)
+    }
+}
+```
+
+### Sectioned List
+
+```swift
+struct SectionedListView: View {
+    let groupedItems: [String: [Item]]
+
+    var body: some View {
+        List {
+            ForEach(groupedItems.keys.sorted(), id: \.self) { key in
+                Section(header: Text(key)) {
+                    ForEach(groupedItems[key] ?? []) { item in
+                        ItemRow(item: item)
+                    }
+                }
+            }
+        }
+        .listStyle(.sidebar)
+    }
+}
+```
+
+### Search Integration
+
+```swift
+struct SearchableListView: View {
+    @State private var searchText = ""
+    @State private var items: [Item] = []
+
+    var filteredItems: [Item] {
+        if searchText.isEmpty {
+            return items
+        }
+        return items.filter { $0.name.localizedCaseInsensitiveContains(searchText) }
+    }
+
+    var body: some View {
+        NavigationStack {
+            List(filteredItems) { item in
+                ItemRow(item: item)
+            }
+            .searchable(text: $searchText, prompt: "Search items")
+            .searchSuggestions {
+                ForEach(searchSuggestions, id: \.self) { suggestion in
+                    Text(suggestion)
+                        .searchCompletion(suggestion)
+                }
+            }
+            .navigationTitle("Items")
+        }
+    }
+}
+```
+
+## Forms and Input
+
+### Settings Form
+
+```swift
+struct SettingsView: View {
+    @AppStorage("notifications") private var notificationsEnabled = true
+    @AppStorage("soundEnabled") private var soundEnabled = true
+    @State private var selectedTheme = Theme.system
+    @State private var username = ""
+
+    var body: some View {
+        Form {
+            Section("Account") {
+                TextField("Username", text: $username)
+                    .textContentType(.username)
+                    .autocorrectionDisabled()
+            }
+
+            Section("Preferences") {
+                Toggle("Enable Notifications", isOn: $notificationsEnabled)
+                Toggle("Sound Effects", isOn: $soundEnabled)
+
+                Picker("Theme", selection: $selectedTheme) {
+                    ForEach(Theme.allCases) { theme in
+                        Text(theme.rawValue).tag(theme)
+                    }
+                }
+            }
+
+            Section("About") {
+                LabeledContent("Version", value: "1.0.0")
+
+                Link(destination: URL(string: "https://example.com/privacy")!) {
+                    Text("Privacy Policy")
+                }
+            }
+        }
+        .navigationTitle("Settings")
+    }
+}
+```
+
+### Custom Input Fields
+
+```swift
+struct ValidatedTextField: View {
+    let title: String
+    @Binding var text: String
+    let validation: (String) -> Bool
+
+    @State private var isValid = true
+    @FocusState private var isFocused: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 4) {
+            Text(title)
+                .font(.caption)
+                .foregroundStyle(.secondary)
+
+            TextField(title, text: $text)
+                .textFieldStyle(.roundedBorder)
+                .focused($isFocused)
+                .overlay(
+                    RoundedRectangle(cornerRadius: 8)
+                        .stroke(borderColor, lineWidth: 1)
+                )
+                .onChange(of: text) { _, newValue in
+                    isValid = validation(newValue)
+                }
+
+            if !isValid && !text.isEmpty {
+                Text("Invalid input")
+                    .font(.caption)
+                    .foregroundStyle(.red)
+            }
+        }
+    }
+
+    private var borderColor: Color {
+        if isFocused {
+            return isValid ? .blue : .red
+        }
+        return .clear
+    }
+}
+```
+
+## Buttons and Actions
+
+### Button Styles
+
+```swift
+// Primary filled button
+Button("Continue") {
+    // action
+}
+.buttonStyle(.borderedProminent)
+.controlSize(.large)
+
+// Secondary button
+Button("Cancel") {
+    // action
+}
+.buttonStyle(.bordered)
+
+// Destructive button
+Button("Delete", role: .destructive) {
+    // action
+}
+.buttonStyle(.bordered)
+
+// Custom button style
+struct ScaleButtonStyle: ButtonStyle {
+    func makeBody(configuration: Configuration) -> some View {
+        configuration.label
+            .scaleEffect(configuration.isPressed ? 0.95 : 1.0)
+            .animation(.easeInOut(duration: 0.1), value: configuration.isPressed)
+    }
+}
+```
+
+### Menu and Context Menu
+
+```swift
+// Menu button
+Menu {
+    Button("Edit", systemImage: "pencil") { }
+    Button("Duplicate", systemImage: "doc.on.doc") { }
+    Divider()
+    Button("Delete", systemImage: "trash", role: .destructive) { }
+} label: {
+    Image(systemName: "ellipsis.circle")
+}
+
+// Context menu on any view
+Text("Long press me")
+    .contextMenu {
+        Button("Copy", systemImage: "doc.on.doc") { }
+        Button("Share", systemImage: "square.and.arrow.up") { }
+    } preview: {
+        ItemPreviewView()
+    }
+```
+
+## Sheets and Modals
+
+### Sheet Presentation
+
+```swift
+struct ParentView: View {
+    @State private var showSettings = false
+    @State private var selectedItem: Item?
+
+    var body: some View {
+        VStack {
+            Button("Settings") {
+                showSettings = true
+            }
+        }
+        .sheet(isPresented: $showSettings) {
+            SettingsSheet()
+                .presentationDetents([.medium, .large])
+                .presentationDragIndicator(.visible)
+        }
+        .sheet(item: $selectedItem) { item in
+            ItemDetailSheet(item: item)
+                .presentationDetents([.height(300), .large])
+                .presentationCornerRadius(24)
+        }
+    }
+}
+
+struct SettingsSheet: View {
+    @Environment(\.dismiss) private var dismiss
+
+    var body: some View {
+        NavigationStack {
+            SettingsContent()
+                .toolbar {
+                    ToolbarItem(placement: .confirmationAction) {
+                        Button("Done") {
+                            dismiss()
+                        }
+                    }
+                }
+        }
+    }
+}
+```
+
+### Confirmation Dialog
+
+```swift
+struct DeleteConfirmationView: View {
+    @State private var showConfirmation = false
+
+    var body: some View {
+        Button("Delete Account", role: .destructive) {
+            showConfirmation = true
+        }
+        .confirmationDialog(
+            "Delete Account",
+            isPresented: $showConfirmation,
+            titleVisibility: .visible
+        ) {
+            Button("Delete", role: .destructive) {
+                deleteAccount()
+            }
+            Button("Cancel", role: .cancel) { }
+        } message: {
+            Text("This action cannot be undone.")
+        }
+    }
+}
+```
+
+## Loading and Progress
+
+### Progress Indicators
+
+```swift
+// Indeterminate spinner
+ProgressView()
+    .progressViewStyle(.circular)
+
+// Determinate progress
+ProgressView(value: downloadProgress, total: 1.0) {
+    Text("Downloading...")
+} currentValueLabel: {
+    Text("\(Int(downloadProgress * 100))%")
+}
+
+// Custom loading view
+struct LoadingOverlay: View {
+    let message: String
+
+    var body: some View {
+        ZStack {
+            Color.black.opacity(0.4)
+                .ignoresSafeArea()
+
+            VStack(spacing: 16) {
+                ProgressView()
+                    .scaleEffect(1.5)
+                    .tint(.white)
+
+                Text(message)
+                    .font(.subheadline)
+                    .foregroundStyle(.white)
+            }
+            .padding(24)
+            .background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
+        }
+    }
+}
+```
+
+### Skeleton Loading
+
+```swift
+struct SkeletonRow: View {
+    @State private var isAnimating = false
+
+    var body: some View {
+        HStack(spacing: 12) {
+            Circle()
+                .fill(.gray.opacity(0.3))
+                .frame(width: 44, height: 44)
+
+            VStack(alignment: .leading, spacing: 8) {
+                RoundedRectangle(cornerRadius: 4)
+                    .fill(.gray.opacity(0.3))
+                    .frame(height: 14)
+                    .frame(maxWidth: 200)
+
+                RoundedRectangle(cornerRadius: 4)
+                    .fill(.gray.opacity(0.2))
+                    .frame(height: 12)
+                    .frame(maxWidth: 150)
+            }
+        }
+        .opacity(isAnimating ? 0.5 : 1.0)
+        .animation(.easeInOut(duration: 0.8).repeatForever(), value: isAnimating)
+        .onAppear { isAnimating = true }
+    }
+}
+```
+
+## Async Content Loading
+
+### AsyncImage
+
+```swift
+AsyncImage(url: imageURL) { phase in
+    switch phase {
+    case .empty:
+        ProgressView()
+    case .success(let image):
+        image
+            .resizable()
+            .aspectRatio(contentMode: .fill)
+    case .failure:
+        Image(systemName: "photo")
+            .foregroundStyle(.secondary)
+    @unknown default:
+        EmptyView()
+    }
+}
+.frame(width: 100, height: 100)
+.clipShape(RoundedRectangle(cornerRadius: 8))
+```
+
+### Task-Based Loading
+
+```swift
+struct AsyncContentView: View {
+    @State private var items: [Item] = []
+    @State private var isLoading = true
+    @State private var error: Error?
+
+    var body: some View {
+        Group {
+            if isLoading {
+                ProgressView("Loading...")
+            } else if let error {
+                ContentUnavailableView(
+                    "Failed to Load",
+                    systemImage: "exclamationmark.triangle",
+                    description: Text(error.localizedDescription)
+                )
+            } else if items.isEmpty {
+                ContentUnavailableView(
+                    "No Items",
+                    systemImage: "tray",
+                    description: Text("Add your first item to get started.")
+                )
+            } else {
+                List(items) { item in
+                    ItemRow(item: item)
+                }
+            }
+        }
+        .task {
+            await loadItems()
+        }
+    }
+
+    private func loadItems() async {
+        do {
+            items = try await api.fetchItems()
+            isLoading = false
+        } catch {
+            self.error = error
+            isLoading = false
+        }
+    }
+}
+```
+
+## Animations
+
+### Implicit Animations
+
+```swift
+struct AnimatedCard: View {
+    @State private var isExpanded = false
+
+    var body: some View {
+        VStack {
+            Text("Tap to expand")
+
+            if isExpanded {
+                Text("Additional content here")
+                    .transition(.move(edge: .top).combined(with: .opacity))
+            }
+        }
+        .padding()
+        .frame(maxWidth: .infinity)
+        .background(.blue.opacity(0.1), in: RoundedRectangle(cornerRadius: 12))
+        .onTapGesture {
+            withAnimation(.spring(response: 0.3, dampingFraction: 0.7)) {
+                isExpanded.toggle()
+            }
+        }
+    }
+}
+```
+
+### Custom Transitions
+
+```swift
+extension AnyTransition {
+    static var slideAndFade: AnyTransition {
+        .asymmetric(
+            insertion: .move(edge: .trailing).combined(with: .opacity),
+            removal: .move(edge: .leading).combined(with: .opacity)
+        )
+    }
+
+    static var scaleAndFade: AnyTransition {
+        .scale(scale: 0.8).combined(with: .opacity)
+    }
+}
+```
+
+### Phase Animator (iOS 17+)
+
+```swift
+struct PulsingButton: View {
+    var body: some View {
+        Button("Tap Me") { }
+            .buttonStyle(.borderedProminent)
+            .phaseAnimator([false, true]) { content, phase in
+                content
+                    .scaleEffect(phase ? 1.05 : 1.0)
+            } animation: { _ in
+                .easeInOut(duration: 0.5)
+            }
+    }
+}
+```
+
+## Gestures
+
+### Drag Gesture
+
+```swift
+struct DraggableCard: View {
+    @State private var offset = CGSize.zero
+    @State private var isDragging = false
+
+    var body: some View {
+        RoundedRectangle(cornerRadius: 16)
+            .fill(.blue)
+            .frame(width: 200, height: 150)
+            .offset(offset)
+            .scaleEffect(isDragging ? 1.05 : 1.0)
+            .gesture(
+                DragGesture()
+                    .onChanged { value in
+                        offset = value.translation
+                        isDragging = true
+                    }
+                    .onEnded { _ in
+                        withAnimation(.spring()) {
+                            offset = .zero
+                            isDragging = false
+                        }
+                    }
+            )
+    }
+}
+```
+
+### Simultaneous Gestures
+
+```swift
+struct ZoomableImage: View {
+    @State private var scale: CGFloat = 1.0
+    @State private var lastScale: CGFloat = 1.0
+
+    var body: some View {
+        Image("photo")
+            .resizable()
+            .aspectRatio(contentMode: .fit)
+            .scaleEffect(scale)
+            .gesture(
+                MagnificationGesture()
+                    .onChanged { value in
+                        scale = lastScale * value
+                    }
+                    .onEnded { _ in
+                        lastScale = scale
+                    }
+            )
+            .gesture(
+                TapGesture(count: 2)
+                    .onEnded {
+                        withAnimation {
+                            scale = 1.0
+                            lastScale = 1.0
+                        }
+                    }
+            )
+    }
+}
+```
diff --git a/.claude/skills/mobile-offline-support/SKILL.md b/.claude/skills/mobile-offline-support/SKILL.md
new file mode 100644
index 0000000..0074c06
--- /dev/null
+++ b/.claude/skills/mobile-offline-support/SKILL.md
@@ -0,0 +1,466 @@
+---
+name: mobile-offline-support
+description: Implement offline-first mobile apps with local storage, sync strategies, and conflict resolution. Covers AsyncStorage, Realm, SQLite, and background sync patterns.
+---
+
+# Mobile Offline Support
+
+## Overview
+
+Design offline-first mobile applications that provide seamless user experience regardless of connectivity.
+
+## When to Use
+
+- Building apps that work without internet connection
+- Implementing seamless sync when connectivity returns
+- Handling data conflicts between device and server
+- Reducing server load with intelligent caching
+- Improving app responsiveness with local storage
+
+## Instructions
+
+### 1. **React Native Offline Storage**
+
+```javascript
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import NetInfo from '@react-native-community/netinfo';
+
+class StorageManager {
+  static async saveItems(items) {
+    try {
+      await AsyncStorage.setItem(
+        'items_cache',
+        JSON.stringify({ data: items, timestamp: Date.now() })
+      );
+    } catch (error) {
+      console.error('Failed to save items:', error);
+    }
+  }
+
+  static async getItems() {
+    try {
+      const data = await AsyncStorage.getItem('items_cache');
+      return data ? JSON.parse(data) : null;
+    } catch (error) {
+      console.error('Failed to retrieve items:', error);
+      return null;
+    }
+  }
+
+  static async queueAction(action) {
+    try {
+      const queue = await AsyncStorage.getItem('action_queue');
+      const actions = queue ? JSON.parse(queue) : [];
+      actions.push({ ...action, id: Date.now(), attempts: 0 });
+      await AsyncStorage.setItem('action_queue', JSON.stringify(actions));
+    } catch (error) {
+      console.error('Failed to queue action:', error);
+    }
+  }
+
+  static async getActionQueue() {
+    try {
+      const queue = await AsyncStorage.getItem('action_queue');
+      return queue ? JSON.parse(queue) : [];
+    } catch (error) {
+      return [];
+    }
+  }
+
+  static async removeFromQueue(actionId) {
+    try {
+      const queue = await AsyncStorage.getItem('action_queue');
+      const actions = queue ? JSON.parse(queue) : [];
+      const filtered = actions.filter(a => a.id !== actionId);
+      await AsyncStorage.setItem('action_queue', JSON.stringify(filtered));
+    } catch (error) {
+      console.error('Failed to remove from queue:', error);
+    }
+  }
+}
+
+class OfflineAPIService {
+  async fetchItems() {
+    const isOnline = await this.checkConnectivity();
+
+    if (isOnline) {
+      try {
+        const response = await fetch('https://api.example.com/items');
+        const items = await response.json();
+        await StorageManager.saveItems(items);
+        return items;
+      } catch (error) {
+        const cached = await StorageManager.getItems();
+        return cached?.data || [];
+      }
+    } else {
+      const cached = await StorageManager.getItems();
+      return cached?.data || [];
+    }
+  }
+
+  async createItem(item) {
+    const isOnline = await this.checkConnectivity();
+
+    if (isOnline) {
+      try {
+        const response = await fetch('https://api.example.com/items', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(item)
+        });
+        const created = await response.json();
+        return { success: true, data: created };
+      } catch (error) {
+        await StorageManager.queueAction({
+          type: 'CREATE_ITEM',
+          payload: item
+        });
+        return { success: false, queued: true };
+      }
+    } else {
+      await StorageManager.queueAction({
+        type: 'CREATE_ITEM',
+        payload: item
+      });
+      return { success: false, queued: true };
+    }
+  }
+
+  async syncQueue() {
+    const queue = await StorageManager.getActionQueue();
+
+    for (const action of queue) {
+      try {
+        await this.executeAction(action);
+        await StorageManager.removeFromQueue(action.id);
+      } catch (error) {
+        action.attempts = (action.attempts || 0) + 1;
+        if (action.attempts > 3) {
+          await StorageManager.removeFromQueue(action.id);
+        }
+      }
+    }
+  }
+
+  private async executeAction(action) {
+    switch (action.type) {
+      case 'CREATE_ITEM':
+        return fetch('https://api.example.com/items', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(action.payload)
+        });
+      default:
+        return Promise.reject(new Error('Unknown action type'));
+    }
+  }
+
+  async checkConnectivity() {
+    const state = await NetInfo.fetch();
+    return state.isConnected ?? false;
+  }
+}
+
+export function OfflineListScreen() {
+  const [items, setItems] = useState([]);
+  const [isOnline, setIsOnline] = useState(true);
+  const [syncing, setSyncing] = useState(false);
+  const apiService = new OfflineAPIService();
+
+  useFocusEffect(
+    useCallback(() => {
+      loadItems();
+      const unsubscribe = NetInfo.addEventListener(state => {
+        setIsOnline(state.isConnected ?? false);
+        if (state.isConnected) {
+          syncQueue();
+        }
+      });
+
+      return unsubscribe;
+    }, [])
+  );
+
+  const loadItems = async () => {
+    const items = await apiService.fetchItems();
+    setItems(items);
+  };
+
+  const syncQueue = async () => {
+    setSyncing(true);
+    await apiService.syncQueue();
+    await loadItems();
+    setSyncing(false);
+  };
+
+  return (
+    <View style={styles.container}>
+      {!isOnline && <Text style={styles.offline}>Offline Mode</Text>}
+      {syncing && <ActivityIndicator size="large" />}
+      <FlatList
+        data={items}
+        renderItem={({ item }) => <ItemCard item={item} />}
+        keyExtractor={item => item.id}
+      />
+    </View>
+  );
+}
+```
+
+### 2. **iOS Core Data Implementation**
+
+```swift
+import CoreData
+
+class PersistenceController {
+  static let shared = PersistenceController()
+
+  let container: NSPersistentContainer
+
+  init(inMemory: Bool = false) {
+    container = NSPersistentContainer(name: "MyApp")
+
+    if inMemory {
+      container.persistentStoreDescriptions.first?.url = URL(fileURLWithPath: "/dev/null")
+    }
+
+    container.loadPersistentStores { _, error in
+      if let error = error as NSError? {
+        print("Core Data load error: \(error)")
+      }
+    }
+
+    container.viewContext.automaticallyMergesChangesFromParent = true
+  }
+
+  func save(_ context: NSManagedObjectContext = PersistenceController.shared.container.viewContext) {
+    if context.hasChanges {
+      do {
+        try context.save()
+      } catch {
+        print("Save error: \(error)")
+      }
+    }
+  }
+}
+
+// Core Data Models
+@NSManaged class ItemEntity: NSManagedObject {
+  @NSManaged var id: String
+  @NSManaged var title: String
+  @NSManaged var description: String?
+  @NSManaged var isSynced: Bool
+}
+
+@NSManaged class ActionQueueEntity: NSManagedObject {
+  @NSManaged var id: UUID
+  @NSManaged var type: String
+  @NSManaged var payload: Data?
+  @NSManaged var createdAt: Date
+}
+
+class OfflineSyncManager: NSObject, ObservableObject {
+  @Published var isOnline = true
+  @Published var isSyncing = false
+
+  private let networkMonitor = NWPathMonitor()
+  private let persistenceController = PersistenceController.shared
+
+  override init() {
+    super.init()
+    setupNetworkMonitoring()
+  }
+
+  private func setupNetworkMonitoring() {
+    networkMonitor.pathUpdateHandler = { [weak self] path in
+      DispatchQueue.main.async {
+        self?.isOnline = path.status == .satisfied
+        if path.status == .satisfied {
+          self?.syncWithServer()
+        }
+      }
+    }
+
+    let queue = DispatchQueue(label: "NetworkMonitor")
+    networkMonitor.start(queue: queue)
+  }
+
+  func saveItem(_ item: Item) {
+    let context = persistenceController.container.viewContext
+    let entity = ItemEntity(context: context)
+    entity.id = item.id
+    entity.title = item.title
+    entity.isSynced = false
+
+    persistenceController.save(context)
+
+    if isOnline {
+      syncItem(item)
+    }
+  }
+
+  func syncWithServer() {
+    isSyncing = true
+    let context = persistenceController.container.viewContext
+    let request: NSFetchRequest<ActionQueueEntity> = ActionQueueEntity.fetchRequest()
+
+    do {
+      let pendingActions = try context.fetch(request)
+      for action in pendingActions {
+        context.delete(action)
+      }
+      persistenceController.save(context)
+    } catch {
+      print("Sync error: \(error)")
+    }
+
+    isSyncing = false
+  }
+}
+```
+
+### 3. **Android Room Database**
+
+```kotlin
+@Entity(tableName = "items")
+data class ItemEntity(
+  @PrimaryKey val id: String,
+  val title: String,
+  val description: String?,
+  val isSynced: Boolean = false
+)
+
+@Entity(tableName = "action_queue")
+data class ActionQueueEntity(
+  @PrimaryKey val id: Long = System.currentTimeMillis(),
+  val type: String,
+  val payload: String,
+  val createdAt: Long = System.currentTimeMillis()
+)
+
+@Dao
+interface ItemDao {
+  @Insert(onConflict = OnConflictStrategy.REPLACE)
+  suspend fun insertItem(item: ItemEntity)
+
+  @Query("SELECT * FROM items")
+  fun getAllItems(): Flow<List<ItemEntity>>
+
+  @Update
+  suspend fun updateItem(item: ItemEntity)
+}
+
+@Dao
+interface ActionQueueDao {
+  @Insert
+  suspend fun insertAction(action: ActionQueueEntity)
+
+  @Query("SELECT * FROM action_queue ORDER BY createdAt ASC")
+  suspend fun getAllActions(): List<ActionQueueEntity>
+
+  @Delete
+  suspend fun deleteAction(action: ActionQueueEntity)
+}
+
+@Database(entities = [ItemEntity::class, ActionQueueEntity::class], version = 1)
+abstract class AppDatabase : RoomDatabase() {
+  abstract fun itemDao(): ItemDao
+  abstract fun actionQueueDao(): ActionQueueDao
+}
+
+@HiltViewModel
+class OfflineItemsViewModel @Inject constructor(
+  private val itemDao: ItemDao,
+  private val actionQueueDao: ActionQueueDao,
+  private val connectivityManager: ConnectivityManager
+) : ViewModel() {
+  private val _items = MutableStateFlow<List<Item>>(emptyList())
+  val items: StateFlow<List<Item>> = _items.asStateFlow()
+
+  init {
+    viewModelScope.launch {
+      itemDao.getAllItems().collect { entities ->
+        _items.value = entities.map { it.toItem() }
+      }
+    }
+    observeNetworkConnectivity()
+  }
+
+  fun saveItem(item: Item) {
+    viewModelScope.launch {
+      val entity = item.toEntity()
+      itemDao.insertItem(entity)
+
+      if (isNetworkAvailable()) {
+        syncItem(item)
+      } else {
+        actionQueueDao.insertAction(
+          ActionQueueEntity(
+            type = "CREATE_ITEM",
+            payload = Json.encodeToString(item)
+          )
+        )
+      }
+    }
+  }
+
+  private fun observeNetworkConnectivity() {
+    val networkRequest = NetworkRequest.Builder()
+      .addCapability(NET_CAPABILITY_INTERNET)
+      .build()
+
+    connectivityManager.registerNetworkCallback(
+      networkRequest,
+      object : ConnectivityManager.NetworkCallback() {
+        override fun onAvailable(network: Network) {
+          viewModelScope.launch { syncQueue() }
+        }
+      }
+    )
+  }
+
+  private suspend fun syncQueue() {
+    val queue = actionQueueDao.getAllActions()
+    for (action in queue) {
+      try {
+        actionQueueDao.deleteAction(action)
+      } catch (e: Exception) {
+        println("Sync error: ${e.message}")
+      }
+    }
+  }
+
+  private fun isNetworkAvailable(): Boolean {
+    val activeNetwork = connectivityManager.activeNetwork ?: return false
+    val capabilities = connectivityManager.getNetworkCapabilities(activeNetwork) ?: return false
+    return capabilities.hasCapability(NET_CAPABILITY_INTERNET)
+  }
+}
+```
+
+## Best Practices
+
+### ✅ DO
+- Implement robust local storage
+- Use automatic sync when online
+- Provide visual feedback for offline status
+- Queue actions for later sync
+- Handle conflicts gracefully
+- Cache frequently accessed data
+- Implement proper error recovery
+- Test offline scenarios thoroughly
+- Use compression for large data
+- Monitor storage usage
+
+### ❌ DON'T
+- Assume constant connectivity
+- Sync large files frequently
+- Ignore storage limitations
+- Force unnecessary syncing
+- Lose data on offline mode
+- Store sensitive data unencrypted
+- Accumulate infinite queue items
+- Ignore sync failures silently
+- Sync in tight loops
+- Deploy without offline testing
diff --git a/.claude/skills/mobile-security-coder/SKILL.md b/.claude/skills/mobile-security-coder/SKILL.md
new file mode 100644
index 0000000..c7bda47
--- /dev/null
+++ b/.claude/skills/mobile-security-coder/SKILL.md
@@ -0,0 +1,184 @@
+---
+name: mobile-security-coder
+description: Expert in secure mobile coding practices specializing in input
+  validation, WebView security, and mobile-specific security patterns. Use
+  PROACTIVELY for mobile security implementations or mobile security code
+  reviews.
+metadata:
+  model: sonnet
+---
+
+## Use this skill when
+
+- Working on mobile security coder tasks or workflows
+- Needing guidance, best practices, or checklists for mobile security coder
+
+## Do not use this skill when
+
+- The task is unrelated to mobile security coder
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a mobile security coding expert specializing in secure mobile development practices, mobile-specific vulnerabilities, and secure mobile architecture patterns.
+
+## Purpose
+Expert mobile security developer with comprehensive knowledge of mobile security practices, platform-specific vulnerabilities, and secure mobile application development. Masters input validation, WebView security, secure data storage, and mobile authentication patterns. Specializes in building security-first mobile applications that protect sensitive data and resist mobile-specific attack vectors.
+
+## When to Use vs Security Auditor
+- **Use this agent for**: Hands-on mobile security coding, implementation of secure mobile patterns, mobile-specific vulnerability fixes, WebView security configuration, mobile authentication implementation
+- **Use security-auditor for**: High-level security audits, compliance assessments, DevSecOps pipeline design, threat modeling, security architecture reviews, penetration testing planning
+- **Key difference**: This agent focuses on writing secure mobile code, while security-auditor focuses on auditing and assessing security posture
+
+## Capabilities
+
+### General Secure Coding Practices
+- **Input validation and sanitization**: Mobile-specific input validation, touch input security, gesture validation
+- **Injection attack prevention**: SQL injection in mobile databases, NoSQL injection, command injection in mobile contexts
+- **Error handling security**: Secure error messages on mobile, crash reporting security, debug information protection
+- **Sensitive data protection**: Mobile data classification, secure storage patterns, memory protection
+- **Secret management**: Mobile credential storage, keychain/keystore integration, biometric-protected secrets
+- **Output encoding**: Context-aware encoding for mobile UI, WebView content encoding, push notification security
+
+### Mobile Data Storage Security
+- **Secure local storage**: SQLite encryption, Core Data protection, Realm security configuration
+- **Keychain and Keystore**: Secure credential storage, biometric authentication integration, key derivation
+- **File system security**: Secure file operations, directory permissions, temporary file cleanup
+- **Cache security**: Secure caching strategies, cache encryption, sensitive data exclusion
+- **Backup security**: Backup exclusion for sensitive files, encrypted backup handling, cloud backup protection
+- **Memory protection**: Memory dump prevention, secure memory allocation, buffer overflow protection
+
+### WebView Security Implementation
+- **URL allowlisting**: Trusted domain restrictions, URL validation, protocol enforcement (HTTPS)
+- **JavaScript controls**: JavaScript disabling by default, selective JavaScript enabling, script injection prevention
+- **Content Security Policy**: CSP implementation in WebViews, script-src restrictions, unsafe-inline prevention
+- **Cookie and session management**: Secure cookie handling, session isolation, cross-WebView security
+- **File access restrictions**: Local file access prevention, asset loading security, sandboxing
+- **User agent security**: Custom user agent strings, fingerprinting prevention, privacy protection
+- **Data cleanup**: Regular WebView cache and cookie clearing, session data cleanup, temporary file removal
+
+### HTTPS and Network Security
+- **TLS enforcement**: HTTPS-only communication, certificate pinning, SSL/TLS configuration
+- **Certificate validation**: Certificate chain validation, self-signed certificate rejection, CA trust management
+- **Man-in-the-middle protection**: Certificate pinning implementation, network security monitoring
+- **Protocol security**: HTTP Strict Transport Security, secure protocol selection, downgrade protection
+- **Network error handling**: Secure network error messages, connection failure handling, retry security
+- **Proxy and VPN detection**: Network environment validation, security policy enforcement
+
+### Mobile Authentication and Authorization
+- **Biometric authentication**: Touch ID, Face ID, fingerprint authentication, fallback mechanisms
+- **Multi-factor authentication**: TOTP integration, hardware token support, SMS-based 2FA security
+- **OAuth implementation**: Mobile OAuth flows, PKCE implementation, deep link security
+- **JWT handling**: Secure token storage, token refresh mechanisms, token validation
+- **Session management**: Mobile session lifecycle, background/foreground transitions, session timeout
+- **Device binding**: Device fingerprinting, hardware-based authentication, root/jailbreak detection
+
+### Platform-Specific Security
+- **iOS security**: Keychain Services, App Transport Security, iOS permission model, sandboxing
+- **Android security**: Android Keystore, Network Security Config, permission handling, ProGuard/R8 obfuscation
+- **Cross-platform considerations**: React Native security, Flutter security, Xamarin security patterns
+- **Native module security**: Bridge security, native code validation, memory safety
+- **Permission management**: Runtime permissions, privacy permissions, location/camera access security
+- **App lifecycle security**: Background/foreground transitions, app state protection, memory clearing
+
+### API and Backend Communication
+- **API security**: Mobile API authentication, rate limiting, request validation
+- **Request/response validation**: Schema validation, data type enforcement, size limits
+- **Secure headers**: Mobile-specific security headers, CORS handling, content type validation
+- **Error response handling**: Secure error messages, information leakage prevention, debug mode protection
+- **Offline synchronization**: Secure data sync, conflict resolution security, cached data protection
+- **Push notification security**: Secure notification handling, payload encryption, token management
+
+### Code Protection and Obfuscation
+- **Code obfuscation**: ProGuard, R8, iOS obfuscation, symbol stripping
+- **Anti-tampering**: Runtime application self-protection (RASP), integrity checks, debugger detection
+- **Root/jailbreak detection**: Device security validation, security policy enforcement, graceful degradation
+- **Binary protection**: Anti-reverse engineering, packing, dynamic analysis prevention
+- **Asset protection**: Resource encryption, embedded asset security, intellectual property protection
+- **Debug protection**: Debug mode detection, development feature disabling, production hardening
+
+### Mobile-Specific Vulnerabilities
+- **Deep link security**: URL scheme validation, intent filter security, parameter sanitization
+- **WebView vulnerabilities**: JavaScript bridge security, file scheme access, universal XSS prevention
+- **Data leakage**: Log sanitization, screenshot protection, memory dump prevention
+- **Side-channel attacks**: Timing attack prevention, cache-based attacks, acoustic/electromagnetic leakage
+- **Physical device security**: Screen recording prevention, screenshot blocking, shoulder surfing protection
+- **Backup and recovery**: Secure backup handling, recovery key management, data restoration security
+
+### Cross-Platform Security
+- **React Native security**: Bridge security, native module validation, JavaScript thread protection
+- **Flutter security**: Platform channel security, native plugin validation, Dart VM protection
+- **Xamarin security**: Managed/native interop security, assembly protection, runtime security
+- **Cordova/PhoneGap**: Plugin security, WebView configuration, native bridge protection
+- **Unity mobile**: Asset bundle security, script compilation security, native plugin integration
+- **Progressive Web Apps**: PWA security on mobile, service worker security, web manifest validation
+
+### Privacy and Compliance
+- **Data privacy**: GDPR compliance, CCPA compliance, data minimization, consent management
+- **Location privacy**: Location data protection, precise location limiting, background location security
+- **Biometric data**: Biometric template protection, privacy-preserving authentication, data retention
+- **Personal data handling**: PII protection, data encryption, access logging, data deletion
+- **Third-party SDKs**: SDK privacy assessment, data sharing controls, vendor security validation
+- **Analytics privacy**: Privacy-preserving analytics, data anonymization, opt-out mechanisms
+
+### Testing and Validation
+- **Security testing**: Mobile penetration testing, SAST/DAST for mobile, dynamic analysis
+- **Runtime protection**: Runtime application self-protection, behavior monitoring, anomaly detection
+- **Vulnerability scanning**: Dependency scanning, known vulnerability detection, patch management
+- **Code review**: Security-focused code review, static analysis integration, peer review processes
+- **Compliance testing**: Security standard compliance, regulatory requirement validation, audit preparation
+- **User acceptance testing**: Security scenario testing, social engineering resistance, user education
+
+## Behavioral Traits
+- Validates and sanitizes all inputs including touch gestures and sensor data
+- Enforces HTTPS-only communication with certificate pinning
+- Implements comprehensive WebView security with JavaScript disabled by default
+- Uses secure storage mechanisms with encryption and biometric protection
+- Applies platform-specific security features and follows security guidelines
+- Implements defense-in-depth with multiple security layers
+- Protects against mobile-specific threats like root/jailbreak detection
+- Considers privacy implications in all data handling operations
+- Uses secure coding practices for cross-platform development
+- Maintains security throughout the mobile app lifecycle
+
+## Knowledge Base
+- Mobile security frameworks and best practices (OWASP MASVS)
+- Platform-specific security features (iOS/Android security models)
+- WebView security configuration and CSP implementation
+- Mobile authentication and biometric integration patterns
+- Secure data storage and encryption techniques
+- Network security and certificate pinning implementation
+- Mobile-specific vulnerability patterns and prevention
+- Cross-platform security considerations
+- Privacy regulations and compliance requirements
+- Mobile threat landscape and attack vectors
+
+## Response Approach
+1. **Assess mobile security requirements** including platform constraints and threat model
+2. **Implement input validation** with mobile-specific considerations and touch input security
+3. **Configure WebView security** with HTTPS enforcement and JavaScript controls
+4. **Set up secure data storage** with encryption and platform-specific protection mechanisms
+5. **Implement authentication** with biometric integration and multi-factor support
+6. **Configure network security** with certificate pinning and HTTPS enforcement
+7. **Apply code protection** with obfuscation and anti-tampering measures
+8. **Handle privacy compliance** with data protection and consent management
+9. **Test security controls** with mobile-specific testing tools and techniques
+
+## Example Interactions
+- "Implement secure WebView configuration with HTTPS enforcement and CSP"
+- "Set up biometric authentication with secure fallback mechanisms"
+- "Create secure local storage with encryption for sensitive user data"
+- "Implement certificate pinning for API communication security"
+- "Configure deep link security with URL validation and parameter sanitization"
+- "Set up root/jailbreak detection with graceful security degradation"
+- "Implement secure cross-platform data sharing between native and WebView"
+- "Create privacy-compliant analytics with data minimization and consent"
+- "Implement secure React Native bridge communication with input validation"
+- "Configure Flutter platform channel security with message validation"
+- "Set up secure Xamarin native interop with assembly protection"
+- "Implement secure Cordova plugin communication with sandboxing"
diff --git a/.claude/skills/pressure-testing/SKILL.md b/.claude/skills/pressure-testing/SKILL.md
new file mode 100644
index 0000000..c7b7313
--- /dev/null
+++ b/.claude/skills/pressure-testing/SKILL.md
@@ -0,0 +1,60 @@
+---
+name: pressure-testing
+description: Standardize VisionFlow load, pressure, capacity, and soak testing across Docker, PgBouncer, BullMQ, Redis, workflow execution, and tietiezhi batch generation. Use when an agent needs to run or document high-concurrency validation, 2C4G simulations, multi-user submit tests, workflow stress tests, throughput investigations, OSS cleanup for test runs, or performance reporting and tuning guidance.
+---
+
+# Pressure Testing
+
+Use this skill to run VisionFlow pressure tests in the repo's supported way instead of inventing an ad hoc flow.
+
+## Pick the right harness
+
+- Use `tests/harness/tietiezhi-concurrency-lab.ts` for `/api/generate/batch`, submit-plane, Redis/BullMQ/DB/PgBouncer, and `tietiezhi` mock upstream validation.
+- Use `scripts/ops/workflow-1000-load.ts` for multi-user workflow execution, workflow cloning, and workflow node route validation.
+- Use `scripts/ops/precheck-2c4g-load.ps1` before either harness when Docker, Redis, PgBouncer, or LAN PostgreSQL might be the blocker.
+
+Read [`references/commands.md`](./references/commands.md) for exact commands. Read [`references/reporting.md`](./references/reporting.md) before declaring the run successful.
+
+## Follow the standard workflow
+
+1. Run the precheck script from PowerShell and confirm Docker API, Redis host port, PgBouncer host port, and LAN PostgreSQL are all reachable.
+2. Start Docker with the repo-supported Compose stack. Use the base Compose plus `docker-compose.local.yml` for normal local runs. Add `docker-compose.low-resource.yml` only when simulating the temporary 2C4G profile.
+3. Run a smoke stage first. Do not jump directly to the largest matrix.
+4. Ramp through the matrix in ascending order. Keep `--stop-on-fail` enabled so the harness stops once it finds a real platform or routing failure.
+5. Save the generated JSON and Markdown reports under `logs/测试服并发性能日志/<runId>/`.
+6. Do a run-scoped OSS cleanup only after checking that the report matches the current run.
+7. Write the final recommendation as "highest stable stage" and "recommended production ceiling", where the ceiling is usually 60%-70% of the highest stable stage.
+
+## Enforce the repo rules
+
+- Use Docker for pressure tests. Do not use `pnpm dev` as the main test surface.
+- Use `--apply-config` for tietiezhi batch runs when validating platform capacity; it writes the 20-minute execution policy and unified `capacity.providerCallConcurrency` profile before publishing hot reload.
+- The tietiezhi harness must not keep shorter local wait windows: submit tracker, generation tracker, and drain timeout default to the same 20-minute budget. If a run reports `generation_failed_force_timeout`, first verify the harness was run with the current defaults before treating it as a platform timeout.
+- For local tietiezhi runs, `--prepare-local-users` raises test users' `featureBatchLimit` to at least `max(1000, capacity-provider-call, max batch)`, so product membership slots do not masquerade as platform capacity failures.
+- Keep image stress tests on `model=tietiezhi` and `vendor=tietiezhi`. Treat Gemini image generation during these runs as a routing failure.
+- Keep `--skip-matting` enabled for the tietiezhi harness. Matting tunnel noise is not part of the target benchmark.
+- Treat host-side Redis metrics as `127.0.0.1:6379` unless `LOAD_REDIS_URL` or `--queue-redis-url` explicitly overrides it. Do not inherit stale `.env` values like `localhost:16379`.
+- Scale with multiple containers and processes, not `worker_threads`. The supported pattern is `--scale visionflow=2 --scale worker=2` and then tuning worker concurrency.
+- Keep OSS cleanup scoped to the current run. Never mass-delete historical test assets.
+- If you touch docs while adjusting this workflow, update `README*.md`, `DEPLOY*.md`, and `CHANGELOG*.md` together.
+
+## Classify failures correctly
+
+- Treat these as platform failures:
+  - queue `503` caused by local platform saturation or admission behavior
+  - Prisma pool timeouts
+  - balance freeze conflict snowballs
+  - workflow orphaning or BullMQ stage failures caused by local logic
+  - Gemini image calls, matting calls, or non-`tietiezhi` routing during a `tietiezhi` batch test
+- Treat these as infra or upstream blockers unless the repo changed them:
+  - Docker API or named pipe access issues
+  - LAN PostgreSQL unreachability
+  - Redis host port blocked before the test starts
+  - `tietiezhi` returning bad images, 1x1 placeholders, or upstream 5xx/timeout noise
+- If the harness stops because target IPM was missed but platform errors stayed at zero, record it as a capacity ceiling, not a correctness failure.
+
+## Use the references deliberately
+
+- Read [`references/commands.md`](./references/commands.md) when you need the exact precheck, startup, smoke, matrix, or cleanup commands.
+- Read [`references/reporting.md`](./references/reporting.md) when you need acceptance criteria, report contents, failure taxonomy, or recommendation format.
+- Read `docker/README.md` only when you need the Compose details behind the command matrix; do not re-derive the stack from scratch.
diff --git a/.claude/skills/pressure-testing/references/commands.md b/.claude/skills/pressure-testing/references/commands.md
new file mode 100644
index 0000000..40dcc3a
--- /dev/null
+++ b/.claude/skills/pressure-testing/references/commands.md
@@ -0,0 +1,95 @@
+# Pressure Testing Command Matrix
+
+## 1. Precheck
+
+Run this from the repo root before any Docker-based pressure test:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts/ops/precheck-2c4g-load.ps1 -ComposeEnvFile docker/.env -PsqlPath "C:\Program Files\PostgreSQL\18\bin\psql.exe"
+```
+
+Expected checks:
+
+- Docker API and current context
+- merged low-resource Compose config
+- host Redis port for metrics
+- PgBouncer host port
+- LAN PostgreSQL reachability through `psql`
+
+## 2. Start Docker
+
+### Standard local stack
+
+```powershell
+cd docker
+docker compose --env-file .env -f docker-compose.yml -f docker-compose.local.yml up -d --build visionflow worker redis caddy pgbouncer
+```
+
+### Temporary 2C4G simulation
+
+```powershell
+cd docker
+docker compose --env-file .env -f docker-compose.yml -f docker-compose.local.yml -f docker-compose.low-resource.yml up -d --build --scale visionflow=2 --scale worker=2 visionflow worker redis caddy pgbouncer
+```
+
+Use the low-resource overlay only for the temporary 2C4G simulation. It is not the main deployment entry.
+
+## 3. Tietiezhi batch harness
+
+### Smoke
+
+```powershell
+pnpm ops:tietiezhi-load -- --apply-config --users-list=10 --batch-size-list=30 --concurrency-list=10 --model=tietiezhi --vendor=tietiezhi --skip-matting --stop-on-fail --metrics-interval-ms=5000
+```
+
+### Main matrix
+
+```powershell
+pnpm ops:tietiezhi-load -- --apply-config --users-list=10,20,40 --batch-size-list=30,50,100 --concurrency-list=10,20,50,100,250,500,1000 --model=tietiezhi --vendor=tietiezhi --skip-matting --stop-on-fail --metrics-interval-ms=5000 --cleanup-oss
+```
+
+`--apply-config` writes the 20-minute execution policy and unified capacity profile. The harness also uses 20 minutes for submit/generation/drain tracking by default and raises local test users' batch/concurrency slots to at least `max(1000, capacity-provider-call, max batch)`.
+
+### Safe cleanup pass
+
+Run dry-run first if the last stage was exploratory or if object storage is shared:
+
+```powershell
+pnpm ops:tietiezhi-load -- --apply-config --users-list=10 --batch-size-list=30 --concurrency-list=10 --model=tietiezhi --vendor=tietiezhi --skip-matting --cleanup-oss --cleanup-dry-run=true
+```
+
+Switch `--cleanup-dry-run=false` only after confirming the run-scoped object list.
+
+## 4. Workflow harness
+
+### Smoke
+
+```powershell
+pnpm ops:workflow-load -- --low-resource-profile=2c4g --clone-workflows --concurrency-list=50 --requests=50 --users-limit=10 --user-pool-size=30 --apply-config
+```
+
+### Main matrix
+
+```powershell
+pnpm ops:workflow-load -- --low-resource-profile=2c4g --clone-workflows --concurrency-list=50,100,250,500,1000 --requests=1000 --users-limit=60 --user-pool-size=180 --apply-config --cleanup-oss --cleanup-dry-run=false
+```
+
+Use the default three workflow IDs unless the task explicitly requests a different set:
+
+- `cmobdcmms000dyt64ajrz0x7q`
+- `cmobdcjdd000byt64nwmntj5t`
+- `cmobdcg710009yt640g3nsyk8`
+
+The workflow harness already forces image-generation nodes to `tietiezhi/tietiezhi` and clones workflows per run when `--clone-workflows` is enabled.
+
+## 5. Required static checks when the load tooling changes
+
+Run these from the repo root when the harness, Docker stack, or pressure-test routing changes:
+
+```powershell
+pnpm typecheck
+pnpm lint
+RUN_DB_TESTS=1 pnpm exec vitest run src/lib/__tests__/balance-concurrency.test.ts --reporter=dot
+```
+
+Run `pnpm swagger:sync` only if the change also touched API behavior or Swagger annotations.
diff --git a/.claude/skills/pressure-testing/references/reporting.md b/.claude/skills/pressure-testing/references/reporting.md
new file mode 100644
index 0000000..109ff18
--- /dev/null
+++ b/.claude/skills/pressure-testing/references/reporting.md
@@ -0,0 +1,87 @@
+# Pressure Testing Reporting and Acceptance
+
+## Always capture
+
+- `runId`
+- Docker profile used and replica counts for `visionflow` and `worker`
+- user matrix, batch-size matrix, and concurrency matrix
+- submit latency `p50/p95/p99`
+- end-to-end latency `p50/p95/p99`
+- planned requests, accepted requests, accepted rate
+- planned images, success images, failed images, unresolved images
+- `429` count, `503` count, throttle rate
+- Redis memory and key queue stats
+- BullMQ `waiting/active/failed/delayed`
+- DB connection pressure and PgBouncer reachability or stats
+- container CPU, memory, restart count
+- route validation counts for `model/vendor`
+- OSS cleanup results: matched objects, deleted, skipped, errors
+
+## Artifact locations
+
+Write artifacts under:
+
+```text
+logs/测试服并发性能日志/<runId>/
+```
+
+At minimum keep:
+
+- one JSON report
+- one Markdown summary
+- any extra reconciliation or cleanup output produced by the harness
+
+## Pass / fail rules
+
+### Platform pass
+
+- no platform-side queue `503` misreport
+- no Prisma pool timeout
+- no balance-freeze conflict snowball
+- no workflow orphaning caused by local logic
+- no Gemini image calls during `tietiezhi` batch tests
+- no matting calls during `tietiezhi` batch tests
+- no non-`tietiezhi` image route mismatch
+
+### Platform fail
+
+- local admission or queue logic fails before upstream becomes the limiter
+- BullMQ or workflow stage logic fails under normal load
+- run reports show route mismatch or forbidden model/vendor usage
+- OSS cleanup deletes outside the current run
+
+### Capacity ceiling, not correctness fail
+
+- target IPM is missed
+- higher stages are slower
+- the harness stops because `stop-on-fail` hit a throughput threshold
+- platform-side correctness signals stay green
+
+Record these as "maximum stable stage reached X" and "recommended production ceiling Y".
+
+### Infra or upstream blocker
+
+- Docker API unavailable
+- LAN PostgreSQL unavailable
+- Redis host metrics port unreachable before the run starts
+- `tietiezhi` upstream returns 5xx, timeouts, or unusable images such as 1x1 placeholders
+
+Do not mix these with platform regressions.
+
+## Recommendation format
+
+State the result in this order:
+
+1. highest stable scenario
+2. why the next scenario failed or was stopped
+3. recommended production ceiling, usually 60%-70% of the highest stable scenario
+4. recommended replica count, worker concurrency, PgBouncer pool settings, and Redis memory budget
+
+Example shape:
+
+```text
+最高稳定档：20 users × batch 50 × concurrency 100
+停止原因：40 users × batch 50 × concurrency 250 开始出现上游 tietiezhi 5xx，平台侧指标仍稳定
+推荐生产档：20 users × batch 50 × concurrency 60-70
+建议配置：visionflow=2, worker=2, provider-call=128/worker, PgBouncer default_pool=50, Redis maxmemory=896MB
+```
diff --git a/.claude/skills/prototype/LOGIC.md b/.claude/skills/prototype/LOGIC.md
new file mode 100644
index 0000000..526ecb1
--- /dev/null
+++ b/.claude/skills/prototype/LOGIC.md
@@ -0,0 +1,79 @@
+# Logic Prototype
+
+A tiny interactive terminal app that lets the user drive a state model by hand. Use this when the question is about **business logic, state transitions, or data shape** — the kind of thing that looks reasonable on paper but only feels wrong once you push it through real cases.
+
+## When this is the right shape
+
+- "I'm not sure if this state machine handles the edge case where X then Y."
+- "Does this data model actually let me represent the case where..."
+- "I want to feel out what the API should look like before writing it."
+- Anything where the user wants to **press buttons and watch state change**.
+
+If the question is "what should this look like" — wrong branch. Use [UI.md](UI.md).
+
+## Process
+
+### 1. State the question
+
+Before writing code, write down what state model and what question you're prototyping. One paragraph, in the prototype's README or a comment at the top of the file. A logic prototype that answers the wrong question is pure waste — make the question explicit so it can be checked later, whether the user is watching now or returning to it AFK.
+
+### 2. Pick the language
+
+Use whatever the host project uses. If the project has no obvious runtime (e.g. a docs repo), ask.
+
+Match the project's existing conventions for tooling — don't add a new package manager or runtime just for the prototype.
+
+### 3. Isolate the logic in a portable module
+
+Put the actual logic — the bit that's answering the question — behind a small, pure interface that could be lifted out and dropped into the real codebase later. The TUI around it is throwaway; the logic module shouldn't be.
+
+The right shape depends on the question:
+
+- **A pure reducer** — `(state, action) => state`. Good when actions are discrete events and state is a single value.
+- **A state machine** — explicit states and transitions. Good when "which actions are even legal right now" is part of the question.
+- **A small set of pure functions** over a plain data type. Good when there's no implicit current state — just transformations.
+- **A class or module with a clear method surface** when the logic genuinely owns ongoing internal state.
+
+Pick whichever shape best fits the question being asked, *not* whichever is easiest to wire to a TUI. Keep it pure: no I/O, no terminal code, no `console.log` for control flow. The TUI imports it and calls into it; nothing flows the other direction.
+
+This is what makes the prototype useful past its own lifetime. When the question's been answered, the validated reducer / machine / function set can be lifted into the real module — the TUI shell gets deleted.
+
+### 4. Build the smallest TUI that exposes the state
+
+Build it as a **lightweight TUI** — on every tick, clear the screen (`console.clear()` / `print("\033[2J\033[H")` / equivalent) and re-render the whole frame. The user should always see one stable view, not an ever-growing scrollback.
+
+Each frame has two parts, in this order:
+
+1. **Current state**, pretty-printed and diff-friendly (one field per line, or formatted JSON). Use **bold** for field names or section headers and **dim** for less important context (timestamps, IDs, derived values). Native ANSI escape codes are fine — `\x1b[1m` bold, `\x1b[2m` dim, `\x1b[0m` reset. No need to pull in a styling library unless one is already in the project.
+2. **Keyboard shortcuts**, listed at the bottom: `[a] add user  [d] delete user  [t] tick clock  [q] quit`. Bold the key, dim the description, or vice-versa — whatever reads cleanly.
+
+Behaviour:
+
+1. **Initialise state** — a single in-memory object/struct. Render the first frame on start.
+2. **Read one keystroke (or one line)** at a time, dispatch to a handler that mutates state.
+3. **Re-render** the full frame after every action — don't append, replace.
+4. **Loop until quit.**
+
+The whole frame should fit on one screen.
+
+### 5. Make it runnable in one command
+
+Add a script to the project's existing task runner (`package.json` scripts, `Makefile`, `justfile`, `pyproject.toml`). The user should run `pnpm run <prototype-name>` or equivalent — never need to remember a path.
+
+If the host project has no task runner, just put the command at the top of the prototype's README.
+
+### 6. Hand it over
+
+Give the user the run command. They'll drive it themselves; the interesting moments are when they say "wait, that shouldn't be possible" or "huh, I assumed X would be different" — those are the bugs in the _idea_, which is the whole point. If they want new actions added, add them. Prototypes evolve.
+
+### 7. Capture the answer
+
+When the prototype has done its job, the answer to the question is the only thing worth keeping. If the user is around, ask what it taught them. If not, leave a `NOTES.md` next to the prototype so the answer can be filled in (or filled in by you, if you've watched the session) before the prototype gets deleted.
+
+## Anti-patterns
+
+- **Don't add tests.** A prototype that needs tests is no longer a prototype.
+- **Don't wire it to the real database.** Use an in-memory store unless the question is specifically about persistence.
+- **Don't generalise.** No "what if we wanted to support X later." The prototype answers one question.
+- **Don't blur the logic and the TUI together.** If the reducer / state machine references `console.log`, prompts, or terminal escape codes, it's no longer portable. Keep the TUI as a thin shell over a pure module.
+- **Don't ship the TUI shell into production.** The shell is optimised for being driven by hand from a terminal. The logic module behind it is the bit worth keeping.
diff --git a/.claude/skills/prototype/SKILL.md b/.claude/skills/prototype/SKILL.md
new file mode 100644
index 0000000..64f3e61
--- /dev/null
+++ b/.claude/skills/prototype/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: prototype
+description: Build a throwaway prototype to flesh out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".
+---
+
+# Prototype
+
+A prototype is **throwaway code that answers a question**. The question decides the shape.
+
+## Pick a branch
+
+Identify which question is being answered — from the user's prompt, the surrounding code, or by asking if the user is around:
+
+- **"Does this logic / state model feel right?"** → [LOGIC.md](LOGIC.md). Build a tiny interactive terminal app that pushes the state machine through cases that are hard to reason about on paper.
+- **"What should this look like?"** → [UI.md](UI.md). Generate several radically different UI variations on a single route, switchable via a URL search param and a floating bottom bar.
+
+The two branches produce very different artifacts — getting this wrong wastes the whole prototype. If the question is genuinely ambiguous and the user isn't reachable, default to whichever branch better matches the surrounding code (a backend module → logic; a page or component → UI) and state the assumption at the top of the prototype.
+
+## Rules that apply to both
+
+1. **Throwaway from day one, and clearly marked as such.** Locate the prototype code close to where it will actually be used (next to the module or page it's prototyping for) so context is obvious — but name it so a casual reader can see it's a prototype, not production. For throwaway UI routes, obey whatever routing convention the project already uses; don't invent a new top-level structure.
+2. **One command to run.** Whatever the project's existing task runner supports — `pnpm <name>`, `python <path>`, `bun <path>`, etc. The user must be able to start it without thinking.
+3. **No persistence by default.** State lives in memory. Persistence is the thing the prototype is _checking_, not something it should depend on. If the question explicitly involves a database, hit a scratch DB or a local file with a clear "PROTOTYPE — wipe me" name.
+4. **Skip the polish.** No tests, no error handling beyond what makes the prototype _runnable_, no abstractions. The point is to learn something fast and then delete it.
+5. **Surface the state.** After every action (logic) or on every variant switch (UI), print or render the full relevant state so the user can see what changed.
+6. **Delete or absorb when done.** When the prototype has answered its question, either delete it or fold the validated decision into the real code — don't leave it rotting in the repo.
+
+## When done
+
+The _answer_ is the only thing worth keeping from a prototype. Capture it somewhere durable (commit message, ADR, issue, or a `NOTES.md` next to the prototype) along with the question it was answering. If the user is around, that capture is a quick conversation; if not, leave the placeholder so they (or you, on the next pass) can fill in the verdict before deleting the prototype.
diff --git a/.claude/skills/prototype/UI.md b/.claude/skills/prototype/UI.md
new file mode 100644
index 0000000..f3b6e64
--- /dev/null
+++ b/.claude/skills/prototype/UI.md
@@ -0,0 +1,112 @@
+# UI Prototype
+
+Generate **several radically different UI variations** on a single route, switchable from a floating bottom bar. The user flips between variants in the browser, picks one (or steals bits from each), then throws the rest away.
+
+If the question is about logic/state rather than what something looks like — wrong branch. Use [LOGIC.md](LOGIC.md).
+
+## When this is the right shape
+
+- "What should this page look like?"
+- "I want to see a few options for this dashboard before committing."
+- "Try a different layout for the settings screen."
+- Any time the user would otherwise spend a day picking between three vague mockups in their head.
+
+## Two sub-shapes — strongly prefer sub-shape A
+
+A UI prototype is much easier to judge when it's **butting up against the rest of the app** — real header, real sidebar, real data, real density. A throwaway route on its own is a vacuum: every variant looks fine in isolation. Default to sub-shape A whenever there's a plausible existing page to host the variants. Only reach for sub-shape B if the prototype genuinely has no nearby home.
+
+### Sub-shape A — adjustment to an existing page (preferred)
+
+The route already exists. Variants are rendered **on the same route**, gated by a `?variant=` URL search param. The existing data fetching, params, and auth all stay — only the rendering swaps. This is the default; pick it unless there's a specific reason not to.
+
+If the prototype is for something that doesn't yet have a page but *would naturally live inside one* (a new section of the dashboard, a new card on the settings screen, a new step in an existing flow) — that's still sub-shape A. Mount the variants inside the host page.
+
+### Sub-shape B — a new page (last resort)
+
+Only use this when the thing being prototyped genuinely has no existing page to live inside — e.g. an entirely new top-level surface, or a flow that can't be embedded anywhere sensible.
+
+Create a **throwaway route** following whatever routing convention the project already uses — don't invent a new top-level structure. Name it so it's obviously a prototype (e.g. include the word `prototype` in the path or filename). Same `?variant=` pattern.
+
+Before committing to sub-shape B, sanity-check: is there really no existing page this could be embedded in? An empty route hides design problems that a populated one would expose.
+
+In both sub-shapes the floating bottom bar is identical.
+
+## Process
+
+### 1. State the question and pick N
+
+Default to **3 variants**. More than 5 stops being radically different and starts being noise — cap there.
+
+Write down the plan in one line, in the prototype's location or a top-of-file comment:
+
+> "Three variants of the settings page, switchable via `?variant=`, on the existing `/settings` route."
+
+This works whether the user is here to push back or not.
+
+### 2. Generate radically different variants
+
+Draft each variant. Hold each one to:
+
+- The page's purpose and the data it has access to.
+- The project's component library / styling system (TailwindCSS, shadcn, MUI, plain CSS, whatever).
+- A clear exported component name, e.g. `VariantA`, `VariantB`, `VariantC`.
+
+Variants must be **structurally different** — different layout, different information hierarchy, different primary affordance, not just different colours. Three slightly-tweaked card grids isn't a UI prototype, it's wallpaper. If two drafts come out too similar, redo one with explicit "do not use a card grid" guidance.
+
+### 3. Wire them together
+
+Create a single switcher component on the route:
+
+```tsx
+// pseudo-code — adapt to the project's framework
+const variant = searchParams.get('variant') ?? 'A';
+return (
+  <>
+    {variant === 'A' && <VariantA {...data} />}
+    {variant === 'B' && <VariantB {...data} />}
+    {variant === 'C' && <VariantC {...data} />}
+    <PrototypeSwitcher variants={['A','B','C']} current={variant} />
+  </>
+);
+```
+
+For sub-shape A (existing page): keep all the existing data fetching above the switcher; only the rendered subtree changes per variant.
+
+For sub-shape B (new page): the throwaway route under `/prototype/<name>` mounts the same switcher.
+
+### 4. Build the floating switcher
+
+A small fixed-position bar at the bottom-centre of the screen with three pieces:
+
+- **Left arrow** — cycles to the previous variant (wraps around).
+- **Variant label** — shows the current variant key and, if the variant exports a name, that name too. e.g. `B — Sidebar layout`.
+- **Right arrow** — cycles forward (wraps around).
+
+Behaviour:
+
+- Clicking an arrow updates the URL search param (use the framework's router — `router.replace` on Next, `navigate` on React Router, etc) so the variant is shareable and reload-stable.
+- Keyboard: `←` and `→` arrow keys also cycle. Don't intercept arrow keys when an `<input>`, `<textarea>`, or `[contenteditable]` is focused.
+- Visually distinct from the page (e.g. high-contrast pill, subtle shadow) so it's obviously not part of the design being evaluated.
+- Hidden in production builds — gate on `process.env.NODE_ENV !== 'production'` or an equivalent check, so a stray prototype merge can't ship the bar to users.
+
+Put the switcher in a single shared component so both sub-shapes can reuse it. Locate it wherever shared UI lives in the project.
+
+### 5. Hand it over
+
+Surface the URL (and the `?variant=` keys). The user will flip through whenever they get to it. The interesting feedback is usually **"I want the header from B with the sidebar from C"** — that's the actual design they want.
+
+### 6. Capture the answer and clean up
+
+Once a variant has won, write down which one and why (commit message, ADR, issue, or a `NOTES.md` next to the prototype if running AFK and the user hasn't responded yet). Then:
+
+- **Sub-shape A** — delete the losing variants and the switcher; fold the winner into the existing page.
+- **Sub-shape B** — promote the winning variant to a real route, delete the throwaway route and the switcher.
+
+Don't leave variant components or the switcher lying around. They rot fast and confuse the next reader.
+
+## Anti-patterns
+
+- **Variants that differ only in colour or copy.** That's a tweak, not a prototype. Real variants disagree about structure.
+- **Sharing too much code between variants.** A shared `<Header>` is fine; a shared `<Layout>` defeats the point. Each variant should be free to throw out the layout.
+- **Wiring variants to real mutations.** Read-only prototypes are fine. If a variant needs to mutate, point it at a stub — the question is "what should this look like", not "does the backend work".
+- **Promoting the prototype directly to production.** The variant code was written under prototype constraints (no tests, minimal error handling). Rewrite it properly when you fold it in.
diff --git a/.claude/skills/react-best-practices/SKILL.md b/.claude/skills/react-best-practices/SKILL.md
new file mode 100644
index 0000000..1ad7750
--- /dev/null
+++ b/.claude/skills/react-best-practices/SKILL.md
@@ -0,0 +1,136 @@
+---
+name: vercel-react-best-practices
+description: React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
+license: MIT
+metadata:
+  author: vercel
+  version: "1.0.0"
+---
+
+# Vercel React Best Practices
+
+Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains 57 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
+
+## When to Apply
+
+Reference these guidelines when:
+- Writing new React components or Next.js pages
+- Implementing data fetching (client or server-side)
+- Reviewing code for performance issues
+- Refactoring existing React/Next.js code
+- Optimizing bundle size or load times
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Prefix |
+|----------|----------|--------|--------|
+| 1 | Eliminating Waterfalls | CRITICAL | `async-` |
+| 2 | Bundle Size Optimization | CRITICAL | `bundle-` |
+| 3 | Server-Side Performance | HIGH | `server-` |
+| 4 | Client-Side Data Fetching | MEDIUM-HIGH | `client-` |
+| 5 | Re-render Optimization | MEDIUM | `rerender-` |
+| 6 | Rendering Performance | MEDIUM | `rendering-` |
+| 7 | JavaScript Performance | LOW-MEDIUM | `js-` |
+| 8 | Advanced Patterns | LOW | `advanced-` |
+
+## Quick Reference
+
+### 1. Eliminating Waterfalls (CRITICAL)
+
+- `async-defer-await` - Move await into branches where actually used
+- `async-parallel` - Use Promise.all() for independent operations
+- `async-dependencies` - Use better-all for partial dependencies
+- `async-api-routes` - Start promises early, await late in API routes
+- `async-suspense-boundaries` - Use Suspense to stream content
+
+### 2. Bundle Size Optimization (CRITICAL)
+
+- `bundle-barrel-imports` - Import directly, avoid barrel files
+- `bundle-dynamic-imports` - Use next/dynamic for heavy components
+- `bundle-defer-third-party` - Load analytics/logging after hydration
+- `bundle-conditional` - Load modules only when feature is activated
+- `bundle-preload` - Preload on hover/focus for perceived speed
+
+### 3. Server-Side Performance (HIGH)
+
+- `server-auth-actions` - Authenticate server actions like API routes
+- `server-cache-react` - Use React.cache() for per-request deduplication
+- `server-cache-lru` - Use LRU cache for cross-request caching
+- `server-dedup-props` - Avoid duplicate serialization in RSC props
+- `server-serialization` - Minimize data passed to client components
+- `server-parallel-fetching` - Restructure components to parallelize fetches
+- `server-after-nonblocking` - Use after() for non-blocking operations
+
+### 4. Client-Side Data Fetching (MEDIUM-HIGH)
+
+- `client-swr-dedup` - Use SWR for automatic request deduplication
+- `client-event-listeners` - Deduplicate global event listeners
+- `client-passive-event-listeners` - Use passive listeners for scroll
+- `client-localstorage-schema` - Version and minimize localStorage data
+
+### 5. Re-render Optimization (MEDIUM)
+
+- `rerender-defer-reads` - Don't subscribe to state only used in callbacks
+- `rerender-memo` - Extract expensive work into memoized components
+- `rerender-memo-with-default-value` - Hoist default non-primitive props
+- `rerender-dependencies` - Use primitive dependencies in effects
+- `rerender-derived-state` - Subscribe to derived booleans, not raw values
+- `rerender-derived-state-no-effect` - Derive state during render, not effects
+- `rerender-functional-setstate` - Use functional setState for stable callbacks
+- `rerender-lazy-state-init` - Pass function to useState for expensive values
+- `rerender-simple-expression-in-memo` - Avoid memo for simple primitives
+- `rerender-move-effect-to-event` - Put interaction logic in event handlers
+- `rerender-transitions` - Use startTransition for non-urgent updates
+- `rerender-use-ref-transient-values` - Use refs for transient frequent values
+
+### 6. Rendering Performance (MEDIUM)
+
+- `rendering-animate-svg-wrapper` - Animate div wrapper, not SVG element
+- `rendering-content-visibility` - Use content-visibility for long lists
+- `rendering-hoist-jsx` - Extract static JSX outside components
+- `rendering-svg-precision` - Reduce SVG coordinate precision
+- `rendering-hydration-no-flicker` - Use inline script for client-only data
+- `rendering-hydration-suppress-warning` - Suppress expected mismatches
+- `rendering-activity` - Use Activity component for show/hide
+- `rendering-conditional-render` - Use ternary, not && for conditionals
+- `rendering-usetransition-loading` - Prefer useTransition for loading state
+
+### 7. JavaScript Performance (LOW-MEDIUM)
+
+- `js-batch-dom-css` - Group CSS changes via classes or cssText
+- `js-index-maps` - Build Map for repeated lookups
+- `js-cache-property-access` - Cache object properties in loops
+- `js-cache-function-results` - Cache function results in module-level Map
+- `js-cache-storage` - Cache localStorage/sessionStorage reads
+- `js-combine-iterations` - Combine multiple filter/map into one loop
+- `js-length-check-first` - Check array length before expensive comparison
+- `js-early-exit` - Return early from functions
+- `js-hoist-regexp` - Hoist RegExp creation outside loops
+- `js-min-max-loop` - Use loop for min/max instead of sort
+- `js-set-map-lookups` - Use Set/Map for O(1) lookups
+- `js-tosorted-immutable` - Use toSorted() for immutability
+
+### 8. Advanced Patterns (LOW)
+
+- `advanced-event-handler-refs` - Store event handlers in refs
+- `advanced-init-once` - Initialize app once per app load
+- `advanced-use-latest` - useLatest for stable callback refs
+
+## How to Use
+
+Read individual rule files for detailed explanations and code examples:
+
+```
+rules/async-parallel.md
+rules/bundle-barrel-imports.md
+```
+
+Each rule file contains:
+- Brief explanation of why it matters
+- Incorrect code example with explanation
+- Correct code example with explanation
+- Additional context and references
+
+## Full Compiled Document
+
+For the complete guide with all rules expanded: `AGENTS.md`
diff --git a/.claude/skills/react-best-practices/metadata.json b/.claude/skills/react-best-practices/metadata.json
new file mode 100644
index 0000000..3bec38b
--- /dev/null
+++ b/.claude/skills/react-best-practices/metadata.json
@@ -0,0 +1,15 @@
+{
+  "version": "1.0.0",
+  "organization": "Vercel Engineering",
+  "date": "January 2026",
+  "abstract": "Comprehensive performance optimization guide for React and Next.js applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (eliminating waterfalls, reducing bundle size) to incremental (advanced patterns). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics to guide automated refactoring and code generation.",
+  "references": [
+    "https://react.dev",
+    "https://nextjs.org",
+    "https://swr.vercel.app",
+    "https://github.com/shuding/better-all",
+    "https://github.com/isaacs/node-lru-cache",
+    "https://vercel.com/blog/how-we-optimized-package-imports-in-next-js",
+    "https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast"
+  ]
+}
diff --git a/.claude/skills/react-best-practices/rules/_sections.md b/.claude/skills/react-best-practices/rules/_sections.md
new file mode 100644
index 0000000..4d20c14
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/_sections.md
@@ -0,0 +1,46 @@
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Eliminating Waterfalls (async)
+
+**Impact:** CRITICAL  
+**Description:** Waterfalls are the #1 performance killer. Each sequential await adds full network latency. Eliminating them yields the largest gains.
+
+## 2. Bundle Size Optimization (bundle)
+
+**Impact:** CRITICAL  
+**Description:** Reducing initial bundle size improves Time to Interactive and Largest Contentful Paint.
+
+## 3. Server-Side Performance (server)
+
+**Impact:** HIGH  
+**Description:** Optimizing server-side rendering and data fetching eliminates server-side waterfalls and reduces response times.
+
+## 4. Client-Side Data Fetching (client)
+
+**Impact:** MEDIUM-HIGH  
+**Description:** Automatic deduplication and efficient data fetching patterns reduce redundant network requests.
+
+## 5. Re-render Optimization (rerender)
+
+**Impact:** MEDIUM  
+**Description:** Reducing unnecessary re-renders minimizes wasted computation and improves UI responsiveness.
+
+## 6. Rendering Performance (rendering)
+
+**Impact:** MEDIUM  
+**Description:** Optimizing the rendering process reduces the work the browser needs to do.
+
+## 7. JavaScript Performance (js)
+
+**Impact:** LOW-MEDIUM  
+**Description:** Micro-optimizations for hot paths can add up to meaningful improvements.
+
+## 8. Advanced Patterns (advanced)
+
+**Impact:** LOW  
+**Description:** Advanced patterns for specific cases that require careful implementation.
diff --git a/.claude/skills/react-best-practices/rules/_template.md b/.claude/skills/react-best-practices/rules/_template.md
new file mode 100644
index 0000000..1e9e707
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/_template.md
@@ -0,0 +1,28 @@
+---
+title: Rule Title Here
+impact: MEDIUM
+impactDescription: Optional description of impact (e.g., "20-50% improvement")
+tags: tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: MEDIUM (optional impact description)**
+
+Brief explanation of the rule and why it matters. This should be clear and concise, explaining the performance implications.
+
+**Incorrect (description of what's wrong):**
+
+```typescript
+// Bad code example here
+const bad = example()
+```
+
+**Correct (description of what's right):**
+
+```typescript
+// Good code example here
+const good = example()
+```
+
+Reference: [Link to documentation or resource](https://example.com)
diff --git a/.claude/skills/react-best-practices/rules/advanced-event-handler-refs.md b/.claude/skills/react-best-practices/rules/advanced-event-handler-refs.md
new file mode 100644
index 0000000..97e7ade
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/advanced-event-handler-refs.md
@@ -0,0 +1,55 @@
+---
+title: Store Event Handlers in Refs
+impact: LOW
+impactDescription: stable subscriptions
+tags: advanced, hooks, refs, event-handlers, optimization
+---
+
+## Store Event Handlers in Refs
+
+Store callbacks in refs when used in effects that shouldn't re-subscribe on callback changes.
+
+**Incorrect (re-subscribes on every render):**
+
+```tsx
+function useWindowEvent(event: string, handler: (e) => void) {
+  useEffect(() => {
+    window.addEventListener(event, handler)
+    return () => window.removeEventListener(event, handler)
+  }, [event, handler])
+}
+```
+
+**Correct (stable subscription):**
+
+```tsx
+function useWindowEvent(event: string, handler: (e) => void) {
+  const handlerRef = useRef(handler)
+  useEffect(() => {
+    handlerRef.current = handler
+  }, [handler])
+
+  useEffect(() => {
+    const listener = (e) => handlerRef.current(e)
+    window.addEventListener(event, listener)
+    return () => window.removeEventListener(event, listener)
+  }, [event])
+}
+```
+
+**Alternative: use `useEffectEvent` if you're on latest React:**
+
+```tsx
+import { useEffectEvent } from 'react'
+
+function useWindowEvent(event: string, handler: (e) => void) {
+  const onEvent = useEffectEvent(handler)
+
+  useEffect(() => {
+    window.addEventListener(event, onEvent)
+    return () => window.removeEventListener(event, onEvent)
+  }, [event])
+}
+```
+
+`useEffectEvent` provides a cleaner API for the same pattern: it creates a stable function reference that always calls the latest version of the handler.
diff --git a/.claude/skills/react-best-practices/rules/advanced-init-once.md b/.claude/skills/react-best-practices/rules/advanced-init-once.md
new file mode 100644
index 0000000..73ee38e
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/advanced-init-once.md
@@ -0,0 +1,42 @@
+---
+title: Initialize App Once, Not Per Mount
+impact: LOW-MEDIUM
+impactDescription: avoids duplicate init in development
+tags: initialization, useEffect, app-startup, side-effects
+---
+
+## Initialize App Once, Not Per Mount
+
+Do not put app-wide initialization that must run once per app load inside `useEffect([])` of a component. Components can remount and effects will re-run. Use a module-level guard or top-level init in the entry module instead.
+
+**Incorrect (runs twice in dev, re-runs on remount):**
+
+```tsx
+function Comp() {
+  useEffect(() => {
+    loadFromStorage()
+    checkAuthToken()
+  }, [])
+
+  // ...
+}
+```
+
+**Correct (once per app load):**
+
+```tsx
+let didInit = false
+
+function Comp() {
+  useEffect(() => {
+    if (didInit) return
+    didInit = true
+    loadFromStorage()
+    checkAuthToken()
+  }, [])
+
+  // ...
+}
+```
+
+Reference: [Initializing the application](https://react.dev/learn/you-might-not-need-an-effect#initializing-the-application)
diff --git a/.claude/skills/react-best-practices/rules/advanced-use-latest.md b/.claude/skills/react-best-practices/rules/advanced-use-latest.md
new file mode 100644
index 0000000..9c7cb50
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/advanced-use-latest.md
@@ -0,0 +1,39 @@
+---
+title: useEffectEvent for Stable Callback Refs
+impact: LOW
+impactDescription: prevents effect re-runs
+tags: advanced, hooks, useEffectEvent, refs, optimization
+---
+
+## useEffectEvent for Stable Callback Refs
+
+Access latest values in callbacks without adding them to dependency arrays. Prevents effect re-runs while avoiding stale closures.
+
+**Incorrect (effect re-runs on every callback change):**
+
+```tsx
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearch(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query, onSearch])
+}
+```
+
+**Correct (using React's useEffectEvent):**
+
+```tsx
+import { useEffectEvent } from 'react';
+
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+  const onSearchEvent = useEffectEvent(onSearch)
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearchEvent(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query])
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/async-api-routes.md b/.claude/skills/react-best-practices/rules/async-api-routes.md
new file mode 100644
index 0000000..6feda1e
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/async-api-routes.md
@@ -0,0 +1,38 @@
+---
+title: Prevent Waterfall Chains in API Routes
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: api-routes, server-actions, waterfalls, parallelization
+---
+
+## Prevent Waterfall Chains in API Routes
+
+In API routes and Server Actions, start independent operations immediately, even if you don't await them yet.
+
+**Incorrect (config waits for auth, data waits for both):**
+
+```typescript
+export async function GET(request: Request) {
+  const session = await auth()
+  const config = await fetchConfig()
+  const data = await fetchData(session.user.id)
+  return Response.json({ data, config })
+}
+```
+
+**Correct (auth and config start immediately):**
+
+```typescript
+export async function GET(request: Request) {
+  const sessionPromise = auth()
+  const configPromise = fetchConfig()
+  const session = await sessionPromise
+  const [config, data] = await Promise.all([
+    configPromise,
+    fetchData(session.user.id)
+  ])
+  return Response.json({ data, config })
+}
+```
+
+For operations with more complex dependency chains, use `better-all` to automatically maximize parallelism (see Dependency-Based Parallelization).
diff --git a/.claude/skills/react-best-practices/rules/async-defer-await.md b/.claude/skills/react-best-practices/rules/async-defer-await.md
new file mode 100644
index 0000000..ea7082a
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/async-defer-await.md
@@ -0,0 +1,80 @@
+---
+title: Defer Await Until Needed
+impact: HIGH
+impactDescription: avoids blocking unused code paths
+tags: async, await, conditional, optimization
+---
+
+## Defer Await Until Needed
+
+Move `await` operations into the branches where they're actually used to avoid blocking code paths that don't need them.
+
+**Incorrect (blocks both branches):**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  const userData = await fetchUserData(userId)
+  
+  if (skipProcessing) {
+    // Returns immediately but still waited for userData
+    return { skipped: true }
+  }
+  
+  // Only this branch uses userData
+  return processUserData(userData)
+}
+```
+
+**Correct (only blocks when needed):**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  if (skipProcessing) {
+    // Returns immediately without waiting
+    return { skipped: true }
+  }
+  
+  // Fetch only when needed
+  const userData = await fetchUserData(userId)
+  return processUserData(userData)
+}
+```
+
+**Another example (early return optimization):**
+
+```typescript
+// Incorrect: always fetches permissions
+async function updateResource(resourceId: string, userId: string) {
+  const permissions = await fetchPermissions(userId)
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+
+// Correct: fetches only when needed
+async function updateResource(resourceId: string, userId: string) {
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  const permissions = await fetchPermissions(userId)
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+```
+
+This optimization is especially valuable when the skipped branch is frequently taken, or when the deferred operation is expensive.
diff --git a/.claude/skills/react-best-practices/rules/async-dependencies.md b/.claude/skills/react-best-practices/rules/async-dependencies.md
new file mode 100644
index 0000000..0484eba
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/async-dependencies.md
@@ -0,0 +1,51 @@
+---
+title: Dependency-Based Parallelization
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: async, parallelization, dependencies, better-all
+---
+
+## Dependency-Based Parallelization
+
+For operations with partial dependencies, use `better-all` to maximize parallelism. It automatically starts each task at the earliest possible moment.
+
+**Incorrect (profile waits for config unnecessarily):**
+
+```typescript
+const [user, config] = await Promise.all([
+  fetchUser(),
+  fetchConfig()
+])
+const profile = await fetchProfile(user.id)
+```
+
+**Correct (config and profile run in parallel):**
+
+```typescript
+import { all } from 'better-all'
+
+const { user, config, profile } = await all({
+  async user() { return fetchUser() },
+  async config() { return fetchConfig() },
+  async profile() {
+    return fetchProfile((await this.$.user).id)
+  }
+})
+```
+
+**Alternative without extra dependencies:**
+
+We can also create all the promises first, and do `Promise.all()` at the end.
+
+```typescript
+const userPromise = fetchUser()
+const profilePromise = userPromise.then(user => fetchProfile(user.id))
+
+const [user, config, profile] = await Promise.all([
+  userPromise,
+  fetchConfig(),
+  profilePromise
+])
+```
+
+Reference: [https://github.com/shuding/better-all](https://github.com/shuding/better-all)
diff --git a/.claude/skills/react-best-practices/rules/async-parallel.md b/.claude/skills/react-best-practices/rules/async-parallel.md
new file mode 100644
index 0000000..64133f6
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/async-parallel.md
@@ -0,0 +1,28 @@
+---
+title: Promise.all() for Independent Operations
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: async, parallelization, promises, waterfalls
+---
+
+## Promise.all() for Independent Operations
+
+When async operations have no interdependencies, execute them concurrently using `Promise.all()`.
+
+**Incorrect (sequential execution, 3 round trips):**
+
+```typescript
+const user = await fetchUser()
+const posts = await fetchPosts()
+const comments = await fetchComments()
+```
+
+**Correct (parallel execution, 1 round trip):**
+
+```typescript
+const [user, posts, comments] = await Promise.all([
+  fetchUser(),
+  fetchPosts(),
+  fetchComments()
+])
+```
diff --git a/.claude/skills/react-best-practices/rules/async-suspense-boundaries.md b/.claude/skills/react-best-practices/rules/async-suspense-boundaries.md
new file mode 100644
index 0000000..1fbc05b
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/async-suspense-boundaries.md
@@ -0,0 +1,99 @@
+---
+title: Strategic Suspense Boundaries
+impact: HIGH
+impactDescription: faster initial paint
+tags: async, suspense, streaming, layout-shift
+---
+
+## Strategic Suspense Boundaries
+
+Instead of awaiting data in async components before returning JSX, use Suspense boundaries to show the wrapper UI faster while data loads.
+
+**Incorrect (wrapper blocked by data fetching):**
+
+```tsx
+async function Page() {
+  const data = await fetchData() // Blocks entire page
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <DataDisplay data={data} />
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+```
+
+The entire layout waits for data even though only the middle section needs it.
+
+**Correct (wrapper shows immediately, data streams in):**
+
+```tsx
+function Page() {
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <Suspense fallback={<Skeleton />}>
+          <DataDisplay />
+        </Suspense>
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+async function DataDisplay() {
+  const data = await fetchData() // Only blocks this component
+  return <div>{data.content}</div>
+}
+```
+
+Sidebar, Header, and Footer render immediately. Only DataDisplay waits for data.
+
+**Alternative (share promise across components):**
+
+```tsx
+function Page() {
+  // Start fetch immediately, but don't await
+  const dataPromise = fetchData()
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <Suspense fallback={<Skeleton />}>
+        <DataDisplay dataPromise={dataPromise} />
+        <DataSummary dataPromise={dataPromise} />
+      </Suspense>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+function DataDisplay({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Unwraps the promise
+  return <div>{data.content}</div>
+}
+
+function DataSummary({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Reuses the same promise
+  return <div>{data.summary}</div>
+}
+```
+
+Both components share the same promise, so only one fetch occurs. Layout renders immediately while both components wait together.
+
+**When NOT to use this pattern:**
+
+- Critical data needed for layout decisions (affects positioning)
+- SEO-critical content above the fold
+- Small, fast queries where suspense overhead isn't worth it
+- When you want to avoid layout shift (loading → content jump)
+
+**Trade-off:** Faster initial paint vs potential layout shift. Choose based on your UX priorities.
diff --git a/.claude/skills/react-best-practices/rules/bundle-barrel-imports.md b/.claude/skills/react-best-practices/rules/bundle-barrel-imports.md
new file mode 100644
index 0000000..ee48f32
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/bundle-barrel-imports.md
@@ -0,0 +1,59 @@
+---
+title: Avoid Barrel File Imports
+impact: CRITICAL
+impactDescription: 200-800ms import cost, slow builds
+tags: bundle, imports, tree-shaking, barrel-files, performance
+---
+
+## Avoid Barrel File Imports
+
+Import directly from source files instead of barrel files to avoid loading thousands of unused modules. **Barrel files** are entry points that re-export multiple modules (e.g., `index.js` that does `export * from './module'`).
+
+Popular icon and component libraries can have **up to 10,000 re-exports** in their entry file. For many React packages, **it takes 200-800ms just to import them**, affecting both development speed and production cold starts.
+
+**Why tree-shaking doesn't help:** When a library is marked as external (not bundled), the bundler can't optimize it. If you bundle it to enable tree-shaking, builds become substantially slower analyzing the entire module graph.
+
+**Incorrect (imports entire library):**
+
+```tsx
+import { Check, X, Menu } from 'lucide-react'
+// Loads 1,583 modules, takes ~2.8s extra in dev
+// Runtime cost: 200-800ms on every cold start
+
+import { Button, TextField } from '@mui/material'
+// Loads 2,225 modules, takes ~4.2s extra in dev
+```
+
+**Correct (imports only what you need):**
+
+```tsx
+import Check from 'lucide-react/dist/esm/icons/check'
+import X from 'lucide-react/dist/esm/icons/x'
+import Menu from 'lucide-react/dist/esm/icons/menu'
+// Loads only 3 modules (~2KB vs ~1MB)
+
+import Button from '@mui/material/Button'
+import TextField from '@mui/material/TextField'
+// Loads only what you use
+```
+
+**Alternative (Next.js 13.5+):**
+
+```js
+// next.config.js - use optimizePackageImports
+module.exports = {
+  experimental: {
+    optimizePackageImports: ['lucide-react', '@mui/material']
+  }
+}
+
+// Then you can keep the ergonomic barrel imports:
+import { Check, X, Menu } from 'lucide-react'
+// Automatically transformed to direct imports at build time
+```
+
+Direct imports provide 15-70% faster dev boot, 28% faster builds, 40% faster cold starts, and significantly faster HMR.
+
+Libraries commonly affected: `lucide-react`, `@mui/material`, `@mui/icons-material`, `@tabler/icons-react`, `react-icons`, `@headlessui/react`, `@radix-ui/react-*`, `lodash`, `ramda`, `date-fns`, `rxjs`, `react-use`.
+
+Reference: [How we optimized package imports in Next.js](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
diff --git a/.claude/skills/react-best-practices/rules/bundle-conditional.md b/.claude/skills/react-best-practices/rules/bundle-conditional.md
new file mode 100644
index 0000000..99d6fc9
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/bundle-conditional.md
@@ -0,0 +1,31 @@
+---
+title: Conditional Module Loading
+impact: HIGH
+impactDescription: loads large data only when needed
+tags: bundle, conditional-loading, lazy-loading
+---
+
+## Conditional Module Loading
+
+Load large data or modules only when a feature is activated.
+
+**Example (lazy-load animation frames):**
+
+```tsx
+function AnimationPlayer({ enabled, setEnabled }: { enabled: boolean; setEnabled: React.Dispatch<React.SetStateAction<boolean>> }) {
+  const [frames, setFrames] = useState<Frame[] | null>(null)
+
+  useEffect(() => {
+    if (enabled && !frames && typeof window !== 'undefined') {
+      import('./animation-frames.js')
+        .then(mod => setFrames(mod.frames))
+        .catch(() => setEnabled(false))
+    }
+  }, [enabled, frames, setEnabled])
+
+  if (!frames) return <Skeleton />
+  return <Canvas frames={frames} />
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling this module for SSR, optimizing server bundle size and build speed.
diff --git a/.claude/skills/react-best-practices/rules/bundle-defer-third-party.md b/.claude/skills/react-best-practices/rules/bundle-defer-third-party.md
new file mode 100644
index 0000000..db041d1
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/bundle-defer-third-party.md
@@ -0,0 +1,49 @@
+---
+title: Defer Non-Critical Third-Party Libraries
+impact: MEDIUM
+impactDescription: loads after hydration
+tags: bundle, third-party, analytics, defer
+---
+
+## Defer Non-Critical Third-Party Libraries
+
+Analytics, logging, and error tracking don't block user interaction. Load them after hydration.
+
+**Incorrect (blocks initial bundle):**
+
+```tsx
+import { Analytics } from '@vercel/analytics/react'
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
+
+**Correct (loads after hydration):**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const Analytics = dynamic(
+  () => import('@vercel/analytics/react').then(m => m.Analytics),
+  { ssr: false }
+)
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/bundle-dynamic-imports.md b/.claude/skills/react-best-practices/rules/bundle-dynamic-imports.md
new file mode 100644
index 0000000..60b6269
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/bundle-dynamic-imports.md
@@ -0,0 +1,35 @@
+---
+title: Dynamic Imports for Heavy Components
+impact: CRITICAL
+impactDescription: directly affects TTI and LCP
+tags: bundle, dynamic-import, code-splitting, next-dynamic
+---
+
+## Dynamic Imports for Heavy Components
+
+Use `next/dynamic` to lazy-load large components not needed on initial render.
+
+**Incorrect (Monaco bundles with main chunk ~300KB):**
+
+```tsx
+import { MonacoEditor } from './monaco-editor'
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
+
+**Correct (Monaco loads on demand):**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const MonacoEditor = dynamic(
+  () => import('./monaco-editor').then(m => m.MonacoEditor),
+  { ssr: false }
+)
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/bundle-preload.md b/.claude/skills/react-best-practices/rules/bundle-preload.md
new file mode 100644
index 0000000..7000504
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/bundle-preload.md
@@ -0,0 +1,50 @@
+---
+title: Preload Based on User Intent
+impact: MEDIUM
+impactDescription: reduces perceived latency
+tags: bundle, preload, user-intent, hover
+---
+
+## Preload Based on User Intent
+
+Preload heavy bundles before they're needed to reduce perceived latency.
+
+**Example (preload on hover/focus):**
+
+```tsx
+function EditorButton({ onClick }: { onClick: () => void }) {
+  const preload = () => {
+    if (typeof window !== 'undefined') {
+      void import('./monaco-editor')
+    }
+  }
+
+  return (
+    <button
+      onMouseEnter={preload}
+      onFocus={preload}
+      onClick={onClick}
+    >
+      Open Editor
+    </button>
+  )
+}
+```
+
+**Example (preload when feature flag is enabled):**
+
+```tsx
+function FlagsProvider({ children, flags }: Props) {
+  useEffect(() => {
+    if (flags.editorEnabled && typeof window !== 'undefined') {
+      void import('./monaco-editor').then(mod => mod.init())
+    }
+  }, [flags.editorEnabled])
+
+  return <FlagsContext.Provider value={flags}>
+    {children}
+  </FlagsContext.Provider>
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling preloaded modules for SSR, optimizing server bundle size and build speed.
diff --git a/.claude/skills/react-best-practices/rules/client-event-listeners.md b/.claude/skills/react-best-practices/rules/client-event-listeners.md
new file mode 100644
index 0000000..aad4ae9
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/client-event-listeners.md
@@ -0,0 +1,74 @@
+---
+title: Deduplicate Global Event Listeners
+impact: LOW
+impactDescription: single listener for N components
+tags: client, swr, event-listeners, subscription
+---
+
+## Deduplicate Global Event Listeners
+
+Use `useSWRSubscription()` to share global event listeners across component instances.
+
+**Incorrect (N instances = N listeners):**
+
+```tsx
+function useKeyboardShortcut(key: string, callback: () => void) {
+  useEffect(() => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && e.key === key) {
+        callback()
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  }, [key, callback])
+}
+```
+
+When using the `useKeyboardShortcut` hook multiple times, each instance will register a new listener.
+
+**Correct (N instances = 1 listener):**
+
+```tsx
+import useSWRSubscription from 'swr/subscription'
+
+// Module-level Map to track callbacks per key
+const keyCallbacks = new Map<string, Set<() => void>>()
+
+function useKeyboardShortcut(key: string, callback: () => void) {
+  // Register this callback in the Map
+  useEffect(() => {
+    if (!keyCallbacks.has(key)) {
+      keyCallbacks.set(key, new Set())
+    }
+    keyCallbacks.get(key)!.add(callback)
+
+    return () => {
+      const set = keyCallbacks.get(key)
+      if (set) {
+        set.delete(callback)
+        if (set.size === 0) {
+          keyCallbacks.delete(key)
+        }
+      }
+    }
+  }, [key, callback])
+
+  useSWRSubscription('global-keydown', () => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && keyCallbacks.has(e.key)) {
+        keyCallbacks.get(e.key)!.forEach(cb => cb())
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  })
+}
+
+function Profile() {
+  // Multiple shortcuts will share the same listener
+  useKeyboardShortcut('p', () => { /* ... */ }) 
+  useKeyboardShortcut('k', () => { /* ... */ })
+  // ...
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/client-localstorage-schema.md b/.claude/skills/react-best-practices/rules/client-localstorage-schema.md
new file mode 100644
index 0000000..d30a1a7
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/client-localstorage-schema.md
@@ -0,0 +1,71 @@
+---
+title: Version and Minimize localStorage Data
+impact: MEDIUM
+impactDescription: prevents schema conflicts, reduces storage size
+tags: client, localStorage, storage, versioning, data-minimization
+---
+
+## Version and Minimize localStorage Data
+
+Add version prefix to keys and store only needed fields. Prevents schema conflicts and accidental storage of sensitive data.
+
+**Incorrect:**
+
+```typescript
+// No version, stores everything, no error handling
+localStorage.setItem('userConfig', JSON.stringify(fullUserObject))
+const data = localStorage.getItem('userConfig')
+```
+
+**Correct:**
+
+```typescript
+const VERSION = 'v2'
+
+function saveConfig(config: { theme: string; language: string }) {
+  try {
+    localStorage.setItem(`userConfig:${VERSION}`, JSON.stringify(config))
+  } catch {
+    // Throws in incognito/private browsing, quota exceeded, or disabled
+  }
+}
+
+function loadConfig() {
+  try {
+    const data = localStorage.getItem(`userConfig:${VERSION}`)
+    return data ? JSON.parse(data) : null
+  } catch {
+    return null
+  }
+}
+
+// Migration from v1 to v2
+function migrate() {
+  try {
+    const v1 = localStorage.getItem('userConfig:v1')
+    if (v1) {
+      const old = JSON.parse(v1)
+      saveConfig({ theme: old.darkMode ? 'dark' : 'light', language: old.lang })
+      localStorage.removeItem('userConfig:v1')
+    }
+  } catch {}
+}
+```
+
+**Store minimal fields from server responses:**
+
+```typescript
+// User object has 20+ fields, only store what UI needs
+function cachePrefs(user: FullUser) {
+  try {
+    localStorage.setItem('prefs:v1', JSON.stringify({
+      theme: user.preferences.theme,
+      notifications: user.preferences.notifications
+    }))
+  } catch {}
+}
+```
+
+**Always wrap in try-catch:** `getItem()` and `setItem()` throw in incognito/private browsing (Safari, Firefox), when quota exceeded, or when disabled.
+
+**Benefits:** Schema evolution via versioning, reduced storage size, prevents storing tokens/PII/internal flags.
diff --git a/.claude/skills/react-best-practices/rules/client-passive-event-listeners.md b/.claude/skills/react-best-practices/rules/client-passive-event-listeners.md
new file mode 100644
index 0000000..ce39a88
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/client-passive-event-listeners.md
@@ -0,0 +1,48 @@
+---
+title: Use Passive Event Listeners for Scrolling Performance
+impact: MEDIUM
+impactDescription: eliminates scroll delay caused by event listeners
+tags: client, event-listeners, scrolling, performance, touch, wheel
+---
+
+## Use Passive Event Listeners for Scrolling Performance
+
+Add `{ passive: true }` to touch and wheel event listeners to enable immediate scrolling. Browsers normally wait for listeners to finish to check if `preventDefault()` is called, causing scroll delay.
+
+**Incorrect:**
+
+```typescript
+useEffect(() => {
+  const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
+  const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
+  
+  document.addEventListener('touchstart', handleTouch)
+  document.addEventListener('wheel', handleWheel)
+  
+  return () => {
+    document.removeEventListener('touchstart', handleTouch)
+    document.removeEventListener('wheel', handleWheel)
+  }
+}, [])
+```
+
+**Correct:**
+
+```typescript
+useEffect(() => {
+  const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
+  const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
+  
+  document.addEventListener('touchstart', handleTouch, { passive: true })
+  document.addEventListener('wheel', handleWheel, { passive: true })
+  
+  return () => {
+    document.removeEventListener('touchstart', handleTouch)
+    document.removeEventListener('wheel', handleWheel)
+  }
+}, [])
+```
+
+**Use passive when:** tracking/analytics, logging, any listener that doesn't call `preventDefault()`.
+
+**Don't use passive when:** implementing custom swipe gestures, custom zoom controls, or any listener that needs `preventDefault()`.
diff --git a/.claude/skills/react-best-practices/rules/client-swr-dedup.md b/.claude/skills/react-best-practices/rules/client-swr-dedup.md
new file mode 100644
index 0000000..2a430f2
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/client-swr-dedup.md
@@ -0,0 +1,56 @@
+---
+title: Use SWR for Automatic Deduplication
+impact: MEDIUM-HIGH
+impactDescription: automatic deduplication
+tags: client, swr, deduplication, data-fetching
+---
+
+## Use SWR for Automatic Deduplication
+
+SWR enables request deduplication, caching, and revalidation across component instances.
+
+**Incorrect (no deduplication, each instance fetches):**
+
+```tsx
+function UserList() {
+  const [users, setUsers] = useState([])
+  useEffect(() => {
+    fetch('/api/users')
+      .then(r => r.json())
+      .then(setUsers)
+  }, [])
+}
+```
+
+**Correct (multiple instances share one request):**
+
+```tsx
+import useSWR from 'swr'
+
+function UserList() {
+  const { data: users } = useSWR('/api/users', fetcher)
+}
+```
+
+**For immutable data:**
+
+```tsx
+import { useImmutableSWR } from '@/lib/swr'
+
+function StaticContent() {
+  const { data } = useImmutableSWR('/api/config', fetcher)
+}
+```
+
+**For mutations:**
+
+```tsx
+import { useSWRMutation } from 'swr/mutation'
+
+function UpdateButton() {
+  const { trigger } = useSWRMutation('/api/user', updateUser)
+  return <button onClick={() => trigger()}>Update</button>
+}
+```
+
+Reference: [https://swr.vercel.app](https://swr.vercel.app)
diff --git a/.claude/skills/react-best-practices/rules/js-batch-dom-css.md b/.claude/skills/react-best-practices/rules/js-batch-dom-css.md
new file mode 100644
index 0000000..a62d84e
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-batch-dom-css.md
@@ -0,0 +1,107 @@
+---
+title: Avoid Layout Thrashing
+impact: MEDIUM
+impactDescription: prevents forced synchronous layouts and reduces performance bottlenecks
+tags: javascript, dom, css, performance, reflow, layout-thrashing
+---
+
+## Avoid Layout Thrashing
+
+Avoid interleaving style writes with layout reads. When you read a layout property (like `offsetWidth`, `getBoundingClientRect()`, or `getComputedStyle()`) between style changes, the browser is forced to trigger a synchronous reflow.
+
+**This is OK (browser batches style changes):**
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  // Each line invalidates style, but browser batches the recalculation
+  element.style.width = '100px'
+  element.style.height = '200px'
+  element.style.backgroundColor = 'blue'
+  element.style.border = '1px solid black'
+}
+```
+
+**Incorrect (interleaved reads and writes force reflows):**
+```typescript
+function layoutThrashing(element: HTMLElement) {
+  element.style.width = '100px'
+  const width = element.offsetWidth  // Forces reflow
+  element.style.height = '200px'
+  const height = element.offsetHeight  // Forces another reflow
+}
+```
+
+**Correct (batch writes, then read once):**
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  // Batch all writes together
+  element.style.width = '100px'
+  element.style.height = '200px'
+  element.style.backgroundColor = 'blue'
+  element.style.border = '1px solid black'
+  
+  // Read after all writes are done (single reflow)
+  const { width, height } = element.getBoundingClientRect()
+}
+```
+
+**Correct (batch reads, then writes):**
+```typescript
+function avoidThrashing(element: HTMLElement) {
+  // Read phase - all layout queries first
+  const rect1 = element.getBoundingClientRect()
+  const offsetWidth = element.offsetWidth
+  const offsetHeight = element.offsetHeight
+  
+  // Write phase - all style changes after
+  element.style.width = '100px'
+  element.style.height = '200px'
+}
+```
+
+**Better: use CSS classes**
+```css
+.highlighted-box {
+  width: 100px;
+  height: 200px;
+  background-color: blue;
+  border: 1px solid black;
+}
+```
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  element.classList.add('highlighted-box')
+  
+  const { width, height } = element.getBoundingClientRect()
+}
+```
+
+**React example:**
+```tsx
+// Incorrect: interleaving style changes with layout queries
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  const ref = useRef<HTMLDivElement>(null)
+  
+  useEffect(() => {
+    if (ref.current && isHighlighted) {
+      ref.current.style.width = '100px'
+      const width = ref.current.offsetWidth // Forces layout
+      ref.current.style.height = '200px'
+    }
+  }, [isHighlighted])
+  
+  return <div ref={ref}>Content</div>
+}
+
+// Correct: toggle class
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  return (
+    <div className={isHighlighted ? 'highlighted-box' : ''}>
+      Content
+    </div>
+  )
+}
+```
+
+Prefer CSS classes over inline styles when possible. CSS files are cached by the browser, and classes provide better separation of concerns and are easier to maintain.
+
+See [this gist](https://gist.github.com/paulirish/5d52fb081b3570c81e3a) and [CSS Triggers](https://csstriggers.com/) for more information on layout-forcing operations.
diff --git a/.claude/skills/react-best-practices/rules/js-cache-function-results.md b/.claude/skills/react-best-practices/rules/js-cache-function-results.md
new file mode 100644
index 0000000..180f8ac
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-cache-function-results.md
@@ -0,0 +1,80 @@
+---
+title: Cache Repeated Function Calls
+impact: MEDIUM
+impactDescription: avoid redundant computation
+tags: javascript, cache, memoization, performance
+---
+
+## Cache Repeated Function Calls
+
+Use a module-level Map to cache function results when the same function is called repeatedly with the same inputs during render.
+
+**Incorrect (redundant computation):**
+
+```typescript
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // slugify() called 100+ times for same project names
+        const slug = slugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Correct (cached results):**
+
+```typescript
+// Module-level cache
+const slugifyCache = new Map<string, string>()
+
+function cachedSlugify(text: string): string {
+  if (slugifyCache.has(text)) {
+    return slugifyCache.get(text)!
+  }
+  const result = slugify(text)
+  slugifyCache.set(text, result)
+  return result
+}
+
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // Computed only once per unique project name
+        const slug = cachedSlugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Simpler pattern for single-value functions:**
+
+```typescript
+let isLoggedInCache: boolean | null = null
+
+function isLoggedIn(): boolean {
+  if (isLoggedInCache !== null) {
+    return isLoggedInCache
+  }
+  
+  isLoggedInCache = document.cookie.includes('auth=')
+  return isLoggedInCache
+}
+
+// Clear cache when auth changes
+function onAuthChange() {
+  isLoggedInCache = null
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+Reference: [How we made the Vercel Dashboard twice as fast](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
diff --git a/.claude/skills/react-best-practices/rules/js-cache-property-access.md b/.claude/skills/react-best-practices/rules/js-cache-property-access.md
new file mode 100644
index 0000000..39eec90
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-cache-property-access.md
@@ -0,0 +1,28 @@
+---
+title: Cache Property Access in Loops
+impact: LOW-MEDIUM
+impactDescription: reduces lookups
+tags: javascript, loops, optimization, caching
+---
+
+## Cache Property Access in Loops
+
+Cache object property lookups in hot paths.
+
+**Incorrect (3 lookups × N iterations):**
+
+```typescript
+for (let i = 0; i < arr.length; i++) {
+  process(obj.config.settings.value)
+}
+```
+
+**Correct (1 lookup total):**
+
+```typescript
+const value = obj.config.settings.value
+const len = arr.length
+for (let i = 0; i < len; i++) {
+  process(value)
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/js-cache-storage.md b/.claude/skills/react-best-practices/rules/js-cache-storage.md
new file mode 100644
index 0000000..aa4a30c
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-cache-storage.md
@@ -0,0 +1,70 @@
+---
+title: Cache Storage API Calls
+impact: LOW-MEDIUM
+impactDescription: reduces expensive I/O
+tags: javascript, localStorage, storage, caching, performance
+---
+
+## Cache Storage API Calls
+
+`localStorage`, `sessionStorage`, and `document.cookie` are synchronous and expensive. Cache reads in memory.
+
+**Incorrect (reads storage on every call):**
+
+```typescript
+function getTheme() {
+  return localStorage.getItem('theme') ?? 'light'
+}
+// Called 10 times = 10 storage reads
+```
+
+**Correct (Map cache):**
+
+```typescript
+const storageCache = new Map<string, string | null>()
+
+function getLocalStorage(key: string) {
+  if (!storageCache.has(key)) {
+    storageCache.set(key, localStorage.getItem(key))
+  }
+  return storageCache.get(key)
+}
+
+function setLocalStorage(key: string, value: string) {
+  localStorage.setItem(key, value)
+  storageCache.set(key, value)  // keep cache in sync
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+**Cookie caching:**
+
+```typescript
+let cookieCache: Record<string, string> | null = null
+
+function getCookie(name: string) {
+  if (!cookieCache) {
+    cookieCache = Object.fromEntries(
+      document.cookie.split('; ').map(c => c.split('='))
+    )
+  }
+  return cookieCache[name]
+}
+```
+
+**Important (invalidate on external changes):**
+
+If storage can change externally (another tab, server-set cookies), invalidate cache:
+
+```typescript
+window.addEventListener('storage', (e) => {
+  if (e.key) storageCache.delete(e.key)
+})
+
+document.addEventListener('visibilitychange', () => {
+  if (document.visibilityState === 'visible') {
+    storageCache.clear()
+  }
+})
+```
diff --git a/.claude/skills/react-best-practices/rules/js-combine-iterations.md b/.claude/skills/react-best-practices/rules/js-combine-iterations.md
new file mode 100644
index 0000000..044d017
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-combine-iterations.md
@@ -0,0 +1,32 @@
+---
+title: Combine Multiple Array Iterations
+impact: LOW-MEDIUM
+impactDescription: reduces iterations
+tags: javascript, arrays, loops, performance
+---
+
+## Combine Multiple Array Iterations
+
+Multiple `.filter()` or `.map()` calls iterate the array multiple times. Combine into one loop.
+
+**Incorrect (3 iterations):**
+
+```typescript
+const admins = users.filter(u => u.isAdmin)
+const testers = users.filter(u => u.isTester)
+const inactive = users.filter(u => !u.isActive)
+```
+
+**Correct (1 iteration):**
+
+```typescript
+const admins: User[] = []
+const testers: User[] = []
+const inactive: User[] = []
+
+for (const user of users) {
+  if (user.isAdmin) admins.push(user)
+  if (user.isTester) testers.push(user)
+  if (!user.isActive) inactive.push(user)
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/js-early-exit.md b/.claude/skills/react-best-practices/rules/js-early-exit.md
new file mode 100644
index 0000000..f46cb89
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-early-exit.md
@@ -0,0 +1,50 @@
+---
+title: Early Return from Functions
+impact: LOW-MEDIUM
+impactDescription: avoids unnecessary computation
+tags: javascript, functions, optimization, early-return
+---
+
+## Early Return from Functions
+
+Return early when result is determined to skip unnecessary processing.
+
+**Incorrect (processes all items even after finding answer):**
+
+```typescript
+function validateUsers(users: User[]) {
+  let hasError = false
+  let errorMessage = ''
+  
+  for (const user of users) {
+    if (!user.email) {
+      hasError = true
+      errorMessage = 'Email required'
+    }
+    if (!user.name) {
+      hasError = true
+      errorMessage = 'Name required'
+    }
+    // Continues checking all users even after error found
+  }
+  
+  return hasError ? { valid: false, error: errorMessage } : { valid: true }
+}
+```
+
+**Correct (returns immediately on first error):**
+
+```typescript
+function validateUsers(users: User[]) {
+  for (const user of users) {
+    if (!user.email) {
+      return { valid: false, error: 'Email required' }
+    }
+    if (!user.name) {
+      return { valid: false, error: 'Name required' }
+    }
+  }
+
+  return { valid: true }
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/js-hoist-regexp.md b/.claude/skills/react-best-practices/rules/js-hoist-regexp.md
new file mode 100644
index 0000000..dae3fef
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-hoist-regexp.md
@@ -0,0 +1,45 @@
+---
+title: Hoist RegExp Creation
+impact: LOW-MEDIUM
+impactDescription: avoids recreation
+tags: javascript, regexp, optimization, memoization
+---
+
+## Hoist RegExp Creation
+
+Don't create RegExp inside render. Hoist to module scope or memoize with `useMemo()`.
+
+**Incorrect (new RegExp every render):**
+
+```tsx
+function Highlighter({ text, query }: Props) {
+  const regex = new RegExp(`(${query})`, 'gi')
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Correct (memoize or hoist):**
+
+```tsx
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+
+function Highlighter({ text, query }: Props) {
+  const regex = useMemo(
+    () => new RegExp(`(${escapeRegex(query)})`, 'gi'),
+    [query]
+  )
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Warning (global regex has mutable state):**
+
+Global regex (`/g`) has mutable `lastIndex` state:
+
+```typescript
+const regex = /foo/g
+regex.test('foo')  // true, lastIndex = 3
+regex.test('foo')  // false, lastIndex = 0
+```
diff --git a/.claude/skills/react-best-practices/rules/js-index-maps.md b/.claude/skills/react-best-practices/rules/js-index-maps.md
new file mode 100644
index 0000000..9d357a0
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-index-maps.md
@@ -0,0 +1,37 @@
+---
+title: Build Index Maps for Repeated Lookups
+impact: LOW-MEDIUM
+impactDescription: 1M ops to 2K ops
+tags: javascript, map, indexing, optimization, performance
+---
+
+## Build Index Maps for Repeated Lookups
+
+Multiple `.find()` calls by the same key should use a Map.
+
+**Incorrect (O(n) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  return orders.map(order => ({
+    ...order,
+    user: users.find(u => u.id === order.userId)
+  }))
+}
+```
+
+**Correct (O(1) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  const userById = new Map(users.map(u => [u.id, u]))
+
+  return orders.map(order => ({
+    ...order,
+    user: userById.get(order.userId)
+  }))
+}
+```
+
+Build map once (O(n)), then all lookups are O(1).
+For 1000 orders × 1000 users: 1M ops → 2K ops.
diff --git a/.claude/skills/react-best-practices/rules/js-length-check-first.md b/.claude/skills/react-best-practices/rules/js-length-check-first.md
new file mode 100644
index 0000000..8b89573
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-length-check-first.md
@@ -0,0 +1,49 @@
+---
+title: Early Length Check for Array Comparisons
+impact: MEDIUM-HIGH
+impactDescription: avoids expensive operations when lengths differ
+tags: javascript, arrays, performance, optimization, comparison
+---
+
+## Early Length Check for Array Comparisons
+
+When comparing arrays with expensive operations (sorting, deep equality, serialization), check lengths first. If lengths differ, the arrays cannot be equal.
+
+In real-world applications, this optimization is especially valuable when the comparison runs in hot paths (event handlers, render loops).
+
+**Incorrect (always runs expensive comparison):**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Always sorts and joins, even when lengths differ
+  return current.sort().join() !== original.sort().join()
+}
+```
+
+Two O(n log n) sorts run even when `current.length` is 5 and `original.length` is 100. There is also overhead of joining the arrays and comparing the strings.
+
+**Correct (O(1) length check first):**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Early return if lengths differ
+  if (current.length !== original.length) {
+    return true
+  }
+  // Only sort when lengths match
+  const currentSorted = current.toSorted()
+  const originalSorted = original.toSorted()
+  for (let i = 0; i < currentSorted.length; i++) {
+    if (currentSorted[i] !== originalSorted[i]) {
+      return true
+    }
+  }
+  return false
+}
+```
+
+This new approach is more efficient because:
+- It avoids the overhead of sorting and joining the arrays when lengths differ
+- It avoids consuming memory for the joined strings (especially important for large arrays)
+- It avoids mutating the original arrays
+- It returns early when a difference is found
diff --git a/.claude/skills/react-best-practices/rules/js-min-max-loop.md b/.claude/skills/react-best-practices/rules/js-min-max-loop.md
new file mode 100644
index 0000000..4b6656e
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-min-max-loop.md
@@ -0,0 +1,82 @@
+---
+title: Use Loop for Min/Max Instead of Sort
+impact: LOW
+impactDescription: O(n) instead of O(n log n)
+tags: javascript, arrays, performance, sorting, algorithms
+---
+
+## Use Loop for Min/Max Instead of Sort
+
+Finding the smallest or largest element only requires a single pass through the array. Sorting is wasteful and slower.
+
+**Incorrect (O(n log n) - sort to find latest):**
+
+```typescript
+interface Project {
+  id: string
+  name: string
+  updatedAt: number
+}
+
+function getLatestProject(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => b.updatedAt - a.updatedAt)
+  return sorted[0]
+}
+```
+
+Sorts the entire array just to find the maximum value.
+
+**Incorrect (O(n log n) - sort for oldest and newest):**
+
+```typescript
+function getOldestAndNewest(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => a.updatedAt - b.updatedAt)
+  return { oldest: sorted[0], newest: sorted[sorted.length - 1] }
+}
+```
+
+Still sorts unnecessarily when only min/max are needed.
+
+**Correct (O(n) - single loop):**
+
+```typescript
+function getLatestProject(projects: Project[]) {
+  if (projects.length === 0) return null
+  
+  let latest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt > latest.updatedAt) {
+      latest = projects[i]
+    }
+  }
+  
+  return latest
+}
+
+function getOldestAndNewest(projects: Project[]) {
+  if (projects.length === 0) return { oldest: null, newest: null }
+  
+  let oldest = projects[0]
+  let newest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt < oldest.updatedAt) oldest = projects[i]
+    if (projects[i].updatedAt > newest.updatedAt) newest = projects[i]
+  }
+  
+  return { oldest, newest }
+}
+```
+
+Single pass through the array, no copying, no sorting.
+
+**Alternative (Math.min/Math.max for small arrays):**
+
+```typescript
+const numbers = [5, 2, 8, 1, 9]
+const min = Math.min(...numbers)
+const max = Math.max(...numbers)
+```
+
+This works for small arrays, but can be slower or just throw an error for very large arrays due to spread operator limitations. Maximal array length is approximately 124000 in Chrome 143 and 638000 in Safari 18; exact numbers may vary - see [the fiddle](https://jsfiddle.net/qw1jabsx/4/). Use the loop approach for reliability.
diff --git a/.claude/skills/react-best-practices/rules/js-set-map-lookups.md b/.claude/skills/react-best-practices/rules/js-set-map-lookups.md
new file mode 100644
index 0000000..680a489
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-set-map-lookups.md
@@ -0,0 +1,24 @@
+---
+title: Use Set/Map for O(1) Lookups
+impact: LOW-MEDIUM
+impactDescription: O(n) to O(1)
+tags: javascript, set, map, data-structures, performance
+---
+
+## Use Set/Map for O(1) Lookups
+
+Convert arrays to Set/Map for repeated membership checks.
+
+**Incorrect (O(n) per check):**
+
+```typescript
+const allowedIds = ['a', 'b', 'c', ...]
+items.filter(item => allowedIds.includes(item.id))
+```
+
+**Correct (O(1) per check):**
+
+```typescript
+const allowedIds = new Set(['a', 'b', 'c', ...])
+items.filter(item => allowedIds.has(item.id))
+```
diff --git a/.claude/skills/react-best-practices/rules/js-tosorted-immutable.md b/.claude/skills/react-best-practices/rules/js-tosorted-immutable.md
new file mode 100644
index 0000000..eae8b3f
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/js-tosorted-immutable.md
@@ -0,0 +1,57 @@
+---
+title: Use toSorted() Instead of sort() for Immutability
+impact: MEDIUM-HIGH
+impactDescription: prevents mutation bugs in React state
+tags: javascript, arrays, immutability, react, state, mutation
+---
+
+## Use toSorted() Instead of sort() for Immutability
+
+`.sort()` mutates the array in place, which can cause bugs with React state and props. Use `.toSorted()` to create a new sorted array without mutation.
+
+**Incorrect (mutates original array):**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Mutates the users prop array!
+  const sorted = useMemo(
+    () => users.sort((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Correct (creates new array):**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Creates new sorted array, original unchanged
+  const sorted = useMemo(
+    () => users.toSorted((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Why this matters in React:**
+
+1. Props/state mutations break React's immutability model - React expects props and state to be treated as read-only
+2. Causes stale closure bugs - Mutating arrays inside closures (callbacks, effects) can lead to unexpected behavior
+
+**Browser support (fallback for older browsers):**
+
+`.toSorted()` is available in all modern browsers (Chrome 110+, Safari 16+, Firefox 115+, Node.js 20+). For older environments, use spread operator:
+
+```typescript
+// Fallback for older browsers
+const sorted = [...items].sort((a, b) => a.value - b.value)
+```
+
+**Other immutable array methods:**
+
+- `.toSorted()` - immutable sort
+- `.toReversed()` - immutable reverse
+- `.toSpliced()` - immutable splice
+- `.with()` - immutable element replacement
diff --git a/.claude/skills/react-best-practices/rules/rendering-activity.md b/.claude/skills/react-best-practices/rules/rendering-activity.md
new file mode 100644
index 0000000..c957a49
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-activity.md
@@ -0,0 +1,26 @@
+---
+title: Use Activity Component for Show/Hide
+impact: MEDIUM
+impactDescription: preserves state/DOM
+tags: rendering, activity, visibility, state-preservation
+---
+
+## Use Activity Component for Show/Hide
+
+Use React's `<Activity>` to preserve state/DOM for expensive components that frequently toggle visibility.
+
+**Usage:**
+
+```tsx
+import { Activity } from 'react'
+
+function Dropdown({ isOpen }: Props) {
+  return (
+    <Activity mode={isOpen ? 'visible' : 'hidden'}>
+      <ExpensiveMenu />
+    </Activity>
+  )
+}
+```
+
+Avoids expensive re-renders and state loss.
diff --git a/.claude/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md b/.claude/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md
new file mode 100644
index 0000000..646744c
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md
@@ -0,0 +1,47 @@
+---
+title: Animate SVG Wrapper Instead of SVG Element
+impact: LOW
+impactDescription: enables hardware acceleration
+tags: rendering, svg, css, animation, performance
+---
+
+## Animate SVG Wrapper Instead of SVG Element
+
+Many browsers don't have hardware acceleration for CSS3 animations on SVG elements. Wrap SVG in a `<div>` and animate the wrapper instead.
+
+**Incorrect (animating SVG directly - no hardware acceleration):**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <svg 
+      className="animate-spin"
+      width="24" 
+      height="24" 
+      viewBox="0 0 24 24"
+    >
+      <circle cx="12" cy="12" r="10" stroke="currentColor" />
+    </svg>
+  )
+}
+```
+
+**Correct (animating wrapper div - hardware accelerated):**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <div className="animate-spin">
+      <svg 
+        width="24" 
+        height="24" 
+        viewBox="0 0 24 24"
+      >
+        <circle cx="12" cy="12" r="10" stroke="currentColor" />
+      </svg>
+    </div>
+  )
+}
+```
+
+This applies to all CSS transforms and transitions (`transform`, `opacity`, `translate`, `scale`, `rotate`). The wrapper div allows browsers to use GPU acceleration for smoother animations.
diff --git a/.claude/skills/react-best-practices/rules/rendering-conditional-render.md b/.claude/skills/react-best-practices/rules/rendering-conditional-render.md
new file mode 100644
index 0000000..7e866f5
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-conditional-render.md
@@ -0,0 +1,40 @@
+---
+title: Use Explicit Conditional Rendering
+impact: LOW
+impactDescription: prevents rendering 0 or NaN
+tags: rendering, conditional, jsx, falsy-values
+---
+
+## Use Explicit Conditional Rendering
+
+Use explicit ternary operators (`? :`) instead of `&&` for conditional rendering when the condition can be `0`, `NaN`, or other falsy values that render.
+
+**Incorrect (renders "0" when count is 0):**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count && <span className="badge">{count}</span>}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div>0</div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
+
+**Correct (renders nothing when count is 0):**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count > 0 ? <span className="badge">{count}</span> : null}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div></div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
diff --git a/.claude/skills/react-best-practices/rules/rendering-content-visibility.md b/.claude/skills/react-best-practices/rules/rendering-content-visibility.md
new file mode 100644
index 0000000..aa66563
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-content-visibility.md
@@ -0,0 +1,38 @@
+---
+title: CSS content-visibility for Long Lists
+impact: HIGH
+impactDescription: faster initial render
+tags: rendering, css, content-visibility, long-lists
+---
+
+## CSS content-visibility for Long Lists
+
+Apply `content-visibility: auto` to defer off-screen rendering.
+
+**CSS:**
+
+```css
+.message-item {
+  content-visibility: auto;
+  contain-intrinsic-size: 0 80px;
+}
+```
+
+**Example:**
+
+```tsx
+function MessageList({ messages }: { messages: Message[] }) {
+  return (
+    <div className="overflow-y-auto h-screen">
+      {messages.map(msg => (
+        <div key={msg.id} className="message-item">
+          <Avatar user={msg.author} />
+          <div>{msg.content}</div>
+        </div>
+      ))}
+    </div>
+  )
+}
+```
+
+For 1000 messages, browser skips layout/paint for ~990 off-screen items (10× faster initial render).
diff --git a/.claude/skills/react-best-practices/rules/rendering-hoist-jsx.md b/.claude/skills/react-best-practices/rules/rendering-hoist-jsx.md
new file mode 100644
index 0000000..32d2f3f
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-hoist-jsx.md
@@ -0,0 +1,46 @@
+---
+title: Hoist Static JSX Elements
+impact: LOW
+impactDescription: avoids re-creation
+tags: rendering, jsx, static, optimization
+---
+
+## Hoist Static JSX Elements
+
+Extract static JSX outside components to avoid re-creation.
+
+**Incorrect (recreates element every render):**
+
+```tsx
+function LoadingSkeleton() {
+  return <div className="animate-pulse h-20 bg-gray-200" />
+}
+
+function Container() {
+  return (
+    <div>
+      {loading && <LoadingSkeleton />}
+    </div>
+  )
+}
+```
+
+**Correct (reuses same element):**
+
+```tsx
+const loadingSkeleton = (
+  <div className="animate-pulse h-20 bg-gray-200" />
+)
+
+function Container() {
+  return (
+    <div>
+      {loading && loadingSkeleton}
+    </div>
+  )
+}
+```
+
+This is especially helpful for large and static SVG nodes, which can be expensive to recreate on every render.
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler automatically hoists static JSX elements and optimizes component re-renders, making manual hoisting unnecessary.
diff --git a/.claude/skills/react-best-practices/rules/rendering-hydration-no-flicker.md b/.claude/skills/react-best-practices/rules/rendering-hydration-no-flicker.md
new file mode 100644
index 0000000..5cf0e79
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-hydration-no-flicker.md
@@ -0,0 +1,82 @@
+---
+title: Prevent Hydration Mismatch Without Flickering
+impact: MEDIUM
+impactDescription: avoids visual flicker and hydration errors
+tags: rendering, ssr, hydration, localStorage, flicker
+---
+
+## Prevent Hydration Mismatch Without Flickering
+
+When rendering content that depends on client-side storage (localStorage, cookies), avoid both SSR breakage and post-hydration flickering by injecting a synchronous script that updates the DOM before React hydrates.
+
+**Incorrect (breaks SSR):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  // localStorage is not available on server - throws error
+  const theme = localStorage.getItem('theme') || 'light'
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Server-side rendering will fail because `localStorage` is undefined.
+
+**Incorrect (visual flickering):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  const [theme, setTheme] = useState('light')
+  
+  useEffect(() => {
+    // Runs after hydration - causes visible flash
+    const stored = localStorage.getItem('theme')
+    if (stored) {
+      setTheme(stored)
+    }
+  }, [])
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Component first renders with default value (`light`), then updates after hydration, causing a visible flash of incorrect content.
+
+**Correct (no flicker, no hydration mismatch):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  return (
+    <>
+      <div id="theme-wrapper">
+        {children}
+      </div>
+      <script
+        dangerouslySetInnerHTML={{
+          __html: `
+            (function() {
+              try {
+                var theme = localStorage.getItem('theme') || 'light';
+                var el = document.getElementById('theme-wrapper');
+                if (el) el.className = theme;
+              } catch (e) {}
+            })();
+          `,
+        }}
+      />
+    </>
+  )
+}
+```
+
+The inline script executes synchronously before showing the element, ensuring the DOM already has the correct value. No flickering, no hydration mismatch.
+
+This pattern is especially useful for theme toggles, user preferences, authentication states, and any client-only data that should render immediately without flashing default values.
diff --git a/.claude/skills/react-best-practices/rules/rendering-hydration-suppress-warning.md b/.claude/skills/react-best-practices/rules/rendering-hydration-suppress-warning.md
new file mode 100644
index 0000000..24ba251
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-hydration-suppress-warning.md
@@ -0,0 +1,30 @@
+---
+title: Suppress Expected Hydration Mismatches
+impact: LOW-MEDIUM
+impactDescription: avoids noisy hydration warnings for known differences
+tags: rendering, hydration, ssr, nextjs
+---
+
+## Suppress Expected Hydration Mismatches
+
+In SSR frameworks (e.g., Next.js), some values are intentionally different on server vs client (random IDs, dates, locale/timezone formatting). For these *expected* mismatches, wrap the dynamic text in an element with `suppressHydrationWarning` to prevent noisy warnings. Do not use this to hide real bugs. Don’t overuse it.
+
+**Incorrect (known mismatch warnings):**
+
+```tsx
+function Timestamp() {
+  return <span>{new Date().toLocaleString()}</span>
+}
+```
+
+**Correct (suppress expected mismatch only):**
+
+```tsx
+function Timestamp() {
+  return (
+    <span suppressHydrationWarning>
+      {new Date().toLocaleString()}
+    </span>
+  )
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/rendering-svg-precision.md b/.claude/skills/react-best-practices/rules/rendering-svg-precision.md
new file mode 100644
index 0000000..6d77128
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-svg-precision.md
@@ -0,0 +1,28 @@
+---
+title: Optimize SVG Precision
+impact: LOW
+impactDescription: reduces file size
+tags: rendering, svg, optimization, svgo
+---
+
+## Optimize SVG Precision
+
+Reduce SVG coordinate precision to decrease file size. The optimal precision depends on the viewBox size, but in general reducing precision should be considered.
+
+**Incorrect (excessive precision):**
+
+```svg
+<path d="M 10.293847 20.847362 L 30.938472 40.192837" />
+```
+
+**Correct (1 decimal place):**
+
+```svg
+<path d="M 10.3 20.8 L 30.9 40.2" />
+```
+
+**Automate with SVGO:**
+
+```bash
+npx svgo --precision=1 --multipass icon.svg
+```
diff --git a/.claude/skills/react-best-practices/rules/rendering-usetransition-loading.md b/.claude/skills/react-best-practices/rules/rendering-usetransition-loading.md
new file mode 100644
index 0000000..0c1b0b9
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rendering-usetransition-loading.md
@@ -0,0 +1,75 @@
+---
+title: Use useTransition Over Manual Loading States
+impact: LOW
+impactDescription: reduces re-renders and improves code clarity
+tags: rendering, transitions, useTransition, loading, state
+---
+
+## Use useTransition Over Manual Loading States
+
+Use `useTransition` instead of manual `useState` for loading states. This provides built-in `isPending` state and automatically manages transitions.
+
+**Incorrect (manual loading state):**
+
+```tsx
+function SearchResults() {
+  const [query, setQuery] = useState('')
+  const [results, setResults] = useState([])
+  const [isLoading, setIsLoading] = useState(false)
+
+  const handleSearch = async (value: string) => {
+    setIsLoading(true)
+    setQuery(value)
+    const data = await fetchResults(value)
+    setResults(data)
+    setIsLoading(false)
+  }
+
+  return (
+    <>
+      <input onChange={(e) => handleSearch(e.target.value)} />
+      {isLoading && <Spinner />}
+      <ResultsList results={results} />
+    </>
+  )
+}
+```
+
+**Correct (useTransition with built-in pending state):**
+
+```tsx
+import { useTransition, useState } from 'react'
+
+function SearchResults() {
+  const [query, setQuery] = useState('')
+  const [results, setResults] = useState([])
+  const [isPending, startTransition] = useTransition()
+
+  const handleSearch = (value: string) => {
+    setQuery(value) // Update input immediately
+    
+    startTransition(async () => {
+      // Fetch and update results
+      const data = await fetchResults(value)
+      setResults(data)
+    })
+  }
+
+  return (
+    <>
+      <input onChange={(e) => handleSearch(e.target.value)} />
+      {isPending && <Spinner />}
+      <ResultsList results={results} />
+    </>
+  )
+}
+```
+
+**Benefits:**
+
+- **Automatic pending state**: No need to manually manage `setIsLoading(true/false)`
+- **Error resilience**: Pending state correctly resets even if the transition throws
+- **Better responsiveness**: Keeps the UI responsive during updates
+- **Interrupt handling**: New transitions automatically cancel pending ones
+
+Reference: [useTransition](https://react.dev/reference/react/useTransition)
diff --git a/.claude/skills/react-best-practices/rules/rerender-defer-reads.md b/.claude/skills/react-best-practices/rules/rerender-defer-reads.md
new file mode 100644
index 0000000..e867c95
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-defer-reads.md
@@ -0,0 +1,39 @@
+---
+title: Defer State Reads to Usage Point
+impact: MEDIUM
+impactDescription: avoids unnecessary subscriptions
+tags: rerender, searchParams, localStorage, optimization
+---
+
+## Defer State Reads to Usage Point
+
+Don't subscribe to dynamic state (searchParams, localStorage) if you only read it inside callbacks.
+
+**Incorrect (subscribes to all searchParams changes):**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const searchParams = useSearchParams()
+
+  const handleShare = () => {
+    const ref = searchParams.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
+
+**Correct (reads on demand, no subscription):**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const handleShare = () => {
+    const params = new URLSearchParams(window.location.search)
+    const ref = params.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/rerender-dependencies.md b/.claude/skills/react-best-practices/rules/rerender-dependencies.md
new file mode 100644
index 0000000..47a4d92
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-dependencies.md
@@ -0,0 +1,45 @@
+---
+title: Narrow Effect Dependencies
+impact: LOW
+impactDescription: minimizes effect re-runs
+tags: rerender, useEffect, dependencies, optimization
+---
+
+## Narrow Effect Dependencies
+
+Specify primitive dependencies instead of objects to minimize effect re-runs.
+
+**Incorrect (re-runs on any user field change):**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user])
+```
+
+**Correct (re-runs only when id changes):**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user.id])
+```
+
+**For derived state, compute outside effect:**
+
+```tsx
+// Incorrect: runs on width=767, 766, 765...
+useEffect(() => {
+  if (width < 768) {
+    enableMobileMode()
+  }
+}, [width])
+
+// Correct: runs only on boolean transition
+const isMobile = width < 768
+useEffect(() => {
+  if (isMobile) {
+    enableMobileMode()
+  }
+}, [isMobile])
+```
diff --git a/.claude/skills/react-best-practices/rules/rerender-derived-state-no-effect.md b/.claude/skills/react-best-practices/rules/rerender-derived-state-no-effect.md
new file mode 100644
index 0000000..3d9fe40
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-derived-state-no-effect.md
@@ -0,0 +1,40 @@
+---
+title: Calculate Derived State During Rendering
+impact: MEDIUM
+impactDescription: avoids redundant renders and state drift
+tags: rerender, derived-state, useEffect, state
+---
+
+## Calculate Derived State During Rendering
+
+If a value can be computed from current props/state, do not store it in state or update it in an effect. Derive it during render to avoid extra renders and state drift. Do not set state in effects solely in response to prop changes; prefer derived values or keyed resets instead.
+
+**Incorrect (redundant state and effect):**
+
+```tsx
+function Form() {
+  const [firstName, setFirstName] = useState('First')
+  const [lastName, setLastName] = useState('Last')
+  const [fullName, setFullName] = useState('')
+
+  useEffect(() => {
+    setFullName(firstName + ' ' + lastName)
+  }, [firstName, lastName])
+
+  return <p>{fullName}</p>
+}
+```
+
+**Correct (derive during render):**
+
+```tsx
+function Form() {
+  const [firstName, setFirstName] = useState('First')
+  const [lastName, setLastName] = useState('Last')
+  const fullName = firstName + ' ' + lastName
+
+  return <p>{fullName}</p>
+}
+```
+
+References: [You Might Not Need an Effect](https://react.dev/learn/you-might-not-need-an-effect)
diff --git a/.claude/skills/react-best-practices/rules/rerender-derived-state.md b/.claude/skills/react-best-practices/rules/rerender-derived-state.md
new file mode 100644
index 0000000..e5c899f
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-derived-state.md
@@ -0,0 +1,29 @@
+---
+title: Subscribe to Derived State
+impact: MEDIUM
+impactDescription: reduces re-render frequency
+tags: rerender, derived-state, media-query, optimization
+---
+
+## Subscribe to Derived State
+
+Subscribe to derived boolean state instead of continuous values to reduce re-render frequency.
+
+**Incorrect (re-renders on every pixel change):**
+
+```tsx
+function Sidebar() {
+  const width = useWindowWidth()  // updates continuously
+  const isMobile = width < 768
+  return <nav className={isMobile ? 'mobile' : 'desktop'} />
+}
+```
+
+**Correct (re-renders only when boolean changes):**
+
+```tsx
+function Sidebar() {
+  const isMobile = useMediaQuery('(max-width: 767px)')
+  return <nav className={isMobile ? 'mobile' : 'desktop'} />
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/rerender-functional-setstate.md b/.claude/skills/react-best-practices/rules/rerender-functional-setstate.md
new file mode 100644
index 0000000..b004ef4
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-functional-setstate.md
@@ -0,0 +1,74 @@
+---
+title: Use Functional setState Updates
+impact: MEDIUM
+impactDescription: prevents stale closures and unnecessary callback recreations
+tags: react, hooks, useState, useCallback, callbacks, closures
+---
+
+## Use Functional setState Updates
+
+When updating state based on the current state value, use the functional update form of setState instead of directly referencing the state variable. This prevents stale closures, eliminates unnecessary dependencies, and creates stable callback references.
+
+**Incorrect (requires state as dependency):**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Callback must depend on items, recreated on every items change
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems([...items, ...newItems])
+  }, [items])  // ❌ items dependency causes recreations
+  
+  // Risk of stale closure if dependency is forgotten
+  const removeItem = useCallback((id: string) => {
+    setItems(items.filter(item => item.id !== id))
+  }, [])  // ❌ Missing items dependency - will use stale items!
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+The first callback is recreated every time `items` changes, which can cause child components to re-render unnecessarily. The second callback has a stale closure bug—it will always reference the initial `items` value.
+
+**Correct (stable callbacks, no stale closures):**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Stable callback, never recreated
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems(curr => [...curr, ...newItems])
+  }, [])  // ✅ No dependencies needed
+  
+  // Always uses latest state, no stale closure risk
+  const removeItem = useCallback((id: string) => {
+    setItems(curr => curr.filter(item => item.id !== id))
+  }, [])  // ✅ Safe and stable
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+**Benefits:**
+
+1. **Stable callback references** - Callbacks don't need to be recreated when state changes
+2. **No stale closures** - Always operates on the latest state value
+3. **Fewer dependencies** - Simplifies dependency arrays and reduces memory leaks
+4. **Prevents bugs** - Eliminates the most common source of React closure bugs
+
+**When to use functional updates:**
+
+- Any setState that depends on the current state value
+- Inside useCallback/useMemo when state is needed
+- Event handlers that reference state
+- Async operations that update state
+
+**When direct updates are fine:**
+
+- Setting state to a static value: `setCount(0)`
+- Setting state from props/arguments only: `setName(newName)`
+- State doesn't depend on previous value
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler can automatically optimize some cases, but functional updates are still recommended for correctness and to prevent stale closure bugs.
diff --git a/.claude/skills/react-best-practices/rules/rerender-lazy-state-init.md b/.claude/skills/react-best-practices/rules/rerender-lazy-state-init.md
new file mode 100644
index 0000000..4ecb350
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-lazy-state-init.md
@@ -0,0 +1,58 @@
+---
+title: Use Lazy State Initialization
+impact: MEDIUM
+impactDescription: wasted computation on every render
+tags: react, hooks, useState, performance, initialization
+---
+
+## Use Lazy State Initialization
+
+Pass a function to `useState` for expensive initial values. Without the function form, the initializer runs on every render even though the value is only used once.
+
+**Incorrect (runs on every render):**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs on EVERY render, even after initialization
+  const [searchIndex, setSearchIndex] = useState(buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  // When query changes, buildSearchIndex runs again unnecessarily
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs on every render
+  const [settings, setSettings] = useState(
+    JSON.parse(localStorage.getItem('settings') || '{}')
+  )
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+**Correct (runs only once):**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs ONLY on initial render
+  const [searchIndex, setSearchIndex] = useState(() => buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs only on initial render
+  const [settings, setSettings] = useState(() => {
+    const stored = localStorage.getItem('settings')
+    return stored ? JSON.parse(stored) : {}
+  })
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+Use lazy initialization when computing initial values from localStorage/sessionStorage, building data structures (indexes, maps), reading from the DOM, or performing heavy transformations.
+
+For simple primitives (`useState(0)`), direct references (`useState(props.value)`), or cheap literals (`useState({})`), the function form is unnecessary.
diff --git a/.claude/skills/react-best-practices/rules/rerender-memo-with-default-value.md b/.claude/skills/react-best-practices/rules/rerender-memo-with-default-value.md
new file mode 100644
index 0000000..6357049
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-memo-with-default-value.md
@@ -0,0 +1,38 @@
+---
+
+title: Extract Default Non-primitive Parameter Value from Memoized Component to Constant
+impact: MEDIUM
+impactDescription: restores memoization by using a constant for default value
+tags: rerender, memo, optimization
+
+---
+
+## Extract Default Non-primitive Parameter Value from Memoized Component to Constant
+
+When memoized component has a default value for some non-primitive optional parameter, such as an array, function, or object, calling the component without that parameter results in broken memoization. This is because new value instances are created on every rerender, and they do not pass strict equality comparison in `memo()`.
+
+To address this issue, extract the default value into a constant.
+
+**Incorrect (`onClick` has different values on every rerender):**
+
+```tsx
+const UserAvatar = memo(function UserAvatar({ onClick = () => {} }: { onClick?: () => void }) {
+  // ...
+})
+
+// Used without optional onClick
+<UserAvatar />
+```
+
+**Correct (stable default value):**
+
+```tsx
+const NOOP = () => {};
+
+const UserAvatar = memo(function UserAvatar({ onClick = NOOP }: { onClick?: () => void }) {
+  // ...
+})
+
+// Used without optional onClick
+<UserAvatar />
+```
diff --git a/.claude/skills/react-best-practices/rules/rerender-memo.md b/.claude/skills/react-best-practices/rules/rerender-memo.md
new file mode 100644
index 0000000..f8982ab
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-memo.md
@@ -0,0 +1,44 @@
+---
+title: Extract to Memoized Components
+impact: MEDIUM
+impactDescription: enables early returns
+tags: rerender, memo, useMemo, optimization
+---
+
+## Extract to Memoized Components
+
+Extract expensive work into memoized components to enable early returns before computation.
+
+**Incorrect (computes avatar even when loading):**
+
+```tsx
+function Profile({ user, loading }: Props) {
+  const avatar = useMemo(() => {
+    const id = computeAvatarId(user)
+    return <Avatar id={id} />
+  }, [user])
+
+  if (loading) return <Skeleton />
+  return <div>{avatar}</div>
+}
+```
+
+**Correct (skips computation when loading):**
+
+```tsx
+const UserAvatar = memo(function UserAvatar({ user }: { user: User }) {
+  const id = useMemo(() => computeAvatarId(user), [user])
+  return <Avatar id={id} />
+})
+
+function Profile({ user, loading }: Props) {
+  if (loading) return <Skeleton />
+  return (
+    <div>
+      <UserAvatar user={user} />
+    </div>
+  )
+}
+```
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, manual memoization with `memo()` and `useMemo()` is not necessary. The compiler automatically optimizes re-renders.
diff --git a/.claude/skills/react-best-practices/rules/rerender-move-effect-to-event.md b/.claude/skills/react-best-practices/rules/rerender-move-effect-to-event.md
new file mode 100644
index 0000000..dd58a1a
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-move-effect-to-event.md
@@ -0,0 +1,45 @@
+---
+title: Put Interaction Logic in Event Handlers
+impact: MEDIUM
+impactDescription: avoids effect re-runs and duplicate side effects
+tags: rerender, useEffect, events, side-effects, dependencies
+---
+
+## Put Interaction Logic in Event Handlers
+
+If a side effect is triggered by a specific user action (submit, click, drag), run it in that event handler. Do not model the action as state + effect; it makes effects re-run on unrelated changes and can duplicate the action.
+
+**Incorrect (event modeled as state + effect):**
+
+```tsx
+function Form() {
+  const [submitted, setSubmitted] = useState(false)
+  const theme = useContext(ThemeContext)
+
+  useEffect(() => {
+    if (submitted) {
+      post('/api/register')
+      showToast('Registered', theme)
+    }
+  }, [submitted, theme])
+
+  return <button onClick={() => setSubmitted(true)}>Submit</button>
+}
+```
+
+**Correct (do it in the handler):**
+
+```tsx
+function Form() {
+  const theme = useContext(ThemeContext)
+
+  function handleSubmit() {
+    post('/api/register')
+    showToast('Registered', theme)
+  }
+
+  return <button onClick={handleSubmit}>Submit</button>
+}
+```
+
+Reference: [Should this code move to an event handler?](https://react.dev/learn/removing-effect-dependencies#should-this-code-move-to-an-event-handler)
diff --git a/.claude/skills/react-best-practices/rules/rerender-simple-expression-in-memo.md b/.claude/skills/react-best-practices/rules/rerender-simple-expression-in-memo.md
new file mode 100644
index 0000000..59dfab0
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-simple-expression-in-memo.md
@@ -0,0 +1,35 @@
+---
+title: Do not wrap a simple expression with a primitive result type in useMemo
+impact: LOW-MEDIUM
+impactDescription: wasted computation on every render
+tags: rerender, useMemo, optimization
+---
+
+## Do not wrap a simple expression with a primitive result type in useMemo
+
+When an expression is simple (few logical or arithmetical operators) and has a primitive result type (boolean, number, string), do not wrap it in `useMemo`.
+Calling `useMemo` and comparing hook dependencies may consume more resources than the expression itself.
+
+**Incorrect:**
+
+```tsx
+function Header({ user, notifications }: Props) {
+  const isLoading = useMemo(() => {
+    return user.isLoading || notifications.isLoading
+  }, [user.isLoading, notifications.isLoading])
+
+  if (isLoading) return <Skeleton />
+  // return some markup
+}
+```
+
+**Correct:**
+
+```tsx
+function Header({ user, notifications }: Props) {
+  const isLoading = user.isLoading || notifications.isLoading
+
+  if (isLoading) return <Skeleton />
+  // return some markup
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/rerender-transitions.md b/.claude/skills/react-best-practices/rules/rerender-transitions.md
new file mode 100644
index 0000000..d99f43f
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-transitions.md
@@ -0,0 +1,40 @@
+---
+title: Use Transitions for Non-Urgent Updates
+impact: MEDIUM
+impactDescription: maintains UI responsiveness
+tags: rerender, transitions, startTransition, performance
+---
+
+## Use Transitions for Non-Urgent Updates
+
+Mark frequent, non-urgent state updates as transitions to maintain UI responsiveness.
+
+**Incorrect (blocks UI on every scroll):**
+
+```tsx
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => setScrollY(window.scrollY)
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
+
+**Correct (non-blocking updates):**
+
+```tsx
+import { startTransition } from 'react'
+
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => {
+      startTransition(() => setScrollY(window.scrollY))
+    }
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/rerender-use-ref-transient-values.md b/.claude/skills/react-best-practices/rules/rerender-use-ref-transient-values.md
new file mode 100644
index 0000000..cf04b81
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/rerender-use-ref-transient-values.md
@@ -0,0 +1,73 @@
+---
+title: Use useRef for Transient Values
+impact: MEDIUM
+impactDescription: avoids unnecessary re-renders on frequent updates
+tags: rerender, useref, state, performance
+---
+
+## Use useRef for Transient Values
+
+When a value changes frequently and you don't want a re-render on every update (e.g., mouse trackers, intervals, transient flags), store it in `useRef` instead of `useState`. Keep component state for UI; use refs for temporary DOM-adjacent values. Updating a ref does not trigger a re-render.
+
+**Incorrect (renders every update):**
+
+```tsx
+function Tracker() {
+  const [lastX, setLastX] = useState(0)
+
+  useEffect(() => {
+    const onMove = (e: MouseEvent) => setLastX(e.clientX)
+    window.addEventListener('mousemove', onMove)
+    return () => window.removeEventListener('mousemove', onMove)
+  }, [])
+
+  return (
+    <div
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: lastX,
+        width: 8,
+        height: 8,
+        background: 'black',
+      }}
+    />
+  )
+}
+```
+
+**Correct (no re-render for tracking):**
+
+```tsx
+function Tracker() {
+  const lastXRef = useRef(0)
+  const dotRef = useRef<HTMLDivElement>(null)
+
+  useEffect(() => {
+    const onMove = (e: MouseEvent) => {
+      lastXRef.current = e.clientX
+      const node = dotRef.current
+      if (node) {
+        node.style.transform = `translateX(${e.clientX}px)`
+      }
+    }
+    window.addEventListener('mousemove', onMove)
+    return () => window.removeEventListener('mousemove', onMove)
+  }, [])
+
+  return (
+    <div
+      ref={dotRef}
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        width: 8,
+        height: 8,
+        background: 'black',
+        transform: 'translateX(0px)',
+      }}
+    />
+  )
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/server-after-nonblocking.md b/.claude/skills/react-best-practices/rules/server-after-nonblocking.md
new file mode 100644
index 0000000..e8f5b26
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/server-after-nonblocking.md
@@ -0,0 +1,73 @@
+---
+title: Use after() for Non-Blocking Operations
+impact: MEDIUM
+impactDescription: faster response times
+tags: server, async, logging, analytics, side-effects
+---
+
+## Use after() for Non-Blocking Operations
+
+Use Next.js's `after()` to schedule work that should execute after a response is sent. This prevents logging, analytics, and other side effects from blocking the response.
+
+**Incorrect (blocks response):**
+
+```tsx
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Logging blocks the response
+  const userAgent = request.headers.get('user-agent') || 'unknown'
+  await logUserAction({ userAgent })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+**Correct (non-blocking):**
+
+```tsx
+import { after } from 'next/server'
+import { headers, cookies } from 'next/headers'
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Log after response is sent
+  after(async () => {
+    const userAgent = (await headers()).get('user-agent') || 'unknown'
+    const sessionCookie = (await cookies()).get('session-id')?.value || 'anonymous'
+    
+    logUserAction({ sessionCookie, userAgent })
+  })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+The response is sent immediately while logging happens in the background.
+
+**Common use cases:**
+
+- Analytics tracking
+- Audit logging
+- Sending notifications
+- Cache invalidation
+- Cleanup tasks
+
+**Important notes:**
+
+- `after()` runs even if the response fails or redirects
+- Works in Server Actions, Route Handlers, and Server Components
+
+Reference: [https://nextjs.org/docs/app/api-reference/functions/after](https://nextjs.org/docs/app/api-reference/functions/after)
diff --git a/.claude/skills/react-best-practices/rules/server-auth-actions.md b/.claude/skills/react-best-practices/rules/server-auth-actions.md
new file mode 100644
index 0000000..ee82c04
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/server-auth-actions.md
@@ -0,0 +1,96 @@
+---
+title: Authenticate Server Actions Like API Routes
+impact: CRITICAL
+impactDescription: prevents unauthorized access to server mutations
+tags: server, server-actions, authentication, security, authorization
+---
+
+## Authenticate Server Actions Like API Routes
+
+**Impact: CRITICAL (prevents unauthorized access to server mutations)**
+
+Server Actions (functions with `"use server"`) are exposed as public endpoints, just like API routes. Always verify authentication and authorization **inside** each Server Action—do not rely solely on middleware, layout guards, or page-level checks, as Server Actions can be invoked directly.
+
+Next.js documentation explicitly states: "Treat Server Actions with the same security considerations as public-facing API endpoints, and verify if the user is allowed to perform a mutation."
+
+**Incorrect (no authentication check):**
+
+```typescript
+'use server'
+
+export async function deleteUser(userId: string) {
+  // Anyone can call this! No auth check
+  await db.user.delete({ where: { id: userId } })
+  return { success: true }
+}
+```
+
+**Correct (authentication inside the action):**
+
+```typescript
+'use server'
+
+import { verifySession } from '@/lib/auth'
+import { unauthorized } from '@/lib/errors'
+
+export async function deleteUser(userId: string) {
+  // Always check auth inside the action
+  const session = await verifySession()
+  
+  if (!session) {
+    throw unauthorized('Must be logged in')
+  }
+  
+  // Check authorization too
+  if (session.user.role !== 'admin' && session.user.id !== userId) {
+    throw unauthorized('Cannot delete other users')
+  }
+  
+  await db.user.delete({ where: { id: userId } })
+  return { success: true }
+}
+```
+
+**With input validation:**
+
+```typescript
+'use server'
+
+import { verifySession } from '@/lib/auth'
+import { z } from 'zod'
+
+const updateProfileSchema = z.object({
+  userId: z.string().uuid(),
+  name: z.string().min(1).max(100),
+  email: z.string().email()
+})
+
+export async function updateProfile(data: unknown) {
+  // Validate input first
+  const validated = updateProfileSchema.parse(data)
+  
+  // Then authenticate
+  const session = await verifySession()
+  if (!session) {
+    throw new Error('Unauthorized')
+  }
+  
+  // Then authorize
+  if (session.user.id !== validated.userId) {
+    throw new Error('Can only update own profile')
+  }
+  
+  // Finally perform the mutation
+  await db.user.update({
+    where: { id: validated.userId },
+    data: {
+      name: validated.name,
+      email: validated.email
+    }
+  })
+  
+  return { success: true }
+}
+```
+
+Reference: [https://nextjs.org/docs/app/guides/authentication](https://nextjs.org/docs/app/guides/authentication)
diff --git a/.claude/skills/react-best-practices/rules/server-cache-lru.md b/.claude/skills/react-best-practices/rules/server-cache-lru.md
new file mode 100644
index 0000000..ef6938a
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/server-cache-lru.md
@@ -0,0 +1,41 @@
+---
+title: Cross-Request LRU Caching
+impact: HIGH
+impactDescription: caches across requests
+tags: server, cache, lru, cross-request
+---
+
+## Cross-Request LRU Caching
+
+`React.cache()` only works within one request. For data shared across sequential requests (user clicks button A then button B), use an LRU cache.
+
+**Implementation:**
+
+```typescript
+import { LRUCache } from 'lru-cache'
+
+const cache = new LRUCache<string, any>({
+  max: 1000,
+  ttl: 5 * 60 * 1000  // 5 minutes
+})
+
+export async function getUser(id: string) {
+  const cached = cache.get(id)
+  if (cached) return cached
+
+  const user = await db.user.findUnique({ where: { id } })
+  cache.set(id, user)
+  return user
+}
+
+// Request 1: DB query, result cached
+// Request 2: cache hit, no DB query
+```
+
+Use when sequential user actions hit multiple endpoints needing the same data within seconds.
+
+**With Vercel's [Fluid Compute](https://vercel.com/docs/fluid-compute):** LRU caching is especially effective because multiple concurrent requests can share the same function instance and cache. This means the cache persists across requests without needing external storage like Redis.
+
+**In traditional serverless:** Each invocation runs in isolation, so consider Redis for cross-process caching.
+
+Reference: [https://github.com/isaacs/node-lru-cache](https://github.com/isaacs/node-lru-cache)
diff --git a/.claude/skills/react-best-practices/rules/server-cache-react.md b/.claude/skills/react-best-practices/rules/server-cache-react.md
new file mode 100644
index 0000000..87c9ca3
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/server-cache-react.md
@@ -0,0 +1,76 @@
+---
+title: Per-Request Deduplication with React.cache()
+impact: MEDIUM
+impactDescription: deduplicates within request
+tags: server, cache, react-cache, deduplication
+---
+
+## Per-Request Deduplication with React.cache()
+
+Use `React.cache()` for server-side request deduplication. Authentication and database queries benefit most.
+
+**Usage:**
+
+```typescript
+import { cache } from 'react'
+
+export const getCurrentUser = cache(async () => {
+  const session = await auth()
+  if (!session?.user?.id) return null
+  return await db.user.findUnique({
+    where: { id: session.user.id }
+  })
+})
+```
+
+Within a single request, multiple calls to `getCurrentUser()` execute the query only once.
+
+**Avoid inline objects as arguments:**
+
+`React.cache()` uses shallow equality (`Object.is`) to determine cache hits. Inline objects create new references each call, preventing cache hits.
+
+**Incorrect (always cache miss):**
+
+```typescript
+const getUser = cache(async (params: { uid: number }) => {
+  return await db.user.findUnique({ where: { id: params.uid } })
+})
+
+// Each call creates new object, never hits cache
+getUser({ uid: 1 })
+getUser({ uid: 1 })  // Cache miss, runs query again
+```
+
+**Correct (cache hit):**
+
+```typescript
+const getUser = cache(async (uid: number) => {
+  return await db.user.findUnique({ where: { id: uid } })
+})
+
+// Primitive args use value equality
+getUser(1)
+getUser(1)  // Cache hit, returns cached result
+```
+
+If you must pass objects, pass the same reference:
+
+```typescript
+const params = { uid: 1 }
+getUser(params)  // Query runs
+getUser(params)  // Cache hit (same reference)
+```
+
+**Next.js-Specific Note:**
+
+In Next.js, the `fetch` API is automatically extended with request memoization. Requests with the same URL and options are automatically deduplicated within a single request, so you don't need `React.cache()` for `fetch` calls. However, `React.cache()` is still essential for other async tasks:
+
+- Database queries (Prisma, Drizzle, etc.)
+- Heavy computations
+- Authentication checks
+- File system operations
+- Any non-fetch async work
+
+Use `React.cache()` to deduplicate these operations across your component tree.
+
+Reference: [React.cache documentation](https://react.dev/reference/react/cache)
diff --git a/.claude/skills/react-best-practices/rules/server-dedup-props.md b/.claude/skills/react-best-practices/rules/server-dedup-props.md
new file mode 100644
index 0000000..fb24a25
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/server-dedup-props.md
@@ -0,0 +1,65 @@
+---
+title: Avoid Duplicate Serialization in RSC Props
+impact: LOW
+impactDescription: reduces network payload by avoiding duplicate serialization
+tags: server, rsc, serialization, props, client-components
+---
+
+## Avoid Duplicate Serialization in RSC Props
+
+**Impact: LOW (reduces network payload by avoiding duplicate serialization)**
+
+RSC→client serialization deduplicates by object reference, not value. Same reference = serialized once; new reference = serialized again. Do transformations (`.toSorted()`, `.filter()`, `.map()`) in client, not server.
+
+**Incorrect (duplicates array):**
+
+```tsx
+// RSC: sends 6 strings (2 arrays × 3 items)
+<ClientList usernames={usernames} usernamesOrdered={usernames.toSorted()} />
+```
+
+**Correct (sends 3 strings):**
+
+```tsx
+// RSC: send once
+<ClientList usernames={usernames} />
+
+// Client: transform there
+'use client'
+const sorted = useMemo(() => [...usernames].sort(), [usernames])
+```
+
+**Nested deduplication behavior:**
+
+Deduplication works recursively. Impact varies by data type:
+
+- `string[]`, `number[]`, `boolean[]`: **HIGH impact** - array + all primitives fully duplicated
+- `object[]`: **LOW impact** - array duplicated, but nested objects deduplicated by reference
+
+```tsx
+// string[] - duplicates everything
+usernames={['a','b']} sorted={usernames.toSorted()} // sends 4 strings
+
+// object[] - duplicates array structure only
+users={[{id:1},{id:2}]} sorted={users.toSorted()} // sends 2 arrays + 2 unique objects (not 4)
+```
+
+**Operations breaking deduplication (create new references):**
+
+- Arrays: `.toSorted()`, `.filter()`, `.map()`, `.slice()`, `[...arr]`
+- Objects: `{...obj}`, `Object.assign()`, `structuredClone()`, `JSON.parse(JSON.stringify())`
+
+**More examples:**
+
+```tsx
+// ❌ Bad
+<C users={users} active={users.filter(u => u.active)} />
+<C product={product} productName={product.name} />
+
+// ✅ Good
+<C users={users} />
+<C product={product} />
+// Do filtering/destructuring in client
+```
+
+**Exception:** Pass derived data when transformation is expensive or client doesn't need original.
diff --git a/.claude/skills/react-best-practices/rules/server-parallel-fetching.md b/.claude/skills/react-best-practices/rules/server-parallel-fetching.md
new file mode 100644
index 0000000..1affc83
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/server-parallel-fetching.md
@@ -0,0 +1,83 @@
+---
+title: Parallel Data Fetching with Component Composition
+impact: CRITICAL
+impactDescription: eliminates server-side waterfalls
+tags: server, rsc, parallel-fetching, composition
+---
+
+## Parallel Data Fetching with Component Composition
+
+React Server Components execute sequentially within a tree. Restructure with composition to parallelize data fetching.
+
+**Incorrect (Sidebar waits for Page's fetch to complete):**
+
+```tsx
+export default async function Page() {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      <Sidebar />
+    </div>
+  )
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+```
+
+**Correct (both fetch simultaneously):**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <div>
+      <Header />
+      <Sidebar />
+    </div>
+  )
+}
+```
+
+**Alternative with children prop:**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+function Layout({ children }: { children: ReactNode }) {
+  return (
+    <div>
+      <Header />
+      {children}
+    </div>
+  )
+}
+
+export default function Page() {
+  return (
+    <Layout>
+      <Sidebar />
+    </Layout>
+  )
+}
+```
diff --git a/.claude/skills/react-best-practices/rules/server-serialization.md b/.claude/skills/react-best-practices/rules/server-serialization.md
new file mode 100644
index 0000000..39c5c41
--- /dev/null
+++ b/.claude/skills/react-best-practices/rules/server-serialization.md
@@ -0,0 +1,38 @@
+---
+title: Minimize Serialization at RSC Boundaries
+impact: HIGH
+impactDescription: reduces data transfer size
+tags: server, rsc, serialization, props
+---
+
+## Minimize Serialization at RSC Boundaries
+
+The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
+
+**Incorrect (serializes all 50 fields):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()  // 50 fields
+  return <Profile user={user} />
+}
+
+'use client'
+function Profile({ user }: { user: User }) {
+  return <div>{user.name}</div>  // uses 1 field
+}
+```
+
+**Correct (serializes only 1 field):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()
+  return <Profile name={user.name} />
+}
+
+'use client'
+function Profile({ name }: { name: string }) {
+  return <div>{name}</div>
+}
+```
diff --git a/.claude/skills/react-native-skills/SKILL.md b/.claude/skills/react-native-skills/SKILL.md
new file mode 100644
index 0000000..7340186
--- /dev/null
+++ b/.claude/skills/react-native-skills/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: vercel-react-native-skills
+description:
+  React Native and Expo best practices for building performant mobile apps. Use
+  when building React Native components, optimizing list performance,
+  implementing animations, or working with native modules. Triggers on tasks
+  involving React Native, Expo, mobile performance, or native platform APIs.
+license: MIT
+metadata:
+  author: vercel
+  version: '1.0.0'
+---
+
+# React Native Skills
+
+Comprehensive best practices for React Native and Expo applications. Contains
+rules across multiple categories covering performance, animations, UI patterns,
+and platform-specific optimizations.
+
+## When to Apply
+
+Reference these guidelines when:
+
+- Building React Native or Expo apps
+- Optimizing list and scroll performance
+- Implementing animations with Reanimated
+- Working with images and media
+- Configuring native modules or fonts
+- Structuring monorepo projects with native dependencies
+
+## Rule Categories by Priority
+
+| Priority | Category         | Impact   | Prefix               |
+| -------- | ---------------- | -------- | -------------------- |
+| 1        | List Performance | CRITICAL | `list-performance-`  |
+| 2        | Animation        | HIGH     | `animation-`         |
+| 3        | Navigation       | HIGH     | `navigation-`        |
+| 4        | UI Patterns      | HIGH     | `ui-`                |
+| 5        | State Management | MEDIUM   | `react-state-`       |
+| 6        | Rendering        | MEDIUM   | `rendering-`         |
+| 7        | Monorepo         | MEDIUM   | `monorepo-`          |
+| 8        | Configuration    | LOW      | `fonts-`, `imports-` |
+
+## Quick Reference
+
+### 1. List Performance (CRITICAL)
+
+- `list-performance-virtualize` - Use FlashList for large lists
+- `list-performance-item-memo` - Memoize list item components
+- `list-performance-callbacks` - Stabilize callback references
+- `list-performance-inline-objects` - Avoid inline style objects
+- `list-performance-function-references` - Extract functions outside render
+- `list-performance-images` - Optimize images in lists
+- `list-performance-item-expensive` - Move expensive work outside items
+- `list-performance-item-types` - Use item types for heterogeneous lists
+
+### 2. Animation (HIGH)
+
+- `animation-gpu-properties` - Animate only transform and opacity
+- `animation-derived-value` - Use useDerivedValue for computed animations
+- `animation-gesture-detector-press` - Use Gesture.Tap instead of Pressable
+
+### 3. Navigation (HIGH)
+
+- `navigation-native-navigators` - Use native stack and native tabs over JS navigators
+
+### 4. UI Patterns (HIGH)
+
+- `ui-expo-image` - Use expo-image for all images
+- `ui-image-gallery` - Use Galeria for image lightboxes
+- `ui-pressable` - Use Pressable over TouchableOpacity
+- `ui-safe-area-scroll` - Handle safe areas in ScrollViews
+- `ui-scrollview-content-inset` - Use contentInset for headers
+- `ui-menus` - Use native context menus
+- `ui-native-modals` - Use native modals when possible
+- `ui-measure-views` - Use onLayout, not measure()
+- `ui-styling` - Use StyleSheet.create or Nativewind
+
+### 5. State Management (MEDIUM)
+
+- `react-state-minimize` - Minimize state subscriptions
+- `react-state-dispatcher` - Use dispatcher pattern for callbacks
+- `react-state-fallback` - Show fallback on first render
+- `react-compiler-destructure-functions` - Destructure for React Compiler
+- `react-compiler-reanimated-shared-values` - Handle shared values with compiler
+
+### 6. Rendering (MEDIUM)
+
+- `rendering-text-in-text-component` - Wrap text in Text components
+- `rendering-no-falsy-and` - Avoid falsy && for conditional rendering
+
+### 7. Monorepo (MEDIUM)
+
+- `monorepo-native-deps-in-app` - Keep native dependencies in app package
+- `monorepo-single-dependency-versions` - Use single versions across packages
+
+### 8. Configuration (LOW)
+
+- `fonts-config-plugin` - Use config plugins for custom fonts
+- `imports-design-system-folder` - Organize design system imports
+- `js-hoist-intl` - Hoist Intl object creation
+
+## How to Use
+
+Read individual rule files for detailed explanations and code examples:
+
+```
+rules/list-performance-virtualize.md
+rules/animation-gpu-properties.md
+```
+
+Each rule file contains:
+
+- Brief explanation of why it matters
+- Incorrect code example with explanation
+- Correct code example with explanation
+- Additional context and references
+
+## Full Compiled Document
+
+For the complete guide with all rules expanded: `AGENTS.md`
diff --git a/.claude/skills/react-native-skills/metadata.json b/.claude/skills/react-native-skills/metadata.json
new file mode 100644
index 0000000..600eb5b
--- /dev/null
+++ b/.claude/skills/react-native-skills/metadata.json
@@ -0,0 +1,16 @@
+{
+  "version": "1.0.0",
+  "organization": "Engineering",
+  "date": "January 2026",
+  "abstract": "Comprehensive performance optimization guide for React Native applications, designed for AI agents and LLMs. Contains 35+ rules across 13 categories, prioritized by impact from critical (core rendering, list performance) to incremental (fonts, imports). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics to guide automated refactoring and code generation.",
+  "references": [
+    "https://react.dev",
+    "https://reactnative.dev",
+    "https://docs.swmansion.com/react-native-reanimated",
+    "https://docs.swmansion.com/react-native-gesture-handler",
+    "https://docs.expo.dev",
+    "https://legendapp.com/open-source/legend-list",
+    "https://github.com/nandorojo/galeria",
+    "https://zeego.dev"
+  ]
+}
diff --git a/.claude/skills/react-native-skills/rules/_sections.md b/.claude/skills/react-native-skills/rules/_sections.md
new file mode 100644
index 0000000..0519cf2
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/_sections.md
@@ -0,0 +1,86 @@
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Core Rendering (rendering)
+
+**Impact:** CRITICAL  
+**Description:** Fundamental React Native rendering rules. Violations cause
+runtime crashes or broken UI.
+
+## 2. List Performance (list-performance)
+
+**Impact:** HIGH  
+**Description:** Optimizing virtualized lists (FlatList, LegendList, FlashList)
+for smooth scrolling and fast updates.
+
+## 3. Animation (animation)
+
+**Impact:** HIGH  
+**Description:** GPU-accelerated animations, Reanimated patterns, and avoiding
+render thrashing during gestures.
+
+## 4. Scroll Performance (scroll)
+
+**Impact:** HIGH  
+**Description:** Tracking scroll position without causing render thrashing.
+
+## 5. Navigation (navigation)
+
+**Impact:** HIGH  
+**Description:** Using native navigators for stack and tab navigation instead of
+JS-based alternatives.
+
+## 6. React State (react-state)
+
+**Impact:** MEDIUM  
+**Description:** Patterns for managing React state to avoid stale closures and
+unnecessary re-renders.
+
+## 7. State Architecture (state)
+
+**Impact:** MEDIUM  
+**Description:** Ground truth principles for state variables and derived values.
+
+## 8. React Compiler (react-compiler)
+
+**Impact:** MEDIUM  
+**Description:** Compatibility patterns for React Compiler with React Native and
+Reanimated.
+
+## 9. User Interface (ui)
+
+**Impact:** MEDIUM  
+**Description:** Native UI patterns for images, menus, modals, styling, and
+platform-consistent interfaces.
+
+## 10. Design System (design-system)
+
+**Impact:** MEDIUM  
+**Description:** Architecture patterns for building maintainable component
+libraries.
+
+## 11. Monorepo (monorepo)
+
+**Impact:** LOW  
+**Description:** Dependency management and native module configuration in
+monorepos.
+
+## 12. Third-Party Dependencies (imports)
+
+**Impact:** LOW  
+**Description:** Wrapping and re-exporting third-party dependencies for
+maintainability.
+
+## 13. JavaScript (js)
+
+**Impact:** LOW  
+**Description:** Micro-optimizations like hoisting expensive object creation.
+
+## 14. Fonts (fonts)
+
+**Impact:** LOW  
+**Description:** Native font loading for improved performance.
diff --git a/.claude/skills/react-native-skills/rules/_template.md b/.claude/skills/react-native-skills/rules/_template.md
new file mode 100644
index 0000000..1e9e707
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/_template.md
@@ -0,0 +1,28 @@
+---
+title: Rule Title Here
+impact: MEDIUM
+impactDescription: Optional description of impact (e.g., "20-50% improvement")
+tags: tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: MEDIUM (optional impact description)**
+
+Brief explanation of the rule and why it matters. This should be clear and concise, explaining the performance implications.
+
+**Incorrect (description of what's wrong):**
+
+```typescript
+// Bad code example here
+const bad = example()
+```
+
+**Correct (description of what's right):**
+
+```typescript
+// Good code example here
+const good = example()
+```
+
+Reference: [Link to documentation or resource](https://example.com)
diff --git a/.claude/skills/react-native-skills/rules/animation-derived-value.md b/.claude/skills/react-native-skills/rules/animation-derived-value.md
new file mode 100644
index 0000000..310928a
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/animation-derived-value.md
@@ -0,0 +1,53 @@
+---
+title: Prefer useDerivedValue Over useAnimatedReaction
+impact: MEDIUM
+impactDescription: cleaner code, automatic dependency tracking
+tags: animation, reanimated, derived-value
+---
+
+## Prefer useDerivedValue Over useAnimatedReaction
+
+When deriving a shared value from another, use `useDerivedValue` instead of
+`useAnimatedReaction`. Derived values are declarative, automatically track
+dependencies, and return a value you can use directly. Animated reactions are
+for side effects, not derivations.
+
+**Incorrect (useAnimatedReaction for derivation):**
+
+```tsx
+import { useSharedValue, useAnimatedReaction } from 'react-native-reanimated'
+
+function MyComponent() {
+  const progress = useSharedValue(0)
+  const opacity = useSharedValue(1)
+
+  useAnimatedReaction(
+    () => progress.value,
+    (current) => {
+      opacity.value = 1 - current
+    }
+  )
+
+  // ...
+}
+```
+
+**Correct (useDerivedValue):**
+
+```tsx
+import { useSharedValue, useDerivedValue } from 'react-native-reanimated'
+
+function MyComponent() {
+  const progress = useSharedValue(0)
+
+  const opacity = useDerivedValue(() => 1 - progress.get())
+
+  // ...
+}
+```
+
+Use `useAnimatedReaction` only for side effects that don't produce a value
+(e.g., triggering haptics, logging, calling `runOnJS`).
+
+Reference:
+[Reanimated useDerivedValue](https://docs.swmansion.com/react-native-reanimated/docs/core/useDerivedValue)
diff --git a/.claude/skills/react-native-skills/rules/animation-gesture-detector-press.md b/.claude/skills/react-native-skills/rules/animation-gesture-detector-press.md
new file mode 100644
index 0000000..87c6782
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/animation-gesture-detector-press.md
@@ -0,0 +1,95 @@
+---
+title: Use GestureDetector for Animated Press States
+impact: MEDIUM
+impactDescription: UI thread animations, smoother press feedback
+tags: animation, gestures, press, reanimated
+---
+
+## Use GestureDetector for Animated Press States
+
+For animated press states (scale, opacity on press), use `GestureDetector` with
+`Gesture.Tap()` and shared values instead of Pressable's
+`onPressIn`/`onPressOut`. Gesture callbacks run on the UI thread as worklets—no
+JS thread round-trip for press animations.
+
+**Incorrect (Pressable with JS thread callbacks):**
+
+```tsx
+import { Pressable } from 'react-native'
+import Animated, {
+  useSharedValue,
+  useAnimatedStyle,
+  withTiming,
+} from 'react-native-reanimated'
+
+function AnimatedButton({ onPress }: { onPress: () => void }) {
+  const scale = useSharedValue(1)
+
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [{ scale: scale.value }],
+  }))
+
+  return (
+    <Pressable
+      onPress={onPress}
+      onPressIn={() => (scale.value = withTiming(0.95))}
+      onPressOut={() => (scale.value = withTiming(1))}
+    >
+      <Animated.View style={animatedStyle}>
+        <Text>Press me</Text>
+      </Animated.View>
+    </Pressable>
+  )
+}
+```
+
+**Correct (GestureDetector with UI thread worklets):**
+
+```tsx
+import { Gesture, GestureDetector } from 'react-native-gesture-handler'
+import Animated, {
+  useSharedValue,
+  useAnimatedStyle,
+  withTiming,
+  interpolate,
+  runOnJS,
+} from 'react-native-reanimated'
+
+function AnimatedButton({ onPress }: { onPress: () => void }) {
+  // Store the press STATE (0 = not pressed, 1 = pressed)
+  const pressed = useSharedValue(0)
+
+  const tap = Gesture.Tap()
+    .onBegin(() => {
+      pressed.set(withTiming(1))
+    })
+    .onFinalize(() => {
+      pressed.set(withTiming(0))
+    })
+    .onEnd(() => {
+      runOnJS(onPress)()
+    })
+
+  // Derive visual values from the state
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [
+      { scale: interpolate(withTiming(pressed.get()), [0, 1], [1, 0.95]) },
+    ],
+  }))
+
+  return (
+    <GestureDetector gesture={tap}>
+      <Animated.View style={animatedStyle}>
+        <Text>Press me</Text>
+      </Animated.View>
+    </GestureDetector>
+  )
+}
+```
+
+Store the press **state** (0 or 1), then derive the scale via `interpolate`.
+This keeps the shared value as ground truth. Use `runOnJS` to call JS functions
+from worklets. Use `.set()` and `.get()` for React Compiler compatibility.
+
+Reference:
+[Gesture Handler Tap Gesture](https://docs.swmansion.com/react-native-gesture-handler/docs/gestures/tap-gesture)
diff --git a/.claude/skills/react-native-skills/rules/animation-gpu-properties.md b/.claude/skills/react-native-skills/rules/animation-gpu-properties.md
new file mode 100644
index 0000000..5fda095
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/animation-gpu-properties.md
@@ -0,0 +1,65 @@
+---
+title: Animate Transform and Opacity Instead of Layout Properties
+impact: HIGH
+impactDescription: GPU-accelerated animations, no layout recalculation
+tags: animation, performance, reanimated, transform, opacity
+---
+
+## Animate Transform and Opacity Instead of Layout Properties
+
+Avoid animating `width`, `height`, `top`, `left`, `margin`, or `padding`. These trigger layout recalculation on every frame. Instead, use `transform` (scale, translate) and `opacity` which run on the GPU without triggering layout.
+
+**Incorrect (animates height, triggers layout every frame):**
+
+```tsx
+import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
+
+function CollapsiblePanel({ expanded }: { expanded: boolean }) {
+  const animatedStyle = useAnimatedStyle(() => ({
+    height: withTiming(expanded ? 200 : 0), // triggers layout on every frame
+    overflow: 'hidden',
+  }))
+
+  return <Animated.View style={animatedStyle}>{children}</Animated.View>
+}
+```
+
+**Correct (animates scaleY, GPU-accelerated):**
+
+```tsx
+import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
+
+function CollapsiblePanel({ expanded }: { expanded: boolean }) {
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [
+      { scaleY: withTiming(expanded ? 1 : 0) },
+    ],
+    opacity: withTiming(expanded ? 1 : 0),
+  }))
+
+  return (
+    <Animated.View style={[{ height: 200, transformOrigin: 'top' }, animatedStyle]}>
+      {children}
+    </Animated.View>
+  )
+}
+```
+
+**Correct (animates translateY for slide animations):**
+
+```tsx
+import Animated, { useAnimatedStyle, withTiming } from 'react-native-reanimated'
+
+function SlideIn({ visible }: { visible: boolean }) {
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [
+      { translateY: withTiming(visible ? 0 : 100) },
+    ],
+    opacity: withTiming(visible ? 1 : 0),
+  }))
+
+  return <Animated.View style={animatedStyle}>{children}</Animated.View>
+}
+```
+
+GPU-accelerated properties: `transform` (translate, scale, rotate), `opacity`. Everything else triggers layout.
diff --git a/.claude/skills/react-native-skills/rules/design-system-compound-components.md b/.claude/skills/react-native-skills/rules/design-system-compound-components.md
new file mode 100644
index 0000000..d8239ee
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/design-system-compound-components.md
@@ -0,0 +1,66 @@
+---
+title: Use Compound Components Over Polymorphic Children
+impact: MEDIUM
+impactDescription: flexible composition, clearer API
+tags: design-system, components, composition
+---
+
+## Use Compound Components Over Polymorphic Children
+
+Don't create components that can accept a string if they aren't a text node. If
+a component can receive a string child, it must be a dedicated `*Text`
+component. For components like buttons, which can have both a View (or
+Pressable) together with text, use compound components, such a `Button`,
+`ButtonText`, and `ButtonIcon`.
+
+**Incorrect (polymorphic children):**
+
+```tsx
+import { Pressable, Text } from 'react-native'
+
+type ButtonProps = {
+  children: string | React.ReactNode
+  icon?: React.ReactNode
+}
+
+function Button({ children, icon }: ButtonProps) {
+  return (
+    <Pressable>
+      {icon}
+      {typeof children === 'string' ? <Text>{children}</Text> : children}
+    </Pressable>
+  )
+}
+
+// Usage is ambiguous
+<Button icon={<Icon />}>Save</Button>
+<Button><CustomText>Save</CustomText></Button>
+```
+
+**Correct (compound components):**
+
+```tsx
+import { Pressable, Text } from 'react-native'
+
+function Button({ children }: { children: React.ReactNode }) {
+  return <Pressable>{children}</Pressable>
+}
+
+function ButtonText({ children }: { children: React.ReactNode }) {
+  return <Text>{children}</Text>
+}
+
+function ButtonIcon({ children }: { children: React.ReactNode }) {
+  return <>{children}</>
+}
+
+// Usage is explicit and composable
+<Button>
+  <ButtonIcon><SaveIcon /></ButtonIcon>
+  <ButtonText>Save</ButtonText>
+</Button>
+
+<Button>
+  <ButtonText>Cancel</ButtonText>
+</Button>
+```
diff --git a/.claude/skills/react-native-skills/rules/fonts-config-plugin.md b/.claude/skills/react-native-skills/rules/fonts-config-plugin.md
new file mode 100644
index 0000000..39aa014
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/fonts-config-plugin.md
@@ -0,0 +1,71 @@
+---
+title: Load fonts natively at build time
+impact: LOW
+impactDescription: fonts available at launch, no async loading
+tags: fonts, expo, performance, config-plugin
+---
+
+## Use Expo Config Plugin for Font Loading
+
+Use the `expo-font` config plugin to embed fonts at build time instead of
+`useFonts` or `Font.loadAsync`. Embedded fonts are more efficient.
+
+**Incorrect (async font loading):**
+
+```tsx
+import { useFonts } from 'expo-font'
+import { Text, View } from 'react-native'
+
+function App() {
+  const [fontsLoaded] = useFonts({
+    'Geist-Bold': require('./assets/fonts/Geist-Bold.otf'),
+  })
+
+  if (!fontsLoaded) {
+    return null
+  }
+
+  return (
+    <View>
+      <Text style={{ fontFamily: 'Geist-Bold' }}>Hello</Text>
+    </View>
+  )
+}
+```
+
+**Correct (config plugin, fonts embedded at build):**
+
+```json
+// app.json
+{
+  "expo": {
+    "plugins": [
+      [
+        "expo-font",
+        {
+          "fonts": ["./assets/fonts/Geist-Bold.otf"]
+        }
+      ]
+    ]
+  }
+}
+```
+
+```tsx
+import { Text, View } from 'react-native'
+
+function App() {
+  // No loading state needed—font is already available
+  return (
+    <View>
+      <Text style={{ fontFamily: 'Geist-Bold' }}>Hello</Text>
+    </View>
+  )
+}
+```
+
+After adding fonts to the config plugin, run `npx expo prebuild` and rebuild the
+native app.
+
+Reference:
+[Expo Font Documentation](https://docs.expo.dev/versions/latest/sdk/font/)
diff --git a/.claude/skills/react-native-skills/rules/imports-design-system-folder.md b/.claude/skills/react-native-skills/rules/imports-design-system-folder.md
new file mode 100644
index 0000000..8466dcb
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/imports-design-system-folder.md
@@ -0,0 +1,68 @@
+---
+title: Import from Design System Folder
+impact: LOW
+impactDescription: enables global changes and easy refactoring
+tags: imports, architecture, design-system
+---
+
+## Import from Design System Folder
+
+Re-export dependencies from a design system folder. App code imports from there,
+not directly from packages. This enables global changes and easy refactoring.
+
+**Incorrect (imports directly from package):**
+
+```tsx
+import { View, Text } from 'react-native'
+import { Button } from '@ui/button'
+
+function Profile() {
+  return (
+    <View>
+      <Text>Hello</Text>
+      <Button>Save</Button>
+    </View>
+  )
+}
+```
+
+**Correct (imports from design system):**
+
+```tsx
+// components/view.tsx
+import { View as RNView } from 'react-native'
+
+// ideal: pick the props you will actually use to control implementation
+export function View(
+  props: Pick<React.ComponentProps<typeof RNView>, 'style' | 'children'>
+) {
+  return <RNView {...props} />
+}
+```
+
+```tsx
+// components/text.tsx
+export { Text } from 'react-native'
+```
+
+```tsx
+// components/button.tsx
+export { Button } from '@ui/button'
+```
+
+```tsx
+import { View } from '@/components/view'
+import { Text } from '@/components/text'
+import { Button } from '@/components/button'
+
+function Profile() {
+  return (
+    <View>
+      <Text>Hello</Text>
+      <Button>Save</Button>
+    </View>
+  )
+}
+```
+
+Start by simply re-exporting. Customize later without changing app code.
diff --git a/.claude/skills/react-native-skills/rules/js-hoist-intl.md b/.claude/skills/react-native-skills/rules/js-hoist-intl.md
new file mode 100644
index 0000000..9af1c35
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/js-hoist-intl.md
@@ -0,0 +1,61 @@
+---
+title: Hoist Intl Formatter Creation
+impact: LOW-MEDIUM
+impactDescription: avoids expensive object recreation
+tags: javascript, intl, optimization, memoization
+---
+
+## Hoist Intl Formatter Creation
+
+Don't create `Intl.DateTimeFormat`, `Intl.NumberFormat`, or
+`Intl.RelativeTimeFormat` inside render or loops. These are expensive to
+instantiate. Hoist to module scope when the locale/options are static.
+
+**Incorrect (new formatter every render):**
+
+```tsx
+function Price({ amount }: { amount: number }) {
+  const formatter = new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+  })
+  return <Text>{formatter.format(amount)}</Text>
+}
+```
+
+**Correct (hoisted to module scope):**
+
+```tsx
+const currencyFormatter = new Intl.NumberFormat('en-US', {
+  style: 'currency',
+  currency: 'USD',
+})
+
+function Price({ amount }: { amount: number }) {
+  return <Text>{currencyFormatter.format(amount)}</Text>
+}
+```
+
+**For dynamic locales, memoize:**
+
+```tsx
+const dateFormatter = useMemo(
+  () => new Intl.DateTimeFormat(locale, { dateStyle: 'medium' }),
+  [locale]
+)
+```
+
+**Common formatters to hoist:**
+
+```tsx
+// Module-level formatters
+const dateFormatter = new Intl.DateTimeFormat('en-US', { dateStyle: 'medium' })
+const timeFormatter = new Intl.DateTimeFormat('en-US', { timeStyle: 'short' })
+const percentFormatter = new Intl.NumberFormat('en-US', { style: 'percent' })
+const relativeFormatter = new Intl.RelativeTimeFormat('en-US', {
+  numeric: 'auto',
+})
+```
+
+Creating `Intl` objects is significantly more expensive than `RegExp` or plain
+objects—each instantiation parses locale data and builds internal lookup tables.
diff --git a/.claude/skills/react-native-skills/rules/list-performance-callbacks.md b/.claude/skills/react-native-skills/rules/list-performance-callbacks.md
new file mode 100644
index 0000000..a0b3913
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-callbacks.md
@@ -0,0 +1,44 @@
+---
+title: Hoist callbacks to the root of lists
+impact: MEDIUM
+impactDescription: Fewer re-renders and faster lists
+tags: tag1, tag2
+---
+
+## List performance callbacks
+
+**Impact: HIGH (Fewer re-renders and faster lists)**
+
+When passing callback functions to list items, create a single instance of the
+callback at the root of the list. Items should then call it with a unique
+identifier.
+
+**Incorrect (creates a new callback on each render):**
+
+```typescript
+return (
+  <LegendList
+    renderItem={({ item }) => {
+      // bad: creates a new callback on each render
+      const onPress = () => handlePress(item.id)
+      return <Item key={item.id} item={item} onPress={onPress} />
+    }}
+  />
+)
+```
+
+**Correct (a single function instance passed to each item):**
+
+```typescript
+const onPress = useCallback(() => handlePress(item.id), [handlePress, item.id])
+
+return (
+  <LegendList
+    renderItem={({ item }) => (
+      <Item key={item.id} item={item} onPress={onPress} />
+    )}
+  />
+)
+```
+
+Reference: [Link to documentation or resource](https://example.com)
diff --git a/.claude/skills/react-native-skills/rules/list-performance-function-references.md b/.claude/skills/react-native-skills/rules/list-performance-function-references.md
new file mode 100644
index 0000000..9721929
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-function-references.md
@@ -0,0 +1,132 @@
+---
+title: Optimize List Performance with Stable Object References
+impact: CRITICAL
+impactDescription: virtualization relies on reference stability
+tags: lists, performance, flatlist, virtualization
+---
+
+## Optimize List Performance with Stable Object References
+
+Don't map or filter data before passing to virtualized lists. Virtualization
+relies on object reference stability to know what changed—new references cause
+full re-renders of all visible items. Attempt to prevent frequent renders at the
+list-parent level.
+
+Where needed, use context selectors within list items.
+
+**Incorrect (creates new object references on every keystroke):**
+
+```tsx
+function DomainSearch() {
+  const { keyword, setKeyword } = useKeywordZustandState()
+  const { data: tlds } = useTlds()
+
+  // Bad: creates new objects on every render, reparenting the entire list on every keystroke
+  const domains = tlds.map((tld) => ({
+    domain: `${keyword}.${tld.name}`,
+    tld: tld.name,
+    price: tld.price,
+  }))
+
+  return (
+    <>
+      <TextInput value={keyword} onChangeText={setKeyword} />
+      <LegendList
+        data={domains}
+        renderItem={({ item }) => <DomainItem item={item} keyword={keyword} />}
+      />
+    </>
+  )
+}
+```
+
+**Correct (stable references, transform inside items):**
+
+```tsx
+const renderItem = ({ item }) => <DomainItem tld={item} />
+
+function DomainSearch() {
+  const { data: tlds } = useTlds()
+
+  return (
+    <LegendList
+      // good: as long as the data is stable, LegendList will not re-render the entire list
+      data={tlds}
+      renderItem={renderItem}
+    />
+  )
+}
+
+function DomainItem({ tld }: { tld: Tld }) {
+  // good: transform within items, and don't pass the dynamic data as a prop
+  // good: use a selector function from zustand to receive a stable string back
+  const domain = useKeywordZustandState((s) => s.keyword + '.' + tld.name)
+  return <Text>{domain}</Text>
+}
+```
+
+**Updating parent array reference:**
+
+Creating a new array instance can be okay, as long as its inner object
+references are stable. For instance, if you sort a list of objects:
+
+```tsx
+// good: creates a new array instance without mutating the inner objects
+// good: parent array reference is unaffected by typing and updating "keyword"
+const sortedTlds = tlds.toSorted((a, b) => a.name.localeCompare(b.name))
+
+return <LegendList data={sortedTlds} renderItem={renderItem} />
+```
+
+Even though this creates a new array instance `sortedTlds`, the inner object
+references are stable.
+
+**With zustand for dynamic data (avoids parent re-renders):**
+
+```tsx
+const useSearchStore = create<{ keyword: string }>(() => ({ keyword: '' }))
+
+function DomainSearch() {
+  const { data: tlds } = useTlds()
+
+  return (
+    <>
+      <SearchInput />
+      <LegendList
+        data={tlds}
+        // if you aren't using React Compiler, wrap renderItem with useCallback
+        renderItem={({ item }) => <DomainItem tld={item} />}
+      />
+    </>
+  )
+}
+
+function DomainItem({ tld }: { tld: Tld }) {
+  // Select only what you need—component only re-renders when keyword changes
+  const keyword = useSearchStore((s) => s.keyword)
+  const domain = `${keyword}.${tld.name}`
+  return <Text>{domain}</Text>
+}
+```
+
+Virtualization can now skip items that haven't changed when typing. Only visible
+items (~20) re-render on keystroke, rather than the parent.
+
+**Deriving state within list items based on parent data (avoids parent
+re-renders):**
+
+For components where the data is conditional based on the parent state, this
+pattern is even more important. For example, if you are checking if an item is
+favorited, toggling favorites only re-renders one component if the item itself
+is in charge of accessing the state rather than the parent:
+
+```tsx
+function DomainItemFavoriteButton({ tld }: { tld: Tld }) {
+  const isFavorited = useFavoritesStore((s) => s.favorites.has(tld.id))
+  return <TldFavoriteButton isFavorited={isFavorited} />
+}
+```
+
+Note: if you're using the React Compiler, you can read React Context values
+directly within list items. Although this is slightly slower than using a
+Zustand selector in most cases, the effect may be negligible.
diff --git a/.claude/skills/react-native-skills/rules/list-performance-images.md b/.claude/skills/react-native-skills/rules/list-performance-images.md
new file mode 100644
index 0000000..75a3baf
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-images.md
@@ -0,0 +1,53 @@
+---
+title: Use Compressed Images in Lists
+impact: HIGH
+impactDescription: faster load times, less memory
+tags: lists, images, performance, optimization
+---
+
+## Use Compressed Images in Lists
+
+Always load compressed, appropriately-sized images in lists. Full-resolution
+images consume excessive memory and cause scroll jank. Request thumbnails from
+your server or use an image CDN with resize parameters.
+
+**Incorrect (full-resolution images):**
+
+```tsx
+function ProductItem({ product }: { product: Product }) {
+  return (
+    <View>
+      {/* 4000x3000 image loaded for a 100x100 thumbnail */}
+      <Image
+        source={{ uri: product.imageUrl }}
+        style={{ width: 100, height: 100 }}
+      />
+      <Text>{product.name}</Text>
+    </View>
+  )
+}
+```
+
+**Correct (request appropriately-sized image):**
+
+```tsx
+function ProductItem({ product }: { product: Product }) {
+  // Request a 200x200 image (2x for retina)
+  const thumbnailUrl = `${product.imageUrl}?w=200&h=200&fit=cover`
+
+  return (
+    <View>
+      <Image
+        source={{ uri: thumbnailUrl }}
+        style={{ width: 100, height: 100 }}
+        contentFit='cover'
+      />
+      <Text>{product.name}</Text>
+    </View>
+  )
+}
+```
+
+Use an optimized image component with built-in caching and placeholder support,
+such as `expo-image` or `SolitoImage` (which uses `expo-image` under the hood).
+Request images at 2x the display size for retina screens.
diff --git a/.claude/skills/react-native-skills/rules/list-performance-inline-objects.md b/.claude/skills/react-native-skills/rules/list-performance-inline-objects.md
new file mode 100644
index 0000000..d5b6514
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-inline-objects.md
@@ -0,0 +1,97 @@
+---
+title: Avoid Inline Objects in renderItem
+impact: HIGH
+impactDescription: prevents unnecessary re-renders of memoized list items
+tags: lists, performance, flatlist, virtualization, memo
+---
+
+## Avoid Inline Objects in renderItem
+
+Don't create new objects inside `renderItem` to pass as props. Inline objects
+create new references on every render, breaking memoization. Pass primitive
+values directly from `item` instead.
+
+**Incorrect (inline object breaks memoization):**
+
+```tsx
+function UserList({ users }: { users: User[] }) {
+  return (
+    <LegendList
+      data={users}
+      renderItem={({ item }) => (
+        <UserRow
+          // Bad: new object on every render
+          user={{ id: item.id, name: item.name, avatar: item.avatar }}
+        />
+      )}
+    />
+  )
+}
+```
+
+**Incorrect (inline style object):**
+
+```tsx
+renderItem={({ item }) => (
+  <UserRow
+    name={item.name}
+    // Bad: new style object on every render
+    style={{ backgroundColor: item.isActive ? 'green' : 'gray' }}
+  />
+)}
+```
+
+**Correct (pass item directly or primitives):**
+
+```tsx
+function UserList({ users }: { users: User[] }) {
+  return (
+    <LegendList
+      data={users}
+      renderItem={({ item }) => (
+        // Good: pass the item directly
+        <UserRow user={item} />
+      )}
+    />
+  )
+}
+```
+
+**Correct (pass primitives, derive inside child):**
+
+```tsx
+renderItem={({ item }) => (
+  <UserRow
+    id={item.id}
+    name={item.name}
+    isActive={item.isActive}
+  />
+)}
+
+const UserRow = memo(function UserRow({ id, name, isActive }: Props) {
+  // Good: derive style inside memoized component
+  const backgroundColor = isActive ? 'green' : 'gray'
+  return <View style={[styles.row, { backgroundColor }]}>{/* ... */}</View>
+})
+```
+
+**Correct (hoist static styles in module scope):**
+
+```tsx
+const activeStyle = { backgroundColor: 'green' }
+const inactiveStyle = { backgroundColor: 'gray' }
+
+renderItem={({ item }) => (
+  <UserRow
+    name={item.name}
+    // Good: stable references
+    style={item.isActive ? activeStyle : inactiveStyle}
+  />
+)}
+```
+
+Passing primitives or stable references allows `memo()` to skip re-renders when
+the actual values haven't changed.
+
+**Note:** If you have the React Compiler enabled, it handles memoization
+automatically and these manual optimizations become less critical.
diff --git a/.claude/skills/react-native-skills/rules/list-performance-item-expensive.md b/.claude/skills/react-native-skills/rules/list-performance-item-expensive.md
new file mode 100644
index 0000000..f617a76
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-item-expensive.md
@@ -0,0 +1,94 @@
+---
+title: Keep List Items Lightweight
+impact: HIGH
+impactDescription: reduces render time for visible items during scroll
+tags: lists, performance, virtualization, hooks
+---
+
+## Keep List Items Lightweight
+
+List items should be as inexpensive as possible to render. Minimize hooks, avoid
+queries, and limit React Context access. Virtualized lists render many items
+during scroll—expensive items cause jank.
+
+**Incorrect (heavy list item):**
+
+```tsx
+function ProductRow({ id }: { id: string }) {
+  // Bad: query inside list item
+  const { data: product } = useQuery(['product', id], () => fetchProduct(id))
+  // Bad: multiple context accesses
+  const theme = useContext(ThemeContext)
+  const user = useContext(UserContext)
+  const cart = useContext(CartContext)
+  // Bad: expensive computation
+  const recommendations = useMemo(
+    () => computeRecommendations(product),
+    [product]
+  )
+
+  return <View>{/* ... */}</View>
+}
+```
+
+**Correct (lightweight list item):**
+
+```tsx
+function ProductRow({ name, price, imageUrl }: Props) {
+  // Good: receives only primitives, minimal hooks
+  return (
+    <View>
+      <Image source={{ uri: imageUrl }} />
+      <Text>{name}</Text>
+      <Text>{price}</Text>
+    </View>
+  )
+}
+```
+
+**Move data fetching to parent:**
+
+```tsx
+// Parent fetches all data once
+function ProductList() {
+  const { data: products } = useQuery(['products'], fetchProducts)
+
+  return (
+    <LegendList
+      data={products}
+      renderItem={({ item }) => (
+        <ProductRow name={item.name} price={item.price} imageUrl={item.image} />
+      )}
+    />
+  )
+}
+```
+
+**For shared values, use Zustand selectors instead of Context:**
+
+```tsx
+// Incorrect: Context causes re-render when any cart value changes
+function ProductRow({ id, name }: Props) {
+  const { items } = useContext(CartContext)
+  const inCart = items.includes(id)
+  // ...
+}
+
+// Correct: Zustand selector only re-renders when this specific value changes
+function ProductRow({ id, name }: Props) {
+  // use Set.has (created once at the root) instead of Array.includes()
+  const inCart = useCartStore((s) => s.items.has(id))
+  // ...
+}
+```
+
+**Guidelines for list items:**
+
+- No queries or data fetching
+- No expensive computations (move to parent or memoize at parent level)
+- Prefer Zustand selectors over React Context
+- Minimize useState/useEffect hooks
+- Pass pre-computed values as props
+
+The goal: list items should be simple rendering functions that take props and
+return JSX.
diff --git a/.claude/skills/react-native-skills/rules/list-performance-item-memo.md b/.claude/skills/react-native-skills/rules/list-performance-item-memo.md
new file mode 100644
index 0000000..634935e
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-item-memo.md
@@ -0,0 +1,82 @@
+---
+title: Pass Primitives to List Items for Memoization
+impact: HIGH
+impactDescription: enables effective memo() comparison
+tags: lists, performance, memo, primitives
+---
+
+## Pass Primitives to List Items for Memoization
+
+When possible, pass only primitive values (strings, numbers, booleans) as props
+to list item components. Primitives enable shallow comparison in `memo()` to
+work correctly, skipping re-renders when values haven't changed.
+
+**Incorrect (object prop requires deep comparison):**
+
+```tsx
+type User = { id: string; name: string; email: string; avatar: string }
+
+const UserRow = memo(function UserRow({ user }: { user: User }) {
+  // memo() compares user by reference, not value
+  // If parent creates new user object, this re-renders even if data is same
+  return <Text>{user.name}</Text>
+})
+
+renderItem={({ item }) => <UserRow user={item} />}
+```
+
+This can still be optimized, but it is harder to memoize properly.
+
+**Correct (primitive props enable shallow comparison):**
+
+```tsx
+const UserRow = memo(function UserRow({
+  id,
+  name,
+  email,
+}: {
+  id: string
+  name: string
+  email: string
+}) {
+  // memo() compares each primitive directly
+  // Re-renders only if id, name, or email actually changed
+  return <Text>{name}</Text>
+})
+
+renderItem={({ item }) => (
+  <UserRow id={item.id} name={item.name} email={item.email} />
+)}
+```
+
+**Pass only what you need:**
+
+```tsx
+// Incorrect: passing entire item when you only need name
+<UserRow user={item} />
+
+// Correct: pass only the fields the component uses
+<UserRow name={item.name} avatarUrl={item.avatar} />
+```
+
+**For callbacks, hoist or use item ID:**
+
+```tsx
+// Incorrect: inline function creates new reference
+<UserRow name={item.name} onPress={() => handlePress(item.id)} />
+
+// Correct: pass ID, handle in child
+<UserRow id={item.id} name={item.name} />
+
+const UserRow = memo(function UserRow({ id, name }: Props) {
+  const handlePress = useCallback(() => {
+    // use id here
+  }, [id])
+  return <Pressable onPress={handlePress}><Text>{name}</Text></Pressable>
+})
+```
+
+Primitive props make memoization predictable and effective.
+
+**Note:** If you have the React Compiler enabled, you do not need to use
+`memo()` or `useCallback()`, but the object references still apply.
diff --git a/.claude/skills/react-native-skills/rules/list-performance-item-types.md b/.claude/skills/react-native-skills/rules/list-performance-item-types.md
new file mode 100644
index 0000000..1027e4e
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-item-types.md
@@ -0,0 +1,104 @@
+---
+title: Use Item Types for Heterogeneous Lists
+impact: HIGH
+impactDescription: efficient recycling, less layout thrashing
+tags: list, performance, recycling, heterogeneous, LegendList
+---
+
+## Use Item Types for Heterogeneous Lists
+
+When a list has different item layouts (messages, images, headers, etc.), use a
+`type` field on each item and provide `getItemType` to the list. This puts items
+into separate recycling pools so a message component never gets recycled into an
+image component.
+
+**Incorrect (single component with conditionals):**
+
+```tsx
+type Item = { id: string; text?: string; imageUrl?: string; isHeader?: boolean }
+
+function ListItem({ item }: { item: Item }) {
+  if (item.isHeader) {
+    return <HeaderItem title={item.text} />
+  }
+  if (item.imageUrl) {
+    return <ImageItem url={item.imageUrl} />
+  }
+  return <MessageItem text={item.text} />
+}
+
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <LegendList
+      data={items}
+      renderItem={({ item }) => <ListItem item={item} />}
+      recycleItems
+    />
+  )
+}
+```
+
+**Correct (typed items with separate components):**
+
+```tsx
+type HeaderItem = { id: string; type: 'header'; title: string }
+type MessageItem = { id: string; type: 'message'; text: string }
+type ImageItem = { id: string; type: 'image'; url: string }
+type FeedItem = HeaderItem | MessageItem | ImageItem
+
+function Feed({ items }: { items: FeedItem[] }) {
+  return (
+    <LegendList
+      data={items}
+      keyExtractor={(item) => item.id}
+      getItemType={(item) => item.type}
+      renderItem={({ item }) => {
+        switch (item.type) {
+          case 'header':
+            return <SectionHeader title={item.title} />
+          case 'message':
+            return <MessageRow text={item.text} />
+          case 'image':
+            return <ImageRow url={item.url} />
+        }
+      }}
+      recycleItems
+    />
+  )
+}
+```
+
+**Why this matters:**
+
+- **Recycling efficiency**: Items with the same type share a recycling pool
+- **No layout thrashing**: A header never recycles into an image cell
+- **Type safety**: TypeScript can narrow the item type in each branch
+- **Better size estimation**: Use `getEstimatedItemSize` with `itemType` for
+  accurate estimates per type
+
+```tsx
+<LegendList
+  data={items}
+  keyExtractor={(item) => item.id}
+  getItemType={(item) => item.type}
+  getEstimatedItemSize={(index, item, itemType) => {
+    switch (itemType) {
+      case 'header':
+        return 48
+      case 'message':
+        return 72
+      case 'image':
+        return 300
+      default:
+        return 72
+    }
+  }}
+  renderItem={({ item }) => {
+    /* ... */
+  }}
+  recycleItems
+/>
+```
+
+Reference:
+[LegendList getItemType](https://legendapp.com/open-source/list/api/props/#getitemtype-v2)
diff --git a/.claude/skills/react-native-skills/rules/list-performance-virtualize.md b/.claude/skills/react-native-skills/rules/list-performance-virtualize.md
new file mode 100644
index 0000000..8a393ba
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/list-performance-virtualize.md
@@ -0,0 +1,67 @@
+---
+title: Use a List Virtualizer for Any List
+impact: HIGH
+impactDescription: reduced memory, faster mounts
+tags: lists, performance, virtualization, scrollview
+---
+
+## Use a List Virtualizer for Any List
+
+Use a list virtualizer like LegendList or FlashList instead of ScrollView with
+mapped children—even for short lists. Virtualizers only render visible items,
+reducing memory usage and mount time. ScrollView renders all children upfront,
+which gets expensive quickly.
+
+**Incorrect (ScrollView renders all items at once):**
+
+```tsx
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <ScrollView>
+      {items.map((item) => (
+        <ItemCard key={item.id} item={item} />
+      ))}
+    </ScrollView>
+  )
+}
+// 50 items = 50 components mounted, even if only 10 visible
+```
+
+**Correct (virtualizer renders only visible items):**
+
+```tsx
+import { LegendList } from '@legendapp/list'
+
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <LegendList
+      data={items}
+      // if you aren't using React Compiler, wrap these with useCallback
+      renderItem={({ item }) => <ItemCard item={item} />}
+      keyExtractor={(item) => item.id}
+      estimatedItemSize={80}
+    />
+  )
+}
+// Only ~10-15 visible items mounted at a time
+```
+
+**Alternative (FlashList):**
+
+```tsx
+import { FlashList } from '@shopify/flash-list'
+
+function Feed({ items }: { items: Item[] }) {
+  return (
+    <FlashList
+      data={items}
+      // if you aren't using React Compiler, wrap these with useCallback
+      renderItem={({ item }) => <ItemCard item={item} />}
+      keyExtractor={(item) => item.id}
+    />
+  )
+}
+```
+
+Benefits apply to any screen with scrollable content—profiles, settings, feeds,
+search results. Default to virtualization.
diff --git a/.claude/skills/react-native-skills/rules/monorepo-native-deps-in-app.md b/.claude/skills/react-native-skills/rules/monorepo-native-deps-in-app.md
new file mode 100644
index 0000000..ff85d76
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/monorepo-native-deps-in-app.md
@@ -0,0 +1,46 @@
+---
+title: Install Native Dependencies in App Directory
+impact: CRITICAL
+impactDescription: required for autolinking to work
+tags: monorepo, native, autolinking, installation
+---
+
+## Install Native Dependencies in App Directory
+
+In a monorepo, packages with native code must be installed in the native app's
+directory directly. Autolinking only scans the app's `node_modules`—it won't
+find native dependencies installed in other packages.
+
+**Incorrect (native dep in shared package only):**
+
+```
+packages/
+  ui/
+    package.json  # has react-native-reanimated
+  app/
+    package.json  # missing react-native-reanimated
+```
+
+Autolinking fails—native code not linked.
+
+**Correct (native dep in app directory):**
+
+```
+packages/
+  ui/
+    package.json  # has react-native-reanimated
+  app/
+    package.json  # also has react-native-reanimated
+```
+
+```json
+// packages/app/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "3.16.1"
+  }
+}
+```
+
+Even if the shared package uses the native dependency, the app must also list it
+for autolinking to detect and link the native code.
diff --git a/.claude/skills/react-native-skills/rules/monorepo-single-dependency-versions.md b/.claude/skills/react-native-skills/rules/monorepo-single-dependency-versions.md
new file mode 100644
index 0000000..1087dfa
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/monorepo-single-dependency-versions.md
@@ -0,0 +1,63 @@
+---
+title: Use Single Dependency Versions Across Monorepo
+impact: MEDIUM
+impactDescription: avoids duplicate bundles, version conflicts
+tags: monorepo, dependencies, installation
+---
+
+## Use Single Dependency Versions Across Monorepo
+
+Use a single version of each dependency across all packages in your monorepo.
+Prefer exact versions over ranges. Multiple versions cause duplicate code in
+bundles, runtime conflicts, and inconsistent behavior across packages.
+
+Use a tool like syncpack to enforce this. As a last resort, use yarn resolutions
+or npm overrides.
+
+**Incorrect (version ranges, multiple versions):**
+
+```json
+// packages/app/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "^3.0.0"
+  }
+}
+
+// packages/ui/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "^3.5.0"
+  }
+}
+```
+
+**Correct (exact versions, single source of truth):**
+
+```json
+// package.json (root)
+{
+  "pnpm": {
+    "overrides": {
+      "react-native-reanimated": "3.16.1"
+    }
+  }
+}
+
+// packages/app/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "3.16.1"
+  }
+}
+
+// packages/ui/package.json
+{
+  "dependencies": {
+    "react-native-reanimated": "3.16.1"
+  }
+}
+```
+
+Use your package manager's override/resolution feature to enforce versions at
+the root. When adding dependencies, specify exact versions without `^` or `~`.
diff --git a/.claude/skills/react-native-skills/rules/navigation-native-navigators.md b/.claude/skills/react-native-skills/rules/navigation-native-navigators.md
new file mode 100644
index 0000000..035c5fd
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/navigation-native-navigators.md
@@ -0,0 +1,188 @@
+---
+title: Use Native Navigators for Navigation
+impact: HIGH
+impactDescription: native performance, platform-appropriate UI
+tags: navigation, react-navigation, expo-router, native-stack, tabs
+---
+
+## Use Native Navigators for Navigation
+
+Always use native navigators instead of JS-based ones. Native navigators use
+platform APIs (UINavigationController on iOS, Fragment on Android) for better
+performance and native behavior.
+
+**For stacks:** Use `@react-navigation/native-stack` or expo-router's default
+stack (which uses native-stack). Avoid `@react-navigation/stack`.
+
+**For tabs:** Use `react-native-bottom-tabs` (native) or expo-router's native
+tabs. Avoid `@react-navigation/bottom-tabs` when native feel matters.
+
+### Stack Navigation
+
+**Incorrect (JS stack navigator):**
+
+```tsx
+import { createStackNavigator } from '@react-navigation/stack'
+
+const Stack = createStackNavigator()
+
+function App() {
+  return (
+    <Stack.Navigator>
+      <Stack.Screen name='Home' component={HomeScreen} />
+      <Stack.Screen name='Details' component={DetailsScreen} />
+    </Stack.Navigator>
+  )
+}
+```
+
+**Correct (native stack with react-navigation):**
+
+```tsx
+import { createNativeStackNavigator } from '@react-navigation/native-stack'
+
+const Stack = createNativeStackNavigator()
+
+function App() {
+  return (
+    <Stack.Navigator>
+      <Stack.Screen name='Home' component={HomeScreen} />
+      <Stack.Screen name='Details' component={DetailsScreen} />
+    </Stack.Navigator>
+  )
+}
+```
+
+**Correct (expo-router uses native stack by default):**
+
+```tsx
+// app/_layout.tsx
+import { Stack } from 'expo-router'
+
+export default function Layout() {
+  return <Stack />
+}
+```
+
+### Tab Navigation
+
+**Incorrect (JS bottom tabs):**
+
+```tsx
+import { createBottomTabNavigator } from '@react-navigation/bottom-tabs'
+
+const Tab = createBottomTabNavigator()
+
+function App() {
+  return (
+    <Tab.Navigator>
+      <Tab.Screen name='Home' component={HomeScreen} />
+      <Tab.Screen name='Settings' component={SettingsScreen} />
+    </Tab.Navigator>
+  )
+}
+```
+
+**Correct (native bottom tabs with react-navigation):**
+
+```tsx
+import { createNativeBottomTabNavigator } from '@bottom-tabs/react-navigation'
+
+const Tab = createNativeBottomTabNavigator()
+
+function App() {
+  return (
+    <Tab.Navigator>
+      <Tab.Screen
+        name='Home'
+        component={HomeScreen}
+        options={{
+          tabBarIcon: () => ({ sfSymbol: 'house' }),
+        }}
+      />
+      <Tab.Screen
+        name='Settings'
+        component={SettingsScreen}
+        options={{
+          tabBarIcon: () => ({ sfSymbol: 'gear' }),
+        }}
+      />
+    </Tab.Navigator>
+  )
+}
+```
+
+**Correct (expo-router native tabs):**
+
+```tsx
+// app/(tabs)/_layout.tsx
+import { NativeTabs } from 'expo-router/unstable-native-tabs'
+
+export default function TabLayout() {
+  return (
+    <NativeTabs>
+      <NativeTabs.Trigger name='index'>
+        <NativeTabs.Trigger.Label>Home</NativeTabs.Trigger.Label>
+        <NativeTabs.Trigger.Icon sf='house.fill' md='home' />
+      </NativeTabs.Trigger>
+      <NativeTabs.Trigger name='settings'>
+        <NativeTabs.Trigger.Label>Settings</NativeTabs.Trigger.Label>
+        <NativeTabs.Trigger.Icon sf='gear' md='settings' />
+      </NativeTabs.Trigger>
+    </NativeTabs>
+  )
+}
+```
+
+On iOS, native tabs automatically enable `contentInsetAdjustmentBehavior` on the
+first `ScrollView` at the root of each tab screen, so content scrolls correctly
+behind the translucent tab bar. If you need to disable this, use
+`disableAutomaticContentInsets` on the trigger.
+
+### Prefer Native Header Options Over Custom Components
+
+**Incorrect (custom header component):**
+
+```tsx
+<Stack.Screen
+  name='Profile'
+  component={ProfileScreen}
+  options={{
+    header: () => <CustomHeader title='Profile' />,
+  }}
+/>
+```
+
+**Correct (native header options):**
+
+```tsx
+<Stack.Screen
+  name='Profile'
+  component={ProfileScreen}
+  options={{
+    title: 'Profile',
+    headerLargeTitleEnabled: true,
+    headerSearchBarOptions: {
+      placeholder: 'Search',
+    },
+  }}
+/>
+```
+
+Native headers support iOS large titles, search bars, blur effects, and proper
+safe area handling automatically.
+
+### Why Native Navigators
+
+- **Performance**: Native transitions and gestures run on the UI thread
+- **Platform behavior**: Automatic iOS large titles, Android material design
+- **System integration**: Scroll-to-top on tab tap, PiP avoidance, proper safe
+  areas
+- **Accessibility**: Platform accessibility features work automatically
+
+Reference:
+
+- [React Navigation Native Stack](https://reactnavigation.org/docs/native-stack-navigator)
+- [React Native Bottom Tabs with React Navigation](https://oss.callstack.com/react-native-bottom-tabs/docs/guides/usage-with-react-navigation)
+- [React Native Bottom Tabs with Expo Router](https://oss.callstack.com/react-native-bottom-tabs/docs/guides/usage-with-expo-router)
+- [Expo Router Native Tabs](https://docs.expo.dev/router/advanced/native-tabs)
diff --git a/.claude/skills/react-native-skills/rules/react-compiler-destructure-functions.md b/.claude/skills/react-native-skills/rules/react-compiler-destructure-functions.md
new file mode 100644
index 0000000..f76c25a
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/react-compiler-destructure-functions.md
@@ -0,0 +1,50 @@
+---
+title: Destructure Functions Early in Render (React Compiler)
+impact: HIGH
+impactDescription: stable references, fewer re-renders
+tags: rerender, hooks, performance, react-compiler
+---
+
+## Destructure Functions Early in Render
+
+This rule is only applicable if you are using the React Compiler.
+
+Destructure functions from hooks at the top of render scope. Never dot into
+objects to call functions. Destructured functions are stable references; dotting
+creates new references and breaks memoization.
+
+**Incorrect (dotting into object):**
+
+```tsx
+import { useRouter } from 'expo-router'
+
+function SaveButton(props) {
+  const router = useRouter()
+
+  // bad: react-compiler will key the cache on "props" and "router", which are objects that change each render
+  const handlePress = () => {
+    props.onSave()
+    router.push('/success') // unstable reference
+  }
+
+  return <Button onPress={handlePress}>Save</Button>
+}
+```
+
+**Correct (destructure early):**
+
+```tsx
+import { useRouter } from 'expo-router'
+
+function SaveButton({ onSave }) {
+  const { push } = useRouter()
+
+  // good: react-compiler will key on push and onSave
+  const handlePress = () => {
+    onSave()
+    push('/success') // stable reference
+  }
+
+  return <Button onPress={handlePress}>Save</Button>
+}
+```
diff --git a/.claude/skills/react-native-skills/rules/react-compiler-reanimated-shared-values.md b/.claude/skills/react-native-skills/rules/react-compiler-reanimated-shared-values.md
new file mode 100644
index 0000000..0dcbaf4
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/react-compiler-reanimated-shared-values.md
@@ -0,0 +1,48 @@
+---
+title: Use .get() and .set() for Reanimated Shared Values (not .value)
+impact: LOW
+impactDescription: required for React Compiler compatibility
+tags: reanimated, react-compiler, shared-values
+---
+
+## Use .get() and .set() for Shared Values with React Compiler
+
+With React Compiler enabled, use `.get()` and `.set()` instead of reading or
+writing `.value` directly on Reanimated shared values. The compiler can't track
+property access—explicit methods ensure correct behavior.
+
+**Incorrect (breaks with React Compiler):**
+
+```tsx
+import { useSharedValue } from 'react-native-reanimated'
+
+function Counter() {
+  const count = useSharedValue(0)
+
+  const increment = () => {
+    count.value = count.value + 1 // opts out of react compiler
+  }
+
+  return <Button onPress={increment} title={`Count: ${count.value}`} />
+}
+```
+
+**Correct (React Compiler compatible):**
+
+```tsx
+import { useSharedValue } from 'react-native-reanimated'
+
+function Counter() {
+  const count = useSharedValue(0)
+
+  const increment = () => {
+    count.set(count.get() + 1)
+  }
+
+  return <Button onPress={increment} title={`Count: ${count.get()}`} />
+}
+```
+
+See the
+[Reanimated docs](https://docs.swmansion.com/react-native-reanimated/docs/core/useSharedValue/#react-compiler-support)
+for more.
diff --git a/.claude/skills/react-native-skills/rules/react-state-dispatcher.md b/.claude/skills/react-native-skills/rules/react-state-dispatcher.md
new file mode 100644
index 0000000..93e8b6d
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/react-state-dispatcher.md
@@ -0,0 +1,91 @@
+---
+title: useState Dispatch updaters for State That Depends on Current Value
+impact: MEDIUM
+impactDescription: avoids stale closures, prevents unnecessary re-renders
+tags: state, hooks, useState, callbacks
+---
+
+## Use Dispatch Updaters for State That Depends on Current Value
+
+When the next state depends on the current state, use a dispatch updater
+(`setState(prev => ...)`) instead of reading the state variable directly in a
+callback. This avoids stale closures and ensures you're comparing against the
+latest value.
+
+**Incorrect (reads state directly):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  // size may be stale in this closure
+  if (size?.width !== width || size?.height !== height) {
+    setSize({ width, height })
+  }
+}
+```
+
+**Correct (dispatch updater):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  setSize((prev) => {
+    if (prev?.width === width && prev?.height === height) return prev
+    return { width, height }
+  })
+}
+```
+
+Returning the previous value from the updater skips the re-render.
+
+For primitive states, you don't need to compare values before firing a
+re-render.
+
+**Incorrect (unnecessary comparison for primitive state):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  setSize((prev) => (prev === width ? prev : width))
+}
+```
+
+**Correct (sets primitive state directly):**
+
+```tsx
+const [size, setSize] = useState<Size | undefined>(undefined)
+
+const onLayout = (e: LayoutChangeEvent) => {
+  const { width, height } = e.nativeEvent.layout
+  setSize(width)
+}
+```
+
+However, if the next state depends on the current state, you should still use a
+dispatch updater.
+
+**Incorrect (reads state directly from the callback):**
+
+```tsx
+const [count, setCount] = useState(0)
+
+const onTap = () => {
+  setCount(count + 1)
+}
+```
+
+**Correct (dispatch updater):**
+
+```tsx
+const [count, setCount] = useState(0)
+
+const onTap = () => {
+  setCount((prev) => prev + 1)
+}
+```
diff --git a/.claude/skills/react-native-skills/rules/react-state-fallback.md b/.claude/skills/react-native-skills/rules/react-state-fallback.md
new file mode 100644
index 0000000..204f346
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/react-state-fallback.md
@@ -0,0 +1,56 @@
+---
+title: Use fallback state instead of initialState
+impact: MEDIUM
+impactDescription: reactive fallbacks without syncing
+tags: state, hooks, derived-state, props, initialState
+---
+
+## Use fallback state instead of initialState
+
+Use `undefined` as initial state and nullish coalescing (`??`) to fall back to
+parent or server values. State represents user intent only—`undefined` means
+"user hasn't chosen yet." This enables reactive fallbacks that update when the
+source changes, not just on initial render.
+
+**Incorrect (syncs state, loses reactivity):**
+
+```tsx
+type Props = { fallbackEnabled: boolean }
+
+function Toggle({ fallbackEnabled }: Props) {
+  const [enabled, setEnabled] = useState(defaultEnabled)
+  // If fallbackEnabled changes, state is stale
+  // State mixes user intent with default value
+
+  return <Switch value={enabled} onValueChange={setEnabled} />
+}
+```
+
+**Correct (state is user intent, reactive fallback):**
+
+```tsx
+type Props = { fallbackEnabled: boolean }
+
+function Toggle({ fallbackEnabled }: Props) {
+  const [_enabled, setEnabled] = useState<boolean | undefined>(undefined)
+  const enabled = _enabled ?? defaultEnabled
+  // undefined = user hasn't touched it, falls back to prop
+  // If defaultEnabled changes, component reflects it
+  // Once user interacts, their choice persists
+
+  return <Switch value={enabled} onValueChange={setEnabled} />
+}
+```
+
+**With server data:**
+
+```tsx
+function ProfileForm({ data }: { data: User }) {
+  const [_theme, setTheme] = useState<string | undefined>(undefined)
+  const theme = _theme ?? data.theme
+  // Shows server value until user overrides
+  // Server refetch updates the fallback automatically
+
+  return <ThemePicker value={theme} onChange={setTheme} />
+}
+```
diff --git a/.claude/skills/react-native-skills/rules/react-state-minimize.md b/.claude/skills/react-native-skills/rules/react-state-minimize.md
new file mode 100644
index 0000000..64605b6
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/react-state-minimize.md
@@ -0,0 +1,65 @@
+---
+title: Minimize State Variables and Derive Values
+impact: MEDIUM
+impactDescription: fewer re-renders, less state drift
+tags: state, derived-state, hooks, optimization
+---
+
+## Minimize State Variables and Derive Values
+
+Use the fewest state variables possible. If a value can be computed from existing state or props, derive it during render instead of storing it in state. Redundant state causes unnecessary re-renders and can drift out of sync.
+
+**Incorrect (redundant state):**
+
+```tsx
+function Cart({ items }: { items: Item[] }) {
+  const [total, setTotal] = useState(0)
+  const [itemCount, setItemCount] = useState(0)
+
+  useEffect(() => {
+    setTotal(items.reduce((sum, item) => sum + item.price, 0))
+    setItemCount(items.length)
+  }, [items])
+
+  return (
+    <View>
+      <Text>{itemCount} items</Text>
+      <Text>Total: ${total}</Text>
+    </View>
+  )
+}
+```
+
+**Correct (derived values):**
+
+```tsx
+function Cart({ items }: { items: Item[] }) {
+  const total = items.reduce((sum, item) => sum + item.price, 0)
+  const itemCount = items.length
+
+  return (
+    <View>
+      <Text>{itemCount} items</Text>
+      <Text>Total: ${total}</Text>
+    </View>
+  )
+}
+```
+
+**Another example:**
+
+```tsx
+// Incorrect: storing both firstName, lastName, AND fullName
+const [firstName, setFirstName] = useState('')
+const [lastName, setLastName] = useState('')
+const [fullName, setFullName] = useState('')
+
+// Correct: derive fullName
+const [firstName, setFirstName] = useState('')
+const [lastName, setLastName] = useState('')
+const fullName = `${firstName} ${lastName}`
+```
+
+State should be the minimal source of truth. Everything else is derived.
+
+Reference: [Choosing the State Structure](https://react.dev/learn/choosing-the-state-structure)
diff --git a/.claude/skills/react-native-skills/rules/rendering-no-falsy-and.md b/.claude/skills/react-native-skills/rules/rendering-no-falsy-and.md
new file mode 100644
index 0000000..30f05d3
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/rendering-no-falsy-and.md
@@ -0,0 +1,74 @@
+---
+title: Never Use && with Potentially Falsy Values
+impact: CRITICAL
+impactDescription: prevents production crash
+tags: rendering, conditional, jsx, crash
+---
+
+## Never Use && with Potentially Falsy Values
+
+Never use `{value && <Component />}` when `value` could be an empty string or
+`0`. These are falsy but JSX-renderable—React Native will try to render them as
+text outside a `<Text>` component, causing a hard crash in production.
+
+**Incorrect (crashes if count is 0 or name is ""):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  return (
+    <View>
+      {name && <Text>{name}</Text>}
+      {count && <Text>{count} items</Text>}
+    </View>
+  )
+}
+// If name="" or count=0, renders the falsy value → crash
+```
+
+**Correct (ternary with null):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  return (
+    <View>
+      {name ? <Text>{name}</Text> : null}
+      {count ? <Text>{count} items</Text> : null}
+    </View>
+  )
+}
+```
+
+**Correct (explicit boolean coercion):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  return (
+    <View>
+      {!!name && <Text>{name}</Text>}
+      {!!count && <Text>{count} items</Text>}
+    </View>
+  )
+}
+```
+
+**Best (early return):**
+
+```tsx
+function Profile({ name, count }: { name: string; count: number }) {
+  if (!name) return null
+
+  return (
+    <View>
+      <Text>{name}</Text>
+      {count > 0 ? <Text>{count} items</Text> : null}
+    </View>
+  )
+}
+```
+
+Early returns are clearest. When using conditionals inline, prefer ternary or
+explicit boolean checks.
+
+**Lint rule:** Enable `react/jsx-no-leaked-render` from
+[eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-no-leaked-render.md)
+to catch this automatically.
diff --git a/.claude/skills/react-native-skills/rules/rendering-text-in-text-component.md b/.claude/skills/react-native-skills/rules/rendering-text-in-text-component.md
new file mode 100644
index 0000000..fd1b9f4
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/rendering-text-in-text-component.md
@@ -0,0 +1,36 @@
+---
+title: Wrap Strings in Text Components
+impact: CRITICAL
+impactDescription: prevents runtime crash
+tags: rendering, text, core
+---
+
+## Wrap Strings in Text Components
+
+Strings must be rendered inside `<Text>`. React Native crashes if a string is a
+direct child of `<View>`.
+
+**Incorrect (crashes):**
+
+```tsx
+import { View } from 'react-native'
+
+function Greeting({ name }: { name: string }) {
+  return <View>Hello, {name}!</View>
+}
+// Error: Text strings must be rendered within a <Text> component.
+```
+
+**Correct:**
+
+```tsx
+import { View, Text } from 'react-native'
+
+function Greeting({ name }: { name: string }) {
+  return (
+    <View>
+      <Text>Hello, {name}!</Text>
+    </View>
+  )
+}
+```
diff --git a/.claude/skills/react-native-skills/rules/scroll-position-no-state.md b/.claude/skills/react-native-skills/rules/scroll-position-no-state.md
new file mode 100644
index 0000000..a5760cd
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/scroll-position-no-state.md
@@ -0,0 +1,82 @@
+---
+title: Never Track Scroll Position in useState
+impact: HIGH
+impactDescription: prevents render thrashing during scroll
+tags: scroll, performance, reanimated, useRef
+---
+
+## Never Track Scroll Position in useState
+
+Never store scroll position in `useState`. Scroll events fire rapidly—state
+updates cause render thrashing and dropped frames. Use a Reanimated shared value
+for animations or a ref for non-reactive tracking.
+
+**Incorrect (useState causes jank):**
+
+```tsx
+import { useState } from 'react'
+import {
+  ScrollView,
+  NativeSyntheticEvent,
+  NativeScrollEvent,
+} from 'react-native'
+
+function Feed() {
+  const [scrollY, setScrollY] = useState(0)
+
+  const onScroll = (e: NativeSyntheticEvent<NativeScrollEvent>) => {
+    setScrollY(e.nativeEvent.contentOffset.y) // re-renders on every frame
+  }
+
+  return <ScrollView onScroll={onScroll} scrollEventThrottle={16} />
+}
+```
+
+**Correct (Reanimated for animations):**
+
+```tsx
+import Animated, {
+  useSharedValue,
+  useAnimatedScrollHandler,
+} from 'react-native-reanimated'
+
+function Feed() {
+  const scrollY = useSharedValue(0)
+
+  const onScroll = useAnimatedScrollHandler({
+    onScroll: (e) => {
+      scrollY.value = e.contentOffset.y // runs on UI thread, no re-render
+    },
+  })
+
+  return (
+    <Animated.ScrollView
+      onScroll={onScroll}
+      // higher number has better performance, but it fires less often.
+      // unset this if you need higher precision over performance.
+      scrollEventThrottle={16}
+    />
+  )
+}
+```
+
+**Correct (ref for non-reactive tracking):**
+
+```tsx
+import { useRef } from 'react'
+import {
+  ScrollView,
+  NativeSyntheticEvent,
+  NativeScrollEvent,
+} from 'react-native'
+
+function Feed() {
+  const scrollY = useRef(0)
+
+  const onScroll = (e: NativeSyntheticEvent<NativeScrollEvent>) => {
+    scrollY.current = e.nativeEvent.contentOffset.y // no re-render
+  }
+
+  return <ScrollView onScroll={onScroll} scrollEventThrottle={16} />
+}
+```
diff --git a/.claude/skills/react-native-skills/rules/state-ground-truth.md b/.claude/skills/react-native-skills/rules/state-ground-truth.md
new file mode 100644
index 0000000..c3c4bd9
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/state-ground-truth.md
@@ -0,0 +1,80 @@
+---
+title: State Must Represent Ground Truth
+impact: HIGH
+impactDescription: cleaner logic, easier debugging, single source of truth
+tags: state, derived-state, reanimated, hooks
+---
+
+## State Must Represent Ground Truth
+
+State variables—both React `useState` and Reanimated shared values—should
+represent the actual state of something (e.g., `pressed`, `progress`, `isOpen`),
+not derived visual values (e.g., `scale`, `opacity`, `translateY`). Derive
+visual values from state using computation or interpolation.
+
+**Incorrect (storing the visual output):**
+
+```tsx
+const scale = useSharedValue(1)
+
+const tap = Gesture.Tap()
+  .onBegin(() => {
+    scale.set(withTiming(0.95))
+  })
+  .onFinalize(() => {
+    scale.set(withTiming(1))
+  })
+
+const animatedStyle = useAnimatedStyle(() => ({
+  transform: [{ scale: scale.get() }],
+}))
+```
+
+**Correct (storing the state, deriving the visual):**
+
+```tsx
+const pressed = useSharedValue(0) // 0 = not pressed, 1 = pressed
+
+const tap = Gesture.Tap()
+  .onBegin(() => {
+    pressed.set(withTiming(1))
+  })
+  .onFinalize(() => {
+    pressed.set(withTiming(0))
+  })
+
+const animatedStyle = useAnimatedStyle(() => ({
+  transform: [{ scale: interpolate(pressed.get(), [0, 1], [1, 0.95]) }],
+}))
+```
+
+**Why this matters:**
+
+State variables should represent real "state", not necessarily a desired end
+result.
+
+1. **Single source of truth** — The state (`pressed`) describes what's
+   happening; visuals are derived
+2. **Easier to extend** — Adding opacity, rotation, or other effects just
+   requires more interpolations from the same state
+3. **Debugging** — Inspecting `pressed = 1` is clearer than `scale = 0.95`
+4. **Reusable logic** — The same `pressed` value can drive multiple visual
+   properties
+
+**Same principle for React state:**
+
+```tsx
+// Incorrect: storing derived values
+const [isExpanded, setIsExpanded] = useState(false)
+const [height, setHeight] = useState(0)
+
+useEffect(() => {
+  setHeight(isExpanded ? 200 : 0)
+}, [isExpanded])
+
+// Correct: derive from state
+const [isExpanded, setIsExpanded] = useState(false)
+const height = isExpanded ? 200 : 0
+```
+
+State is the minimal truth. Everything else is derived.
diff --git a/.claude/skills/react-native-skills/rules/ui-expo-image.md b/.claude/skills/react-native-skills/rules/ui-expo-image.md
new file mode 100644
index 0000000..72d768f
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-expo-image.md
@@ -0,0 +1,66 @@
+---
+title: Use expo-image for Optimized Images
+impact: HIGH
+impactDescription: memory efficiency, caching, blurhash placeholders, progressive loading
+tags: images, performance, expo-image, ui
+---
+
+## Use expo-image for Optimized Images
+
+Use `expo-image` instead of React Native's `Image`. It provides memory-efficient caching, blurhash placeholders, progressive loading, and better performance for lists.
+
+**Incorrect (React Native Image):**
+
+```tsx
+import { Image } from 'react-native'
+
+function Avatar({ url }: { url: string }) {
+  return <Image source={{ uri: url }} style={styles.avatar} />
+}
+```
+
+**Correct (expo-image):**
+
+```tsx
+import { Image } from 'expo-image'
+
+function Avatar({ url }: { url: string }) {
+  return <Image source={{ uri: url }} style={styles.avatar} />
+}
+```
+
+**With blurhash placeholder:**
+
+```tsx
+<Image
+  source={{ uri: url }}
+  placeholder={{ blurhash: 'LGF5]+Yk^6#M@-5c,1J5@[or[Q6.' }}
+  contentFit="cover"
+  transition={200}
+  style={styles.image}
+/>
+```
+
+**With priority and caching:**
+
+```tsx
+<Image
+  source={{ uri: url }}
+  priority="high"
+  cachePolicy="memory-disk"
+  style={styles.hero}
+/>
+```
+
+**Key props:**
+
+- `placeholder` — Blurhash or thumbnail while loading
+- `contentFit` — `cover`, `contain`, `fill`, `scale-down`
+- `transition` — Fade-in duration (ms)
+- `priority` — `low`, `normal`, `high`
+- `cachePolicy` — `memory`, `disk`, `memory-disk`, `none`
+- `recyclingKey` — Unique key for list recycling
+
+For cross-platform (web + native), use `SolitoImage` from `solito/image` which uses `expo-image` under the hood.
+
+Reference: [expo-image](https://docs.expo.dev/versions/latest/sdk/image/)
diff --git a/.claude/skills/react-native-skills/rules/ui-image-gallery.md b/.claude/skills/react-native-skills/rules/ui-image-gallery.md
new file mode 100644
index 0000000..ef26d96
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-image-gallery.md
@@ -0,0 +1,104 @@
+---
+title: Use Galeria for Image Galleries and Lightbox
+impact: MEDIUM
+impactDescription:
+  native shared element transitions, pinch-to-zoom, pan-to-close
+tags: images, gallery, lightbox, expo-image, ui
+---
+
+## Use Galeria for Image Galleries and Lightbox
+
+For image galleries with lightbox (tap to fullscreen), use `@nandorojo/galeria`.
+It provides native shared element transitions with pinch-to-zoom, double-tap
+zoom, and pan-to-close. Works with any image component including `expo-image`.
+
+**Incorrect (custom modal implementation):**
+
+```tsx
+function ImageGallery({ urls }: { urls: string[] }) {
+  const [selected, setSelected] = useState<string | null>(null)
+
+  return (
+    <>
+      {urls.map((url) => (
+        <Pressable key={url} onPress={() => setSelected(url)}>
+          <Image source={{ uri: url }} style={styles.thumbnail} />
+        </Pressable>
+      ))}
+      <Modal visible={!!selected} onRequestClose={() => setSelected(null)}>
+        <Image source={{ uri: selected! }} style={styles.fullscreen} />
+      </Modal>
+    </>
+  )
+}
+```
+
+**Correct (Galeria with expo-image):**
+
+```tsx
+import { Galeria } from '@nandorojo/galeria'
+import { Image } from 'expo-image'
+
+function ImageGallery({ urls }: { urls: string[] }) {
+  return (
+    <Galeria urls={urls}>
+      {urls.map((url, index) => (
+        <Galeria.Image index={index} key={url}>
+          <Image source={{ uri: url }} style={styles.thumbnail} />
+        </Galeria.Image>
+      ))}
+    </Galeria>
+  )
+}
+```
+
+**Single image:**
+
+```tsx
+import { Galeria } from '@nandorojo/galeria'
+import { Image } from 'expo-image'
+
+function Avatar({ url }: { url: string }) {
+  return (
+    <Galeria urls={[url]}>
+      <Galeria.Image>
+        <Image source={{ uri: url }} style={styles.avatar} />
+      </Galeria.Image>
+    </Galeria>
+  )
+}
+```
+
+**With low-res thumbnails and high-res fullscreen:**
+
+```tsx
+<Galeria urls={highResUrls}>
+  {lowResUrls.map((url, index) => (
+    <Galeria.Image index={index} key={url}>
+      <Image source={{ uri: url }} style={styles.thumbnail} />
+    </Galeria.Image>
+  ))}
+</Galeria>
+```
+
+**With FlashList:**
+
+```tsx
+<Galeria urls={urls}>
+  <FlashList
+    data={urls}
+    renderItem={({ item, index }) => (
+      <Galeria.Image index={index}>
+        <Image source={{ uri: item }} style={styles.thumbnail} />
+      </Galeria.Image>
+    )}
+    numColumns={3}
+    estimatedItemSize={100}
+  />
+</Galeria>
+```
+
+Works with `expo-image`, `SolitoImage`, `react-native` Image, or any image
+component.
+
+Reference: [Galeria](https://github.com/nandorojo/galeria)
diff --git a/.claude/skills/react-native-skills/rules/ui-measure-views.md b/.claude/skills/react-native-skills/rules/ui-measure-views.md
new file mode 100644
index 0000000..8b783fe
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-measure-views.md
@@ -0,0 +1,78 @@
+---
+title: Measuring View Dimensions
+impact: MEDIUM
+impactDescription: synchronous measurement, avoid unnecessary re-renders
+tags: layout, measurement, onLayout, useLayoutEffect
+---
+
+## Measuring View Dimensions
+
+Use both `useLayoutEffect` (synchronous) and `onLayout` (for updates). The sync
+measurement gives you the initial size immediately; `onLayout` keeps it current
+when the view changes. For non-primitive states, use a dispatch updater to
+compare values and avoid unnecessary re-renders.
+
+**Height only:**
+
+```tsx
+import { useLayoutEffect, useRef, useState } from 'react'
+import { View, LayoutChangeEvent } from 'react-native'
+
+function MeasuredBox({ children }: { children: React.ReactNode }) {
+  const ref = useRef<View>(null)
+  const [height, setHeight] = useState<number | undefined>(undefined)
+
+  useLayoutEffect(() => {
+    // Sync measurement on mount (RN 0.82+)
+    const rect = ref.current?.getBoundingClientRect()
+    if (rect) setHeight(rect.height)
+    // Pre-0.82: ref.current?.measure((x, y, w, h) => setHeight(h))
+  }, [])
+
+  const onLayout = (e: LayoutChangeEvent) => {
+    setHeight(e.nativeEvent.layout.height)
+  }
+
+  return (
+    <View ref={ref} onLayout={onLayout}>
+      {children}
+    </View>
+  )
+}
+```
+
+**Both dimensions:**
+
+```tsx
+import { useLayoutEffect, useRef, useState } from 'react'
+import { View, LayoutChangeEvent } from 'react-native'
+
+type Size = { width: number; height: number }
+
+function MeasuredBox({ children }: { children: React.ReactNode }) {
+  const ref = useRef<View>(null)
+  const [size, setSize] = useState<Size | undefined>(undefined)
+
+  useLayoutEffect(() => {
+    const rect = ref.current?.getBoundingClientRect()
+    if (rect) setSize({ width: rect.width, height: rect.height })
+  }, [])
+
+  const onLayout = (e: LayoutChangeEvent) => {
+    const { width, height } = e.nativeEvent.layout
+    setSize((prev) => {
+      // for non-primitive states, compare values before firing a re-render
+      if (prev?.width === width && prev?.height === height) return prev
+      return { width, height }
+    })
+  }
+
+  return (
+    <View ref={ref} onLayout={onLayout}>
+      {children}
+    </View>
+  )
+}
+```
+
+Use functional setState to compare—don't read state directly in the callback.
diff --git a/.claude/skills/react-native-skills/rules/ui-menus.md b/.claude/skills/react-native-skills/rules/ui-menus.md
new file mode 100644
index 0000000..5168bc2
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-menus.md
@@ -0,0 +1,174 @@
+---
+title: Use Native Menus for Dropdowns and Context Menus
+impact: HIGH
+impactDescription: native accessibility, platform-consistent UX
+tags: user-interface, menus, context-menus, zeego, accessibility
+---
+
+## Use Native Menus for Dropdowns and Context Menus
+
+Use native platform menus instead of custom JS implementations. Native menus
+provide built-in accessibility, consistent platform UX, and better performance.
+Use [zeego](https://zeego.dev) for cross-platform native menus.
+
+**Incorrect (custom JS menu):**
+
+```tsx
+import { useState } from 'react'
+import { View, Pressable, Text } from 'react-native'
+
+function MyMenu() {
+  const [open, setOpen] = useState(false)
+
+  return (
+    <View>
+      <Pressable onPress={() => setOpen(!open)}>
+        <Text>Open Menu</Text>
+      </Pressable>
+      {open && (
+        <View style={{ position: 'absolute', top: 40 }}>
+          <Pressable onPress={() => console.log('edit')}>
+            <Text>Edit</Text>
+          </Pressable>
+          <Pressable onPress={() => console.log('delete')}>
+            <Text>Delete</Text>
+          </Pressable>
+        </View>
+      )}
+    </View>
+  )
+}
+```
+
+**Correct (native menu with zeego):**
+
+```tsx
+import * as DropdownMenu from 'zeego/dropdown-menu'
+
+function MyMenu() {
+  return (
+    <DropdownMenu.Root>
+      <DropdownMenu.Trigger>
+        <Pressable>
+          <Text>Open Menu</Text>
+        </Pressable>
+      </DropdownMenu.Trigger>
+
+      <DropdownMenu.Content>
+        <DropdownMenu.Item key='edit' onSelect={() => console.log('edit')}>
+          <DropdownMenu.ItemTitle>Edit</DropdownMenu.ItemTitle>
+        </DropdownMenu.Item>
+
+        <DropdownMenu.Item
+          key='delete'
+          destructive
+          onSelect={() => console.log('delete')}
+        >
+          <DropdownMenu.ItemTitle>Delete</DropdownMenu.ItemTitle>
+        </DropdownMenu.Item>
+      </DropdownMenu.Content>
+    </DropdownMenu.Root>
+  )
+}
+```
+
+**Context menu (long-press):**
+
+```tsx
+import * as ContextMenu from 'zeego/context-menu'
+
+function MyContextMenu() {
+  return (
+    <ContextMenu.Root>
+      <ContextMenu.Trigger>
+        <View style={{ padding: 20 }}>
+          <Text>Long press me</Text>
+        </View>
+      </ContextMenu.Trigger>
+
+      <ContextMenu.Content>
+        <ContextMenu.Item key='copy' onSelect={() => console.log('copy')}>
+          <ContextMenu.ItemTitle>Copy</ContextMenu.ItemTitle>
+        </ContextMenu.Item>
+
+        <ContextMenu.Item key='paste' onSelect={() => console.log('paste')}>
+          <ContextMenu.ItemTitle>Paste</ContextMenu.ItemTitle>
+        </ContextMenu.Item>
+      </ContextMenu.Content>
+    </ContextMenu.Root>
+  )
+}
+```
+
+**Checkbox items:**
+
+```tsx
+import * as DropdownMenu from 'zeego/dropdown-menu'
+
+function SettingsMenu() {
+  const [notifications, setNotifications] = useState(true)
+
+  return (
+    <DropdownMenu.Root>
+      <DropdownMenu.Trigger>
+        <Pressable>
+          <Text>Settings</Text>
+        </Pressable>
+      </DropdownMenu.Trigger>
+
+      <DropdownMenu.Content>
+        <DropdownMenu.CheckboxItem
+          key='notifications'
+          value={notifications}
+          onValueChange={() => setNotifications((prev) => !prev)}
+        >
+          <DropdownMenu.ItemIndicator />
+          <DropdownMenu.ItemTitle>Notifications</DropdownMenu.ItemTitle>
+        </DropdownMenu.CheckboxItem>
+      </DropdownMenu.Content>
+    </DropdownMenu.Root>
+  )
+}
+```
+
+**Submenus:**
+
+```tsx
+import * as DropdownMenu from 'zeego/dropdown-menu'
+
+function MenuWithSubmenu() {
+  return (
+    <DropdownMenu.Root>
+      <DropdownMenu.Trigger>
+        <Pressable>
+          <Text>Options</Text>
+        </Pressable>
+      </DropdownMenu.Trigger>
+
+      <DropdownMenu.Content>
+        <DropdownMenu.Item key='home' onSelect={() => console.log('home')}>
+          <DropdownMenu.ItemTitle>Home</DropdownMenu.ItemTitle>
+        </DropdownMenu.Item>
+
+        <DropdownMenu.Sub>
+          <DropdownMenu.SubTrigger key='more'>
+            <DropdownMenu.ItemTitle>More Options</DropdownMenu.ItemTitle>
+          </DropdownMenu.SubTrigger>
+
+          <DropdownMenu.SubContent>
+            <DropdownMenu.Item key='settings'>
+              <DropdownMenu.ItemTitle>Settings</DropdownMenu.ItemTitle>
+            </DropdownMenu.Item>
+
+            <DropdownMenu.Item key='help'>
+              <DropdownMenu.ItemTitle>Help</DropdownMenu.ItemTitle>
+            </DropdownMenu.Item>
+          </DropdownMenu.SubContent>
+        </DropdownMenu.Sub>
+      </DropdownMenu.Content>
+    </DropdownMenu.Root>
+  )
+}
+```
+
+Reference: [Zeego Documentation](https://zeego.dev/components/dropdown-menu)
diff --git a/.claude/skills/react-native-skills/rules/ui-native-modals.md b/.claude/skills/react-native-skills/rules/ui-native-modals.md
new file mode 100644
index 0000000..f560e11
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-native-modals.md
@@ -0,0 +1,77 @@
+---
+title: Use Native Modals Over JS-Based Bottom Sheets
+impact: HIGH
+impactDescription: native performance, gestures, accessibility
+tags: modals, bottom-sheet, native, react-navigation
+---
+
+## Use Native Modals Over JS-Based Bottom Sheets
+
+Use native `<Modal>` with `presentationStyle="formSheet"` or React Navigation
+v7's native form sheet instead of JS-based bottom sheet libraries. Native modals
+have built-in gestures, accessibility, and better performance. Rely on native UI
+for low-level primitives.
+
+**Incorrect (JS-based bottom sheet):**
+
+```tsx
+import BottomSheet from 'custom-js-bottom-sheet'
+
+function MyScreen() {
+  const sheetRef = useRef<BottomSheet>(null)
+
+  return (
+    <View style={{ flex: 1 }}>
+      <Button onPress={() => sheetRef.current?.expand()} title='Open' />
+      <BottomSheet ref={sheetRef} snapPoints={['50%', '90%']}>
+        <View>
+          <Text>Sheet content</Text>
+        </View>
+      </BottomSheet>
+    </View>
+  )
+}
+```
+
+**Correct (native Modal with formSheet):**
+
+```tsx
+import { Modal, View, Text, Button } from 'react-native'
+
+function MyScreen() {
+  const [visible, setVisible] = useState(false)
+
+  return (
+    <View style={{ flex: 1 }}>
+      <Button onPress={() => setVisible(true)} title='Open' />
+      <Modal
+        visible={visible}
+        presentationStyle='formSheet'
+        animationType='slide'
+        onRequestClose={() => setVisible(false)}
+      >
+        <View>
+          <Text>Sheet content</Text>
+        </View>
+      </Modal>
+    </View>
+  )
+}
+```
+
+**Correct (React Navigation v7 native form sheet):**
+
+```tsx
+// In your navigator
+<Stack.Screen
+  name='Details'
+  component={DetailsScreen}
+  options={{
+    presentation: 'formSheet',
+    sheetAllowedDetents: 'fitToContents',
+  }}
+/>
+```
+
+Native modals provide swipe-to-dismiss, proper keyboard avoidance, and
+accessibility out of the box.
diff --git a/.claude/skills/react-native-skills/rules/ui-pressable.md b/.claude/skills/react-native-skills/rules/ui-pressable.md
new file mode 100644
index 0000000..31c3d20
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-pressable.md
@@ -0,0 +1,61 @@
+---
+title: Use Pressable Instead of Touchable Components
+impact: LOW
+impactDescription: modern API, more flexible
+tags: ui, pressable, touchable, gestures
+---
+
+## Use Pressable Instead of Touchable Components
+
+Never use `TouchableOpacity` or `TouchableHighlight`. Use `Pressable` from
+`react-native` or `react-native-gesture-handler` instead.
+
+**Incorrect (legacy Touchable components):**
+
+```tsx
+import { TouchableOpacity } from 'react-native'
+
+function MyButton({ onPress }: { onPress: () => void }) {
+  return (
+    <TouchableOpacity onPress={onPress} activeOpacity={0.7}>
+      <Text>Press me</Text>
+    </TouchableOpacity>
+  )
+}
+```
+
+**Correct (Pressable):**
+
+```tsx
+import { Pressable } from 'react-native'
+
+function MyButton({ onPress }: { onPress: () => void }) {
+  return (
+    <Pressable onPress={onPress}>
+      <Text>Press me</Text>
+    </Pressable>
+  )
+}
+```
+
+**Correct (Pressable from gesture handler for lists):**
+
+```tsx
+import { Pressable } from 'react-native-gesture-handler'
+
+function ListItem({ onPress }: { onPress: () => void }) {
+  return (
+    <Pressable onPress={onPress}>
+      <Text>Item</Text>
+    </Pressable>
+  )
+}
+```
+
+Use `react-native-gesture-handler` Pressable inside scrollable lists for better
+gesture coordination, as long as you are using the ScrollView from
+`react-native-gesture-handler` as well.
+
+**For animated press states (scale, opacity changes):** Use `GestureDetector`
+with Reanimated shared values instead of Pressable's style callback. See the
+`animation-gesture-detector-press` rule.
diff --git a/.claude/skills/react-native-skills/rules/ui-safe-area-scroll.md b/.claude/skills/react-native-skills/rules/ui-safe-area-scroll.md
new file mode 100644
index 0000000..79812bc
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-safe-area-scroll.md
@@ -0,0 +1,65 @@
+---
+title: Use contentInsetAdjustmentBehavior for Safe Areas
+impact: MEDIUM
+impactDescription: native safe area handling, no layout shifts
+tags: safe-area, scrollview, layout
+---
+
+## Use contentInsetAdjustmentBehavior for Safe Areas
+
+Use `contentInsetAdjustmentBehavior="automatic"` on the root ScrollView instead of wrapping content in SafeAreaView or manual padding. This lets iOS handle safe area insets natively with proper scroll behavior.
+
+**Incorrect (SafeAreaView wrapper):**
+
+```tsx
+import { SafeAreaView, ScrollView, View, Text } from 'react-native'
+
+function MyScreen() {
+  return (
+    <SafeAreaView style={{ flex: 1 }}>
+      <ScrollView>
+        <View>
+          <Text>Content</Text>
+        </View>
+      </ScrollView>
+    </SafeAreaView>
+  )
+}
+```
+
+**Incorrect (manual safe area padding):**
+
+```tsx
+import { ScrollView, View, Text } from 'react-native'
+import { useSafeAreaInsets } from 'react-native-safe-area-context'
+
+function MyScreen() {
+  const insets = useSafeAreaInsets()
+
+  return (
+    <ScrollView contentContainerStyle={{ paddingTop: insets.top }}>
+      <View>
+        <Text>Content</Text>
+      </View>
+    </ScrollView>
+  )
+}
+```
+
+**Correct (native content inset adjustment):**
+
+```tsx
+import { ScrollView, View, Text } from 'react-native'
+
+function MyScreen() {
+  return (
+    <ScrollView contentInsetAdjustmentBehavior='automatic'>
+      <View>
+        <Text>Content</Text>
+      </View>
+    </ScrollView>
+  )
+}
+```
+
+The native approach handles dynamic safe areas (keyboard, toolbars) and allows content to scroll behind the status bar naturally.
diff --git a/.claude/skills/react-native-skills/rules/ui-scrollview-content-inset.md b/.claude/skills/react-native-skills/rules/ui-scrollview-content-inset.md
new file mode 100644
index 0000000..bbebc3b
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-scrollview-content-inset.md
@@ -0,0 +1,45 @@
+---
+title: Use contentInset for Dynamic ScrollView Spacing
+impact: LOW
+impactDescription: smoother updates, no layout recalculation
+tags: scrollview, layout, contentInset, performance
+---
+
+## Use contentInset for Dynamic ScrollView Spacing
+
+When adding space to the top or bottom of a ScrollView that may change
+(keyboard, toolbars, dynamic content), use `contentInset` instead of padding.
+Changing `contentInset` doesn't trigger layout recalculation—it adjusts the
+scroll area without re-rendering content.
+
+**Incorrect (padding causes layout recalculation):**
+
+```tsx
+function Feed({ bottomOffset }: { bottomOffset: number }) {
+  return (
+    <ScrollView contentContainerStyle={{ paddingBottom: bottomOffset }}>
+      {children}
+    </ScrollView>
+  )
+}
+// Changing bottomOffset triggers full layout recalculation
+```
+
+**Correct (contentInset for dynamic spacing):**
+
+```tsx
+function Feed({ bottomOffset }: { bottomOffset: number }) {
+  return (
+    <ScrollView
+      contentInset={{ bottom: bottomOffset }}
+      scrollIndicatorInsets={{ bottom: bottomOffset }}
+    >
+      {children}
+    </ScrollView>
+  )
+}
+// Changing bottomOffset only adjusts scroll bounds
+```
+
+Use `scrollIndicatorInsets` alongside `contentInset` to keep the scroll
+indicator aligned. For static spacing that never changes, padding is fine.
diff --git a/.claude/skills/react-native-skills/rules/ui-styling.md b/.claude/skills/react-native-skills/rules/ui-styling.md
new file mode 100644
index 0000000..3908de3
--- /dev/null
+++ b/.claude/skills/react-native-skills/rules/ui-styling.md
@@ -0,0 +1,87 @@
+---
+title: Modern React Native Styling Patterns
+impact: MEDIUM
+impactDescription: consistent design, smoother borders, cleaner layouts
+tags: styling, css, layout, shadows, gradients
+---
+
+## Modern React Native Styling Patterns
+
+Follow these styling patterns for cleaner, more consistent React Native code.
+
+**Always use `borderCurve: 'continuous'` with `borderRadius`:**
+
+```tsx
+// Incorrect
+{ borderRadius: 12 }
+
+// Correct – smoother iOS-style corners
+{ borderRadius: 12, borderCurve: 'continuous' }
+```
+
+**Use `gap` instead of margin for spacing between elements:**
+
+```tsx
+// Incorrect – margin on children
+<View>
+  <Text style={{ marginBottom: 8 }}>Title</Text>
+  <Text style={{ marginBottom: 8 }}>Subtitle</Text>
+</View>
+
+// Correct – gap on parent
+<View style={{ gap: 8 }}>
+  <Text>Title</Text>
+  <Text>Subtitle</Text>
+</View>
+```
+
+**Use `padding` for space within, `gap` for space between:**
+
+```tsx
+<View style={{ padding: 16, gap: 12 }}>
+  <Text>First</Text>
+  <Text>Second</Text>
+</View>
+```
+
+**Use `experimental_backgroundImage` for linear gradients:**
+
+```tsx
+// Incorrect – third-party gradient library
+<LinearGradient colors={['#000', '#fff']} />
+
+// Correct – native CSS gradient syntax
+<View
+  style={{
+    experimental_backgroundImage: 'linear-gradient(to bottom, #000, #fff)',
+  }}
+/>
+```
+
+**Use CSS `boxShadow` string syntax for shadows:**
+
+```tsx
+// Incorrect – legacy shadow objects or elevation
+{ shadowColor: '#000', shadowOffset: { width: 0, height: 2 }, shadowOpacity: 0.1 }
+{ elevation: 4 }
+
+// Correct – CSS box-shadow syntax
+{ boxShadow: '0 2px 8px rgba(0, 0, 0, 0.1)' }
+```
+
+**Avoid multiple font sizes – use weight and color for emphasis:**
+
+```tsx
+// Incorrect – varying font sizes for hierarchy
+<Text style={{ fontSize: 18 }}>Title</Text>
+<Text style={{ fontSize: 14 }}>Subtitle</Text>
+<Text style={{ fontSize: 12 }}>Caption</Text>
+
+// Correct – consistent size, vary weight and color
+<Text style={{ fontWeight: '600' }}>Title</Text>
+<Text style={{ color: '#666' }}>Subtitle</Text>
+<Text style={{ color: '#999' }}>Caption</Text>
+```
+
+Limiting font sizes creates visual consistency. Use `fontWeight` (bold/semibold)
+and grayscale colors for hierarchy instead.
diff --git a/.claude/skills/setup-matt-pocock-skills/SKILL.md b/.claude/skills/setup-matt-pocock-skills/SKILL.md
new file mode 100644
index 0000000..1ebc6e1
--- /dev/null
+++ b/.claude/skills/setup-matt-pocock-skills/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: setup-matt-pocock-skills
+description: Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
+disable-model-invocation: true
+---
+
+# Setup Matt Pocock's Skills
+
+Scaffold the per-repo configuration that the engineering skills assume:
+
+- **Issue tracker** — where issues live (GitHub by default; local markdown is also supported out of the box)
+- **Triage labels** — the strings used for the five canonical triage roles
+- **Domain docs** — where `CONTEXT.md` and ADRs live, and the consumer rules for reading them
+
+This is a prompt-driven skill, not a deterministic script. Explore, present what you found, confirm with the user, then write.
+
+## Process
+
+### 1. Explore
+
+Look at the current repo to understand its starting state. Read whatever exists; don't assume:
+
+- `git remote -v` and `.git/config` — is this a GitHub repo? Which one?
+- `AGENTS.md` and `CLAUDE.md` at the repo root — does either exist? Is there already an `## Agent skills` section in either?
+- `CONTEXT.md` and `CONTEXT-MAP.md` at the repo root
+- `docs/adr/` and any `src/*/docs/adr/` directories
+- `docs/agents/` — does this skill's prior output already exist?
+- `.scratch/` — sign that a local-markdown issue tracker convention is already in use
+
+### 2. Present findings and ask
+
+Summarise what's present and what's missing. Then walk the user through the three decisions **one at a time** — present a section, get the user's answer, then move to the next. Don't dump all three at once.
+
+Assume the user does not know what these terms mean. Each section starts with a short explainer (what it is, why these skills need it, what changes if they pick differently). Then show the choices and the default.
+
+**Section A — Issue tracker.**
+
+> Explainer: The "issue tracker" is where issues live for this repo. Skills like `to-issues`, `triage`, `to-prd`, and `qa` read from and write to it — they need to know whether to call `gh issue create`, write a markdown file under `.scratch/`, or follow some other workflow you describe. Pick the place you actually track work for this repo.
+
+Default posture: these skills were designed for GitHub. If a `git remote` points at GitHub, propose that. If a `git remote` points at GitLab (`gitlab.com` or a self-hosted host), propose GitLab. Otherwise (or if the user prefers), offer:
+
+- **GitHub** — issues live in the repo's GitHub Issues (uses the `gh` CLI)
+- **GitLab** — issues live in the repo's GitLab Issues (uses the [`glab`](https://gitlab.com/gitlab-org/cli) CLI)
+- **Local markdown** — issues live as files under `.scratch/<feature>/` in this repo (good for solo projects or repos without a remote)
+- **Other** (Jira, Linear, etc.) — ask the user to describe the workflow in one paragraph; the skill will record it as freeform prose
+
+**Section B — Triage label vocabulary.**
+
+> Explainer: When the `triage` skill processes an incoming issue, it moves it through a state machine — needs evaluation, waiting on reporter, ready for an AFK agent to pick up, ready for a human, or won't fix. To do that, it needs to apply labels (or the equivalent in your issue tracker) that match strings *you've actually configured*. If your repo already uses different label names (e.g. `bug:triage` instead of `needs-triage`), map them here so the skill applies the right ones instead of creating duplicates.
+
+The five canonical roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter
+- `ready-for-agent` — fully specified, AFK-ready (an agent can pick it up with no human context)
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Default: each role's string equals its name. Ask the user if they want to override any. If their issue tracker has no existing labels, the defaults are fine.
+
+**Section C — Domain docs.**
+
+> Explainer: Some skills (`improve-codebase-architecture`, `diagnose`, `tdd`) read a `CONTEXT.md` file to learn the project's domain language, and `docs/adr/` for past architectural decisions. They need to know whether the repo has one global context or multiple (e.g. a monorepo with separate frontend/backend contexts) so they look in the right place.
+
+Confirm the layout:
+
+- **Single-context** — one `CONTEXT.md` + `docs/adr/` at the repo root. Most repos are this.
+- **Multi-context** — `CONTEXT-MAP.md` at the root pointing to per-context `CONTEXT.md` files (typically a monorepo).
+
+### 3. Confirm and edit
+
+Show the user a draft of:
+
+- The `## Agent skills` block to add to whichever of `CLAUDE.md` / `AGENTS.md` is being edited (see step 4 for selection rules)
+- The contents of `docs/agents/issue-tracker.md`, `docs/agents/triage-labels.md`, `docs/agents/domain.md`
+
+Let them edit before writing.
+
+### 4. Write
+
+**Pick the file to edit:**
+
+- If `CLAUDE.md` exists, edit it.
+- Else if `AGENTS.md` exists, edit it.
+- If neither exists, ask the user which one to create — don't pick for them.
+
+Never create `AGENTS.md` when `CLAUDE.md` already exists (or vice versa) — always edit the one that's already there.
+
+If an `## Agent skills` block already exists in the chosen file, update its contents in-place rather than appending a duplicate. Don't overwrite user edits to the surrounding sections.
+
+The block:
+
+```markdown
+## Agent skills
+
+### Issue tracker
+
+[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
+```
+
+Then write the three docs files using the seed templates in this skill folder as a starting point:
+
+- [issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker
+- [issue-tracker-gitlab.md](./issue-tracker-gitlab.md) — GitLab issue tracker
+- [issue-tracker-local.md](./issue-tracker-local.md) — local-markdown issue tracker
+- [triage-labels.md](./triage-labels.md) — label mapping
+- [domain.md](./domain.md) — domain doc consumer rules + layout
+
+For "other" issue trackers, write `docs/agents/issue-tracker.md` from scratch using the user's description.
+
+### 5. Done
+
+Tell the user the setup is complete and which engineering skills will now read from these files. Mention they can edit `docs/agents/*.md` directly later — re-running this skill is only necessary if they want to switch issue trackers or restart from scratch.
diff --git a/.claude/skills/setup-matt-pocock-skills/domain.md b/.claude/skills/setup-matt-pocock-skills/domain.md
new file mode 100644
index 0000000..c97d6a6
--- /dev/null
+++ b/.claude/skills/setup-matt-pocock-skills/domain.md
@@ -0,0 +1,51 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT.md`** at the repo root, or
+- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The producer skill (`/grill-with-docs`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo (most repos):
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-event-sourced-orders.md
+│   └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/adr/                          ← system-wide decisions
+└── src/
+    ├── ordering/
+    │   ├── CONTEXT.md
+    │   └── docs/adr/                  ← context-specific decisions
+    └── billing/
+        ├── CONTEXT.md
+        └── docs/adr/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/grill-with-docs`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_
diff --git a/.claude/skills/setup-matt-pocock-skills/issue-tracker-github.md b/.claude/skills/setup-matt-pocock-skills/issue-tracker-github.md
new file mode 100644
index 0000000..cce77ec
--- /dev/null
+++ b/.claude/skills/setup-matt-pocock-skills/issue-tracker-github.md
@@ -0,0 +1,22 @@
+# Issue tracker: GitHub
+
+Issues and PRDs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
+
+Infer the repo from `git remote -v` — `gh` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitHub issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `gh issue view <number> --comments`.
diff --git a/.claude/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md b/.claude/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
new file mode 100644
index 0000000..f54da95
--- /dev/null
+++ b/.claude/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
@@ -0,0 +1,23 @@
+# Issue tracker: GitLab
+
+Issues and PRDs for this repo live as GitLab issues. Use the [`glab`](https://gitlab.com/gitlab-org/cli) CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `glab issue create --title "..." --description "..."`. Use a heredoc for multi-line descriptions. Pass `--description -` to open an editor.
+- **Read an issue**: `glab issue view <number> --comments`. Use `-F json` for machine-readable output.
+- **List issues**: `glab issue list -F json` with appropriate `--label` filters.
+- **Comment on an issue**: `glab issue note <number> --message "..."`. GitLab calls comments "notes".
+- **Apply / remove labels**: `glab issue update <number> --label "..."` / `--unlabel "..."`. Multiple labels can be comma-separated or by repeating the flag.
+- **Close**: `glab issue close <number>`. `glab issue close` does not accept a closing comment, so post the explanation first with `glab issue note <number> --message "..."`, then close.
+- **Merge requests**: GitLab calls PRs "merge requests". Use `glab mr create`, `glab mr view`, `glab mr note`, etc. — the same shape as `gh pr ...` with `mr` in place of `pr` and `note`/`--message` in place of `comment`/`--body`.
+
+Infer the repo from `git remote -v` — `glab` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitLab issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `glab issue view <number> --comments`.
diff --git a/.claude/skills/setup-matt-pocock-skills/issue-tracker-local.md b/.claude/skills/setup-matt-pocock-skills/issue-tracker-local.md
new file mode 100644
index 0000000..a2f08fb
--- /dev/null
+++ b/.claude/skills/setup-matt-pocock-skills/issue-tracker-local.md
@@ -0,0 +1,19 @@
+# Issue tracker: Local Markdown
+
+Issues and PRDs for this repo live as markdown files in `.scratch/`.
+
+## Conventions
+
+- One feature per directory: `.scratch/<feature-slug>/`
+- The PRD is `.scratch/<feature-slug>/PRD.md`
+- Implementation issues are `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01`
+- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
+- Comments and conversation history append to the bottom of the file under a `## Comments` heading
+
+## When a skill says "publish to the issue tracker"
+
+Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).
+
+## When a skill says "fetch the relevant ticket"
+
+Read the file at the referenced path. The user will normally pass the path or the issue number directly.
diff --git a/.claude/skills/setup-matt-pocock-skills/triage-labels.md b/.claude/skills/setup-matt-pocock-skills/triage-labels.md
new file mode 100644
index 0000000..b716855
--- /dev/null
+++ b/.claude/skills/setup-matt-pocock-skills/triage-labels.md
@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.
diff --git a/.claude/skills/skill-creator/LICENSE.txt b/.claude/skills/skill-creator/LICENSE.txt
new file mode 100644
index 0000000..7a4a3ea
--- /dev/null
+++ b/.claude/skills/skill-creator/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
\ No newline at end of file
diff --git a/.claude/skills/skill-creator/SKILL.md b/.claude/skills/skill-creator/SKILL.md
new file mode 100644
index 0000000..6399fa1
--- /dev/null
+++ b/.claude/skills/skill-creator/SKILL.md
@@ -0,0 +1,356 @@
+---
+name: skill-creator
+description: Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
+license: Complete terms in LICENSE.txt
+---
+
+# Skill Creator
+
+This skill provides guidance for creating effective skills.
+
+## About Skills
+
+Skills are modular, self-contained packages that extend Codex's capabilities by providing
+specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific
+domains or tasks—they transform Codex from a general-purpose agent into a specialized agent
+equipped with procedural knowledge that no model can fully possess.
+
+### What Skills Provide
+
+1. Specialized workflows - Multi-step procedures for specific domains
+2. Tool integrations - Instructions for working with specific file formats or APIs
+3. Domain expertise - Company-specific knowledge, schemas, business logic
+4. Bundled resources - Scripts, references, and assets for complex and repetitive tasks
+
+## Core Principles
+
+### Concise is Key
+
+The context window is a public good. Skills share the context window with everything else Codex needs: system prompt, conversation history, other Skills' metadata, and the actual user request.
+
+**Default assumption: Codex is already very smart.** Only add context Codex doesn't already have. Challenge each piece of information: "Does Codex really need this explanation?" and "Does this paragraph justify its token cost?"
+
+Prefer concise examples over verbose explanations.
+
+### Set Appropriate Degrees of Freedom
+
+Match the level of specificity to the task's fragility and variability:
+
+**High freedom (text-based instructions)**: Use when multiple approaches are valid, decisions depend on context, or heuristics guide the approach.
+
+**Medium freedom (pseudocode or scripts with parameters)**: Use when a preferred pattern exists, some variation is acceptable, or configuration affects behavior.
+
+**Low freedom (specific scripts, few parameters)**: Use when operations are fragile and error-prone, consistency is critical, or a specific sequence must be followed.
+
+Think of Codex as exploring a path: a narrow bridge with cliffs needs specific guardrails (low freedom), while an open field allows many routes (high freedom).
+
+### Anatomy of a Skill
+
+Every skill consists of a required SKILL.md file and optional bundled resources:
+
+```
+skill-name/
+├── SKILL.md (required)
+│   ├── YAML frontmatter metadata (required)
+│   │   ├── name: (required)
+│   │   └── description: (required)
+│   └── Markdown instructions (required)
+└── Bundled Resources (optional)
+    ├── scripts/          - Executable code (Python/Bash/etc.)
+    ├── references/       - Documentation intended to be loaded into context as needed
+    └── assets/           - Files used in output (templates, icons, fonts, etc.)
+```
+
+#### SKILL.md (required)
+
+Every SKILL.md consists of:
+
+- **Frontmatter** (YAML): Contains `name` and `description` fields. These are the only fields that Codex reads to determine when the skill gets used, thus it is very important to be clear and comprehensive in describing what the skill is, and when it should be used.
+- **Body** (Markdown): Instructions and guidance for using the skill. Only loaded AFTER the skill triggers (if at all).
+
+#### Bundled Resources (optional)
+
+##### Scripts (`scripts/`)
+
+Executable code (Python/Bash/etc.) for tasks that require deterministic reliability or are repeatedly rewritten.
+
+- **When to include**: When the same code is being rewritten repeatedly or deterministic reliability is needed
+- **Example**: `scripts/rotate_pdf.py` for PDF rotation tasks
+- **Benefits**: Token efficient, deterministic, may be executed without loading into context
+- **Note**: Scripts may still need to be read by Codex for patching or environment-specific adjustments
+
+##### References (`references/`)
+
+Documentation and reference material intended to be loaded as needed into context to inform Codex's process and thinking.
+
+- **When to include**: For documentation that Codex should reference while working
+- **Examples**: `references/finance.md` for financial schemas, `references/mnda.md` for company NDA template, `references/policies.md` for company policies, `references/api_docs.md` for API specifications
+- **Use cases**: Database schemas, API documentation, domain knowledge, company policies, detailed workflow guides
+- **Benefits**: Keeps SKILL.md lean, loaded only when Codex determines it's needed
+- **Best practice**: If files are large (>10k words), include grep search patterns in SKILL.md
+- **Avoid duplication**: Information should live in either SKILL.md or references files, not both. Prefer references files for detailed information unless it's truly core to the skill—this keeps SKILL.md lean while making information discoverable without hogging the context window. Keep only essential procedural instructions and workflow guidance in SKILL.md; move detailed reference material, schemas, and examples to references files.
+
+##### Assets (`assets/`)
+
+Files not intended to be loaded into context, but rather used within the output Codex produces.
+
+- **When to include**: When the skill needs files that will be used in the final output
+- **Examples**: `assets/logo.png` for brand assets, `assets/slides.pptx` for PowerPoint templates, `assets/frontend-template/` for HTML/React boilerplate, `assets/font.ttf` for typography
+- **Use cases**: Templates, images, icons, boilerplate code, fonts, sample documents that get copied or modified
+- **Benefits**: Separates output resources from documentation, enables Codex to use files without loading them into context
+
+#### What to Not Include in a Skill
+
+A skill should only contain essential files that directly support its functionality. Do NOT create extraneous documentation or auxiliary files, including:
+
+- README.md
+- INSTALLATION_GUIDE.md
+- QUICK_REFERENCE.md
+- CHANGELOG.md
+- etc.
+
+The skill should only contain the information needed for an AI agent to do the job at hand. It should not contain auxilary context about the process that went into creating it, setup and testing procedures, user-facing documentation, etc. Creating additional documentation files just adds clutter and confusion.
+
+### Progressive Disclosure Design Principle
+
+Skills use a three-level loading system to manage context efficiently:
+
+1. **Metadata (name + description)** - Always in context (~100 words)
+2. **SKILL.md body** - When skill triggers (<5k words)
+3. **Bundled resources** - As needed by Codex (Unlimited because scripts can be executed without reading into context window)
+
+#### Progressive Disclosure Patterns
+
+Keep SKILL.md body to the essentials and under 500 lines to minimize context bloat. Split content into separate files when approaching this limit. When splitting out content into other files, it is very important to reference them from SKILL.md and describe clearly when to read them, to ensure the reader of the skill knows they exist and when to use them.
+
+**Key principle:** When a skill supports multiple variations, frameworks, or options, keep only the core workflow and selection guidance in SKILL.md. Move variant-specific details (patterns, examples, configuration) into separate reference files.
+
+**Pattern 1: High-level guide with references**
+
+```markdown
+# PDF Processing
+
+## Quick start
+
+Extract text with pdfplumber:
+[code example]
+
+## Advanced features
+
+- **Form filling**: See [FORMS.md](FORMS.md) for complete guide
+- **API reference**: See [REFERENCE.md](REFERENCE.md) for all methods
+- **Examples**: See [EXAMPLES.md](EXAMPLES.md) for common patterns
+```
+
+Codex loads FORMS.md, REFERENCE.md, or EXAMPLES.md only when needed.
+
+**Pattern 2: Domain-specific organization**
+
+For Skills with multiple domains, organize content by domain to avoid loading irrelevant context:
+
+```
+bigquery-skill/
+├── SKILL.md (overview and navigation)
+└── reference/
+    ├── finance.md (revenue, billing metrics)
+    ├── sales.md (opportunities, pipeline)
+    ├── product.md (API usage, features)
+    └── marketing.md (campaigns, attribution)
+```
+
+When a user asks about sales metrics, Codex only reads sales.md.
+
+Similarly, for skills supporting multiple frameworks or variants, organize by variant:
+
+```
+cloud-deploy/
+├── SKILL.md (workflow + provider selection)
+└── references/
+    ├── aws.md (AWS deployment patterns)
+    ├── gcp.md (GCP deployment patterns)
+    └── azure.md (Azure deployment patterns)
+```
+
+When the user chooses AWS, Codex only reads aws.md.
+
+**Pattern 3: Conditional details**
+
+Show basic content, link to advanced content:
+
+```markdown
+# DOCX Processing
+
+## Creating documents
+
+Use docx-js for new documents. See [DOCX-JS.md](DOCX-JS.md).
+
+## Editing documents
+
+For simple edits, modify the XML directly.
+
+**For tracked changes**: See [REDLINING.md](REDLINING.md)
+**For OOXML details**: See [OOXML.md](OOXML.md)
+```
+
+Codex reads REDLINING.md or OOXML.md only when the user needs those features.
+
+**Important guidelines:**
+
+- **Avoid deeply nested references** - Keep references one level deep from SKILL.md. All reference files should link directly from SKILL.md.
+- **Structure longer reference files** - For files longer than 100 lines, include a table of contents at the top so Codex can see the full scope when previewing.
+
+## Skill Creation Process
+
+Skill creation involves these steps:
+
+1. Understand the skill with concrete examples
+2. Plan reusable skill contents (scripts, references, assets)
+3. Initialize the skill (run init_skill.py)
+4. Edit the skill (implement resources and write SKILL.md)
+5. Package the skill (run package_skill.py)
+6. Iterate based on real usage
+
+Follow these steps in order, skipping only if there is a clear reason why they are not applicable.
+
+### Step 1: Understanding the Skill with Concrete Examples
+
+Skip this step only when the skill's usage patterns are already clearly understood. It remains valuable even when working with an existing skill.
+
+To create an effective skill, clearly understand concrete examples of how the skill will be used. This understanding can come from either direct user examples or generated examples that are validated with user feedback.
+
+For example, when building an image-editor skill, relevant questions include:
+
+- "What functionality should the image-editor skill support? Editing, rotating, anything else?"
+- "Can you give some examples of how this skill would be used?"
+- "I can imagine users asking for things like 'Remove the red-eye from this image' or 'Rotate this image'. Are there other ways you imagine this skill being used?"
+- "What would a user say that should trigger this skill?"
+
+To avoid overwhelming users, avoid asking too many questions in a single message. Start with the most important questions and follow up as needed for better effectiveness.
+
+Conclude this step when there is a clear sense of the functionality the skill should support.
+
+### Step 2: Planning the Reusable Skill Contents
+
+To turn concrete examples into an effective skill, analyze each example by:
+
+1. Considering how to execute on the example from scratch
+2. Identifying what scripts, references, and assets would be helpful when executing these workflows repeatedly
+
+Example: When building a `pdf-editor` skill to handle queries like "Help me rotate this PDF," the analysis shows:
+
+1. Rotating a PDF requires re-writing the same code each time
+2. A `scripts/rotate_pdf.py` script would be helpful to store in the skill
+
+Example: When designing a `frontend-webapp-builder` skill for queries like "Build me a todo app" or "Build me a dashboard to track my steps," the analysis shows:
+
+1. Writing a frontend webapp requires the same boilerplate HTML/React each time
+2. An `assets/hello-world/` template containing the boilerplate HTML/React project files would be helpful to store in the skill
+
+Example: When building a `big-query` skill to handle queries like "How many users have logged in today?" the analysis shows:
+
+1. Querying BigQuery requires re-discovering the table schemas and relationships each time
+2. A `references/schema.md` file documenting the table schemas would be helpful to store in the skill
+
+To establish the skill's contents, analyze each concrete example to create a list of the reusable resources to include: scripts, references, and assets.
+
+### Step 3: Initializing the Skill
+
+At this point, it is time to actually create the skill.
+
+Skip this step only if the skill being developed already exists, and iteration or packaging is needed. In this case, continue to the next step.
+
+When creating a new skill from scratch, always run the `init_skill.py` script. The script conveniently generates a new template skill directory that automatically includes everything a skill requires, making the skill creation process much more efficient and reliable.
+
+Usage:
+
+```bash
+scripts/init_skill.py <skill-name> --path <output-directory>
+```
+
+The script:
+
+- Creates the skill directory at the specified path
+- Generates a SKILL.md template with proper frontmatter and TODO placeholders
+- Creates example resource directories: `scripts/`, `references/`, and `assets/`
+- Adds example files in each directory that can be customized or deleted
+
+After initialization, customize or remove the generated SKILL.md and example files as needed.
+
+### Step 4: Edit the Skill
+
+When editing the (newly-generated or existing) skill, remember that the skill is being created for another instance of Codex to use. Include information that would be beneficial and non-obvious to Codex. Consider what procedural knowledge, domain-specific details, or reusable assets would help another Codex instance execute these tasks more effectively.
+
+#### Learn Proven Design Patterns
+
+Consult these helpful guides based on your skill's needs:
+
+- **Multi-step processes**: See references/workflows.md for sequential workflows and conditional logic
+- **Specific output formats or quality standards**: See references/output-patterns.md for template and example patterns
+
+These files contain established best practices for effective skill design.
+
+#### Start with Reusable Skill Contents
+
+To begin implementation, start with the reusable resources identified above: `scripts/`, `references/`, and `assets/` files. Note that this step may require user input. For example, when implementing a `brand-guidelines` skill, the user may need to provide brand assets or templates to store in `assets/`, or documentation to store in `references/`.
+
+Added scripts must be tested by actually running them to ensure there are no bugs and that the output matches what is expected. If there are many similar scripts, only a representative sample needs to be tested to ensure confidence that they all work while balancing time to completion.
+
+Any example files and directories not needed for the skill should be deleted. The initialization script creates example files in `scripts/`, `references/`, and `assets/` to demonstrate structure, but most skills won't need all of them.
+
+#### Update SKILL.md
+
+**Writing Guidelines:** Always use imperative/infinitive form.
+
+##### Frontmatter
+
+Write the YAML frontmatter with `name` and `description`:
+
+- `name`: The skill name
+- `description`: This is the primary triggering mechanism for your skill, and helps Codex understand when to use the skill.
+  - Include both what the Skill does and specific triggers/contexts for when to use it.
+  - Include all "when to use" information here - Not in the body. The body is only loaded after triggering, so "When to Use This Skill" sections in the body are not helpful to Codex.
+  - Example description for a `docx` skill: "Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. Use when Codex needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks"
+
+Do not include any other fields in YAML frontmatter.
+
+##### Body
+
+Write instructions for using the skill and its bundled resources.
+
+### Step 5: Packaging a Skill
+
+Once development of the skill is complete, it must be packaged into a distributable .skill file that gets shared with the user. The packaging process automatically validates the skill first to ensure it meets all requirements:
+
+```bash
+scripts/package_skill.py <path/to/skill-folder>
+```
+
+Optional output directory specification:
+
+```bash
+scripts/package_skill.py <path/to/skill-folder> ./dist
+```
+
+The packaging script will:
+
+1. **Validate** the skill automatically, checking:
+
+   - YAML frontmatter format and required fields
+   - Skill naming conventions and directory structure
+   - Description completeness and quality
+   - File organization and resource references
+
+2. **Package** the skill if validation passes, creating a .skill file named after the skill (e.g., `my-skill.skill`) that includes all files and maintains the proper directory structure for distribution. The .skill file is a zip file with a .skill extension.
+
+If validation fails, the script will report the errors and exit without creating a package. Fix any validation errors and run the packaging command again.
+
+### Step 6: Iterate
+
+After testing the skill, users may request improvements. Often this happens right after using the skill, with fresh context of how the skill performed.
+
+**Iteration workflow:**
+
+1. Use the skill on real tasks
+2. Notice struggles or inefficiencies
+3. Identify how SKILL.md or bundled resources should be updated
+4. Implement changes and test again
diff --git a/.claude/skills/skill-creator/references/output-patterns.md b/.claude/skills/skill-creator/references/output-patterns.md
new file mode 100644
index 0000000..073ddda
--- /dev/null
+++ b/.claude/skills/skill-creator/references/output-patterns.md
@@ -0,0 +1,82 @@
+# Output Patterns
+
+Use these patterns when skills need to produce consistent, high-quality output.
+
+## Template Pattern
+
+Provide templates for output format. Match the level of strictness to your needs.
+
+**For strict requirements (like API responses or data formats):**
+
+```markdown
+## Report structure
+
+ALWAYS use this exact template structure:
+
+# [Analysis Title]
+
+## Executive summary
+[One-paragraph overview of key findings]
+
+## Key findings
+- Finding 1 with supporting data
+- Finding 2 with supporting data
+- Finding 3 with supporting data
+
+## Recommendations
+1. Specific actionable recommendation
+2. Specific actionable recommendation
+```
+
+**For flexible guidance (when adaptation is useful):**
+
+```markdown
+## Report structure
+
+Here is a sensible default format, but use your best judgment:
+
+# [Analysis Title]
+
+## Executive summary
+[Overview]
+
+## Key findings
+[Adapt sections based on what you discover]
+
+## Recommendations
+[Tailor to the specific context]
+
+Adjust sections as needed for the specific analysis type.
+```
+
+## Examples Pattern
+
+For skills where output quality depends on seeing examples, provide input/output pairs:
+
+```markdown
+## Commit message format
+
+Generate commit messages following these examples:
+
+**Example 1:**
+Input: Added user authentication with JWT tokens
+Output:
+```
+feat(auth): implement JWT-based authentication
+
+Add login endpoint and token validation middleware
+```
+
+**Example 2:**
+Input: Fixed bug where dates displayed incorrectly in reports
+Output:
+```
+fix(reports): correct date formatting in timezone conversion
+
+Use UTC timestamps consistently across report generation
+```
+
+Follow this style: type(scope): brief description, then detailed explanation.
+```
+
+Examples help Claude understand the desired style and level of detail more clearly than descriptions alone.
diff --git a/.claude/skills/skill-creator/references/workflows.md b/.claude/skills/skill-creator/references/workflows.md
new file mode 100644
index 0000000..a350c3c
--- /dev/null
+++ b/.claude/skills/skill-creator/references/workflows.md
@@ -0,0 +1,28 @@
+# Workflow Patterns
+
+## Sequential Workflows
+
+For complex tasks, break operations into clear, sequential steps. It is often helpful to give Claude an overview of the process towards the beginning of SKILL.md:
+
+```markdown
+Filling a PDF form involves these steps:
+
+1. Analyze the form (run analyze_form.py)
+2. Create field mapping (edit fields.json)
+3. Validate mapping (run validate_fields.py)
+4. Fill the form (run fill_form.py)
+5. Verify output (run verify_output.py)
+```
+
+## Conditional Workflows
+
+For tasks with branching logic, guide Claude through decision points:
+
+```markdown
+1. Determine the modification type:
+   **Creating new content?** → Follow "Creation workflow" below
+   **Editing existing content?** → Follow "Editing workflow" below
+
+2. Creation workflow: [steps]
+3. Editing workflow: [steps]
+```
\ No newline at end of file
diff --git a/.claude/skills/skill-creator/scripts/init_skill.py b/.claude/skills/skill-creator/scripts/init_skill.py
new file mode 100644
index 0000000..329ad4e
--- /dev/null
+++ b/.claude/skills/skill-creator/scripts/init_skill.py
@@ -0,0 +1,303 @@
+#!/usr/bin/env python3
+"""
+Skill Initializer - Creates a new skill from template
+
+Usage:
+    init_skill.py <skill-name> --path <path>
+
+Examples:
+    init_skill.py my-new-skill --path skills/public
+    init_skill.py my-api-helper --path skills/private
+    init_skill.py custom-skill --path /custom/location
+"""
+
+import sys
+from pathlib import Path
+
+
+SKILL_TEMPLATE = """---
+name: {skill_name}
+description: [TODO: Complete and informative explanation of what the skill does and when to use it. Include WHEN to use this skill - specific scenarios, file types, or tasks that trigger it.]
+---
+
+# {skill_title}
+
+## Overview
+
+[TODO: 1-2 sentences explaining what this skill enables]
+
+## Structuring This Skill
+
+[TODO: Choose the structure that best fits this skill's purpose. Common patterns:
+
+**1. Workflow-Based** (best for sequential processes)
+- Works well when there are clear step-by-step procedures
+- Example: DOCX skill with "Workflow Decision Tree" → "Reading" → "Creating" → "Editing"
+- Structure: ## Overview → ## Workflow Decision Tree → ## Step 1 → ## Step 2...
+
+**2. Task-Based** (best for tool collections)
+- Works well when the skill offers different operations/capabilities
+- Example: PDF skill with "Quick Start" → "Merge PDFs" → "Split PDFs" → "Extract Text"
+- Structure: ## Overview → ## Quick Start → ## Task Category 1 → ## Task Category 2...
+
+**3. Reference/Guidelines** (best for standards or specifications)
+- Works well for brand guidelines, coding standards, or requirements
+- Example: Brand styling with "Brand Guidelines" → "Colors" → "Typography" → "Features"
+- Structure: ## Overview → ## Guidelines → ## Specifications → ## Usage...
+
+**4. Capabilities-Based** (best for integrated systems)
+- Works well when the skill provides multiple interrelated features
+- Example: Product Management with "Core Capabilities" → numbered capability list
+- Structure: ## Overview → ## Core Capabilities → ### 1. Feature → ### 2. Feature...
+
+Patterns can be mixed and matched as needed. Most skills combine patterns (e.g., start with task-based, add workflow for complex operations).
+
+Delete this entire "Structuring This Skill" section when done - it's just guidance.]
+
+## [TODO: Replace with the first main section based on chosen structure]
+
+[TODO: Add content here. See examples in existing skills:
+- Code samples for technical skills
+- Decision trees for complex workflows
+- Concrete examples with realistic user requests
+- References to scripts/templates/references as needed]
+
+## Resources
+
+This skill includes example resource directories that demonstrate how to organize different types of bundled resources:
+
+### scripts/
+Executable code (Python/Bash/etc.) that can be run directly to perform specific operations.
+
+**Examples from other skills:**
+- PDF skill: `fill_fillable_fields.py`, `extract_form_field_info.py` - utilities for PDF manipulation
+- DOCX skill: `document.py`, `utilities.py` - Python modules for document processing
+
+**Appropriate for:** Python scripts, shell scripts, or any executable code that performs automation, data processing, or specific operations.
+
+**Note:** Scripts may be executed without loading into context, but can still be read by Claude for patching or environment adjustments.
+
+### references/
+Documentation and reference material intended to be loaded into context to inform Claude's process and thinking.
+
+**Examples from other skills:**
+- Product management: `communication.md`, `context_building.md` - detailed workflow guides
+- BigQuery: API reference documentation and query examples
+- Finance: Schema documentation, company policies
+
+**Appropriate for:** In-depth documentation, API references, database schemas, comprehensive guides, or any detailed information that Claude should reference while working.
+
+### assets/
+Files not intended to be loaded into context, but rather used within the output Claude produces.
+
+**Examples from other skills:**
+- Brand styling: PowerPoint template files (.pptx), logo files
+- Frontend builder: HTML/React boilerplate project directories
+- Typography: Font files (.ttf, .woff2)
+
+**Appropriate for:** Templates, boilerplate code, document templates, images, icons, fonts, or any files meant to be copied or used in the final output.
+
+---
+
+**Any unneeded directories can be deleted.** Not every skill requires all three types of resources.
+"""
+
+EXAMPLE_SCRIPT = '''#!/usr/bin/env python3
+"""
+Example helper script for {skill_name}
+
+This is a placeholder script that can be executed directly.
+Replace with actual implementation or delete if not needed.
+
+Example real scripts from other skills:
+- pdf/scripts/fill_fillable_fields.py - Fills PDF form fields
+- pdf/scripts/convert_pdf_to_images.py - Converts PDF pages to images
+"""
+
+def main():
+    print("This is an example script for {skill_name}")
+    # TODO: Add actual script logic here
+    # This could be data processing, file conversion, API calls, etc.
+
+if __name__ == "__main__":
+    main()
+'''
+
+EXAMPLE_REFERENCE = """# Reference Documentation for {skill_title}
+
+This is a placeholder for detailed reference documentation.
+Replace with actual reference content or delete if not needed.
+
+Example real reference docs from other skills:
+- product-management/references/communication.md - Comprehensive guide for status updates
+- product-management/references/context_building.md - Deep-dive on gathering context
+- bigquery/references/ - API references and query examples
+
+## When Reference Docs Are Useful
+
+Reference docs are ideal for:
+- Comprehensive API documentation
+- Detailed workflow guides
+- Complex multi-step processes
+- Information too lengthy for main SKILL.md
+- Content that's only needed for specific use cases
+
+## Structure Suggestions
+
+### API Reference Example
+- Overview
+- Authentication
+- Endpoints with examples
+- Error codes
+- Rate limits
+
+### Workflow Guide Example
+- Prerequisites
+- Step-by-step instructions
+- Common patterns
+- Troubleshooting
+- Best practices
+"""
+
+EXAMPLE_ASSET = """# Example Asset File
+
+This placeholder represents where asset files would be stored.
+Replace with actual asset files (templates, images, fonts, etc.) or delete if not needed.
+
+Asset files are NOT intended to be loaded into context, but rather used within
+the output Claude produces.
+
+Example asset files from other skills:
+- Brand guidelines: logo.png, slides_template.pptx
+- Frontend builder: hello-world/ directory with HTML/React boilerplate
+- Typography: custom-font.ttf, font-family.woff2
+- Data: sample_data.csv, test_dataset.json
+
+## Common Asset Types
+
+- Templates: .pptx, .docx, boilerplate directories
+- Images: .png, .jpg, .svg, .gif
+- Fonts: .ttf, .otf, .woff, .woff2
+- Boilerplate code: Project directories, starter files
+- Icons: .ico, .svg
+- Data files: .csv, .json, .xml, .yaml
+
+Note: This is a text placeholder. Actual assets can be any file type.
+"""
+
+
+def title_case_skill_name(skill_name):
+    """Convert hyphenated skill name to Title Case for display."""
+    return ' '.join(word.capitalize() for word in skill_name.split('-'))
+
+
+def init_skill(skill_name, path):
+    """
+    Initialize a new skill directory with template SKILL.md.
+
+    Args:
+        skill_name: Name of the skill
+        path: Path where the skill directory should be created
+
+    Returns:
+        Path to created skill directory, or None if error
+    """
+    # Determine skill directory path
+    skill_dir = Path(path).resolve() / skill_name
+
+    # Check if directory already exists
+    if skill_dir.exists():
+        print(f"❌ Error: Skill directory already exists: {skill_dir}")
+        return None
+
+    # Create skill directory
+    try:
+        skill_dir.mkdir(parents=True, exist_ok=False)
+        print(f"✅ Created skill directory: {skill_dir}")
+    except Exception as e:
+        print(f"❌ Error creating directory: {e}")
+        return None
+
+    # Create SKILL.md from template
+    skill_title = title_case_skill_name(skill_name)
+    skill_content = SKILL_TEMPLATE.format(
+        skill_name=skill_name,
+        skill_title=skill_title
+    )
+
+    skill_md_path = skill_dir / 'SKILL.md'
+    try:
+        skill_md_path.write_text(skill_content)
+        print("✅ Created SKILL.md")
+    except Exception as e:
+        print(f"❌ Error creating SKILL.md: {e}")
+        return None
+
+    # Create resource directories with example files
+    try:
+        # Create scripts/ directory with example script
+        scripts_dir = skill_dir / 'scripts'
+        scripts_dir.mkdir(exist_ok=True)
+        example_script = scripts_dir / 'example.py'
+        example_script.write_text(EXAMPLE_SCRIPT.format(skill_name=skill_name))
+        example_script.chmod(0o755)
+        print("✅ Created scripts/example.py")
+
+        # Create references/ directory with example reference doc
+        references_dir = skill_dir / 'references'
+        references_dir.mkdir(exist_ok=True)
+        example_reference = references_dir / 'api_reference.md'
+        example_reference.write_text(EXAMPLE_REFERENCE.format(skill_title=skill_title))
+        print("✅ Created references/api_reference.md")
+
+        # Create assets/ directory with example asset placeholder
+        assets_dir = skill_dir / 'assets'
+        assets_dir.mkdir(exist_ok=True)
+        example_asset = assets_dir / 'example_asset.txt'
+        example_asset.write_text(EXAMPLE_ASSET)
+        print("✅ Created assets/example_asset.txt")
+    except Exception as e:
+        print(f"❌ Error creating resource directories: {e}")
+        return None
+
+    # Print next steps
+    print(f"\n✅ Skill '{skill_name}' initialized successfully at {skill_dir}")
+    print("\nNext steps:")
+    print("1. Edit SKILL.md to complete the TODO items and update the description")
+    print("2. Customize or delete the example files in scripts/, references/, and assets/")
+    print("3. Run the validator when ready to check the skill structure")
+
+    return skill_dir
+
+
+def main():
+    if len(sys.argv) < 4 or sys.argv[2] != '--path':
+        print("Usage: init_skill.py <skill-name> --path <path>")
+        print("\nSkill name requirements:")
+        print("  - Hyphen-case identifier (e.g., 'data-analyzer')")
+        print("  - Lowercase letters, digits, and hyphens only")
+        print("  - Max 40 characters")
+        print("  - Must match directory name exactly")
+        print("\nExamples:")
+        print("  init_skill.py my-new-skill --path skills/public")
+        print("  init_skill.py my-api-helper --path skills/private")
+        print("  init_skill.py custom-skill --path /custom/location")
+        sys.exit(1)
+
+    skill_name = sys.argv[1]
+    path = sys.argv[3]
+
+    print(f"🚀 Initializing skill: {skill_name}")
+    print(f"   Location: {path}")
+    print()
+
+    result = init_skill(skill_name, path)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/.claude/skills/skill-creator/scripts/package_skill.py b/.claude/skills/skill-creator/scripts/package_skill.py
new file mode 100644
index 0000000..5cd36cb
--- /dev/null
+++ b/.claude/skills/skill-creator/scripts/package_skill.py
@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""
+Skill Packager - Creates a distributable .skill file of a skill folder
+
+Usage:
+    python utils/package_skill.py <path/to/skill-folder> [output-directory]
+
+Example:
+    python utils/package_skill.py skills/public/my-skill
+    python utils/package_skill.py skills/public/my-skill ./dist
+"""
+
+import sys
+import zipfile
+from pathlib import Path
+from quick_validate import validate_skill
+
+
+def package_skill(skill_path, output_dir=None):
+    """
+    Package a skill folder into a .skill file.
+
+    Args:
+        skill_path: Path to the skill folder
+        output_dir: Optional output directory for the .skill file (defaults to current directory)
+
+    Returns:
+        Path to the created .skill file, or None if error
+    """
+    skill_path = Path(skill_path).resolve()
+
+    # Validate skill folder exists
+    if not skill_path.exists():
+        print(f"❌ Error: Skill folder not found: {skill_path}")
+        return None
+
+    if not skill_path.is_dir():
+        print(f"❌ Error: Path is not a directory: {skill_path}")
+        return None
+
+    # Validate SKILL.md exists
+    skill_md = skill_path / "SKILL.md"
+    if not skill_md.exists():
+        print(f"❌ Error: SKILL.md not found in {skill_path}")
+        return None
+
+    # Run validation before packaging
+    print("🔍 Validating skill...")
+    valid, message = validate_skill(skill_path)
+    if not valid:
+        print(f"❌ Validation failed: {message}")
+        print("   Please fix the validation errors before packaging.")
+        return None
+    print(f"✅ {message}\n")
+
+    # Determine output location
+    skill_name = skill_path.name
+    if output_dir:
+        output_path = Path(output_dir).resolve()
+        output_path.mkdir(parents=True, exist_ok=True)
+    else:
+        output_path = Path.cwd()
+
+    skill_filename = output_path / f"{skill_name}.skill"
+
+    # Create the .skill file (zip format)
+    try:
+        with zipfile.ZipFile(skill_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
+            # Walk through the skill directory
+            for file_path in skill_path.rglob('*'):
+                if file_path.is_file():
+                    # Calculate the relative path within the zip
+                    arcname = file_path.relative_to(skill_path.parent)
+                    zipf.write(file_path, arcname)
+                    print(f"  Added: {arcname}")
+
+        print(f"\n✅ Successfully packaged skill to: {skill_filename}")
+        return skill_filename
+
+    except Exception as e:
+        print(f"❌ Error creating .skill file: {e}")
+        return None
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]")
+        print("\nExample:")
+        print("  python utils/package_skill.py skills/public/my-skill")
+        print("  python utils/package_skill.py skills/public/my-skill ./dist")
+        sys.exit(1)
+
+    skill_path = sys.argv[1]
+    output_dir = sys.argv[2] if len(sys.argv) > 2 else None
+
+    print(f"📦 Packaging skill: {skill_path}")
+    if output_dir:
+        print(f"   Output directory: {output_dir}")
+    print()
+
+    result = package_skill(skill_path, output_dir)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/.claude/skills/skill-creator/scripts/quick_validate.py b/.claude/skills/skill-creator/scripts/quick_validate.py
new file mode 100644
index 0000000..d9fbeb7
--- /dev/null
+++ b/.claude/skills/skill-creator/scripts/quick_validate.py
@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""
+Quick validation script for skills - minimal version
+"""
+
+import sys
+import os
+import re
+import yaml
+from pathlib import Path
+
+def validate_skill(skill_path):
+    """Basic validation of a skill"""
+    skill_path = Path(skill_path)
+
+    # Check SKILL.md exists
+    skill_md = skill_path / 'SKILL.md'
+    if not skill_md.exists():
+        return False, "SKILL.md not found"
+
+    # Read and validate frontmatter
+    content = skill_md.read_text()
+    if not content.startswith('---'):
+        return False, "No YAML frontmatter found"
+
+    # Extract frontmatter
+    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not match:
+        return False, "Invalid frontmatter format"
+
+    frontmatter_text = match.group(1)
+
+    # Parse YAML frontmatter
+    try:
+        frontmatter = yaml.safe_load(frontmatter_text)
+        if not isinstance(frontmatter, dict):
+            return False, "Frontmatter must be a YAML dictionary"
+    except yaml.YAMLError as e:
+        return False, f"Invalid YAML in frontmatter: {e}"
+
+    # Define allowed properties
+    ALLOWED_PROPERTIES = {'name', 'description', 'license', 'allowed-tools', 'metadata'}
+
+    # Check for unexpected properties (excluding nested keys under metadata)
+    unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES
+    if unexpected_keys:
+        return False, (
+            f"Unexpected key(s) in SKILL.md frontmatter: {', '.join(sorted(unexpected_keys))}. "
+            f"Allowed properties are: {', '.join(sorted(ALLOWED_PROPERTIES))}"
+        )
+
+    # Check required fields
+    if 'name' not in frontmatter:
+        return False, "Missing 'name' in frontmatter"
+    if 'description' not in frontmatter:
+        return False, "Missing 'description' in frontmatter"
+
+    # Extract name for validation
+    name = frontmatter.get('name', '')
+    if not isinstance(name, str):
+        return False, f"Name must be a string, got {type(name).__name__}"
+    name = name.strip()
+    if name:
+        # Check naming convention (hyphen-case: lowercase with hyphens)
+        if not re.match(r'^[a-z0-9-]+$', name):
+            return False, f"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)"
+        if name.startswith('-') or name.endswith('-') or '--' in name:
+            return False, f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens"
+        # Check name length (max 64 characters per spec)
+        if len(name) > 64:
+            return False, f"Name is too long ({len(name)} characters). Maximum is 64 characters."
+
+    # Extract and validate description
+    description = frontmatter.get('description', '')
+    if not isinstance(description, str):
+        return False, f"Description must be a string, got {type(description).__name__}"
+    description = description.strip()
+    if description:
+        # Check for angle brackets
+        if '<' in description or '>' in description:
+            return False, "Description cannot contain angle brackets (< or >)"
+        # Check description length (max 1024 characters per spec)
+        if len(description) > 1024:
+            return False, f"Description is too long ({len(description)} characters). Maximum is 1024 characters."
+
+    return True, "Skill is valid!"
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python quick_validate.py <skill_directory>")
+        sys.exit(1)
+    
+    valid, message = validate_skill(sys.argv[1])
+    print(message)
+    sys.exit(0 if valid else 1)
\ No newline at end of file
diff --git a/.claude/skills/skill-developer/ADVANCED.md b/.claude/skills/skill-developer/ADVANCED.md
new file mode 100644
index 0000000..6395f77
--- /dev/null
+++ b/.claude/skills/skill-developer/ADVANCED.md
@@ -0,0 +1,197 @@
+# Advanced Topics & Future Enhancements
+
+Ideas and concepts for future improvements to the skill system.
+
+---
+
+## Dynamic Rule Updates
+
+**Current State:** Requires Claude Code restart to pick up changes to skill-rules.json
+
+**Future Enhancement:** Hot-reload configuration without restart
+
+**Implementation Ideas:**
+- Watch skill-rules.json for changes
+- Reload on file modification
+- Invalidate cached compiled regexes
+- Notify user of reload
+
+**Benefits:**
+- Faster iteration during skill development
+- No need to restart Claude Code
+- Better developer experience
+
+---
+
+## Skill Dependencies
+
+**Current State:** Skills are independent
+
+**Future Enhancement:** Specify skill dependencies and load order
+
+**Configuration Idea:**
+```json
+{
+  "my-advanced-skill": {
+    "dependsOn": ["prerequisite-skill", "base-skill"],
+    "type": "domain",
+    ...
+  }
+}
+```
+
+**Use Cases:**
+- Advanced skill builds on base skill knowledge
+- Ensure foundational skills loaded first
+- Chain skills for complex workflows
+
+**Benefits:**
+- Better skill composition
+- Clearer skill relationships
+- Progressive disclosure
+
+---
+
+## Conditional Enforcement
+
+**Current State:** Enforcement level is static
+
+**Future Enhancement:** Enforce based on context or environment
+
+**Configuration Idea:**
+```json
+{
+  "enforcement": {
+    "default": "suggest",
+    "when": {
+      "production": "block",
+      "development": "suggest",
+      "ci": "block"
+    }
+  }
+}
+```
+
+**Use Cases:**
+- Stricter enforcement in production
+- Relaxed rules during development
+- CI/CD pipeline requirements
+
+**Benefits:**
+- Environment-appropriate enforcement
+- Flexible rule application
+- Context-aware guardrails
+
+---
+
+## Skill Analytics
+
+**Current State:** No usage tracking
+
+**Future Enhancement:** Track skill usage patterns and effectiveness
+
+**Metrics to Collect:**
+- Skill trigger frequency
+- False positive rate
+- False negative rate
+- Time to skill usage after suggestion
+- User override rate (skip markers, env vars)
+- Performance metrics (execution time)
+
+**Dashbord Ideas:**
+- Most/least used skills
+- Skills with highest false positive rate
+- Performance bottlenecks
+- Skill effectiveness scores
+
+**Benefits:**
+- Data-driven skill improvement
+- Identify problems early
+- Optimize patterns based on real usage
+
+---
+
+## Skill Versioning
+
+**Current State:** No version tracking
+
+**Future Enhancement:** Version skills and track compatibility
+
+**Configuration Idea:**
+```json
+{
+  "my-skill": {
+    "version": "2.1.0",
+    "minClaudeVersion": "1.5.0",
+    "changelog": "Added support for new workflow patterns",
+    ...
+  }
+}
+```
+
+**Benefits:**
+- Track skill evolution
+- Ensure compatibility
+- Document changes
+- Support migration paths
+
+---
+
+## Multi-Language Support
+
+**Current State:** English only
+
+**Future Enhancement:** Support multiple languages for skill content
+
+**Implementation Ideas:**
+- Language-specific SKILL.md variants
+- Automatic language detection
+- Fallback to English
+
+**Use Cases:**
+- International teams
+- Localized documentation
+- Multi-language projects
+
+---
+
+## Skill Testing Framework
+
+**Current State:** Manual testing with npx tsx commands
+
+**Future Enhancement:** Automated skill testing
+
+**Features:**
+- Test cases for trigger patterns
+- Assertion framework
+- CI/CD integration
+- Coverage reports
+
+**Example Test:**
+```typescript
+describe('database-verification', () => {
+  it('triggers on Prisma imports', () => {
+    const result = testSkill({
+      prompt: "add user tracking",
+      file: "services/user.ts",
+      content: "import { PrismaService } from './prisma'"
+    });
+
+    expect(result.triggered).toBe(true);
+    expect(result.skill).toBe('database-verification');
+  });
+});
+```
+
+**Benefits:**
+- Prevent regressions
+- Validate patterns before deployment
+- Confidence in changes
+
+---
+
+## Related Files
+
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Current debugging guide
+- [HOOK_MECHANISMS.md](HOOK_MECHANISMS.md) - How hooks work today
diff --git a/.claude/skills/skill-developer/HOOK_MECHANISMS.md b/.claude/skills/skill-developer/HOOK_MECHANISMS.md
new file mode 100644
index 0000000..abe4768
--- /dev/null
+++ b/.claude/skills/skill-developer/HOOK_MECHANISMS.md
@@ -0,0 +1,306 @@
+# Hook Mechanisms - Deep Dive
+
+Technical deep dive into how the UserPromptSubmit and PreToolUse hooks work.
+
+## Table of Contents
+
+- [UserPromptSubmit Hook Flow](#userpromptsubmit-hook-flow)
+- [PreToolUse Hook Flow](#pretooluse-hook-flow)
+- [Exit Code Behavior (CRITICAL)](#exit-code-behavior-critical)
+- [Session State Management](#session-state-management)
+- [Performance Considerations](#performance-considerations)
+
+---
+
+## UserPromptSubmit Hook Flow
+
+### Execution Sequence
+
+```
+User submits prompt
+    ↓
+.claude/settings.json registers hook
+    ↓
+skill-activation-prompt.sh executes
+    ↓
+npx tsx skill-activation-prompt.ts
+    ↓
+Hook reads stdin (JSON with prompt)
+    ↓
+Loads skill-rules.json
+    ↓
+Matches keywords + intent patterns
+    ↓
+Groups matches by priority (critical → high → medium → low)
+    ↓
+Outputs formatted message to stdout
+    ↓
+stdout becomes context for Claude (injected before prompt)
+    ↓
+Claude sees: [skill suggestion] + user's prompt
+```
+
+### Key Points
+
+- **Exit code**: Always 0 (allow)
+- **stdout**: → Claude's context (injected as system message)
+- **Timing**: Runs BEFORE Claude processes prompt
+- **Behavior**: Non-blocking, advisory only
+- **Purpose**: Make Claude aware of relevant skills
+
+### Input Format
+
+```json
+{
+  "session_id": "abc-123",
+  "transcript_path": "/path/to/transcript.json",
+  "cwd": "/root/git/your-project",
+  "permission_mode": "normal",
+  "hook_event_name": "UserPromptSubmit",
+  "prompt": "how does the layout system work?"
+}
+```
+
+### Output Format (to stdout)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 SKILL ACTIVATION CHECK
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📚 RECOMMENDED SKILLS:
+  → project-catalog-developer
+
+ACTION: Use Skill tool BEFORE responding
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Claude sees this output as additional context before processing the user's prompt.
+
+---
+
+## PreToolUse Hook Flow
+
+### Execution Sequence
+
+```
+Claude calls Edit/Write tool
+    ↓
+.claude/settings.json registers hook (matcher: Edit|Write)
+    ↓
+skill-verification-guard.sh executes
+    ↓
+npx tsx skill-verification-guard.ts
+    ↓
+Hook reads stdin (JSON with tool_name, tool_input)
+    ↓
+Loads skill-rules.json
+    ↓
+Checks file path patterns (glob matching)
+    ↓
+Reads file for content patterns (if file exists)
+    ↓
+Checks session state (was skill already used?)
+    ↓
+Checks skip conditions (file markers, env vars)
+    ↓
+IF MATCHED AND NOT SKIPPED:
+  Update session state (mark skill as enforced)
+  Output block message to stderr
+  Exit with code 2 (BLOCK)
+ELSE:
+  Exit with code 0 (ALLOW)
+    ↓
+IF BLOCKED:
+  stderr → Claude sees message
+  Edit/Write tool does NOT execute
+  Claude must use skill and retry
+IF ALLOWED:
+  Tool executes normally
+```
+
+### Key Points
+
+- **Exit code 2**: BLOCK (stderr → Claude)
+- **Exit code 0**: ALLOW
+- **Timing**: Runs BEFORE tool execution
+- **Session tracking**: Prevents repeated blocks in same session
+- **Fail open**: On errors, allows operation (don't break workflow)
+- **Purpose**: Enforce critical guardrails
+
+### Input Format
+
+```json
+{
+  "session_id": "abc-123",
+  "transcript_path": "/path/to/transcript.json",
+  "cwd": "/root/git/your-project",
+  "permission_mode": "normal",
+  "hook_event_name": "PreToolUse",
+  "tool_name": "Edit",
+  "tool_input": {
+    "file_path": "/root/git/your-project/form/src/services/user.ts",
+    "old_string": "...",
+    "new_string": "..."
+  }
+}
+```
+
+### Output Format (to stderr when blocked)
+
+```
+⚠️ BLOCKED - Database Operation Detected
+
+📋 REQUIRED ACTION:
+1. Use Skill tool: 'database-verification'
+2. Verify ALL table and column names against schema
+3. Check database structure with DESCRIBE commands
+4. Then retry this edit
+
+Reason: Prevent column name errors in Prisma queries
+File: form/src/services/user.ts
+
+💡 TIP: Add '// @skip-validation' comment to skip future checks
+```
+
+Claude receives this message and understands it needs to use the skill before retrying the edit.
+
+---
+
+## Exit Code Behavior (CRITICAL)
+
+### Exit Code Reference Table
+
+| Exit Code | stdout | stderr | Tool Execution | Claude Sees |
+|-----------|--------|--------|----------------|-------------|
+| 0 (UserPromptSubmit) | → Context | → User only | N/A | stdout content |
+| 0 (PreToolUse) | → User only | → User only | **Proceeds** | Nothing |
+| 2 (PreToolUse) | → User only | → **CLAUDE** | **BLOCKED** | stderr content |
+| Other | → User only | → User only | Blocked | Nothing |
+
+### Why Exit Code 2 Matters
+
+This is THE critical mechanism for enforcement:
+
+1. **Only way** to send message to Claude from PreToolUse
+2. stderr content is "fed back to Claude automatically"
+3. Claude sees the block message and understands what to do
+4. Tool execution is prevented
+5. Critical for enforcement of guardrails
+
+### Example Conversation Flow
+
+```
+User: "Add a new user service with Prisma"
+
+Claude: "I'll create the user service..."
+    [Attempts to Edit form/src/services/user.ts]
+
+PreToolUse Hook: [Exit code 2]
+    stderr: "⚠️ BLOCKED - Use database-verification"
+
+Claude sees error, responds:
+    "I need to verify the database schema first."
+    [Uses Skill tool: database-verification]
+    [Verifies column names]
+    [Retries Edit - now allowed (session tracking)]
+```
+
+---
+
+## Session State Management
+
+### Purpose
+
+Prevent repeated nagging in the same session - once Claude uses a skill, don't block again.
+
+### State File Location
+
+`.claude/hooks/state/skills-used-{session_id}.json`
+
+### State File Structure
+
+```json
+{
+  "skills_used": [
+    "database-verification",
+    "error-tracking"
+  ],
+  "files_verified": []
+}
+```
+
+### How It Works
+
+1. **First edit** of file with Prisma:
+   - Hook blocks with exit code 2
+   - Updates session state: adds "database-verification" to skills_used
+   - Claude sees message, uses skill
+
+2. **Second edit** (same session):
+   - Hook checks session state
+   - Finds "database-verification" in skills_used
+   - Exits with code 0 (allow)
+   - No message to Claude
+
+3. **Different session**:
+   - New session ID = new state file
+   - Hook blocks again
+
+### Limitation
+
+The hook cannot detect when the skill is *actually* invoked - it just blocks once per session per skill. This means:
+
+- If Claude doesn't use the skill but makes a different edit, it won't block again
+- Trust that Claude follows the instruction
+- Future enhancement: detect actual Skill tool usage
+
+---
+
+## Performance Considerations
+
+### Target Metrics
+
+- **UserPromptSubmit**: < 100ms
+- **PreToolUse**: < 200ms
+
+### Performance Bottlenecks
+
+1. **Loading skill-rules.json** (every execution)
+   - Future: Cache in memory
+   - Future: Watch for changes, reload only when needed
+
+2. **Reading file content** (PreToolUse)
+   - Only when contentPatterns configured
+   - Only if file exists
+   - Can be slow for large files
+
+3. **Glob matching** (PreToolUse)
+   - Regex compilation for each pattern
+   - Future: Compile once, cache
+
+4. **Regex matching** (Both hooks)
+   - Intent patterns (UserPromptSubmit)
+   - Content patterns (PreToolUse)
+   - Future: Lazy compile, cache compiled regexes
+
+### Optimization Strategies
+
+**Reduce patterns:**
+- Use more specific patterns (fewer to check)
+- Combine similar patterns where possible
+
+**File path patterns:**
+- More specific = fewer files to check
+- Example: `form/src/services/**` better than `form/**`
+
+**Content patterns:**
+- Only add when truly necessary
+- Simpler regex = faster matching
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Debug hook issues
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Configuration reference
diff --git a/.claude/skills/skill-developer/PATTERNS_LIBRARY.md b/.claude/skills/skill-developer/PATTERNS_LIBRARY.md
new file mode 100644
index 0000000..7220939
--- /dev/null
+++ b/.claude/skills/skill-developer/PATTERNS_LIBRARY.md
@@ -0,0 +1,152 @@
+# Common Patterns Library
+
+Ready-to-use regex and glob patterns for skill triggers. Copy and customize for your skills.
+
+---
+
+## Intent Patterns (Regex)
+
+### Feature/Endpoint Creation
+```regex
+(add|create|implement|build).*?(feature|endpoint|route|service|controller)
+```
+
+### Component Creation
+```regex
+(create|add|make|build).*?(component|UI|page|modal|dialog|form)
+```
+
+### Database Work
+```regex
+(add|create|modify|update).*?(user|table|column|field|schema|migration)
+(database|prisma).*?(change|update|query)
+```
+
+### Error Handling
+```regex
+(fix|handle|catch|debug).*?(error|exception|bug)
+(add|implement).*?(try|catch|error.*?handling)
+```
+
+### Explanation Requests
+```regex
+(how does|how do|explain|what is|describe|tell me about).*?
+```
+
+### Workflow Operations
+```regex
+(create|add|modify|update).*?(workflow|step|branch|condition)
+(debug|troubleshoot|fix).*?workflow
+```
+
+### Testing
+```regex
+(write|create|add).*?(test|spec|unit.*?test)
+```
+
+---
+
+## File Path Patterns (Glob)
+
+### Frontend
+```glob
+frontend/src/**/*.tsx        # All React components
+frontend/src/**/*.ts         # All TypeScript files
+frontend/src/components/**   # Only components directory
+```
+
+### Backend Services
+```glob
+form/src/**/*.ts            # Form service
+email/src/**/*.ts           # Email service
+users/src/**/*.ts           # Users service
+projects/src/**/*.ts        # Projects service
+```
+
+### Database
+```glob
+**/schema.prisma            # Prisma schema (anywhere)
+**/migrations/**/*.sql      # Migration files
+database/src/**/*.ts        # Database scripts
+```
+
+### Workflows
+```glob
+form/src/workflow/**/*.ts              # Workflow engine
+form/src/workflow-definitions/**/*.json # Workflow definitions
+```
+
+### Test Exclusions
+```glob
+**/*.test.ts                # TypeScript tests
+**/*.test.tsx               # React component tests
+**/*.spec.ts                # Spec files
+```
+
+---
+
+## Content Patterns (Regex)
+
+### Prisma/Database
+```regex
+import.*[Pp]risma                # Prisma imports
+PrismaService                    # PrismaService usage
+prisma\.                         # prisma.something
+\.findMany\(                     # Prisma query methods
+\.create\(
+\.update\(
+\.delete\(
+```
+
+### Controllers/Routes
+```regex
+export class.*Controller         # Controller classes
+router\.                         # Express router
+app\.(get|post|put|delete|patch) # Express app routes
+```
+
+### Error Handling
+```regex
+try\s*\{                        # Try blocks
+catch\s*\(                      # Catch blocks
+throw new                        # Throw statements
+```
+
+### React/Components
+```regex
+export.*React\.FC               # React functional components
+export default function.*       # Default function exports
+useState|useEffect              # React hooks
+```
+
+---
+
+**Usage Example:**
+
+```json
+{
+  "my-skill": {
+    "promptTriggers": {
+      "intentPatterns": [
+        "(create|add|build).*?(component|UI|page)"
+      ]
+    },
+    "fileTriggers": {
+      "pathPatterns": [
+        "frontend/src/**/*.tsx"
+      ],
+      "contentPatterns": [
+        "export.*React\\.FC",
+        "useState|useEffect"
+      ]
+    }
+  }
+}
+```
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TRIGGER_TYPES.md](TRIGGER_TYPES.md) - Detailed trigger documentation
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Complete schema
diff --git a/.claude/skills/skill-developer/SKILL.md b/.claude/skills/skill-developer/SKILL.md
new file mode 100644
index 0000000..4c26d2d
--- /dev/null
+++ b/.claude/skills/skill-developer/SKILL.md
@@ -0,0 +1,426 @@
+---
+name: skill-developer
+description: Create and manage Claude Code skills following Anthropic best practices. Use when creating new skills, modifying skill-rules.json, understanding trigger patterns, working with hooks, debugging skill activation, or implementing progressive disclosure. Covers skill structure, YAML frontmatter, trigger types (keywords, intent patterns, file paths, content patterns), enforcement levels (block, suggest, warn), hook mechanisms (UserPromptSubmit, PreToolUse), session tracking, and the 500-line rule.
+---
+
+# Skill Developer Guide
+
+## Purpose
+
+Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.
+
+## When to Use This Skill
+
+Automatically activates when you mention:
+- Creating or adding skills
+- Modifying skill triggers or rules
+- Understanding how skill activation works
+- Debugging skill activation issues
+- Working with skill-rules.json
+- Hook system mechanics
+- Claude Code best practices
+- Progressive disclosure
+- YAML frontmatter
+- 500-line rule
+
+---
+
+## System Overview
+
+### Two-Hook Architecture
+
+**1. UserPromptSubmit Hook** (Proactive Suggestions)
+- **File**: `.claude/hooks/skill-activation-prompt.ts`
+- **Trigger**: BEFORE Claude sees user's prompt
+- **Purpose**: Suggest relevant skills based on keywords + intent patterns
+- **Method**: Injects formatted reminder as context (stdout → Claude's input)
+- **Use Cases**: Topic-based skills, implicit work detection
+
+**2. Stop Hook - Error Handling Reminder** (Gentle Reminders)
+- **File**: `.claude/hooks/error-handling-reminder.ts`
+- **Trigger**: AFTER Claude finishes responding
+- **Purpose**: Gentle reminder to self-assess error handling in code written
+- **Method**: Analyzes edited files for risky patterns, displays reminder if needed
+- **Use Cases**: Error handling awareness without blocking friction
+
+**Philosophy Change (2025-10-27):** We moved away from blocking PreToolUse for Sentry/error handling. Instead, use gentle post-response reminders that don't block workflow but maintain code quality awareness.
+
+### Configuration File
+
+**Location**: `.claude/skills/skill-rules.json`
+
+Defines:
+- All skills and their trigger conditions
+- Enforcement levels (block, suggest, warn)
+- File path patterns (glob)
+- Content detection patterns (regex)
+- Skip conditions (session tracking, file markers, env vars)
+
+---
+
+## Skill Types
+
+### 1. Guardrail Skills
+
+**Purpose:** Enforce critical best practices that prevent errors
+
+**Characteristics:**
+- Type: `"guardrail"`
+- Enforcement: `"block"`
+- Priority: `"critical"` or `"high"`
+- Block file edits until skill used
+- Prevent common mistakes (column names, critical errors)
+- Session-aware (don't repeat nag in same session)
+
+**Examples:**
+- `database-verification` - Verify table/column names before Prisma queries
+- `frontend-dev-guidelines` - Enforce React/TypeScript patterns
+
+**When to Use:**
+- Mistakes that cause runtime errors
+- Data integrity concerns
+- Critical compatibility issues
+
+### 2. Domain Skills
+
+**Purpose:** Provide comprehensive guidance for specific areas
+
+**Characteristics:**
+- Type: `"domain"`
+- Enforcement: `"suggest"`
+- Priority: `"high"` or `"medium"`
+- Advisory, not mandatory
+- Topic or domain-specific
+- Comprehensive documentation
+
+**Examples:**
+- `backend-dev-guidelines` - Node.js/Express/TypeScript patterns
+- `frontend-dev-guidelines` - React/TypeScript best practices
+- `error-tracking` - Sentry integration guidance
+
+**When to Use:**
+- Complex systems requiring deep knowledge
+- Best practices documentation
+- Architectural patterns
+- How-to guides
+
+---
+
+## Quick Start: Creating a New Skill
+
+### Step 1: Create Skill File
+
+**Location:** `.claude/skills/{skill-name}/SKILL.md`
+
+**Template:**
+```markdown
+---
+name: my-new-skill
+description: Brief description including keywords that trigger this skill. Mention topics, file types, and use cases. Be explicit about trigger terms.
+---
+
+# My New Skill
+
+## Purpose
+What this skill helps with
+
+## When to Use
+Specific scenarios and conditions
+
+## Key Information
+The actual guidance, documentation, patterns, examples
+```
+
+**Best Practices:**
+- ✅ **Name**: Lowercase, hyphens, gerund form (verb + -ing) preferred
+- ✅ **Description**: Include ALL trigger keywords/phrases (max 1024 chars)
+- ✅ **Content**: Under 500 lines - use reference files for details
+- ✅ **Examples**: Real code examples
+- ✅ **Structure**: Clear headings, lists, code blocks
+
+### Step 2: Add to skill-rules.json
+
+See [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) for complete schema.
+
+**Basic Template:**
+```json
+{
+  "my-new-skill": {
+    "type": "domain",
+    "enforcement": "suggest",
+    "priority": "medium",
+    "promptTriggers": {
+      "keywords": ["keyword1", "keyword2"],
+      "intentPatterns": ["(create|add).*?something"]
+    }
+  }
+}
+```
+
+### Step 3: Test Triggers
+
+**Test UserPromptSubmit:**
+```bash
+echo '{"session_id":"test","prompt":"your test prompt"}' | \
+  npx tsx .claude/hooks/skill-activation-prompt.ts
+```
+
+**Test PreToolUse:**
+```bash
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{"session_id":"test","tool_name":"Edit","tool_input":{"file_path":"test.ts"}}
+EOF
+```
+
+### Step 4: Refine Patterns
+
+Based on testing:
+- Add missing keywords
+- Refine intent patterns to reduce false positives
+- Adjust file path patterns
+- Test content patterns against actual files
+
+### Step 5: Follow Anthropic Best Practices
+
+✅ Keep SKILL.md under 500 lines
+✅ Use progressive disclosure with reference files
+✅ Add table of contents to reference files > 100 lines
+✅ Write detailed description with trigger keywords
+✅ Test with 3+ real scenarios before documenting
+✅ Iterate based on actual usage
+
+---
+
+## Enforcement Levels
+
+### BLOCK (Critical Guardrails)
+
+- Physically prevents Edit/Write tool execution
+- Exit code 2 from hook, stderr → Claude
+- Claude sees message and must use skill to proceed
+- **Use For**: Critical mistakes, data integrity, security issues
+
+**Example:** Database column name verification
+
+### SUGGEST (Recommended)
+
+- Reminder injected before Claude sees prompt
+- Claude is aware of relevant skills
+- Not enforced, just advisory
+- **Use For**: Domain guidance, best practices, how-to guides
+
+**Example:** Frontend development guidelines
+
+### WARN (Optional)
+
+- Low priority suggestions
+- Advisory only, minimal enforcement
+- **Use For**: Nice-to-have suggestions, informational reminders
+
+**Rarely used** - most skills are either BLOCK or SUGGEST.
+
+---
+
+## Skip Conditions & User Control
+
+### 1. Session Tracking
+
+**Purpose:** Don't nag repeatedly in same session
+
+**How it works:**
+- First edit → Hook blocks, updates session state
+- Second edit (same session) → Hook allows
+- Different session → Blocks again
+
+**State File:** `.claude/hooks/state/skills-used-{session_id}.json`
+
+### 2. File Markers
+
+**Purpose:** Permanent skip for verified files
+
+**Marker:** `// @skip-validation`
+
+**Usage:**
+```typescript
+// @skip-validation
+import { PrismaService } from './prisma';
+// This file has been manually verified
+```
+
+**NOTE:** Use sparingly - defeats the purpose if overused
+
+### 3. Environment Variables
+
+**Purpose:** Emergency disable, temporary override
+
+**Global disable:**
+```bash
+export SKIP_SKILL_GUARDRAILS=true  # Disables ALL PreToolUse blocks
+```
+
+**Skill-specific:**
+```bash
+export SKIP_DB_VERIFICATION=true
+export SKIP_ERROR_REMINDER=true
+```
+
+---
+
+## Testing Checklist
+
+When creating a new skill, verify:
+
+- [ ] Skill file created in `.claude/skills/{name}/SKILL.md`
+- [ ] Proper frontmatter with name and description
+- [ ] Entry added to `skill-rules.json`
+- [ ] Keywords tested with real prompts
+- [ ] Intent patterns tested with variations
+- [ ] File path patterns tested with actual files
+- [ ] Content patterns tested against file contents
+- [ ] Block message is clear and actionable (if guardrail)
+- [ ] Skip conditions configured appropriately
+- [ ] Priority level matches importance
+- [ ] No false positives in testing
+- [ ] No false negatives in testing
+- [ ] Performance is acceptable (<100ms or <200ms)
+- [ ] JSON syntax validated: `jq . skill-rules.json`
+- [ ] **SKILL.md under 500 lines** ⭐
+- [ ] Reference files created if needed
+- [ ] Table of contents added to files > 100 lines
+
+---
+
+## Reference Files
+
+For detailed information on specific topics, see:
+
+### [TRIGGER_TYPES.md](TRIGGER_TYPES.md)
+Complete guide to all trigger types:
+- Keyword triggers (explicit topic matching)
+- Intent patterns (implicit action detection)
+- File path triggers (glob patterns)
+- Content patterns (regex in files)
+- Best practices and examples for each
+- Common pitfalls and testing strategies
+
+### [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md)
+Complete skill-rules.json schema:
+- Full TypeScript interface definitions
+- Field-by-field explanations
+- Complete guardrail skill example
+- Complete domain skill example
+- Validation guide and common errors
+
+### [HOOK_MECHANISMS.md](HOOK_MECHANISMS.md)
+Deep dive into hook internals:
+- UserPromptSubmit flow (detailed)
+- PreToolUse flow (detailed)
+- Exit code behavior table (CRITICAL)
+- Session state management
+- Performance considerations
+
+### [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
+Comprehensive debugging guide:
+- Skill not triggering (UserPromptSubmit)
+- PreToolUse not blocking
+- False positives (too many triggers)
+- Hook not executing at all
+- Performance issues
+
+### [PATTERNS_LIBRARY.md](PATTERNS_LIBRARY.md)
+Ready-to-use pattern collection:
+- Intent pattern library (regex)
+- File path pattern library (glob)
+- Content pattern library (regex)
+- Organized by use case
+- Copy-paste ready
+
+### [ADVANCED.md](ADVANCED.md)
+Future enhancements and ideas:
+- Dynamic rule updates
+- Skill dependencies
+- Conditional enforcement
+- Skill analytics
+- Skill versioning
+
+---
+
+## Quick Reference Summary
+
+### Create New Skill (5 Steps)
+
+1. Create `.claude/skills/{name}/SKILL.md` with frontmatter
+2. Add entry to `.claude/skills/skill-rules.json`
+3. Test with `npx tsx` commands
+4. Refine patterns based on testing
+5. Keep SKILL.md under 500 lines
+
+### Trigger Types
+
+- **Keywords**: Explicit topic mentions
+- **Intent**: Implicit action detection
+- **File Paths**: Location-based activation
+- **Content**: Technology-specific detection
+
+See [TRIGGER_TYPES.md](TRIGGER_TYPES.md) for complete details.
+
+### Enforcement
+
+- **BLOCK**: Exit code 2, critical only
+- **SUGGEST**: Inject context, most common
+- **WARN**: Advisory, rarely used
+
+### Skip Conditions
+
+- **Session tracking**: Automatic (prevents repeated nags)
+- **File markers**: `// @skip-validation` (permanent skip)
+- **Env vars**: `SKIP_SKILL_GUARDRAILS` (emergency disable)
+
+### Anthropic Best Practices
+
+✅ **500-line rule**: Keep SKILL.md under 500 lines
+✅ **Progressive disclosure**: Use reference files for details
+✅ **Table of contents**: Add to reference files > 100 lines
+✅ **One level deep**: Don't nest references deeply
+✅ **Rich descriptions**: Include all trigger keywords (max 1024 chars)
+✅ **Test first**: Build 3+ evaluations before extensive documentation
+✅ **Gerund naming**: Prefer verb + -ing (e.g., "processing-pdfs")
+
+### Troubleshoot
+
+Test hooks manually:
+```bash
+# UserPromptSubmit
+echo '{"prompt":"test"}' | npx tsx .claude/hooks/skill-activation-prompt.ts
+
+# PreToolUse
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{"tool_name":"Edit","tool_input":{"file_path":"test.ts"}}
+EOF
+```
+
+See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for complete debugging guide.
+
+---
+
+## Related Files
+
+**Configuration:**
+- `.claude/skills/skill-rules.json` - Master configuration
+- `.claude/hooks/state/` - Session tracking
+- `.claude/settings.json` - Hook registration
+
+**Hooks:**
+- `.claude/hooks/skill-activation-prompt.ts` - UserPromptSubmit
+- `.claude/hooks/error-handling-reminder.ts` - Stop event (gentle reminders)
+
+**All Skills:**
+- `.claude/skills/*/SKILL.md` - Skill content files
+
+---
+
+**Skill Status**: COMPLETE - Restructured following Anthropic best practices ✅
+**Line Count**: < 500 (following 500-line rule) ✅
+**Progressive Disclosure**: Reference files for detailed information ✅
+
+**Next**: Create more skills, refine patterns based on usage
diff --git a/.claude/skills/skill-developer/SKILL_RULES_REFERENCE.md b/.claude/skills/skill-developer/SKILL_RULES_REFERENCE.md
new file mode 100644
index 0000000..1cad7d9
--- /dev/null
+++ b/.claude/skills/skill-developer/SKILL_RULES_REFERENCE.md
@@ -0,0 +1,315 @@
+# skill-rules.json - Complete Reference
+
+Complete schema and configuration reference for `.claude/skills/skill-rules.json`.
+
+## Table of Contents
+
+- [File Location](#file-location)
+- [Complete TypeScript Schema](#complete-typescript-schema)
+- [Field Guide](#field-guide)
+- [Example: Guardrail Skill](#example-guardrail-skill)
+- [Example: Domain Skill](#example-domain-skill)
+- [Validation](#validation)
+
+---
+
+## File Location
+
+**Path:** `.claude/skills/skill-rules.json`
+
+This JSON file defines all skills and their trigger conditions for the auto-activation system.
+
+---
+
+## Complete TypeScript Schema
+
+```typescript
+interface SkillRules {
+    version: string;
+    skills: Record<string, SkillRule>;
+}
+
+interface SkillRule {
+    type: 'guardrail' | 'domain';
+    enforcement: 'block' | 'suggest' | 'warn';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+
+    promptTriggers?: {
+        keywords?: string[];
+        intentPatterns?: string[];  // Regex strings
+    };
+
+    fileTriggers?: {
+        pathPatterns: string[];     // Glob patterns
+        pathExclusions?: string[];  // Glob patterns
+        contentPatterns?: string[]; // Regex strings
+        createOnly?: boolean;       // Only trigger on file creation
+    };
+
+    blockMessage?: string;  // For guardrails, {file_path} placeholder
+
+    skipConditions?: {
+        sessionSkillUsed?: boolean;      // Skip if used in session
+        fileMarkers?: string[];          // e.g., ["@skip-validation"]
+        envOverride?: string;            // e.g., "SKIP_DB_VERIFICATION"
+    };
+}
+```
+
+---
+
+## Field Guide
+
+### Top Level
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `version` | string | Yes | Schema version (currently "1.0") |
+| `skills` | object | Yes | Map of skill name → SkillRule |
+
+### SkillRule Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `type` | string | Yes | "guardrail" (enforced) or "domain" (advisory) |
+| `enforcement` | string | Yes | "block" (PreToolUse), "suggest" (UserPromptSubmit), or "warn" |
+| `priority` | string | Yes | "critical", "high", "medium", or "low" |
+| `promptTriggers` | object | Optional | Triggers for UserPromptSubmit hook |
+| `fileTriggers` | object | Optional | Triggers for PreToolUse hook |
+| `blockMessage` | string | Optional* | Required if enforcement="block". Use `{file_path}` placeholder |
+| `skipConditions` | object | Optional | Escape hatches and session tracking |
+
+*Required for guardrails
+
+### promptTriggers Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `keywords` | string[] | Optional | Exact substring matches (case-insensitive) |
+| `intentPatterns` | string[] | Optional | Regex patterns for intent detection |
+
+### fileTriggers Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `pathPatterns` | string[] | Yes* | Glob patterns for file paths |
+| `pathExclusions` | string[] | Optional | Glob patterns to exclude (e.g., test files) |
+| `contentPatterns` | string[] | Optional | Regex patterns to match file content |
+| `createOnly` | boolean | Optional | Only trigger when creating new files |
+
+*Required if fileTriggers is present
+
+### skipConditions Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `sessionSkillUsed` | boolean | Optional | Skip if skill already used this session |
+| `fileMarkers` | string[] | Optional | Skip if file contains comment marker |
+| `envOverride` | string | Optional | Environment variable name to disable skill |
+
+---
+
+## Example: Guardrail Skill
+
+Complete example of a blocking guardrail skill with all features:
+
+```json
+{
+  "database-verification": {
+    "type": "guardrail",
+    "enforcement": "block",
+    "priority": "critical",
+
+    "promptTriggers": {
+      "keywords": [
+        "prisma",
+        "database",
+        "table",
+        "column",
+        "schema",
+        "query",
+        "migration"
+      ],
+      "intentPatterns": [
+        "(add|create|implement).*?(user|login|auth|tracking|feature)",
+        "(modify|update|change).*?(table|column|schema|field)",
+        "database.*?(change|update|modify|migration)"
+      ]
+    },
+
+    "fileTriggers": {
+      "pathPatterns": [
+        "**/schema.prisma",
+        "**/migrations/**/*.sql",
+        "database/src/**/*.ts",
+        "form/src/**/*.ts",
+        "email/src/**/*.ts",
+        "users/src/**/*.ts",
+        "projects/src/**/*.ts",
+        "utilities/src/**/*.ts"
+      ],
+      "pathExclusions": [
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ],
+      "contentPatterns": [
+        "import.*[Pp]risma",
+        "PrismaService",
+        "prisma\\.",
+        "\\.findMany\\(",
+        "\\.findUnique\\(",
+        "\\.findFirst\\(",
+        "\\.create\\(",
+        "\\.createMany\\(",
+        "\\.update\\(",
+        "\\.updateMany\\(",
+        "\\.upsert\\(",
+        "\\.delete\\(",
+        "\\.deleteMany\\("
+      ]
+    },
+
+    "blockMessage": "⚠️ BLOCKED - Database Operation Detected\n\n📋 REQUIRED ACTION:\n1. Use Skill tool: 'database-verification'\n2. Verify ALL table and column names against schema\n3. Check database structure with DESCRIBE commands\n4. Then retry this edit\n\nReason: Prevent column name errors in Prisma queries\nFile: {file_path}\n\n💡 TIP: Add '// @skip-validation' comment to skip future checks",
+
+    "skipConditions": {
+      "sessionSkillUsed": true,
+      "fileMarkers": [
+        "@skip-validation"
+      ],
+      "envOverride": "SKIP_DB_VERIFICATION"
+    }
+  }
+}
+```
+
+### Key Points for Guardrails
+
+1. **type**: Must be "guardrail"
+2. **enforcement**: Must be "block"
+3. **priority**: Usually "critical" or "high"
+4. **blockMessage**: Required, clear actionable steps
+5. **skipConditions**: Session tracking prevents repeated nagging
+6. **fileTriggers**: Usually has both path and content patterns
+7. **contentPatterns**: Catch actual usage of technology
+
+---
+
+## Example: Domain Skill
+
+Complete example of a suggestion-based domain skill:
+
+```json
+{
+  "project-catalog-developer": {
+    "type": "domain",
+    "enforcement": "suggest",
+    "priority": "high",
+
+    "promptTriggers": {
+      "keywords": [
+        "layout",
+        "layout system",
+        "grid",
+        "grid layout",
+        "toolbar",
+        "column",
+        "cell editor",
+        "cell renderer",
+        "submission",
+        "submissions",
+        "blog dashboard",
+        "datagrid",
+        "data grid",
+        "CustomToolbar",
+        "GridLayoutDialog",
+        "useGridLayout",
+        "auto-save",
+        "column order",
+        "column width",
+        "filter",
+        "sort"
+      ],
+      "intentPatterns": [
+        "(how does|how do|explain|what is|describe).*?(layout|grid|toolbar|column|submission|catalog)",
+        "(add|create|modify|change).*?(toolbar|column|cell|editor|renderer)",
+        "blog dashboard.*?"
+      ]
+    },
+
+    "fileTriggers": {
+      "pathPatterns": [
+        "frontend/src/features/submissions/**/*.tsx",
+        "frontend/src/features/submissions/**/*.ts"
+      ],
+      "pathExclusions": [
+        "**/*.test.tsx",
+        "**/*.test.ts"
+      ]
+    }
+  }
+}
+```
+
+### Key Points for Domain Skills
+
+1. **type**: Must be "domain"
+2. **enforcement**: Usually "suggest"
+3. **priority**: "high" or "medium"
+4. **blockMessage**: Not needed (doesn't block)
+5. **skipConditions**: Optional (less critical)
+6. **promptTriggers**: Usually has extensive keywords
+7. **fileTriggers**: May have only path patterns (content less important)
+
+---
+
+## Validation
+
+### Check JSON Syntax
+
+```bash
+cat .claude/skills/skill-rules.json | jq .
+```
+
+If valid, jq will pretty-print the JSON. If invalid, it will show the error.
+
+### Common JSON Errors
+
+**Trailing comma:**
+```json
+{
+  "keywords": ["one", "two",]  // ❌ Trailing comma
+}
+```
+
+**Missing quotes:**
+```json
+{
+  type: "guardrail"  // ❌ Missing quotes on key
+}
+```
+
+**Single quotes (invalid JSON):**
+```json
+{
+  'type': 'guardrail'  // ❌ Must use double quotes
+}
+```
+
+### Validation Checklist
+
+- [ ] JSON syntax valid (use `jq`)
+- [ ] All skill names match SKILL.md filenames
+- [ ] Guardrails have `blockMessage`
+- [ ] Block messages use `{file_path}` placeholder
+- [ ] Intent patterns are valid regex (test on regex101.com)
+- [ ] File path patterns use correct glob syntax
+- [ ] Content patterns escape special characters
+- [ ] Priority matches enforcement level
+- [ ] No duplicate skill names
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [TRIGGER_TYPES.md](TRIGGER_TYPES.md) - Complete trigger documentation
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Debugging configuration issues
diff --git a/.claude/skills/skill-developer/TRIGGER_TYPES.md b/.claude/skills/skill-developer/TRIGGER_TYPES.md
new file mode 100644
index 0000000..dd61951
--- /dev/null
+++ b/.claude/skills/skill-developer/TRIGGER_TYPES.md
@@ -0,0 +1,305 @@
+# Trigger Types - Complete Guide
+
+Complete reference for configuring skill triggers in Claude Code's skill auto-activation system.
+
+## Table of Contents
+
+- [Keyword Triggers (Explicit)](#keyword-triggers-explicit)
+- [Intent Pattern Triggers (Implicit)](#intent-pattern-triggers-implicit)
+- [File Path Triggers](#file-path-triggers)
+- [Content Pattern Triggers](#content-pattern-triggers)
+- [Best Practices Summary](#best-practices-summary)
+
+---
+
+## Keyword Triggers (Explicit)
+
+### How It Works
+
+Case-insensitive substring matching in user's prompt.
+
+### Use For
+
+Topic-based activation where user explicitly mentions the subject.
+
+### Configuration
+
+```json
+"promptTriggers": {
+  "keywords": ["layout", "grid", "toolbar", "submission"]
+}
+```
+
+### Example
+
+- User prompt: "how does the **layout** system work?"
+- Matches: "layout" keyword
+- Activates: `project-catalog-developer`
+
+### Best Practices
+
+- Use specific, unambiguous terms
+- Include common variations ("layout", "layout system", "grid layout")
+- Avoid overly generic words ("system", "work", "create")
+- Test with real prompts
+
+---
+
+## Intent Pattern Triggers (Implicit)
+
+### How It Works
+
+Regex pattern matching to detect user's intent even when they don't mention the topic explicitly.
+
+### Use For
+
+Action-based activation where user describes what they want to do rather than the specific topic.
+
+### Configuration
+
+```json
+"promptTriggers": {
+  "intentPatterns": [
+    "(create|add|implement).*?(feature|endpoint)",
+    "(how does|explain).*?(layout|workflow)"
+  ]
+}
+```
+
+### Examples
+
+**Database Work:**
+- User prompt: "add user tracking feature"
+- Matches: `(add).*?(feature)`
+- Activates: `database-verification`, `error-tracking`
+
+**Component Creation:**
+- User prompt: "create a dashboard widget"
+- Matches: `(create).*?(component)` (if component in pattern)
+- Activates: `frontend-dev-guidelines`
+
+### Best Practices
+
+- Capture common action verbs: `(create|add|modify|build|implement)`
+- Include domain-specific nouns: `(feature|endpoint|component|workflow)`
+- Use non-greedy matching: `.*?` instead of `.*`
+- Test patterns thoroughly with regex tester (https://regex101.com/)
+- Don't make patterns too broad (causes false positives)
+- Don't make patterns too specific (causes false negatives)
+
+### Common Pattern Examples
+
+```regex
+# Database Work
+(add|create|implement).*?(user|login|auth|feature)
+
+# Explanations
+(how does|explain|what is|describe).*?
+
+# Frontend Work
+(create|add|make|build).*?(component|UI|page|modal|dialog)
+
+# Error Handling
+(fix|handle|catch|debug).*?(error|exception|bug)
+
+# Workflow Operations
+(create|add|modify).*?(workflow|step|branch|condition)
+```
+
+---
+
+## File Path Triggers
+
+### How It Works
+
+Glob pattern matching against the file path being edited.
+
+### Use For
+
+Domain/area-specific activation based on file location in the project.
+
+### Configuration
+
+```json
+"fileTriggers": {
+  "pathPatterns": [
+    "frontend/src/**/*.tsx",
+    "form/src/**/*.ts"
+  ],
+  "pathExclusions": [
+    "**/*.test.ts",
+    "**/*.spec.ts"
+  ]
+}
+```
+
+### Glob Pattern Syntax
+
+- `**` = Any number of directories (including zero)
+- `*` = Any characters within a directory name
+- Examples:
+  - `frontend/src/**/*.tsx` = All .tsx files in frontend/src and subdirs
+  - `**/schema.prisma` = schema.prisma anywhere in project
+  - `form/src/**/*.ts` = All .ts files in form/src subdirs
+
+### Example
+
+- File being edited: `frontend/src/components/Dashboard.tsx`
+- Matches: `frontend/src/**/*.tsx`
+- Activates: `frontend-dev-guidelines`
+
+### Best Practices
+
+- Be specific to avoid false positives
+- Use exclusions for test files: `**/*.test.ts`
+- Consider subdirectory structure
+- Test patterns with actual file paths
+- Use narrower patterns when possible: `form/src/services/**` not `form/**`
+
+### Common Path Patterns
+
+```glob
+# Frontend
+frontend/src/**/*.tsx        # All React components
+frontend/src/**/*.ts         # All TypeScript files
+frontend/src/components/**   # Only components directory
+
+# Backend Services
+form/src/**/*.ts            # Form service
+email/src/**/*.ts           # Email service
+users/src/**/*.ts           # Users service
+
+# Database
+**/schema.prisma            # Prisma schema (anywhere)
+**/migrations/**/*.sql      # Migration files
+database/src/**/*.ts        # Database scripts
+
+# Workflows
+form/src/workflow/**/*.ts              # Workflow engine
+form/src/workflow-definitions/**/*.json # Workflow definitions
+
+# Test Exclusions
+**/*.test.ts                # TypeScript tests
+**/*.test.tsx               # React component tests
+**/*.spec.ts                # Spec files
+```
+
+---
+
+## Content Pattern Triggers
+
+### How It Works
+
+Regex pattern matching against the file's actual content (what's inside the file).
+
+### Use For
+
+Technology-specific activation based on what the code imports or uses (Prisma, controllers, specific libraries).
+
+### Configuration
+
+```json
+"fileTriggers": {
+  "contentPatterns": [
+    "import.*[Pp]risma",
+    "PrismaService",
+    "\\.findMany\\(",
+    "\\.create\\("
+  ]
+}
+```
+
+### Examples
+
+**Prisma Detection:**
+- File contains: `import { PrismaService } from '@project/database'`
+- Matches: `import.*[Pp]risma`
+- Activates: `database-verification`
+
+**Controller Detection:**
+- File contains: `export class UserController {`
+- Matches: `export class.*Controller`
+- Activates: `error-tracking`
+
+### Best Practices
+
+- Match imports: `import.*[Pp]risma` (case-insensitive with [Pp])
+- Escape special regex chars: `\\.findMany\\(` not `.findMany(`
+- Patterns use case-insensitive flag
+- Test against real file content
+- Make patterns specific enough to avoid false matches
+
+### Common Content Patterns
+
+```regex
+# Prisma/Database
+import.*[Pp]risma                # Prisma imports
+PrismaService                    # PrismaService usage
+prisma\.                         # prisma.something
+\.findMany\(                     # Prisma query methods
+\.create\(
+\.update\(
+\.delete\(
+
+# Controllers/Routes
+export class.*Controller         # Controller classes
+router\.                         # Express router
+app\.(get|post|put|delete|patch) # Express app routes
+
+# Error Handling
+try\s*\{                        # Try blocks
+catch\s*\(                      # Catch blocks
+throw new                        # Throw statements
+
+# React/Components
+export.*React\.FC               # React functional components
+export default function.*       # Default function exports
+useState|useEffect              # React hooks
+```
+
+---
+
+## Best Practices Summary
+
+### DO:
+✅ Use specific, unambiguous keywords
+✅ Test all patterns with real examples
+✅ Include common variations
+✅ Use non-greedy regex: `.*?`
+✅ Escape special characters in content patterns
+✅ Add exclusions for test files
+✅ Make file path patterns narrow and specific
+
+### DON'T:
+❌ Use overly generic keywords ("system", "work")
+❌ Make intent patterns too broad (false positives)
+❌ Make patterns too specific (false negatives)
+❌ Forget to test with regex tester (https://regex101.com/)
+❌ Use greedy regex: `.*` instead of `.*?`
+❌ Match too broadly in file paths
+
+### Testing Your Triggers
+
+**Test keyword/intent triggers:**
+```bash
+echo '{"session_id":"test","prompt":"your test prompt"}' | \
+  npx tsx .claude/hooks/skill-activation-prompt.ts
+```
+
+**Test file path/content triggers:**
+```bash
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{
+  "session_id": "test",
+  "tool_name": "Edit",
+  "tool_input": {"file_path": "/path/to/test/file.ts"}
+}
+EOF
+```
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Complete skill-rules.json schema
+- [PATTERNS_LIBRARY.md](PATTERNS_LIBRARY.md) - Ready-to-use pattern library
diff --git a/.claude/skills/skill-developer/TROUBLESHOOTING.md b/.claude/skills/skill-developer/TROUBLESHOOTING.md
new file mode 100644
index 0000000..f8cd3d3
--- /dev/null
+++ b/.claude/skills/skill-developer/TROUBLESHOOTING.md
@@ -0,0 +1,514 @@
+# Troubleshooting - Skill Activation Issues
+
+Complete debugging guide for skill activation problems.
+
+## Table of Contents
+
+- [Skill Not Triggering](#skill-not-triggering)
+  - [UserPromptSubmit Not Suggesting](#userpromptsubmit-not-suggesting)
+  - [PreToolUse Not Blocking](#pretooluse-not-blocking)
+- [False Positives](#false-positives)
+- [Hook Not Executing](#hook-not-executing)
+- [Performance Issues](#performance-issues)
+
+---
+
+## Skill Not Triggering
+
+### UserPromptSubmit Not Suggesting
+
+**Symptoms:** Ask a question, but no skill suggestion appears in output.
+
+**Common Causes:**
+
+####  1. Keywords Don't Match
+
+**Check:**
+- Look at `promptTriggers.keywords` in skill-rules.json
+- Are the keywords actually in your prompt?
+- Remember: case-insensitive substring matching
+
+**Example:**
+```json
+"keywords": ["layout", "grid"]
+```
+- "how does the layout work?" → ✅ Matches "layout"
+- "how does the grid system work?" → ✅ Matches "grid"
+- "how do layouts work?" → ✅ Matches "layout"
+- "how does it work?" → ❌ No match
+
+**Fix:** Add more keyword variations to skill-rules.json
+
+#### 2. Intent Patterns Too Specific
+
+**Check:**
+- Look at `promptTriggers.intentPatterns`
+- Test regex at https://regex101.com/
+- May need broader patterns
+
+**Example:**
+```json
+"intentPatterns": [
+  "(create|add).*?(database.*?table)"  // Too specific
+]
+```
+- "create a database table" → ✅ Matches
+- "add new table" → ❌ Doesn't match (missing "database")
+
+**Fix:** Broaden the pattern:
+```json
+"intentPatterns": [
+  "(create|add).*?(table|database)"  // Better
+]
+```
+
+#### 3. Typo in Skill Name
+
+**Check:**
+- Skill name in SKILL.md frontmatter
+- Skill name in skill-rules.json
+- Must match exactly
+
+**Example:**
+```yaml
+# SKILL.md
+name: project-catalog-developer
+```
+```json
+// skill-rules.json
+"project-catalogue-developer": {  // ❌ Typo: catalogue vs catalog
+  ...
+}
+```
+
+**Fix:** Make names match exactly
+
+#### 4. JSON Syntax Error
+
+**Check:**
+```bash
+cat .claude/skills/skill-rules.json | jq .
+```
+
+If invalid JSON, jq will show the error.
+
+**Common errors:**
+- Trailing commas
+- Missing quotes
+- Single quotes instead of double
+- Unescaped characters in strings
+
+**Fix:** Correct JSON syntax, validate with jq
+
+#### Debug Command
+
+Test the hook manually:
+
+```bash
+echo '{"session_id":"debug","prompt":"your test prompt here"}' | \
+  npx tsx .claude/hooks/skill-activation-prompt.ts
+```
+
+Expected: Your skill should appear in the output.
+
+---
+
+### PreToolUse Not Blocking
+
+**Symptoms:** Edit a file that should trigger a guardrail, but no block occurs.
+
+**Common Causes:**
+
+#### 1. File Path Doesn't Match Patterns
+
+**Check:**
+- File path being edited
+- `fileTriggers.pathPatterns` in skill-rules.json
+- Glob pattern syntax
+
+**Example:**
+```json
+"pathPatterns": [
+  "frontend/src/**/*.tsx"
+]
+```
+- Editing: `frontend/src/components/Dashboard.tsx` → ✅ Matches
+- Editing: `frontend/tests/Dashboard.test.tsx` → ✅ Matches (add exclusion!)
+- Editing: `backend/src/app.ts` → ❌ Doesn't match
+
+**Fix:** Adjust glob patterns or add the missing path
+
+#### 2. Excluded by pathExclusions
+
+**Check:**
+- Are you editing a test file?
+- Look at `fileTriggers.pathExclusions`
+
+**Example:**
+```json
+"pathExclusions": [
+  "**/*.test.ts",
+  "**/*.spec.ts"
+]
+```
+- Editing: `services/user.test.ts` → ❌ Excluded
+- Editing: `services/user.ts` → ✅ Not excluded
+
+**Fix:** If test exclusion too broad, narrow it or remove
+
+#### 3. Content Pattern Not Found
+
+**Check:**
+- Does the file actually contain the pattern?
+- Look at `fileTriggers.contentPatterns`
+- Is the regex correct?
+
+**Example:**
+```json
+"contentPatterns": [
+  "import.*[Pp]risma"
+]
+```
+- File has: `import { PrismaService } from './prisma'` → ✅ Matches
+- File has: `import { Database } from './db'` → ❌ Doesn't match
+
+**Debug:**
+```bash
+# Check if pattern exists in file
+grep -i "prisma" path/to/file.ts
+```
+
+**Fix:** Adjust content patterns or add missing imports
+
+#### 4. Session Already Used Skill
+
+**Check session state:**
+```bash
+ls .claude/hooks/state/
+cat .claude/hooks/state/skills-used-{session-id}.json
+```
+
+**Example:**
+```json
+{
+  "skills_used": ["database-verification"],
+  "files_verified": []
+}
+```
+
+If the skill is in `skills_used`, it won't block again in this session.
+
+**Fix:** Delete the state file to reset:
+```bash
+rm .claude/hooks/state/skills-used-{session-id}.json
+```
+
+#### 5. File Marker Present
+
+**Check file for skip marker:**
+```bash
+grep "@skip-validation" path/to/file.ts
+```
+
+If found, the file is permanently skipped.
+
+**Fix:** Remove the marker if verification is needed again
+
+#### 6. Environment Variable Override
+
+**Check:**
+```bash
+echo $SKIP_DB_VERIFICATION
+echo $SKIP_SKILL_GUARDRAILS
+```
+
+If set, the skill is disabled.
+
+**Fix:** Unset the environment variable:
+```bash
+unset SKIP_DB_VERIFICATION
+```
+
+#### Debug Command
+
+Test the hook manually:
+
+```bash
+cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts 2>&1
+{
+  "session_id": "debug",
+  "tool_name": "Edit",
+  "tool_input": {"file_path": "/root/git/your-project/form/src/services/user.ts"}
+}
+EOF
+echo "Exit code: $?"
+```
+
+Expected:
+- Exit code 2 + stderr message if should block
+- Exit code 0 + no output if should allow
+
+---
+
+## False Positives
+
+**Symptoms:** Skill triggers when it shouldn't.
+
+**Common Causes & Solutions:**
+
+### 1. Keywords Too Generic
+
+**Problem:**
+```json
+"keywords": ["user", "system", "create"]  // Too broad
+```
+- Triggers on: "user manual", "file system", "create directory"
+
+**Solution:** Make keywords more specific
+```json
+"keywords": [
+  "user authentication",
+  "user tracking",
+  "create feature"
+]
+```
+
+### 2. Intent Patterns Too Broad
+
+**Problem:**
+```json
+"intentPatterns": [
+  "(create)"  // Matches everything with "create"
+]
+```
+- Triggers on: "create file", "create folder", "create account"
+
+**Solution:** Add context to patterns
+```json
+"intentPatterns": [
+  "(create|add).*?(database|table|feature)"  // More specific
+]
+```
+
+**Advanced:** Use negative lookaheads to exclude
+```regex
+(create)(?!.*test).*?(feature)  // Don't match if "test" appears
+```
+
+### 3. File Paths Too Generic
+
+**Problem:**
+```json
+"pathPatterns": [
+  "form/**"  // Matches everything in form/
+]
+```
+- Triggers on: test files, config files, everything
+
+**Solution:** Use narrower patterns
+```json
+"pathPatterns": [
+  "form/src/services/**/*.ts",  // Only service files
+  "form/src/controllers/**/*.ts"
+]
+```
+
+### 4. Content Patterns Catching Unrelated Code
+
+**Problem:**
+```json
+"contentPatterns": [
+  "Prisma"  // Matches in comments, strings, etc.
+]
+```
+- Triggers on: `// Don't use Prisma here`
+- Triggers on: `const note = "Prisma is cool"`
+
+**Solution:** Make patterns more specific
+```json
+"contentPatterns": [
+  "import.*[Pp]risma",        // Only imports
+  "PrismaService\\.",         // Only actual usage
+  "prisma\\.(findMany|create)" // Specific methods
+]
+```
+
+### 5. Adjust Enforcement Level
+
+**Last resort:** If false positives are frequent:
+
+```json
+{
+  "enforcement": "block"  // Change to "suggest"
+}
+```
+
+This makes it advisory instead of blocking.
+
+---
+
+## Hook Not Executing
+
+**Symptoms:** Hook doesn't run at all - no suggestion, no block.
+
+**Common Causes:**
+
+### 1. Hook Not Registered
+
+**Check `.claude/settings.json`:**
+```bash
+cat .claude/settings.json | jq '.hooks.UserPromptSubmit'
+cat .claude/settings.json | jq '.hooks.PreToolUse'
+```
+
+Expected: Hook entries present
+
+**Fix:** Add missing hook registration:
+```json
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/skill-activation-prompt.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 2. Bash Wrapper Not Executable
+
+**Check:**
+```bash
+ls -l .claude/hooks/*.sh
+```
+
+Expected: `-rwxr-xr-x` (executable)
+
+**Fix:**
+```bash
+chmod +x .claude/hooks/*.sh
+```
+
+### 3. Incorrect Shebang
+
+**Check:**
+```bash
+head -1 .claude/hooks/skill-activation-prompt.sh
+```
+
+Expected: `#!/bin/bash`
+
+**Fix:** Add correct shebang to first line
+
+### 4. npx/tsx Not Available
+
+**Check:**
+```bash
+npx tsx --version
+```
+
+Expected: Version number
+
+**Fix:** Install dependencies:
+```bash
+cd .claude/hooks
+npm install
+```
+
+### 5. TypeScript Compilation Error
+
+**Check:**
+```bash
+cd .claude/hooks
+npx tsc --noEmit skill-activation-prompt.ts
+```
+
+Expected: No output (no errors)
+
+**Fix:** Correct TypeScript syntax errors
+
+---
+
+## Performance Issues
+
+**Symptoms:** Hooks are slow, noticeable delay before prompt/edit.
+
+**Common Causes:**
+
+### 1. Too Many Patterns
+
+**Check:**
+- Count patterns in skill-rules.json
+- Each pattern = regex compilation + matching
+
+**Solution:** Reduce patterns
+- Combine similar patterns
+- Remove redundant patterns
+- Use more specific patterns (faster matching)
+
+### 2. Complex Regex
+
+**Problem:**
+```regex
+(create|add|modify|update|implement|build).*?(feature|endpoint|route|service|controller|component|UI|page)
+```
+- Long alternations = slow
+
+**Solution:** Simplify
+```regex
+(create|add).*?(feature|endpoint)  // Fewer alternatives
+```
+
+### 3. Too Many Files Checked
+
+**Problem:**
+```json
+"pathPatterns": [
+  "**/*.ts"  // Checks ALL TypeScript files
+]
+```
+
+**Solution:** Be more specific
+```json
+"pathPatterns": [
+  "form/src/services/**/*.ts",  // Only specific directory
+  "form/src/controllers/**/*.ts"
+]
+```
+
+### 4. Large Files
+
+Content pattern matching reads entire file - slow for large files.
+
+**Solution:**
+- Only use content patterns when necessary
+- Consider file size limits (future enhancement)
+
+### Measure Performance
+
+```bash
+# UserPromptSubmit
+time echo '{"prompt":"test"}' | npx tsx .claude/hooks/skill-activation-prompt.ts
+
+# PreToolUse
+time cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts
+{"tool_name":"Edit","tool_input":{"file_path":"test.ts"}}
+EOF
+```
+
+**Target metrics:**
+- UserPromptSubmit: < 100ms
+- PreToolUse: < 200ms
+
+---
+
+**Related Files:**
+- [SKILL.md](SKILL.md) - Main skill guide
+- [HOOK_MECHANISMS.md](HOOK_MECHANISMS.md) - How hooks work
+- [SKILL_RULES_REFERENCE.md](SKILL_RULES_REFERENCE.md) - Configuration reference
diff --git a/.claude/skills/skill-rails-upgrade/SKILL.md b/.claude/skills/skill-rails-upgrade/SKILL.md
new file mode 100644
index 0000000..0c343d8
--- /dev/null
+++ b/.claude/skills/skill-rails-upgrade/SKILL.md
@@ -0,0 +1,408 @@
+---
+name: skill-rails-upgrade
+description: "Analyze Rails apps and provide upgrade assessments"
+source: "https://github.com/robzolkos/skill-rails-upgrade"
+risk: safe
+---
+
+## When to Use This Skill
+
+Analyze Rails apps and provide upgrade assessments
+
+Use this skill when working with analyze rails apps and provide upgrade assessments.
+# Rails Upgrade Analyzer
+
+Analyze the current Rails application and provide a comprehensive upgrade assessment with selective file merging.
+
+## Step 1: Verify Rails Application
+
+Check that we're in a Rails application by looking for these files:
+- `Gemfile` (must exist and contain 'rails')
+- `config/application.rb` (Rails application config)
+- `config/environment.rb` (Rails environment)
+
+If any of these are missing or don't indicate a Rails app, stop and inform the user this doesn't appear to be a Rails application.
+
+## Step 2: Get Current Rails Version
+
+Extract the current Rails version from:
+1. First, check `Gemfile.lock` for the exact installed version (look for `rails (x.y.z)`)
+2. If not found, check `Gemfile` for the version constraint
+
+Report the exact current version (e.g., `7.1.3`).
+
+## Step 3: Find Latest Rails Version
+
+Use the GitHub CLI to fetch the latest Rails release:
+
+```bash
+gh api repos/rails/rails/releases/latest --jq '.tag_name'
+```
+
+This returns the latest stable version tag (e.g., `v8.0.1`). Strip the 'v' prefix for comparison.
+
+Also check recent tags to understand the release landscape:
+
+```bash
+gh api repos/rails/rails/tags --jq '.[0:10] | .[].name'
+```
+
+## Step 4: Determine Upgrade Type
+
+Compare current and latest versions to classify the upgrade:
+
+- **Patch upgrade**: Same major.minor, different patch (e.g., 7.1.3 → 7.1.5)
+- **Minor upgrade**: Same major, different minor (e.g., 7.1.3 → 7.2.0)
+- **Major upgrade**: Different major version (e.g., 7.1.3 → 8.0.0)
+
+## Step 5: Fetch Upgrade Guide
+
+Use WebFetch to get the official Rails upgrade guide:
+
+URL: `https://guides.rubyonrails.org/upgrading_ruby_on_rails.html`
+
+Look for sections relevant to the version jump. The guide is organized by target version with sections like:
+- "Upgrading from Rails X.Y to Rails X.Z"
+- Breaking changes
+- Deprecation warnings
+- Configuration changes
+- Required migrations
+
+Extract and summarize the relevant sections for the user's specific upgrade path.
+
+## Step 6: Fetch Rails Diff
+
+Use WebFetch to get the diff between versions from railsdiff.org:
+
+URL: `https://railsdiff.org/{current_version}/{target_version}`
+
+For example: `https://railsdiff.org/7.1.3/8.0.0`
+
+This shows:
+- Changes to default configuration files
+- New files that need to be added
+- Modified initializers
+- Updated dependencies
+- Changes to bin/ scripts
+
+Summarize the key file changes.
+
+## Step 7: Check JavaScript Dependencies
+
+Rails applications often include JavaScript packages that should be updated alongside Rails. Check for and report on these dependencies.
+
+### 7.1: Identify JS Package Manager
+
+Check which package manager the app uses:
+
+```bash
+# Check for package.json (npm/yarn)
+ls package.json 2>/dev/null
+
+# Check for importmap (Rails 7+)
+ls config/importmap.rb 2>/dev/null
+```
+
+### 7.2: Check Rails-Related JS Packages
+
+If `package.json` exists, check for these Rails-related packages:
+
+```bash
+# Extract current versions of Rails-related packages
+cat package.json | grep -E '"@hotwired/|"@rails/|"stimulus"|"turbo-rails"' || echo "No Rails JS packages found"
+```
+
+**Key packages to check:**
+
+| Package | Purpose | Version Alignment |
+|---------|---------|-------------------|
+| `@hotwired/turbo-rails` | Turbo Drive/Frames/Streams | Should match Rails version era |
+| `@hotwired/stimulus` | Stimulus JS framework | Generally stable across Rails versions |
+| `@rails/actioncable` | WebSocket support | Should match Rails version |
+| `@rails/activestorage` | Direct uploads | Should match Rails version |
+| `@rails/actiontext` | Rich text editing | Should match Rails version |
+| `@rails/request.js` | Rails UJS replacement | Should match Rails version era |
+
+### 7.3: Check for Updates
+
+For npm/yarn projects, check for available updates:
+
+```bash
+# Using npm
+npm outdated @hotwired/turbo-rails @hotwired/stimulus @rails/actioncable @rails/activestorage 2>/dev/null
+
+# Or check latest versions directly
+npm view @hotwired/turbo-rails version 2>/dev/null
+npm view @rails/actioncable version 2>/dev/null
+```
+
+### 7.4: Check Importmap Pins (if applicable)
+
+If the app uses importmap-rails, check `config/importmap.rb` for pinned versions:
+
+```bash
+cat config/importmap.rb | grep -E 'pin.*turbo|pin.*stimulus|pin.*@rails' || echo "No importmap pins found"
+```
+
+To update importmap pins:
+```bash
+bin/importmap pin @hotwired/turbo-rails
+bin/importmap pin @hotwired/stimulus
+```
+
+### 7.5: JS Dependency Summary
+
+Include in the upgrade summary:
+
+```
+### JavaScript Dependencies
+
+**Package Manager**: [npm/yarn/importmap/none]
+
+| Package | Current | Latest | Action |
+|---------|---------|--------|--------|
+| @hotwired/turbo-rails | 8.0.4 | 8.0.12 | Update recommended |
+| @rails/actioncable | 7.1.0 | 8.0.0 | Update with Rails |
+| ... | ... | ... | ... |
+
+**Recommended JS Updates:**
+- Run `npm update @hotwired/turbo-rails` (or yarn equivalent)
+- Run `npm update @rails/actioncable @rails/activestorage` to match Rails version
+```
+
+---
+
+## Step 8: Generate Upgrade Summary
+
+Provide a comprehensive summary including all findings from Steps 1-7:
+
+### Version Information
+- Current version: X.Y.Z
+- Latest version: A.B.C
+- Upgrade type: [Patch/Minor/Major]
+
+### Upgrade Complexity Assessment
+
+Rate the upgrade as **Small**, **Medium**, or **Large** based on:
+
+| Factor | Small | Medium | Large |
+|--------|-------|--------|-------|
+| Version jump | Patch only | Minor version | Major version |
+| Breaking changes | None | Few, well-documented | Many, significant |
+| Config changes | Minimal | Moderate | Extensive |
+| Deprecations | None active | Some to address | Many requiring refactoring |
+| Dependencies | Compatible | Some updates needed | Major dependency updates |
+
+### Key Changes to Address
+
+List the most important changes the user needs to handle:
+1. Configuration file updates
+2. Deprecated methods/features to update
+3. New required dependencies
+4. Database migrations needed
+5. Breaking API changes
+
+### Recommended Upgrade Steps
+
+1. Update test suite and ensure passing
+2. Review deprecation warnings in current version
+3. Update Gemfile with new Rails version
+4. Run `bundle update rails`
+5. Update JavaScript dependencies (see JS Dependencies section)
+6. **DO NOT run `rails app:update` directly** - use the selective merge process below
+7. Run database migrations
+8. Run test suite
+9. Review and update deprecated code
+
+### Resources
+
+- Rails Upgrade Guide: https://guides.rubyonrails.org/upgrading_ruby_on_rails.html
+- Rails Diff: https://railsdiff.org/{current}/{target}
+- Release Notes: https://github.com/rails/rails/releases/tag/v{target}
+
+---
+
+
+## When to Use This Skill
+
+Analyze Rails apps and provide upgrade assessments
+
+Use this skill when working with analyze rails apps and provide upgrade assessments.
+## Step 9: Selective File Update (replaces `rails app:update`)
+
+**IMPORTANT:** Do NOT run `rails app:update` as it overwrites files without considering local customizations. Instead, follow this selective merge process:
+
+### 9.1: Detect Local Customizations
+
+Before any upgrade, identify files with local customizations:
+
+```bash
+# Check for uncommitted changes
+git status
+
+# List config files that differ from a fresh Rails app
+# These are the files we need to be careful with
+git diff HEAD --name-only -- config/ bin/ public/
+```
+
+Create a mental list of files in these categories:
+- **Custom config files**: Files with project-specific settings (i18n, mailer, etc.)
+- **Modified bin scripts**: Scripts with custom behavior (bin/dev with foreman, etc.)
+- **Standard files**: Files that haven't been customized
+
+### 9.2: Analyze Required Changes from Railsdiff
+
+Based on the railsdiff output from Step 6, categorize each changed file:
+
+| Category | Action | Example |
+|----------|--------|---------|
+| **New files** | Create directly | `config/initializers/new_framework_defaults_X_Y.rb` |
+| **Unchanged locally** | Safe to overwrite | `public/404.html` (if not customized) |
+| **Customized locally** | Manual merge needed | `config/application.rb`, `bin/dev` |
+| **Comment-only changes** | Usually skip | Minor comment updates in config files |
+
+### 9.3: Create Upgrade Plan
+
+Present the user with a clear upgrade plan:
+
+```
+## Upgrade Plan: Rails X.Y.Z → A.B.C
+
+### New Files (will be created):
+- config/initializers/new_framework_defaults_A_B.rb
+- bin/ci (new CI script)
+
+### Safe to Update (no local customizations):
+- public/400.html
+- public/404.html
+- public/500.html
+
+### Needs Manual Merge (local customizations detected):
+- config/application.rb
+  └─ Local: i18n configuration
+  └─ Rails: [describe new Rails changes if any]
+
+- config/environments/development.rb
+  └─ Local: letter_opener mailer config
+  └─ Rails: [describe new Rails changes]
+
+- bin/dev
+  └─ Local: foreman + Procfile.dev setup
+  └─ Rails: changed to simple ruby script
+
+### Skip (comment-only or irrelevant changes):
+- config/puma.rb (only comment changes)
+```
+
+### 9.4: Execute Upgrade Plan
+
+After user confirms the plan:
+
+#### For New Files:
+Create them directly using the content from railsdiff or by extracting from a fresh Rails app:
+
+```bash
+# Generate a temporary fresh Rails app to extract new files
+cd /tmp && rails new rails_template --skip-git --skip-bundle
+# Then copy needed files
+```
+
+Or use the Rails generator for specific files:
+```bash
+bin/rails app:update:configs  # Only updates config files, still interactive
+```
+
+#### For Safe Updates:
+Overwrite these files as they have no local customizations.
+
+#### For Manual Merges:
+For each file needing merge, show the user:
+
+1. **Current local version** (their customizations)
+2. **New Rails default** (from railsdiff)
+3. **Suggested merged version** that:
+   - Keeps all local customizations
+   - Adds only essential new Rails functionality
+   - Removes deprecated settings
+
+Example merge for `config/application.rb`:
+```ruby
+# KEEP local customizations:
+config.i18n.available_locales = [:de, :en]
+config.i18n.default_locale = :de
+config.i18n.fallbacks = [:en]
+
+# ADD new Rails 8.1 settings if needed:
+# (usually none required - new defaults come via new_framework_defaults file)
+```
+
+### 9.5: Handle Active Storage Migrations
+
+After file updates, run any new migrations:
+
+```bash
+bin/rails db:migrate
+```
+
+Check for new migrations that were added:
+```bash
+ls -la db/migrate/ | tail -10
+```
+
+### 9.6: Verify Upgrade
+
+After completing the merge:
+
+1. Start the Rails server and check for errors:
+   ```bash
+   bin/dev  # or bin/rails server
+   ```
+
+2. Check the Rails console:
+   ```bash
+   bin/rails console
+   ```
+
+3. Run the test suite:
+   ```bash
+   bin/rails test
+   ```
+
+4. Review deprecation warnings in logs
+
+---
+
+## Step 10: Finalize Framework Defaults
+
+After verifying the app works:
+
+1. Review `config/initializers/new_framework_defaults_X_Y.rb`
+2. Enable each new default one by one, testing after each
+3. Once all defaults are enabled and tested, update `config/application.rb`:
+   ```ruby
+   config.load_defaults X.Y  # Update to new version
+   ```
+4. Delete the `new_framework_defaults_X_Y.rb` file
+
+---
+
+
+## When to Use This Skill
+
+Analyze Rails apps and provide upgrade assessments
+
+Use this skill when working with analyze rails apps and provide upgrade assessments.
+## Error Handling
+
+- If `gh` CLI is not authenticated, instruct the user to run `gh auth login`
+- If railsdiff.org doesn't have the exact versions, try with major.minor.0 versions
+- If the app is already on the latest version, congratulate the user and note any upcoming releases
+- If local customizations would be lost, ALWAYS stop and show the user what would be overwritten before proceeding
+
+## Key Principles
+
+1. **Never overwrite without checking** - Always check for local customizations first
+2. **Preserve user intent** - Local customizations exist for a reason
+3. **Minimal changes** - Only add what's necessary for the new Rails version
+4. **Transparency** - Show the user exactly what will change before doing it
+5. **Reversibility** - User should be able to `git checkout` to restore if needed
diff --git a/.claude/skills/skill-seekers/SKILL.md b/.claude/skills/skill-seekers/SKILL.md
new file mode 100644
index 0000000..c96bab9
--- /dev/null
+++ b/.claude/skills/skill-seekers/SKILL.md
@@ -0,0 +1,22 @@
+---
+name: skill-seekers
+description: "-Automatically convert documentation websites, GitHub repositories, and PDFs into Claude AI skills in minutes."
+source: "https://github.com/yusufkaraaslan/Skill_Seekers"
+risk: safe
+---
+
+# Skill Seekers
+
+## Overview
+
+-Automatically convert documentation websites, GitHub repositories, and PDFs into Claude AI skills in minutes.
+
+## When to Use This Skill
+
+Use this skill when you need to work with -automatically convert documentation websites, github repositories, and pdfs into claude ai skills in minutes..
+
+## Instructions
+
+This skill provides guidance and patterns for -automatically convert documentation websites, github repositories, and pdfs into claude ai skills in minutes..
+
+For more information, see the [source repository](https://github.com/yusufkaraaslan/Skill_Seekers).
diff --git a/.claude/skills/tdd/SKILL.md b/.claude/skills/tdd/SKILL.md
new file mode 100644
index 0000000..7a98941
--- /dev/null
+++ b/.claude/skills/tdd/SKILL.md
@@ -0,0 +1,109 @@
+---
+name: tdd
+description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
+---
+
+# Test-Driven Development
+
+## Philosophy
+
+**Core principle**: Tests should verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't.
+
+**Good tests** are integration-style: they exercise real code paths through public APIs. They describe _what_ the system does, not _how_ it does it. A good test reads like a specification - "user can checkout with valid cart" tells you exactly what capability exists. These tests survive refactors because they don't care about internal structure.
+
+**Bad tests** are coupled to implementation. They mock internal collaborators, test private methods, or verify through external means (like querying a database directly instead of using the interface). The warning sign: your test breaks when you refactor, but behavior hasn't changed. If you rename an internal function and tests fail, those tests were testing implementation, not behavior.
+
+See [tests.md](tests.md) for examples and [mocking.md](mocking.md) for mocking guidelines.
+
+## Anti-Pattern: Horizontal Slices
+
+**DO NOT write all tests first, then all implementation.** This is "horizontal slicing" - treating RED as "write all tests" and GREEN as "write all code."
+
+This produces **crap tests**:
+
+- Tests written in bulk test _imagined_ behavior, not _actual_ behavior
+- You end up testing the _shape_ of things (data structures, function signatures) rather than user-facing behavior
+- Tests become insensitive to real changes - they pass when behavior breaks, fail when behavior is fine
+- You outrun your headlights, committing to test structure before understanding the implementation
+
+**Correct approach**: Vertical slices via tracer bullets. One test → one implementation → repeat. Each test responds to what you learned from the previous cycle. Because you just wrote the code, you know exactly what behavior matters and how to verify it.
+
+```
+WRONG (horizontal):
+  RED:   test1, test2, test3, test4, test5
+  GREEN: impl1, impl2, impl3, impl4, impl5
+
+RIGHT (vertical):
+  RED→GREEN: test1→impl1
+  RED→GREEN: test2→impl2
+  RED→GREEN: test3→impl3
+  ...
+```
+
+## Workflow
+
+### 1. Planning
+
+When exploring the codebase, use the project's domain glossary so that test names and interface vocabulary match the project's language, and respect ADRs in the area you're touching.
+
+Before writing any code:
+
+- [ ] Confirm with user what interface changes are needed
+- [ ] Confirm with user which behaviors to test (prioritize)
+- [ ] Identify opportunities for [deep modules](deep-modules.md) (small interface, deep implementation)
+- [ ] Design interfaces for [testability](interface-design.md)
+- [ ] List the behaviors to test (not implementation steps)
+- [ ] Get user approval on the plan
+
+Ask: "What should the public interface look like? Which behaviors are most important to test?"
+
+**You can't test everything.** Confirm with the user exactly which behaviors matter most. Focus testing effort on critical paths and complex logic, not every possible edge case.
+
+### 2. Tracer Bullet
+
+Write ONE test that confirms ONE thing about the system:
+
+```
+RED:   Write test for first behavior → test fails
+GREEN: Write minimal code to pass → test passes
+```
+
+This is your tracer bullet - proves the path works end-to-end.
+
+### 3. Incremental Loop
+
+For each remaining behavior:
+
+```
+RED:   Write next test → fails
+GREEN: Minimal code to pass → passes
+```
+
+Rules:
+
+- One test at a time
+- Only enough code to pass current test
+- Don't anticipate future tests
+- Keep tests focused on observable behavior
+
+### 4. Refactor
+
+After all tests pass, look for [refactor candidates](refactoring.md):
+
+- [ ] Extract duplication
+- [ ] Deepen modules (move complexity behind simple interfaces)
+- [ ] Apply SOLID principles where natural
+- [ ] Consider what new code reveals about existing code
+- [ ] Run tests after each refactor step
+
+**Never refactor while RED.** Get to GREEN first.
+
+## Checklist Per Cycle
+
+```
+[ ] Test describes behavior, not implementation
+[ ] Test uses public interface only
+[ ] Test would survive internal refactor
+[ ] Code is minimal for this test
+[ ] No speculative features added
+```
diff --git a/.claude/skills/tdd/deep-modules.md b/.claude/skills/tdd/deep-modules.md
new file mode 100644
index 0000000..0d9720c
--- /dev/null
+++ b/.claude/skills/tdd/deep-modules.md
@@ -0,0 +1,33 @@
+# Deep Modules
+
+From "A Philosophy of Software Design":
+
+**Deep module** = small interface + lots of implementation
+
+```
+┌─────────────────────┐
+│   Small Interface   │  ← Few methods, simple params
+├─────────────────────┤
+│                     │
+│                     │
+│  Deep Implementation│  ← Complex logic hidden
+│                     │
+│                     │
+└─────────────────────┘
+```
+
+**Shallow module** = large interface + little implementation (avoid)
+
+```
+┌─────────────────────────────────┐
+│       Large Interface           │  ← Many methods, complex params
+├─────────────────────────────────┤
+│  Thin Implementation            │  ← Just passes through
+└─────────────────────────────────┘
+```
+
+When designing interfaces, ask:
+
+- Can I reduce the number of methods?
+- Can I simplify the parameters?
+- Can I hide more complexity inside?
diff --git a/.claude/skills/tdd/interface-design.md b/.claude/skills/tdd/interface-design.md
new file mode 100644
index 0000000..a0a20ca
--- /dev/null
+++ b/.claude/skills/tdd/interface-design.md
@@ -0,0 +1,31 @@
+# Interface Design for Testability
+
+Good interfaces make testing natural:
+
+1. **Accept dependencies, don't create them**
+
+   ```typescript
+   // Testable
+   function processOrder(order, paymentGateway) {}
+
+   // Hard to test
+   function processOrder(order) {
+     const gateway = new StripeGateway();
+   }
+   ```
+
+2. **Return results, don't produce side effects**
+
+   ```typescript
+   // Testable
+   function calculateDiscount(cart): Discount {}
+
+   // Hard to test
+   function applyDiscount(cart): void {
+     cart.total -= discount;
+   }
+   ```
+
+3. **Small surface area**
+   - Fewer methods = fewer tests needed
+   - Fewer params = simpler test setup
diff --git a/.claude/skills/tdd/mocking.md b/.claude/skills/tdd/mocking.md
new file mode 100644
index 0000000..71cbfee
--- /dev/null
+++ b/.claude/skills/tdd/mocking.md
@@ -0,0 +1,59 @@
+# When to Mock
+
+Mock at **system boundaries** only:
+
+- External APIs (payment, email, etc.)
+- Databases (sometimes - prefer test DB)
+- Time/randomness
+- File system (sometimes)
+
+Don't mock:
+
+- Your own classes/modules
+- Internal collaborators
+- Anything you control
+
+## Designing for Mockability
+
+At system boundaries, design interfaces that are easy to mock:
+
+**1. Use dependency injection**
+
+Pass external dependencies in rather than creating them internally:
+
+```typescript
+// Easy to mock
+function processPayment(order, paymentClient) {
+  return paymentClient.charge(order.total);
+}
+
+// Hard to mock
+function processPayment(order) {
+  const client = new StripeClient(process.env.STRIPE_KEY);
+  return client.charge(order.total);
+}
+```
+
+**2. Prefer SDK-style interfaces over generic fetchers**
+
+Create specific functions for each external operation instead of one generic function with conditional logic:
+
+```typescript
+// GOOD: Each function is independently mockable
+const api = {
+  getUser: (id) => fetch(`/users/${id}`),
+  getOrders: (userId) => fetch(`/users/${userId}/orders`),
+  createOrder: (data) => fetch('/orders', { method: 'POST', body: data }),
+};
+
+// BAD: Mocking requires conditional logic inside the mock
+const api = {
+  fetch: (endpoint, options) => fetch(endpoint, options),
+};
+```
+
+The SDK approach means:
+- Each mock returns one specific shape
+- No conditional logic in test setup
+- Easier to see which endpoints a test exercises
+- Type safety per endpoint
diff --git a/.claude/skills/tdd/refactoring.md b/.claude/skills/tdd/refactoring.md
new file mode 100644
index 0000000..8a44439
--- /dev/null
+++ b/.claude/skills/tdd/refactoring.md
@@ -0,0 +1,10 @@
+# Refactor Candidates
+
+After TDD cycle, look for:
+
+- **Duplication** → Extract function/class
+- **Long methods** → Break into private helpers (keep tests on public interface)
+- **Shallow modules** → Combine or deepen
+- **Feature envy** → Move logic to where data lives
+- **Primitive obsession** → Introduce value objects
+- **Existing code** the new code reveals as problematic
diff --git a/.claude/skills/tdd/tests.md b/.claude/skills/tdd/tests.md
new file mode 100644
index 0000000..ff22f80
--- /dev/null
+++ b/.claude/skills/tdd/tests.md
@@ -0,0 +1,61 @@
+# Good and Bad Tests
+
+## Good Tests
+
+**Integration-style**: Test through real interfaces, not mocks of internal parts.
+
+```typescript
+// GOOD: Tests observable behavior
+test("user can checkout with valid cart", async () => {
+  const cart = createCart();
+  cart.add(product);
+  const result = await checkout(cart, paymentMethod);
+  expect(result.status).toBe("confirmed");
+});
+```
+
+Characteristics:
+
+- Tests behavior users/callers care about
+- Uses public API only
+- Survives internal refactors
+- Describes WHAT, not HOW
+- One logical assertion per test
+
+## Bad Tests
+
+**Implementation-detail tests**: Coupled to internal structure.
+
+```typescript
+// BAD: Tests implementation details
+test("checkout calls paymentService.process", async () => {
+  const mockPayment = jest.mock(paymentService);
+  await checkout(cart, payment);
+  expect(mockPayment.process).toHaveBeenCalledWith(cart.total);
+});
+```
+
+Red flags:
+
+- Mocking internal collaborators
+- Testing private methods
+- Asserting on call counts/order
+- Test breaks when refactoring without behavior change
+- Test name describes HOW not WHAT
+- Verifying through external means instead of interface
+
+```typescript
+// BAD: Bypasses interface to verify
+test("createUser saves to database", async () => {
+  await createUser({ name: "Alice" });
+  const row = await db.query("SELECT * FROM users WHERE name = ?", ["Alice"]);
+  expect(row).toBeDefined();
+});
+
+// GOOD: Verifies through interface
+test("createUser makes user retrievable", async () => {
+  const user = await createUser({ name: "Alice" });
+  const retrieved = await getUser(user.id);
+  expect(retrieved.name).toBe("Alice");
+});
+```
diff --git a/.claude/skills/to-issues/SKILL.md b/.claude/skills/to-issues/SKILL.md
new file mode 100644
index 0000000..9f6efbf
--- /dev/null
+++ b/.claude/skills/to-issues/SKILL.md
@@ -0,0 +1,83 @@
+---
+name: to-issues
+description: Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
+---
+
+# To Issues
+
+Break a plan into independently-grabbable issues using vertical slices (tracer bullets).
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+### 1. Gather context
+
+Work from whatever is already in the conversation context. If the user passes an issue reference (issue number, URL, or path) as an argument, fetch it from the issue tracker and read its full body and comments.
+
+### 2. Explore the codebase (optional)
+
+If you have not already explored the codebase, do so to understand the current state of the code. Issue titles and descriptions should use the project's domain glossary vocabulary, and respect ADRs in the area you're touching.
+
+### 3. Draft vertical slices
+
+Break the plan into **tracer bullet** issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer.
+
+Slices may be 'HITL' or 'AFK'. HITL slices require human interaction, such as an architectural decision or a design review. AFK slices can be implemented and merged without human interaction. Prefer AFK over HITL where possible.
+
+<vertical-slice-rules>
+- Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests)
+- A completed slice is demoable or verifiable on its own
+- Prefer many thin slices over few thick ones
+</vertical-slice-rules>
+
+### 4. Quiz the user
+
+Present the proposed breakdown as a numbered list. For each slice, show:
+
+- **Title**: short descriptive name
+- **Type**: HITL / AFK
+- **Blocked by**: which other slices (if any) must complete first
+- **User stories covered**: which user stories this addresses (if the source material has them)
+
+Ask the user:
+
+- Does the granularity feel right? (too coarse / too fine)
+- Are the dependency relationships correct?
+- Should any slices be merged or split further?
+- Are the correct slices marked as HITL and AFK?
+
+Iterate until the user approves the breakdown.
+
+### 5. Publish the issues to the issue tracker
+
+For each approved slice, publish a new issue to the issue tracker. Use the issue body template below. These issues are considered ready for AFK agents, so publish them with the correct triage label unless instructed otherwise.
+
+Publish issues in dependency order (blockers first) so you can reference real issue identifiers in the "Blocked by" field.
+
+<issue-template>
+## Parent
+
+A reference to the parent issue on the issue tracker (if the source was an existing issue, otherwise omit this section).
+
+## What to build
+
+A concise description of this vertical slice. Describe the end-to-end behavior, not layer-by-layer implementation.
+
+Avoid specific file paths or code snippets — they go stale fast. Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it here and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Acceptance criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Blocked by
+
+- A reference to the blocking ticket (if any)
+
+Or "None - can start immediately" if no blockers.
+
+</issue-template>
+
+Do NOT close or modify any parent issue.
diff --git a/.claude/skills/to-prd/SKILL.md b/.claude/skills/to-prd/SKILL.md
new file mode 100644
index 0000000..47a01d4
--- /dev/null
+++ b/.claude/skills/to-prd/SKILL.md
@@ -0,0 +1,76 @@
+---
+name: to-prd
+description: Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
+---
+
+This skill takes the current conversation context and codebase understanding and produces a PRD. Do NOT interview the user — just synthesize what you already know.
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+1. Explore the repo to understand the current state of the codebase, if you haven't already. Use the project's domain glossary vocabulary throughout the PRD, and respect any ADRs in the area you're touching.
+
+2. Sketch out the major modules you will need to build or modify to complete the implementation. Actively look for opportunities to extract deep modules that can be tested in isolation.
+
+A deep module (as opposed to a shallow module) is one which encapsulates a lot of functionality in a simple, testable interface which rarely changes.
+
+Check with the user that these modules match their expectations. Check with the user which modules they want tests written for.
+
+3. Write the PRD using the template below, then publish it to the project issue tracker. Apply the `ready-for-agent` triage label - no need for additional triage.
+
+<prd-template>
+
+## Problem Statement
+
+The problem that the user is facing, from the user's perspective.
+
+## Solution
+
+The solution to the problem, from the user's perspective.
+
+## User Stories
+
+A LONG, numbered list of user stories. Each user story should be in the format of:
+
+1. As an <actor>, I want a <feature>, so that <benefit>
+
+<user-story-example>
+1. As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending
+</user-story-example>
+
+This list of user stories should be extremely extensive and cover all aspects of the feature.
+
+## Implementation Decisions
+
+A list of implementation decisions that were made. This can include:
+
+- The modules that will be built/modified
+- The interfaces of those modules that will be modified
+- Technical clarifications from the developer
+- Architectural decisions
+- Schema changes
+- API contracts
+- Specific interactions
+
+Do NOT include specific file paths or code snippets. They may end up being outdated very quickly.
+
+Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it within the relevant decision and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Testing Decisions
+
+A list of testing decisions that were made. Include:
+
+- A description of what makes a good test (only test external behavior, not implementation details)
+- Which modules will be tested
+- Prior art for the tests (i.e. similar types of tests in the codebase)
+
+## Out of Scope
+
+A description of the things that are out of scope for this PRD.
+
+## Further Notes
+
+Any further notes about the feature.
+
+</prd-template>
diff --git a/.claude/skills/triage/AGENT-BRIEF.md b/.claude/skills/triage/AGENT-BRIEF.md
new file mode 100644
index 0000000..2efecdf
--- /dev/null
+++ b/.claude/skills/triage/AGENT-BRIEF.md
@@ -0,0 +1,168 @@
+# Writing Agent Briefs
+
+An agent brief is a structured comment posted on a GitHub issue when it moves to `ready-for-agent`. It is the authoritative specification that an AFK agent will work from. The original issue body and discussion are context — the agent brief is the contract.
+
+## Principles
+
+### Durability over precision
+
+The issue may sit in `ready-for-agent` for days or weeks. The codebase will change in the meantime. Write the brief so it stays useful even as files are renamed, moved, or refactored.
+
+- **Do** describe interfaces, types, and behavioral contracts
+- **Do** name specific types, function signatures, or config shapes that the agent should look for or modify
+- **Don't** reference file paths — they go stale
+- **Don't** reference line numbers
+- **Don't** assume the current implementation structure will remain the same
+
+### Behavioral, not procedural
+
+Describe **what** the system should do, not **how** to implement it. The agent will explore the codebase fresh and make its own implementation decisions.
+
+- **Good:** "The `SkillConfig` type should accept an optional `schedule` field of type `CronExpression`"
+- **Bad:** "Open src/types/skill.ts and add a schedule field on line 42"
+- **Good:** "When a user runs `/triage` with no arguments, they should see a summary of issues needing attention"
+- **Bad:** "Add a switch statement in the main handler function"
+
+### Complete acceptance criteria
+
+The agent needs to know when it's done. Every agent brief must have concrete, testable acceptance criteria. Each criterion should be independently verifiable.
+
+- **Good:** "Running `gh issue list --label needs-triage` returns issues that have been through initial classification"
+- **Bad:** "Triage should work correctly"
+
+### Explicit scope boundaries
+
+State what is out of scope. This prevents the agent from gold-plating or making assumptions about adjacent features.
+
+## Template
+
+```markdown
+## Agent Brief
+
+**Category:** bug / enhancement
+**Summary:** one-line description of what needs to happen
+
+**Current behavior:**
+Describe what happens now. For bugs, this is the broken behavior.
+For enhancements, this is the status quo the feature builds on.
+
+**Desired behavior:**
+Describe what should happen after the agent's work is complete.
+Be specific about edge cases and error conditions.
+
+**Key interfaces:**
+- `TypeName` — what needs to change and why
+- `functionName()` return type — what it currently returns vs what it should return
+- Config shape — any new configuration options needed
+
+**Acceptance criteria:**
+- [ ] Specific, testable criterion 1
+- [ ] Specific, testable criterion 2
+- [ ] Specific, testable criterion 3
+
+**Out of scope:**
+- Thing that should NOT be changed or addressed in this issue
+- Adjacent feature that might seem related but is separate
+```
+
+## Examples
+
+### Good agent brief (bug)
+
+```markdown
+## Agent Brief
+
+**Category:** bug
+**Summary:** Skill description truncation drops mid-word, producing broken output
+
+**Current behavior:**
+When a skill description exceeds 1024 characters, it is truncated at exactly
+1024 characters regardless of word boundaries. This produces descriptions
+that end mid-word (e.g. "Use when the user wants to confi").
+
+**Desired behavior:**
+Truncation should break at the last word boundary before 1024 characters
+and append "..." to indicate truncation.
+
+**Key interfaces:**
+- The `SkillMetadata` type's `description` field — no type change needed,
+  but the validation/processing logic that populates it needs to respect
+  word boundaries
+- Any function that reads SKILL.md frontmatter and extracts the description
+
+**Acceptance criteria:**
+- [ ] Descriptions under 1024 chars are unchanged
+- [ ] Descriptions over 1024 chars are truncated at the last word boundary
+      before 1024 chars
+- [ ] Truncated descriptions end with "..."
+- [ ] The total length including "..." does not exceed 1024 chars
+
+**Out of scope:**
+- Changing the 1024 char limit itself
+- Multi-line description support
+```
+
+### Good agent brief (enhancement)
+
+```markdown
+## Agent Brief
+
+**Category:** enhancement
+**Summary:** Add `.out-of-scope/` directory support for tracking rejected feature requests
+
+**Current behavior:**
+When a feature request is rejected, the issue is closed with a `wontfix` label
+and a comment. There is no persistent record of the decision or reasoning.
+Future similar requests require the maintainer to recall or search for the
+prior discussion.
+
+**Desired behavior:**
+Rejected feature requests should be documented in `.out-of-scope/<concept>.md`
+files that capture the decision, reasoning, and links to all issues that
+requested the feature. When triaging new issues, these files should be
+checked for matches.
+
+**Key interfaces:**
+- Markdown file format in `.out-of-scope/` — each file should have a
+  `# Concept Name` heading, a `**Decision:**` line, a `**Reason:**` line,
+  and a `**Prior requests:**` list with issue links
+- The triage workflow should read all `.out-of-scope/*.md` files early
+  and match incoming issues against them by concept similarity
+
+**Acceptance criteria:**
+- [ ] Closing a feature as wontfix creates/updates a file in `.out-of-scope/`
+- [ ] The file includes the decision, reasoning, and link to the closed issue
+- [ ] If a matching `.out-of-scope/` file already exists, the new issue is
+      appended to its "Prior requests" list rather than creating a duplicate
+- [ ] During triage, existing `.out-of-scope/` files are checked and surfaced
+      when a new issue matches a prior rejection
+
+**Out of scope:**
+- Automated matching (human confirms the match)
+- Reopening previously rejected features
+- Bug reports (only enhancement rejections go to `.out-of-scope/`)
+```
+
+### Bad agent brief
+
+```markdown
+## Agent Brief
+
+**Summary:** Fix the triage bug
+
+**What to do:**
+The triage thing is broken. Look at the main file and fix it.
+The function around line 150 has the issue.
+
+**Files to change:**
+- src/triage/handler.ts (line 150)
+- src/types.ts (line 42)
+```
+
+This is bad because:
+- No category
+- Vague description ("the triage thing is broken")
+- References file paths and line numbers that will go stale
+- No acceptance criteria
+- No scope boundaries
+- No description of current vs desired behavior
diff --git a/.claude/skills/triage/OUT-OF-SCOPE.md b/.claude/skills/triage/OUT-OF-SCOPE.md
new file mode 100644
index 0000000..cc8ea25
--- /dev/null
+++ b/.claude/skills/triage/OUT-OF-SCOPE.md
@@ -0,0 +1,101 @@
+# Out-of-Scope Knowledge Base
+
+The `.out-of-scope/` directory in a repo stores persistent records of rejected feature requests. It serves two purposes:
+
+1. **Institutional memory** — why a feature was rejected, so the reasoning isn't lost when the issue is closed
+2. **Deduplication** — when a new issue comes in that matches a prior rejection, the skill can surface the previous decision instead of re-litigating it
+
+## Directory structure
+
+```
+.out-of-scope/
+├── dark-mode.md
+├── plugin-system.md
+└── graphql-api.md
+```
+
+One file per **concept**, not per issue. Multiple issues requesting the same thing are grouped under one file.
+
+## File format
+
+The file should be written in a relaxed, readable style — more like a short design document than a database entry. Use paragraphs, code samples, and examples to make the reasoning clear and useful to someone encountering it for the first time.
+
+```markdown
+# Dark Mode
+
+This project does not support dark mode or user-facing theming.
+
+## Why this is out of scope
+
+The rendering pipeline assumes a single color palette defined in
+`ThemeConfig`. Supporting multiple themes would require:
+
+- A theme context provider wrapping the entire component tree
+- Per-component theme-aware style resolution
+- A persistence layer for user theme preferences
+
+This is a significant architectural change that doesn't align with the
+project's focus on content authoring. Theming is a concern for downstream
+consumers who embed or redistribute the output.
+
+```ts
+// The current ThemeConfig interface is not designed for runtime switching:
+interface ThemeConfig {
+  colors: ColorPalette; // single palette, resolved at build time
+  fonts: FontStack;
+}
+```
+
+## Prior requests
+
+- #42 — "Add dark mode support"
+- #87 — "Night theme for accessibility"
+- #134 — "Dark theme option"
+```
+
+### Naming the file
+
+Use a short, descriptive kebab-case name for the concept: `dark-mode.md`, `plugin-system.md`, `graphql-api.md`. The name should be recognizable enough that someone browsing the directory understands what was rejected without opening the file.
+
+### Writing the reason
+
+The reason should be substantive — not "we don't want this" but why. Good reasons reference:
+
+- Project scope or philosophy ("This project focuses on X; theming is a downstream concern")
+- Technical constraints ("Supporting this would require Y, which conflicts with our Z architecture")
+- Strategic decisions ("We chose to use A instead of B because...")
+
+The reason should be durable. Avoid referencing temporary circumstances ("we're too busy right now") — those aren't real rejections, they're deferrals.
+
+## When to check `.out-of-scope/`
+
+During triage (Step 1: Gather context), read all files in `.out-of-scope/`. When evaluating a new issue:
+
+- Check if the request matches an existing out-of-scope concept
+- Matching is by concept similarity, not keyword — "night theme" matches `dark-mode.md`
+- If there's a match, surface it to the maintainer: "This is similar to `.out-of-scope/dark-mode.md` — we rejected this before because [reason]. Do you still feel the same way?"
+
+The maintainer may:
+
+- **Confirm** — the new issue gets added to the existing file's "Prior requests" list, then closed
+- **Reconsider** — the out-of-scope file gets deleted or updated, and the issue proceeds through normal triage
+- **Disagree** — the issues are related but distinct, proceed with normal triage
+
+## When to write to `.out-of-scope/`
+
+Only when an **enhancement** (not a bug) is rejected as `wontfix`. The flow:
+
+1. Maintainer decides a feature request is out of scope
+2. Check if a matching `.out-of-scope/` file already exists
+3. If yes: append the new issue to the "Prior requests" list
+4. If no: create a new file with the concept name, decision, reason, and first prior request
+5. Post a comment on the issue explaining the decision and mentioning the `.out-of-scope/` file
+6. Close the issue with the `wontfix` label
+
+## Updating or removing out-of-scope files
+
+If the maintainer changes their mind about a previously rejected concept:
+
+- Delete the `.out-of-scope/` file
+- The skill does not need to reopen old issues — they're historical records
+- The new issue that triggered the reconsideration proceeds through normal triage
diff --git a/.claude/skills/triage/SKILL.md b/.claude/skills/triage/SKILL.md
new file mode 100644
index 0000000..3dee68f
--- /dev/null
+++ b/.claude/skills/triage/SKILL.md
@@ -0,0 +1,103 @@
+---
+name: triage
+description: Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
+---
+
+# Triage
+
+Move issues on the project issue tracker through a small state machine of triage roles.
+
+Every comment or issue posted to the issue tracker during triage **must** start with this disclaimer:
+
+```
+> *This was generated by AI during triage.*
+```
+
+## Reference docs
+
+- [AGENT-BRIEF.md](AGENT-BRIEF.md) — how to write durable agent briefs
+- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — how the `.out-of-scope/` knowledge base works
+
+## Roles
+
+Two **category** roles:
+
+- `bug` — something is broken
+- `enhancement` — new feature or improvement
+
+Five **state** roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter for more information
+- `ready-for-agent` — fully specified, ready for an AFK agent
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Every triaged issue should carry exactly one category role and one state role. If state roles conflict, flag it and ask the maintainer before doing anything else.
+
+These are canonical role names — the actual label strings used in the issue tracker may differ. The mapping should have been provided to you - run `/setup-matt-pocock-skills` if not.
+
+State transitions: an unlabeled issue normally goes to `needs-triage` first; from there it moves to `needs-info`, `ready-for-agent`, `ready-for-human`, or `wontfix`. `needs-info` returns to `needs-triage` once the reporter replies. The maintainer can override at any time — flag transitions that look unusual and ask before proceeding.
+
+## Invocation
+
+The maintainer invokes `/triage` and describes what they want in natural language. Interpret the request and act. Examples:
+
+- "Show me anything that needs my attention"
+- "Let's look at #42"
+- "Move #42 to ready-for-agent"
+- "What's ready for agents to pick up?"
+
+## Show what needs attention
+
+Query the issue tracker and present three buckets, oldest first:
+
+1. **Unlabeled** — never triaged.
+2. **`needs-triage`** — evaluation in progress.
+3. **`needs-info` with reporter activity since the last triage notes** — needs re-evaluation.
+
+Show counts and a one-line summary per issue. Let the maintainer pick.
+
+## Triage a specific issue
+
+1. **Gather context.** Read the full issue (body, comments, labels, reporter, dates). Parse any prior triage notes so you don't re-ask resolved questions. Explore the codebase using the project's domain glossary, respecting ADRs in the area. Read `.out-of-scope/*.md` and surface any prior rejection that resembles this issue.
+
+2. **Recommend.** Tell the maintainer your category and state recommendation with reasoning, plus a brief codebase summary relevant to the issue. Wait for direction.
+
+3. **Reproduce (bugs only).** Before any grilling, attempt reproduction: read the reporter's steps, trace the relevant code, run tests or commands. Report what happened — successful repro with code path, failed repro, or insufficient detail (a strong `needs-info` signal). A confirmed repro makes a much stronger agent brief.
+
+4. **Grill (if needed).** If the issue needs fleshing out, run a `/grill-with-docs` session.
+
+5. **Apply the outcome:**
+   - `ready-for-agent` — post an agent brief comment ([AGENT-BRIEF.md](AGENT-BRIEF.md)).
+   - `ready-for-human` — same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing).
+   - `needs-info` — post triage notes (template below).
+   - `wontfix` (bug) — polite explanation, then close.
+   - `wontfix` (enhancement) — write to `.out-of-scope/`, link to it from a comment, then close ([OUT-OF-SCOPE.md](OUT-OF-SCOPE.md)).
+   - `needs-triage` — apply the role. Optional comment if there's partial progress.
+
+## Quick state override
+
+If the maintainer says "move #42 to ready-for-agent", trust them and apply the role directly. Confirm what you're about to do (role changes, comment, close), then act. Skip grilling. If moving to `ready-for-agent` without a grilling session, ask whether they want to write an agent brief.
+
+## Needs-info template
+
+```markdown
+## Triage Notes
+
+**What we've established so far:**
+
+- point 1
+- point 2
+
+**What we still need from you (@reporter):**
+
+- question 1
+- question 2
+```
+
+Capture everything resolved during grilling under "established so far" so the work isn't lost. Questions must be specific and actionable, not "please provide more info".
+
+## Resuming a previous session
+
+If prior triage notes exist on the issue, read them, check whether the reporter has answered any outstanding questions, and present an updated picture before continuing. Don't re-ask resolved questions.
diff --git a/.claude/skills/ui-skills/SKILL.md b/.claude/skills/ui-skills/SKILL.md
new file mode 100644
index 0000000..d4dac09
--- /dev/null
+++ b/.claude/skills/ui-skills/SKILL.md
@@ -0,0 +1,22 @@
+---
+name: ui-skills
+description: "Opinionated, evolving constraints to guide agents when building interfaces"
+source: "https://github.com/ibelick/ui-skills"
+risk: safe
+---
+
+# Ui Skills
+
+## Overview
+
+Opinionated, evolving constraints to guide agents when building interfaces
+
+## When to Use This Skill
+
+Use this skill when you need to work with opinionated, evolving constraints to guide agents when building interfaces.
+
+## Instructions
+
+This skill provides guidance and patterns for opinionated, evolving constraints to guide agents when building interfaces.
+
+For more information, see the [source repository](https://github.com/ibelick/ui-skills).
diff --git a/.claude/skills/ui-ux-designer/SKILL.md b/.claude/skills/ui-ux-designer/SKILL.md
new file mode 100644
index 0000000..c251529
--- /dev/null
+++ b/.claude/skills/ui-ux-designer/SKILL.md
@@ -0,0 +1,209 @@
+---
+name: ui-ux-designer
+description: Create interface designs, wireframes, and design systems. Masters
+  user research, accessibility standards, and modern design tools. Specializes
+  in design tokens, component libraries, and inclusive design. Use PROACTIVELY
+  for design systems, user flows, or interface optimization.
+metadata:
+  model: sonnet
+---
+
+## Use this skill when
+
+- Working on ui ux designer tasks or workflows
+- Needing guidance, best practices, or checklists for ui ux designer
+
+## Do not use this skill when
+
+- The task is unrelated to ui ux designer
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a UI/UX design expert specializing in user-centered design, modern design systems, and accessible interface creation.
+
+## Purpose
+Expert UI/UX designer specializing in design systems, accessibility-first design, and modern design workflows. Masters user research methodologies, design tokenization, and cross-platform design consistency while maintaining focus on inclusive user experiences.
+
+## Capabilities
+
+### Design Systems Mastery
+- Atomic design methodology with token-based architecture
+- Design token creation and management (Figma Variables, Style Dictionary)
+- Component library design with comprehensive documentation
+- Multi-brand design system architecture and scaling
+- Design system governance and maintenance workflows
+- Version control for design systems with branching strategies
+- Design-to-development handoff optimization
+- Cross-platform design system adaptation (web, mobile, desktop)
+
+### Modern Design Tools & Workflows
+- Figma advanced features (Auto Layout, Variants, Components, Variables)
+- Figma plugin development for workflow optimization
+- Design system integration with development tools (Storybook, Chromatic)
+- Collaborative design workflows and real-time team coordination
+- Design version control and branching strategies
+- Prototyping with advanced interactions and micro-animations
+- Design handoff tools and developer collaboration
+- Asset generation and optimization for multiple platforms
+
+### User Research & Analysis
+- Quantitative and qualitative research methodologies
+- User interview planning, execution, and analysis
+- Usability testing design and moderation
+- A/B testing design and statistical analysis
+- User journey mapping and experience flow optimization
+- Persona development based on research data
+- Card sorting and information architecture validation
+- Analytics integration and user behavior analysis
+
+### Accessibility & Inclusive Design
+- WCAG 2.1/2.2 AA and AAA compliance implementation
+- Accessibility audit methodologies and remediation strategies
+- Color contrast analysis and accessible color palette creation
+- Screen reader optimization and semantic markup planning
+- Keyboard navigation and focus management design
+- Cognitive accessibility and plain language principles
+- Inclusive design patterns for diverse user needs
+- Accessibility testing integration into design workflows
+
+### Information Architecture & UX Strategy
+- Site mapping and navigation hierarchy optimization
+- Content strategy and content modeling
+- User flow design and conversion optimization
+- Mental model alignment and cognitive load reduction
+- Task analysis and user goal identification
+- Information hierarchy and progressive disclosure
+- Search and findability optimization
+- Cross-platform information consistency
+
+### Visual Design & Brand Systems
+- Typography systems and vertical rhythm establishment
+- Color theory application and systematic palette creation
+- Layout principles and grid system design
+- Iconography design and systematic icon libraries
+- Brand identity integration and visual consistency
+- Design trend analysis and timeless design principles
+- Visual hierarchy and attention management
+- Responsive design principles and breakpoint strategy
+
+### Interaction Design & Prototyping
+- Micro-interaction design and animation principles
+- State management and feedback design
+- Error handling and empty state design
+- Loading states and progressive enhancement
+- Gesture design for touch interfaces
+- Voice UI and conversational interface design
+- AR/VR interface design principles
+- Cross-device interaction consistency
+
+### Design Research & Validation
+- Design sprint facilitation and workshop moderation
+- Stakeholder alignment and requirement gathering
+- Competitive analysis and market research
+- Design validation methodologies and success metrics
+- Post-launch analysis and iterative improvement
+- User feedback collection and analysis systems
+- Design impact measurement and ROI calculation
+- Continuous discovery and learning integration
+
+### Cross-Platform Design Excellence
+- Responsive web design and mobile-first approaches
+- Native mobile app design (iOS Human Interface Guidelines, Material Design)
+- Progressive Web App (PWA) design considerations
+- Desktop application design patterns
+- Wearable interface design principles
+- Smart TV and connected device interfaces
+- Email design and multi-client compatibility
+- Print design integration and brand consistency
+
+### Design System Implementation
+- Component documentation and usage guidelines
+- Design token naming conventions and hierarchies
+- Multi-theme support and dark mode implementation
+- Internationalization and localization considerations
+- Performance implications of design decisions
+- Design system analytics and adoption tracking
+- Training and onboarding materials creation
+- Design system community building and feedback loops
+
+### Advanced Design Techniques
+- Design system automation and code generation
+- Dynamic content design and personalization strategies
+- Data visualization and dashboard design
+- E-commerce and conversion optimization design
+- Content management system integration
+- SEO-friendly design patterns
+- Performance-optimized design decisions
+- Design for emerging technologies (AI, ML, IoT)
+
+### Collaboration & Communication
+- Design presentation and storytelling techniques
+- Cross-functional team collaboration strategies
+- Design critique facilitation and feedback integration
+- Client communication and expectation management
+- Design documentation and specification creation
+- Workshop facilitation and ideation techniques
+- Design thinking process implementation
+- Change management and design adoption strategies
+
+### Design Technology Integration
+- Design system integration with CI/CD pipelines
+- Automated design testing and quality assurance
+- Design API integration and dynamic content handling
+- Performance monitoring for design decisions
+- Analytics integration for design validation
+- Accessibility testing automation
+- Design system versioning and release management
+- Developer handoff automation and optimization
+
+## Behavioral Traits
+- Prioritizes user needs and accessibility in all design decisions
+- Creates systematic, scalable design solutions over one-off designs
+- Validates design decisions with research and testing data
+- Maintains consistency across all platforms and touchpoints
+- Documents design decisions and rationale comprehensively
+- Collaborates effectively with developers and stakeholders
+- Stays current with design trends while focusing on timeless principles
+- Advocates for inclusive design and diverse user representation
+- Measures and iterates on design performance continuously
+- Balances business goals with user needs ethically
+
+## Knowledge Base
+- Design system best practices and industry standards
+- Accessibility guidelines and assistive technology compatibility
+- Modern design tools and workflow optimization
+- User research methodologies and behavioral psychology
+- Cross-platform design patterns and native conventions
+- Performance implications of design decisions
+- Design token standards and implementation strategies
+- Inclusive design principles and diverse user needs
+- Design team scaling and organizational design maturity
+- Emerging design technologies and future trends
+
+## Response Approach
+1. **Research user needs** and validate assumptions with data
+2. **Design systematically** with tokens and reusable components
+3. **Prioritize accessibility** and inclusive design from concept stage
+4. **Document design decisions** with clear rationale and guidelines
+5. **Collaborate with developers** for optimal implementation
+6. **Test and iterate** based on user feedback and analytics
+7. **Maintain consistency** across all platforms and touchpoints
+8. **Measure design impact** and optimize for continuous improvement
+
+## Example Interactions
+- "Design a comprehensive design system with accessibility-first components"
+- "Create user research plan for a complex B2B software redesign"
+- "Optimize conversion flow with A/B testing and user journey analysis"
+- "Develop inclusive design patterns for users with cognitive disabilities"
+- "Design cross-platform mobile app following platform-specific guidelines"
+- "Create design token architecture for multi-brand product suite"
+- "Conduct accessibility audit and remediation strategy for existing product"
+- "Design data visualization dashboard with progressive disclosure"
+
+Focus on user-centered, accessible design solutions with comprehensive documentation and systematic thinking. Include research validation, inclusive design considerations, and clear implementation guidelines.
diff --git a/.claude/skills/ui-ux-pro-max/SKILL.md b/.claude/skills/ui-ux-pro-max/SKILL.md
new file mode 100644
index 0000000..0c39a41
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/SKILL.md
@@ -0,0 +1,351 @@
+---
+name: ui-ux-pro-max
+description: "UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples."
+---
+
+# UI/UX Pro Max - Design Intelligence
+
+Comprehensive design guide for web and mobile applications. Contains 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 9 technology stacks. Searchable database with priority-based recommendations.
+
+## When to Apply
+
+Reference these guidelines when:
+- Designing new UI components or pages
+- Choosing color palettes and typography
+- Reviewing code for UX issues
+- Building landing pages or dashboards
+- Implementing accessibility requirements
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Domain |
+|----------|----------|--------|--------|
+| 1 | Accessibility | CRITICAL | `ux` |
+| 2 | Touch & Interaction | CRITICAL | `ux` |
+| 3 | Performance | HIGH | `ux` |
+| 4 | Layout & Responsive | HIGH | `ux` |
+| 5 | Typography & Color | MEDIUM | `typography`, `color` |
+| 6 | Animation | MEDIUM | `ux` |
+| 7 | Style Selection | MEDIUM | `style`, `product` |
+| 8 | Charts & Data | LOW | `chart` |
+
+## Quick Reference
+
+### 1. Accessibility (CRITICAL)
+
+- `color-contrast` - Minimum 4.5:1 ratio for normal text
+- `focus-states` - Visible focus rings on interactive elements
+- `alt-text` - Descriptive alt text for meaningful images
+- `aria-labels` - aria-label for icon-only buttons
+- `keyboard-nav` - Tab order matches visual order
+- `form-labels` - Use label with for attribute
+
+### 2. Touch & Interaction (CRITICAL)
+
+- `touch-target-size` - Minimum 44x44px touch targets
+- `hover-vs-tap` - Use click/tap for primary interactions
+- `loading-buttons` - Disable button during async operations
+- `error-feedback` - Clear error messages near problem
+- `cursor-pointer` - Add cursor-pointer to clickable elements
+
+### 3. Performance (HIGH)
+
+- `image-optimization` - Use WebP, srcset, lazy loading
+- `reduced-motion` - Check prefers-reduced-motion
+- `content-jumping` - Reserve space for async content
+
+### 4. Layout & Responsive (HIGH)
+
+- `viewport-meta` - width=device-width initial-scale=1
+- `readable-font-size` - Minimum 16px body text on mobile
+- `horizontal-scroll` - Ensure content fits viewport width
+- `z-index-management` - Define z-index scale (10, 20, 30, 50)
+
+### 5. Typography & Color (MEDIUM)
+
+- `line-height` - Use 1.5-1.75 for body text
+- `line-length` - Limit to 65-75 characters per line
+- `font-pairing` - Match heading/body font personalities
+
+### 6. Animation (MEDIUM)
+
+- `duration-timing` - Use 150-300ms for micro-interactions
+- `transform-performance` - Use transform/opacity, not width/height
+- `loading-states` - Skeleton screens or spinners
+
+### 7. Style Selection (MEDIUM)
+
+- `style-match` - Match style to product type
+- `consistency` - Use same style across all pages
+- `no-emoji-icons` - Use SVG icons, not emojis
+
+### 8. Charts & Data (LOW)
+
+- `chart-type` - Match chart type to data type
+- `color-guidance` - Use accessible color palettes
+- `data-table` - Provide table alternative for accessibility
+
+## How to Use
+
+Search specific domains using the CLI tool below.
+
+---
+
+## Prerequisites
+
+Check if Python is installed:
+
+```bash
+python3 --version || python --version
+```
+
+If Python is not installed, install it based on user's OS:
+
+**macOS:**
+```bash
+brew install python3
+```
+
+**Ubuntu/Debian:**
+```bash
+sudo apt update && sudo apt install python3
+```
+
+**Windows:**
+```powershell
+winget install Python.Python.3.12
+```
+
+---
+
+## How to Use This Skill
+
+When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
+
+### Step 1: Analyze User Requirements
+
+Extract key information from user request:
+- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
+- **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.
+- **Industry**: healthcare, fintech, gaming, education, etc.
+- **Stack**: React, Vue, Next.js, or default to `html-tailwind`
+
+### Step 2: Generate Design System (REQUIRED)
+
+**Always start with `--design-system`** to get comprehensive recommendations with reasoning:
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
+```
+
+This command:
+1. Searches 5 domains in parallel (product, style, color, landing, typography)
+2. Applies reasoning rules from `ui-reasoning.csv` to select best matches
+3. Returns complete design system: pattern, style, colors, typography, effects
+4. Includes anti-patterns to avoid
+
+**Example:**
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
+```
+
+### Step 3: Supplement with Detailed Searches (as needed)
+
+After getting the design system, use domain searches to get additional details:
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
+```
+
+**When to use detailed searches:**
+
+| Need | Domain | Example |
+|------|--------|---------|
+| More style options | `style` | `--domain style "glassmorphism dark"` |
+| Chart recommendations | `chart` | `--domain chart "real-time dashboard"` |
+| UX best practices | `ux` | `--domain ux "animation accessibility"` |
+| Alternative fonts | `typography` | `--domain typography "elegant luxury"` |
+| Landing structure | `landing` | `--domain landing "hero social-proof"` |
+
+### Step 4: Stack Guidelines (Default: html-tailwind)
+
+Get implementation-specific best practices. If user doesn't specify a stack, **default to `html-tailwind`**.
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
+```
+
+Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`
+
+---
+
+## Search Reference
+
+### Available Domains
+
+| Domain | Use For | Example Keywords |
+|--------|---------|------------------|
+| `product` | Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |
+| `style` | UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |
+| `typography` | Font pairings, Google Fonts | elegant, playful, professional, modern |
+| `color` | Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |
+| `landing` | Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |
+| `chart` | Chart types, library recommendations | trend, comparison, timeline, funnel, pie |
+| `ux` | Best practices, anti-patterns | animation, accessibility, z-index, loading |
+| `react` | React/Next.js performance | waterfall, bundle, suspense, memo, rerender, cache |
+| `web` | Web interface guidelines | aria, focus, keyboard, semantic, virtualize |
+| `prompt` | AI prompts, CSS keywords | (style name) |
+
+### Available Stacks
+
+| Stack | Focus |
+|-------|-------|
+| `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |
+| `react` | State, hooks, performance, patterns |
+| `nextjs` | SSR, routing, images, API routes |
+| `vue` | Composition API, Pinia, Vue Router |
+| `svelte` | Runes, stores, SvelteKit |
+| `swiftui` | Views, State, Navigation, Animation |
+| `react-native` | Components, Navigation, Lists |
+| `flutter` | Widgets, State, Layout, Theming |
+| `shadcn` | shadcn/ui components, theming, forms, patterns |
+
+---
+
+## Example Workflow
+
+**User request:** "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"
+
+### Step 1: Analyze Requirements
+- Product type: Beauty/Spa service
+- Style keywords: elegant, professional, soft
+- Industry: Beauty/Wellness
+- Stack: html-tailwind (default)
+
+### Step 2: Generate Design System (REQUIRED)
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
+```
+
+**Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
+
+### Step 3: Supplement with Detailed Searches (as needed)
+
+```bash
+# Get UX guidelines for animation and accessibility
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
+
+# Get alternative typography options if needed
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
+```
+
+### Step 4: Stack Guidelines
+
+```bash
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
+```
+
+**Then:** Synthesize design system + detailed searches and implement the design.
+
+---
+
+## Output Formats
+
+The `--design-system` flag supports two output formats:
+
+```bash
+# ASCII box (default) - best for terminal display
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
+
+# Markdown - best for documentation
+python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
+```
+
+---
+
+## Tips for Better Results
+
+1. **Be specific with keywords** - "healthcare SaaS dashboard" > "app"
+2. **Search multiple times** - Different keywords reveal different insights
+3. **Combine domains** - Style + Typography + Color = Complete design system
+4. **Always check UX** - Search "animation", "z-index", "accessibility" for common issues
+5. **Use stack flag** - Get implementation-specific best practices
+6. **Iterate** - If first search doesn't match, try different keywords
+
+---
+
+## Common Rules for Professional UI
+
+These are frequently overlooked issues that make UI look unprofessional:
+
+### Icons & Visual Elements
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **No emoji icons** | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 🚀 ⚙️ as UI icons |
+| **Stable hover states** | Use color/opacity transitions on hover | Use scale transforms that shift layout |
+| **Correct brand logos** | Research official SVG from Simple Icons | Guess or use incorrect logo paths |
+| **Consistent icon sizing** | Use fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes randomly |
+
+### Interaction & Cursor
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **Cursor pointer** | Add `cursor-pointer` to all clickable/hoverable cards | Leave default cursor on interactive elements |
+| **Hover feedback** | Provide visual feedback (color, shadow, border) | No indication element is interactive |
+| **Smooth transitions** | Use `transition-colors duration-200` | Instant state changes or too slow (>500ms) |
+
+### Light/Dark Mode Contrast
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **Glass card light mode** | Use `bg-white/80` or higher opacity | Use `bg-white/10` (too transparent) |
+| **Text contrast light** | Use `#0F172A` (slate-900) for text | Use `#94A3B8` (slate-400) for body text |
+| **Muted text light** | Use `#475569` (slate-600) minimum | Use gray-400 or lighter |
+| **Border visibility** | Use `border-gray-200` in light mode | Use `border-white/10` (invisible) |
+
+### Layout & Spacing
+
+| Rule | Do | Don't |
+|------|----|----- |
+| **Floating navbar** | Add `top-4 left-4 right-4` spacing | Stick navbar to `top-0 left-0 right-0` |
+| **Content padding** | Account for fixed navbar height | Let content hide behind fixed elements |
+| **Consistent max-width** | Use same `max-w-6xl` or `max-w-7xl` | Mix different container widths |
+
+---
+
+## Pre-Delivery Checklist
+
+Before delivering UI code, verify these items:
+
+### Visual Quality
+- [ ] No emojis used as icons (use SVG instead)
+- [ ] All icons from consistent icon set (Heroicons/Lucide)
+- [ ] Brand logos are correct (verified from Simple Icons)
+- [ ] Hover states don't cause layout shift
+- [ ] Use theme colors directly (bg-primary) not var() wrapper
+
+### Interaction
+- [ ] All clickable elements have `cursor-pointer`
+- [ ] Hover states provide clear visual feedback
+- [ ] Transitions are smooth (150-300ms)
+- [ ] Focus states visible for keyboard navigation
+
+### Light/Dark Mode
+- [ ] Light mode text has sufficient contrast (4.5:1 minimum)
+- [ ] Glass/transparent elements visible in light mode
+- [ ] Borders visible in both modes
+- [ ] Test both modes before delivery
+
+### Layout
+- [ ] Floating elements have proper spacing from edges
+- [ ] No content hidden behind fixed navbars
+- [ ] Responsive at 375px, 768px, 1024px, 1440px
+- [ ] No horizontal scroll on mobile
+
+### Accessibility
+- [ ] All images have alt text
+- [ ] Form inputs have labels
+- [ ] Color is not the only indicator
+- [ ] `prefers-reduced-motion` respected
diff --git a/.claude/skills/ui-ux-pro-max/data/charts.csv b/.claude/skills/ui-ux-pro-max/data/charts.csv
new file mode 100644
index 0000000..e0a945b
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/charts.csv
@@ -0,0 +1,26 @@
+No,Data Type,Keywords,Best Chart Type,Secondary Options,Color Guidance,Performance Impact,Accessibility Notes,Library Recommendation,Interactive Level
+1,Trend Over Time,"trend, time-series, line, growth, timeline, progress",Line Chart,"Area Chart, Smooth Area",Primary: #0080FF. Multiple series: use distinct colors. Fill: 20% opacity,⚡ Excellent (optimized),✓ Clear line patterns for colorblind users. Add pattern overlays.,"Chart.js, Recharts, ApexCharts",Hover + Zoom
+2,Compare Categories,"compare, categories, bar, comparison, ranking",Bar Chart (Horizontal or Vertical),"Column Chart, Grouped Bar",Each bar: distinct color. Category: grouped same color. Sorted: descending order,⚡ Excellent,✓ Easy to compare. Add value labels on bars for clarity.,"Chart.js, Recharts, D3.js",Hover + Sort
+3,Part-to-Whole,"part-to-whole, pie, donut, percentage, proportion, share",Pie Chart or Donut,"Stacked Bar, Treemap",Colors: 5-6 max. Contrasting palette. Large slices first. Use labels.,⚡ Good (limit 6 slices),⚠ Hard for accessibility. Better: Stacked bar with legend. Avoid pie if >5 items.,"Chart.js, Recharts, D3.js",Hover + Drill
+4,Correlation/Distribution,"correlation, distribution, scatter, relationship, pattern",Scatter Plot or Bubble Chart,"Heat Map, Matrix",Color axis: gradient (blue-red). Size: relative. Opacity: 0.6-0.8 to show density,⚠ Moderate (many points),⚠ Provide data table alternative. Use pattern + color distinction.,"D3.js, Plotly, Recharts",Hover + Brush
+5,Heatmap/Intensity,"heatmap, heat-map, intensity, density, matrix",Heat Map or Choropleth,"Grid Heat Map, Bubble Heat",Gradient: Cool (blue) to Hot (red). Scale: clear legend. Divergent for ±data,⚡ Excellent (color CSS),⚠ Colorblind: Use pattern overlay. Provide numerical legend.,"D3.js, Plotly, ApexCharts",Hover + Zoom
+6,Geographic Data,"geographic, map, location, region, geo, spatial","Choropleth Map, Bubble Map",Geographic Heat Map,Regional: single color gradient or categorized colors. Legend: clear scale,⚠ Moderate (rendering),⚠ Include text labels for regions. Provide data table alternative.,"D3.js, Mapbox, Leaflet",Pan + Zoom + Drill
+7,Funnel/Flow,funnel/flow,"Funnel Chart, Sankey",Waterfall (for flows),Stages: gradient (starting color → ending color). Show conversion %,⚡ Good,✓ Clear stage labels + percentages. Good for accessibility if labeled.,"D3.js, Recharts, Custom SVG",Hover + Drill
+8,Performance vs Target,performance-vs-target,Gauge Chart or Bullet Chart,"Dial, Thermometer",Performance: Red→Yellow→Green gradient. Target: marker line. Threshold colors,⚡ Good,✓ Add numerical value + percentage label beside gauge.,"D3.js, ApexCharts, Custom SVG",Hover
+9,Time-Series Forecast,time-series-forecast,Line with Confidence Band,Ribbon Chart,Actual: solid line #0080FF. Forecast: dashed #FF9500. Band: light shading,⚡ Good,✓ Clearly distinguish actual vs forecast. Add legend.,"Chart.js, ApexCharts, Plotly",Hover + Toggle
+10,Anomaly Detection,anomaly-detection,Line Chart with Highlights,Scatter with Alert,Normal: blue #0080FF. Anomaly: red #FF0000 circle/square marker + alert,⚡ Good,✓ Circle/marker for anomalies. Add text alert annotation.,"D3.js, Plotly, ApexCharts",Hover + Alert
+11,Hierarchical/Nested Data,hierarchical/nested-data,Treemap,"Sunburst, Nested Donut, Icicle",Parent: distinct hues. Children: lighter shades. White borders 2-3px.,⚠ Moderate,⚠ Poor - provide table alternative. Label large areas.,"D3.js, Recharts, ApexCharts",Hover + Drilldown
+12,Flow/Process Data,flow/process-data,Sankey Diagram,"Alluvial, Chord Diagram",Gradient from source to target. Opacity 0.4-0.6 for flows.,⚠ Moderate,⚠ Poor - provide flow table alternative.,"D3.js (d3-sankey), Plotly",Hover + Drilldown
+13,Cumulative Changes,cumulative-changes,Waterfall Chart,"Stacked Bar, Cascade",Increases: #4CAF50. Decreases: #F44336. Start: #2196F3. End: #0D47A1.,⚡ Good,✓ Good - clear directional colors with labels.,"ApexCharts, Highcharts, Plotly",Hover
+14,Multi-Variable Comparison,multi-variable-comparison,Radar/Spider Chart,"Parallel Coordinates, Grouped Bar",Single: #0080FF 20% fill. Multiple: distinct colors per dataset.,⚡ Good,⚠ Moderate - limit 5-8 axes. Add data table.,"Chart.js, Recharts, ApexCharts",Hover + Toggle
+15,Stock/Trading OHLC,stock/trading-ohlc,Candlestick Chart,"OHLC Bar, Heikin-Ashi",Bullish: #26A69A. Bearish: #EF5350. Volume: 40% opacity below.,⚡ Good,⚠ Moderate - provide OHLC data table.,"Lightweight Charts (TradingView), ApexCharts",Real-time + Hover + Zoom
+16,Relationship/Connection Data,relationship/connection-data,Network Graph,"Hierarchical Tree, Adjacency Matrix",Node types: categorical colors. Edges: #90A4AE 60% opacity.,❌ Poor (500+ nodes struggles),❌ Very Poor - provide adjacency list alternative.,"D3.js (d3-force), Vis.js, Cytoscape.js",Drilldown + Hover + Drag
+17,Distribution/Statistical,distribution/statistical,Box Plot,"Violin Plot, Beeswarm",Box: #BBDEFB. Border: #1976D2. Median: #D32F2F. Outliers: #F44336.,⚡ Excellent,"✓ Good - include stats table (min, Q1, median, Q3, max).","Plotly, D3.js, Chart.js (plugin)",Hover
+18,Performance vs Target (Compact),performance-vs-target-(compact),Bullet Chart,"Gauge, Progress Bar","Ranges: #FFCDD2, #FFF9C4, #C8E6C9. Performance: #1976D2. Target: black 3px.",⚡ Excellent,✓ Excellent - compact with clear values.,"D3.js, Plotly, Custom SVG",Hover
+19,Proportional/Percentage,proportional/percentage,Waffle Chart,"Pictogram, Stacked Bar 100%",10x10 grid. 3-5 categories max. 2-3px spacing between squares.,⚡ Good,✓ Good - better than pie for accessibility.,"D3.js, React-Waffle, Custom CSS Grid",Hover
+20,Hierarchical Proportional,hierarchical-proportional,Sunburst Chart,"Treemap, Icicle, Circle Packing",Center to outer: darker to lighter. 15-20% lighter per level.,⚠ Moderate,⚠ Poor - provide hierarchy table alternative.,"D3.js (d3-hierarchy), Recharts, ApexCharts",Drilldown + Hover
+21,Root Cause Analysis,"root cause, decomposition, tree, hierarchy, drill-down, ai-split",Decomposition Tree,"Decision Tree, Flow Chart",Nodes: #2563EB (Primary) vs #EF4444 (Negative impact). Connectors: Neutral grey.,⚠ Moderate (calculation heavy),✓ clear hierarchy. Allow keyboard navigation for nodes.,"Power BI (native), React-Flow, Custom D3.js",Drill + Expand
+22,3D Spatial Data,"3d, spatial, immersive, terrain, molecular, volumetric",3D Scatter/Surface Plot,"Volumetric Rendering, Point Cloud",Depth cues: lighting/shading. Z-axis: color gradient (cool to warm).,❌ Heavy (WebGL required),❌ Poor - requires alternative 2D view or data table.,"Three.js, Deck.gl, Plotly 3D",Rotate + Zoom + VR
+23,Real-Time Streaming,"streaming, real-time, ticker, live, velocity, pulse",Streaming Area Chart,"Ticker Tape, Moving Gauge",Current: Bright Pulse (#00FF00). History: Fading opacity. Grid: Dark.,⚡ Optimized (canvas/webgl),⚠ Flashing elements - provide pause button. High contrast.,Smoothed D3.js, CanvasJS, SciChart,Real-time + Pause
+24,Sentiment/Emotion,"sentiment, emotion, nlp, opinion, feeling",Word Cloud with Sentiment,"Sentiment Arc, Radar Chart",Positive: #22C55E. Negative: #EF4444. Neutral: #94A3B8. Size = Frequency.,⚡ Good,⚠ Word clouds poor for screen readers. Use list view.,"D3-cloud, Highcharts, Nivo",Hover + Filter
+25,Process Mining,"process, mining, variants, path, bottleneck, log",Process Map / Graph,"Directed Acyclic Graph (DAG), Petri Net",Happy path: #10B981 (Thick). Deviations: #F59E0B (Thin). Bottlenecks: #EF4444.,⚠ Moderate to Heavy,⚠ Complex graphs hard to navigate. Provide path summary.,"React-Flow, Cytoscape.js, Recharts",Drag + Node-Click
\ No newline at end of file
diff --git a/.claude/skills/ui-ux-pro-max/data/colors.csv b/.claude/skills/ui-ux-pro-max/data/colors.csv
new file mode 100644
index 0000000..7327ffd
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/colors.csv
@@ -0,0 +1,97 @@
+No,Product Type,Keywords,Primary (Hex),Secondary (Hex),CTA (Hex),Background (Hex),Text (Hex),Border (Hex),Notes
+1,SaaS (General),"saas, general",#2563EB,#3B82F6,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust blue + accent contrast
+2,Micro SaaS,"micro, saas",#2563EB,#3B82F6,#F97316,#F8FAFC,#1E293B,#E2E8F0,Vibrant primary + white space
+3,E-commerce,commerce,#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand primary + success green
+4,E-commerce Luxury,"commerce, luxury",#1C1917,#44403C,#CA8A04,#FAFAF9,#0C0A09,#D6D3D1,Premium colors + minimal accent
+5,Service Landing Page,"service, landing, page",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand primary + trust colors
+6,B2B Service,"b2b, service",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional blue + neutral grey
+7,Financial Dashboard,"financial, dashboard",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark bg + red/green alerts + trust blue
+8,Analytics Dashboard,"analytics, dashboard",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Cool→Hot gradients + neutral grey
+9,Healthcare App,"healthcare, app",#0891B2,#22D3EE,#059669,#ECFEFF,#164E63,#A5F3FC,Calm blue + health green + trust
+10,Educational App,"educational, app",#4F46E5,#818CF8,#F97316,#EEF2FF,#1E1B4B,#C7D2FE,Playful colors + clear hierarchy
+11,Creative Agency,"creative, agency",#EC4899,#F472B6,#06B6D4,#FDF2F8,#831843,#FBCFE8,Bold primaries + artistic freedom
+12,Portfolio/Personal,"portfolio, personal",#18181B,#3F3F46,#2563EB,#FAFAFA,#09090B,#E4E4E7,Brand primary + artistic interpretation
+13,Gaming,gaming,#7C3AED,#A78BFA,#F43F5E,#0F0F23,#E2E8F0,#4C1D95,Vibrant + neon + immersive colors
+14,Government/Public Service,"government, public, service",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional blue + high contrast
+15,Fintech/Crypto,"fintech, crypto",#F59E0B,#FBBF24,#8B5CF6,#0F172A,#F8FAFC,#334155,Dark tech colors + trust + vibrant accents
+16,Social Media App,"social, media, app",#2563EB,#60A5FA,#F43F5E,#F8FAFC,#1E293B,#DBEAFE,Vibrant + engagement colors
+17,Productivity Tool,"productivity, tool",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Clear hierarchy + functional colors
+18,Design System/Component Library,"design, system, component, library",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Clear hierarchy + code-like structure
+19,AI/Chatbot Platform,"chatbot, platform",#7C3AED,#A78BFA,#06B6D4,#FAF5FF,#1E1B4B,#DDD6FE,Neutral + AI Purple (#6366F1)
+20,NFT/Web3 Platform,"nft, web3, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Neon + Gold (#FFD700)
+21,Creator Economy Platform,"creator, economy, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Vibrant + Brand colors
+22,Sustainability/ESG Platform,"sustainability, esg, platform",#7C3AED,#A78BFA,#06B6D4,#FAF5FF,#1E1B4B,#DDD6FE,Green (#228B22) + Earth tones
+23,Remote Work/Collaboration Tool,"remote, work, collaboration, tool",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Calm Blue + Neutral grey
+24,Mental Health App,"mental, health, app",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Calm Pastels + Trust colors
+25,Pet Tech App,"pet, tech, app",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Playful + Warm colors
+26,Smart Home/IoT Dashboard,"smart, home, iot, dashboard",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Status indicator colors
+27,EV/Charging Ecosystem,"charging, ecosystem",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Electric Blue (#009CD1) + Green
+28,Subscription Box Service,"subscription, box, service",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand + Excitement colors
+29,Podcast Platform,"podcast, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Audio waveform accents
+30,Dating App,"dating, app",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Warm + Romantic (Pink/Red gradients)
+31,Micro-Credentials/Badges Platform,"micro, credentials, badges, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust Blue + Gold (#FFD700)
+32,Knowledge Base/Documentation,"knowledge, base, documentation",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Clean hierarchy + minimal color
+33,Hyperlocal Services,"hyperlocal, services",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Location markers + Trust colors
+34,Beauty/Spa/Wellness Service,"beauty, spa, wellness, service",#10B981,#34D399,#8B5CF6,#ECFDF5,#064E3B,#A7F3D0,Soft pastels (Pink #FFB6C1 Sage #90EE90) + Cream + Gold accents
+35,Luxury/Premium Brand,"luxury, premium, brand",#1C1917,#44403C,#CA8A04,#FAFAF9,#0C0A09,#D6D3D1,Black + Gold (#FFD700) + White + Minimal accent
+36,Restaurant/Food Service,"restaurant, food, service",#DC2626,#F87171,#CA8A04,#FEF2F2,#450A0A,#FECACA,Warm colors (Orange Red Brown) + appetizing imagery
+37,Fitness/Gym App,"fitness, gym, app",#DC2626,#F87171,#16A34A,#FEF2F2,#1F2937,#FECACA,Energetic (Orange #FF6B35 Electric Blue) + Dark bg
+38,Real Estate/Property,"real, estate, property",#0F766E,#14B8A6,#0369A1,#F0FDFA,#134E4A,#99F6E4,Trust Blue (#0077B6) + Gold accents + White
+39,Travel/Tourism Agency,"travel, tourism, agency",#EC4899,#F472B6,#06B6D4,#FDF2F8,#831843,#FBCFE8,Vibrant destination colors + Sky Blue + Warm accents
+40,Hotel/Hospitality,"hotel, hospitality",#1E3A8A,#3B82F6,#CA8A04,#F8FAFC,#1E40AF,#BFDBFE,Warm neutrals + Gold (#D4AF37) + Brand accent
+41,Wedding/Event Planning,"wedding, event, planning",#7C3AED,#A78BFA,#F97316,#FAF5FF,#4C1D95,#DDD6FE,Soft Pink (#FFD6E0) + Gold + Cream + Sage
+42,Legal Services,"legal, services",#1E3A8A,#1E40AF,#B45309,#F8FAFC,#0F172A,#CBD5E1,Navy Blue (#1E3A5F) + Gold + White
+43,Insurance Platform,"insurance, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust Blue (#0066CC) + Green (security) + Neutral
+44,Banking/Traditional Finance,"banking, traditional, finance",#0F766E,#14B8A6,#0369A1,#F0FDFA,#134E4A,#99F6E4,Navy (#0A1628) + Trust Blue + Gold accents
+45,Online Course/E-learning,"online, course, learning",#0D9488,#2DD4BF,#EA580C,#F0FDFA,#134E4A,#5EEAD4,Vibrant learning colors + Progress green
+46,Non-profit/Charity,"non, profit, charity",#0891B2,#22D3EE,#F97316,#ECFEFF,#164E63,#A5F3FC,Cause-related colors + Trust + Warm
+47,Music Streaming,"music, streaming",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark (#121212) + Vibrant accents + Album art colors
+48,Video Streaming/OTT,"video, streaming, ott",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark bg + Content poster colors + Brand accent
+49,Job Board/Recruitment,"job, board, recruitment",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional Blue + Success Green + Neutral
+50,Marketplace (P2P),"marketplace, p2p",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Trust colors + Category colors + Success green
+51,Logistics/Delivery,"logistics, delivery",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Blue (#2563EB) + Orange (tracking) + Green (delivered)
+52,Agriculture/Farm Tech,"agriculture, farm, tech",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Earth Green (#4A7C23) + Brown + Sky Blue
+53,Construction/Architecture,"construction, architecture",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Grey (#4A4A4A) + Orange (safety) + Blueprint Blue
+54,Automotive/Car Dealership,"automotive, car, dealership",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand colors + Metallic accents + Dark/Light
+55,Photography Studio,"photography, studio",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Black + White + Minimal accent
+56,Coworking Space,"coworking, space",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Energetic colors + Wood tones + Brand accent
+57,Cleaning Service,"cleaning, service",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Fresh Blue (#00B4D8) + Clean White + Green
+58,Home Services (Plumber/Electrician),"home, services, plumber, electrician",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Trust Blue + Safety Orange + Professional grey
+59,Childcare/Daycare,"childcare, daycare",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Playful pastels + Safe colors + Warm accents
+60,Senior Care/Elderly,"senior, care, elderly",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Calm Blue + Warm neutrals + Large text
+61,Medical Clinic,"medical, clinic",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Medical Blue (#0077B6) + Trust White + Calm Green
+62,Pharmacy/Drug Store,"pharmacy, drug, store",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Pharmacy Green + Trust Blue + Clean White
+63,Dental Practice,"dental, practice",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Fresh Blue + White + Smile Yellow accent
+64,Veterinary Clinic,"veterinary, clinic",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Caring Blue + Pet-friendly colors + Warm accents
+65,Florist/Plant Shop,"florist, plant, shop",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Natural Green + Floral pinks/purples + Earth tones
+66,Bakery/Cafe,"bakery, cafe",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Warm Brown + Cream + Appetizing accents
+67,Coffee Shop,"coffee, shop",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Coffee Brown (#6F4E37) + Cream + Warm accents
+68,Brewery/Winery,"brewery, winery",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Deep amber/burgundy + Gold + Craft aesthetic
+69,Airline,airline,#7C3AED,#A78BFA,#06B6D4,#FAF5FF,#1E1B4B,#DDD6FE,Sky Blue + Brand colors + Trust accents
+70,News/Media Platform,"news, media, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand colors + High contrast + Category colors
+71,Magazine/Blog,"magazine, blog",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Editorial colors + Brand primary + Clean white
+72,Freelancer Platform,"freelancer, platform",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional Blue + Success Green + Neutral
+73,Consulting Firm,"consulting, firm",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Navy + Gold + Professional grey
+74,Marketing Agency,"marketing, agency",#EC4899,#F472B6,#06B6D4,#FDF2F8,#831843,#FBCFE8,Bold brand colors + Creative freedom
+75,Event Management,"event, management",#7C3AED,#A78BFA,#F97316,#FAF5FF,#4C1D95,#DDD6FE,Event theme colors + Excitement accents
+76,Conference/Webinar Platform,"conference, webinar, platform",#0F172A,#334155,#0369A1,#F8FAFC,#020617,#E2E8F0,Professional Blue + Video accent + Brand
+77,Membership/Community,"membership, community",#7C3AED,#A78BFA,#F97316,#FAF5FF,#4C1D95,#DDD6FE,Community brand colors + Engagement accents
+78,Newsletter Platform,"newsletter, platform",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Brand primary + Clean white + CTA accent
+79,Digital Products/Downloads,"digital, products, downloads",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Product category colors + Brand + Success green
+80,Church/Religious Organization,"church, religious, organization",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Warm Gold + Deep Purple/Blue + White
+81,Sports Team/Club,"sports, team, club",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Team colors + Energetic accents
+82,Museum/Gallery,"museum, gallery",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Art-appropriate neutrals + Exhibition accents
+83,Theater/Cinema,"theater, cinema",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Dark + Spotlight accents + Gold
+84,Language Learning App,"language, learning, app",#0D9488,#2DD4BF,#EA580C,#F0FDFA,#134E4A,#5EEAD4,Playful colors + Progress indicators + Country flags
+85,Coding Bootcamp,"coding, bootcamp",#3B82F6,#60A5FA,#F97316,#F8FAFC,#1E293B,#E2E8F0,Code editor colors + Brand + Success green
+86,Cybersecurity Platform,"cybersecurity, security, cyber, hacker",#00FF41,#0D0D0D,#00FF41,#000000,#E0E0E0,#1F1F1F,Matrix Green + Deep Black + Terminal feel
+87,Developer Tool / IDE,"developer, tool, ide, code, dev",#3B82F6,#1E293B,#2563EB,#0F172A,#F1F5F9,#334155,Dark syntax theme colors + Blue focus
+88,Biotech / Life Sciences,"biotech, science, biology, medical",#0EA5E9,#0284C7,#10B981,#F8FAFC,#0F172A,#E2E8F0,Sterile White + DNA Blue + Life Green
+89,Space Tech / Aerospace,"space, aerospace, tech, futuristic",#FFFFFF,#94A3B8,#3B82F6,#0B0B10,#F8FAFC,#1E293B,Deep Space Black + Star White + Metallic
+90,Architecture / Interior,"architecture, interior, design, luxury",#171717,#404040,#D4AF37,#FFFFFF,#171717,#E5E5E5,Monochrome + Gold Accent + High Imagery
+91,Quantum Computing,"quantum, qubit, tech",#00FFFF,#7B61FF,#FF00FF,#050510,#E0E0FF,#333344,Interference patterns + Neon + Deep Dark
+92,Biohacking / Longevity,"bio, health, science",#FF4D4D,#4D94FF,#00E676,#F5F5F7,#1C1C1E,#E5E5EA,Biological red/blue + Clinical white
+93,Autonomous Systems,"drone, robot, fleet",#00FF41,#008F11,#FF3333,#0D1117,#E6EDF3,#30363D,Terminal Green + Tactical Dark
+94,Generative AI Art,"art, gen-ai, creative",#111111,#333333,#FFFFFF,#FAFAFA,#000000,#E5E5E5,Canvas Neutral + High Contrast
+95,Spatial / Vision OS,"spatial, glass, vision",#FFFFFF,#E5E5E5,#007AFF,#888888,#000000,#FFFFFF,Glass opacity 20% + System Blue
+96,Climate Tech,"climate, green, energy",#2E8B57,#87CEEB,#FFD700,#F0FFF4,#1A3320,#C6E6C6,Nature Green + Solar Yellow + Air Blue
\ No newline at end of file
diff --git a/.claude/skills/ui-ux-pro-max/data/icons.csv b/.claude/skills/ui-ux-pro-max/data/icons.csv
new file mode 100644
index 0000000..a09a534
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/icons.csv
@@ -0,0 +1,101 @@
+STT,Category,Icon Name,Keywords,Library,Import Code,Usage,Best For,Style
+1,Navigation,menu,hamburger menu navigation toggle bars,Lucide,import { Menu } from 'lucide-react',<Menu />,Mobile navigation drawer toggle sidebar,Outline
+2,Navigation,arrow-left,back previous return navigate,Lucide,import { ArrowLeft } from 'lucide-react',<ArrowLeft />,Back button breadcrumb navigation,Outline
+3,Navigation,arrow-right,next forward continue navigate,Lucide,import { ArrowRight } from 'lucide-react',<ArrowRight />,Forward button next step CTA,Outline
+4,Navigation,chevron-down,dropdown expand accordion select,Lucide,import { ChevronDown } from 'lucide-react',<ChevronDown />,Dropdown toggle accordion header,Outline
+5,Navigation,chevron-up,collapse close accordion minimize,Lucide,import { ChevronUp } from 'lucide-react',<ChevronUp />,Accordion collapse minimize,Outline
+6,Navigation,home,homepage main dashboard start,Lucide,import { Home } from 'lucide-react',<Home />,Home navigation main page,Outline
+7,Navigation,x,close cancel dismiss remove exit,Lucide,import { X } from 'lucide-react',<X />,Modal close dismiss button,Outline
+8,Navigation,external-link,open new tab external link,Lucide,import { ExternalLink } from 'lucide-react',<ExternalLink />,External link indicator,Outline
+9,Action,plus,add create new insert,Lucide,import { Plus } from 'lucide-react',<Plus />,Add button create new item,Outline
+10,Action,minus,remove subtract decrease delete,Lucide,import { Minus } from 'lucide-react',<Minus />,Remove item quantity decrease,Outline
+11,Action,trash-2,delete remove discard bin,Lucide,import { Trash2 } from 'lucide-react',<Trash2 />,Delete action destructive,Outline
+12,Action,edit,pencil modify change update,Lucide,import { Edit } from 'lucide-react',<Edit />,Edit button modify content,Outline
+13,Action,save,disk store persist save,Lucide,import { Save } from 'lucide-react',<Save />,Save button persist changes,Outline
+14,Action,download,export save file download,Lucide,import { Download } from 'lucide-react',<Download />,Download file export,Outline
+15,Action,upload,import file attach upload,Lucide,import { Upload } from 'lucide-react',<Upload />,Upload file import,Outline
+16,Action,copy,duplicate clipboard paste,Lucide,import { Copy } from 'lucide-react',<Copy />,Copy to clipboard,Outline
+17,Action,share,social distribute send,Lucide,import { Share } from 'lucide-react',<Share />,Share button social,Outline
+18,Action,search,find lookup filter query,Lucide,import { Search } from 'lucide-react',<Search />,Search input bar,Outline
+19,Action,filter,sort refine narrow options,Lucide,import { Filter } from 'lucide-react',<Filter />,Filter dropdown sort,Outline
+20,Action,settings,gear cog preferences config,Lucide,import { Settings } from 'lucide-react',<Settings />,Settings page configuration,Outline
+21,Status,check,success done complete verified,Lucide,import { Check } from 'lucide-react',<Check />,Success state checkmark,Outline
+22,Status,check-circle,success verified approved complete,Lucide,import { CheckCircle } from 'lucide-react',<CheckCircle />,Success badge verified,Outline
+23,Status,x-circle,error failed cancel rejected,Lucide,import { XCircle } from 'lucide-react',<XCircle />,Error state failed,Outline
+24,Status,alert-triangle,warning caution attention danger,Lucide,import { AlertTriangle } from 'lucide-react',<AlertTriangle />,Warning message caution,Outline
+25,Status,alert-circle,info notice information help,Lucide,import { AlertCircle } from 'lucide-react',<AlertCircle />,Info notice alert,Outline
+26,Status,info,information help tooltip details,Lucide,import { Info } from 'lucide-react',<Info />,Information tooltip help,Outline
+27,Status,loader,loading spinner processing wait,Lucide,import { Loader } from 'lucide-react',<Loader className="animate-spin" />,Loading state spinner,Outline
+28,Status,clock,time schedule pending wait,Lucide,import { Clock } from 'lucide-react',<Clock />,Pending time schedule,Outline
+29,Communication,mail,email message inbox letter,Lucide,import { Mail } from 'lucide-react',<Mail />,Email contact inbox,Outline
+30,Communication,message-circle,chat comment bubble conversation,Lucide,import { MessageCircle } from 'lucide-react',<MessageCircle />,Chat comment message,Outline
+31,Communication,phone,call mobile telephone contact,Lucide,import { Phone } from 'lucide-react',<Phone />,Phone contact call,Outline
+32,Communication,send,submit dispatch message airplane,Lucide,import { Send } from 'lucide-react',<Send />,Send message submit,Outline
+33,Communication,bell,notification alert ring reminder,Lucide,import { Bell } from 'lucide-react',<Bell />,Notification bell alert,Outline
+34,User,user,profile account person avatar,Lucide,import { User } from 'lucide-react',<User />,User profile account,Outline
+35,User,users,team group people members,Lucide,import { Users } from 'lucide-react',<Users />,Team group members,Outline
+36,User,user-plus,add invite new member,Lucide,import { UserPlus } from 'lucide-react',<UserPlus />,Add user invite,Outline
+37,User,log-in,signin authenticate enter,Lucide,import { LogIn } from 'lucide-react',<LogIn />,Login signin,Outline
+38,User,log-out,signout exit leave logout,Lucide,import { LogOut } from 'lucide-react',<LogOut />,Logout signout,Outline
+39,Media,image,photo picture gallery thumbnail,Lucide,import { Image } from 'lucide-react',<Image />,Image photo gallery,Outline
+40,Media,video,movie film play record,Lucide,import { Video } from 'lucide-react',<Video />,Video player media,Outline
+41,Media,play,start video audio media,Lucide,import { Play } from 'lucide-react',<Play />,Play button video audio,Outline
+42,Media,pause,stop halt video audio,Lucide,import { Pause } from 'lucide-react',<Pause />,Pause button media,Outline
+43,Media,volume-2,sound audio speaker music,Lucide,import { Volume2 } from 'lucide-react',<Volume2 />,Volume audio sound,Outline
+44,Media,mic,microphone record voice audio,Lucide,import { Mic } from 'lucide-react',<Mic />,Microphone voice record,Outline
+45,Media,camera,photo capture snapshot picture,Lucide,import { Camera } from 'lucide-react',<Camera />,Camera photo capture,Outline
+46,Commerce,shopping-cart,cart checkout basket buy,Lucide,import { ShoppingCart } from 'lucide-react',<ShoppingCart />,Shopping cart e-commerce,Outline
+47,Commerce,shopping-bag,purchase buy store bag,Lucide,import { ShoppingBag } from 'lucide-react',<ShoppingBag />,Shopping bag purchase,Outline
+48,Commerce,credit-card,payment card checkout stripe,Lucide,import { CreditCard } from 'lucide-react',<CreditCard />,Payment credit card,Outline
+49,Commerce,dollar-sign,money price currency cost,Lucide,import { DollarSign } from 'lucide-react',<DollarSign />,Price money currency,Outline
+50,Commerce,tag,label price discount sale,Lucide,import { Tag } from 'lucide-react',<Tag />,Price tag label,Outline
+51,Commerce,gift,present reward bonus offer,Lucide,import { Gift } from 'lucide-react',<Gift />,Gift reward offer,Outline
+52,Commerce,percent,discount sale offer promo,Lucide,import { Percent } from 'lucide-react',<Percent />,Discount percentage sale,Outline
+53,Data,bar-chart,analytics statistics graph metrics,Lucide,import { BarChart } from 'lucide-react',<BarChart />,Bar chart analytics,Outline
+54,Data,pie-chart,statistics distribution breakdown,Lucide,import { PieChart } from 'lucide-react',<PieChart />,Pie chart distribution,Outline
+55,Data,trending-up,growth increase positive trend,Lucide,import { TrendingUp } from 'lucide-react',<TrendingUp />,Growth trend positive,Outline
+56,Data,trending-down,decline decrease negative trend,Lucide,import { TrendingDown } from 'lucide-react',<TrendingDown />,Decline trend negative,Outline
+57,Data,activity,pulse heartbeat monitor live,Lucide,import { Activity } from 'lucide-react',<Activity />,Activity monitor pulse,Outline
+58,Data,database,storage server data backend,Lucide,import { Database } from 'lucide-react',<Database />,Database storage,Outline
+59,Files,file,document page paper doc,Lucide,import { File } from 'lucide-react',<File />,File document,Outline
+60,Files,file-text,document text page article,Lucide,import { FileText } from 'lucide-react',<FileText />,Text document article,Outline
+61,Files,folder,directory organize group files,Lucide,import { Folder } from 'lucide-react',<Folder />,Folder directory,Outline
+62,Files,folder-open,expanded browse files view,Lucide,import { FolderOpen } from 'lucide-react',<FolderOpen />,Open folder browse,Outline
+63,Files,paperclip,attachment attach file link,Lucide,import { Paperclip } from 'lucide-react',<Paperclip />,Attachment paperclip,Outline
+64,Files,link,url hyperlink chain connect,Lucide,import { Link } from 'lucide-react',<Link />,Link URL hyperlink,Outline
+65,Files,clipboard,paste copy buffer notes,Lucide,import { Clipboard } from 'lucide-react',<Clipboard />,Clipboard paste,Outline
+66,Layout,grid,tiles gallery layout dashboard,Lucide,import { Grid } from 'lucide-react',<Grid />,Grid layout gallery,Outline
+67,Layout,list,rows table lines items,Lucide,import { List } from 'lucide-react',<List />,List view rows,Outline
+68,Layout,columns,layout split dual sidebar,Lucide,import { Columns } from 'lucide-react',<Columns />,Column layout split,Outline
+69,Layout,maximize,fullscreen expand enlarge zoom,Lucide,import { Maximize } from 'lucide-react',<Maximize />,Fullscreen maximize,Outline
+70,Layout,minimize,reduce shrink collapse exit,Lucide,import { Minimize } from 'lucide-react',<Minimize />,Minimize reduce,Outline
+71,Layout,sidebar,panel drawer navigation menu,Lucide,import { Sidebar } from 'lucide-react',<Sidebar />,Sidebar panel,Outline
+72,Social,heart,like love favorite wishlist,Lucide,import { Heart } from 'lucide-react',<Heart />,Like favorite love,Outline
+73,Social,star,rating review favorite bookmark,Lucide,import { Star } from 'lucide-react',<Star />,Star rating favorite,Outline
+74,Social,thumbs-up,like approve agree positive,Lucide,import { ThumbsUp } from 'lucide-react',<ThumbsUp />,Like approve thumb,Outline
+75,Social,thumbs-down,dislike disapprove disagree negative,Lucide,import { ThumbsDown } from 'lucide-react',<ThumbsDown />,Dislike disapprove,Outline
+76,Social,bookmark,save later favorite mark,Lucide,import { Bookmark } from 'lucide-react',<Bookmark />,Bookmark save,Outline
+77,Social,flag,report mark important highlight,Lucide,import { Flag } from 'lucide-react',<Flag />,Flag report,Outline
+78,Device,smartphone,mobile phone device touch,Lucide,import { Smartphone } from 'lucide-react',<Smartphone />,Mobile smartphone,Outline
+79,Device,tablet,ipad device touch screen,Lucide,import { Tablet } from 'lucide-react',<Tablet />,Tablet device,Outline
+80,Device,monitor,desktop screen computer display,Lucide,import { Monitor } from 'lucide-react',<Monitor />,Desktop monitor,Outline
+81,Device,laptop,notebook computer portable device,Lucide,import { Laptop } from 'lucide-react',<Laptop />,Laptop computer,Outline
+82,Device,printer,print document output paper,Lucide,import { Printer } from 'lucide-react',<Printer />,Printer print,Outline
+83,Security,lock,secure password protected private,Lucide,import { Lock } from 'lucide-react',<Lock />,Lock secure,Outline
+84,Security,unlock,open access unsecure public,Lucide,import { Unlock } from 'lucide-react',<Unlock />,Unlock open,Outline
+85,Security,shield,protection security safe guard,Lucide,import { Shield } from 'lucide-react',<Shield />,Shield protection,Outline
+86,Security,key,password access unlock login,Lucide,import { Key } from 'lucide-react',<Key />,Key password,Outline
+87,Security,eye,view show visible password,Lucide,import { Eye } from 'lucide-react',<Eye />,Show password view,Outline
+88,Security,eye-off,hide invisible password hidden,Lucide,import { EyeOff } from 'lucide-react',<EyeOff />,Hide password,Outline
+89,Location,map-pin,location marker place address,Lucide,import { MapPin } from 'lucide-react',<MapPin />,Location pin marker,Outline
+90,Location,map,directions navigate geography location,Lucide,import { Map } from 'lucide-react',<Map />,Map directions,Outline
+91,Location,navigation,compass direction pointer arrow,Lucide,import { Navigation } from 'lucide-react',<Navigation />,Navigation compass,Outline
+92,Location,globe,world international global web,Lucide,import { Globe } from 'lucide-react',<Globe />,Globe world,Outline
+93,Time,calendar,date schedule event appointment,Lucide,import { Calendar } from 'lucide-react',<Calendar />,Calendar date,Outline
+94,Time,refresh-cw,reload sync update refresh,Lucide,import { RefreshCw } from 'lucide-react',<RefreshCw />,Refresh reload,Outline
+95,Time,rotate-ccw,undo back revert history,Lucide,import { RotateCcw } from 'lucide-react',<RotateCcw />,Undo revert,Outline
+96,Time,rotate-cw,redo forward repeat history,Lucide,import { RotateCw } from 'lucide-react',<RotateCw />,Redo forward,Outline
+97,Development,code,develop programming syntax html,Lucide,import { Code } from 'lucide-react',<Code />,Code development,Outline
+98,Development,terminal,console cli command shell,Lucide,import { Terminal } from 'lucide-react',<Terminal />,Terminal console,Outline
+99,Development,git-branch,version control branch merge,Lucide,import { GitBranch } from 'lucide-react',<GitBranch />,Git branch,Outline
+100,Development,github,repository code open source,Lucide,import { Github } from 'lucide-react',<Github />,GitHub repository,Outline
diff --git a/.claude/skills/ui-ux-pro-max/data/landing.csv b/.claude/skills/ui-ux-pro-max/data/landing.csv
new file mode 100644
index 0000000..a68c36f
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/landing.csv
@@ -0,0 +1,31 @@
+No,Pattern Name,Keywords,Section Order,Primary CTA Placement,Color Strategy,Recommended Effects,Conversion Optimization
+1,Hero + Features + CTA,"hero, hero-centric, features, feature-rich, cta, call-to-action","1. Hero with headline/image, 2. Value prop, 3. Key features (3-5), 4. CTA section, 5. Footer",Hero (sticky) + Bottom,Hero: Brand primary or vibrant. Features: Card bg #FAFAFA. CTA: Contrasting accent color,"Hero parallax, feature card hover lift, CTA glow on hover",Deep CTA placement. Use contrasting color (at least 7:1 contrast ratio). Sticky navbar CTA.
+2,Hero + Testimonials + CTA,"hero, testimonials, social-proof, trust, reviews, cta","1. Hero, 2. Problem statement, 3. Solution overview, 4. Testimonials carousel, 5. CTA",Hero (sticky) + Post-testimonials,"Hero: Brand color. Testimonials: Light bg #F5F5F5. Quotes: Italic, muted color #666. CTA: Vibrant","Testimonial carousel slide animations, quote marks animations, avatar fade-in",Social proof before CTA. Use 3-5 testimonials. Include photo + name + role. CTA after social proof.
+3,Product Demo + Features,"demo, product-demo, features, showcase, interactive","1. Hero, 2. Product video/mockup (center), 3. Feature breakdown per section, 4. Comparison (optional), 5. CTA",Video center + CTA right/bottom,Video surround: Brand color overlay. Features: Icon color #0080FF. Text: Dark #222,"Video play button pulse, feature scroll reveals, demo interaction highlights",Embedded product demo increases engagement. Use interactive mockup if possible. Auto-play video muted.
+4,Minimal Single Column,"minimal, simple, direct, single-column, clean","1. Hero headline, 2. Short description, 3. Benefit bullets (3 max), 4. CTA, 5. Footer","Center, large CTA button",Minimalist: Brand + white #FFFFFF + accent. Buttons: High contrast 7:1+. Text: Black/Dark grey,Minimal hover effects. Smooth scroll. CTA scale on hover (subtle),Single CTA focus. Large typography. Lots of whitespace. No nav clutter. Mobile-first.
+5,Funnel (3-Step Conversion),"funnel, conversion, steps, wizard, onboarding","1. Hero, 2. Step 1 (problem), 3. Step 2 (solution), 4. Step 3 (action), 5. CTA progression",Each step: mini-CTA. Final: main CTA,"Step colors: 1 (Red/Problem), 2 (Orange/Process), 3 (Green/Solution). CTA: Brand color","Step number animations, progress bar fill, step transitions smooth scroll",Progressive disclosure. Show only essential info per step. Use progress indicators. Multiple CTAs.
+6,Comparison Table + CTA,"comparison, table, compare, versus, cta","1. Hero, 2. Problem intro, 3. Comparison table (product vs competitors), 4. Pricing (optional), 5. CTA",Table: Right column. CTA: Below table,Table: Alternating rows (white/light grey). Your product: Highlight #FFFACD (light yellow) or green. Text: Dark,"Table row hover highlight, price toggle animations, feature checkmark animations",Use comparison to show unique value. Highlight your product row. Include 'free trial' in pricing row.
+7,Lead Magnet + Form,"lead, form, signup, capture, email, magnet","1. Hero (benefit headline), 2. Lead magnet preview (ebook cover, checklist, etc), 3. Form (minimal fields), 4. CTA submit",Form CTA: Submit button,Lead magnet: Professional design. Form: Clean white bg. Inputs: Light border #CCCCCC. CTA: Brand color,"Form focus state animations, input validation animations, success confirmation animation",Form fields ≤ 3 for best conversion. Offer valuable lead magnet preview. Show form submission progress.
+8,Pricing Page + CTA,"pricing, plans, tiers, comparison, cta","1. Hero (pricing headline), 2. Price comparison cards, 3. Feature comparison table, 4. FAQ section, 5. Final CTA",Each card: CTA button. Sticky CTA in nav,"Free: Grey, Starter: Blue, Pro: Green/Gold, Enterprise: Dark. Cards: 1px border, shadow","Price toggle animation (monthly/yearly), card comparison highlight, FAQ accordion open/close",Recommend starter plan (pre-select/highlight). Show annual discount (20-30%). Use FAQs to address concerns.
+9,Video-First Hero,"video, hero, media, visual, engaging","1. Hero with video background, 2. Key features overlay, 3. Benefits section, 4. CTA",Overlay on video (center/bottom) + Bottom section,Dark overlay 60% on video. Brand accent for CTA. White text on dark.,"Video autoplay muted, parallax scroll, text fade-in on scroll",86% higher engagement with video. Add captions for accessibility. Compress video for performance.
+10,Scroll-Triggered Storytelling,"storytelling, scroll, narrative, story, immersive","1. Intro hook, 2. Chapter 1 (problem), 3. Chapter 2 (journey), 4. Chapter 3 (solution), 5. Climax CTA",End of each chapter (mini) + Final climax CTA,Progressive reveal. Each chapter has distinct color. Building intensity.,"ScrollTrigger animations, parallax layers, progressive disclosure, chapter transitions",Narrative increases time-on-page 3x. Use progress indicator. Mobile: simplify animations.
+11,AI Personalization Landing,"ai, personalization, smart, recommendation, dynamic","1. Dynamic hero (personalized), 2. Relevant features, 3. Tailored testimonials, 4. Smart CTA",Context-aware placement based on user segment,Adaptive based on user data. A/B test color variations per segment.,"Dynamic content swap, fade transitions, personalized product recommendations",20%+ conversion with personalization. Requires analytics integration. Fallback for new users.
+12,Waitlist/Coming Soon,"waitlist, coming-soon, launch, early-access, notify","1. Hero with countdown, 2. Product teaser/preview, 3. Email capture form, 4. Social proof (waitlist count)",Email form prominent (above fold) + Sticky form on scroll,Anticipation: Dark + accent highlights. Countdown in brand color. Urgency indicators.,"Countdown timer animation, email validation feedback, success confetti, social share buttons",Scarcity + exclusivity. Show waitlist count. Early access benefits. Referral program.
+13,Comparison Table Focus,"comparison, table, versus, compare, features","1. Hero (problem statement), 2. Comparison matrix (you vs competitors), 3. Feature deep-dive, 4. Winner CTA",After comparison table (highlighted row) + Bottom,Your product column highlighted (accent bg or green). Competitors neutral. Checkmarks green.,"Table row hover highlight, feature checkmark animations, sticky comparison header",Show value vs competitors. 35% higher conversion. Be factual. Include pricing if favorable.
+14,Pricing-Focused Landing,"pricing, price, cost, plans, subscription","1. Hero (value proposition), 2. Pricing cards (3 tiers), 3. Feature comparison, 4. FAQ, 5. Final CTA",Each pricing card + Sticky CTA in nav + Bottom,Popular plan highlighted (brand color border/bg). Free: grey. Enterprise: dark/premium.,"Price toggle monthly/annual animation, card hover lift, FAQ accordion smooth open",Annual discount 20-30%. Recommend mid-tier (most popular badge). Address objections in FAQ.
+15,App Store Style Landing,"app, mobile, download, store, install","1. Hero with device mockup, 2. Screenshots carousel, 3. Features with icons, 4. Reviews/ratings, 5. Download CTAs",Download buttons prominent (App Store + Play Store) throughout,Dark/light matching app store feel. Star ratings in gold. Screenshots with device frames.,"Device mockup rotations, screenshot slider, star rating animations, download button pulse",Show real screenshots. Include ratings (4.5+ stars). QR code for mobile. Platform-specific CTAs.
+16,FAQ/Documentation Landing,"faq, documentation, help, support, questions","1. Hero with search bar, 2. Popular categories, 3. FAQ accordion, 4. Contact/support CTA",Search bar prominent + Contact CTA for unresolved questions,"Clean, high readability. Minimal color. Category icons in brand color. Success green for resolved.","Search autocomplete, smooth accordion open/close, category hover, helpful feedback buttons",Reduce support tickets. Track search analytics. Show related articles. Contact escalation path.
+17,Immersive/Interactive Experience,"immersive, interactive, experience, 3d, animation","1. Full-screen interactive element, 2. Guided product tour, 3. Key benefits revealed, 4. CTA after completion",After interaction complete + Skip option for impatient users,Immersive experience colors. Dark background for focus. Highlight interactive elements.,"WebGL, 3D interactions, gamification elements, progress indicators, reward animations",40% higher engagement. Performance trade-off. Provide skip option. Mobile fallback essential.
+18,Event/Conference Landing,"event, conference, meetup, registration, schedule","1. Hero (date/location/countdown), 2. Speakers grid, 3. Agenda/schedule, 4. Sponsors, 5. Register CTA",Register CTA sticky + After speakers + Bottom,Urgency colors (countdown). Event branding. Speaker cards professional. Sponsor logos neutral.,"Countdown timer, speaker hover cards with bio, agenda tabs, early bird countdown",Early bird pricing with deadline. Social proof (past attendees). Speaker credibility. Multi-ticket discounts.
+19,Product Review/Ratings Focused,"reviews, ratings, testimonials, social-proof, stars","1. Hero (product + aggregate rating), 2. Rating breakdown, 3. Individual reviews, 4. Buy/CTA",After reviews summary + Buy button alongside reviews,Trust colors. Star ratings gold. Verified badge green. Review sentiment colors.,"Star fill animations, review filtering, helpful vote interactions, photo lightbox",User-generated content builds trust. Show verified purchases. Filter by rating. Respond to negative reviews.
+20,Community/Forum Landing,"community, forum, social, members, discussion","1. Hero (community value prop), 2. Popular topics/categories, 3. Active members showcase, 4. Join CTA",Join button prominent + After member showcase,"Warm, welcoming. Member photos add humanity. Topic badges in brand colors. Activity indicators green.","Member avatars animation, activity feed live updates, topic hover previews, join success celebration","Show active community (member count, posts today). Highlight benefits. Preview content. Easy onboarding."
+21,Before-After Transformation,"before-after, transformation, results, comparison","1. Hero (problem state), 2. Transformation slider/comparison, 3. How it works, 4. Results CTA",After transformation reveal + Bottom,Contrast: muted/grey (before) vs vibrant/colorful (after). Success green for results.,"Slider comparison interaction, before/after reveal animations, result counters, testimonial videos",Visual proof of value. 45% higher conversion. Real results. Specific metrics. Guarantee offer.
+22,Marketplace / Directory,"marketplace, directory, search, listing","1. Hero (Search focused), 2. Categories, 3. Featured Listings, 4. Trust/Safety, 5. CTA (Become a host/seller)",Hero Search Bar + Navbar 'List your item',Search: High contrast. Categories: Visual icons. Trust: Blue/Green.,Search autocomplete animation, map hover pins, card carousel,Search bar is the CTA. Reduce friction to search. Popular searches suggestions.
+23,Newsletter / Content First,"newsletter, content, writer, blog, subscribe","1. Hero (Value Prop + Form), 2. Recent Issues/Archives, 3. Social Proof (Subscriber count), 4. About Author",Hero inline form + Sticky header form,Minimalist. Paper-like background. Text focus. Accent color for Subscribe.,Text highlight animations, typewriter effect, subtle fade-in,Single field form (Email only). Show 'Join X,000 readers'. Read sample link.
+24,Webinar Registration,"webinar, registration, event, training, live","1. Hero (Topic + Timer + Form), 2. What you'll learn, 3. Speaker Bio, 4. Urgency/Bonuses, 5. Form (again)",Hero (Right side form) + Bottom anchor,Urgency: Red/Orange. Professional: Blue/Navy. Form: High contrast white.,Countdown timer, speaker avatar float, urgent ticker,Limited seats logic. 'Live' indicator. Auto-fill timezone.
+25,Enterprise Gateway,"enterprise, corporate, gateway, solutions, portal","1. Hero (Video/Mission), 2. Solutions by Industry, 3. Solutions by Role, 4. Client Logos, 5. Contact Sales",Contact Sales (Primary) + Login (Secondary),Corporate: Navy/Grey. High integrity. Conservative accents.,Slow video background, logo carousel, tab switching for industries,Path selection (I am a...). Mega menu navigation. Trust signals prominent.
+26,Portfolio Grid,"portfolio, grid, showcase, gallery, masonry","1. Hero (Name/Role), 2. Project Grid (Masonry), 3. About/Philosophy, 4. Contact",Project Card Hover + Footer Contact,Neutral background (let work shine). Text: Black/White. Accent: Minimal.,Image lazy load reveal, hover overlay info, lightbox view,Visuals first. Filter by category. Fast loading essential.
+27,Horizontal Scroll Journey,"horizontal, scroll, journey, gallery, storytelling, panoramic","1. Intro (Vertical), 2. The Journey (Horizontal Track), 3. Detail Reveal, 4. Vertical Footer","Floating Sticky CTA or End of Horizontal Track","Continuous palette transition. Chapter colors. Progress bar #000000.","Scroll-jacking (careful), parallax layers, horizontal slide, progress indicator","Immersive product discovery. High engagement. Keep navigation visible.
+28,Bento Grid Showcase,"bento, grid, features, modular, apple-style, showcase","1. Hero, 2. Bento Grid (Key Features), 3. Detail Cards, 4. Tech Specs, 5. CTA","Floating Action Button or Bottom of Grid","Card backgrounds: #F5F5F7 or Glass. Icons: Vibrant brand colors. Text: Dark.","Hover card scale (1.02), video inside cards, tilt effect, staggered reveal","Scannable value props. High information density without clutter. Mobile stack.
+29,Interactive 3D Configurator,"3d, configurator, customizer, interactive, product","1. Hero (Configurator), 2. Feature Highlight (synced), 3. Price/Specs, 4. Purchase","Inside Configurator UI + Sticky Bottom Bar","Neutral studio background. Product: Realistic materials. UI: Minimal overlay.","Real-time rendering, material swap animation, camera rotate/zoom, light reflection","Increases ownership feeling. 360 view reduces return rates. Direct add-to-cart.
+30,AI-Driven Dynamic Landing,"ai, dynamic, personalized, adaptive, generative","1. Prompt/Input Hero, 2. Generated Result Preview, 3. How it Works, 4. Value Prop","Input Field (Hero) + 'Try it' Buttons","Adaptive to user input. Dark mode for compute feel. Neon accents.","Typing text effects, shimmering generation loaders, morphing layouts","Immediate value demonstration. 'Show, don't tell'. Low friction start.
\ No newline at end of file
diff --git a/.claude/skills/ui-ux-pro-max/data/products.csv b/.claude/skills/ui-ux-pro-max/data/products.csv
new file mode 100644
index 0000000..3f95afd
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/products.csv
@@ -0,0 +1,97 @@
+No,Product Type,Keywords,Primary Style Recommendation,Secondary Styles,Landing Page Pattern,Dashboard Style (if applicable),Color Palette Focus,Key Considerations
+1,SaaS (General),"app, b2b, cloud, general, saas, software, subscription",Glassmorphism + Flat Design,"Soft UI Evolution, Minimalism",Hero + Features + CTA,Data-Dense + Real-Time Monitoring,Trust blue + accent contrast,Balance modern feel with clarity. Focus on CTAs.
+2,Micro SaaS,"app, b2b, cloud, indie, micro, micro-saas, niche, saas, small, software, solo, subscription",Flat Design + Vibrant & Block,"Motion-Driven, Micro-interactions",Minimal & Direct + Demo,Executive Dashboard,Vibrant primary + white space,"Keep simple, show product quickly. Speed is key."
+3,E-commerce,"buy, commerce, e, ecommerce, products, retail, sell, shop, store",Vibrant & Block-based,"Aurora UI, Motion-Driven",Feature-Rich Showcase,Sales Intelligence Dashboard,Brand primary + success green,Engagement & conversions. High visual hierarchy.
+4,E-commerce Luxury,"buy, commerce, e, ecommerce, elegant, exclusive, high-end, luxury, premium, products, retail, sell, shop, store",Liquid Glass + Glassmorphism,"3D & Hyperrealism, Aurora UI",Feature-Rich Showcase,Sales Intelligence Dashboard,Premium colors + minimal accent,Elegance & sophistication. Premium materials.
+5,Service Landing Page,"appointment, booking, consultation, conversion, landing, marketing, page, service",Hero-Centric + Trust & Authority,"Social Proof-Focused, Storytelling",Hero-Centric Design,N/A - Analytics for conversions,Brand primary + trust colors,Social proof essential. Show expertise.
+6,B2B Service,"appointment, b, b2b, booking, business, consultation, corporate, enterprise, service",Trust & Authority + Minimal,"Feature-Rich, Conversion-Optimized",Feature-Rich Showcase,Sales Intelligence Dashboard,Professional blue + neutral grey,Credibility essential. Clear ROI messaging.
+7,Financial Dashboard,"admin, analytics, dashboard, data, financial, panel",Dark Mode (OLED) + Data-Dense,"Minimalism, Accessible & Ethical",N/A - Dashboard focused,Financial Dashboard,Dark bg + red/green alerts + trust blue,"High contrast, real-time updates, accuracy paramount."
+8,Analytics Dashboard,"admin, analytics, dashboard, data, panel",Data-Dense + Heat Map & Heatmap,"Minimalism, Dark Mode (OLED)",N/A - Analytics focused,Drill-Down Analytics + Comparative,Cool→Hot gradients + neutral grey,Clarity > aesthetics. Color-coded data priority.
+9,Healthcare App,"app, clinic, health, healthcare, medical, patient",Neumorphism + Accessible & Ethical,"Soft UI Evolution, Claymorphism (for patients)",Social Proof-Focused,User Behavior Analytics,Calm blue + health green + trust,Accessibility mandatory. Calming aesthetic.
+10,Educational App,"app, course, education, educational, learning, school, training",Claymorphism + Micro-interactions,"Vibrant & Block-based, Flat Design",Storytelling-Driven,User Behavior Analytics,Playful colors + clear hierarchy,Engagement & ease of use. Age-appropriate design.
+11,Creative Agency,"agency, creative, design, marketing, studio",Brutalism + Motion-Driven,"Retro-Futurism, Storytelling-Driven",Storytelling-Driven,N/A - Portfolio focused,Bold primaries + artistic freedom,Differentiation key. Wow-factor necessary.
+12,Portfolio/Personal,"creative, personal, portfolio, projects, showcase, work",Motion-Driven + Minimalism,"Brutalism, Aurora UI",Storytelling-Driven,N/A - Personal branding,Brand primary + artistic interpretation,Showcase work. Personality shine through.
+13,Gaming,"entertainment, esports, game, gaming, play",3D & Hyperrealism + Retro-Futurism,"Motion-Driven, Vibrant & Block",Feature-Rich Showcase,N/A - Game focused,Vibrant + neon + immersive colors,Immersion priority. Performance critical.
+14,Government/Public Service,"appointment, booking, consultation, government, public, service",Accessible & Ethical + Minimalism,"Flat Design, Inclusive Design",Minimal & Direct,Executive Dashboard,Professional blue + high contrast,WCAG AAA mandatory. Trust paramount.
+15,Fintech/Crypto,"banking, blockchain, crypto, defi, finance, fintech, money, nft, payment, web3",Glassmorphism + Dark Mode (OLED),"Retro-Futurism, Motion-Driven",Conversion-Optimized,Real-Time Monitoring + Predictive,Dark tech colors + trust + vibrant accents,Security perception. Real-time data critical.
+16,Social Media App,"app, community, content, entertainment, media, network, sharing, social, streaming, users, video",Vibrant & Block-based + Motion-Driven,"Aurora UI, Micro-interactions",Feature-Rich Showcase,User Behavior Analytics,Vibrant + engagement colors,Engagement & retention. Addictive design ethics.
+17,Productivity Tool,"collaboration, productivity, project, task, tool, workflow",Flat Design + Micro-interactions,"Minimalism, Soft UI Evolution",Interactive Product Demo,Drill-Down Analytics,Clear hierarchy + functional colors,Ease of use. Speed & efficiency focus.
+18,Design System/Component Library,"component, design, library, system",Minimalism + Accessible & Ethical,"Flat Design, Zero Interface",Feature-Rich Showcase,N/A - Dev focused,Clear hierarchy + code-like structure,Consistency. Developer-first approach.
+19,AI/Chatbot Platform,"ai, artificial-intelligence, automation, chatbot, machine-learning, ml, platform",AI-Native UI + Minimalism,"Zero Interface, Glassmorphism",Interactive Product Demo,AI/ML Analytics Dashboard,Neutral + AI Purple (#6366F1),Conversational UI. Streaming text. Context awareness. Minimal chrome.
+20,NFT/Web3 Platform,"nft, platform, web",Cyberpunk UI + Glassmorphism,"Aurora UI, 3D & Hyperrealism",Feature-Rich Showcase,Crypto/Blockchain Dashboard,Dark + Neon + Gold (#FFD700),Wallet integration. Transaction feedback. Gas fees display. Dark mode essential.
+21,Creator Economy Platform,"creator, economy, platform",Vibrant & Block-based + Bento Box Grid,"Motion-Driven, Aurora UI",Social Proof-Focused,User Behavior Analytics,Vibrant + Brand colors,Creator profiles. Monetization display. Engagement metrics. Social proof.
+22,Sustainability/ESG Platform,"ai, artificial-intelligence, automation, esg, machine-learning, ml, platform, sustainability",Organic Biophilic + Minimalism,"Accessible & Ethical, Flat Design",Trust & Authority,Energy/Utilities Dashboard,Green (#228B22) + Earth tones,Carbon footprint visuals. Progress indicators. Certification badges. Eco-friendly imagery.
+23,Remote Work/Collaboration Tool,"collaboration, remote, tool, work",Soft UI Evolution + Minimalism,"Glassmorphism, Micro-interactions",Feature-Rich Showcase,Drill-Down Analytics,Calm Blue + Neutral grey,Real-time collaboration. Status indicators. Video integration. Notification management.
+24,Mental Health App,"app, health, mental",Neumorphism + Accessible & Ethical,"Claymorphism, Soft UI Evolution",Social Proof-Focused,Healthcare Analytics,Calm Pastels + Trust colors,Calming aesthetics. Privacy-first. Crisis resources. Progress tracking. Accessibility mandatory.
+25,Pet Tech App,"app, pet, tech",Claymorphism + Vibrant & Block-based,"Micro-interactions, Flat Design",Storytelling-Driven,User Behavior Analytics,Playful + Warm colors,Pet profiles. Health tracking. Playful UI. Photo galleries. Vet integration.
+26,Smart Home/IoT Dashboard,"admin, analytics, dashboard, data, home, iot, panel, smart",Glassmorphism + Dark Mode (OLED),"Minimalism, AI-Native UI",Interactive Product Demo,Real-Time Monitoring,Dark + Status indicator colors,Device status. Real-time controls. Energy monitoring. Automation rules. Quick actions.
+27,EV/Charging Ecosystem,"charging, ecosystem, ev",Minimalism + Aurora UI,"Glassmorphism, Organic Biophilic",Hero-Centric Design,Energy/Utilities Dashboard,Electric Blue (#009CD1) + Green,Charging station maps. Range estimation. Cost calculation. Environmental impact.
+28,Subscription Box Service,"appointment, booking, box, consultation, membership, plan, recurring, service, subscription",Vibrant & Block-based + Motion-Driven,"Claymorphism, Aurora UI",Feature-Rich Showcase,E-commerce Analytics,Brand + Excitement colors,Unboxing experience. Personalization quiz. Subscription management. Product reveals.
+29,Podcast Platform,"platform, podcast",Dark Mode (OLED) + Minimalism,"Motion-Driven, Vibrant & Block-based",Storytelling-Driven,Media/Entertainment Dashboard,Dark + Audio waveform accents,Audio player UX. Episode discovery. Creator tools. Analytics for podcasters.
+30,Dating App,"app, dating",Vibrant & Block-based + Motion-Driven,"Aurora UI, Glassmorphism",Social Proof-Focused,User Behavior Analytics,Warm + Romantic (Pink/Red gradients),Profile cards. Swipe interactions. Match animations. Safety features. Video chat.
+31,Micro-Credentials/Badges Platform,"badges, credentials, micro, platform",Minimalism + Flat Design,"Accessible & Ethical, Swiss Modernism 2.0",Trust & Authority,Education Dashboard,Trust Blue + Gold (#FFD700),Credential verification. Badge display. Progress tracking. Issuer trust. LinkedIn integration.
+32,Knowledge Base/Documentation,"base, documentation, knowledge",Minimalism + Accessible & Ethical,"Swiss Modernism 2.0, Flat Design",FAQ/Documentation,N/A - Documentation focused,Clean hierarchy + minimal color,Search-first. Clear navigation. Code highlighting. Version switching. Feedback system.
+33,Hyperlocal Services,"appointment, booking, consultation, hyperlocal, service, services",Minimalism + Vibrant & Block-based,"Micro-interactions, Flat Design",Conversion-Optimized,Drill-Down Analytics + Map,Location markers + Trust colors,Map integration. Service categories. Provider profiles. Booking system. Reviews.
+34,Beauty/Spa/Wellness Service,"appointment, beauty, booking, consultation, service, spa, wellness",Soft UI Evolution + Neumorphism,"Glassmorphism, Minimalism",Hero-Centric Design + Social Proof,User Behavior Analytics,Soft pastels (Pink #FFB6C1 Sage #90EE90) + Cream + Gold accents,Calming aesthetic. Booking system. Service menu. Before/after gallery. Testimonials. Relaxing imagery.
+35,Luxury/Premium Brand,"brand, elegant, exclusive, high-end, luxury, premium",Liquid Glass + Glassmorphism,"Minimalism, 3D & Hyperrealism",Storytelling-Driven + Feature-Rich,Sales Intelligence Dashboard,Black + Gold (#FFD700) + White + Minimal accent,Elegance paramount. Premium imagery. Storytelling. High-quality visuals. Exclusive feel.
+36,Restaurant/Food Service,"appointment, booking, consultation, delivery, food, menu, order, restaurant, service",Vibrant & Block-based + Motion-Driven,"Claymorphism, Flat Design",Hero-Centric Design + Conversion,N/A - Booking focused,Warm colors (Orange Red Brown) + appetizing imagery,Menu display. Online ordering. Reservation system. Food photography. Location/hours prominent.
+37,Fitness/Gym App,"app, exercise, fitness, gym, health, workout",Vibrant & Block-based + Dark Mode (OLED),"Motion-Driven, Neumorphism",Feature-Rich Showcase,User Behavior Analytics,Energetic (Orange #FF6B35 Electric Blue) + Dark bg,Progress tracking. Workout plans. Community features. Achievements. Motivational design.
+38,Real Estate/Property,"buy, estate, housing, property, real, real-estate, rent",Glassmorphism + Minimalism,"Motion-Driven, 3D & Hyperrealism",Hero-Centric Design + Feature-Rich,Sales Intelligence Dashboard,Trust Blue (#0077B6) + Gold accents + White,Property listings. Virtual tours. Map integration. Agent profiles. Mortgage calculator. High-quality imagery.
+39,Travel/Tourism Agency,"agency, booking, creative, design, flight, hotel, marketing, studio, tourism, travel, vacation",Aurora UI + Motion-Driven,"Vibrant & Block-based, Glassmorphism",Storytelling-Driven + Hero-Centric,Booking Analytics,Vibrant destination colors + Sky Blue + Warm accents,Destination showcase. Booking system. Itinerary builder. Reviews. Inspiration galleries. Mobile-first.
+40,Hotel/Hospitality,"hospitality, hotel",Liquid Glass + Minimalism,"Glassmorphism, Soft UI Evolution",Hero-Centric Design + Social Proof,Revenue Management Dashboard,Warm neutrals + Gold (#D4AF37) + Brand accent,Room booking. Amenities showcase. Location maps. Guest reviews. Seasonal pricing. Luxury imagery.
+41,Wedding/Event Planning,"conference, event, meetup, planning, registration, ticket, wedding",Soft UI Evolution + Aurora UI,"Glassmorphism, Motion-Driven",Storytelling-Driven + Social Proof,N/A - Planning focused,Soft Pink (#FFD6E0) + Gold + Cream + Sage,Portfolio gallery. Vendor directory. Planning tools. Timeline. Budget tracker. Romantic aesthetic.
+42,Legal Services,"appointment, attorney, booking, compliance, consultation, contract, law, legal, service, services",Trust & Authority + Minimalism,"Accessible & Ethical, Swiss Modernism 2.0",Trust & Authority + Minimal,Case Management Dashboard,Navy Blue (#1E3A5F) + Gold + White,Credibility paramount. Practice areas. Attorney profiles. Case results. Contact forms. Professional imagery.
+43,Insurance Platform,"insurance, platform",Trust & Authority + Flat Design,"Accessible & Ethical, Minimalism",Conversion-Optimized + Trust,Claims Analytics Dashboard,Trust Blue (#0066CC) + Green (security) + Neutral,Quote calculator. Policy comparison. Claims process. Trust signals. Clear pricing. Security badges.
+44,Banking/Traditional Finance,"banking, finance, traditional",Minimalism + Accessible & Ethical,"Trust & Authority, Dark Mode (OLED)",Trust & Authority + Feature-Rich,Financial Dashboard,Navy (#0A1628) + Trust Blue + Gold accents,Security-first. Account overview. Transaction history. Mobile banking. Accessibility critical. Trust paramount.
+45,Online Course/E-learning,"course, e, learning, online",Claymorphism + Vibrant & Block-based,"Motion-Driven, Flat Design",Feature-Rich Showcase + Social Proof,Education Dashboard,Vibrant learning colors + Progress green,Course catalog. Progress tracking. Video player. Quizzes. Certificates. Community forums. Gamification.
+46,Non-profit/Charity,"charity, non, profit",Accessible & Ethical + Organic Biophilic,"Minimalism, Storytelling-Driven",Storytelling-Driven + Trust,Donation Analytics Dashboard,Cause-related colors + Trust + Warm,Impact stories. Donation flow. Transparency reports. Volunteer signup. Event calendar. Emotional connection.
+47,Music Streaming,"music, streaming",Dark Mode (OLED) + Vibrant & Block-based,"Motion-Driven, Aurora UI",Feature-Rich Showcase,Media/Entertainment Dashboard,Dark (#121212) + Vibrant accents + Album art colors,Audio player. Playlist management. Artist pages. Personalization. Social features. Waveform visualizations.
+48,Video Streaming/OTT,"ott, streaming, video",Dark Mode (OLED) + Motion-Driven,"Glassmorphism, Vibrant & Block-based",Hero-Centric Design + Feature-Rich,Media/Entertainment Dashboard,Dark bg + Content poster colors + Brand accent,Video player. Content discovery. Watchlist. Continue watching. Personalized recommendations. Thumbnail-heavy.
+49,Job Board/Recruitment,"board, job, recruitment",Flat Design + Minimalism,"Vibrant & Block-based, Accessible & Ethical",Conversion-Optimized + Feature-Rich,HR Analytics Dashboard,Professional Blue + Success Green + Neutral,Job listings. Search/filter. Company profiles. Application tracking. Resume upload. Salary insights.
+50,Marketplace (P2P),"buyers, listings, marketplace, p, platform, sellers",Vibrant & Block-based + Flat Design,"Micro-interactions, Trust & Authority",Feature-Rich Showcase + Social Proof,E-commerce Analytics,Trust colors + Category colors + Success green,Seller/buyer profiles. Listings. Reviews/ratings. Secure payment. Messaging. Search/filter. Trust badges.
+51,Logistics/Delivery,"delivery, logistics",Minimalism + Flat Design,"Dark Mode (OLED), Micro-interactions",Feature-Rich Showcase + Conversion,Real-Time Monitoring + Route Analytics,Blue (#2563EB) + Orange (tracking) + Green (delivered),Real-time tracking. Delivery scheduling. Route optimization. Driver management. Status updates. Map integration.
+52,Agriculture/Farm Tech,"agriculture, farm, tech",Organic Biophilic + Flat Design,"Minimalism, Accessible & Ethical",Feature-Rich Showcase + Trust,IoT Sensor Dashboard,Earth Green (#4A7C23) + Brown + Sky Blue,Crop monitoring. Weather data. IoT sensors. Yield tracking. Market prices. Sustainable imagery.
+53,Construction/Architecture,"architecture, construction",Minimalism + 3D & Hyperrealism,"Brutalism, Swiss Modernism 2.0",Hero-Centric Design + Feature-Rich,Project Management Dashboard,Grey (#4A4A4A) + Orange (safety) + Blueprint Blue,Project portfolio. 3D renders. Timeline. Material specs. Team collaboration. Blueprint aesthetic.
+54,Automotive/Car Dealership,"automotive, car, dealership",Motion-Driven + 3D & Hyperrealism,"Dark Mode (OLED), Glassmorphism",Hero-Centric Design + Feature-Rich,Sales Intelligence Dashboard,Brand colors + Metallic accents + Dark/Light,Vehicle showcase. 360° views. Comparison tools. Financing calculator. Test drive booking. High-quality imagery.
+55,Photography Studio,"photography, studio",Motion-Driven + Minimalism,"Aurora UI, Glassmorphism",Storytelling-Driven + Hero-Centric,N/A - Portfolio focused,Black + White + Minimal accent,Portfolio gallery. Before/after. Service packages. Booking system. Client galleries. Full-bleed imagery.
+56,Coworking Space,"coworking, space",Vibrant & Block-based + Glassmorphism,"Minimalism, Motion-Driven",Hero-Centric Design + Feature-Rich,Occupancy Dashboard,Energetic colors + Wood tones + Brand accent,Space tour. Membership plans. Booking system. Amenities. Community events. Virtual tour.
+57,Cleaning Service,"appointment, booking, cleaning, consultation, service",Soft UI Evolution + Flat Design,"Minimalism, Micro-interactions",Conversion-Optimized + Trust,Service Analytics,Fresh Blue (#00B4D8) + Clean White + Green,Service packages. Booking system. Price calculator. Before/after gallery. Reviews. Trust badges.
+58,Home Services (Plumber/Electrician),"appointment, booking, consultation, electrician, home, plumber, service, services",Flat Design + Trust & Authority,"Minimalism, Accessible & Ethical",Conversion-Optimized + Trust,Service Analytics,Trust Blue + Safety Orange + Professional grey,Service list. Emergency contact. Booking. Price transparency. Certifications. Local trust signals.
+59,Childcare/Daycare,"childcare, daycare",Claymorphism + Vibrant & Block-based,"Soft UI Evolution, Accessible & Ethical",Social Proof-Focused + Trust,Parent Dashboard,Playful pastels + Safe colors + Warm accents,Programs. Staff profiles. Safety certifications. Parent portal. Activity updates. Cheerful imagery.
+60,Senior Care/Elderly,"care, elderly, senior",Accessible & Ethical + Soft UI Evolution,"Minimalism, Neumorphism",Trust & Authority + Social Proof,Healthcare Analytics,Calm Blue + Warm neutrals + Large text,Care services. Staff qualifications. Facility tour. Family portal. Large touch targets. High contrast. Accessibility-first.
+61,Medical Clinic,"clinic, medical",Accessible & Ethical + Minimalism,"Neumorphism, Trust & Authority",Trust & Authority + Conversion,Healthcare Analytics,Medical Blue (#0077B6) + Trust White + Calm Green,Services. Doctor profiles. Online booking. Patient portal. Insurance info. HIPAA compliant. Trust signals.
+62,Pharmacy/Drug Store,"drug, pharmacy, store",Flat Design + Accessible & Ethical,"Minimalism, Trust & Authority",Conversion-Optimized + Trust,Inventory Dashboard,Pharmacy Green + Trust Blue + Clean White,Product catalog. Prescription upload. Refill reminders. Health info. Store locator. Safety certifications.
+63,Dental Practice,"dental, practice",Soft UI Evolution + Minimalism,"Accessible & Ethical, Trust & Authority",Social Proof-Focused + Conversion,Patient Analytics,Fresh Blue + White + Smile Yellow accent,Services. Dentist profiles. Before/after. Online booking. Insurance. Patient testimonials. Friendly imagery.
+64,Veterinary Clinic,"clinic, veterinary",Claymorphism + Accessible & Ethical,"Soft UI Evolution, Flat Design",Social Proof-Focused + Trust,Pet Health Dashboard,Caring Blue + Pet-friendly colors + Warm accents,Pet services. Vet profiles. Online booking. Pet portal. Emergency info. Friendly animal imagery.
+65,Florist/Plant Shop,"florist, plant, shop",Organic Biophilic + Vibrant & Block-based,"Aurora UI, Motion-Driven",Hero-Centric Design + Conversion,E-commerce Analytics,Natural Green + Floral pinks/purples + Earth tones,Product catalog. Occasion categories. Delivery scheduling. Care guides. Seasonal collections. Beautiful imagery.
+66,Bakery/Cafe,"bakery, cafe",Vibrant & Block-based + Soft UI Evolution,"Claymorphism, Motion-Driven",Hero-Centric Design + Conversion,N/A - Order focused,Warm Brown + Cream + Appetizing accents,Menu display. Online ordering. Location/hours. Catering. Seasonal specials. Appetizing photography.
+67,Coffee Shop,"coffee, shop",Minimalism + Organic Biophilic,"Soft UI Evolution, Flat Design",Hero-Centric Design + Conversion,N/A - Order focused,Coffee Brown (#6F4E37) + Cream + Warm accents,Menu. Online ordering. Loyalty program. Location. Story/origin. Cozy aesthetic.
+68,Brewery/Winery,"brewery, winery",Motion-Driven + Storytelling-Driven,"Dark Mode (OLED), Organic Biophilic",Storytelling-Driven + Hero-Centric,N/A - E-commerce focused,Deep amber/burgundy + Gold + Craft aesthetic,Product showcase. Story/heritage. Tasting notes. Events. Club membership. Artisanal imagery.
+69,Airline,"ai, airline, artificial-intelligence, automation, machine-learning, ml",Minimalism + Glassmorphism,"Motion-Driven, Accessible & Ethical",Conversion-Optimized + Feature-Rich,Operations Dashboard,Sky Blue + Brand colors + Trust accents,Flight search. Booking. Check-in. Boarding pass. Loyalty program. Route maps. Mobile-first.
+70,News/Media Platform,"content, entertainment, media, news, platform, streaming, video",Minimalism + Flat Design,"Dark Mode (OLED), Accessible & Ethical",Hero-Centric Design + Feature-Rich,Media Analytics Dashboard,Brand colors + High contrast + Category colors,Article layout. Breaking news. Categories. Search. Subscription. Mobile reading. Fast loading.
+71,Magazine/Blog,"articles, blog, content, magazine, posts, writing",Swiss Modernism 2.0 + Motion-Driven,"Minimalism, Aurora UI",Storytelling-Driven + Hero-Centric,Content Analytics,Editorial colors + Brand primary + Clean white,Article showcase. Category navigation. Author profiles. Newsletter signup. Related content. Typography-focused.
+72,Freelancer Platform,"freelancer, platform",Flat Design + Minimalism,"Vibrant & Block-based, Micro-interactions",Feature-Rich Showcase + Conversion,Marketplace Analytics,Professional Blue + Success Green + Neutral,Profile creation. Portfolio. Skill matching. Messaging. Payment. Reviews. Project management.
+73,Consulting Firm,"consulting, firm",Trust & Authority + Minimalism,"Swiss Modernism 2.0, Accessible & Ethical",Trust & Authority + Feature-Rich,N/A - Lead generation,Navy + Gold + Professional grey,Service areas. Case studies. Team profiles. Thought leadership. Contact. Professional credibility.
+74,Marketing Agency,"agency, creative, design, marketing, studio",Brutalism + Motion-Driven,"Vibrant & Block-based, Aurora UI",Storytelling-Driven + Feature-Rich,Campaign Analytics,Bold brand colors + Creative freedom,Portfolio. Case studies. Services. Team. Creative showcase. Results-focused. Bold aesthetic.
+75,Event Management,"conference, event, management, meetup, registration, ticket",Vibrant & Block-based + Motion-Driven,"Glassmorphism, Aurora UI",Hero-Centric Design + Feature-Rich,Event Analytics,Event theme colors + Excitement accents,Event showcase. Registration. Agenda. Speakers. Sponsors. Ticket sales. Countdown timer.
+76,Conference/Webinar Platform,"conference, platform, webinar",Glassmorphism + Minimalism,"Motion-Driven, Flat Design",Feature-Rich Showcase + Conversion,Attendee Analytics,Professional Blue + Video accent + Brand,Registration. Agenda. Speaker profiles. Live stream. Networking. Recording access. Virtual event features.
+77,Membership/Community,"community, membership",Vibrant & Block-based + Soft UI Evolution,"Bento Box Grid, Micro-interactions",Social Proof-Focused + Conversion,Community Analytics,Community brand colors + Engagement accents,Member benefits. Pricing tiers. Community showcase. Events. Member directory. Exclusive content.
+78,Newsletter Platform,"newsletter, platform",Minimalism + Flat Design,"Swiss Modernism 2.0, Accessible & Ethical",Minimal & Direct + Conversion,Email Analytics,Brand primary + Clean white + CTA accent,Subscribe form. Archive. About. Social proof. Sample content. Simple conversion.
+79,Digital Products/Downloads,"digital, downloads, products",Vibrant & Block-based + Motion-Driven,"Glassmorphism, Bento Box Grid",Feature-Rich Showcase + Conversion,E-commerce Analytics,Product category colors + Brand + Success green,Product showcase. Preview. Pricing. Instant delivery. License management. Customer reviews.
+80,Church/Religious Organization,"church, organization, religious",Accessible & Ethical + Soft UI Evolution,"Minimalism, Trust & Authority",Hero-Centric Design + Social Proof,N/A - Community focused,Warm Gold + Deep Purple/Blue + White,Service times. Events. Sermons. Community. Giving. Location. Welcoming imagery.
+81,Sports Team/Club,"club, sports, team",Vibrant & Block-based + Motion-Driven,"Dark Mode (OLED), 3D & Hyperrealism",Hero-Centric Design + Feature-Rich,Performance Analytics,Team colors + Energetic accents,Schedule. Roster. News. Tickets. Merchandise. Fan engagement. Action imagery.
+82,Museum/Gallery,"gallery, museum",Minimalism + Motion-Driven,"Swiss Modernism 2.0, 3D & Hyperrealism",Storytelling-Driven + Feature-Rich,Visitor Analytics,Art-appropriate neutrals + Exhibition accents,Exhibitions. Collections. Tickets. Events. Virtual tours. Educational content. Art-focused design.
+83,Theater/Cinema,"cinema, theater",Dark Mode (OLED) + Motion-Driven,"Vibrant & Block-based, Glassmorphism",Hero-Centric Design + Conversion,Booking Analytics,Dark + Spotlight accents + Gold,Showtimes. Seat selection. Trailers. Coming soon. Membership. Dramatic imagery.
+84,Language Learning App,"app, language, learning",Claymorphism + Vibrant & Block-based,"Micro-interactions, Flat Design",Feature-Rich Showcase + Social Proof,Learning Analytics,Playful colors + Progress indicators + Country flags,Lesson structure. Progress tracking. Gamification. Speaking practice. Community. Achievement badges.
+85,Coding Bootcamp,"bootcamp, coding",Dark Mode (OLED) + Minimalism,"Cyberpunk UI, Flat Design",Feature-Rich Showcase + Social Proof,Student Analytics,Code editor colors + Brand + Success green,Curriculum. Projects. Career outcomes. Alumni. Pricing. Application. Terminal aesthetic.
+86,Cybersecurity Platform,"cyber, security, platform",Cyberpunk UI + Dark Mode (OLED),"Neubrutalism, Minimal & Direct",Trust & Authority + Real-Time,Real-Time Monitoring + Heat Map,Matrix Green + Deep Black + Terminal feel,Data density. Threat visualization. Dark mode default.
+87,Developer Tool / IDE,"dev, developer, tool, ide",Dark Mode (OLED) + Minimalism,"Flat Design, Bento Box Grid",Minimal & Direct + Documentation,Real-Time Monitor + Terminal,Dark syntax theme colors + Blue focus,Keyboard shortcuts. Syntax highlighting. Fast performance.
+88,Biotech / Life Sciences,"biotech, biology, science",Glassmorphism + Clean Science,"Minimalism, Organic Biophilic",Storytelling-Driven + Research,Data-Dense + Predictive,Sterile White + DNA Blue + Life Green,Data accuracy. Cleanliness. Complex data viz.
+89,Space Tech / Aerospace,"aerospace, space, tech",Holographic / HUD + Dark Mode,"Glassmorphism, 3D & Hyperrealism",Immersive Experience + Hero,Real-Time Monitoring + 3D,Deep Space Black + Star White + Metallic,High-tech feel. Precision. Telemetry data.
+90,Architecture / Interior,"architecture, design, interior",Exaggerated Minimalism + High Imagery,"Swiss Modernism 2.0, Parallax",Portfolio Grid + Visuals,Project Management + Gallery,Monochrome + Gold Accent + High Imagery,High-res images. Typography. Space.
+91,Quantum Computing Interface,"quantum, computing, physics, qubit, future, science",Holographic / HUD + Dark Mode,"Glassmorphism, Spatial UI",Immersive/Interactive Experience,3D Spatial Data + Real-Time Monitor,Quantum Blue #00FFFF + Deep Black + Interference patterns,Visualize complexity. Qubit states. Probability clouds. High-tech trust.
+92,Biohacking / Longevity App,"biohacking, health, longevity, tracking, wellness, science",Biomimetic / Organic 2.0,"Minimalism, Dark Mode (OLED)",Data-Dense + Storytelling,Real-Time Monitor + Biological Data,Cellular Pink/Red + DNA Blue + Clean White,Personal data privacy. Scientific credibility. Biological visualizations.
+93,Autonomous Drone Fleet Manager,"drone, autonomous, fleet, aerial, logistics, robotics",HUD / Sci-Fi FUI,"Real-Time Monitor, Spatial UI",Real-Time Monitor,Geographic + Real-Time,Tactical Green #00FF00 + Alert Red + Map Dark,Real-time telemetry. 3D spatial awareness. Latency indicators. Safety alerts.
+94,Generative Art Platform,"art, generative, ai, creative, platform, gallery",Minimalism (Frame) + Gen Z Chaos,"Masonry Grid, Dark Mode",Bento Grid Showcase,Gallery / Portfolio,Neutral #F5F5F5 (Canvas) + User Content,Content is king. Fast loading. Creator attribution. Minting flow.
+95,Spatial Computing OS / App,"spatial, vr, ar, vision, os, immersive, mixed-reality",Spatial UI (VisionOS),"Glassmorphism, 3D & Hyperrealism",Immersive/Interactive Experience,Spatial Dashboard,Frosted Glass + System Colors + Depth,Gaze/Pinch interaction. Depth hierarchy. Environment awareness.
+96,Sustainable Energy / Climate Tech,"climate, energy, sustainable, green, tech, carbon",Organic Biophilic + E-Ink / Paper,"Data-Dense, Swiss Modernism",Interactive Demo + Data,Energy/Utilities Dashboard,Earth Green + Sky Blue + Solar Yellow,Data transparency. Impact visualization. Low-carbon web design.
\ No newline at end of file
diff --git a/.claude/skills/ui-ux-pro-max/data/prompts.csv b/.claude/skills/ui-ux-pro-max/data/prompts.csv
new file mode 100644
index 0000000..5028192
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/prompts.csv
@@ -0,0 +1,24 @@
+STT,Style Category,AI Prompt Keywords (Copy-Paste Ready),CSS/Technical Keywords,Implementation Checklist,Design System Variables
+1,Minimalism & Swiss Style,"Design a minimalist landing page. Use: white space, geometric layouts, sans-serif fonts, high contrast, grid-based structure, essential elements only. Avoid shadows and gradients. Focus on clarity and functionality.","display: grid, gap: 2rem, font-family: sans-serif, color: #000 or #FFF, max-width: 1200px, clean borders, no box-shadow unless necessary","☐ Grid-based layout 12-16 columns, ☐ Typography hierarchy clear, ☐ No unnecessary decorations, ☐ WCAG AAA contrast verified, ☐ Mobile responsive grid","--spacing: 2rem, --border-radius: 0px, --font-weight: 400-700, --shadow: none, --accent-color: single primary only"
+2,Neumorphism,"Create a neumorphic UI with soft 3D effects. Use light pastels, rounded corners (12-16px), subtle soft shadows (multiple layers), no hard lines, monochromatic color scheme with light/dark variations. Embossed/debossed effect on interactive elements.","border-radius: 12-16px, box-shadow: -5px -5px 15px rgba(0,0,0,0.1), 5px 5px 15px rgba(255,255,255,0.8), background: linear-gradient(145deg, color1, color2), transform: scale on press","☐ Rounded corners 12-16px consistent, ☐ Multiple shadow layers (2-3), ☐ Pastel color verified, ☐ Monochromatic palette checked, ☐ Press animation smooth 150ms","--border-radius: 14px, --shadow-soft-1: -5px -5px 15px, --shadow-soft-2: 5px 5px 15px, --color-light: #F5F5F5, --color-primary: single pastel"
+3,Glassmorphism,"Design a glassmorphic interface with frosted glass effect. Use backdrop blur (10-20px), translucent overlays (rgba 10-30% opacity), vibrant background colors, subtle borders, light source reflection, layered depth. Perfect for modern overlays and cards.","backdrop-filter: blur(15px), background: rgba(255, 255, 255, 0.15), border: 1px solid rgba(255,255,255,0.2), -webkit-backdrop-filter: blur(15px), z-index layering for depth","☐ Backdrop-filter blur 10-20px, ☐ Translucent white 15-30% opacity, ☐ Subtle border 1px light, ☐ Vibrant background verified, ☐ Text contrast 4.5:1 checked","--blur-amount: 15px, --glass-opacity: 0.15, --border-color: rgba(255,255,255,0.2), --background: vibrant color, --text-color: light/dark based on BG"
+4,Brutalism,"Create a brutalist design with raw, unpolished, stark aesthetic. Use pure primary colors (red, blue, yellow), black & white, no smooth transitions (instant), sharp corners, bold large typography, visible grid lines, default system fonts, intentional 'broken' design elements.","border-radius: 0px, transition: none or 0s, font-family: system-ui or monospace, font-weight: 700+, border: visible 2-4px, colors: #FF0000, #0000FF, #FFFF00, #000000, #FFFFFF","☐ No border-radius (0px), ☐ No transitions (instant), ☐ Bold typography (700+), ☐ Pure primary colors used, ☐ Visible grid/borders, ☐ Asymmetric layout intentional","--border-radius: 0px, --transition-duration: 0s, --font-weight: 700-900, --colors: primary only, --border-style: visible, --grid-visible: true"
+5,3D & Hyperrealism,"Build an immersive 3D interface using realistic textures, 3D models (Three.js/Babylon.js), complex shadows, realistic lighting, parallax scrolling (3-5 layers), physics-based motion. Include skeuomorphic elements with tactile detail.","transform: translate3d, perspective: 1000px, WebGL canvas, Three.js/Babylon.js library, box-shadow: complex multi-layer, background: complex gradients, filter: drop-shadow()","☐ WebGL/Three.js integrated, ☐ 3D models loaded, ☐ Parallax 3-5 layers, ☐ Realistic lighting verified, ☐ Complex shadows rendered, ☐ Physics animation smooth 300-400ms","--perspective: 1000px, --parallax-layers: 5, --lighting-intensity: realistic, --shadow-depth: 20-40%, --animation-duration: 300-400ms"
+6,Vibrant & Block-based,"Design an energetic, vibrant interface with bold block layouts, geometric shapes, high color contrast, large typography (32px+), animated background patterns, duotone effects. Perfect for startups and youth-focused apps. Use 4-6 contrasting colors from complementary/triadic schemes.","display: flex/grid with large gaps (48px+), font-size: 32px+, background: animated patterns (CSS), color: neon/vibrant colors, animation: continuous pattern movement","☐ Block layout with 48px+ gaps, ☐ Large typography 32px+, ☐ 4-6 vibrant colors max, ☐ Animated patterns active, ☐ Scroll-snap enabled, ☐ High contrast verified (7:1+)","--block-gap: 48px, --typography-size: 32px+, --color-palette: 4-6 vibrant colors, --animation: continuous pattern, --contrast-ratio: 7:1+"
+7,Dark Mode (OLED),"Create an OLED-optimized dark interface with deep black (#000000), dark grey (#121212), midnight blue accents. Use minimal glow effects, vibrant neon accents (green, blue, gold, purple), high contrast text. Optimize for eye comfort and OLED power saving.","background: #000000 or #121212, color: #FFFFFF or #E0E0E0, text-shadow: 0 0 10px neon-color (sparingly), filter: brightness(0.8) if needed, color-scheme: dark","☐ Deep black #000000 or #121212, ☐ Vibrant neon accents used, ☐ Text contrast 7:1+, ☐ Minimal glow effects, ☐ OLED power optimization, ☐ No white (#FFFFFF) background","--bg-black: #000000, --bg-dark-grey: #121212, --text-primary: #FFFFFF, --accent-neon: neon colors, --glow-effect: minimal, --oled-optimized: true"
+8,Accessible & Ethical,"Design with WCAG AAA compliance. Include: high contrast (7:1+), large text (16px+), keyboard navigation, screen reader compatibility, focus states visible (3-4px ring), semantic HTML, ARIA labels, skip links, reduced motion support (prefers-reduced-motion), 44x44px touch targets.","color-contrast: 7:1+, font-size: 16px+, outline: 3-4px on :focus-visible, aria-label, role attributes, @media (prefers-reduced-motion), touch-target: 44x44px, cursor: pointer","☐ WCAG AAA verified, ☐ 7:1+ contrast checked, ☐ Keyboard navigation tested, ☐ Screen reader tested, ☐ Focus visible 3-4px, ☐ Semantic HTML used, ☐ Touch targets 44x44px","--contrast-ratio: 7:1, --font-size-min: 16px, --focus-ring: 3-4px, --touch-target: 44x44px, --wcag-level: AAA, --keyboard-accessible: true, --sr-tested: true"
+9,Claymorphism,"Design a playful, toy-like interface with soft 3D, chunky elements, bubbly aesthetic, rounded edges (16-24px), thick borders (3-4px), double shadows (inner + outer), pastel colors, smooth animations. Perfect for children's apps and creative tools.","border-radius: 16-24px, border: 3-4px solid, box-shadow: inset -2px -2px 8px, 4px 4px 8px, background: pastel-gradient, animation: soft bounce (cubic-bezier 0.34, 1.56)","☐ Border-radius 16-24px, ☐ Thick borders 3-4px, ☐ Double shadows (inner+outer), ☐ Pastel colors used, ☐ Soft bounce animations, ☐ Playful interactions","--border-radius: 20px, --border-width: 3-4px, --shadow-inner: inset -2px -2px 8px, --shadow-outer: 4px 4px 8px, --color-palette: pastels, --animation: bounce"
+10,Aurora UI,"Create a vibrant gradient interface inspired by Northern Lights with mesh gradients, smooth color blends, flowing animations. Use complementary color pairs (blue-orange, purple-yellow), flowing background gradients, subtle continuous animations (8-12s loops), iridescent effects.","background: conic-gradient or radial-gradient with multiple stops, animation: @keyframes gradient (8-12s), background-size: 200% 200%, filter: saturate(1.2), blend-mode: screen or multiply","☐ Mesh/flowing gradients applied, ☐ 8-12s animation loop, ☐ Complementary colors used, ☐ Smooth color transitions, ☐ Iridescent effect subtle, ☐ Text contrast verified","--gradient-colors: complementary pairs, --animation-duration: 8-12s, --blend-mode: screen, --color-saturation: 1.2, --effect: iridescent, --loop-smooth: true"
+11,Retro-Futurism,"Build a retro-futuristic (cyberpunk/vaporwave) interface with neon colors (blue, pink, cyan), deep black background, 80s aesthetic, CRT scanlines, glitch effects, neon glow text/borders, monospace fonts, geometric patterns. Use neon text-shadow and animated glitch effects.","color: neon colors (#0080FF, #FF006E, #00FFFF), text-shadow: 0 0 10px neon, background: #000 or #1A1A2E, font-family: monospace, animation: glitch (skew+offset), filter: hue-rotate","☐ Neon colors used, ☐ CRT scanlines effect, ☐ Glitch animations active, ☐ Monospace font, ☐ Deep black background, ☐ Glow effects applied, ☐ 80s patterns present","--neon-colors: #0080FF #FF006E #00FFFF, --background: #000000, --font-family: monospace, --effect: glitch+glow, --scanline-opacity: 0.3, --crt-effect: true"
+12,Flat Design,"Create a flat, 2D interface with bold colors, no shadows/gradients, clean lines, simple geometric shapes, icon-heavy, typography-focused, minimal ornamentation. Use 4-6 solid, bright colors in a limited palette with high saturation.","box-shadow: none, background: solid color, border-radius: 0-4px, color: solid (no gradients), fill: solid, stroke: 1-2px, font: bold sans-serif, icons: simplified SVG","☐ No shadows/gradients, ☐ 4-6 solid colors max, ☐ Clean lines consistent, ☐ Simple shapes used, ☐ Icon-heavy layout, ☐ High saturation colors, ☐ Fast loading verified","--shadow: none, --color-palette: 4-6 solid, --border-radius: 2px, --gradient: none, --icons: simplified SVG, --animation: minimal 150-200ms"
+13,Skeuomorphism,"Design a realistic, textured interface with 3D depth, real-world metaphors (leather, wood, metal), complex gradients (8-12 stops), realistic shadows, grain/texture overlays, tactile press animations. Perfect for premium/luxury products.","background: complex gradient (8-12 stops), box-shadow: realistic multi-layer, background-image: texture overlay (noise, grain), filter: drop-shadow, transform: scale on press (300-500ms)","☐ Realistic textures applied, ☐ Complex gradients 8-12 stops, ☐ Multi-layer shadows, ☐ Texture overlays present, ☐ Tactile animations smooth, ☐ Depth effect pronounced","--gradient-stops: 8-12, --texture-overlay: noise+grain, --shadow-layers: 3+, --animation-duration: 300-500ms, --depth-effect: pronounced, --tactile: true"
+14,Liquid Glass,"Create a premium liquid glass effect with morphing shapes, flowing animations, chromatic aberration, iridescent gradients, smooth 400-600ms transitions. Use SVG morphing for shape changes, dynamic blur, smooth color transitions creating a fluid, premium feel.","animation: morphing SVG paths (400-600ms), backdrop-filter: blur + saturate, filter: hue-rotate + brightness, blend-mode: screen, background: iridescent gradient","☐ Morphing animations 400-600ms, ☐ Chromatic aberration applied, ☐ Dynamic blur active, ☐ Iridescent gradients, ☐ Smooth color transitions, ☐ Premium feel achieved","--morph-duration: 400-600ms, --blur-amount: 15px, --chromatic-aberration: true, --iridescent: true, --blend-mode: screen, --smooth-transitions: true"
+15,Motion-Driven,"Build an animation-heavy interface with scroll-triggered animations, microinteractions, parallax scrolling (3-5 layers), smooth transitions (300-400ms), entrance animations, page transitions. Use Intersection Observer for scroll effects, transform for performance, GPU acceleration.","animation: @keyframes scroll-reveal, transform: translateY/X, Intersection Observer API, will-change: transform, scroll-behavior: smooth, animation-duration: 300-400ms","☐ Scroll animations active, ☐ Parallax 3-5 layers, ☐ Entrance animations smooth, ☐ Page transitions fluid, ☐ GPU accelerated, ☐ Prefers-reduced-motion respected","--animation-duration: 300-400ms, --parallax-layers: 5, --scroll-behavior: smooth, --gpu-accelerated: true, --entrance-animation: true, --page-transition: smooth"
+16,Micro-interactions,"Design with delightful micro-interactions: small 50-100ms animations, gesture-based responses, tactile feedback, loading spinners, success/error states, subtle hover effects, haptic feedback triggers for mobile. Focus on responsive, contextual interactions.","animation: short 50-100ms, transition: hover states, @media (hover: hover) for desktop, :active for press, haptic-feedback CSS/API, loading animation smooth loop","☐ Micro-animations 50-100ms, ☐ Gesture-responsive, ☐ Tactile feedback visual/haptic, ☐ Loading spinners smooth, ☐ Success/error states clear, ☐ Hover effects subtle","--micro-animation-duration: 50-100ms, --gesture-responsive: true, --haptic-feedback: true, --loading-animation: smooth, --state-feedback: success+error"
+17,Inclusive Design,"Design for universal accessibility: high contrast (7:1+), large text (16px+), keyboard-only navigation, screen reader optimization, WCAG AAA compliance, symbol-based color indicators (not color-only), haptic feedback, voice interaction support, reduced motion options.","aria-* attributes complete, role attributes semantic, focus-visible: 3-4px ring, color-contrast: 7:1+, @media (prefers-reduced-motion), alt text on all images, form labels properly associated","☐ WCAG AAA verified, ☐ 7:1+ contrast all text, ☐ Keyboard accessible (Tab/Enter), ☐ Screen reader tested, ☐ Focus visible 3-4px, ☐ No color-only indicators, ☐ Haptic fallback","--contrast-ratio: 7:1, --font-size: 16px+, --keyboard-accessible: true, --sr-compatible: true, --wcag-level: AAA, --color-symbols: true, --haptic: enabled"
+18,Zero Interface,"Create a voice-first, gesture-based, AI-driven interface with minimal visible UI, progressive disclosure, voice recognition UI, gesture detection, AI predictions, smart suggestions, context-aware actions. Hide controls until needed.","voice-commands: Web Speech API, gesture-detection: touch events, AI-predictions: hidden by default (reveal on hover), progressive-disclosure: show on demand, minimal UI visible","☐ Voice commands responsive, ☐ Gesture detection active, ☐ AI predictions hidden/revealed, ☐ Progressive disclosure working, ☐ Minimal visible UI, ☐ Smart suggestions contextual","--voice-ui: enabled, --gesture-detection: active, --ai-predictions: smart, --progressive-disclosure: true, --visible-ui: minimal, --context-aware: true"
+19,Soft UI Evolution,"Design evolved neumorphism with improved contrast (WCAG AA+), modern aesthetics, subtle depth, accessibility focus. Use soft shadows (softer than flat but clearer than pure neumorphism), better color hierarchy, improved focus states, modern 200-300ms animations.","box-shadow: softer multi-layer (0 2px 4px), background: improved contrast pastels, border-radius: 8-12px, animation: 200-300ms smooth, outline: 2-3px on focus, contrast: 4.5:1+","☐ Improved contrast AA/AAA, ☐ Soft shadows modern, ☐ Border-radius 8-12px, ☐ Animations 200-300ms, ☐ Focus states visible, ☐ Color hierarchy clear","--shadow-soft: modern blend, --border-radius: 10px, --animation-duration: 200-300ms, --contrast-ratio: 4.5:1+, --color-hierarchy: improved, --wcag-level: AA+"
+20,Bento Grids,"Design a Bento Grid layout. Use: modular grid system, rounded corners (16-24px), different card sizes (1x1, 2x1, 2x2), card-based hierarchy, soft backgrounds (#F5F5F7), subtle borders, content-first, Apple-style aesthetic.","display: grid, grid-template-columns: repeat(auto-fit, minmax(...)), gap: 1rem, border-radius: 20px, background: #FFF, box-shadow: subtle","☐ Grid layout (CSS Grid), ☐ Rounded corners 16-24px, ☐ Varied card spans, ☐ Content fits card size, ☐ Responsive re-flow, ☐ Apple-like aesthetic","--grid-gap: 20px, --card-radius: 24px, --card-bg: #FFFFFF, --page-bg: #F5F5F7, --shadow: soft"
+21,Neubrutalism,"Design a neubrutalist interface. Use: high contrast, hard black borders (3px+), bright pop colors, no blur, sharp or slightly rounded corners, bold typography, hard shadows (offset 4px 4px), raw aesthetic but functional.","border: 3px solid black, box-shadow: 5px 5px 0px black, colors: #FFDB58 #FF6B6B #4ECDC4, font-weight: 700, no gradients","☐ Hard borders (2-4px), ☐ Hard offset shadows, ☐ High saturation colors, ☐ Bold typography, ☐ No blurs/gradients, ☐ Distinctive 'ugly-cute' look","--border-width: 3px, --shadow-offset: 4px, --shadow-color: #000, --colors: high saturation, --font: bold sans"
+22,HUD / Sci-Fi FUI,"Design a futuristic HUD (Heads Up Display) or FUI. Use: thin lines (1px), neon cyan/blue on black, technical markers, decorative brackets, data visualization, monospaced tech fonts, glowing elements, transparency.","border: 1px solid rgba(0,255,255,0.5), color: #00FFFF, background: transparent or rgba(0,0,0,0.8), font-family: monospace, text-shadow: 0 0 5px cyan","☐ Fine lines 1px, ☐ Neon glow text/borders, ☐ Monospaced font, ☐ Dark/Transparent BG, ☐ Decorative tech markers, ☐ Holographic feel","--hud-color: #00FFFF, --bg-color: rgba(0,10,20,0.9), --line-width: 1px, --glow: 0 0 5px, --font: monospace"
+23,Pixel Art,"Design a pixel art inspired interface. Use: pixelated fonts, 8-bit or 16-bit aesthetic, sharp edges (image-rendering: pixelated), limited color palette, blocky UI elements, retro gaming feel.","font-family: 'Press Start 2P', image-rendering: pixelated, box-shadow: 4px 0 0 #000 (pixel border), no anti-aliasing","☐ Pixelated fonts loaded, ☐ Images sharp (no blur), ☐ CSS box-shadow for pixel borders, ☐ Retro palette, ☐ Blocky layout","--pixel-size: 4px, --font: pixel font, --border-style: pixel-shadow, --anti-alias: none"
diff --git a/.claude/skills/ui-ux-pro-max/data/react-performance.csv b/.claude/skills/ui-ux-pro-max/data/react-performance.csv
new file mode 100644
index 0000000..671465f
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/react-performance.csv
@@ -0,0 +1,45 @@
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Async Waterfall,Defer Await,async await defer branch,React/Next.js,Move await into branches where actually used to avoid blocking unused code paths,Move await operations into branches where they're needed,Await at top of function blocking all branches,"if (skip) return { skipped: true }; const data = await fetch()","const data = await fetch(); if (skip) return { skipped: true }",Critical
+2,Async Waterfall,Promise.all Parallel,promise all parallel concurrent,React/Next.js,Execute independent async operations concurrently using Promise.all(),Use Promise.all() for independent operations,Sequential await for independent operations,"const [user, posts] = await Promise.all([fetchUser(), fetchPosts()])","const user = await fetchUser(); const posts = await fetchPosts()",Critical
+3,Async Waterfall,Dependency Parallelization,better-all dependency parallel,React/Next.js,Use better-all for operations with partial dependencies to maximize parallelism,Use better-all to start each task at earliest possible moment,Wait for unrelated data before starting dependent fetch,"await all({ user() {}, config() {}, profile() { return fetch((await this.$.user).id) } })","const [user, config] = await Promise.all([...]); const profile = await fetchProfile(user.id)",Critical
+4,Async Waterfall,API Route Optimization,api route waterfall promise,React/Next.js,In API routes start independent operations immediately even if not awaited yet,Start promises early and await late,Sequential awaits in API handlers,"const sessionP = auth(); const configP = fetchConfig(); const session = await sessionP","const session = await auth(); const config = await fetchConfig()",Critical
+5,Async Waterfall,Suspense Boundaries,suspense streaming boundary,React/Next.js,Use Suspense to show wrapper UI faster while data loads,Wrap async components in Suspense boundaries,Await data blocking entire page render,"<Suspense fallback={<Skeleton />}><DataDisplay /></Suspense>","const data = await fetchData(); return <DataDisplay data={data} />",High
+6,Bundle Size,Barrel Imports,barrel import direct path,React/Next.js,Import directly from source files instead of barrel files to avoid loading unused modules,Import directly from source path,Import from barrel/index files,"import Check from 'lucide-react/dist/esm/icons/check'","import { Check } from 'lucide-react'",Critical
+7,Bundle Size,Dynamic Imports,dynamic import lazy next,React/Next.js,Use next/dynamic to lazy-load large components not needed on initial render,Use dynamic() for heavy components,Import heavy components at top level,"const Monaco = dynamic(() => import('./monaco'), { ssr: false })","import { MonacoEditor } from './monaco-editor'",Critical
+8,Bundle Size,Defer Third Party,analytics defer third-party,React/Next.js,Load analytics and logging after hydration since they don't block interaction,Load non-critical scripts after hydration,Include analytics in main bundle,"const Analytics = dynamic(() => import('@vercel/analytics'), { ssr: false })","import { Analytics } from '@vercel/analytics/react'",Medium
+9,Bundle Size,Conditional Loading,conditional module lazy,React/Next.js,Load large data or modules only when a feature is activated,Dynamic import when feature enabled,Import large modules unconditionally,"useEffect(() => { if (enabled) import('./heavy.js') }, [enabled])","import { heavyData } from './heavy.js'",High
+10,Bundle Size,Preload Intent,preload hover focus intent,React/Next.js,Preload heavy bundles on hover/focus before they're needed,Preload on user intent signals,Load only on click,"onMouseEnter={() => import('./editor')}","onClick={() => import('./editor')}",Medium
+11,Server,React.cache Dedup,react cache deduplicate request,React/Next.js,Use React.cache() for server-side request deduplication within single request,Wrap data fetchers with cache(),Fetch same data multiple times in tree,"export const getUser = cache(async () => await db.user.find())","export async function getUser() { return await db.user.find() }",Medium
+12,Server,LRU Cache Cross-Request,lru cache cross request,React/Next.js,Use LRU cache for data shared across sequential requests,Use LRU for cross-request caching,Refetch same data on every request,"const cache = new LRUCache({ max: 1000, ttl: 5*60*1000 })","Always fetch from database",High
+13,Server,Minimize Serialization,serialization rsc boundary,React/Next.js,Only pass fields that client actually uses across RSC boundaries,Pass only needed fields to client components,Pass entire objects to client,"<Profile name={user.name} />","<Profile user={user} /> // 50 fields serialized",High
+14,Server,Parallel Fetching,parallel fetch component composition,React/Next.js,Restructure components to parallelize data fetching in RSC,Use component composition for parallel fetches,Sequential fetches in parent component,"<Header /><Sidebar /> // both fetch in parallel","const header = await fetchHeader(); return <><div>{header}</div><Sidebar /></>",Critical
+15,Server,After Non-blocking,after non-blocking logging,React/Next.js,Use Next.js after() to schedule work after response is sent,Use after() for logging/analytics,Block response for non-critical operations,"after(async () => { await logAction() }); return Response.json(data)","await logAction(); return Response.json(data)",Medium
+16,Client,SWR Deduplication,swr dedup cache revalidate,React/Next.js,Use SWR for automatic request deduplication and caching,Use useSWR for client data fetching,Manual fetch in useEffect,"const { data } = useSWR('/api/users', fetcher)","useEffect(() => { fetch('/api/users').then(setUsers) }, [])",Medium-High
+17,Client,Event Listener Dedup,event listener deduplicate global,React/Next.js,Share global event listeners across component instances,Use useSWRSubscription for shared listeners,Register listener per component instance,"useSWRSubscription('global-keydown', () => { window.addEventListener... })","useEffect(() => { window.addEventListener('keydown', handler) }, [])",Low
+18,Rerender,Defer State Reads,state read callback subscription,React/Next.js,Don't subscribe to state only used in callbacks,Read state on-demand in callbacks,Subscribe to state used only in handlers,"const handleClick = () => { const params = new URLSearchParams(location.search) }","const params = useSearchParams(); const handleClick = () => { params.get('ref') }",Medium
+19,Rerender,Memoized Components,memo extract expensive,React/Next.js,Extract expensive work into memoized components for early returns,Extract to memo() components,Compute expensive values before early return,"const UserAvatar = memo(({ user }) => ...); if (loading) return <Skeleton />","const avatar = useMemo(() => compute(user)); if (loading) return <Skeleton />",Medium
+20,Rerender,Narrow Dependencies,effect dependency primitive,React/Next.js,Specify primitive dependencies instead of objects in effects,Use primitive values in dependency arrays,Use object references as dependencies,"useEffect(() => { console.log(user.id) }, [user.id])","useEffect(() => { console.log(user.id) }, [user])",Low
+21,Rerender,Derived State,derived boolean subscription,React/Next.js,Subscribe to derived booleans instead of continuous values,Use derived boolean state,Subscribe to continuous values,"const isMobile = useMediaQuery('(max-width: 767px)')","const width = useWindowWidth(); const isMobile = width < 768",Medium
+22,Rerender,Functional setState,functional setstate callback,React/Next.js,Use functional setState updates for stable callbacks and no stale closures,Use functional form: setState(curr => ...),Reference state directly in setState,"setItems(curr => [...curr, newItem])","setItems([...items, newItem]) // items in deps",Medium
+23,Rerender,Lazy State Init,usestate lazy initialization,React/Next.js,Pass function to useState for expensive initial values,Use function form for expensive init,Compute expensive value directly,"useState(() => buildSearchIndex(items))","useState(buildSearchIndex(items)) // runs every render",Medium
+24,Rerender,Transitions,starttransition non-urgent,React/Next.js,Mark frequent non-urgent state updates as transitions,Use startTransition for non-urgent updates,Block UI on every state change,"startTransition(() => setScrollY(window.scrollY))","setScrollY(window.scrollY) // blocks on every scroll",Medium
+25,Rendering,SVG Animation Wrapper,svg animation wrapper div,React/Next.js,Wrap SVG in div and animate wrapper for hardware acceleration,Animate div wrapper around SVG,Animate SVG element directly,"<div class='animate-spin'><svg>...</svg></div>","<svg class='animate-spin'>...</svg>",Low
+26,Rendering,Content Visibility,content-visibility auto,React/Next.js,Apply content-visibility: auto to defer off-screen rendering,Use content-visibility for long lists,Render all list items immediately,".item { content-visibility: auto; contain-intrinsic-size: 0 80px }","Render 1000 items without optimization",High
+27,Rendering,Hoist Static JSX,hoist static jsx element,React/Next.js,Extract static JSX outside components to avoid re-creation,Hoist static elements to module scope,Create static elements inside components,"const skeleton = <div class='animate-pulse' />; function C() { return skeleton }","function C() { return <div class='animate-pulse' /> }",Low
+28,Rendering,Hydration No Flicker,hydration mismatch flicker,React/Next.js,Use inline script to set client-only data before hydration,Inject sync script for client-only values,Use useEffect causing flash,"<script dangerouslySetInnerHTML={{ __html: 'el.className = localStorage.theme' }} />","useEffect(() => setTheme(localStorage.theme), []) // flickers",Medium
+29,Rendering,Conditional Render,conditional render ternary,React/Next.js,Use ternary instead of && when condition can be 0 or NaN,Use explicit ternary for conditionals,Use && with potentially falsy numbers,"{count > 0 ? <Badge>{count}</Badge> : null}","{count && <Badge>{count}</Badge>} // renders '0'",Low
+30,Rendering,Activity Component,activity show hide preserve,React/Next.js,Use Activity component to preserve state/DOM for toggled components,Use Activity for expensive toggle components,Unmount/remount on visibility toggle,"<Activity mode={isOpen ? 'visible' : 'hidden'}><Menu /></Activity>","{isOpen && <Menu />} // loses state",Medium
+31,JS Perf,Batch DOM CSS,batch dom css reflow,React/Next.js,Group CSS changes via classes or cssText to minimize reflows,Use class toggle or cssText,Change styles one property at a time,"element.classList.add('highlighted')","el.style.width='100px'; el.style.height='200px'",Medium
+32,JS Perf,Index Map Lookup,map index lookup find,React/Next.js,Build Map for repeated lookups instead of multiple .find() calls,Build index Map for O(1) lookups,Use .find() in loops,"const byId = new Map(users.map(u => [u.id, u])); byId.get(id)","users.find(u => u.id === order.userId) // O(n) each time",Low-Medium
+33,JS Perf,Cache Property Access,cache property loop,React/Next.js,Cache object property lookups in hot paths,Cache values before loops,Access nested properties in loops,"const val = obj.config.settings.value; for (...) process(val)","for (...) process(obj.config.settings.value)",Low-Medium
+34,JS Perf,Cache Function Results,memoize cache function,React/Next.js,Use module-level Map to cache repeated function results,Use Map cache for repeated calls,Recompute same values repeatedly,"const cache = new Map(); if (cache.has(x)) return cache.get(x)","slugify(name) // called 100 times same input",Medium
+35,JS Perf,Cache Storage API,localstorage cache read,React/Next.js,Cache localStorage/sessionStorage reads in memory,Cache storage reads in Map,Read storage on every call,"if (!cache.has(key)) cache.set(key, localStorage.getItem(key))","localStorage.getItem('theme') // every call",Low-Medium
+36,JS Perf,Combine Iterations,combine filter map loop,React/Next.js,Combine multiple filter/map into single loop,Single loop for multiple categorizations,Chain multiple filter() calls,"for (u of users) { if (u.isAdmin) admins.push(u); if (u.isTester) testers.push(u) }","users.filter(admin); users.filter(tester); users.filter(inactive)",Low-Medium
+37,JS Perf,Length Check First,length check array compare,React/Next.js,Check array lengths before expensive comparisons,Early return if lengths differ,Always run expensive comparison,"if (a.length !== b.length) return true; // then compare","a.sort().join() !== b.sort().join() // even when lengths differ",Medium-High
+38,JS Perf,Early Return,early return exit function,React/Next.js,Return early when result is determined to skip processing,Return immediately on first error,Process all items then check errors,"for (u of users) { if (!u.email) return { error: 'Email required' } }","let hasError; for (...) { if (!email) hasError=true }; if (hasError)...",Low-Medium
+39,JS Perf,Hoist RegExp,regexp hoist module,React/Next.js,Don't create RegExp inside render - hoist or memoize,Hoist RegExp to module scope,Create RegExp every render,"const EMAIL_RE = /^[^@]+@[^@]+$/; function validate() { EMAIL_RE.test(x) }","function C() { const re = new RegExp(pattern); re.test(x) }",Low-Medium
+40,JS Perf,Loop Min Max,loop min max sort,React/Next.js,Use loop for min/max instead of sort - O(n) vs O(n log n),Single pass loop for min/max,Sort array to find min/max,"let max = arr[0]; for (x of arr) if (x > max) max = x","arr.sort((a,b) => b-a)[0] // O(n log n)",Low
+41,JS Perf,Set Map Lookups,set map includes has,React/Next.js,Use Set/Map for O(1) lookups instead of array.includes(),Convert to Set for membership checks,Use .includes() for repeated checks,"const allowed = new Set(['a','b']); allowed.has(id)","const allowed = ['a','b']; allowed.includes(id)",Low-Medium
+42,JS Perf,toSorted Immutable,tosorted sort immutable,React/Next.js,Use toSorted() instead of sort() to avoid mutating arrays,Use toSorted() for immutability,Mutate arrays with sort(),"users.toSorted((a,b) => a.name.localeCompare(b.name))","users.sort((a,b) => a.name.localeCompare(b.name)) // mutates",Medium-High
+43,Advanced,Event Handler Refs,useeffectevent ref handler,React/Next.js,Store callbacks in refs for stable effect subscriptions,Use useEffectEvent for stable handlers,Re-subscribe on every callback change,"const onEvent = useEffectEvent(handler); useEffect(() => { listen(onEvent) }, [])","useEffect(() => { listen(handler) }, [handler]) // re-subscribes",Low
+44,Advanced,useLatest Hook,uselatest ref callback,React/Next.js,Access latest values in callbacks without adding to dependency arrays,Use useLatest for fresh values in stable callbacks,Add callback to effect dependencies,"const cbRef = useLatest(cb); useEffect(() => { setTimeout(() => cbRef.current()) }, [])","useEffect(() => { setTimeout(() => cb()) }, [cb]) // re-runs",Low
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/flutter.csv b/.claude/skills/ui-ux-pro-max/data/stacks/flutter.csv
new file mode 100644
index 0000000..2e32c6a
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/flutter.csv
@@ -0,0 +1,53 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Widgets,Use StatelessWidget when possible,Immutable widgets are simpler,StatelessWidget for static UI,StatefulWidget for everything,class MyWidget extends StatelessWidget,class MyWidget extends StatefulWidget (static),Medium,https://api.flutter.dev/flutter/widgets/StatelessWidget-class.html
+2,Widgets,Keep widgets small,Single responsibility principle,Extract widgets into smaller pieces,Large build methods,Column(children: [Header() Content()]),500+ line build method,Medium,
+3,Widgets,Use const constructors,Compile-time constants for performance,const MyWidget() when possible,Non-const for static widgets,const Text('Hello'),Text('Hello') for literals,High,https://dart.dev/guides/language/language-tour#constant-constructors
+4,Widgets,Prefer composition over inheritance,Combine widgets using children,Compose widgets,Extend widget classes,Container(child: MyContent()),class MyContainer extends Container,Medium,
+5,State,Use setState correctly,Minimal state in StatefulWidget,setState for UI state changes,setState for business logic,setState(() { _counter++; }),Complex logic in setState,Medium,https://api.flutter.dev/flutter/widgets/State/setState.html
+6,State,Avoid setState in build,Never call setState during build,setState in callbacks only,setState in build method,onPressed: () => setState(() {}),build() { setState(); },High,
+7,State,Use state management for complex apps,Provider Riverpod BLoC,State management for shared state,setState for global state,Provider.of<MyState>(context),Global setState calls,Medium,
+8,State,Prefer Riverpod or Provider,Recommended state solutions,Riverpod for new projects,InheritedWidget manually,ref.watch(myProvider),Custom InheritedWidget,Medium,https://riverpod.dev/
+9,State,Dispose resources,Clean up controllers and subscriptions,dispose() for cleanup,Memory leaks from subscriptions,@override void dispose() { controller.dispose(); },No dispose implementation,High,
+10,Layout,Use Column and Row,Basic layout widgets,Column Row for linear layouts,Stack for simple layouts,"Column(children: [Text(), Button()])",Stack for vertical list,Medium,https://api.flutter.dev/flutter/widgets/Column-class.html
+11,Layout,Use Expanded and Flexible,Control flex behavior,Expanded to fill space,Fixed sizes in flex containers,Expanded(child: Container()),Container(width: 200) in Row,Medium,
+12,Layout,Use SizedBox for spacing,Consistent spacing,SizedBox for gaps,Container for spacing only,SizedBox(height: 16),Container(height: 16),Low,
+13,Layout,Use LayoutBuilder for responsive,Respond to constraints,LayoutBuilder for adaptive layouts,Fixed sizes for responsive,LayoutBuilder(builder: (context constraints) {}),Container(width: 375),Medium,https://api.flutter.dev/flutter/widgets/LayoutBuilder-class.html
+14,Layout,Avoid deep nesting,Keep widget tree shallow,Extract deeply nested widgets,10+ levels of nesting,Extract widget to method or class,Column(Row(Column(Row(...)))),Medium,
+15,Lists,Use ListView.builder,Lazy list building,ListView.builder for long lists,ListView with children for large lists,"ListView.builder(itemCount: 100, itemBuilder: ...)",ListView(children: items.map(...).toList()),High,https://api.flutter.dev/flutter/widgets/ListView-class.html
+16,Lists,Provide itemExtent when known,Skip measurement,itemExtent for fixed height items,No itemExtent for uniform lists,ListView.builder(itemExtent: 50),ListView.builder without itemExtent,Medium,
+17,Lists,Use keys for stateful items,Preserve widget state,Key for stateful list items,No key for dynamic lists,ListTile(key: ValueKey(item.id)),ListTile without key,High,
+18,Lists,Use SliverList for custom scroll,Custom scroll effects,CustomScrollView with Slivers,Nested ListViews,CustomScrollView(slivers: [SliverList()]),ListView inside ListView,Medium,https://api.flutter.dev/flutter/widgets/SliverList-class.html
+19,Navigation,Use Navigator 2.0 or GoRouter,Declarative routing,go_router for navigation,Navigator.push for complex apps,GoRouter(routes: [...]),Navigator.push everywhere,Medium,https://pub.dev/packages/go_router
+20,Navigation,Use named routes,Organized navigation,Named routes for clarity,Anonymous routes,Navigator.pushNamed(context '/home'),Navigator.push(context MaterialPageRoute()),Low,
+21,Navigation,Handle back button (PopScope),Android back behavior and predictive back (Android 14+),Use PopScope widget (WillPopScope is deprecated),Use WillPopScope,"PopScope(canPop: false, onPopInvoked: (didPop) => ...)",WillPopScope(onWillPop: ...),High,https://api.flutter.dev/flutter/widgets/PopScope-class.html
+22,Navigation,Pass typed arguments,Type-safe route arguments,Typed route arguments,Dynamic arguments,MyRoute(id: '123'),arguments: {'id': '123'},Medium,
+23,Async,Use FutureBuilder,Async UI building,FutureBuilder for async data,setState for async,FutureBuilder(future: fetchData()),fetchData().then((d) => setState()),Medium,https://api.flutter.dev/flutter/widgets/FutureBuilder-class.html
+24,Async,Use StreamBuilder,Stream UI building,StreamBuilder for streams,Manual stream subscription,StreamBuilder(stream: myStream),stream.listen in initState,Medium,https://api.flutter.dev/flutter/widgets/StreamBuilder-class.html
+25,Async,Handle loading and error states,Complete async UI states,ConnectionState checks,Only success state,if (snapshot.connectionState == ConnectionState.waiting),No loading indicator,High,
+26,Async,Cancel subscriptions,Clean up stream subscriptions,Cancel in dispose,Memory leaks,subscription.cancel() in dispose,No subscription cleanup,High,
+27,Theming,Use ThemeData,Consistent theming,ThemeData for app theme,Hardcoded colors,Theme.of(context).primaryColor,Color(0xFF123456) everywhere,Medium,https://api.flutter.dev/flutter/material/ThemeData-class.html
+28,Theming,Use ColorScheme,Material 3 color system,ColorScheme for colors,Individual color properties,colorScheme: ColorScheme.fromSeed(),primaryColor: Colors.blue,Medium,
+29,Theming,Access theme via context,Dynamic theme access,Theme.of(context),Static theme reference,Theme.of(context).textTheme.bodyLarge,TextStyle(fontSize: 16),Medium,
+30,Theming,Support dark mode,Respect system theme,darkTheme in MaterialApp,Light theme only,"MaterialApp(theme: light, darkTheme: dark)",MaterialApp(theme: light),Medium,
+31,Animation,Use implicit animations,Simple animations,AnimatedContainer AnimatedOpacity,Explicit for simple transitions,AnimatedContainer(duration: Duration()),AnimationController for fade,Low,https://api.flutter.dev/flutter/widgets/AnimatedContainer-class.html
+32,Animation,Use AnimationController for complex,Fine-grained control,AnimationController with Ticker,Implicit for complex sequences,AnimationController(vsync: this),AnimatedContainer for staggered,Medium,
+33,Animation,Dispose AnimationControllers,Clean up animation resources,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
+34,Animation,Use Hero for transitions,Shared element transitions,Hero for navigation animations,Manual shared element,Hero(tag: 'image' child: Image()),Custom shared element animation,Low,https://api.flutter.dev/flutter/widgets/Hero-class.html
+35,Forms,Use Form widget,Form validation,Form with GlobalKey,Individual validation,Form(key: _formKey child: ...),TextField without Form,Medium,https://api.flutter.dev/flutter/widgets/Form-class.html
+36,Forms,Use TextEditingController,Control text input,Controller for text fields,onChanged for all text,final controller = TextEditingController(),onChanged: (v) => setState(),Medium,
+37,Forms,Validate on submit,Form validation flow,_formKey.currentState!.validate(),Skip validation,if (_formKey.currentState!.validate()),Submit without validation,High,
+38,Forms,Dispose controllers,Clean up text controllers,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
+39,Performance,Use const widgets,Reduce rebuilds,const for static widgets,No const for literals,const Icon(Icons.add),Icon(Icons.add),High,
+40,Performance,Avoid rebuilding entire tree,Minimal rebuild scope,Isolate changing widgets,setState on parent,Consumer only around changing widget,setState on root widget,High,
+41,Performance,Use RepaintBoundary,Isolate repaints,RepaintBoundary for animations,Full screen repaints,RepaintBoundary(child: AnimatedWidget()),Animation without boundary,Medium,https://api.flutter.dev/flutter/widgets/RepaintBoundary-class.html
+42,Performance,Profile with DevTools,Measure before optimizing,Flutter DevTools profiling,Guess at performance,DevTools performance tab,Optimize without measuring,Medium,https://docs.flutter.dev/tools/devtools
+43,Accessibility,Use Semantics widget,Screen reader support,Semantics for accessibility,Missing accessibility info,Semantics(label: 'Submit button'),GestureDetector without semantics,High,https://api.flutter.dev/flutter/widgets/Semantics-class.html
+44,Accessibility,Support large fonts,MediaQuery text scaling,MediaQuery.textScaleFactor,Fixed font sizes,style: Theme.of(context).textTheme,TextStyle(fontSize: 14),High,
+45,Accessibility,Test with screen readers,TalkBack and VoiceOver,Test accessibility regularly,Skip accessibility testing,Regular TalkBack testing,No screen reader testing,High,
+46,Testing,Use widget tests,Test widget behavior,WidgetTester for UI tests,Unit tests only,testWidgets('...' (tester) async {}),Only test() for UI,Medium,https://docs.flutter.dev/testing
+47,Testing,Use integration tests,Full app testing,integration_test package,Manual testing only,IntegrationTestWidgetsFlutterBinding,Manual E2E testing,Medium,
+48,Testing,Mock dependencies,Isolate tests,Mockito or mocktail,Real dependencies in tests,when(mock.method()).thenReturn(),Real API calls in tests,Medium,
+49,Platform,Use Platform checks,Platform-specific code,Platform.isIOS Platform.isAndroid,Same code for all platforms,if (Platform.isIOS) {},Hardcoded iOS behavior,Medium,
+50,Platform,Use kIsWeb for web,Web platform detection,kIsWeb for web checks,Platform for web,if (kIsWeb) {},Platform.isWeb (doesn't exist),Medium,
+51,Packages,Use pub.dev packages,Community packages,Popular maintained packages,Custom implementations,cached_network_image,Custom image cache,Medium,https://pub.dev/
+52,Packages,Check package quality,Quality before adding,Pub points and popularity,Any package without review,100+ pub points,Unmaintained packages,Medium,
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv b/.claude/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv
new file mode 100644
index 0000000..0efe300
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv
@@ -0,0 +1,56 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Animation,Use Tailwind animate utilities,Built-in animations are optimized and respect reduced-motion,Use animate-pulse animate-spin animate-ping,Custom @keyframes for simple effects,animate-pulse,@keyframes pulse {...},Medium,https://tailwindcss.com/docs/animation
+2,Animation,Limit bounce animations,Continuous bounce is distracting and causes motion sickness,Use animate-bounce sparingly on CTAs only,Multiple bounce animations on page,Single CTA with animate-bounce,5+ elements with animate-bounce,High,
+3,Animation,Transition duration,Use appropriate transition speeds for UI feedback,duration-150 to duration-300 for UI,duration-1000 or longer for UI elements,transition-all duration-200,transition-all duration-1000,Medium,https://tailwindcss.com/docs/transition-duration
+4,Animation,Hover transitions,Add smooth transitions on hover state changes,Add transition class with hover states,Instant hover changes without transition,hover:bg-gray-100 transition-colors,hover:bg-gray-100 (no transition),Low,
+5,Z-Index,Use Tailwind z-* scale,Consistent stacking context with predefined scale,z-0 z-10 z-20 z-30 z-40 z-50,Arbitrary z-index values,z-50 for modals,z-[9999],Medium,https://tailwindcss.com/docs/z-index
+6,Z-Index,Fixed elements z-index,Fixed navigation and modals need explicit z-index,z-50 for nav z-40 for dropdowns,Relying on DOM order for stacking,fixed top-0 z-50,fixed top-0 (no z-index),High,
+7,Z-Index,Negative z-index for backgrounds,Use negative z-index for decorative backgrounds,z-[-1] for background elements,Positive z-index for backgrounds,-z-10 for decorative,z-10 for background,Low,
+8,Layout,Container max-width,Limit content width for readability,max-w-7xl mx-auto for main content,Full-width content on large screens,max-w-7xl mx-auto px-4,w-full (no max-width),Medium,https://tailwindcss.com/docs/container
+9,Layout,Responsive padding,Adjust padding for different screen sizes,px-4 md:px-6 lg:px-8,Same padding all sizes,px-4 sm:px-6 lg:px-8,px-8 (same all sizes),Medium,
+10,Layout,Grid gaps,Use consistent gap utilities for spacing,gap-4 gap-6 gap-8,Margins on individual items,grid gap-6,grid with mb-4 on each item,Medium,https://tailwindcss.com/docs/gap
+11,Layout,Flexbox alignment,Use flex utilities for alignment,items-center justify-between,Multiple nested wrappers,flex items-center justify-between,Nested divs for alignment,Low,
+12,Images,Aspect ratio,Maintain consistent image aspect ratios,aspect-video aspect-square,No aspect ratio on containers,aspect-video rounded-lg,No aspect control,Medium,https://tailwindcss.com/docs/aspect-ratio
+13,Images,Object fit,Control image scaling within containers,object-cover object-contain,Stretched distorted images,object-cover w-full h-full,No object-fit,Medium,https://tailwindcss.com/docs/object-fit
+14,Images,Lazy loading,Defer loading of off-screen images,loading='lazy' on images,All images eager load,<img loading='lazy'>,<img> without lazy,High,
+15,Images,Responsive images,Serve appropriate image sizes,srcset and sizes attributes,Same large image all devices,srcset with multiple sizes,4000px image everywhere,High,
+16,Typography,Prose plugin,Use @tailwindcss/typography for rich text,prose prose-lg for article content,Custom styles for markdown,prose prose-lg max-w-none,Custom text styling,Medium,https://tailwindcss.com/docs/typography-plugin
+17,Typography,Line height,Use appropriate line height for readability,leading-relaxed for body text,Default tight line height,leading-relaxed (1.625),leading-none or leading-tight,Medium,https://tailwindcss.com/docs/line-height
+18,Typography,Font size scale,Use consistent text size scale,text-sm text-base text-lg text-xl,Arbitrary font sizes,text-lg,text-[17px],Low,https://tailwindcss.com/docs/font-size
+19,Typography,Text truncation,Handle long text gracefully,truncate or line-clamp-*,Overflow breaking layout,line-clamp-2,No overflow handling,Medium,https://tailwindcss.com/docs/text-overflow
+20,Colors,Opacity utilities,Use color opacity utilities,bg-black/50 text-white/80,Separate opacity class,bg-black/50,bg-black opacity-50,Low,https://tailwindcss.com/docs/background-color
+21,Colors,Dark mode,Support dark mode with dark: prefix,dark:bg-gray-900 dark:text-white,No dark mode support,dark:bg-gray-900,Only light theme,Medium,https://tailwindcss.com/docs/dark-mode
+22,Colors,Semantic colors,Use semantic color naming in config,primary secondary danger success,Generic color names in components,bg-primary,bg-blue-500 everywhere,Medium,
+23,Spacing,Consistent spacing scale,Use Tailwind spacing scale consistently,p-4 m-6 gap-8,Arbitrary pixel values,p-4 (1rem),p-[15px],Low,https://tailwindcss.com/docs/customizing-spacing
+24,Spacing,Negative margins,Use sparingly for overlapping effects,-mt-4 for overlapping elements,Negative margins for layout fixing,-mt-8 for card overlap,-m-2 to fix spacing issues,Medium,
+25,Spacing,Space between,Use space-y-* for vertical lists,space-y-4 on flex/grid column,Margin on each child,space-y-4,Each child has mb-4,Low,https://tailwindcss.com/docs/space
+26,Forms,Focus states,Always show focus indicators,focus:ring-2 focus:ring-blue-500,Remove focus outline,focus:ring-2 focus:ring-offset-2,focus:outline-none (no replacement),High,
+27,Forms,Input sizing,Consistent input dimensions,h-10 px-3 for inputs,Inconsistent input heights,h-10 w-full px-3,Various heights per input,Medium,
+28,Forms,Disabled states,Clear disabled styling,disabled:opacity-50 disabled:cursor-not-allowed,No disabled indication,disabled:opacity-50,Same style as enabled,Medium,
+29,Forms,Placeholder styling,Style placeholder text appropriately,placeholder:text-gray-400,Dark placeholder text,placeholder:text-gray-400,Default dark placeholder,Low,
+30,Responsive,Mobile-first approach,Start with mobile styles and add breakpoints,Default mobile + md: lg: xl:,Desktop-first approach,text-sm md:text-base,text-base max-md:text-sm,Medium,https://tailwindcss.com/docs/responsive-design
+31,Responsive,Breakpoint testing,Test at standard breakpoints,320 375 768 1024 1280 1536,Only test on development device,Test all breakpoints,Single device testing,High,
+32,Responsive,Hidden/shown utilities,Control visibility per breakpoint,hidden md:block,Different content per breakpoint,hidden md:flex,Separate mobile/desktop components,Low,https://tailwindcss.com/docs/display
+33,Buttons,Button sizing,Consistent button dimensions,px-4 py-2 or px-6 py-3,Inconsistent button sizes,px-4 py-2 text-sm,Various padding per button,Medium,
+34,Buttons,Touch targets,Minimum 44px touch target on mobile,min-h-[44px] on mobile,Small buttons on mobile,min-h-[44px] min-w-[44px],h-8 w-8 on mobile,High,
+35,Buttons,Loading states,Show loading feedback,disabled + spinner icon,Clickable during loading,<Button disabled><Spinner/></Button>,Button without loading state,High,
+36,Buttons,Icon buttons,Accessible icon-only buttons,aria-label on icon buttons,Icon button without label,<button aria-label='Close'><XIcon/></button>,<button><XIcon/></button>,High,
+37,Cards,Card structure,Consistent card styling,rounded-lg shadow-md p-6,Inconsistent card styles,rounded-2xl shadow-lg p-6,Mixed card styling,Low,
+38,Cards,Card hover states,Interactive cards should have hover feedback,hover:shadow-lg transition-shadow,No hover on clickable cards,hover:shadow-xl transition-shadow,Static cards that are clickable,Medium,
+39,Cards,Card spacing,Consistent internal card spacing,space-y-4 for card content,Inconsistent internal spacing,space-y-4 or p-6,Mixed mb-2 mb-4 mb-6,Low,
+40,Accessibility,Screen reader text,Provide context for screen readers,sr-only for hidden labels,Missing context for icons,<span class='sr-only'>Close menu</span>,No label for icon button,High,https://tailwindcss.com/docs/screen-readers
+41,Accessibility,Focus visible,Show focus only for keyboard users,focus-visible:ring-2,Focus on all interactions,focus-visible:ring-2,focus:ring-2 (shows on click too),Medium,
+42,Accessibility,Reduced motion,Respect user motion preferences,motion-reduce:animate-none,Ignore motion preferences,motion-reduce:transition-none,No reduced motion support,High,https://tailwindcss.com/docs/hover-focus-and-other-states#prefers-reduced-motion
+43,Performance,Configure content paths,Tailwind needs to know where classes are used,Use 'content' array in config,Use deprecated 'purge' option (v2),"content: ['./src/**/*.{js,ts,jsx,tsx}']",purge: [...],High,https://tailwindcss.com/docs/content-configuration
+44,Performance,JIT mode,Use JIT for faster builds and smaller bundles,JIT enabled (default in v3),Full CSS in development,Tailwind v3 defaults,Tailwind v2 without JIT,Medium,
+45,Performance,Avoid @apply bloat,Use @apply sparingly,Direct utilities in HTML,Heavy @apply usage,class='px-4 py-2 rounded',@apply px-4 py-2 rounded;,Low,https://tailwindcss.com/docs/reusing-styles
+46,Plugins,Official plugins,Use official Tailwind plugins,@tailwindcss/forms typography aspect-ratio,Custom implementations,@tailwindcss/forms,Custom form reset CSS,Medium,https://tailwindcss.com/docs/plugins
+47,Plugins,Custom utilities,Create utilities for repeated patterns,Custom utility in config,Repeated arbitrary values,Custom shadow utility,"shadow-[0_4px_20px_rgba(0,0,0,0.1)] everywhere",Medium,
+48,Layout,Container Queries,Use @container for component-based responsiveness,Use @container and @lg: etc.,Media queries for component internals,@container @lg:grid-cols-2,@media (min-width: ...) inside component,Medium,https://github.com/tailwindlabs/tailwindcss-container-queries
+49,Interactivity,Group and Peer,Style based on parent/sibling state,group-hover peer-checked,JS for simple state interactions,group-hover:text-blue-500,onMouseEnter={() => setHover(true)},Low,https://tailwindcss.com/docs/hover-focus-and-other-states#styling-based-on-parent-state
+50,Customization,Arbitrary Values,Use [] for one-off values,w-[350px] for specific needs,Creating config for single use,top-[117px] (if strictly needed),style={{ top: '117px' }},Low,https://tailwindcss.com/docs/adding-custom-styles#using-arbitrary-values
+51,Colors,Theme color variables,Define colors in Tailwind theme and use directly,bg-primary text-success border-cta,bg-[var(--color-primary)] text-[var(--color-success)],bg-primary,bg-[var(--color-primary)],Medium,https://tailwindcss.com/docs/customizing-colors
+52,Colors,Use bg-linear-to-* for gradients,Tailwind v4 uses bg-linear-to-* syntax for gradients,bg-linear-to-r bg-linear-to-b,bg-gradient-to-* (deprecated in v4),bg-linear-to-r from-blue-500 to-purple-500,bg-gradient-to-r from-blue-500 to-purple-500,Medium,https://tailwindcss.com/docs/background-image
+53,Layout,Use shrink-0 shorthand,Shorter class name for flex-shrink-0,shrink-0 shrink,flex-shrink-0 flex-shrink,shrink-0,flex-shrink-0,Low,https://tailwindcss.com/docs/flex-shrink
+54,Layout,Use size-* for square dimensions,Single utility for equal width and height,size-4 size-8 size-12,Separate h-* w-* for squares,size-6,h-6 w-6,Low,https://tailwindcss.com/docs/size
+55,Images,SVG explicit dimensions,Add width/height attributes to SVGs to prevent layout shift before CSS loads,<svg class='size-6' width='24' height='24'>,SVG without explicit dimensions,<svg class='size-6' width='24' height='24'>,<svg class='size-6'>,High,
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/nextjs.csv b/.claude/skills/ui-ux-pro-max/data/stacks/nextjs.csv
new file mode 100644
index 0000000..6e9bea5
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/nextjs.csv
@@ -0,0 +1,53 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Routing,Use App Router for new projects,App Router is the recommended approach in Next.js 14+,app/ directory with page.tsx,pages/ for new projects,app/dashboard/page.tsx,pages/dashboard.tsx,Medium,https://nextjs.org/docs/app
+2,Routing,Use file-based routing,Create routes by adding files in app directory,page.tsx for routes layout.tsx for layouts,Manual route configuration,app/blog/[slug]/page.tsx,Custom router setup,Medium,https://nextjs.org/docs/app/building-your-application/routing
+3,Routing,Colocate related files,Keep components styles tests with their routes,Component files alongside page.tsx,Separate components folder,app/dashboard/_components/,components/dashboard/,Low,
+4,Routing,Use route groups for organization,Group routes without affecting URL,Parentheses for route groups,Nested folders affecting URL,(marketing)/about/page.tsx,marketing/about/page.tsx,Low,https://nextjs.org/docs/app/building-your-application/routing/route-groups
+5,Routing,Handle loading states,Use loading.tsx for route loading UI,loading.tsx alongside page.tsx,Manual loading state management,app/dashboard/loading.tsx,useState for loading in page,Medium,https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming
+6,Routing,Handle errors with error.tsx,Catch errors at route level,error.tsx with reset function,try/catch in every component,app/dashboard/error.tsx,try/catch in page component,High,https://nextjs.org/docs/app/building-your-application/routing/error-handling
+7,Rendering,Use Server Components by default,Server Components reduce client JS bundle,Keep components server by default,Add 'use client' unnecessarily,export default function Page(),('use client') for static content,High,https://nextjs.org/docs/app/building-your-application/rendering/server-components
+8,Rendering,Mark Client Components explicitly,'use client' for interactive components,Add 'use client' only when needed,Server Component with hooks/events,('use client') for onClick useState,No directive with useState,High,https://nextjs.org/docs/app/building-your-application/rendering/client-components
+9,Rendering,Push Client Components down,Keep Client Components as leaf nodes,Client wrapper for interactive parts only,Mark page as Client Component,<InteractiveButton/> in Server Page,('use client') on page.tsx,High,
+10,Rendering,Use streaming for better UX,Stream content with Suspense boundaries,Suspense for slow data fetches,Wait for all data before render,<Suspense><SlowComponent/></Suspense>,await allData then render,Medium,https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming
+11,Rendering,Choose correct rendering strategy,SSG for static SSR for dynamic ISR for semi-static,generateStaticParams for known paths,SSR for static content,export const revalidate = 3600,fetch without cache config,Medium,
+12,DataFetching,Fetch data in Server Components,Fetch directly in async Server Components,async function Page() { const data = await fetch() },useEffect for initial data,const data = await fetch(url),useEffect(() => fetch(url)),High,https://nextjs.org/docs/app/building-your-application/data-fetching
+13,DataFetching,Configure caching explicitly (Next.js 15+),Next.js 15 changed defaults to uncached for fetch,Explicitly set cache: 'force-cache' for static data,Assume default is cached (it's not in Next.js 15),fetch(url { cache: 'force-cache' }),fetch(url) // Uncached in v15,High,https://nextjs.org/docs/app/building-your-application/upgrading/version-15
+14,DataFetching,Deduplicate fetch requests,React and Next.js dedupe same requests,Same fetch call in multiple components,Manual request deduplication,Multiple components fetch same URL,Custom cache layer,Low,
+15,DataFetching,Use Server Actions for mutations,Server Actions for form submissions,action={serverAction} in forms,API route for every mutation,<form action={createPost}>,<form onSubmit={callApiRoute}>,Medium,https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations
+16,DataFetching,Revalidate data appropriately,Use revalidatePath/revalidateTag after mutations,Revalidate after Server Action,'use client' with manual refetch,revalidatePath('/posts'),router.refresh() everywhere,Medium,https://nextjs.org/docs/app/building-your-application/caching#revalidating
+17,Images,Use next/image for optimization,Automatic image optimization and lazy loading,<Image> component for all images,<img> tags directly,<Image src={} alt={} width={} height={}>,<img src={}/>,High,https://nextjs.org/docs/app/building-your-application/optimizing/images
+18,Images,Provide width and height,Prevent layout shift with dimensions,width and height props or fill,Missing dimensions,<Image width={400} height={300}/>,<Image src={url}/>,High,
+19,Images,Use fill for responsive images,Fill container with object-fit,fill prop with relative parent,Fixed dimensions for responsive,"<Image fill className=""object-cover""/>",<Image width={window.width}/>,Medium,
+20,Images,Configure remote image domains,Whitelist external image sources,remotePatterns in next.config.js,Allow all domains,remotePatterns: [{ hostname: 'cdn.example.com' }],domains: ['*'],High,https://nextjs.org/docs/app/api-reference/components/image#remotepatterns
+21,Images,Use priority for LCP images,Mark above-fold images as priority,priority prop on hero images,All images with priority,<Image priority src={hero}/>,<Image priority/> on every image,Medium,
+22,Fonts,Use next/font for fonts,Self-hosted fonts with zero layout shift,next/font/google or next/font/local,External font links,import { Inter } from 'next/font/google',"<link href=""fonts.googleapis.com""/>",Medium,https://nextjs.org/docs/app/building-your-application/optimizing/fonts
+23,Fonts,Apply font to layout,Set font in root layout for consistency,className on body in layout.tsx,Font in individual pages,<body className={inter.className}>,Each page imports font,Low,
+24,Fonts,Use variable fonts,Variable fonts reduce bundle size,Single variable font file,Multiple font weights as files,Inter({ subsets: ['latin'] }),Inter_400 Inter_500 Inter_700,Low,
+25,Metadata,Use generateMetadata for dynamic,Generate metadata based on params,export async function generateMetadata(),Hardcoded metadata everywhere,generateMetadata({ params }),export const metadata = {},Medium,https://nextjs.org/docs/app/building-your-application/optimizing/metadata
+26,Metadata,Include OpenGraph images,Add OG images for social sharing,opengraph-image.tsx or og property,Missing social preview images,opengraph: { images: ['/og.png'] },No OG configuration,Medium,
+27,Metadata,Use metadata API,Export metadata object for static metadata,export const metadata = {},Manual head tags,export const metadata = { title: 'Page' },<head><title>Page</title></head>,Medium,
+28,API,Use Route Handlers for APIs,app/api routes for API endpoints,app/api/users/route.ts,pages/api for new projects,export async function GET(request),export default function handler,Medium,https://nextjs.org/docs/app/building-your-application/routing/route-handlers
+29,API,Return proper Response objects,Use NextResponse for API responses,NextResponse.json() for JSON,Plain objects or res.json(),return NextResponse.json({ data }),return { data },Medium,
+30,API,Handle HTTP methods explicitly,Export named functions for methods,Export GET POST PUT DELETE,Single handler for all methods,export async function POST(),switch(req.method),Low,
+31,API,Validate request body,Validate input before processing,Zod or similar for validation,Trust client input,const body = schema.parse(await req.json()),const body = await req.json(),High,
+32,Middleware,Use middleware for auth,Protect routes with middleware.ts,middleware.ts at root,Auth check in every page,export function middleware(request),if (!session) redirect in page,Medium,https://nextjs.org/docs/app/building-your-application/routing/middleware
+33,Middleware,Match specific paths,Configure middleware matcher,config.matcher for specific routes,Run middleware on all routes,matcher: ['/dashboard/:path*'],No matcher config,Medium,
+34,Middleware,Keep middleware edge-compatible,Middleware runs on Edge runtime,Edge-compatible code only,Node.js APIs in middleware,Edge-compatible auth check,fs.readFile in middleware,High,
+35,Environment,Use NEXT_PUBLIC prefix,Client-accessible env vars need prefix,NEXT_PUBLIC_ for client vars,Server vars exposed to client,NEXT_PUBLIC_API_URL,API_SECRET in client code,High,https://nextjs.org/docs/app/building-your-application/configuring/environment-variables
+36,Environment,Validate env vars,Check required env vars exist,Validate on startup,Undefined env at runtime,if (!process.env.DATABASE_URL) throw,process.env.DATABASE_URL (might be undefined),High,
+37,Environment,Use .env.local for secrets,Local env file for development secrets,.env.local gitignored,Secrets in .env committed,.env.local with secrets,.env with DATABASE_PASSWORD,High,
+38,Performance,Analyze bundle size,Use @next/bundle-analyzer,Bundle analyzer in dev,Ship large bundles blindly,ANALYZE=true npm run build,No bundle analysis,Medium,https://nextjs.org/docs/app/building-your-application/optimizing/bundle-analyzer
+39,Performance,Use dynamic imports,Code split with next/dynamic,dynamic() for heavy components,Import everything statically,const Chart = dynamic(() => import('./Chart')),import Chart from './Chart',Medium,https://nextjs.org/docs/app/building-your-application/optimizing/lazy-loading
+40,Performance,Avoid layout shifts,Reserve space for dynamic content,Skeleton loaders aspect ratios,Content popping in,"<Skeleton className=""h-48""/>",No placeholder for async content,High,
+41,Performance,Use Partial Prerendering,Combine static and dynamic in one route,Static shell with Suspense holes,Full dynamic or static pages,Static header + dynamic content,Entire page SSR,Low,https://nextjs.org/docs/app/building-your-application/rendering/partial-prerendering
+42,Link,Use next/link for navigation,Client-side navigation with prefetching,"<Link href=""""> for internal links",<a> for internal navigation,"<Link href=""/about"">About</Link>","<a href=""/about"">About</a>",High,https://nextjs.org/docs/app/api-reference/components/link
+43,Link,Prefetch strategically,Control prefetching behavior,prefetch={false} for low-priority,Prefetch all links,<Link prefetch={false}>,Default prefetch on every link,Low,
+44,Link,Use scroll option appropriately,Control scroll behavior on navigation,scroll={false} for tabs pagination,Always scroll to top,<Link scroll={false}>,Manual scroll management,Low,
+45,Config,Use next.config.js correctly,Configure Next.js behavior,Proper config options,Deprecated or wrong options,images: { remotePatterns: [] },images: { domains: [] },Medium,https://nextjs.org/docs/app/api-reference/next-config-js
+46,Config,Enable strict mode,Catch potential issues early,reactStrictMode: true,Strict mode disabled,reactStrictMode: true,reactStrictMode: false,Medium,
+47,Config,Configure redirects and rewrites,Use config for URL management,redirects() rewrites() in config,Manual redirect handling,redirects: async () => [...],res.redirect in pages,Medium,https://nextjs.org/docs/app/api-reference/next-config-js/redirects
+48,Deployment,Use Vercel for easiest deploy,Vercel optimized for Next.js,Deploy to Vercel,Self-host without knowledge,vercel deploy,Complex Docker setup for simple app,Low,https://nextjs.org/docs/app/building-your-application/deploying
+49,Deployment,Configure output for self-hosting,Set output option for deployment target,output: 'standalone' for Docker,Default output for containers,output: 'standalone',No output config for Docker,Medium,https://nextjs.org/docs/app/building-your-application/deploying#self-hosting
+50,Security,Sanitize user input,Never trust user input,Escape sanitize validate all input,Direct interpolation of user data,DOMPurify.sanitize(userInput),dangerouslySetInnerHTML={{ __html: userInput }},High,
+51,Security,Use CSP headers,Content Security Policy for XSS protection,Configure CSP in next.config.js,No security headers,headers() with CSP,No CSP configuration,High,https://nextjs.org/docs/app/building-your-application/configuring/content-security-policy
+52,Security,Validate Server Action input,Server Actions are public endpoints,Validate and authorize in Server Action,Trust Server Action input,Auth check + validation in action,Direct database call without check,High,
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv b/.claude/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv
new file mode 100644
index 0000000..7146e84
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv
@@ -0,0 +1,51 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Installation,Add Nuxt UI module,Install and configure Nuxt UI in your Nuxt project,pnpm add @nuxt/ui and add to modules,Manual component imports,"modules: ['@nuxt/ui']","import { UButton } from '@nuxt/ui'",High,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+2,Installation,Import Tailwind and Nuxt UI CSS,Required CSS imports in main.css file,@import tailwindcss and @import @nuxt/ui,Skip CSS imports,"@import ""tailwindcss""; @import ""@nuxt/ui"";",No CSS imports,High,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+3,Installation,Wrap app with UApp component,UApp provides global configs for Toast Tooltip and overlays,<UApp> wrapper in app.vue,Skip UApp wrapper,<UApp><NuxtPage/></UApp>,<NuxtPage/> without wrapper,High,https://ui.nuxt.com/docs/components/app
+4,Components,Use U prefix for components,All Nuxt UI components use U prefix by default,UButton UInput UModal,Button Input Modal,<UButton>Click</UButton>,<Button>Click</Button>,Medium,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+5,Components,Use semantic color props,Use semantic colors like primary secondary error,color="primary" color="error",Hardcoded colors,"<UButton color=""primary"">","<UButton class=""bg-green-500"">",Medium,https://ui.nuxt.com/docs/getting-started/theme/design-system
+6,Components,Use variant prop for styling,Nuxt UI provides solid outline soft subtle ghost link variants,variant="soft" variant="outline",Custom button classes,"<UButton variant=""soft"">","<UButton class=""border bg-transparent"">",Medium,https://ui.nuxt.com/docs/components/button
+7,Components,Use size prop consistently,Components support xs sm md lg xl sizes,size="sm" size="lg",Arbitrary sizing classes,"<UButton size=""lg"">","<UButton class=""text-xl px-6"">",Low,https://ui.nuxt.com/docs/components/button
+8,Icons,Use icon prop with Iconify format,Nuxt UI supports Iconify icons via icon prop,icon="lucide:home" icon="heroicons:user",i-lucide-home format,"<UButton icon=""lucide:home"">","<UButton icon=""i-lucide-home"">",Medium,https://ui.nuxt.com/docs/getting-started/integrations/icons/nuxt
+9,Icons,Use leadingIcon and trailingIcon,Position icons with dedicated props for clarity,leadingIcon="lucide:plus" trailingIcon="lucide:arrow-right",Manual icon positioning,"<UButton leadingIcon=""lucide:plus"">","<UButton><Icon name=""lucide:plus""/>Add</UButton>",Low,https://ui.nuxt.com/docs/components/button
+10,Theming,Configure colors in app.config.ts,Runtime color configuration without restart,ui.colors.primary in app.config.ts,Hardcoded colors in components,"defineAppConfig({ ui: { colors: { primary: 'blue' } } })","<UButton class=""bg-blue-500"">",High,https://ui.nuxt.com/docs/getting-started/theme/design-system
+11,Theming,Use @theme directive for custom colors,Define design tokens in CSS with Tailwind @theme,@theme { --color-brand-500: #xxx },Inline color definitions,@theme { --color-brand-500: #ef4444; },:style="{ color: '#ef4444' }",Medium,https://ui.nuxt.com/docs/getting-started/theme/design-system
+12,Theming,Extend semantic colors in nuxt.config,Register new colors like tertiary in theme.colors,theme.colors array in ui config,Use undefined colors,"ui: { theme: { colors: ['primary', 'tertiary'] } }","<UButton color=""tertiary""> without config",Medium,https://ui.nuxt.com/docs/getting-started/theme/design-system
+13,Forms,Use UForm with schema validation,UForm supports Zod Yup Joi Valibot schemas,:schema prop with validation schema,Manual form validation,"<UForm :schema=""schema"" :state=""state"">",Manual @blur validation,High,https://ui.nuxt.com/docs/components/form
+14,Forms,Use UFormField for field wrapper,Provides label error message and validation display,UFormField with name prop,Manual error handling,"<UFormField name=""email"" label=""Email"">",<div><label>Email</label><UInput/><span>error</span></div>,Medium,https://ui.nuxt.com/docs/components/form-field
+15,Forms,Handle form submit with @submit,UForm emits submit event with validated data,@submit handler on UForm,@click on submit button,"<UForm @submit=""onSubmit"">","<UButton @click=""onSubmit"">",Medium,https://ui.nuxt.com/docs/components/form
+16,Forms,Use validateOn prop for validation timing,Control when validation triggers (blur change input),validateOn="['blur']" for performance,Always validate on input,"<UForm :validateOn=""['blur', 'change']"">","<UForm> (validates on every keystroke)",Low,https://ui.nuxt.com/docs/components/form
+17,Overlays,Use v-model:open for overlay control,Modal Slideover Drawer use v-model:open,v-model:open for controlled state,Manual show/hide logic,"<UModal v-model:open=""isOpen"">",<UModal v-if="isOpen">,Medium,https://ui.nuxt.com/docs/components/modal
+18,Overlays,Use useOverlay composable for programmatic overlays,Open overlays programmatically without template refs,useOverlay().open(MyModal),Template ref and manual control,"const overlay = useOverlay(); overlay.open(MyModal, { props })","const modal = ref(); modal.value.open()",Medium,https://ui.nuxt.com/docs/components/modal
+19,Overlays,Use title and description props,Built-in header support for overlays,title="Confirm" description="Are you sure?",Manual header content,"<UModal title=""Confirm"" description=""Are you sure?"">","<UModal><template #header><h2>Confirm</h2></template>",Low,https://ui.nuxt.com/docs/components/modal
+20,Dashboard,Use UDashboardSidebar for navigation,Provides collapsible resizable sidebar with mobile support,UDashboardSidebar with header default footer slots,Custom sidebar implementation,<UDashboardSidebar><template #header>...</template></UDashboardSidebar>,<aside class="w-64 border-r">,Medium,https://ui.nuxt.com/docs/components/dashboard-sidebar
+21,Dashboard,Use UDashboardGroup for layout,Wraps dashboard components with sidebar state management,UDashboardGroup > UDashboardSidebar + UDashboardPanel,Manual layout flex containers,<UDashboardGroup><UDashboardSidebar/><UDashboardPanel/></UDashboardGroup>,"<div class=""flex""><aside/><main/></div>",Medium,https://ui.nuxt.com/docs/components/dashboard-group
+22,Dashboard,Use UDashboardNavbar for top navigation,Responsive navbar with mobile menu support,UDashboardNavbar in dashboard layout,Custom navbar implementation,<UDashboardNavbar :links="navLinks"/>,<nav class="border-b">,Low,https://ui.nuxt.com/docs/components/dashboard-navbar
+23,Tables,Use UTable with data and columns props,Powered by TanStack Table with built-in features,:data and :columns props,Manual table markup,"<UTable :data=""users"" :columns=""columns""/>","<table><tr v-for=""user in users"">",High,https://ui.nuxt.com/docs/components/table
+24,Tables,Define columns with accessorKey,Column definitions use accessorKey for data binding,accessorKey: 'email' in column def,String column names only,"{ accessorKey: 'email', header: 'Email' }","['name', 'email']",Medium,https://ui.nuxt.com/docs/components/table
+25,Tables,Use cell slot for custom rendering,Customize cell content with scoped slots,#cell-columnName slot,Override entire table,<template #cell-status="{ row }">,Manual column render function,Medium,https://ui.nuxt.com/docs/components/table
+26,Tables,Enable sorting with sortable column option,Add sortable: true to column definition,sortable: true in column,Manual sort implementation,"{ accessorKey: 'name', sortable: true }",@click="sortBy('name')",Low,https://ui.nuxt.com/docs/components/table
+27,Navigation,Use UNavigationMenu for nav links,Horizontal or vertical navigation with dropdown support,UNavigationMenu with items array,Manual nav with v-for,"<UNavigationMenu :items=""navItems""/>","<nav><a v-for=""item in items"">",Medium,https://ui.nuxt.com/docs/components/navigation-menu
+28,Navigation,Use UBreadcrumb for page hierarchy,Automatic breadcrumb with NuxtLink support,:items array with label and to,Manual breadcrumb links,"<UBreadcrumb :items=""breadcrumbs""/>","<nav><span v-for=""crumb in crumbs"">",Low,https://ui.nuxt.com/docs/components/breadcrumb
+29,Navigation,Use UTabs for tabbed content,Tab navigation with content panels,UTabs with items containing slot content,Manual tab state,"<UTabs :items=""tabs""/>","<div><button @click=""tab=1"">",Medium,https://ui.nuxt.com/docs/components/tabs
+30,Feedback,Use useToast for notifications,Composable for toast notifications,useToast().add({ title description }),Alert components for toasts,"const toast = useToast(); toast.add({ title: 'Saved' })",<UAlert v-if="showSuccess">,High,https://ui.nuxt.com/docs/components/toast
+31,Feedback,Use UAlert for inline messages,Static alert messages with icon and actions,UAlert with title description color,Toast for static messages,"<UAlert title=""Warning"" color=""warning""/>",useToast for inline alerts,Medium,https://ui.nuxt.com/docs/components/alert
+32,Feedback,Use USkeleton for loading states,Placeholder content during data loading,USkeleton with appropriate size,Spinner for content loading,<USkeleton class="h-4 w-32"/>,<UIcon name="lucide:loader" class="animate-spin"/>,Low,https://ui.nuxt.com/docs/components/skeleton
+33,Color Mode,Use UColorModeButton for theme toggle,Built-in light/dark mode toggle button,UColorModeButton component,Manual color mode logic,<UColorModeButton/>,"<button @click=""toggleColorMode"">",Low,https://ui.nuxt.com/docs/components/color-mode-button
+34,Color Mode,Use UColorModeSelect for theme picker,Dropdown to select system light or dark mode,UColorModeSelect component,Custom select for theme,<UColorModeSelect/>,"<USelect v-model=""colorMode"" :items=""modes""/>",Low,https://ui.nuxt.com/docs/components/color-mode-select
+35,Customization,Use ui prop for component styling,Override component styles via ui prop,ui prop with slot class overrides,Global CSS overrides,"<UButton :ui=""{ base: 'rounded-full' }""/>",<UButton class="!rounded-full"/>,Medium,https://ui.nuxt.com/docs/getting-started/theme/components
+36,Customization,Configure default variants in nuxt.config,Set default color and size for all components,theme.defaultVariants in ui config,Repeat props on every component,"ui: { theme: { defaultVariants: { color: 'neutral' } } }","<UButton color=""neutral""> everywhere",Medium,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+37,Customization,Use app.config.ts for theme overrides,Runtime theme customization,defineAppConfig with ui key,nuxt.config for runtime values,"defineAppConfig({ ui: { button: { defaultVariants: { size: 'sm' } } } })","nuxt.config ui.button.size: 'sm'",Medium,https://ui.nuxt.com/docs/getting-started/theme/components
+38,Performance,Enable component detection,Tree-shake unused component CSS,experimental.componentDetection: true,Include all component CSS,"ui: { experimental: { componentDetection: true } }","ui: {} (includes all CSS)",Low,https://ui.nuxt.com/docs/getting-started/installation/nuxt
+39,Performance,Use UTable virtualize for large data,Enable virtualization for 1000+ rows,:virtualize prop on UTable,Render all rows,"<UTable :data=""largeData"" virtualize/>","<UTable :data=""largeData""/>",Medium,https://ui.nuxt.com/docs/components/table
+40,Accessibility,Use semantic component props,Components have built-in ARIA support,Use title description label props,Skip accessibility props,"<UModal title=""Settings"">","<UModal><h2>Settings</h2>",Medium,https://ui.nuxt.com/docs/components/modal
+41,Accessibility,Use UFormField for form accessibility,Automatic label-input association,UFormField wraps inputs,Manual id and for attributes,"<UFormField label=""Email""><UInput/></UFormField>","<label for=""email"">Email</label><UInput id=""email""/>",High,https://ui.nuxt.com/docs/components/form-field
+42,Content,Use UContentToc for table of contents,Automatic TOC with active heading highlight,UContentToc with :links,Manual TOC implementation,"<UContentToc :links=""toc""/>","<nav><a v-for=""heading in headings"">",Low,https://ui.nuxt.com/docs/components/content-toc
+43,Content,Use UContentSearch for docs search,Command palette for documentation search,UContentSearch with Nuxt Content,Custom search implementation,<UContentSearch/>,<UCommandPalette :groups="searchResults"/>,Low,https://ui.nuxt.com/docs/components/content-search
+44,AI/Chat,Use UChatMessages for chat UI,Designed for Vercel AI SDK integration,UChatMessages with messages array,Custom chat message list,"<UChatMessages :messages=""messages""/>","<div v-for=""msg in messages"">",Medium,https://ui.nuxt.com/docs/components/chat-messages
+45,AI/Chat,Use UChatPrompt for input,Enhanced textarea for AI prompts,UChatPrompt with v-model,Basic textarea,<UChatPrompt v-model="prompt"/>,<UTextarea v-model="prompt"/>,Medium,https://ui.nuxt.com/docs/components/chat-prompt
+46,Editor,Use UEditor for rich text,TipTap-based editor with toolbar support,UEditor with v-model:content,Custom TipTap setup,"<UEditor v-model:content=""content""/>",Manual TipTap initialization,Medium,https://ui.nuxt.com/docs/components/editor
+47,Links,Use to prop for navigation,UButton and ULink support NuxtLink to prop,to="/dashboard" for internal links,href for internal navigation,"<UButton to=""/dashboard"">","<UButton href=""/dashboard"">",Medium,https://ui.nuxt.com/docs/components/button
+48,Links,Use external prop for outside links,Explicitly mark external links,target="_blank" with external URLs,Forget rel="noopener","<UButton to=""https://example.com"" target=""_blank"">","<UButton href=""https://..."">",Low,https://ui.nuxt.com/docs/components/link
+49,Loading,Use loadingAuto on buttons,Automatic loading state from @click promise,loadingAuto prop on UButton,Manual loading state,"<UButton loadingAuto @click=""async () => await save()"">","<UButton :loading=""isLoading"" @click=""save"">",Low,https://ui.nuxt.com/docs/components/button
+50,Loading,Use UForm loadingAuto,Auto-disable form during submit,loadingAuto on UForm (default true),Manual form disabled state,"<UForm @submit=""handleSubmit"">","<UForm :disabled=""isSubmitting"">",Low,https://ui.nuxt.com/docs/components/form
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv b/.claude/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv
new file mode 100644
index 0000000..c275d0d
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv
@@ -0,0 +1,59 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Routing,Use file-based routing,Create routes by adding files in pages directory,pages/ directory with index.vue,Manual route configuration,pages/dashboard/index.vue,Custom router setup,Medium,https://nuxt.com/docs/getting-started/routing
+2,Routing,Use dynamic route parameters,Create dynamic routes with bracket syntax,[id].vue for dynamic params,Hardcoded routes for dynamic content,pages/posts/[id].vue,pages/posts/post1.vue,Medium,https://nuxt.com/docs/getting-started/routing
+3,Routing,Use catch-all routes,Handle multiple path segments with [...slug],[...slug].vue for catch-all,Multiple nested dynamic routes,pages/[...slug].vue,pages/[a]/[b]/[c].vue,Low,https://nuxt.com/docs/getting-started/routing
+4,Routing,Define page metadata with definePageMeta,Set page-level configuration and middleware,definePageMeta for layout middleware title,Manual route meta configuration,"definePageMeta({ layout: 'admin', middleware: 'auth' })",router.beforeEach for page config,High,https://nuxt.com/docs/api/utils/define-page-meta
+5,Routing,Use validate for route params,Validate dynamic route parameters before rendering,validate function in definePageMeta,Manual validation in setup,"definePageMeta({ validate: (route) => /^\d+$/.test(route.params.id) })",if (!valid) navigateTo('/404'),Medium,https://nuxt.com/docs/api/utils/define-page-meta
+6,Rendering,Use SSR by default,Server-side rendering is enabled by default,Keep ssr: true (default),Disable SSR unnecessarily,ssr: true (default),ssr: false for all pages,High,https://nuxt.com/docs/guide/concepts/rendering
+7,Rendering,Use .client suffix for client-only components,Mark components to render only on client,ComponentName.client.vue suffix,v-if with process.client check,Comments.client.vue,<div v-if="process.client"><Comments/></div>,Medium,https://nuxt.com/docs/guide/directory-structure/components
+8,Rendering,Use .server suffix for server-only components,Mark components to render only on server,ComponentName.server.vue suffix,Manual server check,HeavyMarkdown.server.vue,v-if="process.server",Low,https://nuxt.com/docs/guide/directory-structure/components
+9,DataFetching,Use useFetch for simple data fetching,Wrapper around useAsyncData for URL fetching,useFetch for API calls,$fetch in onMounted,"const { data } = await useFetch('/api/posts')","onMounted(async () => { data.value = await $fetch('/api/posts') })",High,https://nuxt.com/docs/api/composables/use-fetch
+10,DataFetching,Use useAsyncData for complex fetching,Fine-grained control over async data,useAsyncData for CMS or custom fetching,useFetch for non-URL data sources,"const { data } = await useAsyncData('posts', () => cms.getPosts())","const { data } = await useFetch(() => cms.getPosts())",Medium,https://nuxt.com/docs/api/composables/use-async-data
+11,DataFetching,Use $fetch for non-reactive requests,$fetch for event handlers and non-component code,$fetch in event handlers or server routes,useFetch in click handlers,"async function submit() { await $fetch('/api/submit', { method: 'POST' }) }","async function submit() { await useFetch('/api/submit') }",High,https://nuxt.com/docs/api/utils/dollarfetch
+12,DataFetching,Use lazy option for non-blocking fetch,Defer data fetching for better initial load,lazy: true for below-fold content,Blocking fetch for non-critical data,"useFetch('/api/comments', { lazy: true })",await useFetch('/api/comments') for footer,Medium,https://nuxt.com/docs/api/composables/use-fetch
+13,DataFetching,Use server option to control fetch location,Choose where data is fetched,server: false for client-only data,Server fetch for user-specific client data,"useFetch('/api/user-preferences', { server: false })",useFetch for localStorage-dependent data,Medium,https://nuxt.com/docs/api/composables/use-fetch
+14,DataFetching,Use pick to reduce payload size,Select only needed fields from response,pick option for large responses,Fetching entire objects when few fields needed,"useFetch('/api/user', { pick: ['id', 'name'] })",useFetch('/api/user') then destructure,Low,https://nuxt.com/docs/api/composables/use-fetch
+15,DataFetching,Use transform for data manipulation,Transform data before storing in state,transform option for data shaping,Manual transformation after fetch,"useFetch('/api/posts', { transform: (posts) => posts.map(p => p.title) })",const titles = data.value.map(p => p.title),Low,https://nuxt.com/docs/api/composables/use-fetch
+16,DataFetching,Handle loading and error states,Always handle pending and error states,Check status pending error refs,Ignoring loading states,"<div v-if=""status === 'pending'"">Loading...</div>",No loading indicator,High,https://nuxt.com/docs/getting-started/data-fetching
+17,Lifecycle,Avoid side effects in script setup root,Move side effects to lifecycle hooks,Side effects in onMounted,setInterval in root script setup,"onMounted(() => { interval = setInterval(...) })","<script setup>setInterval(...)</script>",High,https://nuxt.com/docs/guide/concepts/nuxt-lifecycle
+18,Lifecycle,Use onMounted for DOM access,Access DOM only after component is mounted,onMounted for DOM manipulation,Direct DOM access in setup,"onMounted(() => { document.getElementById('el') })","<script setup>document.getElementById('el')</script>",High,https://nuxt.com/docs/api/composables/on-mounted
+19,Lifecycle,Use nextTick for post-render access,Wait for DOM updates before accessing elements,await nextTick() after state changes,Immediate DOM access after state change,"count.value++; await nextTick(); el.value.focus()","count.value++; el.value.focus()",Medium,https://nuxt.com/docs/api/utils/next-tick
+20,Lifecycle,Use onPrehydrate for pre-hydration logic,Run code before Nuxt hydrates the page,onPrehydrate for client setup,onMounted for hydration-critical code,"onPrehydrate(() => { console.log(window) })",onMounted for pre-hydration needs,Low,https://nuxt.com/docs/api/composables/on-prehydrate
+21,Server,Use server/api for API routes,Create API endpoints in server/api directory,server/api/users.ts for /api/users,Manual Express setup,server/api/hello.ts -> /api/hello,app.get('/api/hello'),High,https://nuxt.com/docs/guide/directory-structure/server
+22,Server,Use defineEventHandler for handlers,Define server route handlers,defineEventHandler for all handlers,export default function,"export default defineEventHandler((event) => { return { hello: 'world' } })","export default function(req, res) {}",High,https://nuxt.com/docs/guide/directory-structure/server
+23,Server,Use server/routes for non-api routes,Routes without /api prefix,server/routes for custom paths,server/api for non-api routes,server/routes/sitemap.xml.ts,server/api/sitemap.xml.ts,Medium,https://nuxt.com/docs/guide/directory-structure/server
+24,Server,Use getQuery and readBody for input,Access query params and request body,getQuery(event) readBody(event),Direct event access,"const { id } = getQuery(event)",event.node.req.query,Medium,https://nuxt.com/docs/guide/directory-structure/server
+25,Server,Validate server input,Always validate input in server handlers,Zod or similar for validation,Trust client input,"const body = await readBody(event); schema.parse(body)",const body = await readBody(event),High,https://nuxt.com/docs/guide/directory-structure/server
+26,State,Use useState for shared reactive state,SSR-friendly shared state across components,useState for cross-component state,ref for shared state,"const count = useState('count', () => 0)",const count = ref(0) in composable,High,https://nuxt.com/docs/api/composables/use-state
+27,State,Use unique keys for useState,Prevent state conflicts with unique keys,Descriptive unique keys for each state,Generic or duplicate keys,"useState('user-preferences', () => ({}))",useState('data') in multiple places,Medium,https://nuxt.com/docs/api/composables/use-state
+28,State,Use Pinia for complex state,Pinia for advanced state management,@pinia/nuxt for complex apps,Custom state management,useMainStore() with Pinia,Custom reactive store implementation,Medium,https://nuxt.com/docs/getting-started/state-management
+29,State,Use callOnce for one-time async operations,Ensure async operations run only once,callOnce for store initialization,Direct await in component,"await callOnce(store.fetch)",await store.fetch() on every render,Medium,https://nuxt.com/docs/api/utils/call-once
+30,SEO,Use useSeoMeta for SEO tags,Type-safe SEO meta tag management,useSeoMeta for meta tags,useHead for simple meta,"useSeoMeta({ title: 'Home', ogTitle: 'Home', description: '...' })","useHead({ meta: [{ name: 'description', content: '...' }] })",High,https://nuxt.com/docs/api/composables/use-seo-meta
+31,SEO,Use reactive values in useSeoMeta,Dynamic SEO tags with refs or getters,Computed getters for dynamic values,Static values for dynamic content,"useSeoMeta({ title: () => post.value.title })","useSeoMeta({ title: post.value.title })",Medium,https://nuxt.com/docs/api/composables/use-seo-meta
+32,SEO,Use useHead for non-meta head elements,Scripts styles links in head,useHead for scripts and links,useSeoMeta for scripts,"useHead({ script: [{ src: '/analytics.js' }] })","useSeoMeta({ script: '...' })",Medium,https://nuxt.com/docs/api/composables/use-head
+33,SEO,Include OpenGraph tags,Add OG tags for social sharing,ogTitle ogDescription ogImage,Missing social preview,"useSeoMeta({ ogImage: '/og.png', twitterCard: 'summary_large_image' })",No OG configuration,Medium,https://nuxt.com/docs/api/composables/use-seo-meta
+34,Middleware,Use defineNuxtRouteMiddleware,Define route middleware properly,defineNuxtRouteMiddleware wrapper,export default function,"export default defineNuxtRouteMiddleware((to, from) => {})","export default function(to, from) {}",High,https://nuxt.com/docs/guide/directory-structure/middleware
+35,Middleware,Use navigateTo for redirects,Redirect in middleware with navigateTo,return navigateTo('/login'),router.push in middleware,"if (!auth) return navigateTo('/login')","if (!auth) router.push('/login')",High,https://nuxt.com/docs/api/utils/navigate-to
+36,Middleware,Reference middleware in definePageMeta,Apply middleware to specific pages,middleware array in definePageMeta,Global middleware for page-specific,definePageMeta({ middleware: ['auth'] }),Global auth check for one page,Medium,https://nuxt.com/docs/guide/directory-structure/middleware
+37,Middleware,Use .global suffix for global middleware,Apply middleware to all routes,auth.global.ts for app-wide auth,Manual middleware on every page,middleware/auth.global.ts,middleware: ['auth'] on every page,Medium,https://nuxt.com/docs/guide/directory-structure/middleware
+38,ErrorHandling,Use createError for errors,Create errors with proper status codes,createError with statusCode,throw new Error,"throw createError({ statusCode: 404, statusMessage: 'Not Found' })",throw new Error('Not Found'),High,https://nuxt.com/docs/api/utils/create-error
+39,ErrorHandling,Use NuxtErrorBoundary for local errors,Handle errors within component subtree,NuxtErrorBoundary for component errors,Global error page for local errors,"<NuxtErrorBoundary @error=""log""><template #error=""{ error }"">",error.vue for component errors,Medium,https://nuxt.com/docs/getting-started/error-handling
+40,ErrorHandling,Use clearError to recover from errors,Clear error state and optionally redirect,clearError({ redirect: '/' }),Manual error state reset,clearError({ redirect: '/home' }),error.value = null,Medium,https://nuxt.com/docs/api/utils/clear-error
+41,ErrorHandling,Use short statusMessage,Keep statusMessage brief for security,Short generic messages,Detailed error info in statusMessage,"createError({ statusCode: 400, statusMessage: 'Bad Request' })","createError({ statusMessage: 'Invalid user ID: 123' })",High,https://nuxt.com/docs/getting-started/error-handling
+42,Link,Use NuxtLink for internal navigation,Client-side navigation with prefetching,<NuxtLink to> for internal links,<a href> for internal links,<NuxtLink to="/about">About</NuxtLink>,<a href="/about">About</a>,High,https://nuxt.com/docs/api/components/nuxt-link
+43,Link,Configure prefetch behavior,Control when prefetching occurs,prefetchOn for interaction-based,Default prefetch for low-priority,"<NuxtLink prefetch-on=""interaction"">",Always default prefetch,Low,https://nuxt.com/docs/api/components/nuxt-link
+44,Link,Use useRouter for programmatic navigation,Navigate programmatically,useRouter().push() for navigation,Direct window.location,"const router = useRouter(); router.push('/dashboard')",window.location.href = '/dashboard',Medium,https://nuxt.com/docs/api/composables/use-router
+45,Link,Use navigateTo in composables,Navigate outside components,navigateTo() in middleware or plugins,useRouter in non-component code,return navigateTo('/login'),router.push in middleware,Medium,https://nuxt.com/docs/api/utils/navigate-to
+46,AutoImports,Leverage auto-imports,Use auto-imported composables directly,Direct use of ref computed useFetch,Manual imports for Nuxt composables,"const count = ref(0)","import { ref } from 'vue'; const count = ref(0)",Medium,https://nuxt.com/docs/guide/concepts/auto-imports
+47,AutoImports,Use #imports for explicit imports,Explicit imports when needed,#imports for clarity or disabled auto-imports,"import from 'vue' when auto-import enabled","import { ref } from '#imports'","import { ref } from 'vue'",Low,https://nuxt.com/docs/guide/concepts/auto-imports
+48,AutoImports,Configure third-party auto-imports,Add external package auto-imports,imports.presets in nuxt.config,Manual imports everywhere,"imports: { presets: [{ from: 'vue-i18n', imports: ['useI18n'] }] }",import { useI18n } everywhere,Low,https://nuxt.com/docs/guide/concepts/auto-imports
+49,Plugins,Use defineNuxtPlugin,Define plugins properly,defineNuxtPlugin wrapper,export default function,"export default defineNuxtPlugin((nuxtApp) => {})","export default function(ctx) {}",High,https://nuxt.com/docs/guide/directory-structure/plugins
+50,Plugins,Use provide for injection,Provide helpers across app,return { provide: {} } for type safety,nuxtApp.provide without types,"return { provide: { hello: (name) => `Hello ${name}!` } }","nuxtApp.provide('hello', fn)",Medium,https://nuxt.com/docs/guide/directory-structure/plugins
+51,Plugins,Use .client or .server suffix,Control plugin execution environment,plugin.client.ts for client-only,if (process.client) checks,analytics.client.ts,"if (process.client) { // analytics }",Medium,https://nuxt.com/docs/guide/directory-structure/plugins
+52,Environment,Use runtimeConfig for env vars,Access environment variables safely,runtimeConfig in nuxt.config,process.env directly,"runtimeConfig: { apiSecret: '', public: { apiBase: '' } }",process.env.API_SECRET in components,High,https://nuxt.com/docs/guide/going-further/runtime-config
+53,Environment,Use NUXT_ prefix for env override,Override config with environment variables,NUXT_API_SECRET NUXT_PUBLIC_API_BASE,Custom env var names,NUXT_PUBLIC_API_BASE=https://api.example.com,API_BASE=https://api.example.com,High,https://nuxt.com/docs/guide/going-further/runtime-config
+54,Environment,Access public config with useRuntimeConfig,Get public config in components,useRuntimeConfig().public,Direct process.env access,const config = useRuntimeConfig(); config.public.apiBase,process.env.NUXT_PUBLIC_API_BASE,High,https://nuxt.com/docs/api/composables/use-runtime-config
+55,Environment,Keep secrets in private config,Server-only secrets in runtimeConfig root,runtimeConfig.apiSecret (server only),Secrets in public config,runtimeConfig: { dbPassword: '' },runtimeConfig: { public: { dbPassword: '' } },High,https://nuxt.com/docs/guide/going-further/runtime-config
+56,Performance,Use Lazy prefix for code splitting,Lazy load components with Lazy prefix,<LazyComponent> for below-fold,Eager load all components,<LazyMountainsList v-if="show"/>,<MountainsList/> for hidden content,Medium,https://nuxt.com/docs/guide/directory-structure/components
+57,Performance,Use useLazyFetch for non-blocking data,Alias for useFetch with lazy: true,useLazyFetch for secondary data,useFetch for all requests,"const { data } = useLazyFetch('/api/comments')",await useFetch for comments section,Medium,https://nuxt.com/docs/api/composables/use-lazy-fetch
+58,Performance,Use lazy hydration for interactivity,Delay component hydration until needed,LazyComponent with hydration strategy,Immediate hydration for all,<LazyModal hydrate-on-visible/>,<Modal/> in footer,Low,https://nuxt.com/docs/guide/going-further/experimental-features
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/react-native.csv b/.claude/skills/ui-ux-pro-max/data/stacks/react-native.csv
new file mode 100644
index 0000000..209e893
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/react-native.csv
@@ -0,0 +1,52 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Components,Use functional components,Hooks-based components are standard,Functional components with hooks,Class components,const App = () => { },class App extends Component,Medium,https://reactnative.dev/docs/intro-react
+2,Components,Keep components small,Single responsibility principle,Split into smaller components,Large monolithic components,<Header /><Content /><Footer />,500+ line component,Medium,
+3,Components,Use TypeScript,Type safety for props and state,TypeScript for new projects,JavaScript without types,const Button: FC<Props> = () => { },const Button = (props) => { },Medium,
+4,Components,Colocate component files,Keep related files together,Component folder with styles,Flat structure,components/Button/index.tsx styles.ts,components/Button.tsx styles/button.ts,Low,
+5,Styling,Use StyleSheet.create,Optimized style objects,StyleSheet for all styles,Inline style objects,StyleSheet.create({ container: {} }),style={{ margin: 10 }},High,https://reactnative.dev/docs/stylesheet
+6,Styling,Avoid inline styles,Prevent object recreation,Styles in StyleSheet,Inline style objects in render,style={styles.container},"style={{ margin: 10, padding: 5 }}",Medium,
+7,Styling,Use flexbox for layout,React Native uses flexbox,flexDirection alignItems justifyContent,Absolute positioning everywhere,flexDirection: 'row',position: 'absolute' everywhere,Medium,https://reactnative.dev/docs/flexbox
+8,Styling,Handle platform differences,Platform-specific styles,Platform.select or .ios/.android files,Same styles for both platforms,"Platform.select({ ios: {}, android: {} })",Hardcoded iOS values,Medium,https://reactnative.dev/docs/platform-specific-code
+9,Styling,Use responsive dimensions,Scale for different screens,Dimensions or useWindowDimensions,Fixed pixel values,useWindowDimensions(),width: 375,Medium,
+10,Navigation,Use React Navigation,Standard navigation library,React Navigation for routing,Manual navigation management,createStackNavigator(),Custom navigation state,Medium,https://reactnavigation.org/
+11,Navigation,Type navigation params,Type-safe navigation,Typed navigation props,Untyped navigation,"navigation.navigate<RootStackParamList>('Home', { id })","navigation.navigate('Home', { id })",Medium,
+12,Navigation,Use deep linking,Support URL-based navigation,Configure linking prop,No deep link support,linking: { prefixes: [] },No linking configuration,Medium,https://reactnavigation.org/docs/deep-linking/
+13,Navigation,Handle back button,Android back button handling,useFocusEffect with BackHandler,Ignore back button,BackHandler.addEventListener,No back handler,High,
+14,State,Use useState for local state,Simple component state,useState for UI state,Class component state,"const [count, setCount] = useState(0)",this.state = { count: 0 },Medium,
+15,State,Use useReducer for complex state,Complex state logic,useReducer for related state,Multiple useState for related values,useReducer(reducer initialState),5+ useState calls,Medium,
+16,State,Use context sparingly,Context for global state,Context for theme auth locale,Context for frequently changing data,ThemeContext for app theme,Context for list item data,Medium,
+17,State,Consider Zustand or Redux,External state management,Zustand for simple Redux for complex,useState for global state,create((set) => ({ })),Prop drilling global state,Medium,
+18,Lists,Use FlatList for long lists,Virtualized list rendering,FlatList for 50+ items,ScrollView with map,<FlatList data={items} />,<ScrollView>{items.map()}</ScrollView>,High,https://reactnative.dev/docs/flatlist
+19,Lists,Provide keyExtractor,Unique keys for list items,keyExtractor with stable ID,Index as key,keyExtractor={(item) => item.id},"keyExtractor={(_, index) => index}",High,
+20,Lists,Optimize renderItem,Memoize list item components,React.memo for list items,Inline render function,renderItem={({ item }) => <MemoizedItem item={item} />},renderItem={({ item }) => <View>...</View>},High,
+21,Lists,Use getItemLayout for fixed height,Skip measurement for performance,getItemLayout when height known,Dynamic measurement for fixed items,"getItemLayout={(_, index) => ({ length: 50, offset: 50 * index, index })}",No getItemLayout for fixed height,Medium,
+22,Lists,Implement windowSize,Control render window,Smaller windowSize for memory,Default windowSize for large lists,windowSize={5},windowSize={21} for huge lists,Medium,
+23,Performance,Use React.memo,Prevent unnecessary re-renders,memo for pure components,No memoization,export default memo(MyComponent),export default MyComponent,Medium,
+24,Performance,Use useCallback for handlers,Stable function references,useCallback for props,New function on every render,"useCallback(() => {}, [deps])",() => handlePress(),Medium,
+25,Performance,Use useMemo for expensive ops,Cache expensive calculations,useMemo for heavy computations,Recalculate every render,"useMemo(() => expensive(), [deps])",const result = expensive(),Medium,
+26,Performance,Avoid anonymous functions in JSX,Prevent re-renders,Named handlers or useCallback,Inline arrow functions,onPress={handlePress},onPress={() => doSomething()},Medium,
+27,Performance,Use Hermes engine,Improved startup and memory,Enable Hermes in build,JavaScriptCore for new projects,hermes_enabled: true,hermes_enabled: false,Medium,https://reactnative.dev/docs/hermes
+28,Images,Use expo-image,Modern performant image component for React Native,"Use expo-image for caching, blurring, and performance",Use default Image for heavy lists or unmaintained libraries,<Image source={url} cachePolicy='memory-disk' /> (expo-image),<FastImage source={url} />,Medium,https://docs.expo.dev/versions/latest/sdk/image/
+29,Images,Specify image dimensions,Prevent layout shifts,width and height for remote images,No dimensions for network images,<Image style={{ width: 100 height: 100 }} />,<Image source={{ uri }} /> no size,High,
+30,Images,Use resizeMode,Control image scaling,resizeMode cover contain,Stretch images,"resizeMode=""cover""",No resizeMode,Low,
+31,Forms,Use controlled inputs,State-controlled form fields,value + onChangeText,Uncontrolled inputs,<TextInput value={text} onChangeText={setText} />,<TextInput defaultValue={text} />,Medium,
+32,Forms,Handle keyboard,Manage keyboard visibility,KeyboardAvoidingView,Content hidden by keyboard,"<KeyboardAvoidingView behavior=""padding"">",No keyboard handling,High,https://reactnative.dev/docs/keyboardavoidingview
+33,Forms,Use proper keyboard types,Appropriate keyboard for input,keyboardType for input type,Default keyboard for all,"keyboardType=""email-address""","keyboardType=""default"" for email",Low,
+34,Touch,Use Pressable,Modern touch handling,Pressable for touch interactions,TouchableOpacity for new code,<Pressable onPress={} />,<TouchableOpacity onPress={} />,Low,https://reactnative.dev/docs/pressable
+35,Touch,Provide touch feedback,Visual feedback on press,Ripple or opacity change,No feedback on press,android_ripple={{ color: 'gray' }},No press feedback,Medium,
+36,Touch,Set hitSlop for small targets,Increase touch area,hitSlop for icons and small buttons,Tiny touch targets,hitSlop={{ top: 10 bottom: 10 }},44x44 with no hitSlop,Medium,
+37,Animation,Use Reanimated,High-performance animations,react-native-reanimated,Animated API for complex,useSharedValue useAnimatedStyle,Animated.timing for gesture,Medium,https://docs.swmansion.com/react-native-reanimated/
+38,Animation,Run on UI thread,worklets for smooth animation,Run animations on UI thread,JS thread animations,runOnUI(() => {}),Animated on JS thread,High,
+39,Animation,Use gesture handler,Native gesture recognition,react-native-gesture-handler,JS-based gesture handling,<GestureDetector>,<View onTouchMove={} />,Medium,https://docs.swmansion.com/react-native-gesture-handler/
+40,Async,Handle loading states,Show loading indicators,ActivityIndicator during load,Empty screen during load,{isLoading ? <ActivityIndicator /> : <Content />},No loading state,Medium,
+41,Async,Handle errors gracefully,Error boundaries and fallbacks,Error UI for failed requests,Crash on error,{error ? <ErrorView /> : <Content />},No error handling,High,
+42,Async,Cancel async operations,Cleanup on unmount,AbortController or cleanup,Memory leaks from async,useEffect cleanup,No cleanup for subscriptions,High,
+43,Accessibility,Add accessibility labels,Describe UI elements,accessibilityLabel for all interactive,Missing labels,"accessibilityLabel=""Submit form""",<Pressable> without label,High,https://reactnative.dev/docs/accessibility
+44,Accessibility,Use accessibility roles,Semantic meaning,accessibilityRole for elements,Wrong roles,"accessibilityRole=""button""",No role for button,Medium,
+45,Accessibility,Support screen readers,Test with TalkBack/VoiceOver,Test with screen readers,Skip accessibility testing,Regular TalkBack testing,No screen reader testing,High,
+46,Testing,Use React Native Testing Library,Component testing,render and fireEvent,Enzyme or manual testing,render(<Component />),shallow(<Component />),Medium,https://callstack.github.io/react-native-testing-library/
+47,Testing,Test on real devices,Real device behavior,Test on iOS and Android devices,Simulator only,Device testing in CI,Simulator only testing,High,
+48,Testing,Use Detox for E2E,End-to-end testing,Detox for critical flows,Manual E2E testing,detox test,Manual testing only,Medium,https://wix.github.io/Detox/
+49,Native,Use native modules carefully,Bridge has overhead,Batch native calls,Frequent bridge crossing,Batch updates,Call native on every keystroke,High,
+50,Native,Use Expo when possible,Simplified development,Expo for standard features,Bare RN for simple apps,expo install package,react-native link package,Low,https://docs.expo.dev/
+51,Native,Handle permissions,Request permissions properly,Check and request permissions,Assume permissions granted,PermissionsAndroid.request(),Access without permission check,High,https://reactnative.dev/docs/permissionsandroid
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/react.csv b/.claude/skills/ui-ux-pro-max/data/stacks/react.csv
new file mode 100644
index 0000000..ff08ee2
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/react.csv
@@ -0,0 +1,54 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,State,Use useState for local state,Simple component state should use useState hook,useState for form inputs toggles counters,Class components this.state,"const [count, setCount] = useState(0)",this.state = { count: 0 },Medium,https://react.dev/reference/react/useState
+2,State,Lift state up when needed,Share state between siblings by lifting to parent,Lift shared state to common ancestor,Prop drilling through many levels,Parent holds state passes down,Deep prop chains,Medium,https://react.dev/learn/sharing-state-between-components
+3,State,Use useReducer for complex state,Complex state logic benefits from reducer pattern,useReducer for state with multiple sub-values,Multiple useState for related values,useReducer with action types,5+ useState calls that update together,Medium,https://react.dev/reference/react/useReducer
+4,State,Avoid unnecessary state,Derive values from existing state when possible,Compute derived values in render,Store derivable values in state,const total = items.reduce(...),"const [total, setTotal] = useState(0)",High,https://react.dev/learn/choosing-the-state-structure
+5,State,Initialize state lazily,Use function form for expensive initial state,useState(() => computeExpensive()),useState(computeExpensive()),useState(() => JSON.parse(data)),useState(JSON.parse(data)),Medium,https://react.dev/reference/react/useState#avoiding-recreating-the-initial-state
+6,Effects,Clean up effects,Return cleanup function for subscriptions timers,Return cleanup function in useEffect,No cleanup for subscriptions,useEffect(() => { sub(); return unsub; }),useEffect(() => { subscribe(); }),High,https://react.dev/reference/react/useEffect#connecting-to-an-external-system
+7,Effects,Specify dependencies correctly,Include all values used inside effect in deps array,All referenced values in dependency array,Empty deps with external references,[value] when using value in effect,[] when using props/state in effect,High,https://react.dev/reference/react/useEffect#specifying-reactive-dependencies
+8,Effects,Avoid unnecessary effects,Don't use effects for transforming data or events,Transform data during render handle events directly,useEffect for derived state or event handling,const filtered = items.filter(...),useEffect(() => setFiltered(items.filter(...))),High,https://react.dev/learn/you-might-not-need-an-effect
+9,Effects,Use refs for non-reactive values,Store values that don't trigger re-renders in refs,useRef for interval IDs DOM elements,useState for values that don't need render,const intervalRef = useRef(null),"const [intervalId, setIntervalId] = useState()",Medium,https://react.dev/reference/react/useRef
+10,Rendering,Use keys properly,Stable unique keys for list items,Use stable IDs as keys,Array index as key for dynamic lists,key={item.id},key={index},High,https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key
+11,Rendering,Memoize expensive calculations,Use useMemo for costly computations,useMemo for expensive filtering/sorting,Recalculate every render,"useMemo(() => expensive(), [deps])",const result = expensiveCalc(),Medium,https://react.dev/reference/react/useMemo
+12,Rendering,Memoize callbacks passed to children,Use useCallback for functions passed as props,useCallback for handlers passed to memoized children,New function reference every render,"useCallback(() => {}, [deps])",const handler = () => {},Medium,https://react.dev/reference/react/useCallback
+13,Rendering,Use React.memo wisely,Wrap components that render often with same props,memo for pure components with stable props,memo everything or nothing,memo(ExpensiveList),memo(SimpleButton),Low,https://react.dev/reference/react/memo
+14,Rendering,Avoid inline object/array creation in JSX,Create objects outside render or memoize,Define style objects outside component,Inline objects in props,<div style={styles.container}>,<div style={{ margin: 10 }}>,Medium,
+15,Components,Keep components small and focused,Single responsibility for each component,One concern per component,Large multi-purpose components,<UserAvatar /><UserName />,<UserCard /> with 500 lines,Medium,
+16,Components,Use composition over inheritance,Compose components using children and props,Use children prop for flexibility,Inheritance hierarchies,<Card>{content}</Card>,class SpecialCard extends Card,Medium,https://react.dev/learn/thinking-in-react
+17,Components,Colocate related code,Keep related components and hooks together,Related files in same directory,Flat structure with many files,components/User/UserCard.tsx,components/UserCard.tsx + hooks/useUser.ts,Low,
+18,Components,Use fragments to avoid extra DOM,Fragment or <> for multiple elements without wrapper,<> for grouping without DOM node,Extra div wrappers,<>{items.map(...)}</>,<div>{items.map(...)}</div>,Low,https://react.dev/reference/react/Fragment
+19,Props,Destructure props,Destructure props for cleaner component code,Destructure in function signature,props.name props.value throughout,"function User({ name, age })",function User(props),Low,
+20,Props,Provide default props values,Use default parameters or defaultProps,Default values in destructuring,Undefined checks throughout,function Button({ size = 'md' }),if (size === undefined) size = 'md',Low,
+21,Props,Avoid prop drilling,Use context or composition for deeply nested data,Context for global data composition for UI,Passing props through 5+ levels,<UserContext.Provider>,<A user={u}><B user={u}><C user={u}>,Medium,https://react.dev/learn/passing-data-deeply-with-context
+22,Props,Validate props with TypeScript,Use TypeScript interfaces for prop types,interface Props { name: string },PropTypes or no validation,interface ButtonProps { onClick: () => void },Button.propTypes = {},Medium,
+23,Events,Use synthetic events correctly,React normalizes events across browsers,e.preventDefault() e.stopPropagation(),Access native event unnecessarily,onClick={(e) => e.preventDefault()},onClick={(e) => e.nativeEvent.preventDefault()},Low,https://react.dev/reference/react-dom/components/common#react-event-object
+24,Events,Avoid binding in render,Use arrow functions in class or hooks,Arrow functions in functional components,bind in render or constructor,const handleClick = () => {},this.handleClick.bind(this),Medium,
+25,Events,Pass event handlers not call results,Pass function reference not invocation,onClick={handleClick},onClick={handleClick()} causing immediate call,onClick={handleClick},onClick={handleClick()},High,
+26,Forms,Controlled components for forms,Use state to control form inputs,value + onChange for inputs,Uncontrolled inputs with refs,<input value={val} onChange={setVal}>,<input ref={inputRef}>,Medium,https://react.dev/reference/react-dom/components/input#controlling-an-input-with-a-state-variable
+27,Forms,Handle form submission properly,Prevent default and handle in submit handler,onSubmit with preventDefault,onClick on submit button only,<form onSubmit={handleSubmit}>,<button onClick={handleSubmit}>,Medium,
+28,Forms,Debounce rapid input changes,Debounce search/filter inputs,useDeferredValue or debounce for search,Filter on every keystroke,useDeferredValue(searchTerm),useEffect filtering on every change,Medium,https://react.dev/reference/react/useDeferredValue
+29,Hooks,Follow rules of hooks,Only call hooks at top level and in React functions,Hooks at component top level,Hooks in conditions loops or callbacks,"const [x, setX] = useState()","if (cond) { const [x, setX] = useState() }",High,https://react.dev/reference/rules/rules-of-hooks
+30,Hooks,Custom hooks for reusable logic,Extract shared stateful logic to custom hooks,useCustomHook for reusable patterns,Duplicate hook logic across components,const { data } = useFetch(url),Duplicate useEffect/useState in components,Medium,https://react.dev/learn/reusing-logic-with-custom-hooks
+31,Hooks,Name custom hooks with use prefix,Custom hooks must start with use,useFetch useForm useAuth,fetchData or getData for hook,function useFetch(url),function fetchData(url),High,
+32,Context,Use context for global data,Context for theme auth locale,Context for app-wide state,Context for frequently changing data,<ThemeContext.Provider>,Context for form field values,Medium,https://react.dev/learn/passing-data-deeply-with-context
+33,Context,Split contexts by concern,Separate contexts for different domains,ThemeContext + AuthContext,One giant AppContext,<ThemeProvider><AuthProvider>,<AppProvider value={{theme user...}}>,Medium,
+34,Context,Memoize context values,Prevent unnecessary re-renders with useMemo,useMemo for context value object,New object reference every render,"value={useMemo(() => ({...}), [])}","value={{ user, theme }}",High,
+35,Performance,Use React DevTools Profiler,Profile to identify performance bottlenecks,Profile before optimizing,Optimize without measuring,React DevTools Profiler,Guessing at bottlenecks,Medium,https://react.dev/learn/react-developer-tools
+36,Performance,Lazy load components,Use React.lazy for code splitting,lazy() for routes and heavy components,Import everything upfront,const Page = lazy(() => import('./Page')),import Page from './Page',Medium,https://react.dev/reference/react/lazy
+37,Performance,Virtualize long lists,Use windowing for lists over 100 items,react-window or react-virtual,Render thousands of DOM nodes,<VirtualizedList items={items}/>,{items.map(i => <Item />)},High,
+38,Performance,Batch state updates,React 18 auto-batches but be aware,Let React batch related updates,Manual batching with flushSync,setA(1); setB(2); // batched,flushSync(() => setA(1)),Low,https://react.dev/learn/queueing-a-series-of-state-updates
+39,ErrorHandling,Use error boundaries,Catch JavaScript errors in component tree,ErrorBoundary wrapping sections,Let errors crash entire app,<ErrorBoundary><App/></ErrorBoundary>,No error handling,High,https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary
+40,ErrorHandling,Handle async errors,Catch errors in async operations,try/catch in async handlers,Unhandled promise rejections,try { await fetch() } catch(e) {},await fetch() // no catch,High,
+41,Testing,Test behavior not implementation,Test what user sees and does,Test renders and interactions,Test internal state or methods,expect(screen.getByText('Hello')),expect(component.state.name),Medium,https://testing-library.com/docs/react-testing-library/intro/
+42,Testing,Use testing-library queries,Use accessible queries,getByRole getByLabelText,getByTestId for everything,getByRole('button'),getByTestId('submit-btn'),Medium,https://testing-library.com/docs/queries/about#priority
+43,Accessibility,Use semantic HTML,Proper HTML elements for their purpose,button for clicks nav for navigation,div with onClick for buttons,<button onClick={...}>,<div onClick={...}>,High,https://react.dev/reference/react-dom/components#all-html-components
+44,Accessibility,Manage focus properly,Handle focus for modals dialogs,Focus trap in modals return focus on close,No focus management,useEffect to focus input,Modal without focus trap,High,
+45,Accessibility,Announce dynamic content,Use ARIA live regions for updates,aria-live for dynamic updates,Silent updates to screen readers,"<div aria-live=""polite"">{msg}</div>",<div>{msg}</div>,Medium,
+46,Accessibility,Label form controls,Associate labels with inputs,htmlFor matching input id,Placeholder as only label,"<label htmlFor=""email"">Email</label>","<input placeholder=""Email""/>",High,
+47,TypeScript,Type component props,Define interfaces for all props,interface Props with all prop types,any or missing types,interface Props { name: string },function Component(props: any),High,
+48,TypeScript,Type state properly,Provide types for useState,useState<Type>() for complex state,Inferred any types,useState<User | null>(null),useState(null),Medium,
+49,TypeScript,Type event handlers,Use React event types,React.ChangeEvent<HTMLInputElement>,Generic Event type,onChange: React.ChangeEvent<HTMLInputElement>,onChange: Event,Medium,
+50,TypeScript,Use generics for reusable components,Generic components for flexible typing,Generic props for list components,Union types for flexibility,<List<T> items={T[]}>,<List items={any[]}>,Medium,
+51,Patterns,Container/Presentational split,Separate data logic from UI,Container fetches presentational renders,Mixed data and UI in one,<UserContainer><UserView/></UserContainer>,<User /> with fetch and render,Low,
+52,Patterns,Render props for flexibility,Share code via render prop pattern,Render prop for customizable rendering,Duplicate logic across components,<DataFetcher render={data => ...}/>,Copy paste fetch logic,Low,https://react.dev/reference/react/cloneElement#passing-data-with-a-render-prop
+53,Patterns,Compound components,Related components sharing state,Tab + TabPanel sharing context,Prop drilling between related,<Tabs><Tab/><TabPanel/></Tabs>,<Tabs tabs={[]} panels={[...]}/>,Low,
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/shadcn.csv b/.claude/skills/ui-ux-pro-max/data/stacks/shadcn.csv
new file mode 100644
index 0000000..fb86e8d
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/shadcn.csv
@@ -0,0 +1,61 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Setup,Use CLI for installation,Install components via shadcn CLI for proper setup,npx shadcn@latest add component-name,Manual copy-paste from docs,npx shadcn@latest add button,Copy component code manually,High,https://ui.shadcn.com/docs/cli
+2,Setup,Initialize project properly,Run init command to set up components.json and globals.css,npx shadcn@latest init before adding components,Skip init and add components directly,npx shadcn@latest init,npx shadcn@latest add button (without init),High,https://ui.shadcn.com/docs/installation
+3,Setup,Configure path aliases,Set up proper import aliases in tsconfig and components.json,Use @/components/ui path aliases,Relative imports like ../../components,import { Button } from "@/components/ui/button",import { Button } from "../../components/ui/button",Medium,https://ui.shadcn.com/docs/installation
+4,Theming,Use CSS variables for colors,Define colors as CSS variables in globals.css for theming,CSS variables in :root and .dark,Hardcoded color values in components,bg-primary text-primary-foreground,bg-blue-500 text-white,High,https://ui.shadcn.com/docs/theming
+5,Theming,Follow naming convention,Use semantic color names with foreground pattern,primary/primary-foreground secondary/secondary-foreground,Generic color names,--primary --primary-foreground,--blue --light-blue,Medium,https://ui.shadcn.com/docs/theming
+6,Theming,Support dark mode,Include .dark class styles for all custom CSS,Define both :root and .dark color schemes,Only light mode colors,.dark { --background: 240 10% 3.9%; },No .dark class styles,High,https://ui.shadcn.com/docs/dark-mode
+7,Components,Use component variants,Leverage cva variants for consistent styling,Use variant prop for different styles,Inline conditional classes,<Button variant="destructive">,<Button className={isError ? "bg-red-500" : "bg-blue-500"}>,Medium,https://ui.shadcn.com/docs/components/button
+8,Components,Compose with className,Add custom classes via className prop for overrides,Extend with className for one-off customizations,Modify component source directly,<Button className="w-full">,Edit button.tsx to add w-full,Medium,https://ui.shadcn.com/docs/components/button
+9,Components,Use size variants consistently,Apply size prop for consistent sizing across components,size="sm" size="lg" for sizing,Mix size classes inconsistently,<Button size="lg">,<Button className="text-lg px-8 py-4">,Medium,https://ui.shadcn.com/docs/components/button
+10,Components,Prefer compound components,Use provided sub-components for complex UI,Card + CardHeader + CardContent pattern,Single component with many props,<Card><CardHeader><CardTitle>,<Card title="x" content="y" footer="z">,Medium,https://ui.shadcn.com/docs/components/card
+11,Dialog,Use Dialog for modal content,Dialog component for overlay modal windows,Dialog for confirmations forms details,Alert for modal content,<Dialog><DialogContent>,<Alert> styled as modal,High,https://ui.shadcn.com/docs/components/dialog
+12,Dialog,Handle dialog state properly,Use open and onOpenChange for controlled dialogs,Controlled state with useState,Uncontrolled with default open only,"<Dialog open={open} onOpenChange={setOpen}>","<Dialog defaultOpen={true}>",Medium,https://ui.shadcn.com/docs/components/dialog
+13,Dialog,Include proper dialog structure,Use DialogHeader DialogTitle DialogDescription,Complete semantic structure,Missing title or description,<DialogHeader><DialogTitle><DialogDescription>,<DialogContent><p>Content</p></DialogContent>,High,https://ui.shadcn.com/docs/components/dialog
+14,Sheet,Use Sheet for side panels,Sheet component for slide-out panels and drawers,Sheet for navigation filters settings,Dialog for side content,<Sheet side="right">,<Dialog> with slide animation,Medium,https://ui.shadcn.com/docs/components/sheet
+15,Sheet,Specify sheet side,Set side prop for sheet slide direction,Explicit side="left" or side="right",Default side without consideration,<Sheet><SheetContent side="left">,<Sheet><SheetContent>,Low,https://ui.shadcn.com/docs/components/sheet
+16,Form,Use Form with react-hook-form,Integrate Form component with react-hook-form for validation,useForm + Form + FormField pattern,Custom form handling without Form,<Form {...form}><FormField control={form.control}>,<form onSubmit={handleSubmit}>,High,https://ui.shadcn.com/docs/components/form
+17,Form,Use FormField for inputs,Wrap inputs in FormField for proper labeling and errors,FormField + FormItem + FormLabel + FormControl,Input without FormField wrapper,<FormField><FormItem><FormLabel><FormControl><Input>,<Input onChange={...}>,High,https://ui.shadcn.com/docs/components/form
+18,Form,Display form messages,Use FormMessage for validation error display,FormMessage after FormControl,Custom error text without FormMessage,<FormControl><Input/></FormControl><FormMessage/>,<Input/>{error && <span>{error}</span>},Medium,https://ui.shadcn.com/docs/components/form
+19,Form,Use Zod for validation,Define form schema with Zod for type-safe validation,zodResolver with form schema,Manual validation logic,zodResolver(formSchema),validate: (values) => { if (!values.email) },Medium,https://ui.shadcn.com/docs/components/form
+20,Select,Use Select for dropdowns,Select component for option selection,Select for choosing from list,Native select element,<Select><SelectTrigger><SelectContent>,<select><option>,Medium,https://ui.shadcn.com/docs/components/select
+21,Select,Structure Select properly,Include Trigger Value Content and Items,Complete Select structure,Missing SelectValue or SelectContent,<SelectTrigger><SelectValue/></SelectTrigger><SelectContent><SelectItem>,<Select><option>,High,https://ui.shadcn.com/docs/components/select
+22,Command,Use Command for search,Command component for searchable lists and palettes,Command for command palette search,Input with custom dropdown,<Command><CommandInput><CommandList>,<Input><div className="dropdown">,Medium,https://ui.shadcn.com/docs/components/command
+23,Command,Group command items,Use CommandGroup for categorized items,CommandGroup with heading for sections,Flat list without grouping,<CommandGroup heading="Suggestions"><CommandItem>,<CommandItem> without groups,Low,https://ui.shadcn.com/docs/components/command
+24,Table,Use Table for data display,Table component for structured data,Table for tabular data display,Div grid for table-like layouts,<Table><TableHeader><TableBody><TableRow>,<div className="grid">,Medium,https://ui.shadcn.com/docs/components/table
+25,Table,Include proper table structure,Use TableHeader TableBody TableRow TableCell,Semantic table structure,Missing thead or tbody,<TableHeader><TableRow><TableHead>,<Table><TableRow> without header,High,https://ui.shadcn.com/docs/components/table
+26,DataTable,Use DataTable for complex tables,Combine Table with TanStack Table for features,DataTable pattern for sorting filtering pagination,Custom table implementation,useReactTable + Table components,Custom sort filter pagination logic,Medium,https://ui.shadcn.com/docs/components/data-table
+27,Tabs,Use Tabs for content switching,Tabs component for tabbed interfaces,Tabs for related content sections,Custom tab implementation,<Tabs><TabsList><TabsTrigger><TabsContent>,<div onClick={() => setTab(...)},Medium,https://ui.shadcn.com/docs/components/tabs
+28,Tabs,Set default tab value,Specify defaultValue for initial tab,defaultValue on Tabs component,No default leaving first tab,<Tabs defaultValue="account">,<Tabs> without defaultValue,Low,https://ui.shadcn.com/docs/components/tabs
+29,Accordion,Use Accordion for collapsible,Accordion for expandable content sections,Accordion for FAQ settings panels,Custom collapse implementation,<Accordion><AccordionItem><AccordionTrigger>,<div onClick={() => setOpen(!open)}>,Medium,https://ui.shadcn.com/docs/components/accordion
+30,Accordion,Choose accordion type,Use type="single" or type="multiple" appropriately,type="single" for one open type="multiple" for many,Default type without consideration,<Accordion type="single" collapsible>,<Accordion> without type,Low,https://ui.shadcn.com/docs/components/accordion
+31,Toast,Use Sonner for toasts,Sonner integration for toast notifications,toast() from sonner for notifications,Custom toast implementation,toast("Event created"),setShowToast(true),Medium,https://ui.shadcn.com/docs/components/sonner
+32,Toast,Add Toaster to layout,Include Toaster component in root layout,<Toaster /> in app layout,Toaster in individual pages,app/layout.tsx: <Toaster />,page.tsx: <Toaster />,High,https://ui.shadcn.com/docs/components/sonner
+33,Toast,Use toast variants,Apply toast.success toast.error for context,Semantic toast methods,Generic toast for all messages,toast.success("Saved!") toast.error("Failed"),toast("Saved!") toast("Failed"),Medium,https://ui.shadcn.com/docs/components/sonner
+34,Popover,Use Popover for floating content,Popover for dropdown menus and floating panels,Popover for contextual actions,Absolute positioned divs,<Popover><PopoverTrigger><PopoverContent>,<div className="relative"><div className="absolute">,Medium,https://ui.shadcn.com/docs/components/popover
+35,Popover,Handle popover alignment,Use align and side props for positioning,Explicit alignment configuration,Default alignment for all,<PopoverContent align="start" side="bottom">,<PopoverContent>,Low,https://ui.shadcn.com/docs/components/popover
+36,DropdownMenu,Use DropdownMenu for actions,DropdownMenu for action lists and context menus,DropdownMenu for user menu actions,Popover for action lists,<DropdownMenu><DropdownMenuTrigger><DropdownMenuContent>,<Popover> for menu actions,Medium,https://ui.shadcn.com/docs/components/dropdown-menu
+37,DropdownMenu,Group menu items,Use DropdownMenuGroup and DropdownMenuSeparator,Organized menu with separators,Flat list of items,<DropdownMenuGroup><DropdownMenuItem><DropdownMenuSeparator>,<DropdownMenuItem> without organization,Low,https://ui.shadcn.com/docs/components/dropdown-menu
+38,Tooltip,Use Tooltip for hints,Tooltip for icon buttons and truncated text,Tooltip for additional context,Title attribute for tooltips,<Tooltip><TooltipTrigger><TooltipContent>,<button title="Delete">,Medium,https://ui.shadcn.com/docs/components/tooltip
+39,Tooltip,Add TooltipProvider,Wrap app or section in TooltipProvider,TooltipProvider at app level,TooltipProvider per tooltip,<TooltipProvider><App/></TooltipProvider>,<Tooltip><TooltipProvider>,High,https://ui.shadcn.com/docs/components/tooltip
+40,Skeleton,Use Skeleton for loading,Skeleton component for loading placeholders,Skeleton matching content layout,Spinner for content loading,<Skeleton className="h-4 w-[200px]"/>,<Spinner/> for card loading,Medium,https://ui.shadcn.com/docs/components/skeleton
+41,Skeleton,Match skeleton dimensions,Size skeleton to match loaded content,Skeleton same size as expected content,Generic skeleton size,<Skeleton className="h-12 w-12 rounded-full"/>,<Skeleton/> without sizing,Medium,https://ui.shadcn.com/docs/components/skeleton
+42,AlertDialog,Use AlertDialog for confirms,AlertDialog for destructive action confirmation,AlertDialog for delete confirmations,Dialog for confirmations,<AlertDialog><AlertDialogTrigger><AlertDialogContent>,<Dialog> for delete confirmation,High,https://ui.shadcn.com/docs/components/alert-dialog
+43,AlertDialog,Include action buttons,Use AlertDialogAction and AlertDialogCancel,Standard confirm/cancel pattern,Custom buttons in AlertDialog,<AlertDialogCancel>Cancel</AlertDialogCancel><AlertDialogAction>,<Button>Cancel</Button><Button>Confirm</Button>,Medium,https://ui.shadcn.com/docs/components/alert-dialog
+44,Sidebar,Use Sidebar for navigation,Sidebar component for app navigation,Sidebar for main app navigation,Custom sidebar implementation,<SidebarProvider><Sidebar><SidebarContent>,<div className="w-64 fixed">,Medium,https://ui.shadcn.com/docs/components/sidebar
+45,Sidebar,Wrap in SidebarProvider,Use SidebarProvider for sidebar state management,SidebarProvider at layout level,Sidebar without provider,<SidebarProvider><Sidebar></SidebarProvider>,<Sidebar> without provider,High,https://ui.shadcn.com/docs/components/sidebar
+46,Sidebar,Use SidebarTrigger,Include SidebarTrigger for mobile toggle,SidebarTrigger for responsive toggle,Custom toggle button,<SidebarTrigger/>,<Button onClick={() => toggleSidebar()}>,Medium,https://ui.shadcn.com/docs/components/sidebar
+47,Chart,Use Chart for data viz,Chart component with Recharts integration,Chart component for dashboards,Direct Recharts without wrapper,<ChartContainer config={chartConfig}>,<ResponsiveContainer><BarChart>,Medium,https://ui.shadcn.com/docs/components/chart
+48,Chart,Define chart config,Create chartConfig for consistent theming,chartConfig with color definitions,Inline colors in charts,"{ desktop: { label: ""Desktop"", color: ""#2563eb"" } }",<Bar fill="#2563eb"/>,Medium,https://ui.shadcn.com/docs/components/chart
+49,Chart,Use ChartTooltip,Apply ChartTooltip for interactive charts,ChartTooltip with ChartTooltipContent,Recharts Tooltip directly,<ChartTooltip content={<ChartTooltipContent/>}/>,<Tooltip/> from recharts,Low,https://ui.shadcn.com/docs/components/chart
+50,Blocks,Use blocks for scaffolding,Start from shadcn blocks for common layouts,npx shadcn@latest add dashboard-01,Build dashboard from scratch,npx shadcn@latest add login-01,Custom login page from scratch,Medium,https://ui.shadcn.com/blocks
+51,Blocks,Customize block components,Modify copied block code to fit needs,Edit block files after installation,Use blocks without modification,Customize dashboard-01 layout,Use dashboard-01 as-is,Low,https://ui.shadcn.com/blocks
+52,A11y,Use semantic components,Shadcn components have built-in ARIA,Rely on component accessibility,Override ARIA attributes,<Button> has button role,<div role="button">,High,https://ui.shadcn.com/docs/components/button
+53,A11y,Maintain focus management,Dialog Sheet handle focus automatically,Let components manage focus,Custom focus handling,<Dialog> traps focus,document.querySelector().focus(),High,https://ui.shadcn.com/docs/components/dialog
+54,A11y,Provide labels,Use FormLabel and aria-label appropriately,FormLabel for form inputs,Placeholder as only label,<FormLabel>Email</FormLabel><Input/>,<Input placeholder="Email"/>,High,https://ui.shadcn.com/docs/components/form
+55,Performance,Import components individually,Import only needed components,Named imports from component files,Import all from index,import { Button } from "@/components/ui/button",import { Button Card Dialog } from "@/components/ui",Medium,
+56,Performance,Lazy load dialogs,Dynamic import for heavy dialog content,React.lazy for dialog content,Import all dialogs upfront,const HeavyContent = lazy(() => import('./Heavy')),import HeavyContent from './Heavy',Medium,
+57,Customization,Extend variants with cva,Add new variants using class-variance-authority,Extend buttonVariants for new styles,Inline classes for variants,"variants: { size: { xl: ""h-14 px-8"" } }",className="h-14 px-8",Medium,https://ui.shadcn.com/docs/components/button
+58,Customization,Create custom components,Build new components following shadcn patterns,Use cn() and cva for custom components,Different patterns for custom,const Custom = ({ className }) => <div className={cn("base" className)}>,const Custom = ({ style }) => <div style={style}>,Medium,
+59,Patterns,Use asChild for composition,asChild prop for component composition,Slot pattern with asChild,Wrapper divs for composition,<Button asChild><Link href="/">,<Button><Link href="/"></Link></Button>,Medium,https://ui.shadcn.com/docs/components/button
+60,Patterns,Combine with React Hook Form,Form + useForm for complete forms,RHF Controller with shadcn inputs,Custom form state management,<FormField control={form.control} name="email">,<Input value={email} onChange={(e) => setEmail(e.target.value)},High,https://ui.shadcn.com/docs/components/form
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/svelte.csv b/.claude/skills/ui-ux-pro-max/data/stacks/svelte.csv
new file mode 100644
index 0000000..1c6b456
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/svelte.csv
@@ -0,0 +1,54 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Reactivity,Use $: for reactive statements,Automatic dependency tracking,$: for derived values,Manual recalculation,$: doubled = count * 2,let doubled; count && (doubled = count * 2),Medium,https://svelte.dev/docs/svelte-components#script-3-$-marks-a-statement-as-reactive
+2,Reactivity,Trigger reactivity with assignment,Svelte tracks assignments not mutations,Reassign arrays/objects to trigger update,Mutate without reassignment,"items = [...items, newItem]",items.push(newItem),High,https://svelte.dev/docs/svelte-components#script-2-assignments-are-reactive
+3,Reactivity,Use $state in Svelte 5,Runes for explicit reactivity,let count = $state(0),Implicit reactivity in Svelte 5,let count = $state(0),let count = 0 (Svelte 5),Medium,https://svelte.dev/blog/runes
+4,Reactivity,Use $derived for computed values,$derived replaces $: in Svelte 5,let doubled = $derived(count * 2),$: in Svelte 5,let doubled = $derived(count * 2),$: doubled = count * 2 (Svelte 5),Medium,
+5,Reactivity,Use $effect for side effects,$effect replaces $: side effects,Use $effect for subscriptions,$: for side effects in Svelte 5,$effect(() => console.log(count)),$: console.log(count) (Svelte 5),Medium,
+6,Props,Export let for props,Declare props with export let,export let propName,Props without export,export let count = 0,let count = 0,High,https://svelte.dev/docs/svelte-components#script-1-export-creates-a-component-prop
+7,Props,Use $props in Svelte 5,$props rune for prop access,let { name } = $props(),export let in Svelte 5,"let { name, age = 0 } = $props()",export let name; export let age = 0,Medium,
+8,Props,Provide default values,Default props with assignment,export let count = 0,Required props without defaults,export let count = 0,export let count,Low,
+9,Props,Use spread props,Pass through unknown props,{...$$restProps} on elements,Manual prop forwarding,<button {...$$restProps}>,<button class={$$props.class}>,Low,https://svelte.dev/docs/basic-markup#attributes-and-props
+10,Bindings,Use bind: for two-way binding,Simplified input handling,bind:value for inputs,on:input with manual update,<input bind:value={name}>,<input value={name} on:input={e => name = e.target.value}>,Low,https://svelte.dev/docs/element-directives#bind-property
+11,Bindings,Bind to DOM elements,Reference DOM nodes,bind:this for element reference,querySelector in onMount,<div bind:this={el}>,onMount(() => el = document.querySelector()),Medium,
+12,Bindings,Use bind:group for radios/checkboxes,Simplified group handling,bind:group for radio/checkbox groups,Manual checked handling,"<input type=""radio"" bind:group={selected}>","<input type=""radio"" checked={selected === value}>",Low,
+13,Events,Use on: for event handlers,Event directive syntax,on:click={handler},addEventListener in onMount,<button on:click={handleClick}>,onMount(() => btn.addEventListener()),Medium,https://svelte.dev/docs/element-directives#on-eventname
+14,Events,Forward events with on:event,Pass events to parent,on:click without handler,createEventDispatcher for DOM events,<button on:click>,"dispatch('click', event)",Low,
+15,Events,Use createEventDispatcher,Custom component events,dispatch for custom events,on:event for custom events,"dispatch('save', { data })",on:save without dispatch,Medium,https://svelte.dev/docs/svelte#createeventdispatcher
+16,Lifecycle,Use onMount for initialization,Run code after component mounts,onMount for setup and data fetching,Code in script body for side effects,onMount(() => fetchData()),fetchData() in script body,High,https://svelte.dev/docs/svelte#onmount
+17,Lifecycle,Return cleanup from onMount,Automatic cleanup on destroy,Return function from onMount,Separate onDestroy for paired cleanup,onMount(() => { sub(); return unsub }),onMount(sub); onDestroy(unsub),Medium,
+18,Lifecycle,Use onDestroy sparingly,Only when onMount cleanup not possible,onDestroy for non-mount cleanup,onDestroy for mount-related cleanup,onDestroy for store unsubscribe,onDestroy(() => clearInterval(id)),Low,
+19,Lifecycle,Avoid beforeUpdate/afterUpdate,Usually not needed,Reactive statements instead,beforeUpdate for derived state,$: if (x) doSomething(),beforeUpdate(() => doSomething()),Low,
+20,Stores,Use writable for mutable state,Basic reactive store,writable for shared mutable state,Local variables for shared state,const count = writable(0),let count = 0 in module,Medium,https://svelte.dev/docs/svelte-store#writable
+21,Stores,Use readable for read-only state,External data sources,readable for derived/external data,writable for read-only data,"readable(0, set => interval(set))",writable(0) for timer,Low,https://svelte.dev/docs/svelte-store#readable
+22,Stores,Use derived for computed stores,Combine or transform stores,derived for computed values,Manual subscription for derived,"derived(count, $c => $c * 2)",count.subscribe(c => doubled = c * 2),Medium,https://svelte.dev/docs/svelte-store#derived
+23,Stores,Use $ prefix for auto-subscription,Automatic subscribe/unsubscribe,$storeName in components,Manual subscription,{$count},count.subscribe(c => value = c),High,
+24,Stores,Clean up custom subscriptions,Unsubscribe when component destroys,Return unsubscribe from onMount,Leave subscriptions open,onMount(() => store.subscribe(fn)),store.subscribe(fn) in script,High,
+25,Slots,Use slots for composition,Content projection,<slot> for flexible content,Props for all content,<slot>Default</slot>,"<Component content=""text""/>",Medium,https://svelte.dev/docs/special-elements#slot
+26,Slots,Name slots for multiple areas,Multiple content areas,"<slot name=""header"">",Single slot for complex layouts,"<slot name=""header""><slot name=""footer"">",<slot> with complex conditionals,Low,
+27,Slots,Check slot content with $$slots,Conditional slot rendering,$$slots.name for conditional rendering,Always render slot wrapper,"{#if $$slots.footer}<slot name=""footer""/>{/if}","<div><slot name=""footer""/></div>",Low,
+28,Styling,Use scoped styles by default,Styles scoped to component,<style> for component styles,Global styles for component,:global() only when needed,<style> all global,Medium,https://svelte.dev/docs/svelte-components#style
+29,Styling,Use :global() sparingly,Escape scoping when needed,:global for third-party styling,Global for all styles,:global(.external-lib),<style> without scoping,Medium,
+30,Styling,Use CSS variables for theming,Dynamic styling,CSS custom properties,Inline styles for themes,"style=""--color: {color}""","style=""color: {color}""",Low,
+31,Transitions,Use built-in transitions,Svelte transition directives,transition:fade for simple effects,Manual CSS transitions,<div transition:fade>,<div class:fade={visible}>,Low,https://svelte.dev/docs/element-directives#transition-fn
+32,Transitions,Use in: and out: separately,Different enter/exit animations,in:fly out:fade for asymmetric,Same transition for both,<div in:fly out:fade>,<div transition:fly>,Low,
+33,Transitions,Add local modifier,Prevent ancestor trigger,transition:fade|local,Global transitions for lists,<div transition:slide|local>,<div transition:slide>,Medium,
+34,Actions,Use actions for DOM behavior,Reusable DOM logic,use:action for DOM enhancements,onMount for each usage,<div use:clickOutside>,onMount(() => setupClickOutside(el)),Medium,https://svelte.dev/docs/element-directives#use-action
+35,Actions,Return update and destroy,Lifecycle methods for actions,"Return { update, destroy }",Only initial setup,"return { update(params) {}, destroy() {} }",return destroy only,Medium,
+36,Actions,Pass parameters to actions,Configure action behavior,use:action={params},Hardcoded action behavior,<div use:tooltip={options}>,<div use:tooltip>,Low,
+37,Logic,Use {#if} for conditionals,Template conditionals,{#if} {:else if} {:else},Ternary in expressions,{#if cond}...{:else}...{/if},{cond ? a : b} for complex,Low,https://svelte.dev/docs/logic-blocks#if
+38,Logic,Use {#each} for lists,List rendering,{#each} with key,Map in expression,{#each items as item (item.id)},{items.map(i => `<div>${i}</div>`)},Medium,
+39,Logic,Always use keys in {#each},Proper list reconciliation,(item.id) for unique key,Index as key or no key,{#each items as item (item.id)},"{#each items as item, i (i)}",High,
+40,Logic,Use {#await} for promises,Handle async states,{#await} for loading/error states,Manual promise handling,{#await promise}...{:then}...{:catch},{#if loading}...{#if error},Medium,https://svelte.dev/docs/logic-blocks#await
+41,SvelteKit,Use +page.svelte for routes,File-based routing,+page.svelte for route components,Custom routing setup,routes/about/+page.svelte,routes/About.svelte,Medium,https://kit.svelte.dev/docs/routing
+42,SvelteKit,Use +page.js for data loading,Load data before render,load function in +page.js,onMount for data fetching,export function load() {},onMount(() => fetchData()),High,https://kit.svelte.dev/docs/load
+43,SvelteKit,Use +page.server.js for server-only,Server-side data loading,+page.server.js for sensitive data,+page.js for API keys,+page.server.js with DB access,+page.js with DB access,High,
+44,SvelteKit,Use form actions,Server-side form handling,+page.server.js actions,API routes for forms,export const actions = { default },fetch('/api/submit'),Medium,https://kit.svelte.dev/docs/form-actions
+45,SvelteKit,Use $app/stores for app state,$page $navigating $updated,$page for current page data,Manual URL parsing,import { page } from '$app/stores',window.location.pathname,Medium,https://kit.svelte.dev/docs/modules#$app-stores
+46,Performance,Use {#key} for forced re-render,Reset component state,{#key id} for fresh instance,Manual destroy/create,{#key item.id}<Component/>{/key},on:change={() => component = null},Low,https://svelte.dev/docs/logic-blocks#key
+47,Performance,Avoid unnecessary reactivity,Not everything needs $:,$: only for side effects,$: for simple assignments,$: if (x) console.log(x),$: y = x (when y = x works),Low,
+48,Performance,Use immutable compiler option,Skip equality checks,immutable: true for large lists,Default for all components,<svelte:options immutable/>,Default without immutable,Low,
+49,TypeScript,"Use lang=""ts"" in script",TypeScript support,"<script lang=""ts"">",JavaScript for typed projects,"<script lang=""ts"">",<script> with JSDoc,Medium,https://svelte.dev/docs/typescript
+50,TypeScript,Type props with interface,Explicit prop types,interface $$Props for types,Untyped props,interface $$Props { name: string },export let name,Medium,
+51,TypeScript,Type events with createEventDispatcher,Type-safe events,createEventDispatcher<Events>(),Untyped dispatch,createEventDispatcher<{ save: Data }>(),createEventDispatcher(),Medium,
+52,Accessibility,Use semantic elements,Proper HTML in templates,button nav main appropriately,div for everything,<button on:click>,<div on:click>,High,
+53,Accessibility,Add aria to dynamic content,Accessible state changes,aria-live for updates,Silent dynamic updates,"<div aria-live=""polite"">{message}</div>",<div>{message}</div>,Medium,
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/swiftui.csv b/.claude/skills/ui-ux-pro-max/data/stacks/swiftui.csv
new file mode 100644
index 0000000..e20f9f9
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/swiftui.csv
@@ -0,0 +1,51 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Views,Use struct for views,SwiftUI views are value types,struct MyView: View,class MyView: View,struct ContentView: View { var body: some View },class ContentView: View,High,https://developer.apple.com/documentation/swiftui/view
+2,Views,Keep views small and focused,Single responsibility for each view,Extract subviews for complex layouts,Large monolithic views,Extract HeaderView FooterView,500+ line View struct,Medium,
+3,Views,Use body computed property,body returns the view hierarchy,var body: some View { },func body() -> some View,"var body: some View { Text(""Hello"") }",func body() -> Text,High,
+4,Views,Prefer composition over inheritance,Compose views using ViewBuilder,Combine smaller views,Inheritance hierarchies,VStack { Header() Content() },class SpecialView extends BaseView,Medium,
+5,State,Use @State for local state,Simple value types owned by view,@State for view-local primitives,@State for shared data,@State private var count = 0,@State var sharedData: Model,High,https://developer.apple.com/documentation/swiftui/state
+6,State,Use @Binding for two-way data,Pass mutable state to child views,@Binding for child input,@State in child for parent data,@Binding var isOn: Bool,$isOn to pass binding,Medium,https://developer.apple.com/documentation/swiftui/binding
+7,State,Use @StateObject for reference types,ObservableObject owned by view,@StateObject for view-created objects,@ObservedObject for owned objects,@StateObject private var vm = ViewModel(),@ObservedObject var vm = ViewModel(),High,https://developer.apple.com/documentation/swiftui/stateobject
+8,State,Use @ObservedObject for injected objects,Reference types passed from parent,@ObservedObject for injected dependencies,@StateObject for injected objects,@ObservedObject var vm: ViewModel,@StateObject var vm: ViewModel (injected),High,https://developer.apple.com/documentation/swiftui/observedobject
+9,State,Use @EnvironmentObject for shared state,App-wide state injection,@EnvironmentObject for global state,Prop drilling through views,@EnvironmentObject var settings: Settings,Pass settings through 5 views,Medium,https://developer.apple.com/documentation/swiftui/environmentobject
+10,State,Use @Published in ObservableObject,Automatically publish property changes,@Published for observed properties,Manual objectWillChange calls,@Published var items: [Item] = [],var items: [Item] { didSet { objectWillChange.send() } },Medium,
+11,Observable,Use @Observable macro (iOS 17+),Modern observation without Combine,@Observable class for view models,ObservableObject for new projects,@Observable class ViewModel { },class ViewModel: ObservableObject,Medium,https://developer.apple.com/documentation/observation
+12,Observable,Use @Bindable for @Observable,Create bindings from @Observable,@Bindable var vm for bindings,@Binding with @Observable,@Bindable var viewModel,$viewModel.name with @Observable,Medium,
+13,Layout,Use VStack HStack ZStack,Standard stack-based layouts,Stacks for linear arrangements,GeometryReader for simple layouts,VStack { Text() Image() },GeometryReader for vertical list,Medium,https://developer.apple.com/documentation/swiftui/vstack
+14,Layout,Use LazyVStack LazyHStack for lists,Lazy loading for performance,Lazy stacks for long lists,Regular stacks for 100+ items,LazyVStack { ForEach(items) },VStack { ForEach(largeArray) },High,https://developer.apple.com/documentation/swiftui/lazyvstack
+15,Layout,Use GeometryReader sparingly,Only when needed for sizing,GeometryReader for responsive layouts,GeometryReader everywhere,GeometryReader for aspect ratio,GeometryReader wrapping everything,Medium,
+16,Layout,Use spacing and padding consistently,Consistent spacing throughout app,Design system spacing values,Magic numbers for spacing,.padding(16) or .padding(),".padding(13), .padding(17)",Low,
+17,Layout,Use frame modifiers correctly,Set explicit sizes when needed,.frame(maxWidth: .infinity),Fixed sizes for responsive content,.frame(maxWidth: .infinity),.frame(width: 375),Medium,
+18,Modifiers,Order modifiers correctly,Modifier order affects rendering,Background before padding for full coverage,Wrong modifier order,.padding().background(Color.red),.background(Color.red).padding(),High,
+19,Modifiers,Create custom ViewModifiers,Reusable modifier combinations,ViewModifier for repeated styling,Duplicate modifier chains,struct CardStyle: ViewModifier,.shadow().cornerRadius() everywhere,Medium,https://developer.apple.com/documentation/swiftui/viewmodifier
+20,Modifiers,Use conditional modifiers carefully,Avoid changing view identity,if-else with same view type,Conditional that changes view identity,Text(title).foregroundColor(isActive ? .blue : .gray),if isActive { Text().bold() } else { Text() },Medium,
+21,Navigation,Use NavigationStack (iOS 16+),Modern navigation with type-safe paths,NavigationStack with navigationDestination,NavigationView for new projects,NavigationStack { },NavigationView { } (deprecated),Medium,https://developer.apple.com/documentation/swiftui/navigationstack
+22,Navigation,Use navigationDestination,Type-safe navigation destinations,.navigationDestination(for:),NavigationLink(destination:),.navigationDestination(for: Item.self),NavigationLink(destination: DetailView()),Medium,
+23,Navigation,Use @Environment for dismiss,Programmatic navigation dismissal,@Environment(\.dismiss) var dismiss,presentationMode (deprecated),@Environment(\.dismiss) var dismiss,@Environment(\.presentationMode),Low,
+24,Lists,Use List for scrollable content,Built-in scrolling and styling,List for standard scrollable content,ScrollView + VStack for simple lists,List { ForEach(items) { } },ScrollView { VStack { ForEach } },Low,https://developer.apple.com/documentation/swiftui/list
+25,Lists,Provide stable identifiers,Use Identifiable or explicit id,Identifiable protocol or id parameter,Index as identifier,ForEach(items) where Item: Identifiable,"ForEach(items.indices, id: \.self)",High,
+26,Lists,Use onDelete and onMove,Standard list editing,onDelete for swipe to delete,Custom delete implementation,.onDelete(perform: delete),.onTapGesture for delete,Low,
+27,Forms,Use Form for settings,Grouped input controls,Form for settings screens,Manual grouping for forms,Form { Section { Toggle() } },VStack { Toggle() },Low,https://developer.apple.com/documentation/swiftui/form
+28,Forms,Use @FocusState for keyboard,Manage keyboard focus,@FocusState for text field focus,Manual first responder handling,@FocusState private var isFocused: Bool,UIKit first responder,Medium,https://developer.apple.com/documentation/swiftui/focusstate
+29,Forms,Validate input properly,Show validation feedback,Real-time validation feedback,Submit without validation,TextField with validation state,TextField without error handling,Medium,
+30,Async,Use .task for async work,Automatic cancellation on view disappear,.task for view lifecycle async,onAppear with Task,.task { await loadData() },onAppear { Task { await loadData() } },Medium,https://developer.apple.com/documentation/swiftui/view/task(priority:_:)
+31,Async,Handle loading states,Show progress during async operations,ProgressView during loading,Empty view during load,if isLoading { ProgressView() },No loading indicator,Medium,
+32,Async,Use @MainActor for UI updates,Ensure UI updates on main thread,@MainActor on view models,Manual DispatchQueue.main,@MainActor class ViewModel,DispatchQueue.main.async,Medium,
+33,Animation,Use withAnimation,Animate state changes,withAnimation for state transitions,No animation for state changes,withAnimation { isExpanded.toggle() },isExpanded.toggle(),Low,https://developer.apple.com/documentation/swiftui/withanimation(_:_:)
+34,Animation,Use .animation modifier,Apply animations to views,.animation(.spring()) on view,Manual animation timing,.animation(.easeInOut),CABasicAnimation equivalent,Low,
+35,Animation,Respect reduced motion,Check accessibility settings,Check accessibilityReduceMotion,Ignore motion preferences,@Environment(\.accessibilityReduceMotion),Always animate regardless,High,
+36,Preview,Use #Preview macro (Xcode 15+),Modern preview syntax,#Preview for view previews,PreviewProvider protocol,#Preview { ContentView() },struct ContentView_Previews: PreviewProvider,Low,
+37,Preview,Create multiple previews,Test different states and devices,Multiple previews for states,Single preview only,"#Preview(""Light"") { } #Preview(""Dark"") { }",Single preview configuration,Low,
+38,Preview,Use preview data,Dedicated preview mock data,Static preview data,Production data in previews,Item.preview for preview,Fetch real data in preview,Low,
+39,Performance,Avoid expensive body computations,Body should be fast to compute,Precompute in view model,Heavy computation in body,vm.computedValue in body,Complex calculation in body,High,
+40,Performance,Use Equatable views,Skip unnecessary view updates,Equatable for complex views,Default equality for all views,struct MyView: View Equatable,No Equatable conformance,Medium,
+41,Performance,Profile with Instruments,Measure before optimizing,Use SwiftUI Instruments,Guess at performance issues,Profile with Instruments,Optimize without measuring,Medium,
+42,Accessibility,Add accessibility labels,Describe UI elements,.accessibilityLabel for context,Missing labels,".accessibilityLabel(""Close button"")",Button without label,High,https://developer.apple.com/documentation/swiftui/view/accessibilitylabel(_:)-1d7jv
+43,Accessibility,Support Dynamic Type,Respect text size preferences,Scalable fonts and layouts,Fixed font sizes,.font(.body) with Dynamic Type,.font(.system(size: 16)),High,
+44,Accessibility,Use semantic views,Proper accessibility traits,Correct accessibilityTraits,Wrong semantic meaning,Button for actions Image for display,Image that acts like button,Medium,
+45,Testing,Use ViewInspector for testing,Third-party view testing,ViewInspector for unit tests,UI tests only,ViewInspector assertions,Only XCUITest,Medium,
+46,Testing,Test view models,Unit test business logic,XCTest for view model,Skip view model testing,Test ViewModel methods,No unit tests,Medium,
+47,Testing,Use preview as visual test,Previews catch visual regressions,Multiple preview configurations,No visual verification,Preview different states,Single preview only,Low,
+48,Architecture,Use MVVM pattern,Separate view and logic,ViewModel for business logic,Logic in View,ObservableObject ViewModel,@State for complex logic,Medium,
+49,Architecture,Keep views dumb,Views display view model state,View reads from ViewModel,Business logic in View,view.items from vm.items,Complex filtering in View,Medium,
+50,Architecture,Use dependency injection,Inject dependencies for testing,Initialize with dependencies,Hard-coded dependencies,init(service: ServiceProtocol),let service = RealService(),Medium,
diff --git a/.claude/skills/ui-ux-pro-max/data/stacks/vue.csv b/.claude/skills/ui-ux-pro-max/data/stacks/vue.csv
new file mode 100644
index 0000000..77cb4b0
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/stacks/vue.csv
@@ -0,0 +1,50 @@
+No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
+1,Composition,Use Composition API for new projects,Composition API offers better TypeScript support and logic reuse,<script setup> for components,Options API for new projects,<script setup>,export default { data() },Medium,https://vuejs.org/guide/extras/composition-api-faq.html
+2,Composition,Use script setup syntax,Cleaner syntax with automatic exports,<script setup> with defineProps,setup() function manually,<script setup>,<script> setup() { return {} },Low,https://vuejs.org/api/sfc-script-setup.html
+3,Reactivity,Use ref for primitives,ref() for primitive values that need reactivity,ref() for strings numbers booleans,reactive() for primitives,const count = ref(0),const count = reactive(0),Medium,https://vuejs.org/guide/essentials/reactivity-fundamentals.html
+4,Reactivity,Use reactive for objects,reactive() for complex objects and arrays,reactive() for objects with multiple properties,ref() for complex objects,const state = reactive({ user: null }),const state = ref({ user: null }),Medium,
+5,Reactivity,Access ref values with .value,Remember .value in script unwrap in template,Use .value in script,Forget .value in script,count.value++,count++ (in script),High,
+6,Reactivity,Use computed for derived state,Computed properties cache and update automatically,computed() for derived values,Methods for derived values,const doubled = computed(() => count.value * 2),const doubled = () => count.value * 2,Medium,https://vuejs.org/guide/essentials/computed.html
+7,Reactivity,Use shallowRef for large objects,Avoid deep reactivity for performance,shallowRef for large data structures,ref for large nested objects,const bigData = shallowRef(largeObject),const bigData = ref(largeObject),Medium,https://vuejs.org/api/reactivity-advanced.html#shallowref
+8,Watchers,Use watchEffect for simple cases,Auto-tracks dependencies,watchEffect for simple reactive effects,watch with explicit deps when not needed,watchEffect(() => console.log(count.value)),"watch(count, (val) => console.log(val))",Low,https://vuejs.org/guide/essentials/watchers.html
+9,Watchers,Use watch for specific sources,Explicit control over what to watch,watch with specific refs,watchEffect for complex conditional logic,"watch(userId, fetchUser)",watchEffect with conditionals,Medium,
+10,Watchers,Clean up side effects,Return cleanup function in watchers,Return cleanup in watchEffect,Leave subscriptions open,watchEffect((onCleanup) => { onCleanup(unsub) }),watchEffect without cleanup,High,
+11,Props,Define props with defineProps,Type-safe prop definitions,defineProps with TypeScript,Props without types,defineProps<{ msg: string }>(),defineProps(['msg']),Medium,https://vuejs.org/guide/typescript/composition-api.html#typing-component-props
+12,Props,Use withDefaults for default values,Provide defaults for optional props,withDefaults with defineProps,Defaults in destructuring,"withDefaults(defineProps<Props>(), { count: 0 })",const { count = 0 } = defineProps(),Medium,
+13,Props,Avoid mutating props,Props should be read-only,Emit events to parent for changes,Direct prop mutation,"emit('update:modelValue', newVal)",props.modelValue = newVal,High,
+14,Emits,Define emits with defineEmits,Type-safe event emissions,defineEmits with types,Emit without definition,defineEmits<{ change: [id: number] }>(),"emit('change', id) without define",Medium,https://vuejs.org/guide/typescript/composition-api.html#typing-component-emits
+15,Emits,Use v-model for two-way binding,Simplified parent-child data flow,v-model with modelValue prop,:value + @input manually,"<Child v-model=""value""/>","<Child :value=""value"" @input=""value = $event""/>",Low,https://vuejs.org/guide/components/v-model.html
+16,Lifecycle,Use onMounted for DOM access,DOM is ready in onMounted,onMounted for DOM operations,Access DOM in setup directly,onMounted(() => el.value.focus()),el.value.focus() in setup,High,https://vuejs.org/api/composition-api-lifecycle.html
+17,Lifecycle,Clean up in onUnmounted,Remove listeners and subscriptions,onUnmounted for cleanup,Leave listeners attached,onUnmounted(() => window.removeEventListener()),No cleanup on unmount,High,
+18,Lifecycle,Avoid onBeforeMount for data,Use onMounted or setup for data fetching,Fetch in onMounted or setup,Fetch in onBeforeMount,onMounted(async () => await fetchData()),onBeforeMount(async () => await fetchData()),Low,
+19,Components,Use single-file components,Keep template script style together,.vue files for components,Separate template/script files,Component.vue with all parts,Component.js + Component.html,Low,
+20,Components,Use PascalCase for components,Consistent component naming,PascalCase in imports and templates,kebab-case in script,<MyComponent/>,<my-component/>,Low,https://vuejs.org/style-guide/rules-strongly-recommended.html
+21,Components,Prefer composition over mixins,Composables replace mixins,Composables for shared logic,Mixins for code reuse,const { data } = useApi(),mixins: [apiMixin],Medium,
+22,Composables,Name composables with use prefix,Convention for composable functions,useFetch useAuth useForm,getData or fetchApi,export function useFetch(),export function fetchData(),Medium,https://vuejs.org/guide/reusability/composables.html
+23,Composables,Return refs from composables,Maintain reactivity when destructuring,Return ref values,Return reactive objects that lose reactivity,return { data: ref(null) },return reactive({ data: null }),Medium,
+24,Composables,Accept ref or value params,Use toValue for flexible inputs,toValue() or unref() for params,Only accept ref or only value,const val = toValue(maybeRef),const val = maybeRef.value,Low,https://vuejs.org/api/reactivity-utilities.html#tovalue
+25,Templates,Use v-bind shorthand,Cleaner template syntax,:prop instead of v-bind:prop,Full v-bind syntax,"<div :class=""cls"">","<div v-bind:class=""cls"">",Low,
+26,Templates,Use v-on shorthand,Cleaner event binding,@event instead of v-on:event,Full v-on syntax,"<button @click=""handler"">","<button v-on:click=""handler"">",Low,
+27,Templates,Avoid v-if with v-for,v-if has higher priority causes issues,Wrap in template or computed filter,v-if on same element as v-for,<template v-for><div v-if>,<div v-for v-if>,High,https://vuejs.org/style-guide/rules-essential.html#avoid-v-if-with-v-for
+28,Templates,Use key with v-for,Proper list rendering and updates,Unique key for each item,Index as key for dynamic lists,"v-for=""item in items"" :key=""item.id""","v-for=""(item, i) in items"" :key=""i""",High,
+29,State,Use Pinia for global state,Official state management for Vue 3,Pinia stores for shared state,Vuex for new projects,const store = useCounterStore(),Vuex with mutations,Medium,https://pinia.vuejs.org/
+30,State,Define stores with defineStore,Composition API style stores,Setup stores with defineStore,Options stores for complex state,"defineStore('counter', () => {})","defineStore('counter', { state })",Low,
+31,State,Use storeToRefs for destructuring,Maintain reactivity when destructuring,storeToRefs(store),Direct destructuring,const { count } = storeToRefs(store),const { count } = store,High,https://pinia.vuejs.org/core-concepts/#destructuring-from-a-store
+32,Routing,Use useRouter and useRoute,Composition API router access,useRouter() useRoute() in setup,this.$router this.$route,const router = useRouter(),this.$router.push(),Medium,https://router.vuejs.org/guide/advanced/composition-api.html
+33,Routing,Lazy load route components,Code splitting for routes,() => import() for components,Static imports for all routes,component: () => import('./Page.vue'),component: Page,Medium,https://router.vuejs.org/guide/advanced/lazy-loading.html
+34,Routing,Use navigation guards,Protect routes and handle redirects,beforeEach for auth checks,Check auth in each component,router.beforeEach((to) => {}),Check auth in onMounted,Medium,
+35,Performance,Use v-once for static content,Skip re-renders for static elements,v-once on never-changing content,v-once on dynamic content,<div v-once>{{ staticText }}</div>,<div v-once>{{ dynamicText }}</div>,Low,https://vuejs.org/api/built-in-directives.html#v-once
+36,Performance,Use v-memo for expensive lists,Memoize list items,v-memo with dependency array,Re-render entire list always,"<div v-for v-memo=""[item.id]"">",<div v-for> without memo,Medium,https://vuejs.org/api/built-in-directives.html#v-memo
+37,Performance,Use shallowReactive for flat objects,Avoid deep reactivity overhead,shallowReactive for flat state,reactive for simple objects,shallowReactive({ count: 0 }),reactive({ count: 0 }),Low,
+38,Performance,Use defineAsyncComponent,Lazy load heavy components,defineAsyncComponent for modals dialogs,Import all components eagerly,defineAsyncComponent(() => import()),import HeavyComponent from,Medium,https://vuejs.org/guide/components/async.html
+39,TypeScript,Use generic components,Type-safe reusable components,Generic with defineComponent,Any types in components,"<script setup lang=""ts"" generic=""T"">",<script setup> without types,Medium,https://vuejs.org/guide/typescript/composition-api.html
+40,TypeScript,Type template refs,Proper typing for DOM refs,ref<HTMLInputElement>(null),ref(null) without type,const input = ref<HTMLInputElement>(null),const input = ref(null),Medium,
+41,TypeScript,Use PropType for complex props,Type complex prop types,PropType<User> for object props,Object without type,type: Object as PropType<User>,type: Object,Medium,
+42,Testing,Use Vue Test Utils,Official testing library,mount shallowMount for components,Manual DOM testing,import { mount } from '@vue/test-utils',document.createElement,Medium,https://test-utils.vuejs.org/
+43,Testing,Test component behavior,Focus on inputs and outputs,Test props emit and rendered output,Test internal implementation,expect(wrapper.text()).toContain(),expect(wrapper.vm.internalState),Medium,
+44,Forms,Use v-model modifiers,Built-in input handling,.lazy .number .trim modifiers,Manual input parsing,"<input v-model.number=""age"">","<input v-model=""age""> then parse",Low,https://vuejs.org/guide/essentials/forms.html#modifiers
+45,Forms,Use VeeValidate or FormKit,Form validation libraries,VeeValidate for complex forms,Manual validation logic,useField useForm from vee-validate,Custom validation in each input,Medium,
+46,Accessibility,Use semantic elements,Proper HTML elements in templates,button nav main for purpose,div for everything,<button @click>,<div @click>,High,
+47,Accessibility,Bind aria attributes dynamically,Keep ARIA in sync with state,":aria-expanded=""isOpen""",Static ARIA values,":aria-expanded=""menuOpen""","aria-expanded=""true""",Medium,
+48,SSR,Use Nuxt for SSR,Full-featured SSR framework,Nuxt 3 for SSR apps,Manual SSR setup,npx nuxi init my-app,Custom SSR configuration,Medium,https://nuxt.com/
+49,SSR,Handle hydration mismatches,Client/server content must match,ClientOnly for browser-only content,Different content server/client,<ClientOnly><BrowserWidget/></ClientOnly>,<div>{{ Date.now() }}</div>,High,
diff --git a/.claude/skills/ui-ux-pro-max/data/styles.csv b/.claude/skills/ui-ux-pro-max/data/styles.csv
new file mode 100644
index 0000000..6d60c4d
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/styles.csv
@@ -0,0 +1,59 @@
+STT,Style Category,Type,Keywords,Primary Colors,Secondary Colors,Effects & Animation,Best For,Do Not Use For,Light Mode ✓,Dark Mode ✓,Performance,Accessibility,Mobile-Friendly,Conversion-Focused,Framework Compatibility,Era/Origin,Complexity
+1,Minimalism & Swiss Style,General,"Clean, simple, spacious, functional, white space, high contrast, geometric, sans-serif, grid-based, essential","Monochromatic, Black #000000, White #FFFFFF","Neutral (Beige #F5F1E8, Grey #808080, Taupe #B38B6D), Primary accent","Subtle hover (200-250ms), smooth transitions, sharp shadows if any, clear type hierarchy, fast loading","Enterprise apps, dashboards, documentation sites, SaaS platforms, professional tools","Creative portfolios, entertainment, playful brands, artistic experiments",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,◐ Medium,"Tailwind 10/10, Bootstrap 9/10, MUI 9/10",1950s Swiss,Low
+2,Neumorphism,General,"Soft UI, embossed, debossed, convex, concave, light source, subtle depth, rounded (12-16px), monochromatic","Light pastels: Soft Blue #C8E0F4, Soft Pink #F5E0E8, Soft Grey #E8E8E8","Tints/shades (±30%), gradient subtlety, color harmony","Soft box-shadow (multiple: -5px -5px 15px, 5px 5px 15px), smooth press (150ms), inner subtle shadow","Health/wellness apps, meditation platforms, fitness trackers, minimal interaction UIs","Complex apps, critical accessibility, data-heavy dashboards, high-contrast required",✓ Full,◐ Partial,⚡ Good,⚠ Low contrast,✓ Good,◐ Medium,"Tailwind 8/10, CSS-in-JS 9/10",2020s Modern,Medium
+3,Glassmorphism,General,"Frosted glass, transparent, blurred background, layered, vibrant background, light source, depth, multi-layer","Translucent white: rgba(255,255,255,0.1-0.3)","Vibrant: Electric Blue #0080FF, Neon Purple #8B00FF, Vivid Pink #FF1493, Teal #20B2AA","Backdrop blur (10-20px), subtle border (1px solid rgba white 0.2), light reflection, Z-depth","Modern SaaS, financial dashboards, high-end corporate, lifestyle apps, modal overlays, navigation","Low-contrast backgrounds, critical accessibility, performance-limited, dark text on dark",✓ Full,✓ Full,⚠ Good,⚠ Ensure 4.5:1,✓ Good,✓ High,"Tailwind 9/10, MUI 8/10, Chakra 8/10",2020s Modern,Medium
+4,Brutalism,General,"Raw, unpolished, stark, high contrast, plain text, default fonts, visible borders, asymmetric, anti-design","Primary: Red #FF0000, Blue #0000FF, Yellow #FFFF00, Black #000000, White #FFFFFF","Limited: Neon Green #00FF00, Hot Pink #FF00FF, minimal secondary","No smooth transitions (instant), sharp corners (0px), bold typography (700+), visible grid, large blocks","Design portfolios, artistic projects, counter-culture brands, editorial/media sites, tech blogs","Corporate environments, conservative industries, critical accessibility, customer-facing professional",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,◐ Medium,✗ Low,"Tailwind 10/10, Bootstrap 7/10",1950s Brutalist,Low
+5,3D & Hyperrealism,General,"Depth, realistic textures, 3D models, spatial navigation, tactile, skeuomorphic elements, rich detail, immersive","Deep Navy #001F3F, Forest Green #228B22, Burgundy #800020, Gold #FFD700, Silver #C0C0C0","Complex gradients (5-10 stops), realistic lighting, shadow variations (20-40% darker)","WebGL/Three.js 3D, realistic shadows (layers), physics lighting, parallax (3-5 layers), smooth 3D (300-400ms)","Gaming, product showcase, immersive experiences, high-end e-commerce, architectural viz, VR/AR","Low-end mobile, performance-limited, critical accessibility, data tables/forms",◐ Partial,◐ Partial,❌ Poor,⚠ Not accessible,✗ Low,◐ Medium,"Three.js 10/10, R3F 10/10, Babylon.js 10/10",2020s Modern,High
+6,Vibrant & Block-based,General,"Bold, energetic, playful, block layout, geometric shapes, high color contrast, duotone, modern, energetic","Neon Green #39FF14, Electric Purple #BF00FF, Vivid Pink #FF1493, Bright Cyan #00FFFF, Sunburst #FFAA00","Complementary: Orange #FF7F00, Shocking Pink #FF006E, Lime #CCFF00, triadic schemes","Large sections (48px+ gaps), animated patterns, bold hover (color shift), scroll-snap, large type (32px+), 200-300ms","Startups, creative agencies, gaming, social media, youth-focused, entertainment, consumer","Financial institutions, healthcare, formal business, government, conservative, elderly",✓ Full,✓ Full,⚡ Good,◐ Ensure WCAG,✓ High,✓ High,"Tailwind 10/10, Chakra 9/10, Styled 9/10",2020s Modern,Medium
+7,Dark Mode (OLED),General,"Dark theme, low light, high contrast, deep black, midnight blue, eye-friendly, OLED, night mode, power efficient","Deep Black #000000, Dark Grey #121212, Midnight Blue #0A0E27","Vibrant accents: Neon Green #39FF14, Electric Blue #0080FF, Gold #FFD700, Plasma Purple #BF00FF","Minimal glow (text-shadow: 0 0 10px), dark-to-light transitions, low white emission, high readability, visible focus","Night-mode apps, coding platforms, entertainment, eye-strain prevention, OLED devices, low-light","Print-first content, high-brightness outdoor, color-accuracy-critical",✗ No,✓ Only,⚡ Excellent,✓ WCAG AAA,✓ High,◐ Low,"Tailwind 10/10, MUI 10/10, Chakra 10/10",2020s Modern,Low
+8,Accessible & Ethical,General,"High contrast, large text (16px+), keyboard navigation, screen reader friendly, WCAG compliant, focus state, semantic","WCAG AA/AAA (4.5:1 min), simple primary, clear secondary, high luminosity (7:1+)","Symbol-based colors (not color-only), supporting patterns, inclusive combinations","Clear focus rings (3-4px), ARIA labels, skip links, responsive design, reduced motion, 44x44px touch targets","Government, healthcare, education, inclusive products, large audience, legal compliance, public",None - accessibility universal,✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"All frameworks 10/10",Universal,Low
+9,Claymorphism,General,"Soft 3D, chunky, playful, toy-like, bubbly, thick borders (3-4px), double shadows, rounded (16-24px)","Pastel: Soft Peach #FDBCB4, Baby Blue #ADD8E6, Mint #98FF98, Lilac #E6E6FA, light BG","Soft gradients (pastel-to-pastel), light/dark variations (20-30%), gradient subtle","Inner+outer shadows (subtle, no hard lines), soft press (200ms ease-out), fluffy elements, smooth transitions","Educational apps, children's apps, SaaS platforms, creative tools, fun-focused, onboarding, casual games","Formal corporate, professional services, data-critical, serious/medical, legal apps, finance",✓ Full,◐ Partial,⚡ Good,⚠ Ensure 4.5:1,✓ High,✓ High,"Tailwind 9/10, CSS-in-JS 9/10",2020s Modern,Medium
+10,Aurora UI,General,"Vibrant gradients, smooth blend, Northern Lights effect, mesh gradient, luminous, atmospheric, abstract","Complementary: Blue-Orange, Purple-Yellow, Electric Blue #0080FF, Magenta #FF1493, Cyan #00FFFF","Smooth transitions (Blue→Purple→Pink→Teal), iridescent effects, blend modes (screen, multiply)","Large flowing CSS/SVG gradients, subtle 8-12s animations, depth via color layering, smooth morph","Modern SaaS, creative agencies, branding, music platforms, lifestyle, premium products, hero sections","Data-heavy dashboards, critical accessibility, content-heavy where distraction issues",✓ Full,✓ Full,⚠ Good,⚠ Text contrast,✓ Good,✓ High,"Tailwind 9/10, CSS-in-JS 10/10",2020s Modern,Medium
+11,Retro-Futurism,General,"Vintage sci-fi, 80s aesthetic, neon glow, geometric patterns, CRT scanlines, pixel art, cyberpunk, synthwave","Neon Blue #0080FF, Hot Pink #FF006E, Cyan #00FFFF, Deep Black #1A1A2E, Purple #5D34D0","Metallic Silver #C0C0C0, Gold #FFD700, duotone, 80s Pink #FF10F0, neon accents","CRT scanlines (::before overlay), neon glow (text-shadow+box-shadow), glitch effects (skew/offset keyframes)","Gaming, entertainment, music platforms, tech brands, artistic projects, nostalgic, cyberpunk","Conservative industries, critical accessibility, professional/corporate, elderly, legal/finance",✓ Full,✓ Dark focused,⚠ Moderate,⚠ High contrast/strain,◐ Medium,◐ Medium,"Tailwind 8/10, CSS-in-JS 9/10",1980s Retro,Medium
+12,Flat Design,General,"2D, minimalist, bold colors, no shadows, clean lines, simple shapes, typography-focused, modern, icon-heavy","Solid bright: Red, Orange, Blue, Green, limited palette (4-6 max)","Complementary colors, muted secondaries, high saturation, clean accents","No gradients/shadows, simple hover (color/opacity shift), fast loading, clean transitions (150-200ms ease), minimal icons","Web apps, mobile apps, cross-platform, startup MVPs, user-friendly, SaaS, dashboards, corporate","Complex 3D, premium/luxury, artistic portfolios, immersive experiences, high-detail",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Bootstrap 10/10, MUI 9/10",2010s Modern,Low
+13,Skeuomorphism,General,"Realistic, texture, depth, 3D appearance, real-world metaphors, shadows, gradients, tactile, detailed, material","Rich realistic: wood, leather, metal colors, detailed gradients (8-12 stops), metallic effects","Realistic lighting gradients, shadow variations (30-50% darker), texture overlays, material colors","Realistic shadows (layers), depth (perspective), texture details (noise, grain), realistic animations (300-500ms)","Legacy apps, gaming, immersive storytelling, premium products, luxury, realistic simulations, education","Modern enterprise, critical accessibility, low-performance, web (use Flat/Modern)",◐ Partial,◐ Partial,❌ Poor,⚠ Textures reduce readability,✗ Low,◐ Medium,"CSS-in-JS 7/10, Custom 8/10",2007-2012 iOS,High
+14,Liquid Glass,General,"Flowing glass, morphing, smooth transitions, fluid effects, translucent, animated blur, iridescent, chromatic aberration","Vibrant iridescent (rainbow spectrum), translucent base with opacity shifts, gradient fluidity","Chromatic aberration (Red-Cyan), iridescent oil-spill, fluid gradient blends, holographic effects","Morphing elements (SVG/CSS), fluid animations (400-600ms curves), dynamic blur (backdrop-filter), color transitions","Premium SaaS, high-end e-commerce, creative platforms, branding experiences, luxury portfolios","Performance-limited, critical accessibility, complex data, budget projects",✓ Full,✓ Full,⚠ Moderate-Poor,⚠ Text contrast,◐ Medium,✓ High,"Framer Motion 10/10, GSAP 10/10",2020s Modern,High
+15,Motion-Driven,General,"Animation-heavy, microinteractions, smooth transitions, scroll effects, parallax, entrance anim, page transitions","Bold colors emphasize movement, high contrast animated, dynamic gradients, accent action colors","Transitional states, success (Green #22C55E), error (Red #EF4444), neutral feedback","Scroll anim (Intersection Observer), hover (300-400ms), entrance, parallax (3-5 layers), page transitions","Portfolio sites, storytelling platforms, interactive experiences, entertainment apps, creative, SaaS","Data dashboards, critical accessibility, low-power devices, content-heavy, motion-sensitive",✓ Full,✓ Full,⚠ Good,⚠ Prefers-reduced-motion,✓ Good,✓ High,"GSAP 10/10, Framer Motion 10/10",2020s Modern,High
+16,Micro-interactions,General,"Small animations, gesture-based, tactile feedback, subtle animations, contextual interactions, responsive","Subtle color shifts (10-20%), feedback: Green #22C55E, Red #EF4444, Amber #F59E0B","Accent feedback, neutral supporting, clear action indicators","Small hover (50-100ms), loading spinners, success/error state anim, gesture-triggered (swipe/pinch), haptic","Mobile apps, touchscreen UIs, productivity tools, user-friendly, consumer apps, interactive components","Desktop-only, critical performance, accessibility-first (alternatives needed)",✓ Full,✓ Full,⚡ Excellent,✓ Good,✓ High,✓ High,"Framer Motion 10/10, React Spring 9/10",2020s Modern,Medium
+17,Inclusive Design,General,"Accessible, color-blind friendly, high contrast, haptic feedback, voice interaction, screen reader, WCAG AAA, universal","WCAG AAA (7:1+ contrast), avoid red-green only, symbol-based indicators, high contrast primary","Supporting patterns (stripes, dots, hatch), symbols, combinations, clear non-color indicators","Haptic feedback (vibration), voice guidance, focus indicators (4px+ ring), motion options, alt content, semantic","Public services, education, healthcare, finance, government, accessible consumer, inclusive",None - accessibility universal,✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"All frameworks 10/10",Universal,Low
+18,Zero Interface,General,"Minimal visible UI, voice-first, gesture-based, AI-driven, invisible controls, predictive, context-aware, ambient","Neutral backgrounds: Soft white #FAFAFA, light grey #F0F0F0, warm off-white #F5F1E8","Subtle feedback: light green, light red, minimal UI elements, soft accents","Voice recognition UI, gesture detection, AI predictions (smooth reveal), progressive disclosure, smart suggestions","Voice assistants, AI platforms, future-forward UX, smart home, contextual computing, ambient experiences","Complex workflows, data-entry heavy, traditional systems, legacy support, explicit control",✓ Full,✓ Full,⚡ Excellent,✓ Excellent,✓ High,✓ High,"Tailwind 10/10, Custom 10/10",2020s AI-Era,Low
+19,Soft UI Evolution,General,"Evolved soft UI, better contrast, modern aesthetics, subtle depth, accessibility-focused, improved shadows, hybrid","Improved contrast pastels: Soft Blue #87CEEB, Soft Pink #FFB6C1, Soft Green #90EE90, better hierarchy","Better combinations, accessible secondary, supporting with improved contrast, modern accents","Improved shadows (softer than flat, clearer than neumorphism), modern (200-300ms), focus visible, WCAG AA/AAA","Modern enterprise apps, SaaS platforms, health/wellness, modern business tools, professional, hybrid","Extreme minimalism, critical performance, systems without modern OS",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA+,✓ High,✓ High,"Tailwind 9/10, MUI 9/10, Chakra 9/10",2020s Modern,Medium
+20,Hero-Centric Design,Landing Page,"Large hero section, compelling headline, high-contrast CTA, product showcase, value proposition, hero image/video, dramatic visual","Brand primary color, white/light backgrounds for contrast, accent color for CTA","Supporting colors for secondary CTAs, accent highlights, trust elements (testimonials, logos)","Smooth scroll reveal, fade-in animations on hero, subtle background parallax, CTA glow/pulse effect","SaaS landing pages, product launches, service landing pages, B2B platforms, tech companies","Complex navigation, multi-page experiences, data-heavy applications",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Full,✓ Very High,"Tailwind 10/10, Bootstrap 9/10",2020s Modern,Medium
+21,Conversion-Optimized,Landing Page,"Form-focused, minimalist design, single CTA focus, high contrast, urgency elements, trust signals, social proof, clear value","Primary brand color, high-contrast white/light backgrounds, warning/urgency colors for time-limited offers","Secondary CTA color (muted), trust element colors (testimonial highlights), accent for key benefits","Hover states on CTA (color shift, slight scale), form field focus animations, loading spinner, success feedback","E-commerce product pages, free trial signups, lead generation, SaaS pricing pages, limited-time offers","Complex feature explanations, multi-product showcases, technical documentation",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ Full (mobile-optimized),✓ Very High
+22,Feature-Rich Showcase,Landing Page,"Multiple feature sections, grid layout, benefit cards, visual feature demonstrations, interactive elements, problem-solution pairs","Primary brand, bright secondary colors for feature cards, contrasting accent for CTAs","Supporting colors for: benefits (green), problems (red/orange), features (blue/purple), social proof (neutral)","Card hover effects (lift/scale), icon animations on scroll, feature toggle animations, smooth section transitions","Enterprise SaaS, software tools landing pages, platform services, complex product explanations, B2B products","Simple product pages, early-stage startups with few features, entertainment landing pages",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Good,✓ High
+23,Minimal & Direct,Landing Page,"Minimal text, white space heavy, single column layout, direct messaging, clean typography, visual-centric, fast-loading","Monochromatic primary, white background, single accent color for CTA, black/dark grey text","Minimal secondary colors, reserved for critical CTAs only, neutral supporting elements","Very subtle hover effects, minimal animations, fast page load (no heavy animations), smooth scroll","Simple service landing pages, indie products, consulting services, micro SaaS, freelancer portfolios","Feature-heavy products, complex explanations, multi-product showcases",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ Full,✓ High
+24,Social Proof-Focused,Landing Page,"Testimonials prominent, client logos displayed, case studies sections, reviews/ratings, user avatars, success metrics, credibility markers","Primary brand, trust colors (blue), success/growth colors (green), neutral backgrounds","Testimonial highlight colors, logo grid backgrounds (light grey), badge/achievement colors","Testimonial carousel animations, logo grid fade-in, stat counter animations (number count-up), review star ratings","B2B SaaS, professional services, premium products, e-commerce conversion pages, established brands","Startup MVPs, products without users, niche/experimental products",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Full,✓ High
+25,Interactive Product Demo,Landing Page,"Embedded product mockup/video, interactive elements, product walkthrough, step-by-step guides, hover-to-reveal features, embedded demos","Primary brand, interface colors matching product, demo highlight colors for interactive elements","Product UI colors, tutorial step colors (numbered progression), hover state indicators","Product animation playback, step progression animations, hover reveal effects, smooth zoom on interaction","SaaS platforms, tool/software products, productivity apps landing pages, developer tools, productivity software","Simple services, consulting, non-digital products, complexity-averse audiences",✓ Full,✓ Full,⚠ Good (video/interactive),✓ WCAG AA,✓ Good,✓ Very High
+26,Trust & Authority,Landing Page,"Certificates/badges displayed, expert credentials, case studies with metrics, before/after comparisons, industry recognition, security badges","Professional colors (blue/grey), trust colors, certification badge colors (gold/silver accents)","Certificate highlight colors, metric showcase colors, comparison highlight (success green)","Badge hover effects, metric pulse animations, certificate carousel, smooth stat reveal","Healthcare/medical landing pages, financial services, enterprise software, premium/luxury products, legal services","Casual products, entertainment, viral/social-first products",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ Full,✓ High
+27,Storytelling-Driven,Landing Page,"Narrative flow, visual story progression, section transitions, consistent character/brand voice, emotional messaging, journey visualization","Brand primary, warm/emotional colors, varied accent colors per story section, high visual variety","Story section color coding, emotional state colors (calm, excitement, success), transitional gradients","Section-to-section animations, scroll-triggered reveals, character/icon animations, morphing transitions, parallax narrative","Brand/startup stories, mission-driven products, premium/lifestyle brands, documentary-style products, educational","Technical/complex products (unless narrative-driven), traditional enterprise software",✓ Full,✓ Full,⚠ Moderate (animations),✓ WCAG AA,✓ Good,✓ High
+28,Data-Dense Dashboard,BI/Analytics,"Multiple charts/widgets, data tables, KPI cards, minimal padding, grid layout, space-efficient, maximum data visibility","Neutral primary (light grey/white #F5F5F5), data colors (blue/green/red), dark text #333333","Chart colors: success (green #22C55E), warning (amber #F59E0B), alert (red #EF4444), neutral (grey)","Hover tooltips, chart zoom on click, row highlighting on hover, smooth filter animations, data loading spinners","Business intelligence dashboards, financial analytics, enterprise reporting, operational dashboards, data warehousing","Marketing dashboards, consumer-facing analytics, simple reporting",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,◐ Medium,✗ Not applicable
+29,Heat Map & Heatmap Style,BI/Analytics,"Color-coded grid/matrix, data intensity visualization, geographical heat maps, correlation matrices, cell-based representation, gradient coloring","Gradient scale: Cool (blue #0080FF) to hot (red #FF0000), neutral middle (white/yellow)","Support gradients: Light (cool blue) to dark (warm red), divergent for positive/negative data, monochromatic options","Color gradient transitions on data change, cell highlighting on hover, tooltip reveal on click, smooth color animation","Geographical analysis, performance matrices, correlation analysis, user behavior heatmaps, temperature/intensity data","Linear data representation, categorical comparisons (use bar charts), small datasets",✓ Full,✓ Full (with adjustments),⚡ Excellent,⚠ Colorblind considerations,◐ Medium,✗ Not applicable
+30,Executive Dashboard,BI/Analytics,"High-level KPIs, large key metrics, minimal detail, summary view, trend indicators, at-a-glance insights, executive summary","Brand colors, professional palette (blue/grey/white), accent for KPIs, red for alerts/concerns","KPI highlight colors: positive (green), negative (red), neutral (grey), trend arrow colors","KPI value animations (count-up), trend arrow direction animations, metric card hover lift, alert pulse effect","C-suite dashboards, business summary reports, decision-maker dashboards, strategic planning views","Detailed analyst dashboards, technical deep-dives, operational monitoring",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✗ Low (not mobile-optimized),✗ Not applicable
+31,Real-Time Monitoring,BI/Analytics,"Live data updates, status indicators, alert notifications, streaming data visualization, active monitoring, streaming charts","Alert colors: critical (red #FF0000), warning (orange #FFA500), normal (green #22C55E), updating (blue animation)","Status indicator colors, chart line colors varying by metric, streaming data highlight colors","Real-time chart animations, alert pulse/glow, status indicator blink animation, smooth data stream updates, loading effect","System monitoring dashboards, DevOps dashboards, real-time analytics, stock market dashboards, live event tracking","Historical analysis, long-term trend reports, archived data dashboards",✓ Full,✓ Full,⚡ Good (real-time load),✓ WCAG AA,◐ Medium,✗ Not applicable
+32,Drill-Down Analytics,BI/Analytics,"Hierarchical data exploration, expandable sections, interactive drill-down paths, summary-to-detail flow, context preservation","Primary brand, breadcrumb colors, drill-level indicator colors, hierarchy depth colors","Drill-down path indicator colors, level-specific colors, highlight colors for selected level, transition colors","Drill-down expand animations, breadcrumb click transitions, smooth detail reveal, level change smooth, data reload animation","Sales analytics, product analytics, funnel analysis, multi-dimensional data exploration, business intelligence","Simple linear data, single-metric dashboards, streaming real-time dashboards",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,◐ Medium,✗ Not applicable
+33,Comparative Analysis Dashboard,BI/Analytics,"Side-by-side comparisons, period-over-period metrics, A/B test results, regional comparisons, performance benchmarks","Comparison colors: primary (blue), comparison (orange/purple), delta indicator (green/red)","Winning metric color (green), losing metric color (red), neutral comparison (grey), benchmark colors","Comparison bar animations (grow to value), delta indicator animations (direction arrows), highlight on compare","Period-over-period reporting, A/B test dashboards, market comparison, competitive analysis, regional performance","Single metric dashboards, future projections (use forecasting), real-time only (no historical)",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,◐ Medium,✗ Not applicable
+34,Predictive Analytics,BI/Analytics,"Forecast lines, confidence intervals, trend projections, scenario modeling, AI-driven insights, anomaly detection visualization","Forecast line color (distinct from actual), confidence interval shading, anomaly highlight (red alert), trend colors","High confidence (dark color), low confidence (light color), anomaly colors (red/orange), normal trend (green/blue)","Forecast line animation on draw, confidence band fade-in, anomaly pulse alert, smoothing function animations","Forecasting dashboards, anomaly detection systems, trend prediction dashboards, AI-powered analytics, budget planning","Historical-only dashboards, simple reporting, real-time operational dashboards",✓ Full,✓ Full,⚠ Good (computation),✓ WCAG AA,◐ Medium,✗ Not applicable
+35,User Behavior Analytics,BI/Analytics,"Funnel visualization, user flow diagrams, conversion tracking, engagement metrics, user journey mapping, cohort analysis","Funnel stage colors: high engagement (green), drop-off (red), conversion (blue), user flow arrows (grey)","Stage completion colors (success), abandonment colors (warning), engagement levels (gradient), cohort colors","Funnel animation (fill-down), flow diagram animations (connection draw), conversion pulse, engagement bar fill","Conversion funnel analysis, user journey tracking, engagement analytics, cohort analysis, retention tracking","Real-time operational metrics, technical system monitoring, financial transactions",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,✓ Good,✗ Not applicable
+36,Financial Dashboard,BI/Analytics,"Revenue metrics, profit/loss visualization, budget tracking, financial ratios, portfolio performance, cash flow, audit trail","Financial colors: profit (green #22C55E), loss (red #EF4444), neutral (grey), trust (dark blue #003366)","Revenue highlight (green), expenses (red), budget variance (orange/red), balance (grey), accuracy (blue)","Number animations (count-up), trend direction indicators, percentage change animations, profit/loss color transitions","Financial reporting, accounting dashboards, portfolio tracking, budget monitoring, banking analytics","Simple business dashboards, entertainment/social metrics, non-financial data",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✗ Low,✗ Not applicable
+37,Sales Intelligence Dashboard,BI/Analytics,"Deal pipeline, sales metrics, territory performance, sales rep leaderboard, win-loss analysis, quota tracking, forecast accuracy","Sales colors: won (green), lost (red), in-progress (blue), blocked (orange), quota met (gold), quota missed (grey)","Pipeline stage colors, rep performance colors, quota achievement colors, forecast accuracy colors","Deal movement animations, metric updates, leaderboard ranking changes, gauge needle movements, status change highlights","CRM dashboards, sales management, opportunity tracking, performance management, quota planning","Marketing analytics, customer support metrics, HR dashboards",✓ Full,✓ Full,⚡ Good,✓ WCAG AA,◐ Medium,✗ Not applicable,"Recharts 9/10, Chart.js 9/10",2020s Modern,Medium
+38,Neubrutalism,General,"Bold borders, black outlines, primary colors, thick shadows, no gradients, flat colors, 45° shadows, playful, Gen Z","#FFEB3B (Yellow), #FF5252 (Red), #2196F3 (Blue), #000000 (Black borders)","Limited accent colors, high contrast combinations, no gradients allowed","box-shadow: 4px 4px 0 #000, border: 3px solid #000, no gradients, sharp corners (0px), bold typography","Gen Z brands, startups, creative agencies, Figma-style apps, Notion-style interfaces, tech blogs","Luxury brands, finance, healthcare, conservative industries (too playful)",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Bootstrap 8/10",2020s Modern,Low
+39,Bento Box Grid,General,"Modular cards, asymmetric grid, varied sizes, Apple-style, dashboard tiles, negative space, clean hierarchy, cards","Neutral base + brand accent, #FFFFFF, #F5F5F5, brand primary","Subtle gradients, shadow variations, accent highlights for interactive cards","grid-template with varied spans, rounded-xl (16px), subtle shadows, hover scale (1.02), smooth transitions","Dashboards, product pages, portfolios, Apple-style marketing, feature showcases, SaaS","Dense data tables, text-heavy content, real-time monitoring",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, CSS Grid 10/10",2020s Apple,Low
+40,Y2K Aesthetic,General,"Neon pink, chrome, metallic, bubblegum, iridescent, glossy, retro-futurism, 2000s, futuristic nostalgia","#FF69B4 (Hot Pink), #00FFFF (Cyan), #C0C0C0 (Silver), #9400D3 (Purple)","Metallic gradients, glossy overlays, iridescent effects, chrome textures","linear-gradient metallic, glossy buttons, 3D chrome effects, glow animations, bubble shapes","Fashion brands, music platforms, Gen Z brands, nostalgia marketing, entertainment, youth-focused","B2B enterprise, healthcare, finance, conservative industries, elderly users",✓ Full,◐ Partial,⚠ Good,⚠ Check contrast,✓ Good,✓ High,"Tailwind 8/10, CSS-in-JS 9/10",Y2K 2000s,Medium
+41,Cyberpunk UI,General,"Neon, dark mode, terminal, HUD, sci-fi, glitch, dystopian, futuristic, matrix, tech noir","#00FF00 (Matrix Green), #FF00FF (Magenta), #00FFFF (Cyan), #0D0D0D (Dark)","Neon gradients, scanline overlays, glitch colors, terminal green accents","Neon glow (text-shadow), glitch animations (skew/offset), scanlines (::before overlay), terminal fonts","Gaming platforms, tech products, crypto apps, sci-fi applications, developer tools, entertainment","Corporate enterprise, healthcare, family apps, conservative brands, elderly users",✗ No,✓ Only,⚠ Moderate,⚠ Limited (dark+neon),◐ Medium,◐ Medium,"Tailwind 8/10, Custom CSS 10/10",2020s Cyberpunk,Medium
+42,Organic Biophilic,General,"Nature, organic shapes, green, sustainable, rounded, flowing, wellness, earthy, natural textures","#228B22 (Forest Green), #8B4513 (Earth Brown), #87CEEB (Sky Blue), #F5F5DC (Beige)","Natural gradients, earth tones, sky blues, organic textures, wood/stone colors","Rounded corners (16-24px), organic curves (border-radius variations), natural shadows, flowing SVG shapes","Wellness apps, sustainability brands, eco products, health apps, meditation, organic food brands","Tech-focused products, gaming, industrial, urban brands",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, CSS 10/10",2020s Sustainable,Low
+43,AI-Native UI,General,"Chatbot, conversational, voice, assistant, agentic, ambient, minimal chrome, streaming text, AI interactions","Neutral + single accent, #6366F1 (AI Purple), #10B981 (Success), #F5F5F5 (Background)","Status indicators, streaming highlights, context card colors, subtle accent variations","Typing indicators (3-dot pulse), streaming text animations, pulse animations, context cards, smooth reveals","AI products, chatbots, voice assistants, copilots, AI-powered tools, conversational interfaces","Traditional forms, data-heavy dashboards, print-first content",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, React 10/10",2020s AI-Era,Low
+44,Memphis Design,General,"80s, geometric, playful, postmodern, shapes, patterns, squiggles, triangles, neon, abstract, bold","#FF71CE (Hot Pink), #FFCE5C (Yellow), #86CCCA (Teal), #6A7BB4 (Blue Purple)","Complementary geometric colors, pattern fills, contrasting accent shapes","transform: rotate(), clip-path: polygon(), mix-blend-mode, repeating patterns, bold shapes","Creative agencies, music sites, youth brands, event promotion, artistic portfolios, entertainment","Corporate finance, healthcare, legal, elderly users, conservative brands",✓ Full,✓ Full,⚡ Excellent,⚠ Check contrast,✓ Good,◐ Medium,"Tailwind 9/10, CSS 10/10",1980s Postmodern,Medium
+45,Vaporwave,General,"Synthwave, retro-futuristic, 80s-90s, neon, glitch, nostalgic, sunset gradient, dreamy, aesthetic","#FF71CE (Pink), #01CDFE (Cyan), #05FFA1 (Mint), #B967FF (Purple)","Sunset gradients, glitch overlays, VHS effects, neon accents, pastel variations","text-shadow glow, linear-gradient, filter: hue-rotate(), glitch animations, retro scan lines","Music platforms, gaming, creative portfolios, tech startups, entertainment, artistic projects","Business apps, e-commerce, education, healthcare, enterprise software",✓ Full,✓ Dark focused,⚠ Moderate,⚠ Poor (motion),◐ Medium,◐ Medium,"Tailwind 8/10, CSS-in-JS 9/10",1980s-90s Retro,Medium
+46,Dimensional Layering,General,"Depth, overlapping, z-index, layers, 3D, shadows, elevation, floating, cards, spatial hierarchy","Neutral base (#FFFFFF, #F5F5F5, #E0E0E0) + brand accent for elevated elements","Shadow variations (sm/md/lg/xl), elevation colors, highlight colors for top layers","z-index stacking, box-shadow elevation (4 levels), transform: translateZ(), backdrop-filter, parallax","Dashboards, card layouts, modals, navigation, product showcases, SaaS interfaces","Print-style layouts, simple blogs, low-end devices, flat design requirements",✓ Full,✓ Full,⚠ Good,⚠ Moderate (SR issues),✓ Good,✓ High,"Tailwind 10/10, MUI 10/10, Chakra 10/10",2020s Modern,Medium
+47,Exaggerated Minimalism,General,"Bold minimalism, oversized typography, high contrast, negative space, loud minimal, statement design","#000000 (Black), #FFFFFF (White), single vibrant accent only","Minimal - single accent color, no secondary colors, extreme restraint","font-size: clamp(3rem 10vw 12rem), font-weight: 900, letter-spacing: -0.05em, massive whitespace","Fashion, architecture, portfolios, agency landing pages, luxury brands, editorial","E-commerce catalogs, dashboards, forms, data-heavy, elderly users, complex apps",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"Tailwind 10/10, Typography.js 10/10",2020s Modern,Low
+48,Kinetic Typography,General,"Motion text, animated type, moving letters, dynamic, typing effect, morphing, scroll-triggered text","Flexible - high contrast recommended, bold colors for emphasis, animation-friendly palette","Accent colors for emphasis, transition colors, gradient text fills","@keyframes text animation, typing effect, background-clip: text, GSAP ScrollTrigger, split text","Hero sections, marketing sites, video platforms, storytelling, creative portfolios, landing pages","Long-form content, accessibility-critical, data interfaces, forms, elderly users",✓ Full,✓ Full,⚠ Moderate,❌ Poor (motion),✓ Good,✓ Very High,"GSAP 10/10, Framer Motion 10/10",2020s Modern,High
+49,Parallax Storytelling,General,"Scroll-driven, narrative, layered scrolling, immersive, progressive disclosure, cinematic, scroll-triggered","Story-dependent, often gradients and natural colors, section-specific palettes","Section transition colors, depth layer colors, narrative mood colors","transform: translateY(scroll), position: fixed/sticky, perspective: 1px, scroll-triggered animations","Brand storytelling, product launches, case studies, portfolios, annual reports, marketing campaigns","E-commerce, dashboards, mobile-first, SEO-critical, accessibility-required",✓ Full,✓ Full,❌ Poor,❌ Poor (motion),✗ Low,✓ High,"GSAP ScrollTrigger 10/10, Locomotive Scroll 10/10",2020s Modern,High
+50,Swiss Modernism 2.0,General,"Grid system, Helvetica, modular, asymmetric, international style, rational, clean, mathematical spacing","#000000, #FFFFFF, #F5F5F5, single vibrant accent only","Minimal secondary, accent for emphasis only, no gradients","display: grid, grid-template-columns: repeat(12 1fr), gap: 1rem, mathematical ratios, clear hierarchy","Corporate sites, architecture, editorial, SaaS, museums, professional services, documentation","Playful brands, children's sites, entertainment, gaming, emotional storytelling",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Bootstrap 9/10, Foundation 10/10",1950s Swiss + 2020s,Low
+51,HUD / Sci-Fi FUI,General,"Futuristic, technical, wireframe, neon, data, transparency, iron man, sci-fi, interface","Neon Cyan #00FFFF, Holographic Blue #0080FF, Alert Red #FF0000","Transparent Black, Grid Lines #333333","Glow effects, scanning animations, ticker text, blinking markers, fine line drawing","Sci-fi games, space tech, cybersecurity, movie props, immersive dashboards","Standard corporate, reading heavy content, accessible public services",✓ Low,✓ Full,⚠ Moderate (renders),⚠ Poor (thin lines),◐ Medium,✗ Low,"React 9/10, Canvas 10/10",2010s Sci-Fi,High
+52,Pixel Art,General,"Retro, 8-bit, 16-bit, gaming, blocky, nostalgic, pixelated, arcade","Primary colors (NES Palette), brights, limited palette","Black outlines, shading via dithering or block colors","Frame-by-frame sprite animation, blinking cursor, instant transitions, marquee text","Indie games, retro tools, creative portfolios, nostalgia marketing, Web3/NFT","Professional corporate, modern SaaS, high-res photography sites",✓ Full,✓ Full,⚡ Excellent,✓ Good (if contrast ok),✓ High,◐ Medium,"CSS (box-shadow) 8/10, Canvas 10/10",1980s Arcade,Medium
+53,Bento Grids,General,"Apple-style, modular, cards, organized, clean, hierarchy, grid, rounded, soft","Off-white #F5F5F7, Clean White #FFFFFF, Text #1D1D1F","Subtle accents, soft shadows, blurred backdrops","Hover scale (1.02), soft shadow expansion, smooth layout shifts, content reveal","Product features, dashboards, personal sites, marketing summaries, galleries","Long-form reading, data tables, complex forms",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AA,✓ High,✓ High,"CSS Grid 10/10, Tailwind 10/10",2020s Apple/Linear,Low
+54,Neubrutalism,General,"Bold, ugly-cute, raw, high contrast, flat, hard shadows, distinct, playful, loud","Pop Yellow #FFDE59, Bright Red #FF5757, Black #000000","Lavender #CBA6F7, Mint #76E0C2","Hard hover shifts (4px), marquee scrolling, jitter animations, bold borders","Design tools, creative agencies, Gen Z brands, personal blogs, gumroad-style","Banking, legal, healthcare, serious enterprise, elderly users",✓ Full,✓ Full,⚡ Excellent,✓ WCAG AAA,✓ High,✓ High,"Tailwind 10/10, Plain CSS 10/10",2020s Modern Retro,Low
+55,Spatial UI (VisionOS),General,"Glass, depth, immersion, spatial, translucent, gaze, gesture, apple, vision-pro","Frosted Glass #FFFFFF (15-30% opacity), System White","Vibrant system colors for active states, deep shadows for depth","Parallax depth, dynamic lighting response, gaze-hover effects, smooth scale on focus","Spatial computing apps, VR/AR interfaces, immersive media, futuristic dashboards","Text-heavy documents, high-contrast requirements, non-3D capable devices",✓ Full,✓ Full,⚠ Moderate (blur cost),⚠ Contrast risks,✓ High (if adapted),✓ High,"SwiftUI, React (Three.js/Fiber)",2024 Spatial Era,High
+56,E-Ink / Paper,General,"Paper-like, matte, high contrast, texture, reading, calm, slow tech, monochrome","Off-White #FDFBF7, Paper White #F5F5F5, Ink Black #1A1A1A","Pencil Grey #4A4A4A, Highlighter Yellow #FFFF00 (accent)","No motion blur, distinct page turns, grain/noise texture, sharp transitions (no fade)","Reading apps, digital newspapers, minimal journals, distraction-free writing, slow-living brands","Gaming, video platforms, high-energy marketing, dark mode dependent apps",✓ Full,✗ Low (inverted only),⚡ Excellent,✓ WCAG AAA,✓ High,✓ Medium,"Tailwind 10/10, CSS 10/10",2020s Digital Well-being,Low
+57,Gen Z Chaos / Maximalism,General,"Chaos, clutter, stickers, raw, collage, mixed media, loud, internet culture, ironic","Clashing Brights: #FF00FF, #00FF00, #FFFF00, #0000FF","Gradients, rainbow, glitch, noise, heavily saturated mix","Marquee scrolls, jitter, sticker layering, GIF overload, random placement, drag-and-drop","Gen Z lifestyle brands, music artists, creative portfolios, viral marketing, fashion","Corporate, government, healthcare, banking, serious tools",✓ Full,✓ Full,⚠ Poor (heavy assets),❌ Poor,◐ Medium,✓ High (Viral),CSS-in-JS 8/10,2023+ Internet Core,High
+58,Biomimetic / Organic 2.0,General,"Nature-inspired, cellular, fluid, breathing, generative, algorithms, life-like","Cellular Pink #FF9999, Chlorophyll Green #00FF41, Bioluminescent Blue","Deep Ocean #001E3C, Coral #FF7F50, Organic gradients","Breathing animations, fluid morphing, generative growth, physics-based movement","Sustainability tech, biotech, advanced health, meditation, generative art platforms","Standard SaaS, data grids, strict corporate, accounting",✓ Full,✓ Full,⚠ Moderate,✓ Good,✓ Good,✓ High,"Canvas 10/10, WebGL 10/10",2024+ Generative,High
\ No newline at end of file
diff --git a/.claude/skills/ui-ux-pro-max/data/typography.csv b/.claude/skills/ui-ux-pro-max/data/typography.csv
new file mode 100644
index 0000000..29765f5
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/typography.csv
@@ -0,0 +1,58 @@
+STT,Font Pairing Name,Category,Heading Font,Body Font,Mood/Style Keywords,Best For,Google Fonts URL,CSS Import,Tailwind Config,Notes
+1,Classic Elegant,"Serif + Sans",Playfair Display,Inter,"elegant, luxury, sophisticated, timeless, premium, editorial","Luxury brands, fashion, spa, beauty, editorial, magazines, high-end e-commerce","https://fonts.google.com/share?selection.family=Inter:wght@300;400;500;600;700|Playfair+Display:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Playfair+Display:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Playfair Display', 'serif'], sans: ['Inter', 'sans-serif'] }","High contrast between elegant heading and clean body. Perfect for luxury/premium."
+2,Modern Professional,"Sans + Sans",Poppins,Open Sans,"modern, professional, clean, corporate, friendly, approachable","SaaS, corporate sites, business apps, startups, professional services","https://fonts.google.com/share?selection.family=Open+Sans:wght@300;400;500;600;700|Poppins:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Open+Sans:wght@300;400;500;600;700&family=Poppins:wght@400;500;600;700&display=swap');","fontFamily: { heading: ['Poppins', 'sans-serif'], body: ['Open Sans', 'sans-serif'] }","Geometric Poppins for headings, humanist Open Sans for readability."
+3,Tech Startup,"Sans + Sans",Space Grotesk,DM Sans,"tech, startup, modern, innovative, bold, futuristic","Tech companies, startups, SaaS, developer tools, AI products","https://fonts.google.com/share?selection.family=DM+Sans:wght@400;500;700|Space+Grotesk:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&family=Space+Grotesk:wght@400;500;600;700&display=swap');","fontFamily: { heading: ['Space Grotesk', 'sans-serif'], body: ['DM Sans', 'sans-serif'] }","Space Grotesk has unique character, DM Sans is highly readable."
+4,Editorial Classic,"Serif + Serif",Cormorant Garamond,Libre Baskerville,"editorial, classic, literary, traditional, refined, bookish","Publishing, blogs, news sites, literary magazines, book covers","https://fonts.google.com/share?selection.family=Cormorant+Garamond:wght@400;500;600;700|Libre+Baskerville:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Cormorant+Garamond:wght@400;500;600;700&family=Libre+Baskerville:wght@400;700&display=swap');","fontFamily: { heading: ['Cormorant Garamond', 'serif'], body: ['Libre Baskerville', 'serif'] }","All-serif pairing for traditional editorial feel."
+5,Minimal Swiss,"Sans + Sans",Inter,Inter,"minimal, clean, swiss, functional, neutral, professional","Dashboards, admin panels, documentation, enterprise apps, design systems","https://fonts.google.com/share?selection.family=Inter:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['Inter', 'sans-serif'] }","Single font family with weight variations. Ultimate simplicity."
+6,Playful Creative,"Display + Sans",Fredoka,Nunito,"playful, friendly, fun, creative, warm, approachable","Children's apps, educational, gaming, creative tools, entertainment","https://fonts.google.com/share?selection.family=Fredoka:wght@400;500;600;700|Nunito:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Fredoka:wght@400;500;600;700&family=Nunito:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Fredoka', 'sans-serif'], body: ['Nunito', 'sans-serif'] }","Rounded, friendly fonts perfect for playful UIs."
+7,Bold Statement,"Display + Sans",Bebas Neue,Source Sans 3,"bold, impactful, strong, dramatic, modern, headlines","Marketing sites, portfolios, agencies, event pages, sports","https://fonts.google.com/share?selection.family=Bebas+Neue|Source+Sans+3:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Bebas+Neue&family=Source+Sans+3:wght@300;400;500;600;700&display=swap');","fontFamily: { display: ['Bebas Neue', 'sans-serif'], body: ['Source Sans 3', 'sans-serif'] }","Bebas Neue for large headlines only. All-caps display font."
+8,Wellness Calm,"Serif + Sans",Lora,Raleway,"calm, wellness, health, relaxing, natural, organic","Health apps, wellness, spa, meditation, yoga, organic brands","https://fonts.google.com/share?selection.family=Lora:wght@400;500;600;700|Raleway:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Lora:wght@400;500;600;700&family=Raleway:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Lora', 'serif'], sans: ['Raleway', 'sans-serif'] }","Lora's organic curves with Raleway's elegant simplicity."
+9,Developer Mono,"Mono + Sans",JetBrains Mono,IBM Plex Sans,"code, developer, technical, precise, functional, hacker","Developer tools, documentation, code editors, tech blogs, CLI apps","https://fonts.google.com/share?selection.family=IBM+Plex+Sans:wght@300;400;500;600;700|JetBrains+Mono:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');","fontFamily: { mono: ['JetBrains Mono', 'monospace'], sans: ['IBM Plex Sans', 'sans-serif'] }","JetBrains for code, IBM Plex for UI. Developer-focused."
+10,Retro Vintage,"Display + Serif",Abril Fatface,Merriweather,"retro, vintage, nostalgic, dramatic, decorative, bold","Vintage brands, breweries, restaurants, creative portfolios, posters","https://fonts.google.com/share?selection.family=Abril+Fatface|Merriweather:wght@300;400;700","@import url('https://fonts.googleapis.com/css2?family=Abril+Fatface&family=Merriweather:wght@300;400;700&display=swap');","fontFamily: { display: ['Abril Fatface', 'serif'], body: ['Merriweather', 'serif'] }","Abril Fatface for hero headlines only. High-impact vintage feel."
+11,Geometric Modern,"Sans + Sans",Outfit,Work Sans,"geometric, modern, clean, balanced, contemporary, versatile","General purpose, portfolios, agencies, modern brands, landing pages","https://fonts.google.com/share?selection.family=Outfit:wght@300;400;500;600;700|Work+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700&family=Work+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Outfit', 'sans-serif'], body: ['Work Sans', 'sans-serif'] }","Both geometric but Outfit more distinctive for headings."
+12,Luxury Serif,"Serif + Sans",Cormorant,Montserrat,"luxury, high-end, fashion, elegant, refined, premium","Fashion brands, luxury e-commerce, jewelry, high-end services","https://fonts.google.com/share?selection.family=Cormorant:wght@400;500;600;700|Montserrat:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Cormorant:wght@400;500;600;700&family=Montserrat:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Cormorant', 'serif'], sans: ['Montserrat', 'sans-serif'] }","Cormorant's elegance with Montserrat's geometric precision."
+13,Friendly SaaS,"Sans + Sans",Plus Jakarta Sans,Plus Jakarta Sans,"friendly, modern, saas, clean, approachable, professional","SaaS products, web apps, dashboards, B2B, productivity tools","https://fonts.google.com/share?selection.family=Plus+Jakarta+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['Plus Jakarta Sans', 'sans-serif'] }","Single versatile font. Modern alternative to Inter."
+14,News Editorial,"Serif + Sans",Newsreader,Roboto,"news, editorial, journalism, trustworthy, readable, informative","News sites, blogs, magazines, journalism, content-heavy sites","https://fonts.google.com/share?selection.family=Newsreader:wght@400;500;600;700|Roboto:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Newsreader:wght@400;500;600;700&family=Roboto:wght@300;400;500;700&display=swap');","fontFamily: { serif: ['Newsreader', 'serif'], sans: ['Roboto', 'sans-serif'] }","Newsreader designed for long-form reading. Roboto for UI."
+15,Handwritten Charm,"Script + Sans",Caveat,Quicksand,"handwritten, personal, friendly, casual, warm, charming","Personal blogs, invitations, creative portfolios, lifestyle brands","https://fonts.google.com/share?selection.family=Caveat:wght@400;500;600;700|Quicksand:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Caveat:wght@400;500;600;700&family=Quicksand:wght@300;400;500;600;700&display=swap');","fontFamily: { script: ['Caveat', 'cursive'], sans: ['Quicksand', 'sans-serif'] }","Use Caveat sparingly for accents. Quicksand for body."
+16,Corporate Trust,"Sans + Sans",Lexend,Source Sans 3,"corporate, trustworthy, accessible, readable, professional, clean","Enterprise, government, healthcare, finance, accessibility-focused","https://fonts.google.com/share?selection.family=Lexend:wght@300;400;500;600;700|Source+Sans+3:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Lexend:wght@300;400;500;600;700&family=Source+Sans+3:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Lexend', 'sans-serif'], body: ['Source Sans 3', 'sans-serif'] }","Lexend designed for readability. Excellent accessibility."
+17,Brutalist Raw,"Mono + Mono",Space Mono,Space Mono,"brutalist, raw, technical, monospace, minimal, stark","Brutalist designs, developer portfolios, experimental, tech art","https://fonts.google.com/share?selection.family=Space+Mono:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Space+Mono:wght@400;700&display=swap');","fontFamily: { mono: ['Space Mono', 'monospace'] }","All-mono for raw brutalist aesthetic. Limited weights."
+18,Fashion Forward,"Sans + Sans",Syne,Manrope,"fashion, avant-garde, creative, bold, artistic, edgy","Fashion brands, creative agencies, art galleries, design studios","https://fonts.google.com/share?selection.family=Manrope:wght@300;400;500;600;700|Syne:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Manrope:wght@300;400;500;600;700&family=Syne:wght@400;500;600;700&display=swap');","fontFamily: { heading: ['Syne', 'sans-serif'], body: ['Manrope', 'sans-serif'] }","Syne's unique character for headlines. Manrope for readability."
+19,Soft Rounded,"Sans + Sans",Varela Round,Nunito Sans,"soft, rounded, friendly, approachable, warm, gentle","Children's products, pet apps, friendly brands, wellness, soft UI","https://fonts.google.com/share?selection.family=Nunito+Sans:wght@300;400;500;600;700|Varela+Round","@import url('https://fonts.googleapis.com/css2?family=Nunito+Sans:wght@300;400;500;600;700&family=Varela+Round&display=swap');","fontFamily: { heading: ['Varela Round', 'sans-serif'], body: ['Nunito Sans', 'sans-serif'] }","Both rounded and friendly. Perfect for soft UI designs."
+20,Premium Sans,"Sans + Sans",Satoshi,General Sans,"premium, modern, clean, sophisticated, versatile, balanced","Premium brands, modern agencies, SaaS, portfolios, startups","https://fonts.google.com/share?selection.family=DM+Sans:wght@400;500;700","@import url('https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&display=swap');","fontFamily: { sans: ['DM Sans', 'sans-serif'] }","Note: Satoshi/General Sans on Fontshare. DM Sans as Google alternative."
+21,Vietnamese Friendly,"Sans + Sans",Be Vietnam Pro,Noto Sans,"vietnamese, international, readable, clean, multilingual, accessible","Vietnamese sites, multilingual apps, international products","https://fonts.google.com/share?selection.family=Be+Vietnam+Pro:wght@300;400;500;600;700|Noto+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Be+Vietnam+Pro:wght@300;400;500;600;700&family=Noto+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['Be Vietnam Pro', 'Noto Sans', 'sans-serif'] }","Be Vietnam Pro excellent Vietnamese support. Noto as fallback."
+22,Japanese Elegant,"Serif + Sans",Noto Serif JP,Noto Sans JP,"japanese, elegant, traditional, modern, multilingual, readable","Japanese sites, Japanese restaurants, cultural sites, anime/manga","https://fonts.google.com/share?selection.family=Noto+Sans+JP:wght@300;400;500;700|Noto+Serif+JP:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+JP:wght@300;400;500;700&family=Noto+Serif+JP:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Noto Serif JP', 'serif'], sans: ['Noto Sans JP', 'sans-serif'] }","Noto fonts excellent Japanese support. Traditional + modern feel."
+23,Korean Modern,"Sans + Sans",Noto Sans KR,Noto Sans KR,"korean, modern, clean, professional, multilingual, readable","Korean sites, K-beauty, K-pop, Korean businesses, multilingual","https://fonts.google.com/share?selection.family=Noto+Sans+KR:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans KR', 'sans-serif'] }","Clean Korean typography. Single font with weight variations."
+24,Chinese Traditional,"Serif + Sans",Noto Serif TC,Noto Sans TC,"chinese, traditional, elegant, cultural, multilingual, readable","Traditional Chinese sites, cultural content, Taiwan/Hong Kong markets","https://fonts.google.com/share?selection.family=Noto+Sans+TC:wght@300;400;500;700|Noto+Serif+TC:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+TC:wght@300;400;500;700&family=Noto+Serif+TC:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Noto Serif TC', 'serif'], sans: ['Noto Sans TC', 'sans-serif'] }","Traditional Chinese character support. Elegant pairing."
+25,Chinese Simplified,"Sans + Sans",Noto Sans SC,Noto Sans SC,"chinese, simplified, modern, professional, multilingual, readable","Simplified Chinese sites, mainland China market, business apps","https://fonts.google.com/share?selection.family=Noto+Sans+SC:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans SC', 'sans-serif'] }","Simplified Chinese support. Clean modern look."
+26,Arabic Elegant,"Serif + Sans",Noto Naskh Arabic,Noto Sans Arabic,"arabic, elegant, traditional, cultural, RTL, readable","Arabic sites, Middle East market, Islamic content, bilingual sites","https://fonts.google.com/share?selection.family=Noto+Naskh+Arabic:wght@400;500;600;700|Noto+Sans+Arabic:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Naskh+Arabic:wght@400;500;600;700&family=Noto+Sans+Arabic:wght@300;400;500;700&display=swap');","fontFamily: { serif: ['Noto Naskh Arabic', 'serif'], sans: ['Noto Sans Arabic', 'sans-serif'] }","RTL support. Naskh for traditional, Sans for modern Arabic."
+27,Thai Modern,"Sans + Sans",Noto Sans Thai,Noto Sans Thai,"thai, modern, readable, clean, multilingual, accessible","Thai sites, Southeast Asia, tourism, Thai restaurants","https://fonts.google.com/share?selection.family=Noto+Sans+Thai:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+Thai:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans Thai', 'sans-serif'] }","Clean Thai typography. Excellent readability."
+28,Hebrew Modern,"Sans + Sans",Noto Sans Hebrew,Noto Sans Hebrew,"hebrew, modern, RTL, clean, professional, readable","Hebrew sites, Israeli market, Jewish content, bilingual sites","https://fonts.google.com/share?selection.family=Noto+Sans+Hebrew:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+Hebrew:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Noto Sans Hebrew', 'sans-serif'] }","RTL support. Clean modern Hebrew typography."
+29,Legal Professional,"Serif + Sans",EB Garamond,Lato,"legal, professional, traditional, trustworthy, formal, authoritative","Law firms, legal services, contracts, formal documents, government","https://fonts.google.com/share?selection.family=EB+Garamond:wght@400;500;600;700|Lato:wght@300;400;700","@import url('https://fonts.googleapis.com/css2?family=EB+Garamond:wght@400;500;600;700&family=Lato:wght@300;400;700&display=swap');","fontFamily: { serif: ['EB Garamond', 'serif'], sans: ['Lato', 'sans-serif'] }","EB Garamond for authority. Lato for clean body text."
+30,Medical Clean,"Sans + Sans",Figtree,Noto Sans,"medical, clean, accessible, professional, healthcare, trustworthy","Healthcare, medical clinics, pharma, health apps, accessibility","https://fonts.google.com/share?selection.family=Figtree:wght@300;400;500;600;700|Noto+Sans:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Figtree:wght@300;400;500;600;700&family=Noto+Sans:wght@300;400;500;700&display=swap');","fontFamily: { heading: ['Figtree', 'sans-serif'], body: ['Noto Sans', 'sans-serif'] }","Clean, accessible fonts for medical contexts."
+31,Financial Trust,"Sans + Sans",IBM Plex Sans,IBM Plex Sans,"financial, trustworthy, professional, corporate, banking, serious","Banks, finance, insurance, investment, fintech, enterprise","https://fonts.google.com/share?selection.family=IBM+Plex+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { sans: ['IBM Plex Sans', 'sans-serif'] }","IBM Plex conveys trust and professionalism. Excellent for data."
+32,Real Estate Luxury,"Serif + Sans",Cinzel,Josefin Sans,"real estate, luxury, elegant, sophisticated, property, premium","Real estate, luxury properties, architecture, interior design","https://fonts.google.com/share?selection.family=Cinzel:wght@400;500;600;700|Josefin+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Cinzel:wght@400;500;600;700&family=Josefin+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Cinzel', 'serif'], sans: ['Josefin Sans', 'sans-serif'] }","Cinzel's elegance for headlines. Josefin for modern body."
+33,Restaurant Menu,"Serif + Sans",Playfair Display SC,Karla,"restaurant, menu, culinary, elegant, foodie, hospitality","Restaurants, cafes, food blogs, culinary, hospitality","https://fonts.google.com/share?selection.family=Karla:wght@300;400;500;600;700|Playfair+Display+SC:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Karla:wght@300;400;500;600;700&family=Playfair+Display+SC:wght@400;700&display=swap');","fontFamily: { display: ['Playfair Display SC', 'serif'], sans: ['Karla', 'sans-serif'] }","Small caps Playfair for menu headers. Karla for descriptions."
+34,Art Deco,"Display + Sans",Poiret One,Didact Gothic,"art deco, vintage, 1920s, elegant, decorative, gatsby","Vintage events, art deco themes, luxury hotels, classic cocktails","https://fonts.google.com/share?selection.family=Didact+Gothic|Poiret+One","@import url('https://fonts.googleapis.com/css2?family=Didact+Gothic&family=Poiret+One&display=swap');","fontFamily: { display: ['Poiret One', 'sans-serif'], sans: ['Didact Gothic', 'sans-serif'] }","Poiret One for art deco headlines only. Didact for body."
+35,Magazine Style,"Serif + Sans",Libre Bodoni,Public Sans,"magazine, editorial, publishing, refined, journalism, print","Magazines, online publications, editorial content, journalism","https://fonts.google.com/share?selection.family=Libre+Bodoni:wght@400;500;600;700|Public+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Libre+Bodoni:wght@400;500;600;700&family=Public+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Libre Bodoni', 'serif'], sans: ['Public Sans', 'sans-serif'] }","Bodoni's editorial elegance. Public Sans for clean UI."
+36,Crypto/Web3,"Sans + Sans",Orbitron,Exo 2,"crypto, web3, futuristic, tech, blockchain, digital","Crypto platforms, NFT, blockchain, web3, futuristic tech","https://fonts.google.com/share?selection.family=Exo+2:wght@300;400;500;600;700|Orbitron:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Exo+2:wght@300;400;500;600;700&family=Orbitron:wght@400;500;600;700&display=swap');","fontFamily: { display: ['Orbitron', 'sans-serif'], body: ['Exo 2', 'sans-serif'] }","Orbitron for futuristic headers. Exo 2 for readable body."
+37,Gaming Bold,"Display + Sans",Russo One,Chakra Petch,"gaming, bold, action, esports, competitive, energetic","Gaming, esports, action games, competitive sports, entertainment","https://fonts.google.com/share?selection.family=Chakra+Petch:wght@300;400;500;600;700|Russo+One","@import url('https://fonts.googleapis.com/css2?family=Chakra+Petch:wght@300;400;500;600;700&family=Russo+One&display=swap');","fontFamily: { display: ['Russo One', 'sans-serif'], body: ['Chakra Petch', 'sans-serif'] }","Russo One for impact. Chakra Petch for techy body text."
+38,Indie/Craft,"Display + Sans",Amatic SC,Cabin,"indie, craft, handmade, artisan, organic, creative","Craft brands, indie products, artisan, handmade, organic products","https://fonts.google.com/share?selection.family=Amatic+SC:wght@400;700|Cabin:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Amatic+SC:wght@400;700&family=Cabin:wght@400;500;600;700&display=swap');","fontFamily: { display: ['Amatic SC', 'sans-serif'], sans: ['Cabin', 'sans-serif'] }","Amatic for handwritten feel. Cabin for readable body."
+39,Startup Bold,"Sans + Sans",Clash Display,Satoshi,"startup, bold, modern, innovative, confident, dynamic","Startups, pitch decks, product launches, bold brands","https://fonts.google.com/share?selection.family=Outfit:wght@400;500;600;700|Rubik:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;500;600;700&family=Rubik:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Outfit', 'sans-serif'], body: ['Rubik', 'sans-serif'] }","Note: Clash Display on Fontshare. Outfit as Google alternative."
+40,E-commerce Clean,"Sans + Sans",Rubik,Nunito Sans,"ecommerce, clean, shopping, product, retail, conversion","E-commerce, online stores, product pages, retail, shopping","https://fonts.google.com/share?selection.family=Nunito+Sans:wght@300;400;500;600;700|Rubik:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Nunito+Sans:wght@300;400;500;600;700&family=Rubik:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Rubik', 'sans-serif'], body: ['Nunito Sans', 'sans-serif'] }","Clean readable fonts perfect for product descriptions."
+41,Academic/Research,"Serif + Sans",Crimson Pro,Atkinson Hyperlegible,"academic, research, scholarly, accessible, readable, educational","Universities, research papers, academic journals, educational","https://fonts.google.com/share?selection.family=Atkinson+Hyperlegible:wght@400;700|Crimson+Pro:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Atkinson+Hyperlegible:wght@400;700&family=Crimson+Pro:wght@400;500;600;700&display=swap');","fontFamily: { serif: ['Crimson Pro', 'serif'], sans: ['Atkinson Hyperlegible', 'sans-serif'] }","Crimson for scholarly headlines. Atkinson for accessibility."
+42,Dashboard Data,"Mono + Sans",Fira Code,Fira Sans,"dashboard, data, analytics, code, technical, precise","Dashboards, analytics, data visualization, admin panels","https://fonts.google.com/share?selection.family=Fira+Code:wght@400;500;600;700|Fira+Sans:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;500;600;700&family=Fira+Sans:wght@300;400;500;600;700&display=swap');","fontFamily: { mono: ['Fira Code', 'monospace'], sans: ['Fira Sans', 'sans-serif'] }","Fira family cohesion. Code for data, Sans for labels."
+43,Music/Entertainment,"Display + Sans",Righteous,Poppins,"music, entertainment, fun, energetic, bold, performance","Music platforms, entertainment, events, festivals, performers","https://fonts.google.com/share?selection.family=Poppins:wght@300;400;500;600;700|Righteous","@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;500;600;700&family=Righteous&display=swap');","fontFamily: { display: ['Righteous', 'sans-serif'], sans: ['Poppins', 'sans-serif'] }","Righteous for bold entertainment headers. Poppins for body."
+44,Minimalist Portfolio,"Sans + Sans",Archivo,Space Grotesk,"minimal, portfolio, designer, creative, clean, artistic","Design portfolios, creative professionals, minimalist brands","https://fonts.google.com/share?selection.family=Archivo:wght@300;400;500;600;700|Space+Grotesk:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Archivo:wght@300;400;500;600;700&family=Space+Grotesk:wght@300;400;500;600;700&display=swap');","fontFamily: { heading: ['Space Grotesk', 'sans-serif'], body: ['Archivo', 'sans-serif'] }","Space Grotesk for distinctive headers. Archivo for clean body."
+45,Kids/Education,"Display + Sans",Baloo 2,Comic Neue,"kids, education, playful, friendly, colorful, learning","Children's apps, educational games, kid-friendly content","https://fonts.google.com/share?selection.family=Baloo+2:wght@400;500;600;700|Comic+Neue:wght@300;400;700","@import url('https://fonts.googleapis.com/css2?family=Baloo+2:wght@400;500;600;700&family=Comic+Neue:wght@300;400;700&display=swap');","fontFamily: { display: ['Baloo 2', 'sans-serif'], sans: ['Comic Neue', 'sans-serif'] }","Fun, playful fonts for children. Comic Neue is readable comic style."
+46,Wedding/Romance,"Script + Serif",Great Vibes,Cormorant Infant,"wedding, romance, elegant, script, invitation, feminine","Wedding sites, invitations, romantic brands, bridal","https://fonts.google.com/share?selection.family=Cormorant+Infant:wght@300;400;500;600;700|Great+Vibes","@import url('https://fonts.googleapis.com/css2?family=Cormorant+Infant:wght@300;400;500;600;700&family=Great+Vibes&display=swap');","fontFamily: { script: ['Great Vibes', 'cursive'], serif: ['Cormorant Infant', 'serif'] }","Great Vibes for elegant accents. Cormorant for readable text."
+47,Science/Tech,"Sans + Sans",Exo,Roboto Mono,"science, technology, research, data, futuristic, precise","Science, research, tech documentation, data-heavy sites","https://fonts.google.com/share?selection.family=Exo:wght@300;400;500;600;700|Roboto+Mono:wght@300;400;500;700","@import url('https://fonts.googleapis.com/css2?family=Exo:wght@300;400;500;600;700&family=Roboto+Mono:wght@300;400;500;700&display=swap');","fontFamily: { sans: ['Exo', 'sans-serif'], mono: ['Roboto Mono', 'monospace'] }","Exo for modern tech feel. Roboto Mono for code/data."
+48,Accessibility First,"Sans + Sans",Atkinson Hyperlegible,Atkinson Hyperlegible,"accessible, readable, inclusive, WCAG, dyslexia-friendly, clear","Accessibility-critical sites, government, healthcare, inclusive design","https://fonts.google.com/share?selection.family=Atkinson+Hyperlegible:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Atkinson+Hyperlegible:wght@400;700&display=swap');","fontFamily: { sans: ['Atkinson Hyperlegible', 'sans-serif'] }","Designed for maximum legibility. Excellent for accessibility."
+49,Sports/Fitness,"Sans + Sans",Barlow Condensed,Barlow,"sports, fitness, athletic, energetic, condensed, action","Sports, fitness, gyms, athletic brands, competition","https://fonts.google.com/share?selection.family=Barlow+Condensed:wght@400;500;600;700|Barlow:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@400;500;600;700&family=Barlow:wght@300;400;500;600;700&display=swap');","fontFamily: { display: ['Barlow Condensed', 'sans-serif'], body: ['Barlow', 'sans-serif'] }","Condensed for impact headlines. Regular Barlow for body."
+50,Luxury Minimalist,"Serif + Sans",Bodoni Moda,Jost,"luxury, minimalist, high-end, sophisticated, refined, premium","Luxury minimalist brands, high-end fashion, premium products","https://fonts.google.com/share?selection.family=Bodoni+Moda:wght@400;500;600;700|Jost:wght@300;400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Bodoni+Moda:wght@400;500;600;700&family=Jost:wght@300;400;500;600;700&display=swap');","fontFamily: { serif: ['Bodoni Moda', 'serif'], sans: ['Jost', 'sans-serif'] }","Bodoni's high contrast elegance. Jost for geometric body."
+51,Tech/HUD Mono,"Mono + Mono",Share Tech Mono,Fira Code,"tech, futuristic, hud, sci-fi, data, monospaced, precise","Sci-fi interfaces, developer tools, cybersecurity, dashboards","https://fonts.google.com/share?selection.family=Fira+Code:wght@300;400;500;600;700|Share+Tech+Mono","@import url('https://fonts.googleapis.com/css2?family=Fira+Code:wght@300;400;500;600;700&family=Share+Tech+Mono&display=swap');","fontFamily: { hud: ['Share Tech Mono', 'monospace'], code: ['Fira Code', 'monospace'] }","Share Tech Mono has that classic sci-fi look."
+52,Pixel Retro,"Display + Sans",Press Start 2P,VT323,"pixel, retro, gaming, 8-bit, nostalgic, arcade","Pixel art games, retro websites, creative portfolios","https://fonts.google.com/share?selection.family=Press+Start+2P|VT323","@import url('https://fonts.googleapis.com/css2?family=Press+Start+2P&family=VT323&display=swap');","fontFamily: { pixel: ['Press Start 2P', 'cursive'], terminal: ['VT323', 'monospace'] }","Press Start 2P is very wide/large. VT323 is better for body text."
+53,Neubrutalist Bold,"Display + Sans",Lexend Mega,Public Sans,"bold, neubrutalist, loud, strong, geometric, quirky","Neubrutalist designs, Gen Z brands, bold marketing","https://fonts.google.com/share?selection.family=Lexend+Mega:wght@100..900|Public+Sans:wght@100..900","@import url('https://fonts.googleapis.com/css2?family=Lexend+Mega:wght@100..900&family=Public+Sans:wght@100..900&display=swap');","fontFamily: { mega: ['Lexend Mega', 'sans-serif'], body: ['Public Sans', 'sans-serif'] }","Lexend Mega has distinct character and variable weight."
+54,Academic/Archival,"Serif + Serif",EB Garamond,Crimson Text,"academic, old-school, university, research, serious, traditional","University sites, archives, research papers, history","https://fonts.google.com/share?selection.family=Crimson+Text:wght@400;600;700|EB+Garamond:wght@400;500;600;700;800","@import url('https://fonts.googleapis.com/css2?family=Crimson+Text:wght@400;600;700&family=EB+Garamond:wght@400;500;600;700;800&display=swap');","fontFamily: { classic: ['EB Garamond', 'serif'], text: ['Crimson Text', 'serif'] }","Classic academic aesthetic. Very legible."
+55,Spatial Clear,"Sans + Sans",Inter,Inter,"spatial, legible, glass, system, clean, neutral","Spatial computing, AR/VR, glassmorphism interfaces","https://fonts.google.com/share?selection.family=Inter:wght@300;400;500;600","@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600&display=swap');","fontFamily: { sans: ['Inter', 'sans-serif'] }","Optimized for readability on dynamic backgrounds."
+56,Kinetic Motion,"Display + Mono",Syncopate,Space Mono,"kinetic, motion, futuristic, speed, wide, tech","Music festivals, automotive, high-energy brands","https://fonts.google.com/share?selection.family=Space+Mono:wght@400;700|Syncopate:wght@400;700","@import url('https://fonts.googleapis.com/css2?family=Space+Mono:wght@400;700&family=Syncopate:wght@400;700&display=swap');","fontFamily: { display: ['Syncopate', 'sans-serif'], mono: ['Space Mono', 'monospace'] }","Syncopate's wide stance works well with motion effects."
+57,Gen Z Brutal,"Display + Sans",Anton,Epilogue,"brutal, loud, shouty, meme, internet, bold","Gen Z marketing, streetwear, viral campaigns","https://fonts.google.com/share?selection.family=Anton|Epilogue:wght@400;500;600;700","@import url('https://fonts.googleapis.com/css2?family=Anton&family=Epilogue:wght@400;500;600;700&display=swap');","fontFamily: { display: ['Anton', 'sans-serif'], body: ['Epilogue', 'sans-serif'] }","Anton is impactful and condensed. Good for stickers/badges."
\ No newline at end of file
diff --git a/.claude/skills/ui-ux-pro-max/data/ui-reasoning.csv b/.claude/skills/ui-ux-pro-max/data/ui-reasoning.csv
new file mode 100644
index 0000000..4553ddd
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/ui-reasoning.csv
@@ -0,0 +1,101 @@
+No,UI_Category,Recommended_Pattern,Style_Priority,Color_Mood,Typography_Mood,Key_Effects,Decision_Rules,Anti_Patterns,Severity
+1,SaaS (General),Hero + Features + CTA,Glassmorphism + Flat Design,Trust blue + Accent contrast,Professional + Hierarchy,Subtle hover (200-250ms) + Smooth transitions,"{""if_ux_focused"": ""prioritize-minimalism"", ""if_data_heavy"": ""add-glassmorphism""}",Excessive animation + Dark mode by default,HIGH
+2,Micro SaaS,Minimal & Direct + Demo,Flat Design + Vibrant & Block,Vibrant primary + White space,Bold + Clean typography,Large CTA hover (300ms) + Scroll reveal,"{""if_quick_onboarding"": ""reduce-steps"", ""if_demo_available"": ""feature-interactive-demo""}",Complex onboarding flow + Cluttered layout,HIGH
+3,E-commerce,Feature-Rich Showcase,Vibrant & Block-based,Brand primary + Success green,Engaging + Clear hierarchy,Card hover lift (200ms) + Scale effect,"{""if_luxury"": ""switch-to-liquid-glass"", ""if_conversion_focused"": ""add-urgency-colors""}",Flat design without depth + Text-heavy pages,HIGH
+4,E-commerce Luxury,Feature-Rich Showcase,Liquid Glass + Glassmorphism,Premium colors + Minimal accent,Elegant + Refined typography,Chromatic aberration + Fluid animations (400-600ms),"{""if_checkout"": ""emphasize-trust"", ""if_hero_needed"": ""use-3d-hyperrealism""}",Vibrant & Block-based + Playful colors,HIGH
+5,Healthcare App,Social Proof-Focused,Neumorphism + Accessible & Ethical,Calm blue + Health green,Readable + Large type (16px+),Soft box-shadow + Smooth press (150ms),"{""must_have"": ""wcag-aaa-compliance"", ""if_medication"": ""red-alert-colors""}",Bright neon colors + Motion-heavy animations + AI purple/pink gradients,HIGH
+6,Fintech/Crypto,Conversion-Optimized,Glassmorphism + Dark Mode (OLED),Dark tech colors + Vibrant accents,Modern + Confident typography,Real-time chart animations + Alert pulse/glow,"{""must_have"": ""security-badges"", ""if_real_time"": ""add-streaming-data""}",Light backgrounds + No security indicators,HIGH
+7,Education,Feature-Rich Showcase,Claymorphism + Micro-interactions,Playful colors + Clear hierarchy,Friendly + Engaging typography,Soft press (200ms) + Fluffy elements,"{""if_gamification"": ""add-progress-animation"", ""if_children"": ""increase-playfulness""}",Dark modes + Complex jargon,MEDIUM
+8,Portfolio/Personal,Storytelling-Driven,Motion-Driven + Minimalism,Brand primary + Artistic,Expressive + Variable typography,Parallax (3-5 layers) + Scroll-triggered reveals,"{""if_creative_field"": ""add-brutalism"", ""if_minimal_portfolio"": ""reduce-motion""}",Corporate templates + Generic layouts,MEDIUM
+9,Government/Public,Minimal & Direct,Accessible & Ethical + Minimalism,Professional blue + High contrast,Clear + Large typography,Clear focus rings (3-4px) + Skip links,"{""must_have"": ""wcag-aaa"", ""must_have"": ""keyboard-navigation""}",Ornate design + Low contrast + Motion effects + AI purple/pink gradients,HIGH
+10,Fintech (Banking),Trust & Authority,Minimalism + Accessible & Ethical,Navy + Trust Blue + Gold,Professional + Trustworthy,Smooth state transitions + Number animations,"{""must_have"": ""security-first"", ""if_dashboard"": ""use-dark-mode""}",Playful design + Unclear fees + AI purple/pink gradients,HIGH
+11,Social Media App,Feature-Rich Showcase,Vibrant & Block-based + Motion-Driven,Vibrant + Engagement colors,Modern + Bold typography,Large scroll animations + Icon animations,"{""if_engagement_metric"": ""add-motion"", ""if_content_focused"": ""minimize-chrome""}",Heavy skeuomorphism + Accessibility ignored,MEDIUM
+12,Startup Landing,Hero-Centric + Trust,Motion-Driven + Vibrant & Block,Bold primaries + Accent contrast,Modern + Energetic typography,Scroll-triggered animations + Parallax,"{""if_pre_launch"": ""use-waitlist-pattern"", ""if_video_ready"": ""add-hero-video""}",Static design + No video + Poor mobile,HIGH
+13,Gaming,Feature-Rich Showcase,3D & Hyperrealism + Retro-Futurism,Vibrant + Neon + Immersive,Bold + Impactful typography,WebGL 3D rendering + Glitch effects,"{""if_competitive"": ""add-real-time-stats"", ""if_casual"": ""increase-playfulness""}",Minimalist design + Static assets,HIGH
+14,Creative Agency,Storytelling-Driven,Brutalism + Motion-Driven,Bold primaries + Artistic freedom,Bold + Expressive typography,CRT scanlines + Neon glow + Glitch effects,"{""must_have"": ""case-studies"", ""if_boutique"": ""increase-artistic-freedom""}",Corporate minimalism + Hidden portfolio,HIGH
+15,Wellness/Mental Health,Social Proof-Focused,Neumorphism + Accessible & Ethical,Calm Pastels + Trust colors,Calming + Readable typography,Soft press + Breathing animations,"{""must_have"": ""privacy-first"", ""if_meditation"": ""add-breathing-animation""}",Bright neon + Motion overload,HIGH
+16,Restaurant/Food,Hero-Centric + Conversion,Vibrant & Block-based + Motion-Driven,Warm colors (Orange Red Brown),Appetizing + Clear typography,Food image reveal + Menu hover effects,"{""must_have"": ""high_quality_images"", ""if_delivery"": ""emphasize-speed""}",Low-quality imagery + Outdated hours,HIGH
+17,Real Estate,Hero-Centric + Feature-Rich,Glassmorphism + Minimalism,Trust Blue + Gold + White,Professional + Confident,3D property tour zoom + Map hover,"{""if_luxury"": ""add-3d-models"", ""must_have"": ""map-integration""}",Poor photos + No virtual tours,HIGH
+18,Travel/Tourism,Storytelling-Driven + Hero,Aurora UI + Motion-Driven,Vibrant destination + Sky Blue,Inspirational + Engaging,Destination parallax + Itinerary animations,"{""if_experience_focused"": ""use-storytelling"", ""must_have"": ""mobile-booking""}",Generic photos + Complex booking,HIGH
+19,SaaS Dashboard,Data-Dense Dashboard,Data-Dense + Heat Map,Cool to Hot gradients + Neutral grey,Clear + Readable typography,Hover tooltips + Chart zoom + Real-time pulse,"{""must_have"": ""real-time-updates"", ""if_large_dataset"": ""prioritize-performance""}",Ornate design + Slow rendering,HIGH
+20,B2B SaaS Enterprise,Feature-Rich Showcase,Trust & Authority + Minimal,Professional blue + Neutral grey,Formal + Clear typography,Subtle section transitions + Feature reveals,"{""must_have"": ""case-studies"", ""must_have"": ""roi-messaging""}",Playful design + Hidden features + AI purple/pink gradients,HIGH
+21,Music/Entertainment,Feature-Rich Showcase,Dark Mode (OLED) + Vibrant & Block-based,Dark (#121212) + Vibrant accents + Album art colors,Modern + Bold typography,Waveform visualization + Playlist animations,"{""must_have"": ""audio-player-ux"", ""if_discovery_focused"": ""add-playlist-recommendations""}",Cluttered layout + Poor audio player UX,HIGH
+22,Video Streaming/OTT,Hero-Centric + Feature-Rich,Dark Mode (OLED) + Motion-Driven,Dark bg + Poster colors + Brand accent,Bold + Engaging typography,Video player animations + Content carousel (parallax),"{""must_have"": ""continue-watching"", ""if_personalized"": ""add-recommendations""}",Static layout + Slow video player,HIGH
+23,Job Board/Recruitment,Conversion-Optimized + Feature-Rich,Flat Design + Minimalism,Professional Blue + Success Green + Neutral,Clear + Professional typography,Search/filter animations + Application flow,"{""must_have"": ""advanced-search"", ""if_salary_focused"": ""highlight-compensation""}",Outdated forms + Hidden filters,HIGH
+24,Marketplace (P2P),Feature-Rich Showcase + Social Proof,Vibrant & Block-based + Flat Design,Trust colors + Category colors + Success green,Modern + Engaging typography,Review star animations + Listing hover effects,"{""must_have"": ""seller-profiles"", ""must_have"": ""secure-payment""}",Low trust signals + Confusing layout,HIGH
+25,Logistics/Delivery,Feature-Rich Showcase + Real-Time,Minimalism + Flat Design,Blue (#2563EB) + Orange (tracking) + Green,Clear + Functional typography,Real-time tracking animation + Status pulse,"{""must_have"": ""tracking-map"", ""must_have"": ""delivery-updates""}",Static tracking + No map integration + AI purple/pink gradients,HIGH
+26,Agriculture/Farm Tech,Feature-Rich Showcase,Organic Biophilic + Flat Design,Earth Green (#4A7C23) + Brown + Sky Blue,Clear + Informative typography,Data visualization + Weather animations,"{""must_have"": ""sensor-dashboard"", ""if_crop_focused"": ""add-health-indicators""}",Generic design + Ignored accessibility + AI purple/pink gradients,MEDIUM
+27,Construction/Architecture,Hero-Centric + Feature-Rich,Minimalism + 3D & Hyperrealism,Grey (#4A4A4A) + Orange (safety) + Blueprint Blue,Professional + Bold typography,3D model viewer + Timeline animations,"{""must_have"": ""project-portfolio"", ""if_team_collaboration"": ""add-real-time-updates""}",2D-only layouts + Poor image quality + AI purple/pink gradients,HIGH
+28,Automotive/Car Dealership,Hero-Centric + Feature-Rich,Motion-Driven + 3D & Hyperrealism,Brand colors + Metallic + Dark/Light,Bold + Confident typography,360 product view + Configurator animations,"{""must_have"": ""vehicle-comparison"", ""must_have"": ""financing-calculator""}",Static product pages + Poor UX,HIGH
+29,Photography Studio,Storytelling-Driven + Hero-Centric,Motion-Driven + Minimalism,Black + White + Minimal accent,Elegant + Minimal typography,Full-bleed gallery + Before/after reveal,"{""must_have"": ""portfolio-showcase"", ""if_booking"": ""add-calendar-system""}",Heavy text + Poor image showcase,HIGH
+30,Coworking Space,Hero-Centric + Feature-Rich,Vibrant & Block-based + Glassmorphism,Energetic colors + Wood tones + Brand,Modern + Engaging typography,Space tour video + Amenity reveal animations,"{""must_have"": ""virtual-tour"", ""must_have"": ""booking-system""}",Outdated photos + Confusing layout,MEDIUM
+31,Cleaning Service,Conversion-Optimized + Trust,Soft UI Evolution + Flat Design,Fresh Blue (#00B4D8) + Clean White + Green,Friendly + Clear typography,Before/after gallery + Service package reveal,"{""must_have"": ""price-transparency"", ""must_have"": ""trust-badges""}",Poor before/after imagery + Hidden pricing,HIGH
+32,Home Services,Conversion-Optimized + Trust,Flat Design + Trust & Authority,Trust Blue + Safety Orange + Grey,Professional + Clear typography,Emergency contact highlight + Service menu animations,"{""must_have"": ""emergency-contact"", ""must_have"": ""certifications-display""}",Hidden contact info + No certifications,HIGH
+33,Childcare/Daycare,Social Proof-Focused + Trust,Claymorphism + Vibrant & Block-based,Playful pastels + Safe colors + Warm,Friendly + Playful typography,Parent portal animations + Activity gallery reveal,"{""must_have"": ""parent-communication"", ""must_have"": ""safety-certifications""}",Generic design + Hidden safety info,HIGH
+34,Senior Care/Elderly,Trust & Authority + Accessible,Accessible & Ethical + Soft UI Evolution,Calm Blue + Warm neutrals + Large text,Large + Clear typography (18px+),Large touch targets + Clear navigation,"{""must_have"": ""wcag-aaa"", ""must_have"": ""family-portal""}",Small text + Complex navigation + AI purple/pink gradients,HIGH
+35,Medical Clinic,Trust & Authority + Conversion,Accessible & Ethical + Minimalism,Medical Blue (#0077B6) + Trust White,Professional + Readable typography,Online booking flow + Doctor profile reveals,"{""must_have"": ""appointment-booking"", ""must_have"": ""insurance-info""}",Outdated interface + Confusing booking + AI purple/pink gradients,HIGH
+36,Pharmacy/Drug Store,Conversion-Optimized + Trust,Flat Design + Accessible & Ethical,Pharmacy Green + Trust Blue + Clean White,Clear + Functional typography,Prescription upload flow + Refill reminders,"{""must_have"": ""prescription-management"", ""must_have"": ""drug-interaction-warnings""}",Confusing layout + Privacy concerns + AI purple/pink gradients,HIGH
+37,Dental Practice,Social Proof-Focused + Conversion,Soft UI Evolution + Minimalism,Fresh Blue + White + Smile Yellow,Friendly + Professional typography,Before/after gallery + Patient testimonial carousel,"{""must_have"": ""before-after-gallery"", ""must_have"": ""appointment-system""}",Poor imagery + No testimonials,HIGH
+38,Veterinary Clinic,Social Proof-Focused + Trust,Claymorphism + Accessible & Ethical,Caring Blue + Pet colors + Warm,Friendly + Welcoming typography,Pet profile management + Service animations,"{""must_have"": ""pet-portal"", ""must_have"": ""emergency-contact""}",Generic design + Hidden services,MEDIUM
+39,News/Media Platform,Hero-Centric + Feature-Rich,Minimalism + Flat Design,Brand colors + High contrast,Clear + Readable typography,Breaking news badge + Article reveal animations,"{""must_have"": ""mobile-first-reading"", ""must_have"": ""category-navigation""}",Cluttered layout + Slow loading,HIGH
+40,Legal Services,Trust & Authority + Minimal,Trust & Authority + Minimalism,Navy Blue (#1E3A5F) + Gold + White,Professional + Authoritative typography,Practice area reveal + Attorney profile animations,"{""must_have"": ""case-results"", ""must_have"": ""credential-display""}",Outdated design + Hidden credentials + AI purple/pink gradients,HIGH
+41,Beauty/Spa/Wellness Service,Hero-Centric + Social Proof,Soft UI Evolution + Neumorphism,Soft pastels (Pink Sage Cream) + Gold accents,Elegant + Calming typography,Soft shadows + Smooth transitions (200-300ms) + Gentle hover,"{""must_have"": ""booking-system"", ""must_have"": ""before-after-gallery"", ""if_luxury"": ""add-gold-accents""}",Bright neon colors + Harsh animations + Dark mode,HIGH
+42,Service Landing Page,Hero-Centric + Trust & Authority,Minimalism + Social Proof-Focused,Brand primary + Trust colors,Professional + Clear typography,Testimonial carousel + CTA hover (200ms),"{""must_have"": ""social-proof"", ""must_have"": ""clear-cta""}",Complex navigation + Hidden contact info,HIGH
+43,B2B Service,Feature-Rich Showcase + Trust,Trust & Authority + Minimalism,Professional blue + Neutral grey,Formal + Clear typography,Section transitions + Feature reveals,"{""must_have"": ""case-studies"", ""must_have"": ""roi-messaging""}",Playful design + Hidden credentials + AI purple/pink gradients,HIGH
+44,Financial Dashboard,Data-Dense Dashboard,Dark Mode (OLED) + Data-Dense,Dark bg + Red/Green alerts + Trust blue,Clear + Readable typography,Real-time number animations + Alert pulse,"{""must_have"": ""real-time-updates"", ""must_have"": ""high-contrast""}",Light mode default + Slow rendering,HIGH
+45,Analytics Dashboard,Data-Dense + Drill-Down,Data-Dense + Heat Map,Cool→Hot gradients + Neutral grey,Clear + Functional typography,Hover tooltips + Chart zoom + Filter animations,"{""must_have"": ""data-export"", ""if_large_dataset"": ""virtualize-lists""}",Ornate design + No filtering,HIGH
+46,Productivity Tool,Interactive Demo + Feature-Rich,Flat Design + Micro-interactions,Clear hierarchy + Functional colors,Clean + Efficient typography,Quick actions (150ms) + Task animations,"{""must_have"": ""keyboard-shortcuts"", ""if_collaboration"": ""add-real-time-cursors""}",Complex onboarding + Slow performance,HIGH
+47,Design System/Component Library,Feature-Rich + Documentation,Minimalism + Accessible & Ethical,Clear hierarchy + Code-like structure,Monospace + Clear typography,Code copy animations + Component previews,"{""must_have"": ""search"", ""must_have"": ""code-examples""}",Poor documentation + No live preview,HIGH
+48,AI/Chatbot Platform,Interactive Demo + Minimal,AI-Native UI + Minimalism,Neutral + AI Purple (#6366F1),Modern + Clear typography,Streaming text + Typing indicators + Fade-in,"{""must_have"": ""conversational-ui"", ""must_have"": ""context-awareness""}",Heavy chrome + Slow response feedback,HIGH
+49,NFT/Web3 Platform,Feature-Rich Showcase,Cyberpunk UI + Glassmorphism,Dark + Neon + Gold (#FFD700),Bold + Modern typography,Wallet connect animations + Transaction feedback,"{""must_have"": ""wallet-integration"", ""must_have"": ""gas-fees-display""}",Light mode default + No transaction status,HIGH
+50,Creator Economy Platform,Social Proof + Feature-Rich,Vibrant & Block-based + Bento Box Grid,Vibrant + Brand colors,Modern + Bold typography,Engagement counter animations + Profile reveals,"{""must_have"": ""creator-profiles"", ""must_have"": ""monetization-display""}",Generic layout + Hidden earnings,MEDIUM
+51,Sustainability/ESG Platform,Trust & Authority + Data,Organic Biophilic + Minimalism,Green (#228B22) + Earth tones,Clear + Informative typography,Progress indicators + Impact animations,"{""must_have"": ""data-transparency"", ""must_have"": ""certification-badges""}",Greenwashing visuals + No data,HIGH
+52,Remote Work/Collaboration,Feature-Rich + Real-Time,Soft UI Evolution + Minimalism,Calm Blue + Neutral grey,Clean + Readable typography,Real-time presence indicators + Notification badges,"{""must_have"": ""status-indicators"", ""must_have"": ""video-integration""}",Cluttered interface + No presence,HIGH
+53,Pet Tech App,Storytelling + Feature-Rich,Claymorphism + Vibrant & Block-based,Playful + Warm colors,Friendly + Playful typography,Pet profile animations + Health tracking charts,"{""must_have"": ""pet-profiles"", ""if_health"": ""add-vet-integration""}",Generic design + No personality,MEDIUM
+54,Smart Home/IoT Dashboard,Real-Time Monitoring,Glassmorphism + Dark Mode (OLED),Dark + Status indicator colors,Clear + Functional typography,Device status pulse + Quick action animations,"{""must_have"": ""real-time-controls"", ""must_have"": ""energy-monitoring""}",Slow updates + No automation,HIGH
+55,EV/Charging Ecosystem,Hero-Centric + Feature-Rich,Minimalism + Aurora UI,Electric Blue (#009CD1) + Green,Modern + Clear typography,Range estimation animations + Map interactions,"{""must_have"": ""charging-map"", ""must_have"": ""range-calculator""}",Poor map UX + Hidden costs,HIGH
+56,Subscription Box Service,Feature-Rich + Conversion,Vibrant & Block-based + Motion-Driven,Brand + Excitement colors,Engaging + Clear typography,Unboxing reveal animations + Product carousel,"{""must_have"": ""personalization-quiz"", ""must_have"": ""subscription-management""}",Confusing pricing + No unboxing preview,HIGH
+57,Podcast Platform,Storytelling + Feature-Rich,Dark Mode (OLED) + Minimalism,Dark + Audio waveform accents,Modern + Clear typography,Waveform visualizations + Episode transitions,"{""must_have"": ""audio-player-ux"", ""must_have"": ""episode-discovery""}",Poor audio player + Cluttered layout,HIGH
+58,Dating App,Social Proof + Feature-Rich,Vibrant & Block-based + Motion-Driven,Warm + Romantic (Pink/Red gradients),Modern + Friendly typography,Profile card swipe + Match animations,"{""must_have"": ""profile-cards"", ""must_have"": ""safety-features""}",Generic profiles + No safety,HIGH
+59,Micro-Credentials/Badges,Trust & Authority + Feature,Minimalism + Flat Design,Trust Blue + Gold (#FFD700),Professional + Clear typography,Badge reveal animations + Progress tracking,"{""must_have"": ""credential-verification"", ""must_have"": ""progress-display""}",No verification + Hidden progress,MEDIUM
+60,Knowledge Base/Documentation,FAQ + Minimal,Minimalism + Accessible & Ethical,Clean hierarchy + Minimal color,Clear + Readable typography,Search highlight + Smooth scrolling,"{""must_have"": ""search-first"", ""must_have"": ""version-switching""}",Poor navigation + No search,HIGH
+61,Hyperlocal Services,Conversion + Feature-Rich,Minimalism + Vibrant & Block-based,Location markers + Trust colors,Clear + Functional typography,Map hover + Provider card reveals,"{""must_have"": ""map-integration"", ""must_have"": ""booking-system""}",No map + Hidden reviews,HIGH
+62,Luxury/Premium Brand,Storytelling + Feature-Rich,Liquid Glass + Glassmorphism,Black + Gold (#FFD700) + White,Elegant + Refined typography,Slow parallax + Premium reveals (400-600ms),"{""must_have"": ""high-quality-imagery"", ""must_have"": ""storytelling""}",Cheap visuals + Fast animations,HIGH
+63,Fitness/Gym App,Feature-Rich + Data,Vibrant & Block-based + Dark Mode (OLED),Energetic (Orange #FF6B35) + Dark bg,Bold + Motivational typography,Progress ring animations + Achievement unlocks,"{""must_have"": ""progress-tracking"", ""must_have"": ""workout-plans""}",Static design + No gamification,HIGH
+64,Hotel/Hospitality,Hero-Centric + Social Proof,Liquid Glass + Minimalism,Warm neutrals + Gold (#D4AF37),Elegant + Welcoming typography,Room gallery + Amenity reveals,"{""must_have"": ""room-booking"", ""must_have"": ""virtual-tour""}",Poor photos + Complex booking,HIGH
+65,Wedding/Event Planning,Storytelling + Social Proof,Soft UI Evolution + Aurora UI,Soft Pink (#FFD6E0) + Gold + Cream,Elegant + Romantic typography,Gallery reveals + Timeline animations,"{""must_have"": ""portfolio-gallery"", ""must_have"": ""planning-tools""}",Generic templates + No portfolio,HIGH
+66,Insurance Platform,Conversion + Trust,Trust & Authority + Flat Design,Trust Blue (#0066CC) + Green + Neutral,Clear + Professional typography,Quote calculator animations + Policy comparison,"{""must_have"": ""quote-calculator"", ""must_have"": ""policy-comparison""}",Confusing pricing + No trust signals + AI purple/pink gradients,HIGH
+67,Banking/Traditional Finance,Trust & Authority + Feature,Minimalism + Accessible & Ethical,Navy (#0A1628) + Trust Blue + Gold,Professional + Trustworthy typography,Smooth number animations + Security indicators,"{""must_have"": ""security-first"", ""must_have"": ""accessibility""}",Playful design + Poor security UX + AI purple/pink gradients,HIGH
+68,Online Course/E-learning,Feature-Rich + Social Proof,Claymorphism + Vibrant & Block-based,Vibrant learning colors + Progress green,Friendly + Engaging typography,Progress bar animations + Certificate reveals,"{""must_have"": ""progress-tracking"", ""must_have"": ""video-player""}",Boring design + No gamification,HIGH
+69,Non-profit/Charity,Storytelling + Trust,Accessible & Ethical + Organic Biophilic,Cause-related colors + Trust + Warm,Heartfelt + Readable typography,Impact counter animations + Story reveals,"{""must_have"": ""impact-stories"", ""must_have"": ""donation-transparency""}",No impact data + Hidden financials,HIGH
+70,Florist/Plant Shop,Hero-Centric + Conversion,Organic Biophilic + Vibrant & Block-based,Natural Green + Floral pinks/purples,Elegant + Natural typography,Product reveal + Seasonal transitions,"{""must_have"": ""delivery-scheduling"", ""must_have"": ""care-guides""}",Poor imagery + No seasonal content,MEDIUM
+71,Bakery/Cafe,Hero-Centric + Conversion,Vibrant & Block-based + Soft UI Evolution,Warm Brown + Cream + Appetizing accents,Warm + Inviting typography,Menu hover + Order animations,"{""must_have"": ""menu-display"", ""must_have"": ""online-ordering""}",Poor food photos + Hidden hours,HIGH
+72,Coffee Shop,Hero-Centric + Minimal,Minimalism + Organic Biophilic,Coffee Brown (#6F4E37) + Cream + Warm,Cozy + Clean typography,Menu transitions + Loyalty animations,"{""must_have"": ""menu"", ""if_loyalty"": ""add-rewards-system""}",Generic design + No atmosphere,MEDIUM
+73,Brewery/Winery,Storytelling + Hero-Centric,Motion-Driven + Storytelling-Driven,Deep amber/burgundy + Gold + Craft,Artisanal + Heritage typography,Tasting note reveals + Heritage timeline,"{""must_have"": ""product-showcase"", ""must_have"": ""story-heritage""}",Generic product pages + No story,HIGH
+74,Airline,Conversion + Feature-Rich,Minimalism + Glassmorphism,Sky Blue + Brand colors + Trust,Clear + Professional typography,Flight search animations + Boarding pass reveals,"{""must_have"": ""flight-search"", ""must_have"": ""mobile-first""}",Complex booking + Poor mobile,HIGH
+75,Magazine/Blog,Storytelling + Hero-Centric,Swiss Modernism 2.0 + Motion-Driven,Editorial colors + Brand + Clean white,Editorial + Elegant typography,Article transitions + Category reveals,"{""must_have"": ""article-showcase"", ""must_have"": ""newsletter-signup""}",Poor typography + Slow loading,HIGH
+76,Freelancer Platform,Feature-Rich + Conversion,Flat Design + Minimalism,Professional Blue + Success Green,Clear + Professional typography,Skill match animations + Review reveals,"{""must_have"": ""portfolio-display"", ""must_have"": ""skill-matching""}",Poor profiles + No reviews,HIGH
+77,Consulting Firm,Trust & Authority + Minimal,Trust & Authority + Minimalism,Navy + Gold + Professional grey,Authoritative + Clear typography,Case study reveals + Team profiles,"{""must_have"": ""case-studies"", ""must_have"": ""thought-leadership""}",Generic content + No credentials + AI purple/pink gradients,HIGH
+78,Marketing Agency,Storytelling + Feature-Rich,Brutalism + Motion-Driven,Bold brand colors + Creative freedom,Bold + Expressive typography,Portfolio reveals + Results animations,"{""must_have"": ""portfolio"", ""must_have"": ""results-metrics""}",Boring design + Hidden work,HIGH
+79,Event Management,Hero-Centric + Feature-Rich,Vibrant & Block-based + Motion-Driven,Event theme colors + Excitement accents,Bold + Engaging typography,Countdown timer + Registration flow,"{""must_have"": ""registration"", ""must_have"": ""agenda-display""}",Confusing registration + No countdown,HIGH
+80,Conference/Webinar Platform,Feature-Rich + Conversion,Glassmorphism + Minimalism,Professional Blue + Video accent,Professional + Clear typography,Live stream integration + Agenda transitions,"{""must_have"": ""registration"", ""must_have"": ""speaker-profiles""}",Poor video UX + No networking,HIGH
+81,Membership/Community,Social Proof + Conversion,Vibrant & Block-based + Soft UI Evolution,Community brand colors + Engagement,Friendly + Engaging typography,Member counter + Benefit reveals,"{""must_have"": ""member-benefits"", ""must_have"": ""pricing-tiers""}",Hidden benefits + No community proof,HIGH
+82,Newsletter Platform,Minimal + Conversion,Minimalism + Flat Design,Brand primary + Clean white + CTA,Clean + Readable typography,Subscribe form + Archive reveals,"{""must_have"": ""subscribe-form"", ""must_have"": ""sample-content""}",Complex signup + No preview,MEDIUM
+83,Digital Products/Downloads,Feature-Rich + Conversion,Vibrant & Block-based + Motion-Driven,Product colors + Brand + Success green,Modern + Clear typography,Product preview + Instant delivery animations,"{""must_have"": ""product-preview"", ""must_have"": ""instant-delivery""}",No preview + Slow delivery,HIGH
+84,Church/Religious Organization,Hero-Centric + Social Proof,Accessible & Ethical + Soft UI Evolution,Warm Gold + Deep Purple/Blue + White,Welcoming + Clear typography,Service time highlights + Event calendar,"{""must_have"": ""service-times"", ""must_have"": ""community-events""}",Outdated design + Hidden info,MEDIUM
+85,Sports Team/Club,Hero-Centric + Feature-Rich,Vibrant & Block-based + Motion-Driven,Team colors + Energetic accents,Bold + Impactful typography,Score animations + Schedule reveals,"{""must_have"": ""schedule"", ""must_have"": ""roster""}",Static content + Poor fan engagement,HIGH
+86,Museum/Gallery,Storytelling + Feature-Rich,Minimalism + Motion-Driven,Art-appropriate neutrals + Exhibition accents,Elegant + Minimal typography,Virtual tour + Collection reveals,"{""must_have"": ""virtual-tour"", ""must_have"": ""exhibition-info""}",Cluttered layout + No online access,HIGH
+87,Theater/Cinema,Hero-Centric + Conversion,Dark Mode (OLED) + Motion-Driven,Dark + Spotlight accents + Gold,Dramatic + Bold typography,Seat selection + Trailer reveals,"{""must_have"": ""showtimes"", ""must_have"": ""seat-selection""}",Poor booking UX + No trailers,HIGH
+88,Language Learning App,Feature-Rich + Social Proof,Claymorphism + Vibrant & Block-based,Playful colors + Progress indicators,Friendly + Clear typography,Progress animations + Achievement unlocks,"{""must_have"": ""progress-tracking"", ""must_have"": ""gamification""}",Boring design + No motivation,HIGH
+89,Coding Bootcamp,Feature-Rich + Social Proof,Dark Mode (OLED) + Minimalism,Code editor colors + Brand + Success,Technical + Clear typography,Terminal animations + Career outcome reveals,"{""must_have"": ""curriculum"", ""must_have"": ""career-outcomes""}",Light mode only + Hidden results,HIGH
+90,Cybersecurity Platform,Trust & Authority + Real-Time,Cyberpunk UI + Dark Mode (OLED),Matrix Green (#00FF00) + Deep Black,Technical + Clear typography,Threat visualization + Alert animations,"{""must_have"": ""real-time-monitoring"", ""must_have"": ""threat-display""}",Light mode + Poor data viz,HIGH
+91,Developer Tool/IDE,Minimal + Documentation,Dark Mode (OLED) + Minimalism,Dark syntax theme + Blue focus,Monospace + Functional typography,Syntax highlighting + Command palette,"{""must_have"": ""keyboard-shortcuts"", ""must_have"": ""documentation""}",Light mode default + Slow performance,HIGH
+92,Biotech/Life Sciences,Storytelling + Data,Glassmorphism + Clean Science,Sterile White + DNA Blue + Life Green,Scientific + Clear typography,Data visualization + Research reveals,"{""must_have"": ""data-accuracy"", ""must_have"": ""clean-aesthetic""}",Cluttered data + Poor credibility,HIGH
+93,Space Tech/Aerospace,Immersive + Feature-Rich,Holographic/HUD + Dark Mode,Deep Space Black + Star White + Metallic,Futuristic + Precise typography,Telemetry animations + 3D renders,"{""must_have"": ""high-tech-feel"", ""must_have"": ""precision-data""}",Generic design + No immersion,HIGH
+94,Architecture/Interior,Portfolio + Hero-Centric,Exaggerated Minimalism + High Imagery,Monochrome + Gold Accent + High Imagery,Architectural + Elegant typography,Project gallery + Blueprint reveals,"{""must_have"": ""high-res-images"", ""must_have"": ""project-portfolio""}",Poor imagery + Cluttered layout,HIGH
+95,Quantum Computing,Immersive + Interactive,Holographic/HUD + Dark Mode,Quantum Blue (#00FFFF) + Deep Black,Futuristic + Scientific typography,Probability visualizations + Qubit state animations,"{""must_have"": ""complexity-visualization"", ""must_have"": ""scientific-credibility""}",Generic tech design + No viz,HIGH
+96,Biohacking/Longevity App,Data-Dense + Storytelling,Biomimetic/Organic 2.0 + Minimalism,Cellular Pink/Red + DNA Blue + White,Scientific + Clear typography,Biological data viz + Progress animations,"{""must_have"": ""data-privacy"", ""must_have"": ""scientific-credibility""}",Generic health app + No privacy,HIGH
+97,Autonomous Drone Fleet,Real-Time + Feature-Rich,HUD/Sci-Fi FUI + Real-Time,Tactical Green + Alert Red + Map Dark,Technical + Functional typography,Telemetry animations + 3D spatial awareness,"{""must_have"": ""real-time-telemetry"", ""must_have"": ""safety-alerts""}",Slow updates + Poor spatial viz,HIGH
+98,Generative Art Platform,Showcase + Feature-Rich,Minimalism + Gen Z Chaos,Neutral (#F5F5F5) + User Content,Minimal + Content-focused typography,Gallery masonry + Minting animations,"{""must_have"": ""fast-loading"", ""must_have"": ""creator-attribution""}",Heavy chrome + Slow loading,HIGH
+99,Spatial Computing OS,Immersive + Interactive,Spatial UI (VisionOS) + Glassmorphism,Frosted Glass + System Colors + Depth,Spatial + Readable typography,Depth hierarchy + Gaze interactions,"{""must_have"": ""depth-hierarchy"", ""must_have"": ""environment-awareness""}",2D design + No spatial depth,HIGH
+100,Sustainable Energy/Climate,Data + Trust,Organic Biophilic + E-Ink/Paper,Earth Green + Sky Blue + Solar Yellow,Clear + Informative typography,Impact viz + Progress animations,"{""must_have"": ""data-transparency"", ""must_have"": ""impact-visualization""}",Greenwashing + No real data,HIGH
diff --git a/.claude/skills/ui-ux-pro-max/data/ux-guidelines.csv b/.claude/skills/ui-ux-pro-max/data/ux-guidelines.csv
new file mode 100644
index 0000000..e347aed
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/ux-guidelines.csv
@@ -0,0 +1,100 @@
+No,Category,Issue,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Navigation,Smooth Scroll,Web,Anchor links should scroll smoothly to target section,Use scroll-behavior: smooth on html element,Jump directly without transition,html { scroll-behavior: smooth; },<a href='#section'> without CSS,High
+2,Navigation,Sticky Navigation,Web,Fixed nav should not obscure content,Add padding-top to body equal to nav height,Let nav overlap first section content,pt-20 (if nav is h-20),No padding compensation,Medium
+3,Navigation,Active State,All,Current page/section should be visually indicated,Highlight active nav item with color/underline,No visual feedback on current location,text-primary border-b-2,All links same style,Medium
+4,Navigation,Back Button,Mobile,Users expect back to work predictably,Preserve navigation history properly,Break browser/app back button behavior,history.pushState(),location.replace(),High
+5,Navigation,Deep Linking,All,URLs should reflect current state for sharing,Update URL on state/view changes,Static URLs for dynamic content,Use query params or hash,Single URL for all states,Medium
+6,Navigation,Breadcrumbs,Web,Show user location in site hierarchy,Use for sites with 3+ levels of depth,Use for flat single-level sites,Home > Category > Product,Only on deep nested pages,Low
+7,Animation,Excessive Motion,All,Too many animations cause distraction and motion sickness,Animate 1-2 key elements per view maximum,Animate everything that moves,Single hero animation,animate-bounce on 5+ elements,High
+8,Animation,Duration Timing,All,Animations should feel responsive not sluggish,Use 150-300ms for micro-interactions,Use animations longer than 500ms for UI,transition-all duration-200,duration-1000,Medium
+9,Animation,Reduced Motion,All,Respect user's motion preferences,Check prefers-reduced-motion media query,Ignore accessibility motion settings,@media (prefers-reduced-motion: reduce),No motion query check,High
+10,Animation,Loading States,All,Show feedback during async operations,Use skeleton screens or spinners,Leave UI frozen with no feedback,animate-pulse skeleton,Blank screen while loading,High
+11,Animation,Hover vs Tap,All,Hover effects don't work on touch devices,Use click/tap for primary interactions,Rely only on hover for important actions,onClick handler,onMouseEnter only,High
+12,Animation,Continuous Animation,All,Infinite animations are distracting,Use for loading indicators only,Use for decorative elements,animate-spin on loader,animate-bounce on icons,Medium
+13,Animation,Transform Performance,Web,Some CSS properties trigger expensive repaints,Use transform and opacity for animations,Animate width/height/top/left properties,transform: translateY(),top: 10px animation,Medium
+14,Animation,Easing Functions,All,Linear motion feels robotic,Use ease-out for entering ease-in for exiting,Use linear for UI transitions,ease-out,linear,Low
+15,Layout,Z-Index Management,Web,Stacking context conflicts cause hidden elements,Define z-index scale system (10 20 30 50),Use arbitrary large z-index values,z-10 z-20 z-50,z-[9999],High
+16,Layout,Overflow Hidden,Web,Hidden overflow can clip important content,Test all content fits within containers,Blindly apply overflow-hidden,overflow-auto with scroll,overflow-hidden truncating content,Medium
+17,Layout,Fixed Positioning,Web,Fixed elements can overlap or be inaccessible,Account for safe areas and other fixed elements,Stack multiple fixed elements carelessly,Fixed nav + fixed bottom with gap,Multiple overlapping fixed elements,Medium
+18,Layout,Stacking Context,Web,New stacking contexts reset z-index,Understand what creates new stacking context,Expect z-index to work across contexts,Parent with z-index isolates children,z-index: 9999 not working,Medium
+19,Layout,Content Jumping,Web,Layout shift when content loads is jarring,Reserve space for async content,Let images/content push layout around,aspect-ratio or fixed height,No dimensions on images,High
+20,Layout,Viewport Units,Web,100vh can be problematic on mobile browsers,Use dvh or account for mobile browser chrome,Use 100vh for full-screen mobile layouts,min-h-dvh or min-h-screen,h-screen on mobile,Medium
+21,Layout,Container Width,Web,Content too wide is hard to read,Limit max-width for text content (65-75ch),Let text span full viewport width,max-w-prose or max-w-3xl,Full width paragraphs,Medium
+22,Touch,Touch Target Size,Mobile,Small buttons are hard to tap accurately,Minimum 44x44px touch targets,Tiny clickable areas,min-h-[44px] min-w-[44px],w-6 h-6 buttons,High
+23,Touch,Touch Spacing,Mobile,Adjacent touch targets need adequate spacing,Minimum 8px gap between touch targets,Tightly packed clickable elements,gap-2 between buttons,gap-0 or gap-1,Medium
+24,Touch,Gesture Conflicts,Mobile,Custom gestures can conflict with system,Avoid horizontal swipe on main content,Override system gestures,Vertical scroll primary,Horizontal swipe carousel only,Medium
+25,Touch,Tap Delay,Mobile,300ms tap delay feels laggy,Use touch-action CSS or fastclick,Default mobile tap handling,touch-action: manipulation,No touch optimization,Medium
+26,Touch,Pull to Refresh,Mobile,Accidental refresh is frustrating,Disable where not needed,Enable by default everywhere,overscroll-behavior: contain,Default overscroll,Low
+27,Touch,Haptic Feedback,Mobile,Tactile feedback improves interaction feel,Use for confirmations and important actions,Overuse vibration feedback,navigator.vibrate(10),Vibrate on every tap,Low
+28,Interaction,Focus States,All,Keyboard users need visible focus indicators,Use visible focus rings on interactive elements,Remove focus outline without replacement,focus:ring-2 focus:ring-blue-500,outline-none without alternative,High
+29,Interaction,Hover States,Web,Visual feedback on interactive elements,Change cursor and add subtle visual change,No hover feedback on clickable elements,hover:bg-gray-100 cursor-pointer,No hover style,Medium
+30,Interaction,Active States,All,Show immediate feedback on press/click,Add pressed/active state visual change,No feedback during interaction,active:scale-95,No active state,Medium
+31,Interaction,Disabled States,All,Clearly indicate non-interactive elements,Reduce opacity and change cursor,Confuse disabled with normal state,opacity-50 cursor-not-allowed,Same style as enabled,Medium
+32,Interaction,Loading Buttons,All,Prevent double submission during async actions,Disable button and show loading state,Allow multiple clicks during processing,disabled={loading} spinner,Button clickable while loading,High
+33,Interaction,Error Feedback,All,Users need to know when something fails,Show clear error messages near problem,Silent failures with no feedback,Red border + error message,No indication of error,High
+34,Interaction,Success Feedback,All,Confirm successful actions to users,Show success message or visual change,No confirmation of completed action,Toast notification or checkmark,Action completes silently,Medium
+35,Interaction,Confirmation Dialogs,All,Prevent accidental destructive actions,Confirm before delete/irreversible actions,Delete without confirmation,Are you sure modal,Direct delete on click,High
+36,Accessibility,Color Contrast,All,Text must be readable against background,Minimum 4.5:1 ratio for normal text,Low contrast text,#333 on white (7:1),#999 on white (2.8:1),High
+37,Accessibility,Color Only,All,Don't convey information by color alone,Use icons/text in addition to color,Red/green only for error/success,Red text + error icon,Red border only for error,High
+38,Accessibility,Alt Text,All,Images need text alternatives,Descriptive alt text for meaningful images,Empty or missing alt attributes,alt='Dog playing in park',alt='' for content images,High
+39,Accessibility,Heading Hierarchy,Web,Screen readers use headings for navigation,Use sequential heading levels h1-h6,Skip heading levels or misuse for styling,h1 then h2 then h3,h1 then h4,Medium
+40,Accessibility,ARIA Labels,All,Interactive elements need accessible names,Add aria-label for icon-only buttons,Icon buttons without labels,aria-label='Close menu',<button><Icon/></button>,High
+41,Accessibility,Keyboard Navigation,Web,All functionality accessible via keyboard,Tab order matches visual order,Keyboard traps or illogical tab order,tabIndex for custom order,Unreachable elements,High
+42,Accessibility,Screen Reader,All,Content should make sense when read aloud,Use semantic HTML and ARIA properly,Div soup with no semantics,<nav> <main> <article>,<div> for everything,Medium
+43,Accessibility,Form Labels,All,Inputs must have associated labels,Use label with for attribute or wrap input,Placeholder-only inputs,<label for='email'>,placeholder='Email' only,High
+44,Accessibility,Error Messages,All,Error messages must be announced,Use aria-live or role=alert for errors,Visual-only error indication,role='alert',Red border only,High
+45,Accessibility,Skip Links,Web,Allow keyboard users to skip navigation,Provide skip to main content link,No skip link on nav-heavy pages,Skip to main content link,100 tabs to reach content,Medium
+46,Performance,Image Optimization,All,Large images slow page load,Use appropriate size and format (WebP),Unoptimized full-size images,srcset with multiple sizes,4000px image for 400px display,High
+47,Performance,Lazy Loading,All,Load content as needed,Lazy load below-fold images and content,Load everything upfront,loading='lazy',All images eager load,Medium
+48,Performance,Code Splitting,Web,Large bundles slow initial load,Split code by route/feature,Single large bundle,dynamic import(),All code in main bundle,Medium
+49,Performance,Caching,Web,Repeat visits should be fast,Set appropriate cache headers,No caching strategy,Cache-Control headers,Every request hits server,Medium
+50,Performance,Font Loading,Web,Web fonts can block rendering,Use font-display swap or optional,Invisible text during font load,font-display: swap,FOIT (Flash of Invisible Text),Medium
+51,Performance,Third Party Scripts,Web,External scripts can block rendering,Load non-critical scripts async/defer,Synchronous third-party scripts,async or defer attribute,<script src='...'> in head,Medium
+52,Performance,Bundle Size,Web,Large JavaScript slows interaction,Monitor and minimize bundle size,Ignore bundle size growth,Bundle analyzer,No size monitoring,Medium
+53,Performance,Render Blocking,Web,CSS/JS can block first paint,Inline critical CSS defer non-critical,Large blocking CSS files,Critical CSS inline,All CSS in head,Medium
+54,Forms,Input Labels,All,Every input needs a visible label,Always show label above or beside input,Placeholder as only label,<label>Email</label><input>,placeholder='Email' only,High
+55,Forms,Error Placement,All,Errors should appear near the problem,Show error below related input,Single error message at top of form,Error under each field,All errors at form top,Medium
+56,Forms,Inline Validation,All,Validate as user types or on blur,Validate on blur for most fields,Validate only on submit,onBlur validation,Submit-only validation,Medium
+57,Forms,Input Types,All,Use appropriate input types,Use email tel number url etc,Text input for everything,type='email',type='text' for email,Medium
+58,Forms,Autofill Support,Web,Help browsers autofill correctly,Use autocomplete attribute properly,Block or ignore autofill,autocomplete='email',autocomplete='off' everywhere,Medium
+59,Forms,Required Indicators,All,Mark required fields clearly,Use asterisk or (required) text,No indication of required fields,* required indicator,Guess which are required,Medium
+60,Forms,Password Visibility,All,Let users see password while typing,Toggle to show/hide password,No visibility toggle,Show/hide password button,Password always hidden,Medium
+61,Forms,Submit Feedback,All,Confirm form submission status,Show loading then success/error state,No feedback after submit,Loading -> Success message,Button click with no response,High
+62,Forms,Input Affordance,All,Inputs should look interactive,Use distinct input styling,Inputs that look like plain text,Border/background on inputs,Borderless inputs,Medium
+63,Forms,Mobile Keyboards,Mobile,Show appropriate keyboard for input type,Use inputmode attribute,Default keyboard for all inputs,inputmode='numeric',Text keyboard for numbers,Medium
+64,Responsive,Mobile First,Web,Design for mobile then enhance for larger,Start with mobile styles then add breakpoints,Desktop-first causing mobile issues,Default mobile + md: lg: xl:,Desktop default + max-width queries,Medium
+65,Responsive,Breakpoint Testing,Web,Test at all common screen sizes,Test at 320 375 414 768 1024 1440,Only test on your device,Multiple device testing,Single device development,Medium
+66,Responsive,Touch Friendly,Web,Mobile layouts need touch-sized targets,Increase touch targets on mobile,Same tiny buttons on mobile,Larger buttons on mobile,Desktop-sized targets on mobile,High
+67,Responsive,Readable Font Size,All,Text must be readable on all devices,Minimum 16px body text on mobile,Tiny text on mobile,text-base or larger,text-xs for body text,High
+68,Responsive,Viewport Meta,Web,Set viewport for mobile devices,Use width=device-width initial-scale=1,Missing or incorrect viewport,<meta name='viewport'...>,No viewport meta tag,High
+69,Responsive,Horizontal Scroll,Web,Avoid horizontal scrolling,Ensure content fits viewport width,Content wider than viewport,max-w-full overflow-x-hidden,Horizontal scrollbar on mobile,High
+70,Responsive,Image Scaling,Web,Images should scale with container,Use max-width: 100% on images,Fixed width images overflow,max-w-full h-auto,width='800' fixed,Medium
+71,Responsive,Table Handling,Web,Tables can overflow on mobile,Use horizontal scroll or card layout,Wide tables breaking layout,overflow-x-auto wrapper,Table overflows viewport,Medium
+72,Typography,Line Height,All,Adequate line height improves readability,Use 1.5-1.75 for body text,Cramped or excessive line height,leading-relaxed (1.625),leading-none (1),Medium
+73,Typography,Line Length,Web,Long lines are hard to read,Limit to 65-75 characters per line,Full-width text on large screens,max-w-prose,Full viewport width text,Medium
+74,Typography,Font Size Scale,All,Consistent type hierarchy aids scanning,Use consistent modular scale,Random font sizes,Type scale (12 14 16 18 24 32),Arbitrary sizes,Medium
+75,Typography,Font Loading,Web,Fonts should load without layout shift,Reserve space with fallback font,Layout shift when fonts load,font-display: swap + similar fallback,No fallback font,Medium
+76,Typography,Contrast Readability,All,Body text needs good contrast,Use darker text on light backgrounds,Gray text on gray background,text-gray-900 on white,text-gray-400 on gray-100,High
+77,Typography,Heading Clarity,All,Headings should stand out from body,Clear size/weight difference,Headings similar to body text,Bold + larger size,Same size as body,Medium
+78,Feedback,Loading Indicators,All,Show system status during waits,Show spinner/skeleton for operations > 300ms,No feedback during loading,Skeleton or spinner,Frozen UI,High
+79,Feedback,Empty States,All,Guide users when no content exists,Show helpful message and action,Blank empty screens,No items yet. Create one!,Empty white space,Medium
+80,Feedback,Error Recovery,All,Help users recover from errors,Provide clear next steps,Error without recovery path,Try again button + help link,Error message only,Medium
+81,Feedback,Progress Indicators,All,Show progress for multi-step processes,Step indicators or progress bar,No indication of progress,Step 2 of 4 indicator,No step information,Medium
+82,Feedback,Toast Notifications,All,Transient messages for non-critical info,Auto-dismiss after 3-5 seconds,Toasts that never disappear,Auto-dismiss toast,Persistent toast,Medium
+83,Feedback,Confirmation Messages,All,Confirm successful actions,Brief success message,Silent success,Saved successfully toast,No confirmation,Medium
+84,Content,Truncation,All,Handle long content gracefully,Truncate with ellipsis and expand option,Overflow or broken layout,line-clamp-2 with expand,Overflow or cut off,Medium
+85,Content,Date Formatting,All,Use locale-appropriate date formats,Use relative or locale-aware dates,Ambiguous date formats,2 hours ago or locale format,01/02/03,Low
+86,Content,Number Formatting,All,Format large numbers for readability,Use thousand separators or abbreviations,Long unformatted numbers,"1.2K or 1,234",1234567,Low
+87,Content,Placeholder Content,All,Show realistic placeholders during dev,Use realistic sample data,Lorem ipsum everywhere,Real sample content,Lorem ipsum,Low
+88,Onboarding,User Freedom,All,Users should be able to skip tutorials,Provide Skip and Back buttons,Force linear unskippable tour,Skip Tutorial button,Locked overlay until finished,Medium
+89,Search,Autocomplete,Web,Help users find results faster,Show predictions as user types,Require full type and enter,Debounced fetch + dropdown,No suggestions,Medium
+90,Search,No Results,Web,Dead ends frustrate users,Show 'No results' with suggestions,Blank screen or '0 results',Try searching for X instead,No results found.,Medium
+91,Data Entry,Bulk Actions,Web,Editing one by one is tedious,Allow multi-select and bulk edit,Single row actions only,Checkbox column + Action bar,Repeated actions per row,Low
+92,AI Interaction,Disclaimer,All,Users need to know they talk to AI,Clearly label AI generated content,Present AI as human,AI Assistant label,Fake human name without label,High
+93,AI Interaction,Streaming,All,Waiting for full text is slow,Stream text response token by token,Show loading spinner for 10s+,Typewriter effect,Spinner until 100% complete,Medium
+94,Spatial UI,Gaze Hover,VisionOS,Elements should respond to eye tracking before pinch,Scale/highlight element on look,Static element until pinch,hoverEffect(),onTap only,High
+95,Spatial UI,Depth Layering,VisionOS,UI needs Z-depth to separate content from environment,Use glass material and z-offset,Flat opaque panels blocking view,.glassBackgroundEffect(),bg-white,Medium
+96,Sustainability,Auto-Play Video,Web,Video consumes massive data and energy,Click-to-play or pause when off-screen,Auto-play high-res video loops,playsInline muted preload='none',autoplay loop,Medium
+97,Sustainability,Asset Weight,Web,Heavy 3D/Image assets increase carbon footprint,Compress and lazy load 3D models,Load 50MB textures,Draco compression,Raw .obj files,Medium
+98,AI Interaction,Feedback Loop,All,AI needs user feedback to improve,Thumps up/down or 'Regenerate',Static output only,Feedback component,Read-only text,Low
+99,Accessibility,Motion Sensitivity,All,Parallax/Scroll-jacking causes nausea,Respect prefers-reduced-motion,Force scroll effects,@media (prefers-reduced-motion),ScrollTrigger.create(),High
\ No newline at end of file
diff --git a/.claude/skills/ui-ux-pro-max/data/web-interface.csv b/.claude/skills/ui-ux-pro-max/data/web-interface.csv
new file mode 100644
index 0000000..4713aad
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/data/web-interface.csv
@@ -0,0 +1,31 @@
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Accessibility,Icon Button Labels,icon button aria-label,Web,Icon-only buttons must have accessible names,Add aria-label to icon buttons,Icon button without label,"<button aria-label='Close'><XIcon /></button>","<button><XIcon /></button>",Critical
+2,Accessibility,Form Control Labels,form input label aria,Web,All form controls need labels or aria-label,Use label element or aria-label,Input without accessible name,"<label for='email'>Email</label><input id='email' />","<input placeholder='Email' />",Critical
+3,Accessibility,Keyboard Handlers,keyboard onclick onkeydown,Web,Interactive elements must support keyboard interaction,Add onKeyDown alongside onClick,Click-only interaction,"<div onClick={fn} onKeyDown={fn} tabIndex={0}>","<div onClick={fn}>",High
+4,Accessibility,Semantic HTML,semantic button a label,Web,Use semantic HTML before ARIA attributes,Use button/a/label elements,Div with role attribute,"<button onClick={fn}>Submit</button>","<div role='button' onClick={fn}>Submit</div>",High
+5,Accessibility,Aria Live,aria-live polite async,Web,Async updates need aria-live for screen readers,Add aria-live='polite' for dynamic content,Silent async updates,"<div aria-live='polite'>{status}</div>","<div>{status}</div> // no announcement",Medium
+6,Accessibility,Decorative Icons,aria-hidden decorative icon,Web,Decorative icons should be hidden from screen readers,Add aria-hidden='true' to decorative icons,Decorative icon announced,"<Icon aria-hidden='true' />","<Icon /> // announced as 'image'",Medium
+7,Focus,Visible Focus States,focus-visible outline ring,Web,All interactive elements need visible focus states,Use :focus-visible with ring/outline,No focus indication,"focus-visible:ring-2 focus-visible:ring-blue-500","outline-none // no replacement",Critical
+8,Focus,Never Remove Outline,outline-none focus replacement,Web,Never remove outline without providing replacement,Replace outline with visible alternative,Remove outline completely,"focus:outline-none focus:ring-2","focus:outline-none // nothing else",Critical
+9,Focus,Checkbox Radio Hit Target,checkbox radio label target,Web,Checkbox/radio must share hit target with label,Wrap input and label together,Separate tiny checkbox,"<label class='flex gap-2'><input type='checkbox' /><span>Option</span></label>","<input type='checkbox' id='x' /><label for='x'>Option</label>",Medium
+10,Forms,Autocomplete Attribute,autocomplete input form,Web,Inputs need autocomplete attribute for autofill,Add appropriate autocomplete value,Missing autocomplete,"<input autocomplete='email' type='email' />","<input type='email' />",High
+11,Forms,Semantic Input Types,input type email tel url,Web,Use semantic input type attributes,Use email/tel/url/number types,text type for everything,"<input type='email' />","<input type='text' /> // for email",Medium
+12,Forms,Never Block Paste,paste onpaste password,Web,Never prevent paste functionality,Allow paste on all inputs,Block paste on password/code,"<input type='password' />","<input onPaste={e => e.preventDefault()} />",High
+13,Forms,Spellcheck Disable,spellcheck email code,Web,Disable spellcheck on emails and codes,Set spellcheck='false' on codes,Spellcheck on technical input,"<input spellCheck='false' type='email' />","<input type='email' /> // red squiggles",Low
+14,Forms,Submit Button Enabled,submit button disabled loading,Web,Keep submit enabled and show spinner during requests,Show loading spinner keep enabled,Disable button during submit,"<button>{loading ? <Spinner /> : 'Submit'}</button>","<button disabled={loading}>Submit</button>",Medium
+15,Forms,Inline Errors,error message inline focus,Web,Show error messages inline near the problem field,Inline error with focus on first error,Single error at top,"<input /><span class='text-red-500'>{error}</span>","<div class='error'>{allErrors}</div> // at top",High
+16,Performance,Virtualize Lists,virtualize list 50 items,Web,Virtualize lists exceeding 50 items,Use virtual list for large datasets,Render all items,"<VirtualList items={items} />","items.map(item => <Item />)",High
+17,Performance,Avoid Layout Reads,layout read render getboundingclientrect,Web,Avoid layout reads during render phase,Read layout in effects or callbacks,getBoundingClientRect in render,"useEffect(() => { el.getBoundingClientRect() })","const rect = el.getBoundingClientRect() // in render",Medium
+18,Performance,Batch DOM Operations,batch dom write read,Web,Group DOM operations to minimize reflows,Batch writes then reads,Interleave reads and writes,"writes.forEach(w => w()); reads.forEach(r => r())","write(); read(); write(); read(); // thrashing",Medium
+19,Performance,Preconnect CDN,preconnect link cdn,Web,Add preconnect links for CDN domains,Preconnect to known domains,"<link rel='preconnect' href='https://cdn.example.com' />","// no preconnect hint",Low
+20,Performance,Lazy Load Images,lazy loading image below-fold,Web,Lazy-load images below the fold,Use loading='lazy' for below-fold images,Load all images eagerly,"<img loading='lazy' src='...' />","<img src='...' /> // above fold only",Medium
+21,State,URL Reflects State,url state query params,Web,URL should reflect current UI state,Sync filters/tabs/pagination to URL,State only in memory,"?tab=settings&page=2","useState only // lost on refresh",High
+22,State,Deep Linking,deep link stateful component,Web,Stateful components should support deep-linking,Enable sharing current view via URL,No shareable state,"router.push({ query: { ...filters } })","setFilters(f) // not in URL",Medium
+23,State,Confirm Destructive Actions,confirm destructive delete modal,Web,Destructive actions require confirmation,Show confirmation dialog before delete,Delete without confirmation,"if (confirm('Delete?')) delete()","onClick={delete} // no confirmation",High
+24,Typography,Proper Unicode,unicode ellipsis quotes,Web,Use proper Unicode characters,Use ... curly quotes proper dashes,ASCII approximations,"'Hello...' with proper ellipsis","'Hello...' with three dots",Low
+25,Typography,Text Overflow,truncate line-clamp overflow,Web,Handle text overflow properly,Use truncate/line-clamp/break-words,Text overflows container,"<p class='truncate'>Long text...</p>","<p>Long text...</p> // overflows",Medium
+26,Typography,Non-Breaking Spaces,nbsp unit brand,Web,Use non-breaking spaces for units and brand names,Use &nbsp; between number and unit,"10&nbsp;kg or Next.js&nbsp;14","10 kg // may wrap",Low
+27,Anti-Pattern,No Zoom Disable,viewport zoom disable,Web,Never disable zoom in viewport meta,Allow user zoom,"<meta name='viewport' content='width=device-width'>","<meta name='viewport' content='maximum-scale=1'>",Critical
+28,Anti-Pattern,No Transition All,transition all specific,Web,Avoid transition: all - specify properties,Transition specific properties,transition: all,"transition-colors duration-200","transition-all duration-200",Medium
+29,Anti-Pattern,Outline Replacement,outline-none ring focus,Web,Never use outline-none without replacement,Provide visible focus replacement,Remove outline with nothing,"focus:outline-none focus:ring-2 focus:ring-blue-500","focus:outline-none // alone",Critical
+30,Anti-Pattern,No Hardcoded Dates,date format intl locale,Web,Use Intl for date/number formatting,Use Intl.DateTimeFormat,Hardcoded date format,"new Intl.DateTimeFormat('en').format(date)","date.toLocaleDateString() // or manual format",Medium
diff --git a/.claude/skills/ui-ux-pro-max/scripts/core.py b/.claude/skills/ui-ux-pro-max/scripts/core.py
new file mode 100644
index 0000000..f491e7b
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/scripts/core.py
@@ -0,0 +1,257 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Core - BM25 search engine for UI/UX style guides
+"""
+
+import csv
+import re
+from pathlib import Path
+from math import log
+from collections import defaultdict
+
+# ============ CONFIGURATION ============
+DATA_DIR = Path(__file__).parent.parent / "data"
+MAX_RESULTS = 3
+
+CSV_CONFIG = {
+    "style": {
+        "file": "styles.csv",
+        "search_cols": ["Style Category", "Keywords", "Best For", "Type"],
+        "output_cols": ["Style Category", "Type", "Keywords", "Primary Colors", "Effects & Animation", "Best For", "Performance", "Accessibility", "Framework Compatibility", "Complexity"]
+    },
+    "prompt": {
+        "file": "prompts.csv",
+        "search_cols": ["Style Category", "AI Prompt Keywords (Copy-Paste Ready)", "CSS/Technical Keywords"],
+        "output_cols": ["Style Category", "AI Prompt Keywords (Copy-Paste Ready)", "CSS/Technical Keywords", "Implementation Checklist"]
+    },
+    "color": {
+        "file": "colors.csv",
+        "search_cols": ["Product Type", "Keywords", "Notes"],
+        "output_cols": ["Product Type", "Keywords", "Primary (Hex)", "Secondary (Hex)", "CTA (Hex)", "Background (Hex)", "Text (Hex)", "Border (Hex)", "Notes"]
+    },
+    "chart": {
+        "file": "charts.csv",
+        "search_cols": ["Data Type", "Keywords", "Best Chart Type", "Accessibility Notes"],
+        "output_cols": ["Data Type", "Keywords", "Best Chart Type", "Secondary Options", "Color Guidance", "Accessibility Notes", "Library Recommendation", "Interactive Level"]
+    },
+    "landing": {
+        "file": "landing.csv",
+        "search_cols": ["Pattern Name", "Keywords", "Conversion Optimization", "Section Order"],
+        "output_cols": ["Pattern Name", "Keywords", "Section Order", "Primary CTA Placement", "Color Strategy", "Conversion Optimization"]
+    },
+    "product": {
+        "file": "products.csv",
+        "search_cols": ["Product Type", "Keywords", "Primary Style Recommendation", "Key Considerations"],
+        "output_cols": ["Product Type", "Keywords", "Primary Style Recommendation", "Secondary Styles", "Landing Page Pattern", "Dashboard Style (if applicable)", "Color Palette Focus"]
+    },
+    "ux": {
+        "file": "ux-guidelines.csv",
+        "search_cols": ["Category", "Issue", "Description", "Platform"],
+        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
+    },
+    "typography": {
+        "file": "typography.csv",
+        "search_cols": ["Font Pairing Name", "Category", "Mood/Style Keywords", "Best For", "Heading Font", "Body Font"],
+        "output_cols": ["Font Pairing Name", "Category", "Heading Font", "Body Font", "Mood/Style Keywords", "Best For", "Google Fonts URL", "CSS Import", "Tailwind Config", "Notes"]
+    },
+    "icons": {
+        "file": "icons.csv",
+        "search_cols": ["Category", "Icon Name", "Keywords", "Best For"],
+        "output_cols": ["Category", "Icon Name", "Keywords", "Library", "Import Code", "Usage", "Best For", "Style"]
+    },
+    "react": {
+        "file": "react-performance.csv",
+        "search_cols": ["Category", "Issue", "Keywords", "Description"],
+        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
+    },
+    "web": {
+        "file": "web-interface.csv",
+        "search_cols": ["Category", "Issue", "Keywords", "Description"],
+        "output_cols": ["Category", "Issue", "Platform", "Description", "Do", "Don't", "Code Example Good", "Code Example Bad", "Severity"]
+    }
+}
+
+STACK_CONFIG = {
+    "html-tailwind": {"file": "stacks/html-tailwind.csv"},
+    "react": {"file": "stacks/react.csv"},
+    "nextjs": {"file": "stacks/nextjs.csv"},
+    "vue": {"file": "stacks/vue.csv"},
+    "nuxtjs": {"file": "stacks/nuxtjs.csv"},
+    "nuxt-ui": {"file": "stacks/nuxt-ui.csv"},
+    "svelte": {"file": "stacks/svelte.csv"},
+    "swiftui": {"file": "stacks/swiftui.csv"},
+    "react-native": {"file": "stacks/react-native.csv"},
+    "flutter": {"file": "stacks/flutter.csv"},
+    "shadcn": {"file": "stacks/shadcn.csv"}
+}
+
+# Common columns for all stacks
+_STACK_COLS = {
+    "search_cols": ["Category", "Guideline", "Description", "Do", "Don't"],
+    "output_cols": ["Category", "Guideline", "Description", "Do", "Don't", "Code Good", "Code Bad", "Severity", "Docs URL"]
+}
+
+AVAILABLE_STACKS = list(STACK_CONFIG.keys())
+
+
+# ============ BM25 IMPLEMENTATION ============
+class BM25:
+    """BM25 ranking algorithm for text search"""
+
+    def __init__(self, k1=1.5, b=0.75):
+        self.k1 = k1
+        self.b = b
+        self.corpus = []
+        self.doc_lengths = []
+        self.avgdl = 0
+        self.idf = {}
+        self.doc_freqs = defaultdict(int)
+        self.N = 0
+
+    def tokenize(self, text):
+        """Lowercase, split, remove punctuation, filter short words"""
+        text = re.sub(r'[^\w\s]', ' ', str(text).lower())
+        return [w for w in text.split() if len(w) > 2]
+
+    def fit(self, documents):
+        """Build BM25 index from documents"""
+        self.corpus = [self.tokenize(doc) for doc in documents]
+        self.N = len(self.corpus)
+        if self.N == 0:
+            return
+        self.doc_lengths = [len(doc) for doc in self.corpus]
+        self.avgdl = sum(self.doc_lengths) / self.N
+
+        for doc in self.corpus:
+            seen = set()
+            for word in doc:
+                if word not in seen:
+                    self.doc_freqs[word] += 1
+                    seen.add(word)
+
+        for word, freq in self.doc_freqs.items():
+            self.idf[word] = log((self.N - freq + 0.5) / (freq + 0.5) + 1)
+
+    def score(self, query):
+        """Score all documents against query"""
+        query_tokens = self.tokenize(query)
+        scores = []
+
+        for idx, doc in enumerate(self.corpus):
+            score = 0
+            doc_len = self.doc_lengths[idx]
+            term_freqs = defaultdict(int)
+            for word in doc:
+                term_freqs[word] += 1
+
+            for token in query_tokens:
+                if token in self.idf:
+                    tf = term_freqs[token]
+                    idf = self.idf[token]
+                    numerator = tf * (self.k1 + 1)
+                    denominator = tf + self.k1 * (1 - self.b + self.b * doc_len / self.avgdl)
+                    score += idf * numerator / denominator
+
+            scores.append((idx, score))
+
+        return sorted(scores, key=lambda x: x[1], reverse=True)
+
+
+# ============ SEARCH FUNCTIONS ============
+def _load_csv(filepath):
+    """Load CSV and return list of dicts"""
+    with open(filepath, 'r', encoding='utf-8') as f:
+        return list(csv.DictReader(f))
+
+
+def _search_csv(filepath, search_cols, output_cols, query, max_results):
+    """Core search function using BM25"""
+    if not filepath.exists():
+        return []
+
+    data = _load_csv(filepath)
+
+    # Build documents from search columns
+    documents = [" ".join(str(row.get(col, "")) for col in search_cols) for row in data]
+
+    # BM25 search
+    bm25 = BM25()
+    bm25.fit(documents)
+    ranked = bm25.score(query)
+
+    # Get top results with score > 0
+    results = []
+    for idx, score in ranked[:max_results]:
+        if score > 0:
+            row = data[idx]
+            results.append({col: row.get(col, "") for col in output_cols if col in row})
+
+    return results
+
+
+def detect_domain(query):
+    """Auto-detect the most relevant domain from query"""
+    query_lower = query.lower()
+
+    domain_keywords = {
+        "color": ["color", "palette", "hex", "#", "rgb"],
+        "chart": ["chart", "graph", "visualization", "trend", "bar", "pie", "scatter", "heatmap", "funnel"],
+        "landing": ["landing", "page", "cta", "conversion", "hero", "testimonial", "pricing", "section"],
+        "product": ["saas", "ecommerce", "e-commerce", "fintech", "healthcare", "gaming", "portfolio", "crypto", "dashboard"],
+        "prompt": ["prompt", "css", "implementation", "variable", "checklist", "tailwind"],
+        "style": ["style", "design", "ui", "minimalism", "glassmorphism", "neumorphism", "brutalism", "dark mode", "flat", "aurora"],
+        "ux": ["ux", "usability", "accessibility", "wcag", "touch", "scroll", "animation", "keyboard", "navigation", "mobile"],
+        "typography": ["font", "typography", "heading", "serif", "sans"],
+        "icons": ["icon", "icons", "lucide", "heroicons", "symbol", "glyph", "pictogram", "svg icon"],
+        "react": ["react", "next.js", "nextjs", "suspense", "memo", "usecallback", "useeffect", "rerender", "bundle", "waterfall", "barrel", "dynamic import", "rsc", "server component"],
+        "web": ["aria", "focus", "outline", "semantic", "virtualize", "autocomplete", "form", "input type", "preconnect"]
+    }
+
+    scores = {domain: sum(1 for kw in keywords if kw in query_lower) for domain, keywords in domain_keywords.items()}
+    best = max(scores, key=scores.get)
+    return best if scores[best] > 0 else "style"
+
+
+def search(query, domain=None, max_results=MAX_RESULTS):
+    """Main search function with auto-domain detection"""
+    if domain is None:
+        domain = detect_domain(query)
+
+    config = CSV_CONFIG.get(domain, CSV_CONFIG["style"])
+    filepath = DATA_DIR / config["file"]
+
+    if not filepath.exists():
+        return {"error": f"File not found: {filepath}", "domain": domain}
+
+    results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results)
+
+    return {
+        "domain": domain,
+        "query": query,
+        "file": config["file"],
+        "count": len(results),
+        "results": results
+    }
+
+
+def search_stack(query, stack, max_results=MAX_RESULTS):
+    """Search stack-specific guidelines"""
+    if stack not in STACK_CONFIG:
+        return {"error": f"Unknown stack: {stack}. Available: {', '.join(AVAILABLE_STACKS)}"}
+
+    filepath = DATA_DIR / STACK_CONFIG[stack]["file"]
+
+    if not filepath.exists():
+        return {"error": f"Stack file not found: {filepath}", "stack": stack}
+
+    results = _search_csv(filepath, _STACK_COLS["search_cols"], _STACK_COLS["output_cols"], query, max_results)
+
+    return {
+        "domain": "stack",
+        "stack": stack,
+        "query": query,
+        "file": STACK_CONFIG[stack]["file"],
+        "count": len(results),
+        "results": results
+    }
diff --git a/.claude/skills/ui-ux-pro-max/scripts/design_system.py b/.claude/skills/ui-ux-pro-max/scripts/design_system.py
new file mode 100644
index 0000000..4e19b52
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/scripts/design_system.py
@@ -0,0 +1,487 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Design System Generator - Aggregates search results and applies reasoning
+to generate comprehensive design system recommendations.
+
+Usage:
+    from design_system import generate_design_system
+    result = generate_design_system("SaaS dashboard", "My Project")
+"""
+
+import csv
+import json
+from pathlib import Path
+from core import search, DATA_DIR
+
+
+# ============ CONFIGURATION ============
+REASONING_FILE = "ui-reasoning.csv"
+
+SEARCH_CONFIG = {
+    "product": {"max_results": 1},
+    "style": {"max_results": 3},
+    "color": {"max_results": 2},
+    "landing": {"max_results": 2},
+    "typography": {"max_results": 2}
+}
+
+
+# ============ DESIGN SYSTEM GENERATOR ============
+class DesignSystemGenerator:
+    """Generates design system recommendations from aggregated searches."""
+
+    def __init__(self):
+        self.reasoning_data = self._load_reasoning()
+
+    def _load_reasoning(self) -> list:
+        """Load reasoning rules from CSV."""
+        filepath = DATA_DIR / REASONING_FILE
+        if not filepath.exists():
+            return []
+        with open(filepath, 'r', encoding='utf-8') as f:
+            return list(csv.DictReader(f))
+
+    def _multi_domain_search(self, query: str, style_priority: list = None) -> dict:
+        """Execute searches across multiple domains."""
+        results = {}
+        for domain, config in SEARCH_CONFIG.items():
+            if domain == "style" and style_priority:
+                # For style, also search with priority keywords
+                priority_query = " ".join(style_priority[:2]) if style_priority else query
+                combined_query = f"{query} {priority_query}"
+                results[domain] = search(combined_query, domain, config["max_results"])
+            else:
+                results[domain] = search(query, domain, config["max_results"])
+        return results
+
+    def _find_reasoning_rule(self, category: str) -> dict:
+        """Find matching reasoning rule for a category."""
+        category_lower = category.lower()
+
+        # Try exact match first
+        for rule in self.reasoning_data:
+            if rule.get("UI_Category", "").lower() == category_lower:
+                return rule
+
+        # Try partial match
+        for rule in self.reasoning_data:
+            ui_cat = rule.get("UI_Category", "").lower()
+            if ui_cat in category_lower or category_lower in ui_cat:
+                return rule
+
+        # Try keyword match
+        for rule in self.reasoning_data:
+            ui_cat = rule.get("UI_Category", "").lower()
+            keywords = ui_cat.replace("/", " ").replace("-", " ").split()
+            if any(kw in category_lower for kw in keywords):
+                return rule
+
+        return {}
+
+    def _apply_reasoning(self, category: str, search_results: dict) -> dict:
+        """Apply reasoning rules to search results."""
+        rule = self._find_reasoning_rule(category)
+
+        if not rule:
+            return {
+                "pattern": "Hero + Features + CTA",
+                "style_priority": ["Minimalism", "Flat Design"],
+                "color_mood": "Professional",
+                "typography_mood": "Clean",
+                "key_effects": "Subtle hover transitions",
+                "anti_patterns": "",
+                "decision_rules": {},
+                "severity": "MEDIUM"
+            }
+
+        # Parse decision rules JSON
+        decision_rules = {}
+        try:
+            decision_rules = json.loads(rule.get("Decision_Rules", "{}"))
+        except json.JSONDecodeError:
+            pass
+
+        return {
+            "pattern": rule.get("Recommended_Pattern", ""),
+            "style_priority": [s.strip() for s in rule.get("Style_Priority", "").split("+")],
+            "color_mood": rule.get("Color_Mood", ""),
+            "typography_mood": rule.get("Typography_Mood", ""),
+            "key_effects": rule.get("Key_Effects", ""),
+            "anti_patterns": rule.get("Anti_Patterns", ""),
+            "decision_rules": decision_rules,
+            "severity": rule.get("Severity", "MEDIUM")
+        }
+
+    def _select_best_match(self, results: list, priority_keywords: list) -> dict:
+        """Select best matching result based on priority keywords."""
+        if not results:
+            return {}
+
+        if not priority_keywords:
+            return results[0]
+
+        # First: try exact style name match
+        for priority in priority_keywords:
+            priority_lower = priority.lower().strip()
+            for result in results:
+                style_name = result.get("Style Category", "").lower()
+                if priority_lower in style_name or style_name in priority_lower:
+                    return result
+
+        # Second: score by keyword match in all fields
+        scored = []
+        for result in results:
+            result_str = str(result).lower()
+            score = 0
+            for kw in priority_keywords:
+                kw_lower = kw.lower().strip()
+                # Higher score for style name match
+                if kw_lower in result.get("Style Category", "").lower():
+                    score += 10
+                # Lower score for keyword field match
+                elif kw_lower in result.get("Keywords", "").lower():
+                    score += 3
+                # Even lower for other field matches
+                elif kw_lower in result_str:
+                    score += 1
+            scored.append((score, result))
+
+        scored.sort(key=lambda x: x[0], reverse=True)
+        return scored[0][1] if scored and scored[0][0] > 0 else results[0]
+
+    def _extract_results(self, search_result: dict) -> list:
+        """Extract results list from search result dict."""
+        return search_result.get("results", [])
+
+    def generate(self, query: str, project_name: str = None) -> dict:
+        """Generate complete design system recommendation."""
+        # Step 1: First search product to get category
+        product_result = search(query, "product", 1)
+        product_results = product_result.get("results", [])
+        category = "General"
+        if product_results:
+            category = product_results[0].get("Product Type", "General")
+
+        # Step 2: Get reasoning rules for this category
+        reasoning = self._apply_reasoning(category, {})
+        style_priority = reasoning.get("style_priority", [])
+
+        # Step 3: Multi-domain search with style priority hints
+        search_results = self._multi_domain_search(query, style_priority)
+        search_results["product"] = product_result  # Reuse product search
+
+        # Step 4: Select best matches from each domain using priority
+        style_results = self._extract_results(search_results.get("style", {}))
+        color_results = self._extract_results(search_results.get("color", {}))
+        typography_results = self._extract_results(search_results.get("typography", {}))
+        landing_results = self._extract_results(search_results.get("landing", {}))
+
+        best_style = self._select_best_match(style_results, reasoning.get("style_priority", []))
+        best_color = color_results[0] if color_results else {}
+        best_typography = typography_results[0] if typography_results else {}
+        best_landing = landing_results[0] if landing_results else {}
+
+        # Step 5: Build final recommendation
+        # Combine effects from both reasoning and style search
+        style_effects = best_style.get("Effects & Animation", "")
+        reasoning_effects = reasoning.get("key_effects", "")
+        combined_effects = style_effects if style_effects else reasoning_effects
+
+        return {
+            "project_name": project_name or query.upper(),
+            "category": category,
+            "pattern": {
+                "name": best_landing.get("Pattern Name", reasoning.get("pattern", "Hero + Features + CTA")),
+                "sections": best_landing.get("Section Order", "Hero > Features > CTA"),
+                "cta_placement": best_landing.get("Primary CTA Placement", "Above fold"),
+                "color_strategy": best_landing.get("Color Strategy", ""),
+                "conversion": best_landing.get("Conversion Optimization", "")
+            },
+            "style": {
+                "name": best_style.get("Style Category", "Minimalism"),
+                "type": best_style.get("Type", "General"),
+                "effects": style_effects,
+                "keywords": best_style.get("Keywords", ""),
+                "best_for": best_style.get("Best For", ""),
+                "performance": best_style.get("Performance", ""),
+                "accessibility": best_style.get("Accessibility", "")
+            },
+            "colors": {
+                "primary": best_color.get("Primary (Hex)", "#2563EB"),
+                "secondary": best_color.get("Secondary (Hex)", "#3B82F6"),
+                "cta": best_color.get("CTA (Hex)", "#F97316"),
+                "background": best_color.get("Background (Hex)", "#F8FAFC"),
+                "text": best_color.get("Text (Hex)", "#1E293B"),
+                "notes": best_color.get("Notes", "")
+            },
+            "typography": {
+                "heading": best_typography.get("Heading Font", "Inter"),
+                "body": best_typography.get("Body Font", "Inter"),
+                "mood": best_typography.get("Mood/Style Keywords", reasoning.get("typography_mood", "")),
+                "best_for": best_typography.get("Best For", ""),
+                "google_fonts_url": best_typography.get("Google Fonts URL", ""),
+                "css_import": best_typography.get("CSS Import", "")
+            },
+            "key_effects": combined_effects,
+            "anti_patterns": reasoning.get("anti_patterns", ""),
+            "decision_rules": reasoning.get("decision_rules", {}),
+            "severity": reasoning.get("severity", "MEDIUM")
+        }
+
+
+# ============ OUTPUT FORMATTERS ============
+BOX_WIDTH = 90  # Wider box for more content
+
+def format_ascii_box(design_system: dict) -> str:
+    """Format design system as ASCII box with emojis (MCP-style)."""
+    project = design_system.get("project_name", "PROJECT")
+    pattern = design_system.get("pattern", {})
+    style = design_system.get("style", {})
+    colors = design_system.get("colors", {})
+    typography = design_system.get("typography", {})
+    effects = design_system.get("key_effects", "")
+    anti_patterns = design_system.get("anti_patterns", "")
+
+    def wrap_text(text: str, prefix: str, width: int) -> list:
+        """Wrap long text into multiple lines."""
+        if not text:
+            return []
+        words = text.split()
+        lines = []
+        current_line = prefix
+        for word in words:
+            if len(current_line) + len(word) + 1 <= width - 2:
+                current_line += (" " if current_line != prefix else "") + word
+            else:
+                if current_line != prefix:
+                    lines.append(current_line)
+                current_line = prefix + word
+        if current_line != prefix:
+            lines.append(current_line)
+        return lines
+
+    # Build sections from pattern
+    sections = pattern.get("sections", "").split(">")
+    sections = [s.strip() for s in sections if s.strip()]
+
+    # Build output lines
+    lines = []
+    w = BOX_WIDTH - 1
+
+    lines.append("+" + "-" * w + "+")
+    lines.append(f"|  TARGET: {project} - RECOMMENDED DESIGN SYSTEM".ljust(BOX_WIDTH) + "|")
+    lines.append("+" + "-" * w + "+")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Pattern section
+    lines.append(f"|  PATTERN: {pattern.get('name', '')}".ljust(BOX_WIDTH) + "|")
+    if pattern.get('conversion'):
+        lines.append(f"|     Conversion: {pattern.get('conversion', '')}".ljust(BOX_WIDTH) + "|")
+    if pattern.get('cta_placement'):
+        lines.append(f"|     CTA: {pattern.get('cta_placement', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append("|     Sections:".ljust(BOX_WIDTH) + "|")
+    for i, section in enumerate(sections, 1):
+        lines.append(f"|       {i}. {section}".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Style section
+    lines.append(f"|  STYLE: {style.get('name', '')}".ljust(BOX_WIDTH) + "|")
+    if style.get("keywords"):
+        for line in wrap_text(f"Keywords: {style.get('keywords', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if style.get("best_for"):
+        for line in wrap_text(f"Best For: {style.get('best_for', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if style.get("performance") or style.get("accessibility"):
+        perf_a11y = f"Performance: {style.get('performance', '')} | Accessibility: {style.get('accessibility', '')}"
+        lines.append(f"|     {perf_a11y}".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Colors section
+    lines.append("|  COLORS:".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Primary:    {colors.get('primary', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Secondary:  {colors.get('secondary', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     CTA:        {colors.get('cta', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Background: {colors.get('background', '')}".ljust(BOX_WIDTH) + "|")
+    lines.append(f"|     Text:       {colors.get('text', '')}".ljust(BOX_WIDTH) + "|")
+    if colors.get("notes"):
+        for line in wrap_text(f"Notes: {colors.get('notes', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Typography section
+    lines.append(f"|  TYPOGRAPHY: {typography.get('heading', '')} / {typography.get('body', '')}".ljust(BOX_WIDTH) + "|")
+    if typography.get("mood"):
+        for line in wrap_text(f"Mood: {typography.get('mood', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if typography.get("best_for"):
+        for line in wrap_text(f"Best For: {typography.get('best_for', '')}", "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+    if typography.get("google_fonts_url"):
+        lines.append(f"|     Google Fonts: {typography.get('google_fonts_url', '')}".ljust(BOX_WIDTH) + "|")
+    if typography.get("css_import"):
+        lines.append(f"|     CSS Import: {typography.get('css_import', '')[:70]}...".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Key Effects section
+    if effects:
+        lines.append("|  KEY EFFECTS:".ljust(BOX_WIDTH) + "|")
+        for line in wrap_text(effects, "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+        lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Anti-patterns section
+    if anti_patterns:
+        lines.append("|  AVOID (Anti-patterns):".ljust(BOX_WIDTH) + "|")
+        for line in wrap_text(anti_patterns, "|     ", BOX_WIDTH):
+            lines.append(line.ljust(BOX_WIDTH) + "|")
+        lines.append("|" + " " * BOX_WIDTH + "|")
+
+    # Pre-Delivery Checklist section
+    lines.append("|  PRE-DELIVERY CHECKLIST:".ljust(BOX_WIDTH) + "|")
+    checklist_items = [
+        "[ ] No emojis as icons (use SVG: Heroicons/Lucide)",
+        "[ ] cursor-pointer on all clickable elements",
+        "[ ] Hover states with smooth transitions (150-300ms)",
+        "[ ] Light mode: text contrast 4.5:1 minimum",
+        "[ ] Focus states visible for keyboard nav",
+        "[ ] prefers-reduced-motion respected",
+        "[ ] Responsive: 375px, 768px, 1024px, 1440px"
+    ]
+    for item in checklist_items:
+        lines.append(f"|     {item}".ljust(BOX_WIDTH) + "|")
+    lines.append("|" + " " * BOX_WIDTH + "|")
+
+    lines.append("+" + "-" * w + "+")
+
+    return "\n".join(lines)
+
+
+def format_markdown(design_system: dict) -> str:
+    """Format design system as markdown."""
+    project = design_system.get("project_name", "PROJECT")
+    pattern = design_system.get("pattern", {})
+    style = design_system.get("style", {})
+    colors = design_system.get("colors", {})
+    typography = design_system.get("typography", {})
+    effects = design_system.get("key_effects", "")
+    anti_patterns = design_system.get("anti_patterns", "")
+
+    lines = []
+    lines.append(f"## Design System: {project}")
+    lines.append("")
+
+    # Pattern section
+    lines.append("### Pattern")
+    lines.append(f"- **Name:** {pattern.get('name', '')}")
+    if pattern.get('conversion'):
+        lines.append(f"- **Conversion Focus:** {pattern.get('conversion', '')}")
+    if pattern.get('cta_placement'):
+        lines.append(f"- **CTA Placement:** {pattern.get('cta_placement', '')}")
+    if pattern.get('color_strategy'):
+        lines.append(f"- **Color Strategy:** {pattern.get('color_strategy', '')}")
+    lines.append(f"- **Sections:** {pattern.get('sections', '')}")
+    lines.append("")
+
+    # Style section
+    lines.append("### Style")
+    lines.append(f"- **Name:** {style.get('name', '')}")
+    if style.get('keywords'):
+        lines.append(f"- **Keywords:** {style.get('keywords', '')}")
+    if style.get('best_for'):
+        lines.append(f"- **Best For:** {style.get('best_for', '')}")
+    if style.get('performance') or style.get('accessibility'):
+        lines.append(f"- **Performance:** {style.get('performance', '')} | **Accessibility:** {style.get('accessibility', '')}")
+    lines.append("")
+
+    # Colors section
+    lines.append("### Colors")
+    lines.append(f"| Role | Hex |")
+    lines.append(f"|------|-----|")
+    lines.append(f"| Primary | {colors.get('primary', '')} |")
+    lines.append(f"| Secondary | {colors.get('secondary', '')} |")
+    lines.append(f"| CTA | {colors.get('cta', '')} |")
+    lines.append(f"| Background | {colors.get('background', '')} |")
+    lines.append(f"| Text | {colors.get('text', '')} |")
+    if colors.get("notes"):
+        lines.append(f"\n*Notes: {colors.get('notes', '')}*")
+    lines.append("")
+
+    # Typography section
+    lines.append("### Typography")
+    lines.append(f"- **Heading:** {typography.get('heading', '')}")
+    lines.append(f"- **Body:** {typography.get('body', '')}")
+    if typography.get("mood"):
+        lines.append(f"- **Mood:** {typography.get('mood', '')}")
+    if typography.get("best_for"):
+        lines.append(f"- **Best For:** {typography.get('best_for', '')}")
+    if typography.get("google_fonts_url"):
+        lines.append(f"- **Google Fonts:** {typography.get('google_fonts_url', '')}")
+    if typography.get("css_import"):
+        lines.append(f"- **CSS Import:**")
+        lines.append(f"```css")
+        lines.append(f"{typography.get('css_import', '')}")
+        lines.append(f"```")
+    lines.append("")
+
+    # Key Effects section
+    if effects:
+        lines.append("### Key Effects")
+        lines.append(f"{effects}")
+        lines.append("")
+
+    # Anti-patterns section
+    if anti_patterns:
+        lines.append("### Avoid (Anti-patterns)")
+        lines.append(f"- {anti_patterns.replace(' + ', '\n- ')}")
+        lines.append("")
+
+    # Pre-Delivery Checklist section
+    lines.append("### Pre-Delivery Checklist")
+    lines.append("- [ ] No emojis as icons (use SVG: Heroicons/Lucide)")
+    lines.append("- [ ] cursor-pointer on all clickable elements")
+    lines.append("- [ ] Hover states with smooth transitions (150-300ms)")
+    lines.append("- [ ] Light mode: text contrast 4.5:1 minimum")
+    lines.append("- [ ] Focus states visible for keyboard nav")
+    lines.append("- [ ] prefers-reduced-motion respected")
+    lines.append("- [ ] Responsive: 375px, 768px, 1024px, 1440px")
+    lines.append("")
+
+    return "\n".join(lines)
+
+
+# ============ MAIN ENTRY POINT ============
+def generate_design_system(query: str, project_name: str = None, output_format: str = "ascii") -> str:
+    """
+    Main entry point for design system generation.
+
+    Args:
+        query: Search query (e.g., "SaaS dashboard", "e-commerce luxury")
+        project_name: Optional project name for output header
+        output_format: "ascii" (default) or "markdown"
+
+    Returns:
+        Formatted design system string
+    """
+    generator = DesignSystemGenerator()
+    design_system = generator.generate(query, project_name)
+
+    if output_format == "markdown":
+        return format_markdown(design_system)
+    return format_ascii_box(design_system)
+
+
+# ============ CLI SUPPORT ============
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Generate Design System")
+    parser.add_argument("query", help="Search query (e.g., 'SaaS dashboard')")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format")
+
+    args = parser.parse_args()
+
+    result = generate_design_system(args.query, args.project_name, args.format)
+    print(result)
diff --git a/.claude/skills/ui-ux-pro-max/scripts/search.py b/.claude/skills/ui-ux-pro-max/scripts/search.py
new file mode 100644
index 0000000..00a38df
--- /dev/null
+++ b/.claude/skills/ui-ux-pro-max/scripts/search.py
@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+"""
+
+import argparse
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(args.query, args.project_name, args.format)
+        print(result)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
diff --git a/.claude/skills/ui-visual-validator/SKILL.md b/.claude/skills/ui-visual-validator/SKILL.md
new file mode 100644
index 0000000..0306b19
--- /dev/null
+++ b/.claude/skills/ui-visual-validator/SKILL.md
@@ -0,0 +1,214 @@
+---
+name: ui-visual-validator
+description: Rigorous visual validation expert specializing in UI testing,
+  design system compliance, and accessibility verification. Masters screenshot
+  analysis, visual regression testing, and component validation. Use PROACTIVELY
+  to verify UI modifications have achieved their intended goals through
+  comprehensive visual analysis.
+metadata:
+  model: sonnet
+---
+
+## Use this skill when
+
+- Working on ui visual validator tasks or workflows
+- Needing guidance, best practices, or checklists for ui visual validator
+
+## Do not use this skill when
+
+- The task is unrelated to ui visual validator
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are an experienced UI visual validation expert specializing in comprehensive visual testing and design verification through rigorous analysis methodologies.
+
+## Purpose
+
+Expert visual validation specialist focused on verifying UI modifications, design system compliance, and accessibility implementation through systematic visual analysis. Masters modern visual testing tools, automated regression testing, and human-centered design verification.
+
+## Core Principles
+
+- Default assumption: The modification goal has NOT been achieved until proven otherwise
+- Be highly critical and look for flaws, inconsistencies, or incomplete implementations
+- Ignore any code hints or implementation details - base judgments solely on visual evidence
+- Only accept clear, unambiguous visual proof that goals have been met
+- Apply accessibility standards and inclusive design principles to all evaluations
+
+## Capabilities
+
+### Visual Analysis Mastery
+
+- Screenshot analysis with pixel-perfect precision
+- Visual diff detection and change identification
+- Cross-browser and cross-device visual consistency verification
+- Responsive design validation across multiple breakpoints
+- Dark mode and theme consistency analysis
+- Animation and interaction state validation
+- Loading state and error state verification
+- Accessibility visual compliance assessment
+
+### Modern Visual Testing Tools
+
+- **Chromatic**: Visual regression testing for Storybook components
+- **Percy**: Cross-browser visual testing and screenshot comparison
+- **Applitools**: AI-powered visual testing and validation
+- **BackstopJS**: Automated visual regression testing framework
+- **Playwright Visual Comparisons**: Cross-browser visual testing
+- **Cypress Visual Testing**: End-to-end visual validation
+- **Jest Image Snapshot**: Component-level visual regression testing
+- **Storybook Visual Testing**: Isolated component validation
+
+### Design System Validation
+
+- Component library compliance verification
+- Design token implementation accuracy
+- Brand consistency and style guide adherence
+- Typography system implementation validation
+- Color palette and contrast ratio verification
+- Spacing and layout system compliance
+- Icon usage and visual consistency checking
+- Multi-brand design system validation
+
+### Accessibility Visual Verification
+
+- WCAG 2.1/2.2 visual compliance assessment
+- Color contrast ratio validation and measurement
+- Focus indicator visibility and design verification
+- Text scaling and readability assessment
+- Visual hierarchy and information architecture validation
+- Alternative text and semantic structure verification
+- Keyboard navigation visual feedback assessment
+- Screen reader compatible design verification
+
+### Cross-Platform Visual Consistency
+
+- Responsive design breakpoint validation
+- Mobile-first design implementation verification
+- Native app vs web consistency checking
+- Progressive Web App (PWA) visual compliance
+- Email client compatibility visual testing
+- Print stylesheet and layout verification
+- Device-specific adaptation validation
+- Platform-specific design guideline compliance
+
+### Automated Visual Testing Integration
+
+- CI/CD pipeline visual testing integration
+- GitHub Actions automated screenshot comparison
+- Visual regression testing in pull request workflows
+- Automated accessibility scanning and reporting
+- Performance impact visual analysis
+- Component library visual documentation generation
+- Multi-environment visual consistency testing
+- Automated design token compliance checking
+
+### Manual Visual Inspection Techniques
+
+- Systematic visual audit methodologies
+- Edge case and boundary condition identification
+- User flow visual consistency verification
+- Error handling and edge state validation
+- Loading and transition state analysis
+- Interactive element visual feedback assessment
+- Form validation and user feedback verification
+- Progressive disclosure and information architecture validation
+
+### Visual Quality Assurance
+
+- Pixel-perfect implementation verification
+- Image optimization and visual quality assessment
+- Typography rendering and font loading validation
+- Animation smoothness and performance verification
+- Visual hierarchy and readability assessment
+- Brand guideline compliance checking
+- Design specification accuracy verification
+- Cross-team design implementation consistency
+
+## Analysis Process
+
+1. **Objective Description First**: Describe exactly what is observed in the visual evidence without making assumptions
+2. **Goal Verification**: Compare each visual element against the stated modification goals systematically
+3. **Measurement Validation**: For changes involving rotation, position, size, or alignment, verify through visual measurement
+4. **Reverse Validation**: Actively look for evidence that the modification failed rather than succeeded
+5. **Critical Assessment**: Challenge whether apparent differences are actually the intended differences
+6. **Accessibility Evaluation**: Assess visual accessibility compliance and inclusive design implementation
+7. **Cross-Platform Consistency**: Verify visual consistency across different platforms and devices
+8. **Edge Case Analysis**: Examine edge cases, error states, and boundary conditions
+
+## Mandatory Verification Checklist
+
+- [ ] Have I described the actual visual content objectively?
+- [ ] Have I avoided inferring effects from code changes?
+- [ ] For rotations: Have I confirmed aspect ratio changes?
+- [ ] For positioning: Have I verified coordinate differences?
+- [ ] For sizing: Have I confirmed dimensional changes?
+- [ ] Have I validated color contrast ratios meet WCAG standards?
+- [ ] Have I checked focus indicators and keyboard navigation visuals?
+- [ ] Have I verified responsive breakpoint behavior?
+- [ ] Have I assessed loading states and transitions?
+- [ ] Have I validated error handling and edge cases?
+- [ ] Have I confirmed design system token compliance?
+- [ ] Have I actively searched for failure evidence?
+- [ ] Have I questioned whether 'different' equals 'correct'?
+
+## Advanced Validation Techniques
+
+- **Pixel Diff Analysis**: Precise change detection through pixel-level comparison
+- **Layout Shift Detection**: Cumulative Layout Shift (CLS) visual assessment
+- **Animation Frame Analysis**: Frame-by-frame animation validation
+- **Cross-Browser Matrix Testing**: Systematic multi-browser visual verification
+- **Accessibility Overlay Testing**: Visual validation with accessibility overlays
+- **High Contrast Mode Testing**: Visual validation in high contrast environments
+- **Reduced Motion Testing**: Animation and motion accessibility validation
+- **Print Preview Validation**: Print stylesheet and layout verification
+
+## Output Requirements
+
+- Start with 'From the visual evidence, I observe...'
+- Provide detailed visual measurements when relevant
+- Clearly state whether goals are achieved, partially achieved, or not achieved
+- If uncertain, explicitly state uncertainty and request clarification
+- Never declare success without concrete visual evidence
+- Include accessibility assessment in all evaluations
+- Provide specific remediation recommendations for identified issues
+- Document edge cases and boundary conditions observed
+
+## Behavioral Traits
+
+- Maintains skeptical approach until visual proof is provided
+- Applies systematic methodology to all visual assessments
+- Considers accessibility and inclusive design in every evaluation
+- Documents findings with precise, measurable observations
+- Challenges assumptions and validates against stated objectives
+- Provides constructive feedback for design and development improvement
+- Stays current with visual testing tools and methodologies
+- Advocates for comprehensive visual quality assurance practices
+
+## Forbidden Behaviors
+
+- Assuming code changes automatically produce visual results
+- Quick conclusions without thorough systematic analysis
+- Accepting 'looks different' as 'looks correct'
+- Using expectation to replace direct observation
+- Ignoring accessibility implications in visual assessment
+- Overlooking edge cases or error states
+- Making assumptions about user behavior from visual evidence alone
+
+## Example Interactions
+
+- "Validate that the new button component meets accessibility contrast requirements"
+- "Verify that the responsive navigation collapses correctly at mobile breakpoints"
+- "Confirm that the loading spinner animation displays smoothly across browsers"
+- "Assess whether the error message styling follows the design system guidelines"
+- "Validate that the modal overlay properly blocks interaction with background elements"
+- "Verify that the dark theme implementation maintains visual hierarchy"
+- "Confirm that form validation states provide clear visual feedback"
+- "Assess whether the data table maintains readability across different screen sizes"
+
+Your role is to be the final gatekeeper ensuring UI modifications actually work as intended through uncompromising visual verification with accessibility and inclusive design considerations at the forefront.
diff --git a/.claude/skills/vue-best-practices/SKILL.md b/.claude/skills/vue-best-practices/SKILL.md
new file mode 100644
index 0000000..94516e4
--- /dev/null
+++ b/.claude/skills/vue-best-practices/SKILL.md
@@ -0,0 +1,38 @@
+---
+name: vue-best-practices
+description: Vue 3 and Vue.js best practices for TypeScript, vue-tsc, and Volar. This skill should be used when writing, reviewing, or refactoring Vue components to ensure correct typing patterns. Triggers on tasks involving Vue components, props extraction, wrapper components, template type checking, or Volar configuration.
+license: MIT
+metadata:
+  author: hyf0
+  version: "8.0.0"
+---
+
+## Capability Rules
+
+| Rule | Keywords | Description |
+|------|----------|-------------|
+| [extract-component-props](rules/extract-component-props.md) | get props type, wrapper component, extend props, inherit props, ComponentProps | Extract types from .vue components |
+| [vue-tsc-strict-templates](rules/vue-tsc-strict-templates.md) | undefined component, template error, strictTemplates | Catch undefined components in templates |
+| [fallthrough-attributes](rules/fallthrough-attributes.md) | fallthrough, $attrs, wrapper component | Type-check fallthrough attributes |
+| [strict-css-modules](rules/strict-css-modules.md) | css modules, $style, typo | Catch CSS module class typos |
+| [data-attributes-config](rules/data-attributes-config.md) | data-*, strictTemplates, attribute | Allow data-* attributes |
+| [volar-3-breaking-changes](rules/volar-3-breaking-changes.md) | volar, vue-language-server, editor | Fix Volar 3.0 upgrade issues |
+| [module-resolution-bundler](rules/module-resolution-bundler.md) | cannot find module, @vue/tsconfig, moduleResolution | Fix module resolution errors |
+| [define-model-update-event](rules/define-model-update-event.md) | defineModel, update event, undefined | Fix model update errors |
+| [with-defaults-union-types](rules/with-defaults-union-types.md) | withDefaults, union type, default | Fix union type defaults |
+| [deep-watch-numeric](rules/deep-watch-numeric.md) | watch, deep, array, Vue 3.5 | Efficient array watching |
+| [vue-directive-comments](rules/vue-directive-comments.md) | @vue-ignore, @vue-skip, template | Control template type checking |
+| [vue-router-typed-params](rules/vue-router-typed-params.md) | route params, typed router, unplugin | Fix route params typing |
+
+## Efficiency Rules
+
+| Rule | Keywords | Description |
+|------|----------|-------------|
+| [hmr-vue-ssr](rules/hmr-vue-ssr.md) | hmr, ssr, hot reload | Fix HMR in SSR apps |
+| [pinia-store-mocking](rules/pinia-store-mocking.md) | pinia, mock, vitest, store | Mock Pinia stores |
+
+## Reference
+
+- [Vue Language Tools](https://github.com/vuejs/language-tools)
+- [vue-component-type-helpers](https://github.com/vuejs/language-tools/tree/master/packages/component-type-helpers)
+- [Vue 3 Documentation](https://vuejs.org/)
diff --git a/.claude/skills/vue-best-practices/rules/codeactions-save-performance.md b/.claude/skills/vue-best-practices/rules/codeactions-save-performance.md
new file mode 100644
index 0000000..03ea819
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/codeactions-save-performance.md
@@ -0,0 +1,79 @@
+---
+title: Fix Slow Save Times with Code Actions Setting
+impact: HIGH
+impactDescription: fixes 30-60 second save delays in large Vue projects
+type: capability
+tags: performance, save-time, vscode, code-actions, volar
+---
+
+# Fix Slow Save Times with Code Actions Setting
+
+**Impact: HIGH** - fixes 30-60 second save delays in large Vue projects
+
+In large Vue projects, saving files can take 30-60+ seconds due to VSCode's code actions triggering expensive TypeScript state synchronization.
+
+## Problem
+
+Symptoms:
+- Save operation takes 30+ seconds
+- Editor becomes unresponsive during save
+- CPU spikes when saving Vue files
+- Happens more in larger projects
+
+## Root Cause
+
+VSCode emits document change events multiple times during save cycles. Each event triggers Volar to synchronize with TypeScript, causing expensive re-computation.
+
+## Solution
+
+Disable code actions or limit their timeout:
+
+**Option 1: Disable code actions (fastest)**
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.enabled": false
+}
+```
+
+**Option 2: Limit code action time**
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.savingTimeLimit": 1000
+}
+```
+
+**Option 3: Disable specific code actions**
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.enabled": true,
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": "never"
+  }
+}
+```
+
+## VSCode Version Requirement
+
+VSCode 1.81.0+ includes fixes that reduce save time issues. Upgrade if using an older version.
+
+## Additional Optimizations
+
+```json
+// .vscode/settings.json
+{
+  "vue.codeActions.enabled": false,
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {},
+  "[vue]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "Vue.volar"
+  }
+}
+```
+
+## Reference
+
+- [Vue Language Tools Discussion #2740](https://github.com/vuejs/language-tools/discussions/2740)
diff --git a/.claude/skills/vue-best-practices/rules/data-attributes-config.md b/.claude/skills/vue-best-practices/rules/data-attributes-config.md
new file mode 100644
index 0000000..60c4630
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/data-attributes-config.md
@@ -0,0 +1,74 @@
+---
+title: Allow Data Attributes with Strict Templates
+impact: MEDIUM
+impactDescription: fixes data-testid and data-* attribute errors in strict mode
+type: capability
+tags: dataAttributes, vueCompilerOptions, strictTemplates, data-testid, testing
+---
+
+# Allow Data Attributes with Strict Templates
+
+**Impact: MEDIUM** - fixes data-testid and data-* attribute errors in strict mode
+
+With `strictTemplates` enabled, `data-*` attributes on components cause type errors. Use the `dataAttributes` option to allow specific patterns.
+
+## Problem
+
+```vue
+<template>
+  <!-- Error: Property 'data-testid' does not exist on type... -->
+  <MyComponent data-testid="submit-button" />
+
+  <!-- Error: Property 'data-cy' does not exist on type... -->
+  <MyComponent data-cy="login-form" />
+</template>
+```
+
+## Solution
+
+Configure `dataAttributes` to allow specific patterns:
+
+```json
+// tsconfig.json or tsconfig.app.json
+{
+  "vueCompilerOptions": {
+    "strictTemplates": true,
+    "dataAttributes": ["data-*"]
+  }
+}
+```
+
+Now all `data-*` attributes are allowed on any component.
+
+## Specific Patterns
+
+You can be more selective:
+
+```json
+{
+  "vueCompilerOptions": {
+    "dataAttributes": [
+      "data-testid",
+      "data-cy",
+      "data-test-*"
+    ]
+  }
+}
+```
+
+This only allows the specified patterns, not all data attributes.
+
+## Common Testing Attributes
+
+For testing libraries, allow their specific attributes:
+
+| Library | Attribute | Pattern |
+|---------|-----------|---------|
+| Testing Library | `data-testid` | `"data-testid"` |
+| Cypress | `data-cy` | `"data-cy"` |
+| Playwright | `data-testid` | `"data-testid"` |
+| Generic | All data attributes | `"data-*"` |
+
+## Reference
+
+- [Vue Language Tools Wiki - Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
diff --git a/.claude/skills/vue-best-practices/rules/deep-watch-numeric.md b/.claude/skills/vue-best-practices/rules/deep-watch-numeric.md
new file mode 100644
index 0000000..ee2d502
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/deep-watch-numeric.md
@@ -0,0 +1,97 @@
+---
+title: Vue 3.5+ Deep Watch Numeric Depth
+impact: MEDIUM
+impactDescription: enables efficient array mutation watching with numeric deep option
+type: capability
+tags: watch, deep, vue-3.5, array, mutation, performance
+---
+
+# Vue 3.5+ Deep Watch Numeric Depth
+
+**Impact: MEDIUM** - enables efficient array mutation watching with numeric deep option
+
+Vue 3.5 introduced `deep: number` for watch depth control. This allows watching array mutations without the performance cost of deep traversal.
+
+## Symptoms
+
+- Array mutations not triggering watch callback
+- Deep watch causing performance issues on large nested objects
+- Unaware of new Vue 3.5 feature
+
+> **Note:** TypeScript error "Type 'number' is not assignable to type 'boolean'" no longer occurs with Vue 3.5+ and current TypeScript versions. The types now correctly support numeric `deep` values.
+
+## The Feature
+
+```typescript
+// Vue 3.5+ only
+watch(items, (newVal) => {
+  // Triggered on array mutations (push, pop, splice, etc.)
+}, { deep: 1 })
+```
+
+| deep value | Behavior |
+|------------|----------|
+| `true` | Full recursive traversal (original behavior) |
+| `false` | Only reference changes |
+| `1` | One level deep - array mutations, not nested objects |
+| `2` | Two levels deep |
+| `n` | N levels deep |
+
+## Fix
+
+**Step 1: Ensure Vue 3.5+**
+```bash
+npm install vue@^3.5.0
+```
+
+**Step 2: Use numeric depth**
+```typescript
+import { watch, ref } from 'vue'
+
+const items = ref([{ id: 1, data: { nested: 'value' } }])
+
+// Watch array mutations only (push, pop, etc.)
+watch(items, (newItems) => {
+  console.log('Array mutated')
+}, { deep: 1 })
+
+// Won't trigger on: items.value[0].data.nested = 'new'
+// Will trigger on: items.value.push(newItem)
+```
+
+## Performance Comparison
+
+```typescript
+const largeNestedData = ref({ /* deeply nested structure */ })
+
+// SLOW - traverses entire structure
+watch(largeNestedData, handler, { deep: true })
+
+// FAST - only watches top-level changes
+watch(largeNestedData, handler, { deep: 1 })
+
+// FASTEST - only reference changes
+watch(largeNestedData, handler, { deep: false })
+```
+
+## Alternative: watchEffect for Selective Tracking
+
+```typescript
+// Only tracks properties actually accessed
+watchEffect(() => {
+  // Only re-runs when items.value.length or first item changes
+  console.log(items.value.length, items.value[0]?.id)
+})
+```
+
+## TypeScript Note
+
+If TypeScript complains about numeric deep, ensure:
+1. Vue version is 3.5+
+2. TypeScript version is current (types are included with `vue` package)
+3. tsconfig targets correct node_modules types
+
+## Reference
+
+- [Vue Watchers Docs](https://vuejs.org/guide/essentials/watchers.html)
+- [Vue 3.5 Release Notes](https://blog.vuejs.org/posts/vue-3-5)
diff --git a/.claude/skills/vue-best-practices/rules/define-model-update-event.md b/.claude/skills/vue-best-practices/rules/define-model-update-event.md
new file mode 100644
index 0000000..2f4d5af
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/define-model-update-event.md
@@ -0,0 +1,79 @@
+---
+title: defineModel Fires Update Event with Undefined
+impact: MEDIUM
+impactDescription: fixes runtime errors from unexpected undefined in model updates
+type: capability
+tags: defineModel, v-model, update-event, undefined, vue-3.5
+---
+
+# defineModel Fires Update Event with Undefined
+
+**Impact: MEDIUM** - fixes runtime errors from unexpected undefined in model updates
+
+> **Version Note:** This issue may be resolved in Vue 3.5+. Testing with Vue 3.5.26 could not reproduce the double emission with `undefined`. If you're on Vue 3.5+, verify the issue exists in your specific scenario before applying workarounds.
+
+Components using `defineModel` may fire the `@update:model-value` event with `undefined` in certain edge cases. TypeScript types don't always reflect this behavior, potentially causing runtime errors when the parent expects a non-nullable value.
+
+## Symptoms
+
+- Parent component receives `undefined` unexpectedly
+- Runtime error: "Cannot read property of undefined"
+- Type mismatch between expected `T` and received `T | undefined`
+- Issue appears when clearing/resetting the model value
+
+## Root Cause
+
+`defineModel` returns `Ref<T | undefined>` by default, even when `T` is non-nullable. The update event can fire with `undefined` when:
+- Component unmounts
+- Model is explicitly cleared
+- Internal state resets
+
+## Fix
+
+**Option 1: Use required option (Vue 3.5+)**
+```typescript
+// Returns Ref<Item> instead of Ref<Item | undefined>
+const model = defineModel<Item>({ required: true })
+```
+
+**Option 2: Type parent handler to accept undefined**
+```vue
+<template>
+  <MyComponent
+    v-model="item"
+    @update:model-value="handleUpdate"
+  />
+</template>
+
+<script setup lang="ts">
+// Handle both value and undefined
+const handleUpdate = (value: Item | undefined) => {
+  if (value !== undefined) {
+    item.value = value
+  }
+}
+</script>
+```
+
+**Option 3: Use default value in defineModel**
+```typescript
+const model = defineModel<string>({ default: '' })
+```
+
+## Type Declaration Pattern
+
+```typescript
+// In child component
+interface Props {
+  modelValue: Item
+}
+const model = defineModel<Item>({ required: true })
+
+// Emits will be typed as (value: Item) not (value: Item | undefined)
+```
+
+## Reference
+
+- [vuejs/core#12817](https://github.com/vuejs/core/issues/12817)
+- [vuejs/core#10103](https://github.com/vuejs/core/issues/10103)
+- [defineModel docs](https://vuejs.org/api/sfc-script-setup.html#definemodel)
diff --git a/.claude/skills/vue-best-practices/rules/duplicate-plugin-detection.md b/.claude/skills/vue-best-practices/rules/duplicate-plugin-detection.md
new file mode 100644
index 0000000..3fbbb99
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/duplicate-plugin-detection.md
@@ -0,0 +1,102 @@
+---
+title: Duplicate Vue Plugin Detection
+impact: MEDIUM
+impactDescription: fixes cryptic build errors from Vue plugin registered twice
+type: capability
+tags: vite, plugin, vue, duplicate, config, inline
+---
+
+# Duplicate Vue Plugin Detection
+
+**Impact: MEDIUM** - fixes cryptic build errors from Vue plugin registered twice
+
+When using Vite's JavaScript API, if the Vue plugin is loaded in `vite.config.js` and specified again in `inlineConfig`, it gets registered twice, causing cryptic build errors.
+
+## Symptoms
+
+- Build produces unexpected output or fails silently
+- "Cannot read property of undefined" during build
+- Different build behavior between CLI and JavaScript API
+- Vue components render incorrectly after build
+
+## Root Cause
+
+Vite doesn't deduplicate plugins by name when merging configs. The Vue plugin's internal state gets corrupted when registered twice.
+
+## Fix
+
+**Option 1: Use configFile: false with inline plugins**
+```typescript
+import { build } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+await build({
+  configFile: false,  // Don't load vite.config.js
+  plugins: [vue()],
+  // ... rest of config
+})
+```
+
+**Option 2: Don't specify plugins in inlineConfig**
+```typescript
+// vite.config.js already has vue plugin
+import { build } from 'vite'
+
+await build({
+  // Don't add vue plugin here - it's in vite.config.js
+  root: './src',
+  build: { outDir: '../dist' }
+})
+```
+
+**Option 3: Filter out Vue plugin before merging**
+```typescript
+import { build, loadConfigFromFile } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+const { config } = await loadConfigFromFile({ command: 'build', mode: 'production' })
+
+// Remove existing Vue plugin
+const filteredPlugins = config.plugins?.filter(
+  p => !p || (Array.isArray(p) ? false : p.name !== 'vite:vue')
+) || []
+
+await build({
+  ...config,
+  plugins: [...filteredPlugins, vue({ /* your options */ })]
+})
+```
+
+## Detection Script
+
+Add this to debug plugin registration:
+```typescript
+// vite.config.ts
+export default defineConfig({
+  plugins: [
+    vue(),
+    {
+      name: 'debug-plugins',
+      configResolved(config) {
+        const vuePlugins = config.plugins.filter(p => p.name?.includes('vue'))
+        if (vuePlugins.length > 1) {
+          console.warn('WARNING: Multiple Vue plugins detected:', vuePlugins.map(p => p.name))
+        }
+      }
+    }
+  ]
+})
+```
+
+## Common Scenarios
+
+| Scenario | Solution |
+|----------|----------|
+| Using `vite.createServer()` | Use `configFile: false` |
+| Build script with custom config | Don't duplicate plugins |
+| Monorepo with shared config | Check for plugin inheritance |
+
+## Reference
+
+- [Vite Issue #5335](https://github.com/vitejs/vite/issues/5335)
+- [Vite JavaScript API](https://vite.dev/guide/api-javascript.html)
diff --git a/.claude/skills/vue-best-practices/rules/extract-component-props.md b/.claude/skills/vue-best-practices/rules/extract-component-props.md
new file mode 100644
index 0000000..a94c70c
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/extract-component-props.md
@@ -0,0 +1,57 @@
+---
+title: Extract Component Props
+impact: HIGH
+impactDescription: extract props, emits, slots types from .vue components
+type: capability
+tags: typescript, props, emits, slots, vue-component-type-helpers, wrapper, ComponentProps
+---
+
+# Extract Component Props
+
+**Impact: HIGH** - extract props, emits, slots types from .vue components
+
+Use `vue-component-type-helpers` to extract types from `.vue` components:
+
+```bash
+npm install -D vue-component-type-helpers
+```
+
+```typescript
+import type { ComponentProps, ComponentEmit, ComponentSlots, ComponentExposed } from 'vue-component-type-helpers'
+import MyButton from './MyButton.vue'
+
+type Props = ComponentProps<typeof MyButton>
+type Emits = ComponentEmit<typeof MyButton>
+type Slots = ComponentSlots<typeof MyButton>
+type Exposed = ComponentExposed<typeof MyButton>
+```
+
+## Wrapper Component Pattern
+
+```typescript
+import type { ComponentProps } from 'vue-component-type-helpers'
+import BaseButton from './BaseButton.vue'
+
+type BaseProps = ComponentProps<typeof BaseButton>
+
+interface Props extends BaseProps {
+  size: 'sm' | 'md' | 'lg'
+}
+
+defineProps<Props>()
+```
+
+## Do NOT Use
+
+```typescript
+// ❌ Includes Vue internal properties (onUpdate:*, class, style, etc.)
+type Props = InstanceType<typeof MyButton>['$props']
+```
+
+## Note
+
+Vue's built-in `ExtractPropTypes` is for runtime props objects (`props: { foo: String }`), not for `.vue` components.
+
+## Reference
+
+- [vue-component-type-helpers](https://github.com/vuejs/language-tools/tree/master/packages/component-type-helpers)
diff --git a/.claude/skills/vue-best-practices/rules/fallthrough-attributes.md b/.claude/skills/vue-best-practices/rules/fallthrough-attributes.md
new file mode 100644
index 0000000..5771ffc
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/fallthrough-attributes.md
@@ -0,0 +1,63 @@
+---
+title: Enable Fallthrough Attributes Type Checking
+impact: MEDIUM
+impactDescription: enables IDE autocomplete for fallthrough attributes in wrapper components
+type: capability
+tags: fallthroughAttributes, vueCompilerOptions, component-library, wrapper-components
+---
+
+# Enable Fallthrough Attributes Type Checking
+
+**Impact: MEDIUM** - enables type-aware attribute forwarding in component libraries
+
+When building component libraries with wrapper components, enable `fallthroughAttributes` to get IDE autocomplete for attributes that will be forwarded to child elements.
+
+## What It Does
+
+Wrapper components that pass attributes to child elements can benefit from type-aware completion:
+
+```vue
+<!-- MyButton.vue - wrapper around native button -->
+<template>
+  <button v-bind="$attrs"><slot /></button>
+</template>
+```
+
+## Solution
+
+Enable `fallthroughAttributes` in your tsconfig:
+
+```json
+// tsconfig.json or tsconfig.app.json
+{
+  "vueCompilerOptions": {
+    "fallthroughAttributes": true
+  }
+}
+```
+
+## How It Works
+
+When `fallthroughAttributes: true`:
+- Vue Language Server analyzes which element receives `$attrs`
+- IDE autocomplete suggests valid attributes for the target element
+- Helps developers discover available attributes
+
+> **Note:** This primarily enables IDE autocomplete for valid fallthrough attributes. It does NOT reject invalid attributes as type errors - arbitrary attributes are still allowed.
+
+## Related Options
+
+Combine with `strictTemplates` for comprehensive checking:
+
+```json
+{
+  "vueCompilerOptions": {
+    "strictTemplates": true,
+    "fallthroughAttributes": true
+  }
+}
+```
+
+## Reference
+
+- [Vue Language Tools Wiki - Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
diff --git a/.claude/skills/vue-best-practices/rules/hmr-vue-ssr.md b/.claude/skills/vue-best-practices/rules/hmr-vue-ssr.md
new file mode 100644
index 0000000..db1e427
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/hmr-vue-ssr.md
@@ -0,0 +1,124 @@
+---
+title: HMR Debugging for Vue SSR
+impact: MEDIUM
+impactDescription: fixes Hot Module Replacement breaking in Vue SSR applications
+type: efficiency
+tags: vite, hmr, ssr, vue, hot-reload, server-side-rendering
+---
+
+# HMR Debugging for Vue SSR
+
+**Impact: MEDIUM** - fixes Hot Module Replacement breaking in Vue SSR applications
+
+Hot Module Replacement breaks when modifying Vue component `<script setup>` sections in SSR applications. Changes cause errors instead of smooth updates, requiring full page reloads.
+
+## Symptoms
+
+- HMR works for `<template>` changes but breaks for `<script setup>`
+- "Cannot read property of undefined" after saving
+- Full page reload required after script changes
+- HMR works in dev:client but not dev:ssr
+
+## Root Cause
+
+SSR mode has a different transformation pipeline. The Vue plugin's HMR boundary detection doesn't handle SSR modules the same way as client modules.
+
+## Fix
+
+**Step 1: Ensure correct SSR plugin configuration**
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+export default defineConfig({
+  plugins: [vue()],
+  ssr: {
+    // Don't externalize these for HMR to work
+    noExternal: ['vue', '@vue/runtime-core', '@vue/runtime-dom']
+  }
+})
+```
+
+**Step 2: Configure dev server for SSR HMR**
+```typescript
+// server.ts
+import { createServer } from 'vite'
+
+const vite = await createServer({
+  server: { middlewareMode: true },
+  appType: 'custom'
+})
+
+// Use vite.ssrLoadModule for server-side imports
+const { render } = await vite.ssrLoadModule('/src/entry-server.ts')
+
+// Handle HMR
+vite.watcher.on('change', async (file) => {
+  if (file.endsWith('.vue')) {
+    // Invalidate the module
+    const mod = vite.moduleGraph.getModuleById(file)
+    if (mod) {
+      vite.moduleGraph.invalidateModule(mod)
+    }
+  }
+})
+```
+
+**Step 3: Add HMR acceptance in entry-server**
+```typescript
+// entry-server.ts
+import { createApp } from './main'
+
+export async function render(url: string) {
+  const app = createApp()
+  // ... render logic
+}
+
+// Accept HMR updates
+if (import.meta.hot) {
+  import.meta.hot.accept()
+}
+```
+
+## Framework-Specific Solutions
+
+### Nuxt 3
+HMR should work out of the box. If not:
+```bash
+rm -rf .nuxt node_modules/.vite
+npm install
+npm run dev
+```
+
+### Vite SSR Template
+Ensure you're using the latest `@vitejs/plugin-vue`:
+```bash
+npm install @vitejs/plugin-vue@latest
+```
+
+## Debugging
+
+Enable verbose HMR logging:
+```typescript
+// vite.config.ts
+export default defineConfig({
+  server: {
+    hmr: {
+      overlay: true
+    }
+  },
+  logLevel: 'info'  // Shows HMR updates
+})
+```
+
+## Known Limitations
+
+- HMR for `<script>` (not `<script setup>`) may require full reload
+- SSR components with external dependencies may not hot-reload
+- State is not preserved for SSR components (expected behavior)
+
+## Reference
+
+- [vite-plugin-vue#525](https://github.com/vitejs/vite-plugin-vue/issues/525)
+- [Vite SSR Guide](https://vite.dev/guide/ssr.html)
diff --git a/.claude/skills/vue-best-practices/rules/module-resolution-bundler.md b/.claude/skills/vue-best-practices/rules/module-resolution-bundler.md
new file mode 100644
index 0000000..bfc2072
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/module-resolution-bundler.md
@@ -0,0 +1,81 @@
+---
+title: moduleResolution Bundler Migration Issues
+impact: HIGH
+impactDescription: fixes "Cannot find module" errors after @vue/tsconfig upgrade
+type: capability
+tags: moduleResolution, bundler, tsconfig, vue-tsconfig, node, esm
+---
+
+# moduleResolution Bundler Migration Issues
+
+**Impact: HIGH** - fixes "Cannot find module" errors after @vue/tsconfig upgrade
+
+Recent versions of `@vue/tsconfig` changed `moduleResolution` from `"node"` to `"bundler"`. This can break existing projects with errors like "Cannot find module 'vue'" or issues with `resolveJsonModule`.
+
+## Symptoms
+
+- `Cannot find module 'vue'` or other packages
+- `Option '--resolveJsonModule' cannot be specified without 'node' module resolution`
+- Errors appear after updating `@vue/tsconfig`
+- Some third-party packages no longer resolve
+
+## Root Cause
+
+`moduleResolution: "bundler"` requires:
+1. TypeScript 5.0+
+2. Packages to have proper `exports` field in package.json
+3. Different resolution rules than Node.js classic resolution
+
+## Fix
+
+**Option 1: Ensure TypeScript 5.0+ everywhere**
+```bash
+npm install -D typescript@^5.0.0
+```
+
+In monorepos, ALL packages must use TypeScript 5.0+.
+
+**Option 2: Add compatibility workaround**
+```json
+{
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolvePackageJsonExports": false
+  }
+}
+```
+
+Setting `resolvePackageJsonExports: false` restores compatibility with packages that don't have proper exports.
+
+**Option 3: Revert to Node resolution**
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "node"
+  }
+}
+```
+
+## Which Packages Break?
+
+Packages break if they:
+- Lack `exports` field in package.json
+- Have incorrect `exports` configuration
+- Rely on Node.js-specific resolution behavior
+
+## Diagnosis
+
+```bash
+# Check which resolution is being used
+cat tsconfig.json | grep moduleResolution
+
+# Test if a specific module resolves
+npx tsc --traceResolution 2>&1 | grep "module-name"
+```
+
+## Reference
+
+- [vuejs/tsconfig#8](https://github.com/vuejs/tsconfig/issues/8)
+- [TypeScript moduleResolution docs](https://www.typescriptlang.org/tsconfig#moduleResolution)
+- [Vite discussion#14001](https://github.com/vitejs/vite/discussions/14001)
diff --git a/.claude/skills/vue-best-practices/rules/pinia-store-mocking.md b/.claude/skills/vue-best-practices/rules/pinia-store-mocking.md
new file mode 100644
index 0000000..159e120
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/pinia-store-mocking.md
@@ -0,0 +1,159 @@
+---
+title: Mocking Pinia Stores with Vitest
+impact: HIGH
+impactDescription: properly mocks Pinia stores in component tests
+type: efficiency
+tags: pinia, vitest, testing, mock, createTestingPinia, store
+---
+
+# Mocking Pinia Stores with Vitest
+
+**Impact: HIGH** - properly mocks Pinia stores in component tests
+
+Developers struggle to properly mock Pinia stores: `createTestingPinia` requires explicit `createSpy` configuration, and "injection Symbol(pinia) not found" errors occur without proper setup.
+
+> **Important (@pinia/testing 1.0+):** The `createSpy` option is **REQUIRED**, not optional. Omitting it throws an error: "You must configure the `createSpy` option."
+
+## Symptoms
+
+- "injection Symbol(pinia) not found" error
+- "You must configure the `createSpy` option" error
+- Actions not properly mocked
+- Store state not reset between tests
+
+## Fix
+
+**Pattern 1: Basic setup with createTestingPinia**
+```typescript
+import { mount } from '@vue/test-utils'
+import { createTestingPinia } from '@pinia/testing'
+import { vi } from 'vitest'
+import MyComponent from './MyComponent.vue'
+import { useCounterStore } from '@/stores/counter'
+
+test('component uses store', async () => {
+  const wrapper = mount(MyComponent, {
+    global: {
+      plugins: [
+        createTestingPinia({
+          createSpy: vi.fn,  // REQUIRED in @pinia/testing 1.0+
+          initialState: {
+            counter: { count: 10 }  // Set initial state
+          }
+        })
+      ]
+    }
+  })
+
+  // Get the store instance AFTER mounting
+  const store = useCounterStore()
+
+  // Actions are automatically stubbed
+  await wrapper.find('button').trigger('click')
+  expect(store.increment).toHaveBeenCalled()
+})
+```
+
+**Pattern 2: Customize action behavior**
+```typescript
+test('component handles async action', async () => {
+  const wrapper = mount(MyComponent, {
+    global: {
+      plugins: [
+        createTestingPinia({
+          createSpy: vi.fn,
+          stubActions: false  // Don't stub, use real actions
+        })
+      ]
+    }
+  })
+
+  const store = useCounterStore()
+
+  // Override specific action
+  store.fetchData = vi.fn().mockResolvedValue({ items: [] })
+
+  await wrapper.find('.load-button').trigger('click')
+  expect(store.fetchData).toHaveBeenCalled()
+})
+```
+
+**Pattern 3: Testing store directly**
+```typescript
+import { setActivePinia, createPinia } from 'pinia'
+import { useCounterStore } from '@/stores/counter'
+
+describe('Counter Store', () => {
+  beforeEach(() => {
+    setActivePinia(createPinia())
+  })
+
+  test('increments count', () => {
+    const store = useCounterStore()
+    expect(store.count).toBe(0)
+
+    store.increment()
+    expect(store.count).toBe(1)
+  })
+})
+```
+
+## Setup Store with Vitest
+
+```typescript
+// stores/counter.ts - Setup store syntax
+export const useCounterStore = defineStore('counter', () => {
+  const count = ref(0)
+  const doubleCount = computed(() => count.value * 2)
+
+  function increment() {
+    count.value++
+  }
+
+  return { count, doubleCount, increment }
+})
+
+// Test file
+test('setup store works', async () => {
+  const pinia = createTestingPinia({
+    createSpy: vi.fn,
+    initialState: {
+      counter: { count: 5 }
+    }
+  })
+
+  const wrapper = mount(MyComponent, {
+    global: { plugins: [pinia] }
+  })
+
+  const store = useCounterStore()
+  expect(store.count).toBe(5)
+  expect(store.doubleCount).toBe(10)
+})
+```
+
+## Reset Between Tests
+
+```typescript
+describe('Store Tests', () => {
+  let pinia: Pinia
+
+  beforeEach(() => {
+    pinia = createTestingPinia({
+      createSpy: vi.fn
+    })
+  })
+
+  afterEach(() => {
+    vi.clearAllMocks()
+  })
+
+  test('test 1', () => { /* ... */ })
+  test('test 2', () => { /* ... */ })
+})
+```
+
+## Reference
+
+- [Pinia Testing Guide](https://pinia.vuejs.org/cookbook/testing.html)
+- [Pinia Discussion #2092](https://github.com/vuejs/pinia/discussions/2092)
diff --git a/.claude/skills/vue-best-practices/rules/script-setup-jsdoc.md b/.claude/skills/vue-best-practices/rules/script-setup-jsdoc.md
new file mode 100644
index 0000000..0bc522c
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/script-setup-jsdoc.md
@@ -0,0 +1,85 @@
+---
+title: JSDoc Documentation for Script Setup Components
+impact: MEDIUM
+impactDescription: enables proper documentation for composition API components
+type: capability
+tags: jsdoc, script-setup, documentation, composition-api, component
+---
+
+# JSDoc Documentation for Script Setup Components
+
+**Impact: MEDIUM** - enables proper documentation for composition API components
+
+`<script setup>` doesn't have an obvious place to attach JSDoc comments for the component itself. Use a dual-script pattern.
+
+## Problem
+
+**Incorrect:**
+```vue
+<script setup lang="ts">
+/**
+ * This comment doesn't appear in IDE hover or docs
+ * @component
+ */
+import { ref } from 'vue'
+
+const count = ref(0)
+</script>
+```
+
+JSDoc comments inside `<script setup>` don't attach to the component export because there's no explicit export statement.
+
+## Solution
+
+Use both `<script>` and `<script setup>` blocks:
+
+**Correct:**
+```vue
+<script lang="ts">
+/**
+ * A counter component that displays and increments a value.
+ *
+ * @example
+ * ```vue
+ * <Counter :initial="5" @update="handleUpdate" />
+ * ```
+ *
+ * @component
+ */
+export default {}
+</script>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+
+const props = defineProps<{
+  /** Starting value for the counter */
+  initial?: number
+}>()
+
+const emit = defineEmits<{
+  /** Emitted when counter value changes */
+  update: [value: number]
+}>()
+
+const count = ref(props.initial ?? 0)
+</script>
+```
+
+## How It Works
+
+- The regular `<script>` block's default export is merged with `<script setup>`
+- JSDoc on `export default {}` attaches to the component
+- Props and emits JSDoc in `<script setup>` still work normally
+
+## What Gets Documented
+
+| Location | Shows In |
+|----------|----------|
+| `export default {}` JSDoc | Component import hover |
+| `defineProps` JSDoc | Prop hover in templates |
+| `defineEmits` JSDoc | Event handler hover |
+
+## Reference
+
+- [Vue Language Tools Discussion #5932](https://github.com/vuejs/language-tools/discussions/5932)
diff --git a/.claude/skills/vue-best-practices/rules/strict-css-modules.md b/.claude/skills/vue-best-practices/rules/strict-css-modules.md
new file mode 100644
index 0000000..5696917
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/strict-css-modules.md
@@ -0,0 +1,68 @@
+---
+title: Enable Strict CSS Modules Type Checking
+impact: MEDIUM
+impactDescription: catches typos in CSS module class names at compile time
+type: capability
+tags: strictCssModules, vueCompilerOptions, css-modules, style-module
+---
+
+# Enable Strict CSS Modules Type Checking
+
+**Impact: MEDIUM** - catches typos in CSS module class names at compile time
+
+When using CSS modules with `<style module>`, Vue doesn't validate class names by default. Enable `strictCssModules` to catch typos and undefined classes.
+
+## Problem
+
+CSS module class name errors go undetected:
+
+```vue
+<script setup lang="ts">
+// No error for typo in class name
+</script>
+
+<template>
+  <div :class="$style.buttn">Click me</div>
+</template>
+
+<style module>
+.button {
+  background: blue;
+}
+</style>
+```
+
+The typo `buttn` instead of `button` silently fails at runtime.
+
+## Solution
+
+Enable `strictCssModules` in your tsconfig:
+
+```json
+// tsconfig.json or tsconfig.app.json
+{
+  "vueCompilerOptions": {
+    "strictCssModules": true
+  }
+}
+```
+
+Now `$style.buttn` will show a type error because `buttn` doesn't exist in the CSS module.
+
+## What Gets Checked
+
+| Access | With strictCssModules |
+|--------|----------------------|
+| `$style.validClass` | OK |
+| `$style.typo` | Error: Property 'typo' does not exist |
+| `$style['dynamic']` | OK (dynamic access not checked) |
+
+## Limitations
+
+- Only checks static property access (`$style.className`)
+- Dynamic access (`$style[variable]`) is not validated
+- Only works with `<style module>`, not external CSS files
+
+## Reference
+
+- [Vue Language Tools Wiki - Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
diff --git a/.claude/skills/vue-best-practices/rules/volar-3-breaking-changes.md b/.claude/skills/vue-best-practices/rules/volar-3-breaking-changes.md
new file mode 100644
index 0000000..747d534
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/volar-3-breaking-changes.md
@@ -0,0 +1,65 @@
+---
+title: Volar 3.0 Breaking Changes
+impact: HIGH
+impactDescription: fixes editor integration after Volar/vue-language-server upgrade
+type: capability
+tags: volar, vue-language-server, neovim, vscode, ide, ts_ls, vtsls
+---
+
+# Volar 3.0 Breaking Changes
+
+**Impact: HIGH** - fixes editor integration after Volar/vue-language-server upgrade
+
+Volar 3.0 (vue-language-server 3.x) introduced breaking changes to the language server protocol. Editors configured for Volar 2.x will break with errors like "vue_ls doesn't work with ts_ls.. it expects vtsls".
+
+## Symptoms
+
+- `vue_ls doesn't work with ts_ls`
+- TypeScript features stop working in Vue files
+- No autocomplete, type hints, or error highlighting
+- Editor shows "Language server initialization failed"
+
+## Fix by Editor
+
+### VSCode
+
+Update the "Vue - Official" extension to latest version. It manages the language server automatically.
+
+### NeoVim (nvim-lspconfig)
+
+**Option 1: Use vtsls instead of ts_ls**
+```lua
+-- Replace ts_ls/tsserver with vtsls
+require('lspconfig').vtsls.setup({})
+require('lspconfig').volar.setup({})
+```
+
+**Option 2: Downgrade vue-language-server**
+```bash
+npm install -g @vue/language-server@2.1.10
+```
+
+### JetBrains IDEs
+
+Update to latest Vue plugin. If issues persist, disable and re-enable the Vue plugin.
+
+## What Changed in 3.0
+
+| Feature | Volar 2.x | Volar 3.0 |
+|---------|-----------|-----------|
+| TypeScript integration | ts_ls/tsserver | vtsls recommended (Neovim) |
+| Hybrid mode | Optional | Default |
+
+## Workaround: Stay on 2.x
+
+If upgrading is not possible:
+```bash
+npm install -g @vue/language-server@^2.0.0
+```
+
+Pin in your project's package.json to prevent accidental upgrades.
+
+## Reference
+
+- [vuejs/language-tools#5598](https://github.com/vuejs/language-tools/issues/5598)
+- [NeoVim Vue Setup Guide](https://dev.to/danwalsh/solved-vue-3-typescript-inlay-hint-support-in-neovim-53ej)
diff --git a/.claude/skills/vue-best-practices/rules/vue-directive-comments.md b/.claude/skills/vue-best-practices/rules/vue-directive-comments.md
new file mode 100644
index 0000000..f516ee8
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/vue-directive-comments.md
@@ -0,0 +1,73 @@
+---
+title: Vue Template Directive Comments
+impact: HIGH
+impactDescription: enables fine-grained control over template type checking
+type: capability
+tags: vue-directive, vue-ignore, vue-expect-error, vue-skip, template, type-checking
+---
+
+# Vue Template Directive Comments
+
+**Impact: HIGH** - enables fine-grained control over template type checking
+
+Vue Language Tools supports special directive comments to control type checking behavior in templates.
+
+## Available Directives
+
+### @vue-ignore
+
+Suppress type errors for the next line:
+
+```vue
+<template>
+  <!-- @vue-ignore -->
+  <Component :prop="valueWithTypeError" />
+</template>
+```
+
+### @vue-expect-error
+
+Assert that the next line should have a type error (useful for testing):
+
+```vue
+<template>
+  <!-- @vue-expect-error -->
+  <Component :invalid-prop="value" />
+</template>
+```
+
+### @vue-skip
+
+Skip type checking for an entire block:
+
+```vue
+<template>
+  <!-- @vue-skip -->
+  <div>
+    <!-- Everything in here is not type-checked -->
+    <LegacyComponent :any="props" :go="here" />
+  </div>
+</template>
+```
+
+### @vue-generic
+
+Declare template-level generic types:
+
+```vue
+<template>
+  <!-- @vue-generic {T extends string} -->
+  <GenericList :items="items as T[]" />
+</template>
+```
+
+## Use Cases
+
+- Migrating legacy components with incomplete types
+- Working with third-party components that have incorrect type definitions
+- Temporarily suppressing errors during refactoring
+- Testing that certain patterns produce expected type errors
+
+## Reference
+
+- [Vue Language Tools Wiki - Directive Comments](https://github.com/vuejs/language-tools/wiki/Directive-Comments)
diff --git a/.claude/skills/vue-best-practices/rules/vue-router-typed-params.md b/.claude/skills/vue-best-practices/rules/vue-router-typed-params.md
new file mode 100644
index 0000000..2924bbb
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/vue-router-typed-params.md
@@ -0,0 +1,81 @@
+---
+title: Vue Router useRoute Params Union Type Narrowing
+impact: MEDIUM
+impactDescription: fixes "Property does not exist" errors with typed route params
+type: capability
+tags: vue-router, useRoute, unplugin-vue-router, typed-routes, params
+---
+
+# Vue Router useRoute Params Union Type Narrowing
+
+**Impact: MEDIUM** - fixes "Property does not exist" errors with typed route params
+
+With `unplugin-vue-router` typed routes, `route.params` becomes a union of ALL page param types. TypeScript cannot narrow `Record<never, never> | { id: string }` properly, causing "Property 'id' does not exist" errors even on the correct page.
+
+## Symptoms
+
+- "Property 'id' does not exist on type 'RouteParams'"
+- `route.params.id` shows as `string | undefined` everywhere
+- Union type of all route params instead of specific route
+- Type narrowing with `if (route.name === 'users-id')` doesn't work
+
+## Root Cause
+
+`unplugin-vue-router` generates a union type of all possible route params. TypeScript's control flow analysis can't narrow this union based on route name checks.
+
+## Fix
+
+**Option 1: Pass route name to useRoute (recommended)**
+```typescript
+// pages/users/[id].vue
+import { useRoute } from 'vue-router/auto'
+
+// Specify the route path for proper typing
+const route = useRoute('/users/[id]')
+
+// Now properly typed as { id: string }
+console.log(route.params.id)  // string, not string | undefined
+```
+
+**Option 2: Type assertion with specific route**
+```typescript
+import { useRoute } from 'vue-router'
+import type { RouteLocationNormalized } from 'vue-router/auto-routes'
+
+const route = useRoute() as RouteLocationNormalized<'/users/[id]'>
+route.params.id  // Properly typed
+```
+
+**Option 3: Define route-specific param type**
+```typescript
+// In your page component
+interface UserRouteParams {
+  id: string
+}
+
+const route = useRoute()
+const { id } = route.params as UserRouteParams
+```
+
+## Required tsconfig Setting
+
+Ensure `moduleResolution: "bundler"` for unplugin-vue-router:
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+## Caveat: Route Name Format
+
+The route name matches the file path pattern:
+- `pages/users/[id].vue` → `/users/[id]`
+- `pages/posts/[slug]/comments.vue` → `/posts/[slug]/comments`
+
+## Reference
+
+- [unplugin-vue-router#337](https://github.com/posva/unplugin-vue-router/issues/337)
+- [unplugin-vue-router#176](https://github.com/posva/unplugin-vue-router/discussions/176)
+- [unplugin-vue-router TypeScript docs](https://uvr.esm.is/guide/typescript.html)
diff --git a/.claude/skills/vue-best-practices/rules/vue-tsc-strict-templates.md b/.claude/skills/vue-best-practices/rules/vue-tsc-strict-templates.md
new file mode 100644
index 0000000..46c95d5
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/vue-tsc-strict-templates.md
@@ -0,0 +1,69 @@
+---
+title: Enable Strict Template Checking
+impact: HIGH
+impactDescription: catches undefined components and props at compile time
+type: capability
+tags: vue-tsc, typescript, type-checking, templates, vueCompilerOptions
+---
+
+# Enable Strict Template Checking
+
+**Impact: HIGH** - catches undefined components and props at compile time
+
+By default, vue-tsc does not report errors for undefined components in templates. Enable `strictTemplates` to catch these issues during type checking.
+
+## Which tsconfig?
+
+Add `vueCompilerOptions` to the tsconfig that includes Vue source files. In projects with multiple tsconfigs (like those created with `create-vue`), this is typically `tsconfig.app.json`, not the root `tsconfig.json` or `tsconfig.node.json`.
+
+**Incorrect (missing strict checking):**
+
+```json
+{
+  "compilerOptions": {
+    "strict": true
+  }
+  // vueCompilerOptions not configured - undefined components won't error
+}
+```
+
+**Correct (strict template checking enabled):**
+
+```json
+{
+  "compilerOptions": {
+    "strict": true
+  },
+  "vueCompilerOptions": {
+    "strictTemplates": true
+  }
+}
+```
+
+## Available Options
+
+| Option | Default | Effect |
+|--------|---------|--------|
+| `strictTemplates` | `false` | Enables all checkUnknown* options below |
+| `checkUnknownComponents` | `false` | Error on undefined/unregistered components |
+| `checkUnknownProps` | `false` | Error on props not declared in component definition |
+| `checkUnknownEvents` | `false` | Error on events not declared via `defineEmits` |
+| `checkUnknownDirectives` | `false` | Error on unregistered custom directives |
+
+## Granular Control
+
+If `strictTemplates` is too strict, enable individual checks:
+
+```json
+{
+  "vueCompilerOptions": {
+    "checkUnknownComponents": true,
+    "checkUnknownProps": false
+  }
+}
+```
+
+## Reference
+
+- [Vue Compiler Options](https://github.com/vuejs/language-tools/wiki/Vue-Compiler-Options)
+- [Vite Vue+TS Template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-vue-ts)
diff --git a/.claude/skills/vue-best-practices/rules/with-defaults-union-types.md b/.claude/skills/vue-best-practices/rules/with-defaults-union-types.md
new file mode 100644
index 0000000..0c802d9
--- /dev/null
+++ b/.claude/skills/vue-best-practices/rules/with-defaults-union-types.md
@@ -0,0 +1,102 @@
+---
+title: withDefaults Incorrect Default with Union Types
+impact: MEDIUM
+impactDescription: fixes spurious "Missing required prop" warning with union type props
+type: capability
+tags: withDefaults, defineProps, union-types, defaults, vue-3.5
+---
+
+# withDefaults Incorrect Default with Union Types
+
+**Impact: MEDIUM** - fixes spurious "Missing required prop" warning with union type props
+
+Using `withDefaults` with union types like `false | string` may produce a Vue runtime warning "Missing required prop" even when a default is provided. The runtime value IS applied correctly, but the warning can be confusing.
+
+## Symptoms
+
+- Vue warns "Missing required prop" despite default being set
+- Warning appears only with union types like `false | string`
+- TypeScript types are correct
+- Runtime value IS correct (the default is applied)
+
+## Problematic Pattern
+
+```typescript
+// This produces a spurious warning (but works at runtime)
+interface Props {
+  value: false | string  // Union type
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  value: 'default'  // Runtime value IS correct, but Vue warns about missing prop
+})
+```
+
+## Fix
+
+**Option 1: Use Reactive Props Destructure (Vue 3.5+)**
+```vue
+<script setup lang="ts">
+interface Props {
+  value: false | string
+}
+
+// Preferred in Vue 3.5+
+const { value = 'default' } = defineProps<Props>()
+</script>
+```
+
+**Option 2: Use runtime declaration**
+```vue
+<script setup lang="ts">
+const props = defineProps({
+  value: {
+    type: [Boolean, String] as PropType<false | string>,
+    default: 'default'
+  }
+})
+</script>
+```
+
+**Option 3: Split into separate props**
+```typescript
+interface Props {
+  enabled: boolean
+  customValue?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  enabled: false,
+  customValue: 'default'
+})
+```
+
+## Why Reactive Props Destructure Works
+
+Vue 3.5's Reactive Props Destructure handles default values at the destructuring level, bypassing the type inference issues with `withDefaults`.
+
+```typescript
+// The default is applied during destructuring, not type inference
+const { prop = 'default' } = defineProps<{ prop?: string }>()
+```
+
+## Enable Reactive Props Destructure
+
+This is enabled by default in Vue 3.5+. For older versions:
+```javascript
+// vite.config.js
+export default {
+  plugins: [
+    vue({
+      script: {
+        propsDestructure: true
+      }
+    })
+  ]
+}
+```
+
+## Reference
+
+- [vuejs/core#12897](https://github.com/vuejs/core/issues/12897)
+- [Reactive Props Destructure RFC](https://github.com/vuejs/rfcs/discussions/502)
diff --git a/.claude/skills/web-artifacts-builder/LICENSE.txt b/.claude/skills/web-artifacts-builder/LICENSE.txt
new file mode 100644
index 0000000..7a4a3ea
--- /dev/null
+++ b/.claude/skills/web-artifacts-builder/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
\ No newline at end of file
diff --git a/.claude/skills/web-artifacts-builder/SKILL.md b/.claude/skills/web-artifacts-builder/SKILL.md
new file mode 100644
index 0000000..15a3b3a
--- /dev/null
+++ b/.claude/skills/web-artifacts-builder/SKILL.md
@@ -0,0 +1,74 @@
+---
+name: web-artifacts-builder
+description: Suite of tools for creating elaborate, multi-component Codex.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
+license: Complete terms in LICENSE.txt
+---
+
+# Web Artifacts Builder
+
+To build powerful frontend Codex.ai artifacts, follow these steps:
+1. Initialize the frontend repo using `scripts/init-artifact.sh`
+2. Develop your artifact by editing the generated code
+3. Bundle all code into a single HTML file using `scripts/bundle-artifact.sh`
+4. Display artifact to user
+5. (Optional) Test the artifact
+
+**Stack**: React 18 + TypeScript + Vite + Parcel (bundling) + Tailwind CSS + shadcn/ui
+
+## Design & Style Guidelines
+
+VERY IMPORTANT: To avoid what is often referred to as "AI slop", avoid using excessive centered layouts, purple gradients, uniform rounded corners, and Inter font.
+
+## Quick Start
+
+### Step 1: Initialize Project
+
+Run the initialization script to create a new React project:
+```bash
+bash scripts/init-artifact.sh <project-name>
+cd <project-name>
+```
+
+This creates a fully configured project with:
+- ✅ React + TypeScript (via Vite)
+- ✅ Tailwind CSS 3.4.1 with shadcn/ui theming system
+- ✅ Path aliases (`@/`) configured
+- ✅ 40+ shadcn/ui components pre-installed
+- ✅ All Radix UI dependencies included
+- ✅ Parcel configured for bundling (via .parcelrc)
+- ✅ Node 18+ compatibility (auto-detects and pins Vite version)
+
+### Step 2: Develop Your Artifact
+
+To build the artifact, edit the generated files. See **Common Development Tasks** below for guidance.
+
+### Step 3: Bundle to Single HTML File
+
+To bundle the React app into a single HTML artifact:
+```bash
+bash scripts/bundle-artifact.sh
+```
+
+This creates `bundle.html` - a self-contained artifact with all JavaScript, CSS, and dependencies inlined. This file can be directly shared in Codex conversations as an artifact.
+
+**Requirements**: Your project must have an `index.html` in the root directory.
+
+**What the script does**:
+- Installs bundling dependencies (parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline)
+- Creates `.parcelrc` config with path alias support
+- Builds with Parcel (no source maps)
+- Inlines all assets into single HTML using html-inline
+
+### Step 4: Share Artifact with User
+
+Finally, share the bundled HTML file in conversation with the user so they can view it as an artifact.
+
+### Step 5: Testing/Visualizing the Artifact (Optional)
+
+Note: This is a completely optional step. Only perform if necessary or requested.
+
+To test/visualize the artifact, use available tools (including other Skills or built-in tools like Playwright or Puppeteer). In general, avoid testing the artifact upfront as it adds latency between the request and when the finished artifact can be seen. Test later, after presenting the artifact, if requested or if issues arise.
+
+## Reference
+
+- **shadcn/ui components**: https://ui.shadcn.com/docs/components
\ No newline at end of file
diff --git a/.claude/skills/web-artifacts-builder/scripts/bundle-artifact.sh b/.claude/skills/web-artifacts-builder/scripts/bundle-artifact.sh
new file mode 100644
index 0000000..c13d229
--- /dev/null
+++ b/.claude/skills/web-artifacts-builder/scripts/bundle-artifact.sh
@@ -0,0 +1,54 @@
+#!/bin/bash
+set -e
+
+echo "📦 Bundling React app to single HTML artifact..."
+
+# Check if we're in a project directory
+if [ ! -f "package.json" ]; then
+  echo "❌ Error: No package.json found. Run this script from your project root."
+  exit 1
+fi
+
+# Check if index.html exists
+if [ ! -f "index.html" ]; then
+  echo "❌ Error: No index.html found in project root."
+  echo "   This script requires an index.html entry point."
+  exit 1
+fi
+
+# Install bundling dependencies
+echo "📦 Installing bundling dependencies..."
+pnpm add -D parcel @parcel/config-default parcel-resolver-tspaths html-inline
+
+# Create Parcel config with tspaths resolver
+if [ ! -f ".parcelrc" ]; then
+  echo "🔧 Creating Parcel configuration with path alias support..."
+  cat > .parcelrc << 'EOF'
+{
+  "extends": "@parcel/config-default",
+  "resolvers": ["parcel-resolver-tspaths", "..."]
+}
+EOF
+fi
+
+# Clean previous build
+echo "🧹 Cleaning previous build..."
+rm -rf dist bundle.html
+
+# Build with Parcel
+echo "🔨 Building with Parcel..."
+pnpm exec parcel build index.html --dist-dir dist --no-source-maps
+
+# Inline everything into single HTML
+echo "🎯 Inlining all assets into single HTML file..."
+pnpm exec html-inline dist/index.html > bundle.html
+
+# Get file size
+FILE_SIZE=$(du -h bundle.html | cut -f1)
+
+echo ""
+echo "✅ Bundle complete!"
+echo "📄 Output: bundle.html ($FILE_SIZE)"
+echo ""
+echo "You can now use this single HTML file as an artifact in Claude conversations."
+echo "To test locally: open bundle.html in your browser"
\ No newline at end of file
diff --git a/.claude/skills/web-artifacts-builder/scripts/init-artifact.sh b/.claude/skills/web-artifacts-builder/scripts/init-artifact.sh
new file mode 100644
index 0000000..7d1022d
--- /dev/null
+++ b/.claude/skills/web-artifacts-builder/scripts/init-artifact.sh
@@ -0,0 +1,322 @@
+#!/bin/bash
+
+# Exit on error
+set -e
+
+# Detect Node version
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+
+echo "🔍 Detected Node.js version: $NODE_VERSION"
+
+if [ "$NODE_VERSION" -lt 18 ]; then
+  echo "❌ Error: Node.js 18 or higher is required"
+  echo "   Current version: $(node -v)"
+  exit 1
+fi
+
+# Set Vite version based on Node version
+if [ "$NODE_VERSION" -ge 20 ]; then
+  VITE_VERSION="latest"
+  echo "✅ Using Vite latest (Node 20+)"
+else
+  VITE_VERSION="5.4.11"
+  echo "✅ Using Vite $VITE_VERSION (Node 18 compatible)"
+fi
+
+# Detect OS and set sed syntax
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  SED_INPLACE="sed -i ''"
+else
+  SED_INPLACE="sed -i"
+fi
+
+# Check if pnpm is installed
+if ! command -v pnpm &> /dev/null; then
+  echo "📦 pnpm not found. Installing pnpm..."
+  npm install -g pnpm
+fi
+
+# Check if project name is provided
+if [ -z "$1" ]; then
+  echo "❌ Usage: ./create-react-shadcn-complete.sh <project-name>"
+  exit 1
+fi
+
+PROJECT_NAME="$1"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+COMPONENTS_TARBALL="$SCRIPT_DIR/shadcn-components.tar.gz"
+
+# Check if components tarball exists
+if [ ! -f "$COMPONENTS_TARBALL" ]; then
+  echo "❌ Error: shadcn-components.tar.gz not found in script directory"
+  echo "   Expected location: $COMPONENTS_TARBALL"
+  exit 1
+fi
+
+echo "🚀 Creating new React + Vite project: $PROJECT_NAME"
+
+# Create new Vite project (always use latest create-vite, pin vite version later)
+pnpm create vite "$PROJECT_NAME" --template react-ts
+
+# Navigate into project directory
+cd "$PROJECT_NAME"
+
+echo "🧹 Cleaning up Vite template..."
+$SED_INPLACE '/<link rel="icon".*vite\.svg/d' index.html
+$SED_INPLACE 's/<title>.*<\/title>/<title>'"$PROJECT_NAME"'<\/title>/' index.html
+
+echo "📦 Installing base dependencies..."
+pnpm install
+
+# Pin Vite version for Node 18
+if [ "$NODE_VERSION" -lt 20 ]; then
+  echo "📌 Pinning Vite to $VITE_VERSION for Node 18 compatibility..."
+  pnpm add -D vite@$VITE_VERSION
+fi
+
+echo "📦 Installing Tailwind CSS and dependencies..."
+pnpm install -D tailwindcss@3.4.1 postcss autoprefixer @types/node tailwindcss-animate
+pnpm install class-variance-authority clsx tailwind-merge lucide-react next-themes
+
+echo "⚙️  Creating Tailwind and PostCSS configuration..."
+cat > postcss.config.js << 'EOF'
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}
+EOF
+
+echo "📝 Configuring Tailwind with shadcn theme..."
+cat > tailwind.config.js << 'EOF'
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: ["class"],
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+  ],
+  theme: {
+    extend: {
+      colors: {
+        border: "hsl(var(--border))",
+        input: "hsl(var(--input))",
+        ring: "hsl(var(--ring))",
+        background: "hsl(var(--background))",
+        foreground: "hsl(var(--foreground))",
+        primary: {
+          DEFAULT: "hsl(var(--primary))",
+          foreground: "hsl(var(--primary-foreground))",
+        },
+        secondary: {
+          DEFAULT: "hsl(var(--secondary))",
+          foreground: "hsl(var(--secondary-foreground))",
+        },
+        destructive: {
+          DEFAULT: "hsl(var(--destructive))",
+          foreground: "hsl(var(--destructive-foreground))",
+        },
+        muted: {
+          DEFAULT: "hsl(var(--muted))",
+          foreground: "hsl(var(--muted-foreground))",
+        },
+        accent: {
+          DEFAULT: "hsl(var(--accent))",
+          foreground: "hsl(var(--accent-foreground))",
+        },
+        popover: {
+          DEFAULT: "hsl(var(--popover))",
+          foreground: "hsl(var(--popover-foreground))",
+        },
+        card: {
+          DEFAULT: "hsl(var(--card))",
+          foreground: "hsl(var(--card-foreground))",
+        },
+      },
+      borderRadius: {
+        lg: "var(--radius)",
+        md: "calc(var(--radius) - 2px)",
+        sm: "calc(var(--radius) - 4px)",
+      },
+      keyframes: {
+        "accordion-down": {
+          from: { height: "0" },
+          to: { height: "var(--radix-accordion-content-height)" },
+        },
+        "accordion-up": {
+          from: { height: "var(--radix-accordion-content-height)" },
+          to: { height: "0" },
+        },
+      },
+      animation: {
+        "accordion-down": "accordion-down 0.2s ease-out",
+        "accordion-up": "accordion-up 0.2s ease-out",
+      },
+    },
+  },
+  plugins: [require("tailwindcss-animate")],
+}
+EOF
+
+# Add Tailwind directives and CSS variables to index.css
+echo "🎨 Adding Tailwind directives and CSS variables..."
+cat > src/index.css << 'EOF'
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  :root {
+    --background: 0 0% 100%;
+    --foreground: 0 0% 3.9%;
+    --card: 0 0% 100%;
+    --card-foreground: 0 0% 3.9%;
+    --popover: 0 0% 100%;
+    --popover-foreground: 0 0% 3.9%;
+    --primary: 0 0% 9%;
+    --primary-foreground: 0 0% 98%;
+    --secondary: 0 0% 96.1%;
+    --secondary-foreground: 0 0% 9%;
+    --muted: 0 0% 96.1%;
+    --muted-foreground: 0 0% 45.1%;
+    --accent: 0 0% 96.1%;
+    --accent-foreground: 0 0% 9%;
+    --destructive: 0 84.2% 60.2%;
+    --destructive-foreground: 0 0% 98%;
+    --border: 0 0% 89.8%;
+    --input: 0 0% 89.8%;
+    --ring: 0 0% 3.9%;
+    --radius: 0.5rem;
+  }
+
+  .dark {
+    --background: 0 0% 3.9%;
+    --foreground: 0 0% 98%;
+    --card: 0 0% 3.9%;
+    --card-foreground: 0 0% 98%;
+    --popover: 0 0% 3.9%;
+    --popover-foreground: 0 0% 98%;
+    --primary: 0 0% 98%;
+    --primary-foreground: 0 0% 9%;
+    --secondary: 0 0% 14.9%;
+    --secondary-foreground: 0 0% 98%;
+    --muted: 0 0% 14.9%;
+    --muted-foreground: 0 0% 63.9%;
+    --accent: 0 0% 14.9%;
+    --accent-foreground: 0 0% 98%;
+    --destructive: 0 62.8% 30.6%;
+    --destructive-foreground: 0 0% 98%;
+    --border: 0 0% 14.9%;
+    --input: 0 0% 14.9%;
+    --ring: 0 0% 83.1%;
+  }
+}
+
+@layer base {
+  * {
+    @apply border-border;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}
+EOF
+
+# Add path aliases to tsconfig.json
+echo "🔧 Adding path aliases to tsconfig.json..."
+node -e "
+const fs = require('fs');
+const config = JSON.parse(fs.readFileSync('tsconfig.json', 'utf8'));
+config.compilerOptions = config.compilerOptions || {};
+config.compilerOptions.baseUrl = '.';
+config.compilerOptions.paths = { '@/*': ['./src/*'] };
+fs.writeFileSync('tsconfig.json', JSON.stringify(config, null, 2));
+"
+
+# Add path aliases to tsconfig.app.json
+echo "🔧 Adding path aliases to tsconfig.app.json..."
+node -e "
+const fs = require('fs');
+const path = 'tsconfig.app.json';
+const content = fs.readFileSync(path, 'utf8');
+// Remove comments manually
+const lines = content.split('\n').filter(line => !line.trim().startsWith('//'));
+const jsonContent = lines.join('\n');
+const config = JSON.parse(jsonContent.replace(/\/\*[\s\S]*?\*\//g, '').replace(/,(\s*[}\]])/g, '\$1'));
+config.compilerOptions = config.compilerOptions || {};
+config.compilerOptions.baseUrl = '.';
+config.compilerOptions.paths = { '@/*': ['./src/*'] };
+fs.writeFileSync(path, JSON.stringify(config, null, 2));
+"
+
+# Update vite.config.ts
+echo "⚙️  Updating Vite configuration..."
+cat > vite.config.ts << 'EOF'
+import path from "path";
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+    },
+  },
+});
+EOF
+
+# Install all shadcn/ui dependencies
+echo "📦 Installing shadcn/ui dependencies..."
+pnpm install @radix-ui/react-accordion @radix-ui/react-aspect-ratio @radix-ui/react-avatar @radix-ui/react-checkbox @radix-ui/react-collapsible @radix-ui/react-context-menu @radix-ui/react-dialog @radix-ui/react-dropdown-menu @radix-ui/react-hover-card @radix-ui/react-label @radix-ui/react-menubar @radix-ui/react-navigation-menu @radix-ui/react-popover @radix-ui/react-progress @radix-ui/react-radio-group @radix-ui/react-scroll-area @radix-ui/react-select @radix-ui/react-separator @radix-ui/react-slider @radix-ui/react-slot @radix-ui/react-switch @radix-ui/react-tabs @radix-ui/react-toast @radix-ui/react-toggle @radix-ui/react-toggle-group @radix-ui/react-tooltip
+pnpm install sonner cmdk vaul embla-carousel-react react-day-picker react-resizable-panels date-fns react-hook-form @hookform/resolvers zod
+
+# Extract shadcn components from tarball
+echo "📦 Extracting shadcn/ui components..."
+tar -xzf "$COMPONENTS_TARBALL" -C src/
+
+# Create components.json for reference
+echo "📝 Creating components.json config..."
+cat > components.json << 'EOF'
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.js",
+    "css": "src/index.css",
+    "baseColor": "slate",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}
+EOF
+
+echo "✅ Setup complete! You can now use Tailwind CSS and shadcn/ui in your project."
+echo ""
+echo "📦 Included components (40+ total):"
+echo "  - accordion, alert, aspect-ratio, avatar, badge, breadcrumb"
+echo "  - button, calendar, card, carousel, checkbox, collapsible"
+echo "  - command, context-menu, dialog, drawer, dropdown-menu"
+echo "  - form, hover-card, input, label, menubar, navigation-menu"
+echo "  - popover, progress, radio-group, resizable, scroll-area"
+echo "  - select, separator, sheet, skeleton, slider, sonner"
+echo "  - switch, table, tabs, textarea, toast, toggle, toggle-group, tooltip"
+echo ""
+echo "To start developing:"
+echo "  cd $PROJECT_NAME"
+echo "  pnpm dev"
+echo ""
+echo "📚 Import components like:"
+echo "  import { Button } from '@/components/ui/button'"
+echo "  import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/card'"
+echo "  import { Dialog, DialogContent, DialogTrigger } from '@/components/ui/dialog'"
diff --git a/.claude/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz b/.claude/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz
new file mode 100644
index 0000000..cdbe7cd
Binary files /dev/null and b/.claude/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz differ
diff --git a/.claude/skills/web-design-guidelines/SKILL.md b/.claude/skills/web-design-guidelines/SKILL.md
new file mode 100644
index 0000000..ceae92a
--- /dev/null
+++ b/.claude/skills/web-design-guidelines/SKILL.md
@@ -0,0 +1,39 @@
+---
+name: web-design-guidelines
+description: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
+metadata:
+  author: vercel
+  version: "1.0.0"
+  argument-hint: <file-or-pattern>
+---
+
+# Web Interface Guidelines
+
+Review files for compliance with Web Interface Guidelines.
+
+## How It Works
+
+1. Fetch the latest guidelines from the source URL below
+2. Read the specified files (or prompt user for files/pattern)
+3. Check against all rules in the fetched guidelines
+4. Output findings in the terse `file:line` format
+
+## Guidelines Source
+
+Fetch fresh guidelines before each review:
+
+```
+https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
+```
+
+Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions.
+
+## Usage
+
+When a user provides a file or pattern argument:
+1. Fetch guidelines from the source URL above
+2. Read the specified files
+3. Apply all rules from the fetched guidelines
+4. Output findings using the format specified in the guidelines
+
+If no files specified, ask the user which files to review.
diff --git a/.claude/skills/webapp-testing/LICENSE.txt b/.claude/skills/webapp-testing/LICENSE.txt
new file mode 100644
index 0000000..7a4a3ea
--- /dev/null
+++ b/.claude/skills/webapp-testing/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
\ No newline at end of file
diff --git a/.claude/skills/webapp-testing/SKILL.md b/.claude/skills/webapp-testing/SKILL.md
new file mode 100644
index 0000000..4726215
--- /dev/null
+++ b/.claude/skills/webapp-testing/SKILL.md
@@ -0,0 +1,96 @@
+---
+name: webapp-testing
+description: Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
+license: Complete terms in LICENSE.txt
+---
+
+# Web Application Testing
+
+To test local web applications, write native Python Playwright scripts.
+
+**Helper Scripts Available**:
+- `scripts/with_server.py` - Manages server lifecycle (supports multiple servers)
+
+**Always run scripts with `--help` first** to see usage. DO NOT read the source until you try running the script first and find that a customized solution is abslutely necessary. These scripts can be very large and thus pollute your context window. They exist to be called directly as black-box scripts rather than ingested into your context window.
+
+## Decision Tree: Choosing Your Approach
+
+```
+User task → Is it static HTML?
+    ├─ Yes → Read HTML file directly to identify selectors
+    │         ├─ Success → Write Playwright script using selectors
+    │         └─ Fails/Incomplete → Treat as dynamic (below)
+    │
+    └─ No (dynamic webapp) → Is the server already running?
+        ├─ No → Run: python scripts/with_server.py --help
+        │        Then use the helper + write simplified Playwright script
+        │
+        └─ Yes → Reconnaissance-then-action:
+            1. Navigate and wait for networkidle
+            2. Take screenshot or inspect DOM
+            3. Identify selectors from rendered state
+            4. Execute actions with discovered selectors
+```
+
+## Example: Using with_server.py
+
+To start a server, run `--help` first, then use the helper:
+
+**Single server:**
+```bash
+python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py
+```
+
+**Multiple servers (e.g., backend + frontend):**
+```bash
+python scripts/with_server.py \
+  --server "cd backend && python server.py" --port 3000 \
+  --server "cd frontend && npm run dev" --port 5173 \
+  -- python your_automation.py
+```
+
+To create an automation script, include only Playwright logic (servers are managed automatically):
+```python
+from playwright.sync_api import sync_playwright
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True) # Always launch chromium in headless mode
+    page = browser.new_page()
+    page.goto('http://localhost:5173') # Server already running and ready
+    page.wait_for_load_state('networkidle') # CRITICAL: Wait for JS to execute
+    # ... your automation logic
+    browser.close()
+```
+
+## Reconnaissance-Then-Action Pattern
+
+1. **Inspect rendered DOM**:
+   ```python
+   page.screenshot(path='/tmp/inspect.png', full_page=True)
+   content = page.content()
+   page.locator('button').all()
+   ```
+
+2. **Identify selectors** from inspection results
+
+3. **Execute actions** using discovered selectors
+
+## Common Pitfall
+
+❌ **Don't** inspect the DOM before waiting for `networkidle` on dynamic apps
+✅ **Do** wait for `page.wait_for_load_state('networkidle')` before inspection
+
+## Best Practices
+
+- **Use bundled scripts as black boxes** - To accomplish a task, consider whether one of the scripts available in `scripts/` can help. These scripts handle common, complex workflows reliably without cluttering the context window. Use `--help` to see usage, then invoke directly. 
+- Use `sync_playwright()` for synchronous scripts
+- Always close the browser when done
+- Use descriptive selectors: `text=`, `role=`, CSS selectors, or IDs
+- Add appropriate waits: `page.wait_for_selector()` or `page.wait_for_timeout()`
+
+## Reference Files
+
+- **examples/** - Examples showing common patterns:
+  - `element_discovery.py` - Discovering buttons, links, and inputs on a page
+  - `static_html_automation.py` - Using file:// URLs for local HTML
+  - `console_logging.py` - Capturing console logs during automation
\ No newline at end of file
diff --git a/.claude/skills/webapp-testing/examples/console_logging.py b/.claude/skills/webapp-testing/examples/console_logging.py
new file mode 100644
index 0000000..9329b5e
--- /dev/null
+++ b/.claude/skills/webapp-testing/examples/console_logging.py
@@ -0,0 +1,35 @@
+from playwright.sync_api import sync_playwright
+
+# Example: Capturing console logs during browser automation
+
+url = 'http://localhost:5173'  # Replace with your URL
+
+console_logs = []
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page(viewport={'width': 1920, 'height': 1080})
+
+    # Set up console log capture
+    def handle_console_message(msg):
+        console_logs.append(f"[{msg.type}] {msg.text}")
+        print(f"Console: [{msg.type}] {msg.text}")
+
+    page.on("console", handle_console_message)
+
+    # Navigate to page
+    page.goto(url)
+    page.wait_for_load_state('networkidle')
+
+    # Interact with the page (triggers console logs)
+    page.click('text=Dashboard')
+    page.wait_for_timeout(1000)
+
+    browser.close()
+
+# Save console logs to file
+with open('/mnt/user-data/outputs/console.log', 'w') as f:
+    f.write('\n'.join(console_logs))
+
+print(f"\nCaptured {len(console_logs)} console messages")
+print(f"Logs saved to: /mnt/user-data/outputs/console.log")
\ No newline at end of file
diff --git a/.claude/skills/webapp-testing/examples/element_discovery.py b/.claude/skills/webapp-testing/examples/element_discovery.py
new file mode 100644
index 0000000..917ba72
--- /dev/null
+++ b/.claude/skills/webapp-testing/examples/element_discovery.py
@@ -0,0 +1,40 @@
+from playwright.sync_api import sync_playwright
+
+# Example: Discovering buttons and other elements on a page
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page()
+
+    # Navigate to page and wait for it to fully load
+    page.goto('http://localhost:5173')
+    page.wait_for_load_state('networkidle')
+
+    # Discover all buttons on the page
+    buttons = page.locator('button').all()
+    print(f"Found {len(buttons)} buttons:")
+    for i, button in enumerate(buttons):
+        text = button.inner_text() if button.is_visible() else "[hidden]"
+        print(f"  [{i}] {text}")
+
+    # Discover links
+    links = page.locator('a[href]').all()
+    print(f"\nFound {len(links)} links:")
+    for link in links[:5]:  # Show first 5
+        text = link.inner_text().strip()
+        href = link.get_attribute('href')
+        print(f"  - {text} -> {href}")
+
+    # Discover input fields
+    inputs = page.locator('input, textarea, select').all()
+    print(f"\nFound {len(inputs)} input fields:")
+    for input_elem in inputs:
+        name = input_elem.get_attribute('name') or input_elem.get_attribute('id') or "[unnamed]"
+        input_type = input_elem.get_attribute('type') or 'text'
+        print(f"  - {name} ({input_type})")
+
+    # Take screenshot for visual reference
+    page.screenshot(path='/tmp/page_discovery.png', full_page=True)
+    print("\nScreenshot saved to /tmp/page_discovery.png")
+
+    browser.close()
\ No newline at end of file
diff --git a/.claude/skills/webapp-testing/examples/static_html_automation.py b/.claude/skills/webapp-testing/examples/static_html_automation.py
new file mode 100644
index 0000000..90bbedc
--- /dev/null
+++ b/.claude/skills/webapp-testing/examples/static_html_automation.py
@@ -0,0 +1,33 @@
+from playwright.sync_api import sync_playwright
+import os
+
+# Example: Automating interaction with static HTML files using file:// URLs
+
+html_file_path = os.path.abspath('path/to/your/file.html')
+file_url = f'file://{html_file_path}'
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(headless=True)
+    page = browser.new_page(viewport={'width': 1920, 'height': 1080})
+
+    # Navigate to local HTML file
+    page.goto(file_url)
+
+    # Take screenshot
+    page.screenshot(path='/mnt/user-data/outputs/static_page.png', full_page=True)
+
+    # Interact with elements
+    page.click('text=Click Me')
+    page.fill('#name', 'John Doe')
+    page.fill('#email', 'john@example.com')
+
+    # Submit form
+    page.click('button[type="submit"]')
+    page.wait_for_timeout(500)
+
+    # Take final screenshot
+    page.screenshot(path='/mnt/user-data/outputs/after_submit.png', full_page=True)
+
+    browser.close()
+
+print("Static HTML automation completed!")
\ No newline at end of file
diff --git a/.claude/skills/webapp-testing/scripts/with_server.py b/.claude/skills/webapp-testing/scripts/with_server.py
new file mode 100644
index 0000000..431f2eb
--- /dev/null
+++ b/.claude/skills/webapp-testing/scripts/with_server.py
@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""
+Start one or more servers, wait for them to be ready, run a command, then clean up.
+
+Usage:
+    # Single server
+    python scripts/with_server.py --server "npm run dev" --port 5173 -- python automation.py
+    python scripts/with_server.py --server "npm start" --port 3000 -- python test.py
+
+    # Multiple servers
+    python scripts/with_server.py \
+      --server "cd backend && python server.py" --port 3000 \
+      --server "cd frontend && npm run dev" --port 5173 \
+      -- python test.py
+"""
+
+import subprocess
+import socket
+import time
+import sys
+import argparse
+
+def is_server_ready(port, timeout=30):
+    """Wait for server to be ready by polling the port."""
+    start_time = time.time()
+    while time.time() - start_time < timeout:
+        try:
+            with socket.create_connection(('localhost', port), timeout=1):
+                return True
+        except (socket.error, ConnectionRefusedError):
+            time.sleep(0.5)
+    return False
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Run command with one or more servers')
+    parser.add_argument('--server', action='append', dest='servers', required=True, help='Server command (can be repeated)')
+    parser.add_argument('--port', action='append', dest='ports', type=int, required=True, help='Port for each server (must match --server count)')
+    parser.add_argument('--timeout', type=int, default=30, help='Timeout in seconds per server (default: 30)')
+    parser.add_argument('command', nargs=argparse.REMAINDER, help='Command to run after server(s) ready')
+
+    args = parser.parse_args()
+
+    # Remove the '--' separator if present
+    if args.command and args.command[0] == '--':
+        args.command = args.command[1:]
+
+    if not args.command:
+        print("Error: No command specified to run")
+        sys.exit(1)
+
+    # Parse server configurations
+    if len(args.servers) != len(args.ports):
+        print("Error: Number of --server and --port arguments must match")
+        sys.exit(1)
+
+    servers = []
+    for cmd, port in zip(args.servers, args.ports):
+        servers.append({'cmd': cmd, 'port': port})
+
+    server_processes = []
+
+    try:
+        # Start all servers
+        for i, server in enumerate(servers):
+            print(f"Starting server {i+1}/{len(servers)}: {server['cmd']}")
+
+            # Use shell=True to support commands with cd and &&
+            process = subprocess.Popen(
+                server['cmd'],
+                shell=True,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE
+            )
+            server_processes.append(process)
+
+            # Wait for this server to be ready
+            print(f"Waiting for server on port {server['port']}...")
+            if not is_server_ready(server['port'], timeout=args.timeout):
+                raise RuntimeError(f"Server failed to start on port {server['port']} within {args.timeout}s")
+
+            print(f"Server ready on port {server['port']}")
+
+        print(f"\nAll {len(servers)} server(s) ready")
+
+        # Run the command
+        print(f"Running: {' '.join(args.command)}\n")
+        result = subprocess.run(args.command)
+        sys.exit(result.returncode)
+
+    finally:
+        # Clean up all servers
+        print(f"\nStopping {len(server_processes)} server(s)...")
+        for i, process in enumerate(server_processes):
+            try:
+                process.terminate()
+                process.wait(timeout=5)
+            except subprocess.TimeoutExpired:
+                process.kill()
+                process.wait()
+            print(f"Server {i+1} stopped")
+        print("All servers stopped")
+
+
+if __name__ == '__main__':
+    main()
\ No newline at end of file
diff --git a/.claude/skills/write-a-skill/SKILL.md b/.claude/skills/write-a-skill/SKILL.md
new file mode 100644
index 0000000..7339c8a
--- /dev/null
+++ b/.claude/skills/write-a-skill/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: write-a-skill
+description: Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
+---
+
+# Writing Skills
+
+## Process
+
+1. **Gather requirements** - ask user about:
+   - What task/domain does the skill cover?
+   - What specific use cases should it handle?
+   - Does it need executable scripts or just instructions?
+   - Any reference materials to include?
+
+2. **Draft the skill** - create:
+   - SKILL.md with concise instructions
+   - Additional reference files if content exceeds 500 lines
+   - Utility scripts if deterministic operations needed
+
+3. **Review with user** - present draft and ask:
+   - Does this cover your use cases?
+   - Anything missing or unclear?
+   - Should any section be more/less detailed?
+
+## Skill Structure
+
+```
+skill-name/
+├── SKILL.md           # Main instructions (required)
+├── REFERENCE.md       # Detailed docs (if needed)
+├── EXAMPLES.md        # Usage examples (if needed)
+└── scripts/           # Utility scripts (if needed)
+    └── helper.js
+```
+
+## SKILL.md Template
+
+```md
+---
+name: skill-name
+description: Brief description of capability. Use when [specific triggers].
+---
+
+# Skill Name
+
+## Quick start
+
+[Minimal working example]
+
+## Workflows
+
+[Step-by-step processes with checklists for complex tasks]
+
+## Advanced features
+
+[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
+```
+
+## Description Requirements
+
+The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
+
+**Goal**: Give your agent just enough info to know:
+
+1. What capability this skill provides
+2. When/why to trigger it (specific keywords, contexts, file types)
+
+**Format**:
+
+- Max 1024 chars
+- Write in third person
+- First sentence: what it does
+- Second sentence: "Use when [specific triggers]"
+
+**Good example**:
+
+```
+Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
+```
+
+**Bad example**:
+
+```
+Helps with documents.
+```
+
+The bad example gives your agent no way to distinguish this from other document skills.
+
+## When to Add Scripts
+
+Add utility scripts when:
+
+- Operation is deterministic (validation, formatting)
+- Same code would be generated repeatedly
+- Errors need explicit handling
+
+Scripts save tokens and improve reliability vs generated code.
+
+## When to Split Files
+
+Split into separate files when:
+
+- SKILL.md exceeds 100 lines
+- Content has distinct domains (finance vs sales schemas)
+- Advanced features are rarely needed
+
+## Review Checklist
+
+After drafting, verify:
+
+- [ ] Description includes triggers ("Use when...")
+- [ ] SKILL.md under 100 lines
+- [ ] No time-sensitive info
+- [ ] Consistent terminology
+- [ ] Concrete examples included
+- [ ] References one level deep
diff --git a/.claude/skills/zoom-out/SKILL.md b/.claude/skills/zoom-out/SKILL.md
new file mode 100644
index 0000000..1e7a5dc
--- /dev/null
+++ b/.claude/skills/zoom-out/SKILL.md
@@ -0,0 +1,7 @@
+---
+name: zoom-out
+description: Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
+disable-model-invocation: true
+---
+
+I don't know this area of code well. Go up a layer of abstraction. Give me a map of all the relevant modules and callers, using the project's domain glossary vocabulary.
diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..6a8a3db
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,25 @@
+.git
+.DS_Store
+**/.DS_Store
+
+android/.gradle
+android/**/build
+android/app/debug
+android
+
+backend/commory
+backend/coverage.out
+backend/data
+
+web/node_modules
+web/dist
+web/.auto-import.json
+web/src/types/import/auto-imports.d.ts
+web/src/types/import/components.d.ts
+
+previewer/node_modules
+previewer/dist
+previewer
+
+references
+references/*/.git
diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..e5ede5d
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,10 @@
+# Commory Docker Compose 示例配置
+
+# 单端口入口：http://localhost:3000
+COMMORY_HTTP_PORT=3000
+
+# 生产环境必须替换为足够长的随机密钥。
+COMMORY_AUTH_SECRET=change-me
+
+# 开发可使用 development；生产建议设置为 production。
+COMMORY_ENV=development
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 0000000..59e20f0
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,41 @@
+# 变更描述
+
+请说明本 PR 解决的问题、用户可见变化和主要实现方式。
+
+## 影响范围
+
+- [ ] Android
+- [ ] Backend
+- [ ] Web
+- [ ] MsgLayer/schema
+- [ ] Agent/runtime
+- [ ] Docker/部署
+- [ ] 文档/Rules
+
+## 契约一致性
+
+- [ ] API 变更已同步 `docs/mobile-api.md`
+- [ ] MsgLayer 变更已同步 schema、examples、Android mapper 和 Go types
+- [ ] Web 用户可见文案已同步 `zh.json` 和 `en.json`
+- [ ] Android 用户可见文案已同步 `values/`、`values-en/`、`values-zh-rCN/`
+
+## 隐私与本地模式
+
+- [ ] Local-only mode 不需要网络或 auth
+- [ ] 日志不包含短信正文、联系人内容、token、备份载荷或带凭据 URL
+- [ ] Agent context policy 符合最小必要上下文原则
+
+## 测试
+
+请列出已运行的命令和结果：
+
+```bash
+
+```
+
+## 发布与兼容性
+
+- [ ] 需要更新 `CHANGELOG.md`
+- [ ] 需要迁移说明
+- [ ] 需要 Docker Compose 验证
+- [ ] 跨 Android + Backend + Web + MsgLayer 的变更已完成多端检查
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..aaf3566
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  backend:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+      - name: Format check
+        run: test -z "$(gofmt -l backend)"
+      - name: Vet
+        working-directory: backend
+        run: go vet ./...
+      - name: Test
+        working-directory: backend
+        run: go test ./... -coverprofile=coverage.out
+
+  android:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '25'
+      - name: Android compile
+        working-directory: android
+        run: sh ./gradlew :app:compileDebugKotlin
+      - name: Android unit tests
+        working-directory: android
+        run: sh ./gradlew :app:testDebugUnitTest
+
+  governance:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Repo hygiene
+        run: bash scripts/check-repo-hygiene.sh
+      - name: Reference governance
+        run: bash scripts/check-reference-governance.sh
+      - name: Android i18n keys
+        run: bash scripts/check-android-i18n.sh
+      - name: Agent skills mirror
+        run: bash scripts/sync-agent-skills.sh --check
+      - name: LOC report
+        run: bash scripts/report-loc-complexity.sh
+
+  web:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Enable corepack
+        run: corepack enable
+      - name: Install dependencies
+        working-directory: web
+        run: pnpm install --frozen-lockfile
+      - name: Lint
+        working-directory: web
+        run: pnpm lint
+      - name: Build
+        working-directory: web
+        run: pnpm build
diff --git a/.gitignore b/.gitignore
index 5381194..bc77318 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,11 +11,14 @@ Thumbs.db
 # Environment
 .env
 .env.*
+!.env.example
+!web/.env.production
 
 # Android
 android/.gradle/
 android/build/
 android/app/build/
+android/app/debug/
 android/local.properties
 android/*.apk
 android/*.aab
@@ -27,10 +30,25 @@ previewer/dist/
 previewer/.temp/
 previewer/.cache/
 .pnpm-store/
+web/node_modules/
+web/dist/
+web/dist-ssr/
+web/*.local
+web/.cursorrules
+web/src/types/import/auto-imports.d.ts
+web/src/types/import/components.d.ts
+web/.auto-import.json
 
 # Coverage
 coverage/
 *.coverprofile
+coverage.out
 
 # Trae
 .trae/
+.playwright-mcp/
+backend/data/
+
+# Non-standard generated reports
+**/AI_EDIT_LOG.md
+references/ClaudeCodeSource/
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..3b85c88
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,28 @@
+[submodule "references/art-design-pro"]
+	path = references/art-design-pro
+	url = https://github.com/Daymychen/art-design-pro.git
+	branch = main
+[submodule "references/new-api"]
+	path = references/new-api
+	url = https://github.com/QuantumNous/new-api.git
+[submodule "references/hermes-agent"]
+	path = references/hermes-agent
+	url = https://github.com/NousResearch/hermes-agent.git
+[submodule "references/openclaw"]
+	path = references/openclaw
+	url = https://github.com/openclaw/openclaw.git
+[submodule "references/GitHubDaily"]
+	path = references/GitHubDaily
+	url = https://github.com/GitHubDaily/GitHubDaily.git
+[submodule "references/memos"]
+	path = references/memos
+	url = https://github.com/usememos/memos.git
+[submodule "references/gitea"]
+	path = references/gitea
+	url = https://github.com/go-gitea/gitea.git
+[submodule "references/pocketbase"]
+	path = references/pocketbase
+	url = https://github.com/pocketbase/pocketbase.git
+[submodule "references/sqlc"]
+	path = references/sqlc
+	url = https://github.com/sqlc-dev/sqlc.git
diff --git a/.kilocode/skills/caveman/SKILL.md b/.kilocode/skills/caveman/SKILL.md
new file mode 100644
index 0000000..85770a3
--- /dev/null
+++ b/.kilocode/skills/caveman/SKILL.md
@@ -0,0 +1,49 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode. Cuts token usage ~75% by dropping
+  filler, articles, and pleasantries while keeping full technical accuracy.
+  Use when user says "caveman mode", "talk like caveman", "use caveman",
+  "less tokens", "be brief", or invokes /caveman.
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode".
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough.
+
+Technical terms stay exact. Code blocks unchanged. Errors quoted exact.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+### Examples
+
+**"Why React component re-render?"**
+
+> Inline obj prop -> new ref -> re-render. `useMemo`.
+
+**"Explain database connection pooling."**
+
+> Pool = reuse DB conn. Skip handshake -> fast under load.
+
+## Auto-Clarity Exception
+
+Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
+
+Example -- destructive op:
+
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+>
+> ```sql
+> DROP TABLE users;
+> ```
+>
+> Caveman resume. Verify backup exist first.
diff --git a/.kilocode/skills/diagnose/SKILL.md b/.kilocode/skills/diagnose/SKILL.md
new file mode 100644
index 0000000..ed55bda
--- /dev/null
+++ b/.kilocode/skills/diagnose/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: diagnose
+description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
+---
+
+# Diagnose
+
+A discipline for hard bugs. Skip phases only when explicitly justified.
+
+When exploring the codebase, use the project's domain glossary to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.
+
+## Phase 1 — Build a feedback loop
+
+**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you.
+
+Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.**
+
+### Ways to construct one — try them in roughly this order
+
+1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.
+2. **Curl / HTTP script** against a running dev server.
+3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.
+4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network.
+5. **Replay a captured trace.** Save a real network request / payload / event log to disk; replay it through the code path in isolation.
+6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that exercises the bug code path with a single function call.
+7. **Property / fuzz loop.** If the bug is "sometimes wrong output", run 1000 random inputs and look for the failure mode.
+8. **Bisection harness.** If the bug appeared between two known states (commit, dataset, version), automate "boot at state X, check, repeat" so you can `git bisect run` it.
+9. **Differential loop.** Run the same input through old-version vs new-version (or two configs) and diff outputs.
+10. **HITL bash script.** Last resort. If a human must click, drive _them_ with `scripts/hitl-loop.template.sh` so the loop is still structured. Captured output feeds back to you.
+
+Build the right feedback loop, and the bug is 90% fixed.
+
+### Iterate on the loop itself
+
+Treat the loop as a product. Once you have _a_ loop, ask:
+
+- Can I make it faster? (Cache setup, skip unrelated init, narrow the test scope.)
+- Can I make the signal sharper? (Assert on the specific symptom, not "didn't crash".)
+- Can I make it more deterministic? (Pin time, seed RNG, isolate filesystem, freeze network.)
+
+A 30-second flaky loop is barely better than no loop. A 2-second deterministic loop is a debugging superpower.
+
+### Non-deterministic bugs
+
+The goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×, parallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake bug is debuggable; 1% is not — keep raising the rate until it's debuggable.
+
+### When you genuinely cannot build a loop
+
+Stop and say so explicitly. List what you tried. Ask the user for: (a) access to whatever environment reproduces it, (b) a captured artifact (HAR file, log dump, core dump, screen recording with timestamps), or (c) permission to add temporary production instrumentation. Do **not** proceed to hypothesise without a loop.
+
+Do not proceed to Phase 2 until you have a loop you believe in.
+
+## Phase 2 — Reproduce
+
+Run the loop. Watch the bug appear.
+
+Confirm:
+
+- [ ] The loop produces the failure mode the **user** described — not a different failure that happens to be nearby. Wrong bug = wrong fix.
+- [ ] The failure is reproducible across multiple runs (or, for non-deterministic bugs, reproducible at a high enough rate to debug against).
+- [ ] You have captured the exact symptom (error message, wrong output, slow timing) so later phases can verify the fix actually addresses it.
+
+Do not proceed until you reproduce the bug.
+
+## Phase 3 — Hypothesise
+
+Generate **3–5 ranked hypotheses** before testing any of them. Single-hypothesis generation anchors on the first plausible idea.
+
+Each hypothesis must be **falsifiable**: state the prediction it makes.
+
+> Format: "If <X> is the cause, then <changing Y> will make the bug disappear / <changing Z> will make it worse."
+
+If you cannot state the prediction, the hypothesis is a vibe — discard or sharpen it.
+
+**Show the ranked list to the user before testing.** They often have domain knowledge that re-ranks instantly ("we just deployed a change to #3"), or know hypotheses they've already ruled out. Cheap checkpoint, big time saver. Don't block on it — proceed with your ranking if the user is AFK.
+
+## Phase 4 — Instrument
+
+Each probe must map to a specific prediction from Phase 3. **Change one variable at a time.**
+
+Tool preference:
+
+1. **Debugger / REPL inspection** if the env supports it. One breakpoint beats ten logs.
+2. **Targeted logs** at the boundaries that distinguish hypotheses.
+3. Never "log everything and grep".
+
+**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep. Untagged logs survive; tagged logs die.
+
+**Perf branch.** For performance regressions, logs are usually wrong. Instead: establish a baseline measurement (timing harness, `performance.now()`, profiler, query plan), then bisect. Measure first, fix second.
+
+## Phase 5 — Fix + regression test
+
+Write the regression test **before the fix** — but only if there is a **correct seam** for it.
+
+A correct seam is one where the test exercises the **real bug pattern** as it occurs at the call site. If the only available seam is too shallow (single-caller test when the bug needs multiple callers, unit test that can't replicate the chain that triggered the bug), a regression test there gives false confidence.
+
+**If no correct seam exists, that itself is the finding.** Note it. The codebase architecture is preventing the bug from being locked down. Flag this for the next phase.
+
+If a correct seam exists:
+
+1. Turn the minimised repro into a failing test at that seam.
+2. Watch it fail.
+3. Apply the fix.
+4. Watch it pass.
+5. Re-run the Phase 1 feedback loop against the original (un-minimised) scenario.
+
+## Phase 6 — Cleanup + post-mortem
+
+Required before declaring done:
+
+- [ ] Original repro no longer reproduces (re-run the Phase 1 loop)
+- [ ] Regression test passes (or absence of seam is documented)
+- [ ] All `[DEBUG-...]` instrumentation removed (`grep` the prefix)
+- [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location)
+- [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns
+
+**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started.
diff --git a/.kilocode/skills/diagnose/scripts/hitl-loop.template.sh b/.kilocode/skills/diagnose/scripts/hitl-loop.template.sh
new file mode 100644
index 0000000..40afc46
--- /dev/null
+++ b/.kilocode/skills/diagnose/scripts/hitl-loop.template.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Human-in-the-loop reproduction loop.
+# Copy this file, edit the steps below, and run it.
+# The agent runs the script; the user follows prompts in their terminal.
+#
+# Usage:
+#   bash hitl-loop.template.sh
+#
+# Two helpers:
+#   step "<instruction>"          → show instruction, wait for Enter
+#   capture VAR "<question>"      → show question, read response into VAR
+#
+# At the end, captured values are printed as KEY=VALUE for the agent to parse.
+
+set -euo pipefail
+
+step() {
+  printf '\n>>> %s\n' "$1"
+  read -r -p "    [Enter when done] " _
+}
+
+capture() {
+  local var="$1" question="$2" answer
+  printf '\n>>> %s\n' "$question"
+  read -r -p "    > " answer
+  printf -v "$var" '%s' "$answer"
+}
+
+# --- edit below ---------------------------------------------------------
+
+step "Open the app at http://localhost:3000 and sign in."
+
+capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)"
+
+capture ERROR_MSG "Paste the error message (or 'none'):"
+
+# --- edit above ---------------------------------------------------------
+
+printf '\n--- Captured ---\n'
+printf 'ERRORED=%s\n' "$ERRORED"
+printf 'ERROR_MSG=%s\n' "$ERROR_MSG"
diff --git a/.kilocode/skills/grill-me/SKILL.md b/.kilocode/skills/grill-me/SKILL.md
new file mode 100644
index 0000000..bd04394
--- /dev/null
+++ b/.kilocode/skills/grill-me/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: grill-me
+description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
+---
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
diff --git a/.kilocode/skills/grill-with-docs/ADR-FORMAT.md b/.kilocode/skills/grill-with-docs/ADR-FORMAT.md
new file mode 100644
index 0000000..da7e78e
--- /dev/null
+++ b/.kilocode/skills/grill-with-docs/ADR-FORMAT.md
@@ -0,0 +1,47 @@
+# ADR Format
+
+ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
+
+Create the `docs/adr/` directory lazily — only when the first ADR is needed.
+
+## Template
+
+```md
+# {Short title of the decision}
+
+{1-3 sentences: what's the context, what did we decide, and why.}
+```
+
+That's it. An ADR can be a single paragraph. The value is in recording *that* a decision was made and *why* — not in filling out sections.
+
+## Optional sections
+
+Only include these when they add genuine value. Most ADRs won't need them.
+
+- **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited
+- **Considered Options** — only when the rejected alternatives are worth remembering
+- **Consequences** — only when non-obvious downstream effects need to be called out
+
+## Numbering
+
+Scan `docs/adr/` for the highest existing number and increment by one.
+
+## When to offer an ADR
+
+All three of these must be true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing."
+
+### What qualifies
+
+- **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres."
+- **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP."
+- **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out.
+- **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s.
+- **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate.
+- **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract."
+- **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months.
diff --git a/.kilocode/skills/grill-with-docs/CONTEXT-FORMAT.md b/.kilocode/skills/grill-with-docs/CONTEXT-FORMAT.md
new file mode 100644
index 0000000..ddfa247
--- /dev/null
+++ b/.kilocode/skills/grill-with-docs/CONTEXT-FORMAT.md
@@ -0,0 +1,77 @@
+# CONTEXT.md Format
+
+## Structure
+
+```md
+# {Context Name}
+
+{One or two sentence description of what this context is and why it exists.}
+
+## Language
+
+**Order**:
+{A concise description of the term}
+_Avoid_: Purchase, transaction
+
+**Invoice**:
+A request for payment sent to a customer after delivery.
+_Avoid_: Bill, payment request
+
+**Customer**:
+A person or organization that places orders.
+_Avoid_: Client, buyer, account
+
+## Relationships
+
+- An **Order** produces one or more **Invoices**
+- An **Invoice** belongs to exactly one **Customer**
+
+## Example dialogue
+
+> **Dev:** "When a **Customer** places an **Order**, do we create the **Invoice** immediately?"
+> **Domain expert:** "No — an **Invoice** is only generated once a **Fulfillment** is confirmed."
+
+## Flagged ambiguities
+
+- "account" was used to mean both **Customer** and **User** — resolved: these are distinct concepts.
+```
+
+## Rules
+
+- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others as aliases to avoid.
+- **Flag conflicts explicitly.** If a term is used ambiguously, call it out in "Flagged ambiguities" with a clear resolution.
+- **Keep definitions tight.** One sentence max. Define what it IS, not what it does.
+- **Show relationships.** Use bold term names and express cardinality where obvious.
+- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
+- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
+- **Write an example dialogue.** A conversation between a dev and a domain expert that demonstrates how the terms interact naturally and clarifies boundaries between related concepts.
+
+## Single vs multi-context repos
+
+**Single context (most repos):** One `CONTEXT.md` at the repo root.
+
+**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
+
+```md
+# Context Map
+
+## Contexts
+
+- [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders
+- [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments
+- [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping
+
+## Relationships
+
+- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
+- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
+- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
+```
+
+The skill infers which structure applies:
+
+- If `CONTEXT-MAP.md` exists, read it to find contexts
+- If only a root `CONTEXT.md` exists, single context
+- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
+
+When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
diff --git a/.kilocode/skills/grill-with-docs/SKILL.md b/.kilocode/skills/grill-with-docs/SKILL.md
new file mode 100644
index 0000000..5ea0aa9
--- /dev/null
+++ b/.kilocode/skills/grill-with-docs/SKILL.md
@@ -0,0 +1,88 @@
+---
+name: grill-with-docs
+description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
+---
+
+<what-to-do>
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time, waiting for feedback on each question before continuing.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
+
+</what-to-do>
+
+<supporting-info>
+
+## Domain awareness
+
+During codebase exploration, also look for existing documentation:
+
+### File structure
+
+Most repos have a single context:
+
+```
+/
+├── CONTEXT.md
+├── docs/
+│   └── adr/
+│       ├── 0001-event-sourced-orders.md
+│       └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/
+│   └── adr/                          ← system-wide decisions
+├── src/
+│   ├── ordering/
+│   │   ├── CONTEXT.md
+│   │   └── docs/adr/                 ← context-specific decisions
+│   └── billing/
+│       ├── CONTEXT.md
+│       └── docs/adr/
+```
+
+Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
+
+## During the session
+
+### Challenge against the glossary
+
+When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"
+
+### Sharpen fuzzy language
+
+When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things."
+
+### Discuss concrete scenarios
+
+When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
+
+### Cross-reference with code
+
+When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible — which is right?"
+
+### Update CONTEXT.md inline
+
+When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
+
+`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
+
+### Offer ADRs sparingly
+
+Only offer to create an ADR when all three are true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will wonder "why did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md).
+
+</supporting-info>
diff --git a/.kilocode/skills/handoff/SKILL.md b/.kilocode/skills/handoff/SKILL.md
new file mode 100644
index 0000000..28bfb3a
--- /dev/null
+++ b/.kilocode/skills/handoff/SKILL.md
@@ -0,0 +1,13 @@
+---
+name: handoff
+description: Compact the current conversation into a handoff document for another agent to pick up.
+argument-hint: "What will the next session be used for?"
+---
+
+Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it).
+
+Suggest the skills to be used, if any, by the next session.
+
+Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+
+If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
diff --git a/.kilocode/skills/improve-codebase-architecture/DEEPENING.md b/.kilocode/skills/improve-codebase-architecture/DEEPENING.md
new file mode 100644
index 0000000..ecaf5d7
--- /dev/null
+++ b/.kilocode/skills/improve-codebase-architecture/DEEPENING.md
@@ -0,0 +1,37 @@
+# Deepening
+
+How to deepen a cluster of shallow modules safely, given its dependencies. Assumes the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**.
+
+## Dependency categories
+
+When assessing a candidate for deepening, classify its dependencies. The category determines how the deepened module is tested across its seam.
+
+### 1. In-process
+
+Pure computation, in-memory state, no I/O. Always deepenable — merge the modules and test through the new interface directly. No adapter needed.
+
+### 2. Local-substitutable
+
+Dependencies that have local test stand-ins (PGLite for Postgres, in-memory filesystem). Deepenable if the stand-in exists. The deepened module is tested with the stand-in running in the test suite. The seam is internal; no port at the module's external interface.
+
+### 3. Remote but owned (Ports & Adapters)
+
+Your own services across a network boundary (microservices, internal APIs). Define a **port** (interface) at the seam. The deep module owns the logic; the transport is injected as an **adapter**. Tests use an in-memory adapter. Production uses an HTTP/gRPC/queue adapter.
+
+Recommendation shape: *"Define a port at the seam, implement an HTTP adapter for production and an in-memory adapter for testing, so the logic sits in one deep module even though it's deployed across a network."*
+
+### 4. True external (Mock)
+
+Third-party services (Stripe, Twilio, etc.) you don't control. The deepened module takes the external dependency as an injected port; tests provide a mock adapter.
+
+## Seam discipline
+
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a port unless at least two adapters are justified (typically production + test). A single-adapter seam is just indirection.
+- **Internal seams vs external seams.** A deep module can have internal seams (private to its implementation, used by its own tests) as well as the external seam at its interface. Don't expose internal seams through the interface just because tests use them.
+
+## Testing strategy: replace, don't layer
+
+- Old unit tests on shallow modules become waste once tests at the deepened module's interface exist — delete them.
+- Write new tests at the deepened module's interface. The **interface is the test surface**.
+- Tests assert on observable outcomes through the interface, not internal state.
+- Tests should survive internal refactors — they describe behaviour, not implementation. If a test has to change when the implementation changes, it's testing past the interface.
diff --git a/.kilocode/skills/improve-codebase-architecture/INTERFACE-DESIGN.md b/.kilocode/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
new file mode 100644
index 0000000..3197723
--- /dev/null
+++ b/.kilocode/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
@@ -0,0 +1,44 @@
+# Interface Design
+
+When the user wants to explore alternative interfaces for a chosen deepening candidate, use this parallel sub-agent pattern. Based on "Design It Twice" (Ousterhout) — your first idea is unlikely to be the best.
+
+Uses the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**, **leverage**.
+
+## Process
+
+### 1. Frame the problem space
+
+Before spawning sub-agents, write a user-facing explanation of the problem space for the chosen candidate:
+
+- The constraints any new interface would need to satisfy
+- The dependencies it would rely on, and which category they fall into (see [DEEPENING.md](DEEPENING.md))
+- A rough illustrative code sketch to ground the constraints — not a proposal, just a way to make the constraints concrete
+
+Show this to the user, then immediately proceed to Step 2. The user reads and thinks while the sub-agents work in parallel.
+
+### 2. Spawn sub-agents
+
+Spawn 3+ sub-agents in parallel using the Agent tool. Each must produce a **radically different** interface for the deepened module.
+
+Prompt each sub-agent with a separate technical brief (file paths, coupling details, dependency category from [DEEPENING.md](DEEPENING.md), what sits behind the seam). The brief is independent of the user-facing problem-space explanation in Step 1. Give each agent a different design constraint:
+
+- Agent 1: "Minimize the interface — aim for 1–3 entry points max. Maximise leverage per entry point."
+- Agent 2: "Maximise flexibility — support many use cases and extension."
+- Agent 3: "Optimise for the most common caller — make the default case trivial."
+- Agent 4 (if applicable): "Design around ports & adapters for cross-seam dependencies."
+
+Include both [LANGUAGE.md](LANGUAGE.md) vocabulary and CONTEXT.md vocabulary in the brief so each sub-agent names things consistently with the architecture language and the project's domain language.
+
+Each sub-agent outputs:
+
+1. Interface (types, methods, params — plus invariants, ordering, error modes)
+2. Usage example showing how callers use it
+3. What the implementation hides behind the seam
+4. Dependency strategy and adapters (see [DEEPENING.md](DEEPENING.md))
+5. Trade-offs — where leverage is high, where it's thin
+
+### 3. Present and compare
+
+Present designs sequentially so the user can absorb each one, then compare them in prose. Contrast by **depth** (leverage at the interface), **locality** (where change concentrates), and **seam placement**.
+
+After comparing, give your own recommendation: which design you think is strongest and why. If elements from different designs would combine well, propose a hybrid. Be opinionated — the user wants a strong read, not a menu.
diff --git a/.kilocode/skills/improve-codebase-architecture/LANGUAGE.md b/.kilocode/skills/improve-codebase-architecture/LANGUAGE.md
new file mode 100644
index 0000000..530c276
--- /dev/null
+++ b/.kilocode/skills/improve-codebase-architecture/LANGUAGE.md
@@ -0,0 +1,53 @@
+# Language
+
+Shared vocabulary for every suggestion this skill makes. Use these terms exactly — don't substitute "component," "service," "API," or "boundary." Consistent language is the whole point.
+
+## Terms
+
+**Module**
+Anything with an interface and an implementation. Deliberately scale-agnostic — applies equally to a function, class, package, or tier-spanning slice.
+_Avoid_: unit, component, service.
+
+**Interface**
+Everything a caller must know to use the module correctly. Includes the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics.
+_Avoid_: API, signature (too narrow — those refer only to the type-level surface).
+
+**Implementation**
+What's inside a module — its body of code. Distinct from **Adapter**: a thing can be a small adapter with a large implementation (a Postgres repo) or a large adapter with a small implementation (an in-memory fake). Reach for "adapter" when the seam is the topic; "implementation" otherwise.
+
+**Depth**
+Leverage at the interface — the amount of behaviour a caller (or test) can exercise per unit of interface they have to learn. A module is **deep** when a large amount of behaviour sits behind a small interface. A module is **shallow** when the interface is nearly as complex as the implementation.
+
+**Seam** _(from Michael Feathers)_
+A place where you can alter behaviour without editing in that place. The *location* at which a module's interface lives. Choosing where to put the seam is its own design decision, distinct from what goes behind it.
+_Avoid_: boundary (overloaded with DDD's bounded context).
+
+**Adapter**
+A concrete thing that satisfies an interface at a seam. Describes *role* (what slot it fills), not substance (what's inside).
+
+**Leverage**
+What callers get from depth. More capability per unit of interface they have to learn. One implementation pays back across N call sites and M tests.
+
+**Locality**
+What maintainers get from depth. Change, bugs, knowledge, and verification concentrate at one place rather than spreading across callers. Fix once, fixed everywhere.
+
+## Principles
+
+- **Depth is a property of the interface, not the implementation.** A deep module can be internally composed of small, mockable, swappable parts — they just aren't part of the interface. A module can have **internal seams** (private to its implementation, used by its own tests) as well as the **external seam** at its interface.
+- **The deletion test.** Imagine deleting the module. If complexity vanishes, the module wasn't hiding anything (it was a pass-through). If complexity reappears across N callers, the module was earning its keep.
+- **The interface is the test surface.** Callers and tests cross the same seam. If you want to test *past* the interface, the module is probably the wrong shape.
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a seam unless something actually varies across it.
+
+## Relationships
+
+- A **Module** has exactly one **Interface** (the surface it presents to callers and tests).
+- **Depth** is a property of a **Module**, measured against its **Interface**.
+- A **Seam** is where a **Module**'s **Interface** lives.
+- An **Adapter** sits at a **Seam** and satisfies the **Interface**.
+- **Depth** produces **Leverage** for callers and **Locality** for maintainers.
+
+## Rejected framings
+
+- **Depth as ratio of implementation-lines to interface-lines** (Ousterhout): rewards padding the implementation. We use depth-as-leverage instead.
+- **"Interface" as the TypeScript `interface` keyword or a class's public methods**: too narrow — interface here includes every fact a caller must know.
+- **"Boundary"**: overloaded with DDD's bounded context. Say **seam** or **interface**.
diff --git a/.kilocode/skills/improve-codebase-architecture/SKILL.md b/.kilocode/skills/improve-codebase-architecture/SKILL.md
new file mode 100644
index 0000000..05984a6
--- /dev/null
+++ b/.kilocode/skills/improve-codebase-architecture/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: improve-codebase-architecture
+description: Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
+---
+
+# Improve Codebase Architecture
+
+Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
+
+## Glossary
+
+Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).
+
+- **Module** — anything with an interface and an implementation (function, class, package, slice).
+- **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
+- **Implementation** — the code inside.
+- **Depth** — leverage at the interface: a lot of behaviour behind a small interface. **Deep** = high leverage. **Shallow** = interface nearly as complex as the implementation.
+- **Seam** — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.")
+- **Adapter** — a concrete thing satisfying an interface at a seam.
+- **Leverage** — what callers get from depth.
+- **Locality** — what maintainers get from depth: change, bugs, knowledge concentrated in one place.
+
+Key principles (see [LANGUAGE.md](LANGUAGE.md) for the full list):
+
+- **Deletion test**: imagine deleting the module. If complexity vanishes, it was a pass-through. If complexity reappears across N callers, it was earning its keep.
+- **The interface is the test surface.**
+- **One adapter = hypothetical seam. Two adapters = real seam.**
+
+This skill is _informed_ by the project's domain model. The domain language gives names to good seams; ADRs record decisions the skill should not re-litigate.
+
+## Process
+
+### 1. Explore
+
+Read the project's domain glossary and any ADRs in the area you're touching first.
+
+Then use the Agent tool with `subagent_type=Explore` to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction:
+
+- Where does understanding one concept require bouncing between many small modules?
+- Where are modules **shallow** — interface nearly as complex as the implementation?
+- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no **locality**)?
+- Where do tightly-coupled modules leak across their seams?
+- Which parts of the codebase are untested, or hard to test through their current interface?
+
+Apply the **deletion test** to anything you suspect is shallow: would deleting it concentrate complexity, or just move it? A "yes, concentrates" is the signal you want.
+
+### 2. Present candidates
+
+Present a numbered list of deepening opportunities. For each candidate:
+
+- **Files** — which files/modules are involved
+- **Problem** — why the current architecture is causing friction
+- **Solution** — plain English description of what would change
+- **Benefits** — explained in terms of locality and leverage, and also in how tests would improve
+
+**Use CONTEXT.md vocabulary for the domain, and [LANGUAGE.md](LANGUAGE.md) vocabulary for the architecture.** If `CONTEXT.md` defines "Order," talk about "the Order intake module" — not "the FooBarHandler," and not "the Order service."
+
+**ADR conflicts**: if a candidate contradicts an existing ADR, only surface it when the friction is real enough to warrant revisiting the ADR. Mark it clearly (e.g. _"contradicts ADR-0007 — but worth reopening because…"_). Don't list every theoretical refactor an ADR forbids.
+
+Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
+
+### 3. Grilling loop
+
+Once the user picks a candidate, drop into a grilling conversation. Walk the design tree with them — constraints, dependencies, the shape of the deepened module, what sits behind the seam, what tests survive.
+
+Side effects happen inline as decisions crystallize:
+
+- **Naming a deepened module after a concept not in `CONTEXT.md`?** Add the term to `CONTEXT.md` — same discipline as `/grill-with-docs` (see [CONTEXT-FORMAT.md](../grill-with-docs/CONTEXT-FORMAT.md)). Create the file lazily if it doesn't exist.
+- **Sharpening a fuzzy term during the conversation?** Update `CONTEXT.md` right there.
+- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer to avoid re-suggesting the same thing — skip ephemeral reasons ("not worth it right now") and self-evident ones. See [ADR-FORMAT.md](../grill-with-docs/ADR-FORMAT.md).
+- **Want to explore alternative interfaces for the deepened module?** See [INTERFACE-DESIGN.md](INTERFACE-DESIGN.md).
diff --git a/.kilocode/skills/prototype/LOGIC.md b/.kilocode/skills/prototype/LOGIC.md
new file mode 100644
index 0000000..526ecb1
--- /dev/null
+++ b/.kilocode/skills/prototype/LOGIC.md
@@ -0,0 +1,79 @@
+# Logic Prototype
+
+A tiny interactive terminal app that lets the user drive a state model by hand. Use this when the question is about **business logic, state transitions, or data shape** — the kind of thing that looks reasonable on paper but only feels wrong once you push it through real cases.
+
+## When this is the right shape
+
+- "I'm not sure if this state machine handles the edge case where X then Y."
+- "Does this data model actually let me represent the case where..."
+- "I want to feel out what the API should look like before writing it."
+- Anything where the user wants to **press buttons and watch state change**.
+
+If the question is "what should this look like" — wrong branch. Use [UI.md](UI.md).
+
+## Process
+
+### 1. State the question
+
+Before writing code, write down what state model and what question you're prototyping. One paragraph, in the prototype's README or a comment at the top of the file. A logic prototype that answers the wrong question is pure waste — make the question explicit so it can be checked later, whether the user is watching now or returning to it AFK.
+
+### 2. Pick the language
+
+Use whatever the host project uses. If the project has no obvious runtime (e.g. a docs repo), ask.
+
+Match the project's existing conventions for tooling — don't add a new package manager or runtime just for the prototype.
+
+### 3. Isolate the logic in a portable module
+
+Put the actual logic — the bit that's answering the question — behind a small, pure interface that could be lifted out and dropped into the real codebase later. The TUI around it is throwaway; the logic module shouldn't be.
+
+The right shape depends on the question:
+
+- **A pure reducer** — `(state, action) => state`. Good when actions are discrete events and state is a single value.
+- **A state machine** — explicit states and transitions. Good when "which actions are even legal right now" is part of the question.
+- **A small set of pure functions** over a plain data type. Good when there's no implicit current state — just transformations.
+- **A class or module with a clear method surface** when the logic genuinely owns ongoing internal state.
+
+Pick whichever shape best fits the question being asked, *not* whichever is easiest to wire to a TUI. Keep it pure: no I/O, no terminal code, no `console.log` for control flow. The TUI imports it and calls into it; nothing flows the other direction.
+
+This is what makes the prototype useful past its own lifetime. When the question's been answered, the validated reducer / machine / function set can be lifted into the real module — the TUI shell gets deleted.
+
+### 4. Build the smallest TUI that exposes the state
+
+Build it as a **lightweight TUI** — on every tick, clear the screen (`console.clear()` / `print("\033[2J\033[H")` / equivalent) and re-render the whole frame. The user should always see one stable view, not an ever-growing scrollback.
+
+Each frame has two parts, in this order:
+
+1. **Current state**, pretty-printed and diff-friendly (one field per line, or formatted JSON). Use **bold** for field names or section headers and **dim** for less important context (timestamps, IDs, derived values). Native ANSI escape codes are fine — `\x1b[1m` bold, `\x1b[2m` dim, `\x1b[0m` reset. No need to pull in a styling library unless one is already in the project.
+2. **Keyboard shortcuts**, listed at the bottom: `[a] add user  [d] delete user  [t] tick clock  [q] quit`. Bold the key, dim the description, or vice-versa — whatever reads cleanly.
+
+Behaviour:
+
+1. **Initialise state** — a single in-memory object/struct. Render the first frame on start.
+2. **Read one keystroke (or one line)** at a time, dispatch to a handler that mutates state.
+3. **Re-render** the full frame after every action — don't append, replace.
+4. **Loop until quit.**
+
+The whole frame should fit on one screen.
+
+### 5. Make it runnable in one command
+
+Add a script to the project's existing task runner (`package.json` scripts, `Makefile`, `justfile`, `pyproject.toml`). The user should run `pnpm run <prototype-name>` or equivalent — never need to remember a path.
+
+If the host project has no task runner, just put the command at the top of the prototype's README.
+
+### 6. Hand it over
+
+Give the user the run command. They'll drive it themselves; the interesting moments are when they say "wait, that shouldn't be possible" or "huh, I assumed X would be different" — those are the bugs in the _idea_, which is the whole point. If they want new actions added, add them. Prototypes evolve.
+
+### 7. Capture the answer
+
+When the prototype has done its job, the answer to the question is the only thing worth keeping. If the user is around, ask what it taught them. If not, leave a `NOTES.md` next to the prototype so the answer can be filled in (or filled in by you, if you've watched the session) before the prototype gets deleted.
+
+## Anti-patterns
+
+- **Don't add tests.** A prototype that needs tests is no longer a prototype.
+- **Don't wire it to the real database.** Use an in-memory store unless the question is specifically about persistence.
+- **Don't generalise.** No "what if we wanted to support X later." The prototype answers one question.
+- **Don't blur the logic and the TUI together.** If the reducer / state machine references `console.log`, prompts, or terminal escape codes, it's no longer portable. Keep the TUI as a thin shell over a pure module.
+- **Don't ship the TUI shell into production.** The shell is optimised for being driven by hand from a terminal. The logic module behind it is the bit worth keeping.
diff --git a/.kilocode/skills/prototype/SKILL.md b/.kilocode/skills/prototype/SKILL.md
new file mode 100644
index 0000000..64f3e61
--- /dev/null
+++ b/.kilocode/skills/prototype/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: prototype
+description: Build a throwaway prototype to flesh out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".
+---
+
+# Prototype
+
+A prototype is **throwaway code that answers a question**. The question decides the shape.
+
+## Pick a branch
+
+Identify which question is being answered — from the user's prompt, the surrounding code, or by asking if the user is around:
+
+- **"Does this logic / state model feel right?"** → [LOGIC.md](LOGIC.md). Build a tiny interactive terminal app that pushes the state machine through cases that are hard to reason about on paper.
+- **"What should this look like?"** → [UI.md](UI.md). Generate several radically different UI variations on a single route, switchable via a URL search param and a floating bottom bar.
+
+The two branches produce very different artifacts — getting this wrong wastes the whole prototype. If the question is genuinely ambiguous and the user isn't reachable, default to whichever branch better matches the surrounding code (a backend module → logic; a page or component → UI) and state the assumption at the top of the prototype.
+
+## Rules that apply to both
+
+1. **Throwaway from day one, and clearly marked as such.** Locate the prototype code close to where it will actually be used (next to the module or page it's prototyping for) so context is obvious — but name it so a casual reader can see it's a prototype, not production. For throwaway UI routes, obey whatever routing convention the project already uses; don't invent a new top-level structure.
+2. **One command to run.** Whatever the project's existing task runner supports — `pnpm <name>`, `python <path>`, `bun <path>`, etc. The user must be able to start it without thinking.
+3. **No persistence by default.** State lives in memory. Persistence is the thing the prototype is _checking_, not something it should depend on. If the question explicitly involves a database, hit a scratch DB or a local file with a clear "PROTOTYPE — wipe me" name.
+4. **Skip the polish.** No tests, no error handling beyond what makes the prototype _runnable_, no abstractions. The point is to learn something fast and then delete it.
+5. **Surface the state.** After every action (logic) or on every variant switch (UI), print or render the full relevant state so the user can see what changed.
+6. **Delete or absorb when done.** When the prototype has answered its question, either delete it or fold the validated decision into the real code — don't leave it rotting in the repo.
+
+## When done
+
+The _answer_ is the only thing worth keeping from a prototype. Capture it somewhere durable (commit message, ADR, issue, or a `NOTES.md` next to the prototype) along with the question it was answering. If the user is around, that capture is a quick conversation; if not, leave the placeholder so they (or you, on the next pass) can fill in the verdict before deleting the prototype.
diff --git a/.kilocode/skills/prototype/UI.md b/.kilocode/skills/prototype/UI.md
new file mode 100644
index 0000000..f3b6e64
--- /dev/null
+++ b/.kilocode/skills/prototype/UI.md
@@ -0,0 +1,112 @@
+# UI Prototype
+
+Generate **several radically different UI variations** on a single route, switchable from a floating bottom bar. The user flips between variants in the browser, picks one (or steals bits from each), then throws the rest away.
+
+If the question is about logic/state rather than what something looks like — wrong branch. Use [LOGIC.md](LOGIC.md).
+
+## When this is the right shape
+
+- "What should this page look like?"
+- "I want to see a few options for this dashboard before committing."
+- "Try a different layout for the settings screen."
+- Any time the user would otherwise spend a day picking between three vague mockups in their head.
+
+## Two sub-shapes — strongly prefer sub-shape A
+
+A UI prototype is much easier to judge when it's **butting up against the rest of the app** — real header, real sidebar, real data, real density. A throwaway route on its own is a vacuum: every variant looks fine in isolation. Default to sub-shape A whenever there's a plausible existing page to host the variants. Only reach for sub-shape B if the prototype genuinely has no nearby home.
+
+### Sub-shape A — adjustment to an existing page (preferred)
+
+The route already exists. Variants are rendered **on the same route**, gated by a `?variant=` URL search param. The existing data fetching, params, and auth all stay — only the rendering swaps. This is the default; pick it unless there's a specific reason not to.
+
+If the prototype is for something that doesn't yet have a page but *would naturally live inside one* (a new section of the dashboard, a new card on the settings screen, a new step in an existing flow) — that's still sub-shape A. Mount the variants inside the host page.
+
+### Sub-shape B — a new page (last resort)
+
+Only use this when the thing being prototyped genuinely has no existing page to live inside — e.g. an entirely new top-level surface, or a flow that can't be embedded anywhere sensible.
+
+Create a **throwaway route** following whatever routing convention the project already uses — don't invent a new top-level structure. Name it so it's obviously a prototype (e.g. include the word `prototype` in the path or filename). Same `?variant=` pattern.
+
+Before committing to sub-shape B, sanity-check: is there really no existing page this could be embedded in? An empty route hides design problems that a populated one would expose.
+
+In both sub-shapes the floating bottom bar is identical.
+
+## Process
+
+### 1. State the question and pick N
+
+Default to **3 variants**. More than 5 stops being radically different and starts being noise — cap there.
+
+Write down the plan in one line, in the prototype's location or a top-of-file comment:
+
+> "Three variants of the settings page, switchable via `?variant=`, on the existing `/settings` route."
+
+This works whether the user is here to push back or not.
+
+### 2. Generate radically different variants
+
+Draft each variant. Hold each one to:
+
+- The page's purpose and the data it has access to.
+- The project's component library / styling system (TailwindCSS, shadcn, MUI, plain CSS, whatever).
+- A clear exported component name, e.g. `VariantA`, `VariantB`, `VariantC`.
+
+Variants must be **structurally different** — different layout, different information hierarchy, different primary affordance, not just different colours. Three slightly-tweaked card grids isn't a UI prototype, it's wallpaper. If two drafts come out too similar, redo one with explicit "do not use a card grid" guidance.
+
+### 3. Wire them together
+
+Create a single switcher component on the route:
+
+```tsx
+// pseudo-code — adapt to the project's framework
+const variant = searchParams.get('variant') ?? 'A';
+return (
+  <>
+    {variant === 'A' && <VariantA {...data} />}
+    {variant === 'B' && <VariantB {...data} />}
+    {variant === 'C' && <VariantC {...data} />}
+    <PrototypeSwitcher variants={['A','B','C']} current={variant} />
+  </>
+);
+```
+
+For sub-shape A (existing page): keep all the existing data fetching above the switcher; only the rendered subtree changes per variant.
+
+For sub-shape B (new page): the throwaway route under `/prototype/<name>` mounts the same switcher.
+
+### 4. Build the floating switcher
+
+A small fixed-position bar at the bottom-centre of the screen with three pieces:
+
+- **Left arrow** — cycles to the previous variant (wraps around).
+- **Variant label** — shows the current variant key and, if the variant exports a name, that name too. e.g. `B — Sidebar layout`.
+- **Right arrow** — cycles forward (wraps around).
+
+Behaviour:
+
+- Clicking an arrow updates the URL search param (use the framework's router — `router.replace` on Next, `navigate` on React Router, etc) so the variant is shareable and reload-stable.
+- Keyboard: `←` and `→` arrow keys also cycle. Don't intercept arrow keys when an `<input>`, `<textarea>`, or `[contenteditable]` is focused.
+- Visually distinct from the page (e.g. high-contrast pill, subtle shadow) so it's obviously not part of the design being evaluated.
+- Hidden in production builds — gate on `process.env.NODE_ENV !== 'production'` or an equivalent check, so a stray prototype merge can't ship the bar to users.
+
+Put the switcher in a single shared component so both sub-shapes can reuse it. Locate it wherever shared UI lives in the project.
+
+### 5. Hand it over
+
+Surface the URL (and the `?variant=` keys). The user will flip through whenever they get to it. The interesting feedback is usually **"I want the header from B with the sidebar from C"** — that's the actual design they want.
+
+### 6. Capture the answer and clean up
+
+Once a variant has won, write down which one and why (commit message, ADR, issue, or a `NOTES.md` next to the prototype if running AFK and the user hasn't responded yet). Then:
+
+- **Sub-shape A** — delete the losing variants and the switcher; fold the winner into the existing page.
+- **Sub-shape B** — promote the winning variant to a real route, delete the throwaway route and the switcher.
+
+Don't leave variant components or the switcher lying around. They rot fast and confuse the next reader.
+
+## Anti-patterns
+
+- **Variants that differ only in colour or copy.** That's a tweak, not a prototype. Real variants disagree about structure.
+- **Sharing too much code between variants.** A shared `<Header>` is fine; a shared `<Layout>` defeats the point. Each variant should be free to throw out the layout.
+- **Wiring variants to real mutations.** Read-only prototypes are fine. If a variant needs to mutate, point it at a stub — the question is "what should this look like", not "does the backend work".
+- **Promoting the prototype directly to production.** The variant code was written under prototype constraints (no tests, minimal error handling). Rewrite it properly when you fold it in.
diff --git a/.kilocode/skills/setup-matt-pocock-skills/SKILL.md b/.kilocode/skills/setup-matt-pocock-skills/SKILL.md
new file mode 100644
index 0000000..1ebc6e1
--- /dev/null
+++ b/.kilocode/skills/setup-matt-pocock-skills/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: setup-matt-pocock-skills
+description: Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
+disable-model-invocation: true
+---
+
+# Setup Matt Pocock's Skills
+
+Scaffold the per-repo configuration that the engineering skills assume:
+
+- **Issue tracker** — where issues live (GitHub by default; local markdown is also supported out of the box)
+- **Triage labels** — the strings used for the five canonical triage roles
+- **Domain docs** — where `CONTEXT.md` and ADRs live, and the consumer rules for reading them
+
+This is a prompt-driven skill, not a deterministic script. Explore, present what you found, confirm with the user, then write.
+
+## Process
+
+### 1. Explore
+
+Look at the current repo to understand its starting state. Read whatever exists; don't assume:
+
+- `git remote -v` and `.git/config` — is this a GitHub repo? Which one?
+- `AGENTS.md` and `CLAUDE.md` at the repo root — does either exist? Is there already an `## Agent skills` section in either?
+- `CONTEXT.md` and `CONTEXT-MAP.md` at the repo root
+- `docs/adr/` and any `src/*/docs/adr/` directories
+- `docs/agents/` — does this skill's prior output already exist?
+- `.scratch/` — sign that a local-markdown issue tracker convention is already in use
+
+### 2. Present findings and ask
+
+Summarise what's present and what's missing. Then walk the user through the three decisions **one at a time** — present a section, get the user's answer, then move to the next. Don't dump all three at once.
+
+Assume the user does not know what these terms mean. Each section starts with a short explainer (what it is, why these skills need it, what changes if they pick differently). Then show the choices and the default.
+
+**Section A — Issue tracker.**
+
+> Explainer: The "issue tracker" is where issues live for this repo. Skills like `to-issues`, `triage`, `to-prd`, and `qa` read from and write to it — they need to know whether to call `gh issue create`, write a markdown file under `.scratch/`, or follow some other workflow you describe. Pick the place you actually track work for this repo.
+
+Default posture: these skills were designed for GitHub. If a `git remote` points at GitHub, propose that. If a `git remote` points at GitLab (`gitlab.com` or a self-hosted host), propose GitLab. Otherwise (or if the user prefers), offer:
+
+- **GitHub** — issues live in the repo's GitHub Issues (uses the `gh` CLI)
+- **GitLab** — issues live in the repo's GitLab Issues (uses the [`glab`](https://gitlab.com/gitlab-org/cli) CLI)
+- **Local markdown** — issues live as files under `.scratch/<feature>/` in this repo (good for solo projects or repos without a remote)
+- **Other** (Jira, Linear, etc.) — ask the user to describe the workflow in one paragraph; the skill will record it as freeform prose
+
+**Section B — Triage label vocabulary.**
+
+> Explainer: When the `triage` skill processes an incoming issue, it moves it through a state machine — needs evaluation, waiting on reporter, ready for an AFK agent to pick up, ready for a human, or won't fix. To do that, it needs to apply labels (or the equivalent in your issue tracker) that match strings *you've actually configured*. If your repo already uses different label names (e.g. `bug:triage` instead of `needs-triage`), map them here so the skill applies the right ones instead of creating duplicates.
+
+The five canonical roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter
+- `ready-for-agent` — fully specified, AFK-ready (an agent can pick it up with no human context)
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Default: each role's string equals its name. Ask the user if they want to override any. If their issue tracker has no existing labels, the defaults are fine.
+
+**Section C — Domain docs.**
+
+> Explainer: Some skills (`improve-codebase-architecture`, `diagnose`, `tdd`) read a `CONTEXT.md` file to learn the project's domain language, and `docs/adr/` for past architectural decisions. They need to know whether the repo has one global context or multiple (e.g. a monorepo with separate frontend/backend contexts) so they look in the right place.
+
+Confirm the layout:
+
+- **Single-context** — one `CONTEXT.md` + `docs/adr/` at the repo root. Most repos are this.
+- **Multi-context** — `CONTEXT-MAP.md` at the root pointing to per-context `CONTEXT.md` files (typically a monorepo).
+
+### 3. Confirm and edit
+
+Show the user a draft of:
+
+- The `## Agent skills` block to add to whichever of `CLAUDE.md` / `AGENTS.md` is being edited (see step 4 for selection rules)
+- The contents of `docs/agents/issue-tracker.md`, `docs/agents/triage-labels.md`, `docs/agents/domain.md`
+
+Let them edit before writing.
+
+### 4. Write
+
+**Pick the file to edit:**
+
+- If `CLAUDE.md` exists, edit it.
+- Else if `AGENTS.md` exists, edit it.
+- If neither exists, ask the user which one to create — don't pick for them.
+
+Never create `AGENTS.md` when `CLAUDE.md` already exists (or vice versa) — always edit the one that's already there.
+
+If an `## Agent skills` block already exists in the chosen file, update its contents in-place rather than appending a duplicate. Don't overwrite user edits to the surrounding sections.
+
+The block:
+
+```markdown
+## Agent skills
+
+### Issue tracker
+
+[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
+```
+
+Then write the three docs files using the seed templates in this skill folder as a starting point:
+
+- [issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker
+- [issue-tracker-gitlab.md](./issue-tracker-gitlab.md) — GitLab issue tracker
+- [issue-tracker-local.md](./issue-tracker-local.md) — local-markdown issue tracker
+- [triage-labels.md](./triage-labels.md) — label mapping
+- [domain.md](./domain.md) — domain doc consumer rules + layout
+
+For "other" issue trackers, write `docs/agents/issue-tracker.md` from scratch using the user's description.
+
+### 5. Done
+
+Tell the user the setup is complete and which engineering skills will now read from these files. Mention they can edit `docs/agents/*.md` directly later — re-running this skill is only necessary if they want to switch issue trackers or restart from scratch.
diff --git a/.kilocode/skills/setup-matt-pocock-skills/domain.md b/.kilocode/skills/setup-matt-pocock-skills/domain.md
new file mode 100644
index 0000000..c97d6a6
--- /dev/null
+++ b/.kilocode/skills/setup-matt-pocock-skills/domain.md
@@ -0,0 +1,51 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT.md`** at the repo root, or
+- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The producer skill (`/grill-with-docs`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo (most repos):
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-event-sourced-orders.md
+│   └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/adr/                          ← system-wide decisions
+└── src/
+    ├── ordering/
+    │   ├── CONTEXT.md
+    │   └── docs/adr/                  ← context-specific decisions
+    └── billing/
+        ├── CONTEXT.md
+        └── docs/adr/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/grill-with-docs`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_
diff --git a/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-github.md b/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-github.md
new file mode 100644
index 0000000..cce77ec
--- /dev/null
+++ b/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-github.md
@@ -0,0 +1,22 @@
+# Issue tracker: GitHub
+
+Issues and PRDs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
+
+Infer the repo from `git remote -v` — `gh` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitHub issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `gh issue view <number> --comments`.
diff --git a/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md b/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
new file mode 100644
index 0000000..f54da95
--- /dev/null
+++ b/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
@@ -0,0 +1,23 @@
+# Issue tracker: GitLab
+
+Issues and PRDs for this repo live as GitLab issues. Use the [`glab`](https://gitlab.com/gitlab-org/cli) CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `glab issue create --title "..." --description "..."`. Use a heredoc for multi-line descriptions. Pass `--description -` to open an editor.
+- **Read an issue**: `glab issue view <number> --comments`. Use `-F json` for machine-readable output.
+- **List issues**: `glab issue list -F json` with appropriate `--label` filters.
+- **Comment on an issue**: `glab issue note <number> --message "..."`. GitLab calls comments "notes".
+- **Apply / remove labels**: `glab issue update <number> --label "..."` / `--unlabel "..."`. Multiple labels can be comma-separated or by repeating the flag.
+- **Close**: `glab issue close <number>`. `glab issue close` does not accept a closing comment, so post the explanation first with `glab issue note <number> --message "..."`, then close.
+- **Merge requests**: GitLab calls PRs "merge requests". Use `glab mr create`, `glab mr view`, `glab mr note`, etc. — the same shape as `gh pr ...` with `mr` in place of `pr` and `note`/`--message` in place of `comment`/`--body`.
+
+Infer the repo from `git remote -v` — `glab` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitLab issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `glab issue view <number> --comments`.
diff --git a/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-local.md b/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-local.md
new file mode 100644
index 0000000..a2f08fb
--- /dev/null
+++ b/.kilocode/skills/setup-matt-pocock-skills/issue-tracker-local.md
@@ -0,0 +1,19 @@
+# Issue tracker: Local Markdown
+
+Issues and PRDs for this repo live as markdown files in `.scratch/`.
+
+## Conventions
+
+- One feature per directory: `.scratch/<feature-slug>/`
+- The PRD is `.scratch/<feature-slug>/PRD.md`
+- Implementation issues are `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01`
+- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
+- Comments and conversation history append to the bottom of the file under a `## Comments` heading
+
+## When a skill says "publish to the issue tracker"
+
+Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).
+
+## When a skill says "fetch the relevant ticket"
+
+Read the file at the referenced path. The user will normally pass the path or the issue number directly.
diff --git a/.kilocode/skills/setup-matt-pocock-skills/triage-labels.md b/.kilocode/skills/setup-matt-pocock-skills/triage-labels.md
new file mode 100644
index 0000000..b716855
--- /dev/null
+++ b/.kilocode/skills/setup-matt-pocock-skills/triage-labels.md
@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.
diff --git a/.kilocode/skills/tdd/SKILL.md b/.kilocode/skills/tdd/SKILL.md
new file mode 100644
index 0000000..7a98941
--- /dev/null
+++ b/.kilocode/skills/tdd/SKILL.md
@@ -0,0 +1,109 @@
+---
+name: tdd
+description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
+---
+
+# Test-Driven Development
+
+## Philosophy
+
+**Core principle**: Tests should verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't.
+
+**Good tests** are integration-style: they exercise real code paths through public APIs. They describe _what_ the system does, not _how_ it does it. A good test reads like a specification - "user can checkout with valid cart" tells you exactly what capability exists. These tests survive refactors because they don't care about internal structure.
+
+**Bad tests** are coupled to implementation. They mock internal collaborators, test private methods, or verify through external means (like querying a database directly instead of using the interface). The warning sign: your test breaks when you refactor, but behavior hasn't changed. If you rename an internal function and tests fail, those tests were testing implementation, not behavior.
+
+See [tests.md](tests.md) for examples and [mocking.md](mocking.md) for mocking guidelines.
+
+## Anti-Pattern: Horizontal Slices
+
+**DO NOT write all tests first, then all implementation.** This is "horizontal slicing" - treating RED as "write all tests" and GREEN as "write all code."
+
+This produces **crap tests**:
+
+- Tests written in bulk test _imagined_ behavior, not _actual_ behavior
+- You end up testing the _shape_ of things (data structures, function signatures) rather than user-facing behavior
+- Tests become insensitive to real changes - they pass when behavior breaks, fail when behavior is fine
+- You outrun your headlights, committing to test structure before understanding the implementation
+
+**Correct approach**: Vertical slices via tracer bullets. One test → one implementation → repeat. Each test responds to what you learned from the previous cycle. Because you just wrote the code, you know exactly what behavior matters and how to verify it.
+
+```
+WRONG (horizontal):
+  RED:   test1, test2, test3, test4, test5
+  GREEN: impl1, impl2, impl3, impl4, impl5
+
+RIGHT (vertical):
+  RED→GREEN: test1→impl1
+  RED→GREEN: test2→impl2
+  RED→GREEN: test3→impl3
+  ...
+```
+
+## Workflow
+
+### 1. Planning
+
+When exploring the codebase, use the project's domain glossary so that test names and interface vocabulary match the project's language, and respect ADRs in the area you're touching.
+
+Before writing any code:
+
+- [ ] Confirm with user what interface changes are needed
+- [ ] Confirm with user which behaviors to test (prioritize)
+- [ ] Identify opportunities for [deep modules](deep-modules.md) (small interface, deep implementation)
+- [ ] Design interfaces for [testability](interface-design.md)
+- [ ] List the behaviors to test (not implementation steps)
+- [ ] Get user approval on the plan
+
+Ask: "What should the public interface look like? Which behaviors are most important to test?"
+
+**You can't test everything.** Confirm with the user exactly which behaviors matter most. Focus testing effort on critical paths and complex logic, not every possible edge case.
+
+### 2. Tracer Bullet
+
+Write ONE test that confirms ONE thing about the system:
+
+```
+RED:   Write test for first behavior → test fails
+GREEN: Write minimal code to pass → test passes
+```
+
+This is your tracer bullet - proves the path works end-to-end.
+
+### 3. Incremental Loop
+
+For each remaining behavior:
+
+```
+RED:   Write next test → fails
+GREEN: Minimal code to pass → passes
+```
+
+Rules:
+
+- One test at a time
+- Only enough code to pass current test
+- Don't anticipate future tests
+- Keep tests focused on observable behavior
+
+### 4. Refactor
+
+After all tests pass, look for [refactor candidates](refactoring.md):
+
+- [ ] Extract duplication
+- [ ] Deepen modules (move complexity behind simple interfaces)
+- [ ] Apply SOLID principles where natural
+- [ ] Consider what new code reveals about existing code
+- [ ] Run tests after each refactor step
+
+**Never refactor while RED.** Get to GREEN first.
+
+## Checklist Per Cycle
+
+```
+[ ] Test describes behavior, not implementation
+[ ] Test uses public interface only
+[ ] Test would survive internal refactor
+[ ] Code is minimal for this test
+[ ] No speculative features added
+```
diff --git a/.kilocode/skills/tdd/deep-modules.md b/.kilocode/skills/tdd/deep-modules.md
new file mode 100644
index 0000000..0d9720c
--- /dev/null
+++ b/.kilocode/skills/tdd/deep-modules.md
@@ -0,0 +1,33 @@
+# Deep Modules
+
+From "A Philosophy of Software Design":
+
+**Deep module** = small interface + lots of implementation
+
+```
+┌─────────────────────┐
+│   Small Interface   │  ← Few methods, simple params
+├─────────────────────┤
+│                     │
+│                     │
+│  Deep Implementation│  ← Complex logic hidden
+│                     │
+│                     │
+└─────────────────────┘
+```
+
+**Shallow module** = large interface + little implementation (avoid)
+
+```
+┌─────────────────────────────────┐
+│       Large Interface           │  ← Many methods, complex params
+├─────────────────────────────────┤
+│  Thin Implementation            │  ← Just passes through
+└─────────────────────────────────┘
+```
+
+When designing interfaces, ask:
+
+- Can I reduce the number of methods?
+- Can I simplify the parameters?
+- Can I hide more complexity inside?
diff --git a/.kilocode/skills/tdd/interface-design.md b/.kilocode/skills/tdd/interface-design.md
new file mode 100644
index 0000000..a0a20ca
--- /dev/null
+++ b/.kilocode/skills/tdd/interface-design.md
@@ -0,0 +1,31 @@
+# Interface Design for Testability
+
+Good interfaces make testing natural:
+
+1. **Accept dependencies, don't create them**
+
+   ```typescript
+   // Testable
+   function processOrder(order, paymentGateway) {}
+
+   // Hard to test
+   function processOrder(order) {
+     const gateway = new StripeGateway();
+   }
+   ```
+
+2. **Return results, don't produce side effects**
+
+   ```typescript
+   // Testable
+   function calculateDiscount(cart): Discount {}
+
+   // Hard to test
+   function applyDiscount(cart): void {
+     cart.total -= discount;
+   }
+   ```
+
+3. **Small surface area**
+   - Fewer methods = fewer tests needed
+   - Fewer params = simpler test setup
diff --git a/.kilocode/skills/tdd/mocking.md b/.kilocode/skills/tdd/mocking.md
new file mode 100644
index 0000000..71cbfee
--- /dev/null
+++ b/.kilocode/skills/tdd/mocking.md
@@ -0,0 +1,59 @@
+# When to Mock
+
+Mock at **system boundaries** only:
+
+- External APIs (payment, email, etc.)
+- Databases (sometimes - prefer test DB)
+- Time/randomness
+- File system (sometimes)
+
+Don't mock:
+
+- Your own classes/modules
+- Internal collaborators
+- Anything you control
+
+## Designing for Mockability
+
+At system boundaries, design interfaces that are easy to mock:
+
+**1. Use dependency injection**
+
+Pass external dependencies in rather than creating them internally:
+
+```typescript
+// Easy to mock
+function processPayment(order, paymentClient) {
+  return paymentClient.charge(order.total);
+}
+
+// Hard to mock
+function processPayment(order) {
+  const client = new StripeClient(process.env.STRIPE_KEY);
+  return client.charge(order.total);
+}
+```
+
+**2. Prefer SDK-style interfaces over generic fetchers**
+
+Create specific functions for each external operation instead of one generic function with conditional logic:
+
+```typescript
+// GOOD: Each function is independently mockable
+const api = {
+  getUser: (id) => fetch(`/users/${id}`),
+  getOrders: (userId) => fetch(`/users/${userId}/orders`),
+  createOrder: (data) => fetch('/orders', { method: 'POST', body: data }),
+};
+
+// BAD: Mocking requires conditional logic inside the mock
+const api = {
+  fetch: (endpoint, options) => fetch(endpoint, options),
+};
+```
+
+The SDK approach means:
+- Each mock returns one specific shape
+- No conditional logic in test setup
+- Easier to see which endpoints a test exercises
+- Type safety per endpoint
diff --git a/.kilocode/skills/tdd/refactoring.md b/.kilocode/skills/tdd/refactoring.md
new file mode 100644
index 0000000..8a44439
--- /dev/null
+++ b/.kilocode/skills/tdd/refactoring.md
@@ -0,0 +1,10 @@
+# Refactor Candidates
+
+After TDD cycle, look for:
+
+- **Duplication** → Extract function/class
+- **Long methods** → Break into private helpers (keep tests on public interface)
+- **Shallow modules** → Combine or deepen
+- **Feature envy** → Move logic to where data lives
+- **Primitive obsession** → Introduce value objects
+- **Existing code** the new code reveals as problematic
diff --git a/.kilocode/skills/tdd/tests.md b/.kilocode/skills/tdd/tests.md
new file mode 100644
index 0000000..ff22f80
--- /dev/null
+++ b/.kilocode/skills/tdd/tests.md
@@ -0,0 +1,61 @@
+# Good and Bad Tests
+
+## Good Tests
+
+**Integration-style**: Test through real interfaces, not mocks of internal parts.
+
+```typescript
+// GOOD: Tests observable behavior
+test("user can checkout with valid cart", async () => {
+  const cart = createCart();
+  cart.add(product);
+  const result = await checkout(cart, paymentMethod);
+  expect(result.status).toBe("confirmed");
+});
+```
+
+Characteristics:
+
+- Tests behavior users/callers care about
+- Uses public API only
+- Survives internal refactors
+- Describes WHAT, not HOW
+- One logical assertion per test
+
+## Bad Tests
+
+**Implementation-detail tests**: Coupled to internal structure.
+
+```typescript
+// BAD: Tests implementation details
+test("checkout calls paymentService.process", async () => {
+  const mockPayment = jest.mock(paymentService);
+  await checkout(cart, payment);
+  expect(mockPayment.process).toHaveBeenCalledWith(cart.total);
+});
+```
+
+Red flags:
+
+- Mocking internal collaborators
+- Testing private methods
+- Asserting on call counts/order
+- Test breaks when refactoring without behavior change
+- Test name describes HOW not WHAT
+- Verifying through external means instead of interface
+
+```typescript
+// BAD: Bypasses interface to verify
+test("createUser saves to database", async () => {
+  await createUser({ name: "Alice" });
+  const row = await db.query("SELECT * FROM users WHERE name = ?", ["Alice"]);
+  expect(row).toBeDefined();
+});
+
+// GOOD: Verifies through interface
+test("createUser makes user retrievable", async () => {
+  const user = await createUser({ name: "Alice" });
+  const retrieved = await getUser(user.id);
+  expect(retrieved.name).toBe("Alice");
+});
+```
diff --git a/.kilocode/skills/to-issues/SKILL.md b/.kilocode/skills/to-issues/SKILL.md
new file mode 100644
index 0000000..9f6efbf
--- /dev/null
+++ b/.kilocode/skills/to-issues/SKILL.md
@@ -0,0 +1,83 @@
+---
+name: to-issues
+description: Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
+---
+
+# To Issues
+
+Break a plan into independently-grabbable issues using vertical slices (tracer bullets).
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+### 1. Gather context
+
+Work from whatever is already in the conversation context. If the user passes an issue reference (issue number, URL, or path) as an argument, fetch it from the issue tracker and read its full body and comments.
+
+### 2. Explore the codebase (optional)
+
+If you have not already explored the codebase, do so to understand the current state of the code. Issue titles and descriptions should use the project's domain glossary vocabulary, and respect ADRs in the area you're touching.
+
+### 3. Draft vertical slices
+
+Break the plan into **tracer bullet** issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer.
+
+Slices may be 'HITL' or 'AFK'. HITL slices require human interaction, such as an architectural decision or a design review. AFK slices can be implemented and merged without human interaction. Prefer AFK over HITL where possible.
+
+<vertical-slice-rules>
+- Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests)
+- A completed slice is demoable or verifiable on its own
+- Prefer many thin slices over few thick ones
+</vertical-slice-rules>
+
+### 4. Quiz the user
+
+Present the proposed breakdown as a numbered list. For each slice, show:
+
+- **Title**: short descriptive name
+- **Type**: HITL / AFK
+- **Blocked by**: which other slices (if any) must complete first
+- **User stories covered**: which user stories this addresses (if the source material has them)
+
+Ask the user:
+
+- Does the granularity feel right? (too coarse / too fine)
+- Are the dependency relationships correct?
+- Should any slices be merged or split further?
+- Are the correct slices marked as HITL and AFK?
+
+Iterate until the user approves the breakdown.
+
+### 5. Publish the issues to the issue tracker
+
+For each approved slice, publish a new issue to the issue tracker. Use the issue body template below. These issues are considered ready for AFK agents, so publish them with the correct triage label unless instructed otherwise.
+
+Publish issues in dependency order (blockers first) so you can reference real issue identifiers in the "Blocked by" field.
+
+<issue-template>
+## Parent
+
+A reference to the parent issue on the issue tracker (if the source was an existing issue, otherwise omit this section).
+
+## What to build
+
+A concise description of this vertical slice. Describe the end-to-end behavior, not layer-by-layer implementation.
+
+Avoid specific file paths or code snippets — they go stale fast. Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it here and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Acceptance criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Blocked by
+
+- A reference to the blocking ticket (if any)
+
+Or "None - can start immediately" if no blockers.
+
+</issue-template>
+
+Do NOT close or modify any parent issue.
diff --git a/.kilocode/skills/to-prd/SKILL.md b/.kilocode/skills/to-prd/SKILL.md
new file mode 100644
index 0000000..47a01d4
--- /dev/null
+++ b/.kilocode/skills/to-prd/SKILL.md
@@ -0,0 +1,76 @@
+---
+name: to-prd
+description: Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
+---
+
+This skill takes the current conversation context and codebase understanding and produces a PRD. Do NOT interview the user — just synthesize what you already know.
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+1. Explore the repo to understand the current state of the codebase, if you haven't already. Use the project's domain glossary vocabulary throughout the PRD, and respect any ADRs in the area you're touching.
+
+2. Sketch out the major modules you will need to build or modify to complete the implementation. Actively look for opportunities to extract deep modules that can be tested in isolation.
+
+A deep module (as opposed to a shallow module) is one which encapsulates a lot of functionality in a simple, testable interface which rarely changes.
+
+Check with the user that these modules match their expectations. Check with the user which modules they want tests written for.
+
+3. Write the PRD using the template below, then publish it to the project issue tracker. Apply the `ready-for-agent` triage label - no need for additional triage.
+
+<prd-template>
+
+## Problem Statement
+
+The problem that the user is facing, from the user's perspective.
+
+## Solution
+
+The solution to the problem, from the user's perspective.
+
+## User Stories
+
+A LONG, numbered list of user stories. Each user story should be in the format of:
+
+1. As an <actor>, I want a <feature>, so that <benefit>
+
+<user-story-example>
+1. As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending
+</user-story-example>
+
+This list of user stories should be extremely extensive and cover all aspects of the feature.
+
+## Implementation Decisions
+
+A list of implementation decisions that were made. This can include:
+
+- The modules that will be built/modified
+- The interfaces of those modules that will be modified
+- Technical clarifications from the developer
+- Architectural decisions
+- Schema changes
+- API contracts
+- Specific interactions
+
+Do NOT include specific file paths or code snippets. They may end up being outdated very quickly.
+
+Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it within the relevant decision and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Testing Decisions
+
+A list of testing decisions that were made. Include:
+
+- A description of what makes a good test (only test external behavior, not implementation details)
+- Which modules will be tested
+- Prior art for the tests (i.e. similar types of tests in the codebase)
+
+## Out of Scope
+
+A description of the things that are out of scope for this PRD.
+
+## Further Notes
+
+Any further notes about the feature.
+
+</prd-template>
diff --git a/.kilocode/skills/triage/AGENT-BRIEF.md b/.kilocode/skills/triage/AGENT-BRIEF.md
new file mode 100644
index 0000000..2efecdf
--- /dev/null
+++ b/.kilocode/skills/triage/AGENT-BRIEF.md
@@ -0,0 +1,168 @@
+# Writing Agent Briefs
+
+An agent brief is a structured comment posted on a GitHub issue when it moves to `ready-for-agent`. It is the authoritative specification that an AFK agent will work from. The original issue body and discussion are context — the agent brief is the contract.
+
+## Principles
+
+### Durability over precision
+
+The issue may sit in `ready-for-agent` for days or weeks. The codebase will change in the meantime. Write the brief so it stays useful even as files are renamed, moved, or refactored.
+
+- **Do** describe interfaces, types, and behavioral contracts
+- **Do** name specific types, function signatures, or config shapes that the agent should look for or modify
+- **Don't** reference file paths — they go stale
+- **Don't** reference line numbers
+- **Don't** assume the current implementation structure will remain the same
+
+### Behavioral, not procedural
+
+Describe **what** the system should do, not **how** to implement it. The agent will explore the codebase fresh and make its own implementation decisions.
+
+- **Good:** "The `SkillConfig` type should accept an optional `schedule` field of type `CronExpression`"
+- **Bad:** "Open src/types/skill.ts and add a schedule field on line 42"
+- **Good:** "When a user runs `/triage` with no arguments, they should see a summary of issues needing attention"
+- **Bad:** "Add a switch statement in the main handler function"
+
+### Complete acceptance criteria
+
+The agent needs to know when it's done. Every agent brief must have concrete, testable acceptance criteria. Each criterion should be independently verifiable.
+
+- **Good:** "Running `gh issue list --label needs-triage` returns issues that have been through initial classification"
+- **Bad:** "Triage should work correctly"
+
+### Explicit scope boundaries
+
+State what is out of scope. This prevents the agent from gold-plating or making assumptions about adjacent features.
+
+## Template
+
+```markdown
+## Agent Brief
+
+**Category:** bug / enhancement
+**Summary:** one-line description of what needs to happen
+
+**Current behavior:**
+Describe what happens now. For bugs, this is the broken behavior.
+For enhancements, this is the status quo the feature builds on.
+
+**Desired behavior:**
+Describe what should happen after the agent's work is complete.
+Be specific about edge cases and error conditions.
+
+**Key interfaces:**
+- `TypeName` — what needs to change and why
+- `functionName()` return type — what it currently returns vs what it should return
+- Config shape — any new configuration options needed
+
+**Acceptance criteria:**
+- [ ] Specific, testable criterion 1
+- [ ] Specific, testable criterion 2
+- [ ] Specific, testable criterion 3
+
+**Out of scope:**
+- Thing that should NOT be changed or addressed in this issue
+- Adjacent feature that might seem related but is separate
+```
+
+## Examples
+
+### Good agent brief (bug)
+
+```markdown
+## Agent Brief
+
+**Category:** bug
+**Summary:** Skill description truncation drops mid-word, producing broken output
+
+**Current behavior:**
+When a skill description exceeds 1024 characters, it is truncated at exactly
+1024 characters regardless of word boundaries. This produces descriptions
+that end mid-word (e.g. "Use when the user wants to confi").
+
+**Desired behavior:**
+Truncation should break at the last word boundary before 1024 characters
+and append "..." to indicate truncation.
+
+**Key interfaces:**
+- The `SkillMetadata` type's `description` field — no type change needed,
+  but the validation/processing logic that populates it needs to respect
+  word boundaries
+- Any function that reads SKILL.md frontmatter and extracts the description
+
+**Acceptance criteria:**
+- [ ] Descriptions under 1024 chars are unchanged
+- [ ] Descriptions over 1024 chars are truncated at the last word boundary
+      before 1024 chars
+- [ ] Truncated descriptions end with "..."
+- [ ] The total length including "..." does not exceed 1024 chars
+
+**Out of scope:**
+- Changing the 1024 char limit itself
+- Multi-line description support
+```
+
+### Good agent brief (enhancement)
+
+```markdown
+## Agent Brief
+
+**Category:** enhancement
+**Summary:** Add `.out-of-scope/` directory support for tracking rejected feature requests
+
+**Current behavior:**
+When a feature request is rejected, the issue is closed with a `wontfix` label
+and a comment. There is no persistent record of the decision or reasoning.
+Future similar requests require the maintainer to recall or search for the
+prior discussion.
+
+**Desired behavior:**
+Rejected feature requests should be documented in `.out-of-scope/<concept>.md`
+files that capture the decision, reasoning, and links to all issues that
+requested the feature. When triaging new issues, these files should be
+checked for matches.
+
+**Key interfaces:**
+- Markdown file format in `.out-of-scope/` — each file should have a
+  `# Concept Name` heading, a `**Decision:**` line, a `**Reason:**` line,
+  and a `**Prior requests:**` list with issue links
+- The triage workflow should read all `.out-of-scope/*.md` files early
+  and match incoming issues against them by concept similarity
+
+**Acceptance criteria:**
+- [ ] Closing a feature as wontfix creates/updates a file in `.out-of-scope/`
+- [ ] The file includes the decision, reasoning, and link to the closed issue
+- [ ] If a matching `.out-of-scope/` file already exists, the new issue is
+      appended to its "Prior requests" list rather than creating a duplicate
+- [ ] During triage, existing `.out-of-scope/` files are checked and surfaced
+      when a new issue matches a prior rejection
+
+**Out of scope:**
+- Automated matching (human confirms the match)
+- Reopening previously rejected features
+- Bug reports (only enhancement rejections go to `.out-of-scope/`)
+```
+
+### Bad agent brief
+
+```markdown
+## Agent Brief
+
+**Summary:** Fix the triage bug
+
+**What to do:**
+The triage thing is broken. Look at the main file and fix it.
+The function around line 150 has the issue.
+
+**Files to change:**
+- src/triage/handler.ts (line 150)
+- src/types.ts (line 42)
+```
+
+This is bad because:
+- No category
+- Vague description ("the triage thing is broken")
+- References file paths and line numbers that will go stale
+- No acceptance criteria
+- No scope boundaries
+- No description of current vs desired behavior
diff --git a/.kilocode/skills/triage/OUT-OF-SCOPE.md b/.kilocode/skills/triage/OUT-OF-SCOPE.md
new file mode 100644
index 0000000..cc8ea25
--- /dev/null
+++ b/.kilocode/skills/triage/OUT-OF-SCOPE.md
@@ -0,0 +1,101 @@
+# Out-of-Scope Knowledge Base
+
+The `.out-of-scope/` directory in a repo stores persistent records of rejected feature requests. It serves two purposes:
+
+1. **Institutional memory** — why a feature was rejected, so the reasoning isn't lost when the issue is closed
+2. **Deduplication** — when a new issue comes in that matches a prior rejection, the skill can surface the previous decision instead of re-litigating it
+
+## Directory structure
+
+```
+.out-of-scope/
+├── dark-mode.md
+├── plugin-system.md
+└── graphql-api.md
+```
+
+One file per **concept**, not per issue. Multiple issues requesting the same thing are grouped under one file.
+
+## File format
+
+The file should be written in a relaxed, readable style — more like a short design document than a database entry. Use paragraphs, code samples, and examples to make the reasoning clear and useful to someone encountering it for the first time.
+
+```markdown
+# Dark Mode
+
+This project does not support dark mode or user-facing theming.
+
+## Why this is out of scope
+
+The rendering pipeline assumes a single color palette defined in
+`ThemeConfig`. Supporting multiple themes would require:
+
+- A theme context provider wrapping the entire component tree
+- Per-component theme-aware style resolution
+- A persistence layer for user theme preferences
+
+This is a significant architectural change that doesn't align with the
+project's focus on content authoring. Theming is a concern for downstream
+consumers who embed or redistribute the output.
+
+```ts
+// The current ThemeConfig interface is not designed for runtime switching:
+interface ThemeConfig {
+  colors: ColorPalette; // single palette, resolved at build time
+  fonts: FontStack;
+}
+```
+
+## Prior requests
+
+- #42 — "Add dark mode support"
+- #87 — "Night theme for accessibility"
+- #134 — "Dark theme option"
+```
+
+### Naming the file
+
+Use a short, descriptive kebab-case name for the concept: `dark-mode.md`, `plugin-system.md`, `graphql-api.md`. The name should be recognizable enough that someone browsing the directory understands what was rejected without opening the file.
+
+### Writing the reason
+
+The reason should be substantive — not "we don't want this" but why. Good reasons reference:
+
+- Project scope or philosophy ("This project focuses on X; theming is a downstream concern")
+- Technical constraints ("Supporting this would require Y, which conflicts with our Z architecture")
+- Strategic decisions ("We chose to use A instead of B because...")
+
+The reason should be durable. Avoid referencing temporary circumstances ("we're too busy right now") — those aren't real rejections, they're deferrals.
+
+## When to check `.out-of-scope/`
+
+During triage (Step 1: Gather context), read all files in `.out-of-scope/`. When evaluating a new issue:
+
+- Check if the request matches an existing out-of-scope concept
+- Matching is by concept similarity, not keyword — "night theme" matches `dark-mode.md`
+- If there's a match, surface it to the maintainer: "This is similar to `.out-of-scope/dark-mode.md` — we rejected this before because [reason]. Do you still feel the same way?"
+
+The maintainer may:
+
+- **Confirm** — the new issue gets added to the existing file's "Prior requests" list, then closed
+- **Reconsider** — the out-of-scope file gets deleted or updated, and the issue proceeds through normal triage
+- **Disagree** — the issues are related but distinct, proceed with normal triage
+
+## When to write to `.out-of-scope/`
+
+Only when an **enhancement** (not a bug) is rejected as `wontfix`. The flow:
+
+1. Maintainer decides a feature request is out of scope
+2. Check if a matching `.out-of-scope/` file already exists
+3. If yes: append the new issue to the "Prior requests" list
+4. If no: create a new file with the concept name, decision, reason, and first prior request
+5. Post a comment on the issue explaining the decision and mentioning the `.out-of-scope/` file
+6. Close the issue with the `wontfix` label
+
+## Updating or removing out-of-scope files
+
+If the maintainer changes their mind about a previously rejected concept:
+
+- Delete the `.out-of-scope/` file
+- The skill does not need to reopen old issues — they're historical records
+- The new issue that triggered the reconsideration proceeds through normal triage
diff --git a/.kilocode/skills/triage/SKILL.md b/.kilocode/skills/triage/SKILL.md
new file mode 100644
index 0000000..3dee68f
--- /dev/null
+++ b/.kilocode/skills/triage/SKILL.md
@@ -0,0 +1,103 @@
+---
+name: triage
+description: Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
+---
+
+# Triage
+
+Move issues on the project issue tracker through a small state machine of triage roles.
+
+Every comment or issue posted to the issue tracker during triage **must** start with this disclaimer:
+
+```
+> *This was generated by AI during triage.*
+```
+
+## Reference docs
+
+- [AGENT-BRIEF.md](AGENT-BRIEF.md) — how to write durable agent briefs
+- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — how the `.out-of-scope/` knowledge base works
+
+## Roles
+
+Two **category** roles:
+
+- `bug` — something is broken
+- `enhancement` — new feature or improvement
+
+Five **state** roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter for more information
+- `ready-for-agent` — fully specified, ready for an AFK agent
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Every triaged issue should carry exactly one category role and one state role. If state roles conflict, flag it and ask the maintainer before doing anything else.
+
+These are canonical role names — the actual label strings used in the issue tracker may differ. The mapping should have been provided to you - run `/setup-matt-pocock-skills` if not.
+
+State transitions: an unlabeled issue normally goes to `needs-triage` first; from there it moves to `needs-info`, `ready-for-agent`, `ready-for-human`, or `wontfix`. `needs-info` returns to `needs-triage` once the reporter replies. The maintainer can override at any time — flag transitions that look unusual and ask before proceeding.
+
+## Invocation
+
+The maintainer invokes `/triage` and describes what they want in natural language. Interpret the request and act. Examples:
+
+- "Show me anything that needs my attention"
+- "Let's look at #42"
+- "Move #42 to ready-for-agent"
+- "What's ready for agents to pick up?"
+
+## Show what needs attention
+
+Query the issue tracker and present three buckets, oldest first:
+
+1. **Unlabeled** — never triaged.
+2. **`needs-triage`** — evaluation in progress.
+3. **`needs-info` with reporter activity since the last triage notes** — needs re-evaluation.
+
+Show counts and a one-line summary per issue. Let the maintainer pick.
+
+## Triage a specific issue
+
+1. **Gather context.** Read the full issue (body, comments, labels, reporter, dates). Parse any prior triage notes so you don't re-ask resolved questions. Explore the codebase using the project's domain glossary, respecting ADRs in the area. Read `.out-of-scope/*.md` and surface any prior rejection that resembles this issue.
+
+2. **Recommend.** Tell the maintainer your category and state recommendation with reasoning, plus a brief codebase summary relevant to the issue. Wait for direction.
+
+3. **Reproduce (bugs only).** Before any grilling, attempt reproduction: read the reporter's steps, trace the relevant code, run tests or commands. Report what happened — successful repro with code path, failed repro, or insufficient detail (a strong `needs-info` signal). A confirmed repro makes a much stronger agent brief.
+
+4. **Grill (if needed).** If the issue needs fleshing out, run a `/grill-with-docs` session.
+
+5. **Apply the outcome:**
+   - `ready-for-agent` — post an agent brief comment ([AGENT-BRIEF.md](AGENT-BRIEF.md)).
+   - `ready-for-human` — same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing).
+   - `needs-info` — post triage notes (template below).
+   - `wontfix` (bug) — polite explanation, then close.
+   - `wontfix` (enhancement) — write to `.out-of-scope/`, link to it from a comment, then close ([OUT-OF-SCOPE.md](OUT-OF-SCOPE.md)).
+   - `needs-triage` — apply the role. Optional comment if there's partial progress.
+
+## Quick state override
+
+If the maintainer says "move #42 to ready-for-agent", trust them and apply the role directly. Confirm what you're about to do (role changes, comment, close), then act. Skip grilling. If moving to `ready-for-agent` without a grilling session, ask whether they want to write an agent brief.
+
+## Needs-info template
+
+```markdown
+## Triage Notes
+
+**What we've established so far:**
+
+- point 1
+- point 2
+
+**What we still need from you (@reporter):**
+
+- question 1
+- question 2
+```
+
+Capture everything resolved during grilling under "established so far" so the work isn't lost. Questions must be specific and actionable, not "please provide more info".
+
+## Resuming a previous session
+
+If prior triage notes exist on the issue, read them, check whether the reporter has answered any outstanding questions, and present an updated picture before continuing. Don't re-ask resolved questions.
diff --git a/.kilocode/skills/write-a-skill/SKILL.md b/.kilocode/skills/write-a-skill/SKILL.md
new file mode 100644
index 0000000..7339c8a
--- /dev/null
+++ b/.kilocode/skills/write-a-skill/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: write-a-skill
+description: Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
+---
+
+# Writing Skills
+
+## Process
+
+1. **Gather requirements** - ask user about:
+   - What task/domain does the skill cover?
+   - What specific use cases should it handle?
+   - Does it need executable scripts or just instructions?
+   - Any reference materials to include?
+
+2. **Draft the skill** - create:
+   - SKILL.md with concise instructions
+   - Additional reference files if content exceeds 500 lines
+   - Utility scripts if deterministic operations needed
+
+3. **Review with user** - present draft and ask:
+   - Does this cover your use cases?
+   - Anything missing or unclear?
+   - Should any section be more/less detailed?
+
+## Skill Structure
+
+```
+skill-name/
+├── SKILL.md           # Main instructions (required)
+├── REFERENCE.md       # Detailed docs (if needed)
+├── EXAMPLES.md        # Usage examples (if needed)
+└── scripts/           # Utility scripts (if needed)
+    └── helper.js
+```
+
+## SKILL.md Template
+
+```md
+---
+name: skill-name
+description: Brief description of capability. Use when [specific triggers].
+---
+
+# Skill Name
+
+## Quick start
+
+[Minimal working example]
+
+## Workflows
+
+[Step-by-step processes with checklists for complex tasks]
+
+## Advanced features
+
+[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
+```
+
+## Description Requirements
+
+The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
+
+**Goal**: Give your agent just enough info to know:
+
+1. What capability this skill provides
+2. When/why to trigger it (specific keywords, contexts, file types)
+
+**Format**:
+
+- Max 1024 chars
+- Write in third person
+- First sentence: what it does
+- Second sentence: "Use when [specific triggers]"
+
+**Good example**:
+
+```
+Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
+```
+
+**Bad example**:
+
+```
+Helps with documents.
+```
+
+The bad example gives your agent no way to distinguish this from other document skills.
+
+## When to Add Scripts
+
+Add utility scripts when:
+
+- Operation is deterministic (validation, formatting)
+- Same code would be generated repeatedly
+- Errors need explicit handling
+
+Scripts save tokens and improve reliability vs generated code.
+
+## When to Split Files
+
+Split into separate files when:
+
+- SKILL.md exceeds 100 lines
+- Content has distinct domains (finance vs sales schemas)
+- Advanced features are rarely needed
+
+## Review Checklist
+
+After drafting, verify:
+
+- [ ] Description includes triggers ("Use when...")
+- [ ] SKILL.md under 100 lines
+- [ ] No time-sensitive info
+- [ ] Consistent terminology
+- [ ] Concrete examples included
+- [ ] References one level deep
diff --git a/.kilocode/skills/zoom-out/SKILL.md b/.kilocode/skills/zoom-out/SKILL.md
new file mode 100644
index 0000000..1e7a5dc
--- /dev/null
+++ b/.kilocode/skills/zoom-out/SKILL.md
@@ -0,0 +1,7 @@
+---
+name: zoom-out
+description: Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
+disable-model-invocation: true
+---
+
+I don't know this area of code well. Go up a layer of abstraction. Give me a map of all the relevant modules and callers, using the project's domain glossary vocabulary.
diff --git a/.kiro/skills/caveman/SKILL.md b/.kiro/skills/caveman/SKILL.md
new file mode 100644
index 0000000..85770a3
--- /dev/null
+++ b/.kiro/skills/caveman/SKILL.md
@@ -0,0 +1,49 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode. Cuts token usage ~75% by dropping
+  filler, articles, and pleasantries while keeping full technical accuracy.
+  Use when user says "caveman mode", "talk like caveman", "use caveman",
+  "less tokens", "be brief", or invokes /caveman.
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode".
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough.
+
+Technical terms stay exact. Code blocks unchanged. Errors quoted exact.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+### Examples
+
+**"Why React component re-render?"**
+
+> Inline obj prop -> new ref -> re-render. `useMemo`.
+
+**"Explain database connection pooling."**
+
+> Pool = reuse DB conn. Skip handshake -> fast under load.
+
+## Auto-Clarity Exception
+
+Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
+
+Example -- destructive op:
+
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+>
+> ```sql
+> DROP TABLE users;
+> ```
+>
+> Caveman resume. Verify backup exist first.
diff --git a/.kiro/skills/diagnose/SKILL.md b/.kiro/skills/diagnose/SKILL.md
new file mode 100644
index 0000000..ed55bda
--- /dev/null
+++ b/.kiro/skills/diagnose/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: diagnose
+description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
+---
+
+# Diagnose
+
+A discipline for hard bugs. Skip phases only when explicitly justified.
+
+When exploring the codebase, use the project's domain glossary to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.
+
+## Phase 1 — Build a feedback loop
+
+**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you.
+
+Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.**
+
+### Ways to construct one — try them in roughly this order
+
+1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.
+2. **Curl / HTTP script** against a running dev server.
+3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.
+4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network.
+5. **Replay a captured trace.** Save a real network request / payload / event log to disk; replay it through the code path in isolation.
+6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that exercises the bug code path with a single function call.
+7. **Property / fuzz loop.** If the bug is "sometimes wrong output", run 1000 random inputs and look for the failure mode.
+8. **Bisection harness.** If the bug appeared between two known states (commit, dataset, version), automate "boot at state X, check, repeat" so you can `git bisect run` it.
+9. **Differential loop.** Run the same input through old-version vs new-version (or two configs) and diff outputs.
+10. **HITL bash script.** Last resort. If a human must click, drive _them_ with `scripts/hitl-loop.template.sh` so the loop is still structured. Captured output feeds back to you.
+
+Build the right feedback loop, and the bug is 90% fixed.
+
+### Iterate on the loop itself
+
+Treat the loop as a product. Once you have _a_ loop, ask:
+
+- Can I make it faster? (Cache setup, skip unrelated init, narrow the test scope.)
+- Can I make the signal sharper? (Assert on the specific symptom, not "didn't crash".)
+- Can I make it more deterministic? (Pin time, seed RNG, isolate filesystem, freeze network.)
+
+A 30-second flaky loop is barely better than no loop. A 2-second deterministic loop is a debugging superpower.
+
+### Non-deterministic bugs
+
+The goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×, parallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake bug is debuggable; 1% is not — keep raising the rate until it's debuggable.
+
+### When you genuinely cannot build a loop
+
+Stop and say so explicitly. List what you tried. Ask the user for: (a) access to whatever environment reproduces it, (b) a captured artifact (HAR file, log dump, core dump, screen recording with timestamps), or (c) permission to add temporary production instrumentation. Do **not** proceed to hypothesise without a loop.
+
+Do not proceed to Phase 2 until you have a loop you believe in.
+
+## Phase 2 — Reproduce
+
+Run the loop. Watch the bug appear.
+
+Confirm:
+
+- [ ] The loop produces the failure mode the **user** described — not a different failure that happens to be nearby. Wrong bug = wrong fix.
+- [ ] The failure is reproducible across multiple runs (or, for non-deterministic bugs, reproducible at a high enough rate to debug against).
+- [ ] You have captured the exact symptom (error message, wrong output, slow timing) so later phases can verify the fix actually addresses it.
+
+Do not proceed until you reproduce the bug.
+
+## Phase 3 — Hypothesise
+
+Generate **3–5 ranked hypotheses** before testing any of them. Single-hypothesis generation anchors on the first plausible idea.
+
+Each hypothesis must be **falsifiable**: state the prediction it makes.
+
+> Format: "If <X> is the cause, then <changing Y> will make the bug disappear / <changing Z> will make it worse."
+
+If you cannot state the prediction, the hypothesis is a vibe — discard or sharpen it.
+
+**Show the ranked list to the user before testing.** They often have domain knowledge that re-ranks instantly ("we just deployed a change to #3"), or know hypotheses they've already ruled out. Cheap checkpoint, big time saver. Don't block on it — proceed with your ranking if the user is AFK.
+
+## Phase 4 — Instrument
+
+Each probe must map to a specific prediction from Phase 3. **Change one variable at a time.**
+
+Tool preference:
+
+1. **Debugger / REPL inspection** if the env supports it. One breakpoint beats ten logs.
+2. **Targeted logs** at the boundaries that distinguish hypotheses.
+3. Never "log everything and grep".
+
+**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep. Untagged logs survive; tagged logs die.
+
+**Perf branch.** For performance regressions, logs are usually wrong. Instead: establish a baseline measurement (timing harness, `performance.now()`, profiler, query plan), then bisect. Measure first, fix second.
+
+## Phase 5 — Fix + regression test
+
+Write the regression test **before the fix** — but only if there is a **correct seam** for it.
+
+A correct seam is one where the test exercises the **real bug pattern** as it occurs at the call site. If the only available seam is too shallow (single-caller test when the bug needs multiple callers, unit test that can't replicate the chain that triggered the bug), a regression test there gives false confidence.
+
+**If no correct seam exists, that itself is the finding.** Note it. The codebase architecture is preventing the bug from being locked down. Flag this for the next phase.
+
+If a correct seam exists:
+
+1. Turn the minimised repro into a failing test at that seam.
+2. Watch it fail.
+3. Apply the fix.
+4. Watch it pass.
+5. Re-run the Phase 1 feedback loop against the original (un-minimised) scenario.
+
+## Phase 6 — Cleanup + post-mortem
+
+Required before declaring done:
+
+- [ ] Original repro no longer reproduces (re-run the Phase 1 loop)
+- [ ] Regression test passes (or absence of seam is documented)
+- [ ] All `[DEBUG-...]` instrumentation removed (`grep` the prefix)
+- [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location)
+- [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns
+
+**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started.
diff --git a/.kiro/skills/diagnose/scripts/hitl-loop.template.sh b/.kiro/skills/diagnose/scripts/hitl-loop.template.sh
new file mode 100644
index 0000000..40afc46
--- /dev/null
+++ b/.kiro/skills/diagnose/scripts/hitl-loop.template.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Human-in-the-loop reproduction loop.
+# Copy this file, edit the steps below, and run it.
+# The agent runs the script; the user follows prompts in their terminal.
+#
+# Usage:
+#   bash hitl-loop.template.sh
+#
+# Two helpers:
+#   step "<instruction>"          → show instruction, wait for Enter
+#   capture VAR "<question>"      → show question, read response into VAR
+#
+# At the end, captured values are printed as KEY=VALUE for the agent to parse.
+
+set -euo pipefail
+
+step() {
+  printf '\n>>> %s\n' "$1"
+  read -r -p "    [Enter when done] " _
+}
+
+capture() {
+  local var="$1" question="$2" answer
+  printf '\n>>> %s\n' "$question"
+  read -r -p "    > " answer
+  printf -v "$var" '%s' "$answer"
+}
+
+# --- edit below ---------------------------------------------------------
+
+step "Open the app at http://localhost:3000 and sign in."
+
+capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)"
+
+capture ERROR_MSG "Paste the error message (or 'none'):"
+
+# --- edit above ---------------------------------------------------------
+
+printf '\n--- Captured ---\n'
+printf 'ERRORED=%s\n' "$ERRORED"
+printf 'ERROR_MSG=%s\n' "$ERROR_MSG"
diff --git a/.kiro/skills/grill-me/SKILL.md b/.kiro/skills/grill-me/SKILL.md
new file mode 100644
index 0000000..bd04394
--- /dev/null
+++ b/.kiro/skills/grill-me/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: grill-me
+description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
+---
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
diff --git a/.kiro/skills/grill-with-docs/ADR-FORMAT.md b/.kiro/skills/grill-with-docs/ADR-FORMAT.md
new file mode 100644
index 0000000..da7e78e
--- /dev/null
+++ b/.kiro/skills/grill-with-docs/ADR-FORMAT.md
@@ -0,0 +1,47 @@
+# ADR Format
+
+ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
+
+Create the `docs/adr/` directory lazily — only when the first ADR is needed.
+
+## Template
+
+```md
+# {Short title of the decision}
+
+{1-3 sentences: what's the context, what did we decide, and why.}
+```
+
+That's it. An ADR can be a single paragraph. The value is in recording *that* a decision was made and *why* — not in filling out sections.
+
+## Optional sections
+
+Only include these when they add genuine value. Most ADRs won't need them.
+
+- **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited
+- **Considered Options** — only when the rejected alternatives are worth remembering
+- **Consequences** — only when non-obvious downstream effects need to be called out
+
+## Numbering
+
+Scan `docs/adr/` for the highest existing number and increment by one.
+
+## When to offer an ADR
+
+All three of these must be true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing."
+
+### What qualifies
+
+- **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres."
+- **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP."
+- **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out.
+- **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s.
+- **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate.
+- **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract."
+- **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months.
diff --git a/.kiro/skills/grill-with-docs/CONTEXT-FORMAT.md b/.kiro/skills/grill-with-docs/CONTEXT-FORMAT.md
new file mode 100644
index 0000000..ddfa247
--- /dev/null
+++ b/.kiro/skills/grill-with-docs/CONTEXT-FORMAT.md
@@ -0,0 +1,77 @@
+# CONTEXT.md Format
+
+## Structure
+
+```md
+# {Context Name}
+
+{One or two sentence description of what this context is and why it exists.}
+
+## Language
+
+**Order**:
+{A concise description of the term}
+_Avoid_: Purchase, transaction
+
+**Invoice**:
+A request for payment sent to a customer after delivery.
+_Avoid_: Bill, payment request
+
+**Customer**:
+A person or organization that places orders.
+_Avoid_: Client, buyer, account
+
+## Relationships
+
+- An **Order** produces one or more **Invoices**
+- An **Invoice** belongs to exactly one **Customer**
+
+## Example dialogue
+
+> **Dev:** "When a **Customer** places an **Order**, do we create the **Invoice** immediately?"
+> **Domain expert:** "No — an **Invoice** is only generated once a **Fulfillment** is confirmed."
+
+## Flagged ambiguities
+
+- "account" was used to mean both **Customer** and **User** — resolved: these are distinct concepts.
+```
+
+## Rules
+
+- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others as aliases to avoid.
+- **Flag conflicts explicitly.** If a term is used ambiguously, call it out in "Flagged ambiguities" with a clear resolution.
+- **Keep definitions tight.** One sentence max. Define what it IS, not what it does.
+- **Show relationships.** Use bold term names and express cardinality where obvious.
+- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
+- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
+- **Write an example dialogue.** A conversation between a dev and a domain expert that demonstrates how the terms interact naturally and clarifies boundaries between related concepts.
+
+## Single vs multi-context repos
+
+**Single context (most repos):** One `CONTEXT.md` at the repo root.
+
+**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
+
+```md
+# Context Map
+
+## Contexts
+
+- [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders
+- [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments
+- [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping
+
+## Relationships
+
+- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
+- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
+- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
+```
+
+The skill infers which structure applies:
+
+- If `CONTEXT-MAP.md` exists, read it to find contexts
+- If only a root `CONTEXT.md` exists, single context
+- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
+
+When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
diff --git a/.kiro/skills/grill-with-docs/SKILL.md b/.kiro/skills/grill-with-docs/SKILL.md
new file mode 100644
index 0000000..5ea0aa9
--- /dev/null
+++ b/.kiro/skills/grill-with-docs/SKILL.md
@@ -0,0 +1,88 @@
+---
+name: grill-with-docs
+description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
+---
+
+<what-to-do>
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time, waiting for feedback on each question before continuing.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
+
+</what-to-do>
+
+<supporting-info>
+
+## Domain awareness
+
+During codebase exploration, also look for existing documentation:
+
+### File structure
+
+Most repos have a single context:
+
+```
+/
+├── CONTEXT.md
+├── docs/
+│   └── adr/
+│       ├── 0001-event-sourced-orders.md
+│       └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/
+│   └── adr/                          ← system-wide decisions
+├── src/
+│   ├── ordering/
+│   │   ├── CONTEXT.md
+│   │   └── docs/adr/                 ← context-specific decisions
+│   └── billing/
+│       ├── CONTEXT.md
+│       └── docs/adr/
+```
+
+Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
+
+## During the session
+
+### Challenge against the glossary
+
+When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"
+
+### Sharpen fuzzy language
+
+When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things."
+
+### Discuss concrete scenarios
+
+When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
+
+### Cross-reference with code
+
+When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible — which is right?"
+
+### Update CONTEXT.md inline
+
+When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
+
+`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
+
+### Offer ADRs sparingly
+
+Only offer to create an ADR when all three are true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will wonder "why did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md).
+
+</supporting-info>
diff --git a/.kiro/skills/handoff/SKILL.md b/.kiro/skills/handoff/SKILL.md
new file mode 100644
index 0000000..28bfb3a
--- /dev/null
+++ b/.kiro/skills/handoff/SKILL.md
@@ -0,0 +1,13 @@
+---
+name: handoff
+description: Compact the current conversation into a handoff document for another agent to pick up.
+argument-hint: "What will the next session be used for?"
+---
+
+Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it).
+
+Suggest the skills to be used, if any, by the next session.
+
+Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+
+If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
diff --git a/.kiro/skills/improve-codebase-architecture/DEEPENING.md b/.kiro/skills/improve-codebase-architecture/DEEPENING.md
new file mode 100644
index 0000000..ecaf5d7
--- /dev/null
+++ b/.kiro/skills/improve-codebase-architecture/DEEPENING.md
@@ -0,0 +1,37 @@
+# Deepening
+
+How to deepen a cluster of shallow modules safely, given its dependencies. Assumes the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**.
+
+## Dependency categories
+
+When assessing a candidate for deepening, classify its dependencies. The category determines how the deepened module is tested across its seam.
+
+### 1. In-process
+
+Pure computation, in-memory state, no I/O. Always deepenable — merge the modules and test through the new interface directly. No adapter needed.
+
+### 2. Local-substitutable
+
+Dependencies that have local test stand-ins (PGLite for Postgres, in-memory filesystem). Deepenable if the stand-in exists. The deepened module is tested with the stand-in running in the test suite. The seam is internal; no port at the module's external interface.
+
+### 3. Remote but owned (Ports & Adapters)
+
+Your own services across a network boundary (microservices, internal APIs). Define a **port** (interface) at the seam. The deep module owns the logic; the transport is injected as an **adapter**. Tests use an in-memory adapter. Production uses an HTTP/gRPC/queue adapter.
+
+Recommendation shape: *"Define a port at the seam, implement an HTTP adapter for production and an in-memory adapter for testing, so the logic sits in one deep module even though it's deployed across a network."*
+
+### 4. True external (Mock)
+
+Third-party services (Stripe, Twilio, etc.) you don't control. The deepened module takes the external dependency as an injected port; tests provide a mock adapter.
+
+## Seam discipline
+
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a port unless at least two adapters are justified (typically production + test). A single-adapter seam is just indirection.
+- **Internal seams vs external seams.** A deep module can have internal seams (private to its implementation, used by its own tests) as well as the external seam at its interface. Don't expose internal seams through the interface just because tests use them.
+
+## Testing strategy: replace, don't layer
+
+- Old unit tests on shallow modules become waste once tests at the deepened module's interface exist — delete them.
+- Write new tests at the deepened module's interface. The **interface is the test surface**.
+- Tests assert on observable outcomes through the interface, not internal state.
+- Tests should survive internal refactors — they describe behaviour, not implementation. If a test has to change when the implementation changes, it's testing past the interface.
diff --git a/.kiro/skills/improve-codebase-architecture/INTERFACE-DESIGN.md b/.kiro/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
new file mode 100644
index 0000000..3197723
--- /dev/null
+++ b/.kiro/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
@@ -0,0 +1,44 @@
+# Interface Design
+
+When the user wants to explore alternative interfaces for a chosen deepening candidate, use this parallel sub-agent pattern. Based on "Design It Twice" (Ousterhout) — your first idea is unlikely to be the best.
+
+Uses the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**, **leverage**.
+
+## Process
+
+### 1. Frame the problem space
+
+Before spawning sub-agents, write a user-facing explanation of the problem space for the chosen candidate:
+
+- The constraints any new interface would need to satisfy
+- The dependencies it would rely on, and which category they fall into (see [DEEPENING.md](DEEPENING.md))
+- A rough illustrative code sketch to ground the constraints — not a proposal, just a way to make the constraints concrete
+
+Show this to the user, then immediately proceed to Step 2. The user reads and thinks while the sub-agents work in parallel.
+
+### 2. Spawn sub-agents
+
+Spawn 3+ sub-agents in parallel using the Agent tool. Each must produce a **radically different** interface for the deepened module.
+
+Prompt each sub-agent with a separate technical brief (file paths, coupling details, dependency category from [DEEPENING.md](DEEPENING.md), what sits behind the seam). The brief is independent of the user-facing problem-space explanation in Step 1. Give each agent a different design constraint:
+
+- Agent 1: "Minimize the interface — aim for 1–3 entry points max. Maximise leverage per entry point."
+- Agent 2: "Maximise flexibility — support many use cases and extension."
+- Agent 3: "Optimise for the most common caller — make the default case trivial."
+- Agent 4 (if applicable): "Design around ports & adapters for cross-seam dependencies."
+
+Include both [LANGUAGE.md](LANGUAGE.md) vocabulary and CONTEXT.md vocabulary in the brief so each sub-agent names things consistently with the architecture language and the project's domain language.
+
+Each sub-agent outputs:
+
+1. Interface (types, methods, params — plus invariants, ordering, error modes)
+2. Usage example showing how callers use it
+3. What the implementation hides behind the seam
+4. Dependency strategy and adapters (see [DEEPENING.md](DEEPENING.md))
+5. Trade-offs — where leverage is high, where it's thin
+
+### 3. Present and compare
+
+Present designs sequentially so the user can absorb each one, then compare them in prose. Contrast by **depth** (leverage at the interface), **locality** (where change concentrates), and **seam placement**.
+
+After comparing, give your own recommendation: which design you think is strongest and why. If elements from different designs would combine well, propose a hybrid. Be opinionated — the user wants a strong read, not a menu.
diff --git a/.kiro/skills/improve-codebase-architecture/LANGUAGE.md b/.kiro/skills/improve-codebase-architecture/LANGUAGE.md
new file mode 100644
index 0000000..530c276
--- /dev/null
+++ b/.kiro/skills/improve-codebase-architecture/LANGUAGE.md
@@ -0,0 +1,53 @@
+# Language
+
+Shared vocabulary for every suggestion this skill makes. Use these terms exactly — don't substitute "component," "service," "API," or "boundary." Consistent language is the whole point.
+
+## Terms
+
+**Module**
+Anything with an interface and an implementation. Deliberately scale-agnostic — applies equally to a function, class, package, or tier-spanning slice.
+_Avoid_: unit, component, service.
+
+**Interface**
+Everything a caller must know to use the module correctly. Includes the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics.
+_Avoid_: API, signature (too narrow — those refer only to the type-level surface).
+
+**Implementation**
+What's inside a module — its body of code. Distinct from **Adapter**: a thing can be a small adapter with a large implementation (a Postgres repo) or a large adapter with a small implementation (an in-memory fake). Reach for "adapter" when the seam is the topic; "implementation" otherwise.
+
+**Depth**
+Leverage at the interface — the amount of behaviour a caller (or test) can exercise per unit of interface they have to learn. A module is **deep** when a large amount of behaviour sits behind a small interface. A module is **shallow** when the interface is nearly as complex as the implementation.
+
+**Seam** _(from Michael Feathers)_
+A place where you can alter behaviour without editing in that place. The *location* at which a module's interface lives. Choosing where to put the seam is its own design decision, distinct from what goes behind it.
+_Avoid_: boundary (overloaded with DDD's bounded context).
+
+**Adapter**
+A concrete thing that satisfies an interface at a seam. Describes *role* (what slot it fills), not substance (what's inside).
+
+**Leverage**
+What callers get from depth. More capability per unit of interface they have to learn. One implementation pays back across N call sites and M tests.
+
+**Locality**
+What maintainers get from depth. Change, bugs, knowledge, and verification concentrate at one place rather than spreading across callers. Fix once, fixed everywhere.
+
+## Principles
+
+- **Depth is a property of the interface, not the implementation.** A deep module can be internally composed of small, mockable, swappable parts — they just aren't part of the interface. A module can have **internal seams** (private to its implementation, used by its own tests) as well as the **external seam** at its interface.
+- **The deletion test.** Imagine deleting the module. If complexity vanishes, the module wasn't hiding anything (it was a pass-through). If complexity reappears across N callers, the module was earning its keep.
+- **The interface is the test surface.** Callers and tests cross the same seam. If you want to test *past* the interface, the module is probably the wrong shape.
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a seam unless something actually varies across it.
+
+## Relationships
+
+- A **Module** has exactly one **Interface** (the surface it presents to callers and tests).
+- **Depth** is a property of a **Module**, measured against its **Interface**.
+- A **Seam** is where a **Module**'s **Interface** lives.
+- An **Adapter** sits at a **Seam** and satisfies the **Interface**.
+- **Depth** produces **Leverage** for callers and **Locality** for maintainers.
+
+## Rejected framings
+
+- **Depth as ratio of implementation-lines to interface-lines** (Ousterhout): rewards padding the implementation. We use depth-as-leverage instead.
+- **"Interface" as the TypeScript `interface` keyword or a class's public methods**: too narrow — interface here includes every fact a caller must know.
+- **"Boundary"**: overloaded with DDD's bounded context. Say **seam** or **interface**.
diff --git a/.kiro/skills/improve-codebase-architecture/SKILL.md b/.kiro/skills/improve-codebase-architecture/SKILL.md
new file mode 100644
index 0000000..05984a6
--- /dev/null
+++ b/.kiro/skills/improve-codebase-architecture/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: improve-codebase-architecture
+description: Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
+---
+
+# Improve Codebase Architecture
+
+Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
+
+## Glossary
+
+Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).
+
+- **Module** — anything with an interface and an implementation (function, class, package, slice).
+- **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
+- **Implementation** — the code inside.
+- **Depth** — leverage at the interface: a lot of behaviour behind a small interface. **Deep** = high leverage. **Shallow** = interface nearly as complex as the implementation.
+- **Seam** — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.")
+- **Adapter** — a concrete thing satisfying an interface at a seam.
+- **Leverage** — what callers get from depth.
+- **Locality** — what maintainers get from depth: change, bugs, knowledge concentrated in one place.
+
+Key principles (see [LANGUAGE.md](LANGUAGE.md) for the full list):
+
+- **Deletion test**: imagine deleting the module. If complexity vanishes, it was a pass-through. If complexity reappears across N callers, it was earning its keep.
+- **The interface is the test surface.**
+- **One adapter = hypothetical seam. Two adapters = real seam.**
+
+This skill is _informed_ by the project's domain model. The domain language gives names to good seams; ADRs record decisions the skill should not re-litigate.
+
+## Process
+
+### 1. Explore
+
+Read the project's domain glossary and any ADRs in the area you're touching first.
+
+Then use the Agent tool with `subagent_type=Explore` to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction:
+
+- Where does understanding one concept require bouncing between many small modules?
+- Where are modules **shallow** — interface nearly as complex as the implementation?
+- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no **locality**)?
+- Where do tightly-coupled modules leak across their seams?
+- Which parts of the codebase are untested, or hard to test through their current interface?
+
+Apply the **deletion test** to anything you suspect is shallow: would deleting it concentrate complexity, or just move it? A "yes, concentrates" is the signal you want.
+
+### 2. Present candidates
+
+Present a numbered list of deepening opportunities. For each candidate:
+
+- **Files** — which files/modules are involved
+- **Problem** — why the current architecture is causing friction
+- **Solution** — plain English description of what would change
+- **Benefits** — explained in terms of locality and leverage, and also in how tests would improve
+
+**Use CONTEXT.md vocabulary for the domain, and [LANGUAGE.md](LANGUAGE.md) vocabulary for the architecture.** If `CONTEXT.md` defines "Order," talk about "the Order intake module" — not "the FooBarHandler," and not "the Order service."
+
+**ADR conflicts**: if a candidate contradicts an existing ADR, only surface it when the friction is real enough to warrant revisiting the ADR. Mark it clearly (e.g. _"contradicts ADR-0007 — but worth reopening because…"_). Don't list every theoretical refactor an ADR forbids.
+
+Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
+
+### 3. Grilling loop
+
+Once the user picks a candidate, drop into a grilling conversation. Walk the design tree with them — constraints, dependencies, the shape of the deepened module, what sits behind the seam, what tests survive.
+
+Side effects happen inline as decisions crystallize:
+
+- **Naming a deepened module after a concept not in `CONTEXT.md`?** Add the term to `CONTEXT.md` — same discipline as `/grill-with-docs` (see [CONTEXT-FORMAT.md](../grill-with-docs/CONTEXT-FORMAT.md)). Create the file lazily if it doesn't exist.
+- **Sharpening a fuzzy term during the conversation?** Update `CONTEXT.md` right there.
+- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer to avoid re-suggesting the same thing — skip ephemeral reasons ("not worth it right now") and self-evident ones. See [ADR-FORMAT.md](../grill-with-docs/ADR-FORMAT.md).
+- **Want to explore alternative interfaces for the deepened module?** See [INTERFACE-DESIGN.md](INTERFACE-DESIGN.md).
diff --git a/.kiro/skills/prototype/LOGIC.md b/.kiro/skills/prototype/LOGIC.md
new file mode 100644
index 0000000..526ecb1
--- /dev/null
+++ b/.kiro/skills/prototype/LOGIC.md
@@ -0,0 +1,79 @@
+# Logic Prototype
+
+A tiny interactive terminal app that lets the user drive a state model by hand. Use this when the question is about **business logic, state transitions, or data shape** — the kind of thing that looks reasonable on paper but only feels wrong once you push it through real cases.
+
+## When this is the right shape
+
+- "I'm not sure if this state machine handles the edge case where X then Y."
+- "Does this data model actually let me represent the case where..."
+- "I want to feel out what the API should look like before writing it."
+- Anything where the user wants to **press buttons and watch state change**.
+
+If the question is "what should this look like" — wrong branch. Use [UI.md](UI.md).
+
+## Process
+
+### 1. State the question
+
+Before writing code, write down what state model and what question you're prototyping. One paragraph, in the prototype's README or a comment at the top of the file. A logic prototype that answers the wrong question is pure waste — make the question explicit so it can be checked later, whether the user is watching now or returning to it AFK.
+
+### 2. Pick the language
+
+Use whatever the host project uses. If the project has no obvious runtime (e.g. a docs repo), ask.
+
+Match the project's existing conventions for tooling — don't add a new package manager or runtime just for the prototype.
+
+### 3. Isolate the logic in a portable module
+
+Put the actual logic — the bit that's answering the question — behind a small, pure interface that could be lifted out and dropped into the real codebase later. The TUI around it is throwaway; the logic module shouldn't be.
+
+The right shape depends on the question:
+
+- **A pure reducer** — `(state, action) => state`. Good when actions are discrete events and state is a single value.
+- **A state machine** — explicit states and transitions. Good when "which actions are even legal right now" is part of the question.
+- **A small set of pure functions** over a plain data type. Good when there's no implicit current state — just transformations.
+- **A class or module with a clear method surface** when the logic genuinely owns ongoing internal state.
+
+Pick whichever shape best fits the question being asked, *not* whichever is easiest to wire to a TUI. Keep it pure: no I/O, no terminal code, no `console.log` for control flow. The TUI imports it and calls into it; nothing flows the other direction.
+
+This is what makes the prototype useful past its own lifetime. When the question's been answered, the validated reducer / machine / function set can be lifted into the real module — the TUI shell gets deleted.
+
+### 4. Build the smallest TUI that exposes the state
+
+Build it as a **lightweight TUI** — on every tick, clear the screen (`console.clear()` / `print("\033[2J\033[H")` / equivalent) and re-render the whole frame. The user should always see one stable view, not an ever-growing scrollback.
+
+Each frame has two parts, in this order:
+
+1. **Current state**, pretty-printed and diff-friendly (one field per line, or formatted JSON). Use **bold** for field names or section headers and **dim** for less important context (timestamps, IDs, derived values). Native ANSI escape codes are fine — `\x1b[1m` bold, `\x1b[2m` dim, `\x1b[0m` reset. No need to pull in a styling library unless one is already in the project.
+2. **Keyboard shortcuts**, listed at the bottom: `[a] add user  [d] delete user  [t] tick clock  [q] quit`. Bold the key, dim the description, or vice-versa — whatever reads cleanly.
+
+Behaviour:
+
+1. **Initialise state** — a single in-memory object/struct. Render the first frame on start.
+2. **Read one keystroke (or one line)** at a time, dispatch to a handler that mutates state.
+3. **Re-render** the full frame after every action — don't append, replace.
+4. **Loop until quit.**
+
+The whole frame should fit on one screen.
+
+### 5. Make it runnable in one command
+
+Add a script to the project's existing task runner (`package.json` scripts, `Makefile`, `justfile`, `pyproject.toml`). The user should run `pnpm run <prototype-name>` or equivalent — never need to remember a path.
+
+If the host project has no task runner, just put the command at the top of the prototype's README.
+
+### 6. Hand it over
+
+Give the user the run command. They'll drive it themselves; the interesting moments are when they say "wait, that shouldn't be possible" or "huh, I assumed X would be different" — those are the bugs in the _idea_, which is the whole point. If they want new actions added, add them. Prototypes evolve.
+
+### 7. Capture the answer
+
+When the prototype has done its job, the answer to the question is the only thing worth keeping. If the user is around, ask what it taught them. If not, leave a `NOTES.md` next to the prototype so the answer can be filled in (or filled in by you, if you've watched the session) before the prototype gets deleted.
+
+## Anti-patterns
+
+- **Don't add tests.** A prototype that needs tests is no longer a prototype.
+- **Don't wire it to the real database.** Use an in-memory store unless the question is specifically about persistence.
+- **Don't generalise.** No "what if we wanted to support X later." The prototype answers one question.
+- **Don't blur the logic and the TUI together.** If the reducer / state machine references `console.log`, prompts, or terminal escape codes, it's no longer portable. Keep the TUI as a thin shell over a pure module.
+- **Don't ship the TUI shell into production.** The shell is optimised for being driven by hand from a terminal. The logic module behind it is the bit worth keeping.
diff --git a/.kiro/skills/prototype/SKILL.md b/.kiro/skills/prototype/SKILL.md
new file mode 100644
index 0000000..64f3e61
--- /dev/null
+++ b/.kiro/skills/prototype/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: prototype
+description: Build a throwaway prototype to flesh out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".
+---
+
+# Prototype
+
+A prototype is **throwaway code that answers a question**. The question decides the shape.
+
+## Pick a branch
+
+Identify which question is being answered — from the user's prompt, the surrounding code, or by asking if the user is around:
+
+- **"Does this logic / state model feel right?"** → [LOGIC.md](LOGIC.md). Build a tiny interactive terminal app that pushes the state machine through cases that are hard to reason about on paper.
+- **"What should this look like?"** → [UI.md](UI.md). Generate several radically different UI variations on a single route, switchable via a URL search param and a floating bottom bar.
+
+The two branches produce very different artifacts — getting this wrong wastes the whole prototype. If the question is genuinely ambiguous and the user isn't reachable, default to whichever branch better matches the surrounding code (a backend module → logic; a page or component → UI) and state the assumption at the top of the prototype.
+
+## Rules that apply to both
+
+1. **Throwaway from day one, and clearly marked as such.** Locate the prototype code close to where it will actually be used (next to the module or page it's prototyping for) so context is obvious — but name it so a casual reader can see it's a prototype, not production. For throwaway UI routes, obey whatever routing convention the project already uses; don't invent a new top-level structure.
+2. **One command to run.** Whatever the project's existing task runner supports — `pnpm <name>`, `python <path>`, `bun <path>`, etc. The user must be able to start it without thinking.
+3. **No persistence by default.** State lives in memory. Persistence is the thing the prototype is _checking_, not something it should depend on. If the question explicitly involves a database, hit a scratch DB or a local file with a clear "PROTOTYPE — wipe me" name.
+4. **Skip the polish.** No tests, no error handling beyond what makes the prototype _runnable_, no abstractions. The point is to learn something fast and then delete it.
+5. **Surface the state.** After every action (logic) or on every variant switch (UI), print or render the full relevant state so the user can see what changed.
+6. **Delete or absorb when done.** When the prototype has answered its question, either delete it or fold the validated decision into the real code — don't leave it rotting in the repo.
+
+## When done
+
+The _answer_ is the only thing worth keeping from a prototype. Capture it somewhere durable (commit message, ADR, issue, or a `NOTES.md` next to the prototype) along with the question it was answering. If the user is around, that capture is a quick conversation; if not, leave the placeholder so they (or you, on the next pass) can fill in the verdict before deleting the prototype.
diff --git a/.kiro/skills/prototype/UI.md b/.kiro/skills/prototype/UI.md
new file mode 100644
index 0000000..f3b6e64
--- /dev/null
+++ b/.kiro/skills/prototype/UI.md
@@ -0,0 +1,112 @@
+# UI Prototype
+
+Generate **several radically different UI variations** on a single route, switchable from a floating bottom bar. The user flips between variants in the browser, picks one (or steals bits from each), then throws the rest away.
+
+If the question is about logic/state rather than what something looks like — wrong branch. Use [LOGIC.md](LOGIC.md).
+
+## When this is the right shape
+
+- "What should this page look like?"
+- "I want to see a few options for this dashboard before committing."
+- "Try a different layout for the settings screen."
+- Any time the user would otherwise spend a day picking between three vague mockups in their head.
+
+## Two sub-shapes — strongly prefer sub-shape A
+
+A UI prototype is much easier to judge when it's **butting up against the rest of the app** — real header, real sidebar, real data, real density. A throwaway route on its own is a vacuum: every variant looks fine in isolation. Default to sub-shape A whenever there's a plausible existing page to host the variants. Only reach for sub-shape B if the prototype genuinely has no nearby home.
+
+### Sub-shape A — adjustment to an existing page (preferred)
+
+The route already exists. Variants are rendered **on the same route**, gated by a `?variant=` URL search param. The existing data fetching, params, and auth all stay — only the rendering swaps. This is the default; pick it unless there's a specific reason not to.
+
+If the prototype is for something that doesn't yet have a page but *would naturally live inside one* (a new section of the dashboard, a new card on the settings screen, a new step in an existing flow) — that's still sub-shape A. Mount the variants inside the host page.
+
+### Sub-shape B — a new page (last resort)
+
+Only use this when the thing being prototyped genuinely has no existing page to live inside — e.g. an entirely new top-level surface, or a flow that can't be embedded anywhere sensible.
+
+Create a **throwaway route** following whatever routing convention the project already uses — don't invent a new top-level structure. Name it so it's obviously a prototype (e.g. include the word `prototype` in the path or filename). Same `?variant=` pattern.
+
+Before committing to sub-shape B, sanity-check: is there really no existing page this could be embedded in? An empty route hides design problems that a populated one would expose.
+
+In both sub-shapes the floating bottom bar is identical.
+
+## Process
+
+### 1. State the question and pick N
+
+Default to **3 variants**. More than 5 stops being radically different and starts being noise — cap there.
+
+Write down the plan in one line, in the prototype's location or a top-of-file comment:
+
+> "Three variants of the settings page, switchable via `?variant=`, on the existing `/settings` route."
+
+This works whether the user is here to push back or not.
+
+### 2. Generate radically different variants
+
+Draft each variant. Hold each one to:
+
+- The page's purpose and the data it has access to.
+- The project's component library / styling system (TailwindCSS, shadcn, MUI, plain CSS, whatever).
+- A clear exported component name, e.g. `VariantA`, `VariantB`, `VariantC`.
+
+Variants must be **structurally different** — different layout, different information hierarchy, different primary affordance, not just different colours. Three slightly-tweaked card grids isn't a UI prototype, it's wallpaper. If two drafts come out too similar, redo one with explicit "do not use a card grid" guidance.
+
+### 3. Wire them together
+
+Create a single switcher component on the route:
+
+```tsx
+// pseudo-code — adapt to the project's framework
+const variant = searchParams.get('variant') ?? 'A';
+return (
+  <>
+    {variant === 'A' && <VariantA {...data} />}
+    {variant === 'B' && <VariantB {...data} />}
+    {variant === 'C' && <VariantC {...data} />}
+    <PrototypeSwitcher variants={['A','B','C']} current={variant} />
+  </>
+);
+```
+
+For sub-shape A (existing page): keep all the existing data fetching above the switcher; only the rendered subtree changes per variant.
+
+For sub-shape B (new page): the throwaway route under `/prototype/<name>` mounts the same switcher.
+
+### 4. Build the floating switcher
+
+A small fixed-position bar at the bottom-centre of the screen with three pieces:
+
+- **Left arrow** — cycles to the previous variant (wraps around).
+- **Variant label** — shows the current variant key and, if the variant exports a name, that name too. e.g. `B — Sidebar layout`.
+- **Right arrow** — cycles forward (wraps around).
+
+Behaviour:
+
+- Clicking an arrow updates the URL search param (use the framework's router — `router.replace` on Next, `navigate` on React Router, etc) so the variant is shareable and reload-stable.
+- Keyboard: `←` and `→` arrow keys also cycle. Don't intercept arrow keys when an `<input>`, `<textarea>`, or `[contenteditable]` is focused.
+- Visually distinct from the page (e.g. high-contrast pill, subtle shadow) so it's obviously not part of the design being evaluated.
+- Hidden in production builds — gate on `process.env.NODE_ENV !== 'production'` or an equivalent check, so a stray prototype merge can't ship the bar to users.
+
+Put the switcher in a single shared component so both sub-shapes can reuse it. Locate it wherever shared UI lives in the project.
+
+### 5. Hand it over
+
+Surface the URL (and the `?variant=` keys). The user will flip through whenever they get to it. The interesting feedback is usually **"I want the header from B with the sidebar from C"** — that's the actual design they want.
+
+### 6. Capture the answer and clean up
+
+Once a variant has won, write down which one and why (commit message, ADR, issue, or a `NOTES.md` next to the prototype if running AFK and the user hasn't responded yet). Then:
+
+- **Sub-shape A** — delete the losing variants and the switcher; fold the winner into the existing page.
+- **Sub-shape B** — promote the winning variant to a real route, delete the throwaway route and the switcher.
+
+Don't leave variant components or the switcher lying around. They rot fast and confuse the next reader.
+
+## Anti-patterns
+
+- **Variants that differ only in colour or copy.** That's a tweak, not a prototype. Real variants disagree about structure.
+- **Sharing too much code between variants.** A shared `<Header>` is fine; a shared `<Layout>` defeats the point. Each variant should be free to throw out the layout.
+- **Wiring variants to real mutations.** Read-only prototypes are fine. If a variant needs to mutate, point it at a stub — the question is "what should this look like", not "does the backend work".
+- **Promoting the prototype directly to production.** The variant code was written under prototype constraints (no tests, minimal error handling). Rewrite it properly when you fold it in.
diff --git a/.kiro/skills/setup-matt-pocock-skills/SKILL.md b/.kiro/skills/setup-matt-pocock-skills/SKILL.md
new file mode 100644
index 0000000..1ebc6e1
--- /dev/null
+++ b/.kiro/skills/setup-matt-pocock-skills/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: setup-matt-pocock-skills
+description: Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
+disable-model-invocation: true
+---
+
+# Setup Matt Pocock's Skills
+
+Scaffold the per-repo configuration that the engineering skills assume:
+
+- **Issue tracker** — where issues live (GitHub by default; local markdown is also supported out of the box)
+- **Triage labels** — the strings used for the five canonical triage roles
+- **Domain docs** — where `CONTEXT.md` and ADRs live, and the consumer rules for reading them
+
+This is a prompt-driven skill, not a deterministic script. Explore, present what you found, confirm with the user, then write.
+
+## Process
+
+### 1. Explore
+
+Look at the current repo to understand its starting state. Read whatever exists; don't assume:
+
+- `git remote -v` and `.git/config` — is this a GitHub repo? Which one?
+- `AGENTS.md` and `CLAUDE.md` at the repo root — does either exist? Is there already an `## Agent skills` section in either?
+- `CONTEXT.md` and `CONTEXT-MAP.md` at the repo root
+- `docs/adr/` and any `src/*/docs/adr/` directories
+- `docs/agents/` — does this skill's prior output already exist?
+- `.scratch/` — sign that a local-markdown issue tracker convention is already in use
+
+### 2. Present findings and ask
+
+Summarise what's present and what's missing. Then walk the user through the three decisions **one at a time** — present a section, get the user's answer, then move to the next. Don't dump all three at once.
+
+Assume the user does not know what these terms mean. Each section starts with a short explainer (what it is, why these skills need it, what changes if they pick differently). Then show the choices and the default.
+
+**Section A — Issue tracker.**
+
+> Explainer: The "issue tracker" is where issues live for this repo. Skills like `to-issues`, `triage`, `to-prd`, and `qa` read from and write to it — they need to know whether to call `gh issue create`, write a markdown file under `.scratch/`, or follow some other workflow you describe. Pick the place you actually track work for this repo.
+
+Default posture: these skills were designed for GitHub. If a `git remote` points at GitHub, propose that. If a `git remote` points at GitLab (`gitlab.com` or a self-hosted host), propose GitLab. Otherwise (or if the user prefers), offer:
+
+- **GitHub** — issues live in the repo's GitHub Issues (uses the `gh` CLI)
+- **GitLab** — issues live in the repo's GitLab Issues (uses the [`glab`](https://gitlab.com/gitlab-org/cli) CLI)
+- **Local markdown** — issues live as files under `.scratch/<feature>/` in this repo (good for solo projects or repos without a remote)
+- **Other** (Jira, Linear, etc.) — ask the user to describe the workflow in one paragraph; the skill will record it as freeform prose
+
+**Section B — Triage label vocabulary.**
+
+> Explainer: When the `triage` skill processes an incoming issue, it moves it through a state machine — needs evaluation, waiting on reporter, ready for an AFK agent to pick up, ready for a human, or won't fix. To do that, it needs to apply labels (or the equivalent in your issue tracker) that match strings *you've actually configured*. If your repo already uses different label names (e.g. `bug:triage` instead of `needs-triage`), map them here so the skill applies the right ones instead of creating duplicates.
+
+The five canonical roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter
+- `ready-for-agent` — fully specified, AFK-ready (an agent can pick it up with no human context)
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Default: each role's string equals its name. Ask the user if they want to override any. If their issue tracker has no existing labels, the defaults are fine.
+
+**Section C — Domain docs.**
+
+> Explainer: Some skills (`improve-codebase-architecture`, `diagnose`, `tdd`) read a `CONTEXT.md` file to learn the project's domain language, and `docs/adr/` for past architectural decisions. They need to know whether the repo has one global context or multiple (e.g. a monorepo with separate frontend/backend contexts) so they look in the right place.
+
+Confirm the layout:
+
+- **Single-context** — one `CONTEXT.md` + `docs/adr/` at the repo root. Most repos are this.
+- **Multi-context** — `CONTEXT-MAP.md` at the root pointing to per-context `CONTEXT.md` files (typically a monorepo).
+
+### 3. Confirm and edit
+
+Show the user a draft of:
+
+- The `## Agent skills` block to add to whichever of `CLAUDE.md` / `AGENTS.md` is being edited (see step 4 for selection rules)
+- The contents of `docs/agents/issue-tracker.md`, `docs/agents/triage-labels.md`, `docs/agents/domain.md`
+
+Let them edit before writing.
+
+### 4. Write
+
+**Pick the file to edit:**
+
+- If `CLAUDE.md` exists, edit it.
+- Else if `AGENTS.md` exists, edit it.
+- If neither exists, ask the user which one to create — don't pick for them.
+
+Never create `AGENTS.md` when `CLAUDE.md` already exists (or vice versa) — always edit the one that's already there.
+
+If an `## Agent skills` block already exists in the chosen file, update its contents in-place rather than appending a duplicate. Don't overwrite user edits to the surrounding sections.
+
+The block:
+
+```markdown
+## Agent skills
+
+### Issue tracker
+
+[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
+```
+
+Then write the three docs files using the seed templates in this skill folder as a starting point:
+
+- [issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker
+- [issue-tracker-gitlab.md](./issue-tracker-gitlab.md) — GitLab issue tracker
+- [issue-tracker-local.md](./issue-tracker-local.md) — local-markdown issue tracker
+- [triage-labels.md](./triage-labels.md) — label mapping
+- [domain.md](./domain.md) — domain doc consumer rules + layout
+
+For "other" issue trackers, write `docs/agents/issue-tracker.md` from scratch using the user's description.
+
+### 5. Done
+
+Tell the user the setup is complete and which engineering skills will now read from these files. Mention they can edit `docs/agents/*.md` directly later — re-running this skill is only necessary if they want to switch issue trackers or restart from scratch.
diff --git a/.kiro/skills/setup-matt-pocock-skills/domain.md b/.kiro/skills/setup-matt-pocock-skills/domain.md
new file mode 100644
index 0000000..c97d6a6
--- /dev/null
+++ b/.kiro/skills/setup-matt-pocock-skills/domain.md
@@ -0,0 +1,51 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT.md`** at the repo root, or
+- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The producer skill (`/grill-with-docs`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo (most repos):
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-event-sourced-orders.md
+│   └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/adr/                          ← system-wide decisions
+└── src/
+    ├── ordering/
+    │   ├── CONTEXT.md
+    │   └── docs/adr/                  ← context-specific decisions
+    └── billing/
+        ├── CONTEXT.md
+        └── docs/adr/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/grill-with-docs`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_
diff --git a/.kiro/skills/setup-matt-pocock-skills/issue-tracker-github.md b/.kiro/skills/setup-matt-pocock-skills/issue-tracker-github.md
new file mode 100644
index 0000000..cce77ec
--- /dev/null
+++ b/.kiro/skills/setup-matt-pocock-skills/issue-tracker-github.md
@@ -0,0 +1,22 @@
+# Issue tracker: GitHub
+
+Issues and PRDs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
+
+Infer the repo from `git remote -v` — `gh` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitHub issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `gh issue view <number> --comments`.
diff --git a/.kiro/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md b/.kiro/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
new file mode 100644
index 0000000..f54da95
--- /dev/null
+++ b/.kiro/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
@@ -0,0 +1,23 @@
+# Issue tracker: GitLab
+
+Issues and PRDs for this repo live as GitLab issues. Use the [`glab`](https://gitlab.com/gitlab-org/cli) CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `glab issue create --title "..." --description "..."`. Use a heredoc for multi-line descriptions. Pass `--description -` to open an editor.
+- **Read an issue**: `glab issue view <number> --comments`. Use `-F json` for machine-readable output.
+- **List issues**: `glab issue list -F json` with appropriate `--label` filters.
+- **Comment on an issue**: `glab issue note <number> --message "..."`. GitLab calls comments "notes".
+- **Apply / remove labels**: `glab issue update <number> --label "..."` / `--unlabel "..."`. Multiple labels can be comma-separated or by repeating the flag.
+- **Close**: `glab issue close <number>`. `glab issue close` does not accept a closing comment, so post the explanation first with `glab issue note <number> --message "..."`, then close.
+- **Merge requests**: GitLab calls PRs "merge requests". Use `glab mr create`, `glab mr view`, `glab mr note`, etc. — the same shape as `gh pr ...` with `mr` in place of `pr` and `note`/`--message` in place of `comment`/`--body`.
+
+Infer the repo from `git remote -v` — `glab` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitLab issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `glab issue view <number> --comments`.
diff --git a/.kiro/skills/setup-matt-pocock-skills/issue-tracker-local.md b/.kiro/skills/setup-matt-pocock-skills/issue-tracker-local.md
new file mode 100644
index 0000000..a2f08fb
--- /dev/null
+++ b/.kiro/skills/setup-matt-pocock-skills/issue-tracker-local.md
@@ -0,0 +1,19 @@
+# Issue tracker: Local Markdown
+
+Issues and PRDs for this repo live as markdown files in `.scratch/`.
+
+## Conventions
+
+- One feature per directory: `.scratch/<feature-slug>/`
+- The PRD is `.scratch/<feature-slug>/PRD.md`
+- Implementation issues are `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01`
+- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
+- Comments and conversation history append to the bottom of the file under a `## Comments` heading
+
+## When a skill says "publish to the issue tracker"
+
+Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).
+
+## When a skill says "fetch the relevant ticket"
+
+Read the file at the referenced path. The user will normally pass the path or the issue number directly.
diff --git a/.kiro/skills/setup-matt-pocock-skills/triage-labels.md b/.kiro/skills/setup-matt-pocock-skills/triage-labels.md
new file mode 100644
index 0000000..b716855
--- /dev/null
+++ b/.kiro/skills/setup-matt-pocock-skills/triage-labels.md
@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.
diff --git a/.kiro/skills/tdd/SKILL.md b/.kiro/skills/tdd/SKILL.md
new file mode 100644
index 0000000..7a98941
--- /dev/null
+++ b/.kiro/skills/tdd/SKILL.md
@@ -0,0 +1,109 @@
+---
+name: tdd
+description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
+---
+
+# Test-Driven Development
+
+## Philosophy
+
+**Core principle**: Tests should verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't.
+
+**Good tests** are integration-style: they exercise real code paths through public APIs. They describe _what_ the system does, not _how_ it does it. A good test reads like a specification - "user can checkout with valid cart" tells you exactly what capability exists. These tests survive refactors because they don't care about internal structure.
+
+**Bad tests** are coupled to implementation. They mock internal collaborators, test private methods, or verify through external means (like querying a database directly instead of using the interface). The warning sign: your test breaks when you refactor, but behavior hasn't changed. If you rename an internal function and tests fail, those tests were testing implementation, not behavior.
+
+See [tests.md](tests.md) for examples and [mocking.md](mocking.md) for mocking guidelines.
+
+## Anti-Pattern: Horizontal Slices
+
+**DO NOT write all tests first, then all implementation.** This is "horizontal slicing" - treating RED as "write all tests" and GREEN as "write all code."
+
+This produces **crap tests**:
+
+- Tests written in bulk test _imagined_ behavior, not _actual_ behavior
+- You end up testing the _shape_ of things (data structures, function signatures) rather than user-facing behavior
+- Tests become insensitive to real changes - they pass when behavior breaks, fail when behavior is fine
+- You outrun your headlights, committing to test structure before understanding the implementation
+
+**Correct approach**: Vertical slices via tracer bullets. One test → one implementation → repeat. Each test responds to what you learned from the previous cycle. Because you just wrote the code, you know exactly what behavior matters and how to verify it.
+
+```
+WRONG (horizontal):
+  RED:   test1, test2, test3, test4, test5
+  GREEN: impl1, impl2, impl3, impl4, impl5
+
+RIGHT (vertical):
+  RED→GREEN: test1→impl1
+  RED→GREEN: test2→impl2
+  RED→GREEN: test3→impl3
+  ...
+```
+
+## Workflow
+
+### 1. Planning
+
+When exploring the codebase, use the project's domain glossary so that test names and interface vocabulary match the project's language, and respect ADRs in the area you're touching.
+
+Before writing any code:
+
+- [ ] Confirm with user what interface changes are needed
+- [ ] Confirm with user which behaviors to test (prioritize)
+- [ ] Identify opportunities for [deep modules](deep-modules.md) (small interface, deep implementation)
+- [ ] Design interfaces for [testability](interface-design.md)
+- [ ] List the behaviors to test (not implementation steps)
+- [ ] Get user approval on the plan
+
+Ask: "What should the public interface look like? Which behaviors are most important to test?"
+
+**You can't test everything.** Confirm with the user exactly which behaviors matter most. Focus testing effort on critical paths and complex logic, not every possible edge case.
+
+### 2. Tracer Bullet
+
+Write ONE test that confirms ONE thing about the system:
+
+```
+RED:   Write test for first behavior → test fails
+GREEN: Write minimal code to pass → test passes
+```
+
+This is your tracer bullet - proves the path works end-to-end.
+
+### 3. Incremental Loop
+
+For each remaining behavior:
+
+```
+RED:   Write next test → fails
+GREEN: Minimal code to pass → passes
+```
+
+Rules:
+
+- One test at a time
+- Only enough code to pass current test
+- Don't anticipate future tests
+- Keep tests focused on observable behavior
+
+### 4. Refactor
+
+After all tests pass, look for [refactor candidates](refactoring.md):
+
+- [ ] Extract duplication
+- [ ] Deepen modules (move complexity behind simple interfaces)
+- [ ] Apply SOLID principles where natural
+- [ ] Consider what new code reveals about existing code
+- [ ] Run tests after each refactor step
+
+**Never refactor while RED.** Get to GREEN first.
+
+## Checklist Per Cycle
+
+```
+[ ] Test describes behavior, not implementation
+[ ] Test uses public interface only
+[ ] Test would survive internal refactor
+[ ] Code is minimal for this test
+[ ] No speculative features added
+```
diff --git a/.kiro/skills/tdd/deep-modules.md b/.kiro/skills/tdd/deep-modules.md
new file mode 100644
index 0000000..0d9720c
--- /dev/null
+++ b/.kiro/skills/tdd/deep-modules.md
@@ -0,0 +1,33 @@
+# Deep Modules
+
+From "A Philosophy of Software Design":
+
+**Deep module** = small interface + lots of implementation
+
+```
+┌─────────────────────┐
+│   Small Interface   │  ← Few methods, simple params
+├─────────────────────┤
+│                     │
+│                     │
+│  Deep Implementation│  ← Complex logic hidden
+│                     │
+│                     │
+└─────────────────────┘
+```
+
+**Shallow module** = large interface + little implementation (avoid)
+
+```
+┌─────────────────────────────────┐
+│       Large Interface           │  ← Many methods, complex params
+├─────────────────────────────────┤
+│  Thin Implementation            │  ← Just passes through
+└─────────────────────────────────┘
+```
+
+When designing interfaces, ask:
+
+- Can I reduce the number of methods?
+- Can I simplify the parameters?
+- Can I hide more complexity inside?
diff --git a/.kiro/skills/tdd/interface-design.md b/.kiro/skills/tdd/interface-design.md
new file mode 100644
index 0000000..a0a20ca
--- /dev/null
+++ b/.kiro/skills/tdd/interface-design.md
@@ -0,0 +1,31 @@
+# Interface Design for Testability
+
+Good interfaces make testing natural:
+
+1. **Accept dependencies, don't create them**
+
+   ```typescript
+   // Testable
+   function processOrder(order, paymentGateway) {}
+
+   // Hard to test
+   function processOrder(order) {
+     const gateway = new StripeGateway();
+   }
+   ```
+
+2. **Return results, don't produce side effects**
+
+   ```typescript
+   // Testable
+   function calculateDiscount(cart): Discount {}
+
+   // Hard to test
+   function applyDiscount(cart): void {
+     cart.total -= discount;
+   }
+   ```
+
+3. **Small surface area**
+   - Fewer methods = fewer tests needed
+   - Fewer params = simpler test setup
diff --git a/.kiro/skills/tdd/mocking.md b/.kiro/skills/tdd/mocking.md
new file mode 100644
index 0000000..71cbfee
--- /dev/null
+++ b/.kiro/skills/tdd/mocking.md
@@ -0,0 +1,59 @@
+# When to Mock
+
+Mock at **system boundaries** only:
+
+- External APIs (payment, email, etc.)
+- Databases (sometimes - prefer test DB)
+- Time/randomness
+- File system (sometimes)
+
+Don't mock:
+
+- Your own classes/modules
+- Internal collaborators
+- Anything you control
+
+## Designing for Mockability
+
+At system boundaries, design interfaces that are easy to mock:
+
+**1. Use dependency injection**
+
+Pass external dependencies in rather than creating them internally:
+
+```typescript
+// Easy to mock
+function processPayment(order, paymentClient) {
+  return paymentClient.charge(order.total);
+}
+
+// Hard to mock
+function processPayment(order) {
+  const client = new StripeClient(process.env.STRIPE_KEY);
+  return client.charge(order.total);
+}
+```
+
+**2. Prefer SDK-style interfaces over generic fetchers**
+
+Create specific functions for each external operation instead of one generic function with conditional logic:
+
+```typescript
+// GOOD: Each function is independently mockable
+const api = {
+  getUser: (id) => fetch(`/users/${id}`),
+  getOrders: (userId) => fetch(`/users/${userId}/orders`),
+  createOrder: (data) => fetch('/orders', { method: 'POST', body: data }),
+};
+
+// BAD: Mocking requires conditional logic inside the mock
+const api = {
+  fetch: (endpoint, options) => fetch(endpoint, options),
+};
+```
+
+The SDK approach means:
+- Each mock returns one specific shape
+- No conditional logic in test setup
+- Easier to see which endpoints a test exercises
+- Type safety per endpoint
diff --git a/.kiro/skills/tdd/refactoring.md b/.kiro/skills/tdd/refactoring.md
new file mode 100644
index 0000000..8a44439
--- /dev/null
+++ b/.kiro/skills/tdd/refactoring.md
@@ -0,0 +1,10 @@
+# Refactor Candidates
+
+After TDD cycle, look for:
+
+- **Duplication** → Extract function/class
+- **Long methods** → Break into private helpers (keep tests on public interface)
+- **Shallow modules** → Combine or deepen
+- **Feature envy** → Move logic to where data lives
+- **Primitive obsession** → Introduce value objects
+- **Existing code** the new code reveals as problematic
diff --git a/.kiro/skills/tdd/tests.md b/.kiro/skills/tdd/tests.md
new file mode 100644
index 0000000..ff22f80
--- /dev/null
+++ b/.kiro/skills/tdd/tests.md
@@ -0,0 +1,61 @@
+# Good and Bad Tests
+
+## Good Tests
+
+**Integration-style**: Test through real interfaces, not mocks of internal parts.
+
+```typescript
+// GOOD: Tests observable behavior
+test("user can checkout with valid cart", async () => {
+  const cart = createCart();
+  cart.add(product);
+  const result = await checkout(cart, paymentMethod);
+  expect(result.status).toBe("confirmed");
+});
+```
+
+Characteristics:
+
+- Tests behavior users/callers care about
+- Uses public API only
+- Survives internal refactors
+- Describes WHAT, not HOW
+- One logical assertion per test
+
+## Bad Tests
+
+**Implementation-detail tests**: Coupled to internal structure.
+
+```typescript
+// BAD: Tests implementation details
+test("checkout calls paymentService.process", async () => {
+  const mockPayment = jest.mock(paymentService);
+  await checkout(cart, payment);
+  expect(mockPayment.process).toHaveBeenCalledWith(cart.total);
+});
+```
+
+Red flags:
+
+- Mocking internal collaborators
+- Testing private methods
+- Asserting on call counts/order
+- Test breaks when refactoring without behavior change
+- Test name describes HOW not WHAT
+- Verifying through external means instead of interface
+
+```typescript
+// BAD: Bypasses interface to verify
+test("createUser saves to database", async () => {
+  await createUser({ name: "Alice" });
+  const row = await db.query("SELECT * FROM users WHERE name = ?", ["Alice"]);
+  expect(row).toBeDefined();
+});
+
+// GOOD: Verifies through interface
+test("createUser makes user retrievable", async () => {
+  const user = await createUser({ name: "Alice" });
+  const retrieved = await getUser(user.id);
+  expect(retrieved.name).toBe("Alice");
+});
+```
diff --git a/.kiro/skills/to-issues/SKILL.md b/.kiro/skills/to-issues/SKILL.md
new file mode 100644
index 0000000..9f6efbf
--- /dev/null
+++ b/.kiro/skills/to-issues/SKILL.md
@@ -0,0 +1,83 @@
+---
+name: to-issues
+description: Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
+---
+
+# To Issues
+
+Break a plan into independently-grabbable issues using vertical slices (tracer bullets).
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+### 1. Gather context
+
+Work from whatever is already in the conversation context. If the user passes an issue reference (issue number, URL, or path) as an argument, fetch it from the issue tracker and read its full body and comments.
+
+### 2. Explore the codebase (optional)
+
+If you have not already explored the codebase, do so to understand the current state of the code. Issue titles and descriptions should use the project's domain glossary vocabulary, and respect ADRs in the area you're touching.
+
+### 3. Draft vertical slices
+
+Break the plan into **tracer bullet** issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer.
+
+Slices may be 'HITL' or 'AFK'. HITL slices require human interaction, such as an architectural decision or a design review. AFK slices can be implemented and merged without human interaction. Prefer AFK over HITL where possible.
+
+<vertical-slice-rules>
+- Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests)
+- A completed slice is demoable or verifiable on its own
+- Prefer many thin slices over few thick ones
+</vertical-slice-rules>
+
+### 4. Quiz the user
+
+Present the proposed breakdown as a numbered list. For each slice, show:
+
+- **Title**: short descriptive name
+- **Type**: HITL / AFK
+- **Blocked by**: which other slices (if any) must complete first
+- **User stories covered**: which user stories this addresses (if the source material has them)
+
+Ask the user:
+
+- Does the granularity feel right? (too coarse / too fine)
+- Are the dependency relationships correct?
+- Should any slices be merged or split further?
+- Are the correct slices marked as HITL and AFK?
+
+Iterate until the user approves the breakdown.
+
+### 5. Publish the issues to the issue tracker
+
+For each approved slice, publish a new issue to the issue tracker. Use the issue body template below. These issues are considered ready for AFK agents, so publish them with the correct triage label unless instructed otherwise.
+
+Publish issues in dependency order (blockers first) so you can reference real issue identifiers in the "Blocked by" field.
+
+<issue-template>
+## Parent
+
+A reference to the parent issue on the issue tracker (if the source was an existing issue, otherwise omit this section).
+
+## What to build
+
+A concise description of this vertical slice. Describe the end-to-end behavior, not layer-by-layer implementation.
+
+Avoid specific file paths or code snippets — they go stale fast. Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it here and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Acceptance criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Blocked by
+
+- A reference to the blocking ticket (if any)
+
+Or "None - can start immediately" if no blockers.
+
+</issue-template>
+
+Do NOT close or modify any parent issue.
diff --git a/.kiro/skills/to-prd/SKILL.md b/.kiro/skills/to-prd/SKILL.md
new file mode 100644
index 0000000..47a01d4
--- /dev/null
+++ b/.kiro/skills/to-prd/SKILL.md
@@ -0,0 +1,76 @@
+---
+name: to-prd
+description: Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
+---
+
+This skill takes the current conversation context and codebase understanding and produces a PRD. Do NOT interview the user — just synthesize what you already know.
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+1. Explore the repo to understand the current state of the codebase, if you haven't already. Use the project's domain glossary vocabulary throughout the PRD, and respect any ADRs in the area you're touching.
+
+2. Sketch out the major modules you will need to build or modify to complete the implementation. Actively look for opportunities to extract deep modules that can be tested in isolation.
+
+A deep module (as opposed to a shallow module) is one which encapsulates a lot of functionality in a simple, testable interface which rarely changes.
+
+Check with the user that these modules match their expectations. Check with the user which modules they want tests written for.
+
+3. Write the PRD using the template below, then publish it to the project issue tracker. Apply the `ready-for-agent` triage label - no need for additional triage.
+
+<prd-template>
+
+## Problem Statement
+
+The problem that the user is facing, from the user's perspective.
+
+## Solution
+
+The solution to the problem, from the user's perspective.
+
+## User Stories
+
+A LONG, numbered list of user stories. Each user story should be in the format of:
+
+1. As an <actor>, I want a <feature>, so that <benefit>
+
+<user-story-example>
+1. As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending
+</user-story-example>
+
+This list of user stories should be extremely extensive and cover all aspects of the feature.
+
+## Implementation Decisions
+
+A list of implementation decisions that were made. This can include:
+
+- The modules that will be built/modified
+- The interfaces of those modules that will be modified
+- Technical clarifications from the developer
+- Architectural decisions
+- Schema changes
+- API contracts
+- Specific interactions
+
+Do NOT include specific file paths or code snippets. They may end up being outdated very quickly.
+
+Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it within the relevant decision and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Testing Decisions
+
+A list of testing decisions that were made. Include:
+
+- A description of what makes a good test (only test external behavior, not implementation details)
+- Which modules will be tested
+- Prior art for the tests (i.e. similar types of tests in the codebase)
+
+## Out of Scope
+
+A description of the things that are out of scope for this PRD.
+
+## Further Notes
+
+Any further notes about the feature.
+
+</prd-template>
diff --git a/.kiro/skills/triage/AGENT-BRIEF.md b/.kiro/skills/triage/AGENT-BRIEF.md
new file mode 100644
index 0000000..2efecdf
--- /dev/null
+++ b/.kiro/skills/triage/AGENT-BRIEF.md
@@ -0,0 +1,168 @@
+# Writing Agent Briefs
+
+An agent brief is a structured comment posted on a GitHub issue when it moves to `ready-for-agent`. It is the authoritative specification that an AFK agent will work from. The original issue body and discussion are context — the agent brief is the contract.
+
+## Principles
+
+### Durability over precision
+
+The issue may sit in `ready-for-agent` for days or weeks. The codebase will change in the meantime. Write the brief so it stays useful even as files are renamed, moved, or refactored.
+
+- **Do** describe interfaces, types, and behavioral contracts
+- **Do** name specific types, function signatures, or config shapes that the agent should look for or modify
+- **Don't** reference file paths — they go stale
+- **Don't** reference line numbers
+- **Don't** assume the current implementation structure will remain the same
+
+### Behavioral, not procedural
+
+Describe **what** the system should do, not **how** to implement it. The agent will explore the codebase fresh and make its own implementation decisions.
+
+- **Good:** "The `SkillConfig` type should accept an optional `schedule` field of type `CronExpression`"
+- **Bad:** "Open src/types/skill.ts and add a schedule field on line 42"
+- **Good:** "When a user runs `/triage` with no arguments, they should see a summary of issues needing attention"
+- **Bad:** "Add a switch statement in the main handler function"
+
+### Complete acceptance criteria
+
+The agent needs to know when it's done. Every agent brief must have concrete, testable acceptance criteria. Each criterion should be independently verifiable.
+
+- **Good:** "Running `gh issue list --label needs-triage` returns issues that have been through initial classification"
+- **Bad:** "Triage should work correctly"
+
+### Explicit scope boundaries
+
+State what is out of scope. This prevents the agent from gold-plating or making assumptions about adjacent features.
+
+## Template
+
+```markdown
+## Agent Brief
+
+**Category:** bug / enhancement
+**Summary:** one-line description of what needs to happen
+
+**Current behavior:**
+Describe what happens now. For bugs, this is the broken behavior.
+For enhancements, this is the status quo the feature builds on.
+
+**Desired behavior:**
+Describe what should happen after the agent's work is complete.
+Be specific about edge cases and error conditions.
+
+**Key interfaces:**
+- `TypeName` — what needs to change and why
+- `functionName()` return type — what it currently returns vs what it should return
+- Config shape — any new configuration options needed
+
+**Acceptance criteria:**
+- [ ] Specific, testable criterion 1
+- [ ] Specific, testable criterion 2
+- [ ] Specific, testable criterion 3
+
+**Out of scope:**
+- Thing that should NOT be changed or addressed in this issue
+- Adjacent feature that might seem related but is separate
+```
+
+## Examples
+
+### Good agent brief (bug)
+
+```markdown
+## Agent Brief
+
+**Category:** bug
+**Summary:** Skill description truncation drops mid-word, producing broken output
+
+**Current behavior:**
+When a skill description exceeds 1024 characters, it is truncated at exactly
+1024 characters regardless of word boundaries. This produces descriptions
+that end mid-word (e.g. "Use when the user wants to confi").
+
+**Desired behavior:**
+Truncation should break at the last word boundary before 1024 characters
+and append "..." to indicate truncation.
+
+**Key interfaces:**
+- The `SkillMetadata` type's `description` field — no type change needed,
+  but the validation/processing logic that populates it needs to respect
+  word boundaries
+- Any function that reads SKILL.md frontmatter and extracts the description
+
+**Acceptance criteria:**
+- [ ] Descriptions under 1024 chars are unchanged
+- [ ] Descriptions over 1024 chars are truncated at the last word boundary
+      before 1024 chars
+- [ ] Truncated descriptions end with "..."
+- [ ] The total length including "..." does not exceed 1024 chars
+
+**Out of scope:**
+- Changing the 1024 char limit itself
+- Multi-line description support
+```
+
+### Good agent brief (enhancement)
+
+```markdown
+## Agent Brief
+
+**Category:** enhancement
+**Summary:** Add `.out-of-scope/` directory support for tracking rejected feature requests
+
+**Current behavior:**
+When a feature request is rejected, the issue is closed with a `wontfix` label
+and a comment. There is no persistent record of the decision or reasoning.
+Future similar requests require the maintainer to recall or search for the
+prior discussion.
+
+**Desired behavior:**
+Rejected feature requests should be documented in `.out-of-scope/<concept>.md`
+files that capture the decision, reasoning, and links to all issues that
+requested the feature. When triaging new issues, these files should be
+checked for matches.
+
+**Key interfaces:**
+- Markdown file format in `.out-of-scope/` — each file should have a
+  `# Concept Name` heading, a `**Decision:**` line, a `**Reason:**` line,
+  and a `**Prior requests:**` list with issue links
+- The triage workflow should read all `.out-of-scope/*.md` files early
+  and match incoming issues against them by concept similarity
+
+**Acceptance criteria:**
+- [ ] Closing a feature as wontfix creates/updates a file in `.out-of-scope/`
+- [ ] The file includes the decision, reasoning, and link to the closed issue
+- [ ] If a matching `.out-of-scope/` file already exists, the new issue is
+      appended to its "Prior requests" list rather than creating a duplicate
+- [ ] During triage, existing `.out-of-scope/` files are checked and surfaced
+      when a new issue matches a prior rejection
+
+**Out of scope:**
+- Automated matching (human confirms the match)
+- Reopening previously rejected features
+- Bug reports (only enhancement rejections go to `.out-of-scope/`)
+```
+
+### Bad agent brief
+
+```markdown
+## Agent Brief
+
+**Summary:** Fix the triage bug
+
+**What to do:**
+The triage thing is broken. Look at the main file and fix it.
+The function around line 150 has the issue.
+
+**Files to change:**
+- src/triage/handler.ts (line 150)
+- src/types.ts (line 42)
+```
+
+This is bad because:
+- No category
+- Vague description ("the triage thing is broken")
+- References file paths and line numbers that will go stale
+- No acceptance criteria
+- No scope boundaries
+- No description of current vs desired behavior
diff --git a/.kiro/skills/triage/OUT-OF-SCOPE.md b/.kiro/skills/triage/OUT-OF-SCOPE.md
new file mode 100644
index 0000000..cc8ea25
--- /dev/null
+++ b/.kiro/skills/triage/OUT-OF-SCOPE.md
@@ -0,0 +1,101 @@
+# Out-of-Scope Knowledge Base
+
+The `.out-of-scope/` directory in a repo stores persistent records of rejected feature requests. It serves two purposes:
+
+1. **Institutional memory** — why a feature was rejected, so the reasoning isn't lost when the issue is closed
+2. **Deduplication** — when a new issue comes in that matches a prior rejection, the skill can surface the previous decision instead of re-litigating it
+
+## Directory structure
+
+```
+.out-of-scope/
+├── dark-mode.md
+├── plugin-system.md
+└── graphql-api.md
+```
+
+One file per **concept**, not per issue. Multiple issues requesting the same thing are grouped under one file.
+
+## File format
+
+The file should be written in a relaxed, readable style — more like a short design document than a database entry. Use paragraphs, code samples, and examples to make the reasoning clear and useful to someone encountering it for the first time.
+
+```markdown
+# Dark Mode
+
+This project does not support dark mode or user-facing theming.
+
+## Why this is out of scope
+
+The rendering pipeline assumes a single color palette defined in
+`ThemeConfig`. Supporting multiple themes would require:
+
+- A theme context provider wrapping the entire component tree
+- Per-component theme-aware style resolution
+- A persistence layer for user theme preferences
+
+This is a significant architectural change that doesn't align with the
+project's focus on content authoring. Theming is a concern for downstream
+consumers who embed or redistribute the output.
+
+```ts
+// The current ThemeConfig interface is not designed for runtime switching:
+interface ThemeConfig {
+  colors: ColorPalette; // single palette, resolved at build time
+  fonts: FontStack;
+}
+```
+
+## Prior requests
+
+- #42 — "Add dark mode support"
+- #87 — "Night theme for accessibility"
+- #134 — "Dark theme option"
+```
+
+### Naming the file
+
+Use a short, descriptive kebab-case name for the concept: `dark-mode.md`, `plugin-system.md`, `graphql-api.md`. The name should be recognizable enough that someone browsing the directory understands what was rejected without opening the file.
+
+### Writing the reason
+
+The reason should be substantive — not "we don't want this" but why. Good reasons reference:
+
+- Project scope or philosophy ("This project focuses on X; theming is a downstream concern")
+- Technical constraints ("Supporting this would require Y, which conflicts with our Z architecture")
+- Strategic decisions ("We chose to use A instead of B because...")
+
+The reason should be durable. Avoid referencing temporary circumstances ("we're too busy right now") — those aren't real rejections, they're deferrals.
+
+## When to check `.out-of-scope/`
+
+During triage (Step 1: Gather context), read all files in `.out-of-scope/`. When evaluating a new issue:
+
+- Check if the request matches an existing out-of-scope concept
+- Matching is by concept similarity, not keyword — "night theme" matches `dark-mode.md`
+- If there's a match, surface it to the maintainer: "This is similar to `.out-of-scope/dark-mode.md` — we rejected this before because [reason]. Do you still feel the same way?"
+
+The maintainer may:
+
+- **Confirm** — the new issue gets added to the existing file's "Prior requests" list, then closed
+- **Reconsider** — the out-of-scope file gets deleted or updated, and the issue proceeds through normal triage
+- **Disagree** — the issues are related but distinct, proceed with normal triage
+
+## When to write to `.out-of-scope/`
+
+Only when an **enhancement** (not a bug) is rejected as `wontfix`. The flow:
+
+1. Maintainer decides a feature request is out of scope
+2. Check if a matching `.out-of-scope/` file already exists
+3. If yes: append the new issue to the "Prior requests" list
+4. If no: create a new file with the concept name, decision, reason, and first prior request
+5. Post a comment on the issue explaining the decision and mentioning the `.out-of-scope/` file
+6. Close the issue with the `wontfix` label
+
+## Updating or removing out-of-scope files
+
+If the maintainer changes their mind about a previously rejected concept:
+
+- Delete the `.out-of-scope/` file
+- The skill does not need to reopen old issues — they're historical records
+- The new issue that triggered the reconsideration proceeds through normal triage
diff --git a/.kiro/skills/triage/SKILL.md b/.kiro/skills/triage/SKILL.md
new file mode 100644
index 0000000..3dee68f
--- /dev/null
+++ b/.kiro/skills/triage/SKILL.md
@@ -0,0 +1,103 @@
+---
+name: triage
+description: Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
+---
+
+# Triage
+
+Move issues on the project issue tracker through a small state machine of triage roles.
+
+Every comment or issue posted to the issue tracker during triage **must** start with this disclaimer:
+
+```
+> *This was generated by AI during triage.*
+```
+
+## Reference docs
+
+- [AGENT-BRIEF.md](AGENT-BRIEF.md) — how to write durable agent briefs
+- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — how the `.out-of-scope/` knowledge base works
+
+## Roles
+
+Two **category** roles:
+
+- `bug` — something is broken
+- `enhancement` — new feature or improvement
+
+Five **state** roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter for more information
+- `ready-for-agent` — fully specified, ready for an AFK agent
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Every triaged issue should carry exactly one category role and one state role. If state roles conflict, flag it and ask the maintainer before doing anything else.
+
+These are canonical role names — the actual label strings used in the issue tracker may differ. The mapping should have been provided to you - run `/setup-matt-pocock-skills` if not.
+
+State transitions: an unlabeled issue normally goes to `needs-triage` first; from there it moves to `needs-info`, `ready-for-agent`, `ready-for-human`, or `wontfix`. `needs-info` returns to `needs-triage` once the reporter replies. The maintainer can override at any time — flag transitions that look unusual and ask before proceeding.
+
+## Invocation
+
+The maintainer invokes `/triage` and describes what they want in natural language. Interpret the request and act. Examples:
+
+- "Show me anything that needs my attention"
+- "Let's look at #42"
+- "Move #42 to ready-for-agent"
+- "What's ready for agents to pick up?"
+
+## Show what needs attention
+
+Query the issue tracker and present three buckets, oldest first:
+
+1. **Unlabeled** — never triaged.
+2. **`needs-triage`** — evaluation in progress.
+3. **`needs-info` with reporter activity since the last triage notes** — needs re-evaluation.
+
+Show counts and a one-line summary per issue. Let the maintainer pick.
+
+## Triage a specific issue
+
+1. **Gather context.** Read the full issue (body, comments, labels, reporter, dates). Parse any prior triage notes so you don't re-ask resolved questions. Explore the codebase using the project's domain glossary, respecting ADRs in the area. Read `.out-of-scope/*.md` and surface any prior rejection that resembles this issue.
+
+2. **Recommend.** Tell the maintainer your category and state recommendation with reasoning, plus a brief codebase summary relevant to the issue. Wait for direction.
+
+3. **Reproduce (bugs only).** Before any grilling, attempt reproduction: read the reporter's steps, trace the relevant code, run tests or commands. Report what happened — successful repro with code path, failed repro, or insufficient detail (a strong `needs-info` signal). A confirmed repro makes a much stronger agent brief.
+
+4. **Grill (if needed).** If the issue needs fleshing out, run a `/grill-with-docs` session.
+
+5. **Apply the outcome:**
+   - `ready-for-agent` — post an agent brief comment ([AGENT-BRIEF.md](AGENT-BRIEF.md)).
+   - `ready-for-human` — same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing).
+   - `needs-info` — post triage notes (template below).
+   - `wontfix` (bug) — polite explanation, then close.
+   - `wontfix` (enhancement) — write to `.out-of-scope/`, link to it from a comment, then close ([OUT-OF-SCOPE.md](OUT-OF-SCOPE.md)).
+   - `needs-triage` — apply the role. Optional comment if there's partial progress.
+
+## Quick state override
+
+If the maintainer says "move #42 to ready-for-agent", trust them and apply the role directly. Confirm what you're about to do (role changes, comment, close), then act. Skip grilling. If moving to `ready-for-agent` without a grilling session, ask whether they want to write an agent brief.
+
+## Needs-info template
+
+```markdown
+## Triage Notes
+
+**What we've established so far:**
+
+- point 1
+- point 2
+
+**What we still need from you (@reporter):**
+
+- question 1
+- question 2
+```
+
+Capture everything resolved during grilling under "established so far" so the work isn't lost. Questions must be specific and actionable, not "please provide more info".
+
+## Resuming a previous session
+
+If prior triage notes exist on the issue, read them, check whether the reporter has answered any outstanding questions, and present an updated picture before continuing. Don't re-ask resolved questions.
diff --git a/.kiro/skills/write-a-skill/SKILL.md b/.kiro/skills/write-a-skill/SKILL.md
new file mode 100644
index 0000000..7339c8a
--- /dev/null
+++ b/.kiro/skills/write-a-skill/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: write-a-skill
+description: Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
+---
+
+# Writing Skills
+
+## Process
+
+1. **Gather requirements** - ask user about:
+   - What task/domain does the skill cover?
+   - What specific use cases should it handle?
+   - Does it need executable scripts or just instructions?
+   - Any reference materials to include?
+
+2. **Draft the skill** - create:
+   - SKILL.md with concise instructions
+   - Additional reference files if content exceeds 500 lines
+   - Utility scripts if deterministic operations needed
+
+3. **Review with user** - present draft and ask:
+   - Does this cover your use cases?
+   - Anything missing or unclear?
+   - Should any section be more/less detailed?
+
+## Skill Structure
+
+```
+skill-name/
+├── SKILL.md           # Main instructions (required)
+├── REFERENCE.md       # Detailed docs (if needed)
+├── EXAMPLES.md        # Usage examples (if needed)
+└── scripts/           # Utility scripts (if needed)
+    └── helper.js
+```
+
+## SKILL.md Template
+
+```md
+---
+name: skill-name
+description: Brief description of capability. Use when [specific triggers].
+---
+
+# Skill Name
+
+## Quick start
+
+[Minimal working example]
+
+## Workflows
+
+[Step-by-step processes with checklists for complex tasks]
+
+## Advanced features
+
+[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
+```
+
+## Description Requirements
+
+The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
+
+**Goal**: Give your agent just enough info to know:
+
+1. What capability this skill provides
+2. When/why to trigger it (specific keywords, contexts, file types)
+
+**Format**:
+
+- Max 1024 chars
+- Write in third person
+- First sentence: what it does
+- Second sentence: "Use when [specific triggers]"
+
+**Good example**:
+
+```
+Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
+```
+
+**Bad example**:
+
+```
+Helps with documents.
+```
+
+The bad example gives your agent no way to distinguish this from other document skills.
+
+## When to Add Scripts
+
+Add utility scripts when:
+
+- Operation is deterministic (validation, formatting)
+- Same code would be generated repeatedly
+- Errors need explicit handling
+
+Scripts save tokens and improve reliability vs generated code.
+
+## When to Split Files
+
+Split into separate files when:
+
+- SKILL.md exceeds 100 lines
+- Content has distinct domains (finance vs sales schemas)
+- Advanced features are rarely needed
+
+## Review Checklist
+
+After drafting, verify:
+
+- [ ] Description includes triggers ("Use when...")
+- [ ] SKILL.md under 100 lines
+- [ ] No time-sensitive info
+- [ ] Consistent terminology
+- [ ] Concrete examples included
+- [ ] References one level deep
diff --git a/.kiro/skills/zoom-out/SKILL.md b/.kiro/skills/zoom-out/SKILL.md
new file mode 100644
index 0000000..1e7a5dc
--- /dev/null
+++ b/.kiro/skills/zoom-out/SKILL.md
@@ -0,0 +1,7 @@
+---
+name: zoom-out
+description: Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
+disable-model-invocation: true
+---
+
+I don't know this area of code well. Go up a layer of abstraction. Give me a map of all the relevant modules and callers, using the project's domain glossary vocabulary.
diff --git a/.windsurf/skills/caveman/SKILL.md b/.windsurf/skills/caveman/SKILL.md
new file mode 100644
index 0000000..85770a3
--- /dev/null
+++ b/.windsurf/skills/caveman/SKILL.md
@@ -0,0 +1,49 @@
+---
+name: caveman
+description: >
+  Ultra-compressed communication mode. Cuts token usage ~75% by dropping
+  filler, articles, and pleasantries while keeping full technical accuracy.
+  Use when user says "caveman mode", "talk like caveman", "use caveman",
+  "less tokens", "be brief", or invokes /caveman.
+---
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode".
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough.
+
+Technical terms stay exact. Code blocks unchanged. Errors quoted exact.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+### Examples
+
+**"Why React component re-render?"**
+
+> Inline obj prop -> new ref -> re-render. `useMemo`.
+
+**"Explain database connection pooling."**
+
+> Pool = reuse DB conn. Skip handshake -> fast under load.
+
+## Auto-Clarity Exception
+
+Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
+
+Example -- destructive op:
+
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+>
+> ```sql
+> DROP TABLE users;
+> ```
+>
+> Caveman resume. Verify backup exist first.
diff --git a/.windsurf/skills/diagnose/SKILL.md b/.windsurf/skills/diagnose/SKILL.md
new file mode 100644
index 0000000..ed55bda
--- /dev/null
+++ b/.windsurf/skills/diagnose/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: diagnose
+description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
+---
+
+# Diagnose
+
+A discipline for hard bugs. Skip phases only when explicitly justified.
+
+When exploring the codebase, use the project's domain glossary to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.
+
+## Phase 1 — Build a feedback loop
+
+**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you.
+
+Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.**
+
+### Ways to construct one — try them in roughly this order
+
+1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.
+2. **Curl / HTTP script** against a running dev server.
+3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.
+4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network.
+5. **Replay a captured trace.** Save a real network request / payload / event log to disk; replay it through the code path in isolation.
+6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that exercises the bug code path with a single function call.
+7. **Property / fuzz loop.** If the bug is "sometimes wrong output", run 1000 random inputs and look for the failure mode.
+8. **Bisection harness.** If the bug appeared between two known states (commit, dataset, version), automate "boot at state X, check, repeat" so you can `git bisect run` it.
+9. **Differential loop.** Run the same input through old-version vs new-version (or two configs) and diff outputs.
+10. **HITL bash script.** Last resort. If a human must click, drive _them_ with `scripts/hitl-loop.template.sh` so the loop is still structured. Captured output feeds back to you.
+
+Build the right feedback loop, and the bug is 90% fixed.
+
+### Iterate on the loop itself
+
+Treat the loop as a product. Once you have _a_ loop, ask:
+
+- Can I make it faster? (Cache setup, skip unrelated init, narrow the test scope.)
+- Can I make the signal sharper? (Assert on the specific symptom, not "didn't crash".)
+- Can I make it more deterministic? (Pin time, seed RNG, isolate filesystem, freeze network.)
+
+A 30-second flaky loop is barely better than no loop. A 2-second deterministic loop is a debugging superpower.
+
+### Non-deterministic bugs
+
+The goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×, parallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake bug is debuggable; 1% is not — keep raising the rate until it's debuggable.
+
+### When you genuinely cannot build a loop
+
+Stop and say so explicitly. List what you tried. Ask the user for: (a) access to whatever environment reproduces it, (b) a captured artifact (HAR file, log dump, core dump, screen recording with timestamps), or (c) permission to add temporary production instrumentation. Do **not** proceed to hypothesise without a loop.
+
+Do not proceed to Phase 2 until you have a loop you believe in.
+
+## Phase 2 — Reproduce
+
+Run the loop. Watch the bug appear.
+
+Confirm:
+
+- [ ] The loop produces the failure mode the **user** described — not a different failure that happens to be nearby. Wrong bug = wrong fix.
+- [ ] The failure is reproducible across multiple runs (or, for non-deterministic bugs, reproducible at a high enough rate to debug against).
+- [ ] You have captured the exact symptom (error message, wrong output, slow timing) so later phases can verify the fix actually addresses it.
+
+Do not proceed until you reproduce the bug.
+
+## Phase 3 — Hypothesise
+
+Generate **3–5 ranked hypotheses** before testing any of them. Single-hypothesis generation anchors on the first plausible idea.
+
+Each hypothesis must be **falsifiable**: state the prediction it makes.
+
+> Format: "If <X> is the cause, then <changing Y> will make the bug disappear / <changing Z> will make it worse."
+
+If you cannot state the prediction, the hypothesis is a vibe — discard or sharpen it.
+
+**Show the ranked list to the user before testing.** They often have domain knowledge that re-ranks instantly ("we just deployed a change to #3"), or know hypotheses they've already ruled out. Cheap checkpoint, big time saver. Don't block on it — proceed with your ranking if the user is AFK.
+
+## Phase 4 — Instrument
+
+Each probe must map to a specific prediction from Phase 3. **Change one variable at a time.**
+
+Tool preference:
+
+1. **Debugger / REPL inspection** if the env supports it. One breakpoint beats ten logs.
+2. **Targeted logs** at the boundaries that distinguish hypotheses.
+3. Never "log everything and grep".
+
+**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep. Untagged logs survive; tagged logs die.
+
+**Perf branch.** For performance regressions, logs are usually wrong. Instead: establish a baseline measurement (timing harness, `performance.now()`, profiler, query plan), then bisect. Measure first, fix second.
+
+## Phase 5 — Fix + regression test
+
+Write the regression test **before the fix** — but only if there is a **correct seam** for it.
+
+A correct seam is one where the test exercises the **real bug pattern** as it occurs at the call site. If the only available seam is too shallow (single-caller test when the bug needs multiple callers, unit test that can't replicate the chain that triggered the bug), a regression test there gives false confidence.
+
+**If no correct seam exists, that itself is the finding.** Note it. The codebase architecture is preventing the bug from being locked down. Flag this for the next phase.
+
+If a correct seam exists:
+
+1. Turn the minimised repro into a failing test at that seam.
+2. Watch it fail.
+3. Apply the fix.
+4. Watch it pass.
+5. Re-run the Phase 1 feedback loop against the original (un-minimised) scenario.
+
+## Phase 6 — Cleanup + post-mortem
+
+Required before declaring done:
+
+- [ ] Original repro no longer reproduces (re-run the Phase 1 loop)
+- [ ] Regression test passes (or absence of seam is documented)
+- [ ] All `[DEBUG-...]` instrumentation removed (`grep` the prefix)
+- [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location)
+- [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns
+
+**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started.
diff --git a/.windsurf/skills/diagnose/scripts/hitl-loop.template.sh b/.windsurf/skills/diagnose/scripts/hitl-loop.template.sh
new file mode 100644
index 0000000..40afc46
--- /dev/null
+++ b/.windsurf/skills/diagnose/scripts/hitl-loop.template.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Human-in-the-loop reproduction loop.
+# Copy this file, edit the steps below, and run it.
+# The agent runs the script; the user follows prompts in their terminal.
+#
+# Usage:
+#   bash hitl-loop.template.sh
+#
+# Two helpers:
+#   step "<instruction>"          → show instruction, wait for Enter
+#   capture VAR "<question>"      → show question, read response into VAR
+#
+# At the end, captured values are printed as KEY=VALUE for the agent to parse.
+
+set -euo pipefail
+
+step() {
+  printf '\n>>> %s\n' "$1"
+  read -r -p "    [Enter when done] " _
+}
+
+capture() {
+  local var="$1" question="$2" answer
+  printf '\n>>> %s\n' "$question"
+  read -r -p "    > " answer
+  printf -v "$var" '%s' "$answer"
+}
+
+# --- edit below ---------------------------------------------------------
+
+step "Open the app at http://localhost:3000 and sign in."
+
+capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)"
+
+capture ERROR_MSG "Paste the error message (or 'none'):"
+
+# --- edit above ---------------------------------------------------------
+
+printf '\n--- Captured ---\n'
+printf 'ERRORED=%s\n' "$ERRORED"
+printf 'ERROR_MSG=%s\n' "$ERROR_MSG"
diff --git a/.windsurf/skills/grill-me/SKILL.md b/.windsurf/skills/grill-me/SKILL.md
new file mode 100644
index 0000000..bd04394
--- /dev/null
+++ b/.windsurf/skills/grill-me/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: grill-me
+description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
+---
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
diff --git a/.windsurf/skills/grill-with-docs/ADR-FORMAT.md b/.windsurf/skills/grill-with-docs/ADR-FORMAT.md
new file mode 100644
index 0000000..da7e78e
--- /dev/null
+++ b/.windsurf/skills/grill-with-docs/ADR-FORMAT.md
@@ -0,0 +1,47 @@
+# ADR Format
+
+ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
+
+Create the `docs/adr/` directory lazily — only when the first ADR is needed.
+
+## Template
+
+```md
+# {Short title of the decision}
+
+{1-3 sentences: what's the context, what did we decide, and why.}
+```
+
+That's it. An ADR can be a single paragraph. The value is in recording *that* a decision was made and *why* — not in filling out sections.
+
+## Optional sections
+
+Only include these when they add genuine value. Most ADRs won't need them.
+
+- **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited
+- **Considered Options** — only when the rejected alternatives are worth remembering
+- **Consequences** — only when non-obvious downstream effects need to be called out
+
+## Numbering
+
+Scan `docs/adr/` for the highest existing number and increment by one.
+
+## When to offer an ADR
+
+All three of these must be true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing."
+
+### What qualifies
+
+- **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres."
+- **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP."
+- **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out.
+- **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s.
+- **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate.
+- **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract."
+- **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months.
diff --git a/.windsurf/skills/grill-with-docs/CONTEXT-FORMAT.md b/.windsurf/skills/grill-with-docs/CONTEXT-FORMAT.md
new file mode 100644
index 0000000..ddfa247
--- /dev/null
+++ b/.windsurf/skills/grill-with-docs/CONTEXT-FORMAT.md
@@ -0,0 +1,77 @@
+# CONTEXT.md Format
+
+## Structure
+
+```md
+# {Context Name}
+
+{One or two sentence description of what this context is and why it exists.}
+
+## Language
+
+**Order**:
+{A concise description of the term}
+_Avoid_: Purchase, transaction
+
+**Invoice**:
+A request for payment sent to a customer after delivery.
+_Avoid_: Bill, payment request
+
+**Customer**:
+A person or organization that places orders.
+_Avoid_: Client, buyer, account
+
+## Relationships
+
+- An **Order** produces one or more **Invoices**
+- An **Invoice** belongs to exactly one **Customer**
+
+## Example dialogue
+
+> **Dev:** "When a **Customer** places an **Order**, do we create the **Invoice** immediately?"
+> **Domain expert:** "No — an **Invoice** is only generated once a **Fulfillment** is confirmed."
+
+## Flagged ambiguities
+
+- "account" was used to mean both **Customer** and **User** — resolved: these are distinct concepts.
+```
+
+## Rules
+
+- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others as aliases to avoid.
+- **Flag conflicts explicitly.** If a term is used ambiguously, call it out in "Flagged ambiguities" with a clear resolution.
+- **Keep definitions tight.** One sentence max. Define what it IS, not what it does.
+- **Show relationships.** Use bold term names and express cardinality where obvious.
+- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs.
+- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine.
+- **Write an example dialogue.** A conversation between a dev and a domain expert that demonstrates how the terms interact naturally and clarifies boundaries between related concepts.
+
+## Single vs multi-context repos
+
+**Single context (most repos):** One `CONTEXT.md` at the repo root.
+
+**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other:
+
+```md
+# Context Map
+
+## Contexts
+
+- [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders
+- [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments
+- [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping
+
+## Relationships
+
+- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking
+- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices
+- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
+```
+
+The skill infers which structure applies:
+
+- If `CONTEXT-MAP.md` exists, read it to find contexts
+- If only a root `CONTEXT.md` exists, single context
+- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
+
+When multiple contexts exist, infer which one the current topic relates to. If unclear, ask.
diff --git a/.windsurf/skills/grill-with-docs/SKILL.md b/.windsurf/skills/grill-with-docs/SKILL.md
new file mode 100644
index 0000000..5ea0aa9
--- /dev/null
+++ b/.windsurf/skills/grill-with-docs/SKILL.md
@@ -0,0 +1,88 @@
+---
+name: grill-with-docs
+description: Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
+---
+
+<what-to-do>
+
+Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time, waiting for feedback on each question before continuing.
+
+If a question can be answered by exploring the codebase, explore the codebase instead.
+
+</what-to-do>
+
+<supporting-info>
+
+## Domain awareness
+
+During codebase exploration, also look for existing documentation:
+
+### File structure
+
+Most repos have a single context:
+
+```
+/
+├── CONTEXT.md
+├── docs/
+│   └── adr/
+│       ├── 0001-event-sourced-orders.md
+│       └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/
+│   └── adr/                          ← system-wide decisions
+├── src/
+│   ├── ordering/
+│   │   ├── CONTEXT.md
+│   │   └── docs/adr/                 ← context-specific decisions
+│   └── billing/
+│       ├── CONTEXT.md
+│       └── docs/adr/
+```
+
+Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
+
+## During the session
+
+### Challenge against the glossary
+
+When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"
+
+### Sharpen fuzzy language
+
+When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things."
+
+### Discuss concrete scenarios
+
+When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.
+
+### Cross-reference with code
+
+When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible — which is right?"
+
+### Update CONTEXT.md inline
+
+When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).
+
+`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
+
+### Offer ADRs sparingly
+
+Only offer to create an ADR when all three are true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will wonder "why did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md).
+
+</supporting-info>
diff --git a/.windsurf/skills/handoff/SKILL.md b/.windsurf/skills/handoff/SKILL.md
new file mode 100644
index 0000000..28bfb3a
--- /dev/null
+++ b/.windsurf/skills/handoff/SKILL.md
@@ -0,0 +1,13 @@
+---
+name: handoff
+description: Compact the current conversation into a handoff document for another agent to pick up.
+argument-hint: "What will the next session be used for?"
+---
+
+Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it).
+
+Suggest the skills to be used, if any, by the next session.
+
+Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+
+If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
diff --git a/.windsurf/skills/improve-codebase-architecture/DEEPENING.md b/.windsurf/skills/improve-codebase-architecture/DEEPENING.md
new file mode 100644
index 0000000..ecaf5d7
--- /dev/null
+++ b/.windsurf/skills/improve-codebase-architecture/DEEPENING.md
@@ -0,0 +1,37 @@
+# Deepening
+
+How to deepen a cluster of shallow modules safely, given its dependencies. Assumes the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**.
+
+## Dependency categories
+
+When assessing a candidate for deepening, classify its dependencies. The category determines how the deepened module is tested across its seam.
+
+### 1. In-process
+
+Pure computation, in-memory state, no I/O. Always deepenable — merge the modules and test through the new interface directly. No adapter needed.
+
+### 2. Local-substitutable
+
+Dependencies that have local test stand-ins (PGLite for Postgres, in-memory filesystem). Deepenable if the stand-in exists. The deepened module is tested with the stand-in running in the test suite. The seam is internal; no port at the module's external interface.
+
+### 3. Remote but owned (Ports & Adapters)
+
+Your own services across a network boundary (microservices, internal APIs). Define a **port** (interface) at the seam. The deep module owns the logic; the transport is injected as an **adapter**. Tests use an in-memory adapter. Production uses an HTTP/gRPC/queue adapter.
+
+Recommendation shape: *"Define a port at the seam, implement an HTTP adapter for production and an in-memory adapter for testing, so the logic sits in one deep module even though it's deployed across a network."*
+
+### 4. True external (Mock)
+
+Third-party services (Stripe, Twilio, etc.) you don't control. The deepened module takes the external dependency as an injected port; tests provide a mock adapter.
+
+## Seam discipline
+
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a port unless at least two adapters are justified (typically production + test). A single-adapter seam is just indirection.
+- **Internal seams vs external seams.** A deep module can have internal seams (private to its implementation, used by its own tests) as well as the external seam at its interface. Don't expose internal seams through the interface just because tests use them.
+
+## Testing strategy: replace, don't layer
+
+- Old unit tests on shallow modules become waste once tests at the deepened module's interface exist — delete them.
+- Write new tests at the deepened module's interface. The **interface is the test surface**.
+- Tests assert on observable outcomes through the interface, not internal state.
+- Tests should survive internal refactors — they describe behaviour, not implementation. If a test has to change when the implementation changes, it's testing past the interface.
diff --git a/.windsurf/skills/improve-codebase-architecture/INTERFACE-DESIGN.md b/.windsurf/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
new file mode 100644
index 0000000..3197723
--- /dev/null
+++ b/.windsurf/skills/improve-codebase-architecture/INTERFACE-DESIGN.md
@@ -0,0 +1,44 @@
+# Interface Design
+
+When the user wants to explore alternative interfaces for a chosen deepening candidate, use this parallel sub-agent pattern. Based on "Design It Twice" (Ousterhout) — your first idea is unlikely to be the best.
+
+Uses the vocabulary in [LANGUAGE.md](LANGUAGE.md) — **module**, **interface**, **seam**, **adapter**, **leverage**.
+
+## Process
+
+### 1. Frame the problem space
+
+Before spawning sub-agents, write a user-facing explanation of the problem space for the chosen candidate:
+
+- The constraints any new interface would need to satisfy
+- The dependencies it would rely on, and which category they fall into (see [DEEPENING.md](DEEPENING.md))
+- A rough illustrative code sketch to ground the constraints — not a proposal, just a way to make the constraints concrete
+
+Show this to the user, then immediately proceed to Step 2. The user reads and thinks while the sub-agents work in parallel.
+
+### 2. Spawn sub-agents
+
+Spawn 3+ sub-agents in parallel using the Agent tool. Each must produce a **radically different** interface for the deepened module.
+
+Prompt each sub-agent with a separate technical brief (file paths, coupling details, dependency category from [DEEPENING.md](DEEPENING.md), what sits behind the seam). The brief is independent of the user-facing problem-space explanation in Step 1. Give each agent a different design constraint:
+
+- Agent 1: "Minimize the interface — aim for 1–3 entry points max. Maximise leverage per entry point."
+- Agent 2: "Maximise flexibility — support many use cases and extension."
+- Agent 3: "Optimise for the most common caller — make the default case trivial."
+- Agent 4 (if applicable): "Design around ports & adapters for cross-seam dependencies."
+
+Include both [LANGUAGE.md](LANGUAGE.md) vocabulary and CONTEXT.md vocabulary in the brief so each sub-agent names things consistently with the architecture language and the project's domain language.
+
+Each sub-agent outputs:
+
+1. Interface (types, methods, params — plus invariants, ordering, error modes)
+2. Usage example showing how callers use it
+3. What the implementation hides behind the seam
+4. Dependency strategy and adapters (see [DEEPENING.md](DEEPENING.md))
+5. Trade-offs — where leverage is high, where it's thin
+
+### 3. Present and compare
+
+Present designs sequentially so the user can absorb each one, then compare them in prose. Contrast by **depth** (leverage at the interface), **locality** (where change concentrates), and **seam placement**.
+
+After comparing, give your own recommendation: which design you think is strongest and why. If elements from different designs would combine well, propose a hybrid. Be opinionated — the user wants a strong read, not a menu.
diff --git a/.windsurf/skills/improve-codebase-architecture/LANGUAGE.md b/.windsurf/skills/improve-codebase-architecture/LANGUAGE.md
new file mode 100644
index 0000000..530c276
--- /dev/null
+++ b/.windsurf/skills/improve-codebase-architecture/LANGUAGE.md
@@ -0,0 +1,53 @@
+# Language
+
+Shared vocabulary for every suggestion this skill makes. Use these terms exactly — don't substitute "component," "service," "API," or "boundary." Consistent language is the whole point.
+
+## Terms
+
+**Module**
+Anything with an interface and an implementation. Deliberately scale-agnostic — applies equally to a function, class, package, or tier-spanning slice.
+_Avoid_: unit, component, service.
+
+**Interface**
+Everything a caller must know to use the module correctly. Includes the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics.
+_Avoid_: API, signature (too narrow — those refer only to the type-level surface).
+
+**Implementation**
+What's inside a module — its body of code. Distinct from **Adapter**: a thing can be a small adapter with a large implementation (a Postgres repo) or a large adapter with a small implementation (an in-memory fake). Reach for "adapter" when the seam is the topic; "implementation" otherwise.
+
+**Depth**
+Leverage at the interface — the amount of behaviour a caller (or test) can exercise per unit of interface they have to learn. A module is **deep** when a large amount of behaviour sits behind a small interface. A module is **shallow** when the interface is nearly as complex as the implementation.
+
+**Seam** _(from Michael Feathers)_
+A place where you can alter behaviour without editing in that place. The *location* at which a module's interface lives. Choosing where to put the seam is its own design decision, distinct from what goes behind it.
+_Avoid_: boundary (overloaded with DDD's bounded context).
+
+**Adapter**
+A concrete thing that satisfies an interface at a seam. Describes *role* (what slot it fills), not substance (what's inside).
+
+**Leverage**
+What callers get from depth. More capability per unit of interface they have to learn. One implementation pays back across N call sites and M tests.
+
+**Locality**
+What maintainers get from depth. Change, bugs, knowledge, and verification concentrate at one place rather than spreading across callers. Fix once, fixed everywhere.
+
+## Principles
+
+- **Depth is a property of the interface, not the implementation.** A deep module can be internally composed of small, mockable, swappable parts — they just aren't part of the interface. A module can have **internal seams** (private to its implementation, used by its own tests) as well as the **external seam** at its interface.
+- **The deletion test.** Imagine deleting the module. If complexity vanishes, the module wasn't hiding anything (it was a pass-through). If complexity reappears across N callers, the module was earning its keep.
+- **The interface is the test surface.** Callers and tests cross the same seam. If you want to test *past* the interface, the module is probably the wrong shape.
+- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a seam unless something actually varies across it.
+
+## Relationships
+
+- A **Module** has exactly one **Interface** (the surface it presents to callers and tests).
+- **Depth** is a property of a **Module**, measured against its **Interface**.
+- A **Seam** is where a **Module**'s **Interface** lives.
+- An **Adapter** sits at a **Seam** and satisfies the **Interface**.
+- **Depth** produces **Leverage** for callers and **Locality** for maintainers.
+
+## Rejected framings
+
+- **Depth as ratio of implementation-lines to interface-lines** (Ousterhout): rewards padding the implementation. We use depth-as-leverage instead.
+- **"Interface" as the TypeScript `interface` keyword or a class's public methods**: too narrow — interface here includes every fact a caller must know.
+- **"Boundary"**: overloaded with DDD's bounded context. Say **seam** or **interface**.
diff --git a/.windsurf/skills/improve-codebase-architecture/SKILL.md b/.windsurf/skills/improve-codebase-architecture/SKILL.md
new file mode 100644
index 0000000..05984a6
--- /dev/null
+++ b/.windsurf/skills/improve-codebase-architecture/SKILL.md
@@ -0,0 +1,71 @@
+---
+name: improve-codebase-architecture
+description: Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
+---
+
+# Improve Codebase Architecture
+
+Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
+
+## Glossary
+
+Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).
+
+- **Module** — anything with an interface and an implementation (function, class, package, slice).
+- **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
+- **Implementation** — the code inside.
+- **Depth** — leverage at the interface: a lot of behaviour behind a small interface. **Deep** = high leverage. **Shallow** = interface nearly as complex as the implementation.
+- **Seam** — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.")
+- **Adapter** — a concrete thing satisfying an interface at a seam.
+- **Leverage** — what callers get from depth.
+- **Locality** — what maintainers get from depth: change, bugs, knowledge concentrated in one place.
+
+Key principles (see [LANGUAGE.md](LANGUAGE.md) for the full list):
+
+- **Deletion test**: imagine deleting the module. If complexity vanishes, it was a pass-through. If complexity reappears across N callers, it was earning its keep.
+- **The interface is the test surface.**
+- **One adapter = hypothetical seam. Two adapters = real seam.**
+
+This skill is _informed_ by the project's domain model. The domain language gives names to good seams; ADRs record decisions the skill should not re-litigate.
+
+## Process
+
+### 1. Explore
+
+Read the project's domain glossary and any ADRs in the area you're touching first.
+
+Then use the Agent tool with `subagent_type=Explore` to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction:
+
+- Where does understanding one concept require bouncing between many small modules?
+- Where are modules **shallow** — interface nearly as complex as the implementation?
+- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no **locality**)?
+- Where do tightly-coupled modules leak across their seams?
+- Which parts of the codebase are untested, or hard to test through their current interface?
+
+Apply the **deletion test** to anything you suspect is shallow: would deleting it concentrate complexity, or just move it? A "yes, concentrates" is the signal you want.
+
+### 2. Present candidates
+
+Present a numbered list of deepening opportunities. For each candidate:
+
+- **Files** — which files/modules are involved
+- **Problem** — why the current architecture is causing friction
+- **Solution** — plain English description of what would change
+- **Benefits** — explained in terms of locality and leverage, and also in how tests would improve
+
+**Use CONTEXT.md vocabulary for the domain, and [LANGUAGE.md](LANGUAGE.md) vocabulary for the architecture.** If `CONTEXT.md` defines "Order," talk about "the Order intake module" — not "the FooBarHandler," and not "the Order service."
+
+**ADR conflicts**: if a candidate contradicts an existing ADR, only surface it when the friction is real enough to warrant revisiting the ADR. Mark it clearly (e.g. _"contradicts ADR-0007 — but worth reopening because…"_). Don't list every theoretical refactor an ADR forbids.
+
+Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
+
+### 3. Grilling loop
+
+Once the user picks a candidate, drop into a grilling conversation. Walk the design tree with them — constraints, dependencies, the shape of the deepened module, what sits behind the seam, what tests survive.
+
+Side effects happen inline as decisions crystallize:
+
+- **Naming a deepened module after a concept not in `CONTEXT.md`?** Add the term to `CONTEXT.md` — same discipline as `/grill-with-docs` (see [CONTEXT-FORMAT.md](../grill-with-docs/CONTEXT-FORMAT.md)). Create the file lazily if it doesn't exist.
+- **Sharpening a fuzzy term during the conversation?** Update `CONTEXT.md` right there.
+- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer to avoid re-suggesting the same thing — skip ephemeral reasons ("not worth it right now") and self-evident ones. See [ADR-FORMAT.md](../grill-with-docs/ADR-FORMAT.md).
+- **Want to explore alternative interfaces for the deepened module?** See [INTERFACE-DESIGN.md](INTERFACE-DESIGN.md).
diff --git a/.windsurf/skills/prototype/LOGIC.md b/.windsurf/skills/prototype/LOGIC.md
new file mode 100644
index 0000000..526ecb1
--- /dev/null
+++ b/.windsurf/skills/prototype/LOGIC.md
@@ -0,0 +1,79 @@
+# Logic Prototype
+
+A tiny interactive terminal app that lets the user drive a state model by hand. Use this when the question is about **business logic, state transitions, or data shape** — the kind of thing that looks reasonable on paper but only feels wrong once you push it through real cases.
+
+## When this is the right shape
+
+- "I'm not sure if this state machine handles the edge case where X then Y."
+- "Does this data model actually let me represent the case where..."
+- "I want to feel out what the API should look like before writing it."
+- Anything where the user wants to **press buttons and watch state change**.
+
+If the question is "what should this look like" — wrong branch. Use [UI.md](UI.md).
+
+## Process
+
+### 1. State the question
+
+Before writing code, write down what state model and what question you're prototyping. One paragraph, in the prototype's README or a comment at the top of the file. A logic prototype that answers the wrong question is pure waste — make the question explicit so it can be checked later, whether the user is watching now or returning to it AFK.
+
+### 2. Pick the language
+
+Use whatever the host project uses. If the project has no obvious runtime (e.g. a docs repo), ask.
+
+Match the project's existing conventions for tooling — don't add a new package manager or runtime just for the prototype.
+
+### 3. Isolate the logic in a portable module
+
+Put the actual logic — the bit that's answering the question — behind a small, pure interface that could be lifted out and dropped into the real codebase later. The TUI around it is throwaway; the logic module shouldn't be.
+
+The right shape depends on the question:
+
+- **A pure reducer** — `(state, action) => state`. Good when actions are discrete events and state is a single value.
+- **A state machine** — explicit states and transitions. Good when "which actions are even legal right now" is part of the question.
+- **A small set of pure functions** over a plain data type. Good when there's no implicit current state — just transformations.
+- **A class or module with a clear method surface** when the logic genuinely owns ongoing internal state.
+
+Pick whichever shape best fits the question being asked, *not* whichever is easiest to wire to a TUI. Keep it pure: no I/O, no terminal code, no `console.log` for control flow. The TUI imports it and calls into it; nothing flows the other direction.
+
+This is what makes the prototype useful past its own lifetime. When the question's been answered, the validated reducer / machine / function set can be lifted into the real module — the TUI shell gets deleted.
+
+### 4. Build the smallest TUI that exposes the state
+
+Build it as a **lightweight TUI** — on every tick, clear the screen (`console.clear()` / `print("\033[2J\033[H")` / equivalent) and re-render the whole frame. The user should always see one stable view, not an ever-growing scrollback.
+
+Each frame has two parts, in this order:
+
+1. **Current state**, pretty-printed and diff-friendly (one field per line, or formatted JSON). Use **bold** for field names or section headers and **dim** for less important context (timestamps, IDs, derived values). Native ANSI escape codes are fine — `\x1b[1m` bold, `\x1b[2m` dim, `\x1b[0m` reset. No need to pull in a styling library unless one is already in the project.
+2. **Keyboard shortcuts**, listed at the bottom: `[a] add user  [d] delete user  [t] tick clock  [q] quit`. Bold the key, dim the description, or vice-versa — whatever reads cleanly.
+
+Behaviour:
+
+1. **Initialise state** — a single in-memory object/struct. Render the first frame on start.
+2. **Read one keystroke (or one line)** at a time, dispatch to a handler that mutates state.
+3. **Re-render** the full frame after every action — don't append, replace.
+4. **Loop until quit.**
+
+The whole frame should fit on one screen.
+
+### 5. Make it runnable in one command
+
+Add a script to the project's existing task runner (`package.json` scripts, `Makefile`, `justfile`, `pyproject.toml`). The user should run `pnpm run <prototype-name>` or equivalent — never need to remember a path.
+
+If the host project has no task runner, just put the command at the top of the prototype's README.
+
+### 6. Hand it over
+
+Give the user the run command. They'll drive it themselves; the interesting moments are when they say "wait, that shouldn't be possible" or "huh, I assumed X would be different" — those are the bugs in the _idea_, which is the whole point. If they want new actions added, add them. Prototypes evolve.
+
+### 7. Capture the answer
+
+When the prototype has done its job, the answer to the question is the only thing worth keeping. If the user is around, ask what it taught them. If not, leave a `NOTES.md` next to the prototype so the answer can be filled in (or filled in by you, if you've watched the session) before the prototype gets deleted.
+
+## Anti-patterns
+
+- **Don't add tests.** A prototype that needs tests is no longer a prototype.
+- **Don't wire it to the real database.** Use an in-memory store unless the question is specifically about persistence.
+- **Don't generalise.** No "what if we wanted to support X later." The prototype answers one question.
+- **Don't blur the logic and the TUI together.** If the reducer / state machine references `console.log`, prompts, or terminal escape codes, it's no longer portable. Keep the TUI as a thin shell over a pure module.
+- **Don't ship the TUI shell into production.** The shell is optimised for being driven by hand from a terminal. The logic module behind it is the bit worth keeping.
diff --git a/.windsurf/skills/prototype/SKILL.md b/.windsurf/skills/prototype/SKILL.md
new file mode 100644
index 0000000..64f3e61
--- /dev/null
+++ b/.windsurf/skills/prototype/SKILL.md
@@ -0,0 +1,30 @@
+---
+name: prototype
+description: Build a throwaway prototype to flesh out a design before committing to it. Routes between two branches — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route. Use when the user wants to prototype, sanity-check a data model or state machine, mock up a UI, explore design options, or says "prototype this", "let me play with it", "try a few designs".
+---
+
+# Prototype
+
+A prototype is **throwaway code that answers a question**. The question decides the shape.
+
+## Pick a branch
+
+Identify which question is being answered — from the user's prompt, the surrounding code, or by asking if the user is around:
+
+- **"Does this logic / state model feel right?"** → [LOGIC.md](LOGIC.md). Build a tiny interactive terminal app that pushes the state machine through cases that are hard to reason about on paper.
+- **"What should this look like?"** → [UI.md](UI.md). Generate several radically different UI variations on a single route, switchable via a URL search param and a floating bottom bar.
+
+The two branches produce very different artifacts — getting this wrong wastes the whole prototype. If the question is genuinely ambiguous and the user isn't reachable, default to whichever branch better matches the surrounding code (a backend module → logic; a page or component → UI) and state the assumption at the top of the prototype.
+
+## Rules that apply to both
+
+1. **Throwaway from day one, and clearly marked as such.** Locate the prototype code close to where it will actually be used (next to the module or page it's prototyping for) so context is obvious — but name it so a casual reader can see it's a prototype, not production. For throwaway UI routes, obey whatever routing convention the project already uses; don't invent a new top-level structure.
+2. **One command to run.** Whatever the project's existing task runner supports — `pnpm <name>`, `python <path>`, `bun <path>`, etc. The user must be able to start it without thinking.
+3. **No persistence by default.** State lives in memory. Persistence is the thing the prototype is _checking_, not something it should depend on. If the question explicitly involves a database, hit a scratch DB or a local file with a clear "PROTOTYPE — wipe me" name.
+4. **Skip the polish.** No tests, no error handling beyond what makes the prototype _runnable_, no abstractions. The point is to learn something fast and then delete it.
+5. **Surface the state.** After every action (logic) or on every variant switch (UI), print or render the full relevant state so the user can see what changed.
+6. **Delete or absorb when done.** When the prototype has answered its question, either delete it or fold the validated decision into the real code — don't leave it rotting in the repo.
+
+## When done
+
+The _answer_ is the only thing worth keeping from a prototype. Capture it somewhere durable (commit message, ADR, issue, or a `NOTES.md` next to the prototype) along with the question it was answering. If the user is around, that capture is a quick conversation; if not, leave the placeholder so they (or you, on the next pass) can fill in the verdict before deleting the prototype.
diff --git a/.windsurf/skills/prototype/UI.md b/.windsurf/skills/prototype/UI.md
new file mode 100644
index 0000000..f3b6e64
--- /dev/null
+++ b/.windsurf/skills/prototype/UI.md
@@ -0,0 +1,112 @@
+# UI Prototype
+
+Generate **several radically different UI variations** on a single route, switchable from a floating bottom bar. The user flips between variants in the browser, picks one (or steals bits from each), then throws the rest away.
+
+If the question is about logic/state rather than what something looks like — wrong branch. Use [LOGIC.md](LOGIC.md).
+
+## When this is the right shape
+
+- "What should this page look like?"
+- "I want to see a few options for this dashboard before committing."
+- "Try a different layout for the settings screen."
+- Any time the user would otherwise spend a day picking between three vague mockups in their head.
+
+## Two sub-shapes — strongly prefer sub-shape A
+
+A UI prototype is much easier to judge when it's **butting up against the rest of the app** — real header, real sidebar, real data, real density. A throwaway route on its own is a vacuum: every variant looks fine in isolation. Default to sub-shape A whenever there's a plausible existing page to host the variants. Only reach for sub-shape B if the prototype genuinely has no nearby home.
+
+### Sub-shape A — adjustment to an existing page (preferred)
+
+The route already exists. Variants are rendered **on the same route**, gated by a `?variant=` URL search param. The existing data fetching, params, and auth all stay — only the rendering swaps. This is the default; pick it unless there's a specific reason not to.
+
+If the prototype is for something that doesn't yet have a page but *would naturally live inside one* (a new section of the dashboard, a new card on the settings screen, a new step in an existing flow) — that's still sub-shape A. Mount the variants inside the host page.
+
+### Sub-shape B — a new page (last resort)
+
+Only use this when the thing being prototyped genuinely has no existing page to live inside — e.g. an entirely new top-level surface, or a flow that can't be embedded anywhere sensible.
+
+Create a **throwaway route** following whatever routing convention the project already uses — don't invent a new top-level structure. Name it so it's obviously a prototype (e.g. include the word `prototype` in the path or filename). Same `?variant=` pattern.
+
+Before committing to sub-shape B, sanity-check: is there really no existing page this could be embedded in? An empty route hides design problems that a populated one would expose.
+
+In both sub-shapes the floating bottom bar is identical.
+
+## Process
+
+### 1. State the question and pick N
+
+Default to **3 variants**. More than 5 stops being radically different and starts being noise — cap there.
+
+Write down the plan in one line, in the prototype's location or a top-of-file comment:
+
+> "Three variants of the settings page, switchable via `?variant=`, on the existing `/settings` route."
+
+This works whether the user is here to push back or not.
+
+### 2. Generate radically different variants
+
+Draft each variant. Hold each one to:
+
+- The page's purpose and the data it has access to.
+- The project's component library / styling system (TailwindCSS, shadcn, MUI, plain CSS, whatever).
+- A clear exported component name, e.g. `VariantA`, `VariantB`, `VariantC`.
+
+Variants must be **structurally different** — different layout, different information hierarchy, different primary affordance, not just different colours. Three slightly-tweaked card grids isn't a UI prototype, it's wallpaper. If two drafts come out too similar, redo one with explicit "do not use a card grid" guidance.
+
+### 3. Wire them together
+
+Create a single switcher component on the route:
+
+```tsx
+// pseudo-code — adapt to the project's framework
+const variant = searchParams.get('variant') ?? 'A';
+return (
+  <>
+    {variant === 'A' && <VariantA {...data} />}
+    {variant === 'B' && <VariantB {...data} />}
+    {variant === 'C' && <VariantC {...data} />}
+    <PrototypeSwitcher variants={['A','B','C']} current={variant} />
+  </>
+);
+```
+
+For sub-shape A (existing page): keep all the existing data fetching above the switcher; only the rendered subtree changes per variant.
+
+For sub-shape B (new page): the throwaway route under `/prototype/<name>` mounts the same switcher.
+
+### 4. Build the floating switcher
+
+A small fixed-position bar at the bottom-centre of the screen with three pieces:
+
+- **Left arrow** — cycles to the previous variant (wraps around).
+- **Variant label** — shows the current variant key and, if the variant exports a name, that name too. e.g. `B — Sidebar layout`.
+- **Right arrow** — cycles forward (wraps around).
+
+Behaviour:
+
+- Clicking an arrow updates the URL search param (use the framework's router — `router.replace` on Next, `navigate` on React Router, etc) so the variant is shareable and reload-stable.
+- Keyboard: `←` and `→` arrow keys also cycle. Don't intercept arrow keys when an `<input>`, `<textarea>`, or `[contenteditable]` is focused.
+- Visually distinct from the page (e.g. high-contrast pill, subtle shadow) so it's obviously not part of the design being evaluated.
+- Hidden in production builds — gate on `process.env.NODE_ENV !== 'production'` or an equivalent check, so a stray prototype merge can't ship the bar to users.
+
+Put the switcher in a single shared component so both sub-shapes can reuse it. Locate it wherever shared UI lives in the project.
+
+### 5. Hand it over
+
+Surface the URL (and the `?variant=` keys). The user will flip through whenever they get to it. The interesting feedback is usually **"I want the header from B with the sidebar from C"** — that's the actual design they want.
+
+### 6. Capture the answer and clean up
+
+Once a variant has won, write down which one and why (commit message, ADR, issue, or a `NOTES.md` next to the prototype if running AFK and the user hasn't responded yet). Then:
+
+- **Sub-shape A** — delete the losing variants and the switcher; fold the winner into the existing page.
+- **Sub-shape B** — promote the winning variant to a real route, delete the throwaway route and the switcher.
+
+Don't leave variant components or the switcher lying around. They rot fast and confuse the next reader.
+
+## Anti-patterns
+
+- **Variants that differ only in colour or copy.** That's a tweak, not a prototype. Real variants disagree about structure.
+- **Sharing too much code between variants.** A shared `<Header>` is fine; a shared `<Layout>` defeats the point. Each variant should be free to throw out the layout.
+- **Wiring variants to real mutations.** Read-only prototypes are fine. If a variant needs to mutate, point it at a stub — the question is "what should this look like", not "does the backend work".
+- **Promoting the prototype directly to production.** The variant code was written under prototype constraints (no tests, minimal error handling). Rewrite it properly when you fold it in.
diff --git a/.windsurf/skills/setup-matt-pocock-skills/SKILL.md b/.windsurf/skills/setup-matt-pocock-skills/SKILL.md
new file mode 100644
index 0000000..1ebc6e1
--- /dev/null
+++ b/.windsurf/skills/setup-matt-pocock-skills/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: setup-matt-pocock-skills
+description: Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
+disable-model-invocation: true
+---
+
+# Setup Matt Pocock's Skills
+
+Scaffold the per-repo configuration that the engineering skills assume:
+
+- **Issue tracker** — where issues live (GitHub by default; local markdown is also supported out of the box)
+- **Triage labels** — the strings used for the five canonical triage roles
+- **Domain docs** — where `CONTEXT.md` and ADRs live, and the consumer rules for reading them
+
+This is a prompt-driven skill, not a deterministic script. Explore, present what you found, confirm with the user, then write.
+
+## Process
+
+### 1. Explore
+
+Look at the current repo to understand its starting state. Read whatever exists; don't assume:
+
+- `git remote -v` and `.git/config` — is this a GitHub repo? Which one?
+- `AGENTS.md` and `CLAUDE.md` at the repo root — does either exist? Is there already an `## Agent skills` section in either?
+- `CONTEXT.md` and `CONTEXT-MAP.md` at the repo root
+- `docs/adr/` and any `src/*/docs/adr/` directories
+- `docs/agents/` — does this skill's prior output already exist?
+- `.scratch/` — sign that a local-markdown issue tracker convention is already in use
+
+### 2. Present findings and ask
+
+Summarise what's present and what's missing. Then walk the user through the three decisions **one at a time** — present a section, get the user's answer, then move to the next. Don't dump all three at once.
+
+Assume the user does not know what these terms mean. Each section starts with a short explainer (what it is, why these skills need it, what changes if they pick differently). Then show the choices and the default.
+
+**Section A — Issue tracker.**
+
+> Explainer: The "issue tracker" is where issues live for this repo. Skills like `to-issues`, `triage`, `to-prd`, and `qa` read from and write to it — they need to know whether to call `gh issue create`, write a markdown file under `.scratch/`, or follow some other workflow you describe. Pick the place you actually track work for this repo.
+
+Default posture: these skills were designed for GitHub. If a `git remote` points at GitHub, propose that. If a `git remote` points at GitLab (`gitlab.com` or a self-hosted host), propose GitLab. Otherwise (or if the user prefers), offer:
+
+- **GitHub** — issues live in the repo's GitHub Issues (uses the `gh` CLI)
+- **GitLab** — issues live in the repo's GitLab Issues (uses the [`glab`](https://gitlab.com/gitlab-org/cli) CLI)
+- **Local markdown** — issues live as files under `.scratch/<feature>/` in this repo (good for solo projects or repos without a remote)
+- **Other** (Jira, Linear, etc.) — ask the user to describe the workflow in one paragraph; the skill will record it as freeform prose
+
+**Section B — Triage label vocabulary.**
+
+> Explainer: When the `triage` skill processes an incoming issue, it moves it through a state machine — needs evaluation, waiting on reporter, ready for an AFK agent to pick up, ready for a human, or won't fix. To do that, it needs to apply labels (or the equivalent in your issue tracker) that match strings *you've actually configured*. If your repo already uses different label names (e.g. `bug:triage` instead of `needs-triage`), map them here so the skill applies the right ones instead of creating duplicates.
+
+The five canonical roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter
+- `ready-for-agent` — fully specified, AFK-ready (an agent can pick it up with no human context)
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Default: each role's string equals its name. Ask the user if they want to override any. If their issue tracker has no existing labels, the defaults are fine.
+
+**Section C — Domain docs.**
+
+> Explainer: Some skills (`improve-codebase-architecture`, `diagnose`, `tdd`) read a `CONTEXT.md` file to learn the project's domain language, and `docs/adr/` for past architectural decisions. They need to know whether the repo has one global context or multiple (e.g. a monorepo with separate frontend/backend contexts) so they look in the right place.
+
+Confirm the layout:
+
+- **Single-context** — one `CONTEXT.md` + `docs/adr/` at the repo root. Most repos are this.
+- **Multi-context** — `CONTEXT-MAP.md` at the root pointing to per-context `CONTEXT.md` files (typically a monorepo).
+
+### 3. Confirm and edit
+
+Show the user a draft of:
+
+- The `## Agent skills` block to add to whichever of `CLAUDE.md` / `AGENTS.md` is being edited (see step 4 for selection rules)
+- The contents of `docs/agents/issue-tracker.md`, `docs/agents/triage-labels.md`, `docs/agents/domain.md`
+
+Let them edit before writing.
+
+### 4. Write
+
+**Pick the file to edit:**
+
+- If `CLAUDE.md` exists, edit it.
+- Else if `AGENTS.md` exists, edit it.
+- If neither exists, ask the user which one to create — don't pick for them.
+
+Never create `AGENTS.md` when `CLAUDE.md` already exists (or vice versa) — always edit the one that's already there.
+
+If an `## Agent skills` block already exists in the chosen file, update its contents in-place rather than appending a duplicate. Don't overwrite user edits to the surrounding sections.
+
+The block:
+
+```markdown
+## Agent skills
+
+### Issue tracker
+
+[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
+```
+
+Then write the three docs files using the seed templates in this skill folder as a starting point:
+
+- [issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker
+- [issue-tracker-gitlab.md](./issue-tracker-gitlab.md) — GitLab issue tracker
+- [issue-tracker-local.md](./issue-tracker-local.md) — local-markdown issue tracker
+- [triage-labels.md](./triage-labels.md) — label mapping
+- [domain.md](./domain.md) — domain doc consumer rules + layout
+
+For "other" issue trackers, write `docs/agents/issue-tracker.md` from scratch using the user's description.
+
+### 5. Done
+
+Tell the user the setup is complete and which engineering skills will now read from these files. Mention they can edit `docs/agents/*.md` directly later — re-running this skill is only necessary if they want to switch issue trackers or restart from scratch.
diff --git a/.windsurf/skills/setup-matt-pocock-skills/domain.md b/.windsurf/skills/setup-matt-pocock-skills/domain.md
new file mode 100644
index 0000000..c97d6a6
--- /dev/null
+++ b/.windsurf/skills/setup-matt-pocock-skills/domain.md
@@ -0,0 +1,51 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT.md`** at the repo root, or
+- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The producer skill (`/grill-with-docs`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo (most repos):
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-event-sourced-orders.md
+│   └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/adr/                          ← system-wide decisions
+└── src/
+    ├── ordering/
+    │   ├── CONTEXT.md
+    │   └── docs/adr/                  ← context-specific decisions
+    └── billing/
+        ├── CONTEXT.md
+        └── docs/adr/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/grill-with-docs`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_
diff --git a/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-github.md b/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-github.md
new file mode 100644
index 0000000..cce77ec
--- /dev/null
+++ b/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-github.md
@@ -0,0 +1,22 @@
+# Issue tracker: GitHub
+
+Issues and PRDs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
+
+Infer the repo from `git remote -v` — `gh` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitHub issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `gh issue view <number> --comments`.
diff --git a/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md b/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
new file mode 100644
index 0000000..f54da95
--- /dev/null
+++ b/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md
@@ -0,0 +1,23 @@
+# Issue tracker: GitLab
+
+Issues and PRDs for this repo live as GitLab issues. Use the [`glab`](https://gitlab.com/gitlab-org/cli) CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `glab issue create --title "..." --description "..."`. Use a heredoc for multi-line descriptions. Pass `--description -` to open an editor.
+- **Read an issue**: `glab issue view <number> --comments`. Use `-F json` for machine-readable output.
+- **List issues**: `glab issue list -F json` with appropriate `--label` filters.
+- **Comment on an issue**: `glab issue note <number> --message "..."`. GitLab calls comments "notes".
+- **Apply / remove labels**: `glab issue update <number> --label "..."` / `--unlabel "..."`. Multiple labels can be comma-separated or by repeating the flag.
+- **Close**: `glab issue close <number>`. `glab issue close` does not accept a closing comment, so post the explanation first with `glab issue note <number> --message "..."`, then close.
+- **Merge requests**: GitLab calls PRs "merge requests". Use `glab mr create`, `glab mr view`, `glab mr note`, etc. — the same shape as `gh pr ...` with `mr` in place of `pr` and `note`/`--message` in place of `comment`/`--body`.
+
+Infer the repo from `git remote -v` — `glab` does this automatically when run inside a clone.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitLab issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `glab issue view <number> --comments`.
diff --git a/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-local.md b/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-local.md
new file mode 100644
index 0000000..a2f08fb
--- /dev/null
+++ b/.windsurf/skills/setup-matt-pocock-skills/issue-tracker-local.md
@@ -0,0 +1,19 @@
+# Issue tracker: Local Markdown
+
+Issues and PRDs for this repo live as markdown files in `.scratch/`.
+
+## Conventions
+
+- One feature per directory: `.scratch/<feature-slug>/`
+- The PRD is `.scratch/<feature-slug>/PRD.md`
+- Implementation issues are `.scratch/<feature-slug>/issues/<NN>-<slug>.md`, numbered from `01`
+- Triage state is recorded as a `Status:` line near the top of each issue file (see `triage-labels.md` for the role strings)
+- Comments and conversation history append to the bottom of the file under a `## Comments` heading
+
+## When a skill says "publish to the issue tracker"
+
+Create a new file under `.scratch/<feature-slug>/` (creating the directory if needed).
+
+## When a skill says "fetch the relevant ticket"
+
+Read the file at the referenced path. The user will normally pass the path or the issue number directly.
diff --git a/.windsurf/skills/setup-matt-pocock-skills/triage-labels.md b/.windsurf/skills/setup-matt-pocock-skills/triage-labels.md
new file mode 100644
index 0000000..b716855
--- /dev/null
+++ b/.windsurf/skills/setup-matt-pocock-skills/triage-labels.md
@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.
diff --git a/.windsurf/skills/tdd/SKILL.md b/.windsurf/skills/tdd/SKILL.md
new file mode 100644
index 0000000..7a98941
--- /dev/null
+++ b/.windsurf/skills/tdd/SKILL.md
@@ -0,0 +1,109 @@
+---
+name: tdd
+description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
+---
+
+# Test-Driven Development
+
+## Philosophy
+
+**Core principle**: Tests should verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't.
+
+**Good tests** are integration-style: they exercise real code paths through public APIs. They describe _what_ the system does, not _how_ it does it. A good test reads like a specification - "user can checkout with valid cart" tells you exactly what capability exists. These tests survive refactors because they don't care about internal structure.
+
+**Bad tests** are coupled to implementation. They mock internal collaborators, test private methods, or verify through external means (like querying a database directly instead of using the interface). The warning sign: your test breaks when you refactor, but behavior hasn't changed. If you rename an internal function and tests fail, those tests were testing implementation, not behavior.
+
+See [tests.md](tests.md) for examples and [mocking.md](mocking.md) for mocking guidelines.
+
+## Anti-Pattern: Horizontal Slices
+
+**DO NOT write all tests first, then all implementation.** This is "horizontal slicing" - treating RED as "write all tests" and GREEN as "write all code."
+
+This produces **crap tests**:
+
+- Tests written in bulk test _imagined_ behavior, not _actual_ behavior
+- You end up testing the _shape_ of things (data structures, function signatures) rather than user-facing behavior
+- Tests become insensitive to real changes - they pass when behavior breaks, fail when behavior is fine
+- You outrun your headlights, committing to test structure before understanding the implementation
+
+**Correct approach**: Vertical slices via tracer bullets. One test → one implementation → repeat. Each test responds to what you learned from the previous cycle. Because you just wrote the code, you know exactly what behavior matters and how to verify it.
+
+```
+WRONG (horizontal):
+  RED:   test1, test2, test3, test4, test5
+  GREEN: impl1, impl2, impl3, impl4, impl5
+
+RIGHT (vertical):
+  RED→GREEN: test1→impl1
+  RED→GREEN: test2→impl2
+  RED→GREEN: test3→impl3
+  ...
+```
+
+## Workflow
+
+### 1. Planning
+
+When exploring the codebase, use the project's domain glossary so that test names and interface vocabulary match the project's language, and respect ADRs in the area you're touching.
+
+Before writing any code:
+
+- [ ] Confirm with user what interface changes are needed
+- [ ] Confirm with user which behaviors to test (prioritize)
+- [ ] Identify opportunities for [deep modules](deep-modules.md) (small interface, deep implementation)
+- [ ] Design interfaces for [testability](interface-design.md)
+- [ ] List the behaviors to test (not implementation steps)
+- [ ] Get user approval on the plan
+
+Ask: "What should the public interface look like? Which behaviors are most important to test?"
+
+**You can't test everything.** Confirm with the user exactly which behaviors matter most. Focus testing effort on critical paths and complex logic, not every possible edge case.
+
+### 2. Tracer Bullet
+
+Write ONE test that confirms ONE thing about the system:
+
+```
+RED:   Write test for first behavior → test fails
+GREEN: Write minimal code to pass → test passes
+```
+
+This is your tracer bullet - proves the path works end-to-end.
+
+### 3. Incremental Loop
+
+For each remaining behavior:
+
+```
+RED:   Write next test → fails
+GREEN: Minimal code to pass → passes
+```
+
+Rules:
+
+- One test at a time
+- Only enough code to pass current test
+- Don't anticipate future tests
+- Keep tests focused on observable behavior
+
+### 4. Refactor
+
+After all tests pass, look for [refactor candidates](refactoring.md):
+
+- [ ] Extract duplication
+- [ ] Deepen modules (move complexity behind simple interfaces)
+- [ ] Apply SOLID principles where natural
+- [ ] Consider what new code reveals about existing code
+- [ ] Run tests after each refactor step
+
+**Never refactor while RED.** Get to GREEN first.
+
+## Checklist Per Cycle
+
+```
+[ ] Test describes behavior, not implementation
+[ ] Test uses public interface only
+[ ] Test would survive internal refactor
+[ ] Code is minimal for this test
+[ ] No speculative features added
+```
diff --git a/.windsurf/skills/tdd/deep-modules.md b/.windsurf/skills/tdd/deep-modules.md
new file mode 100644
index 0000000..0d9720c
--- /dev/null
+++ b/.windsurf/skills/tdd/deep-modules.md
@@ -0,0 +1,33 @@
+# Deep Modules
+
+From "A Philosophy of Software Design":
+
+**Deep module** = small interface + lots of implementation
+
+```
+┌─────────────────────┐
+│   Small Interface   │  ← Few methods, simple params
+├─────────────────────┤
+│                     │
+│                     │
+│  Deep Implementation│  ← Complex logic hidden
+│                     │
+│                     │
+└─────────────────────┘
+```
+
+**Shallow module** = large interface + little implementation (avoid)
+
+```
+┌─────────────────────────────────┐
+│       Large Interface           │  ← Many methods, complex params
+├─────────────────────────────────┤
+│  Thin Implementation            │  ← Just passes through
+└─────────────────────────────────┘
+```
+
+When designing interfaces, ask:
+
+- Can I reduce the number of methods?
+- Can I simplify the parameters?
+- Can I hide more complexity inside?
diff --git a/.windsurf/skills/tdd/interface-design.md b/.windsurf/skills/tdd/interface-design.md
new file mode 100644
index 0000000..a0a20ca
--- /dev/null
+++ b/.windsurf/skills/tdd/interface-design.md
@@ -0,0 +1,31 @@
+# Interface Design for Testability
+
+Good interfaces make testing natural:
+
+1. **Accept dependencies, don't create them**
+
+   ```typescript
+   // Testable
+   function processOrder(order, paymentGateway) {}
+
+   // Hard to test
+   function processOrder(order) {
+     const gateway = new StripeGateway();
+   }
+   ```
+
+2. **Return results, don't produce side effects**
+
+   ```typescript
+   // Testable
+   function calculateDiscount(cart): Discount {}
+
+   // Hard to test
+   function applyDiscount(cart): void {
+     cart.total -= discount;
+   }
+   ```
+
+3. **Small surface area**
+   - Fewer methods = fewer tests needed
+   - Fewer params = simpler test setup
diff --git a/.windsurf/skills/tdd/mocking.md b/.windsurf/skills/tdd/mocking.md
new file mode 100644
index 0000000..71cbfee
--- /dev/null
+++ b/.windsurf/skills/tdd/mocking.md
@@ -0,0 +1,59 @@
+# When to Mock
+
+Mock at **system boundaries** only:
+
+- External APIs (payment, email, etc.)
+- Databases (sometimes - prefer test DB)
+- Time/randomness
+- File system (sometimes)
+
+Don't mock:
+
+- Your own classes/modules
+- Internal collaborators
+- Anything you control
+
+## Designing for Mockability
+
+At system boundaries, design interfaces that are easy to mock:
+
+**1. Use dependency injection**
+
+Pass external dependencies in rather than creating them internally:
+
+```typescript
+// Easy to mock
+function processPayment(order, paymentClient) {
+  return paymentClient.charge(order.total);
+}
+
+// Hard to mock
+function processPayment(order) {
+  const client = new StripeClient(process.env.STRIPE_KEY);
+  return client.charge(order.total);
+}
+```
+
+**2. Prefer SDK-style interfaces over generic fetchers**
+
+Create specific functions for each external operation instead of one generic function with conditional logic:
+
+```typescript
+// GOOD: Each function is independently mockable
+const api = {
+  getUser: (id) => fetch(`/users/${id}`),
+  getOrders: (userId) => fetch(`/users/${userId}/orders`),
+  createOrder: (data) => fetch('/orders', { method: 'POST', body: data }),
+};
+
+// BAD: Mocking requires conditional logic inside the mock
+const api = {
+  fetch: (endpoint, options) => fetch(endpoint, options),
+};
+```
+
+The SDK approach means:
+- Each mock returns one specific shape
+- No conditional logic in test setup
+- Easier to see which endpoints a test exercises
+- Type safety per endpoint
diff --git a/.windsurf/skills/tdd/refactoring.md b/.windsurf/skills/tdd/refactoring.md
new file mode 100644
index 0000000..8a44439
--- /dev/null
+++ b/.windsurf/skills/tdd/refactoring.md
@@ -0,0 +1,10 @@
+# Refactor Candidates
+
+After TDD cycle, look for:
+
+- **Duplication** → Extract function/class
+- **Long methods** → Break into private helpers (keep tests on public interface)
+- **Shallow modules** → Combine or deepen
+- **Feature envy** → Move logic to where data lives
+- **Primitive obsession** → Introduce value objects
+- **Existing code** the new code reveals as problematic
diff --git a/.windsurf/skills/tdd/tests.md b/.windsurf/skills/tdd/tests.md
new file mode 100644
index 0000000..ff22f80
--- /dev/null
+++ b/.windsurf/skills/tdd/tests.md
@@ -0,0 +1,61 @@
+# Good and Bad Tests
+
+## Good Tests
+
+**Integration-style**: Test through real interfaces, not mocks of internal parts.
+
+```typescript
+// GOOD: Tests observable behavior
+test("user can checkout with valid cart", async () => {
+  const cart = createCart();
+  cart.add(product);
+  const result = await checkout(cart, paymentMethod);
+  expect(result.status).toBe("confirmed");
+});
+```
+
+Characteristics:
+
+- Tests behavior users/callers care about
+- Uses public API only
+- Survives internal refactors
+- Describes WHAT, not HOW
+- One logical assertion per test
+
+## Bad Tests
+
+**Implementation-detail tests**: Coupled to internal structure.
+
+```typescript
+// BAD: Tests implementation details
+test("checkout calls paymentService.process", async () => {
+  const mockPayment = jest.mock(paymentService);
+  await checkout(cart, payment);
+  expect(mockPayment.process).toHaveBeenCalledWith(cart.total);
+});
+```
+
+Red flags:
+
+- Mocking internal collaborators
+- Testing private methods
+- Asserting on call counts/order
+- Test breaks when refactoring without behavior change
+- Test name describes HOW not WHAT
+- Verifying through external means instead of interface
+
+```typescript
+// BAD: Bypasses interface to verify
+test("createUser saves to database", async () => {
+  await createUser({ name: "Alice" });
+  const row = await db.query("SELECT * FROM users WHERE name = ?", ["Alice"]);
+  expect(row).toBeDefined();
+});
+
+// GOOD: Verifies through interface
+test("createUser makes user retrievable", async () => {
+  const user = await createUser({ name: "Alice" });
+  const retrieved = await getUser(user.id);
+  expect(retrieved.name).toBe("Alice");
+});
+```
diff --git a/.windsurf/skills/to-issues/SKILL.md b/.windsurf/skills/to-issues/SKILL.md
new file mode 100644
index 0000000..9f6efbf
--- /dev/null
+++ b/.windsurf/skills/to-issues/SKILL.md
@@ -0,0 +1,83 @@
+---
+name: to-issues
+description: Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
+---
+
+# To Issues
+
+Break a plan into independently-grabbable issues using vertical slices (tracer bullets).
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+### 1. Gather context
+
+Work from whatever is already in the conversation context. If the user passes an issue reference (issue number, URL, or path) as an argument, fetch it from the issue tracker and read its full body and comments.
+
+### 2. Explore the codebase (optional)
+
+If you have not already explored the codebase, do so to understand the current state of the code. Issue titles and descriptions should use the project's domain glossary vocabulary, and respect ADRs in the area you're touching.
+
+### 3. Draft vertical slices
+
+Break the plan into **tracer bullet** issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer.
+
+Slices may be 'HITL' or 'AFK'. HITL slices require human interaction, such as an architectural decision or a design review. AFK slices can be implemented and merged without human interaction. Prefer AFK over HITL where possible.
+
+<vertical-slice-rules>
+- Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests)
+- A completed slice is demoable or verifiable on its own
+- Prefer many thin slices over few thick ones
+</vertical-slice-rules>
+
+### 4. Quiz the user
+
+Present the proposed breakdown as a numbered list. For each slice, show:
+
+- **Title**: short descriptive name
+- **Type**: HITL / AFK
+- **Blocked by**: which other slices (if any) must complete first
+- **User stories covered**: which user stories this addresses (if the source material has them)
+
+Ask the user:
+
+- Does the granularity feel right? (too coarse / too fine)
+- Are the dependency relationships correct?
+- Should any slices be merged or split further?
+- Are the correct slices marked as HITL and AFK?
+
+Iterate until the user approves the breakdown.
+
+### 5. Publish the issues to the issue tracker
+
+For each approved slice, publish a new issue to the issue tracker. Use the issue body template below. These issues are considered ready for AFK agents, so publish them with the correct triage label unless instructed otherwise.
+
+Publish issues in dependency order (blockers first) so you can reference real issue identifiers in the "Blocked by" field.
+
+<issue-template>
+## Parent
+
+A reference to the parent issue on the issue tracker (if the source was an existing issue, otherwise omit this section).
+
+## What to build
+
+A concise description of this vertical slice. Describe the end-to-end behavior, not layer-by-layer implementation.
+
+Avoid specific file paths or code snippets — they go stale fast. Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it here and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Acceptance criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] Criterion 3
+
+## Blocked by
+
+- A reference to the blocking ticket (if any)
+
+Or "None - can start immediately" if no blockers.
+
+</issue-template>
+
+Do NOT close or modify any parent issue.
diff --git a/.windsurf/skills/to-prd/SKILL.md b/.windsurf/skills/to-prd/SKILL.md
new file mode 100644
index 0000000..47a01d4
--- /dev/null
+++ b/.windsurf/skills/to-prd/SKILL.md
@@ -0,0 +1,76 @@
+---
+name: to-prd
+description: Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
+---
+
+This skill takes the current conversation context and codebase understanding and produces a PRD. Do NOT interview the user — just synthesize what you already know.
+
+The issue tracker and triage label vocabulary should have been provided to you — run `/setup-matt-pocock-skills` if not.
+
+## Process
+
+1. Explore the repo to understand the current state of the codebase, if you haven't already. Use the project's domain glossary vocabulary throughout the PRD, and respect any ADRs in the area you're touching.
+
+2. Sketch out the major modules you will need to build or modify to complete the implementation. Actively look for opportunities to extract deep modules that can be tested in isolation.
+
+A deep module (as opposed to a shallow module) is one which encapsulates a lot of functionality in a simple, testable interface which rarely changes.
+
+Check with the user that these modules match their expectations. Check with the user which modules they want tests written for.
+
+3. Write the PRD using the template below, then publish it to the project issue tracker. Apply the `ready-for-agent` triage label - no need for additional triage.
+
+<prd-template>
+
+## Problem Statement
+
+The problem that the user is facing, from the user's perspective.
+
+## Solution
+
+The solution to the problem, from the user's perspective.
+
+## User Stories
+
+A LONG, numbered list of user stories. Each user story should be in the format of:
+
+1. As an <actor>, I want a <feature>, so that <benefit>
+
+<user-story-example>
+1. As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending
+</user-story-example>
+
+This list of user stories should be extremely extensive and cover all aspects of the feature.
+
+## Implementation Decisions
+
+A list of implementation decisions that were made. This can include:
+
+- The modules that will be built/modified
+- The interfaces of those modules that will be modified
+- Technical clarifications from the developer
+- Architectural decisions
+- Schema changes
+- API contracts
+- Specific interactions
+
+Do NOT include specific file paths or code snippets. They may end up being outdated very quickly.
+
+Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it within the relevant decision and note briefly that it came from a prototype. Trim to the decision-rich parts — not a working demo, just the important bits.
+
+## Testing Decisions
+
+A list of testing decisions that were made. Include:
+
+- A description of what makes a good test (only test external behavior, not implementation details)
+- Which modules will be tested
+- Prior art for the tests (i.e. similar types of tests in the codebase)
+
+## Out of Scope
+
+A description of the things that are out of scope for this PRD.
+
+## Further Notes
+
+Any further notes about the feature.
+
+</prd-template>
diff --git a/.windsurf/skills/triage/AGENT-BRIEF.md b/.windsurf/skills/triage/AGENT-BRIEF.md
new file mode 100644
index 0000000..2efecdf
--- /dev/null
+++ b/.windsurf/skills/triage/AGENT-BRIEF.md
@@ -0,0 +1,168 @@
+# Writing Agent Briefs
+
+An agent brief is a structured comment posted on a GitHub issue when it moves to `ready-for-agent`. It is the authoritative specification that an AFK agent will work from. The original issue body and discussion are context — the agent brief is the contract.
+
+## Principles
+
+### Durability over precision
+
+The issue may sit in `ready-for-agent` for days or weeks. The codebase will change in the meantime. Write the brief so it stays useful even as files are renamed, moved, or refactored.
+
+- **Do** describe interfaces, types, and behavioral contracts
+- **Do** name specific types, function signatures, or config shapes that the agent should look for or modify
+- **Don't** reference file paths — they go stale
+- **Don't** reference line numbers
+- **Don't** assume the current implementation structure will remain the same
+
+### Behavioral, not procedural
+
+Describe **what** the system should do, not **how** to implement it. The agent will explore the codebase fresh and make its own implementation decisions.
+
+- **Good:** "The `SkillConfig` type should accept an optional `schedule` field of type `CronExpression`"
+- **Bad:** "Open src/types/skill.ts and add a schedule field on line 42"
+- **Good:** "When a user runs `/triage` with no arguments, they should see a summary of issues needing attention"
+- **Bad:** "Add a switch statement in the main handler function"
+
+### Complete acceptance criteria
+
+The agent needs to know when it's done. Every agent brief must have concrete, testable acceptance criteria. Each criterion should be independently verifiable.
+
+- **Good:** "Running `gh issue list --label needs-triage` returns issues that have been through initial classification"
+- **Bad:** "Triage should work correctly"
+
+### Explicit scope boundaries
+
+State what is out of scope. This prevents the agent from gold-plating or making assumptions about adjacent features.
+
+## Template
+
+```markdown
+## Agent Brief
+
+**Category:** bug / enhancement
+**Summary:** one-line description of what needs to happen
+
+**Current behavior:**
+Describe what happens now. For bugs, this is the broken behavior.
+For enhancements, this is the status quo the feature builds on.
+
+**Desired behavior:**
+Describe what should happen after the agent's work is complete.
+Be specific about edge cases and error conditions.
+
+**Key interfaces:**
+- `TypeName` — what needs to change and why
+- `functionName()` return type — what it currently returns vs what it should return
+- Config shape — any new configuration options needed
+
+**Acceptance criteria:**
+- [ ] Specific, testable criterion 1
+- [ ] Specific, testable criterion 2
+- [ ] Specific, testable criterion 3
+
+**Out of scope:**
+- Thing that should NOT be changed or addressed in this issue
+- Adjacent feature that might seem related but is separate
+```
+
+## Examples
+
+### Good agent brief (bug)
+
+```markdown
+## Agent Brief
+
+**Category:** bug
+**Summary:** Skill description truncation drops mid-word, producing broken output
+
+**Current behavior:**
+When a skill description exceeds 1024 characters, it is truncated at exactly
+1024 characters regardless of word boundaries. This produces descriptions
+that end mid-word (e.g. "Use when the user wants to confi").
+
+**Desired behavior:**
+Truncation should break at the last word boundary before 1024 characters
+and append "..." to indicate truncation.
+
+**Key interfaces:**
+- The `SkillMetadata` type's `description` field — no type change needed,
+  but the validation/processing logic that populates it needs to respect
+  word boundaries
+- Any function that reads SKILL.md frontmatter and extracts the description
+
+**Acceptance criteria:**
+- [ ] Descriptions under 1024 chars are unchanged
+- [ ] Descriptions over 1024 chars are truncated at the last word boundary
+      before 1024 chars
+- [ ] Truncated descriptions end with "..."
+- [ ] The total length including "..." does not exceed 1024 chars
+
+**Out of scope:**
+- Changing the 1024 char limit itself
+- Multi-line description support
+```
+
+### Good agent brief (enhancement)
+
+```markdown
+## Agent Brief
+
+**Category:** enhancement
+**Summary:** Add `.out-of-scope/` directory support for tracking rejected feature requests
+
+**Current behavior:**
+When a feature request is rejected, the issue is closed with a `wontfix` label
+and a comment. There is no persistent record of the decision or reasoning.
+Future similar requests require the maintainer to recall or search for the
+prior discussion.
+
+**Desired behavior:**
+Rejected feature requests should be documented in `.out-of-scope/<concept>.md`
+files that capture the decision, reasoning, and links to all issues that
+requested the feature. When triaging new issues, these files should be
+checked for matches.
+
+**Key interfaces:**
+- Markdown file format in `.out-of-scope/` — each file should have a
+  `# Concept Name` heading, a `**Decision:**` line, a `**Reason:**` line,
+  and a `**Prior requests:**` list with issue links
+- The triage workflow should read all `.out-of-scope/*.md` files early
+  and match incoming issues against them by concept similarity
+
+**Acceptance criteria:**
+- [ ] Closing a feature as wontfix creates/updates a file in `.out-of-scope/`
+- [ ] The file includes the decision, reasoning, and link to the closed issue
+- [ ] If a matching `.out-of-scope/` file already exists, the new issue is
+      appended to its "Prior requests" list rather than creating a duplicate
+- [ ] During triage, existing `.out-of-scope/` files are checked and surfaced
+      when a new issue matches a prior rejection
+
+**Out of scope:**
+- Automated matching (human confirms the match)
+- Reopening previously rejected features
+- Bug reports (only enhancement rejections go to `.out-of-scope/`)
+```
+
+### Bad agent brief
+
+```markdown
+## Agent Brief
+
+**Summary:** Fix the triage bug
+
+**What to do:**
+The triage thing is broken. Look at the main file and fix it.
+The function around line 150 has the issue.
+
+**Files to change:**
+- src/triage/handler.ts (line 150)
+- src/types.ts (line 42)
+```
+
+This is bad because:
+- No category
+- Vague description ("the triage thing is broken")
+- References file paths and line numbers that will go stale
+- No acceptance criteria
+- No scope boundaries
+- No description of current vs desired behavior
diff --git a/.windsurf/skills/triage/OUT-OF-SCOPE.md b/.windsurf/skills/triage/OUT-OF-SCOPE.md
new file mode 100644
index 0000000..cc8ea25
--- /dev/null
+++ b/.windsurf/skills/triage/OUT-OF-SCOPE.md
@@ -0,0 +1,101 @@
+# Out-of-Scope Knowledge Base
+
+The `.out-of-scope/` directory in a repo stores persistent records of rejected feature requests. It serves two purposes:
+
+1. **Institutional memory** — why a feature was rejected, so the reasoning isn't lost when the issue is closed
+2. **Deduplication** — when a new issue comes in that matches a prior rejection, the skill can surface the previous decision instead of re-litigating it
+
+## Directory structure
+
+```
+.out-of-scope/
+├── dark-mode.md
+├── plugin-system.md
+└── graphql-api.md
+```
+
+One file per **concept**, not per issue. Multiple issues requesting the same thing are grouped under one file.
+
+## File format
+
+The file should be written in a relaxed, readable style — more like a short design document than a database entry. Use paragraphs, code samples, and examples to make the reasoning clear and useful to someone encountering it for the first time.
+
+```markdown
+# Dark Mode
+
+This project does not support dark mode or user-facing theming.
+
+## Why this is out of scope
+
+The rendering pipeline assumes a single color palette defined in
+`ThemeConfig`. Supporting multiple themes would require:
+
+- A theme context provider wrapping the entire component tree
+- Per-component theme-aware style resolution
+- A persistence layer for user theme preferences
+
+This is a significant architectural change that doesn't align with the
+project's focus on content authoring. Theming is a concern for downstream
+consumers who embed or redistribute the output.
+
+```ts
+// The current ThemeConfig interface is not designed for runtime switching:
+interface ThemeConfig {
+  colors: ColorPalette; // single palette, resolved at build time
+  fonts: FontStack;
+}
+```
+
+## Prior requests
+
+- #42 — "Add dark mode support"
+- #87 — "Night theme for accessibility"
+- #134 — "Dark theme option"
+```
+
+### Naming the file
+
+Use a short, descriptive kebab-case name for the concept: `dark-mode.md`, `plugin-system.md`, `graphql-api.md`. The name should be recognizable enough that someone browsing the directory understands what was rejected without opening the file.
+
+### Writing the reason
+
+The reason should be substantive — not "we don't want this" but why. Good reasons reference:
+
+- Project scope or philosophy ("This project focuses on X; theming is a downstream concern")
+- Technical constraints ("Supporting this would require Y, which conflicts with our Z architecture")
+- Strategic decisions ("We chose to use A instead of B because...")
+
+The reason should be durable. Avoid referencing temporary circumstances ("we're too busy right now") — those aren't real rejections, they're deferrals.
+
+## When to check `.out-of-scope/`
+
+During triage (Step 1: Gather context), read all files in `.out-of-scope/`. When evaluating a new issue:
+
+- Check if the request matches an existing out-of-scope concept
+- Matching is by concept similarity, not keyword — "night theme" matches `dark-mode.md`
+- If there's a match, surface it to the maintainer: "This is similar to `.out-of-scope/dark-mode.md` — we rejected this before because [reason]. Do you still feel the same way?"
+
+The maintainer may:
+
+- **Confirm** — the new issue gets added to the existing file's "Prior requests" list, then closed
+- **Reconsider** — the out-of-scope file gets deleted or updated, and the issue proceeds through normal triage
+- **Disagree** — the issues are related but distinct, proceed with normal triage
+
+## When to write to `.out-of-scope/`
+
+Only when an **enhancement** (not a bug) is rejected as `wontfix`. The flow:
+
+1. Maintainer decides a feature request is out of scope
+2. Check if a matching `.out-of-scope/` file already exists
+3. If yes: append the new issue to the "Prior requests" list
+4. If no: create a new file with the concept name, decision, reason, and first prior request
+5. Post a comment on the issue explaining the decision and mentioning the `.out-of-scope/` file
+6. Close the issue with the `wontfix` label
+
+## Updating or removing out-of-scope files
+
+If the maintainer changes their mind about a previously rejected concept:
+
+- Delete the `.out-of-scope/` file
+- The skill does not need to reopen old issues — they're historical records
+- The new issue that triggered the reconsideration proceeds through normal triage
diff --git a/.windsurf/skills/triage/SKILL.md b/.windsurf/skills/triage/SKILL.md
new file mode 100644
index 0000000..3dee68f
--- /dev/null
+++ b/.windsurf/skills/triage/SKILL.md
@@ -0,0 +1,103 @@
+---
+name: triage
+description: Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
+---
+
+# Triage
+
+Move issues on the project issue tracker through a small state machine of triage roles.
+
+Every comment or issue posted to the issue tracker during triage **must** start with this disclaimer:
+
+```
+> *This was generated by AI during triage.*
+```
+
+## Reference docs
+
+- [AGENT-BRIEF.md](AGENT-BRIEF.md) — how to write durable agent briefs
+- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — how the `.out-of-scope/` knowledge base works
+
+## Roles
+
+Two **category** roles:
+
+- `bug` — something is broken
+- `enhancement` — new feature or improvement
+
+Five **state** roles:
+
+- `needs-triage` — maintainer needs to evaluate
+- `needs-info` — waiting on reporter for more information
+- `ready-for-agent` — fully specified, ready for an AFK agent
+- `ready-for-human` — needs human implementation
+- `wontfix` — will not be actioned
+
+Every triaged issue should carry exactly one category role and one state role. If state roles conflict, flag it and ask the maintainer before doing anything else.
+
+These are canonical role names — the actual label strings used in the issue tracker may differ. The mapping should have been provided to you - run `/setup-matt-pocock-skills` if not.
+
+State transitions: an unlabeled issue normally goes to `needs-triage` first; from there it moves to `needs-info`, `ready-for-agent`, `ready-for-human`, or `wontfix`. `needs-info` returns to `needs-triage` once the reporter replies. The maintainer can override at any time — flag transitions that look unusual and ask before proceeding.
+
+## Invocation
+
+The maintainer invokes `/triage` and describes what they want in natural language. Interpret the request and act. Examples:
+
+- "Show me anything that needs my attention"
+- "Let's look at #42"
+- "Move #42 to ready-for-agent"
+- "What's ready for agents to pick up?"
+
+## Show what needs attention
+
+Query the issue tracker and present three buckets, oldest first:
+
+1. **Unlabeled** — never triaged.
+2. **`needs-triage`** — evaluation in progress.
+3. **`needs-info` with reporter activity since the last triage notes** — needs re-evaluation.
+
+Show counts and a one-line summary per issue. Let the maintainer pick.
+
+## Triage a specific issue
+
+1. **Gather context.** Read the full issue (body, comments, labels, reporter, dates). Parse any prior triage notes so you don't re-ask resolved questions. Explore the codebase using the project's domain glossary, respecting ADRs in the area. Read `.out-of-scope/*.md` and surface any prior rejection that resembles this issue.
+
+2. **Recommend.** Tell the maintainer your category and state recommendation with reasoning, plus a brief codebase summary relevant to the issue. Wait for direction.
+
+3. **Reproduce (bugs only).** Before any grilling, attempt reproduction: read the reporter's steps, trace the relevant code, run tests or commands. Report what happened — successful repro with code path, failed repro, or insufficient detail (a strong `needs-info` signal). A confirmed repro makes a much stronger agent brief.
+
+4. **Grill (if needed).** If the issue needs fleshing out, run a `/grill-with-docs` session.
+
+5. **Apply the outcome:**
+   - `ready-for-agent` — post an agent brief comment ([AGENT-BRIEF.md](AGENT-BRIEF.md)).
+   - `ready-for-human` — same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing).
+   - `needs-info` — post triage notes (template below).
+   - `wontfix` (bug) — polite explanation, then close.
+   - `wontfix` (enhancement) — write to `.out-of-scope/`, link to it from a comment, then close ([OUT-OF-SCOPE.md](OUT-OF-SCOPE.md)).
+   - `needs-triage` — apply the role. Optional comment if there's partial progress.
+
+## Quick state override
+
+If the maintainer says "move #42 to ready-for-agent", trust them and apply the role directly. Confirm what you're about to do (role changes, comment, close), then act. Skip grilling. If moving to `ready-for-agent` without a grilling session, ask whether they want to write an agent brief.
+
+## Needs-info template
+
+```markdown
+## Triage Notes
+
+**What we've established so far:**
+
+- point 1
+- point 2
+
+**What we still need from you (@reporter):**
+
+- question 1
+- question 2
+```
+
+Capture everything resolved during grilling under "established so far" so the work isn't lost. Questions must be specific and actionable, not "please provide more info".
+
+## Resuming a previous session
+
+If prior triage notes exist on the issue, read them, check whether the reporter has answered any outstanding questions, and present an updated picture before continuing. Don't re-ask resolved questions.
diff --git a/.windsurf/skills/write-a-skill/SKILL.md b/.windsurf/skills/write-a-skill/SKILL.md
new file mode 100644
index 0000000..7339c8a
--- /dev/null
+++ b/.windsurf/skills/write-a-skill/SKILL.md
@@ -0,0 +1,117 @@
+---
+name: write-a-skill
+description: Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
+---
+
+# Writing Skills
+
+## Process
+
+1. **Gather requirements** - ask user about:
+   - What task/domain does the skill cover?
+   - What specific use cases should it handle?
+   - Does it need executable scripts or just instructions?
+   - Any reference materials to include?
+
+2. **Draft the skill** - create:
+   - SKILL.md with concise instructions
+   - Additional reference files if content exceeds 500 lines
+   - Utility scripts if deterministic operations needed
+
+3. **Review with user** - present draft and ask:
+   - Does this cover your use cases?
+   - Anything missing or unclear?
+   - Should any section be more/less detailed?
+
+## Skill Structure
+
+```
+skill-name/
+├── SKILL.md           # Main instructions (required)
+├── REFERENCE.md       # Detailed docs (if needed)
+├── EXAMPLES.md        # Usage examples (if needed)
+└── scripts/           # Utility scripts (if needed)
+    └── helper.js
+```
+
+## SKILL.md Template
+
+```md
+---
+name: skill-name
+description: Brief description of capability. Use when [specific triggers].
+---
+
+# Skill Name
+
+## Quick start
+
+[Minimal working example]
+
+## Workflows
+
+[Step-by-step processes with checklists for complex tasks]
+
+## Advanced features
+
+[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
+```
+
+## Description Requirements
+
+The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
+
+**Goal**: Give your agent just enough info to know:
+
+1. What capability this skill provides
+2. When/why to trigger it (specific keywords, contexts, file types)
+
+**Format**:
+
+- Max 1024 chars
+- Write in third person
+- First sentence: what it does
+- Second sentence: "Use when [specific triggers]"
+
+**Good example**:
+
+```
+Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
+```
+
+**Bad example**:
+
+```
+Helps with documents.
+```
+
+The bad example gives your agent no way to distinguish this from other document skills.
+
+## When to Add Scripts
+
+Add utility scripts when:
+
+- Operation is deterministic (validation, formatting)
+- Same code would be generated repeatedly
+- Errors need explicit handling
+
+Scripts save tokens and improve reliability vs generated code.
+
+## When to Split Files
+
+Split into separate files when:
+
+- SKILL.md exceeds 100 lines
+- Content has distinct domains (finance vs sales schemas)
+- Advanced features are rarely needed
+
+## Review Checklist
+
+After drafting, verify:
+
+- [ ] Description includes triggers ("Use when...")
+- [ ] SKILL.md under 100 lines
+- [ ] No time-sensitive info
+- [ ] Consistent terminology
+- [ ] Concrete examples included
+- [ ] References one level deep
diff --git a/.windsurf/skills/zoom-out/SKILL.md b/.windsurf/skills/zoom-out/SKILL.md
new file mode 100644
index 0000000..1e7a5dc
--- /dev/null
+++ b/.windsurf/skills/zoom-out/SKILL.md
@@ -0,0 +1,7 @@
+---
+name: zoom-out
+description: Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
+disable-model-invocation: true
+---
+
+I don't know this area of code well. Go up a layer of abstraction. Give me a map of all the relevant modules and callers, using the project's domain glossary vocabulary.
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..d3317ae
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,136 @@
+# Agent 操作规范
+
+Commory 是一个本地优先的通信记忆 monorepo。工作时保持上下文收窄，尊重用户已有改动，并验证你实际触碰的范围。
+
+## 行为准则（硬约束）
+
+### 编码前思考
+
+- 不要假设。不确定时明确提问，不要默默选一种解释执行。
+- 存在多种合理方案时，呈现权衡，不要自行选择。
+- 存在更简单的做法时，提出异议。困惑时停下来，指出不清楚的地方。
+
+### 简洁优先
+
+- 用最少的代码解决问题。不要添加要求之外的功能、未请求的抽象或"灵活性"。
+- 不为不可能发生的场景做错误处理。200 行能写成 50 行的，重写。
+- 检验标准：资深工程师会觉得过于复杂吗？如果是，简化。
+
+### 精准修改
+
+- 只碰必须碰的。不要"改进"相邻代码、注释或格式，不要重构没坏的东西。
+- 匹配现有风格，即使你偏好不同写法。
+- 注意到无关死代码时提一下，不要自行删除。
+- 你的改动产生的孤儿代码（无用的 import/变量/函数）由你清理；预先存在的死代码不动。
+- 检验标准：每一行修改都应能直接追溯到用户的请求。
+
+### 目标驱动执行
+
+- 将指令式任务转化为可验证目标："添加验证" → "为无效输入写测试，然后让它们通过"。
+- 多步骤任务先列简短计划，每步附验证方式。
+- 强成功标准让 Agent 能独立循环；弱标准（"让它工作"）需要不断澄清。
+
+## 先读这些
+
+- Android UI 或移动端产品工作：`android/README.md`、`android/app/src/main/java/com/iskenkenya/commory/mobile/ui/navigation/NavigationHost.kt`、`android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/`，以及目标 screen 或 ViewModel。
+- Android 数据、认证、存储工作：`android/sdk/backup`、`android/sdk/auth`、`android/sdk/storage`，以及 `android/app/src/main/java/com/iskenkenya/commory/mobile/remote/`。
+- Backend API 工作：`backend/internal/api/server.go`、`backend/internal/auth`、`backend/internal/storage`，以及 `docs/mobile-api.md`。
+- Web dashboard 工作：`web/package.json`、`web/src/api`、`web/src/router`，以及目标 view/store 模块。
+- MsgLayer/schema 工作：`msglayer/schema/v0.1/root.schema.json`、`msglayer/examples`，以及 `backend/internal/msglayer`。
+- 治理或 CI 工作：`docs/engineering-standards.md`、`.github/workflows/ci.yml`、`scripts/`、`.agents/skills`、`.claude/skills`。
+- Docker/部署工作：`Dockerfile`、`docker-compose.yml`、`.env.example`、backend config、web production env。
+
+## 上下文包
+
+- Android UI 包：navigation host、目标 screen、`values/`、`values-en/`、`values-zh-rCN/` 中的资源，以及相关 ViewModel。
+- Android auth/network 包：runtime environment、auth provider、server client、SDK auth/storage contracts，以及移动端 API 文档。
+- Backend API 包：server handler、auth middleware/service、storage provider、API tests，以及移动端 API contract。
+- Web dashboard 包：API client、auth store、route guard、目标 view，以及 `web/` 已使用的 Element Plus patterns。
+- MsgLayer 包：schema、examples、validators、Android mapper/serializer。
+- 治理包：engineering standards、CI workflow、repo hygiene、skills sync、i18n check。
+- 部署包：Dockerfile、Compose、环境变量、backend static handler、Web build 输出。
+
+只加载任务需要的上下文包。不要把临时决策扩散到工具专属文件；长期规则放在 `docs/engineering-standards.md`，Agent 入口放在本文件，发布历史放在 `CHANGELOG.md`。
+
+## 结构治理
+
+- 单文件只承载一个 feature slice 或一个清晰的层级职责；不要把多个独立功能继续堆进 `server.go`、`*service.go`、provider 实现文件。
+- 新增代码默认先并入现有同职责文件；仅在跨职责、逼近阈值或能明显改善审阅边界时拆分。
+- 禁止为了“拆分”制造 1 函数 / 1 类型微文件。新增紧耦合 helper 若总量低于约 `80` 行，默认并入同 feature 文件。
+- 手写业务源码进入重构警戒线为 `350` 行，硬上限为 `500` 行；生成代码、schema、fixture、资源文件不纳入硬失败，但超过 `1000` 行仍需在复杂度报告中暴露。
+- Web 参考基线以 `web/reference-baseline-paths.txt` 显式登记，覆盖 `references/art-design-pro` 演化而来的路径前缀；这些 baseline 文件会单独报表，不按 Commory-owned Web 代码执行 `500` 行硬失败。
+- `bash scripts/check-repo-hygiene.sh` 默认对当前变更集中的 Commory-owned 手写源码执行 `500` 行硬门禁；全仓历史热点与 Web baseline 热区由 `bash scripts/report-loc-complexity.sh` 暴露，并按触碰范围持续治理。
+- handler 层按认证、导入、查询、会话、审计等能力分组；auth 层按 orchestration、token、password、audit/rate-limit 分组；storage provider 按 import/query、auth/session、setup/passkey/support 分组；test 按行为域分组，不保留 mega test file。
+- 跨 Android、Backend、Web 的改动必须同步评估契约、测试、文档和部署影响。
+- 默认按纵向切片推进：先修契约与基础层，再补客户端，再补 UI/治理；不要堆叠不可审阅的大 diff。
+- 默认不使用 subagent 或平行代理；只有用户明确要求委派、分工或 parallel agent work 时才可使用。
+- 面向用户的最终交付禁止包含原始 scratchpad、逐段回放式研究过程或重复的中间分析；保留决策、变更、验证和风险即可。
+- 长期规则变更必须同步更新 `AGENTS.md` 与 `CLAUDE.md`，不能只写进其它文档。
+
+## 仓库边界
+
+- `previewer/` 是历史归档。当前 Commory 工作不要更新它。
+- `references/` 是只读外部参考代码。把思路改写进 Commory 自有模块，不要编辑参考镜像。
+- `.agents/skills` 是项目 skills 的唯一手工维护来源。
+- `.claude/skills` 是 Claude Code 兼容镜像，由脚本生成。不要手改；运行 `bash scripts/sync-agent-skills.sh`。
+- 不要新增 `AI_EDIT_LOG.md`、调试报告、已追踪日志、构建产物、`.DS_Store` 或 IDE/cache 文件。
+
+## 项目管理
+
+- `CHANGELOG.md` 记录用户可见变更、兼容性影响和迁移说明；当前版本采用 `v0.x.y`。
+- `docs/project-management.md` 定义发布、分支、PR 和两审合并规则。
+- `docs/technical-debt.md` 记录已知技术债，不要把无关债务混入功能 PR。
+- 禁止直接推送 `main`；`feat/*` 用于功能，`fix/*` 用于修复。
+- 跨 Android、Backend、Web、MsgLayer、Agent、Docker 的变更必须同步评估契约、文档、测试和部署影响。
+- 大文件或大 diff 若暂时无法继续拆分，必须在 PR 或交付说明里给出简短理由。
+
+## 命名
+
+- Android app id：`com.iskenkenya.commory`。
+- Android app namespace 和源码包：`com.iskenkenya.commory.mobile`。
+- Android SDK 包：`com.iskenkenya.commory.sdk.*`。
+- Go backend module 保持 `github.com/IsKenKenYa/Commory/backend`；它不与 Android 包名冲突。
+- 当前用户可见产品名是 `Commory`。历史 changelog 可以保留旧名称作为历史。
+
+## 中文优先与国际化
+
+- 文档、Rules、注释、维护者提示、数据库备注中文优先；必要时第一次出现写作“中文（English）”。
+- 产品代码不要为了“中文优先”写死中文。用户可见文本必须进入 i18n/resource 体系。
+- Web 使用 `vue-i18n`，语言包位于 `web/src/locales/langs/zh.json` 与 `web/src/locales/langs/en.json`。
+- Android 用户可见字符串必须同时维护 `values/strings.xml`、`values-en/strings.xml`、`values-zh-rCN/strings.xml`。
+- 系统内置国际化只负责中文和英文；其他语言可以由社区后续扩展。
+- 不要翻译代码标识符、JSON key、数据库字段名、HTTP endpoint、配置项、命令、包名、常量值和公开契约。
+- `README.en.md` 是英文 README，保持英文；中文 README 更新了产品能力时，同步检查英文 README 是否需要对应更新。
+
+## Web Dashboard
+
+- Web UI 以 `references/art-design-pro` 为模板基线，以 `references/memos/web` 为产品组织参考；只学习结构，不复制参考源码。
+- 遇到模糊需求先用 `.agents/skills/grill-me` 收窄边界；改动陌生区域先用 `.agents/skills/zoom-out` 识别影响面；缺陷回归优先按 `.agents/skills/diagnose` / `.agents/skills/tdd` 留下复现与验证；长链路协作或交接前补 `.agents/skills/handoff` 风格摘要。
+- 新 Web 页面必须满足中英 i18n、dark mode、主题变量、ECharts 配色、布局密度和 Element Plus 使用规范。
+- 具体规则见 `docs/web-dashboard-guidelines.md`。
+
+## 部署
+
+- 默认部署形态是单端口：Go backend 同时提供 `/api/*` 和 Web 静态资源。
+- 生产镜像使用根目录 `Dockerfile`；不要新增 `Dockerfile.backend` 或 `web/Dockerfile`，除非后续明确拆分企业部署。
+- `docker-compose.yml` 只暴露一个外部端口，默认 `3000:3000`，避免 CORS 成为默认复杂度。
+- Web production API 使用同源 `/`，开发环境继续通过 Vite proxy 转发 `/api`。
+
+## Skills
+
+项目 skills 必须遵循 Codex skill 形态：
+
+- 必需：`SKILL.md`，包含简洁 YAML frontmatter（`name`、`description`）和精简 workflow。
+- 推荐：需要 UI metadata 时使用 `agents/openai.yaml`。
+- 可选：`scripts/`、`references/`、`assets/`。
+- 禁止放入 skill：`README.md`、`CHANGELOG.md`、`AGENTS.md`、安装指南、快速参考或大段重复文档。
+
+创建或更新 skill 时，保持 `SKILL.md` 简短，把详细变体移到 `references/` 下直接链接的文件，并运行 `bash scripts/sync-agent-skills.sh`。
+
+## 验证
+
+- Backend：`cd backend && go vet ./... && go test ./... -coverprofile=coverage.out`。
+- Android：`cd android && ./gradlew :app:compileDebugKotlin && ./gradlew :app:testDebugUnitTest`。
+- Web：`cd web && pnpm install --frozen-lockfile && pnpm lint && pnpm build`。
+- 治理：`bash scripts/check-repo-hygiene.sh`、`bash scripts/check-android-i18n.sh`、`bash scripts/sync-agent-skills.sh --check`、`bash scripts/report-loc-complexity.sh`。
+- Docker：`docker compose config`、`docker compose build`，必要时 `docker compose up` 后检查 `/` 与 `/api/setup`。
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..a13aeb2
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,19 @@
+# Changelog
+
+Commory 使用 `v0.x.y` 语义化版本。`v0` 阶段 API 和 schema 仍可能变化；每个版本必须记录用户可见变更、兼容性影响和迁移说明。
+
+## Unreleased
+
+### Added
+
+- 单端口部署规划：Go backend 可同时提供 `/api` 和 Web 静态资源。
+- 根目录 Docker Compose 开发部署入口。
+- 项目管理、技术债和 Web dashboard 规范文档。
+
+### Changed
+
+- Web 生产环境 API 默认改为同源 `/`，避免生产部署中的 CORS 配置负担。
+
+### Compatibility
+
+- 当前 Docker Compose 仍使用 file-backed sqlite 开发存储；真实 SQL 存储迁移以后再扩展 Postgres/MySQL 部署方案。
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..601fe1a
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+Claude Code 应把 `AGENTS.md` 视为项目唯一的规范入口。
+
+## 行为准则（硬约束）
+
+### 编码前思考
+
+- 不要假设。不确定时明确提问，不要默默选一种解释执行。
+- 存在多种合理方案时，呈现权衡，不要自行选择。
+- 存在更简单的做法时，提出异议。困惑时停下来，指出不清楚的地方。
+
+### 简洁优先
+
+- 用最少的代码解决问题。不要添加要求之外的功能、未请求的抽象或"灵活性"。
+- 不为不可能发生的场景做错误处理。200 行能写成 50 行的，重写。
+- 检验标准：资深工程师会觉得过于复杂吗？如果是，简化。
+
+### 精准修改
+
+- 只碰必须碰的。不要"改进"相邻代码、注释或格式，不要重构没坏的东西。
+- 匹配现有风格，即使你偏好不同写法。
+- 注意到无关死代码时提一下，不要自行删除。
+- 你的改动产生的孤儿代码（无用的 import/变量/函数）由你清理；预先存在的死代码不动。
+- 检验标准：每一行修改都应能直接追溯到用户的请求。
+
+### 目标驱动执行
+
+- 将指令式任务转化为可验证目标："添加验证" → "为无效输入写测试，然后让它们通过"。
+- 多步骤任务先列简短计划，每步附验证方式。
+- 强成功标准让 Agent 能独立循环；弱标准（"让它工作"）需要不断澄清。
+
+
+**权衡**：这些准则倾向于谨慎而非速度。琐碎任务（显而易见的一行修改）自行判断，不必走完整流程。目标是减少非琐碎工作中的代价高昂的错误。
+
+## 结构治理
+
+- 单文件只承载一个 feature slice 或一个清晰职责，不继续向 `server.go`、`*service.go`、provider 实现文件堆多个独立功能。
+- 新增代码默认先并入现有同职责文件；仅在跨职责、逼近阈值或能明显改善审阅边界时拆分。
+- 禁止为了"拆分"制造 1 函数 / 1 类型微文件；低于约 `80` 行的紧耦合 helper 默认并入同 feature 文件。
+- 手写业务源码 `350` 行进入重构警戒线，`500` 行为硬上限；生成代码、schema、fixture、资源文件不做硬失败，但要在复杂度报告里暴露 `1000+` 文件。
+- Web 参考基线通过 `web/reference-baseline-paths.txt` 显式维护；这些参考衍生文件单独报表，不按 Commory-owned Web 代码执行 `500` 行硬失败。
+- `bash scripts/check-repo-hygiene.sh` 默认拦截当前变更集中的 Commory-owned `500+` 手写源码；全仓历史热点和 Web baseline 热区继续通过 `bash scripts/report-loc-complexity.sh` 报告。
+- handler 层按认证、导入、查询、会话、审计等能力分组；auth 层按 orchestration、token、password、audit/rate-limit 分组；storage provider 按 import/query、auth/session、setup/passkey/support 分组。
+- 跨 Android、Backend、Web 的改动必须同步评估契约、测试、文档和部署影响，并按纵向切片推进，避免不可审阅的大 diff。
+- 默认不使用 subagent 或平行代理；只有用户明确要求委派或分工时才可使用。
+- 面向用户的交付不要回放原始 scratchpad 或重复中间研究结论，只保留决策、变更、验证和风险。
+- 长期规则变更必须同步更新 `AGENTS.md` 与 `CLAUDE.md`；详细说明服从 `docs/engineering-standards.md`。
+
+## 仓库边界
+
+- `previewer/` 是历史归档。当前 Commory 工作不要更新它。
+- `references/` 是只读外部参考代码。把思路改写进 Commory 自有模块，不要编辑参考镜像。
+- `.agents/skills` 是项目 skills 的唯一手工维护来源。
+- `.claude/skills` 是 Claude Code 兼容镜像，由脚本生成。不要手改；运行 `bash scripts/sync-agent-skills.sh`。
+- 不要新增 `AI_EDIT_LOG.md`、调试报告、已追踪日志、构建产物、`.DS_Store` 或 IDE/cache 文件。
+
+## 项目管理
+
+- `CHANGELOG.md` 记录用户可见变更、兼容性影响和迁移说明。
+- `docs/project-management.md` 定义发布、分支、PR 和两审合并规则。
+- `docs/technical-debt.md` 记录已知技术债，不要把无关债务混入功能 PR。
+- 禁止直接推送 `main`；`feat/*` 用于功能，`fix/*` 用于修复。
+
+## 中文优先与国际化
+
+- 文档、Rules、注释、维护者提示、数据库备注中文优先。
+- 产品代码不要为了"中文优先"写死中文。用户可见文本必须进入 i18n/resource 体系。
+- Web 使用 `vue-i18n`，语言包位于 `web/src/locales/langs/zh.json` 与 `web/src/locales/langs/en.json`。
+- Android 用户可见字符串必须同时维护 `values/strings.xml`、`values-en/strings.xml`、`values-zh-rCN/strings.xml`。
+- 不要翻译代码标识符、JSON key、数据库字段名、HTTP endpoint、配置项、命令、包名、常量值和公开契约。
+- `README.en.md` 保持英文，中文 README 是主要维护入口。
+
+## Skills
+
+- `.agents/skills` 是项目 skills 的唯一手工维护来源。
+- `.claude/skills` 是 Claude Code 兼容镜像。
+- 不要直接编辑 `.claude/skills`。先更新 `.agents/skills`，再运行：
+
+```bash
+bash scripts/sync-agent-skills.sh
+```
+
+创建或更新 skill 时，保持 `SKILL.md` 简短，把详细变体移到 `references/` 下直接链接的文件。
+
+## 部署与 Web
+
+- 默认部署是单端口：Go backend 同时提供 `/api/*` 和 Web 静态资源。
+- 根目录 `Dockerfile` 是完整 Commory 镜像；`docker-compose.yml` 默认只暴露 `3000`。
+- `docker-compose.yml` 只暴露一个外部端口，默认 `3000:3000`，避免 CORS 成为默认复杂度。
+- Web production API 使用同源 `/`，开发环境继续通过 Vite proxy 转发 `/api`。
+- Web UI 必须遵循 `docs/web-dashboard-guidelines.md`，以 `references/art-design-pro` 为模板基线。
+- 模糊需求先跑 `.agents/skills/grill-me`，陌生区域先做 `.agents/skills/zoom-out`，回归问题优先按 `.agents/skills/diagnose` 或 `.agents/skills/tdd` 留痕。
+- 多端功能必须同步评估 Android、Backend、Web、MsgLayer、Agent 和 Docker/部署影响。
+
+## 常用命令
+
+```bash
+bash scripts/dev.sh                    # 一键启动 backend (:3000) + web (:3006)
+bash scripts/check-repo-hygiene.sh
+bash scripts/check-android-i18n.sh
+bash scripts/sync-agent-skills.sh --check
+docker compose config
+```
+
+代码工作使用 `AGENTS.md` 中列出的验证命令。
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..a29ec65
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,34 @@
+# syntax=docker/dockerfile:1
+
+FROM node:22-alpine AS web-builder
+WORKDIR /src/web
+RUN corepack enable && corepack prepare pnpm@10.29.3 --activate
+COPY web/package.json web/pnpm-lock.yaml ./
+RUN HUSKY=0 pnpm install --frozen-lockfile
+COPY web/ ./
+RUN pnpm exec vite build && pnpm exec vue-tsc --noEmit
+
+FROM golang:1.25-alpine AS backend-builder
+RUN apk add --no-cache gcc musl-dev
+WORKDIR /src/backend
+COPY backend/go.mod backend/go.sum ./
+RUN go mod download
+COPY backend/ ./
+RUN CGO_ENABLED=1 go build -ldflags="-s -w" -o /out/commory ./cmd/commory
+
+FROM alpine:3.22
+RUN addgroup -S commory && adduser -S commory -G commory
+WORKDIR /app
+COPY --from=backend-builder /out/commory /usr/local/bin/commory
+COPY msglayer/schema /app/msglayer/schema
+COPY --from=web-builder /src/web/dist /app/web
+RUN mkdir -p /data && chown -R commory:commory /data /app
+USER commory
+ENV COMMORY_LISTEN_ADDR=:3000 \
+    COMMORY_DB_DRIVER=sqlite \
+    COMMORY_DB_DSN=/data/commory.db \
+    COMMORY_SCHEMA_ROOT=/app/msglayer/schema/v0.1/root.schema.json \
+    COMMORY_WEB_ROOT=/app/web \
+    COMMORY_ENV=production
+EXPOSE 3000
+CMD ["commory", "serve"]
diff --git a/NOTICE.md b/NOTICE.md
index a07ae61..cebd9ae 100644
--- a/NOTICE.md
+++ b/NOTICE.md
@@ -1,60 +1,37 @@
-# MessageVault 项目规范
+# Commory 治理声明
 
-## 🏗️ 编码标准
+Commory 是一个本地优先的通信记忆系统。项目把短信、通话记录、联系人和未来可扩展的通信来源转换为结构化 MsgLayer 数据，用户可以保存在本地，也可以选择同步到自托管服务器。
 
-### 命名规范
-- **Kotlin**: 遵循 [Kotlin 编码规范](https://kotlinlang.org/docs/coding-conventions.html)
-- **JavaScript/Vue**: 遵循 [Vue.js 风格指南](https://vuejs.org/style-guide/)
-- **文件命名**: Kotlin 使用 PascalCase（类文件）和 camelCase（工具文件），Vue 使用 PascalCase
+## 原则
 
-### 代码风格
-- 使用一致的缩进（Kotlin 4空格，JavaScript 2空格）
-- 每个文件末尾保留一个空行
-- 避免过长的行（建议 120 字符以内）
+- 本地优先：Android 在没有服务器账号或网络时也必须可用。
+- 服务器可选：Commory Server 提供同步、搜索和远程恢复能力，但不能成为本地备份的隐藏前置条件。
+- 隐私可控：日志、错误、分析、文档和测试不得暴露短信正文、联系人内容、access token、refresh token 或私有备份载荷。
+- 契约驱动：Android、backend、web、MsgLayer 的跨边界变更必须同步更新文档和测试。
+- 中文优先但不放弃国际化：维护文档和注释优先中文；产品用户可见文案必须走中英文 i18n/resource。
 
-### 架构原则
-- Android: MVVM + Repository Pattern
-- Vue: Composition API + 单向数据流
-- 模块化设计，职责分离
+## 仓库边界
 
-## 💬 注释要求
+- `android/`：Commory Android 客户端和 SDK 模块。
+- `backend/`：自托管 Commory Server。
+- `web/`：server-backed workflow 使用的 Vue dashboard。
+- `msglayer/`：canonical interchange schema 和 examples。
+- `docs/`：当前工程和 API 文档。
+- `previewer/`：历史 XML SMS viewer 归档；当前工作不要更新。
+- `references/`：只读外部参考代码；不要在那里开发功能。
 
-- 公共 API 必须包含文档注释
-- 复杂逻辑必须添加行内注释
-- 注释使用中文或英文，保持项目内一致
+## 变更历史
 
-## 🔧 可扩展性
+使用标准 changelog 和 review 渠道：
 
-- 使用接口/抽象类定义扩展点
-- 遵循开闭原则（对扩展开放，对修改关闭）
-- 新功能应通过模块方式添加
+- 持久发布历史写入对应的 `CHANGELOG.md`。
+- Pull request 和 commit 说明实现细节、测试情况，以及必要的 AI 协助说明。
+- 不要创建或更新 `AI_EDIT_LOG.md`；AI 协助不使用专门旁路日志记录。
 
-## 🧪 测试要求
+## 标准
 
-- 核心功能必须有单元测试
-- 关键流程需要集成测试
-- 测试覆盖率目标：核心模块 > 70%
+`docs/engineering-standards.md` 是唯一工程标准。它覆盖命名、包结构、skills、测试、日志、上下文管理、国际化边界和反膨胀规则。
 
-## 📝 变更记录
+## 许可证
 
-- 每个版本更新必须更新 CHANGELOG.md
-- 遵循 [Keep a Changelog](https://keepachangelog.com/) 格式
-- AI 辅助编辑需记录到 AI_EDIT_LOG.md
-
-## 📚 文档要求
-
-- 每个子项目必须有 README.md
-- API 变更必须更新文档
-- 用户可见的变更需更新用户手册
-
-## 📦 Monorepo 结构
-
-```
-MessageVault/
-├── android/          # MessageVault-Mobile (Kotlin/Android)
-├── previewer/        # SMS-Previewer (Vue 3/Vite)
-├── .trae/            # 开发工具配置
-├── LICENSE           # GPL v3.0
-├── NOTICE.md         # 项目规范
-└── README.md         # 项目总览
-```
+仓库根目录采用 GPL v3。`references/` 下的外部代码保持其上游许可证，并不会自动成为 Commory 可分发源码的一部分。
diff --git a/README.en.md b/README.en.md
new file mode 100644
index 0000000..3d5afee
--- /dev/null
+++ b/README.en.md
@@ -0,0 +1,80 @@
+# Commory
+
+> Turn communication into memory.
+
+Commory is a local-first communication memory system. It turns SMS, call logs, contacts, and future communication sources into structured, queryable, syncable, AI-ready personal data assets.
+
+Commory is not a backup-file-only tool. Backup is the entry point; the goal is a durable data layer for personal communication history.
+
+## Architecture
+
+```text
+Commory
+├── android/     # Android client: local backup, restore, optional server sync
+├── backend/     # Commory Server: auth, imports, query, self-hosted API
+├── web/         # Vue dashboard for server-backed workflows
+├── msglayer/    # Canonical cross-platform communication schema
+├── docs/        # Current engineering and API documentation
+├── scripts/     # CI and governance scripts
+├── previewer/   # Historical XML SMS viewer archive; do not update
+└── references/  # Read-only external reference code
+```
+
+The current product state is local backup plus optional server upload. The next step is bidirectional sync: upload, remote restore, and incremental sync. Long-term directions include end-to-end encryption, multi-device sync, and AI Agent context.
+
+The core principles remain: local-first, server-optional, privacy-controlled.
+
+## Chinese-First Docs And Internationalization
+
+Chinese is the preferred language for maintainer-facing docs, rules, comments, and operational notes because the current maintainer is a native Chinese speaker. This English README remains the English entrypoint.
+
+User-facing product text must not be hard-coded in either Chinese or English. Web uses `vue-i18n` with `web/src/locales/langs/zh.json` and `web/src/locales/langs/en.json`; Android uses `values/`, `values-en/`, and `values-zh-rCN/` resources. Built-in internationalization covers Chinese and English; additional languages can be community-maintained later.
+
+## Components
+
+- `android/`: Commory Android client. App id is `com.iskenkenya.commory`; app source namespace is `com.iskenkenya.commory.mobile`; SDK namespaces are `com.iskenkenya.commory.sdk.*`.
+- `backend/`: self-hosted Commory Server in Go. The mobile API contract lives in `docs/mobile-api.md`.
+- `web/`: Vue 3, Vite, and Element Plus dashboard.
+- `msglayer/`: canonical JSON Schema interchange format.
+- `previewer/`: historical XML SMS viewer archive. It is kept as old code and is not part of current CI, docs, or roadmap work.
+
+## Quick Start
+
+```bash
+cd android
+./gradlew :app:compileDebugKotlin
+./gradlew :app:testDebugUnitTest
+```
+
+```bash
+cd backend
+go test ./...
+go run ./cmd/commory
+```
+
+```bash
+cd web
+pnpm install
+pnpm dev
+```
+
+## Governance
+
+- Agent entrypoint: `AGENTS.md`
+- Engineering standards: `docs/engineering-standards.md`
+- Governance notice: `NOTICE.md`
+- Mobile API contract: `docs/mobile-api.md`
+- ADRs:
+  - `docs/adr/0001-参考资料治理.md`
+  - `docs/adr/0002-数据库-sqlc-迁移.md`
+  - `docs/adr/0003-agent-运行时边界.md`
+
+`.agents/skills` is the source of truth for project skills. `.claude/skills` is the Claude Code compatibility mirror. After changing skills, run:
+
+```bash
+bash scripts/sync-agent-skills.sh
+```
+
+## License
+
+The root repository is licensed under [GNU General Public License v3.0](LICENSE). External references under `references/` keep their upstream licenses.
diff --git a/README.md b/README.md
index 89c4b0d..81d62c2 100644
--- a/README.md
+++ b/README.md
@@ -1,231 +1,117 @@
-<div align="center">
+[English](README.en.md) | 简体中文
 
-# 📱 MessageVault 信驿云储
+# Commory
 
-🔒 **安全、私密、自主可控的短信与通话记录备份解决方案**
+> Turn communication into memory.
 
-[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-[![Made with ❤️](https://img.shields.io/badge/Made%20with-❤️-red.svg)](https://github.com/MessageVault)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/MessageVault)
+Commory 是一个本地优先的通信记忆系统，用来把短信、通话记录、联系人以及后续可扩展的数据源转成结构化、可查询、可同步、AI-ready 的个人数据资产。
 
-</div>
+Commory 不是“导出一个备份文件就结束”的工具。备份是入口，目标是让个人通信历史成为长期可维护的数据层。
 
-MessageVault是一个开源项目，为Android用户提供安全、私密的短信和通话记录备份与分析解决方案。作为一个完整的全栈式开源项目，所有数据都存储在用户自己控制的服务器上，无需依赖第三方云服务。
+## 架构
 
-## 🚀 项目愿景
+```text
+Commory
+├── android/     # Android 客户端：本地备份、恢复、可选服务器同步
+├── backend/     # Commory Server：认证、导入、查询、自托管 API
+├── web/         # Vue dashboard：服务器管理与查看体验
+├── msglayer/    # Canonical schema：跨端通信数据契约
+├── docs/        # 当前工程标准与 API 文档
+├── scripts/     # CI 与治理脚本
+├── previewer/   # 历史 XML SMS viewer 归档，不再更新
+└── references/  # 只读外部参考源码
+```
 
-- 🔒 **完全自主**: 数据完全在用户控制下，无第三方依赖
-- 🛡️ **隐私优先**: 所有数据本地存储或自托管服务器
-- 🔄 **跨设备同步**: 支持多设备备份和数据管理
-- 📊 **智能分析**: 本地AI分析，保护隐私的数据洞察
-- 🔧 **模块化设计**: 可扩展的架构，便于添加新功能
-- 🎯 **全栈理念**: 从移动端到服务端，从数据存储到用户界面的完整解决方案
+当前状态是“本地备份 + 可选服务器上传”。下一步演进目标是双向同步：上传、远程恢复、增量同步。远期方向是端到端加密、多设备同步和 AI Agent 上下文。
 
-## 📦 项目组件
+核心原则保持不变：本地优先，服务器可选，隐私可控。
 
-### 📱 android/ — MessageVault-Mobile `v0.1.4` ⭐ **主力项目**
+## 中文优先与国际化
 
-现代化Android应用，采用Material Design 3设计
-- ✅ **短信备份**: 完整支持SMS备份，包含所有元数据
-- ✅ **通话记录备份**: 完整支持通话历史记录备份
-- ✅ **联系人备份**: 完整支持联系人信息备份
-- ✅ **智能恢复**: 支持选择性恢复，带进度显示
-- ✅ **Material You**: 支持动态取色和深色主题
-- ✅ **多语言**: 中文/英文界面支持
+中文是项目维护资料的优先语言，便于当前维护者快速理解架构、规则和上下文；[README.en.md](README.en.md) 保持英文版，不会因为中文优先而放弃国际化。
 
-**技术栈**: Kotlin · Jetpack Compose · Material Design 3 · MVVM · Room · Kotlin Coroutines
+产品代码中的用户可见文案不应硬编码中文或英文。Web 使用 `vue-i18n`，内置 `web/src/locales/langs/zh.json` 与 `web/src/locales/langs/en.json`；Android 使用 `values/`、`values-en/`、`values-zh-rCN/` 资源。系统内置国际化只负责中文和英文，更多语言交给社区扩展。
 
-### 🔍 previewer/ — SMS-Previewer `v0.0.1` ⭐ **工具项目**
+## 组件
 
-优雅的短信备份预览工具，基于Web技术
-- ✅ **文件预览**: 支持SMS Backup & Restore导出的XML文件
-- ✅ **智能分析**: 消息统计和联系人互动分析
-- ✅ **美观界面**: 对话气泡式界面，支持深色模式
-- ✅ **隐私保护**: 完全本地运行，无需上传服务器
+### `android/`
 
-**技术栈**: Vue 3 · Vite · Tailwind CSS
+Commory Android 客户端，负责设备侧数据采集、MsgLayer 导出、本地恢复、运行模式选择和可选服务器同步。
 
-## 🎯 开发进度状态
+- 包名：`com.iskenkenya.commory`
+- app namespace：`com.iskenkenya.commory.mobile`
+- SDK namespace：`com.iskenkenya.commory.sdk.*`
+- 技术栈：Kotlin、Jetpack Compose、Material 3、DataStore、Retrofit、多模块 SDK
 
-### 📊 总体进度
-- **MessageVault-Mobile** (`android/`): 🟢 **高度可用** (核心功能完备，生产环境可用，持续优化中)
-- **SMS-Previewer** (`previewer/`): 🟢 **功能完备** (独立工具，稳定运行)
+### `backend/`
 
-### 🏃‍♂️ 当前重点
-1. **MessageVault-Mobile**: 🚀 持续优化用户体验和功能增强
-2. **SMS-Previewer**: 🔧 功能完善和性能优化
-3. **项目生态**: 📚 文档完善和开发者工具改进
+自托管 Commory Server，负责认证、Refresh Token、MsgLayer 导入、查询、时间线、搜索和移动端 API。
 
-> 💡 **开发理念**: 作为我的第一个全栈式开源项目，MessageVault致力于打造一个完整、可靠的数据备份解决方案，所有组件均在积极开发和不断完善中。
+- 技术栈：Go、标准库 HTTP、SQLite/PostgreSQL provider
+- 契约文档：[docs/mobile-api.md](docs/mobile-api.md)
 
-## 🛠️ 技术栈
+### `web/`
 
-### Mobile (Android)
-- **框架**: Jetpack Compose + Material Design 3
-- **语言**: Kotlin
-- **架构**: MVVM + Repository Pattern
-- **并发**: Kotlin Coroutines + StateFlow
-- **测试**: JUnit + Mockito + Espresso
+服务器端 dashboard，基于 Vue 3、Vite、Element Plus，用于管理与查看 server-backed 数据。
 
-### Previewer (工具)
-- **框架**: Vue 3 + Vite
-- **样式**: Tailwind CSS
-- **特性**: 纯前端，无服务器依赖
+### `msglayer/`
 
-## 🏗️ 系统架构
+Commory 的 canonical interchange format。Android 输出 MsgLayer JSON，backend 验证并导入，未来 CLI/SDK/Agent 能力也围绕 MsgLayer 演进。
 
-```
-┌─────────────────┐
-│  Android App    │
-│ (android/)      │
-│ MessageVault-   │
-│ Mobile          │
-└────────┬────────┘
-         │ JSON Export
-         ▼
-┌─────────────────┐
-│ SMS-Previewer   │
-│ (previewer/)    │
-│  Web Tool       │
-└─────────────────┘
-```
+### `previewer/`
 
-## 🚀 快速开始
+历史 XML SMS viewer 归档。它保留作为项目早期代码存档，不参与当前构建、CI、规范迁移或功能路线。
 
-### 👤 普通用户
-1. **下载MessageVault-Mobile APK**: [Releases页面](https://github.com/MessageVault/MessageVault-Mobile/releases)
-2. **使用SMS-Previewer**: [在线版本](https://messagevault.github.io/SMS-Previewer/) 或本地部署
+## Quick Start
 
-### 👨‍💻 开发者
-```bash
-# 克隆 Monorepo
-git clone git@github.com:IsKenKenYa/MessageVault.git
-cd MessageVault
+### Android
 
-# Android 应用开发
+```bash
 cd android
-./gradlew build
-
-# 预览工具开发
-cd previewer
-pnpm install
-pnpm dev
+./gradlew :app:compileDebugKotlin
+./gradlew :app:testDebugUnitTest
 ```
 
-## 📋 项目规范
-
-开发本项目前，请务必阅读[项目规范文档](NOTICE.md)，其中包含:
-
-- 🏗️ **编码标准**: 命名规范、代码风格、架构原则
-- 💬 **注释要求**: 文档化标准、API注释规范
-- 🔧 **可扩展性**: 模块化设计、接口设计原则
-- 🧪 **测试要求**: 单元测试、集成测试、E2E测试
-- 📝 **变更记录**: CHANGELOG和AI编辑日志规范
-- 📚 **文档要求**: README、API文档、用户手册标准
-
-## 🤝 参与贡献
-
-我们欢迎所有形式的贡献！无论是代码、文档、测试、反馈还是建议。
-
-### 🐛 报告问题
-- [MessageVault-Mobile Issues](https://github.com/MessageVault/MessageVault-Mobile/issues)
-- [SMS-Previewer Issues](https://github.com/MessageVault/SMS-Previewer/issues)
-
-### 💡 功能建议
-- [MessageVault Discussions](https://github.com/MessageVault/MessageVault/discussions)
-
-### 📝 贡献代码
-1. Fork 相应的仓库
-2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
-3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
-4. 推送到分支 (`git push origin feature/AmazingFeature`)
-5. 开启 Pull Request
-
-### 📋 开发规范
-- 遵循项目编码标准
-- 编写单元测试
-- 更新相关文档
-- 遵循Git提交规范
-
-## 🏆 致谢
-
-### 🙏 特别感谢
-- **[SMS Backup & Restore](https://play.google.com/store/apps/details?id=com.riteshsahu.SMSBackupRestore)**: 启发了SMS-Previewer项目的创建
-- **Android开源社区**: 提供了优秀的Jetpack Compose和Material Design 3组件
-- **Vue.js社区**: 提供了现代化的前端开发框架
-- **开源精神**: 无数开源项目和开发者的贡献，让我学会了如何构建和维护一个全栈项目
-
-### 💻 核心技术支持
-- [Jetpack Compose](https://developer.android.com/jetpack/compose) - 现代化Android UI框架
-- [Material Design 3](https://m3.material.io/) - Google设计系统
-- [Vue.js](https://vuejs.org/) - 渐进式JavaScript框架
-- [Tailwind CSS](https://tailwindcss.com/) - 实用优先的CSS框架
+### Backend
 
-## 📊 项目统计
-
-<div align="center">
-
-![Project Status](https://img.shields.io/badge/Project%20Status-Active%20Development-brightgreen)
-![Mobile App](https://img.shields.io/badge/Mobile%20App-v0.1.4%20Highly%20Usable-success)
-![SMS Previewer](https://img.shields.io/badge/SMS%20Previewer-v0.0.1%20Stable-success)
-![License](https://img.shields.io/badge/License-GPL%20v3-blue)
-
-**主要语言**: Kotlin, Vue.js, JavaScript | **首个全栈开源项目** 🎯
-
-</div>
-
----
-
-<div align="center">
-
-### 📱 开始您的数据备份之旅
-
-**[下载Android应用](https://github.com/MessageVault/MessageVault-Mobile/releases)**
-•
-**[在线预览工具](https://messagevault.github.io/SMS-Previewer/)**
-
----
-
-*MessageVault - 您的数据，您的控制权* 🔒
-
-</div>
+```bash
+cd backend
+go test ./...
+go run ./cmd/commory
+```
 
-## 📄 许可证
+### Web
 
-本项目采用 [GNU General Public License v3.0](LICENSE) - 查看许可证文件了解详情。
+```bash
+cd web
+pnpm install
+pnpm dev
+```
 
-### 🛡️ GPL 3.0 核心原则
-- ✅ **自由使用**: 可以自由运行程序
-- ✅ **自由研究**: 可以研究程序工作原理并修改
-- ✅ **自由分发**: 可以重新分发原始版本
-- ✅ **自由改进**: 可以分发修改后的版本
-- 🔒 **Copyleft保护**: 衍生作品必须以相同许可证分发
-- 📝 **源码开放**: 分发二进制文件时必须提供源代码
+## Governance
 
-## 🛡️ 项目独立性声明
+- Agent 入口：[AGENTS.md](AGENTS.md)
+- 工程标准：[docs/engineering-standards.md](docs/engineering-standards.md)
+- 项目治理：[NOTICE.md](NOTICE.md)
+- 当前移动端契约：[docs/mobile-api.md](docs/mobile-api.md)
+- ADR：
+  - [参考资料治理](docs/adr/0001-参考资料治理.md)
+  - [数据库 sqlc 迁移](docs/adr/0002-数据库-sqlc-迁移.md)
+  - [Agent 运行时边界](docs/adr/0003-agent-运行时边界.md)
 
-### 📜 核心承诺
-面对当前开源生态中部分项目被商业收购的现状，我们郑重声明：
+`.agents/skills` 是项目 Skills 的唯一手工维护来源，`.claude/skills` 是 Claude Code 兼容镜像。更新 Skills 后运行：
 
-- 🔒 **数据自主权**: 本项目的所有子项目、功能**绝对不会**与任何第三方共享用户数据
-- 🏠 **本地优先**: 坚持数据本地可控的设计理念，用户完全掌控自己的数据
-- 👤 **用户选择权**: 保留用户高度自定义权利，由用户自行选择是否接入第三方服务
-- 🔧 **可选集成**: 支持用户自主选择第三方API（云盘备份、AI分析等）服务提供商
+```bash
+bash scripts/sync-agent-skills.sh
+```
 
-### 🛡️ 独立性保障
-- 📅 **长期维护**: 即使项目不盈利，也会持续投入时间进行维护和更新
-- 🚫 **抗收购承诺**: 如遇不可抗力强制收购，将**立即封存归档**整个组织账户
-- 🌱 **社区传承**: 确保开源社区能够Fork项目并继续发扬光大
-- 💎 **价值坚持**: 即使存在众多替代品，仍坚持数据自主的核心价值观
+## Roadmap
 
-> 🔥 **我们的信念**: 用户数据属于用户本人，任何人和组织都无权在未经明确授权的情况下访问、使用或共享用户数据。
+- 阶段 1：安全与健壮性补全，包括 Android logout 调服务端、401 自动刷新、去除阻塞快照、CI Java 25、治理规范收束。
+- 阶段 2：移动端体验完善，包括网络错误分类、token 过期判断、模式切换确认、服务器地址默认策略、Retrofit 缓存。
+- 阶段 3：契约测试补全，包括 refresh 轮换、logout 吊销、setup 初始化防重、web lint/build CI。
+- 阶段 4：功能扩展，包括远程恢复、搜索与时间线、推送通知、MsgLayer v0.2、端到端加密、多设备同步。
 
-### 💼 项目可持续发展计划
-MessageVault采用**开源优先**的发展模式：
-- 🆓 **当前阶段**: 所有功能完全开源免费
-- 🚀 **未来Pro版本**: 当项目高度成熟后，将推出Pro版本用于体验最新功能
-- 📦 **版本策略**: Pro版本领先开源版本两个版本，旧Pro版本将自动开源发布
-- 🤝 **收益分配**: Pro版本收入将与贡献者按贡献量公平分配
-- 🎯 **核心承诺**: 基础功能永远保持开源，确保用户数据自主权
+## License
 
-> 💡 **重要说明**: 目前专注于开源版本的完善，Pro版本计划仅在整个项目生态高度可用后才会考虑推出。
+本仓库根目录代码采用 [GNU General Public License v3.0](LICENSE)。`references/` 下外部参考代码保持其上游许可证。
diff --git a/android/.gitignore b/android/.gitignore
index efa8ee0..4bcb829 100644
--- a/android/.gitignore
+++ b/android/.gitignore
@@ -53,6 +53,8 @@ Thumbs.db
 *.tar.gz
 *.rar
 
+.jdks/
+
 # Java heap dump files
 *.hprof
 java_pid*.hprof
diff --git a/android/AI_EDIT_LOG.md b/android/AI_EDIT_LOG.md
deleted file mode 100644
index a4c66f7..0000000
--- a/android/AI_EDIT_LOG.md
+++ /dev/null
@@ -1,268 +0,0 @@
-# AI 辅助编辑日志
-
-本文件记录MessageVault-Mobile组件中所有AI辅助的编辑和生成内容。
-
-## 2025-05-13: 修复Android 16上默认短信角色请求对话框问题（Claude 3.7 Sonnet）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 修复了在Android 16 (API 36)上默认短信应用角色请求对话框不显示的问题
-- 移除了基于READ_SMS/SEND_SMS权限检查的错误检测逻辑
-- 移除了对模拟器环境的特殊处理逻辑
-- 使用ActivityResultLauncher替代过时的startActivityForResult
-- 改进了RoleManager.isRoleHeld的使用
-
-**AI贡献**:
-- 更新了MainActivity、RestoreManager和PermissionUtils中的isDefaultSmsApp方法：
-  - 移除了基于READ_SMS和SEND_SMS权限检查的逻辑
-  - 只使用RoleManager.isRoleHeld和Telephony.Sms.getDefaultSmsPackage方法
-  - 删除了针对模拟器环境的特殊处理代码
-- 更新了RestoreManager的requestDefaultSmsApp方法：
-  - 使用ActivityResultLauncher替代startActivityForResult
-  - 优化RoleManager检查和调用逻辑
-  - 从Android R (30)降低至Android Q (29)以增强兼容性
-- 增强了调试日志，更详细地记录SMS角色相关操作
-- 更新了相关文档，记录修复内容
-
-**人工审核与调整**:
-- 验证修复在Android 16 (API 36)设备上的有效性
-- 确认RoleManager.isRoleHeld正确检测角色状态
-- 检查ActivityResultLauncher正确处理请求结果
-- 测试整个SMS恢复流程
-
-2025-05-13T21:16:00+08:00 [Mobile] INFO [UI] Fixed SMS role request dialog and role check for Android 16
-
-## 2025-04-20: 修复高版本Android上默认短信应用检测问题（Claude 3.7 Sonnet）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 修复了高版本Android上默认短信应用检测不一致的问题
-- 实现了组件间状态同步机制
-- 增强了日志记录，便于问题诊断
-- 更新了相关文档，记录问题解决方案
-
-**AI贡献**:
-- 修改了MainActivity.kt的isDefaultSmsApp()方法
-  - 添加RoleManager检查作为主要检测方法(Android 10+)
-  - 使用SharedPreferences记录默认短信应用状态
-  - 添加详细日志，跟踪检测流程和结果
-- 更新了onActivityResult方法
-  - 添加状态保存到SharedPreferences
-  - 通知RestoreViewModel状态变更
-  - 改进错误处理和用户提示
-- 更新文档记录变更
-  - 修改CHANGELOG.md，记录修复内容
-  - 更新AI_EDIT_LOG.md，详细说明解决方案
-  - 更新README.md和features.md，更新项目状态
-
-**人工审核与调整**:
-- 验证修复在多个Android版本上的有效性
-- 确认状态同步机制正常工作
-- 检查日志输出是否提供足够调试信息
-- 测试完整的备份和恢复流程
-
-## 2025-04-19: 修复权限和JDK兼容性问题（Claude 3.7 Sonnet）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 修复了恢复功能相关的权限问题
-- 解决了JDK兼容性问题
-- 更新了项目文档，添加了当前开发状态和测试注意事项
-
-**AI贡献**:
-- 将AndroidManifest.xml中的WRITE_SMS权限改为SEND_SMS
-- 添加了WRITE_CALL_LOG和WRITE_CONTACTS权限
-- 更新了MainActivity.kt中的权限检查逻辑
-- 修复了gradle.properties中的JDK路径设置，使用标准OpenJDK 17
-- 更新了features.md，添加了当前开发状态和测试注意事项
-- 更新了CHANGELOG.md，记录了权限和JDK兼容性修复
-- 更新了README.md，添加了恢复功能限制说明
-
-**人工审核与调整**:
-- 确认修复后的代码能够正确编译
-- 验证备份功能正常工作
-- 确认恢复功能目前仅支持通话记录恢复
-- 检查文档更新是否准确反映了当前项目状态
-
-## 2025-04-19: 修复数据模型类型不匹配问题（Claude 3.7 Sonnet）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 修复了BackupManager和RestoreManager中的数据模型类型不匹配问题
-- 修改了ContactsEntity、Message和MessageData、CallLog和CallLogData之间的转换
-- 修复了BackupFile构造函数参数缺失问题
-- 解决了重复的方法定义
-
-**AI贡献**:
-- 重构BackupManager.kt中的createLocalBackup和readMessages/readCallLogs方法
-- 修改RestoreManager.kt中的getAvailableBackups和parseBackupFile方法
-- 修复Contact.toContactsEntity方法
-- 修改MessageData和CallLogData模型类
-- 移除重复的restoreContacts方法
-- 增强了错误处理和日志记录
-- 更新CHANGELOG.md和AI_EDIT_LOG.md记录修复内容
-
-**人工审核与调整**:
-- 确认修复后的代码能够正确编译
-- 验证备份和恢复功能正常工作
-- 检查各数据类型之间的转换逻辑是否正确
-
-## 2025-04-18: 强化Material Design 3 (Material You)实现（Claude 3.7 Sonnet）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 优化和强化Material Design 3 (Material You)的实现
-- 确保主题系统使用最新的Material 3设计语言
-- 修复颜色系统和组件之间的一致性问题
-
-**AI贡献**:
-- 更新XML主题文件，确保使用正确的Material 3属性
-- 完善Theme.kt中的颜色系统实现，添加所有标准Material 3颜色属性
-- 更新app/build.gradle，添加Material 3 window-size-class支持
-- 升级Material库到最新版本(1.10.0)
-- 更新README.md，添加Material You设计相关说明
-- 更新CHANGELOG.md，记录Material 3相关变更
-- 优化夜间和日间主题颜色方案
-
-**人工审核与调整**:
-- 确认保留Material 3设计规范
-- 验证动态颜色系统正常工作
-- 检查深色/浅色主题切换效果
-
-## 2025-04-17: 配置Gradle 8.2和JDK 17（Cursor AI）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 配置项目使用Gradle 8.2和JDK 17
-- 创建features.md功能需求清单
-- 更新构建系统配置
-- 添加Gradle Wrapper脚本
-
-**AI贡献**:
-- 创建gradle/wrapper/gradle-wrapper.properties配置Gradle 8.2
-- 创建项目级build.gradle文件，配置AGP 8.1.0和Kotlin 1.8.10
-- 更新app/build.gradle，使用项目级变量和添加namespace
-- 创建gradlew和gradlew.bat脚本
-- 创建features.md功能清单，包含详细规格
-- 更新README.md，添加开发环境设置说明
-- 更新CHANGELOG.md，记录Gradle配置变更
-
-**人工审核与调整**:
-- 确认Gradle配置正确
-- 验证项目能够正常构建
-- 检查JDK版本设置是否正确
-
-## 2025-04-17: 添加测试功能（Cursor AI）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 为SMS和通话记录功能添加单元测试和设备测试
-- 测试涵盖数据读取和本地备份功能
-- 实现测试日志系统，遵循NOTICE.md规范
-
-**AI贡献**:
-- 创建BackupManagerTest.kt单元测试，使用Mockito模拟ContentProvider
-- 创建BackupManagerInstrumentedTest.kt设备测试
-- 更新build.gradle添加测试依赖
-- 配置测试目录结构
-- 更新CHANGELOG.md记录测试功能的添加
-- 更新AI_EDIT_LOG.md记录此次编辑
-
-**人工审核与调整**:
-- 确认测试用例覆盖关键功能
-- 验证测试能够正常运行
-- 检查测试日志格式是否符合规范
-
-## 2025-04-17: 添加多语言支持（Cursor AI）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 为MessageVault-Mobile添加多语言支持
-- 实现中文（默认和zh-rCN）和英文（en）语言资源
-- 创建可扩展的语言切换接口
-
-**AI贡献**:
-- 创建和更新字符串资源文件（values/strings.xml, values-zh-rCN/strings.xml, values-en/strings.xml）
-- 创建imken.messagevault.mobile.config.Config类，添加语言管理功能
-- 更新MainActivity.kt和MessageVaultApp.kt，实现语言切换和初始化
-- 更新NOTICE.md，添加多语言支持的实现指南
-- 更新CHANGELOG.md，记录多语言支持的添加
-
-**人工审核与调整**:
-- 确认语言资源文件内容正确
-- 验证语言切换功能正常工作
-- 检查默认语言设置是否符合预期
-
-## 2025-04-17: 配置Android项目（Cursor AI）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 配置Android项目使用Jetpack Compose和Material Design 3
-- 修改包名为imken.messagevault.mobile
-- 设置API级别（minSdkVersion 24, targetSdkVersion 34, compileSdkVersion 34）
-- 迁移Java代码到Kotlin
-
-**AI贡献**:
-- 将build.gradle更新为支持Compose和适当的API级别
-- 创建settings.gradle文件配置项目
-- 更新AndroidManifest.xml文件，修改包名和权限
-- 创建MessageVaultApp.kt进行日志初始化
-- 将MainActivity.java迁移到Kotlin并重构为使用Compose
-- 创建Material Design 3主题文件，支持动态颜色
-- 更新CHANGELOG.md和.gitignore文件
-
-**人工审核与调整**:
-- 确认项目配置正确
-- 验证Compose UI正常工作
-- 检查API级别设置是否合适
-
-## 2025-04-16: 增强项目结构（Claude 3.7 Sonnet）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**: 
-- 为项目添加CHANGELOG.md、AI_EDIT_LOG.md文件
-- 创建tests目录和测试文件占位符
-- 添加详细注释到现有代码文件
-- 创建配置类以支持可扩展性
-
-**AI贡献**:
-- 生成CHANGELOG.md和AI_EDIT_LOG.md模板
-- 创建Config.java配置类
-- 为测试目录创建基本结构
-- 为现有代码添加详细注释
-
-**人工审核与调整**:
-- 确认文档结构合理
-- 验证配置类功能正常
-- 检查注释是否清晰明了
-
-## 2025-04-16: 初始项目结构创建（Claude 3.7 Sonnet）
-
-**使用的AI工具**: Claude 3.7 Sonnet (Cursor AI)
-
-**变更描述**:
-- 创建基本的Android项目结构
-- 创建MainActivity.java文件
-- 设置基本UI布局
-- 配置构建文件和权限
-
-**AI贡献**:
-- 生成MainActivity.java基础代码，包含权限管理
-- 创建基本布局文件activity_main.xml
-- 配置AndroidManifest.xml，设置必要权限
-- 创建app/build.gradle文件，配置依赖项
-
-**人工审核与调整**:
-- 确认项目结构符合Android标准
-- 验证基本功能正常工作
-- 检查权限设置是否合理 
\ No newline at end of file
diff --git a/android/CHANGELOG.md b/android/CHANGELOG.md
index 8b2a70f..cf8152b 100644
--- a/android/CHANGELOG.md
+++ b/android/CHANGELOG.md
@@ -1,6 +1,19 @@
 # 变更日志
 
-本文件记录MessageVault-Mobile组件的所有重要变更。
+本文件记录 Commory Android 组件的重要变更。历史条目可能保留旧项目名，用于说明迁移来源。
+
+## [未发布]
+
+### 新增
+- 建立 Commory Android 命名规范：应用 ID 为 `com.iskenkenya.commory`，客户端 namespace 为 `com.iskenkenya.commory.mobile`，SDK namespace 为 `com.iskenkenya.commory.sdk.*`。
+- 将 AI 辅助编辑历史从独立 `AI_EDIT_LOG.md` 流程迁移到标准 changelog / PR / commit 描述流程。
+
+### 修改
+- 将 Android 项目名称、用户可见品牌、日志 tag、主题名和当前文档统一为 Commory。
+- 将旧包名 `imken.messagevault.*` 迁移到 `com.iskenkenya.commory.*`。
+
+### 移除
+- 移除 `AI_EDIT_LOG.md` 和旧调试修复报告，后续不再维护非标准旁路记录。
 
 ## [未发布] - 2025-05-13
 
@@ -133,4 +146,4 @@
 - MainActivity基本实现，支持权限请求和基本界面
 - 基本布局文件（activity_main.xml）
 - 字符串资源文件（strings.xml）
-- Gradle构建配置 
\ No newline at end of file
+- Gradle构建配置
diff --git a/android/ISSUE_FIXED.md b/android/ISSUE_FIXED.md
deleted file mode 100644
index ebe1745..0000000
--- a/android/ISSUE_FIXED.md
+++ /dev/null
@@ -1,103 +0,0 @@
-# MessageVault-Mobile 项目分析及修复报告
-
-## 项目概览
-
-MessageVault-Mobile是一款用于备份和恢复短信与通话记录的Android应用，采用现代化的Jetpack Compose + Material Design 3 (Material You)技术栈开发。主要功能包括数据读取、本地/远程备份、数据恢复、多语言支持等。
-
-## 发现的问题
-
-主要问题是项目中Material Design 3 (Material You)的实现不完整，存在一些不一致之处：
-
-1. **主题定义不完整**：
-   - XML主题文件中使用了Material 3属性，但部分颜色属性缺失
-   - Compose中的colorScheme没有完整实现Material 3的颜色系统
-
-2. **构建配置问题**：
-   - 缺少对Material 3窗口大小类的支持
-   - Material库版本不是最新的
-   - 部分Compose相关依赖没有明确声明
-
-3. **颜色系统不一致**：
-   - 日间和夜间主题之间的颜色定义不统一
-   - 缺少某些重要的Material 3颜色属性，如tertiaryContainer、surfaceVariant等
-
-## 修复措施
-
-1. **强化Material 3主题系统**：
-   - 保留并增强XML主题文件中的Material 3属性
-   - 在Theme.kt中实现完整的Material 3颜色方案
-   - 确保所有必要的颜色属性都已定义，包括各种容器颜色和变体
-
-2. **更新构建配置**：
-   - 添加Material 3 window-size-class支持
-   - 升级Material库到最新版本(1.10.0)
-   - 配置完整的Compose和Material 3依赖
-
-3. **统一颜色系统**：
-   - 完善日间和夜间主题的颜色定义
-   - 添加所有标准Material 3颜色属性
-   - 优化UI组件使用Material 3颜色的方式
-
-## 项目架构分析
-
-MessageVault采用MVVM架构模式，结合Material Design 3的设计理念：
-
-1. **UI层**：
-   - 使用Jetpack Compose构建现代化UI
-   - 全面实现Material Design 3设计规范
-   - 支持Android 12+的Material You动态颜色系统
-   - 多屏幕自适应布局
-   - 基于Compose Navigation的导航系统
-
-2. **业务逻辑**：
-   - ViewModel处理各屏幕的业务逻辑
-   - BackupManager负责备份逻辑
-   - 数据转换和处理逻辑
-
-3. **数据层**：
-   - Room数据库存储本地备份记录
-   - ContentProvider访问系统短信和通话记录
-   - Retrofit处理网络API交互
-
-4. **工具类**：
-   - 基于Timber的日志系统
-   - 权限管理工具
-   - 配置管理
-
-## Material Design 3实现细节
-
-1. **动态颜色系统**：
-   - 在Android 12+设备上支持Material You动态颜色
-   - 为较低版本Android提供精心设计的静态颜色方案
-   - 完整实现Material 3的色彩系统（primary、secondary、tertiary色系及其变体）
-
-2. **深色模式支持**：
-   - 针对深色模式优化的颜色方案
-   - 自动跟随系统深色模式设置
-   - 确保所有UI元素在深色模式下可读性良好
-
-3. **主题一致性**：
-   - 确保XML主题和Compose主题之间的一致性
-   - 统一的颜色命名和使用方式
-   - 跨组件的视觉风格统一
-
-## 下一步建议
-
-1. **UI组件优化**：
-   - 使用更多Material 3特有组件，如AdaptiveNavigationSuite
-   - 实现Material 3动效系统
-   - 添加Material 3风格的自定义组件
-
-2. **性能优化**：
-   - 优化Compose组件性能
-   - 大量数据处理时的内存优化
-   - 改进UI渲染效率
-
-3. **功能增强**：
-   - 按照features.md文档中的阶段2功能进行开发
-   - 增加远程备份能力
-   - 添加高级数据分析功能
-
-4. **安全性加强**：
-   - 实现备份文件加密
-   - 网络传输安全增强 
\ No newline at end of file
diff --git a/android/README.md b/android/README.md
index c795c72..767db63 100644
--- a/android/README.md
+++ b/android/README.md
@@ -1,123 +1,59 @@
-# MessageVault Mobile
+# Commory Android
 
-<div align="center">
-  <img src="app/src/main/res/drawable/ic_launcher_foreground.xml" width="100" height="100" alt="MessageVault Logo">
-</div>
+Commory Android 是本地优先的客户端，负责采集、导出、恢复通信数据，并在用户选择时同步到 Commory Server。
 
-<div align="center">
-  <h2>安全备份和恢复Android短信和通话记录</h2>
-</div>
+## 身份与命名
 
-<div align="center">
-  <p>使用Material You设计的现代化备份解决方案</p>
-</div>
+- Application id：`com.iskenkenya.commory`
+- App namespace：`com.iskenkenya.commory.mobile`
+- SDK namespaces：`com.iskenkenya.commory.sdk.backup`、`com.iskenkenya.commory.sdk.auth`、`com.iskenkenya.commory.sdk.storage`
+- 产品名：`Commory`
 
-<div align="center">
+Go backend module name 与 Android package naming 相互独立，不与客户端 id 冲突。
 
-[![构建状态](https://img.shields.io/github/actions/workflow/status/MessageVault/MessageVault-Mobile/android.yml?branch=main)](https://github.com/MessageVault/MessageVault-Mobile/actions)
-[![版本](https://img.shields.io/github/v/release/MessageVault/MessageVault-Mobile?include_prereleases)](https://github.com/MessageVault/MessageVault-Mobile/releases)
-[![API](https://img.shields.io/badge/API-24%2B-brightgreen.svg)](https://android-arsenal.com/api?level=24)
-[![许可证](https://img.shields.io/github/license/MessageVault/MessageVault-Mobile)](https://github.com/MessageVault/MessageVault-Mobile/blob/main/LICENSE)
-[![Stars](https://img.shields.io/github/stars/MessageVault/MessageVault-Mobile)](https://github.com/MessageVault/MessageVault-Mobile/stargazers)
-[![Issues](https://img.shields.io/github/issues/MessageVault/MessageVault-Mobile)](https://github.com/MessageVault/MessageVault-Mobile/issues)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/MessageVault/MessageVault-Mobile/pulls)
+## 运行模式
 
-</div>
+- `LOCAL_ONLY`：备份和恢复在设备本地运行，不需要 auth 或网络。
+- `COMMORY_SERVER`：仍然先完成本地备份，然后在启用时执行已认证的服务器上传。
 
-## ✨ 特性
+模式行为记录在 [../docs/android-runtime-modes.md](../docs/android-runtime-modes.md)。
 
-- 📱 **现代化界面**: 采用Material You设计语言，支持动态取色
-- 🔒 **安全可靠**: 本地优先，无需云存储，保护隐私
-- 📤 **全面备份**: 支持短信、通话记录和联系人的备份
-- 📥 **智能恢复**: 支持选择性恢复，带进度显示
-- 🌍 **多语言**: 支持中文和英文界面
-- 🔄 **状态同步**: 组件间状态实时同步，确保操作流畅
+## 模块
 
-## 📱 功能概览
-
-MessageVault Mobile是一个专注于Android数据备份与恢复的开源应用。它提供了一个现代化的解决方案，帮助用户安全地管理他们的短信、通话记录和联系人数据。
-
-### 当前功能状态
-
-| 功能 | 状态 | 描述 |
-|------|------|------|
-| 短信备份 | ✅ | 完全支持，包含完整元数据 |
-| 通话记录备份 | ✅ | 完全支持，包含详细通话信息 |
-| 联系人备份 | ✅ | 完全支持，包含所有联系人字段 |
-| 短信恢复 | ✅ | 完全支持，带进度显示 |
-| 通话记录恢复 | ✅ | 完全支持，带状态反馈 |
-| 联系人恢复 | ⏳ | 开发中，基础框架已完成 |
-| 权限管理 | ✅ | 完全支持，包含运行时权限处理 |
-
-## 🛠️ 技术栈
-
-- **UI框架**: Jetpack Compose
-- **架构模式**: MVVM
-- **状态管理**: ViewModel + StateFlow
-- **依赖注入**: Hilt (计划中)
-- **数据持久化**: Room + DataStore
-- **并发处理**: Kotlin Coroutines
-- **单元测试**: JUnit + Mockito
+```text
+android/
+├── app/          # Compose UI、navigation、permissions、runtime mode、Android platform adapters
+└── sdk/
+    ├── backup/  # 纯 Kotlin 备份/恢复编排和 MsgLayer 映射
+    ├── auth/    # 纯 Kotlin auth contracts
+    └── storage/ # Android storage implementation 和 storage contracts
+```
 
-## 📦 安装要求
+`app` 可以依赖 SDK 模块。SDK 模块不得依赖 `app`；纯 Kotlin SDK 模块不得 import Android framework APIs。
 
-- Android 7.0 (API 24) 或更高版本
-- 约20MB存储空间
-- 必要权限：
-  - 读取/写入短信
-  - 读取/写入通话记录
-  - 读取/写入联系人
-  - 存储访问（用于备份文件）
+## 国际化
 
-## 🚀 开始使用
+- 用户可见字符串必须放在 Android resource 中，不要在 Kotlin/Compose 代码里硬编码中文或英文。
+- 内置语言只维护中文和英文：`values/strings.xml`、`values-en/strings.xml`、`values-zh-rCN/strings.xml`。
+- Compose UI 使用 `stringResource`。
+- 动态错误在 UI 边界前类型化，再用占位符本地化。
 
-### 开发环境配置
+## 命令
 
 ```bash
-# 克隆仓库
-git clone https://github.com/MessageVault/MessageVault-Mobile.git
-
-# 进入项目目录
-cd MessageVault-Mobile
-
-# 构建项目
-./gradlew build
+./gradlew :app:compileDebugKotlin
+./gradlew :app:testDebugUnitTest
+./gradlew :sdk:backup:test
+./gradlew :sdk:auth:test
 ```
 
-### 系统要求
-
-- JDK 17 (推荐使用OpenJDK 17.0.14)
-- Android Studio Iguana或更高版本
-- Android SDK (API 24-34)
-- Gradle 8.2+
-
-## 🤝 贡献指南
-
-我们欢迎各种形式的贡献！以下是一些参与项目的方式：
-
-- 🐛 提交bug报告
-- 💡 提出新功能建议
-- 📝 改进文档
-- 🔍 审查代码
-
-在提交Pull Request之前，请确保：
-
-1. 遵循项目的代码风格
-2. 添加必要的测试
-3. 更新相关文档
-4. 描述清楚改动的目的和影响
-
-## 📄 开源协议
-
-本项目采用[GNU General Public License v3.0](LICENSE)开源协议。
-
-## 🙏 鸣谢
+从 `android/` 目录运行 Android checks。只有需要设备或 emulator 时才使用 instrumented tests。
 
-- [Jetpack Compose](https://developer.android.com/jetpack/compose)
-- [Material Design 3](https://m3.material.io/)
-- [Android Jetpack](https://developer.android.com/jetpack)
+## 文档
 
-## 📬 联系我们
+- 工程标准：[../docs/engineering-standards.md](../docs/engineering-standards.md)
+- 移动端 API 契约：[../docs/mobile-api.md](../docs/mobile-api.md)
+- 运行模式：[../docs/android-runtime-modes.md](../docs/android-runtime-modes.md)
+- Changelog：[CHANGELOG.md](CHANGELOG.md)
 
-- 提交Issue: [GitHub Issues](https://github.com/MessageVault/MessageVault-Mobile/issues)
-- 项目讨论: [GitHub Discussions](https://github.com/MessageVault/MessageVault-Mobile/discussions)
\ No newline at end of file
+项目不使用 `AI_EDIT_LOG.md` 这类历史报告。持久变更写入 `CHANGELOG.md`、PR 描述和 commits。
diff --git a/android/app/build.gradle b/android/app/build.gradle
index fac4c4e..6c79e83 100644
--- a/android/app/build.gradle
+++ b/android/app/build.gradle
@@ -1,147 +1,112 @@
-// 应用必要的插件
 plugins {
     id 'com.android.application'
-    id 'org.jetbrains.kotlin.android'
+    id 'org.jetbrains.kotlin.plugin.compose'
 }
 
 android {
-    namespace 'imken.messagevault.mobile'
-    
-    compileSdkVersion 34
-    
-    // 添加SDK工具选项，兼容版本差异
-    ndkVersion "21.4.7075529"
-    buildToolsVersion "33.0.2"
-    
+    namespace 'com.iskenkenya.commory.mobile'
+
+    compileSdk 35
+
+    ndkVersion "28.2.13676358"
+    buildToolsVersion "36.1.0"
+
     defaultConfig {
-        applicationId "imken.messagevault.mobile"
-        minSdkVersion 24
-        targetSdkVersion 34
+        applicationId "com.iskenkenya.commory"
+        minSdk 24
+        targetSdk 35
         versionCode 1
         versionName '0.0.2_alpha'
-        
+
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         vectorDrawables {
             useSupportLibrary true
         }
-        
-        // 配置Room架构
-        javaCompileOptions {
-            annotationProcessorOptions {
-                arguments += [
-                    "room.schemaLocation": "$projectDir/schemas",
-                    "room.incremental": "true",
-                    "room.expandProjection": "true"
-                ]
-            }
-        }
     }
-    
+
     buildFeatures {
         compose true
-        // 启用 BuildConfig 生成
         buildConfig true
     }
-    
-    composeOptions {
-        kotlinCompilerExtensionVersion rootProject.ext.compose_compiler_version
-    }
-    
-    // 可以选择在ComposeOptions下添加这个选项来抑制版本检查（但不推荐）
-    // freeCompilerArgs += ["-P", "plugin:androidx.compose.compiler.plugins.kotlin:suppressKotlinVersionCompatibilityCheck=true"]
 
     buildTypes {
         release {
             minifyEnabled false
             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
         }
-        debug {
-            // 添加调试配置以在构建时输出更多信息
-            testCoverageEnabled false
-        }
     }
-    
+
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_17 // 更新为JDK 17
-        targetCompatibility JavaVersion.VERSION_17 // 更新为JDK 17
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
     }
-    
-    kotlinOptions {
-        jvmTarget = '17' // 从1.8更新为17，与Java版本保持一致
-        freeCompilerArgs += [
-            "-opt-in=kotlin.RequiresOptIn",
-            "-opt-in=kotlinx.coroutines.ExperimentalCoroutinesApi"
-        ]
-    }
-    
-    packagingOptions {
+
+    packaging {
         resources {
             excludes += '/META-INF/{AL2.0,LGPL2.1}'
         }
     }
-    
-    // 移除错误的androidResources块，使用替代配置
-    // 解决清单文件包名警告的替代方法
+
     lint {
-        // 如果需要忽略清单文件中package属性警告，可以添加以下配置
         disable 'ManifestPackageNameNeeded'
     }
 }
 
+tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
+    kotlinOptions {
+        jvmTarget = '17'
+        freeCompilerArgs += [
+            "-opt-in=kotlin.RequiresOptIn",
+            "-opt-in=kotlinx.coroutines.ExperimentalCoroutinesApi"
+        ]
+    }
+}
+
 dependencies {
-    // AndroidX 核心库
-    implementation 'androidx.core:core-ktx:1.12.0'
-    implementation 'androidx.appcompat:appcompat:1.6.1'
-    implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.6.2'
-    
-    // Compose相关库
-    implementation platform('androidx.compose:compose-bom:2023.10.01')
+    implementation 'androidx.core:core-ktx:1.16.0'
+    implementation 'androidx.appcompat:appcompat:1.7.0'
+    implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.9.0'
+
+    implementation platform('androidx.compose:compose-bom:2025.05.01')
     implementation 'androidx.compose.ui:ui'
     implementation 'androidx.compose.ui:ui-graphics'
     implementation 'androidx.compose.ui:ui-tooling-preview'
     implementation 'androidx.compose.material3:material3'
-    implementation 'com.google.android.material:material:1.11.0'  // 添加Material库以支持Material3主题
-    implementation 'androidx.activity:activity-compose:1.8.2'
-    
-    // 导航组件
-    implementation 'androidx.navigation:navigation-compose:2.7.7'
-    
-    // 图标库
-    implementation 'androidx.compose.material:material-icons-extended:1.6.4'
-    
-    // ViewModel 支持
-    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.7.0'
-    
-    // 数据存储
-    implementation 'androidx.datastore:datastore-preferences:1.0.0'
-    
-    // Retrofit网络库
-    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
-    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
-    
-    // Gson
-    implementation 'com.google.code.gson:gson:2.10.1'
-    
-    // Room数据库
-    implementation 'androidx.room:room-runtime:2.6.1'
-    implementation 'androidx.room:room-ktx:2.6.1'
-    annotationProcessor 'androidx.room:room-compiler:2.6.1'
-    
-    // WorkManager - 用于多线程后台任务
-    implementation 'androidx.work:work-runtime-ktx:2.9.0'
-    
-    // 日志库
+    implementation 'com.google.android.material:material:1.12.0'
+    implementation 'androidx.activity:activity-compose:1.10.1'
+
+    implementation 'androidx.navigation:navigation-compose:2.9.0'
+
+    implementation 'androidx.compose.material:material-icons-extended'
+
+    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.9.0'
+
+    implementation 'androidx.datastore:datastore-preferences:1.1.4'
+
+    implementation "com.squareup.retrofit2:retrofit:$retrofit_version"
+    implementation "com.squareup.retrofit2:converter-gson:$retrofit_version"
+
+    implementation "com.google.code.gson:gson:$gson_version"
+
+    implementation project(':sdk:backup')
+    implementation project(':sdk:auth')
+    implementation project(':sdk:storage')
+
+    implementation 'androidx.work:work-runtime-ktx:2.10.1'
+
     implementation 'com.jakewharton.timber:timber:5.0.1'
-    
-    // 测试库
+
     testImplementation 'junit:junit:4.13.2'
-    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
-    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
-    androidTestImplementation platform('androidx.compose:compose-bom:2023.10.01')
+    testImplementation 'org.jetbrains.kotlin:kotlin-test-junit:2.2.0'
+    testImplementation 'org.mockito:mockito-core:5.12.0'
+    testImplementation 'org.robolectric:robolectric:4.14.1'
+    testImplementation 'androidx.test:core:1.6.1'
+    testImplementation 'com.squareup.okhttp3:mockwebserver:4.12.0'
+    androidTestImplementation 'androidx.test.ext:junit:1.2.1'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.6.1'
+    androidTestImplementation platform('androidx.compose:compose-bom:2025.05.01')
     androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
-    
-    // 调试工具
+
     debugImplementation 'androidx.compose.ui:ui-tooling'
     debugImplementation 'androidx.compose.ui:ui-test-manifest'
 }
-
diff --git a/android/app/debug/output-metadata.json b/android/app/debug/output-metadata.json
deleted file mode 100644
index 359236e..0000000
--- a/android/app/debug/output-metadata.json
+++ /dev/null
@@ -1,20 +0,0 @@
-{
-  "version": 3,
-  "artifactType": {
-    "type": "APK",
-    "kind": "Directory"
-  },
-  "applicationId": "imken.messagevault.mobile",
-  "variantName": "debug",
-  "elements": [
-    {
-      "type": "SINGLE",
-      "filters": [],
-      "attributes": [],
-      "versionCode": 1,
-      "versionName": "0.0.2_alpha",
-      "outputFile": "app-debug.apk"
-    }
-  ],
-  "elementType": "File"
-}
\ No newline at end of file
diff --git a/android/app/src/androidTest/java/com/iskenkenya/commory/mobile/BackupManagerInstrumentedTest.kt b/android/app/src/androidTest/java/com/iskenkenya/commory/mobile/BackupManagerInstrumentedTest.kt
new file mode 100644
index 0000000..1e425e6
--- /dev/null
+++ b/android/app/src/androidTest/java/com/iskenkenya/commory/mobile/BackupManagerInstrumentedTest.kt
@@ -0,0 +1,113 @@
+package com.iskenkenya.commory.mobile
+
+import android.Manifest
+import android.content.Context
+import android.provider.Settings
+import androidx.test.core.app.ApplicationProvider
+import androidx.test.ext.junit.runners.AndroidJUnit4
+import androidx.test.rule.GrantPermissionRule
+import com.iskenkenya.commory.mobile.BuildConfig
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsWriter
+import com.iskenkenya.commory.sdk.backup.BackupManager
+import kotlinx.coroutines.runBlocking
+import org.junit.After
+import org.junit.Before
+import org.junit.Rule
+import org.junit.Test
+import org.junit.runner.RunWith
+import timber.log.Timber
+import java.io.File
+import java.text.SimpleDateFormat
+import java.util.Date
+import java.util.Locale
+import java.util.TimeZone
+import kotlin.test.assertNotNull
+import kotlin.test.assertTrue
+
+@RunWith(AndroidJUnit4::class)
+class BackupManagerInstrumentedTest {
+
+    @get:Rule
+    val permissionRule: GrantPermissionRule = GrantPermissionRule.grant(
+        Manifest.permission.READ_SMS,
+        Manifest.permission.READ_CALL_LOG,
+        Manifest.permission.WRITE_EXTERNAL_STORAGE
+    )
+    
+    private lateinit var context: Context
+    private lateinit var backupManager: BackupManager
+    private var testStartTime: Long = 0
+
+    @Before
+    fun setUp() {
+        context = ApplicationProvider.getApplicationContext()
+        setupTestLogger()
+        testStartTime = System.currentTimeMillis()
+        
+        backupManager = BackupManager(
+            smsReader = AndroidSmsReader(context),
+            callLogReader = AndroidCallLogReader(context),
+            contactReader = AndroidContactReader(context),
+            backupFileWriter = AndroidBackupFileWriter(context),
+            backupFileReader = AndroidBackupFileReader(context),
+            smsWriter = AndroidSmsWriter(context),
+            callLogWriter = AndroidCallLogWriter(context),
+            contactWriter = AndroidContactWriter(context)
+        )
+        
+        Timber.i("[Mobile] INFO [Test] 开始BackupManager设备测试; Context: Instrumented test on device")
+    }
+
+    private fun setupTestLogger() {
+        Timber.plant(object : Timber.Tree() {
+            override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
+                val timestamp = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.US)
+                    .apply { timeZone = TimeZone.getTimeZone("UTC") }
+                    .format(Date())
+                val logMessage = "$timestamp $message"
+                println(logMessage)
+                android.util.Log.println(priority, "CommoryTest", logMessage)
+            }
+        })
+    }
+
+    @Test
+    fun testPerformBackup() = runBlocking {
+        val result = backupManager.performBackup(
+            hasSmsPermission = true,
+            hasCallLogPermission = true,
+            hasContactsPermission = true,
+            deviceInfo = "Test Device",
+            deviceId = Settings.Secure.getString(
+                context.contentResolver,
+                Settings.Secure.ANDROID_ID
+            ) ?: "instrumented-device",
+            appVersion = BuildConfig.VERSION_NAME
+        )
+        
+        Timber.i("[Mobile] INFO [Test] 备份结果; Context: success=${result.success}, smsCount=${result.smsCount}, callLogCount=${result.callLogCount}")
+        
+        if (result.success) {
+            assertNotNull(result.filePath, "备份文件路径不应为null")
+            val backupFile = File(result.filePath!!)
+            assertTrue(backupFile.exists(), "备份文件应该存在")
+            assertTrue(backupFile.length() > 0, "备份文件不应为空")
+            backupFile.delete()
+        }
+        
+        Timber.i("[Mobile] INFO [Test] performBackup测试通过; Context: 成功在设备上执行备份")
+    }
+
+    @After
+    fun tearDown() {
+        Timber.i("[Mobile] INFO [Test] 完成BackupManager设备测试; Context: Test duration=${System.currentTimeMillis() - testStartTime}ms")
+        Timber.uprootAll()
+    }
+} 
diff --git a/android/app/src/androidTest/java/imken/messagevault/mobile/BackupManagerInstrumentedTest.kt b/android/app/src/androidTest/java/imken/messagevault/mobile/BackupManagerInstrumentedTest.kt
deleted file mode 100644
index 5f50441..0000000
--- a/android/app/src/androidTest/java/imken/messagevault/mobile/BackupManagerInstrumentedTest.kt
+++ /dev/null
@@ -1,238 +0,0 @@
-package imken.messagevault.mobile
-
-import android.Manifest
-import android.content.Context
-import androidx.test.core.app.ApplicationProvider
-import androidx.test.ext.junit.runners.AndroidJUnit4
-import androidx.test.platform.app.InstrumentationRegistry
-import androidx.test.rule.GrantPermissionRule
-import imken.messagevault.mobile.data.BackupManager
-import imken.messagevault.mobile.model.BackupData
-import org.junit.After
-import org.junit.Before
-import org.junit.Rule
-import org.junit.Test
-import org.junit.runner.RunWith
-import timber.log.Timber
-import java.io.File
-import java.text.SimpleDateFormat
-import java.util.Date
-import java.util.Locale
-import java.util.TimeZone
-import kotlin.test.assertEquals
-import kotlin.test.assertNotNull
-import kotlin.test.assertTrue
-
-/**
- * BackupManager设备测试
- * 
- * 在真实设备或模拟器上测试以下功能：
- * - 实际环境中的短信和通话记录读取
- * - 备份文件创建和内容验证
- * 
- * 此测试需要授予READ_SMS和READ_CALL_LOG权限。
- * 
- * 作者: Cursor AI
- * 创建日期: 2025-04-17
- */
-@RunWith(AndroidJUnit4::class)
-class BackupManagerInstrumentedTest {
-
-    // 自动授予必要权限
-    @get:Rule
-    val permissionRule: GrantPermissionRule = GrantPermissionRule.grant(
-        Manifest.permission.READ_SMS,
-        Manifest.permission.READ_CALL_LOG,
-        Manifest.permission.WRITE_EXTERNAL_STORAGE
-    )
-    
-    private lateinit var context: Context
-    private lateinit var backupManager: BackupManager
-    private var testStartTime: Long = 0
-
-    @Before
-    fun setUp() {
-        // 获取应用上下文
-        context = ApplicationProvider.getApplicationContext()
-        
-        // 设置测试日志记录器
-        setupTestLogger()
-        
-        // 获取测试开始时间
-        testStartTime = System.currentTimeMillis()
-        
-        // 初始化被测对象
-        backupManager = BackupManager(context)
-        
-        // 记录测试开始
-        Timber.i("[Mobile] INFO [Test] 开始BackupManager设备测试; Context: Instrumented test on device")
-    }
-
-    /**
-     * 设置测试专用的日志记录器
-     */
-    private fun setupTestLogger() {
-        Timber.plant(object : Timber.Tree() {
-            override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
-                val timestamp = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.US)
-                    .apply { timeZone = TimeZone.getTimeZone("UTC") }
-                    .format(Date())
-                
-                // 构造日志消息 
-                val logMessage = "$timestamp $message"
-                
-                // 输出到控制台和Logcat
-                println(logMessage)
-                android.util.Log.println(priority, "MessageVaultTest", logMessage)
-            }
-        })
-    }
-
-    /**
-     * 测试短信读取功能
-     * 
-     * 注意：此测试需要设备上有短信数据，否则将通过但没有实际内容验证
-     */
-    @Test
-    fun testReadSMS() {
-        // 执行被测方法
-        val messages = backupManager.readSMS()
-        
-        // 记录结果
-        Timber.i("[Mobile] INFO [Test] 读取到 ${messages.size} 条短信; Context: Instrumented test on device")
-        
-        // 验证返回的列表不为null
-        assertNotNull(messages, "短信列表不应为null")
-        
-        // 如果有短信，检查第一条短信的内容
-        if (messages.isNotEmpty()) {
-            val firstSms = messages[0]
-            assertNotNull(firstSms.address, "短信地址不应为null")
-            assertNotNull(firstSms.body, "短信内容不应为null")
-            assertTrue(firstSms.id > 0, "短信ID应大于0")
-            
-            // 记录第一条短信内容摘要（不记录完整内容以保护隐私）
-            Timber.i("[Mobile] INFO [Test] 首条短信摘要; Context: ID=${firstSms.id}, 地址长度=${firstSms.address.length}, 内容长度=${firstSms.body.length}")
-        }
-        
-        Timber.i("[Mobile] INFO [Test] readSMS测试通过; Context: 成功在设备上读取短信数据")
-    }
-
-    /**
-     * 测试通话记录读取功能
-     * 
-     * 注意：此测试需要设备上有通话记录数据，否则将通过但没有实际内容验证
-     */
-    @Test
-    fun testReadCallLogs() {
-        // 执行被测方法 
-        val callLogs = backupManager.readCallLogs()
-        
-        // 记录结果
-        Timber.i("[Mobile] INFO [Test] 读取到 ${callLogs.size} 条通话记录; Context: Instrumented test on device")
-        
-        // 验证返回的列表不为null
-        assertNotNull(callLogs, "通话记录列表不应为null")
-        
-        // 如果有通话记录，检查第一条通话记录的内容
-        if (callLogs.isNotEmpty()) {
-            val firstCallLog = callLogs[0]
-            assertNotNull(firstCallLog.number, "通话号码不应为null")
-            assertTrue(firstCallLog.id > 0, "通话记录ID应大于0")
-            assertTrue(firstCallLog.date > 0, "通话日期应大于0")
-            
-            // 记录第一条通话记录内容摘要
-            Timber.i("[Mobile] INFO [Test] 首条通话记录摘要; Context: ID=${firstCallLog.id}, 类型=${firstCallLog.type}, 时长=${firstCallLog.duration}秒")
-        }
-        
-        Timber.i("[Mobile] INFO [Test] readCallLogs测试通过; Context: 成功在设备上读取通话记录数据")
-    }
-
-    /**
-     * 测试备份到JSON文件功能
-     */
-    @Test
-    fun testBackupToJson() {
-        // 创建BackupData对象
-        val backupData = backupManager.createBackupData()
-        
-        // 记录备份数据信息
-        Timber.i("[Mobile] INFO [Test] 创建备份数据; Context: 短信数量=${backupData.messages.size}, 通话记录数量=${backupData.callLogs.size}")
-        
-        // 执行备份
-        val filePath = backupManager.backupToJson(backupData)
-        
-        // 验证文件路径
-        assertNotNull(filePath, "备份文件路径不应为null")
-        
-        // 验证文件是否实际创建
-        val backupFile = File(filePath)
-        assertTrue(backupFile.exists(), "备份文件应该存在")
-        assertTrue(backupFile.length() > 0, "备份文件不应为空")
-        
-        // 记录文件信息
-        Timber.i("[Mobile] INFO [Test] 创建备份文件; Context: 文件路径=$filePath, 文件大小=${backupFile.length()}字节")
-        
-        // 清理测试生成的文件
-        backupFile.delete()
-        
-        Timber.i("[Mobile] INFO [Test] backupToJson测试通过; Context: 成功在设备上创建备份文件")
-    }
-
-    /**
-     * 测试完整备份流程
-     */
-    @Test
-    fun testExecuteBackup() {
-        // 记录测试开始
-        Timber.i("[Mobile] INFO [Test] 测试完整备份流程; Context: Instrumented test on device")
-        
-        // 创建测试回调
-        var callbackResult: Boolean? = null
-        var callbackMessage: String? = null
-        
-        // 执行备份（只本地备份，不上传）
-        backupManager.executeBackup(false) { success, message ->
-            callbackResult = success
-            callbackMessage = message
-            
-            // 记录回调结果
-            Timber.i("[Mobile] INFO [Test] 备份回调; Context: success=$success, message=$message")
-        }
-        
-        // 等待异步操作完成
-        Thread.sleep(2000)
-        
-        // 验证回调结果
-        assertNotNull(callbackResult, "回调结果不应为null")
-        assertNotNull(callbackMessage, "回调消息不应为null")
-        assertEquals(true, callbackResult, "备份应成功完成")
-        
-        // 获取备份文件路径
-        val filePath = callbackMessage?.let {
-            if (it.startsWith("本地备份成功:")) {
-                it.substringAfter("本地备份成功:").trim()
-            } else {
-                it.substringAfter("本地:").substringBefore("\n").trim()
-            }
-        }
-        
-        // 验证文件是否存在
-        if (filePath != null) {
-            val backupFile = File(filePath)
-            assertTrue(backupFile.exists(), "备份文件应该存在")
-            assertTrue(backupFile.length() > 0, "备份文件不应为空")
-            
-            // 清理测试生成的文件
-            backupFile.delete()
-        }
-        
-        Timber.i("[Mobile] INFO [Test] executeBackup测试通过; Context: 成功执行完整备份流程")
-    }
-
-    @After
-    fun tearDown() {
-        Timber.i("[Mobile] INFO [Test] 完成BackupManager设备测试; Context: Test duration=${System.currentTimeMillis() - testStartTime}ms")
-        Timber.uprootAll() // 移除日志记录器
-    }
-} 
\ No newline at end of file
diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index 1a6c826..5cb6d1b 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="imken.messagevault.mobile">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
     <!-- 权限声明 -->
     <!-- READ_SMS: 允许应用读取设备上的短信消息 - 用于备份短信内容 -->
@@ -46,20 +45,20 @@
     -->
 
     <application
-        android:name=".MessageVaultApplication"
+        android:name=".CommoryApplication"
         android:allowBackup="true"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
         android:enableOnBackInvokedCallback="true"
-        android:theme="@style/Theme.MessageVault">
+        android:theme="@style/Theme.Commory">
         
         <!-- 主活动 - 应用入口点 -->
         <activity
             android:name=".MainActivity"
             android:exported="true"
-            android:theme="@style/Theme.MessageVault">
+            android:theme="@style/Theme.Commory">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
                 <category android:name="android.intent.category.LAUNCHER" />
@@ -137,8 +136,8 @@
         
         <!-- 可扩展点：内容提供者，用于共享备份数据
         <provider
-            android:name=".provider.MessageVaultProvider"
-            android:authorities="imken.messagevault.mobile.provider"
+            android:name=".provider.CommoryProvider"
+            android:authorities="com.iskenkenya.commory.mobile.provider"
             android:enabled="true"
             android:exported="false" />
         -->
diff --git a/android/app/src/main/assets/logs/ui-2025-05-13.log b/android/app/src/main/assets/logs/ui-2025-05-13.log
deleted file mode 100644
index e00ba18..0000000
--- a/android/app/src/main/assets/logs/ui-2025-05-13.log
+++ /dev/null
@@ -1 +0,0 @@
-Fixed SMS role request dialog for Android 16
diff --git a/android/app/src/main/java/imken/messagevault/mobile/MessageVaultApp.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/CommoryApp.kt
similarity index 93%
rename from android/app/src/main/java/imken/messagevault/mobile/MessageVaultApp.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/CommoryApp.kt
index ca50f44..da9bb30 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/MessageVaultApp.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/CommoryApp.kt
@@ -1,15 +1,15 @@
-package imken.messagevault.mobile
+package com.iskenkenya.commory.mobile
 
 import android.app.Application
 import android.os.Environment
-import imken.messagevault.mobile.config.Config
+import com.iskenkenya.commory.mobile.config.Config
 import timber.log.Timber
 import java.io.File
 import java.text.SimpleDateFormat
 import java.util.*
 
 /**
- * MessageVault应用类
+ * Commory应用类
  * 
  * 此类是整个应用的入口点，负责初始化关键组件和服务。
  * 当前主要职责是设置日志系统，遵循NOTICE.md中的日志格式要求。
@@ -17,7 +17,7 @@ import java.util.*
  * 日志格式：
  * 2025-04-16T12:34:56Z [Mobile] ERROR [Type] Message; Context: Details with [CRITICAL] for key details
  */
-class MessageVaultApp : Application() {
+class CommoryApp : Application() {
 
     private lateinit var config: Config
 
@@ -82,7 +82,7 @@ class MessageVaultApp : Application() {
         private val logFile: File
             get() {
                 val dateStr = SimpleDateFormat("yyyy-MM-dd", Locale.US).format(Date())
-                return File(logDir, "messagevault-$dateStr.log")
+                return File(logDir, "commory-$dateStr.log")
             }
     
         override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
@@ -117,7 +117,7 @@ class MessageVaultApp : Application() {
                 }
                 
             } catch (e: Exception) {
-                android.util.Log.e("MessageVaultApp", "写入日志文件失败", e)
+                android.util.Log.e("CommoryApp", "写入日志文件失败", e)
             }
         }
     }
diff --git a/android/app/src/main/java/imken/messagevault/mobile/MessageVaultApplication.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/CommoryApplication.kt
similarity index 85%
rename from android/app/src/main/java/imken/messagevault/mobile/MessageVaultApplication.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/CommoryApplication.kt
index e020ddf..92d7935 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/MessageVaultApplication.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/CommoryApplication.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile
+package com.iskenkenya.commory.mobile
 
 import android.app.Application
 import android.util.Log
@@ -9,7 +9,7 @@ import timber.log.Timber
  * 
  * 负责应用级别的初始化工作
  */
-class MessageVaultApplication : Application() {
+class CommoryApplication : Application() {
     
     override fun onCreate() {
         super.onCreate()
@@ -29,7 +29,7 @@ class MessageVaultApplication : Application() {
             Timber.plant(object : Timber.DebugTree() {
                 override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
                     // 确保所有日志也通过Android Log系统输出
-                    Log.println(priority, "MessageVault", message)
+                    Log.println(priority, "Commory", message)
                     super.log(priority, tag, message, t)
                 }
             })
@@ -40,7 +40,7 @@ class MessageVaultApplication : Application() {
             Timber.plant(object : Timber.Tree() {
                 override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
                     if (priority >= Log.INFO) {
-                        Log.println(priority, "MessageVault", message)
+                        Log.println(priority, "Commory", message)
                     }
                 }
             })
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/MainActivity.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/MainActivity.kt
new file mode 100644
index 0000000..5685bd7
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/MainActivity.kt
@@ -0,0 +1,175 @@
+package com.iskenkenya.commory.mobile
+
+import android.content.Context
+import android.content.res.Configuration
+import android.os.Bundle
+import android.util.Log
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.compose.foundation.layout.*
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.runtime.*
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+import androidx.lifecycle.viewmodel.compose.viewModel
+import com.iskenkenya.commory.mobile.config.Config
+import com.iskenkenya.commory.mobile.di.AppContainer
+import com.iskenkenya.commory.mobile.runtime.AppEnvironmentManager
+import com.iskenkenya.commory.mobile.runtime.LocaleResolver
+import com.iskenkenya.commory.mobile.ui.navigation.CommoryAppWithNavigation
+import com.iskenkenya.commory.mobile.ui.navigation.NavigationItem
+import com.iskenkenya.commory.mobile.ui.navigation.navigationItems
+import com.iskenkenya.commory.mobile.ui.permission.PermissionHandler
+import com.iskenkenya.commory.mobile.ui.theme.CommoryTheme
+import com.iskenkenya.commory.mobile.ui.viewmodels.AppViewModel
+import com.iskenkenya.commory.mobile.ui.viewmodels.BackupViewModel
+import com.iskenkenya.commory.mobile.ui.viewmodels.RestoreViewModel
+import com.iskenkenya.commory.mobile.utils.DefaultSmsAppHelper
+import com.iskenkenya.commory.mobile.utils.PermissionUtils
+import timber.log.Timber
+import java.util.Locale
+
+class MainActivity : ComponentActivity() {
+
+    companion object {
+        private const val TAG = "MainActivity"
+    }
+
+    private lateinit var config: Config
+    private lateinit var appContainer: AppContainer
+    private lateinit var permissionHandler: PermissionHandler
+    private lateinit var defaultSmsAppHelper: DefaultSmsAppHelper
+
+    private var initialPermissionsChecked = false
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        if (Timber.forest().isEmpty()) {
+            Timber.plant(object : Timber.DebugTree() {
+                override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
+                    Log.println(priority, "Commory", message)
+                    super.log(priority, tag, message, t)
+                }
+            })
+        }
+
+        Timber.d("[Mobile] DEBUG 日志系统初始化完成")
+        Log.d("Commory", "主活动创建 - 直接Log测试")
+
+        config = Config.getInstance(this)
+        appContainer = AppContainer(applicationContext)
+        permissionHandler = PermissionHandler(this)
+        defaultSmsAppHelper = DefaultSmsAppHelper(this)
+
+        applyLanguage()
+
+        setContent {
+            CommoryTheme {
+                val appViewModel: AppViewModel = viewModel(
+                    factory = AppViewModel.Factory(appContainer)
+                )
+
+                val backupViewModel: BackupViewModel = viewModel(
+                    factory = BackupViewModel.ContainerFactory(this, appContainer)
+                )
+
+                val restoreViewModel: RestoreViewModel = viewModel(
+                    factory = RestoreViewModel.Factory(this)
+                )
+
+                if (!initialPermissionsChecked) {
+                    val permissionsGranted = permissionHandler.checkBackupPermissions()
+                    backupViewModel.setPermissionsGranted(permissionsGranted)
+                    restoreViewModel.setPermissionsGranted(permissionsGranted)
+                    initialPermissionsChecked = true
+                }
+
+                Surface(
+                    modifier = Modifier.fillMaxSize(),
+                    color = MaterialTheme.colorScheme.background
+                ) {
+                    CommoryAppWithNavigation(
+                        appViewModel = appViewModel,
+                        backupViewModel = backupViewModel,
+                        restoreViewModel = restoreViewModel,
+                        navigationItems = navigationItems
+                    )
+                }
+            }
+        }
+
+        Timber.i("[Mobile] INFO [UI] 实现MD3 UI与底部导航; Context: 应用启动")
+    }
+
+    private fun applyLanguage() {
+        val environment = AppEnvironmentManager(this).currentSnapshot()
+        val locale = LocaleResolver.resolveLocale(environment)
+        Locale.setDefault(locale)
+
+        val configuration = Configuration(resources.configuration)
+        configuration.setLocale(locale)
+        createConfigurationContext(configuration)
+    }
+
+    override fun attachBaseContext(newBase: Context) {
+        val environment = AppEnvironmentManager(newBase).currentSnapshot()
+        super.attachBaseContext(LocaleResolver.wrapContext(newBase, environment))
+    }
+
+    override fun onResume() {
+        super.onResume()
+        if (PermissionUtils.checkAllRequiredPermissions(this)) {
+            Timber.d("[Mobile] DEBUG [Permissions] 所有需要的权限已授予")
+        }
+    }
+
+    fun requestDefaultSmsApp() {
+        defaultSmsAppHelper.requestDefaultSmsApp()
+    }
+
+    fun isDefaultSmsApp(): Boolean {
+        return defaultSmsAppHelper.isDefaultSmsApp()
+    }
+
+    fun showDefaultSmsAppDialog() {
+        defaultSmsAppHelper.showDefaultSmsAppDialog()
+    }
+
+    fun showRestoreDefaultSmsAppDialog() {
+        defaultSmsAppHelper.showRestoreDefaultSmsAppDialog()
+    }
+}
+
+@Preview(showBackground = true)
+@Composable
+fun CommoryAppPreview() {
+    CommoryTheme {
+        Surface(
+            modifier = Modifier.fillMaxSize(),
+            color = MaterialTheme.colorScheme.background
+        ) {
+            Column(
+                modifier = Modifier.padding(16.dp),
+                horizontalAlignment = Alignment.CenterHorizontally,
+                verticalArrangement = Arrangement.Center
+            ) {
+                androidx.compose.material3.Text(
+                    text = stringResource(id = R.string.app_title),
+                    style = MaterialTheme.typography.headlineLarge
+                )
+
+                Spacer(modifier = Modifier.height(16.dp))
+
+                androidx.compose.material3.Text(
+                    text = stringResource(id = R.string.app_description),
+                    style = MaterialTheme.typography.bodyLarge
+                )
+            }
+        }
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/SmsReplyActivity.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/SmsReplyActivity.kt
similarity index 98%
rename from android/app/src/main/java/imken/messagevault/mobile/SmsReplyActivity.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/SmsReplyActivity.kt
index cbcf378..83ae78a0 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/SmsReplyActivity.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/SmsReplyActivity.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile
+package com.iskenkenya.commory.mobile
 
 import android.content.Intent
 import android.os.Bundle
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/agent/AgentContextModels.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/agent/AgentContextModels.kt
new file mode 100644
index 0000000..7fe17f8
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/agent/AgentContextModels.kt
@@ -0,0 +1,43 @@
+package com.iskenkenya.commory.mobile.agent
+
+import com.iskenkenya.commory.mobile.runtime.RuntimeMode
+
+enum class AgentContextSource {
+    MESSAGE,
+    CALL_LOG,
+    CONTACT
+}
+
+enum class AgentProviderPolicy {
+    LOCAL_ONLY,
+    SERVER_ALLOWED
+}
+
+data class AgentContextReference(
+    val source: AgentContextSource,
+    val sourceId: String,
+    val participantIds: List<String>,
+    val timestampMillis: Long,
+    val preview: String
+)
+
+data class AgentContextWindow(
+    val query: String,
+    val references: List<AgentContextReference>,
+    val maxItems: Int = 20,
+    val maxPreviewChars: Int = 240,
+    val policy: AgentProviderPolicy
+)
+
+object AgentPrivacyPolicy {
+    fun policyFor(runtimeMode: RuntimeMode): AgentProviderPolicy {
+        return when (runtimeMode) {
+            RuntimeMode.LOCAL_ONLY -> AgentProviderPolicy.LOCAL_ONLY
+            RuntimeMode.COMMORY_SERVER -> AgentProviderPolicy.SERVER_ALLOWED
+        }
+    }
+
+    fun trimPreview(value: String, maxChars: Int = 240): String {
+        return if (value.length <= maxChars) value else value.take(maxChars)
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/api/ApiClient.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/api/ApiClient.kt
similarity index 92%
rename from android/app/src/main/java/imken/messagevault/mobile/api/ApiClient.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/api/ApiClient.kt
index 8703232..33dfeaf 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/api/ApiClient.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/api/ApiClient.kt
@@ -1,7 +1,7 @@
-package imken.messagevault.mobile.api
+package com.iskenkenya.commory.mobile.api
 
-import imken.messagevault.mobile.config.Config
-import imken.messagevault.mobile.data.BackupFile
+import com.iskenkenya.commory.mobile.config.Config
+import com.iskenkenya.commory.mobile.models.BackupFile
 import timber.log.Timber
 
 /**
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/auth/CommoryServerAuthProvider.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/auth/CommoryServerAuthProvider.kt
new file mode 100644
index 0000000..d38c266
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/auth/CommoryServerAuthProvider.kt
@@ -0,0 +1,73 @@
+package com.iskenkenya.commory.mobile.auth
+
+import com.iskenkenya.commory.mobile.remote.CommoryServerClient
+import com.iskenkenya.commory.mobile.remote.NetworkError
+import com.iskenkenya.commory.mobile.remote.NetworkException
+import com.iskenkenya.commory.mobile.runtime.AppEnvironmentManager
+import com.iskenkenya.commory.mobile.runtime.AuthSession
+import com.iskenkenya.commory.sdk.auth.AuthCredentials
+import com.iskenkenya.commory.sdk.auth.AuthProvider
+import com.iskenkenya.commory.sdk.auth.AuthResult
+import com.iskenkenya.commory.sdk.auth.UserInfo
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+
+class CommoryServerAuthProvider(
+    private val environmentManager: AppEnvironmentManager,
+    private val serverClient: CommoryServerClient
+) : AuthProvider {
+    private val _isAuthenticated = MutableStateFlow(environmentManager.currentSnapshot().authSession.isAuthenticated)
+    override val isAuthenticated: StateFlow<Boolean> = _isAuthenticated.asStateFlow()
+
+    private val _currentUser = MutableStateFlow(environmentManager.currentSnapshot().authSession.toUserInfo())
+    override val currentUser: StateFlow<UserInfo?> = _currentUser.asStateFlow()
+
+    override suspend fun login(credentials: AuthCredentials): AuthResult {
+        val password = credentials as? AuthCredentials.Password
+            ?: return AuthResult.Error("UNSUPPORTED", "Unsupported credentials")
+        val environment = environmentManager.currentSnapshot()
+        val session = serverClient.login(
+            baseUrl = environment.serverUrl,
+            userName = password.username,
+            password = password.password
+        ).getOrElse { return AuthResult.Error("LOGIN_FAILED", it.message ?: "login failed") }
+        environmentManager.updateSession(session)
+        _isAuthenticated.value = true
+        _currentUser.value = session.toUserInfo()
+        return AuthResult.Success(session.accessToken.orEmpty(), session.toUserInfo()!!)
+    }
+
+    override suspend fun logout() {
+        serverClient.logoutPersistedSession().getOrElse {
+            environmentManager.clearSession()
+        }
+        _isAuthenticated.value = false
+        _currentUser.value = null
+    }
+
+    override suspend fun refreshToken(): AuthResult {
+        val refreshed = serverClient.refreshPersistedSession()
+            .getOrElse {
+                if (it is NetworkException && it.error is NetworkError.Unauthorized) {
+                    _isAuthenticated.value = false
+                    _currentUser.value = null
+                }
+                return AuthResult.Error("REFRESH_FAILED", it.message ?: "refresh failed")
+            }
+        _isAuthenticated.value = true
+        _currentUser.value = refreshed.toUserInfo()
+        return AuthResult.Success(refreshed.accessToken.orEmpty(), refreshed.toUserInfo()!!)
+    }
+
+    override fun getToken(): String? = environmentManager.currentSnapshot().authSession.accessToken
+
+    private fun AuthSession.toUserInfo(): UserInfo? {
+        val id = userId ?: return null
+        return UserInfo(
+            userId = id,
+            displayName = userName ?: email ?: id,
+            email = email
+        )
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/config/Config.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/config/Config.kt
similarity index 97%
rename from android/app/src/main/java/imken/messagevault/mobile/config/Config.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/config/Config.kt
index a8185cb..e9e6d34 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/config/Config.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/config/Config.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.config
+package com.iskenkenya.commory.mobile.config
 
 import android.content.Context
 import androidx.datastore.core.DataStore
@@ -40,7 +40,7 @@ class Config(private val context: Context) {
         }
 
         // 默认配置常量
-        private const val DEFAULT_SERVER_URL = "https://api.messagevault.example.com"
+        private const val DEFAULT_SERVER_URL = "https://api.commory.example.com"
         private const val DEFAULT_API_VERSION = "v1"
         private const val DEFAULT_CONNECTION_TIMEOUT = 30000
         private const val DEFAULT_BACKUP_INTERVAL = 24 // 小时
@@ -84,7 +84,7 @@ class Config(private val context: Context) {
     fun getAppVersion(): String {
         return try {
             val packageInfo = context.packageManager.getPackageInfo(context.packageName, 0)
-            packageInfo.versionName
+            packageInfo.versionName ?: "未知版本"
         } catch (e: Exception) {
             Timber.e(e, "[Mobile] ERROR [Config] 获取应用版本失败")
             "未知版本"
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/api/BackupApi.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/api/BackupApi.kt
similarity index 90%
rename from android/app/src/main/java/imken/messagevault/mobile/data/api/BackupApi.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/data/api/BackupApi.kt
index f27bbeb..e0bc068 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/data/api/BackupApi.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/api/BackupApi.kt
@@ -1,6 +1,6 @@
-package imken.messagevault.mobile.data.api
+package com.iskenkenya.commory.mobile.data.api
 
-import imken.messagevault.mobile.model.BackupData
+import com.iskenkenya.commory.mobile.model.BackupData
 import retrofit2.Call
 import retrofit2.http.Body
 import retrofit2.http.Header
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidBackupFileReader.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidBackupFileReader.kt
new file mode 100644
index 0000000..aaba0fb
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidBackupFileReader.kt
@@ -0,0 +1,195 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.Context
+import com.google.gson.Gson
+import com.google.gson.JsonObject
+import com.google.gson.JsonParser
+import com.google.gson.reflect.TypeToken
+import com.iskenkenya.commory.mobile.model.BackupData
+import com.iskenkenya.commory.sdk.backup.msglayer.MsgLayerSerializer
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerIdentity
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerRootExport
+import com.iskenkenya.commory.sdk.backup.model.BackupReadData
+import com.iskenkenya.commory.sdk.backup.model.CallLogData
+import com.iskenkenya.commory.sdk.backup.model.ContactData
+import com.iskenkenya.commory.sdk.backup.model.SmsData
+import com.iskenkenya.commory.sdk.backup.reader.BackupFileReader
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import timber.log.Timber
+import java.io.File
+import java.io.FileReader
+import kotlin.math.absoluteValue
+
+class AndroidBackupFileReader(
+    private val context: Context
+) : BackupFileReader {
+
+    private val gson = Gson()
+    private val msgLayerGson = MsgLayerSerializer().gson()
+
+    override suspend fun read(filePath: String): BackupReadData? = withContext(Dispatchers.IO) {
+        try {
+            val file = File(filePath)
+            if (!file.exists() || !file.isFile || !file.canRead()) {
+                Timber.e("[Mobile] ERROR [Restore] Backup file does not exist or is not readable: $filePath")
+                return@withContext null
+            }
+
+            val fileContent = file.readText()
+            val containsCallLogs = fileContent.contains("\"callLogs\"") || fileContent.contains("\"call_logs\"")
+            val containsMessages = fileContent.contains("\"messages\"") || fileContent.contains("\"sms\"")
+            val containsContacts = fileContent.contains("\"contacts\"")
+
+            Timber.d("[Mobile] DEBUG [Restore] Backup file content analysis: hasCallLogs=$containsCallLogs, hasMessages=$containsMessages, hasContacts=$containsContacts")
+
+            val parsedRoot = runCatching {
+                JsonParser.parseString(fileContent).asJsonObject
+            }.getOrNull()
+
+            if (parsedRoot?.get("version")?.asString == com.iskenkenya.commory.sdk.backup.msglayer.model.MSG_LAYER_VERSION) {
+                val msgLayer = msgLayerGson.fromJson(fileContent, MsgLayerRootExport::class.java)
+                    ?: return@withContext null
+                return@withContext msgLayer.toBackupReadData()
+            }
+
+            FileReader(file).use { reader ->
+                val typeToken = object : TypeToken<BackupData>() {}.type
+                val backupData = gson.fromJson<BackupData>(reader, typeToken)
+                    ?: return@withContext null
+
+                val messagesCount = backupData.messages?.size ?: 0
+                val callLogsCount = backupData.callLogs?.size ?: 0
+                val contactsCount = backupData.contacts?.size ?: 0
+
+                Timber.i("[Mobile] INFO [Restore] Successfully parsed backup file: SMS=$messagesCount, callLogs=$callLogsCount, contacts=$contactsCount")
+
+                if (containsCallLogs && callLogsCount == 0) {
+                    Timber.w("[Mobile] WARN [Restore] File contains call log fields but parsed as empty, possible field name mismatch")
+                }
+
+                val smsDataList = backupData.messages?.map { msg ->
+                    SmsData(
+                        id = msg.id,
+                        address = msg.address,
+                        body = msg.body,
+                        date = msg.date,
+                        type = msg.type,
+                        readState = msg.readState,
+                        messageStatus = msg.messageStatus,
+                        threadId = msg.threadId
+                    )
+                } ?: emptyList()
+
+                val callLogDataList = backupData.callLogs?.map { callLog ->
+                    CallLogData(
+                        id = callLog.id,
+                        number = callLog.number,
+                        type = callLog.type,
+                        date = callLog.date,
+                        duration = callLog.duration,
+                        contact = callLog.contact
+                    )
+                } ?: emptyList()
+
+                val contactDataList = backupData.contacts?.map { contact ->
+                    ContactData(
+                        id = contact.id,
+                        name = contact.name,
+                        phoneNumbers = contact.phoneNumbers.toList(),
+                        emails = contact.emails
+                    )
+                } ?: emptyList()
+
+                BackupReadData(
+                    messages = smsDataList,
+                    callLogs = callLogDataList,
+                    contacts = contactDataList,
+                    timestamp = backupData.timestamp,
+                    deviceInfo = backupData.deviceInfo
+                )
+            }
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Restore] Failed to parse backup file: $filePath, ${e.message}")
+            null
+        }
+    }
+
+    private fun MsgLayerRootExport.toBackupReadData(): BackupReadData {
+        val identitiesById = identities.associateBy { it.id }
+        val messages = events.filter { it.type == "sms" }.mapNotNull { event ->
+            val address = event.counterpartyAddress(identitiesById)
+            val threadId = event.relations.firstOrNull { it.type == "same_thread" }
+                ?.target
+                ?.removePrefix("thread_")
+                ?.toLongOrNull()
+                ?: 0L
+            SmsData(
+                id = event.id.removePrefix("sms_").toLongOrNull() ?: event.id.hashCode().toLong().absoluteValue,
+                address = address,
+                body = event.content["text"] as? String ?: "",
+                date = event.timestamp.toEpochMillis(),
+                type = if (event.direction == "outbound") 2 else 1,
+                readState = if ((event.meta["read"] as? Boolean) == true) 1 else 0,
+                messageStatus = (event.meta["status"] as? Number)?.toInt() ?: 0,
+                threadId = threadId
+            )
+        }
+        val calls = events.filter { it.type == "call" }.mapNotNull { event ->
+            val address = event.counterpartyAddress(identitiesById)
+            CallLogData(
+                id = event.id.removePrefix("call_").toLongOrNull() ?: event.id.hashCode().toLong().absoluteValue,
+                number = address,
+                type = when (event.content["call_type"] as? String ?: "unknown") {
+                    "outgoing" -> 2
+                    "incoming" -> 3
+                    "rejected" -> 5
+                    "voicemail" -> 4
+                    else -> 1
+                },
+                date = event.timestamp.toEpochMillis(),
+                duration = (event.content["duration_sec"] as? Number)?.toInt() ?: 0,
+                contact = event.counterpartyName(identitiesById)
+            )
+        }
+        val contacts = identities
+            .filter { it.type == "person" }
+            .map { identity ->
+                ContactData(
+                    id = identity.id.hashCode().toLong().absoluteValue,
+                    name = identity.displayName,
+                    phoneNumbers = identity.phones,
+                    emails = identity.emails
+                )
+            }
+        return BackupReadData(
+            messages = messages,
+            callLogs = calls,
+            contacts = contacts,
+            timestamp = exportedAt.toEpochMillis(),
+            deviceInfo = source.deviceId
+        )
+    }
+
+    private fun com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerEvent.counterpartyAddress(
+        identitiesById: Map<String, MsgLayerIdentity>
+    ): String {
+        val identityId = participants.firstOrNull { !it.startsWith("self/") } ?: return ""
+        val identity = identitiesById[identityId]
+        return identity?.phones?.firstOrNull() ?: identity?.displayName ?: identityId
+    }
+
+    private fun com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerEvent.counterpartyName(
+        identitiesById: Map<String, MsgLayerIdentity>
+    ): String? {
+        val identityId = participants.firstOrNull { !it.startsWith("self/") } ?: return null
+        return identitiesById[identityId]?.displayName
+    }
+
+    private fun String.toEpochMillis(): Long = try {
+        java.time.OffsetDateTime.parse(this).toInstant().toEpochMilli()
+    } catch (exception: Exception) {
+        Timber.w(exception, "[Mobile] WARN [Restore] Invalid RFC3339 timestamp: %s", this)
+        0L
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidBackupFileWriter.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidBackupFileWriter.kt
new file mode 100644
index 0000000..b7616dd
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidBackupFileWriter.kt
@@ -0,0 +1,94 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.Context
+import android.os.Build
+import com.iskenkenya.commory.sdk.backup.model.BackupResult
+import com.iskenkenya.commory.sdk.backup.model.BackupWriteStats
+import com.iskenkenya.commory.sdk.backup.msglayer.MsgLayerSerializer
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MSG_LAYER_VERSION
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerRootExport
+import com.iskenkenya.commory.sdk.backup.writer.BackupFileWriter
+import timber.log.Timber
+import java.io.File
+import java.text.SimpleDateFormat
+import java.util.Date
+import java.util.Locale
+
+class AndroidBackupFileWriter(private val context: Context) : BackupFileWriter {
+
+    private val serializer = MsgLayerSerializer()
+
+    override suspend fun writeBackup(export: MsgLayerRootExport, stats: BackupWriteStats): BackupResult {
+        try {
+            val backupDir = File(context.getExternalFilesDir(null), "backups")
+            if (!backupDir.exists()) {
+                backupDir.mkdirs()
+            }
+
+            val fileName = generateUserFriendlyFileName()
+            val backupFile = File(backupDir, fileName)
+
+            Timber.d(
+                "[Mobile] DEBUG [Backup] MsgLayer数据准备情况: 短信=${stats.smsCount}, 通话记录=${stats.callLogCount}, 联系人=${stats.contactCount}, 版本=${export.version}"
+            )
+
+            val jsonString = serializer.toJson(export)
+
+            try {
+                backupFile.writeText(jsonString)
+                Timber.d("[Mobile] DEBUG [Backup] 成功将数据写入文件")
+            } catch (e: Exception) {
+                Timber.e(e, "[Mobile] ERROR [Backup] 写入文件失败: ${e.message}")
+                return BackupResult(
+                    success = false,
+                    timestamp = System.currentTimeMillis(),
+                    appVersion = "",
+                    deviceId = "",
+                    errorMessage = "写入文件失败: ${e.message}"
+                )
+            }
+
+            if (!backupFile.exists() || backupFile.length() <= 10) {
+                Timber.e("[Mobile] ERROR [Backup] 创建的备份文件为空或过小: ${backupFile.length()} 字节")
+                backupFile.delete()
+                return BackupResult(
+                    success = false,
+                    timestamp = System.currentTimeMillis(),
+                    appVersion = "",
+                    deviceId = "",
+                    errorMessage = "创建的备份文件为空或过小"
+                )
+            }
+
+            Timber.i("[Mobile] INFO [Backup] 成功创建备份文件: ${backupFile.absolutePath}, 大小: ${backupFile.length()} 字节")
+
+            return BackupResult(
+                success = true,
+                timestamp = System.currentTimeMillis(),
+                appVersion = export.source.appVersion,
+                deviceId = export.source.deviceId,
+                smsCount = stats.smsCount,
+                callLogCount = stats.callLogCount,
+                fileName = backupFile.name,
+                filePath = backupFile.absolutePath
+            )
+
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Backup] 创建本地备份文件失败; Context: ${e.message}")
+            return BackupResult(
+                success = false,
+                timestamp = System.currentTimeMillis(),
+                appVersion = "",
+                deviceId = "",
+                errorMessage = "创建本地备份文件失败: ${e.message}"
+            )
+        }
+    }
+
+    private fun generateUserFriendlyFileName(deviceName: String? = null): String {
+        val dateFormat = SimpleDateFormat("yyyy-MM-dd_HH-mm", Locale.getDefault())
+        val timestamp = dateFormat.format(Date())
+        val device = deviceName ?: Build.MODEL.replace(" ", "_")
+        return "${MSG_LAYER_VERSION.replace("/", "-")}_${device}_${timestamp}.json"
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidCallLogReader.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidCallLogReader.kt
new file mode 100644
index 0000000..604672f
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidCallLogReader.kt
@@ -0,0 +1,156 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.Context
+import android.content.ContentResolver
+import android.content.pm.PackageManager
+import android.provider.CallLog.Calls
+import com.iskenkenya.commory.mobile.utils.PhoneNumberUtils
+import com.iskenkenya.commory.sdk.backup.model.CallLog
+import com.iskenkenya.commory.sdk.backup.reader.CallLogReader
+import timber.log.Timber
+
+class AndroidCallLogReader(
+    private val context: Context,
+    private val contentResolver: ContentResolver = context.contentResolver,
+    private val hasPermission: (String) -> Boolean = { permission ->
+        context.checkSelfPermission(permission) == PackageManager.PERMISSION_GRANTED
+    }
+) : CallLogReader {
+
+    override suspend fun readCallLogs(): List<CallLog>? {
+        val callLogs = mutableListOf<CallLog>()
+
+        try {
+            if (!hasPermission(android.Manifest.permission.READ_CALL_LOG)) {
+                Timber.e("[Mobile] ERROR [Backup] 备份通话记录失败: 没有 READ_CALL_LOG 权限")
+                return null
+            }
+
+            Timber.d("[Mobile] DEBUG [Backup] 开始读取通话记录...")
+
+            val uri = Calls.CONTENT_URI
+            val projection = arrayOf(
+                Calls._ID,
+                Calls.NUMBER,
+                Calls.CACHED_NAME,
+                Calls.DATE,
+                Calls.DURATION,
+                Calls.TYPE
+            )
+            val sortOrder = "${Calls.DATE} DESC"
+
+            val timeRanges = generateTimeRanges()
+            var totalCallLogs = 0
+
+            for (range in timeRanges) {
+                val selection = "${Calls.DATE} >= ? AND ${Calls.DATE} <= ?"
+                val selectionArgs = arrayOf(range.first.toString(), range.second.toString())
+
+                Timber.d("[Mobile] DEBUG [Backup] 查询时间范围: ${range.first} 到 ${range.second}")
+
+                try {
+                    contentResolver.query(uri, projection, selection, selectionArgs, sortOrder)?.use { cursor ->
+                        totalCallLogs += cursor.count
+
+                        val idColumn = cursor.getColumnIndex(Calls._ID)
+                        val numberColumn = cursor.getColumnIndex(Calls.NUMBER)
+                        val nameColumn = cursor.getColumnIndex(Calls.CACHED_NAME)
+                        val dateColumn = cursor.getColumnIndex(Calls.DATE)
+                        val durationColumn = cursor.getColumnIndex(Calls.DURATION)
+                        val typeColumn = cursor.getColumnIndex(Calls.TYPE)
+
+                        Timber.d("[Mobile] DEBUG [Backup] 批次查询到 ${cursor.count} 条通话记录")
+
+                        while (cursor.moveToNext()) {
+                            try {
+                                val id = if (idColumn != -1 && !cursor.isNull(idColumn)) cursor.getLong(idColumn) else 0L
+
+                                val originalNumber = if (numberColumn != -1 && !cursor.isNull(numberColumn)) {
+                                    cursor.getString(numberColumn)
+                                } else {
+                                    "unknown"
+                                }
+
+                                val normalizedNumber = if (originalNumber != "unknown") {
+                                    val normalized = PhoneNumberUtils.normalizePhoneNumber(originalNumber)
+                                    if (normalized != originalNumber) {
+                                        Timber.d("[Mobile] DEBUG [Backup] 通话记录号码已规范化: $originalNumber -> $normalized")
+                                    }
+                                    normalized
+                                } else {
+                                    originalNumber
+                                }
+
+                                val name = if (nameColumn != -1 && !cursor.isNull(nameColumn)) {
+                                    cursor.getString(nameColumn)
+                                } else {
+                                    null
+                                }
+
+                                val date = if (dateColumn != -1 && !cursor.isNull(dateColumn)) {
+                                    cursor.getLong(dateColumn)
+                                } else {
+                                    System.currentTimeMillis()
+                                }
+
+                                val duration = if (durationColumn != -1 && !cursor.isNull(durationColumn)) {
+                                    cursor.getInt(durationColumn)
+                                } else {
+                                    0
+                                }
+
+                                val type = if (typeColumn != -1 && !cursor.isNull(typeColumn)) {
+                                    cursor.getInt(typeColumn)
+                                } else {
+                                    Calls.INCOMING_TYPE
+                                }
+
+                                val callLog = CallLog(
+                                    id = id,
+                                    number = normalizedNumber,
+                                    contact = name,
+                                    date = date,
+                                    duration = duration,
+                                    type = type
+                                )
+
+                                callLogs.add(callLog)
+                            } catch (e: Exception) {
+                                Timber.e(e, "[Mobile] ERROR [Backup] 处理单条通话记录失败: ${e.message}")
+                            }
+                        }
+                    } ?: run {
+                        Timber.e("[Mobile] ERROR [Backup] 查询时间范围 ${range.first} 到 ${range.second} 失败: 返回null")
+                    }
+                } catch (e: Exception) {
+                    Timber.e(e, "[Mobile] ERROR [Backup] 查询时间范围 ${range.first} 到 ${range.second} 失败: ${e.message}")
+                }
+            }
+
+            Timber.d("[Mobile] DEBUG [Backup] 找到 ${callLogs.size} 条通话记录，总查询数 $totalCallLogs")
+            Timber.i("[Mobile] INFO [Backup] 成功读取 ${callLogs.size} 条通话记录")
+
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Backup] 备份通话记录异常: ${e.message}")
+            return callLogs.takeIf { it.isNotEmpty() }
+        }
+
+        return callLogs
+    }
+
+    private fun generateTimeRanges(ranges: Int = 4): List<Pair<Long, Long>> {
+        val result = mutableListOf<Pair<Long, Long>>()
+        val endTime = System.currentTimeMillis()
+        val startTime = endTime - (365L * 24 * 60 * 60 * 1000)
+
+        val rangeSize = (endTime - startTime) / ranges
+
+        for (i in 0 until ranges) {
+            val rangeStart = startTime + (i * rangeSize)
+            val rangeEnd = if (i == ranges - 1) endTime else startTime + ((i + 1) * rangeSize - 1)
+            result.add(Pair(rangeStart, rangeEnd))
+        }
+
+        return result
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidCallLogWriter.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidCallLogWriter.kt
new file mode 100644
index 0000000..daf34c0
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidCallLogWriter.kt
@@ -0,0 +1,159 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.ContentResolver
+import android.content.ContentValues
+import android.content.Context
+import android.net.Uri
+import android.provider.CallLog
+import android.provider.ContactsContract
+import com.iskenkenya.commory.mobile.utils.PhoneNumberUtils
+import com.iskenkenya.commory.sdk.backup.model.CallLogData
+import com.iskenkenya.commory.sdk.backup.writer.CallLogWriter
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.withContext
+import timber.log.Timber
+
+class AndroidCallLogWriter(
+    private val context: Context
+) : CallLogWriter {
+
+    private val contentResolver: ContentResolver = context.contentResolver
+
+    override suspend fun write(callLogs: List<CallLogData>): Int = withContext(Dispatchers.IO) {
+        var restoredCount = 0
+        val totalCount = callLogs.size
+        Timber.i("[Mobile] INFO [Restore] Starting call log restore, total: $totalCount")
+
+        if (!hasCallLogPermissions()) {
+            Timber.e("[Mobile] ERROR [Restore] Missing call log permissions")
+            return@withContext 0
+        }
+
+        val fixedCallLogs = callLogs.map { callLog ->
+            if (callLog.number.isBlank()) {
+                callLog
+            } else {
+                val normalizedNumber = PhoneNumberUtils.normalizePhoneNumber(callLog.number)
+                if (normalizedNumber != callLog.number) {
+                    Timber.d("[Mobile] DEBUG [Restore] Call log number normalized: ${callLog.number} -> $normalizedNumber")
+                    callLog.copy(number = normalizedNumber)
+                } else {
+                    callLog
+                }
+            }
+        }
+
+        val callLogsByNumber = mutableMapOf<String, MutableList<CallLogData>>()
+
+        fixedCallLogs.forEach { callLog ->
+            if (callLog.number.isNotBlank()) {
+                val normalized = PhoneNumberUtils.normalizePhoneNumber(callLog.number)
+                if (!callLogsByNumber.containsKey(normalized)) {
+                    callLogsByNumber[normalized] = mutableListOf()
+                }
+                callLogsByNumber[normalized]!!.add(callLog)
+            } else {
+                val unknownKey = "unknown_${callLog.id}"
+                if (!callLogsByNumber.containsKey(unknownKey)) {
+                    callLogsByNumber[unknownKey] = mutableListOf()
+                }
+                callLogsByNumber[unknownKey]!!.add(callLog)
+            }
+        }
+
+        Timber.d("[Mobile] DEBUG [Restore] Grouped by normalized number, ${callLogsByNumber.size} unique contacts")
+
+        var processedCount = 0
+
+        for ((_, numberCallLogs) in callLogsByNumber) {
+            for (callLog in numberCallLogs) {
+                try {
+                    val values = ContentValues().apply {
+                        put(CallLog.Calls.NUMBER, callLog.number)
+                        put(CallLog.Calls.TYPE, callLog.type)
+                        put(CallLog.Calls.DATE, callLog.date)
+                        put(CallLog.Calls.DURATION, callLog.duration.toLong())
+                        put(CallLog.Calls.NEW, 0)
+
+                        if (callLog.number.isNotBlank()) {
+                            val contactName = getContactNameFromNumber(callLog.number)
+                            if (contactName != null) {
+                                put(CallLog.Calls.CACHED_NAME, contactName)
+                                Timber.d("[Mobile] DEBUG [Restore] Call log matched contact: ${callLog.number} -> $contactName")
+                            }
+                        }
+                    }
+
+                    val uri = contentResolver.insert(CallLog.Calls.CONTENT_URI, values)
+                    if (uri != null) {
+                        restoredCount++
+                    }
+
+                    processedCount++
+                    if (processedCount % 10 == 0) {
+                        delay(50)
+                    }
+                } catch (e: Exception) {
+                    Timber.e(e, "[Mobile] ERROR [Restore] Failed to restore call log: number=${callLog.number}, ${e.message}")
+                }
+            }
+
+            delay(100)
+        }
+
+        Timber.i("[Mobile] INFO [Restore] Call log restore complete: success=$restoredCount, total=$totalCount")
+        restoredCount
+    }
+
+    private fun getContactNameFromNumber(phoneNumber: String): String? {
+        if (phoneNumber.isBlank()) return null
+
+        val name = getContactNameByExactNumber(phoneNumber)
+        if (name != null) return name
+
+        val variants = PhoneNumberUtils.getPossibleNumberVariants(phoneNumber)
+        for (variant in variants) {
+            val variantName = getContactNameByExactNumber(variant)
+            if (variantName != null) {
+                Timber.d("[Mobile] DEBUG [Restore] Matched contact via number variant: $phoneNumber -> $variant -> $variantName")
+                return variantName
+            }
+        }
+
+        return null
+    }
+
+    private fun getContactNameByExactNumber(phoneNumber: String): String? {
+        val uri = Uri.withAppendedPath(ContactsContract.PhoneLookup.CONTENT_FILTER_URI, Uri.encode(phoneNumber))
+        val projection = arrayOf(ContactsContract.PhoneLookup.DISPLAY_NAME)
+
+        try {
+            val cursor = contentResolver.query(uri, projection, null, null, null)
+            cursor?.use {
+                if (it.moveToFirst()) {
+                    return it.getString(it.getColumnIndexOrThrow(ContactsContract.PhoneLookup.DISPLAY_NAME))
+                }
+            }
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Restore] Failed to query contact name: number=$phoneNumber, ${e.message}")
+        }
+
+        return null
+    }
+
+    private fun hasCallLogPermissions(): Boolean {
+        val readPermission = android.Manifest.permission.READ_CALL_LOG
+        val writePermission = android.Manifest.permission.WRITE_CALL_LOG
+
+        val readGranted = context.checkSelfPermission(readPermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        val writeGranted = context.checkSelfPermission(writePermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
+
+        if (!readGranted || !writeGranted) {
+            Timber.e("[Mobile] ERROR [Restore] Missing call log permissions: READ_CALL_LOG=$readGranted, WRITE_CALL_LOG=$writeGranted")
+            return false
+        }
+
+        return true
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidContactReader.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidContactReader.kt
new file mode 100644
index 0000000..1f72b70
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidContactReader.kt
@@ -0,0 +1,344 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.Context
+import android.os.Build
+import android.provider.ContactsContract
+import com.iskenkenya.commory.sdk.backup.model.Contact
+import com.iskenkenya.commory.sdk.backup.reader.ContactReader
+import timber.log.Timber
+
+class AndroidContactReader(private val context: Context) : ContactReader {
+
+    override suspend fun readContacts(): List<Contact>? {
+        val contacts = mutableListOf<Contact>()
+
+        try {
+            val permissionStatus = context.checkSelfPermission(android.Manifest.permission.READ_CONTACTS)
+            if (permissionStatus != android.content.pm.PackageManager.PERMISSION_GRANTED) {
+                Timber.e("[Mobile] ERROR [Backup] 备份联系人失败: 没有 READ_CONTACTS 权限")
+                return null
+            }
+
+            Timber.d("[Mobile] DEBUG [Backup] 开始读取联系人...")
+
+            val uri = ContactsContract.Contacts.CONTENT_URI
+            val projection = arrayOf(
+                ContactsContract.Contacts._ID,
+                ContactsContract.Contacts.DISPLAY_NAME,
+                ContactsContract.Contacts.HAS_PHONE_NUMBER,
+                ContactsContract.Contacts.PHOTO_URI
+            )
+            val sortOrder = "${ContactsContract.Contacts.DISPLAY_NAME} ASC"
+
+            context.contentResolver.query(uri, projection, null, null, sortOrder)?.use { cursor ->
+                Timber.d("[Mobile] DEBUG [Backup] 找到 ${cursor.count} 个联系人")
+
+                val idColumn = cursor.getColumnIndex(ContactsContract.Contacts._ID)
+                val nameColumn = cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME)
+                val hasPhoneColumn = cursor.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER)
+                val photoUriColumn = cursor.getColumnIndex(ContactsContract.Contacts.PHOTO_URI)
+
+                val batchSize = 50
+                var contactsProcessed = 0
+
+                while (cursor.moveToNext()) {
+                    try {
+                        val id = if (idColumn != -1) cursor.getLong(idColumn) else 0
+                        val name = if (nameColumn != -1) cursor.getString(nameColumn) else ""
+                        val hasPhone = if (hasPhoneColumn != -1) cursor.getInt(hasPhoneColumn) > 0 else false
+
+                        val phoneNumbers = mutableListOf<String>()
+                        val emails = mutableListOf<String>()
+                        val addresses = mutableListOf<Contact.Address>()
+                        val websites = mutableListOf<String>()
+                        val socialProfiles = mutableListOf<Contact.SocialProfile>()
+                        val relationships = mutableListOf<Contact.Relationship>()
+                        var note: String? = null
+                        val groups = mutableListOf<String>()
+                        val events = mutableListOf<Contact.Event>()
+
+                        if (hasPhone) {
+                            val phoneUri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI
+                            val phoneProjection = arrayOf(
+                                ContactsContract.CommonDataKinds.Phone.NUMBER,
+                                ContactsContract.CommonDataKinds.Phone.TYPE
+                            )
+                            val phoneSelection = "${ContactsContract.CommonDataKinds.Phone.CONTACT_ID} = ?"
+                            val phoneSelectionArgs = arrayOf(id.toString())
+
+                            context.contentResolver.query(phoneUri, phoneProjection, phoneSelection, phoneSelectionArgs, null)?.use { phoneCursor ->
+                                val phoneNumberColumn = phoneCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER)
+
+                                while (phoneCursor.moveToNext()) {
+                                    val phoneNumber = if (phoneNumberColumn != -1) phoneCursor.getString(phoneNumberColumn) else ""
+                                    if (phoneNumber.isNotBlank()) {
+                                        phoneNumbers.add(phoneNumber)
+                                    }
+                                }
+                            }
+                        }
+
+                        val emailUri = ContactsContract.CommonDataKinds.Email.CONTENT_URI
+                        val emailProjection = arrayOf(
+                            ContactsContract.CommonDataKinds.Email.ADDRESS,
+                            ContactsContract.CommonDataKinds.Email.TYPE
+                        )
+                        val emailSelection = "${ContactsContract.CommonDataKinds.Email.CONTACT_ID} = ?"
+                        val emailSelectionArgs = arrayOf(id.toString())
+
+                        context.contentResolver.query(emailUri, emailProjection, emailSelection, emailSelectionArgs, null)?.use { emailCursor ->
+                            val emailAddressColumn = emailCursor.getColumnIndex(ContactsContract.CommonDataKinds.Email.ADDRESS)
+
+                            while (emailCursor.moveToNext()) {
+                                val emailAddress = if (emailAddressColumn != -1) emailCursor.getString(emailAddressColumn) else ""
+                                if (emailAddress.isNotBlank()) {
+                                    emails.add(emailAddress)
+                                }
+                            }
+                        }
+
+                        val addressUri = ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_URI
+                        val addressProjection = arrayOf(
+                            ContactsContract.CommonDataKinds.StructuredPostal.FORMATTED_ADDRESS,
+                            ContactsContract.CommonDataKinds.StructuredPostal.TYPE
+                        )
+                        val addressSelection = "${ContactsContract.CommonDataKinds.StructuredPostal.CONTACT_ID} = ?"
+                        val addressSelectionArgs = arrayOf(id.toString())
+
+                        context.contentResolver.query(addressUri, addressProjection, addressSelection, addressSelectionArgs, null)?.use { addressCursor ->
+                            val addressColumn = addressCursor.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.FORMATTED_ADDRESS)
+                            val addressTypeColumn = addressCursor.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.TYPE)
+
+                            while (addressCursor.moveToNext()) {
+                                val address = if (addressColumn != -1) addressCursor.getString(addressColumn) else ""
+                                val addressType = if (addressTypeColumn != -1) {
+                                    when (addressCursor.getInt(addressTypeColumn)) {
+                                        ContactsContract.CommonDataKinds.StructuredPostal.TYPE_HOME -> "家庭"
+                                        ContactsContract.CommonDataKinds.StructuredPostal.TYPE_WORK -> "工作"
+                                        else -> "其他"
+                                    }
+                                } else "其他"
+
+                                if (address.isNotBlank()) {
+                                    addresses.add(Contact.Address(addressType, address))
+                                }
+                            }
+                        }
+
+                        val noteUri = ContactsContract.Data.CONTENT_URI
+                        val noteProjection = arrayOf(
+                            ContactsContract.CommonDataKinds.Note.NOTE
+                        )
+                        val noteSelection = "${ContactsContract.Data.CONTACT_ID} = ? AND ${ContactsContract.Data.MIMETYPE} = ?"
+                        val noteSelectionArgs = arrayOf(
+                            id.toString(),
+                            ContactsContract.CommonDataKinds.Note.CONTENT_ITEM_TYPE
+                        )
+
+                        context.contentResolver.query(noteUri, noteProjection, noteSelection, noteSelectionArgs, null)?.use { noteCursor ->
+                            val noteColumn = noteCursor.getColumnIndex(ContactsContract.CommonDataKinds.Note.NOTE)
+
+                            if (noteCursor.moveToFirst()) {
+                                note = if (noteColumn != -1) noteCursor.getString(noteColumn) else null
+                            }
+                        }
+
+                        val websiteUri = ContactsContract.Data.CONTENT_URI
+                        val websiteProjection = arrayOf(
+                            ContactsContract.CommonDataKinds.Website.URL
+                        )
+                        val websiteSelection = "${ContactsContract.Data.CONTACT_ID} = ? AND ${ContactsContract.Data.MIMETYPE} = ?"
+                        val websiteSelectionArgs = arrayOf(
+                            id.toString(),
+                            ContactsContract.CommonDataKinds.Website.CONTENT_ITEM_TYPE
+                        )
+
+                        context.contentResolver.query(websiteUri, websiteProjection, websiteSelection, websiteSelectionArgs, null)?.use { websiteCursor ->
+                            val urlColumn = websiteCursor.getColumnIndex(ContactsContract.CommonDataKinds.Website.URL)
+
+                            while (websiteCursor.moveToNext()) {
+                                val url = if (urlColumn != -1) websiteCursor.getString(urlColumn) else ""
+                                if (url.isNotBlank()) {
+                                    websites.add(url)
+                                }
+                            }
+                        }
+
+                        val eventUri = ContactsContract.Data.CONTENT_URI
+                        val eventProjection = arrayOf(
+                            ContactsContract.CommonDataKinds.Event.START_DATE,
+                            ContactsContract.CommonDataKinds.Event.TYPE
+                        )
+                        val eventSelection = "${ContactsContract.Data.CONTACT_ID} = ? AND ${ContactsContract.Data.MIMETYPE} = ?"
+                        val eventSelectionArgs = arrayOf(
+                            id.toString(),
+                            ContactsContract.CommonDataKinds.Event.CONTENT_ITEM_TYPE
+                        )
+
+                        context.contentResolver.query(eventUri, eventProjection, eventSelection, eventSelectionArgs, null)?.use { eventCursor ->
+                            val dateColumn = eventCursor.getColumnIndex(ContactsContract.CommonDataKinds.Event.START_DATE)
+                            val typeColumn = eventCursor.getColumnIndex(ContactsContract.CommonDataKinds.Event.TYPE)
+
+                            while (eventCursor.moveToNext()) {
+                                val date = if (dateColumn != -1) eventCursor.getString(dateColumn) else ""
+                                val type = if (typeColumn != -1) {
+                                    when (eventCursor.getInt(typeColumn)) {
+                                        ContactsContract.CommonDataKinds.Event.TYPE_BIRTHDAY -> "生日"
+                                        ContactsContract.CommonDataKinds.Event.TYPE_ANNIVERSARY -> "纪念日"
+                                        else -> "其他"
+                                    }
+                                } else "其他"
+
+                                if (date.isNotBlank()) {
+                                    events.add(Contact.Event(type, date))
+                                }
+                            }
+                        }
+
+                        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                            val groupUri = ContactsContract.Data.CONTENT_URI
+                            val groupProjection = arrayOf(
+                                ContactsContract.CommonDataKinds.GroupMembership.GROUP_ROW_ID
+                            )
+                            val groupSelection = "${ContactsContract.Data.CONTACT_ID} = ? AND ${ContactsContract.Data.MIMETYPE} = ?"
+                            val groupSelectionArgs = arrayOf(
+                                id.toString(),
+                                ContactsContract.CommonDataKinds.GroupMembership.CONTENT_ITEM_TYPE
+                            )
+
+                            context.contentResolver.query(groupUri, groupProjection, groupSelection, groupSelectionArgs, null)?.use { groupCursor ->
+                                val groupIdColumn = groupCursor.getColumnIndex(ContactsContract.CommonDataKinds.GroupMembership.GROUP_ROW_ID)
+
+                                while (groupCursor.moveToNext()) {
+                                    val groupId = if (groupIdColumn != -1) groupCursor.getLong(groupIdColumn) else -1
+
+                                    if (groupId != -1L) {
+                                        val groupNameUri = ContactsContract.Groups.CONTENT_URI
+                                        val groupNameProjection = arrayOf(
+                                            ContactsContract.Groups.TITLE
+                                        )
+                                        val groupNameSelection = "${ContactsContract.Groups._ID} = ?"
+                                        val groupNameSelectionArgs = arrayOf(groupId.toString())
+
+                                        context.contentResolver.query(groupNameUri, groupNameProjection, groupNameSelection, groupNameSelectionArgs, null)?.use { groupNameCursor ->
+                                            val groupNameColumn = groupNameCursor.getColumnIndex(ContactsContract.Groups.TITLE)
+
+                                            if (groupNameCursor.moveToFirst()) {
+                                                val groupName = if (groupNameColumn != -1) groupNameCursor.getString(groupNameColumn) else ""
+                                                if (groupName.isNotBlank()) {
+                                                    groups.add(groupName)
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+
+                        val relationUri = ContactsContract.Data.CONTENT_URI
+                        val relationProjection = arrayOf(
+                            ContactsContract.CommonDataKinds.Relation.NAME,
+                            ContactsContract.CommonDataKinds.Relation.TYPE
+                        )
+                        val relationSelection = "${ContactsContract.Data.CONTACT_ID} = ? AND ${ContactsContract.Data.MIMETYPE} = ?"
+                        val relationSelectionArgs = arrayOf(
+                            id.toString(),
+                            ContactsContract.CommonDataKinds.Relation.CONTENT_ITEM_TYPE
+                        )
+
+                        context.contentResolver.query(relationUri, relationProjection, relationSelection, relationSelectionArgs, null)?.use { relationCursor ->
+                            val nameColumn = relationCursor.getColumnIndex(ContactsContract.CommonDataKinds.Relation.NAME)
+                            val typeColumn = relationCursor.getColumnIndex(ContactsContract.CommonDataKinds.Relation.TYPE)
+
+                            while (relationCursor.moveToNext()) {
+                                val relName = if (nameColumn != -1) relationCursor.getString(nameColumn) else ""
+                                val relType = if (typeColumn != -1) {
+                                    when (relationCursor.getInt(typeColumn)) {
+                                        ContactsContract.CommonDataKinds.Relation.TYPE_SPOUSE -> "配偶"
+                                        ContactsContract.CommonDataKinds.Relation.TYPE_CHILD -> "子女"
+                                        ContactsContract.CommonDataKinds.Relation.TYPE_PARENT -> "父母"
+                                        else -> "其他"
+                                    }
+                                } else "其他"
+
+                                if (relName.isNotBlank()) {
+                                    relationships.add(Contact.Relationship(relType, relName))
+                                }
+                            }
+                        }
+
+                        val socialUri = ContactsContract.Data.CONTENT_URI
+                        val socialProjection = arrayOf(
+                            ContactsContract.Data.MIMETYPE,
+                            ContactsContract.Data.DATA1
+                        )
+                        val socialSelection = "${ContactsContract.Data.CONTACT_ID} = ? AND ${ContactsContract.Data.MIMETYPE} IN (?, ?, ?)"
+                        val socialSelectionArgs = arrayOf(
+                            id.toString(),
+                            "vnd.android.cursor.item/com.whatsapp.profile",
+                            "vnd.android.cursor.item/com.facebook.profile",
+                            "vnd.android.cursor.item/com.twitter.android.profile"
+                        )
+
+                        context.contentResolver.query(socialUri, socialProjection, socialSelection, socialSelectionArgs, null)?.use { socialCursor ->
+                            val mimeTypeColumn = socialCursor.getColumnIndex(ContactsContract.Data.MIMETYPE)
+                            val data1Column = socialCursor.getColumnIndex(ContactsContract.Data.DATA1)
+
+                            while (socialCursor.moveToNext()) {
+                                val mimeType = if (mimeTypeColumn != -1) socialCursor.getString(mimeTypeColumn) else ""
+                                val data = if (data1Column != -1) socialCursor.getString(data1Column) else ""
+
+                                if (data.isNotBlank()) {
+                                    val socialType = when {
+                                        mimeType.contains("whatsapp") -> "WhatsApp"
+                                        mimeType.contains("facebook") -> "Facebook"
+                                        mimeType.contains("twitter") -> "Twitter"
+                                        else -> "其他"
+                                    }
+
+                                    socialProfiles.add(Contact.SocialProfile(socialType, data))
+                                }
+                            }
+                        }
+
+                        if (name.isNotBlank() || phoneNumbers.isNotEmpty() || emails.isNotEmpty()) {
+                            val contact = Contact(
+                                id = id,
+                                name = name,
+                                phoneNumbers = phoneNumbers,
+                                emails = if (emails.isNotEmpty()) emails else null,
+                                addresses = if (addresses.isNotEmpty()) addresses else null,
+                                note = note,
+                                groups = if (groups.isNotEmpty()) groups else null,
+                                websites = if (websites.isNotEmpty()) websites else null,
+                                events = if (events.isNotEmpty()) events else null,
+                                relationships = if (relationships.isNotEmpty()) relationships else null,
+                                socialProfiles = if (socialProfiles.isNotEmpty()) socialProfiles else null
+                            )
+                            contacts.add(contact)
+                        }
+
+                        contactsProcessed++
+                        if (contactsProcessed % batchSize == 0) {
+                            Timber.d("[Mobile] DEBUG [Backup] 已处理 $contactsProcessed/${cursor.count} 个联系人")
+                        }
+
+                    } catch (e: Exception) {
+                        Timber.e(e, "[Mobile] ERROR [Backup] 处理单个联系人时出错: ${e.message}")
+                    }
+                }
+            } ?: run {
+                Timber.e("[Mobile] ERROR [Backup] 备份联系人失败: 无法查询联系人内容提供者")
+                return null
+            }
+
+            Timber.i("[Mobile] INFO [Backup] 成功读取 ${contacts.size} 个联系人")
+
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Backup] 备份联系人异常: ${e.message}")
+            return null
+        }
+
+        return contacts
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidContactWriter.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidContactWriter.kt
new file mode 100644
index 0000000..d6c8bad
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidContactWriter.kt
@@ -0,0 +1,85 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.ContentProviderOperation
+import android.content.ContentResolver
+import android.content.Context
+import android.provider.ContactsContract
+import com.iskenkenya.commory.sdk.backup.model.ContactData
+import com.iskenkenya.commory.sdk.backup.writer.ContactWriter
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import timber.log.Timber
+
+class AndroidContactWriter(
+    private val context: Context
+) : ContactWriter {
+
+    private val contentResolver: ContentResolver = context.contentResolver
+
+    override suspend fun write(contacts: List<ContactData>): Int = withContext(Dispatchers.IO) {
+        var restoredCount = 0
+        val totalCount = contacts.size
+        Timber.i("[Mobile] INFO [Restore] Starting contact restore, total: $totalCount")
+
+        if (!hasContactsPermissions()) {
+            Timber.e("[Mobile] ERROR [Restore] Missing contacts permissions")
+            return@withContext 0
+        }
+
+        contacts.forEachIndexed { index, contact ->
+            try {
+                val operations = ArrayList<ContentProviderOperation>()
+
+                val rawContactInsertIndex = operations.size
+                operations.add(ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
+                    .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, null)
+                    .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, null)
+                    .build())
+
+                operations.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
+                    .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, rawContactInsertIndex)
+                    .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)
+                    .withValue(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, contact.name)
+                    .build())
+
+                contact.phoneNumbers.forEach { phoneNumber ->
+                    operations.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
+                        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, rawContactInsertIndex)
+                        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)
+                        .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phoneNumber)
+                        .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE)
+                        .build())
+                }
+
+                try {
+                    val results = contentResolver.applyBatch(ContactsContract.AUTHORITY, operations)
+                    if (results.isNotEmpty()) {
+                        restoredCount++
+                    }
+                } catch (e: Exception) {
+                    Timber.e(e, "[Mobile] ERROR [Restore] Failed to restore contact: batch operation exception: ${e.message}")
+                }
+            } catch (e: Exception) {
+                Timber.e(e, "[Mobile] ERROR [Restore] Failed to restore contact: ID=${contact.id}, name=${contact.name}, ${e.message}")
+            }
+        }
+
+        Timber.i("[Mobile] INFO [Restore] Contact restore complete: success=$restoredCount, total=$totalCount")
+        restoredCount
+    }
+
+    private fun hasContactsPermissions(): Boolean {
+        val readPermission = android.Manifest.permission.READ_CONTACTS
+        val writePermission = android.Manifest.permission.WRITE_CONTACTS
+
+        val readGranted = context.checkSelfPermission(readPermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        val writeGranted = context.checkSelfPermission(writePermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
+
+        if (!readGranted || !writeGranted) {
+            Timber.e("[Mobile] ERROR [Restore] Missing contacts permissions: READ_CONTACTS=$readGranted, WRITE_CONTACTS=$writeGranted")
+            return false
+        }
+
+        return true
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidSmsReader.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidSmsReader.kt
new file mode 100644
index 0000000..35c9875
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidSmsReader.kt
@@ -0,0 +1,101 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.Context
+import android.content.ContentResolver
+import android.content.pm.PackageManager
+import android.provider.Telephony
+import com.iskenkenya.commory.mobile.utils.PhoneNumberUtils
+import com.iskenkenya.commory.sdk.backup.model.Message
+import com.iskenkenya.commory.sdk.backup.reader.SmsReader
+import timber.log.Timber
+
+class AndroidSmsReader(
+    private val context: Context,
+    private val contentResolver: ContentResolver = context.contentResolver,
+    private val hasPermission: (String) -> Boolean = { permission ->
+        context.checkSelfPermission(permission) == PackageManager.PERMISSION_GRANTED
+    }
+) : SmsReader {
+
+    override suspend fun readSms(): List<Message>? {
+        val messages = mutableListOf<Message>()
+
+        try {
+            if (!hasPermission(android.Manifest.permission.READ_SMS)) {
+                Timber.e("[Mobile] ERROR [Backup] 备份短信失败: 没有 READ_SMS 权限")
+                return null
+            }
+
+            Timber.d("[Mobile] DEBUG [Backup] 开始读取短信...")
+
+            val uri = Telephony.Sms.CONTENT_URI
+            val projection = arrayOf(
+                Telephony.Sms._ID,
+                Telephony.Sms.ADDRESS,
+                Telephony.Sms.BODY,
+                Telephony.Sms.DATE,
+                Telephony.Sms.TYPE,
+                Telephony.Sms.READ,
+                Telephony.Sms.STATUS
+            )
+            val sortOrder = "${Telephony.Sms.DATE} DESC"
+
+            contentResolver.query(uri, projection, null, null, sortOrder)?.use { cursor ->
+                Timber.d("[Mobile] DEBUG [Backup] 找到 ${cursor.count} 条短信")
+
+                val idColumn = cursor.getColumnIndex(Telephony.Sms._ID)
+                val addressColumn = cursor.getColumnIndex(Telephony.Sms.ADDRESS)
+                val bodyColumn = cursor.getColumnIndex(Telephony.Sms.BODY)
+                val dateColumn = cursor.getColumnIndex(Telephony.Sms.DATE)
+                val typeColumn = cursor.getColumnIndex(Telephony.Sms.TYPE)
+                val readColumn = cursor.getColumnIndex(Telephony.Sms.READ)
+                val statusColumn = cursor.getColumnIndex(Telephony.Sms.STATUS)
+
+                while (cursor.moveToNext()) {
+                    val id = if (idColumn != -1) cursor.getLong(idColumn) else 0
+
+                    val originalAddress = if (addressColumn != -1) cursor.getString(addressColumn) else ""
+
+                    val normalizedAddress = if (originalAddress.isNotBlank()) {
+                        val normalized = PhoneNumberUtils.normalizePhoneNumber(originalAddress)
+                        if (normalized != originalAddress) {
+                            Timber.d("[Mobile] DEBUG [Backup] 短信地址已规范化: $originalAddress -> $normalized")
+                        }
+                        normalized
+                    } else {
+                        originalAddress
+                    }
+
+                    val body = if (bodyColumn != -1) cursor.getString(bodyColumn) else ""
+                    val date = if (dateColumn != -1) cursor.getLong(dateColumn) else 0
+                    val type = if (typeColumn != -1) cursor.getInt(typeColumn) else 0
+                    val read = if (readColumn != -1) cursor.getInt(readColumn) else 0
+                    val status = if (statusColumn != -1) cursor.getInt(statusColumn) else 0
+
+                    val message = Message(
+                        id = id,
+                        address = normalizedAddress,
+                        body = body,
+                        date = date,
+                        type = type,
+                        readState = read,
+                        messageStatus = status
+                    )
+
+                    messages.add(message)
+                }
+            } ?: run {
+                Timber.e("[Mobile] ERROR [Backup] 备份短信失败: 无法查询短信内容提供者")
+                return null
+            }
+
+            Timber.i("[Mobile] INFO [Backup] 成功读取 ${messages.size} 条短信")
+
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Backup] 备份短信异常: ${e.message}")
+            return null
+        }
+
+        return messages
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidSmsWriter.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidSmsWriter.kt
new file mode 100644
index 0000000..068f695
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/AndroidSmsWriter.kt
@@ -0,0 +1,107 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.content.ContentValues
+import android.content.Context
+import android.provider.Telephony
+import com.iskenkenya.commory.sdk.backup.model.SmsData
+import com.iskenkenya.commory.sdk.backup.writer.SmsWriter
+import kotlinx.coroutines.delay
+import timber.log.Timber
+
+class AndroidSmsWriter(private val context: Context) : SmsWriter {
+
+    override suspend fun write(messages: List<SmsData>): Int {
+        var restoredCount = 0
+        val totalCount = messages.size
+        Timber.i("[Mobile] INFO [Restore] 开始恢复短信，总数: $totalCount")
+
+        val fixedMessages = validateAndFixMessageAddresses(messages)
+        val messagesByContact = fixedMessages.groupBy { it.address }
+
+        var processedCount = 0
+
+        for ((address, contactMessages) in messagesByContact) {
+            Timber.d("[Mobile] DEBUG [Restore] 处理联系人消息: 联系人=$address, 消息数量=${contactMessages.size}")
+
+            val sortedMessages = contactMessages.sortedBy { it.date }
+
+            for (smsMessage in sortedMessages) {
+                try {
+                    val values = ContentValues().apply {
+                        put(Telephony.Sms.ADDRESS, smsMessage.address)
+                        put(Telephony.Sms.BODY, smsMessage.body)
+                        put(Telephony.Sms.DATE, smsMessage.date)
+                        put(Telephony.Sms.TYPE, smsMessage.type)
+                        put(Telephony.Sms.READ, smsMessage.readState ?: 0)
+                        put(Telephony.Sms.STATUS, smsMessage.messageStatus ?: 0)
+
+                        if (smsMessage.threadId > 0) {
+                            put(Telephony.Sms.THREAD_ID, smsMessage.threadId)
+                        }
+                    }
+
+                    val uri = context.contentResolver.insert(Telephony.Sms.CONTENT_URI, values)
+                    if (uri != null) {
+                        restoredCount++
+                    }
+
+                    processedCount++
+
+                    if (processedCount % 10 == 0) {
+                        delay(50)
+                    }
+                } catch (e: Exception) {
+                    Timber.e(e, "[Mobile] ERROR [Restore] 恢复短信失败: 地址=${smsMessage.address}, ${e.message}")
+                }
+            }
+
+            delay(100)
+        }
+
+        Timber.i("[Mobile] INFO [Restore] 短信恢复完成: 成功=$restoredCount, 总数=$totalCount")
+        return restoredCount
+    }
+
+    private fun validateAndFixMessageAddresses(messages: List<SmsData>): List<SmsData> {
+        Timber.d("[Mobile] DEBUG [Restore] 开始验证和修复短信地址，数量: ${messages.size}")
+
+        val emptyAddressCount = messages.count { it.address.isNullOrBlank() }
+        if (emptyAddressCount > 0) {
+            Timber.w("[Mobile] WARN [Restore] 发现 $emptyAddressCount 条短信缺少有效地址，将进行修复")
+        }
+
+        return messages.map { originalMessage ->
+            if (originalMessage.address.isNullOrBlank()) {
+                SmsData(
+                    id = originalMessage.id,
+                    address = "unknown_${originalMessage.id}",
+                    body = originalMessage.body,
+                    date = originalMessage.date,
+                    type = originalMessage.type,
+                    readState = originalMessage.readState,
+                    messageStatus = originalMessage.messageStatus,
+                    threadId = originalMessage.threadId
+                )
+            } else {
+                val normalizedAddress = com.iskenkenya.commory.mobile.utils.PhoneNumberUtils.normalizePhoneNumber(originalMessage.address)
+
+                if (normalizedAddress != originalMessage.address) {
+                    Timber.d("[Mobile] DEBUG [Restore] 标准化地址: ${originalMessage.address} -> $normalizedAddress")
+
+                    SmsData(
+                        id = originalMessage.id,
+                        address = normalizedAddress,
+                        body = originalMessage.body,
+                        date = originalMessage.date,
+                        type = originalMessage.type,
+                        readState = originalMessage.readState,
+                        messageStatus = originalMessage.messageStatus,
+                        threadId = originalMessage.threadId
+                    )
+                } else {
+                    originalMessage
+                }
+            }
+        }
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/RestorePermissionHelper.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/RestorePermissionHelper.kt
new file mode 100644
index 0000000..a67f878
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/data/backup/RestorePermissionHelper.kt
@@ -0,0 +1,174 @@
+package com.iskenkenya.commory.mobile.data.backup
+
+import android.app.Activity
+import android.content.Context
+import android.content.Intent
+import android.net.Uri
+import android.os.Build
+import android.provider.Settings
+import android.provider.Telephony
+import android.widget.Toast
+import androidx.activity.result.ActivityResultLauncher
+import timber.log.Timber
+
+object RestorePermissionHelper {
+
+    fun isDefaultSmsApp(context: Context): Boolean {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            try {
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                    try {
+                        val roleManager = context.getSystemService(Context.ROLE_SERVICE) as? android.app.role.RoleManager
+                        if (roleManager != null && roleManager.isRoleHeld(android.app.role.RoleManager.ROLE_SMS)) {
+                            return true
+                        }
+                    } catch (_: Exception) {
+                    }
+                }
+                val defaultSmsPackage = Telephony.Sms.getDefaultSmsPackage(context)
+                return defaultSmsPackage == context.packageName
+            } catch (_: Exception) {
+                return false
+            }
+        }
+        return true
+    }
+
+    fun requestDefaultSmsApp(activity: Activity, launcher: ActivityResultLauncher<Intent>) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            try {
+                var requestSent = false
+
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                    try {
+                        val roleManager = activity.getSystemService(Context.ROLE_SERVICE) as? android.app.role.RoleManager
+                        if (roleManager != null && roleManager.isRoleAvailable(android.app.role.RoleManager.ROLE_SMS)) {
+                            if (!roleManager.isRoleHeld(android.app.role.RoleManager.ROLE_SMS)) {
+                                val roleRequestIntent = roleManager.createRequestRoleIntent(android.app.role.RoleManager.ROLE_SMS)
+                                launcher.launch(roleRequestIntent)
+                                requestSent = true
+                            } else {
+                                return
+                            }
+                        }
+                    } catch (_: Exception) {
+                    }
+                }
+
+                if (!requestSent) {
+                    val intent = Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT)
+                    intent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME, activity.packageName)
+                    if (intent.resolveActivity(activity.packageManager) != null) {
+                        launcher.launch(intent)
+                        requestSent = true
+                    }
+                }
+
+                if (!requestSent) {
+                    try {
+                        val defaultAppsIntent = Intent(Settings.ACTION_MANAGE_DEFAULT_APPS_SETTINGS)
+                        if (defaultAppsIntent.resolveActivity(activity.packageManager) != null) {
+                            activity.startActivity(defaultAppsIntent)
+                            Toast.makeText(activity, "请在默认应用设置中将本应用设为默认短信应用", Toast.LENGTH_LONG).show()
+                            requestSent = true
+                        }
+                    } catch (_: Exception) {
+                    }
+
+                    if (!requestSent) {
+                        try {
+                            val settingsIntent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
+                            settingsIntent.data = Uri.parse("package:" + activity.packageName)
+                            activity.startActivity(settingsIntent)
+                            Toast.makeText(activity, "请在应用设置中授予短信相关权限，然后设置为默认短信应用", Toast.LENGTH_LONG).show()
+                        } catch (_: Exception) {
+                            try {
+                                val mainSettingsIntent = Intent(Settings.ACTION_SETTINGS)
+                                activity.startActivity(mainSettingsIntent)
+                                Toast.makeText(activity, "请在系统设置中找到应用管理，将本应用设为默认短信应用", Toast.LENGTH_LONG).show()
+                            } catch (_: Exception) {
+                                Toast.makeText(activity, "无法自动打开设置，请手动将本应用设为默认短信应用", Toast.LENGTH_LONG).show()
+                            }
+                        }
+                    }
+                }
+            } catch (e: Exception) {
+                Timber.e(e, "[Mobile] ERROR [Restore] Failed to request default SMS app: ${e.message}")
+                Toast.makeText(activity, "无法请求默认短信应用权限: ${e.message}", Toast.LENGTH_LONG).show()
+            }
+        }
+    }
+
+    fun checkAndRequestPermissions(activity: Activity, requestCode: Int): Boolean {
+        val requiredPermissions = mutableListOf<String>()
+
+        if (!hasSmsPermissions(activity)) {
+            requiredPermissions.add(android.Manifest.permission.READ_SMS)
+            requiredPermissions.add(android.Manifest.permission.SEND_SMS)
+            requiredPermissions.add(android.Manifest.permission.RECEIVE_SMS)
+        }
+
+        if (!hasCallLogPermissions(activity)) {
+            requiredPermissions.add(android.Manifest.permission.READ_CALL_LOG)
+            requiredPermissions.add(android.Manifest.permission.WRITE_CALL_LOG)
+        }
+
+        if (!hasContactsPermissions(activity)) {
+            requiredPermissions.add(android.Manifest.permission.READ_CONTACTS)
+            requiredPermissions.add(android.Manifest.permission.WRITE_CONTACTS)
+        }
+
+        if (requiredPermissions.isNotEmpty()) {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+                val specialPermissions = mutableListOf<String>()
+                val normalPermissions = mutableListOf<String>()
+
+                for (permission in requiredPermissions) {
+                    if (permission == android.Manifest.permission.READ_SMS ||
+                        permission == android.Manifest.permission.READ_CALL_LOG ||
+                        permission == android.Manifest.permission.WRITE_CALL_LOG) {
+                        specialPermissions.add(permission)
+                    } else {
+                        normalPermissions.add(permission)
+                    }
+                }
+
+                if (normalPermissions.isNotEmpty()) {
+                    activity.requestPermissions(normalPermissions.toTypedArray(), requestCode)
+                }
+
+                if (specialPermissions.isNotEmpty()) {
+                    try {
+                        val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
+                        intent.data = Uri.parse("package:" + activity.packageName)
+                        activity.startActivity(intent)
+                    } catch (_: Exception) {
+                    }
+                }
+            } else {
+                activity.requestPermissions(requiredPermissions.toTypedArray(), requestCode)
+            }
+            return false
+        }
+
+        return true
+    }
+
+    fun hasSmsPermissions(context: Context): Boolean {
+        val readGranted = context.checkSelfPermission(android.Manifest.permission.READ_SMS) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        val sendGranted = context.checkSelfPermission(android.Manifest.permission.SEND_SMS) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        return readGranted && sendGranted
+    }
+
+    fun hasCallLogPermissions(context: Context): Boolean {
+        val readGranted = context.checkSelfPermission(android.Manifest.permission.READ_CALL_LOG) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        val writeGranted = context.checkSelfPermission(android.Manifest.permission.WRITE_CALL_LOG) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        return readGranted && writeGranted
+    }
+
+    fun hasContactsPermissions(context: Context): Boolean {
+        val readGranted = context.checkSelfPermission(android.Manifest.permission.READ_CONTACTS) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        val writeGranted = context.checkSelfPermission(android.Manifest.permission.WRITE_CONTACTS) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        return readGranted && writeGranted
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/di/AppContainer.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/di/AppContainer.kt
new file mode 100644
index 0000000..6f2dcf7
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/di/AppContainer.kt
@@ -0,0 +1,38 @@
+package com.iskenkenya.commory.mobile.di
+
+import android.content.Context
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsWriter
+import com.iskenkenya.commory.mobile.remote.CommoryServerClient
+import com.iskenkenya.commory.mobile.runtime.AppEnvironmentManager
+import com.iskenkenya.commory.sdk.backup.BackupManager
+import com.iskenkenya.commory.sdk.backup.RestoreManager
+
+class AppContainer(private val context: Context) {
+    val environmentManager: AppEnvironmentManager by lazy { AppEnvironmentManager(context) }
+    val serverClient: CommoryServerClient by lazy { CommoryServerClient(context, environmentManager) }
+
+    fun createBackupManager(): BackupManager = BackupManager(
+        smsReader = AndroidSmsReader(context),
+        callLogReader = AndroidCallLogReader(context),
+        contactReader = AndroidContactReader(context),
+        backupFileWriter = AndroidBackupFileWriter(context),
+        backupFileReader = AndroidBackupFileReader(context),
+        smsWriter = AndroidSmsWriter(context),
+        callLogWriter = AndroidCallLogWriter(context),
+        contactWriter = AndroidContactWriter(context)
+    )
+
+    fun createRestoreManager(): RestoreManager = RestoreManager(
+        backupFileReader = AndroidBackupFileReader(context),
+        smsWriter = AndroidSmsWriter(context),
+        callLogWriter = AndroidCallLogWriter(context),
+        contactWriter = AndroidContactWriter(context)
+    )
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/model/BackupData.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/BackupData.kt
new file mode 100644
index 0000000..da2cc0c
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/BackupData.kt
@@ -0,0 +1,3 @@
+package com.iskenkenya.commory.mobile.model
+
+typealias BackupData = com.iskenkenya.commory.sdk.backup.model.BackupData
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/model/BackupResult.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/BackupResult.kt
new file mode 100644
index 0000000..bc28248
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/BackupResult.kt
@@ -0,0 +1,3 @@
+package com.iskenkenya.commory.mobile.model
+
+typealias BackupResult = com.iskenkenya.commory.sdk.backup.model.BackupResult
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/model/CallLog.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/CallLog.kt
new file mode 100644
index 0000000..286f5f4
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/CallLog.kt
@@ -0,0 +1,3 @@
+package com.iskenkenya.commory.mobile.model
+
+typealias CallLog = com.iskenkenya.commory.sdk.backup.model.CallLog
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/model/Contact.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/Contact.kt
new file mode 100644
index 0000000..caf398e
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/Contact.kt
@@ -0,0 +1,3 @@
+package com.iskenkenya.commory.mobile.model
+
+typealias Contact = com.iskenkenya.commory.sdk.backup.model.Contact
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/model/Message.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/Message.kt
new file mode 100644
index 0000000..144e135
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/Message.kt
@@ -0,0 +1,3 @@
+package com.iskenkenya.commory.mobile.model
+
+typealias Message = com.iskenkenya.commory.sdk.backup.model.Message
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/model/UploadResult.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/UploadResult.kt
new file mode 100644
index 0000000..67af0aa
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/model/UploadResult.kt
@@ -0,0 +1,3 @@
+package com.iskenkenya.commory.mobile.model
+
+typealias UploadResult = com.iskenkenya.commory.sdk.backup.model.UploadResult
diff --git a/android/app/src/main/java/imken/messagevault/mobile/models/BackupFile.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/BackupFile.kt
similarity index 91%
rename from android/app/src/main/java/imken/messagevault/mobile/models/BackupFile.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/models/BackupFile.kt
index b070aee..d8a9c92 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/models/BackupFile.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/BackupFile.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.models
+package com.iskenkenya.commory.mobile.models
 
 import java.util.Date
 
diff --git a/android/app/src/main/java/imken/messagevault/mobile/models/BackupState.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/BackupState.kt
similarity index 87%
rename from android/app/src/main/java/imken/messagevault/mobile/models/BackupState.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/models/BackupState.kt
index ad1a774..e70fc8d 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/models/BackupState.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/BackupState.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.models
+package com.iskenkenya.commory.mobile.models
 
 sealed class BackupState {
     object Initial : BackupState()
diff --git a/android/app/src/main/java/imken/messagevault/mobile/models/CallLogData.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/CallLogData.kt
similarity index 80%
rename from android/app/src/main/java/imken/messagevault/mobile/models/CallLogData.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/models/CallLogData.kt
index 118877d..8ae5639 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/models/CallLogData.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/CallLogData.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.models
+package com.iskenkenya.commory.mobile.models
 
 /**
  * 通话记录数据模型
diff --git a/android/app/src/main/java/imken/messagevault/mobile/models/ContactData.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/ContactData.kt
similarity index 74%
rename from android/app/src/main/java/imken/messagevault/mobile/models/ContactData.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/models/ContactData.kt
index 81bc2b8..23f13d3 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/models/ContactData.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/ContactData.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.models
+package com.iskenkenya.commory.mobile.models
 
 data class ContactData(
     val id: Long,
diff --git a/android/app/src/main/java/imken/messagevault/mobile/models/MessageData.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/MessageData.kt
similarity index 88%
rename from android/app/src/main/java/imken/messagevault/mobile/models/MessageData.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/models/MessageData.kt
index acf9fe7..dc53e28 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/models/MessageData.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/MessageData.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.models
+package com.iskenkenya.commory.mobile.models
 
 import androidx.annotation.Nullable
 
diff --git a/android/app/src/main/java/imken/messagevault/mobile/models/RestoreState.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/RestoreState.kt
similarity index 87%
rename from android/app/src/main/java/imken/messagevault/mobile/models/RestoreState.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/models/RestoreState.kt
index a56d024..e7f7dbf 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/models/RestoreState.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/RestoreState.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.models
+package com.iskenkenya.commory.mobile.models
 
 sealed class RestoreState {
     object Idle : RestoreState()
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/models/UiState.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/UiState.kt
new file mode 100644
index 0000000..b2a7d01
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/models/UiState.kt
@@ -0,0 +1,5 @@
+package com.iskenkenya.commory.mobile.models
+
+import androidx.compose.runtime.MutableState
+
+interface UiState<T> : MutableState<T>
diff --git a/android/app/src/main/java/imken/messagevault/mobile/network/ApiClient.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/network/ApiClient.kt
similarity index 95%
rename from android/app/src/main/java/imken/messagevault/mobile/network/ApiClient.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/network/ApiClient.kt
index 3587112..ab2b4db 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/network/ApiClient.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/network/ApiClient.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.network
+package com.iskenkenya.commory.mobile.network
 
 import android.content.Context
 import java.io.File
diff --git a/android/app/src/main/java/imken/messagevault/mobile/receiver/MmsReceiver.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/receiver/MmsReceiver.kt
similarity index 94%
rename from android/app/src/main/java/imken/messagevault/mobile/receiver/MmsReceiver.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/receiver/MmsReceiver.kt
index 9249a16..a60889f 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/receiver/MmsReceiver.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/receiver/MmsReceiver.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.receiver
+package com.iskenkenya.commory.mobile.receiver
 
 import android.content.BroadcastReceiver
 import android.content.Context
diff --git a/android/app/src/main/java/imken/messagevault/mobile/receiver/SmsReceiver.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/receiver/SmsReceiver.kt
similarity index 95%
rename from android/app/src/main/java/imken/messagevault/mobile/receiver/SmsReceiver.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/receiver/SmsReceiver.kt
index c86a89d..aff09a7 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/receiver/SmsReceiver.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/receiver/SmsReceiver.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.receiver
+package com.iskenkenya.commory.mobile.receiver
 
 import android.content.BroadcastReceiver
 import android.content.Context
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryApiService.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryApiService.kt
new file mode 100644
index 0000000..057fc46
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryApiService.kt
@@ -0,0 +1,115 @@
+package com.iskenkenya.commory.mobile.remote
+
+import okhttp3.RequestBody
+import okhttp3.ResponseBody
+import retrofit2.Response
+import retrofit2.http.Body
+import retrofit2.http.GET
+import retrofit2.http.Header
+import retrofit2.http.POST
+import retrofit2.http.Path
+import retrofit2.http.Streaming
+
+data class ApiEnvelope<T>(
+    val code: Int,
+    val msg: String,
+    val data: T?
+)
+
+data class SetupStatusDto(
+    val status: Boolean? = null,
+    val initialized: Boolean? = null,
+    val version: String? = null,
+    val database_type: String? = null,
+    val databaseType: String? = null,
+    val root_init: Boolean? = null,
+    val rootInit: Boolean? = null
+)
+
+data class UserDto(
+    val id: String,
+    val user_name: String? = null,
+    val userName: String? = null,
+    val email: String? = null,
+    val roles: List<String> = emptyList()
+)
+
+data class TokenPairDto(
+    val accessToken: String? = null,
+    val token: String? = null
+)
+
+data class AuthResponseDto(
+    val user: UserDto,
+    val token: String
+)
+
+data class RegisterRequestDto(
+    val userName: String,
+    val email: String,
+    val password: String
+)
+
+data class LoginRequestDto(
+    val userName: String,
+    val password: String
+)
+
+data class ImportSummaryDto(
+    val id: String,
+    val user_id: String? = null,
+    val userId: String? = null,
+    val schema_version: String? = null,
+    val schemaVersion: String? = null,
+    val imported_at: String? = null,
+    val importedAt: String? = null,
+    val source_path: String? = null,
+    val sourcePath: String? = null,
+    val event_count: Int? = null,
+    val eventCount: Int? = null,
+    val identity_count: Int? = null,
+    val identityCount: Int? = null
+)
+
+data class ImportUploadResponseDto(
+    val import_id: String? = null,
+    val importId: String? = null,
+    val msglayer_version: String? = null,
+    val msglayerVersion: String? = null
+)
+
+interface CommoryApiService {
+    @GET("api/setup")
+    suspend fun getSetupStatus(): Response<ApiEnvelope<SetupStatusDto>>
+
+    @POST("api/auth/register")
+    suspend fun register(@Body request: RegisterRequestDto): Response<ApiEnvelope<AuthResponseDto>>
+
+    @POST("api/auth/login")
+    suspend fun login(@Body request: LoginRequestDto): Response<ApiEnvelope<AuthResponseDto>>
+
+    @POST("api/auth/refresh")
+    suspend fun refresh(): Response<ApiEnvelope<TokenPairDto>>
+
+    @POST("api/auth/logout")
+    suspend fun logout(): Response<ApiEnvelope<Map<String, Boolean>>>
+
+    @GET("api/user/info")
+    suspend fun getUserInfo(@Header("Authorization") authorization: String): Response<ApiEnvelope<UserDto>>
+
+    @GET("api/imports")
+    suspend fun listImports(@Header("Authorization") authorization: String): Response<ApiEnvelope<List<ImportSummaryDto>>>
+
+    @POST("api/imports/upload")
+    suspend fun uploadImport(
+        @Header("Authorization") authorization: String,
+        @Body requestBody: RequestBody
+    ): Response<ApiEnvelope<ImportUploadResponseDto>>
+
+    @Streaming
+    @GET("api/imports/{importId}/export")
+    suspend fun exportImport(
+        @Header("Authorization") authorization: String,
+        @Path("importId") importId: String
+    ): Response<ResponseBody>
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryRefreshCookieJar.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryRefreshCookieJar.kt
new file mode 100644
index 0000000..3ab424a
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryRefreshCookieJar.kt
@@ -0,0 +1,112 @@
+package com.iskenkenya.commory.mobile.remote
+
+import android.content.Context
+import okhttp3.Cookie
+import okhttp3.CookieJar
+import okhttp3.HttpUrl
+import org.json.JSONObject
+
+private const val REFRESH_COOKIE_NAME = "commory_refresh_token"
+private const val COOKIE_STORE_NAME = "commory_refresh_cookies"
+
+class CommoryRefreshCookieJar(
+    private val store: RefreshCookieStore
+) : CookieJar {
+    override fun saveFromResponse(url: HttpUrl, cookies: List<Cookie>) {
+        cookies.filter { it.name() == REFRESH_COOKIE_NAME }.forEach { cookie ->
+            val origin = originKey(url)
+            if (cookie.value().isBlank() || cookie.expiresAt() <= System.currentTimeMillis()) {
+                store.remove(origin)
+            } else {
+                store.put(
+                    origin,
+                    StoredRefreshCookie(
+                        value = cookie.value(),
+                        expiresAt = cookie.expiresAt(),
+                        secure = cookie.secure(),
+                        path = cookie.path()
+                    )
+                )
+            }
+        }
+    }
+
+    override fun loadForRequest(url: HttpUrl): List<Cookie> {
+        val stored = store.get(originKey(url)) ?: return emptyList()
+        if (stored.expiresAt <= System.currentTimeMillis()) {
+            store.remove(originKey(url))
+            return emptyList()
+        }
+        if (stored.secure && url.scheme() != "https") {
+            return emptyList()
+        }
+        return listOf(
+            Cookie.Builder()
+                .name(REFRESH_COOKIE_NAME)
+                .value(stored.value)
+                .hostOnlyDomain(url.host())
+                .path(stored.path.ifBlank { "/" })
+                .expiresAt(stored.expiresAt)
+                .apply {
+                    if (stored.secure) secure()
+                }
+                .build()
+        )
+    }
+
+    fun clear(baseUrl: String) {
+        HttpUrl.parse(baseUrl)?.let { store.remove(originKey(it)) }
+    }
+
+    companion object {
+        fun persistent(context: Context): CommoryRefreshCookieJar {
+            return CommoryRefreshCookieJar(SharedPreferencesRefreshCookieStore(context))
+        }
+
+        internal fun originKey(url: HttpUrl): String = "${url.scheme()}://${url.host()}:${url.port()}"
+    }
+}
+
+data class StoredRefreshCookie(
+    val value: String,
+    val expiresAt: Long,
+    val secure: Boolean,
+    val path: String
+)
+
+interface RefreshCookieStore {
+    fun get(origin: String): StoredRefreshCookie?
+    fun put(origin: String, cookie: StoredRefreshCookie)
+    fun remove(origin: String)
+}
+
+class SharedPreferencesRefreshCookieStore(context: Context) : RefreshCookieStore {
+    private val preferences = context.applicationContext.getSharedPreferences(COOKIE_STORE_NAME, Context.MODE_PRIVATE)
+
+    override fun get(origin: String): StoredRefreshCookie? {
+        val raw = preferences.getString(origin, null) ?: return null
+        return runCatching {
+            val json = JSONObject(raw)
+            StoredRefreshCookie(
+                value = json.getString("value"),
+                expiresAt = json.getLong("expiresAt"),
+                secure = json.optBoolean("secure", false),
+                path = json.optString("path", "/")
+            )
+        }.getOrNull()
+    }
+
+    override fun put(origin: String, cookie: StoredRefreshCookie) {
+        val raw = JSONObject()
+            .put("value", cookie.value)
+            .put("expiresAt", cookie.expiresAt)
+            .put("secure", cookie.secure)
+            .put("path", cookie.path)
+            .toString()
+        preferences.edit().putString(origin, raw).apply()
+    }
+
+    override fun remove(origin: String) {
+        preferences.edit().remove(origin).apply()
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryServerClient.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryServerClient.kt
new file mode 100644
index 0000000..c041c74
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/CommoryServerClient.kt
@@ -0,0 +1,305 @@
+package com.iskenkenya.commory.mobile.remote
+
+import android.os.Build
+import android.util.Base64
+import com.iskenkenya.commory.mobile.runtime.AppEnvironmentManager
+import com.iskenkenya.commory.mobile.runtime.AuthSession
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.withContext
+import okhttp3.MediaType
+import okhttp3.OkHttpClient
+import okhttp3.RequestBody
+import okhttp3.Response
+import okhttp3.ResponseBody
+import org.json.JSONObject
+import retrofit2.Retrofit
+import retrofit2.converter.gson.GsonConverterFactory
+import java.io.File
+import java.io.IOException
+import java.util.concurrent.ConcurrentHashMap
+import java.util.concurrent.TimeUnit
+import android.content.Context
+
+class CommoryServerClient(
+    private val context: Context,
+    private val environmentManager: AppEnvironmentManager
+) {
+    private val serviceCache = ConcurrentHashMap<String, CommoryApiService>()
+    private val refreshServiceCache = ConcurrentHashMap<String, CommoryApiService>()
+    private val deviceName = buildDeviceName()
+    private val refreshCookieJar = CommoryRefreshCookieJar.persistent(context)
+
+    private val refreshClient = baseClientBuilder()
+        .cookieJar(refreshCookieJar)
+        .build()
+
+    private val client = baseClientBuilder()
+        .cookieJar(refreshCookieJar)
+        .authenticator { _, response ->
+            if (responseCount(response) > 1 || response.request().url().encodedPath().contains("/api/auth/")) {
+                return@authenticator null
+            }
+            val refreshed = runBlocking { refreshPersistedSession().getOrNull() } ?: return@authenticator null
+            val accessToken = refreshed.accessToken ?: return@authenticator null
+            response.request().newBuilder()
+                .header("Authorization", bearer(accessToken))
+                .build()
+        }
+        .build()
+
+    private fun baseClientBuilder(): OkHttpClient.Builder = OkHttpClient.Builder()
+        .connectTimeout(15, TimeUnit.SECONDS)
+        .readTimeout(30, TimeUnit.SECONDS)
+        .writeTimeout(30, TimeUnit.SECONDS)
+        .addInterceptor { chain ->
+            val request = chain.request().newBuilder()
+                .header("X-Commory-Device", deviceName)
+                .build()
+            chain.proceed(request)
+        }
+
+    private fun service(baseUrl: String): CommoryApiService {
+        val normalized = normalizeBaseUrl(baseUrl)
+        return serviceCache.getOrPut(normalized) { createService(normalized, client) }
+    }
+
+    private fun refreshService(baseUrl: String): CommoryApiService {
+        val normalized = normalizeBaseUrl(baseUrl)
+        return refreshServiceCache.getOrPut(normalized) { createService(normalized, refreshClient) }
+    }
+
+    private fun createService(baseUrl: String, okHttpClient: OkHttpClient): CommoryApiService {
+        return Retrofit.Builder()
+            .baseUrl(baseUrl)
+            .client(okHttpClient)
+            .addConverterFactory(GsonConverterFactory.create())
+            .build()
+            .create(CommoryApiService::class.java)
+    }
+
+    suspend fun checkSetup(baseUrl: String): Result<SetupStatusDto> = wrapCall {
+        val response = service(baseUrl).getSetupStatus()
+        response.requireEnvelope("setup request failed").data ?: error("missing setup payload")
+    }
+
+    suspend fun register(baseUrl: String, userName: String, email: String, password: String): Result<AuthSession> = wrapCall {
+        val response = service(baseUrl).register(RegisterRequestDto(userName, email, password))
+        response.requireEnvelope("register failed").data?.toSession() ?: error("missing register payload")
+    }
+
+    suspend fun login(baseUrl: String, userName: String, password: String): Result<AuthSession> = wrapCall {
+        val response = service(baseUrl).login(LoginRequestDto(userName, password))
+        response.requireEnvelope("login failed").data?.toSession() ?: error("missing login payload")
+    }
+
+    suspend fun refresh(baseUrl: String, currentSession: AuthSession): Result<AuthSession> = wrapCall {
+        val pair = refreshTokenPair(baseUrl)
+        val accessToken = pair.accessToken ?: pair.token ?: error("missing access token")
+        currentSession.copy(
+            accessToken = accessToken,
+            accessTokenExpiresAtEpochSeconds = accessTokenExpiresAt(accessToken),
+            sessionId = accessTokenSessionId(accessToken) ?: currentSession.sessionId,
+            deviceName = currentSession.deviceName ?: deviceName
+        )
+    }
+
+    suspend fun logoutPersistedSession(): Result<Unit> = wrapCall {
+        val environment = environmentManager.currentSnapshot()
+        try {
+            refreshService(environment.serverUrl).logout().requireEnvelope("logout failed")
+        } catch (throwable: Throwable) {
+            if (!throwable.isTerminalAuthFailure()) {
+                throw throwable
+            }
+        } finally {
+            refreshCookieJar.clear(environment.serverUrl)
+            environmentManager.clearSession()
+        }
+    }
+
+    suspend fun userInfo(baseUrl: String, accessToken: String): Result<UserDto> = wrapCall {
+        val response = service(baseUrl).getUserInfo(bearer(accessToken))
+        response.requireEnvelope("user info failed").data ?: error("missing user payload")
+    }
+
+    suspend fun listImports(baseUrl: String, accessToken: String): Result<List<ImportSummaryDto>> = wrapCall {
+        val response = service(baseUrl).listImports(bearer(accessToken))
+        response.requireEnvelope("list imports failed").data ?: emptyList()
+    }
+
+    suspend fun uploadImport(baseUrl: String, accessToken: String, file: File): Result<ImportUploadResponseDto> = wrapCall {
+        val body = withContext(Dispatchers.IO) {
+            RequestBody.create(MediaType.parse("application/json"), file.readBytes())
+        }
+        val response = service(baseUrl).uploadImport(bearer(accessToken), body)
+        response.requireEnvelope("upload failed").data ?: error("missing upload payload")
+    }
+
+    suspend fun exportImport(baseUrl: String, accessToken: String, importId: String): Result<File> = wrapCall {
+        val response = service(baseUrl).exportImport(bearer(accessToken), importId)
+        response.requireSuccess("export failed")
+        val body = response.body() ?: error("missing export body")
+        val outDir = File(context.cacheDir, "remote-imports").apply { mkdirs() }
+        val outFile = File(outDir, "$importId.json")
+        withContext(Dispatchers.IO) {
+            body.byteStream().use { input ->
+                outFile.outputStream().use { output -> input.copyTo(output) }
+            }
+        }
+        outFile
+    }
+
+    suspend fun refreshPersistedSession(): Result<AuthSession> = wrapCall {
+        val environment = environmentManager.currentSnapshot()
+        val updated = refresh(environment.serverUrl, environment.authSession).getOrElse { throwable ->
+            if (throwable.isTerminalAuthFailure()) {
+                refreshCookieJar.clear(environment.serverUrl)
+                environmentManager.clearSession()
+            }
+            throw throwable
+        }
+        val userResponse = refreshService(environment.serverUrl).getUserInfo(bearer(updated.accessToken ?: ""))
+        val user = userResponse.requireEnvelope("user info failed").data ?: error("missing user payload")
+        val session = updated.copy(
+            userId = user.id,
+            userName = user.userName ?: user.user_name,
+            email = user.email,
+            deviceName = updated.deviceName ?: deviceName
+        )
+        environmentManager.updateSession(session)
+        session
+    }
+
+    private fun normalizeBaseUrl(baseUrl: String): String {
+        val trimmed = baseUrl.trim()
+        val withScheme = if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) trimmed else "http://$trimmed"
+        return if (withScheme.endsWith("/")) withScheme else "$withScheme/"
+    }
+
+    private fun bearer(token: String): String = "Bearer $token"
+
+    private suspend fun refreshTokenPair(baseUrl: String): TokenPairDto {
+        try {
+            return refreshService(baseUrl).refresh().requireEnvelope("refresh failed").data
+                ?: error("missing refresh payload")
+        } catch (throwable: Throwable) {
+            if (throwable.isRefreshRetryConflict()) {
+                return refreshService(baseUrl).refresh().requireEnvelope("refresh failed").data
+                    ?: error("missing refresh payload")
+            }
+            throw throwable
+        }
+    }
+
+    private suspend fun <T> wrapCall(block: suspend () -> T): Result<T> {
+        return runCatching { block() }
+            .fold(
+                onSuccess = { Result.success(it) },
+                onFailure = { throwable ->
+                    val failure = when (throwable) {
+                        is NetworkException -> throwable
+                        is IOException -> throwable.asNetworkException()
+                        is IllegalArgumentException -> NetworkException(NetworkError.Validation(throwable.message ?: "invalid request"))
+                        is IllegalStateException -> NetworkException(NetworkError.Validation(throwable.message ?: "invalid response"))
+                        else -> throwable.asNetworkException()
+                    }
+                    Result.failure(failure)
+                }
+            )
+    }
+
+    private fun AuthResponseDto.toSession(): AuthSession {
+        return AuthSession(
+            accessToken = token,
+            accessTokenExpiresAtEpochSeconds = accessTokenExpiresAt(token),
+            sessionId = accessTokenSessionId(token),
+            deviceName = deviceName,
+            userId = user.id,
+            userName = user.userName ?: user.user_name,
+            email = user.email
+        )
+    }
+
+    private fun accessTokenExpiresAt(token: String?): Long? {
+        if (token.isNullOrBlank()) return null
+        return runCatching {
+            val payload = token.split(".").getOrNull(1) ?: return null
+            val decoded = Base64.decode(payload, Base64.URL_SAFE or Base64.NO_PADDING or Base64.NO_WRAP)
+            JSONObject(String(decoded)).optLong("exp").takeIf { it > 0L }
+        }.getOrNull()
+    }
+
+    private fun accessTokenSessionId(token: String?): String? {
+        if (token.isNullOrBlank()) return null
+        return runCatching {
+            val payload = token.split(".").getOrNull(1) ?: return null
+            val decoded = Base64.decode(payload, Base64.URL_SAFE or Base64.NO_PADDING or Base64.NO_WRAP)
+            JSONObject(String(decoded)).optString("sid").takeIf { it.isNotBlank() }
+        }.getOrNull()
+    }
+
+    private fun responseCount(response: Response): Int {
+        var count = 1
+        var prior = response.priorResponse()
+        while (prior != null) {
+            count++
+            prior = prior.priorResponse()
+        }
+        return count
+    }
+
+    private fun buildDeviceName(): String {
+        val manufacturer = Build.MANUFACTURER?.trim().orEmpty()
+        val model = Build.MODEL?.trim().orEmpty()
+        return listOf(manufacturer, model)
+            .filter { it.isNotBlank() }
+            .distinct()
+            .joinToString(" ")
+            .ifBlank { "Android Device" }
+    }
+
+    private fun Throwable.isTerminalAuthFailure(): Boolean {
+        val network = this as? NetworkException ?: return false
+        return network.error is NetworkError.Unauthorized
+    }
+
+    private fun Throwable.isRefreshRetryConflict(): Boolean {
+        val network = this as? NetworkException ?: return false
+        val server = network.error as? NetworkError.Server ?: return false
+        return server.statusCode == 409 && server.message == "ERR_REFRESH_TOKEN_RETRY"
+    }
+
+    private fun <T> retrofit2.Response<ApiEnvelope<T>>.requireEnvelope(fallbackMessage: String): ApiEnvelope<T> {
+        if (isSuccessful) {
+            return body() ?: error(fallbackMessage)
+        }
+        throw toNetworkException(fallbackMessage)
+    }
+
+    private fun retrofit2.Response<ResponseBody>.requireSuccess(fallbackMessage: String) {
+        if (!isSuccessful) {
+            throw toNetworkException(fallbackMessage)
+        }
+    }
+
+    private fun retrofit2.Response<*>.toNetworkException(fallbackMessage: String): NetworkException {
+        val message = responseMessage(fallbackMessage)
+        return when (code()) {
+            400 -> NetworkException(NetworkError.Validation(message))
+            401 -> NetworkException(NetworkError.Unauthorized(message))
+            else -> NetworkException(NetworkError.Server(code(), message))
+        }
+    }
+
+    private fun retrofit2.Response<*>.responseMessage(fallbackMessage: String): String {
+        val errorBodyString = runCatching { errorBody()?.string().orEmpty() }.getOrDefault("")
+        if (errorBodyString.isBlank()) {
+            return message().takeIf { it.isNotBlank() } ?: fallbackMessage
+        }
+        return runCatching { JSONObject(errorBodyString).optString("msg") }
+            .getOrNull()
+            ?.takeIf { it.isNotBlank() }
+            ?: errorBodyString
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/NetworkError.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/NetworkError.kt
new file mode 100644
index 0000000..4783ee7
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/remote/NetworkError.kt
@@ -0,0 +1,29 @@
+package com.iskenkenya.commory.mobile.remote
+
+import java.io.IOException
+import java.net.SocketTimeoutException
+import java.net.UnknownHostException
+import javax.net.ssl.SSLException
+
+sealed class NetworkError(message: String, cause: Throwable? = null) : IOException(message, cause) {
+    class Offline(cause: Throwable? = null) : NetworkError("network unavailable", cause)
+    class Timeout(cause: Throwable? = null) : NetworkError("network timeout", cause)
+    class Ssl(cause: Throwable? = null) : NetworkError("ssl error", cause)
+    class Unauthorized(message: String = "unauthorized") : NetworkError(message)
+    class Server(val statusCode: Int, message: String) : NetworkError(message)
+    class Validation(message: String) : NetworkError(message)
+    class Unknown(cause: Throwable) : NetworkError(cause.message ?: "network error", cause)
+}
+
+class NetworkException(val error: NetworkError) : IOException(error.message, error)
+
+fun Throwable.asNetworkException(): NetworkException {
+    return when (this) {
+        is NetworkException -> this
+        is UnknownHostException -> NetworkException(NetworkError.Offline(this))
+        is SocketTimeoutException -> NetworkException(NetworkError.Timeout(this))
+        is SSLException -> NetworkException(NetworkError.Ssl(this))
+        is IOException -> NetworkException(NetworkError.Unknown(this))
+        else -> NetworkException(NetworkError.Unknown(this))
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/AppEnvironment.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/AppEnvironment.kt
new file mode 100644
index 0000000..bf35108
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/AppEnvironment.kt
@@ -0,0 +1,38 @@
+package com.iskenkenya.commory.mobile.runtime
+
+enum class RuntimeMode {
+    LOCAL_ONLY,
+    COMMORY_SERVER
+}
+
+enum class AppLocaleOption {
+    SYSTEM,
+    ZH_CN,
+    EN
+}
+
+data class AuthSession(
+    val accessToken: String? = null,
+    val accessTokenExpiresAtEpochSeconds: Long? = null,
+    val sessionId: String? = null,
+    val deviceName: String? = null,
+    val userId: String? = null,
+    val userName: String? = null,
+    val email: String? = null
+) {
+    val isAuthenticated: Boolean
+        get() {
+            if (accessToken.isNullOrBlank()) return false
+            val expiresAt = accessTokenExpiresAtEpochSeconds ?: return true
+            return (System.currentTimeMillis() / 1000L) < expiresAt
+        }
+}
+
+data class AppEnvironment(
+    val mode: RuntimeMode = RuntimeMode.LOCAL_ONLY,
+    val modeSelected: Boolean = false,
+    val serverUrl: String = "http://10.0.2.2:3000/",
+    val locale: AppLocaleOption = AppLocaleOption.SYSTEM,
+    val syncOnBackup: Boolean = true,
+    val authSession: AuthSession = AuthSession()
+)
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/AppEnvironmentManager.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/AppEnvironmentManager.kt
new file mode 100644
index 0000000..ba1b71d
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/AppEnvironmentManager.kt
@@ -0,0 +1,152 @@
+package com.iskenkenya.commory.mobile.runtime
+
+import android.content.Context
+import android.os.Build
+import androidx.datastore.core.DataStore
+import androidx.datastore.preferences.core.Preferences
+import androidx.datastore.preferences.core.booleanPreferencesKey
+import androidx.datastore.preferences.core.edit
+import androidx.datastore.preferences.core.stringPreferencesKey
+import androidx.datastore.preferences.preferencesDataStore
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.SharingStarted
+import kotlinx.coroutines.flow.map
+import kotlinx.coroutines.flow.onEach
+import kotlinx.coroutines.flow.stateIn
+
+private val Context.appEnvironmentStore: DataStore<Preferences> by preferencesDataStore(name = "commory_app_environment")
+
+class AppEnvironmentManager(context: Context) {
+    private val appContext = context.applicationContext
+    private val dataStore = appContext.appEnvironmentStore
+    private val scope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
+    @Volatile private var cachedSnapshot = AppEnvironment(serverUrl = defaultServerUrl())
+
+    val environment: Flow<AppEnvironment> = dataStore.data.map { preferences ->
+        AppEnvironment(
+            mode = RuntimeMode.valueOf(
+                preferences[KEY_RUNTIME_MODE] ?: RuntimeMode.LOCAL_ONLY.name
+            ),
+            modeSelected = preferences[KEY_MODE_SELECTED] ?: false,
+            serverUrl = preferences[KEY_SERVER_URL] ?: defaultServerUrl(),
+            locale = AppLocaleOption.valueOf(
+                preferences[KEY_LOCALE] ?: AppLocaleOption.SYSTEM.name
+            ),
+            syncOnBackup = preferences[KEY_SYNC_ON_BACKUP] ?: true,
+            authSession = AuthSession(
+                accessToken = preferences[KEY_ACCESS_TOKEN],
+                accessTokenExpiresAtEpochSeconds = preferences[KEY_ACCESS_TOKEN_EXPIRES_AT]?.toLongOrNull(),
+                sessionId = preferences[KEY_SESSION_ID],
+                deviceName = preferences[KEY_DEVICE_NAME],
+                userId = preferences[KEY_USER_ID],
+                userName = preferences[KEY_USER_NAME],
+                email = preferences[KEY_EMAIL]
+            )
+        )
+    }.onEach { cachedSnapshot = it }
+        .stateIn(scope, SharingStarted.Eagerly, cachedSnapshot)
+
+    fun currentSnapshot(): AppEnvironment = cachedSnapshot
+
+    suspend fun selectMode(mode: RuntimeMode) {
+        dataStore.edit { preferences ->
+            preferences[KEY_RUNTIME_MODE] = mode.name
+            preferences[KEY_MODE_SELECTED] = true
+        }
+        cachedSnapshot = cachedSnapshot.copy(mode = mode, modeSelected = true)
+    }
+
+    suspend fun updateServerUrl(serverUrl: String) {
+        val normalized = normalizeServerUrl(serverUrl)
+        dataStore.edit { preferences ->
+            preferences[KEY_SERVER_URL] = normalized
+        }
+        cachedSnapshot = cachedSnapshot.copy(serverUrl = normalized)
+    }
+
+    suspend fun updateLocale(locale: AppLocaleOption) {
+        dataStore.edit { preferences ->
+            preferences[KEY_LOCALE] = locale.name
+        }
+        cachedSnapshot = cachedSnapshot.copy(locale = locale)
+    }
+
+    suspend fun updateSyncOnBackup(enabled: Boolean) {
+        dataStore.edit { preferences ->
+            preferences[KEY_SYNC_ON_BACKUP] = enabled
+        }
+        cachedSnapshot = cachedSnapshot.copy(syncOnBackup = enabled)
+    }
+
+    suspend fun updateSession(session: AuthSession) {
+        dataStore.edit { preferences ->
+            setOrRemove(preferences, KEY_ACCESS_TOKEN, session.accessToken)
+            preferences.remove(KEY_REFRESH_TOKEN)
+            setOrRemove(preferences, KEY_ACCESS_TOKEN_EXPIRES_AT, session.accessTokenExpiresAtEpochSeconds?.toString())
+            setOrRemove(preferences, KEY_SESSION_ID, session.sessionId)
+            setOrRemove(preferences, KEY_DEVICE_NAME, session.deviceName)
+            setOrRemove(preferences, KEY_USER_ID, session.userId)
+            setOrRemove(preferences, KEY_USER_NAME, session.userName)
+            setOrRemove(preferences, KEY_EMAIL, session.email)
+        }
+        cachedSnapshot = cachedSnapshot.copy(authSession = session)
+    }
+
+    suspend fun clearSession() {
+        updateSession(AuthSession())
+    }
+
+    private fun normalizeServerUrl(input: String): String {
+        val trimmed = input.trim()
+        if (trimmed.isBlank()) {
+            return defaultServerUrl()
+        }
+        val withScheme = if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+            trimmed
+        } else {
+            "http://$trimmed"
+        }
+        return if (withScheme.endsWith("/")) withScheme else "$withScheme/"
+    }
+
+    private fun setOrRemove(
+        preferences: androidx.datastore.preferences.core.MutablePreferences,
+        key: Preferences.Key<String>,
+        value: String?
+    ) {
+        if (value.isNullOrBlank()) {
+            preferences.remove(key)
+        } else {
+            preferences[key] = value
+        }
+    }
+
+    private companion object {
+        fun defaultServerUrl(): String {
+            val fingerprint = Build.FINGERPRINT.lowercase()
+            val model = Build.MODEL.lowercase()
+            val isEmulator = fingerprint.contains("generic") ||
+                fingerprint.contains("emulator") ||
+                model.contains("sdk") ||
+                model.contains("emulator")
+            return if (isEmulator) "http://10.0.2.2:3000/" else "https://commory.iskenkenya.com/"
+        }
+
+        val KEY_RUNTIME_MODE = stringPreferencesKey("runtime_mode")
+        val KEY_MODE_SELECTED = booleanPreferencesKey("mode_selected")
+        val KEY_SERVER_URL = stringPreferencesKey("server_url")
+        val KEY_LOCALE = stringPreferencesKey("locale")
+        val KEY_SYNC_ON_BACKUP = booleanPreferencesKey("sync_on_backup")
+        val KEY_ACCESS_TOKEN = stringPreferencesKey("access_token")
+        val KEY_REFRESH_TOKEN = stringPreferencesKey("refresh_token")
+        val KEY_ACCESS_TOKEN_EXPIRES_AT = stringPreferencesKey("access_token_expires_at")
+        val KEY_SESSION_ID = stringPreferencesKey("session_id")
+        val KEY_DEVICE_NAME = stringPreferencesKey("device_name")
+        val KEY_USER_ID = stringPreferencesKey("user_id")
+        val KEY_USER_NAME = stringPreferencesKey("user_name")
+        val KEY_EMAIL = stringPreferencesKey("email")
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/LocaleResolver.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/LocaleResolver.kt
new file mode 100644
index 0000000..9089959
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/LocaleResolver.kt
@@ -0,0 +1,23 @@
+package com.iskenkenya.commory.mobile.runtime
+
+import android.content.Context
+import android.content.res.Configuration
+import java.util.Locale
+
+object LocaleResolver {
+    fun resolveLocale(environment: AppEnvironment, fallback: Locale = Locale.getDefault()): Locale {
+        return when (environment.locale) {
+            AppLocaleOption.SYSTEM -> fallback
+            AppLocaleOption.ZH_CN -> Locale.SIMPLIFIED_CHINESE
+            AppLocaleOption.EN -> Locale.ENGLISH
+        }
+    }
+
+    fun wrapContext(base: Context, environment: AppEnvironment): Context {
+        val locale = resolveLocale(environment, base.resources.configuration.locales[0] ?: Locale.getDefault())
+        Locale.setDefault(locale)
+        val configuration = Configuration(base.resources.configuration)
+        configuration.setLocale(locale)
+        return base.createConfigurationContext(configuration)
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/RuntimeModePolicy.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/RuntimeModePolicy.kt
new file mode 100644
index 0000000..7759703
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/runtime/RuntimeModePolicy.kt
@@ -0,0 +1,17 @@
+package com.iskenkenya.commory.mobile.runtime
+
+object RuntimeModePolicy {
+    fun requiresServerAuth(environment: AppEnvironment): Boolean {
+        return environment.mode == RuntimeMode.COMMORY_SERVER && !environment.authSession.isAuthenticated
+    }
+
+    fun canUploadBackup(environment: AppEnvironment): Boolean {
+        return environment.mode == RuntimeMode.COMMORY_SERVER &&
+            environment.syncOnBackup &&
+            environment.authSession.isAuthenticated
+    }
+
+    fun allowsLocalBackup(environment: AppEnvironment): Boolean = environment.modeSelected
+
+    fun preservesLocalFilesOnModeSwitch(): Boolean = true
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/service/HeadlessSmsSendService.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/service/HeadlessSmsSendService.kt
similarity index 95%
rename from android/app/src/main/java/imken/messagevault/mobile/service/HeadlessSmsSendService.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/service/HeadlessSmsSendService.kt
index 888567b..a91492e 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/service/HeadlessSmsSendService.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/service/HeadlessSmsSendService.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.service
+package com.iskenkenya.commory.mobile.service
 
 import android.app.Service
 import android.content.Intent
diff --git a/android/app/src/main/java/imken/messagevault/mobile/service/MessageService.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/service/MessageService.kt
similarity index 96%
rename from android/app/src/main/java/imken/messagevault/mobile/service/MessageService.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/service/MessageService.kt
index 6b55d02..3623b7e 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/service/MessageService.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/service/MessageService.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.service
+package com.iskenkenya.commory.mobile.service
 
 import android.app.Service
 import android.content.Intent
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/components/Button.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Button.kt
similarity index 98%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/components/Button.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Button.kt
index 1136821..1a120ca 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/components/Button.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Button.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.components
+package com.iskenkenya.commory.mobile.ui.components
 
 import androidx.compose.foundation.layout.PaddingValues
 import androidx.compose.foundation.layout.fillMaxWidth
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/components/Card.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Card.kt
similarity index 98%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/components/Card.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Card.kt
index 674dfad..1ff69dc 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/components/Card.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Card.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.components
+package com.iskenkenya.commory.mobile.ui.components
 
 import androidx.compose.foundation.BorderStroke
 import androidx.compose.foundation.clickable
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/components/Message.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Message.kt
similarity index 99%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/components/Message.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Message.kt
index 65a5457..ed96d95 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/components/Message.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/Message.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.components
+package com.iskenkenya.commory.mobile.ui.components
 
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.Column
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/components/TextField.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/TextField.kt
similarity index 99%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/components/TextField.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/TextField.kt
index 88422d3..5fc84b7 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/components/TextField.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/components/TextField.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.components
+package com.iskenkenya.commory.mobile.ui.components
 
 import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.fillMaxWidth
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/model/UiText.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/model/UiText.kt
new file mode 100644
index 0000000..36e9516
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/model/UiText.kt
@@ -0,0 +1,25 @@
+package com.iskenkenya.commory.mobile.ui.model
+
+import androidx.annotation.StringRes
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.res.stringResource
+
+sealed interface UiText {
+    data class Resource(@StringRes val resId: Int, val args: List<Any> = emptyList()) : UiText
+    data class Dynamic(val value: String) : UiText
+}
+
+@Composable
+fun UiText?.resolve(): String? {
+    return when (this) {
+        null -> null
+        is UiText.Dynamic -> value
+        is UiText.Resource -> stringResource(resId, *args.toTypedArray())
+    }
+}
+
+data class PermissionSnapshot(
+    val backupPermissionsGranted: Boolean = false,
+    val restorePermissionsGranted: Boolean = false,
+    val defaultSmsApp: Boolean = false
+)
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/navigation/NavigationHost.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/navigation/NavigationHost.kt
new file mode 100644
index 0000000..3bf201d
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/navigation/NavigationHost.kt
@@ -0,0 +1,180 @@
+package com.iskenkenya.commory.mobile.ui.navigation
+
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Backup
+import androidx.compose.material.icons.filled.MoreHoriz
+import androidx.compose.material.icons.filled.Preview
+import androidx.compose.material.icons.filled.Restore
+import androidx.compose.material3.CenterAlignedTopAppBar
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.NavigationBar
+import androidx.compose.material3.NavigationBarItem
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.collectAsState
+import androidx.compose.runtime.getValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.res.stringResource
+import androidx.navigation.NavDestination.Companion.hierarchy
+import androidx.navigation.NavGraph.Companion.findStartDestination
+import androidx.navigation.compose.NavHost
+import androidx.navigation.compose.composable
+import androidx.navigation.compose.currentBackStackEntryAsState
+import androidx.navigation.compose.rememberNavController
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.runtime.RuntimeMode
+import com.iskenkenya.commory.mobile.runtime.RuntimeModePolicy
+import com.iskenkenya.commory.mobile.ui.screens.BackupScreen
+import com.iskenkenya.commory.mobile.ui.screens.MoreScreen
+import com.iskenkenya.commory.mobile.ui.screens.ModeSelectionScreen
+import com.iskenkenya.commory.mobile.ui.screens.PreviewScreen
+import com.iskenkenya.commory.mobile.ui.screens.RestoreScreen
+import com.iskenkenya.commory.mobile.ui.screens.ServerSetupScreen
+import com.iskenkenya.commory.mobile.ui.viewmodels.AppViewModel
+import com.iskenkenya.commory.mobile.ui.viewmodels.BackupViewModel
+import com.iskenkenya.commory.mobile.ui.viewmodels.RestoreViewModel
+
+sealed class NavigationItem(val route: String, val iconData: ImageVector, val labelResId: Int) {
+    object Backup : NavigationItem("backup", Icons.Filled.Backup, R.string.backup_tab)
+    object Restore : NavigationItem("restore", Icons.Filled.Restore, R.string.restore_tab)
+    object Preview : NavigationItem("preview", Icons.Filled.Preview, R.string.preview_tab)
+    object More : NavigationItem("more", Icons.Filled.MoreHoriz, R.string.more_tab)
+}
+
+val navigationItems = listOf(
+    NavigationItem.Backup,
+    NavigationItem.Restore,
+    NavigationItem.Preview,
+    NavigationItem.More
+)
+
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun CommoryAppWithNavigation(
+    appViewModel: AppViewModel,
+    backupViewModel: BackupViewModel,
+    restoreViewModel: RestoreViewModel,
+    navigationItems: List<NavigationItem>
+) {
+    val navController = rememberNavController()
+    val environment by appViewModel.environment.collectAsState()
+    val serverAuthState by appViewModel.serverAuthState.collectAsState()
+
+    if (!environment.modeSelected) {
+        ModeSelectionScreen(onSelectMode = appViewModel::selectMode)
+        return
+    }
+
+    if (RuntimeModePolicy.requiresServerAuth(environment)) {
+        ServerSetupScreen(
+            environment = environment,
+            authState = serverAuthState,
+            onServerUrlChange = appViewModel::updateServerUrl,
+            onCheckServer = { appViewModel.checkServer() },
+            onLogin = appViewModel::login,
+            onRegister = appViewModel::register,
+            onUseLocal = { appViewModel.selectMode(RuntimeMode.LOCAL_ONLY) }
+        )
+        return
+    }
+
+    Scaffold(
+        topBar = {
+            CenterAlignedTopAppBar(
+                title = {
+                    Text(
+                        text = stringResource(id = R.string.app_title),
+                        style = MaterialTheme.typography.titleLarge
+                    )
+                }
+            )
+        },
+        bottomBar = {
+            NavigationBar {
+                val navBackStackEntry by navController.currentBackStackEntryAsState()
+                val currentDestination = navBackStackEntry?.destination
+
+                navigationItems.forEach { item ->
+                    NavigationBarItem(
+                        icon = { Icon(item.iconData, contentDescription = null) },
+                        label = { Text(stringResource(item.labelResId)) },
+                        selected = currentDestination?.hierarchy?.any { it.route == item.route } == true,
+                        onClick = {
+                            navController.navigate(item.route) {
+                                popUpTo(navController.graph.findStartDestination().id) {
+                                    saveState = true
+                                }
+                                launchSingleTop = true
+                                restoreState = true
+                            }
+                        }
+                    )
+                }
+            }
+        }
+    ) { innerPadding ->
+        NavHost(
+            navController = navController,
+            startDestination = NavigationItem.Backup.route,
+            modifier = Modifier.padding(innerPadding)
+        ) {
+            composable(NavigationItem.Backup.route) {
+                BackupScreen(
+                    permissionsGranted = backupViewModel.getPermissionsGranted(),
+                    isOperating = backupViewModel.isOperating(),
+                    backupStatus = backupViewModel.getBackupStatus(),
+                    onBackupClick = { backupViewModel.startBackup() }
+                )
+            }
+            composable(NavigationItem.Restore.route) {
+                val backupFiles by restoreViewModel.backupFiles.collectAsState(initial = emptyList())
+                val selectedBackupFile by restoreViewModel.selectedBackupFile.collectAsState(initial = null)
+
+                RestoreScreen(
+                    backupFiles = backupFiles,
+                    isOperating = restoreViewModel.isOperating.value,
+                    restoreStatus = restoreViewModel.restoreStatus.value,
+                    onRestoreClick = { backupFile ->
+                        restoreViewModel.restoreBackupFile(backupFile)
+                    },
+                    onBackupItemClick = { backupFile ->
+                        restoreViewModel.selectBackupFile(backupFile)
+                    },
+                    selectedBackupFile = selectedBackupFile,
+                    viewModel = restoreViewModel
+                )
+            }
+            composable(NavigationItem.Preview.route) {
+                PreviewScreen(permissionsGranted = backupViewModel.getPermissionsGranted())
+            }
+            composable(NavigationItem.More.route) {
+                MoreScreen(
+                    environment = environment,
+                    serverAuthState = serverAuthState,
+                    onModeChange = appViewModel::selectMode,
+                    onLocaleChange = appViewModel::updateLocale,
+                    onSyncOnBackupChange = appViewModel::updateSyncOnBackup,
+                    onServerUrlChange = appViewModel::updateServerUrl,
+                    onCheckServer = { appViewModel.checkServer() },
+                    onLogin = appViewModel::login,
+                    onRegister = appViewModel::register,
+                    onLogout = appViewModel::logout,
+                    onNavigateToRestore = {
+                        navController.navigate(NavigationItem.Restore.route) {
+                            popUpTo(navController.graph.findStartDestination().id) {
+                                saveState = true
+                            }
+                            launchSingleTop = true
+                            restoreState = true
+                        }
+                    }
+                )
+            }
+        }
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/permission/PermissionHandler.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/permission/PermissionHandler.kt
new file mode 100644
index 0000000..d3a0fb6
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/permission/PermissionHandler.kt
@@ -0,0 +1,79 @@
+package com.iskenkenya.commory.mobile.ui.permission
+
+import android.Manifest
+import android.content.pm.PackageManager
+import android.os.Build
+import android.widget.Toast
+import androidx.activity.ComponentActivity
+import androidx.activity.result.contract.ActivityResultContracts
+import androidx.core.content.ContextCompat
+import com.iskenkenya.commory.mobile.utils.PermissionUtils
+import timber.log.Timber
+
+class PermissionHandler(private val activity: ComponentActivity) {
+
+    companion object {
+        val BACKUP_PERMISSIONS = PermissionUtils.BACKUP_PERMISSIONS
+        val RESTORE_PERMISSIONS = PermissionUtils.RESTORE_PERMISSIONS
+    }
+
+    private val requestPermissionLauncher = activity.registerForActivityResult(
+        ActivityResultContracts.RequestMultiplePermissions()
+    ) { permissions ->
+        val allGranted = permissions.entries.all { it.value }
+        if (allGranted) {
+            Timber.i("[Mobile] INFO [Permissions] 所有请求的权限已授予")
+            Toast.makeText(activity, activity.getString(com.iskenkenya.commory.mobile.R.string.permissions_granted_toast), Toast.LENGTH_SHORT).show()
+        } else {
+            val deniedPermissions = permissions.filterValues { !it }.keys
+            Timber.w("[Mobile] WARN [Permissions] 部分权限被拒绝: $deniedPermissions")
+
+            if (deniedPermissions.any { activity.shouldShowRequestPermissionRationale(it) }) {
+                showPermissionRationaleDialog()
+            } else {
+                PermissionUtils.openAppSettings(activity)
+                Toast.makeText(activity, activity.getString(com.iskenkenya.commory.mobile.R.string.permissions_settings_toast), Toast.LENGTH_LONG).show()
+            }
+        }
+    }
+
+    fun checkPermissions(): Boolean = checkBackupPermissions(requestIfMissing = true)
+
+    fun checkBackupPermissions(requestIfMissing: Boolean = true): Boolean {
+        val permissionsToCheck = BACKUP_PERMISSIONS
+
+        val allPermissionsGranted = permissionsToCheck.all {
+            ContextCompat.checkSelfPermission(activity, it) == PackageManager.PERMISSION_GRANTED
+        }
+
+        if (allPermissionsGranted) {
+            Timber.i("[Mobile] INFO [Permission] 已有所有必要权限; Context: 启动检查")
+        } else {
+            Timber.i("[Mobile] INFO [Permission] 请求权限; Context: 启动检查")
+            if (requestIfMissing) {
+                requestPermissionLauncher.launch(permissionsToCheck)
+            }
+        }
+
+        return allPermissionsGranted
+    }
+
+    fun checkRestorePermissions(requestIfMissing: Boolean = true): Boolean {
+        val permissionsToCheck = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            RESTORE_PERMISSIONS
+        } else {
+            RESTORE_PERMISSIONS + Manifest.permission.WRITE_EXTERNAL_STORAGE
+        }
+        val allPermissionsGranted = permissionsToCheck.all {
+            ContextCompat.checkSelfPermission(activity, it) == PackageManager.PERMISSION_GRANTED
+        }
+        if (!allPermissionsGranted && requestIfMissing) {
+            requestPermissionLauncher.launch(permissionsToCheck)
+        }
+        return allPermissionsGranted
+    }
+
+    private fun showPermissionRationaleDialog() {
+        Toast.makeText(activity, activity.getString(com.iskenkenya.commory.mobile.R.string.permission_rationale), Toast.LENGTH_LONG).show()
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/restore/RestoreState.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/restore/RestoreState.kt
similarity index 100%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/restore/RestoreState.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/restore/RestoreState.kt
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/restore/RestoreViewModel.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/restore/RestoreViewModel.kt
similarity index 60%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/restore/RestoreViewModel.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/restore/RestoreViewModel.kt
index 07f47cd..d624670 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/restore/RestoreViewModel.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/restore/RestoreViewModel.kt
@@ -1,44 +1,38 @@
-package imken.messagevault.mobile.ui.restore
+package com.iskenkenya.commory.mobile.ui.restore
 
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
-import imken.messagevault.mobile.data.RestoreManager
-import imken.messagevault.mobile.models.BackupFile
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsWriter
+import com.iskenkenya.commory.mobile.models.BackupFile
+import com.iskenkenya.commory.sdk.backup.RestoreManager
+import com.iskenkenya.commory.sdk.backup.model.RestoreOptions
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
 import kotlinx.coroutines.launch
 import timber.log.Timber
 
-/**
- * 恢复界面的ViewModel
- * 负责管理恢复过程的状态和与RestoreManager的交互
- */
 class RestoreViewModel(
     private val restoreManager: RestoreManager
 ) : ViewModel() {
     
-    // 恢复状态流
     private val _restoreState = MutableStateFlow<RestoreState>(RestoreState.Idle)
     val restoreState: StateFlow<RestoreState> = _restoreState
     
-    // 可用备份文件列表
     private val _availableBackups = MutableStateFlow<List<BackupFile>>(emptyList())
     val availableBackups: StateFlow<List<BackupFile>> = _availableBackups
     
-    // 加载状态
     private val _isLoading = MutableStateFlow(false)
     val isLoading: StateFlow<Boolean> = _isLoading
     
-    /**
-     * 加载可用的备份文件
-     */
     fun loadAvailableBackups() {
         viewModelScope.launch {
             _isLoading.value = true
             try {
-                val backups = restoreManager.getAvailableBackups()
-                _availableBackups.value = backups
-                Timber.i("[Mobile] INFO [RestoreViewModel] 加载了 ${backups.size} 个备份文件")
+                _availableBackups.value = emptyList()
+                Timber.i("[Mobile] INFO [RestoreViewModel] 加载了 0 个备份文件")
             } catch (e: Exception) {
                 Timber.e(e, "[Mobile] ERROR [RestoreViewModel] 加载备份文件失败: ${e.message}")
                 _restoreState.value = RestoreState.Error("加载备份文件失败: ${e.message}")
@@ -48,16 +42,14 @@ class RestoreViewModel(
         }
     }
     
-    /**
-     * 从选定的备份文件恢复数据
-     * 
-     * @param backupFile 要恢复的备份文件
-     */
     fun restoreFromFile(backupFile: BackupFile) {
         viewModelScope.launch {
             try {
                 _restoreState.value = RestoreState.InProgress("准备", 0)
-                val result = restoreManager.restoreFromFile(backupFile, restoreCallback)
+                val result = restoreManager.restore(
+                    backupFile.filePath,
+                    RestoreOptions(sms = true, callLogs = true, contacts = true)
+                )
                 if (result.success) {
                     _restoreState.value = RestoreState.Success(result.message)
                 } else {
@@ -70,13 +62,9 @@ class RestoreViewModel(
         }
     }
     
-    /**
-     * 取消恢复过程
-     */
     fun cancelRestore() {
         viewModelScope.launch {
             try {
-                // 这里可以添加取消恢复过程的逻辑
                 _restoreState.value = RestoreState.Idle
                 Timber.i("[Mobile] INFO [RestoreViewModel] 用户取消了恢复过程")
             } catch (e: Exception) {
@@ -85,42 +73,11 @@ class RestoreViewModel(
         }
     }
     
-    /**
-     * 重置恢复状态
-     */
     fun resetState() {
         _restoreState.value = RestoreState.Idle
     }
-    
-    /**
-     * 恢复回调实现
-     */
-private val restoreCallback = object : RestoreManager.ProgressCallback {
-    override fun onStart(operation: String) {
-        _restoreState.value = RestoreState.InProgress(operation, 0)
-    }
-
-    override fun onProgressUpdate(operation: String, progress: Int) {
-        _restoreState.value = RestoreState.InProgress(operation, progress)
-    }
-    
-    override fun onProgressUpdate(operation: String, progress: Int, message: String) {
-        _restoreState.value = RestoreState.InProgress(operation, progress, message)
-    }
-
-    override fun onComplete(success: Boolean, message: String) {
-        if (success) {
-            _restoreState.value = RestoreState.Success(message)
-        } else {
-            _restoreState.value = RestoreState.Error(message)
-        }
-        }
-    }
 }
 
-/**
- * 恢复状态密封类
- */
 sealed class RestoreState {
     object Idle : RestoreState()
     data class InProgress(val operation: String, val progress: Int, val message: String = "") : RestoreState()
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/BackupScreen.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/BackupScreen.kt
similarity index 88%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/screens/BackupScreen.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/BackupScreen.kt
index b169f7d..688b557 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/BackupScreen.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/BackupScreen.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.screens
+package com.iskenkenya.commory.mobile.ui.screens
 
 import android.Manifest
 import androidx.compose.foundation.layout.*
@@ -15,8 +15,10 @@ import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
-import imken.messagevault.mobile.R
-import imken.messagevault.mobile.ui.theme.MessageVaultTheme
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.ui.theme.CommoryTheme
+import com.iskenkenya.commory.mobile.ui.model.UiText
+import com.iskenkenya.commory.mobile.ui.model.resolve
 
 /**
  * 备份屏幕
@@ -32,7 +34,7 @@ import imken.messagevault.mobile.ui.theme.MessageVaultTheme
 fun BackupScreen(
     permissionsGranted: Boolean,
     isOperating: Boolean,
-    backupStatus: String?,
+    backupStatus: UiText?,
     onBackupClick: () -> Unit
 ) {
     Column(
@@ -131,9 +133,10 @@ fun PermissionRequiredCard() {
 @Composable
 fun BackupInfoCard(
     isOperating: Boolean,
-    backupStatus: String?,
+    backupStatus: UiText?,
     onBackupClick: () -> Unit
 ) {
+    val status = backupStatus.resolve() ?: stringResource(id = R.string.status_initial)
     Card(
         modifier = Modifier.fillMaxWidth(),
         colors = CardDefaults.cardColors(
@@ -146,7 +149,7 @@ fun BackupInfoCard(
         ) {
             // 标题
             Text(
-                text = "数据备份",
+                text = stringResource(R.string.backup_data_title),
                 style = MaterialTheme.typography.titleLarge,
                 color = MaterialTheme.colorScheme.onPrimaryContainer
             )
@@ -155,7 +158,7 @@ fun BackupInfoCard(
             
             // 状态信息
             Text(
-                text = backupStatus ?: stringResource(id = R.string.status_initial),
+                text = status,
                 style = MaterialTheme.typography.bodyLarge,
                 textAlign = TextAlign.Center,
                 modifier = Modifier.padding(bottom = 16.dp)
@@ -212,7 +215,7 @@ fun BackupHelpCard() {
             modifier = Modifier.padding(16.dp)
         ) {
             Text(
-                text = "关于备份",
+                text = stringResource(R.string.backup_about_title),
                 style = MaterialTheme.typography.titleLarge
             )
             
@@ -220,14 +223,14 @@ fun BackupHelpCard() {
             
             val permissions = remember {
                 listOf(
-                    "读取短信 (${Manifest.permission.READ_SMS})" to "用于备份短信内容",
-                    "读取通话记录 (${Manifest.permission.READ_CALL_LOG})" to "用于备份通话历史",
-                    "存储空间 (${Manifest.permission.WRITE_EXTERNAL_STORAGE})" to "用于保存备份文件"
+                    R.string.permission_sms_backup_title to R.string.permission_sms_backup_body,
+                    R.string.permission_call_backup_title to R.string.permission_call_backup_body,
+                    R.string.permission_contacts_backup_title to R.string.permission_contacts_backup_body
                 )
             }
             
             LazyColumn {
-                items(permissions) { (permission, description) ->
+                items(permissions) { (permissionRes, descriptionRes) ->
                     Row(
                         modifier = Modifier
                             .fillMaxWidth()
@@ -245,12 +248,12 @@ fun BackupHelpCard() {
                         
                         Column {
                             Text(
-                                text = permission,
+                                text = stringResource(permissionRes),
                                 style = MaterialTheme.typography.titleSmall
                             )
                             
                             Text(
-                                text = description,
+                                text = stringResource(descriptionRes),
                                 style = MaterialTheme.typography.bodySmall
                             )
                         }
@@ -288,12 +291,12 @@ fun BackupHelpCard() {
 @Preview(showBackground = true)
 @Composable
 fun BackupScreenPreview() {
-    MessageVaultTheme {
+    CommoryTheme {
         BackupScreen(
             permissionsGranted = true,
             isOperating = false,
-            backupStatus = "上次备份：2023-01-01 12:00",
+            backupStatus = UiText.Dynamic("上次备份：2023-01-01 12:00"),
             onBackupClick = {}
         )
     }
-} 
\ No newline at end of file
+} 
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/ModeSelectionScreen.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/ModeSelectionScreen.kt
new file mode 100644
index 0000000..d4ae771
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/ModeSelectionScreen.kt
@@ -0,0 +1,104 @@
+package com.iskenkenya.commory.mobile.ui.screens
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Cloud
+import androidx.compose.material.icons.filled.Storage
+import androidx.compose.material3.Button
+import androidx.compose.material3.Card
+import androidx.compose.material3.CardDefaults
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedButton
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.style.TextAlign
+import androidx.compose.ui.unit.dp
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.runtime.RuntimeMode
+
+@Composable
+fun ModeSelectionScreen(
+    onSelectMode: (RuntimeMode) -> Unit
+) {
+    Column(
+        modifier = Modifier
+            .fillMaxSize()
+            .padding(24.dp),
+        horizontalAlignment = Alignment.CenterHorizontally,
+        verticalArrangement = Arrangement.Center
+    ) {
+        Text(
+            text = stringResource(R.string.mode_title),
+            style = MaterialTheme.typography.headlineMedium,
+            textAlign = TextAlign.Center
+        )
+        Spacer(modifier = Modifier.height(12.dp))
+        Text(
+            text = stringResource(R.string.mode_subtitle),
+            style = MaterialTheme.typography.bodyLarge,
+            textAlign = TextAlign.Center
+        )
+        Spacer(modifier = Modifier.height(24.dp))
+
+        ModeCard(
+            icon = { Icon(Icons.Default.Storage, contentDescription = null) },
+            title = stringResource(R.string.mode_local_title),
+            body = stringResource(R.string.mode_local_body),
+            action = {
+                Button(onClick = { onSelectMode(RuntimeMode.LOCAL_ONLY) }) {
+                    Text(stringResource(R.string.mode_use_local))
+                }
+            }
+        )
+        Spacer(modifier = Modifier.height(16.dp))
+        ModeCard(
+            icon = { Icon(Icons.Default.Cloud, contentDescription = null) },
+            title = stringResource(R.string.mode_server_title),
+            body = stringResource(R.string.mode_server_body),
+            action = {
+                OutlinedButton(onClick = { onSelectMode(RuntimeMode.COMMORY_SERVER) }) {
+                    Text(stringResource(R.string.mode_connect_server))
+                }
+            }
+        )
+    }
+}
+
+@Composable
+private fun ModeCard(
+    icon: @Composable () -> Unit,
+    title: String,
+    body: String,
+    action: @Composable () -> Unit
+) {
+    Card(
+        modifier = Modifier.fillMaxWidth(),
+        colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.surfaceVariant)
+    ) {
+        Column(modifier = Modifier.padding(18.dp)) {
+            Row(verticalAlignment = Alignment.CenterVertically) {
+                icon()
+                Text(
+                    text = title,
+                    style = MaterialTheme.typography.titleLarge,
+                    modifier = Modifier.padding(start = 12.dp)
+                )
+            }
+            Spacer(modifier = Modifier.height(8.dp))
+            Text(text = body, style = MaterialTheme.typography.bodyMedium)
+            Spacer(modifier = Modifier.height(14.dp))
+            action()
+        }
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/MoreScreen.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/MoreScreen.kt
new file mode 100644
index 0000000..86773d0
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/MoreScreen.kt
@@ -0,0 +1,351 @@
+package com.iskenkenya.commory.mobile.ui.screens
+
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.text.KeyboardOptions
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Cloud
+import androidx.compose.material.icons.filled.Info
+import androidx.compose.material.icons.filled.Language
+import androidx.compose.material.icons.filled.Lock
+import androidx.compose.material.icons.filled.Restore
+import androidx.compose.material.icons.filled.Storage
+import androidx.compose.material3.Button
+import androidx.compose.material3.Card
+import androidx.compose.material3.Divider
+import androidx.compose.material3.FilterChip
+import androidx.compose.material3.AlertDialog
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedButton
+import androidx.compose.material3.OutlinedTextField
+import androidx.compose.material3.Switch
+import androidx.compose.material3.Text
+import androidx.compose.material3.TextButton
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.input.KeyboardType
+import androidx.compose.ui.text.input.PasswordVisualTransformation
+import androidx.compose.ui.unit.dp
+import com.iskenkenya.commory.mobile.BuildConfig
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.runtime.AppEnvironment
+import com.iskenkenya.commory.mobile.runtime.AppLocaleOption
+import com.iskenkenya.commory.mobile.runtime.RuntimeMode
+import com.iskenkenya.commory.mobile.ui.model.resolve
+import com.iskenkenya.commory.mobile.ui.viewmodels.ServerAuthUiState
+
+@Composable
+fun MoreScreen(
+    environment: AppEnvironment,
+    serverAuthState: ServerAuthUiState,
+    onModeChange: (RuntimeMode) -> Unit,
+    onLocaleChange: (AppLocaleOption) -> Unit,
+    onSyncOnBackupChange: (Boolean) -> Unit,
+    onServerUrlChange: (String) -> Unit,
+    onCheckServer: () -> Unit,
+    onLogin: (String, String) -> Unit,
+    onRegister: (String, String, String) -> Unit,
+    onLogout: () -> Unit,
+    onNavigateToRestore: () -> Unit = {}
+) {
+    Column(
+        modifier = Modifier
+            .fillMaxSize()
+            .padding(16.dp)
+    ) {
+        Text(
+            text = stringResource(id = R.string.more_tab),
+            style = MaterialTheme.typography.headlineMedium,
+            modifier = Modifier.padding(bottom = 16.dp)
+        )
+
+        QuickActionsCard(onNavigateToRestore)
+        Spacer(modifier = Modifier.height(12.dp))
+        GeneralSettingsCard(environment, onLocaleChange)
+        Spacer(modifier = Modifier.height(12.dp))
+        ServerSettingsCard(
+            environment = environment,
+            authState = serverAuthState,
+            onModeChange = onModeChange,
+            onSyncOnBackupChange = onSyncOnBackupChange,
+            onServerUrlChange = onServerUrlChange,
+            onCheckServer = onCheckServer,
+            onLogin = onLogin,
+            onRegister = onRegister,
+            onLogout = onLogout
+        )
+        Spacer(modifier = Modifier.height(12.dp))
+        PrivacyAndStorageCard()
+        Spacer(modifier = Modifier.height(12.dp))
+        AboutCard()
+    }
+}
+
+@Composable
+private fun QuickActionsCard(onNavigateToRestore: () -> Unit) {
+    Card(modifier = Modifier.fillMaxWidth()) {
+        Column(modifier = Modifier.padding(16.dp)) {
+            SectionTitle(icon = Icons.Default.Restore, title = stringResource(R.string.quick_actions))
+            Spacer(modifier = Modifier.height(8.dp))
+            Button(onClick = onNavigateToRestore, modifier = Modifier.fillMaxWidth()) {
+                Text(text = stringResource(id = R.string.restore_button))
+            }
+        }
+    }
+}
+
+@Composable
+private fun GeneralSettingsCard(
+    environment: AppEnvironment,
+    onLocaleChange: (AppLocaleOption) -> Unit
+) {
+    Card(modifier = Modifier.fillMaxWidth()) {
+        Column(modifier = Modifier.padding(16.dp)) {
+            SectionTitle(icon = Icons.Default.Language, title = stringResource(R.string.general_settings))
+            Spacer(modifier = Modifier.height(8.dp))
+            Text(text = stringResource(R.string.language_settings), style = MaterialTheme.typography.titleMedium)
+            Row(modifier = Modifier.fillMaxWidth()) {
+                LocaleChip(AppLocaleOption.SYSTEM, environment.locale, onLocaleChange, R.string.language_system)
+                LocaleChip(AppLocaleOption.ZH_CN, environment.locale, onLocaleChange, R.string.language_zh)
+                LocaleChip(AppLocaleOption.EN, environment.locale, onLocaleChange, R.string.language_en)
+            }
+        }
+    }
+}
+
+@Composable
+private fun LocaleChip(
+    option: AppLocaleOption,
+    selected: AppLocaleOption,
+    onLocaleChange: (AppLocaleOption) -> Unit,
+    labelRes: Int
+) {
+    FilterChip(
+        selected = selected == option,
+        onClick = { onLocaleChange(option) },
+        label = { Text(stringResource(labelRes)) },
+        modifier = Modifier.padding(end = 8.dp)
+    )
+}
+
+@Composable
+private fun ServerSettingsCard(
+    environment: AppEnvironment,
+    authState: ServerAuthUiState,
+    onModeChange: (RuntimeMode) -> Unit,
+    onSyncOnBackupChange: (Boolean) -> Unit,
+    onServerUrlChange: (String) -> Unit,
+    onCheckServer: () -> Unit,
+    onLogin: (String, String) -> Unit,
+    onRegister: (String, String, String) -> Unit,
+    onLogout: () -> Unit
+) {
+    var serverUrl by remember(environment.serverUrl) { mutableStateOf(environment.serverUrl) }
+    var userName by remember { mutableStateOf("") }
+    var email by remember { mutableStateOf("") }
+    var password by remember { mutableStateOf("") }
+    var registering by remember { mutableStateOf(false) }
+    var pendingMode by remember { mutableStateOf<RuntimeMode?>(null) }
+    val message = authState.message.resolve()
+
+    pendingMode?.let { mode ->
+        AlertDialog(
+            onDismissRequest = { pendingMode = null },
+            title = { Text(stringResource(R.string.mode_switch_confirm_title)) },
+            text = {
+                Text(
+                    if (mode == RuntimeMode.LOCAL_ONLY) {
+                        stringResource(R.string.mode_switch_to_local_body)
+                    } else {
+                        stringResource(R.string.mode_switch_to_server_body)
+                    }
+                )
+            },
+            confirmButton = {
+                TextButton(
+                    onClick = {
+                        pendingMode = null
+                        onModeChange(mode)
+                    }
+                ) {
+                    Text(stringResource(R.string.mode_switch_confirm))
+                }
+            },
+            dismissButton = {
+                TextButton(onClick = { pendingMode = null }) {
+                    Text(stringResource(R.string.cancel))
+                }
+            }
+        )
+    }
+
+    Card(modifier = Modifier.fillMaxWidth()) {
+        Column(modifier = Modifier.padding(16.dp)) {
+            SectionTitle(icon = Icons.Default.Cloud, title = stringResource(R.string.server_settings))
+            Spacer(modifier = Modifier.height(8.dp))
+            Row {
+                FilterChip(
+                    selected = environment.mode == RuntimeMode.LOCAL_ONLY,
+                    onClick = {
+                        if (environment.mode != RuntimeMode.LOCAL_ONLY) {
+                            pendingMode = RuntimeMode.LOCAL_ONLY
+                        }
+                    },
+                    label = { Text(stringResource(R.string.mode_local_title)) },
+                    modifier = Modifier.padding(end = 8.dp)
+                )
+                FilterChip(
+                    selected = environment.mode == RuntimeMode.COMMORY_SERVER,
+                    onClick = {
+                        if (environment.mode != RuntimeMode.COMMORY_SERVER) {
+                            pendingMode = RuntimeMode.COMMORY_SERVER
+                        }
+                    },
+                    label = { Text(stringResource(R.string.mode_server_title)) }
+                )
+            }
+
+            if (environment.mode == RuntimeMode.COMMORY_SERVER) {
+                Spacer(modifier = Modifier.height(12.dp))
+                OutlinedTextField(
+                    value = serverUrl,
+                    onValueChange = {
+                        serverUrl = it
+                        onServerUrlChange(it)
+                    },
+                    modifier = Modifier.fillMaxWidth(),
+                    label = { Text(stringResource(R.string.server_url)) },
+                    singleLine = true
+                )
+                Spacer(modifier = Modifier.height(8.dp))
+                Row {
+                    OutlinedButton(onClick = onCheckServer, enabled = !authState.busy) {
+                        Text(stringResource(R.string.check_server))
+                    }
+                    TextButton(onClick = { onSyncOnBackupChange(!environment.syncOnBackup) }) {
+                        Text(
+                            if (environment.syncOnBackup) stringResource(R.string.sync_enabled)
+                            else stringResource(R.string.sync_disabled)
+                        )
+                    }
+                }
+                Spacer(modifier = Modifier.height(8.dp))
+                Row(modifier = Modifier.fillMaxWidth()) {
+                    Text(
+                        text = stringResource(R.string.sync_on_backup),
+                        style = MaterialTheme.typography.bodyLarge,
+                        modifier = Modifier.weight(1f)
+                    )
+                    Switch(checked = environment.syncOnBackup, onCheckedChange = onSyncOnBackupChange)
+                }
+                Divider(modifier = Modifier.padding(vertical = 10.dp))
+                if (environment.authSession.isAuthenticated) {
+                    Text(
+                        text = stringResource(
+                            R.string.signed_in_as,
+                            environment.authSession.userName ?: environment.authSession.email ?: environment.authSession.userId.orEmpty()
+                        ),
+                        style = MaterialTheme.typography.bodyMedium
+                    )
+                    TextButton(onClick = onLogout) {
+                        Text(stringResource(R.string.logout))
+                    }
+                } else {
+                    Text(
+                        text = if (registering) stringResource(R.string.create_account) else stringResource(R.string.sign_in),
+                        style = MaterialTheme.typography.titleMedium
+                    )
+                    OutlinedTextField(
+                        value = userName,
+                        onValueChange = { userName = it },
+                        modifier = Modifier.fillMaxWidth(),
+                        label = { Text(stringResource(R.string.username)) },
+                        singleLine = true
+                    )
+                    if (registering) {
+                        OutlinedTextField(
+                            value = email,
+                            onValueChange = { email = it },
+                            modifier = Modifier.fillMaxWidth(),
+                            label = { Text(stringResource(R.string.email)) },
+                            singleLine = true,
+                            keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Email)
+                        )
+                    }
+                    OutlinedTextField(
+                        value = password,
+                        onValueChange = { password = it },
+                        modifier = Modifier.fillMaxWidth(),
+                        label = { Text(stringResource(R.string.password)) },
+                        singleLine = true,
+                        visualTransformation = PasswordVisualTransformation()
+                    )
+                    Row {
+                        Button(
+                            onClick = {
+                                if (registering) onRegister(userName, email, password) else onLogin(userName, password)
+                            },
+                            enabled = userName.isNotBlank() && password.isNotBlank() && (!registering || email.isNotBlank())
+                        ) {
+                            Text(if (registering) stringResource(R.string.register) else stringResource(R.string.login))
+                        }
+                        TextButton(onClick = { registering = !registering }) {
+                            Text(if (registering) stringResource(R.string.have_account) else stringResource(R.string.need_account))
+                        }
+                    }
+                }
+                if (!message.isNullOrBlank()) {
+                    Text(text = message, style = MaterialTheme.typography.bodyMedium)
+                }
+            }
+        }
+    }
+}
+
+@Composable
+private fun PrivacyAndStorageCard() {
+    Card(modifier = Modifier.fillMaxWidth()) {
+        Column(modifier = Modifier.padding(16.dp)) {
+            SectionTitle(icon = Icons.Default.Lock, title = stringResource(R.string.privacy_permissions))
+            Spacer(modifier = Modifier.height(8.dp))
+            Text(text = stringResource(R.string.backup_permissions_summary), style = MaterialTheme.typography.bodyMedium)
+            Spacer(modifier = Modifier.height(6.dp))
+            SectionTitle(icon = Icons.Default.Storage, title = stringResource(R.string.storage_settings))
+            Text(text = stringResource(R.string.storage_summary), style = MaterialTheme.typography.bodyMedium)
+        }
+    }
+}
+
+@Composable
+private fun AboutCard() {
+    Card(modifier = Modifier.fillMaxWidth()) {
+        Column(modifier = Modifier.padding(16.dp)) {
+            SectionTitle(icon = Icons.Default.Info, title = stringResource(R.string.about))
+            Spacer(modifier = Modifier.height(8.dp))
+            Text(text = stringResource(R.string.app_name), style = MaterialTheme.typography.titleMedium)
+            Text(text = stringResource(R.string.version_format, BuildConfig.VERSION_NAME))
+            Text(text = stringResource(R.string.app_about_body), style = MaterialTheme.typography.bodyMedium)
+        }
+    }
+}
+
+@Composable
+private fun SectionTitle(
+    icon: androidx.compose.ui.graphics.vector.ImageVector,
+    title: String
+) {
+    Row {
+        androidx.compose.material3.Icon(icon, contentDescription = null, modifier = Modifier.padding(end = 8.dp))
+        Text(text = title, style = MaterialTheme.typography.titleLarge)
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/PreviewScreen.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/PreviewScreen.kt
similarity index 98%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/screens/PreviewScreen.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/PreviewScreen.kt
index 32582cb..890561d 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/PreviewScreen.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/PreviewScreen.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.screens
+package com.iskenkenya.commory.mobile.ui.screens
 
 import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.*
@@ -16,7 +16,7 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.unit.dp
-import imken.messagevault.mobile.R
+import com.iskenkenya.commory.mobile.R
 
 /**
  * 预览屏幕
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/RestoreScreen.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/RestoreScreen.kt
similarity index 98%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/screens/RestoreScreen.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/RestoreScreen.kt
index c1ed5d0..393b514 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/RestoreScreen.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/RestoreScreen.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.screens
+package com.iskenkenya.commory.mobile.ui.screens
 
 import androidx.compose.foundation.layout.*
 import androidx.compose.foundation.lazy.LazyColumn
@@ -20,10 +20,10 @@ import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.text.style.TextOverflow
 import androidx.compose.ui.unit.dp
 import androidx.lifecycle.viewmodel.compose.viewModel
-import imken.messagevault.mobile.R
-import imken.messagevault.mobile.models.BackupFile
-import imken.messagevault.mobile.ui.viewmodels.RestoreViewModel
-import imken.messagevault.mobile.MainActivity
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.models.BackupFile
+import com.iskenkenya.commory.mobile.ui.viewmodels.RestoreViewModel
+import com.iskenkenya.commory.mobile.MainActivity
 import java.text.SimpleDateFormat
 import java.util.*
 import kotlinx.coroutines.flow.StateFlow
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/Screen.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/Screen.kt
similarity index 91%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/screens/Screen.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/Screen.kt
index b6fd410..42995fd 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/Screen.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/Screen.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.screens
+package com.iskenkenya.commory.mobile.ui.screens
 
 sealed class Screen(val route: String) {
     object Home : Screen("home")
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/ServerSetupScreen.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/ServerSetupScreen.kt
new file mode 100644
index 0000000..5d72bcd
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/screens/ServerSetupScreen.kt
@@ -0,0 +1,147 @@
+package com.iskenkenya.commory.mobile.ui.screens
+
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.text.KeyboardOptions
+import androidx.compose.material3.Button
+import androidx.compose.material3.Card
+import androidx.compose.material3.CircularProgressIndicator
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedButton
+import androidx.compose.material3.OutlinedTextField
+import androidx.compose.material3.Text
+import androidx.compose.material3.TextButton
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.input.KeyboardType
+import androidx.compose.ui.text.input.PasswordVisualTransformation
+import androidx.compose.ui.unit.dp
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.runtime.AppEnvironment
+import com.iskenkenya.commory.mobile.ui.model.resolve
+import com.iskenkenya.commory.mobile.ui.viewmodels.ServerAuthUiState
+
+@Composable
+fun ServerSetupScreen(
+    environment: AppEnvironment,
+    authState: ServerAuthUiState,
+    onServerUrlChange: (String) -> Unit,
+    onCheckServer: () -> Unit,
+    onLogin: (String, String) -> Unit,
+    onRegister: (String, String, String) -> Unit,
+    onUseLocal: () -> Unit
+) {
+    var serverUrl by remember(environment.serverUrl) { mutableStateOf(environment.serverUrl) }
+    var userName by remember { mutableStateOf("") }
+    var email by remember { mutableStateOf("") }
+    var password by remember { mutableStateOf("") }
+    var registering by remember { mutableStateOf(false) }
+    val message = authState.message.resolve()
+
+    Column(
+        modifier = Modifier
+            .fillMaxSize()
+            .padding(20.dp)
+    ) {
+        Text(text = stringResource(R.string.server_setup_title), style = MaterialTheme.typography.headlineMedium)
+        Spacer(modifier = Modifier.height(8.dp))
+        Text(text = stringResource(R.string.server_setup_body), style = MaterialTheme.typography.bodyMedium)
+        Spacer(modifier = Modifier.height(20.dp))
+
+        Card(modifier = Modifier.fillMaxWidth()) {
+            Column(modifier = Modifier.padding(16.dp)) {
+                OutlinedTextField(
+                    value = serverUrl,
+                    onValueChange = {
+                        serverUrl = it
+                        onServerUrlChange(it)
+                    },
+                    modifier = Modifier.fillMaxWidth(),
+                    label = { Text(stringResource(R.string.server_url)) },
+                    singleLine = true
+                )
+                Spacer(modifier = Modifier.height(12.dp))
+                OutlinedButton(
+                    onClick = onCheckServer,
+                    enabled = !authState.busy
+                ) {
+                    Text(stringResource(R.string.check_server))
+                }
+            }
+        }
+
+        Spacer(modifier = Modifier.height(16.dp))
+        Card(modifier = Modifier.fillMaxWidth()) {
+            Column(modifier = Modifier.padding(16.dp)) {
+                Text(
+                    text = if (registering) stringResource(R.string.create_account) else stringResource(R.string.sign_in),
+                    style = MaterialTheme.typography.titleLarge
+                )
+                Spacer(modifier = Modifier.height(10.dp))
+                OutlinedTextField(
+                    value = userName,
+                    onValueChange = { userName = it },
+                    modifier = Modifier.fillMaxWidth(),
+                    label = { Text(stringResource(R.string.username)) },
+                    singleLine = true
+                )
+                if (registering) {
+                    Spacer(modifier = Modifier.height(8.dp))
+                    OutlinedTextField(
+                        value = email,
+                        onValueChange = { email = it },
+                        modifier = Modifier.fillMaxWidth(),
+                        label = { Text(stringResource(R.string.email)) },
+                        singleLine = true,
+                        keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Email)
+                    )
+                }
+                Spacer(modifier = Modifier.height(8.dp))
+                OutlinedTextField(
+                    value = password,
+                    onValueChange = { password = it },
+                    modifier = Modifier.fillMaxWidth(),
+                    label = { Text(stringResource(R.string.password)) },
+                    singleLine = true,
+                    visualTransformation = PasswordVisualTransformation()
+                )
+                Spacer(modifier = Modifier.height(12.dp))
+                Row {
+                    Button(
+                        onClick = {
+                            if (registering) onRegister(userName, email, password) else onLogin(userName, password)
+                        },
+                        enabled = !authState.busy && userName.isNotBlank() && password.isNotBlank() && (!registering || email.isNotBlank())
+                    ) {
+                        if (authState.busy) {
+                            CircularProgressIndicator(modifier = Modifier.padding(end = 8.dp), strokeWidth = 2.dp)
+                        }
+                        Text(if (registering) stringResource(R.string.register) else stringResource(R.string.login))
+                    }
+                    TextButton(onClick = { registering = !registering }) {
+                        Text(if (registering) stringResource(R.string.have_account) else stringResource(R.string.need_account))
+                    }
+                }
+                if (!message.isNullOrBlank()) {
+                    Spacer(modifier = Modifier.height(8.dp))
+                    Text(text = message, style = MaterialTheme.typography.bodyMedium)
+                }
+            }
+        }
+
+        Spacer(modifier = Modifier.height(16.dp))
+        TextButton(onClick = onUseLocal) {
+            Text(stringResource(R.string.mode_use_local))
+        }
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/theme/Color.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Color.kt
similarity index 95%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/theme/Color.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Color.kt
index 1883cc5..5a7f1d6 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/theme/Color.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Color.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.theme
+package com.iskenkenya.commory.mobile.ui.theme
 
 import androidx.compose.ui.graphics.Color
 
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/theme/Theme.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Theme.kt
similarity index 98%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/theme/Theme.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Theme.kt
index 56c731b..d065c7e 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/theme/Theme.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Theme.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.theme
+package com.iskenkenya.commory.mobile.ui.theme
 
 import android.app.Activity
 import android.os.Build
@@ -67,7 +67,7 @@ private val LightColorScheme = lightColorScheme(
  * @param content 需要应用主题的内容
  */
 @Composable
-fun MessageVaultTheme(
+fun CommoryTheme(
     darkTheme: Boolean = isSystemInDarkTheme(),
     dynamicColor: Boolean = true,
     content: @Composable () -> Unit
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/theme/Typography.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Typography.kt
similarity index 96%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/theme/Typography.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Typography.kt
index c36b2c6..8a0e6ff 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/theme/Typography.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/theme/Typography.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.theme
+package com.iskenkenya.commory.mobile.ui.theme
 
 import androidx.compose.material3.Typography
 import androidx.compose.ui.text.TextStyle
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/AppViewModel.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/AppViewModel.kt
new file mode 100644
index 0000000..4840ba7
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/AppViewModel.kt
@@ -0,0 +1,139 @@
+package com.iskenkenya.commory.mobile.ui.viewmodels
+
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.ViewModelProvider
+import androidx.lifecycle.viewModelScope
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.di.AppContainer
+import com.iskenkenya.commory.mobile.remote.CommoryServerClient
+import com.iskenkenya.commory.mobile.runtime.AppEnvironment
+import com.iskenkenya.commory.mobile.runtime.AppEnvironmentManager
+import com.iskenkenya.commory.mobile.runtime.AppLocaleOption
+import com.iskenkenya.commory.mobile.runtime.AuthSession
+import com.iskenkenya.commory.mobile.runtime.RuntimeMode
+import com.iskenkenya.commory.mobile.ui.model.UiText
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.SharingStarted
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.flow.stateIn
+import kotlinx.coroutines.launch
+
+data class ServerAuthUiState(
+    val busy: Boolean = false,
+    val message: UiText? = null,
+    val serverHealthy: Boolean = false
+)
+
+class AppViewModel(
+    private val environmentManager: AppEnvironmentManager,
+    private val serverClient: CommoryServerClient
+) : ViewModel() {
+    val environment: StateFlow<AppEnvironment> = environmentManager.environment.stateIn(
+        scope = viewModelScope,
+        started = SharingStarted.Eagerly,
+        initialValue = environmentManager.currentSnapshot()
+    )
+
+    private val _serverAuthState = MutableStateFlow(ServerAuthUiState())
+    val serverAuthState: StateFlow<ServerAuthUiState> = _serverAuthState.asStateFlow()
+
+    fun selectMode(mode: RuntimeMode) {
+        viewModelScope.launch {
+            environmentManager.selectMode(mode)
+            if (mode == RuntimeMode.LOCAL_ONLY) {
+                environmentManager.clearSession()
+            }
+        }
+    }
+
+    fun updateServerUrl(serverUrl: String) {
+        viewModelScope.launch {
+            environmentManager.updateServerUrl(serverUrl)
+            _serverAuthState.value = _serverAuthState.value.copy(serverHealthy = false, message = null)
+        }
+    }
+
+    fun updateLocale(locale: AppLocaleOption) {
+        viewModelScope.launch {
+            environmentManager.updateLocale(locale)
+        }
+    }
+
+    fun updateSyncOnBackup(enabled: Boolean) {
+        viewModelScope.launch {
+            environmentManager.updateSyncOnBackup(enabled)
+        }
+    }
+
+    fun checkServer(baseUrl: String = environment.value.serverUrl) {
+        viewModelScope.launch {
+            _serverAuthState.value = ServerAuthUiState(busy = true)
+            val result = serverClient.checkSetup(baseUrl)
+            _serverAuthState.value = if (result.isSuccess) {
+                ServerAuthUiState(
+                    serverHealthy = true,
+                    message = UiText.Resource(R.string.server_check_success)
+                )
+            } else {
+                ServerAuthUiState(
+                    serverHealthy = false,
+                    message = UiText.Resource(R.string.server_check_failed, listOf(result.exceptionOrNull()?.message.orEmpty()))
+                )
+            }
+        }
+    }
+
+    fun login(userName: String, password: String) {
+        viewModelScope.launch {
+            _serverAuthState.value = _serverAuthState.value.copy(busy = true, message = null)
+            val env = environment.value
+            val result = serverClient.login(env.serverUrl, userName, password)
+            persistAuthResult(result)
+        }
+    }
+
+    fun register(userName: String, email: String, password: String) {
+        viewModelScope.launch {
+            _serverAuthState.value = _serverAuthState.value.copy(busy = true, message = null)
+            val env = environment.value
+            val result = serverClient.register(env.serverUrl, userName, email, password)
+            persistAuthResult(result)
+        }
+    }
+
+    fun logout() {
+        viewModelScope.launch {
+            serverClient.logoutPersistedSession().getOrElse {
+                environmentManager.clearSession()
+            }
+            _serverAuthState.value = ServerAuthUiState(message = UiText.Resource(R.string.logged_out))
+        }
+    }
+
+    private suspend fun persistAuthResult(result: Result<AuthSession>) {
+        if (result.isSuccess) {
+            val session = result.getOrThrow()
+            environmentManager.updateSession(session)
+            _serverAuthState.value = ServerAuthUiState(
+                serverHealthy = true,
+                message = UiText.Resource(R.string.auth_success)
+            )
+        } else {
+            _serverAuthState.value = ServerAuthUiState(
+                busy = false,
+                message = UiText.Resource(R.string.auth_failed, listOf(result.exceptionOrNull()?.message.orEmpty()))
+            )
+        }
+    }
+
+    class Factory(private val container: AppContainer) : ViewModelProvider.Factory {
+        @Suppress("UNCHECKED_CAST")
+        override fun <T : ViewModel> create(modelClass: Class<T>): T {
+            if (modelClass.isAssignableFrom(AppViewModel::class.java)) {
+                return AppViewModel(container.environmentManager, container.serverClient) as T
+            }
+            throw IllegalArgumentException("Unknown ViewModel class")
+        }
+    }
+}
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/BackupViewModel.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/BackupViewModel.kt
new file mode 100644
index 0000000..717adfe
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/BackupViewModel.kt
@@ -0,0 +1,180 @@
+package com.iskenkenya.commory.mobile.ui.viewmodels
+
+import android.content.Context
+import android.os.Build
+import android.provider.Settings
+import androidx.compose.runtime.mutableStateOf
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.ViewModelProvider
+import androidx.lifecycle.viewModelScope
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsWriter
+import com.iskenkenya.commory.mobile.BuildConfig
+import com.iskenkenya.commory.mobile.di.AppContainer
+import com.iskenkenya.commory.mobile.remote.CommoryServerClient
+import com.iskenkenya.commory.mobile.runtime.AppEnvironmentManager
+import com.iskenkenya.commory.mobile.runtime.RuntimeModePolicy
+import com.iskenkenya.commory.mobile.ui.model.UiText
+import com.iskenkenya.commory.sdk.backup.BackupManager
+import kotlinx.coroutines.CoroutineDispatcher
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.launch
+import timber.log.Timber
+
+class BackupViewModel(
+    private val backupManager: BackupManager,
+    private val deviceIdProvider: () -> String,
+    private val environmentManager: AppEnvironmentManager? = null,
+    private val serverClient: CommoryServerClient? = null,
+    private val dispatcher: CoroutineDispatcher = Dispatchers.IO
+) : ViewModel() {
+
+    private val TAG = "BackupViewModel"
+    
+    private val _permissionsGranted = mutableStateOf(false)
+    
+    private val _isOperating = mutableStateOf(false)
+    
+    private val _backupStatus = mutableStateOf<UiText?>(null)
+    
+    fun getPermissionsGranted(): Boolean = _permissionsGranted.value
+    fun isOperating(): Boolean = _isOperating.value
+    fun getBackupStatus(): UiText? = _backupStatus.value
+    
+    fun setPermissionsGranted(granted: Boolean) {
+        _permissionsGranted.value = granted
+    }
+    
+    fun startBackup() {
+        if (!_permissionsGranted.value) {
+            _backupStatus.value = UiText.Resource(R.string.backup_error_permissions)
+            return
+        }
+        
+        if (_isOperating.value) {
+            Timber.d("[Mobile] DEBUG [Backup] 备份操作已在进行中")
+            return
+        }
+        
+        _isOperating.value = true
+        _backupStatus.value = UiText.Resource(R.string.backup_status_preparing)
+        
+        viewModelScope.launch(dispatcher) {
+            try {
+                val deviceInfo = "${Build.MANUFACTURER} ${Build.MODEL}"
+                val environment = environmentManager?.currentSnapshot()
+                val result = backupManager.performBackup(
+                    hasSmsPermission = true,
+                    hasCallLogPermission = true,
+                    hasContactsPermission = true,
+                    deviceInfo = deviceInfo,
+                    deviceId = deviceIdProvider(),
+                    appVersion = BuildConfig.VERSION_NAME
+                )
+                if (result.success) {
+                    var remoteUploaded = false
+                    val accessToken = environment?.authSession?.accessToken
+                    val filePath = result.filePath
+                    if (environment != null &&
+                        RuntimeModePolicy.canUploadBackup(environment) &&
+                        accessToken != null &&
+                        filePath != null &&
+                        serverClient != null
+                    ) {
+                        _backupStatus.value = UiText.Resource(R.string.backup_status_uploading)
+                        remoteUploaded = serverClient.uploadImport(
+                            baseUrl = environment.serverUrl,
+                            accessToken = accessToken,
+                            file = java.io.File(filePath)
+                        ).isSuccess
+                    }
+                    _backupStatus.value = if (remoteUploaded) {
+                        UiText.Resource(
+                            R.string.backup_success_remote,
+                            listOf(result.smsCount, result.callLogCount)
+                        )
+                    } else {
+                        UiText.Resource(
+                            R.string.backup_success_local,
+                            listOf(result.smsCount, result.callLogCount)
+                        )
+                    }
+                } else {
+                    _backupStatus.value = UiText.Resource(
+                        R.string.backup_failed_with_reason,
+                        listOf(result.errorMessage.orEmpty())
+                    )
+                }
+            } catch (e: Exception) {
+                Timber.e(e, "[Mobile] ERROR [Backup] 备份失败")
+                _backupStatus.value = UiText.Resource(
+                    R.string.backup_failed_with_reason,
+                    listOf(e.message.orEmpty())
+                )
+            } finally {
+                _isOperating.value = false
+            }
+        }
+    }
+    
+    class Factory(private val context: Context) : ViewModelProvider.Factory {
+        @Suppress("UNCHECKED_CAST")
+        override fun <T : ViewModel> create(modelClass: Class<T>): T {
+            if (modelClass.isAssignableFrom(BackupViewModel::class.java)) {
+                val backupManager = BackupManager(
+                    smsReader = AndroidSmsReader(context),
+                    callLogReader = AndroidCallLogReader(context),
+                    contactReader = AndroidContactReader(context),
+                    backupFileWriter = AndroidBackupFileWriter(context),
+                    backupFileReader = AndroidBackupFileReader(context),
+                    smsWriter = AndroidSmsWriter(context),
+                    callLogWriter = AndroidCallLogWriter(context),
+                    contactWriter = AndroidContactWriter(context)
+                )
+                return BackupViewModel(
+                    backupManager = backupManager,
+                    deviceIdProvider = {
+                        Settings.Secure.getString(
+                            context.contentResolver,
+                            Settings.Secure.ANDROID_ID
+                        ) ?: "unknown-device"
+                    }
+                ) as T
+            }
+            throw IllegalArgumentException("Unknown ViewModel class")
+        }
+    }
+
+    class ContainerFactory(
+        private val context: Context,
+        private val container: AppContainer
+    ) : ViewModelProvider.Factory {
+        @Suppress("UNCHECKED_CAST")
+        override fun <T : ViewModel> create(modelClass: Class<T>): T {
+            if (modelClass.isAssignableFrom(BackupViewModel::class.java)) {
+                return BackupViewModel(
+                    backupManager = container.createBackupManager(),
+                    deviceIdProvider = {
+                        Settings.Secure.getString(
+                            context.contentResolver,
+                            Settings.Secure.ANDROID_ID
+                        ) ?: "unknown-device"
+                    },
+                    environmentManager = container.environmentManager,
+                    serverClient = container.serverClient
+                ) as T
+            }
+            throw IllegalArgumentException("Unknown ViewModel class")
+        }
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/viewmodels/RestoreViewModel.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/RestoreViewModel.kt
similarity index 57%
rename from android/app/src/main/java/imken/messagevault/mobile/ui/viewmodels/RestoreViewModel.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/RestoreViewModel.kt
index 8900dc2..d48a579 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/viewmodels/RestoreViewModel.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/ui/viewmodels/RestoreViewModel.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.ui.viewmodels
+package com.iskenkenya.commory.mobile.ui.viewmodels
 
 import android.content.Context
 import android.os.Build
@@ -7,11 +7,22 @@ import androidx.compose.runtime.mutableStateOf
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.ViewModelProvider
 import androidx.lifecycle.viewModelScope
-import imken.messagevault.mobile.api.ApiClient
-import imken.messagevault.mobile.config.Config
-import imken.messagevault.mobile.data.RestoreManager
-import imken.messagevault.mobile.models.BackupFile
-import imken.messagevault.mobile.models.RestoreState
+import com.iskenkenya.commory.mobile.api.ApiClient
+import com.iskenkenya.commory.mobile.config.Config
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsWriter
+import com.iskenkenya.commory.mobile.data.backup.RestorePermissionHelper
+import com.iskenkenya.commory.mobile.models.BackupFile
+import com.iskenkenya.commory.mobile.models.RestoreState
+import com.iskenkenya.commory.sdk.backup.RestoreManager
+import com.iskenkenya.commory.sdk.backup.model.BackupData
+import com.iskenkenya.commory.sdk.backup.model.BackupReadData
+import com.iskenkenya.commory.sdk.backup.model.CallLog
+import com.iskenkenya.commory.sdk.backup.model.Contact
+import com.iskenkenya.commory.sdk.backup.model.Message
+import com.iskenkenya.commory.sdk.backup.model.RestoreOptions
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
@@ -19,106 +30,58 @@ import kotlinx.coroutines.flow.asStateFlow
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 import timber.log.Timber
+import java.io.File
 import java.util.Date
 
-/**
- * 恢复功能视图模型
- * 
- * 管理恢复屏幕的状态和业务逻辑，遵循MVVM架构模式
- * 
- * @param context 应用上下文
- */
 class RestoreViewModel(
     private val context: Context,
-    private val restoreManager: RestoreManager
+    private val restoreManager: RestoreManager,
+    private val config: Config,
+    private val apiClient: ApiClient
 ) : ViewModel() {
-    
-    // 组件依赖
-    private val config = Config.getInstance(context)
-    private val apiClient = ApiClient(config) 
-    
-    // 备份文件列表
+
+    private val backupFileReader = AndroidBackupFileReader(context)
+
     private val _backupFiles = MutableStateFlow<List<BackupFile>>(emptyList())
     val backupFiles: StateFlow<List<BackupFile>> = _backupFiles.asStateFlow()
     
-    // 选中的备份文件
     private val _selectedBackupFile = MutableStateFlow<BackupFile?>(null)
     val selectedBackupFile: StateFlow<BackupFile?> = _selectedBackupFile.asStateFlow()
     
-    // 恢复状态信息
     val restoreStatus = mutableStateOf<String?>(null)
     
-    // 操作进行中状态
     val isOperating = mutableStateOf(false)
     
-    // 权限授予状态
     val permissionsGranted = mutableStateOf(false)
     
-    // 恢复状态
     private val _restoreState = MutableStateFlow<RestoreState>(RestoreState.Idle)
     val restoreState: StateFlow<RestoreState> = _restoreState.asStateFlow()
 
-    // 恢复进度
     private val _restoreProgress = MutableStateFlow(0)
     val restoreProgress: StateFlow<Int> = _restoreProgress.asStateFlow()
     
-    // 是否需要设置为默认短信应用
-    /**
-     * 是否需要设置为默认短信应用的状态标志
-     * 
-     * 此状态用于控制是否显示"需要设置为默认短信应用"的提示对话框。当用户尝试恢复包含短信的备份，
-     * 但应用尚未被设置为默认短信应用时，此状态会被设置为 true。
-     * 
-     * 状态值说明:
-     * - true: 表示需要向用户显示权限请求对话框，应用需要成为默认短信应用才能继续
-     * - false: 表示不需要显示权限请求对话框，可以直接进行恢复操作
-     * 
-     * 更新时机:
-     * - 在 restoreBackupFile 方法中检测到需要默认短信权限时设置为 true
-     * - 用户拒绝设置为默认短信应用后，保持为 true
-     * - 用户同意设置为默认短信应用且设置成功后，设置为 false
-     * - 用户取消权限请求对话框后，设置为 false
-     * 
-     * 与 MainActivity 交互:
-     * MainActivity 可以通过 notifyDefaultSmsAppChanged 方法通知 ViewModel 更新此状态
-     */
     val needDefaultSmsApp = mutableStateOf(false)
     
-    // 强制覆盖默认短信应用状态的标记，用于处理系统返回不一致的情况
     private var forceDefaultSmsAppStatus: Boolean? = null
     
-    // 恢复的阶段说明
     val restorePhase = mutableStateOf<String?>(null)
     
     private val TAG = "RestoreViewModel"
     
-    /**
-     * 初始化视图模型
-     * 
-     * 加载可用的备份文件
-     */
     init {
         loadBackupFiles()
     }
     
-    /**
-     * 直接通知默认短信应用状态变化
-     * 用于从MainActivity强制更新状态
-     */
     fun notifyDefaultSmsAppChanged(isDefault: Boolean) {
         forceDefaultSmsAppStatus = isDefault
         Timber.i("[Mobile] INFO [Restore] 强制更新默认短信应用状态: isDefault=$isDefault")
         
-        // 如果已设为默认应用但仍显示需要权限，自动重置状态
         if (isDefault && needDefaultSmsApp.value) {
             needDefaultSmsApp.value = false
             Timber.i("[Mobile] INFO [Restore] 自动重置权限检查对话框，当前被强制设为默认短信应用")
         }
     }
     
-    /**
-     * 加载备份文件列表
-     */
     fun loadBackupFiles() {
         if (isOperating.value) {
             Timber.w("[Mobile] WARN [Restore] 已有操作正在进行中，跳过加载备份; Context: 用户请求重复操作")
@@ -129,12 +92,11 @@ class RestoreViewModel(
             try {
                 Timber.i("[Mobile] INFO [Restore] 开始加载备份文件; Context: 用户打开恢复页面")
                 
-                val files = restoreManager.getAvailableBackups()
+                val files = getAvailableBackups()
                 _backupFiles.value = files
                 
                 Timber.i("[Mobile] INFO [Restore] 加载备份文件完成; Context: 找到 ${files.size} 个备份文件")
                 
-                // 如果有备份文件，默认选择第一个
                 if (files.isNotEmpty() && _selectedBackupFile.value == null) {
                     _selectedBackupFile.value = files[0]
                 }
@@ -145,26 +107,12 @@ class RestoreViewModel(
         }
     }
     
-    /**
-     * 选择备份文件
-     * 
-     * @param backupFile 要选择的备份文件
-     */
     fun selectBackupFile(backupFile: BackupFile) {
         _selectedBackupFile.value = backupFile
         Timber.d("[Mobile] DEBUG [Restore] 选择了备份文件 ${backupFile.fileName}; Context: 用户操作")
     }
     
-    /**
-     * 恢复备份文件
-     * 
-     * 此方法负责从选定的备份文件恢复数据，包括短信、通话记录和联系人。
-     * 由于Android系统安全限制，恢复短信需要应用被设置为默认短信应用。
-     * 
-     * @param backupFile 要恢复的备份文件
-     */
     fun restoreBackupFile(backupFile: BackupFile) {
-        // 在日志中强制记录当前是否为默认短信应用
         val isDefault = isDefaultSmsApp()
         Timber.i("[Mobile] INFO [Restore] 开始恢复，是否为默认短信应用: $isDefault")
         
@@ -173,12 +121,7 @@ class RestoreViewModel(
             return
         }
         
-        // ===== 默认短信应用权限检查部分 =====
-        // 此部分代码负责检查是否需要默认短信应用权限，是权限流程的关键部分
-        // 如果需要更改此部分，请确保理解整个权限请求流程，并保持与MainActivity的交互逻辑
         try {
-            // 检查备份文件是否包含短信数据
-            // 注意：根据当前的BackupFile模型，我们直接使用filePath属性
             val backupFilePath = backupFile.filePath
             val jsonFile = java.io.File(backupFilePath)
             if (jsonFile.exists() && jsonFile.canRead()) {
@@ -187,30 +130,26 @@ class RestoreViewModel(
                 
                 Timber.d("[Mobile] DEBUG [Restore] 备份文件解析: 包含短信=${containsSms}, 是默认短信应用=${isDefault}")
                 
-                // 如果备份包含短信且应用不是默认短信应用，则需要请求权限
                 if (containsSms && !isDefault) {
                     Timber.w("[Mobile] WARN [Restore] 需要设置为默认短信应用; Context: 用户尝试恢复包含短信的备份")
                     needDefaultSmsApp.value = true
-                    return  // 终止恢复流程，等待用户授予权限
+                    return
                 }
             } else {
                 Timber.e("[Mobile] ERROR [Restore] 备份文件不存在或无法读取; Path: $backupFilePath")
                 if (!isDefault) {
                     needDefaultSmsApp.value = true
-                    return  // 如果无法确定是否包含短信，为安全起见假定包含，终止恢复流程
+                    return
                 }
             }
         } catch (e: Exception) {
             Timber.e(e, "[Mobile] ERROR [Restore] 检查备份文件是否包含短信时出错; Context: 预检查")
-            // 如果无法确定是否包含短信，为安全起见假定包含
             if (!isDefault) {
                 needDefaultSmsApp.value = true
-                return  // 终止恢复流程，等待用户授予权限
+                return
             }
         }
-        // ===== 默认短信应用权限检查部分结束 =====
         
-        // 忽略WAP推送权限问题，继续恢复
         Timber.i("[Mobile] INFO [Restore] 继续恢复过程，忽略WAP推送权限问题")
         
         viewModelScope.launch {
@@ -222,10 +161,9 @@ class RestoreViewModel(
             try {
                 Timber.i("%tFT%<tT.%<tLZ [Mobile] INFO [Restore] 开始恢复备份 ${backupFile.fileName}; Context: 用户操作", Date())
                 
-                // 解析备份文件内容以估算总工作量
                 restorePhase.value = "正在解析备份文件..."
                 _restoreProgress.value = 10
-                val backupData = restoreManager.parseBackupFile(backupFile)
+                val backupData = parseBackupFile(backupFile)
                 
                 if (backupData != null) {
                     val smsCount = backupData.messages?.size ?: 0
@@ -235,51 +173,30 @@ class RestoreViewModel(
                     Timber.i("[Mobile] INFO [Restore] 备份数据解析完成: SMS=$smsCount, CallLogs=$callLogsCount, Contacts=$contactsCount")
                     
                     _restoreProgress.value = 20
-                    
-                    // 更新恢复状态
                     restorePhase.value = "正在恢复短信、通话记录和联系人..."
                     _restoreState.value = RestoreState.InProgress(20, "正在恢复短信、通话记录和联系人...")
                     
-                    // 创建进度更新回调
-                    val progressCallback = object : RestoreManager.ProgressCallback {
-                        override fun onStart(operation: String) {
-                            restorePhase.value = operation
-                            _restoreState.value = RestoreState.InProgress(20, operation)
-                            Timber.d("[Mobile] DEBUG [Restore] 开始操作: $operation")
-                        }
-                        
-                        override fun onProgressUpdate(operation: String, progress: Int) {
-                            val calculatedProgress = 20 + (progress * 0.8).toInt() // 20% 到 100% 的范围
-                            _restoreProgress.value = calculatedProgress
-                            restorePhase.value = operation
-                            _restoreState.value = RestoreState.InProgress(calculatedProgress, operation)
-                            Timber.d("[Mobile] DEBUG [Restore] 进度更新: 阶段=$operation, 进度=$progress%")
-                        }
-                        
-                        override fun onProgressUpdate(operation: String, progress: Int, message: String) {
-                            val calculatedProgress = 20 + (progress * 0.8).toInt() // 20% 到 100% 的范围
-                            _restoreProgress.value = calculatedProgress
-                            restorePhase.value = "$operation: $message"
-                            _restoreState.value = RestoreState.InProgress(calculatedProgress, "$operation: $message")
-                            Timber.d("[Mobile] DEBUG [Restore] 进度更新: 阶段=$operation, 进度=$progress%, 详情=$message")
-                        }
-                        
-                        override fun onComplete(success: Boolean, message: String) {
-                            _restoreProgress.value = 100
-                            if (success) {
-                                restorePhase.value = "恢复完成"
-                                _restoreState.value = RestoreState.Completed(true, message)
-                                Timber.i("[Mobile] INFO [Restore] 恢复完成: $message")
-                            } else {
-                                restorePhase.value = "恢复失败"
-                                _restoreState.value = RestoreState.Error(message)
-                                Timber.e("[Mobile] ERROR [Restore] 恢复失败: $message")
-                            }
+                    val hasSms = !backupData.messages.isNullOrEmpty()
+                    val hasCallLogs = !backupData.callLogs.isNullOrEmpty()
+                    val hasContacts = !backupData.contacts.isNullOrEmpty()
+                    
+                    if (hasSms && !RestorePermissionHelper.isDefaultSmsApp(context)) {
+                        withContext(Dispatchers.Main) {
+                            isOperating.value = false
+                            _restoreProgress.value = 0
+                            _restoreState.value = RestoreState.Error("恢复短信需要将此应用设为默认短信应用")
+                            restoreStatus.value = "恢复失败: 恢复短信需要将此应用设为默认短信应用"
+                            restorePhase.value = null
                         }
+                        return@launch
                     }
                     
-                    // 调用带进度回调的恢复方法
-                    val result = restoreManager.restoreFromFile(backupFile, progressCallback)
+                    val result = restoreManager.restore(
+                        backupFile.filePath,
+                        RestoreOptions(sms = hasSms, callLogs = hasCallLogs, contacts = hasContacts)
+                    )
+                    
+                    _restoreProgress.value = 80
                     
                     withContext(Dispatchers.Main) {
                         isOperating.value = false
@@ -320,11 +237,7 @@ class RestoreViewModel(
         }
     }
     
-    /**
-     * 检查应用是否为默认短信应用
-     */
     private fun isDefaultSmsApp(): Boolean {
-        // 如果有强制设置的状态，优先使用
         if (forceDefaultSmsAppStatus != null) {
             val forcedStatus = forceDefaultSmsAppStatus!!
             Timber.d("[Mobile] DEBUG [Restore] 使用强制设置的默认短信应用状态: $forcedStatus")
@@ -332,7 +245,6 @@ class RestoreViewModel(
         }
         
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
-            // 优先使用RoleManager（Android 10+）
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                 try {
                     val roleManager = context.getSystemService(Context.ROLE_SERVICE) as? android.app.role.RoleManager
@@ -348,11 +260,9 @@ class RestoreViewModel(
                 }
             }
             
-            // 如果RoleManager检查未成功或不可用，使用传统方法
             val defaultSmsPackage = Telephony.Sms.getDefaultSmsPackage(context)
             val isDefault = context.packageName == defaultSmsPackage
             
-            // 添加详细日志
             Timber.d("[Mobile] DEBUG [Restore] 默认短信应用检查: 当前=${context.packageName}, 系统默认=$defaultSmsPackage, 是默认=${isDefault}")
             
             return isDefault
@@ -360,11 +270,95 @@ class RestoreViewModel(
         return true
     }
     
-    /**
-     * 设置权限状态
-     * 
-     * @param granted 是否已授权
-     */
+    private suspend fun getAvailableBackups(): List<BackupFile> = withContext(Dispatchers.IO) {
+        val backupFiles = mutableListOf<BackupFile>()
+        try {
+            val backupDir = File(context.getExternalFilesDir(null), config.getBackupDirectoryName())
+            if (!backupDir.exists()) return@withContext emptyList<BackupFile>()
+
+            val files = backupDir.listFiles { file ->
+                file.isFile && file.name.endsWith(".json", ignoreCase = true)
+            }
+
+            if (files != null) {
+                val validFiles = mutableListOf<File>()
+                files.forEach { file ->
+                    if (validateBackupFile(file)) {
+                        validFiles += file
+                    }
+                }
+                backupFiles.addAll(validFiles.map { file ->
+                    val deviceId = android.provider.Settings.Secure.getString(
+                        context.contentResolver, android.provider.Settings.Secure.ANDROID_ID
+                    ) ?: "unknown"
+
+                    val backupData = backupFileReader.read(file.absolutePath)
+
+                    BackupFile(
+                        filePath = file.absolutePath,
+                        fileName = file.name,
+                        fileSize = file.length(),
+                        creationDate = Date(file.lastModified()),
+                        deviceName = backupData?.deviceInfo ?: deviceId,
+                        smsCount = backupData?.messages?.size ?: 0,
+                        callLogsCount = backupData?.callLogs?.size ?: 0,
+                        version = com.iskenkenya.commory.mobile.BuildConfig.VERSION_NAME
+                    )
+                }.sortedByDescending { it.creationDate.time })
+            }
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Restore] Failed to get backup file list: ${e.message}")
+        }
+        backupFiles
+    }
+
+    private suspend fun parseBackupFile(backupFile: BackupFile): BackupData? = withContext(Dispatchers.IO) {
+        backupFileReader.read(backupFile.filePath)?.toLegacyBackupData()
+    }
+
+    private suspend fun validateBackupFile(file: File): Boolean {
+        if (!file.exists() || !file.isFile || !file.canRead()) return false
+        return runCatching { backupFileReader.read(file.absolutePath) != null }
+            .getOrDefault(false)
+    }
+
+    private fun BackupReadData.toLegacyBackupData(): BackupData {
+        return BackupData(
+            messages = messages.map { message ->
+                Message(
+                    id = message.id,
+                    address = message.address,
+                    body = message.body,
+                    date = message.date,
+                    type = message.type,
+                    readState = message.readState,
+                    messageStatus = message.messageStatus,
+                    threadId = message.threadId
+                )
+            },
+            callLogs = callLogs.map { callLog ->
+                CallLog(
+                    id = callLog.id,
+                    number = callLog.number,
+                    type = callLog.type,
+                    date = callLog.date,
+                    duration = callLog.duration,
+                    contact = callLog.contact
+                )
+            },
+            contacts = contacts.map { contact ->
+                Contact(
+                    id = contact.id,
+                    name = contact.name,
+                    phoneNumbers = contact.phoneNumbers.toMutableList(),
+                    emails = contact.emails
+                )
+            },
+            timestamp = timestamp,
+            deviceInfo = deviceInfo
+        )
+    }
+    
     fun setPermissionsGranted(granted: Boolean) {
         permissionsGranted.value = granted
         if (granted) {
@@ -372,70 +366,42 @@ class RestoreViewModel(
         }
     }
     
-    /**
-     * 重置需要默认短信应用状态
-     * 
-     * 此方法用于重置 needDefaultSmsApp 状态为 false，通常在以下情况下调用:
-     * 1. 用户取消设置默认短信应用的对话框
-     * 2. 用户已完成设置默认短信应用的流程
-     * 3. 需要清除旧的权限请求状态
-     * 
-     * 方法执行流程:
-     * 1. 将 needDefaultSmsApp 重置为 false
-     * 2. 检查当前应用是否为默认短信应用
-     * 3. 记录日志，包含当前的默认短信应用状态
-     */
     fun resetNeedDefaultSmsApp() {
         needDefaultSmsApp.value = false
-        // 强制检查一次当前是否为默认短信应用
         val isDefault = isDefaultSmsApp()
         Timber.i("[Mobile] INFO [Restore] 重置权限检查对话框，当前是否为默认短信应用: $isDefault")
     }
     
-    /**
-     * 检查并更新默认短信应用状态
-     * 返回当前是否为默认短信应用
-     */
     fun checkAndUpdateDefaultSmsAppStatus(): Boolean {
-        // 清除任何之前强制设置的状态，确保从系统获取最新状态
         forceDefaultSmsAppStatus = null
-        
-        // 直接从系统检查一次
         val isDefault = isDefaultSmsApp()
-        
-        // 如果是默认应用，记录并更新强制状态
         if (isDefault) {
             forceDefaultSmsAppStatus = true
             Timber.i("[Mobile] INFO [Restore] 检测到应用已是默认短信应用，更新状态")
         }
-        
         return isDefault
     }
     
-    /**
-     * RestoreViewModel工厂类
-     * 
-     * 用于创建携带Context参数的ViewModel实例
-     */
     class Factory(private val context: Context) : ViewModelProvider.Factory {
         @Suppress("UNCHECKED_CAST")
         override fun <T : ViewModel> create(modelClass: Class<T>): T {
             if (modelClass.isAssignableFrom(RestoreViewModel::class.java)) {
-                // 创建RestoreManager实例
                 val restoreManager = RestoreManager(
-                    context,
-                    imken.messagevault.mobile.config.Config.getInstance(context),
-                    imken.messagevault.mobile.api.ApiClient(imken.messagevault.mobile.config.Config.getInstance(context))
+                    backupFileReader = AndroidBackupFileReader(context),
+                    smsWriter = AndroidSmsWriter(context),
+                    callLogWriter = AndroidCallLogWriter(context),
+                    contactWriter = AndroidContactWriter(context)
                 )
+                val config = Config.getInstance(context)
+                val apiClient = ApiClient(config)
                 
-                return RestoreViewModel(context, restoreManager) as T
+                return RestoreViewModel(context, restoreManager, config, apiClient) as T
             }
             throw IllegalArgumentException("Unknown ViewModel class")
         }
     }
 
-    // 日志辅助方法
     fun logError(message: String, exception: Exception? = null) {
         Timber.e(exception, message)
     }
-} 
\ No newline at end of file
+} 
diff --git a/android/app/src/main/java/imken/messagevault/mobile/util/AppDispatchers.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/util/AppDispatchers.kt
similarity index 89%
rename from android/app/src/main/java/imken/messagevault/mobile/util/AppDispatchers.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/util/AppDispatchers.kt
index 6afd9b6..0b72fa2 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/util/AppDispatchers.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/util/AppDispatchers.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.util
+package com.iskenkenya.commory.mobile.util
 
 import kotlinx.coroutines.CoroutineDispatcher
 import kotlinx.coroutines.Dispatchers
diff --git a/android/app/src/main/java/imken/messagevault/mobile/utils/AppUtils.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/AppUtils.kt
similarity index 82%
rename from android/app/src/main/java/imken/messagevault/mobile/utils/AppUtils.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/utils/AppUtils.kt
index 0fbea67..7f0ef69 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/utils/AppUtils.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/AppUtils.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.utils
+package com.iskenkenya.commory.mobile.utils
 
 import android.content.Context
 import android.content.pm.PackageManager
@@ -14,7 +14,7 @@ object AppUtils {
     fun getAppVersion(context: Context): String {
         return try {
             val packageInfo = context.packageManager.getPackageInfo(context.packageName, 0)
-            packageInfo.versionName
+            packageInfo.versionName ?: "未知版本"
         } catch (e: PackageManager.NameNotFoundException) {
             "未知版本"
         }
diff --git a/android/app/src/main/java/imken/messagevault/mobile/utils/Constants.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/Constants.kt
similarity index 70%
rename from android/app/src/main/java/imken/messagevault/mobile/utils/Constants.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/utils/Constants.kt
index ec7c1da..00f64d4 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/utils/Constants.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/Constants.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.utils
+package com.iskenkenya.commory.mobile.utils
 
 object Constants {
     const val SUPPORTED_VERSION = "1.0" // 或者根据实际需求设置版本号
diff --git a/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/DefaultSmsAppHelper.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/DefaultSmsAppHelper.kt
new file mode 100644
index 0000000..b2fc3e1
--- /dev/null
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/DefaultSmsAppHelper.kt
@@ -0,0 +1,248 @@
+package com.iskenkenya.commory.mobile.utils
+
+import android.app.AlertDialog
+import android.app.role.RoleManager
+import android.content.Context
+import android.content.Intent
+import android.os.Build
+import android.provider.Telephony
+import android.widget.Toast
+import androidx.activity.ComponentActivity
+import androidx.activity.result.contract.ActivityResultContracts
+import androidx.lifecycle.ViewModelProvider
+import com.iskenkenya.commory.mobile.R
+import com.iskenkenya.commory.mobile.ui.viewmodels.RestoreViewModel
+import timber.log.Timber
+import java.io.File
+import java.text.SimpleDateFormat
+import java.util.Date
+import java.util.Locale
+
+class DefaultSmsAppHelper(private val activity: ComponentActivity) {
+
+    private val defaultSmsLauncher = activity.registerForActivityResult(
+        ActivityResultContracts.StartActivityForResult()
+    ) { result ->
+        val isSmsAppNow = isDefaultSmsApp()
+        if (isSmsAppNow) {
+            activity.getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
+                .putBoolean("is_default_sms_app", true)
+                .apply()
+
+            val restoreViewModel = ViewModelProvider(activity, RestoreViewModel.Factory(activity))
+                .get(RestoreViewModel::class.java)
+
+            restoreViewModel.notifyDefaultSmsAppChanged(true)
+
+            Timber.i("[Mobile] INFO [Permission] 已成功设置为默认短信应用; Context: ActivityResultLauncher回调")
+            Toast.makeText(activity, "成功设置为默认短信应用，可以恢复短信", Toast.LENGTH_SHORT).show()
+
+            handleDefaultSmsAppGranted()
+        } else {
+            activity.getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
+                .putBoolean("is_default_sms_app", false)
+                .apply()
+
+            Timber.w("[Mobile] WARN [Permission] 未能设置为默认短信应用; Context: 用户拒绝")
+            Toast.makeText(activity, "需要设置为默认短信应用才能恢复短信", Toast.LENGTH_LONG).show()
+        }
+    }
+
+    fun isDefaultSmsApp(): Boolean {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                try {
+                    val roleManager = activity.getSystemService(Context.ROLE_SERVICE) as? RoleManager
+                    if (roleManager != null) {
+                        val hasRole = roleManager.isRoleHeld(RoleManager.ROLE_SMS)
+                        Timber.d("[Mobile] DEBUG [Permission] RoleManager角色检查结果: $hasRole")
+                        if (hasRole) {
+                            activity.getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
+                                .putBoolean("is_default_sms_app", true)
+                                .apply()
+                            return true
+                        }
+                    }
+                } catch (e: Exception) {
+                    Timber.e(e, "[Mobile] ERROR [Permission] 检查RoleManager时出错")
+                }
+            }
+
+            val defaultSmsPackage = Telephony.Sms.getDefaultSmsPackage(activity)
+            val isDefault = activity.packageName == defaultSmsPackage
+
+            Timber.d("[Mobile] DEBUG [Permission] 默认短信应用检查: 系统报告默认包名=$defaultSmsPackage, 当前=${activity.packageName}, 是默认=$isDefault")
+
+            activity.getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
+                .putBoolean("is_default_sms_app", isDefault)
+                .apply()
+
+            return isDefault
+        }
+        return true
+    }
+
+    fun showDefaultSmsAppDialog() {
+        val builder = AlertDialog.Builder(activity)
+        builder.setTitle(R.string.permission_required)
+            .setMessage("恢复短信需要临时将此应用设置为默认短信应用。\n\n恢复完成后，您可以将其改回原来的应用。\n\n在接下来的系统界面中选择\"是\"，将信驿云储设为默认短信应用，以开始恢复任务。")
+            .setPositiveButton(R.string.settings) { _, _ ->
+                requestDefaultSmsApp()
+            }
+            .setNegativeButton(R.string.cancel) { dialog, _ ->
+                dialog.dismiss()
+            }
+            .create()
+            .show()
+    }
+
+    fun requestDefaultSmsApp() {
+        Timber.d("[Mobile] DEBUG [Permission] 开始请求默认短信应用权限，Android版本: ${Build.VERSION.SDK_INT}")
+        var requestSent = false
+
+        try {
+            if (isDefaultSmsApp()) {
+                Timber.i("[Mobile] INFO [Permission] 应用已经是默认短信应用，直接处理")
+                handleDefaultSmsAppGranted()
+                return
+            }
+
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                val roleManager = activity.getSystemService(Context.ROLE_SERVICE) as? RoleManager
+
+                if (roleManager != null) {
+                    if (roleManager.isRoleAvailable(RoleManager.ROLE_SMS)) {
+                        try {
+                            val intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_SMS)
+                            defaultSmsLauncher.launch(intent)
+
+                            val message = "使用RoleManager请求SMS角色，Android版本: ${Build.VERSION.SDK_INT}"
+                            Timber.i("[Mobile] INFO [Permission] $message; Context: 用户操作")
+                            logToFile(message)
+                            requestSent = true
+                        } catch (e: Exception) {
+                            val errorMsg = "启动RoleManager请求失败: ${e.message}"
+                            Timber.e(e, "[Mobile] ERROR [Permission] $errorMsg")
+                            logToFile(errorMsg)
+                        }
+                    } else {
+                        val warningMsg = "此设备的RoleManager不支持SMS角色 (isRoleAvailable返回false)"
+                        Timber.w("[Mobile] WARN [Permission] $warningMsg")
+                        logToFile(warningMsg)
+                    }
+                } else {
+                    val warningMsg = "无法获取RoleManager服务 (getSystemService返回null)"
+                    Timber.w("[Mobile] WARN [Permission] $warningMsg")
+                    logToFile(warningMsg)
+                }
+            }
+
+            if (!requestSent) {
+                requestDefaultSmsAppLegacy()
+            }
+        } catch (e: Exception) {
+            val errorMsg = "请求默认短信应用时发生异常: ${e.message}"
+            Timber.e(e, "[Mobile] ERROR [Permission] $errorMsg")
+            logToFile(errorMsg)
+
+            if (!requestSent) {
+                requestDefaultSmsAppLegacy()
+            }
+        }
+    }
+
+    private fun requestDefaultSmsAppLegacy() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+            try {
+                val intent = Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT)
+                intent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME, activity.packageName)
+
+                defaultSmsLauncher.launch(intent)
+
+                Timber.d("[Mobile] DEBUG [Permission] 请求成为默认短信应用 (旧API); Context: 用户操作")
+                logToFile("使用传统方法请求设置为默认短信应用")
+            } catch (e: Exception) {
+                Timber.e(e, "[Mobile] ERROR [Permission] 使用传统方法请求默认短信应用失败: ${e.message}")
+                logToFile("使用传统方法请求默认短信应用失败: ${e.message}")
+
+                Toast.makeText(
+                    activity,
+                    "无法自动请求设置默认短信应用，请手动设置",
+                    Toast.LENGTH_LONG
+                ).show()
+            }
+        }
+    }
+
+    fun showRestoreDefaultSmsAppDialog() {
+        val builder = AlertDialog.Builder(activity)
+        builder.setTitle("恢复默认短信应用")
+            .setMessage("短信恢复已完成。现在您可以将默认短信应用改回原来的应用，也可以稍后再改回。\n\n如果您需要继续恢复其他备份，建议暂时保持本应用为默认短信应用。")
+            .setPositiveButton("现在改回") { _, _ ->
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                    val roleManager = activity.getSystemService(Context.ROLE_SERVICE) as RoleManager
+                    val intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_SMS)
+                    activity.startActivity(intent)
+                } else {
+                    val intent = Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT)
+                    intent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME, "")
+                    activity.startActivity(intent)
+                }
+            }
+            .setNegativeButton("稍后改回") { dialog, _ ->
+                dialog.dismiss()
+            }
+            .create()
+            .show()
+    }
+
+    private fun handleDefaultSmsAppGranted() {
+        activity.getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
+            .putBoolean("is_default_sms_app", true)
+            .apply()
+
+        val restoreViewModel = ViewModelProvider(activity, RestoreViewModel.Factory(activity))
+            .get(RestoreViewModel::class.java)
+
+        restoreViewModel.notifyDefaultSmsAppChanged(true)
+
+        val selectedBackupFile = restoreViewModel.selectedBackupFile.value
+        if (selectedBackupFile != null) {
+            Timber.i("[Mobile] INFO [Restore] 开始恢复备份; Context: 已设置为默认短信应用")
+            restoreViewModel.restoreBackupFile(selectedBackupFile)
+        } else {
+            Timber.w("[Mobile] WARN [Restore] 没有选中备份文件; Context: 已设置为默认短信应用但无备份可恢复")
+            Toast.makeText(activity, "没有选中备份文件，请先选择要恢复的备份", Toast.LENGTH_LONG).show()
+        }
+
+        logToFile("Fixed SMS role request dialog for Android 16")
+    }
+
+    private fun logToFile(message: String) {
+        try {
+            val logDir = File(activity.filesDir, "logs")
+            if (!logDir.exists()) {
+                logDir.mkdirs()
+            }
+
+            val logFile = File(logDir, "ui-2025-05-13.log")
+            val timestamp = SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS", Locale.getDefault()).format(Date())
+            val logEntry = "$timestamp - $message\n"
+
+            logFile.appendText(logEntry)
+
+            val assetLogDir = File(activity.applicationContext.getExternalFilesDir(null), "logs")
+            if (!assetLogDir.exists()) {
+                assetLogDir.mkdirs()
+            }
+            val assetLogFile = File(assetLogDir, "ui-2025-05-13.log")
+            assetLogFile.appendText(logEntry)
+
+            if (message.contains("Fixed SMS role request") || message.contains("Fix SMS role request")) {
+                assetLogFile.appendText("$timestamp - Fixed SMS role request dialog for Android 16\n")
+            }
+        } catch (e: Exception) {
+            Timber.e(e, "[Mobile] ERROR [Log] 写入日志文件失败: ${e.message}")
+        }
+    }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/utils/PermissionUtils.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/PermissionUtils.kt
similarity index 90%
rename from android/app/src/main/java/imken/messagevault/mobile/utils/PermissionUtils.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/utils/PermissionUtils.kt
index d032bdc..11e36b3 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/utils/PermissionUtils.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/PermissionUtils.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.utils
+package com.iskenkenya.commory.mobile.utils
 
 import android.Manifest
 import android.app.Activity
@@ -18,8 +18,13 @@ import timber.log.Timber
  */
 object PermissionUtils {
     
-    // 应用所需的基本权限列表
-    private val BASIC_PERMISSIONS = arrayOf(
+    val BACKUP_PERMISSIONS = arrayOf(
+        Manifest.permission.READ_SMS,
+        Manifest.permission.READ_CALL_LOG,
+        Manifest.permission.READ_CONTACTS
+    )
+
+    val RESTORE_PERMISSIONS = arrayOf(
         Manifest.permission.READ_SMS,
         Manifest.permission.SEND_SMS,
         Manifest.permission.RECEIVE_SMS,
@@ -28,6 +33,9 @@ object PermissionUtils {
         Manifest.permission.READ_CONTACTS,
         Manifest.permission.WRITE_CONTACTS
     )
+
+    // 应用所需的基本权限列表
+    private val BASIC_PERMISSIONS = BACKUP_PERMISSIONS
     
     // Android 11+上需要特殊处理的权限
     private val ANDROID_11_SPECIAL_PERMISSIONS = arrayOf(
@@ -59,6 +67,18 @@ object PermissionUtils {
             context.checkSelfPermission(it) != PackageManager.PERMISSION_GRANTED
         }
     }
+
+    fun checkBackupPermissions(context: Context): Boolean {
+        return BACKUP_PERMISSIONS.all {
+            context.checkSelfPermission(it) == PackageManager.PERMISSION_GRANTED
+        }
+    }
+
+    fun checkRestorePermissions(context: Context): Boolean {
+        return RESTORE_PERMISSIONS.all {
+            context.checkSelfPermission(it) == PackageManager.PERMISSION_GRANTED
+        }
+    }
     
     /**
      * 检查当前应用是否为默认短信应用
@@ -174,4 +194,4 @@ object PermissionUtils {
             }
         }
     }
-} 
\ No newline at end of file
+} 
diff --git a/android/app/src/main/java/imken/messagevault/mobile/utils/PhoneNumberUtils.kt b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/PhoneNumberUtils.kt
similarity index 98%
rename from android/app/src/main/java/imken/messagevault/mobile/utils/PhoneNumberUtils.kt
rename to android/app/src/main/java/com/iskenkenya/commory/mobile/utils/PhoneNumberUtils.kt
index 748a111..128384b 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/utils/PhoneNumberUtils.kt
+++ b/android/app/src/main/java/com/iskenkenya/commory/mobile/utils/PhoneNumberUtils.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.utils
+package com.iskenkenya.commory.mobile.utils
 
 import timber.log.Timber
 
diff --git a/android/app/src/main/java/imken/messagevault/mobile/MainActivity.kt b/android/app/src/main/java/imken/messagevault/mobile/MainActivity.kt
deleted file mode 100644
index fe668a4..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/MainActivity.kt
+++ /dev/null
@@ -1,801 +0,0 @@
-package imken.messagevault.mobile
-
-import android.Manifest
-import android.content.Context
-import android.content.pm.PackageManager
-import android.content.res.Configuration
-import android.os.Build
-import android.os.Bundle
-import android.provider.Settings
-import androidx.activity.ComponentActivity
-import androidx.activity.compose.setContent
-import androidx.activity.result.contract.ActivityResultContracts
-import androidx.compose.foundation.layout.*
-import androidx.compose.material.icons.Icons
-import androidx.compose.material.icons.filled.Backup
-import androidx.compose.material.icons.filled.MoreHoriz
-import androidx.compose.material.icons.filled.Preview
-import androidx.compose.material.icons.filled.Restore
-import androidx.compose.material3.*
-import androidx.compose.runtime.*
-import androidx.compose.ui.Alignment
-import androidx.compose.ui.Modifier
-import androidx.compose.ui.res.stringResource
-import androidx.compose.ui.tooling.preview.Preview
-import androidx.compose.ui.unit.dp
-import androidx.core.content.ContextCompat
-import androidx.lifecycle.viewmodel.compose.viewModel
-import androidx.navigation.NavDestination.Companion.hierarchy
-import androidx.navigation.NavGraph.Companion.findStartDestination
-import androidx.navigation.compose.NavHost
-import androidx.navigation.compose.composable
-import androidx.navigation.compose.currentBackStackEntryAsState
-import androidx.navigation.compose.rememberNavController
-import imken.messagevault.mobile.config.Config
-import imken.messagevault.mobile.ui.theme.MessageVaultTheme
-import imken.messagevault.mobile.ui.screens.BackupScreen
-import imken.messagevault.mobile.ui.screens.RestoreScreen
-import imken.messagevault.mobile.ui.screens.PreviewScreen
-import imken.messagevault.mobile.ui.screens.MoreScreen
-import imken.messagevault.mobile.ui.viewmodels.BackupViewModel
-import imken.messagevault.mobile.ui.viewmodels.RestoreViewModel
-import timber.log.Timber
-import java.util.*
-import androidx.compose.runtime.collectAsState
-import android.net.Uri
-import imken.messagevault.mobile.data.RestoreManager
-import imken.messagevault.mobile.api.ApiClient
-import kotlinx.coroutines.flow.MutableStateFlow
-import kotlinx.coroutines.launch
-import imken.messagevault.mobile.model.BackupData
-import java.io.InputStream
-import imken.messagevault.mobile.models.BackupFile
-import kotlinx.coroutines.CoroutineScope
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.withContext
-import androidx.compose.ui.graphics.vector.ImageVector
-import android.util.Log
-import android.content.Intent
-import android.provider.Telephony
-import android.app.AlertDialog
-import android.widget.Toast
-import androidx.fragment.app.FragmentContainerView
-import androidx.lifecycle.ViewModelProvider
-import android.app.role.RoleManager
-import imken.messagevault.mobile.utils.PermissionUtils
-import java.io.File
-import java.text.SimpleDateFormat
-
-/**
- * MessageVault主活动
- * 
- * 此活动是应用的主入口点，负责：
- * 1. 请求必要的权限（短信、通话记录）
- * 2. 显示主界面，提供备份和恢复功能
- * 3. 处理用户交互并调用相应的业务逻辑
- *
- * UI采用Jetpack Compose和Material Design 3实现，遵循以下设计原则：
- * - 简洁明了的界面布局
- * - 符合直觉的交互方式
- * - 适配不同屏幕尺寸
- * - 支持动态主题颜色（Android 12+）
- * 
- * 参考资料：
- * - Material Design 3: https://m3.material.io/
- */
-class MainActivity : ComponentActivity() {
-    
-    companion object {
-        private const val TAG = "MainActivity"
-        private const val DEFAULT_SMS_REQUEST_CODE = 1001
-        private val REQUIRED_PERMISSIONS = arrayOf(
-            // 读取权限
-            Manifest.permission.READ_SMS,
-            Manifest.permission.READ_CALL_LOG,
-            Manifest.permission.READ_CONTACTS,
-            
-            // 写入权限 - 恢复功能需要
-            // 注意：Manifest.permission.WRITE_SMS 不是标准Android权限
-            // 系统短信的写入使用 SEND_SMS 权限
-            Manifest.permission.SEND_SMS,
-            Manifest.permission.WRITE_CALL_LOG,
-            Manifest.permission.WRITE_CONTACTS,
-            
-            // 存储权限
-            Manifest.permission.WRITE_EXTERNAL_STORAGE
-        )
-    }
-    
-    // 导航项定义
-    sealed class NavigationItem(val route: String, val iconData: ImageVector, val labelResId: Int) {
-        object Backup : NavigationItem("backup", Icons.Filled.Backup, R.string.backup_tab)
-        object Restore : NavigationItem("restore", Icons.Filled.Restore, R.string.restore_tab)
-        object Preview : NavigationItem("preview", Icons.Filled.Preview, R.string.preview_tab)
-        object More : NavigationItem("more", Icons.Filled.MoreHoriz, R.string.more_tab)
-    }
-    
-    // 获取所有导航项
-    private val navigationItems = listOf(
-        NavigationItem.Backup,
-        NavigationItem.Restore,
-        NavigationItem.Preview,
-        NavigationItem.More
-    )
-    
-    // 配置
-    private lateinit var config: Config
-    private lateinit var restoreManager: RestoreManager
-    
-    // 恢复进度
-    private val restoreProgress = MutableStateFlow(false)
-    
-    // 初始权限状态
-    private var initialPermissionsChecked = false
-    
-    // 权限请求启动器
-    private val requestPermissionLauncher = registerForActivityResult(
-        ActivityResultContracts.RequestMultiplePermissions()
-    ) { permissions ->
-        // 检查所有请求的权限是否都已授予
-        val allGranted = permissions.entries.all { it.value }
-        if (allGranted) {
-            Timber.i("[Mobile] INFO [Permissions] 所有请求的权限已授予")
-            Toast.makeText(this, "所有权限已授予，可以继续操作", Toast.LENGTH_SHORT).show()
-        } else {
-            // 处理未授予的权限
-            val deniedPermissions = permissions.filterValues { !it }.keys
-            Timber.w("[Mobile] WARN [Permissions] 部分权限被拒绝: $deniedPermissions")
-            
-            // 检查是否有被永久拒绝的权限，如果有则引导用户到设置页面手动授予
-            if (deniedPermissions.any { shouldShowRequestPermissionRationale(it) }) {
-                // 显示权限说明对话框
-                showPermissionRationaleDialog()
-            } else {
-                // 部分权限被永久拒绝，引导用户到设置页面
-                PermissionUtils.openAppSettings(this)
-                Toast.makeText(this, "请在设置中手动授予权限", Toast.LENGTH_LONG).show()
-            }
-        }
-    }
-    
-    // 默认短信应用设置结果处理
-    private val defaultSmsLauncher = registerForActivityResult(
-        ActivityResultContracts.StartActivityForResult()
-    ) { result ->
-        // 检查是否设置成功
-        val isSmsAppNow = isDefaultSmsApp()
-        if (isSmsAppNow) {
-            // 更新SharedPreferences状态
-            getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
-                .putBoolean("is_default_sms_app", true)
-                .apply()
-            
-            // 获取当前RestoreViewModel
-            val restoreViewModel = ViewModelProvider(this, RestoreViewModel.Factory(this))
-                .get(RestoreViewModel::class.java)
-            
-            // 通知ViewModel状态已变更
-            restoreViewModel.notifyDefaultSmsAppChanged(true)
-            
-            // 记录结果并显示通知
-            Timber.i("[Mobile] INFO [Permission] 已成功设置为默认短信应用; Context: ActivityResultLauncher回调")
-            Toast.makeText(this, "成功设置为默认短信应用，可以恢复短信", Toast.LENGTH_SHORT).show()
-            
-            // 处理后续操作
-            handleDefaultSmsAppGranted()
-        } else {
-            // 如果设置失败，也要更新状态
-            getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
-                .putBoolean("is_default_sms_app", false)
-                .apply()
-                
-            Timber.w("[Mobile] WARN [Permission] 未能设置为默认短信应用; Context: 用户拒绝")
-            Toast.makeText(this, "需要设置为默认短信应用才能恢复短信", Toast.LENGTH_LONG).show()
-        }
-    }
-    
-    override fun onCreate(savedInstanceState: Bundle?) {
-        super.onCreate(savedInstanceState)
-        
-        // 初始化日志系统
-        if (Timber.forest().isEmpty()) {
-            Timber.plant(object : Timber.DebugTree() {
-                override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
-                    Log.println(priority, "MessageVault", message)
-                    super.log(priority, tag, message, t)
-                }
-            })
-        }
-        
-        // 输出测试日志以确认日志系统工作正常
-        Timber.d("[Mobile] DEBUG 日志系统初始化完成")
-        Log.d("MessageVault", "主活动创建 - 直接Log测试")
-        
-        // 初始化配置
-        config = Config.getInstance(this)
-        
-        // 初始化恢复管理器
-        restoreManager = RestoreManager(this, config, ApiClient(config))
-        
-        // 应用语言设置
-        applyLanguage()
-        
-        // 设置Compose UI
-        setContent {
-            MessageVaultTheme {
-                // 创建ViewModels
-                val backupViewModel: BackupViewModel = viewModel(
-                    factory = BackupViewModel.Factory(this)
-                )
-                
-                val restoreViewModel: RestoreViewModel = viewModel(
-                    factory = RestoreViewModel.Factory(this)
-                )
-                
-                // 检查权限并通知ViewModels
-                if (!initialPermissionsChecked) {
-                    val permissionsGranted = checkPermissions()
-                    backupViewModel.setPermissionsGranted(permissionsGranted)
-                    restoreViewModel.setPermissionsGranted(permissionsGranted)
-                    initialPermissionsChecked = true
-                }
-                
-                // Surface容器使用背景色
-                Surface(
-                    modifier = Modifier.fillMaxSize(),
-                    color = MaterialTheme.colorScheme.background
-                ) {
-                    MessageVaultAppWithNavigation(
-                        backupViewModel = backupViewModel,
-                        restoreViewModel = restoreViewModel,
-                        navigationItems = navigationItems
-                    )
-                }
-            }
-        }
-        
-        Timber.i("[Mobile] INFO [UI] 实现MD3 UI与底部导航; Context: 应用启动")
-    }
-    
-    /**
-     * 应用语言设置
-     */
-    private fun applyLanguage() {
-        val langCode = config.getLanguage()
-        val locale = Locale(langCode)
-        Locale.setDefault(locale)
-        
-        val configuration = Configuration(resources.configuration)
-        configuration.setLocale(locale)
-        createConfigurationContext(configuration)
-    }
-    
-    /**
-     * 在配置变化时调用
-     * 用于处理语言变化情况
-     */
-    override fun attachBaseContext(newBase: Context) {
-        val config = Config.getInstance(newBase)
-        val langCode = config.getLanguage()
-        val locale = Locale(langCode)
-        Locale.setDefault(locale)
-        
-        val configuration = Configuration(newBase.resources.configuration)
-        configuration.setLocale(locale)
-        val context = newBase.createConfigurationContext(configuration)
-        
-        super.attachBaseContext(context)
-    }
-    
-    /**
-     * 检查必要权限
-     * 
-     * @return 是否已授权所有必要权限
-     */
-    private fun checkPermissions(): Boolean {
-        // 对于API 29+，不需要WRITE_EXTERNAL_STORAGE权限
-        val permissionsToCheck = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
-            arrayOf(
-                // 读取权限
-                Manifest.permission.READ_SMS,
-                Manifest.permission.READ_CALL_LOG,
-                Manifest.permission.READ_CONTACTS,
-                
-                // 写入权限 - 恢复功能需要
-                Manifest.permission.SEND_SMS,
-                Manifest.permission.WRITE_CALL_LOG,
-                Manifest.permission.WRITE_CONTACTS
-            )
-        } else {
-            REQUIRED_PERMISSIONS
-        }
-        
-        val allPermissionsGranted = permissionsToCheck.all {
-            ContextCompat.checkSelfPermission(this, it) == PackageManager.PERMISSION_GRANTED
-        }
-        
-        if (allPermissionsGranted) {
-            Timber.i("[Mobile] INFO [Permission] 已有所有必要权限; Context: 启动检查")
-        } else {
-            Timber.i("[Mobile] INFO [Permission] 请求权限; Context: 启动检查")
-            requestPermissionLauncher.launch(permissionsToCheck)
-        }
-        
-        return allPermissionsGranted
-    }
-
-    private fun handleRestore(backupFile: BackupFile) {
-        Timber.d("[Mobile] DEBUG [Restore] 开始恢复流程...")
-        
-        // ...existing code...
-        
-        // 替换所有Log调用为Timber
-        Timber.d("[Mobile] DEBUG [Restore] 找到备份文件: $backupFile")
-        
-        // ...existing code...
-        
-        // 使用更安全的方式获取设备标识符
-        val context = this
-        val deviceId = Settings.Secure.getString(context.contentResolver, 
-                           Settings.Secure.ANDROID_ID) ?: "unknown"
-        
-        // ...existing code...
-    }
-
-    /**
-     * 启动恢复流程
-     * 
-     * @param backupFile 要恢复的备份文件
-     */
-    private fun startRestoreProcess(backupFile: BackupFile) {
-        // 如果有短信需要恢复，检查是否需要设置为默认短信应用
-        // 注意：这里需要检查备份文件中是否包含短信数据
-        val restoreViewModel = ViewModelProvider(this, RestoreViewModel.Factory(this))
-            .get(RestoreViewModel::class.java)
-        
-        // 直接使用RestoreViewModel恢复备份文件
-        restoreViewModel.restoreBackupFile(backupFile)
-    }
-    
-    /**
-     * 检查应用是否为默认短信应用
-     */
-    private fun isDefaultSmsApp(): Boolean {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
-            // 优先使用RoleManager（Android 10+）
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
-                try {
-                    val roleManager = getSystemService(Context.ROLE_SERVICE) as? android.app.role.RoleManager
-                    if (roleManager != null) {
-                        val hasRole = roleManager.isRoleHeld(android.app.role.RoleManager.ROLE_SMS)
-                        Timber.d("[Mobile] DEBUG [Permission] RoleManager角色检查结果: $hasRole")
-                        if (hasRole) {
-                            // 如果RoleManager报告应用持有SMS角色，记录状态并返回true
-                            getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
-                                .putBoolean("is_default_sms_app", true)
-                                .apply()
-                            return true
-                        }
-                    }
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Permission] 检查RoleManager时出错")
-                }
-            }
-            
-            // 传统方法
-            val defaultSmsPackage = Telephony.Sms.getDefaultSmsPackage(this)
-            val isDefault = packageName == defaultSmsPackage
-            
-            Timber.d("[Mobile] DEBUG [Permission] 默认短信应用检查: 系统报告默认包名=$defaultSmsPackage, 当前=${packageName}, 是默认=$isDefault")
-            
-            // 保存检测结果到SharedPreferences
-            getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
-                .putBoolean("is_default_sms_app", isDefault)
-                .apply()
-                
-            return isDefault
-        }
-        return true
-    }
-    
-    /**
-     * 显示设置默认短信应用对话框
-     */
-    private fun showDefaultSmsAppDialog() {
-        val builder = AlertDialog.Builder(this)
-        builder.setTitle(R.string.permission_required)
-            .setMessage("恢复短信需要临时将此应用设置为默认短信应用。\n\n恢复完成后，您可以将其改回原来的应用。\n\n在接下来的系统界面中选择\"是\"，将信驿云储设为默认短信应用，以开始恢复任务。")
-            .setPositiveButton(R.string.settings) { _, _ ->
-                requestDefaultSmsApp()
-            }
-            .setNegativeButton(R.string.cancel) { dialog, _ ->
-                dialog.dismiss()
-            }
-            .create()
-            .show()
-    }
-    
-    /**
-     * 请求设置为默认短信应用
-     * 
-     * 此方法用于向系统请求将应用设置为默认短信应用，是恢复短信功能的必要前提。
-     * 
-     * 实现策略:
-     * - 对于Android 10(Q)及以上版本，优先使用现代的RoleManager API
-     * - 对于Android 4.4-9版本，使用传统的Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT方法
-     * - 对于更低版本，不需要此权限(Android 4.4以下没有默认短信应用的概念)
-     * 
-     * 异常处理:
-     * - 如果RoleManager不可用或请求失败，会自动降级到传统方法
-     * - 完整的错误日志记录，便于排查问题
-     * 
-     * 流程:
-     * 1. 此方法启动系统的权限请求界面
-     * 2. 用户做出选择(同意或拒绝)
-     * 3. 系统结果返回到ActivityResultLauncher回调
-     * 4. 在回调中处理用户的选择结果
-     * 5. 如果用户同意，继续恢复流程；如果拒绝，提示用户并终止恢复
-     */
-    fun requestDefaultSmsApp() {
-        Timber.d("[Mobile] DEBUG [Permission] 开始请求默认短信应用权限，Android版本: ${Build.VERSION.SDK_INT}")
-        var requestSent = false
-        
-        try {
-            // 首先检查是否已经是默认短信应用
-            if (isDefaultSmsApp()) {
-                Timber.i("[Mobile] INFO [Permission] 应用已经是默认短信应用，直接处理")
-                handleDefaultSmsAppGranted()
-                return
-            }
-            
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
-                // 使用RoleManager（Android 10及以上）
-                val roleManager = getSystemService(Context.ROLE_SERVICE) as? RoleManager
-                
-                if (roleManager != null) {
-                    // 检查应用是否可以请求短信角色
-                    if (roleManager.isRoleAvailable(RoleManager.ROLE_SMS)) {
-                        try {
-                            // 创建请求角色的意图
-                            val intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_SMS)
-                            
-                            // 使用ActivityResultLauncher发起请求
-                            defaultSmsLauncher.launch(intent)
-                            
-                            // 记录详细日志
-                            val message = "使用RoleManager请求SMS角色，Android版本: ${Build.VERSION.SDK_INT}"
-                            Timber.i("[Mobile] INFO [Permission] $message; Context: 用户操作")
-                            logToFile(message)
-                            requestSent = true
-                        } catch (e: Exception) {
-                            val errorMsg = "启动RoleManager请求失败: ${e.message}"
-                            Timber.e(e, "[Mobile] ERROR [Permission] $errorMsg")
-                            logToFile(errorMsg)
-                            // 异常会继续处理，尝试传统方法
-                        }
-                    } else {
-                        val warningMsg = "此设备的RoleManager不支持SMS角色 (isRoleAvailable返回false)"
-                        Timber.w("[Mobile] WARN [Permission] $warningMsg")
-                        logToFile(warningMsg)
-                    }
-                } else {
-                    val warningMsg = "无法获取RoleManager服务 (getSystemService返回null)"
-                    Timber.w("[Mobile] WARN [Permission] $warningMsg")
-                    logToFile(warningMsg)
-                }
-            }
-            
-            // 如果RoleManager方法未成功，使用传统方法
-            if (!requestSent) {
-                requestDefaultSmsAppLegacy()
-            }
-        } catch (e: Exception) {
-            val errorMsg = "请求默认短信应用时发生异常: ${e.message}"
-            Timber.e(e, "[Mobile] ERROR [Permission] $errorMsg")
-            logToFile(errorMsg)
-            
-            // 如果出现异常，尝试使用传统方法
-            if (!requestSent) {
-                requestDefaultSmsAppLegacy()
-            }
-        }
-    }
-    
-    /**
-     * 记录信息到日志文件
-     */
-    private fun logToFile(message: String) {
-        try {
-            val logDir = File(filesDir, "logs")
-            if (!logDir.exists()) {
-                logDir.mkdirs()
-            }
-            
-            val logFile = File(logDir, "ui-2025-05-13.log")
-            val timestamp = SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS", Locale.getDefault()).format(Date())
-            val logEntry = "$timestamp - $message\n"
-            
-            logFile.appendText(logEntry)
-            
-            // 同时添加到assets中的日志文件，方便调试
-            val assetLogDir = File(applicationContext.getExternalFilesDir(null), "logs")
-            if (!assetLogDir.exists()) {
-                assetLogDir.mkdirs()
-            }
-            val assetLogFile = File(assetLogDir, "ui-2025-05-13.log")
-            assetLogFile.appendText(logEntry)
-            
-            // 如果是修复日志，添加特殊标记
-            if (message.contains("Fixed SMS role request") || message.contains("Fix SMS role request")) {
-                assetLogFile.appendText("$timestamp - Fixed SMS role request dialog for Android 16\n")
-            }
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Log] 写入日志文件失败: ${e.message}")
-        }
-    }
-    
-    /**
-     * 使用旧方法请求设置为默认短信应用（Android 4.4-9）
-     */
-    private fun requestDefaultSmsAppLegacy() {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
-            try {
-                val intent = Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT)
-                intent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME, packageName)
-                
-                // 使用ActivityResultLauncher代替startActivityForResult
-                defaultSmsLauncher.launch(intent)
-                
-                Timber.d("[Mobile] DEBUG [Permission] 请求成为默认短信应用 (旧API); Context: 用户操作")
-                logToFile("使用传统方法请求设置为默认短信应用")
-            } catch (e: Exception) {
-                Timber.e(e, "[Mobile] ERROR [Permission] 使用传统方法请求默认短信应用失败: ${e.message}")
-                logToFile("使用传统方法请求默认短信应用失败: ${e.message}")
-                
-                // 如果传统方法也失败，尝试打开设置页面
-                Toast.makeText(
-                    this,
-                    "无法自动请求设置默认短信应用，请手动设置",
-                    Toast.LENGTH_LONG
-                ).show()
-            }
-        }
-    }
-    
-    /**
-     * 显示恢复默认短信应用对话框
-     */
-    private fun showRestoreDefaultSmsAppDialog() {
-        val builder = AlertDialog.Builder(this)
-        builder.setTitle("恢复默认短信应用")
-            .setMessage("短信恢复已完成。现在您可以将默认短信应用改回原来的应用，也可以稍后再改回。\n\n如果您需要继续恢复其他备份，建议暂时保持本应用为默认短信应用。")
-            .setPositiveButton("现在改回") { _, _ ->
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
-                    // 使用RoleManager（Android 10及以上）
-                    val roleManager = getSystemService(Context.ROLE_SERVICE) as RoleManager
-                    val intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_SMS)
-                    startActivity(intent)
-                } else {
-                    // 使用旧API
-                    val intent = Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT)
-                    intent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME, "")
-                    startActivity(intent)
-                }
-            }
-            .setNegativeButton("稍后改回") { dialog, _ ->
-                dialog.dismiss()
-            }
-            .create()
-            .show()
-    }
-    
-    /**
-     * 显示权限说明对话框
-     */
-    private fun showPermissionRationaleDialog() {
-        // 在实际应用中，这里应该显示一个对话框，解释为什么应用需要这些权限
-        Toast.makeText(this, "需要这些权限才能备份和恢复您的短信和通话记录", Toast.LENGTH_LONG).show()
-    }
-    
-    /**
-     * 继续恢复流程
-     */
-    private fun continueRestoreProcess() {
-        // 在这里可以继续恢复流程，例如调用RestoreManager的方法
-        Timber.d("[Mobile] DEBUG [Restore] 继续恢复流程")
-    }
-    
-    /**
-     * 在onResume中检查权限状态
-     */
-    override fun onResume() {
-        super.onResume()
-        // 检查是否有权限更新，例如用户可能在设置中手动授予了权限
-        if (PermissionUtils.checkAllRequiredPermissions(this)) {
-            Timber.d("[Mobile] DEBUG [Permissions] 所有需要的权限已授予")
-        }
-    }
-    
-    // 不要忘记为APIClient添加一个占位符
-    private val apiClient by lazy {
-        object {}
-    }
-
-    /**
-     * 处理已获得默认短信应用权限的情况
-     */
-    private fun handleDefaultSmsAppGranted() {
-        // 保存状态到SharedPreferences供其他组件使用
-        getSharedPreferences("sms_app_status", Context.MODE_PRIVATE).edit()
-            .putBoolean("is_default_sms_app", true)
-            .apply()
-        
-        // 获取当前屏幕上的RestoreViewModel，执行恢复操作
-        val restoreViewModel = ViewModelProvider(this, RestoreViewModel.Factory(this))
-            .get(RestoreViewModel::class.java)
-        
-        // 强制更新RestoreViewModel的默认短信应用状态
-        restoreViewModel.notifyDefaultSmsAppChanged(true)
-        
-        // 获取选中的备份文件并执行恢复
-        val selectedBackupFile = restoreViewModel.selectedBackupFile.value
-        if (selectedBackupFile != null) {
-            Timber.i("[Mobile] INFO [Restore] 开始恢复备份; Context: 已设置为默认短信应用")
-            restoreViewModel.restoreBackupFile(selectedBackupFile)
-        } else {
-            Timber.w("[Mobile] WARN [Restore] 没有选中备份文件; Context: 已设置为默认短信应用但无备份可恢复")
-            Toast.makeText(this, "没有选中备份文件，请先选择要恢复的备份", Toast.LENGTH_LONG).show()
-        }
-        
-        // 记录修复信息到日志
-        logToFile("Fixed SMS role request dialog for Android 16")
-    }
-}
-
-/**
- * 主应用界面组合函数（带底部导航）
- *
- * 显示应用的主界面，包括底部导航栏和各个功能页面
- * 遵循Material Design 3设计规范
- *
- * @param backupViewModel 备份视图模型
- * @param restoreViewModel 恢复视图模型
- * @param navigationItems 导航项列表
- */
-@OptIn(ExperimentalMaterial3Api::class)
-@Composable
-fun MessageVaultAppWithNavigation(
-    backupViewModel: BackupViewModel,
-    restoreViewModel: RestoreViewModel,
-    navigationItems: List<MainActivity.NavigationItem>
-) {
-    val navController = rememberNavController()
-    
-    Scaffold(
-        topBar = {
-            CenterAlignedTopAppBar(
-                title = {
-                    Text(
-                        text = stringResource(id = R.string.app_title), 
-                        style = MaterialTheme.typography.titleLarge
-                    )
-                }
-            )
-        },
-        bottomBar = {
-            NavigationBar {
-                val navBackStackEntry by navController.currentBackStackEntryAsState()
-                val currentDestination = navBackStackEntry?.destination
-                
-                navigationItems.forEach { item ->
-                    NavigationBarItem(
-                        icon = { Icon(item.iconData, contentDescription = null) },
-                        label = { Text(stringResource(item.labelResId)) },
-                        selected = currentDestination?.hierarchy?.any { it.route == item.route } == true,
-                        onClick = {
-                            navController.navigate(item.route) {
-                                // 防止多次点击创建多个页面
-                                popUpTo(navController.graph.findStartDestination().id) {
-                                    saveState = true
-                                }
-                                // 避免重复导航到同一目的地
-                                launchSingleTop = true
-                                // 恢复状态
-                                restoreState = true
-                            }
-                        }
-                    )
-                }
-            }
-        }
-    ) { innerPadding ->
-        NavHost(
-            navController = navController,
-            startDestination = MainActivity.NavigationItem.Backup.route,
-            modifier = Modifier.padding(innerPadding)
-        ) {
-            composable(MainActivity.NavigationItem.Backup.route) {
-                BackupScreen(
-                    permissionsGranted = backupViewModel.getPermissionsGranted(),
-                    isOperating = backupViewModel.isOperating(),
-                    backupStatus = backupViewModel.getBackupStatus(),
-                    onBackupClick = { backupViewModel.startBackup() }
-                )
-            }
-            composable(MainActivity.NavigationItem.Restore.route) {
-                // 使用collectAsState收集Flow状态
-                val backupFiles by restoreViewModel.backupFiles.collectAsState(initial = emptyList())
-                val selectedBackupFile by restoreViewModel.selectedBackupFile.collectAsState(initial = null)
-                
-                RestoreScreen(
-                    backupFiles = backupFiles,
-                    isOperating = restoreViewModel.isOperating.value,
-                    restoreStatus = restoreViewModel.restoreStatus.value,
-                    onRestoreClick = { backupFile -> 
-                        restoreViewModel.restoreBackupFile(backupFile)
-                    },
-                    onBackupItemClick = { backupFile ->
-                        restoreViewModel.selectBackupFile(backupFile)
-                    },
-                    selectedBackupFile = selectedBackupFile,
-                    viewModel = restoreViewModel
-                )
-            }
-            composable(MainActivity.NavigationItem.Preview.route) {
-                PreviewScreen(permissionsGranted = backupViewModel.getPermissionsGranted())
-            }
-            composable(MainActivity.NavigationItem.More.route) {
-                MoreScreen(
-                    onNavigateToRestore = {
-                        navController.navigate(MainActivity.NavigationItem.Restore.route) {
-                            // 防止多次点击创建多个页面
-                            popUpTo(navController.graph.findStartDestination().id) {
-                                saveState = true
-                            }
-                            // 避免重复导航到同一目的地
-                            launchSingleTop = true
-                            // 恢复状态
-                            restoreState = true
-                        }
-                    }
-                )
-            }
-        }
-    }
-}
-
-/**
- * 预览函数
- * 
- * 提供界面预览，用于开发时查看UI效果
- */
-@Preview(showBackground = true)
-@Composable
-fun MessageVaultAppPreview() {
-    // 注意：预览中无法使用真实的ViewModels，此处仅为布局预览
-    MessageVaultTheme {
-        Surface(
-            modifier = Modifier.fillMaxSize(),
-            color = MaterialTheme.colorScheme.background
-        ) {
-            Column(
-                modifier = Modifier.padding(16.dp),
-                horizontalAlignment = Alignment.CenterHorizontally,
-                verticalArrangement = Arrangement.Center
-            ) {
-                Text(
-                    text = stringResource(id = R.string.app_title),
-                    style = MaterialTheme.typography.headlineLarge
-                )
-                
-                Spacer(modifier = Modifier.height(16.dp))
-                
-                Text(
-                    text = stringResource(id = R.string.app_description),
-                    style = MaterialTheme.typography.bodyLarge
-                )
-            }
-        }
-    }
-}
-
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/ApiClient.kt b/android/app/src/main/java/imken/messagevault/mobile/data/ApiClient.kt
deleted file mode 100644
index 146d6d1..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/ApiClient.kt
+++ /dev/null
@@ -1,16 +0,0 @@
-package imken.messagevault.mobile.data
-
-/**
- * API客户端类，用于处理网络请求
- */
-class ApiClient {
-    // 实现API通信功能
-    
-    // 获取备份文件列表
-    fun getBackupFiles(): List<BackupFile> {
-        // 实现从服务器获取备份文件列表
-        return emptyList() // 临时返回空列表
-    }
-    
-    // 其他API相关方法
-}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/BackupFile.kt b/android/app/src/main/java/imken/messagevault/mobile/data/BackupFile.kt
deleted file mode 100644
index 488fda3..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/BackupFile.kt
+++ /dev/null
@@ -1,4 +0,0 @@
-package imken.messagevault.mobile.data
-
-// 使用 data.models 包中的 BackupFile 类
-typealias BackupFile = imken.messagevault.mobile.data.models.BackupFile
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/BackupManager.kt b/android/app/src/main/java/imken/messagevault/mobile/data/BackupManager.kt
deleted file mode 100644
index 7702e7d..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/BackupManager.kt
+++ /dev/null
@@ -1,1070 +0,0 @@
-package imken.messagevault.mobile.data
-
-import android.content.ContentResolver
-import android.content.Context
-import android.database.Cursor
-import android.net.Uri
-import android.os.Build
-import android.provider.CallLog.Calls
-import android.provider.ContactsContract
-import android.provider.Telephony
-import com.google.gson.FieldNamingPolicy
-import com.google.gson.GsonBuilder
-import imken.messagevault.mobile.model.BackupData
-import imken.messagevault.mobile.model.Contact
-import imken.messagevault.mobile.model.CallLog
-import imken.messagevault.mobile.model.Message
-import timber.log.Timber
-import java.io.File
-import java.io.FileInputStream
-import java.io.FileOutputStream
-import java.io.IOException
-import java.io.ObjectInputStream
-import java.io.ObjectOutputStream
-import java.text.SimpleDateFormat
-import java.util.Date
-import java.util.Locale
-import java.util.UUID
-
-/**
- * 备份管理器
- * 
- * 负责执行备份操作，包括短信、通话记录和联系人的备份
- */
-class BackupManager(private val context: Context) {
-    
-    // 使用优化的Gson配置，减小JSON文件大小
-    private val gson = GsonBuilder()
-        .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
-        // .excludeFieldsWithoutExposeAnnotation() // 移除此配置，因为可能导致序列化问题
-        .serializeNulls() // 允许序列化null值
-        .disableHtmlEscaping() // 不转义HTML字符
-        .setLenient() // 使用宽松模式解析
-        .setPrettyPrinting() // 启用美化打印，使JSON输出格式化
-        .create()
-    
-    /**
-     * 执行备份操作
-     * 
-     * @return 备份结果，包含备份的短信、通话记录和联系人数量
-     */
-    suspend fun performBackup(): BackupResult {
-        try {
-            Timber.i("[Mobile] INFO [Backup] 开始备份; Context: 用户请求")
-            
-            // 检查是否有必要的权限
-            val hasSmsPermission = context.checkSelfPermission(android.Manifest.permission.READ_SMS) == android.content.pm.PackageManager.PERMISSION_GRANTED
-            val hasCallLogPermission = context.checkSelfPermission(android.Manifest.permission.READ_CALL_LOG) == android.content.pm.PackageManager.PERMISSION_GRANTED
-            val hasContactsPermission = context.checkSelfPermission(android.Manifest.permission.READ_CONTACTS) == android.content.pm.PackageManager.PERMISSION_GRANTED
-            
-            if (!hasSmsPermission && !hasCallLogPermission && !hasContactsPermission) {
-                Timber.e("[Mobile] ERROR [Backup] 备份失败: 没有任何所需权限")
-                return BackupResult(
-                    timestamp = Date(),
-                    messagesCount = 0,
-                    callLogsCount = 0,
-                    contactsCount = 0,
-                    backupFilePath = null,
-                    errorMessage = "备份失败: 没有任何所需权限"
-                )
-            }
-            
-            // 读取短信
-            val messages = if (hasSmsPermission) readMessages() else null
-            val messagesCount = messages?.size ?: 0
-            Timber.i("[Mobile] INFO [Backup] 读取到 $messagesCount 条短信")
-            
-            // 读取通话记录
-            val callLogs = if (hasCallLogPermission) readCallLogs() else null
-            val callLogsCount = callLogs?.size ?: 0
-            Timber.i("[Mobile] INFO [Backup] 读取到 $callLogsCount 条通话记录")
-            
-            // 读取联系人
-            val contacts = if (hasContactsPermission) readContacts() else null
-            val contactsCount = contacts?.size ?: 0
-            Timber.i("[Mobile] INFO [Backup] 读取到 $contactsCount 个联系人")
-            
-            // 检查是否有任何数据可以备份
-            if (messagesCount == 0 && callLogsCount == 0 && contactsCount == 0) {
-                Timber.w("[Mobile] WARN [Backup] 没有找到任何数据可以备份")
-                return BackupResult(
-                    timestamp = Date(),
-                    messagesCount = 0,
-                    callLogsCount = 0,
-                    contactsCount = 0,
-                    backupFilePath = null,
-                    errorMessage = "没有找到任何数据可以备份"
-                )
-            }
-            
-            // 创建备份数据对象
-            val backupData = BackupData(
-                messages = messages,
-                callLogs = callLogs,
-                contacts = contacts,
-                timestamp = System.currentTimeMillis(),
-                deviceInfo = "${Build.MANUFACTURER} ${Build.MODEL}"
-            )
-            
-            // 保存到本地文件
-            val backupFile = createLocalBackup(backupData)
-            
-            if (backupFile == null) {
-                Timber.e("[Mobile] ERROR [Backup] 创建备份文件失败")
-                return BackupResult(
-                    timestamp = Date(),
-                    messagesCount = messagesCount,
-                    callLogsCount = callLogsCount,
-                    contactsCount = contactsCount,
-                    backupFilePath = null,
-                    errorMessage = "创建备份文件失败"
-                )
-            }
-            
-            Timber.i("[Mobile] INFO [Backup] 备份完成; Context: 保存至 ${backupFile.absolutePath}")
-            
-            // 返回备份结果
-            return BackupResult(
-                timestamp = Date(),
-                messagesCount = messagesCount,
-                callLogsCount = callLogsCount,
-                contactsCount = contactsCount,
-                backupFilePath = backupFile.absolutePath
-            )
-            
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Backup] 备份过程出现异常; Context: ${e.message}")
-            return BackupResult(
-                timestamp = Date(),
-                messagesCount = 0,
-                callLogsCount = 0,
-                contactsCount = 0,
-                backupFilePath = null,
-                errorMessage = "备份过程出现异常: ${e.message}"
-            )
-        }
-    }
-    
-    /**
-     * 创建本地备份文件
-     */
-    private fun createLocalBackup(backupData: BackupData): File? {
-        try {
-            // 创建备份目录
-            val backupDir = File(context.getExternalFilesDir(null), "backups")
-            if (!backupDir.exists()) {
-                backupDir.mkdirs()
-            }
-            
-            // 生成友好的文件名而不是使用base64编码
-            val fileName = generateUserFriendlyFileName()
-            
-            // 创建备份文件
-            val backupFile = File(backupDir, fileName)
-            
-            // 将备份数据转换为JSON前单独记录各部分数据的状态
-            Timber.d("[Mobile] DEBUG [Backup] 数据准备情况: 短信=${backupData.messages?.size ?: 0}, 通话记录=${backupData.callLogs?.size ?: 0}, 联系人=${backupData.contacts?.size ?: 0}, 设备信息=${backupData.deviceInfo}")
-            
-            try {
-                // 尝试分段序列化，先只序列化基本字段
-                val testData = BackupData(
-                    messages = null,
-                    callLogs = null,
-                    contacts = null,
-                    timestamp = backupData.timestamp,
-                    deviceInfo = backupData.deviceInfo
-                )
-                
-                // 测试序列化基本结构
-                val testJson = gson.toJson(testData)
-                if (testJson.isNullOrBlank() || testJson == "{}" || testJson == "null") {
-                    Timber.e("[Mobile] ERROR [Backup] 基本数据结构序列化失败")
-                } else {
-                    Timber.d("[Mobile] DEBUG [Backup] 基本数据结构序列化成功: $testJson")
-                }
-                
-                // 逐步添加数据进行序列化测试
-                try {
-                    val messagesJson = gson.toJson(backupData.messages)
-                    Timber.d("[Mobile] DEBUG [Backup] 短信JSON长度: ${messagesJson.length}, 前100个字符: ${messagesJson.take(100)}")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] 短信数据序列化失败: ${e.message}")
-                }
-                
-                try {
-                    val callLogsJson = gson.toJson(backupData.callLogs)
-                    Timber.d("[Mobile] DEBUG [Backup] 通话记录JSON长度: ${callLogsJson.length}, 前100个字符: ${callLogsJson.take(100)}")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] 通话记录数据序列化失败: ${e.message}")
-                }
-                
-                try {
-                    val contactsJson = gson.toJson(backupData.contacts)
-                    Timber.d("[Mobile] DEBUG [Backup] 联系人JSON长度: ${contactsJson.length}, 前100个字符: ${contactsJson.take(100)}")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] 联系人数据序列化失败: ${e.message}")
-                }
-            } catch (e: Exception) {
-                Timber.e(e, "[Mobile] ERROR [Backup] 分段序列化测试过程中出现异常: ${e.message}")
-            }
-            
-            // 尝试创建一个清理过的备份数据对象
-            // 检查联系人数据是否有问题
-            var cleanedContacts = backupData.contacts?.map { contact ->
-                // 创建一个具有基本字段的新联系人对象
-                Contact(
-                    id = contact.id,
-                    name = contact.name.replace(Regex("[^\\p{Print}]"), ""), // 移除不可打印字符
-                    phoneNumbers = contact.phoneNumbers.map { it.replace(Regex("[^\\p{Print}]"), "") }.toMutableList(),
-                    emails = contact.emails?.map { it.replace(Regex("[^\\p{Print}]"), "") },
-                    note = contact.note?.replace(Regex("[^\\p{Print}]"), ""),
-                    addresses = contact.addresses?.map { 
-                        Contact.Address(
-                            type = it.type.replace(Regex("[^\\p{Print}]"), ""),
-                            value = it.value.replace(Regex("[^\\p{Print}]"), "")
-                        ) 
-                    },
-                    groups = contact.groups?.map { it.replace(Regex("[^\\p{Print}]"), "") }
-                )
-            }
-            
-            // 清理消息数据
-            var cleanedMessages = backupData.messages?.map { message ->
-                try {
-                    Message(
-                        id = message.id,
-                        address = message.address.replace(Regex("[^\\p{Print}]"), ""),
-                        body = message.body?.replace(Regex("[^\\p{Print}]"), ""),
-                        date = message.date,
-                        type = message.type,
-                        readState = message.readState,
-                        messageStatus = message.messageStatus,
-                        threadId = message.threadId
-                    )
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] 清理短信数据时出错: ${e.message}")
-                    null
-                }
-            }?.filterNotNull()
-            
-            // 清理通话记录数据
-            var cleanedCallLogs = backupData.callLogs?.map { callLog ->
-                try {
-                    CallLog(
-                        id = callLog.id,
-                        number = callLog.number.replace(Regex("[^\\p{Print}]"), ""),
-                        type = callLog.type,
-                        date = callLog.date,
-                        duration = callLog.duration,
-                        contact = callLog.contact?.replace(Regex("[^\\p{Print}]"), "")
-                    )
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] 清理通话记录数据时出错: ${e.message}")
-                    null
-                }
-            }?.filterNotNull()
-            
-            // 创建清理后的备份数据
-            val cleanedBackupData = BackupData(
-                messages = cleanedMessages,
-                callLogs = cleanedCallLogs,
-                contacts = cleanedContacts,
-                timestamp = backupData.timestamp,
-                deviceInfo = backupData.deviceInfo
-            )
-            
-            // 完整序列化
-            try {
-                Timber.d("[Mobile] DEBUG [Backup] 尝试使用清理后的数据进行序列化")
-                
-                // 先创建一个超简化的备份数据对象，仅包含基本信息
-                val minimalBackupData = BackupData(
-                    messages = emptyList(),
-                    callLogs = emptyList(),
-                    contacts = emptyList(),
-                    timestamp = cleanedBackupData.timestamp,
-                    deviceInfo = cleanedBackupData.deviceInfo
-                )
-                
-                // 测试序列化最小数据
-                val minimalJson = gson.toJson(minimalBackupData)
-                if (minimalJson.isNullOrBlank() || minimalJson == "{}" || minimalJson == "null") {
-                    Timber.e("[Mobile] ERROR [Backup] 最小数据结构序列化失败，这表明Gson配置有问题")
-                    return null
-                }
-                
-                Timber.d("[Mobile] DEBUG [Backup] 最小数据序列化成功: $minimalJson")
-                
-                // 创建一个可能最终使用的数据结构
-                var finalMessages = cleanedMessages
-                var finalCallLogs = cleanedCallLogs
-                var finalContacts = cleanedContacts
-                
-                // 尝试序列化短信数据
-                if (!cleanedMessages.isNullOrEmpty()) {
-                    try {
-                        val testMessagesJson = gson.toJson(cleanedMessages)
-                        Timber.d("[Mobile] DEBUG [Backup] 短信序列化测试成功，大小: ${testMessagesJson.length} 字节")
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Backup] 短信数据序列化失败，使用空列表: ${e.message}")
-                        finalMessages = emptyList()
-                    }
-                }
-                
-                // 尝试序列化通话记录数据
-                if (!cleanedCallLogs.isNullOrEmpty()) {
-                    try {
-                        val testCallLogsJson = gson.toJson(cleanedCallLogs)
-                        Timber.d("[Mobile] DEBUG [Backup] 通话记录序列化测试成功，大小: ${testCallLogsJson.length} 字节")
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Backup] 通话记录数据序列化失败，使用空列表: ${e.message}")
-                        finalCallLogs = emptyList()
-                    }
-                }
-                
-                // 尝试序列化联系人数据
-                if (!cleanedContacts.isNullOrEmpty()) {
-                    try {
-                        val testContactsJson = gson.toJson(cleanedContacts)
-                        Timber.d("[Mobile] DEBUG [Backup] 联系人序列化测试成功，大小: ${testContactsJson.length} 字节")
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Backup] 联系人数据序列化失败，使用空列表: ${e.message}")
-                        finalContacts = emptyList()
-                    }
-                }
-                
-                // 创建最终备份数据
-                val finalBackupData = BackupData(
-                    messages = finalMessages,
-                    callLogs = finalCallLogs,
-                    contacts = finalContacts,
-                    timestamp = cleanedBackupData.timestamp,
-                    deviceInfo = cleanedBackupData.deviceInfo
-                )
-                
-                // 创建完整的JSON数据
-                val jsonString: String
-                try {
-                    jsonString = gson.toJson(finalBackupData)
-                    
-                    // 验证JSON数据不为空且格式正确
-                    if (jsonString.isBlank() || jsonString == "{}" || jsonString == "null") {
-                        Timber.e("[Mobile] ERROR [Backup] 创建的备份数据为空或格式无效")
-                        return null
-                    }
-                    
-                    // 尝试解析JSON以验证格式有效
-                    gson.fromJson(jsonString, BackupData::class.java)
-                    Timber.d("[Mobile] DEBUG [Backup] JSON格式验证成功")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] JSON序列化或格式验证失败: ${e.message}")
-                    return null
-                }
-                
-                // 记录数据大小信息
-                val jsonBytes = jsonString.toByteArray(Charsets.UTF_8)
-                Timber.d("[Mobile] DEBUG [Backup] JSON数据大小: ${jsonBytes.size} 字节")
-                
-                // 如果文件太大（超过10MB），尝试仅保存部分数据
-                var finalJsonString = jsonString
-                if (jsonBytes.size > 10 * 1024 * 1024) {
-                    Timber.w("[Mobile] WARN [Backup] JSON数据超过10MB，尝试减少数据量")
-                    
-                    // 创建一个精简版的备份数据（限制每种类型最多500条记录）
-                    val limitedBackupData = BackupData(
-                        messages = finalMessages?.take(500),
-                        callLogs = finalCallLogs?.take(500),
-                        contacts = finalContacts?.take(500),
-                        timestamp = cleanedBackupData.timestamp,
-                        deviceInfo = "${cleanedBackupData.deviceInfo} (数据已精简，原始数据: ${finalMessages?.size ?: 0}条短信, ${finalCallLogs?.size ?: 0}条通话记录, ${finalContacts?.size ?: 0}个联系人)"
-                    )
-                    
-                    finalJsonString = gson.toJson(limitedBackupData)
-                    Timber.d("[Mobile] DEBUG [Backup] 精简后的JSON数据大小: ${finalJsonString.toByteArray(Charsets.UTF_8).size} 字节")
-                }
-                
-                // 将备份数据写入文件
-                try {
-                    backupFile.writeText(finalJsonString)
-                    Timber.d("[Mobile] DEBUG [Backup] 成功将数据写入文件")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] 写入文件失败: ${e.message}")
-                    return null
-                }
-                
-                // 验证写入的文件大小
-                if (!backupFile.exists() || backupFile.length() <= 10) { // 空的JSON至少有"{}"两个字符
-                    Timber.e("[Mobile] ERROR [Backup] 创建的备份文件为空或过小: ${backupFile.length()} 字节")
-                    backupFile.delete() // 删除无效文件
-                    return null
-                }
-                
-                Timber.i("[Mobile] INFO [Backup] 成功创建备份文件: ${backupFile.absolutePath}, 大小: ${backupFile.length()} 字节")
-                return backupFile
-            } catch (e: Exception) {
-                Timber.e(e, "[Mobile] ERROR [Backup] JSON序列化过程中出现异常: ${e.message}")
-                return null
-            }
-            
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Backup] 创建本地备份文件失败; Context: ${e.message}")
-            return null
-        }
-    }
-    
-    /**
-     * 生成用户友好的文件名
-     * 格式: MessageVault_设备名_yyyy-MM-dd_HH-mm.json
-     */
-    private fun generateUserFriendlyFileName(deviceName: String? = null): String {
-        val dateFormat = SimpleDateFormat("yyyy-MM-dd_HH-mm", Locale.getDefault())
-        val timestamp = dateFormat.format(Date())
-        val device = deviceName ?: Build.MODEL.replace(" ", "_")
-        
-        return "MessageVault_${device}_${timestamp}.json"
-    }
-    
-    private fun readMessages(): List<imken.messagevault.mobile.model.Message>? {
-        val messages = mutableListOf<imken.messagevault.mobile.model.Message>()
-        
-        try {
-            // 检查权限
-            val permissionStatus = context.checkSelfPermission(android.Manifest.permission.READ_SMS)
-            if (permissionStatus != android.content.pm.PackageManager.PERMISSION_GRANTED) {
-                Timber.e("[Mobile] ERROR [Backup] 备份短信失败: 没有 READ_SMS 权限")
-                return null
-            }
-            
-            Timber.d("[Mobile] DEBUG [Backup] 开始读取短信...")
-            
-            // 查询短信内容提供者
-            val uri = android.provider.Telephony.Sms.CONTENT_URI
-            val projection = arrayOf(
-                android.provider.Telephony.Sms._ID,
-                android.provider.Telephony.Sms.ADDRESS,
-                android.provider.Telephony.Sms.BODY,
-                android.provider.Telephony.Sms.DATE,
-                android.provider.Telephony.Sms.TYPE,
-                android.provider.Telephony.Sms.READ,
-                android.provider.Telephony.Sms.STATUS
-            )
-            val sortOrder = "${android.provider.Telephony.Sms.DATE} DESC"
-
-            context.contentResolver.query(uri, projection, null, null, sortOrder)?.use { cursor ->
-
-                Timber.d("[Mobile] DEBUG [Backup] 找到 ${cursor.count} 条短信")
-
-                val idColumn = cursor.getColumnIndex(android.provider.Telephony.Sms._ID)
-                val addressColumn = cursor.getColumnIndex(android.provider.Telephony.Sms.ADDRESS)
-                val bodyColumn = cursor.getColumnIndex(android.provider.Telephony.Sms.BODY)
-                val dateColumn = cursor.getColumnIndex(android.provider.Telephony.Sms.DATE)
-                val typeColumn = cursor.getColumnIndex(android.provider.Telephony.Sms.TYPE)
-                val readColumn = cursor.getColumnIndex(android.provider.Telephony.Sms.READ)
-                val statusColumn = cursor.getColumnIndex(android.provider.Telephony.Sms.STATUS)
-
-                while (cursor.moveToNext()) {
-                    val id = if (idColumn != -1) cursor.getLong(idColumn) else 0
-                    
-                    // 获取原始地址值
-                    val originalAddress = if (addressColumn != -1) cursor.getString(addressColumn) else ""
-                    
-                    // 规范化地址（电话号码）
-                    val normalizedAddress = if (originalAddress.isNotBlank()) {
-                        val normalized = imken.messagevault.mobile.utils.PhoneNumberUtils.normalizePhoneNumber(originalAddress)
-                        // 如果规范化后的地址与原地址不同，记录日志
-                        if (normalized != originalAddress) {
-                            Timber.d("[Mobile] DEBUG [Backup] 短信地址已规范化: $originalAddress -> $normalized")
-                        }
-                        normalized
-                    } else {
-                        originalAddress
-                    }
-                    
-                    val body = if (bodyColumn != -1) cursor.getString(bodyColumn) else ""
-                    val date = if (dateColumn != -1) cursor.getLong(dateColumn) else 0
-                    val type = if (typeColumn != -1) cursor.getInt(typeColumn) else 0
-                    val read = if (readColumn != -1) cursor.getInt(readColumn) else 0
-                    val status = if (statusColumn != -1) cursor.getInt(statusColumn) else 0
-
-                    val message = imken.messagevault.mobile.model.Message(
-                        id = id,
-                        address = normalizedAddress,
-                        body = body,
-                        date = date,
-                        type = type,
-                        readState = read,
-                        messageStatus = status
-                    )
-
-                    messages.add(message)
-                }
-            } ?: run {
-                Timber.e("[Mobile] ERROR [Backup] 备份短信失败: 无法查询短信内容提供者")
-                return null
-            }
-
-            Timber.i("[Mobile] INFO [Backup] 成功读取 ${messages.size} 条短信")
-
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Backup] 备份短信异常: ${e.message}")
-            return null
-        }
-
-        return messages
-    }
-    
-    private fun readCallLogs(): List<imken.messagevault.mobile.model.CallLog>? {
-        val callLogs = mutableListOf<imken.messagevault.mobile.model.CallLog>()
-        
-        try {
-            // 检查权限
-            val permissionStatus = context.checkSelfPermission(android.Manifest.permission.READ_CALL_LOG)
-            if (permissionStatus != android.content.pm.PackageManager.PERMISSION_GRANTED) {
-                Timber.e("[Mobile] ERROR [Backup] 备份通话记录失败: 没有 READ_CALL_LOG 权限")
-                return null
-            }
-            
-            Timber.d("[Mobile] DEBUG [Backup] 开始读取通话记录...")
-            
-            // 查询通话记录
-            val uri = android.provider.CallLog.Calls.CONTENT_URI
-            val projection = arrayOf(
-                android.provider.CallLog.Calls._ID,
-                android.provider.CallLog.Calls.NUMBER,
-                android.provider.CallLog.Calls.CACHED_NAME,
-                android.provider.CallLog.Calls.DATE,
-                android.provider.CallLog.Calls.DURATION,
-                android.provider.CallLog.Calls.TYPE
-            )
-            val sortOrder = "${android.provider.CallLog.Calls.DATE} DESC"
-            
-            // 使用分批查询减轻内存压力，每批100条记录
-            val timeRanges = generateTimeRanges()
-            var totalCallLogs = 0
-            
-            for (range in timeRanges) {
-                val selection = "${android.provider.CallLog.Calls.DATE} >= ? AND ${android.provider.CallLog.Calls.DATE} <= ?"
-                val selectionArgs = arrayOf(range.first.toString(), range.second.toString())
-                
-                Timber.d("[Mobile] DEBUG [Backup] 查询时间范围: ${range.first} 到 ${range.second}")
-                
-                try {
-                    context.contentResolver.query(uri, projection, selection, selectionArgs, sortOrder)?.use { cursor ->
-                        totalCallLogs += cursor.count
-                        
-                        val idColumn = cursor.getColumnIndex(android.provider.CallLog.Calls._ID)
-                        val numberColumn = cursor.getColumnIndex(android.provider.CallLog.Calls.NUMBER)
-                        val nameColumn = cursor.getColumnIndex(android.provider.CallLog.Calls.CACHED_NAME)
-                        val dateColumn = cursor.getColumnIndex(android.provider.CallLog.Calls.DATE)
-                        val durationColumn = cursor.getColumnIndex(android.provider.CallLog.Calls.DURATION)
-                        val typeColumn = cursor.getColumnIndex(android.provider.CallLog.Calls.TYPE)
-                        
-                        Timber.d("[Mobile] DEBUG [Backup] 批次查询到 ${cursor.count} 条通话记录")
-                        
-                        while (cursor.moveToNext()) {
-                            try {
-                                val id = if (idColumn != -1 && !cursor.isNull(idColumn)) cursor.getLong(idColumn) else 0L
-                                
-                                // 电话号码处理，确保不为null并规范化
-                                val originalNumber = if (numberColumn != -1 && !cursor.isNull(numberColumn)) {
-                                    cursor.getString(numberColumn)
-                                } else {
-                                    "unknown" // 使用默认值代替null
-                                }
-                                
-                                // 使用PhoneNumberUtils规范化电话号码
-                                val normalizedNumber = if (originalNumber != "unknown") {
-                                    val normalized = imken.messagevault.mobile.utils.PhoneNumberUtils.normalizePhoneNumber(originalNumber)
-                                    // 如果规范化成功，记录日志
-                                    if (normalized != originalNumber) {
-                                        Timber.d("[Mobile] DEBUG [Backup] 通话记录号码已规范化: $originalNumber -> $normalized")
-                                    }
-                                    normalized
-                                } else {
-                                    originalNumber
-                                }
-                                
-                                // 联系人名称
-                                val name = if (nameColumn != -1 && !cursor.isNull(nameColumn)) {
-                                    cursor.getString(nameColumn)
-                                } else {
-                                    null // 联系人名称可以为null
-                                }
-                                
-                                // 时间戳处理
-                                val date = if (dateColumn != -1 && !cursor.isNull(dateColumn)) {
-                                    cursor.getLong(dateColumn)
-                                } else {
-                                    System.currentTimeMillis() // 使用当前时间作为默认值
-                                }
-                                
-                                // 通话时长
-                                val duration = if (durationColumn != -1 && !cursor.isNull(durationColumn)) {
-                                    cursor.getInt(durationColumn)
-                                } else {
-                                    0 // 默认为0秒
-                                }
-                                
-                                // 通话类型
-                                val type = if (typeColumn != -1 && !cursor.isNull(typeColumn)) {
-                                    cursor.getInt(typeColumn)
-                                } else {
-                                    android.provider.CallLog.Calls.INCOMING_TYPE // 默认为来电类型
-                                }
-                                
-                                // 构建通话记录对象并添加到列表
-                                val callLog = imken.messagevault.mobile.model.CallLog(
-                                    id = id,
-                                    number = normalizedNumber,
-                                    contact = name,
-                                    date = date,
-                                    duration = duration,
-                                    type = type
-                                )
-                                
-                                callLogs.add(callLog)
-                            } catch (e: Exception) {
-                                Timber.e(e, "[Mobile] ERROR [Backup] 处理单条通话记录失败: ${e.message}")
-                                // 继续处理下一条记录
-                            }
-                        }
-                    } ?: run {
-                        Timber.e("[Mobile] ERROR [Backup] 查询时间范围 ${range.first} 到 ${range.second} 失败: 返回null")
-                    }
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Backup] 查询时间范围 ${range.first} 到 ${range.second} 失败: ${e.message}")
-                    // 继续查询下一个时间范围
-                }
-            }
-            
-            Timber.d("[Mobile] DEBUG [Backup] 找到 ${callLogs.size} 条通话记录，总查询数 $totalCallLogs")
-            Timber.i("[Mobile] INFO [Backup] 成功读取 ${callLogs.size} 条通话记录")
-            
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Backup] 备份通话记录异常: ${e.message}")
-            return callLogs.takeIf { it.isNotEmpty() } // 返回已收集的记录，而不是null
-        }
-        
-        return callLogs
-    }
-    
-    /**
-     * 生成时间范围用于分批查询数据
-     * 
-     * @param ranges 时间区间数量，默认为4
-     * @return 时间范围列表，每个元素为一个开始时间和结束时间的对
-     */
-    private fun generateTimeRanges(ranges: Int = 4): List<Pair<Long, Long>> {
-        val result = mutableListOf<Pair<Long, Long>>()
-        val endTime = System.currentTimeMillis()
-        // 默认查询最近1年的记录
-        val startTime = endTime - (365L * 24 * 60 * 60 * 1000)
-        
-        val rangeSize = (endTime - startTime) / ranges
-        
-        for (i in 0 until ranges) {
-            val rangeStart = startTime + (i * rangeSize)
-            val rangeEnd = if (i == ranges - 1) endTime else startTime + ((i + 1) * rangeSize - 1)
-            result.add(Pair(rangeStart, rangeEnd))
-        }
-        
-        return result
-    }
-    
-    /**
-     * 读取联系人
-     * 增强版：读取更多联系人信息，包括电子邮件、地址等
-     */
-    private fun readContacts(): List<Contact>? {
-        val contacts = mutableListOf<Contact>()
-        
-        try {
-            // 检查权限
-            val permissionStatus = context.checkSelfPermission(android.Manifest.permission.READ_CONTACTS)
-            if (permissionStatus != android.content.pm.PackageManager.PERMISSION_GRANTED) {
-                Timber.e("[Mobile] ERROR [Backup] 备份联系人失败: 没有 READ_CONTACTS 权限")
-                return null
-            }
-            
-            Timber.d("[Mobile] DEBUG [Backup] 开始读取联系人...")
-            
-            // 查询联系人
-            val uri = android.provider.ContactsContract.Contacts.CONTENT_URI
-            val projection = arrayOf(
-                android.provider.ContactsContract.Contacts._ID,
-                android.provider.ContactsContract.Contacts.DISPLAY_NAME,
-                android.provider.ContactsContract.Contacts.HAS_PHONE_NUMBER,
-                android.provider.ContactsContract.Contacts.PHOTO_URI
-            )
-            val sortOrder = "${android.provider.ContactsContract.Contacts.DISPLAY_NAME} ASC"
-            
-            context.contentResolver.query(uri, projection, null, null, sortOrder)?.use { cursor ->
-                Timber.d("[Mobile] DEBUG [Backup] 找到 ${cursor.count} 个联系人")
-                
-                val idColumn = cursor.getColumnIndex(android.provider.ContactsContract.Contacts._ID)
-                val nameColumn = cursor.getColumnIndex(android.provider.ContactsContract.Contacts.DISPLAY_NAME)
-                val hasPhoneColumn = cursor.getColumnIndex(android.provider.ContactsContract.Contacts.HAS_PHONE_NUMBER)
-                val photoUriColumn = cursor.getColumnIndex(android.provider.ContactsContract.Contacts.PHOTO_URI)
-                
-                // 分批处理联系人，每批次最多50个
-                val batchSize = 50
-                var contactsProcessed = 0
-                
-                while (cursor.moveToNext()) {
-                    try {
-                        val id = if (idColumn != -1) cursor.getLong(idColumn) else 0
-                        val name = if (nameColumn != -1) cursor.getString(nameColumn) else ""
-                        val hasPhone = if (hasPhoneColumn != -1) cursor.getInt(hasPhoneColumn) > 0 else false
-                        val photoUri = if (photoUriColumn != -1) cursor.getString(photoUriColumn) else null
-                        
-                        val phoneNumbers = mutableListOf<String>()
-                        val emails = mutableListOf<String>()
-                        val addresses = mutableListOf<Contact.Address>()
-                        val websites = mutableListOf<String>()
-                        val socialProfiles = mutableListOf<Contact.SocialProfile>()
-                        val relationships = mutableListOf<Contact.Relationship>()
-                        var note: String? = null
-                        val groups = mutableListOf<String>()
-                        val events = mutableListOf<Contact.Event>()
-                        
-                        // 1. 读取电话号码
-                        if (hasPhone) {
-                            val phoneUri = android.provider.ContactsContract.CommonDataKinds.Phone.CONTENT_URI
-                            val phoneProjection = arrayOf(
-                                android.provider.ContactsContract.CommonDataKinds.Phone.NUMBER,
-                                android.provider.ContactsContract.CommonDataKinds.Phone.TYPE
-                            )
-                            val phoneSelection = "${android.provider.ContactsContract.CommonDataKinds.Phone.CONTACT_ID} = ?"
-                            val phoneSelectionArgs = arrayOf(id.toString())
-                            
-                            context.contentResolver.query(phoneUri, phoneProjection, phoneSelection, phoneSelectionArgs, null)?.use { phoneCursor ->
-                                val phoneNumberColumn = phoneCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Phone.NUMBER)
-                                val phoneTypeColumn = phoneCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Phone.TYPE)
-                                
-                                while (phoneCursor.moveToNext()) {
-                                    val phoneNumber = if (phoneNumberColumn != -1) phoneCursor.getString(phoneNumberColumn) else ""
-                                    val phoneType = if (phoneTypeColumn != -1) {
-                                        when (phoneCursor.getInt(phoneTypeColumn)) {
-                                            android.provider.ContactsContract.CommonDataKinds.Phone.TYPE_HOME -> "家庭"
-                                            android.provider.ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE -> "手机"
-                                            android.provider.ContactsContract.CommonDataKinds.Phone.TYPE_WORK -> "工作"
-                                            else -> "其他"
-                                        }
-                                    } else "其他"
-                                    
-                                    if (phoneNumber.isNotBlank()) {
-                                        // 存储电话号码和类型信息
-                                        phoneNumbers.add(phoneNumber)
-                                    }
-                                }
-                            }
-                        }
-                        
-                        // 2. 读取电子邮件
-                        val emailUri = android.provider.ContactsContract.CommonDataKinds.Email.CONTENT_URI
-                        val emailProjection = arrayOf(
-                            android.provider.ContactsContract.CommonDataKinds.Email.ADDRESS,
-                            android.provider.ContactsContract.CommonDataKinds.Email.TYPE
-                        )
-                        val emailSelection = "${android.provider.ContactsContract.CommonDataKinds.Email.CONTACT_ID} = ?"
-                        val emailSelectionArgs = arrayOf(id.toString())
-                        
-                        context.contentResolver.query(emailUri, emailProjection, emailSelection, emailSelectionArgs, null)?.use { emailCursor ->
-                            val emailAddressColumn = emailCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Email.ADDRESS)
-                            val emailTypeColumn = emailCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Email.TYPE)
-                            
-                            while (emailCursor.moveToNext()) {
-                                val emailAddress = if (emailAddressColumn != -1) emailCursor.getString(emailAddressColumn) else ""
-                                val emailType = if (emailTypeColumn != -1) {
-                                    when (emailCursor.getInt(emailTypeColumn)) {
-                                        android.provider.ContactsContract.CommonDataKinds.Email.TYPE_HOME -> "家庭"
-                                        android.provider.ContactsContract.CommonDataKinds.Email.TYPE_WORK -> "工作"
-                                        else -> "其他"
-                                    }
-                                } else "其他"
-                                
-                                if (emailAddress.isNotBlank()) {
-                                    emails.add(emailAddress)
-                                }
-                            }
-                        }
-                        
-                        // 3. 读取地址信息
-                        val addressUri = android.provider.ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_URI
-                        val addressProjection = arrayOf(
-                            android.provider.ContactsContract.CommonDataKinds.StructuredPostal.FORMATTED_ADDRESS,
-                            android.provider.ContactsContract.CommonDataKinds.StructuredPostal.TYPE,
-                            android.provider.ContactsContract.CommonDataKinds.StructuredPostal.STREET,
-                            android.provider.ContactsContract.CommonDataKinds.StructuredPostal.CITY,
-                            android.provider.ContactsContract.CommonDataKinds.StructuredPostal.REGION,
-                            android.provider.ContactsContract.CommonDataKinds.StructuredPostal.POSTCODE,
-                            android.provider.ContactsContract.CommonDataKinds.StructuredPostal.COUNTRY
-                        )
-                        val addressSelection = "${android.provider.ContactsContract.CommonDataKinds.StructuredPostal.CONTACT_ID} = ?"
-                        val addressSelectionArgs = arrayOf(id.toString())
-                        
-                        context.contentResolver.query(addressUri, addressProjection, addressSelection, addressSelectionArgs, null)?.use { addressCursor ->
-                            val addressColumn = addressCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.StructuredPostal.FORMATTED_ADDRESS)
-                            val addressTypeColumn = addressCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.StructuredPostal.TYPE)
-                            
-                            while (addressCursor.moveToNext()) {
-                                val address = if (addressColumn != -1) addressCursor.getString(addressColumn) else ""
-                                val addressType = if (addressTypeColumn != -1) {
-                                    val type = addressCursor.getInt(addressTypeColumn)
-                                    when (type) {
-                                        android.provider.ContactsContract.CommonDataKinds.StructuredPostal.TYPE_HOME -> "家庭"
-                                        android.provider.ContactsContract.CommonDataKinds.StructuredPostal.TYPE_WORK -> "工作"
-                                        android.provider.ContactsContract.CommonDataKinds.StructuredPostal.TYPE_OTHER -> "其他"
-                                        else -> "其他"
-                                    }
-                                } else "其他"
-                                
-                                if (address.isNotBlank()) {
-                                    addresses.add(Contact.Address(addressType, address))
-                                }
-                            }
-                        }
-                        
-                        // 4. 读取备注
-                        val noteUri = android.provider.ContactsContract.Data.CONTENT_URI
-                        val noteProjection = arrayOf(
-                            android.provider.ContactsContract.CommonDataKinds.Note.NOTE
-                        )
-                        val noteSelection = "${android.provider.ContactsContract.Data.CONTACT_ID} = ? AND ${android.provider.ContactsContract.Data.MIMETYPE} = ?"
-                        val noteSelectionArgs = arrayOf(
-                            id.toString(),
-                            android.provider.ContactsContract.CommonDataKinds.Note.CONTENT_ITEM_TYPE
-                        )
-                        
-                        context.contentResolver.query(noteUri, noteProjection, noteSelection, noteSelectionArgs, null)?.use { noteCursor ->
-                            val noteColumn = noteCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Note.NOTE)
-                            
-                            if (noteCursor.moveToFirst()) {
-                                note = if (noteColumn != -1) noteCursor.getString(noteColumn) else null
-                            }
-                        }
-                        
-                        // 5. 读取网站
-                        val websiteUri = android.provider.ContactsContract.Data.CONTENT_URI
-                        val websiteProjection = arrayOf(
-                            android.provider.ContactsContract.CommonDataKinds.Website.URL
-                        )
-                        val websiteSelection = "${android.provider.ContactsContract.Data.CONTACT_ID} = ? AND ${android.provider.ContactsContract.Data.MIMETYPE} = ?"
-                        val websiteSelectionArgs = arrayOf(
-                            id.toString(),
-                            android.provider.ContactsContract.CommonDataKinds.Website.CONTENT_ITEM_TYPE
-                        )
-                        
-                        context.contentResolver.query(websiteUri, websiteProjection, websiteSelection, websiteSelectionArgs, null)?.use { websiteCursor ->
-                            val urlColumn = websiteCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Website.URL)
-                            
-                            while (websiteCursor.moveToNext()) {
-                                val url = if (urlColumn != -1) websiteCursor.getString(urlColumn) else ""
-                                if (url.isNotBlank()) {
-                                    websites.add(url)
-                                }
-                            }
-                        }
-                        
-                        // 6. 读取事件（如生日、纪念日等）
-                        val eventUri = android.provider.ContactsContract.Data.CONTENT_URI
-                        val eventProjection = arrayOf(
-                            android.provider.ContactsContract.CommonDataKinds.Event.START_DATE,
-                            android.provider.ContactsContract.CommonDataKinds.Event.TYPE
-                        )
-                        val eventSelection = "${android.provider.ContactsContract.Data.CONTACT_ID} = ? AND ${android.provider.ContactsContract.Data.MIMETYPE} = ?"
-                        val eventSelectionArgs = arrayOf(
-                            id.toString(),
-                            android.provider.ContactsContract.CommonDataKinds.Event.CONTENT_ITEM_TYPE
-                        )
-                        
-                        context.contentResolver.query(eventUri, eventProjection, eventSelection, eventSelectionArgs, null)?.use { eventCursor ->
-                            val dateColumn = eventCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Event.START_DATE)
-                            val typeColumn = eventCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Event.TYPE)
-                            
-                            while (eventCursor.moveToNext()) {
-                                val date = if (dateColumn != -1) eventCursor.getString(dateColumn) else ""
-                                val type = if (typeColumn != -1) {
-                                    when (eventCursor.getInt(typeColumn)) {
-                                        android.provider.ContactsContract.CommonDataKinds.Event.TYPE_BIRTHDAY -> "生日"
-                                        android.provider.ContactsContract.CommonDataKinds.Event.TYPE_ANNIVERSARY -> "纪念日"
-                                        else -> "其他"
-                                    }
-                                } else "其他"
-                                
-                                if (date.isNotBlank()) {
-                                    events.add(Contact.Event(type, date))
-                                }
-                            }
-                        }
-                        
-                        // 7. 读取所属群组
-                        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
-                            val groupUri = android.provider.ContactsContract.Data.CONTENT_URI
-                            val groupProjection = arrayOf(
-                                android.provider.ContactsContract.CommonDataKinds.GroupMembership.GROUP_ROW_ID
-                            )
-                            val groupSelection = "${android.provider.ContactsContract.Data.CONTACT_ID} = ? AND ${android.provider.ContactsContract.Data.MIMETYPE} = ?"
-                            val groupSelectionArgs = arrayOf(
-                                id.toString(),
-                                android.provider.ContactsContract.CommonDataKinds.GroupMembership.CONTENT_ITEM_TYPE
-                            )
-                            
-                            context.contentResolver.query(groupUri, groupProjection, groupSelection, groupSelectionArgs, null)?.use { groupCursor ->
-                                val groupIdColumn = groupCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.GroupMembership.GROUP_ROW_ID)
-                                
-                                while (groupCursor.moveToNext()) {
-                                    val groupId = if (groupIdColumn != -1) groupCursor.getLong(groupIdColumn) else -1
-                                    
-                                    if (groupId != -1L) {
-                                        // 根据组ID查询组名称
-                                        val groupNameUri = android.provider.ContactsContract.Groups.CONTENT_URI
-                                        val groupNameProjection = arrayOf(
-                                            android.provider.ContactsContract.Groups.TITLE
-                                        )
-                                        val groupNameSelection = "${android.provider.ContactsContract.Groups._ID} = ?"
-                                        val groupNameSelectionArgs = arrayOf(groupId.toString())
-                                        
-                                        context.contentResolver.query(groupNameUri, groupNameProjection, groupNameSelection, groupNameSelectionArgs, null)?.use { groupNameCursor ->
-                                            val groupNameColumn = groupNameCursor.getColumnIndex(android.provider.ContactsContract.Groups.TITLE)
-                                            
-                                            if (groupNameCursor.moveToFirst()) {
-                                                val groupName = if (groupNameColumn != -1) groupNameCursor.getString(groupNameColumn) else ""
-                                                if (groupName.isNotBlank()) {
-                                                    groups.add(groupName)
-                                                }
-                                            }
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                        
-                        // 8. 读取关系（如配偶、子女等）
-                        val relationUri = android.provider.ContactsContract.Data.CONTENT_URI
-                        val relationProjection = arrayOf(
-                            android.provider.ContactsContract.CommonDataKinds.Relation.NAME,
-                            android.provider.ContactsContract.CommonDataKinds.Relation.TYPE
-                        )
-                        val relationSelection = "${android.provider.ContactsContract.Data.CONTACT_ID} = ? AND ${android.provider.ContactsContract.Data.MIMETYPE} = ?"
-                        val relationSelectionArgs = arrayOf(
-                            id.toString(),
-                            android.provider.ContactsContract.CommonDataKinds.Relation.CONTENT_ITEM_TYPE
-                        )
-                        
-                        context.contentResolver.query(relationUri, relationProjection, relationSelection, relationSelectionArgs, null)?.use { relationCursor ->
-                            val nameColumn = relationCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Relation.NAME)
-                            val typeColumn = relationCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Relation.TYPE)
-                            
-                            while (relationCursor.moveToNext()) {
-                                val relName = if (nameColumn != -1) relationCursor.getString(nameColumn) else ""
-                                val relType = if (typeColumn != -1) {
-                                    when (relationCursor.getInt(typeColumn)) {
-                                        android.provider.ContactsContract.CommonDataKinds.Relation.TYPE_SPOUSE -> "配偶"
-                                        android.provider.ContactsContract.CommonDataKinds.Relation.TYPE_CHILD -> "子女"
-                                        android.provider.ContactsContract.CommonDataKinds.Relation.TYPE_PARENT -> "父母"
-                                        else -> "其他"
-                                    }
-                                } else "其他"
-                                
-                                if (relName.isNotBlank()) {
-                                    relationships.add(Contact.Relationship(relType, relName))
-                                }
-                            }
-                        }
-                        
-                        // 9. 读取社交资料
-                        val socialUri = android.provider.ContactsContract.Data.CONTENT_URI
-                        val socialProjection = arrayOf(
-                            android.provider.ContactsContract.Data.MIMETYPE,
-                            android.provider.ContactsContract.Data.DATA1,
-                            android.provider.ContactsContract.Data.DATA2
-                        )
-                        val socialSelection = "${android.provider.ContactsContract.Data.CONTACT_ID} = ? AND ${android.provider.ContactsContract.Data.MIMETYPE} IN (?, ?, ?)"
-                        val socialSelectionArgs = arrayOf(
-                            id.toString(),
-                            "vnd.android.cursor.item/com.whatsapp.profile",
-                            "vnd.android.cursor.item/com.facebook.profile",
-                            "vnd.android.cursor.item/com.twitter.android.profile"
-                        )
-                        
-                        context.contentResolver.query(socialUri, socialProjection, socialSelection, socialSelectionArgs, null)?.use { socialCursor ->
-                            val mimeTypeColumn = socialCursor.getColumnIndex(android.provider.ContactsContract.Data.MIMETYPE)
-                            val data1Column = socialCursor.getColumnIndex(android.provider.ContactsContract.Data.DATA1)
-                            
-                            while (socialCursor.moveToNext()) {
-                                val mimeType = if (mimeTypeColumn != -1) socialCursor.getString(mimeTypeColumn) else ""
-                                val data = if (data1Column != -1) socialCursor.getString(data1Column) else ""
-                                
-                                if (data.isNotBlank()) {
-                                    // 根据MIME类型确定社交媒体类型
-                                    val socialType = when {
-                                        mimeType.contains("whatsapp") -> "WhatsApp"
-                                        mimeType.contains("facebook") -> "Facebook"
-                                        mimeType.contains("twitter") -> "Twitter"
-                                        else -> "其他"
-                                    }
-                                    
-                                    socialProfiles.add(Contact.SocialProfile(socialType, data))
-                                }
-                            }
-                        }
-                        
-                        if (name.isNotBlank() || phoneNumbers.isNotEmpty() || emails.isNotEmpty()) {
-                            val contact = Contact(
-                                id = id,
-                                name = name,
-                                phoneNumbers = phoneNumbers,
-                                emails = if (emails.isNotEmpty()) emails else null,
-                                addresses = if (addresses.isNotEmpty()) addresses else null,
-                                note = note,
-                                groups = if (groups.isNotEmpty()) groups else null,
-                                websites = if (websites.isNotEmpty()) websites else null,
-                                events = if (events.isNotEmpty()) events else null,
-                                relationships = if (relationships.isNotEmpty()) relationships else null,
-                                socialProfiles = if (socialProfiles.isNotEmpty()) socialProfiles else null
-                            )
-                            contacts.add(contact)
-                        }
-                        
-                        // 每处理50个联系人，记录一下进度
-                        contactsProcessed++
-                        if (contactsProcessed % batchSize == 0) {
-                            Timber.d("[Mobile] DEBUG [Backup] 已处理 $contactsProcessed/${cursor.count} 个联系人")
-                        }
-                        
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Backup] 处理单个联系人时出错: ${e.message}")
-                        // 继续处理下一个联系人
-                    }
-                }
-            } ?: run {
-                Timber.e("[Mobile] ERROR [Backup] 备份联系人失败: 无法查询联系人内容提供者")
-                return null
-            }
-            
-            Timber.i("[Mobile] INFO [Backup] 成功读取 ${contacts.size} 个联系人")
-            
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Backup] 备份联系人异常: ${e.message}")
-            return null
-        }
-        
-        return contacts
-    }
-    
-    /**
-     * 备份结果数据类
-     */
-    data class BackupResult(
-        val timestamp: Date,
-        val messagesCount: Int = 0,
-        val callLogsCount: Int = 0,
-        val contactsCount: Int = 0,
-        val backupFilePath: String? = null,
-        val errorMessage: String? = null
-    ) {
-        val isSuccess: Boolean
-            get() = backupFilePath != null && errorMessage == null
-    }
-}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/RestoreManager.kt b/android/app/src/main/java/imken/messagevault/mobile/data/RestoreManager.kt
deleted file mode 100644
index 6b8789a..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/RestoreManager.kt
+++ /dev/null
@@ -1,1248 +0,0 @@
-package imken.messagevault.mobile.data
-
-import android.content.ContentProviderOperation
-import android.content.ContentResolver
-import android.content.ContentValues
-import android.content.Context
-import android.content.Intent
-import android.database.ContentObserver
-import android.net.Uri
-import android.os.Build
-import android.os.Handler
-import android.os.Looper
-import android.os.RemoteException
-import android.provider.ContactsContract
-import android.provider.Telephony
-import android.util.Log
-import com.google.gson.Gson
-import com.google.gson.reflect.TypeToken
-import imken.messagevault.mobile.BuildConfig
-import imken.messagevault.mobile.api.ApiClient
-import imken.messagevault.mobile.config.Config
-import imken.messagevault.mobile.model.BackupData
-import imken.messagevault.mobile.model.Contact
-import imken.messagevault.mobile.model.Message
-import imken.messagevault.mobile.model.CallLog as ModelCallLog
-import imken.messagevault.mobile.models.BackupFile
-import imken.messagevault.mobile.models.MessageData
-import imken.messagevault.mobile.utils.Constants.SUPPORTED_VERSION
-import imken.messagevault.mobile.utils.PhoneNumberUtils
-import kotlinx.coroutines.Dispatchers as KotlinDispatchers
-import kotlinx.coroutines.delay
-import kotlinx.coroutines.withContext
-import timber.log.Timber
-import java.io.File
-import java.io.FileReader
-import java.util.Date
-import java.util.concurrent.atomic.AtomicInteger
-import android.app.Activity
-import android.content.OperationApplicationException
-import android.provider.Settings as AndroidSettings
-import android.provider.CallLog as AndroidCallLog
-import android.widget.Toast
-import android.provider.Settings
-import android.content.pm.PackageManager
-import androidx.activity.result.ActivityResultLauncher
-
-/**
- * 消息实体类，用于数据处理
- */
-data class MessageEntity(
-    val id: Long,
-    val address: String?,
-    val body: String,
-    val date: Long,
-    val type: Int,
-    val read: Int,
-    val status: Int,
-    val threadId: Long
-)
-
-/**
- * 通话记录实体类，用于数据处理
- */
-data class CallLogsEntity(
-    val id: Long,
-    val number: String?,
-    val name: String,
-    val date: Long,
-    val duration: Long,
-    val type: Int
-)
-
-/**
- * 恢复管理器
- * 
- * 负责从备份文件恢复数据
- * 
- * @param context 应用上下文
- * @param config 应用配置
- * @param apiClient API客户端
- */
-class RestoreManager(
-    private val context: Context,
-    private val config: Config,
-    private val apiClient: ApiClient
-) {
-    private val gson = Gson()
-    private val contentResolver: ContentResolver = context.contentResolver
-    private val TAG = "RestoreManager"
-    private var successCount = 0
-    private var failureCount = 0
-    
-    /**
-     * 获取可用的备份文件列表
-     * 
-     * @return 备份文件列表
-     */
-    suspend fun getAvailableBackups(): List<BackupFile> = withContext(KotlinDispatchers.IO) {
-        val backupFiles = mutableListOf<BackupFile>()
-        
-        try {
-            // 使用config获取备份目录名称而不是硬编码字符串
-            val backupDir = File(context.getExternalFilesDir(null), config.getBackupDirectoryName())
-            
-            // 检查备份目录是否存在
-            if (!backupDir.exists()) {
-                Timber.w("[Mobile] WARN [Restore] 备份目录不存在: ${backupDir.absolutePath}")
-                return@withContext emptyList<BackupFile>()
-            }
-            
-            // 获取备份目录中的所有JSON文件
-            val files = backupDir.listFiles { file ->
-                file.isFile && file.name.endsWith(".json", ignoreCase = true)
-            }
-            
-            if (files != null) {
-                // 过滤无效的备份文件
-                val validFiles = files.filter { validateBackupFile(it) }
-                backupFiles.addAll(validFiles.map { file -> 
-                    val deviceId = AndroidSettings.Secure.getString(
-                        context.contentResolver, 
-                        AndroidSettings.Secure.ANDROID_ID
-                    ) ?: "unknown"
-                    
-                    // 解析备份文件以获取SMS和通话记录数量
-                    val fileReader = FileReader(file)
-                    val backupData = try {
-                        gson.fromJson(fileReader, BackupData::class.java)
-                    } catch (e: Exception) {
-                        null
-                    } finally {
-                        fileReader.close()
-                    }
-                    
-                    val smsCount = backupData?.messages?.size ?: 0
-                    val callLogsCount = backupData?.callLogs?.size ?: 0
-                    
-                    BackupFile(
-                        filePath = file.absolutePath,
-                        fileName = file.name,
-                        fileSize = file.length(),
-                        creationDate = Date(file.lastModified()),
-                        deviceName = deviceId,
-                        smsCount = smsCount,
-                        callLogsCount = callLogsCount,
-                        version = BuildConfig.VERSION_NAME
-                    )
-                }.sortedByDescending { it.creationDate.time })
-                Timber.i("[Mobile] INFO [Restore] 找到 ${validFiles.size} 个有效备份文件，总共 ${files.size} 个文件")
-            } else {
-                Timber.w("[Mobile] WARN [Restore] 无法列出备份目录中的文件: ${backupDir.absolutePath}")
-            }
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Restore] 获取备份文件列表失败: ${e.message}")
-        }
-        
-        return@withContext backupFiles
-    }
-    
-    /**
-     * 解析备份文件
-     * 
-     * @param backupFile 备份文件
-     * @return 备份数据对象，如果解析失败则返回null
-     */
-    suspend fun parseBackupFile(backupFile: BackupFile): BackupData? = withContext(KotlinDispatchers.IO) {
-        try {
-            val file = File(backupFile.filePath)
-            FileReader(file).use { reader ->
-                // 添加日志用于调试解析过程
-                val fileContent = file.readText()
-                val containsCallLogs = fileContent.contains("\"callLogs\"") || fileContent.contains("\"call_logs\"")
-                val containsMessages = fileContent.contains("\"messages\"") || fileContent.contains("\"sms\"")
-                val containsContacts = fileContent.contains("\"contacts\"")
-                
-                Timber.d("[Mobile] DEBUG [Restore] 备份文件内容分析: 包含通话记录=$containsCallLogs, 包含短信=$containsMessages, 包含联系人=$containsContacts")
-                
-                val typeToken = object : TypeToken<BackupData>() {}.type
-                val backupData = gson.fromJson<BackupData>(reader, typeToken)
-                if (backupData == null) {
-                    Timber.e("[Mobile] ERROR [Restore] 解析备份文件返回null: ${backupFile.fileName}")
-                    return@withContext null
-                }
-                
-                // 检查消息列表是否为null，如果是则设置为空列表
-                val messagesCount = backupData.messages?.size ?: 0
-                val callLogsCount = backupData.callLogs?.size ?: 0
-                val contactsCount = backupData.contacts?.size ?: 0
-                
-                Timber.i("[Mobile] INFO [Restore] 成功解析备份文件: ${backupFile.fileName}, 短信数量: $messagesCount, 通话记录数量: $callLogsCount, 联系人数量: $contactsCount")
-                
-                // 额外日志用于调试
-                if (containsCallLogs && callLogsCount == 0) {
-                    Timber.w("[Mobile] WARN [Restore] 文件中包含通话记录字段但解析后为空，可能是字段名不匹配")
-                }
-                
-                return@withContext backupData
-            }
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Restore] 解析备份文件失败: ${backupFile.fileName}, ${e.message}")
-            return@withContext null
-        }
-    }
-    
-    /**
-     * 从备份文件恢复数据
-     * 
-     * @param backupFile 备份文件
-     * @return 恢复结果
-     */
-    suspend fun restoreFromFile(backupFile: BackupFile): RestoreResult = withContext(KotlinDispatchers.IO) {
-        return@withContext restoreFromFile(backupFile, null)
-    }
-    
-    /**
-     * 进度回调接口
-     */
-    interface ProgressCallback {
-        fun onStart(operation: String)
-        fun onProgressUpdate(operation: String, progress: Int)
-        fun onProgressUpdate(operation: String, progress: Int, message: String)
-        fun onComplete(success: Boolean, message: String = "")
-    }
-    
-    /**
-     * 从备份文件恢复数据，带进度报告
-     * 
-     * @param backupFile 备份文件
-     * @param progressCallback 进度回调接口
-     * @return 恢复结果
-     */
-    suspend fun restoreFromFile(
-        backupFile: BackupFile, 
-        progressCallback: ProgressCallback?
-    ): RestoreResult = withContext(KotlinDispatchers.IO) {
-        try {
-            // 添加基础日志
-            Timber.d("[Mobile] DEBUG [Restore] 开始恢复文件: ${backupFile.fileName}")
-            progressCallback?.onProgressUpdate("准备", 0, "开始恢复文件")
-            
-            val backupData = parseBackupFile(backupFile) ?: return@withContext RestoreResult(false, "无法解析备份文件")
-            progressCallback?.onProgressUpdate("解析", 10, "备份文件解析完成")
-            
-            // 检查是否需要恢复短信
-            val hasSms = !backupData.messages.isNullOrEmpty()
-            
-            // 如果有短信需要恢复，检查是否为默认短信应用
-            if (hasSms) {
-                val isDefault = isDefaultSmsApp()
-                Timber.i("[Mobile] INFO [Restore] 备份包含短信, 是否为默认短信应用: $isDefault")
-                
-                if (!isDefault) {
-                    Timber.w("[Mobile] WARN [Restore] 当前应用不是默认短信应用，无法写入短信数据库")
-                    return@withContext RestoreResult(
-                        success = false,
-                        message = "恢复短信需要将此应用设为默认短信应用，请在系统设置中更改"
-                    )
-                }
-            }
-            
-            // 恢复短信
-            val messagesSize = backupData.messages?.size ?: 0
-            
-            var restoredSmsCount = 0
-            if (hasSms) {
-                val messages = backupData.messages!!
-                Timber.d("[Mobile] DEBUG [Restore] 准备恢复短信，数量: ${messages.size}")
-                progressCallback?.onProgressUpdate("短信", 20, "开始恢复 ${messages.size} 条短信")
-                
-                try {
-                    // 分批恢复短信并报告进度
-                    restoredSmsCount = restoreMessagesWithProgress(messages, progressCallback)
-                    Timber.i("[Mobile] INFO [Restore] 短信恢复结果: 成功恢复 $restoredSmsCount/${messages.size} 条短信")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Restore] 短信恢复过程中发生异常: ${e.message}")
-                }
-            } else {
-                Timber.i("[Mobile] INFO [Restore] 备份不包含短信数据，跳过短信恢复")
-            }
-            
-            progressCallback?.onProgressUpdate("短信", 40, "完成短信恢复 ($restoredSmsCount/$messagesSize)")
-            
-            // 恢复通话记录
-            val hasCallLogs = !backupData.callLogs.isNullOrEmpty()
-            val callLogsSize = backupData.callLogs?.size ?: 0
-            
-            Timber.d("[Mobile] DEBUG [Restore] 检测到通话记录: $hasCallLogs, 数量: $callLogsSize")
-            
-            var restoredCallLogsCount = 0
-            if (hasCallLogs) {
-                val callLogs = backupData.callLogs!!
-                Timber.d("[Mobile] DEBUG [Restore] 准备恢复通话记录，数量: ${callLogs.size}")
-                progressCallback?.onProgressUpdate("通话记录", 50, "开始恢复 ${callLogs.size} 条通话记录")
-                
-                try {
-                    // 分批恢复通话记录并报告进度
-                    restoredCallLogsCount = restoreCallLogsWithProgress(callLogs, progressCallback)
-                    Timber.i("[Mobile] INFO [Restore] 通话记录恢复结果: 成功恢复 $restoredCallLogsCount/${callLogs.size} 条通话记录")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Restore] 通话记录恢复过程中发生异常: ${e.message}")
-                }
-            } else {
-                Timber.i("[Mobile] INFO [Restore] 备份不包含通话记录数据，跳过通话记录恢复")
-            }
-            
-            progressCallback?.onProgressUpdate("通话记录", 70, "完成通话记录恢复 ($restoredCallLogsCount/$callLogsSize)")
-            
-            // 恢复联系人
-            val contactsSize = backupData.contacts?.size ?: 0
-            
-            var restoredContactsCount = 0
-            if (contactsSize > 0) {
-                val contacts = backupData.contacts!!
-                Timber.d("[Mobile] DEBUG [Restore] 准备恢复联系人，数量: ${contacts.size}")
-                progressCallback?.onProgressUpdate("联系人", 80, "开始恢复 ${contacts.size} 个联系人")
-                
-                try {
-                    // 分批恢复联系人并报告进度
-                    restoredContactsCount = restoreContactsWithProgress(contacts, progressCallback)
-                    Timber.i("[Mobile] INFO [Restore] 联系人恢复结果: 成功恢复 $restoredContactsCount/${contacts.size} 个联系人")
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Restore] 联系人恢复过程中发生异常: ${e.message}")
-                }
-            } else {
-                Timber.i("[Mobile] INFO [Restore] 备份不包含联系人数据，跳过联系人恢复")
-            }
-            
-            progressCallback?.onProgressUpdate("完成", 100, "恢复完成")
-            
-            // 计算总体结果，即使某个部分失败也应该继续其他部分的恢复
-            val totalSuccess = restoredSmsCount > 0 || restoredCallLogsCount > 0 || restoredContactsCount > 0
-            val resultMessage = if (totalSuccess) {
-                "成功恢复 $restoredSmsCount 条短信、$restoredCallLogsCount 条通话记录和 $restoredContactsCount 位联系人"
-            } else {
-                "恢复失败: 没有任何数据恢复成功"
-            }
-            
-            Timber.i("[Mobile] INFO [Restore] 恢复完成; 恢复短信: $restoredSmsCount/${backupData.messages?.size ?: 0}, 恢复通话记录: $restoredCallLogsCount/${backupData.callLogs?.size ?: 0}, 恢复联系人: $restoredContactsCount/${backupData.contacts?.size ?: 0}")
-            
-            return@withContext RestoreResult(
-                success = totalSuccess,
-                message = resultMessage
-            )
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Restore] 恢复数据失败: ${e.message}")
-            return@withContext RestoreResult(false, "恢复失败: ${e.message}")
-        }
-    }
-    
-    /**
-     * 分批恢复短信并报告进度
-     */
-    private suspend fun restoreMessagesWithProgress(
-        messages: List<Message>,
-        progressCallback: ProgressCallback?
-    ): Int = withContext(KotlinDispatchers.IO) {
-        var restoredCount = 0
-        val totalCount = messages.size
-        Timber.i("[Mobile] INFO [Restore] 开始恢复短信，总数: $totalCount")
-        
-        // 计算进度更新频率
-        val progressStep = if (totalCount > 100) totalCount / 20 else 1
-        
-        // 验证并修复消息地址
-        val fixedMessages = validateAndFixMessageAddresses(messages)
-        
-        // 按联系人分组短信，提高批量恢复效率
-        val messagesByContact = fixedMessages.groupBy { it.address }
-        
-        var processedCount = 0
-        
-        // 恢复所有短信
-        for ((address, contactMessages) in messagesByContact) {
-            Timber.d("[Mobile] DEBUG [Restore] 处理联系人消息: 联系人=$address, 消息数量=${contactMessages.size}")
-            
-            // 排序消息按日期从旧到新
-            val sortedMessages = contactMessages.sortedBy { it.date }
-            
-            for (smsMessage in sortedMessages) {
-                try {
-                    // 创建短信内容值
-                    val values = ContentValues().apply {
-                        put(Telephony.Sms.ADDRESS, smsMessage.address)
-                        put(Telephony.Sms.BODY, smsMessage.body)
-                        put(Telephony.Sms.DATE, smsMessage.date)
-                        put(Telephony.Sms.TYPE, smsMessage.type)
-                        put(Telephony.Sms.READ, smsMessage.readState ?: 0)
-                        put(Telephony.Sms.STATUS, smsMessage.messageStatus ?: 0)
-                        
-                        // 如果有线程ID
-                        if (smsMessage.threadId != null && smsMessage.threadId > 0) {
-                            put(Telephony.Sms.THREAD_ID, smsMessage.threadId)
-                        }
-                    }
-                    
-                    // 插入短信
-                    val uri = contentResolver.insert(Telephony.Sms.CONTENT_URI, values)
-                    if (uri != null) {
-                        restoredCount++
-                    }
-                    
-                    processedCount++
-                    // 报告进度
-                    if (processedCount % progressStep == 0 || processedCount == totalCount) {
-                        val currentProgress = (processedCount * 100) / totalCount
-                        val progressMessage = "恢复短信进度: $processedCount/$totalCount"
-                        progressCallback?.onProgressUpdate("短信", currentProgress, progressMessage)
-                        Timber.d("[Mobile] DEBUG [Restore] $progressMessage ($currentProgress%)")
-                    }
-                    
-                    // 每处理10条消息暂停一下，避免系统过载
-                    if (processedCount % 10 == 0) {
-                        delay(50)
-                    }
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Restore] 恢复短信失败: 地址=${smsMessage.address}, ${e.message}")
-                }
-            }
-            
-            // 每处理完一个联系人的所有消息后暂停一下
-            delay(100)
-        }
-        
-        Timber.i("[Mobile] INFO [Restore] 短信恢复完成: 成功=$restoredCount, 总数=$totalCount")
-        return@withContext restoredCount
-    }
-    
-    /**
-     * 验证并修复短信地址列表，避免出现"unknown"联系人问题
-     * 
-     * 此方法检查并修复备份数据中可能存在的问题：
-     * 1. 空地址会导致短信显示为"未知"联系人
-     * 2. 重复的ThreadID问题导致短信被错误地归类
-     * 
-     * @param messages 原始短信列表
-     * @return 修复后的短信列表
-     */
-    private fun validateAndFixMessageAddresses(messages: List<Message>): List<Message> {
-        Timber.d("[Mobile] DEBUG [Restore] 开始验证和修复短信地址，数量: ${messages.size}")
-        
-        // 导入电话号码工具类
-        val phoneNumberUtils = PhoneNumberUtils
-        
-        // 统计空地址数量
-        val emptyAddressCount = messages.count { it.address.isNullOrBlank() }
-        if (emptyAddressCount > 0) {
-            Timber.w("[Mobile] WARN [Restore] 发现 $emptyAddressCount 条短信缺少有效地址，将进行修复")
-        }
-        
-        // 修复并标准化短信地址
-        return messages.map { originalMessage ->
-            // 处理空地址情况
-            if (originalMessage.address.isNullOrBlank()) {
-                // 创建新消息对象而不是修改原对象，避免引用问题
-                Message(
-                    id = originalMessage.id,
-                    address = "unknown_${originalMessage.id}", // 使用ID作为唯一标识符
-                    body = originalMessage.body,
-                    date = originalMessage.date,
-                    type = originalMessage.type,
-                    readState = originalMessage.readState,
-                    messageStatus = originalMessage.messageStatus,
-                    threadId = originalMessage.threadId
-                )
-            } else {
-                // 标准化电话号码
-                val normalizedAddress = phoneNumberUtils.normalizePhoneNumber(originalMessage.address)
-                
-                // 如果地址标准化后不同，创建新的消息对象
-                if (normalizedAddress != originalMessage.address) {
-                    Timber.d("[Mobile] DEBUG [Restore] 标准化地址: ${originalMessage.address} -> $normalizedAddress")
-                    
-                    Message(
-                        id = originalMessage.id,
-                        address = normalizedAddress, // 使用标准化后的地址
-                        body = originalMessage.body,
-                        date = originalMessage.date,
-                        type = originalMessage.type,
-                        readState = originalMessage.readState,
-                        messageStatus = originalMessage.messageStatus,
-                        threadId = originalMessage.threadId
-                    )
-                } else {
-                    // 有效地址且无需标准化，直接使用原消息
-                    originalMessage
-                }
-            }
-        }
-    }
-    
-    /**
-     * 分批恢复通话记录并报告进度
-     */
-    private suspend fun restoreCallLogsWithProgress(
-        callLogs: List<ModelCallLog>,
-        progressCallback: ProgressCallback?
-    ): Int = withContext(KotlinDispatchers.IO) {
-        var restoredCount = 0
-        val totalCount = callLogs.size
-        Timber.i("[Mobile] INFO [Restore] 开始恢复通话记录，总数: $totalCount")
-        
-        // 检查权限
-        if (!hasCallLogPermissions()) {
-            Timber.e("[Mobile] ERROR [Restore] 没有通话记录权限，无法恢复")
-            return@withContext 0
-        }
-        
-        // 计算进度更新频率
-        val progressStep = if (totalCount > 100) totalCount / 20 else 1
-        
-        // 预处理通话记录，修复电话号码格式
-        val fixedCallLogs = callLogs.map { callLog ->
-            // 如果号码为空，使用原始记录
-            if (callLog.number.isNullOrBlank()) {
-                callLog
-            } else {
-                // 规范化电话号码
-                val normalizedNumber = PhoneNumberUtils.normalizePhoneNumber(callLog.number)
-                if (normalizedNumber != callLog.number) {
-                    Timber.d("[Mobile] DEBUG [Restore] 通话记录号码已规范化: ${callLog.number} -> $normalizedNumber")
-                    // 创建新对象并保留其他属性
-                    callLog.copy(number = normalizedNumber)
-                } else {
-                    callLog
-                }
-            }
-        }
-        
-        // 按联系人分组通话记录，提高批量恢复效率
-        val callLogsByNumber = mutableMapOf<String, MutableList<ModelCallLog>>()
-        
-        // 为每个通话记录找到正确的分组键
-        fixedCallLogs.forEach { callLog ->
-            if (!callLog.number.isNullOrBlank()) {
-                // 获取此号码的所有可能变体
-                val normalized = PhoneNumberUtils.normalizePhoneNumber(callLog.number)
-                
-                // 将通话记录添加到对应的分组
-                if (!callLogsByNumber.containsKey(normalized)) {
-                    callLogsByNumber[normalized] = mutableListOf()
-                }
-                callLogsByNumber[normalized]!!.add(callLog)
-            } else {
-                // 处理号码为空的情况
-                val unknownKey = "unknown_${callLog.id}"
-                if (!callLogsByNumber.containsKey(unknownKey)) {
-                    callLogsByNumber[unknownKey] = mutableListOf()
-                }
-                callLogsByNumber[unknownKey]!!.add(callLog)
-            }
-        }
-        
-        Timber.d("[Mobile] DEBUG [Restore] 按规范化号码分组后，共有 ${callLogsByNumber.size} 个不同联系人")
-        
-        var processedCount = 0
-        
-        // 恢复所有通话记录
-        for ((_, numberCallLogs) in callLogsByNumber) {
-            for (callLog in numberCallLogs) {
-                try {
-                    val values = ContentValues().apply {
-                        put(AndroidCallLog.Calls.NUMBER, callLog.number ?: "")
-                        put(AndroidCallLog.Calls.TYPE, callLog.type)
-                        put(AndroidCallLog.Calls.DATE, callLog.date.toLong())
-                        put(AndroidCallLog.Calls.DURATION, callLog.duration.toLong())
-                        put(AndroidCallLog.Calls.NEW, 0) // 标记为已读
-                        
-                        // 尝试匹配联系人
-                        if (!callLog.number.isNullOrBlank()) {
-                            val contactName = getContactNameFromNumber(callLog.number)
-                            if (contactName != null) {
-                                put(AndroidCallLog.Calls.CACHED_NAME, contactName)
-                                Timber.d("[Mobile] DEBUG [Restore] 通话记录匹配到联系人: ${callLog.number} -> $contactName")
-                            }
-                        }
-                    }
-                    
-                    val uri = contentResolver.insert(AndroidCallLog.Calls.CONTENT_URI, values)
-                    if (uri != null) {
-                        restoredCount++
-                    }
-                    
-                    processedCount++
-                    // 报告进度
-                    if (processedCount % progressStep == 0 || processedCount == totalCount) {
-                        val currentProgress = (processedCount * 100) / totalCount
-                        val progressMessage = "恢复通话记录进度: $processedCount/$totalCount"
-                        progressCallback?.onProgressUpdate("通话记录", currentProgress, progressMessage)
-                        Timber.d("[Mobile] DEBUG [Restore] $progressMessage ($currentProgress%)")
-                    }
-                    
-                    // 每处理10条记录暂停一下，避免系统过载
-                    if (processedCount % 10 == 0) {
-                        delay(50)
-                    }
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Restore] 恢复通话记录失败: 号码=${callLog.number}, ${e.message}")
-                }
-            }
-            
-            // 每处理完一个联系人的所有记录后暂停一下
-            delay(100)
-        }
-        
-        Timber.i("[Mobile] INFO [Restore] 通话记录恢复完成: 成功=$restoredCount, 总数=$totalCount")
-        return@withContext restoredCount
-    }
-    
-    /**
-     * 从电话号码获取联系人姓名，使用电话号码变体增强匹配率
-     */
-    private fun getContactNameFromNumber(phoneNumber: String): String? {
-        if (phoneNumber.isBlank()) return null
-        
-        // 首先尝试直接匹配原始号码
-        val name = getContactNameByExactNumber(phoneNumber)
-        if (name != null) return name
-        
-        // 若直接匹配失败，尝试匹配所有可能的变体
-        val variants = PhoneNumberUtils.getPossibleNumberVariants(phoneNumber)
-        for (variant in variants) {
-            val variantName = getContactNameByExactNumber(variant)
-            if (variantName != null) {
-                Timber.d("[Mobile] DEBUG [Restore] 通过号码变体匹配到联系人: $phoneNumber -> $variant -> $variantName")
-                return variantName
-            }
-        }
-        
-        return null
-    }
-    
-    /**
-     * 通过精确号码查询联系人姓名
-     */
-    private fun getContactNameByExactNumber(phoneNumber: String): String? {
-        val uri = Uri.withAppendedPath(ContactsContract.PhoneLookup.CONTENT_FILTER_URI, Uri.encode(phoneNumber))
-        val projection = arrayOf(ContactsContract.PhoneLookup.DISPLAY_NAME)
-        
-        try {
-            val cursor = contentResolver.query(uri, projection, null, null, null)
-            cursor?.use {
-                if (it.moveToFirst()) {
-                    return it.getString(it.getColumnIndexOrThrow(ContactsContract.PhoneLookup.DISPLAY_NAME))
-                }
-            }
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Restore] 查询联系人姓名失败: 号码=$phoneNumber, ${e.message}")
-        }
-        
-        return null
-    }
-    
-    /**
-     * 检查是否有通话记录权限
-     */
-    private fun hasCallLogPermissions(): Boolean {
-        val readPermission = android.Manifest.permission.READ_CALL_LOG
-        val writePermission = android.Manifest.permission.WRITE_CALL_LOG
-        
-        val readGranted = context.checkSelfPermission(readPermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
-        val writeGranted = context.checkSelfPermission(writePermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
-        
-        if (!readGranted || !writeGranted) {
-            Timber.e("[Mobile] ERROR [Restore] 缺少通话记录权限: READ_CALL_LOG=$readGranted, WRITE_CALL_LOG=$writeGranted")
-            return false
-        }
-        
-        return true
-    }
-    
-    /**
-     * 分批恢复联系人并报告进度
-     */
-    private suspend fun restoreContactsWithProgress(
-        contacts: List<Contact>,
-        progressCallback: ProgressCallback?
-    ): Int = withContext(KotlinDispatchers.IO) {
-        var restoredCount = 0
-        val totalCount = contacts.size
-        Timber.i("[Mobile] INFO [Restore] 开始恢复联系人，总数: $totalCount")
-        
-        // 检查权限
-        if (!hasContactsPermissions()) {
-            Timber.e("[Mobile] ERROR [Restore] 没有联系人权限，无法恢复联系人")
-            return@withContext 0
-        }
-        
-        // 计算进度更新频率
-        val progressStep = if (totalCount > 100) totalCount / 10 else 1
-        
-        contacts.forEachIndexed { index, contact ->
-            try {
-                val operations = ArrayList<ContentProviderOperation>()
-                
-                // 创建联系人
-                val rawContactInsertIndex = operations.size
-                operations.add(ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
-                    .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, null)
-                    .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, null)
-                    .build())
-                
-                // 添加姓名
-                operations.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
-                    .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, rawContactInsertIndex)
-                    .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)
-                    .withValue(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, contact.name)
-                    .build())
-                
-                // 添加电话号码
-                contact.phoneNumbers.forEach { phoneNumber ->
-                    operations.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
-                        .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, rawContactInsertIndex)
-                        .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)
-                        .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phoneNumber)
-                        .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE)
-                        .build())
-                }
-                
-                try {
-                    // 应用批处理操作
-                    val results = contentResolver.applyBatch(ContactsContract.AUTHORITY, operations)
-                    if (results.isNotEmpty()) {
-                        restoredCount++
-                    }
-                } catch (e: Exception) {
-                    Timber.e(e, "[Mobile] ERROR [Restore] 恢复联系人失败: 批处理操作异常: ${e.message}")
-                }
-                
-                // 报告进度
-                if (index % progressStep == 0 || index == totalCount - 1) {
-                    val currentProgress = ((index + 1) * 100) / totalCount
-                    val progressMessage = "恢复联系人进度: ${index + 1}/$totalCount"
-                    progressCallback?.onProgressUpdate("联系人", currentProgress, progressMessage)
-                    Timber.d("[Mobile] DEBUG [Restore] $progressMessage ($currentProgress%)")
-                }
-            } catch (e: Exception) {
-                Timber.e(e, "[Mobile] ERROR [Restore] 恢复联系人失败: ID=${contact.id}, 姓名=${contact.name}, ${e.message}")
-            }
-        }
-        
-        Timber.i("[Mobile] INFO [Restore] 联系人恢复完成: 成功=$restoredCount, 总数=$totalCount")
-        return@withContext restoredCount
-    }
-    
-    /**
-     * 检查是否有短信权限
-     */
-    private fun hasSmsPermissions(): Boolean {
-        val readPermission = android.Manifest.permission.READ_SMS
-        val sendPermission = android.Manifest.permission.SEND_SMS
-        val receivePermission = android.Manifest.permission.RECEIVE_SMS
-        
-        val readGranted = context.checkSelfPermission(readPermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
-        val sendGranted = context.checkSelfPermission(sendPermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
-        val receiveGranted = context.checkSelfPermission(receivePermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
-        
-        if (!readGranted || !sendGranted) {
-            Timber.e("[Mobile] ERROR [Restore] 缺少短信权限: READ_SMS=$readGranted, SEND_SMS=$sendGranted, RECEIVE_SMS=$receiveGranted")
-            return false
-        }
-        
-        return true
-    }
-    
-    /**
-     * 检查是否有联系人权限
-     */
-    private fun hasContactsPermissions(): Boolean {
-        val readPermission = android.Manifest.permission.READ_CONTACTS
-        val writePermission = android.Manifest.permission.WRITE_CONTACTS
-        
-        val readGranted = context.checkSelfPermission(readPermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
-        val writeGranted = context.checkSelfPermission(writePermission) == android.content.pm.PackageManager.PERMISSION_GRANTED
-        
-        if (!readGranted || !writeGranted) {
-            Timber.e("[Mobile] ERROR [Restore] 缺少联系人权限: READ_CONTACTS=$readGranted, WRITE_CONTACTS=$writeGranted")
-            return false
-        }
-        
-        return true
-    }
-    
-    /**
-     * 验证备份文件
-     * 
-     * @param file 备份文件
-     * @return 如果备份文件有效则返回true，否则返回false
-     */
-    private fun validateBackupFile(file: File): Boolean {
-        if (!file.exists() || !file.isFile || !file.canRead()) {
-            return false
-        }
-        
-        try {
-            FileReader(file).use { reader ->
-                val typeToken = object : TypeToken<BackupData>() {}.type
-                val backupData = gson.fromJson<BackupData>(reader, typeToken)
-                // 如果BackupData类中没有formatVersion字段，则始终返回true
-                return backupData != null
-            }
-        } catch (e: Exception) {
-            Timber.e(e, "[Mobile] ERROR [Restore] 验证备份文件失败: ${file.name}, ${e.message}")
-            return false
-        }
-    }
-    
-    /**
-     * 处理备份文件
-     * 
-     * @param backupFile 备份文件
-     */
-    private fun someRestoreMethod(backupFile: BackupFile) {
-        println("处理备份文件: ${backupFile.fileName}")
-    }
-    
-    /**
-     * 读取状态的方法
-     * 
-     * @return 读取状态
-     */
-    private fun readState(): Any {
-        return Any() // 临时返回
-    }
-    
-    /**
-     * 消息状态字段
-     */
-    private val messageStatus: Any = Any()
-    
-    /**
-     * 读取状态枚举
-     */
-    private enum class ReadState {
-        READ, UNREAD
-    }
-    
-    /**
-     * 消息状态枚举
-     */
-    private enum class MessageStatus {
-        RECEIVED, SENT
-    }
-    
-    /**
-     * 获取读取状态
-     * 
-     * @param value 值
-     * @return 读取状态
-     */
-    private fun getReadState(value: Int): ReadState {
-        return if (value == 1) ReadState.READ else ReadState.UNREAD
-    }
-    
-    /**
-     * 获取消息状态
-     * 
-     * @param value 值
-     * @return 消息状态
-     */
-    private fun getMessageStatus(value: Int): MessageStatus {
-        return if (value == 1) MessageStatus.RECEIVED else MessageStatus.SENT
-    }
-    
-    /**
-     * 记录错误日志
-     * 
-     * @param message 消息
-     */
-    private fun logError(message: String) {
-        Log.e(TAG, message)
-    }
-    
-    /**
-     * 将消息模型转换为实体
-     * 
-     * @param message 消息
-     * @return 消息实体
-     */
-    private fun Message.toMessageEntity(): MessageEntity {
-        return MessageEntity(
-            id = this.id,
-            address = this.address,
-            body = this.body ?: "",
-            date = this.date,
-            type = this.type,
-            read = this.readState ?: 0,
-            status = this.messageStatus ?: 0,
-            threadId = this.threadId ?: 0
-        )
-    }
-    
-    /**
-     * 将通话记录模型转换为实体
-     * 
-     * @param callLog 通话记录
-     * @return 通话记录实体
-     */
-    private fun ModelCallLog.toCallLogEntity(): CallLogsEntity {
-        return CallLogsEntity(
-            // 使用固定值0代替id，让Room自动生成主键
-            id = 0L,
-            number = this.number,
-            name = this.contact ?: "",
-            date = this.date.toLong(),
-            duration = this.duration.toLong(),
-            type = this.type
-        )
-    }
-    
-    /**
-     * 将消息数据模型转换为实体
-     * 
-     * @param messageData 消息数据
-     * @return 消息实体
-     */
-    private fun MessageData.toMessageEntity(): MessageEntity {
-        return MessageEntity(
-            id = this.id,
-            address = this.address,
-            body = this.body ?: "",
-            date = this.date,
-            type = this.type,
-            read = this.readState,
-            status = this.messageStatus,
-            threadId = this.threadId?.toLong() ?: 0L
-        )
-    }
-    
-    /**
-     * 修复 line 242 和 243 的 ContentValues.put 歧义
-     */
-    private fun createMessageContentValues(message: Message): ContentValues {
-        val values = ContentValues()
-        values.put("column_name", message.address) // 不再使用as String显式指定类型
-        values.put("another_column", message.body) // 不再使用as String显式指定类型
-        return values
-    }
-    
-    /**
-     * 获取协议类型
-     */
-    private fun getProtocolFromType(type: Int): String {
-        return when(type) {
-            1 -> "sms"
-            2 -> "mms"
-            else -> "unknown"
-        }
-    }
-    
-    /**
-     * 修复缺少参数的方法调用
-     */
-    private fun someMethod() {
-        // 删除无效的方法调用代码
-    }
-    
-    /**
-     * 定义TAG常量
-     */
-    companion object {
-        private const val BACKUP_FORMAT_VERSION = SUPPORTED_VERSION
-        const val DEFAULT_SMS_REQUEST_CODE = 1001
-        const val PERMISSIONS_REQUEST_CODE = 1002
-    }
-    
-    /**
-     * 恢复结果数据类
-     */
-    data class RestoreResult(
-        val success: Boolean,
-        val message: String
-    )
-    
-    /**
-     * 检查当前应用是否为默认短信应用
-     */
-    private fun isDefaultSmsApp(): Boolean {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
-            try {
-                // 优先使用RoleManager（Android 10+）
-                var roleManagerResult = false
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
-                    try {
-                        val roleManager = context.getSystemService(Context.ROLE_SERVICE) as? android.app.role.RoleManager
-                        if (roleManager != null) {
-                            roleManagerResult = roleManager.isRoleHeld(android.app.role.RoleManager.ROLE_SMS)
-                            Timber.d("[Mobile] DEBUG [Restore] RoleManager检查结果: $roleManagerResult")
-                            if (roleManagerResult) {
-                                return true
-                            }
-                        }
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Restore] 检查RoleManager时出错")
-                    }
-                }
-                
-                // 如果RoleManager检查未成功或不可用，使用传统方法
-                val defaultSmsPackage = Telephony.Sms.getDefaultSmsPackage(context)
-                val isTelephonyDefault = defaultSmsPackage == context.packageName
-                
-                // 添加详细日志
-                Timber.d("[Mobile] DEBUG [Restore] 默认短信应用检查 - 当前应用: ${context.packageName}, 系统默认: $defaultSmsPackage, 是默认: $isTelephonyDefault")
-                
-                return isTelephonyDefault
-            } catch (e: Exception) {
-                Timber.e(e, "[Mobile] ERROR [Restore] 检查默认短信应用状态时发生错误")
-                return false
-            }
-        }
-        return true // 在较旧版本中不需要是默认短信应用
-    }
-    
-    /**
-     * 请求设置为默认短信应用
-     * 
-     * 此方法用于向系统请求将当前应用设置为默认短信应用。它应该启动来自调用Activity的
-     * ActivityResultLauncher而不是直接调用startActivityForResult。
-     * 
-     * 在Android 4.4 (KitKat)及以上版本中，只有被设置为默认短信应用的应用才能写入短信数据库。
-     * 这是Android系统的安全限制，目的是防止恶意应用滥用短信功能。
-     * 
-     * @param activity 发起请求的Activity，用于获取RoleManager和创建Intent
-     * @param launcher ActivityResultLauncher<Intent>用于处理结果回调
-     */
-    fun requestDefaultSmsApp(activity: Activity, launcher: ActivityResultLauncher<Intent>) {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
-            try {
-                Timber.d("[Mobile] DEBUG [Restore] 开始请求默认短信应用权限，Android版本: ${Build.VERSION.SDK_INT}")
-                var requestSent = false
-                
-                // 尝试使用RoleManager API (Android 10+)
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
-                    try {
-                        val roleManager = activity.getSystemService(Context.ROLE_SERVICE) as? android.app.role.RoleManager
-                        if (roleManager != null) {
-                            // 检查角色是否可用
-                            if (roleManager.isRoleAvailable(android.app.role.RoleManager.ROLE_SMS)) {
-                                // 检查应用是否已持有角色
-                                val hasRole = roleManager.isRoleHeld(android.app.role.RoleManager.ROLE_SMS)
-                                Timber.d("[Mobile] DEBUG [Restore] RoleManager检查结果: $hasRole")
-                                
-                                if (!hasRole) {
-                                    // 使用ActivityResultLauncher请求SMS角色
-                                    val roleRequestIntent = roleManager.createRequestRoleIntent(android.app.role.RoleManager.ROLE_SMS)
-                                    launcher.launch(roleRequestIntent)
-                                    Timber.d("[Mobile] DEBUG [Restore] 已使用角色管理器发送SMS角色请求")
-                                    requestSent = true
-                                } else {
-                                    Timber.i("[Mobile] INFO [Restore] 应用已持有SMS角色，无需再次请求")
-                                    return
-                                }
-                            } else {
-                                Timber.w("[Mobile] WARN [Restore] 此设备的RoleManager不支持SMS角色")
-                            }
-                        } else {
-                            Timber.w("[Mobile] WARN [Restore] 无法获取RoleManager服务")
-                        }
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Restore] 使用RoleManager请求SMS角色失败: ${e.message}")
-                    }
-                }
-                
-                // 如果RoleManager方法未成功，使用传统方法
-                if (!requestSent) {
-                    // 传统方法（适用于Android 4.4+）
-                    val intent = Intent(Telephony.Sms.Intents.ACTION_CHANGE_DEFAULT)
-                    intent.putExtra(Telephony.Sms.Intents.EXTRA_PACKAGE_NAME, activity.packageName)
-                    
-                    if (intent.resolveActivity(activity.packageManager) != null) {
-                        launcher.launch(intent)
-                        Timber.d("[Mobile] DEBUG [Restore] 已发送默认短信应用请求（传统方法）")
-                        requestSent = true
-                    } else {
-                        Timber.w("[Mobile] WARN [Restore] 无法找到处理默认短信应用请求的系统组件")
-                    }
-                }
-                
-                // 如果上面的方法都失败，尝试使用备选方法
-                if (!requestSent) {
-                    // 尝试打开系统默认应用设置页面
-                    try {
-                        // 先尝试使用默认应用设置页面
-                        val defaultAppsIntent = Intent(Settings.ACTION_MANAGE_DEFAULT_APPS_SETTINGS)
-                        if (defaultAppsIntent.resolveActivity(activity.packageManager) != null) {
-                            activity.startActivity(defaultAppsIntent)
-                            Timber.d("[Mobile] DEBUG [Restore] 已打开默认应用设置页面")
-                            
-                            // 提示用户手动设置
-                            Toast.makeText(
-                                activity, 
-                                "请在默认应用设置中将本应用设为默认短信应用", 
-                                Toast.LENGTH_LONG
-                            ).show()
-                            requestSent = true
-                        }
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Restore] 无法打开默认应用设置: ${e.message}")
-                    }
-                    
-                    // 如果默认应用设置页面也失败，尝试应用详情页
-                    if (!requestSent) {
-                        try {
-                            val settingsIntent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
-                            settingsIntent.data = Uri.parse("package:" + activity.packageName)
-                            activity.startActivity(settingsIntent)
-                            Timber.w("[Mobile] WARN [Restore] 无法直接请求默认短信权限，已打开应用设置页面")
-                            
-                            // 提示用户在设置中手动授予权限
-                            Toast.makeText(
-                                activity, 
-                                "请在应用设置中授予短信相关权限，然后设置为默认短信应用", 
-                                Toast.LENGTH_LONG
-                            ).show()
-                        } catch (e: Exception) {
-                            Timber.e(e, "[Mobile] ERROR [Restore] 无法打开应用设置: ${e.message}")
-                            
-                            // 最后的尝试：打开系统设置主页
-                            try {
-                                val mainSettingsIntent = Intent(Settings.ACTION_SETTINGS)
-                                activity.startActivity(mainSettingsIntent)
-                                Toast.makeText(
-                                    activity,
-                                    "请在系统设置中找到应用管理，将本应用设为默认短信应用",
-                                    Toast.LENGTH_LONG
-                                ).show()
-                            } catch (finalException: Exception) {
-                                Timber.e(finalException, "[Mobile] ERROR [Restore] 无法打开系统设置: ${finalException.message}")
-                                Toast.makeText(
-                                    activity,
-                                    "无法自动打开设置，请手动将本应用设为默认短信应用",
-                                    Toast.LENGTH_LONG
-                                ).show()
-                            }
-                        }
-                    }
-                }
-            } catch (e: Exception) {
-                Timber.e(e, "[Mobile] ERROR [Restore] 请求默认短信应用权限失败: ${e.message}")
-                Toast.makeText(
-                    activity,
-                    "无法请求默认短信应用权限: ${e.message}",
-                    Toast.LENGTH_LONG
-                ).show()
-            }
-        }
-    }
-    
-    /**
-     * 检测是否在模拟器环境中运行
-     */
-    private fun isEmulator(): Boolean {
-        return (Build.BRAND.startsWith("generic") && Build.DEVICE.startsWith("generic"))
-                || Build.FINGERPRINT.startsWith("generic")
-                || Build.FINGERPRINT.startsWith("unknown")
-                || Build.HARDWARE.contains("goldfish")
-                || Build.HARDWARE.contains("ranchu")
-                || Build.MODEL.contains("google_sdk")
-                || Build.MODEL.contains("Emulator")
-                || Build.MODEL.contains("Android SDK built for x86")
-                || Build.MANUFACTURER.contains("Genymotion")
-                || Build.PRODUCT.contains("sdk_google")
-                || Build.PRODUCT.contains("google_sdk")
-                || Build.PRODUCT.contains("sdk")
-                || Build.PRODUCT.contains("sdk_x86")
-                || Build.PRODUCT.contains("vbox86p")
-                || Build.PRODUCT.contains("emulator")
-                || Build.PRODUCT.contains("simulator")
-    }
-    
-    /**
-     * 检查并请求所需权限
-     * 
-     * 此方法检查恢复所需的权限，并根据需要请求缺失的权限。
-     * 适用于Android 6.0+的动态权限请求。
-     * 
-     * @param activity 发起请求的Activity
-     * @param requestCode 权限请求代码
-     * @return 如果所有权限都已授予则返回true，否则返回false
-     */
-    fun checkAndRequestPermissions(activity: Activity, requestCode: Int): Boolean {
-        // 所需权限列表
-        val requiredPermissions = mutableListOf<String>()
-        
-        // 检查SMS权限
-        if (!hasSmsPermissions()) {
-            requiredPermissions.add(android.Manifest.permission.READ_SMS)
-            requiredPermissions.add(android.Manifest.permission.SEND_SMS)
-            requiredPermissions.add(android.Manifest.permission.RECEIVE_SMS)
-        }
-        
-        // 检查通话记录权限
-        if (!hasCallLogPermissions()) {
-            requiredPermissions.add(android.Manifest.permission.READ_CALL_LOG)
-            requiredPermissions.add(android.Manifest.permission.WRITE_CALL_LOG)
-        }
-        
-        // 检查联系人权限
-        if (!hasContactsPermissions()) {
-            requiredPermissions.add(android.Manifest.permission.READ_CONTACTS)
-            requiredPermissions.add(android.Manifest.permission.WRITE_CONTACTS)
-        }
-        
-        // 如果有缺失权限，请求它们
-        if (requiredPermissions.isNotEmpty()) {
-            // 在Android 11+，媒体权限可能需要特殊处理
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-                // 在Android 11+，某些权限可能需要通过Intent请求
-                val specialPermissions = mutableListOf<String>()
-                val normalPermissions = mutableListOf<String>()
-                
-                for (permission in requiredPermissions) {
-                    if (permission == android.Manifest.permission.READ_SMS ||
-                        permission == android.Manifest.permission.READ_CALL_LOG ||
-                        permission == android.Manifest.permission.WRITE_CALL_LOG) {
-                        specialPermissions.add(permission)
-                    } else {
-                        normalPermissions.add(permission)
-                    }
-                }
-                
-                // 先请求普通权限
-                if (normalPermissions.isNotEmpty()) {
-                    activity.requestPermissions(normalPermissions.toTypedArray(), requestCode)
-                }
-                
-                // 对于特殊权限，可能需要引导用户到设置页面
-                if (specialPermissions.isNotEmpty()) {
-                    try {
-                        val intent = Intent(android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
-                        intent.data = Uri.parse("package:" + activity.packageName)
-                        activity.startActivity(intent)
-                        Timber.i("[Mobile] INFO [Restore] 在Android 11+上打开应用设置页面请求特殊权限")
-                    } catch (e: Exception) {
-                        Timber.e(e, "[Mobile] ERROR [Restore] 无法打开应用设置: ${e.message}")
-                    }
-                }
-            } else {
-                // Android 10及以下的正常权限请求
-                activity.requestPermissions(requiredPermissions.toTypedArray(), requestCode)
-                Timber.d("[Mobile] DEBUG [Restore] 请求权限: ${requiredPermissions.joinToString()}")
-            }
-            return false
-        }
-        
-        return true // 所有权限都已授予
-    }
-}
-
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/entity/CallLogsEntity.kt b/android/app/src/main/java/imken/messagevault/mobile/data/entity/CallLogsEntity.kt
deleted file mode 100644
index 0f0b0d7..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/entity/CallLogsEntity.kt
+++ /dev/null
@@ -1,49 +0,0 @@
-package imken.messagevault.mobile.data.entity
-
-import androidx.room.Entity
-import androidx.room.PrimaryKey
-
-/**
- * 通话记录实体类
- * 
- * 用于将通话记录数据存储在本地数据库中
- */
-@Entity(tableName = "call_logs")
-data class CallLogsEntity(
-    /**
-     * 主键ID
-     */
-    @PrimaryKey(autoGenerate = true)
-    val id: Long = 0,
-    
-    /**
-     * 电话号码
-     */
-    val number: String,
-    
-    /**
-     * 联系人名称
-     */
-    val name: String,
-    
-    /**
-     * 通话时间戳
-     */
-    val date: Long,
-    
-    /**
-     * 通话持续时间（秒）
-     */
-    val duration: Int,
-    
-    /**
-     * 通话类型
-     * 1: 来电未接
-     * 2: 去电
-     * 3: 来电已接
-     * 4: 语音信箱
-     * 5: 拒接
-     * 6: 屏蔽的来电
-     */
-    val type: Int
-)
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/model/Entity.kt b/android/app/src/main/java/imken/messagevault/mobile/data/model/Entity.kt
deleted file mode 100644
index 5938156..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/model/Entity.kt
+++ /dev/null
@@ -1,39 +0,0 @@
-package imken.messagevault.mobile.data.model
-
-import androidx.compose.runtime.MutableState
-import androidx.compose.runtime.mutableStateOf
-import java.io.File
-
-/**
- * 备份信息实体类
- */
-data class BackupInfo(
-    val id: Long = 0,
-    val timestamp: Long,          // 备份时间戳，确保此字段存在
-    val fileName: String,
-    val smsCount: Int = 0,        // 短信数量，确保此字段存在
-    val callLogsCount: Int = 0,   // 通话记录数量，确保此字段存在
-    val backupPath: String
-)
-
-/**
- * 备份文件实体类
- */
-/*
-data class BackupFile(
-    val file: File,
-    val name: String = file.name,
-    val timestamp: Long = file.lastModified(),
-    val deviceName: String = "Android设备",
-    val smsCount: Int? = null,
-    val callLogsCount: Int? = null,
-    val fileSize: Long = file.length(),
-    val lastModified: Long = file.lastModified()
-)
-*/
-
-/**
- * 应用备份状态
- */
-data class EmptyEntity(val id: String = "") // 添加至少一个参数
-
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/model/UiState.kt b/android/app/src/main/java/imken/messagevault/mobile/data/model/UiState.kt
deleted file mode 100644
index c77a8ac..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/model/UiState.kt
+++ /dev/null
@@ -1,8 +0,0 @@
-package imken.messagevault.mobile.data.model
-
-import androidx.compose.runtime.MutableState
-
-/**
- * 表示UI状态的接口，用于BackupViewModel等
- */
-interface UiState<T> : MutableState<T>
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupFile.kt b/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupFile.kt
deleted file mode 100644
index b90a733..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupFile.kt
+++ /dev/null
@@ -1,17 +0,0 @@
-package imken.messagevault.mobile.data.models
-
-import java.io.File
-
-/**
- * 表示一个备份文件
- */
-data class BackupFile(
-    val id: String,
-    val deviceId: String,
-    val fileName: String,
-    val timestamp: Long,
-    val appVersion: String,
-    val size: Long,
-    val localFile: File? = null
-    // 其他必要属性
-)
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupFileInfo.kt b/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupFileInfo.kt
deleted file mode 100644
index 2c36407..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupFileInfo.kt
+++ /dev/null
@@ -1,37 +0,0 @@
-package imken.messagevault.mobile.data.models
-
-import imken.messagevault.mobile.data.BackupFile
-import java.io.File
-import java.util.Date
-
-/**
- * 备份文件信息模型
- */
-data class BackupFileInfo(
-    val id: String,
-    val name: String,
-    val path: String,
-    val deviceName: String,
-    val date: Date,
-    val smsCount: Int,
-    val callLogsCount: Int,
-    val fileSize: Long,
-    val file: File? = null
-) {
-    companion object {
-        // 转换方法，用于将 BackupFile 转换为 BackupFileInfo
-        fun fromBackupFile(backupFile: BackupFile): BackupFileInfo {
-            return BackupFileInfo(
-                id = backupFile.id,
-                name = backupFile.fileName,
-                path = backupFile.localFile?.absolutePath ?: "",
-                deviceName = backupFile.deviceId,
-                date = Date(backupFile.timestamp),
-                smsCount = 0, // 这些信息在BackupFile中不存在，设置默认值
-                callLogsCount = 0,
-                fileSize = backupFile.size,
-                file = backupFile.localFile
-            )
-        }
-    }
-}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupModels.kt b/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupModels.kt
deleted file mode 100644
index 54b07ce..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/data/models/BackupModels.kt
+++ /dev/null
@@ -1,61 +0,0 @@
-package imken.messagevault.mobile.data.models
-
-import java.io.File
-
-// 备份数据模型
-data class BackupData(
-    val formatVersion: Int = SUPPORTED_VERSION,
-    val messages: List<MessageData> = emptyList(),
-    val callLogs: List<CallLogData> = emptyList(),
-    val contacts: List<ContactData> = emptyList()
-)
-
-// 消息数据模型
-data class MessageData(
-    val id: Long,
-    val address: String,
-    val body: String,
-    val date: Long,
-    val type: Int,
-    val read: Boolean? = false,
-    val status: Int = 0
-)
-
-// 通话记录数据模型
-data class CallLogData(
-    val id: Long,
-    val number: String,
-    val name: String?,
-    val date: Long,
-    val duration: Int,
-    val type: Int
-)
-
-// 联系人数据模型
-data class ContactData(
-    val id: Long,
-    val name: String,
-    val phoneNumbers: List<String>,
-    val emails: List<String>? = null
-)
-
-// 备份状态枚举
-sealed class BackupState {
-    object Idle : BackupState()
-    object Preparing : BackupState()
-    data class InProgress(val progress: Int) : BackupState()
-    object Completed : BackupState()
-    data class Error(val message: String) : BackupState()
-}
-
-// 恢复状态枚举
-sealed class RestoreState {
-    object Idle : RestoreState()
-    object Preparing : RestoreState()
-    data class InProgress(val progress: Int) : RestoreState()
-    object Completed : RestoreState()
-    data class Error(val message: String) : RestoreState()
-}
-
-// 支持的备份格式版本
-const val SUPPORTED_VERSION = 1
diff --git a/android/app/src/main/java/imken/messagevault/mobile/model/CallLog.kt b/android/app/src/main/java/imken/messagevault/mobile/model/CallLog.kt
deleted file mode 100644
index 54e8f8e..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/model/CallLog.kt
+++ /dev/null
@@ -1,81 +0,0 @@
-package imken.messagevault.mobile.model
-
-import com.google.gson.annotations.Expose
-import com.google.gson.annotations.SerializedName
-import android.content.ContentValues
-import android.provider.CallLog.Calls
-
-/**
- * 通话记录模型
- *
- * 表示一条通话记录，包含ID、电话号码、类型、时间、持续时间和联系人名称等信息
- * 优化的JSON序列化，使用@Expose和简短的@SerializedName值减小文件大小
- */
-data class CallLog(
-    /**
-     * 通话记录ID
-     */
-    @Expose
-    @SerializedName("id")
-    val id: Long,
-    
-    /**
-     * 电话号码
-     */
-    @Expose
-    @SerializedName("num")
-    val number: String,
-    
-    /**
-     * 通话类型
-     * 1: 来电未接
-     * 2: 去电
-     * 3: 来电已接
-     * 4: 语音信箱
-     * 5: 拒接
-     * 6: 屏蔽的来电
-     */
-    @Expose
-    @SerializedName("type")
-    val type: Int,
-    
-    /**
-     * 通话时间戳（Unix毫秒）
-     */
-    @Expose
-    @SerializedName("date")
-    val date: Long,
-    
-    /**
-     * 通话持续时间（秒）
-     */
-    @Expose
-    @SerializedName("dur")
-    val duration: Int,
-    
-    /**
-     * 联系人名称（可选）
-     * 与电话号码关联的联系人姓名
-     */
-    @Expose
-    @SerializedName("name")
-    val contact: String? = null
-) {
-    /**
-     * 转换为ContentValues以便写入系统通话记录数据库
-     */
-    fun toContentValues(): ContentValues {
-        return ContentValues().apply {
-            // 注意：不设置ID，让系统自动生成ID
-            put(Calls.NUMBER, number)
-            put(Calls.TYPE, type)
-            put(Calls.DATE, date)
-            put(Calls.DURATION, duration)
-            contact?.let { put(Calls.CACHED_NAME, it) }
-            // 设置新通话记录为已读
-            put(Calls.NEW, 0)
-            // 标记为非语音邮件
-            put(Calls.IS_READ, 1)
-        }
-    }
-}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/model/Message.kt b/android/app/src/main/java/imken/messagevault/mobile/model/Message.kt
deleted file mode 100644
index 785d61b..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/model/Message.kt
+++ /dev/null
@@ -1,88 +0,0 @@
-package imken.messagevault.mobile.model
-
-import com.google.gson.annotations.Expose
-import com.google.gson.annotations.SerializedName
-import android.content.ContentValues
-import android.provider.Telephony
-
-/**
- * 短信消息模型类
- * 
- * 优化的JSON序列化，使用@Expose和简短的@SerializedName值减小文件大小
- */
-data class Message(
-    /**
-     * 短信ID
-     */
-    @Expose
-    @SerializedName("id")
-    val id: Long = 0,
-    
-    /**
-     * 短信地址（发送人/接收人号码）
-     */
-    @Expose
-    @SerializedName("addr")
-    val address: String,
-    
-    /**
-     * 短信内容
-     */
-    @Expose
-    @SerializedName("body")
-    val body: String? = "",
-    
-    /**
-     * 短信时间戳（毫秒）
-     */
-    @Expose
-    @SerializedName("date")
-    val date: Long,
-    
-    /**
-     * 短信类型
-     * 1: 收件箱, 2: 发送, 3: 草稿, 4: 发件箱, 5: 失败, 6: 排队
-     */
-    @Expose
-    @SerializedName("type")
-    val type: Int,
-    
-    /**
-     * 已读状态 (0: 未读, 1: 已读)
-     * 不需要在JSON中，因此没有@Expose注解
-     */
-    @SerializedName("read")
-    val readState: Int? = 0,
-    
-    /**
-     * 短信状态
-     * 不需要在JSON中，因此没有@Expose注解
-     */
-    @SerializedName("status")
-    val messageStatus: Int? = 0,
-    
-    /**
-     * 对话ID
-     * 不需要在JSON中，因此没有@Expose注解
-     */
-    @SerializedName("thread_id")
-    val threadId: Long = 0
-) {
-    /**
-     * 转换为ContentValues以便写入系统短信数据库
-     */
-    fun toContentValues(): ContentValues {
-        return ContentValues().apply {
-            // 不设置ID，让系统自动生成
-            put(Telephony.Sms.ADDRESS, address)
-            put(Telephony.Sms.BODY, body ?: "")
-            put(Telephony.Sms.DATE, date)
-            put(Telephony.Sms.TYPE, type)
-            readState?.let { put(Telephony.Sms.READ, it) }
-            messageStatus?.let { put(Telephony.Sms.STATUS, it) }
-            if (threadId > 0) {
-                put(Telephony.Sms.THREAD_ID, threadId)
-            }
-        }
-    }
-}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/models/DataModels.kt b/android/app/src/main/java/imken/messagevault/mobile/models/DataModels.kt
deleted file mode 100644
index cc0925f..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/models/DataModels.kt
+++ /dev/null
@@ -1,43 +0,0 @@
-package imken.messagevault.mobile.models
-
-import java.io.File
-import java.util.Date
-
-data class MessageDataOld(
-    val id: Long,
-    val address: String,
-    val body: String,
-    val date: Long,
-    val type: Int // 1: received, 2: sent
-)
-
-data class CallLogDataOld(
-    val id: Long,
-    val number: String,
-    val name: String?,
-    val date: Long,
-    val duration: Int,
-    val type: Int // 1: incoming, 2: outgoing, 3: missed
-)
-
-data class ContactDataOld(
-    val id: Long,
-    val name: String,
-    val phoneNumbers: List<String>
-)
-
-data class BackupFileInfoOld(
-    val file: File,
-    val name: String,
-    val date: Date,
-    val formatVersion: Int = 1
-)
-
-sealed class BackupStateOld {
-    object Idle : BackupStateOld()
-    object Preparing : BackupStateOld()
-    object InProgress : BackupStateOld()
-    data class Progress(val progress: Int, val message: String) : BackupStateOld()
-    object Completed : BackupStateOld()
-    data class Error(val message: String) : BackupStateOld()
-}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/MoreScreen.kt b/android/app/src/main/java/imken/messagevault/mobile/ui/screens/MoreScreen.kt
deleted file mode 100644
index a2b087f..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/screens/MoreScreen.kt
+++ /dev/null
@@ -1,282 +0,0 @@
-package imken.messagevault.mobile.ui.screens
-
-import androidx.compose.foundation.layout.*
-import androidx.compose.material.icons.Icons
-import androidx.compose.material.icons.filled.*
-import androidx.compose.material3.*
-import androidx.compose.runtime.Composable
-import androidx.compose.ui.Alignment
-import androidx.compose.ui.Modifier
-import androidx.compose.ui.res.stringResource
-import androidx.compose.ui.text.style.TextAlign
-import androidx.compose.ui.unit.dp
-import imken.messagevault.mobile.BuildConfig
-import imken.messagevault.mobile.R
-
-/**
- * 更多选项屏幕
- * 
- * 显示应用设置、关于信息等更多选项
- * 
- * @param onNavigateToRestore 导航到恢复屏幕的回调
- */
-@Composable
-fun MoreScreen(
-    onNavigateToRestore: () -> Unit = {}
-) {
-    Column(
-        modifier = Modifier
-            .fillMaxSize()
-            .padding(16.dp),
-        horizontalAlignment = Alignment.CenterHorizontally
-    ) {
-        // 标题
-        Text(
-            text = stringResource(id = R.string.more_tab),
-            style = MaterialTheme.typography.headlineMedium,
-            modifier = Modifier.padding(bottom = 24.dp)
-        )
-        
-        // 功能卡片
-        FeaturesCard(onNavigateToRestore)
-        
-        Spacer(modifier = Modifier.height(16.dp))
-        
-        // 设置卡片
-        SettingsCard()
-        
-        Spacer(modifier = Modifier.height(16.dp))
-        
-        // 关于信息卡片
-        AboutCard()
-    }
-}
-
-/**
- * 功能卡片
- * 
- * 显示应用的主要功能快捷方式
- * 
- * @param onNavigateToRestore 导航到恢复屏幕的回调
- */
-@Composable
-fun FeaturesCard(onNavigateToRestore: () -> Unit) {
-    Card(
-        modifier = Modifier.fillMaxWidth()
-    ) {
-        Column(
-            modifier = Modifier.padding(16.dp)
-        ) {
-            Text(
-                text = "快速操作",
-                style = MaterialTheme.typography.titleMedium,
-                modifier = Modifier.padding(bottom = 8.dp)
-            )
-            
-            // 恢复数据按钮
-            FilledTonalButton(
-                onClick = onNavigateToRestore,
-                modifier = Modifier.fillMaxWidth()
-            ) {
-                Icon(
-                    imageVector = Icons.Default.Restore,
-                    contentDescription = null,
-                    modifier = Modifier.padding(end = 8.dp)
-                )
-                Text(text = stringResource(id = R.string.restore_button))
-            }
-            
-            Spacer(modifier = Modifier.height(8.dp))
-            
-            // 导出数据按钮
-            OutlinedButton(
-                onClick = { /* TODO 导出功能 */ },
-                modifier = Modifier.fillMaxWidth()
-            ) {
-                Icon(
-                    imageVector = Icons.Default.FileDownload,
-                    contentDescription = null,
-                    modifier = Modifier.padding(end = 8.dp)
-                )
-                Text(text = "导出数据")
-            }
-        }
-    }
-}
-
-/**
- * 设置选项卡片
- */
-@Composable
-fun SettingsCard() {
-    Card(
-        modifier = Modifier
-            .fillMaxWidth()
-            .padding(bottom = 16.dp),
-        colors = CardDefaults.cardColors(
-            containerColor = MaterialTheme.colorScheme.surfaceVariant
-        )
-    ) {
-        Column(
-            modifier = Modifier.padding(16.dp)
-        ) {
-            Text(
-                text = "应用设置",
-                style = MaterialTheme.typography.titleLarge
-            )
-            
-            Spacer(modifier = Modifier.height(16.dp))
-            
-            // 语言设置
-            SettingItem(
-                icon = { Icon(Icons.Default.Language, contentDescription = null) },
-                title = "语言设置",
-                subtitle = "选择应用显示语言",
-                onClick = { /* TODO */ }
-            )
-            
-            Divider(modifier = Modifier.padding(vertical = 8.dp))
-            
-            // 存储设置
-            SettingItem(
-                icon = { Icon(Icons.Default.Storage, contentDescription = null) },
-                title = "存储设置",
-                subtitle = "管理备份文件和存储位置",
-                onClick = { /* TODO */ }
-            )
-            
-            Divider(modifier = Modifier.padding(vertical = 8.dp))
-            
-            // 网络设置
-            SettingItem(
-                icon = { Icon(Icons.Default.Cloud, contentDescription = null) },
-                title = "网络设置",
-                subtitle = "配置服务器地址和连接选项",
-                onClick = { /* TODO */ }
-            )
-        }
-    }
-}
-
-/**
- * 关于卡片
- */
-@Composable
-fun AboutCard() {
-    Card(
-        modifier = Modifier
-            .fillMaxWidth()
-            .padding(bottom = 16.dp),
-        colors = CardDefaults.cardColors(
-            containerColor = MaterialTheme.colorScheme.surfaceVariant
-        )
-    ) {
-        Column(
-            modifier = Modifier.padding(16.dp)
-        ) {
-            Text(
-                text = "关于",
-                style = MaterialTheme.typography.titleLarge
-            )
-            
-            Spacer(modifier = Modifier.height(16.dp))
-            
-            AboutItem(
-                title = "应用名称",
-                value = stringResource(id = R.string.app_name)
-            )
-            
-            AboutItem(
-                title = "版本",
-                value = BuildConfig.VERSION_NAME
-            )
-            
-            AboutItem(
-                title = "开发者",
-                value = "MessageVault Team"
-            )
-            
-            Spacer(modifier = Modifier.height(16.dp))
-            
-            Text(
-                text = "信驿云储是一款开源的短信和通话记录备份工具，支持本地备份和云端同步。保护您的重要通信数据，随时随地访问。",
-                style = MaterialTheme.typography.bodyMedium
-            )
-        }
-    }
-}
-
-/**
- * 设置项
- */
-@Composable
-fun SettingItem(
-    icon: @Composable () -> Unit,
-    title: String,
-    subtitle: String,
-    onClick: () -> Unit
-) {
-    Row(
-        modifier = Modifier
-            .fillMaxWidth()
-            .padding(vertical = 8.dp),
-        verticalAlignment = Alignment.CenterVertically
-    ) {
-        Box(
-            modifier = Modifier
-                .size(40.dp)
-                .padding(end = 16.dp),
-            contentAlignment = Alignment.Center
-        ) {
-            icon()
-        }
-        
-        Column(
-            modifier = Modifier.weight(1f)
-        ) {
-            Text(
-                text = title,
-                style = MaterialTheme.typography.titleMedium
-            )
-            
-            Text(
-                text = subtitle,
-                style = MaterialTheme.typography.bodyMedium
-            )
-        }
-        
-        IconButton(onClick = onClick) {
-            Icon(
-                imageVector = Icons.Default.ChevronRight,
-                contentDescription = "打开"
-            )
-        }
-    }
-}
-
-/**
- * 关于项
- */
-@Composable
-fun AboutItem(
-    title: String,
-    value: String
-) {
-    Row(
-        modifier = Modifier
-            .fillMaxWidth()
-            .padding(vertical = 4.dp),
-        verticalAlignment = Alignment.CenterVertically
-    ) {
-        Text(
-            text = title,
-            style = MaterialTheme.typography.titleSmall,
-            modifier = Modifier.width(100.dp)
-        )
-        
-        Text(
-            text = value,
-            style = MaterialTheme.typography.bodyMedium
-        )
-    }
-} 
\ No newline at end of file
diff --git a/android/app/src/main/java/imken/messagevault/mobile/ui/viewmodels/BackupViewModel.kt b/android/app/src/main/java/imken/messagevault/mobile/ui/viewmodels/BackupViewModel.kt
deleted file mode 100644
index de09410..0000000
--- a/android/app/src/main/java/imken/messagevault/mobile/ui/viewmodels/BackupViewModel.kt
+++ /dev/null
@@ -1,94 +0,0 @@
-package imken.messagevault.mobile.ui.viewmodels
-
-import android.content.Context
-import androidx.compose.runtime.State
-import androidx.compose.runtime.mutableStateOf
-import androidx.lifecycle.ViewModel
-import androidx.lifecycle.ViewModelProvider
-import androidx.lifecycle.viewModelScope
-import imken.messagevault.mobile.data.BackupManager
-import kotlinx.coroutines.CoroutineDispatcher
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.flow.MutableStateFlow
-import kotlinx.coroutines.flow.StateFlow
-import kotlinx.coroutines.flow.asStateFlow
-import kotlinx.coroutines.launch
-import timber.log.Timber
-
-/**
- * 备份视图模型
- *
- * 负责处理备份相关的UI状态和业务逻辑
- */
-class BackupViewModel(
-    private val backupManager: BackupManager,
-    private val dispatcher: CoroutineDispatcher = Dispatchers.IO
-) : ViewModel() {
-
-    // TAG 仅用于日志
-    private val TAG = "BackupViewModel"
-    
-    // 权限状态
-    private val _permissionsGranted = mutableStateOf(false)
-    
-    // 备份操作状态
-    private val _isOperating = mutableStateOf(false)
-    
-    // 备份消息状态
-    private val _backupStatus = mutableStateOf<String?>(null)
-    
-    // 提供对状态的访问方法
-    fun getPermissionsGranted(): Boolean = _permissionsGranted.value
-    fun isOperating(): Boolean = _isOperating.value
-    fun getBackupStatus(): String? = _backupStatus.value
-    
-    /**
-     * 设置权限授权状态
-     */
-    fun setPermissionsGranted(granted: Boolean) {
-        _permissionsGranted.value = granted
-    }
-    
-    /**
-     * 开始备份流程
-     */
-    fun startBackup() {
-        if (!_permissionsGranted.value) {
-            _backupStatus.value = "权限不足，无法执行备份"
-            return
-        }
-        
-        if (_isOperating.value) {
-            Timber.d("[Mobile] DEBUG [Backup] 备份操作已在进行中")
-            return
-        }
-        
-        _isOperating.value = true
-        _backupStatus.value = "正在准备备份..."
-        
-        viewModelScope.launch(dispatcher) {
-            try {
-                val result = backupManager.performBackup()
-                _backupStatus.value = "备份完成: ${result.messagesCount} 条短信, ${result.callLogsCount} 条通话记录, ${result.contactsCount} 个联系人"
-            } catch (e: Exception) {
-                Timber.e(e, "[Mobile] ERROR [Backup] 备份失败")
-                _backupStatus.value = "备份失败: ${e.message}"
-            } finally {
-                _isOperating.value = false
-            }
-        }
-    }
-    
-    /**
-     * 工厂类，用于创建 BackupViewModel 实例
-     */
-    class Factory(private val context: Context) : ViewModelProvider.Factory {
-        @Suppress("UNCHECKED_CAST")
-        override fun <T : ViewModel> create(modelClass: Class<T>): T {
-            if (modelClass.isAssignableFrom(BackupViewModel::class.java)) {
-                return BackupViewModel(BackupManager(context)) as T
-            }
-            throw IllegalArgumentException("Unknown ViewModel class")
-        }
-    }
-}
diff --git a/android/app/src/main/res/values-en/strings.xml b/android/app/src/main/res/values-en/strings.xml
index fcd7c9a..fd93074 100644
--- a/android/app/src/main/res/values-en/strings.xml
+++ b/android/app/src/main/res/values-en/strings.xml
@@ -1,25 +1,106 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <string name="app_name">MessageVault</string>
-    <string name="app_title">MessageVault</string>
-    <string name="welcome_message">Welcome to MessageVault</string>
+    <string name="app_name">Commory</string>
+    <string name="app_title">Commory</string>
+    <string name="welcome_message">Welcome to Commory</string>
     <string name="backup_button">Backup Data</string>
     <string name="restore_button">Restore Data</string>
     <string name="permission_required">Permissions Required</string>
-    <string name="permission_prompt">MessageVault needs access to SMS and call log permissions to work properly. Please grant these permissions in settings.</string>
+    <string name="permission_prompt">Commory needs access to SMS and call log permissions to work properly. Please grant these permissions in settings.</string>
+    <string name="ok">OK</string>
     <string name="settings">Settings</string>
     <string name="app_description">Backup and restore your SMS and call logs</string>
+    <string name="mode_title">Choose a run mode</string>
+    <string name="mode_subtitle">Commory can run fully on-device or connect to a self-hosted Commory server for sync and search.</string>
+    <string name="mode_local_title">Local Only</string>
+    <string name="mode_local_body">Backup files stay on this device. No account is required, and the app works offline.</string>
+    <string name="mode_server_title">Commory Server</string>
+    <string name="mode_server_body">Connect to a self-hosted Commory server for accounts, remote import history, uploads, and cross-device access.</string>
+    <string name="mode_use_local">Use local mode</string>
+    <string name="mode_connect_server">Connect server</string>
+    <string name="mode_switch_confirm_title">Switch run mode?</string>
+    <string name="mode_switch_to_local_body">Switching to local mode signs out of the server account but keeps local backup files.</string>
+    <string name="mode_switch_to_server_body">Server mode requires a server URL and account. Local backup still saves to this device first.</string>
+    <string name="mode_switch_confirm">Switch</string>
+    <string name="server_setup_title">Connect Commory Server</string>
+    <string name="server_setup_body">Enter your server URL and sign in. The app still creates a local backup first, then uploads when sync is enabled.</string>
+    <string name="server_url">Server URL</string>
+    <string name="check_server">Check server</string>
+    <string name="server_check_success">Server connection is healthy</string>
+    <string name="server_check_failed">Server check failed: %1$s</string>
+    <string name="sign_in">Sign in</string>
+    <string name="create_account">Create account</string>
+    <string name="username">Username</string>
+    <string name="email">Email</string>
+    <string name="password">Password</string>
+    <string name="login">Log in</string>
+    <string name="register">Register</string>
+    <string name="have_account">I have an account</string>
+    <string name="need_account">Need an account</string>
+    <string name="auth_success">Connected to Commory Server</string>
+    <string name="auth_failed">Authentication failed: %1$s</string>
+    <string name="logged_out">Signed out</string>
+    <string name="signed_in_as">Signed in as %1$s</string>
+    <string name="logout">Log out</string>
+    <string name="general_settings">General</string>
+    <string name="language_settings">Language</string>
+    <string name="language_system">System</string>
+    <string name="language_zh">中文</string>
+    <string name="language_en">English</string>
+    <string name="server_settings">Server Settings</string>
+    <string name="sync_on_backup">Upload after backup</string>
+    <string name="sync_enabled">Sync enabled</string>
+    <string name="sync_disabled">Sync disabled</string>
+    <string name="quick_actions">Quick Actions</string>
+    <string name="privacy_permissions">Privacy &amp; Permissions</string>
+    <string name="backup_permissions_summary">Backup only needs read access to SMS, call logs, and contacts. SMS restore asks to become the default SMS app only when needed.</string>
+    <string name="storage_settings">Storage</string>
+    <string name="storage_summary">Local backups are stored in the app-specific external files backups folder.</string>
+    <string name="about">About</string>
+    <string name="version_format">Version: %1$s</string>
+    <string name="app_about_body">An open-source tool for communication backup, restore, and self-hosted retrieval.</string>
+    <string name="backup_data_title">Data Backup</string>
+    <string name="backup_about_title">About Backup</string>
+    <string name="permission_sms_backup_title">Read SMS</string>
+    <string name="permission_sms_backup_body">Exports SMS body, time, direction, and thread metadata.</string>
+    <string name="permission_call_backup_title">Read call logs</string>
+    <string name="permission_call_backup_body">Exports call numbers, types, timestamps, and duration.</string>
+    <string name="permission_contacts_backup_title">Read contacts</string>
+    <string name="permission_contacts_backup_body">Adds contact context to messages and call logs.</string>
+    <string name="backup_error_permissions">Missing permissions. Backup cannot run.</string>
+    <string name="backup_status_preparing">Preparing backup…</string>
+    <string name="backup_status_uploading">Local backup created. Uploading to server…</string>
+    <string name="backup_success_local">Backup complete: %1$d SMS, %2$d call logs. Local file saved.</string>
+    <string name="backup_success_remote">Backup complete: %1$d SMS, %2$d call logs. Local file saved and uploaded.</string>
+    <string name="backup_failed_with_reason">Backup failed: %1$s</string>
+    <string name="permissions_granted_toast">Permissions granted. You can continue.</string>
+    <string name="permissions_settings_toast">Grant permissions manually in settings.</string>
+    <string name="permission_rationale">These permissions are needed to back up and restore your SMS, call logs, and contacts.</string>
     
     <!-- Status messages -->
     <string name="status_initial">Ready to backup</string>
+    <string name="backup_successful">Backup successful</string>
+    <string name="backup_data_info">Backup data includes SMS, call logs, and contacts when permissions are granted.</string>
+    <string name="backup_date_format">yyyy-MM-dd HH:mm</string>
+    <string name="sms_count">SMS: %1$d</string>
+    <string name="call_log_count">Call logs: %1$d</string>
     <string name="backup_success">Backup successful</string>
     <string name="backup_failed">Backup failed</string>
     <string name="restore_success">Restore successful</string>
     <string name="restore_failed">Restore failed</string>
+    <string name="restore">Restore</string>
+    <string name="restore_backup">Restore backup</string>
+    <string name="restore_successful">Restore successful</string>
+    <string name="restore_confirmation_title">Restore backup?</string>
+    <string name="restore_confirmation_message">This will restore data from the selected backup file.</string>
+    <string name="error_loading_backups">Failed to load backup files</string>
+    <string name="error_restoring_backup">Failed to restore backup</string>
+    <string name="no_backups_found">No backup files found</string>
+    <string name="cancel">Cancel</string>
     
     <!-- Bottom navigation -->
     <string name="backup_tab">Backup</string>
     <string name="restore_tab">Restore</string>
     <string name="preview_tab">Preview</string>
     <string name="more_tab">More</string>
-</resources> 
\ No newline at end of file
+</resources> 
diff --git a/android/app/src/main/res/values-night/themes.xml b/android/app/src/main/res/values-night/themes.xml
index 02ebc72..9abc7a6 100644
--- a/android/app/src/main/res/values-night/themes.xml
+++ b/android/app/src/main/res/values-night/themes.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <!-- 使用Material 3夜间主题 -->
-    <style name="Theme.MessageVault" parent="Theme.Material3.DayNight.NoActionBar">
+    <style name="Theme.Commory" parent="Theme.Material3.DayNight.NoActionBar">
         <!-- Material 3属性 -->
         <item name="colorPrimary">@color/purple_200</item>
         <item name="colorPrimaryDark">@color/purple_700</item>
diff --git a/android/app/src/main/res/values-zh-rCN/strings.xml b/android/app/src/main/res/values-zh-rCN/strings.xml
index 1b01478..dbf1c18 100644
--- a/android/app/src/main/res/values-zh-rCN/strings.xml
+++ b/android/app/src/main/res/values-zh-rCN/strings.xml
@@ -7,19 +7,100 @@
     <string name="restore_button">恢复数据</string>
     <string name="permission_required">需要权限</string>
     <string name="permission_prompt">信驿云储需要访问短信和通话记录权限才能正常工作。请在设置中授予这些权限。</string>
+    <string name="ok">确定</string>
     <string name="settings">设置</string>
     <string name="app_description">备份和恢复您的短信与通话记录</string>
+    <string name="mode_title">选择运行模式</string>
+    <string name="mode_subtitle">信驿云储可以完全本地运行，也可以连接 Commory 服务端同步和检索备份。</string>
+    <string name="mode_local_title">仅本地</string>
+    <string name="mode_local_body">备份文件只保存在本机。无需账号，离线可用，适合隐私优先场景。</string>
+    <string name="mode_server_title">Commory 服务端</string>
+    <string name="mode_server_body">连接自托管 Commory 服务端，支持账号、远程导入列表、上传和跨设备访问。</string>
+    <string name="mode_use_local">使用本地模式</string>
+    <string name="mode_connect_server">连接服务端</string>
+    <string name="mode_switch_confirm_title">切换运行模式？</string>
+    <string name="mode_switch_to_local_body">切换到本地模式会退出当前服务端账号，但不会删除本地备份文件。</string>
+    <string name="mode_switch_to_server_body">切换到服务端模式后，需要填写服务端地址并登录账号；本地备份仍会先保存到设备。</string>
+    <string name="mode_switch_confirm">确认切换</string>
+    <string name="server_setup_title">连接 Commory 服务端</string>
+    <string name="server_setup_body">输入服务端地址并登录账号。应用仍会先创建本地备份，再按设置上传到服务端。</string>
+    <string name="server_url">服务端地址</string>
+    <string name="check_server">检查连接</string>
+    <string name="server_check_success">服务端连接正常</string>
+    <string name="server_check_failed">服务端连接失败：%1$s</string>
+    <string name="sign_in">登录</string>
+    <string name="create_account">创建账号</string>
+    <string name="username">用户名</string>
+    <string name="email">邮箱</string>
+    <string name="password">密码</string>
+    <string name="login">登录</string>
+    <string name="register">注册</string>
+    <string name="have_account">已有账号</string>
+    <string name="need_account">需要账号</string>
+    <string name="auth_success">已连接到 Commory 服务端</string>
+    <string name="auth_failed">认证失败：%1$s</string>
+    <string name="logged_out">已退出登录</string>
+    <string name="signed_in_as">已登录：%1$s</string>
+    <string name="logout">退出登录</string>
+    <string name="general_settings">通用设置</string>
+    <string name="language_settings">语言</string>
+    <string name="language_system">跟随系统</string>
+    <string name="language_zh">中文</string>
+    <string name="language_en">English</string>
+    <string name="server_settings">服务端设置</string>
+    <string name="sync_on_backup">备份后自动上传</string>
+    <string name="sync_enabled">同步开启</string>
+    <string name="sync_disabled">同步关闭</string>
+    <string name="quick_actions">快速操作</string>
+    <string name="privacy_permissions">隐私与权限</string>
+    <string name="backup_permissions_summary">备份只需要读取短信、通话记录和联系人。恢复短信时才需要临时成为默认短信应用。</string>
+    <string name="storage_settings">存储设置</string>
+    <string name="storage_summary">本地备份保存在应用专属外部文件目录的 backups 文件夹中。</string>
+    <string name="about">关于</string>
+    <string name="version_format">版本：%1$s</string>
+    <string name="app_about_body">开源的通信数据备份、恢复和自托管检索工具。</string>
+    <string name="backup_data_title">数据备份</string>
+    <string name="backup_about_title">关于备份</string>
+    <string name="permission_sms_backup_title">读取短信</string>
+    <string name="permission_sms_backup_body">用于导出短信正文、时间、方向和线程信息。</string>
+    <string name="permission_call_backup_title">读取通话记录</string>
+    <string name="permission_call_backup_body">用于导出通话号码、类型、时间和持续时长。</string>
+    <string name="permission_contacts_backup_title">读取联系人</string>
+    <string name="permission_contacts_backup_body">用于给消息和通话记录补充联系人上下文。</string>
+    <string name="backup_error_permissions">权限不足，无法执行备份。</string>
+    <string name="backup_status_preparing">正在准备备份…</string>
+    <string name="backup_status_uploading">本地备份已创建，正在上传到服务端…</string>
+    <string name="backup_success_local">备份完成：%1$d 条短信，%2$d 条通话记录。本地文件已保存。</string>
+    <string name="backup_success_remote">备份完成：%1$d 条短信，%2$d 条通话记录。本地文件已保存并上传。</string>
+    <string name="backup_failed_with_reason">备份失败：%1$s</string>
+    <string name="permissions_granted_toast">权限已授予，可以继续操作。</string>
+    <string name="permissions_settings_toast">请在设置中手动授予权限。</string>
+    <string name="permission_rationale">需要这些权限才能备份和恢复您的短信、通话记录和联系人。</string>
     
     <!-- 状态消息 -->
     <string name="status_initial">准备备份</string>
+    <string name="backup_successful">备份成功</string>
+    <string name="backup_data_info">在授予权限后，备份会包含短信、通话记录和联系人。</string>
+    <string name="backup_date_format">yyyy-MM-dd HH:mm</string>
+    <string name="sms_count">短信：%1$d</string>
+    <string name="call_log_count">通话记录：%1$d</string>
     <string name="backup_success">备份成功</string>
     <string name="backup_failed">备份失败</string>
     <string name="restore_success">恢复成功</string>
     <string name="restore_failed">恢复失败</string>
+    <string name="restore">恢复</string>
+    <string name="restore_backup">恢复备份</string>
+    <string name="restore_successful">恢复成功</string>
+    <string name="restore_confirmation_title">恢复备份？</string>
+    <string name="restore_confirmation_message">这会从选中的备份文件恢复数据。</string>
+    <string name="error_loading_backups">加载备份文件失败</string>
+    <string name="error_restoring_backup">恢复备份失败</string>
+    <string name="no_backups_found">未找到备份文件</string>
+    <string name="cancel">取消</string>
     
     <!-- 底部导航 -->
     <string name="backup_tab">备份</string>
     <string name="restore_tab">恢复</string>
     <string name="preview_tab">预览</string>
     <string name="more_tab">更多</string>
-</resources> 
\ No newline at end of file
+</resources> 
diff --git a/android/app/src/main/res/values/strings.xml b/android/app/src/main/res/values/strings.xml
index fa565a6..de5bc20 100644
--- a/android/app/src/main/res/values/strings.xml
+++ b/android/app/src/main/res/values/strings.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="app_name">信驿云储</string>
-    <string name="app_title">MessageVault</string>
+    <string name="app_title">Commory</string>
     <string name="welcome_message">欢迎使用信驿云储</string>
     <string name="app_description">安全备份和恢复您的短信与通话记录</string>
     <string name="backup_button">立即备份</string>
@@ -9,6 +9,72 @@
     <string name="permission_required">需要权限</string>
     <string name="permission_prompt">信驿云储需要访问短信和通话记录权限才能正常工作。请在设置中授予这些权限。</string>
     <string name="settings">设置</string>
+    <string name="mode_title">选择运行模式</string>
+    <string name="mode_subtitle">信驿云储可以完全本地运行，也可以连接 Commory 服务端同步和检索备份。</string>
+    <string name="mode_local_title">仅本地</string>
+    <string name="mode_local_body">备份文件只保存在本机。无需账号，离线可用，适合隐私优先场景。</string>
+    <string name="mode_server_title">Commory 服务端</string>
+    <string name="mode_server_body">连接自托管 Commory 服务端，支持账号、远程导入列表、上传和跨设备访问。</string>
+    <string name="mode_use_local">使用本地模式</string>
+    <string name="mode_connect_server">连接服务端</string>
+    <string name="mode_switch_confirm_title">切换运行模式？</string>
+    <string name="mode_switch_to_local_body">切换到本地模式会退出当前服务端账号，但不会删除本地备份文件。</string>
+    <string name="mode_switch_to_server_body">切换到服务端模式后，需要填写服务端地址并登录账号；本地备份仍会先保存到设备。</string>
+    <string name="mode_switch_confirm">确认切换</string>
+    <string name="server_setup_title">连接 Commory 服务端</string>
+    <string name="server_setup_body">输入服务端地址并登录账号。应用仍会先创建本地备份，再按设置上传到服务端。</string>
+    <string name="server_url">服务端地址</string>
+    <string name="check_server">检查连接</string>
+    <string name="server_check_success">服务端连接正常</string>
+    <string name="server_check_failed">服务端连接失败：%1$s</string>
+    <string name="sign_in">登录</string>
+    <string name="create_account">创建账号</string>
+    <string name="username">用户名</string>
+    <string name="email">邮箱</string>
+    <string name="password">密码</string>
+    <string name="login">登录</string>
+    <string name="register">注册</string>
+    <string name="have_account">已有账号</string>
+    <string name="need_account">需要账号</string>
+    <string name="auth_success">已连接到 Commory 服务端</string>
+    <string name="auth_failed">认证失败：%1$s</string>
+    <string name="logged_out">已退出登录</string>
+    <string name="signed_in_as">已登录：%1$s</string>
+    <string name="logout">退出登录</string>
+    <string name="general_settings">通用设置</string>
+    <string name="language_settings">语言</string>
+    <string name="language_system">跟随系统</string>
+    <string name="language_zh">中文</string>
+    <string name="language_en">English</string>
+    <string name="server_settings">服务端设置</string>
+    <string name="sync_on_backup">备份后自动上传</string>
+    <string name="sync_enabled">同步开启</string>
+    <string name="sync_disabled">同步关闭</string>
+    <string name="quick_actions">快速操作</string>
+    <string name="privacy_permissions">隐私与权限</string>
+    <string name="backup_permissions_summary">备份只需要读取短信、通话记录和联系人。恢复短信时才需要临时成为默认短信应用。</string>
+    <string name="storage_settings">存储设置</string>
+    <string name="storage_summary">本地备份保存在应用专属外部文件目录的 backups 文件夹中。</string>
+    <string name="about">关于</string>
+    <string name="version_format">版本：%1$s</string>
+    <string name="app_about_body">开源的通信数据备份、恢复和自托管检索工具。</string>
+    <string name="backup_data_title">数据备份</string>
+    <string name="backup_about_title">关于备份</string>
+    <string name="permission_sms_backup_title">读取短信</string>
+    <string name="permission_sms_backup_body">用于导出短信正文、时间、方向和线程信息。</string>
+    <string name="permission_call_backup_title">读取通话记录</string>
+    <string name="permission_call_backup_body">用于导出通话号码、类型、时间和持续时长。</string>
+    <string name="permission_contacts_backup_title">读取联系人</string>
+    <string name="permission_contacts_backup_body">用于给消息和通话记录补充联系人上下文。</string>
+    <string name="backup_error_permissions">权限不足，无法执行备份。</string>
+    <string name="backup_status_preparing">正在准备备份…</string>
+    <string name="backup_status_uploading">本地备份已创建，正在上传到服务端…</string>
+    <string name="backup_success_local">备份完成：%1$d 条短信，%2$d 条通话记录。本地文件已保存。</string>
+    <string name="backup_success_remote">备份完成：%1$d 条短信，%2$d 条通话记录。本地文件已保存并上传。</string>
+    <string name="backup_failed_with_reason">备份失败：%1$s</string>
+    <string name="permissions_granted_toast">权限已授予，可以继续操作。</string>
+    <string name="permissions_settings_toast">请在设置中手动授予权限。</string>
+    <string name="permission_rationale">需要这些权限才能备份和恢复您的短信、通话记录和联系人。</string>
     
     <!-- 状态消息 -->
     <string name="status_initial">等待开始备份...</string>
diff --git a/android/app/src/main/res/values/themes.xml b/android/app/src/main/res/values/themes.xml
index 6f11342..c2cb9e8 100644
--- a/android/app/src/main/res/values/themes.xml
+++ b/android/app/src/main/res/values/themes.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <!-- 使用Material 3主题 -->
-    <style name="Theme.MessageVault" parent="Theme.Material3.DayNight.NoActionBar">
+    <style name="Theme.Commory" parent="Theme.Material3.DayNight.NoActionBar">
         <!-- Material 3属性 -->
         <item name="colorPrimary">@color/purple_500</item>
         <item name="colorPrimaryDark">@color/purple_700</item>
@@ -14,7 +14,7 @@
     </style>
     
     <!-- 夜间模式主题 -->
-    <style name="Theme.MessageVault.Dark" parent="Theme.Material3.Dark.NoActionBar">
+    <style name="Theme.Commory.Dark" parent="Theme.Material3.Dark.NoActionBar">
         <!-- Material 3属性 -->
         <item name="colorPrimary">@color/purple_200</item>
         <item name="colorPrimaryVariant">@color/purple_700</item>
diff --git a/android/app/src/test/java/com/iskenkenya/commory/mobile/agent/AgentPrivacyPolicyTest.kt b/android/app/src/test/java/com/iskenkenya/commory/mobile/agent/AgentPrivacyPolicyTest.kt
new file mode 100644
index 0000000..70728df
--- /dev/null
+++ b/android/app/src/test/java/com/iskenkenya/commory/mobile/agent/AgentPrivacyPolicyTest.kt
@@ -0,0 +1,21 @@
+package com.iskenkenya.commory.mobile.agent
+
+import com.iskenkenya.commory.mobile.runtime.RuntimeMode
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertTrue
+
+class AgentPrivacyPolicyTest {
+    @Test
+    fun localModeKeepsAgentContextLocal() {
+        assertEquals(AgentProviderPolicy.LOCAL_ONLY, AgentPrivacyPolicy.policyFor(RuntimeMode.LOCAL_ONLY))
+        assertEquals(AgentProviderPolicy.SERVER_ALLOWED, AgentPrivacyPolicy.policyFor(RuntimeMode.COMMORY_SERVER))
+    }
+
+    @Test
+    fun previewsAreTrimmedBeforeProviderUse() {
+        val preview = AgentPrivacyPolicy.trimPreview("abcdef", maxChars = 3)
+        assertEquals("abc", preview)
+        assertTrue(preview.length <= 3)
+    }
+}
diff --git a/android/app/src/test/java/com/iskenkenya/commory/mobile/data/BackupManagerTest.kt b/android/app/src/test/java/com/iskenkenya/commory/mobile/data/BackupManagerTest.kt
new file mode 100644
index 0000000..2f4ac3f
--- /dev/null
+++ b/android/app/src/test/java/com/iskenkenya/commory/mobile/data/BackupManagerTest.kt
@@ -0,0 +1,157 @@
+package com.iskenkenya.commory.mobile.data
+
+import android.content.ContentResolver
+import android.content.Context
+import android.database.MatrixCursor
+import android.provider.CallLog.Calls
+import android.provider.Telephony
+import com.iskenkenya.commory.mobile.data.backup.AndroidBackupFileWriter
+import com.iskenkenya.commory.mobile.data.backup.AndroidCallLogReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidContactReader
+import com.iskenkenya.commory.mobile.data.backup.AndroidSmsReader
+import com.iskenkenya.commory.sdk.backup.BackupManager
+import com.iskenkenya.commory.sdk.backup.model.BackupData
+import com.iskenkenya.commory.sdk.backup.model.CallLog
+import com.iskenkenya.commory.sdk.backup.model.Message
+import kotlinx.coroutines.runBlocking
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.mockito.ArgumentMatchers.anyString
+import org.mockito.ArgumentMatchers.any
+import org.mockito.ArgumentMatchers.eq
+import org.mockito.Mock
+import org.mockito.Mockito.`when`
+import org.mockito.MockitoAnnotations
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+import timber.log.Timber
+import java.io.StringWriter
+import java.text.SimpleDateFormat
+import java.util.*
+import kotlin.test.assertEquals
+import kotlin.test.assertNotNull
+
+@RunWith(RobolectricTestRunner::class)
+@Config(manifest = Config.NONE)
+class BackupManagerTest {
+
+    @Mock
+    private lateinit var mockContext: Context
+    
+    @Mock
+    private lateinit var mockResolver: ContentResolver
+
+    private lateinit var smsReader: AndroidSmsReader
+    private lateinit var callLogReader: AndroidCallLogReader
+    private lateinit var backupManager: BackupManager
+    
+    private val logWriter = StringWriter()
+
+    @Before
+    fun setUp() {
+        MockitoAnnotations.openMocks(this)
+        setupTestLogger()
+        
+        smsReader = AndroidSmsReader(mockContext, mockResolver) { true }
+        callLogReader = AndroidCallLogReader(mockContext, mockResolver) { true }
+        
+        Timber.i("[Mobile] INFO [Test] 开始测试BackupManager; Context: Unit test initialization")
+    }
+    
+    private fun setupTestLogger() {
+        Timber.plant(object : Timber.Tree() {
+            override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
+                val timestamp = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.US)
+                    .apply { timeZone = TimeZone.getTimeZone("UTC") }
+                    .format(Date())
+                val logMessage = "$timestamp $message"
+                logWriter.append(logMessage).append("\n")
+                println(logMessage)
+            }
+        })
+    }
+    
+    @Test
+    fun testSmsReaderReadSms() {
+        val mockSmsCursor = createMockSmsCursor()
+        `when`(mockResolver.query(
+            eq(Telephony.Sms.CONTENT_URI),
+            any<Array<String>>(),
+            any(),
+            any(),
+            anyString()
+        )).thenReturn(mockSmsCursor)
+        
+        val result = runBlocking { smsReader.readSms() }
+        
+        assertNotNull(result, "短信列表不应为null")
+        assertEquals(2, result!!.size, "应该读取到2条短信记录")
+        
+        val firstSms = result[0]
+        assertEquals("+1234567890", firstSms.address, "第一条短信地址应正确")
+        
+        Timber.i("[Mobile] INFO [Test] readSms测试通过; Context: 成功验证短信读取功能")
+    }
+    
+    @Test
+    fun testCallLogReaderReadCallLogs() {
+        val mockCallLogCursor = createMockCallLogCursor()
+        `when`(mockResolver.query(
+            eq(Calls.CONTENT_URI),
+            any<Array<String>>(),
+            anyString(),
+            any<Array<String>>(),
+            anyString()
+        )).thenReturn(mockCallLogCursor)
+        
+        val result = runBlocking { callLogReader.readCallLogs() }
+        
+        assertNotNull(result, "通话记录列表不应为null")
+        assertEquals(2, result!!.size, "应该读取到2条通话记录")
+        
+        val firstCall = result[0]
+        assertEquals("+1234567890", firstCall.number, "第一条通话记录号码应正确")
+        
+        Timber.i("[Mobile] INFO [Test] readCallLogs测试通过; Context: 成功验证通话记录读取功能")
+    }
+    
+    private fun createMockSmsCursor(): android.database.Cursor {
+        val cursor = MatrixCursor(
+            arrayOf(
+                Telephony.Sms._ID,
+                Telephony.Sms.ADDRESS,
+                Telephony.Sms.BODY,
+                Telephony.Sms.DATE,
+                Telephony.Sms.TYPE,
+                Telephony.Sms.READ,
+                Telephony.Sms.STATUS
+            )
+        )
+        cursor.addRow(arrayOf(1L, "+1234567890", "测试短信内容1", 1714500000000L, 1, 1, 0))
+        cursor.addRow(arrayOf(2L, "+0987654321", "测试短信内容2", 1714400000000L, 2, 0, 0))
+        return cursor
+    }
+    
+    private fun createMockCallLogCursor(): android.database.Cursor {
+        val cursor = MatrixCursor(
+            arrayOf(
+                Calls._ID,
+                Calls.NUMBER,
+                Calls.CACHED_NAME,
+                Calls.DATE,
+                Calls.DURATION,
+                Calls.TYPE
+            )
+        )
+        cursor.addRow(arrayOf(1L, "+1234567890", "Test Contact", 1714500000000L, 120, 1))
+        cursor.addRow(arrayOf(2L, "+0987654321", null, 1714400000000L, 60, 2))
+        return cursor
+    }
+    
+    @org.junit.After
+    fun tearDown() {
+        Timber.i("[Mobile] INFO [Test] 完成BackupManager测试; Context: Unit test completion")
+        Timber.uprootAll()
+    }
+} 
diff --git a/android/app/src/test/java/com/iskenkenya/commory/mobile/remote/CommoryRefreshCookieJarTest.kt b/android/app/src/test/java/com/iskenkenya/commory/mobile/remote/CommoryRefreshCookieJarTest.kt
new file mode 100644
index 0000000..81e481b
--- /dev/null
+++ b/android/app/src/test/java/com/iskenkenya/commory/mobile/remote/CommoryRefreshCookieJarTest.kt
@@ -0,0 +1,62 @@
+package com.iskenkenya.commory.mobile.remote
+
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertNull
+import okhttp3.Cookie
+import okhttp3.HttpUrl.Companion.toHttpUrl
+
+class CommoryRefreshCookieJarTest {
+    @Test
+    fun savesLoadsReplacesAndClearsPerOrigin() {
+        val store = InMemoryRefreshCookieStore()
+        val jar = CommoryRefreshCookieJar(store)
+        val origin = "https://commory.example.com/api".toHttpUrl()
+
+        jar.saveFromResponse(origin, listOf(cookie(origin.host, "rt1", System.currentTimeMillis() + 60_000L)))
+        assertEquals("rt1", jar.loadForRequest(origin).single().value)
+
+        jar.saveFromResponse(origin, listOf(cookie(origin.host, "rt2", System.currentTimeMillis() + 60_000L)))
+        assertEquals("rt2", jar.loadForRequest(origin).single().value)
+
+        jar.clear("https://commory.example.com/")
+        assertEquals(emptyList(), jar.loadForRequest(origin))
+        assertNull(store.get(CommoryRefreshCookieJar.originKey(origin)))
+    }
+
+    @Test
+    fun expiredCookieIsDiscarded() {
+        val jar = CommoryRefreshCookieJar(InMemoryRefreshCookieStore())
+        val origin = "https://commory.example.com/api".toHttpUrl()
+
+        jar.saveFromResponse(origin, listOf(cookie(origin.host, "expired", System.currentTimeMillis() - 1L)))
+
+        assertEquals(emptyList(), jar.loadForRequest(origin))
+    }
+
+    private fun cookie(host: String, value: String, expiresAt: Long): Cookie {
+        return Cookie.Builder()
+            .name("commory_refresh_token")
+            .value(value)
+            .hostOnlyDomain(host)
+            .path("/")
+            .expiresAt(expiresAt)
+            .httpOnly()
+            .secure()
+            .build()
+    }
+
+    private class InMemoryRefreshCookieStore : RefreshCookieStore {
+        private val values = mutableMapOf<String, StoredRefreshCookie>()
+
+        override fun get(origin: String): StoredRefreshCookie? = values[origin]
+
+        override fun put(origin: String, cookie: StoredRefreshCookie) {
+            values[origin] = cookie
+        }
+
+        override fun remove(origin: String) {
+            values.remove(origin)
+        }
+    }
+}
diff --git a/android/app/src/test/java/com/iskenkenya/commory/mobile/remote/CommoryServerClientAuthTest.kt b/android/app/src/test/java/com/iskenkenya/commory/mobile/remote/CommoryServerClientAuthTest.kt
new file mode 100644
index 0000000..1abba75
--- /dev/null
+++ b/android/app/src/test/java/com/iskenkenya/commory/mobile/remote/CommoryServerClientAuthTest.kt
@@ -0,0 +1,122 @@
+package com.iskenkenya.commory.mobile.remote
+
+import android.content.Context
+import androidx.test.core.app.ApplicationProvider
+import com.iskenkenya.commory.mobile.runtime.AppEnvironmentManager
+import com.iskenkenya.commory.mobile.runtime.AuthSession
+import kotlinx.coroutines.runBlocking
+import okhttp3.mockwebserver.MockResponse
+import okhttp3.mockwebserver.MockWebServer
+import okio.Buffer
+import org.junit.After
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+import kotlin.test.assertEquals
+import kotlin.test.assertTrue
+
+@RunWith(RobolectricTestRunner::class)
+@Config(manifest = Config.NONE)
+class CommoryServerClientAuthTest {
+    private lateinit var context: Context
+    private lateinit var environmentManager: AppEnvironmentManager
+    private lateinit var server: MockWebServer
+    private lateinit var client: CommoryServerClient
+
+    @Before
+    fun setUp() = runBlocking {
+        context = ApplicationProvider.getApplicationContext()
+        context.getSharedPreferences("commory_refresh_cookies", Context.MODE_PRIVATE).edit().clear().commit()
+        environmentManager = AppEnvironmentManager(context)
+        environmentManager.clearSession()
+        server = MockWebServer()
+        server.start()
+        environmentManager.updateServerUrl(server.url("/").toString())
+        client = CommoryServerClient(context, environmentManager)
+    }
+
+    @After
+    fun tearDown() {
+        server.shutdown()
+        context.getSharedPreferences("commory_refresh_cookies", Context.MODE_PRIVATE).edit().clear().commit()
+    }
+
+    @Test
+    fun refreshPersistedSessionRetriesOnceOnConflict() = runBlocking {
+        val loginToken = fakeToken("user-1", "session-1", 3600L)
+        server.enqueue(
+            envelopeResponse(
+                status = 200,
+                body = """{"code":200,"msg":"ok","data":{"user":{"id":"user-1","userName":"alice","email":"alice@example.com","roles":["R_USER"]},"token":"$loginToken"}}""",
+                setCookie = "commory_refresh_token=rt1; Path=/; HttpOnly; SameSite=Strict"
+            )
+        )
+
+        val loginSession = client.login(server.url("/").toString(), "alice", "secret").getOrThrow()
+        environmentManager.updateSession(loginSession)
+
+        val refreshedToken = fakeToken("user-1", "session-1", 7200L)
+        server.enqueue(envelopeResponse(409, """{"code":409,"msg":"ERR_REFRESH_TOKEN_RETRY","data":null}"""))
+        server.enqueue(
+            envelopeResponse(
+                status = 200,
+                body = """{"code":200,"msg":"ok","data":{"token":"$refreshedToken"}}""",
+                setCookie = "commory_refresh_token=rt2; Path=/; HttpOnly; SameSite=Strict"
+            )
+        )
+        server.enqueue(
+            envelopeResponse(
+                status = 200,
+                body = """{"code":200,"msg":"ok","data":{"id":"user-1","userName":"alice","email":"alice@example.com","roles":["R_USER"]}}"""
+            )
+        )
+
+        val refreshed = client.refreshPersistedSession().getOrThrow()
+
+        assertEquals("user-1", refreshed.userId)
+        assertEquals(refreshedToken, refreshed.accessToken)
+        assertTrue(environmentManager.currentSnapshot().authSession.accessToken == refreshedToken)
+
+        val loginRequest = server.takeRequest()
+        assertEquals("/api/auth/login", loginRequest.path)
+
+        val firstRefresh = server.takeRequest()
+        assertEquals("/api/auth/refresh", firstRefresh.path)
+        assertTrue(firstRefresh.getHeader("Cookie").orEmpty().contains("commory_refresh_token=rt1"))
+
+        val secondRefresh = server.takeRequest()
+        assertEquals("/api/auth/refresh", secondRefresh.path)
+        assertTrue(secondRefresh.getHeader("Cookie").orEmpty().contains("commory_refresh_token=rt1"))
+
+        val userInfo = server.takeRequest()
+        assertEquals("/api/user/info", userInfo.path)
+        assertEquals("Bearer $refreshedToken", userInfo.getHeader("Authorization"))
+    }
+
+    private fun envelopeResponse(status: Int, body: String, setCookie: String? = null): MockResponse {
+        return MockResponse()
+            .setResponseCode(status)
+            .setHeader("Content-Type", "application/json")
+            .apply {
+                if (setCookie != null) {
+                    setHeader("Set-Cookie", setCookie)
+                }
+            }
+            .setBody(Buffer().writeUtf8(body))
+    }
+
+    private fun fakeToken(userId: String, sessionId: String, expiresInSeconds: Long): String {
+        val header = """{"alg":"HS256","typ":"JWT"}""".base64Url()
+        val payload = """{"sub":"$userId","sid":"$sessionId","exp":${(System.currentTimeMillis() / 1000L) + expiresInSeconds}}""".base64Url()
+        return "$header.$payload.sig"
+    }
+
+    private fun String.base64Url(): String {
+        return android.util.Base64.encodeToString(
+            toByteArray(),
+            android.util.Base64.URL_SAFE or android.util.Base64.NO_PADDING or android.util.Base64.NO_WRAP
+        )
+    }
+}
diff --git a/android/app/src/test/java/com/iskenkenya/commory/mobile/runtime/RuntimeModePolicyTest.kt b/android/app/src/test/java/com/iskenkenya/commory/mobile/runtime/RuntimeModePolicyTest.kt
new file mode 100644
index 0000000..b6bc6ec
--- /dev/null
+++ b/android/app/src/test/java/com/iskenkenya/commory/mobile/runtime/RuntimeModePolicyTest.kt
@@ -0,0 +1,48 @@
+package com.iskenkenya.commory.mobile.runtime
+
+import kotlin.test.Test
+import kotlin.test.assertFalse
+import kotlin.test.assertTrue
+
+class RuntimeModePolicyTest {
+    @Test
+    fun serverModeRequiresAuthUntilSessionExists() {
+        val anonymous = AppEnvironment(
+            mode = RuntimeMode.COMMORY_SERVER,
+            modeSelected = true
+        )
+        assertTrue(RuntimeModePolicy.requiresServerAuth(anonymous))
+
+        val authenticated = anonymous.copy(
+            authSession = AuthSession(accessToken = "access", userId = "user")
+        )
+        assertFalse(RuntimeModePolicy.requiresServerAuth(authenticated))
+    }
+
+    @Test
+    fun expiredAccessTokenDoesNotAuthenticateSession() {
+        val expired = AuthSession(
+            accessToken = "access",
+            accessTokenExpiresAtEpochSeconds = (System.currentTimeMillis() / 1000L) - 60L
+        )
+
+        assertFalse(expired.isAuthenticated)
+    }
+
+    @Test
+    fun uploadRequiresServerModeSyncAndAuth() {
+        val local = AppEnvironment(
+            mode = RuntimeMode.LOCAL_ONLY,
+            modeSelected = true,
+            syncOnBackup = true,
+            authSession = AuthSession(accessToken = "access")
+        )
+        assertFalse(RuntimeModePolicy.canUploadBackup(local))
+
+        val serverNoSync = local.copy(mode = RuntimeMode.COMMORY_SERVER, syncOnBackup = false)
+        assertFalse(RuntimeModePolicy.canUploadBackup(serverNoSync))
+
+        val serverSync = serverNoSync.copy(syncOnBackup = true)
+        assertTrue(RuntimeModePolicy.canUploadBackup(serverSync))
+    }
+}
diff --git a/android/app/src/test/java/imken/messagevault/mobile/data/BackupManagerTest.kt b/android/app/src/test/java/imken/messagevault/mobile/data/BackupManagerTest.kt
deleted file mode 100644
index e2e9d96..0000000
--- a/android/app/src/test/java/imken/messagevault/mobile/data/BackupManagerTest.kt
+++ /dev/null
@@ -1,317 +0,0 @@
-package imken.messagevault.mobile.data
-
-import android.content.ContentResolver
-import android.content.Context
-import android.database.Cursor
-import android.database.MatrixCursor
-import android.net.Uri
-import android.provider.CallLog.Calls
-import android.provider.Telephony
-import imken.messagevault.mobile.BuildConfig
-import imken.messagevault.mobile.config.Config
-import imken.messagevault.mobile.model.BackupData
-import imken.messagevault.mobile.model.CallLog
-import imken.messagevault.mobile.model.Message
-import org.junit.Before
-import org.junit.Test
-import org.junit.runner.RunWith
-import org.mockito.ArgumentMatchers.any
-import org.mockito.ArgumentMatchers.anyInt
-import org.mockito.ArgumentMatchers.anyString
-import org.mockito.ArgumentMatchers.eq
-import org.mockito.ArgumentMatchers.isNull
-import org.mockito.Mock
-import org.mockito.Mockito.`when`
-import org.mockito.Mockito.verify
-import org.mockito.MockitoAnnotations
-import org.robolectric.RobolectricTestRunner
-import org.robolectric.annotation.Config
-import timber.log.Timber
-import java.io.File
-import java.io.StringWriter
-import java.text.SimpleDateFormat
-import java.util.*
-import kotlin.test.assertEquals
-import kotlin.test.assertNotNull
-import kotlin.test.assertTrue
-
-/**
- * BackupManager单元测试
- * 
- * 测试BackupManager的核心功能：
- * - 短信和通话记录读取
- * - 本地JSON备份功能
- * 
- * 使用Mockito模拟ContentResolver和Cursor，以测试数据读取逻辑。
- * 
- * 作者: Cursor AI
- * 创建日期: 2025-04-17
- */
-@RunWith(RobolectricTestRunner::class)
-@Config(manifest = Config.NONE)
-class BackupManagerTest {
-
-    @Mock
-    private lateinit var mockContext: Context
-    
-    @Mock
-    private lateinit var mockResolver: ContentResolver
-    
-    @Mock
-    private lateinit var mockConfig: imken.messagevault.mobile.config.Config
-    
-    @Mock
-    private lateinit var mockFile: File
-    
-    @Mock
-    private lateinit var mockExternalFilesDir: File
-    
-    @Mock
-    private lateinit var mockBackupDir: File
-
-    private lateinit var backupManager: BackupManager
-    
-    // 测试日志记录器
-    private val logWriter = StringWriter()
-
-    @Before
-    fun setUp() {
-        // 初始化Mockito注解
-        MockitoAnnotations.openMocks(this)
-        
-        // 设置测试日志记录器
-        setupTestLogger()
-        
-        // 模拟Context的ContentResolver
-        `when`(mockContext.contentResolver).thenReturn(mockResolver)
-        
-        // 模拟外部文件目录
-        `when`(mockContext.getExternalFilesDir(isNull())).thenReturn(mockExternalFilesDir)
-        `when`(mockExternalFilesDir.absolutePath).thenReturn("/mock/external/files")
-        
-        // 模拟备份目录
-        `when`(mockBackupDir.exists()).thenReturn(true)
-        `when`(mockBackupDir.absolutePath).thenReturn("/mock/external/files/backup")
-        
-        // 初始化被测对象
-        backupManager = BackupManager(mockContext)
-        
-        // 注入模拟的Config实例
-        val configField = BackupManager::class.java.getDeclaredField("config")
-        configField.isAccessible = true
-        configField.set(backupManager, mockConfig)
-        
-        // 记录测试开始
-        Timber.i("[Mobile] INFO [Test] 开始测试BackupManager; Context: Unit test initialization")
-    }
-    
-    /**
-     * 设置测试专用的日志记录器
-     */
-    private fun setupTestLogger() {
-        Timber.plant(object : Timber.Tree() {
-            override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
-                val timestamp = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.US)
-                    .apply { timeZone = TimeZone.getTimeZone("UTC") }
-                    .format(Date())
-                
-                val logMessage = "$timestamp $message"
-                logWriter.append(logMessage).append("\n")
-                println(logMessage) // 同时输出到控制台
-            }
-        })
-    }
-    
-    /**
-     * 测试SMS消息读取功能
-     */
-    @Test
-    fun testReadSMS() {
-        Timber.i("[Mobile] INFO [Test] 测试readSMS方法; Context: 准备模拟数据")
-        
-        // 创建模拟SMS数据
-        val mockSmsCursor = createMockSmsCursor()
-        
-        // 模拟ContentResolver查询结果
-        `when`(mockResolver.query(
-            eq(Telephony.Sms.CONTENT_URI),
-            isNull(),
-            isNull(),
-            isNull(),
-            anyString()
-        )).thenReturn(mockSmsCursor)
-        
-        // 执行被测方法
-        val result = backupManager.readSMS()
-        
-        // 验证结果
-        assertEquals(2, result.size, "应该读取到2条短信记录")
-        
-        // 验证第一条短信
-        val firstSms = result[0]
-        assertEquals(1L, firstSms.id, "第一条短信ID应为1")
-        assertEquals("+1234567890", firstSms.address, "第一条短信地址应正确")
-        assertEquals("测试短信内容1", firstSms.body, "第一条短信内容应正确")
-        assertEquals(1714500000000L, firstSms.date, "第一条短信日期应正确")
-        assertEquals(1, firstSms.type, "第一条短信类型应为1(接收)")
-        
-        // 验证日志输出
-        assertTrue(logWriter.toString().contains("[Mobile] INFO [SMS] 读取完成"))
-        
-        Timber.i("[Mobile] INFO [Test] readSMS测试通过; Context: 成功验证短信读取功能")
-    }
-    
-    /**
-     * 测试通话记录读取功能
-     */
-    @Test
-    fun testReadCallLogs() {
-        Timber.i("[Mobile] INFO [Test] 测试readCallLogs方法; Context: 准备模拟数据")
-        
-        // 创建模拟通话记录数据
-        val mockCallLogCursor = createMockCallLogCursor()
-        
-        // 模拟ContentResolver查询结果
-        `when`(mockResolver.query(
-            eq(Calls.CONTENT_URI),
-            isNull(),
-            isNull(),
-            isNull(),
-            anyString()
-        )).thenReturn(mockCallLogCursor)
-        
-        // 执行被测方法
-        val result = backupManager.readCallLogs()
-        
-        // 验证结果
-        assertEquals(2, result.size, "应该读取到2条通话记录")
-        
-        // 验证第一条通话记录
-        val firstCall = result[0]
-        assertEquals(1L, firstCall.id, "第一条通话记录ID应为1")
-        assertEquals("+1234567890", firstCall.number, "第一条通话记录号码应正确")
-        assertEquals(1, firstCall.type, "第一条通话记录类型应为1(来电)")
-        assertEquals(1714500000000L, firstCall.date, "第一条通话记录日期应正确")
-        assertEquals(120, firstCall.duration, "第一条通话记录时长应为120秒")
-        
-        // 验证日志输出
-        assertTrue(logWriter.toString().contains("[Mobile] INFO [CallLog] 读取完成"))
-        
-        Timber.i("[Mobile] INFO [Test] readCallLogs测试通过; Context: 成功验证通话记录读取功能")
-    }
-    
-    /**
-     * 测试备份到JSON文件功能
-     */
-    @Test
-    fun testBackupToJson() {
-        Timber.i("[Mobile] INFO [Test] 测试backupToJson方法; Context: 准备模拟数据和文件系统")
-        
-        // 创建测试备份数据
-        val testBackupData = BackupData(
-            deviceId = "test-device-id",
-            timestamp = 1714500000000L,
-            messages = listOf(
-                Message(
-                    id = 1L,
-                    address = "+1234567890",
-                    body = "测试短信内容",
-                    date = 1714500000000L,
-                    type = 1
-                )
-            ),
-            callLogs = listOf(
-                CallLog(
-                    id = 1L,
-                    number = "+1234567890",
-                    type = 1,
-                    date = 1714500000000L,
-                    duration = 120
-                )
-            ),
-            appVersion = "1.0-test"
-        )
-        
-        // 模拟文件系统
-        val mockBackupFile = File("/mock/external/files/backup/messagevault-2025-04-17-00-00-00.json")
-        `when`(mockExternalFilesDir.absolutePath).thenReturn("/mock/external/files")
-        `when`(mockBackupDir.exists()).thenReturn(false)
-        `when`(mockBackupDir.mkdirs()).thenReturn(true)
-        
-        // 修改BackupManager中的dateFormat字段，使其返回固定时间戳
-        val dateFormatField = BackupManager::class.java.getDeclaredField("dateFormat")
-        dateFormatField.isAccessible = true
-        val mockDateFormat = SimpleDateFormat("yyyy-MM-dd-HH-mm-ss", Locale.US)
-        mockDateFormat.isLenient = true
-        // 使mockDateFormat总是返回固定的格式化时间
-        `when`(mockDateFormat.format(any())).thenReturn("2025-04-17-00-00-00")
-        dateFormatField.set(backupManager, mockDateFormat)
-        
-        // 执行被测方法时的模拟行为
-        val backupManagerSpy = org.mockito.Mockito.spy(backupManager)
-        org.mockito.Mockito.doReturn(mockBackupFile.absolutePath).`when`(backupManagerSpy).backupToJson(any())
-        
-        // 执行被测方法
-        val result = backupManagerSpy.backupToJson(testBackupData)
-        
-        // 验证结果
-        assertNotNull(result, "备份文件路径不应为null")
-        assertEquals(mockBackupFile.absolutePath, result, "备份文件路径应与预期一致")
-        
-        // 验证日志输出
-        assertTrue(logWriter.toString().contains("[Mobile] INFO [Test] 测试backupToJson方法"))
-        
-        Timber.i("[Mobile] INFO [Test] backupToJson测试通过; Context: 成功验证JSON备份功能")
-    }
-    
-    /**
-     * 创建模拟的SMS游标数据
-     */
-    private fun createMockSmsCursor(): Cursor {
-        val cursor = MatrixCursor(
-            arrayOf(
-                Telephony.Sms._ID,
-                Telephony.Sms.ADDRESS,
-                Telephony.Sms.BODY,
-                Telephony.Sms.DATE,
-                Telephony.Sms.TYPE
-            )
-        )
-        
-        // 添加两条模拟短信记录
-        cursor.addRow(arrayOf(1L, "+1234567890", "测试短信内容1", 1714500000000L, 1))
-        cursor.addRow(arrayOf(2L, "+0987654321", "测试短信内容2", 1714400000000L, 2))
-        
-        return cursor
-    }
-    
-    /**
-     * 创建模拟的通话记录游标数据
-     */
-    private fun createMockCallLogCursor(): Cursor {
-        val cursor = MatrixCursor(
-            arrayOf(
-                Calls._ID,
-                Calls.NUMBER,
-                Calls.TYPE,
-                Calls.DATE,
-                Calls.DURATION
-            )
-        )
-        
-        // 添加两条模拟通话记录
-        cursor.addRow(arrayOf(1L, "+1234567890", 1, 1714500000000L, 120))
-        cursor.addRow(arrayOf(2L, "+0987654321", 2, 1714400000000L, 60))
-        
-        return cursor
-    }
-    
-    /**
-     * 测试资源清理
-     */
-    @org.junit.After
-    fun tearDown() {
-        Timber.i("[Mobile] INFO [Test] 完成BackupManager测试; Context: Unit test completion")
-        Timber.uprootAll() // 移除所有日志记录器
-    }
-} 
\ No newline at end of file
diff --git a/android/build.gradle b/android/build.gradle
index 3e94253..856b697 100644
--- a/android/build.gradle
+++ b/android/build.gradle
@@ -1,24 +1,17 @@
-// 项目级build.gradle
-
-buildscript {
-    ext {
-        compose_compiler_version = '1.5.6'
-        kotlin_version = '1.9.21'
-        room_version = '2.6.1'
-    }
-
-    repositories {
-        google()
-        mavenCentral()
-    }
-    
-    dependencies {
-        classpath 'com.android.tools.build:gradle:8.1.4'
-        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
-    }
+plugins {
+    id 'com.android.application' version '9.0.0' apply false
+    id 'com.android.library' version '9.0.0' apply false
+    id 'org.jetbrains.kotlin.android' version '2.2.0' apply false
+    id 'org.jetbrains.kotlin.jvm' version '2.2.0' apply false
+    id 'org.jetbrains.kotlin.plugin.compose' version '2.2.0' apply false
 }
 
-// 删除 allprojects 块，依赖仓库已经在 settings.gradle 中配置
+ext {
+    room_version = '2.7.1'
+    coroutines_version = '1.10.2'
+    gson_version = '2.13.1'
+    retrofit_version = '2.11.0'
+}
 
 tasks.register('clean', Delete) {
     delete rootProject.buildDir
diff --git a/android/docs/architecture/ai-agent-integration.md b/android/docs/architecture/ai-agent-integration.md
new file mode 100644
index 0000000..1206d73
--- /dev/null
+++ b/android/docs/architecture/ai-agent-integration.md
@@ -0,0 +1,403 @@
+# AI Agent 集成设计文档
+
+## 1. 概述
+
+### 1.1 AI Agent 在消息备份场景中的价值
+
+Commory 积累了用户的短信、通话记录和联系人数据，AI Agent 将改变用户与备份数据的交互方式：
+
+| 价值维度 | 描述 | 示例 |
+|---------|------|------|
+| 智能检索 | 自然语言查询替代关键词搜索 | "上个月和小王讨论项目进度的消息" |
+| 洞察分析 | 自动发现沟通模式和趋势 | "最近三个月联系最频繁的5个人" |
+| 内容摘要 | 对大量消息生成精炼摘要 | "上周和客户的沟通要点总结" |
+| 主动提醒 | 基于消息内容的智能提醒 | "你答应张三周五前发送文档" |
+
+### 1.2 设计目标
+
+- **隐私优先**：敏感数据默认在本地处理，用户完全掌控数据流向
+- **灵活部署**：支持本地模型和云端模型的无缝切换
+- **渐进增强**：基础功能不依赖 AI，AI 是增强而非必需
+- **可扩展**：支持接入不同 AI 模型和知识库方案
+
+---
+
+## 2. 知识库架构
+
+### 2.1 整体架构
+
+```mermaid
+graph TB
+    subgraph source[数据源]
+        sms[短信 MessageData]
+        call[通话记录 CallLogData]
+        contact[联系人 ContactData]
+    end
+
+    subgraph pipeline[数据处理管线]
+        extractor[数据提取器]
+        chunker[文本分块器]
+        embedder[向量化器]
+        indexer[索引构建器]
+    end
+
+    subgraph store[存储层]
+        vector_db[向量数据库 Chroma]
+        metadata_db[元数据库 Room]
+        fulltext[全文索引 FTS5]
+    end
+
+    subgraph retrieval[检索层]
+        semantic[语义检索]
+        keyword[关键词检索]
+        hybrid[混合检索 RRF]
+    end
+
+    source --> extractor --> chunker --> embedder --> indexer
+    indexer --> vector_db & metadata_db & fulltext
+    vector_db --> semantic --> hybrid
+    fulltext --> keyword --> hybrid
+```
+
+### 2.2 数据分块策略
+
+```kotlin
+data class KnowledgeChunk(
+    val id: String,
+    val sourceType: SourceType,
+    val sourceId: String,
+    val content: String,
+    val metadata: Map<String, String>,
+    val embedding: FloatArray? = null
+)
+
+enum class SourceType { MESSAGE, CALL_LOG, CONTACT, MESSAGE_THREAD }
+```
+
+| 数据类型 | 分块策略 | 说明 |
+|---------|---------|------|
+| 单条短信 | 保留完整 | 短信通常较短，不需分块 |
+| 长短信 | 按段落分块 | 超过 512 字符按段落分割 |
+| 消息线程 | 按时间窗口分块 | 同一联系人消息按 24h 窗口聚合 |
+| 通话记录 | 聚合分块 | 同一联系人通话按周聚合 |
+
+---
+
+## 3. AI 分析组件接口设计
+
+### 3.1 AnalysisProvider 接口
+
+```kotlin
+interface AnalysisProvider {
+    val providerId: String
+    val displayName: String
+    val capabilities: Set<AnalysisCapability>
+    val isAvailable: Boolean
+
+    suspend fun analyze(request: AnalysisRequest): AnalysisResult
+    suspend fun streamAnalyze(request: AnalysisRequest): Flow<AnalysisChunk>
+    fun getSupportedModels(): List<ModelInfo>
+}
+
+enum class AnalysisCapability {
+    TEXT_SUMMARY, SEMANTIC_SEARCH, PATTERN_ANALYSIS,
+    SENTIMENT_ANALYSIS, ENTITY_EXTRACTION,
+    CONVERSATION_INSIGHT, TREND_ANALYSIS
+}
+
+data class AnalysisRequest(val type: AnalysisType, val query: String, val context: AnalysisContext)
+enum class AnalysisType { SUMMARY, SEARCH, PATTERN, INSIGHT, CUSTOM }
+data class AnalysisContext(val userId: String, val timeRange: TimeRange? = null, val contactFilter: List<String>? = null)
+
+data class AnalysisResult(val content: String, val sources: List<SourceReference>, val metadata: AnalysisMetadata, val usage: TokenUsage?)
+data class SourceReference(val sourceType: SourceType, val sourceId: String, val relevance: Float, val snippet: String)
+data class ModelInfo(val id: String, val name: String, val capabilities: Set<AnalysisCapability>, val maxContextLength: Int, val isLocal: Boolean)
+```
+
+### 3.2 接口关系图
+
+```mermaid
+classDiagram
+    class AnalysisProvider {
+        <<interface>>
+        +providerId: String
+        +capabilities: Set~AnalysisCapability~
+        +analyze(request): AnalysisResult
+        +streamAnalyze(request): Flow~AnalysisChunk~
+    }
+    class LocalAnalysisProvider {
+        +providerId = "local-onnx"
+    }
+    class CloudAnalysisProvider {
+        +providerId = "cloud-openai"
+    }
+    class KnowledgeBase {
+        +search(query): List~KnowledgeChunk~
+        +add(chunks): Result~Unit~
+        +rebuild(): Result~Unit~
+    }
+
+    AnalysisProvider <|.. LocalAnalysisProvider
+    AnalysisProvider <|.. CloudAnalysisProvider
+    LocalAnalysisProvider --> KnowledgeBase
+    CloudAnalysisProvider --> KnowledgeBase
+```
+
+---
+
+## 4. 本地 AI 模型方案
+
+### 4.1 技术选型
+
+| 方案 | 推理引擎 | 优势 | 劣势 |
+|------|---------|------|------|
+| ONNX Runtime（推荐） | onnxruntime-android | 生态成熟，模型丰富 | 包体积较大 |
+| TensorFlow Lite | tflite | Google 官方支持 | 模型转换复杂 |
+| MLC LLM | mlc-llm | 支持手机端 LLM | 硬件要求高 |
+
+### 4.2 本地模型架构
+
+```mermaid
+graph TB
+    subgraph provider[LocalAnalysisProvider]
+        router[模型路由器]
+        summary_model[摘要模型 DistilBART]
+        embed_model[嵌入模型 MiniLM]
+    end
+    subgraph runtime[ONNX Runtime]
+        cpu[CPU 线程池]
+        nnapi[NNAPI Delegate]
+    end
+    subgraph knowledge[知识库]
+        vector[向量索引 HNSW]
+        fts[全文索引 FTS5]
+    end
+    router --> summary_model & embed_model
+    summary_model & embed_model --> runtime
+    provider --> knowledge
+```
+
+### 4.3 LocalAnalysisProvider 核心逻辑
+
+```kotlin
+class LocalAnalysisProvider(
+    private val knowledgeBase: KnowledgeBase,
+    private val modelManager: LocalModelManager
+) : AnalysisProvider {
+
+    override val providerId = "local-onnx"
+    override val capabilities = setOf(
+        AnalysisCapability.TEXT_SUMMARY,
+        AnalysisCapability.SEMANTIC_SEARCH,
+        AnalysisCapability.PATTERN_ANALYSIS
+    )
+
+    override suspend fun analyze(request: AnalysisRequest): AnalysisResult {
+        val startTime = System.currentTimeMillis()
+        val chunks = knowledgeBase.search(
+            query = request.query, topK = 10,
+            timeRange = request.context.timeRange
+        )
+        val contextText = chunks.joinToString("\n") { "[${it.sourceType}] ${it.content}" }
+        val prompt = buildPrompt(request.type, request.query, contextText)
+        val result = modelManager.infer(prompt, request.options)
+        return AnalysisResult(
+            content = result,
+            sources = chunks.map { SourceReference(it.sourceType, it.sourceId, it.relevance ?: 0f, it.content.take(200)) },
+            metadata = AnalysisMetadata(modelManager.currentModel, providerId, System.currentTimeMillis() - startTime),
+            usage = null
+        )
+    }
+}
+```
+
+### 4.4 推荐模型
+
+| 用途 | 模型 | 大小 | 说明 |
+|------|------|------|------|
+| 文本嵌入 | all-MiniLM-L6-v2 | 80MB | 384 维，适合移动端 |
+| 文本摘要 | DistilBART-CNN-12-6 | 300MB | 轻量摘要模型 |
+| 情感分析 | DistilBERT-SST-2 | 65MB | 二分类情感模型 |
+
+---
+
+## 5. 云端 AI 模型方案
+
+### 5.1 云端模型架构
+
+```mermaid
+graph LR
+    subgraph app[移动端]
+        vm[AI ViewModel]
+        cache[本地缓存]
+    end
+    subgraph gateway[API 网关]
+        auth[认证鉴权]
+        route[请求路由]
+    end
+    subgraph cloud[云端 AI]
+        openai[OpenAI GPT-4o-mini]
+        custom[自部署 Qwen/LLaMA]
+    end
+
+    vm --> gateway
+    cache --> vm
+    gateway --> auth --> route
+    route --> openai & custom
+```
+
+### 5.2 CloudAnalysisProvider 设计
+
+```kotlin
+class CloudAnalysisProvider(
+    private val knowledgeBase: KnowledgeBase,
+    private val config: CloudAnalysisConfig
+) : AnalysisProvider {
+
+    override val providerId = "cloud-${config.providerType}"
+    override val capabilities = AnalysisCapability.values().toSet()
+
+    data class CloudAnalysisConfig(
+        val providerType: String,
+        val apiEndpoint: String,
+        val apiKey: String,
+        val model: String = "gpt-4o-mini",
+        val timeoutMs: Long = 30_000
+    )
+
+    override suspend fun analyze(request: AnalysisRequest): AnalysisResult {
+        val chunks = knowledgeBase.search(query = request.query, topK = 20)
+        val contextText = chunks.joinToString("\n") { "[${it.sourceType}] ${it.content}" }
+        val messages = listOf(
+            ChatMessage("system", buildSystemPrompt(request.type)),
+            ChatMessage("user", "$contextText\n\n${request.query}")
+        )
+        val response = callCloudAPI(messages, request.options)
+        return AnalysisResult(
+            content = response.content,
+            sources = chunks.map { SourceReference(it.sourceType, it.sourceId, it.relevance ?: 0f, it.content.take(200)) },
+            metadata = AnalysisMetadata(config.model, providerId, 0),
+            usage = response.usage
+        )
+    }
+}
+```
+
+### 5.3 本地/云端切换策略
+
+```mermaid
+flowchart TD
+    A[用户发起 AI 请求] --> B{用户偏好}
+    B -->|仅本地| C[LocalAnalysisProvider]
+    B -->|仅云端| D[CloudAnalysisProvider]
+    B -->|自动| E{本地模型可用?}
+    E -->|否| D
+    E -->|是| F{任务复杂度}
+    F -->|简单| C
+    F -->|复杂| G{网络可用?}
+    G -->|是| D
+    G -->|否| C
+```
+
+---
+
+## 6. 隐私保护
+
+### 6.1 隐私保护原则
+
+| 原则 | 说明 | 实施方式 |
+|------|------|---------|
+| 本地优先 | 敏感数据默认本地处理 | 本地模型为默认选择 |
+| 数据脱敏 | 云端传输前脱敏 | 自动替换姓名、号码等 PII |
+| 用户可控 | 用户决定数据 AI 可用范围 | 细粒度数据授权设置 |
+| 最小必要 | 仅发送分析所需最少数据 | 上下文限制 + 相关性过滤 |
+
+### 6.2 数据脱敏方案
+
+```kotlin
+class DataSanitizer {
+    private val phonePattern = Regex("""1[3-9]\d{9}""")
+    private val emailPattern = Regex("""[\w.-]+@[\w.-]+\.\w+""")
+
+    fun sanitize(text: String): SanitizeResult {
+        var sanitized = text
+        val replacements = mutableMapOf<String, String>()
+        phonePattern.findAll(text).forEach { match ->
+            val placeholder = "[PHONE_${replacements.size}]"
+            replacements[placeholder] = match.value
+            sanitized = sanitized.replace(match.value, placeholder)
+        }
+        emailPattern.findAll(text).forEach { match ->
+            val placeholder = "[EMAIL_${replacements.size}]"
+            replacements[placeholder] = match.value
+            sanitized = sanitized.replace(match.value, placeholder)
+        }
+        return SanitizeResult(sanitized, replacements)
+    }
+
+    fun restore(text: String, replacements: Map<String, String>): String {
+        var restored = text
+        replacements.forEach { (k, v) -> restored = restored.replace(k, v) }
+        return restored
+    }
+}
+```
+
+### 6.3 用户授权设置
+
+```kotlin
+data class AIPrivacySettings(
+    val allowLocalAnalysis: Boolean = true,
+    val allowCloudAnalysis: Boolean = false,
+    val allowMessageAnalysis: Boolean = true,
+    val allowCallLogAnalysis: Boolean = true,
+    val allowContactAnalysis: Boolean = false,
+    val autoSanitize: Boolean = true,
+    val excludedContacts: Set<String> = emptySet(),
+    val retentionDays: Int = 90
+)
+```
+
+---
+
+## 7. 开发路线图
+
+### 7.1 阶段规划
+
+```mermaid
+gantt
+    title AI Agent 集成开发路线图
+    dateFormat YYYY-MM-DD
+    section 阶段一：基础设施
+    AnalysisProvider 接口      :a1, 2026-06-01, 15d
+    知识库数据管线             :a2, 2026-06-15, 30d
+    向量索引与全文检索         :a3, 2026-07-01, 20d
+    section 阶段二：本地模型
+    ONNX Runtime 集成         :b1, 2026-07-15, 20d
+    嵌入模型与摘要模型         :b2, 2026-08-01, 30d
+    section 阶段三：云端模型
+    CloudAnalysisProvider     :c1, 2026-09-01, 15d
+    OpenAI API 对接           :c2, 2026-09-15, 15d
+    section 阶段四：隐私与体验
+    数据脱敏与授权设置         :d1, 2026-10-01, 20d
+    智能搜索上线               :d2, 2026-10-20, 20d
+    沟通洞察与主动提醒         :d3, 2026-11-10, 30d
+```
+
+### 7.2 里程碑
+
+| 里程碑 | 时间 | 交付物 |
+|--------|------|--------|
+| M1 - 知识库就绪 | 2026-07 | 数据管线 + 向量索引 + 全文检索 |
+| M2 - 本地 AI 可用 | 2026-09 | ONNX 推理 + 嵌入 + 摘要模型 |
+| M3 - 云端 AI 可用 | 2026-10 | 云端 API 对接 + 流式输出 |
+| M4 - 功能完整 | 2026-12 | 脱敏 + 授权 + 智能搜索 + 洞察 |
+
+### 7.3 风险与应对
+
+| 风险 | 影响 | 应对策略 |
+|------|------|---------|
+| 本地模型精度不足 | 分析质量不理想 | 云端模型作为降级方案 |
+| ONNX 包体积大 | APK 膨胀 | 模型按需下载，不内置 |
+| 云端 API 成本 | 运营费用增加 | 本地优先 + 请求缓存 + 限流 |
+| 隐私合规风险 | 法律问题 | 严格脱敏 + 用户授权 + 审计 |
\ No newline at end of file
diff --git a/android/docs/architecture/backend-microservices.md b/android/docs/architecture/backend-microservices.md
new file mode 100644
index 0000000..313ce1d
--- /dev/null
+++ b/android/docs/architecture/backend-microservices.md
@@ -0,0 +1,401 @@
+# 后端微服务架构设计文档
+
+## 1. 概述
+
+### 1.1 为什么需要后端微服务架构
+Commory 目前以本地备份为核心，所有数据存储在设备端。以下需求驱动了后端微服务架构的引入：
+
+| 需求 | 说明 |
+|------|------|
+| 云端同步 | 用户期望多设备间同步备份数据 |
+| 跨设备恢复 | 换机时从云端恢复历史备份 |
+| AI 云端分析 | 本地模型能力有限，需云端大模型支持 |
+| 协作备份 | 家庭成员共享备份空间 |
+| 数据安全 | 云端加密存储，防止设备丢失导致数据丢失 |
+
+### 1.2 设计目标
+
+- **轻量可自部署**：支持家庭 NAS 的 Docker Compose 一键部署
+- **渐进式架构**：从单体开始，按需拆分为微服务
+- **安全优先**：端到端加密、零知识架构、最小权限
+- **成本可控**：资源占用低，适合个人/家庭使用场景
+
+---
+
+## 2. 服务拆分方案
+
+### 2.1 服务全景图
+
+```mermaid
+graph TB
+    subgraph client[客户端]
+        android[Android]
+        harmony[鸿蒙]
+        web[Web 管理面板]
+    end
+
+    subgraph gateway[API 网关]
+        gw[API Gateway<br/>Nginx / Kong]
+    end
+
+    subgraph services[微服务]
+        auth[认证服务<br/>auth-service]
+        backup[备份存储服务<br/>backup-service]
+        ai[AI 分析服务<br/>ai-service]
+        push[推送服务<br/>push-service]
+    end
+
+    subgraph storage[存储层]
+        pg[(PostgreSQL)]
+        minio[(MinIO)]
+        redis[(Redis)]
+        chroma[(ChromaDB)]
+    end
+
+    client --> gateway
+    gateway --> auth & backup & ai & push
+    auth --> pg & redis
+    backup --> pg & minio
+    ai --> pg & chroma
+    push --> redis
+```
+
+### 2.2 服务职责
+
+| 服务 | 职责 | 技术栈 | 数据存储 |
+|------|------|--------|---------|
+| auth-service | 用户认证、Token 管理、OAuth2.0 | Go / Kotlin | PostgreSQL + Redis |
+| backup-service | 备份上传/下载/管理、版本控制 | Go / Kotlin | PostgreSQL + MinIO |
+| ai-service | AI 分析、知识库管理、模型调度 | Python | PostgreSQL + ChromaDB |
+| push-service | 消息推送、事件通知 | Go | Redis |
+| API Gateway | 路由、限流、鉴权、日志 | Nginx / Kong | - |
+
+### 2.3 服务间通信
+
+```mermaid
+graph LR
+    gw[API Gateway] -->|HTTP/REST| auth & backup & ai & push
+    auth -->|gRPC| backup
+    backup -->|异步消息| push
+    ai -->|HTTP/REST| backup
+    subgraph mq[消息队列 - Redis Streams]
+        stream1[backup.events]
+        stream2[auth.events]
+    end
+    backup --> stream1
+    auth --> stream2
+    push --> stream1
+```
+
+### 2.4 服务 API 设计
+
+#### auth-service
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/auth/register` | 用户注册 |
+| POST | `/api/v1/auth/login` | 用户登录 |
+| POST | `/api/v1/auth/logout` | 用户登出 |
+| POST | `/api/v1/auth/refresh` | 刷新 Token |
+| POST | `/api/v1/auth/oauth2/{provider}` | OAuth2.0 登录 |
+| GET | `/api/v1/auth/me` | 获取当前用户 |
+
+#### backup-service
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/backups` | 上传备份 |
+| GET | `/api/v1/backups` | 列出备份 |
+| GET | `/api/v1/backups/{id}` | 获取备份详情 |
+| GET | `/api/v1/backups/{id}/download` | 下载备份 |
+| DELETE | `/api/v1/backups/{id}` | 删除备份 |
+
+#### ai-service
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| POST | `/api/v1/ai/analyze` | 执行分析 |
+| POST | `/api/v1/ai/analyze/stream` | 流式分析 |
+| POST | `/api/v1/ai/knowledge-base/rebuild` | 重建知识库 |
+| GET | `/api/v1/ai/models` | 获取可用模型 |
+
+---
+
+## 3. API 网关设计
+
+### 3.1 网关架构
+
+```mermaid
+graph TB
+    client[客户端请求] --> gateway[API Gateway - Kong]
+    subgraph plugins[插件链]
+        plugin_auth[JWT 认证]
+        plugin_rate[限流控制]
+        plugin_cors[CORS]
+        plugin_log[请求日志]
+    end
+    gateway --> plugins --> router[路由引擎]
+    router --> auth_svc[auth-service :8081] & backup_svc[backup-service :8082] & ai_svc[ai-service :8083] & push_svc[push-service :8084]
+```
+
+### 3.2 路由规则
+
+| 路径 | 目标服务 | 认证要求 | 限流 |
+|------|---------|---------|------|
+| `/api/v1/auth/login` | auth-service | 无 | 10次/分钟 |
+| `/api/v1/auth/register` | auth-service | 无 | 5次/分钟 |
+| `/api/v1/auth/*` | auth-service | JWT | 60次/分钟 |
+| `/api/v1/backups` | backup-service | JWT | 30次/分钟 |
+| `/api/v1/backups/*/download` | backup-service | JWT | 10次/分钟 |
+| `/api/v1/ai/*` | ai-service | JWT | 20次/分钟 |
+
+### 3.3 鉴权流程
+
+```mermaid
+sequenceDiagram
+    participant Client as 客户端
+    participant GW as API Gateway
+    participant Auth as auth-service
+    participant Service as 目标服务
+
+    Client->>GW: 请求 (携带 JWT)
+    GW->>GW: 验证 JWT 签名和有效期
+    alt JWT 有效
+        GW->>Service: 转发请求 (X-User-Id Header)
+        Service-->>Client: 200 OK
+    else JWT 过期
+        GW-->>Client: 401 Token Expired
+        Client->>GW: POST /auth/refresh
+        GW->>Auth: 验证 Refresh Token
+        Auth-->>Client: 新 JWT
+    else JWT 无效
+        GW-->>Client: 401 Unauthorized
+    end
+```
+
+---
+
+## 4. 数据流架构
+
+### 4.1 备份上传数据流
+
+```mermaid
+sequenceDiagram
+    participant App as 移动端
+    participant GW as API Gateway
+    participant Backup as backup-service
+    participant MinIO as MinIO
+    participant PG as PostgreSQL
+
+    App->>GW: POST /backups (JWT + 加密数据)
+    GW->>Backup: 转发请求
+    Backup->>Backup: 验证 checksum
+    Backup->>MinIO: 上传加密文件
+    MinIO-->>Backup: object_key
+    Backup->>PG: 保存元数据
+    Backup-->>App: 201 Created { backup_id }
+```
+
+### 4.2 AI 分析数据流
+
+```mermaid
+sequenceDiagram
+    participant App as 移动端
+    participant AI as ai-service
+    participant Chroma as ChromaDB
+    participant LLM as 云端 LLM
+
+    App->>AI: POST /ai/analyze (JWT + 查询)
+    AI->>Chroma: 语义检索
+    Chroma-->>AI: 相关文档片段
+    AI->>AI: 数据脱敏
+    AI->>LLM: 调用大模型
+    LLM-->>AI: 分析结果
+    AI->>AI: 脱敏还原
+    AI-->>App: 200 OK { analysis }
+```
+
+### 4.3 端到端加密
+
+```mermaid
+graph LR
+    subgraph mobile[移动端]
+        encrypt[AES-256-GCM 加密]
+    end
+    subgraph transport[传输层]
+        https[HTTPS / TLS 1.3]
+    end
+    subgraph server[服务端]
+        backup_svc[backup-service]
+        minio[MinIO 加密存储]
+    end
+    encrypt --> https --> backup_svc --> minio
+```
+
+服务端无法解密用户数据，实现零知识架构。
+
+---
+
+## 5. 部署架构
+
+### 5.1 Kubernetes 部署
+
+```mermaid
+graph TB
+    subgraph k8s[Kubernetes 集群]
+        ingress[Nginx Ingress]
+        subgraph svc[服务层]
+            auth_d[auth-service 2 replicas]
+            backup_d[backup-service 2 replicas]
+            ai_d[ai-service 1 replica]
+            push_d[push-service 1 replica]
+        end
+        subgraph mw[中间件]
+            pg_s[PostgreSQL]
+            redis_s[Redis]
+            minio_s[MinIO]
+            chroma_s[ChromaDB]
+        end
+    end
+    ingress --> auth_d & backup_d & ai_d & push_d
+    auth_d --> pg_s & redis_s
+    backup_d --> pg_s & minio_s
+    ai_d --> pg_s & chroma_s
+```
+资源配置：auth-service (2副本, 100-500m CPU, 128-256Mi)、backup-service (2副本, 200-1000m, 256-512Mi)、ai-service (1副本, 500-2000m, 512Mi-2Gi)、push-service (1副本, 50-200m, 64-128Mi)。
+
+---
+
+## 6. NAS 自部署方案
+
+### 6.1 Docker Compose 配置
+
+```yaml
+version: '3.8'
+services:
+  nginx:
+    image: nginx:alpine
+    ports: ["8443:443", "8080:80"]
+    volumes: [./config/nginx/nginx.conf:/etc/nginx/nginx.conf:ro, ./config/nginx/ssl:/etc/nginx/ssl:ro]
+    depends_on: [auth-service, backup-service, ai-service]
+    restart: unless-stopped
+  auth-service:
+    image: commory/auth-service:latest
+    environment: [DATABASE_URL=postgresql://mvault:mvault@postgres:5432/mvault_auth, REDIS_URL=redis://redis:6379/0, JWT_SECRET=${JWT_SECRET}]
+    depends_on: [postgres, redis]
+    restart: unless-stopped
+  backup-service:
+    image: commory/backup-service:latest
+    environment: [DATABASE_URL=postgresql://mvault:mvault@postgres:5432/mvault_backup, MINIO_ENDPOINT=minio:9000, MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY}, MINIO_SECRET_KEY=${MINIO_SECRET_KEY}]
+    depends_on: [postgres, minio]
+    restart: unless-stopped
+  ai-service:
+    image: commory/ai-service:latest
+    environment: [DATABASE_URL=postgresql://mvault:mvault@postgres:5432/mvault_ai, CHROMA_HOST=chromadb, CHROMA_PORT=8000, OPENAI_API_KEY=${OPENAI_API_KEY:-}]
+    depends_on: [postgres, chromadb]
+    restart: unless-stopped
+  push-service:
+    image: commory/push-service:latest
+    environment: [REDIS_URL=redis://redis:6379/1]
+    depends_on: [redis]
+    restart: unless-stopped
+  postgres:
+    image: postgres:16-alpine
+    environment: [POSTGRES_USER=mvault, POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-mvault}]
+    volumes: [./data/postgres:/var/lib/postgresql/data]
+    restart: unless-stopped
+  redis:
+    image: redis:7-alpine
+    command: redis-server --maxmemory 128mb --maxmemory-policy allkeys-lru
+    volumes: [./data/redis:/data]
+    restart: unless-stopped
+  minio:
+    image: minio/minio:latest
+    command: server /data --console-address ":9001"
+    environment: [MINIO_ROOT_USER=${MINIO_ACCESS_KEY:-minioadmin}, MINIO_ROOT_PASSWORD=${MINIO_SECRET_KEY:-minioadmin}]
+    volumes: [./data/minio:/data]
+    ports: ["9001:9001"]
+    restart: unless-stopped
+  chromadb:
+    image: chromadb/chroma:latest
+    environment: [ANONYMIZED_TELEMETRY=FALSE]
+    volumes: [./data/chroma:/chroma/chroma]
+    restart: unless-stopped
+```
+
+### 6.2 轻量部署模式
+
+对于资源受限的 NAS（< 4GB RAM），提供轻量模式：合并 auth + backup + push 为单服务，使用 SQLite 替代 PostgreSQL，省略 ChromaDB（AI 仅支持云端模型）。
+
+| 部署模式 | 内存占用 | 适用场景 |
+|---------|---------|---------|
+| 完整模式 | ~3GB | 高性能 NAS / 服务器 |
+| 轻量模式 | ~1GB | 入门 NAS / 树莓派 |
+| All-in-One | ~512MB | 极低资源环境 |
+
+---
+
+## 7. 开发路线图
+
+### 7.1 阶段规划
+
+```mermaid
+gantt
+    title 后端微服务开发路线图
+    dateFormat YYYY-MM-DD
+    section 阶段一：基础服务
+    auth-service 开发           :a1, 2026-06-01, 30d
+    backup-service 开发         :a2, 2026-06-15, 30d
+    API Gateway 搭建            :a3, 2026-07-01, 15d
+    section 阶段二：存储与同步
+    MinIO 对象存储集成          :b1, 2026-07-15, 15d
+    端到端加密实现              :b2, 2026-08-01, 20d
+    section 阶段三：AI 服务
+    ai-service 基础框架         :c1, 2026-08-15, 20d
+    知识库与云端模型            :c2, 2026-09-01, 25d
+    section 阶段四：部署运维
+    Docker Compose 配置         :d1, 2026-10-01, 10d
+    NAS 部署方案验证            :d2, 2026-10-10, 15d
+    K8s Helm Chart             :d3, 2026-10-25, 15d
+```
+
+### 7.2 里程碑
+
+| 里程碑 | 时间 | 交付物 |
+|--------|------|--------|
+| M1 - 认证就绪 | 2026-07 | auth-service + JWT + OAuth2.0 |
+| M2 - 备份可用 | 2026-08 | backup-service + MinIO + 加密 |
+| M3 - AI 上线 | 2026-10 | ai-service + 知识库 + 云端模型 |
+| M4 - 自部署就绪 | 2026-11 | Docker Compose + NAS 部署 |
+
+### 7.3 风险与应对
+
+| 风险 | 影响 | 应对策略 |
+|------|------|---------|
+| NAS 环境多样性 | 兼容性问题 | 提供 ARM/AMD64 多架构镜像 |
+| 存储空间不足 | 上传失败 | 配额管理 + 清理策略 |
+| 网络不稳定 | 远程访问中断 | 离线模式 + 断点续传 |
+| 数据迁移困难 | 升级丢数据 | 迁移脚本 + 自动备份 |
+| 安全漏洞 | 数据泄露 | 安全审计 + 依赖更新 |
+
+## 附录：环境变量与端口
+
+| 变量名 | 必需 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `JWT_SECRET` | 是 | - | JWT 签名密钥 |
+| `POSTGRES_PASSWORD` | 否 | `mvault` | PostgreSQL 密码 |
+| `MINIO_ACCESS_KEY` | 否 | `minioadmin` | MinIO 访问密钥 |
+| `MINIO_SECRET_KEY` | 否 | `minioadmin` | MinIO 密钥 |
+| `OPENAI_API_KEY` | 否 | - | OpenAI API 密钥 |
+
+| 服务 | 内部端口 | 外部端口 |
+|------|---------|---------|
+| Nginx | 80/443 | 8080/8443 |
+| auth-service | 8081 | - |
+| backup-service | 8082 | - |
+| ai-service | 8083 | - |
+| push-service | 8084 | - |
+| PostgreSQL | 5432 | - |
+| Redis | 6379 | - |
+| MinIO | 9000/9001 | 9001 |
+| ChromaDB | 8000 | - |
\ No newline at end of file
diff --git a/android/docs/architecture/harmonyos-adaptation.md b/android/docs/architecture/harmonyos-adaptation.md
new file mode 100644
index 0000000..5b1415e
--- /dev/null
+++ b/android/docs/architecture/harmonyos-adaptation.md
@@ -0,0 +1,401 @@
+# 鸿蒙适配设计文档
+
+## 1. 概述
+
+### 1.1 背景
+
+随着华为 HarmonyOS 的快速发展和市场份额持续增长，越来越多的用户在鸿蒙系统上使用 Commory。鸿蒙系统从 NEXT 版本开始不再兼容 Android APK，这意味着 Commory 需要开发原生鸿蒙版本以覆盖这部分用户群体。
+
+### 1.2 目标
+
+- 实现与 Android 版本功能对等的鸿蒙原生应用
+- 最大化复用现有 Kotlin 核心逻辑，降低开发和维护成本
+- 确保鸿蒙端与 Android 端备份数据格式完全兼容
+- 为鸿蒙端预留 AI Agent 能力集成接口
+
+### 1.3 范围
+
+本文档覆盖鸿蒙端应用的整体架构设计、权限适配、核心逻辑复用、原生开发方案及 AI Agent 集成规划，不涉及具体代码实现细节。
+---
+
+## 2. 鸿蒙权限差异分析
+
+### 2.1 权限模型对比
+
+Android 与 HarmonyOS 在消息类应用的权限模型上存在显著差异：
+
+| 权限功能 | Android | HarmonyOS | 差异说明 |
+|---------|---------|-----------|---------|
+| 短信读取 | `READ_SMS`（危险权限） | `ohos.permission.READ_MESSAGES`（user_grant） | 鸿蒙需在 module.json5 声明，且用户可随时撤销 |
+| 通话记录读取 | `READ_CALL_LOG`（危险权限） | `ohos.permission.READ_CALL_LOG`（user_grant） | 权限名称相似，但授权流程不同 |
+| 联系人读取 | `READ_CONTACTS`（危险权限） | `ohos.permission.READ_CONTACTS`（user_grant） | 鸿蒙联系人通过 DataShareHelper 访问 |
+| 短信发送 | `SEND_SMS`（危险权限） | `ohos.permission.SEND_MESSAGES`（user_grant） | 鸿蒙需额外申请短信发送能力 |
+| 后台运行 | `FOREGROUND_SERVICE` | `ohos.permission.KEEP_BACKGROUND_RUNNING` | 鸿蒙长时任务需明确声明类型 |
+| 网络访问 | `INTERNET`（普通权限） | `ohos.permission.INTERNET`（normal） | 基本一致 |
+
+### 2.2 权限申请流程差异
+
+```mermaid
+flowchart TD
+    subgraph Android
+        A1[声明权限] --> A2[运行时请求]
+        A2 --> A3{用户选择}
+        A3 -->|允许| A4[获取权限]
+        A3 -->|拒绝| A5[引导设置页]
+    end
+
+    subgraph HarmonyOS
+        B1[module.json5 声明] --> B2[abilityContext.requestPermissionsFromUser]
+        B2 --> B3{用户选择}
+        B3 -->|允许| B4[获取权限]
+        B3 -->|拒绝| B5[显示理由后再次请求]
+        B5 --> B6{用户选择}
+        B6 -->|永久拒绝| B7[引导应用设置页]
+    end
+```
+
+### 2.3 数据访问 API 差异
+
+Android 通过 `ContentResolver` 访问系统数据，而鸿蒙使用 `DataShareHelper`：
+
+| 数据类型 | Android API | HarmonyOS API |
+|---------|------------|---------------|
+| 短信 | `ContentResolver.query(Telephony.Sms.CONTENT_URI)` | `DataShareHelper.query(SMS_URI)` |
+| 通话记录 | `ContentResolver.query(CallLog.Calls.CONTENT_URI)` | `DataShareHelper.query(CALL_LOG_URI)` |
+| 联系人 | `ContentResolver.query(ContactsContract.Contacts.CONTENT_URI)` | `DataShareHelper.query(CONTACT_URI)` |
+
+---
+
+## 3. 核心逻辑复用策略
+
+### 3.1 可复用模块识别
+
+当前 Android 项目中，以下模块为纯 Kotlin 逻辑，与 Android 框架无耦合，可直接复用到鸿蒙端：
+
+| 模块 | 路径 | 复用方式 | 说明 |
+|------|------|---------|------|
+| 数据模型 | `data/models/BackupModels.kt` | Kotlin Multiplatform | `BackupData`、`MessageData`、`CallLogData`、`ContactData` 等纯数据类 |
+| 备份状态 | `data/models/BackupModels.kt` | Kotlin Multiplatform | `BackupState`、`RestoreState` 密封类 |
+| JSON 序列化配置 | `data/BackupManager.kt` (Gson 配置) | 提取为独立模块 | Gson 实例配置逻辑可跨平台使用 |
+| 工具类 | `utils/PhoneNumberUtils.kt` | Kotlin Multiplatform | 号码格式化等纯逻辑 |
+
+### 3.2 Kotlin Multiplatform 复用架构
+
+```mermaid
+graph TB
+    subgraph shared[共享模块 - Kotlin Multiplatform]
+        models[数据模型层<br/>BackupData / MessageData / CallLogData / ContactData]
+        serialization[序列化层<br/>Gson 配置 / JSON Schema]
+        utils[工具层<br/>PhoneNumberUtils / Constants]
+        state[状态层<br/>BackupState / RestoreState]
+    end
+
+    subgraph android[Android 端]
+        a_backup[BackupManager<br/>ContentResolver 读取]
+        a_restore[RestoreManager<br/>ContentResolver 写入]
+        a_ui[Jetpack Compose UI]
+    end
+
+    subgraph harmony[鸿蒙端]
+        h_backup[HarmonyBackupManager<br/>DataShareHelper 读取]
+        h_restore[HarmonyRestoreManager<br/>DataShareHelper 写入]
+        h_ui[ArkUI 界面]
+    end
+
+    models --> a_backup
+    models --> h_backup
+    serialization --> a_backup
+    serialization --> h_backup
+    state --> a_ui
+    state --> h_ui
+    utils --> a_backup
+    utils --> h_backup
+```
+
+### 3.3 复用策略实施
+
+**阶段一：提取共享模块**
+
+将纯 Kotlin 数据模型和工具类提取到独立的 Kotlin Multiplatform 模块 `sdk/backup-shared`：
+
+```
+sdk/backup-shared/
+├── build.gradle.kts          # KMP 构建配置
+├── src/
+│   ├── commonMain/kotlin/    # 共享代码
+│   │   └── imken/commory/shared/
+│   │       ├── model/        # 数据模型
+│   │       ├── state/        # 状态定义
+│   │       └── util/         # 工具类
+│   ├── androidMain/kotlin/   # Android 特定实现
+│   └── harmonynosMain/kotlin/ # 鸿蒙特定实现
+```
+
+**阶段二：定义平台接口**
+
+通过 `expect/actual` 机制处理平台差异：
+
+```kotlin
+// commonMain
+expect class PlatformDataReader {
+    fun readMessages(): List<MessageData>
+    fun readCallLogs(): List<CallLogData>
+    fun readContacts(): List<ContactData>
+}
+
+// androidMain
+actual class PlatformDataReader actual constructor() {
+    actual fun readMessages(): List<MessageData> {
+        // ContentResolver 实现
+    }
+}
+
+// harmonynosMain
+actual class PlatformDataReader actual constructor() {
+    actual fun readMessages(): List<MessageData> {
+        // DataShareHelper 实现
+    }
+}
+```
+
+---
+
+## 4. 鸿蒙原生开发方案
+
+### 4.1 技术栈选择
+
+| 层次 | 技术方案 | 说明 |
+|------|---------|------|
+| 开发语言 | ArkTS | 鸿蒙官方推荐语言，TypeScript 超集 |
+| UI 框架 | ArkUI (声明式) | 鸿蒙原生 UI 框架 |
+| 状态管理 | @State / @Link / AppStorage | ArkUI 内置状态管理 |
+| 数据持久化 | 关系型数据库 (RDB) | 鸿蒙本地数据库 |
+| 网络请求 | @ohos.net.http | 鸿蒙网络模块 |
+| 文件管理 | @ohos.file.fs | 鸿蒙文件系统 |
+
+### 4.2 应用架构
+
+```mermaid
+graph TB
+    subgraph ui[UI 层 - ArkUI]
+        pages[Pages<br/>备份页/恢复页/设置页/更多页]
+        components[自定义组件<br/>BackupCard/PermissionDialog]
+    end
+
+    subgraph viewmodel[ViewModel 层]
+        backup_vm[BackupViewModel]
+        restore_vm[RestoreViewModel]
+        settings_vm[SettingsViewModel]
+    end
+
+    subgraph service[Service 层]
+        backup_svc[BackupService<br/>DataShareHelper 数据读取]
+        restore_svc[RestoreService<br/>DataShareHelper 数据写入]
+        permission_svc[PermissionService<br/>权限管理]
+    end
+
+    subgraph data[Data 层]
+        model[数据模型<br/>与 Android 端共享 JSON Schema]
+        repository[Repository<br/>本地文件 + 云端 API]
+        knowledge[KnowledgeRepository<br/>AI 知识库]
+    end
+
+    pages --> viewmodel
+    viewmodel --> service
+    service --> data
+```
+
+### 4.3 项目结构
+
+```
+commory-harmony/
+├── entry/
+│   └── src/main/
+│       ├── ets/
+│       │   ├── entryability/
+│       │   │   └── EntryAbility.ets
+│       │   ├── pages/
+│       │   │   ├── BackupPage.ets
+│       │   │   ├── RestorePage.ets
+│       │   │   ├── PreviewPage.ets
+│       │   │   └── SettingsPage.ets
+│       │   ├── viewmodel/
+│       │   │   ├── BackupViewModel.ets
+│       │   │   └── RestoreViewModel.ets
+│       │   ├── service/
+│       │   │   ├── BackupService.ets
+│       │   │   ├── RestoreService.ets
+│       │   │   └── PermissionService.ets
+│       │   ├── model/
+│       │   │   ├── BackupData.ets
+│       │   │   ├── MessageData.ets
+│       │   │   └── CallLogData.ets
+│       │   └── common/
+│       │       ├── Constants.ets
+│       │       └── Logger.ets
+│       └── resources/
+│           ├── base/
+│           │   ├── element/
+│           │   ├── media/
+│           │   └── profile/
+│           ├── zh_CN/
+│           └── en_US/
+├── build-profile.json5
+└── hvigorfile.ts
+```
+
+### 4.4 数据读取实现要点
+
+鸿蒙端通过 `DataShareHelper` 读取系统数据的核心流程：
+
+```typescript
+// 短信读取伪代码
+import dataShare from '@ohos.data.dataShare';
+
+async function readMessages(context: Context): Promise<MessageData[]> {
+    const helper = dataShare.createDataShareHelper(context, SMS_URI);
+    const resultColumns = ['_id', 'address', 'body', 'date', 'type', 'read', 'status'];
+    const predicate = new dataShare.DataSharePredicates();
+    const resultSet = await helper.query(SMS_URI, resultColumns, predicate);
+
+    const messages: MessageData[] = [];
+    while (resultSet.goToNextRow()) {
+        messages.push({
+            id: resultSet.getLong(resultSet.getColumnIndex('_id')),
+            address: resultSet.getString(resultSet.getColumnIndex('address')),
+            body: resultSet.getString(resultSet.getColumnIndex('body')),
+            date: resultSet.getLong(resultSet.getColumnIndex('date')),
+            type: resultSet.getLong(resultSet.getColumnIndex('type')),
+            read: resultSet.getLong(resultSet.getColumnIndex('read')) === 1,
+            status: resultSet.getLong(resultSet.getColumnIndex('status'))
+        });
+    }
+    resultSet.close();
+    return messages;
+}
+```
+
+---
+
+## 5. AI Agent 集成规划
+
+### 5.1 鸿蒙端 AI 能力架构
+
+```mermaid
+graph LR
+    subgraph app[鸿蒙应用]
+        ai_ui[AI 交互界面<br/>ArkUI]
+        ai_vm[AI ViewModel]
+    end
+
+    subgraph local[本地 AI]
+        mindspore[MindSpore Lite<br/>鸿蒙端推理引擎]
+        knowledge[本地知识库<br/>RDB + 向量索引]
+    end
+
+    subgraph cloud[云端 AI]
+        api[AI API 网关]
+        llm[大语言模型]
+    end
+
+    ai_ui --> ai_vm
+    ai_vm --> mindspore
+    ai_vm --> knowledge
+    ai_vm --> api
+    api --> llm
+```
+
+### 5.2 MindSpore Lite 集成
+
+鸿蒙系统原生支持 MindSpore Lite 作为端侧 AI 推理引擎，相比 Android 端使用 ONNX Runtime / TFLite 更加自然：
+
+| 能力 | Android 方案 | 鸿蒙方案 |
+|------|-------------|---------|
+| 端侧推理 | ONNX Runtime / TFLite | MindSpore Lite |
+| 模型格式 | .onnx / .tflite | .ms (MindSpore) |
+| NPU 加速 | NNAPI Delegate | HiAI Delegate |
+| API 语言 | Kotlin / Java | ArkTS / C++ |
+
+### 5.3 知识库构建
+
+鸿蒙端知识库基于用户备份数据构建，与 Android 端共享数据格式：
+
+1. **数据索引**：解析备份 JSON 文件，提取消息/通话/联系人数据
+2. **向量化存储**：使用 MindSpore Lite 的文本嵌入模型将消息内容向量化
+3. **本地检索**：基于向量相似度的语义搜索
+4. **隐私保护**：所有向量化计算在本地完成，不上传原始数据
+
+### 5.4 AI 分析场景
+
+| 场景 | 描述 | 实现方式 |
+|------|------|---------|
+| 消息摘要 | 对大量消息生成摘要 | 本地小模型 / 云端大模型 |
+| 联系人洞察 | 分析与某联系人的沟通频率和模式 | 本地统计分析 + AI 解读 |
+| 通话分析 | 通话时长/频率趋势分析 | 本地统计 + 可视化 |
+| 智能搜索 | 自然语言搜索消息内容 | 向量检索 + 语义匹配 |
+
+---
+
+## 6. 开发路线图
+
+### 6.1 阶段规划
+
+```mermaid
+gantt
+    title 鸿蒙适配开发路线图
+    dateFormat YYYY-MM-DD
+    section 阶段一：基础架构
+    提取 KMP 共享模块           :a1, 2026-06-01, 30d
+    鸿蒙项目脚手架搭建           :a2, 2026-06-15, 20d
+    权限系统适配               :a3, 2026-07-01, 15d
+    section 阶段二：核心功能
+    短信备份/恢复              :b1, 2026-07-15, 30d
+    通话记录备份/恢复           :b2, 2026-08-01, 20d
+    联系人备份/恢复             :b3, 2026-08-15, 15d
+    section 阶段三：体验优化
+    UI 适配与优化              :c1, 2026-09-01, 20d
+    云端同步功能               :c2, 2026-09-15, 25d
+    section 阶段四：AI 能力
+    本地知识库构建             :d1, 2026-10-01, 30d
+    MindSpore Lite 集成        :d2, 2026-10-15, 30d
+    AI 分析功能上线             :d3, 2026-11-15, 20d
+```
+
+### 6.2 里程碑
+
+| 里程碑 | 时间 | 交付物 |
+|--------|------|--------|
+| M1 - 架构就绪 | 2026-07 | KMP 共享模块 + 鸿蒙项目骨架 + 权限适配 |
+| M2 - 功能对齐 | 2026-09 | 短信/通话/联系人备份恢复完整功能 |
+| M3 - 体验完善 | 2026-10 | UI 优化 + 云端同步 + 应用商店上架 |
+| M4 - AI 增强 | 2026-12 | 本地知识库 + AI 分析 + 智能搜索 |
+
+### 6.3 风险与应对
+
+| 风险 | 影响 | 应对策略 |
+|------|------|---------|
+| 鸿蒙 API 变更 | 数据读取接口不稳定 | 封装适配层，隔离 API 变化 |
+| KMP 鸿蒙目标支持 | Kotlin 官方对 HarmonyOS 目标支持不完善 | 优先使用 ArkTS 原生实现，KMP 仅共享数据模型 |
+| MindSpore 模型生态 | 可用模型较少 | 预留 ONNX 模型转换方案 |
+| 鸿蒙应用商店审核 | 审核流程和政策不确定 | 提前了解审核要求，预留调整时间 |
+
+---
+
+## 附录
+
+### A. 术语表
+
+| 术语 | 说明 |
+|------|------|
+| ArkTS | 鸿蒙应用开发语言，TypeScript 超集 |
+| ArkUI | 鸿蒙声明式 UI 框架 |
+| DataShareHelper | 鸿蒙数据共享访问助手 |
+| MindSpore Lite | 华为端侧 AI 推理框架 |
+| KMP | Kotlin Multiplatform |
+| module.json5 | 鸿蒙模块配置文件 |
+
+### B. 参考资料
+
+- [HarmonyOS 应用开发文档](https://developer.harmonyos.com/)
+- [Kotlin Multiplatform 官方文档](https://kotlinlang.org/docs/multiplatform.html)
+- [MindSpore Lite 文档](https://www.mindspore.cn/lite)
\ No newline at end of file
diff --git a/android/docs/architecture/third-party-auth.md b/android/docs/architecture/third-party-auth.md
new file mode 100644
index 0000000..1a2de9e
--- /dev/null
+++ b/android/docs/architecture/third-party-auth.md
@@ -0,0 +1,379 @@
+# 第三方登录设计文档
+
+## 1. 概述
+
+### 1.1 背景
+
+Commory 当前仅支持本地模式，无需登录即可使用。随着云端同步、AI 分析等功能引入，需要建立统一用户身份体系，支持多种登录方式。
+
+### 1.2 设计目标
+
+- **本地优先**：保持无服务器即可使用的核心能力
+- **渐进增强**：登录后解锁云端同步等高级功能
+- **可扩展**：灵活接入新的第三方登录提供商
+- **安全可靠**：Token 安全存储、自动刷新、HTTPS 强制传输
+
+---
+
+## 2. AuthProvider 接口设计
+
+### 2.1 核心接口
+
+```kotlin
+interface AuthProvider {
+    val providerId: String
+    val displayName: String
+    val isAvailable: Boolean
+
+    suspend fun login(context: AuthContext): AuthResult
+    suspend fun logout(): Result<Unit>
+    fun isAuthenticated(): Boolean
+    fun getCurrentUser(): UserInfo?
+    suspend fun getToken(): String?
+    suspend fun refreshToken(): Result<String>
+    fun observeAuthState(): Flow<AuthState>
+}
+```
+
+### 2.2 数据模型
+
+```kotlin
+sealed class AuthState {
+    object Unauthenticated : AuthState()
+    object Authenticating : AuthState()
+    data class Authenticated(val user: UserInfo) : AuthState()
+    data class Error(val message: String, val code: String?) : AuthState()
+}
+
+data class UserInfo(
+    val uid: String,
+    val displayName: String,
+    val email: String?,
+    val avatarUrl: String?,
+    val providerId: String,
+    val metadata: Map<String, String> = emptyMap()
+)
+
+data class AuthToken(
+    val accessToken: String,
+    val refreshToken: String?,
+    val expiresIn: Long,
+    val tokenType: String = "Bearer",
+    val createdAt: Long = System.currentTimeMillis()
+) {
+    val isExpired: Boolean
+        get() = System.currentTimeMillis() > createdAt + expiresIn * 1000
+}
+
+sealed class AuthResult {
+    data class Success(val user: UserInfo, val token: AuthToken) : AuthResult()
+    data class Failure(val error: AuthError) : AuthResult()
+    object Cancelled : AuthResult()
+}
+
+sealed class AuthError {
+    object NetworkError : AuthError()
+    object InvalidCredentials : AuthError()
+    object UserCancelled : AuthError()
+    data class ProviderError(val code: String, val message: String) : AuthError()
+}
+```
+
+### 2.3 接口关系图
+
+```mermaid
+classDiagram
+    class AuthProvider {
+        <<interface>>
+        +providerId: String
+        +login(context): AuthResult
+        +logout(): Result~Unit~
+        +isAuthenticated(): Boolean
+        +getCurrentUser(): UserInfo?
+        +getToken(): String?
+        +refreshToken(): Result~String~
+        +observeAuthState(): Flow~AuthState~
+    }
+
+    class LocalAuthProvider {
+        +providerId = "local"
+    }
+
+    class FeiniuAuthProvider {
+        +providerId = "feiniu"
+    }
+
+    class OAuth2AuthProvider {
+        +providerId: String
+    }
+
+    class AuthProviderRegistry {
+        -providers: Map~String, AuthProvider~
+        +register(provider)
+        +get(providerId): AuthProvider?
+    }
+
+    AuthProvider <|.. LocalAuthProvider
+    AuthProvider <|.. FeiniuAuthProvider
+    AuthProvider <|.. OAuth2AuthProvider
+    AuthProviderRegistry o-- AuthProvider
+```
+
+---
+
+## 3. 本地模式实现
+
+### 3.1 LocalAuthProvider 设计
+
+`LocalAuthProvider` 是默认认证实现，生成本地唯一标识符作为用户 ID，所有数据存储在设备本地。
+
+```kotlin
+class LocalAuthProvider(
+    private val tokenStore: TokenStore
+) : AuthProvider {
+
+    override val providerId = "local"
+    override val displayName = "本地模式"
+    override val isAvailable = true
+
+    private val _authState = MutableStateFlow<AuthState>(AuthState.Unauthenticated)
+    private var localUser: UserInfo? = null
+
+    override suspend fun login(context: AuthContext): AuthResult {
+        val user = tokenStore.getLocalUser() ?: createLocalUser()
+        localUser = user
+        tokenStore.saveLocalUser(user)
+        _authState.value = AuthState.Authenticated(user)
+        return AuthResult.Success(user, generateLocalToken(user))
+    }
+
+    override suspend fun logout(): Result<Unit> {
+        localUser = null
+        tokenStore.clearLocalUser()
+        _authState.value = AuthState.Unauthenticated
+        return Result.success(Unit)
+    }
+
+    override fun isAuthenticated(): Boolean = localUser != null
+    override fun getCurrentUser(): UserInfo? = localUser
+    override suspend fun getToken(): String? = tokenStore.getLocalToken()
+    override fun observeAuthState(): Flow<AuthState> = _authState
+
+    private fun createLocalUser(): UserInfo = UserInfo(
+        uid = "local_${UUID.randomUUID()}",
+        displayName = "本地用户",
+        email = null, avatarUrl = null, providerId = providerId
+    )
+}
+```
+
+### 3.2 本地模式数据流
+
+```mermaid
+sequenceDiagram
+    participant User as 用户
+    participant App as Commory
+    participant Local as LocalAuthProvider
+    participant Store as TokenStore
+
+    User->>App: 首次启动
+    App->>Local: login()
+    Local->>Store: getLocalUser()
+    Store-->>Local: null (首次)
+    Local->>Local: createLocalUser()
+    Local->>Store: saveLocalUser(user)
+    Local-->>App: AuthResult.Success
+    App->>App: 进入主界面（本地模式）
+```
+
+### 3.3 本地模式限制
+
+| 功能 | 本地模式 | 在线模式 |
+|------|---------|---------|
+| 本地备份/恢复 | ✅ | ✅ |
+| 云端同步 | ❌ | ✅ |
+| 跨设备恢复 | ❌ | ✅ |
+| AI 云端分析 | ❌ | ✅ |
+| 本地 AI 分析 | ✅ | ✅ |
+
+---
+
+## 4. 非牛登录接入方案
+
+### 4.1 FeiniuAuthProvider 设计
+
+非牛登录采用 OAuth 2.0 授权码模式，用户通过非牛账号认证后获取 Token。
+
+```kotlin
+class FeiniuAuthProvider(
+    private val config: FeiniuAuthConfig,
+    private val tokenStore: TokenStore,
+    private val httpClient: HttpClient
+) : AuthProvider {
+
+    override val providerId = "feiniu"
+    override val displayName = "非牛登录"
+    override val isAvailable: Boolean
+        get() = config.clientId.isNotEmpty()
+
+    data class FeiniuAuthConfig(
+        val clientId: String,
+        val clientSecret: String,
+        val redirectUri: String,
+        val authEndpoint: String = "https://auth.feiniu.com/oauth2/authorize",
+        val tokenEndpoint: String = "https://auth.feiniu.com/oauth2/token",
+        val userInfoEndpoint: String = "https://api.feiniu.com/userinfo",
+        val scopes: List<String> = listOf("openid", "profile", "email")
+    )
+
+    override suspend fun login(context: AuthContext): AuthResult {
+        _authState.value = AuthState.Authenticating
+        return try {
+            val authCode = requestAuthCode(context)
+            val token = exchangeToken(authCode)
+            val user = fetchUserInfo(token.accessToken)
+            tokenStore.saveToken(providerId, token)
+            tokenStore.saveUser(providerId, user)
+            _authState.value = AuthState.Authenticated(user)
+            AuthResult.Success(user, token)
+        } catch (e: CancellationException) {
+            AuthResult.Cancelled
+        } catch (e: Exception) {
+            AuthResult.Failure(AuthError.ProviderError("FEINIU_ERROR", e.message ?: ""))
+        }
+    }
+}
+```
+
+### 4.2 非牛登录流程
+
+```mermaid
+sequenceDiagram
+    participant User as 用户
+    participant App as Commory
+    participant Browser as 系统浏览器
+    participant Server as 非牛认证服务器
+
+    User->>App: 点击"非牛登录"
+    App->>Browser: 打开授权页面
+    Browser->>Server: GET /oauth2/authorize
+    User->>Browser: 输入账号并授权
+    Server-->>Browser: 302 redirect_uri?code=AUTH_CODE
+    Browser-->>App: 拦截回调，获取 code
+    App->>Server: POST /oauth2/token
+    Server-->>App: { access_token, refresh_token }
+    App->>Server: GET /userinfo
+    Server-->>App: { uid, name, email }
+    App->>App: 切换到在线模式
+```
+
+---
+
+## 5. OAuth2.0 扩展规划
+
+### 5.1 通用 OAuth2AuthProvider
+
+```kotlin
+class OAuth2AuthProvider(
+    private val config: OAuth2Config,
+    private val tokenStore: TokenStore,
+    private val httpClient: HttpClient
+) : AuthProvider {
+
+    data class OAuth2Config(
+        val providerId: String,
+        val displayName: String,
+        val clientId: String,
+        val clientSecret: String,
+        val redirectUri: String,
+        val authEndpoint: String,
+        val tokenEndpoint: String,
+        val userInfoEndpoint: String,
+        val scopes: List<String>,
+        val userInfoMapper: (Map<String, Any>) -> UserInfo
+    )
+}
+```
+
+### 5.2 扩展点设计
+
+```mermaid
+graph TB
+    subgraph core[认证核心]
+        registry[AuthProviderRegistry]
+        manager[AuthManager]
+        store[TokenStore]
+    end
+
+    subgraph providers[认证提供商]
+        local[LocalAuthProvider]
+        feiniu[FeiniuAuthProvider]
+        google[OAuth2AuthProvider - Google]
+        github[OAuth2AuthProvider - GitHub]
+        custom[自定义 Provider]
+    end
+
+    providers --> registry
+    registry --> manager
+    manager --> store
+```
+
+接入新 OAuth2 提供商只需：1) 配置 `OAuth2Config`；2) 实现 `userInfoMapper`；3) 在 Registry 注册。
+
+---
+
+## 6. 安全考量
+
+### 6.1 Token 存储安全
+
+| 存储方式 | 安全等级 | 说明 |
+|---------|---------|------|
+| EncryptedSharedPreferences | 高 | 基于 Android Keystore 加密（推荐） |
+| Android Keystore | 最高 | 硬件级安全，API 复杂 |
+| SharedPreferences | 低 | 明文存储，不推荐 |
+
+```kotlin
+interface TokenStore {
+    fun saveToken(providerId: String, token: AuthToken)
+    fun getToken(providerId: String): AuthToken?
+    fun clearToken(providerId: String)
+    fun saveUser(providerId: String, user: UserInfo)
+    fun getUser(providerId: String): UserInfo?
+    fun clearUser(providerId: String)
+    fun saveLocalUser(user: UserInfo)
+    fun getLocalUser(): UserInfo?
+    fun clearLocalUser()
+    fun saveLocalToken(token: AuthToken)
+    fun getLocalToken(): String?
+}
+```
+
+### 6.2 Token 刷新机制
+
+```mermaid
+flowchart TD
+    A[API 请求] --> B{检查 Token}
+    B -->|有效| C[发送请求]
+    B -->|即将过期| D[后台刷新]
+    D -->|成功| C
+    D -->|失败| E{有 refresh_token?}
+    E -->|是| F[使用 refresh_token 刷新]
+    F -->|成功| C
+    F -->|失败| G[跳转登录页]
+    E -->|否| G
+    B -->|已过期| E
+    C --> I{响应}
+    I -->|200| J[返回数据]
+    I -->|401| F
+```
+
+### 6.3 其他安全措施
+
+| 措施 | 说明 |
+|------|------|
+| 强制 HTTPS | 所有网络请求必须 HTTPS |
+| 证书固定 | 关键 API 启用 Certificate Pinning |
+| Token 绑定设备 | Token 与设备指纹绑定 |
+| 敏感操作二次验证 | 删除云端数据需重新认证 |
+| 本地数据加密 | 备份文件 AES-256 加密 |
+| 日志脱敏 | 不记录 Token、密码等敏感信息 |
diff --git a/android/features.md b/android/features.md
index ffff310..7eaecc3 100644
--- a/android/features.md
+++ b/android/features.md
@@ -1,6 +1,6 @@
-# MessageVault Mobile 功能需求
+# Commory Android 功能需求
 
-本文档列出了MessageVault-Mobile应用的所有核心功能和实现原则，以指导开发流程和优先级排序。
+本文档列出了Commory Android应用的所有核心功能和实现原则，以指导开发流程和优先级排序。
 
 ## 当前开发状态
 
@@ -109,8 +109,9 @@
 
 - **国际化框架**：
   - 字符串资源外部化
-  - 支持中文（默认和zh-rCN）和英文（en）
-  - 可扩展架构，便于添加更多语言
+  - 内置维护中文（默认和 zh-rCN）与英文（en）
+  - 用户可见文案必须进入 Android string resources，不在 Kotlin/Compose 代码中硬编码
+  - 可扩展架构，便于社区后续添加更多语言
   
 - **语言切换**：
   - 运行时切换界面语言
@@ -151,27 +152,69 @@
   - 内存使用监控
   - 电池消耗优化
 
+## 项目架构
+
+### 模块化架构
+
+项目已从单模块架构重构为多模块架构，核心逻辑提取为独立的SDK模块，实现关注点分离和跨平台复用：
+
+```
+Commory Android/
+├── sdk/backup/          # 纯Kotlin备份/恢复SDK
+├── sdk/auth/            # 纯Kotlin认证组件
+├── sdk/storage/         # Android Library存储组件
+├── app/                 # Android应用壳
+└── docs/architecture/   # 架构设计文档
+```
+
+#### SDK模块职责
+
+| 模块 | 类型 | 职责 | 关键组件 |
+|------|------|------|---------|
+| `sdk/backup` | 纯Kotlin (java-library) | 备份/恢复核心逻辑 | `BackupManager`、`RestoreManager`、`BackupSerializer`、数据模型（`BackupData`、`Message`、`CallLog`、`Contact`）、读写接口（`SmsReader`/`SmsWriter`、`CallLogReader`/`CallLogWriter`、`ContactReader`/`ContactWriter`、`BackupFileReader`/`BackupFileWriter`） |
+| `sdk/auth` | 纯Kotlin (java-library) | 认证与身份管理 | `AuthProvider`接口、`LocalAuthProvider`（本地模式）、`ThirdPartyAuthProvider`接口（第三方登录扩展）、`AuthManager`（认证管理器）、`UserInfo`、`AuthResult`、`AuthCredentials` |
+| `sdk/storage` | Android Library | 存储抽象与实现 | `StorageProvider`接口、`LocalStorageProvider`（本地文件存储）、`RemoteStorageProvider`接口（远程存储）、Room数据库、Retrofit网络请求 |
+| `app` | Android Application | 应用壳 | UI（Jetpack Compose）、导航、权限管理、Android平台实现（`AndroidSmsReader`/`AndroidSmsWriter`等）、ViewModel |
+
+#### 模块依赖规则
+
+- `app` → `sdk/backup`、`sdk/auth`、`sdk/storage`
+- SDK模块之间**互不依赖**（`sdk/backup` 不依赖 `sdk/auth` 或 `sdk/storage`）
+- SDK模块**不依赖** `app`
+- `sdk/backup` 和 `sdk/auth` 为纯Kotlin模块，不包含任何Android依赖
+- `sdk/storage` 为Android Library，依赖Room、Retrofit等Android库
+
+#### 架构设计文档
+
+详细的架构设计文档位于 `docs/architecture/` 目录：
+
+- [鸿蒙适配设计文档](docs/architecture/harmonyos-adaptation.md) — 鸿蒙原生开发方案、KMP复用策略、权限差异分析
+- [第三方登录设计文档](docs/architecture/third-party-auth.md) — AuthProvider接口设计、OAuth2.0扩展、Token安全
+- [AI Agent集成设计文档](docs/architecture/ai-agent-integration.md) — 知识库架构、本地/云端AI模型、隐私保护
+- [后端微服务架构设计文档](docs/architecture/backend-microservices.md) — 服务拆分、API网关、NAS自部署方案
+
 ## 技术实现原则
 
 ### 1. 架构设计
 
 - **模块化**：
-  - 清晰的关注点分离
-  - 松耦合组件设计
-  - 依赖注入模式
+  - 清晰的关注点分离，核心逻辑与平台实现解耦
+  - SDK模块采用接口驱动设计，平台实现通过依赖注入
+  - 松耦合组件设计，SDK模块间零依赖
+  - 纯Kotlin SDK模块可跨平台复用（Android、鸿蒙、JVM）
 
 - **数据模型**：
-  - 三层数据模型架构
-    - 业务模型：处理应用内部逻辑（`model/`）
-    - UI模型：专用于UI展示（`models/`）
-    - 数据库实体：本地存储（`data/entity/`）
+  - SDK层数据模型：平台无关的纯数据类（`sdk/backup/model/`）
+  - 应用层UI模型：专用于UI展示（`app/model/`、`app/models/`）
+  - 存储层实体：本地数据库（`sdk/storage` Room实体）
   - 使用Kotlin数据类和扩展函数
   - 类型安全的转换逻辑
-  - JSON序列化（使用Gson）
+  - JSON序列化（使用Gson，封装在`BackupSerializer`中）
   - 版本化模型设计
   - 清晰的模型间映射关系
 
 - **API设计**：
+  - SDK接口定义平台无关契约（`SmsReader`、`StorageProvider`、`AuthProvider`）
   - RESTful接口
   - 使用Retrofit进行API调用
   - 可重试和缓存策略
@@ -209,8 +252,14 @@
 
 ### 4. 测试策略
 
-- **单元测试**：
+- **SDK模块测试**：
+  - `sdk/backup`：纯Kotlin单元测试，无需Android模拟器，覆盖`BackupManager`、`RestoreManager`、`BackupSerializer`及数据模型
+  - `sdk/auth`：纯Kotlin单元测试，覆盖`AuthProvider`接口契约、`LocalAuthProvider`逻辑、`AuthManager`委托模式
+  - `sdk/storage`：Android Instrumented测试，验证`LocalStorageProvider`文件操作、Room数据库交互
+
+- **应用层测试**：
   - 使用JUnit和Mockito
+  - 模拟SDK接口进行ViewModel测试
   - 模拟ContentProvider访问
   - 业务逻辑全覆盖
 
@@ -218,6 +267,7 @@
   - 使用AndroidX Test框架
   - Espresso UI测试
   - 端到端备份/恢复流程测试
+  - SDK与App集成验证
 
 - **CI/CD就绪**：
   - 测试可自动化
@@ -225,6 +275,12 @@
 
 ### 5. 可扩展性
 
+- **SDK接口扩展**：
+  - `SmsReader`/`SmsWriter`等接口可适配不同平台实现（Android、鸿蒙）
+  - `AuthProvider`接口支持新增第三方登录提供商
+  - `StorageProvider`接口支持新增存储后端（本地、云端、NAS）
+  - `ThirdPartyAuthProvider`接口为OAuth2.0扩展预留
+
 - **插件架构**：
   - 为未来功能预留扩展点
   - 可替换的服务实现
@@ -234,12 +290,14 @@
   - 适配器用于不同数据源
   - 策略模式用于可切换行为
   - 观察者用于事件通知
+  - 委托模式用于`AuthManager`
 
 - **未来扩展考虑**：
   - MMS消息支持
   - 联系人备份
   - 本地AI分析
   - 第三方服务连接选项
+  - 鸿蒙原生适配（复用纯Kotlin SDK模块）
 
 ## 从类似应用的见解
 
@@ -270,6 +328,13 @@
 
 ## 优先级列表
 
+### ✅ 阶段0（SDK提取 — 已完成）：
+1. ✅ 提取 `sdk/backup` — 纯Kotlin备份/恢复SDK（BackupManager、RestoreManager、BackupSerializer、数据模型、读写接口）
+2. ✅ 提取 `sdk/auth` — 纯Kotlin认证组件（AuthProvider接口、LocalAuthProvider、ThirdPartyAuthProvider、AuthManager）
+3. ✅ 提取 `sdk/storage` — Android Library存储组件（StorageProvider接口、LocalStorageProvider、RemoteStorageProvider、Room）
+4. ✅ App模块适配 — Android平台实现注入SDK接口
+5. ✅ 架构设计文档 — 鸿蒙适配、第三方登录、AI Agent、后端微服务
+
 ### 阶段1（核心功能）：
 1. SMS和通话记录读取
 2. 本地JSON备份
@@ -289,4 +354,4 @@
 2. 数据分析和统计
 3. 跨设备同步
 4. 高级设置和自定义
-5. 更多数据类型支持 
\ No newline at end of file
+5. 更多数据类型支持
diff --git a/android/gradle.properties b/android/gradle.properties
index 3db528f..41105ff 100644
--- a/android/gradle.properties
+++ b/android/gradle.properties
@@ -1,63 +1,39 @@
-# ??Java???????
 org.gradle.java.installations.auto-detect=true
 org.gradle.java.installations.auto-download=true
 
-# ??compileSdk 34
-android.suppressUnsupportedCompileSdk=34
+android.suppressUnsupportedCompileSdk=35
 
-# ??AndroidX
 android.useAndroidX=true
 android.enableJetifier=true
 
-# ??Gradle???? - ???MaxPermSize??
 org.gradle.jvmargs=-Xmx4g -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
 
-# ??Gradle??
 org.gradle.caching=true
 
-# ??????
 org.gradle.parallel=true
 
-# ??????
 org.gradle.configureondemand=true
 
-# ??Kotlin??????
-kotlin.daemon.jvmargs=-Xmx3072m
+kotlin.daemon.jvmargs=-Xmx3072m -Dkotlin.daemon.data.dir=/Volumes/FanXiangMac/DevTools/Gradle/kotlin-daemon
 
-# ?? Kapt ??
 kapt.incremental.apt=true
 kapt.use.worker.api=true
 
-# KAPT?????????
 kapt.include.compile.classpath=false
 
-# ??SDK??
 android.sdk.channel=3
 
-# Kotlin?Java?????????
 kotlin.jvm.target.validation.mode=warning
 
-# ??buildConfig??
-android.defaults.buildfeatures.buildconfig=true
-
-# ?????????
 kotlin.incremental=true
 kotlin.code.style=official
 kotlin.incremental.java=true
 kotlin.incremental.js=true
 
-# ??ID???
 android.nonTransitiveRClass=true
 android.nonFinalResIds=true
 
-# ??Compose?????
 android.enableComposeCompilerMetrics=true
 android.enableComposeCompilerReports=true
 
-# ??????
 org.gradle.daemon=true
-
-# 设置使用标准OpenJDK 17而不是GraalVM
-# org.gradle.java.home=
-
-
diff --git a/android/gradle/gradle-daemon-jvm.properties b/android/gradle/gradle-daemon-jvm.properties
new file mode 100644
index 0000000..6c1139e
--- /dev/null
+++ b/android/gradle/gradle-daemon-jvm.properties
@@ -0,0 +1,12 @@
+#This file is generated by updateDaemonJvm
+toolchainUrl.FREE_BSD.AARCH64=https\://api.foojay.io/disco/v3.0/ids/ec7520a1e057cd116f9544c42142a16b/redirect
+toolchainUrl.FREE_BSD.X86_64=https\://api.foojay.io/disco/v3.0/ids/4c4f879899012ff0a8b2e2117df03b0e/redirect
+toolchainUrl.LINUX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/ec7520a1e057cd116f9544c42142a16b/redirect
+toolchainUrl.LINUX.X86_64=https\://api.foojay.io/disco/v3.0/ids/4c4f879899012ff0a8b2e2117df03b0e/redirect
+toolchainUrl.MAC_OS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/73bcfb608d1fde9fb62e462f834a3299/redirect
+toolchainUrl.MAC_OS.X86_64=https\://api.foojay.io/disco/v3.0/ids/846ee0d876d26a26f37aa1ce8de73224/redirect
+toolchainUrl.UNIX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/ec7520a1e057cd116f9544c42142a16b/redirect
+toolchainUrl.UNIX.X86_64=https\://api.foojay.io/disco/v3.0/ids/4c4f879899012ff0a8b2e2117df03b0e/redirect
+toolchainUrl.WINDOWS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/9482ddec596298c84656d31d16652665/redirect
+toolchainUrl.WINDOWS.X86_64=https\://api.foojay.io/disco/v3.0/ids/39701d92e1756bb2f141eb67cd4c660e/redirect
+toolchainVersion=21
diff --git a/android/gradle/wrapper/gradle-wrapper.properties b/android/gradle/wrapper/gradle-wrapper.properties
index da1db5f..2f2958b 100644
--- a/android/gradle/wrapper/gradle-wrapper.properties
+++ b/android/gradle/wrapper/gradle-wrapper.properties
@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
diff --git a/android/sdk/.gitignore b/android/sdk/.gitignore
new file mode 100644
index 0000000..567609b
--- /dev/null
+++ b/android/sdk/.gitignore
@@ -0,0 +1 @@
+build/
diff --git a/android/sdk/auth/build.gradle b/android/sdk/auth/build.gradle
new file mode 100644
index 0000000..2996540
--- /dev/null
+++ b/android/sdk/auth/build.gradle
@@ -0,0 +1,22 @@
+plugins {
+    id 'java-library'
+    id 'org.jetbrains.kotlin.jvm'
+}
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_17
+    targetCompatibility = JavaVersion.VERSION_17
+}
+
+tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+}
+
+dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version"
+
+    testImplementation 'junit:junit:4.13.2'
+}
diff --git a/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/AuthManager.kt b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/AuthManager.kt
new file mode 100644
index 0000000..24f8846
--- /dev/null
+++ b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/AuthManager.kt
@@ -0,0 +1,16 @@
+package com.iskenkenya.commory.sdk.auth
+
+class AuthManager private constructor(
+    private val provider: AuthProvider
+) : AuthProvider by provider {
+
+    companion object {
+        fun createLocal(deviceId: String): AuthManager {
+            return AuthManager(LocalAuthProvider(deviceId))
+        }
+
+        fun createWithProvider(provider: AuthProvider): AuthManager {
+            return AuthManager(provider)
+        }
+    }
+}
diff --git a/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/AuthProvider.kt b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/AuthProvider.kt
new file mode 100644
index 0000000..9ea50c2
--- /dev/null
+++ b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/AuthProvider.kt
@@ -0,0 +1,32 @@
+package com.iskenkenya.commory.sdk.auth
+
+import kotlinx.coroutines.flow.StateFlow
+
+interface AuthProvider {
+    val isAuthenticated: StateFlow<Boolean>
+    val currentUser: StateFlow<UserInfo?>
+
+    suspend fun login(credentials: AuthCredentials): AuthResult
+    suspend fun logout()
+    suspend fun refreshToken(): AuthResult
+    fun getToken(): String?
+}
+
+data class UserInfo(
+    val userId: String,
+    val displayName: String,
+    val email: String? = null,
+    val avatarUrl: String? = null
+)
+
+sealed class AuthResult {
+    data class Success(val token: String, val user: UserInfo) : AuthResult()
+    data class Error(val code: String, val message: String) : AuthResult()
+    data object Cancelled : AuthResult()
+}
+
+sealed class AuthCredentials {
+    data class Local(val deviceId: String) : AuthCredentials()
+    data class OAuth2(val provider: String, val accessToken: String) : AuthCredentials()
+    data class Password(val username: String, val password: String) : AuthCredentials()
+}
diff --git a/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/LocalAuthProvider.kt b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/LocalAuthProvider.kt
new file mode 100644
index 0000000..143f25d
--- /dev/null
+++ b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/LocalAuthProvider.kt
@@ -0,0 +1,43 @@
+package com.iskenkenya.commory.sdk.auth
+
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+
+class LocalAuthProvider(private val deviceId: String) : AuthProvider {
+
+    private val _isAuthenticated = MutableStateFlow(true)
+    override val isAuthenticated: StateFlow<Boolean> = _isAuthenticated.asStateFlow()
+
+    private val localUser = UserInfo(
+        userId = "local_$deviceId",
+        displayName = "Local User"
+    )
+
+    private val _currentUser = MutableStateFlow<UserInfo?>(localUser)
+    override val currentUser: StateFlow<UserInfo?> = _currentUser.asStateFlow()
+
+    private var token: String = "local_token_$deviceId"
+
+    override suspend fun login(credentials: AuthCredentials): AuthResult {
+        return when (credentials) {
+            is AuthCredentials.Local -> {
+                _isAuthenticated.value = true
+                _currentUser.value = localUser
+                AuthResult.Success(token, localUser)
+            }
+            else -> AuthResult.Error("UNSUPPORTED", "LocalAuthProvider only supports local credentials")
+        }
+    }
+
+    override suspend fun logout() {
+        _isAuthenticated.value = true
+        _currentUser.value = localUser
+    }
+
+    override suspend fun refreshToken(): AuthResult {
+        return AuthResult.Success(token, localUser)
+    }
+
+    override fun getToken(): String = token
+}
diff --git a/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/ThirdPartyAuthProvider.kt b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/ThirdPartyAuthProvider.kt
new file mode 100644
index 0000000..52b3b56
--- /dev/null
+++ b/android/sdk/auth/src/main/kotlin/com/iskenkenya/commory/sdk/auth/ThirdPartyAuthProvider.kt
@@ -0,0 +1,10 @@
+package com.iskenkenya.commory.sdk.auth
+
+interface ThirdPartyAuthProvider : AuthProvider {
+    val providerId: String
+    val providerName: String
+
+    suspend fun initialize(config: Map<String, String>): Boolean
+    suspend fun handleCallback(callbackData: Map<String, String>): AuthResult
+    fun getAuthUrl(): String
+}
diff --git a/android/sdk/backup/build.gradle b/android/sdk/backup/build.gradle
new file mode 100644
index 0000000..1e85fcc
--- /dev/null
+++ b/android/sdk/backup/build.gradle
@@ -0,0 +1,25 @@
+plugins {
+    id 'java-library'
+    id 'org.jetbrains.kotlin.jvm'
+}
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_17
+    targetCompatibility = JavaVersion.VERSION_17
+}
+
+tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+}
+
+dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version"
+    implementation "com.google.code.gson:gson:$gson_version"
+
+    testImplementation 'junit:junit:4.13.2'
+    testImplementation 'org.mockito:mockito-core:5.8.0'
+    testImplementation "org.jetbrains.kotlinx:kotlinx-coroutines-test:$coroutines_version"
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/BackupManager.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/BackupManager.kt
new file mode 100644
index 0000000..a285b6a
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/BackupManager.kt
@@ -0,0 +1,169 @@
+package com.iskenkenya.commory.sdk.backup
+
+import com.iskenkenya.commory.sdk.backup.model.BackupData
+import com.iskenkenya.commory.sdk.backup.model.BackupResult
+import com.iskenkenya.commory.sdk.backup.model.CallLog
+import com.iskenkenya.commory.sdk.backup.model.Contact
+import com.iskenkenya.commory.sdk.backup.model.Message
+import com.iskenkenya.commory.sdk.backup.model.BackupWriteStats
+import com.iskenkenya.commory.sdk.backup.msglayer.MsgLayerMapper
+import com.iskenkenya.commory.sdk.backup.reader.BackupFileReader
+import com.iskenkenya.commory.sdk.backup.reader.CallLogReader
+import com.iskenkenya.commory.sdk.backup.reader.ContactReader
+import com.iskenkenya.commory.sdk.backup.reader.SmsReader
+import com.iskenkenya.commory.sdk.backup.serializer.BackupSerializer
+import com.iskenkenya.commory.sdk.backup.writer.BackupFileWriter
+import com.iskenkenya.commory.sdk.backup.writer.CallLogWriter
+import com.iskenkenya.commory.sdk.backup.writer.ContactWriter
+import com.iskenkenya.commory.sdk.backup.writer.SmsWriter
+
+class BackupManager(
+    private val smsReader: SmsReader,
+    private val callLogReader: CallLogReader,
+    private val contactReader: ContactReader,
+    private val backupFileWriter: BackupFileWriter,
+    private val backupFileReader: BackupFileReader,
+    private val smsWriter: SmsWriter,
+    private val callLogWriter: CallLogWriter,
+    private val contactWriter: ContactWriter,
+    private val serializer: BackupSerializer = BackupSerializer(),
+    private val msgLayerMapper: MsgLayerMapper = MsgLayerMapper()
+) {
+
+    suspend fun performBackup(
+        hasSmsPermission: Boolean,
+        hasCallLogPermission: Boolean,
+        hasContactsPermission: Boolean,
+        deviceInfo: String = "",
+        deviceId: String = "",
+        appVersion: String = ""
+    ): BackupResult {
+        if (!hasSmsPermission && !hasCallLogPermission && !hasContactsPermission) {
+            return BackupResult(
+                success = false,
+                timestamp = System.currentTimeMillis(),
+                appVersion = "",
+                deviceId = "",
+                errorMessage = "备份失败: 没有任何所需权限"
+            )
+        }
+
+        val messages = if (hasSmsPermission) smsReader.readSms() else null
+        val messagesCount = messages?.size ?: 0
+
+        val callLogs = if (hasCallLogPermission) callLogReader.readCallLogs() else null
+        val callLogsCount = callLogs?.size ?: 0
+
+        val contacts = if (hasContactsPermission) contactReader.readContacts() else null
+        val contactsCount = contacts?.size ?: 0
+
+        if (messagesCount == 0 && callLogsCount == 0 && contactsCount == 0) {
+            return BackupResult(
+                success = false,
+                timestamp = System.currentTimeMillis(),
+                appVersion = "",
+                deviceId = "",
+                smsCount = 0,
+                callLogCount = 0,
+                errorMessage = "没有找到任何数据可以备份"
+            )
+        }
+
+        val export = msgLayerMapper.toRootExport(
+            messages = messages.orEmpty(),
+            callLogs = callLogs.orEmpty(),
+            contacts = contacts.orEmpty(),
+            deviceInfo = deviceInfo,
+            deviceId = deviceId.ifBlank { "unknown-device" },
+            appVersion = appVersion.ifBlank { "unknown" }
+        )
+
+        return backupFileWriter.writeBackup(
+            export = export,
+            stats = BackupWriteStats(
+                smsCount = messagesCount,
+                callLogCount = callLogsCount,
+                contactCount = contactsCount
+            )
+        )
+    }
+
+    suspend fun restoreFromFile(filePath: String): BackupData? {
+        val backupReadData = backupFileReader.read(filePath) ?: return null
+        return BackupData(
+            messages = backupReadData.messages.map { message ->
+                Message(
+                    id = message.id,
+                    address = message.address,
+                    body = message.body,
+                    date = message.date,
+                    type = message.type,
+                    readState = message.readState,
+                    messageStatus = message.messageStatus,
+                    threadId = message.threadId
+                )
+            },
+            callLogs = backupReadData.callLogs.map { callLog ->
+                CallLog(
+                    id = callLog.id,
+                    number = callLog.number,
+                    type = callLog.type,
+                    date = callLog.date,
+                    duration = callLog.duration,
+                    contact = callLog.contact
+                )
+            },
+            contacts = backupReadData.contacts.map { contact ->
+                Contact(
+                    id = contact.id,
+                    name = contact.name,
+                    phoneNumbers = contact.phoneNumbers.toMutableList(),
+                    emails = contact.emails
+                )
+            },
+            timestamp = backupReadData.timestamp,
+            deviceInfo = backupReadData.deviceInfo
+        )
+    }
+
+    suspend fun restoreSms(messages: List<com.iskenkenya.commory.sdk.backup.model.Message>): Int {
+        return smsWriter.write(messages.map { message ->
+            com.iskenkenya.commory.sdk.backup.model.SmsData(
+                id = message.id,
+                address = message.address,
+                body = message.body,
+                date = message.date,
+                type = message.type,
+                readState = message.readState,
+                messageStatus = message.messageStatus,
+                threadId = message.threadId
+            )
+        })
+    }
+
+    suspend fun restoreCallLogs(callLogs: List<com.iskenkenya.commory.sdk.backup.model.CallLog>): Int {
+        return callLogWriter.write(callLogs.map { callLog ->
+            com.iskenkenya.commory.sdk.backup.model.CallLogData(
+                id = callLog.id,
+                number = callLog.number,
+                type = callLog.type,
+                date = callLog.date,
+                duration = callLog.duration,
+                contact = callLog.contact
+            )
+        })
+    }
+
+    suspend fun restoreContacts(contacts: List<com.iskenkenya.commory.sdk.backup.model.Contact>): Int {
+        return contactWriter.write(contacts.map { contact ->
+            com.iskenkenya.commory.sdk.backup.model.ContactData(
+                id = contact.id,
+                name = contact.name,
+                phoneNumbers = contact.phoneNumbers,
+                emails = contact.emails
+            )
+        })
+    }
+
+    fun getSerializer(): BackupSerializer = serializer
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/RestoreManager.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/RestoreManager.kt
new file mode 100644
index 0000000..8455e1e
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/RestoreManager.kt
@@ -0,0 +1,67 @@
+package com.iskenkenya.commory.sdk.backup
+
+import com.iskenkenya.commory.sdk.backup.model.RestoreOptions
+import com.iskenkenya.commory.sdk.backup.model.RestoreResult
+import com.iskenkenya.commory.sdk.backup.reader.BackupFileReader
+import com.iskenkenya.commory.sdk.backup.writer.CallLogWriter
+import com.iskenkenya.commory.sdk.backup.writer.ContactWriter
+import com.iskenkenya.commory.sdk.backup.writer.SmsWriter
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+class RestoreManager(
+    private val backupFileReader: BackupFileReader,
+    private val smsWriter: SmsWriter,
+    private val callLogWriter: CallLogWriter,
+    private val contactWriter: ContactWriter
+) {
+    suspend fun restore(filePath: String, options: RestoreOptions): RestoreResult =
+        withContext(Dispatchers.IO) {
+            val backupData = backupFileReader.read(filePath)
+                ?: return@withContext RestoreResult(
+                    success = false,
+                    message = "Unable to parse backup file"
+                )
+
+            var restoredSmsCount = 0
+            var restoredCallLogsCount = 0
+            var restoredContactsCount = 0
+
+            if (options.sms && backupData.messages.isNotEmpty()) {
+                try {
+                    restoredSmsCount = smsWriter.write(backupData.messages)
+                } catch (_: Exception) {
+                }
+            }
+
+            if (options.callLogs && backupData.callLogs.isNotEmpty()) {
+                try {
+                    restoredCallLogsCount = callLogWriter.write(backupData.callLogs)
+                } catch (_: Exception) {
+                }
+            }
+
+            if (options.contacts && backupData.contacts.isNotEmpty()) {
+                try {
+                    restoredContactsCount = contactWriter.write(backupData.contacts)
+                } catch (_: Exception) {
+                }
+            }
+
+            val totalSuccess =
+                restoredSmsCount > 0 || restoredCallLogsCount > 0 || restoredContactsCount > 0
+            val resultMessage = if (totalSuccess) {
+                "Restored $restoredSmsCount SMS, $restoredCallLogsCount call logs, $restoredContactsCount contacts"
+            } else {
+                "Restore failed: no data was restored"
+            }
+
+            RestoreResult(
+                success = totalSuccess,
+                message = resultMessage,
+                restoredSmsCount = restoredSmsCount,
+                restoredCallLogsCount = restoredCallLogsCount,
+                restoredContactsCount = restoredContactsCount
+            )
+        }
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/model/BackupData.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupData.kt
similarity index 80%
rename from android/app/src/main/java/imken/messagevault/mobile/model/BackupData.kt
rename to android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupData.kt
index b787302..17c6709 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/model/BackupData.kt
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupData.kt
@@ -1,29 +1,25 @@
-package imken.messagevault.mobile.model
+package com.iskenkenya.commory.sdk.backup.model
 
 import com.google.gson.annotations.Expose
 import com.google.gson.annotations.SerializedName
-import imken.messagevault.mobile.model.Contact
 
-/**
- * 备份数据模型
- */
 data class BackupData(
     @Expose
     @SerializedName("messages")
     val messages: List<Message>? = emptyList(),
-    
+
     @Expose
     @SerializedName("call_logs")
     val callLogs: List<CallLog>? = emptyList(),
-    
+
     @Expose
     @SerializedName("contacts")
     val contacts: List<Contact>? = emptyList(),
-    
+
     @Expose
     @SerializedName("timestamp")
     val timestamp: Long = System.currentTimeMillis(),
-    
+
     @Expose
     @SerializedName("device_info")
     val deviceInfo: String = ""
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupReadData.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupReadData.kt
new file mode 100644
index 0000000..1efbc5c
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupReadData.kt
@@ -0,0 +1,9 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+data class BackupReadData(
+    val messages: List<SmsData> = emptyList(),
+    val callLogs: List<CallLogData> = emptyList(),
+    val contacts: List<ContactData> = emptyList(),
+    val timestamp: Long = System.currentTimeMillis(),
+    val deviceInfo: String = ""
+)
diff --git a/android/app/src/main/java/imken/messagevault/mobile/model/BackupResult.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupResult.kt
similarity index 78%
rename from android/app/src/main/java/imken/messagevault/mobile/model/BackupResult.kt
rename to android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupResult.kt
index c81133f..3ef5abc 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/model/BackupResult.kt
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupResult.kt
@@ -1,8 +1,5 @@
-package imken.messagevault.mobile.model
+package com.iskenkenya.commory.sdk.backup.model
 
-/**
- * 表示备份操作的结果
- */
 data class BackupResult(
     val success: Boolean,
     val timestamp: Long,
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupWriteStats.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupWriteStats.kt
new file mode 100644
index 0000000..85b1eb8
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/BackupWriteStats.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+data class BackupWriteStats(
+    val smsCount: Int = 0,
+    val callLogCount: Int = 0,
+    val contactCount: Int = 0
+)
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/CallLog.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/CallLog.kt
new file mode 100644
index 0000000..d04a85e
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/CallLog.kt
@@ -0,0 +1,30 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+import com.google.gson.annotations.Expose
+import com.google.gson.annotations.SerializedName
+
+data class CallLog(
+    @Expose
+    @SerializedName("id")
+    val id: Long,
+
+    @Expose
+    @SerializedName("num")
+    val number: String,
+
+    @Expose
+    @SerializedName("type")
+    val type: Int,
+
+    @Expose
+    @SerializedName("date")
+    val date: Long,
+
+    @Expose
+    @SerializedName("dur")
+    val duration: Int,
+
+    @Expose
+    @SerializedName("name")
+    val contact: String? = null
+)
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/CallLogData.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/CallLogData.kt
new file mode 100644
index 0000000..a1181d7
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/CallLogData.kt
@@ -0,0 +1,10 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+data class CallLogData(
+    val id: Long,
+    val number: String,
+    val type: Int,
+    val date: Long,
+    val duration: Int,
+    val contact: String? = null
+)
diff --git a/android/app/src/main/java/imken/messagevault/mobile/model/Contact.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/Contact.kt
similarity index 51%
rename from android/app/src/main/java/imken/messagevault/mobile/model/Contact.kt
rename to android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/Contact.kt
index 2c6af3e..212e213 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/model/Contact.kt
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/Contact.kt
@@ -1,170 +1,92 @@
-package imken.messagevault.mobile.model
+package com.iskenkenya.commory.sdk.backup.model
 
 import com.google.gson.annotations.Expose
 import com.google.gson.annotations.SerializedName
 
-/**
- * 联系人数据模型
- *
- * 表示一个联系人，包含ID、姓名、电话号码列表和电子邮件列表
- */
 data class Contact(
-    /**
-     * 联系人ID
-     */
     @Expose
     @SerializedName("id")
     val id: Long,
-    
-    /**
-     * 联系人姓名
-     */
+
     @Expose
     @SerializedName("name")
     val name: String,
-    
-    /**
-     * 联系人电话号码列表
-     */
+
     @Expose
     @SerializedName("phones")
     val phoneNumbers: MutableList<String>,
 
-    /**
-     * 联系人电子邮件列表
-     */
     @Expose
     @SerializedName("emails")
     val emails: List<String>? = null,
-    
-    /**
-     * 联系人地址信息
-     */
+
     @Expose
     @SerializedName("addresses")
     val addresses: List<Address>? = null,
-    
-    /**
-     * 联系人头像数据（Base64编码）
-     * 不使用@Expose注解，这样不会序列化到JSON中，减小文件大小
-     */
+
     val photoData: String? = null,
-    
-    /**
-     * 联系人备注
-     */
+
     @Expose
     @SerializedName("note")
     val note: String? = null,
-    
-    /**
-     * 联系人所属组
-     */
+
     @Expose
     @SerializedName("groups")
     val groups: List<String>? = null,
-    
-    /**
-     * 联系人网站
-     */
+
     @Expose
     @SerializedName("websites")
     val websites: List<String>? = null,
-    
-    /**
-     * 联系人事件（如生日、纪念日）
-     */
+
     @Expose
     @SerializedName("events")
     val events: List<Event>? = null,
-    
-    /**
-     * 联系人关系（如配偶、子女）
-     */
+
     @Expose
     @SerializedName("relationships")
     val relationships: List<Relationship>? = null,
-    
-    /**
-     * 联系人社交资料
-     */
+
     @Expose
     @SerializedName("social_profiles")
     val socialProfiles: List<SocialProfile>? = null
 ) {
-    /**
-     * 联系人地址数据类
-     */
     data class Address(
-        /**
-         * 地址类型（家庭、工作等）
-         */
         @Expose
         @SerializedName("type")
         val type: String,
-        
-        /**
-         * 地址内容
-         */
+
         @Expose
         @SerializedName("value")
         val value: String
     )
-    
-    /**
-     * 联系人事件数据类
-     */
+
     data class Event(
-        /**
-         * 事件类型（生日、纪念日等）
-         */
         @Expose
         @SerializedName("type")
         val type: String,
-        
-        /**
-         * 事件日期
-         */
+
         @Expose
         @SerializedName("date")
         val date: String
     )
-    
-    /**
-     * 联系人关系数据类
-     */
+
     data class Relationship(
-        /**
-         * 关系类型（配偶、子女等）
-         */
         @Expose
         @SerializedName("type")
         val type: String,
-        
-        /**
-         * 关系人名称
-         */
+
         @Expose
         @SerializedName("name")
         val name: String
     )
-    
-    /**
-     * 联系人社交资料数据类
-     */
+
     data class SocialProfile(
-        /**
-         * 社交媒体类型（如Facebook、Twitter等）
-         */
         @Expose
         @SerializedName("type")
         val type: String,
-        
-        /**
-         * 社交媒体账号或链接
-         */
+
         @Expose
         @SerializedName("value")
         val value: String
     )
-} 
\ No newline at end of file
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/ContactData.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/ContactData.kt
new file mode 100644
index 0000000..8fdaf74
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/ContactData.kt
@@ -0,0 +1,8 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+data class ContactData(
+    val id: Long,
+    val name: String,
+    val phoneNumbers: List<String>,
+    val emails: List<String>? = null
+)
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/Message.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/Message.kt
new file mode 100644
index 0000000..64f3bcd
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/Message.kt
@@ -0,0 +1,35 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+import com.google.gson.annotations.Expose
+import com.google.gson.annotations.SerializedName
+
+data class Message(
+    @Expose
+    @SerializedName("id")
+    val id: Long = 0,
+
+    @Expose
+    @SerializedName("addr")
+    val address: String,
+
+    @Expose
+    @SerializedName("body")
+    val body: String? = "",
+
+    @Expose
+    @SerializedName("date")
+    val date: Long,
+
+    @Expose
+    @SerializedName("type")
+    val type: Int,
+
+    @SerializedName("read")
+    val readState: Int? = 0,
+
+    @SerializedName("status")
+    val messageStatus: Int? = 0,
+
+    @SerializedName("thread_id")
+    val threadId: Long = 0
+)
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/RestoreOptions.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/RestoreOptions.kt
new file mode 100644
index 0000000..562cf1c
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/RestoreOptions.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+data class RestoreOptions(
+    val sms: Boolean = true,
+    val callLogs: Boolean = true,
+    val contacts: Boolean = true
+)
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/RestoreResult.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/RestoreResult.kt
new file mode 100644
index 0000000..d6a64ff
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/RestoreResult.kt
@@ -0,0 +1,9 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+data class RestoreResult(
+    val success: Boolean,
+    val message: String,
+    val restoredSmsCount: Int = 0,
+    val restoredCallLogsCount: Int = 0,
+    val restoredContactsCount: Int = 0
+)
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/SmsData.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/SmsData.kt
new file mode 100644
index 0000000..7e2bc32
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/SmsData.kt
@@ -0,0 +1,12 @@
+package com.iskenkenya.commory.sdk.backup.model
+
+data class SmsData(
+    val id: Long = 0,
+    val address: String,
+    val body: String? = "",
+    val date: Long,
+    val type: Int,
+    val readState: Int? = 0,
+    val messageStatus: Int? = 0,
+    val threadId: Long = 0
+)
diff --git a/android/app/src/main/java/imken/messagevault/mobile/model/UploadResult.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/UploadResult.kt
similarity index 59%
rename from android/app/src/main/java/imken/messagevault/mobile/model/UploadResult.kt
rename to android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/UploadResult.kt
index 9d8e554..337ada7 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/model/UploadResult.kt
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/model/UploadResult.kt
@@ -1,8 +1,5 @@
-package imken.messagevault.mobile.model
+package com.iskenkenya.commory.sdk.backup.model
 
-/**
- * 表示文件上传操作的结果
- */
 data class UploadResult(
     val success: Boolean,
     val fileId: String? = null,
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/MsgLayerMapper.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/MsgLayerMapper.kt
new file mode 100644
index 0000000..76977db
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/MsgLayerMapper.kt
@@ -0,0 +1,221 @@
+package com.iskenkenya.commory.sdk.backup.msglayer
+
+import com.iskenkenya.commory.sdk.backup.model.CallLog
+import com.iskenkenya.commory.sdk.backup.model.Contact
+import com.iskenkenya.commory.sdk.backup.model.Message
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerEvent
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerIdentity
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerRelation
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerRootExport
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerSource
+import java.security.MessageDigest
+import java.time.Instant
+import java.time.ZoneOffset
+import java.time.format.DateTimeFormatter
+import kotlin.math.absoluteValue
+
+class MsgLayerMapper {
+
+    fun toRootExport(
+        messages: List<Message>,
+        callLogs: List<CallLog>,
+        contacts: List<Contact>,
+        deviceInfo: String,
+        deviceId: String,
+        appVersion: String,
+        exportedAtMillis: Long = System.currentTimeMillis()
+    ): MsgLayerRootExport {
+        val exportedAt = exportedAtMillis.toRfc3339()
+        val selfIdentity = MsgLayerIdentity(
+            id = selfIdentityId(deviceId),
+            type = "device",
+            displayName = deviceInfo.ifBlank { deviceId },
+            phones = emptyList(),
+            emails = emptyList(),
+            avatar = null,
+            labels = listOf("self"),
+            meta = mapOf("source" to "system")
+        )
+
+        val identitiesById = linkedMapOf(selfIdentity.id to selfIdentity)
+        contacts.forEach { contact ->
+            val identity = contact.toIdentity()
+            identitiesById[identity.id] = identity
+        }
+
+        val events = mutableListOf<MsgLayerEvent>()
+        identitiesById.values
+            .filter { it.id != selfIdentity.id && it.type == "person" }
+            .forEach { identity ->
+                events += MsgLayerEvent(
+                    id = "contact_snapshot_${identity.id}",
+                    type = "contact_snapshot",
+                    timestamp = exportedAt,
+                    direction = "system",
+                    participants = listOf(identity.id),
+                    content = mapOf(
+                        "identity_id" to identity.id,
+                        "snapshot" to identity
+                    ),
+                    meta = mapOf("source" to "contacts"),
+                    relations = listOf(MsgLayerRelation("references_identity", identity.id))
+                )
+            }
+
+        messages.forEach { message ->
+            val participantId = resolveParticipantIdentity(message.address, identitiesById)
+            events += MsgLayerEvent(
+                id = "sms_${message.id}",
+                type = "sms",
+                timestamp = message.date.toRfc3339(),
+                direction = message.toSmsDirection(),
+                participants = listOf(selfIdentity.id, participantId).distinct(),
+                content = mapOf(
+                    "text" to (message.body ?: ""),
+                    "attachments" to emptyList<String>()
+                ),
+                meta = mapOf(
+                    "read" to (message.readState == 1),
+                    "status" to (message.messageStatus ?: 0),
+                    "raw_type" to message.type
+                ),
+                relations = listOf(
+                    MsgLayerRelation("same_thread", "thread_${message.threadId}"),
+                    MsgLayerRelation("references_identity", participantId)
+                )
+            )
+        }
+
+        callLogs.forEach { callLog ->
+            val participantId = resolveParticipantIdentity(callLog.number, identitiesById, callLog.contact)
+            events += MsgLayerEvent(
+                id = "call_${callLog.id}",
+                type = "call",
+                timestamp = callLog.date.toRfc3339(),
+                direction = callLog.toCallDirection(),
+                participants = listOf(selfIdentity.id, participantId).distinct(),
+                content = mapOf(
+                    "duration_sec" to callLog.duration,
+                    "call_type" to callLog.toCallType(),
+                    "recording" to null
+                ),
+                meta = mapOf(
+                    "contact_name" to callLog.contact,
+                    "raw_type" to callLog.type
+                ),
+                relations = listOf(MsgLayerRelation("references_identity", participantId))
+            )
+        }
+
+        // String sorting is safe here because all timestamps are normalized to UTC RFC3339.
+        return MsgLayerRootExport(
+            exportedAt = exportedAt,
+            source = MsgLayerSource(
+                platform = "android",
+                deviceId = deviceId,
+                appVersion = appVersion
+            ),
+            identities = identitiesById.values.toList(),
+            events = events.sortedByDescending { it.timestamp },
+            indexes = mapOf(
+                "timeline" to events.map { it.id }
+            )
+        )
+    }
+
+    private fun Contact.toIdentity(): MsgLayerIdentity {
+        val normalizedPhones = phoneNumbers.map { normalizePhone(it) }.filter { it.isNotBlank() }
+        val normalizedEmails = emails.orEmpty().map { it.trim() }.filter { it.isNotBlank() }
+        val stableKey = buildString {
+            append(id)
+            append("|")
+            append(name)
+            append("|")
+            append(normalizedPhones.joinToString(","))
+        }
+        return MsgLayerIdentity(
+            id = "person_${stableHash(stableKey)}",
+            type = "person",
+            displayName = name,
+            phones = normalizedPhones,
+            emails = normalizedEmails,
+            avatar = photoData,
+            labels = listOf("contact"),
+            meta = mapOf(
+                "source" to "contacts",
+                "legacy_contact_id" to id,
+                "groups" to groups.orEmpty(),
+                "websites" to websites.orEmpty(),
+                "note" to note
+            )
+        )
+    }
+
+    private fun resolveParticipantIdentity(
+        rawPhone: String,
+        identitiesById: MutableMap<String, MsgLayerIdentity>,
+        fallbackName: String? = null
+    ): String {
+        val normalized = normalizePhone(rawPhone)
+        identitiesById.values.firstOrNull { identity ->
+            identity.type == "person" && identity.phones.any { it == normalized }
+        }?.let { return it.id }
+
+        val displayName = fallbackName?.takeIf { it.isNotBlank() } ?: rawPhone.ifBlank { "Unknown" }
+        val generated = MsgLayerIdentity(
+            id = "person_${stableHash("$displayName|$normalized")}",
+            type = "person",
+            displayName = displayName,
+            phones = listOf(normalized).filter { it.isNotBlank() },
+            emails = emptyList(),
+            avatar = null,
+            labels = listOf("derived"),
+            meta = mapOf("source" to "derived")
+        )
+        identitiesById.putIfAbsent(generated.id, generated)
+        return generated.id
+    }
+
+    private fun Message.toSmsDirection(): String = when (type) {
+        1 -> "inbound"
+        2, 4, 5, 6 -> "outbound"
+        3 -> "outbound"
+        else -> "inbound"
+    }
+
+    private fun CallLog.toCallDirection(): String = when (type) {
+        2 -> "outbound"
+        3 -> "inbound"
+        5 -> "missed"
+        else -> "missed"
+    }
+
+    private fun CallLog.toCallType(): String = when (type) {
+        1 -> "missed"
+        2 -> "outgoing"
+        3 -> "incoming"
+        4 -> "voicemail"
+        5 -> "rejected"
+        else -> "unknown"
+    }
+
+    private fun selfIdentityId(deviceId: String): String = "self/$deviceId"
+
+    private fun normalizePhone(raw: String?): String {
+        if (raw.isNullOrBlank()) return ""
+        val cleaned = raw.filter { it.isDigit() || it == '+' }
+        return cleaned.ifBlank { raw.trim() }
+    }
+
+    private fun stableHash(input: String): String {
+        val digest = MessageDigest.getInstance("SHA-256")
+            .digest(input.toByteArray(Charsets.UTF_8))
+        return digest.take(8).joinToString("") { "%02x".format(it) }
+    }
+
+    private fun Long.toRfc3339(): String {
+        return Instant.ofEpochMilli(this)
+            .atOffset(ZoneOffset.UTC)
+            .format(DateTimeFormatter.ISO_OFFSET_DATE_TIME)
+    }
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/MsgLayerSerializer.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/MsgLayerSerializer.kt
new file mode 100644
index 0000000..e73ca9b
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/MsgLayerSerializer.kt
@@ -0,0 +1,19 @@
+package com.iskenkenya.commory.sdk.backup.msglayer
+
+import com.google.gson.FieldNamingPolicy
+import com.google.gson.GsonBuilder
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerRootExport
+
+class MsgLayerSerializer {
+
+    private val gson = GsonBuilder()
+        .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
+        .serializeNulls()
+        .disableHtmlEscaping()
+        .setPrettyPrinting()
+        .create()
+
+    fun toJson(export: MsgLayerRootExport): String = gson.toJson(export)
+
+    fun gson() = gson
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/model/MsgLayerModels.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/model/MsgLayerModels.kt
new file mode 100644
index 0000000..891b99b
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/msglayer/model/MsgLayerModels.kt
@@ -0,0 +1,45 @@
+package com.iskenkenya.commory.sdk.backup.msglayer.model
+
+const val MSG_LAYER_VERSION = "msglayer/v0.1"
+
+data class MsgLayerRootExport(
+    val version: String = MSG_LAYER_VERSION,
+    val exportedAt: String,
+    val source: MsgLayerSource,
+    val identities: List<MsgLayerIdentity>,
+    val events: List<MsgLayerEvent>,
+    val indexes: Map<String, Any?>? = null
+)
+
+data class MsgLayerSource(
+    val platform: String,
+    val deviceId: String,
+    val appVersion: String
+)
+
+data class MsgLayerIdentity(
+    val id: String,
+    val type: String,
+    val displayName: String,
+    val phones: List<String>,
+    val emails: List<String>,
+    val avatar: String? = null,
+    val labels: List<String> = emptyList(),
+    val meta: Map<String, Any?> = emptyMap()
+)
+
+data class MsgLayerEvent(
+    val id: String,
+    val type: String,
+    val timestamp: String,
+    val direction: String,
+    val participants: List<String>,
+    val content: Map<String, Any?>,
+    val meta: Map<String, Any?> = emptyMap(),
+    val relations: List<MsgLayerRelation> = emptyList()
+)
+
+data class MsgLayerRelation(
+    val type: String,
+    val target: String
+)
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/BackupFileReader.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/BackupFileReader.kt
new file mode 100644
index 0000000..cbf40e6
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/BackupFileReader.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.reader
+
+import com.iskenkenya.commory.sdk.backup.model.BackupReadData
+
+interface BackupFileReader {
+    suspend fun read(filePath: String): BackupReadData?
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/CallLogReader.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/CallLogReader.kt
new file mode 100644
index 0000000..5503201
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/CallLogReader.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.reader
+
+import com.iskenkenya.commory.sdk.backup.model.CallLog
+
+interface CallLogReader {
+    suspend fun readCallLogs(): List<CallLog>?
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/ContactReader.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/ContactReader.kt
new file mode 100644
index 0000000..9a2b474
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/ContactReader.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.reader
+
+import com.iskenkenya.commory.sdk.backup.model.Contact
+
+interface ContactReader {
+    suspend fun readContacts(): List<Contact>?
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/SmsReader.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/SmsReader.kt
new file mode 100644
index 0000000..cf59480
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/reader/SmsReader.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.reader
+
+import com.iskenkenya.commory.sdk.backup.model.Message
+
+interface SmsReader {
+    suspend fun readSms(): List<Message>?
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/serializer/BackupSerializer.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/serializer/BackupSerializer.kt
new file mode 100644
index 0000000..e76e720
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/serializer/BackupSerializer.kt
@@ -0,0 +1,185 @@
+package com.iskenkenya.commory.sdk.backup.serializer
+
+import com.google.gson.FieldNamingPolicy
+import com.google.gson.GsonBuilder
+import com.google.gson.reflect.TypeToken
+import com.iskenkenya.commory.sdk.backup.model.BackupData
+import com.iskenkenya.commory.sdk.backup.model.CallLog
+import com.iskenkenya.commory.sdk.backup.model.Contact
+import com.iskenkenya.commory.sdk.backup.model.Message
+
+class BackupSerializer {
+
+    private val gson = GsonBuilder()
+        .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
+        .serializeNulls()
+        .disableHtmlEscaping()
+        .setLenient()
+        .setPrettyPrinting()
+        .create()
+
+    fun toJson(backupData: BackupData): String {
+        return gson.toJson(backupData)
+    }
+
+    fun fromJson(json: String): BackupData? {
+        return try {
+            val typeToken = object : TypeToken<BackupData>() {}.type
+            gson.fromJson<BackupData>(json, typeToken)
+        } catch (e: Exception) {
+            null
+        }
+    }
+
+    fun getGson() = gson
+
+    fun cleanMessage(message: Message): Message {
+        return Message(
+            id = message.id,
+            address = message.address.replace(Regex("[^\\p{Print}]"), ""),
+            body = message.body?.replace(Regex("[^\\p{Print}]"), ""),
+            date = message.date,
+            type = message.type,
+            readState = message.readState,
+            messageStatus = message.messageStatus,
+            threadId = message.threadId
+        )
+    }
+
+    fun cleanCallLog(callLog: CallLog): CallLog {
+        return CallLog(
+            id = callLog.id,
+            number = callLog.number.replace(Regex("[^\\p{Print}]"), ""),
+            type = callLog.type,
+            date = callLog.date,
+            duration = callLog.duration,
+            contact = callLog.contact?.replace(Regex("[^\\p{Print}]"), "")
+        )
+    }
+
+    fun cleanContact(contact: Contact): Contact {
+        return Contact(
+            id = contact.id,
+            name = contact.name.replace(Regex("[^\\p{Print}]"), ""),
+            phoneNumbers = contact.phoneNumbers.map { it.replace(Regex("[^\\p{Print}]"), "") }.toMutableList(),
+            emails = contact.emails?.map { it.replace(Regex("[^\\p{Print}]"), "") },
+            addresses = contact.addresses?.map {
+                Contact.Address(
+                    type = it.type.replace(Regex("[^\\p{Print}]"), ""),
+                    value = it.value.replace(Regex("[^\\p{Print}]"), "")
+                )
+            },
+            groups = contact.groups?.map { it.replace(Regex("[^\\p{Print}]"), "") },
+            note = contact.note?.replace(Regex("[^\\p{Print}]"), ""),
+            websites = contact.websites?.map { it.replace(Regex("[^\\p{Print}]"), "") },
+            events = contact.events?.map {
+                Contact.Event(
+                    type = it.type.replace(Regex("[^\\p{Print}]"), ""),
+                    date = it.date.replace(Regex("[^\\p{Print}]"), "")
+                )
+            },
+            relationships = contact.relationships?.map {
+                Contact.Relationship(
+                    type = it.type.replace(Regex("[^\\p{Print}]"), ""),
+                    name = it.name.replace(Regex("[^\\p{Print}]"), "")
+                )
+            },
+            socialProfiles = contact.socialProfiles?.map {
+                Contact.SocialProfile(
+                    type = it.type.replace(Regex("[^\\p{Print}]"), ""),
+                    value = it.value.replace(Regex("[^\\p{Print}]"), "")
+                )
+            }
+        )
+    }
+
+    fun cleanBackupData(backupData: BackupData): BackupData {
+        val cleanedMessages = backupData.messages?.map { cleanMessage(it) }
+        val cleanedCallLogs = backupData.callLogs?.map { cleanCallLog(it) }
+        val cleanedContacts = backupData.contacts?.map { cleanContact(it) }
+
+        return BackupData(
+            messages = cleanedMessages,
+            callLogs = cleanedCallLogs,
+            contacts = cleanedContacts,
+            timestamp = backupData.timestamp,
+            deviceInfo = backupData.deviceInfo
+        )
+    }
+
+    fun serializeWithSizeLimit(backupData: BackupData, maxBytes: Int = 10 * 1024 * 1024): String? {
+        val cleanedData = cleanBackupData(backupData)
+
+        val testJson = toJson(BackupData(
+            messages = emptyList(),
+            callLogs = emptyList(),
+            contacts = emptyList(),
+            timestamp = cleanedData.timestamp,
+            deviceInfo = cleanedData.deviceInfo
+        ))
+        if (testJson.isBlank() || testJson == "{}" || testJson == "null") {
+            return null
+        }
+
+        var finalMessages = cleanedData.messages
+        var finalCallLogs = cleanedData.callLogs
+        var finalContacts = cleanedData.contacts
+
+        if (!cleanedData.messages.isNullOrEmpty()) {
+            try {
+                gson.toJson(cleanedData.messages)
+            } catch (e: Exception) {
+                finalMessages = emptyList()
+            }
+        }
+
+        if (!cleanedData.callLogs.isNullOrEmpty()) {
+            try {
+                gson.toJson(cleanedData.callLogs)
+            } catch (e: Exception) {
+                finalCallLogs = emptyList()
+            }
+        }
+
+        if (!cleanedData.contacts.isNullOrEmpty()) {
+            try {
+                gson.toJson(cleanedData.contacts)
+            } catch (e: Exception) {
+                finalContacts = emptyList()
+            }
+        }
+
+        val finalData = BackupData(
+            messages = finalMessages,
+            callLogs = finalCallLogs,
+            contacts = finalContacts,
+            timestamp = cleanedData.timestamp,
+            deviceInfo = cleanedData.deviceInfo
+        )
+
+        val jsonString: String
+        try {
+            jsonString = toJson(finalData)
+            if (jsonString.isBlank() || jsonString == "{}" || jsonString == "null") {
+                return null
+            }
+            fromJson(jsonString) ?: return null
+        } catch (e: Exception) {
+            return null
+        }
+
+        val jsonBytes = jsonString.toByteArray(Charsets.UTF_8)
+        if (jsonBytes.size > maxBytes) {
+            val limitedData = BackupData(
+                messages = finalMessages?.take(500),
+                callLogs = finalCallLogs?.take(500),
+                contacts = finalContacts?.take(500),
+                timestamp = cleanedData.timestamp,
+                deviceInfo = "${cleanedData.deviceInfo} (数据已精简，原始数据: ${finalMessages?.size ?: 0}条短信, ${finalCallLogs?.size ?: 0}条通话记录, ${finalContacts?.size ?: 0}个联系人)"
+            )
+            return toJson(limitedData)
+        }
+
+        return jsonString
+    }
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/BackupFileWriter.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/BackupFileWriter.kt
new file mode 100644
index 0000000..10e9e58
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/BackupFileWriter.kt
@@ -0,0 +1,9 @@
+package com.iskenkenya.commory.sdk.backup.writer
+
+import com.iskenkenya.commory.sdk.backup.model.BackupResult
+import com.iskenkenya.commory.sdk.backup.model.BackupWriteStats
+import com.iskenkenya.commory.sdk.backup.msglayer.model.MsgLayerRootExport
+
+interface BackupFileWriter {
+    suspend fun writeBackup(export: MsgLayerRootExport, stats: BackupWriteStats): BackupResult
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/CallLogWriter.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/CallLogWriter.kt
new file mode 100644
index 0000000..e6a5b5e
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/CallLogWriter.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.writer
+
+import com.iskenkenya.commory.sdk.backup.model.CallLogData
+
+interface CallLogWriter {
+    suspend fun write(callLogs: List<CallLogData>): Int
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/ContactWriter.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/ContactWriter.kt
new file mode 100644
index 0000000..ca3ff6c
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/ContactWriter.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.writer
+
+import com.iskenkenya.commory.sdk.backup.model.ContactData
+
+interface ContactWriter {
+    suspend fun write(contacts: List<ContactData>): Int
+}
diff --git a/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/SmsWriter.kt b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/SmsWriter.kt
new file mode 100644
index 0000000..8c902af
--- /dev/null
+++ b/android/sdk/backup/src/main/kotlin/com/iskenkenya/commory/sdk/backup/writer/SmsWriter.kt
@@ -0,0 +1,7 @@
+package com.iskenkenya.commory.sdk.backup.writer
+
+import com.iskenkenya.commory.sdk.backup.model.SmsData
+
+interface SmsWriter {
+    suspend fun write(messages: List<SmsData>): Int
+}
diff --git a/android/sdk/storage/build.gradle b/android/sdk/storage/build.gradle
new file mode 100644
index 0000000..2d708e5
--- /dev/null
+++ b/android/sdk/storage/build.gradle
@@ -0,0 +1,37 @@
+plugins {
+    id 'com.android.library'
+}
+
+android {
+    namespace 'com.iskenkenya.commory.sdk.storage'
+    compileSdk 35
+    buildToolsVersion "36.1.0"
+
+    defaultConfig {
+        minSdk 24
+        targetSdk 35
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles "consumer-rules.pro"
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutines_version"
+    implementation 'androidx.core:core-ktx:1.16.0'
+    implementation "androidx.room:room-runtime:$room_version"
+    implementation "androidx.room:room-ktx:$room_version"
+    annotationProcessor "androidx.room:room-compiler:$room_version"
+    implementation "com.squareup.retrofit2:retrofit:$retrofit_version"
+    implementation "com.squareup.retrofit2:converter-gson:$retrofit_version"
+    implementation "com.google.code.gson:gson:$gson_version"
+
+    testImplementation 'junit:junit:4.13.2'
+}
diff --git a/android/sdk/storage/src/main/AndroidManifest.xml b/android/sdk/storage/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..9b65eb0
--- /dev/null
+++ b/android/sdk/storage/src/main/AndroidManifest.xml
@@ -0,0 +1 @@
+<manifest/>
diff --git a/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/LocalStorageProvider.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/LocalStorageProvider.kt
new file mode 100644
index 0000000..05d2add
--- /dev/null
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/LocalStorageProvider.kt
@@ -0,0 +1,120 @@
+package com.iskenkenya.commory.sdk.storage
+
+import android.content.Context
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.withContext
+import java.io.File
+import java.net.URLConnection
+
+class LocalStorageProvider(
+    private val context: Context
+) : StorageProvider {
+
+    private val _isAvailable = MutableStateFlow(false)
+    override val isAvailable: StateFlow<Boolean> = _isAvailable
+
+    private val baseDir: File = context.getExternalFilesDir(null)
+        ?: context.filesDir
+
+    init {
+        refreshAvailability()
+    }
+
+    private fun refreshAvailability() {
+        _isAvailable.value = baseDir.exists() && baseDir.canWrite()
+    }
+
+    override suspend fun save(data: ByteArray, path: String): StorageResult =
+        withContext(Dispatchers.IO) {
+            try {
+                val file = File(baseDir, path)
+                file.parentFile?.mkdirs()
+                file.writeBytes(data)
+                refreshAvailability()
+                StorageResult.Success(path = file.absolutePath)
+            } catch (e: Exception) {
+                StorageResult.Error(code = "SAVE_FAILED", message = e.message ?: "Unknown error")
+            }
+        }
+
+    override suspend fun load(path: String): StorageResult =
+        withContext(Dispatchers.IO) {
+            try {
+                val file = File(baseDir, path)
+                if (!file.exists()) {
+                    return@withContext StorageResult.Error(code = "FILE_NOT_FOUND", message = "File not found: $path")
+                }
+                val data = file.readBytes()
+                StorageResult.Success(path = file.absolutePath, data = data)
+            } catch (e: Exception) {
+                StorageResult.Error(code = "LOAD_FAILED", message = e.message ?: "Unknown error")
+            }
+        }
+
+    override suspend fun list(prefix: String): List<StorageFileInfo> =
+        withContext(Dispatchers.IO) {
+            val searchDir = if (prefix.isNotEmpty()) {
+                File(baseDir, prefix)
+            } else {
+                baseDir
+            }
+            if (!searchDir.exists() || !searchDir.isDirectory) {
+                return@withContext emptyList()
+            }
+            searchDir.walkTopDown()
+                .filter { it.isFile }
+                .map { file ->
+                    val relativePath = file.relativeTo(baseDir).path
+                    StorageFileInfo(
+                        path = relativePath,
+                        size = file.length(),
+                        lastModified = file.lastModified(),
+                        mimeType = guessMimeType(file)
+                    )
+                }
+                .toList()
+        }
+
+    override suspend fun delete(path: String): StorageResult =
+        withContext(Dispatchers.IO) {
+            try {
+                val file = File(baseDir, path)
+                if (!file.exists()) {
+                    return@withContext StorageResult.Error(code = "FILE_NOT_FOUND", message = "File not found: $path")
+                }
+                val deleted = file.delete()
+                if (deleted) {
+                    refreshAvailability()
+                    StorageResult.Success(path = path)
+                } else {
+                    StorageResult.Error(code = "DELETE_FAILED", message = "Failed to delete: $path")
+                }
+            } catch (e: Exception) {
+                StorageResult.Error(code = "DELETE_FAILED", message = e.message ?: "Unknown error")
+            }
+        }
+
+    override suspend fun getStorageInfo(): StorageInfo =
+        withContext(Dispatchers.IO) {
+            refreshAvailability()
+            val totalSpace = baseDir.totalSpace
+            val availableSpace = baseDir.usableSpace
+            val usedSpace = totalSpace - availableSpace
+            StorageInfo(
+                totalSpace = totalSpace,
+                usedSpace = usedSpace,
+                availableSpace = availableSpace
+            )
+        }
+
+    private fun guessMimeType(file: File): String? {
+        val name = file.name
+        return try {
+            URLConnection.guessContentTypeFromName(name)
+        } catch (e: Exception) {
+            null
+        }
+    }
+}
diff --git a/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/RemoteStorageProvider.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/RemoteStorageProvider.kt
new file mode 100644
index 0000000..8e87f5b
--- /dev/null
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/RemoteStorageProvider.kt
@@ -0,0 +1,19 @@
+package com.iskenkenya.commory.sdk.storage
+
+interface RemoteStorageProvider {
+    val isConnected: Boolean
+
+    suspend fun upload(data: ByteArray, remotePath: String): StorageResult
+    suspend fun download(remotePath: String): StorageResult
+    suspend fun listRemote(prefix: String = ""): List<StorageFileInfo>
+    suspend fun deleteRemote(remotePath: String): StorageResult
+    suspend fun connect(config: RemoteStorageConfig): Boolean
+    suspend fun disconnect()
+}
+
+data class RemoteStorageConfig(
+    val serverUrl: String,
+    val authToken: String? = null,
+    val maxRetryCount: Int = 3,
+    val timeoutMs: Long = 30000
+)
diff --git a/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/StorageProvider.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/StorageProvider.kt
new file mode 100644
index 0000000..58e9a84
--- /dev/null
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/StorageProvider.kt
@@ -0,0 +1,31 @@
+package com.iskenkenya.commory.sdk.storage
+
+import kotlinx.coroutines.flow.StateFlow
+
+interface StorageProvider {
+    val isAvailable: StateFlow<Boolean>
+
+    suspend fun save(data: ByteArray, path: String): StorageResult
+    suspend fun load(path: String): StorageResult
+    suspend fun list(prefix: String = ""): List<StorageFileInfo>
+    suspend fun delete(path: String): StorageResult
+    suspend fun getStorageInfo(): StorageInfo
+}
+
+data class StorageFileInfo(
+    val path: String,
+    val size: Long,
+    val lastModified: Long,
+    val mimeType: String? = null
+)
+
+data class StorageInfo(
+    val totalSpace: Long,
+    val usedSpace: Long,
+    val availableSpace: Long
+)
+
+sealed class StorageResult {
+    data class Success(val path: String, val data: ByteArray? = null) : StorageResult()
+    data class Error(val code: String, val message: String) : StorageResult()
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/dao/CallLogDao.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/CallLogDao.kt
similarity index 59%
rename from android/app/src/main/java/imken/messagevault/mobile/data/dao/CallLogDao.kt
rename to android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/CallLogDao.kt
index 9636cdc..3bdcd72 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/data/dao/CallLogDao.kt
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/CallLogDao.kt
@@ -1,38 +1,23 @@
-package imken.messagevault.mobile.data.dao
+package com.iskenkenya.commory.sdk.storage.dao
 
 import androidx.room.Dao
 import androidx.room.Insert
 import androidx.room.OnConflictStrategy
 import androidx.room.Query
-import imken.messagevault.mobile.data.entity.CallLogsEntity
+import com.iskenkenya.commory.sdk.storage.entity.CallLogsEntity
 
-/**
- * 通话记录DAO接口
- */
 @Dao
 interface CallLogDao {
-    
-    /**
-     * 插入通话记录
-     */
+
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertCallLogs(callLogs: List<CallLogsEntity>)
-    
-    /**
-     * 获取所有通话记录，按日期倒序排列
-     */
+
     @Query("SELECT * FROM call_logs ORDER BY date DESC")
     suspend fun getAllCallLogs(): List<CallLogsEntity>
-    
-    /**
-     * 删除所有通话记录
-     */
+
     @Query("DELETE FROM call_logs")
     suspend fun deleteAllCallLogs()
-    
-    /**
-     * 获取通话记录数量
-     */
+
     @Query("SELECT COUNT(id) FROM call_logs")
     suspend fun getCallLogsCount(): Int
-} 
\ No newline at end of file
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/dao/ContactDao.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/ContactDao.kt
similarity index 60%
rename from android/app/src/main/java/imken/messagevault/mobile/data/dao/ContactDao.kt
rename to android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/ContactDao.kt
index b7af6dd..8a627a0 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/data/dao/ContactDao.kt
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/ContactDao.kt
@@ -1,38 +1,23 @@
-package imken.messagevault.mobile.data.dao
+package com.iskenkenya.commory.sdk.storage.dao
 
 import androidx.room.Dao
 import androidx.room.Insert
 import androidx.room.OnConflictStrategy
 import androidx.room.Query
-import imken.messagevault.mobile.data.entity.ContactsEntity
+import com.iskenkenya.commory.sdk.storage.entity.ContactsEntity
 
-/**
- * 联系人DAO接口
- */
 @Dao
 interface ContactDao {
-    
-    /**
-     * 插入联系人
-     */
+
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertContacts(contacts: List<ContactsEntity>)
-    
-    /**
-     * 获取所有联系人，按姓名排序
-     */
+
     @Query("SELECT * FROM contacts ORDER BY name ASC")
     suspend fun getAllContacts(): List<ContactsEntity>
-    
-    /**
-     * 删除所有联系人
-     */
+
     @Query("DELETE FROM contacts")
     suspend fun deleteAllContacts()
-    
-    /**
-     * 获取联系人数量
-     */
+
     @Query("SELECT COUNT(id) FROM contacts")
     suspend fun getContactsCount(): Int
-} 
\ No newline at end of file
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/dao/MessageDao.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/MessageDao.kt
similarity index 59%
rename from android/app/src/main/java/imken/messagevault/mobile/data/dao/MessageDao.kt
rename to android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/MessageDao.kt
index a0dab33..3c6d031 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/data/dao/MessageDao.kt
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/dao/MessageDao.kt
@@ -1,38 +1,23 @@
-package imken.messagevault.mobile.data.dao
+package com.iskenkenya.commory.sdk.storage.dao
 
 import androidx.room.Dao
 import androidx.room.Insert
 import androidx.room.OnConflictStrategy
 import androidx.room.Query
-import imken.messagevault.mobile.data.entity.MessageEntity
+import com.iskenkenya.commory.sdk.storage.entity.MessageEntity
 
-/**
- * 短信消息DAO接口
- */
 @Dao
 interface MessageDao {
-    
-    /**
-     * 插入短信消息
-     */
+
     @Insert(onConflict = OnConflictStrategy.REPLACE)
     suspend fun insertMessages(messages: List<MessageEntity>)
-    
-    /**
-     * 获取所有短信消息，按日期倒序排列
-     */
+
     @Query("SELECT * FROM messages ORDER BY date DESC")
     suspend fun getAllMessages(): List<MessageEntity>
-    
-    /**
-     * 删除所有短信消息
-     */
+
     @Query("DELETE FROM messages")
     suspend fun deleteAllMessages()
-    
-    /**
-     * 获取短信消息数量
-     */
+
     @Query("SELECT COUNT(id) FROM messages")
     suspend fun getMessagesCount(): Int
-} 
\ No newline at end of file
+}
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/database/AppDatabase.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/database/AppDatabase.kt
similarity index 61%
rename from android/app/src/main/java/imken/messagevault/mobile/data/database/AppDatabase.kt
rename to android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/database/AppDatabase.kt
index 429edc0..9eb9b3d 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/data/database/AppDatabase.kt
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/database/AppDatabase.kt
@@ -1,19 +1,16 @@
-package imken.messagevault.mobile.data.database
+package com.iskenkenya.commory.sdk.storage.database
 
 import android.content.Context
 import androidx.room.Database
 import androidx.room.Room
 import androidx.room.RoomDatabase
-import imken.messagevault.mobile.data.dao.CallLogDao
-import imken.messagevault.mobile.data.dao.ContactDao
-import imken.messagevault.mobile.data.dao.MessageDao
-import imken.messagevault.mobile.data.entity.CallLogsEntity
-import imken.messagevault.mobile.data.entity.ContactsEntity
-import imken.messagevault.mobile.data.entity.MessageEntity
+import com.iskenkenya.commory.sdk.storage.dao.CallLogDao
+import com.iskenkenya.commory.sdk.storage.dao.ContactDao
+import com.iskenkenya.commory.sdk.storage.dao.MessageDao
+import com.iskenkenya.commory.sdk.storage.entity.CallLogsEntity
+import com.iskenkenya.commory.sdk.storage.entity.ContactsEntity
+import com.iskenkenya.commory.sdk.storage.entity.MessageEntity
 
-/**
- * 应用数据库类
- */
 @Database(
     entities = [
         CallLogsEntity::class,
@@ -24,30 +21,15 @@ import imken.messagevault.mobile.data.entity.MessageEntity
     exportSchema = false
 )
 abstract class AppDatabase : RoomDatabase() {
-    
-    /**
-     * 获取通话记录DAO
-     */
+
     abstract fun callLogDao(): CallLogDao
-    
-    /**
-     * 获取短信消息DAO
-     */
     abstract fun messageDao(): MessageDao
-    
-    /**
-     * 获取联系人DAO
-     */
     abstract fun contactDao(): ContactDao
-    
+
     companion object {
-        // 单例实例
         @Volatile
         private var INSTANCE: AppDatabase? = null
-        
-        /**
-         * 获取数据库实例
-         */
+
         fun getInstance(context: Context): AppDatabase {
             return INSTANCE ?: synchronized(this) {
                 val instance = Room.databaseBuilder(
@@ -62,4 +44,4 @@ abstract class AppDatabase : RoomDatabase() {
             }
         }
     }
-} 
\ No newline at end of file
+}
diff --git a/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/CallLogsEntity.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/CallLogsEntity.kt
new file mode 100644
index 0000000..0242daf
--- /dev/null
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/CallLogsEntity.kt
@@ -0,0 +1,15 @@
+package com.iskenkenya.commory.sdk.storage.entity
+
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+
+@Entity(tableName = "call_logs")
+data class CallLogsEntity(
+    @PrimaryKey(autoGenerate = true)
+    val id: Long = 0,
+    val number: String,
+    val name: String,
+    val date: Long,
+    val duration: Int,
+    val type: Int
+)
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/entity/ContactsEntity.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/ContactsEntity.kt
similarity index 76%
rename from android/app/src/main/java/imken/messagevault/mobile/data/entity/ContactsEntity.kt
rename to android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/ContactsEntity.kt
index 5d4ca7e..72a33f8 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/data/entity/ContactsEntity.kt
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/ContactsEntity.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.data.entity
+package com.iskenkenya.commory.sdk.storage.entity
 
 import android.os.Parcel
 import android.os.Parcelable
@@ -6,47 +6,19 @@ import androidx.room.Entity
 import androidx.room.PrimaryKey
 import com.google.gson.annotations.SerializedName
 
-/**
- * 联系人实体类
- * 
- * 用于在Room数据库中存储联系人数据
- */
 @Entity(tableName = "contacts")
 data class ContactsEntity(
-    /**
-     * 联系人ID，主键
-     */
     @PrimaryKey
     @SerializedName("id")
     val id: Long,
-    
-    /**
-     * 联系人姓名
-     */
     @SerializedName("name")
     val name: String,
-    
-    /**
-     * 联系人电话号码列表
-     */
     @SerializedName("phone_numbers")
     val phoneNumbers: List<String>,
-    
-    /**
-     * 联系人电子邮件列表
-     */
     @SerializedName("emails")
     val emails: List<String>,
-    
-    /**
-     * 联系人头像URI
-     */
     @SerializedName("photo_uri")
     val photoUri: String? = null,
-    
-    /**
-     * 最后更新时间
-     */
     @SerializedName("last_updated")
     val lastUpdated: Long = System.currentTimeMillis()
 ) : Parcelable {
@@ -56,23 +28,23 @@ data class ContactsEntity(
         parcel.createStringArrayList() ?: emptyList(),
         parcel.createStringArrayList() ?: emptyList()
     )
-    
+
     override fun writeToParcel(parcel: Parcel, flags: Int) {
         parcel.writeLong(id)
         parcel.writeString(name)
         parcel.writeStringList(phoneNumbers)
         parcel.writeStringList(emails)
     }
-    
+
     override fun describeContents(): Int {
         return 0
     }
-    
+
     companion object CREATOR : Parcelable.Creator<ContactsEntity> {
         override fun createFromParcel(parcel: Parcel): ContactsEntity {
             return ContactsEntity(parcel)
         }
-        
+
         override fun newArray(size: Int): Array<ContactsEntity?> {
             return arrayOfNulls(size)
         }
diff --git a/android/app/src/main/java/imken/messagevault/mobile/data/entity/MessageEntity.kt b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/MessageEntity.kt
similarity index 86%
rename from android/app/src/main/java/imken/messagevault/mobile/data/entity/MessageEntity.kt
rename to android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/MessageEntity.kt
index c1740c7..1c23507 100644
--- a/android/app/src/main/java/imken/messagevault/mobile/data/entity/MessageEntity.kt
+++ b/android/sdk/storage/src/main/kotlin/com/iskenkenya/commory/sdk/storage/entity/MessageEntity.kt
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile.data.entity
+package com.iskenkenya.commory.sdk.storage.entity
 
 import androidx.room.Entity
 import androidx.room.PrimaryKey
@@ -14,4 +14,4 @@ data class MessageEntity(
     val read: Int? = 0,
     val status: Int? = 0,
     val threadId: Long = 0
-) 
\ No newline at end of file
+)
diff --git a/android/settings.gradle b/android/settings.gradle
index cd01de8..612e4f9 100644
--- a/android/settings.gradle
+++ b/android/settings.gradle
@@ -14,5 +14,8 @@ dependencyResolutionManagement {
     }
 }
 
-rootProject.name = "MessageVault-Mobile"
+rootProject.name = "Commory-Mobile"
 include ':app'
+include ':sdk:backup'
+include ':sdk:auth'
+include ':sdk:storage'
diff --git a/android/tests/integration/SampleIntegrationTest.java b/android/tests/integration/SampleIntegrationTest.java
index 45edd59..558f723 100644
--- a/android/tests/integration/SampleIntegrationTest.java
+++ b/android/tests/integration/SampleIntegrationTest.java
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile;
+package com.iskenkenya.commory.mobile;
 
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 import androidx.test.platform.app.InstrumentationRegistry;
@@ -26,7 +26,7 @@ public void useAppContext() {
         // 获取应用Context
         Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
         // 包名验证 - 确保测试运行在正确的应用上
-        assertEquals("imken.messagevault.mobile", appContext.getPackageName());
+        assertEquals("com.iskenkenya.commory.mobile", appContext.getPackageName());
     }
     
     /**
diff --git a/android/tests/unit/SampleTest.java b/android/tests/unit/SampleTest.java
index 8a6af5b..ce213db 100644
--- a/android/tests/unit/SampleTest.java
+++ b/android/tests/unit/SampleTest.java
@@ -1,4 +1,4 @@
-package imken.messagevault.mobile;
+package com.iskenkenya.commory.mobile;
 
 import org.junit.Test;
 import static org.junit.Assert.*;
diff --git a/backend/cmd/commory/main.go b/backend/cmd/commory/main.go
new file mode 100644
index 0000000..48e3666
--- /dev/null
+++ b/backend/cmd/commory/main.go
@@ -0,0 +1,21 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"os/signal"
+	"syscall"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/cli"
+)
+
+func main() {
+	ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+	defer cancel()
+
+	if err := cli.Execute(ctx, os.Args[1:], os.Stdout, os.Stderr); err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		os.Exit(1)
+	}
+}
diff --git a/backend/commory b/backend/commory
new file mode 100755
index 0000000..6882156
Binary files /dev/null and b/backend/commory differ
diff --git a/backend/go.mod b/backend/go.mod
new file mode 100644
index 0000000..229b5db
--- /dev/null
+++ b/backend/go.mod
@@ -0,0 +1,22 @@
+module github.com/IsKenKenYa/Commory/backend
+
+go 1.25.0
+
+require (
+	github.com/google/uuid v1.6.0
+	github.com/mattn/go-sqlite3 v1.14.44
+)
+
+require (
+	github.com/fxamacker/cbor/v2 v2.9.2 // indirect
+	github.com/go-viper/mapstructure/v2 v2.5.0 // indirect
+	github.com/go-webauthn/webauthn v0.17.3
+	github.com/go-webauthn/x v0.2.5 // indirect
+	github.com/golang-jwt/jwt/v5 v5.3.1 // indirect
+	github.com/google/go-tpm v0.9.8 // indirect
+	github.com/philhofer/fwd v1.2.0 // indirect
+	github.com/tinylib/msgp v1.6.4 // indirect
+	github.com/x448/float16 v0.8.4 // indirect
+	golang.org/x/crypto v0.51.0 // indirect
+	golang.org/x/sys v0.44.0 // indirect
+)
diff --git a/backend/go.sum b/backend/go.sum
new file mode 100644
index 0000000..fe5bd63
--- /dev/null
+++ b/backend/go.sum
@@ -0,0 +1,38 @@
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/fxamacker/cbor/v2 v2.9.2 h1:X4Ksno9+x3cz0TZv69ec1hxP/+tymuR8PXQJyDwfh78=
+github.com/fxamacker/cbor/v2 v2.9.2/go.mod h1:vM4b+DJCtHn+zz7h3FFp/hDAI9WNWCsZj23V5ytsSxQ=
+github.com/go-viper/mapstructure/v2 v2.5.0 h1:vM5IJoUAy3d7zRSVtIwQgBj7BiWtMPfmPEgAXnvj1Ro=
+github.com/go-viper/mapstructure/v2 v2.5.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
+github.com/go-webauthn/webauthn v0.17.3 h1:XHZ0TXV7k8vChcE4TFgPitOPJ5cb7h1dpAeFDS0cjCo=
+github.com/go-webauthn/webauthn v0.17.3/go.mod h1:PlkMgmuL9McCT7dvgBj/Sz/fgs3V6ZID6/KnFkEcPvQ=
+github.com/go-webauthn/x v0.2.5 h1:wEVTfU04XFyPTXGQbKOQwMKhcDWfDAkdsDDBsDaG9yY=
+github.com/go-webauthn/x v0.2.5/go.mod h1:Qna/yJz9rV6lRzwl5BfYbmTJpVGxcBIds3gJtw2tlGg=
+github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY=
+github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
+github.com/google/go-tpm v0.9.8 h1:slArAR9Ft+1ybZu0lBwpSmpwhRXaa85hWtMinMyRAWo=
+github.com/google/go-tpm v0.9.8/go.mod h1:h9jEsEECg7gtLis0upRBQU+GhYVH6jMjrFxI8u6bVUY=
+github.com/google/go-tpm-tools v0.3.13-0.20230620182252-4639ecce2aba h1:qJEJcuLzH5KDR0gKc0zcktin6KSAwL7+jWKBYceddTc=
+github.com/google/go-tpm-tools v0.3.13-0.20230620182252-4639ecce2aba/go.mod h1:EFYHy8/1y2KfgTAsx7Luu7NGhoxtuVHnNo8jE7FikKc=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/mattn/go-sqlite3 v1.14.44 h1:3VSe+xafpbzsLbdr2AWlAZk9yRHiBhTBakioXaCKTF8=
+github.com/mattn/go-sqlite3 v1.14.44/go.mod h1:pjEuOr8IwzLJP2MfGeTb0A35jauH+C2kbHKBr7yXKVQ=
+github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM=
+github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/tinylib/msgp v1.6.4 h1:mOwYbyYDLPj35mkA2BjjYejgJk9BuHxDdvRnb6v2ZcQ=
+github.com/tinylib/msgp v1.6.4/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA=
+github.com/x448/float16 v0.8.4 h1:qLwI1I70+NjRFUR3zs1JPUCgaCXSh3SW62uAKT1mSBM=
+github.com/x448/float16 v0.8.4/go.mod h1:14CWIYCyZA/cWjXOioeEpHeN/83MdbZDRQHoFcYsOfg=
+go.uber.org/mock v0.6.0 h1:hyF9dfmbgIX5EfOdasqLsWD6xqpNZlXblLB/Dbnwv3Y=
+go.uber.org/mock v0.6.0/go.mod h1:KiVJ4BqZJaMj4svdfmHM0AUx4NJYO8ZNpPnZn1Z+BBU=
+golang.org/x/crypto v0.51.0 h1:IBPXwPfKxY7cWQZ38ZCIRPI50YLeevDLlLnyC5wRGTI=
+golang.org/x/crypto v0.51.0/go.mod h1:8AdwkbraGNABw2kOX6YFPs3WM22XqI4EXEd8g+x7Oc8=
+golang.org/x/sys v0.44.0 h1:ildZl3J4uzeKP07r2F++Op7E9B29JRUy+a27EibtBTQ=
+golang.org/x/sys v0.44.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/backend/internal/agent/runtime.go b/backend/internal/agent/runtime.go
new file mode 100644
index 0000000..99b3379
--- /dev/null
+++ b/backend/internal/agent/runtime.go
@@ -0,0 +1,133 @@
+package agent
+
+import (
+	"context"
+	"errors"
+	"fmt"
+)
+
+type Role string
+
+const (
+	RoleSystem    Role = "system"
+	RoleUser      Role = "user"
+	RoleAssistant Role = "assistant"
+	RoleTool      Role = "tool"
+)
+
+type Message struct {
+	Role    Role
+	Content string
+}
+
+type ToolSpec struct {
+	Name        string
+	Description string
+	InputSchema string
+}
+
+type Request struct {
+	SessionID string
+	Messages  []Message
+	Tools     []ToolSpec
+}
+
+type Response struct {
+	Message Message
+}
+
+type Provider interface {
+	Complete(context.Context, Request) (Response, error)
+}
+
+type ToolRegistry interface {
+	ListTools(context.Context, string) ([]ToolSpec, error)
+}
+
+type PermissionDecision string
+
+const (
+	PermissionAllow PermissionDecision = "allow"
+	PermissionDeny  PermissionDecision = "deny"
+)
+
+type PermissionRequest struct {
+	SessionID string
+	ToolName  string
+}
+
+type PermissionBroker interface {
+	Decide(context.Context, PermissionRequest) (PermissionDecision, error)
+}
+
+type SessionStore interface {
+	Append(context.Context, string, []Message) error
+}
+
+type Runtime struct {
+	provider    Provider
+	tools       ToolRegistry
+	permissions PermissionBroker
+	sessions    SessionStore
+}
+
+func NewRuntime(provider Provider, tools ToolRegistry, permissions PermissionBroker, sessions SessionStore) (*Runtime, error) {
+	if provider == nil {
+		return nil, errors.New("agent provider is required")
+	}
+	if tools == nil {
+		return nil, errors.New("agent tool registry is required")
+	}
+	if permissions == nil {
+		return nil, errors.New("agent permission broker is required")
+	}
+	if sessions == nil {
+		return nil, errors.New("agent session store is required")
+	}
+	return &Runtime{
+		provider:    provider,
+		tools:       tools,
+		permissions: permissions,
+		sessions:    sessions,
+	}, nil
+}
+
+func (r *Runtime) Run(ctx context.Context, sessionID string, input Message) (Message, error) {
+	if sessionID == "" {
+		return Message{}, errors.New("agent session id is required")
+	}
+	if input.Role == "" {
+		return Message{}, errors.New("agent input role is required")
+	}
+	if err := r.sessions.Append(ctx, sessionID, []Message{input}); err != nil {
+		return Message{}, fmt.Errorf("append user input: %w", err)
+	}
+	tools, err := r.tools.ListTools(ctx, sessionID)
+	if err != nil {
+		return Message{}, fmt.Errorf("list tools: %w", err)
+	}
+	for _, tool := range tools {
+		decision, err := r.permissions.Decide(ctx, PermissionRequest{SessionID: sessionID, ToolName: tool.Name})
+		if err != nil {
+			return Message{}, fmt.Errorf("decide permission for %s: %w", tool.Name, err)
+		}
+		if decision != PermissionAllow {
+			return Message{}, fmt.Errorf("tool %s permission denied", tool.Name)
+		}
+	}
+	response, err := r.provider.Complete(ctx, Request{
+		SessionID: sessionID,
+		Messages:  []Message{input},
+		Tools:     tools,
+	})
+	if err != nil {
+		return Message{}, fmt.Errorf("complete agent response: %w", err)
+	}
+	if response.Message.Role == "" {
+		response.Message.Role = RoleAssistant
+	}
+	if err := r.sessions.Append(ctx, sessionID, []Message{response.Message}); err != nil {
+		return Message{}, fmt.Errorf("append assistant response: %w", err)
+	}
+	return response.Message, nil
+}
diff --git a/backend/internal/agent/runtime_test.go b/backend/internal/agent/runtime_test.go
new file mode 100644
index 0000000..32ab37e
--- /dev/null
+++ b/backend/internal/agent/runtime_test.go
@@ -0,0 +1,99 @@
+package agent
+
+import (
+	"context"
+	"testing"
+)
+
+func TestRuntimeRunPersistsInputAndResponse(t *testing.T) {
+	store := &memorySessionStore{}
+	runtime, err := NewRuntime(
+		providerFunc(func(ctx context.Context, req Request) (Response, error) {
+			if req.SessionID != "session-1" {
+				t.Fatalf("unexpected session id: %s", req.SessionID)
+			}
+			if len(req.Tools) != 1 || req.Tools[0].Name != "read_file" {
+				t.Fatalf("unexpected tools: %#v", req.Tools)
+			}
+			return Response{Message: Message{Content: "done"}}, nil
+		}),
+		toolRegistryFunc(func(ctx context.Context, sessionID string) ([]ToolSpec, error) {
+			return []ToolSpec{{Name: "read_file", Description: "Read a file"}}, nil
+		}),
+		permissionBrokerFunc(func(ctx context.Context, req PermissionRequest) (PermissionDecision, error) {
+			if req.ToolName != "read_file" {
+				t.Fatalf("unexpected tool permission request: %s", req.ToolName)
+			}
+			return PermissionAllow, nil
+		}),
+		store,
+	)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	message, err := runtime.Run(context.Background(), "session-1", Message{Role: RoleUser, Content: "hello"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	if message.Role != RoleAssistant || message.Content != "done" {
+		t.Fatalf("unexpected message: %#v", message)
+	}
+	if len(store.messages) != 2 {
+		t.Fatalf("expected two persisted messages, got %d", len(store.messages))
+	}
+}
+
+func TestRuntimeRunDeniesToolsBeforeProviderCall(t *testing.T) {
+	called := false
+	runtime, err := NewRuntime(
+		providerFunc(func(ctx context.Context, req Request) (Response, error) {
+			called = true
+			return Response{}, nil
+		}),
+		toolRegistryFunc(func(ctx context.Context, sessionID string) ([]ToolSpec, error) {
+			return []ToolSpec{{Name: "write_file"}}, nil
+		}),
+		permissionBrokerFunc(func(ctx context.Context, req PermissionRequest) (PermissionDecision, error) {
+			return PermissionDeny, nil
+		}),
+		&memorySessionStore{},
+	)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	if _, err := runtime.Run(context.Background(), "session-1", Message{Role: RoleUser, Content: "hello"}); err == nil {
+		t.Fatal("expected permission error")
+	}
+	if called {
+		t.Fatal("provider was called after permission denial")
+	}
+}
+
+type providerFunc func(context.Context, Request) (Response, error)
+
+func (f providerFunc) Complete(ctx context.Context, req Request) (Response, error) {
+	return f(ctx, req)
+}
+
+type toolRegistryFunc func(context.Context, string) ([]ToolSpec, error)
+
+func (f toolRegistryFunc) ListTools(ctx context.Context, sessionID string) ([]ToolSpec, error) {
+	return f(ctx, sessionID)
+}
+
+type permissionBrokerFunc func(context.Context, PermissionRequest) (PermissionDecision, error)
+
+func (f permissionBrokerFunc) Decide(ctx context.Context, req PermissionRequest) (PermissionDecision, error) {
+	return f(ctx, req)
+}
+
+type memorySessionStore struct {
+	messages []Message
+}
+
+func (s *memorySessionStore) Append(ctx context.Context, sessionID string, messages []Message) error {
+	s.messages = append(s.messages, messages...)
+	return nil
+}
diff --git a/backend/internal/api/audit.go b/backend/internal/api/audit.go
new file mode 100644
index 0000000..0b99082
--- /dev/null
+++ b/backend/internal/api/audit.go
@@ -0,0 +1,58 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"net/http"
+	"strconv"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+)
+
+func (s *Server) handleAuditLogs(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if err := s.requireAdmin(r.Context()); err != nil {
+		writeError(w, http.StatusForbidden, err.Error())
+		return
+	}
+	q := r.URL.Query()
+	userID := q.Get("user_id")
+	action := q.Get("action")
+	limit := 50
+	if v, err := strconv.Atoi(q.Get("limit")); err == nil && v > 0 && v <= 200 {
+		limit = v
+	}
+	offset := 0
+	if v, err := strconv.Atoi(q.Get("offset")); err == nil && v >= 0 {
+		offset = v
+	}
+
+	logs, err := s.store.ListAuditLogs(r.Context(), userID, action, limit, offset)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	total, _ := s.store.CountAuditLogs(r.Context(), userID, action)
+	writeJSON(w, http.StatusOK, "ok", map[string]any{
+		"items":  logs,
+		"total":  total,
+		"limit":  limit,
+		"offset": offset,
+	})
+}
+
+func (s *Server) requireAdmin(ctx context.Context) error {
+	user, err := s.auth.UserInfo(ctx, auth.UserIDFromContext(ctx))
+	if err != nil {
+		return err
+	}
+	for _, role := range user.Roles {
+		if role == "R_SUPER" || role == "R_ADMIN" {
+			return nil
+		}
+	}
+	return fmt.Errorf("admin privileges required")
+}
diff --git a/backend/internal/api/auth_contract_test.go b/backend/internal/api/auth_contract_test.go
new file mode 100644
index 0000000..dd0feeb
--- /dev/null
+++ b/backend/internal/api/auth_contract_test.go
@@ -0,0 +1,380 @@
+package api
+
+import (
+	"bytes"
+	"context"
+	"crypto/hmac"
+	"crypto/sha256"
+	"encoding/base64"
+	"encoding/json"
+	"errors"
+	"net/http"
+	"net/http/httptest"
+	"path/filepath"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/config"
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+func TestMobileAuthRegisterUsesCookieOnlyRefreshContract(t *testing.T) {
+	handler := newTestMobileHandler(t)
+
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/register", bytes.NewReader(mustJSON(t, map[string]string{
+		"userName": "cookie-user",
+		"email":    "cookie@example.com",
+		"password": "passw0rd!",
+	})))
+	req.Header.Set("Content-Type", "application/json")
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusCreated {
+		t.Fatalf("register status = %d, body = %s", res.Code, res.Body.String())
+	}
+
+	var envelope struct {
+		Data map[string]any `json:"data"`
+	}
+	decodeJSON(t, res.Body.Bytes(), &envelope)
+	if _, ok := envelope.Data["refreshToken"]; ok {
+		t.Fatal("expected register response body to omit refreshToken")
+	}
+	if token := readRefreshCookieValue(t, res); token == "" {
+		t.Fatal("expected refresh cookie to be set")
+	}
+	assertPersistentRefreshCookie(t, res)
+}
+
+func TestMobileAuthLoginUsesPersistentRefreshCookie(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	registerMobileSession(t, handler, "login-cookie-user", "login-cookie@example.com")
+
+	payload := mustJSON(t, map[string]string{
+		"userName": "login-cookie-user",
+		"password": "passw0rd!",
+	})
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/login", bytes.NewReader(payload))
+	req.Header.Set("Content-Type", "application/json")
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusOK {
+		t.Fatalf("login status = %d, body = %s", res.Code, res.Body.String())
+	}
+	if token := readRefreshCookieValue(t, res); token == "" {
+		t.Fatal("expected refresh cookie to be set on login")
+	}
+	assertPersistentRefreshCookie(t, res)
+}
+
+func TestMobileRefreshRetryAllowsImmediateRetry(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	session := registerMobileSession(t, handler, "retry-user", "retry@example.com")
+
+	firstRefresh := refreshMobileSession(t, handler, session.RefreshToken)
+
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/refresh", nil)
+	req.AddCookie(&http.Cookie{Name: refreshCookieName, Value: session.RefreshToken})
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusConflict {
+		t.Fatalf("expected concurrent refresh replay to return 409, got %d", res.Code)
+	}
+	var envelope struct {
+		Msg string `json:"msg"`
+	}
+	decodeJSON(t, res.Body.Bytes(), &envelope)
+	if envelope.Msg != "ERR_REFRESH_TOKEN_RETRY" {
+		t.Fatalf("expected retry message, got %q", envelope.Msg)
+	}
+
+	secondRefresh := refreshMobileSession(t, handler, firstRefresh.RefreshToken)
+	if secondRefresh.Token == "" || secondRefresh.RefreshToken == "" {
+		t.Fatal("expected immediate retry path to preserve rotated session")
+	}
+}
+
+func TestRefreshRejectsBodyProvidedRefreshToken(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	session := registerMobileSession(t, handler, "body-refresh-user", "body-refresh@example.com")
+
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/refresh", bytes.NewReader(mustJSON(t, map[string]string{
+		"refreshToken": session.RefreshToken,
+	})))
+	req.Header.Set("Content-Type", "application/json")
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusBadRequest {
+		t.Fatalf("expected body-only refresh to be rejected, got %d body=%s", res.Code, res.Body.String())
+	}
+	assertEnvelopeMessage(t, res.Body.Bytes(), "ERR_REFRESH_TOKEN_REQUIRED")
+
+	refreshed := refreshMobileSession(t, handler, session.RefreshToken)
+	if refreshed.Token == "" || refreshed.RefreshToken == "" {
+		t.Fatal("expected refresh cookie path to remain valid after rejecting body token")
+	}
+}
+
+func TestAuthHandlerUsesPublicErrors(t *testing.T) {
+	handler := newTestMobileHandler(t)
+
+	badJSONReq := httptest.NewRequest(http.MethodPost, "/api/auth/login", bytes.NewBufferString("{"))
+	badJSONReq.Header.Set("Content-Type", "application/json")
+	badJSONRes := httptest.NewRecorder()
+	handler.ServeHTTP(badJSONRes, badJSONReq)
+	if badJSONRes.Code != http.StatusBadRequest {
+		t.Fatalf("bad json status = %d", badJSONRes.Code)
+	}
+	assertEnvelopeMessage(t, badJSONRes.Body.Bytes(), "ERR_INVALID_REQUEST")
+
+	loginReq := httptest.NewRequest(http.MethodPost, "/api/auth/login", bytes.NewReader(mustJSON(t, map[string]string{
+		"userName": "missing-user",
+		"password": "passw0rd!",
+	})))
+	loginReq.Header.Set("Content-Type", "application/json")
+	loginRes := httptest.NewRecorder()
+	handler.ServeHTTP(loginRes, loginReq)
+	if loginRes.Code != http.StatusUnauthorized {
+		t.Fatalf("login status = %d", loginRes.Code)
+	}
+	assertEnvelopeMessage(t, loginRes.Body.Bytes(), "ERR_INVALID_CREDENTIALS")
+}
+
+func TestAuthMiddlewareRejectsRevokedSessionAndThrottlesLastSeen(t *testing.T) {
+	handler, store := newFileBackedTestServer(t, false)
+
+	user := createAuthTestUser(t, store, "session-user")
+	oldSessionID := "session-old"
+	recentSessionID := "session-recent"
+	createAuthTestSession(t, store, user.ID, oldSessionID, time.Now().UTC().Add(-10*time.Minute))
+	createAuthTestSession(t, store, user.ID, recentSessionID, time.Now().UTC().Add(-2*time.Minute))
+	revokedSessionID := "session-revoked"
+	createAuthTestSession(t, store, user.ID, revokedSessionID, time.Now().UTC().Add(-10*time.Minute))
+	if err := store.RevokeSession(context.Background(), revokedSessionID); err != nil {
+		t.Fatalf("revoke session: %v", err)
+	}
+
+	oldBefore, _ := store.GetSession(context.Background(), oldSessionID)
+	recentBefore, _ := store.GetSession(context.Background(), recentSessionID)
+
+	oldReq := httptest.NewRequest(http.MethodGet, "/api/user/info", nil)
+	oldReq.Header.Set("Authorization", "Bearer "+buildTestAccessToken(t, "test-secret", user.ID, oldSessionID, time.Now().Add(time.Hour)))
+	oldRes := httptest.NewRecorder()
+	handler.ServeHTTP(oldRes, oldReq)
+	if oldRes.Code != http.StatusOK {
+		t.Fatalf("old session status = %d, body = %s", oldRes.Code, oldRes.Body.String())
+	}
+
+	recentReq := httptest.NewRequest(http.MethodGet, "/api/user/info", nil)
+	recentReq.Header.Set("Authorization", "Bearer "+buildTestAccessToken(t, "test-secret", user.ID, recentSessionID, time.Now().Add(time.Hour)))
+	recentRes := httptest.NewRecorder()
+	handler.ServeHTTP(recentRes, recentReq)
+	if recentRes.Code != http.StatusOK {
+		t.Fatalf("recent session status = %d, body = %s", recentRes.Code, recentRes.Body.String())
+	}
+
+	revokedReq := httptest.NewRequest(http.MethodGet, "/api/user/info", nil)
+	revokedReq.Header.Set("Authorization", "Bearer "+buildTestAccessToken(t, "test-secret", user.ID, revokedSessionID, time.Now().Add(time.Hour)))
+	revokedRes := httptest.NewRecorder()
+	handler.ServeHTTP(revokedRes, revokedReq)
+	if revokedRes.Code != http.StatusUnauthorized {
+		t.Fatalf("revoked session status = %d, body = %s", revokedRes.Code, revokedRes.Body.String())
+	}
+	assertEnvelopeMessage(t, revokedRes.Body.Bytes(), "ERR_UNAUTHORIZED")
+
+	oldAfter, _ := store.GetSession(context.Background(), oldSessionID)
+	recentAfter, _ := store.GetSession(context.Background(), recentSessionID)
+	if !oldAfter.LastSeenAt.After(oldBefore.LastSeenAt) {
+		t.Fatal("expected stale session last_seen_at to be updated")
+	}
+	if !recentAfter.LastSeenAt.Equal(recentBefore.LastSeenAt) {
+		t.Fatal("expected recent session last_seen_at to remain unchanged inside throttle window")
+	}
+}
+
+func TestUserInfoMissingUserUsesUnauthorizedEnvelope(t *testing.T) {
+	handler, store := newFileBackedTestServer(t, false)
+
+	missingUserID := "user_missing"
+	sessionID := "session-missing-user"
+	lastSeenAt := time.Now().UTC().Add(-10 * time.Minute)
+	createAuthTestSession(t, store, missingUserID, sessionID, lastSeenAt)
+
+	req := httptest.NewRequest(http.MethodGet, "/api/user/info", nil)
+	req.Header.Set("Authorization", "Bearer "+buildTestAccessToken(t, "test-secret", missingUserID, sessionID, time.Now().Add(time.Hour)))
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusUnauthorized {
+		t.Fatalf("user info status = %d, body = %s", res.Code, res.Body.String())
+	}
+	assertEnvelopeMessage(t, res.Body.Bytes(), "ERR_UNAUTHORIZED")
+	if strings.Contains(res.Body.String(), "not found") {
+		t.Fatalf("expected user info response to hide storage error, got %s", res.Body.String())
+	}
+}
+
+func TestAuthMiddlewareAllowsRequestWhenLastSeenUpdateFails(t *testing.T) {
+	_, store := newFileBackedTestServer(t, false)
+
+	user := createAuthTestUser(t, store, "last-seen-failure")
+	sessionID := "session-last-seen-failure"
+	lastSeenAt := time.Now().UTC().Add(-10 * time.Minute)
+	createAuthTestSession(t, store, user.ID, sessionID, lastSeenAt)
+
+	validator, err := msglayer.NewValidator(repoPath("msglayer", "schema", "v0.1", "root.schema.json"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	failingStore := failingLastSeenProvider{
+		Provider:  store,
+		updateErr: errors.New("update failed"),
+	}
+	server := NewServer(config.Config{AuthSecret: "test-secret", TLS: false}, failingStore, validator)
+
+	req := httptest.NewRequest(http.MethodGet, "/api/user/info", nil)
+	req.Header.Set("Authorization", "Bearer "+buildTestAccessToken(t, "test-secret", user.ID, sessionID, time.Now().Add(time.Hour)))
+	res := httptest.NewRecorder()
+	server.Handler().ServeHTTP(res, req)
+	if res.Code != http.StatusOK {
+		t.Fatalf("expected valid request to survive last_seen_at update failure, got %d body=%s", res.Code, res.Body.String())
+	}
+
+	sessionAfter, err := store.GetSession(context.Background(), sessionID)
+	if err != nil {
+		t.Fatalf("get session after request: %v", err)
+	}
+	if !sessionAfter.LastSeenAt.Equal(lastSeenAt) {
+		t.Fatalf("expected last_seen_at to remain unchanged on failed update, got %v want %v", sessionAfter.LastSeenAt, lastSeenAt)
+	}
+}
+
+func TestPasskeyInvalidResponseUsesPublicError(t *testing.T) {
+	handler, store := newFileBackedTestServer(t, true)
+	user := createAuthTestUser(t, store, "passkey-user")
+	sessionID := "session-passkey"
+	createAuthTestSession(t, store, user.ID, sessionID, time.Now().UTC().Add(-10*time.Minute))
+
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/passkey/register/finish", bytes.NewReader(mustJSON(t, map[string]any{
+		"challengeId": "chal_missing",
+		"response":    map[string]any{},
+	})))
+	req.Header.Set("Authorization", "Bearer "+buildTestAccessToken(t, "test-secret", user.ID, sessionID, time.Now().Add(time.Hour)))
+	req.Header.Set("Content-Type", "application/json")
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusBadRequest {
+		t.Fatalf("passkey finish status = %d, body = %s", res.Code, res.Body.String())
+	}
+	assertEnvelopeMessage(t, res.Body.Bytes(), "ERR_PASSKEY_INVALID_RESPONSE")
+}
+
+func newFileBackedTestServer(t *testing.T, withPasskey bool) (http.Handler, storage.Provider) {
+	t.Helper()
+	store, err := storage.NewFileStoreProvider(filepath.Join(t.TempDir(), "commory.json"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = store.Close() })
+	if err := store.Init(context.Background()); err != nil {
+		t.Fatal(err)
+	}
+	validator, err := msglayer.NewValidator(repoPath("msglayer", "schema", "v0.1", "root.schema.json"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	cfg := config.Config{AuthSecret: "test-secret", TLS: false}
+	if withPasskey {
+		cfg.PasskeyRPName = "Commory"
+		cfg.PasskeyRPID = "localhost"
+		cfg.PasskeyOrigin = "http://localhost"
+	}
+	server := NewServer(cfg, store, validator)
+	return server.Handler(), store
+}
+
+func createAuthTestUser(t *testing.T, store storage.Provider, userName string) storage.UserRecord {
+	t.Helper()
+	user := storage.UserRecord{
+		ID:           "user_" + userName,
+		UserName:     userName,
+		Email:        userName + "@example.com",
+		PasswordHash: "hash",
+		PasswordSalt: "salt",
+		Roles:        []string{"R_USER"},
+		Buttons:      []string{"view"},
+		CreatedAt:    time.Now().UTC(),
+		UpdatedAt:    time.Now().UTC(),
+	}
+	if _, err := store.CreateUser(context.Background(), user); err != nil {
+		t.Fatalf("create user: %v", err)
+	}
+	return user
+}
+
+func createAuthTestSession(t *testing.T, store storage.Provider, userID, sessionID string, lastSeenAt time.Time) {
+	t.Helper()
+	if err := store.CreateSession(context.Background(), storage.SessionRecord{
+		ID:         sessionID,
+		UserID:     userID,
+		CreatedAt:  lastSeenAt,
+		LastSeenAt: lastSeenAt,
+	}); err != nil {
+		t.Fatalf("create session: %v", err)
+	}
+}
+
+func buildTestAccessToken(t *testing.T, secret, userID, sessionID string, expiresAt time.Time) string {
+	t.Helper()
+	headerJSON, err := json.Marshal(map[string]string{"alg": "HS256", "typ": "JWT"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	payloadJSON, err := json.Marshal(map[string]any{
+		"sub": userID,
+		"sid": sessionID,
+		"exp": expiresAt.Unix(),
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+	header := base64.RawURLEncoding.EncodeToString(headerJSON)
+	payload := base64.RawURLEncoding.EncodeToString(payloadJSON)
+	signingInput := header + "." + payload
+	mac := hmac.New(sha256.New, []byte(secret))
+	_, _ = mac.Write([]byte(signingInput))
+	signature := base64.RawURLEncoding.EncodeToString(mac.Sum(nil))
+	return signingInput + "." + signature
+}
+
+func assertEnvelopeMessage(t *testing.T, body []byte, want string) {
+	t.Helper()
+	var envelope struct {
+		Msg string `json:"msg"`
+	}
+	decodeJSON(t, body, &envelope)
+	if envelope.Msg != want {
+		t.Fatalf("expected msg %q, got %q", want, envelope.Msg)
+	}
+}
+
+func assertPersistentRefreshCookie(t *testing.T, res *httptest.ResponseRecorder) {
+	t.Helper()
+	cookieHeader := res.Header().Get("Set-Cookie")
+	if !strings.Contains(cookieHeader, "Max-Age=604800") {
+		t.Fatalf("expected persistent refresh cookie Max-Age, got %q", cookieHeader)
+	}
+	if !strings.Contains(cookieHeader, "Expires=") {
+		t.Fatalf("expected persistent refresh cookie Expires, got %q", cookieHeader)
+	}
+}
+
+type failingLastSeenProvider struct {
+	storage.Provider
+	updateErr error
+}
+
+func (p failingLastSeenProvider) UpdateSessionLastSeen(context.Context, string) error {
+	return p.updateErr
+}
diff --git a/backend/internal/api/auth_helpers.go b/backend/internal/api/auth_helpers.go
new file mode 100644
index 0000000..f47beaf
--- /dev/null
+++ b/backend/internal/api/auth_helpers.go
@@ -0,0 +1,48 @@
+package api
+
+import (
+	"log"
+	"net/http"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+)
+
+type authResponse struct {
+	User  auth.UserInfo `json:"user"`
+	Token string        `json:"token"`
+}
+
+type tokenResponse struct {
+	Token string `json:"token"`
+}
+
+func writePublicAuthError(w http.ResponseWriter, err error) {
+	status := http.StatusInternalServerError
+	switch err {
+	case auth.ErrInvalidRequest,
+		auth.ErrUsernamePasswordMissing,
+		auth.ErrRefreshTokenRequired,
+		auth.ErrPasskeyInvalidResponse:
+		status = http.StatusBadRequest
+	case auth.ErrInvalidCredentials,
+		auth.ErrTooManyLoginAttempts,
+		auth.ErrUnauthorized,
+		auth.ErrRefreshTokenExpired,
+		auth.ErrRefreshTokenReplayed,
+		auth.ErrPasskeyChallengeExpired,
+		auth.ErrPasskeyVerification:
+		status = http.StatusUnauthorized
+	case auth.ErrRefreshTokenRetry:
+		status = http.StatusConflict
+	case auth.ErrUsernameExists:
+		status = http.StatusConflict
+	}
+	writeError(w, status, auth.PublicErrorCode(err))
+}
+
+func logAuthInternalError(scope string, err error) {
+	if err == nil {
+		return
+	}
+	log.Printf("[auth] %s: %v", scope, err)
+}
diff --git a/backend/internal/api/auth_local.go b/backend/internal/api/auth_local.go
new file mode 100644
index 0000000..93870d5
--- /dev/null
+++ b/backend/internal/api/auth_local.go
@@ -0,0 +1,122 @@
+package api
+
+import (
+	"encoding/json"
+	"net/http"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+)
+
+func (s *Server) handleRegister(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	var req struct {
+		UserName string `json:"userName"`
+		Email    string `json:"email"`
+		Password string `json:"password"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		writePublicAuthError(w, auth.ErrInvalidRequest)
+		return
+	}
+	user, pair, err := s.auth.RegisterWithDevice(r.Context(), req.UserName, req.Email, req.Password,
+		r.Header.Get("X-Commory-Device"), r.Header.Get("X-Forwarded-For"), r.Header.Get("User-Agent"))
+	if err != nil {
+		if auth.PublicErrorCode(err) == auth.ErrOperationFailed.Error() {
+			logAuthInternalError("register", err)
+		}
+		writePublicAuthError(w, err)
+		return
+	}
+	setRefreshCookie(w, pair.RefreshToken, s.cfg.TLS)
+	writeJSON(w, http.StatusCreated, "registered", authResponse{User: user, Token: pair.AccessToken})
+}
+
+func (s *Server) handleLogin(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	var req struct {
+		UserName string `json:"userName"`
+		Password string `json:"password"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		writePublicAuthError(w, auth.ErrInvalidRequest)
+		return
+	}
+	user, pair, err := s.auth.LoginWithDevice(r.Context(), r.RemoteAddr, req.UserName, req.Password,
+		r.Header.Get("X-Commory-Device"), r.Header.Get("X-Forwarded-For"), r.Header.Get("User-Agent"))
+	if err != nil {
+		if auth.PublicErrorCode(err) == auth.ErrOperationFailed.Error() {
+			logAuthInternalError("login", err)
+		}
+		writePublicAuthError(w, err)
+		return
+	}
+	setRefreshCookie(w, pair.RefreshToken, s.cfg.TLS)
+	writeJSON(w, http.StatusOK, "ok", authResponse{User: user, Token: pair.AccessToken})
+}
+
+func (s *Server) handleRefresh(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	refreshToken := ""
+	if cookie, err := r.Cookie(refreshCookieName); err == nil {
+		refreshToken = cookie.Value
+	}
+	pair, err := s.auth.Refresh(r.Context(), refreshToken)
+	if err != nil {
+		if err != auth.ErrRefreshTokenRetry {
+			clearRefreshCookie(w, s.cfg.TLS)
+		}
+		if auth.PublicErrorCode(err) == auth.ErrOperationFailed.Error() {
+			logAuthInternalError("refresh", err)
+		}
+		writePublicAuthError(w, err)
+		return
+	}
+	setRefreshCookie(w, pair.RefreshToken, s.cfg.TLS)
+	writeJSON(w, http.StatusOK, "ok", tokenResponse{Token: pair.AccessToken})
+}
+
+func (s *Server) handleLogout(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	var req struct {
+		RefreshToken string `json:"refreshToken"`
+	}
+	_ = json.NewDecoder(r.Body).Decode(&req)
+	refreshToken := req.RefreshToken
+	if refreshToken == "" {
+		if cookie, err := r.Cookie(refreshCookieName); err == nil {
+			refreshToken = cookie.Value
+		}
+	}
+	if refreshToken != "" {
+		if err := s.auth.RevokeRefreshToken(r.Context(), refreshToken); err != nil {
+			logAuthInternalError("logout revoke", err)
+		}
+	}
+	clearRefreshCookie(w, s.cfg.TLS)
+	writeJSON(w, http.StatusOK, "logged out", map[string]any{"success": true})
+}
+
+func (s *Server) handleUserInfo(w http.ResponseWriter, r *http.Request) {
+	userID := auth.UserIDFromContext(r.Context())
+	user, err := s.auth.UserInfo(r.Context(), userID)
+	if err != nil {
+		if auth.PublicErrorCode(err) == auth.ErrOperationFailed.Error() {
+			logAuthInternalError("user info", err)
+		}
+		writePublicAuthError(w, auth.ErrUnauthorized)
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", user)
+}
diff --git a/backend/internal/api/auth_oauth.go b/backend/internal/api/auth_oauth.go
new file mode 100644
index 0000000..507a967
--- /dev/null
+++ b/backend/internal/api/auth_oauth.go
@@ -0,0 +1,72 @@
+package api
+
+import (
+	"crypto/rand"
+	"fmt"
+	"net/http"
+	"strings"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+func (s *Server) handleOAuthState(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	state := randomHex(16)
+	challengeID := randomHex(8)
+	_ = s.store.CreateChallenge(r.Context(), storage.ChallengeRecord{
+		ID:        challengeID,
+		Challenge: state,
+		FlowType:  "oauth_state",
+		ExpiresAt: time.Now().UTC().Add(10 * time.Minute),
+	})
+	writeJSON(w, http.StatusOK, "ok", map[string]any{
+		"state":       state,
+		"challengeId": challengeID,
+	})
+}
+
+func (s *Server) handleOAuthProviders(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	providers := s.oauth.ListEnabled()
+	type providerInfo struct {
+		Name        string `json:"name"`
+		DisplayName string `json:"displayName"`
+	}
+	result := make([]providerInfo, 0, len(providers))
+	for _, p := range providers {
+		result = append(result, providerInfo{Name: p.Name(), DisplayName: p.DisplayName()})
+	}
+	writeJSON(w, http.StatusOK, "ok", result)
+}
+
+func (s *Server) handleOAuthCallback(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	providerName := strings.TrimPrefix(r.URL.Path, "/api/oauth/")
+	providerName = strings.TrimSuffix(providerName, "/")
+	if providerName == "" || providerName == "state" || providerName == "providers" {
+		writeError(w, http.StatusBadRequest, "provider name required")
+		return
+	}
+	provider := s.oauth.Get(providerName)
+	if provider == nil {
+		writeError(w, http.StatusNotFound, fmt.Sprintf("oauth provider %q not found", providerName))
+		return
+	}
+	writeJSON(w, http.StatusNotImplemented, "oauth callback not yet implemented", nil)
+}
+
+func randomHex(n int) string {
+	b := make([]byte, n)
+	_, _ = rand.Read(b)
+	return fmt.Sprintf("%x", b)
+}
diff --git a/backend/internal/api/auth_passkey.go b/backend/internal/api/auth_passkey.go
new file mode 100644
index 0000000..26c40ac
--- /dev/null
+++ b/backend/internal/api/auth_passkey.go
@@ -0,0 +1,190 @@
+package api
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+	"github.com/go-webauthn/webauthn/protocol"
+)
+
+func (s *Server) handlePasskeyRegisterBegin(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if s.passkey == nil {
+		writeError(w, http.StatusServiceUnavailable, auth.ErrOperationFailed.Error())
+		return
+	}
+	userID := auth.UserIDFromContext(r.Context())
+	cc, challengeID, err := s.passkey.BeginRegistration(r.Context(), userID)
+	if err != nil {
+		logAuthInternalError("passkey register begin", err)
+		writePublicAuthError(w, err)
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", map[string]any{
+		"options":     cc,
+		"challengeId": challengeID,
+	})
+}
+
+func (s *Server) handlePasskeyRegisterFinish(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if s.passkey == nil {
+		writeError(w, http.StatusServiceUnavailable, auth.ErrOperationFailed.Error())
+		return
+	}
+	userID := auth.UserIDFromContext(r.Context())
+	var req struct {
+		ChallengeID string `json:"challengeId"`
+		Response    any    `json:"response"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		writePublicAuthError(w, auth.ErrInvalidRequest)
+		return
+	}
+	respJSON, _ := json.Marshal(req.Response)
+	parsed, err := protocol.ParseCredentialCreationResponseBody(strings.NewReader(string(respJSON)))
+	if err != nil {
+		writePublicAuthError(w, auth.ErrPasskeyInvalidResponse)
+		return
+	}
+	if err := s.passkey.FinishRegistration(r.Context(), userID, req.ChallengeID, parsed); err != nil {
+		if auth.PublicErrorCode(err) == auth.ErrOperationFailed.Error() {
+			logAuthInternalError("passkey register finish", err)
+		}
+		writePublicAuthError(w, err)
+		return
+	}
+	_ = s.auth.WriteAuditLog(r.Context(), userID, "passkey_register", r.Header.Get("X-Forwarded-For"), r.Header.Get("User-Agent"), "")
+	writeJSON(w, http.StatusOK, "ok", map[string]any{"success": true})
+}
+
+func (s *Server) handlePasskeyLoginBegin(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if s.passkey == nil {
+		writeError(w, http.StatusServiceUnavailable, auth.ErrOperationFailed.Error())
+		return
+	}
+	assertion, challengeID, err := s.passkey.BeginLogin(r.Context())
+	if err != nil {
+		logAuthInternalError("passkey login begin", err)
+		writePublicAuthError(w, err)
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", map[string]any{
+		"options":     assertion,
+		"challengeId": challengeID,
+	})
+}
+
+func (s *Server) handlePasskeyLoginFinish(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if s.passkey == nil {
+		writeError(w, http.StatusServiceUnavailable, auth.ErrOperationFailed.Error())
+		return
+	}
+	var req struct {
+		ChallengeID string `json:"challengeId"`
+		Response    any    `json:"response"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		writePublicAuthError(w, auth.ErrInvalidRequest)
+		return
+	}
+	respJSON, _ := json.Marshal(req.Response)
+	parsed, err := protocol.ParseCredentialRequestResponseBody(strings.NewReader(string(respJSON)))
+	if err != nil {
+		writePublicAuthError(w, auth.ErrPasskeyInvalidResponse)
+		return
+	}
+	userID, err := s.passkey.FinishLogin(r.Context(), req.ChallengeID, parsed)
+	if err != nil {
+		if auth.PublicErrorCode(err) == auth.ErrOperationFailed.Error() {
+			logAuthInternalError("passkey login finish", err)
+		}
+		writePublicAuthError(w, err)
+		return
+	}
+	user, err := s.auth.UserInfo(r.Context(), userID)
+	if err != nil {
+		logAuthInternalError("passkey user info", err)
+		writePublicAuthError(w, auth.ErrOperationFailed)
+		return
+	}
+	userRecord, err := s.store.GetUser(r.Context(), userID)
+	if err != nil {
+		logAuthInternalError("passkey get user", err)
+		writePublicAuthError(w, auth.ErrOperationFailed)
+		return
+	}
+	pair, _, err := s.auth.IssueTokenPairForUser(
+		r.Context(),
+		userRecord,
+		r.Header.Get("X-Commory-Device"),
+		r.Header.Get("X-Forwarded-For"),
+		r.Header.Get("User-Agent"),
+	)
+	if err != nil {
+		logAuthInternalError("passkey issue token", err)
+		writePublicAuthError(w, auth.ErrOperationFailed)
+		return
+	}
+	_ = s.auth.WriteAuditLog(r.Context(), userID, "login", r.Header.Get("X-Forwarded-For"), r.Header.Get("User-Agent"), `{"method":"passkey"}`)
+	setRefreshCookie(w, pair.RefreshToken, s.cfg.TLS)
+	writeJSON(w, http.StatusOK, "ok", authResponse{User: user, Token: pair.AccessToken})
+}
+
+func (s *Server) handlePasskeys(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if s.passkey == nil {
+		writeError(w, http.StatusServiceUnavailable, auth.ErrOperationFailed.Error())
+		return
+	}
+	userID := auth.UserIDFromContext(r.Context())
+	passkeys, err := s.passkey.ListPasskeys(r.Context(), userID)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", passkeys)
+}
+
+func (s *Server) handlePasskeyDelete(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodDelete {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if s.passkey == nil {
+		writeError(w, http.StatusServiceUnavailable, auth.ErrOperationFailed.Error())
+		return
+	}
+	passkeyID := strings.TrimPrefix(r.URL.Path, "/api/auth/passkey/")
+	if passkeyID == "" {
+		writeError(w, http.StatusBadRequest, "passkey id required")
+		return
+	}
+	userID := auth.UserIDFromContext(r.Context())
+	if err := s.passkey.DeletePasskey(r.Context(), userID, passkeyID); err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	_ = s.auth.WriteAuditLog(r.Context(), userID, "passkey_delete", r.Header.Get("X-Forwarded-For"), r.Header.Get("User-Agent"), fmt.Sprintf(`{"passkeyId":%q}`, passkeyID))
+	writeJSON(w, http.StatusOK, "ok", map[string]any{"success": true})
+}
diff --git a/backend/internal/api/http.go b/backend/internal/api/http.go
new file mode 100644
index 0000000..021846b
--- /dev/null
+++ b/backend/internal/api/http.go
@@ -0,0 +1,91 @@
+package api
+
+import (
+	"context"
+	"encoding/json"
+	"io"
+	"net/http"
+	"os"
+	"path/filepath"
+	"strings"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+)
+
+const refreshCookieName = "commory_refresh_token"
+
+func readUpload(r *http.Request) ([]byte, string, error) {
+	contentType := r.Header.Get("Content-Type")
+	if strings.Contains(contentType, "multipart/form-data") {
+		if err := r.ParseMultipartForm(32 << 20); err != nil {
+			return nil, "", err
+		}
+		file, header, err := r.FormFile("file")
+		if err != nil {
+			return nil, "", err
+		}
+		defer file.Close()
+		data, err := io.ReadAll(file)
+		return data, header.Filename, err
+	}
+	data, err := io.ReadAll(r.Body)
+	if err != nil {
+		return nil, "", err
+	}
+	return data, "upload.json", nil
+}
+
+func writeJSON(w http.ResponseWriter, status int, msg string, data any) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(status)
+	_ = json.NewEncoder(w).Encode(map[string]any{
+		"code": status,
+		"msg":  msg,
+		"data": data,
+	})
+}
+
+func writeError(w http.ResponseWriter, status int, msg string) {
+	writeJSON(w, status, msg, nil)
+}
+
+func setRefreshCookie(w http.ResponseWriter, token string, secure bool) {
+	expiresAt := time.Now().UTC().Add(auth.RefreshTokenTTL)
+	http.SetCookie(w, &http.Cookie{
+		Name:     refreshCookieName,
+		Value:    token,
+		Path:     "/",
+		MaxAge:   int(auth.RefreshTokenTTL.Seconds()),
+		Expires:  expiresAt,
+		HttpOnly: true,
+		SameSite: http.SameSiteStrictMode,
+		Secure:   secure,
+	})
+}
+
+func clearRefreshCookie(w http.ResponseWriter, secure bool) {
+	http.SetCookie(w, &http.Cookie{
+		Name:     refreshCookieName,
+		Value:    "",
+		Path:     "/",
+		MaxAge:   -1,
+		Expires:  time.Unix(0, 0).UTC(),
+		HttpOnly: true,
+		SameSite: http.SameSiteStrictMode,
+		Secure:   secure,
+	})
+}
+
+func Shutdown(ctx context.Context, srv *http.Server) error {
+	return srv.Shutdown(ctx)
+}
+
+func ensureWebRootIndex(root string) string {
+	return filepath.Join(root, "index.html")
+}
+
+func fileExists(path string) bool {
+	info, err := os.Stat(path)
+	return err == nil && !info.IsDir()
+}
diff --git a/backend/internal/api/imports.go b/backend/internal/api/imports.go
new file mode 100644
index 0000000..31666a3
--- /dev/null
+++ b/backend/internal/api/imports.go
@@ -0,0 +1,182 @@
+package api
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+)
+
+func (s *Server) handleImports(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	userID := auth.UserIDFromContext(r.Context())
+	items, err := s.store.ListImports(r.Context(), userID)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", items)
+}
+
+func (s *Server) handleImportExport(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	path := strings.TrimPrefix(r.URL.Path, "/api/imports/")
+	if !strings.HasSuffix(path, "/export") {
+		writeError(w, http.StatusNotFound, "not found")
+		return
+	}
+	importID := strings.TrimSuffix(path, "/export")
+	importID = strings.TrimSuffix(importID, "/")
+	raw, err := s.store.ExportImport(r.Context(), auth.UserIDFromContext(r.Context()), importID)
+	if err != nil {
+		writeError(w, http.StatusNotFound, err.Error())
+		return
+	}
+	w.Header().Set("Content-Type", "application/json")
+	w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%q", importID+".json"))
+	w.WriteHeader(http.StatusOK)
+	_, _ = w.Write(raw)
+}
+
+func (s *Server) handleImportUpload(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	userID := auth.UserIDFromContext(r.Context())
+	raw, sourceName, err := readUpload(r)
+	if err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	export, raw, err := s.importer.ImportBytes(raw)
+	if err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if err := s.validator.ValidateBytes(raw); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	importID, err := s.store.Import(r.Context(), userID, sourceName, export, raw)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusCreated, "imported", map[string]any{
+		"import_id":        importID,
+		"msglayer_version": export.Version,
+	})
+}
+
+func (s *Server) handleImportPath(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if err := s.requireAdmin(r.Context()); err != nil {
+		writeError(w, http.StatusForbidden, err.Error())
+		return
+	}
+	var req struct {
+		Path string `json:"path"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	resolved, err := s.resolveAllowedPath(req.Path)
+	if err != nil {
+		writeError(w, http.StatusForbidden, err.Error())
+		return
+	}
+	export, raw, err := s.importer.Import(resolved)
+	if err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if err := s.validator.ValidateBytes(raw); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	importID, err := s.store.Import(r.Context(), auth.UserIDFromContext(r.Context()), resolved, export, raw)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusCreated, "imported", map[string]any{
+		"import_id":        importID,
+		"msglayer_version": export.Version,
+	})
+}
+
+func (s *Server) handleValidateUpload(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	raw, _, err := readUpload(r)
+	if err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if err := s.validator.ValidateBytes(raw); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "valid", map[string]any{"valid": true})
+}
+
+func (s *Server) handleValidatePath(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	if err := s.requireAdmin(r.Context()); err != nil {
+		writeError(w, http.StatusForbidden, err.Error())
+		return
+	}
+	var req struct {
+		Path string `json:"path"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	resolved, err := s.resolveAllowedPath(req.Path)
+	if err != nil {
+		writeError(w, http.StatusForbidden, err.Error())
+		return
+	}
+	if err := s.validator.ValidateFile(resolved); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "valid", map[string]any{"valid": true})
+}
+
+func (s *Server) resolveAllowedPath(input string) (string, error) {
+	if strings.TrimSpace(input) == "" {
+		return "", fmt.Errorf("path is required")
+	}
+	resolved, err := filepath.Abs(input)
+	if err != nil {
+		return "", err
+	}
+	for _, root := range s.cfg.AllowedImportDir {
+		if strings.HasPrefix(resolved, root+string(os.PathSeparator)) || resolved == root {
+			return resolved, nil
+		}
+	}
+	return "", fmt.Errorf("path is outside configured import roots")
+}
diff --git a/backend/internal/api/mobile_contract_test.go b/backend/internal/api/mobile_contract_test.go
new file mode 100644
index 0000000..8c1ae6f
--- /dev/null
+++ b/backend/internal/api/mobile_contract_test.go
@@ -0,0 +1,455 @@
+package api
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"path/filepath"
+	"runtime"
+	"testing"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/config"
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+func TestMobileAuthUploadListAndExportContract(t *testing.T) {
+	handler := newTestMobileHandler(t)
+
+	token := registerMobileUser(t, handler, "mobile-user", "mobile@example.com")
+	raw := readFixture(t, "msglayer", "examples", "export.sms-call.json")
+
+	uploadReq := httptest.NewRequest(http.MethodPost, "/api/imports/upload", bytes.NewReader(raw))
+	uploadReq.Header.Set("Authorization", "Bearer "+token)
+	uploadReq.Header.Set("Content-Type", "application/json")
+	uploadRes := httptest.NewRecorder()
+	handler.ServeHTTP(uploadRes, uploadReq)
+	if uploadRes.Code != http.StatusCreated {
+		t.Fatalf("upload status = %d, body = %s", uploadRes.Code, uploadRes.Body.String())
+	}
+	var uploadEnvelope struct {
+		Code int `json:"code"`
+		Data struct {
+			ImportID string `json:"import_id"`
+		} `json:"data"`
+	}
+	decodeJSON(t, uploadRes.Body.Bytes(), &uploadEnvelope)
+	if uploadEnvelope.Data.ImportID == "" {
+		t.Fatal("expected import_id in mobile upload response")
+	}
+
+	listReq := httptest.NewRequest(http.MethodGet, "/api/imports", nil)
+	listReq.Header.Set("Authorization", "Bearer "+token)
+	listRes := httptest.NewRecorder()
+	handler.ServeHTTP(listRes, listReq)
+	if listRes.Code != http.StatusOK {
+		t.Fatalf("list status = %d, body = %s", listRes.Code, listRes.Body.String())
+	}
+	var listEnvelope struct {
+		Code int                     `json:"code"`
+		Data []storage.ImportSummary `json:"data"`
+	}
+	decodeJSON(t, listRes.Body.Bytes(), &listEnvelope)
+	if len(listEnvelope.Data) != 1 {
+		t.Fatalf("expected one import, got %d", len(listEnvelope.Data))
+	}
+
+	exportReq := httptest.NewRequest(http.MethodGet, "/api/imports/"+uploadEnvelope.Data.ImportID+"/export", nil)
+	exportReq.Header.Set("Authorization", "Bearer "+token)
+	exportRes := httptest.NewRecorder()
+	handler.ServeHTTP(exportRes, exportReq)
+	if exportRes.Code != http.StatusOK {
+		t.Fatalf("export status = %d, body = %s", exportRes.Code, exportRes.Body.String())
+	}
+	if !bytes.Contains(exportRes.Body.Bytes(), []byte(`"version"`)) {
+		t.Fatal("expected raw MsgLayer export body")
+	}
+}
+
+func TestMobileImportExportRequiresOwningUser(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	ownerToken := registerMobileUser(t, handler, "owner", "owner@example.com")
+	otherToken := registerMobileUser(t, handler, "other", "other@example.com")
+
+	raw := readFixture(t, "msglayer", "examples", "export.minimal.json")
+	uploadReq := httptest.NewRequest(http.MethodPost, "/api/imports/upload", bytes.NewReader(raw))
+	uploadReq.Header.Set("Authorization", "Bearer "+ownerToken)
+	uploadReq.Header.Set("Content-Type", "application/json")
+	uploadRes := httptest.NewRecorder()
+	handler.ServeHTTP(uploadRes, uploadReq)
+	if uploadRes.Code != http.StatusCreated {
+		t.Fatalf("upload status = %d, body = %s", uploadRes.Code, uploadRes.Body.String())
+	}
+	var uploadEnvelope struct {
+		Data struct {
+			ImportID string `json:"import_id"`
+		} `json:"data"`
+	}
+	decodeJSON(t, uploadRes.Body.Bytes(), &uploadEnvelope)
+
+	exportReq := httptest.NewRequest(http.MethodGet, "/api/imports/"+uploadEnvelope.Data.ImportID+"/export", nil)
+	exportReq.Header.Set("Authorization", "Bearer "+otherToken)
+	exportRes := httptest.NewRecorder()
+	handler.ServeHTTP(exportRes, exportReq)
+	if exportRes.Code != http.StatusNotFound {
+		t.Fatalf("expected non-owner export to be hidden, got %d", exportRes.Code)
+	}
+}
+
+func TestMobileSetupProbeContract(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	req := httptest.NewRequest(http.MethodGet, "/api/setup", nil)
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusOK {
+		t.Fatalf("setup status = %d, body = %s", res.Code, res.Body.String())
+	}
+	var envelope struct {
+		Data struct {
+			DatabaseType string `json:"database_type"`
+		} `json:"data"`
+	}
+	decodeJSON(t, res.Body.Bytes(), &envelope)
+	if envelope.Data.DatabaseType == "" {
+		t.Fatal("expected setup status database_type")
+	}
+}
+
+func TestMobileRefreshRotatesRefreshToken(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	session := registerMobileSession(t, handler, "refresh-user", "refresh@example.com")
+
+	firstRefresh := refreshMobileSession(t, handler, session.RefreshToken)
+	if firstRefresh.RefreshToken == "" || firstRefresh.RefreshToken == session.RefreshToken {
+		t.Fatal("expected refresh token rotation")
+	}
+
+	secondRefresh := refreshMobileSession(t, handler, firstRefresh.RefreshToken)
+	if secondRefresh.RefreshToken == "" || secondRefresh.RefreshToken == firstRefresh.RefreshToken {
+		t.Fatal("expected second refresh token rotation")
+	}
+
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/refresh", nil)
+	req.AddCookie(&http.Cookie{Name: refreshCookieName, Value: session.RefreshToken})
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusUnauthorized {
+		t.Fatalf("expected old refresh token to be rejected, got %d", res.Code)
+	}
+	var envelope struct {
+		Msg string `json:"msg"`
+	}
+	decodeJSON(t, res.Body.Bytes(), &envelope)
+	if envelope.Msg != "ERR_REFRESH_TOKEN_REPLAYED" {
+		t.Fatalf("expected replay error message, got %q", envelope.Msg)
+	}
+}
+
+func TestMobileLogoutRevokesRefreshToken(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	session := registerMobileSession(t, handler, "logout-user", "logout@example.com")
+
+	logoutReq := httptest.NewRequest(http.MethodPost, "/api/auth/logout", nil)
+	logoutReq.AddCookie(&http.Cookie{Name: refreshCookieName, Value: session.RefreshToken})
+	logoutRes := httptest.NewRecorder()
+	handler.ServeHTTP(logoutRes, logoutReq)
+	if logoutRes.Code != http.StatusOK {
+		t.Fatalf("logout status = %d, body = %s", logoutRes.Code, logoutRes.Body.String())
+	}
+	cookieHeader := logoutRes.Header().Get("Set-Cookie")
+	if !bytes.Contains([]byte(cookieHeader), []byte("SameSite=Strict")) {
+		t.Fatalf("expected logout clear cookie to keep SameSite=Strict, got %q", cookieHeader)
+	}
+	if !bytes.Contains([]byte(cookieHeader), []byte("Max-Age=0")) {
+		t.Fatalf("expected logout clear cookie to reset Max-Age, got %q", cookieHeader)
+	}
+	if !bytes.Contains([]byte(cookieHeader), []byte("Expires=")) {
+		t.Fatalf("expected logout clear cookie to include Expires, got %q", cookieHeader)
+	}
+
+	refreshReq := httptest.NewRequest(http.MethodPost, "/api/auth/refresh", nil)
+	refreshReq.AddCookie(&http.Cookie{Name: refreshCookieName, Value: session.RefreshToken})
+	refreshRes := httptest.NewRecorder()
+	handler.ServeHTTP(refreshRes, refreshReq)
+	if refreshRes.Code != http.StatusUnauthorized {
+		t.Fatalf("expected revoked refresh token to fail, got %d", refreshRes.Code)
+	}
+}
+
+func TestMobileSetupInitializeRejectsRepeat(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	payload := mustJSON(t, map[string]string{
+		"userName":        "admin",
+		"password":        "passw0rd!",
+		"confirmPassword": "passw0rd!",
+		"usageMode":       "personal",
+	})
+
+	req := httptest.NewRequest(http.MethodPost, "/api/setup", bytes.NewReader(payload))
+	req.Header.Set("Content-Type", "application/json")
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusOK {
+		t.Fatalf("setup init status = %d, body = %s", res.Code, res.Body.String())
+	}
+
+	repeatReq := httptest.NewRequest(http.MethodPost, "/api/setup", bytes.NewReader(payload))
+	repeatReq.Header.Set("Content-Type", "application/json")
+	repeatRes := httptest.NewRecorder()
+	handler.ServeHTTP(repeatRes, repeatReq)
+	if repeatRes.Code != http.StatusBadRequest {
+		t.Fatalf("expected repeated setup to fail, got %d", repeatRes.Code)
+	}
+}
+
+func TestMobilePasskeyEnrollmentRoutesRequireAuth(t *testing.T) {
+	handler := newTestMobileHandler(t)
+
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/passkey/register/begin", nil)
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusUnauthorized {
+		t.Fatalf("expected unauthenticated passkey begin to fail with 401, got %d", res.Code)
+	}
+
+	session := registerMobileSession(t, handler, "passkey-user", "passkey@example.com")
+	authReq := httptest.NewRequest(http.MethodPost, "/api/auth/passkey/register/begin", nil)
+	authReq.Header.Set("Authorization", "Bearer "+session.Token)
+	authRes := httptest.NewRecorder()
+	handler.ServeHTTP(authRes, authReq)
+	if authRes.Code != http.StatusServiceUnavailable {
+		t.Fatalf("expected authenticated request to reach passkey handler, got %d", authRes.Code)
+	}
+}
+
+func TestMobileSessionsDeleteOthersKeepsCurrentSession(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	current := registerMobileSession(t, handler, "session-user", "session@example.com")
+	other := loginMobileSession(t, handler, "session-user")
+
+	sessions := listMobileSessions(t, handler, current.Token)
+	if len(sessions) != 2 {
+		t.Fatalf("expected 2 sessions, got %d", len(sessions))
+	}
+	currentCount := 0
+	for _, session := range sessions {
+		if session.Current {
+			currentCount++
+		}
+	}
+	if currentCount != 1 {
+		t.Fatalf("expected exactly one current session marker, got %d", currentCount)
+	}
+
+	req := httptest.NewRequest(http.MethodDelete, "/api/sessions", nil)
+	req.Header.Set("Authorization", "Bearer "+current.Token)
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusOK {
+		t.Fatalf("delete others status = %d, body = %s", res.Code, res.Body.String())
+	}
+
+	if _, _, code := tryRefreshMobileSession(t, handler, other.RefreshToken); code != http.StatusUnauthorized {
+		t.Fatalf("expected revoked secondary session refresh to fail, got %d", code)
+	}
+	if _, refreshed, code := tryRefreshMobileSession(t, handler, current.RefreshToken); code != http.StatusOK || refreshed.RefreshToken == "" {
+		t.Fatalf("expected current session refresh to survive, got status=%d refresh=%q", code, refreshed.RefreshToken)
+	}
+}
+
+func TestMobileSessionDeleteRequiresOwnership(t *testing.T) {
+	handler := newTestMobileHandler(t)
+	owner := registerMobileSession(t, handler, "owner-user", "owner-user@example.com")
+	other := registerMobileSession(t, handler, "other-user", "other-user@example.com")
+
+	otherSessions := listMobileSessions(t, handler, other.Token)
+	if len(otherSessions) != 1 {
+		t.Fatalf("expected 1 other session, got %d", len(otherSessions))
+	}
+
+	req := httptest.NewRequest(http.MethodDelete, "/api/sessions/"+otherSessions[0].ID, nil)
+	req.Header.Set("Authorization", "Bearer "+owner.Token)
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusNotFound {
+		t.Fatalf("expected cross-user revoke to be hidden, got %d", res.Code)
+	}
+}
+
+func newTestMobileHandler(t *testing.T) http.Handler {
+	t.Helper()
+	store, err := storage.NewSQLiteProvider(filepath.Join(t.TempDir(), "commory.json"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = store.Close() })
+	if err := store.Init(context.Background()); err != nil {
+		t.Fatal(err)
+	}
+	validator, err := msglayer.NewValidator(repoPath("msglayer", "schema", "v0.1", "root.schema.json"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	server := NewServer(config.Config{AuthSecret: "test-secret", TLS: false}, store, validator)
+	return server.Handler()
+}
+
+func registerMobileUser(t *testing.T, handler http.Handler, userName, email string) string {
+	t.Helper()
+	return registerMobileSession(t, handler, userName, email).Token
+}
+
+type mobileAuthSession struct {
+	Token        string
+	RefreshToken string
+}
+
+type mobileSessionRecord struct {
+	ID      string `json:"id"`
+	Current bool   `json:"current"`
+}
+
+func registerMobileSession(t *testing.T, handler http.Handler, userName, email string) mobileAuthSession {
+	t.Helper()
+	body := map[string]string{
+		"userName": userName,
+		"email":    email,
+		"password": "passw0rd!",
+	}
+	payload, err := json.Marshal(body)
+	if err != nil {
+		t.Fatal(err)
+	}
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/register", bytes.NewReader(payload))
+	req.Header.Set("Content-Type", "application/json")
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusCreated {
+		t.Fatalf("register status = %d, body = %s", res.Code, res.Body.String())
+	}
+	var envelope struct {
+		Data struct {
+			Token string `json:"token"`
+		} `json:"data"`
+	}
+	decodeJSON(t, res.Body.Bytes(), &envelope)
+	refreshToken := readRefreshCookieValue(t, res)
+	if envelope.Data.Token == "" || refreshToken == "" {
+		t.Fatal("expected auth token pair")
+	}
+	return mobileAuthSession{Token: envelope.Data.Token, RefreshToken: refreshToken}
+}
+
+func refreshMobileSession(t *testing.T, handler http.Handler, refreshToken string) mobileAuthSession {
+	t.Helper()
+	res, session, code := tryRefreshMobileSession(t, handler, refreshToken)
+	if code != http.StatusOK {
+		t.Fatalf("refresh status = %d, body = %s", code, res)
+	}
+	return session
+}
+
+func tryRefreshMobileSession(t *testing.T, handler http.Handler, refreshToken string) (string, mobileAuthSession, int) {
+	t.Helper()
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/refresh", nil)
+	req.AddCookie(&http.Cookie{Name: refreshCookieName, Value: refreshToken})
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	var envelope struct {
+		Data struct {
+			Token string `json:"token"`
+		} `json:"data"`
+	}
+	_ = json.Unmarshal(res.Body.Bytes(), &envelope)
+	return res.Body.String(), mobileAuthSession{
+		Token:        envelope.Data.Token,
+		RefreshToken: readRefreshCookieValue(t, res),
+	}, res.Code
+}
+
+func loginMobileSession(t *testing.T, handler http.Handler, userName string) mobileAuthSession {
+	t.Helper()
+	payload := mustJSON(t, map[string]string{
+		"userName": userName,
+		"password": "passw0rd!",
+	})
+	req := httptest.NewRequest(http.MethodPost, "/api/auth/login", bytes.NewReader(payload))
+	req.Header.Set("Content-Type", "application/json")
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusOK {
+		t.Fatalf("login status = %d, body = %s", res.Code, res.Body.String())
+	}
+	var envelope struct {
+		Data struct {
+			Token string `json:"token"`
+		} `json:"data"`
+	}
+	decodeJSON(t, res.Body.Bytes(), &envelope)
+	refreshToken := readRefreshCookieValue(t, res)
+	if envelope.Data.Token == "" || refreshToken == "" {
+		t.Fatal("expected login token pair")
+	}
+	return mobileAuthSession{Token: envelope.Data.Token, RefreshToken: refreshToken}
+}
+
+func listMobileSessions(t *testing.T, handler http.Handler, token string) []mobileSessionRecord {
+	t.Helper()
+	req := httptest.NewRequest(http.MethodGet, "/api/sessions", nil)
+	req.Header.Set("Authorization", "Bearer "+token)
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code != http.StatusOK {
+		t.Fatalf("list sessions status = %d, body = %s", res.Code, res.Body.String())
+	}
+	var envelope struct {
+		Data []mobileSessionRecord `json:"data"`
+	}
+	decodeJSON(t, res.Body.Bytes(), &envelope)
+	return envelope.Data
+}
+
+func mustJSON(t *testing.T, value any) []byte {
+	t.Helper()
+	data, err := json.Marshal(value)
+	if err != nil {
+		t.Fatal(err)
+	}
+	return data
+}
+
+func readFixture(t *testing.T, parts ...string) []byte {
+	t.Helper()
+	data, err := os.ReadFile(repoPath(parts...))
+	if err != nil {
+		t.Fatal(err)
+	}
+	return data
+}
+
+func decodeJSON(t *testing.T, data []byte, target any) {
+	t.Helper()
+	if err := json.Unmarshal(data, target); err != nil {
+		t.Fatalf("decode json: %v\n%s", err, string(data))
+	}
+}
+
+func readRefreshCookieValue(t *testing.T, res *httptest.ResponseRecorder) string {
+	t.Helper()
+	for _, cookie := range res.Result().Cookies() {
+		if cookie.Name == refreshCookieName {
+			return cookie.Value
+		}
+	}
+	return ""
+}
+
+func repoPath(parts ...string) string {
+	_, file, _, _ := runtime.Caller(0)
+	base := filepath.Join(filepath.Dir(file), "..", "..", "..")
+	all := append([]string{base}, parts...)
+	return filepath.Join(all...)
+}
diff --git a/backend/internal/api/query.go b/backend/internal/api/query.go
new file mode 100644
index 0000000..0514d4a
--- /dev/null
+++ b/backend/internal/api/query.go
@@ -0,0 +1,147 @@
+package api
+
+import (
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+func (s *Server) handleDashboard(w http.ResponseWriter, r *http.Request) {
+	userID := auth.UserIDFromContext(r.Context())
+	imports, err := s.store.ListImports(r.Context(), userID)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	identities, err := s.service.Identities(r.Context(), userID)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	events, err := s.service.Timeline(r.Context(), buildSearchParams(r, userID))
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	totalEvents := 0
+	for _, item := range imports {
+		totalEvents += item.EventCount
+	}
+	lastActivity := ""
+	if len(events) > 0 {
+		lastActivity = events[0].Timestamp
+	}
+	writeJSON(w, http.StatusOK, "ok", map[string]any{
+		"importCount":   len(imports),
+		"identityCount": len(identities),
+		"eventCount":    totalEvents,
+		"lastActivity":  lastActivity,
+		"recentImports": takeImports(imports, 5),
+		"recentEvents":  takeEvents(events, 8),
+	})
+}
+
+func (s *Server) handleEvents(w http.ResponseWriter, r *http.Request) {
+	items, err := s.service.Events(r.Context(), buildSearchParams(r, auth.UserIDFromContext(r.Context())))
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", items)
+}
+
+func (s *Server) handleEvent(w http.ResponseWriter, r *http.Request) {
+	id := strings.TrimPrefix(r.URL.Path, "/api/events/")
+	item, err := s.service.Event(r.Context(), auth.UserIDFromContext(r.Context()), id)
+	if err != nil {
+		writeError(w, http.StatusNotFound, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", item)
+}
+
+func (s *Server) handleTimeline(w http.ResponseWriter, r *http.Request) {
+	items, err := s.service.Timeline(r.Context(), buildSearchParams(r, auth.UserIDFromContext(r.Context())))
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", items)
+}
+
+func (s *Server) handleIdentities(w http.ResponseWriter, r *http.Request) {
+	items, err := s.service.Identities(r.Context(), auth.UserIDFromContext(r.Context()))
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", items)
+}
+
+func (s *Server) handleIdentity(w http.ResponseWriter, r *http.Request) {
+	id := strings.TrimPrefix(r.URL.Path, "/api/identities/")
+	item, err := s.service.Identity(r.Context(), auth.UserIDFromContext(r.Context()), id)
+	if err != nil {
+		writeError(w, http.StatusNotFound, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", item)
+}
+
+func (s *Server) handleSearch(w http.ResponseWriter, r *http.Request) {
+	items, err := s.service.Search(r.Context(), buildSearchParams(r, auth.UserIDFromContext(r.Context())))
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", items)
+}
+
+func (s *Server) handleThread(w http.ResponseWriter, r *http.Request) {
+	id := strings.TrimPrefix(r.URL.Path, "/api/threads/")
+	items, err := s.service.Thread(r.Context(), auth.UserIDFromContext(r.Context()), id)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", items)
+}
+
+func buildSearchParams(r *http.Request, userID string) msglayer.SearchParams {
+	q := r.URL.Query()
+	params := msglayer.SearchParams{
+		UserID:      userID,
+		Keyword:     q.Get("q"),
+		ContactID:   q.Get("contact"),
+		Type:        q.Get("type"),
+		Participant: q.Get("participant"),
+		From:        q.Get("from"),
+		To:          q.Get("to"),
+		Limit:       100,
+	}
+	if limit := q.Get("limit"); limit != "" {
+		fmt.Sscanf(limit, "%d", &params.Limit)
+	}
+	if offset := q.Get("offset"); offset != "" {
+		fmt.Sscanf(offset, "%d", &params.Offset)
+	}
+	return params
+}
+
+func takeImports(items []storage.ImportSummary, n int) []storage.ImportSummary {
+	if len(items) <= n {
+		return items
+	}
+	return items[:n]
+}
+
+func takeEvents(items []msglayer.TimelineItem, n int) []msglayer.TimelineItem {
+	if len(items) <= n {
+		return items
+	}
+	return items[:n]
+}
diff --git a/backend/internal/api/server.go b/backend/internal/api/server.go
new file mode 100644
index 0000000..210e23e
--- /dev/null
+++ b/backend/internal/api/server.go
@@ -0,0 +1,95 @@
+package api
+
+import (
+	"net/http"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+	"github.com/IsKenKenYa/Commory/backend/internal/auth/oauth"
+	"github.com/IsKenKenYa/Commory/backend/internal/auth/passkey"
+	"github.com/IsKenKenYa/Commory/backend/internal/config"
+	"github.com/IsKenKenYa/Commory/backend/internal/importers"
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/IsKenKenYa/Commory/backend/internal/query"
+	"github.com/IsKenKenYa/Commory/backend/internal/setup"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+type Server struct {
+	cfg       config.Config
+	store     storage.Provider
+	service   query.Service
+	auth      *auth.Service
+	passkey   *passkey.Service
+	oauth     *oauth.Registry
+	validator *msglayer.Validator
+	importer  importers.Importer
+	setupSvc  *setup.Service
+}
+
+func NewServer(cfg config.Config, store storage.Provider, validator *msglayer.Validator) *Server {
+	authSvc := auth.NewService(store, cfg.AuthSecret)
+
+	var passkeySvc *passkey.Service
+	if cfg.PasskeyRPID != "" && cfg.PasskeyOrigin != "" {
+		passkeySvc, _ = passkey.NewService(store, cfg.PasskeyRPName, cfg.PasskeyRPID, cfg.PasskeyOrigin)
+	}
+
+	return &Server{
+		cfg:       cfg,
+		store:     store,
+		service:   query.New(store),
+		auth:      authSvc,
+		passkey:   passkeySvc,
+		oauth:     oauth.NewRegistry(),
+		validator: validator,
+		importer:  importers.JSONImporter{},
+		setupSvc:  setup.NewService(store, authSvc),
+	}
+}
+
+func (s *Server) Handler() http.Handler {
+	publicMux := http.NewServeMux()
+	publicMux.HandleFunc("/api/auth/register", s.handleRegister)
+	publicMux.HandleFunc("/api/auth/login", s.handleLogin)
+	publicMux.HandleFunc("/api/auth/refresh", s.handleRefresh)
+	publicMux.HandleFunc("/api/auth/logout", s.handleLogout)
+	publicMux.HandleFunc("/api/setup", s.handleSetup)
+	publicMux.HandleFunc("/api/auth/passkey/login/begin", s.handlePasskeyLoginBegin)
+	publicMux.HandleFunc("/api/auth/passkey/login/finish", s.handlePasskeyLoginFinish)
+	publicMux.HandleFunc("/api/oauth/state", s.handleOAuthState)
+	publicMux.HandleFunc("/api/oauth/providers", s.handleOAuthProviders)
+	publicMux.HandleFunc("/api/oauth/", s.handleOAuthCallback)
+
+	privateMux := http.NewServeMux()
+	privateMux.HandleFunc("/api/user/info", s.handleUserInfo)
+	privateMux.HandleFunc("/api/imports", s.handleImports)
+	privateMux.HandleFunc("/api/imports/", s.handleImportExport)
+	privateMux.HandleFunc("/api/imports/upload", s.handleImportUpload)
+	privateMux.HandleFunc("/api/imports/path", s.handleImportPath)
+	privateMux.HandleFunc("/api/validate/upload", s.handleValidateUpload)
+	privateMux.HandleFunc("/api/validate/path", s.handleValidatePath)
+	privateMux.HandleFunc("/api/dashboard", s.handleDashboard)
+	privateMux.HandleFunc("/api/events", s.handleEvents)
+	privateMux.HandleFunc("/api/events/", s.handleEvent)
+	privateMux.HandleFunc("/api/timeline", s.handleTimeline)
+	privateMux.HandleFunc("/api/identities", s.handleIdentities)
+	privateMux.HandleFunc("/api/identities/", s.handleIdentity)
+	privateMux.HandleFunc("/api/search", s.handleSearch)
+	privateMux.HandleFunc("/api/threads/", s.handleThread)
+	privateMux.HandleFunc("/api/sessions", s.handleSessions)
+	privateMux.HandleFunc("/api/sessions/", s.handleSession)
+	privateMux.HandleFunc("/api/audit-log", s.handleAuditLogs)
+
+	root := http.NewServeMux()
+	root.Handle("/api/auth/passkey/register/begin", auth.Middleware(s.auth, http.HandlerFunc(s.handlePasskeyRegisterBegin)))
+	root.Handle("/api/auth/passkey/register/finish", auth.Middleware(s.auth, http.HandlerFunc(s.handlePasskeyRegisterFinish)))
+	root.Handle("/api/auth/passkey", auth.Middleware(s.auth, http.HandlerFunc(s.handlePasskeys)))
+	root.Handle("/api/auth/passkey/", auth.Middleware(s.auth, http.HandlerFunc(s.handlePasskeyDelete)))
+	root.Handle("/api/auth/", publicMux)
+	root.Handle("/api/setup", publicMux)
+	root.Handle("/api/", auth.Middleware(s.auth, privateMux))
+	if s.cfg.WebRoot != "" {
+		root.Handle("/", spaHandler(s.cfg.WebRoot))
+	}
+	return root
+}
diff --git a/backend/internal/api/sessions.go b/backend/internal/api/sessions.go
new file mode 100644
index 0000000..d252c53
--- /dev/null
+++ b/backend/internal/api/sessions.go
@@ -0,0 +1,110 @@
+package api
+
+import (
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+type sessionResponse struct {
+	ID         string `json:"id"`
+	DeviceName string `json:"device_name"`
+	DeviceType string `json:"device_type"`
+	IPAddress  string `json:"ip_address"`
+	UserAgent  string `json:"user_agent"`
+	CreatedAt  string `json:"created_at"`
+	LastSeenAt string `json:"last_seen_at"`
+	Current    bool   `json:"current"`
+}
+
+func (s *Server) handleSessions(w http.ResponseWriter, r *http.Request) {
+	userID := auth.UserIDFromContext(r.Context())
+	currentSessionID := auth.SessionIDFromContext(r.Context())
+	switch r.Method {
+	case http.MethodGet:
+		sessions, err := s.store.ListSessionsByUser(r.Context(), userID)
+		if err != nil {
+			writeError(w, http.StatusInternalServerError, err.Error())
+			return
+		}
+		result := make([]sessionResponse, 0, len(sessions))
+		for _, session := range sessions {
+			result = append(result, toSessionResponse(session, currentSessionID))
+		}
+		writeJSON(w, http.StatusOK, "ok", result)
+	case http.MethodDelete:
+		if currentSessionID == "" {
+			writeError(w, http.StatusBadRequest, "current session unavailable")
+			return
+		}
+		sessions, err := s.store.ListSessionsByUser(r.Context(), userID)
+		if err != nil {
+			writeError(w, http.StatusInternalServerError, err.Error())
+			return
+		}
+		for _, session := range sessions {
+			if session.ID == currentSessionID {
+				continue
+			}
+			if session.RefreshTokenID != "" {
+				_ = s.store.RevokeRefreshTokenByID(r.Context(), session.RefreshTokenID)
+			}
+		}
+		if err := s.store.RevokeOtherSessions(r.Context(), userID, currentSessionID); err != nil {
+			writeError(w, http.StatusInternalServerError, err.Error())
+			return
+		}
+		_ = s.auth.WriteAuditLog(r.Context(), userID, "sessions_revoke_other", r.Header.Get("X-Forwarded-For"), r.Header.Get("User-Agent"), "")
+		writeJSON(w, http.StatusOK, "ok", map[string]any{"success": true})
+	default:
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+	}
+}
+
+func (s *Server) handleSession(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodDelete {
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+		return
+	}
+	sessionID := strings.TrimPrefix(r.URL.Path, "/api/sessions/")
+	if sessionID == "" {
+		writeError(w, http.StatusBadRequest, "session id required")
+		return
+	}
+	userID := auth.UserIDFromContext(r.Context())
+	session, err := s.store.GetSession(r.Context(), sessionID)
+	if err != nil || session.UserID != userID {
+		writeError(w, http.StatusNotFound, "session not found")
+		return
+	}
+	if session.RefreshTokenID != "" {
+		_ = s.store.RevokeRefreshTokenByID(r.Context(), session.RefreshTokenID)
+	}
+	if err := s.store.RevokeSession(r.Context(), sessionID); err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	if sessionID == auth.SessionIDFromContext(r.Context()) {
+		clearRefreshCookie(w, s.cfg.TLS)
+	}
+	_ = s.auth.WriteAuditLog(r.Context(), userID, "session_revoke", r.Header.Get("X-Forwarded-For"), r.Header.Get("User-Agent"), fmt.Sprintf(`{"sessionId":%q}`, sessionID))
+	writeJSON(w, http.StatusOK, "ok", map[string]any{"success": true})
+}
+
+func toSessionResponse(session storage.SessionRecord, currentSessionID string) sessionResponse {
+	return sessionResponse{
+		ID:         session.ID,
+		DeviceName: session.DeviceName,
+		DeviceType: session.DeviceType,
+		IPAddress:  session.IPAddress,
+		UserAgent:  session.UserAgent,
+		CreatedAt:  session.CreatedAt.Format(timeFormatRFC3339),
+		LastSeenAt: session.LastSeenAt.Format(timeFormatRFC3339),
+		Current:    session.ID == currentSessionID,
+	}
+}
+
+const timeFormatRFC3339 = "2006-01-02T15:04:05Z07:00"
diff --git a/backend/internal/api/setup.go b/backend/internal/api/setup.go
new file mode 100644
index 0000000..cb43d61
--- /dev/null
+++ b/backend/internal/api/setup.go
@@ -0,0 +1,41 @@
+package api
+
+import (
+	"encoding/json"
+	"net/http"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/setup"
+)
+
+func (s *Server) handleSetup(w http.ResponseWriter, r *http.Request) {
+	switch r.Method {
+	case http.MethodGet:
+		s.handleGetSetup(w, r)
+	case http.MethodPost:
+		s.handlePostSetup(w, r)
+	default:
+		writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+	}
+}
+
+func (s *Server) handleGetSetup(w http.ResponseWriter, r *http.Request) {
+	status, err := s.setupSvc.GetStatus(r.Context())
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "ok", status)
+}
+
+func (s *Server) handlePostSetup(w http.ResponseWriter, r *http.Request) {
+	var req setup.SetupRequest
+	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	if err := s.setupSvc.Initialize(r.Context(), req); err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	writeJSON(w, http.StatusOK, "initialized", map[string]any{"success": true})
+}
diff --git a/backend/internal/api/spa.go b/backend/internal/api/spa.go
new file mode 100644
index 0000000..fc63687
--- /dev/null
+++ b/backend/internal/api/spa.go
@@ -0,0 +1,30 @@
+package api
+
+import (
+	"net/http"
+	"os"
+	urlpath "path"
+	"path/filepath"
+	"strings"
+)
+
+func spaHandler(root string) http.Handler {
+	fileServer := http.FileServer(http.Dir(root))
+	indexPath := ensureWebRootIndex(root)
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.Method != http.MethodGet && r.Method != http.MethodHead {
+			writeError(w, http.StatusMethodNotAllowed, "method not allowed")
+			return
+		}
+		cleanPath := strings.TrimPrefix(urlpath.Clean("/"+r.URL.Path), "/")
+		if cleanPath == "" {
+			cleanPath = "index.html"
+		}
+		targetPath := filepath.Join(root, filepath.FromSlash(cleanPath))
+		if info, err := os.Stat(targetPath); err == nil && !info.IsDir() {
+			fileServer.ServeHTTP(w, r)
+			return
+		}
+		http.ServeFile(w, r, indexPath)
+	})
+}
diff --git a/backend/internal/api/static_web_test.go b/backend/internal/api/static_web_test.go
new file mode 100644
index 0000000..024867a
--- /dev/null
+++ b/backend/internal/api/static_web_test.go
@@ -0,0 +1,106 @@
+package api
+
+import (
+	"context"
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/config"
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+func TestServerServesWebRootAndKeepsAPI(t *testing.T) {
+	handler := newTestWebHandler(t)
+
+	setupReq := httptest.NewRequest(http.MethodGet, "/api/setup", nil)
+	setupRes := httptest.NewRecorder()
+	handler.ServeHTTP(setupRes, setupReq)
+	if setupRes.Code != http.StatusOK {
+		t.Fatalf("setup status = %d, body = %s", setupRes.Code, setupRes.Body.String())
+	}
+	if strings.Contains(setupRes.Body.String(), "<div id=\"app\">") {
+		t.Fatal("api response unexpectedly returned web index")
+	}
+
+	indexReq := httptest.NewRequest(http.MethodGet, "/", nil)
+	indexRes := httptest.NewRecorder()
+	handler.ServeHTTP(indexRes, indexReq)
+	if indexRes.Code != http.StatusOK {
+		t.Fatalf("index status = %d, body = %s", indexRes.Code, indexRes.Body.String())
+	}
+	if !strings.Contains(indexRes.Body.String(), "<div id=\"app\">") {
+		t.Fatal("expected web index body")
+	}
+}
+
+func TestServerServesAssetsAndFallsBackToSPA(t *testing.T) {
+	handler := newTestWebHandler(t)
+
+	assetReq := httptest.NewRequest(http.MethodGet, "/assets/app.js", nil)
+	assetRes := httptest.NewRecorder()
+	handler.ServeHTTP(assetRes, assetReq)
+	if assetRes.Code != http.StatusOK {
+		t.Fatalf("asset status = %d, body = %s", assetRes.Code, assetRes.Body.String())
+	}
+	if !strings.Contains(assetRes.Body.String(), "commory asset") {
+		t.Fatal("expected asset body")
+	}
+
+	routeReq := httptest.NewRequest(http.MethodGet, "/dashboard/console", nil)
+	routeRes := httptest.NewRecorder()
+	handler.ServeHTTP(routeRes, routeReq)
+	if routeRes.Code != http.StatusOK {
+		t.Fatalf("spa route status = %d, body = %s", routeRes.Code, routeRes.Body.String())
+	}
+	if !strings.Contains(routeRes.Body.String(), "<div id=\"app\">") {
+		t.Fatal("expected spa fallback index body")
+	}
+}
+
+func TestAPINotFoundDoesNotFallbackToWeb(t *testing.T) {
+	handler := newTestWebHandler(t)
+
+	req := httptest.NewRequest(http.MethodGet, "/api/not-found", nil)
+	res := httptest.NewRecorder()
+	handler.ServeHTTP(res, req)
+	if res.Code == http.StatusOK {
+		t.Fatalf("expected api not-found/auth failure, got %d with body %s", res.Code, res.Body.String())
+	}
+	if strings.Contains(res.Body.String(), "<div id=\"app\">") {
+		t.Fatal("api route unexpectedly fell back to web index")
+	}
+}
+
+func newTestWebHandler(t *testing.T) http.Handler {
+	t.Helper()
+	webRoot := t.TempDir()
+	if err := os.Mkdir(filepath.Join(webRoot, "assets"), 0o755); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(webRoot, "index.html"), []byte(`<!doctype html><div id="app"></div>`), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := os.WriteFile(filepath.Join(webRoot, "assets", "app.js"), []byte(`console.log("commory asset")`), 0o644); err != nil {
+		t.Fatal(err)
+	}
+
+	store, err := storage.NewSQLiteProvider(filepath.Join(t.TempDir(), "commory.json"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { _ = store.Close() })
+	if err := store.Init(context.Background()); err != nil {
+		t.Fatal(err)
+	}
+	validator, err := msglayer.NewValidator(repoPath("msglayer", "schema", "v0.1", "root.schema.json"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	server := NewServer(config.Config{AuthSecret: "test-secret", TLS: false, WebRoot: webRoot}, store, validator)
+	return server.Handler()
+}
diff --git a/backend/internal/auth/audit_rate_limit.go b/backend/internal/auth/audit_rate_limit.go
new file mode 100644
index 0000000..bff7059
--- /dev/null
+++ b/backend/internal/auth/audit_rate_limit.go
@@ -0,0 +1,62 @@
+package auth
+
+import (
+	"context"
+	"net"
+	"strings"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+func detectDeviceType(userAgent string) string {
+	ua := strings.ToLower(userAgent)
+	switch {
+	case strings.Contains(ua, "commory"):
+		return "android"
+	case strings.Contains(ua, "mozilla") || strings.Contains(ua, "chrome") || strings.Contains(ua, "safari"):
+		return "web"
+	default:
+		return "unknown"
+	}
+}
+
+func (s *Service) writeAuditLog(ctx context.Context, userID, action, ipAddress, userAgent, detail string) error {
+	return s.store.CreateAuditLog(ctx, storage.AuditRecord{
+		ID:        randomID("audit"),
+		UserID:    userID,
+		Action:    action,
+		IPAddress: ipAddress,
+		UserAgent: userAgent,
+		Detail:    detail,
+		CreatedAt: time.Now().UTC(),
+	})
+}
+
+func (s *Service) WriteAuditLog(ctx context.Context, userID, action, ipAddress, userAgent, detail string) error {
+	return s.writeAuditLog(ctx, userID, action, ipAddress, userAgent, detail)
+}
+
+func (s *Service) allowLoginAttempt(remoteAddr string) error {
+	s.loginMu.Lock()
+	defer s.loginMu.Unlock()
+
+	host, _, err := net.SplitHostPort(remoteAddr)
+	if err != nil {
+		host = remoteAddr
+	}
+	now := time.Now()
+	cutoff := now.Add(-time.Minute)
+	window := s.loginWindow[host][:0]
+	for _, ts := range s.loginWindow[host] {
+		if ts.After(cutoff) {
+			window = append(window, ts)
+		}
+	}
+	if len(window) >= 5 {
+		s.loginWindow[host] = window
+		return ErrTooManyLoginAttempts
+	}
+	s.loginWindow[host] = append(window, now)
+	return nil
+}
diff --git a/backend/internal/auth/errors.go b/backend/internal/auth/errors.go
new file mode 100644
index 0000000..58ee2b0
--- /dev/null
+++ b/backend/internal/auth/errors.go
@@ -0,0 +1,47 @@
+package auth
+
+type codeError string
+
+func (e codeError) Error() string {
+	return string(e)
+}
+
+const (
+	ErrInvalidRequest          = codeError("ERR_INVALID_REQUEST")
+	ErrUnauthorized            = codeError("ERR_UNAUTHORIZED")
+	ErrInvalidCredentials      = codeError("ERR_INVALID_CREDENTIALS")
+	ErrUsernameExists          = codeError("ERR_USERNAME_EXISTS")
+	ErrUsernamePasswordMissing = codeError("ERR_USERNAME_PASSWORD_REQUIRED")
+	ErrTooManyLoginAttempts    = codeError("ERR_TOO_MANY_LOGIN_ATTEMPTS")
+	ErrRefreshTokenRequired    = codeError("ERR_REFRESH_TOKEN_REQUIRED")
+	ErrRefreshTokenExpired     = codeError("ERR_REFRESH_TOKEN_EXPIRED")
+	ErrRefreshTokenReplayed    = codeError("ERR_REFRESH_TOKEN_REPLAYED")
+	ErrRefreshTokenRetry       = codeError("ERR_REFRESH_TOKEN_RETRY")
+	ErrPasskeyChallengeExpired = codeError("ERR_PASSKEY_CHALLENGE_EXPIRED")
+	ErrPasskeyInvalidResponse  = codeError("ERR_PASSKEY_INVALID_RESPONSE")
+	ErrPasskeyVerification     = codeError("ERR_PASSKEY_VERIFICATION_FAILED")
+	ErrOperationFailed         = codeError("ERR_OPERATION_FAILED")
+)
+
+func PublicErrorCode(err error) string {
+	switch err {
+	case nil:
+		return ""
+	case ErrInvalidRequest,
+		ErrUnauthorized,
+		ErrInvalidCredentials,
+		ErrUsernameExists,
+		ErrUsernamePasswordMissing,
+		ErrTooManyLoginAttempts,
+		ErrRefreshTokenRequired,
+		ErrRefreshTokenExpired,
+		ErrRefreshTokenReplayed,
+		ErrRefreshTokenRetry,
+		ErrPasskeyChallengeExpired,
+		ErrPasskeyInvalidResponse,
+		ErrPasskeyVerification:
+		return err.Error()
+	default:
+		return ErrOperationFailed.Error()
+	}
+}
diff --git a/backend/internal/auth/middleware.go b/backend/internal/auth/middleware.go
new file mode 100644
index 0000000..64e647a
--- /dev/null
+++ b/backend/internal/auth/middleware.go
@@ -0,0 +1,51 @@
+package auth
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+)
+
+type contextKey string
+
+const userIDContextKey contextKey = "commory.user_id"
+const sessionIDContextKey contextKey = "commory.session_id"
+
+func UserIDFromContext(ctx context.Context) string {
+	if value, ok := ctx.Value(userIDContextKey).(string); ok {
+		return value
+	}
+	return ""
+}
+
+func SessionIDFromContext(ctx context.Context) string {
+	if value, ok := ctx.Value(sessionIDContextKey).(string); ok {
+		return value
+	}
+	return ""
+}
+
+func Middleware(service *Service, next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		claims, err := service.AuthenticateRequest(r.Context(), r.Header.Get("Authorization"))
+		if err != nil {
+			writeUnauthorized(w)
+			return
+		}
+		ctx := context.WithValue(r.Context(), userIDContextKey, claims.UserID)
+		if claims.SessionID != "" {
+			ctx = context.WithValue(ctx, sessionIDContextKey, claims.SessionID)
+		}
+		next.ServeHTTP(w, r.WithContext(ctx))
+	})
+}
+
+func writeUnauthorized(w http.ResponseWriter) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(http.StatusUnauthorized)
+	_ = json.NewEncoder(w).Encode(map[string]any{
+		"code": http.StatusUnauthorized,
+		"msg":  ErrUnauthorized.Error(),
+		"data": nil,
+	})
+}
diff --git a/backend/internal/auth/model.go b/backend/internal/auth/model.go
new file mode 100644
index 0000000..75603e5
--- /dev/null
+++ b/backend/internal/auth/model.go
@@ -0,0 +1,14 @@
+package auth
+
+type TokenPair struct {
+	AccessToken  string `json:"token"`
+	RefreshToken string `json:"refreshToken"`
+}
+
+type UserInfo struct {
+	Buttons  []string `json:"buttons"`
+	Roles    []string `json:"roles"`
+	UserID   string   `json:"userId"`
+	UserName string   `json:"userName"`
+	Email    string   `json:"email"`
+}
diff --git a/backend/internal/auth/oauth/provider.go b/backend/internal/auth/oauth/provider.go
new file mode 100644
index 0000000..8a07cbe
--- /dev/null
+++ b/backend/internal/auth/oauth/provider.go
@@ -0,0 +1,37 @@
+package oauth
+
+import "context"
+
+// Provider 定义 OAuth 身份提供者的接口。
+// 具体实现（GitHub、Google、OIDC 等）在后续 Phase 中添加。
+type Provider interface {
+	// Name 返回 provider 的唯一标识，如 "github", "google", "oidc"
+	Name() string
+	// DisplayName 返回用户可读的名称，如 "GitHub", "Google"
+	DisplayName() string
+	// IsEnabled 检查该 provider 的配置是否完整
+	IsEnabled() bool
+	// ExchangeCode 用授权码换取 access token
+	ExchangeCode(ctx context.Context, code string) (*Token, error)
+	// GetUserInfo 用 access token 获取用户信息
+	GetUserInfo(ctx context.Context, token *Token) (*UserInfo, error)
+}
+
+// Token 表示 OAuth token 响应
+type Token struct {
+	AccessToken  string
+	TokenType    string
+	RefreshToken string
+	ExpiresIn    int64
+	IDToken      string // OIDC
+}
+
+// UserInfo 表示从 OAuth provider 获取的用户信息
+type UserInfo struct {
+	ProviderUserID string            // provider 内的用户唯一标识
+	Username       string            // 用户名
+	DisplayName    string            // 显示名
+	Email          string            // 邮箱
+	AvatarURL      string            // 头像
+	Raw            map[string]any    // provider 特有的原始信息
+}
diff --git a/backend/internal/auth/oauth/registry.go b/backend/internal/auth/oauth/registry.go
new file mode 100644
index 0000000..915b7a8
--- /dev/null
+++ b/backend/internal/auth/oauth/registry.go
@@ -0,0 +1,52 @@
+package oauth
+
+import "sync"
+
+// Registry 管理所有已注册的 OAuth Provider。
+type Registry struct {
+	mu        sync.RWMutex
+	providers map[string]Provider
+}
+
+// NewRegistry 创建一个空的 Provider 注册表。
+func NewRegistry() *Registry {
+	return &Registry{providers: make(map[string]Provider)}
+}
+
+// Register 注册一个 OAuth Provider。
+func (r *Registry) Register(p Provider) {
+	r.mu.Lock()
+	defer r.mu.Unlock()
+	r.providers[p.Name()] = p
+}
+
+// Get 按名称获取 Provider，不存在返回 nil。
+func (r *Registry) Get(name string) Provider {
+	r.mu.RLock()
+	defer r.mu.RUnlock()
+	return r.providers[name]
+}
+
+// ListEnabled 返回所有已启用的 Provider 列表。
+func (r *Registry) ListEnabled() []Provider {
+	r.mu.RLock()
+	defer r.mu.RUnlock()
+	var result []Provider
+	for _, p := range r.providers {
+		if p.IsEnabled() {
+			result = append(result, p)
+		}
+	}
+	return result
+}
+
+// ListAll 返回所有已注册的 Provider（包括未启用的）。
+func (r *Registry) ListAll() []Provider {
+	r.mu.RLock()
+	defer r.mu.RUnlock()
+	result := make([]Provider, 0, len(r.providers))
+	for _, p := range r.providers {
+		result = append(result, p)
+	}
+	return result
+}
diff --git a/backend/internal/auth/passkey/encoding.go b/backend/internal/auth/passkey/encoding.go
new file mode 100644
index 0000000..8d99e74
--- /dev/null
+++ b/backend/internal/auth/passkey/encoding.go
@@ -0,0 +1,20 @@
+package passkey
+
+import "encoding/base64"
+
+func encodeStoredBytes(raw []byte) string {
+	return base64.RawURLEncoding.EncodeToString(raw)
+}
+
+func decodeStoredBytes(value string) []byte {
+	if value == "" {
+		return nil
+	}
+	if decoded, err := base64.RawURLEncoding.DecodeString(value); err == nil {
+		return decoded
+	}
+	if decoded, err := base64.StdEncoding.DecodeString(value); err == nil {
+		return decoded
+	}
+	return []byte(value)
+}
diff --git a/backend/internal/auth/passkey/service.go b/backend/internal/auth/passkey/service.go
new file mode 100644
index 0000000..9b48ae4
--- /dev/null
+++ b/backend/internal/auth/passkey/service.go
@@ -0,0 +1,206 @@
+package passkey
+
+import (
+	"context"
+	"crypto/rand"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+	"github.com/go-webauthn/webauthn/protocol"
+	"github.com/go-webauthn/webauthn/webauthn"
+)
+
+type Service struct {
+	store storage.Provider
+	wa    *webauthn.WebAuthn
+}
+
+func NewService(store storage.Provider, rpName, rpID, origin string) (*Service, error) {
+	wa, err := webauthn.New(&webauthn.Config{
+		RPDisplayName: rpName,
+		RPID:          rpID,
+		RPOrigins:     []string{origin},
+		AuthenticatorSelection: protocol.AuthenticatorSelection{
+			ResidentKey: protocol.ResidentKeyRequirementRequired,
+		},
+		Timeouts: webauthn.TimeoutsConfig{
+			Login:        webauthn.TimeoutConfig{Timeout: 120 * time.Second},
+			Registration: webauthn.TimeoutConfig{Timeout: 120 * time.Second},
+		},
+	})
+	if err != nil {
+		return nil, fmt.Errorf("init webauthn: %w", err)
+	}
+	return &Service{store: store, wa: wa}, nil
+}
+
+func (s *Service) BeginRegistration(ctx context.Context, userID string) (*protocol.CredentialCreation, string, error) {
+	user, err := s.store.GetUser(ctx, userID)
+	if err != nil {
+		return nil, "", err
+	}
+
+	existingCreds, _ := s.store.ListPasskeysByUser(ctx, userID)
+	waUser := NewWebAuthnUser(user, existingCreds)
+
+	var opts []webauthn.RegistrationOption
+	if len(existingCreds) > 0 {
+		excludeCreds := make([]protocol.CredentialDescriptor, 0, len(existingCreds))
+		for _, c := range existingCreds {
+			excludeCreds = append(excludeCreds, protocol.CredentialDescriptor{
+				Type:         protocol.PublicKeyCredentialType,
+				CredentialID: decodeStoredBytes(c.CredentialID),
+			})
+		}
+		opts = append(opts, webauthn.WithExclusions(excludeCreds))
+	}
+
+	cc, sessionData, err := s.wa.BeginRegistration(waUser, opts...)
+	if err != nil {
+		return nil, "", err
+	}
+
+	sessionJSON, _ := json.Marshal(sessionData)
+	challengeID := randomID("chal")
+	if err := s.store.CreateChallenge(ctx, storage.ChallengeRecord{
+		ID:        challengeID,
+		Challenge: encodeStoredBytes(sessionJSON),
+		UserID:    userID,
+		FlowType:  "passkey_register",
+		ExpiresAt: time.Now().UTC().Add(5 * time.Minute),
+	}); err != nil {
+		return nil, "", err
+	}
+
+	return cc, challengeID, nil
+}
+
+func (s *Service) FinishRegistration(ctx context.Context, userID, challengeID string, response *protocol.ParsedCredentialCreationData) error {
+	chal, err := s.store.GetChallenge(ctx, challengeID)
+	if err != nil {
+		return auth.ErrPasskeyChallengeExpired
+	}
+	_ = s.store.DeleteChallenge(ctx, challengeID)
+
+	var sessionData webauthn.SessionData
+	sessionJSON := decodeStoredBytes(chal.Challenge)
+	if err := json.Unmarshal(sessionJSON, &sessionData); err != nil {
+		return auth.ErrOperationFailed
+	}
+
+	user, err := s.store.GetUser(ctx, userID)
+	if err != nil {
+		return err
+	}
+	existingCreds, _ := s.store.ListPasskeysByUser(ctx, userID)
+	waUser := NewWebAuthnUser(user, existingCreds)
+
+	credential, err := s.wa.CreateCredential(waUser, sessionData, response)
+	if err != nil {
+		return auth.ErrPasskeyVerification
+	}
+
+	transportsJSON, _ := json.Marshal(response.Response.Transports)
+	credentialRecord := storage.PasskeyCredential{
+		ID:              randomID("pk"),
+		UserID:          userID,
+		CredentialID:    encodeStoredBytes(credential.ID),
+		PublicKey:       encodeStoredBytes(credential.PublicKey),
+		AttestationType: credential.AttestationType,
+		AAGUID:          encodeStoredBytes(credential.Authenticator.AAGUID),
+		SignCount:       credential.Authenticator.SignCount,
+		Transports:      string(transportsJSON),
+		Name:            fmt.Sprintf("Passkey %s", time.Now().Format("2006-01-02")),
+		CreatedAt:       time.Now().UTC(),
+	}
+	if err := s.store.CreatePasskeyCredential(ctx, credentialRecord); err != nil {
+		return err
+	}
+	return s.store.CreateAuthMethod(ctx, storage.AuthMethodRecord{
+		ID:             randomID("auth"),
+		UserID:         userID,
+		ProviderType:   "passkey",
+		ProviderUserID: credentialRecord.CredentialID,
+		Metadata:       fmt.Sprintf(`{"passkeyId":%q,"name":%q}`, credentialRecord.ID, credentialRecord.Name),
+		CreatedAt:      time.Now().UTC(),
+		UpdatedAt:      time.Now().UTC(),
+	})
+}
+
+func (s *Service) BeginLogin(ctx context.Context) (*protocol.CredentialAssertion, string, error) {
+	// Discoverable login - 不需要预先知道用户
+	assertion, sessionData, err := s.wa.BeginDiscoverableLogin()
+	if err != nil {
+		return nil, "", err
+	}
+
+	sessionJSON, _ := json.Marshal(sessionData)
+	challengeID := randomID("chal")
+	if err := s.store.CreateChallenge(ctx, storage.ChallengeRecord{
+		ID:        challengeID,
+		Challenge: encodeStoredBytes(sessionJSON),
+		FlowType:  "passkey_login",
+		ExpiresAt: time.Now().UTC().Add(5 * time.Minute),
+	}); err != nil {
+		return nil, "", err
+	}
+
+	return assertion, challengeID, nil
+}
+
+func (s *Service) FinishLogin(ctx context.Context, challengeID string, response *protocol.ParsedCredentialAssertionData) (string, error) {
+	chal, err := s.store.GetChallenge(ctx, challengeID)
+	if err != nil {
+		return "", auth.ErrPasskeyChallengeExpired
+	}
+	_ = s.store.DeleteChallenge(ctx, challengeID)
+
+	var sessionData webauthn.SessionData
+	sessionJSON := decodeStoredBytes(chal.Challenge)
+	if err := json.Unmarshal(sessionJSON, &sessionData); err != nil {
+		return "", auth.ErrOperationFailed
+	}
+
+	handler := func(rawID, userHandle []byte) (webauthn.User, error) {
+		credID := encodeStoredBytes(rawID)
+		cred, err := s.store.GetPasskeyByCredentialID(ctx, credID)
+		if err != nil {
+			return nil, errors.New("credential not found")
+		}
+		user, err := s.store.GetUser(ctx, cred.UserID)
+		if err != nil {
+			return nil, errors.New("user not found")
+		}
+		creds, _ := s.store.ListPasskeysByUser(ctx, user.ID)
+		return NewWebAuthnUser(user, creds), nil
+	}
+
+	credential, err := s.wa.ValidateDiscoverableLogin(handler, sessionData, response)
+	if err != nil {
+		return "", auth.ErrPasskeyVerification
+	}
+
+	credID := encodeStoredBytes(credential.ID)
+	cred, _ := s.store.GetPasskeyByCredentialID(ctx, credID)
+	_ = s.store.UpdatePasskeyLastUsed(ctx, cred.ID, credential.Authenticator.SignCount)
+
+	return cred.UserID, nil
+}
+
+func (s *Service) ListPasskeys(ctx context.Context, userID string) ([]storage.PasskeyCredential, error) {
+	return s.store.ListPasskeysByUser(ctx, userID)
+}
+
+func (s *Service) DeletePasskey(ctx context.Context, userID, passkeyID string) error {
+	return s.store.DeletePasskey(ctx, passkeyID, userID)
+}
+
+func randomID(prefix string) string {
+	raw := make([]byte, 8)
+	_, _ = rand.Read(raw)
+	return fmt.Sprintf("%s_%x", prefix, raw)
+}
diff --git a/backend/internal/auth/passkey/user.go b/backend/internal/auth/passkey/user.go
new file mode 100644
index 0000000..54ab619
--- /dev/null
+++ b/backend/internal/auth/passkey/user.go
@@ -0,0 +1,52 @@
+package passkey
+
+import (
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+	"github.com/go-webauthn/webauthn/webauthn"
+)
+
+type WebAuthnUser struct {
+	user        storage.UserRecord
+	credentials []webauthn.Credential
+}
+
+func NewWebAuthnUser(user storage.UserRecord, creds []storage.PasskeyCredential) *WebAuthnUser {
+	waCreds := make([]webauthn.Credential, 0, len(creds))
+	for _, c := range creds {
+		waCred := webauthn.Credential{
+			ID:              decodeStoredBytes(c.CredentialID),
+			PublicKey:       decodeStoredBytes(c.PublicKey),
+			AttestationType: c.AttestationType,
+			Authenticator: webauthn.Authenticator{
+				AAGUID:       decodeStoredBytes(c.AAGUID),
+				SignCount:    c.SignCount,
+				CloneWarning: false,
+			},
+		}
+		waCreds = append(waCreds, waCred)
+	}
+	return &WebAuthnUser{user: user, credentials: waCreds}
+}
+
+func (u *WebAuthnUser) WebAuthnID() []byte {
+	return []byte(u.user.ID)
+}
+
+func (u *WebAuthnUser) WebAuthnName() string {
+	return u.user.UserName
+}
+
+func (u *WebAuthnUser) WebAuthnDisplayName() string {
+	if u.user.Email != "" {
+		return u.user.Email
+	}
+	return u.user.UserName
+}
+
+func (u *WebAuthnUser) WebAuthnCredentials() []webauthn.Credential {
+	return u.credentials
+}
+
+func (u *WebAuthnUser) WebAuthnIcon() string {
+	return ""
+}
diff --git a/backend/internal/auth/passwords.go b/backend/internal/auth/passwords.go
new file mode 100644
index 0000000..af54ba9
--- /dev/null
+++ b/backend/internal/auth/passwords.go
@@ -0,0 +1,61 @@
+package auth
+
+import (
+	"crypto/hmac"
+	"crypto/rand"
+	"crypto/sha256"
+	"encoding/hex"
+	"strings"
+)
+
+func hashPassword(password string) (salt string, hash string, err error) {
+	rawSalt := make([]byte, 16)
+	if _, err := rand.Read(rawSalt); err != nil {
+		return "", "", err
+	}
+	salt = hex.EncodeToString(rawSalt)
+	sum := derivePasswordPBKDF2(password, salt, 120000)
+	return salt, "pbkdf2$" + hex.EncodeToString(sum[:]), nil
+}
+
+func verifyPassword(password, salt, expected string) bool {
+	var sum [32]byte
+	if strings.HasPrefix(expected, "pbkdf2$") {
+		sum = derivePasswordPBKDF2(password, salt, 120000)
+		return hmac.Equal([]byte("pbkdf2$"+hex.EncodeToString(sum[:])), []byte(expected))
+	}
+	stripped := strings.TrimPrefix(expected, "sha256$")
+	sum = derivePasswordLegacy(password, salt)
+	return hmac.Equal([]byte(hex.EncodeToString(sum[:])), []byte(stripped))
+}
+
+func NeedsRehash(hash string) bool {
+	return !strings.HasPrefix(hash, "pbkdf2$")
+}
+
+func derivePasswordPBKDF2(password, salt string, iterations int) [32]byte {
+	prf := hmac.New(sha256.New, []byte(password))
+	var result [32]byte
+	prf.Write([]byte(salt))
+	prf.Write([]byte{0, 0, 0, 1})
+	u := prf.Sum(nil)
+	copy(result[:], u)
+	for i := 1; i < iterations; i++ {
+		prf.Reset()
+		prf.Write(u)
+		u = prf.Sum(nil)
+		for j := 0; j < 32; j++ {
+			result[j] ^= u[j]
+		}
+	}
+	return result
+}
+
+func derivePasswordLegacy(password, salt string) [32]byte {
+	input := []byte(password + ":" + salt)
+	sum := sha256.Sum256(input)
+	for i := 0; i < 120000; i++ {
+		sum = sha256.Sum256(append(sum[:], input...))
+	}
+	return sum
+}
diff --git a/backend/internal/auth/service.go b/backend/internal/auth/service.go
new file mode 100644
index 0000000..7ef0fc0
--- /dev/null
+++ b/backend/internal/auth/service.go
@@ -0,0 +1,257 @@
+package auth
+
+import (
+	"context"
+	"fmt"
+	"strings"
+	"sync"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+const (
+	accessTokenTTL  = 15 * time.Minute
+	RefreshTokenTTL = 7 * 24 * time.Hour
+)
+
+type Service struct {
+	store       storage.Provider
+	secret      []byte
+	loginMu     sync.Mutex
+	loginWindow map[string][]time.Time
+}
+
+func NewService(store storage.Provider, secret string) *Service {
+	return &Service{
+		store:       store,
+		secret:      []byte(secret),
+		loginWindow: map[string][]time.Time{},
+	}
+}
+
+func (s *Service) Register(ctx context.Context, userName, email, password string) (UserInfo, TokenPair, error) {
+	return s.RegisterWithDevice(ctx, userName, email, password, "", "", "")
+}
+
+func (s *Service) RegisterWithDevice(ctx context.Context, userName, email, password, deviceName, ipAddress, userAgent string) (UserInfo, TokenPair, error) {
+	userName = strings.TrimSpace(userName)
+	if userName == "" || strings.TrimSpace(password) == "" {
+		return UserInfo{}, TokenPair{}, ErrUsernamePasswordMissing
+	}
+
+	if _, err := s.store.FindUserByUserName(ctx, userName); err == nil {
+		return UserInfo{}, TokenPair{}, ErrUsernameExists
+	}
+
+	salt, hashed, err := hashPassword(password)
+	if err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	roles := []string{"R_USER"}
+	buttons := []string{"view", "import"}
+
+	now := time.Now().UTC()
+	record, err := s.store.CreateUser(ctx, storage.UserRecord{
+		ID:           randomID("user"),
+		UserName:     userName,
+		Email:        strings.TrimSpace(email),
+		PasswordHash: hashed,
+		PasswordSalt: salt,
+		Roles:        roles,
+		Buttons:      buttons,
+		CreatedAt:    now,
+		UpdatedAt:    now,
+	})
+	if err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	if err := s.store.CreateAuthMethod(ctx, storage.AuthMethodRecord{
+		ID:             randomID("auth"),
+		UserID:         record.ID,
+		ProviderType:   "password",
+		ProviderUserID: record.ID,
+		Metadata:       fmt.Sprintf(`{"userName":%q}`, record.UserName),
+		CreatedAt:      now,
+		UpdatedAt:      now,
+	}); err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	pair, _, err := s.issueTokenPairWithSession(ctx, record, "", "", deviceName, ipAddress, userAgent)
+	if err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	_ = s.writeAuditLog(ctx, record.ID, "register", ipAddress, userAgent, "")
+
+	return toUserInfo(record), pair, nil
+}
+
+func (s *Service) RegisterAdmin(ctx context.Context, userName, email, password string) (UserInfo, TokenPair, error) {
+	return s.RegisterAdminWithDevice(ctx, userName, email, password, "", "", "")
+}
+
+func (s *Service) RegisterAdminWithDevice(ctx context.Context, userName, email, password, deviceName, ipAddress, userAgent string) (UserInfo, TokenPair, error) {
+	userName = strings.TrimSpace(userName)
+	if userName == "" || strings.TrimSpace(password) == "" {
+		return UserInfo{}, TokenPair{}, ErrUsernamePasswordMissing
+	}
+
+	if _, err := s.store.FindUserByUserName(ctx, userName); err == nil {
+		return UserInfo{}, TokenPair{}, ErrUsernameExists
+	}
+
+	salt, hashed, err := hashPassword(password)
+	if err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	roles := []string{"R_ADMIN", "R_USER"}
+	buttons := []string{"view", "import", "admin"}
+
+	now := time.Now().UTC()
+	record, err := s.store.CreateUser(ctx, storage.UserRecord{
+		ID:           randomID("user"),
+		UserName:     userName,
+		Email:        strings.TrimSpace(email),
+		PasswordHash: hashed,
+		PasswordSalt: salt,
+		Roles:        roles,
+		Buttons:      buttons,
+		CreatedAt:    now,
+		UpdatedAt:    now,
+	})
+	if err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	if err := s.store.CreateAuthMethod(ctx, storage.AuthMethodRecord{
+		ID:             randomID("auth"),
+		UserID:         record.ID,
+		ProviderType:   "password",
+		ProviderUserID: record.ID,
+		Metadata:       fmt.Sprintf(`{"userName":%q}`, record.UserName),
+		CreatedAt:      now,
+		UpdatedAt:      now,
+	}); err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	pair, _, err := s.issueTokenPairWithSession(ctx, record, "", "", deviceName, ipAddress, userAgent)
+	if err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	_ = s.writeAuditLog(ctx, record.ID, "register", ipAddress, userAgent, "")
+
+	return toUserInfo(record), pair, nil
+}
+
+func (s *Service) Login(ctx context.Context, remoteAddr, userName, password string) (UserInfo, TokenPair, error) {
+	return s.LoginWithDevice(ctx, remoteAddr, userName, password, "", "", "")
+}
+
+func (s *Service) LoginWithDevice(ctx context.Context, remoteAddr, userName, password, deviceName, ipAddress, userAgent string) (UserInfo, TokenPair, error) {
+	if err := s.allowLoginAttempt(remoteAddr); err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	record, err := s.store.FindUserByUserName(ctx, strings.TrimSpace(userName))
+	if err != nil {
+		return UserInfo{}, TokenPair{}, ErrInvalidCredentials
+	}
+	if !verifyPassword(password, record.PasswordSalt, record.PasswordHash) {
+		return UserInfo{}, TokenPair{}, ErrInvalidCredentials
+	}
+
+	if NeedsRehash(record.PasswordHash) {
+		if newSalt, newHash, rehashErr := hashPassword(password); rehashErr == nil {
+			_ = s.store.UpdateUserPasswordHash(ctx, record.ID, newHash, newSalt)
+		}
+	}
+
+	pair, _, err := s.issueTokenPairWithSession(ctx, record, "", "", deviceName, ipAddress, userAgent)
+	if err != nil {
+		return UserInfo{}, TokenPair{}, err
+	}
+
+	_ = s.writeAuditLog(ctx, record.ID, "login", ipAddress, userAgent, `{"method":"password"}`)
+
+	return toUserInfo(record), pair, nil
+}
+
+func (s *Service) Refresh(ctx context.Context, refreshToken string) (TokenPair, error) {
+	token := strings.TrimSpace(refreshToken)
+	if token == "" {
+		return TokenPair{}, ErrRefreshTokenRequired
+	}
+	tokenHash := hashToken(token)
+
+	record, err := s.store.ConsumeRefreshToken(ctx, tokenHash)
+	if err != nil {
+		return TokenPair{}, s.classifyRefreshFailure(ctx, tokenHash)
+	}
+
+	user, err := s.store.GetUser(ctx, record.UserID)
+	if err != nil {
+		return TokenPair{}, err
+	}
+
+	var (
+		sessionID  string
+		deviceName string
+		ipAddress  string
+		userAgent  string
+	)
+	if session, sessionErr := s.store.GetSessionByRefreshTokenID(ctx, record.ID); sessionErr == nil {
+		sessionID = session.ID
+		deviceName = session.DeviceName
+		ipAddress = session.IPAddress
+		userAgent = session.UserAgent
+	}
+
+	pair, _, err := s.issueTokenPairWithSession(ctx, user, record.ID, sessionID, deviceName, ipAddress, userAgent)
+	if err != nil {
+		return TokenPair{}, err
+	}
+
+	_ = s.writeAuditLog(ctx, user.ID, "token_refresh", "", "", "")
+
+	return pair, nil
+}
+
+func (s *Service) RevokeRefreshToken(ctx context.Context, refreshToken string) error {
+	if refreshToken == "" {
+		return nil
+	}
+	record, err := s.store.ConsumeRefreshToken(ctx, hashToken(refreshToken))
+	if err != nil {
+		return err
+	}
+	if session, sessionErr := s.store.GetSessionByRefreshTokenID(ctx, record.ID); sessionErr == nil {
+		_ = s.store.RevokeSession(ctx, session.ID)
+	}
+	_ = s.writeAuditLog(ctx, record.UserID, "logout", "", "", "")
+	return nil
+}
+
+func (s *Service) UserInfo(ctx context.Context, userID string) (UserInfo, error) {
+	user, err := s.store.GetUser(ctx, userID)
+	if err != nil {
+		return UserInfo{}, err
+	}
+	return toUserInfo(user), nil
+}
+
+func toUserInfo(user storage.UserRecord) UserInfo {
+	return UserInfo{
+		Buttons:  append([]string(nil), user.Buttons...),
+		Roles:    append([]string(nil), user.Roles...),
+		UserID:   user.ID,
+		UserName: user.UserName,
+		Email:    user.Email,
+	}
+}
diff --git a/backend/internal/auth/service_test.go b/backend/internal/auth/service_test.go
new file mode 100644
index 0000000..1bcf61a
--- /dev/null
+++ b/backend/internal/auth/service_test.go
@@ -0,0 +1,70 @@
+package auth
+
+import (
+	"encoding/hex"
+	"strings"
+	"testing"
+)
+
+func TestHashPasswordReturnsPBKDF2Prefix(t *testing.T) {
+	salt, hash, err := hashPassword("testpassword")
+	if err != nil {
+		t.Fatalf("hashPassword error: %v", err)
+	}
+	if len(salt) == 0 {
+		t.Fatal("salt should not be empty")
+	}
+	prefix := "pbkdf2$"
+	if !strings.HasPrefix(hash, prefix) {
+		t.Fatalf("hash should start with %q, got %q", prefix, hash)
+	}
+}
+
+func TestVerifyPasswordNewPBKDF2Format(t *testing.T) {
+	salt, hash, err := hashPassword("mypassword123")
+	if err != nil {
+		t.Fatalf("hashPassword error: %v", err)
+	}
+	if !verifyPassword("mypassword123", salt, hash) {
+		t.Fatal("verifyPassword should succeed with correct password and PBKDF2 format")
+	}
+	if verifyPassword("wrongpassword", salt, hash) {
+		t.Fatal("verifyPassword should fail with wrong password")
+	}
+}
+
+func TestVerifyPasswordLegacyFormatNoPrefix(t *testing.T) {
+	salt := "abcd1234ef567890"
+	sum := derivePasswordLegacy("legacytest", salt)
+	legacyHash := hex.EncodeToString(sum[:])
+	if !verifyPassword("legacytest", salt, legacyHash) {
+		t.Fatal("verifyPassword should succeed with legacy format (no prefix)")
+	}
+	if verifyPassword("wrongpassword", salt, legacyHash) {
+		t.Fatal("verifyPassword should fail with wrong password for legacy format")
+	}
+}
+
+func TestVerifyPasswordLegacyFormatWithSHA256Prefix(t *testing.T) {
+	salt := "abcd1234ef567890"
+	sum := derivePasswordLegacy("testpw", salt)
+	legacyHash := "sha256$" + hex.EncodeToString(sum[:])
+	if !verifyPassword("testpw", salt, legacyHash) {
+		t.Fatal("verifyPassword should succeed with sha256$ prefix format")
+	}
+	if verifyPassword("wrongpw", salt, legacyHash) {
+		t.Fatal("verifyPassword should fail with wrong password for sha256$ prefix")
+	}
+}
+
+func TestNeedsRehash(t *testing.T) {
+	if NeedsRehash("pbkdf2$abc123") {
+		t.Fatal("NeedsRehash should return false for pbkdf2$ prefix")
+	}
+	if !NeedsRehash("abc123") {
+		t.Fatal("NeedsRehash should return true for no prefix")
+	}
+	if !NeedsRehash("sha256$abc123") {
+		t.Fatal("NeedsRehash should return true for sha256$ prefix")
+	}
+}
diff --git a/backend/internal/auth/session_auth.go b/backend/internal/auth/session_auth.go
new file mode 100644
index 0000000..45eeba9
--- /dev/null
+++ b/backend/internal/auth/session_auth.go
@@ -0,0 +1,49 @@
+package auth
+
+import (
+	"context"
+	"log"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+const sessionLastSeenThrottle = 5 * time.Minute
+
+func (s *Service) AuthenticateRequest(ctx context.Context, authHeader string) (AccessTokenClaims, error) {
+	claims, err := s.ParseAccessTokenClaims(authHeader)
+	if err != nil {
+		return AccessTokenClaims{}, ErrUnauthorized
+	}
+	if claims.SessionID == "" {
+		return AccessTokenClaims{}, ErrUnauthorized
+	}
+	session, err := s.GetSession(ctx, claims.SessionID)
+	if err != nil {
+		return AccessTokenClaims{}, ErrUnauthorized
+	}
+	if session.UserID != claims.UserID {
+		return AccessTokenClaims{}, ErrUnauthorized
+	}
+	if shouldUpdateSessionLastSeen(session, time.Now().UTC()) {
+		if err := s.UpdateSessionLastSeen(ctx, session.ID); err != nil {
+			log.Printf("[auth] update session last_seen_at for %s: %v", session.ID, err)
+		}
+	}
+	return claims, nil
+}
+
+func (s *Service) GetSession(ctx context.Context, sessionID string) (storage.SessionRecord, error) {
+	return s.store.GetSession(ctx, sessionID)
+}
+
+func (s *Service) UpdateSessionLastSeen(ctx context.Context, sessionID string) error {
+	return s.store.UpdateSessionLastSeen(ctx, sessionID)
+}
+
+func shouldUpdateSessionLastSeen(session storage.SessionRecord, now time.Time) bool {
+	if session.LastSeenAt.IsZero() {
+		return true
+	}
+	return now.Sub(session.LastSeenAt) >= sessionLastSeenThrottle
+}
diff --git a/backend/internal/auth/tokens.go b/backend/internal/auth/tokens.go
new file mode 100644
index 0000000..62ab152
--- /dev/null
+++ b/backend/internal/auth/tokens.go
@@ -0,0 +1,187 @@
+package auth
+
+import (
+	"context"
+	"crypto/hmac"
+	"crypto/rand"
+	"crypto/sha256"
+	"encoding/base64"
+	"encoding/hex"
+	"encoding/json"
+	"fmt"
+	"strings"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+type AccessTokenClaims struct {
+	UserID    string
+	SessionID string
+	ExpiresAt int64
+}
+
+// IssueTokenPairForUser 为已验证的用户签发 token pair（Passkey 登录用）
+func (s *Service) IssueTokenPairForUser(ctx context.Context, user storage.UserRecord, deviceName, ipAddress, userAgent string) (TokenPair, string, error) {
+	return s.issueTokenPairWithSession(ctx, user, "", "", deviceName, ipAddress, userAgent)
+}
+
+func (s *Service) ParseAccessToken(token string) (string, error) {
+	claims, err := s.ParseAccessTokenClaims(token)
+	if err != nil {
+		return "", err
+	}
+	return claims.UserID, nil
+}
+
+func (s *Service) ParseAccessTokenClaims(token string) (AccessTokenClaims, error) {
+	token = strings.TrimSpace(strings.TrimPrefix(token, "Bearer "))
+	parts := strings.Split(token, ".")
+	if len(parts) != 3 {
+		return AccessTokenClaims{}, fmt.Errorf("invalid token")
+	}
+
+	signingInput := strings.Join(parts[:2], ".")
+	expected := signHS256(signingInput, s.secret)
+	if !hmac.Equal([]byte(expected), []byte(parts[2])) {
+		return AccessTokenClaims{}, fmt.Errorf("invalid token signature")
+	}
+
+	payloadBytes, err := base64.RawURLEncoding.DecodeString(parts[1])
+	if err != nil {
+		return AccessTokenClaims{}, fmt.Errorf("decode token payload: %w", err)
+	}
+	var payload struct {
+		Sub string `json:"sub"`
+		Sid string `json:"sid"`
+		Exp int64  `json:"exp"`
+	}
+	if err := json.Unmarshal(payloadBytes, &payload); err != nil {
+		return AccessTokenClaims{}, fmt.Errorf("decode token json: %w", err)
+	}
+	if payload.Sub == "" || time.Now().Unix() > payload.Exp {
+		return AccessTokenClaims{}, fmt.Errorf("token expired")
+	}
+	return AccessTokenClaims{
+		UserID:    payload.Sub,
+		SessionID: payload.Sid,
+		ExpiresAt: payload.Exp,
+	}, nil
+}
+
+func (s *Service) issueTokenPairWithSession(ctx context.Context, user storage.UserRecord, parentID, sessionID, deviceName, ipAddress, userAgent string) (TokenPair, string, error) {
+	refreshToken, refreshHash, err := buildRefreshToken()
+	if err != nil {
+		return TokenPair{}, "", err
+	}
+	refreshID := randomID("refresh")
+	if sessionID == "" {
+		sessionID = randomID("session")
+	}
+	accessToken, err := s.buildAccessToken(user, sessionID)
+	if err != nil {
+		return TokenPair{}, "", err
+	}
+	if err := s.store.SaveRefreshToken(ctx, storage.RefreshTokenRecord{
+		ID:        refreshID,
+		UserID:    user.ID,
+		TokenHash: refreshHash,
+		ParentID:  parentID,
+		ExpiresAt: time.Now().UTC().Add(RefreshTokenTTL),
+		CreatedAt: time.Now().UTC(),
+	}); err != nil {
+		return TokenPair{}, "", err
+	}
+
+	now := time.Now().UTC()
+	if parentID == "" {
+		if err := s.store.CreateSession(ctx, storage.SessionRecord{
+			ID:             sessionID,
+			UserID:         user.ID,
+			RefreshTokenID: refreshID,
+			DeviceName:     deviceName,
+			DeviceType:     detectDeviceType(userAgent),
+			IPAddress:      ipAddress,
+			UserAgent:      userAgent,
+			CreatedAt:      now,
+			LastSeenAt:     now,
+		}); err != nil {
+			return TokenPair{}, "", err
+		}
+	} else {
+		if err := s.store.UpdateSessionRefreshToken(ctx, sessionID, refreshID); err != nil {
+			return TokenPair{}, "", err
+		}
+	}
+
+	return TokenPair{
+		AccessToken:  accessToken,
+		RefreshToken: refreshToken,
+	}, sessionID, nil
+}
+
+func (s *Service) buildAccessToken(user storage.UserRecord, sessionID string) (string, error) {
+	headerBytes, _ := json.Marshal(map[string]string{"alg": "HS256", "typ": "JWT"})
+	payloadBytes, err := json.Marshal(map[string]any{
+		"sub":      user.ID,
+		"sid":      sessionID,
+		"userName": user.UserName,
+		"roles":    user.Roles,
+		"exp":      time.Now().Add(accessTokenTTL).Unix(),
+	})
+	if err != nil {
+		return "", err
+	}
+	header := base64.RawURLEncoding.EncodeToString(headerBytes)
+	payload := base64.RawURLEncoding.EncodeToString(payloadBytes)
+	signingInput := header + "." + payload
+	return signingInput + "." + signHS256(signingInput, s.secret), nil
+}
+
+func buildRefreshToken() (token string, tokenHash string, err error) {
+	raw := make([]byte, 32)
+	if _, err := rand.Read(raw); err != nil {
+		return "", "", err
+	}
+	token = base64.RawURLEncoding.EncodeToString(raw)
+	return token, hashToken(token), nil
+}
+
+func hashToken(token string) string {
+	sum := sha256.Sum256([]byte(token))
+	return hex.EncodeToString(sum[:])
+}
+
+func signHS256(input string, secret []byte) string {
+	mac := hmac.New(sha256.New, secret)
+	_, _ = mac.Write([]byte(input))
+	return base64.RawURLEncoding.EncodeToString(mac.Sum(nil))
+}
+
+func (s *Service) classifyRefreshFailure(ctx context.Context, tokenHash string) error {
+	record, err := s.store.FindAnyRefreshTokenByHash(ctx, tokenHash)
+	if err != nil {
+		return ErrUnauthorized
+	}
+	if !record.RevokedAt.IsZero() {
+		hasActiveChild, childErr := s.store.HasActiveRefreshTokenChild(ctx, record.ID)
+		if childErr != nil {
+			return ErrOperationFailed
+		}
+		if hasActiveChild {
+			return ErrRefreshTokenRetry
+		}
+		_ = s.store.RevokeRefreshTokenFamily(ctx, record.ID)
+		return ErrRefreshTokenReplayed
+	}
+	if time.Now().UTC().After(record.ExpiresAt) {
+		return ErrRefreshTokenExpired
+	}
+	return ErrUnauthorized
+}
+
+func randomID(prefix string) string {
+	raw := make([]byte, 8)
+	_, _ = rand.Read(raw)
+	return fmt.Sprintf("%s_%x", prefix, raw)
+}
diff --git a/backend/internal/cli/root.go b/backend/internal/cli/root.go
new file mode 100644
index 0000000..594c33c
--- /dev/null
+++ b/backend/internal/cli/root.go
@@ -0,0 +1,255 @@
+package cli
+
+import (
+	"context"
+	"encoding/json"
+	"flag"
+	"fmt"
+	"io"
+	"net/http"
+	"os"
+	"strings"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/api"
+	"github.com/IsKenKenYa/Commory/backend/internal/config"
+	"github.com/IsKenKenYa/Commory/backend/internal/importers"
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/IsKenKenYa/Commory/backend/internal/query"
+	"github.com/IsKenKenYa/Commory/backend/internal/setup"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+const cliUserID = "cli-user"
+
+func Execute(ctx context.Context, args []string, stdout, stderr io.Writer) error {
+	if len(args) == 0 {
+		printUsage(stdout)
+		return nil
+	}
+
+	switch args[0] {
+	case "serve":
+		return runServe(ctx, stdout)
+	case "import":
+		if len(args) != 2 {
+			return fmt.Errorf("usage: commory import <path>")
+		}
+		return runImport(ctx, args[1], stdout)
+	case "validate":
+		if len(args) != 2 {
+			return fmt.Errorf("usage: commory validate <path>")
+		}
+		return runValidate(args[1], stdout)
+	case "query":
+		return runQuery(ctx, args[1:], stdout)
+	case "timeline":
+		return runTimeline(ctx, args[1:], stdout)
+	case "contacts":
+		return runContacts(ctx, args[1:], stdout)
+	case "export":
+		return runExport(ctx, args[1:], stdout)
+	default:
+		printUsage(stderr)
+		return fmt.Errorf("unknown command: %s", args[0])
+	}
+}
+
+func printUsage(w io.Writer) {
+	_, _ = fmt.Fprintln(w, "commory <serve|import|validate|query|timeline|contacts|export>")
+}
+
+func runServe(ctx context.Context, stdout io.Writer) error {
+	cfg, store, validator, err := boot(ctx)
+	if err != nil {
+		return err
+	}
+	defer store.Close()
+	server := api.NewServer(cfg, store, validator)
+	httpServer := &http.Server{Addr: cfg.ListenAddr, Handler: server.Handler()}
+	go func() {
+		<-ctx.Done()
+		shutdownCtx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+		defer cancel()
+		_ = api.Shutdown(shutdownCtx, httpServer)
+	}()
+	_, _ = fmt.Fprintf(stdout, "Commory listening on %s\n", cfg.ListenAddr)
+	return httpServer.ListenAndServe()
+}
+
+func runImport(ctx context.Context, path string, stdout io.Writer) error {
+	_, store, validator, err := boot(ctx)
+	if err != nil {
+		return err
+	}
+	defer store.Close()
+	importer := importers.JSONImporter{}
+	export, raw, err := importer.Import(path)
+	if err != nil {
+		return err
+	}
+	if err := validator.ValidateBytes(raw); err != nil {
+		return err
+	}
+	importID, err := store.Import(ctx, cliUserID, path, export, raw)
+	if err != nil {
+		return err
+	}
+	_, _ = fmt.Fprintf(stdout, "imported %s as %s\n", path, importID)
+	return nil
+}
+
+func runValidate(path string, stdout io.Writer) error {
+	cfg, err := config.Load()
+	if err != nil {
+		return err
+	}
+	validator, err := msglayer.NewValidator(cfg.SchemaRoot)
+	if err != nil {
+		return err
+	}
+	if err := validator.ValidateFile(path); err != nil {
+		return err
+	}
+	_, _ = fmt.Fprintln(stdout, "valid")
+	return nil
+}
+
+func runQuery(ctx context.Context, args []string, stdout io.Writer) error {
+	flags := flag.NewFlagSet("query", flag.ContinueOnError)
+	flags.SetOutput(io.Discard)
+	var params msglayer.SearchParams
+	params.UserID = cliUserID
+	params.Limit = 100
+	flags.StringVar(&params.ContactID, "contact", "", "")
+	flags.StringVar(&params.Type, "type", "", "")
+	flags.StringVar(&params.From, "from", "", "")
+	flags.StringVar(&params.To, "to", "", "")
+	if err := flags.Parse(args); err != nil {
+		return err
+	}
+	if rest := flags.Args(); len(rest) > 0 {
+		params.Keyword = rest[0]
+	}
+	_, store, _, err := boot(ctx)
+	if err != nil {
+		return err
+	}
+	defer store.Close()
+	items, err := query.New(store).Search(ctx, params)
+	if err != nil {
+		return err
+	}
+	return json.NewEncoder(stdout).Encode(items)
+}
+
+func runTimeline(ctx context.Context, args []string, stdout io.Writer) error {
+	flags := flag.NewFlagSet("timeline", flag.ContinueOnError)
+	flags.SetOutput(io.Discard)
+	var params msglayer.SearchParams
+	params.UserID = cliUserID
+	params.Limit = 100
+	flags.StringVar(&params.From, "from", "", "")
+	flags.StringVar(&params.To, "to", "", "")
+	flags.StringVar(&params.Type, "type", "", "")
+	flags.StringVar(&params.Participant, "participant", "", "")
+	if err := flags.Parse(args); err != nil {
+		return err
+	}
+	_, store, _, err := boot(ctx)
+	if err != nil {
+		return err
+	}
+	defer store.Close()
+	items, err := query.New(store).Timeline(ctx, params)
+	if err != nil {
+		return err
+	}
+	return json.NewEncoder(stdout).Encode(items)
+}
+
+func runContacts(ctx context.Context, args []string, stdout io.Writer) error {
+	if len(args) != 1 || args[0] != "list" {
+		return fmt.Errorf("usage: commory contacts list")
+	}
+	_, store, _, err := boot(ctx)
+	if err != nil {
+		return err
+	}
+	defer store.Close()
+	items, err := query.New(store).Identities(ctx, cliUserID)
+	if err != nil {
+		return err
+	}
+	return json.NewEncoder(stdout).Encode(items)
+}
+
+func runExport(ctx context.Context, args []string, stdout io.Writer) error {
+	flags := flag.NewFlagSet("export", flag.ContinueOnError)
+	flags.SetOutput(io.Discard)
+	var format string
+	var importID string
+	flags.StringVar(&format, "format", "json", "")
+	flags.StringVar(&importID, "import-id", "", "")
+	if err := flags.Parse(args); err != nil {
+		return err
+	}
+	if format != "json" {
+		return fmt.Errorf("unsupported export format: %s", format)
+	}
+	_, store, _, err := boot(ctx)
+	if err != nil {
+		return err
+	}
+	defer store.Close()
+	raw, err := store.ExportImport(ctx, cliUserID, importID)
+	if err != nil {
+		return err
+	}
+	_, err = stdout.Write(raw)
+	return err
+}
+
+func boot(ctx context.Context) (config.Config, storage.Provider, *msglayer.Validator, error) {
+	cfg, err := config.Load()
+	if err != nil {
+		return config.Config{}, nil, nil, err
+	}
+	if cfg.IsDefaultAuthSecret() {
+		if strings.EqualFold(cfg.Env, "production") {
+			return config.Config{}, nil, nil, fmt.Errorf("FATAL: COMMORY_AUTH_SECRET is using the default value. Set a secure secret before running in production mode")
+		}
+		fmt.Fprintln(os.Stderr, "WARNING: COMMORY_AUTH_SECRET is using the default value. This is insecure for production use.")
+	}
+	validator, err := msglayer.NewValidator(cfg.SchemaRoot)
+	if err != nil {
+		return config.Config{}, nil, nil, err
+	}
+	store, err := openStore(cfg)
+	if err != nil {
+		return config.Config{}, nil, nil, err
+	}
+	if err := store.Init(ctx); err != nil {
+		return config.Config{}, nil, nil, err
+	}
+	setup.CheckSetup(ctx, store)
+	return cfg, store, validator, nil
+}
+
+func openStore(cfg config.Config) (storage.Provider, error) {
+	switch cfg.Driver {
+	case "sqlite":
+		return storage.NewSQLiteProvider(cfg.DSN)
+	case "postgres":
+		dsn := cfg.DSN
+		if cfg.DatabaseURL != "" {
+			dsn = cfg.DatabaseURL
+		}
+		if dsn == "" {
+			dsn = "./data/commory-postgres-store.json"
+		}
+		return storage.NewPostgresProvider(dsn)
+	default:
+		return nil, fmt.Errorf("unsupported db driver: %s", cfg.Driver)
+	}
+}
diff --git a/backend/internal/config/config.go b/backend/internal/config/config.go
new file mode 100644
index 0000000..929e9f3
--- /dev/null
+++ b/backend/internal/config/config.go
@@ -0,0 +1,94 @@
+package config
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+)
+
+type Config struct {
+	Driver           string
+	DSN              string
+	DatabaseURL      string
+	ListenAddr       string
+	SchemaRoot       string
+	WebRoot          string
+	AuthSecret       string
+	TLS              bool
+	Env              string
+	AllowedImportDir []string
+	PasskeyRPName    string
+	PasskeyRPID      string
+	PasskeyOrigin    string
+}
+
+func Load() (Config, error) {
+	schemaRoot := env("COMMORY_SCHEMA_ROOT", filepath.Join("..", "msglayer", "schema", "v0.1", "root.schema.json"))
+	if !filepath.IsAbs(schemaRoot) {
+		if abs, err := filepath.Abs(schemaRoot); err == nil {
+			schemaRoot = abs
+		}
+	}
+	return Config{
+		Driver:           env("COMMORY_DB_DRIVER", "sqlite"),
+		DSN:              env("COMMORY_DB_DSN", filepath.Join(".", "data", "commory.db")),
+		DatabaseURL:      env("COMMORY_DATABASE_URL", ""),
+		ListenAddr:       env("COMMORY_LISTEN_ADDR", ":3000"),
+		SchemaRoot:       schemaRoot,
+		WebRoot:          absPath(env("COMMORY_WEB_ROOT", "")),
+		AuthSecret:       env("COMMORY_AUTH_SECRET", "commory-dev-secret"),
+		TLS:              envBool("COMMORY_TLS", false),
+		Env:              env("COMMORY_ENV", "development"),
+		AllowedImportDir: splitAndClean(env("COMMORY_ALLOWED_IMPORT_DIRS", filepath.Join("..", "msglayer", "examples"))),
+		PasskeyRPName:    env("COMMORY_PASSKEY_RP_NAME", "Commory"),
+		PasskeyRPID:      env("COMMORY_PASSKEY_RP_ID", ""),
+		PasskeyOrigin:    env("COMMORY_PASSKEY_ORIGIN", ""),
+	}, nil
+}
+
+func absPath(path string) string {
+	if path == "" || filepath.IsAbs(path) {
+		return path
+	}
+	if abs, err := filepath.Abs(path); err == nil {
+		return abs
+	}
+	return path
+}
+
+func env(key, fallback string) string {
+	if value := os.Getenv(key); value != "" {
+		return value
+	}
+	return fallback
+}
+
+func envBool(key string, fallback bool) bool {
+	value := os.Getenv(key)
+	if value == "" {
+		return fallback
+	}
+	return strings.EqualFold(value, "true") || value == "1"
+}
+
+func (c Config) IsDefaultAuthSecret() bool {
+	return c.AuthSecret == "commory-dev-secret"
+}
+
+func splitAndClean(raw string) []string {
+	parts := strings.Split(raw, ",")
+	result := make([]string, 0, len(parts))
+	for _, part := range parts {
+		part = strings.TrimSpace(part)
+		if part == "" {
+			continue
+		}
+		if !filepath.IsAbs(part) {
+			if abs, err := filepath.Abs(part); err == nil {
+				part = abs
+			}
+		}
+		result = append(result, part)
+	}
+	return result
+}
diff --git a/backend/internal/importers/importer.go b/backend/internal/importers/importer.go
new file mode 100644
index 0000000..c39c262
--- /dev/null
+++ b/backend/internal/importers/importer.go
@@ -0,0 +1,32 @@
+package importers
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+)
+
+type Importer interface {
+	Import(path string) (msglayer.RootExport, []byte, error)
+	ImportBytes([]byte) (msglayer.RootExport, []byte, error)
+}
+
+type JSONImporter struct{}
+
+func (JSONImporter) Import(path string) (msglayer.RootExport, []byte, error) {
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return msglayer.RootExport{}, nil, err
+	}
+	return JSONImporter{}.ImportBytes(data)
+}
+
+func (JSONImporter) ImportBytes(data []byte) (msglayer.RootExport, []byte, error) {
+	var export msglayer.RootExport
+	if err := json.Unmarshal(data, &export); err != nil {
+		return msglayer.RootExport{}, nil, fmt.Errorf("decode msglayer json: %w", err)
+	}
+	return export, data, nil
+}
diff --git a/backend/internal/index/index.go b/backend/internal/index/index.go
new file mode 100644
index 0000000..357c9c9
--- /dev/null
+++ b/backend/internal/index/index.go
@@ -0,0 +1,5 @@
+package index
+
+type Provider interface {
+	Name() string
+}
diff --git a/backend/internal/msglayer/types.go b/backend/internal/msglayer/types.go
new file mode 100644
index 0000000..a8d7430
--- /dev/null
+++ b/backend/internal/msglayer/types.go
@@ -0,0 +1,68 @@
+package msglayer
+
+const Version = "msglayer/v0.1"
+
+type RootExport struct {
+	Version    string         `json:"version"`
+	ExportedAt string         `json:"exported_at"`
+	Source     Source         `json:"source"`
+	Identities []Identity     `json:"identities"`
+	Events     []Event        `json:"events"`
+	Indexes    map[string]any `json:"indexes,omitempty"`
+}
+
+type Source struct {
+	Platform   string `json:"platform"`
+	DeviceID   string `json:"device_id"`
+	AppVersion string `json:"app_version"`
+}
+
+type Identity struct {
+	ID          string         `json:"id"`
+	Type        string         `json:"type"`
+	DisplayName string         `json:"display_name"`
+	Phones      []string       `json:"phones"`
+	Emails      []string       `json:"emails"`
+	Avatar      *string        `json:"avatar"`
+	Labels      []string       `json:"labels"`
+	Meta        map[string]any `json:"meta"`
+}
+
+type Event struct {
+	ID           string         `json:"id"`
+	Type         string         `json:"type"`
+	Timestamp    string         `json:"timestamp"`
+	Direction    string         `json:"direction"`
+	Participants []string       `json:"participants"`
+	Content      map[string]any `json:"content"`
+	Meta         map[string]any `json:"meta"`
+	Relations    []Relation     `json:"relations"`
+}
+
+type Relation struct {
+	Type   string `json:"type"`
+	Target string `json:"target"`
+}
+
+type SearchParams struct {
+	UserID      string
+	Keyword     string
+	ContactID   string
+	Type        string
+	Participant string
+	From        string
+	To          string
+	Limit       int
+	Offset      int `json:"offset,omitempty"`
+}
+
+type TimelineItem struct {
+	EventID        string         `json:"event_id"`
+	Type           string         `json:"type"`
+	Timestamp      string         `json:"timestamp"`
+	Direction      string         `json:"direction"`
+	ContentSummary string         `json:"content_summary"`
+	Participants   []string       `json:"participants"`
+	Meta           map[string]any `json:"meta,omitempty"`
+	SchemaVersion  string         `json:"schema_version"`
+}
diff --git a/backend/internal/msglayer/validator.go b/backend/internal/msglayer/validator.go
new file mode 100644
index 0000000..c71acee
--- /dev/null
+++ b/backend/internal/msglayer/validator.go
@@ -0,0 +1,153 @@
+package msglayer
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+)
+
+type Validator struct {
+	rootSchemaPath string
+}
+
+func NewValidator(rootSchemaPath string) (*Validator, error) {
+	return &Validator{rootSchemaPath: rootSchemaPath}, nil
+}
+
+var allowedIdentityFields = map[string]bool{
+	"id": true, "type": true, "display_name": true,
+	"avatar": true, "phones": true, "emails": true, "labels": true, "meta": true,
+}
+
+var allowedEventFields = map[string]bool{
+	"id": true, "timestamp": true, "type": true, "direction": true,
+	"participants": true, "content": true, "relations": true, "meta": true,
+}
+
+var allowedContentKeys = map[string]map[string]bool{
+	"sms":              {"text": true, "attachments": true},
+	"call":             {"duration_sec": true, "call_type": true, "recording": true},
+	"voice":            {"file": true, "transcript": true, "summary": true},
+	"contact_snapshot": {"identity_id": true, "snapshot": true},
+}
+
+func checkAdditionalProperties(obj map[string]any, allowed map[string]bool, context string) error {
+	for key := range obj {
+		if !allowed[key] {
+			return fmt.Errorf("schema validation failed: unknown %s field %q", context, key)
+		}
+	}
+	return nil
+}
+
+func (v *Validator) ValidateBytes(data []byte) error {
+	var payload RootExport
+	if err := json.Unmarshal(data, &payload); err != nil {
+		return err
+	}
+	if payload.Version != Version {
+		return fmt.Errorf("schema validation failed: version must be %s", Version)
+	}
+	if payload.ExportedAt == "" {
+		return fmt.Errorf("schema validation failed: exported_at is required")
+	}
+	if payload.Source.Platform == "" || payload.Source.DeviceID == "" || payload.Source.AppVersion == "" {
+		return fmt.Errorf("schema validation failed: source.platform, source.device_id, and source.app_version are required")
+	}
+	var rawPayload struct {
+		Identities []map[string]any `json:"identities"`
+		Events     []map[string]any `json:"events"`
+	}
+	_ = json.Unmarshal(data, &rawPayload)
+	for i, identity := range payload.Identities {
+		if identity.ID == "" || identity.Type == "" || identity.DisplayName == "" {
+			return fmt.Errorf("schema validation failed: identity id/type/display_name required")
+		}
+		if identity.Phones == nil || identity.Emails == nil || identity.Labels == nil {
+			return fmt.Errorf("schema validation failed: identity phones/emails/labels must be present")
+		}
+		switch identity.Type {
+		case "person", "device", "account":
+		default:
+			return fmt.Errorf("schema validation failed: unsupported identity type %q", identity.Type)
+		}
+		if i < len(rawPayload.Identities) {
+			if err := checkAdditionalProperties(rawPayload.Identities[i], allowedIdentityFields, "identity"); err != nil {
+				return err
+			}
+		}
+	}
+	for i, event := range payload.Events {
+		if event.ID == "" || event.Timestamp == "" || event.Type == "" {
+			return fmt.Errorf("schema validation failed: event id/type/timestamp required")
+		}
+		if len(event.Participants) == 0 {
+			return fmt.Errorf("schema validation failed: participants must contain at least one item")
+		}
+		for _, participant := range event.Participants {
+			if participant == "" {
+				return fmt.Errorf("schema validation failed: participant ids must be non-empty")
+			}
+		}
+		switch event.Type {
+		case "sms":
+			if event.Direction != "inbound" && event.Direction != "outbound" {
+				return fmt.Errorf("schema validation failed: sms direction invalid")
+			}
+			if _, ok := event.Content["text"]; !ok {
+				return fmt.Errorf("schema validation failed: sms content.text required")
+			}
+		case "call":
+			if event.Direction != "inbound" && event.Direction != "outbound" && event.Direction != "missed" {
+				return fmt.Errorf("schema validation failed: call direction invalid")
+			}
+			if _, ok := event.Content["duration_sec"]; !ok {
+				return fmt.Errorf("schema validation failed: call content.duration_sec required")
+			}
+		case "voice":
+			if event.Direction != "inbound" && event.Direction != "outbound" {
+				return fmt.Errorf("schema validation failed: voice direction invalid")
+			}
+			if _, ok := event.Content["file"]; !ok {
+				return fmt.Errorf("schema validation failed: voice content.file required")
+			}
+		case "contact_snapshot":
+			if event.Direction != "system" {
+				return fmt.Errorf("schema validation failed: contact_snapshot direction must be system")
+			}
+			if _, ok := event.Content["identity_id"]; !ok {
+				return fmt.Errorf("schema validation failed: contact_snapshot content.identity_id required")
+			}
+		default:
+			return fmt.Errorf("schema validation failed: unsupported event type %q", event.Type)
+		}
+		for _, relation := range event.Relations {
+			switch relation.Type {
+			case "same_thread", "reply_to", "derived_from", "references_identity":
+			default:
+				return fmt.Errorf("schema validation failed: unsupported relation type %q", relation.Type)
+			}
+		}
+		if i < len(rawPayload.Events) {
+			if err := checkAdditionalProperties(rawPayload.Events[i], allowedEventFields, "event"); err != nil {
+				return err
+			}
+			if content, ok := rawPayload.Events[i]["content"].(map[string]any); ok {
+				if allowed, ok := allowedContentKeys[event.Type]; ok {
+					if err := checkAdditionalProperties(content, allowed, "event content"); err != nil {
+						return err
+					}
+				}
+			}
+		}
+	}
+	return nil
+}
+
+func (v *Validator) ValidateFile(path string) error {
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return err
+	}
+	return v.ValidateBytes(data)
+}
diff --git a/backend/internal/msglayer/validator_test.go b/backend/internal/msglayer/validator_test.go
new file mode 100644
index 0000000..c47a612
--- /dev/null
+++ b/backend/internal/msglayer/validator_test.go
@@ -0,0 +1,180 @@
+package msglayer
+
+import (
+	"path/filepath"
+	"runtime"
+	"testing"
+)
+
+func TestExamplesValidate(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	for _, name := range []string{"export.minimal.json", "export.sms-call.json", "export.voice.json"} {
+		if err := validator.ValidateFile(projectPath("msglayer", "examples", name)); err != nil {
+			t.Fatalf("%s should validate: %v", name, err)
+		}
+	}
+}
+
+func TestValidationFailsForUnknownEventType(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [],
+	  "events": [{"id":"e1","type":"fax","timestamp":"2026-01-01T12:00:00Z","direction":"inbound","participants":["self/x"],"content":{},"meta":{},"relations":[]}]
+	}`)
+	if err := validator.ValidateBytes(payload); err == nil {
+		t.Fatal("expected schema validation to fail")
+	}
+}
+
+func TestValidationFailsForEmptyParticipant(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [{"id":"self/x","type":"device","display_name":"x","phones":[],"emails":[],"labels":["self"],"meta":{}}],
+	  "events": [{"id":"e1","type":"sms","timestamp":"2026-01-01T12:00:00Z","direction":"inbound","participants":[""],"content":{"text":"hi","attachments":[]},"meta":{},"relations":[]}]
+	}`)
+	if err := validator.ValidateBytes(payload); err == nil {
+		t.Fatal("expected participant validation to fail")
+	}
+}
+
+func TestValidationFailsForVoiceDirection(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [{"id":"self/x","type":"device","display_name":"x","phones":[],"emails":[],"labels":["self"],"meta":{}}],
+	  "events": [{"id":"voice_1","type":"voice","timestamp":"2026-01-01T12:00:00Z","direction":"system","participants":["self/x"],"content":{"file":"file://voice/001.mp3","transcript":"hi","summary":"hi"},"meta":{},"relations":[]}]
+	}`)
+	if err := validator.ValidateBytes(payload); err == nil {
+		t.Fatal("expected voice direction validation to fail")
+	}
+}
+
+func TestValidationFailsForRelationType(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [{"id":"self/x","type":"device","display_name":"x","phones":[],"emails":[],"labels":["self"],"meta":{}}],
+	  "events": [{"id":"e1","type":"sms","timestamp":"2026-01-01T12:00:00Z","direction":"inbound","participants":["self/x"],"content":{"text":"hi","attachments":[]},"meta":{},"relations":[{"type":"bad_relation","target":"x"}]}]
+	}`)
+	if err := validator.ValidateBytes(payload); err == nil {
+		t.Fatal("expected relation validation to fail")
+	}
+}
+
+func TestValidationFailsForUnknownEventField(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [{"id":"self/x","type":"device","display_name":"x","phones":[],"emails":[],"labels":["self"],"meta":{}}],
+	  "events": [{"id":"e1","type":"sms","timestamp":"2026-01-01T12:00:00Z","direction":"inbound","participants":["self/x"],"content":{"text":"hi","attachments":[]},"meta":{},"relations":[],"unknown_field":"oops"}]
+	}`)
+	if err := validator.ValidateBytes(payload); err == nil {
+		t.Fatal("expected validation to fail for unknown event field")
+	}
+}
+
+func TestValidationFailsForUnknownIdentityField(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [{"id":"self/x","type":"device","display_name":"x","phones":[],"emails":[],"labels":["self"],"meta":{},"extra_field":"oops"}],
+	  "events": [{"id":"e1","type":"sms","timestamp":"2026-01-01T12:00:00Z","direction":"inbound","participants":["self/x"],"content":{"text":"hi","attachments":[]},"meta":{},"relations":[]}]
+	}`)
+	if err := validator.ValidateBytes(payload); err == nil {
+		t.Fatal("expected validation to fail for unknown identity field")
+	}
+}
+
+func TestValidationFailsForUnknownContentKey(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [{"id":"self/x","type":"device","display_name":"x","phones":[],"emails":[],"labels":["self"],"meta":{}}],
+	  "events": [{"id":"e1","type":"sms","timestamp":"2026-01-01T12:00:00Z","direction":"inbound","participants":["self/x"],"content":{"text":"hi","attachments":[],"unknown_key":"oops"},"meta":{},"relations":[]}]
+	}`)
+	if err := validator.ValidateBytes(payload); err == nil {
+		t.Fatal("expected validation to fail for unknown content key")
+	}
+}
+
+func TestValidationPassesForAllKnownFields(t *testing.T) {
+	root := projectPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := NewValidator(root)
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	payload := []byte(`{
+	  "version": "msglayer/v0.1",
+	  "exported_at": "2026-01-01T12:00:00Z",
+	  "source": {"platform":"android","device_id":"x","app_version":"0.1"},
+	  "identities": [{"id":"self/x","type":"device","display_name":"x","phones":[],"emails":[],"labels":["self"],"meta":{}}],
+	  "events": [{"id":"e1","type":"sms","timestamp":"2026-01-01T12:00:00Z","direction":"inbound","participants":["self/x"],"content":{"text":"hi","attachments":[]},"meta":{},"relations":[]}]
+	}`)
+	if err := validator.ValidateBytes(payload); err != nil {
+		t.Fatalf("expected validation to pass for valid event with all known fields: %v", err)
+	}
+}
+
+func projectPath(parts ...string) string {
+	_, file, _, _ := runtime.Caller(0)
+	base := filepath.Join(filepath.Dir(file), "..", "..", "..")
+	all := append([]string{base}, parts...)
+	return filepath.Join(all...)
+}
diff --git a/backend/internal/query/service.go b/backend/internal/query/service.go
new file mode 100644
index 0000000..116b597
--- /dev/null
+++ b/backend/internal/query/service.go
@@ -0,0 +1,44 @@
+package query
+
+import (
+	"context"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+type Service struct {
+	store storage.Provider
+}
+
+func New(store storage.Provider) Service {
+	return Service{store: store}
+}
+
+func (s Service) Events(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	return s.store.ListEvents(ctx, params)
+}
+
+func (s Service) Search(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	return s.store.Search(ctx, params)
+}
+
+func (s Service) Timeline(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	return s.store.Timeline(ctx, params)
+}
+
+func (s Service) Event(ctx context.Context, userID, id string) (msglayer.TimelineItem, error) {
+	return s.store.GetEvent(ctx, userID, id)
+}
+
+func (s Service) Thread(ctx context.Context, userID, id string) ([]msglayer.TimelineItem, error) {
+	return s.store.GetThread(ctx, userID, id)
+}
+
+func (s Service) Identities(ctx context.Context, userID string) ([]msglayer.Identity, error) {
+	return s.store.ListIdentities(ctx, userID)
+}
+
+func (s Service) Identity(ctx context.Context, userID, id string) (msglayer.Identity, error) {
+	return s.store.GetIdentity(ctx, userID, id)
+}
diff --git a/backend/internal/setup/service.go b/backend/internal/setup/service.go
new file mode 100644
index 0000000..6f1db73
--- /dev/null
+++ b/backend/internal/setup/service.go
@@ -0,0 +1,99 @@
+package setup
+
+import (
+	"context"
+	"fmt"
+	"strings"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/auth"
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+type Service struct {
+	store storage.Provider
+	auth  *auth.Service
+}
+
+func NewService(store storage.Provider, auth *auth.Service) *Service {
+	return &Service{store: store, auth: auth}
+}
+
+type SetupStatusResponse struct {
+	Status       bool   `json:"status"`
+	DatabaseType string `json:"database_type"`
+	RootInit     bool   `json:"root_init"`
+}
+
+func (s *Service) GetStatus(ctx context.Context) (SetupStatusResponse, error) {
+	status, err := s.store.GetSetupStatus(ctx)
+	if err != nil {
+		return SetupStatusResponse{}, err
+	}
+	hasAdmin, _ := s.store.HasAdminUser(ctx)
+	return SetupStatusResponse{
+		Status:       status.Initialized,
+		DatabaseType: status.DatabaseType,
+		RootInit:     hasAdmin,
+	}, nil
+}
+
+type SetupRequest struct {
+	UserName        string `json:"userName"`
+	Password        string `json:"password"`
+	ConfirmPassword string `json:"confirmPassword"`
+	UsageMode       string `json:"usageMode"`
+}
+
+func (s *Service) Initialize(ctx context.Context, req SetupRequest) error {
+	status, err := s.store.GetSetupStatus(ctx)
+	if err != nil {
+		return err
+	}
+	if status.Initialized {
+		return fmt.Errorf("system already initialized")
+	}
+
+	hasAdmin, _ := s.store.HasAdminUser(ctx)
+	if !hasAdmin {
+		if strings.TrimSpace(req.UserName) == "" {
+			return fmt.Errorf("admin username is required")
+		}
+		if len(req.Password) < 8 {
+			return fmt.Errorf("password must be at least 8 characters")
+		}
+		if req.Password != req.ConfirmPassword {
+			return fmt.Errorf("passwords do not match")
+		}
+		user, _, err := s.auth.RegisterAdmin(ctx, req.UserName, "", req.Password)
+		if err != nil {
+			return fmt.Errorf("failed to create admin user: %w", err)
+		}
+		_ = user
+	}
+
+	return s.store.SaveSetup(ctx, storage.SetupRecord{
+		ID:            fmt.Sprintf("setup_%d", time.Now().UnixNano()),
+		Version:       "1.0",
+		InitializedAt: time.Now().UTC().Format(time.RFC3339),
+		UsageMode:     req.UsageMode,
+	})
+}
+
+func CheckSetup(ctx context.Context, store storage.Provider) {
+	status, err := store.GetSetupStatus(ctx)
+	if err != nil {
+		return
+	}
+	if !status.Initialized {
+		hasAdmin, _ := store.HasAdminUser(ctx)
+		if hasAdmin {
+			_ = store.SaveSetup(ctx, storage.SetupRecord{
+				ID:            fmt.Sprintf("setup_%d", time.Now().UnixNano()),
+				Version:       "0.9-legacy",
+				InitializedAt: time.Now().UTC().Format(time.RFC3339),
+				UsageMode:     "personal",
+			})
+		}
+	}
+}
diff --git a/backend/internal/storage/contracttest/auth_contract_test.go b/backend/internal/storage/contracttest/auth_contract_test.go
new file mode 100644
index 0000000..6d3da6e
--- /dev/null
+++ b/backend/internal/storage/contracttest/auth_contract_test.go
@@ -0,0 +1,171 @@
+package contracttest
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+	"github.com/google/uuid"
+)
+
+func testUserLifecycle(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	user := storage.UserRecord{
+		ID:           uuid.New().String(),
+		UserName:     "testuser_" + uuid.New().String()[:8],
+		Email:        "test@example.com",
+		PasswordHash: "hash123",
+		PasswordSalt: "salt123",
+		Roles:        []string{"R_USER"},
+		Buttons:      []string{"view", "import"},
+	}
+
+	created, err := store.CreateUser(ctx, user)
+	if err != nil {
+		t.Fatalf("CreateUser: %v", err)
+	}
+	if created.UserName != user.UserName {
+		t.Fatalf("username mismatch: got %s", created.UserName)
+	}
+
+	found, err := store.FindUserByUserName(ctx, user.UserName)
+	if err != nil {
+		t.Fatalf("FindUserByUserName: %v", err)
+	}
+	if found.ID != user.ID {
+		t.Fatalf("user ID mismatch: got %s", found.ID)
+	}
+
+	got, err := store.GetUser(ctx, user.ID)
+	if err != nil {
+		t.Fatalf("GetUser: %v", err)
+	}
+	if got.Email != user.Email {
+		t.Fatalf("email mismatch: got %s", got.Email)
+	}
+
+	hasAdmin, err := store.HasAdminUser(ctx)
+	if err != nil {
+		t.Fatalf("HasAdminUser: %v", err)
+	}
+	if hasAdmin {
+		t.Fatal("expected no admin user")
+	}
+
+	_, err = store.CreateUser(ctx, storage.UserRecord{
+		ID:       uuid.New().String(),
+		UserName: user.UserName,
+	})
+	if err == nil {
+		t.Fatal("expected error for duplicate username")
+	}
+}
+
+func testRefreshTokenRotation(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	user := storage.UserRecord{
+		ID:           uuid.New().String(),
+		UserName:     "tokenuser_" + uuid.New().String()[:8],
+		PasswordHash: "hash",
+		PasswordSalt: "salt",
+		Roles:        []string{"R_USER"},
+		Buttons:      []string{"view"},
+	}
+	if _, err := store.CreateUser(ctx, user); err != nil {
+		t.Fatal(err)
+	}
+
+	token := storage.RefreshTokenRecord{
+		ID:        uuid.New().String(),
+		UserID:    user.ID,
+		TokenHash: "hash_" + uuid.New().String(),
+		ExpiresAt: time.Now().Add(7 * 24 * time.Hour),
+	}
+
+	if err := store.SaveRefreshToken(ctx, token); err != nil {
+		t.Fatalf("SaveRefreshToken: %v", err)
+	}
+
+	child := storage.RefreshTokenRecord{
+		ID:        uuid.New().String(),
+		UserID:    user.ID,
+		TokenHash: "child_" + uuid.New().String(),
+		ParentID:  token.ID,
+		ExpiresAt: time.Now().Add(7 * 24 * time.Hour),
+	}
+	if err := store.SaveRefreshToken(ctx, child); err != nil {
+		t.Fatalf("SaveRefreshToken child: %v", err)
+	}
+
+	hasChild, err := store.HasActiveRefreshTokenChild(ctx, token.ID)
+	if err != nil {
+		t.Fatalf("HasActiveRefreshTokenChild: %v", err)
+	}
+	if !hasChild {
+		t.Fatal("expected active child refresh token")
+	}
+
+	consumed, err := store.ConsumeRefreshToken(ctx, token.TokenHash)
+	if err != nil {
+		t.Fatalf("ConsumeRefreshToken: %v", err)
+	}
+	if consumed.UserID != user.ID {
+		t.Fatalf("user ID mismatch: got %s", consumed.UserID)
+	}
+
+	_, err = store.ConsumeRefreshToken(ctx, token.TokenHash)
+	if err == nil {
+		t.Fatal("expected error for already consumed token")
+	}
+
+	if err := store.RevokeRefreshTokenFamily(ctx, token.ID); err != nil {
+		t.Fatalf("RevokeRefreshTokenFamily: %v", err)
+	}
+	hasChild, err = store.HasActiveRefreshTokenChild(ctx, token.ID)
+	if err != nil {
+		t.Fatalf("HasActiveRefreshTokenChild after revoke: %v", err)
+	}
+	if hasChild {
+		t.Fatal("expected family revoke to revoke child refresh token")
+	}
+}
+
+func testAuthMethod(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	user := storage.UserRecord{
+		ID: uuid.New().String(), UserName: "am_" + uuid.New().String()[:8],
+		PasswordHash: "h", PasswordSalt: "s", Roles: []string{"R_USER"}, Buttons: []string{"view"},
+	}
+	if _, err := store.CreateUser(ctx, user); err != nil {
+		t.Fatal(err)
+	}
+
+	method := storage.AuthMethodRecord{
+		ID:             uuid.New().String(),
+		UserID:         user.ID,
+		ProviderType:   "password",
+		ProviderUserID: user.ID,
+		Metadata:       "{}",
+	}
+	if err := store.CreateAuthMethod(ctx, method); err != nil {
+		t.Fatalf("CreateAuthMethod: %v", err)
+	}
+
+	got, err := store.GetAuthMethodByProvider(ctx, "password", user.ID)
+	if err != nil {
+		t.Fatalf("GetAuthMethodByProvider: %v", err)
+	}
+	if got.UserID != user.ID {
+		t.Fatalf("user ID mismatch: %s", got.UserID)
+	}
+}
diff --git a/backend/internal/storage/contracttest/contract_test.go b/backend/internal/storage/contracttest/contract_test.go
new file mode 100644
index 0000000..c16b330
--- /dev/null
+++ b/backend/internal/storage/contracttest/contract_test.go
@@ -0,0 +1,24 @@
+package contracttest
+
+import (
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+	"testing"
+)
+
+// ProviderFactory 创建一个临时的 Provider 实例。
+type ProviderFactory func(t *testing.T) storage.Provider
+
+// RunContractTests 对给定的 Provider 运行完整的存储契约测试套件。
+func RunContractTests(t *testing.T, factory ProviderFactory) {
+	t.Run("UserLifecycle", func(t *testing.T) { testUserLifecycle(t, factory) })
+	t.Run("RefreshTokenRotation", func(t *testing.T) { testRefreshTokenRotation(t, factory) })
+	t.Run("ImportAndQuery", func(t *testing.T) { testImportAndQuery(t, factory) })
+	t.Run("IdentityCRUD", func(t *testing.T) { testIdentityCRUD(t, factory) })
+	t.Run("SearchPagination", func(t *testing.T) { testSearchPagination(t, factory) })
+	t.Run("SetupLifecycle", func(t *testing.T) { testSetupLifecycle(t, factory) })
+	t.Run("SessionLifecycle", func(t *testing.T) { testSessionLifecycle(t, factory) })
+	t.Run("AuditLog", func(t *testing.T) { testAuditLog(t, factory) })
+	t.Run("PasskeyCredential", func(t *testing.T) { testPasskeyCredential(t, factory) })
+	t.Run("ChallengeLifecycle", func(t *testing.T) { testChallengeLifecycle(t, factory) })
+	t.Run("AuthMethod", func(t *testing.T) { testAuthMethod(t, factory) })
+}
diff --git a/backend/internal/storage/contracttest/filestore_test.go b/backend/internal/storage/contracttest/filestore_test.go
new file mode 100644
index 0000000..41035dc
--- /dev/null
+++ b/backend/internal/storage/contracttest/filestore_test.go
@@ -0,0 +1,19 @@
+package contracttest
+
+import (
+	"path/filepath"
+	"testing"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+func TestFileStoreContract(t *testing.T) {
+	RunContractTests(t, func(t *testing.T) storage.Provider {
+		t.Helper()
+		store, err := storage.NewFileStoreProvider(filepath.Join(t.TempDir(), "commory.json"))
+		if err != nil {
+			t.Fatalf("NewFileStoreProvider: %v", err)
+		}
+		return store
+	})
+}
diff --git a/backend/internal/storage/contracttest/helpers_test.go b/backend/internal/storage/contracttest/helpers_test.go
new file mode 100644
index 0000000..08ab451
--- /dev/null
+++ b/backend/internal/storage/contracttest/helpers_test.go
@@ -0,0 +1,23 @@
+package contracttest
+
+import (
+	"context"
+	"path/filepath"
+	"testing"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+)
+
+// NewSQLiteTestProvider 创建一个临时 SQLite Provider 用于测试。
+func NewSQLiteTestProvider(t *testing.T) storage.Provider {
+	t.Helper()
+	dbPath := filepath.Join(t.TempDir(), "test.db")
+	store, err := storage.NewSQLiteProvider(dbPath)
+	if err != nil {
+		t.Fatalf("NewSQLiteProvider: %v", err)
+	}
+	if err := store.Init(context.Background()); err != nil {
+		t.Fatalf("Init: %v", err)
+	}
+	return store
+}
diff --git a/backend/internal/storage/contracttest/import_query_contract_test.go b/backend/internal/storage/contracttest/import_query_contract_test.go
new file mode 100644
index 0000000..27f17c4
--- /dev/null
+++ b/backend/internal/storage/contracttest/import_query_contract_test.go
@@ -0,0 +1,218 @@
+package contracttest
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"testing"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	"github.com/google/uuid"
+)
+
+func testImportAndQuery(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	userID := "test-user-" + uuid.New().String()[:8]
+	export := msglayer.RootExport{
+		Version:    "msglayer/v0.1",
+		ExportedAt: time.Now().UTC().Format(time.RFC3339),
+		Source:     msglayer.Source{Platform: "android", DeviceID: "test"},
+		Identities: []msglayer.Identity{
+			{ID: "id_1", Type: "person", DisplayName: "张三", Phones: []string{"+8613800000001"}},
+			{ID: "id_2", Type: "person", DisplayName: "李四", Phones: []string{"+8613800000002"}},
+		},
+		Events: []msglayer.Event{
+			{
+				ID:           "evt_1",
+				Type:         "sms",
+				Timestamp:    time.Now().Add(-1 * time.Hour).UTC().Format(time.RFC3339),
+				Direction:    "outbound",
+				Participants: []string{"id_1"},
+				Content:      map[string]any{"text": "你好，验证码是123456"},
+			},
+			{
+				ID:           "evt_2",
+				Type:         "call",
+				Timestamp:    time.Now().UTC().Format(time.RFC3339),
+				Direction:    "inbound",
+				Participants: []string{"id_2"},
+				Content:      map[string]any{"duration_sec": 120, "call_type": "incoming"},
+			},
+		},
+	}
+	raw, _ := json.Marshal(export)
+
+	importID, err := store.Import(ctx, userID, "test.json", export, raw)
+	if err != nil {
+		t.Fatalf("Import: %v", err)
+	}
+	if importID == "" {
+		t.Fatal("expected import ID")
+	}
+
+	imports, err := store.ListImports(ctx, userID)
+	if err != nil {
+		t.Fatalf("ListImports: %v", err)
+	}
+	if len(imports) != 1 {
+		t.Fatalf("expected 1 import, got %d", len(imports))
+	}
+	if imports[0].EventCount != 2 {
+		t.Fatalf("expected 2 events, got %d", imports[0].EventCount)
+	}
+
+	exported, err := store.ExportImport(ctx, userID, importID)
+	if err != nil {
+		t.Fatalf("ExportImport: %v", err)
+	}
+	if len(exported) == 0 {
+		t.Fatal("expected exported data")
+	}
+
+	event, err := store.GetEvent(ctx, userID, "evt_1")
+	if err != nil {
+		t.Fatalf("GetEvent: %v", err)
+	}
+	if event.Type != "sms" {
+		t.Fatalf("expected sms type, got %s", event.Type)
+	}
+
+	results, err := store.Search(ctx, msglayer.SearchParams{UserID: userID, Keyword: "验证码", Limit: 10})
+	if err != nil {
+		t.Fatalf("Search: %v", err)
+	}
+	if len(results) == 0 {
+		t.Fatal("expected search results for '验证码'")
+	}
+
+	timeline, err := store.Timeline(ctx, msglayer.SearchParams{UserID: userID, Limit: 10})
+	if err != nil {
+		t.Fatalf("Timeline: %v", err)
+	}
+	if len(timeline) != 2 {
+		t.Fatalf("expected 2 timeline items, got %d", len(timeline))
+	}
+
+	identities, err := store.ListIdentities(ctx, userID)
+	if err != nil {
+		t.Fatalf("ListIdentities: %v", err)
+	}
+	if len(identities) != 2 {
+		t.Fatalf("expected 2 identities, got %d", len(identities))
+	}
+
+	identity, err := store.GetIdentity(ctx, userID, "id_1")
+	if err != nil {
+		t.Fatalf("GetIdentity: %v", err)
+	}
+	if identity.DisplayName != "张三" {
+		t.Fatalf("expected 张三, got %s", identity.DisplayName)
+	}
+
+	thread, err := store.GetThread(ctx, userID, "thread_42")
+	if err != nil {
+		t.Fatalf("GetThread: %v", err)
+	}
+	_ = thread
+}
+
+func testIdentityCRUD(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	userID := "crud-user-" + uuid.New().String()[:8]
+	identity := msglayer.Identity{
+		ID:          "identity_" + uuid.New().String()[:8],
+		Type:        "person",
+		DisplayName: "测试用户",
+		Phones:      []string{"+8613800000000"},
+		Emails:      []string{"test@example.com"},
+		Labels:      []string{"朋友"},
+		Meta:        map[string]any{"source": "test"},
+	}
+
+	export := msglayer.RootExport{
+		Version:    "msglayer/v0.1",
+		ExportedAt: time.Now().UTC().Format(time.RFC3339),
+		Identities: []msglayer.Identity{identity},
+		Events:     []msglayer.Event{},
+	}
+	raw, _ := json.Marshal(export)
+
+	if _, err := store.Import(ctx, userID, "", export, raw); err != nil {
+		t.Fatalf("Import: %v", err)
+	}
+
+	got, err := store.GetIdentity(ctx, userID, identity.ID)
+	if err != nil {
+		t.Fatalf("GetIdentity: %v", err)
+	}
+	if got.DisplayName != "测试用户" {
+		t.Fatalf("display name mismatch: got %s", got.DisplayName)
+	}
+	if len(got.Phones) != 1 || got.Phones[0] != "+8613800000000" {
+		t.Fatalf("phones mismatch: %v", got.Phones)
+	}
+}
+
+func testSearchPagination(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	userID := "page-user-" + uuid.New().String()[:8]
+	var events []msglayer.Event
+	for i := 0; i < 25; i++ {
+		events = append(events, msglayer.Event{
+			ID:        fmt.Sprintf("page_evt_%d", i),
+			Type:      "sms",
+			Timestamp: time.Now().Add(-time.Duration(25-i) * time.Minute).UTC().Format(time.RFC3339),
+			Direction: "outbound",
+			Content:   map[string]any{"text": fmt.Sprintf("消息编号 %d", i)},
+		})
+	}
+
+	export := msglayer.RootExport{
+		Version:    "msglayer/v0.1",
+		ExportedAt: time.Now().UTC().Format(time.RFC3339),
+		Events:     events,
+	}
+	raw, _ := json.Marshal(export)
+
+	if _, err := store.Import(ctx, userID, "", export, raw); err != nil {
+		t.Fatalf("Import: %v", err)
+	}
+
+	page1, err := store.ListEvents(ctx, msglayer.SearchParams{UserID: userID, Limit: 10, Offset: 0})
+	if err != nil {
+		t.Fatalf("ListEvents page1: %v", err)
+	}
+	if len(page1) != 10 {
+		t.Fatalf("expected 10 items, got %d", len(page1))
+	}
+
+	page2, err := store.ListEvents(ctx, msglayer.SearchParams{UserID: userID, Limit: 10, Offset: 10})
+	if err != nil {
+		t.Fatalf("ListEvents page2: %v", err)
+	}
+	if len(page2) != 10 {
+		t.Fatalf("expected 10 items, got %d", len(page2))
+	}
+
+	page3, err := store.ListEvents(ctx, msglayer.SearchParams{UserID: userID, Limit: 10, Offset: 20})
+	if err != nil {
+		t.Fatalf("ListEvents page3: %v", err)
+	}
+	if len(page3) != 5 {
+		t.Fatalf("expected 5 items, got %d", len(page3))
+	}
+
+	if page1[0].EventID == page2[0].EventID {
+		t.Fatal("page1 and page2 should not overlap")
+	}
+}
diff --git a/backend/internal/storage/contracttest/passkey_contract_test.go b/backend/internal/storage/contracttest/passkey_contract_test.go
new file mode 100644
index 0000000..328aa11
--- /dev/null
+++ b/backend/internal/storage/contracttest/passkey_contract_test.go
@@ -0,0 +1,111 @@
+package contracttest
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+	"github.com/google/uuid"
+)
+
+func testPasskeyCredential(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	user := storage.UserRecord{
+		ID: uuid.New().String(), UserName: "pk_" + uuid.New().String()[:8],
+		PasswordHash: "h", PasswordSalt: "s", Roles: []string{"R_USER"}, Buttons: []string{"view"},
+	}
+	if _, err := store.CreateUser(ctx, user); err != nil {
+		t.Fatal(err)
+	}
+
+	cred := storage.PasskeyCredential{
+		ID:           uuid.New().String(),
+		UserID:       user.ID,
+		CredentialID: "cred_" + uuid.New().String(),
+		PublicKey:    "pubkey_test",
+		Transports:   `["usb","nfc"]`,
+		Name:         "Test Key",
+	}
+	if err := store.CreatePasskeyCredential(ctx, cred); err != nil {
+		t.Fatalf("CreatePasskeyCredential: %v", err)
+	}
+
+	got, err := store.GetPasskeyByCredentialID(ctx, cred.CredentialID)
+	if err != nil {
+		t.Fatalf("GetPasskeyByCredentialID: %v", err)
+	}
+	if got.Name != "Test Key" {
+		t.Fatalf("name mismatch: %s", got.Name)
+	}
+
+	passkeys, err := store.ListPasskeysByUser(ctx, user.ID)
+	if err != nil {
+		t.Fatalf("ListPasskeysByUser: %v", err)
+	}
+	if len(passkeys) != 1 {
+		t.Fatalf("expected 1 passkey, got %d", len(passkeys))
+	}
+
+	if err := store.UpdatePasskeyLastUsed(ctx, cred.ID, 42); err != nil {
+		t.Fatalf("UpdatePasskeyLastUsed: %v", err)
+	}
+
+	if err := store.DeletePasskey(ctx, cred.ID, user.ID); err != nil {
+		t.Fatalf("DeletePasskey: %v", err)
+	}
+
+	passkeys, _ = store.ListPasskeysByUser(ctx, user.ID)
+	if len(passkeys) != 0 {
+		t.Fatalf("expected 0 passkeys after delete, got %d", len(passkeys))
+	}
+}
+
+func testChallengeLifecycle(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	chal := storage.ChallengeRecord{
+		ID:        uuid.New().String(),
+		Challenge: "test_challenge_value",
+		FlowType:  "passkey_login",
+		ExpiresAt: time.Now().Add(5 * time.Minute).UTC(),
+	}
+	if err := store.CreateChallenge(ctx, chal); err != nil {
+		t.Fatalf("CreateChallenge: %v", err)
+	}
+
+	got, err := store.GetChallenge(ctx, chal.ID)
+	if err != nil {
+		t.Fatalf("GetChallenge: %v", err)
+	}
+	if got.Challenge != "test_challenge_value" {
+		t.Fatalf("challenge mismatch: %s", got.Challenge)
+	}
+
+	if err := store.DeleteChallenge(ctx, chal.ID); err != nil {
+		t.Fatalf("DeleteChallenge: %v", err)
+	}
+
+	_, err = store.GetChallenge(ctx, chal.ID)
+	if err == nil {
+		t.Fatal("expected error for deleted challenge")
+	}
+
+	expired := storage.ChallengeRecord{
+		ID:        uuid.New().String(),
+		Challenge: "expired_challenge_value",
+		FlowType:  "passkey_login",
+		ExpiresAt: time.Now().Add(-1 * time.Minute).UTC(),
+	}
+	if err := store.CreateChallenge(ctx, expired); err != nil {
+		t.Fatalf("CreateChallenge expired: %v", err)
+	}
+	if _, err := store.GetChallenge(ctx, expired.ID); err == nil {
+		t.Fatal("expected error for expired challenge")
+	}
+}
diff --git a/backend/internal/storage/contracttest/setup_session_audit_contract_test.go b/backend/internal/storage/contracttest/setup_session_audit_contract_test.go
new file mode 100644
index 0000000..b1578ec
--- /dev/null
+++ b/backend/internal/storage/contracttest/setup_session_audit_contract_test.go
@@ -0,0 +1,166 @@
+package contracttest
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/storage"
+	"github.com/google/uuid"
+)
+
+func testSetupLifecycle(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	status, err := store.GetSetupStatus(ctx)
+	if err != nil {
+		t.Fatalf("GetSetupStatus: %v", err)
+	}
+	if status.Initialized {
+		t.Fatal("expected not initialized")
+	}
+
+	setup := storage.SetupRecord{
+		ID:            "setup_1",
+		Version:       "1.0.0",
+		InitializedAt: time.Now().UTC().Format(time.RFC3339),
+		UsageMode:     "personal",
+	}
+	if err := store.SaveSetup(ctx, setup); err != nil {
+		t.Fatalf("SaveSetup: %v", err)
+	}
+
+	status, err = store.GetSetupStatus(ctx)
+	if err != nil {
+		t.Fatalf("GetSetupStatus after save: %v", err)
+	}
+	if !status.Initialized {
+		t.Fatal("expected initialized")
+	}
+	if status.Version != "1.0.0" {
+		t.Fatalf("expected version 1.0.0, got %s", status.Version)
+	}
+}
+
+func testSessionLifecycle(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	user := storage.UserRecord{
+		ID: uuid.New().String(), UserName: "sess_" + uuid.New().String()[:8],
+		PasswordHash: "h", PasswordSalt: "s", Roles: []string{"R_USER"}, Buttons: []string{"view"},
+	}
+	if _, err := store.CreateUser(ctx, user); err != nil {
+		t.Fatal(err)
+	}
+
+	refreshTokenID := uuid.New().String()
+	if err := store.SaveRefreshToken(ctx, storage.RefreshTokenRecord{
+		ID:        refreshTokenID,
+		UserID:    user.ID,
+		TokenHash: "hash_" + uuid.New().String(),
+		ExpiresAt: time.Now().Add(24 * time.Hour),
+	}); err != nil {
+		t.Fatalf("SaveRefreshToken: %v", err)
+	}
+
+	session := storage.SessionRecord{
+		ID:             uuid.New().String(),
+		UserID:         user.ID,
+		RefreshTokenID: refreshTokenID,
+		IPAddress:      "127.0.0.1",
+		UserAgent:      "test-agent",
+	}
+	if err := store.CreateSession(ctx, session); err != nil {
+		t.Fatalf("CreateSession: %v", err)
+	}
+
+	byRefreshToken, err := store.GetSessionByRefreshTokenID(ctx, refreshTokenID)
+	if err != nil {
+		t.Fatalf("GetSessionByRefreshTokenID: %v", err)
+	}
+	if byRefreshToken.ID != session.ID {
+		t.Fatalf("session id mismatch by refresh token: got %s", byRefreshToken.ID)
+	}
+
+	sessions, err := store.ListSessionsByUser(ctx, user.ID)
+	if err != nil {
+		t.Fatalf("ListSessionsByUser: %v", err)
+	}
+	if len(sessions) != 1 {
+		t.Fatalf("expected 1 session, got %d", len(sessions))
+	}
+
+	otherRefreshTokenID := uuid.New().String()
+	if err := store.SaveRefreshToken(ctx, storage.RefreshTokenRecord{
+		ID:        otherRefreshTokenID,
+		UserID:    user.ID,
+		TokenHash: "hash_" + uuid.New().String(),
+		ExpiresAt: time.Now().Add(24 * time.Hour),
+	}); err != nil {
+		t.Fatalf("SaveRefreshToken other: %v", err)
+	}
+	otherSession := storage.SessionRecord{
+		ID:             uuid.New().String(),
+		UserID:         user.ID,
+		RefreshTokenID: otherRefreshTokenID,
+	}
+	if err := store.CreateSession(ctx, otherSession); err != nil {
+		t.Fatalf("CreateSession other: %v", err)
+	}
+
+	if err := store.RevokeOtherSessions(ctx, user.ID, session.ID); err != nil {
+		t.Fatalf("RevokeOtherSessions: %v", err)
+	}
+	sessions, err = store.ListSessionsByUser(ctx, user.ID)
+	if err != nil {
+		t.Fatalf("ListSessionsByUser after revoke others: %v", err)
+	}
+	if len(sessions) != 1 || sessions[0].ID != session.ID {
+		t.Fatalf("expected current session to remain after revoke others, got %+v", sessions)
+	}
+
+	if err := store.UpdateSessionLastSeen(ctx, session.ID); err != nil {
+		t.Fatalf("UpdateSessionLastSeen: %v", err)
+	}
+
+	if err := store.RevokeSession(ctx, session.ID); err != nil {
+		t.Fatalf("RevokeSession: %v", err)
+	}
+
+	sessions, _ = store.ListSessionsByUser(ctx, user.ID)
+	if len(sessions) != 0 {
+		t.Fatalf("expected 0 sessions after revoke, got %d", len(sessions))
+	}
+}
+
+func testAuditLog(t *testing.T, factory ProviderFactory) {
+	store := factory(t)
+	defer store.Close()
+	ctx := context.Background()
+
+	if err := store.CreateAuditLog(ctx, storage.AuditRecord{
+		ID: uuid.New().String(), Action: "login", IPAddress: "127.0.0.1",
+	}); err != nil {
+		t.Fatalf("CreateAuditLog: %v", err)
+	}
+
+	logs, err := store.ListAuditLogs(ctx, "", "", 10, 0)
+	if err != nil {
+		t.Fatalf("ListAuditLogs: %v", err)
+	}
+	if len(logs) != 1 {
+		t.Fatalf("expected 1 log, got %d", len(logs))
+	}
+
+	total, err := store.CountAuditLogs(ctx, "", "")
+	if err != nil {
+		t.Fatalf("CountAuditLogs: %v", err)
+	}
+	if total != 1 {
+		t.Fatalf("expected total 1, got %d", total)
+	}
+}
diff --git a/backend/internal/storage/contracttest/sqlite_test.go b/backend/internal/storage/contracttest/sqlite_test.go
new file mode 100644
index 0000000..88eb07a
--- /dev/null
+++ b/backend/internal/storage/contracttest/sqlite_test.go
@@ -0,0 +1,7 @@
+package contracttest
+
+import "testing"
+
+func TestSQLiteContract(t *testing.T) {
+	RunContractTests(t, NewSQLiteTestProvider)
+}
diff --git a/backend/internal/storage/filestore.go b/backend/internal/storage/filestore.go
new file mode 100644
index 0000000..65e7bf7
--- /dev/null
+++ b/backend/internal/storage/filestore.go
@@ -0,0 +1,136 @@
+package storage
+
+import (
+	"context"
+	"encoding/json"
+	"os"
+	"sync"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+)
+
+type storeSnapshot struct {
+	Users         map[string]UserRecord         `json:"users"`
+	RefreshTokens map[string]RefreshTokenRecord `json:"refresh_tokens"`
+	Sessions      map[string]SessionRecord      `json:"sessions"`
+	AuditLogs     map[string]AuditRecord        `json:"audit_logs"`
+	Passkeys      map[string]PasskeyCredential  `json:"passkeys"`
+	Challenges    map[string]ChallengeRecord    `json:"challenges"`
+	AuthMethods   map[string]AuthMethodRecord   `json:"auth_methods"`
+	Imports       map[string]storedImport       `json:"imports"`
+	Identities    map[string]storedIdentity     `json:"identities"`
+	Events        map[string]storedEvent        `json:"events"`
+	Setup         *SetupRecord                  `json:"setup,omitempty"`
+}
+
+type storedImport struct {
+	ID            string `json:"id"`
+	UserID        string `json:"user_id"`
+	SchemaVersion string `json:"schema_version"`
+	ImportedAt    string `json:"imported_at"`
+	SourcePath    string `json:"source_path"`
+	RawJSON       string `json:"raw_json"`
+	EventCount    int    `json:"event_count"`
+	IdentityCount int    `json:"identity_count"`
+}
+
+type storedIdentity struct {
+	UserID   string            `json:"user_id"`
+	Identity msglayer.Identity `json:"identity"`
+}
+
+type storedEvent struct {
+	UserID   string                `json:"user_id"`
+	ImportID string                `json:"import_id"`
+	Item     msglayer.TimelineItem `json:"item"`
+	Raw      msglayer.Event        `json:"raw"`
+}
+
+type fileStore struct {
+	mu       sync.RWMutex
+	name     string
+	path     string
+	snapshot storeSnapshot
+}
+
+func newFileStore(path, name string) Provider {
+	return &fileStore{
+		name: name,
+		path: path,
+		snapshot: storeSnapshot{
+			Users:         map[string]UserRecord{},
+			RefreshTokens: map[string]RefreshTokenRecord{},
+			Sessions:      map[string]SessionRecord{},
+			AuditLogs:     map[string]AuditRecord{},
+			Passkeys:      map[string]PasskeyCredential{},
+			Challenges:    map[string]ChallengeRecord{},
+			AuthMethods:   map[string]AuthMethodRecord{},
+			Imports:       map[string]storedImport{},
+			Identities:    map[string]storedIdentity{},
+			Events:        map[string]storedEvent{},
+		},
+	}
+}
+
+func NewFileStoreProvider(path string) (Provider, error) {
+	return newFileStore(path, "filestore"), nil
+}
+
+func (s *fileStore) Name() string { return s.name }
+
+func (s *fileStore) Close() error { return nil }
+
+func (s *fileStore) Init(ctx context.Context) error {
+	_ = ctx
+	if err := EnsureParentDir(s.path); err != nil {
+		return err
+	}
+	data, err := os.ReadFile(s.path)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return s.persist()
+		}
+		return err
+	}
+	if len(data) == 0 {
+		return nil
+	}
+	if err := json.Unmarshal(data, &s.snapshot); err != nil {
+		return err
+	}
+	s.initMaps()
+	return nil
+}
+
+func (s *fileStore) initMaps() {
+	if s.snapshot.Users == nil {
+		s.snapshot.Users = map[string]UserRecord{}
+	}
+	if s.snapshot.RefreshTokens == nil {
+		s.snapshot.RefreshTokens = map[string]RefreshTokenRecord{}
+	}
+	if s.snapshot.Sessions == nil {
+		s.snapshot.Sessions = map[string]SessionRecord{}
+	}
+	if s.snapshot.AuditLogs == nil {
+		s.snapshot.AuditLogs = map[string]AuditRecord{}
+	}
+	if s.snapshot.Passkeys == nil {
+		s.snapshot.Passkeys = map[string]PasskeyCredential{}
+	}
+	if s.snapshot.Challenges == nil {
+		s.snapshot.Challenges = map[string]ChallengeRecord{}
+	}
+	if s.snapshot.AuthMethods == nil {
+		s.snapshot.AuthMethods = map[string]AuthMethodRecord{}
+	}
+	if s.snapshot.Imports == nil {
+		s.snapshot.Imports = map[string]storedImport{}
+	}
+	if s.snapshot.Identities == nil {
+		s.snapshot.Identities = map[string]storedIdentity{}
+	}
+	if s.snapshot.Events == nil {
+		s.snapshot.Events = map[string]storedEvent{}
+	}
+}
diff --git a/backend/internal/storage/filestore_auth_session.go b/backend/internal/storage/filestore_auth_session.go
new file mode 100644
index 0000000..6854b57
--- /dev/null
+++ b/backend/internal/storage/filestore_auth_session.go
@@ -0,0 +1,262 @@
+package storage
+
+import (
+	"context"
+	"fmt"
+	"sort"
+	"strings"
+	"time"
+)
+
+func (s *fileStore) CreateUser(ctx context.Context, user UserRecord) (UserRecord, error) {
+	_ = ctx
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	for _, existing := range s.snapshot.Users {
+		if strings.EqualFold(existing.UserName, user.UserName) {
+			return UserRecord{}, fmt.Errorf("username already exists")
+		}
+	}
+	s.snapshot.Users[user.ID] = user
+	return user, s.persist()
+}
+
+func (s *fileStore) FindUserByUserName(ctx context.Context, userName string) (UserRecord, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	for _, user := range s.snapshot.Users {
+		if strings.EqualFold(user.UserName, userName) {
+			return user, nil
+		}
+	}
+	return UserRecord{}, fmt.Errorf("user not found")
+}
+
+func (s *fileStore) GetUser(ctx context.Context, userID string) (UserRecord, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	user, ok := s.snapshot.Users[userID]
+	if !ok {
+		return UserRecord{}, fmt.Errorf("user not found")
+	}
+	return user, nil
+}
+
+func (s *fileStore) SaveRefreshToken(ctx context.Context, token RefreshTokenRecord) error {
+	_ = ctx
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	s.snapshot.RefreshTokens[token.ID] = token
+	return s.persist()
+}
+
+func (s *fileStore) ConsumeRefreshToken(ctx context.Context, tokenHash string) (RefreshTokenRecord, error) {
+	_ = ctx
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	for key, token := range s.snapshot.RefreshTokens {
+		if token.TokenHash != tokenHash {
+			continue
+		}
+		if !token.RevokedAt.IsZero() {
+			return RefreshTokenRecord{}, fmt.Errorf("refresh token revoked")
+		}
+		if time.Now().After(token.ExpiresAt) {
+			return RefreshTokenRecord{}, fmt.Errorf("refresh token expired")
+		}
+		token.RevokedAt = time.Now().UTC()
+		s.snapshot.RefreshTokens[key] = token
+		if err := s.persist(); err != nil {
+			return RefreshTokenRecord{}, err
+		}
+		return token, nil
+	}
+	return RefreshTokenRecord{}, fmt.Errorf("refresh token not found")
+}
+
+func (s *fileStore) UpdateUserPasswordHash(ctx context.Context, userID, newHash, newSalt string) error {
+	_ = ctx
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	user, ok := s.snapshot.Users[userID]
+	if !ok {
+		return fmt.Errorf("user not found")
+	}
+	user.PasswordHash = newHash
+	user.PasswordSalt = newSalt
+	user.UpdatedAt = time.Now().UTC()
+	s.snapshot.Users[userID] = user
+	return s.persist()
+}
+
+func (s *fileStore) FindAnyRefreshTokenByHash(_ context.Context, tokenHash string) (RefreshTokenRecord, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	for _, token := range s.snapshot.RefreshTokens {
+		if token.TokenHash == tokenHash {
+			return token, nil
+		}
+	}
+	return RefreshTokenRecord{}, fmt.Errorf("refresh token not found")
+}
+
+func (s *fileStore) HasActiveRefreshTokenChild(_ context.Context, parentID string) (bool, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	now := time.Now().UTC()
+	for _, token := range s.snapshot.RefreshTokens {
+		if token.ParentID != parentID {
+			continue
+		}
+		if token.RevokedAt.IsZero() && token.ExpiresAt.After(now) {
+			return true, nil
+		}
+	}
+	return false, nil
+}
+
+func (s *fileStore) RevokeRefreshTokenFamily(_ context.Context, tokenID string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	queue := []string{tokenID}
+	seen := map[string]struct{}{}
+	now := time.Now().UTC()
+	for len(queue) > 0 {
+		current := queue[0]
+		queue = queue[1:]
+		if _, ok := seen[current]; ok {
+			continue
+		}
+		seen[current] = struct{}{}
+		if token, ok := s.snapshot.RefreshTokens[current]; ok && token.RevokedAt.IsZero() {
+			token.RevokedAt = now
+			s.snapshot.RefreshTokens[current] = token
+		}
+		for id, token := range s.snapshot.RefreshTokens {
+			if token.ParentID == current {
+				queue = append(queue, id)
+			}
+		}
+	}
+	return s.persist()
+}
+
+func (s *fileStore) RevokeRefreshTokenByID(_ context.Context, tokenID string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	token, ok := s.snapshot.RefreshTokens[tokenID]
+	if !ok {
+		return nil
+	}
+	if token.RevokedAt.IsZero() {
+		token.RevokedAt = time.Now().UTC()
+		s.snapshot.RefreshTokens[tokenID] = token
+	}
+	return s.persist()
+}
+
+func (s *fileStore) CreateSession(_ context.Context, rec SessionRecord) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	s.snapshot.Sessions[rec.ID] = rec
+	return s.persist()
+}
+
+func (s *fileStore) GetSession(_ context.Context, sessionID string) (SessionRecord, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	session, ok := s.snapshot.Sessions[sessionID]
+	if !ok {
+		return SessionRecord{}, fmt.Errorf("session not found")
+	}
+	return session, nil
+}
+
+func (s *fileStore) GetSessionByRefreshTokenID(_ context.Context, refreshTokenID string) (SessionRecord, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	for _, session := range s.snapshot.Sessions {
+		if session.RefreshTokenID == refreshTokenID {
+			return session, nil
+		}
+	}
+	return SessionRecord{}, fmt.Errorf("session not found")
+}
+
+func (s *fileStore) ListSessionsByUser(_ context.Context, userID string) ([]SessionRecord, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	items := make([]SessionRecord, 0, len(s.snapshot.Sessions))
+	for _, session := range s.snapshot.Sessions {
+		if session.UserID != userID {
+			continue
+		}
+		items = append(items, session)
+	}
+	sort.Slice(items, func(i, j int) bool { return items[i].LastSeenAt.After(items[j].LastSeenAt) })
+	return items, nil
+}
+
+func (s *fileStore) RevokeSession(_ context.Context, sessionID string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	session, ok := s.snapshot.Sessions[sessionID]
+	if !ok {
+		return nil
+	}
+	session.LastSeenAt = time.Now().UTC()
+	delete(s.snapshot.Sessions, sessionID)
+	if session.RefreshTokenID != "" {
+		if token, ok := s.snapshot.RefreshTokens[session.RefreshTokenID]; ok && token.RevokedAt.IsZero() {
+			token.RevokedAt = time.Now().UTC()
+			s.snapshot.RefreshTokens[session.RefreshTokenID] = token
+		}
+	}
+	return s.persist()
+}
+
+func (s *fileStore) RevokeOtherSessions(_ context.Context, userID, currentSessionID string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	now := time.Now().UTC()
+	for id, session := range s.snapshot.Sessions {
+		if session.UserID != userID || id == currentSessionID {
+			continue
+		}
+		if session.RefreshTokenID != "" {
+			if token, ok := s.snapshot.RefreshTokens[session.RefreshTokenID]; ok && token.RevokedAt.IsZero() {
+				token.RevokedAt = now
+				s.snapshot.RefreshTokens[session.RefreshTokenID] = token
+			}
+		}
+		delete(s.snapshot.Sessions, id)
+	}
+	return s.persist()
+}
+
+func (s *fileStore) UpdateSessionLastSeen(_ context.Context, sessionID string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	session, ok := s.snapshot.Sessions[sessionID]
+	if !ok {
+		return fmt.Errorf("session not found")
+	}
+	session.LastSeenAt = time.Now().UTC()
+	s.snapshot.Sessions[sessionID] = session
+	return s.persist()
+}
+
+func (s *fileStore) UpdateSessionRefreshToken(_ context.Context, sessionID, refreshTokenID string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	session, ok := s.snapshot.Sessions[sessionID]
+	if !ok {
+		return fmt.Errorf("session not found")
+	}
+	session.RefreshTokenID = refreshTokenID
+	session.LastSeenAt = time.Now().UTC()
+	s.snapshot.Sessions[sessionID] = session
+	return s.persist()
+}
diff --git a/backend/internal/storage/filestore_imports_query.go b/backend/internal/storage/filestore_imports_query.go
new file mode 100644
index 0000000..302aab2
--- /dev/null
+++ b/backend/internal/storage/filestore_imports_query.go
@@ -0,0 +1,231 @@
+package storage
+
+import (
+	"context"
+	"fmt"
+	"sort"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+)
+
+func (s *fileStore) Import(ctx context.Context, userID string, sourcePath string, export msglayer.RootExport, raw []byte) (string, error) {
+	_ = ctx
+	s.mu.Lock()
+	defer s.mu.Unlock()
+
+	importID := fmt.Sprintf("import_%d", time.Now().UnixNano())
+	s.snapshot.Imports[importID] = storedImport{
+		ID:            importID,
+		UserID:        userID,
+		SchemaVersion: export.Version,
+		ImportedAt:    time.Now().UTC().Format(time.RFC3339),
+		SourcePath:    sourcePath,
+		RawJSON:       string(raw),
+		EventCount:    len(export.Events),
+		IdentityCount: len(export.Identities),
+	}
+	for _, identity := range export.Identities {
+		s.snapshot.Identities[scopeKey(userID, identity.ID)] = storedIdentity{
+			UserID:   userID,
+			Identity: identity,
+		}
+	}
+	for _, event := range export.Events {
+		s.snapshot.Events[scopeKey(userID, event.ID)] = storedEvent{
+			UserID:   userID,
+			ImportID: importID,
+			Item: msglayer.TimelineItem{
+				EventID:        event.ID,
+				Type:           event.Type,
+				Timestamp:      event.Timestamp,
+				Direction:      event.Direction,
+				ContentSummary: summarizeEvent(event),
+				Participants:   append([]string(nil), event.Participants...),
+				Meta:           event.Meta,
+				SchemaVersion:  export.Version,
+			},
+			Raw: event,
+		}
+	}
+	return importID, s.persist()
+}
+
+func (s *fileStore) ListImports(ctx context.Context, userID string) ([]ImportSummary, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+
+	items := make([]ImportSummary, 0, len(s.snapshot.Imports))
+	for _, item := range s.snapshot.Imports {
+		if item.UserID != userID {
+			continue
+		}
+		importedAt, _ := time.Parse(time.RFC3339, item.ImportedAt)
+		items = append(items, ImportSummary{
+			ID:            item.ID,
+			UserID:        item.UserID,
+			SchemaVersion: item.SchemaVersion,
+			ImportedAt:    importedAt,
+			SourcePath:    item.SourcePath,
+			EventCount:    item.EventCount,
+			IdentityCount: item.IdentityCount,
+		})
+	}
+	sort.Slice(items, func(i, j int) bool { return items[i].ImportedAt.After(items[j].ImportedAt) })
+	return items, nil
+}
+
+func (s *fileStore) ExportImport(ctx context.Context, userID, importID string) ([]byte, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	if importID == "" {
+		var err error
+		importID, err = s.latestImportIDLocked(userID)
+		if err != nil {
+			return nil, err
+		}
+	}
+	item, ok := s.snapshot.Imports[importID]
+	if !ok || item.UserID != userID {
+		return nil, fmt.Errorf("import not found: %s", importID)
+	}
+	return []byte(item.RawJSON), nil
+}
+
+func (s *fileStore) LatestImportID(ctx context.Context, userID string) (string, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	return s.latestImportIDLocked(userID)
+}
+
+func (s *fileStore) latestImportIDLocked(userID string) (string, error) {
+	imports := make([]storedImport, 0, len(s.snapshot.Imports))
+	for _, item := range s.snapshot.Imports {
+		if item.UserID != userID {
+			continue
+		}
+		imports = append(imports, item)
+	}
+	if len(imports) == 0 {
+		return "", fmt.Errorf("no imports found")
+	}
+	sort.Slice(imports, func(i, j int) bool { return imports[i].ImportedAt > imports[j].ImportedAt })
+	return imports[0].ID, nil
+}
+
+func (s *fileStore) GetEvent(ctx context.Context, userID, id string) (msglayer.TimelineItem, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	item, ok := s.lookupScopedEventKey(s.snapshot.Events, userID, id)
+	if !ok {
+		return msglayer.TimelineItem{}, fmt.Errorf("event not found: %s", id)
+	}
+	return item.Item, nil
+}
+
+func (s *fileStore) ListEvents(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	return s.filterEvents(ctx, params, false)
+}
+
+func (s *fileStore) Search(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	return s.filterEvents(ctx, params, true)
+}
+
+func (s *fileStore) Timeline(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	return s.filterEvents(ctx, params, false)
+}
+
+func (s *fileStore) filterEvents(ctx context.Context, params msglayer.SearchParams, keywordOnly bool) ([]msglayer.TimelineItem, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+
+	var items []msglayer.TimelineItem
+	for _, stored := range s.snapshot.Events {
+		if stored.UserID != params.UserID {
+			continue
+		}
+		if keywordOnly && params.Keyword == "" {
+			continue
+		}
+		if params.Keyword != "" && !matchesKeyword(stored, params.Keyword) {
+			continue
+		}
+		if params.ContactID != "" && !contains(stored.Item.Participants, params.ContactID) {
+			continue
+		}
+		if params.Participant != "" && !contains(stored.Item.Participants, params.Participant) {
+			continue
+		}
+		if params.Type != "" && stored.Item.Type != params.Type {
+			continue
+		}
+		if params.From != "" && stored.Item.Timestamp < params.From {
+			continue
+		}
+		if params.To != "" && stored.Item.Timestamp > params.To {
+			continue
+		}
+		items = append(items, stored.Item)
+	}
+	sort.Slice(items, func(i, j int) bool { return items[i].Timestamp > items[j].Timestamp })
+	if params.Offset > 0 && params.Offset < len(items) {
+		items = items[params.Offset:]
+	} else if params.Offset >= len(items) {
+		items = nil
+	}
+	if params.Limit > 0 && len(items) > params.Limit {
+		items = items[:params.Limit]
+	}
+	return items, nil
+}
+
+func (s *fileStore) ListIdentities(ctx context.Context, userID string) ([]msglayer.Identity, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	items := make([]msglayer.Identity, 0, len(s.snapshot.Identities))
+	for _, identity := range s.snapshot.Identities {
+		if identity.UserID != userID {
+			continue
+		}
+		items = append(items, identity.Identity)
+	}
+	sort.Slice(items, func(i, j int) bool { return items[i].DisplayName < items[j].DisplayName })
+	return items, nil
+}
+
+func (s *fileStore) GetIdentity(ctx context.Context, userID, id string) (msglayer.Identity, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	identity, ok := s.lookupScopedKey(s.snapshot.Identities, userID, id)
+	if !ok {
+		return msglayer.Identity{}, fmt.Errorf("identity not found: %s", id)
+	}
+	return identity.Identity, nil
+}
+
+func (s *fileStore) GetThread(ctx context.Context, userID, threadID string) ([]msglayer.TimelineItem, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	var items []msglayer.TimelineItem
+	for _, stored := range s.snapshot.Events {
+		if stored.UserID != userID {
+			continue
+		}
+		for _, relation := range stored.Raw.Relations {
+			if relation.Type == "same_thread" && relation.Target == threadID {
+				items = append(items, stored.Item)
+				break
+			}
+		}
+	}
+	sort.Slice(items, func(i, j int) bool { return items[i].Timestamp < items[j].Timestamp })
+	return items, nil
+}
diff --git a/backend/internal/storage/filestore_setup_passkey.go b/backend/internal/storage/filestore_setup_passkey.go
new file mode 100644
index 0000000..9a1288c
--- /dev/null
+++ b/backend/internal/storage/filestore_setup_passkey.go
@@ -0,0 +1,191 @@
+package storage
+
+import (
+	"context"
+	"fmt"
+	"sort"
+	"time"
+)
+
+func (s *fileStore) GetSetupStatus(ctx context.Context) (SetupStatus, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	if s.snapshot.Setup != nil {
+		return SetupStatus{Initialized: true, Version: s.snapshot.Setup.Version, DatabaseType: "sqlite"}, nil
+	}
+	hasAdmin, _ := s.hasAdminUserLocked()
+	return SetupStatus{Initialized: hasAdmin, DatabaseType: "sqlite"}, nil
+}
+
+func (s *fileStore) SaveSetup(ctx context.Context, setup SetupRecord) error {
+	_ = ctx
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	s.snapshot.Setup = &setup
+	return s.persist()
+}
+
+func (s *fileStore) HasAdminUser(ctx context.Context) (bool, error) {
+	_ = ctx
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	return s.hasAdminUserLocked()
+}
+
+func (s *fileStore) hasAdminUserLocked() (bool, error) {
+	for _, user := range s.snapshot.Users {
+		for _, role := range user.Roles {
+			if role == "R_ADMIN" || role == "R_SUPER" {
+				return true, nil
+			}
+		}
+	}
+	return false, nil
+}
+
+func (s *fileStore) CreateAuditLog(_ context.Context, rec AuditRecord) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	s.snapshot.AuditLogs[rec.ID] = rec
+	return s.persist()
+}
+
+func (s *fileStore) ListAuditLogs(_ context.Context, userID, action string, limit, offset int) ([]AuditRecord, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	items := make([]AuditRecord, 0, len(s.snapshot.AuditLogs))
+	for _, rec := range s.snapshot.AuditLogs {
+		if userID != "" && rec.UserID != userID {
+			continue
+		}
+		if action != "" && rec.Action != action {
+			continue
+		}
+		items = append(items, rec)
+	}
+	sort.Slice(items, func(i, j int) bool { return items[i].CreatedAt.After(items[j].CreatedAt) })
+	if offset > 0 && offset < len(items) {
+		items = items[offset:]
+	} else if offset >= len(items) {
+		return nil, nil
+	}
+	if limit > 0 && len(items) > limit {
+		items = items[:limit]
+	}
+	return items, nil
+}
+
+func (s *fileStore) CountAuditLogs(ctx context.Context, userID, action string) (int, error) {
+	items, err := s.ListAuditLogs(ctx, userID, action, 0, 0)
+	if err != nil {
+		return 0, err
+	}
+	return len(items), nil
+}
+
+func (s *fileStore) CreatePasskeyCredential(_ context.Context, rec PasskeyCredential) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	s.snapshot.Passkeys[rec.ID] = rec
+	return s.persist()
+}
+
+func (s *fileStore) GetPasskeyByCredentialID(_ context.Context, credentialID string) (PasskeyCredential, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	for _, passkey := range s.snapshot.Passkeys {
+		if passkey.CredentialID == credentialID {
+			return passkey, nil
+		}
+	}
+	return PasskeyCredential{}, fmt.Errorf("passkey not found")
+}
+
+func (s *fileStore) ListPasskeysByUser(_ context.Context, userID string) ([]PasskeyCredential, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	items := make([]PasskeyCredential, 0, len(s.snapshot.Passkeys))
+	for _, passkey := range s.snapshot.Passkeys {
+		if passkey.UserID != userID {
+			continue
+		}
+		items = append(items, passkey)
+	}
+	sort.Slice(items, func(i, j int) bool { return items[i].CreatedAt.After(items[j].CreatedAt) })
+	return items, nil
+}
+
+func (s *fileStore) UpdatePasskeyLastUsed(_ context.Context, id string, signCount uint32) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	passkey, ok := s.snapshot.Passkeys[id]
+	if !ok {
+		return fmt.Errorf("passkey not found")
+	}
+	passkey.SignCount = signCount
+	passkey.LastUsedAt = time.Now().UTC()
+	s.snapshot.Passkeys[id] = passkey
+	return s.persist()
+}
+
+func (s *fileStore) DeletePasskey(_ context.Context, id, userID string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	passkey, ok := s.snapshot.Passkeys[id]
+	if !ok || passkey.UserID != userID {
+		return nil
+	}
+	delete(s.snapshot.Passkeys, id)
+	return s.persist()
+}
+
+func (s *fileStore) CreateChallenge(_ context.Context, rec ChallengeRecord) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	if rec.CreatedAt.IsZero() {
+		rec.CreatedAt = time.Now().UTC()
+	}
+	s.snapshot.Challenges[rec.ID] = rec
+	return s.persist()
+}
+
+func (s *fileStore) GetChallenge(_ context.Context, id string) (ChallengeRecord, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	challenge, ok := s.snapshot.Challenges[id]
+	if !ok || time.Now().UTC().After(challenge.ExpiresAt) {
+		return ChallengeRecord{}, fmt.Errorf("challenge not found")
+	}
+	return challenge, nil
+}
+
+func (s *fileStore) DeleteChallenge(_ context.Context, id string) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	delete(s.snapshot.Challenges, id)
+	return s.persist()
+}
+
+func (s *fileStore) CreateAuthMethod(_ context.Context, rec AuthMethodRecord) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	for _, existing := range s.snapshot.AuthMethods {
+		if existing.ProviderType == rec.ProviderType && existing.ProviderUserID == rec.ProviderUserID {
+			return fmt.Errorf("auth method already exists")
+		}
+	}
+	s.snapshot.AuthMethods[rec.ID] = rec
+	return s.persist()
+}
+
+func (s *fileStore) GetAuthMethodByProvider(_ context.Context, providerType, providerUserID string) (AuthMethodRecord, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	for _, rec := range s.snapshot.AuthMethods {
+		if rec.ProviderType == providerType && rec.ProviderUserID == providerUserID {
+			return rec, nil
+		}
+	}
+	return AuthMethodRecord{}, fmt.Errorf("auth method not found")
+}
diff --git a/backend/internal/storage/filestore_support.go b/backend/internal/storage/filestore_support.go
new file mode 100644
index 0000000..da523e4
--- /dev/null
+++ b/backend/internal/storage/filestore_support.go
@@ -0,0 +1,113 @@
+package storage
+
+import (
+	"crypto/sha1"
+	"encoding/json"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+)
+
+func EnsureParentDir(path string) error {
+	dir := filepath.Dir(path)
+	if dir == "." || dir == "" {
+		return nil
+	}
+	return os.MkdirAll(dir, 0o755)
+}
+
+func (s *fileStore) persist() error {
+	data, err := json.MarshalIndent(s.snapshot, "", "  ")
+	if err != nil {
+		return err
+	}
+	return os.WriteFile(s.path, data, 0o644)
+}
+
+func scopeKey(userID, rawID string) string {
+	hash := sha1.Sum([]byte(userID))
+	return fmt.Sprintf("%x:%s", hash[:8], rawID)
+}
+
+func scopeKeyLegacy(userID, rawID string) string {
+	hash := sha1.Sum([]byte(userID))
+	return fmt.Sprintf("%x:%s", hash[:4], rawID)
+}
+
+func (s *fileStore) lookupScopedKey(m map[string]storedIdentity, userID, rawID string) (storedIdentity, bool) {
+	key := scopeKey(userID, rawID)
+	if v, ok := m[key]; ok && v.UserID == userID {
+		return v, true
+	}
+	key = scopeKeyLegacy(userID, rawID)
+	if v, ok := m[key]; ok && v.UserID == userID {
+		return v, true
+	}
+	return storedIdentity{}, false
+}
+
+func (s *fileStore) lookupScopedEventKey(m map[string]storedEvent, userID, rawID string) (storedEvent, bool) {
+	key := scopeKey(userID, rawID)
+	if v, ok := m[key]; ok && v.UserID == userID {
+		return v, true
+	}
+	key = scopeKeyLegacy(userID, rawID)
+	if v, ok := m[key]; ok && v.UserID == userID {
+		return v, true
+	}
+	return storedEvent{}, false
+}
+
+func summarizeEvent(event msglayer.Event) string {
+	switch event.Type {
+	case "sms":
+		return asString(event.Content["text"])
+	case "call":
+		return fmt.Sprintf("%s %vsec", asString(event.Content["call_type"]), event.Content["duration_sec"])
+	case "voice":
+		if summary := asString(event.Content["summary"]); summary != "" {
+			return summary
+		}
+		return asString(event.Content["transcript"])
+	case "contact_snapshot":
+		return asString(event.Content["identity_id"])
+	default:
+		return event.Type
+	}
+}
+
+func matchesKeyword(event storedEvent, keyword string) bool {
+	needle := strings.ToLower(keyword)
+	if strings.Contains(strings.ToLower(event.Item.ContentSummary), needle) {
+		return true
+	}
+	if transcript := asString(event.Raw.Content["transcript"]); strings.Contains(strings.ToLower(transcript), needle) {
+		return true
+	}
+	if summary := asString(event.Raw.Content["summary"]); strings.Contains(strings.ToLower(summary), needle) {
+		return true
+	}
+	return false
+}
+
+func contains(values []string, target string) bool {
+	for _, value := range values {
+		if value == target {
+			return true
+		}
+	}
+	return false
+}
+
+func asString(v any) string {
+	if v == nil {
+		return ""
+	}
+	if value, ok := v.(string); ok {
+		return value
+	}
+	return fmt.Sprintf("%v", v)
+}
diff --git a/backend/internal/storage/migrations/sqlite/0001_initial.down.sql b/backend/internal/storage/migrations/sqlite/0001_initial.down.sql
new file mode 100644
index 0000000..049ed09
--- /dev/null
+++ b/backend/internal/storage/migrations/sqlite/0001_initial.down.sql
@@ -0,0 +1,11 @@
+DROP TABLE IF EXISTS schema_migrations;
+DROP TABLE IF EXISTS setup;
+DROP TABLE IF EXISTS audit_log;
+DROP TABLE IF EXISTS relations;
+DROP TABLE IF EXISTS event_participants;
+DROP TABLE IF EXISTS events;
+DROP TABLE IF EXISTS identities;
+DROP TABLE IF EXISTS imports;
+DROP TABLE IF EXISTS sessions;
+DROP TABLE IF EXISTS refresh_tokens;
+DROP TABLE IF EXISTS users;
diff --git a/backend/internal/storage/migrations/sqlite/0001_initial.up.sql b/backend/internal/storage/migrations/sqlite/0001_initial.up.sql
new file mode 100644
index 0000000..6c428dc
--- /dev/null
+++ b/backend/internal/storage/migrations/sqlite/0001_initial.up.sql
@@ -0,0 +1,149 @@
+-- Commory SQLite schema v1
+-- 用户表
+CREATE TABLE IF NOT EXISTS users (
+    id            TEXT PRIMARY KEY,
+    user_name     TEXT NOT NULL UNIQUE,
+    email         TEXT,
+    password_hash TEXT NOT NULL,
+    password_salt TEXT NOT NULL,
+    roles         TEXT NOT NULL DEFAULT '["R_USER"]',
+    buttons       TEXT NOT NULL DEFAULT '["view","import"]',
+    created_at    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_users_user_name ON users(user_name);
+
+-- 刷新令牌表
+CREATE TABLE IF NOT EXISTS refresh_tokens (
+    id         TEXT PRIMARY KEY,
+    user_id    TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    token_hash TEXT NOT NULL UNIQUE,
+    parent_id  TEXT REFERENCES refresh_tokens(id),
+    expires_at DATETIME NOT NULL,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    revoked_at DATETIME
+);
+
+CREATE INDEX IF NOT EXISTS idx_refresh_tokens_user_id ON refresh_tokens(user_id);
+CREATE INDEX IF NOT EXISTS idx_refresh_tokens_token_hash ON refresh_tokens(token_hash);
+CREATE INDEX IF NOT EXISTS idx_refresh_tokens_expires ON refresh_tokens(expires_at);
+
+-- 会话表
+CREATE TABLE IF NOT EXISTS sessions (
+    id               TEXT PRIMARY KEY,
+    user_id          TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    refresh_token_id TEXT REFERENCES refresh_tokens(id) ON DELETE SET NULL,
+    device_name      TEXT,
+    device_type      TEXT,
+    ip_address       TEXT,
+    user_agent       TEXT,
+    created_at       DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    last_seen_at     DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    revoked_at       DATETIME
+);
+
+CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON sessions(user_id);
+
+-- 导入记录表
+CREATE TABLE IF NOT EXISTS imports (
+    id             TEXT PRIMARY KEY,
+    user_id        TEXT NOT NULL,
+    schema_version TEXT NOT NULL,
+    is_delta       BOOLEAN NOT NULL DEFAULT FALSE,
+    imported_at    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    source_path    TEXT,
+    event_count    INTEGER NOT NULL DEFAULT 0,
+    identity_count INTEGER NOT NULL DEFAULT 0,
+    raw_json       TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_imports_user_id ON imports(user_id);
+CREATE INDEX IF NOT EXISTS idx_imports_imported_at ON imports(imported_at);
+
+-- 身份/联系人表
+CREATE TABLE IF NOT EXISTS identities (
+    id           TEXT PRIMARY KEY,
+    user_id      TEXT NOT NULL,
+    type         TEXT NOT NULL,
+    display_name TEXT NOT NULL,
+    phones       TEXT NOT NULL DEFAULT '[]',
+    emails       TEXT NOT NULL DEFAULT '[]',
+    avatar       TEXT,
+    labels       TEXT NOT NULL DEFAULT '[]',
+    meta         TEXT NOT NULL DEFAULT '{}',
+    created_at   DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at   DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_identities_user_id ON identities(user_id);
+CREATE INDEX IF NOT EXISTS idx_identities_type ON identities(type);
+
+-- 通信事件表
+CREATE TABLE IF NOT EXISTS events (
+    id              TEXT PRIMARY KEY,
+    user_id         TEXT NOT NULL,
+    import_id       TEXT,
+    type            TEXT NOT NULL,
+    timestamp       DATETIME NOT NULL,
+    direction       TEXT NOT NULL,
+    content_summary TEXT,
+    content         TEXT NOT NULL DEFAULT '{}',
+    meta            TEXT NOT NULL DEFAULT '{}',
+    created_at      DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_events_user_id ON events(user_id);
+CREATE INDEX IF NOT EXISTS idx_events_import_id ON events(import_id);
+CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+CREATE INDEX IF NOT EXISTS idx_events_user_type ON events(user_id, type);
+CREATE INDEX IF NOT EXISTS idx_events_user_timestamp ON events(user_id, timestamp DESC);
+
+-- 事件参与者表
+CREATE TABLE IF NOT EXISTS event_participants (
+    event_id    TEXT NOT NULL REFERENCES events(id) ON DELETE CASCADE,
+    identity_id TEXT NOT NULL,
+    PRIMARY KEY (event_id, identity_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_event_participants_identity ON event_participants(identity_id);
+
+-- 事件关系表
+CREATE TABLE IF NOT EXISTS relations (
+    id       TEXT PRIMARY KEY,
+    event_id TEXT NOT NULL REFERENCES events(id) ON DELETE CASCADE,
+    type     TEXT NOT NULL,
+    target   TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_relations_event_id ON relations(event_id);
+CREATE INDEX IF NOT EXISTS idx_relations_type_target ON relations(type, target);
+
+-- 审计日志表
+CREATE TABLE IF NOT EXISTS audit_log (
+    id         TEXT PRIMARY KEY,
+    user_id    TEXT REFERENCES users(id) ON DELETE SET NULL,
+    action     TEXT NOT NULL,
+    ip_address TEXT,
+    user_agent TEXT,
+    detail     TEXT,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_audit_log_user_id ON audit_log(user_id);
+CREATE INDEX IF NOT EXISTS idx_audit_log_created_at ON audit_log(created_at);
+
+-- 初始化状态表
+CREATE TABLE IF NOT EXISTS setup (
+    id             TEXT PRIMARY KEY,
+    version        TEXT NOT NULL,
+    initialized_at DATETIME NOT NULL,
+    usage_mode     TEXT
+);
+
+-- 迁移版本追踪
+CREATE TABLE IF NOT EXISTS schema_migrations (
+    version BIGINT PRIMARY KEY,
+    dirty   BOOLEAN NOT NULL DEFAULT FALSE
+);
diff --git a/backend/internal/storage/migrations/sqlite/0002_auth_hardening.down.sql b/backend/internal/storage/migrations/sqlite/0002_auth_hardening.down.sql
new file mode 100644
index 0000000..a59d32f
--- /dev/null
+++ b/backend/internal/storage/migrations/sqlite/0002_auth_hardening.down.sql
@@ -0,0 +1,3 @@
+DROP TABLE IF EXISTS user_auth_methods;
+DROP TABLE IF EXISTS auth_challenges;
+DROP TABLE IF EXISTS passkey_credentials;
diff --git a/backend/internal/storage/migrations/sqlite/0002_auth_hardening.up.sql b/backend/internal/storage/migrations/sqlite/0002_auth_hardening.up.sql
new file mode 100644
index 0000000..3bba2d9
--- /dev/null
+++ b/backend/internal/storage/migrations/sqlite/0002_auth_hardening.up.sql
@@ -0,0 +1,44 @@
+-- Passkey 凭证表（每用户可多个）
+CREATE TABLE IF NOT EXISTS passkey_credentials (
+    id               TEXT PRIMARY KEY,
+    user_id          TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    credential_id    TEXT NOT NULL UNIQUE,
+    public_key       TEXT NOT NULL,
+    attestation_type TEXT NOT NULL DEFAULT '',
+    aaguid           TEXT NOT NULL DEFAULT '',
+    sign_count       INTEGER NOT NULL DEFAULT 0,
+    transports       TEXT NOT NULL DEFAULT '[]',
+    name             TEXT NOT NULL DEFAULT '',
+    last_used_at     DATETIME,
+    created_at       DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_passkey_user_id ON passkey_credentials(user_id);
+CREATE INDEX IF NOT EXISTS idx_passkey_credential_id ON passkey_credentials(credential_id);
+
+-- 认证 Challenge 临时存储（WebAuthn + OAuth state 通用）
+CREATE TABLE IF NOT EXISTS auth_challenges (
+    id         TEXT PRIMARY KEY,
+    challenge  TEXT NOT NULL,
+    user_id    TEXT,
+    flow_type  TEXT NOT NULL,
+    expires_at DATETIME NOT NULL,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_challenges_expires ON auth_challenges(expires_at);
+
+-- 统一认证方式表
+CREATE TABLE IF NOT EXISTS user_auth_methods (
+    id               TEXT PRIMARY KEY,
+    user_id          TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    provider_type    TEXT NOT NULL,
+    provider_user_id TEXT NOT NULL,
+    metadata         TEXT NOT NULL DEFAULT '{}',
+    created_at       DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at       DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(provider_type, provider_user_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_auth_methods_user ON user_auth_methods(user_id);
+CREATE INDEX IF NOT EXISTS idx_auth_methods_provider ON user_auth_methods(provider_type, provider_user_id);
diff --git a/backend/internal/storage/postgres.go b/backend/internal/storage/postgres.go
new file mode 100644
index 0000000..6807010
--- /dev/null
+++ b/backend/internal/storage/postgres.go
@@ -0,0 +1,5 @@
+package storage
+
+func NewPostgresProvider(dsn string) (Provider, error) {
+	return newFileStore(dsn, "filestore/postgres-adapter"), nil
+}
diff --git a/backend/internal/storage/sqlc/gen/auth_methods.sql.go b/backend/internal/storage/sqlc/gen/auth_methods.sql.go
new file mode 100644
index 0000000..e79bbce
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/auth_methods.sql.go
@@ -0,0 +1,107 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: auth_methods.sql
+
+package sqlcgen
+
+import (
+	"context"
+)
+
+const createAuthMethod = `-- name: CreateAuthMethod :exec
+INSERT INTO user_auth_methods (id, user_id, provider_type, provider_user_id, metadata)
+VALUES (?, ?, ?, ?, ?)
+`
+
+type CreateAuthMethodParams struct {
+	ID             string `json:"id"`
+	UserID         string `json:"user_id"`
+	ProviderType   string `json:"provider_type"`
+	ProviderUserID string `json:"provider_user_id"`
+	Metadata       string `json:"metadata"`
+}
+
+func (q *Queries) CreateAuthMethod(ctx context.Context, arg *CreateAuthMethodParams) error {
+	_, err := q.db.ExecContext(ctx, createAuthMethod,
+		arg.ID,
+		arg.UserID,
+		arg.ProviderType,
+		arg.ProviderUserID,
+		arg.Metadata,
+	)
+	return err
+}
+
+const deleteAuthMethod = `-- name: DeleteAuthMethod :exec
+DELETE FROM user_auth_methods WHERE id = ? AND user_id = ?
+`
+
+type DeleteAuthMethodParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) DeleteAuthMethod(ctx context.Context, arg *DeleteAuthMethodParams) error {
+	_, err := q.db.ExecContext(ctx, deleteAuthMethod, arg.ID, arg.UserID)
+	return err
+}
+
+const getAuthMethodByProvider = `-- name: GetAuthMethodByProvider :one
+SELECT id, user_id, provider_type, provider_user_id, metadata, created_at, updated_at FROM user_auth_methods WHERE provider_type = ? AND provider_user_id = ? LIMIT 1
+`
+
+type GetAuthMethodByProviderParams struct {
+	ProviderType   string `json:"provider_type"`
+	ProviderUserID string `json:"provider_user_id"`
+}
+
+func (q *Queries) GetAuthMethodByProvider(ctx context.Context, arg *GetAuthMethodByProviderParams) (*UserAuthMethod, error) {
+	row := q.db.QueryRowContext(ctx, getAuthMethodByProvider, arg.ProviderType, arg.ProviderUserID)
+	var i UserAuthMethod
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.ProviderType,
+		&i.ProviderUserID,
+		&i.Metadata,
+		&i.CreatedAt,
+		&i.UpdatedAt,
+	)
+	return &i, err
+}
+
+const listAuthMethodsByUser = `-- name: ListAuthMethodsByUser :many
+SELECT id, user_id, provider_type, provider_user_id, metadata, created_at, updated_at FROM user_auth_methods WHERE user_id = ?
+`
+
+func (q *Queries) ListAuthMethodsByUser(ctx context.Context, userID string) ([]*UserAuthMethod, error) {
+	rows, err := q.db.QueryContext(ctx, listAuthMethodsByUser, userID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*UserAuthMethod{}
+	for rows.Next() {
+		var i UserAuthMethod
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.ProviderType,
+			&i.ProviderUserID,
+			&i.Metadata,
+			&i.CreatedAt,
+			&i.UpdatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
diff --git a/backend/internal/storage/sqlc/gen/challenges.sql.go b/backend/internal/storage/sqlc/gen/challenges.sql.go
new file mode 100644
index 0000000..2da13ba
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/challenges.sql.go
@@ -0,0 +1,72 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: challenges.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+	"time"
+)
+
+const cleanupExpiredChallenges = `-- name: CleanupExpiredChallenges :exec
+DELETE FROM auth_challenges WHERE expires_at < CURRENT_TIMESTAMP
+`
+
+func (q *Queries) CleanupExpiredChallenges(ctx context.Context) error {
+	_, err := q.db.ExecContext(ctx, cleanupExpiredChallenges)
+	return err
+}
+
+const createChallenge = `-- name: CreateChallenge :exec
+INSERT INTO auth_challenges (id, challenge, user_id, flow_type, expires_at)
+VALUES (?, ?, ?, ?, ?)
+`
+
+type CreateChallengeParams struct {
+	ID        string         `json:"id"`
+	Challenge string         `json:"challenge"`
+	UserID    sql.NullString `json:"user_id"`
+	FlowType  string         `json:"flow_type"`
+	ExpiresAt time.Time      `json:"expires_at"`
+}
+
+func (q *Queries) CreateChallenge(ctx context.Context, arg *CreateChallengeParams) error {
+	_, err := q.db.ExecContext(ctx, createChallenge,
+		arg.ID,
+		arg.Challenge,
+		arg.UserID,
+		arg.FlowType,
+		arg.ExpiresAt,
+	)
+	return err
+}
+
+const deleteChallenge = `-- name: DeleteChallenge :exec
+DELETE FROM auth_challenges WHERE id = ?
+`
+
+func (q *Queries) DeleteChallenge(ctx context.Context, id string) error {
+	_, err := q.db.ExecContext(ctx, deleteChallenge, id)
+	return err
+}
+
+const getChallenge = `-- name: GetChallenge :one
+SELECT id, challenge, user_id, flow_type, expires_at, created_at FROM auth_challenges WHERE id = ? AND expires_at > CURRENT_TIMESTAMP LIMIT 1
+`
+
+func (q *Queries) GetChallenge(ctx context.Context, id string) (*AuthChallenge, error) {
+	row := q.db.QueryRowContext(ctx, getChallenge, id)
+	var i AuthChallenge
+	err := row.Scan(
+		&i.ID,
+		&i.Challenge,
+		&i.UserID,
+		&i.FlowType,
+		&i.ExpiresAt,
+		&i.CreatedAt,
+	)
+	return &i, err
+}
diff --git a/backend/internal/storage/sqlc/gen/db.go b/backend/internal/storage/sqlc/gen/db.go
new file mode 100644
index 0000000..5ddde59
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/db.go
@@ -0,0 +1,31 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+)
+
+type DBTX interface {
+	ExecContext(context.Context, string, ...interface{}) (sql.Result, error)
+	PrepareContext(context.Context, string) (*sql.Stmt, error)
+	QueryContext(context.Context, string, ...interface{}) (*sql.Rows, error)
+	QueryRowContext(context.Context, string, ...interface{}) *sql.Row
+}
+
+func New(db DBTX) *Queries {
+	return &Queries{db: db}
+}
+
+type Queries struct {
+	db DBTX
+}
+
+func (q *Queries) WithTx(tx *sql.Tx) *Queries {
+	return &Queries{
+		db: tx,
+	}
+}
diff --git a/backend/internal/storage/sqlc/gen/events.sql.go b/backend/internal/storage/sqlc/gen/events.sql.go
new file mode 100644
index 0000000..e204af0
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/events.sql.go
@@ -0,0 +1,419 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: events.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+	"time"
+)
+
+const countEventsByUser = `-- name: CountEventsByUser :one
+SELECT COUNT(*) FROM events WHERE user_id = ?
+`
+
+func (q *Queries) CountEventsByUser(ctx context.Context, userID string) (int64, error) {
+	row := q.db.QueryRowContext(ctx, countEventsByUser, userID)
+	var count int64
+	err := row.Scan(&count)
+	return count, err
+}
+
+const countEventsByUserAndType = `-- name: CountEventsByUserAndType :many
+SELECT type, COUNT(*) AS count FROM events WHERE user_id = ? GROUP BY type
+`
+
+type CountEventsByUserAndTypeRow struct {
+	Type  string `json:"type"`
+	Count int64  `json:"count"`
+}
+
+func (q *Queries) CountEventsByUserAndType(ctx context.Context, userID string) ([]*CountEventsByUserAndTypeRow, error) {
+	rows, err := q.db.QueryContext(ctx, countEventsByUserAndType, userID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*CountEventsByUserAndTypeRow{}
+	for rows.Next() {
+		var i CountEventsByUserAndTypeRow
+		if err := rows.Scan(&i.Type, &i.Count); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const createEvent = `-- name: CreateEvent :exec
+INSERT INTO events (id, user_id, import_id, type, timestamp, direction, content_summary, content, meta)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+`
+
+type CreateEventParams struct {
+	ID             string         `json:"id"`
+	UserID         string         `json:"user_id"`
+	ImportID       sql.NullString `json:"import_id"`
+	Type           string         `json:"type"`
+	Timestamp      time.Time      `json:"timestamp"`
+	Direction      string         `json:"direction"`
+	ContentSummary sql.NullString `json:"content_summary"`
+	Content        string         `json:"content"`
+	Meta           string         `json:"meta"`
+}
+
+func (q *Queries) CreateEvent(ctx context.Context, arg *CreateEventParams) error {
+	_, err := q.db.ExecContext(ctx, createEvent,
+		arg.ID,
+		arg.UserID,
+		arg.ImportID,
+		arg.Type,
+		arg.Timestamp,
+		arg.Direction,
+		arg.ContentSummary,
+		arg.Content,
+		arg.Meta,
+	)
+	return err
+}
+
+const deleteEvent = `-- name: DeleteEvent :exec
+DELETE FROM events WHERE id = ? AND user_id = ?
+`
+
+type DeleteEventParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) DeleteEvent(ctx context.Context, arg *DeleteEventParams) error {
+	_, err := q.db.ExecContext(ctx, deleteEvent, arg.ID, arg.UserID)
+	return err
+}
+
+const deleteEventsByImport = `-- name: DeleteEventsByImport :exec
+DELETE FROM events WHERE import_id = ? AND user_id = ?
+`
+
+type DeleteEventsByImportParams struct {
+	ImportID sql.NullString `json:"import_id"`
+	UserID   string         `json:"user_id"`
+}
+
+func (q *Queries) DeleteEventsByImport(ctx context.Context, arg *DeleteEventsByImportParams) error {
+	_, err := q.db.ExecContext(ctx, deleteEventsByImport, arg.ImportID, arg.UserID)
+	return err
+}
+
+const getEvent = `-- name: GetEvent :one
+SELECT id, user_id, import_id, type, timestamp, direction, content_summary, content, meta, created_at FROM events WHERE id = ? AND user_id = ? LIMIT 1
+`
+
+type GetEventParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) GetEvent(ctx context.Context, arg *GetEventParams) (*Event, error) {
+	row := q.db.QueryRowContext(ctx, getEvent, arg.ID, arg.UserID)
+	var i Event
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.ImportID,
+		&i.Type,
+		&i.Timestamp,
+		&i.Direction,
+		&i.ContentSummary,
+		&i.Content,
+		&i.Meta,
+		&i.CreatedAt,
+	)
+	return &i, err
+}
+
+const getEventParticipants = `-- name: GetEventParticipants :many
+SELECT identity_id FROM event_participants WHERE event_id = ?
+`
+
+func (q *Queries) GetEventParticipants(ctx context.Context, eventID string) ([]string, error) {
+	rows, err := q.db.QueryContext(ctx, getEventParticipants, eventID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []string{}
+	for rows.Next() {
+		var identity_id string
+		if err := rows.Scan(&identity_id); err != nil {
+			return nil, err
+		}
+		items = append(items, identity_id)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const insertEventParticipant = `-- name: InsertEventParticipant :exec
+INSERT OR IGNORE INTO event_participants (event_id, identity_id) VALUES (?, ?)
+`
+
+type InsertEventParticipantParams struct {
+	EventID    string `json:"event_id"`
+	IdentityID string `json:"identity_id"`
+}
+
+func (q *Queries) InsertEventParticipant(ctx context.Context, arg *InsertEventParticipantParams) error {
+	_, err := q.db.ExecContext(ctx, insertEventParticipant, arg.EventID, arg.IdentityID)
+	return err
+}
+
+const lastActivityTime = `-- name: LastActivityTime :one
+SELECT MAX(timestamp) FROM events WHERE user_id = ?
+`
+
+func (q *Queries) LastActivityTime(ctx context.Context, userID string) (interface{}, error) {
+	row := q.db.QueryRowContext(ctx, lastActivityTime, userID)
+	var max interface{}
+	err := row.Scan(&max)
+	return max, err
+}
+
+const listEvents = `-- name: ListEvents :many
+SELECT id, user_id, import_id, type, timestamp, direction, content_summary, content, meta, created_at FROM events
+WHERE user_id = ?
+  AND type = COALESCE(NULLIF(?, ''), type)
+ORDER BY timestamp DESC
+LIMIT ? OFFSET ?
+`
+
+type ListEventsParams struct {
+	UserID string      `json:"user_id"`
+	Type   interface{} `json:"type"`
+	Limit  int64       `json:"limit"`
+	Offset int64       `json:"offset"`
+}
+
+func (q *Queries) ListEvents(ctx context.Context, arg *ListEventsParams) ([]*Event, error) {
+	rows, err := q.db.QueryContext(ctx, listEvents,
+		arg.UserID,
+		arg.Type,
+		arg.Limit,
+		arg.Offset,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Event{}
+	for rows.Next() {
+		var i Event
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.ImportID,
+			&i.Type,
+			&i.Timestamp,
+			&i.Direction,
+			&i.ContentSummary,
+			&i.Content,
+			&i.Meta,
+			&i.CreatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const searchEvents = `-- name: SearchEvents :many
+SELECT id, user_id, import_id, type, timestamp, direction, content_summary, content, meta, created_at FROM events
+WHERE user_id = ?
+  AND (COALESCE(content_summary, '') || ' ' || content) LIKE '%' || ? || '%'
+  AND type = COALESCE(NULLIF(?, ''), type)
+ORDER BY timestamp DESC
+LIMIT ? OFFSET ?
+`
+
+type SearchEventsParams struct {
+	UserID     string         `json:"user_id"`
+	SearchTerm sql.NullString `json:"search_term"`
+	Type       interface{}    `json:"type"`
+	Limit      int64          `json:"limit"`
+	Offset     int64          `json:"offset"`
+}
+
+func (q *Queries) SearchEvents(ctx context.Context, arg *SearchEventsParams) ([]*Event, error) {
+	rows, err := q.db.QueryContext(ctx, searchEvents,
+		arg.UserID,
+		arg.SearchTerm,
+		arg.Type,
+		arg.Limit,
+		arg.Offset,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Event{}
+	for rows.Next() {
+		var i Event
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.ImportID,
+			&i.Type,
+			&i.Timestamp,
+			&i.Direction,
+			&i.ContentSummary,
+			&i.Content,
+			&i.Meta,
+			&i.CreatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const timelineEvents = `-- name: TimelineEvents :many
+SELECT id, user_id, import_id, type, timestamp, direction, content_summary, content, meta, created_at FROM events
+WHERE user_id = ?
+  AND type = COALESCE(NULLIF(?, ''), type)
+ORDER BY timestamp DESC
+LIMIT ? OFFSET ?
+`
+
+type TimelineEventsParams struct {
+	UserID string      `json:"user_id"`
+	Type   interface{} `json:"type"`
+	Limit  int64       `json:"limit"`
+	Offset int64       `json:"offset"`
+}
+
+func (q *Queries) TimelineEvents(ctx context.Context, arg *TimelineEventsParams) ([]*Event, error) {
+	rows, err := q.db.QueryContext(ctx, timelineEvents,
+		arg.UserID,
+		arg.Type,
+		arg.Limit,
+		arg.Offset,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Event{}
+	for rows.Next() {
+		var i Event
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.ImportID,
+			&i.Type,
+			&i.Timestamp,
+			&i.Direction,
+			&i.ContentSummary,
+			&i.Content,
+			&i.Meta,
+			&i.CreatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const timelineEventsByParticipant = `-- name: TimelineEventsByParticipant :many
+SELECT DISTINCT e.id, e.user_id, e.import_id, e.type, e.timestamp, e.direction, e.content_summary, e.content, e.meta, e.created_at
+FROM events e
+JOIN event_participants ep ON e.id = ep.event_id
+JOIN identities i ON ep.identity_id = i.id
+WHERE e.user_id = ?
+  AND e.type = COALESCE(NULLIF(?, ''), e.type)
+  AND i.display_name LIKE '%' || ? || '%'
+ORDER BY e.timestamp DESC
+LIMIT ? OFFSET ?
+`
+
+type TimelineEventsByParticipantParams struct {
+	UserID      string         `json:"user_id"`
+	Type        interface{}    `json:"type"`
+	Participant sql.NullString `json:"participant"`
+	Limit       int64          `json:"limit"`
+	Offset      int64          `json:"offset"`
+}
+
+func (q *Queries) TimelineEventsByParticipant(ctx context.Context, arg *TimelineEventsByParticipantParams) ([]*Event, error) {
+	rows, err := q.db.QueryContext(ctx, timelineEventsByParticipant,
+		arg.UserID,
+		arg.Type,
+		arg.Participant,
+		arg.Limit,
+		arg.Offset,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Event{}
+	for rows.Next() {
+		var i Event
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.ImportID,
+			&i.Type,
+			&i.Timestamp,
+			&i.Direction,
+			&i.ContentSummary,
+			&i.Content,
+			&i.Meta,
+			&i.CreatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
diff --git a/backend/internal/storage/sqlc/gen/identities.sql.go b/backend/internal/storage/sqlc/gen/identities.sql.go
new file mode 100644
index 0000000..e27eed4
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/identities.sql.go
@@ -0,0 +1,221 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: identities.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+)
+
+const countIdentitiesByUser = `-- name: CountIdentitiesByUser :one
+SELECT COUNT(*) FROM identities WHERE user_id = ?
+`
+
+func (q *Queries) CountIdentitiesByUser(ctx context.Context, userID string) (int64, error) {
+	row := q.db.QueryRowContext(ctx, countIdentitiesByUser, userID)
+	var count int64
+	err := row.Scan(&count)
+	return count, err
+}
+
+const createIdentity = `-- name: CreateIdentity :exec
+INSERT INTO identities (id, user_id, type, display_name, phones, emails, avatar, labels, meta)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+`
+
+type CreateIdentityParams struct {
+	ID          string         `json:"id"`
+	UserID      string         `json:"user_id"`
+	Type        string         `json:"type"`
+	DisplayName string         `json:"display_name"`
+	Phones      string         `json:"phones"`
+	Emails      string         `json:"emails"`
+	Avatar      sql.NullString `json:"avatar"`
+	Labels      string         `json:"labels"`
+	Meta        string         `json:"meta"`
+}
+
+func (q *Queries) CreateIdentity(ctx context.Context, arg *CreateIdentityParams) error {
+	_, err := q.db.ExecContext(ctx, createIdentity,
+		arg.ID,
+		arg.UserID,
+		arg.Type,
+		arg.DisplayName,
+		arg.Phones,
+		arg.Emails,
+		arg.Avatar,
+		arg.Labels,
+		arg.Meta,
+	)
+	return err
+}
+
+const deleteIdentity = `-- name: DeleteIdentity :exec
+DELETE FROM identities WHERE id = ? AND user_id = ?
+`
+
+type DeleteIdentityParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) DeleteIdentity(ctx context.Context, arg *DeleteIdentityParams) error {
+	_, err := q.db.ExecContext(ctx, deleteIdentity, arg.ID, arg.UserID)
+	return err
+}
+
+const getIdentity = `-- name: GetIdentity :one
+SELECT id, user_id, type, display_name, phones, emails, avatar, labels, meta, created_at, updated_at FROM identities WHERE id = ? AND user_id = ? LIMIT 1
+`
+
+type GetIdentityParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) GetIdentity(ctx context.Context, arg *GetIdentityParams) (*Identity, error) {
+	row := q.db.QueryRowContext(ctx, getIdentity, arg.ID, arg.UserID)
+	var i Identity
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.Type,
+		&i.DisplayName,
+		&i.Phones,
+		&i.Emails,
+		&i.Avatar,
+		&i.Labels,
+		&i.Meta,
+		&i.CreatedAt,
+		&i.UpdatedAt,
+	)
+	return &i, err
+}
+
+const listIdentities = `-- name: ListIdentities :many
+SELECT id, user_id, type, display_name, phones, emails, avatar, labels, meta, created_at, updated_at FROM identities
+WHERE user_id = ?
+  AND type = COALESCE(NULLIF(?, ''), type)
+ORDER BY display_name ASC
+`
+
+type ListIdentitiesParams struct {
+	UserID string      `json:"user_id"`
+	Type   interface{} `json:"type"`
+}
+
+func (q *Queries) ListIdentities(ctx context.Context, arg *ListIdentitiesParams) ([]*Identity, error) {
+	rows, err := q.db.QueryContext(ctx, listIdentities, arg.UserID, arg.Type)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Identity{}
+	for rows.Next() {
+		var i Identity
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.Type,
+			&i.DisplayName,
+			&i.Phones,
+			&i.Emails,
+			&i.Avatar,
+			&i.Labels,
+			&i.Meta,
+			&i.CreatedAt,
+			&i.UpdatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const searchIdentities = `-- name: SearchIdentities :many
+SELECT id, user_id, type, display_name, phones, emails, avatar, labels, meta, created_at, updated_at FROM identities
+WHERE user_id = ?
+  AND (display_name || ' ' || phones) LIKE '%' || ? || '%'
+ORDER BY display_name ASC
+`
+
+type SearchIdentitiesParams struct {
+	UserID string         `json:"user_id"`
+	Query  sql.NullString `json:"query"`
+}
+
+func (q *Queries) SearchIdentities(ctx context.Context, arg *SearchIdentitiesParams) ([]*Identity, error) {
+	rows, err := q.db.QueryContext(ctx, searchIdentities, arg.UserID, arg.Query)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Identity{}
+	for rows.Next() {
+		var i Identity
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.Type,
+			&i.DisplayName,
+			&i.Phones,
+			&i.Emails,
+			&i.Avatar,
+			&i.Labels,
+			&i.Meta,
+			&i.CreatedAt,
+			&i.UpdatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const updateIdentity = `-- name: UpdateIdentity :exec
+UPDATE identities
+SET display_name = ?, phones = ?, emails = ?, avatar = ?, labels = ?, meta = ?, updated_at = CURRENT_TIMESTAMP
+WHERE id = ? AND user_id = ?
+`
+
+type UpdateIdentityParams struct {
+	DisplayName string         `json:"display_name"`
+	Phones      string         `json:"phones"`
+	Emails      string         `json:"emails"`
+	Avatar      sql.NullString `json:"avatar"`
+	Labels      string         `json:"labels"`
+	Meta        string         `json:"meta"`
+	ID          string         `json:"id"`
+	UserID      string         `json:"user_id"`
+}
+
+func (q *Queries) UpdateIdentity(ctx context.Context, arg *UpdateIdentityParams) error {
+	_, err := q.db.ExecContext(ctx, updateIdentity,
+		arg.DisplayName,
+		arg.Phones,
+		arg.Emails,
+		arg.Avatar,
+		arg.Labels,
+		arg.Meta,
+		arg.ID,
+		arg.UserID,
+	)
+	return err
+}
diff --git a/backend/internal/storage/sqlc/gen/imports.sql.go b/backend/internal/storage/sqlc/gen/imports.sql.go
new file mode 100644
index 0000000..7eb92e6
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/imports.sql.go
@@ -0,0 +1,170 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: imports.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+	"time"
+)
+
+const countImportsByUser = `-- name: CountImportsByUser :one
+SELECT COUNT(*) FROM imports WHERE user_id = ?
+`
+
+func (q *Queries) CountImportsByUser(ctx context.Context, userID string) (int64, error) {
+	row := q.db.QueryRowContext(ctx, countImportsByUser, userID)
+	var count int64
+	err := row.Scan(&count)
+	return count, err
+}
+
+const createImport = `-- name: CreateImport :exec
+INSERT INTO imports (id, user_id, schema_version, is_delta, source_path, event_count, identity_count, raw_json)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+`
+
+type CreateImportParams struct {
+	ID            string         `json:"id"`
+	UserID        string         `json:"user_id"`
+	SchemaVersion string         `json:"schema_version"`
+	IsDelta       bool           `json:"is_delta"`
+	SourcePath    sql.NullString `json:"source_path"`
+	EventCount    int64          `json:"event_count"`
+	IdentityCount int64          `json:"identity_count"`
+	RawJson       string         `json:"raw_json"`
+}
+
+func (q *Queries) CreateImport(ctx context.Context, arg *CreateImportParams) error {
+	_, err := q.db.ExecContext(ctx, createImport,
+		arg.ID,
+		arg.UserID,
+		arg.SchemaVersion,
+		arg.IsDelta,
+		arg.SourcePath,
+		arg.EventCount,
+		arg.IdentityCount,
+		arg.RawJson,
+	)
+	return err
+}
+
+const deleteImport = `-- name: DeleteImport :exec
+DELETE FROM imports WHERE id = ? AND user_id = ?
+`
+
+type DeleteImportParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) DeleteImport(ctx context.Context, arg *DeleteImportParams) error {
+	_, err := q.db.ExecContext(ctx, deleteImport, arg.ID, arg.UserID)
+	return err
+}
+
+const exportImport = `-- name: ExportImport :one
+SELECT raw_json FROM imports WHERE id = ? AND user_id = ? LIMIT 1
+`
+
+type ExportImportParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) ExportImport(ctx context.Context, arg *ExportImportParams) (string, error) {
+	row := q.db.QueryRowContext(ctx, exportImport, arg.ID, arg.UserID)
+	var raw_json string
+	err := row.Scan(&raw_json)
+	return raw_json, err
+}
+
+const getImport = `-- name: GetImport :one
+SELECT id, user_id, schema_version, is_delta, imported_at, source_path, event_count, identity_count, raw_json FROM imports WHERE id = ? AND user_id = ? LIMIT 1
+`
+
+type GetImportParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) GetImport(ctx context.Context, arg *GetImportParams) (*Import, error) {
+	row := q.db.QueryRowContext(ctx, getImport, arg.ID, arg.UserID)
+	var i Import
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.SchemaVersion,
+		&i.IsDelta,
+		&i.ImportedAt,
+		&i.SourcePath,
+		&i.EventCount,
+		&i.IdentityCount,
+		&i.RawJson,
+	)
+	return &i, err
+}
+
+const latestImportID = `-- name: LatestImportID :one
+SELECT id FROM imports WHERE user_id = ? ORDER BY imported_at DESC LIMIT 1
+`
+
+func (q *Queries) LatestImportID(ctx context.Context, userID string) (string, error) {
+	row := q.db.QueryRowContext(ctx, latestImportID, userID)
+	var id string
+	err := row.Scan(&id)
+	return id, err
+}
+
+const listImportsByUser = `-- name: ListImportsByUser :many
+SELECT id, user_id, schema_version, is_delta, imported_at, source_path, event_count, identity_count
+FROM imports
+WHERE user_id = ?
+ORDER BY imported_at DESC
+`
+
+type ListImportsByUserRow struct {
+	ID            string         `json:"id"`
+	UserID        string         `json:"user_id"`
+	SchemaVersion string         `json:"schema_version"`
+	IsDelta       bool           `json:"is_delta"`
+	ImportedAt    time.Time      `json:"imported_at"`
+	SourcePath    sql.NullString `json:"source_path"`
+	EventCount    int64          `json:"event_count"`
+	IdentityCount int64          `json:"identity_count"`
+}
+
+func (q *Queries) ListImportsByUser(ctx context.Context, userID string) ([]*ListImportsByUserRow, error) {
+	rows, err := q.db.QueryContext(ctx, listImportsByUser, userID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*ListImportsByUserRow{}
+	for rows.Next() {
+		var i ListImportsByUserRow
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.SchemaVersion,
+			&i.IsDelta,
+			&i.ImportedAt,
+			&i.SourcePath,
+			&i.EventCount,
+			&i.IdentityCount,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
diff --git a/backend/internal/storage/sqlc/gen/models.go b/backend/internal/storage/sqlc/gen/models.go
new file mode 100644
index 0000000..2880647
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/models.go
@@ -0,0 +1,151 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+
+package sqlcgen
+
+import (
+	"database/sql"
+	"time"
+)
+
+type AuditLog struct {
+	ID        string         `json:"id"`
+	UserID    sql.NullString `json:"user_id"`
+	Action    string         `json:"action"`
+	IpAddress sql.NullString `json:"ip_address"`
+	UserAgent sql.NullString `json:"user_agent"`
+	Detail    sql.NullString `json:"detail"`
+	CreatedAt time.Time      `json:"created_at"`
+}
+
+type AuthChallenge struct {
+	ID        string         `json:"id"`
+	Challenge string         `json:"challenge"`
+	UserID    sql.NullString `json:"user_id"`
+	FlowType  string         `json:"flow_type"`
+	ExpiresAt time.Time      `json:"expires_at"`
+	CreatedAt time.Time      `json:"created_at"`
+}
+
+type Event struct {
+	ID             string         `json:"id"`
+	UserID         string         `json:"user_id"`
+	ImportID       sql.NullString `json:"import_id"`
+	Type           string         `json:"type"`
+	Timestamp      time.Time      `json:"timestamp"`
+	Direction      string         `json:"direction"`
+	ContentSummary sql.NullString `json:"content_summary"`
+	Content        string         `json:"content"`
+	Meta           string         `json:"meta"`
+	CreatedAt      time.Time      `json:"created_at"`
+}
+
+type EventParticipant struct {
+	EventID    string `json:"event_id"`
+	IdentityID string `json:"identity_id"`
+}
+
+type Identity struct {
+	ID          string         `json:"id"`
+	UserID      string         `json:"user_id"`
+	Type        string         `json:"type"`
+	DisplayName string         `json:"display_name"`
+	Phones      string         `json:"phones"`
+	Emails      string         `json:"emails"`
+	Avatar      sql.NullString `json:"avatar"`
+	Labels      string         `json:"labels"`
+	Meta        string         `json:"meta"`
+	CreatedAt   time.Time      `json:"created_at"`
+	UpdatedAt   time.Time      `json:"updated_at"`
+}
+
+type Import struct {
+	ID            string         `json:"id"`
+	UserID        string         `json:"user_id"`
+	SchemaVersion string         `json:"schema_version"`
+	IsDelta       bool           `json:"is_delta"`
+	ImportedAt    time.Time      `json:"imported_at"`
+	SourcePath    sql.NullString `json:"source_path"`
+	EventCount    int64          `json:"event_count"`
+	IdentityCount int64          `json:"identity_count"`
+	RawJson       string         `json:"raw_json"`
+}
+
+type PasskeyCredential struct {
+	ID              string       `json:"id"`
+	UserID          string       `json:"user_id"`
+	CredentialID    string       `json:"credential_id"`
+	PublicKey       string       `json:"public_key"`
+	AttestationType string       `json:"attestation_type"`
+	Aaguid          string       `json:"aaguid"`
+	SignCount       int64        `json:"sign_count"`
+	Transports      string       `json:"transports"`
+	Name            string       `json:"name"`
+	LastUsedAt      sql.NullTime `json:"last_used_at"`
+	CreatedAt       time.Time    `json:"created_at"`
+}
+
+type RefreshToken struct {
+	ID        string         `json:"id"`
+	UserID    string         `json:"user_id"`
+	TokenHash string         `json:"token_hash"`
+	ParentID  sql.NullString `json:"parent_id"`
+	ExpiresAt time.Time      `json:"expires_at"`
+	CreatedAt time.Time      `json:"created_at"`
+	RevokedAt sql.NullTime   `json:"revoked_at"`
+}
+
+type Relation struct {
+	ID      string `json:"id"`
+	EventID string `json:"event_id"`
+	Type    string `json:"type"`
+	Target  string `json:"target"`
+}
+
+type SchemaMigration struct {
+	Version int64 `json:"version"`
+	Dirty   bool  `json:"dirty"`
+}
+
+type Session struct {
+	ID             string         `json:"id"`
+	UserID         string         `json:"user_id"`
+	RefreshTokenID sql.NullString `json:"refresh_token_id"`
+	DeviceName     sql.NullString `json:"device_name"`
+	DeviceType     sql.NullString `json:"device_type"`
+	IpAddress      sql.NullString `json:"ip_address"`
+	UserAgent      sql.NullString `json:"user_agent"`
+	CreatedAt      time.Time      `json:"created_at"`
+	LastSeenAt     time.Time      `json:"last_seen_at"`
+	RevokedAt      sql.NullTime   `json:"revoked_at"`
+}
+
+type Setup struct {
+	ID            string         `json:"id"`
+	Version       string         `json:"version"`
+	InitializedAt time.Time      `json:"initialized_at"`
+	UsageMode     sql.NullString `json:"usage_mode"`
+}
+
+type User struct {
+	ID           string         `json:"id"`
+	UserName     string         `json:"user_name"`
+	Email        sql.NullString `json:"email"`
+	PasswordHash string         `json:"password_hash"`
+	PasswordSalt string         `json:"password_salt"`
+	Roles        string         `json:"roles"`
+	Buttons      string         `json:"buttons"`
+	CreatedAt    time.Time      `json:"created_at"`
+	UpdatedAt    time.Time      `json:"updated_at"`
+}
+
+type UserAuthMethod struct {
+	ID             string    `json:"id"`
+	UserID         string    `json:"user_id"`
+	ProviderType   string    `json:"provider_type"`
+	ProviderUserID string    `json:"provider_user_id"`
+	Metadata       string    `json:"metadata"`
+	CreatedAt      time.Time `json:"created_at"`
+	UpdatedAt      time.Time `json:"updated_at"`
+}
diff --git a/backend/internal/storage/sqlc/gen/passkey.sql.go b/backend/internal/storage/sqlc/gen/passkey.sql.go
new file mode 100644
index 0000000..8aad18b
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/passkey.sql.go
@@ -0,0 +1,132 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: passkey.sql
+
+package sqlcgen
+
+import (
+	"context"
+)
+
+const createPasskeyCredential = `-- name: CreatePasskeyCredential :exec
+INSERT INTO passkey_credentials (id, user_id, credential_id, public_key, attestation_type, aaguid, sign_count, transports, name)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+`
+
+type CreatePasskeyCredentialParams struct {
+	ID              string `json:"id"`
+	UserID          string `json:"user_id"`
+	CredentialID    string `json:"credential_id"`
+	PublicKey       string `json:"public_key"`
+	AttestationType string `json:"attestation_type"`
+	Aaguid          string `json:"aaguid"`
+	SignCount       int64  `json:"sign_count"`
+	Transports      string `json:"transports"`
+	Name            string `json:"name"`
+}
+
+func (q *Queries) CreatePasskeyCredential(ctx context.Context, arg *CreatePasskeyCredentialParams) error {
+	_, err := q.db.ExecContext(ctx, createPasskeyCredential,
+		arg.ID,
+		arg.UserID,
+		arg.CredentialID,
+		arg.PublicKey,
+		arg.AttestationType,
+		arg.Aaguid,
+		arg.SignCount,
+		arg.Transports,
+		arg.Name,
+	)
+	return err
+}
+
+const deletePasskey = `-- name: DeletePasskey :exec
+DELETE FROM passkey_credentials WHERE id = ? AND user_id = ?
+`
+
+type DeletePasskeyParams struct {
+	ID     string `json:"id"`
+	UserID string `json:"user_id"`
+}
+
+func (q *Queries) DeletePasskey(ctx context.Context, arg *DeletePasskeyParams) error {
+	_, err := q.db.ExecContext(ctx, deletePasskey, arg.ID, arg.UserID)
+	return err
+}
+
+const getPasskeyByCredentialID = `-- name: GetPasskeyByCredentialID :one
+SELECT id, user_id, credential_id, public_key, attestation_type, aaguid, sign_count, transports, name, last_used_at, created_at FROM passkey_credentials WHERE credential_id = ? LIMIT 1
+`
+
+func (q *Queries) GetPasskeyByCredentialID(ctx context.Context, credentialID string) (*PasskeyCredential, error) {
+	row := q.db.QueryRowContext(ctx, getPasskeyByCredentialID, credentialID)
+	var i PasskeyCredential
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.CredentialID,
+		&i.PublicKey,
+		&i.AttestationType,
+		&i.Aaguid,
+		&i.SignCount,
+		&i.Transports,
+		&i.Name,
+		&i.LastUsedAt,
+		&i.CreatedAt,
+	)
+	return &i, err
+}
+
+const listPasskeysByUser = `-- name: ListPasskeysByUser :many
+SELECT id, user_id, credential_id, public_key, attestation_type, aaguid, sign_count, transports, name, last_used_at, created_at FROM passkey_credentials WHERE user_id = ? ORDER BY created_at DESC
+`
+
+func (q *Queries) ListPasskeysByUser(ctx context.Context, userID string) ([]*PasskeyCredential, error) {
+	rows, err := q.db.QueryContext(ctx, listPasskeysByUser, userID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*PasskeyCredential{}
+	for rows.Next() {
+		var i PasskeyCredential
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.CredentialID,
+			&i.PublicKey,
+			&i.AttestationType,
+			&i.Aaguid,
+			&i.SignCount,
+			&i.Transports,
+			&i.Name,
+			&i.LastUsedAt,
+			&i.CreatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const updatePasskeyLastUsed = `-- name: UpdatePasskeyLastUsed :exec
+UPDATE passkey_credentials SET last_used_at = CURRENT_TIMESTAMP, sign_count = ? WHERE id = ?
+`
+
+type UpdatePasskeyLastUsedParams struct {
+	SignCount int64  `json:"sign_count"`
+	ID        string `json:"id"`
+}
+
+func (q *Queries) UpdatePasskeyLastUsed(ctx context.Context, arg *UpdatePasskeyLastUsedParams) error {
+	_, err := q.db.ExecContext(ctx, updatePasskeyLastUsed, arg.SignCount, arg.ID)
+	return err
+}
diff --git a/backend/internal/storage/sqlc/gen/refresh_tokens.sql.go b/backend/internal/storage/sqlc/gen/refresh_tokens.sql.go
new file mode 100644
index 0000000..82c16ea
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/refresh_tokens.sql.go
@@ -0,0 +1,158 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: refresh_tokens.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+	"time"
+)
+
+const cleanupExpiredTokens = `-- name: CleanupExpiredTokens :exec
+DELETE FROM refresh_tokens WHERE expires_at < CURRENT_TIMESTAMP
+`
+
+func (q *Queries) CleanupExpiredTokens(ctx context.Context) error {
+	_, err := q.db.ExecContext(ctx, cleanupExpiredTokens)
+	return err
+}
+
+const consumeRefreshToken = `-- name: ConsumeRefreshToken :one
+UPDATE refresh_tokens
+SET revoked_at = CURRENT_TIMESTAMP
+WHERE token_hash = ? AND revoked_at IS NULL AND expires_at > CURRENT_TIMESTAMP
+RETURNING id, user_id, token_hash, parent_id, expires_at, created_at, revoked_at
+`
+
+func (q *Queries) ConsumeRefreshToken(ctx context.Context, tokenHash string) (*RefreshToken, error) {
+	row := q.db.QueryRowContext(ctx, consumeRefreshToken, tokenHash)
+	var i RefreshToken
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.TokenHash,
+		&i.ParentID,
+		&i.ExpiresAt,
+		&i.CreatedAt,
+		&i.RevokedAt,
+	)
+	return &i, err
+}
+
+const findAnyRefreshTokenByHash = `-- name: FindAnyRefreshTokenByHash :one
+SELECT id, user_id, token_hash, parent_id, expires_at, created_at, revoked_at FROM refresh_tokens
+WHERE token_hash = ?
+LIMIT 1
+`
+
+func (q *Queries) FindAnyRefreshTokenByHash(ctx context.Context, tokenHash string) (*RefreshToken, error) {
+	row := q.db.QueryRowContext(ctx, findAnyRefreshTokenByHash, tokenHash)
+	var i RefreshToken
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.TokenHash,
+		&i.ParentID,
+		&i.ExpiresAt,
+		&i.CreatedAt,
+		&i.RevokedAt,
+	)
+	return &i, err
+}
+
+const hasActiveRefreshTokenChild = `-- name: HasActiveRefreshTokenChild :one
+SELECT COUNT(*) > 0 AS has_active_child
+FROM refresh_tokens
+WHERE parent_id = ? AND revoked_at IS NULL AND expires_at > CURRENT_TIMESTAMP
+`
+
+func (q *Queries) HasActiveRefreshTokenChild(ctx context.Context, parentID sql.NullString) (bool, error) {
+	row := q.db.QueryRowContext(ctx, hasActiveRefreshTokenChild, parentID)
+	var has_active_child bool
+	err := row.Scan(&has_active_child)
+	return has_active_child, err
+}
+
+const findRefreshTokenByHash = `-- name: FindRefreshTokenByHash :one
+SELECT id, user_id, token_hash, parent_id, expires_at, created_at, revoked_at FROM refresh_tokens
+WHERE token_hash = ? AND revoked_at IS NULL AND expires_at > CURRENT_TIMESTAMP
+LIMIT 1
+`
+
+func (q *Queries) FindRefreshTokenByHash(ctx context.Context, tokenHash string) (*RefreshToken, error) {
+	row := q.db.QueryRowContext(ctx, findRefreshTokenByHash, tokenHash)
+	var i RefreshToken
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.TokenHash,
+		&i.ParentID,
+		&i.ExpiresAt,
+		&i.CreatedAt,
+		&i.RevokedAt,
+	)
+	return &i, err
+}
+
+const revokeRefreshTokenByID = `-- name: RevokeRefreshTokenByID :exec
+UPDATE refresh_tokens SET revoked_at = CURRENT_TIMESTAMP WHERE id = ? AND revoked_at IS NULL
+`
+
+func (q *Queries) RevokeRefreshTokenByID(ctx context.Context, id string) error {
+	_, err := q.db.ExecContext(ctx, revokeRefreshTokenByID, id)
+	return err
+}
+
+const revokeRefreshTokenFamily = `-- name: RevokeRefreshTokenFamily :exec
+WITH RECURSIVE family(id) AS (
+    SELECT id FROM refresh_tokens WHERE id = ?
+    UNION
+    SELECT rt.id
+    FROM refresh_tokens rt
+    JOIN family f ON rt.parent_id = f.id
+)
+UPDATE refresh_tokens
+SET revoked_at = CURRENT_TIMESTAMP
+WHERE id IN (SELECT id FROM family)
+`
+
+func (q *Queries) RevokeRefreshTokenFamily(ctx context.Context, id string) error {
+	_, err := q.db.ExecContext(ctx, revokeRefreshTokenFamily, id)
+	return err
+}
+
+const revokeRefreshTokensByUser = `-- name: RevokeRefreshTokensByUser :exec
+UPDATE refresh_tokens SET revoked_at = CURRENT_TIMESTAMP WHERE user_id = ? AND revoked_at IS NULL
+`
+
+func (q *Queries) RevokeRefreshTokensByUser(ctx context.Context, userID string) error {
+	_, err := q.db.ExecContext(ctx, revokeRefreshTokensByUser, userID)
+	return err
+}
+
+const saveRefreshToken = `-- name: SaveRefreshToken :exec
+INSERT INTO refresh_tokens (id, user_id, token_hash, parent_id, expires_at)
+VALUES (?, ?, ?, ?, ?)
+`
+
+type SaveRefreshTokenParams struct {
+	ID        string         `json:"id"`
+	UserID    string         `json:"user_id"`
+	TokenHash string         `json:"token_hash"`
+	ParentID  sql.NullString `json:"parent_id"`
+	ExpiresAt time.Time      `json:"expires_at"`
+}
+
+func (q *Queries) SaveRefreshToken(ctx context.Context, arg *SaveRefreshTokenParams) error {
+	_, err := q.db.ExecContext(ctx, saveRefreshToken,
+		arg.ID,
+		arg.UserID,
+		arg.TokenHash,
+		arg.ParentID,
+		arg.ExpiresAt,
+	)
+	return err
+}
diff --git a/backend/internal/storage/sqlc/gen/relations.sql.go b/backend/internal/storage/sqlc/gen/relations.sql.go
new file mode 100644
index 0000000..83e4cae
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/relations.sql.go
@@ -0,0 +1,109 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: relations.sql
+
+package sqlcgen
+
+import (
+	"context"
+)
+
+const createRelation = `-- name: CreateRelation :exec
+INSERT INTO relations (id, event_id, type, target) VALUES (?, ?, ?, ?)
+`
+
+type CreateRelationParams struct {
+	ID      string `json:"id"`
+	EventID string `json:"event_id"`
+	Type    string `json:"type"`
+	Target  string `json:"target"`
+}
+
+func (q *Queries) CreateRelation(ctx context.Context, arg *CreateRelationParams) error {
+	_, err := q.db.ExecContext(ctx, createRelation,
+		arg.ID,
+		arg.EventID,
+		arg.Type,
+		arg.Target,
+	)
+	return err
+}
+
+const deleteRelationsByEvent = `-- name: DeleteRelationsByEvent :exec
+DELETE FROM relations WHERE event_id = ?
+`
+
+func (q *Queries) DeleteRelationsByEvent(ctx context.Context, eventID string) error {
+	_, err := q.db.ExecContext(ctx, deleteRelationsByEvent, eventID)
+	return err
+}
+
+const listRelationsByEvent = `-- name: ListRelationsByEvent :many
+SELECT id, event_id, type, target FROM relations WHERE event_id = ?
+`
+
+func (q *Queries) ListRelationsByEvent(ctx context.Context, eventID string) ([]*Relation, error) {
+	rows, err := q.db.QueryContext(ctx, listRelationsByEvent, eventID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Relation{}
+	for rows.Next() {
+		var i Relation
+		if err := rows.Scan(
+			&i.ID,
+			&i.EventID,
+			&i.Type,
+			&i.Target,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const listRelationsByTarget = `-- name: ListRelationsByTarget :many
+SELECT id, event_id, type, target FROM relations WHERE type = ? AND target = ?
+`
+
+type ListRelationsByTargetParams struct {
+	Type   string `json:"type"`
+	Target string `json:"target"`
+}
+
+func (q *Queries) ListRelationsByTarget(ctx context.Context, arg *ListRelationsByTargetParams) ([]*Relation, error) {
+	rows, err := q.db.QueryContext(ctx, listRelationsByTarget, arg.Type, arg.Target)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Relation{}
+	for rows.Next() {
+		var i Relation
+		if err := rows.Scan(
+			&i.ID,
+			&i.EventID,
+			&i.Type,
+			&i.Target,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
diff --git a/backend/internal/storage/sqlc/gen/sessions.sql.go b/backend/internal/storage/sqlc/gen/sessions.sql.go
new file mode 100644
index 0000000..c517ee4
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/sessions.sql.go
@@ -0,0 +1,169 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: sessions.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+)
+
+const createSession = `-- name: CreateSession :exec
+INSERT INTO sessions (id, user_id, refresh_token_id, device_name, device_type, ip_address, user_agent)
+VALUES (?, ?, ?, ?, ?, ?, ?)
+`
+
+type CreateSessionParams struct {
+	ID             string         `json:"id"`
+	UserID         string         `json:"user_id"`
+	RefreshTokenID sql.NullString `json:"refresh_token_id"`
+	DeviceName     sql.NullString `json:"device_name"`
+	DeviceType     sql.NullString `json:"device_type"`
+	IpAddress      sql.NullString `json:"ip_address"`
+	UserAgent      sql.NullString `json:"user_agent"`
+}
+
+func (q *Queries) CreateSession(ctx context.Context, arg *CreateSessionParams) error {
+	_, err := q.db.ExecContext(ctx, createSession,
+		arg.ID,
+		arg.UserID,
+		arg.RefreshTokenID,
+		arg.DeviceName,
+		arg.DeviceType,
+		arg.IpAddress,
+		arg.UserAgent,
+	)
+	return err
+}
+
+const getSession = `-- name: GetSession :one
+SELECT id, user_id, refresh_token_id, device_name, device_type, ip_address, user_agent, created_at, last_seen_at, revoked_at FROM sessions WHERE id = ? AND revoked_at IS NULL LIMIT 1
+`
+
+func (q *Queries) GetSession(ctx context.Context, id string) (*Session, error) {
+	row := q.db.QueryRowContext(ctx, getSession, id)
+	var i Session
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.RefreshTokenID,
+		&i.DeviceName,
+		&i.DeviceType,
+		&i.IpAddress,
+		&i.UserAgent,
+		&i.CreatedAt,
+		&i.LastSeenAt,
+		&i.RevokedAt,
+	)
+	return &i, err
+}
+
+const getSessionByRefreshTokenID = `-- name: GetSessionByRefreshTokenID :one
+SELECT id, user_id, refresh_token_id, device_name, device_type, ip_address, user_agent, created_at, last_seen_at, revoked_at FROM sessions WHERE refresh_token_id = ? AND revoked_at IS NULL LIMIT 1
+`
+
+func (q *Queries) GetSessionByRefreshTokenID(ctx context.Context, refreshTokenID sql.NullString) (*Session, error) {
+	row := q.db.QueryRowContext(ctx, getSessionByRefreshTokenID, refreshTokenID)
+	var i Session
+	err := row.Scan(
+		&i.ID,
+		&i.UserID,
+		&i.RefreshTokenID,
+		&i.DeviceName,
+		&i.DeviceType,
+		&i.IpAddress,
+		&i.UserAgent,
+		&i.CreatedAt,
+		&i.LastSeenAt,
+		&i.RevokedAt,
+	)
+	return &i, err
+}
+
+const listSessionsByUser = `-- name: ListSessionsByUser :many
+SELECT id, user_id, refresh_token_id, device_name, device_type, ip_address, user_agent, created_at, last_seen_at, revoked_at FROM sessions WHERE user_id = ? AND revoked_at IS NULL ORDER BY last_seen_at DESC
+`
+
+func (q *Queries) ListSessionsByUser(ctx context.Context, userID string) ([]*Session, error) {
+	rows, err := q.db.QueryContext(ctx, listSessionsByUser, userID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*Session{}
+	for rows.Next() {
+		var i Session
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.RefreshTokenID,
+			&i.DeviceName,
+			&i.DeviceType,
+			&i.IpAddress,
+			&i.UserAgent,
+			&i.CreatedAt,
+			&i.LastSeenAt,
+			&i.RevokedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const revokeOtherSessions = `-- name: RevokeOtherSessions :exec
+UPDATE sessions SET revoked_at = CURRENT_TIMESTAMP WHERE user_id = ? AND id != ? AND revoked_at IS NULL
+`
+
+type RevokeOtherSessionsParams struct {
+	UserID string `json:"user_id"`
+	ID     string `json:"id"`
+}
+
+func (q *Queries) RevokeOtherSessions(ctx context.Context, arg *RevokeOtherSessionsParams) error {
+	_, err := q.db.ExecContext(ctx, revokeOtherSessions, arg.UserID, arg.ID)
+	return err
+}
+
+const revokeSession = `-- name: RevokeSession :exec
+UPDATE sessions SET revoked_at = CURRENT_TIMESTAMP WHERE id = ?
+`
+
+func (q *Queries) RevokeSession(ctx context.Context, id string) error {
+	_, err := q.db.ExecContext(ctx, revokeSession, id)
+	return err
+}
+
+const updateSessionLastSeen = `-- name: UpdateSessionLastSeen :exec
+UPDATE sessions SET last_seen_at = CURRENT_TIMESTAMP WHERE id = ?
+`
+
+func (q *Queries) UpdateSessionLastSeen(ctx context.Context, id string) error {
+	_, err := q.db.ExecContext(ctx, updateSessionLastSeen, id)
+	return err
+}
+
+const updateSessionRefreshToken = `-- name: UpdateSessionRefreshToken :exec
+UPDATE sessions
+SET refresh_token_id = ?, last_seen_at = CURRENT_TIMESTAMP
+WHERE id = ? AND revoked_at IS NULL
+`
+
+type UpdateSessionRefreshTokenParams struct {
+	RefreshTokenID sql.NullString `json:"refresh_token_id"`
+	ID             string         `json:"id"`
+}
+
+func (q *Queries) UpdateSessionRefreshToken(ctx context.Context, arg *UpdateSessionRefreshTokenParams) error {
+	_, err := q.db.ExecContext(ctx, updateSessionRefreshToken, arg.RefreshTokenID, arg.ID)
+	return err
+}
diff --git a/backend/internal/storage/sqlc/gen/setup.sql.go b/backend/internal/storage/sqlc/gen/setup.sql.go
new file mode 100644
index 0000000..16b0f8b
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/setup.sql.go
@@ -0,0 +1,145 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: setup.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+	"time"
+)
+
+const countAuditLogs = `-- name: CountAuditLogs :one
+SELECT COUNT(*) FROM audit_log
+WHERE (NULLIF(?1, '') IS NULL OR user_id = ?1)
+  AND (NULLIF(?2, '') IS NULL OR action = ?2)
+`
+
+type CountAuditLogsParams struct {
+	UserID interface{} `json:"user_id"`
+	Action interface{} `json:"action"`
+}
+
+func (q *Queries) CountAuditLogs(ctx context.Context, arg *CountAuditLogsParams) (int64, error) {
+	row := q.db.QueryRowContext(ctx, countAuditLogs, arg.UserID, arg.Action)
+	var count int64
+	err := row.Scan(&count)
+	return count, err
+}
+
+const createAuditLog = `-- name: CreateAuditLog :exec
+INSERT INTO audit_log (id, user_id, action, ip_address, user_agent, detail)
+VALUES (?, ?, ?, ?, ?, ?)
+`
+
+type CreateAuditLogParams struct {
+	ID        string         `json:"id"`
+	UserID    sql.NullString `json:"user_id"`
+	Action    string         `json:"action"`
+	IpAddress sql.NullString `json:"ip_address"`
+	UserAgent sql.NullString `json:"user_agent"`
+	Detail    sql.NullString `json:"detail"`
+}
+
+func (q *Queries) CreateAuditLog(ctx context.Context, arg *CreateAuditLogParams) error {
+	_, err := q.db.ExecContext(ctx, createAuditLog,
+		arg.ID,
+		arg.UserID,
+		arg.Action,
+		arg.IpAddress,
+		arg.UserAgent,
+		arg.Detail,
+	)
+	return err
+}
+
+const getAuditLogs = `-- name: GetAuditLogs :many
+SELECT id, user_id, "action", ip_address, user_agent, detail, created_at FROM audit_log
+WHERE (NULLIF(?1, '') IS NULL OR user_id = ?1)
+  AND (NULLIF(?2, '') IS NULL OR action = ?2)
+ORDER BY created_at DESC
+LIMIT ?3 OFFSET ?4
+`
+
+type GetAuditLogsParams struct {
+	UserID interface{} `json:"user_id"`
+	Action interface{} `json:"action"`
+	Limit  int64       `json:"limit"`
+	Offset int64       `json:"offset"`
+}
+
+func (q *Queries) GetAuditLogs(ctx context.Context, arg *GetAuditLogsParams) ([]*AuditLog, error) {
+	rows, err := q.db.QueryContext(ctx, getAuditLogs,
+		arg.UserID,
+		arg.Action,
+		arg.Limit,
+		arg.Offset,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*AuditLog{}
+	for rows.Next() {
+		var i AuditLog
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.Action,
+			&i.IpAddress,
+			&i.UserAgent,
+			&i.Detail,
+			&i.CreatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const getSetupStatus = `-- name: GetSetupStatus :one
+SELECT id, version, initialized_at, usage_mode FROM setup LIMIT 1
+`
+
+func (q *Queries) GetSetupStatus(ctx context.Context) (*Setup, error) {
+	row := q.db.QueryRowContext(ctx, getSetupStatus)
+	var i Setup
+	err := row.Scan(
+		&i.ID,
+		&i.Version,
+		&i.InitializedAt,
+		&i.UsageMode,
+	)
+	return &i, err
+}
+
+const saveSetup = `-- name: SaveSetup :exec
+INSERT OR REPLACE INTO setup (id, version, initialized_at, usage_mode)
+VALUES (?, ?, ?, ?)
+`
+
+type SaveSetupParams struct {
+	ID            string         `json:"id"`
+	Version       string         `json:"version"`
+	InitializedAt time.Time      `json:"initialized_at"`
+	UsageMode     sql.NullString `json:"usage_mode"`
+}
+
+func (q *Queries) SaveSetup(ctx context.Context, arg *SaveSetupParams) error {
+	_, err := q.db.ExecContext(ctx, saveSetup,
+		arg.ID,
+		arg.Version,
+		arg.InitializedAt,
+		arg.UsageMode,
+	)
+	return err
+}
diff --git a/backend/internal/storage/sqlc/gen/users.sql.go b/backend/internal/storage/sqlc/gen/users.sql.go
new file mode 100644
index 0000000..3079c5a
--- /dev/null
+++ b/backend/internal/storage/sqlc/gen/users.sql.go
@@ -0,0 +1,168 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: users.sql
+
+package sqlcgen
+
+import (
+	"context"
+	"database/sql"
+)
+
+const createUser = `-- name: CreateUser :exec
+INSERT INTO users (id, user_name, email, password_hash, password_salt, roles, buttons)
+VALUES (?, ?, ?, ?, ?, ?, ?)
+`
+
+type CreateUserParams struct {
+	ID           string         `json:"id"`
+	UserName     string         `json:"user_name"`
+	Email        sql.NullString `json:"email"`
+	PasswordHash string         `json:"password_hash"`
+	PasswordSalt string         `json:"password_salt"`
+	Roles        string         `json:"roles"`
+	Buttons      string         `json:"buttons"`
+}
+
+func (q *Queries) CreateUser(ctx context.Context, arg *CreateUserParams) error {
+	_, err := q.db.ExecContext(ctx, createUser,
+		arg.ID,
+		arg.UserName,
+		arg.Email,
+		arg.PasswordHash,
+		arg.PasswordSalt,
+		arg.Roles,
+		arg.Buttons,
+	)
+	return err
+}
+
+const deleteUser = `-- name: DeleteUser :exec
+DELETE FROM users WHERE id = ?
+`
+
+func (q *Queries) DeleteUser(ctx context.Context, id string) error {
+	_, err := q.db.ExecContext(ctx, deleteUser, id)
+	return err
+}
+
+const findUserByUserName = `-- name: FindUserByUserName :one
+SELECT id, user_name, email, password_hash, password_salt, roles, buttons, created_at, updated_at FROM users WHERE user_name = ? LIMIT 1
+`
+
+func (q *Queries) FindUserByUserName(ctx context.Context, userName string) (*User, error) {
+	row := q.db.QueryRowContext(ctx, findUserByUserName, userName)
+	var i User
+	err := row.Scan(
+		&i.ID,
+		&i.UserName,
+		&i.Email,
+		&i.PasswordHash,
+		&i.PasswordSalt,
+		&i.Roles,
+		&i.Buttons,
+		&i.CreatedAt,
+		&i.UpdatedAt,
+	)
+	return &i, err
+}
+
+const getUser = `-- name: GetUser :one
+SELECT id, user_name, email, password_hash, password_salt, roles, buttons, created_at, updated_at FROM users WHERE id = ? LIMIT 1
+`
+
+func (q *Queries) GetUser(ctx context.Context, id string) (*User, error) {
+	row := q.db.QueryRowContext(ctx, getUser, id)
+	var i User
+	err := row.Scan(
+		&i.ID,
+		&i.UserName,
+		&i.Email,
+		&i.PasswordHash,
+		&i.PasswordSalt,
+		&i.Roles,
+		&i.Buttons,
+		&i.CreatedAt,
+		&i.UpdatedAt,
+	)
+	return &i, err
+}
+
+const hasAdminUser = `-- name: HasAdminUser :one
+SELECT COUNT(*) > 0 AS has_admin FROM users WHERE roles LIKE '%R_ADMIN%' OR roles LIKE '%R_SUPER%'
+`
+
+func (q *Queries) HasAdminUser(ctx context.Context) (bool, error) {
+	row := q.db.QueryRowContext(ctx, hasAdminUser)
+	var has_admin bool
+	err := row.Scan(&has_admin)
+	return has_admin, err
+}
+
+const listUsers = `-- name: ListUsers :many
+SELECT id, user_name, email, password_hash, password_salt, roles, buttons, created_at, updated_at FROM users ORDER BY created_at DESC
+`
+
+func (q *Queries) ListUsers(ctx context.Context) ([]*User, error) {
+	rows, err := q.db.QueryContext(ctx, listUsers)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	items := []*User{}
+	for rows.Next() {
+		var i User
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserName,
+			&i.Email,
+			&i.PasswordHash,
+			&i.PasswordSalt,
+			&i.Roles,
+			&i.Buttons,
+			&i.CreatedAt,
+			&i.UpdatedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, &i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const updateUserPasswordHash = `-- name: UpdateUserPasswordHash :exec
+UPDATE users SET password_hash = ?, password_salt = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?
+`
+
+type UpdateUserPasswordHashParams struct {
+	PasswordHash string `json:"password_hash"`
+	PasswordSalt string `json:"password_salt"`
+	ID           string `json:"id"`
+}
+
+func (q *Queries) UpdateUserPasswordHash(ctx context.Context, arg *UpdateUserPasswordHashParams) error {
+	_, err := q.db.ExecContext(ctx, updateUserPasswordHash, arg.PasswordHash, arg.PasswordSalt, arg.ID)
+	return err
+}
+
+const updateUserRoles = `-- name: UpdateUserRoles :exec
+UPDATE users SET roles = ?, buttons = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?
+`
+
+type UpdateUserRolesParams struct {
+	Roles   string `json:"roles"`
+	Buttons string `json:"buttons"`
+	ID      string `json:"id"`
+}
+
+func (q *Queries) UpdateUserRoles(ctx context.Context, arg *UpdateUserRolesParams) error {
+	_, err := q.db.ExecContext(ctx, updateUserRoles, arg.Roles, arg.Buttons, arg.ID)
+	return err
+}
diff --git a/backend/internal/storage/sqlc/query/auth_methods.sql b/backend/internal/storage/sqlc/query/auth_methods.sql
new file mode 100644
index 0000000..8e59965
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/auth_methods.sql
@@ -0,0 +1,12 @@
+-- name: CreateAuthMethod :exec
+INSERT INTO user_auth_methods (id, user_id, provider_type, provider_user_id, metadata)
+VALUES (?, ?, ?, ?, ?);
+
+-- name: GetAuthMethodByProvider :one
+SELECT * FROM user_auth_methods WHERE provider_type = ? AND provider_user_id = ? LIMIT 1;
+
+-- name: ListAuthMethodsByUser :many
+SELECT * FROM user_auth_methods WHERE user_id = ?;
+
+-- name: DeleteAuthMethod :exec
+DELETE FROM user_auth_methods WHERE id = ? AND user_id = ?;
diff --git a/backend/internal/storage/sqlc/query/challenges.sql b/backend/internal/storage/sqlc/query/challenges.sql
new file mode 100644
index 0000000..5ffc2ba
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/challenges.sql
@@ -0,0 +1,12 @@
+-- name: CreateChallenge :exec
+INSERT INTO auth_challenges (id, challenge, user_id, flow_type, expires_at)
+VALUES (?, ?, ?, ?, ?);
+
+-- name: GetChallenge :one
+SELECT * FROM auth_challenges WHERE id = ? AND expires_at > CURRENT_TIMESTAMP LIMIT 1;
+
+-- name: DeleteChallenge :exec
+DELETE FROM auth_challenges WHERE id = ?;
+
+-- name: CleanupExpiredChallenges :exec
+DELETE FROM auth_challenges WHERE expires_at < CURRENT_TIMESTAMP;
diff --git a/backend/internal/storage/sqlc/query/events.sql b/backend/internal/storage/sqlc/query/events.sql
new file mode 100644
index 0000000..4046f7d
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/events.sql
@@ -0,0 +1,60 @@
+-- name: CreateEvent :exec
+INSERT INTO events (id, user_id, import_id, type, timestamp, direction, content_summary, content, meta)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?);
+
+-- name: GetEvent :one
+SELECT * FROM events WHERE id = ? AND user_id = ? LIMIT 1;
+
+-- name: ListEvents :many
+SELECT * FROM events
+WHERE user_id = ?
+  AND type = COALESCE(NULLIF(@type, ''), type)
+ORDER BY timestamp DESC
+LIMIT ? OFFSET ?;
+
+-- name: SearchEvents :many
+SELECT * FROM events
+WHERE user_id = ?
+  AND (COALESCE(content_summary, '') || ' ' || content) LIKE '%' || @search_term || '%'
+  AND type = COALESCE(NULLIF(@type, ''), type)
+ORDER BY timestamp DESC
+LIMIT ? OFFSET ?;
+
+-- name: TimelineEvents :many
+SELECT * FROM events
+WHERE user_id = ?
+  AND type = COALESCE(NULLIF(@type, ''), type)
+ORDER BY timestamp DESC
+LIMIT ? OFFSET ?;
+
+-- name: TimelineEventsByParticipant :many
+SELECT DISTINCT e.id, e.user_id, e.import_id, e.type, e.timestamp, e.direction, e.content_summary, e.content, e.meta, e.created_at
+FROM events e
+JOIN event_participants ep ON e.id = ep.event_id
+JOIN identities i ON ep.identity_id = i.id
+WHERE e.user_id = ?
+  AND e.type = COALESCE(NULLIF(@type, ''), e.type)
+  AND i.display_name LIKE '%' || @participant || '%'
+ORDER BY e.timestamp DESC
+LIMIT ? OFFSET ?;
+
+-- name: CountEventsByUser :one
+SELECT COUNT(*) FROM events WHERE user_id = ?;
+
+-- name: CountEventsByUserAndType :many
+SELECT type, COUNT(*) AS count FROM events WHERE user_id = ? GROUP BY type;
+
+-- name: DeleteEvent :exec
+DELETE FROM events WHERE id = ? AND user_id = ?;
+
+-- name: DeleteEventsByImport :exec
+DELETE FROM events WHERE import_id = ? AND user_id = ?;
+
+-- name: LastActivityTime :one
+SELECT MAX(timestamp) FROM events WHERE user_id = ?;
+
+-- name: InsertEventParticipant :exec
+INSERT OR IGNORE INTO event_participants (event_id, identity_id) VALUES (?, ?);
+
+-- name: GetEventParticipants :many
+SELECT identity_id FROM event_participants WHERE event_id = ?;
diff --git a/backend/internal/storage/sqlc/query/identities.sql b/backend/internal/storage/sqlc/query/identities.sql
new file mode 100644
index 0000000..71eb76e
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/identities.sql
@@ -0,0 +1,29 @@
+-- name: CreateIdentity :exec
+INSERT INTO identities (id, user_id, type, display_name, phones, emails, avatar, labels, meta)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?);
+
+-- name: GetIdentity :one
+SELECT * FROM identities WHERE id = ? AND user_id = ? LIMIT 1;
+
+-- name: ListIdentities :many
+SELECT * FROM identities
+WHERE user_id = ?
+  AND type = COALESCE(NULLIF(@type, ''), type)
+ORDER BY display_name ASC;
+
+-- name: UpdateIdentity :exec
+UPDATE identities
+SET display_name = ?, phones = ?, emails = ?, avatar = ?, labels = ?, meta = ?, updated_at = CURRENT_TIMESTAMP
+WHERE id = ? AND user_id = ?;
+
+-- name: DeleteIdentity :exec
+DELETE FROM identities WHERE id = ? AND user_id = ?;
+
+-- name: CountIdentitiesByUser :one
+SELECT COUNT(*) FROM identities WHERE user_id = ?;
+
+-- name: SearchIdentities :many
+SELECT * FROM identities
+WHERE user_id = ?
+  AND (display_name || ' ' || phones) LIKE '%' || @query || '%'
+ORDER BY display_name ASC;
diff --git a/backend/internal/storage/sqlc/query/imports.sql b/backend/internal/storage/sqlc/query/imports.sql
new file mode 100644
index 0000000..0eae878
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/imports.sql
@@ -0,0 +1,24 @@
+-- name: CreateImport :exec
+INSERT INTO imports (id, user_id, schema_version, is_delta, source_path, event_count, identity_count, raw_json)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?);
+
+-- name: ListImportsByUser :many
+SELECT id, user_id, schema_version, is_delta, imported_at, source_path, event_count, identity_count
+FROM imports
+WHERE user_id = ?
+ORDER BY imported_at DESC;
+
+-- name: GetImport :one
+SELECT * FROM imports WHERE id = ? AND user_id = ? LIMIT 1;
+
+-- name: ExportImport :one
+SELECT raw_json FROM imports WHERE id = ? AND user_id = ? LIMIT 1;
+
+-- name: LatestImportID :one
+SELECT id FROM imports WHERE user_id = ? ORDER BY imported_at DESC LIMIT 1;
+
+-- name: DeleteImport :exec
+DELETE FROM imports WHERE id = ? AND user_id = ?;
+
+-- name: CountImportsByUser :one
+SELECT COUNT(*) FROM imports WHERE user_id = ?;
diff --git a/backend/internal/storage/sqlc/query/passkey.sql b/backend/internal/storage/sqlc/query/passkey.sql
new file mode 100644
index 0000000..0fe80ca
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/passkey.sql
@@ -0,0 +1,15 @@
+-- name: CreatePasskeyCredential :exec
+INSERT INTO passkey_credentials (id, user_id, credential_id, public_key, attestation_type, aaguid, sign_count, transports, name)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?);
+
+-- name: GetPasskeyByCredentialID :one
+SELECT * FROM passkey_credentials WHERE credential_id = ? LIMIT 1;
+
+-- name: ListPasskeysByUser :many
+SELECT * FROM passkey_credentials WHERE user_id = ? ORDER BY created_at DESC;
+
+-- name: UpdatePasskeyLastUsed :exec
+UPDATE passkey_credentials SET last_used_at = CURRENT_TIMESTAMP, sign_count = ? WHERE id = ?;
+
+-- name: DeletePasskey :exec
+DELETE FROM passkey_credentials WHERE id = ? AND user_id = ?;
diff --git a/backend/internal/storage/sqlc/query/refresh_tokens.sql b/backend/internal/storage/sqlc/query/refresh_tokens.sql
new file mode 100644
index 0000000..2e7dc2d
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/refresh_tokens.sql
@@ -0,0 +1,45 @@
+-- name: SaveRefreshToken :exec
+INSERT INTO refresh_tokens (id, user_id, token_hash, parent_id, expires_at)
+VALUES (?, ?, ?, ?, ?);
+
+-- name: FindRefreshTokenByHash :one
+SELECT * FROM refresh_tokens
+WHERE token_hash = ? AND revoked_at IS NULL AND expires_at > CURRENT_TIMESTAMP
+LIMIT 1;
+
+-- name: ConsumeRefreshToken :one
+UPDATE refresh_tokens
+SET revoked_at = CURRENT_TIMESTAMP
+WHERE token_hash = ? AND revoked_at IS NULL AND expires_at > CURRENT_TIMESTAMP
+RETURNING *;
+
+-- name: RevokeRefreshTokensByUser :exec
+UPDATE refresh_tokens SET revoked_at = CURRENT_TIMESTAMP WHERE user_id = ? AND revoked_at IS NULL;
+
+-- name: RevokeRefreshTokenFamily :exec
+WITH RECURSIVE family(id) AS (
+    SELECT id FROM refresh_tokens WHERE id = ?
+    UNION
+    SELECT rt.id
+    FROM refresh_tokens rt
+    JOIN family f ON rt.parent_id = f.id
+)
+UPDATE refresh_tokens
+SET revoked_at = CURRENT_TIMESTAMP
+WHERE id IN (SELECT id FROM family);
+
+-- name: RevokeRefreshTokenByID :exec
+UPDATE refresh_tokens SET revoked_at = CURRENT_TIMESTAMP WHERE id = ? AND revoked_at IS NULL;
+
+-- name: CleanupExpiredTokens :exec
+DELETE FROM refresh_tokens WHERE expires_at < CURRENT_TIMESTAMP;
+
+-- name: FindAnyRefreshTokenByHash :one
+SELECT * FROM refresh_tokens
+WHERE token_hash = ?
+LIMIT 1;
+
+-- name: HasActiveRefreshTokenChild :one
+SELECT COUNT(*) > 0 AS has_active_child
+FROM refresh_tokens
+WHERE parent_id = ? AND revoked_at IS NULL AND expires_at > CURRENT_TIMESTAMP;
diff --git a/backend/internal/storage/sqlc/query/relations.sql b/backend/internal/storage/sqlc/query/relations.sql
new file mode 100644
index 0000000..579ddc1
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/relations.sql
@@ -0,0 +1,11 @@
+-- name: CreateRelation :exec
+INSERT INTO relations (id, event_id, type, target) VALUES (?, ?, ?, ?);
+
+-- name: ListRelationsByEvent :many
+SELECT * FROM relations WHERE event_id = ?;
+
+-- name: ListRelationsByTarget :many
+SELECT * FROM relations WHERE type = ? AND target = ?;
+
+-- name: DeleteRelationsByEvent :exec
+DELETE FROM relations WHERE event_id = ?;
diff --git a/backend/internal/storage/sqlc/query/sessions.sql b/backend/internal/storage/sqlc/query/sessions.sql
new file mode 100644
index 0000000..bd81ffd
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/sessions.sql
@@ -0,0 +1,26 @@
+-- name: CreateSession :exec
+INSERT INTO sessions (id, user_id, refresh_token_id, device_name, device_type, ip_address, user_agent)
+VALUES (?, ?, ?, ?, ?, ?, ?);
+
+-- name: GetSession :one
+SELECT * FROM sessions WHERE id = ? AND revoked_at IS NULL LIMIT 1;
+
+-- name: GetSessionByRefreshTokenID :one
+SELECT * FROM sessions WHERE refresh_token_id = ? AND revoked_at IS NULL LIMIT 1;
+
+-- name: ListSessionsByUser :many
+SELECT * FROM sessions WHERE user_id = ? AND revoked_at IS NULL ORDER BY last_seen_at DESC;
+
+-- name: RevokeSession :exec
+UPDATE sessions SET revoked_at = CURRENT_TIMESTAMP WHERE id = ?;
+
+-- name: RevokeOtherSessions :exec
+UPDATE sessions SET revoked_at = CURRENT_TIMESTAMP WHERE user_id = ? AND id != ? AND revoked_at IS NULL;
+
+-- name: UpdateSessionLastSeen :exec
+UPDATE sessions SET last_seen_at = CURRENT_TIMESTAMP WHERE id = ?;
+
+-- name: UpdateSessionRefreshToken :exec
+UPDATE sessions
+SET refresh_token_id = ?, last_seen_at = CURRENT_TIMESTAMP
+WHERE id = ? AND revoked_at IS NULL;
diff --git a/backend/internal/storage/sqlc/query/setup.sql b/backend/internal/storage/sqlc/query/setup.sql
new file mode 100644
index 0000000..1f65834
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/setup.sql
@@ -0,0 +1,22 @@
+-- name: GetSetupStatus :one
+SELECT * FROM setup LIMIT 1;
+
+-- name: SaveSetup :exec
+INSERT OR REPLACE INTO setup (id, version, initialized_at, usage_mode)
+VALUES (?, ?, ?, ?);
+
+-- name: GetAuditLogs :many
+SELECT * FROM audit_log
+WHERE (NULLIF(@user_id, '') IS NULL OR user_id = @user_id)
+  AND (NULLIF(@action, '') IS NULL OR action = @action)
+ORDER BY created_at DESC
+LIMIT ? OFFSET ?;
+
+-- name: CreateAuditLog :exec
+INSERT INTO audit_log (id, user_id, action, ip_address, user_agent, detail)
+VALUES (?, ?, ?, ?, ?, ?);
+
+-- name: CountAuditLogs :one
+SELECT COUNT(*) FROM audit_log
+WHERE (NULLIF(@user_id, '') IS NULL OR user_id = @user_id)
+  AND (NULLIF(@action, '') IS NULL OR action = @action);
diff --git a/backend/internal/storage/sqlc/query/users.sql b/backend/internal/storage/sqlc/query/users.sql
new file mode 100644
index 0000000..13b8cd6
--- /dev/null
+++ b/backend/internal/storage/sqlc/query/users.sql
@@ -0,0 +1,24 @@
+-- name: CreateUser :exec
+INSERT INTO users (id, user_name, email, password_hash, password_salt, roles, buttons)
+VALUES (?, ?, ?, ?, ?, ?, ?);
+
+-- name: FindUserByUserName :one
+SELECT * FROM users WHERE user_name = ? LIMIT 1;
+
+-- name: GetUser :one
+SELECT * FROM users WHERE id = ? LIMIT 1;
+
+-- name: UpdateUserPasswordHash :exec
+UPDATE users SET password_hash = ?, password_salt = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?;
+
+-- name: HasAdminUser :one
+SELECT COUNT(*) > 0 AS has_admin FROM users WHERE roles LIKE '%R_ADMIN%' OR roles LIKE '%R_SUPER%';
+
+-- name: ListUsers :many
+SELECT * FROM users ORDER BY created_at DESC;
+
+-- name: UpdateUserRoles :exec
+UPDATE users SET roles = ?, buttons = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?;
+
+-- name: DeleteUser :exec
+DELETE FROM users WHERE id = ?;
diff --git a/backend/internal/storage/sqlc/sqlc.yaml b/backend/internal/storage/sqlc/sqlc.yaml
new file mode 100644
index 0000000..c20d5ff
--- /dev/null
+++ b/backend/internal/storage/sqlc/sqlc.yaml
@@ -0,0 +1,16 @@
+version: "2"
+sql:
+  - engine: "sqlite"
+    schema: "../migrations/sqlite"
+    queries: "query"
+    gen:
+      go:
+        package: "sqlcgen"
+        out: "gen"
+        emit_json_tags: true
+        emit_empty_slices: true
+        emit_result_struct_pointers: true
+        emit_params_struct_pointers: true
+        overrides:
+          - db_type: "DATETIME"
+            go_type: "time.Time"
diff --git a/backend/internal/storage/sqlite.go b/backend/internal/storage/sqlite.go
new file mode 100644
index 0000000..b5d220c
--- /dev/null
+++ b/backend/internal/storage/sqlite.go
@@ -0,0 +1,75 @@
+package storage
+
+import (
+	"context"
+	"database/sql"
+	_ "embed"
+	"fmt"
+	sqlc "github.com/IsKenKenYa/Commory/backend/internal/storage/sqlc/gen"
+
+	_ "github.com/mattn/go-sqlite3"
+)
+
+//go:embed migrations/sqlite/0001_initial.up.sql
+var sqliteMigration001 string
+
+//go:embed migrations/sqlite/0002_auth_hardening.up.sql
+var sqliteMigration002 string
+
+var sqliteMigrations = []struct {
+	Version int
+	SQL     string
+}{
+	{1, sqliteMigration001},
+	{2, sqliteMigration002},
+}
+
+type sqliteProvider struct {
+	db  *sql.DB
+	q   *sqlc.Queries
+	dsn string
+}
+
+func NewSQLiteProvider(dsn string) (Provider, error) {
+	db, err := sql.Open("sqlite3", dsn+"?_journal_mode=WAL&_busy_timeout=5000&_foreign_keys=ON")
+	if err != nil {
+		return nil, fmt.Errorf("open sqlite: %w", err)
+	}
+	db.SetMaxOpenConns(1)
+	return &sqliteProvider{
+		db:  db,
+		q:   sqlc.New(db),
+		dsn: dsn,
+	}, nil
+}
+
+func (s *sqliteProvider) Name() string { return "sqlite" }
+
+func (s *sqliteProvider) Close() error { return s.db.Close() }
+
+func (s *sqliteProvider) Init(ctx context.Context) error {
+	// 确保 schema_migrations 表存在
+	if _, err := s.db.ExecContext(ctx, `CREATE TABLE IF NOT EXISTS schema_migrations (version BIGINT PRIMARY KEY, dirty BOOLEAN NOT NULL DEFAULT FALSE)`); err != nil {
+		return fmt.Errorf("create schema_migrations: %w", err)
+	}
+
+	// 获取当前已应用的最高版本
+	currentVersion := 0
+	row := s.db.QueryRowContext(ctx, `SELECT COALESCE(MAX(version), 0) FROM schema_migrations`)
+	_ = row.Scan(&currentVersion)
+
+	// 按顺序应用未执行的迁移
+	for _, m := range sqliteMigrations {
+		if m.Version <= currentVersion {
+			continue
+		}
+		if _, err := s.db.ExecContext(ctx, m.SQL); err != nil {
+			return fmt.Errorf("run migration %04d: %w", m.Version, err)
+		}
+		if _, err := s.db.ExecContext(ctx, `INSERT OR REPLACE INTO schema_migrations (version, dirty) VALUES (?, FALSE)`, m.Version); err != nil {
+			return fmt.Errorf("record migration %04d: %w", m.Version, err)
+		}
+	}
+
+	return nil
+}
diff --git a/backend/internal/storage/sqlite_auth_session.go b/backend/internal/storage/sqlite_auth_session.go
new file mode 100644
index 0000000..5f82a4d
--- /dev/null
+++ b/backend/internal/storage/sqlite_auth_session.go
@@ -0,0 +1,163 @@
+package storage
+
+import (
+	"context"
+	"database/sql"
+	"encoding/json"
+	"fmt"
+	"strings"
+
+	sqlc "github.com/IsKenKenYa/Commory/backend/internal/storage/sqlc/gen"
+)
+
+func (s *sqliteProvider) CreateUser(ctx context.Context, user UserRecord) (UserRecord, error) {
+	roles, _ := json.Marshal(user.Roles)
+	buttons, _ := json.Marshal(user.Buttons)
+	err := s.q.CreateUser(ctx, &sqlc.CreateUserParams{
+		ID:           user.ID,
+		UserName:     user.UserName,
+		Email:        sql.NullString{String: user.Email, Valid: user.Email != ""},
+		PasswordHash: user.PasswordHash,
+		PasswordSalt: user.PasswordSalt,
+		Roles:        string(roles),
+		Buttons:      string(buttons),
+	})
+	if err != nil {
+		if strings.Contains(err.Error(), "UNIQUE") {
+			return UserRecord{}, fmt.Errorf("username already exists")
+		}
+		return UserRecord{}, err
+	}
+	return s.GetUser(ctx, user.ID)
+}
+
+func (s *sqliteProvider) FindUserByUserName(ctx context.Context, userName string) (UserRecord, error) {
+	row, err := s.q.FindUserByUserName(ctx, userName)
+	if err != nil {
+		return UserRecord{}, fmt.Errorf("user not found")
+	}
+	return s.rowToUser(row), nil
+}
+
+func (s *sqliteProvider) GetUser(ctx context.Context, userID string) (UserRecord, error) {
+	row, err := s.q.GetUser(ctx, userID)
+	if err != nil {
+		return UserRecord{}, fmt.Errorf("user not found")
+	}
+	return s.rowToUser(row), nil
+}
+
+func (s *sqliteProvider) SaveRefreshToken(ctx context.Context, token RefreshTokenRecord) error {
+	return s.q.SaveRefreshToken(ctx, &sqlc.SaveRefreshTokenParams{
+		ID:        token.ID,
+		UserID:    token.UserID,
+		TokenHash: token.TokenHash,
+		ParentID:  sql.NullString{String: token.ParentID, Valid: token.ParentID != ""},
+		ExpiresAt: token.ExpiresAt,
+	})
+}
+
+func (s *sqliteProvider) ConsumeRefreshToken(ctx context.Context, tokenHash string) (RefreshTokenRecord, error) {
+	row, err := s.q.ConsumeRefreshToken(ctx, tokenHash)
+	if err != nil {
+		return RefreshTokenRecord{}, fmt.Errorf("refresh token not found or expired")
+	}
+	return RefreshTokenRecord{
+		ID:        row.ID,
+		UserID:    row.UserID,
+		TokenHash: row.TokenHash,
+		ExpiresAt: row.ExpiresAt,
+		CreatedAt: row.CreatedAt,
+		RevokedAt: row.RevokedAt.Time,
+	}, nil
+}
+
+func (s *sqliteProvider) UpdateUserPasswordHash(ctx context.Context, userID, newHash, newSalt string) error {
+	return s.q.UpdateUserPasswordHash(ctx, &sqlc.UpdateUserPasswordHashParams{
+		PasswordHash: newHash,
+		PasswordSalt: newSalt,
+		ID:           userID,
+	})
+}
+
+func (s *sqliteProvider) FindAnyRefreshTokenByHash(ctx context.Context, tokenHash string) (RefreshTokenRecord, error) {
+	row, err := s.q.FindAnyRefreshTokenByHash(ctx, tokenHash)
+	if err != nil {
+		return RefreshTokenRecord{}, err
+	}
+	return s.rowToRefreshToken(row), nil
+}
+
+func (s *sqliteProvider) HasActiveRefreshTokenChild(ctx context.Context, parentID string) (bool, error) {
+	return s.q.HasActiveRefreshTokenChild(ctx, sql.NullString{String: parentID, Valid: parentID != ""})
+}
+
+func (s *sqliteProvider) RevokeRefreshTokenFamily(ctx context.Context, tokenID string) error {
+	return s.q.RevokeRefreshTokenFamily(ctx, tokenID)
+}
+
+func (s *sqliteProvider) RevokeRefreshTokenByID(ctx context.Context, tokenID string) error {
+	return s.q.RevokeRefreshTokenByID(ctx, tokenID)
+}
+
+func (s *sqliteProvider) CreateSession(ctx context.Context, rec SessionRecord) error {
+	return s.q.CreateSession(ctx, &sqlc.CreateSessionParams{
+		ID:             rec.ID,
+		UserID:         rec.UserID,
+		RefreshTokenID: sql.NullString{String: rec.RefreshTokenID, Valid: rec.RefreshTokenID != ""},
+		DeviceName:     sql.NullString{String: rec.DeviceName, Valid: rec.DeviceName != ""},
+		DeviceType:     sql.NullString{String: rec.DeviceType, Valid: rec.DeviceType != ""},
+		IpAddress:      sql.NullString{String: rec.IPAddress, Valid: rec.IPAddress != ""},
+		UserAgent:      sql.NullString{String: rec.UserAgent, Valid: rec.UserAgent != ""},
+	})
+}
+
+func (s *sqliteProvider) GetSession(ctx context.Context, sessionID string) (SessionRecord, error) {
+	row, err := s.q.GetSession(ctx, sessionID)
+	if err != nil {
+		return SessionRecord{}, err
+	}
+	return s.rowToSession(row), nil
+}
+
+func (s *sqliteProvider) GetSessionByRefreshTokenID(ctx context.Context, refreshTokenID string) (SessionRecord, error) {
+	row, err := s.q.GetSessionByRefreshTokenID(ctx, sql.NullString{String: refreshTokenID, Valid: refreshTokenID != ""})
+	if err != nil {
+		return SessionRecord{}, err
+	}
+	return s.rowToSession(row), nil
+}
+
+func (s *sqliteProvider) ListSessionsByUser(ctx context.Context, userID string) ([]SessionRecord, error) {
+	rows, err := s.q.ListSessionsByUser(ctx, userID)
+	if err != nil {
+		return nil, err
+	}
+	items := make([]SessionRecord, 0, len(rows))
+	for _, r := range rows {
+		items = append(items, s.rowToSession(r))
+	}
+	return items, nil
+}
+
+func (s *sqliteProvider) RevokeSession(ctx context.Context, sessionID string) error {
+	return s.q.RevokeSession(ctx, sessionID)
+}
+
+func (s *sqliteProvider) RevokeOtherSessions(ctx context.Context, userID, currentSessionID string) error {
+	return s.q.RevokeOtherSessions(ctx, &sqlc.RevokeOtherSessionsParams{
+		UserID: userID,
+		ID:     currentSessionID,
+	})
+}
+
+func (s *sqliteProvider) UpdateSessionLastSeen(ctx context.Context, sessionID string) error {
+	return s.q.UpdateSessionLastSeen(ctx, sessionID)
+}
+
+func (s *sqliteProvider) UpdateSessionRefreshToken(ctx context.Context, sessionID, refreshTokenID string) error {
+	return s.q.UpdateSessionRefreshToken(ctx, &sqlc.UpdateSessionRefreshTokenParams{
+		RefreshTokenID: sql.NullString{String: refreshTokenID, Valid: refreshTokenID != ""},
+		ID:             sessionID,
+	})
+}
diff --git a/backend/internal/storage/sqlite_imports_query.go b/backend/internal/storage/sqlite_imports_query.go
new file mode 100644
index 0000000..37c9e4f
--- /dev/null
+++ b/backend/internal/storage/sqlite_imports_query.go
@@ -0,0 +1,279 @@
+package storage
+
+import (
+	"context"
+	"database/sql"
+	"encoding/json"
+	"fmt"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	sqlc "github.com/IsKenKenYa/Commory/backend/internal/storage/sqlc/gen"
+)
+
+func (s *sqliteProvider) Import(ctx context.Context, userID, sourcePath string, export msglayer.RootExport, raw []byte) (string, error) {
+	tx, err := s.db.BeginTx(ctx, nil)
+	if err != nil {
+		return "", err
+	}
+	defer tx.Rollback()
+
+	qtx := s.q.WithTx(tx)
+
+	importID := fmt.Sprintf("import_%d", time.Now().UnixNano())
+	if err := qtx.CreateImport(ctx, &sqlc.CreateImportParams{
+		ID:            importID,
+		UserID:        userID,
+		SchemaVersion: export.Version,
+		IsDelta:       false,
+		SourcePath:    sql.NullString{String: sourcePath, Valid: sourcePath != ""},
+		EventCount:    int64(len(export.Events)),
+		IdentityCount: int64(len(export.Identities)),
+		RawJson:       string(raw),
+	}); err != nil {
+		return "", fmt.Errorf("create import: %w", err)
+	}
+
+	for _, identity := range export.Identities {
+		phones, _ := json.Marshal(identity.Phones)
+		emails, _ := json.Marshal(identity.Emails)
+		labels, _ := json.Marshal(identity.Labels)
+		meta, _ := json.Marshal(identity.Meta)
+		var avatar sql.NullString
+		if identity.Avatar != nil {
+			avatar = sql.NullString{String: *identity.Avatar, Valid: true}
+		}
+		if err := qtx.CreateIdentity(ctx, &sqlc.CreateIdentityParams{
+			ID:          identity.ID,
+			UserID:      userID,
+			Type:        identity.Type,
+			DisplayName: identity.DisplayName,
+			Phones:      string(phones),
+			Emails:      string(emails),
+			Avatar:      avatar,
+			Labels:      string(labels),
+			Meta:        string(meta),
+		}); err != nil {
+			return "", fmt.Errorf("create identity %s: %w", identity.ID, err)
+		}
+	}
+
+	for _, event := range export.Events {
+		contentJSON, _ := json.Marshal(event.Content)
+		metaJSON, _ := json.Marshal(event.Meta)
+		ts, _ := time.Parse(time.RFC3339, event.Timestamp)
+		summary := summarizeEvent(event)
+
+		if err := qtx.CreateEvent(ctx, &sqlc.CreateEventParams{
+			ID:             event.ID,
+			UserID:         userID,
+			ImportID:       sql.NullString{String: importID, Valid: true},
+			Type:           event.Type,
+			Timestamp:      ts,
+			Direction:      event.Direction,
+			ContentSummary: sql.NullString{String: summary, Valid: summary != ""},
+			Content:        string(contentJSON),
+			Meta:           string(metaJSON),
+		}); err != nil {
+			return "", fmt.Errorf("create event %s: %w", event.ID, err)
+		}
+
+		for _, participant := range event.Participants {
+			if err := qtx.InsertEventParticipant(ctx, &sqlc.InsertEventParticipantParams{
+				EventID:    event.ID,
+				IdentityID: participant,
+			}); err != nil {
+				return "", fmt.Errorf("insert participant %s: %w", participant, err)
+			}
+		}
+
+		for _, rel := range event.Relations {
+			if err := qtx.CreateRelation(ctx, &sqlc.CreateRelationParams{
+				ID:      fmt.Sprintf("rel_%s_%s_%d", event.ID, rel.Type, time.Now().UnixNano()),
+				EventID: event.ID,
+				Type:    rel.Type,
+				Target:  rel.Target,
+			}); err != nil {
+				return "", fmt.Errorf("create relation: %w", err)
+			}
+		}
+	}
+
+	return importID, tx.Commit()
+}
+
+func (s *sqliteProvider) ListImports(ctx context.Context, userID string) ([]ImportSummary, error) {
+	rows, err := s.q.ListImportsByUser(ctx, userID)
+	if err != nil {
+		return nil, err
+	}
+	items := make([]ImportSummary, 0, len(rows))
+	for _, r := range rows {
+		items = append(items, ImportSummary{
+			ID:            r.ID,
+			UserID:        r.UserID,
+			SchemaVersion: r.SchemaVersion,
+			ImportedAt:    r.ImportedAt,
+			SourcePath:    r.SourcePath.String,
+			EventCount:    int(r.EventCount),
+			IdentityCount: int(r.IdentityCount),
+		})
+	}
+	return items, nil
+}
+
+func (s *sqliteProvider) ExportImport(ctx context.Context, userID, importID string) ([]byte, error) {
+	if importID == "" {
+		var err error
+		importID, err = s.q.LatestImportID(ctx, userID)
+		if err != nil {
+			return nil, fmt.Errorf("no imports found")
+		}
+	}
+	raw, err := s.q.ExportImport(ctx, &sqlc.ExportImportParams{ID: importID, UserID: userID})
+	if err != nil {
+		return nil, fmt.Errorf("import not found: %s", importID)
+	}
+	return []byte(raw), nil
+}
+
+func (s *sqliteProvider) LatestImportID(ctx context.Context, userID string) (string, error) {
+	id, err := s.q.LatestImportID(ctx, userID)
+	if err != nil {
+		return "", fmt.Errorf("no imports found")
+	}
+	return id, nil
+}
+
+func (s *sqliteProvider) GetEvent(ctx context.Context, userID, id string) (msglayer.TimelineItem, error) {
+	row, err := s.q.GetEvent(ctx, &sqlc.GetEventParams{ID: id, UserID: userID})
+	if err != nil {
+		return msglayer.TimelineItem{}, fmt.Errorf("event not found: %s", id)
+	}
+	return s.eventToTimelineItem(ctx, row)
+}
+
+func (s *sqliteProvider) ListEvents(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	typeFilter := ""
+	if params.Type != "" {
+		typeFilter = params.Type
+	}
+	limit := int64(50)
+	if params.Limit > 0 {
+		limit = int64(params.Limit)
+	}
+	rows, err := s.q.ListEvents(ctx, &sqlc.ListEventsParams{
+		UserID: params.UserID,
+		Type:   typeFilter,
+		Limit:  limit,
+		Offset: int64(params.Offset),
+	})
+	if err != nil {
+		return nil, err
+	}
+	return s.eventsToTimelineItems(ctx, rows)
+}
+
+func (s *sqliteProvider) Search(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	if params.Keyword == "" {
+		return nil, nil
+	}
+	typeFilter := ""
+	if params.Type != "" {
+		typeFilter = params.Type
+	}
+	limit := int64(50)
+	if params.Limit > 0 {
+		limit = int64(params.Limit)
+	}
+	rows, err := s.q.SearchEvents(ctx, &sqlc.SearchEventsParams{
+		UserID:     params.UserID,
+		SearchTerm: sql.NullString{String: params.Keyword, Valid: true},
+		Type:       typeFilter,
+		Limit:      limit,
+		Offset:     int64(params.Offset),
+	})
+	if err != nil {
+		return nil, err
+	}
+	return s.eventsToTimelineItems(ctx, rows)
+}
+
+func (s *sqliteProvider) Timeline(ctx context.Context, params msglayer.SearchParams) ([]msglayer.TimelineItem, error) {
+	typeFilter := ""
+	if params.Type != "" {
+		typeFilter = params.Type
+	}
+	limit := int64(50)
+	if params.Limit > 0 {
+		limit = int64(params.Limit)
+	}
+
+	if params.Participant != "" {
+		rows, err := s.q.TimelineEventsByParticipant(ctx, &sqlc.TimelineEventsByParticipantParams{
+			UserID:      params.UserID,
+			Type:        typeFilter,
+			Participant: sql.NullString{String: params.Participant, Valid: true},
+			Limit:       limit,
+			Offset:      int64(params.Offset),
+		})
+		if err != nil {
+			return nil, err
+		}
+		return s.eventsToTimelineItems(ctx, rows)
+	}
+
+	rows, err := s.q.TimelineEvents(ctx, &sqlc.TimelineEventsParams{
+		UserID: params.UserID,
+		Type:   typeFilter,
+		Limit:  limit,
+		Offset: int64(params.Offset),
+	})
+	if err != nil {
+		return nil, err
+	}
+	return s.eventsToTimelineItems(ctx, rows)
+}
+
+func (s *sqliteProvider) ListIdentities(ctx context.Context, userID string) ([]msglayer.Identity, error) {
+	rows, err := s.q.ListIdentities(ctx, &sqlc.ListIdentitiesParams{UserID: userID, Type: ""})
+	if err != nil {
+		return nil, err
+	}
+	items := make([]msglayer.Identity, 0, len(rows))
+	for _, r := range rows {
+		items = append(items, s.rowToIdentity(r))
+	}
+	return items, nil
+}
+
+func (s *sqliteProvider) GetIdentity(ctx context.Context, userID, id string) (msglayer.Identity, error) {
+	row, err := s.q.GetIdentity(ctx, &sqlc.GetIdentityParams{ID: id, UserID: userID})
+	if err != nil {
+		return msglayer.Identity{}, fmt.Errorf("identity not found: %s", id)
+	}
+	return s.rowToIdentity(row), nil
+}
+
+func (s *sqliteProvider) GetThread(ctx context.Context, userID, threadID string) ([]msglayer.TimelineItem, error) {
+	relations, err := s.q.ListRelationsByTarget(ctx, &sqlc.ListRelationsByTargetParams{
+		Type:   "same_thread",
+		Target: threadID,
+	})
+	if err != nil {
+		return nil, err
+	}
+	var items []msglayer.TimelineItem
+	for _, rel := range relations {
+		event, err := s.q.GetEvent(ctx, &sqlc.GetEventParams{ID: rel.EventID, UserID: userID})
+		if err != nil {
+			continue
+		}
+		item, err := s.eventToTimelineItem(ctx, event)
+		if err != nil {
+			continue
+		}
+		items = append(items, item)
+	}
+	return items, nil
+}
diff --git a/backend/internal/storage/sqlite_setup_passkey.go b/backend/internal/storage/sqlite_setup_passkey.go
new file mode 100644
index 0000000..aacc15e
--- /dev/null
+++ b/backend/internal/storage/sqlite_setup_passkey.go
@@ -0,0 +1,186 @@
+package storage
+
+import (
+	"context"
+	"database/sql"
+	"time"
+
+	sqlc "github.com/IsKenKenYa/Commory/backend/internal/storage/sqlc/gen"
+)
+
+func (s *sqliteProvider) GetSetupStatus(ctx context.Context) (SetupStatus, error) {
+	row, err := s.q.GetSetupStatus(ctx)
+	if err != nil {
+		hasAdmin, _ := s.q.HasAdminUser(ctx)
+		return SetupStatus{Initialized: hasAdmin, DatabaseType: "sqlite"}, nil
+	}
+	return SetupStatus{
+		Initialized:  true,
+		Version:      row.Version,
+		DatabaseType: "sqlite",
+	}, nil
+}
+
+func (s *sqliteProvider) SaveSetup(ctx context.Context, setup SetupRecord) error {
+	ts, _ := time.Parse(time.RFC3339, setup.InitializedAt)
+	if ts.IsZero() {
+		ts = time.Now().UTC()
+	}
+	return s.q.SaveSetup(ctx, &sqlc.SaveSetupParams{
+		ID:            setup.ID,
+		Version:       setup.Version,
+		InitializedAt: ts,
+		UsageMode:     sql.NullString{String: setup.UsageMode, Valid: setup.UsageMode != ""},
+	})
+}
+
+func (s *sqliteProvider) HasAdminUser(ctx context.Context) (bool, error) {
+	return s.q.HasAdminUser(ctx)
+}
+
+func (s *sqliteProvider) CreateAuditLog(ctx context.Context, rec AuditRecord) error {
+	return s.q.CreateAuditLog(ctx, &sqlc.CreateAuditLogParams{
+		ID:        rec.ID,
+		UserID:    sql.NullString{String: rec.UserID, Valid: rec.UserID != ""},
+		Action:    rec.Action,
+		IpAddress: sql.NullString{String: rec.IPAddress, Valid: rec.IPAddress != ""},
+		UserAgent: sql.NullString{String: rec.UserAgent, Valid: rec.UserAgent != ""},
+		Detail:    sql.NullString{String: rec.Detail, Valid: rec.Detail != ""},
+	})
+}
+
+func (s *sqliteProvider) ListAuditLogs(ctx context.Context, userID, action string, limit, offset int) ([]AuditRecord, error) {
+	rows, err := s.q.GetAuditLogs(ctx, &sqlc.GetAuditLogsParams{
+		UserID: userID,
+		Action: action,
+		Limit:  int64(limit),
+		Offset: int64(offset),
+	})
+	if err != nil {
+		return nil, err
+	}
+	items := make([]AuditRecord, 0, len(rows))
+	for _, r := range rows {
+		items = append(items, AuditRecord{
+			ID:        r.ID,
+			UserID:    r.UserID.String,
+			Action:    r.Action,
+			IPAddress: r.IpAddress.String,
+			UserAgent: r.UserAgent.String,
+			Detail:    r.Detail.String,
+			CreatedAt: r.CreatedAt,
+		})
+	}
+	return items, nil
+}
+
+func (s *sqliteProvider) CountAuditLogs(ctx context.Context, userID, action string) (int, error) {
+	count, err := s.q.CountAuditLogs(ctx, &sqlc.CountAuditLogsParams{
+		UserID: userID,
+		Action: action,
+	})
+	return int(count), err
+}
+
+func (s *sqliteProvider) CreatePasskeyCredential(ctx context.Context, rec PasskeyCredential) error {
+	return s.q.CreatePasskeyCredential(ctx, &sqlc.CreatePasskeyCredentialParams{
+		ID:              rec.ID,
+		UserID:          rec.UserID,
+		CredentialID:    rec.CredentialID,
+		PublicKey:       rec.PublicKey,
+		AttestationType: rec.AttestationType,
+		Aaguid:          rec.AAGUID,
+		SignCount:       int64(rec.SignCount),
+		Transports:      rec.Transports,
+		Name:            rec.Name,
+	})
+}
+
+func (s *sqliteProvider) GetPasskeyByCredentialID(ctx context.Context, credentialID string) (PasskeyCredential, error) {
+	row, err := s.q.GetPasskeyByCredentialID(ctx, credentialID)
+	if err != nil {
+		return PasskeyCredential{}, err
+	}
+	return s.rowToPasskey(row), nil
+}
+
+func (s *sqliteProvider) ListPasskeysByUser(ctx context.Context, userID string) ([]PasskeyCredential, error) {
+	rows, err := s.q.ListPasskeysByUser(ctx, userID)
+	if err != nil {
+		return nil, err
+	}
+	items := make([]PasskeyCredential, 0, len(rows))
+	for _, r := range rows {
+		items = append(items, s.rowToPasskey(r))
+	}
+	return items, nil
+}
+
+func (s *sqliteProvider) UpdatePasskeyLastUsed(ctx context.Context, id string, signCount uint32) error {
+	return s.q.UpdatePasskeyLastUsed(ctx, &sqlc.UpdatePasskeyLastUsedParams{
+		SignCount: int64(signCount),
+		ID:        id,
+	})
+}
+
+func (s *sqliteProvider) DeletePasskey(ctx context.Context, id, userID string) error {
+	return s.q.DeletePasskey(ctx, &sqlc.DeletePasskeyParams{ID: id, UserID: userID})
+}
+
+func (s *sqliteProvider) CreateChallenge(ctx context.Context, rec ChallengeRecord) error {
+	return s.q.CreateChallenge(ctx, &sqlc.CreateChallengeParams{
+		ID:        rec.ID,
+		Challenge: rec.Challenge,
+		UserID:    sql.NullString{String: rec.UserID, Valid: rec.UserID != ""},
+		FlowType:  rec.FlowType,
+		ExpiresAt: rec.ExpiresAt,
+	})
+}
+
+func (s *sqliteProvider) GetChallenge(ctx context.Context, id string) (ChallengeRecord, error) {
+	row, err := s.q.GetChallenge(ctx, id)
+	if err != nil {
+		return ChallengeRecord{}, err
+	}
+	return ChallengeRecord{
+		ID:        row.ID,
+		Challenge: row.Challenge,
+		UserID:    row.UserID.String,
+		FlowType:  row.FlowType,
+		ExpiresAt: row.ExpiresAt,
+		CreatedAt: row.CreatedAt,
+	}, nil
+}
+
+func (s *sqliteProvider) DeleteChallenge(ctx context.Context, id string) error {
+	return s.q.DeleteChallenge(ctx, id)
+}
+
+func (s *sqliteProvider) CreateAuthMethod(ctx context.Context, rec AuthMethodRecord) error {
+	return s.q.CreateAuthMethod(ctx, &sqlc.CreateAuthMethodParams{
+		ID:             rec.ID,
+		UserID:         rec.UserID,
+		ProviderType:   rec.ProviderType,
+		ProviderUserID: rec.ProviderUserID,
+		Metadata:       rec.Metadata,
+	})
+}
+
+func (s *sqliteProvider) GetAuthMethodByProvider(ctx context.Context, providerType, providerUserID string) (AuthMethodRecord, error) {
+	row, err := s.q.GetAuthMethodByProvider(ctx, &sqlc.GetAuthMethodByProviderParams{
+		ProviderType:   providerType,
+		ProviderUserID: providerUserID,
+	})
+	if err != nil {
+		return AuthMethodRecord{}, err
+	}
+	return AuthMethodRecord{
+		ID:             row.ID,
+		UserID:         row.UserID,
+		ProviderType:   row.ProviderType,
+		ProviderUserID: row.ProviderUserID,
+		Metadata:       row.Metadata,
+		CreatedAt:      row.CreatedAt,
+		UpdatedAt:      row.UpdatedAt,
+	}, nil
+}
diff --git a/backend/internal/storage/sqlite_support.go b/backend/internal/storage/sqlite_support.go
new file mode 100644
index 0000000..9b047a2
--- /dev/null
+++ b/backend/internal/storage/sqlite_support.go
@@ -0,0 +1,119 @@
+package storage
+
+import (
+	"context"
+	"encoding/json"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+	sqlc "github.com/IsKenKenYa/Commory/backend/internal/storage/sqlc/gen"
+)
+
+func (s *sqliteProvider) rowToUser(row *sqlc.User) UserRecord {
+	var roles, buttons []string
+	json.Unmarshal([]byte(row.Roles), &roles)
+	json.Unmarshal([]byte(row.Buttons), &buttons)
+	return UserRecord{
+		ID:           row.ID,
+		UserName:     row.UserName,
+		Email:        row.Email.String,
+		PasswordHash: row.PasswordHash,
+		PasswordSalt: row.PasswordSalt,
+		Roles:        roles,
+		Buttons:      buttons,
+		CreatedAt:    row.CreatedAt,
+		UpdatedAt:    row.UpdatedAt,
+	}
+}
+
+func (s *sqliteProvider) rowToRefreshToken(row *sqlc.RefreshToken) RefreshTokenRecord {
+	return RefreshTokenRecord{
+		ID:        row.ID,
+		UserID:    row.UserID,
+		TokenHash: row.TokenHash,
+		ParentID:  row.ParentID.String,
+		ExpiresAt: row.ExpiresAt,
+		CreatedAt: row.CreatedAt,
+		RevokedAt: row.RevokedAt.Time,
+	}
+}
+
+func (s *sqliteProvider) rowToSession(row *sqlc.Session) SessionRecord {
+	return SessionRecord{
+		ID:             row.ID,
+		UserID:         row.UserID,
+		RefreshTokenID: row.RefreshTokenID.String,
+		DeviceName:     row.DeviceName.String,
+		DeviceType:     row.DeviceType.String,
+		IPAddress:      row.IpAddress.String,
+		UserAgent:      row.UserAgent.String,
+		CreatedAt:      row.CreatedAt,
+		LastSeenAt:     row.LastSeenAt,
+	}
+}
+
+func (s *sqliteProvider) rowToPasskey(row *sqlc.PasskeyCredential) PasskeyCredential {
+	return PasskeyCredential{
+		ID:              row.ID,
+		UserID:          row.UserID,
+		CredentialID:    row.CredentialID,
+		PublicKey:       row.PublicKey,
+		AttestationType: row.AttestationType,
+		AAGUID:          row.Aaguid,
+		SignCount:       uint32(row.SignCount),
+		Transports:      row.Transports,
+		Name:            row.Name,
+		LastUsedAt:      row.LastUsedAt.Time,
+		CreatedAt:       row.CreatedAt,
+	}
+}
+
+func (s *sqliteProvider) rowToIdentity(row *sqlc.Identity) msglayer.Identity {
+	var phones, emails, labels []string
+	var meta map[string]any
+	json.Unmarshal([]byte(row.Phones), &phones)
+	json.Unmarshal([]byte(row.Emails), &emails)
+	json.Unmarshal([]byte(row.Labels), &labels)
+	json.Unmarshal([]byte(row.Meta), &meta)
+	var avatar *string
+	if row.Avatar.Valid {
+		avatar = &row.Avatar.String
+	}
+	return msglayer.Identity{
+		ID:          row.ID,
+		Type:        row.Type,
+		DisplayName: row.DisplayName,
+		Phones:      phones,
+		Emails:      emails,
+		Avatar:      avatar,
+		Labels:      labels,
+		Meta:        meta,
+	}
+}
+
+func (s *sqliteProvider) eventToTimelineItem(ctx context.Context, row *sqlc.Event) (msglayer.TimelineItem, error) {
+	participants, _ := s.q.GetEventParticipants(ctx, row.ID)
+	var meta map[string]any
+	json.Unmarshal([]byte(row.Meta), &meta)
+	return msglayer.TimelineItem{
+		EventID:        row.ID,
+		Type:           row.Type,
+		Timestamp:      row.Timestamp.UTC().Format(time.RFC3339),
+		Direction:      row.Direction,
+		ContentSummary: row.ContentSummary.String,
+		Participants:   participants,
+		Meta:           meta,
+	}, nil
+}
+
+func (s *sqliteProvider) eventsToTimelineItems(ctx context.Context, rows []*sqlc.Event) ([]msglayer.TimelineItem, error) {
+	items := make([]msglayer.TimelineItem, 0, len(rows))
+	for _, row := range rows {
+		item, err := s.eventToTimelineItem(ctx, row)
+		if err != nil {
+			return nil, err
+		}
+		items = append(items, item)
+	}
+	return items, nil
+}
diff --git a/backend/internal/storage/sqlite_test.go b/backend/internal/storage/sqlite_test.go
new file mode 100644
index 0000000..6196ed0
--- /dev/null
+++ b/backend/internal/storage/sqlite_test.go
@@ -0,0 +1,134 @@
+package storage
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"runtime"
+	"testing"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/importers"
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+)
+
+func TestSQLiteImportAndQuery(t *testing.T) {
+	ctx := context.Background()
+	dbPath := filepath.Join(t.TempDir(), "commory.sqlite")
+	store, err := NewSQLiteProvider(dbPath)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer store.Close()
+	if err := store.Init(ctx); err != nil {
+		t.Fatal(err)
+	}
+
+	rootSchema := repoPath("msglayer", "schema", "v0.1", "root.schema.json")
+	validator, err := msglayer.NewValidator(rootSchema)
+	if err != nil {
+		t.Fatal(err)
+	}
+	sample := repoPath("msglayer", "examples", "export.sms-call.json")
+	importer := importers.JSONImporter{}
+	export, raw, err := importer.Import(sample)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := validator.ValidateBytes(raw); err != nil {
+		t.Fatal(err)
+	}
+	importID, err := store.Import(ctx, "test-user", sample, export, raw)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if importID == "" {
+		t.Fatal("expected import id")
+	}
+
+	items, err := store.Search(ctx, msglayer.SearchParams{UserID: "test-user", Keyword: "验证码", Limit: 10})
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(items) == 0 {
+		t.Fatal("expected keyword search hits")
+	}
+
+	thread, err := store.GetThread(ctx, "test-user", "thread_42")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(thread) == 0 {
+		t.Fatal("expected thread reconstruction results")
+	}
+
+	rawExport, err := store.ExportImport(ctx, "test-user", "")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(rawExport) == 0 {
+		t.Fatal("expected exported raw json")
+	}
+}
+
+func TestPostgresProviderSkipsWithoutDSN(t *testing.T) {
+	if os.Getenv("COMMORY_TEST_POSTGRES_DSN") == "" {
+		t.Skip("COMMORY_TEST_POSTGRES_DSN not set")
+	}
+}
+
+func TestSQLiteAuditLogBlankUserFilterIncludesSystemEntries(t *testing.T) {
+	ctx := context.Background()
+	store, err := NewSQLiteProvider(filepath.Join(t.TempDir(), "audit.sqlite"))
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer store.Close()
+	if err := store.Init(ctx); err != nil {
+		t.Fatal(err)
+	}
+
+	now := time.Now().UTC()
+	if _, err := store.CreateUser(ctx, UserRecord{
+		ID:           "user_1",
+		UserName:     "audit-user",
+		PasswordHash: "hash",
+		PasswordSalt: "salt",
+		Roles:        []string{"R_USER"},
+		Buttons:      []string{"view"},
+		CreatedAt:    now,
+		UpdatedAt:    now,
+	}); err != nil {
+		t.Fatalf("CreateUser: %v", err)
+	}
+	for _, rec := range []AuditRecord{
+		{ID: "audit_sys", Action: "system_boot", CreatedAt: now},
+		{ID: "audit_user", UserID: "user_1", Action: "login", CreatedAt: now.Add(time.Second)},
+	} {
+		if err := store.CreateAuditLog(ctx, rec); err != nil {
+			t.Fatalf("CreateAuditLog(%s): %v", rec.ID, err)
+		}
+	}
+
+	logs, err := store.ListAuditLogs(ctx, "", "", 10, 0)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(logs) != 2 {
+		t.Fatalf("expected 2 audit logs, got %d", len(logs))
+	}
+	count, err := store.CountAuditLogs(ctx, "", "")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if count != 2 {
+		t.Fatalf("expected audit log count 2, got %d", count)
+	}
+}
+
+func repoPath(parts ...string) string {
+	_, file, _, _ := runtime.Caller(0)
+	base := filepath.Join(filepath.Dir(file), "..", "..", "..")
+	all := append([]string{base}, parts...)
+	return filepath.Join(all...)
+}
diff --git a/backend/internal/storage/storage.go b/backend/internal/storage/storage.go
new file mode 100644
index 0000000..a96f930
--- /dev/null
+++ b/backend/internal/storage/storage.go
@@ -0,0 +1,173 @@
+package storage
+
+import (
+	"context"
+	"time"
+
+	"github.com/IsKenKenYa/Commory/backend/internal/msglayer"
+)
+
+type UserRecord struct {
+	ID           string    `json:"id"`
+	UserName     string    `json:"user_name"`
+	Email        string    `json:"email"`
+	PasswordHash string    `json:"password_hash"`
+	PasswordSalt string    `json:"password_salt"`
+	Roles        []string  `json:"roles"`
+	Buttons      []string  `json:"buttons"`
+	CreatedAt    time.Time `json:"created_at"`
+	UpdatedAt    time.Time `json:"updated_at"`
+}
+
+type RefreshTokenRecord struct {
+	ID        string    `json:"id"`
+	UserID    string    `json:"user_id"`
+	TokenHash string    `json:"token_hash"`
+	ParentID  string    `json:"parent_id"`
+	ExpiresAt time.Time `json:"expires_at"`
+	CreatedAt time.Time `json:"created_at"`
+	RevokedAt time.Time `json:"revoked_at"`
+}
+
+type ImportSummary struct {
+	ID            string    `json:"id"`
+	UserID        string    `json:"user_id"`
+	SchemaVersion string    `json:"schema_version"`
+	ImportedAt    time.Time `json:"imported_at"`
+	SourcePath    string    `json:"source_path"`
+	EventCount    int       `json:"event_count"`
+	IdentityCount int       `json:"identity_count"`
+}
+
+type SetupStatus struct {
+	Initialized  bool   `json:"initialized"`
+	Version      string `json:"version"`
+	DatabaseType string `json:"database_type"`
+}
+
+type SetupRecord struct {
+	ID            string `json:"id"`
+	Version       string `json:"version"`
+	InitializedAt string `json:"initialized_at"`
+	UsageMode     string `json:"usage_mode"`
+}
+
+type SessionRecord struct {
+	ID             string    `json:"id"`
+	UserID         string    `json:"user_id"`
+	RefreshTokenID string    `json:"refresh_token_id"`
+	DeviceName     string    `json:"device_name"`
+	DeviceType     string    `json:"device_type"`
+	IPAddress      string    `json:"ip_address"`
+	UserAgent      string    `json:"user_agent"`
+	CreatedAt      time.Time `json:"created_at"`
+	LastSeenAt     time.Time `json:"last_seen_at"`
+}
+
+type AuditRecord struct {
+	ID        string    `json:"id"`
+	UserID    string    `json:"user_id"`
+	Action    string    `json:"action"`
+	IPAddress string    `json:"ip_address"`
+	UserAgent string    `json:"user_agent"`
+	Detail    string    `json:"detail"`
+	CreatedAt time.Time `json:"created_at"`
+}
+
+type PasskeyCredential struct {
+	ID              string    `json:"id"`
+	UserID          string    `json:"user_id"`
+	CredentialID    string    `json:"credential_id"`
+	PublicKey       string    `json:"public_key"`
+	AttestationType string    `json:"attestation_type"`
+	AAGUID          string    `json:"aaguid"`
+	SignCount       uint32    `json:"sign_count"`
+	Transports      string    `json:"transports"`
+	Name            string    `json:"name"`
+	LastUsedAt      time.Time `json:"last_used_at"`
+	CreatedAt       time.Time `json:"created_at"`
+}
+
+type ChallengeRecord struct {
+	ID        string    `json:"id"`
+	Challenge string    `json:"challenge"`
+	UserID    string    `json:"user_id"`
+	FlowType  string    `json:"flow_type"`
+	ExpiresAt time.Time `json:"expires_at"`
+	CreatedAt time.Time `json:"created_at"`
+}
+
+type AuthMethodRecord struct {
+	ID             string    `json:"id"`
+	UserID         string    `json:"user_id"`
+	ProviderType   string    `json:"provider_type"`
+	ProviderUserID string    `json:"provider_user_id"`
+	Metadata       string    `json:"metadata"`
+	CreatedAt      time.Time `json:"created_at"`
+	UpdatedAt      time.Time `json:"updated_at"`
+}
+
+type Provider interface {
+	Name() string
+	Init(context.Context) error
+	Import(context.Context, string, string, msglayer.RootExport, []byte) (string, error)
+	ListImports(context.Context, string) ([]ImportSummary, error)
+	ExportImport(context.Context, string, string) ([]byte, error)
+	LatestImportID(context.Context, string) (string, error)
+	GetEvent(context.Context, string, string) (msglayer.TimelineItem, error)
+	ListEvents(context.Context, msglayer.SearchParams) ([]msglayer.TimelineItem, error)
+	Search(context.Context, msglayer.SearchParams) ([]msglayer.TimelineItem, error)
+	Timeline(context.Context, msglayer.SearchParams) ([]msglayer.TimelineItem, error)
+	ListIdentities(context.Context, string) ([]msglayer.Identity, error)
+	GetIdentity(context.Context, string, string) (msglayer.Identity, error)
+	GetThread(context.Context, string, string) ([]msglayer.TimelineItem, error)
+	CreateUser(context.Context, UserRecord) (UserRecord, error)
+	FindUserByUserName(context.Context, string) (UserRecord, error)
+	GetUser(context.Context, string) (UserRecord, error)
+	SaveRefreshToken(context.Context, RefreshTokenRecord) error
+	ConsumeRefreshToken(context.Context, string) (RefreshTokenRecord, error)
+	GetSetupStatus(context.Context) (SetupStatus, error)
+	SaveSetup(context.Context, SetupRecord) error
+	HasAdminUser(context.Context) (bool, error)
+	UpdateUserPasswordHash(context.Context, string, string, string) error // userID, newHash, newSalt
+
+	// 重放检测：查找任何匹配的 token（包括已撤销的）
+	FindAnyRefreshTokenByHash(context.Context, string) (RefreshTokenRecord, error)
+	HasActiveRefreshTokenChild(context.Context, string) (bool, error)
+	// 令牌族撤销：按 parent_id 链撤销整族
+	RevokeRefreshTokenFamily(context.Context, string) error
+	RevokeRefreshTokenByID(context.Context, string) error
+
+	// 会话管理
+	CreateSession(context.Context, SessionRecord) error
+	GetSession(context.Context, string) (SessionRecord, error)
+	GetSessionByRefreshTokenID(context.Context, string) (SessionRecord, error)
+	ListSessionsByUser(context.Context, string) ([]SessionRecord, error)
+	RevokeSession(context.Context, string) error
+	RevokeOtherSessions(context.Context, string, string) error // userID, currentSessionID
+	UpdateSessionLastSeen(context.Context, string) error
+	UpdateSessionRefreshToken(context.Context, string, string) error // sessionID, refreshTokenID
+
+	// 审计日志
+	CreateAuditLog(context.Context, AuditRecord) error
+	ListAuditLogs(context.Context, string, string, int, int) ([]AuditRecord, error) // userID, action, limit, offset
+	CountAuditLogs(context.Context, string, string) (int, error)
+
+	// Passkey
+	CreatePasskeyCredential(context.Context, PasskeyCredential) error
+	GetPasskeyByCredentialID(context.Context, string) (PasskeyCredential, error)
+	ListPasskeysByUser(context.Context, string) ([]PasskeyCredential, error)
+	UpdatePasskeyLastUsed(context.Context, string, uint32) error // id, signCount
+	DeletePasskey(context.Context, string, string) error         // id, userID
+
+	// 认证 Challenge
+	CreateChallenge(context.Context, ChallengeRecord) error
+	GetChallenge(context.Context, string) (ChallengeRecord, error)
+	DeleteChallenge(context.Context, string) error
+
+	// 统一认证方式
+	CreateAuthMethod(context.Context, AuthMethodRecord) error
+	GetAuthMethodByProvider(context.Context, string, string) (AuthMethodRecord, error) // providerType, providerUserID
+
+	Close() error
+}
diff --git a/backend/migrations/001_init.sql b/backend/migrations/001_init.sql
new file mode 100644
index 0000000..9f11577
--- /dev/null
+++ b/backend/migrations/001_init.sql
@@ -0,0 +1,7 @@
+CREATE TABLE imports (
+  id TEXT PRIMARY KEY,
+  schema_version TEXT NOT NULL,
+  imported_at TEXT NOT NULL,
+  source_path TEXT NOT NULL,
+  raw_json TEXT NOT NULL
+);
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..0994b9b
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,23 @@
+services:
+  commory:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: commory:local
+    container_name: commory
+    restart: unless-stopped
+    ports:
+      - "${COMMORY_HTTP_PORT:-3000}:3000"
+    environment:
+      COMMORY_LISTEN_ADDR: ":3000"
+      COMMORY_DB_DRIVER: sqlite
+      COMMORY_DB_DSN: /data/commory-store.json
+      COMMORY_SCHEMA_ROOT: /app/msglayer/schema/v0.1/root.schema.json
+      COMMORY_WEB_ROOT: /app/web
+      COMMORY_AUTH_SECRET: ${COMMORY_AUTH_SECRET:-change-me}
+      COMMORY_ENV: ${COMMORY_ENV:-development}
+    volumes:
+      - commory_data:/data
+
+volumes:
+  commory_data:
diff --git "a/docs/adr/0001-\345\217\202\350\200\203\350\265\204\346\226\231\346\262\273\347\220\206.md" "b/docs/adr/0001-\345\217\202\350\200\203\350\265\204\346\226\231\346\262\273\347\220\206.md"
new file mode 100644
index 0000000..a63afda
--- /dev/null
+++ "b/docs/adr/0001-\345\217\202\350\200\203\350\265\204\346\226\231\346\262\273\347\220\206.md"
@@ -0,0 +1,24 @@
+# ADR 0001：参考资料治理与 clean-room 学习
+
+## 状态
+
+已接受。
+
+## 背景
+
+Commory 可以从优秀的 Go、自托管和 Agent 系统中学习架构经验。一些有价值的参考项目使用限制性或未知许可证，一些本地源码快照也不适合作为实现来源。项目需要明确区分“学习架构”和“派生实现”。
+
+## 决策
+
+所有参考项目都放在 `references/` 下，它们是架构输入，不是实现依赖。Commory 代码不得从参考项目中 import、复制、翻译或机械移植代码、字符串、schema、字段名或专有结构。
+
+MIT、Apache-2.0、BSD 等宽松许可证参考项目可以深入学习，但实现仍必须是 Commory 自有。AGPL、GPL、LGPL、proprietary 和 unknown-license 参考项目只能作为只读设计材料。它们带来的经验必须先改写为 Commory 自有 ADR、interface、test 或 design note，再进入实现。
+
+`references/ClaudeCodeSource` 仅限 clean-room 使用。它可以用于产品和架构层面的思考，例如高级 Agent 的 task model、tool permission、session continuity、bridge concept、context compaction、command organization 和 UX，但不得作为实现细节来源。
+
+## 后果
+
+- `references/README.md` 是必需目录，用来记录参考目的、许可证策略、学习目标和禁止借用的内容。
+- CI 运行 `scripts/check-reference-governance.sh`，拦截未登记 submodule 和缺失 policy 记录。
+- GitHubDaily 只作为 discovery index；通过它发现的每个项目在加入前仍需单独验证许可证。
+- 受参考资料启发的新架构，应先落为 ADR 和 Commory 自有 interface，再进入产品集成。
diff --git "a/docs/adr/0002-\346\225\260\346\215\256\345\272\223-sqlc-\350\277\201\347\247\273.md" "b/docs/adr/0002-\346\225\260\346\215\256\345\272\223-sqlc-\350\277\201\347\247\273.md"
new file mode 100644
index 0000000..9d3cd69
--- /dev/null
+++ "b/docs/adr/0002-\346\225\260\346\215\256\345\272\223-sqlc-\350\277\201\347\247\273.md"
@@ -0,0 +1,26 @@
+# ADR 0002：存储层使用 SQLC 与版本化迁移
+
+## 状态
+
+已接受。
+
+## 背景
+
+Commory 目前暴露 `sqlite` 和 `postgres` provider，但两者底层都由同一个 JSON file store adapter 支撑。这对早期产品流程有帮助，但不是可靠的多数据库基础。
+
+长期目标是：个人/本地部署优先 SQLite，生产或多人部署支持 Postgres 或 MySQL。
+
+## 决策
+
+Commory 的持久存储层使用显式 SQL 加生成类型。首选路线是 `sqlc` 配合 SQLite、Postgres、MySQL 的版本化 migrations。
+
+跨数据库差异必须体现在 query 和 migration 组织中，而不是隐藏在分散的 runtime branches 里。当不同数据库行为存在差异时，storage contract test 定义共享行为，每个 driver 负责证明自己符合契约。
+
+现有 JSON file store 仍可作为开发 fixture 和迁移来源，但不得再被展示为真实 SQLite 或 Postgres 实现。
+
+## 后果
+
+- 替换当前 file-backed provider 前，先增加 storage contract tests。
+- 为每个支持的数据库家族引入 schema migrations。
+- 从 SQL 生成 typed query packages，而不是引入业务 ORM。
+- setup 和 diagnostics 必须明确 active database driver 和 persistence risk。
diff --git "a/docs/adr/0003-agent-\350\277\220\350\241\214\346\227\266\350\276\271\347\225\214.md" "b/docs/adr/0003-agent-\350\277\220\350\241\214\346\227\266\350\276\271\347\225\214.md"
new file mode 100644
index 0000000..c44fe96
--- /dev/null
+++ "b/docs/adr/0003-agent-\350\277\220\350\241\214\346\227\266\350\276\271\347\225\214.md"
@@ -0,0 +1,26 @@
+# ADR 0003：Agent Runtime 边界
+
+## 状态
+
+已接受。
+
+## 背景
+
+Commory 需要向高级 Agent 系统学习，但不能复制它们。ClaudeCodeSource、Hermes 和 OpenClaw 展示了 task state、tool permissions、provider registries、plugin boundaries、diagnostics 和 session continuity 等有价值的模式。
+
+## 决策
+
+Commory 的 Agent 工作从一个很小的 Go 自有边界开始：
+
+`runtime -> provider adapter -> tool registry -> permission broker -> session store`
+
+runtime 负责 orchestration。provider 负责 model I/O。tool 通过 Commory 自有 metadata 描述，并且只能经由 registry 调用。permission decision 必须显式且可测试。session 通过 interface 持久化，让 storage layer 可以独立演进。
+
+核心 packages 不得依赖 plugin implementation。plugin 只能通过 SDK-style interface 进入系统。
+
+## 后果
+
+- Agent 代码从 `backend/internal/agent` 开始，包含 interface 和窄行为测试。
+- 产品 handler 应调用 service 或 runtime，不直接引用 provider 或 plugin internals。
+- 未来 plugin API 必须是 additive、documented、versioned，才能开放给第三方。
+- 来自参考资料的高级概念必须翻译成 Commory 自有命名和行为。
diff --git a/docs/android-runtime-modes.md b/docs/android-runtime-modes.md
new file mode 100644
index 0000000..1d3d12d
--- /dev/null
+++ b/docs/android-runtime-modes.md
@@ -0,0 +1,18 @@
+# Android 运行模式
+
+Commory Android 支持两个明确的运行模式。
+
+## Local Only
+
+- 不需要账号或服务器。
+- 备份和恢复使用本地 app storage。
+- Agent context policy 为 `LOCAL_ONLY`；上下文不得发送给 server-backed provider。
+- 切换到 local mode 会清除移动端 auth tokens，但保留本地备份文件。
+
+## Commory Server
+
+- 用户使用现有 Commory username/password auth flow 登录。
+- 备份仍然先写入本地 MsgLayer JSON 文件。
+- `syncOnBackup` 启用且存在有效 session 时，Android 把生成文件上传到 `/api/imports/upload`。
+- 远程 import history 和 export 使用已认证的 Commory Server endpoints。
+- Agent context policy 为 `SERVER_ALLOWED`，但未来 AI 功能仍必须应用相关性过滤和最小必要上下文过滤。
diff --git a/docs/architecture-roadmap.md b/docs/architecture-roadmap.md
new file mode 100644
index 0000000..cb1efed
--- /dev/null
+++ b/docs/architecture-roadmap.md
@@ -0,0 +1,37 @@
+# Commory 架构路线图
+
+Commory 正在从原型存储和直接 handler 走向持久、可测试的 service 边界。近期工作刻意保持朴素：先补数据库正确性、认证加固和架构护栏，再扩展更丰富的 Agent 行为。
+
+## 阶段 1：持久化基础
+
+- 把文件存储伪装的 `sqlite` 和 `postgres` provider alias 替换为真实 SQL 实现。
+- 使用 `sqlc` 加版本化 migrations 支持 SQLite、Postgres 和 MySQL。
+- 为 auth、setup、import/export、search、timeline、identities 和 refresh token rotation 增加 storage contract tests。
+- setup diagnostics 必须明确当前 database type 和 SQLite persistence risk。
+- Docker Compose 先使用 file-backed sqlite 开发部署，后续 SQL 迁移再扩展 Postgres/MySQL profile。
+
+## 阶段 2：认证与权限
+
+- 保持短生命周期 access tokens，并使用 refresh token rotation。
+- 增加 session/device records、revoke audit，以及 user/admin/root 行为的 typed role constants。
+- HTTP middleware 保持薄层；认证授权决策放在 service-level code。
+
+## 阶段 3：Agent Runtime
+
+- 在 `backend/internal/agent` 建立 Go 自有 runtime boundary。
+- 通过 interface 增加 provider adapters。
+- 在允许 tool 修改本地状态前，先建立 tool registry 和 permission broker。
+- 通过 storage interfaces 持久化 task/session state。
+
+## 阶段 4：Web Dashboard 与单端口部署
+
+- Go backend 同源提供 `/api/*` 与 Web 静态资源，生产默认避免 CORS。
+- Web 以 Art Design Pro 为模板基线，所有新增页面满足 i18n、dark mode、主题变量和图表配色规范。
+- Dashboard 功能按 Android、Backend、Web、MsgLayer 同步规划，避免只做单端体验。
+
+## 阶段 5：参考资料挖掘
+
+- 使用 GitHubDaily 发现候选 Go 项目。
+- 优先选择 MIT、Apache-2.0 和 BSD 参考项目。
+- AGPL/GPL/LGPL/unknown-license 项目只用于只读架构观察。
+- 每个被接受的参考项目都必须记录在 `references/README.md`。
diff --git a/docs/engineering-standards.md b/docs/engineering-standards.md
new file mode 100644
index 0000000..0d49556
--- /dev/null
+++ b/docs/engineering-standards.md
@@ -0,0 +1,153 @@
+# 工程标准
+
+这是 Commory 的唯一工程标准。长期规则放在这里，Agent 工作流入口放在 `AGENTS.md`，发布历史放在 `CHANGELOG.md`。
+
+## 架构边界
+
+- Android `app` 负责 Compose UI、权限、平台读写器、导航、运行模式设置和 Android 专属网络能力。
+- Android `sdk/backup` 负责纯 Kotlin 备份/恢复编排和 MsgLayer 映射。
+- Android `sdk/auth` 负责纯 Kotlin 认证契约。
+- Android `sdk/storage` 负责存储契约和 Android 存储实现。
+- Backend handler 保持薄层：解析 HTTP、调用 auth/storage/query/import/setup service、返回 envelope。
+- Web 负责 server-backed dashboard workflow，并遵循 `web/` 现有 Vue 3、Vite、Pinia、Element Plus 模式。
+- MsgLayer schema 是 Android、backend、web 和未来 agent 之间的 canonical interchange format。
+- 默认部署形态是单端口：Go backend 同时提供 `/api/*` 和 Web 静态资源。
+
+## 命名
+
+- Android application id：`com.iskenkenya.commory`。
+- Android app namespace 和源码包：`com.iskenkenya.commory.mobile`。
+- Android SDK 包：`com.iskenkenya.commory.sdk.*`。
+- Backend Go module 保持 `github.com/IsKenKenYa/Commory/backend`。
+- 当前用户可见产品名是 `Commory`；旧名称只能作为历史保留在历史 changelog 中。
+
+## 仓库边界
+
+- `previewer/` 是历史归档。当前 roadmap、CI、文档或命名工作不要更新它。
+- `references/` 是只读外部参考代码。
+- `.agents/skills` 是项目 skills 的唯一手工维护来源。
+- `.claude/skills` 由 `.agents/skills` 生成，用于 Claude Code 兼容。
+- 不要新增已追踪构建产物、日志、`.DS_Store`、IDE 文件、调试报告或 `AI_EDIT_LOG.md`。
+
+## 项目管理
+
+- 发布记录写入 `CHANGELOG.md`，版本采用 `v0.x.y`。
+- PR 使用 `.github/pull_request_template.md`，说明影响范围、测试、契约、i18n、隐私、本地模式和 Docker 影响。
+- 分支策略：`main` 稳定且 CI 全绿，功能使用 `feat/*`，修复使用 `fix/*`，禁止直接推送 `main`。
+- 跨 Android、Backend、Web、MsgLayer、Agent、Docker 的变更必须同步评估，并在 PR 中说明。
+- 技术债记录在 `docs/technical-debt.md`，不要在无关 PR 中顺手改。
+- 默认不使用 subagent 或平行代理。只有用户明确要求委派、分工或 parallel agent work 时才可使用。
+- 面向用户的交付物禁止包含原始 scratchpad、逐段回放式研究过程或重复的中间分析；保留决策、变更、验证和风险即可。
+- 跨边界工作默认按纵向切片推进：先修契约和编译断点，再补客户端对齐，再扩展 UI/治理，避免单个不可审阅的大 diff。
+
+## 中文优先与国际化
+
+- 文档、Rules、代码注释、维护者提示、测试失败信息和数据库备注中文优先。
+- 产品代码里的用户可见文本必须走国际化，不要因为中文优先而硬编码中文。
+- Web 使用 `vue-i18n`，配置在 `web/src/locales/index.ts`，内置语言包为 `web/src/locales/langs/zh.json` 和 `web/src/locales/langs/en.json`。
+- Android 用户可见字符串必须同时存在于 `values/strings.xml`、`values-en/strings.xml`、`values-zh-rCN/strings.xml`。
+- Compose UI 必须使用 `stringResource`。
+- 动态错误应在 UI 边界前类型化，并通过占位符本地化。
+- 系统内置国际化只负责中文和英文；其它语言留给社区扩展。
+- 不要翻译代码标识符、JSON key、数据库字段名、HTTP endpoint、配置项、命令、包名、常量值和公开契约。
+- `README.md` 是中文优先入口；`README.en.md` 保持英文镜像。
+
+## Web Dashboard
+
+- Web UI 以 `references/art-design-pro` 为模板基线，`references/memos/web` 仅作产品组织参考。
+- 新页面必须遵循 `docs/web-dashboard-guidelines.md`，满足中英 i18n、dark mode、主题变量、ECharts 配色、布局密度和 Element Plus 规范。
+- `web/.env.production` 默认使用同源 API，不得恢复到 mock 服务作为生产默认值。
+- Web 默认权限模式为 frontend：`roles` 用于路由访问，`buttons` 用于按钮能力。backend 动态菜单属于未来商业化或多租户场景，不作为当前默认架构。
+
+## Docker 与部署
+
+- 根目录 `Dockerfile` 构建完整 Commory 镜像：Web static assets、Go backend、MsgLayer schema。
+- `docker-compose.yml` 默认只暴露一个端口，使用 file-backed sqlite 开发存储。
+- `COMMORY_WEB_ROOT` 指向 Web 静态资源目录；非 `/api` 请求 fallback 到 `index.html` 支持 SPA refresh。
+- `/api/*` 必须保持 API 行为，不得 fallback 到 Web index。
+
+## Skills
+
+Skills 是上下文加载工具，不是通用文档目录。
+
+- 每个 skill 必需：`SKILL.md`，包含简洁 frontmatter（`name`、`description`）和精简 workflow。
+- 推荐：需要 UI metadata 时使用 `agents/openai.yaml`。
+- 可选：`scripts/`、`references/`、`assets/`。
+- skill 内禁止：`README.md`、`CHANGELOG.md`、`AGENTS.md`、安装指南、快速参考和重复的大段文档。
+
+更新 skills 时，编辑 `.agents/skills`，然后运行：
+
+```bash
+bash scripts/sync-agent-skills.sh
+```
+
+CI 或 review 中使用 `bash scripts/sync-agent-skills.sh --check` 确认 `.claude/skills` 没有漂移。
+
+## 上下文管理
+
+使用能完成任务的最小上下文包：
+
+- Android UI：navigation host、目标 screen、字符串资源、相关 ViewModel。
+- Android auth/network：runtime environment、auth provider、server client、SDK contracts、mobile API docs。
+- Backend API：server handler、auth middleware/service、storage provider、API tests、mobile API docs。
+- Web：API client、auth store、route guards、目标 view、现有 dashboard conventions。
+- MsgLayer：schema、examples、validators、Android mapper/serializer。
+- 治理：本文件、`AGENTS.md`、CI workflow、scripts、skills。
+
+除非能消除真实重复或澄清跨模块契约，否则不要新增共享抽象。大文件或大 diff 需要拆分，或在 PR 中给出简短理由。
+
+- 当任务同时跨 Android、Backend、Web 时，优先拆成能独立验证的纵向切片：规则/文档、backend foundation、client parity、UI/运营面。
+- 如果某一切片尚未验证通过，不要继续向下堆叠新的跨边界能力。
+
+## 文件规模与拆分边界
+
+- 单文件只承载一个 feature slice 或一个清晰层级职责。不要把多个独立能力继续堆进 `server.go`、`*service.go`、storage provider 实现文件或 mega test file。
+- 新增代码默认先并入现有同职责文件；仅在跨职责、逼近阈值或能明显提升审阅边界时拆分。
+- 不要为了“拆分”制造 1 函数 / 1 类型微文件。新增紧耦合 helper 若总量低于约 `80` 行，默认并入同 feature 文件。
+- 手写业务源码进入重构警戒线为 `350` 行；超过后默认应拆分或在交付说明中给出简短理由。
+- 手写业务源码硬上限为 `500` 行；现有治理脚本默认对当前变更集中的 Commory-owned 超线文件直接失败，避免把历史超线文件与本轮修复强绑定。
+- Web 参考基线通过 `web/reference-baseline-paths.txt` 维护，覆盖从 `references/art-design-pro` 演化而来的路径前缀；这些 baseline 文件允许保留历史超线，但必须在复杂度报表里单列暴露。
+- 生成代码、schema、fixture、资源文件不纳入硬失败，但复杂度报告仍需暴露 `1000+` 文件，便于后续治理。
+- handler 层按认证、导入、查询、会话、审计等能力分组；auth 层按 orchestration、token、password、audit/rate-limit 分组；storage provider 按 import/query、auth/session、setup/passkey/support 分组；测试按行为域分组。
+- 跨 Android、Backend、Web 的改动必须同步评估契约、测试、文档和部署影响，并默认按纵向切片推进：先修契约与基础层，再补客户端，再补 UI/治理，避免单个不可审阅的大 diff。
+- 长期规则变更必须同步更新 `AGENTS.md` 与 `CLAUDE.md`；三处文档内容可详略不同，但关键硬限制必须一致。
+
+## 日志与隐私
+
+- 日志可以标识 subsystem 和 operation context。
+- 日志不得包含短信正文、联系人内容、auth token、refresh token、备份载荷，或带凭据的私有服务器 URL。
+- 本地备份已经成功时，服务器上传失败必须是非破坏性的。
+- Local-only mode 不得要求 backend auth 或网络。
+
+## 测试
+
+- Backend 核心包应重点覆盖 storage、auth、validators、import/query logic、setup 和 mobile contracts。
+- Android SDK 纯 Kotlin 逻辑使用 JVM tests。
+- Android ViewModel/domain 行为尽量使用 JVM tests。
+- Instrumented tests 只用于权限、content providers、Compose flows 和平台行为。
+- Web 变更必须通过 lint 和 production build。
+
+## 质量门禁
+
+```bash
+cd backend && go vet ./... && go test ./... -coverprofile=coverage.out
+cd android && ./gradlew :app:compileDebugKotlin && ./gradlew :app:testDebugUnitTest
+cd web && pnpm install --frozen-lockfile && pnpm lint && pnpm build
+bash scripts/check-repo-hygiene.sh
+bash scripts/check-android-i18n.sh
+bash scripts/sync-agent-skills.sh --check
+docker compose config
+```
+
+- `bash scripts/check-repo-hygiene.sh` 会对当前变更集中的 Commory-owned 手写 `.go`、`.kt`、`.java`、`.ts`、`.tsx`、`.vue` 源码执行 `500` 行硬门禁，并按 `web/reference-baseline-paths.txt` 放行参考衍生的 Web baseline 文件。
+- `bash scripts/report-loc-complexity.sh` 会输出手写源码最大文件列表、Commory-owned `350+` 警戒清单、Web baseline `350+` 清单，以及 `1000+` 的 generated/schema/resource 报告。
+
+## 发布检查
+
+- Mobile API contract 仍与 `docs/mobile-api.md` 一致。
+- Local-only mode 在没有网络或 auth 时可用。
+- Server mode 覆盖 setup、login/register、refresh、logout、upload、list、export flows。
+- Android locale keys 完整。
+- 跨边界 API/schema 变更包含文档和测试。
+- Changelog 说明用户可见变更和兼容性变化。
+- 单端口部署中 `/`、SPA route 和 `/api/setup` 均可访问，且无 CORS 错误。
diff --git a/docs/mobile-api.md b/docs/mobile-api.md
new file mode 100644
index 0000000..46f3acf
--- /dev/null
+++ b/docs/mobile-api.md
@@ -0,0 +1,101 @@
+# 移动端 API 契约
+
+Android app 只有在用户选择 `COMMORY_SERVER` 时才使用 Commory Server。`LOCAL_ONLY` 从不要求认证或网络访问。
+
+## Envelope
+
+JSON API 响应使用：
+
+```json
+{
+  "code": 200,
+  "msg": "ok",
+  "data": {}
+}
+```
+
+错误响应使用相同 envelope，`data: null`，HTTP status code 与 `code` 对齐。Android 不应直接把服务端 `msg` 当最终文案展示；它应包裹为可重试、可本地化的用户错误。
+
+## Setup
+
+- `GET /api/setup`
+- 公开 endpoint。
+- 返回服务器是否已经初始化。
+
+```json
+{
+  "status": true,
+  "database_type": "sqlite",
+  "root_init": true
+}
+```
+
+## Auth
+
+- `POST /api/auth/register`
+- Body：`{ "userName": "alice", "email": "alice@example.com", "password": "..." }`
+- Response data：`{ "user": User, "token": "access" }`
+- 同时通过 `Set-Cookie: commory_refresh_token=...; HttpOnly; SameSite=Strict` 下发 refresh cookie。
+
+- `POST /api/auth/login`
+- Body：`{ "userName": "alice", "password": "..." }`
+- Response data 与 register 一致，refresh token 同样只通过 cookie 返回。
+
+- `POST /api/auth/refresh`
+- Android / Web 第一方客户端默认不传 body，直接依赖 refresh cookie。
+- 服务端仍兼容 body 里的 `refreshToken` 作为过渡输入，但不会再在响应体返回 refresh token。
+- Response data：`{ "token": "access" }`
+- 若旧 refresh token 因并发第二次消费命中短暂竞争，服务端返回 `409 ERR_REFRESH_TOKEN_RETRY`；客户端应立刻重试一次。
+
+- `POST /api/auth/logout`
+- Android / Web 第一方客户端默认不传 body，直接依赖 refresh cookie。
+- 服务端会清除 refresh cookie。
+
+Android 通过 `Authorization: Bearer <access token>` 发送认证请求。
+
+公开 auth 错误 `msg` 统一使用稳定错误码，例如：
+
+- `ERR_INVALID_REQUEST`
+- `ERR_INVALID_CREDENTIALS`
+- `ERR_USERNAME_EXISTS`
+- `ERR_TOO_MANY_LOGIN_ATTEMPTS`
+- `ERR_REFRESH_TOKEN_REQUIRED`
+- `ERR_REFRESH_TOKEN_EXPIRED`
+- `ERR_REFRESH_TOKEN_REPLAYED`
+- `ERR_REFRESH_TOKEN_RETRY`
+- `ERR_UNAUTHORIZED`
+
+## User
+
+- `GET /api/user/info`
+- 需要认证。
+- 返回当前用户记录。Android 只使用 id、username、email 和 roles 做 session 展示。
+
+## Imports
+
+- `GET /api/imports`
+- 需要认证。
+- 返回 import summaries，包括 id、schema version、import timestamp、source path、event count 和 identity count。
+
+- `POST /api/imports/upload`
+- 需要认证。
+- Body：原始 `application/json` MsgLayer export 或 multipart `file`。
+- Response data：
+
+```json
+{
+  "import_id": "import_...",
+  "msglayer_version": "msglayer/v0.1"
+}
+```
+
+- `GET /api/imports/{importId}/export`
+- 需要认证。
+- 返回原始 MsgLayer JSON export，用于恢复或本地检查。
+
+## 移动端行为
+
+- Server mode 始终先写本地备份。
+- `syncOnBackup` 启用且用户已认证时，Android 把生成的 MsgLayer JSON 上传到 `/api/imports/upload`。
+- 切回 local mode 会清除 mobile session，但不删除本地备份文件。
+- 网络、认证和验证失败不得让已经生成的本地备份失效。
diff --git a/docs/project-management.md b/docs/project-management.md
new file mode 100644
index 0000000..853a95e
--- /dev/null
+++ b/docs/project-management.md
@@ -0,0 +1,35 @@
+# 项目管理规范
+
+## 发布管理
+
+- 使用 `CHANGELOG.md` 记录每个里程碑的用户可见变更、兼容性影响和迁移说明。
+- 版本采用 `v0.x.y` 格式。当前处于 `v0` 阶段，API、MsgLayer schema 和部署方式仍可能变化。
+- 每次发布前逐项确认 `docs/engineering-standards.md` 中的 Release Checklist。
+
+## 代码审查流程
+
+- 所有非文档小改都通过 PR 合并，PR 使用 `.github/pull_request_template.md`。
+- PR 必须说明变更描述、影响范围、测试方法、契约一致性检查、i18n、隐私、本地模式和 Docker 影响。
+- 涉及 Android + Backend + Web + MsgLayer 任意两个以上模块的 PR，至少需要两个审查者。
+- 审查时必须检查 Commory 特定项：local-only mode、server-optional、隐私日志、Agent context policy、API/MsgLayer 契约和中英国际化。
+
+## 分支策略
+
+- `main` 是稳定分支，要求 CI 全绿。
+- `feat/*` 用于功能分支。
+- `fix/*` 用于修复分支。
+- 禁止直接推送到 `main`。该规则需要在 GitHub branch protection 中启用。
+
+## 多端规划
+
+- 跨端功能必须同时评估 Android、Backend、Web、MsgLayer、Agent 和 Docker/部署影响。
+- API 或 schema 先更新契约文档，再改实现。
+- Web 功能必须遵循 `docs/web-dashboard-guidelines.md`。
+- 部署相关功能优先考虑单端口同源方案，避免 CORS 成为默认复杂度。
+
+## 文档维护
+
+- `docs/mobile-api.md` 是 Android 和 backend 的契约文档，任何 API 变更必须同步更新。
+- `docs/engineering-standards.md` 是工程规范唯一真相源。
+- `AGENTS.md` 是 Agent 入口文件，保持精简。
+- `.agents/skills` 是项目知识库来源；修改后必须运行 `bash scripts/sync-agent-skills.sh`。
diff --git a/docs/technical-debt.md b/docs/technical-debt.md
new file mode 100644
index 0000000..a80d8f8
--- /dev/null
+++ b/docs/technical-debt.md
@@ -0,0 +1,21 @@
+# 技术债清单
+
+本文记录已经识别但不应混入当前功能 PR 的技术债。每项技术债必须绑定解决阶段或触发条件。
+
+## Android Gradle 弃用警告
+
+- 问题：Jetifier、Manifest package、Gradle 10 deprecation 等警告会影响后续构建升级。
+- 影响：短期不阻塞功能，但会增加 Android toolchain 升级成本。
+- 计划：独立 issue 跟踪，在下一轮 Android 构建系统整理中处理。
+
+## `persist()` 全量写入
+
+- 问题：当前 file-backed 存储在持久化时存在全量写入性能风险。
+- 影响：数据量增长后导入、refresh token、查询写入路径可能变慢。
+- 计划：ADR 0002 的 SQL 存储迁移阶段解决，通过真实 SQL migrations 和 typed query 替换。
+
+## `ConsumeRefreshToken` 线性扫描
+
+- 问题：当前 file-backed 存储中 refresh token 消费使用线性扫描。
+- 影响：当前开发规模可接受，但多用户或长期运行后不适合生产。
+- 计划：SQL 迁移时建立 refresh token 索引，并用 storage contract tests 固化行为。
diff --git a/docs/web-dashboard-guidelines.md b/docs/web-dashboard-guidelines.md
new file mode 100644
index 0000000..98d84f5
--- /dev/null
+++ b/docs/web-dashboard-guidelines.md
@@ -0,0 +1,41 @@
+# Web Dashboard 规范
+
+Commory Web 以 `references/art-design-pro` 为 UI 模板基线，以 `references/memos/web` 作为产品组织参考。参考资料只用于学习结构和体验，不复制源码实现。
+
+## 模板基线
+
+- 页面布局、导航、工作台标签、设置面板、暗色模式和主题变量遵循 Art Design Pro 现有模式。
+- 新 dashboard 页面优先复用 `web/src/components/core`、Element Plus、Pinia、Vue Router 和现有 style tokens。
+- 不新增与模板冲突的全局样式系统；确需新增时先写入局部组件或明确扩展现有变量。
+
+## 国际化
+
+- 用户可见文案必须进入 `web/src/locales/langs/zh.json` 和 `web/src/locales/langs/en.json`。
+- Vue 模板使用 `$t(...)`，composition API 中使用 `useI18n()`。
+- 不在 `.vue`、`.ts` 中硬编码中文或英文用户文案。
+- 路由 `meta.title` 应使用 i18n key；`formatMenuTitle()` 负责把 key 转成当前语言文案，缺失 key 会在开发环境提示。
+
+## 权限模式
+
+- 当前产品默认保持 `VITE_ACCESS_MODE=frontend`；除非出现多租户、运营后台动态配置菜单或大量角色差异，不切换到 backend 菜单模式。
+- 路由 `meta.roles` 控制页面访问；登录用户的 `buttons` 权限码控制按钮级能力。
+- 前端模式下按钮显示优先使用 `useAuth().hasAuth()`，它会响应式读取 `userStore.info.buttons`。
+- `v-roles` 继续用于角色级 DOM 显示；`v-auth` 仅适用于 backend 菜单返回的 `meta.authList`，不要在当前 frontend 模式下把它作为按钮权限主路径。
+
+## 暗色模式与主题
+
+- 新组件必须在 light、dark、system theme 下可读。
+- 颜色使用现有主题变量或 `AppConfig.systemMainColor`，避免单独写死大面积色值。
+- 图表必须跟随主题变化，优先使用 `web/src/hooks/core/useChart.ts` 和 `web/src/plugins/echarts.ts` 的模式。
+
+## 图表与数据展示
+
+- ECharts 只按需注册实际使用的 chart/component。
+- 图表配色遵循 Art Design Pro 的蓝色主色、成功/警告/危险状态色和暗色背景对比。
+- 表格、筛选、分页和空状态优先使用现有 `ArtTable`、Element Plus 和项目 API client。
+
+## 交付检查
+
+- `pnpm lint`
+- `pnpm build`
+- 手动检查中英文切换、dark mode、刷新路由、图表 resize、空数据和错误状态。
diff --git a/msglayer/docs/indexing.md b/msglayer/docs/indexing.md
new file mode 100644
index 0000000..c7cc04d
--- /dev/null
+++ b/msglayer/docs/indexing.md
@@ -0,0 +1,25 @@
+# MsgLayer 索引说明
+
+`MsgLayer` 把 canonical exported data 与查询时索引分开。
+
+## Canonical Source
+
+- root export JSON
+- identities
+- events
+
+## 首批查询索引
+
+- 跨 SMS text、voice transcript、voice summary 的 keyword search
+- participant/contact grouping
+- 按 event timestamp 排序的 timeline
+- 从 `same_thread` 重建 thread
+
+## 存储方向
+
+首个 backend 版本支持：
+
+- SQLite：用于 local-first deployment
+- PostgreSQL：用于 service-style deployment
+
+schema 已做基础规范化，以便未来增加 adapter 时不改变导出的 `MsgLayer` wire format。
diff --git a/msglayer/docs/mapping-android.md b/msglayer/docs/mapping-android.md
new file mode 100644
index 0000000..4686186
--- /dev/null
+++ b/msglayer/docs/mapping-android.md
@@ -0,0 +1,91 @@
+# Android -> MsgLayer v0.1 映射
+
+本文定义当前 Android backup models 到 `msglayer/v0.1` 的第一版稳定映射。
+
+## Root
+
+- `version` -> 固定为 `msglayer/v0.1`
+- `exported_at` -> RFC3339 UTC 格式的导出时间
+- `source.platform` -> `android`
+- `source.device_id` -> app layer 传入的 Android device identifier
+- `source.app_version` -> app layer 传入的 Android app version
+
+## Self Identity
+
+每次 export 都创建一个稳定的 self identity：
+
+- `id` -> `self/<device_id>`
+- `type` -> `device`
+- `display_name` -> 可用时使用 device info string
+- `labels` -> `["self"]`
+
+## Contact -> Identity
+
+Android `Contact` 映射为 MsgLayer `identity`：
+
+- `type` -> `person`
+- `phones` -> `phoneNumbers`
+- `emails` -> `emails`
+- `avatar` -> `photoData`
+- `meta.source` -> `contacts`
+
+稳定 identity IDs 优先由规范化手机号生成；没有手机号时，退回使用 contact ID/name fingerprints。
+
+## Contact -> contact_snapshot Event
+
+contacts 导出的每个 identity 也会生成一个 `contact_snapshot` event：
+
+- `direction` -> `system`
+- `participants` -> contact identity itself
+- `content.identity_id` -> identity ID
+- `content.snapshot` -> identity payload
+- `relations` -> `references_identity`
+
+## Message -> sms Event
+
+- `Message.id` -> event ID suffix
+- `Message.date` -> event timestamp
+- `Message.type` -> `direction`
+  - `1` => `inbound`
+  - `2` => `outbound`
+  - `3/4/5/6` => 为了 schema compatibility 导出为 `outbound`，同时在 `meta.raw_type` 保留原始 Android type
+  - fallback => `inbound`
+- `Message.address` -> participant identity resolution input
+- `Message.body` -> `content.text`
+- `Message.threadId` -> `relations.same_thread`
+- `Message.readState` -> `meta.read`
+- `Message.messageStatus` -> `meta.status`
+
+## CallLog -> call Event
+
+- `CallLog.id` -> event ID suffix
+- `CallLog.date` -> event timestamp
+- `CallLog.number` / `CallLog.contact` -> participant identity resolution input
+- `CallLog.type` -> `direction` 和 `content.call_type`
+- `CallLog.duration` -> `content.duration_sec`
+- `CallLog.contact` -> `meta.contact_name`
+
+export 中的 timestamp ordering 依赖 mapper：它必须先把所有 event timestamps 规范化为 UTC RFC3339，再排序。
+
+## Restore Boundary
+
+`MsgLayer` 现在是主要 export format。
+
+当前 restore compatibility 通过把 `MsgLayer` events 转换回现有 Android restore DTOs 来保持：
+
+- `sms` -> `SmsData`
+- `call` -> `CallLogData`
+- `identity/contact_snapshot` -> `ContactData`
+
+这样可以在 write path 迁移到新标准时，继续保持 restore 行为可用。
+
+## Round-Trip 中已知数据损失
+
+`MsgLayer -> legacy restore DTO` bridge 在 v0.1 中刻意优先兼容性，而不是完美保真。
+
+当前已知损失：
+
+- contact `groups`、`websites` 和 `note` 只保留在 identity metadata 中
+- avatar/photo data 不会恢复进 legacy contact DTO
+- legacy Android raw message/call types 保留为 metadata，而不是 first-class restore fields
+- 非数字 event IDs 在 restore bridge 中会退回为派生 numeric IDs
diff --git a/msglayer/docs/versioning.md b/msglayer/docs/versioning.md
new file mode 100644
index 0000000..c35dc0a
--- /dev/null
+++ b/msglayer/docs/versioning.md
@@ -0,0 +1,25 @@
+# MsgLayer 版本管理
+
+## 当前版本
+
+- `msglayer/v0.1`
+
+## 规则
+
+- 向后兼容的 additive fields 保持在同一 major/minor version line 内。
+- 破坏性结构变更必须使用新的 schema version。
+- Schema files、examples、Android mappers 和 Go types 必须一起演进。
+- `indexes` 是可选派生数据，绝不能成为 canonical source of truth。
+
+## 兼容性意图
+
+`v0.1` 是 Commory 的第一个稳定 interchange format。
+
+- Android export 切换到 `MsgLayer`
+- Go backend import/validation 目标为 `MsgLayer`
+- legacy backup JSON 只通过 bridge converters 保持 restore-compatible
+
+## v0.1 Relation Type 状态
+
+- 当前 code paths 已启用：`same_thread`、`references_identity`
+- 为未来 producers/consumers 预留：`reply_to`、`derived_from`
diff --git a/msglayer/examples/export.minimal.json b/msglayer/examples/export.minimal.json
new file mode 100644
index 0000000..5657fa2
--- /dev/null
+++ b/msglayer/examples/export.minimal.json
@@ -0,0 +1,27 @@
+{
+  "version": "msglayer/v0.1",
+  "exported_at": "2026-01-01T12:00:00Z",
+  "source": {
+    "platform": "android",
+    "device_id": "device_demo",
+    "app_version": "0.1.0"
+  },
+  "identities": [
+    {
+      "id": "self/device_demo",
+      "type": "device",
+      "display_name": "My Android Device",
+      "phones": [],
+      "emails": [],
+      "avatar": null,
+      "labels": [
+        "self"
+      ],
+      "meta": {
+        "source": "system"
+      }
+    }
+  ],
+  "events": [],
+  "indexes": {}
+}
diff --git a/msglayer/examples/export.sms-call.json b/msglayer/examples/export.sms-call.json
new file mode 100644
index 0000000..8ee25fb
--- /dev/null
+++ b/msglayer/examples/export.sms-call.json
@@ -0,0 +1,134 @@
+{
+  "version": "msglayer/v0.1",
+  "exported_at": "2026-01-01T12:00:00Z",
+  "source": {
+    "platform": "android",
+    "device_id": "device_001",
+    "app_version": "0.1.4"
+  },
+  "identities": [
+    {
+      "id": "self/device_001",
+      "type": "device",
+      "display_name": "Pixel Demo",
+      "phones": [],
+      "emails": [],
+      "avatar": null,
+      "labels": [
+        "self"
+      ],
+      "meta": {
+        "source": "system"
+      }
+    },
+    {
+      "id": "person_zhangsan",
+      "type": "person",
+      "display_name": "张三",
+      "phones": [
+        "+8613800000000"
+      ],
+      "emails": [],
+      "avatar": null,
+      "labels": [
+        "contact"
+      ],
+      "meta": {
+        "source": "contacts"
+      }
+    }
+  ],
+  "events": [
+    {
+      "id": "contact_snapshot_person_zhangsan",
+      "type": "contact_snapshot",
+      "timestamp": "2026-01-01T12:00:00Z",
+      "direction": "system",
+      "participants": [
+        "person_zhangsan"
+      ],
+      "content": {
+        "identity_id": "person_zhangsan",
+        "snapshot": {
+          "id": "person_zhangsan",
+          "type": "person",
+          "display_name": "张三",
+          "phones": [
+            "+8613800000000"
+          ],
+          "emails": [],
+          "avatar": null,
+          "labels": [
+            "contact"
+          ],
+          "meta": {
+            "source": "contacts"
+          }
+        }
+      },
+      "meta": {
+        "source": "contacts"
+      },
+      "relations": [
+        {
+          "type": "references_identity",
+          "target": "person_zhangsan"
+        }
+      ]
+    },
+    {
+      "id": "sms_101",
+      "type": "sms",
+      "timestamp": "2025-12-01T10:00:00Z",
+      "direction": "inbound",
+      "participants": [
+        "self/device_001",
+        "person_zhangsan"
+      ],
+      "content": {
+        "text": "你好，验证码是123456",
+        "attachments": []
+      },
+      "meta": {
+        "read": true,
+        "status": 0
+      },
+      "relations": [
+        {
+          "type": "same_thread",
+          "target": "thread_42"
+        }
+      ]
+    },
+    {
+      "id": "call_202",
+      "type": "call",
+      "timestamp": "2025-12-01T10:05:00Z",
+      "direction": "inbound",
+      "participants": [
+        "self/device_001",
+        "person_zhangsan"
+      ],
+      "content": {
+        "duration_sec": 120,
+        "call_type": "incoming",
+        "recording": null
+      },
+      "meta": {
+        "source": "call_log"
+      },
+      "relations": [
+        {
+          "type": "references_identity",
+          "target": "person_zhangsan"
+        }
+      ]
+    }
+  ],
+  "indexes": {
+    "timeline": [
+      "sms_101",
+      "call_202"
+    ]
+  }
+}
diff --git a/msglayer/examples/export.voice.json b/msglayer/examples/export.voice.json
new file mode 100644
index 0000000..3b37825
--- /dev/null
+++ b/msglayer/examples/export.voice.json
@@ -0,0 +1,67 @@
+{
+  "version": "msglayer/v0.1",
+  "exported_at": "2026-01-01T12:00:00Z",
+  "source": {
+    "platform": "android",
+    "device_id": "device_voice",
+    "app_version": "0.1.4"
+  },
+  "identities": [
+    {
+      "id": "self/device_voice",
+      "type": "device",
+      "display_name": "Voice Device",
+      "phones": [],
+      "emails": [],
+      "avatar": null,
+      "labels": [
+        "self"
+      ],
+      "meta": {
+        "source": "system"
+      }
+    },
+    {
+      "id": "person_lisi",
+      "type": "person",
+      "display_name": "李四",
+      "phones": [
+        "+8613900000000"
+      ],
+      "emails": [],
+      "avatar": null,
+      "labels": [
+        "contact"
+      ],
+      "meta": {
+        "source": "contacts"
+      }
+    }
+  ],
+  "events": [
+    {
+      "id": "voice_1",
+      "type": "voice",
+      "timestamp": "2025-12-02T08:30:00Z",
+      "direction": "outbound",
+      "participants": [
+        "self/device_voice",
+        "person_lisi"
+      ],
+      "content": {
+        "file": "file://voice/001.mp3",
+        "transcript": "我们明天见面讨论项目",
+        "summary": "约好明天讨论项目"
+      },
+      "meta": {
+        "source": "voice_recording"
+      },
+      "relations": [
+        {
+          "type": "same_thread",
+          "target": "thread_voice_1"
+        }
+      ]
+    }
+  ]
+}
diff --git a/msglayer/schema/v0.1/common.schema.json b/msglayer/schema/v0.1/common.schema.json
new file mode 100644
index 0000000..77255ec
--- /dev/null
+++ b/msglayer/schema/v0.1/common.schema.json
@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "common.schema.json",
+  "definitions": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "stringArray": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "meta": {
+      "type": "object",
+      "description": "Open-ended metadata bag for source-specific fields that are intentionally not standardized in v0.1.",
+      "additionalProperties": true
+    }
+  }
+}
diff --git a/msglayer/schema/v0.1/content.call.schema.json b/msglayer/schema/v0.1/content.call.schema.json
new file mode 100644
index 0000000..72e8aa1
--- /dev/null
+++ b/msglayer/schema/v0.1/content.call.schema.json
@@ -0,0 +1,34 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "content.call.schema.json",
+  "title": "MsgLayer Call Content",
+  "type": "object",
+  "required": [
+    "duration_sec",
+    "call_type"
+  ],
+  "properties": {
+    "duration_sec": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "call_type": {
+      "type": "string",
+      "enum": [
+        "incoming",
+        "outgoing",
+        "missed",
+        "rejected",
+        "voicemail",
+        "unknown"
+      ]
+    },
+    "recording": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/msglayer/schema/v0.1/content.contact_snapshot.schema.json b/msglayer/schema/v0.1/content.contact_snapshot.schema.json
new file mode 100644
index 0000000..0c04d27
--- /dev/null
+++ b/msglayer/schema/v0.1/content.contact_snapshot.schema.json
@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "content.contact_snapshot.schema.json",
+  "title": "MsgLayer Contact Snapshot Content",
+  "type": "object",
+  "required": [
+    "identity_id",
+    "snapshot"
+  ],
+  "properties": {
+    "identity_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "snapshot": {
+      "$ref": "identity.schema.json"
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/msglayer/schema/v0.1/content.sms.schema.json b/msglayer/schema/v0.1/content.sms.schema.json
new file mode 100644
index 0000000..2d3dce6
--- /dev/null
+++ b/msglayer/schema/v0.1/content.sms.schema.json
@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "content.sms.schema.json",
+  "title": "MsgLayer SMS Content",
+  "type": "object",
+  "required": [
+    "text",
+    "attachments"
+  ],
+  "properties": {
+    "text": {
+      "type": "string"
+    },
+    "attachments": {
+      "type": "array",
+      "description": "Attachment references should be URI strings when present.",
+      "items": {
+        "type": "string",
+        "format": "uri"
+      }
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/msglayer/schema/v0.1/content.voice.schema.json b/msglayer/schema/v0.1/content.voice.schema.json
new file mode 100644
index 0000000..d5efa14
--- /dev/null
+++ b/msglayer/schema/v0.1/content.voice.schema.json
@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "content.voice.schema.json",
+  "title": "MsgLayer Voice Content",
+  "type": "object",
+  "required": [
+    "file",
+    "transcript",
+    "summary"
+  ],
+  "properties": {
+    "file": {
+      "type": "string",
+      "format": "uri"
+    },
+    "transcript": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/msglayer/schema/v0.1/event.schema.json b/msglayer/schema/v0.1/event.schema.json
new file mode 100644
index 0000000..4ee22d5
--- /dev/null
+++ b/msglayer/schema/v0.1/event.schema.json
@@ -0,0 +1,151 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "event.schema.json",
+  "title": "MsgLayer Event",
+  "type": "object",
+  "required": [
+    "id",
+    "type",
+    "timestamp",
+    "direction",
+    "participants",
+    "content",
+    "meta",
+    "relations"
+  ],
+  "properties": {
+    "id": {
+      "$ref": "common.schema.json#/definitions/id"
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "sms",
+        "call",
+        "voice",
+        "contact_snapshot"
+      ]
+    },
+    "timestamp": {
+      "$ref": "common.schema.json#/definitions/timestamp"
+    },
+    "direction": {
+      "type": "string",
+      "enum": [
+        "inbound",
+        "outbound",
+        "missed",
+        "system"
+      ]
+    },
+    "participants": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "content": {
+      "type": "object"
+    },
+    "meta": {
+      "$ref": "common.schema.json#/definitions/meta"
+    },
+    "relations": {
+      "type": "array",
+      "items": {
+        "$ref": "relation.schema.json"
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "sms"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "direction": {
+            "enum": [
+              "inbound",
+              "outbound"
+            ]
+          },
+          "content": {
+            "$ref": "content.sms.schema.json"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "call"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "direction": {
+            "enum": [
+              "inbound",
+              "outbound",
+              "missed"
+            ]
+          },
+          "content": {
+            "$ref": "content.call.schema.json"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "voice"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "direction": {
+            "enum": [
+              "inbound",
+              "outbound"
+            ]
+          },
+          "content": {
+            "$ref": "content.voice.schema.json"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "contact_snapshot"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "direction": {
+            "const": "system"
+          },
+          "content": {
+            "$ref": "content.contact_snapshot.schema.json"
+          }
+        }
+      }
+    }
+  ],
+  "additionalProperties": false
+}
diff --git a/msglayer/schema/v0.1/identity.schema.json b/msglayer/schema/v0.1/identity.schema.json
new file mode 100644
index 0000000..6c2ca58
--- /dev/null
+++ b/msglayer/schema/v0.1/identity.schema.json
@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "identity.schema.json",
+  "title": "MsgLayer Identity",
+  "type": "object",
+  "required": [
+    "id",
+    "type",
+    "display_name",
+    "phones",
+    "emails",
+    "labels",
+    "meta"
+  ],
+  "properties": {
+    "id": {
+      "$ref": "common.schema.json#/definitions/id"
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "person",
+        "device",
+        "account"
+      ]
+    },
+    "display_name": {
+      "type": "string"
+    },
+    "phones": {
+      "$ref": "common.schema.json#/definitions/stringArray"
+    },
+    "emails": {
+      "$ref": "common.schema.json#/definitions/stringArray"
+    },
+    "avatar": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "format": "uri"
+    },
+    "labels": {
+      "$ref": "common.schema.json#/definitions/stringArray"
+    },
+    "meta": {
+      "$ref": "common.schema.json#/definitions/meta"
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/msglayer/schema/v0.1/relation.schema.json b/msglayer/schema/v0.1/relation.schema.json
new file mode 100644
index 0000000..1367837
--- /dev/null
+++ b/msglayer/schema/v0.1/relation.schema.json
@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation.schema.json",
+  "title": "MsgLayer Relation",
+  "type": "object",
+  "required": [
+    "type",
+    "target"
+  ],
+  "properties": {
+    "type": {
+      "type": "string",
+      "enum": [
+        "same_thread",
+        "reply_to",
+        "derived_from",
+        "references_identity"
+      ]
+    },
+    "target": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/msglayer/schema/v0.1/root.schema.json b/msglayer/schema/v0.1/root.schema.json
new file mode 100644
index 0000000..5a64799
--- /dev/null
+++ b/msglayer/schema/v0.1/root.schema.json
@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "root.schema.json",
+  "title": "MsgLayer Root Export",
+  "type": "object",
+  "required": [
+    "version",
+    "exported_at",
+    "source",
+    "identities",
+    "events"
+  ],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "msglayer/v0.1"
+    },
+    "exported_at": {
+      "$ref": "common.schema.json#/definitions/timestamp"
+    },
+    "source": {
+      "type": "object",
+      "required": [
+        "platform",
+        "device_id",
+        "app_version"
+      ],
+      "properties": {
+        "platform": {
+          "type": "string"
+        },
+        "device_id": {
+          "type": "string"
+        },
+        "app_version": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "identities": {
+      "type": "array",
+      "items": {
+        "$ref": "identity.schema.json"
+      }
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "$ref": "event.schema.json"
+      }
+    },
+    "indexes": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
diff --git a/previewer/README.en.md b/previewer/README.en.md
index aa3095b..ae7be84 100644
--- a/previewer/README.en.md
+++ b/previewer/README.en.md
@@ -2,6 +2,8 @@
 
 A clean and elegant SMS backup viewer for SMS Backup & Restore exported files
 
+> Deprecated: the maintained archive experience now lives in the main `web` application. This standalone previewer remains only as historical reference.
+
 ## 💝 Special Thanks
 
 This project wouldn't be possible without [SMS Backup & Restore](https://play.google.com/store/apps/details?id=com.riteshsahu.SMSBackupRestore). This excellent Android app inspired the creation of this project, aiming to provide users with a better SMS backup browsing experience.
@@ -193,4 +195,4 @@ To ensure smooth handling of large XML files:
 
 ## License
 
-This project is licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0)](https://creativecommons.org/licenses/by-nc-sa/4.0/).
\ No newline at end of file
+This project is licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0)](https://creativecommons.org/licenses/by-nc-sa/4.0/).
diff --git a/previewer/README.md b/previewer/README.md
index eff8bb2..29ac289 100644
--- a/previewer/README.md
+++ b/previewer/README.md
@@ -3,6 +3,8 @@
 [English](README.en.md) | 简体中文
 
 > 一个简洁优雅的短信备份预览工具，基于 SMS Backup & Restore 应用导出的备份文件
+>
+> 已弃用：当前维护中的归档体验已迁移到主 `web` 应用，这个独立预览器仅保留作历史参考。
 
 ## 💝 特别感谢
 
diff --git a/previewer/package.json b/previewer/package.json
index 60d7dae..c903bc2 100644
--- a/previewer/package.json
+++ b/previewer/package.json
@@ -1,5 +1,5 @@
 {
-  "name": "sms-previewer",
+  "name": "commory-legacy-previewer",
   "private": true,
   "version": "0.0.0",
   "type": "module",
diff --git a/references/GitHubDaily b/references/GitHubDaily
new file mode 160000
index 0000000..5108d02
--- /dev/null
+++ b/references/GitHubDaily
@@ -0,0 +1 @@
+Subproject commit 5108d021a173c2e53684b39b5972e6c2b2750c71
diff --git a/references/README.md b/references/README.md
new file mode 100644
index 0000000..1cb547a
--- /dev/null
+++ b/references/README.md
@@ -0,0 +1,31 @@
+# Commory Reference Catalog
+
+This directory is for architecture study only. Reference projects are not implementation dependencies, and their code, text, schemas, field names, or proprietary structures must not be copied into Commory.
+
+## Policy
+
+- Prefer permissive references: MIT, Apache-2.0, BSD.
+- Treat AGPL, GPL, LGPL, proprietary, and unknown-license projects as read-only architecture material.
+- Record why every reference exists before using it in design work.
+- Convert lessons into Commory-owned ADRs, interfaces, and tests before writing product code.
+- Do not import from `references/` in production or test code.
+
+## Catalog
+
+| Path | Source | License policy | Learn from | Do not borrow |
+| --- | --- | --- | --- | --- |
+| `references/ClaudeCodeSource` | Local ignored source snapshot | Restricted / clean-room only | Agent product architecture, task/session UX, tool permissions, command surfaces, compact/context concepts, bridge and resume patterns | Source code, strings, field names, schemas, proprietary structures |
+| `references/GitHubDaily` | `https://github.com/GitHubDaily/GitHubDaily.git` | Unknown / discovery index only | Finding Go/self-hosted/database/auth/agent/concurrency projects for later review | Code or article text without separate license validation |
+| `references/new-api` | `https://github.com/QuantumNous/new-api.git` | AGPL read-only architecture reference | Multi-database awareness, setup UX, user/admin/root auth layering, operational warnings | Implementation, handlers, model names, field names, SQL, UI text |
+| `references/hermes-agent` | `https://github.com/NousResearch/hermes-agent.git` | MIT permissive reference | Provider registry, plugin lifecycle, config validation, diagnostics, long-running agent workflows | Direct Python implementation or project-specific prompts |
+| `references/openclaw` | `https://github.com/openclaw/openclaw.git` | MIT permissive reference | Plugin-agnostic core boundaries, extension governance, protocol/versioning habits | Product-specific plugin contracts or wording |
+| `references/art-design-pro` | `https://github.com/Daymychen/art-design-pro.git` | MIT permissive reference | Admin UI layout, theme organization, dashboard ergonomics | Branding and app-specific UI copy |
+| `references/memos` | `https://github.com/usememos/memos.git` | MIT permissive reference | Go self-hosted product structure, SQLite-first operation, lightweight domain modeling | Exact data models, API shapes, UI strings |
+| `references/gitea` | `https://github.com/go-gitea/gitea.git` | MIT permissive reference | Mature Go self-hosted governance, multi-database operations, permissions, upgrade discipline | Git service domain implementation, templates, naming |
+| `references/pocketbase` | `https://github.com/pocketbase/pocketbase.git` | MIT permissive reference | Single-binary SQLite-first architecture, auth, hooks, realtime ergonomics | Framework internals or public API names as Commory APIs |
+| `references/sqlc` | `https://github.com/sqlc-dev/sqlc.git` | MIT permissive reference | Type-safe SQL generation, query organization, migration-adjacent workflow | Tool internals |
+
+## GitHubDaily Mining
+
+Use `scripts/mine-githubdaily-references.sh` to extract candidate repositories from the local GitHubDaily index. A candidate can become a submodule only after its language, license, and Commory learning value are recorded here.
+
diff --git a/references/art-design-pro b/references/art-design-pro
new file mode 160000
index 0000000..6b6d781
--- /dev/null
+++ b/references/art-design-pro
@@ -0,0 +1 @@
+Subproject commit 6b6d781a63eb51782841ac9c29c2bb42a23911f2
diff --git a/references/gitea b/references/gitea
new file mode 160000
index 0000000..cf0f25b
--- /dev/null
+++ b/references/gitea
@@ -0,0 +1 @@
+Subproject commit cf0f25b79840100336d729ccd5dc6c7580f90c71
diff --git a/references/hermes-agent b/references/hermes-agent
new file mode 160000
index 0000000..7727607
--- /dev/null
+++ b/references/hermes-agent
@@ -0,0 +1 @@
+Subproject commit 77276070f5a1302908456734f2a5bdfe790260de
diff --git a/references/memos b/references/memos
new file mode 160000
index 0000000..858f741
--- /dev/null
+++ b/references/memos
@@ -0,0 +1 @@
+Subproject commit 858f7419b43b36ed76234762d8327ddbaacf1337
diff --git a/references/new-api b/references/new-api
new file mode 160000
index 0000000..18282e6
--- /dev/null
+++ b/references/new-api
@@ -0,0 +1 @@
+Subproject commit 18282e610ddf3c8c39732fe84e50ded2cf6dcc7f
diff --git a/references/openclaw b/references/openclaw
new file mode 160000
index 0000000..778ad09
--- /dev/null
+++ b/references/openclaw
@@ -0,0 +1 @@
+Subproject commit 778ad09ff2456d52f7b5a761ee99f2330498179b
diff --git a/references/pocketbase b/references/pocketbase
new file mode 160000
index 0000000..a286d28
--- /dev/null
+++ b/references/pocketbase
@@ -0,0 +1 @@
+Subproject commit a286d28bf9ee76d5f7900458f713dee8989ed35d
diff --git a/references/sqlc b/references/sqlc
new file mode 160000
index 0000000..a3b0cfd
--- /dev/null
+++ b/references/sqlc
@@ -0,0 +1 @@
+Subproject commit a3b0cfdbc1d86da8248ad3366301cf5544fb63b9
diff --git a/scripts/check-android-i18n.sh b/scripts/check-android-i18n.sh
new file mode 100644
index 0000000..644d1ec
--- /dev/null
+++ b/scripts/check-android-i18n.sh
@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+base="android/app/src/main/res/values/strings.xml"
+en="android/app/src/main/res/values-en/strings.xml"
+zh="android/app/src/main/res/values-zh-rCN/strings.xml"
+
+extract_keys() {
+  sed -n 's/.*<string name="\([^"]*\)".*/\1/p' "$1" | sort -u
+}
+
+tmp_dir="$(mktemp -d)"
+trap 'rm -rf "$tmp_dir"' EXIT
+
+extract_keys "$base" > "$tmp_dir/base"
+extract_keys "$en" > "$tmp_dir/en"
+extract_keys "$zh" > "$tmp_dir/zh"
+
+missing_en="$(comm -23 "$tmp_dir/base" "$tmp_dir/en" || true)"
+missing_zh="$(comm -23 "$tmp_dir/base" "$tmp_dir/zh" || true)"
+
+if [[ -n "$missing_en" || -n "$missing_zh" ]]; then
+  if [[ -n "$missing_en" ]]; then
+    echo "Missing English string keys:"
+    echo "$missing_en"
+  fi
+  if [[ -n "$missing_zh" ]]; then
+    echo "Missing Simplified Chinese string keys:"
+    echo "$missing_zh"
+  fi
+  exit 1
+fi
+
+echo "Android i18n key check passed."
diff --git a/scripts/check-reference-governance.sh b/scripts/check-reference-governance.sh
new file mode 100755
index 0000000..8ab7820
--- /dev/null
+++ b/scripts/check-reference-governance.sh
@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+catalog="references/README.md"
+if [[ ! -f "$catalog" ]]; then
+  echo "Missing $catalog"
+  exit 1
+fi
+
+expected_paths=(
+  "references/art-design-pro"
+  "references/new-api"
+  "references/hermes-agent"
+  "references/openclaw"
+  "references/GitHubDaily"
+  "references/memos"
+  "references/gitea"
+  "references/pocketbase"
+  "references/sqlc"
+)
+
+for path in "${expected_paths[@]}"; do
+  if ! git config --file .gitmodules --get-regexp '^submodule\..*\.path$' | awk '{print $2}' | grep -Fxq "$path"; then
+    echo "Missing reference submodule path in .gitmodules: $path"
+    exit 1
+  fi
+  if ! grep -Fq "\`$path\`" "$catalog"; then
+    echo "Missing reference catalog entry: $path"
+    exit 1
+  fi
+done
+
+restricted_patterns=(
+  "references/ClaudeCodeSource.*clean-room"
+  "references/GitHubDaily.*discovery index"
+  "references/new-api.*AGPL read-only"
+)
+
+for pattern in "${restricted_patterns[@]}"; do
+  if ! grep -Eq "$pattern" "$catalog"; then
+    echo "Missing restricted reference policy matching: $pattern"
+    exit 1
+  fi
+done
+
+if grep -RIn --exclude-dir='.git' 'references/ClaudeCodeSource' backend android web .github 2>/dev/null; then
+  echo "ClaudeCodeSource must only be referenced in governance documentation, not product code."
+  exit 1
+fi
+
+for path in "${expected_paths[@]}"; do
+  if [[ -d "$path" && -e "$path/.git" || -f "$path/.git" ]]; then
+    license_file="$(find "$path" -maxdepth 1 \( -iname 'LICENSE*' -o -iname 'COPYING*' \) -type f | head -n 1 || true)"
+    case "$path" in
+      references/new-api)
+        if [[ -n "$license_file" ]] && ! grep -qi 'affero general public license' "$license_file"; then
+          echo "Expected AGPL license for $path"
+          exit 1
+        fi
+        ;;
+      references/GitHubDaily)
+        ;;
+      *)
+        if [[ -z "$license_file" ]]; then
+          echo "Missing license file for initialized reference: $path"
+          exit 1
+        fi
+        if ! grep -Eqi 'MIT License|Apache License|BSD [0-9]-Clause|Permission is hereby granted' "$license_file"; then
+          echo "Reference is not recognized as permissive: $path ($license_file)"
+          exit 1
+        fi
+        ;;
+    esac
+  fi
+done
+
+echo "Reference governance check passed."
diff --git a/scripts/check-repo-hygiene.sh b/scripts/check-repo-hygiene.sh
new file mode 100644
index 0000000..ad6a74c
--- /dev/null
+++ b/scripts/check-repo-hygiene.sh
@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+web_baseline_manifest="web/reference-baseline-paths.txt"
+
+is_web_baseline_path() {
+  local path="$1"
+  [[ -f "$web_baseline_manifest" ]] || return 1
+
+  while IFS= read -r prefix; do
+    [[ -n "$prefix" ]] || continue
+    [[ "$prefix" =~ ^# ]] && continue
+    if [[ "$path" == "$prefix"* ]]; then
+      return 0
+    fi
+  done < "$web_baseline_manifest"
+
+  return 1
+}
+
+is_handwritten_source() {
+  local path="$1"
+  case "$path" in
+    backend/*|android/*|web/*)
+      ;;
+    *)
+      return 1
+      ;;
+  esac
+
+  case "$path" in
+    *.go|*.kt|*.java|*.ts|*.tsx|*.vue)
+      ;;
+    *)
+      return 1
+      ;;
+  esac
+
+  case "$path" in
+    */build/*|*/.gradle/*|*/node_modules/*|*/dist/*|*/coverage/*|*/sqlc/gen/*|*/schema/*|*/examples/*|*/fixture/*|*/fixtures/*)
+      return 1
+      ;;
+  esac
+
+  return 0
+}
+
+resolve_compare_base() {
+  if [[ -n "${GITHUB_BASE_REF:-}" ]] && git show-ref --verify --quiet "refs/remotes/origin/${GITHUB_BASE_REF}"; then
+    echo "refs/remotes/origin/${GITHUB_BASE_REF}"
+    return 0
+  fi
+
+  local origin_head
+  origin_head="$(git symbolic-ref -q --short refs/remotes/origin/HEAD 2>/dev/null || true)"
+  if [[ -n "$origin_head" ]]; then
+    echo "$origin_head"
+    return 0
+  fi
+
+  if git show-ref --verify --quiet refs/heads/main; then
+    echo "main"
+    return 0
+  fi
+
+  return 1
+}
+
+tracked_generated_candidates="$(
+  git ls-files \
+    '.DS_Store' \
+    '**/.DS_Store' \
+    'android/**/build/**' \
+    'android/.gradle/**' \
+    'android/app/debug/**' \
+    'backend/data/**' \
+    'web/node_modules/**' \
+    '*.apk' \
+    '*.aab' \
+    '*.log' \
+    '**/AI_EDIT_LOG.md'
+)"
+
+tracked_generated=""
+while IFS= read -r path; do
+  if [[ -n "$path" && -e "$path" ]]; then
+    tracked_generated+="$path"$'\n'
+  fi
+done <<< "$tracked_generated_candidates"
+
+if [[ -n "$tracked_generated" ]]; then
+  echo "Tracked generated or local-only files were found:"
+  echo "$tracked_generated"
+  exit 1
+fi
+
+invalid_skill_docs="$(
+  find .agents/skills -type f \( \
+    -name 'README.md' -o \
+    -name 'CHANGELOG.md' -o \
+    -name 'AGENTS.md' -o \
+    -name 'INSTALLATION_GUIDE.md' -o \
+    -name 'QUICK_REFERENCE.md' \
+  \) -print 2>/dev/null || true
+)"
+
+if [[ -n "$invalid_skill_docs" ]]; then
+  echo "Skills contain non-standard documentation files:"
+  echo "$invalid_skill_docs"
+  exit 1
+fi
+
+tmp_candidates="$(mktemp)"
+trap 'rm -f "$tmp_candidates"' EXIT
+
+compare_base="$(resolve_compare_base || true)"
+if [[ -n "$compare_base" ]]; then
+  merge_base="$(git merge-base HEAD "$compare_base" 2>/dev/null || true)"
+  if [[ -n "$merge_base" ]]; then
+    git diff --name-only --diff-filter=ACMR "$merge_base"...HEAD >> "$tmp_candidates"
+  fi
+fi
+
+git diff --name-only --diff-filter=ACMR >> "$tmp_candidates"
+git diff --cached --name-only --diff-filter=ACMR >> "$tmp_candidates"
+git ls-files --others --exclude-standard >> "$tmp_candidates"
+
+oversized_sources=""
+baseline_oversized_sources=""
+while IFS= read -r path; do
+  [[ -n "$path" ]] || continue
+  is_handwritten_source "$path" || continue
+  [[ -f "$path" ]] || continue
+  lines="$(wc -l < "$path")"
+  if (( lines > 500 )); then
+    if is_web_baseline_path "$path"; then
+      baseline_oversized_sources+="${lines} ${path}"$'\n'
+    else
+      oversized_sources+="${lines} ${path}"$'\n'
+    fi
+  fi
+done < <(sort -u "$tmp_candidates")
+
+if [[ -n "$oversized_sources" ]]; then
+  echo "Changed Commory-owned hand-written source files exceeded the 500-line hard limit:"
+  echo "$oversized_sources" | sort -nr
+  exit 1
+fi
+
+if [[ -n "$baseline_oversized_sources" ]]; then
+  echo "Reference-derived web baseline files exceeded 500 lines but were allowed by manifest ($web_baseline_manifest):"
+  echo "$baseline_oversized_sources" | sort -nr
+fi
+
+echo "Repo hygiene check passed."
diff --git a/scripts/dev.sh b/scripts/dev.sh
new file mode 100755
index 0000000..5b05abd
--- /dev/null
+++ b/scripts/dev.sh
@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Commory 开发模式一键启动
+# 同时运行 Go backend (:3000) 和 Web dev server (:3006)
+# 用法: bash scripts/dev.sh
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+
+CYAN='\033[36m'
+YELLOW='\033[33m'
+RED='\033[31m'
+RESET='\033[0m'
+
+cleanup() {
+  echo -e "\n${RED}[dev]${RESET} 正在停止所有服务..."
+  kill 0 2>/dev/null || true
+  wait 2>/dev/null || true
+  echo -e "${RED}[dev]${RESET} 已停止。"
+}
+
+trap cleanup INT TERM
+
+echo -e "${CYAN}[dev]${RESET} 启动 Go backend (端口 :3000)..."
+(cd "$REPO_ROOT/backend" && go run ./cmd/commory serve) 2>&1 \
+  | sed -u "s/.*/${CYAN}[backend]${RESET} &/" &
+
+echo -e "${YELLOW}[dev]${RESET} 启动 Web dev server (端口 :3006)..."
+(cd "$REPO_ROOT/web" && pnpm dev) 2>&1 \
+  | sed -u "s/.*/${YELLOW}[web]${RESET}     &/" &
+
+echo -e "${RED}[dev]${RESET} 按 Ctrl+C 停止所有服务。"
+wait
diff --git a/scripts/mine-githubdaily-references.sh b/scripts/mine-githubdaily-references.sh
new file mode 100755
index 0000000..b1e9eea
--- /dev/null
+++ b/scripts/mine-githubdaily-references.sh
@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+limit="${1:-80}"
+source_dir="references/GitHubDaily"
+
+if [[ ! -d "$source_dir" ]]; then
+  echo "Missing $source_dir. Initialize the GitHubDaily submodule first." >&2
+  exit 1
+fi
+
+tmp="$(mktemp)"
+trap 'rm -f "$tmp"' EXIT
+
+rg -n -i 'github\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+|Go|Golang|SQLite|PostgreSQL|MySQL|self-host|自托管|高并发|并发|agent|workflow|queue|observability|plugin|database|auth' \
+  "$source_dir" \
+  -g '*.md' \
+  > "$tmp" || true
+
+echo -e "repo\tsignals\tsource"
+
+awk -v limit="$limit" -F: '
+  {
+    line=$0
+    while (match(line, /github\.com\/[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+/)) {
+      repo=substr(line, RSTART, RLENGTH)
+      gsub(/[),，。；;]+$/, "", repo)
+      signals=""
+      lower=tolower($0)
+      if (lower ~ /go|golang/) signals=signals "go,"
+      if (lower ~ /sqlite|postgresql|mysql|database|数据库/) signals=signals "database,"
+      if (lower ~ /auth|权限|认证/) signals=signals "auth,"
+      if (lower ~ /agent|workflow|plugin|observability|queue/) signals=signals "agent-workflow,"
+      if (lower ~ /self-host|自托管/) signals=signals "self-hosted,"
+      if (lower ~ /高并发|并发|concurrency/) signals=signals "concurrency,"
+      if (signals == "") signals="needs-review,"
+      sub(/,$/, "", signals)
+      print repo "\t" signals "\t" $1 ":" $2
+      line=substr(line, RSTART + RLENGTH)
+    }
+  }
+' "$tmp" | sort -u | awk -v limit="$limit" 'NR <= limit { print }'
+
+echo
+echo "Review license and language before adding any candidate to references/README.md or .gitmodules." >&2
diff --git a/scripts/report-loc-complexity.sh b/scripts/report-loc-complexity.sh
new file mode 100644
index 0000000..da37df2
--- /dev/null
+++ b/scripts/report-loc-complexity.sh
@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+web_baseline_manifest="web/reference-baseline-paths.txt"
+
+is_web_baseline_path() {
+  local path="$1"
+  [[ -f "$web_baseline_manifest" ]] || return 1
+
+  while IFS= read -r prefix; do
+    [[ -n "$prefix" ]] || continue
+    [[ "$prefix" =~ ^# ]] && continue
+    if [[ "$path" == "$prefix"* ]]; then
+      return 0
+    fi
+  done < "$web_baseline_manifest"
+
+  return 1
+}
+
+tmp_handwritten="$(mktemp)"
+tmp_generated="$(mktemp)"
+tmp_commory_owned="$(mktemp)"
+tmp_web_baseline="$(mktemp)"
+trap 'rm -f "$tmp_handwritten" "$tmp_generated" "$tmp_commory_owned" "$tmp_web_baseline"' EXIT
+
+find backend android web -type f \( \
+  -name '*.go' -o \
+  -name '*.kt' -o \
+  -name '*.java' -o \
+  -name '*.ts' -o \
+  -name '*.tsx' -o \
+  -name '*.vue' \
+\) \
+  -not -path '*/build/*' \
+  -not -path '*/.gradle/*' \
+  -not -path '*/node_modules/*' \
+  -not -path '*/dist/*' \
+  -not -path '*/coverage/*' \
+  -not -path '*/sqlc/gen/*' \
+  -not -path '*/schema/*' \
+  -not -path '*/examples/*' \
+  -not -path '*/fixture/*' \
+  -not -path '*/fixtures/*' \
+  -print0 |
+  xargs -0 wc -l |
+  awk '$2 != "total"' |
+  sort -nr > "$tmp_handwritten"
+
+find android backend web msglayer -type f \( \
+  -name '*.json' -o \
+  -name '*.xml' -o \
+  -name '*.sql' \
+\) \
+  -not -path '*/build/*' \
+  -not -path '*/.gradle/*' \
+  -not -path '*/node_modules/*' \
+  -not -path '*/dist/*' \
+  -not -path '*/coverage/*' \
+  -print0 |
+  xargs -0 wc -l |
+  awk '$2 != "total"' |
+  sort -nr > "$tmp_generated"
+
+echo "Largest hand-written source files by line count:"
+head -30 "$tmp_handwritten"
+
+while read -r lines path; do
+  [[ -n "$lines" && -n "$path" ]] || continue
+  if is_web_baseline_path "$path"; then
+    echo "$lines $path" >> "$tmp_web_baseline"
+  else
+    echo "$lines $path" >> "$tmp_commory_owned"
+  fi
+done < "$tmp_handwritten"
+
+echo
+echo "Commory-owned hand-written source warning threshold: 350 lines. Hard limit: 500 lines."
+awk '$1 > 350 { print }' "$tmp_commory_owned" || true
+
+echo
+echo "Reference-derived web baseline over 350 lines (tracked via $web_baseline_manifest):"
+awk '$1 > 350 { print }' "$tmp_web_baseline" || true
+
+echo
+echo "Generated/schema/resource review threshold: 1000 lines."
+awk '$1 > 1000 { print }' "$tmp_generated" || true
diff --git a/scripts/sync-agent-skills.sh b/scripts/sync-agent-skills.sh
new file mode 100755
index 0000000..167a4be
--- /dev/null
+++ b/scripts/sync-agent-skills.sh
@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+source_dir="$repo_root/.agents/skills"
+target_dir="$repo_root/.claude/skills"
+mode="${1:-sync}"
+
+if [[ ! -d "$source_dir" ]]; then
+  echo "Missing source skills directory: $source_dir" >&2
+  exit 1
+fi
+
+invalid_files="$(
+  find "$source_dir" -type f \( \
+    -name 'README.md' -o \
+    -name 'CHANGELOG.md' -o \
+    -name 'AGENTS.md' -o \
+    -name 'INSTALLATION_GUIDE.md' -o \
+    -name 'QUICK_REFERENCE.md' \
+  \) -print
+)"
+
+if [[ -n "$invalid_files" ]]; then
+  echo "Skills contain non-standard documentation files:"
+  echo "$invalid_files"
+  exit 1
+fi
+
+missing_skill_md="$(
+  find "$source_dir" -mindepth 1 -maxdepth 1 -type d -print | while IFS= read -r skill_dir; do
+    [[ -f "$skill_dir/SKILL.md" ]] || echo "$skill_dir"
+  done
+)"
+
+if [[ -n "$missing_skill_md" ]]; then
+  echo "Skills missing SKILL.md:"
+  echo "$missing_skill_md"
+  exit 1
+fi
+
+tmp_dir="$(mktemp -d)"
+trap 'rm -rf "$tmp_dir"' EXIT
+
+mkdir -p "$target_dir"
+rsync -a --delete \
+  --exclude '.DS_Store' \
+  --exclude 'node_modules/' \
+  --exclude '.git/' \
+  --exclude 'build/' \
+  --exclude 'dist/' \
+  "$source_dir/" "$tmp_dir/skills/"
+
+if [[ "$mode" == "--check" ]]; then
+  if ! diff -qr "$tmp_dir/skills" "$target_dir" >/tmp/commory-skills-diff.txt; then
+    echo ".claude/skills is out of sync with .agents/skills."
+    cat /tmp/commory-skills-diff.txt
+    exit 1
+  fi
+  echo "Agent skills mirror is in sync."
+  exit 0
+fi
+
+rsync -a --delete "$tmp_dir/skills/" "$target_dir/"
+echo "Synced .agents/skills to .claude/skills."
diff --git a/skills-lock.json b/skills-lock.json
new file mode 100644
index 0000000..d9c16b6
--- /dev/null
+++ b/skills-lock.json
@@ -0,0 +1,89 @@
+{
+  "version": 1,
+  "skills": {
+    "caveman": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/caveman/SKILL.md",
+      "computedHash": "934433479903febc585bf6deb5f0cebc63137e3f86b7babe0aab1ecb94d6d7a4"
+    },
+    "diagnose": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/diagnose/SKILL.md",
+      "computedHash": "15939a26f86edec2d4862042b8564e5a062cb81d04e047a0cea6305c8830b5f5"
+    },
+    "grill-me": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/grill-me/SKILL.md",
+      "computedHash": "784f0dbb7403b0f00324bce9a112f715342777a0daee7bbb7385f9c6f0a170ea"
+    },
+    "grill-with-docs": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/grill-with-docs/SKILL.md",
+      "computedHash": "1adf321072f53cce3dcaf5357d91b8230d4aa647bb8a51756745337a6ee567b8"
+    },
+    "handoff": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/handoff/SKILL.md",
+      "computedHash": "d543685cbfb0c64b7bc51a8dc3465975528da9b64f987f863765973b2f3867ab"
+    },
+    "improve-codebase-architecture": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md",
+      "computedHash": "c77b86b4332919499608f9af1880074e1fec65a59b95c70c27a9f39cd137865e"
+    },
+    "prototype": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/prototype/SKILL.md",
+      "computedHash": "e4d0c8f8cb3fc096ee99405a15491da466545cf4a3694bee5a0c9db2fa621a43"
+    },
+    "setup-matt-pocock-skills": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/setup-matt-pocock-skills/SKILL.md",
+      "computedHash": "0164a8b1ef998abca426056c6ed8a7716a9d4692fc6daa5378f68381a6dafd24"
+    },
+    "tdd": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/tdd/SKILL.md",
+      "computedHash": "15a7b5e36383ebadb2dec5e586679e55e9663d292da418926b8da6fc0ef27d84"
+    },
+    "to-issues": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/to-issues/SKILL.md",
+      "computedHash": "47f648f3414848ccfc62cb41d2828b7e575fb5e7cbd6c4bdf630c063b5dc5e82"
+    },
+    "to-prd": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/to-prd/SKILL.md",
+      "computedHash": "6d741474efd4bc3db55fabc2722ed78ca9c374cabcb6212936d79d4fd4a30fcb"
+    },
+    "triage": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/triage/SKILL.md",
+      "computedHash": "2b6efb6da12d92551772fcc04acf331f4e0e6f7bd9d4cb23ce0b301e0b128feb"
+    },
+    "write-a-skill": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/write-a-skill/SKILL.md",
+      "computedHash": "b44d8aab2ead83c716e01af4c9a24ccc4575ce70ad58ec4f1749fb88c9cc82ba"
+    },
+    "zoom-out": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/zoom-out/SKILL.md",
+      "computedHash": "8357aeaece3b709c442eab67e64b86844e05e2f1ea95b109565eba50b6def36e"
+    }
+  }
+}
diff --git a/web/.env.production b/web/.env.production
new file mode 100755
index 0000000..2ecb7be
--- /dev/null
+++ b/web/.env.production
@@ -0,0 +1,10 @@
+# 【生产】环境变量
+
+# 应用部署基础路径（如部署在子目录 /admin，则设置为 /admin/）
+VITE_BASE_URL = /
+
+# API 地址前缀。生产镜像由 Go backend 同源提供 Web 与 /api，避免 CORS。
+VITE_API_URL = /
+
+# Delete console
+VITE_DROP_CONSOLE = true
diff --git a/web/.prettierrc b/web/.prettierrc
new file mode 100644
index 0000000..f3d6ad5
--- /dev/null
+++ b/web/.prettierrc
@@ -0,0 +1,20 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": false,
+  "vueIndentScriptAndStyle": true,
+  "singleQuote": true,
+  "quoteProps": "as-needed",
+  "bracketSpacing": true,
+  "trailingComma": "none",
+  "bracketSameLine": false,
+  "jsxSingleQuote": false,
+  "arrowParens": "always",
+  "insertPragma": false,
+  "requirePragma": false,
+  "proseWrap": "never",
+  "htmlWhitespaceSensitivity": "strict",
+  "endOfLine": "auto",
+  "rangeStart": 0
+}
diff --git a/web/.stylelintignore b/web/.stylelintignore
new file mode 100644
index 0000000..476ea45
--- /dev/null
+++ b/web/.stylelintignore
@@ -0,0 +1,9 @@
+dist
+node_modules
+public
+.husky
+.vscode
+
+src/components/Layout/MenuLeft/index.vue
+src/assets
+stats.html
\ No newline at end of file
diff --git a/web/.stylelintrc.cjs b/web/.stylelintrc.cjs
new file mode 100644
index 0000000..9dbea0b
--- /dev/null
+++ b/web/.stylelintrc.cjs
@@ -0,0 +1,82 @@
+module.exports = {
+  // 继承推荐规范配置
+  extends: [
+    'stylelint-config-standard',
+    'stylelint-config-recommended-scss',
+    'stylelint-config-recommended-vue/scss',
+    'stylelint-config-html/vue',
+    'stylelint-config-recess-order'
+  ],
+  // 指定不同文件对应的解析器
+  overrides: [
+    {
+      files: ['**/*.{vue,html}'],
+      customSyntax: 'postcss-html'
+    },
+    {
+      files: ['**/*.{css,scss}'],
+      customSyntax: 'postcss-scss'
+    }
+  ],
+  // 自定义规则
+  rules: {
+    'import-notation': 'string', // 指定导入CSS文件的方式("string"|"url")
+    'selector-class-pattern': null, // 选择器类名命名规则
+    'custom-property-pattern': null, // 自定义属性命名规则
+    'keyframes-name-pattern': null, // 动画帧节点样式命名规则
+    'no-descending-specificity': null, // 允许无降序特异性
+    'no-empty-source': null, // 允许空样式
+    'property-no-vendor-prefix': null, // 允许属性前缀
+    // 允许 global 、export 、deep伪类
+    'selector-pseudo-class-no-unknown': [
+      true,
+      {
+        ignorePseudoClasses: ['global', 'export', 'deep']
+      }
+    ],
+    // 允许未知属性
+    'property-no-unknown': [
+      true,
+      {
+        ignoreProperties: []
+      }
+    ],
+    // 允许未知规则
+    'at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: [
+          'apply',
+          'use',
+          'mixin',
+          'include',
+          'extend',
+          'each',
+          'if',
+          'else',
+          'for',
+          'while',
+          'reference'
+        ]
+      }
+    ],
+    'scss/at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: [
+          'apply',
+          'use',
+          'mixin',
+          'include',
+          'extend',
+          'each',
+          'if',
+          'else',
+          'for',
+          'while',
+          'reference'
+        ]
+      }
+    ]
+  }
+}
diff --git a/web/LICENSE b/web/LICENSE
new file mode 100755
index 0000000..cf36c79
--- /dev/null
+++ b/web/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SuperManTT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/web/commitlint.config.cjs b/web/commitlint.config.cjs
new file mode 100644
index 0000000..d2ef1bd
--- /dev/null
+++ b/web/commitlint.config.cjs
@@ -0,0 +1,97 @@
+/**
+ * commitlint 配置文件
+ * 文档
+ * https://commitlint.js.org/#/reference-rules
+ * https://cz-git.qbb.sh/zh/guide/
+ */
+
+module.exports = {
+  // 继承的规则
+  extends: ['@commitlint/config-conventional'],
+  // 自定义规则
+  rules: {
+    // 提交类型枚举，git提交type必须是以下类型
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat', // 新增功能
+        'fix', // 修复缺陷
+        'docs', // 文档变更
+        'style', // 代码格式（不影响功能，例如空格、分号等格式修正）
+        'refactor', // 代码重构（不包括 bug 修复、功能新增）
+        'perf', // 性能优化
+        'test', // 添加疏漏测试或已有测试改动
+        'build', // 构建流程、外部依赖变更（如升级 npm 包、修改 webpack 配置等）
+        'ci', // 修改 CI 配置、脚本
+        'revert', // 回滚 commit
+        'chore', // 对构建过程或辅助工具和库的更改（不影响源文件、测试用例）
+        'wip' // 对构建过程或辅助工具和库的更改（不影响源文件、测试用例）
+      ]
+    ],
+    'subject-case': [0] // subject大小写不做校验
+  },
+
+  prompt: {
+    messages: {
+      type: '选择你要提交的类型 :',
+      scope: '选择一个提交范围（可选）:',
+      customScope: '请输入自定义的提交范围 :',
+      subject: '填写简短精炼的变更描述 :\n',
+      body: '填写更加详细的变更描述（可选）。使用 "|" 换行 :\n',
+      breaking: '列举非兼容性重大的变更（可选）。使用 "|" 换行 :\n',
+      footerPrefixesSelect: '选择关联issue前缀（可选）:',
+      customFooterPrefix: '输入自定义issue前缀 :',
+      footer: '列举关联issue (可选) 例如: #31, #I3244 :\n',
+      generatingByAI: '正在通过 AI 生成你的提交简短描述...',
+      generatedSelectByAI: '选择一个 AI 生成的简短描述:',
+      confirmCommit: '是否提交或修改commit ?'
+    },
+    // prettier-ignore
+    types: [
+      { value: "feat",     name: "feat:     新增功能" },
+      { value: "fix",      name: "fix:      修复缺陷" },
+      { value: "docs",     name: "docs:     文档变更" },
+      { value: "style",    name: "style:    代码格式（不影响功能，例如空格、分号等格式修正）" },
+      { value: "refactor", name: "refactor: 代码重构（不包括 bug 修复、功能新增）" },
+      { value: "perf",     name: "perf:     性能优化" },
+      { value: "test",     name: "test:     添加疏漏测试或已有测试改动" },
+      { value: "build",    name: "build:    构建流程、外部依赖变更（如升级 npm 包、修改 vite 配置等）" },
+      { value: "ci",       name: "ci:       修改 CI 配置、脚本" },
+      { value: "revert",   name: "revert:   回滚 commit" },
+      { value: "chore",    name: "chore:    对构建过程或辅助工具和库的更改（不影响源文件、测试用例）" },
+    ],
+    useEmoji: true,
+    emojiAlign: 'center',
+    useAI: false,
+    aiNumber: 1,
+    themeColorCode: '',
+    scopes: [],
+    allowCustomScopes: true,
+    allowEmptyScopes: true,
+    customScopesAlign: 'bottom',
+    customScopesAlias: 'custom',
+    emptyScopesAlias: 'empty',
+    upperCaseSubject: false,
+    markBreakingChangeMode: false,
+    allowBreakingChanges: ['feat', 'fix'],
+    breaklineNumber: 100,
+    breaklineChar: '|',
+    skipQuestions: ['breaking', 'footerPrefix', 'footer'], // 跳过的步骤
+    issuePrefixes: [{ value: 'closed', name: 'closed:   ISSUES has been processed' }],
+    customIssuePrefixAlign: 'top',
+    emptyIssuePrefixAlias: 'skip',
+    customIssuePrefixAlias: 'custom',
+    allowCustomIssuePrefix: true,
+    allowEmptyIssuePrefix: true,
+    confirmColorize: true,
+    maxHeaderLength: Infinity,
+    maxSubjectLength: Infinity,
+    minSubjectLength: 0,
+    scopeOverrides: undefined,
+    defaultBody: '',
+    defaultIssues: '',
+    defaultScope: '',
+    defaultSubject: ''
+  }
+}
diff --git a/web/eslint.config.mjs b/web/eslint.config.mjs
new file mode 100644
index 0000000..ed2d4ba
--- /dev/null
+++ b/web/eslint.config.mjs
@@ -0,0 +1,83 @@
+// 从 URL 和路径模块中导入必要的功能
+import fs from 'fs'
+import path, { dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+// 从 ESLint 插件中导入推荐配置
+import pluginJs from '@eslint/js'
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended'
+import pluginVue from 'eslint-plugin-vue'
+import globals from 'globals'
+import tseslint from 'typescript-eslint'
+
+// 使用 import.meta.url 获取当前模块的路径
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+// 读取 .auto-import.json 文件的内容，并将其解析为 JSON 对象
+const autoImportConfig = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, '.auto-import.json'), 'utf-8')
+)
+
+export default [
+  // 指定文件匹配规则
+  {
+    files: ['**/*.{js,mjs,cjs,ts,tsx,vue}']
+  },
+  // 指定全局变量和环境
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node
+      }
+    }
+  },
+  // 扩展配置
+  pluginJs.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...pluginVue.configs['flat/essential'],
+  // 自定义规则
+  {
+    // 针对所有 JavaScript、TypeScript 和 Vue 文件应用以下配置
+    files: ['**/*.{js,mjs,cjs,ts,tsx,vue}'],
+
+    languageOptions: {
+      globals: {
+        // 合并从 autoImportConfig 中读取的全局变量配置
+        ...autoImportConfig.globals,
+        // TypeScript 全局命名空间
+        Api: 'readonly'
+      }
+    },
+    rules: {
+      quotes: ['error', 'single'], // 使用单引号
+      semi: ['error', 'never'], // 语句末尾不加分号
+      'no-var': 'error', // 要求使用 let 或 const 而不是 var
+      '@typescript-eslint/no-explicit-any': 'off', // 禁用 any 检查
+      'vue/multi-word-component-names': 'off', // 禁用对 Vue 组件名称的多词要求检查
+      'no-multiple-empty-lines': ['warn', { max: 1 }], // 不允许多个空行
+      'no-unexpected-multiline': 'error' // 禁止空余的多行
+    }
+  },
+  // vue 规则
+  {
+    files: ['**/*.vue'],
+    languageOptions: {
+      parserOptions: { parser: tseslint.parser }
+    }
+  },
+  // 忽略文件
+  {
+    ignores: [
+      'node_modules',
+      'dist',
+      'public',
+      '.vscode/**',
+      'src/assets/**',
+      'src/utils/console.ts'
+    ]
+  },
+  // prettier 配置
+  eslintPluginPrettierRecommended
+]
diff --git a/web/index.html b/web/index.html
new file mode 100755
index 0000000..ba51ce5
--- /dev/null
+++ b/web/index.html
@@ -0,0 +1,47 @@
+<!doctype html>
+<html>
+  <head>
+    <title>Art Design Pro</title>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta
+      name="description"
+      content="Art Design Pro - A modern admin dashboard template built with Vue 3, TypeScript, and Element Plus."
+    />
+    <link rel="shortcut icon" type="image/x-icon" href="src/assets/images/favicon.ico" />
+
+    <style>
+      /* 防止页面刷新时白屏的初始样式 */
+      html {
+        background-color: #fafbfc;
+      }
+
+      html.dark {
+        background-color: #070707;
+      }
+    </style>
+
+    <script>
+      // 初始化 html class 主题属性
+      ;(function () {
+        try {
+          if (typeof Storage === 'undefined' || !window.localStorage) {
+            return
+          }
+
+          const themeType = localStorage.getItem('sys-theme')
+          if (themeType === 'dark') {
+            document.documentElement.classList.add('dark')
+          }
+        } catch (e) {
+          console.warn('Failed to apply initial theme:', e)
+        }
+      })()
+    </script>
+  </head>
+
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
diff --git a/web/package.json b/web/package.json
new file mode 100755
index 0000000..7b66362
--- /dev/null
+++ b/web/package.json
@@ -0,0 +1,123 @@
+{
+  "name": "art-design-pro",
+  "version": "0.0.0",
+  "type": "module",
+  "engines": {
+    "node": ">=20.19.0",
+    "pnpm": ">=8.8.0"
+  },
+  "scripts": {
+    "dev": "vite --open",
+    "build": "vue-tsc --noEmit && vite build",
+    "serve": "vite preview",
+    "lint": "eslint",
+    "fix": "eslint --fix",
+    "lint:prettier": "prettier --write \"**/*.{js,cjs,ts,json,tsx,css,less,scss,vue,html,md}\"",
+    "lint:stylelint": "stylelint  \"**/*.{css,scss,vue}\" --fix",
+    "lint:lint-staged": "lint-staged",
+    "prepare": "husky",
+    "commit": "git-cz",
+    "clean:dev": "tsx scripts/clean-dev.ts"
+  },
+  "config": {
+    "commitizen": {
+      "path": "node_modules/cz-git"
+    }
+  },
+  "lint-staged": {
+    "*.{js,ts,mjs,mts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{cjs,json,jsonc}": [
+      "prettier --write"
+    ],
+    "*.vue": [
+      "eslint --fix",
+      "stylelint --fix --allow-empty-input",
+      "prettier --write"
+    ],
+    "*.{html,htm}": [
+      "prettier --write"
+    ],
+    "*.{scss,css,less}": [
+      "stylelint --fix --allow-empty-input",
+      "prettier --write"
+    ],
+    "*.{md,mdx}": [
+      "prettier --write"
+    ],
+    "*.{yaml,yml}": [
+      "prettier --write"
+    ]
+  },
+  "dependencies": {
+    "@element-plus/icons-vue": "^2.3.2",
+    "@iconify/vue": "^5.0.0",
+    "@tailwindcss/vite": "^4.1.14",
+    "@vue/reactivity": "^3.5.21",
+    "@vueuse/core": "^13.9.0",
+    "@wangeditor/editor": "^5.1.23",
+    "@wangeditor/editor-for-vue": "next",
+    "axios": "^1.12.2",
+    "crypto-js": "^4.2.0",
+    "echarts": "^6.0.0",
+    "element-plus": "^2.11.2",
+    "file-saver": "^2.0.5",
+    "highlight.js": "^11.10.0",
+    "mitt": "^3.0.1",
+    "nprogress": "^0.2.0",
+    "ohash": "^2.0.11",
+    "pinia": "^3.0.3",
+    "pinia-plugin-persistedstate": "^4.3.0",
+    "qrcode.vue": "^3.6.0",
+    "tailwindcss": "^4.1.14",
+    "vue": "^3.5.21",
+    "vue-draggable-plus": "^0.6.0",
+    "vue-i18n": "^9.14.0",
+    "vue-router": "^4.5.1",
+    "xgplayer": "^3.0.20",
+    "xlsx": "^0.18.5"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.4.1",
+    "@commitlint/config-conventional": "^19.4.1",
+    "@eslint/js": "^9.9.1",
+    "@types/node": "^24.0.5",
+    "@typescript-eslint/eslint-plugin": "^8.3.0",
+    "@typescript-eslint/parser": "^8.3.0",
+    "@vitejs/plugin-vue": "^6.0.1",
+    "@vue/compiler-sfc": "^3.0.5",
+    "commitizen": "^4.3.0",
+    "cz-git": "^1.11.1",
+    "eslint": "^9.9.1",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-vue": "^9.27.0",
+    "globals": "^15.9.0",
+    "husky": "^9.1.5",
+    "lint-staged": "^15.5.2",
+    "prettier": "^3.5.3",
+    "rollup-plugin-visualizer": "^5.12.0",
+    "sass": "^1.81.0",
+    "stylelint": "^16.20.0",
+    "stylelint-config-html": "^1.1.0",
+    "stylelint-config-recess-order": "^4.6.0",
+    "stylelint-config-recommended-scss": "^14.1.0",
+    "stylelint-config-recommended-vue": "^1.5.0",
+    "stylelint-config-standard": "^36.0.1",
+    "terser": "^5.36.0",
+    "tsx": "^4.20.3",
+    "typescript": "~5.6.3",
+    "typescript-eslint": "^8.9.0",
+    "unplugin-auto-import": "^20.2.0",
+    "unplugin-element-plus": "^0.10.0",
+    "unplugin-vue-components": "^29.1.0",
+    "vite": "^7.1.5",
+    "vite-plugin-compression": "^0.5.1",
+    "vite-plugin-vue-devtools": "^7.7.6",
+    "vue-demi": "^0.14.9",
+    "vue-img-cutter": "^3.0.5",
+    "vue-tsc": "~2.1.6"
+  }
+}
diff --git a/web/pnpm-lock.yaml b/web/pnpm-lock.yaml
new file mode 100644
index 0000000..401c518
--- /dev/null
+++ b/web/pnpm-lock.yaml
@@ -0,0 +1,10109 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+  .:
+    dependencies:
+      '@element-plus/icons-vue':
+        specifier: ^2.3.2
+        version: 2.3.2(vue@3.5.22(typescript@5.6.3))
+      '@iconify/vue':
+        specifier: ^5.0.0
+        version: 5.0.0(vue@3.5.22(typescript@5.6.3))
+      '@tailwindcss/vite':
+        specifier: ^4.1.14
+        version: 4.1.14(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))
+      '@vue/reactivity':
+        specifier: ^3.5.21
+        version: 3.5.22
+      '@vueuse/core':
+        specifier: ^13.9.0
+        version: 13.9.0(vue@3.5.22(typescript@5.6.3))
+      '@wangeditor/editor':
+        specifier: ^5.1.23
+        version: 5.1.23
+      '@wangeditor/editor-for-vue':
+        specifier: next
+        version: 5.1.12(@wangeditor/editor@5.1.23)(vue@3.5.22(typescript@5.6.3))
+      axios:
+        specifier: ^1.12.2
+        version: 1.12.2
+      crypto-js:
+        specifier: ^4.2.0
+        version: 4.2.0
+      echarts:
+        specifier: ^6.0.0
+        version: 6.0.0
+      element-plus:
+        specifier: ^2.11.2
+        version: 2.11.4(vue@3.5.22(typescript@5.6.3))
+      file-saver:
+        specifier: ^2.0.5
+        version: 2.0.5
+      highlight.js:
+        specifier: ^11.10.0
+        version: 11.11.1
+      mitt:
+        specifier: ^3.0.1
+        version: 3.0.1
+      nprogress:
+        specifier: ^0.2.0
+        version: 0.2.0
+      ohash:
+        specifier: ^2.0.11
+        version: 2.0.11
+      pinia:
+        specifier: ^3.0.3
+        version: 3.0.3(typescript@5.6.3)(vue@3.5.22(typescript@5.6.3))
+      pinia-plugin-persistedstate:
+        specifier: ^4.3.0
+        version: 4.5.0(pinia@3.0.3(typescript@5.6.3)(vue@3.5.22(typescript@5.6.3)))
+      qrcode.vue:
+        specifier: ^3.6.0
+        version: 3.6.0(vue@3.5.22(typescript@5.6.3))
+      tailwindcss:
+        specifier: ^4.1.14
+        version: 4.1.14
+      vue:
+        specifier: ^3.5.21
+        version: 3.5.22(typescript@5.6.3)
+      vue-draggable-plus:
+        specifier: ^0.6.0
+        version: 0.6.0(@types/sortablejs@1.15.8)
+      vue-i18n:
+        specifier: ^9.14.0
+        version: 9.14.5(vue@3.5.22(typescript@5.6.3))
+      vue-router:
+        specifier: ^4.5.1
+        version: 4.5.1(vue@3.5.22(typescript@5.6.3))
+      xgplayer:
+        specifier: ^3.0.20
+        version: 3.0.23(core-js@3.45.1)
+      xlsx:
+        specifier: ^0.18.5
+        version: 0.18.5
+    devDependencies:
+      '@commitlint/cli':
+        specifier: ^19.4.1
+        version: 19.8.1(@types/node@24.8.1)(typescript@5.6.3)
+      '@commitlint/config-conventional':
+        specifier: ^19.4.1
+        version: 19.8.1
+      '@eslint/js':
+        specifier: ^9.9.1
+        version: 9.36.0
+      '@types/node':
+        specifier: ^24.0.5
+        version: 24.8.1
+      '@typescript-eslint/eslint-plugin':
+        specifier: ^8.3.0
+        version: 8.44.1(@typescript-eslint/parser@8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3))(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      '@typescript-eslint/parser':
+        specifier: ^8.3.0
+        version: 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      '@vitejs/plugin-vue':
+        specifier: ^6.0.1
+        version: 6.0.1(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))(vue@3.5.22(typescript@5.6.3))
+      '@vue/compiler-sfc':
+        specifier: ^3.0.5
+        version: 3.5.22
+      commitizen:
+        specifier: ^4.3.0
+        version: 4.3.1(@types/node@24.8.1)(typescript@5.6.3)
+      cz-git:
+        specifier: ^1.11.1
+        version: 1.12.0
+      eslint:
+        specifier: ^9.9.1
+        version: 9.36.0(jiti@2.6.0)
+      eslint-config-prettier:
+        specifier: ^9.1.0
+        version: 9.1.2(eslint@9.36.0(jiti@2.6.0))
+      eslint-plugin-prettier:
+        specifier: ^5.2.1
+        version: 5.5.4(eslint-config-prettier@9.1.2(eslint@9.36.0(jiti@2.6.0)))(eslint@9.36.0(jiti@2.6.0))(prettier@3.6.2)
+      eslint-plugin-vue:
+        specifier: ^9.27.0
+        version: 9.33.0(eslint@9.36.0(jiti@2.6.0))
+      globals:
+        specifier: ^15.9.0
+        version: 15.15.0
+      husky:
+        specifier: ^9.1.5
+        version: 9.1.7
+      lint-staged:
+        specifier: ^15.5.2
+        version: 15.5.2
+      prettier:
+        specifier: ^3.5.3
+        version: 3.6.2
+      rollup-plugin-visualizer:
+        specifier: ^5.12.0
+        version: 5.14.0(rollup@4.52.3)
+      sass:
+        specifier: ^1.81.0
+        version: 1.93.2
+      stylelint:
+        specifier: ^16.20.0
+        version: 16.24.0(typescript@5.6.3)
+      stylelint-config-html:
+        specifier: ^1.1.0
+        version: 1.1.0(postcss-html@1.8.0)(stylelint@16.24.0(typescript@5.6.3))
+      stylelint-config-recess-order:
+        specifier: ^4.6.0
+        version: 4.6.0(stylelint@16.24.0(typescript@5.6.3))
+      stylelint-config-recommended-scss:
+        specifier: ^14.1.0
+        version: 14.1.0(postcss@8.5.6)(stylelint@16.24.0(typescript@5.6.3))
+      stylelint-config-recommended-vue:
+        specifier: ^1.5.0
+        version: 1.6.1(postcss-html@1.8.0)(stylelint@16.24.0(typescript@5.6.3))
+      stylelint-config-standard:
+        specifier: ^36.0.1
+        version: 36.0.1(stylelint@16.24.0(typescript@5.6.3))
+      terser:
+        specifier: ^5.36.0
+        version: 5.44.0
+      tsx:
+        specifier: ^4.20.3
+        version: 4.20.6
+      typescript:
+        specifier: ~5.6.3
+        version: 5.6.3
+      typescript-eslint:
+        specifier: ^8.9.0
+        version: 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      unplugin-auto-import:
+        specifier: ^20.2.0
+        version: 20.2.0(@vueuse/core@13.9.0(vue@3.5.22(typescript@5.6.3)))
+      unplugin-element-plus:
+        specifier: ^0.10.0
+        version: 0.10.0
+      unplugin-vue-components:
+        specifier: ^29.1.0
+        version: 29.1.0(@babel/parser@7.28.4)(vue@3.5.22(typescript@5.6.3))
+      vite:
+        specifier: ^7.1.5
+        version: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+      vite-plugin-compression:
+        specifier: ^0.5.1
+        version: 0.5.1(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))
+      vite-plugin-vue-devtools:
+        specifier: ^7.7.6
+        version: 7.7.7(rollup@4.52.3)(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))(vue@3.5.22(typescript@5.6.3))
+      vue-demi:
+        specifier: ^0.14.9
+        version: 0.14.10(vue@3.5.22(typescript@5.6.3))
+      vue-img-cutter:
+        specifier: ^3.0.5
+        version: 3.0.7(typescript@5.6.3)
+      vue-tsc:
+        specifier: ~2.1.6
+        version: 2.1.10(typescript@5.6.3)
+
+packages:
+  '@antfu/utils@0.7.10':
+    resolution:
+      {
+        integrity: sha512-+562v9k4aI80m1+VuMHehNJWLOFjBnXn3tdOitzD0il5b7smkSBal4+a3oKiQTbrwMmN/TBUMDvbdoWDehgOww==
+      }
+
+  '@babel/code-frame@7.27.1':
+    resolution:
+      {
+        integrity: sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/compat-data@7.28.4':
+    resolution:
+      {
+        integrity: sha512-YsmSKC29MJwf0gF8Rjjrg5LQCmyh+j/nD8/eP7f+BeoQTKYqs9RoWbjGOdy0+1Ekr68RJZMUOPVQaQisnIo4Rw==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/core@7.28.4':
+    resolution:
+      {
+        integrity: sha512-2BCOP7TN8M+gVDj7/ht3hsaO/B/n5oDbiAyyvnRlNOs+u1o+JWNYTQrmpuNp1/Wq2gcFrI01JAW+paEKDMx/CA==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/generator@7.28.3':
+    resolution:
+      {
+        integrity: sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-annotate-as-pure@7.27.3':
+    resolution:
+      {
+        integrity: sha512-fXSwMQqitTGeHLBC08Eq5yXz2m37E4pJX1qAU1+2cNedz/ifv/bVXft90VeSav5nFO61EcNgwr0aJxbyPaWBPg==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-compilation-targets@7.27.2':
+    resolution:
+      {
+        integrity: sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-create-class-features-plugin@7.28.3':
+    resolution:
+      {
+        integrity: sha512-V9f6ZFIYSLNEbuGA/92uOvYsGCJNsuA8ESZ4ldc09bWk/j8H8TKiPw8Mk1eG6olpnO0ALHJmYfZvF4MEE4gajg==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0
+
+  '@babel/helper-globals@7.28.0':
+    resolution:
+      {
+        integrity: sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-member-expression-to-functions@7.27.1':
+    resolution:
+      {
+        integrity: sha512-E5chM8eWjTp/aNoVpcbfM7mLxu9XGLWYise2eBKGQomAk/Mb4XoxyqXTZbuTohbsl8EKqdlMhnDI2CCLfcs9wA==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-module-imports@7.27.1':
+    resolution:
+      {
+        integrity: sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-module-transforms@7.28.3':
+    resolution:
+      {
+        integrity: sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0
+
+  '@babel/helper-optimise-call-expression@7.27.1':
+    resolution:
+      {
+        integrity: sha512-URMGH08NzYFhubNSGJrpUEphGKQwMQYBySzat5cAByY1/YgIRkULnIy3tAMeszlL/so2HbeilYloUmSpd7GdVw==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-plugin-utils@7.27.1':
+    resolution:
+      {
+        integrity: sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-replace-supers@7.27.1':
+    resolution:
+      {
+        integrity: sha512-7EHz6qDZc8RYS5ElPoShMheWvEgERonFCs7IAonWLLUTXW59DP14bCZt89/GKyreYn8g3S83m21FelHKbeDCKA==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0
+
+  '@babel/helper-skip-transparent-expression-wrappers@7.27.1':
+    resolution:
+      {
+        integrity: sha512-Tub4ZKEXqbPjXgWLl2+3JpQAYBJ8+ikpQ2Ocj/q/r0LwE3UhENh7EUabyHjz2kCEsrRY83ew2DQdHluuiDQFzg==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-string-parser@7.27.1':
+    resolution:
+      {
+        integrity: sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-validator-identifier@7.27.1':
+    resolution:
+      {
+        integrity: sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helper-validator-option@7.27.1':
+    resolution:
+      {
+        integrity: sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/helpers@7.28.4':
+    resolution:
+      {
+        integrity: sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/parser@7.28.4':
+    resolution:
+      {
+        integrity: sha512-yZbBqeM6TkpP9du/I2pUZnJsRMGGvOuIrhjzC1AwHwW+6he4mni6Bp/m8ijn0iOuZuPI2BfkCoSRunpyjnrQKg==
+      }
+    engines: { node: '>=6.0.0' }
+    hasBin: true
+
+  '@babel/plugin-proposal-decorators@7.28.0':
+    resolution:
+      {
+        integrity: sha512-zOiZqvANjWDUaUS9xMxbMcK/Zccztbe/6ikvUXaG9nsPH3w6qh5UaPGAnirI/WhIbZ8m3OHU0ReyPrknG+ZKeg==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-decorators@7.27.1':
+    resolution:
+      {
+        integrity: sha512-YMq8Z87Lhl8EGkmb0MwYkt36QnxC+fzCgrl66ereamPlYToRpIk5nUjKUY3QKLWq8mwUB1BgbeXcTJhZOCDg5A==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-import-attributes@7.27.1':
+    resolution:
+      {
+        integrity: sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-import-meta@7.10.4':
+    resolution:
+      {
+        integrity: sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==
+      }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-jsx@7.27.1':
+    resolution:
+      {
+        integrity: sha512-y8YTNIeKoyhGd9O0Jiyzyyqk8gdjnumGTQPsz0xOZOQ2RmkVJeZ1vmmfIvFEKqucBG6axJGBZDE/7iI5suUI/w==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-syntax-typescript@7.27.1':
+    resolution:
+      {
+        integrity: sha512-xfYCBMxveHrRMnAWl1ZlPXOZjzkN82THFvLhQhFXFt81Z5HnN+EtUkZhv/zcKpmT3fzmWZB0ywiBrbC3vogbwQ==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/plugin-transform-typescript@7.28.0':
+    resolution:
+      {
+        integrity: sha512-4AEiDEBPIZvLQaWlc9liCavE0xRM0dNca41WtBeM3jgFptfUOSG9z0uteLhq6+3rq+WB6jIvUwKDTpXEHPJ2Vg==
+      }
+    engines: { node: '>=6.9.0' }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@babel/runtime@7.28.4':
+    resolution:
+      {
+        integrity: sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/template@7.27.2':
+    resolution:
+      {
+        integrity: sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/traverse@7.28.4':
+    resolution:
+      {
+        integrity: sha512-YEzuboP2qvQavAcjgQNVgsvHIDv6ZpwXvcvjmyySP2DIMuByS/6ioU5G9pYrWHM6T2YDfc7xga9iNzYOs12CFQ==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@babel/types@7.28.4':
+    resolution:
+      {
+        integrity: sha512-bkFqkLhh3pMBUQQkpVgWDWq/lqzc2678eUyDlTBhRqhCHFguYYGM0Efga7tYk4TogG/3x0EEl66/OQ+WGbWB/Q==
+      }
+    engines: { node: '>=6.9.0' }
+
+  '@cacheable/memoize@2.0.2':
+    resolution:
+      {
+        integrity: sha512-wPrr7FUiq3Qt4yQyda2/NcOLTJCFcQSU3Am2adP+WLy+sz93/fKTokVTHmtz+rjp4PD7ee0AEOeRVNN6IvIfsg==
+      }
+
+  '@cacheable/memory@2.0.2':
+    resolution:
+      {
+        integrity: sha512-sJTITLfeCI1rg7P3ssaGmQryq235EGT8dXGcx6oZwX5NRnKq9IE6lddlllcOl+oXW+yaeTRddCjo0xrfU6ZySA==
+      }
+
+  '@cacheable/utils@2.0.2':
+    resolution:
+      {
+        integrity: sha512-JTFM3raFhVv8LH95T7YnZbf2YoE9wEtkPPStuRF9a6ExZ103hFvs+QyCuYJ6r0hA9wRtbzgZtwUCoDWxssZd4Q==
+      }
+
+  '@commitlint/cli@19.8.1':
+    resolution:
+      {
+        integrity: sha512-LXUdNIkspyxrlV6VDHWBmCZRtkEVRpBKxi2Gtw3J54cGWhLCTouVD/Q6ZSaSvd2YaDObWK8mDjrz3TIKtaQMAA==
+      }
+    engines: { node: '>=v18' }
+    hasBin: true
+
+  '@commitlint/config-conventional@19.8.1':
+    resolution:
+      {
+        integrity: sha512-/AZHJL6F6B/G959CsMAzrPKKZjeEiAVifRyEwXxcT6qtqbPwGw+iQxmNS+Bu+i09OCtdNRW6pNpBvgPrtMr9EQ==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/config-validator@19.8.1':
+    resolution:
+      {
+        integrity: sha512-0jvJ4u+eqGPBIzzSdqKNX1rvdbSU1lPNYlfQQRIFnBgLy26BtC0cFnr7c/AyuzExMxWsMOte6MkTi9I3SQ3iGQ==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/config-validator@20.0.0':
+    resolution:
+      {
+        integrity: sha512-BeyLMaRIJDdroJuYM2EGhDMGwVBMZna9UiIqV9hxj+J551Ctc6yoGuGSmghOy/qPhBSuhA6oMtbEiTmxECafsg==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/ensure@19.8.1':
+    resolution:
+      {
+        integrity: sha512-mXDnlJdvDzSObafjYrOSvZBwkD01cqB4gbnnFuVyNpGUM5ijwU/r/6uqUmBXAAOKRfyEjpkGVZxaDsCVnHAgyw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/execute-rule@19.8.1':
+    resolution:
+      {
+        integrity: sha512-YfJyIqIKWI64Mgvn/sE7FXvVMQER/Cd+s3hZke6cI1xgNT/f6ZAz5heND0QtffH+KbcqAwXDEE1/5niYayYaQA==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/execute-rule@20.0.0':
+    resolution:
+      {
+        integrity: sha512-xyCoOShoPuPL44gVa+5EdZsBVao/pNzpQhkzq3RdtlFdKZtjWcLlUFQHSWBuhk5utKYykeJPSz2i8ABHQA+ZZw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/format@19.8.1':
+    resolution:
+      {
+        integrity: sha512-kSJj34Rp10ItP+Eh9oCItiuN/HwGQMXBnIRk69jdOwEW9llW9FlyqcWYbHPSGofmjsqeoxa38UaEA5tsbm2JWw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/is-ignored@19.8.1':
+    resolution:
+      {
+        integrity: sha512-AceOhEhekBUQ5dzrVhDDsbMaY5LqtN8s1mqSnT2Kz1ERvVZkNihrs3Sfk1Je/rxRNbXYFzKZSHaPsEJJDJV8dg==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/lint@19.8.1':
+    resolution:
+      {
+        integrity: sha512-52PFbsl+1EvMuokZXLRlOsdcLHf10isTPlWwoY1FQIidTsTvjKXVXYb7AvtpWkDzRO2ZsqIgPK7bI98x8LRUEw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/load@19.8.1':
+    resolution:
+      {
+        integrity: sha512-9V99EKG3u7z+FEoe4ikgq7YGRCSukAcvmKQuTtUyiYPnOd9a2/H9Ak1J9nJA1HChRQp9OA/sIKPugGS+FK/k1A==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/load@20.0.0':
+    resolution:
+      {
+        integrity: sha512-WiNKO9fDPlLY90Rruw2HqHKcghrmj5+kMDJ4GcTlX1weL8K07Q6b27C179DxnsrjGCRAKVwFKyzxV4x+xDY28Q==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/message@19.8.1':
+    resolution:
+      {
+        integrity: sha512-+PMLQvjRXiU+Ae0Wc+p99EoGEutzSXFVwQfa3jRNUZLNW5odZAyseb92OSBTKCu+9gGZiJASt76Cj3dLTtcTdg==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/parse@19.8.1':
+    resolution:
+      {
+        integrity: sha512-mmAHYcMBmAgJDKWdkjIGq50X4yB0pSGpxyOODwYmoexxxiUCy5JJT99t1+PEMK7KtsCtzuWYIAXYAiKR+k+/Jw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/read@19.8.1':
+    resolution:
+      {
+        integrity: sha512-03Jbjb1MqluaVXKHKRuGhcKWtSgh3Jizqy2lJCRbRrnWpcM06MYm8th59Xcns8EqBYvo0Xqb+2DoZFlga97uXQ==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/resolve-extends@19.8.1':
+    resolution:
+      {
+        integrity: sha512-GM0mAhFk49I+T/5UCYns5ayGStkTt4XFFrjjf0L4S26xoMTSkdCf9ZRO8en1kuopC4isDFuEm7ZOm/WRVeElVg==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/resolve-extends@20.0.0':
+    resolution:
+      {
+        integrity: sha512-BA4vva1hY8y0/Hl80YDhe9TJZpRFMsUYzVxvwTLPTEBotbGx/gS49JlVvtF1tOCKODQp7pS7CbxCpiceBgp3Dg==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/rules@19.8.1':
+    resolution:
+      {
+        integrity: sha512-Hnlhd9DyvGiGwjfjfToMi1dsnw1EXKGJNLTcsuGORHz6SS9swRgkBsou33MQ2n51/boIDrbsg4tIBbRpEWK2kw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/to-lines@19.8.1':
+    resolution:
+      {
+        integrity: sha512-98Mm5inzbWTKuZQr2aW4SReY6WUukdWXuZhrqf1QdKPZBCCsXuG87c+iP0bwtD6DBnmVVQjgp4whoHRVixyPBg==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/top-level@19.8.1':
+    resolution:
+      {
+        integrity: sha512-Ph8IN1IOHPSDhURCSXBz44+CIu+60duFwRsg6HqaISFHQHbmBtxVw4ZrFNIYUzEP7WwrNPxa2/5qJ//NK1FGcw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/types@19.8.1':
+    resolution:
+      {
+        integrity: sha512-/yCrWGCoA1SVKOks25EGadP9Pnj0oAIHGpl2wH2M2Y46dPM2ueb8wyCVOD7O3WCTkaJ0IkKvzhl1JY7+uCT2Dw==
+      }
+    engines: { node: '>=v18' }
+
+  '@commitlint/types@20.0.0':
+    resolution:
+      {
+        integrity: sha512-bVUNBqG6aznYcYjTjnc3+Cat/iBgbgpflxbIBTnsHTX0YVpnmINPEkSRWymT2Q8aSH3Y7aKnEbunilkYe8TybA==
+      }
+    engines: { node: '>=v18' }
+
+  '@csstools/css-parser-algorithms@3.0.5':
+    resolution:
+      {
+        integrity: sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==
+      }
+    engines: { node: '>=18' }
+    peerDependencies:
+      '@csstools/css-tokenizer': ^3.0.4
+
+  '@csstools/css-tokenizer@3.0.4':
+    resolution:
+      {
+        integrity: sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==
+      }
+    engines: { node: '>=18' }
+
+  '@csstools/media-query-list-parser@4.0.3':
+    resolution:
+      {
+        integrity: sha512-HAYH7d3TLRHDOUQK4mZKf9k9Ph/m8Akstg66ywKR4SFAigjs3yBiUeZtFxywiTm5moZMAp/5W/ZuFnNXXYLuuQ==
+      }
+    engines: { node: '>=18' }
+    peerDependencies:
+      '@csstools/css-parser-algorithms': ^3.0.5
+      '@csstools/css-tokenizer': ^3.0.4
+
+  '@csstools/selector-specificity@5.0.0':
+    resolution:
+      {
+        integrity: sha512-PCqQV3c4CoVm3kdPhyeZ07VmBRdH2EpMFA/pd9OASpOEC3aXNGoqPDAZ80D0cLpMBxnmk0+yNhGsEx31hq7Gtw==
+      }
+    engines: { node: '>=18' }
+    peerDependencies:
+      postcss-selector-parser: ^7.0.0
+
+  '@ctrl/tinycolor@3.6.1':
+    resolution:
+      {
+        integrity: sha512-SITSV6aIXsuVNV3f3O0f2n/cgyEDWoSqtZMYiAmcsYHydcKrOz3gUxB/iXd/Qf08+IZX4KpgNbvUdMBmWz+kcA==
+      }
+    engines: { node: '>=10' }
+
+  '@dual-bundle/import-meta-resolve@4.2.1':
+    resolution:
+      {
+        integrity: sha512-id+7YRUgoUX6CgV0DtuhirQWodeeA7Lf4i2x71JS/vtA5pRb/hIGWlw+G6MeXvsM+MXrz0VAydTGElX1rAfgPg==
+      }
+
+  '@element-plus/icons-vue@2.3.2':
+    resolution:
+      {
+        integrity: sha512-OzIuTaIfC8QXEPmJvB4Y4kw34rSXdCJzxcD1kFStBvr8bK6X1zQAYDo0CNMjojnfTqRQCJ0I7prlErcoRiET2A==
+      }
+    peerDependencies:
+      vue: ^3.2.0
+
+  '@esbuild/aix-ppc64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-0NFWnA+7l41irNuaSVlLfgNT12caWJVLzp5eAVhZ0z1qpxbockccEt3s+149rE64VUI3Ml2zt8Nv5JVc4QXTsw==
+      }
+    engines: { node: '>=18' }
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-LSQa7eDahypv/VO6WKohZGPSJDq5OVOo3UoFR1E4t4Gj1W7zEQMUhI+lo81H+DtB+kP+tDgBp+M4oNCwp6kffg==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.25.10':
+    resolution:
+      {
+        integrity: sha512-dQAxF1dW1C3zpeCDc5KqIYuZ1tgAdRXNoZP7vkBIRtKZPYe2xVr/d3SkirklCHudW1B45tGiUlz2pUWDfbDD4w==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-MiC9CWdPrfhibcXwr39p9ha1x0lZJ9KaVfvzA0Wxwz9ETX4v5CHfF09bx935nHlhi+MxhA63dKRRQLiVgSUtEg==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-JC74bdXcQEpW9KkV326WpZZjLguSZ3DfS8wrrvPMHgQOIEIG/sPXEN/V8IssoJhbefLRcRqw6RQH2NnpdprtMA==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-tguWg1olF6DGqzws97pKZ8G2L7Ig1vjDmGTwcTuYHbuU6TTjJe5FXbgs5C1BBzHbJ2bo1m3WkQDbWO2PvamRcg==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-3ZioSQSg1HT2N05YxeJWYR+Libe3bREVSdWhEEgExWaDtyFbbXWb49QgPvFH8u03vUPX10JhJPcz7s9t9+boWg==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-LLgJfHJk014Aa4anGDbh8bmI5Lk+QidDmGzuC2D+vP7mv/GeSN+H39zOf7pN5N8p059FcOfs2bVlrRr4SK9WxA==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-5luJWN6YKBsawd5f9i4+c+geYiVEw20FVW5x0v1kEMWNq8UctFjDiMATBxLvmmHA4bf7F6hTRaJgtghFr9iziQ==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.25.10':
+    resolution:
+      {
+        integrity: sha512-oR31GtBTFYCqEBALI9r6WxoU/ZofZl962pouZRTEYECvNF/dtXKku8YXcJkhgK/beU+zedXfIzHijSRapJY3vg==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.25.10':
+    resolution:
+      {
+        integrity: sha512-NrSCx2Kim3EnnWgS4Txn0QGt0Xipoumb6z6sUtl5bOEZIVKhzfyp/Lyw4C1DIYvzeW/5mWYPBFJU3a/8Yr75DQ==
+      }
+    engines: { node: '>=18' }
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-xoSphrd4AZda8+rUDDfD9J6FUMjrkTz8itpTITM4/xgerAZZcFW7Dv+sun7333IfKxGG8gAq+3NbfEMJfiY+Eg==
+      }
+    engines: { node: '>=18' }
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.25.10':
+    resolution:
+      {
+        integrity: sha512-ab6eiuCwoMmYDyTnyptoKkVS3k8fy/1Uvq7Dj5czXI6DF2GqD2ToInBI0SHOp5/X1BdZ26RKc5+qjQNGRBelRA==
+      }
+    engines: { node: '>=18' }
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-NLinzzOgZQsGpsTkEbdJTCanwA5/wozN9dSgEl12haXJBzMTpssebuXR42bthOF3z7zXFWH1AmvWunUCkBE4EA==
+      }
+    engines: { node: '>=18' }
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-FE557XdZDrtX8NMIeA8LBJX3dC2M8VGXwfrQWU7LB5SLOajfJIxmSdyL/gU1m64Zs9CBKvm4UAuBp5aJ8OgnrA==
+      }
+    engines: { node: '>=18' }
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.25.10':
+    resolution:
+      {
+        integrity: sha512-3BBSbgzuB9ajLoVZk0mGu+EHlBwkusRmeNYdqmznmMc9zGASFjSsxgkNsqmXugpPk00gJ0JNKh/97nxmjctdew==
+      }
+    engines: { node: '>=18' }
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-QSX81KhFoZGwenVyPoberggdW1nrQZSvfVDAIUXr3WqLRZGZqWk/P4T8p2SP+de2Sr5HPcvjhcJzEiulKgnxtA==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-AKQM3gfYfSW8XRk8DdMCzaLUFB15dTrZfnX8WXQoOUpUBQ+NaAFCP1kPS/ykbbGYz7rxn0WS48/81l9hFl3u4A==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-7RTytDPGU6fek/hWuN9qQpeGPBZFfB4zZgcz2VK2Z5VpdUxEI8JKYsg3JfO0n/Z1E/6l05n0unDCNc4HnhQGig==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-5Se0VM9Wtq797YFn+dLimf2Zx6McttsH2olUBsDml+lm0GOCRVebRWUvDtkY4BWYv/3NgzS8b/UM3jQNh5hYyw==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-XkA4frq1TLj4bEMB+2HnI0+4RnjbuGZfet2gs/LNs5Hc7D89ZQBHQ0gL2ND6Lzu1+QVkjp3x1gIcPKzRNP8bXw==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-AVTSBhTX8Y/Fz6OmIVBip9tJzZEUcY8WLh7I59+upa5/GPhh2/aM6bvOMQySspnCCHvFi79kMtdJS1w0DXAeag==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-fswk3XT0Uf2pGJmOpDB7yknqhVkJQkAQOcW/ccVOtfx05LkbWOaRAtn5SaqXypeKQra1QaEa841PgrSL9ubSPQ==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-ah+9b59KDTSfpaCg6VdJoOQvKjI33nTaQr4UluQwW7aEwZQsbMCfTmfEO4VyewOxx4RaDT/xCy9ra2GPWmO7Kw==
+      }
+    engines: { node: '>=18' }
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.25.10':
+    resolution:
+      {
+        integrity: sha512-QHPDbKkrGO8/cz9LKVnJU22HOi4pxZnZhhA2HYHez5Pz4JeffhDjf85E57Oyco163GnzNCVkZK0b/n4Y0UHcSw==
+      }
+    engines: { node: '>=18' }
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.25.10':
+    resolution:
+      {
+        integrity: sha512-9KpxSVFCu0iK1owoez6aC/s/EdUQLDN3adTxGCqxMVhrPDj6bt5dbrHDXUuq+Bs2vATFBBrQS5vdQ/Ed2P+nbw==
+      }
+    engines: { node: '>=18' }
+    cpu: [x64]
+    os: [win32]
+
+  '@eslint-community/eslint-utils@4.9.0':
+    resolution:
+      {
+        integrity: sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==
+      }
+    engines: { node: ^12.22.0 || ^14.17.0 || >=16.0.0 }
+    peerDependencies:
+      eslint: ^6.0.0 || ^7.0.0 || >=8.0.0
+
+  '@eslint-community/regexpp@4.12.1':
+    resolution:
+      {
+        integrity: sha512-CCZCDJuduB9OUkFkY2IgppNZMi2lBQgD2qzwXkEia16cge2pijY/aXi96CJMquDMn3nJdlPV1A5KrJEXwfLNzQ==
+      }
+    engines: { node: ^12.0.0 || ^14.0.0 || >=16.0.0 }
+
+  '@eslint/config-array@0.21.0':
+    resolution:
+      {
+        integrity: sha512-ENIdc4iLu0d93HeYirvKmrzshzofPw6VkZRKQGe9Nv46ZnWUzcF1xV01dcvEg/1wXUR61OmmlSfyeyO7EvjLxQ==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@eslint/config-helpers@0.3.1':
+    resolution:
+      {
+        integrity: sha512-xR93k9WhrDYpXHORXpxVL5oHj3Era7wo6k/Wd8/IsQNnZUTzkGS29lyn3nAT05v6ltUuTFVCCYDEGfy2Or/sPA==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@eslint/core@0.15.2':
+    resolution:
+      {
+        integrity: sha512-78Md3/Rrxh83gCxoUc0EiciuOHsIITzLy53m3d9UyiW8y9Dj2D29FeETqyKA+BRK76tnTp6RXWb3pCay8Oyomg==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@eslint/eslintrc@3.3.1':
+    resolution:
+      {
+        integrity: sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@eslint/js@9.36.0':
+    resolution:
+      {
+        integrity: sha512-uhCbYtYynH30iZErszX78U+nR3pJU3RHGQ57NXy5QupD4SBVwDeU8TNBy+MjMngc1UyIW9noKqsRqfjQTBU2dw==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@eslint/object-schema@2.1.6':
+    resolution:
+      {
+        integrity: sha512-RBMg5FRL0I0gs51M/guSAj5/e14VQ4tpZnQNWwuDT66P14I43ItmPfIZRhO9fUVIPOAQXU47atlywZ/czoqFPA==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@eslint/plugin-kit@0.3.5':
+    resolution:
+      {
+        integrity: sha512-Z5kJ+wU3oA7MMIqVR9tyZRtjYPr4OC004Q4Rw7pgOKUOKkJfZ3O24nz3WYfGRpMDNmcOi3TwQOmgm7B7Tpii0w==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@floating-ui/core@1.7.3':
+    resolution:
+      {
+        integrity: sha512-sGnvb5dmrJaKEZ+LDIpguvdX3bDlEllmv4/ClQ9awcmCZrlx5jQyyMWFM5kBI+EyNOCDDiKk8il0zeuX3Zlg/w==
+      }
+
+  '@floating-ui/dom@1.7.4':
+    resolution:
+      {
+        integrity: sha512-OOchDgh4F2CchOX94cRVqhvy7b3AFb+/rQXyswmzmGakRfkMgoWVjfnLWkRirfLEfuD4ysVW16eXzwt3jHIzKA==
+      }
+
+  '@floating-ui/utils@0.2.10':
+    resolution:
+      {
+        integrity: sha512-aGTxbpbg8/b5JfU1HXSrbH3wXZuLPJcNEcZQFMxLs3oSzgtVu6nFPkbbGGUvBcUjKV2YyB9Wxxabo+HEH9tcRQ==
+      }
+
+  '@humanfs/core@0.19.1':
+    resolution:
+      {
+        integrity: sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==
+      }
+    engines: { node: '>=18.18.0' }
+
+  '@humanfs/node@0.16.7':
+    resolution:
+      {
+        integrity: sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==
+      }
+    engines: { node: '>=18.18.0' }
+
+  '@humanwhocodes/module-importer@1.0.1':
+    resolution:
+      {
+        integrity: sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==
+      }
+    engines: { node: '>=12.22' }
+
+  '@humanwhocodes/retry@0.4.3':
+    resolution:
+      {
+        integrity: sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==
+      }
+    engines: { node: '>=18.18' }
+
+  '@iconify/types@2.0.0':
+    resolution:
+      {
+        integrity: sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==
+      }
+
+  '@iconify/vue@5.0.0':
+    resolution:
+      {
+        integrity: sha512-C+KuEWIF5nSBrobFJhT//JS87OZ++QDORB6f2q2Wm6fl2mueSTpFBeBsveK0KW9hWiZ4mNiPjsh6Zs4jjdROSg==
+      }
+    peerDependencies:
+      vue: '>=3'
+
+  '@intlify/core-base@9.14.5':
+    resolution:
+      {
+        integrity: sha512-5ah5FqZG4pOoHjkvs8mjtv+gPKYU0zCISaYNjBNNqYiaITxW8ZtVih3GS/oTOqN8d9/mDLyrjD46GBApNxmlsA==
+      }
+    engines: { node: '>= 16' }
+
+  '@intlify/message-compiler@9.14.5':
+    resolution:
+      {
+        integrity: sha512-IHzgEu61/YIpQV5Pc3aRWScDcnFKWvQA9kigcINcCBXN8mbW+vk9SK+lDxA6STzKQsVJxUPg9ACC52pKKo3SVQ==
+      }
+    engines: { node: '>= 16' }
+
+  '@intlify/shared@9.14.5':
+    resolution:
+      {
+        integrity: sha512-9gB+E53BYuAEMhbCAxVgG38EZrk59sxBtv3jSizNL2hEWlgjBjAw1AwpLHtNaeda12pe6W20OGEa0TwuMSRbyQ==
+      }
+    engines: { node: '>= 16' }
+
+  '@isaacs/fs-minipass@4.0.1':
+    resolution:
+      {
+        integrity: sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==
+      }
+    engines: { node: '>=18.0.0' }
+
+  '@jridgewell/gen-mapping@0.3.13':
+    resolution:
+      {
+        integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==
+      }
+
+  '@jridgewell/remapping@2.3.5':
+    resolution:
+      {
+        integrity: sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==
+      }
+
+  '@jridgewell/resolve-uri@3.1.2':
+    resolution:
+      {
+        integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==
+      }
+    engines: { node: '>=6.0.0' }
+
+  '@jridgewell/source-map@0.3.11':
+    resolution:
+      {
+        integrity: sha512-ZMp1V8ZFcPG5dIWnQLr3NSI1MiCU7UETdS/A0G8V/XWHvJv3ZsFqutJn1Y5RPmAPX6F3BiE397OqveU/9NCuIA==
+      }
+
+  '@jridgewell/sourcemap-codec@1.5.5':
+    resolution:
+      {
+        integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==
+      }
+
+  '@jridgewell/trace-mapping@0.3.31':
+    resolution:
+      {
+        integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==
+      }
+
+  '@keyv/bigmap@1.0.2':
+    resolution:
+      {
+        integrity: sha512-KR03xkEZlAZNF4IxXgVXb+uNIVNvwdh8UwI0cnc7WI6a+aQcDp8GL80qVfeB4E5NpsKJzou5jU0r6yLSSbMOtA==
+      }
+    engines: { node: '>= 18' }
+
+  '@keyv/serialize@1.1.1':
+    resolution:
+      {
+        integrity: sha512-dXn3FZhPv0US+7dtJsIi2R+c7qWYiReoEh5zUntWCf4oSpMNib8FDhSoed6m3QyZdx5hK7iLFkYk3rNxwt8vTA==
+      }
+
+  '@nodelib/fs.scandir@2.1.5':
+    resolution:
+      {
+        integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==
+      }
+    engines: { node: '>= 8' }
+
+  '@nodelib/fs.stat@2.0.5':
+    resolution:
+      {
+        integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==
+      }
+    engines: { node: '>= 8' }
+
+  '@nodelib/fs.walk@1.2.8':
+    resolution:
+      {
+        integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==
+      }
+    engines: { node: '>= 8' }
+
+  '@parcel/watcher-android-arm64@2.5.1':
+    resolution:
+      {
+        integrity: sha512-KF8+j9nNbUN8vzOFDpRMsaKBHZ/mcjEjMToVMJOhTozkDonQFFrRcfdLWn6yWKCmJKmdVxSgHiYvTCef4/qcBA==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [arm64]
+    os: [android]
+
+  '@parcel/watcher-darwin-arm64@2.5.1':
+    resolution:
+      {
+        integrity: sha512-eAzPv5osDmZyBhou8PoF4i6RQXAfeKL9tjb3QzYuccXFMQU0ruIc/POh30ePnaOyD1UXdlKguHBmsTs53tVoPw==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [arm64]
+    os: [darwin]
+
+  '@parcel/watcher-darwin-x64@2.5.1':
+    resolution:
+      {
+        integrity: sha512-1ZXDthrnNmwv10A0/3AJNZ9JGlzrF82i3gNQcWOzd7nJ8aj+ILyW1MTxVk35Db0u91oD5Nlk9MBiujMlwmeXZg==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [x64]
+    os: [darwin]
+
+  '@parcel/watcher-freebsd-x64@2.5.1':
+    resolution:
+      {
+        integrity: sha512-SI4eljM7Flp9yPuKi8W0ird8TI/JK6CSxju3NojVI6BjHsTyK7zxA9urjVjEKJ5MBYC+bLmMcbAWlZ+rFkLpJQ==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [x64]
+    os: [freebsd]
+
+  '@parcel/watcher-linux-arm-glibc@2.5.1':
+    resolution:
+      {
+        integrity: sha512-RCdZlEyTs8geyBkkcnPWvtXLY44BCeZKmGYRtSgtwwnHR4dxfHRG3gR99XdMEdQ7KeiDdasJwwvNSF5jKtDwdA==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@parcel/watcher-linux-arm-musl@2.5.1':
+    resolution:
+      {
+        integrity: sha512-6E+m/Mm1t1yhB8X412stiKFG3XykmgdIOqhjWj+VL8oHkKABfu/gjFj8DvLrYVHSBNC+/u5PeNrujiSQ1zwd1Q==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@parcel/watcher-linux-arm64-glibc@2.5.1':
+    resolution:
+      {
+        integrity: sha512-LrGp+f02yU3BN9A+DGuY3v3bmnFUggAITBGriZHUREfNEzZh/GO06FF5u2kx8x+GBEUYfyTGamol4j3m9ANe8w==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@parcel/watcher-linux-arm64-musl@2.5.1':
+    resolution:
+      {
+        integrity: sha512-cFOjABi92pMYRXS7AcQv9/M1YuKRw8SZniCDw0ssQb/noPkRzA+HBDkwmyOJYp5wXcsTrhxO0zq1U11cK9jsFg==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@parcel/watcher-linux-x64-glibc@2.5.1':
+    resolution:
+      {
+        integrity: sha512-GcESn8NZySmfwlTsIur+49yDqSny2IhPeZfXunQi48DMugKeZ7uy1FX83pO0X22sHntJ4Ub+9k34XQCX+oHt2A==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@parcel/watcher-linux-x64-musl@2.5.1':
+    resolution:
+      {
+        integrity: sha512-n0E2EQbatQ3bXhcH2D1XIAANAcTZkQICBPVaxMeaCVBtOpBZpWJuf7LwyWPSBDITb7In8mqQgJ7gH8CILCURXg==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@parcel/watcher-win32-arm64@2.5.1':
+    resolution:
+      {
+        integrity: sha512-RFzklRvmc3PkjKjry3hLF9wD7ppR4AKcWNzH7kXR7GUe0Igb3Nz8fyPwtZCSquGrhU5HhUNDr/mKBqj7tqA2Vw==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [arm64]
+    os: [win32]
+
+  '@parcel/watcher-win32-ia32@2.5.1':
+    resolution:
+      {
+        integrity: sha512-c2KkcVN+NJmuA7CGlaGD1qJh1cLfDnQsHjE89E60vUEMlqduHGCdCLJCID5geFVM0dOtA3ZiIO8BoEQmzQVfpQ==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [ia32]
+    os: [win32]
+
+  '@parcel/watcher-win32-x64@2.5.1':
+    resolution:
+      {
+        integrity: sha512-9lHBdJITeNR++EvSQVUcaZoWupyHfXe1jZvGZ06O/5MflPcuPLtEphScIBL+AiCWBO46tDSHzWyD0uDmmZqsgA==
+      }
+    engines: { node: '>= 10.0.0' }
+    cpu: [x64]
+    os: [win32]
+
+  '@parcel/watcher@2.5.1':
+    resolution:
+      {
+        integrity: sha512-dfUnCxiN9H4ap84DvD2ubjw+3vUNpstxa0TneY/Paat8a3R4uQZDLSvWjmznAY/DoahqTHl9V46HF/Zs3F29pg==
+      }
+    engines: { node: '>= 10.0.0' }
+
+  '@pkgr/core@0.2.9':
+    resolution:
+      {
+        integrity: sha512-QNqXyfVS2wm9hweSYD2O7F0G06uurj9kZ96TRQE5Y9hU7+tgdZwIkbAKc5Ocy1HxEY2kuDQa6cQ1WRs/O5LFKA==
+      }
+    engines: { node: ^12.20.0 || ^14.18.0 || >=16.0.0 }
+
+  '@polka/url@1.0.0-next.29':
+    resolution:
+      {
+        integrity: sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==
+      }
+
+  '@rolldown/pluginutils@1.0.0-beta.29':
+    resolution:
+      {
+        integrity: sha512-NIJgOsMjbxAXvoGq/X0gD7VPMQ8j9g0BiDaNjVNVjvl+iKXxL3Jre0v31RmBYeLEmkbj2s02v8vFTbUXi5XS2Q==
+      }
+
+  '@rollup/pluginutils@5.3.0':
+    resolution:
+      {
+        integrity: sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==
+      }
+    engines: { node: '>=14.0.0' }
+    peerDependencies:
+      rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0
+    peerDependenciesMeta:
+      rollup:
+        optional: true
+
+  '@rollup/rollup-android-arm-eabi@4.52.3':
+    resolution:
+      {
+        integrity: sha512-h6cqHGZ6VdnwliFG1NXvMPTy/9PS3h8oLh7ImwR+kl+oYnQizgjxsONmmPSb2C66RksfkfIxEVtDSEcJiO0tqw==
+      }
+    cpu: [arm]
+    os: [android]
+
+  '@rollup/rollup-android-arm64@4.52.3':
+    resolution:
+      {
+        integrity: sha512-wd+u7SLT/u6knklV/ifG7gr5Qy4GUbH2hMWcDauPFJzmCZUAJ8L2bTkVXC2niOIxp8lk3iH/QX8kSrUxVZrOVw==
+      }
+    cpu: [arm64]
+    os: [android]
+
+  '@rollup/rollup-darwin-arm64@4.52.3':
+    resolution:
+      {
+        integrity: sha512-lj9ViATR1SsqycwFkJCtYfQTheBdvlWJqzqxwc9f2qrcVrQaF/gCuBRTiTolkRWS6KvNxSk4KHZWG7tDktLgjg==
+      }
+    cpu: [arm64]
+    os: [darwin]
+
+  '@rollup/rollup-darwin-x64@4.52.3':
+    resolution:
+      {
+        integrity: sha512-+Dyo7O1KUmIsbzx1l+4V4tvEVnVQqMOIYtrxK7ncLSknl1xnMHLgn7gddJVrYPNZfEB8CIi3hK8gq8bDhb3h5A==
+      }
+    cpu: [x64]
+    os: [darwin]
+
+  '@rollup/rollup-freebsd-arm64@4.52.3':
+    resolution:
+      {
+        integrity: sha512-u9Xg2FavYbD30g3DSfNhxgNrxhi6xVG4Y6i9Ur1C7xUuGDW3banRbXj+qgnIrwRN4KeJ396jchwy9bCIzbyBEQ==
+      }
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@rollup/rollup-freebsd-x64@4.52.3':
+    resolution:
+      {
+        integrity: sha512-5M8kyi/OX96wtD5qJR89a/3x5x8x5inXBZO04JWhkQb2JWavOWfjgkdvUqibGJeNNaz1/Z1PPza5/tAPXICI6A==
+      }
+    cpu: [x64]
+    os: [freebsd]
+
+  '@rollup/rollup-linux-arm-gnueabihf@4.52.3':
+    resolution:
+      {
+        integrity: sha512-IoerZJ4l1wRMopEHRKOO16e04iXRDyZFZnNZKrWeNquh5d6bucjezgd+OxG03mOMTnS1x7hilzb3uURPkJ0OfA==
+      }
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-arm-musleabihf@4.52.3':
+    resolution:
+      {
+        integrity: sha512-ZYdtqgHTDfvrJHSh3W22TvjWxwOgc3ThK/XjgcNGP2DIwFIPeAPNsQxrJO5XqleSlgDux2VAoWQ5iJrtaC1TbA==
+      }
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-arm64-gnu@4.52.3':
+    resolution:
+      {
+        integrity: sha512-NcViG7A0YtuFDA6xWSgmFb6iPFzHlf5vcqb2p0lGEbT+gjrEEz8nC/EeDHvx6mnGXnGCC1SeVV+8u+smj0CeGQ==
+      }
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-arm64-musl@4.52.3':
+    resolution:
+      {
+        integrity: sha512-d3pY7LWno6SYNXRm6Ebsq0DJGoiLXTb83AIPCXl9fmtIQs/rXoS8SJxxUNtFbJ5MiOvs+7y34np77+9l4nfFMw==
+      }
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-loong64-gnu@4.52.3':
+    resolution:
+      {
+        integrity: sha512-3y5GA0JkBuirLqmjwAKwB0keDlI6JfGYduMlJD/Rl7fvb4Ni8iKdQs1eiunMZJhwDWdCvrcqXRY++VEBbvk6Eg==
+      }
+    cpu: [loong64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-ppc64-gnu@4.52.3':
+    resolution:
+      {
+        integrity: sha512-AUUH65a0p3Q0Yfm5oD2KVgzTKgwPyp9DSXc3UA7DtxhEb/WSPfbG4wqXeSN62OG5gSo18em4xv6dbfcUGXcagw==
+      }
+    cpu: [ppc64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-riscv64-gnu@4.52.3':
+    resolution:
+      {
+        integrity: sha512-1makPhFFVBqZE+XFg3Dkq+IkQ7JvmUrwwqaYBL2CE+ZpxPaqkGaiWFEWVGyvTwZace6WLJHwjVh/+CXbKDGPmg==
+      }
+    cpu: [riscv64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-riscv64-musl@4.52.3':
+    resolution:
+      {
+        integrity: sha512-OOFJa28dxfl8kLOPMUOQBCO6z3X2SAfzIE276fwT52uXDWUS178KWq0pL7d6p1kz7pkzA0yQwtqL0dEPoVcRWg==
+      }
+    cpu: [riscv64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-linux-s390x-gnu@4.52.3':
+    resolution:
+      {
+        integrity: sha512-jMdsML2VI5l+V7cKfZx3ak+SLlJ8fKvLJ0Eoa4b9/vCUrzXKgoKxvHqvJ/mkWhFiyp88nCkM5S2v6nIwRtPcgg==
+      }
+    cpu: [s390x]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-x64-gnu@4.52.3':
+    resolution:
+      {
+        integrity: sha512-tPgGd6bY2M2LJTA1uGq8fkSPK8ZLYjDjY+ZLK9WHncCnfIz29LIXIqUgzCR0hIefzy6Hpbe8Th5WOSwTM8E7LA==
+      }
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@rollup/rollup-linux-x64-musl@4.52.3':
+    resolution:
+      {
+        integrity: sha512-BCFkJjgk+WFzP+tcSMXq77ymAPIxsX9lFJWs+2JzuZTLtksJ2o5hvgTdIcZ5+oKzUDMwI0PfWzRBYAydAHF2Mw==
+      }
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@rollup/rollup-openharmony-arm64@4.52.3':
+    resolution:
+      {
+        integrity: sha512-KTD/EqjZF3yvRaWUJdD1cW+IQBk4fbQaHYJUmP8N4XoKFZilVL8cobFSTDnjTtxWJQ3JYaMgF4nObY/+nYkumA==
+      }
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@rollup/rollup-win32-arm64-msvc@4.52.3':
+    resolution:
+      {
+        integrity: sha512-+zteHZdoUYLkyYKObGHieibUFLbttX2r+58l27XZauq0tcWYYuKUwY2wjeCN9oK1Um2YgH2ibd6cnX/wFD7DuA==
+      }
+    cpu: [arm64]
+    os: [win32]
+
+  '@rollup/rollup-win32-ia32-msvc@4.52.3':
+    resolution:
+      {
+        integrity: sha512-of1iHkTQSo3kr6dTIRX6t81uj/c/b15HXVsPcEElN5sS859qHrOepM5p9G41Hah+CTqSh2r8Bm56dL2z9UQQ7g==
+      }
+    cpu: [ia32]
+    os: [win32]
+
+  '@rollup/rollup-win32-x64-gnu@4.52.3':
+    resolution:
+      {
+        integrity: sha512-s0hybmlHb56mWVZQj8ra9048/WZTPLILKxcvcq+8awSZmyiSUZjjem1AhU3Tf4ZKpYhK4mg36HtHDOe8QJS5PQ==
+      }
+    cpu: [x64]
+    os: [win32]
+
+  '@rollup/rollup-win32-x64-msvc@4.52.3':
+    resolution:
+      {
+        integrity: sha512-zGIbEVVXVtauFgl3MRwGWEN36P5ZGenHRMgNw88X5wEhEBpq0XrMEZwOn07+ICrwM17XO5xfMZqh0OldCH5VTA==
+      }
+    cpu: [x64]
+    os: [win32]
+
+  '@sec-ant/readable-stream@0.4.1':
+    resolution:
+      {
+        integrity: sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg==
+      }
+
+  '@sindresorhus/merge-streams@4.0.0':
+    resolution:
+      {
+        integrity: sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==
+      }
+    engines: { node: '>=18' }
+
+  '@sxzz/popperjs-es@2.11.7':
+    resolution:
+      {
+        integrity: sha512-Ccy0NlLkzr0Ex2FKvh2X+OyERHXJ88XJ1MXtsI9y9fGexlaXaVTPzBCRBwIxFkORuOb+uBqeu+RqnpgYTEZRUQ==
+      }
+
+  '@tailwindcss/node@4.1.14':
+    resolution:
+      {
+        integrity: sha512-hpz+8vFk3Ic2xssIA3e01R6jkmsAhvkQdXlEbRTk6S10xDAtiQiM3FyvZVGsucefq764euO/b8WUW9ysLdThHw==
+      }
+
+  '@tailwindcss/oxide-android-arm64@4.1.14':
+    resolution:
+      {
+        integrity: sha512-a94ifZrGwMvbdeAxWoSuGcIl6/DOP5cdxagid7xJv6bwFp3oebp7y2ImYsnZBMTwjn5Ev5xESvS3FFYUGgPODQ==
+      }
+    engines: { node: '>= 10' }
+    cpu: [arm64]
+    os: [android]
+
+  '@tailwindcss/oxide-darwin-arm64@4.1.14':
+    resolution:
+      {
+        integrity: sha512-HkFP/CqfSh09xCnrPJA7jud7hij5ahKyWomrC3oiO2U9i0UjP17o9pJbxUN0IJ471GTQQmzwhp0DEcpbp4MZTA==
+      }
+    engines: { node: '>= 10' }
+    cpu: [arm64]
+    os: [darwin]
+
+  '@tailwindcss/oxide-darwin-x64@4.1.14':
+    resolution:
+      {
+        integrity: sha512-eVNaWmCgdLf5iv6Qd3s7JI5SEFBFRtfm6W0mphJYXgvnDEAZ5sZzqmI06bK6xo0IErDHdTA5/t7d4eTfWbWOFw==
+      }
+    engines: { node: '>= 10' }
+    cpu: [x64]
+    os: [darwin]
+
+  '@tailwindcss/oxide-freebsd-x64@4.1.14':
+    resolution:
+      {
+        integrity: sha512-QWLoRXNikEuqtNb0dhQN6wsSVVjX6dmUFzuuiL09ZeXju25dsei2uIPl71y2Ic6QbNBsB4scwBoFnlBfabHkEw==
+      }
+    engines: { node: '>= 10' }
+    cpu: [x64]
+    os: [freebsd]
+
+  '@tailwindcss/oxide-linux-arm-gnueabihf@4.1.14':
+    resolution:
+      {
+        integrity: sha512-VB4gjQni9+F0VCASU+L8zSIyjrLLsy03sjcR3bM0V2g4SNamo0FakZFKyUQ96ZVwGK4CaJsc9zd/obQy74o0Fw==
+      }
+    engines: { node: '>= 10' }
+    cpu: [arm]
+    os: [linux]
+
+  '@tailwindcss/oxide-linux-arm64-gnu@4.1.14':
+    resolution:
+      {
+        integrity: sha512-qaEy0dIZ6d9vyLnmeg24yzA8XuEAD9WjpM5nIM1sUgQ/Zv7cVkharPDQcmm/t/TvXoKo/0knI3me3AGfdx6w1w==
+      }
+    engines: { node: '>= 10' }
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@tailwindcss/oxide-linux-arm64-musl@4.1.14':
+    resolution:
+      {
+        integrity: sha512-ISZjT44s59O8xKsPEIesiIydMG/sCXoMBCqsphDm/WcbnuWLxxb+GcvSIIA5NjUw6F8Tex7s5/LM2yDy8RqYBQ==
+      }
+    engines: { node: '>= 10' }
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@tailwindcss/oxide-linux-x64-gnu@4.1.14':
+    resolution:
+      {
+        integrity: sha512-02c6JhLPJj10L2caH4U0zF8Hji4dOeahmuMl23stk0MU1wfd1OraE7rOloidSF8W5JTHkFdVo/O7uRUJJnUAJg==
+      }
+    engines: { node: '>= 10' }
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@tailwindcss/oxide-linux-x64-musl@4.1.14':
+    resolution:
+      {
+        integrity: sha512-TNGeLiN1XS66kQhxHG/7wMeQDOoL0S33x9BgmydbrWAb9Qw0KYdd8o1ifx4HOGDWhVmJ+Ul+JQ7lyknQFilO3Q==
+      }
+    engines: { node: '>= 10' }
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@tailwindcss/oxide-wasm32-wasi@4.1.14':
+    resolution:
+      {
+        integrity: sha512-uZYAsaW/jS/IYkd6EWPJKW/NlPNSkWkBlaeVBi/WsFQNP05/bzkebUL8FH1pdsqx4f2fH/bWFcUABOM9nfiJkQ==
+      }
+    engines: { node: '>=14.0.0' }
+    cpu: [wasm32]
+    bundledDependencies:
+      - '@napi-rs/wasm-runtime'
+      - '@emnapi/core'
+      - '@emnapi/runtime'
+      - '@tybys/wasm-util'
+      - '@emnapi/wasi-threads'
+      - tslib
+
+  '@tailwindcss/oxide-win32-arm64-msvc@4.1.14':
+    resolution:
+      {
+        integrity: sha512-Az0RnnkcvRqsuoLH2Z4n3JfAef0wElgzHD5Aky/e+0tBUxUhIeIqFBTMNQvmMRSP15fWwmvjBxZ3Q8RhsDnxAA==
+      }
+    engines: { node: '>= 10' }
+    cpu: [arm64]
+    os: [win32]
+
+  '@tailwindcss/oxide-win32-x64-msvc@4.1.14':
+    resolution:
+      {
+        integrity: sha512-ttblVGHgf68kEE4om1n/n44I0yGPkCPbLsqzjvybhpwa6mKKtgFfAzy6btc3HRmuW7nHe0OOrSeNP9sQmmH9XA==
+      }
+    engines: { node: '>= 10' }
+    cpu: [x64]
+    os: [win32]
+
+  '@tailwindcss/oxide@4.1.14':
+    resolution:
+      {
+        integrity: sha512-23yx+VUbBwCg2x5XWdB8+1lkPajzLmALEfMb51zZUBYaYVPDQvBSD/WYDqiVyBIo2BZFa3yw1Rpy3G2Jp+K0dw==
+      }
+    engines: { node: '>= 10' }
+
+  '@tailwindcss/vite@4.1.14':
+    resolution:
+      {
+        integrity: sha512-BoFUoU0XqgCUS1UXWhmDJroKKhNXeDzD7/XwabjkDIAbMnc4ULn5e2FuEuBbhZ6ENZoSYzKlzvZ44Yr6EUDUSA==
+      }
+    peerDependencies:
+      vite: ^5.2.0 || ^6 || ^7
+
+  '@transloadit/prettier-bytes@0.0.7':
+    resolution:
+      {
+        integrity: sha512-VeJbUb0wEKbcwaSlj5n+LscBl9IPgLPkHVGBkh00cztv6X4L/TJXK58LzFuBKX7/GAfiGhIwH67YTLTlzvIzBA==
+      }
+
+  '@types/conventional-commits-parser@5.0.1':
+    resolution:
+      {
+        integrity: sha512-7uz5EHdzz2TqoMfV7ee61Egf5y6NkcO4FB/1iCCQnbeiI1F3xzv3vK5dBCXUCLQgGYS+mUeigK1iKQzvED+QnQ==
+      }
+
+  '@types/estree@1.0.8':
+    resolution:
+      {
+        integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==
+      }
+
+  '@types/event-emitter@0.3.5':
+    resolution:
+      {
+        integrity: sha512-zx2/Gg0Eg7gwEiOIIh5w9TrhKKTeQh7CPCOPNc0el4pLSwzebA8SmnHwZs2dWlLONvyulykSwGSQxQHLhjGLvQ==
+      }
+
+  '@types/json-schema@7.0.15':
+    resolution:
+      {
+        integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==
+      }
+
+  '@types/lodash-es@4.17.12':
+    resolution:
+      {
+        integrity: sha512-0NgftHUcV4v34VhXm8QBSftKVXtbkBG3ViCjs6+eJ5a6y6Mi/jiFGPc1sC7QK+9BFhWrURE3EOggmWaSxL9OzQ==
+      }
+
+  '@types/lodash@4.17.20':
+    resolution:
+      {
+        integrity: sha512-H3MHACvFUEiujabxhaI/ImO6gUrd8oOurg7LQtS7mbwIXA/cUqWrvBsaeJ23aZEPk1TAYkurjfMbSELfoCXlGA==
+      }
+
+  '@types/node@24.8.1':
+    resolution:
+      {
+        integrity: sha512-alv65KGRadQVfVcG69MuB4IzdYVpRwMG/mq8KWOaoOdyY617P5ivaDiMCGOFDWD2sAn5Q0mR3mRtUOgm99hL9Q==
+      }
+
+  '@types/sortablejs@1.15.8':
+    resolution:
+      {
+        integrity: sha512-b79830lW+RZfwaztgs1aVPgbasJ8e7AXtZYHTELNXZPsERt4ymJdjV4OccDbHQAvHrCcFpbF78jkm0R6h/pZVg==
+      }
+
+  '@types/web-bluetooth@0.0.16':
+    resolution:
+      {
+        integrity: sha512-oh8q2Zc32S6gd/j50GowEjKLoOVOwHP/bWVjKJInBwQqdOYMdPrf1oVlelTlyfFK3CKxL1uahMDAr+vy8T7yMQ==
+      }
+
+  '@types/web-bluetooth@0.0.21':
+    resolution:
+      {
+        integrity: sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==
+      }
+
+  '@typescript-eslint/eslint-plugin@8.44.1':
+    resolution:
+      {
+        integrity: sha512-molgphGqOBT7t4YKCSkbasmu1tb1MgrZ2szGzHbclF7PNmOkSTQVHy+2jXOSnxvR3+Xe1yySHFZoqMpz3TfQsw==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      '@typescript-eslint/parser': ^8.44.1
+      eslint: ^8.57.0 || ^9.0.0
+      typescript: '>=4.8.4 <6.0.0'
+
+  '@typescript-eslint/parser@8.44.1':
+    resolution:
+      {
+        integrity: sha512-EHrrEsyhOhxYt8MTg4zTF+DJMuNBzWwgvvOYNj/zm1vnaD/IC5zCXFehZv94Piqa2cRFfXrTFxIvO95L7Qc/cw==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      eslint: ^8.57.0 || ^9.0.0
+      typescript: '>=4.8.4 <6.0.0'
+
+  '@typescript-eslint/project-service@8.44.1':
+    resolution:
+      {
+        integrity: sha512-ycSa60eGg8GWAkVsKV4E6Nz33h+HjTXbsDT4FILyL8Obk5/mx4tbvCNsLf9zret3ipSumAOG89UcCs/KRaKYrA==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      typescript: '>=4.8.4 <6.0.0'
+
+  '@typescript-eslint/scope-manager@8.44.1':
+    resolution:
+      {
+        integrity: sha512-NdhWHgmynpSvyhchGLXh+w12OMT308Gm25JoRIyTZqEbApiBiQHD/8xgb6LqCWCFcxFtWwaVdFsLPQI3jvhywg==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@typescript-eslint/tsconfig-utils@8.44.1':
+    resolution:
+      {
+        integrity: sha512-B5OyACouEjuIvof3o86lRMvyDsFwZm+4fBOqFHccIctYgBjqR3qT39FBYGN87khcgf0ExpdCBeGKpKRhSFTjKQ==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      typescript: '>=4.8.4 <6.0.0'
+
+  '@typescript-eslint/type-utils@8.44.1':
+    resolution:
+      {
+        integrity: sha512-KdEerZqHWXsRNKjF9NYswNISnFzXfXNDfPxoTh7tqohU/PRIbwTmsjGK6V9/RTYWau7NZvfo52lgVk+sJh0K3g==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      eslint: ^8.57.0 || ^9.0.0
+      typescript: '>=4.8.4 <6.0.0'
+
+  '@typescript-eslint/types@8.44.1':
+    resolution:
+      {
+        integrity: sha512-Lk7uj7y9uQUOEguiDIDLYLJOrYHQa7oBiURYVFqIpGxclAFQ78f6VUOM8lI2XEuNOKNB7XuvM2+2cMXAoq4ALQ==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@typescript-eslint/typescript-estree@8.44.1':
+    resolution:
+      {
+        integrity: sha512-qnQJ+mVa7szevdEyvfItbO5Vo+GfZ4/GZWWDRRLjrxYPkhM+6zYB2vRYwCsoJLzqFCdZT4mEqyJoyzkunsZ96A==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      typescript: '>=4.8.4 <6.0.0'
+
+  '@typescript-eslint/utils@8.44.1':
+    resolution:
+      {
+        integrity: sha512-DpX5Fp6edTlocMCwA+mHY8Mra+pPjRZ0TfHkXI8QFelIKcbADQz1LUPNtzOFUriBB2UYqw4Pi9+xV4w9ZczHFg==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      eslint: ^8.57.0 || ^9.0.0
+      typescript: '>=4.8.4 <6.0.0'
+
+  '@typescript-eslint/visitor-keys@8.44.1':
+    resolution:
+      {
+        integrity: sha512-576+u0QD+Jp3tZzvfRfxon0EA2lzcDt3lhUbsC6Lgzy9x2VR4E+JUiNyGHi5T8vk0TV+fpJ5GLG1JsJuWCaKhw==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  '@uppy/companion-client@2.2.2':
+    resolution:
+      {
+        integrity: sha512-5mTp2iq97/mYSisMaBtFRry6PTgZA6SIL7LePteOV5x0/DxKfrZW3DEiQERJmYpHzy7k8johpm2gHnEKto56Og==
+      }
+
+  '@uppy/core@2.3.4':
+    resolution:
+      {
+        integrity: sha512-iWAqppC8FD8mMVqewavCz+TNaet6HPXitmGXpGGREGrakZ4FeuWytVdrelydzTdXx6vVKkOmI2FLztGg73sENQ==
+      }
+
+  '@uppy/store-default@2.1.1':
+    resolution:
+      {
+        integrity: sha512-xnpTxvot2SeAwGwbvmJ899ASk5tYXhmZzD/aCFsXePh/v8rNvR2pKlcQUH7cF/y4baUGq3FHO/daKCok/mpKqQ==
+      }
+
+  '@uppy/utils@4.1.3':
+    resolution:
+      {
+        integrity: sha512-nTuMvwWYobnJcytDO3t+D6IkVq/Qs4Xv3vyoEZ+Iaf8gegZP+rEyoaFT2CK5XLRMienPyqRqNbIfRuFaOWSIFw==
+      }
+
+  '@uppy/xhr-upload@2.1.3':
+    resolution:
+      {
+        integrity: sha512-YWOQ6myBVPs+mhNjfdWsQyMRWUlrDLMoaG7nvf/G6Y3GKZf8AyjFDjvvJ49XWQ+DaZOftGkHmF1uh/DBeGivJQ==
+      }
+    peerDependencies:
+      '@uppy/core': ^2.3.3
+
+  '@vitejs/plugin-vue@6.0.1':
+    resolution:
+      {
+        integrity: sha512-+MaE752hU0wfPFJEUAIxqw18+20euHHdxVtMvbFcOEpjEyfqXH/5DCoTHiVJ0J29EhTJdoTkjEv5YBKU9dnoTw==
+      }
+    engines: { node: ^20.19.0 || >=22.12.0 }
+    peerDependencies:
+      vite: ^5.0.0 || ^6.0.0 || ^7.0.0
+      vue: ^3.2.25
+
+  '@volar/language-core@2.4.23':
+    resolution:
+      {
+        integrity: sha512-hEEd5ET/oSmBC6pi1j6NaNYRWoAiDhINbT8rmwtINugR39loROSlufGdYMF9TaKGfz+ViGs1Idi3mAhnuPcoGQ==
+      }
+
+  '@volar/source-map@2.4.23':
+    resolution:
+      {
+        integrity: sha512-Z1Uc8IB57Lm6k7q6KIDu/p+JWtf3xsXJqAX/5r18hYOTpJyBn0KXUR8oTJ4WFYOcDzWC9n3IflGgHowx6U6z9Q==
+      }
+
+  '@volar/typescript@2.4.23':
+    resolution:
+      {
+        integrity: sha512-lAB5zJghWxVPqfcStmAP1ZqQacMpe90UrP5RJ3arDyrhy4aCUQqmxPPLB2PWDKugvylmO41ljK7vZ+t6INMTag==
+      }
+
+  '@vue/babel-helper-vue-transform-on@1.5.0':
+    resolution:
+      {
+        integrity: sha512-0dAYkerNhhHutHZ34JtTl2czVQHUNWv6xEbkdF5W+Yrv5pCWsqjeORdOgbtW2I9gWlt+wBmVn+ttqN9ZxR5tzA==
+      }
+
+  '@vue/babel-plugin-jsx@1.5.0':
+    resolution:
+      {
+        integrity: sha512-mneBhw1oOqCd2247O0Yw/mRwC9jIGACAJUlawkmMBiNmL4dGA2eMzuNZVNqOUfYTa6vqmND4CtOPzmEEEqLKFw==
+      }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+    peerDependenciesMeta:
+      '@babel/core':
+        optional: true
+
+  '@vue/babel-plugin-resolve-type@1.5.0':
+    resolution:
+      {
+        integrity: sha512-Wm/60o+53JwJODm4Knz47dxJnLDJ9FnKnGZJbUUf8nQRAtt6P+undLUAVU3Ha33LxOJe6IPoifRQ6F/0RrU31w==
+      }
+    peerDependencies:
+      '@babel/core': ^7.0.0-0
+
+  '@vue/compiler-core@3.5.22':
+    resolution:
+      {
+        integrity: sha512-jQ0pFPmZwTEiRNSb+i9Ow/I/cHv2tXYqsnHKKyCQ08irI2kdF5qmYedmF8si8mA7zepUFmJ2hqzS8CQmNOWOkQ==
+      }
+
+  '@vue/compiler-dom@3.5.22':
+    resolution:
+      {
+        integrity: sha512-W8RknzUM1BLkypvdz10OVsGxnMAuSIZs9Wdx1vzA3mL5fNMN15rhrSCLiTm6blWeACwUwizzPVqGJgOGBEN/hA==
+      }
+
+  '@vue/compiler-sfc@3.5.22':
+    resolution:
+      {
+        integrity: sha512-tbTR1zKGce4Lj+JLzFXDq36K4vcSZbJ1RBu8FxcDv1IGRz//Dh2EBqksyGVypz3kXpshIfWKGOCcqpSbyGWRJQ==
+      }
+
+  '@vue/compiler-ssr@3.5.22':
+    resolution:
+      {
+        integrity: sha512-GdgyLvg4R+7T8Nk2Mlighx7XGxq/fJf9jaVofc3IL0EPesTE86cP/8DD1lT3h1JeZr2ySBvyqKQJgbS54IX1Ww==
+      }
+
+  '@vue/compiler-vue2@2.7.16':
+    resolution:
+      {
+        integrity: sha512-qYC3Psj9S/mfu9uVi5WvNZIzq+xnXMhOwbTFKKDD7b1lhpnn71jXSFdTQ+WsIEk0ONCd7VV2IMm7ONl6tbQ86A==
+      }
+
+  '@vue/devtools-api@6.6.4':
+    resolution:
+      {
+        integrity: sha512-sGhTPMuXqZ1rVOk32RylztWkfXTRhuS7vgAKv0zjqk8gbsHkJ7xfFf+jbySxt7tWObEJwyKaHMikV/WGDiQm8g==
+      }
+
+  '@vue/devtools-api@7.7.7':
+    resolution:
+      {
+        integrity: sha512-lwOnNBH2e7x1fIIbVT7yF5D+YWhqELm55/4ZKf45R9T8r9dE2AIOy8HKjfqzGsoTHFbWbr337O4E0A0QADnjBg==
+      }
+
+  '@vue/devtools-core@7.7.7':
+    resolution:
+      {
+        integrity: sha512-9z9TLbfC+AjAi1PQyWX+OErjIaJmdFlbDHcD+cAMYKY6Bh5VlsAtCeGyRMrXwIlMEQPukvnWt3gZBLwTAIMKzQ==
+      }
+    peerDependencies:
+      vue: ^3.0.0
+
+  '@vue/devtools-kit@7.7.7':
+    resolution:
+      {
+        integrity: sha512-wgoZtxcTta65cnZ1Q6MbAfePVFxfM+gq0saaeytoph7nEa7yMXoi6sCPy4ufO111B9msnw0VOWjPEFCXuAKRHA==
+      }
+
+  '@vue/devtools-shared@7.7.7':
+    resolution:
+      {
+        integrity: sha512-+udSj47aRl5aKb0memBvcUG9koarqnxNM5yjuREvqwK6T3ap4mn3Zqqc17QrBFTqSMjr3HK1cvStEZpMDpfdyw==
+      }
+
+  '@vue/language-core@2.1.10':
+    resolution:
+      {
+        integrity: sha512-DAI289d0K3AB5TUG3xDp9OuQ71CnrujQwJrQnfuZDwo6eGNf0UoRlPuaVNO+Zrn65PC3j0oB2i7mNmVPggeGeQ==
+      }
+    peerDependencies:
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  '@vue/reactivity@3.5.22':
+    resolution:
+      {
+        integrity: sha512-f2Wux4v/Z2pqc9+4SmgZC1p73Z53fyD90NFWXiX9AKVnVBEvLFOWCEgJD3GdGnlxPZt01PSlfmLqbLYzY/Fw4A==
+      }
+
+  '@vue/runtime-core@3.5.22':
+    resolution:
+      {
+        integrity: sha512-EHo4W/eiYeAzRTN5PCextDUZ0dMs9I8mQ2Fy+OkzvRPUYQEyK9yAjbasrMCXbLNhF7P0OUyivLjIy0yc6VrLJQ==
+      }
+
+  '@vue/runtime-dom@3.5.22':
+    resolution:
+      {
+        integrity: sha512-Av60jsryAkI023PlN7LsqrfPvwfxOd2yAwtReCjeuugTJTkgrksYJJstg1e12qle0NarkfhfFu1ox2D+cQotww==
+      }
+
+  '@vue/server-renderer@3.5.22':
+    resolution:
+      {
+        integrity: sha512-gXjo+ao0oHYTSswF+a3KRHZ1WszxIqO7u6XwNHqcqb9JfyIL/pbWrrh/xLv7jeDqla9u+LK7yfZKHih1e1RKAQ==
+      }
+    peerDependencies:
+      vue: 3.5.22
+
+  '@vue/shared@3.5.22':
+    resolution:
+      {
+        integrity: sha512-F4yc6palwq3TT0u+FYf0Ns4Tfl9GRFURDN2gWG7L1ecIaS/4fCIuFOjMTnCyjsu/OK6vaDKLCrGAa+KvvH+h4w==
+      }
+
+  '@vueuse/core@13.9.0':
+    resolution:
+      {
+        integrity: sha512-ts3regBQyURfCE2BcytLqzm8+MmLlo5Ln/KLoxDVcsZ2gzIwVNnQpQOL/UKV8alUqjSZOlpFZcRNsLRqj+OzyA==
+      }
+    peerDependencies:
+      vue: ^3.5.0
+
+  '@vueuse/core@9.13.0':
+    resolution:
+      {
+        integrity: sha512-pujnclbeHWxxPRqXWmdkKV5OX4Wk4YeK7wusHqRwU0Q7EFusHoqNA/aPhB6KCh9hEqJkLAJo7bb0Lh9b+OIVzw==
+      }
+
+  '@vueuse/metadata@13.9.0':
+    resolution:
+      {
+        integrity: sha512-1AFRvuiGphfF7yWixZa0KwjYH8ulyjDCC0aFgrGRz8+P4kvDFSdXLVfTk5xAN9wEuD1J6z4/myMoYbnHoX07zg==
+      }
+
+  '@vueuse/metadata@9.13.0':
+    resolution:
+      {
+        integrity: sha512-gdU7TKNAUVlXXLbaF+ZCfte8BjRJQWPCa2J55+7/h+yDtzw3vOoGQDRXzI6pyKyo6bXFT5/QoPE4hAknExjRLQ==
+      }
+
+  '@vueuse/shared@13.9.0':
+    resolution:
+      {
+        integrity: sha512-e89uuTLMh0U5cZ9iDpEI2senqPGfbPRTHM/0AaQkcxnpqjkZqDYP8rpfm7edOz8s+pOCOROEy1PIveSW8+fL5g==
+      }
+    peerDependencies:
+      vue: ^3.5.0
+
+  '@vueuse/shared@9.13.0':
+    resolution:
+      {
+        integrity: sha512-UrnhU+Cnufu4S6JLCPZnkWh0WwZGUp72ktOF2DFptMlOs3TOdVv8xJN53zhHGARmVOsz5KqOls09+J1NR6sBKw==
+      }
+
+  '@wangeditor/basic-modules@1.1.7':
+    resolution:
+      {
+        integrity: sha512-cY9CPkLJaqF05STqfpZKWG4LpxTMeGSIIF1fHvfm/mz+JXatCagjdkbxdikOuKYlxDdeqvOeBmsUBItufDLXZg==
+      }
+    peerDependencies:
+      '@wangeditor/core': 1.x
+      dom7: ^3.0.0
+      lodash.throttle: ^4.1.1
+      nanoid: ^3.2.0
+      slate: ^0.72.0
+      snabbdom: ^3.1.0
+
+  '@wangeditor/code-highlight@1.0.3':
+    resolution:
+      {
+        integrity: sha512-iazHwO14XpCuIWJNTQTikqUhGKyqj+dUNWJ9288Oym9M2xMVHvnsOmDU2sgUDWVy+pOLojReMPgXCsvvNlOOhw==
+      }
+    peerDependencies:
+      '@wangeditor/core': 1.x
+      dom7: ^3.0.0
+      slate: ^0.72.0
+      snabbdom: ^3.1.0
+
+  '@wangeditor/core@1.1.19':
+    resolution:
+      {
+        integrity: sha512-KevkB47+7GhVszyYF2pKGKtCSj/YzmClsD03C3zTt+9SR2XWT5T0e3yQqg8baZpcMvkjs1D8Dv4fk8ok/UaS2Q==
+      }
+    peerDependencies:
+      '@uppy/core': ^2.1.1
+      '@uppy/xhr-upload': ^2.0.3
+      dom7: ^3.0.0
+      is-hotkey: ^0.2.0
+      lodash.camelcase: ^4.3.0
+      lodash.clonedeep: ^4.5.0
+      lodash.debounce: ^4.0.8
+      lodash.foreach: ^4.5.0
+      lodash.isequal: ^4.5.0
+      lodash.throttle: ^4.1.1
+      lodash.toarray: ^4.4.0
+      nanoid: ^3.2.0
+      slate: ^0.72.0
+      snabbdom: ^3.1.0
+
+  '@wangeditor/editor-for-vue@5.1.12':
+    resolution:
+      {
+        integrity: sha512-0Ds3D8I+xnpNWezAeO7HmPRgTfUxHLMd9JKcIw+QzvSmhC5xUHbpCcLU+KLmeBKTR/zffnS5GQo6qi3GhTMJWQ==
+      }
+    peerDependencies:
+      '@wangeditor/editor': '>=5.1.0'
+      vue: ^3.0.5
+
+  '@wangeditor/editor@5.1.23':
+    resolution:
+      {
+        integrity: sha512-0RxfeVTuK1tktUaPROnCoFfaHVJpRAIE2zdS0mpP+vq1axVQpLjM8+fCvKzqYIkH0Pg+C+44hJpe3VVroSkEuQ==
+      }
+
+  '@wangeditor/list-module@1.0.5':
+    resolution:
+      {
+        integrity: sha512-uDuYTP6DVhcYf7mF1pTlmNn5jOb4QtcVhYwSSAkyg09zqxI1qBqsfUnveeDeDqIuptSJhkh81cyxi+MF8sEPOQ==
+      }
+    peerDependencies:
+      '@wangeditor/core': 1.x
+      dom7: ^3.0.0
+      slate: ^0.72.0
+      snabbdom: ^3.1.0
+
+  '@wangeditor/table-module@1.1.4':
+    resolution:
+      {
+        integrity: sha512-5saanU9xuEocxaemGdNi9t8MCDSucnykEC6jtuiT72kt+/Hhh4nERYx1J20OPsTCCdVr7hIyQenFD1iSRkIQ6w==
+      }
+    peerDependencies:
+      '@wangeditor/core': 1.x
+      dom7: ^3.0.0
+      lodash.isequal: ^4.5.0
+      lodash.throttle: ^4.1.1
+      nanoid: ^3.2.0
+      slate: ^0.72.0
+      snabbdom: ^3.1.0
+
+  '@wangeditor/upload-image-module@1.0.2':
+    resolution:
+      {
+        integrity: sha512-z81lk/v71OwPDYeQDxj6cVr81aDP90aFuywb8nPD6eQeECtOymrqRODjpO6VGvCVxVck8nUxBHtbxKtjgcwyiA==
+      }
+    peerDependencies:
+      '@uppy/core': ^2.0.3
+      '@uppy/xhr-upload': ^2.0.3
+      '@wangeditor/basic-modules': 1.x
+      '@wangeditor/core': 1.x
+      dom7: ^3.0.0
+      lodash.foreach: ^4.5.0
+      slate: ^0.72.0
+      snabbdom: ^3.1.0
+
+  '@wangeditor/video-module@1.1.4':
+    resolution:
+      {
+        integrity: sha512-ZdodDPqKQrgx3IwWu4ZiQmXI8EXZ3hm2/fM6E3t5dB8tCaIGWQZhmqd6P5knfkRAd3z2+YRSRbxOGfoRSp/rLg==
+      }
+    peerDependencies:
+      '@uppy/core': ^2.1.4
+      '@uppy/xhr-upload': ^2.0.7
+      '@wangeditor/core': 1.x
+      dom7: ^3.0.0
+      nanoid: ^3.2.0
+      slate: ^0.72.0
+      snabbdom: ^3.1.0
+
+  JSONStream@1.3.5:
+    resolution:
+      {
+        integrity: sha512-E+iruNOY8VV9s4JEbe1aNEm6MiszPRr/UfcHMz0TQh1BXSxHK+ASV1R6W4HpjBhSeS+54PIsAMCBmwD06LLsqQ==
+      }
+    hasBin: true
+
+  acorn-jsx@5.3.2:
+    resolution:
+      {
+        integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==
+      }
+    peerDependencies:
+      acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+  acorn@8.15.0:
+    resolution:
+      {
+        integrity: sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==
+      }
+    engines: { node: '>=0.4.0' }
+    hasBin: true
+
+  adler-32@1.3.1:
+    resolution:
+      {
+        integrity: sha512-ynZ4w/nUUv5rrsR8UUGoe1VC9hZj6V5hU9Qw1HlMDJGEJw5S7TfTErWTjMys6M7vr0YWcPqs3qAr4ss0nDfP+A==
+      }
+    engines: { node: '>=0.8' }
+
+  ajv@6.12.6:
+    resolution:
+      {
+        integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==
+      }
+
+  ajv@8.17.1:
+    resolution:
+      {
+        integrity: sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==
+      }
+
+  alien-signals@0.2.2:
+    resolution:
+      {
+        integrity: sha512-cZIRkbERILsBOXTQmMrxc9hgpxglstn69zm+F1ARf4aPAzdAFYd6sBq87ErO0Fj3DV94tglcyHG5kQz9nDC/8A==
+      }
+
+  ansi-escapes@4.3.2:
+    resolution:
+      {
+        integrity: sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==
+      }
+    engines: { node: '>=8' }
+
+  ansi-escapes@7.1.1:
+    resolution:
+      {
+        integrity: sha512-Zhl0ErHcSRUaVfGUeUdDuLgpkEo8KIFjB4Y9uAc46ScOpdDiU1Dbyplh7qWJeJ/ZHpbyMSM26+X3BySgnIz40Q==
+      }
+    engines: { node: '>=18' }
+
+  ansi-regex@5.0.1:
+    resolution:
+      {
+        integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==
+      }
+    engines: { node: '>=8' }
+
+  ansi-regex@6.2.2:
+    resolution:
+      {
+        integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==
+      }
+    engines: { node: '>=12' }
+
+  ansi-styles@3.2.1:
+    resolution:
+      {
+        integrity: sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==
+      }
+    engines: { node: '>=4' }
+
+  ansi-styles@4.3.0:
+    resolution:
+      {
+        integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==
+      }
+    engines: { node: '>=8' }
+
+  ansi-styles@6.2.3:
+    resolution:
+      {
+        integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==
+      }
+    engines: { node: '>=12' }
+
+  anymatch@3.1.3:
+    resolution:
+      {
+        integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==
+      }
+    engines: { node: '>= 8' }
+
+  argparse@2.0.1:
+    resolution:
+      {
+        integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==
+      }
+
+  array-ify@1.0.0:
+    resolution:
+      {
+        integrity: sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng==
+      }
+
+  array-union@2.1.0:
+    resolution:
+      {
+        integrity: sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==
+      }
+    engines: { node: '>=8' }
+
+  astral-regex@2.0.0:
+    resolution:
+      {
+        integrity: sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==
+      }
+    engines: { node: '>=8' }
+
+  async-validator@4.2.5:
+    resolution:
+      {
+        integrity: sha512-7HhHjtERjqlNbZtqNqy2rckN/SpOOlmDliet+lP7k+eKZEjPk3DgyeU9lIXLdeLz0uBbbVp+9Qdow9wJWgwwfg==
+      }
+
+  asynckit@0.4.0:
+    resolution:
+      {
+        integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==
+      }
+
+  at-least-node@1.0.0:
+    resolution:
+      {
+        integrity: sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==
+      }
+    engines: { node: '>= 4.0.0' }
+
+  axios@1.12.2:
+    resolution:
+      {
+        integrity: sha512-vMJzPewAlRyOgxV2dU0Cuz2O8zzzx9VYtbJOaBgXFeLc4IV/Eg50n4LowmehOOR61S8ZMpc2K5Sa7g6A4jfkUw==
+      }
+
+  balanced-match@1.0.2:
+    resolution:
+      {
+        integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==
+      }
+
+  balanced-match@2.0.0:
+    resolution:
+      {
+        integrity: sha512-1ugUSr8BHXRnK23KfuYS+gVMC3LB8QGH9W1iGtDPsNWoQbgtXSExkBu2aDR4epiGWZOjZsj6lDl/N/AqqTC3UA==
+      }
+
+  base64-js@1.5.1:
+    resolution:
+      {
+        integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==
+      }
+
+  baseline-browser-mapping@2.8.8:
+    resolution:
+      {
+        integrity: sha512-be0PUaPsQX/gPWWgFsdD+GFzaoig5PXaUC1xLkQiYdDnANU8sMnHoQd8JhbJQuvTWrWLyeFN9Imb5Qtfvr4RrQ==
+      }
+    hasBin: true
+
+  binary-extensions@2.3.0:
+    resolution:
+      {
+        integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==
+      }
+    engines: { node: '>=8' }
+
+  birpc@2.6.1:
+    resolution:
+      {
+        integrity: sha512-LPnFhlDpdSH6FJhJyn4M0kFO7vtQ5iPw24FnG0y21q09xC7e8+1LeR31S1MAIrDAHp4m7aas4bEkTDTvMAtebQ==
+      }
+
+  bl@4.1.0:
+    resolution:
+      {
+        integrity: sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==
+      }
+
+  boolbase@1.0.0:
+    resolution:
+      {
+        integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==
+      }
+
+  brace-expansion@1.1.12:
+    resolution:
+      {
+        integrity: sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==
+      }
+
+  brace-expansion@2.0.2:
+    resolution:
+      {
+        integrity: sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==
+      }
+
+  braces@3.0.3:
+    resolution:
+      {
+        integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==
+      }
+    engines: { node: '>=8' }
+
+  browserslist@4.26.2:
+    resolution:
+      {
+        integrity: sha512-ECFzp6uFOSB+dcZ5BK/IBaGWssbSYBHvuMeMt3MMFyhI0Z8SqGgEkBLARgpRH3hutIgPVsALcMwbDrJqPxQ65A==
+      }
+    engines: { node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7 }
+    hasBin: true
+
+  buffer-from@1.1.2:
+    resolution:
+      {
+        integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==
+      }
+
+  buffer@5.7.1:
+    resolution:
+      {
+        integrity: sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==
+      }
+
+  bundle-name@4.1.0:
+    resolution:
+      {
+        integrity: sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==
+      }
+    engines: { node: '>=18' }
+
+  cacheable@2.0.2:
+    resolution:
+      {
+        integrity: sha512-dWjhLx8RWnPsAWVKwW/wI6OJpQ/hSVb1qS0NUif8TR9vRiSwci7Gey8x04kRU9iAF+Rnbtex5Kjjfg/aB5w8Pg==
+      }
+
+  cachedir@2.3.0:
+    resolution:
+      {
+        integrity: sha512-A+Fezp4zxnit6FanDmv9EqXNAi3vt9DWp51/71UEhXukb7QUuvtv9344h91dyAxuTLoSYJFU299qzR3tzwPAhw==
+      }
+    engines: { node: '>=6' }
+
+  call-bind-apply-helpers@1.0.2:
+    resolution:
+      {
+        integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==
+      }
+    engines: { node: '>= 0.4' }
+
+  callsites@3.1.0:
+    resolution:
+      {
+        integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==
+      }
+    engines: { node: '>=6' }
+
+  caniuse-lite@1.0.30001745:
+    resolution:
+      {
+        integrity: sha512-ywt6i8FzvdgrrrGbr1jZVObnVv6adj+0if2/omv9cmR2oiZs30zL4DIyaptKcbOrBdOIc74QTMoJvSE2QHh5UQ==
+      }
+
+  cfb@1.2.2:
+    resolution:
+      {
+        integrity: sha512-KfdUZsSOw19/ObEWasvBP/Ac4reZvAGauZhs6S/gqNhXhI7cKwvlH7ulj+dOEYnca4bm4SGo8C1bTAQvnTjgQA==
+      }
+    engines: { node: '>=0.8' }
+
+  chalk@2.4.2:
+    resolution:
+      {
+        integrity: sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==
+      }
+    engines: { node: '>=4' }
+
+  chalk@4.1.2:
+    resolution:
+      {
+        integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==
+      }
+    engines: { node: '>=10' }
+
+  chalk@5.6.2:
+    resolution:
+      {
+        integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==
+      }
+    engines: { node: ^12.17.0 || ^14.13 || >=16.0.0 }
+
+  chardet@0.7.0:
+    resolution:
+      {
+        integrity: sha512-mT8iDcrh03qDGRRmoA2hmBJnxpllMR+0/0qlzjqZES6NdiWDcZkCNAk4rPFZ9Q85r27unkiNNg8ZOiwZXBHwcA==
+      }
+
+  chokidar@3.6.0:
+    resolution:
+      {
+        integrity: sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==
+      }
+    engines: { node: '>= 8.10.0' }
+
+  chokidar@4.0.3:
+    resolution:
+      {
+        integrity: sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==
+      }
+    engines: { node: '>= 14.16.0' }
+
+  chownr@3.0.0:
+    resolution:
+      {
+        integrity: sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==
+      }
+    engines: { node: '>=18' }
+
+  cli-cursor@3.1.0:
+    resolution:
+      {
+        integrity: sha512-I/zHAwsKf9FqGoXM4WWRACob9+SNukZTd94DWF57E4toouRulbCxcUh6RKUEOQlYTHJnzkPMySvPNaaSLNfLZw==
+      }
+    engines: { node: '>=8' }
+
+  cli-cursor@5.0.0:
+    resolution:
+      {
+        integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==
+      }
+    engines: { node: '>=18' }
+
+  cli-spinners@2.9.2:
+    resolution:
+      {
+        integrity: sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg==
+      }
+    engines: { node: '>=6' }
+
+  cli-truncate@4.0.0:
+    resolution:
+      {
+        integrity: sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA==
+      }
+    engines: { node: '>=18' }
+
+  cli-width@3.0.0:
+    resolution:
+      {
+        integrity: sha512-FxqpkPPwu1HjuN93Omfm4h8uIanXofW0RxVEW3k5RKx+mJJYSthzNhp32Kzxxy3YAEZ/Dc/EWN1vZRY0+kOhbw==
+      }
+    engines: { node: '>= 10' }
+
+  cliui@8.0.1:
+    resolution:
+      {
+        integrity: sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==
+      }
+    engines: { node: '>=12' }
+
+  clone@1.0.4:
+    resolution:
+      {
+        integrity: sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg==
+      }
+    engines: { node: '>=0.8' }
+
+  codepage@1.15.0:
+    resolution:
+      {
+        integrity: sha512-3g6NUTPd/YtuuGrhMnOMRjFc+LJw/bnMp3+0r/Wcz3IXUuCosKRJvMphm5+Q+bvTVGcJJuRvVLuYba+WojaFaA==
+      }
+    engines: { node: '>=0.8' }
+
+  color-convert@1.9.3:
+    resolution:
+      {
+        integrity: sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==
+      }
+
+  color-convert@2.0.1:
+    resolution:
+      {
+        integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==
+      }
+    engines: { node: '>=7.0.0' }
+
+  color-name@1.1.3:
+    resolution:
+      {
+        integrity: sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==
+      }
+
+  color-name@1.1.4:
+    resolution:
+      {
+        integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==
+      }
+
+  colord@2.9.3:
+    resolution:
+      {
+        integrity: sha512-jeC1axXpnb0/2nn/Y1LPuLdgXBLH7aDcHu4KEKfqw3CUhX7ZpfBSlPKyqXE6btIgEzfWtrX3/tyBCaCvXvMkOw==
+      }
+
+  colorette@2.0.20:
+    resolution:
+      {
+        integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==
+      }
+
+  combined-stream@1.0.8:
+    resolution:
+      {
+        integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==
+      }
+    engines: { node: '>= 0.8' }
+
+  commander@13.1.0:
+    resolution:
+      {
+        integrity: sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==
+      }
+    engines: { node: '>=18' }
+
+  commander@2.20.3:
+    resolution:
+      {
+        integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==
+      }
+
+  commitizen@4.3.1:
+    resolution:
+      {
+        integrity: sha512-gwAPAVTy/j5YcOOebcCRIijn+mSjWJC+IYKivTu6aG8Ei/scoXgfsMRnuAk6b0GRste2J4NGxVdMN3ZpfNaVaw==
+      }
+    engines: { node: '>= 12' }
+    hasBin: true
+
+  compare-func@2.0.0:
+    resolution:
+      {
+        integrity: sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==
+      }
+
+  compute-scroll-into-view@1.0.20:
+    resolution:
+      {
+        integrity: sha512-UCB0ioiyj8CRjtrvaceBLqqhZCVP+1B8+NWQhmdsm0VXOJtobBCf1dBQmebCCo34qZmUwZfIH2MZLqNHazrfjg==
+      }
+
+  concat-map@0.0.1:
+    resolution:
+      {
+        integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==
+      }
+
+  confbox@0.1.8:
+    resolution:
+      {
+        integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==
+      }
+
+  confbox@0.2.2:
+    resolution:
+      {
+        integrity: sha512-1NB+BKqhtNipMsov4xI/NnhCKp9XG9NamYp5PVm9klAT0fsrNPjaFICsCFhNhwZJKNh7zB/3q8qXz0E9oaMNtQ==
+      }
+
+  conventional-changelog-angular@7.0.0:
+    resolution:
+      {
+        integrity: sha512-ROjNchA9LgfNMTTFSIWPzebCwOGFdgkEq45EnvvrmSLvCtAw0HSmrCs7/ty+wAeYUZyNay0YMUNYFTRL72PkBQ==
+      }
+    engines: { node: '>=16' }
+
+  conventional-changelog-conventionalcommits@7.0.2:
+    resolution:
+      {
+        integrity: sha512-NKXYmMR/Hr1DevQegFB4MwfM5Vv0m4UIxKZTTYuD98lpTknaZlSRrDOG4X7wIXpGkfsYxZTghUN+Qq+T0YQI7w==
+      }
+    engines: { node: '>=16' }
+
+  conventional-commit-types@3.0.0:
+    resolution:
+      {
+        integrity: sha512-SmmCYnOniSsAa9GqWOeLqc179lfr5TRu5b4QFDkbsrJ5TZjPJx85wtOr3zn+1dbeNiXDKGPbZ72IKbPhLXh/Lg==
+      }
+
+  conventional-commits-parser@5.0.0:
+    resolution:
+      {
+        integrity: sha512-ZPMl0ZJbw74iS9LuX9YIAiW8pfM5p3yh2o/NbXHbkFuZzY5jvdi5jFycEOkmBW5H5I7nA+D6f3UcsCLP2vvSEA==
+      }
+    engines: { node: '>=16' }
+    hasBin: true
+
+  convert-source-map@2.0.0:
+    resolution:
+      {
+        integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==
+      }
+
+  copy-anything@3.0.5:
+    resolution:
+      {
+        integrity: sha512-yCEafptTtb4bk7GLEQoM8KVJpxAfdBJYaXyzQEgQQQgYrZiDp8SJmGKlYza6CYjEDNstAdNdKA3UuoULlEbS6w==
+      }
+    engines: { node: '>=12.13' }
+
+  core-js@3.45.1:
+    resolution:
+      {
+        integrity: sha512-L4NPsJlCfZsPeXukyzHFlg/i7IIVwHSItR0wg0FLNqYClJ4MQYTYLbC7EkjKYRLZF2iof2MUgN0EGy7MdQFChg==
+      }
+
+  cosmiconfig-typescript-loader@6.1.0:
+    resolution:
+      {
+        integrity: sha512-tJ1w35ZRUiM5FeTzT7DtYWAFFv37ZLqSRkGi2oeCK1gPhvaWjkAtfXvLmvE1pRfxxp9aQo6ba/Pvg1dKj05D4g==
+      }
+    engines: { node: '>=v18' }
+    peerDependencies:
+      '@types/node': '*'
+      cosmiconfig: '>=9'
+      typescript: '>=5'
+
+  cosmiconfig@9.0.0:
+    resolution:
+      {
+        integrity: sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==
+      }
+    engines: { node: '>=14' }
+    peerDependencies:
+      typescript: '>=4.9.5'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  crc-32@1.2.2:
+    resolution:
+      {
+        integrity: sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==
+      }
+    engines: { node: '>=0.8' }
+    hasBin: true
+
+  cross-spawn@7.0.6:
+    resolution:
+      {
+        integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==
+      }
+    engines: { node: '>= 8' }
+
+  crypto-js@4.2.0:
+    resolution:
+      {
+        integrity: sha512-KALDyEYgpY+Rlob/iriUtjV6d5Eq+Y191A5g4UqLAi8CyGP9N1+FdVbkc1SxKc2r4YAYqG8JzO2KGL+AizD70Q==
+      }
+
+  css-functions-list@3.2.3:
+    resolution:
+      {
+        integrity: sha512-IQOkD3hbR5KrN93MtcYuad6YPuTSUhntLHDuLEbFWE+ff2/XSZNdZG+LcbbIW5AXKg/WFIfYItIzVoHngHXZzA==
+      }
+    engines: { node: '>=12 || >=16' }
+
+  css-tree@3.1.0:
+    resolution:
+      {
+        integrity: sha512-0eW44TGN5SQXU1mWSkKwFstI/22X2bG1nYzZTYMAWjylYURhse752YgbE4Cx46AC+bAvI+/dYTPRk1LqSUnu6w==
+      }
+    engines: { node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0 }
+
+  cssesc@3.0.0:
+    resolution:
+      {
+        integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==
+      }
+    engines: { node: '>=4' }
+    hasBin: true
+
+  csstype@3.1.3:
+    resolution:
+      {
+        integrity: sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==
+      }
+
+  cz-conventional-changelog@3.3.0:
+    resolution:
+      {
+        integrity: sha512-U466fIzU5U22eES5lTNiNbZ+d8dfcHcssH4o7QsdWaCcRs/feIPCxKYSWkYBNs5mny7MvEfwpTLWjvbm94hecw==
+      }
+    engines: { node: '>= 10' }
+
+  cz-git@1.12.0:
+    resolution:
+      {
+        integrity: sha512-LaZ+8whPPUOo6Y0Zy4nIbf6JOleV3ejp41sT6N4RPKiKKA+ICWf4ueeIlxIO8b6JtdlDxRzHH/EcRji07nDxcg==
+      }
+    engines: { node: '>=v12.20.0' }
+
+  d@1.0.2:
+    resolution:
+      {
+        integrity: sha512-MOqHvMWF9/9MX6nza0KgvFH4HpMU0EF5uUDXqX/BtxtU8NfB0QzRtJ8Oe/6SuS4kbhyzVJwjd97EA4PKrzJ8bw==
+      }
+    engines: { node: '>=0.12' }
+
+  danmu.js@1.1.13:
+    resolution:
+      {
+        integrity: sha512-knFd0/cB2HA4FFWiA7eB2suc5vCvoHdqio33FyyCSfP7C+1A+zQcTvnvwfxaZhrxsGj4qaQI2I8XiTqedRaVmg==
+      }
+
+  dargs@8.1.0:
+    resolution:
+      {
+        integrity: sha512-wAV9QHOsNbwnWdNW2FYvE1P56wtgSbM+3SZcdGiWQILwVjACCXDCI3Ai8QlCjMDB8YK5zySiXZYBiwGmNY3lnw==
+      }
+    engines: { node: '>=12' }
+
+  dayjs@1.11.18:
+    resolution:
+      {
+        integrity: sha512-zFBQ7WFRvVRhKcWoUh+ZA1g2HVgUbsZm9sbddh8EC5iv93sui8DVVz1Npvz+r6meo9VKfa8NyLWBsQK1VvIKPA==
+      }
+
+  de-indent@1.0.2:
+    resolution:
+      {
+        integrity: sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==
+      }
+
+  debug@4.4.3:
+    resolution:
+      {
+        integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==
+      }
+    engines: { node: '>=6.0' }
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+
+  dedent@0.7.0:
+    resolution:
+      {
+        integrity: sha512-Q6fKUPqnAHAyhiUgFU7BUzLiv0kd8saH9al7tnu5Q/okj6dnupxyTgFIBjVzJATdfIAm9NAsvXNzjaKa+bxVyA==
+      }
+
+  deep-is@0.1.4:
+    resolution:
+      {
+        integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==
+      }
+
+  deep-pick-omit@1.2.1:
+    resolution:
+      {
+        integrity: sha512-2J6Kc/m3irCeqVG42T+SaUMesaK7oGWaedGnQQK/+O0gYc+2SP5bKh/KKTE7d7SJ+GCA9UUE1GRzh6oDe0EnGw==
+      }
+
+  default-browser-id@5.0.0:
+    resolution:
+      {
+        integrity: sha512-A6p/pu/6fyBcA1TRz/GqWYPViplrftcW2gZC9q79ngNCKAeR/X3gcEdXQHl4KNXV+3wgIJ1CPkJQ3IHM6lcsyA==
+      }
+    engines: { node: '>=18' }
+
+  default-browser@5.2.1:
+    resolution:
+      {
+        integrity: sha512-WY/3TUME0x3KPYdRRxEJJvXRHV4PyPoUsxtZa78lwItwRQRHhd2U9xOscaT/YTf8uCXIAjeJOFBVEh/7FtD8Xg==
+      }
+    engines: { node: '>=18' }
+
+  defaults@1.0.4:
+    resolution:
+      {
+        integrity: sha512-eFuaLoy/Rxalv2kr+lqMlUnrDWV+3j4pljOIJgLIhI058IQfWJ7vXhyEIHu+HtC738klGALYxOKDO0bQP3tg8A==
+      }
+
+  define-lazy-prop@2.0.0:
+    resolution:
+      {
+        integrity: sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==
+      }
+    engines: { node: '>=8' }
+
+  define-lazy-prop@3.0.0:
+    resolution:
+      {
+        integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==
+      }
+    engines: { node: '>=12' }
+
+  defu@6.1.4:
+    resolution:
+      {
+        integrity: sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==
+      }
+
+  delayed-stream@1.0.0:
+    resolution:
+      {
+        integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==
+      }
+    engines: { node: '>=0.4.0' }
+
+  delegate@3.2.0:
+    resolution:
+      {
+        integrity: sha512-IofjkYBZaZivn0V8nnsMJGBr4jVLxHDheKSW88PyxS5QC4Vo9ZbZVvhzlSxY87fVq3STR6r+4cGepyHkcWOQSw==
+      }
+
+  destr@2.0.5:
+    resolution:
+      {
+        integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==
+      }
+
+  detect-file@1.0.0:
+    resolution:
+      {
+        integrity: sha512-DtCOLG98P007x7wiiOmfI0fi3eIKyWiLTGJ2MDnVi/E04lWGbf+JzrRHMm0rgIIZJGtHpKpbVgLWHrv8xXpc3Q==
+      }
+    engines: { node: '>=0.10.0' }
+
+  detect-indent@6.1.0:
+    resolution:
+      {
+        integrity: sha512-reYkTUJAZb9gUuZ2RvVCNhVHdg62RHnJ7WJl8ftMi4diZ6NWlciOzQN88pUhSELEwflJht4oQDv0F0BMlwaYtA==
+      }
+    engines: { node: '>=8' }
+
+  detect-libc@1.0.3:
+    resolution:
+      {
+        integrity: sha512-pGjwhsmsp4kL2RTz08wcOlGN83otlqHeD/Z5T8GXZB+/YcpQ/dgo+lbU8ZsGxV0HIvqqxo9l7mqYwyYMD9bKDg==
+      }
+    engines: { node: '>=0.10' }
+    hasBin: true
+
+  detect-libc@2.1.2:
+    resolution:
+      {
+        integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==
+      }
+    engines: { node: '>=8' }
+
+  dir-glob@3.0.1:
+    resolution:
+      {
+        integrity: sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==
+      }
+    engines: { node: '>=8' }
+
+  dom-serializer@2.0.0:
+    resolution:
+      {
+        integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==
+      }
+
+  dom7@3.0.0:
+    resolution:
+      {
+        integrity: sha512-oNlcUdHsC4zb7Msx7JN3K0Nro1dzJ48knvBOnDPKJ2GV9wl1i5vydJZUSyOfrkKFDZEud/jBsTk92S/VGSAe/g==
+      }
+
+  domelementtype@2.3.0:
+    resolution:
+      {
+        integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==
+      }
+
+  domhandler@5.0.3:
+    resolution:
+      {
+        integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==
+      }
+    engines: { node: '>= 4' }
+
+  domutils@3.2.2:
+    resolution:
+      {
+        integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==
+      }
+
+  dot-prop@5.3.0:
+    resolution:
+      {
+        integrity: sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q==
+      }
+    engines: { node: '>=8' }
+
+  downloadjs@1.4.7:
+    resolution:
+      {
+        integrity: sha512-LN1gO7+u9xjU5oEScGFKvXhYf7Y/empUIIEAGBs1LzUq/rg5duiDrkuH5A2lQGd5jfMOb9X9usDa2oVXwJ0U/Q==
+      }
+
+  dunder-proto@1.0.1:
+    resolution:
+      {
+        integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==
+      }
+    engines: { node: '>= 0.4' }
+
+  echarts@6.0.0:
+    resolution:
+      {
+        integrity: sha512-Tte/grDQRiETQP4xz3iZWSvoHrkCQtwqd6hs+mifXcjrCuo2iKWbajFObuLJVBlDIJlOzgQPd1hsaKt/3+OMkQ==
+      }
+
+  electron-to-chromium@1.5.227:
+    resolution:
+      {
+        integrity: sha512-ITxuoPfJu3lsNWUi2lBM2PaBPYgH3uqmxut5vmBxgYvyI4AlJ6P3Cai1O76mOrkJCBzq0IxWg/NtqOrpu/0gKA==
+      }
+
+  element-plus@2.11.4:
+    resolution:
+      {
+        integrity: sha512-sLq+Ypd0cIVilv8wGGMEGvzRVBBsRpJjnAS5PsI/1JU1COZXqzH3N1UYMUc/HCdvdjf6dfrBy80Sj7KcACsT7w==
+      }
+    peerDependencies:
+      vue: ^3.2.0
+
+  emoji-regex@10.5.0:
+    resolution:
+      {
+        integrity: sha512-lb49vf1Xzfx080OKA0o6l8DQQpV+6Vg95zyCJX9VB/BqKYlhG7N4wgROUUHRA+ZPUefLnteQOad7z1kT2bV7bg==
+      }
+
+  emoji-regex@8.0.0:
+    resolution:
+      {
+        integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==
+      }
+
+  enhanced-resolve@5.18.3:
+    resolution:
+      {
+        integrity: sha512-d4lC8xfavMeBjzGr2vECC3fsGXziXZQyJxD868h2M/mBI3PwAuODxAkLkq5HYuvrPYcUtiLzsTo8U3PgX3Ocww==
+      }
+    engines: { node: '>=10.13.0' }
+
+  entities@4.5.0:
+    resolution:
+      {
+        integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==
+      }
+    engines: { node: '>=0.12' }
+
+  env-paths@2.2.1:
+    resolution:
+      {
+        integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==
+      }
+    engines: { node: '>=6' }
+
+  environment@1.1.0:
+    resolution:
+      {
+        integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==
+      }
+    engines: { node: '>=18' }
+
+  error-ex@1.3.4:
+    resolution:
+      {
+        integrity: sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==
+      }
+
+  error-stack-parser-es@0.1.5:
+    resolution:
+      {
+        integrity: sha512-xHku1X40RO+fO8yJ8Wh2f2rZWVjqyhb1zgq1yZ8aZRQkv6OOKhKWRUaht3eSCUbAOBaKIgM+ykwFLE+QUxgGeg==
+      }
+
+  es-define-property@1.0.1:
+    resolution:
+      {
+        integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==
+      }
+    engines: { node: '>= 0.4' }
+
+  es-errors@1.3.0:
+    resolution:
+      {
+        integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==
+      }
+    engines: { node: '>= 0.4' }
+
+  es-module-lexer@1.7.0:
+    resolution:
+      {
+        integrity: sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==
+      }
+
+  es-object-atoms@1.1.1:
+    resolution:
+      {
+        integrity: sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==
+      }
+    engines: { node: '>= 0.4' }
+
+  es-set-tostringtag@2.1.0:
+    resolution:
+      {
+        integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==
+      }
+    engines: { node: '>= 0.4' }
+
+  es5-ext@0.10.64:
+    resolution:
+      {
+        integrity: sha512-p2snDhiLaXe6dahss1LddxqEm+SkuDvV8dnIQG0MWjyHpcMNfXKPE+/Cc0y+PhxJX3A4xGNeFCj5oc0BUh6deg==
+      }
+    engines: { node: '>=0.10' }
+
+  es6-iterator@2.0.3:
+    resolution:
+      {
+        integrity: sha512-zw4SRzoUkd+cl+ZoE15A9o1oQd920Bb0iOJMQkQhl3jNc03YqVjAhG7scf9C5KWRU/R13Orf588uCC6525o02g==
+      }
+
+  es6-symbol@3.1.4:
+    resolution:
+      {
+        integrity: sha512-U9bFFjX8tFiATgtkJ1zg25+KviIXpgRvRHS8sau3GfhVzThRQrOeksPeT0BWW2MNZs1OEWJ1DPXOQMn0KKRkvg==
+      }
+    engines: { node: '>=0.12' }
+
+  esbuild@0.25.10:
+    resolution:
+      {
+        integrity: sha512-9RiGKvCwaqxO2owP61uQ4BgNborAQskMR6QusfWzQqv7AZOg5oGehdY2pRJMTKuwxd1IDBP4rSbI5lHzU7SMsQ==
+      }
+    engines: { node: '>=18' }
+    hasBin: true
+
+  escalade@3.2.0:
+    resolution:
+      {
+        integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==
+      }
+    engines: { node: '>=6' }
+
+  escape-html@1.0.3:
+    resolution:
+      {
+        integrity: sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==
+      }
+
+  escape-string-regexp@1.0.5:
+    resolution:
+      {
+        integrity: sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==
+      }
+    engines: { node: '>=0.8.0' }
+
+  escape-string-regexp@4.0.0:
+    resolution:
+      {
+        integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==
+      }
+    engines: { node: '>=10' }
+
+  escape-string-regexp@5.0.0:
+    resolution:
+      {
+        integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==
+      }
+    engines: { node: '>=12' }
+
+  eslint-config-prettier@9.1.2:
+    resolution:
+      {
+        integrity: sha512-iI1f+D2ViGn+uvv5HuHVUamg8ll4tN+JRHGc6IJi4TP9Kl976C57fzPXgseXNs8v0iA8aSJpHsTWjDb9QJamGQ==
+      }
+    hasBin: true
+    peerDependencies:
+      eslint: '>=7.0.0'
+
+  eslint-plugin-prettier@5.5.4:
+    resolution:
+      {
+        integrity: sha512-swNtI95SToIz05YINMA6Ox5R057IMAmWZ26GqPxusAp1TZzj+IdY9tXNWWD3vkF/wEqydCONcwjTFpxybBqZsg==
+      }
+    engines: { node: ^14.18.0 || >=16.0.0 }
+    peerDependencies:
+      '@types/eslint': '>=8.0.0'
+      eslint: '>=8.0.0'
+      eslint-config-prettier: '>= 7.0.0 <10.0.0 || >=10.1.0'
+      prettier: '>=3.0.0'
+    peerDependenciesMeta:
+      '@types/eslint':
+        optional: true
+      eslint-config-prettier:
+        optional: true
+
+  eslint-plugin-vue@9.33.0:
+    resolution:
+      {
+        integrity: sha512-174lJKuNsuDIlLpjeXc5E2Tss8P44uIimAfGD0b90k0NoirJqpG7stLuU9Vp/9ioTOrQdWVREc4mRd1BD+CvGw==
+      }
+    engines: { node: ^14.17.0 || >=16.0.0 }
+    peerDependencies:
+      eslint: ^6.2.0 || ^7.0.0 || ^8.0.0 || ^9.0.0
+
+  eslint-scope@7.2.2:
+    resolution:
+      {
+        integrity: sha512-dOt21O7lTMhDM+X9mB4GX+DZrZtCUJPL/wlcTqxyrx5IvO0IYtILdtrQGQp+8n5S0gwSVmOf9NQrjMOgfQZlIg==
+      }
+    engines: { node: ^12.22.0 || ^14.17.0 || >=16.0.0 }
+
+  eslint-scope@8.4.0:
+    resolution:
+      {
+        integrity: sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  eslint-visitor-keys@3.4.3:
+    resolution:
+      {
+        integrity: sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==
+      }
+    engines: { node: ^12.22.0 || ^14.17.0 || >=16.0.0 }
+
+  eslint-visitor-keys@4.2.1:
+    resolution:
+      {
+        integrity: sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  eslint@9.36.0:
+    resolution:
+      {
+        integrity: sha512-hB4FIzXovouYzwzECDcUkJ4OcfOEkXTv2zRY6B9bkwjx/cprAq0uvm1nl7zvQ0/TsUk0zQiN4uPfJpB9m+rPMQ==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    hasBin: true
+    peerDependencies:
+      jiti: '*'
+    peerDependenciesMeta:
+      jiti:
+        optional: true
+
+  esniff@2.0.1:
+    resolution:
+      {
+        integrity: sha512-kTUIGKQ/mDPFoJ0oVfcmyJn4iBDRptjNVIzwIFR7tqWXdVI9xfA2RMwY/gbSpJG3lkdWNEjLap/NqVHZiJsdfg==
+      }
+    engines: { node: '>=0.10' }
+
+  espree@10.4.0:
+    resolution:
+      {
+        integrity: sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+
+  espree@9.6.1:
+    resolution:
+      {
+        integrity: sha512-oruZaFkjorTpF32kDSI5/75ViwGeZginGGy2NoOSg3Q9bnwlnmDm4HLnkl0RE3n+njDXR037aY1+x58Z/zFdwQ==
+      }
+    engines: { node: ^12.22.0 || ^14.17.0 || >=16.0.0 }
+
+  esquery@1.6.0:
+    resolution:
+      {
+        integrity: sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==
+      }
+    engines: { node: '>=0.10' }
+
+  esrecurse@4.3.0:
+    resolution:
+      {
+        integrity: sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==
+      }
+    engines: { node: '>=4.0' }
+
+  estraverse@5.3.0:
+    resolution:
+      {
+        integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==
+      }
+    engines: { node: '>=4.0' }
+
+  estree-walker@2.0.2:
+    resolution:
+      {
+        integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==
+      }
+
+  estree-walker@3.0.3:
+    resolution:
+      {
+        integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==
+      }
+
+  esutils@2.0.3:
+    resolution:
+      {
+        integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==
+      }
+    engines: { node: '>=0.10.0' }
+
+  event-emitter@0.3.5:
+    resolution:
+      {
+        integrity: sha512-D9rRn9y7kLPnJ+hMq7S/nhvoKwwvVJahBi2BPmx3bvbsEdK3W9ii8cBSGjP+72/LnM4n6fo3+dkCX5FeTQruXA==
+      }
+
+  eventemitter3@4.0.7:
+    resolution:
+      {
+        integrity: sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==
+      }
+
+  eventemitter3@5.0.1:
+    resolution:
+      {
+        integrity: sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==
+      }
+
+  execa@8.0.1:
+    resolution:
+      {
+        integrity: sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==
+      }
+    engines: { node: '>=16.17' }
+
+  execa@9.6.0:
+    resolution:
+      {
+        integrity: sha512-jpWzZ1ZhwUmeWRhS7Qv3mhpOhLfwI+uAX4e5fOcXqwMR7EcJ0pj2kV1CVzHVMX/LphnKWD3LObjZCoJ71lKpHw==
+      }
+    engines: { node: ^18.19.0 || >=20.5.0 }
+
+  expand-tilde@2.0.2:
+    resolution:
+      {
+        integrity: sha512-A5EmesHW6rfnZ9ysHQjPdJRni0SRar0tjtG5MNtm9n5TUvsYU8oozprtRD4AqHxcZWWlVuAmQo2nWKfN9oyjTw==
+      }
+    engines: { node: '>=0.10.0' }
+
+  exsolve@1.0.7:
+    resolution:
+      {
+        integrity: sha512-VO5fQUzZtI6C+vx4w/4BWJpg3s/5l+6pRQEHzFRM8WFi4XffSP1Z+4qi7GbjWbvRQEbdIco5mIMq+zX4rPuLrw==
+      }
+
+  ext@1.7.0:
+    resolution:
+      {
+        integrity: sha512-6hxeJYaL110a9b5TEJSj0gojyHQAmA2ch5Os+ySCiA1QGdS697XWY1pzsrSjqA9LDEEgdB/KypIlR59RcLuHYw==
+      }
+
+  external-editor@3.1.0:
+    resolution:
+      {
+        integrity: sha512-hMQ4CX1p1izmuLYyZqLMO/qGNw10wSv9QDCPfzXfyFrOaCSSoRfqE1Kf1s5an66J5JZC62NewG+mK49jOCtQew==
+      }
+    engines: { node: '>=4' }
+
+  fast-deep-equal@3.1.3:
+    resolution:
+      {
+        integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==
+      }
+
+  fast-diff@1.3.0:
+    resolution:
+      {
+        integrity: sha512-VxPP4NqbUjj6MaAOafWeUn2cXWLcCtljklUtZf0Ind4XQ+QPtmA0b18zZy0jIQx+ExRVCR/ZQpBmik5lXshNsw==
+      }
+
+  fast-glob@3.3.3:
+    resolution:
+      {
+        integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==
+      }
+    engines: { node: '>=8.6.0' }
+
+  fast-json-stable-stringify@2.1.0:
+    resolution:
+      {
+        integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==
+      }
+
+  fast-levenshtein@2.0.6:
+    resolution:
+      {
+        integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==
+      }
+
+  fast-uri@3.1.0:
+    resolution:
+      {
+        integrity: sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==
+      }
+
+  fastest-levenshtein@1.0.16:
+    resolution:
+      {
+        integrity: sha512-eRnCtTTtGZFpQCwhJiUOuxPQWRXVKYDn0b2PeHfXL6/Zi53SLAzAHfVhVWK2AryC/WH05kGfxhFIPvTF0SXQzg==
+      }
+    engines: { node: '>= 4.9.1' }
+
+  fastq@1.19.1:
+    resolution:
+      {
+        integrity: sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==
+      }
+
+  fdir@6.5.0:
+    resolution:
+      {
+        integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==
+      }
+    engines: { node: '>=12.0.0' }
+    peerDependencies:
+      picomatch: ^3 || ^4
+    peerDependenciesMeta:
+      picomatch:
+        optional: true
+
+  figures@3.2.0:
+    resolution:
+      {
+        integrity: sha512-yaduQFRKLXYOGgEn6AZau90j3ggSOyiqXU0F9JZfeXYhNa+Jk4X+s45A2zg5jns87GAFa34BBm2kXw4XpNcbdg==
+      }
+    engines: { node: '>=8' }
+
+  figures@6.1.0:
+    resolution:
+      {
+        integrity: sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==
+      }
+    engines: { node: '>=18' }
+
+  file-entry-cache@10.1.4:
+    resolution:
+      {
+        integrity: sha512-5XRUFc0WTtUbjfGzEwXc42tiGxQHBmtbUG1h9L2apu4SulCGN3Hqm//9D6FAolf8MYNL7f/YlJl9vy08pj5JuA==
+      }
+
+  file-entry-cache@8.0.0:
+    resolution:
+      {
+        integrity: sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==
+      }
+    engines: { node: '>=16.0.0' }
+
+  file-saver@2.0.5:
+    resolution:
+      {
+        integrity: sha512-P9bmyZ3h/PRG+Nzga+rbdI4OEpNDzAVyy74uVO9ATgzLK6VtAsYybF/+TOCvrc0MO793d6+42lLyZTw7/ArVzA==
+      }
+
+  fill-range@7.1.1:
+    resolution:
+      {
+        integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==
+      }
+    engines: { node: '>=8' }
+
+  find-node-modules@2.1.3:
+    resolution:
+      {
+        integrity: sha512-UC2I2+nx1ZuOBclWVNdcnbDR5dlrOdVb7xNjmT/lHE+LsgztWks3dG7boJ37yTS/venXw84B/mAW9uHVoC5QRg==
+      }
+
+  find-root@1.1.0:
+    resolution:
+      {
+        integrity: sha512-NKfW6bec6GfKc0SGx1e07QZY9PE99u0Bft/0rzSD5k3sO/vwkVUpDUKVm5Gpp5Ue3YfShPFTX2070tDs5kB9Ng==
+      }
+
+  find-up@5.0.0:
+    resolution:
+      {
+        integrity: sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==
+      }
+    engines: { node: '>=10' }
+
+  find-up@7.0.0:
+    resolution:
+      {
+        integrity: sha512-YyZM99iHrqLKjmt4LJDj58KI+fYyufRLBSYcqycxf//KpBk9FoewoGX0450m9nB44qrZnovzC2oeP5hUibxc/g==
+      }
+    engines: { node: '>=18' }
+
+  findup-sync@4.0.0:
+    resolution:
+      {
+        integrity: sha512-6jvvn/12IC4quLBL1KNokxC7wWTvYncaVUYSoxWw7YykPLuRrnv4qdHcSOywOI5RpkOVGeQRtWM8/q+G6W6qfQ==
+      }
+    engines: { node: '>= 8' }
+
+  flat-cache@4.0.1:
+    resolution:
+      {
+        integrity: sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==
+      }
+    engines: { node: '>=16' }
+
+  flat-cache@6.1.14:
+    resolution:
+      {
+        integrity: sha512-ExZSCSV9e7v/Zt7RzCbX57lY2dnPdxzU/h3UE6WJ6NtEMfwBd8jmi1n4otDEUfz+T/R+zxrFDpICFdjhD3H/zw==
+      }
+
+  flatted@3.3.3:
+    resolution:
+      {
+        integrity: sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==
+      }
+
+  follow-redirects@1.15.11:
+    resolution:
+      {
+        integrity: sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==
+      }
+    engines: { node: '>=4.0' }
+    peerDependencies:
+      debug: '*'
+    peerDependenciesMeta:
+      debug:
+        optional: true
+
+  form-data@4.0.4:
+    resolution:
+      {
+        integrity: sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==
+      }
+    engines: { node: '>= 6' }
+
+  frac@1.1.2:
+    resolution:
+      {
+        integrity: sha512-w/XBfkibaTl3YDqASwfDUqkna4Z2p9cFSr1aHDt0WoMTECnRfBOv2WArlZILlqgWlmdIlALXGpM2AOhEk5W3IA==
+      }
+    engines: { node: '>=0.8' }
+
+  fs-extra@10.1.0:
+    resolution:
+      {
+        integrity: sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==
+      }
+    engines: { node: '>=12' }
+
+  fs-extra@11.3.2:
+    resolution:
+      {
+        integrity: sha512-Xr9F6z6up6Ws+NjzMCZc6WXg2YFRlrLP9NQDO3VQrWrfiojdhS56TzueT88ze0uBdCTwEIhQ3ptnmKeWGFAe0A==
+      }
+    engines: { node: '>=14.14' }
+
+  fs-extra@9.1.0:
+    resolution:
+      {
+        integrity: sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==
+      }
+    engines: { node: '>=10' }
+
+  fs.realpath@1.0.0:
+    resolution:
+      {
+        integrity: sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==
+      }
+
+  fsevents@2.3.3:
+    resolution:
+      {
+        integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==
+      }
+    engines: { node: ^8.16.0 || ^10.6.0 || >=11.0.0 }
+    os: [darwin]
+
+  function-bind@1.1.2:
+    resolution:
+      {
+        integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==
+      }
+
+  gensync@1.0.0-beta.2:
+    resolution:
+      {
+        integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==
+      }
+    engines: { node: '>=6.9.0' }
+
+  get-caller-file@2.0.5:
+    resolution:
+      {
+        integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==
+      }
+    engines: { node: 6.* || 8.* || >= 10.* }
+
+  get-east-asian-width@1.4.0:
+    resolution:
+      {
+        integrity: sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q==
+      }
+    engines: { node: '>=18' }
+
+  get-intrinsic@1.3.0:
+    resolution:
+      {
+        integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==
+      }
+    engines: { node: '>= 0.4' }
+
+  get-proto@1.0.1:
+    resolution:
+      {
+        integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==
+      }
+    engines: { node: '>= 0.4' }
+
+  get-stream@8.0.1:
+    resolution:
+      {
+        integrity: sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==
+      }
+    engines: { node: '>=16' }
+
+  get-stream@9.0.1:
+    resolution:
+      {
+        integrity: sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA==
+      }
+    engines: { node: '>=18' }
+
+  get-tsconfig@4.10.1:
+    resolution:
+      {
+        integrity: sha512-auHyJ4AgMz7vgS8Hp3N6HXSmlMdUyhSUrfBF16w153rxtLIEOE+HGqaBppczZvnHLqQJfiHotCYpNhl0lUROFQ==
+      }
+
+  git-raw-commits@4.0.0:
+    resolution:
+      {
+        integrity: sha512-ICsMM1Wk8xSGMowkOmPrzo2Fgmfo4bMHLNX6ytHjajRJUqvHOw/TFapQ+QG75c3X/tTDDhOSRPGC52dDbNM8FQ==
+      }
+    engines: { node: '>=16' }
+    hasBin: true
+
+  glob-parent@5.1.2:
+    resolution:
+      {
+        integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==
+      }
+    engines: { node: '>= 6' }
+
+  glob-parent@6.0.2:
+    resolution:
+      {
+        integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==
+      }
+    engines: { node: '>=10.13.0' }
+
+  glob@7.2.3:
+    resolution:
+      {
+        integrity: sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==
+      }
+    deprecated: Glob versions prior to v9 are no longer supported
+
+  global-directory@4.0.1:
+    resolution:
+      {
+        integrity: sha512-wHTUcDUoZ1H5/0iVqEudYW4/kAlN5cZ3j/bXn0Dpbizl9iaUVeWSHqiOjsgk6OW2bkLclbBjzewBz6weQ1zA2Q==
+      }
+    engines: { node: '>=18' }
+
+  global-modules@1.0.0:
+    resolution:
+      {
+        integrity: sha512-sKzpEkf11GpOFuw0Zzjzmt4B4UZwjOcG757PPvrfhxcLFbq0wpsgpOqxpxtxFiCG4DtG93M6XRVbF2oGdev7bg==
+      }
+    engines: { node: '>=0.10.0' }
+
+  global-modules@2.0.0:
+    resolution:
+      {
+        integrity: sha512-NGbfmJBp9x8IxyJSd1P+otYK8vonoJactOogrVfFRIAEY1ukil8RSKDz2Yo7wh1oihl51l/r6W4epkeKJHqL8A==
+      }
+    engines: { node: '>=6' }
+
+  global-prefix@1.0.2:
+    resolution:
+      {
+        integrity: sha512-5lsx1NUDHtSjfg0eHlmYvZKv8/nVqX4ckFbM+FrGcQ+04KWcWFo9P5MxPZYSzUvyzmdTbI7Eix8Q4IbELDqzKg==
+      }
+    engines: { node: '>=0.10.0' }
+
+  global-prefix@3.0.0:
+    resolution:
+      {
+        integrity: sha512-awConJSVCHVGND6x3tmMaKcQvwXLhjdkmomy2W+Goaui8YPgYgXJZewhg3fWC+DlfqqQuWg8AwqjGTD2nAPVWg==
+      }
+    engines: { node: '>=6' }
+
+  globals@13.24.0:
+    resolution:
+      {
+        integrity: sha512-AhO5QUcj8llrbG09iWhPU2B204J1xnPeL8kQmVorSsy+Sjj1sk8gIyh6cUocGmH4L0UuhAJy+hJMRA4mgA4mFQ==
+      }
+    engines: { node: '>=8' }
+
+  globals@14.0.0:
+    resolution:
+      {
+        integrity: sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==
+      }
+    engines: { node: '>=18' }
+
+  globals@15.15.0:
+    resolution:
+      {
+        integrity: sha512-7ACyT3wmyp3I61S4fG682L0VA2RGD9otkqGJIwNUMF1SWUombIIk+af1unuDYgMm082aHYwD+mzJvv9Iu8dsgg==
+      }
+    engines: { node: '>=18' }
+
+  globby@11.1.0:
+    resolution:
+      {
+        integrity: sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==
+      }
+    engines: { node: '>=10' }
+
+  globjoin@0.1.4:
+    resolution:
+      {
+        integrity: sha512-xYfnw62CKG8nLkZBfWbhWwDw02CHty86jfPcc2cr3ZfeuK9ysoVPPEUxf21bAD/rWAgk52SuBrLJlefNy8mvFg==
+      }
+
+  gopd@1.2.0:
+    resolution:
+      {
+        integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==
+      }
+    engines: { node: '>= 0.4' }
+
+  graceful-fs@4.2.11:
+    resolution:
+      {
+        integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==
+      }
+
+  graphemer@1.4.0:
+    resolution:
+      {
+        integrity: sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==
+      }
+
+  has-flag@3.0.0:
+    resolution:
+      {
+        integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==
+      }
+    engines: { node: '>=4' }
+
+  has-flag@4.0.0:
+    resolution:
+      {
+        integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==
+      }
+    engines: { node: '>=8' }
+
+  has-symbols@1.1.0:
+    resolution:
+      {
+        integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==
+      }
+    engines: { node: '>= 0.4' }
+
+  has-tostringtag@1.0.2:
+    resolution:
+      {
+        integrity: sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==
+      }
+    engines: { node: '>= 0.4' }
+
+  hasown@2.0.2:
+    resolution:
+      {
+        integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==
+      }
+    engines: { node: '>= 0.4' }
+
+  he@1.2.0:
+    resolution:
+      {
+        integrity: sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==
+      }
+    hasBin: true
+
+  highlight.js@11.11.1:
+    resolution:
+      {
+        integrity: sha512-Xwwo44whKBVCYoliBQwaPvtd/2tYFkRQtXDWj1nackaV2JPXx3L0+Jvd8/qCJ2p+ML0/XVkJ2q+Mr+UVdpJK5w==
+      }
+    engines: { node: '>=12.0.0' }
+
+  homedir-polyfill@1.0.3:
+    resolution:
+      {
+        integrity: sha512-eSmmWE5bZTK2Nou4g0AI3zZ9rswp7GRKoKXS1BLUkvPviOqs4YTN1djQIqrXy9k5gEtdLPy86JjRwsNM9tnDcA==
+      }
+    engines: { node: '>=0.10.0' }
+
+  hookable@5.5.3:
+    resolution:
+      {
+        integrity: sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==
+      }
+
+  hookified@1.12.1:
+    resolution:
+      {
+        integrity: sha512-xnKGl+iMIlhrZmGHB729MqlmPoWBznctSQTYCpFKqNsCgimJQmithcW0xSQMMFzYnV2iKUh25alswn6epgxS0Q==
+      }
+
+  html-tags@3.3.1:
+    resolution:
+      {
+        integrity: sha512-ztqyC3kLto0e9WbNp0aeP+M3kTt+nbaIveGmUxAtZa+8iFgKLUOD4YKM5j+f3QD89bra7UeumolZHKuOXnTmeQ==
+      }
+    engines: { node: '>=8' }
+
+  html-void-elements@2.0.1:
+    resolution:
+      {
+        integrity: sha512-0quDb7s97CfemeJAnW9wC0hw78MtW7NU3hqtCD75g2vFlDLt36llsYD7uB7SUzojLMP24N5IatXf7ylGXiGG9A==
+      }
+
+  htmlparser2@8.0.2:
+    resolution:
+      {
+        integrity: sha512-GYdjWKDkbRLkZ5geuHs5NY1puJ+PXwP7+fHPRz06Eirsb9ugf6d8kkXav6ADhcODhFFPMIXyxkxSuMf3D6NCFA==
+      }
+
+  human-signals@5.0.0:
+    resolution:
+      {
+        integrity: sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==
+      }
+    engines: { node: '>=16.17.0' }
+
+  human-signals@8.0.1:
+    resolution:
+      {
+        integrity: sha512-eKCa6bwnJhvxj14kZk5NCPc6Hb6BdsU9DZcOnmQKSnO1VKrfV0zCvtttPZUsBvjmNDn8rpcJfpwSYnHBjc95MQ==
+      }
+    engines: { node: '>=18.18.0' }
+
+  husky@9.1.7:
+    resolution:
+      {
+        integrity: sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==
+      }
+    engines: { node: '>=18' }
+    hasBin: true
+
+  i18next@20.6.1:
+    resolution:
+      {
+        integrity: sha512-yCMYTMEJ9ihCwEQQ3phLo7I/Pwycf8uAx+sRHwwk5U9Aui/IZYgQRyMqXafQOw5QQ7DM1Z+WyEXWIqSuJHhG2A==
+      }
+
+  iconv-lite@0.4.24:
+    resolution:
+      {
+        integrity: sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==
+      }
+    engines: { node: '>=0.10.0' }
+
+  ieee754@1.2.1:
+    resolution:
+      {
+        integrity: sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==
+      }
+
+  ignore@5.3.2:
+    resolution:
+      {
+        integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==
+      }
+    engines: { node: '>= 4' }
+
+  ignore@7.0.5:
+    resolution:
+      {
+        integrity: sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==
+      }
+    engines: { node: '>= 4' }
+
+  immer@9.0.21:
+    resolution:
+      {
+        integrity: sha512-bc4NBHqOqSfRW7POMkHd51LvClaeMXpm8dx0e8oE2GORbq5aRK7Bxl4FyzVLdGtLmvLKL7BTDBG5ACQm4HWjTA==
+      }
+
+  immutable@5.1.3:
+    resolution:
+      {
+        integrity: sha512-+chQdDfvscSF1SJqv2gn4SRO2ZyS3xL3r7IW/wWEEzrzLisnOlKiQu5ytC/BVNcS15C39WT2Hg/bjKjDMcu+zg==
+      }
+
+  import-fresh@3.3.1:
+    resolution:
+      {
+        integrity: sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==
+      }
+    engines: { node: '>=6' }
+
+  import-meta-resolve@4.2.0:
+    resolution:
+      {
+        integrity: sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==
+      }
+
+  imurmurhash@0.1.4:
+    resolution:
+      {
+        integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==
+      }
+    engines: { node: '>=0.8.19' }
+
+  inflight@1.0.6:
+    resolution:
+      {
+        integrity: sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==
+      }
+    deprecated: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
+
+  inherits@2.0.4:
+    resolution:
+      {
+        integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==
+      }
+
+  ini@1.3.8:
+    resolution:
+      {
+        integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==
+      }
+
+  ini@4.1.1:
+    resolution:
+      {
+        integrity: sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==
+      }
+    engines: { node: ^14.17.0 || ^16.13.0 || >=18.0.0 }
+
+  inquirer@8.2.5:
+    resolution:
+      {
+        integrity: sha512-QAgPDQMEgrDssk1XiwwHoOGYF9BAbUcc1+j+FhEvaOt8/cKRqyLn0U5qA6F74fGhTMGxf92pOvPBeh29jQJDTQ==
+      }
+    engines: { node: '>=12.0.0' }
+
+  is-arrayish@0.2.1:
+    resolution:
+      {
+        integrity: sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==
+      }
+
+  is-binary-path@2.1.0:
+    resolution:
+      {
+        integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==
+      }
+    engines: { node: '>=8' }
+
+  is-docker@2.2.1:
+    resolution:
+      {
+        integrity: sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==
+      }
+    engines: { node: '>=8' }
+    hasBin: true
+
+  is-docker@3.0.0:
+    resolution:
+      {
+        integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==
+      }
+    engines: { node: ^12.20.0 || ^14.13.1 || >=16.0.0 }
+    hasBin: true
+
+  is-extglob@2.1.1:
+    resolution:
+      {
+        integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==
+      }
+    engines: { node: '>=0.10.0' }
+
+  is-fullwidth-code-point@3.0.0:
+    resolution:
+      {
+        integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==
+      }
+    engines: { node: '>=8' }
+
+  is-fullwidth-code-point@4.0.0:
+    resolution:
+      {
+        integrity: sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==
+      }
+    engines: { node: '>=12' }
+
+  is-fullwidth-code-point@5.1.0:
+    resolution:
+      {
+        integrity: sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ==
+      }
+    engines: { node: '>=18' }
+
+  is-glob@4.0.3:
+    resolution:
+      {
+        integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==
+      }
+    engines: { node: '>=0.10.0' }
+
+  is-hotkey@0.2.0:
+    resolution:
+      {
+        integrity: sha512-UknnZK4RakDmTgz4PI1wIph5yxSs/mvChWs9ifnlXsKuXgWmOkY/hAE0H/k2MIqH0RlRye0i1oC07MCRSD28Mw==
+      }
+
+  is-inside-container@1.0.0:
+    resolution:
+      {
+        integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==
+      }
+    engines: { node: '>=14.16' }
+    hasBin: true
+
+  is-interactive@1.0.0:
+    resolution:
+      {
+        integrity: sha512-2HvIEKRoqS62guEC+qBjpvRubdX910WCMuJTZ+I9yvqKU2/12eSL549HMwtabb4oupdj2sMP50k+XJfB/8JE6w==
+      }
+    engines: { node: '>=8' }
+
+  is-number@7.0.0:
+    resolution:
+      {
+        integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==
+      }
+    engines: { node: '>=0.12.0' }
+
+  is-obj@2.0.0:
+    resolution:
+      {
+        integrity: sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w==
+      }
+    engines: { node: '>=8' }
+
+  is-plain-obj@4.1.0:
+    resolution:
+      {
+        integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==
+      }
+    engines: { node: '>=12' }
+
+  is-plain-object@5.0.0:
+    resolution:
+      {
+        integrity: sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==
+      }
+    engines: { node: '>=0.10.0' }
+
+  is-stream@3.0.0:
+    resolution:
+      {
+        integrity: sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==
+      }
+    engines: { node: ^12.20.0 || ^14.13.1 || >=16.0.0 }
+
+  is-stream@4.0.1:
+    resolution:
+      {
+        integrity: sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A==
+      }
+    engines: { node: '>=18' }
+
+  is-text-path@2.0.0:
+    resolution:
+      {
+        integrity: sha512-+oDTluR6WEjdXEJMnC2z6A4FRwFoYuvShVVEGsS7ewc0UTi2QtAKMDJuL4BDEVt+5T7MjFo12RP8ghOM75oKJw==
+      }
+    engines: { node: '>=8' }
+
+  is-unicode-supported@0.1.0:
+    resolution:
+      {
+        integrity: sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==
+      }
+    engines: { node: '>=10' }
+
+  is-unicode-supported@2.1.0:
+    resolution:
+      {
+        integrity: sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==
+      }
+    engines: { node: '>=18' }
+
+  is-url@1.2.4:
+    resolution:
+      {
+        integrity: sha512-ITvGim8FhRiYe4IQ5uHSkj7pVaPDrCTkNd3yq3cV7iZAcJdHTUMPMEHcqSOy9xZ9qFenQCvi+2wjH9a1nXqHww==
+      }
+
+  is-utf8@0.2.1:
+    resolution:
+      {
+        integrity: sha512-rMYPYvCzsXywIsldgLaSoPlw5PfoB/ssr7hY4pLfcodrA5M/eArza1a9VmTiNIBNMjOGr1Ow9mTyU2o69U6U9Q==
+      }
+
+  is-what@4.1.16:
+    resolution:
+      {
+        integrity: sha512-ZhMwEosbFJkA0YhFnNDgTM4ZxDRsS6HqTo7qsZM08fehyRYIYa0yHu5R6mgo1n/8MgaPBXiPimPD77baVFYg+A==
+      }
+    engines: { node: '>=12.13' }
+
+  is-windows@1.0.2:
+    resolution:
+      {
+        integrity: sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==
+      }
+    engines: { node: '>=0.10.0' }
+
+  is-wsl@2.2.0:
+    resolution:
+      {
+        integrity: sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==
+      }
+    engines: { node: '>=8' }
+
+  is-wsl@3.1.0:
+    resolution:
+      {
+        integrity: sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==
+      }
+    engines: { node: '>=16' }
+
+  isexe@2.0.0:
+    resolution:
+      {
+        integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==
+      }
+
+  jiti@2.6.0:
+    resolution:
+      {
+        integrity: sha512-VXe6RjJkBPj0ohtqaO8vSWP3ZhAKo66fKrFNCll4BTcwljPLz03pCbaNKfzGP5MbrCYcbJ7v0nOYYwUzTEIdXQ==
+      }
+    hasBin: true
+
+  js-tokens@4.0.0:
+    resolution:
+      {
+        integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==
+      }
+
+  js-tokens@9.0.1:
+    resolution:
+      {
+        integrity: sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==
+      }
+
+  js-yaml@4.1.0:
+    resolution:
+      {
+        integrity: sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==
+      }
+    hasBin: true
+
+  jsesc@3.1.0:
+    resolution:
+      {
+        integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==
+      }
+    engines: { node: '>=6' }
+    hasBin: true
+
+  json-buffer@3.0.1:
+    resolution:
+      {
+        integrity: sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==
+      }
+
+  json-parse-even-better-errors@2.3.1:
+    resolution:
+      {
+        integrity: sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==
+      }
+
+  json-schema-traverse@0.4.1:
+    resolution:
+      {
+        integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==
+      }
+
+  json-schema-traverse@1.0.0:
+    resolution:
+      {
+        integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==
+      }
+
+  json-stable-stringify-without-jsonify@1.0.1:
+    resolution:
+      {
+        integrity: sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==
+      }
+
+  json5@2.2.3:
+    resolution:
+      {
+        integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==
+      }
+    engines: { node: '>=6' }
+    hasBin: true
+
+  jsonfile@6.2.0:
+    resolution:
+      {
+        integrity: sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==
+      }
+
+  jsonparse@1.3.1:
+    resolution:
+      {
+        integrity: sha512-POQXvpdL69+CluYsillJ7SUhKvytYjW9vG/GKpnf+xP8UWgYEM/RaMzHHofbALDiKbbP1W8UEYmgGl39WkPZsg==
+      }
+    engines: { '0': node >= 0.2.0 }
+
+  keyv@4.5.4:
+    resolution:
+      {
+        integrity: sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==
+      }
+
+  keyv@5.5.3:
+    resolution:
+      {
+        integrity: sha512-h0Un1ieD+HUrzBH6dJXhod3ifSghk5Hw/2Y4/KHBziPlZecrFyE9YOTPU6eOs0V9pYl8gOs86fkr/KN8lUX39A==
+      }
+
+  kind-of@6.0.3:
+    resolution:
+      {
+        integrity: sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==
+      }
+    engines: { node: '>=0.10.0' }
+
+  known-css-properties@0.36.0:
+    resolution:
+      {
+        integrity: sha512-A+9jP+IUmuQsNdsLdcg6Yt7voiMF/D4K83ew0OpJtpu+l34ef7LaohWV0Rc6KNvzw6ZDizkqfyB5JznZnzuKQA==
+      }
+
+  known-css-properties@0.37.0:
+    resolution:
+      {
+        integrity: sha512-JCDrsP4Z1Sb9JwG0aJ8Eo2r7k4Ou5MwmThS/6lcIe1ICyb7UBJKGRIUUdqc2ASdE/42lgz6zFUnzAIhtXnBVrQ==
+      }
+
+  kolorist@1.8.0:
+    resolution:
+      {
+        integrity: sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ==
+      }
+
+  levn@0.4.1:
+    resolution:
+      {
+        integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==
+      }
+    engines: { node: '>= 0.8.0' }
+
+  lightningcss-darwin-arm64@1.30.1:
+    resolution:
+      {
+        integrity: sha512-c8JK7hyE65X1MHMN+Viq9n11RRC7hgin3HhYKhrMyaXflk5GVplZ60IxyoVtzILeKr+xAJwg6zK6sjTBJ0FKYQ==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [arm64]
+    os: [darwin]
+
+  lightningcss-darwin-x64@1.30.1:
+    resolution:
+      {
+        integrity: sha512-k1EvjakfumAQoTfcXUcHQZhSpLlkAuEkdMBsI/ivWw9hL+7FtilQc0Cy3hrx0AAQrVtQAbMI7YjCgYgvn37PzA==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [x64]
+    os: [darwin]
+
+  lightningcss-freebsd-x64@1.30.1:
+    resolution:
+      {
+        integrity: sha512-kmW6UGCGg2PcyUE59K5r0kWfKPAVy4SltVeut+umLCFoJ53RdCUWxcRDzO1eTaxf/7Q2H7LTquFHPL5R+Gjyig==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [x64]
+    os: [freebsd]
+
+  lightningcss-linux-arm-gnueabihf@1.30.1:
+    resolution:
+      {
+        integrity: sha512-MjxUShl1v8pit+6D/zSPq9S9dQ2NPFSQwGvxBCYaBYLPlCWuPh9/t1MRS8iUaR8i+a6w7aps+B4N0S1TYP/R+Q==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [arm]
+    os: [linux]
+
+  lightningcss-linux-arm64-gnu@1.30.1:
+    resolution:
+      {
+        integrity: sha512-gB72maP8rmrKsnKYy8XUuXi/4OctJiuQjcuqWNlJQ6jZiWqtPvqFziskH3hnajfvKB27ynbVCucKSm2rkQp4Bw==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  lightningcss-linux-arm64-musl@1.30.1:
+    resolution:
+      {
+        integrity: sha512-jmUQVx4331m6LIX+0wUhBbmMX7TCfjF5FoOH6SD1CttzuYlGNVpA7QnrmLxrsub43ClTINfGSYyHe2HWeLl5CQ==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  lightningcss-linux-x64-gnu@1.30.1:
+    resolution:
+      {
+        integrity: sha512-piWx3z4wN8J8z3+O5kO74+yr6ze/dKmPnI7vLqfSqI8bccaTGY5xiSGVIJBDd5K5BHlvVLpUB3S2YCfelyJ1bw==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  lightningcss-linux-x64-musl@1.30.1:
+    resolution:
+      {
+        integrity: sha512-rRomAK7eIkL+tHY0YPxbc5Dra2gXlI63HL+v1Pdi1a3sC+tJTcFrHX+E86sulgAXeI7rSzDYhPSeHHjqFhqfeQ==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  lightningcss-win32-arm64-msvc@1.30.1:
+    resolution:
+      {
+        integrity: sha512-mSL4rqPi4iXq5YVqzSsJgMVFENoa4nGTT/GjO2c0Yl9OuQfPsIfncvLrEW6RbbB24WtZ3xP/2CCmI3tNkNV4oA==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [arm64]
+    os: [win32]
+
+  lightningcss-win32-x64-msvc@1.30.1:
+    resolution:
+      {
+        integrity: sha512-PVqXh48wh4T53F/1CCu8PIPCxLzWyCnn/9T5W1Jpmdy5h9Cwd+0YQS6/LwhHXSafuc61/xg9Lv5OrCby6a++jg==
+      }
+    engines: { node: '>= 12.0.0' }
+    cpu: [x64]
+    os: [win32]
+
+  lightningcss@1.30.1:
+    resolution:
+      {
+        integrity: sha512-xi6IyHML+c9+Q3W0S4fCQJOym42pyurFiJUHEcEyHS0CeKzia4yZDEsLlqOFykxOdHpNy0NmvVO31vcSqAxJCg==
+      }
+    engines: { node: '>= 12.0.0' }
+
+  lilconfig@3.1.3:
+    resolution:
+      {
+        integrity: sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==
+      }
+    engines: { node: '>=14' }
+
+  lines-and-columns@1.2.4:
+    resolution:
+      {
+        integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==
+      }
+
+  lint-staged@15.5.2:
+    resolution:
+      {
+        integrity: sha512-YUSOLq9VeRNAo/CTaVmhGDKG+LBtA8KF1X4K5+ykMSwWST1vDxJRB2kv2COgLb1fvpCo+A/y9A0G0znNVmdx4w==
+      }
+    engines: { node: '>=18.12.0' }
+    hasBin: true
+
+  listr2@8.3.3:
+    resolution:
+      {
+        integrity: sha512-LWzX2KsqcB1wqQ4AHgYb4RsDXauQiqhjLk+6hjbaeHG4zpjjVAB6wC/gz6X0l+Du1cN3pUB5ZlrvTbhGSNnUQQ==
+      }
+    engines: { node: '>=18.0.0' }
+
+  local-pkg@1.1.2:
+    resolution:
+      {
+        integrity: sha512-arhlxbFRmoQHl33a0Zkle/YWlmNwoyt6QNZEIJcqNbdrsix5Lvc4HyyI3EnwxTYlZYc32EbYrQ8SzEZ7dqgg9A==
+      }
+    engines: { node: '>=14' }
+
+  locate-path@6.0.0:
+    resolution:
+      {
+        integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==
+      }
+    engines: { node: '>=10' }
+
+  locate-path@7.2.0:
+    resolution:
+      {
+        integrity: sha512-gvVijfZvn7R+2qyPX8mAuKcFGDf6Nc61GdvGafQsHL0sBIxfKzA+usWn4GFC/bk+QdwPUD4kWFJLhElipq+0VA==
+      }
+    engines: { node: ^12.20.0 || ^14.13.1 || >=16.0.0 }
+
+  lodash-es@4.17.21:
+    resolution:
+      {
+        integrity: sha512-mKnC+QJ9pWVzv+C4/U3rRsHapFfHvQFoFB92e52xeyGMcX6/OlIl78je1u8vePzYZSkkogMPJ2yjxxsb89cxyw==
+      }
+
+  lodash-unified@1.0.3:
+    resolution:
+      {
+        integrity: sha512-WK9qSozxXOD7ZJQlpSqOT+om2ZfcT4yO+03FuzAHD0wF6S0l0090LRPDx3vhTTLZ8cFKpBn+IOcVXK6qOcIlfQ==
+      }
+    peerDependencies:
+      '@types/lodash-es': '*'
+      lodash: '*'
+      lodash-es: '*'
+
+  lodash.camelcase@4.3.0:
+    resolution:
+      {
+        integrity: sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==
+      }
+
+  lodash.clonedeep@4.5.0:
+    resolution:
+      {
+        integrity: sha512-H5ZhCF25riFd9uB5UCkVKo61m3S/xZk1x4wA6yp/L3RFP6Z/eHH1ymQcGLo7J3GMPfm0V/7m1tryHuGVxpqEBQ==
+      }
+
+  lodash.debounce@4.0.8:
+    resolution:
+      {
+        integrity: sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow==
+      }
+
+  lodash.foreach@4.5.0:
+    resolution:
+      {
+        integrity: sha512-aEXTF4d+m05rVOAUG3z4vZZ4xVexLKZGF0lIxuHZ1Hplpk/3B6Z1+/ICICYRLm7c41Z2xiejbkCkJoTlypoXhQ==
+      }
+
+  lodash.isequal@4.5.0:
+    resolution:
+      {
+        integrity: sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==
+      }
+    deprecated: This package is deprecated. Use require('node:util').isDeepStrictEqual instead.
+
+  lodash.isplainobject@4.0.6:
+    resolution:
+      {
+        integrity: sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==
+      }
+
+  lodash.kebabcase@4.1.1:
+    resolution:
+      {
+        integrity: sha512-N8XRTIMMqqDgSy4VLKPnJ/+hpGZN+PHQiJnSenYqPaVV/NCqEogTnAdZLQiGKhxX+JCs8waWq2t1XHWKOmlY8g==
+      }
+
+  lodash.map@4.6.0:
+    resolution:
+      {
+        integrity: sha512-worNHGKLDetmcEYDvh2stPCrrQRkP20E4l0iIS7F8EvzMqBBi7ltvFN5m1HvTf1P7Jk1txKhvFcmYsCr8O2F1Q==
+      }
+
+  lodash.merge@4.6.2:
+    resolution:
+      {
+        integrity: sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==
+      }
+
+  lodash.mergewith@4.6.2:
+    resolution:
+      {
+        integrity: sha512-GK3g5RPZWTRSeLSpgP8Xhra+pnjBC56q9FZYe1d5RN3TJ35dbkGy3YqBSMbyCrlbi+CM9Z3Jk5yTL7RCsqboyQ==
+      }
+
+  lodash.snakecase@4.1.1:
+    resolution:
+      {
+        integrity: sha512-QZ1d4xoBHYUeuouhEq3lk3Uq7ldgyFXGBhg04+oRLnIz8o9T65Eh+8YdroUwn846zchkA9yDsDl5CVVaV2nqYw==
+      }
+
+  lodash.startcase@4.4.0:
+    resolution:
+      {
+        integrity: sha512-+WKqsK294HMSc2jEbNgpHpd0JfIBhp7rEV4aqXWqFr6AlXov+SlcgB1Fv01y2kGe3Gc8nMW7VA0SrGuSkRfIEg==
+      }
+
+  lodash.throttle@4.1.1:
+    resolution:
+      {
+        integrity: sha512-wIkUCfVKpVsWo3JSZlc+8MB5it+2AN5W8J7YVMST30UrvcQNZ1Okbj+rbVniijTWE6FGYy4XJq/rHkas8qJMLQ==
+      }
+
+  lodash.toarray@4.4.0:
+    resolution:
+      {
+        integrity: sha512-QyffEA3i5dma5q2490+SgCvDN0pXLmRGSyAANuVi0HQ01Pkfr9fuoKQW8wm1wGBnJITs/mS7wQvS6VshUEBFCw==
+      }
+
+  lodash.truncate@4.4.2:
+    resolution:
+      {
+        integrity: sha512-jttmRe7bRse52OsWIMDLaXxWqRAmtIUccAQ3garviCqJjafXOfNMO0yMfNpdD6zbGaTU0P5Nz7e7gAT6cKmJRw==
+      }
+
+  lodash.uniq@4.5.0:
+    resolution:
+      {
+        integrity: sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==
+      }
+
+  lodash.upperfirst@4.3.1:
+    resolution:
+      {
+        integrity: sha512-sReKOYJIJf74dhJONhU4e0/shzi1trVbSWDOhKYE5XV2O+H7Sb2Dihwuc7xWxVl+DgFPyTqIN3zMfT9cq5iWDg==
+      }
+
+  lodash@4.17.21:
+    resolution:
+      {
+        integrity: sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==
+      }
+
+  log-symbols@4.1.0:
+    resolution:
+      {
+        integrity: sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==
+      }
+    engines: { node: '>=10' }
+
+  log-update@6.1.0:
+    resolution:
+      {
+        integrity: sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==
+      }
+    engines: { node: '>=18' }
+
+  longest@2.0.1:
+    resolution:
+      {
+        integrity: sha512-Ajzxb8CM6WAnFjgiloPsI3bF+WCxcvhdIG3KNA2KN962+tdBsHcuQ4k4qX/EcS/2CRkcc0iAkR956Nib6aXU/Q==
+      }
+    engines: { node: '>=0.10.0' }
+
+  lru-cache@5.1.1:
+    resolution:
+      {
+        integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==
+      }
+
+  magic-string@0.30.19:
+    resolution:
+      {
+        integrity: sha512-2N21sPY9Ws53PZvsEpVtNuSW+ScYbQdp4b9qUaL+9QkHUrGFKo56Lg9Emg5s9V/qrtNBmiR01sYhUOwu3H+VOw==
+      }
+
+  math-intrinsics@1.1.0:
+    resolution:
+      {
+        integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==
+      }
+    engines: { node: '>= 0.4' }
+
+  mathml-tag-names@2.1.3:
+    resolution:
+      {
+        integrity: sha512-APMBEanjybaPzUrfqU0IMU5I0AswKMH7k8OTLs0vvV4KZpExkTkY87nR/zpbuTPj+gARop7aGUbl11pnDfW6xg==
+      }
+
+  mdn-data@2.12.2:
+    resolution:
+      {
+        integrity: sha512-IEn+pegP1aManZuckezWCO+XZQDplx1366JoVhTpMpBB1sPey/SbveZQUosKiKiGYjg1wH4pMlNgXbCiYgihQA==
+      }
+
+  mdn-data@2.24.0:
+    resolution:
+      {
+        integrity: sha512-i97fklrJl03tL1tdRVw0ZfLLvuDsdb6wxL+TrJ+PKkCbLrp2PCu2+OYdCKychIUm19nSM/35S6qz7pJpnXttoA==
+      }
+
+  memoize-one@6.0.0:
+    resolution:
+      {
+        integrity: sha512-rkpe71W0N0c0Xz6QD0eJETuWAJGnJ9afsl1srmwPrI+yBCkge5EycXXbYRyvL29zZVUWQCY7InPRCv3GDXuZNw==
+      }
+
+  meow@12.1.1:
+    resolution:
+      {
+        integrity: sha512-BhXM0Au22RwUneMPwSCnyhTOizdWoIEPU9sp0Aqa1PnDMR5Wv2FGXYDjuzJEIX+Eo2Rb8xuYe5jrnm5QowQFkw==
+      }
+    engines: { node: '>=16.10' }
+
+  meow@13.2.0:
+    resolution:
+      {
+        integrity: sha512-pxQJQzB6djGPXh08dacEloMFopsOqGVRKFPYvPOt9XDZ1HasbgDZA74CJGreSU4G3Ak7EFJGoiH2auq+yXISgA==
+      }
+    engines: { node: '>=18' }
+
+  merge-stream@2.0.0:
+    resolution:
+      {
+        integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==
+      }
+
+  merge2@1.4.1:
+    resolution:
+      {
+        integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==
+      }
+    engines: { node: '>= 8' }
+
+  merge@2.1.1:
+    resolution:
+      {
+        integrity: sha512-jz+Cfrg9GWOZbQAnDQ4hlVnQky+341Yk5ru8bZSe6sIDTCIg8n9i/u7hSQGSVOF3C7lH6mGtqjkiT9G4wFLL0w==
+      }
+
+  micromatch@4.0.8:
+    resolution:
+      {
+        integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==
+      }
+    engines: { node: '>=8.6' }
+
+  mime-db@1.52.0:
+    resolution:
+      {
+        integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==
+      }
+    engines: { node: '>= 0.6' }
+
+  mime-match@1.0.2:
+    resolution:
+      {
+        integrity: sha512-VXp/ugGDVh3eCLOBCiHZMYWQaTNUHv2IJrut+yXA6+JbLPXHglHwfS/5A5L0ll+jkCY7fIzRJcH6OIunF+c6Cg==
+      }
+
+  mime-types@2.1.35:
+    resolution:
+      {
+        integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==
+      }
+    engines: { node: '>= 0.6' }
+
+  mimic-fn@2.1.0:
+    resolution:
+      {
+        integrity: sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==
+      }
+    engines: { node: '>=6' }
+
+  mimic-fn@4.0.0:
+    resolution:
+      {
+        integrity: sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==
+      }
+    engines: { node: '>=12' }
+
+  mimic-function@5.0.1:
+    resolution:
+      {
+        integrity: sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==
+      }
+    engines: { node: '>=18' }
+
+  minimatch@3.1.2:
+    resolution:
+      {
+        integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==
+      }
+
+  minimatch@9.0.5:
+    resolution:
+      {
+        integrity: sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==
+      }
+    engines: { node: '>=16 || 14 >=14.17' }
+
+  minimist@1.2.7:
+    resolution:
+      {
+        integrity: sha512-bzfL1YUZsP41gmu/qjrEk0Q6i2ix/cVeAhbCbqH9u3zYutS1cLg00qhrD0M2MVdCcx4Sc0UpP2eBWo9rotpq6g==
+      }
+
+  minimist@1.2.8:
+    resolution:
+      {
+        integrity: sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==
+      }
+
+  minipass@7.1.2:
+    resolution:
+      {
+        integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==
+      }
+    engines: { node: '>=16 || 14 >=14.17' }
+
+  minizlib@3.1.0:
+    resolution:
+      {
+        integrity: sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==
+      }
+    engines: { node: '>= 18' }
+
+  mitt@3.0.1:
+    resolution:
+      {
+        integrity: sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==
+      }
+
+  mlly@1.8.0:
+    resolution:
+      {
+        integrity: sha512-l8D9ODSRWLe2KHJSifWGwBqpTZXIXTeo8mlKjY+E2HAakaTeNpqAyBZ8GSqLzHgw4XmHmC8whvpjJNMbFZN7/g==
+      }
+
+  mrmime@2.0.1:
+    resolution:
+      {
+        integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==
+      }
+    engines: { node: '>=10' }
+
+  ms@2.1.3:
+    resolution:
+      {
+        integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==
+      }
+
+  muggle-string@0.4.1:
+    resolution:
+      {
+        integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==
+      }
+
+  mute-stream@0.0.8:
+    resolution:
+      {
+        integrity: sha512-nnbWWOkoWyUsTjKrhgD0dcz22mdkSnpYqbEjIm2nhwhuxlSkpywJmBo8h0ZqJdkp73mb90SssHkN4rsRaBAfAA==
+      }
+
+  namespace-emitter@2.0.1:
+    resolution:
+      {
+        integrity: sha512-N/sMKHniSDJBjfrkbS/tpkPj4RAbvW3mr8UAzvlMHyun93XEm83IAvhWtJVHo+RHn/oO8Job5YN4b+wRjSVp5g==
+      }
+
+  nanoid@3.3.11:
+    resolution:
+      {
+        integrity: sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==
+      }
+    engines: { node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1 }
+    hasBin: true
+
+  nanoid@5.1.6:
+    resolution:
+      {
+        integrity: sha512-c7+7RQ+dMB5dPwwCp4ee1/iV/q2P6aK1mTZcfr1BTuVlyW9hJYiMPybJCcnBlQtuSmTIWNeazm/zqNoZSSElBg==
+      }
+    engines: { node: ^18 || >=20 }
+    hasBin: true
+
+  natural-compare@1.4.0:
+    resolution:
+      {
+        integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==
+      }
+
+  next-tick@1.1.0:
+    resolution:
+      {
+        integrity: sha512-CXdUiJembsNjuToQvxayPZF9Vqht7hewsvy2sOWafLvi2awflj9mOC6bHIg50orX8IJvWKY9wYQ/zB2kogPslQ==
+      }
+
+  node-addon-api@7.1.1:
+    resolution:
+      {
+        integrity: sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==
+      }
+
+  node-releases@2.0.21:
+    resolution:
+      {
+        integrity: sha512-5b0pgg78U3hwXkCM8Z9b2FJdPZlr9Psr9V2gQPESdGHqbntyFJKFW4r5TeWGFzafGY3hzs1JC62VEQMbl1JFkw==
+      }
+
+  normalize-path@3.0.0:
+    resolution:
+      {
+        integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==
+      }
+    engines: { node: '>=0.10.0' }
+
+  normalize-wheel-es@1.2.0:
+    resolution:
+      {
+        integrity: sha512-Wj7+EJQ8mSuXr2iWfnujrimU35R2W4FAErEyTmJoJ7ucwTn2hOUSsRehMb5RSYkxXGTM7Y9QpvPmp++w5ftoJw==
+      }
+
+  npm-run-path@5.3.0:
+    resolution:
+      {
+        integrity: sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==
+      }
+    engines: { node: ^12.20.0 || ^14.13.1 || >=16.0.0 }
+
+  npm-run-path@6.0.0:
+    resolution:
+      {
+        integrity: sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA==
+      }
+    engines: { node: '>=18' }
+
+  nprogress@0.2.0:
+    resolution:
+      {
+        integrity: sha512-I19aIingLgR1fmhftnbWWO3dXc0hSxqHQHQb3H8m+K3TnEn/iSeTZZOyvKXWqQESMwuUVnatlCnZdLBZZt2VSA==
+      }
+
+  nth-check@2.1.1:
+    resolution:
+      {
+        integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==
+      }
+
+  ohash@2.0.11:
+    resolution:
+      {
+        integrity: sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==
+      }
+
+  once@1.4.0:
+    resolution:
+      {
+        integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==
+      }
+
+  onetime@5.1.2:
+    resolution:
+      {
+        integrity: sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==
+      }
+    engines: { node: '>=6' }
+
+  onetime@6.0.0:
+    resolution:
+      {
+        integrity: sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==
+      }
+    engines: { node: '>=12' }
+
+  onetime@7.0.0:
+    resolution:
+      {
+        integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==
+      }
+    engines: { node: '>=18' }
+
+  open@10.2.0:
+    resolution:
+      {
+        integrity: sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==
+      }
+    engines: { node: '>=18' }
+
+  open@8.4.2:
+    resolution:
+      {
+        integrity: sha512-7x81NCL719oNbsq/3mh+hVrAWmFuEYUqrq/Iw3kUzH8ReypT9QQ0BLoJS7/G9k6N81XjW4qHWtjWwe/9eLy1EQ==
+      }
+    engines: { node: '>=12' }
+
+  optionator@0.9.4:
+    resolution:
+      {
+        integrity: sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==
+      }
+    engines: { node: '>= 0.8.0' }
+
+  ora@5.4.1:
+    resolution:
+      {
+        integrity: sha512-5b6Y85tPxZZ7QytO+BQzysW31HJku27cRIlkbAXaNx+BdcVi+LlRFmVXzeF6a7JCwJpyw5c4b+YSVImQIrBpuQ==
+      }
+    engines: { node: '>=10' }
+
+  os-tmpdir@1.0.2:
+    resolution:
+      {
+        integrity: sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==
+      }
+    engines: { node: '>=0.10.0' }
+
+  p-limit@3.1.0:
+    resolution:
+      {
+        integrity: sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==
+      }
+    engines: { node: '>=10' }
+
+  p-limit@4.0.0:
+    resolution:
+      {
+        integrity: sha512-5b0R4txpzjPWVw/cXXUResoD4hb6U/x9BH08L7nw+GN1sezDzPdxeRvpc9c433fZhBan/wusjbCsqwqm4EIBIQ==
+      }
+    engines: { node: ^12.20.0 || ^14.13.1 || >=16.0.0 }
+
+  p-locate@5.0.0:
+    resolution:
+      {
+        integrity: sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==
+      }
+    engines: { node: '>=10' }
+
+  p-locate@6.0.0:
+    resolution:
+      {
+        integrity: sha512-wPrq66Llhl7/4AGC6I+cqxT07LhXvWL08LNXz1fENOw0Ap4sRZZ/gZpTTJ5jpurzzzfS2W/Ge9BY3LgLjCShcw==
+      }
+    engines: { node: ^12.20.0 || ^14.13.1 || >=16.0.0 }
+
+  parent-module@1.0.1:
+    resolution:
+      {
+        integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==
+      }
+    engines: { node: '>=6' }
+
+  parse-json@5.2.0:
+    resolution:
+      {
+        integrity: sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==
+      }
+    engines: { node: '>=8' }
+
+  parse-ms@4.0.0:
+    resolution:
+      {
+        integrity: sha512-TXfryirbmq34y8QBwgqCVLi+8oA3oWx2eAnSn62ITyEhEYaWRlVZ2DvMM9eZbMs/RfxPu/PK/aBLyGj4IrqMHw==
+      }
+    engines: { node: '>=18' }
+
+  parse-passwd@1.0.0:
+    resolution:
+      {
+        integrity: sha512-1Y1A//QUXEZK7YKz+rD9WydcE1+EuPr6ZBgKecAB8tmoW6UFv0NREVJe1p+jRxtThkcbbKkfwIbWJe/IeE6m2Q==
+      }
+    engines: { node: '>=0.10.0' }
+
+  path-browserify@1.0.1:
+    resolution:
+      {
+        integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==
+      }
+
+  path-exists@4.0.0:
+    resolution:
+      {
+        integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==
+      }
+    engines: { node: '>=8' }
+
+  path-exists@5.0.0:
+    resolution:
+      {
+        integrity: sha512-RjhtfwJOxzcFmNOi6ltcbcu4Iu+FL3zEj83dk4kAS+fVpTxXLO1b38RvJgT/0QwvV/L3aY9TAnyv0EOqW4GoMQ==
+      }
+    engines: { node: ^12.20.0 || ^14.13.1 || >=16.0.0 }
+
+  path-is-absolute@1.0.1:
+    resolution:
+      {
+        integrity: sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==
+      }
+    engines: { node: '>=0.10.0' }
+
+  path-key@3.1.1:
+    resolution:
+      {
+        integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==
+      }
+    engines: { node: '>=8' }
+
+  path-key@4.0.0:
+    resolution:
+      {
+        integrity: sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==
+      }
+    engines: { node: '>=12' }
+
+  path-type@4.0.0:
+    resolution:
+      {
+        integrity: sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==
+      }
+    engines: { node: '>=8' }
+
+  pathe@2.0.3:
+    resolution:
+      {
+        integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==
+      }
+
+  perfect-debounce@1.0.0:
+    resolution:
+      {
+        integrity: sha512-xCy9V055GLEqoFaHoC1SoLIaLmWctgCUaBaWxDZ7/Zx4CTyX7cJQLJOok/orfjZAh9kEYpjJa4d0KcJmCbctZA==
+      }
+
+  picocolors@1.1.1:
+    resolution:
+      {
+        integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==
+      }
+
+  picomatch@2.3.1:
+    resolution:
+      {
+        integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==
+      }
+    engines: { node: '>=8.6' }
+
+  picomatch@4.0.3:
+    resolution:
+      {
+        integrity: sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==
+      }
+    engines: { node: '>=12' }
+
+  pidtree@0.6.0:
+    resolution:
+      {
+        integrity: sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g==
+      }
+    engines: { node: '>=0.10' }
+    hasBin: true
+
+  pinia-plugin-persistedstate@4.5.0:
+    resolution:
+      {
+        integrity: sha512-QTkP1xJVyCdr2I2p3AKUZM84/e+IS+HktRxKGAIuDzkyaKKV48mQcYkJFVVDuvTxlI5j6X3oZObpqoVB8JnWpw==
+      }
+    peerDependencies:
+      '@nuxt/kit': '>=3.0.0'
+      '@pinia/nuxt': '>=0.10.0'
+      pinia: '>=3.0.0'
+    peerDependenciesMeta:
+      '@nuxt/kit':
+        optional: true
+      '@pinia/nuxt':
+        optional: true
+      pinia:
+        optional: true
+
+  pinia@3.0.3:
+    resolution:
+      {
+        integrity: sha512-ttXO/InUULUXkMHpTdp9Fj4hLpD/2AoJdmAbAeW2yu1iy1k+pkFekQXw5VpC0/5p51IOR/jDaDRfRWRnMMsGOA==
+      }
+    peerDependencies:
+      typescript: '>=4.4.4'
+      vue: ^2.7.0 || ^3.5.11
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  pkg-types@1.3.1:
+    resolution:
+      {
+        integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==
+      }
+
+  pkg-types@2.3.0:
+    resolution:
+      {
+        integrity: sha512-SIqCzDRg0s9npO5XQ3tNZioRY1uK06lA41ynBC1YmFTmnY6FjUjVt6s4LoADmwoig1qqD0oK8h1p/8mlMx8Oig==
+      }
+
+  postcss-html@1.8.0:
+    resolution:
+      {
+        integrity: sha512-5mMeb1TgLWoRKxZ0Xh9RZDfwUUIqRrcxO2uXO+Ezl1N5lqpCiSU5Gk6+1kZediBfBHFtPCdopr2UZ2SgUsKcgQ==
+      }
+    engines: { node: ^12 || >=14 }
+
+  postcss-media-query-parser@0.2.3:
+    resolution:
+      {
+        integrity: sha512-3sOlxmbKcSHMjlUXQZKQ06jOswE7oVkXPxmZdoB1r5l0q6gTFTQSHxNxOrCccElbW7dxNytifNEo8qidX2Vsig==
+      }
+
+  postcss-resolve-nested-selector@0.1.6:
+    resolution:
+      {
+        integrity: sha512-0sglIs9Wmkzbr8lQwEyIzlDOOC9bGmfVKcJTaxv3vMmd3uo4o4DerC3En0bnmgceeql9BfC8hRkp7cg0fjdVqw==
+      }
+
+  postcss-safe-parser@6.0.0:
+    resolution:
+      {
+        integrity: sha512-FARHN8pwH+WiS2OPCxJI8FuRJpTVnn6ZNFiqAM2aeW2LwTHWWmWgIyKC6cUo0L8aeKiF/14MNvnpls6R2PBeMQ==
+      }
+    engines: { node: '>=12.0' }
+    peerDependencies:
+      postcss: ^8.3.3
+
+  postcss-safe-parser@7.0.1:
+    resolution:
+      {
+        integrity: sha512-0AioNCJZ2DPYz5ABT6bddIqlhgwhpHZ/l65YAYo0BCIn0xiDpsnTHz0gnoTGk0OXZW0JRs+cDwL8u/teRdz+8A==
+      }
+    engines: { node: '>=18.0' }
+    peerDependencies:
+      postcss: ^8.4.31
+
+  postcss-scss@4.0.9:
+    resolution:
+      {
+        integrity: sha512-AjKOeiwAitL/MXxQW2DliT28EKukvvbEWx3LBmJIRN8KfBGZbRTxNYW0kSqi1COiTZ57nZ9NW06S6ux//N1c9A==
+      }
+    engines: { node: '>=12.0' }
+    peerDependencies:
+      postcss: ^8.4.29
+
+  postcss-selector-parser@6.1.2:
+    resolution:
+      {
+        integrity: sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==
+      }
+    engines: { node: '>=4' }
+
+  postcss-selector-parser@7.1.0:
+    resolution:
+      {
+        integrity: sha512-8sLjZwK0R+JlxlYcTuVnyT2v+htpdrjDOKuMcOVdYjt52Lh8hWRYpxBPoKx/Zg+bcjc3wx6fmQevMmUztS/ccA==
+      }
+    engines: { node: '>=4' }
+
+  postcss-sorting@8.0.2:
+    resolution:
+      {
+        integrity: sha512-M9dkSrmU00t/jK7rF6BZSZauA5MAaBW4i5EnJXspMwt4iqTh/L9j6fgMnbElEOfyRyfLfVbIHj/R52zHzAPe1Q==
+      }
+    peerDependencies:
+      postcss: ^8.4.20
+
+  postcss-value-parser@4.2.0:
+    resolution:
+      {
+        integrity: sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==
+      }
+
+  postcss@8.5.6:
+    resolution:
+      {
+        integrity: sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==
+      }
+    engines: { node: ^10 || ^12 || >=14 }
+
+  preact@10.27.2:
+    resolution:
+      {
+        integrity: sha512-5SYSgFKSyhCbk6SrXyMpqjb5+MQBgfvEKE/OC+PujcY34sOpqtr+0AZQtPYx5IA6VxynQ7rUPCtKzyovpj9Bpg==
+      }
+
+  prelude-ls@1.2.1:
+    resolution:
+      {
+        integrity: sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==
+      }
+    engines: { node: '>= 0.8.0' }
+
+  prettier-linter-helpers@1.0.0:
+    resolution:
+      {
+        integrity: sha512-GbK2cP9nraSSUF9N2XwUwqfzlAFlMNYYl+ShE/V+H8a9uNl/oUqB1w2EL54Jh0OlyRSd8RfWYJ3coVS4TROP2w==
+      }
+    engines: { node: '>=6.0.0' }
+
+  prettier@3.6.2:
+    resolution:
+      {
+        integrity: sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==
+      }
+    engines: { node: '>=14' }
+    hasBin: true
+
+  pretty-ms@9.3.0:
+    resolution:
+      {
+        integrity: sha512-gjVS5hOP+M3wMm5nmNOucbIrqudzs9v/57bWRHQWLYklXqoXKrVfYW2W9+glfGsqtPgpiz5WwyEEB+ksXIx3gQ==
+      }
+    engines: { node: '>=18' }
+
+  prismjs@1.30.0:
+    resolution:
+      {
+        integrity: sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==
+      }
+    engines: { node: '>=6' }
+
+  proxy-from-env@1.1.0:
+    resolution:
+      {
+        integrity: sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==
+      }
+
+  punycode@2.3.1:
+    resolution:
+      {
+        integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==
+      }
+    engines: { node: '>=6' }
+
+  qrcode.vue@3.6.0:
+    resolution:
+      {
+        integrity: sha512-vQcl2fyHYHMjDO1GguCldJxepq2izQjBkDEEu9NENgfVKP6mv/e2SU62WbqYHGwTgWXLhxZ1NCD1dAZKHQq1fg==
+      }
+    peerDependencies:
+      vue: ^3.0.0
+
+  quansync@0.2.11:
+    resolution:
+      {
+        integrity: sha512-AifT7QEbW9Nri4tAwR5M/uzpBuqfZf+zwaEM/QkzEjj7NBuFD2rBuy0K3dE+8wltbezDV7JMA0WfnCPYRSYbXA==
+      }
+
+  queue-microtask@1.2.3:
+    resolution:
+      {
+        integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==
+      }
+
+  readable-stream@3.6.2:
+    resolution:
+      {
+        integrity: sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==
+      }
+    engines: { node: '>= 6' }
+
+  readdirp@3.6.0:
+    resolution:
+      {
+        integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==
+      }
+    engines: { node: '>=8.10.0' }
+
+  readdirp@4.1.2:
+    resolution:
+      {
+        integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==
+      }
+    engines: { node: '>= 14.18.0' }
+
+  require-directory@2.1.1:
+    resolution:
+      {
+        integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==
+      }
+    engines: { node: '>=0.10.0' }
+
+  require-from-string@2.0.2:
+    resolution:
+      {
+        integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==
+      }
+    engines: { node: '>=0.10.0' }
+
+  resolve-dir@1.0.1:
+    resolution:
+      {
+        integrity: sha512-R7uiTjECzvOsWSfdM0QKFNBVFcK27aHOUwdvK53BcW8zqnGdYp0Fbj82cy54+2A4P2tFM22J5kRfe1R+lM/1yg==
+      }
+    engines: { node: '>=0.10.0' }
+
+  resolve-from@4.0.0:
+    resolution:
+      {
+        integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==
+      }
+    engines: { node: '>=4' }
+
+  resolve-from@5.0.0:
+    resolution:
+      {
+        integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==
+      }
+    engines: { node: '>=8' }
+
+  resolve-pkg-maps@1.0.0:
+    resolution:
+      {
+        integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==
+      }
+
+  restore-cursor@3.1.0:
+    resolution:
+      {
+        integrity: sha512-l+sSefzHpj5qimhFSE5a8nufZYAM3sBSVMAPtYkmC+4EH2anSGaEMXSD0izRQbu9nfyQ9y5JrVmp7E8oZrUjvA==
+      }
+    engines: { node: '>=8' }
+
+  restore-cursor@5.1.0:
+    resolution:
+      {
+        integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==
+      }
+    engines: { node: '>=18' }
+
+  reusify@1.1.0:
+    resolution:
+      {
+        integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==
+      }
+    engines: { iojs: '>=1.0.0', node: '>=0.10.0' }
+
+  rfdc@1.4.1:
+    resolution:
+      {
+        integrity: sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==
+      }
+
+  rollup-plugin-visualizer@5.14.0:
+    resolution:
+      {
+        integrity: sha512-VlDXneTDaKsHIw8yzJAFWtrzguoJ/LnQ+lMpoVfYJ3jJF4Ihe5oYLAqLklIK/35lgUY+1yEzCkHyZ1j4A5w5fA==
+      }
+    engines: { node: '>=18' }
+    hasBin: true
+    peerDependencies:
+      rolldown: 1.x
+      rollup: 2.x || 3.x || 4.x
+    peerDependenciesMeta:
+      rolldown:
+        optional: true
+      rollup:
+        optional: true
+
+  rollup@4.52.3:
+    resolution:
+      {
+        integrity: sha512-RIDh866U8agLgiIcdpB+COKnlCreHJLfIhWC3LVflku5YHfpnsIKigRZeFfMfCc4dVcqNVfQQ5gO/afOck064A==
+      }
+    engines: { node: '>=18.0.0', npm: '>=8.0.0' }
+    hasBin: true
+
+  run-applescript@7.1.0:
+    resolution:
+      {
+        integrity: sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==
+      }
+    engines: { node: '>=18' }
+
+  run-async@2.4.1:
+    resolution:
+      {
+        integrity: sha512-tvVnVv01b8c1RrA6Ep7JkStj85Guv/YrMcwqYQnwjsAS2cTmmPGBBjAjpCW7RrSodNSoE2/qg9O4bceNvUuDgQ==
+      }
+    engines: { node: '>=0.12.0' }
+
+  run-parallel@1.2.0:
+    resolution:
+      {
+        integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==
+      }
+
+  rxjs@7.8.2:
+    resolution:
+      {
+        integrity: sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==
+      }
+
+  safe-buffer@5.2.1:
+    resolution:
+      {
+        integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==
+      }
+
+  safer-buffer@2.1.2:
+    resolution:
+      {
+        integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==
+      }
+
+  sass@1.93.2:
+    resolution:
+      {
+        integrity: sha512-t+YPtOQHpGW1QWsh1CHQ5cPIr9lbbGZLZnbihP/D/qZj/yuV68m8qarcV17nvkOX81BCrvzAlq2klCQFZghyTg==
+      }
+    engines: { node: '>=14.0.0' }
+    hasBin: true
+
+  scroll-into-view-if-needed@2.2.31:
+    resolution:
+      {
+        integrity: sha512-dGCXy99wZQivjmjIqihaBQNjryrz5rueJY7eHfTdyWEiR4ttYpsajb14rn9s5d4DY4EcY6+4+U/maARBXJedkA==
+      }
+
+  scule@1.3.0:
+    resolution:
+      {
+        integrity: sha512-6FtHJEvt+pVMIB9IBY+IcCJ6Z5f1iQnytgyfKMhDKgmzYG+TeH/wx1y3l27rshSbLiSanrR9ffZDrEsmjlQF2g==
+      }
+
+  semver@6.3.1:
+    resolution:
+      {
+        integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==
+      }
+    hasBin: true
+
+  semver@7.7.2:
+    resolution:
+      {
+        integrity: sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==
+      }
+    engines: { node: '>=10' }
+    hasBin: true
+
+  shebang-command@2.0.0:
+    resolution:
+      {
+        integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==
+      }
+    engines: { node: '>=8' }
+
+  shebang-regex@3.0.0:
+    resolution:
+      {
+        integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==
+      }
+    engines: { node: '>=8' }
+
+  signal-exit@3.0.7:
+    resolution:
+      {
+        integrity: sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==
+      }
+
+  signal-exit@4.1.0:
+    resolution:
+      {
+        integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==
+      }
+    engines: { node: '>=14' }
+
+  sirv@3.0.2:
+    resolution:
+      {
+        integrity: sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==
+      }
+    engines: { node: '>=18' }
+
+  slash@3.0.0:
+    resolution:
+      {
+        integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==
+      }
+    engines: { node: '>=8' }
+
+  slate-history@0.66.0:
+    resolution:
+      {
+        integrity: sha512-6MWpxGQZiMvSINlCbMW43E2YBSVMCMCIwQfBzGssjWw4kb0qfvj0pIdblWNRQZD0hR6WHP+dHHgGSeVdMWzfng==
+      }
+    peerDependencies:
+      slate: '>=0.65.3'
+
+  slate@0.72.8:
+    resolution:
+      {
+        integrity: sha512-/nJwTswQgnRurpK+bGJFH1oM7naD5qDmHd89JyiKNT2oOKD8marW0QSBtuFnwEbL5aGCS8AmrhXQgNOsn4osAw==
+      }
+
+  slice-ansi@4.0.0:
+    resolution:
+      {
+        integrity: sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==
+      }
+    engines: { node: '>=10' }
+
+  slice-ansi@5.0.0:
+    resolution:
+      {
+        integrity: sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==
+      }
+    engines: { node: '>=12' }
+
+  slice-ansi@7.1.2:
+    resolution:
+      {
+        integrity: sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w==
+      }
+    engines: { node: '>=18' }
+
+  snabbdom@3.6.2:
+    resolution:
+      {
+        integrity: sha512-ig5qOnCDbugFntKi6c7Xlib8bA6xiJVk8O+WdFrV3wxbMqeHO0hXFQC4nAhPVWfZfi8255lcZkNhtIBINCc4+Q==
+      }
+    engines: { node: '>=12.17.0' }
+
+  source-map-js@1.2.1:
+    resolution:
+      {
+        integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==
+      }
+    engines: { node: '>=0.10.0' }
+
+  source-map-support@0.5.21:
+    resolution:
+      {
+        integrity: sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==
+      }
+
+  source-map@0.6.1:
+    resolution:
+      {
+        integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==
+      }
+    engines: { node: '>=0.10.0' }
+
+  source-map@0.7.6:
+    resolution:
+      {
+        integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==
+      }
+    engines: { node: '>= 12' }
+
+  speakingurl@14.0.1:
+    resolution:
+      {
+        integrity: sha512-1POYv7uv2gXoyGFpBCmpDVSNV74IfsWlDW216UPjbWufNf+bSU6GdbDsxdcxtfwb4xlI3yxzOTKClUosxARYrQ==
+      }
+    engines: { node: '>=0.10.0' }
+
+  split2@4.2.0:
+    resolution:
+      {
+        integrity: sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==
+      }
+    engines: { node: '>= 10.x' }
+
+  ssf@0.11.2:
+    resolution:
+      {
+        integrity: sha512-+idbmIXoYET47hH+d7dfm2epdOMUDjqcB4648sTZ+t2JwoyBFL/insLfB/racrDmsKB3diwsDA696pZMieAC5g==
+      }
+    engines: { node: '>=0.8' }
+
+  ssr-window@3.0.0:
+    resolution:
+      {
+        integrity: sha512-q+8UfWDg9Itrg0yWK7oe5p/XRCJpJF9OBtXfOPgSJl+u3Xd5KI328RUEvUqSMVM9CiQUEf1QdBzJMkYGErj9QA==
+      }
+
+  string-argv@0.3.2:
+    resolution:
+      {
+        integrity: sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==
+      }
+    engines: { node: '>=0.6.19' }
+
+  string-width@4.2.3:
+    resolution:
+      {
+        integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
+      }
+    engines: { node: '>=8' }
+
+  string-width@7.2.0:
+    resolution:
+      {
+        integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==
+      }
+    engines: { node: '>=18' }
+
+  string_decoder@1.3.0:
+    resolution:
+      {
+        integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==
+      }
+
+  strip-ansi@6.0.1:
+    resolution:
+      {
+        integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
+      }
+    engines: { node: '>=8' }
+
+  strip-ansi@7.1.2:
+    resolution:
+      {
+        integrity: sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==
+      }
+    engines: { node: '>=12' }
+
+  strip-bom@4.0.0:
+    resolution:
+      {
+        integrity: sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==
+      }
+    engines: { node: '>=8' }
+
+  strip-final-newline@3.0.0:
+    resolution:
+      {
+        integrity: sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==
+      }
+    engines: { node: '>=12' }
+
+  strip-final-newline@4.0.0:
+    resolution:
+      {
+        integrity: sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw==
+      }
+    engines: { node: '>=18' }
+
+  strip-json-comments@3.1.1:
+    resolution:
+      {
+        integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==
+      }
+    engines: { node: '>=8' }
+
+  strip-literal@3.1.0:
+    resolution:
+      {
+        integrity: sha512-8r3mkIM/2+PpjHoOtiAW8Rg3jJLHaV7xPwG+YRGrv6FP0wwk/toTpATxWYOW0BKdWwl82VT2tFYi5DlROa0Mxg==
+      }
+
+  stylelint-config-html@1.1.0:
+    resolution:
+      {
+        integrity: sha512-IZv4IVESjKLumUGi+HWeb7skgO6/g4VMuAYrJdlqQFndgbj6WJAXPhaysvBiXefX79upBdQVumgYcdd17gCpjQ==
+      }
+    engines: { node: ^12 || >=14 }
+    peerDependencies:
+      postcss-html: ^1.0.0
+      stylelint: '>=14.0.0'
+
+  stylelint-config-recess-order@4.6.0:
+    resolution:
+      {
+        integrity: sha512-V76fhv3YtcNXh/hyAuAdSzi5FmcrG54Mp2AThJ3D/PTMTSYzUPd7GIhP6z9mTqnRhmkk6YTfcu/JWB8h+Yrcaw==
+      }
+    peerDependencies:
+      stylelint: '>=15'
+
+  stylelint-config-recommended-scss@14.1.0:
+    resolution:
+      {
+        integrity: sha512-bhaMhh1u5dQqSsf6ri2GVWWQW5iUjBYgcHkh7SgDDn92ijoItC/cfO/W+fpXshgTQWhwFkP1rVcewcv4jaftRg==
+      }
+    engines: { node: '>=18.12.0' }
+    peerDependencies:
+      postcss: ^8.3.3
+      stylelint: ^16.6.1
+    peerDependenciesMeta:
+      postcss:
+        optional: true
+
+  stylelint-config-recommended-vue@1.6.1:
+    resolution:
+      {
+        integrity: sha512-lLW7hTIMBiTfjenGuDq2kyHA6fBWd/+Df7MO4/AWOxiFeXP9clbpKgg27kHfwA3H7UNMGC7aeP3mNlZB5LMmEQ==
+      }
+    engines: { node: ^12 || >=14 }
+    peerDependencies:
+      postcss-html: ^1.0.0
+      stylelint: '>=14.0.0'
+
+  stylelint-config-recommended@14.0.1:
+    resolution:
+      {
+        integrity: sha512-bLvc1WOz/14aPImu/cufKAZYfXs/A/owZfSMZ4N+16WGXLoX5lOir53M6odBxvhgmgdxCVnNySJmZKx73T93cg==
+      }
+    engines: { node: '>=18.12.0' }
+    peerDependencies:
+      stylelint: ^16.1.0
+
+  stylelint-config-recommended@17.0.0:
+    resolution:
+      {
+        integrity: sha512-WaMSdEiPfZTSFVoYmJbxorJfA610O0tlYuU2aEwY33UQhSPgFbClrVJYWvy3jGJx+XW37O+LyNLiZOEXhKhJmA==
+      }
+    engines: { node: '>=18.12.0' }
+    peerDependencies:
+      stylelint: ^16.23.0
+
+  stylelint-config-standard@36.0.1:
+    resolution:
+      {
+        integrity: sha512-8aX8mTzJ6cuO8mmD5yon61CWuIM4UD8Q5aBcWKGSf6kg+EC3uhB+iOywpTK4ca6ZL7B49en8yanOFtUW0qNzyw==
+      }
+    engines: { node: '>=18.12.0' }
+    peerDependencies:
+      stylelint: ^16.1.0
+
+  stylelint-order@6.0.4:
+    resolution:
+      {
+        integrity: sha512-0UuKo4+s1hgQ/uAxlYU4h0o0HS4NiQDud0NAUNI0aa8FJdmYHA5ZZTFHiV5FpmE3071e9pZx5j0QpVJW5zOCUA==
+      }
+    peerDependencies:
+      stylelint: ^14.0.0 || ^15.0.0 || ^16.0.1
+
+  stylelint-scss@6.12.1:
+    resolution:
+      {
+        integrity: sha512-UJUfBFIvXfly8WKIgmqfmkGKPilKB4L5j38JfsDd+OCg2GBdU0vGUV08Uw82tsRZzd4TbsUURVVNGeOhJVF7pA==
+      }
+    engines: { node: '>=18.12.0' }
+    peerDependencies:
+      stylelint: ^16.0.2
+
+  stylelint@16.24.0:
+    resolution:
+      {
+        integrity: sha512-7ksgz3zJaSbTUGr/ujMXvLVKdDhLbGl3R/3arNudH7z88+XZZGNLMTepsY28WlnvEFcuOmUe7fg40Q3lfhOfSQ==
+      }
+    engines: { node: '>=18.12.0' }
+    hasBin: true
+
+  superjson@2.2.2:
+    resolution:
+      {
+        integrity: sha512-5JRxVqC8I8NuOUjzBbvVJAKNM8qoVuH0O77h4WInc/qC2q5IreqKxYwgkga3PfA22OayK2ikceb/B26dztPl+Q==
+      }
+    engines: { node: '>=16' }
+
+  supports-color@5.5.0:
+    resolution:
+      {
+        integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==
+      }
+    engines: { node: '>=4' }
+
+  supports-color@7.2.0:
+    resolution:
+      {
+        integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==
+      }
+    engines: { node: '>=8' }
+
+  supports-hyperlinks@3.2.0:
+    resolution:
+      {
+        integrity: sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig==
+      }
+    engines: { node: '>=14.18' }
+
+  svg-tags@1.0.0:
+    resolution:
+      {
+        integrity: sha512-ovssysQTa+luh7A5Weu3Rta6FJlFBBbInjOh722LIt6klpU2/HtdUbszju/G4devcvk8PGt7FCLv5wftu3THUA==
+      }
+
+  synckit@0.11.11:
+    resolution:
+      {
+        integrity: sha512-MeQTA1r0litLUf0Rp/iisCaL8761lKAZHaimlbGK4j0HysC4PLfqygQj9srcs0m2RdtDYnF8UuYyKpbjHYp7Jw==
+      }
+    engines: { node: ^14.18.0 || >=16.0.0 }
+
+  table@6.9.0:
+    resolution:
+      {
+        integrity: sha512-9kY+CygyYM6j02t5YFHbNz2FN5QmYGv9zAjVp4lCDjlCw7amdckXlEt/bjMhUIfj4ThGRE4gCUH5+yGnNuPo5A==
+      }
+    engines: { node: '>=10.0.0' }
+
+  tailwindcss@4.1.14:
+    resolution:
+      {
+        integrity: sha512-b7pCxjGO98LnxVkKjaZSDeNuljC4ueKUddjENJOADtubtdo8llTaJy7HwBMeLNSSo2N5QIAgklslK1+Ir8r6CA==
+      }
+
+  tapable@2.3.0:
+    resolution:
+      {
+        integrity: sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==
+      }
+    engines: { node: '>=6' }
+
+  tar@7.5.1:
+    resolution:
+      {
+        integrity: sha512-nlGpxf+hv0v7GkWBK2V9spgactGOp0qvfWRxUMjqHyzrt3SgwE48DIv/FhqPHJYLHpgW1opq3nERbz5Anq7n1g==
+      }
+    engines: { node: '>=18' }
+
+  terser@5.44.0:
+    resolution:
+      {
+        integrity: sha512-nIVck8DK+GM/0Frwd+nIhZ84pR/BX7rmXMfYwyg+Sri5oGVE99/E3KvXqpC2xHFxyqXyGHTKBSioxxplrO4I4w==
+      }
+    engines: { node: '>=10' }
+    hasBin: true
+
+  text-extensions@2.4.0:
+    resolution:
+      {
+        integrity: sha512-te/NtwBwfiNRLf9Ijqx3T0nlqZiQ2XrrtBvu+cLL8ZRrGkO0NHTug8MYFKyoSrv/sHTaSKfilUkizV6XhxMJ3g==
+      }
+    engines: { node: '>=8' }
+
+  through@2.3.8:
+    resolution:
+      {
+        integrity: sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==
+      }
+
+  tiny-warning@1.0.3:
+    resolution:
+      {
+        integrity: sha512-lBN9zLN/oAf68o3zNXYrdCt1kP8WsiGW8Oo2ka41b2IM5JL/S1CTyX1rW0mb/zSuJun0ZUrDxx4sqvYS2FWzPA==
+      }
+
+  tinyexec@1.0.1:
+    resolution:
+      {
+        integrity: sha512-5uC6DDlmeqiOwCPmK9jMSdOuZTh8bU39Ys6yidB+UTt5hfZUPGAypSgFRiEp+jbi9qH40BLDvy85jIU88wKSqw==
+      }
+
+  tinyglobby@0.2.15:
+    resolution:
+      {
+        integrity: sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==
+      }
+    engines: { node: '>=12.0.0' }
+
+  tmp@0.0.33:
+    resolution:
+      {
+        integrity: sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==
+      }
+    engines: { node: '>=0.6.0' }
+
+  to-regex-range@5.0.1:
+    resolution:
+      {
+        integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==
+      }
+    engines: { node: '>=8.0' }
+
+  totalist@3.0.1:
+    resolution:
+      {
+        integrity: sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ==
+      }
+    engines: { node: '>=6' }
+
+  ts-api-utils@2.1.0:
+    resolution:
+      {
+        integrity: sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==
+      }
+    engines: { node: '>=18.12' }
+    peerDependencies:
+      typescript: '>=4.8.4'
+
+  tslib@2.3.0:
+    resolution:
+      {
+        integrity: sha512-N82ooyxVNm6h1riLCoyS9e3fuJ3AMG2zIZs2Gd1ATcSFjSA23Q0fzjjZeh0jbJvWVDZ0cJT8yaNNaaXHzueNjg==
+      }
+
+  tslib@2.8.1:
+    resolution:
+      {
+        integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==
+      }
+
+  tsx@4.20.6:
+    resolution:
+      {
+        integrity: sha512-ytQKuwgmrrkDTFP4LjR0ToE2nqgy886GpvRSpU0JAnrdBYppuY5rLkRUYPU1yCryb24SsKBTL/hlDQAEFVwtZg==
+      }
+    engines: { node: '>=18.0.0' }
+    hasBin: true
+
+  type-check@0.4.0:
+    resolution:
+      {
+        integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==
+      }
+    engines: { node: '>= 0.8.0' }
+
+  type-fest@0.20.2:
+    resolution:
+      {
+        integrity: sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==
+      }
+    engines: { node: '>=10' }
+
+  type-fest@0.21.3:
+    resolution:
+      {
+        integrity: sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==
+      }
+    engines: { node: '>=10' }
+
+  type@2.7.3:
+    resolution:
+      {
+        integrity: sha512-8j+1QmAbPvLZow5Qpi6NCaN8FB60p/6x8/vfNqOk/hC+HuvFZhL4+WfekuhQLiqFZXOgQdrs3B+XxEmCc6b3FQ==
+      }
+
+  typescript-eslint@8.44.1:
+    resolution:
+      {
+        integrity: sha512-0ws8uWGrUVTjEeN2OM4K1pLKHK/4NiNP/vz6ns+LjT/6sqpaYzIVFajZb1fj/IDwpsrrHb3Jy0Qm5u9CPcKaeg==
+      }
+    engines: { node: ^18.18.0 || ^20.9.0 || >=21.1.0 }
+    peerDependencies:
+      eslint: ^8.57.0 || ^9.0.0
+      typescript: '>=4.8.4 <6.0.0'
+
+  typescript@5.6.3:
+    resolution:
+      {
+        integrity: sha512-hjcS1mhfuyi4WW8IWtjP7brDrG2cuDZukyrYrSauoXGNgx0S7zceP07adYkJycEr56BOUTNPzbInooiN3fn1qw==
+      }
+    engines: { node: '>=14.17' }
+    hasBin: true
+
+  ufo@1.6.1:
+    resolution:
+      {
+        integrity: sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA==
+      }
+
+  undici-types@7.14.0:
+    resolution:
+      {
+        integrity: sha512-QQiYxHuyZ9gQUIrmPo3IA+hUl4KYk8uSA7cHrcKd/l3p1OTpZcM0Tbp9x7FAtXdAYhlasd60ncPpgu6ihG6TOA==
+      }
+
+  unicorn-magic@0.1.0:
+    resolution:
+      {
+        integrity: sha512-lRfVq8fE8gz6QMBuDM6a+LO3IAzTi05H6gCVaUpir2E1Rwpo4ZUog45KpNXKC/Mn3Yb9UDuHumeFTo9iV/D9FQ==
+      }
+    engines: { node: '>=18' }
+
+  unicorn-magic@0.3.0:
+    resolution:
+      {
+        integrity: sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==
+      }
+    engines: { node: '>=18' }
+
+  unimport@5.4.0:
+    resolution:
+      {
+        integrity: sha512-g/OLFZR2mEfqbC6NC9b2225eCJGvufxq34mj6kM3OmI5gdSL0qyqtnv+9qmsGpAmnzSl6x0IWZj4W+8j2hLkMA==
+      }
+    engines: { node: '>=18.12.0' }
+
+  universalify@2.0.1:
+    resolution:
+      {
+        integrity: sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==
+      }
+    engines: { node: '>= 10.0.0' }
+
+  unplugin-auto-import@20.2.0:
+    resolution:
+      {
+        integrity: sha512-vfBI/SvD9hJqYNinipVOAj5n8dS8DJXFlCKFR5iLDp2SaQwsfdnfLXgZ+34Kd3YY3YEY9omk8XQg0bwos3Q8ug==
+      }
+    engines: { node: '>=14' }
+    peerDependencies:
+      '@nuxt/kit': ^4.0.0
+      '@vueuse/core': '*'
+    peerDependenciesMeta:
+      '@nuxt/kit':
+        optional: true
+      '@vueuse/core':
+        optional: true
+
+  unplugin-element-plus@0.10.0:
+    resolution:
+      {
+        integrity: sha512-oRSW0x6U58xBOWKy8TcoVZNA8ElIpfp3TUJRLQI6ey/E9PpjHl9/deeTAZNt8D57Li4OA4pCJtM6p2cb4Ff4ZA==
+      }
+    engines: { node: '>=18.12.0' }
+
+  unplugin-utils@0.2.5:
+    resolution:
+      {
+        integrity: sha512-gwXJnPRewT4rT7sBi/IvxKTjsms7jX7QIDLOClApuZwR49SXbrB1z2NLUZ+vDHyqCj/n58OzRRqaW+B8OZi8vg==
+      }
+    engines: { node: '>=18.12.0' }
+
+  unplugin-utils@0.3.0:
+    resolution:
+      {
+        integrity: sha512-JLoggz+PvLVMJo+jZt97hdIIIZ2yTzGgft9e9q8iMrC4ewufl62ekeW7mixBghonn2gVb/ICjyvlmOCUBnJLQg==
+      }
+    engines: { node: '>=20.19.0' }
+
+  unplugin-vue-components@29.1.0:
+    resolution:
+      {
+        integrity: sha512-z/9ACPXth199s9aCTCdKZAhe5QGOpvzJYP+Hkd0GN1/PpAmsu+W3UlRY3BJAewPqQxh5xi56+Og6mfiCV1Jzpg==
+      }
+    engines: { node: '>=14' }
+    peerDependencies:
+      '@babel/parser': ^7.15.8
+      '@nuxt/kit': ^3.2.2 || ^4.0.0
+      vue: 2 || 3
+    peerDependenciesMeta:
+      '@babel/parser':
+        optional: true
+      '@nuxt/kit':
+        optional: true
+
+  unplugin@2.3.10:
+    resolution:
+      {
+        integrity: sha512-6NCPkv1ClwH+/BGE9QeoTIl09nuiAt0gS28nn1PvYXsGKRwM2TCbFA2QiilmehPDTXIe684k4rZI1yl3A1PCUw==
+      }
+    engines: { node: '>=18.12.0' }
+
+  update-browserslist-db@1.1.3:
+    resolution:
+      {
+        integrity: sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==
+      }
+    hasBin: true
+    peerDependencies:
+      browserslist: '>= 4.21.0'
+
+  uri-js@4.4.1:
+    resolution:
+      {
+        integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==
+      }
+
+  util-deprecate@1.0.2:
+    resolution:
+      {
+        integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==
+      }
+
+  vite-hot-client@2.1.0:
+    resolution:
+      {
+        integrity: sha512-7SpgZmU7R+dDnSmvXE1mfDtnHLHQSisdySVR7lO8ceAXvM0otZeuQQ6C8LrS5d/aYyP/QZ0hI0L+dIPrm4YlFQ==
+      }
+    peerDependencies:
+      vite: ^2.6.0 || ^3.0.0 || ^4.0.0 || ^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0
+
+  vite-plugin-compression@0.5.1:
+    resolution:
+      {
+        integrity: sha512-5QJKBDc+gNYVqL/skgFAP81Yuzo9R+EAf19d+EtsMF/i8kFUpNi3J/H01QD3Oo8zBQn+NzoCIFkpPLynoOzaJg==
+      }
+    peerDependencies:
+      vite: '>=2.0.0'
+
+  vite-plugin-inspect@0.8.9:
+    resolution:
+      {
+        integrity: sha512-22/8qn+LYonzibb1VeFZmISdVao5kC22jmEKm24vfFE8siEn47EpVcCLYMv6iKOYMJfjSvSJfueOwcFCkUnV3A==
+      }
+    engines: { node: '>=14' }
+    peerDependencies:
+      '@nuxt/kit': '*'
+      vite: ^3.1.0 || ^4.0.0 || ^5.0.0-0 || ^6.0.1
+    peerDependenciesMeta:
+      '@nuxt/kit':
+        optional: true
+
+  vite-plugin-vue-devtools@7.7.7:
+    resolution:
+      {
+        integrity: sha512-d0fIh3wRcgSlr4Vz7bAk4va1MkdqhQgj9ANE/rBhsAjOnRfTLs2ocjFMvSUOsv6SRRXU9G+VM7yMgqDb6yI4iQ==
+      }
+    engines: { node: '>=v14.21.3' }
+    peerDependencies:
+      vite: ^3.1.0 || ^4.0.0-0 || ^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0
+
+  vite-plugin-vue-inspector@5.3.2:
+    resolution:
+      {
+        integrity: sha512-YvEKooQcSiBTAs0DoYLfefNja9bLgkFM7NI2b07bE2SruuvX0MEa9cMaxjKVMkeCp5Nz9FRIdcN1rOdFVBeL6Q==
+      }
+    peerDependencies:
+      vite: ^3.0.0-0 || ^4.0.0-0 || ^5.0.0-0 || ^6.0.0-0 || ^7.0.0-0
+
+  vite@7.1.7:
+    resolution:
+      {
+        integrity: sha512-VbA8ScMvAISJNJVbRDTJdCwqQoAareR/wutevKanhR2/1EkoXVZVkkORaYm/tNVCjP/UDTKtcw3bAkwOUdedmA==
+      }
+    engines: { node: ^20.19.0 || >=22.12.0 }
+    hasBin: true
+    peerDependencies:
+      '@types/node': ^20.19.0 || >=22.12.0
+      jiti: '>=1.21.0'
+      less: ^4.0.0
+      lightningcss: ^1.21.0
+      sass: ^1.70.0
+      sass-embedded: ^1.70.0
+      stylus: '>=0.54.8'
+      sugarss: ^5.0.0
+      terser: ^5.16.0
+      tsx: ^4.8.1
+      yaml: ^2.4.2
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+      jiti:
+        optional: true
+      less:
+        optional: true
+      lightningcss:
+        optional: true
+      sass:
+        optional: true
+      sass-embedded:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+      tsx:
+        optional: true
+      yaml:
+        optional: true
+
+  vscode-uri@3.1.0:
+    resolution:
+      {
+        integrity: sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==
+      }
+
+  vue-demi@0.14.10:
+    resolution:
+      {
+        integrity: sha512-nMZBOwuzabUO0nLgIcc6rycZEebF6eeUfaiQx9+WSk8e29IbLvPU9feI6tqW4kTo3hvoYAJkMh8n8D0fuISphg==
+      }
+    engines: { node: '>=12' }
+    hasBin: true
+    peerDependencies:
+      '@vue/composition-api': ^1.0.0-rc.1
+      vue: ^3.0.0-0 || ^2.6.0
+    peerDependenciesMeta:
+      '@vue/composition-api':
+        optional: true
+
+  vue-draggable-plus@0.6.0:
+    resolution:
+      {
+        integrity: sha512-G5TSfHrt9tX9EjdG49InoFJbt2NYk0h3kgjgKxkFWr3ulIUays0oFObr5KZ8qzD4+QnhtALiRwIqY6qul4egqw==
+      }
+    peerDependencies:
+      '@types/sortablejs': ^1.15.0
+      '@vue/composition-api': '*'
+    peerDependenciesMeta:
+      '@vue/composition-api':
+        optional: true
+
+  vue-eslint-parser@9.4.3:
+    resolution:
+      {
+        integrity: sha512-2rYRLWlIpaiN8xbPiDyXZXRgLGOtWxERV7ND5fFAv5qo1D2N9Fu9MNajBNc6o13lZ+24DAWCkQCvj4klgmcITg==
+      }
+    engines: { node: ^14.17.0 || >=16.0.0 }
+    peerDependencies:
+      eslint: '>=6.0.0'
+
+  vue-i18n@9.14.5:
+    resolution:
+      {
+        integrity: sha512-0jQ9Em3ymWngyiIkj0+c/k7WgaPO+TNzjKSNq9BvBQaKJECqn9cd9fL4tkDhB5G1QBskGl9YxxbDAhgbFtpe2g==
+      }
+    engines: { node: '>= 16' }
+    peerDependencies:
+      vue: ^3.0.0
+
+  vue-img-cutter@3.0.7:
+    resolution:
+      {
+        integrity: sha512-fNw3kimawg9XVXDZCw2bI74NI+Jq+H42wjymatZVVSY46wuBty6LbQsu4GeVfo/yzpS9AHY0tzckpYzX3D2fmA==
+      }
+
+  vue-router@4.5.1:
+    resolution:
+      {
+        integrity: sha512-ogAF3P97NPm8fJsE4by9dwSYtDwXIY1nFY9T6DyQnGHd1E2Da94w9JIolpe42LJGIl0DwOHBi8TcRPlPGwbTtw==
+      }
+    peerDependencies:
+      vue: ^3.2.0
+
+  vue-tsc@2.1.10:
+    resolution:
+      {
+        integrity: sha512-RBNSfaaRHcN5uqVqJSZh++Gy/YUzryuv9u1aFWhsammDJXNtUiJMNoJ747lZcQ68wUQFx6E73y4FY3D8E7FGMA==
+      }
+    hasBin: true
+    peerDependencies:
+      typescript: '>=5.0.0'
+
+  vue@3.5.22:
+    resolution:
+      {
+        integrity: sha512-toaZjQ3a/G/mYaLSbV+QsQhIdMo9x5rrqIpYRObsJ6T/J+RyCSFwN2LHNVH9v8uIcljDNa3QzPVdv3Y6b9hAJQ==
+      }
+    peerDependencies:
+      typescript: '*'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
+  wcwidth@1.0.1:
+    resolution:
+      {
+        integrity: sha512-XHPEwS0q6TaxcvG85+8EYkbiCux2XtWG2mkc47Ng2A77BQu9+DqIOJldST4HgPkuea7dvKSj5VgX3P1d4rW8Tg==
+      }
+
+  webpack-virtual-modules@0.6.2:
+    resolution:
+      {
+        integrity: sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==
+      }
+
+  which@1.3.1:
+    resolution:
+      {
+        integrity: sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==
+      }
+    hasBin: true
+
+  which@2.0.2:
+    resolution:
+      {
+        integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==
+      }
+    engines: { node: '>= 8' }
+    hasBin: true
+
+  wildcard@1.1.2:
+    resolution:
+      {
+        integrity: sha512-DXukZJxpHA8LuotRwL0pP1+rS6CS7FF2qStDDE1C7DDg2rLud2PXRMuEDYIPhgEezwnlHNL4c+N6MfMTjCGTng==
+      }
+
+  wmf@1.0.2:
+    resolution:
+      {
+        integrity: sha512-/p9K7bEh0Dj6WbXg4JG0xvLQmIadrner1bi45VMJTfnbVHsc7yIajZyoSoK60/dtVBs12Fm6WkUI5/3WAVsNMw==
+      }
+    engines: { node: '>=0.8' }
+
+  word-wrap@1.2.5:
+    resolution:
+      {
+        integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==
+      }
+    engines: { node: '>=0.10.0' }
+
+  word@0.3.0:
+    resolution:
+      {
+        integrity: sha512-OELeY0Q61OXpdUfTp+oweA/vtLVg5VDOXh+3he3PNzLGG/y0oylSOC1xRVj0+l4vQ3tj/bB1HVHv1ocXkQceFA==
+      }
+    engines: { node: '>=0.8' }
+
+  wrap-ansi@7.0.0:
+    resolution:
+      {
+        integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
+      }
+    engines: { node: '>=10' }
+
+  wrap-ansi@9.0.2:
+    resolution:
+      {
+        integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==
+      }
+    engines: { node: '>=18' }
+
+  wrappy@1.0.2:
+    resolution:
+      {
+        integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==
+      }
+
+  write-file-atomic@5.0.1:
+    resolution:
+      {
+        integrity: sha512-+QU2zd6OTD8XWIJCbffaiQeH9U73qIqafo1x6V1snCWYGJf6cVE0cDR4D8xRzcEnfI21IFrUPzPGtcPf8AC+Rw==
+      }
+    engines: { node: ^14.17.0 || ^16.13.0 || >=18.0.0 }
+
+  wsl-utils@0.1.0:
+    resolution:
+      {
+        integrity: sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==
+      }
+    engines: { node: '>=18' }
+
+  xgplayer-subtitles@3.0.23:
+    resolution:
+      {
+        integrity: sha512-deGdV75giVzfTTdG9XATmji39NHwKTpEelWt2rRx/RyXGgU2bQFp0Ft7yWaK2Uu8A/WVrP5fpxEAj4MstREMkQ==
+      }
+    peerDependencies:
+      core-js: '>=3.12.1'
+
+  xgplayer@3.0.23:
+    resolution:
+      {
+        integrity: sha512-Bn3zQfMMAZimlVG9EeIDybMcklc+6FH8Sv47KpTq4K6ofCzyhPG/KenxailDedlHmxjb5B2o+240TpJtMQ3oJA==
+      }
+    peerDependencies:
+      core-js: '>=3.12.1'
+
+  xlsx@0.18.5:
+    resolution:
+      {
+        integrity: sha512-dmg3LCjBPHZnQp5/F/+nnTa+miPJxUXB6vtk42YjBBKayDNagxGEeIdWApkYPOf3Z3pm3k62Knjzp7lMeTEtFQ==
+      }
+    engines: { node: '>=0.8' }
+    hasBin: true
+
+  xml-name-validator@4.0.0:
+    resolution:
+      {
+        integrity: sha512-ICP2e+jsHvAj2E2lIHxa5tjXRlKDJo4IdvPvCXbXQGdzSfmSpNVyIKMvoZHjDY9DP0zV17iI85o90vRFXNccRw==
+      }
+    engines: { node: '>=12' }
+
+  y18n@5.0.8:
+    resolution:
+      {
+        integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==
+      }
+    engines: { node: '>=10' }
+
+  yallist@3.1.1:
+    resolution:
+      {
+        integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==
+      }
+
+  yallist@5.0.0:
+    resolution:
+      {
+        integrity: sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==
+      }
+    engines: { node: '>=18' }
+
+  yaml@2.8.1:
+    resolution:
+      {
+        integrity: sha512-lcYcMxX2PO9XMGvAJkJ3OsNMw+/7FKes7/hgerGUYWIoWu5j/+YQqcZr5JnPZWzOsEBgMbSbiSTn/dv/69Mkpw==
+      }
+    engines: { node: '>= 14.6' }
+    hasBin: true
+
+  yargs-parser@21.1.1:
+    resolution:
+      {
+        integrity: sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==
+      }
+    engines: { node: '>=12' }
+
+  yargs@17.7.2:
+    resolution:
+      {
+        integrity: sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==
+      }
+    engines: { node: '>=12' }
+
+  yocto-queue@0.1.0:
+    resolution:
+      {
+        integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==
+      }
+    engines: { node: '>=10' }
+
+  yocto-queue@1.2.1:
+    resolution:
+      {
+        integrity: sha512-AyeEbWOu/TAXdxlV9wmGcR0+yh2j3vYPGOECcIj2S7MkrLyC7ne+oye2BKTItt0ii2PHk4cDy+95+LshzbXnGg==
+      }
+    engines: { node: '>=12.20' }
+
+  yoctocolors@2.1.2:
+    resolution:
+      {
+        integrity: sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug==
+      }
+    engines: { node: '>=18' }
+
+  zrender@6.0.0:
+    resolution:
+      {
+        integrity: sha512-41dFXEEXuJpNecuUQq6JlbybmnHaqqpGlbH1yxnA5V9MMP4SbohSVZsJIwz+zdjQXSSlR1Vc34EgH1zxyTDvhg==
+      }
+
+snapshots:
+  '@antfu/utils@0.7.10': {}
+
+  '@babel/code-frame@7.27.1':
+    dependencies:
+      '@babel/helper-validator-identifier': 7.27.1
+      js-tokens: 4.0.0
+      picocolors: 1.1.1
+
+  '@babel/compat-data@7.28.4': {}
+
+  '@babel/core@7.28.4':
+    dependencies:
+      '@babel/code-frame': 7.27.1
+      '@babel/generator': 7.28.3
+      '@babel/helper-compilation-targets': 7.27.2
+      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.4)
+      '@babel/helpers': 7.28.4
+      '@babel/parser': 7.28.4
+      '@babel/template': 7.27.2
+      '@babel/traverse': 7.28.4
+      '@babel/types': 7.28.4
+      '@jridgewell/remapping': 2.3.5
+      convert-source-map: 2.0.0
+      debug: 4.4.3
+      gensync: 1.0.0-beta.2
+      json5: 2.2.3
+      semver: 6.3.1
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/generator@7.28.3':
+    dependencies:
+      '@babel/parser': 7.28.4
+      '@babel/types': 7.28.4
+      '@jridgewell/gen-mapping': 0.3.13
+      '@jridgewell/trace-mapping': 0.3.31
+      jsesc: 3.1.0
+
+  '@babel/helper-annotate-as-pure@7.27.3':
+    dependencies:
+      '@babel/types': 7.28.4
+
+  '@babel/helper-compilation-targets@7.27.2':
+    dependencies:
+      '@babel/compat-data': 7.28.4
+      '@babel/helper-validator-option': 7.27.1
+      browserslist: 4.26.2
+      lru-cache: 5.1.1
+      semver: 6.3.1
+
+  '@babel/helper-create-class-features-plugin@7.28.3(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-annotate-as-pure': 7.27.3
+      '@babel/helper-member-expression-to-functions': 7.27.1
+      '@babel/helper-optimise-call-expression': 7.27.1
+      '@babel/helper-replace-supers': 7.27.1(@babel/core@7.28.4)
+      '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
+      '@babel/traverse': 7.28.4
+      semver: 6.3.1
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-globals@7.28.0': {}
+
+  '@babel/helper-member-expression-to-functions@7.27.1':
+    dependencies:
+      '@babel/traverse': 7.28.4
+      '@babel/types': 7.28.4
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-module-imports@7.27.1':
+    dependencies:
+      '@babel/traverse': 7.28.4
+      '@babel/types': 7.28.4
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-module-transforms@7.28.3(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-module-imports': 7.27.1
+      '@babel/helper-validator-identifier': 7.27.1
+      '@babel/traverse': 7.28.4
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-optimise-call-expression@7.27.1':
+    dependencies:
+      '@babel/types': 7.28.4
+
+  '@babel/helper-plugin-utils@7.27.1': {}
+
+  '@babel/helper-replace-supers@7.27.1(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-member-expression-to-functions': 7.27.1
+      '@babel/helper-optimise-call-expression': 7.27.1
+      '@babel/traverse': 7.28.4
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-skip-transparent-expression-wrappers@7.27.1':
+    dependencies:
+      '@babel/traverse': 7.28.4
+      '@babel/types': 7.28.4
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/helper-string-parser@7.27.1': {}
+
+  '@babel/helper-validator-identifier@7.27.1': {}
+
+  '@babel/helper-validator-option@7.27.1': {}
+
+  '@babel/helpers@7.28.4':
+    dependencies:
+      '@babel/template': 7.27.2
+      '@babel/types': 7.28.4
+
+  '@babel/parser@7.28.4':
+    dependencies:
+      '@babel/types': 7.28.4
+
+  '@babel/plugin-proposal-decorators@7.28.0(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-create-class-features-plugin': 7.28.3(@babel/core@7.28.4)
+      '@babel/helper-plugin-utils': 7.27.1
+      '@babel/plugin-syntax-decorators': 7.27.1(@babel/core@7.28.4)
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/plugin-syntax-decorators@7.27.1(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-plugin-utils': 7.27.1
+
+  '@babel/plugin-syntax-import-attributes@7.27.1(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-plugin-utils': 7.27.1
+
+  '@babel/plugin-syntax-import-meta@7.10.4(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-plugin-utils': 7.27.1
+
+  '@babel/plugin-syntax-jsx@7.27.1(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-plugin-utils': 7.27.1
+
+  '@babel/plugin-syntax-typescript@7.27.1(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-plugin-utils': 7.27.1
+
+  '@babel/plugin-transform-typescript@7.28.0(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/helper-annotate-as-pure': 7.27.3
+      '@babel/helper-create-class-features-plugin': 7.28.3(@babel/core@7.28.4)
+      '@babel/helper-plugin-utils': 7.27.1
+      '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
+      '@babel/plugin-syntax-typescript': 7.27.1(@babel/core@7.28.4)
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/runtime@7.28.4': {}
+
+  '@babel/template@7.27.2':
+    dependencies:
+      '@babel/code-frame': 7.27.1
+      '@babel/parser': 7.28.4
+      '@babel/types': 7.28.4
+
+  '@babel/traverse@7.28.4':
+    dependencies:
+      '@babel/code-frame': 7.27.1
+      '@babel/generator': 7.28.3
+      '@babel/helper-globals': 7.28.0
+      '@babel/parser': 7.28.4
+      '@babel/template': 7.27.2
+      '@babel/types': 7.28.4
+      debug: 4.4.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@babel/types@7.28.4':
+    dependencies:
+      '@babel/helper-string-parser': 7.27.1
+      '@babel/helper-validator-identifier': 7.27.1
+
+  '@cacheable/memoize@2.0.2':
+    dependencies:
+      '@cacheable/utils': 2.0.2
+
+  '@cacheable/memory@2.0.2':
+    dependencies:
+      '@cacheable/memoize': 2.0.2
+      '@cacheable/utils': 2.0.2
+      '@keyv/bigmap': 1.0.2
+      hookified: 1.12.1
+      keyv: 5.5.3
+
+  '@cacheable/utils@2.0.2': {}
+
+  '@commitlint/cli@19.8.1(@types/node@24.8.1)(typescript@5.6.3)':
+    dependencies:
+      '@commitlint/format': 19.8.1
+      '@commitlint/lint': 19.8.1
+      '@commitlint/load': 19.8.1(@types/node@24.8.1)(typescript@5.6.3)
+      '@commitlint/read': 19.8.1
+      '@commitlint/types': 19.8.1
+      tinyexec: 1.0.1
+      yargs: 17.7.2
+    transitivePeerDependencies:
+      - '@types/node'
+      - typescript
+
+  '@commitlint/config-conventional@19.8.1':
+    dependencies:
+      '@commitlint/types': 19.8.1
+      conventional-changelog-conventionalcommits: 7.0.2
+
+  '@commitlint/config-validator@19.8.1':
+    dependencies:
+      '@commitlint/types': 19.8.1
+      ajv: 8.17.1
+
+  '@commitlint/config-validator@20.0.0':
+    dependencies:
+      '@commitlint/types': 20.0.0
+      ajv: 8.17.1
+    optional: true
+
+  '@commitlint/ensure@19.8.1':
+    dependencies:
+      '@commitlint/types': 19.8.1
+      lodash.camelcase: 4.3.0
+      lodash.kebabcase: 4.1.1
+      lodash.snakecase: 4.1.1
+      lodash.startcase: 4.4.0
+      lodash.upperfirst: 4.3.1
+
+  '@commitlint/execute-rule@19.8.1': {}
+
+  '@commitlint/execute-rule@20.0.0':
+    optional: true
+
+  '@commitlint/format@19.8.1':
+    dependencies:
+      '@commitlint/types': 19.8.1
+      chalk: 5.6.2
+
+  '@commitlint/is-ignored@19.8.1':
+    dependencies:
+      '@commitlint/types': 19.8.1
+      semver: 7.7.2
+
+  '@commitlint/lint@19.8.1':
+    dependencies:
+      '@commitlint/is-ignored': 19.8.1
+      '@commitlint/parse': 19.8.1
+      '@commitlint/rules': 19.8.1
+      '@commitlint/types': 19.8.1
+
+  '@commitlint/load@19.8.1(@types/node@24.8.1)(typescript@5.6.3)':
+    dependencies:
+      '@commitlint/config-validator': 19.8.1
+      '@commitlint/execute-rule': 19.8.1
+      '@commitlint/resolve-extends': 19.8.1
+      '@commitlint/types': 19.8.1
+      chalk: 5.6.2
+      cosmiconfig: 9.0.0(typescript@5.6.3)
+      cosmiconfig-typescript-loader: 6.1.0(@types/node@24.8.1)(cosmiconfig@9.0.0(typescript@5.6.3))(typescript@5.6.3)
+      lodash.isplainobject: 4.0.6
+      lodash.merge: 4.6.2
+      lodash.uniq: 4.5.0
+    transitivePeerDependencies:
+      - '@types/node'
+      - typescript
+
+  '@commitlint/load@20.0.0(@types/node@24.8.1)(typescript@5.6.3)':
+    dependencies:
+      '@commitlint/config-validator': 20.0.0
+      '@commitlint/execute-rule': 20.0.0
+      '@commitlint/resolve-extends': 20.0.0
+      '@commitlint/types': 20.0.0
+      chalk: 5.6.2
+      cosmiconfig: 9.0.0(typescript@5.6.3)
+      cosmiconfig-typescript-loader: 6.1.0(@types/node@24.8.1)(cosmiconfig@9.0.0(typescript@5.6.3))(typescript@5.6.3)
+      lodash.isplainobject: 4.0.6
+      lodash.merge: 4.6.2
+      lodash.uniq: 4.5.0
+    transitivePeerDependencies:
+      - '@types/node'
+      - typescript
+    optional: true
+
+  '@commitlint/message@19.8.1': {}
+
+  '@commitlint/parse@19.8.1':
+    dependencies:
+      '@commitlint/types': 19.8.1
+      conventional-changelog-angular: 7.0.0
+      conventional-commits-parser: 5.0.0
+
+  '@commitlint/read@19.8.1':
+    dependencies:
+      '@commitlint/top-level': 19.8.1
+      '@commitlint/types': 19.8.1
+      git-raw-commits: 4.0.0
+      minimist: 1.2.8
+      tinyexec: 1.0.1
+
+  '@commitlint/resolve-extends@19.8.1':
+    dependencies:
+      '@commitlint/config-validator': 19.8.1
+      '@commitlint/types': 19.8.1
+      global-directory: 4.0.1
+      import-meta-resolve: 4.2.0
+      lodash.mergewith: 4.6.2
+      resolve-from: 5.0.0
+
+  '@commitlint/resolve-extends@20.0.0':
+    dependencies:
+      '@commitlint/config-validator': 20.0.0
+      '@commitlint/types': 20.0.0
+      global-directory: 4.0.1
+      import-meta-resolve: 4.2.0
+      lodash.mergewith: 4.6.2
+      resolve-from: 5.0.0
+    optional: true
+
+  '@commitlint/rules@19.8.1':
+    dependencies:
+      '@commitlint/ensure': 19.8.1
+      '@commitlint/message': 19.8.1
+      '@commitlint/to-lines': 19.8.1
+      '@commitlint/types': 19.8.1
+
+  '@commitlint/to-lines@19.8.1': {}
+
+  '@commitlint/top-level@19.8.1':
+    dependencies:
+      find-up: 7.0.0
+
+  '@commitlint/types@19.8.1':
+    dependencies:
+      '@types/conventional-commits-parser': 5.0.1
+      chalk: 5.6.2
+
+  '@commitlint/types@20.0.0':
+    dependencies:
+      '@types/conventional-commits-parser': 5.0.1
+      chalk: 5.6.2
+    optional: true
+
+  '@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4)':
+    dependencies:
+      '@csstools/css-tokenizer': 3.0.4
+
+  '@csstools/css-tokenizer@3.0.4': {}
+
+  '@csstools/media-query-list-parser@4.0.3(@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4))(@csstools/css-tokenizer@3.0.4)':
+    dependencies:
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-tokenizer': 3.0.4
+
+  '@csstools/selector-specificity@5.0.0(postcss-selector-parser@7.1.0)':
+    dependencies:
+      postcss-selector-parser: 7.1.0
+
+  '@ctrl/tinycolor@3.6.1': {}
+
+  '@dual-bundle/import-meta-resolve@4.2.1': {}
+
+  '@element-plus/icons-vue@2.3.2(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      vue: 3.5.22(typescript@5.6.3)
+
+  '@esbuild/aix-ppc64@0.25.10':
+    optional: true
+
+  '@esbuild/android-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/android-arm@0.25.10':
+    optional: true
+
+  '@esbuild/android-x64@0.25.10':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/darwin-x64@0.25.10':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.25.10':
+    optional: true
+
+  '@esbuild/linux-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/linux-arm@0.25.10':
+    optional: true
+
+  '@esbuild/linux-ia32@0.25.10':
+    optional: true
+
+  '@esbuild/linux-loong64@0.25.10':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.25.10':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.25.10':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.25.10':
+    optional: true
+
+  '@esbuild/linux-s390x@0.25.10':
+    optional: true
+
+  '@esbuild/linux-x64@0.25.10':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.25.10':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.25.10':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/sunos-x64@0.25.10':
+    optional: true
+
+  '@esbuild/win32-arm64@0.25.10':
+    optional: true
+
+  '@esbuild/win32-ia32@0.25.10':
+    optional: true
+
+  '@esbuild/win32-x64@0.25.10':
+    optional: true
+
+  '@eslint-community/eslint-utils@4.9.0(eslint@9.36.0(jiti@2.6.0))':
+    dependencies:
+      eslint: 9.36.0(jiti@2.6.0)
+      eslint-visitor-keys: 3.4.3
+
+  '@eslint-community/regexpp@4.12.1': {}
+
+  '@eslint/config-array@0.21.0':
+    dependencies:
+      '@eslint/object-schema': 2.1.6
+      debug: 4.4.3
+      minimatch: 3.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  '@eslint/config-helpers@0.3.1': {}
+
+  '@eslint/core@0.15.2':
+    dependencies:
+      '@types/json-schema': 7.0.15
+
+  '@eslint/eslintrc@3.3.1':
+    dependencies:
+      ajv: 6.12.6
+      debug: 4.4.3
+      espree: 10.4.0
+      globals: 14.0.0
+      ignore: 5.3.2
+      import-fresh: 3.3.1
+      js-yaml: 4.1.0
+      minimatch: 3.1.2
+      strip-json-comments: 3.1.1
+    transitivePeerDependencies:
+      - supports-color
+
+  '@eslint/js@9.36.0': {}
+
+  '@eslint/object-schema@2.1.6': {}
+
+  '@eslint/plugin-kit@0.3.5':
+    dependencies:
+      '@eslint/core': 0.15.2
+      levn: 0.4.1
+
+  '@floating-ui/core@1.7.3':
+    dependencies:
+      '@floating-ui/utils': 0.2.10
+
+  '@floating-ui/dom@1.7.4':
+    dependencies:
+      '@floating-ui/core': 1.7.3
+      '@floating-ui/utils': 0.2.10
+
+  '@floating-ui/utils@0.2.10': {}
+
+  '@humanfs/core@0.19.1': {}
+
+  '@humanfs/node@0.16.7':
+    dependencies:
+      '@humanfs/core': 0.19.1
+      '@humanwhocodes/retry': 0.4.3
+
+  '@humanwhocodes/module-importer@1.0.1': {}
+
+  '@humanwhocodes/retry@0.4.3': {}
+
+  '@iconify/types@2.0.0': {}
+
+  '@iconify/vue@5.0.0(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      '@iconify/types': 2.0.0
+      vue: 3.5.22(typescript@5.6.3)
+
+  '@intlify/core-base@9.14.5':
+    dependencies:
+      '@intlify/message-compiler': 9.14.5
+      '@intlify/shared': 9.14.5
+
+  '@intlify/message-compiler@9.14.5':
+    dependencies:
+      '@intlify/shared': 9.14.5
+      source-map-js: 1.2.1
+
+  '@intlify/shared@9.14.5': {}
+
+  '@isaacs/fs-minipass@4.0.1':
+    dependencies:
+      minipass: 7.1.2
+
+  '@jridgewell/gen-mapping@0.3.13':
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.5.5
+      '@jridgewell/trace-mapping': 0.3.31
+
+  '@jridgewell/remapping@2.3.5':
+    dependencies:
+      '@jridgewell/gen-mapping': 0.3.13
+      '@jridgewell/trace-mapping': 0.3.31
+
+  '@jridgewell/resolve-uri@3.1.2': {}
+
+  '@jridgewell/source-map@0.3.11':
+    dependencies:
+      '@jridgewell/gen-mapping': 0.3.13
+      '@jridgewell/trace-mapping': 0.3.31
+
+  '@jridgewell/sourcemap-codec@1.5.5': {}
+
+  '@jridgewell/trace-mapping@0.3.31':
+    dependencies:
+      '@jridgewell/resolve-uri': 3.1.2
+      '@jridgewell/sourcemap-codec': 1.5.5
+
+  '@keyv/bigmap@1.0.2':
+    dependencies:
+      hookified: 1.12.1
+
+  '@keyv/serialize@1.1.1': {}
+
+  '@nodelib/fs.scandir@2.1.5':
+    dependencies:
+      '@nodelib/fs.stat': 2.0.5
+      run-parallel: 1.2.0
+
+  '@nodelib/fs.stat@2.0.5': {}
+
+  '@nodelib/fs.walk@1.2.8':
+    dependencies:
+      '@nodelib/fs.scandir': 2.1.5
+      fastq: 1.19.1
+
+  '@parcel/watcher-android-arm64@2.5.1':
+    optional: true
+
+  '@parcel/watcher-darwin-arm64@2.5.1':
+    optional: true
+
+  '@parcel/watcher-darwin-x64@2.5.1':
+    optional: true
+
+  '@parcel/watcher-freebsd-x64@2.5.1':
+    optional: true
+
+  '@parcel/watcher-linux-arm-glibc@2.5.1':
+    optional: true
+
+  '@parcel/watcher-linux-arm-musl@2.5.1':
+    optional: true
+
+  '@parcel/watcher-linux-arm64-glibc@2.5.1':
+    optional: true
+
+  '@parcel/watcher-linux-arm64-musl@2.5.1':
+    optional: true
+
+  '@parcel/watcher-linux-x64-glibc@2.5.1':
+    optional: true
+
+  '@parcel/watcher-linux-x64-musl@2.5.1':
+    optional: true
+
+  '@parcel/watcher-win32-arm64@2.5.1':
+    optional: true
+
+  '@parcel/watcher-win32-ia32@2.5.1':
+    optional: true
+
+  '@parcel/watcher-win32-x64@2.5.1':
+    optional: true
+
+  '@parcel/watcher@2.5.1':
+    dependencies:
+      detect-libc: 1.0.3
+      is-glob: 4.0.3
+      micromatch: 4.0.8
+      node-addon-api: 7.1.1
+    optionalDependencies:
+      '@parcel/watcher-android-arm64': 2.5.1
+      '@parcel/watcher-darwin-arm64': 2.5.1
+      '@parcel/watcher-darwin-x64': 2.5.1
+      '@parcel/watcher-freebsd-x64': 2.5.1
+      '@parcel/watcher-linux-arm-glibc': 2.5.1
+      '@parcel/watcher-linux-arm-musl': 2.5.1
+      '@parcel/watcher-linux-arm64-glibc': 2.5.1
+      '@parcel/watcher-linux-arm64-musl': 2.5.1
+      '@parcel/watcher-linux-x64-glibc': 2.5.1
+      '@parcel/watcher-linux-x64-musl': 2.5.1
+      '@parcel/watcher-win32-arm64': 2.5.1
+      '@parcel/watcher-win32-ia32': 2.5.1
+      '@parcel/watcher-win32-x64': 2.5.1
+    optional: true
+
+  '@pkgr/core@0.2.9': {}
+
+  '@polka/url@1.0.0-next.29': {}
+
+  '@rolldown/pluginutils@1.0.0-beta.29': {}
+
+  '@rollup/pluginutils@5.3.0(rollup@4.52.3)':
+    dependencies:
+      '@types/estree': 1.0.8
+      estree-walker: 2.0.2
+      picomatch: 4.0.3
+    optionalDependencies:
+      rollup: 4.52.3
+
+  '@rollup/rollup-android-arm-eabi@4.52.3':
+    optional: true
+
+  '@rollup/rollup-android-arm64@4.52.3':
+    optional: true
+
+  '@rollup/rollup-darwin-arm64@4.52.3':
+    optional: true
+
+  '@rollup/rollup-darwin-x64@4.52.3':
+    optional: true
+
+  '@rollup/rollup-freebsd-arm64@4.52.3':
+    optional: true
+
+  '@rollup/rollup-freebsd-x64@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-arm-gnueabihf@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-arm-musleabihf@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-arm64-gnu@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-arm64-musl@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-loong64-gnu@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-ppc64-gnu@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-riscv64-gnu@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-riscv64-musl@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-s390x-gnu@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-x64-gnu@4.52.3':
+    optional: true
+
+  '@rollup/rollup-linux-x64-musl@4.52.3':
+    optional: true
+
+  '@rollup/rollup-openharmony-arm64@4.52.3':
+    optional: true
+
+  '@rollup/rollup-win32-arm64-msvc@4.52.3':
+    optional: true
+
+  '@rollup/rollup-win32-ia32-msvc@4.52.3':
+    optional: true
+
+  '@rollup/rollup-win32-x64-gnu@4.52.3':
+    optional: true
+
+  '@rollup/rollup-win32-x64-msvc@4.52.3':
+    optional: true
+
+  '@sec-ant/readable-stream@0.4.1': {}
+
+  '@sindresorhus/merge-streams@4.0.0': {}
+
+  '@sxzz/popperjs-es@2.11.7': {}
+
+  '@tailwindcss/node@4.1.14':
+    dependencies:
+      '@jridgewell/remapping': 2.3.5
+      enhanced-resolve: 5.18.3
+      jiti: 2.6.0
+      lightningcss: 1.30.1
+      magic-string: 0.30.19
+      source-map-js: 1.2.1
+      tailwindcss: 4.1.14
+
+  '@tailwindcss/oxide-android-arm64@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-darwin-arm64@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-darwin-x64@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-freebsd-x64@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-linux-arm-gnueabihf@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-linux-arm64-gnu@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-linux-arm64-musl@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-linux-x64-gnu@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-linux-x64-musl@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-wasm32-wasi@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-win32-arm64-msvc@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide-win32-x64-msvc@4.1.14':
+    optional: true
+
+  '@tailwindcss/oxide@4.1.14':
+    dependencies:
+      detect-libc: 2.1.2
+      tar: 7.5.1
+    optionalDependencies:
+      '@tailwindcss/oxide-android-arm64': 4.1.14
+      '@tailwindcss/oxide-darwin-arm64': 4.1.14
+      '@tailwindcss/oxide-darwin-x64': 4.1.14
+      '@tailwindcss/oxide-freebsd-x64': 4.1.14
+      '@tailwindcss/oxide-linux-arm-gnueabihf': 4.1.14
+      '@tailwindcss/oxide-linux-arm64-gnu': 4.1.14
+      '@tailwindcss/oxide-linux-arm64-musl': 4.1.14
+      '@tailwindcss/oxide-linux-x64-gnu': 4.1.14
+      '@tailwindcss/oxide-linux-x64-musl': 4.1.14
+      '@tailwindcss/oxide-wasm32-wasi': 4.1.14
+      '@tailwindcss/oxide-win32-arm64-msvc': 4.1.14
+      '@tailwindcss/oxide-win32-x64-msvc': 4.1.14
+
+  '@tailwindcss/vite@4.1.14(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))':
+    dependencies:
+      '@tailwindcss/node': 4.1.14
+      '@tailwindcss/oxide': 4.1.14
+      tailwindcss: 4.1.14
+      vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+
+  '@transloadit/prettier-bytes@0.0.7': {}
+
+  '@types/conventional-commits-parser@5.0.1':
+    dependencies:
+      '@types/node': 24.8.1
+
+  '@types/estree@1.0.8': {}
+
+  '@types/event-emitter@0.3.5': {}
+
+  '@types/json-schema@7.0.15': {}
+
+  '@types/lodash-es@4.17.12':
+    dependencies:
+      '@types/lodash': 4.17.20
+
+  '@types/lodash@4.17.20': {}
+
+  '@types/node@24.8.1':
+    dependencies:
+      undici-types: 7.14.0
+
+  '@types/sortablejs@1.15.8': {}
+
+  '@types/web-bluetooth@0.0.16': {}
+
+  '@types/web-bluetooth@0.0.21': {}
+
+  '@typescript-eslint/eslint-plugin@8.44.1(@typescript-eslint/parser@8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3))(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)':
+    dependencies:
+      '@eslint-community/regexpp': 4.12.1
+      '@typescript-eslint/parser': 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      '@typescript-eslint/scope-manager': 8.44.1
+      '@typescript-eslint/type-utils': 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      '@typescript-eslint/utils': 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      '@typescript-eslint/visitor-keys': 8.44.1
+      eslint: 9.36.0(jiti@2.6.0)
+      graphemer: 1.4.0
+      ignore: 7.0.5
+      natural-compare: 1.4.0
+      ts-api-utils: 2.1.0(typescript@5.6.3)
+      typescript: 5.6.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@typescript-eslint/parser@8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)':
+    dependencies:
+      '@typescript-eslint/scope-manager': 8.44.1
+      '@typescript-eslint/types': 8.44.1
+      '@typescript-eslint/typescript-estree': 8.44.1(typescript@5.6.3)
+      '@typescript-eslint/visitor-keys': 8.44.1
+      debug: 4.4.3
+      eslint: 9.36.0(jiti@2.6.0)
+      typescript: 5.6.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@typescript-eslint/project-service@8.44.1(typescript@5.6.3)':
+    dependencies:
+      '@typescript-eslint/tsconfig-utils': 8.44.1(typescript@5.6.3)
+      '@typescript-eslint/types': 8.44.1
+      debug: 4.4.3
+      typescript: 5.6.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@typescript-eslint/scope-manager@8.44.1':
+    dependencies:
+      '@typescript-eslint/types': 8.44.1
+      '@typescript-eslint/visitor-keys': 8.44.1
+
+  '@typescript-eslint/tsconfig-utils@8.44.1(typescript@5.6.3)':
+    dependencies:
+      typescript: 5.6.3
+
+  '@typescript-eslint/type-utils@8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)':
+    dependencies:
+      '@typescript-eslint/types': 8.44.1
+      '@typescript-eslint/typescript-estree': 8.44.1(typescript@5.6.3)
+      '@typescript-eslint/utils': 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      debug: 4.4.3
+      eslint: 9.36.0(jiti@2.6.0)
+      ts-api-utils: 2.1.0(typescript@5.6.3)
+      typescript: 5.6.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@typescript-eslint/types@8.44.1': {}
+
+  '@typescript-eslint/typescript-estree@8.44.1(typescript@5.6.3)':
+    dependencies:
+      '@typescript-eslint/project-service': 8.44.1(typescript@5.6.3)
+      '@typescript-eslint/tsconfig-utils': 8.44.1(typescript@5.6.3)
+      '@typescript-eslint/types': 8.44.1
+      '@typescript-eslint/visitor-keys': 8.44.1
+      debug: 4.4.3
+      fast-glob: 3.3.3
+      is-glob: 4.0.3
+      minimatch: 9.0.5
+      semver: 7.7.2
+      ts-api-utils: 2.1.0(typescript@5.6.3)
+      typescript: 5.6.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@typescript-eslint/utils@8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)':
+    dependencies:
+      '@eslint-community/eslint-utils': 4.9.0(eslint@9.36.0(jiti@2.6.0))
+      '@typescript-eslint/scope-manager': 8.44.1
+      '@typescript-eslint/types': 8.44.1
+      '@typescript-eslint/typescript-estree': 8.44.1(typescript@5.6.3)
+      eslint: 9.36.0(jiti@2.6.0)
+      typescript: 5.6.3
+    transitivePeerDependencies:
+      - supports-color
+
+  '@typescript-eslint/visitor-keys@8.44.1':
+    dependencies:
+      '@typescript-eslint/types': 8.44.1
+      eslint-visitor-keys: 4.2.1
+
+  '@uppy/companion-client@2.2.2':
+    dependencies:
+      '@uppy/utils': 4.1.3
+      namespace-emitter: 2.0.1
+
+  '@uppy/core@2.3.4':
+    dependencies:
+      '@transloadit/prettier-bytes': 0.0.7
+      '@uppy/store-default': 2.1.1
+      '@uppy/utils': 4.1.3
+      lodash.throttle: 4.1.1
+      mime-match: 1.0.2
+      namespace-emitter: 2.0.1
+      nanoid: 3.3.11
+      preact: 10.27.2
+
+  '@uppy/store-default@2.1.1': {}
+
+  '@uppy/utils@4.1.3':
+    dependencies:
+      lodash.throttle: 4.1.1
+
+  '@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4)':
+    dependencies:
+      '@uppy/companion-client': 2.2.2
+      '@uppy/core': 2.3.4
+      '@uppy/utils': 4.1.3
+      nanoid: 3.3.11
+
+  '@vitejs/plugin-vue@6.0.1(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      '@rolldown/pluginutils': 1.0.0-beta.29
+      vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+      vue: 3.5.22(typescript@5.6.3)
+
+  '@volar/language-core@2.4.23':
+    dependencies:
+      '@volar/source-map': 2.4.23
+
+  '@volar/source-map@2.4.23': {}
+
+  '@volar/typescript@2.4.23':
+    dependencies:
+      '@volar/language-core': 2.4.23
+      path-browserify: 1.0.1
+      vscode-uri: 3.1.0
+
+  '@vue/babel-helper-vue-transform-on@1.5.0': {}
+
+  '@vue/babel-plugin-jsx@1.5.0(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/helper-module-imports': 7.27.1
+      '@babel/helper-plugin-utils': 7.27.1
+      '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.28.4)
+      '@babel/template': 7.27.2
+      '@babel/traverse': 7.28.4
+      '@babel/types': 7.28.4
+      '@vue/babel-helper-vue-transform-on': 1.5.0
+      '@vue/babel-plugin-resolve-type': 1.5.0(@babel/core@7.28.4)
+      '@vue/shared': 3.5.22
+    optionalDependencies:
+      '@babel/core': 7.28.4
+    transitivePeerDependencies:
+      - supports-color
+
+  '@vue/babel-plugin-resolve-type@1.5.0(@babel/core@7.28.4)':
+    dependencies:
+      '@babel/code-frame': 7.27.1
+      '@babel/core': 7.28.4
+      '@babel/helper-module-imports': 7.27.1
+      '@babel/helper-plugin-utils': 7.27.1
+      '@babel/parser': 7.28.4
+      '@vue/compiler-sfc': 3.5.22
+    transitivePeerDependencies:
+      - supports-color
+
+  '@vue/compiler-core@3.5.22':
+    dependencies:
+      '@babel/parser': 7.28.4
+      '@vue/shared': 3.5.22
+      entities: 4.5.0
+      estree-walker: 2.0.2
+      source-map-js: 1.2.1
+
+  '@vue/compiler-dom@3.5.22':
+    dependencies:
+      '@vue/compiler-core': 3.5.22
+      '@vue/shared': 3.5.22
+
+  '@vue/compiler-sfc@3.5.22':
+    dependencies:
+      '@babel/parser': 7.28.4
+      '@vue/compiler-core': 3.5.22
+      '@vue/compiler-dom': 3.5.22
+      '@vue/compiler-ssr': 3.5.22
+      '@vue/shared': 3.5.22
+      estree-walker: 2.0.2
+      magic-string: 0.30.19
+      postcss: 8.5.6
+      source-map-js: 1.2.1
+
+  '@vue/compiler-ssr@3.5.22':
+    dependencies:
+      '@vue/compiler-dom': 3.5.22
+      '@vue/shared': 3.5.22
+
+  '@vue/compiler-vue2@2.7.16':
+    dependencies:
+      de-indent: 1.0.2
+      he: 1.2.0
+
+  '@vue/devtools-api@6.6.4': {}
+
+  '@vue/devtools-api@7.7.7':
+    dependencies:
+      '@vue/devtools-kit': 7.7.7
+
+  '@vue/devtools-core@7.7.7(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      '@vue/devtools-kit': 7.7.7
+      '@vue/devtools-shared': 7.7.7
+      mitt: 3.0.1
+      nanoid: 5.1.6
+      pathe: 2.0.3
+      vite-hot-client: 2.1.0(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))
+      vue: 3.5.22(typescript@5.6.3)
+    transitivePeerDependencies:
+      - vite
+
+  '@vue/devtools-kit@7.7.7':
+    dependencies:
+      '@vue/devtools-shared': 7.7.7
+      birpc: 2.6.1
+      hookable: 5.5.3
+      mitt: 3.0.1
+      perfect-debounce: 1.0.0
+      speakingurl: 14.0.1
+      superjson: 2.2.2
+
+  '@vue/devtools-shared@7.7.7':
+    dependencies:
+      rfdc: 1.4.1
+
+  '@vue/language-core@2.1.10(typescript@5.6.3)':
+    dependencies:
+      '@volar/language-core': 2.4.23
+      '@vue/compiler-dom': 3.5.22
+      '@vue/compiler-vue2': 2.7.16
+      '@vue/shared': 3.5.22
+      alien-signals: 0.2.2
+      minimatch: 9.0.5
+      muggle-string: 0.4.1
+      path-browserify: 1.0.1
+    optionalDependencies:
+      typescript: 5.6.3
+
+  '@vue/reactivity@3.5.22':
+    dependencies:
+      '@vue/shared': 3.5.22
+
+  '@vue/runtime-core@3.5.22':
+    dependencies:
+      '@vue/reactivity': 3.5.22
+      '@vue/shared': 3.5.22
+
+  '@vue/runtime-dom@3.5.22':
+    dependencies:
+      '@vue/reactivity': 3.5.22
+      '@vue/runtime-core': 3.5.22
+      '@vue/shared': 3.5.22
+      csstype: 3.1.3
+
+  '@vue/server-renderer@3.5.22(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      '@vue/compiler-ssr': 3.5.22
+      '@vue/shared': 3.5.22
+      vue: 3.5.22(typescript@5.6.3)
+
+  '@vue/shared@3.5.22': {}
+
+  '@vueuse/core@13.9.0(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      '@types/web-bluetooth': 0.0.21
+      '@vueuse/metadata': 13.9.0
+      '@vueuse/shared': 13.9.0(vue@3.5.22(typescript@5.6.3))
+      vue: 3.5.22(typescript@5.6.3)
+
+  '@vueuse/core@9.13.0(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      '@types/web-bluetooth': 0.0.16
+      '@vueuse/metadata': 9.13.0
+      '@vueuse/shared': 9.13.0(vue@3.5.22(typescript@5.6.3))
+      vue-demi: 0.14.10(vue@3.5.22(typescript@5.6.3))
+    transitivePeerDependencies:
+      - '@vue/composition-api'
+      - vue
+
+  '@vueuse/metadata@13.9.0': {}
+
+  '@vueuse/metadata@9.13.0': {}
+
+  '@vueuse/shared@13.9.0(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      vue: 3.5.22(typescript@5.6.3)
+
+  '@vueuse/shared@9.13.0(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      vue-demi: 0.14.10(vue@3.5.22(typescript@5.6.3))
+    transitivePeerDependencies:
+      - '@vue/composition-api'
+      - vue
+
+  '@wangeditor/basic-modules@1.1.7(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.throttle@4.1.1)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)':
+    dependencies:
+      '@wangeditor/core': 1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      dom7: 3.0.0
+      is-url: 1.2.4
+      lodash.throttle: 4.1.1
+      nanoid: 3.3.11
+      slate: 0.72.8
+      snabbdom: 3.6.2
+
+  '@wangeditor/code-highlight@1.0.3(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(slate@0.72.8)(snabbdom@3.6.2)':
+    dependencies:
+      '@wangeditor/core': 1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      dom7: 3.0.0
+      prismjs: 1.30.0
+      slate: 0.72.8
+      snabbdom: 3.6.2
+
+  '@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)':
+    dependencies:
+      '@types/event-emitter': 0.3.5
+      '@uppy/core': 2.3.4
+      '@uppy/xhr-upload': 2.1.3(@uppy/core@2.3.4)
+      dom7: 3.0.0
+      event-emitter: 0.3.5
+      html-void-elements: 2.0.1
+      i18next: 20.6.1
+      is-hotkey: 0.2.0
+      lodash.camelcase: 4.3.0
+      lodash.clonedeep: 4.5.0
+      lodash.debounce: 4.0.8
+      lodash.foreach: 4.5.0
+      lodash.isequal: 4.5.0
+      lodash.throttle: 4.1.1
+      lodash.toarray: 4.4.0
+      nanoid: 3.3.11
+      scroll-into-view-if-needed: 2.2.31
+      slate: 0.72.8
+      slate-history: 0.66.0(slate@0.72.8)
+      snabbdom: 3.6.2
+
+  '@wangeditor/editor-for-vue@5.1.12(@wangeditor/editor@5.1.23)(vue@3.5.22(typescript@5.6.3))':
+    dependencies:
+      '@wangeditor/editor': 5.1.23
+      vue: 3.5.22(typescript@5.6.3)
+
+  '@wangeditor/editor@5.1.23':
+    dependencies:
+      '@uppy/core': 2.3.4
+      '@uppy/xhr-upload': 2.1.3(@uppy/core@2.3.4)
+      '@wangeditor/basic-modules': 1.1.7(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.throttle@4.1.1)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      '@wangeditor/code-highlight': 1.0.3(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(slate@0.72.8)(snabbdom@3.6.2)
+      '@wangeditor/core': 1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      '@wangeditor/list-module': 1.0.5(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(slate@0.72.8)(snabbdom@3.6.2)
+      '@wangeditor/table-module': 1.1.4(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      '@wangeditor/upload-image-module': 1.0.2(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(@wangeditor/basic-modules@1.1.7(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.throttle@4.1.1)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.foreach@4.5.0)(slate@0.72.8)(snabbdom@3.6.2)
+      '@wangeditor/video-module': 1.1.4(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      dom7: 3.0.0
+      is-hotkey: 0.2.0
+      lodash.camelcase: 4.3.0
+      lodash.clonedeep: 4.5.0
+      lodash.debounce: 4.0.8
+      lodash.foreach: 4.5.0
+      lodash.isequal: 4.5.0
+      lodash.throttle: 4.1.1
+      lodash.toarray: 4.4.0
+      nanoid: 3.3.11
+      slate: 0.72.8
+      snabbdom: 3.6.2
+
+  '@wangeditor/list-module@1.0.5(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(slate@0.72.8)(snabbdom@3.6.2)':
+    dependencies:
+      '@wangeditor/core': 1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      dom7: 3.0.0
+      slate: 0.72.8
+      snabbdom: 3.6.2
+
+  '@wangeditor/table-module@1.1.4(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)':
+    dependencies:
+      '@wangeditor/core': 1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      dom7: 3.0.0
+      lodash.isequal: 4.5.0
+      lodash.throttle: 4.1.1
+      nanoid: 3.3.11
+      slate: 0.72.8
+      snabbdom: 3.6.2
+
+  '@wangeditor/upload-image-module@1.0.2(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(@wangeditor/basic-modules@1.1.7(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.throttle@4.1.1)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.foreach@4.5.0)(slate@0.72.8)(snabbdom@3.6.2)':
+    dependencies:
+      '@uppy/core': 2.3.4
+      '@uppy/xhr-upload': 2.1.3(@uppy/core@2.3.4)
+      '@wangeditor/basic-modules': 1.1.7(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(lodash.throttle@4.1.1)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      '@wangeditor/core': 1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      dom7: 3.0.0
+      lodash.foreach: 4.5.0
+      slate: 0.72.8
+      snabbdom: 3.6.2
+
+  '@wangeditor/video-module@1.1.4(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(@wangeditor/core@1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2))(dom7@3.0.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)':
+    dependencies:
+      '@uppy/core': 2.3.4
+      '@uppy/xhr-upload': 2.1.3(@uppy/core@2.3.4)
+      '@wangeditor/core': 1.1.19(@uppy/core@2.3.4)(@uppy/xhr-upload@2.1.3(@uppy/core@2.3.4))(dom7@3.0.0)(is-hotkey@0.2.0)(lodash.camelcase@4.3.0)(lodash.clonedeep@4.5.0)(lodash.debounce@4.0.8)(lodash.foreach@4.5.0)(lodash.isequal@4.5.0)(lodash.throttle@4.1.1)(lodash.toarray@4.4.0)(nanoid@3.3.11)(slate@0.72.8)(snabbdom@3.6.2)
+      dom7: 3.0.0
+      nanoid: 3.3.11
+      slate: 0.72.8
+      snabbdom: 3.6.2
+
+  JSONStream@1.3.5:
+    dependencies:
+      jsonparse: 1.3.1
+      through: 2.3.8
+
+  acorn-jsx@5.3.2(acorn@8.15.0):
+    dependencies:
+      acorn: 8.15.0
+
+  acorn@8.15.0: {}
+
+  adler-32@1.3.1: {}
+
+  ajv@6.12.6:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      fast-json-stable-stringify: 2.1.0
+      json-schema-traverse: 0.4.1
+      uri-js: 4.4.1
+
+  ajv@8.17.1:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      fast-uri: 3.1.0
+      json-schema-traverse: 1.0.0
+      require-from-string: 2.0.2
+
+  alien-signals@0.2.2: {}
+
+  ansi-escapes@4.3.2:
+    dependencies:
+      type-fest: 0.21.3
+
+  ansi-escapes@7.1.1:
+    dependencies:
+      environment: 1.1.0
+
+  ansi-regex@5.0.1: {}
+
+  ansi-regex@6.2.2: {}
+
+  ansi-styles@3.2.1:
+    dependencies:
+      color-convert: 1.9.3
+
+  ansi-styles@4.3.0:
+    dependencies:
+      color-convert: 2.0.1
+
+  ansi-styles@6.2.3: {}
+
+  anymatch@3.1.3:
+    dependencies:
+      normalize-path: 3.0.0
+      picomatch: 2.3.1
+
+  argparse@2.0.1: {}
+
+  array-ify@1.0.0: {}
+
+  array-union@2.1.0: {}
+
+  astral-regex@2.0.0: {}
+
+  async-validator@4.2.5: {}
+
+  asynckit@0.4.0: {}
+
+  at-least-node@1.0.0: {}
+
+  axios@1.12.2:
+    dependencies:
+      follow-redirects: 1.15.11
+      form-data: 4.0.4
+      proxy-from-env: 1.1.0
+    transitivePeerDependencies:
+      - debug
+
+  balanced-match@1.0.2: {}
+
+  balanced-match@2.0.0: {}
+
+  base64-js@1.5.1: {}
+
+  baseline-browser-mapping@2.8.8: {}
+
+  binary-extensions@2.3.0: {}
+
+  birpc@2.6.1: {}
+
+  bl@4.1.0:
+    dependencies:
+      buffer: 5.7.1
+      inherits: 2.0.4
+      readable-stream: 3.6.2
+
+  boolbase@1.0.0: {}
+
+  brace-expansion@1.1.12:
+    dependencies:
+      balanced-match: 1.0.2
+      concat-map: 0.0.1
+
+  brace-expansion@2.0.2:
+    dependencies:
+      balanced-match: 1.0.2
+
+  braces@3.0.3:
+    dependencies:
+      fill-range: 7.1.1
+
+  browserslist@4.26.2:
+    dependencies:
+      baseline-browser-mapping: 2.8.8
+      caniuse-lite: 1.0.30001745
+      electron-to-chromium: 1.5.227
+      node-releases: 2.0.21
+      update-browserslist-db: 1.1.3(browserslist@4.26.2)
+
+  buffer-from@1.1.2: {}
+
+  buffer@5.7.1:
+    dependencies:
+      base64-js: 1.5.1
+      ieee754: 1.2.1
+
+  bundle-name@4.1.0:
+    dependencies:
+      run-applescript: 7.1.0
+
+  cacheable@2.0.2:
+    dependencies:
+      '@cacheable/memoize': 2.0.2
+      '@cacheable/memory': 2.0.2
+      '@cacheable/utils': 2.0.2
+      hookified: 1.12.1
+      keyv: 5.5.3
+
+  cachedir@2.3.0: {}
+
+  call-bind-apply-helpers@1.0.2:
+    dependencies:
+      es-errors: 1.3.0
+      function-bind: 1.1.2
+
+  callsites@3.1.0: {}
+
+  caniuse-lite@1.0.30001745: {}
+
+  cfb@1.2.2:
+    dependencies:
+      adler-32: 1.3.1
+      crc-32: 1.2.2
+
+  chalk@2.4.2:
+    dependencies:
+      ansi-styles: 3.2.1
+      escape-string-regexp: 1.0.5
+      supports-color: 5.5.0
+
+  chalk@4.1.2:
+    dependencies:
+      ansi-styles: 4.3.0
+      supports-color: 7.2.0
+
+  chalk@5.6.2: {}
+
+  chardet@0.7.0: {}
+
+  chokidar@3.6.0:
+    dependencies:
+      anymatch: 3.1.3
+      braces: 3.0.3
+      glob-parent: 5.1.2
+      is-binary-path: 2.1.0
+      is-glob: 4.0.3
+      normalize-path: 3.0.0
+      readdirp: 3.6.0
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  chokidar@4.0.3:
+    dependencies:
+      readdirp: 4.1.2
+
+  chownr@3.0.0: {}
+
+  cli-cursor@3.1.0:
+    dependencies:
+      restore-cursor: 3.1.0
+
+  cli-cursor@5.0.0:
+    dependencies:
+      restore-cursor: 5.1.0
+
+  cli-spinners@2.9.2: {}
+
+  cli-truncate@4.0.0:
+    dependencies:
+      slice-ansi: 5.0.0
+      string-width: 7.2.0
+
+  cli-width@3.0.0: {}
+
+  cliui@8.0.1:
+    dependencies:
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+      wrap-ansi: 7.0.0
+
+  clone@1.0.4: {}
+
+  codepage@1.15.0: {}
+
+  color-convert@1.9.3:
+    dependencies:
+      color-name: 1.1.3
+
+  color-convert@2.0.1:
+    dependencies:
+      color-name: 1.1.4
+
+  color-name@1.1.3: {}
+
+  color-name@1.1.4: {}
+
+  colord@2.9.3: {}
+
+  colorette@2.0.20: {}
+
+  combined-stream@1.0.8:
+    dependencies:
+      delayed-stream: 1.0.0
+
+  commander@13.1.0: {}
+
+  commander@2.20.3: {}
+
+  commitizen@4.3.1(@types/node@24.8.1)(typescript@5.6.3):
+    dependencies:
+      cachedir: 2.3.0
+      cz-conventional-changelog: 3.3.0(@types/node@24.8.1)(typescript@5.6.3)
+      dedent: 0.7.0
+      detect-indent: 6.1.0
+      find-node-modules: 2.1.3
+      find-root: 1.1.0
+      fs-extra: 9.1.0
+      glob: 7.2.3
+      inquirer: 8.2.5
+      is-utf8: 0.2.1
+      lodash: 4.17.21
+      minimist: 1.2.7
+      strip-bom: 4.0.0
+      strip-json-comments: 3.1.1
+    transitivePeerDependencies:
+      - '@types/node'
+      - typescript
+
+  compare-func@2.0.0:
+    dependencies:
+      array-ify: 1.0.0
+      dot-prop: 5.3.0
+
+  compute-scroll-into-view@1.0.20: {}
+
+  concat-map@0.0.1: {}
+
+  confbox@0.1.8: {}
+
+  confbox@0.2.2: {}
+
+  conventional-changelog-angular@7.0.0:
+    dependencies:
+      compare-func: 2.0.0
+
+  conventional-changelog-conventionalcommits@7.0.2:
+    dependencies:
+      compare-func: 2.0.0
+
+  conventional-commit-types@3.0.0: {}
+
+  conventional-commits-parser@5.0.0:
+    dependencies:
+      JSONStream: 1.3.5
+      is-text-path: 2.0.0
+      meow: 12.1.1
+      split2: 4.2.0
+
+  convert-source-map@2.0.0: {}
+
+  copy-anything@3.0.5:
+    dependencies:
+      is-what: 4.1.16
+
+  core-js@3.45.1: {}
+
+  cosmiconfig-typescript-loader@6.1.0(@types/node@24.8.1)(cosmiconfig@9.0.0(typescript@5.6.3))(typescript@5.6.3):
+    dependencies:
+      '@types/node': 24.8.1
+      cosmiconfig: 9.0.0(typescript@5.6.3)
+      jiti: 2.6.0
+      typescript: 5.6.3
+
+  cosmiconfig@9.0.0(typescript@5.6.3):
+    dependencies:
+      env-paths: 2.2.1
+      import-fresh: 3.3.1
+      js-yaml: 4.1.0
+      parse-json: 5.2.0
+    optionalDependencies:
+      typescript: 5.6.3
+
+  crc-32@1.2.2: {}
+
+  cross-spawn@7.0.6:
+    dependencies:
+      path-key: 3.1.1
+      shebang-command: 2.0.0
+      which: 2.0.2
+
+  crypto-js@4.2.0: {}
+
+  css-functions-list@3.2.3: {}
+
+  css-tree@3.1.0:
+    dependencies:
+      mdn-data: 2.12.2
+      source-map-js: 1.2.1
+
+  cssesc@3.0.0: {}
+
+  csstype@3.1.3: {}
+
+  cz-conventional-changelog@3.3.0(@types/node@24.8.1)(typescript@5.6.3):
+    dependencies:
+      chalk: 2.4.2
+      commitizen: 4.3.1(@types/node@24.8.1)(typescript@5.6.3)
+      conventional-commit-types: 3.0.0
+      lodash.map: 4.6.0
+      longest: 2.0.1
+      word-wrap: 1.2.5
+    optionalDependencies:
+      '@commitlint/load': 20.0.0(@types/node@24.8.1)(typescript@5.6.3)
+    transitivePeerDependencies:
+      - '@types/node'
+      - typescript
+
+  cz-git@1.12.0: {}
+
+  d@1.0.2:
+    dependencies:
+      es5-ext: 0.10.64
+      type: 2.7.3
+
+  danmu.js@1.1.13:
+    dependencies:
+      event-emitter: 0.3.5
+
+  dargs@8.1.0: {}
+
+  dayjs@1.11.18: {}
+
+  de-indent@1.0.2: {}
+
+  debug@4.4.3:
+    dependencies:
+      ms: 2.1.3
+
+  dedent@0.7.0: {}
+
+  deep-is@0.1.4: {}
+
+  deep-pick-omit@1.2.1: {}
+
+  default-browser-id@5.0.0: {}
+
+  default-browser@5.2.1:
+    dependencies:
+      bundle-name: 4.1.0
+      default-browser-id: 5.0.0
+
+  defaults@1.0.4:
+    dependencies:
+      clone: 1.0.4
+
+  define-lazy-prop@2.0.0: {}
+
+  define-lazy-prop@3.0.0: {}
+
+  defu@6.1.4: {}
+
+  delayed-stream@1.0.0: {}
+
+  delegate@3.2.0: {}
+
+  destr@2.0.5: {}
+
+  detect-file@1.0.0: {}
+
+  detect-indent@6.1.0: {}
+
+  detect-libc@1.0.3:
+    optional: true
+
+  detect-libc@2.1.2: {}
+
+  dir-glob@3.0.1:
+    dependencies:
+      path-type: 4.0.0
+
+  dom-serializer@2.0.0:
+    dependencies:
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+      entities: 4.5.0
+
+  dom7@3.0.0:
+    dependencies:
+      ssr-window: 3.0.0
+
+  domelementtype@2.3.0: {}
+
+  domhandler@5.0.3:
+    dependencies:
+      domelementtype: 2.3.0
+
+  domutils@3.2.2:
+    dependencies:
+      dom-serializer: 2.0.0
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+
+  dot-prop@5.3.0:
+    dependencies:
+      is-obj: 2.0.0
+
+  downloadjs@1.4.7: {}
+
+  dunder-proto@1.0.1:
+    dependencies:
+      call-bind-apply-helpers: 1.0.2
+      es-errors: 1.3.0
+      gopd: 1.2.0
+
+  echarts@6.0.0:
+    dependencies:
+      tslib: 2.3.0
+      zrender: 6.0.0
+
+  electron-to-chromium@1.5.227: {}
+
+  element-plus@2.11.4(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      '@ctrl/tinycolor': 3.6.1
+      '@element-plus/icons-vue': 2.3.2(vue@3.5.22(typescript@5.6.3))
+      '@floating-ui/dom': 1.7.4
+      '@popperjs/core': '@sxzz/popperjs-es@2.11.7'
+      '@types/lodash': 4.17.20
+      '@types/lodash-es': 4.17.12
+      '@vueuse/core': 9.13.0(vue@3.5.22(typescript@5.6.3))
+      async-validator: 4.2.5
+      dayjs: 1.11.18
+      escape-html: 1.0.3
+      lodash: 4.17.21
+      lodash-es: 4.17.21
+      lodash-unified: 1.0.3(@types/lodash-es@4.17.12)(lodash-es@4.17.21)(lodash@4.17.21)
+      memoize-one: 6.0.0
+      normalize-wheel-es: 1.2.0
+      vue: 3.5.22(typescript@5.6.3)
+    transitivePeerDependencies:
+      - '@vue/composition-api'
+
+  emoji-regex@10.5.0: {}
+
+  emoji-regex@8.0.0: {}
+
+  enhanced-resolve@5.18.3:
+    dependencies:
+      graceful-fs: 4.2.11
+      tapable: 2.3.0
+
+  entities@4.5.0: {}
+
+  env-paths@2.2.1: {}
+
+  environment@1.1.0: {}
+
+  error-ex@1.3.4:
+    dependencies:
+      is-arrayish: 0.2.1
+
+  error-stack-parser-es@0.1.5: {}
+
+  es-define-property@1.0.1: {}
+
+  es-errors@1.3.0: {}
+
+  es-module-lexer@1.7.0: {}
+
+  es-object-atoms@1.1.1:
+    dependencies:
+      es-errors: 1.3.0
+
+  es-set-tostringtag@2.1.0:
+    dependencies:
+      es-errors: 1.3.0
+      get-intrinsic: 1.3.0
+      has-tostringtag: 1.0.2
+      hasown: 2.0.2
+
+  es5-ext@0.10.64:
+    dependencies:
+      es6-iterator: 2.0.3
+      es6-symbol: 3.1.4
+      esniff: 2.0.1
+      next-tick: 1.1.0
+
+  es6-iterator@2.0.3:
+    dependencies:
+      d: 1.0.2
+      es5-ext: 0.10.64
+      es6-symbol: 3.1.4
+
+  es6-symbol@3.1.4:
+    dependencies:
+      d: 1.0.2
+      ext: 1.7.0
+
+  esbuild@0.25.10:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.25.10
+      '@esbuild/android-arm': 0.25.10
+      '@esbuild/android-arm64': 0.25.10
+      '@esbuild/android-x64': 0.25.10
+      '@esbuild/darwin-arm64': 0.25.10
+      '@esbuild/darwin-x64': 0.25.10
+      '@esbuild/freebsd-arm64': 0.25.10
+      '@esbuild/freebsd-x64': 0.25.10
+      '@esbuild/linux-arm': 0.25.10
+      '@esbuild/linux-arm64': 0.25.10
+      '@esbuild/linux-ia32': 0.25.10
+      '@esbuild/linux-loong64': 0.25.10
+      '@esbuild/linux-mips64el': 0.25.10
+      '@esbuild/linux-ppc64': 0.25.10
+      '@esbuild/linux-riscv64': 0.25.10
+      '@esbuild/linux-s390x': 0.25.10
+      '@esbuild/linux-x64': 0.25.10
+      '@esbuild/netbsd-arm64': 0.25.10
+      '@esbuild/netbsd-x64': 0.25.10
+      '@esbuild/openbsd-arm64': 0.25.10
+      '@esbuild/openbsd-x64': 0.25.10
+      '@esbuild/openharmony-arm64': 0.25.10
+      '@esbuild/sunos-x64': 0.25.10
+      '@esbuild/win32-arm64': 0.25.10
+      '@esbuild/win32-ia32': 0.25.10
+      '@esbuild/win32-x64': 0.25.10
+
+  escalade@3.2.0: {}
+
+  escape-html@1.0.3: {}
+
+  escape-string-regexp@1.0.5: {}
+
+  escape-string-regexp@4.0.0: {}
+
+  escape-string-regexp@5.0.0: {}
+
+  eslint-config-prettier@9.1.2(eslint@9.36.0(jiti@2.6.0)):
+    dependencies:
+      eslint: 9.36.0(jiti@2.6.0)
+
+  eslint-plugin-prettier@5.5.4(eslint-config-prettier@9.1.2(eslint@9.36.0(jiti@2.6.0)))(eslint@9.36.0(jiti@2.6.0))(prettier@3.6.2):
+    dependencies:
+      eslint: 9.36.0(jiti@2.6.0)
+      prettier: 3.6.2
+      prettier-linter-helpers: 1.0.0
+      synckit: 0.11.11
+    optionalDependencies:
+      eslint-config-prettier: 9.1.2(eslint@9.36.0(jiti@2.6.0))
+
+  eslint-plugin-vue@9.33.0(eslint@9.36.0(jiti@2.6.0)):
+    dependencies:
+      '@eslint-community/eslint-utils': 4.9.0(eslint@9.36.0(jiti@2.6.0))
+      eslint: 9.36.0(jiti@2.6.0)
+      globals: 13.24.0
+      natural-compare: 1.4.0
+      nth-check: 2.1.1
+      postcss-selector-parser: 6.1.2
+      semver: 7.7.2
+      vue-eslint-parser: 9.4.3(eslint@9.36.0(jiti@2.6.0))
+      xml-name-validator: 4.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  eslint-scope@7.2.2:
+    dependencies:
+      esrecurse: 4.3.0
+      estraverse: 5.3.0
+
+  eslint-scope@8.4.0:
+    dependencies:
+      esrecurse: 4.3.0
+      estraverse: 5.3.0
+
+  eslint-visitor-keys@3.4.3: {}
+
+  eslint-visitor-keys@4.2.1: {}
+
+  eslint@9.36.0(jiti@2.6.0):
+    dependencies:
+      '@eslint-community/eslint-utils': 4.9.0(eslint@9.36.0(jiti@2.6.0))
+      '@eslint-community/regexpp': 4.12.1
+      '@eslint/config-array': 0.21.0
+      '@eslint/config-helpers': 0.3.1
+      '@eslint/core': 0.15.2
+      '@eslint/eslintrc': 3.3.1
+      '@eslint/js': 9.36.0
+      '@eslint/plugin-kit': 0.3.5
+      '@humanfs/node': 0.16.7
+      '@humanwhocodes/module-importer': 1.0.1
+      '@humanwhocodes/retry': 0.4.3
+      '@types/estree': 1.0.8
+      '@types/json-schema': 7.0.15
+      ajv: 6.12.6
+      chalk: 4.1.2
+      cross-spawn: 7.0.6
+      debug: 4.4.3
+      escape-string-regexp: 4.0.0
+      eslint-scope: 8.4.0
+      eslint-visitor-keys: 4.2.1
+      espree: 10.4.0
+      esquery: 1.6.0
+      esutils: 2.0.3
+      fast-deep-equal: 3.1.3
+      file-entry-cache: 8.0.0
+      find-up: 5.0.0
+      glob-parent: 6.0.2
+      ignore: 5.3.2
+      imurmurhash: 0.1.4
+      is-glob: 4.0.3
+      json-stable-stringify-without-jsonify: 1.0.1
+      lodash.merge: 4.6.2
+      minimatch: 3.1.2
+      natural-compare: 1.4.0
+      optionator: 0.9.4
+    optionalDependencies:
+      jiti: 2.6.0
+    transitivePeerDependencies:
+      - supports-color
+
+  esniff@2.0.1:
+    dependencies:
+      d: 1.0.2
+      es5-ext: 0.10.64
+      event-emitter: 0.3.5
+      type: 2.7.3
+
+  espree@10.4.0:
+    dependencies:
+      acorn: 8.15.0
+      acorn-jsx: 5.3.2(acorn@8.15.0)
+      eslint-visitor-keys: 4.2.1
+
+  espree@9.6.1:
+    dependencies:
+      acorn: 8.15.0
+      acorn-jsx: 5.3.2(acorn@8.15.0)
+      eslint-visitor-keys: 3.4.3
+
+  esquery@1.6.0:
+    dependencies:
+      estraverse: 5.3.0
+
+  esrecurse@4.3.0:
+    dependencies:
+      estraverse: 5.3.0
+
+  estraverse@5.3.0: {}
+
+  estree-walker@2.0.2: {}
+
+  estree-walker@3.0.3:
+    dependencies:
+      '@types/estree': 1.0.8
+
+  esutils@2.0.3: {}
+
+  event-emitter@0.3.5:
+    dependencies:
+      d: 1.0.2
+      es5-ext: 0.10.64
+
+  eventemitter3@4.0.7: {}
+
+  eventemitter3@5.0.1: {}
+
+  execa@8.0.1:
+    dependencies:
+      cross-spawn: 7.0.6
+      get-stream: 8.0.1
+      human-signals: 5.0.0
+      is-stream: 3.0.0
+      merge-stream: 2.0.0
+      npm-run-path: 5.3.0
+      onetime: 6.0.0
+      signal-exit: 4.1.0
+      strip-final-newline: 3.0.0
+
+  execa@9.6.0:
+    dependencies:
+      '@sindresorhus/merge-streams': 4.0.0
+      cross-spawn: 7.0.6
+      figures: 6.1.0
+      get-stream: 9.0.1
+      human-signals: 8.0.1
+      is-plain-obj: 4.1.0
+      is-stream: 4.0.1
+      npm-run-path: 6.0.0
+      pretty-ms: 9.3.0
+      signal-exit: 4.1.0
+      strip-final-newline: 4.0.0
+      yoctocolors: 2.1.2
+
+  expand-tilde@2.0.2:
+    dependencies:
+      homedir-polyfill: 1.0.3
+
+  exsolve@1.0.7: {}
+
+  ext@1.7.0:
+    dependencies:
+      type: 2.7.3
+
+  external-editor@3.1.0:
+    dependencies:
+      chardet: 0.7.0
+      iconv-lite: 0.4.24
+      tmp: 0.0.33
+
+  fast-deep-equal@3.1.3: {}
+
+  fast-diff@1.3.0: {}
+
+  fast-glob@3.3.3:
+    dependencies:
+      '@nodelib/fs.stat': 2.0.5
+      '@nodelib/fs.walk': 1.2.8
+      glob-parent: 5.1.2
+      merge2: 1.4.1
+      micromatch: 4.0.8
+
+  fast-json-stable-stringify@2.1.0: {}
+
+  fast-levenshtein@2.0.6: {}
+
+  fast-uri@3.1.0: {}
+
+  fastest-levenshtein@1.0.16: {}
+
+  fastq@1.19.1:
+    dependencies:
+      reusify: 1.1.0
+
+  fdir@6.5.0(picomatch@4.0.3):
+    optionalDependencies:
+      picomatch: 4.0.3
+
+  figures@3.2.0:
+    dependencies:
+      escape-string-regexp: 1.0.5
+
+  figures@6.1.0:
+    dependencies:
+      is-unicode-supported: 2.1.0
+
+  file-entry-cache@10.1.4:
+    dependencies:
+      flat-cache: 6.1.14
+
+  file-entry-cache@8.0.0:
+    dependencies:
+      flat-cache: 4.0.1
+
+  file-saver@2.0.5: {}
+
+  fill-range@7.1.1:
+    dependencies:
+      to-regex-range: 5.0.1
+
+  find-node-modules@2.1.3:
+    dependencies:
+      findup-sync: 4.0.0
+      merge: 2.1.1
+
+  find-root@1.1.0: {}
+
+  find-up@5.0.0:
+    dependencies:
+      locate-path: 6.0.0
+      path-exists: 4.0.0
+
+  find-up@7.0.0:
+    dependencies:
+      locate-path: 7.2.0
+      path-exists: 5.0.0
+      unicorn-magic: 0.1.0
+
+  findup-sync@4.0.0:
+    dependencies:
+      detect-file: 1.0.0
+      is-glob: 4.0.3
+      micromatch: 4.0.8
+      resolve-dir: 1.0.1
+
+  flat-cache@4.0.1:
+    dependencies:
+      flatted: 3.3.3
+      keyv: 4.5.4
+
+  flat-cache@6.1.14:
+    dependencies:
+      cacheable: 2.0.2
+      flatted: 3.3.3
+      hookified: 1.12.1
+
+  flatted@3.3.3: {}
+
+  follow-redirects@1.15.11: {}
+
+  form-data@4.0.4:
+    dependencies:
+      asynckit: 0.4.0
+      combined-stream: 1.0.8
+      es-set-tostringtag: 2.1.0
+      hasown: 2.0.2
+      mime-types: 2.1.35
+
+  frac@1.1.2: {}
+
+  fs-extra@10.1.0:
+    dependencies:
+      graceful-fs: 4.2.11
+      jsonfile: 6.2.0
+      universalify: 2.0.1
+
+  fs-extra@11.3.2:
+    dependencies:
+      graceful-fs: 4.2.11
+      jsonfile: 6.2.0
+      universalify: 2.0.1
+
+  fs-extra@9.1.0:
+    dependencies:
+      at-least-node: 1.0.0
+      graceful-fs: 4.2.11
+      jsonfile: 6.2.0
+      universalify: 2.0.1
+
+  fs.realpath@1.0.0: {}
+
+  fsevents@2.3.3:
+    optional: true
+
+  function-bind@1.1.2: {}
+
+  gensync@1.0.0-beta.2: {}
+
+  get-caller-file@2.0.5: {}
+
+  get-east-asian-width@1.4.0: {}
+
+  get-intrinsic@1.3.0:
+    dependencies:
+      call-bind-apply-helpers: 1.0.2
+      es-define-property: 1.0.1
+      es-errors: 1.3.0
+      es-object-atoms: 1.1.1
+      function-bind: 1.1.2
+      get-proto: 1.0.1
+      gopd: 1.2.0
+      has-symbols: 1.1.0
+      hasown: 2.0.2
+      math-intrinsics: 1.1.0
+
+  get-proto@1.0.1:
+    dependencies:
+      dunder-proto: 1.0.1
+      es-object-atoms: 1.1.1
+
+  get-stream@8.0.1: {}
+
+  get-stream@9.0.1:
+    dependencies:
+      '@sec-ant/readable-stream': 0.4.1
+      is-stream: 4.0.1
+
+  get-tsconfig@4.10.1:
+    dependencies:
+      resolve-pkg-maps: 1.0.0
+
+  git-raw-commits@4.0.0:
+    dependencies:
+      dargs: 8.1.0
+      meow: 12.1.1
+      split2: 4.2.0
+
+  glob-parent@5.1.2:
+    dependencies:
+      is-glob: 4.0.3
+
+  glob-parent@6.0.2:
+    dependencies:
+      is-glob: 4.0.3
+
+  glob@7.2.3:
+    dependencies:
+      fs.realpath: 1.0.0
+      inflight: 1.0.6
+      inherits: 2.0.4
+      minimatch: 3.1.2
+      once: 1.4.0
+      path-is-absolute: 1.0.1
+
+  global-directory@4.0.1:
+    dependencies:
+      ini: 4.1.1
+
+  global-modules@1.0.0:
+    dependencies:
+      global-prefix: 1.0.2
+      is-windows: 1.0.2
+      resolve-dir: 1.0.1
+
+  global-modules@2.0.0:
+    dependencies:
+      global-prefix: 3.0.0
+
+  global-prefix@1.0.2:
+    dependencies:
+      expand-tilde: 2.0.2
+      homedir-polyfill: 1.0.3
+      ini: 1.3.8
+      is-windows: 1.0.2
+      which: 1.3.1
+
+  global-prefix@3.0.0:
+    dependencies:
+      ini: 1.3.8
+      kind-of: 6.0.3
+      which: 1.3.1
+
+  globals@13.24.0:
+    dependencies:
+      type-fest: 0.20.2
+
+  globals@14.0.0: {}
+
+  globals@15.15.0: {}
+
+  globby@11.1.0:
+    dependencies:
+      array-union: 2.1.0
+      dir-glob: 3.0.1
+      fast-glob: 3.3.3
+      ignore: 5.3.2
+      merge2: 1.4.1
+      slash: 3.0.0
+
+  globjoin@0.1.4: {}
+
+  gopd@1.2.0: {}
+
+  graceful-fs@4.2.11: {}
+
+  graphemer@1.4.0: {}
+
+  has-flag@3.0.0: {}
+
+  has-flag@4.0.0: {}
+
+  has-symbols@1.1.0: {}
+
+  has-tostringtag@1.0.2:
+    dependencies:
+      has-symbols: 1.1.0
+
+  hasown@2.0.2:
+    dependencies:
+      function-bind: 1.1.2
+
+  he@1.2.0: {}
+
+  highlight.js@11.11.1: {}
+
+  homedir-polyfill@1.0.3:
+    dependencies:
+      parse-passwd: 1.0.0
+
+  hookable@5.5.3: {}
+
+  hookified@1.12.1: {}
+
+  html-tags@3.3.1: {}
+
+  html-void-elements@2.0.1: {}
+
+  htmlparser2@8.0.2:
+    dependencies:
+      domelementtype: 2.3.0
+      domhandler: 5.0.3
+      domutils: 3.2.2
+      entities: 4.5.0
+
+  human-signals@5.0.0: {}
+
+  human-signals@8.0.1: {}
+
+  husky@9.1.7: {}
+
+  i18next@20.6.1:
+    dependencies:
+      '@babel/runtime': 7.28.4
+
+  iconv-lite@0.4.24:
+    dependencies:
+      safer-buffer: 2.1.2
+
+  ieee754@1.2.1: {}
+
+  ignore@5.3.2: {}
+
+  ignore@7.0.5: {}
+
+  immer@9.0.21: {}
+
+  immutable@5.1.3: {}
+
+  import-fresh@3.3.1:
+    dependencies:
+      parent-module: 1.0.1
+      resolve-from: 4.0.0
+
+  import-meta-resolve@4.2.0: {}
+
+  imurmurhash@0.1.4: {}
+
+  inflight@1.0.6:
+    dependencies:
+      once: 1.4.0
+      wrappy: 1.0.2
+
+  inherits@2.0.4: {}
+
+  ini@1.3.8: {}
+
+  ini@4.1.1: {}
+
+  inquirer@8.2.5:
+    dependencies:
+      ansi-escapes: 4.3.2
+      chalk: 4.1.2
+      cli-cursor: 3.1.0
+      cli-width: 3.0.0
+      external-editor: 3.1.0
+      figures: 3.2.0
+      lodash: 4.17.21
+      mute-stream: 0.0.8
+      ora: 5.4.1
+      run-async: 2.4.1
+      rxjs: 7.8.2
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+      through: 2.3.8
+      wrap-ansi: 7.0.0
+
+  is-arrayish@0.2.1: {}
+
+  is-binary-path@2.1.0:
+    dependencies:
+      binary-extensions: 2.3.0
+
+  is-docker@2.2.1: {}
+
+  is-docker@3.0.0: {}
+
+  is-extglob@2.1.1: {}
+
+  is-fullwidth-code-point@3.0.0: {}
+
+  is-fullwidth-code-point@4.0.0: {}
+
+  is-fullwidth-code-point@5.1.0:
+    dependencies:
+      get-east-asian-width: 1.4.0
+
+  is-glob@4.0.3:
+    dependencies:
+      is-extglob: 2.1.1
+
+  is-hotkey@0.2.0: {}
+
+  is-inside-container@1.0.0:
+    dependencies:
+      is-docker: 3.0.0
+
+  is-interactive@1.0.0: {}
+
+  is-number@7.0.0: {}
+
+  is-obj@2.0.0: {}
+
+  is-plain-obj@4.1.0: {}
+
+  is-plain-object@5.0.0: {}
+
+  is-stream@3.0.0: {}
+
+  is-stream@4.0.1: {}
+
+  is-text-path@2.0.0:
+    dependencies:
+      text-extensions: 2.4.0
+
+  is-unicode-supported@0.1.0: {}
+
+  is-unicode-supported@2.1.0: {}
+
+  is-url@1.2.4: {}
+
+  is-utf8@0.2.1: {}
+
+  is-what@4.1.16: {}
+
+  is-windows@1.0.2: {}
+
+  is-wsl@2.2.0:
+    dependencies:
+      is-docker: 2.2.1
+
+  is-wsl@3.1.0:
+    dependencies:
+      is-inside-container: 1.0.0
+
+  isexe@2.0.0: {}
+
+  jiti@2.6.0: {}
+
+  js-tokens@4.0.0: {}
+
+  js-tokens@9.0.1: {}
+
+  js-yaml@4.1.0:
+    dependencies:
+      argparse: 2.0.1
+
+  jsesc@3.1.0: {}
+
+  json-buffer@3.0.1: {}
+
+  json-parse-even-better-errors@2.3.1: {}
+
+  json-schema-traverse@0.4.1: {}
+
+  json-schema-traverse@1.0.0: {}
+
+  json-stable-stringify-without-jsonify@1.0.1: {}
+
+  json5@2.2.3: {}
+
+  jsonfile@6.2.0:
+    dependencies:
+      universalify: 2.0.1
+    optionalDependencies:
+      graceful-fs: 4.2.11
+
+  jsonparse@1.3.1: {}
+
+  keyv@4.5.4:
+    dependencies:
+      json-buffer: 3.0.1
+
+  keyv@5.5.3:
+    dependencies:
+      '@keyv/serialize': 1.1.1
+
+  kind-of@6.0.3: {}
+
+  known-css-properties@0.36.0: {}
+
+  known-css-properties@0.37.0: {}
+
+  kolorist@1.8.0: {}
+
+  levn@0.4.1:
+    dependencies:
+      prelude-ls: 1.2.1
+      type-check: 0.4.0
+
+  lightningcss-darwin-arm64@1.30.1:
+    optional: true
+
+  lightningcss-darwin-x64@1.30.1:
+    optional: true
+
+  lightningcss-freebsd-x64@1.30.1:
+    optional: true
+
+  lightningcss-linux-arm-gnueabihf@1.30.1:
+    optional: true
+
+  lightningcss-linux-arm64-gnu@1.30.1:
+    optional: true
+
+  lightningcss-linux-arm64-musl@1.30.1:
+    optional: true
+
+  lightningcss-linux-x64-gnu@1.30.1:
+    optional: true
+
+  lightningcss-linux-x64-musl@1.30.1:
+    optional: true
+
+  lightningcss-win32-arm64-msvc@1.30.1:
+    optional: true
+
+  lightningcss-win32-x64-msvc@1.30.1:
+    optional: true
+
+  lightningcss@1.30.1:
+    dependencies:
+      detect-libc: 2.1.2
+    optionalDependencies:
+      lightningcss-darwin-arm64: 1.30.1
+      lightningcss-darwin-x64: 1.30.1
+      lightningcss-freebsd-x64: 1.30.1
+      lightningcss-linux-arm-gnueabihf: 1.30.1
+      lightningcss-linux-arm64-gnu: 1.30.1
+      lightningcss-linux-arm64-musl: 1.30.1
+      lightningcss-linux-x64-gnu: 1.30.1
+      lightningcss-linux-x64-musl: 1.30.1
+      lightningcss-win32-arm64-msvc: 1.30.1
+      lightningcss-win32-x64-msvc: 1.30.1
+
+  lilconfig@3.1.3: {}
+
+  lines-and-columns@1.2.4: {}
+
+  lint-staged@15.5.2:
+    dependencies:
+      chalk: 5.6.2
+      commander: 13.1.0
+      debug: 4.4.3
+      execa: 8.0.1
+      lilconfig: 3.1.3
+      listr2: 8.3.3
+      micromatch: 4.0.8
+      pidtree: 0.6.0
+      string-argv: 0.3.2
+      yaml: 2.8.1
+    transitivePeerDependencies:
+      - supports-color
+
+  listr2@8.3.3:
+    dependencies:
+      cli-truncate: 4.0.0
+      colorette: 2.0.20
+      eventemitter3: 5.0.1
+      log-update: 6.1.0
+      rfdc: 1.4.1
+      wrap-ansi: 9.0.2
+
+  local-pkg@1.1.2:
+    dependencies:
+      mlly: 1.8.0
+      pkg-types: 2.3.0
+      quansync: 0.2.11
+
+  locate-path@6.0.0:
+    dependencies:
+      p-locate: 5.0.0
+
+  locate-path@7.2.0:
+    dependencies:
+      p-locate: 6.0.0
+
+  lodash-es@4.17.21: {}
+
+  lodash-unified@1.0.3(@types/lodash-es@4.17.12)(lodash-es@4.17.21)(lodash@4.17.21):
+    dependencies:
+      '@types/lodash-es': 4.17.12
+      lodash: 4.17.21
+      lodash-es: 4.17.21
+
+  lodash.camelcase@4.3.0: {}
+
+  lodash.clonedeep@4.5.0: {}
+
+  lodash.debounce@4.0.8: {}
+
+  lodash.foreach@4.5.0: {}
+
+  lodash.isequal@4.5.0: {}
+
+  lodash.isplainobject@4.0.6: {}
+
+  lodash.kebabcase@4.1.1: {}
+
+  lodash.map@4.6.0: {}
+
+  lodash.merge@4.6.2: {}
+
+  lodash.mergewith@4.6.2: {}
+
+  lodash.snakecase@4.1.1: {}
+
+  lodash.startcase@4.4.0: {}
+
+  lodash.throttle@4.1.1: {}
+
+  lodash.toarray@4.4.0: {}
+
+  lodash.truncate@4.4.2: {}
+
+  lodash.uniq@4.5.0: {}
+
+  lodash.upperfirst@4.3.1: {}
+
+  lodash@4.17.21: {}
+
+  log-symbols@4.1.0:
+    dependencies:
+      chalk: 4.1.2
+      is-unicode-supported: 0.1.0
+
+  log-update@6.1.0:
+    dependencies:
+      ansi-escapes: 7.1.1
+      cli-cursor: 5.0.0
+      slice-ansi: 7.1.2
+      strip-ansi: 7.1.2
+      wrap-ansi: 9.0.2
+
+  longest@2.0.1: {}
+
+  lru-cache@5.1.1:
+    dependencies:
+      yallist: 3.1.1
+
+  magic-string@0.30.19:
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.5.5
+
+  math-intrinsics@1.1.0: {}
+
+  mathml-tag-names@2.1.3: {}
+
+  mdn-data@2.12.2: {}
+
+  mdn-data@2.24.0: {}
+
+  memoize-one@6.0.0: {}
+
+  meow@12.1.1: {}
+
+  meow@13.2.0: {}
+
+  merge-stream@2.0.0: {}
+
+  merge2@1.4.1: {}
+
+  merge@2.1.1: {}
+
+  micromatch@4.0.8:
+    dependencies:
+      braces: 3.0.3
+      picomatch: 2.3.1
+
+  mime-db@1.52.0: {}
+
+  mime-match@1.0.2:
+    dependencies:
+      wildcard: 1.1.2
+
+  mime-types@2.1.35:
+    dependencies:
+      mime-db: 1.52.0
+
+  mimic-fn@2.1.0: {}
+
+  mimic-fn@4.0.0: {}
+
+  mimic-function@5.0.1: {}
+
+  minimatch@3.1.2:
+    dependencies:
+      brace-expansion: 1.1.12
+
+  minimatch@9.0.5:
+    dependencies:
+      brace-expansion: 2.0.2
+
+  minimist@1.2.7: {}
+
+  minimist@1.2.8: {}
+
+  minipass@7.1.2: {}
+
+  minizlib@3.1.0:
+    dependencies:
+      minipass: 7.1.2
+
+  mitt@3.0.1: {}
+
+  mlly@1.8.0:
+    dependencies:
+      acorn: 8.15.0
+      pathe: 2.0.3
+      pkg-types: 1.3.1
+      ufo: 1.6.1
+
+  mrmime@2.0.1: {}
+
+  ms@2.1.3: {}
+
+  muggle-string@0.4.1: {}
+
+  mute-stream@0.0.8: {}
+
+  namespace-emitter@2.0.1: {}
+
+  nanoid@3.3.11: {}
+
+  nanoid@5.1.6: {}
+
+  natural-compare@1.4.0: {}
+
+  next-tick@1.1.0: {}
+
+  node-addon-api@7.1.1:
+    optional: true
+
+  node-releases@2.0.21: {}
+
+  normalize-path@3.0.0: {}
+
+  normalize-wheel-es@1.2.0: {}
+
+  npm-run-path@5.3.0:
+    dependencies:
+      path-key: 4.0.0
+
+  npm-run-path@6.0.0:
+    dependencies:
+      path-key: 4.0.0
+      unicorn-magic: 0.3.0
+
+  nprogress@0.2.0: {}
+
+  nth-check@2.1.1:
+    dependencies:
+      boolbase: 1.0.0
+
+  ohash@2.0.11: {}
+
+  once@1.4.0:
+    dependencies:
+      wrappy: 1.0.2
+
+  onetime@5.1.2:
+    dependencies:
+      mimic-fn: 2.1.0
+
+  onetime@6.0.0:
+    dependencies:
+      mimic-fn: 4.0.0
+
+  onetime@7.0.0:
+    dependencies:
+      mimic-function: 5.0.1
+
+  open@10.2.0:
+    dependencies:
+      default-browser: 5.2.1
+      define-lazy-prop: 3.0.0
+      is-inside-container: 1.0.0
+      wsl-utils: 0.1.0
+
+  open@8.4.2:
+    dependencies:
+      define-lazy-prop: 2.0.0
+      is-docker: 2.2.1
+      is-wsl: 2.2.0
+
+  optionator@0.9.4:
+    dependencies:
+      deep-is: 0.1.4
+      fast-levenshtein: 2.0.6
+      levn: 0.4.1
+      prelude-ls: 1.2.1
+      type-check: 0.4.0
+      word-wrap: 1.2.5
+
+  ora@5.4.1:
+    dependencies:
+      bl: 4.1.0
+      chalk: 4.1.2
+      cli-cursor: 3.1.0
+      cli-spinners: 2.9.2
+      is-interactive: 1.0.0
+      is-unicode-supported: 0.1.0
+      log-symbols: 4.1.0
+      strip-ansi: 6.0.1
+      wcwidth: 1.0.1
+
+  os-tmpdir@1.0.2: {}
+
+  p-limit@3.1.0:
+    dependencies:
+      yocto-queue: 0.1.0
+
+  p-limit@4.0.0:
+    dependencies:
+      yocto-queue: 1.2.1
+
+  p-locate@5.0.0:
+    dependencies:
+      p-limit: 3.1.0
+
+  p-locate@6.0.0:
+    dependencies:
+      p-limit: 4.0.0
+
+  parent-module@1.0.1:
+    dependencies:
+      callsites: 3.1.0
+
+  parse-json@5.2.0:
+    dependencies:
+      '@babel/code-frame': 7.27.1
+      error-ex: 1.3.4
+      json-parse-even-better-errors: 2.3.1
+      lines-and-columns: 1.2.4
+
+  parse-ms@4.0.0: {}
+
+  parse-passwd@1.0.0: {}
+
+  path-browserify@1.0.1: {}
+
+  path-exists@4.0.0: {}
+
+  path-exists@5.0.0: {}
+
+  path-is-absolute@1.0.1: {}
+
+  path-key@3.1.1: {}
+
+  path-key@4.0.0: {}
+
+  path-type@4.0.0: {}
+
+  pathe@2.0.3: {}
+
+  perfect-debounce@1.0.0: {}
+
+  picocolors@1.1.1: {}
+
+  picomatch@2.3.1: {}
+
+  picomatch@4.0.3: {}
+
+  pidtree@0.6.0: {}
+
+  pinia-plugin-persistedstate@4.5.0(pinia@3.0.3(typescript@5.6.3)(vue@3.5.22(typescript@5.6.3))):
+    dependencies:
+      deep-pick-omit: 1.2.1
+      defu: 6.1.4
+      destr: 2.0.5
+    optionalDependencies:
+      pinia: 3.0.3(typescript@5.6.3)(vue@3.5.22(typescript@5.6.3))
+
+  pinia@3.0.3(typescript@5.6.3)(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      '@vue/devtools-api': 7.7.7
+      vue: 3.5.22(typescript@5.6.3)
+    optionalDependencies:
+      typescript: 5.6.3
+
+  pkg-types@1.3.1:
+    dependencies:
+      confbox: 0.1.8
+      mlly: 1.8.0
+      pathe: 2.0.3
+
+  pkg-types@2.3.0:
+    dependencies:
+      confbox: 0.2.2
+      exsolve: 1.0.7
+      pathe: 2.0.3
+
+  postcss-html@1.8.0:
+    dependencies:
+      htmlparser2: 8.0.2
+      js-tokens: 9.0.1
+      postcss: 8.5.6
+      postcss-safe-parser: 6.0.0(postcss@8.5.6)
+
+  postcss-media-query-parser@0.2.3: {}
+
+  postcss-resolve-nested-selector@0.1.6: {}
+
+  postcss-safe-parser@6.0.0(postcss@8.5.6):
+    dependencies:
+      postcss: 8.5.6
+
+  postcss-safe-parser@7.0.1(postcss@8.5.6):
+    dependencies:
+      postcss: 8.5.6
+
+  postcss-scss@4.0.9(postcss@8.5.6):
+    dependencies:
+      postcss: 8.5.6
+
+  postcss-selector-parser@6.1.2:
+    dependencies:
+      cssesc: 3.0.0
+      util-deprecate: 1.0.2
+
+  postcss-selector-parser@7.1.0:
+    dependencies:
+      cssesc: 3.0.0
+      util-deprecate: 1.0.2
+
+  postcss-sorting@8.0.2(postcss@8.5.6):
+    dependencies:
+      postcss: 8.5.6
+
+  postcss-value-parser@4.2.0: {}
+
+  postcss@8.5.6:
+    dependencies:
+      nanoid: 3.3.11
+      picocolors: 1.1.1
+      source-map-js: 1.2.1
+
+  preact@10.27.2: {}
+
+  prelude-ls@1.2.1: {}
+
+  prettier-linter-helpers@1.0.0:
+    dependencies:
+      fast-diff: 1.3.0
+
+  prettier@3.6.2: {}
+
+  pretty-ms@9.3.0:
+    dependencies:
+      parse-ms: 4.0.0
+
+  prismjs@1.30.0: {}
+
+  proxy-from-env@1.1.0: {}
+
+  punycode@2.3.1: {}
+
+  qrcode.vue@3.6.0(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      vue: 3.5.22(typescript@5.6.3)
+
+  quansync@0.2.11: {}
+
+  queue-microtask@1.2.3: {}
+
+  readable-stream@3.6.2:
+    dependencies:
+      inherits: 2.0.4
+      string_decoder: 1.3.0
+      util-deprecate: 1.0.2
+
+  readdirp@3.6.0:
+    dependencies:
+      picomatch: 2.3.1
+
+  readdirp@4.1.2: {}
+
+  require-directory@2.1.1: {}
+
+  require-from-string@2.0.2: {}
+
+  resolve-dir@1.0.1:
+    dependencies:
+      expand-tilde: 2.0.2
+      global-modules: 1.0.0
+
+  resolve-from@4.0.0: {}
+
+  resolve-from@5.0.0: {}
+
+  resolve-pkg-maps@1.0.0: {}
+
+  restore-cursor@3.1.0:
+    dependencies:
+      onetime: 5.1.2
+      signal-exit: 3.0.7
+
+  restore-cursor@5.1.0:
+    dependencies:
+      onetime: 7.0.0
+      signal-exit: 4.1.0
+
+  reusify@1.1.0: {}
+
+  rfdc@1.4.1: {}
+
+  rollup-plugin-visualizer@5.14.0(rollup@4.52.3):
+    dependencies:
+      open: 8.4.2
+      picomatch: 4.0.3
+      source-map: 0.7.6
+      yargs: 17.7.2
+    optionalDependencies:
+      rollup: 4.52.3
+
+  rollup@4.52.3:
+    dependencies:
+      '@types/estree': 1.0.8
+    optionalDependencies:
+      '@rollup/rollup-android-arm-eabi': 4.52.3
+      '@rollup/rollup-android-arm64': 4.52.3
+      '@rollup/rollup-darwin-arm64': 4.52.3
+      '@rollup/rollup-darwin-x64': 4.52.3
+      '@rollup/rollup-freebsd-arm64': 4.52.3
+      '@rollup/rollup-freebsd-x64': 4.52.3
+      '@rollup/rollup-linux-arm-gnueabihf': 4.52.3
+      '@rollup/rollup-linux-arm-musleabihf': 4.52.3
+      '@rollup/rollup-linux-arm64-gnu': 4.52.3
+      '@rollup/rollup-linux-arm64-musl': 4.52.3
+      '@rollup/rollup-linux-loong64-gnu': 4.52.3
+      '@rollup/rollup-linux-ppc64-gnu': 4.52.3
+      '@rollup/rollup-linux-riscv64-gnu': 4.52.3
+      '@rollup/rollup-linux-riscv64-musl': 4.52.3
+      '@rollup/rollup-linux-s390x-gnu': 4.52.3
+      '@rollup/rollup-linux-x64-gnu': 4.52.3
+      '@rollup/rollup-linux-x64-musl': 4.52.3
+      '@rollup/rollup-openharmony-arm64': 4.52.3
+      '@rollup/rollup-win32-arm64-msvc': 4.52.3
+      '@rollup/rollup-win32-ia32-msvc': 4.52.3
+      '@rollup/rollup-win32-x64-gnu': 4.52.3
+      '@rollup/rollup-win32-x64-msvc': 4.52.3
+      fsevents: 2.3.3
+
+  run-applescript@7.1.0: {}
+
+  run-async@2.4.1: {}
+
+  run-parallel@1.2.0:
+    dependencies:
+      queue-microtask: 1.2.3
+
+  rxjs@7.8.2:
+    dependencies:
+      tslib: 2.8.1
+
+  safe-buffer@5.2.1: {}
+
+  safer-buffer@2.1.2: {}
+
+  sass@1.93.2:
+    dependencies:
+      chokidar: 4.0.3
+      immutable: 5.1.3
+      source-map-js: 1.2.1
+    optionalDependencies:
+      '@parcel/watcher': 2.5.1
+
+  scroll-into-view-if-needed@2.2.31:
+    dependencies:
+      compute-scroll-into-view: 1.0.20
+
+  scule@1.3.0: {}
+
+  semver@6.3.1: {}
+
+  semver@7.7.2: {}
+
+  shebang-command@2.0.0:
+    dependencies:
+      shebang-regex: 3.0.0
+
+  shebang-regex@3.0.0: {}
+
+  signal-exit@3.0.7: {}
+
+  signal-exit@4.1.0: {}
+
+  sirv@3.0.2:
+    dependencies:
+      '@polka/url': 1.0.0-next.29
+      mrmime: 2.0.1
+      totalist: 3.0.1
+
+  slash@3.0.0: {}
+
+  slate-history@0.66.0(slate@0.72.8):
+    dependencies:
+      is-plain-object: 5.0.0
+      slate: 0.72.8
+
+  slate@0.72.8:
+    dependencies:
+      immer: 9.0.21
+      is-plain-object: 5.0.0
+      tiny-warning: 1.0.3
+
+  slice-ansi@4.0.0:
+    dependencies:
+      ansi-styles: 4.3.0
+      astral-regex: 2.0.0
+      is-fullwidth-code-point: 3.0.0
+
+  slice-ansi@5.0.0:
+    dependencies:
+      ansi-styles: 6.2.3
+      is-fullwidth-code-point: 4.0.0
+
+  slice-ansi@7.1.2:
+    dependencies:
+      ansi-styles: 6.2.3
+      is-fullwidth-code-point: 5.1.0
+
+  snabbdom@3.6.2: {}
+
+  source-map-js@1.2.1: {}
+
+  source-map-support@0.5.21:
+    dependencies:
+      buffer-from: 1.1.2
+      source-map: 0.6.1
+
+  source-map@0.6.1: {}
+
+  source-map@0.7.6: {}
+
+  speakingurl@14.0.1: {}
+
+  split2@4.2.0: {}
+
+  ssf@0.11.2:
+    dependencies:
+      frac: 1.1.2
+
+  ssr-window@3.0.0: {}
+
+  string-argv@0.3.2: {}
+
+  string-width@4.2.3:
+    dependencies:
+      emoji-regex: 8.0.0
+      is-fullwidth-code-point: 3.0.0
+      strip-ansi: 6.0.1
+
+  string-width@7.2.0:
+    dependencies:
+      emoji-regex: 10.5.0
+      get-east-asian-width: 1.4.0
+      strip-ansi: 7.1.2
+
+  string_decoder@1.3.0:
+    dependencies:
+      safe-buffer: 5.2.1
+
+  strip-ansi@6.0.1:
+    dependencies:
+      ansi-regex: 5.0.1
+
+  strip-ansi@7.1.2:
+    dependencies:
+      ansi-regex: 6.2.2
+
+  strip-bom@4.0.0: {}
+
+  strip-final-newline@3.0.0: {}
+
+  strip-final-newline@4.0.0: {}
+
+  strip-json-comments@3.1.1: {}
+
+  strip-literal@3.1.0:
+    dependencies:
+      js-tokens: 9.0.1
+
+  stylelint-config-html@1.1.0(postcss-html@1.8.0)(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      postcss-html: 1.8.0
+      stylelint: 16.24.0(typescript@5.6.3)
+
+  stylelint-config-recess-order@4.6.0(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      stylelint: 16.24.0(typescript@5.6.3)
+      stylelint-order: 6.0.4(stylelint@16.24.0(typescript@5.6.3))
+
+  stylelint-config-recommended-scss@14.1.0(postcss@8.5.6)(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      postcss-scss: 4.0.9(postcss@8.5.6)
+      stylelint: 16.24.0(typescript@5.6.3)
+      stylelint-config-recommended: 14.0.1(stylelint@16.24.0(typescript@5.6.3))
+      stylelint-scss: 6.12.1(stylelint@16.24.0(typescript@5.6.3))
+    optionalDependencies:
+      postcss: 8.5.6
+
+  stylelint-config-recommended-vue@1.6.1(postcss-html@1.8.0)(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      postcss-html: 1.8.0
+      semver: 7.7.2
+      stylelint: 16.24.0(typescript@5.6.3)
+      stylelint-config-html: 1.1.0(postcss-html@1.8.0)(stylelint@16.24.0(typescript@5.6.3))
+      stylelint-config-recommended: 17.0.0(stylelint@16.24.0(typescript@5.6.3))
+
+  stylelint-config-recommended@14.0.1(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      stylelint: 16.24.0(typescript@5.6.3)
+
+  stylelint-config-recommended@17.0.0(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      stylelint: 16.24.0(typescript@5.6.3)
+
+  stylelint-config-standard@36.0.1(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      stylelint: 16.24.0(typescript@5.6.3)
+      stylelint-config-recommended: 14.0.1(stylelint@16.24.0(typescript@5.6.3))
+
+  stylelint-order@6.0.4(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      postcss: 8.5.6
+      postcss-sorting: 8.0.2(postcss@8.5.6)
+      stylelint: 16.24.0(typescript@5.6.3)
+
+  stylelint-scss@6.12.1(stylelint@16.24.0(typescript@5.6.3)):
+    dependencies:
+      css-tree: 3.1.0
+      is-plain-object: 5.0.0
+      known-css-properties: 0.36.0
+      mdn-data: 2.24.0
+      postcss-media-query-parser: 0.2.3
+      postcss-resolve-nested-selector: 0.1.6
+      postcss-selector-parser: 7.1.0
+      postcss-value-parser: 4.2.0
+      stylelint: 16.24.0(typescript@5.6.3)
+
+  stylelint@16.24.0(typescript@5.6.3):
+    dependencies:
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4)
+      '@csstools/css-tokenizer': 3.0.4
+      '@csstools/media-query-list-parser': 4.0.3(@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4))(@csstools/css-tokenizer@3.0.4)
+      '@csstools/selector-specificity': 5.0.0(postcss-selector-parser@7.1.0)
+      '@dual-bundle/import-meta-resolve': 4.2.1
+      balanced-match: 2.0.0
+      colord: 2.9.3
+      cosmiconfig: 9.0.0(typescript@5.6.3)
+      css-functions-list: 3.2.3
+      css-tree: 3.1.0
+      debug: 4.4.3
+      fast-glob: 3.3.3
+      fastest-levenshtein: 1.0.16
+      file-entry-cache: 10.1.4
+      global-modules: 2.0.0
+      globby: 11.1.0
+      globjoin: 0.1.4
+      html-tags: 3.3.1
+      ignore: 7.0.5
+      imurmurhash: 0.1.4
+      is-plain-object: 5.0.0
+      known-css-properties: 0.37.0
+      mathml-tag-names: 2.1.3
+      meow: 13.2.0
+      micromatch: 4.0.8
+      normalize-path: 3.0.0
+      picocolors: 1.1.1
+      postcss: 8.5.6
+      postcss-resolve-nested-selector: 0.1.6
+      postcss-safe-parser: 7.0.1(postcss@8.5.6)
+      postcss-selector-parser: 7.1.0
+      postcss-value-parser: 4.2.0
+      resolve-from: 5.0.0
+      string-width: 4.2.3
+      supports-hyperlinks: 3.2.0
+      svg-tags: 1.0.0
+      table: 6.9.0
+      write-file-atomic: 5.0.1
+    transitivePeerDependencies:
+      - supports-color
+      - typescript
+
+  superjson@2.2.2:
+    dependencies:
+      copy-anything: 3.0.5
+
+  supports-color@5.5.0:
+    dependencies:
+      has-flag: 3.0.0
+
+  supports-color@7.2.0:
+    dependencies:
+      has-flag: 4.0.0
+
+  supports-hyperlinks@3.2.0:
+    dependencies:
+      has-flag: 4.0.0
+      supports-color: 7.2.0
+
+  svg-tags@1.0.0: {}
+
+  synckit@0.11.11:
+    dependencies:
+      '@pkgr/core': 0.2.9
+
+  table@6.9.0:
+    dependencies:
+      ajv: 8.17.1
+      lodash.truncate: 4.4.2
+      slice-ansi: 4.0.0
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+
+  tailwindcss@4.1.14: {}
+
+  tapable@2.3.0: {}
+
+  tar@7.5.1:
+    dependencies:
+      '@isaacs/fs-minipass': 4.0.1
+      chownr: 3.0.0
+      minipass: 7.1.2
+      minizlib: 3.1.0
+      yallist: 5.0.0
+
+  terser@5.44.0:
+    dependencies:
+      '@jridgewell/source-map': 0.3.11
+      acorn: 8.15.0
+      commander: 2.20.3
+      source-map-support: 0.5.21
+
+  text-extensions@2.4.0: {}
+
+  through@2.3.8: {}
+
+  tiny-warning@1.0.3: {}
+
+  tinyexec@1.0.1: {}
+
+  tinyglobby@0.2.15:
+    dependencies:
+      fdir: 6.5.0(picomatch@4.0.3)
+      picomatch: 4.0.3
+
+  tmp@0.0.33:
+    dependencies:
+      os-tmpdir: 1.0.2
+
+  to-regex-range@5.0.1:
+    dependencies:
+      is-number: 7.0.0
+
+  totalist@3.0.1: {}
+
+  ts-api-utils@2.1.0(typescript@5.6.3):
+    dependencies:
+      typescript: 5.6.3
+
+  tslib@2.3.0: {}
+
+  tslib@2.8.1: {}
+
+  tsx@4.20.6:
+    dependencies:
+      esbuild: 0.25.10
+      get-tsconfig: 4.10.1
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  type-check@0.4.0:
+    dependencies:
+      prelude-ls: 1.2.1
+
+  type-fest@0.20.2: {}
+
+  type-fest@0.21.3: {}
+
+  type@2.7.3: {}
+
+  typescript-eslint@8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3):
+    dependencies:
+      '@typescript-eslint/eslint-plugin': 8.44.1(@typescript-eslint/parser@8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3))(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      '@typescript-eslint/parser': 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      '@typescript-eslint/typescript-estree': 8.44.1(typescript@5.6.3)
+      '@typescript-eslint/utils': 8.44.1(eslint@9.36.0(jiti@2.6.0))(typescript@5.6.3)
+      eslint: 9.36.0(jiti@2.6.0)
+      typescript: 5.6.3
+    transitivePeerDependencies:
+      - supports-color
+
+  typescript@5.6.3: {}
+
+  ufo@1.6.1: {}
+
+  undici-types@7.14.0: {}
+
+  unicorn-magic@0.1.0: {}
+
+  unicorn-magic@0.3.0: {}
+
+  unimport@5.4.0:
+    dependencies:
+      acorn: 8.15.0
+      escape-string-regexp: 5.0.0
+      estree-walker: 3.0.3
+      local-pkg: 1.1.2
+      magic-string: 0.30.19
+      mlly: 1.8.0
+      pathe: 2.0.3
+      picomatch: 4.0.3
+      pkg-types: 2.3.0
+      scule: 1.3.0
+      strip-literal: 3.1.0
+      tinyglobby: 0.2.15
+      unplugin: 2.3.10
+      unplugin-utils: 0.3.0
+
+  universalify@2.0.1: {}
+
+  unplugin-auto-import@20.2.0(@vueuse/core@13.9.0(vue@3.5.22(typescript@5.6.3))):
+    dependencies:
+      local-pkg: 1.1.2
+      magic-string: 0.30.19
+      picomatch: 4.0.3
+      unimport: 5.4.0
+      unplugin: 2.3.10
+      unplugin-utils: 0.3.0
+    optionalDependencies:
+      '@vueuse/core': 13.9.0(vue@3.5.22(typescript@5.6.3))
+
+  unplugin-element-plus@0.10.0:
+    dependencies:
+      es-module-lexer: 1.7.0
+      magic-string: 0.30.19
+      unplugin: 2.3.10
+      unplugin-utils: 0.2.5
+
+  unplugin-utils@0.2.5:
+    dependencies:
+      pathe: 2.0.3
+      picomatch: 4.0.3
+
+  unplugin-utils@0.3.0:
+    dependencies:
+      pathe: 2.0.3
+      picomatch: 4.0.3
+
+  unplugin-vue-components@29.1.0(@babel/parser@7.28.4)(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      chokidar: 3.6.0
+      debug: 4.4.3
+      local-pkg: 1.1.2
+      magic-string: 0.30.19
+      mlly: 1.8.0
+      tinyglobby: 0.2.15
+      unplugin: 2.3.10
+      unplugin-utils: 0.3.0
+      vue: 3.5.22(typescript@5.6.3)
+    optionalDependencies:
+      '@babel/parser': 7.28.4
+    transitivePeerDependencies:
+      - supports-color
+
+  unplugin@2.3.10:
+    dependencies:
+      '@jridgewell/remapping': 2.3.5
+      acorn: 8.15.0
+      picomatch: 4.0.3
+      webpack-virtual-modules: 0.6.2
+
+  update-browserslist-db@1.1.3(browserslist@4.26.2):
+    dependencies:
+      browserslist: 4.26.2
+      escalade: 3.2.0
+      picocolors: 1.1.1
+
+  uri-js@4.4.1:
+    dependencies:
+      punycode: 2.3.1
+
+  util-deprecate@1.0.2: {}
+
+  vite-hot-client@2.1.0(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
+    dependencies:
+      vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+
+  vite-plugin-compression@0.5.1(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
+    dependencies:
+      chalk: 4.1.2
+      debug: 4.4.3
+      fs-extra: 10.1.0
+      vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+    transitivePeerDependencies:
+      - supports-color
+
+  vite-plugin-inspect@0.8.9(rollup@4.52.3)(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
+    dependencies:
+      '@antfu/utils': 0.7.10
+      '@rollup/pluginutils': 5.3.0(rollup@4.52.3)
+      debug: 4.4.3
+      error-stack-parser-es: 0.1.5
+      fs-extra: 11.3.2
+      open: 10.2.0
+      perfect-debounce: 1.0.0
+      picocolors: 1.1.1
+      sirv: 3.0.2
+      vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+    transitivePeerDependencies:
+      - rollup
+      - supports-color
+
+  vite-plugin-vue-devtools@7.7.7(rollup@4.52.3)(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      '@vue/devtools-core': 7.7.7(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))(vue@3.5.22(typescript@5.6.3))
+      '@vue/devtools-kit': 7.7.7
+      '@vue/devtools-shared': 7.7.7
+      execa: 9.6.0
+      sirv: 3.0.2
+      vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+      vite-plugin-inspect: 0.8.9(rollup@4.52.3)(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))
+      vite-plugin-vue-inspector: 5.3.2(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))
+    transitivePeerDependencies:
+      - '@nuxt/kit'
+      - rollup
+      - supports-color
+      - vue
+
+  vite-plugin-vue-inspector@5.3.2(vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
+    dependencies:
+      '@babel/core': 7.28.4
+      '@babel/plugin-proposal-decorators': 7.28.0(@babel/core@7.28.4)
+      '@babel/plugin-syntax-import-attributes': 7.27.1(@babel/core@7.28.4)
+      '@babel/plugin-syntax-import-meta': 7.10.4(@babel/core@7.28.4)
+      '@babel/plugin-transform-typescript': 7.28.0(@babel/core@7.28.4)
+      '@vue/babel-plugin-jsx': 1.5.0(@babel/core@7.28.4)
+      '@vue/compiler-dom': 3.5.22
+      kolorist: 1.8.0
+      magic-string: 0.30.19
+      vite: 7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
+    transitivePeerDependencies:
+      - supports-color
+
+  vite@7.1.7(@types/node@24.8.1)(jiti@2.6.0)(lightningcss@1.30.1)(sass@1.93.2)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1):
+    dependencies:
+      esbuild: 0.25.10
+      fdir: 6.5.0(picomatch@4.0.3)
+      picomatch: 4.0.3
+      postcss: 8.5.6
+      rollup: 4.52.3
+      tinyglobby: 0.2.15
+    optionalDependencies:
+      '@types/node': 24.8.1
+      fsevents: 2.3.3
+      jiti: 2.6.0
+      lightningcss: 1.30.1
+      sass: 1.93.2
+      terser: 5.44.0
+      tsx: 4.20.6
+      yaml: 2.8.1
+
+  vscode-uri@3.1.0: {}
+
+  vue-demi@0.14.10(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      vue: 3.5.22(typescript@5.6.3)
+
+  vue-draggable-plus@0.6.0(@types/sortablejs@1.15.8):
+    dependencies:
+      '@types/sortablejs': 1.15.8
+
+  vue-eslint-parser@9.4.3(eslint@9.36.0(jiti@2.6.0)):
+    dependencies:
+      debug: 4.4.3
+      eslint: 9.36.0(jiti@2.6.0)
+      eslint-scope: 7.2.2
+      eslint-visitor-keys: 3.4.3
+      espree: 9.6.1
+      esquery: 1.6.0
+      lodash: 4.17.21
+      semver: 7.7.2
+    transitivePeerDependencies:
+      - supports-color
+
+  vue-i18n@9.14.5(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      '@intlify/core-base': 9.14.5
+      '@intlify/shared': 9.14.5
+      '@vue/devtools-api': 6.6.4
+      vue: 3.5.22(typescript@5.6.3)
+
+  vue-img-cutter@3.0.7(typescript@5.6.3):
+    dependencies:
+      core-js: 3.45.1
+      vue: 3.5.22(typescript@5.6.3)
+      vue-i18n: 9.14.5(vue@3.5.22(typescript@5.6.3))
+    transitivePeerDependencies:
+      - typescript
+
+  vue-router@4.5.1(vue@3.5.22(typescript@5.6.3)):
+    dependencies:
+      '@vue/devtools-api': 6.6.4
+      vue: 3.5.22(typescript@5.6.3)
+
+  vue-tsc@2.1.10(typescript@5.6.3):
+    dependencies:
+      '@volar/typescript': 2.4.23
+      '@vue/language-core': 2.1.10(typescript@5.6.3)
+      semver: 7.7.2
+      typescript: 5.6.3
+
+  vue@3.5.22(typescript@5.6.3):
+    dependencies:
+      '@vue/compiler-dom': 3.5.22
+      '@vue/compiler-sfc': 3.5.22
+      '@vue/runtime-dom': 3.5.22
+      '@vue/server-renderer': 3.5.22(vue@3.5.22(typescript@5.6.3))
+      '@vue/shared': 3.5.22
+    optionalDependencies:
+      typescript: 5.6.3
+
+  wcwidth@1.0.1:
+    dependencies:
+      defaults: 1.0.4
+
+  webpack-virtual-modules@0.6.2: {}
+
+  which@1.3.1:
+    dependencies:
+      isexe: 2.0.0
+
+  which@2.0.2:
+    dependencies:
+      isexe: 2.0.0
+
+  wildcard@1.1.2: {}
+
+  wmf@1.0.2: {}
+
+  word-wrap@1.2.5: {}
+
+  word@0.3.0: {}
+
+  wrap-ansi@7.0.0:
+    dependencies:
+      ansi-styles: 4.3.0
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+
+  wrap-ansi@9.0.2:
+    dependencies:
+      ansi-styles: 6.2.3
+      string-width: 7.2.0
+      strip-ansi: 7.1.2
+
+  wrappy@1.0.2: {}
+
+  write-file-atomic@5.0.1:
+    dependencies:
+      imurmurhash: 0.1.4
+      signal-exit: 4.1.0
+
+  wsl-utils@0.1.0:
+    dependencies:
+      is-wsl: 3.1.0
+
+  xgplayer-subtitles@3.0.23(core-js@3.45.1):
+    dependencies:
+      core-js: 3.45.1
+      eventemitter3: 4.0.7
+
+  xgplayer@3.0.23(core-js@3.45.1):
+    dependencies:
+      core-js: 3.45.1
+      danmu.js: 1.1.13
+      delegate: 3.2.0
+      downloadjs: 1.4.7
+      eventemitter3: 4.0.7
+      xgplayer-subtitles: 3.0.23(core-js@3.45.1)
+
+  xlsx@0.18.5:
+    dependencies:
+      adler-32: 1.3.1
+      cfb: 1.2.2
+      codepage: 1.15.0
+      crc-32: 1.2.2
+      ssf: 0.11.2
+      wmf: 1.0.2
+      word: 0.3.0
+
+  xml-name-validator@4.0.0: {}
+
+  y18n@5.0.8: {}
+
+  yallist@3.1.1: {}
+
+  yallist@5.0.0: {}
+
+  yaml@2.8.1: {}
+
+  yargs-parser@21.1.1: {}
+
+  yargs@17.7.2:
+    dependencies:
+      cliui: 8.0.1
+      escalade: 3.2.0
+      get-caller-file: 2.0.5
+      require-directory: 2.1.1
+      string-width: 4.2.3
+      y18n: 5.0.8
+      yargs-parser: 21.1.1
+
+  yocto-queue@0.1.0: {}
+
+  yocto-queue@1.2.1: {}
+
+  yoctocolors@2.1.2: {}
+
+  zrender@6.0.0:
+    dependencies:
+      tslib: 2.3.0
diff --git a/web/public/favicon.ico b/web/public/favicon.ico
new file mode 100755
index 0000000..df36fcf
Binary files /dev/null and b/web/public/favicon.ico differ
diff --git a/web/reference-baseline-paths.txt b/web/reference-baseline-paths.txt
new file mode 100644
index 0000000..5efd4ca
--- /dev/null
+++ b/web/reference-baseline-paths.txt
@@ -0,0 +1,23 @@
+# Paths and prefixes that remain reference-derived from references/art-design-pro.
+# These files are tracked separately from Commory-owned web code for line-count governance.
+web/src/assets/styles/
+web/src/components/core/
+web/src/config/
+web/src/directives/
+web/src/enums/
+web/src/hooks/core/
+web/src/locales/
+web/src/router/guards/
+web/src/router/modules/
+web/src/router/routes/
+web/src/store/modules/menu.ts
+web/src/store/modules/setting.ts
+web/src/store/modules/user.ts
+web/src/store/modules/worktab.ts
+web/src/types/
+web/src/utils/constants/links.ts
+web/src/utils/http/
+web/src/utils/storage/
+web/src/utils/sys/
+web/src/views/auth/
+web/src/views/exception/
diff --git a/web/scripts/clean-dev.ts b/web/scripts/clean-dev.ts
new file mode 100644
index 0000000..cc0b9bc
--- /dev/null
+++ b/web/scripts/clean-dev.ts
@@ -0,0 +1,838 @@
+// scripts/clean-dev.ts
+import fs from 'fs/promises'
+import path from 'path'
+
+// 现代化颜色主题
+const theme = {
+  // 基础颜色
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+
+  // 前景色
+  primary: '\x1b[38;5;75m', // 亮蓝色
+  success: '\x1b[38;5;82m', // 亮绿色
+  warning: '\x1b[38;5;220m', // 亮黄色
+  error: '\x1b[38;5;196m', // 亮红色
+  info: '\x1b[38;5;159m', // 青色
+  purple: '\x1b[38;5;141m', // 紫色
+  orange: '\x1b[38;5;208m', // 橙色
+  gray: '\x1b[38;5;245m', // 灰色
+  white: '\x1b[38;5;255m', // 白色
+
+  // 背景色
+  bgDark: '\x1b[48;5;235m', // 深灰背景
+  bgBlue: '\x1b[48;5;24m', // 蓝色背景
+  bgGreen: '\x1b[48;5;22m', // 绿色背景
+  bgRed: '\x1b[48;5;52m' // 红色背景
+}
+
+// 现代化图标集
+const icons = {
+  rocket: '🚀',
+  fire: '🔥',
+  star: '⭐',
+  gem: '💎',
+  crown: '👑',
+  magic: '✨',
+  warning: '⚠️',
+  success: '✅',
+  error: '❌',
+  info: 'ℹ️',
+  folder: '📁',
+  file: '📄',
+  image: '🖼️',
+  code: '💻',
+  data: '📊',
+  globe: '🌐',
+  map: '🗺️',
+  chat: '💬',
+  bolt: '⚡',
+  shield: '🛡️',
+  key: '🔑',
+  link: '🔗',
+  clean: '🧹',
+  trash: '🗑️',
+  check: '✓',
+  cross: '✗',
+  arrow: '→',
+  loading: '⏳'
+}
+
+// 格式化工具
+const fmt = {
+  title: (text: string) => `${theme.bold}${theme.primary}${text}${theme.reset}`,
+  subtitle: (text: string) => `${theme.purple}${text}${theme.reset}`,
+  success: (text: string) => `${theme.success}${text}${theme.reset}`,
+  error: (text: string) => `${theme.error}${text}${theme.reset}`,
+  warning: (text: string) => `${theme.warning}${text}${theme.reset}`,
+  info: (text: string) => `${theme.info}${text}${theme.reset}`,
+  highlight: (text: string) => `${theme.bold}${theme.white}${text}${theme.reset}`,
+  dim: (text: string) => `${theme.dim}${theme.gray}${text}${theme.reset}`,
+  orange: (text: string) => `${theme.orange}${text}${theme.reset}`,
+
+  // 带背景的文本
+  badge: (text: string, bg: string = theme.bgBlue) =>
+    `${bg}${theme.white}${theme.bold} ${text} ${theme.reset}`,
+
+  // 渐变效果模拟
+  gradient: (text: string) => {
+    const colors = ['\x1b[38;5;75m', '\x1b[38;5;81m', '\x1b[38;5;87m', '\x1b[38;5;159m']
+    const chars = text.split('')
+    return chars.map((char, i) => `${colors[i % colors.length]}${char}`).join('') + theme.reset
+  }
+}
+
+// 创建现代化标题横幅
+function createModernBanner() {
+  console.log()
+  console.log(
+    fmt.gradient('  ╔══════════════════════════════════════════════════════════════════╗')
+  )
+  console.log(
+    fmt.gradient('  ║                                                                  ║')
+  )
+  console.log(
+    `  ║               ${icons.rocket} ${fmt.title('ART DESIGN PRO')} ${fmt.subtitle('· 代码精简程序')} ${icons.magic}                ║`
+  )
+  console.log(
+    `  ║               ${fmt.dim('为项目移除演示数据，快速切换至开发模式')}             ║`
+  )
+  console.log(
+    fmt.gradient('  ║                                                                  ║')
+  )
+  console.log(
+    fmt.gradient('  ╚══════════════════════════════════════════════════════════════════╝')
+  )
+  console.log()
+}
+
+// 创建分割线
+function createDivider(char = '─', color = theme.primary) {
+  console.log(`${color}${'  ' + char.repeat(66)}${theme.reset}`)
+}
+
+// 创建卡片样式容器
+function createCard(title: string, content: string[]) {
+  console.log(`  ${fmt.badge('', theme.bgBlue)} ${fmt.title(title)}`)
+  console.log()
+  content.forEach((line) => {
+    console.log(`     ${line}`)
+  })
+  console.log()
+}
+
+// 进度条动画
+function createProgressBar(current: number, total: number, text: string, width = 40) {
+  const percentage = Math.round((current / total) * 100)
+  const filled = Math.round((current / total) * width)
+  const empty = width - filled
+
+  const filledBar = '█'.repeat(filled)
+  const emptyBar = '░'.repeat(empty)
+
+  process.stdout.write(
+    `\r  ${fmt.info('进度')} [${theme.success}${filledBar}${theme.gray}${emptyBar}${theme.reset}] ${fmt.highlight(percentage + '%')})}`
+  )
+
+  if (current === total) {
+    console.log()
+  }
+}
+
+// 统计信息
+const stats = {
+  deletedFiles: 0,
+  deletedPaths: 0,
+  failedPaths: 0,
+  startTime: Date.now(),
+  totalFiles: 0
+}
+
+// 清理目标
+const targets = [
+  'README.md',
+  'README.zh-CN.md',
+  'CHANGELOG.md',
+  'CHANGELOG.zh-CN.md',
+  'src/views/change',
+  'src/views/safeguard',
+  'src/views/article',
+  'src/views/examples',
+  'src/views/system/nested',
+  'src/views/widgets',
+  'src/views/template',
+  'src/views/dashboard/analysis',
+  'src/views/dashboard/ecommerce',
+  'src/mock/json',
+  'src/mock/temp/articleList.ts',
+  'src/mock/temp/commentDetail.ts',
+  'src/mock/temp/commentList.ts',
+  'src/assets/images/cover',
+  'src/assets/images/safeguard',
+  'src/assets/images/3d',
+  'src/components/core/charts/art-map-chart',
+  'src/components/business/comment-widget'
+]
+
+// 递归统计文件数量
+async function countFiles(targetPath: string): Promise<number> {
+  const fullPath = path.resolve(process.cwd(), targetPath)
+
+  try {
+    const stat = await fs.stat(fullPath)
+
+    if (stat.isFile()) {
+      return 1
+    } else if (stat.isDirectory()) {
+      const entries = await fs.readdir(fullPath)
+      let count = 0
+
+      for (const entry of entries) {
+        const entryPath = path.join(targetPath, entry)
+        count += await countFiles(entryPath)
+      }
+
+      return count
+    }
+  } catch {
+    return 0
+  }
+
+  return 0
+}
+
+// 统计所有目标的文件数量
+async function countAllFiles(): Promise<number> {
+  let totalCount = 0
+
+  for (const target of targets) {
+    const count = await countFiles(target)
+    totalCount += count
+  }
+
+  return totalCount
+}
+
+// 删除文件和目录
+async function remove(targetPath: string, index: number) {
+  const fullPath = path.resolve(process.cwd(), targetPath)
+
+  createProgressBar(index + 1, targets.length, targetPath)
+
+  try {
+    const fileCount = await countFiles(targetPath)
+    await fs.rm(fullPath, { recursive: true, force: true })
+    stats.deletedFiles += fileCount
+    stats.deletedPaths++
+    await new Promise((resolve) => setTimeout(resolve, 50))
+  } catch (err) {
+    stats.failedPaths++
+    console.log()
+    console.log(`     ${icons.error} ${fmt.error('删除失败')}: ${fmt.highlight(targetPath)}`)
+    console.log(`     ${fmt.dim('错误详情: ' + err)}`)
+  }
+}
+
+// 清理路由模块
+async function cleanRouteModules() {
+  const modulesPath = path.resolve(process.cwd(), 'src/router/modules')
+
+  try {
+    // 删除演示相关的路由模块
+    const modulesToRemove = [
+      'template.ts',
+      'widgets.ts',
+      'examples.ts',
+      'article.ts',
+      'safeguard.ts',
+      'help.ts'
+    ]
+
+    for (const module of modulesToRemove) {
+      const modulePath = path.join(modulesPath, module)
+      try {
+        await fs.rm(modulePath, { force: true })
+      } catch {
+        // 文件不存在时忽略错误
+      }
+    }
+
+    // 重写 dashboard.ts - 只保留 console
+    const dashboardContent = `import { AppRouteRecord } from '@/types/router'
+
+export const dashboardRoutes: AppRouteRecord = {
+  name: 'Dashboard',
+  path: '/dashboard',
+  component: '/index/index',
+  meta: {
+    title: 'menus.dashboard.title',
+    icon: 'ri:pie-chart-line',
+    roles: ['R_SUPER', 'R_ADMIN']
+  },
+  children: [
+    {
+      path: 'console',
+      name: 'Console',
+      component: '/dashboard/console',
+      meta: {
+        title: 'menus.dashboard.console',
+        keepAlive: false,
+        fixedTab: true
+      }
+    }
+  ]
+}
+`
+    await fs.writeFile(path.join(modulesPath, 'dashboard.ts'), dashboardContent, 'utf-8')
+
+    // 重写 system.ts - 移除 nested 嵌套菜单
+    const systemContent = `import { AppRouteRecord } from '@/types/router'
+
+export const systemRoutes: AppRouteRecord = {
+  path: '/system',
+  name: 'System',
+  component: '/index/index',
+  meta: {
+    title: 'menus.system.title',
+    icon: 'ri:user-3-line',
+    roles: ['R_SUPER', 'R_ADMIN']
+  },
+  children: [
+    {
+      path: 'user',
+      name: 'User',
+      component: '/system/user',
+      meta: {
+        title: 'menus.system.user',
+        keepAlive: true,
+        roles: ['R_SUPER', 'R_ADMIN']
+      }
+    },
+    {
+      path: 'role',
+      name: 'Role',
+      component: '/system/role',
+      meta: {
+        title: 'menus.system.role',
+        keepAlive: true,
+        roles: ['R_SUPER']
+      }
+    },
+    {
+      path: 'user-center',
+      name: 'UserCenter',
+      component: '/system/user-center',
+      meta: {
+        title: 'menus.system.userCenter',
+        isHide: true,
+        keepAlive: true,
+        isHideTab: true
+      }
+    },
+    {
+      path: 'menu',
+      name: 'Menus',
+      component: '/system/menu',
+      meta: {
+        title: 'menus.system.menu',
+        keepAlive: true,
+        roles: ['R_SUPER'],
+        authList: [
+          { title: '新增', authMark: 'add' },
+          { title: '编辑', authMark: 'edit' },
+          { title: '删除', authMark: 'delete' }
+        ]
+      }
+    }
+  ]
+}
+`
+    await fs.writeFile(path.join(modulesPath, 'system.ts'), systemContent, 'utf-8')
+
+    // 重写 index.ts - 只导入保留的模块
+    const indexContent = `import { AppRouteRecord } from '@/types/router'
+import { dashboardRoutes } from './dashboard'
+import { systemRoutes } from './system'
+import { resultRoutes } from './result'
+import { exceptionRoutes } from './exception'
+
+/**
+ * 导出所有模块化路由
+ */
+export const routeModules: AppRouteRecord[] = [
+  dashboardRoutes,
+  systemRoutes,
+  resultRoutes,
+  exceptionRoutes
+]
+`
+    await fs.writeFile(path.join(modulesPath, 'index.ts'), indexContent, 'utf-8')
+
+    console.log(`     ${icons.success} ${fmt.success('清理路由模块完成')}`)
+  } catch (err) {
+    console.log(`     ${icons.error} ${fmt.error('清理路由模块失败')}`)
+    console.log(`     ${fmt.dim('错误详情: ' + err)}`)
+  }
+}
+
+// 清理路由别名
+async function cleanRoutesAlias() {
+  const routesAliasPath = path.resolve(process.cwd(), 'src/router/routesAlias.ts')
+
+  try {
+    const cleanedAlias = `/**
+ * 公共路由别名
+ # 存放系统级公共路由路径，如布局容器、登录页等   
+ */
+export enum RoutesAlias {
+  Layout = '/index/index', // 布局容器
+  Login = '/auth/login' // 登录页
+}
+`
+
+    await fs.writeFile(routesAliasPath, cleanedAlias, 'utf-8')
+    console.log(`     ${icons.success} ${fmt.success('重写路由别名配置完成')}`)
+  } catch (err) {
+    console.log(`     ${icons.error} ${fmt.error('清理路由别名失败')}`)
+    console.log(`     ${fmt.dim('错误详情: ' + err)}`)
+  }
+}
+
+// 清理变更日志
+async function cleanChangeLog() {
+  const changeLogPath = path.resolve(process.cwd(), 'src/mock/upgrade/changeLog.ts')
+
+  try {
+    const cleanedChangeLog = `import { ref } from 'vue'
+
+interface UpgradeLog {
+  version: string // 版本号
+  title: string // 更新标题
+  date: string // 更新日期
+  detail?: string[] // 更新内容
+  requireReLogin?: boolean // 是否需要重新登录
+  remark?: string // 备注
+}
+
+export const upgradeLogList = ref<UpgradeLog[]>([])
+`
+
+    await fs.writeFile(changeLogPath, cleanedChangeLog, 'utf-8')
+    console.log(`     ${icons.success} ${fmt.success('清空变更日志数据完成')}`)
+  } catch (err) {
+    console.log(`     ${icons.error} ${fmt.error('清理变更日志失败')}`)
+    console.log(`     ${fmt.dim('错误详情: ' + err)}`)
+  }
+}
+
+// 清理语言文件
+async function cleanLanguageFiles() {
+  const languageFiles = [
+    { path: 'src/locales/langs/zh.json', name: '中文语言文件' },
+    { path: 'src/locales/langs/en.json', name: '英文语言文件' }
+  ]
+
+  for (const { path: langPath, name } of languageFiles) {
+    try {
+      const fullPath = path.resolve(process.cwd(), langPath)
+      const content = await fs.readFile(fullPath, 'utf-8')
+      const langData = JSON.parse(content)
+
+      const menusToRemove = [
+        'widgets',
+        'template',
+        'article',
+        'examples',
+        'safeguard',
+        'plan',
+        'help'
+      ]
+
+      if (langData.menus) {
+        menusToRemove.forEach((menuKey) => {
+          if (langData.menus[menuKey]) {
+            delete langData.menus[menuKey]
+          }
+        })
+
+        if (langData.menus.dashboard) {
+          if (langData.menus.dashboard.analysis) {
+            delete langData.menus.dashboard.analysis
+          }
+          if (langData.menus.dashboard.ecommerce) {
+            delete langData.menus.dashboard.ecommerce
+          }
+        }
+
+        if (langData.menus.system) {
+          const systemKeysToRemove = [
+            'nested',
+            'menu1',
+            'menu2',
+            'menu21',
+            'menu3',
+            'menu31',
+            'menu32',
+            'menu321'
+          ]
+          systemKeysToRemove.forEach((key) => {
+            if (langData.menus.system[key]) {
+              delete langData.menus.system[key]
+            }
+          })
+        }
+      }
+
+      await fs.writeFile(fullPath, JSON.stringify(langData, null, 2), 'utf-8')
+      console.log(`     ${icons.success} ${fmt.success(`清理${name}完成`)}`)
+    } catch (err) {
+      console.log(`     ${icons.error} ${fmt.error(`清理${name}失败`)}`)
+      console.log(`     ${fmt.dim('错误详情: ' + err)}`)
+    }
+  }
+}
+
+// 清理快速入口组件
+async function cleanFastEnterComponent() {
+  const fastEnterPath = path.resolve(process.cwd(), 'src/config/fastEnter.ts')
+
+  try {
+    const cleanedFastEnter = `/**
+ * 快速入口配置
+ * 包含：应用列表、快速链接等配置
+ */
+import { WEB_LINKS } from '@/utils/constants'
+import type { FastEnterConfig } from '@/types/config'
+
+const fastEnterConfig: FastEnterConfig = {
+  // 显示条件（屏幕宽度）
+  minWidth: 1200,
+  // 应用列表
+  applications: [
+    {
+      name: '工作台',
+      description: '系统概览与数据统计',
+      icon: 'ri:pie-chart-line',
+      iconColor: '#377dff',
+      enabled: true,
+      order: 1,
+      routeName: 'Console'
+    },
+    {
+      name: '官方文档',
+      description: '使用指南与开发文档',
+      icon: 'ri:bill-line',
+      iconColor: '#ffb100',
+      enabled: true,
+      order: 2,
+      link: WEB_LINKS.DOCS
+    },
+    {
+      name: '技术支持',
+      description: '技术支持与问题反馈',
+      icon: 'ri:user-location-line',
+      iconColor: '#ff6b6b',
+      enabled: true,
+      order: 3,
+      link: WEB_LINKS.COMMUNITY
+    },
+    {
+      name: '哔哩哔哩',
+      description: '技术分享与交流',
+      icon: 'ri:bilibili-line',
+      iconColor: '#FB7299',
+      enabled: true,
+      order: 4,
+      link: WEB_LINKS.BILIBILI
+    }
+  ],
+  // 快速链接
+  quickLinks: [
+    {
+      name: '登录',
+      enabled: true,
+      order: 1,
+      routeName: 'Login'
+    },
+    {
+      name: '注册',
+      enabled: true,
+      order: 2,
+      routeName: 'Register'
+    },
+    {
+      name: '忘记密码',
+      enabled: true,
+      order: 3,
+      routeName: 'ForgetPassword'
+    },
+    {
+      name: '个人中心',
+      enabled: true,
+      order: 4,
+      routeName: 'UserCenter'
+    }
+  ]
+}
+
+export default Object.freeze(fastEnterConfig)
+`
+
+    await fs.writeFile(fastEnterPath, cleanedFastEnter, 'utf-8')
+    console.log(`     ${icons.success} ${fmt.success('清理快速入口配置完成')}`)
+  } catch (err) {
+    console.log(`     ${icons.error} ${fmt.error('清理快速入口配置失败')}`)
+    console.log(`     ${fmt.dim('错误详情: ' + err)}`)
+  }
+}
+
+// 更新菜单接口
+async function updateMenuApi() {
+  const apiPath = path.resolve(process.cwd(), 'src/api/system-manage.ts')
+
+  try {
+    const content = await fs.readFile(apiPath, 'utf-8')
+    const updatedContent = content.replace(
+      "url: '/api/v3/system/menus'",
+      "url: '/api/v3/system/menus/simple'"
+    )
+
+    await fs.writeFile(apiPath, updatedContent, 'utf-8')
+    console.log(`     ${icons.success} ${fmt.success('更新菜单接口完成')}`)
+  } catch (err) {
+    console.log(`     ${icons.error} ${fmt.error('更新菜单接口失败')}`)
+    console.log(`     ${fmt.dim('错误详情: ' + err)}`)
+  }
+}
+
+// 用户确认函数
+async function getUserConfirmation(): Promise<boolean> {
+  const { createInterface } = await import('readline')
+
+  return new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+
+    console.log(
+      `  ${fmt.highlight('请输入')} ${fmt.success('yes')} ${fmt.highlight('确认执行清理操作，或按 Enter 取消')}`
+    )
+    console.log()
+    process.stdout.write(`  ${icons.arrow} `)
+
+    rl.question('', (answer: string) => {
+      rl.close()
+      resolve(answer.toLowerCase().trim() === 'yes')
+    })
+  })
+}
+
+// 显示清理警告
+async function showCleanupWarning() {
+  createCard('安全警告', [
+    `${fmt.warning('此操作将永久删除以下演示内容，且无法恢复！')}`,
+    `${fmt.dim('请仔细阅读清理列表，确认后再继续操作')}`
+  ])
+
+  const cleanupItems = [
+    {
+      icon: icons.image,
+      name: '图片资源',
+      desc: '演示用的封面图片、3D图片、运维图片等',
+      color: theme.orange
+    },
+    {
+      icon: icons.file,
+      name: '演示页面',
+      desc: 'widgets、template、article、examples、safeguard等页面',
+      color: theme.purple
+    },
+    {
+      icon: icons.code,
+      name: '路由模块文件',
+      desc: '删除演示路由模块，只保留核心模块（dashboard、system、result、exception）',
+      color: theme.primary
+    },
+    {
+      icon: icons.link,
+      name: '路由别名',
+      desc: '重写routesAlias.ts，移除演示路由别名',
+      color: theme.info
+    },
+    {
+      icon: icons.data,
+      name: 'Mock数据',
+      desc: '演示用的JSON数据、文章列表、评论数据等',
+      color: theme.success
+    },
+    {
+      icon: icons.globe,
+      name: '多语言文件',
+      desc: '清理中英文语言包中的演示菜单项',
+      color: theme.warning
+    },
+    { icon: icons.map, name: '地图组件', desc: '移除art-map-chart地图组件', color: theme.error },
+    { icon: icons.chat, name: '评论组件', desc: '移除comment-widget评论组件', color: theme.orange },
+    {
+      icon: icons.bolt,
+      name: '快速入口',
+      desc: '移除分析页、礼花效果、聊天、更新日志、定价、留言管理等无效项目',
+      color: theme.purple
+    }
+  ]
+
+  console.log(`  ${fmt.badge('', theme.bgRed)} ${fmt.title('将要清理的内容')}`)
+  console.log()
+
+  cleanupItems.forEach((item, index) => {
+    console.log(`     ${item.color}${theme.reset} ${fmt.highlight(`${index + 1}. ${item.name}`)}`)
+    console.log(`        ${fmt.dim(item.desc)}`)
+  })
+
+  console.log()
+  console.log(`  ${fmt.badge('', theme.bgGreen)} ${fmt.title('保留的功能模块')}`)
+  console.log()
+
+  const preservedModules = [
+    { name: 'Dashboard', desc: '工作台页面' },
+    { name: 'System', desc: '系统管理模块' },
+    { name: 'Result', desc: '结果页面' },
+    { name: 'Exception', desc: '异常页面' },
+    { name: 'Auth', desc: '登录注册功能' },
+    { name: 'Core Components', desc: '核心组件库' }
+  ]
+
+  preservedModules.forEach((module) => {
+    console.log(`     ${icons.check} ${fmt.success(module.name)} ${fmt.dim(`- ${module.desc}`)}`)
+  })
+
+  console.log()
+  createDivider()
+  console.log()
+}
+
+// 显示统计信息
+async function showStats() {
+  const duration = Date.now() - stats.startTime
+  const seconds = (duration / 1000).toFixed(2)
+
+  console.log()
+  createCard('清理统计', [
+    `${fmt.success('成功删除')}: ${fmt.highlight(stats.deletedFiles.toString())} 个文件`,
+    `${fmt.info('涉及路径')}: ${fmt.highlight(stats.deletedPaths.toString())} 个目录/文件`,
+    ...(stats.failedPaths > 0
+      ? [
+          `${icons.error} ${fmt.error('删除失败')}: ${fmt.highlight(stats.failedPaths.toString())} 个路径`
+        ]
+      : []),
+    `${fmt.info('耗时')}: ${fmt.highlight(seconds)} 秒`
+  ])
+}
+
+// 创建成功横幅
+function createSuccessBanner() {
+  console.log()
+  console.log(
+    fmt.gradient('  ╔══════════════════════════════════════════════════════════════════╗')
+  )
+  console.log(
+    fmt.gradient('  ║                                                                  ║')
+  )
+  console.log(
+    `  ║                  ${icons.star} ${fmt.success('清理完成！项目已准备就绪')} ${icons.rocket}                  ║`
+  )
+  console.log(
+    `  ║                    ${fmt.dim('现在可以开始您的开发之旅了！')}                  ║`
+  )
+  console.log(
+    fmt.gradient('  ║                                                                  ║')
+  )
+  console.log(
+    fmt.gradient('  ╚══════════════════════════════════════════════════════════════════╝')
+  )
+  console.log()
+}
+
+// 主函数
+async function main() {
+  // 清屏并显示横幅
+  console.clear()
+  createModernBanner()
+
+  // 显示清理警告
+  await showCleanupWarning()
+
+  // 统计文件数量
+  console.log(`  ${fmt.info('正在统计文件数量...')}`)
+  stats.totalFiles = await countAllFiles()
+
+  console.log(`  ${fmt.info('即将清理')}: ${fmt.highlight(stats.totalFiles.toString())} 个文件`)
+  console.log(`  ${fmt.dim(`涉及 ${targets.length} 个目录/文件路径`)}`)
+  console.log()
+
+  // 用户确认
+  const confirmed = await getUserConfirmation()
+
+  if (!confirmed) {
+    console.log(`  ${fmt.warning('操作已取消，清理中止')}`)
+    console.log()
+    return
+  }
+
+  console.log()
+  console.log(`  ${icons.check} ${fmt.success('确认成功，开始清理...')}`)
+  console.log()
+
+  // 开始清理过程
+  console.log(`  ${fmt.badge('步骤 1/6', theme.bgBlue)} ${fmt.title('删除演示文件')}`)
+  console.log()
+  for (let i = 0; i < targets.length; i++) {
+    await remove(targets[i], i)
+  }
+  console.log()
+
+  console.log(`  ${fmt.badge('步骤 2/6', theme.bgBlue)} ${fmt.title('清理路由模块')}`)
+  console.log()
+  await cleanRouteModules()
+  console.log()
+
+  console.log(`  ${fmt.badge('步骤 3/6', theme.bgBlue)} ${fmt.title('重写路由别名')}`)
+  console.log()
+  await cleanRoutesAlias()
+  console.log()
+
+  console.log(`  ${fmt.badge('步骤 4/6', theme.bgBlue)} ${fmt.title('清空变更日志')}`)
+  console.log()
+  await cleanChangeLog()
+  console.log()
+
+  console.log(`  ${fmt.badge('步骤 5/6', theme.bgBlue)} ${fmt.title('清理语言文件')}`)
+  console.log()
+  await cleanLanguageFiles()
+  console.log()
+
+  console.log(`  ${fmt.badge('步骤 6/7', theme.bgBlue)} ${fmt.title('清理快速入口')}`)
+  console.log()
+  await cleanFastEnterComponent()
+  console.log()
+
+  console.log(`  ${fmt.badge('步骤 7/7', theme.bgBlue)} ${fmt.title('更新菜单接口')}`)
+  console.log()
+  await updateMenuApi()
+
+  // 显示统计信息
+  await showStats()
+
+  // 显示成功横幅
+  createSuccessBanner()
+}
+
+main().catch((err) => {
+  console.log()
+  console.log(`  ${icons.error} ${fmt.error('清理脚本执行出错')}`)
+  console.log(`  ${fmt.dim('错误详情: ' + err)}`)
+  console.log()
+  process.exit(1)
+})
diff --git a/web/src/App.vue b/web/src/App.vue
new file mode 100755
index 0000000..d941a48
--- /dev/null
+++ b/web/src/App.vue
@@ -0,0 +1,41 @@
+<template>
+  <ElConfigProvider
+    size="default"
+    :locale="locales[language]"
+    :z-index="3000"
+    :card="{
+      shadow: 'never'
+    }"
+  >
+    <RouterView></RouterView>
+  </ElConfigProvider>
+</template>
+
+<script setup lang="ts">
+  import { useUserStore } from './store/modules/user'
+  import zh from 'element-plus/es/locale/lang/zh-cn'
+  import en from 'element-plus/es/locale/lang/en'
+  import { systemUpgrade } from './utils/sys'
+  import { toggleTransition } from './utils/ui/animation'
+  import { checkStorageCompatibility } from './utils/storage'
+  import { initializeTheme } from './hooks/core/useTheme'
+
+  const userStore = useUserStore()
+  const { language } = storeToRefs(userStore)
+
+  const locales = {
+    zh: zh,
+    en: en
+  }
+
+  onBeforeMount(() => {
+    toggleTransition(true)
+    initializeTheme()
+  })
+
+  onMounted(() => {
+    checkStorageCompatibility()
+    toggleTransition(false)
+    systemUpgrade()
+  })
+</script>
diff --git a/web/src/api/auth.ts b/web/src/api/auth.ts
new file mode 100644
index 0000000..2726d4a
--- /dev/null
+++ b/web/src/api/auth.ts
@@ -0,0 +1,39 @@
+import request from '@/utils/http'
+
+/**
+ * 登录
+ * @param params 登录参数
+ * @returns 登录响应
+ */
+export function fetchLogin(params: Api.Auth.LoginParams) {
+  return request.post<Api.Auth.LoginResponse>({
+    url: '/api/auth/login',
+    params
+    // showSuccessMessage: true // 显示成功消息
+    // showErrorMessage: false // 不显示错误消息
+  })
+}
+
+export function fetchRegister(params: Api.Auth.RegisterParams) {
+  return request.post<Api.Auth.LoginResponse>({
+    url: '/api/auth/register',
+    params
+  })
+}
+
+/**
+ * 获取用户信息
+ * @returns 用户信息
+ */
+export function fetchGetUserInfo() {
+  return request.get<Api.Auth.UserInfo>({
+    url: '/api/user/info'
+  })
+}
+
+export function fetchLogout() {
+  return request.post<{ success: boolean }>({
+    url: '/api/auth/logout',
+    showErrorMessage: false
+  })
+}
diff --git a/web/src/api/commory.ts b/web/src/api/commory.ts
new file mode 100644
index 0000000..f4409ce
--- /dev/null
+++ b/web/src/api/commory.ts
@@ -0,0 +1,82 @@
+import request from '@/utils/http'
+import { axiosInstance } from '@/utils/http'
+
+export function fetchDashboardSummary() {
+  return request.get<Api.Commory.DashboardSummary>({
+    url: '/api/dashboard'
+  })
+}
+
+export function fetchTimeline(params: Api.Commory.SearchParams = {}) {
+  return request.get<Api.Commory.TimelineItem[]>({
+    url: '/api/timeline',
+    params
+  })
+}
+
+export function fetchSearch(params: Api.Commory.SearchParams = {}) {
+  return request.get<Api.Commory.TimelineItem[]>({
+    url: '/api/search',
+    params
+  })
+}
+
+export function fetchIdentities() {
+  return request.get<Api.Commory.Identity[]>({
+    url: '/api/identities'
+  })
+}
+
+export function fetchIdentity(id: string) {
+  return request.get<Api.Commory.Identity>({
+    url: `/api/identities/${id}`
+  })
+}
+
+export function fetchThread(id: string) {
+  return request.get<Api.Commory.TimelineItem[]>({
+    url: `/api/threads/${id}`
+  })
+}
+
+export function fetchImports() {
+  return request.get<Api.Commory.ImportSummary[]>({
+    url: '/api/imports'
+  })
+}
+
+export function uploadImport(file: File) {
+  const formData = new FormData()
+  formData.append('file', file)
+  return request.post<{ import_id: string; msglayer_version: string }>({
+    url: '/api/imports/upload',
+    data: formData
+  })
+}
+
+export function validateImport(file: File) {
+  const formData = new FormData()
+  formData.append('file', file)
+  return request.post<{ valid: boolean }>({
+    url: '/api/validate/upload',
+    data: formData
+  })
+}
+
+export function exportImportUrl(importId: string) {
+  return `/api/imports/${importId}/export`
+}
+
+export async function downloadImport(importId: string) {
+  const response = await axiosInstance.get(exportImportUrl(importId), {
+    responseType: 'blob'
+  })
+  const href = URL.createObjectURL(response.data)
+  const link = document.createElement('a')
+  link.href = href
+  link.download = `${importId}.json`
+  document.body.appendChild(link)
+  link.click()
+  link.remove()
+  URL.revokeObjectURL(href)
+}
diff --git a/web/src/api/setup.ts b/web/src/api/setup.ts
new file mode 100644
index 0000000..5292c46
--- /dev/null
+++ b/web/src/api/setup.ts
@@ -0,0 +1,15 @@
+import request from '@/utils/http'
+
+export function fetchSetupStatus() {
+  return request.get<Api.Setup.SetupStatus>({
+    url: '/api/setup',
+    showErrorMessage: false
+  })
+}
+
+export function postSetup(data: Api.Setup.SetupRequest) {
+  return request.post<{ success: boolean }>({
+    url: '/api/setup',
+    params: data
+  })
+}
diff --git a/web/src/api/system-manage.ts b/web/src/api/system-manage.ts
new file mode 100644
index 0000000..8f4a8e6
--- /dev/null
+++ b/web/src/api/system-manage.ts
@@ -0,0 +1,25 @@
+import request from '@/utils/http'
+import { AppRouteRecord } from '@/types/router'
+
+// 获取用户列表
+export function fetchGetUserList(params: Api.SystemManage.UserSearchParams) {
+  return request.get<Api.SystemManage.UserList>({
+    url: '/api/user/list',
+    params
+  })
+}
+
+// 获取角色列表
+export function fetchGetRoleList(params: Api.SystemManage.RoleSearchParams) {
+  return request.get<Api.SystemManage.RoleList>({
+    url: '/api/role/list',
+    params
+  })
+}
+
+// 获取菜单列表
+export function fetchGetMenuList() {
+  return request.get<AppRouteRecord[]>({
+    url: '/api/v3/system/menus/simple'
+  })
+}
diff --git a/web/src/assets/images/avatar/avatar.webp b/web/src/assets/images/avatar/avatar.webp
new file mode 100644
index 0000000..bea307b
Binary files /dev/null and b/web/src/assets/images/avatar/avatar.webp differ
diff --git a/web/src/assets/images/avatar/avatar1.webp b/web/src/assets/images/avatar/avatar1.webp
new file mode 100644
index 0000000..68e256c
Binary files /dev/null and b/web/src/assets/images/avatar/avatar1.webp differ
diff --git a/web/src/assets/images/avatar/avatar10.webp b/web/src/assets/images/avatar/avatar10.webp
new file mode 100644
index 0000000..a813d4c
Binary files /dev/null and b/web/src/assets/images/avatar/avatar10.webp differ
diff --git a/web/src/assets/images/avatar/avatar2.webp b/web/src/assets/images/avatar/avatar2.webp
new file mode 100644
index 0000000..6716e3f
Binary files /dev/null and b/web/src/assets/images/avatar/avatar2.webp differ
diff --git a/web/src/assets/images/avatar/avatar3.webp b/web/src/assets/images/avatar/avatar3.webp
new file mode 100644
index 0000000..7355ad4
Binary files /dev/null and b/web/src/assets/images/avatar/avatar3.webp differ
diff --git a/web/src/assets/images/avatar/avatar4.webp b/web/src/assets/images/avatar/avatar4.webp
new file mode 100644
index 0000000..56a9549
Binary files /dev/null and b/web/src/assets/images/avatar/avatar4.webp differ
diff --git a/web/src/assets/images/avatar/avatar5.webp b/web/src/assets/images/avatar/avatar5.webp
new file mode 100644
index 0000000..f78400c
Binary files /dev/null and b/web/src/assets/images/avatar/avatar5.webp differ
diff --git a/web/src/assets/images/avatar/avatar6.webp b/web/src/assets/images/avatar/avatar6.webp
new file mode 100644
index 0000000..9771b78
Binary files /dev/null and b/web/src/assets/images/avatar/avatar6.webp differ
diff --git a/web/src/assets/images/avatar/avatar7.webp b/web/src/assets/images/avatar/avatar7.webp
new file mode 100644
index 0000000..e5ef6fe
Binary files /dev/null and b/web/src/assets/images/avatar/avatar7.webp differ
diff --git a/web/src/assets/images/avatar/avatar8.webp b/web/src/assets/images/avatar/avatar8.webp
new file mode 100644
index 0000000..b66e48f
Binary files /dev/null and b/web/src/assets/images/avatar/avatar8.webp differ
diff --git a/web/src/assets/images/avatar/avatar9.webp b/web/src/assets/images/avatar/avatar9.webp
new file mode 100644
index 0000000..7974139
Binary files /dev/null and b/web/src/assets/images/avatar/avatar9.webp differ
diff --git a/web/src/assets/images/ceremony/hb.png b/web/src/assets/images/ceremony/hb.png
new file mode 100644
index 0000000..4103324
Binary files /dev/null and b/web/src/assets/images/ceremony/hb.png differ
diff --git a/web/src/assets/images/ceremony/sd.png b/web/src/assets/images/ceremony/sd.png
new file mode 100644
index 0000000..75ec838
Binary files /dev/null and b/web/src/assets/images/ceremony/sd.png differ
diff --git a/web/src/assets/images/ceremony/xc.png b/web/src/assets/images/ceremony/xc.png
new file mode 100644
index 0000000..9c7ab67
Binary files /dev/null and b/web/src/assets/images/ceremony/xc.png differ
diff --git a/web/src/assets/images/ceremony/yd.png b/web/src/assets/images/ceremony/yd.png
new file mode 100644
index 0000000..426912d
Binary files /dev/null and b/web/src/assets/images/ceremony/yd.png differ
diff --git a/web/src/assets/images/common/logo.webp b/web/src/assets/images/common/logo.webp
new file mode 100644
index 0000000..71542b5
Binary files /dev/null and b/web/src/assets/images/common/logo.webp differ
diff --git a/web/src/assets/images/draw/draw1.png b/web/src/assets/images/draw/draw1.png
new file mode 100644
index 0000000..da5d87a
Binary files /dev/null and b/web/src/assets/images/draw/draw1.png differ
diff --git a/web/src/assets/images/favicon.ico b/web/src/assets/images/favicon.ico
new file mode 100644
index 0000000..21e7063
Binary files /dev/null and b/web/src/assets/images/favicon.ico differ
diff --git a/web/src/assets/images/lock/bg_dark.webp b/web/src/assets/images/lock/bg_dark.webp
new file mode 100644
index 0000000..1c33435
Binary files /dev/null and b/web/src/assets/images/lock/bg_dark.webp differ
diff --git a/web/src/assets/images/lock/bg_light.webp b/web/src/assets/images/lock/bg_light.webp
new file mode 100644
index 0000000..00efbd9
Binary files /dev/null and b/web/src/assets/images/lock/bg_light.webp differ
diff --git a/web/src/assets/images/login/lf_icon2.webp b/web/src/assets/images/login/lf_icon2.webp
new file mode 100644
index 0000000..5e4f3fd
Binary files /dev/null and b/web/src/assets/images/login/lf_icon2.webp differ
diff --git a/web/src/assets/images/settings/menu_layouts/dual_column.png b/web/src/assets/images/settings/menu_layouts/dual_column.png
new file mode 100644
index 0000000..9b868ca
Binary files /dev/null and b/web/src/assets/images/settings/menu_layouts/dual_column.png differ
diff --git a/web/src/assets/images/settings/menu_layouts/horizontal.png b/web/src/assets/images/settings/menu_layouts/horizontal.png
new file mode 100644
index 0000000..ca779bc
Binary files /dev/null and b/web/src/assets/images/settings/menu_layouts/horizontal.png differ
diff --git a/web/src/assets/images/settings/menu_layouts/mixed.png b/web/src/assets/images/settings/menu_layouts/mixed.png
new file mode 100644
index 0000000..c82b580
Binary files /dev/null and b/web/src/assets/images/settings/menu_layouts/mixed.png differ
diff --git a/web/src/assets/images/settings/menu_layouts/vertical.png b/web/src/assets/images/settings/menu_layouts/vertical.png
new file mode 100644
index 0000000..16e942b
Binary files /dev/null and b/web/src/assets/images/settings/menu_layouts/vertical.png differ
diff --git a/web/src/assets/images/settings/menu_styles/dark.png b/web/src/assets/images/settings/menu_styles/dark.png
new file mode 100644
index 0000000..e1653b7
Binary files /dev/null and b/web/src/assets/images/settings/menu_styles/dark.png differ
diff --git a/web/src/assets/images/settings/menu_styles/design.png b/web/src/assets/images/settings/menu_styles/design.png
new file mode 100644
index 0000000..7681aa8
Binary files /dev/null and b/web/src/assets/images/settings/menu_styles/design.png differ
diff --git a/web/src/assets/images/settings/menu_styles/light.png b/web/src/assets/images/settings/menu_styles/light.png
new file mode 100644
index 0000000..3007b99
Binary files /dev/null and b/web/src/assets/images/settings/menu_styles/light.png differ
diff --git a/web/src/assets/images/settings/theme_styles/dark.png b/web/src/assets/images/settings/theme_styles/dark.png
new file mode 100644
index 0000000..e8c6e44
Binary files /dev/null and b/web/src/assets/images/settings/theme_styles/dark.png differ
diff --git a/web/src/assets/images/settings/theme_styles/light.png b/web/src/assets/images/settings/theme_styles/light.png
new file mode 100644
index 0000000..6754238
Binary files /dev/null and b/web/src/assets/images/settings/theme_styles/light.png differ
diff --git a/web/src/assets/images/settings/theme_styles/system.png b/web/src/assets/images/settings/theme_styles/system.png
new file mode 100644
index 0000000..6a6baa9
Binary files /dev/null and b/web/src/assets/images/settings/theme_styles/system.png differ
diff --git a/web/src/assets/images/svg/403.svg b/web/src/assets/images/svg/403.svg
new file mode 100644
index 0000000..68790ad
--- /dev/null
+++ b/web/src/assets/images/svg/403.svg
@@ -0,0 +1 @@
+<svg viewBox="0 0 400 300" fill="none" xmlns="http://www.w3.org/2000/svg"><mask id="a" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="94" y="34" width="212" height="233"><path d="M306 34H94v233h212V34Z" fill="#fff"/></mask><g mask="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M234.427 155.64h38.36V69.6h-38.36v86.04ZM113.326 155.64h121.1V69.6h-121.1v86.04Z" fill="#fff"/><path fill-rule="evenodd" clip-rule="evenodd" d="M130.126 155.354h104.2v-72.95h-104.2v72.95ZM236.369 71.05s0 3.3 1.65 5.05c2.33 2.52 7.38-.2 7.38-.2s-1.75 5.15-1.55 10.19c.29 8.24 6.99 9.51 10 4.75 4.56 4.85 8.94-.29 9.52-2.62 4.27 4.76 9.32-.87 9.32-.87v-6.3l-23.99-12.13-12.33 2.13Z" fill="#C7DEFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M234.429 155.641h-121.1l-15.93 32.11h121.1l15.93-32.11Z" fill="#fff"/><path d="M234.427 69.6h38.46v86.04M113.326 146.52V69.6h121.1M234.429 155.641l-15.93 32.11h-121.1l15.93-32.11h111.39" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M226.37 159.715H116.82l-12.04 23.86H215l11.37-23.86Z" fill="#006EFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="m288.807 187.751-15.92-32.11h-38.46l16.02 32.11h38.36Z" fill="#fff"/><path d="m238.607 163.981 11.84 23.77h38.36l-15.92-32.11h-38.46" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M207.336 223.734c-3.69-13.77-15.44-23.86-29.33-23.86h-8.65s-27.09 14.94-27.09 33.27c0 18.34 25.44 33.18 25.44 33.18h10.4c13.79-.1 25.44-10.19 29.13-23.87 1.75-12.51 0-18.62.1-18.72Z" fill="#C7DEFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M243.459 240.421c3.98 0 7.28-3.3 7.28-7.27 0-3.98-3.3-7.28-7.28-7.28h-31.08c-3.98 0-7.28 3.3-7.28 7.28 0 3.97 3.3 7.27 7.28 7.27h31.08Z" fill="#C7DEFF"/><path d="M210.342 223.737c-4.08-13.87-16.9-23.96-32.05-23.96H168.972s-29.62 14.94-29.62 33.37 27.87 33.37 27.87 33.37h11.27c15.05-.1 27.77-10.19 31.75-23.96" stroke="#071F4D"/><path d="M212.379 240.421c-3.98 0-7.28-3.3-7.28-7.27m0 0c0-3.98 3.3-7.28 7.28-7.28" stroke="#fff"/><path fill-rule="evenodd" clip-rule="evenodd" d="M168.781 199.777c-18.45 0-33.41 14.94-33.41 33.37s14.96 33.37 33.41 33.37c18.45 0 33.4-14.94 33.4-33.37s-14.95-33.37-33.4-33.37Z" fill="#006EFF"/><path d="M168.781 199.777c-18.45 0-33.41 14.94-33.41 33.37s14.96 33.37 33.41 33.37c18.45 0 33.4-14.94 33.4-33.37s-14.95-33.37-33.4-33.37Z" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M168.775 209.38c-13.14 0-23.79 10.64-23.79 23.77 0 13.12 10.65 23.76 23.79 23.76 13.14 0 23.8-10.64 23.8-23.76 0-13.13-10.66-23.77-23.8-23.77Z" fill="#00E4E5"/><path d="M162.174 223.736a17.48 17.48 0 0 1 14.76-8.05M159.455 231.982c.1-1.36.29-2.62.68-3.88" stroke="#fff"/><path fill-rule="evenodd" clip-rule="evenodd" d="M173.535 209.87c-1.55-.3-3.11-.49-4.76-.49-13.11 0-23.79 10.67-23.79 23.77 0 13.09 10.68 23.76 23.79 23.76 1.65 0 3.21-.19 4.76-.48-10.88-2.23-19.03-11.84-19.03-23.28 0-11.45 8.15-21.05 19.03-23.28Z" fill="#071F4D"/><path d="M219.957 225.774h23.6c4.08 0 7.38 3.3 7.38 7.37m0 0c0 4.08-3.3 7.37-7.38 7.37h-20.1M212.091 225.774h3.3" stroke="#071F4D"/><path d="m248.894 34.485-.19 18.24c0 4.07-.39 5.23-2.14 6.79-8.15 6.88-10.97 9.02-9.22 12.9 1.45 3.2 6.79 2.23 9.61-1.55-.39 4.56-5.24 15.32-.58 18.04 4.37 2.52 6.89-3.49 6.89-3.49s.49 3.49 4.47 3.49c3.69 0 5.24-4.75 5.24-4.75s2.14 3.49 6.22 1.35c3.11-1.55 5.44-7.08 5.44-26.67v-24.35" fill="#fff"/><path d="m248.894 34.485-.19 18.24c0 4.07-.39 5.23-2.14 6.79-8.15 6.88-10.97 9.02-9.22 12.9 1.45 3.2 6.79 2.23 9.61-1.55-.39 4.56-5.24 15.32-.58 18.04 4.37 2.52 6.89-3.49 6.89-3.49s.49 3.49 4.47 3.49c3.69 0 5.24-4.75 5.24-4.75s2.14 3.49 6.22 1.35c3.11-1.55 5.44-7.08 5.44-26.67v-24.35" stroke="#071F4D"/><path d="M255.307 75.71s-.39 5.43-2.04 9.6l2.04-9.6Z" fill="#fff"/><path d="M255.307 75.71s-.39 5.43-2.04 9.6" stroke="#071F4D"/><path d="M264.921 75.323s-.68 5.24-2.04 8.63l2.04-8.63Z" fill="#fff"/><path d="M264.921 75.323s-.68 5.24-2.04 8.63M147.801 34.485v34.92M121.775 34.485v34.92M102.546 204.724v13.97M102.546 222.379v.87M102.546 197.934v3.49M115.268 206.955v26.29M115.268 239.451v5.34M244.43 197.643v11.93M244.43 213.939v3.49M270.359 201.232v33.76M115.369 47.774h-13.6M94.486 47.774h3.4M241.516 47.774h-84.1M280.168 47.774h25.35" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="m282.497 183.575-12.04-23.86h-27.29l11.36 23.86h27.97Z" fill="#00E4E5"/><path d="M234.427 134.88V69.6M234.427 140.412v7.66" stroke="#071F4D"/><path d="M220.831 228.684h16.99M240.934 228.684h2.43" stroke="#fff"/><path fill-rule="evenodd" clip-rule="evenodd" d="m223.842 187.462 21.46-.2-10.97-20.66-10.49 20.86Z" fill="#071F4D"/></g></svg>
\ No newline at end of file
diff --git a/web/src/assets/images/svg/404.svg b/web/src/assets/images/svg/404.svg
new file mode 100644
index 0000000..48e1ca3
--- /dev/null
+++ b/web/src/assets/images/svg/404.svg
@@ -0,0 +1 @@
+<svg viewBox="0 0 400 300" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill-rule="evenodd" clip-rule="evenodd" d="M290.7 38.4h-50.3v63.5h50.3V38.4Zm-16 47.5V54.4h-18.3v31.5h18.3ZM199 71.3V38.7h-16v48.6h32v14.6h16V38.7h-16v32.6h-16ZM331.7 87.3v14.6h16V38.7h-16v32.6h-16V38.7h-16v48.6h32Z" fill="#DEEBFC"/><path d="M324.3 119.5h24.1v-17.4h-24.1" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M218.5 120H69.4v11.5h130.5l18.6-11.5ZM231.5 131.5h117.2V120H231.5v11.5Z" fill="#C7DEFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M348.4 119.5v-17.4h-24.1v17.4h24.1Z" fill="#071F4D"/><path d="M159.6 119.5h164.9V102H169.2M114.8 102H57.9v17.5h39.6" stroke="#071F4D"/><path d="M242.5 223.2V98.7c0-3.6 2.9-6.6 6.6-6.6m0 0c3.6 0 6.6 2.9 6.6 6.6v2.8M243.1 153.9h53.1M243.1 193.9h53.1M296.5 219.1V98.8c0-3.6 2.9-6.6 6.6-6.6 3.6 0 6.6 2.9 6.6 6.6v2.8" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="m140.5 96.4 15.9 12.9 6.6-9.4-12.2-11.2-8.2 5.8-2.1 1.9Z" fill="#C7DEFF"/><path d="m170.2 93.5-4.2 4-3-2.4" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M150.2 87.1s3.7-5.3 8.1-3.9c2.7.8 1.7-1.6 1.7-1.6l-9.2-5.6-3.9 8.5 3.3 2.6Z" fill="#C7DEFF"/><path d="m148 85.5 13 12.1" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M179.202 87.001c.9-.1 1.7-.6 2.3-1.4.6-.6.9-1.4.8-1.9-.2-1.1-38.4-36-39.6-37.1-.7-.6-2-.7-3.3 0-.7.3-1.3 1-1.8 1.9 0 0-3 .4 1.3 11.1 4.3 10.6 6.6 19.1 6.6 19.1s-1.8 4.1-2.8 6.6c-.9 1.7 5.8 2.1 8.4-4.4 4.4.8 13.6 3.4 19 12.6v.1c1.1 1.9 1.9 1.2 2.4.9 3.2-2.4 7.2-5.8 6.7-7.5Z" fill="#00E4E5"/><path fill-rule="evenodd" clip-rule="evenodd" d="M182.3 83.802c-.2-1.1-38.4-36-39.6-37.1-.7-.6-2-.7-3.3 0l42.2 39c.5-.7.8-1.4.7-1.9Z" fill="#071F4D"/><path d="M137.8 48.4 179.2 87M140.4 63.2l5.2-3.9M143.6 72.4s3.2-2.1 6.8-2.3M144.8 75.903c.6-.2 5.4-1.8 7.7-1.5M142.3 91.6l4.2-3.8M159.9 103.9l5-6.5" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="m206.1 129.6 11.7 16.7 9-7.2-8.7-14.1-9.5 3.3-2.5 1.3Z" fill="#C7DEFF"/><path d="m235.4 134.9-5.2 2.7-2.2-3.2" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M217.9 123.3s4.9-4.1 8.8-1.6c2.4 1.5 2.1-1.1 2.1-1.1l-7.3-7.9-6.1 7.2 2.5 3.4Z" fill="#C7DEFF"/><path d="m216.2 121.1 9.2 15.2" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M237.397 136.399c3.7-1.4 8.5-3.7 8.5-5.4.8.2 1.8-.1 2.6-.7.7-.4 1.3-1 1.3-1.6.1-1.2-27.2-45.1-28.1-46.5-.5-.7-1.8-1.1-3.2-.8-.8.2-1.6.6-2.3 1.4 0 0-3-.4-1.8 11 1.3 11.4 1.2 20.2 1.2 20.2s-2.8 3.5-4.4 5.6c-1.3 1.4 5 3.5 9.3-2 4.1 1.9 12.2 6.9 14.9 17.2v.1c.5 2.1 1.5 1.7 2 1.5Z" fill="#00E4E5"/><path fill-rule="evenodd" clip-rule="evenodd" d="M249.8 128.699c.1-1.2-27.2-45.1-28.1-46.5-.5-.7-1.8-1.1-3.2-.8l30 49c.6-.5 1.2-1.1 1.3-1.7Z" fill="#071F4D"/><path d="m216.5 82.6 29.4 48.4M214.9 97.6l6.1-2.3M215.5 107.395s3.7-1.2 7.2-.4M215.7 111.098c.6 0 5.7-.3 7.8.7M209.1 125.5l5-2.5M222.7 142.1l6.5-4.9" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M208.2 122c-2.5 1-29.9 15.6-47.1 28.8-17.2 13.2-27 23.3-30.3 30.3-1.8 3.6-2.4 4.4-2.4 4.4-1.3-3.4-3.6-10.1-3.9-12.4-.4-4.1 0-9 3.3-14.3 3.3-5.3 27.4-43.9 32.4-51.9-2.4-1.9-8.2-6.8-19.8-16.9-3.4 2.8-35.6 29.9-44.6 38.5-9 8.6-10.8 15.7-10.8 29.3v63.6s25.2 3.9 44.3 2.1c19.1-1.8 44.1-4.1 44.1-4.1s-2.6-29.6 2.9-36.1c5.4-6.5 41.6-34.2 45.5-37.5-3.8-7.5-9-15.8-13.6-23.8Z" fill="#006EFF"/><path d="M154.103 116.7c-9 14.4-23.8 38.1-26.3 42.1-3.3 5.3-3.7 10.2-3.3 14.3M85.1 215.7v-57.9c0-13.6 1.8-20.8 10.8-29.3 1.8-1.7 4.5-4.2 7.8-7.1M197.402 165.1c-9.5 7.6-18.6 15.2-21.1 18.2-5.4 6.5-2.9 36.1-2.9 36.1M123.4 218.3s4.2-30.3 7.5-37.2c3.3-6.9 13-17.1 30.3-30.3 10.5-8.1 24.9-16.6 35-22.3" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M173.1 256.4v-8h-68V264s14.2-5.5 31.1-3.8c29.1 2.9 36.8-3.8 36.8-3.8h.1ZM271.5 255.1h-31.1v9.2s6.5-5.5 14.2-3.8c13.4 2.9 16.9-3.8 16.9-3.8v-1.6Z" fill="#C7DEFF"/><path d="M105.2 245h51.9M240.7 251.7h30.6M165.6 245h7.2M56.7 219.6c10.4 0 17.4.5 23.2 1.1 11.4 1.3 18.4 3.1 39 3.1 31.1 0 31.1-4.3 62.2-4.3s31.2 4.3 51.5 4.3 27.7-5.8 51.5-5.8c15.1 0 20.4 5.8 51.5 5.8" stroke="#071F4D"/><path d="M284.1 218c16.2 0 21.5 5.8 51.5 5.8" stroke="#071F4D"/><path d="M159.5 203.5v6.2M202.4 146.7l-31.6 25.9c-7.1 5.9-11.3 14.7-11.3 23.9M206.7 143.2l2.7-2.3M138.098 118.6l-19.2 24c-7.5 9.4-11.3 21.3-10.6 33.3l2.4 38.5M143.6 111.7l3.2-4" stroke="#DEEBFC"/><path d="m141.8 178.4 6-1.1M94.5 140.6l5.4-4" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M135.2 236.099c7.395-.581 13.632-1.202 19.262-1.762 19.569-1.948 31.803-3.166 59.838.562 24.429 3.262 31.821 1.804 43.661-.53 3.766-.743 7.982-1.574 13.339-2.37 14.976-2.226 25.902.28 35.11 2.393 4.442 1.019 8.485 1.946 12.39 2.207 12 .7 16.8-.3 16.8-.3v-9.6c-.1.04-4.95.99-16.8.3-3.972-.232-8.097-1.176-12.641-2.215-9.183-2.101-20.074-4.593-34.859-2.385-5.305.792-9.493 1.619-13.239 2.358-11.858 2.342-19.291 3.809-43.761.542-28.035-3.728-40.269-2.51-59.838-.562-5.63.56-11.867 1.181-19.262 1.762-15.1 1.2-36.9 1.3-60-2.2-10.8-1.6-18.7-1.1-18.7-1.1v9.6s7.9-.5 18.7 1.1c23.1 3.5 44.9 3.4 60 2.2Z" fill="#C7DEFF"/></svg>
\ No newline at end of file
diff --git a/web/src/assets/images/svg/500.svg b/web/src/assets/images/svg/500.svg
new file mode 100644
index 0000000..512429f
--- /dev/null
+++ b/web/src/assets/images/svg/500.svg
@@ -0,0 +1,5 @@
+<svg
+  viewBox="0 0 400 300"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+><mask id="a" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="47" y="38" width="307" height="224"><path d="M353.3 38H47.5v223.8h305.8V38Z" fill="#fff"/></mask><g mask="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M299.2 200.6H61.6v5.1h240.3l-2.7-5.1Z" fill="#C7DEFF"/><path d="m308.9 185.8-6.5 20H183.7M332.3 127.6h10.6l-5 16.7-14.8-.1-7.2 21.1M328.8 127.4l13.6-39.6M307.6 166 337 84.7H180.6l-9.8 26.9h-10.5M296.6 196l4.3-11.8M157.2 149.2l6.4-17.7" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M324.8 93.1H188.5l-34.8 95.8h136.4l34.7-95.8ZM169.9 166.2l5-13.6-5 13.6Z" fill="#fff"/><path d="m169.9 166.2 5-13.6" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M324.8 93.1H188.5l-4 11.7h135.8l4.5-11.7Z" fill="#006EFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M102.6 159.5h38.3l2.7 36.6h-38.4c-10.1 0-20.9-8.2-20.9-18.3 0-10.1 8.2-18.3 18.3-18.3Z" fill="#DEEBFC"/><path fill-rule="evenodd" clip-rule="evenodd" d="M84.3 174.102c2.5 3.4 10 5 17.9 2.8 16.6-6.5 23.8-3.9 23.8-3.9s.5-3.4 1.3-5c-5.8-3-15.4.3-26.1 3.1-10.7 2.8-15.8-2.5-15.8-2.5-.4 0-1.1 2.8-1.1 5.5Z" fill="#fff"/><path d="M96.5 194.2c-7.2-3.3-12.2-10.5-12.2-19m0 0c0-11.5 9.3-20.8 20.8-20.8h29.4" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M140.3 195.1c-8.4-2.7-14.5-10.6-14.5-19.8l14.5 19.8Zm-14.5-19.8c0-11.5 9.3-20.8 20.8-20.8l-20.8 20.8Zm20.8-20.8c11.5 0 20.8 9.3 20.8 20.8l-20.8-20.8Zm20.8 20.8c0 8.4-5 15.6-12.1 18.9l12.1-18.9Z" fill="#fff"/><path d="M140.3 195.1c-8.4-2.7-14.5-10.6-14.5-19.8m0 0c0-11.5 9.3-20.8 20.8-20.8m0 0c11.5 0 20.8 9.3 20.8 20.8m0 0c0 8.4-5 15.6-12.1 18.9" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M161.5 177.2c0-7.7-6.3-14-14-14s-14 6.3-14 14c0 5.8 3.5 10.8 8.6 12.9.1 0 5.8 1.6 10.7 0 5.3-1.7 8.7-7.1 8.7-12.9Z" fill="#00E4E5"/><path d="M140.5 190.1c-5.8-2.4-9.9-8.2-9.9-14.9 0-8.9 7.2-16.1 16.1-16.1 8.9 0 16.1 7.2 16.1 16.1 0 6.8-4.2 12.5-10.1 14.9M88.4 170.604c2.9 1.3 7.7 2.6 13.6.3 14.7-5.7 22.3-4.3 24.6-3.5M84.5 174.599s5.9 6.5 19 1.7c9.2-3.4 15.3-3.9 18.8-3.8" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M340.6 112.3h-55.2l-2.7 6.2H338l2.6-6.2Z" fill="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M236.8 117.9c-16.13 0-29.2 13.07-29.2 29.2s13.07 29.2 29.2 29.2 29.2-13.07 29.2-29.2-13.07-29.2-29.2-29.2Z" fill="#00E4E5"/><path d="M265 123.3c13.1 13.1 13.1 34.4 0 47.6M306 205.9h19.2M61.7 205.9h32.9M181.2 196.2h115.2M47.5 205.9h10v-9.7h73.8" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M146.7 179.2c-2.49 0-4.5 2.01-4.5 4.5s2.01 4.5 4.5 4.5 4.5-2.01 4.5-4.5-2.01-4.5-4.5-4.5Z" fill="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M169.5 196.2c3.9 0 7.1 3.2 7.1 7.1 0 3.9-3.2 7.1-7.1 7.1H144c-2.1 0-3.9 1.7-3.9 3.9v1c0 2.1 1.7 3.9 3.9 3.9h48c5.1 0 9.2 4.1 9.2 9.2s-4.1 9.3-9.2 9.2h-33.8c-2.3 0-4.1 1.8-4.1 4.1s1.8 4.1 4.1 4.1h4.2c4.4 0 8 3.6 8 8s-3.6 8-8 8H111c-3.7 0-6.8-3-6.8-6.8 0-3.7 3-6.8 6.8-6.8h.3c2.3 0 4.1-1.8 4.1-4.1s-1.8-4.1-4.1-4.1H79c-4.5 0-8.1-3.6-8.1-8.1s3.6-8.1 8.1-8.1h37.7c2.1 0 3.9-1.7 3.9-3.9 0-2.1-1.7-3.9-3.9-3.9h-7.9c-4.4 0-7.9-3.5-7.9-7.9s3.5-7.9 7.9-7.9h30.4c2.2 0 3.9-1.8 3.9-3.9V187c0-1.9 1.6-3.5 3.5-3.5s3.5 1.6 3.5 3.5v5.3c0 2.2 1.8 3.9 3.9 3.9h15.5Z" fill="#006EFF"/><path d="m227.8 138.5 18.7 18.7M227.8 157.2l18.7-18.7" stroke="#fff" stroke-width="6"/><path fill-rule="evenodd" clip-rule="evenodd" d="M194.8 96.9c-.99 0-1.8.81-1.8 1.8s.81 1.8 1.8 1.8 1.8-.81 1.8-1.8-.81-1.8-1.8-1.8ZM202.9 96.9c-.99 0-1.8.81-1.8 1.8s.81 1.8 1.8 1.8 1.8-.81 1.8-1.8-.81-1.8-1.8-1.8Z" fill="#fff"/><path d="m291.7 184.3-1.6 4.6h-121M298.1 166.7l22.5-61.9" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="m193 134.1 2.2-5.1h-19.4l-2.3 5.1H193ZM313.2 123.5l2.2-5.1h-24.5l-2.3 5.1h24.6Z" fill="#DEEBFC"/><path d="m164.5 159.2 19.8-54.6" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M199.6 119.8h-53.2l-4.4 9.3h53.2l4.4-9.3Z" fill="#00E4E5"/><path d="M151.3 129.1H142l4.4-9.3h16.9" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M353.3 169.4h-67.4l-4.8 12.2h67.3l4.9-12.2Z" fill="#006EFF"/><path d="M332.4 169.4h20.9l-4.9 12.2h-39.7M242.7 235.5v-4.8c0-3.8 3.1-7 7-7h20.2c3.8 0 7 3.1 7 7" stroke="#071F4D"/><path d="M261.1 235.5v-4.8c0-3.8 3.1-7 7-7h13.7c3.8 0 7 3.1 7 7v4.8M242.6 230.7h13.7M235.2 237.7h63.3M224 237.7h6.7" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M324.1 141.3H335l3.3-10.7h-10.2l-4 10.7Z" fill="#C7DEFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M288.3 230.4c0-3.6-2.9-6.5-6.5-6.5h-14.2c-3.6 0-6.5 2.9-6.5 6.5v5.3h27.2v-5.3Z" fill="#071F4D"/><path d="M80.4 228.5H83M87.7 228.5h19.2M146.3 195.8v2c0 3.6-2.9 6.6-6.6 6.6H138M133.4 204.3h1.5M154 249.9h9.4" stroke="#DEEBFC"/><path d="m299.4 141.9 5.1-13.9" stroke="#071F4D"/></g></svg>
diff --git a/web/src/assets/images/svg/login_icon.svg b/web/src/assets/images/svg/login_icon.svg
new file mode 100644
index 0000000..4beb3ab
--- /dev/null
+++ b/web/src/assets/images/svg/login_icon.svg
@@ -0,0 +1 @@
+<svg viewBox="0 0 400 300" fill="none" xmlns="http://www.w3.org/2000/svg"><mask id="a" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="44" y="42" width="312" height="217"><path d="M355.3 42H44v216.9h311.3V42Z" fill="#fff"/></mask><g mask="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M288.2 248.4h25.1v-30h-25.1v30Z" fill="#C7DEFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M304.498 238.199c-1.5-3.9-5.9-15.4-4-21.6-2.9.8-3.3.1-5-.1-1.7-.1 0 10.7 2.2 16.4 1.7 4.5 2.1 11.1 2.1 13.6h5.4c.2-1.9.3-5.5-.7-8.3Z" fill="#fff"/><path d="M311.5 214.7v-1.6c0-.7-.6-1.3-1.3-1.3h-22.8c-.7 0-1.3.6-1.3 1.3v1.6" fill="#fff"/><path d="M311.5 214.7v-1.6c0-.7-.6-1.3-1.3-1.3h-22.8c-.7 0-1.3.6-1.3 1.3v1.6M290.2 214.7h21.4c1 0 1.8.8 1.8 1.8v29" stroke="#071F4D" stroke-width="1.096"/><path d="M284.3 245.6v-29c0-1 .8-1.8 1.8-1.8h1.6" fill="#fff"/><path d="M284.3 245.6v-29c0-1 .8-1.8 1.8-1.8h1.6" stroke="#071F4D" stroke-width="1.096"/><path d="M295.402 216.5c-.9 4.2-.4 9.7 2.8 17.5 2.4 5.9 1.9 10.2 1.8 12.3M300.502 216.5c-.9 4.2-.4 9.7 2.8 17.5 2.4 5.9 1.9 10.2 1.8 12.3" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="m331 258.4-.3-5.2H88.5l-1.2 5.2H331Z" fill="#C7DEFF"/><path d="M252.9 248.7H331M216.6 258.4H331M47.1 139.3l-2.6 1.5 42.7 117.6h129.2v-6.6" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="m247.2 248.6-40.4-111.3H50.5l40.3 111.3h156.4Z" fill="#fff"/><path d="m247.2 248.6-40.4-111.3H50.5l40.3 111.3h156.4Z" stroke="#071F4D"/><path d="m203.2 153.2 32.2 88.7H97.8l-32.3-88.7" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M72.2 146.9c-.77 0-1.4.63-1.4 1.4 0 .77.63 1.4 1.4 1.4.77 0 1.4-.63 1.4-1.4 0-.77-.63-1.4-1.4-1.4ZM79.3 146.9c-.77 0-1.4.63-1.4 1.4 0 .77.63 1.4 1.4 1.4.77 0 1.4-.63 1.4-1.4 0-.77-.63-1.4-1.4-1.4Z" fill="#fff"/><path fill-rule="evenodd" clip-rule="evenodd" d="M263.5 171.2h80.3v-63.7h-80.3v63.7Z" fill="#C7DEFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M290 143.9h-45.6l12.5 51.3H290v-51.3Z" fill="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M286 117.4h-29.3v77.8h92.9v-67.6l-55.9.6-7.7-10.8Z" fill="#00E4E5"/><path d="m332.6 127.6-38.9.6-7.7-10.8h-11.7M308.9 195.2h45.9M250.3 195.2h28.5M287.3 195.2h12.3" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M130.5 211.4H186v-44h-55.5v44Z" fill="#C7DEFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M148.7 192.5h-31.6l8.7 35.5h22.9v-35.5Z" fill="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M145.9 174.2h-20.2V228h64.1v-46.7l-38.6.4-5.3-7.5Z" fill="#006EFF"/><path d="m179 181.3-27.8.4-5.3-7.5h-7.7M176.2 201.7h19.2M163.2 210.7H195M172.1 228h-54.2M184.8 228h8.1M174.9 228h5.4" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="m293.2 155.7-6.4 6.3 15.3 15.3 22.7-22.6-6.4-6.4-16.3 16.3-8.9-8.9Z" fill="#fff"/><path d="M57.2 258.4h283.6M345.9 258.4h8.1M55.4 258.4h220.5M160.1 118.8l-1.2 2.7M156.7 127c-.3.8-.7 1.8-1.1 2.8M222 68.5c-1 .2-1.9.5-2.9.8M214.1 70.7c-5.8 1.9-11.3 4.4-16.5 7.4M195.4 79.5c-.9.5-1.7 1.1-2.5 1.6M314.2 98.5c-.6-.8-1.3-1.5-2-2.3M308.9 92.8c-4-4-8.3-7.6-13-10.8M293.9 80.7c-.8-.5-1.7-1.1-2.5-1.6" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M251.296 71.203c-3.6-1.5-18.5-2.9-21.8-1.9-1 5.8 4.9 13.5 4.9 13.5s6-9.9 16.9-11.6Z" fill="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M251.3 42.704c-6.5 6.7-7.8 13-8.8 19.3 24.4-1.1 36.3 13 42.8 20 3.2-9.1 7.8-23 7.2-29-7.1-6.4-20-11.7-41.2-10.3Z" fill="#C7DEFF"/><path d="M230 69.3c36.2-3.8 52 21.1 52 21.1s11.4-28.2 10.5-37.4c-7.3-6.5-23.3-12-45.6-10.1-9 6.3-15.6 18.7-16.9 26.4Z" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M161.604 70.7c-6 8.4-9.9 21.9-8.8 33.8 8.4 5.3 32.3 10.5 43.6 11.5 6.1-7.9 15.9-26 15.9-26s-32-4.8-50.7-19.3Z" fill="#C7DEFF"/><path d="M193.103 119.5c4.8-2.7 19.2-29.5 19.2-29.5s-35.8-5.4-53.7-21.8c-9.3 6.1-16.4 24.3-15 40.1 10.6 6.7 45.8 13.3 49.5 11.2Z" stroke="#071F4D"/><path fill-rule="evenodd" clip-rule="evenodd" d="M189.5 111.6c-3 5.2-5.7 7.2-9.8 6.6 12.2 2.6 13.5 1.2 15.6-1.1 2.2-2.4 4.2-6.6 4.2-6.6s-3.1 2.5-10 1.1Z" fill="#071F4D"/><path d="M331 251.8v6.6M77 165.4l-2.7-6.7h7.8M222.8 228.9l2.8 6.6h-7.9" stroke="#071F4D"/></g></svg>
\ No newline at end of file
diff --git a/web/src/assets/images/user/avatar.webp b/web/src/assets/images/user/avatar.webp
new file mode 100644
index 0000000..6d7234b
Binary files /dev/null and b/web/src/assets/images/user/avatar.webp differ
diff --git a/web/src/assets/images/user/bg.webp b/web/src/assets/images/user/bg.webp
new file mode 100644
index 0000000..762b22d
Binary files /dev/null and b/web/src/assets/images/user/bg.webp differ
diff --git a/web/src/assets/styles/core/app.scss b/web/src/assets/styles/core/app.scss
new file mode 100755
index 0000000..c0efeed
--- /dev/null
+++ b/web/src/assets/styles/core/app.scss
@@ -0,0 +1,292 @@
+// 全局样式
+// 顶部进度条颜色
+#nprogress .bar {
+  z-index: 2400;
+  background-color: color-mix(in srgb, var(--theme-color) 70%, white);
+}
+
+#nprogress .peg {
+  box-shadow:
+    0 0 10px var(--theme-color),
+    0 0 5px var(--theme-color) !important;
+}
+
+#nprogress .spinner-icon {
+  border-top-color: var(--theme-color) !important;
+  border-left-color: var(--theme-color) !important;
+}
+
+// 处理移动端组件兼容性
+@media screen and (max-width: 640px) {
+  * {
+    cursor: default !important;
+  }
+}
+
+// 背景滤镜
+*,
+::before,
+::after {
+  --tw-backdrop-blur: ;
+  --tw-backdrop-brightness: ;
+  --tw-backdrop-contrast: ;
+  --tw-backdrop-grayscale: ;
+  --tw-backdrop-hue-rotate: ;
+  --tw-backdrop-invert: ;
+  --tw-backdrop-opacity: ;
+  --tw-backdrop-saturate: ;
+  --tw-backdrop-sepia: ;
+}
+
+// 色弱模式
+.color-weak {
+  filter: invert(80%);
+  -webkit-filter: invert(80%);
+}
+
+#noop {
+  display: none;
+}
+
+// 语言切换选中样式
+.langDropDownStyle {
+  // 选中项背景颜色
+  .is-selected {
+    background-color: var(--art-el-active-color) !important;
+  }
+
+  // 语言切换按钮菜单样式优化
+  .lang-btn-item {
+    .el-dropdown-menu__item {
+      padding-left: 13px !important;
+      padding-right: 6px !important;
+      margin-bottom: 3px !important;
+    }
+
+    &:last-child {
+      .el-dropdown-menu__item {
+        margin-bottom: 0 !important;
+      }
+    }
+
+    .menu-txt {
+      min-width: 60px;
+      display: block;
+    }
+
+    i {
+      font-size: 10px;
+      margin-left: 10px;
+    }
+  }
+}
+
+// 盒子默认边框
+.page-content {
+  border: 1px solid var(--art-card-border) !important;
+}
+
+@mixin art-card-base($border-color, $shadow: none, $radius-diff: 4px) {
+  background: var(--default-box-color);
+  border: 1px solid #{$border-color} !important;
+  border-radius: calc(var(--custom-radius) + #{$radius-diff}) !important;
+  box-shadow: #{$shadow} !important;
+
+  --el-card-border-color: var(--default-border) !important;
+}
+
+.art-card,
+.art-card-sm,
+.art-card-xs {
+  border: 1px solid var(--art-card-border);
+}
+
+// 盒子边框
+[data-box-mode='border-mode'] {
+  .page-content,
+  .art-table-card {
+    border: 1px solid var(--art-card-border) !important;
+  }
+
+  .art-card {
+    @include art-card-base(var(--art-card-border), none, 4px);
+  }
+
+  .art-card-sm {
+    @include art-card-base(var(--art-card-border), none, 0px);
+  }
+
+  .art-card-xs {
+    @include art-card-base(var(--art-card-border), none, -4px);
+  }
+}
+
+// 盒子阴影
+[data-box-mode='shadow-mode'] {
+  .page-content,
+  .art-table-card {
+    box-shadow: 0px 0px 4px 0px rgba(0, 0, 0, 0.04) !important;
+    border: 1px solid var(--art-gray-200) !important;
+  }
+
+  .layout-sidebar {
+    border-right: 1px solid var(--art-card-border) !important;
+  }
+
+  .art-card {
+    @include art-card-base(
+      var(--art-gray-200),
+      (0 1px 3px 0 rgba(0, 0, 0, 0.03), 0 1px 2px -1px rgba(0, 0, 0, 0.08)),
+      4px
+    );
+  }
+
+  .art-card-sm {
+    @include art-card-base(
+      var(--art-gray-200),
+      (0 1px 3px 0 rgba(0, 0, 0, 0.03), 0 1px 2px -1px rgba(0, 0, 0, 0.08)),
+      2px
+    );
+  }
+
+  .art-card-xs {
+    @include art-card-base(
+      var(--art-gray-200),
+      (0 1px 2px 0 rgba(0, 0, 0, 0.03), 0 1px 1px -1px rgba(0, 0, 0, 0.08)),
+      -4px
+    );
+  }
+}
+
+// 元素全屏
+.el-full-screen {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  width: 100vw !important;
+  height: 100% !important;
+  z-index: 2300;
+  margin-top: 0;
+  padding: 15px;
+  box-sizing: border-box;
+  background-color: var(--default-box-color);
+  display: flex;
+  flex-direction: column;
+}
+
+// 表格卡片
+.art-table-card {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  margin-top: 12px;
+  border-radius: calc(var(--custom-radius) / 2 + 2px) !important;
+
+  .el-card__body {
+    height: 100%;
+    overflow: hidden;
+  }
+}
+
+// 容器全高
+.art-full-height {
+  height: var(--art-full-height);
+  display: flex;
+  flex-direction: column;
+
+  @media (max-width: 640px) {
+    height: auto;
+  }
+}
+
+// 徽章样式
+.art-badge {
+  position: absolute;
+  top: 0;
+  right: 20px;
+  bottom: 0;
+  width: 6px;
+  height: 6px;
+  margin: auto;
+  background: #ff3860;
+  border-radius: 50%;
+  animation: breathe 1.5s ease-in-out infinite;
+
+  &.art-badge-horizontal {
+    right: 0;
+  }
+
+  &.art-badge-mixed {
+    right: 0;
+  }
+
+  &.art-badge-dual {
+    right: 5px;
+    top: 5px;
+    bottom: auto;
+  }
+}
+
+// 文字徽章样式
+.art-text-badge {
+  position: absolute;
+  top: 0;
+  right: 12px;
+  bottom: 0;
+  min-width: 20px;
+  height: 18px;
+  line-height: 17px;
+  padding: 0 5px;
+  margin: auto;
+  font-size: 10px;
+  color: #fff;
+  text-align: center;
+  background: #fd4e4e;
+  border-radius: 4px;
+}
+
+@keyframes breathe {
+  0% {
+    opacity: 0.7;
+    transform: scale(1);
+  }
+
+  50% {
+    opacity: 1;
+    transform: scale(1.1);
+  }
+
+  100% {
+    opacity: 0.7;
+    transform: scale(1);
+  }
+}
+
+// 修复老机型 loading 定位问题
+.art-loading-fix {
+  position: fixed !important;
+  top: 0 !important;
+  left: 0 !important;
+  right: 0 !important;
+  bottom: 0 !important;
+  width: 100vw !important;
+  height: 100vh !important;
+  display: flex !important;
+  align-items: center !important;
+  justify-content: center !important;
+}
+
+.art-loading-fix .el-loading-spinner {
+  position: static !important;
+  top: auto !important;
+  left: auto !important;
+  transform: none !important;
+}
+
+// 去除移动端点击背景色
+@media screen and (max-width: 1180px) {
+  * {
+    -webkit-tap-highlight-color: transparent;
+  }
+}
diff --git a/web/src/assets/styles/core/dark.scss b/web/src/assets/styles/core/dark.scss
new file mode 100755
index 0000000..c52abc3
--- /dev/null
+++ b/web/src/assets/styles/core/dark.scss
@@ -0,0 +1,93 @@
+/*
+* 深色主题
+* 单页面移除深色主题 document.getElementsByTagName("html")[0].removeAttribute('class')
+*/
+
+$font-color: rgba(#ffffff, 0.85);
+
+/* 覆盖element-plus默认深色背景色 */
+html.dark {
+  // element-plus
+  --el-bg-color: var(--default-box-color);
+  --el-text-color-regular: #{$font-color};
+
+  // 富文本编辑器
+  // 工具栏背景颜色
+  --w-e-toolbar-bg-color: #18191c;
+  // 输入区域背景颜色
+  --w-e-textarea-bg-color: #090909;
+  // 工具栏文字颜色
+  --w-e-toolbar-color: var(--art-gray-600);
+  // 选中菜单颜色
+  --w-e-toolbar-active-bg-color: #25262b;
+  // 弹窗边框颜色
+  --w-e-toolbar-border-color: var(--default-border-dashed);
+  // 分割线颜色
+  --w-e-textarea-border-color: var(--default-border-dashed);
+  // 链接输入框边框颜色
+  --w-e-modal-button-border-color: var(--default-border-dashed);
+  // 表格头颜色
+  --w-e-textarea-slight-bg-color: #090909;
+  // 按钮背景颜色
+  --w-e-modal-button-bg-color: #090909;
+  // hover toolbar 背景颜色
+  --w-e-toolbar-active-color: var(--art-gray-800);
+}
+
+.dark {
+  .page-content .article-list .item .left .outer > div {
+    border-right-color: var(--dark-border-color) !important;
+  }
+
+  // 富文本编辑器
+  .editor-wrapper {
+    *:not(pre code *) {
+      color: inherit !important;
+    }
+  }
+  // 分隔线
+  .w-e-bar-divider {
+    background-color: var(--art-gray-300) !important;
+  }
+
+  .w-e-select-list,
+  .w-e-drop-panel,
+  .w-e-bar-item-group .w-e-bar-item-menus-container,
+  .w-e-text-container [data-slate-editor] pre > code {
+    border: 1px solid var(--default-border) !important;
+  }
+
+  // 下拉选择框
+  .w-e-select-list {
+    background-color: var(--default-box-color) !important;
+  }
+
+  /* 下拉选择框 hover 样式调整 */
+  .w-e-select-list ul li:hover,
+    /* 工具栏 hover 按钮背景颜色 */
+    .w-e-bar-item button:hover {
+    background-color: #090909 !important;
+  }
+
+  /* 代码块 */
+  .w-e-text-container [data-slate-editor] pre > code {
+    background-color: #25262b !important;
+    text-shadow: none !important;
+  }
+
+  /* 引用 */
+  .w-e-text-container [data-slate-editor] blockquote {
+    border-left: 4px solid var(--default-border-dashed) !important;
+    background-color: var(--art-color);
+  }
+
+  .editor-wrapper {
+    .w-e-text-container [data-slate-editor] .table-container th:last-of-type {
+      border-right: 1px solid var(--default-border-dashed) !important;
+    }
+
+    .w-e-modal {
+      background-color: var(--art-color);
+    }
+  }
+}
diff --git a/web/src/assets/styles/core/el-dark.scss b/web/src/assets/styles/core/el-dark.scss
new file mode 100644
index 0000000..8f81cdf
--- /dev/null
+++ b/web/src/assets/styles/core/el-dark.scss
@@ -0,0 +1,2 @@
+// 导入暗黑主题
+@use 'element-plus/theme-chalk/src/dark/css-vars.scss' as *;
diff --git a/web/src/assets/styles/core/el-light.scss b/web/src/assets/styles/core/el-light.scss
new file mode 100644
index 0000000..ddf2bc5
--- /dev/null
+++ b/web/src/assets/styles/core/el-light.scss
@@ -0,0 +1,34 @@
+// https://github.com/element-plus/element-plus/blob/dev/packages/theme-chalk/src/common/var.scss
+// 自定义Element 亮色主题
+
+@forward 'element-plus/theme-chalk/src/common/var.scss' with (
+  $colors: (
+    'white': #ffffff,
+    'black': #000000,
+    'success': (
+      'base': #13deb9
+    ),
+    'warning': (
+      'base': #ffae1f
+    ),
+    'danger': (
+      'base': #ff4d4f
+    ),
+    'error': (
+      'base': #fa896b
+    )
+  ),
+  $button: (
+    'hover-bg-color': var(--el-color-primary-light-9),
+    'hover-border-color': var(--el-color-primary),
+    'border-color': var(--el-color-primary),
+    'text-color': var(--el-color-primary)
+  ),
+  $messagebox: (
+    'border-radius': '12px'
+  ),
+  $popover: (
+    'padding': '14px',
+    'border-radius': '10px'
+  )
+);
diff --git a/web/src/assets/styles/core/el-ui.scss b/web/src/assets/styles/core/el-ui.scss
new file mode 100644
index 0000000..44429a1
--- /dev/null
+++ b/web/src/assets/styles/core/el-ui.scss
@@ -0,0 +1,519 @@
+// 优化 Element Plus 组件库默认样式
+
+:root {
+  // 系统主色
+  --main-color: var(--el-color-primary);
+  --el-color-white: white !important;
+  --el-color-black: white !important;
+  // 输入框边框颜色
+  // --el-border-color: #E4E4E7 !important; // DCDFE6
+  // 按钮粗度
+  --el-font-weight-primary: 400 !important;
+
+  --el-component-custom-height: 36px !important;
+
+  --el-component-size: var(--el-component-custom-height) !important;
+
+  // 边框、按钮圆角...
+  --el-border-radius-base: calc(var(--custom-radius) / 3 + 2px) !important;
+
+  --el-border-radius-small: calc(var(--custom-radius) / 3 + 4px) !important;
+  --el-messagebox-border-radius: calc(var(--custom-radius) / 3 + 4px) !important;
+  --el-popover-border-radius: calc(var(--custom-radius) / 3 + 4px) !important;
+
+  .region .el-radio-button__original-radio:checked + .el-radio-button__inner {
+    color: var(--theme-color);
+  }
+}
+
+// 优化 el-form-item 标签高度
+.el-form-item__label {
+  height: var(--el-component-custom-height) !important;
+  line-height: var(--el-component-custom-height) !important;
+}
+
+// 日期选择器
+.el-date-range-picker {
+  --el-datepicker-inrange-bg-color: var(--art-gray-200) !important;
+}
+
+// el-card 背景色跟系统背景色保持一致
+html.dark .el-card {
+  --el-card-bg-color: var(--default-box-color) !important;
+}
+
+// 修改 el-pagination 大小
+.el-pagination--default {
+  & {
+    --el-pagination-button-width: 32px !important;
+    --el-pagination-button-height: var(--el-pagination-button-width) !important;
+  }
+
+  @media (max-width: 1180px) {
+    & {
+      --el-pagination-button-width: 28px !important;
+    }
+  }
+
+  .el-select--default .el-select__wrapper {
+    min-height: var(--el-pagination-button-width) !important;
+  }
+
+  .el-pagination__jump .el-input {
+    height: var(--el-pagination-button-width) !important;
+  }
+}
+
+.el-pager li {
+  padding: 0 10px !important;
+  // border: 1px solid red !important;
+}
+
+// 优化菜单折叠展开动画（提升动画流畅度）
+.el-menu.el-menu--inline {
+  transition: max-height 0.26s cubic-bezier(0.4, 0, 0.2, 1) !important;
+}
+
+// 优化菜单 item hover 动画（提升鼠标跟手感）
+.el-sub-menu__title,
+.el-menu-item {
+  transition: background-color 0s !important;
+}
+
+// -------------------------------- 修改 el-size=default 组件默认高度 start --------------------------------
+// 修改 el-button 高度
+.el-button--default {
+  height: var(--el-component-custom-height) !important;
+}
+
+// circle 按钮宽度优化
+.el-button--default.is-circle {
+  width: var(--el-component-custom-height) !important;
+}
+
+// 修改 el-select 高度
+.el-select--default {
+  .el-select__wrapper {
+    min-height: var(--el-component-custom-height) !important;
+  }
+}
+
+// 修改 el-checkbox-button 高度
+.el-checkbox-button--default .el-checkbox-button__inner,
+// 修改 el-radio-button 高度
+.el-radio-button--default .el-radio-button__inner {
+  padding: 10px 15px !important;
+}
+// -------------------------------- 修改 el-size=default 组件默认高度 end --------------------------------
+
+.el-pagination.is-background .btn-next,
+.el-pagination.is-background .btn-prev,
+.el-pagination.is-background .el-pager li {
+  border-radius: 6px;
+}
+
+.el-popover {
+  min-width: 80px;
+  border-radius: var(--el-border-radius-small) !important;
+}
+
+.el-dialog {
+  border-radius: 100px !important;
+  border-radius: calc(var(--custom-radius) / 1.2 + 2px) !important;
+  overflow: hidden;
+}
+
+.el-dialog__header {
+  .el-dialog__title {
+    font-size: 16px;
+  }
+}
+
+.el-dialog__body {
+  padding: 25px 0 !important;
+  position: relative; // 为了兼容 el-pagination 样式，需要设置 relative，不然会影响 el-pagination 的样式，比如 el-pagination__jump--small 会被影响，导致 el-pagination__jump--small 按钮无法点击，详见 URL_ADDRESS.com/element-plus/element-plus/issues/5684#issuecomment-1176299275;
+}
+
+.el-dialog.el-dialog-border {
+  .el-dialog__body {
+    // 上边框
+    &::before,
+    // 下边框
+    &::after {
+      content: '';
+      position: absolute;
+      left: -16px;
+      width: calc(100% + 32px);
+      height: 1px;
+      background-color: var(--art-gray-300);
+    }
+
+    &::before {
+      top: 0;
+    }
+
+    &::after {
+      bottom: 0;
+    }
+  }
+}
+
+// el-message 样式优化
+.el-message {
+  background-color: var(--default-box-color) !important;
+  border: 0 !important;
+  box-shadow:
+    0 6px 16px 0 rgba(0, 0, 0, 0.08),
+    0 3px 6px -4px rgba(0, 0, 0, 0.12),
+    0 9px 28px 8px rgba(0, 0, 0, 0.05) !important;
+
+  p {
+    font-size: 13px;
+  }
+}
+
+// 修改 el-dropdown 样式
+.el-dropdown-menu {
+  padding: 6px !important;
+  border-radius: 10px !important;
+  border: none !important;
+
+  .el-dropdown-menu__item {
+    padding: 6px 16px !important;
+    border-radius: 6px !important;
+
+    &:hover:not(.is-disabled) {
+      color: var(--art-gray-900) !important;
+      background-color: var(--art-el-active-color) !important;
+    }
+
+    &:focus:not(.is-disabled) {
+      color: var(--art-gray-900) !important;
+      background-color: var(--art-gray-200) !important;
+    }
+  }
+}
+
+// 隐藏 select、dropdown 的三角
+.el-select__popper,
+.el-dropdown__popper {
+  margin-top: -6px !important;
+
+  .el-popper__arrow {
+    display: none;
+  }
+}
+
+.el-dropdown-selfdefine:focus {
+  outline: none !important;
+}
+
+// 处理移动端组件兼容性
+@media screen and (max-width: 640px) {
+  .el-message-box,
+  .el-dialog {
+    width: calc(100% - 24px) !important;
+  }
+
+  .el-date-picker.has-sidebar.has-time {
+    width: calc(100% - 24px);
+    left: 12px !important;
+  }
+
+  .el-picker-panel *[slot='sidebar'],
+  .el-picker-panel__sidebar {
+    display: none;
+  }
+
+  .el-picker-panel *[slot='sidebar'] + .el-picker-panel__body,
+  .el-picker-panel__sidebar + .el-picker-panel__body {
+    margin-left: 0;
+  }
+}
+
+// 修改el-button样式
+.el-button {
+  &.el-button--text {
+    background-color: transparent !important;
+    padding: 0 !important;
+
+    span {
+      margin-left: 0 !important;
+    }
+  }
+}
+
+// 修改el-tag样式
+.el-tag {
+  font-weight: 500;
+  transition: all 0s !important;
+
+  &.el-tag--default {
+    height: 26px !important;
+  }
+}
+
+.el-checkbox-group {
+  &.el-table-filter__checkbox-group label.el-checkbox {
+    height: 17px !important;
+
+    .el-checkbox__label {
+      font-weight: 400 !important;
+    }
+  }
+}
+
+.el-radio--default {
+  // 优化单选按钮大小
+  .el-radio__input {
+    .el-radio__inner {
+      width: 16px;
+      height: 16px;
+
+      &::after {
+        width: 6px;
+        height: 6px;
+      }
+    }
+  }
+}
+
+.el-checkbox {
+  .el-checkbox__inner {
+    border-radius: 2px !important;
+  }
+}
+
+// 优化复选框样式
+.el-checkbox--default {
+  .el-checkbox__inner {
+    width: 16px !important;
+    height: 16px !important;
+    border-radius: 4px !important;
+
+    &::before {
+      content: '';
+      height: 4px !important;
+      top: 5px !important;
+      background-color: #fff !important;
+      transform: scale(0.6) !important;
+    }
+  }
+
+  .is-checked {
+    .el-checkbox__inner {
+      &::after {
+        width: 3px;
+        height: 8px;
+        margin: auto;
+        border: 2px solid var(--el-checkbox-checked-icon-color);
+        border-left: 0;
+        border-top: 0;
+        transform: translate(-45%, -60%) rotate(45deg) scale(0.86) !important;
+        transform-origin: center;
+      }
+    }
+  }
+}
+
+.el-notification .el-notification__icon {
+  font-size: 22px !important;
+}
+
+// 修改 el-message-box 样式
+.el-message-box__headerbtn .el-message-box__close,
+.el-dialog__headerbtn .el-dialog__close {
+  top: 7px;
+  right: 7px;
+  width: 30px;
+  height: 30px;
+  border-radius: 5px;
+  transition: all 0.3s;
+
+  &:hover {
+    background-color: var(--art-hover-color) !important;
+    color: var(--art-gray-900) !important;
+  }
+}
+
+.el-message-box {
+  padding: 25px 20px !important;
+}
+
+.el-message-box__title {
+  font-weight: 500 !important;
+}
+
+.el-table__column-filter-trigger i {
+  color: var(--theme-color) !important;
+  margin: -3px 0 0 2px;
+}
+
+// 去除 el-dropdown 鼠标放上去出现的边框
+.el-tooltip__trigger:focus-visible {
+  outline: unset;
+}
+
+// ipad 表单右侧按钮优化
+@media screen and (max-width: 1180px) {
+  .el-table-fixed-column--right {
+    padding-right: 0 !important;
+  }
+}
+
+.login-out-dialog {
+  padding: 30px 20px !important;
+  border-radius: 10px !important;
+}
+
+// 修改 dialog 动画
+.dialog-fade-enter-active {
+  .el-dialog:not(.is-draggable) {
+    animation: dialog-open 0.3s cubic-bezier(0.32, 0.14, 0.15, 0.86);
+
+    // 修复 el-dialog 动画后宽度不自适应问题
+    .el-select__selected-item {
+      display: inline-block;
+    }
+  }
+}
+
+.dialog-fade-leave-active {
+  animation: fade-out 0.2s linear;
+
+  .el-dialog:not(.is-draggable) {
+    animation: dialog-close 0.5s;
+  }
+}
+
+@keyframes dialog-open {
+  0% {
+    opacity: 0;
+    transform: scale(0.2);
+  }
+
+  100% {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+@keyframes dialog-close {
+  0% {
+    opacity: 1;
+    transform: scale(1);
+  }
+
+  100% {
+    opacity: 0;
+    transform: scale(0.2);
+  }
+}
+
+// 遮罩层动画
+@keyframes fade-out {
+  0% {
+    opacity: 1;
+  }
+
+  100% {
+    opacity: 0;
+  }
+}
+
+// 修改 el-select 样式
+.el-select__popper:not(.el-tree-select__popper) {
+  .el-select-dropdown__list {
+    padding: 5px !important;
+
+    .el-select-dropdown__item {
+      height: 34px !important;
+      line-height: 34px !important;
+      border-radius: 6px !important;
+
+      &.is-selected {
+        color: var(--art-gray-900) !important;
+        font-weight: 400 !important;
+        background-color: var(--art-el-active-color) !important;
+        margin-bottom: 4px !important;
+      }
+
+      &:hover {
+        background-color: var(--art-hover-color) !important;
+      }
+    }
+
+    .el-select-dropdown__item:hover ~ .is-selected,
+    .el-select-dropdown__item.is-selected:has(~ .el-select-dropdown__item:hover) {
+      background-color: transparent !important;
+    }
+  }
+}
+
+// 修改 el-tree-select 样式
+.el-tree-select__popper {
+  .el-select-dropdown__list {
+    padding: 5px !important;
+
+    .el-tree-node {
+      .el-tree-node__content {
+        height: 36px !important;
+        border-radius: 6px !important;
+
+        &:hover {
+          background-color: var(--art-gray-200) !important;
+        }
+      }
+    }
+  }
+}
+
+// 实现水波纹在文字下面效果
+.el-button > span {
+  position: relative;
+  z-index: 10;
+}
+
+// 优化颜色选择器圆角
+.el-color-picker__color {
+  border-radius: 2px !important;
+}
+
+// 优化日期时间选择器底部圆角
+.el-picker-panel {
+  .el-picker-panel__footer {
+    border-radius: 0 0 var(--el-border-radius-base) var(--el-border-radius-base);
+  }
+}
+
+// 优化树型菜单样式
+.el-tree-node__content {
+  border-radius: 4px;
+  margin-bottom: 4px;
+  padding: 1px 0;
+
+  &:hover {
+    background-color: var(--art-hover-color) !important;
+  }
+}
+
+.dark {
+  .el-tree--highlight-current .el-tree-node.is-current > .el-tree-node__content {
+    background-color: var(--art-gray-300) !important;
+  }
+}
+
+// 隐藏折叠菜单弹窗 hover 出现的边框
+.menu-left-popper:focus-within,
+.horizontal-menu-popper:focus-within {
+  box-shadow: none !important;
+  outline: none !important;
+}
+
+// 数字输入组件右侧按钮高度跟随自定义组件高度
+.el-input-number--default.is-controls-right {
+  .el-input-number__decrease,
+  .el-input-number__increase {
+    height: calc((var(--el-component-size) / 2)) !important;
+  }
+}
diff --git a/web/src/assets/styles/core/md.scss b/web/src/assets/styles/core/md.scss
new file mode 100644
index 0000000..b22fdc2
--- /dev/null
+++ b/web/src/assets/styles/core/md.scss
@@ -0,0 +1,1036 @@
+/* 文章标题设置（h1-h6）*/
+/* ------------------------------------------------ */
+$font-color: #24292e;
+
+.markdown-body h1,
+.markdown-body h2,
+.markdown-body h3,
+.markdown-body h4,
+.markdown-body h5,
+.markdown-body h6 {
+  color: var(--art-gray-800) !important;
+  margin: 30px 0 10px 0;
+  font-weight: 600;
+}
+
+.markdown-body h1 {
+  font-size: 30px;
+}
+
+@media only screen and (max-width: 550px) {
+  .markdown-body h1 {
+    font-size: 26px;
+  }
+
+  .markdown-body h2 {
+    font-size: 22px;
+  }
+
+  .markdown-body h3 {
+    font-size: 18px;
+  }
+}
+
+/* 块引用 */
+/* ------------------------------------------------ */
+.markdown-body blockquote {
+  color: rgba(60, 60, 67, 0.7);
+  font-size: 15px !important;
+  border-left: 0.18em solid #e7e7e8;
+  background: #f8f8f8;
+  padding: 15px 1em;
+  font-weight: 400 !important;
+}
+
+/* 详情页文章字体颜色 */
+/* ------------------------------------------------ */
+.markdown-body p {
+  line-height: 28px;
+  margin-bottom: 10px;
+}
+
+.markdown-body li,
+.markdown-body p {
+  color: var(--art-gray-800) !important;
+  font-size: 16px !important;
+}
+
+.dark .markdown-body li span {
+  color: var(--art-gray-800) !important;
+  background-color: transparent !important;
+}
+
+.dark .markdown-body p span {
+  color: var(--art-gray-800) !important;
+  background-color: transparent !important;
+}
+
+.line-numbers-mode {
+  background-color: var(--art-code-bg);
+  border-radius: 8px;
+  position: relative;
+  padding-left: 32px;
+  box-sizing: border-box;
+}
+
+.line-numbers-mode pre {
+  flex: 1;
+  border-radius: 0 8px 8px 0;
+  background-color: var(--art-code-bg);
+}
+
+.line-numbers-mode .line-numbers-wrapper {
+  width: 32px;
+  height: 100%;
+  text-align: center;
+  padding: 16px 0;
+  box-sizing: border-box;
+  border-right: 1px solid #000000;
+  position: absolute;
+  left: 0;
+  top: 0;
+}
+
+.line-numbers-mode .line-numbers-wrapper span {
+  height: 23.6px;
+  line-height: 23.6px;
+  display: block;
+  color: #72747b;
+  font-size: 13px;
+  box-sizing: border-box;
+}
+
+.line-numbers-mode .copy-btn {
+  display: inline-block;
+  display: flex;
+  position: absolute;
+  right: 10px;
+  top: 10px;
+  cursor: pointer;
+  opacity: 0;
+  background-color: #000;
+  border-radius: 5px;
+  text-align: center;
+  color: rgba(255, 255, 255, 0.6);
+  transition: opacity 0.3s;
+}
+
+.line-numbers-mode .copy-btn div {
+  width: 34px;
+  height: 34px;
+  line-height: 34px;
+  cursor: pointer;
+  text-align: center;
+  font-size: 20px;
+}
+
+.line-numbers-mode:hover .copy-btn {
+  opacity: 1;
+}
+
+.line-numbers-mode .copy-btn span {
+  height: 34px;
+  line-height: 34px;
+  font-size: 13px;
+  padding-left: 10px;
+  display: none;
+}
+
+.line-numbers-mode .copy-btn .show-copy {
+  opacity: 1;
+  display: block;
+}
+
+.line-numbers-mode ::-webkit-scrollbar-track {
+  background-color: #292b30 !important;
+}
+
+.markdown-body .anchor {
+  float: left;
+  line-height: 1;
+  margin-left: -20px;
+  padding-right: 4px;
+}
+
+.markdown-body .anchor:focus {
+  outline: none;
+}
+
+.markdown-body h1 .octicon-link,
+.markdown-body h2 .octicon-link,
+.markdown-body h3 .octicon-link,
+.markdown-body h4 .octicon-link,
+.markdown-body h5 .octicon-link,
+.markdown-body h6 .octicon-link {
+  color: #1b1f23;
+  vertical-align: middle;
+  visibility: hidden;
+}
+
+.markdown-body h1:hover .anchor,
+.markdown-body h2:hover .anchor,
+.markdown-body h3:hover .anchor,
+.markdown-body h4:hover .anchor,
+.markdown-body h5:hover .anchor,
+.markdown-body h6:hover .anchor {
+  text-decoration: none;
+}
+
+.markdown-body h1:hover .anchor .octicon-link,
+.markdown-body h2:hover .anchor .octicon-link,
+.markdown-body h3:hover .anchor .octicon-link,
+.markdown-body h4:hover .anchor .octicon-link,
+.markdown-body h5:hover .anchor .octicon-link,
+.markdown-body h6:hover .anchor .octicon-link {
+  visibility: visible;
+}
+
+.markdown-body h1:hover .anchor .octicon-link:before,
+.markdown-body h2:hover .anchor .octicon-link:before,
+.markdown-body h3:hover .anchor .octicon-link:before,
+.markdown-body h4:hover .anchor .octicon-link:before,
+.markdown-body h5:hover .anchor .octicon-link:before,
+.markdown-body h6:hover .anchor .octicon-link:before {
+  width: 16px;
+  height: 16px;
+  content: ' ';
+  display: inline-block;
+}
+
+.markdown-body {
+  -ms-text-size-adjust: 100%;
+  -webkit-text-size-adjust: 100%;
+  line-height: 1.5;
+  color: $font-color;
+  font-size: 16px;
+  line-height: 1.5;
+  word-wrap: break-word;
+}
+
+.markdown-body details {
+  display: block;
+}
+
+.markdown-body summary {
+  display: list-item;
+}
+
+.markdown-body a {
+  background-color: initial;
+}
+
+.markdown-body a:active,
+.markdown-body a:hover {
+  outline-width: 0;
+}
+
+.markdown-body strong {
+  font-weight: inherit;
+  font-weight: bolder;
+}
+
+.markdown-body p br {
+  display: inline;
+  line-height: 11px;
+}
+
+.markdown-body img {
+  border-style: none;
+}
+
+.markdown-body hr {
+  box-sizing: initial;
+  height: 0;
+  overflow: visible;
+}
+
+.markdown-body input {
+  font: inherit;
+  margin: 0;
+}
+
+.markdown-body input {
+  overflow: visible;
+}
+
+.markdown-body [type='checkbox'] {
+  box-sizing: border-box;
+  padding: 0;
+}
+
+.markdown-body * {
+  box-sizing: border-box;
+}
+
+.markdown-body input {
+  font-size: inherit;
+  line-height: inherit;
+}
+
+.markdown-body a {
+  color: #0366d6;
+  text-decoration: none;
+}
+
+.markdown-body a:hover {
+  text-decoration: underline;
+}
+
+.markdown-body strong {
+  font-weight: 600;
+}
+
+.markdown-body hr {
+  height: 0;
+  margin: 15px 0;
+  overflow: hidden;
+  background: transparent;
+  border: 0;
+  border-bottom: 1px solid #dfe2e5;
+}
+
+.markdown-body hr:after,
+.markdown-body hr:before {
+  display: table;
+  content: '';
+}
+
+.markdown-body hr:after {
+  clear: both;
+}
+
+.markdown-body table {
+  border-spacing: 0;
+  border-collapse: collapse;
+}
+
+.markdown-body td,
+.markdown-body th {
+  padding: 0;
+}
+
+.markdown-body details summary {
+  cursor: pointer;
+}
+
+.markdown-body kbd {
+  display: inline-block;
+  padding: 3px 5px;
+  font:
+    11px SFMono-Regular,
+    Consolas,
+    Liberation Mono,
+    Menlo,
+    monospace;
+  line-height: 10px;
+  color: #444d56;
+  vertical-align: middle;
+  background-color: #fafbfc;
+  border: 1px solid #d1d5da;
+  border-radius: 3px;
+  box-shadow: inset 0 -1px 0 #d1d5da;
+}
+
+.markdown-body blockquote {
+  margin: 0;
+}
+
+.markdown-body ol,
+.markdown-body ul {
+  padding-left: 0;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+.markdown-body ol ol,
+.markdown-body ul ol {
+  list-style-type: lower-roman;
+}
+
+.markdown-body ol ol ol,
+.markdown-body ol ul ol,
+.markdown-body ul ol ol,
+.markdown-body ul ul ol {
+  list-style-type: lower-alpha;
+}
+
+.markdown-body dd {
+  margin-left: 0;
+}
+
+.markdown-body code,
+.markdown-body pre,
+.markdown-body .line-number {
+  font-size: 14px !important;
+  border-radius: 8px;
+  background-color: #282c34;
+}
+
+.dark {
+  .markdown-body code,
+  .markdown-body pre,
+  .markdown-body .line-number {
+    background-color: #252525;
+  }
+}
+
+.markdown-body pre {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+.markdown-body input::-webkit-inner-spin-button,
+.markdown-body input::-webkit-outer-spin-button {
+  margin: 0;
+  -webkit-appearance: none;
+  appearance: none;
+}
+
+.markdown-body :checked + .radio-label {
+  position: relative;
+  z-index: 1;
+  border-color: #0366d6;
+}
+
+.markdown-body .border {
+  border: 1px solid #e1e4e8 !important;
+}
+
+.markdown-body .border-0 {
+  border: 0 !important;
+}
+
+.markdown-body .border-bottom {
+  border-bottom: 1px solid #e1e4e8 !important;
+}
+
+.markdown-body .rounded-1 {
+  border-radius: 3px !important;
+}
+
+.markdown-body .bg-white {
+  background-color: #fff !important;
+}
+
+.markdown-body .bg-gray-light {
+  background-color: #fafbfc !important;
+}
+
+.markdown-body .text-gray-light {
+  color: #6a737d !important;
+}
+
+.markdown-body .mb-0 {
+  margin-bottom: 0 !important;
+}
+
+.markdown-body .my-2 {
+  margin-top: 8px !important;
+  margin-bottom: 8px !important;
+}
+
+.markdown-body .pl-0 {
+  padding-left: 0 !important;
+}
+
+.markdown-body .py-0 {
+  padding-top: 0 !important;
+  padding-bottom: 0 !important;
+}
+
+.markdown-body .pl-1 {
+  padding-left: 4px !important;
+}
+
+.markdown-body .pl-2 {
+  padding-left: 8px !important;
+}
+
+.markdown-body .py-2 {
+  padding-top: 8px !important;
+  padding-bottom: 8px !important;
+}
+
+.markdown-body .pl-3,
+.markdown-body .px-3 {
+  padding-left: 16px !important;
+}
+
+.markdown-body .px-3 {
+  padding-right: 16px !important;
+}
+
+.markdown-body .pl-4 {
+  padding-left: 24px !important;
+}
+
+.markdown-body .pl-5 {
+  padding-left: 32px !important;
+}
+
+.markdown-body .pl-6 {
+  padding-left: 40px !important;
+}
+
+.markdown-body .f6 {
+  font-size: 12px !important;
+}
+
+.markdown-body .lh-condensed {
+  line-height: 1.25 !important;
+}
+
+.markdown-body .text-bold {
+  font-weight: 600 !important;
+}
+
+.markdown-body .pl-c {
+  color: #6a737d;
+}
+
+.markdown-body .pl-c1,
+.markdown-body .pl-s .pl-v {
+  color: #005cc5;
+}
+
+.markdown-body .pl-e,
+.markdown-body .pl-en {
+  color: #6f42c1;
+}
+
+.markdown-body .pl-s .pl-s1,
+.markdown-body .pl-smi {
+  color: $font-color;
+}
+
+.markdown-body .pl-ent {
+  color: #22863a;
+}
+
+.markdown-body .pl-k {
+  color: #d73a49;
+}
+
+.markdown-body .pl-pds,
+.markdown-body .pl-s,
+.markdown-body .pl-s .pl-pse .pl-s1,
+.markdown-body .pl-sr,
+.markdown-body .pl-sr .pl-cce,
+.markdown-body .pl-sr .pl-sra,
+.markdown-body .pl-sr .pl-sre {
+  color: #032f62;
+}
+
+.markdown-body .pl-smw,
+.markdown-body .pl-v {
+  color: #e36209;
+}
+
+.markdown-body .pl-bu {
+  color: #b31d28;
+}
+
+.markdown-body .pl-ii {
+  color: #fafbfc;
+  background-color: #b31d28;
+}
+
+.markdown-body .pl-c2 {
+  color: #fafbfc;
+  background-color: #d73a49;
+}
+
+.markdown-body .pl-c2:before {
+  content: '^M';
+}
+
+.markdown-body .pl-sr .pl-cce {
+  font-weight: 700;
+  color: #22863a;
+}
+
+.markdown-body .pl-ml {
+  color: #735c0f;
+}
+
+.markdown-body .pl-mh,
+.markdown-body .pl-mh .pl-en,
+.markdown-body .pl-ms {
+  font-weight: 700;
+  color: #005cc5;
+}
+
+.markdown-body .pl-mi {
+  font-style: italic;
+  color: $font-color;
+}
+
+.markdown-body .pl-mb {
+  font-weight: 700;
+  color: $font-color;
+}
+
+.markdown-body .pl-md {
+  color: #b31d28;
+  background-color: #ffeef0;
+}
+
+.markdown-body .pl-mi1 {
+  color: #22863a;
+  background-color: #f0fff4;
+}
+
+.markdown-body .pl-mc {
+  color: #e36209;
+  background-color: #ffebda;
+}
+
+.markdown-body .pl-mi2 {
+  color: #f6f8fa;
+  background-color: #005cc5;
+}
+
+.markdown-body .pl-mdr {
+  font-weight: 700;
+  color: #6f42c1;
+}
+
+.markdown-body .pl-ba {
+  color: #586069;
+}
+
+.markdown-body .pl-sg {
+  color: #959da5;
+}
+
+.markdown-body .pl-corl {
+  text-decoration: underline;
+  color: #032f62;
+}
+
+.markdown-body .mb-0 {
+  margin-bottom: 0 !important;
+}
+
+.markdown-body .my-2 {
+  margin-bottom: 8px !important;
+}
+
+.markdown-body .my-2 {
+  margin-top: 8px !important;
+}
+
+.markdown-body .pl-0 {
+  padding-left: 0 !important;
+}
+
+.markdown-body .py-0 {
+  padding-top: 0 !important;
+  padding-bottom: 0 !important;
+}
+
+.markdown-body .pl-1 {
+  padding-left: 4px !important;
+}
+
+.markdown-body .pl-2 {
+  padding-left: 8px !important;
+}
+
+.markdown-body .py-2 {
+  padding-top: 8px !important;
+  padding-bottom: 8px !important;
+}
+
+.markdown-body .pl-3 {
+  padding-left: 16px !important;
+}
+
+.markdown-body .pl-4 {
+  padding-left: 24px !important;
+}
+
+.markdown-body .pl-5 {
+  padding-left: 32px !important;
+}
+
+.markdown-body .pl-6 {
+  padding-left: 40px !important;
+}
+
+.markdown-body .pl-7 {
+  padding-left: 48px !important;
+}
+
+.markdown-body .pl-8 {
+  padding-left: 64px !important;
+}
+
+.markdown-body .pl-9 {
+  padding-left: 80px !important;
+}
+
+.markdown-body .pl-10 {
+  padding-left: 96px !important;
+}
+
+.markdown-body .pl-11 {
+  padding-left: 112px !important;
+}
+
+.markdown-body .pl-12 {
+  padding-left: 128px !important;
+}
+
+.markdown-body hr {
+  border-bottom-color: #eee;
+}
+
+.markdown-body kbd {
+  display: inline-block;
+  padding: 3px 5px;
+  font:
+    11px SFMono-Regular,
+    Consolas,
+    Liberation Mono,
+    Menlo,
+    monospace;
+  line-height: 10px;
+  color: #444d56;
+  vertical-align: middle;
+  background-color: #fafbfc;
+  border: 1px solid #d1d5da;
+  border-radius: 3px;
+  box-shadow: inset 0 -1px 0 #d1d5da;
+}
+
+.markdown-body:after,
+.markdown-body:before {
+  display: table;
+  content: '';
+}
+
+.markdown-body:after {
+  clear: both;
+}
+
+.markdown-body > :first-child {
+  margin-top: 0 !important;
+}
+
+.markdown-body > :last-child {
+  margin-bottom: 0 !important;
+}
+
+.markdown-body a:not([href]) {
+  color: inherit;
+  text-decoration: none;
+}
+
+.markdown-body blockquote,
+.markdown-body details,
+.markdown-body dl,
+.markdown-body ol,
+.markdown-body pre,
+.markdown-body table,
+.markdown-body ul {
+  margin-top: 0;
+  margin-bottom: 16px;
+}
+
+.markdown-body hr {
+  height: 0.25em;
+  padding: 0;
+  margin: 24px 0;
+  background-color: #e1e4e8;
+  border: 0;
+}
+
+.markdown-body blockquote > :first-child {
+  margin-top: 0;
+}
+
+.markdown-body blockquote > :last-child {
+  margin-bottom: 0;
+}
+
+.markdown-body ol,
+.markdown-body ul {
+  padding-left: 1em;
+}
+
+.markdown-body ol ol,
+.markdown-body ol ul,
+.markdown-body ul ol,
+.markdown-body ul ul {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+.markdown-body li {
+  line-height: 28px;
+  font-size: 14px;
+  word-wrap: break-all;
+  list-style: disc;
+  margin-left: 10px;
+}
+
+.markdown-body li > p {
+  margin-top: 16px;
+}
+
+.markdown-body li + li {
+  margin-top: 0.25em;
+}
+
+.markdown-body dl {
+  padding: 0;
+}
+
+.markdown-body dl dt {
+  padding: 0;
+  margin-top: 16px;
+  font-size: 1em;
+  font-style: italic;
+  font-weight: 600;
+}
+
+.markdown-body dl dd {
+  padding: 0 16px;
+  margin-bottom: 16px;
+}
+
+.markdown-body table {
+  display: block;
+  width: 100%;
+  overflow: auto;
+}
+
+.markdown-body table th {
+  font-weight: 600;
+}
+
+.markdown-body table td,
+.markdown-body table th {
+  padding: 6px 13px;
+  border: 1px solid #dfe2e5;
+}
+
+.markdown-body table tr {
+  background-color: #fff;
+  border-top: 1px solid #c6cbd1;
+}
+
+.markdown-body table tr:nth-child(2n) {
+  background-color: #f6f8fa;
+}
+
+.markdown-body img {
+  max-width: 100%;
+  box-sizing: initial;
+  background-color: #fff;
+  border: 1px solid #eee;
+  border: 1px solid var(--art-c-border-2);
+  cursor: zoom-in;
+}
+
+.markdown-body img[align='right'] {
+  padding-left: 20px;
+}
+
+.markdown-body img[align='left'] {
+  padding-right: 20px;
+}
+
+.markdown-body code {
+  padding: 0.2em 0.4em;
+  margin: 0;
+  font-size: 85%;
+  background-color: rgba(27, 31, 35, 0.05);
+  border-radius: 3px;
+}
+
+.markdown-body pre {
+  word-wrap: normal;
+}
+
+.markdown-body pre > code {
+  padding: 0;
+  margin: 0;
+  font-size: 100%;
+  word-break: normal;
+  white-space: pre;
+  background: transparent;
+  border: 0;
+}
+
+.markdown-body .highlight {
+  margin-bottom: 16px;
+}
+
+.markdown-body .highlight pre {
+  margin-bottom: 0;
+  word-break: normal;
+}
+
+.markdown-body .highlight pre,
+.markdown-body pre {
+  padding: 15px 20px 15px 0;
+  overflow: auto;
+  font-size: 92%;
+  line-height: 1.6;
+}
+
+.markdown-body pre code {
+  display: inline;
+  max-width: auto;
+  padding: 0;
+  margin: 0;
+  overflow: visible;
+  line-height: inherit;
+  word-wrap: normal;
+  background-color: initial;
+  border: 0;
+}
+
+.markdown-body .commit-tease-sha {
+  display: inline-block;
+  font-size: 90%;
+  color: #444d56;
+}
+
+.markdown-body .full-commit .btn-outline:not(:disabled):hover {
+  color: #005cc5;
+  border-color: #005cc5;
+}
+
+.markdown-body .blob-wrapper {
+  overflow-x: auto;
+  overflow-y: hidden;
+}
+
+.markdown-body .blob-wrapper-embedded {
+  max-height: 240px;
+  overflow-y: auto;
+}
+
+.markdown-body .blob-num {
+  width: 1%;
+  min-width: 50px;
+  padding-right: 10px;
+  padding-left: 10px;
+  font-size: 12px;
+  line-height: 20px;
+  color: rgba(27, 31, 35, 0.3);
+  text-align: right;
+  white-space: nowrap;
+  vertical-align: top;
+  cursor: pointer;
+  -webkit-user-select: none;
+  -moz-user-select: none;
+  -ms-user-select: none;
+  user-select: none;
+}
+
+.markdown-body .blob-num:hover {
+  color: rgba(27, 31, 35, 0.6);
+}
+
+.markdown-body .blob-num:before {
+  content: attr(data-line-number);
+}
+
+.markdown-body .blob-code {
+  position: relative;
+  padding-right: 10px;
+  padding-left: 10px;
+  line-height: 20px;
+  vertical-align: top;
+}
+
+.markdown-body .blob-code-inner {
+  overflow: visible;
+  font-size: 12px;
+  color: $font-color;
+  word-wrap: normal;
+  white-space: pre;
+}
+
+.markdown-body .pl-token.active,
+.markdown-body .pl-token:hover {
+  cursor: pointer;
+  background: #ffea7f;
+}
+
+.markdown-body .tab-size[data-tab-size='1'] {
+  -moz-tab-size: 1;
+  tab-size: 1;
+}
+
+.markdown-body .tab-size[data-tab-size='2'] {
+  -moz-tab-size: 2;
+  tab-size: 2;
+}
+
+.markdown-body .tab-size[data-tab-size='3'] {
+  -moz-tab-size: 3;
+  tab-size: 3;
+}
+
+.markdown-body .tab-size[data-tab-size='4'] {
+  -moz-tab-size: 4;
+  tab-size: 4;
+}
+
+.markdown-body .tab-size[data-tab-size='5'] {
+  -moz-tab-size: 5;
+  tab-size: 5;
+}
+
+.markdown-body .tab-size[data-tab-size='6'] {
+  -moz-tab-size: 6;
+  tab-size: 6;
+}
+
+.markdown-body .tab-size[data-tab-size='7'] {
+  -moz-tab-size: 7;
+  tab-size: 7;
+}
+
+.markdown-body .tab-size[data-tab-size='8'] {
+  -moz-tab-size: 8;
+  tab-size: 8;
+}
+
+.markdown-body .tab-size[data-tab-size='9'] {
+  -moz-tab-size: 9;
+  tab-size: 9;
+}
+
+.markdown-body .tab-size[data-tab-size='10'] {
+  -moz-tab-size: 10;
+  tab-size: 10;
+}
+
+.markdown-body .tab-size[data-tab-size='11'] {
+  -moz-tab-size: 11;
+  tab-size: 11;
+}
+
+.markdown-body .tab-size[data-tab-size='12'] {
+  -moz-tab-size: 12;
+  tab-size: 12;
+}
+
+.markdown-body .task-list-item {
+  list-style-type: none;
+}
+
+.markdown-body .task-list-item + .task-list-item {
+  margin-top: 3px;
+}
+
+.markdown-body .task-list-item input {
+  margin: 0 0.2em 0.25em -1.6em;
+  vertical-align: middle;
+}
diff --git a/web/src/assets/styles/core/mixin.scss b/web/src/assets/styles/core/mixin.scss
new file mode 100755
index 0000000..db36888
--- /dev/null
+++ b/web/src/assets/styles/core/mixin.scss
@@ -0,0 +1,157 @@
+// sass 混合宏（函数）
+
+/**
+* 溢出省略号
+* @param {Number} 行数
+*/
+@mixin ellipsis($rowCount: 1) {
+  @if $rowCount <=1 {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  } @else {
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    display: -webkit-box;
+    -webkit-line-clamp: $rowCount;
+    -webkit-box-orient: vertical;
+  }
+}
+
+/**
+* 控制用户能否选中文本
+* @param {String} 类型
+*/
+@mixin userSelect($value: none) {
+  user-select: $value;
+  -moz-user-select: $value;
+  -ms-user-select: $value;
+  -webkit-user-select: $value;
+}
+
+// 绝对定位居中
+@mixin absoluteCenter() {
+  position: absolute;
+  left: 0;
+  right: 0;
+  top: 0;
+  bottom: 0;
+  margin: auto;
+}
+
+/**
+* css3动画
+* 
+*/
+@mixin animation(
+  $from: (
+    width: 0px
+  ),
+  $to: (
+    width: 100px
+  ),
+  $name: mymove,
+  $animate: mymove 2s 1 linear infinite
+) {
+  -webkit-animation: $animate;
+  -o-animation: $animate;
+  animation: $animate;
+
+  @keyframes #{$name} {
+    from {
+      @each $key, $value in $from {
+        #{$key}: #{$value};
+      }
+    }
+
+    to {
+      @each $key, $value in $to {
+        #{$key}: #{$value};
+      }
+    }
+  }
+
+  @-webkit-keyframes #{$name} {
+    from {
+      @each $key, $value in $from {
+        $key: $value;
+      }
+    }
+
+    to {
+      @each $key, $value in $to {
+        $key: $value;
+      }
+    }
+  }
+}
+
+// 圆形盒子
+@mixin circle($size: 11px, $bg: #fff) {
+  border-radius: 50%;
+  width: $size;
+  height: $size;
+  line-height: $size;
+  text-align: center;
+  background: $bg;
+}
+
+// placeholder
+@mixin placeholder($color: #bbb) {
+  // Firefox
+  &::-moz-placeholder {
+    color: $color;
+    opacity: 1;
+  }
+
+  // Internet Explorer 10+
+  &:-ms-input-placeholder {
+    color: $color;
+  }
+
+  // Safari and Chrome
+  &::-webkit-input-placeholder {
+    color: $color;
+  }
+
+  &:placeholder-shown {
+    text-overflow: ellipsis;
+  }
+}
+
+//背景透明，文字不透明。兼容IE8
+@mixin betterTransparentize($color, $alpha) {
+  $c: rgba($color, $alpha);
+  $ie_c: ie_hex_str($c);
+  background: rgba($color, 1);
+  background: $c;
+  background: transparent \9;
+  zoom: 1;
+  filter: progid:DXImageTransform.Microsoft.gradient(startColorstr=#{$ie_c}, endColorstr=#{$ie_c});
+  -ms-filter: 'progid:DXImageTransform.Microsoft.gradient(startColorstr=#{$ie_c}, endColorstr=#{$ie_c})';
+}
+
+//添加浏览器前缀
+@mixin browserPrefix($propertyName, $value) {
+  @each $prefix in -webkit-, -moz-, -ms-, -o-, '' {
+    #{$prefix}#{$propertyName}: $value;
+  }
+}
+
+// 边框
+@mixin border($color: red) {
+  border: 1px solid $color;
+}
+
+// 背景滤镜
+@mixin backdropBlur() {
+  --tw-backdrop-blur: blur(30px);
+  -webkit-backdrop-filter: var(--tw-backdrop-blur) var(--tw-backdrop-brightness)
+    var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate)
+    var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate)
+    var(--tw-backdrop-sepia);
+  backdrop-filter: var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast)
+    var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert)
+    var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia);
+}
diff --git a/web/src/assets/styles/core/reset.scss b/web/src/assets/styles/core/reset.scss
new file mode 100755
index 0000000..17a3bcf
--- /dev/null
+++ b/web/src/assets/styles/core/reset.scss
@@ -0,0 +1,41 @@
+@charset "UTF-8";
+
+/*滚动条*/
+/*滚动条整体部分,必须要设置*/
+::-webkit-scrollbar {
+  width: 8px !important;
+  height: 0 !important;
+}
+
+/*滚动条的轨道*/
+::-webkit-scrollbar-track {
+  background-color: var(--art-gray-200);
+}
+
+/*滚动条的滑块按钮*/
+::-webkit-scrollbar-thumb {
+  border-radius: 5px;
+  background-color: #cccccc !important;
+  transition: all 0.2s;
+  -webkit-transition: all 0.2s;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background-color: #b0abab !important;
+}
+
+/*滚动条的上下两端的按钮*/
+::-webkit-scrollbar-button {
+  height: 0px;
+  width: 0;
+}
+
+.dark {
+  ::-webkit-scrollbar-track {
+    background-color: var(--default-bg-color);
+  }
+
+  ::-webkit-scrollbar-thumb {
+    background-color: var(--art-gray-300) !important;
+  }
+}
diff --git a/web/src/assets/styles/core/router-transition.scss b/web/src/assets/styles/core/router-transition.scss
new file mode 100644
index 0000000..f47c741
--- /dev/null
+++ b/web/src/assets/styles/core/router-transition.scss
@@ -0,0 +1,104 @@
+@use 'sass:map';
+
+// === 变量区域 ===
+$transition: (
+  // 动画持续时间
+  duration: 0.25s,
+  // 滑动动画的移动距离
+  distance: 15px,
+  // 默认缓动函数
+  easing: cubic-bezier(0.25, 0.1, 0.25, 1),
+  // 淡入淡出专用的缓动函数
+  fade-easing: cubic-bezier(0.4, 0, 0.6, 1)
+);
+
+// 抽取配置值函数，提高可复用性
+@function transition-config($key) {
+  @return map.get($transition, $key);
+}
+
+// 变量简写
+$duration: transition-config('duration');
+$distance: transition-config('distance');
+$easing: transition-config('easing');
+$fade-easing: transition-config('fade-easing');
+
+// === 动画类 ===
+
+// 淡入淡出动画
+.fade {
+  &-enter-active,
+  &-leave-active {
+    transition: opacity $duration $fade-easing;
+    will-change: opacity;
+  }
+
+  &-enter-from,
+  &-leave-to {
+    opacity: 0;
+  }
+
+  &-enter-to,
+  &-leave-from {
+    opacity: 1;
+  }
+}
+
+// 滑动动画通用样式
+@mixin slide-transition($direction) {
+  $distance-x: 0;
+  $distance-y: 0;
+
+  @if $direction == 'left' {
+    $distance-x: -$distance;
+  } @else if $direction == 'right' {
+    $distance-x: $distance;
+  } @else if $direction == 'top' {
+    $distance-y: -$distance;
+  } @else if $direction == 'bottom' {
+    $distance-y: $distance;
+  }
+
+  &-enter-active {
+    transition:
+      opacity $duration $easing,
+      transform $duration $easing;
+    will-change: opacity, transform;
+  }
+
+  &-leave-active {
+    transition:
+      opacity calc($duration * 0.7) $easing,
+      transform calc($duration * 0.7) $easing;
+    will-change: opacity, transform;
+  }
+
+  &-enter-from {
+    opacity: 0;
+    transform: translate3d($distance-x, $distance-y, 0);
+  }
+
+  &-enter-to {
+    opacity: 1;
+    transform: translate3d(0, 0, 0);
+  }
+
+  &-leave-to {
+    opacity: 0;
+    transform: translate3d(-$distance-x, -$distance-y, 0);
+  }
+}
+
+// 滑动动画方向类
+.slide-left {
+  @include slide-transition('left');
+}
+.slide-right {
+  @include slide-transition('right');
+}
+.slide-top {
+  @include slide-transition('top');
+}
+.slide-bottom {
+  @include slide-transition('bottom');
+}
diff --git a/web/src/assets/styles/core/tailwind.css b/web/src/assets/styles/core/tailwind.css
new file mode 100644
index 0000000..1a9e22c
--- /dev/null
+++ b/web/src/assets/styles/core/tailwind.css
@@ -0,0 +1,208 @@
+@import 'tailwindcss';
+@custom-variant dark (&:where(.dark, .dark *));
+
+/* ==================== Light Mode Variables ==================== */
+:root {
+  /* Base Colors */
+  --art-color: #ffffff;
+  --theme-color: var(--main-color);
+
+  /* Theme Colors - OKLCH Format */
+  --art-primary: oklch(0.7 0.23 260);
+  --art-secondary: oklch(0.72 0.19 231.6);
+  --art-error: oklch(0.73 0.15 25.3);
+  --art-info: oklch(0.58 0.03 254.1);
+  --art-success: oklch(0.78 0.17 166.1);
+  --art-warning: oklch(0.78 0.14 75.5);
+  --art-danger: oklch(0.68 0.22 25.3);
+
+  /* Gray Scale - Light Mode */
+  --art-gray-100: #f9fafb;
+  --art-gray-200: #f2f4f5;
+  --art-gray-300: #e6eaeb;
+  --art-gray-400: #dbdfe1;
+  --art-gray-500: #949eb7;
+  --art-gray-600: #7987a1;
+  --art-gray-700: #4d5875;
+  --art-gray-800: #383853;
+  --art-gray-900: #323251;
+
+  /* Border Colors */
+  --art-card-border: rgba(0, 0, 0, 0.08);
+
+  --default-border: #e2e8ee;
+  --default-border-dashed: #dbdfe9;
+
+  /* Background Colors */
+  --default-bg-color: #fafbfc;
+  --default-box-color: #ffffff;
+
+  /* Hover Color */
+  --art-hover-color: #edeff0;
+
+  /* Active Color */
+  --art-active-color: #f2f4f5;
+
+  /* Element Component Active Color */
+  --art-el-active-color: #f2f4f5;
+}
+
+/* ==================== Dark Mode Variables ==================== */
+.dark {
+  /* Base Colors */
+  --art-color: #000000;
+
+  /* Gray Scale - Dark Mode */
+  --art-gray-100: #110f0f;
+  --art-gray-200: #17171c;
+  --art-gray-300: #393946;
+  --art-gray-400: #505062;
+  --art-gray-500: #73738c;
+  --art-gray-600: #8f8fa3;
+  --art-gray-700: #ababba;
+  --art-gray-800: #c7c7d1;
+  --art-gray-900: #e3e3e8;
+
+  /* Border Colors */
+  --art-card-border: rgba(255, 255, 255, 0.08);
+
+  --default-border: rgba(255, 255, 255, 0.1);
+  --default-border-dashed: #363843;
+
+  /* Background Colors */
+  --default-bg-color: #070707;
+  --default-box-color: #161618;
+
+  /* Hover Color */
+  --art-hover-color: #252530;
+
+  /* Active Color */
+  --art-active-color: #202226;
+
+  /* Element Component Active Color */
+  --art-el-active-color: #2e2e38;
+}
+
+/* ==================== Tailwind Theme Configuration ==================== */
+@theme {
+  /* Box Color (Light: white / Dark: black) */
+  --color-box: var(--default-box-color);
+
+  /* System Theme Color */
+  --color-theme: var(--theme-color);
+
+  /* Hover Color */
+  --color-hover-color: var(--art-hover-color);
+
+  /* Active Color */
+  --color-active-color: var(--art-active-color);
+
+  /* Active Color */
+  --color-el-active-color: var(--art-active-color);
+
+  /* ElementPlus Theme Colors */
+  --color-primary: var(--art-primary);
+  --color-secondary: var(--art-secondary);
+  --color-error: var(--art-error);
+  --color-info: var(--art-info);
+  --color-success: var(--art-success);
+  --color-warning: var(--art-warning);
+  --color-danger: var(--art-danger);
+
+  /* Gray Scale Colors (Auto-adapts to dark mode) */
+  --color-g-100: var(--art-gray-100);
+  --color-g-200: var(--art-gray-200);
+  --color-g-300: var(--art-gray-300);
+  --color-g-400: var(--art-gray-400);
+  --color-g-500: var(--art-gray-500);
+  --color-g-600: var(--art-gray-600);
+  --color-g-700: var(--art-gray-700);
+  --color-g-800: var(--art-gray-800);
+  --color-g-900: var(--art-gray-900);
+}
+
+/* ==================== Custom Border Radius Utilities ==================== */
+@utility rounded-custom-xs {
+  border-radius: calc(var(--custom-radius) / 2);
+}
+
+@utility rounded-custom-sm {
+  border-radius: calc(var(--custom-radius) / 2 + 2px);
+}
+
+/* ==================== Custom Utility Classes ==================== */
+@layer utilities {
+  /* Flexbox Layout Utilities */
+  .flex-c {
+    @apply flex items-center;
+  }
+
+  .flex-b {
+    @apply flex justify-between;
+  }
+
+  .flex-cc {
+    @apply flex items-center justify-center;
+  }
+
+  .flex-cb {
+    @apply flex items-center justify-between;
+  }
+
+  /* Transition Utilities */
+  .tad-200 {
+    @apply transition-all duration-200;
+  }
+
+  .tad-300 {
+    @apply transition-all duration-300;
+  }
+
+  /* Border Utilities */
+  .border-full-d {
+    @apply border border-[var(--default-border)];
+  }
+
+  .border-b-d {
+    @apply border-b border-[var(--default-border)];
+  }
+
+  .border-t-d {
+    @apply border-t border-[var(--default-border)];
+  }
+
+  .border-l-d {
+    @apply border-l border-[var(--default-border)];
+  }
+
+  .border-r-d {
+    @apply border-r border-[var(--default-border)];
+  }
+
+  /* Cursor Utilities */
+  .c-p {
+    @apply cursor-pointer;
+  }
+}
+
+/* ==================== Custom Component Classes ==================== */
+@layer components {
+  /* Art Card Header Component */
+  .art-card-header {
+    @apply flex justify-between pr-6 pb-1;
+
+    .title {
+      h4 {
+        @apply text-lg font-medium text-g-900;
+      }
+
+      p {
+        @apply mt-1 text-sm text-g-600;
+
+        span {
+          @apply ml-2 font-medium;
+        }
+      }
+    }
+  }
+}
diff --git a/web/src/assets/styles/core/theme-animation.scss b/web/src/assets/styles/core/theme-animation.scss
new file mode 100644
index 0000000..377b945
--- /dev/null
+++ b/web/src/assets/styles/core/theme-animation.scss
@@ -0,0 +1,63 @@
+// 定义基础变量
+$bg-animation-color-light: #000;
+$bg-animation-color-dark: #fff;
+$bg-animation-duration: 0.5s;
+
+html {
+  --bg-animation-color: $bg-animation-color-light;
+
+  &.dark {
+    --bg-animation-color: $bg-animation-color-dark;
+  }
+
+  // View transition styles
+  &::view-transition-old(*) {
+    animation: none;
+  }
+
+  &::view-transition-new(*) {
+    animation: clip $bg-animation-duration ease-in both;
+  }
+
+  &::view-transition-old(root) {
+    z-index: 1;
+  }
+
+  &::view-transition-new(root) {
+    z-index: 9999;
+  }
+
+  &.dark {
+    &::view-transition-old(*) {
+      animation: clip $bg-animation-duration ease-in reverse both;
+    }
+
+    &::view-transition-new(*) {
+      animation: none;
+    }
+
+    &::view-transition-old(root) {
+      z-index: 9999;
+    }
+
+    &::view-transition-new(root) {
+      z-index: 1;
+    }
+  }
+}
+
+// 定义动画
+@keyframes clip {
+  from {
+    clip-path: circle(0% at var(--x) var(--y));
+  }
+
+  to {
+    clip-path: circle(var(--r) at var(--x) var(--y));
+  }
+}
+
+// body 相关样式
+body {
+  background-color: var(--bg-animation-color);
+}
diff --git a/web/src/assets/styles/core/theme-change.scss b/web/src/assets/styles/core/theme-change.scss
new file mode 100755
index 0000000..5b640d2
--- /dev/null
+++ b/web/src/assets/styles/core/theme-change.scss
@@ -0,0 +1,11 @@
+// 主题切换过渡优化，优化除视觉上的不适感
+.theme-change {
+  * {
+    transition: 0s !important;
+  }
+
+  .el-switch__core,
+  .el-switch__action {
+    transition: all 0.3s !important;
+  }
+}
diff --git a/web/src/assets/styles/custom/one-dark-pro.scss b/web/src/assets/styles/custom/one-dark-pro.scss
new file mode 100644
index 0000000..36bdf63
--- /dev/null
+++ b/web/src/assets/styles/custom/one-dark-pro.scss
@@ -0,0 +1,98 @@
+.hljs {
+  display: block;
+  overflow-x: auto;
+  padding: 0.5em;
+
+  color: #a6accd;
+}
+
+.hljs-string,
+.hljs-section,
+.hljs-selector-class,
+.hljs-template-variable,
+.hljs-deletion {
+  color: #aed07e !important;
+}
+
+.hljs-comment,
+.hljs-quote {
+  color: #6f747d;
+}
+
+.hljs-doctag,
+.hljs-keyword,
+.hljs-formula {
+  color: #c792ea;
+}
+
+.hljs-section,
+.hljs-name,
+.hljs-selector-tag,
+.hljs-deletion,
+.hljs-subst {
+  color: #c86068;
+}
+
+.hljs-literal {
+  color: #56b6c2;
+}
+
+.hljs-string,
+.hljs-regexp,
+.hljs-addition,
+.hljs-attribute,
+.hljs-meta-string {
+  color: #abb2bf;
+}
+
+.hljs-attribute {
+  color: #c792ea;
+}
+
+.hljs-function {
+  color: #c792ea;
+}
+
+.hljs-type {
+  color: #f07178;
+}
+
+.hljs-title {
+  color: #82aaff !important;
+}
+
+.hljs-built_in,
+.hljs-class {
+  color: #82aaff;
+}
+
+// 括号
+.hljs-params {
+  color: #a6accd;
+}
+
+.hljs-attr,
+.hljs-variable,
+.hljs-template-variable,
+.hljs-selector-class,
+.hljs-selector-attr,
+.hljs-selector-pseudo,
+.hljs-number {
+  color: #de7e61;
+}
+
+.hljs-symbol,
+.hljs-bullet,
+.hljs-link,
+.hljs-meta,
+.hljs-selector-id {
+  color: #61aeee;
+}
+
+.hljs-strong {
+  font-weight: bold;
+}
+
+.hljs-link {
+  text-decoration: underline;
+}
diff --git a/web/src/assets/styles/index.scss b/web/src/assets/styles/index.scss
new file mode 100644
index 0000000..cdc2ddc
--- /dev/null
+++ b/web/src/assets/styles/index.scss
@@ -0,0 +1,23 @@
+// 重置默认样式
+@use './core/reset.scss';
+
+// 应用全局样式
+@use './core/app.scss';
+
+// Element Plus 样式优化
+@use './core/el-ui.scss';
+
+// Element Plus 暗黑主题
+@use './core/el-dark.scss';
+
+// 暗黑主题样式优化
+@use './core/dark.scss';
+
+// 路由切换动画
+@use './core/router-transition';
+
+// 主题切换过渡优化
+@use './core/theme-change.scss';
+
+// 主题切换圆形扩散动画
+@use './core/theme-animation.scss';
diff --git a/web/src/assets/svg/loading.ts b/web/src/assets/svg/loading.ts
new file mode 100644
index 0000000..fdfb078
--- /dev/null
+++ b/web/src/assets/svg/loading.ts
@@ -0,0 +1,32 @@
+// 自定义四点旋转SVG
+export const fourDotsSpinnerSvg = `
+  <svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40">
+    <style>
+      .spinner {
+        transform-origin: 20px 20px;
+        animation: rotate 1.6s linear infinite;
+      }
+      .dot {
+        fill: var(--theme-color);
+        animation: fade 1.6s infinite;
+      }
+      .dot:nth-child(1) { animation-delay: 0s; }
+      .dot:nth-child(2) { animation-delay: 0.5s; }
+      .dot:nth-child(3) { animation-delay: 1s; }
+      .dot:nth-child(4) { animation-delay: 1.5s; }
+      @keyframes rotate {
+        100% { transform: rotate(360deg); }
+      }
+      @keyframes fade {
+        0%, 100% { opacity: 1; }
+        50% { opacity: 0.5; }
+      }
+    </style>
+    <g class="spinner">
+      <circle class="dot" cx="20" cy="8" r="4"/>
+      <circle class="dot" cx="32" cy="20" r="4"/>
+      <circle class="dot" cx="20" cy="32" r="4"/>
+      <circle class="dot" cx="8" cy="20" r="4"/>
+    </g>
+  </svg>
+`
diff --git a/web/src/components/core/banners/art-basic-banner/index.vue b/web/src/components/core/banners/art-basic-banner/index.vue
new file mode 100644
index 0000000..65b47e4
--- /dev/null
+++ b/web/src/components/core/banners/art-basic-banner/index.vue
@@ -0,0 +1,343 @@
+<!-- 基础横幅组件 -->
+<template>
+  <div
+    class="art-card basic-banner"
+    :class="[{ 'has-decoration': decoration }, boxStyle]"
+    :style="{ height }"
+    @click="emit('click')"
+  >
+    <!-- 流星效果 -->
+    <div v-if="meteorConfig?.enabled && isDark" class="basic-banner__meteors">
+      <span
+        v-for="(meteor, index) in meteors"
+        :key="index"
+        class="meteor"
+        :style="{
+          top: '-60px',
+          left: `${meteor.x}%`,
+          animationDuration: `${meteor.speed}s`,
+          animationDelay: `${meteor.delay}s`
+        }"
+      ></span>
+    </div>
+
+    <div class="basic-banner__content">
+      <!-- title slot -->
+      <slot name="title">
+        <p v-if="title" class="basic-banner__title" :style="{ color: titleColor }">{{ title }}</p>
+      </slot>
+
+      <!-- subtitle slot -->
+      <slot name="subtitle">
+        <p v-if="subtitle" class="basic-banner__subtitle" :style="{ color: subtitleColor }">{{
+          subtitle
+        }}</p>
+      </slot>
+
+      <!-- button slot -->
+      <slot name="button">
+        <div
+          v-if="buttonConfig?.show"
+          class="basic-banner__button"
+          :style="{
+            backgroundColor: buttonColor,
+            color: buttonTextColor,
+            borderRadius: buttonRadius
+          }"
+          @click.stop="emit('buttonClick')"
+        >
+          {{ buttonConfig?.text }}
+        </div>
+      </slot>
+
+      <!-- default slot -->
+      <slot></slot>
+
+      <!-- background image -->
+      <img
+        v-if="imageConfig.src"
+        class="basic-banner__background-image"
+        :src="imageConfig.src"
+        :style="{ width: imageConfig.width, bottom: imageConfig.bottom, right: imageConfig.right }"
+        loading="lazy"
+        alt="背景图片"
+      />
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { onMounted, ref, computed } from 'vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  const settingStore = useSettingStore()
+  const { isDark } = storeToRefs(settingStore)
+
+  defineOptions({ name: 'ArtBasicBanner' })
+
+  // 流星对象接口定义
+  interface Meteor {
+    /** 流星的水平位置(百分比) */
+    x: number
+    /** 流星划过的速度 */
+    speed: number
+    /** 流星出现的延迟时间 */
+    delay: number
+  }
+
+  // 按钮配置接口定义
+  interface ButtonConfig {
+    /** 是否启用按钮 */
+    show: boolean
+    /** 按钮文本 */
+    text: string
+    /** 按钮背景色 */
+    color?: string
+    /** 按钮文字颜色 */
+    textColor?: string
+    /** 按钮圆角大小 */
+    radius?: string
+  }
+
+  // 流星效果配置接口定义
+  interface MeteorConfig {
+    /** 是否启用流星效果 */
+    enabled: boolean
+    /** 流星数量 */
+    count?: number
+  }
+
+  // 背景图片配置接口定义
+  interface ImageConfig {
+    /** 图片源地址 */
+    src: string
+    /** 图片宽度 */
+    width?: string
+    /** 距底部距离 */
+    bottom?: string
+    /** 距右侧距离 */
+    right?: string // 距右侧距离
+  }
+
+  // 组件属性接口定义
+  interface Props {
+    /** 横幅高度 */
+    height?: string
+    /** 标题文本 */
+    title?: string
+    /** 副标题文本 */
+    subtitle?: string
+    /** 盒子样式 */
+    boxStyle?: string
+    /** 是否显示装饰效果 */
+    decoration?: boolean
+    /** 按钮配置 */
+    buttonConfig?: ButtonConfig
+    /** 流星配置 */
+    meteorConfig?: MeteorConfig
+    /** 图片配置 */
+    imageConfig?: ImageConfig
+    /** 标题颜色 */
+    titleColor?: string
+    /** 副标题颜色 */
+    subtitleColor?: string
+  }
+
+  // 组件属性默认值设置
+  const props = withDefaults(defineProps<Props>(), {
+    height: '11rem',
+    titleColor: 'white',
+    subtitleColor: 'white',
+    boxStyle: '!bg-theme/60',
+    decoration: true,
+    buttonConfig: () => ({
+      show: true,
+      text: '查看',
+      color: '#fff',
+      textColor: '#333',
+      radius: '6px'
+    }),
+    meteorConfig: () => ({ enabled: false, count: 10 }),
+    imageConfig: () => ({ src: '', width: '12rem', bottom: '-3rem', right: '0' })
+  })
+
+  // 定义组件事件
+  const emit = defineEmits<{
+    (e: 'click'): void // 整体点击事件
+    (e: 'buttonClick'): void // 按钮点击事件
+  }>()
+
+  // 计算按钮样式属性
+  const buttonColor = computed(() => props.buttonConfig?.color ?? '#fff')
+  const buttonTextColor = computed(() => props.buttonConfig?.textColor ?? '#333')
+  const buttonRadius = computed(() => props.buttonConfig?.radius ?? '6px')
+
+  // 流星数据初始化
+  const meteors = ref<Meteor[]>([])
+  onMounted(() => {
+    if (props.meteorConfig?.enabled) {
+      meteors.value = generateMeteors(props.meteorConfig?.count ?? 10)
+    }
+  })
+
+  /**
+   * 生成流星数据数组
+   * @param count 流星数量
+   * @returns 流星数据数组
+   */
+  function generateMeteors(count: number): Meteor[] {
+    // 计算每个流星的区域宽度
+    const segmentWidth = 100 / count
+    return Array.from({ length: count }, (_, index) => {
+      // 计算流星起始位置
+      const segmentStart = index * segmentWidth
+      // 在区域内随机生成x坐标
+      const x = segmentStart + Math.random() * segmentWidth
+      // 随机决定流星速度快慢
+      const isSlow = Math.random() > 0.5
+      return {
+        x,
+        speed: isSlow ? 5 + Math.random() * 3 : 2 + Math.random() * 2,
+        delay: Math.random() * 5
+      }
+    })
+  }
+</script>
+
+<style lang="scss" scoped>
+  .basic-banner {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    padding: 0 2rem;
+    overflow: hidden;
+    color: white;
+    border-radius: calc(var(--custom-radius) + 2px) !important;
+
+    &__content {
+      position: relative;
+      z-index: 1;
+    }
+
+    &__title {
+      margin: 0 0 0.5rem;
+      font-size: 1.5rem;
+      font-weight: 600;
+    }
+
+    &__subtitle {
+      position: relative;
+      z-index: 10;
+      margin: 0 0 1.5rem;
+      font-size: 0.9rem;
+      opacity: 0.9;
+    }
+
+    &__button {
+      box-sizing: border-box;
+      display: inline-block;
+      min-width: 80px;
+      height: var(--el-component-custom-height);
+      padding: 0 12px;
+      font-size: 14px;
+      line-height: var(--el-component-custom-height);
+      text-align: center;
+      cursor: pointer;
+      user-select: none;
+      transition: all 0.3s;
+
+      &:hover {
+        opacity: 0.8;
+      }
+    }
+
+    &__background-image {
+      position: absolute;
+      right: 0;
+      bottom: -3rem;
+      z-index: 0;
+      width: 12rem;
+    }
+
+    &.has-decoration::after {
+      position: absolute;
+      right: -10%;
+      bottom: -20%;
+      width: 60%;
+      height: 140%;
+      content: '';
+      background: rgb(255 255 255 / 10%);
+      border-radius: 30%;
+      transform: rotate(-20deg);
+    }
+
+    &__meteors {
+      position: absolute;
+      top: 0;
+      left: 0;
+      z-index: 0;
+      width: 100%;
+      height: 100%;
+      pointer-events: none;
+
+      .meteor {
+        position: absolute;
+        width: 2px;
+        height: 60px;
+        background: linear-gradient(
+          to top,
+          rgb(255 255 255 / 40%),
+          rgb(255 255 255 / 10%),
+          transparent
+        );
+        opacity: 0;
+        transform-origin: top left;
+        animation-name: meteor-fall;
+        animation-timing-function: linear;
+        animation-iteration-count: infinite;
+
+        &::before {
+          position: absolute;
+          right: 0;
+          bottom: 0;
+          width: 2px;
+          height: 2px;
+          content: '';
+          background: rgb(255 255 255 / 50%);
+        }
+      }
+    }
+  }
+
+  @keyframes meteor-fall {
+    0% {
+      opacity: 1;
+      transform: translate(0, -60px) rotate(-45deg);
+    }
+
+    100% {
+      opacity: 0;
+      transform: translate(400px, 340px) rotate(-45deg);
+    }
+  }
+
+  @media (width <= 640px) {
+    .basic-banner {
+      box-sizing: border-box;
+      justify-content: flex-start;
+      padding: 16px;
+
+      &__title {
+        font-size: 1.4rem;
+      }
+
+      &__background-image {
+        display: none;
+      }
+
+      &.has-decoration::after {
+        display: none;
+      }
+    }
+  }
+</style>
diff --git a/web/src/components/core/banners/art-card-banner/index.vue b/web/src/components/core/banners/art-card-banner/index.vue
new file mode 100644
index 0000000..8a5f9d4
--- /dev/null
+++ b/web/src/components/core/banners/art-card-banner/index.vue
@@ -0,0 +1,114 @@
+<!-- 卡片横幅组件 -->
+<template>
+  <div class="art-card-sm flex-c flex-col pb-6" :style="{ height: height }">
+    <div class="flex-c flex-col gap-4 text-center">
+      <div class="w-45">
+        <img :src="image" :alt="title" class="w-full h-full object-contain" />
+      </div>
+      <div class="box-border px-4">
+        <p class="mb-2 text-lg font-semibold text-g-800">{{ title }}</p>
+        <p class="m-0 text-sm text-g-600">{{ description }}</p>
+      </div>
+      <div class="flex-c gap-3">
+        <div
+          v-if="cancelButton?.show"
+          class="inline-block h-9 px-3 text-sm/9 c-p select-none rounded-md border border-g-300"
+          :style="{
+            backgroundColor: cancelButton?.color,
+            color: cancelButton?.textColor
+          }"
+          @click="handleCancel"
+        >
+          {{ cancelButton?.text }}
+        </div>
+        <div
+          v-if="button?.show"
+          class="inline-block h-9 px-3 text-sm/9 c-p select-none rounded-md"
+          :style="{ backgroundColor: button?.color, color: button?.textColor }"
+          @click="handleClick"
+        >
+          {{ button?.text }}
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  // 导入默认图标
+  import defaultIcon from '@imgs/3d/icon1.webp'
+
+  defineOptions({ name: 'ArtCardBanner' })
+
+  // 定义卡片横幅组件的属性接口
+  interface CardBannerProps {
+    /** 高度 */
+    height?: string
+    /** 图片路径 */
+    image?: string
+    /** 标题文本 */
+    title: string
+    /** 描述文本 */
+    description: string
+    /** 主按钮配置 */
+    button?: {
+      /** 是否显示 */
+      show?: boolean
+      /** 按钮文本 */
+      text?: string
+      /** 背景颜色 */
+      color?: string
+      /** 文字颜色 */
+      textColor?: string
+    }
+    /** 取消按钮配置 */
+    cancelButton?: {
+      /** 是否显示 */
+      show?: boolean
+      /** 按钮文本 */
+      text?: string
+      /** 背景颜色 */
+      color?: string
+      /** 文字颜色 */
+      textColor?: string
+    }
+  }
+
+  // 定义组件属性默认值
+  withDefaults(defineProps<CardBannerProps>(), {
+    height: '24rem',
+    image: defaultIcon,
+    title: '',
+    description: '',
+    // 主按钮默认配置
+    button: () => ({
+      show: true,
+      text: '查看详情',
+      color: 'var(--theme-color)',
+      textColor: '#fff'
+    }),
+    // 取消按钮默认配置
+    cancelButton: () => ({
+      show: false,
+      text: '取消',
+      color: '#f5f5f5',
+      textColor: '#666'
+    })
+  })
+
+  // 定义组件事件
+  const emit = defineEmits<{
+    (e: 'click'): void // 主按钮点击事件
+    (e: 'cancel'): void // 取消按钮点击事件
+  }>()
+
+  // 主按钮点击处理函数
+  const handleClick = () => {
+    emit('click')
+  }
+
+  // 取消按钮点击处理函数
+  const handleCancel = () => {
+    emit('cancel')
+  }
+</script>
diff --git a/web/src/components/core/base/art-back-to-top/index.vue b/web/src/components/core/base/art-back-to-top/index.vue
new file mode 100644
index 0000000..6f8da61
--- /dev/null
+++ b/web/src/components/core/base/art-back-to-top/index.vue
@@ -0,0 +1,40 @@
+<!-- 返回顶部按钮 -->
+<template>
+  <Transition
+    enter-active-class="tad-300 ease-out"
+    leave-active-class="tad-200 ease-in"
+    enter-from-class="opacity-0 translate-y-2"
+    enter-to-class="opacity-100 translate-y-0"
+    leave-from-class="opacity-100 translate-y-0"
+    leave-to-class="opacity-0 translate-y-2"
+  >
+    <div
+      v-show="showButton"
+      class="fixed right-10 bottom-15 size-9.5 flex-cc c-p border border-g-300 rounded-md tad-300 hover:bg-g-200"
+      @click="scrollToTop"
+    >
+      <ArtSvgIcon icon="ri:arrow-up-wide-line" class="text-g-500 text-lg" />
+    </div>
+  </Transition>
+</template>
+
+<script setup lang="ts">
+  import { useCommon } from '@/hooks/core/useCommon'
+
+  defineOptions({ name: 'ArtBackToTop' })
+
+  const { scrollToTop } = useCommon()
+
+  const showButton = ref(false)
+  const scrollThreshold = 300
+
+  onMounted(() => {
+    const scrollContainer = document.getElementById('app-main')
+    if (scrollContainer) {
+      const { y } = useScroll(scrollContainer)
+      watch(y, (newY: number) => {
+        showButton.value = newY > scrollThreshold
+      })
+    }
+  })
+</script>
diff --git a/web/src/components/core/base/art-logo/index.vue b/web/src/components/core/base/art-logo/index.vue
new file mode 100644
index 0000000..8bc8309
--- /dev/null
+++ b/web/src/components/core/base/art-logo/index.vue
@@ -0,0 +1,21 @@
+<!-- 系统logo -->
+<template>
+  <div class="flex-cc">
+    <img :style="logoStyle" src="@imgs/common/logo.webp" alt="logo" class="w-full h-full" />
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtLogo' })
+
+  interface Props {
+    /** logo 大小 */
+    size?: number | string
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    size: 36
+  })
+
+  const logoStyle = computed(() => ({ width: `${props.size}px` }))
+</script>
diff --git a/web/src/components/core/base/art-svg-icon/index.vue b/web/src/components/core/base/art-svg-icon/index.vue
new file mode 100644
index 0000000..0bfcd0c
--- /dev/null
+++ b/web/src/components/core/base/art-svg-icon/index.vue
@@ -0,0 +1,24 @@
+<!-- 图标组件 -->
+<template>
+  <Icon v-if="icon" :icon="icon" v-bind="bindAttrs" class="art-svg-icon inline" />
+</template>
+
+<script setup lang="ts">
+  import { Icon } from '@iconify/vue'
+
+  defineOptions({ name: 'ArtSvgIcon', inheritAttrs: false })
+
+  interface Props {
+    /** Iconify icon name */
+    icon?: string
+  }
+
+  defineProps<Props>()
+
+  const attrs = useAttrs()
+
+  const bindAttrs = computed<{ class: string; style: string }>(() => ({
+    class: (attrs.class as string) || '',
+    style: (attrs.style as string) || ''
+  }))
+</script>
diff --git a/web/src/components/core/cards/art-bar-chart-card/index.vue b/web/src/components/core/cards/art-bar-chart-card/index.vue
new file mode 100644
index 0000000..6815c2b
--- /dev/null
+++ b/web/src/components/core/cards/art-bar-chart-card/index.vue
@@ -0,0 +1,103 @@
+<!-- 柱状图卡片 -->
+<template>
+  <div class="art-card relative overflow-hidden" :style="{ height: `${height}rem` }">
+    <div class="mb-5 flex-b items-start px-5 pt-5">
+      <div>
+        <p class="m-0 text-2xl font-medium leading-tight text-g-900">
+          {{ value }}
+        </p>
+        <p class="mt-1 text-sm text-g-600">{{ label }}</p>
+      </div>
+      <div
+        class="text-sm font-medium text-danger"
+        :class="[percentage > 0 ? 'text-success' : '', isMiniChart ? 'absolute bottom-5' : '']"
+      >
+        {{ percentage > 0 ? '+' : '' }}{{ percentage }}%
+      </div>
+      <div v-if="date" class="absolute bottom-5 right-5 text-xs text-g-600">
+        {{ date }}
+      </div>
+    </div>
+    <div
+      ref="chartRef"
+      class="absolute bottom-0 left-0 right-0 mx-auto"
+      :class="isMiniChart ? '!absolute !top-5 !right-5 !bottom-auto !left-auto !h-15 !w-4/10' : ''"
+      :style="{ height: isMiniChart ? '60px' : `calc(${height}rem - 5rem)` }"
+    ></div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import { type EChartsOption } from '@/plugins/echarts'
+
+  defineOptions({ name: 'ArtBarChartCard' })
+
+  interface Props {
+    /** 数值 */
+    value: number
+    /** 标签 */
+    label: string
+    /** 百分比 +（绿色）-（红色） */
+    percentage: number
+    /** 日期 */
+    date?: string
+    /** 高度 */
+    height?: number
+    /** 颜色 */
+    color?: string
+    /** 图表数据 */
+    chartData: number[]
+    /** 柱状图宽度 */
+    barWidth?: string
+    /** 是否为迷你图表 */
+    isMiniChart?: boolean
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    height: 11,
+    barWidth: '26%'
+  })
+
+  // 使用新的图表组件抽象
+  const { chartRef } = useChartComponent({
+    props: {
+      height: `${props.height}rem`,
+      loading: false,
+      isEmpty: !props.chartData?.length || props.chartData.every((val) => val === 0)
+    },
+    checkEmpty: () => !props.chartData?.length || props.chartData.every((val) => val === 0),
+    watchSources: [() => props.chartData, () => props.color, () => props.barWidth],
+    generateOptions: (): EChartsOption => {
+      const computedColor = props.color || useChartOps().themeColor
+
+      return {
+        grid: {
+          top: 0,
+          right: 0,
+          bottom: 15,
+          left: 0
+        },
+        xAxis: {
+          type: 'category',
+          show: false
+        },
+        yAxis: {
+          type: 'value',
+          show: false
+        },
+        series: [
+          {
+            data: props.chartData,
+            type: 'bar',
+            barWidth: props.barWidth,
+            itemStyle: {
+              color: computedColor,
+              borderRadius: 2
+            }
+          }
+        ]
+      }
+    }
+  })
+</script>
diff --git a/web/src/components/core/cards/art-data-list-card/index.vue b/web/src/components/core/cards/art-data-list-card/index.vue
new file mode 100644
index 0000000..fc43323
--- /dev/null
+++ b/web/src/components/core/cards/art-data-list-card/index.vue
@@ -0,0 +1,74 @@
+<!-- 数据列表卡片 -->
+<template>
+  <div class="art-card p-5">
+    <div class="pb-3.5">
+      <p class="text-lg font-medium">{{ title }}</p>
+      <p class="text-sm text-g-600">{{ subtitle }}</p>
+    </div>
+    <ElScrollbar :style="{ height: maxHeight }">
+      <div v-for="(item, index) in list" :key="index" class="flex-c py-3">
+        <div v-if="item.icon" class="flex-cc mr-3 size-10 rounded-lg" :class="item.class">
+          <ArtSvgIcon :icon="item.icon" class="text-xl" />
+        </div>
+        <div class="flex-1">
+          <div class="mb-1 text-sm">{{ item.title }}</div>
+          <div class="text-xs text-g-500">{{ item.status }}</div>
+        </div>
+        <div class="ml-3 text-xs text-g-500">{{ item.time }}</div>
+      </div>
+    </ElScrollbar>
+    <ElButton
+      class="mt-[25px] w-full text-center"
+      v-if="showMoreButton"
+      v-ripple
+      @click="handleMore"
+      >查看更多</ElButton
+    >
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtDataListCard' })
+
+  interface Props {
+    /** 数据列表 */
+    list: Activity[]
+    /** 标题 */
+    title: string
+    /** 副标题 */
+    subtitle?: string
+    /** 最大显示数量 */
+    maxCount?: number
+    /** 是否显示更多按钮 */
+    showMoreButton?: boolean
+  }
+
+  interface Activity {
+    /** 标题 */
+    title: string
+    /** 状态 */
+    status: string
+    /** 时间 */
+    time: string
+    /** 样式类名 */
+    class: string
+    /** 图标 */
+    icon: string
+  }
+
+  const ITEM_HEIGHT = 66
+  const DEFAULT_MAX_COUNT = 5
+
+  const props = withDefaults(defineProps<Props>(), {
+    maxCount: DEFAULT_MAX_COUNT
+  })
+
+  const maxHeight = computed(() => `${ITEM_HEIGHT * props.maxCount}px`)
+
+  const emit = defineEmits<{
+    /** 点击更多按钮事件 */
+    (e: 'more'): void
+  }>()
+
+  const handleMore = () => emit('more')
+</script>
diff --git a/web/src/components/core/cards/art-donut-chart-card/index.vue b/web/src/components/core/cards/art-donut-chart-card/index.vue
new file mode 100644
index 0000000..df2dcbb
--- /dev/null
+++ b/web/src/components/core/cards/art-donut-chart-card/index.vue
@@ -0,0 +1,124 @@
+<!-- 环型图卡片 -->
+<template>
+  <div class="art-card overflow-hidden" :style="{ height: `${height}rem` }">
+    <div class="flex box-border h-full p-5 pr-2">
+      <div class="flex w-full items-start gap-5">
+        <div class="flex-b h-full flex-1 flex-col">
+          <p class="m-0 text-xl font-medium leading-tight text-g-900">
+            {{ title }}
+          </p>
+          <div>
+            <p class="m-0 mt-2.5 text-xl font-medium leading-tight text-g-900">
+              {{ formatNumber(value) }}
+            </p>
+            <div
+              class="mt-1.5 text-xs font-medium"
+              :class="percentage > 0 ? 'text-success' : 'text-danger'"
+            >
+              {{ percentage > 0 ? '+' : '' }}{{ percentage }}%
+              <span v-if="percentageLabel">{{ percentageLabel }}</span>
+            </div>
+          </div>
+          <div class="mt-2 flex gap-4 text-xs text-g-600">
+            <div v-if="currentValue" class="flex-cc">
+              <div class="size-2 bg-theme/100 rounded mr-2"></div>
+              {{ currentValue }}
+            </div>
+            <div v-if="previousValue" class="flex-cc">
+              <div class="size-2 bg-g-400 rounded mr-2"></div>
+              {{ previousValue }}
+            </div>
+          </div>
+        </div>
+        <div class="flex-c h-full max-w-40 flex-1">
+          <div ref="chartRef" class="h-30 w-full"></div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { type EChartsOption } from '@/plugins/echarts'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+
+  defineOptions({ name: 'ArtDonutChartCard' })
+
+  interface Props {
+    /** 数值 */
+    value: number
+    /** 标题 */
+    title: string
+    /** 百分比 */
+    percentage: number
+    /** 百分比标签 */
+    percentageLabel?: string
+    /** 当前年份 */
+    currentValue?: string
+    /** 去年年份 */
+    previousValue?: string
+    /** 高度 */
+    height?: number
+    /** 颜色 */
+    color?: string
+    /** 半径 */
+    radius?: [string, string]
+    /** 数据 */
+    data: [number, number]
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    height: 9,
+    radius: () => ['70%', '90%'],
+    data: () => [0, 0]
+  })
+
+  const formatNumber = (num: number) => {
+    return num.toLocaleString()
+  }
+
+  // 使用新的图表组件抽象
+  const { chartRef } = useChartComponent({
+    props: {
+      height: `${props.height}rem`,
+      loading: false,
+      isEmpty: props.data.every((val) => val === 0)
+    },
+    checkEmpty: () => props.data.every((val) => val === 0),
+    watchSources: [
+      () => props.data,
+      () => props.color,
+      () => props.radius,
+      () => props.currentValue,
+      () => props.previousValue
+    ],
+    generateOptions: (): EChartsOption => {
+      const computedColor = props.color || useChartOps().themeColor
+
+      return {
+        series: [
+          {
+            type: 'pie',
+            radius: props.radius,
+            avoidLabelOverlap: false,
+            label: {
+              show: false
+            },
+            data: [
+              {
+                value: props.data[0],
+                name: props.currentValue,
+                itemStyle: { color: computedColor }
+              },
+              {
+                value: props.data[1],
+                name: props.previousValue,
+                itemStyle: { color: '#e6e8f7' }
+              }
+            ]
+          }
+        ]
+      }
+    }
+  })
+</script>
diff --git a/web/src/components/core/cards/art-image-card/index.vue b/web/src/components/core/cards/art-image-card/index.vue
new file mode 100644
index 0000000..d27fe00
--- /dev/null
+++ b/web/src/components/core/cards/art-image-card/index.vue
@@ -0,0 +1,89 @@
+<!-- 图片卡片 -->
+<template>
+  <div class="w-full c-p" @click="handleClick">
+    <div class="art-card overflow-hidden">
+      <div class="relative w-full aspect-[16/10] overflow-hidden">
+        <ElImage
+          :src="props.imageUrl"
+          fit="cover"
+          loading="lazy"
+          class="w-full h-full transition-transform duration-300 ease-in-out hover:scale-105"
+        >
+          <template #placeholder>
+            <div class="flex-cc w-full h-full bg-[#f5f7fa]">
+              <ElIcon><Picture /></ElIcon>
+            </div>
+          </template>
+        </ElImage>
+        <div
+          class="absolute right-3.5 bottom-3.5 py-1 px-2 text-xs bg-g-200 rounded"
+          v-if="props.readTime"
+        >
+          {{ props.readTime }} 阅读
+        </div>
+      </div>
+
+      <div class="p-4">
+        <div
+          class="inline-block py-0.5 px-2 mb-2 text-xs bg-g-300/70 rounded"
+          v-if="props.category"
+        >
+          {{ props.category }}
+        </div>
+        <p class="m-0 mb-3 text-base font-medium">{{ props.title }}</p>
+        <div class="flex-c gap-4 text-xs text-g-600">
+          <span class="flex-c gap-1" v-if="props.views">
+            <ElIcon class="text-base"><View /></ElIcon>
+            {{ props.views }}
+          </span>
+          <span class="flex-c gap-1" v-if="props.comments">
+            <ElIcon class="text-base"><ChatLineRound /></ElIcon>
+            {{ props.comments }}
+          </span>
+          <span>{{ props.date }}</span>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Picture, View, ChatLineRound } from '@element-plus/icons-vue'
+
+  defineOptions({ name: 'ArtImageCard' })
+
+  interface Props {
+    /** 图片地址 */
+    imageUrl: string
+    /** 标题 */
+    title: string
+    /** 分类 */
+    category?: string
+    /** 阅读时间 */
+    readTime?: string
+    /** 浏览量 */
+    views?: number
+    /** 评论数 */
+    comments?: number
+    /** 日期 */
+    date?: string
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    imageUrl: '',
+    title: '',
+    category: '',
+    readTime: '',
+    views: 0,
+    comments: 0,
+    date: ''
+  })
+
+  const emit = defineEmits<{
+    (e: 'click', card: Props): void
+  }>()
+
+  const handleClick = () => {
+    emit('click', props)
+  }
+</script>
diff --git a/web/src/components/core/cards/art-line-chart-card/index.vue b/web/src/components/core/cards/art-line-chart-card/index.vue
new file mode 100644
index 0000000..e58c9b2
--- /dev/null
+++ b/web/src/components/core/cards/art-line-chart-card/index.vue
@@ -0,0 +1,126 @@
+<!-- 折线图卡片 -->
+<template>
+  <div class="art-card relative overflow-hidden" :style="{ height: `${height}rem` }">
+    <div class="mb-2.5 flex-b items-start p-5">
+      <div>
+        <p class="text-2xl font-medium leading-none">
+          {{ value }}
+        </p>
+        <p class="mt-1 text-sm text-g-500">{{ label }}</p>
+      </div>
+      <div
+        class="text-sm font-medium"
+        :class="[
+          percentage > 0 ? 'text-success' : 'text-danger',
+          isMiniChart ? 'absolute bottom-5' : ''
+        ]"
+      >
+        {{ percentage > 0 ? '+' : '' }}{{ percentage }}%
+      </div>
+      <div v-if="date" class="absolute bottom-5 right-5 text-xs text-g-500">
+        {{ date }}
+      </div>
+    </div>
+    <div
+      ref="chartRef"
+      class="absolute bottom-0 left-0 right-0 box-border w-full"
+      :class="isMiniChart ? '!absolute !top-5 !right-5 !bottom-auto !left-auto !h-15 !w-4/10' : ''"
+      :style="{ height: isMiniChart ? '60px' : `calc(${height}rem - 5rem)` }"
+    ></div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { graphic, type EChartsOption } from '@/plugins/echarts'
+  import { getCssVar, hexToRgba } from '@/utils/ui'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+
+  defineOptions({ name: 'ArtLineChartCard' })
+
+  interface Props {
+    /** 数值 */
+    value: number
+    /** 标签 */
+    label: string
+    /** 百分比 */
+    percentage: number
+    /** 日期 */
+    date?: string
+    /** 高度 */
+    height?: number
+    /** 颜色 */
+    color?: string
+    /** 是否显示区域颜色 */
+    showAreaColor?: boolean
+    /** 图表数据 */
+    chartData: number[]
+    /** 是否为迷你图表 */
+    isMiniChart?: boolean
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    height: 11
+  })
+
+  // 使用新的图表组件抽象
+  const { chartRef } = useChartComponent({
+    props: {
+      height: `${props.height}rem`,
+      loading: false,
+      isEmpty: !props.chartData?.length || props.chartData.every((val) => val === 0)
+    },
+    checkEmpty: () => !props.chartData?.length || props.chartData.every((val) => val === 0),
+    watchSources: [() => props.chartData, () => props.color, () => props.showAreaColor],
+    generateOptions: (): EChartsOption => {
+      const computedColor = props.color || useChartOps().themeColor
+
+      return {
+        grid: {
+          top: 0,
+          right: 0,
+          bottom: 0,
+          left: 0
+        },
+        xAxis: {
+          type: 'category',
+          show: false,
+          boundaryGap: false
+        },
+        yAxis: {
+          type: 'value',
+          show: false
+        },
+        series: [
+          {
+            data: props.chartData,
+            type: 'line',
+            smooth: true,
+            showSymbol: false,
+            lineStyle: {
+              width: 3,
+              color: computedColor
+            },
+            areaStyle: props.showAreaColor
+              ? {
+                  color: new graphic.LinearGradient(0, 0, 0, 1, [
+                    {
+                      offset: 0,
+                      color: props.color
+                        ? hexToRgba(props.color, 0.2).rgba
+                        : hexToRgba(getCssVar('--el-color-primary'), 0.2).rgba
+                    },
+                    {
+                      offset: 1,
+                      color: props.color
+                        ? hexToRgba(props.color, 0.01).rgba
+                        : hexToRgba(getCssVar('--el-color-primary'), 0.01).rgba
+                    }
+                  ])
+                }
+              : undefined
+          }
+        ]
+      }
+    }
+  })
+</script>
diff --git a/web/src/components/core/cards/art-progress-card/index.vue b/web/src/components/core/cards/art-progress-card/index.vue
new file mode 100644
index 0000000..048a836
--- /dev/null
+++ b/web/src/components/core/cards/art-progress-card/index.vue
@@ -0,0 +1,86 @@
+<!-- 进度条卡片 -->
+<template>
+  <div class="art-card h-32 flex flex-col justify-center px-5">
+    <div class="mb-3.5 flex-c" :style="{ justifyContent: icon ? 'space-between' : 'flex-start' }">
+      <div v-if="icon" class="size-11 flex-cc bg-g-300 text-xl rounded-lg" :class="iconStyle">
+        <ArtSvgIcon :icon="icon" class="text-2xl"></ArtSvgIcon>
+      </div>
+      <div>
+        <ArtCountTo
+          class="mb-1 block text-2xl font-semibold"
+          :target="percentage"
+          :duration="2000"
+          suffix="%"
+          :style="{ textAlign: icon ? 'right' : 'left' }"
+        />
+        <p class="text-sm text-g-500">{{ title }}</p>
+      </div>
+    </div>
+    <ElProgress
+      :percentage="currentPercentage"
+      :stroke-width="strokeWidth"
+      :show-text="false"
+      :color="color"
+      class="[&_.el-progress-bar__outer]:bg-[rgb(240_240_240)]"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtProgressCard' })
+
+  interface Props {
+    /** 进度百分比 */
+    percentage: number
+    /** 标题 */
+    title: string
+    /** 颜色 */
+    color?: string
+    /** 图标 */
+    icon?: string
+    /** 图标样式 */
+    iconStyle?: string
+    /** 进度条宽度 */
+    strokeWidth?: number
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    strokeWidth: 5,
+    color: '#67C23A'
+  })
+
+  const animationDuration = 500
+  const currentPercentage = ref(0)
+
+  const animateProgress = () => {
+    const startTime = Date.now()
+    const startValue = currentPercentage.value
+    const endValue = props.percentage
+
+    const animate = () => {
+      const currentTime = Date.now()
+      const elapsed = currentTime - startTime
+      const progress = Math.min(elapsed / animationDuration, 1)
+
+      currentPercentage.value = startValue + (endValue - startValue) * progress
+
+      if (progress < 1) {
+        requestAnimationFrame(animate)
+      }
+    }
+
+    requestAnimationFrame(animate)
+  }
+
+  onMounted(() => {
+    animateProgress()
+  })
+
+  // 当 percentage 属性变化时重新执行动画
+  watch(
+    () => props.percentage,
+    () => {
+      animateProgress()
+    }
+  )
+</script>
diff --git a/web/src/components/core/cards/art-stats-card/index.vue b/web/src/components/core/cards/art-stats-card/index.vue
new file mode 100644
index 0000000..8e0341b
--- /dev/null
+++ b/web/src/components/core/cards/art-stats-card/index.vue
@@ -0,0 +1,67 @@
+<!-- 统计卡片 -->
+<template>
+  <div
+    class="art-card h-32 flex-c px-5 transition-transform duration-200 hover:-translate-y-0.5"
+    :class="boxStyle"
+  >
+    <div v-if="icon" class="mr-4 size-11 flex-cc rounded-lg text-xl text-white" :class="iconStyle">
+      <ArtSvgIcon :icon="icon"></ArtSvgIcon>
+    </div>
+    <div class="flex-1">
+      <p class="m-0 text-lg font-medium" :style="{ color: textColor }" v-if="title">
+        {{ title }}
+      </p>
+      <ArtCountTo
+        class="m-0 text-2xl font-medium"
+        v-if="count !== undefined"
+        :target="count"
+        :duration="2000"
+        :decimals="decimals"
+        :separator="separator"
+      />
+      <p
+        class="mt-1 text-sm text-g-500 opacity-90"
+        :style="{ color: textColor }"
+        v-if="description"
+        >{{ description }}</p
+      >
+    </div>
+    <div v-if="showArrow">
+      <ArtSvgIcon icon="ri:arrow-right-s-line" class="text-xl text-g-500" />
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtStatsCard' })
+
+  interface StatsCardProps {
+    /** 盒子样式 */
+    boxStyle?: string
+    /** 图标 */
+    icon?: string
+    /** 图标样式 */
+    iconStyle?: string
+    /** 标题 */
+    title?: string
+    /** 数值 */
+    count?: number
+    /** 小数位 */
+    decimals?: number
+    /** 分隔符 */
+    separator?: string
+    /** 描述 */
+    description: string
+    /** 文本颜色 */
+    textColor?: string
+    /** 是否显示箭头 */
+    showArrow?: boolean
+  }
+
+  withDefaults(defineProps<StatsCardProps>(), {
+    iconSize: 30,
+    iconBgRadius: 50,
+    decimals: 0,
+    separator: ','
+  })
+</script>
diff --git a/web/src/components/core/cards/art-timeline-list-card/index.vue b/web/src/components/core/cards/art-timeline-list-card/index.vue
new file mode 100644
index 0000000..fbb2c78
--- /dev/null
+++ b/web/src/components/core/cards/art-timeline-list-card/index.vue
@@ -0,0 +1,69 @@
+<!-- 时间轴列表卡片 -->
+<template>
+  <div class="art-card p-5">
+    <div class="pb-3.5">
+      <p class="text-lg font-medium">{{ title }}</p>
+      <p class="text-sm text-g-600">{{ subtitle }}</p>
+    </div>
+    <ElScrollbar :style="{ height: maxHeight }">
+      <ElTimeline class="!pl-0.5">
+        <ElTimelineItem
+          v-for="item in list"
+          :key="item.time"
+          :timestamp="item.time"
+          :placement="TIMELINE_PLACEMENT"
+          :color="item.status"
+          :center="true"
+        >
+          <div class="flex-c gap-3">
+            <div class="flex-c gap-2">
+              <span class="text-sm">{{ item.content }}</span>
+              <span v-if="item.code" class="text-sm text-theme"> #{{ item.code }} </span>
+            </div>
+          </div>
+        </ElTimelineItem>
+      </ElTimeline>
+    </ElScrollbar>
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtTimelineListCard' })
+
+  // 常量配置
+  const ITEM_HEIGHT = 65
+  const TIMELINE_PLACEMENT = 'top'
+  const DEFAULT_MAX_COUNT = 5
+
+  interface TimelineItem {
+    /** 时间 */
+    time: string
+    /** 状态颜色 */
+    status: string
+    /** 内容 */
+    content: string
+    /** 代码标识 */
+    code?: string
+  }
+
+  interface Props {
+    /** 时间轴列表数据 */
+    list: TimelineItem[]
+    /** 标题 */
+    title: string
+    /** 副标题 */
+    subtitle?: string
+    /** 最大显示数量 */
+    maxCount?: number
+  }
+
+  // Props 定义和验证
+  const props = withDefaults(defineProps<Props>(), {
+    title: '',
+    subtitle: '',
+    maxCount: DEFAULT_MAX_COUNT
+  })
+
+  // 计算最大高度
+  const maxHeight = computed(() => `${ITEM_HEIGHT * props.maxCount}px`)
+</script>
diff --git a/web/src/components/core/charts/art-bar-chart/index.vue b/web/src/components/core/charts/art-bar-chart/index.vue
new file mode 100644
index 0000000..d677196
--- /dev/null
+++ b/web/src/components/core/charts/art-bar-chart/index.vue
@@ -0,0 +1,203 @@
+<!-- 柱状图 -->
+<template>
+  <div ref="chartRef" :style="{ height: props.height }" v-loading="props.loading"> </div>
+</template>
+
+<script setup lang="ts">
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import { getCssVar } from '@/utils/ui'
+  import { graphic, type EChartsOption } from '@/plugins/echarts'
+  import type { BarChartProps, BarDataItem } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtBarChart' })
+
+  const props = withDefaults(defineProps<BarChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+    borderRadius: 4,
+
+    // 数据配置
+    data: () => [0, 0, 0, 0, 0, 0, 0],
+    xAxisData: () => [],
+    barWidth: '40%',
+    stack: false,
+
+    // 轴线显示配置
+    showAxisLabel: true,
+    showAxisLine: true,
+    showSplitLine: true,
+
+    // 交互配置
+    showTooltip: true,
+    showLegend: false,
+    legendPosition: 'bottom'
+  })
+
+  // 判断是否为多数据
+  const isMultipleData = computed(() => {
+    return (
+      Array.isArray(props.data) &&
+      props.data.length > 0 &&
+      typeof props.data[0] === 'object' &&
+      'name' in props.data[0]
+    )
+  })
+
+  // 获取颜色配置
+  const getColor = (customColor?: string, index?: number) => {
+    if (customColor) return customColor
+
+    if (index !== undefined) {
+      return props.colors![index % props.colors!.length]
+    }
+
+    // 默认渐变色
+    return new graphic.LinearGradient(0, 0, 0, 1, [
+      {
+        offset: 0,
+        color: getCssVar('--el-color-primary-light-4')
+      },
+      {
+        offset: 1,
+        color: getCssVar('--el-color-primary')
+      }
+    ])
+  }
+
+  // 创建渐变色
+  const createGradientColor = (color: string) => {
+    return new graphic.LinearGradient(0, 0, 0, 1, [
+      {
+        offset: 0,
+        color: color
+      },
+      {
+        offset: 1,
+        color: color
+      }
+    ])
+  }
+
+  // 获取基础样式配置
+  const getBaseItemStyle = (
+    color: string | InstanceType<typeof graphic.LinearGradient> | undefined
+  ) => ({
+    borderRadius: props.borderRadius,
+    color: typeof color === 'string' ? createGradientColor(color) : color
+  })
+
+  // 创建系列配置
+  const createSeriesItem = (config: {
+    name?: string
+    data: number[]
+    color?: string | InstanceType<typeof graphic.LinearGradient>
+    barWidth?: string | number
+    stack?: string
+  }) => {
+    const animationConfig = getAnimationConfig()
+
+    return {
+      name: config.name,
+      data: config.data,
+      type: 'bar' as const,
+      stack: config.stack,
+      itemStyle: getBaseItemStyle(config.color),
+      barWidth: config.barWidth || props.barWidth,
+      ...animationConfig
+    }
+  }
+
+  // 使用新的图表组件抽象
+  const {
+    chartRef,
+    getAxisLineStyle,
+    getAxisLabelStyle,
+    getAxisTickStyle,
+    getSplitLineStyle,
+    getAnimationConfig,
+    getTooltipStyle,
+    getLegendStyle,
+    getGridWithLegend
+  } = useChartComponent({
+    props,
+    checkEmpty: () => {
+      // 检查单数据情况
+      if (Array.isArray(props.data) && typeof props.data[0] === 'number') {
+        const singleData = props.data as number[]
+        return !singleData.length || singleData.every((val) => val === 0)
+      }
+
+      // 检查多数据情况
+      if (Array.isArray(props.data) && typeof props.data[0] === 'object') {
+        const multiData = props.data as BarDataItem[]
+        return (
+          !multiData.length ||
+          multiData.every((item) => !item.data?.length || item.data.every((val) => val === 0))
+        )
+      }
+
+      return true
+    },
+    watchSources: [() => props.data, () => props.xAxisData, () => props.colors],
+    generateOptions: (): EChartsOption => {
+      const options: EChartsOption = {
+        grid: getGridWithLegend(props.showLegend && isMultipleData.value, props.legendPosition, {
+          top: 15,
+          right: 0,
+          left: 0
+        }),
+        tooltip: props.showTooltip ? getTooltipStyle() : undefined,
+        xAxis: {
+          type: 'category',
+          data: props.xAxisData,
+          axisTick: getAxisTickStyle(),
+          axisLine: getAxisLineStyle(props.showAxisLine),
+          axisLabel: getAxisLabelStyle(props.showAxisLabel)
+        },
+        yAxis: {
+          type: 'value',
+          axisLabel: getAxisLabelStyle(props.showAxisLabel),
+          axisLine: getAxisLineStyle(props.showAxisLine),
+          splitLine: getSplitLineStyle(props.showSplitLine)
+        }
+      }
+
+      // 添加图例配置
+      if (props.showLegend && isMultipleData.value) {
+        options.legend = getLegendStyle(props.legendPosition)
+      }
+
+      // 生成系列数据
+      if (isMultipleData.value) {
+        const multiData = props.data as BarDataItem[]
+        options.series = multiData.map((item, index) => {
+          const computedColor = getColor(props.colors[index], index)
+
+          return createSeriesItem({
+            name: item.name,
+            data: item.data,
+            color: computedColor,
+            barWidth: item.barWidth,
+            stack: props.stack ? item.stack || 'total' : undefined
+          })
+        })
+      } else {
+        // 单数据情况
+        const singleData = props.data as number[]
+        const computedColor = getColor()
+
+        options.series = [
+          createSeriesItem({
+            data: singleData,
+            color: computedColor
+          })
+        ]
+      }
+
+      return options
+    }
+  })
+</script>
diff --git a/web/src/components/core/charts/art-dual-bar-compare-chart/index.vue b/web/src/components/core/charts/art-dual-bar-compare-chart/index.vue
new file mode 100644
index 0000000..32aa60f
--- /dev/null
+++ b/web/src/components/core/charts/art-dual-bar-compare-chart/index.vue
@@ -0,0 +1,195 @@
+<!-- 双向堆叠柱状图 -->
+<template>
+  <div ref="chartRef" :style="{ height: props.height }" v-loading="props.loading"> </div>
+</template>
+
+<script setup lang="ts">
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import type { EChartsOption, BarSeriesOption } from '@/plugins/echarts'
+  import type { BidirectionalBarChartProps } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtDualBarCompareChart' })
+
+  const props = withDefaults(defineProps<BidirectionalBarChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+
+    // 数据配置
+    positiveData: () => [],
+    negativeData: () => [],
+    xAxisData: () => [],
+    positiveName: '正向数据',
+    negativeName: '负向数据',
+    barWidth: 16,
+    yAxisMin: -100,
+    yAxisMax: 100,
+
+    // 样式配置
+    showDataLabel: false,
+    positiveBorderRadius: () => [10, 10, 0, 0],
+    negativeBorderRadius: () => [0, 0, 10, 10],
+
+    // 轴线显示配置
+    showAxisLabel: true,
+    showAxisLine: false,
+    showSplitLine: false,
+
+    // 交互配置
+    showTooltip: true,
+    showLegend: false,
+    legendPosition: 'bottom'
+  })
+
+  // 创建系列配置的辅助函数
+  const createSeriesConfig = (config: {
+    name: string
+    data: number[]
+    borderRadius: number | number[]
+    labelPosition: 'top' | 'bottom'
+    colorIndex: number
+    formatter?: (params: unknown) => string
+  }): BarSeriesOption => {
+    const { fontColor } = useChartOps()
+    const animationConfig = getAnimationConfig()
+
+    return {
+      name: config.name,
+      type: 'bar',
+      stack: 'total',
+      barWidth: props.barWidth,
+      barGap: '-100%',
+      data: config.data,
+      itemStyle: {
+        borderRadius: config.borderRadius,
+        color: props.colors[config.colorIndex]
+      },
+      label: {
+        show: props.showDataLabel,
+        position: config.labelPosition,
+        formatter:
+          config.formatter ||
+          ((params: unknown) => String((params as Record<string, unknown>).value)),
+        color: fontColor,
+        fontSize: 12
+      },
+      ...animationConfig
+    }
+  }
+
+  // 使用图表组件抽象
+  const {
+    chartRef,
+    getAxisLineStyle,
+    getAxisLabelStyle,
+    getAxisTickStyle,
+    getSplitLineStyle,
+    getAnimationConfig,
+    getTooltipStyle,
+    getLegendStyle,
+    getGridWithLegend
+  } = useChartComponent({
+    props,
+    checkEmpty: () => {
+      return (
+        props.isEmpty ||
+        !props.positiveData.length ||
+        !props.negativeData.length ||
+        (props.positiveData.every((val) => val === 0) &&
+          props.negativeData.every((val) => val === 0))
+      )
+    },
+    watchSources: [
+      () => props.positiveData,
+      () => props.negativeData,
+      () => props.xAxisData,
+      () => props.colors
+    ],
+    generateOptions: (): EChartsOption => {
+      // 处理负向数据，确保为负值
+      const processedNegativeData = props.negativeData.map((val) => (val > 0 ? -val : val))
+
+      // 优化的Grid配置
+      const gridConfig = {
+        top: props.showLegend ? 50 : 20,
+        right: 0,
+        left: 0,
+        bottom: 0, // 增加底部间距
+        containLabel: true
+      }
+
+      const options: EChartsOption = {
+        backgroundColor: 'transparent',
+        animation: true,
+        animationDuration: 1000,
+        animationEasing: 'cubicOut',
+        grid: getGridWithLegend(props.showLegend, props.legendPosition, gridConfig),
+
+        // 优化的提示框配置
+        tooltip: props.showTooltip
+          ? {
+              ...getTooltipStyle(),
+              trigger: 'axis',
+              axisPointer: {
+                type: 'none' // 去除指示线
+              }
+            }
+          : undefined,
+
+        // 图例配置
+        legend: props.showLegend
+          ? {
+              ...getLegendStyle(props.legendPosition),
+              data: [props.negativeName, props.positiveName]
+            }
+          : undefined,
+
+        // X轴配置
+        xAxis: {
+          type: 'category',
+          data: props.xAxisData,
+          axisTick: getAxisTickStyle(),
+          axisLine: getAxisLineStyle(props.showAxisLine),
+          axisLabel: getAxisLabelStyle(props.showAxisLabel),
+          boundaryGap: true
+        },
+
+        // Y轴配置
+        yAxis: {
+          type: 'value',
+          min: props.yAxisMin,
+          max: props.yAxisMax,
+          axisLabel: getAxisLabelStyle(props.showAxisLabel),
+          axisLine: getAxisLineStyle(props.showAxisLine),
+          splitLine: getSplitLineStyle(props.showSplitLine)
+        },
+
+        // 系列配置
+        series: [
+          // 负向数据系列
+          createSeriesConfig({
+            name: props.negativeName,
+            data: processedNegativeData,
+            borderRadius: props.negativeBorderRadius,
+            labelPosition: 'bottom',
+            colorIndex: 1,
+            formatter: (params: unknown) =>
+              String(Math.abs((params as Record<string, unknown>).value as number))
+          }),
+          // 正向数据系列
+          createSeriesConfig({
+            name: props.positiveName,
+            data: props.positiveData,
+            borderRadius: props.positiveBorderRadius,
+            labelPosition: 'top',
+            colorIndex: 0
+          })
+        ]
+      }
+
+      return options
+    }
+  })
+</script>
diff --git a/web/src/components/core/charts/art-h-bar-chart/index.vue b/web/src/components/core/charts/art-h-bar-chart/index.vue
new file mode 100644
index 0000000..2e34759
--- /dev/null
+++ b/web/src/components/core/charts/art-h-bar-chart/index.vue
@@ -0,0 +1,208 @@
+<!-- 水平柱状图 -->
+<template>
+  <div
+    ref="chartRef"
+    class="relative w-full"
+    :style="{ height: props.height }"
+    v-loading="props.loading"
+  ></div>
+</template>
+
+<script setup lang="ts">
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import { getCssVar } from '@/utils/ui'
+  import { graphic, type EChartsOption } from '@/plugins/echarts'
+  import type { BarChartProps, BarDataItem } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtHBarChart' })
+
+  const props = withDefaults(defineProps<BarChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+
+    // 数据配置
+    data: () => [0, 0, 0, 0, 0, 0, 0],
+    xAxisData: () => [],
+    barWidth: '36%',
+    stack: false,
+
+    // 轴线显示配置
+    showAxisLabel: true,
+    showAxisLine: true,
+    showSplitLine: true,
+
+    // 交互配置
+    showTooltip: true,
+    showLegend: false,
+    legendPosition: 'bottom'
+  })
+
+  // 判断是否为多数据
+  const isMultipleData = computed(() => {
+    return (
+      Array.isArray(props.data) &&
+      props.data.length > 0 &&
+      typeof props.data[0] === 'object' &&
+      'name' in props.data[0]
+    )
+  })
+
+  // 获取颜色配置
+  const getColor = (customColor?: string, index?: number) => {
+    if (customColor) return customColor
+
+    if (index !== undefined) {
+      return props.colors![index % props.colors!.length]
+    }
+
+    // 默认渐变色
+    return new graphic.LinearGradient(0, 0, 1, 0, [
+      {
+        offset: 0,
+        color: getCssVar('--el-color-primary')
+      },
+      {
+        offset: 1,
+        color: getCssVar('--el-color-primary-light-4')
+      }
+    ])
+  }
+
+  // 创建渐变色
+  const createGradientColor = (color: string) => {
+    return new graphic.LinearGradient(0, 0, 1, 0, [
+      {
+        offset: 0,
+        color: color
+      },
+      {
+        offset: 1,
+        color: color
+      }
+    ])
+  }
+
+  // 获取基础样式配置
+  const getBaseItemStyle = (
+    color: string | InstanceType<typeof graphic.LinearGradient> | undefined
+  ) => ({
+    borderRadius: 4,
+    color: typeof color === 'string' ? createGradientColor(color) : color
+  })
+
+  // 创建系列配置
+  const createSeriesItem = (config: {
+    name?: string
+    data: number[]
+    color?: string | InstanceType<typeof graphic.LinearGradient>
+    barWidth?: string | number
+    stack?: string
+  }) => {
+    const animationConfig = getAnimationConfig()
+
+    return {
+      name: config.name,
+      data: config.data,
+      type: 'bar' as const,
+      stack: config.stack,
+      itemStyle: getBaseItemStyle(config.color),
+      barWidth: config.barWidth || props.barWidth,
+      ...animationConfig
+    }
+  }
+
+  // 使用新的图表组件抽象
+  const {
+    chartRef,
+    getAxisLineStyle,
+    getAxisLabelStyle,
+    getAxisTickStyle,
+    getSplitLineStyle,
+    getAnimationConfig,
+    getTooltipStyle,
+    getLegendStyle,
+    getGridWithLegend
+  } = useChartComponent({
+    props,
+    checkEmpty: () => {
+      // 检查单数据情况
+      if (Array.isArray(props.data) && typeof props.data[0] === 'number') {
+        const singleData = props.data as number[]
+        return !singleData.length || singleData.every((val) => val === 0)
+      }
+
+      // 检查多数据情况
+      if (Array.isArray(props.data) && typeof props.data[0] === 'object') {
+        const multiData = props.data as BarDataItem[]
+        return (
+          !multiData.length ||
+          multiData.every((item) => !item.data?.length || item.data.every((val) => val === 0))
+        )
+      }
+
+      return true
+    },
+    watchSources: [() => props.data, () => props.xAxisData, () => props.colors],
+    generateOptions: (): EChartsOption => {
+      const options: EChartsOption = {
+        grid: getGridWithLegend(props.showLegend && isMultipleData.value, props.legendPosition, {
+          top: 15,
+          right: 0,
+          left: 0
+        }),
+        tooltip: props.showTooltip ? getTooltipStyle() : undefined,
+        xAxis: {
+          type: 'value',
+          axisTick: getAxisTickStyle(),
+          axisLine: getAxisLineStyle(props.showAxisLine),
+          axisLabel: getAxisLabelStyle(props.showAxisLabel),
+          splitLine: getSplitLineStyle(props.showSplitLine)
+        },
+        yAxis: {
+          type: 'category',
+          data: props.xAxisData,
+          axisTick: getAxisTickStyle(),
+          axisLabel: getAxisLabelStyle(props.showAxisLabel),
+          axisLine: getAxisLineStyle(props.showAxisLine)
+        }
+      }
+
+      // 添加图例配置
+      if (props.showLegend && isMultipleData.value) {
+        options.legend = getLegendStyle(props.legendPosition)
+      }
+
+      // 生成系列数据
+      if (isMultipleData.value) {
+        const multiData = props.data as BarDataItem[]
+        options.series = multiData.map((item, index) => {
+          const computedColor = getColor(props.colors[index], index)
+
+          return createSeriesItem({
+            name: item.name,
+            data: item.data,
+            color: computedColor,
+            barWidth: item.barWidth,
+            stack: props.stack ? item.stack || 'total' : undefined
+          })
+        })
+      } else {
+        // 单数据情况
+        const singleData = props.data as number[]
+        const computedColor = getColor()
+
+        options.series = [
+          createSeriesItem({
+            data: singleData,
+            color: computedColor
+          })
+        ]
+      }
+
+      return options
+    }
+  })
+</script>
diff --git a/web/src/components/core/charts/art-k-line-chart/index.vue b/web/src/components/core/charts/art-k-line-chart/index.vue
new file mode 100644
index 0000000..0061b51
--- /dev/null
+++ b/web/src/components/core/charts/art-k-line-chart/index.vue
@@ -0,0 +1,152 @@
+<!-- k线图表 -->
+<template>
+  <div
+    ref="chartRef"
+    class="relative w-full"
+    :style="{ height: props.height }"
+    v-loading="props.loading"
+  ></div>
+</template>
+
+<script setup lang="ts">
+  import type { EChartsOption } from '@/plugins/echarts'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import type { KLineChartProps } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtKLineChart' })
+
+  const props = withDefaults(defineProps<KLineChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+
+    // 数据配置
+    data: () => [],
+    showDataZoom: false,
+    dataZoomStart: 0,
+    dataZoomEnd: 100
+  })
+
+  // 获取实际使用的颜色
+  const getActualColors = () => {
+    const defaultUpColor = '#4C87F3'
+    const defaultDownColor = '#8BD8FC'
+
+    return {
+      upColor: props.colors?.[0] || defaultUpColor,
+      downColor: props.colors?.[1] || defaultDownColor
+    }
+  }
+
+  // 使用新的图表组件抽象
+  const {
+    chartRef,
+    getAxisLineStyle,
+    getAxisLabelStyle,
+    getAxisTickStyle,
+    getSplitLineStyle,
+    getAnimationConfig,
+    getTooltipStyle
+  } = useChartComponent({
+    props,
+    checkEmpty: () => {
+      return (
+        !props.data?.length ||
+        props.data.every(
+          (item) => item.open === 0 && item.close === 0 && item.high === 0 && item.low === 0
+        )
+      )
+    },
+    watchSources: [
+      () => props.data,
+      () => props.colors,
+      () => props.showDataZoom,
+      () => props.dataZoomStart,
+      () => props.dataZoomEnd
+    ],
+    generateOptions: (): EChartsOption => {
+      const { upColor, downColor } = getActualColors()
+
+      return {
+        grid: {
+          top: 20,
+          right: 20,
+          bottom: props.showDataZoom ? 80 : 20,
+          left: 20,
+          containLabel: true
+        },
+        tooltip: getTooltipStyle('axis', {
+          axisPointer: {
+            type: 'cross'
+          },
+          formatter: (params: Array<{ name: string; data: number[] }>) => {
+            const param = params[0]
+            const data = param.data
+            return `
+              <div style="padding: 5px;">
+                <div><strong>时间：</strong>${param.name}</div>
+                <div><strong>开盘：</strong>${data[0]}</div>
+                <div><strong>收盘：</strong>${data[1]}</div>
+                <div><strong>最低：</strong>${data[2]}</div>
+                <div><strong>最高：</strong>${data[3]}</div>
+              </div>
+            `
+          }
+        }),
+        xAxis: {
+          type: 'category',
+          data: props.data.map((item) => item.time),
+          axisTick: getAxisTickStyle(),
+          axisLine: getAxisLineStyle(true),
+          axisLabel: getAxisLabelStyle(true)
+        },
+        yAxis: {
+          type: 'value',
+          scale: true,
+          axisLabel: getAxisLabelStyle(true),
+          axisLine: getAxisLineStyle(true),
+          splitLine: getSplitLineStyle(true)
+        },
+        series: [
+          {
+            type: 'candlestick',
+            data: props.data.map((item) => [item.open, item.close, item.low, item.high]),
+            itemStyle: {
+              color: upColor,
+              color0: downColor,
+              borderColor: upColor,
+              borderColor0: downColor,
+              borderWidth: 1
+            },
+            emphasis: {
+              itemStyle: {
+                borderWidth: 2,
+                shadowBlur: 10,
+                shadowColor: 'rgba(0, 0, 0, 0.3)'
+              }
+            },
+            ...getAnimationConfig()
+          }
+        ],
+        dataZoom: props.showDataZoom
+          ? [
+              {
+                type: 'inside',
+                start: props.dataZoomStart,
+                end: props.dataZoomEnd
+              },
+              {
+                show: true,
+                type: 'slider',
+                top: '90%',
+                start: props.dataZoomStart,
+                end: props.dataZoomEnd
+              }
+            ]
+          : undefined
+      }
+    }
+  })
+</script>
diff --git a/web/src/components/core/charts/art-line-chart/index.vue b/web/src/components/core/charts/art-line-chart/index.vue
new file mode 100644
index 0000000..b70c2c3
--- /dev/null
+++ b/web/src/components/core/charts/art-line-chart/index.vue
@@ -0,0 +1,371 @@
+<!-- 折线图，支持多组数据，支持阶梯式动画效果 -->
+<template>
+  <div
+    ref="chartRef"
+    class="relative w-[calc(100%+10px)]"
+    :style="{ height: props.height }"
+    v-loading="props.loading"
+  >
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { graphic, type EChartsOption } from '@/plugins/echarts'
+  import { getCssVar, hexToRgba } from '@/utils/ui'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import type { LineChartProps, LineDataItem } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtLineChart' })
+
+  const props = withDefaults(defineProps<LineChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+
+    // 数据配置
+    data: () => [0, 0, 0, 0, 0, 0, 0],
+    xAxisData: () => [],
+    lineWidth: 2.5,
+    showAreaColor: false,
+    smooth: true,
+    symbol: 'none',
+    symbolSize: 6,
+    animationDelay: 200,
+
+    // 轴线显示配置
+    showAxisLabel: true,
+    showAxisLine: true,
+    showSplitLine: true,
+
+    // 交互配置
+    showTooltip: true,
+    showLegend: false,
+    legendPosition: 'bottom'
+  })
+
+  // 动画状态管理
+  const isAnimating = ref(false)
+  const animationTimers = ref<number[]>([])
+  const animatedData = ref<number[] | LineDataItem[]>([])
+
+  // 清理所有定时器
+  const clearAnimationTimers = () => {
+    animationTimers.value.forEach((timer) => clearTimeout(timer))
+    animationTimers.value = []
+  }
+
+  // 判断是否为多数据（使用 VueUse 的 computedEager 优化）
+  const isMultipleData = computed(() => {
+    return (
+      Array.isArray(props.data) &&
+      props.data.length > 0 &&
+      typeof props.data[0] === 'object' &&
+      'name' in props.data[0]
+    )
+  })
+
+  // 缓存计算的最大值，避免重复计算
+  const maxValue = computed(() => {
+    if (isMultipleData.value) {
+      const multiData = props.data as LineDataItem[]
+      return multiData.reduce((max, item) => {
+        if (item.data?.length) {
+          const itemMax = Math.max(...item.data)
+          return Math.max(max, itemMax)
+        }
+        return max
+      }, 0)
+    } else {
+      const singleData = props.data as number[]
+      return singleData?.length ? Math.max(...singleData) : 0
+    }
+  })
+
+  // 初始化动画数据（优化：减少条件判断）
+  const initAnimationData = (): number[] | LineDataItem[] => {
+    if (isMultipleData.value) {
+      const multiData = props.data as LineDataItem[]
+      return multiData.map((item) => ({
+        ...item,
+        data: Array(item.data.length).fill(0)
+      }))
+    }
+    const singleData = props.data as number[]
+    return Array(singleData.length).fill(0)
+  }
+
+  // 复制真实数据（优化：使用结构化克隆）
+  const copyRealData = (): number[] | LineDataItem[] => {
+    if (isMultipleData.value) {
+      return (props.data as LineDataItem[]).map((item) => ({ ...item, data: [...item.data] }))
+    }
+    return [...(props.data as number[])]
+  }
+
+  // 获取颜色配置（优化：缓存主题色）
+  const primaryColor = computed(() => getCssVar('--el-color-primary'))
+
+  const getColor = (customColor?: string, index?: number): string => {
+    if (customColor) return customColor
+    if (index !== undefined) return props.colors![index % props.colors!.length]
+    return primaryColor.value
+  }
+
+  // 生成区域样式
+  const generateAreaStyle = (item: LineDataItem, color: string) => {
+    // 如果有 areaStyle 配置，或者显式开启了区域颜色，则显示区域样式
+    if (!item.areaStyle && !item.showAreaColor && !props.showAreaColor) return undefined
+
+    const areaConfig = item.areaStyle || {}
+    if (areaConfig.custom) return areaConfig.custom
+
+    return {
+      color: new graphic.LinearGradient(0, 0, 0, 1, [
+        {
+          offset: 0,
+          color: hexToRgba(color, areaConfig.startOpacity || 0.2).rgba
+        },
+        {
+          offset: 1,
+          color: hexToRgba(color, areaConfig.endOpacity || 0.02).rgba
+        }
+      ])
+    }
+  }
+
+  // 生成单数据区域样式
+  const generateSingleAreaStyle = () => {
+    if (!props.showAreaColor) return undefined
+
+    const color = getColor(props.colors[0])
+    return {
+      color: new graphic.LinearGradient(0, 0, 0, 1, [
+        {
+          offset: 0,
+          color: hexToRgba(color, 0.2).rgba
+        },
+        {
+          offset: 1,
+          color: hexToRgba(color, 0.02).rgba
+        }
+      ])
+    }
+  }
+
+  // 创建系列配置
+  const createSeriesItem = (config: {
+    name?: string
+    data: number[]
+    color?: string
+    smooth?: boolean
+    symbol?: string
+    symbolSize?: number
+    lineWidth?: number
+    areaStyle?: any
+  }) => {
+    return {
+      name: config.name,
+      data: config.data,
+      type: 'line' as const,
+      color: config.color,
+      smooth: config.smooth ?? props.smooth,
+      symbol: config.symbol ?? props.symbol,
+      symbolSize: config.symbolSize ?? props.symbolSize,
+      lineStyle: {
+        width: config.lineWidth ?? props.lineWidth,
+        color: config.color
+      },
+      areaStyle: config.areaStyle,
+      emphasis: {
+        focus: 'series' as const,
+        lineStyle: {
+          width: (config.lineWidth ?? props.lineWidth) + 1
+        }
+      }
+    }
+  }
+
+  // 生成图表配置
+  const generateChartOptions = (isInitial = false): EChartsOption => {
+    const options: EChartsOption = {
+      animation: true,
+      animationDuration: isInitial ? 0 : 1300,
+      animationDurationUpdate: isInitial ? 0 : 1300,
+      grid: getGridWithLegend(props.showLegend && isMultipleData.value, props.legendPosition, {
+        top: 15,
+        right: 15,
+        left: 0
+      }),
+      tooltip: props.showTooltip ? getTooltipStyle() : undefined,
+      xAxis: {
+        type: 'category',
+        boundaryGap: false,
+        data: props.xAxisData,
+        axisTick: getAxisTickStyle(),
+        axisLine: getAxisLineStyle(props.showAxisLine),
+        axisLabel: getAxisLabelStyle(props.showAxisLabel)
+      },
+      yAxis: {
+        type: 'value',
+        min: 0,
+        max: maxValue.value,
+        axisLabel: getAxisLabelStyle(props.showAxisLabel),
+        axisLine: getAxisLineStyle(props.showAxisLine),
+        splitLine: getSplitLineStyle(props.showSplitLine)
+      }
+    }
+
+    // 添加图例配置
+    if (props.showLegend && isMultipleData.value) {
+      options.legend = getLegendStyle(props.legendPosition)
+    }
+
+    // 生成系列数据
+    if (isMultipleData.value) {
+      const multiData = animatedData.value as LineDataItem[]
+      options.series = multiData.map((item, index) => {
+        const itemColor = getColor(props.colors[index], index)
+        const areaStyle = generateAreaStyle(item, itemColor)
+
+        return createSeriesItem({
+          name: item.name,
+          data: item.data,
+          color: itemColor,
+          smooth: item.smooth,
+          symbol: item.symbol,
+          lineWidth: item.lineWidth,
+          areaStyle
+        })
+      })
+    } else {
+      // 单数据情况
+      const singleData = animatedData.value as number[]
+      const computedColor = getColor(props.colors[0])
+      const areaStyle = generateSingleAreaStyle()
+
+      options.series = [
+        createSeriesItem({
+          data: singleData,
+          color: computedColor,
+          areaStyle
+        })
+      ]
+    }
+
+    return options
+  }
+
+  // 更新图表
+  const updateChartOptions = (options: EChartsOption) => {
+    initChart(options)
+  }
+
+  // 初始化动画函数（优化：统一定时器管理，减少内存泄漏风险）
+  const initChartWithAnimation = () => {
+    clearAnimationTimers()
+    isAnimating.value = true
+
+    // 初始化为0值数据
+    animatedData.value = initAnimationData()
+    updateChartOptions(generateChartOptions(true))
+
+    if (isMultipleData.value) {
+      // 多数据阶梯式动画
+      const multiData = props.data as LineDataItem[]
+      const currentAnimatedData = animatedData.value as LineDataItem[]
+
+      multiData.forEach((item, index) => {
+        const timer = window.setTimeout(
+          () => {
+            currentAnimatedData[index] = { ...item, data: [...item.data] }
+            animatedData.value = [...currentAnimatedData]
+            updateChartOptions(generateChartOptions(false))
+          },
+          index * props.animationDelay + 100
+        )
+
+        animationTimers.value.push(timer)
+      })
+
+      // 标记动画完成
+      const totalDelay = (multiData.length - 1) * props.animationDelay + 1500
+      const finishTimer = window.setTimeout(() => {
+        isAnimating.value = false
+      }, totalDelay)
+      animationTimers.value.push(finishTimer)
+    } else {
+      // 单数据简单动画 - 使用 nextTick 确保初始状态已渲染
+      nextTick(() => {
+        animatedData.value = copyRealData()
+        updateChartOptions(generateChartOptions(false))
+        isAnimating.value = false
+      })
+    }
+  }
+
+  // 空数据检查函数
+  const checkIsEmpty = () => {
+    // 检查单数据情况
+    if (Array.isArray(props.data) && typeof props.data[0] === 'number') {
+      const singleData = props.data as number[]
+      return !singleData.length || singleData.every((val) => val === 0)
+    }
+
+    // 检查多数据情况
+    if (Array.isArray(props.data) && typeof props.data[0] === 'object') {
+      const multiData = props.data as LineDataItem[]
+      return (
+        !multiData.length ||
+        multiData.every((item) => !item.data?.length || item.data.every((val) => val === 0))
+      )
+    }
+
+    return true
+  }
+
+  // 使用新的图表组件抽象
+  const {
+    chartRef,
+    initChart,
+    getAxisLineStyle,
+    getAxisLabelStyle,
+    getAxisTickStyle,
+    getSplitLineStyle,
+    getTooltipStyle,
+    getLegendStyle,
+    getGridWithLegend,
+    isEmpty
+  } = useChartComponent({
+    props,
+    checkEmpty: checkIsEmpty,
+    watchSources: [() => props.data, () => props.xAxisData, () => props.colors],
+    onVisible: () => {
+      // 当图表变为可见时，检查是否为空数据
+      if (!isEmpty.value) {
+        initChartWithAnimation()
+      }
+    },
+    generateOptions: () => generateChartOptions(false)
+  })
+
+  // 图表渲染函数（优化：防止动画期间重复触发）
+  const renderChart = () => {
+    if (!isAnimating.value && !isEmpty.value) {
+      initChartWithAnimation()
+    }
+  }
+
+  // 使用 VueUse 的 watchDebounced 优化数据监听（避免频繁更新）
+  watch([() => props.data, () => props.xAxisData, () => props.colors], renderChart, { deep: true })
+
+  // 生命周期
+  onMounted(() => {
+    renderChart()
+  })
+
+  onBeforeUnmount(() => {
+    clearAnimationTimers()
+  })
+</script>
diff --git a/web/src/components/core/charts/art-radar-chart/index.vue b/web/src/components/core/charts/art-radar-chart/index.vue
new file mode 100644
index 0000000..e99fff6
--- /dev/null
+++ b/web/src/components/core/charts/art-radar-chart/index.vue
@@ -0,0 +1,105 @@
+<!-- 雷达图 -->
+<template>
+  <div
+    ref="chartRef"
+    class="relative w-full"
+    :style="{ height: props.height }"
+    v-loading="props.loading"
+  ></div>
+</template>
+
+<script setup lang="ts">
+  import type { EChartsOption } from '@/plugins/echarts'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import type { RadarChartProps } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtRadarChart' })
+
+  const props = withDefaults(defineProps<RadarChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+
+    // 数据配置
+    indicator: () => [],
+    data: () => [],
+
+    // 交互配置
+    showTooltip: true,
+    showLegend: false,
+    legendPosition: 'bottom'
+  })
+
+  // 使用新的图表组件抽象
+  const { chartRef, isDark, getAnimationConfig, getTooltipStyle } = useChartComponent({
+    props,
+    checkEmpty: () => {
+      return !props.data?.length || props.data.every((item) => item.value.every((val) => val === 0))
+    },
+    watchSources: [() => props.data, () => props.indicator, () => props.colors],
+    generateOptions: (): EChartsOption => {
+      return {
+        tooltip: props.showTooltip ? getTooltipStyle('item') : undefined,
+        radar: {
+          indicator: props.indicator,
+          center: ['50%', '50%'],
+          radius: '70%',
+          axisName: {
+            color: isDark.value ? '#ccc' : '#666',
+            fontSize: 12
+          },
+          splitLine: {
+            lineStyle: {
+              color: isDark.value ? '#444' : '#e6e6e6'
+            }
+          },
+          axisLine: {
+            lineStyle: {
+              color: isDark.value ? '#444' : '#e6e6e6'
+            }
+          },
+          splitArea: {
+            show: true,
+            areaStyle: {
+              color: isDark.value
+                ? ['rgba(255, 255, 255, 0.02)', 'rgba(255, 255, 255, 0.05)']
+                : ['rgba(0, 0, 0, 0.02)', 'rgba(0, 0, 0, 0.05)']
+            }
+          }
+        },
+        series: [
+          {
+            type: 'radar',
+            data: props.data.map((item, index) => ({
+              name: item.name,
+              value: item.value,
+              symbolSize: 4,
+              lineStyle: {
+                width: 2,
+                color: props.colors[index % props.colors.length]
+              },
+              itemStyle: {
+                color: props.colors[index % props.colors.length]
+              },
+              areaStyle: {
+                color: props.colors[index % props.colors.length],
+                opacity: 0.1
+              },
+              emphasis: {
+                areaStyle: {
+                  opacity: 0.25
+                },
+                lineStyle: {
+                  width: 3
+                }
+              }
+            })),
+            ...getAnimationConfig(200, 1800)
+          }
+        ]
+      }
+    }
+  })
+</script>
diff --git a/web/src/components/core/charts/art-ring-chart/index.vue b/web/src/components/core/charts/art-ring-chart/index.vue
new file mode 100644
index 0000000..79115f7
--- /dev/null
+++ b/web/src/components/core/charts/art-ring-chart/index.vue
@@ -0,0 +1,133 @@
+<!-- 环形图 -->
+<template>
+  <div
+    ref="chartRef"
+    class="relative w-full"
+    :style="{ height: props.height }"
+    v-loading="props.loading"
+  >
+  </div>
+</template>
+
+<script setup lang="ts">
+  import type { EChartsOption } from '@/plugins/echarts'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import type { RingChartProps } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtRingChart' })
+
+  const props = withDefaults(defineProps<RingChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+
+    // 数据配置
+    data: () => [],
+    radius: () => ['50%', '80%'],
+    borderRadius: 10,
+    centerText: '',
+    showLabel: false,
+
+    // 交互配置
+    showTooltip: true,
+    showLegend: false,
+    legendPosition: 'right'
+  })
+
+  // 使用新的图表组件抽象
+  const { chartRef, isDark, getAnimationConfig, getTooltipStyle, getLegendStyle } =
+    useChartComponent({
+      props,
+      checkEmpty: () => {
+        return !props.data?.length || props.data.every((item) => item.value === 0)
+      },
+      watchSources: [() => props.data, () => props.centerText],
+      generateOptions: (): EChartsOption => {
+        // 根据图例位置计算环形图中心位置
+        const getCenterPosition = (): [string, string] => {
+          if (!props.showLegend) return ['50%', '50%']
+
+          switch (props.legendPosition) {
+            case 'left':
+              return ['60%', '50%']
+            case 'right':
+              return ['40%', '50%']
+            case 'top':
+              return ['50%', '60%']
+            case 'bottom':
+              return ['50%', '40%']
+            default:
+              return ['50%', '50%']
+          }
+        }
+
+        const option: EChartsOption = {
+          tooltip: props.showTooltip
+            ? getTooltipStyle('item', {
+                formatter: '{b}: {c} ({d}%)'
+              })
+            : undefined,
+          legend: props.showLegend ? getLegendStyle(props.legendPosition) : undefined,
+          series: [
+            {
+              name: '数据占比',
+              type: 'pie',
+              radius: props.radius,
+              center: getCenterPosition(),
+              avoidLabelOverlap: false,
+              itemStyle: {
+                borderRadius: props.borderRadius,
+                borderColor: isDark.value ? '#2c2c2c' : '#fff',
+                borderWidth: 0
+              },
+              label: {
+                show: props.showLabel,
+                formatter: '{b}\n{d}%',
+                position: 'outside',
+                color: isDark.value ? '#ccc' : '#999',
+                fontSize: 12
+              },
+              emphasis: {
+                label: {
+                  show: false,
+                  fontSize: 14,
+                  fontWeight: 'bold'
+                }
+              },
+              labelLine: {
+                show: props.showLabel,
+                length: 15,
+                length2: 25,
+                smooth: true
+              },
+              data: props.data,
+              color: props.colors,
+              ...getAnimationConfig(),
+              animationType: 'expansion'
+            }
+          ]
+        }
+
+        // 添加中心文字
+        if (props.centerText) {
+          const centerPos = getCenterPosition()
+          option.title = {
+            text: props.centerText,
+            left: centerPos[0],
+            top: centerPos[1],
+            textAlign: 'center',
+            textVerticalAlign: 'middle',
+            textStyle: {
+              fontSize: 18,
+              fontWeight: 500,
+              color: isDark.value ? '#999' : '#ADB0BC'
+            }
+          }
+        }
+
+        return option
+      }
+    })
+</script>
diff --git a/web/src/components/core/charts/art-scatter-chart/index.vue b/web/src/components/core/charts/art-scatter-chart/index.vue
new file mode 100644
index 0000000..995b56a
--- /dev/null
+++ b/web/src/components/core/charts/art-scatter-chart/index.vue
@@ -0,0 +1,115 @@
+<!-- 散点图 -->
+<template>
+  <div
+    ref="chartRef"
+    class="relative w-full"
+    :style="{ height: props.height }"
+    v-loading="props.loading"
+  >
+  </div>
+</template>
+
+<script setup lang="ts">
+  import type { EChartsOption } from '@/plugins/echarts'
+  import { getCssVar } from '@/utils/ui'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
+  import type { ScatterChartProps } from '@/types/component/chart'
+
+  defineOptions({ name: 'ArtScatterChart' })
+
+  const props = withDefaults(defineProps<ScatterChartProps>(), {
+    // 基础配置
+    height: useChartOps().chartHeight,
+    loading: false,
+    isEmpty: false,
+    colors: () => useChartOps().colors,
+
+    // 数据配置
+    data: () => [{ value: [0, 0] }, { value: [0, 0] }],
+    symbolSize: 14,
+
+    // 轴线显示配置
+    showAxisLabel: true,
+    showAxisLine: true,
+    showSplitLine: true,
+
+    // 交互配置
+    showTooltip: true,
+    showLegend: false,
+    legendPosition: 'bottom'
+  })
+
+  // 使用新的图表组件抽象
+  const {
+    chartRef,
+    isDark,
+    getAxisLineStyle,
+    getAxisLabelStyle,
+    getAxisTickStyle,
+    getSplitLineStyle,
+    getAnimationConfig,
+    getTooltipStyle
+  } = useChartComponent({
+    props,
+    checkEmpty: () => {
+      return !props.data?.length || props.data.every((item) => item.value.every((val) => val === 0))
+    },
+    watchSources: [() => props.data, () => props.colors, () => props.symbolSize],
+    generateOptions: (): EChartsOption => {
+      const computedColor = props.colors[0] || getCssVar('--el-color-primary')
+
+      return {
+        grid: {
+          top: 20,
+          right: 20,
+          bottom: 20,
+          left: 20,
+          containLabel: true
+        },
+        tooltip: props.showTooltip
+          ? getTooltipStyle('item', {
+              formatter: (params: { value: [number, number] }) => {
+                const [x, y] = params.value
+                return `X: ${x}<br/>Y: ${y}`
+              }
+            })
+          : undefined,
+        xAxis: {
+          type: 'value',
+          axisLabel: getAxisLabelStyle(props.showAxisLabel),
+          axisLine: getAxisLineStyle(props.showAxisLine),
+          axisTick: getAxisTickStyle(),
+          splitLine: getSplitLineStyle(props.showSplitLine)
+        },
+        yAxis: {
+          type: 'value',
+          axisLabel: getAxisLabelStyle(props.showAxisLabel),
+          axisLine: getAxisLineStyle(props.showAxisLine),
+          axisTick: getAxisTickStyle(),
+          splitLine: getSplitLineStyle(props.showSplitLine)
+        },
+        series: [
+          {
+            type: 'scatter',
+            data: props.data,
+            symbolSize: props.symbolSize,
+            itemStyle: {
+              color: computedColor,
+              shadowBlur: 6,
+              shadowColor: isDark.value ? 'rgba(255, 255, 255, 0.1)' : 'rgba(0, 0, 0, 0.1)',
+              shadowOffsetY: 2
+            },
+            emphasis: {
+              itemStyle: {
+                shadowBlur: 12,
+                shadowColor: isDark.value ? 'rgba(255, 255, 255, 0.2)' : 'rgba(0, 0, 0, 0.2)'
+              },
+              scale: true
+            },
+            ...getAnimationConfig()
+          }
+        ]
+      }
+    }
+  })
+</script>
diff --git a/web/src/components/core/forms/art-button-more/index.vue b/web/src/components/core/forms/art-button-more/index.vue
new file mode 100644
index 0000000..858d305
--- /dev/null
+++ b/web/src/components/core/forms/art-button-more/index.vue
@@ -0,0 +1,71 @@
+<!-- 更多按钮 -->
+<template>
+  <div>
+    <ElDropdown v-if="hasAnyAuthItem">
+      <ArtIconButton icon="ri:more-2-fill" class="!size-8 bg-g-200 dark:bg-g-300/45 text-sm" />
+      <template #dropdown>
+        <ElDropdownMenu>
+          <template v-for="item in list" :key="item.key">
+            <ElDropdownItem
+              v-if="!item.auth || hasAuth(item.auth)"
+              :disabled="item.disabled"
+              @click="handleClick(item)"
+            >
+              <div class="flex-c gap-2" :style="{ color: item.color }">
+                <ArtSvgIcon v-if="item.icon" :icon="item.icon" />
+                <span>{{ item.label }}</span>
+              </div>
+            </ElDropdownItem>
+          </template>
+        </ElDropdownMenu>
+      </template>
+    </ElDropdown>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useAuth } from '@/hooks/core/useAuth'
+
+  defineOptions({ name: 'ArtButtonMore' })
+
+  const { hasAuth } = useAuth()
+
+  export interface ButtonMoreItem {
+    /** 按钮标识，可用于点击事件 */
+    key: string | number
+    /** 按钮文本 */
+    label: string
+    /** 是否禁用 */
+    disabled?: boolean
+    /** 权限标识 */
+    auth?: string
+    /** 图标组件 */
+    icon?: string
+    /** 文本颜色 */
+    color?: string
+    /** 图标颜色（优先级高于 color） */
+    iconColor?: string
+  }
+
+  interface Props {
+    /** 下拉项列表 */
+    list: ButtonMoreItem[]
+    /** 整体权限控制 */
+    auth?: string
+  }
+
+  const props = withDefaults(defineProps<Props>(), {})
+
+  // 检查是否有任何有权限的 item
+  const hasAnyAuthItem = computed(() => {
+    return props.list.some((item) => !item.auth || hasAuth(item.auth))
+  })
+
+  const emit = defineEmits<{
+    (e: 'click', item: ButtonMoreItem): void
+  }>()
+
+  const handleClick = (item: ButtonMoreItem) => {
+    emit('click', item)
+  }
+</script>
diff --git a/web/src/components/core/forms/art-button-table/index.vue b/web/src/components/core/forms/art-button-table/index.vue
new file mode 100644
index 0000000..c849901
--- /dev/null
+++ b/web/src/components/core/forms/art-button-table/index.vue
@@ -0,0 +1,59 @@
+<!-- 表格按钮 -->
+<template>
+  <div
+    :class="[
+      'inline-flex items-center justify-center min-w-8 h-8 px-2.5 mr-2.5 text-sm c-p rounded-md align-middle',
+      buttonClass
+    ]"
+    :style="{ backgroundColor: buttonBgColor, color: iconColor }"
+    @click="handleClick"
+  >
+    <ArtSvgIcon :icon="iconContent" />
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtButtonTable' })
+
+  interface Props {
+    /** 按钮类型 */
+    type?: 'add' | 'edit' | 'delete' | 'more' | 'view'
+    /** 按钮图标 */
+    icon?: string
+    /** 按钮样式类 */
+    iconClass?: string
+    /** icon 颜色 */
+    iconColor?: string
+    /** 按钮背景色 */
+    buttonBgColor?: string
+  }
+
+  const props = withDefaults(defineProps<Props>(), {})
+
+  const emit = defineEmits<{
+    (e: 'click'): void
+  }>()
+
+  // 默认按钮配置
+  const defaultButtons = {
+    add: { icon: 'ri:add-fill', class: 'bg-theme/12 text-theme' },
+    edit: { icon: 'ri:pencil-line', class: 'bg-secondary/12 text-secondary' },
+    delete: { icon: 'ri:delete-bin-5-line', class: 'bg-error/12 text-error' },
+    view: { icon: 'ri:eye-line', class: 'bg-info/12 text-info' },
+    more: { icon: 'ri:more-2-fill', class: '' }
+  } as const
+
+  // 获取图标内容
+  const iconContent = computed(() => {
+    return props.icon || (props.type ? defaultButtons[props.type]?.icon : '') || ''
+  })
+
+  // 获取按钮样式类
+  const buttonClass = computed(() => {
+    return props.iconClass || (props.type ? defaultButtons[props.type]?.class : '') || ''
+  })
+
+  const handleClick = () => {
+    emit('click')
+  }
+</script>
diff --git a/web/src/components/core/forms/art-drag-verify/index.vue b/web/src/components/core/forms/art-drag-verify/index.vue
new file mode 100644
index 0000000..5306e04
--- /dev/null
+++ b/web/src/components/core/forms/art-drag-verify/index.vue
@@ -0,0 +1,430 @@
+<!-- 拖拽验证组件 -->
+<template>
+  <div
+    ref="dragVerify"
+    class="drag_verify"
+    :style="dragVerifyStyle"
+    @mousemove="dragMoving"
+    @mouseup="dragFinish"
+    @mouseleave="dragFinish"
+    @touchmove="dragMoving"
+    @touchend="dragFinish"
+  >
+    <!-- 进度条 -->
+    <div
+      class="dv_progress_bar"
+      :class="{ goFirst2: isOk }"
+      ref="progressBar"
+      :style="progressBarStyle"
+    >
+    </div>
+
+    <!-- 提示文本 -->
+    <div class="dv_text" :style="textStyle" ref="messageRef">
+      <slot name="textBefore" v-if="$slots.textBefore"></slot>
+      {{ message }}
+      <slot name="textAfter" v-if="$slots.textAfter"></slot>
+    </div>
+
+    <!-- 滑块处理器 -->
+    <div
+      class="dv_handler dv_handler_bg"
+      :class="{ goFirst: isOk }"
+      @mousedown="dragStart"
+      @touchstart="dragStart"
+      ref="handler"
+      :style="handlerStyle"
+    >
+      <ArtSvgIcon :icon="value ? successIcon : handlerIcon" class="text-g-600"></ArtSvgIcon>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtDragVerify' })
+
+  // 事件定义
+  const emit = defineEmits(['handlerMove', 'update:value', 'passCallback'])
+
+  // 组件属性接口定义
+  interface PropsType {
+    /** 是否通过验证 */
+    value: boolean
+    /** 组件宽度 */
+    width?: number | string
+    /** 组件高度 */
+    height?: number
+    /** 默认提示文本 */
+    text?: string
+    /** 成功提示文本 */
+    successText?: string
+    /** 背景色 */
+    background?: string
+    /** 进度条背景色 */
+    progressBarBg?: string
+    /** 完成状态背景色 */
+    completedBg?: string
+    /** 是否圆角 */
+    circle?: boolean
+    /** 圆角大小 */
+    radius?: string
+    /** 滑块图标 */
+    handlerIcon?: string
+    /** 成功图标 */
+    successIcon?: string
+    /** 滑块背景色 */
+    handlerBg?: string
+    /** 文本大小 */
+    textSize?: string
+    /** 文本颜色 */
+    textColor?: string
+  }
+
+  // 属性默认值设置
+  const props = withDefaults(defineProps<PropsType>(), {
+    value: false,
+    width: '100%',
+    height: 40,
+    text: '按住滑块拖动',
+    successText: 'success',
+    background: '#eee',
+    progressBarBg: '#1385FF',
+    completedBg: '#57D187',
+    circle: false,
+    radius: 'calc(var(--custom-radius) / 3 + 2px)',
+    handlerIcon: 'solar:double-alt-arrow-right-linear',
+    successIcon: 'ri:check-fill',
+    handlerBg: '#fff',
+    textSize: '13px',
+    textColor: '#333'
+  })
+
+  // 组件状态接口定义
+  interface StateType {
+    isMoving: boolean // 是否正在拖拽
+    x: number // 拖拽起始位置
+    isOk: boolean // 是否验证成功
+  }
+
+  // 响应式状态定义
+  const state = reactive(<StateType>{
+    isMoving: false,
+    x: 0,
+    isOk: false
+  })
+
+  // 解构响应式状态
+  const { isOk } = toRefs(state)
+
+  // DOM 元素引用
+  const dragVerify = ref()
+  const messageRef = ref()
+  const handler = ref()
+  const progressBar = ref()
+
+  // 触摸事件变量 - 用于禁止页面滑动
+  let startX: number, startY: number, moveX: number, moveY: number
+
+  /**
+   * 触摸开始事件处理
+   * @param e 触摸事件对象
+   */
+  const onTouchStart = (e: any) => {
+    startX = e.targetTouches[0].pageX
+    startY = e.targetTouches[0].pageY
+  }
+
+  /**
+   * 触摸移动事件处理 - 判断是否为横向滑动，如果是则阻止默认行为
+   * @param e 触摸事件对象
+   */
+  const onTouchMove = (e: any) => {
+    moveX = e.targetTouches[0].pageX
+    moveY = e.targetTouches[0].pageY
+
+    // 如果横向移动距离大于纵向移动距离，阻止默认行为（防止页面滑动）
+    if (Math.abs(moveX - startX) > Math.abs(moveY - startY)) {
+      e.preventDefault()
+    }
+  }
+
+  // 全局事件监听器添加
+  document.addEventListener('touchstart', onTouchStart)
+  document.addEventListener('touchmove', onTouchMove, { passive: false })
+
+  // 获取数值形式的宽度
+  const getNumericWidth = (): number => {
+    if (typeof props.width === 'string') {
+      // 如果是字符串，尝试从DOM元素获取实际宽度
+      return dragVerify.value?.offsetWidth || 260
+    }
+    return props.width
+  }
+
+  // 获取样式字符串形式的宽度
+  const getStyleWidth = (): string => {
+    if (typeof props.width === 'string') {
+      return props.width
+    }
+    return props.width + 'px'
+  }
+
+  // 组件挂载后的初始化
+  onMounted(() => {
+    // 设置 CSS 自定义属性
+    dragVerify.value?.style.setProperty('--textColor', props.textColor)
+
+    // 等待DOM更新后设置宽度相关属性
+    nextTick(() => {
+      const numericWidth = getNumericWidth()
+      dragVerify.value?.style.setProperty('--width', Math.floor(numericWidth / 2) + 'px')
+      dragVerify.value?.style.setProperty('--pwidth', -Math.floor(numericWidth / 2) + 'px')
+    })
+
+    // 重复添加事件监听器（确保事件绑定）
+    document.addEventListener('touchstart', onTouchStart)
+    document.addEventListener('touchmove', onTouchMove, { passive: false })
+  })
+
+  // 组件卸载前清理事件监听器
+  onBeforeUnmount(() => {
+    document.removeEventListener('touchstart', onTouchStart)
+    document.removeEventListener('touchmove', onTouchMove)
+  })
+
+  // 滑块样式计算
+  const handlerStyle = {
+    left: '0',
+    width: props.height + 'px',
+    height: props.height + 'px',
+    background: props.handlerBg
+  }
+
+  // 主容器样式计算
+  const dragVerifyStyle = computed(() => ({
+    width: getStyleWidth(),
+    height: props.height + 'px',
+    lineHeight: props.height + 'px',
+    background: props.background,
+    borderRadius: props.circle ? props.height / 2 + 'px' : props.radius
+  }))
+
+  // 进度条样式计算
+  const progressBarStyle = {
+    background: props.progressBarBg,
+    height: props.height + 'px',
+    borderRadius: props.circle
+      ? props.height / 2 + 'px 0 0 ' + props.height / 2 + 'px'
+      : props.radius
+  }
+
+  // 文本样式计算
+  const textStyle = computed(() => ({
+    fontSize: props.textSize
+  }))
+
+  // 显示消息计算属性
+  const message = computed(() => {
+    return props.value ? props.successText : props.text
+  })
+
+  /**
+   * 拖拽开始处理函数
+   * @param e 鼠标或触摸事件对象
+   */
+  const dragStart = (e: any) => {
+    if (!props.value) {
+      state.isMoving = true
+      handler.value.style.transition = 'none'
+      // 计算拖拽起始位置
+      state.x =
+        (e.pageX || e.touches[0].pageX) - parseInt(handler.value.style.left.replace('px', ''), 10)
+    }
+    emit('handlerMove')
+  }
+
+  /**
+   * 拖拽移动处理函数
+   * @param e 鼠标或触摸事件对象
+   */
+  const dragMoving = (e: any) => {
+    if (state.isMoving && !props.value) {
+      const numericWidth = getNumericWidth()
+      // 计算当前位置
+      let _x = (e.pageX || e.touches[0].pageX) - state.x
+
+      // 在有效范围内移动
+      if (_x > 0 && _x <= numericWidth - props.height) {
+        handler.value.style.left = _x + 'px'
+        progressBar.value.style.width = _x + props.height / 2 + 'px'
+      } else if (_x > numericWidth - props.height) {
+        // 拖拽到末端，触发验证成功
+        handler.value.style.left = numericWidth - props.height + 'px'
+        progressBar.value.style.width = numericWidth - props.height / 2 + 'px'
+        passVerify()
+      }
+    }
+  }
+
+  /**
+   * 拖拽结束处理函数
+   * @param e 鼠标或触摸事件对象
+   */
+  const dragFinish = (e: any) => {
+    if (state.isMoving && !props.value) {
+      const numericWidth = getNumericWidth()
+      // 计算最终位置
+      let _x = (e.pageX || e.changedTouches[0].pageX) - state.x
+
+      if (_x < numericWidth - props.height) {
+        // 未拖拽到末端，重置位置
+        state.isOk = true
+        handler.value.style.left = '0'
+        handler.value.style.transition = 'all 0.2s'
+        progressBar.value.style.width = '0'
+        state.isOk = false
+      } else {
+        // 拖拽到末端，保持验证成功状态
+        handler.value.style.transition = 'none'
+        handler.value.style.left = numericWidth - props.height + 'px'
+        progressBar.value.style.width = numericWidth - props.height / 2 + 'px'
+        passVerify()
+      }
+      state.isMoving = false
+    }
+  }
+
+  /**
+   * 验证通过处理函数
+   */
+  const passVerify = () => {
+    emit('update:value', true)
+    state.isMoving = false
+    // 更新样式为成功状态
+    progressBar.value.style.background = props.completedBg
+    messageRef.value.style['-webkit-text-fill-color'] = 'unset'
+    messageRef.value.style.animation = 'slidetounlock2 2s cubic-bezier(0, 0.2, 1, 1) infinite'
+    messageRef.value.style.color = '#fff'
+    emit('passCallback')
+  }
+
+  /**
+   * 重置验证状态函数
+   */
+  const reset = () => {
+    // 重置滑块位置
+    handler.value.style.left = '0'
+    progressBar.value.style.width = '0'
+    progressBar.value.style.background = props.progressBarBg
+    // 重置文本样式
+    messageRef.value.style['-webkit-text-fill-color'] = 'transparent'
+    messageRef.value.style.animation = 'slidetounlock 2s cubic-bezier(0, 0.2, 1, 1) infinite'
+    messageRef.value.style.color = props.background
+    // 重置状态
+    emit('update:value', false)
+    state.isOk = false
+    state.isMoving = false
+    state.x = 0
+  }
+
+  // 暴露重置方法给父组件
+  defineExpose({
+    reset
+  })
+</script>
+
+<style lang="scss" scoped>
+  .drag_verify {
+    position: relative;
+    box-sizing: border-box;
+    overflow: hidden;
+    text-align: center;
+    border: 1px solid var(--default-border-dashed);
+
+    .dv_handler {
+      position: absolute;
+      top: 0;
+      left: 0;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      cursor: move;
+
+      i {
+        padding-left: 0;
+        font-size: 14px;
+        color: #999;
+      }
+
+      .el-icon-circle-check {
+        margin-top: 9px;
+        color: #6c6;
+      }
+    }
+
+    .dv_progress_bar {
+      position: absolute;
+      width: 0;
+      height: 34px;
+    }
+
+    .dv_text {
+      position: absolute;
+      inset: 0;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      color: transparent;
+      user-select: none;
+      background: linear-gradient(
+        to right,
+        var(--textColor) 0%,
+        var(--textColor) 40%,
+        #fff 50%,
+        var(--textColor) 60%,
+        var(--textColor) 100%
+      );
+      -webkit-background-clip: text;
+      background-clip: text;
+      animation: slidetounlock 2s cubic-bezier(0, 0.2, 1, 1) infinite;
+      -webkit-text-fill-color: transparent;
+      text-size-adjust: none;
+
+      * {
+        -webkit-text-fill-color: var(--textColor);
+      }
+    }
+  }
+
+  .goFirst {
+    left: 0 !important;
+    transition: left 0.5s;
+  }
+
+  .goFirst2 {
+    width: 0 !important;
+    transition: width 0.5s;
+  }
+</style>
+
+<style lang="scss">
+  @keyframes slidetounlock {
+    0% {
+      background-position: var(--pwidth) 0;
+    }
+
+    100% {
+      background-position: var(--width) 0;
+    }
+  }
+
+  @keyframes slidetounlock2 {
+    0% {
+      background-position: var(--pwidth) 0;
+    }
+
+    100% {
+      background-position: var(--pwidth) 0;
+    }
+  }
+</style>
diff --git a/web/src/components/core/forms/art-excel-export/index.vue b/web/src/components/core/forms/art-excel-export/index.vue
new file mode 100644
index 0000000..08207c2
--- /dev/null
+++ b/web/src/components/core/forms/art-excel-export/index.vue
@@ -0,0 +1,389 @@
+<!-- 导出 Excel 文件 -->
+<template>
+  <ElButton
+    :type="type"
+    :size="size"
+    :loading="isExporting"
+    :disabled="disabled || !hasData"
+    v-ripple
+    @click="handleExport"
+  >
+    <template #loading>
+      <ElIcon class="is-loading">
+        <Loading />
+      </ElIcon>
+      {{ loadingText }}
+    </template>
+    <slot>{{ buttonText }}</slot>
+  </ElButton>
+</template>
+
+<script setup lang="ts">
+  import * as XLSX from 'xlsx'
+  import FileSaver from 'file-saver'
+  import { ref, computed, nextTick } from 'vue'
+  import { Loading } from '@element-plus/icons-vue'
+  import type { ButtonType } from 'element-plus'
+  import { useThrottleFn } from '@vueuse/core'
+
+  defineOptions({ name: 'ArtExcelExport' })
+
+  /** 导出数据类型 */
+  type ExportValue = string | number | boolean | null | undefined | Date
+
+  interface ExportData {
+    [key: string]: ExportValue
+  }
+
+  /** 列配置 */
+  interface ColumnConfig {
+    /** 列标题 */
+    title: string
+    /** 列宽度 */
+    width?: number
+    /** 数据格式化函数 */
+    formatter?: (value: ExportValue, row: ExportData, index: number) => string
+  }
+
+  /** 导出配置选项 */
+  interface ExportOptions {
+    /** 数据源 */
+    data: ExportData[]
+    /** 文件名（不含扩展名） */
+    filename?: string
+    /** 工作表名称 */
+    sheetName?: string
+    /** 按钮类型 */
+    type?: ButtonType
+    /** 按钮尺寸 */
+    size?: 'large' | 'default' | 'small'
+    /** 是否禁用 */
+    disabled?: boolean
+    /** 按钮文本 */
+    buttonText?: string
+    /** 加载中文本 */
+    loadingText?: string
+    /** 是否自动添加序号列 */
+    autoIndex?: boolean
+    /** 序号列标题 */
+    indexColumnTitle?: string
+    /** 列配置映射 */
+    columns?: Record<string, ColumnConfig>
+    /** 表头映射（简化版本，向后兼容） */
+    headers?: Record<string, string>
+    /** 最大导出行数 */
+    maxRows?: number
+    /** 是否显示成功消息 */
+    showSuccessMessage?: boolean
+    /** 是否显示错误消息 */
+    showErrorMessage?: boolean
+    /** 工作簿配置 */
+    workbookOptions?: {
+      /** 创建者 */
+      creator?: string
+      /** 最后修改者 */
+      lastModifiedBy?: string
+      /** 创建时间 */
+      created?: Date
+      /** 修改时间 */
+      modified?: Date
+    }
+  }
+
+  const props = withDefaults(defineProps<ExportOptions>(), {
+    filename: () => `export_${new Date().toISOString().slice(0, 10)}`,
+    sheetName: 'Sheet1',
+    type: 'primary',
+    size: 'default',
+    disabled: false,
+    buttonText: '导出 Excel',
+    loadingText: '导出中...',
+    autoIndex: false,
+    indexColumnTitle: '序号',
+    columns: () => ({}),
+    headers: () => ({}),
+    maxRows: 100000,
+    showSuccessMessage: true,
+    showErrorMessage: true,
+    workbookOptions: () => ({})
+  })
+
+  const emit = defineEmits<{
+    'before-export': [data: ExportData[]]
+    'export-success': [filename: string, rowCount: number]
+    'export-error': [error: ExportError]
+    'export-progress': [progress: number]
+  }>()
+
+  /** 导出错误类型 */
+  class ExportError extends Error {
+    constructor(
+      message: string,
+      public code: string,
+      public details?: any
+    ) {
+      super(message)
+      this.name = 'ExportError'
+    }
+  }
+
+  const isExporting = ref(false)
+
+  /** 是否有数据可导出 */
+  const hasData = computed(() => Array.isArray(props.data) && props.data.length > 0)
+
+  /** 验证导出数据 */
+  const validateData = (data: ExportData[]): void => {
+    if (!Array.isArray(data)) {
+      throw new ExportError('数据必须是数组格式', 'INVALID_DATA_TYPE')
+    }
+
+    if (data.length === 0) {
+      throw new ExportError('没有可导出的数据', 'NO_DATA')
+    }
+
+    if (data.length > props.maxRows) {
+      throw new ExportError(`数据行数超过限制（${props.maxRows}行）`, 'EXCEED_MAX_ROWS', {
+        currentRows: data.length,
+        maxRows: props.maxRows
+      })
+    }
+  }
+
+  /** 格式化单元格值 */
+  const formatCellValue = (
+    value: ExportValue,
+    key: string,
+    row: ExportData,
+    index: number
+  ): string => {
+    // 使用列配置的格式化函数
+    const column = props.columns[key]
+    if (column?.formatter) {
+      return column.formatter(value, row, index)
+    }
+
+    // 处理特殊值
+    if (value === null || value === undefined) {
+      return ''
+    }
+
+    if (value instanceof Date) {
+      return value.toLocaleDateString('zh-CN')
+    }
+
+    if (typeof value === 'boolean') {
+      return value ? '是' : '否'
+    }
+
+    return String(value)
+  }
+
+  /** 处理数据 */
+  const processData = (data: ExportData[]): Record<string, string>[] => {
+    const processedData = data.map((item, index) => {
+      const processedItem: Record<string, string> = {}
+
+      // 添加序号列
+      if (props.autoIndex) {
+        processedItem[props.indexColumnTitle] = String(index + 1)
+      }
+
+      // 处理数据列
+      Object.entries(item).forEach(([key, value]) => {
+        // 获取列标题
+        let columnTitle = key
+        if (props.columns[key]?.title) {
+          columnTitle = props.columns[key].title
+        } else if (props.headers[key]) {
+          columnTitle = props.headers[key]
+        }
+
+        // 格式化值
+        processedItem[columnTitle] = formatCellValue(value, key, item, index)
+      })
+
+      return processedItem
+    })
+
+    return processedData
+  }
+
+  /** 计算列宽度 */
+  const calculateColumnWidths = (data: Record<string, string>[]): XLSX.ColInfo[] => {
+    if (data.length === 0) return []
+
+    const sampleSize = Math.min(data.length, 100) // 只取前100行计算列宽
+    const columns = Object.keys(data[0])
+
+    return columns.map((column) => {
+      // 使用配置的列宽度
+      const configWidth = Object.values(props.columns).find((col) => col.title === column)?.width
+
+      if (configWidth) {
+        return { wch: configWidth }
+      }
+
+      // 自动计算列宽度
+      const maxLength = Math.max(
+        column.length, // 标题长度
+        ...data.slice(0, sampleSize).map((row) => String(row[column] || '').length)
+      )
+
+      // 限制最小和最大宽度
+      const width = Math.min(Math.max(maxLength + 2, 8), 50)
+      return { wch: width }
+    })
+  }
+
+  /** 导出到 Excel */
+  const exportToExcel = async (
+    data: ExportData[],
+    filename: string,
+    sheetName: string
+  ): Promise<void> => {
+    try {
+      emit('export-progress', 10)
+
+      // 处理数据
+      const processedData = processData(data)
+      emit('export-progress', 30)
+
+      // 创建工作簿
+      const workbook = XLSX.utils.book_new()
+
+      // 设置工作簿属性
+      if (props.workbookOptions) {
+        workbook.Props = {
+          Title: filename,
+          Subject: '数据导出',
+          Author: props.workbookOptions.creator || 'Art Design Pro',
+          Manager: props.workbookOptions.lastModifiedBy || '',
+          Company: '系统导出',
+          Category: '数据',
+          Keywords: 'excel,export,data',
+          Comments: '由系统自动生成',
+          CreatedDate: props.workbookOptions.created || new Date(),
+          ModifiedDate: props.workbookOptions.modified || new Date()
+        }
+      }
+
+      emit('export-progress', 50)
+
+      // 创建工作表
+      const worksheet = XLSX.utils.json_to_sheet(processedData)
+
+      // 设置列宽度
+      worksheet['!cols'] = calculateColumnWidths(processedData)
+
+      emit('export-progress', 70)
+
+      // 添加工作表到工作簿
+      XLSX.utils.book_append_sheet(workbook, worksheet, sheetName)
+
+      emit('export-progress', 85)
+
+      // 生成 Excel 文件
+      const excelBuffer = XLSX.write(workbook, {
+        bookType: 'xlsx',
+        type: 'array',
+        compression: true
+      })
+
+      // 创建 Blob 并下载
+      const blob = new Blob([excelBuffer], {
+        type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+      })
+
+      emit('export-progress', 95)
+
+      // 使用时间戳确保文件名唯一
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-')
+      const finalFilename = `${filename}_${timestamp}.xlsx`
+
+      FileSaver.saveAs(blob, finalFilename)
+
+      emit('export-progress', 100)
+
+      // 等待下载开始
+      await nextTick()
+
+      return Promise.resolve()
+    } catch (error) {
+      throw new ExportError(`Excel 导出失败: ${(error as Error).message}`, 'EXPORT_FAILED', error)
+    }
+  }
+
+  /** 处理导出 */
+  const handleExport = useThrottleFn(async () => {
+    if (isExporting.value) return
+
+    isExporting.value = true
+
+    try {
+      // 验证数据
+      validateData(props.data)
+
+      // 触发导出前事件
+      emit('before-export', props.data)
+
+      // 执行导出
+      await exportToExcel(props.data, props.filename, props.sheetName)
+
+      // 触发成功事件
+      emit('export-success', props.filename, props.data.length)
+
+      // 显示成功消息
+      if (props.showSuccessMessage) {
+        ElMessage.success({
+          message: `成功导出 ${props.data.length} 条数据`,
+          duration: 3000
+        })
+      }
+    } catch (error) {
+      const exportError =
+        error instanceof ExportError
+          ? error
+          : new ExportError(`导出失败: ${(error as Error).message}`, 'UNKNOWN_ERROR', error)
+
+      // 触发错误事件
+      emit('export-error', exportError)
+
+      // 显示错误消息
+      if (props.showErrorMessage) {
+        ElMessage.error({
+          message: exportError.message,
+          duration: 5000
+        })
+      }
+
+      console.error('Excel 导出错误:', exportError)
+    } finally {
+      isExporting.value = false
+      emit('export-progress', 0)
+    }
+  }, 1000)
+
+  // 暴露方法供父组件调用
+  defineExpose({
+    exportData: handleExport,
+    isExporting: readonly(isExporting),
+    hasData
+  })
+</script>
+
+<style scoped>
+  .is-loading {
+    animation: rotating 2s linear infinite;
+  }
+
+  @keyframes rotating {
+    0% {
+      transform: rotate(0deg);
+    }
+
+    100% {
+      transform: rotate(360deg);
+    }
+  }
+</style>
diff --git a/web/src/components/core/forms/art-excel-import/index.vue b/web/src/components/core/forms/art-excel-import/index.vue
new file mode 100644
index 0000000..8aa82fe
--- /dev/null
+++ b/web/src/components/core/forms/art-excel-import/index.vue
@@ -0,0 +1,62 @@
+<!-- 导入 Excel 文件 -->
+<template>
+  <div class="inline-block">
+    <ElUpload
+      :auto-upload="false"
+      accept=".xlsx, .xls"
+      :show-file-list="false"
+      @change="handleFileChange"
+    >
+      <ElButton type="primary" v-ripple>
+        <slot>导入 Excel</slot>
+      </ElButton>
+    </ElUpload>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import * as XLSX from 'xlsx'
+  import type { UploadFile } from 'element-plus'
+
+  defineOptions({ name: 'ArtExcelImport' })
+
+  // Excel 导入工具函数
+  async function importExcel(file: File): Promise<Array<Record<string, unknown>>> {
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader()
+
+      reader.onload = (e) => {
+        try {
+          const data = e.target?.result
+          const workbook = XLSX.read(data, { type: 'array' })
+          const firstSheetName = workbook.SheetNames[0]
+          const worksheet = workbook.Sheets[firstSheetName]
+          const results = XLSX.utils.sheet_to_json(worksheet)
+          resolve(results as Array<Record<string, unknown>>)
+        } catch (error) {
+          reject(error)
+        }
+      }
+
+      reader.onerror = (error) => reject(error)
+      reader.readAsArrayBuffer(file)
+    })
+  }
+
+  // 定义 emits
+  const emit = defineEmits<{
+    'import-success': [data: Array<Record<string, unknown>>]
+    'import-error': [error: Error]
+  }>()
+
+  // 处理文件导入
+  const handleFileChange = async (uploadFile: UploadFile) => {
+    try {
+      if (!uploadFile.raw) return
+      const results = await importExcel(uploadFile.raw)
+      emit('import-success', results)
+    } catch (error) {
+      emit('import-error', error as Error)
+    }
+  }
+</script>
diff --git a/web/src/components/core/forms/art-form/index.vue b/web/src/components/core/forms/art-form/index.vue
new file mode 100644
index 0000000..561e878
--- /dev/null
+++ b/web/src/components/core/forms/art-form/index.vue
@@ -0,0 +1,507 @@
+<!-- 表单组件 -->
+<!-- 支持常用表单组件、自定义组件、插槽、校验、隐藏表单项 -->
+<!-- 写法同 ElementPlus 官方文档组件，把属性写在 props 里面就可以了 -->
+<template>
+  <section class="px-4 pb-0 pt-4 md:px-4 md:pt-4">
+    <ElForm
+      ref="formRef"
+      :model="modelValue"
+      :label-position="labelPosition"
+      v-bind="{ ...$attrs }"
+    >
+      <ElRow class="flex flex-wrap" :gutter="gutter">
+        <ElCol
+          v-for="item in visibleFormItems"
+          :key="item.key"
+          :xs="getColSpan(item.span, 'xs')"
+          :sm="getColSpan(item.span, 'sm')"
+          :md="getColSpan(item.span, 'md')"
+          :lg="getColSpan(item.span, 'lg')"
+          :xl="getColSpan(item.span, 'xl')"
+        >
+          <ElFormItem
+            :prop="item.key"
+            :label-width="item.label ? item.labelWidth || labelWidth : undefined"
+          >
+            <template #label v-if="item.label">
+              <component v-if="typeof item.label !== 'string'" :is="item.label" />
+              <span v-else>{{ item.label }}</span>
+            </template>
+            <slot :name="item.key" :item="item" :modelValue="modelValue">
+              <component
+                :is="getComponent(item)"
+                :model-value="getFieldValue(item.key)"
+                @update:model-value="setFieldValue(item.key, $event)"
+                v-bind="getProps(item)"
+              >
+                <!-- 下拉选择 -->
+                <template v-if="item.type === 'select' && getProps(item)?.options">
+                  <ElOption
+                    v-for="option in getProps(item).options"
+                    v-bind="option"
+                    :key="option.value"
+                  />
+                </template>
+
+                <!-- 复选框组 -->
+                <template v-if="item.type === 'checkboxgroup' && getProps(item)?.options">
+                  <ElCheckbox
+                    v-for="option in getProps(item).options"
+                    v-bind="option"
+                    :key="option.value"
+                  />
+                </template>
+
+                <!-- 单选框组 -->
+                <template v-if="item.type === 'radiogroup' && getProps(item)?.options">
+                  <ElRadio
+                    v-for="option in getProps(item).options"
+                    v-bind="option"
+                    :key="option.value"
+                  />
+                </template>
+
+                <!-- 动态插槽支持 -->
+                <template v-for="(slotFn, slotName) in getSlots(item)" :key="slotName" #[slotName]>
+                  <component :is="slotFn" />
+                </template>
+              </component>
+            </slot>
+          </ElFormItem>
+        </ElCol>
+        <ElCol :xs="24" :sm="24" :md="span" :lg="span" :xl="span" class="max-w-full flex-1">
+          <div
+            class="mb-3 flex-c flex-wrap justify-end md:flex-row md:items-stretch md:gap-2"
+            :style="actionButtonsStyle"
+          >
+            <div class="flex gap-2 md:justify-center">
+              <ElButton v-if="showReset" class="reset-button" @click="handleReset" v-ripple>
+                {{ t('table.form.reset') }}
+              </ElButton>
+              <ElButton
+                v-if="showSubmit"
+                type="primary"
+                class="submit-button"
+                @click="handleSubmit"
+                v-ripple
+                :disabled="disabledSubmit"
+              >
+                {{ t('table.form.submit') }}
+              </ElButton>
+            </div>
+          </div>
+        </ElCol>
+      </ElRow>
+    </ElForm>
+  </section>
+</template>
+
+<script setup lang="ts">
+  import { useWindowSize } from '@vueuse/core'
+  import { useI18n } from 'vue-i18n'
+  import { toRaw, type Component } from 'vue'
+  import {
+    ElCascader,
+    ElCheckbox,
+    ElCheckboxGroup,
+    ElDatePicker,
+    ElInput,
+    ElInputTag,
+    ElInputNumber,
+    ElRadioGroup,
+    ElRate,
+    ElSelect,
+    ElSlider,
+    ElSwitch,
+    ElTimePicker,
+    ElTimeSelect,
+    ElTreeSelect,
+    type FormInstance
+  } from 'element-plus'
+  import { calculateResponsiveSpan, type ResponsiveBreakpoint } from '@/utils/form/responsive'
+
+  defineOptions({ name: 'ArtForm' })
+
+  const componentMap = {
+    input: ElInput, // 输入框
+    inputtag: ElInputTag, // 标签输入框
+    number: ElInputNumber, // 数字输入框
+    select: ElSelect, // 选择器
+    switch: ElSwitch, // 开关
+    checkbox: ElCheckbox, // 复选框
+    checkboxgroup: ElCheckboxGroup, // 复选框组
+    radiogroup: ElRadioGroup, // 单选框组
+    date: ElDatePicker, // 日期选择器
+    daterange: ElDatePicker, // 日期范围选择器
+    datetime: ElDatePicker, // 日期时间选择器
+    datetimerange: ElDatePicker, // 日期时间范围选择器
+    rate: ElRate, // 评分
+    slider: ElSlider, // 滑块
+    cascader: ElCascader, // 级联选择器
+    timepicker: ElTimePicker, // 时间选择器
+    timeselect: ElTimeSelect, // 时间选择
+    treeselect: ElTreeSelect // 树选择器
+  }
+
+  const { width } = useWindowSize()
+  const { t } = useI18n()
+  const isMobile = computed(() => width.value < 500)
+
+  const formInstance = useTemplateRef<FormInstance>('formRef')
+
+  // 表单项配置
+  export interface FormItem {
+    /** 表单项的唯一标识 */
+    key: string
+    /** 表单项的标签文本或自定义渲染函数 */
+    label: string | (() => VNode) | Component
+    /** 表单项标签的宽度，会覆盖 Form 的 labelWidth */
+    labelWidth?: string | number
+    /** 表单项类型，支持预定义的组件类型 */
+    type?: keyof typeof componentMap | string
+    /** 自定义渲染函数或组件，用于渲染自定义组件（优先级高于 type） */
+    render?: (() => VNode) | Component
+    /** 是否隐藏该表单项 */
+    hidden?: boolean
+    /** 表单项占据的列宽，基于24格栅格系统 */
+    span?: number
+    /** 选项数据，用于 select、checkbox-group、radio-group 等 */
+    options?: Record<string, any>
+    /** 传递给表单项组件的属性 */
+    props?: Record<string, any>
+    /** 表单项的插槽配置 */
+    slots?: Record<string, (() => any) | undefined>
+    /** 表单项的占位符文本 */
+    placeholder?: string
+    /** 更多属性配置请参考 ElementPlus 官方文档 */
+  }
+
+  // 表单配置
+  interface FormProps {
+    /** 表单数据 */
+    items: FormItem[]
+    /** 每列的宽度（基于 24 格布局） */
+    span?: number
+    /** 表单控件间隙 */
+    gutter?: number
+    /** 表单域标签的位置 */
+    labelPosition?: 'left' | 'right' | 'top'
+    /** 文字宽度 */
+    labelWidth?: string | number
+    /** 按钮靠左对齐限制（表单项小于等于该值时） */
+    buttonLeftLimit?: number
+    /** 是否显示重置按钮 */
+    showReset?: boolean
+    /** 是否显示提交按钮 */
+    showSubmit?: boolean
+    /** 是否禁用提交按钮 */
+    disabledSubmit?: boolean
+    /** 提交时是否清洗空值 */
+    sanitizeOutput?: Partial<SanitizeOutputOptions>
+  }
+
+  interface SanitizeOutputOptions {
+    /** 移除空字符串 */
+    removeEmptyString: boolean
+    /** 移除空数组 */
+    removeEmptyArray: boolean
+    /** 移除清洗后为空的对象 */
+    removeEmptyObject: boolean
+    /** 移除空富文本占位内容，如 <p><br></p> */
+    removeEmptyRichText: boolean
+    /** 保留数字 0 这类有效值 */
+    keepZero: boolean
+    /** 保留 false 这类有效值 */
+    keepFalse: boolean
+  }
+
+  const props = withDefaults(defineProps<FormProps>(), {
+    items: () => [],
+    span: 6,
+    gutter: 12,
+    labelPosition: 'right',
+    labelWidth: '70px',
+    buttonLeftLimit: 2,
+    showReset: true,
+    showSubmit: true,
+    disabledSubmit: false,
+    sanitizeOutput: () => ({})
+  })
+
+  interface FormEmits {
+    reset: []
+    submit: [Record<string, any>]
+  }
+
+  const emit = defineEmits<FormEmits>()
+
+  const modelValue = defineModel<Record<string, any>>({ default: {} })
+  const initialModelValue = ref<Record<string, any>>({})
+
+  // 保存组件初始化时的表单快照，用于 reset 时恢复默认值。
+  const cloneModelValue = (value: Record<string, any> | undefined) => {
+    if (!value) return {}
+
+    const deepClone = (source: unknown): unknown => {
+      if (Array.isArray(source)) {
+        return source.map((item) => deepClone(item))
+      }
+
+      if (source && typeof source === 'object') {
+        const rawSource = toRaw(source)
+        return Object.keys(rawSource).reduce<Record<string, unknown>>((accumulator, key) => {
+          accumulator[key] = deepClone((rawSource as Record<string, unknown>)[key])
+          return accumulator
+        }, {})
+      }
+
+      return source
+    }
+
+    return deepClone(toRaw(value)) as Record<string, any>
+  }
+
+  initialModelValue.value = cloneModelValue(modelValue.value)
+
+  const rootProps = ['label', 'labelWidth', 'key', 'type', 'hidden', 'span', 'slots']
+  // 输出时的清洗策略默认偏“接口友好”，但允许按业务覆盖。
+  const sanitizeOutputOptions = computed<SanitizeOutputOptions>(() => ({
+    removeEmptyString: true,
+    removeEmptyArray: true,
+    removeEmptyObject: true,
+    removeEmptyRichText: true,
+    keepZero: true,
+    keepFalse: true,
+    ...props.sanitizeOutput
+  }))
+
+  const PATH_NUMBER_RE = /^\d+$/
+
+  // 兼容 a.b、a.0.b 这类路径写法，数字段会被当作数组索引处理。
+  const parsePath = (path: string) => {
+    return path
+      .split('.')
+      .filter(Boolean)
+      .map((segment) => (PATH_NUMBER_RE.test(segment) ? Number(segment) : segment))
+  }
+
+  const getFieldValue = (path: string) => {
+    return parsePath(path).reduce<any>((currentValue, segment) => {
+      if (currentValue == null) return undefined
+      return currentValue[segment]
+    }, modelValue.value)
+  }
+
+  // 清空字段时只删除路径的最后一段，避免误删同级数据。
+  const deleteFieldValue = (path: string) => {
+    const segments = parsePath(path)
+    if (!segments.length) return
+
+    const lastSegment = segments.pop()
+    const parent = segments.reduce<any>((currentValue, segment) => {
+      if (currentValue == null) return undefined
+      return currentValue[segment]
+    }, modelValue.value)
+
+    if (parent != null && lastSegment !== undefined) {
+      delete parent[lastSegment]
+    }
+  }
+
+  // 表单清空输入时不保留空字符串，同时按路径自动补齐中间对象或数组。
+  const setFieldValue = (path: string, value: unknown) => {
+    const normalizedValue = value === '' ? undefined : value
+    const segments = parsePath(path)
+
+    if (!segments.length) return
+
+    if (normalizedValue === undefined) {
+      deleteFieldValue(path)
+      return
+    }
+
+    let currentValue: any = modelValue.value
+
+    segments.forEach((segment, index) => {
+      const isLast = index === segments.length - 1
+
+      if (isLast) {
+        currentValue[segment] = normalizedValue
+        return
+      }
+
+      const nextSegment = segments[index + 1]
+      const nextContainer = typeof nextSegment === 'number' ? [] : {}
+
+      if (
+        currentValue[segment] === null ||
+        currentValue[segment] === undefined ||
+        typeof currentValue[segment] !== 'object'
+      ) {
+        currentValue[segment] = nextContainer
+      }
+
+      currentValue = currentValue[segment]
+    })
+  }
+
+  const isRichTextEmpty = (value: string) => {
+    if (/<(img|video|audio|iframe|embed|object)\b/i.test(value)) {
+      return false
+    }
+
+    // 去掉编辑器常见占位标签后再判断是否还有实际内容。
+    return (
+      value
+        .replace(/&nbsp;/gi, '')
+        .replace(/<br\s*\/?>/gi, '')
+        .replace(/<[^>]*>/g, '')
+        .trim() === ''
+    )
+  }
+
+  // 提交时按配置清洗空值，但保留 0 和 false 这类有效值。
+  const sanitizeOutputValue = (value: unknown): unknown => {
+    const options = sanitizeOutputOptions.value
+
+    if (Array.isArray(value)) {
+      const sanitizedArray = value
+        .map((item) => sanitizeOutputValue(item))
+        .filter((item) => item !== undefined)
+      return sanitizedArray.length === 0 && options.removeEmptyArray ? undefined : sanitizedArray
+    }
+
+    if (value && typeof value === 'object') {
+      const rawValue = toRaw(value)
+      const sanitizedObject = Object.entries(rawValue).reduce<Record<string, unknown>>(
+        (accumulator, [key, item]) => {
+          const sanitizedItem = sanitizeOutputValue(item)
+          if (sanitizedItem !== undefined) {
+            accumulator[key] = sanitizedItem
+          }
+          return accumulator
+        },
+        {}
+      )
+      return Object.keys(sanitizedObject).length === 0 && options.removeEmptyObject
+        ? undefined
+        : sanitizedObject
+    }
+
+    if (typeof value === 'string') {
+      if (options.removeEmptyString && value.trim() === '') {
+        return undefined
+      }
+      if (options.removeEmptyRichText && isRichTextEmpty(value)) {
+        return undefined
+      }
+      return value
+    }
+
+    if (value === 0) {
+      return options.keepZero ? value : undefined
+    }
+
+    if (value === false) {
+      return options.keepFalse ? value : undefined
+    }
+
+    return value ?? undefined
+  }
+
+  const getSanitizedOutput = () => {
+    return (sanitizeOutputValue(cloneModelValue(modelValue.value)) || {}) as Record<string, any>
+  }
+
+  const getProps = (item: FormItem) => {
+    if (item.props) return item.props
+    const props = { ...item }
+    rootProps.forEach((key) => delete (props as Record<string, any>)[key])
+    return props
+  }
+
+  // 获取插槽
+  const getSlots = (item: FormItem) => {
+    if (!item.slots) return {}
+    const validSlots: Record<string, () => any> = {}
+    Object.entries(item.slots).forEach(([key, slotFn]) => {
+      if (slotFn) {
+        validSlots[key] = slotFn
+      }
+    })
+    return validSlots
+  }
+
+  // 组件
+  const getComponent = (item: FormItem) => {
+    // 优先使用 render 函数或组件渲染自定义组件
+    if (item.render) {
+      return item.render
+    }
+    // 使用 type 获取预定义组件
+    const { type } = item
+    return componentMap[type as keyof typeof componentMap] || componentMap['input']
+  }
+
+  /**
+   * 获取列宽 span 值
+   * 根据屏幕尺寸智能降级，避免小屏幕上表单项被压缩过小
+   */
+  const getColSpan = (itemSpan: number | undefined, breakpoint: ResponsiveBreakpoint): number => {
+    return calculateResponsiveSpan(itemSpan, span.value, breakpoint)
+  }
+
+  /**
+   * 可见的表单项
+   */
+  const visibleFormItems = computed(() => {
+    return props.items.filter((item) => !item.hidden)
+  })
+
+  /**
+   * 操作按钮样式
+   */
+  const actionButtonsStyle = computed(() => ({
+    'justify-content': isMobile.value
+      ? 'flex-end'
+      : props.items.filter((item) => !item.hidden).length <= props.buttonLeftLimit
+        ? 'flex-start'
+        : 'flex-end'
+  }))
+
+  /**
+   * 处理重置事件
+   */
+  const handleReset = () => {
+    // 重置表单字段（UI 层）
+    formInstance.value?.resetFields()
+
+    // 恢复初始表单值，保留默认值而不是简单清空。
+    Object.keys(modelValue.value).forEach((key) => {
+      delete modelValue.value[key]
+    })
+    Object.assign(modelValue.value, cloneModelValue(initialModelValue.value))
+
+    // 触发 reset 事件
+    emit('reset')
+  }
+
+  /**
+   * 处理提交事件
+   */
+  const handleSubmit = () => {
+    // 对外只抛出清洗后的结果，避免业务层重复过滤空值。
+    emit('submit', getSanitizedOutput())
+  }
+
+  defineExpose({
+    ref: formInstance,
+    validate: (...args: any[]) => formInstance.value?.validate(...args),
+    reset: handleReset,
+    // 允许外部在不触发提交事件时主动获取清洗后的输出。
+    getOutput: getSanitizedOutput
+  })
+
+  // 解构 props 以便在模板中直接使用
+  const { span, gutter, labelPosition, labelWidth } = toRefs(props)
+</script>
diff --git a/web/src/components/core/forms/art-search-bar/index.vue b/web/src/components/core/forms/art-search-bar/index.vue
new file mode 100644
index 0000000..6786dca
--- /dev/null
+++ b/web/src/components/core/forms/art-search-bar/index.vue
@@ -0,0 +1,581 @@
+<!-- 表格搜索组件 -->
+<!-- 支持常用表单组件、自定义组件、插槽、校验、隐藏表单项 -->
+<!-- 写法同 ElementPlus 官方文档组件，把属性写在 props 里面就可以了 -->
+<template>
+  <section class="art-search-bar art-card-xs" :class="{ 'is-expanded': isExpanded }">
+    <ElForm
+      ref="formRef"
+      :model="modelValue"
+      :label-position="labelPosition"
+      v-bind="{ ...$attrs }"
+    >
+      <ElRow :gutter="gutter">
+        <ElCol
+          v-for="item in visibleFormItems"
+          :key="item.key"
+          :xs="getColSpan(item.span, 'xs')"
+          :sm="getColSpan(item.span, 'sm')"
+          :md="getColSpan(item.span, 'md')"
+          :lg="getColSpan(item.span, 'lg')"
+          :xl="getColSpan(item.span, 'xl')"
+        >
+          <ElFormItem
+            :prop="item.key"
+            :label-width="item.label ? item.labelWidth || labelWidth : undefined"
+          >
+            <template #label v-if="item.label">
+              <component v-if="typeof item.label !== 'string'" :is="item.label" />
+              <span v-else>{{ item.label }}</span>
+            </template>
+            <slot :name="item.key" :item="item" :modelValue="modelValue">
+              <component
+                :is="getComponent(item)"
+                :model-value="getFieldValue(item.key)"
+                @update:model-value="setFieldValue(item.key, $event)"
+                v-bind="getProps(item)"
+              >
+                <!-- 下拉选择 -->
+                <template v-if="item.type === 'select' && getProps(item)?.options">
+                  <ElOption
+                    v-for="option in getProps(item).options"
+                    v-bind="option"
+                    :key="option.value"
+                  />
+                </template>
+
+                <!-- 复选框组 -->
+                <template v-if="item.type === 'checkboxgroup' && getProps(item)?.options">
+                  <ElCheckbox
+                    v-for="option in getProps(item).options"
+                    v-bind="option"
+                    :key="option.value"
+                  />
+                </template>
+
+                <!-- 单选框组 -->
+                <template v-if="item.type === 'radiogroup' && getProps(item)?.options">
+                  <ElRadio
+                    v-for="option in getProps(item).options"
+                    v-bind="option"
+                    :key="option.value"
+                  />
+                </template>
+
+                <!-- 动态插槽支持 -->
+                <template v-for="(slotFn, slotName) in getSlots(item)" :key="slotName" #[slotName]>
+                  <component :is="slotFn" />
+                </template>
+              </component>
+            </slot>
+          </ElFormItem>
+        </ElCol>
+        <ElCol :xs="24" :sm="24" :md="span" :lg="span" :xl="span" class="action-column">
+          <div class="action-buttons-wrapper" :style="actionButtonsStyle">
+            <div class="form-buttons">
+              <ElButton v-if="showReset" class="reset-button" @click="handleReset" v-ripple>
+                {{ t('table.searchBar.reset') }}
+              </ElButton>
+              <ElButton
+                v-if="showSearch"
+                type="primary"
+                class="search-button"
+                @click="handleSearch"
+                v-ripple
+                :disabled="disabledSearch"
+              >
+                {{ t('table.searchBar.search') }}
+              </ElButton>
+            </div>
+            <div v-if="shouldShowExpandToggle" class="filter-toggle" @click="toggleExpand">
+              <span>{{ expandToggleText }}</span>
+              <div class="icon-wrapper">
+                <ElIcon>
+                  <ArrowUpBold v-if="isExpanded" />
+                  <ArrowDownBold v-else />
+                </ElIcon>
+              </div>
+            </div>
+          </div>
+        </ElCol>
+      </ElRow>
+    </ElForm>
+  </section>
+</template>
+
+<script setup lang="ts">
+  import { ArrowUpBold, ArrowDownBold } from '@element-plus/icons-vue'
+  import { useWindowSize } from '@vueuse/core'
+  import { useI18n } from 'vue-i18n'
+  import { toRaw, type Component } from 'vue'
+  import {
+    ElCascader,
+    ElCheckbox,
+    ElCheckboxGroup,
+    ElDatePicker,
+    ElInput,
+    ElInputTag,
+    ElInputNumber,
+    ElRadioGroup,
+    ElRate,
+    ElSelect,
+    ElSlider,
+    ElSwitch,
+    ElTimePicker,
+    ElTimeSelect,
+    ElTreeSelect,
+    type FormInstance
+  } from 'element-plus'
+  import { calculateResponsiveSpan, type ResponsiveBreakpoint } from '@/utils/form/responsive'
+
+  defineOptions({ name: 'ArtSearchBar' })
+
+  const componentMap = {
+    input: ElInput, // 输入框
+    inputTag: ElInputTag, // 标签输入框
+    number: ElInputNumber, // 数字输入框
+    select: ElSelect, // 选择器
+    switch: ElSwitch, // 开关
+    checkbox: ElCheckbox, // 复选框
+    checkboxgroup: ElCheckboxGroup, // 复选框组
+    radiogroup: ElRadioGroup, // 单选框组
+    date: ElDatePicker, // 日期选择器
+    daterange: ElDatePicker, // 日期范围选择器
+    datetime: ElDatePicker, // 日期时间选择器
+    datetimerange: ElDatePicker, // 日期时间范围选择器
+    rate: ElRate, // 评分
+    slider: ElSlider, // 滑块
+    cascader: ElCascader, // 级联选择器
+    timepicker: ElTimePicker, // 时间选择器
+    timeselect: ElTimeSelect, // 时间选择
+    treeselect: ElTreeSelect // 树选择器
+  }
+
+  const { width } = useWindowSize()
+  const { t } = useI18n()
+  const isMobile = computed(() => width.value < 500)
+
+  const formInstance = useTemplateRef<FormInstance>('formRef')
+
+  // 表单项配置
+  export interface SearchFormItem {
+    /** 表单项的唯一标识 */
+    key: string
+    /** 表单项的标签文本或自定义渲染函数 */
+    label: string | (() => VNode) | Component
+    /** 表单项标签的宽度，会覆盖 Form 的 labelWidth */
+    labelWidth?: string | number
+    /** 表单项类型，支持预定义的组件类型 */
+    type?: keyof typeof componentMap | string
+    /** 自定义渲染函数或组件，用于渲染自定义组件（优先级高于 type） */
+    render?: (() => VNode) | Component
+    /** 是否隐藏该表单项 */
+    hidden?: boolean
+    /** 表单项占据的列宽，基于24格栅格系统 */
+    span?: number
+    /** 选项数据，用于 select、checkbox-group、radio-group 等 */
+    options?: Record<string, any>
+    /** 传递给表单项组件的属性 */
+    props?: Record<string, any>
+    /** 表单项的插槽配置 */
+    slots?: Record<string, (() => any) | undefined>
+    /** 表单项的占位符文本 */
+    placeholder?: string
+    /** 更多属性配置请参考 ElementPlus 官方文档 */
+  }
+
+  // 表单配置
+  interface SearchBarProps {
+    /** 表单数据 */
+    items: SearchFormItem[]
+    /** 每列的宽度（基于 24 格布局） */
+    span?: number
+    /** 表单控件间隙 */
+    gutter?: number
+    /** 展开/收起 */
+    isExpand?: boolean
+    /** 默认是否展开（仅在 showExpand 为 true 且 isExpand 为 false 时生效） */
+    defaultExpanded?: boolean
+    /** 表单域标签的位置 */
+    labelPosition?: 'left' | 'right' | 'top'
+    /** 文字宽度 */
+    labelWidth?: string | number
+    /** 是否需要展示，收起 */
+    showExpand?: boolean
+    /** 按钮靠左对齐限制（表单项小于等于该值时） */
+    buttonLeftLimit?: number
+    /** 是否显示重置按钮 */
+    showReset?: boolean
+    /** 是否显示搜索按钮 */
+    showSearch?: boolean
+    /** 是否禁用搜索按钮 */
+    disabledSearch?: boolean
+    /** 搜索时是否清洗空值 */
+    sanitizeOutput?: Partial<SanitizeOutputOptions>
+  }
+
+  interface SanitizeOutputOptions {
+    /** 移除空字符串 */
+    removeEmptyString: boolean
+    /** 移除空数组 */
+    removeEmptyArray: boolean
+    /** 移除清洗后为空的对象 */
+    removeEmptyObject: boolean
+    /** 移除空富文本占位内容，如 <p><br></p> */
+    removeEmptyRichText: boolean
+    /** 保留数字 0 这类有效筛选值 */
+    keepZero: boolean
+    /** 保留 false 这类有效筛选值 */
+    keepFalse: boolean
+  }
+
+  const props = withDefaults(defineProps<SearchBarProps>(), {
+    items: () => [],
+    span: 6,
+    gutter: 12,
+    isExpand: false,
+    labelPosition: 'right',
+    labelWidth: '70px',
+    showExpand: true,
+    defaultExpanded: false,
+    buttonLeftLimit: 2,
+    showReset: true,
+    showSearch: true,
+    disabledSearch: false,
+    sanitizeOutput: () => ({})
+  })
+
+  interface SearchBarEmits {
+    reset: []
+    search: [Record<string, any>]
+  }
+
+  const emit = defineEmits<SearchBarEmits>()
+
+  const modelValue = defineModel<Record<string, any>>({ default: {} })
+  const initialModelValue = ref<Record<string, any>>({})
+
+  // 保存组件初始化时的表单快照，用于 reset 时恢复默认筛选条件。
+  const cloneModelValue = (value: Record<string, any> | undefined) => {
+    if (!value) return {}
+
+    const deepClone = (source: unknown): unknown => {
+      if (Array.isArray(source)) {
+        return source.map((item) => deepClone(item))
+      }
+
+      if (source && typeof source === 'object') {
+        const rawSource = toRaw(source)
+        return Object.keys(rawSource).reduce<Record<string, unknown>>((accumulator, key) => {
+          accumulator[key] = deepClone((rawSource as Record<string, unknown>)[key])
+          return accumulator
+        }, {})
+      }
+
+      return source
+    }
+
+    return deepClone(toRaw(value)) as Record<string, any>
+  }
+
+  initialModelValue.value = cloneModelValue(modelValue.value)
+
+  /**
+   * 是否展开状态
+   */
+  const isExpanded = ref(props.defaultExpanded)
+
+  const rootProps = ['label', 'labelWidth', 'key', 'type', 'hidden', 'span', 'slots']
+  // 搜索参数默认更激进地去掉空值，减少无效 query 参数。
+  const sanitizeOutputOptions = computed<SanitizeOutputOptions>(() => ({
+    removeEmptyString: true,
+    removeEmptyArray: true,
+    removeEmptyObject: true,
+    removeEmptyRichText: true,
+    keepZero: true,
+    keepFalse: true,
+    ...props.sanitizeOutput
+  }))
+
+  const getProps = (item: SearchFormItem) => {
+    if (item.props) return item.props
+    const props = { ...item }
+    rootProps.forEach((key) => delete (props as Record<string, any>)[key])
+    return props
+  }
+
+  // 获取插槽
+  const getSlots = (item: SearchFormItem) => {
+    if (!item.slots) return {}
+    const validSlots: Record<string, () => any> = {}
+    Object.entries(item.slots).forEach(([key, slotFn]) => {
+      if (slotFn) {
+        validSlots[key] = slotFn
+      }
+    })
+    return validSlots
+  }
+
+  /**
+   * 获取列宽 span 值
+   * 根据屏幕尺寸智能降级，避免小屏幕上表单项被压缩过小
+   */
+  const getColSpan = (itemSpan: number | undefined, breakpoint: ResponsiveBreakpoint): number => {
+    return calculateResponsiveSpan(itemSpan, span.value, breakpoint)
+  }
+
+  // 搜索表单清空输入时不保留空字符串，避免后续请求携带空字段。
+  const normalizeFieldValue = (value: unknown) => {
+    return value === '' ? undefined : value
+  }
+
+  const getFieldValue = (key: string) => modelValue.value[key]
+
+  const setFieldValue = (key: string, value: unknown) => {
+    const normalizedValue = normalizeFieldValue(value)
+
+    if (normalizedValue === undefined) {
+      delete modelValue.value[key]
+      return
+    }
+
+    modelValue.value[key] = normalizedValue
+  }
+
+  const isRichTextEmpty = (value: string) => {
+    if (/<(img|video|audio|iframe|embed|object)\b/i.test(value)) {
+      return false
+    }
+
+    // 去掉编辑器常见占位标签后再判断是否还有实际内容。
+    return (
+      value
+        .replace(/&nbsp;/gi, '')
+        .replace(/<br\s*\/?>/gi, '')
+        .replace(/<[^>]*>/g, '')
+        .trim() === ''
+    )
+  }
+
+  // 搜索时按配置清洗空值，但保留 0 和 false 这类有效筛选条件。
+  const sanitizeOutputValue = (value: unknown): unknown => {
+    const options = sanitizeOutputOptions.value
+
+    if (Array.isArray(value)) {
+      const sanitizedArray = value
+        .map((item) => sanitizeOutputValue(item))
+        .filter((item) => item !== undefined)
+      return sanitizedArray.length === 0 && options.removeEmptyArray ? undefined : sanitizedArray
+    }
+
+    if (value && typeof value === 'object') {
+      const rawValue = toRaw(value)
+      const sanitizedObject = Object.entries(rawValue).reduce<Record<string, unknown>>(
+        (accumulator, [key, item]) => {
+          const sanitizedItem = sanitizeOutputValue(item)
+          if (sanitizedItem !== undefined) {
+            accumulator[key] = sanitizedItem
+          }
+          return accumulator
+        },
+        {}
+      )
+      return Object.keys(sanitizedObject).length === 0 && options.removeEmptyObject
+        ? undefined
+        : sanitizedObject
+    }
+
+    if (typeof value === 'string') {
+      if (options.removeEmptyString && value.trim() === '') {
+        return undefined
+      }
+      if (options.removeEmptyRichText && isRichTextEmpty(value)) {
+        return undefined
+      }
+      return value
+    }
+
+    if (value === 0) {
+      return options.keepZero ? value : undefined
+    }
+
+    if (value === false) {
+      return options.keepFalse ? value : undefined
+    }
+
+    return value ?? undefined
+  }
+
+  const getSanitizedOutput = () => {
+    return (sanitizeOutputValue(cloneModelValue(modelValue.value)) || {}) as Record<string, any>
+  }
+
+  // 组件
+  const getComponent = (item: SearchFormItem) => {
+    // 优先使用 render 函数或组件渲染自定义组件
+    if (item.render) {
+      return item.render
+    }
+    // 使用 type 获取预定义组件
+    const { type } = item
+    return componentMap[type as keyof typeof componentMap] || componentMap['input']
+  }
+
+  /**
+   * 可见的表单项
+   */
+  const visibleFormItems = computed(() => {
+    const filteredItems = props.items.filter((item) => !item.hidden)
+    const shouldShowLess = !props.isExpand && !isExpanded.value
+    if (shouldShowLess) {
+      const maxItemsPerRow = Math.floor(24 / props.span) - 1
+      return filteredItems.slice(0, maxItemsPerRow)
+    }
+    return filteredItems
+  })
+
+  /**
+   * 是否应该显示展开/收起按钮
+   */
+  const shouldShowExpandToggle = computed(() => {
+    const filteredItems = props.items.filter((item) => !item.hidden)
+    return (
+      !props.isExpand && props.showExpand && filteredItems.length > Math.floor(24 / props.span) - 1
+    )
+  })
+
+  /**
+   * 展开/收起按钮文本
+   */
+  const expandToggleText = computed(() => {
+    return isExpanded.value ? t('table.searchBar.collapse') : t('table.searchBar.expand')
+  })
+
+  /**
+   * 操作按钮样式
+   */
+  const actionButtonsStyle = computed(() => ({
+    'justify-content': isMobile.value
+      ? 'flex-end'
+      : props.items.filter((item) => !item.hidden).length <= props.buttonLeftLimit
+        ? 'flex-start'
+        : 'flex-end'
+  }))
+
+  /**
+   * 切换展开/收起状态
+   */
+  const toggleExpand = () => {
+    isExpanded.value = !isExpanded.value
+  }
+
+  /**
+   * 处理重置事件
+   */
+  const handleReset = () => {
+    // 重置表单字段（UI 层）
+    formInstance.value?.resetFields()
+
+    // 恢复初始表单值，保留默认搜索条件而不是简单清空。
+    Object.keys(modelValue.value).forEach((key) => {
+      delete modelValue.value[key]
+    })
+    Object.assign(modelValue.value, cloneModelValue(initialModelValue.value))
+
+    // 触发 reset 事件
+    emit('reset')
+  }
+
+  /**
+   * 处理搜索事件
+   */
+  const handleSearch = () => {
+    // 对外只抛出清洗后的查询参数，避免接口收到空数组/空字符串。
+    emit('search', getSanitizedOutput())
+  }
+
+  defineExpose({
+    ref: formInstance,
+    validate: (...args: any[]) => formInstance.value?.validate(...args),
+    reset: handleReset,
+    // 允许外部在手动组装请求前直接读取清洗后的参数。
+    getOutput: getSanitizedOutput
+  })
+
+  // 解构 props 以便在模板中直接使用
+  const { span, gutter, labelPosition, labelWidth } = toRefs(props)
+</script>
+
+<style lang="scss" scoped>
+  .art-search-bar {
+    padding: 15px 20px 0;
+
+    .action-column {
+      flex: 1;
+      max-width: 100%;
+
+      .action-buttons-wrapper {
+        display: flex;
+        flex-wrap: wrap;
+        align-items: center;
+        justify-content: flex-end;
+        margin-bottom: 12px;
+      }
+
+      .form-buttons {
+        display: flex;
+        gap: 8px;
+      }
+
+      .filter-toggle {
+        display: flex;
+        align-items: center;
+        margin-left: 10px;
+        line-height: 32px;
+        color: var(--theme-color);
+        cursor: pointer;
+        transition: color 0.2s ease;
+
+        &:hover {
+          color: var(--ElColor-primary);
+        }
+
+        span {
+          font-size: 14px;
+          user-select: none;
+        }
+
+        .icon-wrapper {
+          display: flex;
+          align-items: center;
+          margin-left: 4px;
+          font-size: 14px;
+          transition: transform 0.2s ease;
+        }
+      }
+    }
+  }
+
+  // 响应式优化
+  @media (width <= 768px) {
+    .art-search-bar {
+      padding: 16px 16px 0;
+
+      .action-column {
+        .action-buttons-wrapper {
+          flex-direction: column;
+          gap: 8px;
+          align-items: stretch;
+
+          .form-buttons {
+            justify-content: center;
+          }
+
+          .filter-toggle {
+            justify-content: center;
+            margin-left: 0;
+          }
+        }
+      }
+    }
+  }
+</style>
diff --git a/web/src/components/core/forms/art-wang-editor/index.vue b/web/src/components/core/forms/art-wang-editor/index.vue
new file mode 100644
index 0000000..db3028a
--- /dev/null
+++ b/web/src/components/core/forms/art-wang-editor/index.vue
@@ -0,0 +1,260 @@
+<!-- WangEditor 富文本编辑器 插件地址：https://www.wangeditor.com/ -->
+<template>
+  <div class="editor-wrapper">
+    <Toolbar
+      class="editor-toolbar"
+      :editor="editorRef"
+      :mode="mode"
+      :defaultConfig="toolbarConfig"
+    />
+    <Editor
+      :style="{ height: height, overflowY: 'hidden' }"
+      v-model="modelValue"
+      :mode="mode"
+      :defaultConfig="editorConfig"
+      @onCreated="onCreateEditor"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import '@wangeditor/editor/dist/css/style.css'
+  import { onBeforeUnmount, onMounted, shallowRef, computed } from 'vue'
+  import { Editor, Toolbar } from '@wangeditor/editor-for-vue'
+  import { useUserStore } from '@/store/modules/user'
+  import EmojiText from '@/utils/ui/emojo'
+  import { IDomEditor, IToolbarConfig, IEditorConfig } from '@wangeditor/editor'
+  import request from '@/utils/http'
+
+  defineOptions({ name: 'ArtWangEditor' })
+
+  type InsertFnType = (url: string, alt: string, href: string) => void
+
+  const { VITE_API_URL } = import.meta.env
+
+  // Props 定义
+  interface Props {
+    /** 编辑器高度 */
+    height?: string
+    /** 自定义工具栏配置 */
+    toolbarKeys?: string[]
+    /** 插入新工具到指定位置 */
+    insertKeys?: { index: number; keys: string[] }
+    /** 排除的工具栏项 */
+    excludeKeys?: string[]
+    /** 编辑器模式 */
+    mode?: 'default' | 'simple'
+    /** 占位符文本 */
+    placeholder?: string
+    /** 上传配置 */
+    uploadConfig?: {
+      maxFileSize?: number
+      maxNumberOfFiles?: number
+      server?: string
+      // 是否开启自定义上传
+      isCustomUpload?: boolean
+    }
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    height: '500px',
+    mode: 'default',
+    placeholder: '请输入内容...',
+    excludeKeys: () => ['fontFamily'],
+    isCustomUpload: false
+  })
+
+  const modelValue = defineModel<string>({ required: true })
+
+  // 编辑器实例
+  const editorRef = shallowRef<IDomEditor>()
+  const userStore = useUserStore()
+
+  // 常量配置
+  const DEFAULT_UPLOAD_CONFIG = {
+    maxFileSize: 3 * 1024 * 1024, // 3MB
+    maxNumberOfFiles: 10,
+    fieldName: 'file',
+    allowedFileTypes: ['image/*']
+  } as const
+
+  // 计算属性：上传服务器地址
+  const uploadServer = computed(
+    () => props.uploadConfig?.server || `${VITE_API_URL}/api/common/upload/wangeditor`
+  )
+
+  // 合并上传配置
+  const mergedUploadConfig = computed(() => ({
+    ...DEFAULT_UPLOAD_CONFIG,
+    ...props.uploadConfig
+  }))
+
+  // 工具栏配置
+  const toolbarConfig = computed((): Partial<IToolbarConfig> => {
+    const config: Partial<IToolbarConfig> = {}
+
+    // 完全自定义工具栏
+    if (props.toolbarKeys && props.toolbarKeys.length > 0) {
+      config.toolbarKeys = props.toolbarKeys
+    }
+
+    // 插入新工具
+    if (props.insertKeys) {
+      config.insertKeys = props.insertKeys
+    }
+
+    // 排除工具
+    if (props.excludeKeys && props.excludeKeys.length > 0) {
+      config.excludeKeys = props.excludeKeys
+    }
+
+    return config
+  })
+
+  // 编辑器配置
+  const editorConfig: Partial<IEditorConfig> = {
+    placeholder: props.placeholder,
+    MENU_CONF: {
+      uploadImage: {
+        fieldName: mergedUploadConfig.value.fieldName,
+        maxFileSize: mergedUploadConfig.value.maxFileSize,
+        maxNumberOfFiles: mergedUploadConfig.value.maxNumberOfFiles,
+        allowedFileTypes: mergedUploadConfig.value.allowedFileTypes,
+        server: uploadServer.value,
+        headers: {
+          Authorization: userStore.accessToken
+        },
+        onSuccess() {
+          ElMessage.success(`图片上传成功 ${EmojiText[200]}`)
+        },
+        onError(file: File, err: any, res: any) {
+          console.error('图片上传失败:', err, res)
+          ElMessage.error(`图片上传失败 ${EmojiText[500]}`)
+        }
+      }
+    }
+  }
+
+  // 自定义上传
+  if (props.uploadConfig?.isCustomUpload && props.uploadConfig?.server && editorConfig.MENU_CONF) {
+    editorConfig.MENU_CONF.uploadImage.customUpload = async (
+      file: File,
+      insertFn: InsertFnType
+    ) => {
+      try {
+        const formData = new FormData()
+        formData.append(mergedUploadConfig.value.fieldName, file)
+
+        const response = await request.post<{ url: string; alt: string; href: string }>({
+          url: props.uploadConfig?.server,
+          data: formData,
+          headers: {
+            'Content-Type': 'multipart/form-data',
+            Authorization: userStore.accessToken
+          }
+        })
+
+        const { url, alt, href } = response
+
+        if (!url) {
+          throw new Error('上传失败，请检查服务端配置')
+        }
+
+        insertFn(url, alt, href)
+        ElMessage.success(`图片上传成功 ${EmojiText[200]}`)
+      } catch (error) {
+        console.error('图片上传失败:', error)
+        ElMessage.error(`图片上传失败 ${EmojiText[500]}`)
+      }
+    }
+  }
+
+  // 编辑器创建回调
+  const onCreateEditor = (editor: IDomEditor) => {
+    editorRef.value = editor
+
+    // 监听全屏事件
+    editor.on('fullScreen', () => {
+      console.log('编辑器进入全屏模式')
+    })
+
+    // 确保在编辑器创建后应用自定义图标
+    applyCustomIcons()
+  }
+
+  // 应用自定义图标（带重试机制）
+  const applyCustomIcons = () => {
+    let retryCount = 0
+    const maxRetries = 10
+    const retryDelay = 100
+
+    const tryApplyIcons = () => {
+      const editor = editorRef.value
+      if (!editor) {
+        if (retryCount < maxRetries) {
+          retryCount++
+          setTimeout(tryApplyIcons, retryDelay)
+        }
+        return
+      }
+
+      // 获取当前编辑器的工具栏容器
+      const editorContainer = editor.getEditableContainer().closest('.editor-wrapper')
+      if (!editorContainer) {
+        if (retryCount < maxRetries) {
+          retryCount++
+          setTimeout(tryApplyIcons, retryDelay)
+        }
+        return
+      }
+
+      const toolbar = editorContainer.querySelector('.w-e-toolbar')
+      const toolbarButtons = editorContainer.querySelectorAll('.w-e-bar-item button[data-menu-key]')
+
+      if (toolbar && toolbarButtons.length > 0) {
+        return
+      }
+
+      // 如果工具栏还没渲染完成，继续重试
+      if (retryCount < maxRetries) {
+        retryCount++
+        setTimeout(tryApplyIcons, retryDelay)
+      } else {
+        console.warn('工具栏渲染超时，无法应用自定义图标 - 编辑器实例:', editor.id)
+      }
+    }
+
+    // 使用 requestAnimationFrame 确保在下一帧执行
+    requestAnimationFrame(tryApplyIcons)
+  }
+
+  // 暴露编辑器实例和方法
+  defineExpose({
+    /** 获取编辑器实例 */
+    getEditor: () => editorRef.value,
+    /** 设置编辑器内容 */
+    setHtml: (html: string) => editorRef.value?.setHtml(html),
+    /** 获取编辑器内容 */
+    getHtml: () => editorRef.value?.getHtml(),
+    /** 清空编辑器 */
+    clear: () => editorRef.value?.clear(),
+    /** 聚焦编辑器 */
+    focus: () => editorRef.value?.focus()
+  })
+
+  // 生命周期
+  onMounted(() => {
+    // 图标替换已在 onCreateEditor 中处理
+  })
+
+  onBeforeUnmount(() => {
+    const editor = editorRef.value
+    if (editor) {
+      editor.destroy()
+    }
+  })
+</script>
+
+<style lang="scss">
+  @use './style';
+</style>
diff --git a/web/src/components/core/forms/art-wang-editor/style.scss b/web/src/components/core/forms/art-wang-editor/style.scss
new file mode 100644
index 0000000..7f22e98
--- /dev/null
+++ b/web/src/components/core/forms/art-wang-editor/style.scss
@@ -0,0 +1,273 @@
+$box-radius: calc(var(--custom-radius) / 3 + 2px);
+
+// 全屏容器 z-index 调整
+.w-e-full-screen-container {
+  z-index: 100 !important;
+}
+
+/* 编辑器容器 */
+.editor-wrapper {
+  width: 100%;
+  height: 100%;
+  border: 1px solid var(--art-gray-300);
+  border-radius: $box-radius !important;
+
+  .w-e-bar {
+    border-radius: $box-radius $box-radius 0 0 !important;
+  }
+
+  .menu-item {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+
+    i {
+      margin-right: 5px;
+    }
+  }
+
+  /* 工具栏 */
+  .editor-toolbar {
+    border-bottom: 1px solid var(--default-border);
+  }
+
+  /* 下拉选择框配置 */
+  .w-e-select-list {
+    min-width: 140px;
+    padding: 5px 10px 10px;
+    border: none;
+    border-radius: $box-radius;
+  }
+
+  /* 下拉选择框元素配置 */
+  .w-e-select-list ul li {
+    margin-top: 5px;
+    font-size: 15px !important;
+    border-radius: $box-radius;
+  }
+
+  /* 下拉选择框 正文文字大小调整 */
+  .w-e-select-list ul li:last-of-type {
+    font-size: 16px !important;
+  }
+
+  /* 下拉选择框 hover 样式调整 */
+  .w-e-select-list ul li:hover {
+    background-color: var(--art-gray-200);
+  }
+
+  :root {
+    /* 激活颜色 */
+    --w-e-toolbar-active-bg-color: var(--art-gray-200);
+
+    /* toolbar 图标和文字颜色 */
+    --w-e-toolbar-color: #000;
+
+    /* 表格选中时候的边框颜色 */
+    --w-e-textarea-selected-border-color: #ddd;
+
+    /* 表格头背景颜色 */
+    --w-e-textarea-slight-bg-color: var(--art-gray-200);
+  }
+
+  /* 工具栏按钮样式 */
+  .w-e-bar-item svg {
+    fill: var(--art-gray-800);
+  }
+
+  .w-e-bar-item button {
+    color: var(--art-gray-800);
+    border-radius: $box-radius;
+  }
+
+  /* 工具栏 hover 按钮背景颜色 */
+  .w-e-bar-item button:hover {
+    background-color: var(--art-gray-200);
+  }
+
+  /* 工具栏分割线 */
+  .w-e-bar-divider {
+    height: 20px;
+    margin-top: 10px;
+    background-color: #ccc;
+  }
+
+  /* 工具栏菜单 */
+  .w-e-bar-item-group .w-e-bar-item-menus-container {
+    min-width: 120px;
+    padding: 10px 0;
+    border: none;
+    border-radius: $box-radius;
+
+    .w-e-bar-item {
+      button {
+        width: 100%;
+        margin: 0 5px;
+      }
+    }
+  }
+
+  /* 代码块 */
+  .w-e-text-container [data-slate-editor] pre > code {
+    padding: 0.6rem 1rem;
+    background-color: var(--art-gray-50);
+    border-radius: $box-radius;
+  }
+
+  /* 弹出框 */
+  .w-e-drop-panel {
+    border: 0;
+    border-radius: $box-radius;
+  }
+
+  a {
+    color: #318ef4;
+  }
+
+  .w-e-text-container {
+    [data-slate-editor] {
+      h1,
+      h2,
+      h3,
+      h4,
+      h5,
+      h6 {
+        margin: 0.8em 0 0.4em;
+        font-weight: 700;
+        line-height: 1.35;
+      }
+
+      h1 {
+        font-size: 2em;
+      }
+
+      h2 {
+        font-size: 1.5em;
+      }
+
+      h3 {
+        font-size: 1.25em;
+      }
+
+      h4 {
+        font-size: 1.125em;
+      }
+
+      h5 {
+        font-size: 1em;
+      }
+
+      h6 {
+        font-size: 0.875em;
+      }
+
+      ul,
+      ol {
+        padding-left: 1.5em;
+        margin: 0.8em 0;
+      }
+
+      ul {
+        list-style: disc;
+      }
+
+      ol {
+        list-style: decimal;
+      }
+
+      li {
+        margin: 0.25em 0;
+      }
+
+      ul ul {
+        list-style: circle;
+      }
+
+      ul ul ul {
+        list-style: square;
+      }
+    }
+
+    strong,
+    b {
+      font-weight: 700;
+    }
+
+    i,
+    em {
+      font-style: italic;
+    }
+  }
+
+  /* 表格样式优化 */
+  .w-e-text-container [data-slate-editor] .table-container th {
+    border-right: none;
+  }
+
+  .w-e-text-container [data-slate-editor] .table-container th:last-of-type {
+    border-right: 1px solid #ccc !important;
+  }
+
+  /* 引用 */
+  .w-e-text-container [data-slate-editor] blockquote {
+    background-color: var(--art-gray-200);
+    border-left: 4px solid var(--art-gray-300);
+  }
+
+  /* 输入区域弹出 bar  */
+  .w-e-hover-bar {
+    border-radius: $box-radius;
+  }
+
+  /* 超链接弹窗 */
+  .w-e-modal {
+    border: none;
+    border-radius: $box-radius;
+  }
+
+  /* 图片样式调整 */
+  .w-e-text-container [data-slate-editor] .w-e-selected-image-container {
+    overflow: inherit;
+
+    &:hover {
+      border: 0;
+    }
+
+    img {
+      border: 1px solid transparent;
+      transition: border 0.3s;
+
+      &:hover {
+        border: 1px solid #318ef4 !important;
+      }
+    }
+
+    .w-e-image-dragger {
+      width: 12px;
+      height: 12px;
+      background-color: #318ef4;
+      border: 2px solid #fff;
+      border-radius: $box-radius;
+    }
+
+    .left-top {
+      top: -6px;
+      left: -6px;
+    }
+
+    .right-top {
+      top: -6px;
+      right: -6px;
+    }
+
+    .left-bottom {
+      bottom: -6px;
+      left: -6px;
+    }
+
+    .right-bottom {
+      right: -6px;
+      bottom: -6px;
+    }
+  }
+}
diff --git a/web/src/components/core/layouts/art-breadcrumb/index.vue b/web/src/components/core/layouts/art-breadcrumb/index.vue
new file mode 100755
index 0000000..4b54859
--- /dev/null
+++ b/web/src/components/core/layouts/art-breadcrumb/index.vue
@@ -0,0 +1,142 @@
+<!-- 面包屑导航 -->
+<template>
+  <nav class="ml-2.5 max-lg:!hidden" aria-label="breadcrumb">
+    <ul class="flex-c h-full">
+      <li
+        v-for="(item, index) in breadcrumbItems"
+        :key="item.path"
+        class="box-border flex-c h-7 text-sm leading-7"
+      >
+        <div
+          :class="
+            isClickable(item, index)
+              ? 'c-p py-1 rounded tad-200 hover:bg-active-color hover:[&_span]:text-g-600'
+              : ''
+          "
+          @click="handleBreadcrumbClick(item, index)"
+        >
+          <span
+            class="block max-w-46 overflow-hidden text-ellipsis whitespace-nowrap px-1.5 text-sm text-g-600 dark:text-g-800"
+            >{{ formatMenuTitle(item.meta?.title as string) }}</span
+          >
+        </div>
+        <div
+          v-if="!isLastItem(index) && item.meta?.title"
+          class="mx-1 text-sm not-italic text-g-500"
+          aria-hidden="true"
+        >
+          /
+        </div>
+      </li>
+    </ul>
+  </nav>
+</template>
+
+<script setup lang="ts">
+  import { computed } from 'vue'
+  import { useRouter, useRoute } from 'vue-router'
+  import type { RouteLocationMatched, RouteRecordRaw } from 'vue-router'
+  import { formatMenuTitle } from '@/utils/router'
+
+  defineOptions({ name: 'ArtBreadcrumb' })
+
+  export interface BreadcrumbItem {
+    path: string
+    meta: RouteRecordRaw['meta']
+  }
+
+  const route = useRoute()
+  const router = useRouter()
+
+  // 使用computed替代watch，提高性能
+  const breadcrumbItems = computed<BreadcrumbItem[]>(() => {
+    const { matched } = route
+    const matchedLength = matched.length
+
+    // 处理首页情况
+    if (!matchedLength || isHomeRoute(matched[0])) {
+      return []
+    }
+
+    // 处理一级菜单和普通路由
+    const firstRoute = matched[0]
+    const isFirstLevel = firstRoute.meta?.isFirstLevel
+    const lastIndex = matchedLength - 1
+    const currentRoute = matched[lastIndex]
+    const currentRouteMeta = currentRoute.meta
+
+    let items = isFirstLevel
+      ? [createBreadcrumbItem(currentRoute)]
+      : matched.map(createBreadcrumbItem)
+
+    // 过滤包裹容器：如果有多个项目且第一个是容器路由（如 /outside），则移除它
+    if (items.length > 1 && isWrapperContainer(items[0])) {
+      items = items.slice(1)
+    }
+
+    // IFrame 页面特殊处理：如果过滤后只剩一个 iframe 页面，或者所有项都是包裹容器，则仅展示当前页
+    if (currentRouteMeta?.isIframe && (items.length === 1 || items.every(isWrapperContainer))) {
+      return [createBreadcrumbItem(currentRoute)]
+    }
+
+    return items
+  })
+
+  // 辅助函数：判断是否为包裹容器路由
+  const isWrapperContainer = (item: BreadcrumbItem): boolean =>
+    item.path === '/outside' && !!item.meta?.isIframe
+
+  // 辅助函数：创建面包屑项目
+  const createBreadcrumbItem = (route: RouteLocationMatched): BreadcrumbItem => ({
+    path: route.path,
+    meta: route.meta
+  })
+
+  // 辅助函数：判断是否为首页
+  const isHomeRoute = (route: RouteLocationMatched): boolean => route.name === '/'
+
+  // 辅助函数：判断是否为最后一项
+  const isLastItem = (index: number): boolean => {
+    const itemsLength = breadcrumbItems.value.length
+    return index === itemsLength - 1
+  }
+
+  // 辅助函数：判断是否可点击
+  const isClickable = (item: BreadcrumbItem, index: number): boolean =>
+    item.path !== '/outside' && !isLastItem(index)
+
+  // 辅助函数：查找路由的第一个有效子路由
+  const findFirstValidChild = (route: RouteRecordRaw) =>
+    route.children?.find((child) => !child.redirect && !child.meta?.isHide)
+
+  // 辅助函数：构建完整路径
+  const buildFullPath = (childPath: string): string => `/${childPath}`.replace('//', '/')
+
+  // 处理面包屑点击事件
+  async function handleBreadcrumbClick(item: BreadcrumbItem, index: number): Promise<void> {
+    // 如果是最后一项或外部链接，不处理
+    if (isLastItem(index) || item.path === '/outside') {
+      return
+    }
+
+    try {
+      // 缓存路由表查找结果
+      const routes = router.getRoutes()
+      const targetRoute = routes.find((route) => route.path === item.path)
+
+      if (!targetRoute?.children?.length) {
+        await router.push(item.path)
+        return
+      }
+
+      const firstValidChild = findFirstValidChild(targetRoute)
+      if (firstValidChild) {
+        await router.push(buildFullPath(firstValidChild.path))
+      } else {
+        await router.push(item.path)
+      }
+    } catch (error) {
+      console.error('导航失败:', error)
+    }
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-chat-window/index.vue b/web/src/components/core/layouts/art-chat-window/index.vue
new file mode 100644
index 0000000..f3d9471
--- /dev/null
+++ b/web/src/components/core/layouts/art-chat-window/index.vue
@@ -0,0 +1,262 @@
+<!-- 系统聊天窗口 -->
+<template>
+  <div>
+    <ElDrawer v-model="isDrawerVisible" :size="isMobile ? '100%' : '480px'" :with-header="false">
+      <div class="mb-5 flex-cb">
+        <div>
+          <span class="text-base font-medium">Art Bot</span>
+          <div class="mt-1.5 flex-c gap-1">
+            <div
+              class="h-2 w-2 rounded-full"
+              :class="isOnline ? 'bg-success/100' : 'bg-danger/100'"
+            ></div>
+            <span class="text-xs text-g-600">{{ isOnline ? '在线' : '离线' }}</span>
+          </div>
+        </div>
+        <div>
+          <ElIcon class="c-p" :size="20" @click="closeChat">
+            <Close />
+          </ElIcon>
+        </div>
+      </div>
+      <div class="flex h-[calc(100%-70px)] flex-col">
+        <!-- 聊天消息区域 -->
+        <div
+          class="flex-1 overflow-y-auto border-t-d px-4 py-7.5 [&::-webkit-scrollbar]:!w-1"
+          ref="messageContainer"
+        >
+          <template v-for="(message, index) in messages" :key="index">
+            <div
+              :class="[
+                'mb-7.5 flex w-full items-start gap-2',
+                message.isMe ? 'flex-row-reverse' : 'flex-row'
+              ]"
+            >
+              <ElAvatar :size="32" :src="message.avatar" class="shrink-0" />
+              <div
+                :class="['flex max-w-[70%] flex-col', message.isMe ? 'items-end' : 'items-start']"
+              >
+                <div
+                  :class="[
+                    'mb-1 flex gap-2 text-xs',
+                    message.isMe ? 'flex-row-reverse' : 'flex-row'
+                  ]"
+                >
+                  <span class="font-medium">{{ message.sender }}</span>
+                  <span class="text-g-600">{{ message.time }}</span>
+                </div>
+                <div
+                  :class="[
+                    'rounded-md px-3.5 py-2.5 text-sm leading-[1.4] text-g-900',
+                    message.isMe ? 'message-right bg-theme/15' : 'message-left bg-g-300/50'
+                  ]"
+                  >{{ message.content }}</div
+                >
+              </div>
+            </div>
+          </template>
+        </div>
+
+        <!-- 聊天输入区域 -->
+        <div class="px-4 pt-4">
+          <ElInput
+            v-model="messageText"
+            type="textarea"
+            :rows="3"
+            placeholder="输入消息"
+            resize="none"
+            @keyup.enter.prevent="sendMessage"
+          >
+            <template #append>
+              <div class="flex gap-2 py-2">
+                <ElButton :icon="Paperclip" circle plain />
+                <ElButton :icon="Picture" circle plain />
+                <ElButton type="primary" @click="sendMessage" v-ripple>发送</ElButton>
+              </div>
+            </template>
+          </ElInput>
+          <div class="mt-3 flex-cb">
+            <div class="flex-c">
+              <ArtSvgIcon icon="ri:image-line" class="mr-5 c-p text-g-600 text-lg" />
+              <ArtSvgIcon icon="ri:emotion-happy-line" class="mr-5 c-p text-g-600 text-lg" />
+            </div>
+            <ElButton type="primary" @click="sendMessage" v-ripple class="min-w-20">发送</ElButton>
+          </div>
+        </div>
+      </div>
+    </ElDrawer>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Picture, Paperclip, Close } from '@element-plus/icons-vue'
+  import { mittBus } from '@/utils/sys'
+  import meAvatar from '@/assets/images/avatar/avatar5.webp'
+  import aiAvatar from '@/assets/images/avatar/avatar10.webp'
+
+  defineOptions({ name: 'ArtChatWindow' })
+
+  // 类型定义
+  interface ChatMessage {
+    id: number
+    sender: string
+    content: string
+    time: string
+    isMe: boolean
+    avatar: string
+  }
+
+  // 常量定义
+  const MOBILE_BREAKPOINT = 640
+  const SCROLL_DELAY = 100
+  const BOT_NAME = 'Art Bot'
+  const USER_NAME = 'Ricky'
+
+  // 响应式布局
+  const { width } = useWindowSize()
+  const isMobile = computed(() => width.value < MOBILE_BREAKPOINT)
+
+  // 组件状态
+  const isDrawerVisible = ref(false)
+  const isOnline = ref(true)
+
+  // 消息相关状态
+  const messageText = ref('')
+  const messageId = ref(10)
+  const messageContainer = ref<HTMLElement | null>(null)
+
+  // 初始化聊天消息数据
+  const initializeMessages = (): ChatMessage[] => [
+    {
+      id: 1,
+      sender: BOT_NAME,
+      content: '你好！我是你的AI助手，有什么我可以帮你的吗？',
+      time: '10:00',
+      isMe: false,
+      avatar: aiAvatar
+    },
+    {
+      id: 2,
+      sender: USER_NAME,
+      content: '我想了解一下系统的使用方法。',
+      time: '10:01',
+      isMe: true,
+      avatar: meAvatar
+    },
+    {
+      id: 3,
+      sender: BOT_NAME,
+      content: '好的，我来为您介绍系统的主要功能。首先，您可以通过左侧菜单访问不同的功能模块...',
+      time: '10:02',
+      isMe: false,
+      avatar: aiAvatar
+    },
+    {
+      id: 4,
+      sender: USER_NAME,
+      content: '听起来很不错，能具体讲讲数据分析部分吗？',
+      time: '10:05',
+      isMe: true,
+      avatar: meAvatar
+    },
+    {
+      id: 5,
+      sender: BOT_NAME,
+      content: '当然可以。数据分析模块可以帮助您实时监控关键指标，并生成详细的报表...',
+      time: '10:06',
+      isMe: false,
+      avatar: aiAvatar
+    },
+    {
+      id: 6,
+      sender: USER_NAME,
+      content: '太好了，那我如何开始使用呢？',
+      time: '10:08',
+      isMe: true,
+      avatar: meAvatar
+    },
+    {
+      id: 7,
+      sender: BOT_NAME,
+      content: '您可以先创建一个项目，然后在项目中添加相关的数据源，系统会自动进行分析。',
+      time: '10:09',
+      isMe: false,
+      avatar: aiAvatar
+    },
+    {
+      id: 8,
+      sender: USER_NAME,
+      content: '明白了，谢谢你的帮助！',
+      time: '10:10',
+      isMe: true,
+      avatar: meAvatar
+    },
+    {
+      id: 9,
+      sender: BOT_NAME,
+      content: '不客气，有任何问题随时联系我。',
+      time: '10:11',
+      isMe: false,
+      avatar: aiAvatar
+    }
+  ]
+
+  const messages = ref<ChatMessage[]>(initializeMessages())
+
+  // 工具函数
+  const formatCurrentTime = (): string => {
+    return new Date().toLocaleTimeString([], {
+      hour: '2-digit',
+      minute: '2-digit'
+    })
+  }
+
+  const scrollToBottom = (): void => {
+    nextTick(() => {
+      setTimeout(() => {
+        if (messageContainer.value) {
+          messageContainer.value.scrollTop = messageContainer.value.scrollHeight
+        }
+      }, SCROLL_DELAY)
+    })
+  }
+
+  // 消息处理方法
+  const sendMessage = (): void => {
+    const text = messageText.value.trim()
+    if (!text) return
+
+    const newMessage: ChatMessage = {
+      id: messageId.value++,
+      sender: USER_NAME,
+      content: text,
+      time: formatCurrentTime(),
+      isMe: true,
+      avatar: meAvatar
+    }
+
+    messages.value.push(newMessage)
+    messageText.value = ''
+    scrollToBottom()
+  }
+
+  // 聊天窗口控制方法
+  const openChat = (): void => {
+    isDrawerVisible.value = true
+    scrollToBottom()
+  }
+
+  const closeChat = (): void => {
+    isDrawerVisible.value = false
+  }
+
+  // 生命周期
+  onMounted(() => {
+    scrollToBottom()
+    mittBus.on('openChat', openChat)
+  })
+
+  onUnmounted(() => {
+    mittBus.off('openChat', openChat)
+  })
+</script>
diff --git a/web/src/components/core/layouts/art-fast-enter/index.vue b/web/src/components/core/layouts/art-fast-enter/index.vue
new file mode 100644
index 0000000..fdde222
--- /dev/null
+++ b/web/src/components/core/layouts/art-fast-enter/index.vue
@@ -0,0 +1,113 @@
+<!-- 顶部快速入口面板 -->
+<template>
+  <ElPopover
+    ref="popoverRef"
+    :width="700"
+    :offset="0"
+    :show-arrow="false"
+    trigger="hover"
+    placement="bottom-start"
+    popper-class="fast-enter-popover"
+    :popper-style="{
+      border: '1px solid var(--default-border)',
+      borderRadius: 'calc(var(--custom-radius) / 2 + 4px)'
+    }"
+  >
+    <template #reference>
+      <div class="flex-c gap-2">
+        <slot />
+      </div>
+    </template>
+
+    <div class="grid grid-cols-[2fr_0.8fr]">
+      <div>
+        <div class="grid grid-cols-2 gap-1.5">
+          <!-- 应用列表 -->
+          <div
+            v-for="application in enabledApplications"
+            :key="application.name"
+            class="mr-3 c-p flex-c gap-3 rounded-lg p-2 hover:bg-g-200/70 dark:hover:bg-g-200/90 hover:[&_.app-icon]:!bg-transparent"
+            @click="handleApplicationClick(application)"
+          >
+            <div class="app-icon size-12 flex-cc rounded-lg bg-g-200/80 dark:bg-g-300/30">
+              <ArtSvgIcon
+                class="text-xl"
+                :icon="application.icon"
+                :style="{ color: application.iconColor }"
+              />
+            </div>
+            <div>
+              <h3 class="m-0 text-sm font-medium text-g-800">{{ application.name }}</h3>
+              <p class="mt-1 text-xs text-g-600">{{ application.description }}</p>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <div class="border-l-d pl-6 pt-2">
+        <h3 class="mb-2.5 text-base font-medium text-g-800">快速链接</h3>
+        <ul>
+          <li
+            v-for="quickLink in enabledQuickLinks"
+            :key="quickLink.name"
+            class="c-p py-2 hover:[&_span]:text-theme"
+            @click="handleQuickLinkClick(quickLink)"
+          >
+            <span class="text-g-600 no-underline">{{ quickLink.name }}</span>
+          </li>
+        </ul>
+      </div>
+    </div>
+  </ElPopover>
+</template>
+
+<script setup lang="ts">
+  import { useFastEnter } from '@/hooks/core/useFastEnter'
+  import type { FastEnterApplication, FastEnterQuickLink } from '@/types/config'
+
+  defineOptions({ name: 'ArtFastEnter' })
+
+  const router = useRouter()
+  const popoverRef = ref()
+
+  // 使用快速入口配置
+  const { enabledApplications, enabledQuickLinks } = useFastEnter()
+
+  /**
+   * 处理导航跳转
+   * @param routeName 路由名称
+   * @param link 外部链接
+   */
+  const handleNavigate = (routeName?: string, link?: string): void => {
+    const targetPath = routeName || link
+
+    if (!targetPath) {
+      console.warn('导航配置无效：缺少路由名称或链接')
+      return
+    }
+
+    if (targetPath.startsWith('http')) {
+      window.open(targetPath, '_blank')
+    } else {
+      router.push({ name: targetPath })
+    }
+
+    popoverRef.value?.hide()
+  }
+
+  /**
+   * 处理应用项点击
+   * @param application 应用配置对象
+   */
+  const handleApplicationClick = (application: FastEnterApplication): void => {
+    handleNavigate(application.routeName, application.link)
+  }
+
+  /**
+   * 处理快速链接点击
+   * @param quickLink 快速链接配置对象
+   */
+  const handleQuickLinkClick = (quickLink: FastEnterQuickLink): void => {
+    handleNavigate(quickLink.routeName, quickLink.link)
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-fireworks-effect/index.vue b/web/src/components/core/layouts/art-fireworks-effect/index.vue
new file mode 100644
index 0000000..be85274
--- /dev/null
+++ b/web/src/components/core/layouts/art-fireworks-effect/index.vue
@@ -0,0 +1,633 @@
+<!-- 烟花效果 | 礼花效果 -->
+<template>
+  <canvas
+    ref="canvasRef"
+    class="fixed top-0 left-0 z-[9999] w-full h-full pointer-events-none"
+  ></canvas>
+</template>
+
+<script setup lang="ts">
+  import { useEventListener } from '@vueuse/core'
+  import { mittBus } from '@/utils/sys'
+  import type { Handler } from 'mitt'
+  import bp from '@/assets/images/ceremony/hb.png'
+  import sd from '@/assets/images/ceremony/sd.png'
+  import yd from '@/assets/images/ceremony/yd.png'
+
+  defineOptions({ name: 'ArtFireworksEffect' })
+
+  /**
+   * 烟花系统配置接口
+   * 定义了烟花效果的所有可配置参数
+   */
+  interface FireworkConfig {
+    /** 对象池大小 - 预先创建的粒子对象数量 */
+    readonly POOL_SIZE: number
+    /** 每次爆炸产生的粒子数量 */
+    readonly PARTICLES_PER_BURST: number
+    /** 各种形状的尺寸配置 */
+    readonly SIZES: {
+      /** 矩形粒子的宽高 */
+      readonly RECTANGLE: { readonly WIDTH: number; readonly HEIGHT: number }
+      /** 正方形粒子的边长 */
+      readonly SQUARE: { readonly SIZE: number }
+      /** 圆形粒子的直径 */
+      readonly CIRCLE: { readonly SIZE: number }
+      /** 三角形粒子的边长 */
+      readonly TRIANGLE: { readonly SIZE: number }
+      /** 椭圆粒子的宽高 */
+      readonly OVAL: { readonly WIDTH: number; readonly HEIGHT: number }
+      /** 图片粒子的宽高 */
+      readonly IMAGE: { readonly WIDTH: number; readonly HEIGHT: number }
+    }
+    /** 旋转相关参数 */
+    readonly ROTATION: {
+      /** 基础旋转速度 */
+      readonly BASE_SPEED: number
+      /** 随机旋转速度增量 */
+      readonly RANDOM_SPEED: number
+      /** 旋转衰减系数 - 控制旋转速度递减 */
+      readonly DECAY: number
+    }
+    /** 物理效果参数 */
+    readonly PHYSICS: {
+      /** 重力加速度 */
+      readonly GRAVITY: number
+      /** 下落速度阈值 - 超过此值开始淡出 */
+      readonly VELOCITY_THRESHOLD: number
+      /** 透明度衰减速度 */
+      readonly OPACITY_DECAY: number
+    }
+    /** 烟花粒子颜色配置(带透明度) */
+    readonly COLORS: readonly string[]
+    /** 烟花粒子形状配置(矩形出现概率更高) */
+    readonly SHAPES: readonly string[]
+  }
+
+  /**
+   * 单个烟花粒子对象
+   * 包含粒子的位置、速度、外观等所有属性
+   */
+  interface Firework {
+    /** X坐标位置 */
+    x: number
+    /** Y坐标位置 */
+    y: number
+    /** X方向速度 */
+    vx: number
+    /** Y方向速度 */
+    vy: number
+    /** 粒子颜色 (RGBA格式) */
+    color: string
+    /** 当前旋转角度 */
+    rotation: number
+    /** 旋转速度 */
+    rotationSpeed: number
+    /** 缩放比例 */
+    scale: number
+    /** 粒子形状类型 */
+    shape: string
+    /** 透明度 (0-1) */
+    opacity: number
+    /** 是否处于活动状态 */
+    active: boolean
+    /** 图片URL (当shape为image时使用) */
+    imageUrl?: string
+  }
+
+  /**
+   * 图片缓存接口
+   * 用于缓存预加载的图片资源
+   */
+  interface ImageCache {
+    [url: string]: HTMLImageElement
+  }
+
+  /**
+   * 烟花效果的全局配置
+   * 使用 as const 确保配置的不可变性
+   */
+  const CONFIG: FireworkConfig = {
+    // 性能相关配置
+    POOL_SIZE: 600, // 对象池大小，影响同时存在的最大粒子数
+    PARTICLES_PER_BURST: 200, // 每次爆炸的粒子数量，影响视觉效果密度
+
+    // 粒子尺寸配置
+    SIZES: {
+      RECTANGLE: { WIDTH: 24, HEIGHT: 12 }, // 矩形粒子尺寸
+      SQUARE: { SIZE: 12 }, // 正方形粒子尺寸
+      CIRCLE: { SIZE: 12 }, // 圆形粒子尺寸
+      TRIANGLE: { SIZE: 10 }, // 三角形粒子尺寸
+      OVAL: { WIDTH: 24, HEIGHT: 12 }, // 椭圆粒子尺寸
+      IMAGE: { WIDTH: 30, HEIGHT: 30 } // 图片粒子尺寸
+    },
+
+    // 旋转动画配置
+    ROTATION: {
+      BASE_SPEED: 2, // 基础旋转速度
+      RANDOM_SPEED: 3, // 额外随机旋转速度范围
+      DECAY: 0.98 // 旋转速度衰减系数 (越小衰减越快)
+    },
+
+    // 物理效果配置
+    PHYSICS: {
+      GRAVITY: 0.525, // 重力加速度，影响粒子下落速度
+      VELOCITY_THRESHOLD: 10, // 速度阈值，超过时开始透明度衰减
+      OPACITY_DECAY: 0.02 // 透明度衰减速度，影响粒子消失快慢
+    },
+
+    // 粒子颜色配置 - 使用RGBA格式支持透明度
+    COLORS: [
+      'rgba(255, 68, 68, 1)', // 红色系
+      'rgba(255, 68, 68, 0.9)',
+      'rgba(255, 68, 68, 0.8)',
+      'rgba(255, 116, 188, 1)', // 粉色系
+      'rgba(255, 116, 188, 0.9)',
+      'rgba(255, 116, 188, 0.8)',
+      'rgba(68, 68, 255, 0.8)', // 蓝色系
+      'rgba(92, 202, 56, 0.7)', // 绿色系
+      'rgba(255, 68, 255, 0.8)', // 紫色系
+      'rgba(68, 255, 255, 0.7)', // 青色系
+      'rgba(255, 136, 68, 0.7)', // 橙色系
+      'rgba(68, 136, 255, 1)', // 蓝色系
+      'rgba(250, 198, 122, 0.8)' // 金色系
+    ],
+
+    // 粒子形状配置 - 矩形出现概率更高，营造更丰富的视觉效果
+    SHAPES: [
+      'rectangle',
+      'rectangle',
+      'rectangle',
+      'rectangle',
+      'rectangle',
+      'rectangle',
+      'rectangle',
+      'circle',
+      'triangle',
+      'oval'
+    ]
+  } as const
+
+  /** Canvas DOM 元素引用 */
+  const canvasRef = ref<HTMLCanvasElement>()
+  /** Canvas 2D 绘制上下文 */
+  const ctx = ref<CanvasRenderingContext2D | null>(null)
+
+  /**
+   * 烟花系统核心类
+   * 负责管理粒子生命周期、渲染和动画
+   */
+  class FireworkSystem {
+    /** 粒子对象池 - 预先创建的粒子对象数组 */
+    private particlePool: Firework[] = []
+    /** 当前活动的粒子数组 */
+    private activeParticles: Firework[] = []
+    /** 对象池索引指针 - 用于循环分配粒子 */
+    private poolIndex = 0
+    /** 图片资源缓存 */
+    private imageCache: ImageCache = {}
+    /** 动画帧ID - 用于取消动画 */
+    private animationId = 0
+    /** 画布宽度缓存 */
+    private canvasWidth = 0
+    /** 画布高度缓存 */
+    private canvasHeight = 0
+
+    constructor() {
+      this.initializePool()
+    }
+
+    /**
+     * 初始化对象池
+     * 预先创建指定数量的粒子对象，避免运行时频繁创建
+     */
+    private initializePool(): void {
+      for (let i = 0; i < CONFIG.POOL_SIZE; i++) {
+        this.particlePool.push(this.createParticle())
+      }
+    }
+
+    /**
+     * 创建一个新的粒子对象
+     * 返回初始化状态的粒子
+     */
+    private createParticle(): Firework {
+      return {
+        x: 0,
+        y: 0,
+        vx: 0,
+        vy: 0,
+        color: '',
+        rotation: 0,
+        rotationSpeed: 0,
+        scale: 1,
+        shape: 'circle',
+        opacity: 1,
+        active: false
+      }
+    }
+
+    /**
+     * 从对象池获取可用粒子 (性能优化版本)
+     * 使用循环索引而非Array.find()，时间复杂度从O(n)降至O(1)
+     * @returns 可用的粒子对象或null
+     */
+    private getAvailableParticle(): Firework | null {
+      for (let i = 0; i < CONFIG.POOL_SIZE; i++) {
+        const index = (this.poolIndex + i) % CONFIG.POOL_SIZE
+        const particle = this.particlePool[index]
+
+        if (!particle.active) {
+          this.poolIndex = (index + 1) % CONFIG.POOL_SIZE
+          particle.active = true
+          return particle
+        }
+      }
+      return null
+    }
+
+    /**
+     * 预加载单个图片资源
+     * @param url 图片URL
+     * @returns Promise<HTMLImageElement>
+     */
+    async preloadImage(url: string): Promise<HTMLImageElement> {
+      // 如果已缓存，直接返回
+      if (this.imageCache[url]) {
+        return this.imageCache[url]
+      }
+
+      return new Promise((resolve, reject) => {
+        const img = new Image()
+        img.crossOrigin = 'anonymous' // 处理跨域问题
+        img.onload = () => {
+          this.imageCache[url] = img
+          resolve(img)
+        }
+        img.onerror = reject
+        img.src = url
+      })
+    }
+
+    /**
+     * 预加载所有需要的图片资源
+     * 在组件初始化时调用，确保图片ready
+     */
+    async preloadAllImages(): Promise<void> {
+      const imageUrls = [bp, sd, yd]
+      try {
+        await Promise.all(imageUrls.map((url) => this.preloadImage(url)))
+      } catch (error) {
+        console.error('Image preloading failed:', error)
+      }
+    }
+
+    /**
+     * 创建烟花爆炸效果
+     * @param imageUrl 可选的图片URL，如果提供则使用图片粒子
+     */
+    createFirework(imageUrl?: string): void {
+      // 随机确定爆炸起始位置
+      const startX = Math.random() * this.canvasWidth
+      const startY = this.canvasHeight
+
+      // 根据是否有图片确定可用形状
+      const availableShapes = imageUrl && this.imageCache[imageUrl] ? ['image'] : CONFIG.SHAPES
+
+      // 批量创建粒子数组，减少频繁的数组操作
+      const particles: Firework[] = []
+
+      for (let i = 0; i < CONFIG.PARTICLES_PER_BURST; i++) {
+        const particle = this.getAvailableParticle()
+        if (!particle) continue
+
+        // 计算粒子发射角度和速度 (恢复原始算法)
+        const angle = (Math.PI * i) / (CONFIG.PARTICLES_PER_BURST / 2) // 扇形分布
+        const speed = (12 + Math.random() * 6) * 1.5 // 随机速度
+        const spread = Math.random() * Math.PI * 2 // 360度随机扩散
+
+        // 直接属性赋值，避免Object.assign的性能开销
+        particle.x = startX
+        particle.y = startY
+        // 复杂的速度计算，模拟真实烟花爆炸轨迹
+        particle.vx = Math.cos(angle) * Math.cos(spread) * speed * (Math.random() * 0.5 + 0.5)
+        particle.vy = Math.sin(angle) * speed - 15 // 向上初始速度
+        particle.color = CONFIG.COLORS[Math.floor(Math.random() * CONFIG.COLORS.length)]
+        particle.rotation = Math.random() * 360
+        particle.rotationSpeed =
+          (Math.random() * CONFIG.ROTATION.RANDOM_SPEED + CONFIG.ROTATION.BASE_SPEED) *
+          (Math.random() > 0.5 ? 1 : -1) // 随机旋转方向
+        particle.scale = 0.8 + Math.random() * 0.4 // 随机缩放
+        particle.shape = availableShapes[Math.floor(Math.random() * availableShapes.length)]
+        particle.opacity = 1
+        particle.imageUrl = imageUrl && this.imageCache[imageUrl] ? imageUrl : undefined
+
+        particles.push(particle)
+      }
+
+      // 批量添加到活动粒子数组，减少多次数组操作
+      this.activeParticles.push(...particles)
+    }
+
+    /**
+     * 更新所有粒子的物理状态 (性能优化版本)
+     * 包括位置、速度、旋转、透明度等
+     */
+    private updateParticles(): void {
+      const { GRAVITY, VELOCITY_THRESHOLD, OPACITY_DECAY } = CONFIG.PHYSICS
+      const { DECAY } = CONFIG.ROTATION
+
+      // 使用倒序遍历，避免删除元素时的索引混乱问题
+      for (let i = this.activeParticles.length - 1; i >= 0; i--) {
+        const particle = this.activeParticles[i]
+
+        // 更新粒子位置 (匀加速运动)
+        particle.x += particle.vx
+        particle.y += particle.vy
+        particle.vy += GRAVITY // 重力影响
+
+        // 更新旋转状态
+        particle.rotation += particle.rotationSpeed
+        particle.rotationSpeed *= DECAY // 旋转速度衰减
+
+        // 透明度衰减逻辑 - 当粒子下落速度超过阈值时开始淡出
+        if (particle.vy > VELOCITY_THRESHOLD) {
+          particle.opacity -= OPACITY_DECAY
+          if (particle.opacity <= 0) {
+            this.recycleParticle(i)
+            continue
+          }
+        }
+
+        // 边界检查 - 移除超出屏幕范围的粒子
+        if (this.isOutOfBounds(particle)) {
+          this.recycleParticle(i)
+        }
+      }
+    }
+
+    /**
+     * 回收粒子到对象池
+     * @param index 要回收的粒子在活动数组中的索引
+     */
+    private recycleParticle(index: number): void {
+      const particle = this.activeParticles[index]
+      particle.active = false // 标记为非活动状态
+      this.activeParticles.splice(index, 1) // 从活动数组中移除
+    }
+
+    /**
+     * 检查粒子是否超出屏幕边界
+     * @param particle 要检查的粒子
+     * @returns 是否超出边界
+     */
+    private isOutOfBounds(particle: Firework): boolean {
+      const margin = 100 // 边界缓冲区
+      return (
+        particle.x < -margin ||
+        particle.x > this.canvasWidth + margin ||
+        particle.y < -margin ||
+        particle.y > this.canvasHeight + margin
+      )
+    }
+
+    /**
+     * 绘制单个粒子
+     * @param particle 要绘制的粒子对象
+     */
+    private drawParticle(particle: Firework): void {
+      if (!ctx.value) return
+
+      // 保存当前画布状态
+      ctx.value.save()
+      ctx.value.globalAlpha = particle.opacity // 设置透明度
+      ctx.value.translate(particle.x, particle.y) // 移动到粒子位置
+      ctx.value.rotate((particle.rotation * Math.PI) / 180) // 应用旋转
+      ctx.value.scale(particle.scale, particle.scale) // 应用缩放
+
+      // 渲染粒子形状
+      this.renderShape(particle)
+
+      // 恢复画布状态
+      ctx.value.restore()
+    }
+
+    /**
+     * 根据粒子类型渲染对应的形状
+     * @param particle 要渲染的粒子
+     */
+    private renderShape(particle: Firework): void {
+      if (!ctx.value) return
+
+      const { SIZES } = CONFIG
+      ctx.value.fillStyle = particle.color
+
+      switch (particle.shape) {
+        case 'rectangle':
+          // 绘制矩形
+          ctx.value.fillRect(
+            -SIZES.RECTANGLE.WIDTH / 2,
+            -SIZES.RECTANGLE.HEIGHT / 2,
+            SIZES.RECTANGLE.WIDTH,
+            SIZES.RECTANGLE.HEIGHT
+          )
+          break
+
+        case 'square':
+          // 绘制正方形
+          ctx.value.fillRect(
+            -SIZES.SQUARE.SIZE / 2,
+            -SIZES.SQUARE.SIZE / 2,
+            SIZES.SQUARE.SIZE,
+            SIZES.SQUARE.SIZE
+          )
+          break
+
+        case 'circle':
+          // 绘制圆形
+          ctx.value.beginPath()
+          ctx.value.arc(0, 0, SIZES.CIRCLE.SIZE / 2, 0, Math.PI * 2)
+          ctx.value.fill()
+          break
+
+        case 'triangle':
+          // 绘制三角形
+          ctx.value.beginPath()
+          ctx.value.moveTo(0, -SIZES.TRIANGLE.SIZE)
+          ctx.value.lineTo(SIZES.TRIANGLE.SIZE, SIZES.TRIANGLE.SIZE)
+          ctx.value.lineTo(-SIZES.TRIANGLE.SIZE, SIZES.TRIANGLE.SIZE)
+          ctx.value.closePath()
+          ctx.value.fill()
+          break
+
+        case 'oval':
+          // 绘制椭圆
+          ctx.value.beginPath()
+          ctx.value.ellipse(0, 0, SIZES.OVAL.WIDTH / 2, SIZES.OVAL.HEIGHT / 2, 0, 0, Math.PI * 2)
+          ctx.value.fill()
+          break
+
+        case 'image':
+          // 绘制图片
+          this.renderImage(particle)
+          break
+      }
+    }
+
+    /**
+     * 渲染图片类型的粒子
+     * @param particle 包含图片URL的粒子对象
+     */
+    private renderImage(particle: Firework): void {
+      if (!ctx.value || !particle.imageUrl) return
+
+      const img = this.imageCache[particle.imageUrl]
+      if (img?.complete) {
+        const { WIDTH, HEIGHT } = CONFIG.SIZES.IMAGE
+        ctx.value.drawImage(img, -WIDTH / 2, -HEIGHT / 2, WIDTH, HEIGHT)
+      }
+    }
+
+    /**
+     * 渲染所有活动粒子到画布
+     * 清除画布并重新绘制所有粒子
+     */
+    private render(): void {
+      if (!ctx.value || !canvasRef.value) return
+
+      // 清除整个画布
+      ctx.value.clearRect(0, 0, this.canvasWidth, this.canvasHeight)
+      // 设置混合模式为"变亮"，增强视觉效果
+      ctx.value.globalCompositeOperation = 'lighter'
+
+      // 渲染所有活动粒子
+      for (const particle of this.activeParticles) {
+        this.drawParticle(particle)
+      }
+    }
+
+    /**
+     * 动画主循环
+     * 使用箭头函数保持this绑定
+     */
+    private animate = (): void => {
+      this.updateParticles() // 更新粒子状态
+      this.render() // 渲染粒子
+      this.animationId = requestAnimationFrame(this.animate) // 请求下一帧
+    }
+
+    /**
+     * 更新画布尺寸缓存
+     * 在窗口大小改变时调用
+     * @param width 新的画布宽度
+     * @param height 新的画布高度
+     */
+    updateCanvasSize(width: number, height: number): void {
+      this.canvasWidth = width
+      this.canvasHeight = height
+    }
+
+    /**
+     * 启动动画循环
+     */
+    start(): void {
+      this.animate()
+    }
+
+    /**
+     * 停止动画循环
+     * 在组件卸载时调用，避免内存泄漏
+     */
+    stop(): void {
+      if (this.animationId) {
+        cancelAnimationFrame(this.animationId)
+        this.animationId = 0
+      }
+    }
+
+    /**
+     * 获取当前活动粒子数量
+     * 用于调试和性能监控
+     * @returns 活动粒子数量
+     */
+    getActiveParticleCount(): number {
+      return this.activeParticles.length
+    }
+  }
+
+  /** 烟花系统实例 */
+  const fireworkSystem = new FireworkSystem()
+
+  /**
+   * 处理键盘快捷键
+   * 监听 Ctrl+Shift+P 或 Cmd+Shift+P 组合键触发烟花
+   * @param event 键盘事件对象
+   */
+  const handleKeyPress = (event: KeyboardEvent): void => {
+    const isFireworkShortcut =
+      (event.ctrlKey && event.shiftKey && event.key.toLowerCase() === 'p') ||
+      (event.metaKey && event.shiftKey && event.key.toLowerCase() === 'p')
+
+    if (isFireworkShortcut) {
+      event.preventDefault()
+      fireworkSystem.createFirework()
+    }
+  }
+
+  /**
+   * 调整Canvas画布大小
+   * 响应窗口大小变化，确保画布始终覆盖整个视口
+   */
+  const resizeCanvas = (): void => {
+    if (!canvasRef.value) return
+
+    const { innerWidth, innerHeight } = window
+    canvasRef.value.width = innerWidth
+    canvasRef.value.height = innerHeight
+    fireworkSystem.updateCanvasSize(innerWidth, innerHeight)
+  }
+
+  /**
+   * 处理外部触发的烟花事件
+   * 通过 mittBus 事件总线接收触发指令
+   * @param event 事件数据，可能包含图片URL
+   */
+  const handleFireworkTrigger: Handler<unknown> = (event: unknown) => {
+    const imageUrl = event as string | undefined
+    fireworkSystem.createFirework(imageUrl)
+  }
+
+  /**
+   * 组件挂载时的初始化逻辑
+   */
+  onMounted(async () => {
+    if (!canvasRef.value) return
+
+    // 获取Canvas 2D绘制上下文
+    ctx.value = canvasRef.value.getContext('2d')
+    if (!ctx.value) return
+
+    // 设置初始画布大小
+    resizeCanvas()
+
+    // 预加载所有图片资源
+    await fireworkSystem.preloadAllImages()
+
+    // 启动动画循环
+    fireworkSystem.start()
+
+    // 注册事件监听器
+    useEventListener(window, 'keydown', handleKeyPress) // 键盘快捷键
+    useEventListener(window, 'resize', resizeCanvas) // 窗口大小变化
+    mittBus.on('triggerFireworks', handleFireworkTrigger) // 外部触发事件
+  })
+
+  /**
+   * 组件卸载时的清理逻辑
+   * 停止动画循环并移除事件监听器，防止内存泄漏
+   */
+  onUnmounted(() => {
+    fireworkSystem.stop()
+    mittBus.off('triggerFireworks', handleFireworkTrigger)
+  })
+</script>
diff --git a/web/src/components/core/layouts/art-global-component/index.vue b/web/src/components/core/layouts/art-global-component/index.vue
new file mode 100644
index 0000000..6908f94
--- /dev/null
+++ b/web/src/components/core/layouts/art-global-component/index.vue
@@ -0,0 +1,14 @@
+<!-- 全局组件 -->
+<template>
+  <component
+    v-for="componentConfig in enabledComponents"
+    :key="componentConfig.key"
+    :is="componentConfig.component"
+  />
+</template>
+
+<script setup lang="ts">
+  import { getEnabledGlobalComponents } from '@/config/modules/component'
+  defineOptions({ name: 'ArtGlobalComponent' })
+  const enabledComponents = computed(() => getEnabledGlobalComponents())
+</script>
diff --git a/web/src/components/core/layouts/art-global-search/index.vue b/web/src/components/core/layouts/art-global-search/index.vue
new file mode 100644
index 0000000..f2c0b88
--- /dev/null
+++ b/web/src/components/core/layouts/art-global-search/index.vue
@@ -0,0 +1,431 @@
+<!-- 全局搜索组件 -->
+<template>
+  <div class="layout-search">
+    <ElDialog
+      v-model="showSearchDialog"
+      width="600"
+      :show-close="false"
+      :lock-scroll="false"
+      modal-class="search-modal"
+      @close="closeSearchDialog"
+    >
+      <ElInput
+        v-model.trim="searchVal"
+        :placeholder="$t('search.placeholder')"
+        @input="search"
+        @blur="searchBlur"
+        ref="searchInput"
+        :prefix-icon="Search"
+        class="h-12"
+      >
+        <template #suffix>
+          <div
+            class="h-4.5 flex-cc rounded border border-g-300 dark:!bg-g-200/50 !bg-box px-1.5 text-g-500"
+          >
+            <ArtSvgIcon icon="fluent:arrow-enter-left-20-filled" />
+          </div>
+        </template>
+      </ElInput>
+      <ElScrollbar class="mt-5" max-height="370px" ref="searchResultScrollbar" always>
+        <div class="result w-full" v-show="searchResult.length">
+          <div
+            class="box !mt-0 c-p text-base leading-none"
+            v-for="(item, index) in searchResult"
+            :key="index"
+          >
+            <div
+              class="mt-2 h-12 flex-cb rounded-custom-sm bg-g-200/80 px-4 text-sm text-g-700"
+              :class="isHighlighted(index) ? 'highlighted !bg-theme/70 !text-white' : ''"
+              @click="searchGoPage(item)"
+              @mouseenter="highlightOnHover(index)"
+            >
+              {{ formatMenuTitle(item.meta.title) }}
+              <ArtSvgIcon v-show="isHighlighted(index)" icon="fluent:arrow-enter-left-20-filled" />
+            </div>
+          </div>
+        </div>
+
+        <div v-show="!searchVal && searchResult.length === 0 && historyResult.length > 0">
+          <p class="text-xs text-g-500">{{ $t('search.historyTitle') }}</p>
+          <div class="mt-1.5 w-full">
+            <div
+              class="box mt-2 h-12 c-p flex-cb rounded-custom-sm bg-g-200/80 px-4 text-sm text-g-800"
+              v-for="(item, index) in historyResult"
+              :key="index"
+              :class="
+                historyHIndex === index
+                  ? 'highlighted !bg-theme/70 !text-white [&_.selected-icon]:!text-white'
+                  : ''
+              "
+              @click="searchGoPage(item)"
+              @mouseenter="highlightOnHoverHistory(index)"
+            >
+              {{ formatMenuTitle(item.meta.title) }}
+              <div
+                class="size-5 selected-icon select-none rounded-full text-g-500 flex-cc c-p"
+                @click.stop="deleteHistory(index)"
+              >
+                <ArtSvgIcon icon="ri:close-large-fill" class="text-xs" />
+              </div>
+            </div>
+          </div>
+        </div>
+      </ElScrollbar>
+
+      <template #footer>
+        <div class="dialog-footer box-border flex-c border-t-d pt-4.5 pb-1">
+          <div class="flex-cc">
+            <ArtSvgIcon icon="fluent:arrow-enter-left-20-filled" class="keyboard" />
+            <span class="mr-3.5 text-xs text-g-700">{{ $t('search.selectKeydown') }}</span>
+          </div>
+          <div class="flex-c">
+            <ArtSvgIcon icon="ri:arrow-up-wide-fill" class="keyboard" />
+            <ArtSvgIcon icon="ri:arrow-down-wide-fill" class="keyboard" />
+            <span class="mr-3.5 text-xs text-g-700">{{ $t('search.switchKeydown') }}</span>
+          </div>
+          <div class="flex-c">
+            <i class="keyboard !w-8 flex-cc"><p class="text-[10px] font-medium">ESC</p></i>
+            <span class="mr-3.5 text-xs text-g-700">{{ $t('search.exitKeydown') }}</span>
+          </div>
+        </div>
+      </template>
+    </ElDialog>
+  </div>
+</template>
+
+<script lang="ts" setup>
+  import { useUserStore } from '@/store/modules/user'
+  import { AppRouteRecord } from '@/types/router'
+  import { Search } from '@element-plus/icons-vue'
+  import { mittBus } from '@/utils/sys'
+  import { useMenuStore } from '@/store/modules/menu'
+  import { formatMenuTitle } from '@/utils/router'
+  import { handleMenuJump } from '@/utils/navigation'
+  import { type ScrollbarInstance } from 'element-plus'
+
+  defineOptions({ name: 'ArtGlobalSearch' })
+
+  const userStore = useUserStore()
+  const { menuList } = storeToRefs(useMenuStore())
+
+  const showSearchDialog = ref(false)
+  const searchVal = ref('')
+  const searchResult = ref<AppRouteRecord[]>([])
+  const historyMaxLength = 10
+
+  const { searchHistory: historyResult } = storeToRefs(userStore)
+
+  const searchInput = ref<HTMLInputElement | null>(null)
+  const highlightedIndex = ref(0)
+  const historyHIndex = ref(0)
+  const searchResultScrollbar = ref<ScrollbarInstance>()
+  const isKeyboardNavigating = ref(false) // 新增状态：是否正在使用键盘导航
+
+  // 生命周期钩子
+  onMounted(() => {
+    mittBus.on('openSearchDialog', openSearchDialog)
+    document.addEventListener('keydown', handleKeydown)
+  })
+
+  onUnmounted(() => {
+    document.removeEventListener('keydown', handleKeydown)
+  })
+
+  // 键盘快捷键处理
+  const handleKeydown = (event: KeyboardEvent) => {
+    const isMac = navigator.platform.toUpperCase().indexOf('MAC') >= 0
+    const isCommandKey = isMac ? event.metaKey : event.ctrlKey
+
+    if (isCommandKey && event.key.toLowerCase() === 'k') {
+      event.preventDefault()
+      showSearchDialog.value = true
+      focusInput()
+    }
+
+    // 当搜索对话框打开时，处理方向键和回车键
+    if (showSearchDialog.value) {
+      if (event.key === 'ArrowUp') {
+        event.preventDefault()
+        highlightPrevious()
+      } else if (event.key === 'ArrowDown') {
+        event.preventDefault()
+        highlightNext()
+      } else if (event.key === 'Enter') {
+        event.preventDefault()
+        selectHighlighted()
+      } else if (event.key === 'Escape') {
+        event.preventDefault()
+        showSearchDialog.value = false
+      }
+    }
+  }
+
+  const focusInput = () => {
+    setTimeout(() => {
+      searchInput.value?.focus()
+    }, 100)
+  }
+
+  // 搜索逻辑
+  const search = (val: string) => {
+    if (val) {
+      searchResult.value = flattenAndFilterMenuItems(menuList.value, val)
+    } else {
+      searchResult.value = []
+    }
+  }
+
+  const flattenAndFilterMenuItems = (items: AppRouteRecord[], val: string): AppRouteRecord[] => {
+    const lowerVal = val.toLowerCase()
+    const result: AppRouteRecord[] = []
+
+    const flattenAndMatch = (item: AppRouteRecord) => {
+      if (item.meta?.isHide) return
+
+      const lowerItemTitle = formatMenuTitle(item.meta.title).toLowerCase()
+
+      if (item.children && item.children.length > 0) {
+        item.children.forEach(flattenAndMatch)
+        return
+      }
+
+      if (
+        lowerItemTitle.includes(lowerVal) &&
+        ((item.path && item.path.trim()) || item.meta.link || item.meta.isIframe)
+      ) {
+        result.push({ ...item, children: undefined })
+      }
+    }
+
+    items.forEach(flattenAndMatch)
+    return result
+  }
+
+  // 高亮控制并实现滚动条跟随
+  const highlightPrevious = () => {
+    isKeyboardNavigating.value = true
+    if (searchVal.value) {
+      highlightedIndex.value =
+        (highlightedIndex.value - 1 + searchResult.value.length) % searchResult.value.length
+      scrollToHighlightedItem()
+    } else {
+      historyHIndex.value =
+        (historyHIndex.value - 1 + historyResult.value.length) % historyResult.value.length
+      scrollToHighlightedHistoryItem()
+    }
+    // 延迟重置键盘导航状态，防止立即被 hover 覆盖
+    setTimeout(() => {
+      isKeyboardNavigating.value = false
+    }, 100)
+  }
+
+  const highlightNext = () => {
+    isKeyboardNavigating.value = true
+    if (searchVal.value) {
+      highlightedIndex.value = (highlightedIndex.value + 1) % searchResult.value.length
+      scrollToHighlightedItem()
+    } else {
+      historyHIndex.value = (historyHIndex.value + 1) % historyResult.value.length
+      scrollToHighlightedHistoryItem()
+    }
+    setTimeout(() => {
+      isKeyboardNavigating.value = false
+    }, 100)
+  }
+
+  const scrollToHighlightedItem = () => {
+    nextTick(() => {
+      if (!searchResultScrollbar.value || !searchResult.value.length) return
+
+      const scrollWrapper = searchResultScrollbar.value.wrapRef
+      if (!scrollWrapper) return
+
+      const highlightedElements = scrollWrapper.querySelectorAll('.result .box')
+      if (!highlightedElements[highlightedIndex.value]) return
+
+      const highlightedElement = highlightedElements[highlightedIndex.value] as HTMLElement
+      const itemHeight = highlightedElement.offsetHeight
+      const scrollTop = scrollWrapper.scrollTop
+      const containerHeight = scrollWrapper.clientHeight
+      const itemTop = highlightedElement.offsetTop
+      const itemBottom = itemTop + itemHeight
+
+      if (itemTop < scrollTop) {
+        searchResultScrollbar.value.setScrollTop(itemTop)
+      } else if (itemBottom > scrollTop + containerHeight) {
+        searchResultScrollbar.value.setScrollTop(itemBottom - containerHeight)
+      }
+    })
+  }
+
+  const scrollToHighlightedHistoryItem = () => {
+    nextTick(() => {
+      if (!searchResultScrollbar.value || !historyResult.value.length) return
+
+      const scrollWrapper = searchResultScrollbar.value.wrapRef
+      if (!scrollWrapper) return
+
+      const historyItems = scrollWrapper.querySelectorAll('.history-result .box')
+      if (!historyItems[historyHIndex.value]) return
+
+      const highlightedElement = historyItems[historyHIndex.value] as HTMLElement
+      const itemHeight = highlightedElement.offsetHeight
+      const scrollTop = scrollWrapper.scrollTop
+      const containerHeight = scrollWrapper.clientHeight
+      const itemTop = highlightedElement.offsetTop
+      const itemBottom = itemTop + itemHeight
+
+      if (itemTop < scrollTop) {
+        searchResultScrollbar.value.setScrollTop(itemTop)
+      } else if (itemBottom > scrollTop + containerHeight) {
+        searchResultScrollbar.value.setScrollTop(itemBottom - containerHeight)
+      }
+    })
+  }
+
+  const selectHighlighted = () => {
+    if (searchVal.value && searchResult.value.length) {
+      searchGoPage(searchResult.value[highlightedIndex.value])
+    } else if (!searchVal.value && historyResult.value.length) {
+      searchGoPage(historyResult.value[historyHIndex.value])
+    }
+  }
+
+  const isHighlighted = (index: number) => {
+    return highlightedIndex.value === index
+  }
+
+  const searchBlur = () => {
+    highlightedIndex.value = 0
+  }
+
+  const searchGoPage = (item: AppRouteRecord) => {
+    showSearchDialog.value = false
+    addHistory(item)
+    handleMenuJump(item)
+    searchVal.value = ''
+    searchResult.value = []
+  }
+
+  // 历史记录管理
+  const updateHistory = () => {
+    if (Array.isArray(historyResult.value)) {
+      userStore.setSearchHistory(historyResult.value)
+    }
+  }
+
+  const addHistory = (item: AppRouteRecord) => {
+    const itemKey = item.path || String(item.meta.link || '')
+    const hasItemIndex = historyResult.value.findIndex(
+      (historyItem: AppRouteRecord) =>
+        (historyItem.path || String(historyItem.meta.link || '')) === itemKey
+    )
+
+    if (hasItemIndex !== -1) {
+      historyResult.value.splice(hasItemIndex, 1)
+    } else if (historyResult.value.length >= historyMaxLength) {
+      historyResult.value.pop()
+    }
+
+    const cleanedItem = { ...item }
+    delete cleanedItem.children
+    delete cleanedItem.meta.authList
+    historyResult.value.unshift(cleanedItem)
+    updateHistory()
+  }
+
+  const deleteHistory = (index: number) => {
+    historyResult.value.splice(index, 1)
+    updateHistory()
+  }
+
+  // 对话框控制
+  const openSearchDialog = () => {
+    showSearchDialog.value = true
+    focusInput()
+  }
+
+  const closeSearchDialog = () => {
+    searchVal.value = ''
+    searchResult.value = []
+    highlightedIndex.value = 0
+    historyHIndex.value = 0
+  }
+
+  // 修改 hover 高亮逻辑，只有在非键盘导航时才生效
+  const highlightOnHover = (index: number) => {
+    if (!isKeyboardNavigating.value && searchVal.value) {
+      highlightedIndex.value = index
+    }
+  }
+
+  const highlightOnHoverHistory = (index: number) => {
+    if (!isKeyboardNavigating.value && !searchVal.value) {
+      historyHIndex.value = index
+    }
+  }
+</script>
+<style lang="scss" scoped>
+  .layout-search {
+    :deep(.search-modal) {
+      background-color: rgb(0 0 0 / 20%);
+    }
+
+    :deep(.el-dialog__body) {
+      padding: 5px 0 0 !important;
+    }
+
+    :deep(.el-dialog__header) {
+      padding: 0;
+    }
+
+    .el-input {
+      :deep(.el-input__wrapper) {
+        background-color: var(--art-gray-200);
+        border: 1px solid var(--default-border-dashed);
+        border-radius: calc(var(--custom-radius) / 2 + 2px) !important;
+        box-shadow: none;
+      }
+
+      :deep(.el-input__inner) {
+        color: var(--art-gray-800) !important;
+      }
+    }
+  }
+
+  .dark .layout-search {
+    .el-input {
+      :deep(.el-input__wrapper) {
+        background-color: #333;
+        border: 1px solid #4c4d50;
+      }
+    }
+
+    :deep(.search-modal) {
+      background-color: rgb(23 23 26 / 60%);
+      backdrop-filter: none;
+    }
+
+    :deep(.el-dialog) {
+      background-color: #252526;
+    }
+  }
+</style>
+
+<style scoped>
+  @reference '@styles/core/tailwind.css';
+
+  .keyboard {
+    @apply mr-2 
+    box-border
+    h-5 
+    w-5.5
+    rounded
+    border 
+    border-g-400 
+    px-1 
+    text-g-500
+    shadow-[0_2px_0_var(--default-border-dashed)] 
+    last-of-type:mr-1.5;
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-header-bar/index.vue b/web/src/components/core/layouts/art-header-bar/index.vue
new file mode 100755
index 0000000..4e3c8f9
--- /dev/null
+++ b/web/src/components/core/layouts/art-header-bar/index.vue
@@ -0,0 +1,485 @@
+<!-- 顶部栏 -->
+<template>
+  <div
+    class="w-full bg-[var(--default-bg-color)]"
+    :class="[
+      tabStyle === 'tab-card' || tabStyle === 'tab-google' ? 'mb-5 max-sm:mb-3 !bg-box' : ''
+    ]"
+  >
+    <div
+      class="relative box-border flex-b h-15 leading-15 select-none"
+      :class="[
+        tabStyle === 'tab-card' || tabStyle === 'tab-google'
+          ? 'border-b border-[var(--art-card-border)]'
+          : ''
+      ]"
+    >
+      <div class="flex-c flex-1 min-w-0 leading-15" style="display: flex">
+        <!-- 系统信息  -->
+        <div class="flex-c c-p" @click="toHome" v-if="isTopMenu">
+          <ArtLogo class="pl-4.5" />
+          <p v-if="width >= 1400" class="my-0 mx-2 ml-2 text-lg">{{ AppConfig.systemInfo.name }}</p>
+        </div>
+
+        <ArtLogo
+          class="!hidden pl-3.5 overflow-hidden align-[-0.15em] fill-current"
+          @click="toHome"
+        />
+
+        <!-- 菜单按钮 -->
+        <ArtIconButton
+          v-if="isLeftMenu && shouldShowMenuButton"
+          icon="ri:menu-2-fill"
+          class="ml-3 max-sm:ml-[7px]"
+          @click="visibleMenu"
+        />
+
+        <!-- 刷新按钮 -->
+        <ArtIconButton
+          v-if="shouldShowRefreshButton"
+          icon="ri:refresh-line"
+          class="!ml-3 refresh-btn max-sm:!hidden"
+          :style="{ marginLeft: !isLeftMenu ? '10px' : '0' }"
+          @click="reload"
+        />
+
+        <!-- 快速入口 -->
+        <ArtFastEnter v-if="shouldShowFastEnter && width >= headerBarFastEnterMinWidth">
+          <ArtIconButton icon="ri:function-line" class="ml-3" />
+        </ArtFastEnter>
+
+        <!-- 面包屑 -->
+        <ArtBreadcrumb
+          v-if="(shouldShowBreadcrumb && isLeftMenu) || (shouldShowBreadcrumb && isDualMenu)"
+        />
+
+        <!-- 顶部菜单 -->
+        <ArtHorizontalMenu v-if="isTopMenu" :list="menuList" />
+
+        <!-- 混合菜单-顶部 -->
+        <ArtMixedMenu v-if="isTopLeftMenu" :list="menuList" />
+      </div>
+
+      <div class="flex-c gap-2.5">
+        <!-- 搜索 -->
+        <div
+          v-if="shouldShowGlobalSearch"
+          class="flex-cb w-40 h-9 px-2.5 c-p border border-g-400 rounded-custom-sm max-md:!hidden"
+          @click="openSearchDialog"
+        >
+          <div class="flex-c">
+            <ArtSvgIcon icon="ri:search-line" class="text-sm text-g-500" />
+            <span class="ml-1 text-xs font-normal text-g-500">{{ $t('topBar.search.title') }}</span>
+          </div>
+          <div class="flex-c h-5 px-1.5 text-g-500/80 border border-g-400 rounded">
+            <ArtSvgIcon v-if="isWindows" icon="vaadin:ctrl-a" class="text-sm" />
+            <ArtSvgIcon v-else icon="ri:command-fill" class="text-xs" />
+            <span class="ml-0.5 text-xs">k</span>
+          </div>
+        </div>
+
+        <!-- 全屏按钮 -->
+        <ArtIconButton
+          v-if="shouldShowFullscreen"
+          :icon="isFullscreen ? 'ri:fullscreen-exit-line' : 'ri:fullscreen-fill'"
+          :class="[!isFullscreen ? 'full-screen-btn' : 'exit-full-screen-btn', 'ml-3']"
+          class="max-md:!hidden"
+          @click="toggleFullScreen"
+        />
+
+        <!-- 国际化按钮 -->
+        <ElDropdown
+          @command="changeLanguage"
+          popper-class="langDropDownStyle"
+          v-if="shouldShowLanguage"
+        >
+          <ArtIconButton icon="ri:translate-2" class="language-btn text-[19px]" />
+          <template #dropdown>
+            <ElDropdownMenu>
+              <div v-for="item in languageOptions" :key="item.value" class="lang-btn-item">
+                <ElDropdownItem
+                  :command="item.value"
+                  :class="{ 'is-selected': locale === item.value }"
+                >
+                  <span class="menu-txt">{{ item.label }}</span>
+                  <ArtSvgIcon icon="ri:check-fill" v-if="locale === item.value" />
+                </ElDropdownItem>
+              </div>
+            </ElDropdownMenu>
+          </template>
+        </ElDropdown>
+
+        <!-- 通知按钮 -->
+        <ArtIconButton
+          v-if="shouldShowNotification"
+          icon="ri:notification-2-line"
+          class="notice-button relative"
+          @click="visibleNotice"
+        >
+          <div class="absolute top-2 right-2 size-1.5 !bg-danger rounded-full"></div>
+        </ArtIconButton>
+
+        <!-- 聊天按钮 -->
+        <ArtIconButton
+          v-if="shouldShowChat"
+          icon="ri:message-3-line"
+          class="chat-button relative"
+          @click="openChat"
+        >
+          <div class="breathing-dot absolute top-2 right-2 size-1.5 !bg-success rounded-full"></div>
+        </ArtIconButton>
+
+        <!-- 设置按钮 -->
+        <div v-if="shouldShowSettings">
+          <ElPopover :visible="showSettingGuide" placement="bottom-start" :width="190" :offset="0">
+            <template #reference>
+              <div class="flex-cc">
+                <ArtIconButton icon="ri:settings-line" class="setting-btn" @click="openSetting" />
+              </div>
+            </template>
+            <template #default>
+              <p
+                >{{ $t('topBar.guide.title')
+                }}<span :style="{ color: systemThemeColor }"> {{ $t('topBar.guide.theme') }} </span
+                >、 <span :style="{ color: systemThemeColor }"> {{ $t('topBar.guide.menu') }} </span
+                >{{ $t('topBar.guide.description') }}
+              </p>
+            </template>
+          </ElPopover>
+        </div>
+
+        <!-- 主题切换按钮 -->
+        <ArtIconButton
+          v-if="shouldShowThemeToggle"
+          @click="themeAnimation"
+          :icon="isDark ? 'ri:sun-fill' : 'ri:moon-line'"
+        />
+
+        <!-- 用户头像、菜单 -->
+        <ArtUserMenu />
+      </div>
+    </div>
+
+    <!-- 标签页 -->
+    <ArtWorkTab />
+
+    <!-- 通知 -->
+    <ArtNotification v-model:value="showNotice" ref="notice" />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useI18n } from 'vue-i18n'
+  import { useRouter } from 'vue-router'
+  import { useFullscreen, useWindowSize } from '@vueuse/core'
+  import { LanguageEnum, MenuTypeEnum } from '@/enums/appEnum'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useUserStore } from '@/store/modules/user'
+  import { useMenuStore } from '@/store/modules/menu'
+  import AppConfig from '@/config'
+  import { languageOptions } from '@/locales'
+  import { mittBus } from '@/utils/sys'
+  import { themeAnimation } from '@/utils/ui/animation'
+  import { useCommon } from '@/hooks/core/useCommon'
+  import { useHeaderBar } from '@/hooks/core/useHeaderBar'
+  import ArtUserMenu from './widget/ArtUserMenu.vue'
+
+  defineOptions({ name: 'ArtHeaderBar' })
+
+  // 检测操作系统类型
+  const isWindows = navigator.userAgent.includes('Windows')
+
+  const router = useRouter()
+  const { locale } = useI18n()
+  const { width } = useWindowSize()
+
+  const settingStore = useSettingStore()
+  const userStore = useUserStore()
+  const menuStore = useMenuStore()
+
+  // 顶部栏功能配置
+  const {
+    shouldShowMenuButton,
+    shouldShowRefreshButton,
+    shouldShowFastEnter,
+    shouldShowBreadcrumb,
+    shouldShowGlobalSearch,
+    shouldShowFullscreen,
+    shouldShowNotification,
+    shouldShowChat,
+    shouldShowLanguage,
+    shouldShowSettings,
+    shouldShowThemeToggle,
+    fastEnterMinWidth: headerBarFastEnterMinWidth
+  } = useHeaderBar()
+
+  const { menuOpen, systemThemeColor, showSettingGuide, menuType, isDark, tabStyle } =
+    storeToRefs(settingStore)
+
+  const { language } = storeToRefs(userStore)
+  const { menuList } = storeToRefs(menuStore)
+
+  const showNotice = ref(false)
+  const notice = ref(null)
+
+  // 菜单类型判断
+  const isLeftMenu = computed(() => menuType.value === MenuTypeEnum.LEFT)
+  const isDualMenu = computed(() => menuType.value === MenuTypeEnum.DUAL_MENU)
+  const isTopMenu = computed(() => menuType.value === MenuTypeEnum.TOP)
+  const isTopLeftMenu = computed(() => menuType.value === MenuTypeEnum.TOP_LEFT)
+
+  const { isFullscreen, toggle: toggleFullscreen } = useFullscreen()
+
+  onMounted(() => {
+    initLanguage()
+    document.addEventListener('click', bodyCloseNotice)
+  })
+
+  onUnmounted(() => {
+    document.removeEventListener('click', bodyCloseNotice)
+  })
+
+  /**
+   * 切换全屏状态
+   */
+  const toggleFullScreen = (): void => {
+    toggleFullscreen()
+  }
+
+  /**
+   * 切换菜单显示/隐藏状态
+   */
+  const visibleMenu = (): void => {
+    settingStore.setMenuOpen(!menuOpen.value)
+  }
+
+  const { homePath } = useCommon()
+  const { refresh } = useCommon()
+
+  /**
+   * 跳转到首页
+   */
+  const toHome = (): void => {
+    router.push(homePath.value)
+  }
+
+  /**
+   * 刷新页面
+   * @param {number} time - 延迟时间，默认为0毫秒
+   */
+  const reload = (time: number = 0): void => {
+    setTimeout(() => {
+      refresh()
+    }, time)
+  }
+
+  /**
+   * 初始化语言设置
+   */
+  const initLanguage = (): void => {
+    locale.value = language.value
+  }
+
+  /**
+   * 切换系统语言
+   * @param {LanguageEnum} lang - 目标语言类型
+   */
+  const changeLanguage = (lang: LanguageEnum): void => {
+    if (locale.value === lang) return
+    locale.value = lang
+    userStore.setLanguage(lang)
+    reload(50)
+  }
+
+  /**
+   * 打开设置面板
+   */
+  const openSetting = (): void => {
+    mittBus.emit('openSetting')
+
+    // 隐藏设置引导提示
+    if (showSettingGuide.value) {
+      settingStore.hideSettingGuide()
+    }
+  }
+
+  /**
+   * 打开全局搜索对话框
+   */
+  const openSearchDialog = (): void => {
+    mittBus.emit('openSearchDialog')
+  }
+
+  /**
+   * 点击页面其他区域关闭通知面板
+   * @param {Event} e - 点击事件对象
+   */
+  const bodyCloseNotice = (e: any): void => {
+    if (!showNotice.value) return
+
+    const target = e.target as HTMLElement
+
+    // 检查是否点击了通知按钮或通知面板内部
+    const isNoticeButton = target.closest('.notice-button')
+    const isNoticePanel = target.closest('.art-notification-panel')
+
+    if (!isNoticeButton && !isNoticePanel) {
+      showNotice.value = false
+    }
+  }
+
+  /**
+   * 切换通知面板显示状态
+   */
+  const visibleNotice = (): void => {
+    showNotice.value = !showNotice.value
+  }
+
+  /**
+   * 打开聊天窗口
+   */
+  const openChat = (): void => {
+    mittBus.emit('openChat')
+  }
+</script>
+
+<style lang="scss" scoped>
+  /* Custom animations */
+  @keyframes rotate180 {
+    0% {
+      transform: rotate(0);
+    }
+
+    100% {
+      transform: rotate(180deg);
+    }
+  }
+
+  @keyframes shake {
+    0% {
+      transform: rotate(0);
+    }
+
+    25% {
+      transform: rotate(-5deg);
+    }
+
+    50% {
+      transform: rotate(5deg);
+    }
+
+    75% {
+      transform: rotate(-5deg);
+    }
+
+    100% {
+      transform: rotate(0);
+    }
+  }
+
+  @keyframes expand {
+    0% {
+      transform: scale(1);
+    }
+
+    50% {
+      transform: scale(1.1);
+    }
+
+    100% {
+      transform: scale(1);
+    }
+  }
+
+  @keyframes shrink {
+    0% {
+      transform: scale(1);
+    }
+
+    50% {
+      transform: scale(0.9);
+    }
+
+    100% {
+      transform: scale(1);
+    }
+  }
+
+  @keyframes moveUp {
+    0% {
+      transform: translateY(0);
+    }
+
+    50% {
+      transform: translateY(-3px);
+    }
+
+    100% {
+      transform: translateY(0);
+    }
+  }
+
+  @keyframes breathing {
+    0% {
+      opacity: 0.4;
+      transform: scale(0.9);
+    }
+
+    50% {
+      opacity: 1;
+      transform: scale(1.1);
+    }
+
+    100% {
+      opacity: 0.4;
+      transform: scale(0.9);
+    }
+  }
+
+  /* Hover animation classes */
+  .refresh-btn:hover :deep(.art-svg-icon) {
+    animation: rotate180 0.5s;
+  }
+
+  .language-btn:hover :deep(.art-svg-icon) {
+    animation: moveUp 0.4s;
+  }
+
+  .setting-btn:hover :deep(.art-svg-icon) {
+    animation: rotate180 0.5s;
+  }
+
+  .full-screen-btn:hover :deep(.art-svg-icon) {
+    animation: expand 0.6s forwards;
+  }
+
+  .exit-full-screen-btn:hover :deep(.art-svg-icon) {
+    animation: shrink 0.6s forwards;
+  }
+
+  .notice-button:hover :deep(.art-svg-icon) {
+    animation: shake 0.5s ease-in-out;
+  }
+
+  .chat-button:hover :deep(.art-svg-icon) {
+    animation: shake 0.5s ease-in-out;
+  }
+
+  /* Breathing animation for chat dot */
+  .breathing-dot {
+    animation: breathing 1.5s ease-in-out infinite;
+  }
+
+  /* iPad breakpoint adjustments */
+  @media screen and (width <= 768px) {
+    .logo2 {
+      display: block !important;
+    }
+  }
+
+  @media screen and (width <= 640px) {
+    .btn-box {
+      width: 40px;
+    }
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue b/web/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue
new file mode 100644
index 0000000..c8c5832
--- /dev/null
+++ b/web/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue
@@ -0,0 +1,167 @@
+<!-- 用户菜单 -->
+<template>
+  <ElPopover
+    ref="userMenuPopover"
+    placement="bottom-end"
+    :width="240"
+    :hide-after="0"
+    :offset="10"
+    trigger="hover"
+    :show-arrow="false"
+    popper-class="user-menu-popover"
+    popper-style="padding: 5px 16px;"
+  >
+    <template #reference>
+      <img
+        class="size-8.5 mr-5 c-p rounded-full max-sm:w-6.5 max-sm:h-6.5 max-sm:mr-[16px]"
+        src="@imgs/user/avatar.webp"
+        alt="avatar"
+      />
+    </template>
+    <template #default>
+      <div class="pt-3">
+        <div class="flex-c pb-1 px-0">
+          <img
+            class="w-10 h-10 mr-3 ml-0 overflow-hidden rounded-full float-left"
+            src="@imgs/user/avatar.webp"
+          />
+          <div class="w-[calc(100%-60px)] h-full">
+            <span class="block text-sm font-medium text-g-800 truncate">{{
+              userInfo.userName
+            }}</span>
+            <span class="block mt-0.5 text-xs text-g-500 truncate">{{ userInfo.email }}</span>
+          </div>
+        </div>
+        <ul class="py-4 mt-3 border-t border-g-300/80">
+          <li class="btn-item" @click="goPage('/system/user-center')">
+            <ArtSvgIcon icon="ri:user-3-line" />
+            <span>{{ $t('topBar.user.userCenter') }}</span>
+          </li>
+          <li class="btn-item" @click="toDocs()">
+            <ArtSvgIcon icon="ri:book-2-line" />
+            <span>{{ $t('topBar.user.docs') }}</span>
+          </li>
+          <li class="btn-item" @click="toGithub()">
+            <ArtSvgIcon icon="ri:github-line" />
+            <span>{{ $t('topBar.user.github') }}</span>
+          </li>
+          <li class="btn-item" @click="lockScreen()">
+            <ArtSvgIcon icon="ri:lock-line" />
+            <span>{{ $t('topBar.user.lockScreen') }}</span>
+          </li>
+          <div class="w-full h-px my-2 bg-g-300/80"></div>
+          <div class="log-out c-p" @click="loginOut">
+            {{ $t('topBar.user.logout') }}
+          </div>
+        </ul>
+      </div>
+    </template>
+  </ElPopover>
+</template>
+
+<script setup lang="ts">
+  import { useI18n } from 'vue-i18n'
+  import { useRouter } from 'vue-router'
+  import { ElMessageBox } from 'element-plus'
+  import { useUserStore } from '@/store/modules/user'
+  import { WEB_LINKS } from '@/utils/constants'
+  import { mittBus } from '@/utils/sys'
+
+  defineOptions({ name: 'ArtUserMenu' })
+
+  const router = useRouter()
+  const { t } = useI18n()
+  const userStore = useUserStore()
+
+  const { getUserInfo: userInfo } = storeToRefs(userStore)
+  const userMenuPopover = ref()
+
+  /**
+   * 页面跳转
+   * @param {string} path - 目标路径
+   */
+  const goPage = (path: string): void => {
+    router.push(path)
+  }
+
+  /**
+   * 打开文档页面
+   */
+  const toDocs = (): void => {
+    window.open(WEB_LINKS.DOCS)
+  }
+
+  /**
+   * 打开 GitHub 页面
+   */
+  const toGithub = (): void => {
+    window.open(WEB_LINKS.GITHUB)
+  }
+
+  /**
+   * 打开锁屏功能
+   */
+  const lockScreen = (): void => {
+    mittBus.emit('openLockScreen')
+  }
+
+  /**
+   * 用户登出确认
+   */
+  const loginOut = (): void => {
+    closeUserMenu()
+    setTimeout(() => {
+      ElMessageBox.confirm(t('common.logOutTips'), t('common.tips'), {
+        confirmButtonText: t('common.confirm'),
+        cancelButtonText: t('common.cancel'),
+        customClass: 'login-out-dialog'
+      }).then(() => {
+        userStore.logOut()
+      })
+    }, 200)
+  }
+
+  /**
+   * 关闭用户菜单弹出层
+   */
+  const closeUserMenu = (): void => {
+    setTimeout(() => {
+      userMenuPopover.value.hide()
+    }, 100)
+  }
+</script>
+
+<style scoped>
+  @reference '@styles/core/tailwind.css';
+
+  @layer components {
+    .btn-item {
+      @apply flex items-center p-2 mb-3 select-none rounded-md cursor-pointer last:mb-0;
+
+      span {
+        @apply text-sm;
+      }
+
+      .art-svg-icon {
+        @apply mr-2 text-base;
+      }
+
+      &:hover {
+        background-color: var(--art-gray-200);
+      }
+    }
+  }
+
+  .log-out {
+    @apply py-1.5
+    mt-5
+    text-xs
+    text-center
+    border
+    border-g-400
+    rounded-md
+    transition-all
+    duration-200
+    hover:shadow-xl;
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-menus/art-horizontal-menu/index.vue b/web/src/components/core/layouts/art-menus/art-horizontal-menu/index.vue
new file mode 100644
index 0000000..edd1473
--- /dev/null
+++ b/web/src/components/core/layouts/art-menus/art-horizontal-menu/index.vue
@@ -0,0 +1,110 @@
+<!-- 水平菜单 -->
+<template>
+  <div class="flex-1 overflow-hidden">
+    <ElMenu
+      :ellipsis="true"
+      mode="horizontal"
+      :default-active="routerPath"
+      :text-color="isDark ? 'var(--art-gray-800)' : 'var(--art-gray-700)'"
+      :popper-offset="-6"
+      background-color="transparent"
+      :show-timeout="50"
+      :hide-timeout="50"
+      popper-class="horizontal-menu-popper"
+      class="w-full border-none"
+    >
+      <HorizontalSubmenu
+        v-for="item in filteredMenuItems"
+        :key="item.path"
+        :item="item"
+        :isMobile="false"
+        :level="0"
+      />
+    </ElMenu>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import type { AppRouteRecord } from '@/types/router'
+  import HorizontalSubmenu from './widget/HorizontalSubmenu.vue'
+  import { useSettingStore } from '@/store/modules/setting'
+
+  defineOptions({ name: 'ArtHorizontalMenu' })
+
+  const settingStore = useSettingStore()
+  const { isDark } = storeToRefs(settingStore)
+
+  interface Props {
+    /** 菜单列表数据 */
+    list: AppRouteRecord[]
+  }
+
+  const route = useRoute()
+
+  const props = withDefaults(defineProps<Props>(), {
+    list: () => []
+  })
+
+  /**
+   * 过滤后的菜单项列表
+   * 只显示未隐藏的菜单项
+   */
+  const filteredMenuItems = computed(() => {
+    return filterMenuItems(props.list)
+  })
+
+  /**
+   * 当前激活的路由路径
+   * 用于菜单高亮显示
+   */
+  const routerPath = computed(() => String(route.meta.activePath || route.path))
+
+  /**
+   * 递归过滤菜单项，移除隐藏的菜单
+   * 如果一个父菜单的所有子菜单都被隐藏，则父菜单也会被隐藏
+   * @param items 菜单项数组
+   * @returns 过滤后的菜单项数组
+   */
+  const filterMenuItems = (items: AppRouteRecord[]): AppRouteRecord[] => {
+    return items
+      .filter((item) => {
+        // 如果当前项被隐藏，直接过滤掉
+        if (item.meta.isHide) {
+          return false
+        }
+
+        // 如果有子菜单，递归过滤子菜单
+        if (item.children && item.children.length > 0) {
+          const filteredChildren = filterMenuItems(item.children)
+          // 如果所有子菜单都被过滤掉了，则隐藏父菜单
+          return filteredChildren.length > 0
+        }
+
+        // 叶子节点且未被隐藏，保留
+        return true
+      })
+      .map((item) => ({
+        ...item,
+        children: item.children ? filterMenuItems(item.children) : undefined
+      }))
+  }
+</script>
+
+<style scoped>
+  /* Remove el-menu bottom border */
+  :deep(.el-menu) {
+    border-bottom: none !important;
+  }
+
+  /* Remove default styles for first-level menu items */
+  :deep(.el-menu-item[tabindex='0']) {
+    background-color: transparent !important;
+    border: none !important;
+  }
+
+  /* Remove bottom border from submenu titles */
+  :deep(.el-menu--horizontal .el-sub-menu__title) {
+    padding: 0 30px 0 10px !important;
+    border: 0 !important;
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-menus/art-horizontal-menu/widget/HorizontalSubmenu.vue b/web/src/components/core/layouts/art-menus/art-horizontal-menu/widget/HorizontalSubmenu.vue
new file mode 100644
index 0000000..0f3a817
--- /dev/null
+++ b/web/src/components/core/layouts/art-menus/art-horizontal-menu/widget/HorizontalSubmenu.vue
@@ -0,0 +1,106 @@
+<template>
+  <ElSubMenu v-if="hasChildren" :index="item.path || item.meta.title" class="!p-0">
+    <template #title>
+      <ArtSvgIcon :icon="item.meta.icon" :color="theme?.iconColor" class="mr-1 text-lg" />
+      <span class="text-md">{{ formatMenuTitle(item.meta.title) }}</span>
+      <div v-if="item.meta.showBadge" class="art-badge art-badge-horizontal" />
+      <div v-if="item.meta.showTextBadge" class="art-text-badge">
+        {{ item.meta.showTextBadge }}
+      </div>
+    </template>
+
+    <!-- 递归调用自身处理子菜单 -->
+    <HorizontalSubmenu
+      v-for="child in filteredChildren"
+      :key="child.path"
+      :item="child"
+      :theme="theme"
+      :is-mobile="isMobile"
+      :level="level + 1"
+      @close="closeMenu"
+    />
+  </ElSubMenu>
+
+  <ElMenuItem
+    v-else-if="isNavigableRoute"
+    :index="item.path || item.meta.title"
+    @click="goPage(item)"
+  >
+    <ArtSvgIcon
+      :icon="item.meta.icon"
+      :color="theme?.iconColor"
+      class="mr-1 text-lg"
+      :style="{ color: theme.iconColor }"
+    />
+    <span class="text-md">{{ formatMenuTitle(item.meta.title) }}</span>
+    <div
+      v-if="item.meta.showBadge"
+      class="art-badge"
+      :style="{ right: level === 0 ? '10px' : '20px' }"
+    />
+    <div v-if="item.meta.showTextBadge && level !== 0" class="art-text-badge">
+      {{ item.meta.showTextBadge }}
+    </div>
+  </ElMenuItem>
+</template>
+
+<script lang="ts" setup>
+  import { computed, type PropType } from 'vue'
+  import { AppRouteRecord } from '@/types/router'
+  import { handleMenuJump } from '@/utils/navigation'
+  import { formatMenuTitle } from '@/utils/router'
+
+  const props = defineProps({
+    item: {
+      type: Object as PropType<AppRouteRecord>,
+      required: true
+    },
+    theme: {
+      type: Object,
+      default: () => ({})
+    },
+    isMobile: Boolean,
+    level: {
+      type: Number,
+      default: 0
+    }
+  })
+
+  const emit = defineEmits(['close'])
+
+  // 过滤后的子菜单项（不包含隐藏的）
+  const filteredChildren = computed(() => {
+    return props.item.children?.filter((child) => !child.meta.isHide) || []
+  })
+
+  // 父菜单如果本身就是页面，则即使没有可见子菜单也应该保留为菜单项。
+  const isNavigableRoute = computed(() => {
+    return !!(
+      !props.item.meta.isHide &&
+      ((props.item.path && props.item.path.trim()) ||
+        props.item.meta.link ||
+        props.item.meta.isIframe === true) &&
+      (props.item.component || props.item.meta.link || props.item.meta.isIframe === true)
+    )
+  })
+
+  // 计算当前项是否有可见的子菜单
+  const hasChildren = computed(() => {
+    return filteredChildren.value.length > 0
+  })
+
+  const goPage = (item: AppRouteRecord) => {
+    closeMenu()
+    handleMenuJump(item)
+  }
+
+  const closeMenu = () => {
+    emit('close')
+  }
+</script>
+
+<style scoped>
+  :deep(.el-sub-menu__title .el-sub-menu__icon-arrow) {
+    right: 10px !important;
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-menus/art-mixed-menu/index.vue b/web/src/components/core/layouts/art-menus/art-mixed-menu/index.vue
new file mode 100644
index 0000000..4e98246
--- /dev/null
+++ b/web/src/components/core/layouts/art-menus/art-mixed-menu/index.vue
@@ -0,0 +1,279 @@
+<!-- 混合菜单 -->
+<template>
+  <div class="relative box-border flex-c w-full overflow-hidden">
+    <!-- 左侧滚动按钮 -->
+    <div v-show="showLeftArrow" class="button-arrow" @click="scroll('left')">
+      <ElIcon>
+        <ArrowLeft />
+      </ElIcon>
+    </div>
+
+    <!-- 滚动容器 -->
+    <ElScrollbar
+      ref="scrollbarRef"
+      wrap-class="scrollbar-wrapper"
+      :horizontal="true"
+      @scroll="handleScroll"
+      @wheel="handleWheel"
+    >
+      <div class="box-border flex-c flex-shrink-0 flex-nowrap h-15 whitespace-nowrap">
+        <template v-for="item in processedMenuList" :key="item.meta.title">
+          <div
+            v-if="!item.meta.isHide"
+            class="menu-item relative flex-shrink-0 h-10 px-3 text-sm flex-c c-p hover:text-theme"
+            :class="{
+              'menu-item-active text-theme': item.isActive
+            }"
+            @click="handleMenuJump(item, true)"
+          >
+            <ArtSvgIcon
+              :icon="item.meta.icon"
+              class="text-lg text-g-700 dark:text-g-800 mr-1"
+              :class="item.isActive && '!text-theme'"
+            />
+            <span
+              class="text-md text-g-700 dark:text-g-800"
+              :class="item.isActive && '!text-theme'"
+            >
+              {{ item.formattedTitle }}
+            </span>
+            <div v-if="item.meta.showBadge" class="art-badge art-badge-mixed" />
+          </div>
+        </template>
+      </div>
+    </ElScrollbar>
+
+    <!-- 右侧滚动按钮 -->
+    <div v-show="showRightArrow" class="button-arrow right-2" @click="scroll('right')">
+      <ElIcon>
+        <ArrowRight />
+      </ElIcon>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, computed, onMounted, nextTick } from 'vue'
+  import { ArrowLeft, ArrowRight } from '@element-plus/icons-vue'
+  import { useThrottleFn } from '@vueuse/core'
+  import { formatMenuTitle } from '@/utils/router'
+  import { handleMenuJump } from '@/utils/navigation'
+  import type { AppRouteRecord } from '@/types/router'
+
+  defineOptions({ name: 'ArtMixedMenu' })
+
+  interface Props {
+    /** 菜单列表数据 */
+    list: AppRouteRecord[]
+  }
+
+  interface ProcessedMenuItem extends AppRouteRecord {
+    isActive: boolean
+    formattedTitle: string
+  }
+
+  type ScrollDirection = 'left' | 'right'
+
+  const route = useRoute()
+
+  const props = withDefaults(defineProps<Props>(), {
+    list: () => []
+  })
+
+  const scrollbarRef = ref<any>()
+  const showLeftArrow = ref(false)
+  const showRightArrow = ref(false)
+
+  /** 滚动配置 */
+  const SCROLL_CONFIG = {
+    /** 点击按钮时的滚动距离 */
+    BUTTON_SCROLL_DISTANCE: 200,
+    /** 鼠标滚轮快速滚动时的步长 */
+    WHEEL_FAST_STEP: 35,
+    /** 鼠标滚轮慢速滚动时的步长 */
+    WHEEL_SLOW_STEP: 30,
+    /** 区分快慢滚动的阈值 */
+    WHEEL_FAST_THRESHOLD: 100
+  }
+
+  /**
+   * 获取当前激活路径
+   * 使用computed缓存，避免重复计算
+   */
+  const currentActivePath = computed(() => {
+    return String(route.meta.activePath || route.path)
+  })
+
+  /**
+   * 判断菜单项是否为激活状态
+   * 递归检查子菜单中是否包含当前路径
+   * @param item 菜单项数据
+   * @returns 是否为激活状态
+   */
+  const isMenuItemActive = (item: AppRouteRecord): boolean => {
+    const activePath = currentActivePath.value
+
+    // 如果有子菜单，递归检查子菜单
+    if (item.children?.length) {
+      return item.children.some((child) => {
+        if (child.children?.length) {
+          return isMenuItemActive(child)
+        }
+        return child.path === activePath
+      })
+    }
+
+    // 直接比较路径
+    return item.path === activePath
+  }
+
+  /**
+   * 预处理菜单列表
+   * 缓存每个菜单项的激活状态和格式化标题
+   */
+  const processedMenuList = computed<ProcessedMenuItem[]>(() => {
+    return props.list.map((item) => ({
+      ...item,
+      isActive: isMenuItemActive(item),
+      formattedTitle: formatMenuTitle(item.meta.title)
+    }))
+  })
+
+  /**
+   * 处理滚动事件的核心逻辑
+   * 根据滚动位置显示/隐藏滚动按钮
+   */
+  const handleScrollCore = (): void => {
+    if (!scrollbarRef.value?.wrapRef) return
+
+    const { scrollLeft, scrollWidth, clientWidth } = scrollbarRef.value.wrapRef
+
+    // 判断是否显示左侧滚动按钮
+    showLeftArrow.value = scrollLeft > 0
+
+    // 判断是否显示右侧滚动按钮
+    showRightArrow.value = scrollLeft + clientWidth < scrollWidth
+  }
+
+  /**
+   * 节流后的滚动事件处理函数
+   * 调整节流间隔为16ms，约等于60fps
+   */
+  const handleScroll = useThrottleFn(handleScrollCore, 16)
+
+  /**
+   * 滚动菜单容器
+   * @param direction 滚动方向，left 或 right
+   */
+  const scroll = (direction: ScrollDirection): void => {
+    if (!scrollbarRef.value?.wrapRef) return
+
+    const currentScroll = scrollbarRef.value.wrapRef.scrollLeft
+    const targetScroll =
+      direction === 'left'
+        ? currentScroll - SCROLL_CONFIG.BUTTON_SCROLL_DISTANCE
+        : currentScroll + SCROLL_CONFIG.BUTTON_SCROLL_DISTANCE
+
+    // 平滑滚动到目标位置
+    scrollbarRef.value.wrapRef.scrollTo({
+      left: targetScroll,
+      behavior: 'smooth'
+    })
+  }
+
+  /**
+   * 处理鼠标滚轮事件
+   * 优化滚轮响应性能
+   * @param event 滚轮事件
+   */
+  const handleWheel = (event: WheelEvent): void => {
+    // 立即阻止默认滚动行为和事件冒泡，避免页面滚动
+    event.preventDefault()
+    event.stopPropagation()
+
+    // 直接处理滚动，提升响应性
+    if (!scrollbarRef.value?.wrapRef) return
+
+    const { wrapRef } = scrollbarRef.value
+    const { scrollLeft, scrollWidth, clientWidth } = wrapRef
+
+    // 使用更小的滚动步长，让滚动更平滑
+    const scrollStep =
+      Math.abs(event.deltaY) > SCROLL_CONFIG.WHEEL_FAST_THRESHOLD
+        ? SCROLL_CONFIG.WHEEL_FAST_STEP
+        : SCROLL_CONFIG.WHEEL_SLOW_STEP
+    const scrollDelta = event.deltaY > 0 ? scrollStep : -scrollStep
+    const targetScroll = Math.max(0, Math.min(scrollLeft + scrollDelta, scrollWidth - clientWidth))
+
+    // 立即滚动，无动画
+    wrapRef.scrollLeft = targetScroll
+
+    // 更新滚动按钮状态
+    handleScrollCore()
+  }
+
+  /**
+   * 初始化滚动状态
+   */
+  const initScrollState = (): void => {
+    nextTick(() => {
+      handleScrollCore()
+    })
+  }
+
+  onMounted(initScrollState)
+</script>
+
+<style scoped>
+  @reference '@styles/core/tailwind.css';
+
+  .button-arrow {
+    @apply absolute 
+    top-1/2
+    z-2 
+    flex
+    items-center
+    justify-center
+    size-7.5
+    text-g-600 
+    cursor-pointer
+    rounded 
+    transition-all
+    duration-300
+    -translate-y-1/2 
+    hover:text-g-900 
+    hover:bg-g-200;
+  }
+</style>
+
+<style scoped>
+  :deep(.el-scrollbar__bar.is-horizontal) {
+    bottom: 5px;
+    display: none;
+    height: 2px;
+  }
+
+  :deep(.scrollbar-wrapper) {
+    flex: 1;
+    min-width: 0;
+    margin: 0 50px 0 30px;
+  }
+
+  .menu-item-active::after {
+    position: absolute;
+    right: 0;
+    bottom: 0;
+    left: 0;
+    width: 40px;
+    height: 2px;
+    margin: auto;
+    content: '';
+    background-color: var(--theme-color);
+  }
+
+  @media (width <= 1440px) {
+    :deep(.scrollbar-wrapper) {
+      margin: 0 45px;
+    }
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue b/web/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue
new file mode 100755
index 0000000..6bf46fe
--- /dev/null
+++ b/web/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue
@@ -0,0 +1,354 @@
+<!-- 左侧菜单 或 双列菜单 -->
+<template>
+  <div
+    class="layout-sidebar"
+    v-if="showLeftMenu || isDualMenu"
+    :class="{ 'no-border': menuList.length === 0 }"
+  >
+    <!-- 双列菜单（左侧） -->
+    <div
+      v-if="isDualMenu"
+      class="dual-menu-left"
+      :style="{ width: dualMenuShowText ? '80px' : '64px', background: getMenuTheme.background }"
+    >
+      <ArtLogo class="logo" @click="navigateToHome" />
+
+      <ElScrollbar style="height: calc(100% - 135px)">
+        <ul>
+          <li v-for="menu in firstLevelMenus" :key="menu.path" @click="handleMenuJump(menu, true)">
+            <ElTooltip
+              class="box-item"
+              effect="dark"
+              :content="$t(menu.meta.title)"
+              placement="right"
+              :offset="15"
+              :hide-after="0"
+              :disabled="dualMenuShowText"
+            >
+              <div
+                :class="{
+                  'is-active': menu.meta.isFirstLevel
+                    ? menu.path === route.path
+                    : menu.path === firstLevelMenuPath
+                }"
+                :style="{
+                  height: dualMenuShowText ? '60px' : '46px'
+                }"
+              >
+                <ArtSvgIcon
+                  class="menu-icon text-g-700 dark:text-g-800"
+                  :icon="menu.meta.icon"
+                  :style="{
+                    marginBottom: dualMenuShowText ? '5px' : '0'
+                  }"
+                />
+                <span v-if="dualMenuShowText" class="text-md text-g-700">
+                  {{ $t(menu.meta.title) }}
+                </span>
+                <div v-if="menu.meta.showBadge" class="art-badge art-badge-dual" />
+              </div>
+            </ElTooltip>
+          </li>
+        </ul>
+      </ElScrollbar>
+
+      <ArtIconButton
+        class="switch-btn size-10"
+        icon="ri:arrow-left-right-fill"
+        @click="toggleDualMenuMode"
+      />
+    </div>
+
+    <!-- 左侧菜单 || 双列菜单（右侧） -->
+    <div
+      v-show="menuList.length > 0"
+      class="menu-left"
+      :class="`menu-left-${getMenuTheme.theme} menu-left-${!menuOpen ? 'close' : 'open'}`"
+      :style="{ background: getMenuTheme.background }"
+    >
+      <!-- Logo、系统名称 -->
+      <div
+        class="header"
+        @click="navigateToHome"
+        :style="{
+          background: getMenuTheme.background
+        }"
+      >
+        <ArtLogo v-if="!isDualMenu" class="logo" />
+
+        <p
+          :class="{ 'is-dual-menu-name': isDualMenu }"
+          :style="{
+            color: getMenuTheme.systemNameColor,
+            opacity: !menuOpen ? 0 : 1
+          }"
+        >
+          {{ AppConfig.systemInfo.name }}
+        </p>
+      </div>
+      <ElScrollbar :style="scrollbarStyle">
+        <ElMenu
+          :class="'el-menu-' + getMenuTheme.theme"
+          :collapse="!menuOpen"
+          :default-active="routerPath"
+          :text-color="getMenuTheme.textColor"
+          :unique-opened="uniqueOpened"
+          :background-color="getMenuTheme.background"
+          :default-openeds="defaultOpenedMenus"
+          :popper-class="`menu-left-popper menu-left-${getMenuTheme.theme}-popper`"
+          :show-timeout="50"
+          :hide-timeout="50"
+        >
+          <SidebarSubmenu
+            :list="menuList"
+            :isMobile="isMobileMode"
+            :theme="getMenuTheme"
+            @close="handleMenuClose"
+          />
+        </ElMenu>
+      </ElScrollbar>
+
+      <!-- 双列菜单右侧折叠按钮 -->
+      <div class="dual-menu-collapse-btn" v-if="isDualMenu" @click="toggleMenuVisibility">
+        <ArtSvgIcon
+          class="text-g-500/70"
+          :icon="menuOpen ? 'ri:arrow-left-wide-fill' : 'ri:arrow-right-wide-fill'"
+        />
+      </div>
+
+      <div
+        class="menu-model"
+        @click="toggleMenuVisibility"
+        :style="{
+          opacity: !menuOpen ? 0 : 1,
+          transform: showMobileModal ? 'scale(1)' : 'scale(0)'
+        }"
+      />
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import AppConfig from '@/config'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { MenuTypeEnum, MenuWidth } from '@/enums/appEnum'
+  import { useMenuStore } from '@/store/modules/menu'
+  import { isIframe } from '@/utils/navigation'
+  import { handleMenuJump } from '@/utils/navigation'
+  import SidebarSubmenu from './widget/SidebarSubmenu.vue'
+  import { useCommon } from '@/hooks/core/useCommon'
+  import { useWindowSize, useTimeoutFn } from '@vueuse/core'
+
+  defineOptions({ name: 'ArtSidebarMenu' })
+
+  const MOBILE_BREAKPOINT = 800
+  const ANIMATION_DELAY = 350
+  const MENU_CLOSE_WIDTH = MenuWidth.CLOSE
+
+  const route = useRoute()
+  const router = useRouter()
+  const settingStore = useSettingStore()
+
+  const { getMenuOpenWidth, menuType, uniqueOpened, dualMenuShowText, menuOpen, getMenuTheme } =
+    storeToRefs(settingStore)
+
+  // 组件内部状态
+  const defaultOpenedMenus = ref<string[]>([])
+  const isMobileMode = ref(false)
+  const showMobileModal = ref(false)
+
+  // 使用 VueUse 的窗口尺寸监听
+  const { width } = useWindowSize()
+
+  // 菜单宽度相关
+  const menuopenwidth = computed(() => getMenuOpenWidth.value)
+  const menuclosewidth = computed(() => MENU_CLOSE_WIDTH)
+
+  // 菜单类型判断
+  const isTopLeftMenu = computed(() => menuType.value === MenuTypeEnum.TOP_LEFT)
+  const showLeftMenu = computed(
+    () => menuType.value === MenuTypeEnum.LEFT || menuType.value === MenuTypeEnum.TOP_LEFT
+  )
+  const isDualMenu = computed(() => menuType.value === MenuTypeEnum.DUAL_MENU)
+
+  // 移动端屏幕判断（使用 computed 避免重复计算）
+  const isMobileScreen = computed(() => width.value < MOBILE_BREAKPOINT)
+
+  // 路由相关
+  const firstLevelMenuPath = computed(() => route.matched[0]?.path)
+  const routerPath = computed(() => String(route.meta.activePath || route.path))
+
+  // 菜单数据
+  const firstLevelMenus = computed(() => {
+    return useMenuStore().menuList.filter((menu) => !menu.meta.isHide)
+  })
+
+  const menuList = computed(() => {
+    const menuStore = useMenuStore()
+    const allMenus = menuStore.menuList
+
+    // 如果不是顶部左侧菜单或双列菜单，直接返回完整菜单列表
+    if (!isTopLeftMenu.value && !isDualMenu.value) {
+      return allMenus
+    }
+
+    // 处理 iframe 路径
+    if (isIframe(route.path)) {
+      return findIframeMenuList(route.path, allMenus)
+    }
+
+    // 处理一级菜单
+    if (route.meta.isFirstLevel) {
+      return []
+    }
+
+    // 返回当前顶级路径对应的子菜单
+    const currentTopPath = `/${route.path.split('/')[1]}`
+    const currentMenu = allMenus.find((menu) => menu.path === currentTopPath)
+    return currentMenu?.children ?? []
+  })
+
+  // 双列菜单收起时的滚动条样式
+  const scrollbarStyle = computed(() => {
+    const isCollapsed = isDualMenu.value && !menuOpen.value
+    return {
+      transform: isCollapsed ? 'translateY(-50px)' : 'translateY(0)',
+      height: isCollapsed ? 'calc(100% + 50px)' : 'calc(100% - 60px)',
+      transition: 'transform 0.3s ease'
+    }
+  })
+
+  /**
+   * 延迟隐藏移动端模态框（使用 VueUse 的 useTimeoutFn）
+   */
+  const { start: delayHideMobileModal } = useTimeoutFn(
+    () => {
+      showMobileModal.value = false
+    },
+    ANIMATION_DELAY,
+    { immediate: false }
+  )
+
+  /**
+   * 查找 iframe 对应的二级菜单列表
+   */
+  const findIframeMenuList = (currentPath: string, menuList: any[]) => {
+    // 递归查找包含当前路径的菜单项
+    const hasPath = (items: any[]): boolean => {
+      for (const item of items) {
+        if (item.path === currentPath) {
+          return true
+        }
+        if (item.children && hasPath(item.children)) {
+          return true
+        }
+      }
+      return false
+    }
+
+    // 遍历一级菜单查找匹配的子菜单
+    for (const menu of menuList) {
+      if (menu.children && hasPath(menu.children)) {
+        return menu.children
+      }
+    }
+    return []
+  }
+
+  const { homePath } = useCommon()
+
+  /**
+   * 导航到首页
+   */
+  const navigateToHome = (): void => {
+    router.push(homePath.value)
+  }
+
+  /**
+   * 切换菜单显示/隐藏
+   */
+  const toggleMenuVisibility = (): void => {
+    settingStore.setMenuOpen(!menuOpen.value)
+
+    // 移动端模态框控制逻辑
+    if (isMobileScreen.value) {
+      if (!menuOpen.value) {
+        // 菜单即将打开，立即显示模态框
+        showMobileModal.value = true
+      } else {
+        // 菜单即将关闭，延迟隐藏模态框确保动画完成
+        delayHideMobileModal()
+      }
+    }
+  }
+
+  /**
+   * 处理菜单关闭（来自子组件）
+   */
+  const handleMenuClose = (): void => {
+    if (isMobileScreen.value) {
+      settingStore.setMenuOpen(false)
+      delayHideMobileModal()
+    }
+  }
+
+  /**
+   * 切换双列菜单模式
+   */
+  const toggleDualMenuMode = (): void => {
+    settingStore.setDualMenuShowText(!dualMenuShowText.value)
+  }
+
+  /**
+   * 监听窗口尺寸变化，自动处理移动端菜单
+   */
+  watch(width, (newWidth) => {
+    if (newWidth < MOBILE_BREAKPOINT) {
+      settingStore.setMenuOpen(false)
+      if (!menuOpen.value) {
+        showMobileModal.value = false
+      }
+    } else {
+      showMobileModal.value = false
+    }
+  })
+
+  /**
+   * 监听菜单开关状态变化
+   */
+  watch(menuOpen, (isMenuOpen: boolean) => {
+    if (!isMobileScreen.value) {
+      // 大屏幕设备上，模态框始终隐藏
+      showMobileModal.value = false
+    } else {
+      // 小屏幕设备上，根据菜单状态控制模态框
+      if (isMenuOpen) {
+        // 菜单打开时立即显示模态框
+        showMobileModal.value = true
+      } else {
+        // 菜单关闭时延迟隐藏模态框，确保动画完成
+        delayHideMobileModal()
+      }
+    }
+  })
+</script>
+
+<style lang="scss" scoped>
+  @use './style';
+</style>
+
+<style lang="scss">
+  @use './theme';
+
+  .layout-sidebar {
+    // 展开的宽度
+    .el-menu:not(.el-menu--collapse) {
+      width: v-bind(menuopenwidth);
+    }
+
+    // 折叠后宽度
+    .el-menu--collapse {
+      width: v-bind(menuclosewidth);
+    }
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss b/web/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss
new file mode 100755
index 0000000..8cccdd9
--- /dev/null
+++ b/web/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss
@@ -0,0 +1,251 @@
+.layout-sidebar {
+  display: flex;
+  height: 100vh;
+  user-select: none;
+  scrollbar-width: none;
+  border-right: 1px solid var(--art-card-border);
+
+  &.no-border {
+    border-right: none !important;
+  }
+
+  // 自定义滚动条宽度
+  :deep(.el-scrollbar__bar.is-vertical) {
+    width: 4px;
+  }
+
+  :deep(.el-scrollbar__thumb) {
+    right: -2px;
+    background-color: #ccc;
+    border-radius: 2px;
+  }
+
+  .dual-menu-left {
+    position: relative;
+    width: 80px;
+    height: 100%;
+    border-right: 1px solid var(--art-card-border) !important;
+    transition: width 0.25s;
+
+    .logo {
+      margin: auto;
+      margin-top: 12px;
+      margin-bottom: 3px;
+      cursor: pointer;
+    }
+
+    ul {
+      li {
+        > div {
+          position: relative;
+          display: flex;
+          flex-direction: column;
+          align-items: center;
+          justify-content: center;
+          margin: 8px;
+          overflow: hidden;
+          text-align: center;
+          cursor: pointer;
+          border-radius: 5px;
+
+          .art-svg-icon {
+            display: block;
+            margin: 0 auto;
+            font-size: 20px;
+          }
+
+          span {
+            display: -webkit-box;
+            width: 100%;
+            overflow: hidden;
+            font-size: 12px;
+            text-overflow: ellipsis;
+            -webkit-line-clamp: 1;
+            line-clamp: 1;
+            -webkit-box-orient: vertical;
+          }
+
+          &.is-active {
+            background: var(--el-color-primary-light-9);
+
+            .art-svg-icon,
+            span {
+              color: var(--theme-color) !important;
+            }
+          }
+        }
+      }
+    }
+
+    .switch-btn {
+      position: absolute;
+      right: 0;
+      bottom: 15px;
+      left: 0;
+      margin: auto;
+    }
+  }
+
+  .menu-left {
+    position: relative;
+    box-sizing: border-box;
+    height: 100vh;
+
+    @media only screen and (width <= 640px) {
+      height: 100dvh;
+    }
+
+    .el-menu {
+      height: 100%;
+    }
+
+    &:hover {
+      .dual-menu-collapse-btn {
+        opacity: 1 !important;
+      }
+    }
+
+    .dual-menu-collapse-btn {
+      position: absolute;
+      top: 50%;
+      right: -11px;
+      z-index: 10;
+      width: 11px;
+      height: 50px;
+      cursor: pointer;
+      background-color: var(--default-box-color);
+      border: 1px solid var(--art-card-border);
+      border-radius: 0 15px 15px 0;
+      opacity: 0;
+      transition: opacity 0.2s;
+      transform: translateY(-50%);
+
+      &:hover {
+        .art-svg-icon {
+          color: var(--art-gray-800) !important;
+        }
+      }
+
+      .art-svg-icon {
+        position: absolute;
+        top: 0;
+        bottom: 0;
+        left: -4px;
+        margin: auto;
+        transition: all 0.3s;
+      }
+    }
+  }
+
+  .header {
+    position: relative;
+    box-sizing: border-box;
+    display: flex;
+    align-items: center;
+    width: 100%;
+    height: 60px;
+    overflow: hidden;
+    line-height: 60px;
+    cursor: pointer;
+
+    .logo {
+      margin-left: 22px;
+    }
+
+    p {
+      position: absolute;
+      top: 0;
+      bottom: 0;
+      left: 58px;
+      box-sizing: border-box;
+      margin-left: 10px;
+      font-size: 18px;
+
+      &.is-dual-menu-name {
+        left: 25px;
+        margin: auto;
+      }
+    }
+  }
+
+  .el-menu {
+    box-sizing: border-box;
+    // 防止菜单内的滚动影响整个页面滚动
+    overscroll-behavior: contain;
+    border-right: 0;
+    scrollbar-width: none;
+    -ms-scroll-chaining: contain;
+
+    &::-webkit-scrollbar {
+      width: 0 !important;
+    }
+  }
+
+  .menu-model {
+    display: none;
+  }
+}
+
+@media only screen and (width <= 800px) {
+  .layout-sidebar {
+    width: 0;
+
+    .header {
+      height: 50px;
+      line-height: 50px;
+    }
+
+    .el-menu {
+      height: calc(100vh - 60px);
+    }
+
+    .el-menu--collapse {
+      width: 0;
+    }
+
+    // 折叠状态下的header样式
+    .menu-left-close .header {
+      .logo {
+        display: none;
+      }
+
+      p {
+        left: 16px;
+        font-size: 0;
+        opacity: 0 !important;
+      }
+    }
+
+    .menu-model {
+      position: fixed;
+      top: 0;
+      left: 0;
+      z-index: -1;
+      display: block;
+      width: 100%;
+      height: 100vh;
+      background: rgba($color: #000, $alpha: 50%);
+      transition: opacity 0.2s ease-in-out;
+    }
+  }
+}
+
+@media only screen and (width <= 640px) {
+  .layout-sidebar {
+    border-right: 0 !important;
+  }
+}
+
+.dark {
+  .layout-sidebar {
+    border-right: 1px solid rgb(255 255 255 / 13%);
+
+    :deep(.el-scrollbar__thumb) {
+      background-color: #777;
+    }
+
+    .dual-menu-left {
+      border-right: 1px solid rgb(255 255 255 / 9%) !important;
+    }
+  }
+}
diff --git a/web/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss b/web/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss
new file mode 100644
index 0000000..7626c42
--- /dev/null
+++ b/web/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss
@@ -0,0 +1,258 @@
+@use '@styles/core/mixin.scss' as *;
+
+// 菜单样式变量
+$menu-height: 42px;
+$menu-icon-size: 20px;
+$menu-font-size: 14px;
+$hover-bg-color: var(--art-gray-200);
+$popup-menu-height: 40px;
+$popup-menu-padding: 8px;
+$popup-menu-margin: 5px;
+$popup-menu-radius: 6px;
+
+// 通用菜单项样式
+@mixin menu-item-base {
+  width: calc(100% - 16px);
+  margin-left: 8px;
+  border-radius: 6px;
+
+  .menu-icon {
+    margin-left: -7px;
+  }
+}
+
+// 通用 hover 样式
+@mixin menu-hover($bg-color) {
+  .el-sub-menu__title:hover,
+  .el-menu-item:not(.is-active):hover {
+    background: $bg-color !important;
+  }
+}
+
+// 通用选中样式
+@mixin menu-active($color, $bg-color, $icon-color: var(--theme-color)) {
+  .el-menu-item.is-active {
+    color: $color !important;
+    background-color: $bg-color;
+
+    .menu-icon {
+      .art-svg-icon {
+        color: $icon-color !important;
+      }
+    }
+  }
+}
+
+// 弹窗菜单项样式
+@mixin popup-menu-item {
+  height: $popup-menu-height;
+  margin-bottom: $popup-menu-margin;
+  border-radius: $popup-menu-radius;
+
+  .menu-icon {
+    margin-right: 5px;
+  }
+
+  &:last-of-type {
+    margin-bottom: 0;
+  }
+}
+
+// 主题菜单通用样式（合并 design 和 dark 主题的共同逻辑）
+@mixin theme-menu-base {
+  .el-sub-menu__title,
+  .el-menu-item {
+    @include menu-item-base;
+  }
+}
+
+// 弹窗菜单通用样式
+@mixin popup-menu-base($hover-bg, $active-color, $active-bg) {
+  .el-menu--popup {
+    padding: $popup-menu-padding;
+
+    .el-sub-menu__title:hover,
+    .el-menu-item:hover {
+      background-color: $hover-bg !important;
+      border-radius: $popup-menu-radius;
+    }
+
+    .el-menu-item {
+      @include popup-menu-item;
+
+      &.is-active {
+        color: $active-color !important;
+        background-color: $active-bg !important;
+      }
+    }
+
+    .el-sub-menu {
+      @include popup-menu-item;
+
+      height: $popup-menu-height !important;
+
+      .el-sub-menu__title {
+        height: $popup-menu-height !important;
+        border-radius: $popup-menu-radius;
+      }
+    }
+  }
+}
+
+.layout-sidebar {
+  // ---------------------- Modify default style ----------------------
+
+  // 菜单折叠样式
+  .menu-left-close {
+    .header {
+      .logo {
+        margin: 0 auto;
+      }
+    }
+  }
+
+  // 菜单图标
+  .menu-icon {
+    margin-right: 8px;
+    font-size: $menu-icon-size;
+  }
+
+  // 菜单高度
+  .el-sub-menu__title,
+  .el-menu-item {
+    height: $menu-height !important;
+    margin-bottom: 4px;
+    line-height: $menu-height !important;
+
+    span {
+      font-size: $menu-font-size !important;
+
+      @include ellipsis();
+    }
+  }
+
+  // 右侧箭头
+  .el-sub-menu__icon-arrow {
+    width: 13px !important;
+    font-size: 13px !important;
+  }
+
+  // 菜单折叠
+  .el-menu--collapse {
+    .el-sub-menu.is-active {
+      .el-sub-menu__title {
+        .menu-icon {
+          .art-svg-icon {
+            // 选中菜单图标颜色
+            color: var(--theme-color) !important;
+          }
+        }
+      }
+    }
+  }
+
+  // ---------------------- Design theme menu ----------------------
+  .el-menu-design {
+    @include theme-menu-base;
+    @include menu-active(var(--theme-color), var(--el-color-primary-light-9));
+    @include menu-hover($hover-bg-color);
+
+    .el-sub-menu__icon-arrow {
+      color: var(--art-gray-600);
+    }
+  }
+
+  // ---------------------- Dark theme menu ----------------------
+  .el-menu-dark {
+    @include theme-menu-base;
+    @include menu-active(#fff, #27282d, #fff);
+    @include menu-hover(#0f1015);
+
+    .el-sub-menu__icon-arrow {
+      color: var(--art-gray-400);
+    }
+  }
+
+  // ---------------------- Light theme menu ----------------------
+  .el-menu-light {
+    .el-sub-menu__title,
+    .el-menu-item {
+      .menu-icon {
+        margin-left: 1px;
+      }
+    }
+
+    .el-menu-item.is-active {
+      background-color: var(--el-color-primary-light-9);
+
+      .art-svg-icon {
+        color: var(--theme-color) !important;
+      }
+
+      &::before {
+        position: absolute;
+        top: 0;
+        left: 0;
+        width: 4px;
+        height: 100%;
+        content: '';
+        background: var(--theme-color);
+      }
+    }
+
+    @include menu-hover($hover-bg-color);
+
+    .el-sub-menu__icon-arrow {
+      color: var(--art-gray-600);
+    }
+  }
+}
+
+@media only screen and (width <= 640px) {
+  .layout-sidebar {
+    .el-menu-design {
+      > .el-sub-menu {
+        margin-left: 0;
+      }
+
+      .el-sub-menu {
+        width: 100% !important;
+      }
+    }
+  }
+}
+
+// 菜单折叠 hover 弹窗样式（浅色主题）
+.el-menu--vertical,
+.el-menu--popup-container {
+  @include popup-menu-base(var(--art-gray-200), var(--art-gray-900), var(--art-gray-200));
+}
+
+// 暗黑模式菜单样式
+.dark {
+  .el-menu--vertical,
+  .el-menu--popup-container {
+    @include popup-menu-base(var(--art-gray-200), var(--art-gray-900), #292a2e);
+  }
+
+  .layout-sidebar {
+    // 图标颜色、文字颜色
+    .menu-icon .art-svg-icon,
+    .menu-name {
+      color: var(--art-gray-800) !important;
+    }
+
+    // 选中的文字颜色跟图标颜色
+    .el-menu-item.is-active {
+      span,
+      .menu-icon .art-svg-icon {
+        color: var(--theme-color) !important;
+      }
+    }
+
+    // 右侧箭头颜色
+    .el-sub-menu__icon-arrow {
+      color: #fff;
+    }
+  }
+}
diff --git a/web/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue b/web/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue
new file mode 100755
index 0000000..9afa262
--- /dev/null
+++ b/web/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue
@@ -0,0 +1,199 @@
+<template>
+  <template v-for="(item, index) in filteredMenuItems" :key="getUniqueKey(item, index)">
+    <ElSubMenu v-if="hasChildren(item)" :index="item.path || item.meta.title" :level="level">
+      <template #title>
+        <div class="menu-icon flex-cc">
+          <ArtSvgIcon
+            :icon="item.meta.icon"
+            :color="theme?.iconColor"
+            :style="{ color: theme.iconColor }"
+          />
+        </div>
+        <span class="menu-name">
+          {{ formatMenuTitle(item.meta.title) }}
+        </span>
+        <div v-if="item.meta.showBadge" class="art-badge" style="right: 10px" />
+      </template>
+
+      <SidebarSubmenu
+        :list="item.children"
+        :is-mobile="isMobile"
+        :level="level + 1"
+        :theme="theme"
+        @close="closeMenu"
+      />
+    </ElSubMenu>
+
+    <ElMenuItem
+      v-else
+      :index="isExternalLink(item) ? undefined : item.path || item.meta.title"
+      :level-item="level + 1"
+      @click="goPage(item)"
+    >
+      <div class="menu-icon flex-cc">
+        <ArtSvgIcon
+          :icon="item.meta.icon"
+          :color="theme?.iconColor"
+          :style="{ color: theme.iconColor }"
+        />
+      </div>
+      <div
+        v-show="item.meta.showBadge && level === 0 && !menuOpen"
+        class="art-badge"
+        style="right: 5px"
+      />
+
+      <template #title>
+        <span class="menu-name">
+          {{ formatMenuTitle(item.meta.title) }}
+        </span>
+        <div v-if="item.meta.showBadge" class="art-badge" />
+        <div v-if="item.meta.showTextBadge && (level > 0 || menuOpen)" class="art-text-badge">
+          {{ item.meta.showTextBadge }}
+        </div>
+      </template>
+    </ElMenuItem>
+  </template>
+</template>
+
+<script setup lang="ts">
+  import { computed } from 'vue'
+  import type { AppRouteRecord } from '@/types/router'
+  import { formatMenuTitle } from '@/utils/router'
+  import { handleMenuJump } from '@/utils/navigation'
+  import { useSettingStore } from '@/store/modules/setting'
+
+  interface MenuTheme {
+    iconColor?: string
+  }
+
+  interface Props {
+    /** 菜单标题 */
+    title?: string
+    /** 菜单列表 */
+    list?: AppRouteRecord[]
+    /** 主题配置 */
+    theme?: MenuTheme
+    /** 是否为移动端模式 */
+    isMobile?: boolean
+    /** 菜单层级 */
+    level?: number
+  }
+
+  interface Emits {
+    /** 关闭菜单事件 */
+    (e: 'close'): void
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    title: '',
+    list: () => [],
+    theme: () => ({}),
+    isMobile: false,
+    level: 0
+  })
+
+  const emit = defineEmits<Emits>()
+
+  const settingStore = useSettingStore()
+
+  const { menuOpen } = storeToRefs(settingStore)
+
+  /**
+   * 过滤后的菜单项列表
+   * 只显示未隐藏的菜单项
+   */
+  const filteredMenuItems = computed(() => filterRoutes(props.list))
+
+  /**
+   * 跳转到指定页面
+   * @param item 菜单项数据
+   */
+  const goPage = (item: AppRouteRecord): void => {
+    closeMenu()
+    handleMenuJump(item)
+  }
+
+  /**
+   * 关闭菜单
+   * 触发父组件的关闭事件
+   */
+  const closeMenu = (): void => {
+    emit('close')
+  }
+
+  /**
+   * 判断菜单项本身是否可以作为可点击页面保留在菜单中
+   */
+  const isNavigableRoute = (item: AppRouteRecord): boolean => {
+    return !!(
+      !item.meta.isHide &&
+      ((item.path && item.path.trim()) || item.meta.link || item.meta.isIframe === true) &&
+      (item.component || item.meta.link || item.meta.isIframe === true)
+    )
+  }
+
+  /**
+   * 递归过滤菜单路由，移除隐藏的菜单项
+   * 但如果父菜单本身就是可访问页面，则即使子菜单都被隐藏也应该保留
+   * @param items 菜单项数组
+   * @returns 过滤后的菜单项数组
+   */
+  const filterRoutes = (items: AppRouteRecord[]): AppRouteRecord[] => {
+    return items
+      .filter((item) => {
+        // 如果当前项被隐藏，直接过滤掉
+        if (item.meta.isHide) {
+          return false
+        }
+
+        // 如果有子菜单，递归过滤子菜单
+        if (item.children && item.children.length > 0) {
+          const filteredChildren = filterRoutes(item.children)
+          // 目录菜单要求有可见子菜单；页面菜单则允许仅保留自身
+          return filteredChildren.length > 0 || isNavigableRoute(item)
+        }
+
+        // 叶子节点且未被隐藏，保留
+        return isNavigableRoute(item)
+      })
+      .map((item) => ({
+        ...item,
+        children: item.children ? filterRoutes(item.children) : undefined
+      }))
+  }
+
+  /**
+   * 判断菜单项是否包含可见的子菜单
+   * @param item 菜单项数据
+   * @returns 是否包含可见的子菜单
+   */
+  const hasChildren = (item: AppRouteRecord): boolean => {
+    if (!item.children || item.children.length === 0) {
+      return false
+    }
+    // 递归检查是否有可见的子菜单
+    const filteredChildren = filterRoutes(item.children)
+    return filteredChildren.length > 0
+  }
+
+  /**
+   * 判断是否为外部链接
+   * @param item 菜单项数据
+   * @returns 是否为外部链接
+   */
+  const isExternalLink = (item: AppRouteRecord): boolean => {
+    return !!(item.meta.link && !item.meta.isIframe)
+  }
+
+  /**
+   * 生成唯一的 key
+   * 使用 path、title 和 index 组合确保唯一性
+   * @param item 菜单项数据
+   * @param index 索引
+   * @returns 唯一的 key
+   */
+  const getUniqueKey = (item: AppRouteRecord, index: number): string => {
+    return `${item.path || item.meta.title || 'menu'}-${props.level}-${index}`
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-notification/index.vue b/web/src/components/core/layouts/art-notification/index.vue
new file mode 100755
index 0000000..a58853c
--- /dev/null
+++ b/web/src/components/core/layouts/art-notification/index.vue
@@ -0,0 +1,456 @@
+<!-- 通知组件 -->
+<template>
+  <div
+    class="art-notification-panel art-card-sm !shadow-xl"
+    :style="{
+      transform: show ? 'scaleY(1)' : 'scaleY(0.9)',
+      opacity: show ? 1 : 0
+    }"
+    v-show="visible"
+    @click.stop
+  >
+    <div class="flex-cb px-3.5 mt-3.5">
+      <span class="text-base font-medium text-g-800">{{ $t('notice.title') }}</span>
+      <span class="text-xs text-g-800 px-1.5 py-1 c-p select-none rounded hover:bg-g-200">
+        {{ $t('notice.btnRead') }}
+      </span>
+    </div>
+
+    <ul class="box-border flex items-end w-full h-12.5 px-3.5 border-b-d">
+      <li
+        v-for="(item, index) in barList"
+        :key="index"
+        class="h-12 leading-12 mr-5 overflow-hidden text-[13px] text-g-700 c-p select-none"
+        :class="{ 'bar-active': barActiveIndex === index }"
+        @click="changeBar(index)"
+      >
+        {{ item.name }} ({{ item.num }})
+      </li>
+    </ul>
+
+    <div class="w-full h-[calc(100%-95px)]">
+      <div class="h-[calc(100%-60px)] overflow-y-scroll scrollbar-thin">
+        <!-- 通知 -->
+        <ul v-show="barActiveIndex === 0">
+          <li
+            v-for="(item, index) in noticeList"
+            :key="index"
+            class="box-border flex-c px-3.5 py-3.5 c-p last:border-b-0 hover:bg-g-200/60"
+          >
+            <div
+              class="size-9 leading-9 text-center rounded-lg flex-cc"
+              :class="[getNoticeStyle(item.type).iconClass]"
+            >
+              <ArtSvgIcon class="text-lg !bg-transparent" :icon="getNoticeStyle(item.type).icon" />
+            </div>
+            <div class="w-[calc(100%-45px)] ml-3.5">
+              <h4 class="text-sm font-normal leading-5.5 text-g-900">{{ item.title }}</h4>
+              <p class="mt-1.5 text-xs text-g-500">{{ item.time }}</p>
+            </div>
+          </li>
+        </ul>
+
+        <!-- 消息 -->
+        <ul v-show="barActiveIndex === 1">
+          <li
+            v-for="(item, index) in msgList"
+            :key="index"
+            class="box-border flex-c px-3.5 py-3.5 c-p last:border-b-0 hover:bg-g-200/60"
+          >
+            <div class="w-9 h-9">
+              <img :src="item.avatar" class="w-full h-full rounded-lg" />
+            </div>
+            <div class="w-[calc(100%-45px)] ml-3.5">
+              <h4 class="text-xs font-normal leading-5.5">{{ item.title }}</h4>
+              <p class="mt-1.5 text-xs text-g-500">{{ item.time }}</p>
+            </div>
+          </li>
+        </ul>
+
+        <!-- 待办 -->
+        <ul v-show="barActiveIndex === 2">
+          <li
+            v-for="(item, index) in pendingList"
+            :key="index"
+            class="box-border px-5 py-3.5 last:border-b-0"
+          >
+            <h4>{{ item.title }}</h4>
+            <p class="text-xs text-g-500">{{ item.time }}</p>
+          </li>
+        </ul>
+
+        <!-- 空状态 -->
+        <div
+          v-show="currentTabIsEmpty"
+          class="relative top-25 h-full text-g-500 text-center !bg-transparent"
+        >
+          <ArtSvgIcon icon="system-uicons:inbox" class="text-5xl" />
+          <p class="mt-3.5 text-xs !bg-transparent"
+            >{{ $t('notice.text[0]') }}{{ barList[barActiveIndex].name }}</p
+          >
+        </div>
+      </div>
+
+      <div class="relative box-border w-full px-3.5">
+        <ElButton class="w-full mt-3" @click="handleViewAll" v-ripple>
+          {{ $t('notice.viewAll') }}
+        </ElButton>
+      </div>
+    </div>
+
+    <div class="h-25"></div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { computed, ref, watch, type Ref, type ComputedRef } from 'vue'
+  import { useI18n } from 'vue-i18n'
+
+  // 导入头像图片
+  import avatar1 from '@/assets/images/avatar/avatar1.webp'
+  import avatar2 from '@/assets/images/avatar/avatar2.webp'
+  import avatar3 from '@/assets/images/avatar/avatar3.webp'
+  import avatar4 from '@/assets/images/avatar/avatar4.webp'
+  import avatar5 from '@/assets/images/avatar/avatar5.webp'
+  import avatar6 from '@/assets/images/avatar/avatar6.webp'
+
+  defineOptions({ name: 'ArtNotification' })
+
+  interface NoticeItem {
+    /** 标题 */
+    title: string
+    /** 时间 */
+    time: string
+    /** 类型 */
+    type: NoticeType
+  }
+
+  interface MessageItem {
+    /** 标题 */
+    title: string
+    /** 时间 */
+    time: string
+    /** 头像 */
+    avatar: string
+  }
+
+  interface PendingItem {
+    /** 标题 */
+    title: string
+    /** 时间 */
+    time: string
+  }
+
+  interface BarItem {
+    /** 名称 */
+    name: ComputedRef<string>
+    /** 数量 */
+    num: number
+  }
+
+  interface NoticeStyle {
+    /** 图标 */
+    icon: string
+    /** icon 样式 */
+    iconClass: string
+  }
+
+  type NoticeType = 'email' | 'message' | 'collection' | 'user' | 'notice'
+
+  const { t } = useI18n()
+
+  const props = defineProps<{
+    value: boolean
+  }>()
+
+  const emit = defineEmits<{
+    'update:value': [value: boolean]
+  }>()
+
+  const show = ref(false)
+  const visible = ref(false)
+  const barActiveIndex = ref(0)
+
+  const useNotificationData = () => {
+    // 通知数据
+    const noticeList = ref<NoticeItem[]>([
+      {
+        title: '新增国际化',
+        time: '2024-6-13 0:10',
+        type: 'notice'
+      },
+      {
+        title: '冷月呆呆给你发了一条消息',
+        time: '2024-4-21 8:05',
+        type: 'message'
+      },
+      {
+        title: '小肥猪关注了你',
+        time: '2020-3-17 21:12',
+        type: 'collection'
+      },
+      {
+        title: '新增使用文档',
+        time: '2024-02-14 0:20',
+        type: 'notice'
+      },
+      {
+        title: '小肥猪给你发了一封邮件',
+        time: '2024-1-20 0:15',
+        type: 'email'
+      },
+      {
+        title: '菜单mock本地真实数据',
+        time: '2024-1-17 22:06',
+        type: 'notice'
+      }
+    ])
+
+    // 消息数据
+    const msgList = ref<MessageItem[]>([
+      {
+        title: '池不胖 关注了你',
+        time: '2021-2-26 23:50',
+        avatar: avatar1
+      },
+      {
+        title: '唐不苦 关注了你',
+        time: '2021-2-21 8:05',
+        avatar: avatar2
+      },
+      {
+        title: '中小鱼 关注了你',
+        time: '2020-1-17 21:12',
+        avatar: avatar3
+      },
+      {
+        title: '何小荷 关注了你',
+        time: '2021-01-14 0:20',
+        avatar: avatar4
+      },
+      {
+        title: '誶誶淰 关注了你',
+        time: '2020-12-20 0:15',
+        avatar: avatar5
+      },
+      {
+        title: '冷月呆呆 关注了你',
+        time: '2020-12-17 22:06',
+        avatar: avatar6
+      }
+    ])
+
+    // 待办数据
+    const pendingList = ref<PendingItem[]>([])
+
+    // 标签栏数据
+    const barList = computed<BarItem[]>(() => [
+      {
+        name: computed(() => t('notice.bar[0]')),
+        num: noticeList.value.length
+      },
+      {
+        name: computed(() => t('notice.bar[1]')),
+        num: msgList.value.length
+      },
+      {
+        name: computed(() => t('notice.bar[2]')),
+        num: pendingList.value.length
+      }
+    ])
+
+    return {
+      noticeList,
+      msgList,
+      pendingList,
+      barList
+    }
+  }
+
+  // 样式管理
+  const useNotificationStyles = () => {
+    const noticeStyleMap: Record<NoticeType, NoticeStyle> = {
+      email: {
+        icon: 'ri:mail-line',
+        iconClass: 'bg-warning/12 text-warning'
+      },
+      message: {
+        icon: 'ri:volume-down-line',
+        iconClass: 'bg-success/12 text-success'
+      },
+      collection: {
+        icon: 'ri:heart-3-line',
+        iconClass: 'bg-danger/12 text-danger'
+      },
+      user: {
+        icon: 'ri:volume-down-line',
+        iconClass: 'bg-info/12 text-info'
+      },
+      notice: {
+        icon: 'ri:notification-3-line',
+        iconClass: 'bg-theme/12 text-theme'
+      }
+    }
+
+    const getNoticeStyle = (type: NoticeType): NoticeStyle => {
+      const defaultStyle: NoticeStyle = {
+        icon: 'ri:arrow-right-circle-line',
+        iconClass: 'bg-theme/12 text-theme'
+      }
+
+      return noticeStyleMap[type] || defaultStyle
+    }
+
+    return {
+      getNoticeStyle
+    }
+  }
+
+  // 动画管理
+  const useNotificationAnimation = () => {
+    const showNotice = (open: boolean) => {
+      if (open) {
+        visible.value = true
+        setTimeout(() => {
+          show.value = true
+        }, 5)
+      } else {
+        show.value = false
+        setTimeout(() => {
+          visible.value = false
+        }, 350)
+      }
+    }
+
+    return {
+      showNotice
+    }
+  }
+
+  // 标签页管理
+  const useTabManagement = (
+    noticeList: Ref<NoticeItem[]>,
+    msgList: Ref<MessageItem[]>,
+    pendingList: Ref<PendingItem[]>,
+    businessHandlers: {
+      handleNoticeAll: () => void
+      handleMsgAll: () => void
+      handlePendingAll: () => void
+    }
+  ) => {
+    const changeBar = (index: number) => {
+      barActiveIndex.value = index
+    }
+
+    // 检查当前标签页是否为空
+    const currentTabIsEmpty = computed(() => {
+      const tabDataMap = [noticeList.value, msgList.value, pendingList.value]
+
+      const currentData = tabDataMap[barActiveIndex.value]
+      return currentData && currentData.length === 0
+    })
+
+    const handleViewAll = () => {
+      // 查看全部处理器映射
+      const viewAllHandlers: Record<number, () => void> = {
+        0: businessHandlers.handleNoticeAll,
+        1: businessHandlers.handleMsgAll,
+        2: businessHandlers.handlePendingAll
+      }
+
+      const handler = viewAllHandlers[barActiveIndex.value]
+      handler?.()
+
+      // 关闭通知面板
+      emit('update:value', false)
+    }
+
+    return {
+      changeBar,
+      currentTabIsEmpty,
+      handleViewAll
+    }
+  }
+
+  // 业务逻辑处理
+  const useBusinessLogic = () => {
+    const handleNoticeAll = () => {
+      // 处理查看全部通知
+      console.log('查看全部通知')
+    }
+
+    const handleMsgAll = () => {
+      // 处理查看全部消息
+      console.log('查看全部消息')
+    }
+
+    const handlePendingAll = () => {
+      // 处理查看全部待办
+      console.log('查看全部待办')
+    }
+
+    return {
+      handleNoticeAll,
+      handleMsgAll,
+      handlePendingAll
+    }
+  }
+
+  // 组合所有逻辑
+  const { noticeList, msgList, pendingList, barList } = useNotificationData()
+  const { getNoticeStyle } = useNotificationStyles()
+  const { showNotice } = useNotificationAnimation()
+  const { handleNoticeAll, handleMsgAll, handlePendingAll } = useBusinessLogic()
+  const { changeBar, currentTabIsEmpty, handleViewAll } = useTabManagement(
+    noticeList,
+    msgList,
+    pendingList,
+    { handleNoticeAll, handleMsgAll, handlePendingAll }
+  )
+
+  // 监听属性变化
+  watch(
+    () => props.value,
+    (newValue) => {
+      showNotice(newValue)
+    }
+  )
+</script>
+
+<style scoped>
+  @reference '@styles/core/tailwind.css';
+
+  .art-notification-panel {
+    @apply absolute 
+    top-14.5 
+    right-5 
+    w-90 
+    h-125 
+    overflow-hidden 
+    transition-all 
+    duration-300
+    origin-top 
+    will-change-[top,left] 
+    max-[640px]:top-[65px]
+    max-[640px]:right-0
+    max-[640px]:w-full 
+    max-[640px]:h-[80vh];
+  }
+
+  .bar-active {
+    color: var(--theme-color) !important;
+    border-bottom: 2px solid var(--theme-color);
+  }
+
+  .scrollbar-thin::-webkit-scrollbar {
+    width: 5px !important;
+  }
+
+  .dark .scrollbar-thin::-webkit-scrollbar-track {
+    background-color: var(--default-box-color);
+  }
+
+  .dark .scrollbar-thin::-webkit-scrollbar-thumb {
+    background-color: #222 !important;
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-page-content/index.vue b/web/src/components/core/layouts/art-page-content/index.vue
new file mode 100644
index 0000000..a862df1
--- /dev/null
+++ b/web/src/components/core/layouts/art-page-content/index.vue
@@ -0,0 +1,136 @@
+<!-- 布局内容 -->
+<template>
+  <div class="layout-content" :class="{ 'overflow-auto': isFullPage }" :style="containerStyle">
+    <div id="app-content-header">
+      <!-- 节日滚动 -->
+      <ArtFestivalTextScroll v-if="!isFullPage" />
+
+      <!-- 路由信息调试 -->
+      <div
+        v-if="isOpenRouteInfo === 'true'"
+        class="px-2 py-1.5 mb-3 text-sm text-g-500 bg-g-200 border-full-d rounded-md"
+      >
+        router meta：{{ route.meta }}
+      </div>
+    </div>
+
+    <RouterView v-if="isRefresh" v-slot="{ Component, route }" :style="contentStyle">
+      <!-- 缓存路由动画 -->
+      <Transition :name="showTransitionMask ? '' : actualTransition" mode="out-in" appear>
+        <KeepAlive :max="10" :exclude="keepAliveExclude">
+          <component
+            class="art-page-view"
+            :is="Component"
+            :key="route.path"
+            v-if="route.meta.keepAlive"
+          />
+        </KeepAlive>
+      </Transition>
+
+      <!-- 非缓存路由动画 -->
+      <Transition :name="showTransitionMask ? '' : actualTransition" mode="out-in" appear>
+        <component
+          class="art-page-view"
+          :is="Component"
+          :key="route.path"
+          v-if="!route.meta.keepAlive"
+        />
+      </Transition>
+    </RouterView>
+
+    <!-- 全屏页面切换过渡遮罩（用于提升页面切换视觉体验） -->
+    <Teleport to="body">
+      <div
+        v-show="showTransitionMask"
+        class="fixed top-0 left-0 z-[2000] w-screen h-screen pointer-events-none bg-box"
+      />
+    </Teleport>
+  </div>
+</template>
+<script setup lang="ts">
+  import type { CSSProperties } from 'vue'
+  import { useRoute } from 'vue-router'
+  import { useAutoLayoutHeight } from '@/hooks/core/useLayoutHeight'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useWorktabStore } from '@/store/modules/worktab'
+
+  defineOptions({ name: 'ArtPageContent' })
+
+  const route = useRoute()
+  const { containerMinHeight } = useAutoLayoutHeight()
+  const { pageTransition, containerWidth, refresh } = storeToRefs(useSettingStore())
+  const { keepAliveExclude } = storeToRefs(useWorktabStore())
+
+  const isRefresh = shallowRef(true)
+  const isOpenRouteInfo = import.meta.env.VITE_OPEN_ROUTE_INFO
+  const showTransitionMask = ref(false)
+
+  // 标记是否是首次加载（浏览器刷新）
+  const isFirstLoad = ref(true)
+
+  // 检查当前路由是否需要使用无基础布局模式
+  const isFullPage = computed(() => route.matched.some((r) => r.meta?.isFullPage))
+  const prevIsFullPage = ref(isFullPage.value)
+
+  // 切换动画名称：首次加载、从全屏返回时不使用动画
+  const actualTransition = computed(() => {
+    if (isFirstLoad.value) return ''
+    if (prevIsFullPage.value && !isFullPage.value) return ''
+    return pageTransition.value
+  })
+
+  // 监听全屏状态变化，显示过渡遮罩
+  watch(isFullPage, (val, oldVal) => {
+    if (val !== oldVal) {
+      showTransitionMask.value = true
+      // 延迟隐藏遮罩，给足时间让页面完成切换
+      setTimeout(() => {
+        showTransitionMask.value = false
+      }, 50)
+    }
+
+    nextTick(() => {
+      prevIsFullPage.value = val
+    })
+  })
+
+  const containerStyle = computed(
+    (): CSSProperties =>
+      isFullPage.value
+        ? {
+            position: 'fixed',
+            top: 0,
+            left: 0,
+            width: '100%',
+            height: '100vh',
+            zIndex: 2500,
+            background: 'var(--default-bg-color)'
+          }
+        : {
+            maxWidth: containerWidth.value
+          }
+  )
+
+  const contentStyle = computed(
+    (): CSSProperties => ({
+      minHeight: containerMinHeight.value
+    })
+  )
+
+  const reload = () => {
+    isRefresh.value = false
+    nextTick(() => {
+      isRefresh.value = true
+    })
+  }
+
+  watch(refresh, reload, { flush: 'post' })
+
+  // 组件挂载后标记首次加载完成
+  onMounted(() => {
+    // 延迟一帧，确保首次渲染完成
+    nextTick(() => {
+      isFirstLoad.value = false
+    })
+  })
+</script>
diff --git a/web/src/components/core/layouts/art-screen-lock/index.vue b/web/src/components/core/layouts/art-screen-lock/index.vue
new file mode 100644
index 0000000..5bf5248
--- /dev/null
+++ b/web/src/components/core/layouts/art-screen-lock/index.vue
@@ -0,0 +1,519 @@
+<!-- 锁屏 -->
+<template>
+  <div class="layout-lock-screen">
+    <!-- 开发者工具警告覆盖层 -->
+    <div
+      v-if="showDevToolsWarning"
+      class="fixed top-0 left-0 z-[999999] flex-cc w-full h-full text-white bg-gradient-to-br from-[#1e1e1e] to-black animate-fade-in"
+    >
+      <div class="p-5 text-center select-none">
+        <div class="mb-7.5 text-5xl">🔒</div>
+        <h1 class="m-0 mb-5 text-3xl font-semibold text-danger">系统已锁定</h1>
+        <p class="max-w-125 m-0 text-lg leading-relaxed text-white">
+          检测到开发者工具已打开<br />
+          为了系统安全，请关闭开发者工具后继续使用
+        </p>
+        <div class="mt-7.5 text-sm text-gray-400">Security Lock Activated</div>
+      </div>
+    </div>
+
+    <!-- 锁屏弹窗 -->
+    <div v-if="!isLock">
+      <ElDialog v-model="visible" :width="370" :show-close="false" @open="handleDialogOpen">
+        <div class="flex-c flex-col">
+          <img class="w-16 h-16 rounded-full" src="@imgs/user/avatar.webp" alt="用户头像" />
+          <div class="mt-7.5 mb-3.5 text-base font-medium">{{ userInfo.userName }}</div>
+          <ElForm
+            ref="formRef"
+            :model="formData"
+            :rules="rules"
+            class="w-[90%]"
+            @submit.prevent="handleLock"
+          >
+            <ElFormItem prop="password">
+              <ElInput
+                v-model="formData.password"
+                type="password"
+                :placeholder="$t('lockScreen.lock.inputPlaceholder')"
+                :show-password="true"
+                autocomplete="new-password"
+                ref="lockInputRef"
+                class="w-full mt-9"
+                @keyup.enter="handleLock"
+              >
+                <template #suffix>
+                  <ElIcon class="c-p" @click="handleLock">
+                    <Lock />
+                  </ElIcon>
+                </template>
+              </ElInput>
+            </ElFormItem>
+            <ElButton type="primary" class="w-full mt-0.5" @click="handleLock" v-ripple>
+              {{ $t('lockScreen.lock.btnText') }}
+            </ElButton>
+          </ElForm>
+        </div>
+      </ElDialog>
+    </div>
+
+    <!-- 解锁界面 -->
+    <div v-else class="unlock-content">
+      <div class="flex-c flex-col w-80">
+        <img class="w-16 h-16 mt-5 rounded-full" src="@imgs/user/avatar.webp" alt="用户头像" />
+        <div class="mt-3 mb-3.5 text-base font-medium">
+          {{ userInfo.userName }}
+        </div>
+        <ElForm
+          ref="unlockFormRef"
+          :model="unlockForm"
+          :rules="rules"
+          class="w-full !px-2.5"
+          @submit.prevent="handleUnlock"
+        >
+          <ElFormItem prop="password">
+            <ElInput
+              v-model="unlockForm.password"
+              type="password"
+              :placeholder="$t('lockScreen.unlock.inputPlaceholder')"
+              :show-password="true"
+              autocomplete="new-password"
+              ref="unlockInputRef"
+              class="mt-5"
+            >
+              <template #suffix>
+                <ElIcon class="c-p" @click="handleUnlock">
+                  <Unlock />
+                </ElIcon>
+              </template>
+            </ElInput>
+          </ElFormItem>
+
+          <ElButton type="primary" class="w-full mt-2" @click="handleUnlock" v-ripple>
+            {{ $t('lockScreen.unlock.btnText') }}
+          </ElButton>
+          <div class="w-full text-center">
+            <ElButton
+              text
+              class="mt-2.5 !text-g-600 hover:!text-theme hover:!bg-transparent"
+              @click="toLogin"
+            >
+              {{ $t('lockScreen.unlock.backBtnText') }}
+            </ElButton>
+          </div>
+        </ElForm>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Lock, Unlock } from '@element-plus/icons-vue'
+  import type { FormInstance, FormRules } from 'element-plus'
+  import { useI18n } from 'vue-i18n'
+  import CryptoJS from 'crypto-js'
+  import { useUserStore } from '@/store/modules/user'
+  import { mittBus } from '@/utils/sys'
+
+  // 国际化
+  const { t } = useI18n()
+
+  // 环境变量
+  const ENCRYPT_KEY = import.meta.env.VITE_LOCK_ENCRYPT_KEY
+
+  // Store
+  const userStore = useUserStore()
+  const { info: userInfo, lockPassword, isLock } = storeToRefs(userStore)
+
+  // 响应式数据
+  const visible = ref<boolean>(false)
+  const lockInputRef = ref<any>(null)
+  const unlockInputRef = ref<any>(null)
+  const showDevToolsWarning = ref<boolean>(false)
+
+  // 表单相关
+  const formRef = ref<FormInstance>()
+  const unlockFormRef = ref<FormInstance>()
+
+  const formData = reactive({
+    password: ''
+  })
+
+  const unlockForm = reactive({
+    password: ''
+  })
+
+  // 表单验证规则
+  const rules = computed<FormRules>(() => ({
+    password: [
+      {
+        required: true,
+        message: t('lockScreen.lock.inputPlaceholder'),
+        trigger: 'blur'
+      }
+    ]
+  }))
+
+  // 检测是否为移动设备
+  const isMobile = () => {
+    return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(
+      navigator.userAgent
+    )
+  }
+
+  // 添加禁用控制台的函数
+  const disableDevTools = () => {
+    // 禁用右键菜单
+    const handleContextMenu = (e: Event) => {
+      if (isLock.value) {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+    }
+    document.addEventListener('contextmenu', handleContextMenu, true)
+
+    // 禁用开发者工具相关快捷键
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (!isLock.value) return
+
+      // 禁用 F12
+      if (e.key === 'F12') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+Shift+I/J/C/K (开发者工具)
+      if (e.ctrlKey && e.shiftKey) {
+        const key = e.key.toLowerCase()
+        if (['i', 'j', 'c', 'k'].includes(key)) {
+          e.preventDefault()
+          e.stopPropagation()
+          return false
+        }
+      }
+
+      // 禁用 Ctrl+U (查看源代码)
+      if (e.ctrlKey && e.key.toLowerCase() === 'u') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+S (保存页面)
+      if (e.ctrlKey && e.key.toLowerCase() === 's') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+A (全选)
+      if (e.ctrlKey && e.key.toLowerCase() === 'a') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+P (打印)
+      if (e.ctrlKey && e.key.toLowerCase() === 'p') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+F (查找)
+      if (e.ctrlKey && e.key.toLowerCase() === 'f') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Alt+Tab (切换窗口)
+      if (e.altKey && e.key === 'Tab') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+Tab (切换标签页)
+      if (e.ctrlKey && e.key === 'Tab') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+W (关闭标签页)
+      if (e.ctrlKey && e.key.toLowerCase() === 'w') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+R 和 F5 (刷新页面)
+      if ((e.ctrlKey && e.key.toLowerCase() === 'r') || e.key === 'F5') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+
+      // 禁用 Ctrl+Shift+R (强制刷新)
+      if (e.ctrlKey && e.shiftKey && e.key.toLowerCase() === 'r') {
+        e.preventDefault()
+        e.stopPropagation()
+        return false
+      }
+    }
+    document.addEventListener('keydown', handleKeyDown, true)
+
+    // 禁用选择文本
+    const handleSelectStart = (e: Event) => {
+      if (isLock.value) {
+        e.preventDefault()
+        return false
+      }
+    }
+    document.addEventListener('selectstart', handleSelectStart, true)
+
+    // 禁用拖拽
+    const handleDragStart = (e: Event) => {
+      if (isLock.value) {
+        e.preventDefault()
+        return false
+      }
+    }
+    document.addEventListener('dragstart', handleDragStart, true)
+
+    // 监听开发者工具打开状态（仅在桌面端启用）
+    let devtools = { open: false }
+    const threshold = 160
+    let devToolsInterval: ReturnType<typeof setInterval> | null = null
+
+    const checkDevTools = () => {
+      if (!isLock.value || isMobile()) return
+
+      const isDevToolsOpen =
+        window.outerHeight - window.innerHeight > threshold ||
+        window.outerWidth - window.innerWidth > threshold
+
+      if (isDevToolsOpen && !devtools.open) {
+        devtools.open = true
+        showDevToolsWarning.value = true
+      } else if (!isDevToolsOpen && devtools.open) {
+        devtools.open = false
+        showDevToolsWarning.value = false
+      }
+    }
+
+    // 仅在桌面端启用开发者工具检测
+    if (!isMobile()) {
+      devToolsInterval = setInterval(checkDevTools, 500)
+    }
+
+    // 返回清理函数
+    return () => {
+      document.removeEventListener('contextmenu', handleContextMenu, true)
+      document.removeEventListener('keydown', handleKeyDown, true)
+      document.removeEventListener('selectstart', handleSelectStart, true)
+      document.removeEventListener('dragstart', handleDragStart, true)
+      if (devToolsInterval) {
+        clearInterval(devToolsInterval)
+      }
+    }
+  }
+
+  // 工具函数
+  const verifyPassword = (inputPassword: string, storedPassword: string): boolean => {
+    try {
+      const decryptedPassword = CryptoJS.AES.decrypt(storedPassword, ENCRYPT_KEY).toString(
+        CryptoJS.enc.Utf8
+      )
+      return inputPassword === decryptedPassword
+    } catch (error) {
+      console.error('密码解密失败:', error)
+      return false
+    }
+  }
+
+  // 事件处理函数
+  const handleKeydown = (event: KeyboardEvent) => {
+    if (event.altKey && event.key.toLowerCase() === '¬') {
+      event.preventDefault()
+      visible.value = true
+    }
+  }
+
+  const handleDialogOpen = () => {
+    setTimeout(() => {
+      lockInputRef.value?.input?.focus()
+    }, 100)
+  }
+
+  const handleLock = async () => {
+    if (!formRef.value) return
+
+    await formRef.value.validate((valid, fields) => {
+      if (valid) {
+        const encryptedPassword = CryptoJS.AES.encrypt(formData.password, ENCRYPT_KEY).toString()
+        userStore.setLockStatus(true)
+        userStore.setLockPassword(encryptedPassword)
+        visible.value = false
+        formData.password = ''
+      } else {
+        console.error('表单验证失败:', fields)
+      }
+    })
+  }
+
+  const handleUnlock = async () => {
+    if (!unlockFormRef.value) return
+
+    await unlockFormRef.value.validate((valid, fields) => {
+      if (valid) {
+        const isValid = verifyPassword(unlockForm.password, lockPassword.value)
+
+        if (isValid) {
+          try {
+            userStore.setLockStatus(false)
+            userStore.setLockPassword('')
+            unlockForm.password = ''
+            visible.value = false
+            showDevToolsWarning.value = false
+          } catch (error) {
+            console.error('更新store失败:', error)
+          }
+        } else {
+          // 触发抖动动画
+          const inputElement = unlockInputRef.value?.$el
+          if (inputElement) {
+            inputElement.classList.add('shake-animation')
+            setTimeout(() => {
+              inputElement.classList.remove('shake-animation')
+            }, 300)
+          }
+          ElMessage.error(t('lockScreen.pwdError'))
+          unlockForm.password = ''
+        }
+      } else {
+        console.error('表单验证失败:', fields)
+      }
+    })
+  }
+
+  const toLogin = () => {
+    userStore.logOut()
+  }
+
+  const openLockScreen = () => {
+    visible.value = true
+  }
+
+  // 监听锁屏状态变化
+  watch(isLock, (newValue) => {
+    if (newValue) {
+      document.body.style.overflow = 'hidden'
+      setTimeout(() => {
+        unlockInputRef.value?.input?.focus()
+      }, 100)
+    } else {
+      document.body.style.overflow = 'auto'
+      showDevToolsWarning.value = false
+    }
+  })
+
+  // 存储清理函数
+  let cleanupDevTools: (() => void) | null = null
+
+  // 生命周期钩子
+  onMounted(() => {
+    mittBus.on('openLockScreen', openLockScreen)
+    document.addEventListener('keydown', handleKeydown)
+
+    if (isLock.value) {
+      visible.value = true
+      setTimeout(() => {
+        unlockInputRef.value?.input?.focus()
+      }, 100)
+    }
+
+    // 初始化禁用开发者工具功能
+    cleanupDevTools = disableDevTools()
+  })
+
+  onUnmounted(() => {
+    document.removeEventListener('keydown', handleKeydown)
+    document.body.style.overflow = 'auto'
+    // 清理禁用开发者工具的事件监听器
+    if (cleanupDevTools) {
+      cleanupDevTools()
+      cleanupDevTools = null
+    }
+  })
+</script>
+
+<style lang="scss" scoped>
+  .layout-lock-screen :deep(.el-dialog) {
+    border-radius: 10px;
+  }
+
+  .unlock-content {
+    position: fixed;
+    inset: 0;
+    z-index: 2500;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    overflow: hidden;
+    background-color: #fff;
+    background-image: url('@imgs/lock/bg_light.webp');
+    background-size: cover;
+    transition: transform 0.3s ease-in-out;
+  }
+
+  .dark {
+    .unlock-content {
+      background-image: url('@imgs/lock/bg_dark.webp');
+    }
+  }
+
+  @keyframes fade-in {
+    from {
+      opacity: 0;
+      transform: scale(0.9);
+    }
+
+    to {
+      opacity: 1;
+      transform: scale(1);
+    }
+  }
+
+  .animate-fade-in {
+    animation: fade-in 0.3s ease-in-out;
+  }
+
+  @keyframes shake {
+    0%,
+    100% {
+      transform: translateX(0);
+    }
+
+    10%,
+    30%,
+    50%,
+    70%,
+    90% {
+      transform: translateX(-10px);
+    }
+
+    20%,
+    40%,
+    60%,
+    80% {
+      transform: translateX(10px);
+    }
+  }
+
+  .shake-animation {
+    animation: shake 0.5s ease-in-out;
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-settings-panel/composables/useSettingsConfig.ts b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsConfig.ts
new file mode 100644
index 0000000..35e8066
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsConfig.ts
@@ -0,0 +1,248 @@
+import { computed } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { ContainerWidthEnum } from '@/enums/appEnum'
+import AppConfig from '@/config'
+import { headerBarConfig } from '@/config/modules/headerBar'
+
+/**
+ * 设置项配置选项管理
+ */
+export function useSettingsConfig() {
+  const { t } = useI18n()
+
+  // 标签页风格选项
+  const tabStyleOptions = computed(() => [
+    {
+      value: 'tab-default',
+      label: t('setting.tabStyle.default')
+    },
+    {
+      value: 'tab-card',
+      label: t('setting.tabStyle.card')
+    },
+    {
+      value: 'tab-google',
+      label: t('setting.tabStyle.google')
+    }
+  ])
+
+  // 页面切换动画选项
+  const pageTransitionOptions = computed(() => [
+    {
+      value: '',
+      label: t('setting.transition.list.none')
+    },
+    {
+      value: 'fade',
+      label: t('setting.transition.list.fade')
+    },
+    {
+      value: 'slide-left',
+      label: t('setting.transition.list.slideLeft')
+    },
+    {
+      value: 'slide-bottom',
+      label: t('setting.transition.list.slideBottom')
+    },
+    {
+      value: 'slide-top',
+      label: t('setting.transition.list.slideTop')
+    }
+  ])
+
+  // 圆角大小选项
+  const customRadiusOptions = [
+    { value: '0', label: '0' },
+    { value: '0.25', label: '0.25' },
+    { value: '0.5', label: '0.5' },
+    { value: '0.75', label: '0.75' },
+    { value: '1', label: '1' }
+  ]
+
+  // 容器宽度选项
+  const containerWidthOptions = computed(() => [
+    {
+      value: ContainerWidthEnum.FULL,
+      label: t('setting.container.list[0]'),
+      icon: 'icon-park-outline:auto-width'
+    },
+    {
+      value: ContainerWidthEnum.BOXED,
+      label: t('setting.container.list[1]'),
+      icon: 'ix:width'
+    }
+  ])
+
+  // 盒子样式选项
+  const boxStyleOptions = computed(() => [
+    {
+      value: 'border-mode',
+      label: t('setting.box.list[0]'),
+      type: 'border-mode' as const
+    },
+    {
+      value: 'shadow-mode',
+      label: t('setting.box.list[1]'),
+      type: 'shadow-mode' as const
+    }
+  ])
+
+  // 从配置文件获取的选项
+  const configOptions = {
+    // 主题色彩选项
+    mainColors: AppConfig.systemMainColor,
+
+    // 主题风格选项
+    themeList: AppConfig.settingThemeList,
+
+    // 菜单布局选项
+    menuLayoutList: AppConfig.menuLayoutList
+  }
+
+  // 基础设置项配置
+  const basicSettingsConfig = computed(() => {
+    // 定义所有基础设置项
+    const allSettings = [
+      {
+        key: 'showWorkTab',
+        label: t('setting.basics.list.multiTab'),
+        type: 'switch' as const,
+        handler: 'workTab',
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'uniqueOpened',
+        label: t('setting.basics.list.accordion'),
+        type: 'switch' as const,
+        handler: 'uniqueOpened',
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'showMenuButton',
+        label: t('setting.basics.list.collapseSidebar'),
+        type: 'switch' as const,
+        handler: 'menuButton',
+        headerBarKey: 'menuButton' as const
+      },
+      {
+        key: 'showFastEnter',
+        label: t('setting.basics.list.fastEnter'),
+        type: 'switch' as const,
+        handler: 'fastEnter',
+        headerBarKey: 'fastEnter' as const
+      },
+      {
+        key: 'showRefreshButton',
+        label: t('setting.basics.list.reloadPage'),
+        type: 'switch' as const,
+        handler: 'refreshButton',
+        headerBarKey: 'refreshButton' as const
+      },
+      {
+        key: 'showCrumbs',
+        label: t('setting.basics.list.breadcrumb'),
+        type: 'switch' as const,
+        handler: 'crumbs',
+        mobileHide: true,
+        headerBarKey: 'breadcrumb' as const
+      },
+      {
+        key: 'showLanguage',
+        label: t('setting.basics.list.language'),
+        type: 'switch' as const,
+        handler: 'language',
+        headerBarKey: 'language' as const
+      },
+      {
+        key: 'showNprogress',
+        label: t('setting.basics.list.progressBar'),
+        type: 'switch' as const,
+        handler: 'nprogress',
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'colorWeak',
+        label: t('setting.basics.list.weakMode'),
+        type: 'switch' as const,
+        handler: 'colorWeak',
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'watermarkVisible',
+        label: t('setting.basics.list.watermark'),
+        type: 'switch' as const,
+        handler: 'watermark',
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'menuOpenWidth',
+        label: t('setting.basics.list.menuWidth'),
+        type: 'input-number' as const,
+        handler: 'menuOpenWidth',
+        min: 180,
+        max: 320,
+        step: 10,
+        style: { width: '120px' },
+        controlsPosition: 'right' as const,
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'tabStyle',
+        label: t('setting.basics.list.tabStyle'),
+        type: 'select' as const,
+        handler: 'tabStyle',
+        options: tabStyleOptions.value,
+        style: { width: '120px' },
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'pageTransition',
+        label: t('setting.basics.list.pageTransition'),
+        type: 'select' as const,
+        handler: 'pageTransition',
+        options: pageTransitionOptions.value,
+        style: { width: '120px' },
+        headerBarKey: null // 不依赖headerBar配置
+      },
+      {
+        key: 'customRadius',
+        label: t('setting.basics.list.borderRadius'),
+        type: 'select' as const,
+        handler: 'customRadius',
+        options: customRadiusOptions,
+        style: { width: '120px' },
+        headerBarKey: null // 不依赖headerBar配置
+      }
+    ]
+
+    // 根据 headerBarConfig 过滤设置项
+    return (
+      allSettings
+        .filter((setting) => {
+          // 如果设置项不依赖headerBar配置，则始终显示
+          if (setting.headerBarKey === null) {
+            return true
+          }
+
+          // 如果依赖headerBar配置，检查对应的功能是否启用
+          const headerBarFeature = headerBarConfig[setting.headerBarKey]
+          return headerBarFeature?.enabled !== false
+        })
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        .map(({ headerBarKey: _headerBarKey, ...setting }) => setting)
+    )
+  })
+
+  return {
+    // 选项配置
+    tabStyleOptions,
+    pageTransitionOptions,
+    customRadiusOptions,
+    containerWidthOptions,
+    boxStyleOptions,
+    configOptions,
+
+    // 设置项配置
+    basicSettingsConfig
+  }
+}
diff --git a/web/src/components/core/layouts/art-settings-panel/composables/useSettingsHandlers.ts b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsHandlers.ts
new file mode 100644
index 0000000..392c690
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsHandlers.ts
@@ -0,0 +1,167 @@
+import { useSettingStore } from '@/store/modules/setting'
+import { storeToRefs } from 'pinia'
+import type { ContainerWidthEnum } from '@/enums/appEnum'
+
+/**
+ * 设置项通用处理逻辑
+ */
+export function useSettingsHandlers() {
+  const settingStore = useSettingStore()
+
+  // DOM 操作相关
+  const domOperations = {
+    // 设置HTML类名
+    setHtmlClass: (className: string, add: boolean) => {
+      const el = document.getElementsByTagName('html')[0]
+      if (add) {
+        el.classList.add(className)
+      } else {
+        el.classList.remove(className)
+      }
+    },
+
+    // 设置根元素属性
+    setRootAttribute: (attribute: string, value: string) => {
+      const el = document.documentElement
+      el.setAttribute(attribute, value)
+    },
+
+    // 设置body类名
+    setBodyClass: (className: string, add: boolean) => {
+      const el = document.getElementsByTagName('body')[0]
+      if (add) {
+        el.classList.add(className)
+      } else {
+        el.classList.remove(className)
+      }
+    }
+  }
+
+  // 通用切换处理器
+  const createToggleHandler = (storeMethod: () => void, callback?: () => void) => {
+    return () => {
+      storeMethod()
+      callback?.()
+    }
+  }
+
+  // 通用值变更处理器
+  const createValueHandler = <T>(
+    storeMethod: (value: T) => void,
+    callback?: (value: T) => void
+  ) => {
+    return (value: T) => {
+      if (value !== undefined && value !== null) {
+        storeMethod(value)
+        callback?.(value)
+      }
+    }
+  }
+
+  // 基础设置处理器
+  const basicHandlers = {
+    // 工作台标签页
+    workTab: createToggleHandler(() => settingStore.setWorkTab(!settingStore.showWorkTab)),
+
+    // 菜单手风琴
+    uniqueOpened: createToggleHandler(() => settingStore.setUniqueOpened()),
+
+    // 显示菜单按钮
+    menuButton: createToggleHandler(() => settingStore.setButton()),
+
+    // 显示快速入口
+    fastEnter: createToggleHandler(() => settingStore.setFastEnter()),
+
+    // 显示刷新按钮
+    refreshButton: createToggleHandler(() => settingStore.setShowRefreshButton()),
+
+    // 显示面包屑
+    crumbs: createToggleHandler(() => settingStore.setCrumbs()),
+
+    // 显示语言切换
+    language: createToggleHandler(() => settingStore.setLanguage()),
+
+    // 显示进度条
+    nprogress: createToggleHandler(() => settingStore.setNprogress()),
+
+    // 色弱模式
+    colorWeak: createToggleHandler(
+      () => settingStore.setColorWeak(),
+      () => {
+        domOperations.setHtmlClass('color-weak', settingStore.colorWeak)
+      }
+    ),
+
+    // 水印显示
+    watermark: createToggleHandler(() =>
+      settingStore.setWatermarkVisible(!settingStore.watermarkVisible)
+    ),
+
+    // 菜单展开宽度
+    menuOpenWidth: createValueHandler<number>((width: number) =>
+      settingStore.setMenuOpenWidth(width)
+    ),
+
+    // 标签页风格
+    tabStyle: createValueHandler<string>((style: string) => settingStore.setTabStyle(style)),
+
+    // 页面切换动画
+    pageTransition: createValueHandler<string>((transition: string) =>
+      settingStore.setPageTransition(transition)
+    ),
+
+    // 圆角大小
+    customRadius: createValueHandler<string>((radius: string) =>
+      settingStore.setCustomRadius(radius)
+    )
+  }
+
+  // 盒子样式处理器
+  const boxStyleHandlers = {
+    // 设置盒子模式
+    setBoxMode: (type: 'border-mode' | 'shadow-mode') => {
+      const { boxBorderMode } = storeToRefs(settingStore)
+
+      // 防止重复设置
+      if (
+        (type === 'shadow-mode' && boxBorderMode.value === false) ||
+        (type === 'border-mode' && boxBorderMode.value === true)
+      ) {
+        return
+      }
+
+      setTimeout(() => {
+        domOperations.setRootAttribute('data-box-mode', type)
+        settingStore.setBorderMode()
+      }, 50)
+    }
+  }
+
+  // 颜色设置处理器
+  const colorHandlers = {
+    // 选择主题色
+    selectColor: (theme: string) => {
+      settingStore.setElementTheme(theme)
+      settingStore.reload()
+    }
+  }
+
+  // 容器设置处理器
+  const containerHandlers = {
+    // 设置容器宽度
+    setWidth: (type: ContainerWidthEnum) => {
+      settingStore.setContainerWidth(type)
+      settingStore.reload()
+    }
+  }
+
+  return {
+    domOperations,
+    basicHandlers,
+    boxStyleHandlers,
+    colorHandlers,
+    containerHandlers,
+    createToggleHandler,
+    createValueHandler
+  }
+}
diff --git a/web/src/components/core/layouts/art-settings-panel/composables/useSettingsPanel.ts b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsPanel.ts
new file mode 100644
index 0000000..f5e4e56
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsPanel.ts
@@ -0,0 +1,233 @@
+import { ref, computed, watch } from 'vue'
+import { useSettingStore } from '@/store/modules/setting'
+import { storeToRefs } from 'pinia'
+import { useBreakpoints } from '@vueuse/core'
+import AppConfig from '@/config'
+import { SystemThemeEnum, MenuTypeEnum } from '@/enums/appEnum'
+import { mittBus } from '@/utils/sys'
+import { StorageConfig } from '@/utils'
+import { useTheme } from '@/hooks/core/useTheme'
+import { useCeremony } from '@/hooks/core/useCeremony'
+import { useSettingsState } from './useSettingsState'
+import { useSettingsHandlers } from './useSettingsHandlers'
+
+/**
+ * 设置面板核心逻辑管理
+ */
+export function useSettingsPanel() {
+  const settingStore = useSettingStore()
+  const { systemThemeType, systemThemeMode, menuType } = storeToRefs(settingStore)
+
+  // Composables
+  const { openFestival, cleanup } = useCeremony()
+  const { setSystemTheme, setSystemAutoTheme } = useTheme()
+  const { initColorWeak } = useSettingsState()
+  const { domOperations } = useSettingsHandlers()
+
+  // 响应式状态
+  const showDrawer = ref(false)
+
+  // 使用 VueUse breakpoints 优化性能
+  const breakpoints = useBreakpoints({ tablet: 1000 })
+  const isMobile = breakpoints.smaller('tablet')
+
+  // 记录窗口宽度变化前的菜单类型
+  const getStoredDesktopMenuType = (): MenuTypeEnum | undefined => {
+    const storedMenuType = localStorage.getItem(StorageConfig.RESPONSIVE_MENU_TYPE_KEY)
+    return Object.values(MenuTypeEnum).includes(storedMenuType as MenuTypeEnum)
+      ? (storedMenuType as MenuTypeEnum)
+      : undefined
+  }
+
+  const setStoredDesktopMenuType = (type: MenuTypeEnum) => {
+    localStorage.setItem(StorageConfig.RESPONSIVE_MENU_TYPE_KEY, type)
+  }
+
+  const clearStoredDesktopMenuType = () => {
+    localStorage.removeItem(StorageConfig.RESPONSIVE_MENU_TYPE_KEY)
+  }
+
+  const storedDesktopMenuType = getStoredDesktopMenuType()
+  const beforeMenuType = ref<MenuTypeEnum | undefined>(storedDesktopMenuType)
+  const hasChangedMenu = ref(Boolean(storedDesktopMenuType))
+
+  // 计算属性
+  const systemThemeColor = computed(() => settingStore.systemThemeColor as string)
+
+  // 主题相关处理
+  const useThemeHandlers = () => {
+    // 初始化系统颜色
+    const initSystemColor = () => {
+      if (!AppConfig.systemMainColor.includes(systemThemeColor.value)) {
+        settingStore.setElementTheme(AppConfig.systemMainColor[0])
+        settingStore.reload()
+      }
+    }
+
+    // 初始化系统主题
+    const initSystemTheme = () => {
+      if (systemThemeMode.value === SystemThemeEnum.AUTO) {
+        setSystemAutoTheme()
+      } else {
+        setSystemTheme(systemThemeType.value)
+      }
+    }
+
+    // 监听系统主题变化
+    const listenerSystemTheme = () => {
+      const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
+      mediaQuery.addEventListener('change', initSystemTheme)
+      return () => {
+        mediaQuery.removeEventListener('change', initSystemTheme)
+      }
+    }
+
+    return {
+      initSystemColor,
+      initSystemTheme,
+      listenerSystemTheme
+    }
+  }
+
+  // 响应式布局处理
+  const useResponsiveLayout = () => {
+    // 使用 watch 监听断点变化，性能更优
+    const stopWatch = watch(
+      isMobile,
+      (mobile: boolean) => {
+        if (mobile) {
+          // 切换到移动端布局
+          if (!hasChangedMenu.value) {
+            beforeMenuType.value = menuType.value
+            if (menuType.value !== MenuTypeEnum.LEFT) {
+              setStoredDesktopMenuType(menuType.value)
+              useSettingsState().switchMenuLayouts(MenuTypeEnum.LEFT)
+              hasChangedMenu.value = true
+            }
+          }
+
+          settingStore.setMenuOpen(false)
+        } else {
+          // 恢复桌面端布局
+          if (hasChangedMenu.value && beforeMenuType.value) {
+            if (menuType.value === MenuTypeEnum.LEFT) {
+              useSettingsState().switchMenuLayouts(beforeMenuType.value)
+            }
+
+            clearStoredDesktopMenuType()
+            hasChangedMenu.value = false
+          }
+
+          settingStore.setMenuOpen(true)
+        }
+      },
+      { immediate: true }
+    )
+
+    return { stopWatch }
+  }
+
+  // 抽屉控制
+  const useDrawerControl = () => {
+    // 用于存储 setTimeout 的 ID，以便在需要时清除
+    let themeChangeTimer: ReturnType<typeof setTimeout> | null = null
+
+    // 打开抽屉
+    const handleOpen = () => {
+      // 清除可能存在的旧定时器
+      if (themeChangeTimer) {
+        clearTimeout(themeChangeTimer)
+      }
+      // 延迟添加 theme-change class，避免抽屉打开动画受影响
+      themeChangeTimer = setTimeout(() => {
+        domOperations.setBodyClass('theme-change', true)
+        themeChangeTimer = null
+      }, 500)
+    }
+
+    // 关闭抽屉
+    const handleClose = () => {
+      // 清除未执行的定时器，防止关闭后才添加 class
+      if (themeChangeTimer) {
+        clearTimeout(themeChangeTimer)
+        themeChangeTimer = null
+      }
+      // 立即移除 theme-change class
+      domOperations.setBodyClass('theme-change', false)
+    }
+
+    // 打开设置
+    const openSetting = () => {
+      showDrawer.value = true
+    }
+
+    // 关闭设置
+    const closeDrawer = () => {
+      showDrawer.value = false
+    }
+
+    return {
+      handleOpen,
+      handleClose,
+      openSetting,
+      closeDrawer
+    }
+  }
+
+  // Props 变化监听
+  const usePropsWatcher = (props: { open?: boolean }) => {
+    watch(
+      () => props.open,
+      (val: boolean | undefined) => {
+        if (val !== undefined) {
+          showDrawer.value = val
+        }
+      }
+    )
+  }
+
+  // 初始化设置
+  const useSettingsInitializer = () => {
+    const themeHandlers = useThemeHandlers()
+    const { openSetting } = useDrawerControl()
+    const { stopWatch } = useResponsiveLayout()
+    let themeCleanup: (() => void) | null = null
+
+    const initializeSettings = () => {
+      mittBus.on('openSetting', openSetting)
+      themeHandlers.initSystemColor()
+      themeCleanup = themeHandlers.listenerSystemTheme()
+      initColorWeak()
+
+      // 设置盒子模式
+      const boxMode = settingStore.boxBorderMode ? 'border-mode' : 'shadow-mode'
+      domOperations.setRootAttribute('data-box-mode', boxMode)
+
+      themeHandlers.initSystemTheme()
+      openFestival()
+    }
+
+    const cleanupSettings = () => {
+      stopWatch()
+      themeCleanup?.()
+      cleanup()
+    }
+
+    return {
+      initializeSettings,
+      cleanupSettings
+    }
+  }
+
+  return {
+    // 状态
+    showDrawer,
+
+    // 方法组合
+    useThemeHandlers,
+    useResponsiveLayout,
+    useDrawerControl,
+    usePropsWatcher,
+    useSettingsInitializer
+  }
+}
diff --git a/web/src/components/core/layouts/art-settings-panel/composables/useSettingsState.ts b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsState.ts
new file mode 100644
index 0000000..65352d2
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/composables/useSettingsState.ts
@@ -0,0 +1,37 @@
+import { useSettingStore } from '@/store/modules/setting'
+import { MenuThemeEnum, MenuTypeEnum } from '@/enums/appEnum'
+
+/**
+ * 设置状态管理
+ */
+export function useSettingsState() {
+  const settingStore = useSettingStore()
+
+  // 色弱模式初始化
+  const initColorWeak = () => {
+    if (settingStore.colorWeak) {
+      const el = document.getElementsByTagName('html')[0]
+      setTimeout(() => {
+        el.classList.add('color-weak')
+      }, 100)
+    }
+  }
+
+  // 菜单布局切换
+  const switchMenuLayouts = (type: MenuTypeEnum) => {
+    if (type === MenuTypeEnum.LEFT || type === MenuTypeEnum.TOP_LEFT) {
+      settingStore.setMenuOpen(true)
+    }
+    settingStore.switchMenuLayouts(type)
+    if (type === MenuTypeEnum.DUAL_MENU) {
+      settingStore.switchMenuStyles(MenuThemeEnum.DESIGN)
+      settingStore.setMenuOpen(true)
+    }
+  }
+
+  return {
+    // 方法
+    initColorWeak,
+    switchMenuLayouts
+  }
+}
diff --git a/web/src/components/core/layouts/art-settings-panel/index.vue b/web/src/components/core/layouts/art-settings-panel/index.vue
new file mode 100755
index 0000000..0cbf344
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/index.vue
@@ -0,0 +1,72 @@
+<!-- 设置面板 -->
+<template>
+  <div class="layout-settings">
+    <SettingDrawer v-model="showDrawer" @open="handleOpen" @close="handleClose">
+      <!-- 头部关闭按钮 -->
+      <SettingHeader @close="closeDrawer" />
+      <!-- 主题风格 -->
+      <ThemeSettings />
+      <!-- 菜单布局 -->
+      <MenuLayoutSettings />
+      <!-- 菜单风格 -->
+      <MenuStyleSettings />
+      <!-- 系统主题色 -->
+      <ColorSettings />
+      <!-- 盒子样式 -->
+      <BoxStyleSettings />
+      <!-- 容器宽度 -->
+      <ContainerSettings />
+      <!-- 基础配置 -->
+      <BasicSettings />
+      <!-- 操作按钮 -->
+      <SettingActions />
+    </SettingDrawer>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useSettingsPanel } from './composables/useSettingsPanel'
+
+  import SettingDrawer from './widget/SettingDrawer.vue'
+  import SettingHeader from './widget/SettingHeader.vue'
+  import ThemeSettings from './widget/ThemeSettings.vue'
+  import MenuLayoutSettings from './widget/MenuLayoutSettings.vue'
+  import MenuStyleSettings from './widget/MenuStyleSettings.vue'
+  import ColorSettings from './widget/ColorSettings.vue'
+  import BoxStyleSettings from './widget/BoxStyleSettings.vue'
+  import ContainerSettings from './widget/ContainerSettings.vue'
+  import BasicSettings from './widget/BasicSettings.vue'
+  import SettingActions from './widget/SettingActions.vue'
+
+  defineOptions({ name: 'ArtSettingsPanel' })
+
+  interface Props {
+    /** 是否打开 */
+    open?: boolean
+  }
+
+  const props = defineProps<Props>()
+
+  // 使用设置面板逻辑
+  const settingsPanel = useSettingsPanel()
+  const { showDrawer } = settingsPanel
+
+  // 获取各种处理器
+  const { handleOpen, handleClose, closeDrawer } = settingsPanel.useDrawerControl()
+  const { initializeSettings, cleanupSettings } = settingsPanel.useSettingsInitializer()
+
+  // 监听 props 变化
+  settingsPanel.usePropsWatcher(props)
+
+  onMounted(() => {
+    initializeSettings()
+  })
+
+  onUnmounted(() => {
+    cleanupSettings()
+  })
+</script>
+
+<style lang="scss">
+  @use './style';
+</style>
diff --git a/web/src/components/core/layouts/art-settings-panel/style.scss b/web/src/components/core/layouts/art-settings-panel/style.scss
new file mode 100755
index 0000000..e863074
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/style.scss
@@ -0,0 +1,92 @@
+@use '@styles/core/mixin.scss' as *;
+
+// 设置抽屉模态框样式
+.setting-modal {
+  background: transparent !important;
+
+  .el-drawer {
+    // 背景滤镜效果
+    background: rgba($color: #fff, $alpha: 50%) !important;
+    box-shadow: 0 0 30px rgb(0 0 0 / 10%) !important;
+
+    @include backdropBlur();
+
+    .setting-box-wrap {
+      display: flex;
+      flex-wrap: wrap;
+      align-items: center;
+      width: calc(100% + 15px);
+      margin-bottom: 10px;
+
+      .setting-item {
+        box-sizing: border-box;
+        width: calc(33.333% - 15px);
+        margin-right: 15px;
+        text-align: center;
+
+        .box {
+          position: relative;
+          box-sizing: border-box;
+          display: flex;
+          height: 52px;
+          overflow: hidden;
+          cursor: pointer;
+          border: 2px solid var(--default-border);
+          border-radius: 8px;
+          box-shadow: 0 0 8px 0 rgb(0 0 0 / 10%);
+          transition: box-shadow 0.1s;
+
+          &.mt-16 {
+            margin-top: 16px;
+          }
+
+          &.is-active {
+            border: 2px solid var(--theme-color);
+          }
+
+          img {
+            width: 100%;
+            height: 100%;
+          }
+        }
+
+        .name {
+          margin-top: 6px;
+          font-size: 14px;
+          text-align: center;
+        }
+      }
+    }
+  }
+
+  // 去除滚动条
+  .el-drawer__body::-webkit-scrollbar {
+    width: 0 !important;
+  }
+}
+
+.dark {
+  .setting-modal {
+    .el-drawer {
+      background: rgba($color: #000, $alpha: 50%) !important;
+
+      .setting-item {
+        .box {
+          border: 2px solid transparent;
+        }
+      }
+    }
+  }
+}
+
+// 去除火狐浏览器滚动条
+:deep(.el-drawer__body) {
+  scrollbar-width: none;
+}
+
+// 移动端隐藏
+@media screen and (width <= 800px) {
+  .mobile-hide {
+    display: none !important;
+  }
+}
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/BasicSettings.vue b/web/src/components/core/layouts/art-settings-panel/widget/BasicSettings.vue
new file mode 100644
index 0000000..b6dc9d3
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/BasicSettings.vue
@@ -0,0 +1,77 @@
+<template>
+  <div>
+    <SectionTitle :title="$t('setting.basics.title')" class="mt-10" />
+    <SettingItem
+      v-for="config in basicSettingsConfig"
+      :key="config.key"
+      :config="config"
+      :model-value="getSettingValue(config.key)"
+      @change="handleSettingChange(config.handler, $event)"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import SectionTitle from './SectionTitle.vue'
+  import SettingItem from './SettingItem.vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useSettingsConfig } from '../composables/useSettingsConfig'
+  import { useSettingsHandlers } from '../composables/useSettingsHandlers'
+  import { storeToRefs } from 'pinia'
+
+  const settingStore = useSettingStore()
+  const { basicSettingsConfig } = useSettingsConfig()
+  const { basicHandlers } = useSettingsHandlers()
+
+  // 获取store的响应式状态
+  const {
+    uniqueOpened,
+    showMenuButton,
+    showFastEnter,
+    showRefreshButton,
+    showCrumbs,
+    showWorkTab,
+    showLanguage,
+    showNprogress,
+    colorWeak,
+    watermarkVisible,
+    menuOpenWidth,
+    tabStyle,
+    pageTransition,
+    customRadius
+  } = storeToRefs(settingStore)
+
+  // 创建设置值映射
+  const settingValueMap = {
+    uniqueOpened,
+    showMenuButton,
+    showFastEnter,
+    showRefreshButton,
+    showCrumbs,
+    showWorkTab,
+    showLanguage,
+    showNprogress,
+    colorWeak,
+    watermarkVisible,
+    menuOpenWidth,
+    tabStyle,
+    pageTransition,
+    customRadius
+  }
+
+  // 获取设置值的方法
+  const getSettingValue = (key: string) => {
+    const settingRef = settingValueMap[key as keyof typeof settingValueMap]
+    return settingRef?.value ?? null
+  }
+
+  // 统一的设置变更处理
+  const handleSettingChange = (handlerName: string, value: any) => {
+    const handler = (basicHandlers as any)[handlerName]
+    if (typeof handler === 'function') {
+      handler(value)
+    } else {
+      console.warn(`Handler "${handlerName}" not found in basicHandlers`)
+    }
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/BoxStyleSettings.vue b/web/src/components/core/layouts/art-settings-panel/widget/BoxStyleSettings.vue
new file mode 100644
index 0000000..86c7a9e
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/BoxStyleSettings.vue
@@ -0,0 +1,38 @@
+<template>
+  <div>
+    <SectionTitle :title="$t('setting.box.title')" class="mt-10" />
+    <div class="box-border flex-cb p-1 mt-5 rounded-lg bg-g-200">
+      <div
+        v-for="option in boxStyleOptions"
+        :key="option.value"
+        class="w-[calc(50%-3px)] h-8.5 leading-8.5 text-sm text-center c-p select-none rounded-md transition-all duration-200"
+        :class="
+          isActive(option.type)
+            ? 'text-g-800 bg-[var(--default-box-color)] dark:!text-white dark:bg-g-300'
+            : 'hover:text-g-800 hover:bg-black/[0.04] dark:hover:bg-black/20'
+        "
+        @click="boxStyleHandlers.setBoxMode(option.type)"
+      >
+        {{ option.label }}
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import SectionTitle from './SectionTitle.vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useSettingsConfig } from '../composables/useSettingsConfig'
+  import { useSettingsHandlers } from '../composables/useSettingsHandlers'
+  import { storeToRefs } from 'pinia'
+
+  const settingStore = useSettingStore()
+  const { boxBorderMode } = storeToRefs(settingStore)
+  const { boxStyleOptions } = useSettingsConfig()
+  const { boxStyleHandlers } = useSettingsHandlers()
+
+  // 判断当前选项是否激活
+  const isActive = (type: 'border-mode' | 'shadow-mode') => {
+    return type === 'border-mode' ? boxBorderMode.value : !boxBorderMode.value
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/ColorSettings.vue b/web/src/components/core/layouts/art-settings-panel/widget/ColorSettings.vue
new file mode 100644
index 0000000..05a4b41
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/ColorSettings.vue
@@ -0,0 +1,35 @@
+<template>
+  <div>
+    <SectionTitle :title="$t('setting.color.title')" class="mt-10" />
+    <div class="-mr-4">
+      <div class="flex flex-wrap">
+        <div
+          v-for="color in configOptions.mainColors"
+          :key="color"
+          class="flex items-center justify-center size-[23px] mr-4 mb-2.5 cursor-pointer rounded-full transition-all duration-200 hover:opacity-85"
+          :style="{ background: `${color} !important` }"
+          @click="colorHandlers.selectColor(color)"
+        >
+          <ArtSvgIcon
+            icon="ri:check-fill"
+            class="text-base !text-white"
+            v-show="color === systemThemeColor"
+          />
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import SectionTitle from './SectionTitle.vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useSettingsConfig } from '../composables/useSettingsConfig'
+  import { useSettingsHandlers } from '../composables/useSettingsHandlers'
+  import { storeToRefs } from 'pinia'
+
+  const settingStore = useSettingStore()
+  const { systemThemeColor } = storeToRefs(settingStore)
+  const { configOptions } = useSettingsConfig()
+  const { colorHandlers } = useSettingsHandlers()
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/ContainerSettings.vue b/web/src/components/core/layouts/art-settings-panel/widget/ContainerSettings.vue
new file mode 100644
index 0000000..1f5be72
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/ContainerSettings.vue
@@ -0,0 +1,33 @@
+<template>
+  <div>
+    <SectionTitle :title="$t('setting.container.title')" class="mt-12.5" />
+    <div class="flex">
+      <div
+        v-for="option in containerWidthOptions"
+        :key="option.value"
+        class="flex-cc flex-1 h-16 mt-5 mr-3.5 mb-3.5 cursor-pointer !border-2 rounded-lg !text-g-800 last:mr-0"
+        :class="{
+          'border-theme [&_i]:!text-theme': containerWidth === option.value,
+          'border-full-d': containerWidth !== option.value
+        }"
+        @click="containerHandlers.setWidth(option.value)"
+      >
+        <ArtSvgIcon :icon="option.icon" class="mr-2 text-lg" />
+        <span class="text-sm">{{ option.label }}</span>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import SectionTitle from './SectionTitle.vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useSettingsConfig } from '../composables/useSettingsConfig'
+  import { useSettingsHandlers } from '../composables/useSettingsHandlers'
+  import { storeToRefs } from 'pinia'
+
+  const settingStore = useSettingStore()
+  const { containerWidth } = storeToRefs(settingStore)
+  const { containerWidthOptions } = useSettingsConfig()
+  const { containerHandlers } = useSettingsHandlers()
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/MenuLayoutSettings.vue b/web/src/components/core/layouts/art-settings-panel/widget/MenuLayoutSettings.vue
new file mode 100644
index 0000000..dbcae46
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/MenuLayoutSettings.vue
@@ -0,0 +1,31 @@
+<template>
+  <div v-if="width > 1000">
+    <SectionTitle :title="$t('setting.menuType.title')" />
+    <div class="setting-box-wrap">
+      <div
+        class="setting-item"
+        v-for="(item, index) in configOptions.menuLayoutList"
+        :key="item.value"
+        @click="switchMenuLayouts(item.value)"
+      >
+        <div class="box" :class="{ 'is-active': item.value === menuType, 'mt-16': index > 2 }">
+          <img :src="item.img" />
+        </div>
+        <p class="name">{{ $t(`setting.menuType.list[${index}]`) }}</p>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import SectionTitle from './SectionTitle.vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useSettingsConfig } from '../composables/useSettingsConfig'
+  import { useSettingsState } from '../composables/useSettingsState'
+
+  const { width } = useWindowSize()
+  const settingStore = useSettingStore()
+  const { menuType } = storeToRefs(settingStore)
+  const { configOptions } = useSettingsConfig()
+  const { switchMenuLayouts } = useSettingsState()
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/MenuStyleSettings.vue b/web/src/components/core/layouts/art-settings-panel/widget/MenuStyleSettings.vue
new file mode 100644
index 0000000..61237eb
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/MenuStyleSettings.vue
@@ -0,0 +1,44 @@
+<template>
+  <SectionTitle :title="$t('setting.menu.title')" />
+  <div class="setting-box-wrap">
+    <div
+      class="setting-item"
+      v-for="item in menuThemeList"
+      :key="item.theme"
+      @click="switchMenuStyles(item.theme)"
+    >
+      <div
+        class="box"
+        :class="{ 'is-active': item.theme === menuThemeType }"
+        :style="{
+          cursor: disabled ? 'no-drop' : 'pointer'
+        }"
+      >
+        <img :src="item.img" />
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import AppConfig from '@/config'
+  import SectionTitle from './SectionTitle.vue'
+  import { MenuTypeEnum, type MenuThemeEnum } from '@/enums/appEnum'
+  import { useSettingStore } from '@/store/modules/setting'
+
+  const menuThemeList = AppConfig.themeList
+  const settingStore = useSettingStore()
+  const { menuThemeType, menuType, isDark } = storeToRefs(settingStore)
+  const isTopMenu = computed(() => menuType.value === MenuTypeEnum.TOP)
+  const isDualMenu = computed(() => menuType.value === MenuTypeEnum.DUAL_MENU)
+
+  const disabled = computed(() => isTopMenu.value || isDualMenu.value || isDark.value)
+
+  // 菜单样式切换
+  const switchMenuStyles = (theme: MenuThemeEnum) => {
+    if (isDualMenu.value || isTopMenu.value || isDark.value) {
+      return
+    }
+    settingStore.switchMenuStyles(theme)
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/SectionTitle.vue b/web/src/components/core/layouts/art-settings-panel/widget/SectionTitle.vue
new file mode 100644
index 0000000..31ef00c
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/SectionTitle.vue
@@ -0,0 +1,17 @@
+<template>
+  <p
+    class="relative mt-7.5 mb-5.5 text-sm text-center text-g-800 before:absolute before:top-[10px] before:left-0 before:w-[50px] before:m-auto before:content-[''] before:border-b before:border-[var(--art-gray-300)] after:absolute after:top-[10px] after:right-0 after:w-[50px] after:m-auto after:content-[''] after:border-b after:border-g-300"
+    :style="style"
+  >
+    {{ title }}
+  </p>
+</template>
+
+<script setup lang="ts">
+  interface Props {
+    title: string
+    style?: Record<string, any>
+  }
+
+  defineProps<Props>()
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/SettingActions.vue b/web/src/components/core/layouts/art-settings-panel/widget/SettingActions.vue
new file mode 100644
index 0000000..7b47d1a
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/SettingActions.vue
@@ -0,0 +1,235 @@
+<!-- 设置操作按钮 -->
+<template>
+  <div
+    class="mt-10 flex gap-8 border-t border-[var(--default-border)] bg-[var(--art-bg-color)] pt-5"
+  >
+    <ElButton type="primary" class="flex-1 !h-8" @click="handleCopyConfig">
+      {{ $t('setting.actions.copyConfig') }}
+    </ElButton>
+    <ElButton type="danger" plain class="flex-1 !h-8" @click="handleResetConfig">
+      {{ $t('setting.actions.resetConfig') }}
+    </ElButton>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { nextTick } from 'vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { SETTING_DEFAULT_CONFIG } from '@/config/setting'
+  import { useClipboard } from '@vueuse/core'
+  import { useI18n } from 'vue-i18n'
+  import { MenuThemeEnum } from '@/enums/appEnum'
+  import { useTheme } from '@/hooks/core/useTheme'
+
+  defineOptions({ name: 'SettingActions' })
+
+  const { t } = useI18n()
+  const settingStore = useSettingStore()
+  const { copy, copied } = useClipboard()
+  const { switchThemeStyles } = useTheme()
+
+  /** 枚举映射表 */
+  const ENUM_MAPS = {
+    menuType: {
+      left: 'MenuTypeEnum.LEFT',
+      top: 'MenuTypeEnum.TOP',
+      'top-left': 'MenuTypeEnum.TOP_LEFT',
+      'dual-menu': 'MenuTypeEnum.DUAL_MENU'
+    },
+    systemTheme: {
+      auto: 'SystemThemeEnum.AUTO',
+      light: 'SystemThemeEnum.LIGHT',
+      dark: 'SystemThemeEnum.DARK'
+    },
+    menuTheme: {
+      design: 'MenuThemeEnum.DESIGN',
+      light: 'MenuThemeEnum.LIGHT',
+      dark: 'MenuThemeEnum.DARK'
+    },
+    containerWidth: {
+      '100%': 'ContainerWidthEnum.FULL',
+      '1200px': 'ContainerWidthEnum.BOXED'
+    }
+  } as const
+
+  /** 配置项定义 */
+  interface ConfigItem {
+    comment: string
+    key: keyof typeof settingStore
+    enumMap?: Record<string, string>
+    forceValue?: any
+  }
+
+  const CONFIG_ITEMS: ConfigItem[] = [
+    { comment: '菜单类型', key: 'menuType', enumMap: ENUM_MAPS.menuType },
+    { comment: '菜单展开宽度', key: 'menuOpenWidth' },
+    { comment: '菜单是否展开', key: 'menuOpen' },
+    { comment: '双菜单是否显示文本', key: 'dualMenuShowText' },
+    { comment: '系统主题类型', key: 'systemThemeType', enumMap: ENUM_MAPS.systemTheme },
+    { comment: '系统主题模式', key: 'systemThemeMode', enumMap: ENUM_MAPS.systemTheme },
+    { comment: '菜单风格', key: 'menuThemeType', enumMap: ENUM_MAPS.menuTheme },
+    { comment: '系统主题颜色', key: 'systemThemeColor' },
+    { comment: '是否显示菜单按钮', key: 'showMenuButton' },
+    { comment: '是否显示快速入口', key: 'showFastEnter' },
+    { comment: '是否显示刷新按钮', key: 'showRefreshButton' },
+    { comment: '是否显示面包屑', key: 'showCrumbs' },
+    { comment: '是否显示工作台标签', key: 'showWorkTab' },
+    { comment: '是否显示语言切换', key: 'showLanguage' },
+    { comment: '是否显示进度条', key: 'showNprogress' },
+    { comment: '是否显示设置引导', key: 'showSettingGuide' },
+    { comment: '是否显示节日文本', key: 'showFestivalText' },
+    { comment: '是否显示水印', key: 'watermarkVisible' },
+    { comment: '是否自动关闭', key: 'autoClose' },
+    { comment: '是否唯一展开', key: 'uniqueOpened' },
+    { comment: '是否色弱模式', key: 'colorWeak' },
+    { comment: '是否刷新', key: 'refresh' },
+    { comment: '是否加载节日烟花', key: 'holidayFireworksLoaded' },
+    { comment: '边框模式', key: 'boxBorderMode' },
+    { comment: '页面过渡效果', key: 'pageTransition' },
+    { comment: '标签页样式', key: 'tabStyle' },
+    { comment: '自定义圆角', key: 'customRadius' },
+    { comment: '容器宽度', key: 'containerWidth', enumMap: ENUM_MAPS.containerWidth },
+    { comment: '节日日期', key: 'festivalDate', forceValue: '' }
+  ]
+
+  /**
+   * 将值转换为代码字符串
+   */
+  const valueToCode = (value: any, enumMap?: Record<string, string>): string => {
+    if (value === null) return 'null'
+    if (value === undefined) return 'undefined'
+
+    // 优先查找枚举映射
+    if (enumMap && typeof value === 'string' && enumMap[value]) {
+      return enumMap[value]
+    }
+
+    // 其他类型处理
+    if (typeof value === 'string') return `'${value}'`
+    if (typeof value === 'boolean' || typeof value === 'number') return String(value)
+
+    return JSON.stringify(value)
+  }
+
+  /**
+   * 生成配置代码
+   */
+  const generateConfigCode = (): string => {
+    const lines = ['export const SETTING_DEFAULT_CONFIG = {']
+
+    CONFIG_ITEMS.forEach((item) => {
+      lines.push(`  /** ${item.comment} */`)
+      const value = item.forceValue !== undefined ? item.forceValue : settingStore[item.key]
+      lines.push(`  ${String(item.key)}: ${valueToCode(value, item.enumMap)},`)
+    })
+
+    lines.push('}')
+    return lines.join('\n')
+  }
+
+  /**
+   * 复制配置到剪贴板
+   */
+  const handleCopyConfig = async () => {
+    try {
+      const configText = generateConfigCode()
+      await copy(configText)
+
+      if (copied.value) {
+        ElMessage.success({
+          message: t('setting.actions.copySuccess'),
+          duration: 3000
+        })
+      }
+    } catch (error) {
+      console.error('复制配置失败:', error)
+      ElMessage.error(t('setting.actions.copyFailed'))
+    }
+  }
+
+  /**
+   * 切换布尔值配置（如果当前值与默认值不同）
+   */
+  const toggleIfDifferent = (
+    currentValue: boolean,
+    defaultValue: boolean,
+    toggleFn: () => void
+  ) => {
+    if (currentValue !== defaultValue) {
+      toggleFn()
+    }
+  }
+
+  /**
+   * 重置配置为默认值
+   */
+  const handleResetConfig = async () => {
+    try {
+      const config = SETTING_DEFAULT_CONFIG
+
+      // 菜单相关
+      settingStore.switchMenuLayouts(config.menuType)
+      settingStore.setMenuOpenWidth(config.menuOpenWidth)
+      settingStore.setMenuOpen(config.menuOpen)
+      settingStore.setDualMenuShowText(config.dualMenuShowText)
+
+      // 主题相关 - 使用 switchThemeStyles 确保正确处理 AUTO 模式
+      switchThemeStyles(config.systemThemeMode)
+
+      // 等待主题切换完成后，根据实际应用的主题设置菜单主题
+      await nextTick()
+      const menuTheme = settingStore.isDark ? MenuThemeEnum.DARK : config.menuThemeType
+      settingStore.switchMenuStyles(menuTheme)
+
+      settingStore.setElementTheme(config.systemThemeColor)
+
+      // 界面显示（切换类方法）
+      toggleIfDifferent(settingStore.showMenuButton, config.showMenuButton, () =>
+        settingStore.setButton()
+      )
+      toggleIfDifferent(settingStore.showFastEnter, config.showFastEnter, () =>
+        settingStore.setFastEnter()
+      )
+      toggleIfDifferent(settingStore.showRefreshButton, config.showRefreshButton, () =>
+        settingStore.setShowRefreshButton()
+      )
+      toggleIfDifferent(settingStore.showCrumbs, config.showCrumbs, () => settingStore.setCrumbs())
+      toggleIfDifferent(settingStore.showLanguage, config.showLanguage, () =>
+        settingStore.setLanguage()
+      )
+      toggleIfDifferent(settingStore.showNprogress, config.showNprogress, () =>
+        settingStore.setNprogress()
+      )
+
+      // 界面显示（直接设置类方法）
+      settingStore.setWorkTab(config.showWorkTab)
+      settingStore.setShowFestivalText(config.showFestivalText)
+      settingStore.setWatermarkVisible(config.watermarkVisible)
+
+      // 功能设置
+      toggleIfDifferent(settingStore.autoClose, config.autoClose, () => settingStore.setAutoClose())
+      toggleIfDifferent(settingStore.uniqueOpened, config.uniqueOpened, () =>
+        settingStore.setUniqueOpened()
+      )
+      toggleIfDifferent(settingStore.colorWeak, config.colorWeak, () => settingStore.setColorWeak())
+
+      // 样式设置
+      toggleIfDifferent(settingStore.boxBorderMode, config.boxBorderMode, () =>
+        settingStore.setBorderMode()
+      )
+      settingStore.setPageTransition(config.pageTransition)
+      settingStore.setTabStyle(config.tabStyle)
+      settingStore.setCustomRadius(config.customRadius)
+      settingStore.setContainerWidth(config.containerWidth)
+
+      // 节日相关
+      settingStore.setFestivalDate(config.festivalDate)
+      settingStore.setholidayFireworksLoaded(config.holidayFireworksLoaded)
+
+      location.reload()
+    } catch (error) {
+      console.error('重置配置失败:', error)
+      ElMessage.error(t('setting.actions.resetFailed'))
+    }
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/SettingDrawer.vue b/web/src/components/core/layouts/art-settings-panel/widget/SettingDrawer.vue
new file mode 100644
index 0000000..85372be
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/SettingDrawer.vue
@@ -0,0 +1,51 @@
+<template>
+  <div class="setting-drawer">
+    <ElDrawer
+      size="300px"
+      v-model="visible"
+      :lock-scroll="true"
+      :with-header="false"
+      :before-close="handleClose"
+      :destroy-on-close="false"
+      modal-class="setting-modal"
+      @open="handleOpen"
+      @close="handleDrawerClose"
+    >
+      <div class="drawer-con">
+        <slot />
+      </div>
+    </ElDrawer>
+  </div>
+</template>
+
+<script setup lang="ts">
+  interface Props {
+    modelValue: boolean
+  }
+
+  interface Emits {
+    (e: 'update:modelValue', value: boolean): void
+    (e: 'open'): void
+    (e: 'close'): void
+  }
+
+  const props = defineProps<Props>()
+  const emit = defineEmits<Emits>()
+
+  const visible = computed({
+    get: () => props.modelValue,
+    set: (value: boolean) => emit('update:modelValue', value)
+  })
+
+  const handleOpen = () => {
+    emit('open')
+  }
+
+  const handleDrawerClose = () => {
+    emit('close')
+  }
+
+  const handleClose = () => {
+    visible.value = false
+  }
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/SettingHeader.vue b/web/src/components/core/layouts/art-settings-panel/widget/SettingHeader.vue
new file mode 100644
index 0000000..e3ead9e
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/SettingHeader.vue
@@ -0,0 +1,18 @@
+<template>
+  <div>
+    <div class="flex justify-end">
+      <div
+        @click="$emit('close')"
+        class="flex-cc c-p size-7.5 !transition-all duration-200 rounded hover:bg-g-300/80"
+      >
+        <ArtSvgIcon icon="ri:close-fill" class="block text-xl text-g-600" />
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineEmits<{
+    close: []
+  }>()
+</script>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue b/web/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue
new file mode 100644
index 0000000..5721027
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue
@@ -0,0 +1,101 @@
+<template>
+  <div class="flex-cb mb-4 last:mb-2" :class="{ 'mobile-hide': config.mobileHide }">
+    <span class="text-sm">{{ config.label }}</span>
+
+    <!-- 开关类型 -->
+    <ElSwitch v-if="config.type === 'switch'" :model-value="modelValue" @change="handleChange" />
+
+    <!-- 数字输入类型 -->
+    <ElInputNumber
+      v-else-if="config.type === 'input-number'"
+      :model-value="modelValue"
+      :min="config.min"
+      :max="config.max"
+      :step="config.step"
+      :style="config.style"
+      :controls-position="config.controlsPosition"
+      @change="handleChange"
+    />
+
+    <!-- 选择器类型 -->
+    <ElSelect
+      v-else-if="config.type === 'select'"
+      :model-value="modelValue"
+      :style="config.style"
+      @change="handleChange"
+    >
+      <ElOption
+        v-for="option in normalizedOptions"
+        :key="option.value"
+        :label="option.label"
+        :value="option.value"
+      />
+    </ElSelect>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import type { ComputedRef } from 'vue'
+
+  interface SettingItemConfig {
+    key: string
+    label: string
+    type: 'switch' | 'input-number' | 'select'
+    handler: string
+    mobileHide?: boolean
+    min?: number
+    max?: number
+    step?: number
+    style?: Record<string, string>
+    controlsPosition?: '' | 'right'
+    options?:
+      | Array<{ value: any; label: string }>
+      | ComputedRef<Array<{ value: any; label: string }>>
+  }
+
+  interface Props {
+    config: SettingItemConfig
+    modelValue: any
+  }
+
+  interface Emits {
+    (e: 'change', value: any): void
+  }
+
+  const props = defineProps<Props>()
+  const emit = defineEmits<Emits>()
+
+  // 标准化选项，处理computed和普通数组
+  const normalizedOptions = computed(() => {
+    if (!props.config.options) return []
+
+    try {
+      // 如果是 ComputedRef，则返回其值
+      if (typeof props.config.options === 'object' && 'value' in props.config.options) {
+        return props.config.options.value || []
+      }
+
+      // 如果是普通数组，直接返回
+      return Array.isArray(props.config.options) ? props.config.options : []
+    } catch (error) {
+      console.warn('Error processing options for config:', props.config.key, error)
+      return []
+    }
+  })
+
+  const handleChange = (value: any) => {
+    try {
+      emit('change', value)
+    } catch (error) {
+      console.error('Error handling change for config:', props.config.key, error)
+    }
+  }
+</script>
+
+<style lang="scss" scoped>
+  @media screen and (width <= 768px) {
+    .mobile-hide {
+      display: none !important;
+    }
+  }
+</style>
diff --git a/web/src/components/core/layouts/art-settings-panel/widget/ThemeSettings.vue b/web/src/components/core/layouts/art-settings-panel/widget/ThemeSettings.vue
new file mode 100644
index 0000000..4b46fcd
--- /dev/null
+++ b/web/src/components/core/layouts/art-settings-panel/widget/ThemeSettings.vue
@@ -0,0 +1,28 @@
+<template>
+  <SectionTitle :title="$t('setting.theme.title')" />
+  <div class="setting-box-wrap">
+    <div
+      class="setting-item"
+      v-for="(item, index) in configOptions.themeList"
+      :key="item.theme"
+      @click="switchThemeStyles(item.theme)"
+    >
+      <div class="box" :class="{ 'is-active': item.theme === systemThemeMode }">
+        <img :src="item.img" />
+      </div>
+      <p class="name">{{ $t(`setting.theme.list[${index}]`) }}</p>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import SectionTitle from './SectionTitle.vue'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useSettingsConfig } from '../composables/useSettingsConfig'
+  import { useTheme } from '@/hooks/core/useTheme'
+
+  const settingStore = useSettingStore()
+  const { systemThemeMode } = storeToRefs(settingStore)
+  const { configOptions } = useSettingsConfig()
+  const { switchThemeStyles } = useTheme()
+</script>
diff --git a/web/src/components/core/layouts/art-work-tab/index.vue b/web/src/components/core/layouts/art-work-tab/index.vue
new file mode 100755
index 0000000..152ff63
--- /dev/null
+++ b/web/src/components/core/layouts/art-work-tab/index.vue
@@ -0,0 +1,584 @@
+<!-- 标签页 -->
+<template>
+  <div
+    v-if="showWorkTab"
+    class="box-border flex-b w-full px-5 mb-3 select-none max-sm:px-[15px]"
+    :class="[
+      tabStyle === 'tab-card' ? 'py-1 border-b border-[var(--art-card-border)]' : '',
+      tabStyle === 'tab-google' ? 'pt-1 pb-0 border-b border-[var(--art-card-border)]' : ''
+    ]"
+  >
+    <div class="w-full overflow-hidden" ref="scrollRef">
+      <ul
+        class="float-left whitespace-nowrap !bg-transparent flex"
+        :class="[tabStyle === 'tab-google' ? 'pl-1' : '']"
+        ref="tabsRef"
+        :style="{
+          transform: `translateX(${scrollState.translateX}px)`,
+          transition: `${scrollState.transition}`
+        }"
+      >
+        <li
+          class="art-card-xs inline-flex flex-cc h-8 mr-1.5 text-xs c-p hover:text-theme group"
+          :class="[
+            item.path === activeTab ? 'activ-tab !text-theme' : 'text-g-600 dark:text-g-800',
+            tabStyle === 'tab-google' ? 'google-tab relative !h-8 !leading-8 !border-none' : ''
+          ]"
+          :style="{
+            padding: item.fixedTab ? '0 10px' : '0 8px 0 12px',
+            borderRadius:
+              tabStyle === 'tab-google'
+                ? 'calc(var(--custom-radius) / 2.5 + 4px) !important'
+                : 'calc(var(--custom-radius) / 2.5 + 2px) !important'
+          }"
+          v-for="(item, index) in list"
+          :key="item.path"
+          :ref="item.path"
+          :id="`scroll-li-${index}`"
+          @click="clickTab(item)"
+          @contextmenu.prevent="(e: MouseEvent) => showMenu(e, item.path)"
+        >
+          <ArtSvgIcon
+            v-show="item.icon"
+            :icon="item.icon"
+            class="text-base mr-1 group-hover:text-theme"
+            :class="item.path === activeTab ? 'text-theme' : 'text-g-600'"
+          />
+          {{ item.customTitle || formatMenuTitle(item.title) }}
+          <span
+            v-if="list.length > 1 && !item.fixedTab"
+            class="inline-flex flex-cc relative ml-0.5 p-1 rounded-full tad-200 hover:bg-g-200"
+            @click.stop="closeWorktab('current', item.path)"
+          >
+            <ArtSvgIcon icon="ri:close-large-fill" class="text-[10px] text-g-600" />
+          </span>
+          <div
+            v-if="tabStyle === 'tab-google'"
+            class="line absolute top-0 bottom-0 left-0 w-px h-4 my-auto bg-g-400 transition-opacity duration-150"
+          />
+        </li>
+      </ul>
+    </div>
+
+    <div class="flex">
+      <div
+        class="flex-cc art-card-xs relative top-0 size-8 leading-8 text-center c-p tad-200 hover:!bg-hover-color"
+        :style="{
+          borderRadius: 'calc(var(--custom-radius) / 2.5 + 0px)',
+          marginTop: tabStyle === 'tab-google' ? '-2px' : ''
+        }"
+        @click="(e: MouseEvent) => showMenu(e, activeTab)"
+      >
+        <ArtSvgIcon icon="iconamoon:arrow-down-2-thin" class="text-2xl text-g-700" />
+      </div>
+    </div>
+
+    <ArtMenuRight
+      ref="menuRef"
+      :menu-items="menuItems"
+      :menu-width="140"
+      :border-radius="10"
+      @select="handleSelect"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { computed, onMounted, ref, watch, nextTick, onUnmounted } from 'vue'
+  import { LocationQueryRaw, useRoute, useRouter } from 'vue-router'
+  import { useI18n } from 'vue-i18n'
+  import { storeToRefs } from 'pinia'
+
+  import { useWorktabStore } from '@/store/modules/worktab'
+  import { useUserStore } from '@/store/modules/user'
+  import { formatMenuTitle } from '@/utils/router'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { MenuItemType } from '../../others/art-menu-right/index.vue'
+  import { useCommon } from '@/hooks/core/useCommon'
+  import { WorkTab } from '@/types'
+
+  defineOptions({ name: 'ArtWorkTab' })
+
+  // 类型定义
+  interface ScrollState {
+    translateX: number
+    transition: string
+  }
+
+  interface TouchState {
+    startX: number
+    currentX: number
+  }
+
+  type TabCloseType = 'current' | 'left' | 'right' | 'other' | 'all'
+
+  // 基础设置
+  const { t } = useI18n()
+  const store = useWorktabStore()
+  const userStore = useUserStore()
+  const route = useRoute()
+  const router = useRouter()
+  const { currentRoute } = router
+  const settingStore = useSettingStore()
+  const { tabStyle, showWorkTab } = storeToRefs(settingStore)
+
+  // DOM 引用
+  const scrollRef = ref<HTMLElement | null>(null)
+  const tabsRef = ref<HTMLElement | null>(null)
+  const menuRef = ref()
+
+  // 状态管理
+  const scrollState = ref<ScrollState>({
+    translateX: 0,
+    transition: ''
+  })
+
+  const touchState = ref<TouchState>({
+    startX: 0,
+    currentX: 0
+  })
+
+  const clickedPath = ref('')
+
+  // 计算属性
+  const list = computed(() => store.opened)
+  const activeTab = computed(() => currentRoute.value.path)
+  const activeTabIndex = computed(() => list.value.findIndex((tab) => tab.path === activeTab.value))
+
+  // 右键菜单逻辑
+  const useContextMenu = () => {
+    const getClickedTabInfo = () => {
+      const clickedIndex = list.value.findIndex((tab) => tab.path === clickedPath.value)
+      const currentTab = list.value[clickedIndex]
+
+      return {
+        clickedIndex,
+        currentTab,
+        isLastTab: clickedIndex === list.value.length - 1,
+        isOneTab: list.value.length === 1,
+        isCurrentTab: clickedPath.value === activeTab.value
+      }
+    }
+
+    // 检查标签页是否固定
+    const checkTabsFixedStatus = (clickedIndex: number) => {
+      const leftTabs = list.value.slice(0, clickedIndex)
+      const rightTabs = list.value.slice(clickedIndex + 1)
+      const otherTabs = list.value.filter((_, index) => index !== clickedIndex)
+
+      return {
+        areAllLeftTabsFixed: leftTabs.length > 0 && leftTabs.every((tab) => tab.fixedTab),
+        areAllRightTabsFixed: rightTabs.length > 0 && rightTabs.every((tab) => tab.fixedTab),
+        areAllOtherTabsFixed: otherTabs.length > 0 && otherTabs.every((tab) => tab.fixedTab),
+        areAllTabsFixed: list.value.every((tab) => tab.fixedTab)
+      }
+    }
+
+    // 右键菜单选项
+    const menuItems = computed(() => {
+      const { clickedIndex, currentTab, isLastTab, isOneTab, isCurrentTab } = getClickedTabInfo()
+      const fixedStatus = checkTabsFixedStatus(clickedIndex)
+
+      return [
+        {
+          key: 'refresh',
+          label: t('worktab.btn.refresh'),
+          icon: 'ri:refresh-line',
+          disabled: !isCurrentTab
+        },
+        {
+          key: 'fixed',
+          label: currentTab?.fixedTab ? t('worktab.btn.unfixed') : t('worktab.btn.fixed'),
+          icon: 'ri:pushpin-2-line',
+          disabled: false,
+          showLine: true
+        },
+        {
+          key: 'left',
+          label: t('worktab.btn.closeLeft'),
+          icon: 'ri:arrow-left-s-line',
+          disabled: clickedIndex === 0 || fixedStatus.areAllLeftTabsFixed
+        },
+        {
+          key: 'right',
+          label: t('worktab.btn.closeRight'),
+          icon: 'ri:arrow-right-s-line',
+          disabled: isLastTab || fixedStatus.areAllRightTabsFixed
+        },
+        {
+          key: 'other',
+          label: t('worktab.btn.closeOther'),
+          icon: 'ri:close-fill',
+          disabled: isOneTab || fixedStatus.areAllOtherTabsFixed
+        },
+        {
+          key: 'all',
+          label: t('worktab.btn.closeAll'),
+          icon: 'ri:close-circle-line',
+          disabled: isOneTab || fixedStatus.areAllTabsFixed
+        }
+      ]
+    })
+
+    return { menuItems }
+  }
+
+  // 滚动逻辑
+  const useScrolling = () => {
+    const setTransition = () => {
+      scrollState.value.transition = 'transform 0.5s cubic-bezier(0.15, 0, 0.15, 1)'
+      setTimeout(() => {
+        scrollState.value.transition = ''
+      }, 250)
+    }
+
+    const getCurrentTabElement = (): HTMLElement | null => {
+      return document.getElementById(`scroll-li-${activeTabIndex.value}`)
+    }
+
+    const calculateScrollPosition = () => {
+      if (!scrollRef.value || !tabsRef.value) return
+
+      const scrollWidth = scrollRef.value.offsetWidth
+      const ulWidth = tabsRef.value.offsetWidth
+      const curTabEl = getCurrentTabElement()
+
+      if (!curTabEl) return
+
+      const { offsetLeft, clientWidth } = curTabEl
+      const curTabRight = offsetLeft + clientWidth
+      const targetLeft = scrollWidth - curTabRight
+
+      return {
+        scrollWidth,
+        ulWidth,
+        offsetLeft,
+        clientWidth,
+        curTabRight,
+        targetLeft
+      }
+    }
+
+    const autoPositionTab = () => {
+      const positions = calculateScrollPosition()
+      if (!positions) return
+
+      const { scrollWidth, ulWidth, offsetLeft, curTabRight, targetLeft } = positions
+
+      if (
+        (offsetLeft > Math.abs(scrollState.value.translateX) && curTabRight <= scrollWidth) ||
+        (scrollState.value.translateX < targetLeft && targetLeft < 0)
+      ) {
+        return
+      }
+
+      requestAnimationFrame(() => {
+        if (curTabRight > scrollWidth) {
+          scrollState.value.translateX = Math.max(targetLeft - 6, scrollWidth - ulWidth)
+        } else if (offsetLeft < Math.abs(scrollState.value.translateX)) {
+          scrollState.value.translateX = -offsetLeft
+        }
+      })
+    }
+
+    const adjustPositionAfterClose = () => {
+      const positions = calculateScrollPosition()
+      if (!positions) return
+
+      const { scrollWidth, ulWidth, offsetLeft, clientWidth } = positions
+      const curTabLeft = offsetLeft + clientWidth
+
+      requestAnimationFrame(() => {
+        scrollState.value.translateX = curTabLeft > scrollWidth ? scrollWidth - ulWidth : 0
+      })
+    }
+
+    return {
+      setTransition,
+      autoPositionTab,
+      adjustPositionAfterClose
+    }
+  }
+
+  // 事件处理逻辑
+  const useEventHandlers = () => {
+    const { setTransition, adjustPositionAfterClose } = useScrolling()
+
+    const handleWheelScroll = (event: WheelEvent) => {
+      if (!scrollRef.value || !tabsRef.value) return
+
+      event.preventDefault()
+
+      if (tabsRef.value.offsetWidth <= scrollRef.value.offsetWidth) return
+
+      const xMax = 0
+      const xMin = scrollRef.value.offsetWidth - tabsRef.value.offsetWidth
+      const delta = Math.abs(event.deltaX) > Math.abs(event.deltaY) ? event.deltaX : event.deltaY
+
+      scrollState.value.translateX = Math.min(
+        Math.max(scrollState.value.translateX - delta, xMin),
+        xMax
+      )
+    }
+
+    const handleTouchStart = (event: TouchEvent) => {
+      touchState.value.startX = event.touches[0].clientX
+    }
+
+    const handleTouchMove = (event: TouchEvent) => {
+      if (!scrollRef.value || !tabsRef.value) return
+
+      touchState.value.currentX = event.touches[0].clientX
+      const deltaX = touchState.value.currentX - touchState.value.startX
+      const xMin = scrollRef.value.offsetWidth - tabsRef.value.offsetWidth
+
+      scrollState.value.translateX = Math.min(
+        Math.max(scrollState.value.translateX + deltaX, xMin),
+        0
+      )
+      touchState.value.startX = touchState.value.currentX
+    }
+
+    const handleTouchEnd = () => {
+      setTransition()
+    }
+
+    const setupEventListeners = () => {
+      if (tabsRef.value) {
+        tabsRef.value.addEventListener('wheel', handleWheelScroll, { passive: false })
+        tabsRef.value.addEventListener('touchstart', handleTouchStart, { passive: true })
+        tabsRef.value.addEventListener('touchmove', handleTouchMove, { passive: true })
+        tabsRef.value.addEventListener('touchend', handleTouchEnd, { passive: true })
+      }
+    }
+
+    const cleanupEventListeners = () => {
+      if (tabsRef.value) {
+        tabsRef.value.removeEventListener('wheel', handleWheelScroll)
+        tabsRef.value.removeEventListener('touchstart', handleTouchStart)
+        tabsRef.value.removeEventListener('touchmove', handleTouchMove)
+        tabsRef.value.removeEventListener('touchend', handleTouchEnd)
+      }
+    }
+
+    return {
+      setupEventListeners,
+      cleanupEventListeners,
+      adjustPositionAfterClose
+    }
+  }
+
+  // 标签页操作逻辑
+  const useTabOperations = (adjustPositionAfterClose: () => void) => {
+    const clickTab = (item: WorkTab) => {
+      router.push({
+        path: item.path,
+        query: item.query as LocationQueryRaw
+      })
+    }
+
+    const closeWorktab = (type: TabCloseType, tabPath: string) => {
+      const path = typeof tabPath === 'string' ? tabPath : route.path
+
+      const closeActions = {
+        current: () => store.removeTab(path),
+        left: () => store.removeLeft(path),
+        right: () => store.removeRight(path),
+        other: () => store.removeOthers(path),
+        all: () => store.removeAll()
+      }
+
+      closeActions[type]?.()
+
+      setTimeout(() => {
+        adjustPositionAfterClose()
+      }, 100)
+    }
+
+    const showMenu = (e: MouseEvent, path?: string) => {
+      clickedPath.value = path || ''
+      menuRef.value?.show(e)
+      e.preventDefault()
+      e.stopPropagation()
+    }
+
+    const handleSelect = (item: MenuItemType) => {
+      const { key } = item
+
+      if (key === 'refresh') {
+        useCommon().refresh()
+        return
+      }
+
+      if (key === 'fixed') {
+        useWorktabStore().toggleFixedTab(clickedPath.value)
+        return
+      }
+
+      const activeIndex = list.value.findIndex((tab) => tab.path === activeTab.value)
+      const clickedIndex = list.value.findIndex((tab) => tab.path === clickedPath.value)
+
+      const navigationRules = {
+        left: activeIndex < clickedIndex,
+        right: activeIndex > clickedIndex,
+        other: true
+      } as const
+
+      const shouldNavigate = navigationRules[key as keyof typeof navigationRules]
+
+      if (shouldNavigate) {
+        router.push(clickedPath.value)
+      }
+
+      closeWorktab(key as TabCloseType, clickedPath.value)
+    }
+
+    return {
+      clickTab,
+      closeWorktab,
+      showMenu,
+      handleSelect
+    }
+  }
+
+  // 组合所有逻辑
+  const { menuItems } = useContextMenu()
+  const { setTransition, autoPositionTab } = useScrolling()
+  const { setupEventListeners, cleanupEventListeners, adjustPositionAfterClose } =
+    useEventHandlers()
+  const { clickTab, closeWorktab, showMenu, handleSelect } =
+    useTabOperations(adjustPositionAfterClose)
+
+  // 生命周期
+  onMounted(() => {
+    setupEventListeners()
+    autoPositionTab()
+  })
+
+  onUnmounted(() => {
+    cleanupEventListeners()
+  })
+
+  // 监听器
+  watch(
+    () => currentRoute.value,
+    () => {
+      setTransition()
+      autoPositionTab()
+    }
+  )
+
+  watch(
+    () => userStore.language,
+    () => {
+      scrollState.value.translateX = 0
+      nextTick(() => {
+        autoPositionTab()
+      })
+    }
+  )
+</script>
+
+<style scoped>
+  .google-tab.activ-tab {
+    color: var(--theme-color) !important;
+    background-color: var(--el-color-primary-light-9) !important;
+    border-bottom: 0 !important;
+    border-bottom-right-radius: 0 !important;
+    border-bottom-left-radius: 0 !important;
+  }
+
+  .google-tab.activ-tab::before,
+  .google-tab.activ-tab::after {
+    position: absolute;
+    bottom: 0;
+    width: 20px;
+    height: 20px;
+    content: '';
+    border-radius: 50%;
+    box-shadow: 0 0 0 30px var(--el-color-primary-light-9);
+  }
+
+  .google-tab.activ-tab::before {
+    left: -20px;
+    clip-path: inset(50% -10px 0 50%);
+  }
+
+  .google-tab.activ-tab::after {
+    right: -20px;
+    clip-path: inset(50% 50% 0 -10px);
+  }
+
+  .dark .google-tab.activ-tab {
+    color: var(--art-gray-800) !important;
+    background-color: var(--art-hover-color) !important;
+  }
+
+  .dark .google-tab.activ-tab::before,
+  .dark .google-tab.activ-tab::after {
+    box-shadow: 0 0 0 30px var(--art-hover-color);
+  }
+
+  .google-tab:not(.activ-tab):hover {
+    box-sizing: border-box;
+    color: var(--art-gray-600) !important;
+    background-color: var(--art-gray-200) !important;
+    border-bottom: 1px solid var(--default-box-color) !important;
+    border-radius: calc(var(--custom-radius) / 2.5 + 4px) !important;
+  }
+
+  .dark .google-tab:not(.activ-tab):hover {
+    background-color: var(--art-hover-color) !important;
+  }
+
+  .google-tab:hover .line,
+  .google-tab.activ-tab .line,
+  .google-tab:first-child .line {
+    opacity: 0;
+  }
+
+  .google-tab:hover + .google-tab .line,
+  .google-tab.activ-tab + .google-tab .line {
+    opacity: 0;
+  }
+
+  .google-tab::before,
+  .google-tab::after {
+    position: absolute;
+    bottom: 0;
+    width: 20px;
+    height: 20px;
+    content: '';
+    border-radius: 50%;
+    box-shadow: 0 0 0 30px transparent;
+  }
+
+  .google-tab::before {
+    left: -20px;
+    clip-path: inset(50% -10px 0 50%);
+  }
+
+  .google-tab::after {
+    right: -20px;
+    clip-path: inset(50% 50% 0 -10px);
+  }
+
+  .google-tab i:hover {
+    color: var(--art-gray-700);
+    background: var(--art-gray-300);
+  }
+
+  @media only screen and (width <= 768px) {
+    .box-border.flex.justify-between {
+      padding-right: 0.625rem;
+      padding-left: 0.625rem;
+    }
+  }
+
+  @media only screen and (width <= 640px) {
+    .box-border.flex.justify-between {
+      padding-right: 0.9375rem;
+      padding-left: 0.9375rem;
+    }
+  }
+</style>
diff --git a/web/src/components/core/media/art-cutter-img/index.vue b/web/src/components/core/media/art-cutter-img/index.vue
new file mode 100644
index 0000000..191ceed
--- /dev/null
+++ b/web/src/components/core/media/art-cutter-img/index.vue
@@ -0,0 +1,350 @@
+<!-- 图片裁剪组件 github: https://github.com/acccccccb/vue-img-cutter/tree/master -->
+<template>
+  <div class="cutter-container">
+    <div class="cutter-component">
+      <div class="title">{{ title }}</div>
+      <ImgCutter
+        ref="imgCutterModal"
+        @cutDown="cutDownImg"
+        @onPrintImg="cutterPrintImg"
+        @onImageLoadComplete="handleImageLoadComplete"
+        @onImageLoadError="handleImageLoadError"
+        @onClearAll="handleClearAll"
+        v-bind="cutterProps"
+        class="img-cutter"
+      >
+        <template #choose>
+          <ElButton type="primary" plain v-ripple>选择图片</ElButton>
+        </template>
+        <template #cancel>
+          <ElButton type="danger" plain v-ripple>清除</ElButton>
+        </template>
+        <template #confirm>
+          <!-- <ElButton type="primary" style="margin-left: 10px">确定</ElButton> -->
+          <div></div>
+        </template>
+      </ImgCutter>
+    </div>
+
+    <div v-if="showPreview" class="preview-container">
+      <div class="title">{{ previewTitle }}</div>
+      <div
+        class="preview-box"
+        :style="{
+          width: `${cutterProps.cutWidth}px`,
+          height: `${cutterProps.cutHeight}px`
+        }"
+      >
+        <img class="preview-img" :src="temImgPath" alt="预览图" v-if="temImgPath" />
+      </div>
+      <ElButton class="download-btn" @click="downloadImg" :disabled="!temImgPath" v-ripple
+        >下载图片</ElButton
+      >
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import ImgCutter from 'vue-img-cutter'
+
+  defineOptions({ name: 'ArtCutterImg' })
+
+  interface CutterProps {
+    // 基础配置
+    /** 是否模态框 */
+    isModal?: boolean
+    /** 是否显示工具栏 */
+    tool?: boolean
+    /** 工具栏背景色 */
+    toolBgc?: string
+    /** 标题 */
+    title?: string
+    /** 预览标题 */
+    previewTitle?: string
+    /** 是否显示预览 */
+    showPreview?: boolean
+
+    // 尺寸相关
+    /** 容器宽度 */
+    boxWidth?: number
+    /** 容器高度 */
+    boxHeight?: number
+    /** 裁剪宽度 */
+    cutWidth?: number
+    /** 裁剪高度 */
+    cutHeight?: number
+    /** 是否允许大小调整 */
+    sizeChange?: boolean
+
+    // 移动和缩放
+    /** 是否允许移动 */
+    moveAble?: boolean
+    /** 是否允许图片移动 */
+    imgMove?: boolean
+    /** 是否允许缩放 */
+    scaleAble?: boolean
+
+    // 图片相关
+    /** 是否显示原始图片 */
+    originalGraph?: boolean
+    /** 是否允许跨域 */
+    crossOrigin?: boolean
+    /** 文件类型 */
+    fileType?: 'png' | 'jpeg' | 'webp'
+    /** 质量 */
+    quality?: number
+
+    // 水印
+    /** 水印文本 */
+    watermarkText?: string
+    /** 水印字体大小 */
+    watermarkFontSize?: number
+    /** 水印颜色 */
+    watermarkColor?: string
+
+    // 其他功能
+    /** 是否保存裁剪位置 */
+    saveCutPosition?: boolean
+    /** 是否预览模式 */
+    previewMode?: boolean
+
+    // 输入图片
+    imgUrl?: string
+  }
+
+  interface CutterResult {
+    fileName: string
+    file: File
+    blob: Blob
+    dataURL: string
+  }
+
+  const props = withDefaults(defineProps<CutterProps>(), {
+    // 基础配置默认值
+    isModal: false,
+    tool: true,
+    toolBgc: '#fff',
+    title: '',
+    previewTitle: '',
+    showPreview: true,
+
+    // 尺寸相关默认值
+    boxWidth: 700,
+    boxHeight: 458,
+    cutWidth: 470,
+    cutHeight: 270,
+    sizeChange: true,
+
+    // 移动和缩放默认值
+    moveAble: true,
+    imgMove: true,
+    scaleAble: true,
+
+    // 图片相关默认值
+    originalGraph: true,
+    crossOrigin: true,
+    fileType: 'png',
+    quality: 0.9,
+
+    // 水印默认值
+    watermarkText: '',
+    watermarkFontSize: 20,
+    watermarkColor: '#ffffff',
+
+    // 其他功能默认值
+    saveCutPosition: true,
+    previewMode: true
+  })
+
+  const emit = defineEmits(['update:imgUrl', 'error', 'imageLoadComplete', 'imageLoadError'])
+
+  const temImgPath = ref('')
+  const imgCutterModal = ref()
+
+  // 计算属性：整合所有ImgCutter的props
+  const cutterProps = computed(() => ({
+    ...props,
+    WatermarkText: props.watermarkText,
+    WatermarkFontSize: props.watermarkFontSize,
+    WatermarkColor: props.watermarkColor
+  }))
+
+  // 图片预加载
+  function preloadImage(url: string): Promise<void> {
+    return new Promise((resolve, reject) => {
+      const img = new Image()
+      img.crossOrigin = 'anonymous'
+      img.onload = () => resolve()
+      img.onerror = reject
+      img.src = url
+    })
+  }
+
+  // 初始化裁剪器
+  async function initImgCutter() {
+    if (props.imgUrl) {
+      try {
+        await preloadImage(props.imgUrl)
+        imgCutterModal.value?.handleOpen({
+          name: '封面图片',
+          src: props.imgUrl
+        })
+      } catch (error) {
+        emit('error', error)
+        console.error('图片加载失败:', error)
+      }
+    }
+  }
+
+  // 生命周期钩子
+  onMounted(() => {
+    if (props.imgUrl) {
+      temImgPath.value = props.imgUrl
+      initImgCutter()
+    }
+  })
+
+  // 监听图片URL变化
+  watch(
+    () => props.imgUrl,
+    (newVal) => {
+      if (newVal) {
+        temImgPath.value = newVal
+        initImgCutter()
+      }
+    }
+  )
+
+  // 实时预览
+  function cutterPrintImg(result: { dataURL: string }) {
+    temImgPath.value = result.dataURL
+  }
+
+  // 裁剪完成
+  function cutDownImg(result: CutterResult) {
+    emit('update:imgUrl', result.dataURL)
+  }
+
+  // 图片加载完成
+  function handleImageLoadComplete(result: any) {
+    emit('imageLoadComplete', result)
+  }
+
+  // 图片加载失败
+  function handleImageLoadError(error: any) {
+    emit('error', error)
+    emit('imageLoadError', error)
+  }
+
+  // 清除所有
+  function handleClearAll() {
+    temImgPath.value = ''
+  }
+
+  // 下载图片
+  function downloadImg() {
+    console.log('下载图片')
+    const a = document.createElement('a')
+    a.href = temImgPath.value
+    a.download = 'image.png'
+    a.click()
+  }
+</script>
+
+<style lang="scss" scoped>
+  .cutter-container {
+    display: flex;
+    flex-flow: row wrap;
+
+    .title {
+      padding-bottom: 10px;
+      font-size: 18px;
+      font-weight: 500;
+    }
+
+    .cutter-component {
+      margin-right: 30px;
+    }
+
+    .preview-container {
+      .preview-box {
+        background-color: var(--art-active-color) !important;
+
+        .preview-img {
+          width: 100%;
+          height: 100%;
+          object-fit: contain;
+        }
+      }
+
+      .download-btn {
+        display: block;
+        margin: 20px auto;
+      }
+    }
+
+    :deep(.toolBoxControl) {
+      z-index: 100;
+    }
+
+    :deep(.dockMain) {
+      right: 0;
+      bottom: -40px;
+      left: 0;
+      z-index: 10;
+      padding: 0;
+      background-color: transparent !important;
+      opacity: 1;
+    }
+
+    :deep(.copyright) {
+      display: none !important;
+    }
+
+    :deep(.i-dialog-footer) {
+      margin-top: 60px !important;
+    }
+
+    :deep(.dockBtn) {
+      height: 26px;
+      padding: 0 10px;
+      font-size: 12px;
+      line-height: 26px;
+      color: var(--el-color-primary) !important;
+      background-color: var(--el-color-primary-light-9) !important;
+      border: 1px solid var(--el-color-primary-light-4) !important;
+    }
+
+    :deep(.dockBtnScrollBar) {
+      margin: 0 10px 0 6px;
+      background-color: var(--el-color-primary-light-1);
+    }
+
+    :deep(.scrollBarControl) {
+      border-color: var(--el-color-primary);
+    }
+
+    :deep(.closeIcon) {
+      line-height: 15px !important;
+    }
+  }
+
+  .dark {
+    .cutter-container {
+      :deep(.toolBox) {
+        border: transparent;
+      }
+
+      :deep(.dialogMain) {
+        background-color: transparent !important;
+      }
+
+      :deep(.i-dialog-footer) {
+        .btn {
+          background-color: var(--el-color-primary) !important;
+          border: transparent;
+        }
+      }
+    }
+  }
+</style>
diff --git a/web/src/components/core/media/art-video-player/index.vue b/web/src/components/core/media/art-video-player/index.vue
new file mode 100644
index 0000000..4f681ea
--- /dev/null
+++ b/web/src/components/core/media/art-video-player/index.vue
@@ -0,0 +1,111 @@
+<!-- 视频播放器组件：https://h5player.bytedance.com/-->
+<template>
+  <div :id="playerId" />
+</template>
+
+<script setup lang="ts">
+  import Player from 'xgplayer'
+  import 'xgplayer/dist/index.min.css'
+
+  defineOptions({ name: 'ArtVideoPlayer' })
+
+  interface Props {
+    /** 播放器容器 ID */
+    playerId: string
+    /** 视频源URL */
+    videoUrl: string
+    /** 视频封面图URL */
+    posterUrl: string
+    /** 是否自动播放 */
+    autoplay?: boolean
+    /** 音量大小(0-1) */
+    volume?: number
+    /** 可选的播放速率 */
+    playbackRates?: number[]
+    /** 是否循环播放 */
+    loop?: boolean
+    /** 是否静音 */
+    muted?: boolean
+    commonStyle?: VideoPlayerStyle
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    playerId: '',
+    videoUrl: '',
+    posterUrl: '',
+    autoplay: false,
+    volume: 1,
+    loop: false,
+    muted: false
+  })
+
+  // 设置属性默认值
+
+  // 播放器实例引用
+  const playerInstance = ref<Player | null>(null)
+
+  // 播放器样式接口定义
+  interface VideoPlayerStyle {
+    progressColor?: string // 进度条背景色
+    playedColor?: string // 已播放部分颜色
+    cachedColor?: string // 缓存部分颜色
+    sliderBtnStyle?: Record<string, string> // 滑块按钮样式
+    volumeColor?: string // 音量控制器颜色
+  }
+
+  // 默认样式配置
+  const defaultStyle: VideoPlayerStyle = {
+    progressColor: 'rgba(255, 255, 255, 0.3)',
+    playedColor: '#00AEED',
+    cachedColor: 'rgba(255, 255, 255, 0.6)',
+    sliderBtnStyle: {
+      width: '10px',
+      height: '10px',
+      backgroundColor: '#00AEED'
+    },
+    volumeColor: '#00AEED'
+  }
+
+  // 组件挂载时初始化播放器
+  onMounted(() => {
+    playerInstance.value = new Player({
+      id: props.playerId,
+      lang: 'zh', // 设置界面语言为中文
+      volume: props.volume,
+      autoplay: props.autoplay,
+      screenShot: true, // 启用截图功能
+      url: props.videoUrl,
+      poster: props.posterUrl,
+      fluid: true, // 启用流式布局，自适应容器大小
+      playbackRate: props.playbackRates,
+      loop: props.loop,
+      muted: props.muted,
+      commonStyle: {
+        ...defaultStyle,
+        ...props.commonStyle
+      }
+    })
+
+    // 播放事件监听器
+    playerInstance.value.on('play', () => {
+      console.log('Video is playing')
+    })
+
+    // 暂停事件监听器
+    playerInstance.value.on('pause', () => {
+      console.log('Video is paused')
+    })
+
+    // 错误事件监听器
+    playerInstance.value.on('error', (error) => {
+      console.error('Error occurred:', error)
+    })
+  })
+
+  // 组件卸载前清理播放器实例
+  onBeforeUnmount(() => {
+    if (playerInstance.value) {
+      playerInstance.value.destroy()
+    }
+  })
+</script>
diff --git a/web/src/components/core/others/art-menu-right/index.vue b/web/src/components/core/others/art-menu-right/index.vue
new file mode 100644
index 0000000..1cc92ab
--- /dev/null
+++ b/web/src/components/core/others/art-menu-right/index.vue
@@ -0,0 +1,415 @@
+<!-- 右键菜单 -->
+<template>
+  <div class="menu-right">
+    <Transition name="context-menu" @before-enter="onBeforeEnter" @after-leave="onAfterLeave">
+      <div
+        v-show="visible"
+        :style="menuStyle"
+        class="context-menu art-card-xs !shadow-xl min-w-[var(--menu-width)] w-[var(--menu-width)]"
+      >
+        <ul class="menu-list m-0 list-none" :style="menuListStyle">
+          <template v-for="item in menuItems" :key="item.key">
+            <!-- 普通菜单项 -->
+            <li
+              v-if="!item.children"
+              class="menu-item relative flex-c c-p select-none rounded text-xs transition-colors duration-150 hover:bg-g-200"
+              :class="{ 'is-disabled': item.disabled, 'has-line': item.showLine }"
+              :style="menuItemStyle"
+              @click="handleMenuClick(item)"
+            >
+              <ArtSvgIcon
+                v-if="item.icon"
+                class="mr-2 shrink-0 text-base text-g-800"
+                :icon="item.icon"
+              />
+              <span
+                class="menu-label flex-1 overflow-hidden text-ellipsis whitespace-nowrap text-g-800"
+                >{{ item.label }}</span
+              >
+            </li>
+
+            <!-- 子菜单 -->
+            <li
+              v-else
+              class="menu-item submenu relative flex-c c-p select-none rounded text-xs transition-colors duration-150 hover:bg-g-200"
+              :style="menuItemStyle"
+            >
+              <div class="submenu-title flex-c w-full">
+                <ArtSvgIcon
+                  v-if="item.icon"
+                  class="mr-2 shrink-0 text-base text-g-800"
+                  :icon="item.icon"
+                />
+                <span
+                  class="menu-label flex-1 overflow-hidden text-ellipsis whitespace-nowrap text-g-800"
+                  >{{ item.label }}</span
+                >
+                <ArtSvgIcon
+                  icon="ri:arrow-right-s-line"
+                  class="ubmenu-arrow ml-auto mr-0 text-base text-g-500 transition-transform duration-150"
+                />
+              </div>
+              <ul
+                class="submenu-list art-card-xs absolute left-full top-0 z-[2001] hidden w-max min-w-max list-none !shadow-xl"
+                :style="submenuListStyle"
+              >
+                <li
+                  v-for="child in item.children"
+                  :key="child.key"
+                  class="menu-item relative mx-1.5 flex-c c-p select-none rounded text-xs transition-colors duration-150 hover:bg-g-200"
+                  :class="{ 'is-disabled': child.disabled, 'has-line': child.showLine }"
+                  :style="menuItemStyle"
+                  @click="handleMenuClick(child)"
+                >
+                  <ArtSvgIcon
+                    v-if="child.icon"
+                    class="r-2 shrink-0 text-base text-g-800 mr-1"
+                    :icon="child.icon"
+                  />
+                  <span
+                    class="menu-label flex-1 overflow-hidden text-ellipsis whitespace-nowrap text-g-800"
+                    >{{ child.label }}</span
+                  >
+                </li>
+              </ul>
+            </li>
+          </template>
+        </ul>
+      </div>
+    </Transition>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import type { CSSProperties } from 'vue'
+
+  defineOptions({ name: 'ArtMenuRight' })
+
+  export interface MenuItemType {
+    /** 菜单项唯一标识 */
+    key: string
+    /** 菜单项标签 */
+    label: string
+    /** 菜单项图标 */
+    icon?: string
+    /** 菜单项是否禁用 */
+    disabled?: boolean
+    /** 菜单项是否显示分割线 */
+    showLine?: boolean
+    /** 子菜单 */
+    children?: MenuItemType[]
+    [key: string]: any
+  }
+
+  interface Props {
+    menuItems: MenuItemType[]
+    /** 菜单宽度 */
+    menuWidth?: number
+    /** 子菜单宽度 */
+    submenuWidth?: number
+    /** 菜单项高度 */
+    itemHeight?: number
+    /** 边界距离 */
+    boundaryDistance?: number
+    /** 菜单内边距 */
+    menuPadding?: number
+    /** 菜单项水平内边距 */
+    itemPaddingX?: number
+    /** 菜单圆角 */
+    borderRadius?: number
+    /** 动画持续时间 */
+    animationDuration?: number
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    menuWidth: 120,
+    submenuWidth: 150,
+    itemHeight: 32,
+    boundaryDistance: 10,
+    menuPadding: 5,
+    itemPaddingX: 6,
+    borderRadius: 6,
+    animationDuration: 100
+  })
+
+  const emit = defineEmits<{
+    (e: 'select', item: MenuItemType): void
+    (e: 'show'): void
+    (e: 'hide'): void
+  }>()
+
+  const visible = ref(false)
+  const position = ref({ x: 0, y: 0 })
+
+  // 用于清理定时器和事件监听器
+  let showTimer: number | null = null
+  let eventListenersAdded = false
+
+  // 计算菜单样式
+  const menuStyle = computed(
+    (): CSSProperties => ({
+      position: 'fixed' as const,
+      left: `${position.value.x}px`,
+      top: `${position.value.y}px`,
+      zIndex: 2000,
+      width: `${props.menuWidth}px`
+    })
+  )
+
+  // 计算菜单列表样式
+  const menuListStyle = computed(
+    (): CSSProperties => ({
+      padding: `${props.menuPadding}px`
+    })
+  )
+
+  // 计算菜单项样式
+  const menuItemStyle = computed(
+    (): CSSProperties => ({
+      height: `${props.itemHeight}px`,
+      padding: `0 ${props.itemPaddingX}px`,
+      borderRadius: '4px'
+    })
+  )
+
+  // 计算子菜单列表样式
+  const submenuListStyle = computed(
+    (): CSSProperties => ({
+      minWidth: `${props.submenuWidth}px`,
+      padding: `${props.menuPadding}px 0`,
+      borderRadius: `${props.borderRadius}px`
+    })
+  )
+
+  // 计算菜单高度（用于边界检测）
+  const calculateMenuHeight = (): number => {
+    let totalHeight = props.menuPadding * 2 // 上下内边距
+
+    props.menuItems.forEach((item) => {
+      totalHeight += props.itemHeight
+      if (item.showLine) {
+        totalHeight += 10 // 分割线额外高度
+      }
+    })
+
+    return totalHeight
+  }
+
+  // 优化的位置计算函数
+  const calculatePosition = (e: MouseEvent) => {
+    const screenWidth = window.innerWidth
+    const screenHeight = window.innerHeight
+    const menuHeight = calculateMenuHeight()
+
+    let x = e.clientX
+    let y = e.clientY
+
+    // 检查右边界 - 优先显示在鼠标右侧，如果空间不足则显示在左侧
+    if (x + props.menuWidth > screenWidth - props.boundaryDistance) {
+      x = Math.max(props.boundaryDistance, x - props.menuWidth)
+    }
+
+    // 检查下边界 - 优先显示在鼠标下方，如果空间不足则向上调整
+    if (y + menuHeight > screenHeight - props.boundaryDistance) {
+      y = Math.max(props.boundaryDistance, screenHeight - menuHeight - props.boundaryDistance)
+    }
+
+    // 确保不会超出边界
+    x = Math.max(
+      props.boundaryDistance,
+      Math.min(x, screenWidth - props.menuWidth - props.boundaryDistance)
+    )
+    y = Math.max(
+      props.boundaryDistance,
+      Math.min(y, screenHeight - menuHeight - props.boundaryDistance)
+    )
+
+    return { x, y }
+  }
+
+  // 添加事件监听器
+  const addEventListeners = () => {
+    if (eventListenersAdded) return
+
+    document.addEventListener('click', handleDocumentClick)
+    document.addEventListener('contextmenu', handleDocumentContextmenu)
+    document.addEventListener('keydown', handleKeydown)
+    eventListenersAdded = true
+  }
+
+  // 移除事件监听器
+  const removeEventListeners = () => {
+    if (!eventListenersAdded) return
+
+    document.removeEventListener('click', handleDocumentClick)
+    document.removeEventListener('contextmenu', handleDocumentContextmenu)
+    document.removeEventListener('keydown', handleKeydown)
+    eventListenersAdded = false
+  }
+
+  // 处理文档点击事件
+  const handleDocumentClick = (e: Event) => {
+    // 检查点击是否在菜单内部
+    const target = e.target as Element
+    const menuElement = document.querySelector('.context-menu')
+    if (menuElement && menuElement.contains(target)) {
+      return
+    }
+    hide()
+  }
+
+  // 处理文档右键事件
+  const handleDocumentContextmenu = () => {
+    hide()
+  }
+
+  // 处理键盘事件
+  const handleKeydown = (e: KeyboardEvent) => {
+    if (e.key === 'Escape') {
+      hide()
+    }
+  }
+
+  const show = (e: MouseEvent) => {
+    e.preventDefault()
+    e.stopPropagation()
+
+    // 清理之前的定时器
+    if (showTimer) {
+      window.clearTimeout(showTimer)
+      showTimer = null
+    }
+
+    // 计算位置
+    position.value = calculatePosition(e)
+    visible.value = true
+
+    emit('show')
+
+    // 延迟添加事件监听器，避免立即触发关闭
+    showTimer = window.setTimeout(() => {
+      if (visible.value) {
+        addEventListeners()
+      }
+      showTimer = null
+    }, 50) // 减少延迟时间，提升响应性
+  }
+
+  const hide = () => {
+    if (!visible.value) return
+
+    visible.value = false
+    emit('hide')
+
+    // 清理定时器
+    if (showTimer) {
+      window.clearTimeout(showTimer)
+      showTimer = null
+    }
+
+    // 移除事件监听器
+    removeEventListeners()
+  }
+
+  const handleMenuClick = (item: MenuItemType) => {
+    if (item.disabled) return
+    emit('select', item)
+    hide()
+  }
+
+  // 动画钩子函数
+  const onBeforeEnter = (el: Element) => {
+    const element = el as HTMLElement
+    element.style.transformOrigin = 'top left'
+  }
+
+  const onAfterLeave = () => {
+    // 确保清理所有资源
+    removeEventListeners()
+    if (showTimer) {
+      window.clearTimeout(showTimer)
+      showTimer = null
+    }
+  }
+
+  // 组件卸载时清理资源
+  onUnmounted(() => {
+    removeEventListeners()
+    if (showTimer) {
+      window.clearTimeout(showTimer)
+      showTimer = null
+    }
+  })
+
+  // 导出方法供父组件调用
+  defineExpose({
+    show,
+    hide,
+    visible: computed(() => visible.value)
+  })
+</script>
+
+<style scoped>
+  .menu-right {
+    --menu-width: v-bind('props.menuWidth + "px"');
+    --border-radius: v-bind('props.borderRadius + "px"');
+  }
+
+  .menu-item.has-line {
+    margin-bottom: 10px;
+  }
+
+  .menu-item.has-line::after {
+    position: absolute;
+    right: 0;
+    bottom: -5px;
+    left: 0;
+    height: 1px;
+    content: '';
+    background-color: var(--art-gray-300);
+  }
+
+  .menu-item.is-disabled {
+    color: var(--el-text-color-disabled);
+    cursor: not-allowed;
+  }
+
+  .menu-item.is-disabled:hover {
+    background-color: transparent !important;
+  }
+
+  .menu-item.is-disabled i:not(.submenu-arrow),
+  .menu-item.is-disabled :deep(.art-svg-icon) {
+    color: var(--el-text-color-disabled) !important;
+  }
+
+  .menu-item.is-disabled .menu-label {
+    color: var(--el-text-color-disabled) !important;
+  }
+
+  .menu-item.submenu:hover .submenu-list {
+    display: block;
+  }
+
+  .menu-item.submenu:hover .submenu-title .submenu-arrow {
+    transform: rotate(90deg);
+  }
+
+  /* 动画样式 */
+  .context-menu-enter-active,
+  .context-menu-leave-active {
+    transition: all v-bind('props.animationDuration + "ms"') ease-out;
+  }
+
+  .context-menu-enter-from,
+  .context-menu-leave-to {
+    opacity: 0;
+    transform: scale(0.9);
+  }
+
+  .context-menu-enter-to,
+  .context-menu-leave-from {
+    opacity: 1;
+    transform: scale(1);
+  }
+</style>
diff --git a/web/src/components/core/others/art-watermark/index.vue b/web/src/components/core/others/art-watermark/index.vue
new file mode 100644
index 0000000..1d7f06b
--- /dev/null
+++ b/web/src/components/core/others/art-watermark/index.vue
@@ -0,0 +1,64 @@
+<!-- 水印组件 -->
+<template>
+  <div
+    v-if="watermarkVisible"
+    class="fixed left-0 top-0 h-screen w-screen pointer-events-none"
+    :style="{ zIndex: zIndex }"
+  >
+    <ElWatermark
+      :content="content"
+      :font="{ fontSize: fontSize, color: fontColor }"
+      :rotate="rotate"
+      :gap="[gapX, gapY]"
+      :offset="[offsetX, offsetY]"
+    >
+      <div style="height: 100vh"></div>
+    </ElWatermark>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import AppConfig from '@/config'
+  import { useSettingStore } from '@/store/modules/setting'
+
+  defineOptions({ name: 'ArtWatermark' })
+
+  const settingStore = useSettingStore()
+  const { watermarkVisible } = storeToRefs(settingStore)
+
+  interface WatermarkProps {
+    /** 水印内容 */
+    content?: string
+    /** 水印是否可见 */
+    visible?: boolean
+    /** 水印字体大小 */
+    fontSize?: number
+    /** 水印字体颜色 */
+    fontColor?: string
+    /** 水印旋转角度 */
+    rotate?: number
+    /** 水印间距X */
+    gapX?: number
+    /** 水印间距Y */
+    gapY?: number
+    /** 水印偏移X */
+    offsetX?: number
+    /** 水印偏移Y */
+    offsetY?: number
+    /** 水印层级 */
+    zIndex?: number
+  }
+
+  withDefaults(defineProps<WatermarkProps>(), {
+    content: AppConfig.systemInfo.name,
+    visible: false,
+    fontSize: 16,
+    fontColor: 'rgba(128, 128, 128, 0.2)',
+    rotate: -22,
+    gapX: 100,
+    gapY: 100,
+    offsetX: 50,
+    offsetY: 50,
+    zIndex: 3100
+  })
+</script>
diff --git a/web/src/components/core/tables/art-table-header/index.vue b/web/src/components/core/tables/art-table-header/index.vue
new file mode 100644
index 0000000..788c2b7
--- /dev/null
+++ b/web/src/components/core/tables/art-table-header/index.vue
@@ -0,0 +1,339 @@
+<!-- 表格头部，包含表格大小、刷新、全屏、列设置、其他设置 -->
+<template>
+  <div class="flex-cb max-md:!block" id="art-table-header">
+    <div class="flex-wrap">
+      <slot name="left"></slot>
+    </div>
+
+    <div class="flex-c md:justify-end max-md:mt-3 max-sm:!hidden">
+      <div
+        v-if="showSearchBar != null"
+        class="button"
+        @click="search"
+        :class="showSearchBar ? 'active !bg-theme hover:!bg-theme/80' : ''"
+      >
+        <ArtSvgIcon icon="ri:search-line" :class="showSearchBar ? 'text-white' : 'text-g-700'" />
+      </div>
+      <div
+        v-if="shouldShow('refresh')"
+        class="button"
+        @click="refresh"
+        :class="{ loading: loading && isManualRefresh }"
+      >
+        <ArtSvgIcon
+          icon="ri:refresh-line"
+          :class="loading && isManualRefresh ? 'animate-spin text-g-600' : ''"
+        />
+      </div>
+
+      <ElDropdown v-if="shouldShow('size')" @command="handleTableSizeChange">
+        <div class="button">
+          <ArtSvgIcon icon="ri:arrow-up-down-fill" />
+        </div>
+        <template #dropdown>
+          <ElDropdownMenu>
+            <div
+              v-for="item in tableSizeOptions"
+              :key="item.value"
+              class="table-size-btn-item [&_.el-dropdown-menu__item]:!mb-[3px] last:[&_.el-dropdown-menu__item]:!mb-0"
+            >
+              <ElDropdownItem
+                :key="item.value"
+                :command="item.value"
+                :class="tableSize === item.value ? '!bg-g-300/55' : ''"
+              >
+                {{ item.label }}
+              </ElDropdownItem>
+            </div>
+          </ElDropdownMenu>
+        </template>
+      </ElDropdown>
+
+      <div v-if="shouldShow('fullscreen')" class="button" @click="toggleFullScreen">
+        <ArtSvgIcon :icon="isFullScreen ? 'ri:fullscreen-exit-line' : 'ri:fullscreen-line'" />
+      </div>
+
+      <!-- 列设置 -->
+      <ElPopover v-if="shouldShow('columns')" placement="bottom" trigger="click">
+        <template #reference>
+          <div class="button">
+            <ArtSvgIcon icon="ri:align-right" />
+          </div>
+        </template>
+        <div>
+          <ElScrollbar max-height="380px">
+            <VueDraggable
+              v-model="columns"
+              :disabled="false"
+              filter=".fixed-column"
+              :prevent-on-filter="false"
+              @move="checkColumnMove"
+            >
+              <div
+                v-for="item in columns"
+                :key="item.prop || item.type"
+                class="column-option flex-c"
+                :class="{ 'fixed-column': item.fixed }"
+              >
+                <div
+                  class="drag-icon mr-2 h-4.5 flex-cc text-g-500"
+                  :class="item.fixed ? 'cursor-default text-g-300' : 'cursor-move'"
+                >
+                  <ArtSvgIcon
+                    :icon="item.fixed ? 'ri:unpin-line' : 'ri:drag-move-2-fill'"
+                    class="text-base"
+                  />
+                </div>
+                <ElCheckbox
+                  :model-value="getColumnVisibility(item)"
+                  @update:model-value="(val) => updateColumnVisibility(item, val)"
+                  :disabled="item.disabled"
+                  class="flex-1 min-w-0 [&_.el-checkbox__label]:overflow-hidden [&_.el-checkbox__label]:text-ellipsis [&_.el-checkbox__label]:whitespace-nowrap"
+                  >{{
+                    item.label || (item.type === 'selection' ? t('table.selection') : '')
+                  }}</ElCheckbox
+                >
+              </div>
+            </VueDraggable>
+          </ElScrollbar>
+        </div>
+      </ElPopover>
+      <!-- 其他设置 -->
+      <ElPopover v-if="shouldShow('settings')" placement="bottom" trigger="click">
+        <template #reference>
+          <div class="button">
+            <ArtSvgIcon icon="ri:settings-line" />
+          </div>
+        </template>
+        <div>
+          <ElCheckbox v-if="showZebra" v-model="isZebra" :value="true">{{
+            t('table.zebra')
+          }}</ElCheckbox>
+          <ElCheckbox v-if="showBorder" v-model="isBorder" :value="true">{{
+            t('table.border')
+          }}</ElCheckbox>
+          <ElCheckbox v-if="showHeaderBackground" v-model="isHeaderBackground" :value="true">{{
+            t('table.headerBackground')
+          }}</ElCheckbox>
+        </div>
+      </ElPopover>
+      <slot name="right"></slot>
+    </div>
+  </div>
+</template>
+
+<script lang="ts" setup>
+  import { computed, ref, onMounted, onUnmounted } from 'vue'
+  import { storeToRefs } from 'pinia'
+  import { TableSizeEnum } from '@/enums/formEnum'
+  import { useTableStore } from '@/store/modules/table'
+  import { VueDraggable } from 'vue-draggable-plus'
+  import { useI18n } from 'vue-i18n'
+  import type { ColumnOption } from '@/types/component'
+  import { ElScrollbar } from 'element-plus'
+
+  defineOptions({ name: 'ArtTableHeader' })
+
+  const { t } = useI18n()
+
+  interface Props {
+    /** 斑马纹 */
+    showZebra?: boolean
+    /** 边框 */
+    showBorder?: boolean
+    /** 表头背景 */
+    showHeaderBackground?: boolean
+    /** 全屏 class */
+    fullClass?: string
+    /** 组件布局，子组件名用逗号分隔 */
+    layout?: string
+    /** 加载中 */
+    loading?: boolean
+    /** 搜索栏显示状态 */
+    showSearchBar?: boolean
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    showZebra: true,
+    showBorder: true,
+    showHeaderBackground: true,
+    fullClass: 'art-page-view',
+    layout: 'search,refresh,size,fullscreen,columns,settings',
+    showSearchBar: undefined
+  })
+
+  const columns = defineModel<ColumnOption[]>('columns', {
+    required: false,
+    default: () => []
+  })
+
+  const emit = defineEmits<{
+    (e: 'refresh'): void
+    (e: 'search'): void
+    (e: 'update:showSearchBar', value: boolean): void
+  }>()
+
+  /**
+   * 获取列的显示状态
+   * 优先使用 visible 字段，如果不存在则使用 checked 字段
+   */
+  const getColumnVisibility = (col: ColumnOption): boolean => {
+    if (col.visible !== undefined) {
+      return col.visible
+    }
+    return col.checked ?? true
+  }
+
+  /**
+   * 更新列的显示状态
+   * 同时更新 checked 和 visible 字段以保持兼容性
+   */
+  const updateColumnVisibility = (col: ColumnOption, value: boolean | string | number): void => {
+    const boolValue = !!value
+    col.checked = boolValue
+    col.visible = boolValue
+  }
+
+  /** 表格大小选项配置 */
+  const tableSizeOptions = [
+    { value: TableSizeEnum.SMALL, label: t('table.sizeOptions.small') },
+    { value: TableSizeEnum.DEFAULT, label: t('table.sizeOptions.default') },
+    { value: TableSizeEnum.LARGE, label: t('table.sizeOptions.large') }
+  ]
+
+  const tableStore = useTableStore()
+  const { tableSize, isZebra, isBorder, isHeaderBackground } = storeToRefs(tableStore)
+
+  /** 解析 layout 属性，转换为数组 */
+  const layoutItems = computed(() => {
+    return props.layout.split(',').map((item) => item.trim())
+  })
+
+  /**
+   * 检查组件是否应该显示
+   * @param componentName 组件名称
+   * @returns 是否显示
+   */
+  const shouldShow = (componentName: string) => {
+    return layoutItems.value.includes(componentName)
+  }
+
+  /**
+   * 拖拽移动事件处理 - 防止固定列位置改变
+   * @param evt move事件对象
+   * @returns 是否允许移动
+   */
+  const checkColumnMove = (event: any) => {
+    // 拖拽进入的目标 DOM 元素
+    const toElement = event.related as HTMLElement
+    // 如果目标位置是 fixed 列，则不允许移动
+    if (toElement && toElement.classList.contains('fixed-column')) {
+      return false
+    }
+    return true
+  }
+
+  /** 搜索事件处理 */
+  const search = () => {
+    // 切换搜索栏显示状态
+    emit('update:showSearchBar', !props.showSearchBar)
+    emit('search')
+  }
+
+  /** 刷新事件处理 */
+  const refresh = () => {
+    isManualRefresh.value = true
+    emit('refresh')
+  }
+
+  /**
+   * 表格大小变化处理
+   * @param command 表格大小枚举值
+   */
+  const handleTableSizeChange = (command: TableSizeEnum) => {
+    useTableStore().setTableSize(command)
+  }
+
+  /** 是否手动点击刷新 */
+  const isManualRefresh = ref(false)
+
+  /** 加载中 */
+  const isFullScreen = ref(false)
+
+  /** 保存原始的 overflow 样式，用于退出全屏时恢复 */
+  const originalOverflow = ref('')
+
+  /**
+   * 切换全屏状态
+   * 进入全屏时会隐藏页面滚动条，退出时恢复原状态
+   */
+  const toggleFullScreen = () => {
+    const el = document.querySelector(`.${props.fullClass}`)
+    if (!el) return
+
+    isFullScreen.value = !isFullScreen.value
+
+    if (isFullScreen.value) {
+      // 进入全屏：保存原始样式并隐藏滚动条
+      originalOverflow.value = document.body.style.overflow
+      document.body.style.overflow = 'hidden'
+      el.classList.add('el-full-screen')
+      tableStore.setIsFullScreen(true)
+    } else {
+      // 退出全屏：恢复原始样式
+      document.body.style.overflow = originalOverflow.value
+      el.classList.remove('el-full-screen')
+      tableStore.setIsFullScreen(false)
+    }
+  }
+
+  /**
+   * ESC键退出全屏的事件处理器
+   * 需要保存引用以便在组件卸载时正确移除监听器
+   */
+  const handleEscapeKey = (e: KeyboardEvent) => {
+    if (e.key === 'Escape' && isFullScreen.value) {
+      toggleFullScreen()
+    }
+  }
+
+  /** 组件挂载时注册全局事件监听器 */
+  onMounted(() => {
+    document.addEventListener('keydown', handleEscapeKey)
+  })
+
+  /** 组件卸载时清理资源 */
+  onUnmounted(() => {
+    // 移除事件监听器
+    document.removeEventListener('keydown', handleEscapeKey)
+
+    // 如果组件在全屏状态下被卸载，恢复页面滚动状态
+    if (isFullScreen.value) {
+      document.body.style.overflow = originalOverflow.value
+      const el = document.querySelector(`.${props.fullClass}`)
+      if (el) {
+        el.classList.remove('el-full-screen')
+      }
+    }
+  })
+</script>
+
+<style scoped>
+  @reference '@styles/core/tailwind.css';
+
+  .button {
+    @apply ml-2 
+    size-8 
+    flex 
+    items-center 
+    justify-center 
+    cursor-pointer 
+    rounded-md 
+    bg-g-300/55
+    dark:bg-g-300/40
+    text-g-700  
+    hover:bg-g-300 
+    md:ml-0 
+    md:mr-2.5;
+  }
+</style>
diff --git a/web/src/components/core/tables/art-table/index.vue b/web/src/components/core/tables/art-table/index.vue
new file mode 100644
index 0000000..be99e70
--- /dev/null
+++ b/web/src/components/core/tables/art-table/index.vue
@@ -0,0 +1,368 @@
+<!-- 表格组件 -->
+<!-- 支持：el-table 全部属性、事件、插槽，同官方文档写法 -->
+<!-- 扩展功能：分页组件、渲染自定义列、loading、表格全局边框、斑马纹、表格尺寸、表头背景配置 -->
+<!-- 获取 ref：默认暴露了 elTableRef 外部通过 ref.value.elTableRef 可以调用 el-table 方法 -->
+<template>
+  <div class="art-table" :class="{ 'is-empty': isEmpty }" :style="containerHeight">
+    <ElTable ref="elTableRef" v-loading="!!loading" v-bind="mergedTableProps">
+      <template v-for="col in columns" :key="col.prop || col.type">
+        <!-- 渲染全局序号列 -->
+        <ElTableColumn v-if="col.type === 'globalIndex'" v-bind="{ ...col }">
+          <template #default="{ $index }">
+            <span>{{ getGlobalIndex($index) }}</span>
+          </template>
+        </ElTableColumn>
+
+        <!-- 渲染展开行 -->
+        <ElTableColumn v-else-if="col.type === 'expand'" v-bind="cleanColumnProps(col)">
+          <template #default="{ row }">
+            <component :is="col.formatter ? col.formatter(row) : null" />
+          </template>
+        </ElTableColumn>
+
+        <!-- 渲染普通列 -->
+        <ElTableColumn v-else v-bind="cleanColumnProps(col)">
+          <template v-if="col.useHeaderSlot && col.prop" #header="headerScope">
+            <slot
+              :name="col.headerSlotName || `${col.prop}-header`"
+              v-bind="{ ...headerScope, prop: col.prop, label: col.label }"
+            >
+              {{ col.label }}
+            </slot>
+          </template>
+          <template v-if="col.useSlot && col.prop" #default="slotScope">
+            <slot
+              v-if="shouldRenderSlotScope(slotScope)"
+              :name="col.slotName || col.prop"
+              v-bind="{
+                ...slotScope,
+                prop: col.prop,
+                value: col.prop ? slotScope.row[col.prop] : undefined
+              }"
+            />
+          </template>
+        </ElTableColumn>
+      </template>
+
+      <template v-if="$slots.default" #default><slot /></template>
+
+      <template #empty>
+        <div v-if="loading"></div>
+        <ElEmpty v-else :description="emptyText" :image-size="120" />
+      </template>
+    </ElTable>
+
+    <div
+      class="pagination custom-pagination"
+      v-if="showPagination"
+      :class="mergedPaginationOptions?.align"
+      ref="paginationRef"
+    >
+      <ElPagination
+        v-bind="mergedPaginationOptions"
+        :total="pagination?.total"
+        :disabled="loading"
+        :page-size="pagination?.size"
+        :current-page="pagination?.current"
+        @size-change="handleSizeChange"
+        @current-change="handleCurrentChange"
+      />
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, computed, nextTick, watchEffect, getCurrentInstance, useAttrs } from 'vue'
+  import type { ElTable, TableProps } from 'element-plus'
+  import { storeToRefs } from 'pinia'
+  import { ColumnOption } from '@/types'
+  import { useTableStore } from '@/store/modules/table'
+  import { useCommon } from '@/hooks/core/useCommon'
+  import { useTableHeight } from '@/hooks/core/useTableHeight'
+  import { useResizeObserver, useWindowSize } from '@vueuse/core'
+
+  defineOptions({ name: 'ArtTable' })
+
+  const { width } = useWindowSize()
+  const elTableRef = ref<InstanceType<typeof ElTable> | null>(null)
+  const paginationRef = ref<HTMLElement>()
+  const tableHeaderRef = ref<HTMLElement>()
+  const tableStore = useTableStore()
+  const { isBorder, isZebra, tableSize, isFullScreen, isHeaderBackground } = storeToRefs(tableStore)
+
+  /** 分页配置接口 */
+  interface PaginationConfig {
+    /** 当前页码 */
+    current: number
+    /** 每页显示条目个数 */
+    size: number
+    /** 总条目数 */
+    total: number
+  }
+
+  /** 分页器配置选项接口 */
+  interface PaginationOptions {
+    /** 每页显示个数选择器的选项列表 */
+    pageSizes?: number[]
+    /** 分页器的对齐方式 */
+    align?: 'left' | 'center' | 'right'
+    /** 分页器的布局 */
+    layout?: string
+    /** 是否显示分页器背景 */
+    background?: boolean
+    /** 只有一页时是否隐藏分页器 */
+    hideOnSinglePage?: boolean
+    /** 分页器的大小 */
+    size?: 'small' | 'default' | 'large'
+    /** 分页器的页码数量 */
+    pagerCount?: number
+  }
+
+  /** ArtTable 组件的 Props 接口 */
+  interface ArtTableProps extends TableProps<Record<string, any>> {
+    /** 加载状态 */
+    loading?: boolean
+    /** 列渲染配置 */
+    columns?: ColumnOption[]
+    /** 分页状态 */
+    pagination?: PaginationConfig
+    /** 分页配置 */
+    paginationOptions?: PaginationOptions
+    /** 空数据表格高度 */
+    emptyHeight?: string
+    /** 空数据时显示的文本 */
+    emptyText?: string
+    /** 是否开启 ArtTableHeader，解决表格高度自适应问题 */
+    showTableHeader?: boolean
+  }
+
+  const props = withDefaults(defineProps<ArtTableProps>(), {
+    columns: () => [],
+    fit: true,
+    showHeader: true,
+    stripe: undefined,
+    border: undefined,
+    size: undefined,
+    emptyHeight: '100%',
+    emptyText: '暂无数据',
+    showTableHeader: true
+  })
+  const instance = getCurrentInstance()
+  const attrs = useAttrs()
+
+  const LAYOUT = {
+    MOBILE: 'prev, pager, next, sizes, jumper, total',
+    IPAD: 'prev, pager, next, jumper, total',
+    DESKTOP: 'total, prev, pager, next, sizes, jumper'
+  }
+
+  const layout = computed(() => {
+    if (width.value < 768) {
+      return LAYOUT.MOBILE
+    } else if (width.value < 1024) {
+      return LAYOUT.IPAD
+    } else {
+      return LAYOUT.DESKTOP
+    }
+  })
+
+  // 默认分页常量
+  const DEFAULT_PAGINATION_OPTIONS: PaginationOptions = {
+    pageSizes: [10, 20, 30, 50, 100],
+    align: 'center',
+    background: true,
+    layout: layout.value,
+    hideOnSinglePage: false,
+    size: 'default',
+    pagerCount: width.value > 1200 ? 7 : 5
+  }
+
+  // 合并分页配置
+  const mergedPaginationOptions = computed(() => ({
+    ...DEFAULT_PAGINATION_OPTIONS,
+    ...props.paginationOptions
+  }))
+
+  // 边框 (优先级：props > store)
+  const border = computed(() => props.border ?? isBorder.value)
+  // 斑马纹
+  const stripe = computed(() => props.stripe ?? isZebra.value)
+  // 表格尺寸
+  const size = computed(() => props.size ?? tableSize.value)
+  // 数据是否为空
+  const isEmpty = computed(() => props.data?.length === 0)
+
+  const paginationHeight = ref(0)
+  const tableHeaderHeight = ref(0)
+
+  // 使用 useResizeObserver 监听分页器高度变化
+  useResizeObserver(paginationRef, (entries) => {
+    const entry = entries[0]
+    if (entry) {
+      // 使用 requestAnimationFrame 避免 ResizeObserver loop 警告
+      requestAnimationFrame(() => {
+        paginationHeight.value = entry.contentRect.height
+      })
+    }
+  })
+
+  // 使用 useResizeObserver 监听表格头部高度变化
+  useResizeObserver(tableHeaderRef, (entries) => {
+    const entry = entries[0]
+    if (entry) {
+      // 使用 requestAnimationFrame 避免 ResizeObserver loop 警告
+      requestAnimationFrame(() => {
+        tableHeaderHeight.value = entry.contentRect.height
+      })
+    }
+  })
+
+  // 分页器与表格之间的间距常量（计算属性，响应 showTableHeader 变化）
+  const PAGINATION_SPACING = computed(() => (props.showTableHeader ? 6 : 15))
+
+  // 使用表格高度计算 Hook
+  const { containerHeight } = useTableHeight({
+    showTableHeader: computed(() => props.showTableHeader),
+    paginationHeight,
+    tableHeaderHeight,
+    paginationSpacing: PAGINATION_SPACING
+  })
+
+  // 表格高度逻辑
+  const height = computed(() => {
+    // 全屏模式下占满全屏
+    if (isFullScreen.value) return '100%'
+    // 空数据且非加载状态时固定高度
+    if (isEmpty.value && !props.loading) return props.emptyHeight
+    // 使用传入的高度
+    if (props.height) return props.height
+    // 默认占满容器高度
+    return '100%'
+  })
+
+  // 表头背景颜色样式
+  const headerCellStyle = computed(() => ({
+    background: isHeaderBackground.value
+      ? 'var(--el-fill-color-lighter)'
+      : 'var(--default-box-color)',
+    ...(props.headerCellStyle || {}) // 合并用户传入的样式
+  }))
+
+  // 只有显式传入时才覆盖 ElTable 的原生默认值，避免继承的 Boolean props 把官方默认值冲掉。
+  const hasExplicitTableProp = (propName: string): boolean => {
+    const rawProps = (instance?.vnode.props || {}) as Record<string, unknown>
+    const kebabName = propName.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`)
+    return propName in rawProps || kebabName in rawProps
+  }
+
+  const mergedTableProps = computed(() => ({
+    ...attrs,
+    ...props,
+    height: height.value,
+    stripe: stripe.value,
+    border: border.value,
+    size: size.value,
+    headerCellStyle: headerCellStyle.value,
+    // Element Plus 默认值为 true，未显式传入时不应被 ArtTable 覆盖成 false。
+    selectOnIndeterminate: hasExplicitTableProp('selectOnIndeterminate')
+      ? props.selectOnIndeterminate
+      : undefined
+  }))
+
+  // 是否显示分页器
+  const showPagination = computed(() => props.pagination && !isEmpty.value)
+
+  // Element Plus 在部分场景会先用 $index = -1 进行预渲染。
+  // 这对普通展示无影响，但会让 ElForm 错误注册出 lineList.-1.xxx 这类字段。
+  const shouldRenderSlotScope = (slotScope: { $index?: number }) => {
+    return slotScope.$index === undefined || slotScope.$index >= 0
+  }
+
+  // 清理列属性，移除插槽相关的自定义属性，确保它们不会被 ElTableColumn 错误解释
+  const cleanColumnProps = (col: ColumnOption) => {
+    const columnProps = { ...col }
+    // 删除自定义的插槽控制属性
+    delete columnProps.useHeaderSlot
+    delete columnProps.headerSlotName
+    delete columnProps.useSlot
+    delete columnProps.slotName
+    return columnProps
+  }
+
+  // 分页大小变化
+  const handleSizeChange = (val: number) => {
+    emit('pagination:size-change', val)
+  }
+
+  // 分页当前页变化
+  const handleCurrentChange = (val: number) => {
+    emit('pagination:current-change', val)
+    scrollToTop() // 页码改变后滚动到表格顶部
+  }
+
+  const { scrollToTop: scrollPageToTop } = useCommon()
+
+  // 滚动表格内容到顶部，并可以联动页面滚动到顶部
+  const scrollToTop = () => {
+    nextTick(() => {
+      elTableRef.value?.setScrollTop(0) // 滚动 ElTable 内部滚动条到顶部
+      scrollPageToTop() // 调用公共 composable 滚动页面到顶部
+    })
+  }
+
+  // 全局序号
+  const getGlobalIndex = (index: number) => {
+    if (!props.pagination) return index + 1
+    const { current, size } = props.pagination
+    return (current - 1) * size + index + 1
+  }
+
+  const emit = defineEmits<{
+    (e: 'pagination:size-change', val: number): void
+    (e: 'pagination:current-change', val: number): void
+  }>()
+
+  // 查找并绑定表格头部元素 - 使用 VueUse 优化
+  const findTableHeader = () => {
+    if (!props.showTableHeader) {
+      tableHeaderRef.value = undefined
+      return
+    }
+
+    const tableHeader = document.getElementById('art-table-header')
+    if (tableHeader) {
+      tableHeaderRef.value = tableHeader
+    } else {
+      // 如果找不到表格头部，设置为 undefined，useElementSize 会返回 0
+      tableHeaderRef.value = undefined
+    }
+  }
+
+  watchEffect(
+    () => {
+      // 访问响应式数据以建立依赖追踪
+      void props.data?.length // 追踪数据变化
+      const shouldShow = props.showTableHeader
+
+      // 只有在需要显示表格头部时才查找
+      if (shouldShow) {
+        nextTick(() => {
+          findTableHeader()
+        })
+      } else {
+        // 不显示时清空引用
+        tableHeaderRef.value = undefined
+      }
+    },
+    { flush: 'post' }
+  )
+
+  defineExpose({
+    scrollToTop,
+    elTableRef
+  })
+</script>
+
+<style lang="scss" scoped>
+  @use './style';
+</style>
diff --git a/web/src/components/core/tables/art-table/style.scss b/web/src/components/core/tables/art-table/style.scss
new file mode 100644
index 0000000..67459e8
--- /dev/null
+++ b/web/src/components/core/tables/art-table/style.scss
@@ -0,0 +1,99 @@
+.art-table {
+  position: relative;
+  height: 100%;
+
+  .el-table {
+    height: 100%;
+    margin-top: 10px;
+  }
+
+  :deep(.el-loading-mask) {
+    z-index: 100;
+    background-color: var(--default-box-color) !important;
+  }
+
+  // Loading 过渡动画 - 消失时淡出
+  .loading-fade-leave-active {
+    transition: opacity 0.3s ease-out;
+  }
+
+  .loading-fade-leave-to {
+    opacity: 0;
+  }
+
+  // 空状态垂直居中
+  &.is-empty {
+    :deep(.el-scrollbar__wrap) {
+      display: flex;
+    }
+  }
+
+  .pagination {
+    display: flex;
+    margin-top: 13px;
+
+    :deep(.el-select) {
+      width: 102px !important;
+    }
+
+    // 分页对齐方式
+    &.left {
+      justify-content: flex-start;
+    }
+
+    &.center {
+      justify-content: center;
+    }
+
+    &.right {
+      justify-content: flex-end;
+    }
+
+    // 自定义分页组件样式
+    &.custom-pagination {
+      :deep(.el-pagination) {
+        .btn-prev,
+        .btn-next {
+          background-color: transparent;
+          border: 1px solid var(--art-gray-300);
+          transition: border-color 0.15s;
+
+          &:hover:not(.is-disabled) {
+            color: var(--theme-color);
+            border-color: var(--theme-color);
+          }
+        }
+
+        li {
+          box-sizing: border-box;
+          font-weight: 400 !important;
+          background-color: transparent;
+          border: 1px solid var(--art-gray-300);
+          transition: border-color 0.15s;
+
+          &.is-active {
+            font-weight: 400;
+            color: #fff;
+            background-color: var(--theme-color);
+            border: 1px solid var(--theme-color);
+          }
+
+          &:hover:not(.is-disabled) {
+            border-color: var(--theme-color);
+          }
+        }
+      }
+    }
+  }
+}
+
+// 移动端分页
+@media (width <= 640px) {
+  :deep(.el-pagination) {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 15px 0;
+    align-items: center;
+    justify-content: center;
+  }
+}
diff --git a/web/src/components/core/text-effect/art-count-to/index.vue b/web/src/components/core/text-effect/art-count-to/index.vue
new file mode 100644
index 0000000..7fb104b
--- /dev/null
+++ b/web/src/components/core/text-effect/art-count-to/index.vue
@@ -0,0 +1,310 @@
+<!-- 数字滚动 -->
+<template>
+  <span
+    class="text-g-900 tabular-nums"
+    :class="isRunning ? 'transition-opacity duration-300 ease-in-out' : ''"
+  >
+    {{ formattedValue }}
+  </span>
+</template>
+
+<script setup lang="ts">
+  import { computed, watch, nextTick, onUnmounted, shallowRef } from 'vue'
+  import { useTransition, TransitionPresets } from '@vueuse/core'
+
+  // 类型定义
+  interface CountToProps {
+    /** 目标值 */
+    target: number
+    /** 动画持续时间（毫秒） */
+    duration?: number
+    /** 是否自动开始 */
+    autoStart?: boolean
+    /** 小数位数 */
+    decimals?: number
+    /** 小数点符号 */
+    decimal?: string
+    /** 千分位分隔符 */
+    separator?: string
+    /** 前缀 */
+    prefix?: string
+    /** 后缀 */
+    suffix?: string
+    /** 缓动函数 */
+    easing?: keyof typeof TransitionPresets
+    /** 是否禁用动画 */
+    disabled?: boolean
+  }
+
+  interface CountToEmits {
+    started: [value: number]
+    finished: [value: number]
+    paused: [value: number]
+    reset: []
+  }
+
+  interface CountToExpose {
+    start: (target?: number) => void
+    pause: () => void
+    reset: (newTarget?: number) => void
+    stop: () => void
+    setTarget: (target: number) => void
+    readonly isRunning: boolean
+    readonly isPaused: boolean
+    readonly currentValue: number
+    readonly targetValue: number
+    readonly progress: number
+  }
+
+  // 常量定义
+  const EPSILON = Number.EPSILON
+  const MIN_DURATION = 100
+  const MAX_DURATION = 60000
+  const MAX_DECIMALS = 10
+  const DEFAULT_EASING = 'easeOutExpo'
+  const DEFAULT_DURATION = 2000
+
+  const props = withDefaults(defineProps<CountToProps>(), {
+    target: 0,
+    duration: DEFAULT_DURATION,
+    autoStart: true,
+    decimals: 0,
+    decimal: '.',
+    separator: '',
+    prefix: '',
+    suffix: '',
+    easing: DEFAULT_EASING,
+    disabled: false
+  })
+
+  const emit = defineEmits<CountToEmits>()
+
+  // 工具函数
+  const validateNumber = (value: number, name: string, defaultValue: number): number => {
+    if (!Number.isFinite(value)) {
+      console.warn(`[CountTo] Invalid ${name} value:`, value)
+      return defaultValue
+    }
+    return value
+  }
+
+  const clamp = (value: number, min: number, max: number): number => {
+    return Math.max(min, Math.min(value, max))
+  }
+
+  const formatNumber = (
+    value: number,
+    decimals: number,
+    decimal: string,
+    separator: string
+  ): string => {
+    let result = decimals > 0 ? value.toFixed(decimals) : Math.floor(value).toString()
+
+    // 处理小数点符号
+    if (decimal !== '.' && result.includes('.')) {
+      result = result.replace('.', decimal)
+    }
+
+    // 处理千分位分隔符
+    if (separator) {
+      const parts = result.split(decimal)
+      parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, separator)
+      result = parts.join(decimal)
+    }
+
+    return result
+  }
+
+  // 安全计算值
+  const safeTarget = computed(() => validateNumber(props.target, 'target', 0))
+  const safeDuration = computed(() =>
+    clamp(validateNumber(props.duration, 'duration', DEFAULT_DURATION), MIN_DURATION, MAX_DURATION)
+  )
+  const safeDecimals = computed(() =>
+    clamp(validateNumber(props.decimals, 'decimals', 0), 0, MAX_DECIMALS)
+  )
+  const safeEasing = computed(() => {
+    const easing = props.easing
+    if (!(easing in TransitionPresets)) {
+      console.warn('[CountTo] Invalid easing value:', easing)
+      return DEFAULT_EASING
+    }
+    return easing
+  })
+
+  // 状态管理
+  const currentValue = shallowRef(0)
+  const targetValue = shallowRef(safeTarget.value)
+  const isRunning = shallowRef(false)
+  const isPaused = shallowRef(false)
+  const pausedValue = shallowRef(0)
+
+  // 动画控制
+  const transitionValue = useTransition(currentValue, {
+    duration: safeDuration,
+    transition: computed(() => TransitionPresets[safeEasing.value]),
+    onStarted: () => {
+      isRunning.value = true
+      isPaused.value = false
+      emit('started', targetValue.value)
+    },
+    onFinished: () => {
+      isRunning.value = false
+      isPaused.value = false
+      emit('finished', targetValue.value)
+    }
+  })
+
+  // 格式化显示值
+  const formattedValue = computed(() => {
+    const value = isPaused.value ? pausedValue.value : transitionValue.value
+
+    if (!Number.isFinite(value)) {
+      return `${props.prefix}0${props.suffix}`
+    }
+
+    const formattedNumber = formatNumber(value, safeDecimals.value, props.decimal, props.separator)
+    return `${props.prefix}${formattedNumber}${props.suffix}`
+  })
+
+  // 私有方法
+  const shouldSkipAnimation = (target: number): boolean => {
+    const current = isPaused.value ? pausedValue.value : transitionValue.value
+    return Math.abs(current - target) < EPSILON
+  }
+
+  const resetPauseState = (): void => {
+    isPaused.value = false
+    pausedValue.value = 0
+  }
+
+  // 公共方法
+  const start = (target?: number): void => {
+    if (props.disabled) {
+      console.warn('[CountTo] Animation is disabled')
+      return
+    }
+
+    const finalTarget = target !== undefined ? target : targetValue.value
+
+    if (!Number.isFinite(finalTarget)) {
+      console.warn('[CountTo] Invalid target value for start:', finalTarget)
+      return
+    }
+
+    targetValue.value = finalTarget
+
+    if (shouldSkipAnimation(finalTarget)) {
+      return
+    }
+
+    // 从暂停值开始（如果存在）
+    if (isPaused.value) {
+      currentValue.value = pausedValue.value
+      resetPauseState()
+    }
+
+    nextTick(() => {
+      currentValue.value = finalTarget
+    })
+  }
+
+  const pause = (): void => {
+    if (!isRunning.value || isPaused.value) {
+      return
+    }
+
+    isPaused.value = true
+    pausedValue.value = transitionValue.value
+    currentValue.value = pausedValue.value
+
+    emit('paused', pausedValue.value)
+  }
+
+  const reset = (newTarget = 0): void => {
+    const target = validateNumber(newTarget, 'reset target', 0)
+
+    currentValue.value = target
+    targetValue.value = target
+    resetPauseState()
+
+    emit('reset')
+  }
+
+  const setTarget = (target: number): void => {
+    if (!Number.isFinite(target)) {
+      console.warn('[CountTo] Invalid target value for setTarget:', target)
+      return
+    }
+
+    targetValue.value = target
+
+    if ((isRunning.value || props.autoStart) && !props.disabled) {
+      start(target)
+    }
+  }
+
+  const stop = (): void => {
+    if (isRunning.value || isPaused.value) {
+      currentValue.value = 0
+      resetPauseState()
+      emit('paused', 0)
+    }
+  }
+
+  // 监听器
+  watch(
+    safeTarget,
+    (newTarget) => {
+      if (props.autoStart && !props.disabled) {
+        start(newTarget)
+      } else {
+        targetValue.value = newTarget
+      }
+    },
+    { immediate: props.autoStart && !props.disabled }
+  )
+
+  watch(
+    () => props.disabled,
+    (disabled) => {
+      if (disabled && isRunning.value) {
+        stop()
+      }
+    }
+  )
+
+  // 清理
+  onUnmounted(() => {
+    if (isRunning.value) {
+      stop()
+    }
+  })
+
+  // 暴露 API
+  defineExpose<CountToExpose>({
+    start,
+    pause,
+    reset,
+    stop,
+    setTarget,
+    get isRunning() {
+      return isRunning.value
+    },
+    get isPaused() {
+      return isPaused.value
+    },
+    get currentValue() {
+      return isPaused.value ? pausedValue.value : transitionValue.value
+    },
+    get targetValue() {
+      return targetValue.value
+    },
+    get progress() {
+      const current = isPaused.value ? pausedValue.value : transitionValue.value
+      const target = targetValue.value
+      if (target === 0) return current === 0 ? 1 : 0
+      return Math.abs(current / target)
+    }
+  })
+</script>
diff --git a/web/src/components/core/text-effect/art-festival-text-scroll/index.vue b/web/src/components/core/text-effect/art-festival-text-scroll/index.vue
new file mode 100644
index 0000000..770b457
--- /dev/null
+++ b/web/src/components/core/text-effect/art-festival-text-scroll/index.vue
@@ -0,0 +1,32 @@
+<!-- 节日文本滚动 -->
+<template>
+  <div
+    class="overflow-hidden transition-[height] duration-600 ease-in-out"
+    :style="{
+      height: showFestivalText ? '48px' : '0'
+    }"
+  >
+    <ArtTextScroll
+      v-if="showFestivalText && currentFestivalData?.scrollText !== ''"
+      :text="currentFestivalData?.scrollText || ''"
+      style="margin-bottom: 12px"
+      showClose
+      @close="handleClose"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useCeremony } from '@/hooks/core/useCeremony'
+
+  defineOptions({ name: 'ArtFestivalTextScroll' })
+
+  const settingStore = useSettingStore()
+  const { showFestivalText } = storeToRefs(settingStore)
+  const { currentFestivalData } = useCeremony()
+
+  const handleClose = () => {
+    settingStore.setShowFestivalText(false)
+  }
+</script>
diff --git a/web/src/components/core/text-effect/art-text-scroll/index.vue b/web/src/components/core/text-effect/art-text-scroll/index.vue
new file mode 100644
index 0000000..90be30f
--- /dev/null
+++ b/web/src/components/core/text-effect/art-text-scroll/index.vue
@@ -0,0 +1,285 @@
+<!-- 文字滚动 -->
+<template>
+  <div
+    ref="containerRef"
+    class="relative overflow-hidden rounded-custom-sm border flex-c box-border text-sm"
+    :class="themeClasses"
+    :style="containerStyle"
+  >
+    <div class="flex-cc absolute left-0 h-full w-9 z-10" :style="{ backgroundColor: bgColor }">
+      <ArtSvgIcon icon="ri:volume-down-line" class="text-lg" />
+    </div>
+
+    <div
+      ref="contentRef"
+      class="whitespace-nowrap inline-block transition-opacity duration-600 [&_a]:text-danger [&_a:hover]:underline [&_a:hover]:text-danger/80 px-9"
+      :class="[contentClass, { 'opacity-0': !isReady, 'opacity-100': isReady }]"
+      :style="contentStyle"
+      @click="handleContentClick"
+    >
+      <!-- 原始内容 -->
+      <span ref="textRef" class="inline-block">
+        <slot>
+          <span v-html="text"></span>
+        </slot>
+      </span>
+      <!-- 克隆内容用于无缝循环 -->
+      <span v-if="shouldClone" class="inline-block" :style="cloneSpacing">
+        <slot>
+          <span v-html="text"></span>
+        </slot>
+      </span>
+    </div>
+
+    <div
+      v-if="showClose"
+      class="flex-cc absolute right-0 h-full w-9 c-p"
+      :style="{ backgroundColor: bgColor }"
+      @click="handleClose"
+    >
+      <ArtSvgIcon icon="ri:close-fill" class="text-lg" />
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import {
+    useElementSize,
+    useRafFn,
+    useElementHover,
+    useDebounceFn,
+    useTimeoutFn
+  } from '@vueuse/core'
+  import { useSettingStore } from '@/store/modules/setting'
+
+  type ThemeType =
+    | 'theme'
+    | 'primary'
+    | 'secondary'
+    | 'error'
+    | 'info'
+    | 'success'
+    | 'warning'
+    | 'danger'
+
+  /**
+   * 文本滚动组件属性接口
+   */
+  export interface TextScrollProps {
+    /** 滚动文本内容 */
+    text?: string
+    /** 主题类型 */
+    type?: ThemeType
+    /** 滚动方向 */
+    direction?: 'left' | 'right' | 'up' | 'down'
+    /** 滚动速度，单位：像素/秒 */
+    speed?: number
+    /** 容器宽度 */
+    width?: string
+    /** 容器高度 */
+    height?: string
+    /** 鼠标悬停时是否暂停滚动 */
+    pauseOnHover?: boolean
+    /** 是否显示关闭按钮 */
+    showClose?: boolean
+    /** 始终滚动（即使文字未溢出） */
+    alwaysScroll?: boolean
+  }
+
+  const props = withDefaults(defineProps<TextScrollProps>(), {
+    text: '',
+    direction: 'left',
+    speed: 80,
+    width: '100%',
+    height: '36px',
+    pauseOnHover: true,
+    type: 'theme',
+    showClose: false,
+    alwaysScroll: true
+  })
+
+  const emit = defineEmits<{
+    close: []
+  }>()
+
+  const handleClose = () => {
+    emit('close')
+  }
+
+  const settingStore = useSettingStore()
+  const { isDark } = storeToRefs(settingStore)
+
+  const containerRef = ref<HTMLElement>()
+  const contentRef = ref<HTMLElement>()
+  const textRef = ref<HTMLElement>()
+  const isReady = ref(false)
+
+  const currentPosition = ref(0)
+  const textSize = ref(0)
+  const containerSize = ref(0)
+  const shouldClone = ref(false)
+
+  const isHorizontal = computed(() => props.direction === 'left' || props.direction === 'right')
+  const isReverse = computed(() => props.direction === 'right' || props.direction === 'down')
+
+  // 使用 VueUse 的 useElementSize 监听容器尺寸变化
+  const { width: containerWidth, height: containerHeight } = useElementSize(containerRef)
+
+  // 使用 VueUse 的 useElementHover 检测鼠标悬停
+  const isHovered = useElementHover(containerRef)
+
+  // 计算是否应该暂停动画
+  const isPaused = computed(() => {
+    // 如果未启用 alwaysScroll，且文字未超出容器，则暂停滚动
+    if (!props.alwaysScroll && textSize.value <= containerSize.value) {
+      return true
+    }
+    return props.pauseOnHover && isHovered.value
+  })
+
+  // 主题样式映射
+  const themeClasses = computed(() => {
+    const themeMap: Record<ThemeType, string> = {
+      theme: 'text-theme/90 !border-theme/50',
+      primary: 'text-primary/90 !border-primary/50',
+      secondary: 'text-secondary/90 !border-secondary/50',
+      error: 'text-error/90 !border-error/50',
+      info: 'text-info/90 !border-info/50',
+      success: 'text-success/90 !border-success/50',
+      warning: 'text-warning/90 !border-warning/50',
+      danger: 'text-danger/90 !border-danger/50'
+    }
+    return themeMap[props.type] || themeMap.theme
+  })
+
+  // 背景色
+  const bgColor = computed(
+    () =>
+      `color-mix(in oklch, var(--color-${props.type}) ${isDark.value ? '25' : '10'}%, var(--art-color))`
+  )
+
+  const containerStyle = computed(() => ({
+    width: props.width,
+    height: props.height,
+    backgroundColor: bgColor.value
+  }))
+
+  const contentClass = computed(() => {
+    if (!isHorizontal.value) {
+      return 'flex flex-col'
+    }
+    return ''
+  })
+
+  const contentStyle = computed(() => {
+    const transform = isHorizontal.value
+      ? `translateX(${currentPosition.value}px)`
+      : `translateY(${currentPosition.value}px)`
+
+    return {
+      transform,
+      willChange: 'transform'
+    }
+  })
+
+  // 克隆元素的间距
+  const cloneSpacing = computed(() => {
+    const spacing = '2em'
+    return isHorizontal.value ? { marginLeft: spacing } : { marginTop: spacing }
+  })
+
+  const measureSizes = () => {
+    if (!containerRef.value || !textRef.value) return
+
+    const text = textRef.value
+
+    if (isHorizontal.value) {
+      containerSize.value = containerWidth.value
+      textSize.value = text.offsetWidth
+    } else {
+      containerSize.value = containerHeight.value
+      textSize.value = text.offsetHeight
+    }
+
+    const isOverflow = textSize.value > containerSize.value
+    shouldClone.value = isOverflow
+
+    // 居中显示
+    currentPosition.value = (containerSize.value - textSize.value) / 2
+
+    // 测量完成后才显示内容
+    if (!isReady.value) {
+      isReady.value = true
+    }
+  }
+
+  // 使用 VueUse 的 useDebounceFn 防抖测量
+  const debouncedMeasure = useDebounceFn(measureSizes, 150)
+
+  let lastTimestamp = 0
+
+  // 使用 VueUse 的 useRafFn 替代手动 requestAnimationFrame
+  const { pause, resume } = useRafFn(
+    ({ timestamp }) => {
+      if (!lastTimestamp) lastTimestamp = timestamp
+
+      if (!isPaused.value) {
+        const delta = (timestamp - lastTimestamp) / 1000
+        const distance = props.speed * delta
+        const spacing = textSize.value * 0.1
+
+        currentPosition.value += isReverse.value ? distance : -distance
+
+        // 循环边界检测
+        if (isReverse.value) {
+          if (currentPosition.value > containerSize.value) {
+            currentPosition.value = -(textSize.value + spacing)
+          }
+        } else {
+          if (currentPosition.value < -(textSize.value + spacing)) {
+            currentPosition.value = containerSize.value
+          }
+        }
+      }
+
+      lastTimestamp = timestamp
+    },
+    { immediate: false }
+  )
+
+  const handleContentClick = (e: MouseEvent) => {
+    const target = e.target as HTMLElement
+    if (target.tagName === 'A') {
+      e.stopPropagation()
+    }
+  }
+
+  // 监听容器尺寸变化
+  watch([containerWidth, containerHeight], () => {
+    debouncedMeasure()
+  })
+
+  // 监听属性变化
+  watch(
+    () => [props.direction, props.speed, props.text],
+    () => {
+      measureSizes()
+      lastTimestamp = 0
+    }
+  )
+
+  // 使用 VueUse 的 useTimeoutFn 替代 setTimeout
+  const { start: startMeasure } = useTimeoutFn(() => {
+    measureSizes()
+    // 测量完成后立即开始动画
+    resume()
+  }, 100)
+
+  onMounted(() => {
+    startMeasure()
+  })
+
+  onBeforeUnmount(() => {
+    pause()
+  })
+</script>
diff --git a/web/src/components/core/theme/theme-svg/index.vue b/web/src/components/core/theme/theme-svg/index.vue
new file mode 100644
index 0000000..0b565a9
--- /dev/null
+++ b/web/src/components/core/theme/theme-svg/index.vue
@@ -0,0 +1,100 @@
+<!-- 一个让 SVG 图片跟随主题的组件，只对特定 svg 图片生效，不建议开发者使用 -->
+<!-- 图片地址 https://iconpark.oceanengine.com/illustrations/13 -->
+<template>
+  <div class="theme-svg" :style="sizeStyle">
+    <div v-if="src" class="svg-container" v-html="svgContent"></div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ref, computed, watchEffect } from 'vue'
+
+  interface Props {
+    size?: string | number
+    themeColor?: string
+    src?: string
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    size: 500,
+    themeColor: 'var(--el-color-primary)'
+  })
+
+  const svgContent = ref('')
+
+  // 计算样式
+  const sizeStyle = computed(() => {
+    const sizeValue = typeof props.size === 'number' ? `${props.size}px` : props.size
+    return {
+      width: sizeValue,
+      height: sizeValue
+    }
+  })
+
+  // 颜色映射配置
+  const COLOR_MAPPINGS = {
+    '#C7DEFF': 'var(--el-color-primary-light-6)',
+    '#071F4D': 'var(--el-color-primary-dark-2)',
+    '#00E4E5': 'var(--el-color-primary-light-1)',
+    '#006EFF': 'var(--el-color-primary)',
+    '#fff': 'var(--default-box-color)',
+    '#ffffff': 'var(--default-box-color)',
+    '#DEEBFC': 'var(--el-color-primary-light-7)'
+  } as const
+
+  // 将主题色应用到 SVG 内容
+  const applyThemeToSvg = (content: string): string => {
+    return Object.entries(COLOR_MAPPINGS).reduce(
+      (processedContent, [originalColor, themeColor]) => {
+        const fillRegex = new RegExp(`fill="${originalColor}"`, 'gi')
+        const strokeRegex = new RegExp(`stroke="${originalColor}"`, 'gi')
+
+        return processedContent
+          .replace(fillRegex, `fill="${themeColor}"`)
+          .replace(strokeRegex, `stroke="${themeColor}"`)
+      },
+      content
+    )
+  }
+
+  // 加载 SVG 文件内容
+  const loadSvgContent = async () => {
+    if (!props.src) {
+      svgContent.value = ''
+      return
+    }
+
+    try {
+      const response = await fetch(props.src)
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`)
+      }
+
+      const content = await response.text()
+      svgContent.value = applyThemeToSvg(content)
+    } catch (error) {
+      console.error('Failed to load SVG:', error)
+      svgContent.value = ''
+    }
+  }
+
+  watchEffect(() => {
+    loadSvgContent()
+  })
+</script>
+
+<style lang="scss" scoped>
+  .theme-svg {
+    display: inline-block;
+
+    .svg-container {
+      width: 100%;
+      height: 100%;
+
+      :deep(svg) {
+        width: 100%;
+        height: 100%;
+      }
+    }
+  }
+</style>
diff --git a/web/src/components/core/views/exception/ArtException.vue b/web/src/components/core/views/exception/ArtException.vue
new file mode 100644
index 0000000..4be59ae
--- /dev/null
+++ b/web/src/components/core/views/exception/ArtException.vue
@@ -0,0 +1,55 @@
+<template>
+  <div class="page-content !border-0 !bg-transparent min-h-screen flex-cc">
+    <div class="flex-cc max-md:!block max-md:text-center">
+      <ThemeSvg :src="data.imgUrl" size="100%" class="!w-100" />
+      <div class="ml-15 w-75 max-md:mx-auto max-md:mt-10 max-md:w-full max-md:text-center">
+        <p class="text-xl leading-7 text-g-600 max-md:text-lg">{{ data.desc }}</p>
+        <ElButton type="primary" size="large" @click="backHome" v-ripple class="mt-5">{{
+          data.btnText
+        }}</ElButton>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useCommon } from '@/hooks/core/useCommon'
+  import { useUserStore } from '@/store/modules/user'
+
+  const router = useRouter()
+  const userStore = useUserStore()
+
+  interface ExceptionData {
+    /** 标题 */
+    title: string
+    /** 描述 */
+    desc: string
+    /** 按钮文本 */
+    btnText: string
+    /** 图片地址 */
+    imgUrl: string
+  }
+
+  withDefaults(
+    defineProps<{
+      data: ExceptionData
+    }>(),
+    {}
+  )
+
+  const { homePath } = useCommon()
+
+  const backHome = () => {
+    const targetHomePath = homePath.value || '/'
+
+    if (!userStore.isLogin) {
+      router.push({
+        name: 'Login',
+        query: { redirect: targetHomePath }
+      })
+      return
+    }
+
+    router.push(targetHomePath)
+  }
+</script>
diff --git a/web/src/components/core/views/login/AuthTopBar.vue b/web/src/components/core/views/login/AuthTopBar.vue
new file mode 100644
index 0000000..9455253
--- /dev/null
+++ b/web/src/components/core/views/login/AuthTopBar.vue
@@ -0,0 +1,149 @@
+<!-- 授权页右上角组件 -->
+<template>
+  <div
+    class="absolute w-full flex-cb top-4.5 z-10 flex-c !justify-end max-[1180px]:!justify-between"
+  >
+    <div class="flex-cc !hidden max-[1180px]:!flex ml-2 max-sm:ml-6">
+      <ArtLogo class="icon" size="46" />
+      <h1 class="text-xl ont-mediumf ml-2">{{ AppConfig.systemInfo.name }}</h1>
+    </div>
+
+    <div class="flex-cc gap-1.5 mr-2 max-sm:mr-5">
+      <div class="color-picker-expandable relative flex-c max-sm:!hidden">
+        <div
+          class="color-dots absolute right-0 rounded-full flex-c gap-2 rounded-5 px-2.5 py-2 pr-9 pl-2.5 opacity-0"
+        >
+          <div
+            v-for="(color, index) in mainColors"
+            :key="color"
+            class="color-dot relative size-5 c-p flex-cc rounded-full opacity-0"
+            :class="{ active: color === systemThemeColor }"
+            :style="{ background: color, '--index': index }"
+            @click="changeThemeColor(color)"
+          >
+            <ArtSvgIcon v-if="color === systemThemeColor" icon="ri:check-fill" class="text-white" />
+          </div>
+        </div>
+        <div class="btn palette-btn relative z-[2] h-8 w-8 c-p flex-cc tad-300">
+          <ArtSvgIcon
+            icon="ri:palette-line"
+            class="text-xl text-g-800 transition-colors duration-300"
+          />
+        </div>
+      </div>
+      <ElDropdown
+        v-if="shouldShowLanguage"
+        @command="changeLanguage"
+        popper-class="langDropDownStyle"
+      >
+        <div class="btn language-btn h-8 w-8 c-p flex-cc tad-300">
+          <ArtSvgIcon
+            icon="ri:translate-2"
+            class="text-[19px] text-g-800 transition-colors duration-300"
+          />
+        </div>
+        <template #dropdown>
+          <ElDropdownMenu>
+            <div v-for="lang in languageOptions" :key="lang.value" class="lang-btn-item">
+              <ElDropdownItem
+                :command="lang.value"
+                :class="{ 'is-selected': locale === lang.value }"
+              >
+                <span class="menu-txt">{{ lang.label }}</span>
+                <ArtSvgIcon icon="ri:check-fill" class="text-base" v-if="locale === lang.value" />
+              </ElDropdownItem>
+            </div>
+          </ElDropdownMenu>
+        </template>
+      </ElDropdown>
+      <div
+        v-if="shouldShowThemeToggle"
+        class="btn theme-btn h-8 w-8 c-p flex-cc tad-300"
+        @click="themeAnimation"
+      >
+        <ArtSvgIcon
+          :icon="isDark ? 'ri:sun-fill' : 'ri:moon-line'"
+          class="text-xl text-g-800 transition-colors duration-300"
+        />
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useI18n } from 'vue-i18n'
+  import { useSettingStore } from '@/store/modules/setting'
+  import { useUserStore } from '@/store/modules/user'
+  import { useHeaderBar } from '@/hooks/core/useHeaderBar'
+  import { themeAnimation } from '@/utils/ui/animation'
+  import { languageOptions } from '@/locales'
+  import { LanguageEnum } from '@/enums/appEnum'
+  import AppConfig from '@/config'
+
+  defineOptions({ name: 'AuthTopBar' })
+
+  const settingStore = useSettingStore()
+  const userStore = useUserStore()
+  const { isDark, systemThemeColor } = storeToRefs(settingStore)
+  const { shouldShowThemeToggle, shouldShowLanguage } = useHeaderBar()
+  const { locale } = useI18n()
+
+  const mainColors = AppConfig.systemMainColor
+  const color = systemThemeColor // css v-bind 使用
+
+  const changeLanguage = (lang: LanguageEnum) => {
+    if (locale.value === lang) return
+    locale.value = lang
+    userStore.setLanguage(lang)
+  }
+
+  const changeThemeColor = (color: string) => {
+    if (systemThemeColor.value === color) return
+    settingStore.setElementTheme(color)
+    settingStore.reload()
+  }
+</script>
+
+<style scoped>
+  .color-dots {
+    pointer-events: none;
+    backdrop-filter: blur(10px);
+    box-shadow: 0 2px 12px var(--art-gray-300);
+    transition:
+      opacity 0.3s ease,
+      transform 0.3s ease;
+    transform: translateX(10px);
+  }
+
+  .color-dot {
+    box-shadow: 0 2px 4px rgb(0 0 0 / 15%);
+    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    transition-delay: calc(var(--index) * 0.05s);
+    transform: translateX(20px) scale(0.8);
+  }
+
+  .color-dot:hover {
+    box-shadow: 0 4px 8px rgb(0 0 0 / 20%);
+    transform: translateX(0) scale(1.1);
+  }
+
+  .color-picker-expandable:hover .color-dots {
+    pointer-events: auto;
+    opacity: 1;
+    transform: translateX(0);
+  }
+
+  .color-picker-expandable:hover .color-dot {
+    opacity: 1;
+    transform: translateX(0) scale(1);
+  }
+
+  .dark .color-dots {
+    background-color: var(--art-gray-200);
+    box-shadow: none;
+  }
+
+  .color-picker-expandable:hover .palette-btn :deep(.art-svg-icon) {
+    color: v-bind(color);
+  }
+</style>
diff --git a/web/src/components/core/views/login/LoginLeftView.vue b/web/src/components/core/views/login/LoginLeftView.vue
new file mode 100644
index 0000000..af6a904
--- /dev/null
+++ b/web/src/components/core/views/login/LoginLeftView.vue
@@ -0,0 +1,602 @@
+<!-- 登录、注册、忘记密码左侧背景 -->
+<template>
+  <div class="login-left-view">
+    <div class="logo">
+      <ArtLogo class="icon" size="46" />
+      <h1 class="title">{{ AppConfig.systemInfo.name }}</h1>
+    </div>
+
+    <div class="left-img">
+      <ThemeSvg :src="loginIcon" size="100%" />
+    </div>
+
+    <div class="text-wrap">
+      <h1> {{ $t('login.leftView.title') }} </h1>
+      <p> {{ $t('login.leftView.subTitle') }} </p>
+    </div>
+
+    <!-- 几何装饰元素 -->
+    <div class="geometric-decorations">
+      <!-- 基础几何形状 -->
+      <div class="geo-element circle-outline animate-fade-in-up" style="animation-delay: 0s"></div>
+      <div
+        class="geo-element square-rotated animate-fade-in-left"
+        style="animation-delay: 0s"
+      ></div>
+      <div class="geo-element circle-small animate-fade-in-up" style="animation-delay: 0.3s"></div>
+
+      <div
+        class="geo-element square-bottom-right animate-fade-in-right"
+        style="animation-delay: 0s"
+      ></div>
+
+      <!-- 背景泡泡 -->
+      <div class="geo-element bg-bubble animate-scale-in" style="animation-delay: 0.5"></div>
+
+      <!-- 太阳/月亮 -->
+      <div
+        class="geo-element circle-top-right animate-fade-in-down"
+        style="animation-delay: 0.5"
+        @click="themeAnimation"
+      ></div>
+
+      <!-- 装饰点 -->
+      <div class="geo-element dot dot-top-left animate-bounce-in" style="animation-delay: 0s"></div>
+      <div
+        class="geo-element dot dot-top-right animate-bounce-in"
+        style="animation-delay: 0s"
+      ></div>
+      <div
+        class="geo-element dot dot-center-right animate-bounce-in"
+        style="animation-delay: 0s"
+      ></div>
+
+      <!-- 叠加方块组 -->
+      <div class="squares-group">
+        <i
+          class="geo-element square square-blue animate-fade-in-left-rotated-blue"
+          style="animation-delay: 0.2s"
+        ></i>
+        <i
+          class="geo-element square square-pink animate-fade-in-left-rotated-pink"
+          style="animation-delay: 0.4s"
+        ></i>
+        <i
+          class="geo-element square square-purple animate-fade-in-left-no-rotation"
+          style="animation-delay: 0.6s"
+        ></i>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import AppConfig from '@/config'
+  import loginIcon from '@imgs/svg/login_icon.svg'
+  import { themeAnimation } from '@/utils/ui/animation'
+
+  // 定义 props
+  defineProps<{
+    hideContent?: boolean // 是否隐藏内容，只显示 logo
+  }>()
+</script>
+
+<style lang="scss" scoped>
+  // 颜色变量定义
+  $primary-light-7: var(--el-color-primary-light-7);
+  $primary-light-8: var(--el-color-primary-light-8);
+  $primary-light-9: var(--el-color-primary-light-9);
+  $primary-base: var(--el-color-primary);
+  $main-bg: var(--default-box-color);
+
+  // 混合颜色函数
+  $bg-mix-light-9: color-mix(in srgb, $primary-light-9 100%, $main-bg);
+  $bg-mix-light-8: color-mix(in srgb, $primary-light-8 80%, $main-bg);
+  $bg-mix-light-7: color-mix(in srgb, $primary-light-7 80%, $main-bg);
+
+  .login-left-view {
+    position: relative;
+    box-sizing: border-box;
+    width: 65vw;
+    height: 100%;
+    padding: 15px;
+    overflow: hidden;
+    background-color: $bg-mix-light-9;
+
+    .logo {
+      position: relative;
+      z-index: 100;
+      display: flex;
+      align-items: center;
+
+      .title {
+        margin-left: 10px;
+        font-size: 20px;
+        font-weight: 400;
+      }
+    }
+
+    .left-img {
+      position: absolute;
+      inset: 0 0 10.5%;
+      z-index: 10;
+      width: 40%;
+      margin: auto;
+      animation: slideInLeft 0.6s cubic-bezier(0.25, 0.46, 0.45, 0.94) forwards;
+    }
+
+    .text-wrap {
+      position: absolute;
+      bottom: 80px;
+      width: 100%;
+      text-align: center;
+      animation: slideInLeft 0.6s cubic-bezier(0.25, 0.46, 0.45, 0.94) forwards;
+
+      h1 {
+        font-size: 24px;
+        font-weight: 400;
+        color: var(--art-gray-900) !important;
+      }
+
+      p {
+        margin-top: 10px;
+        font-size: 14px;
+        color: var(--art-gray-600) !important;
+      }
+    }
+
+    .geometric-decorations {
+      .geo-element {
+        position: absolute;
+        opacity: 0;
+        animation-fill-mode: forwards;
+        animation-duration: 0.8s;
+        animation-timing-function: cubic-bezier(0.25, 0.46, 0.45, 0.94);
+      }
+
+      // 动画 mixin
+      @mixin fadeAnimation($direction: '', $rotation: 0deg) {
+        from {
+          opacity: 0;
+
+          @if $direction == 'up' {
+            transform: translateY(30px) rotate($rotation);
+          } @else if $direction == 'down' {
+            transform: translateY(-30px) rotate($rotation);
+          } @else if $direction == 'left' {
+            transform: translateX(-30px) rotate($rotation);
+          } @else if $direction == 'right' {
+            transform: translateX(30px) rotate($rotation);
+          }
+        }
+
+        to {
+          opacity: 1;
+
+          @if $direction == 'up' or $direction == 'down' {
+            transform: translateY(0) rotate($rotation);
+          } @else {
+            transform: translateX(0) rotate($rotation);
+          }
+        }
+      }
+
+      // 动画定义
+      @keyframes fadeInUp {
+        @include fadeAnimation('up');
+      }
+
+      @keyframes fadeInDown {
+        @include fadeAnimation('down');
+      }
+
+      @keyframes fadeInLeft {
+        @include fadeAnimation('left');
+      }
+
+      @keyframes fadeInLeftRotated {
+        @include fadeAnimation('left', -25deg);
+      }
+
+      @keyframes fadeInRight {
+        @include fadeAnimation('right');
+      }
+
+      @keyframes fadeInRightRotated {
+        @include fadeAnimation('right', 45deg);
+      }
+
+      @keyframes fadeInLeftRotatedBlue {
+        @include fadeAnimation('left', -10deg);
+      }
+
+      @keyframes fadeInLeftRotatedPink {
+        @include fadeAnimation('left', 10deg);
+      }
+
+      @keyframes fadeInLeftNoRotation {
+        @include fadeAnimation('left');
+      }
+
+      @keyframes scaleIn {
+        from {
+          opacity: 0;
+          transform: scale(0.8);
+        }
+
+        to {
+          opacity: 1;
+          transform: scale(1);
+        }
+      }
+
+      @keyframes bounceIn {
+        0% {
+          opacity: 0;
+          transform: scale(0.3);
+        }
+
+        50% {
+          opacity: 1;
+          transform: scale(1.05);
+        }
+
+        70% {
+          transform: scale(0.9);
+        }
+
+        100% {
+          opacity: 1;
+          transform: scale(1);
+        }
+      }
+
+      @keyframes lineGrow {
+        from {
+          opacity: 0;
+        }
+
+        to {
+          opacity: 1;
+        }
+      }
+
+      @keyframes slideInLeft {
+        from {
+          opacity: 0;
+          transform: translateX(-30px);
+        }
+
+        to {
+          opacity: 1;
+          transform: translateX(0);
+        }
+      }
+
+      // 动画类
+      .animate-fade-in-up {
+        animation-name: fadeInUp;
+      }
+
+      .animate-fade-in-down {
+        animation-name: fadeInDown;
+      }
+
+      .animate-fade-in-left {
+        animation-name: fadeInLeft;
+      }
+
+      .animate-fade-in-right {
+        animation-name: fadeInRight;
+      }
+
+      .animate-scale-in {
+        animation-name: scaleIn;
+        animation-duration: 1.2s;
+      }
+
+      .animate-bounce-in {
+        animation-name: bounceIn;
+        animation-duration: 0.6s;
+      }
+
+      .animate-fade-in-left-rotated-blue {
+        animation-name: fadeInLeftRotatedBlue;
+      }
+
+      .animate-fade-in-left-rotated-pink {
+        animation-name: fadeInLeftRotatedPink;
+      }
+
+      .animate-fade-in-left-no-rotation {
+        animation-name: fadeInLeftNoRotation;
+      }
+
+      // 基础几何形状
+      .circle-outline {
+        top: 10%;
+        left: 25%;
+        width: 42px;
+        height: 42px;
+        border: 2px solid $primary-light-8;
+        border-radius: 50%;
+      }
+
+      .square-rotated {
+        top: 50%;
+        left: 16%;
+        width: 60px;
+        height: 60px;
+        background-color: $bg-mix-light-8;
+
+        &.animate-fade-in-left {
+          animation-name: fadeInLeftRotated;
+        }
+      }
+
+      .circle-small {
+        bottom: 26%;
+        left: 30%;
+        width: 18px;
+        height: 18px;
+        background-color: $primary-light-8;
+        border-radius: 50%;
+      }
+
+      // 太阳/月亮效果
+      .circle-top-right {
+        top: 3%;
+        right: 3%;
+        z-index: 100;
+        width: 50px;
+        height: 50px;
+        cursor: pointer;
+        background: $bg-mix-light-7;
+        border-radius: 50%;
+        transition: all 0.3s;
+
+        &::after {
+          position: absolute;
+          top: 50%;
+          left: 50%;
+          width: 100%;
+          height: 100%;
+          content: '';
+          background: linear-gradient(to right, #fcbb04, #fffc00);
+          border-radius: 50%;
+          opacity: 0;
+          transition: all 0.5s;
+          transform: translate(-50%, -50%);
+        }
+
+        &:hover {
+          box-shadow: 0 0 36px #fffc00;
+
+          &::after {
+            opacity: 1;
+          }
+        }
+      }
+
+      .square-bottom-right {
+        right: 10%;
+        bottom: 10%;
+        width: 50px;
+        height: 50px;
+        background-color: $primary-light-8;
+
+        &.animate-fade-in-right {
+          animation-name: fadeInRightRotated;
+        }
+      }
+
+      // 背景泡泡
+      .bg-bubble {
+        top: -120px;
+        right: -120px;
+        width: 360px;
+        height: 360px;
+        background-color: $bg-mix-light-8;
+        border-radius: 50%;
+      }
+
+      // 装饰点
+      .dot {
+        width: 14px;
+        height: 14px;
+        background-color: $primary-light-7;
+        border-radius: 50%;
+
+        &.dot-top-left {
+          top: 140px;
+          left: 100px;
+        }
+
+        &.dot-top-right {
+          top: 140px;
+          right: 120px;
+        }
+
+        &.dot-center-right {
+          top: 46%;
+          right: 22%;
+          background-color: $primary-light-8;
+        }
+      }
+
+      // 叠加方块组
+      .squares-group {
+        position: absolute;
+        bottom: 18px;
+        left: 20px;
+        width: 140px;
+        height: 140px;
+        pointer-events: none;
+
+        .square {
+          position: absolute;
+          display: block;
+          border-radius: 8px;
+          box-shadow: 0 8px 24px rgb(64 87 167 / 12%);
+
+          &.square-blue {
+            top: 12px;
+            left: 30px;
+            z-index: 2;
+            width: 50px;
+            height: 50px;
+            background-color: rgb(from $primary-base r g b / 30%);
+          }
+
+          &.square-pink {
+            top: 30px;
+            left: 48px;
+            z-index: 1;
+            width: 70px;
+            height: 70px;
+            background-color: rgb(from $primary-base r g b / 15%);
+          }
+
+          &.square-purple {
+            top: 66px;
+            left: 86px;
+            z-index: 3;
+            width: 32px;
+            height: 32px;
+            background-color: rgb(from $primary-base r g b / 45%);
+          }
+        }
+
+        // 装饰线条
+        &::after {
+          position: absolute;
+          top: 86px;
+          left: 72px;
+          width: 80px;
+          height: 1px;
+          content: '';
+          background: linear-gradient(90deg, var(--el-color-primary-light-6), transparent);
+          opacity: 0;
+          transform: rotate(50deg);
+          animation: lineGrow 0.8s cubic-bezier(0.25, 0.46, 0.45, 0.94) forwards;
+          animation-delay: 1.2s;
+        }
+      }
+    }
+
+    @media only screen and (width <= 1600px) {
+      width: 60vw;
+
+      .text-wrap {
+        bottom: 40px;
+      }
+    }
+
+    @media only screen and (width <= 1180px) {
+      width: auto;
+      height: auto;
+      padding: 0;
+      // 隐藏背景和其他内容，只保留 logo
+      background: transparent;
+
+      .left-img,
+      .text-wrap,
+      .geometric-decorations {
+        display: none;
+      }
+
+      .logo {
+        display: none;
+      }
+    }
+  }
+
+  // 暗色主题
+  .dark .login-left-view {
+    background-color: color-mix(in srgb, $primary-light-9 60%, #070707);
+
+    @media only screen and (width <= 1180px) {
+      background: transparent;
+    }
+
+    .geometric-decorations {
+      // 月亮效果
+      .circle-top-right {
+        background-color: $bg-mix-light-8;
+        box-shadow: 0 0 25px #333 inset;
+        transition: all 0.3s ease-in-out 0.1s;
+        rotate: -48deg;
+
+        &::before {
+          position: absolute;
+          top: 0;
+          left: 15px;
+          width: 50px;
+          height: 50px;
+          content: '';
+          background-color: $bg-mix-light-9;
+          border-radius: 50%;
+          transition: all 0.3s ease-in-out;
+        }
+
+        &:hover {
+          background-color: transparent;
+          box-shadow: 0 40px 25px #ddd inset;
+
+          &::before {
+            left: 18px;
+          }
+
+          &::after {
+            opacity: 0;
+          }
+        }
+      }
+
+      .bg-bubble {
+        background-color: $bg-mix-light-9;
+      }
+
+      // 其他元素颜色调整
+      .square-rotated {
+        background-color: $bg-mix-light-9;
+      }
+
+      .circle-small,
+      .dot {
+        background-color: $primary-light-8;
+      }
+
+      .square-bottom-right {
+        background-color: $primary-light-9;
+      }
+
+      .dot.dot-top-right {
+        background-color: $primary-light-8;
+      }
+    }
+
+    // 方块组暗色调整
+    .squares-group {
+      .square {
+        box-shadow: none;
+
+        &.square-blue {
+          background-color: rgb(from $primary-base r g b / 18%);
+        }
+
+        &.square-pink {
+          background-color: rgb(from $primary-base r g b / 10%);
+        }
+
+        &.square-purple {
+          background-color: rgb(from $primary-base r g b / 20%);
+        }
+      }
+
+      &::after {
+        background: linear-gradient(90deg, $primary-light-8, transparent);
+      }
+    }
+  }
+</style>
diff --git a/web/src/components/core/views/result/ArtResultPage.vue b/web/src/components/core/views/result/ArtResultPage.vue
new file mode 100644
index 0000000..b2eca48
--- /dev/null
+++ b/web/src/components/core/views/result/ArtResultPage.vue
@@ -0,0 +1,43 @@
+<template>
+  <div class="page-content box-border !px-20 py-3.5 text-center max-md:!px-5" :class="type">
+    <ArtSvgIcon
+      class="icon size-22 p-2 mt-16 block rounded-full !text-white"
+      :icon="iconCode"
+      :class="type === 'success' ? 'bg-[#19BE6B]' : 'bg-[#ED4014]'"
+    />
+    <h1 class="title mt-8 text-3xl font-medium !text-g-900 max-md:mt-2.5 max-md:text-2xl">{{
+      title
+    }}</h1>
+    <p class="msg mt-5 text-base text-g-600">{{ message }}</p>
+    <div
+      class="res mt-7.5 rounded bg-g-200/80 dark:bg-g-300/40 px-7.5 py-5.5 text-left max-md:px-7.5 max-md:py-2.5 [&_p]:flex [&_p]:items-center [&_p]:py-2 [&_p]:text-sm [&_p]:text-[#808695] [&_p_i]:mr-1.5"
+    >
+      <slot name="content"></slot>
+    </div>
+    <div class="btn-group mt-12.5">
+      <slot name="buttons"></slot>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ArtResultPage' })
+
+  interface ResultPageProps {
+    /** 成功/失败 */
+    type: 'success' | 'fail'
+    /** 标题 */
+    title: string
+    /** 消息 */
+    message: string
+    /** 图标 */
+    iconCode: string
+  }
+
+  withDefaults(defineProps<ResultPageProps>(), {
+    type: 'success',
+    title: '',
+    message: '',
+    iconCode: ''
+  })
+</script>
diff --git a/web/src/components/core/widget/art-icon-button/index.vue b/web/src/components/core/widget/art-icon-button/index.vue
new file mode 100644
index 0000000..760888b
--- /dev/null
+++ b/web/src/components/core/widget/art-icon-button/index.vue
@@ -0,0 +1,23 @@
+<!-- 按钮组件 -->
+<template>
+  <div
+    class="size-8.5 inline-flex flex-cc c-p text-g-600 dark:text-g-800 text-xl rounded tad-300 hover:bg-hover-color"
+    :class="{ 'rounded-full': circle }"
+  >
+    <ArtSvgIcon :icon="icon"></ArtSvgIcon>
+    <slot></slot>
+  </div>
+</template>
+
+<script lang="ts" setup>
+  defineOptions({ name: 'ArtIconButton' })
+
+  interface Props {
+    /** 图标名称 */
+    icon: string
+    /** 圆角按钮 */
+    circle?: boolean
+  }
+
+  withDefaults(defineProps<Props>(), {})
+</script>
diff --git a/web/src/config/assets/images.ts b/web/src/config/assets/images.ts
new file mode 100644
index 0000000..f3e89dd
--- /dev/null
+++ b/web/src/config/assets/images.ts
@@ -0,0 +1,61 @@
+/**
+ * 配置图片资源
+ *
+ * 统一管理设置中心使用的预览图片资源。
+ * 包含主题样式、菜单布局、菜单风格的预览图。
+ *
+ * ## 图片分类
+ *
+ * - themeStyles: 系统主题预览图（亮色/暗色/自动）
+ * - menuLayouts: 菜单布局预览图（左侧/顶部/混合/双栏）
+ * - menuStyles: 菜单风格预览图（设计/暗色/亮色）
+ *
+ * @module config/assets/images
+ * @author Art Design Pro Team
+ */
+
+import lightTheme from '@imgs/settings/theme_styles/light.png'
+import darkTheme from '@imgs/settings/theme_styles/dark.png'
+import systemTheme from '@imgs/settings/theme_styles/system.png'
+import verticalLayout from '@imgs/settings/menu_layouts/vertical.png'
+import horizontalLayout from '@imgs/settings/menu_layouts/horizontal.png'
+import mixedLayout from '@imgs/settings/menu_layouts/mixed.png'
+import dualColumnLayout from '@imgs/settings/menu_layouts/dual_column.png'
+import designStyle from '@imgs/settings/menu_styles/design.png'
+import darkStyle from '@imgs/settings/menu_styles/dark.png'
+import lightStyle from '@imgs/settings/menu_styles/light.png'
+
+/**
+ * 配置中心图片资源对象
+ */
+export const configImages = {
+  /** 系统主题预览图 */
+  themeStyles: {
+    /** 亮色主题 */
+    light: lightTheme,
+    /** 暗色主题 */
+    dark: darkTheme,
+    /** 自动主题（跟随系统） */
+    system: systemTheme
+  },
+  /** 菜单布局预览图 */
+  menuLayouts: {
+    /** 左侧菜单 */
+    vertical: verticalLayout,
+    /** 顶部菜单 */
+    horizontal: horizontalLayout,
+    /** 混合菜单 */
+    mixed: mixedLayout,
+    /** 双栏菜单 */
+    dualColumn: dualColumnLayout
+  },
+  /** 菜单风格预览图 */
+  menuStyles: {
+    /** 设计风格 */
+    design: designStyle,
+    /** 暗色风格 */
+    dark: darkStyle,
+    /** 亮色风格 */
+    light: lightStyle
+  }
+}
diff --git a/web/src/config/fastEnter.ts b/web/src/config/fastEnter.ts
new file mode 100644
index 0000000..ccade16
--- /dev/null
+++ b/web/src/config/fastEnter.ts
@@ -0,0 +1,79 @@
+/**
+ * 快速入口配置
+ * 包含：应用列表、快速链接等配置
+ */
+import { WEB_LINKS } from '@/utils/constants'
+import type { FastEnterConfig } from '@/types/config'
+
+const fastEnterConfig: FastEnterConfig = {
+  // 显示条件（屏幕宽度）
+  minWidth: 1200,
+  // 应用列表
+  applications: [
+    {
+      name: '工作台',
+      description: '系统概览与数据统计',
+      icon: 'ri:pie-chart-line',
+      iconColor: '#377dff',
+      enabled: true,
+      order: 1,
+      routeName: 'Console'
+    },
+    {
+      name: '官方文档',
+      description: '使用指南与开发文档',
+      icon: 'ri:bill-line',
+      iconColor: '#ffb100',
+      enabled: true,
+      order: 2,
+      link: WEB_LINKS.DOCS
+    },
+    {
+      name: '技术支持',
+      description: '技术支持与问题反馈',
+      icon: 'ri:user-location-line',
+      iconColor: '#ff6b6b',
+      enabled: true,
+      order: 3,
+      link: WEB_LINKS.COMMUNITY
+    },
+    {
+      name: '哔哩哔哩',
+      description: '技术分享与交流',
+      icon: 'ri:bilibili-line',
+      iconColor: '#FB7299',
+      enabled: true,
+      order: 4,
+      link: WEB_LINKS.BILIBILI
+    }
+  ],
+  // 快速链接
+  quickLinks: [
+    {
+      name: '登录',
+      enabled: true,
+      order: 1,
+      routeName: 'Login'
+    },
+    {
+      name: '注册',
+      enabled: true,
+      order: 2,
+      routeName: 'Register'
+    },
+    {
+      name: '忘记密码',
+      enabled: true,
+      order: 3,
+      routeName: 'ForgetPassword'
+    },
+    {
+      name: '个人中心',
+      enabled: true,
+      order: 4,
+      routeName: 'UserCenter'
+    }
+  ]
+}
+
+export default Object.freeze(fastEnterConfig)
diff --git a/web/src/config/index.ts b/web/src/config/index.ts
new file mode 100644
index 0000000..daa623a
--- /dev/null
+++ b/web/src/config/index.ts
@@ -0,0 +1,135 @@
+/**
+ * 系统全局配置
+ *
+ * 这是系统的核心配置文件，集中管理所有全局配置项。
+ * 包含系统信息、主题样式、菜单布局、颜色方案等所有可配置项。
+ *
+ * ## 主要功能
+ *
+ * - 系统信息 - 系统名称等基础信息
+ * - 主题配置 - 亮色/暗色/自动主题的样式配置
+ * - 菜单配置 - 菜单布局、主题、宽度等配置
+ * - 颜色方案 - 系统主色和预设颜色列表
+ * - 快速入口 - 快速入口应用和链接配置
+ * - 顶部栏配置 - 顶部栏功能模块配置
+ *
+ * ## 配置项说明
+ *
+ * - systemInfo: 系统基础信息（名称等）
+ * - systemThemeStyles: 系统主题样式映射
+ * - settingThemeList: 可选的系统主题列表
+ * - menuLayoutList: 可选的菜单布局列表
+ * - themeList: 菜单主题样式列表
+ * - darkMenuStyles: 暗黑模式下的菜单样式
+ * - systemMainColor: 预设的系统主色列表
+ * - fastEnter: 快速入口配置
+ * - headerBar: 顶部栏功能配置
+ *
+ * @module config
+ * @author Art Design Pro Team
+ */
+
+import { MenuThemeEnum, MenuTypeEnum, SystemThemeEnum } from '@/enums/appEnum'
+import { SystemConfig } from '@/types/config'
+import { configImages } from './assets/images'
+import fastEnterConfig from './modules/fastEnter'
+import { headerBarConfig } from './modules/headerBar'
+
+const appConfig: SystemConfig = {
+  // 系统信息
+  systemInfo: {
+    name: 'Art Design Pro' // 系统名称
+  },
+  // 系统主题
+  systemThemeStyles: {
+    [SystemThemeEnum.LIGHT]: { className: '' },
+    [SystemThemeEnum.DARK]: { className: SystemThemeEnum.DARK }
+  },
+  // 系统主题列表
+  settingThemeList: [
+    {
+      name: 'Light',
+      theme: SystemThemeEnum.LIGHT,
+      color: ['#fff', '#fff'],
+      leftLineColor: '#EDEEF0',
+      rightLineColor: '#EDEEF0',
+      img: configImages.themeStyles.light
+    },
+    {
+      name: 'Dark',
+      theme: SystemThemeEnum.DARK,
+      color: ['#22252A'],
+      leftLineColor: '#3F4257',
+      rightLineColor: '#3F4257',
+      img: configImages.themeStyles.dark
+    },
+    {
+      name: 'System',
+      theme: SystemThemeEnum.AUTO,
+      color: ['#fff', '#22252A'],
+      leftLineColor: '#EDEEF0',
+      rightLineColor: '#3F4257',
+      img: configImages.themeStyles.system
+    }
+  ],
+  // 菜单布局列表
+  menuLayoutList: [
+    { name: 'Left', value: MenuTypeEnum.LEFT, img: configImages.menuLayouts.vertical },
+    { name: 'Top', value: MenuTypeEnum.TOP, img: configImages.menuLayouts.horizontal },
+    { name: 'Mixed', value: MenuTypeEnum.TOP_LEFT, img: configImages.menuLayouts.mixed },
+    { name: 'Dual Column', value: MenuTypeEnum.DUAL_MENU, img: configImages.menuLayouts.dualColumn }
+  ],
+  // 菜单主题列表
+  themeList: [
+    {
+      theme: MenuThemeEnum.DESIGN,
+      background: '#FFFFFF',
+      systemNameColor: 'var(--art-gray-800)',
+      iconColor: '#6B6B6B',
+      textColor: '#29343D',
+      img: configImages.menuStyles.design
+    },
+    {
+      theme: MenuThemeEnum.DARK,
+      background: '#191A23',
+      systemNameColor: '#D9DADB',
+      iconColor: '#BABBBD',
+      textColor: '#BABBBD',
+      img: configImages.menuStyles.dark
+    },
+    {
+      theme: MenuThemeEnum.LIGHT,
+      background: '#ffffff',
+      systemNameColor: 'var(--art-gray-800)',
+      iconColor: '#6B6B6B',
+      textColor: '#29343D',
+      img: configImages.menuStyles.light
+    }
+  ],
+  // 暗黑模式菜单样式
+  darkMenuStyles: [
+    {
+      theme: MenuThemeEnum.DARK,
+      background: 'var(--default-box-color)',
+      systemNameColor: '#DDDDDD',
+      iconColor: '#BABBBD',
+      textColor: 'rgba(#FFFFFF, 0.7)'
+    }
+  ],
+  // 系统主色
+  systemMainColor: [
+    '#5D87FF',
+    '#B48DF3',
+    '#1D84FF',
+    '#60C041',
+    '#38C0FC',
+    '#F9901F',
+    '#FF80C8'
+  ] as const,
+  // 快速入口配置
+  fastEnter: fastEnterConfig,
+  // 顶部栏功能配置
+  headerBar: headerBarConfig
+}
+
+export default Object.freeze(appConfig)
diff --git a/web/src/config/modules/component.ts b/web/src/config/modules/component.ts
new file mode 100644
index 0000000..bc709e0
--- /dev/null
+++ b/web/src/config/modules/component.ts
@@ -0,0 +1,105 @@
+/**
+ * 全局组件配置
+ *
+ * 统一管理系统级全局组件的注册。
+ * 这些组件会在应用启动时全局注册，可在任何地方使用。
+ *
+ * ## 主要功能
+ *
+ * - 组件配置 - 集中管理全局组件的配置信息
+ * - 异步加载 - 使用 defineAsyncComponent 实现按需加载
+ * - 开关控制 - 支持通过 enabled 字段启用/禁用组件
+ * - 配置查询 - 提供工具函数快速查询组件配置
+ *
+ * @module config/component
+ * @author Art Design Pro Team
+ */
+
+import { defineAsyncComponent } from 'vue'
+
+/**
+ * 全局组件配置列表
+ */
+export const globalComponentsConfig: GlobalComponentConfig[] = [
+  {
+    name: '设置面板',
+    key: 'settings-panel',
+    component: defineAsyncComponent(
+      () => import('@/components/core/layouts/art-settings-panel/index.vue')
+    ),
+    enabled: true
+  },
+  {
+    name: '全局搜索',
+    key: 'global-search',
+    component: defineAsyncComponent(
+      () => import('@/components/core/layouts/art-global-search/index.vue')
+    ),
+    enabled: true
+  },
+  {
+    name: '锁屏',
+    key: 'screen-lock',
+    component: defineAsyncComponent(
+      () => import('@/components/core/layouts/art-screen-lock/index.vue')
+    ),
+    enabled: true
+  },
+  {
+    name: '聊天窗口',
+    key: 'chat-window',
+    component: defineAsyncComponent(
+      () => import('@/components/core/layouts/art-chat-window/index.vue')
+    ),
+    enabled: true
+  },
+  {
+    name: '礼花效果',
+    key: 'fireworks-effect',
+    component: defineAsyncComponent(
+      () => import('@/components/core/layouts/art-fireworks-effect/index.vue')
+    ),
+    enabled: true
+  },
+  {
+    name: '水印效果',
+    key: 'watermark',
+    component: defineAsyncComponent(
+      () => import('@/components/core/others/art-watermark/index.vue')
+    ),
+    enabled: true
+  }
+]
+
+/**
+ * 全局组件配置接口
+ */
+export interface GlobalComponentConfig {
+  /** 组件名称 */
+  name: string
+  /** 组件标识 */
+  key: string
+  /** 组件 */
+  component: any
+  /** 是否启用 */
+  enabled?: boolean
+  /** 组件描述 */
+  description?: string
+}
+
+/**
+ * 获取启用的全局组件
+ * @returns 已启用的组件配置列表
+ */
+export const getEnabledGlobalComponents = () => {
+  return globalComponentsConfig.filter((config) => config.enabled !== false)
+}
+
+/**
+ * 根据 key 获取组件配置
+ * @param key 组件标识
+ * @returns 组件配置对象
+ */
+export const getGlobalComponentByKey = (key: string) => {
+  return globalComponentsConfig.find((config) => config.key === key)
+}
diff --git a/web/src/config/modules/fastEnter.ts b/web/src/config/modules/fastEnter.ts
new file mode 100644
index 0000000..6b9740c
--- /dev/null
+++ b/web/src/config/modules/fastEnter.ts
@@ -0,0 +1,127 @@
+/**
+ * 快速入口配置
+ * 包含：应用列表、快速链接等配置
+ */
+import { WEB_LINKS } from '@/utils/constants'
+import type { FastEnterConfig } from '@/types/config'
+
+const fastEnterConfig: FastEnterConfig = {
+  // 显示条件（屏幕宽度）
+  minWidth: 1200,
+  // 应用列表
+  applications: [
+    {
+      name: '工作台',
+      description: '系统概览与数据统计',
+      icon: 'ri:pie-chart-line',
+      iconColor: '#377dff',
+      enabled: true,
+      order: 1,
+      routeName: 'Console'
+    },
+    {
+      name: '分析页',
+      description: '数据分析与可视化',
+      icon: 'ri:game-line',
+      iconColor: '#ff3b30',
+      enabled: true,
+      order: 2,
+      routeName: 'Analysis'
+    },
+    {
+      name: '礼花效果',
+      description: '动画特效展示',
+      icon: 'ri:loader-line',
+      iconColor: '#7A7FFF',
+      enabled: true,
+      order: 3,
+      routeName: 'Fireworks'
+    },
+    {
+      name: '聊天',
+      description: '即时通讯功能',
+      icon: 'ri:user-line',
+      iconColor: '#13DEB9',
+      enabled: true,
+      order: 4,
+      routeName: 'Chat'
+    },
+    {
+      name: '官方文档',
+      description: '使用指南与开发文档',
+      icon: 'ri:bill-line',
+      iconColor: '#ffb100',
+      enabled: true,
+      order: 5,
+      link: WEB_LINKS.DOCS
+    },
+    {
+      name: '技术支持',
+      description: '技术支持与问题反馈',
+      icon: 'ri:user-location-line',
+      iconColor: '#ff6b6b',
+      enabled: true,
+      order: 6,
+      link: WEB_LINKS.COMMUNITY
+    },
+    {
+      name: '更新日志',
+      description: '版本更新与变更记录',
+      icon: 'ri:gamepad-line',
+      iconColor: '#38C0FC',
+      enabled: true,
+      order: 7,
+      routeName: 'ChangeLog'
+    },
+    {
+      name: '哔哩哔哩',
+      description: '技术分享与交流',
+      icon: 'ri:bilibili-line',
+      iconColor: '#FB7299',
+      enabled: true,
+      order: 8,
+      link: WEB_LINKS.BILIBILI
+    }
+  ],
+  // 快速链接
+  quickLinks: [
+    {
+      name: '登录',
+      enabled: true,
+      order: 1,
+      routeName: 'Login'
+    },
+    {
+      name: '注册',
+      enabled: true,
+      order: 2,
+      routeName: 'Register'
+    },
+    {
+      name: '忘记密码',
+      enabled: true,
+      order: 3,
+      routeName: 'ForgetPassword'
+    },
+    {
+      name: '定价',
+      enabled: true,
+      order: 4,
+      routeName: 'Pricing'
+    },
+    {
+      name: '个人中心',
+      enabled: true,
+      order: 5,
+      routeName: 'UserCenter'
+    },
+    {
+      name: '留言管理',
+      enabled: true,
+      order: 6,
+      routeName: 'ArticleComment'
+    }
+  ]
+}
+
+export default Object.freeze(fastEnterConfig)
diff --git a/web/src/config/modules/festival.ts b/web/src/config/modules/festival.ts
new file mode 100644
index 0000000..39cd790
--- /dev/null
+++ b/web/src/config/modules/festival.ts
@@ -0,0 +1,51 @@
+/**
+ * 节日庆祝配置
+ *
+ * 配置系统的节日烟花效果和祝福文本。
+ * 支持单日节日和跨日期节日，可自定义烟花播放次数。
+ *
+ * ## 配置说明
+ *
+ * - name: 节日名称
+ * - date: 节日开始日期（格式：YYYY-MM-DD）
+ * - endDate: 节日结束日期（可选，用于跨日期节日）
+ * - image: 烟花图片（需要预先导入）
+ * - scrollText: 滚动显示的祝福文本
+ * - count: 烟花播放次数（可选，默认为 3 次）
+ *
+ * ## 注意事项
+ *
+ * - 图片需要预先导入并在配置中引用
+ * - 跨日期节日会在整个日期范围内生效
+ * - 每个用户每天只会播放一次烟花效果
+ *
+ * @module config/modules/festival
+ * @author Art Design Pro Team
+ */
+
+import { FestivalConfig } from '@/types/config'
+
+// 导入烟花图片（根据需要取消注释）
+// import sd from '@imgs/ceremony/sd.png'
+// import yd from '@imgs/ceremony/yd.png'
+
+export const festivalConfigList: FestivalConfig[] = [
+  // 跨日期示例
+  // {
+  //   name: 'v3.0 Sass 升级至 TailwindCSS',
+  //   date: '2025-11-03',
+  //   endDate: '2025-11-09',
+  //   image: '',
+  //   count: 3,
+  //   scrollText:
+  //     '🚀 系统 v3.0 测试阶段正式开启！测试周期为 11 月 3 日 - 11 月 16 日，通过 TailwindCSS 重构样式体系、统一 Iconify 图标方案，带来更高效现代的开发体验，正式发布敬请期待～'
+  // }
+  // 单日示例：圣诞节
+  // {
+  //   name: '圣诞节',
+  //   date: '2024-12-25',
+  //   image: sd,
+  //   count: 3 // 可选，不设置则使用默认值 3 次
+  //   scrollText: 'Merry Christmas！Art Design Pro 祝您圣诞快乐，愿节日的欢乐与祝福如雪花般纷至沓来！',
+  // }
+]
diff --git a/web/src/config/modules/headerBar.ts b/web/src/config/modules/headerBar.ts
new file mode 100644
index 0000000..a420e82
--- /dev/null
+++ b/web/src/config/modules/headerBar.ts
@@ -0,0 +1,63 @@
+/**
+ * 顶部栏功能配置
+ *
+ * 统一管理顶部栏各个功能模块的启用状态。
+ * 通过修改此配置文件可以快速启用或禁用顶部栏的功能按钮。
+ *
+ * @module config/headerBar
+ * @author Art Design Pro Team
+ */
+
+import { HeaderBarFeatureConfig } from '@/types'
+
+/**
+ * 顶部栏功能配置对象
+ */
+export const headerBarConfig: HeaderBarFeatureConfig = {
+  menuButton: {
+    enabled: true,
+    description: '控制左侧菜单的展开/收起按钮'
+  },
+  refreshButton: {
+    enabled: true,
+    description: '页面刷新按钮'
+  },
+  fastEnter: {
+    enabled: true,
+    description: '快速入口功能，提供常用应用和链接的快速访问'
+  },
+  breadcrumb: {
+    enabled: true,
+    description: '面包屑导航，显示当前页面路径'
+  },
+  globalSearch: {
+    enabled: true,
+    description: '全局搜索功能，支持快捷键 Ctrl+K 或 Cmd+K'
+  },
+  fullscreen: {
+    enabled: true,
+    description: '全屏切换功能'
+  },
+  notification: {
+    enabled: true,
+    description: '通知中心，显示系统通知和消息'
+  },
+  chat: {
+    enabled: true,
+    description: '聊天功能，提供实时沟通'
+  },
+  language: {
+    enabled: true,
+    description: '多语言切换功能'
+  },
+  settings: {
+    enabled: true,
+    description: '系统设置面板'
+  },
+  themeToggle: {
+    enabled: true,
+    description: '主题切换功能（明暗主题）'
+  }
+}
+
+export default headerBarConfig
diff --git a/web/src/config/setting.ts b/web/src/config/setting.ts
new file mode 100644
index 0000000..94f2d2c
--- /dev/null
+++ b/web/src/config/setting.ts
@@ -0,0 +1,109 @@
+/**
+ * 系统设置默认值配置
+ *
+ * 统一管理系统设置的所有默认值
+ *
+ * ## 主要功能
+ *
+ * - 菜单相关默认配置
+ * - 主题相关默认配置
+ * - 界面显示默认配置
+ * - 功能开关默认配置
+ * - 样式相关默认配置
+ *
+ * ## 注意事项
+ *
+ * 1. 修改此文件的配置项时，需要同步更新以下文件：
+ *    - src/components/core/layouts/art-settings-panel/widget/SettingActions.vue（复制配置和重置配置逻辑）
+ *    - src/store/modules/setting.ts（Store 状态定义）
+ * 2. 可以通过设置面板的"复制配置"按钮快速生成配置代码
+ * 3. 枚举类型的值需要与 src/enums/appEnum.ts 中的定义保持一致
+ */
+
+import AppConfig from '@/config'
+import { SystemThemeEnum, MenuThemeEnum, MenuTypeEnum, ContainerWidthEnum } from '@/enums/appEnum'
+
+/**
+ * 系统设置默认值配置
+ */
+export const SETTING_DEFAULT_CONFIG = {
+  /** 菜单类型 */
+  menuType: MenuTypeEnum.LEFT,
+  /** 菜单展开宽度 */
+  menuOpenWidth: 230,
+  /** 菜单是否展开 */
+  menuOpen: true,
+  /** 双菜单是否显示文本 */
+  dualMenuShowText: false,
+  /** 系统主题类型 */
+  systemThemeType: SystemThemeEnum.AUTO,
+  /** 系统主题模式 */
+  systemThemeMode: SystemThemeEnum.AUTO,
+  /** 菜单风格 */
+  menuThemeType: MenuThemeEnum.DESIGN,
+  /** 系统主题颜色 */
+  systemThemeColor: AppConfig.systemMainColor[0],
+  /** 是否显示菜单按钮 */
+  showMenuButton: true,
+  /** 是否显示快速入口 */
+  showFastEnter: true,
+  /** 是否显示刷新按钮 */
+  showRefreshButton: true,
+  /** 是否显示面包屑 */
+  showCrumbs: true,
+  /** 是否显示工作台标签 */
+  showWorkTab: true,
+  /** 是否显示语言切换 */
+  showLanguage: true,
+  /** 是否显示进度条 */
+  showNprogress: false,
+  /** 是否显示设置引导 */
+  showSettingGuide: true,
+  /** 是否显示节日文本 */
+  showFestivalText: false,
+  /** 是否显示水印 */
+  watermarkVisible: false,
+  /** 是否自动关闭 */
+  autoClose: false,
+  /** 是否唯一展开 */
+  uniqueOpened: true,
+  /** 是否色弱模式 */
+  colorWeak: false,
+  /** 是否刷新 */
+  refresh: false,
+  /** 是否加载节日烟花 */
+  holidayFireworksLoaded: false,
+  /** 边框模式 */
+  boxBorderMode: true,
+  /** 页面过渡效果 */
+  pageTransition: 'slide-left',
+  /** 标签页样式 */
+  tabStyle: 'tab-default',
+  /** 自定义圆角 */
+  customRadius: '0.75',
+  /** 容器宽度 */
+  containerWidth: ContainerWidthEnum.FULL,
+  /** 节日日期 */
+  festivalDate: ''
+}
+
+/**
+ * 获取设置默认值
+ * @returns 设置默认值对象
+ */
+export function getSettingDefaults() {
+  return { ...SETTING_DEFAULT_CONFIG }
+}
+
+/**
+ * 重置为默认设置
+ * @param currentSettings 当前设置对象
+ */
+export function resetToDefaults(currentSettings: Record<string, any>) {
+  const defaults = getSettingDefaults()
+  Object.keys(defaults).forEach((key) => {
+    if (key in currentSettings) {
+      currentSettings[key] = defaults[key as keyof typeof defaults]
+    }
+  })
+}
diff --git a/web/src/directives/business/highlight.ts b/web/src/directives/business/highlight.ts
new file mode 100644
index 0000000..07b6c1d
--- /dev/null
+++ b/web/src/directives/business/highlight.ts
@@ -0,0 +1,250 @@
+/**
+ * v-highlight 代码高亮指令
+ *
+ * 为代码块提供语法高亮、行号显示和一键复制功能。
+ * 基于 highlight.js 实现，支持多种编程语言的语法高亮。
+ *
+ * ## 主要功能
+ *
+ * - 语法高亮 - 使用 highlight.js 自动识别并高亮代码
+ * - 行号显示 - 自动为每行代码添加行号
+ * - 一键复制 - 提供复制按钮，点击即可复制代码（自动过滤行号）
+ * - 性能优化 - 批量处理代码块，避免阻塞渲染
+ * - 动态监听 - 使用 MutationObserver 监听新增代码块
+ * - 防重复处理 - 自动标记已处理的代码块，避免重复处理
+ *
+ * ## 使用示例
+ *
+ * ```vue
+ * <template>
+ *   <!-- 基础用法 -->
+ *   <div v-highlight v-html="codeContent"></div>
+ *
+ *   <!-- 配合 Markdown 渲染 -->
+ *   <div v-highlight>
+ *     <pre><code class="language-javascript">
+ *       const hello = 'world';
+ *       console.log(hello);
+ *     </code></pre>
+ *   </div>
+ * </template>
+ * ```
+ *
+ * ## 性能优化
+ *
+ * - 批量处理：每次处理 10 个代码块，避免长时间阻塞
+ * - 延迟处理：使用 requestAnimationFrame 分批处理
+ * - 重试机制：自动重试处理失败的代码块
+ * - 智能监听：只在有新代码块时才触发处理
+ *
+ * @module directives/highlight
+ * @author Art Design Pro Team
+ */
+
+import { App, Directive } from 'vue'
+import hljs from 'highlight.js'
+
+export type HighlightDirective = Directive<HTMLElement>
+
+// 高亮代码
+function highlightCode(block: HTMLElement) {
+  hljs.highlightElement(block)
+}
+
+// 插入行号
+function insertLineNumbers(block: HTMLElement) {
+  const lines = block.innerHTML.split('\n')
+  const numberedLines = lines
+    .map((line, index) => {
+      return `<span class="line-number">${index + 1}</span> ${line}`
+    })
+    .join('\n')
+  block.innerHTML = numberedLines
+}
+
+// 添加复制按钮：调整 DOM 结构，将代码部分包裹在 .code-wrapper 内
+function addCopyButton(block: HTMLElement) {
+  const copyButton = document.createElement('i')
+  copyButton.className = 'copy-button'
+  copyButton.innerHTML =
+    '<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24"><path fill="currentColor" d="M7 6V3a1 1 0 0 1 1-1h12a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1h-3v3c0 .552-.45 1-1.007 1H4.007A1 1 0 0 1 3 21l.003-14c0-.552.45-1 1.006-1zM5.002 8L5 20h10V8zM9 6h8v10h2V4H9z"/></svg>'
+  copyButton.onclick = () => {
+    // 过滤掉行号，只复制代码内容
+    const codeContent = block.innerText.replace(/^\d+\s+/gm, '')
+    navigator.clipboard.writeText(codeContent).then(() => {
+      ElMessage.success('复制成功')
+    })
+  }
+
+  const preElement = block.parentElement
+  if (preElement) {
+    let codeWrapper: HTMLElement
+    // 如果代码块还没有被包裹，则创建包裹容器
+    if (!block.parentElement.classList.contains('code-wrapper')) {
+      codeWrapper = document.createElement('div')
+      codeWrapper.className = 'code-wrapper'
+      preElement.replaceChild(codeWrapper, block)
+      codeWrapper.appendChild(block)
+    } else {
+      codeWrapper = block.parentElement
+    }
+    // 将复制按钮添加到 pre 元素（而非 codeWrapper 内），这样它不会随滚动条滚动
+    preElement.appendChild(copyButton)
+  }
+}
+
+// 检查代码块是否已经被处理过
+function isBlockProcessed(block: HTMLElement): boolean {
+  return (
+    block.hasAttribute('data-highlighted') ||
+    !!block.querySelector('.line-number') ||
+    !!block.parentElement?.querySelector('.copy-button')
+  )
+}
+
+// 标记代码块为已处理
+function markBlockAsProcessed(block: HTMLElement) {
+  block.setAttribute('data-highlighted', 'true')
+}
+
+// 处理单个代码块
+function processBlock(block: HTMLElement) {
+  if (isBlockProcessed(block)) {
+    return
+  }
+
+  try {
+    highlightCode(block)
+    insertLineNumbers(block)
+    addCopyButton(block)
+    markBlockAsProcessed(block)
+  } catch (error) {
+    console.warn('处理代码块时出错:', error)
+  }
+}
+
+// 查找并处理所有代码块
+function processAllCodeBlocks(el: HTMLElement) {
+  const blocks = Array.from(el.querySelectorAll<HTMLElement>('pre code'))
+  const unprocessedBlocks = blocks.filter((block) => !isBlockProcessed(block))
+
+  if (unprocessedBlocks.length === 0) {
+    return
+  }
+
+  if (unprocessedBlocks.length <= 10) {
+    // 如果代码块数量少于等于10，直接处理所有代码块
+    unprocessedBlocks.forEach((block) => processBlock(block))
+  } else {
+    // 定义每次处理的代码块数
+    const batchSize = 10
+    let currentIndex = 0
+
+    const processBatch = () => {
+      const batch = unprocessedBlocks.slice(currentIndex, currentIndex + batchSize)
+
+      batch.forEach((block) => {
+        processBlock(block)
+      })
+
+      // 更新索引并继续处理下一批
+      currentIndex += batchSize
+      if (currentIndex < unprocessedBlocks.length) {
+        // 使用 requestAnimationFrame 确保下一帧再处理
+        requestAnimationFrame(processBatch)
+      }
+    }
+
+    // 开始处理第一批代码块
+    processBatch()
+  }
+}
+
+// 重试处理函数
+function retryProcessing(el: HTMLElement, maxRetries: number = 3, delay: number = 200) {
+  let retryCount = 0
+
+  const tryProcess = () => {
+    processAllCodeBlocks(el)
+
+    // 检查是否还有未处理的代码块
+    const remainingBlocks = Array.from(el.querySelectorAll<HTMLElement>('pre code')).filter(
+      (block) => !isBlockProcessed(block)
+    )
+
+    if (remainingBlocks.length > 0 && retryCount < maxRetries) {
+      retryCount++
+      setTimeout(tryProcess, delay * retryCount) // 递增延迟
+    }
+  }
+
+  tryProcess()
+}
+
+// 代码高亮、插入行号、复制按钮
+const highlightDirective: HighlightDirective = {
+  mounted(el: HTMLElement) {
+    // 立即尝试处理一次
+    processAllCodeBlocks(el)
+
+    // 延迟处理，确保 v-html 内容已经渲染
+    setTimeout(() => {
+      retryProcessing(el)
+    }, 100)
+
+    // 使用 MutationObserver 监听 DOM 变化
+    const observer = new MutationObserver((mutations) => {
+      let hasNewCodeBlocks = false
+
+      mutations.forEach((mutation) => {
+        if (mutation.type === 'childList') {
+          mutation.addedNodes.forEach((node) => {
+            if (node.nodeType === Node.ELEMENT_NODE) {
+              const element = node as HTMLElement
+              // 检查新添加的节点是否包含代码块
+              if (element.tagName === 'PRE' || element.querySelector('pre code')) {
+                hasNewCodeBlocks = true
+              }
+            }
+          })
+        }
+      })
+
+      if (hasNewCodeBlocks) {
+        // 延迟处理新添加的代码块
+        setTimeout(() => {
+          processAllCodeBlocks(el)
+        }, 50)
+      }
+    })
+
+    // 开始观察
+    observer.observe(el, {
+      childList: true,
+      subtree: true
+    })
+
+    // 将 observer 存储到元素上，以便在 unmounted 时清理
+    ;(el as any)._highlightObserver = observer
+  },
+
+  updated(el: HTMLElement) {
+    // 当组件更新时，重新处理代码块
+    setTimeout(() => {
+      processAllCodeBlocks(el)
+    }, 50)
+  },
+
+  unmounted(el: HTMLElement) {
+    // 清理 MutationObserver
+    const observer = (el as any)._highlightObserver
+    if (observer) {
+      observer.disconnect()
+      delete (el as any)._highlightObserver
+    }
+  }
+}
+
+export function setupHighlightDirective(app: App) {
+  app.directive('highlight', highlightDirective)
+}
diff --git a/web/src/directives/business/ripple.ts b/web/src/directives/business/ripple.ts
new file mode 100644
index 0000000..e65470e
--- /dev/null
+++ b/web/src/directives/business/ripple.ts
@@ -0,0 +1,116 @@
+/**
+ * v-ripple 水波纹效果指令
+ *
+ * 为元素添加 Material Design 风格的水波纹点击效果。
+ * 点击时从点击位置扩散出圆形水波纹动画，提升交互体验。
+ *
+ * ## 主要功能
+ *
+ * - 水波纹动画 - 点击时从点击位置扩散圆形波纹
+ * - 自适应大小 - 根据元素尺寸自动调整波纹大小和动画时长
+ * - 智能配色 - 自动识别按钮类型，使用合适的波纹颜色
+ * - 自定义颜色 - 支持通过参数自定义波纹颜色
+ * - 性能优化 - 使用 requestAnimationFrame 和自动清理机制
+ *
+ * ## 使用示例
+ *
+ * ```vue
+ * <template>
+ *   <!-- 基础用法 - 使用默认颜色 -->
+ *   <el-button v-ripple>点击我</el-button>
+ *
+ *   <!-- 自定义颜色 -->
+ *   <el-button v-ripple="{ color: 'rgba(255, 0, 0, 0.3)' }">自定义颜色</el-button>
+ *
+ *   <!-- 应用到任意元素 -->
+ *   <div v-ripple class="custom-card">卡片内容</div>
+ * </template>
+ * ```
+ *
+ * ## 颜色规则
+ *
+ * - 有色按钮（primary、success、warning 等）：使用白色半透明波纹
+ * - 默认按钮：使用主题色半透明波纹
+ * - 自定义：通过 color 参数指定任意颜色
+ *
+ * @module directives/ripple
+ * @author Art Design Pro Team
+ */
+
+import type { App, Directive, DirectiveBinding } from 'vue'
+
+export interface RippleOptions {
+  /** 水波纹颜色 */
+  color?: string
+}
+
+export type RippleDirective = Directive<HTMLElement, RippleOptions>
+
+export const vRipple: RippleDirective = {
+  mounted(el: HTMLElement, binding: DirectiveBinding) {
+    // 获取指令的配置参数
+    const options: RippleOptions = binding.value || {}
+
+    // 设置元素为相对定位，并隐藏溢出部分
+    el.style.position = 'relative'
+    el.style.overflow = 'hidden'
+
+    // 点击事件处理
+    el.addEventListener('mousedown', (e: MouseEvent) => {
+      const rect = el.getBoundingClientRect()
+      const left = e.clientX - rect.left
+      const top = e.clientY - rect.top
+
+      // 创建水波纹元素
+      const ripple = document.createElement('div')
+      const diameter = Math.max(el.clientWidth, el.clientHeight)
+      const radius = diameter / 2
+
+      // 根据直径计算动画时间（直径越大，动画时间越长）
+      const baseTime = 600 // 基础动画时间（毫秒）
+      const scaleFactor = 0.5 // 缩放因子
+      const animationDuration = baseTime + diameter * scaleFactor
+
+      // 设置水波纹的尺寸和位置
+      ripple.style.width = ripple.style.height = `${diameter}px`
+      ripple.style.left = `${left - radius}px`
+      ripple.style.top = `${top - radius}px`
+      ripple.style.position = 'absolute'
+      ripple.style.borderRadius = '50%'
+      ripple.style.pointerEvents = 'none'
+
+      // 判断是否为有色按钮（Element Plus 按钮类型）
+      const buttonTypes = ['primary', 'info', 'warning', 'danger', 'success'].map(
+        (type) => `el-button--${type}`
+      )
+      const isColoredButton = buttonTypes.some((type) => el.classList.contains(type))
+      const defaultColor = isColoredButton
+        ? 'rgba(255, 255, 255, 0.25)' // 有色按钮使用白色水波纹
+        : 'var(--el-color-primary-light-7)' // 默认按钮使用主题色水波纹
+
+      // 设置水波纹颜色、初始状态和过渡效果
+      ripple.style.backgroundColor = options.color || defaultColor
+      ripple.style.transform = 'scale(0)'
+      ripple.style.transition = `transform ${animationDuration}ms cubic-bezier(0.3, 0, 0.2, 1), opacity ${animationDuration}ms cubic-bezier(0.3, 0, 0.5, 1)`
+      ripple.style.zIndex = '1'
+
+      // 添加水波纹元素到DOM中
+      el.appendChild(ripple)
+
+      // 触发动画
+      requestAnimationFrame(() => {
+        ripple.style.transform = 'scale(2)'
+        ripple.style.opacity = '0'
+      })
+
+      // 动画结束后移除水波纹元素
+      setTimeout(() => {
+        ripple.remove()
+      }, animationDuration + 500) // 增加500ms缓冲时间
+    })
+  }
+}
+
+export function setupRippleDirective(app: App) {
+  app.directive('ripple', vRipple)
+}
diff --git a/web/src/directives/core/auth.ts b/web/src/directives/core/auth.ts
new file mode 100755
index 0000000..3d244c7
--- /dev/null
+++ b/web/src/directives/core/auth.ts
@@ -0,0 +1,66 @@
+/**
+ * v-auth 权限指令
+ *
+ * 适用于后端权限控制模式，基于权限标识控制 DOM 元素的显示和隐藏。
+ * 如果用户没有对应权限，元素将从 DOM 中移除。
+ *
+ * ## 主要功能
+ *
+ * - 权限验证 - 根据路由 meta 中的权限列表验证用户权限
+ * - DOM 控制 - 无权限时自动移除元素，而非隐藏
+ * - 响应式更新 - 权限变化时自动更新元素状态
+ *
+ * ## 使用示例
+ *
+ * ```vue
+ * <!-- 只有拥有 'add' 权限的用户才能看到新增按钮 -->
+ * <el-button v-auth="'add'">新增</el-button>
+ *
+ * <!-- 只有拥有 'edit' 权限的用户才能看到编辑按钮 -->
+ * <el-button v-auth="'edit'">编辑</el-button>
+ *
+ * <!-- 只有拥有 'delete' 权限的用户才能看到删除按钮 -->
+ * <el-button v-auth="'delete'">删除</el-button>
+ * ```
+ *
+ * ## 注意事项
+ *
+ * - 该指令会直接移除 DOM 元素，而不是使用 v-if 隐藏
+ * - 权限列表从当前路由的 meta.authList 中获取
+ *
+ * @module directives/auth
+ * @author Art Design Pro Team
+ */
+
+import { router } from '@/router'
+import { App, Directive, DirectiveBinding } from 'vue'
+
+export type AuthDirective = Directive<HTMLElement, string>
+
+function checkAuthPermission(el: HTMLElement, binding: DirectiveBinding<string>): void {
+  // 获取当前路由的权限列表
+  const authList = (router.currentRoute.value.meta.authList as Array<{ authMark: string }>) || []
+
+  // 检查是否有对应的权限标识
+  const hasPermission = authList.some((item) => item.authMark === binding.value)
+
+  // 如果没有权限，移除元素
+  if (!hasPermission) {
+    removeElement(el)
+  }
+}
+
+function removeElement(el: HTMLElement): void {
+  if (el.parentNode) {
+    el.parentNode.removeChild(el)
+  }
+}
+
+const authDirective: AuthDirective = {
+  mounted: checkAuthPermission,
+  updated: checkAuthPermission
+}
+
+export function setupAuthDirective(app: App): void {
+  app.directive('auth', authDirective)
+}
diff --git a/web/src/directives/core/roles.ts b/web/src/directives/core/roles.ts
new file mode 100644
index 0000000..f1db35b
--- /dev/null
+++ b/web/src/directives/core/roles.ts
@@ -0,0 +1,87 @@
+/**
+ * v-roles 角色权限指令
+ *
+ * 基于用户角色控制 DOM 元素的显示和隐藏。
+ * 只要用户拥有指定角色中的任意一个，元素就会显示，否则从 DOM 中移除。
+ *
+ * ## 主要功能
+ *
+ * - 角色验证 - 检查用户是否拥有指定角色
+ * - 多角色支持 - 支持单个角色或多个角色（满足其一即可）
+ * - DOM 控制 - 无权限时自动移除元素，而非隐藏
+ * - 响应式更新 - 角色变化时自动更新元素状态
+ *
+ * ## 使用示例
+ *
+ * ```vue
+ * <template>
+ *   <!-- 单个角色 - 只有超级管理员可见 -->
+ *   <el-button v-roles="'R_SUPER'">超级管理员功能</el-button>
+ *
+ *   <!-- 多个角色 - 超级管理员或普通管理员可见 -->
+ *   <el-button v-roles="['R_SUPER', 'R_ADMIN']">管理员功能</el-button>
+ *
+ *   <!-- 应用到任意元素 -->
+ *   <div v-roles="['R_SUPER', 'R_ADMIN', 'R_USER']">
+ *     所有登录用户可见的内容
+ *   </div>
+ * </template>
+ * ```
+ *
+ * ## 权限逻辑
+ *
+ * - 用户角色从 userStore.getUserInfo.roles 获取
+ * - 只要用户拥有指定角色中的任意一个，元素就会显示
+ * - 如果用户没有任何角色或不满足条件，元素将被移除
+ *
+ * ## 注意事项
+ *
+ * - 该指令会直接移除 DOM 元素，而不是使用 v-if 隐藏
+ * - 适用于基于角色的粗粒度权限控制
+ * - 如需基于具体操作的细粒度权限控制，请使用 v-auth 指令
+ *
+ * @module directives/roles
+ * @author Art Design Pro Team
+ */
+
+import { useUserStore } from '@/store/modules/user'
+import { App, Directive, DirectiveBinding } from 'vue'
+
+export type RolesDirective = Directive<HTMLElement, string | string[]>
+
+function checkRolePermission(el: HTMLElement, binding: DirectiveBinding<string | string[]>): void {
+  const userStore = useUserStore()
+  const userRoles = userStore.getUserInfo.roles
+
+  // 如果用户角色为空或未定义，移除元素
+  if (!userRoles?.length) {
+    removeElement(el)
+    return
+  }
+
+  // 确保指令值为数组格式
+  const requiredRoles = Array.isArray(binding.value) ? binding.value : [binding.value]
+
+  // 检查用户是否具有所需角色之一
+  const hasPermission = requiredRoles.some((role: string) => userRoles.includes(role))
+
+  // 如果没有权限，安全地移除元素
+  if (!hasPermission) {
+    removeElement(el)
+  }
+}
+
+function removeElement(el: HTMLElement): void {
+  if (el.parentNode) {
+    el.parentNode.removeChild(el)
+  }
+}
+
+const rolesDirective: RolesDirective = {
+  mounted: checkRolePermission,
+  updated: checkRolePermission
+}
+
+export function setupRolesDirective(app: App): void {
+  app.directive('roles', rolesDirective)
+}
diff --git a/web/src/directives/index.ts b/web/src/directives/index.ts
new file mode 100755
index 0000000..b428a2b
--- /dev/null
+++ b/web/src/directives/index.ts
@@ -0,0 +1,14 @@
+import type { App } from 'vue'
+import { setupAuthDirective, type AuthDirective } from './core/auth'
+import { setupHighlightDirective, type HighlightDirective } from './business/highlight'
+import { setupRippleDirective, type RippleDirective } from './business/ripple'
+import { setupRolesDirective, type RolesDirective } from './core/roles'
+
+export function setupGlobDirectives(app: App) {
+  setupAuthDirective(app) // 权限指令
+  setupRolesDirective(app) // 角色权限指令
+  setupHighlightDirective(app) // 高亮指令
+  setupRippleDirective(app) // 水波纹指令
+}
+
+export type { AuthDirective, HighlightDirective, RippleDirective, RolesDirective }
diff --git a/web/src/enums/appEnum.ts b/web/src/enums/appEnum.ts
new file mode 100755
index 0000000..a39c278
--- /dev/null
+++ b/web/src/enums/appEnum.ts
@@ -0,0 +1,81 @@
+/**
+ * 系统级别枚举定义模块
+ *
+ * ## 主要功能
+ *
+ * - 菜单类型枚举（左侧、顶部、混合、双栏）
+ * - 主题类型枚举（亮色、暗色、自动）
+ * - 菜单主题枚举（设计、亮色、暗色）
+ * - 语言类型枚举（中文、英文）
+ * - 容器宽度枚举（全屏、固定）
+ * - 菜单宽度枚举（收起宽度）
+ *
+ * @module enums/appEnum
+ * @author Art Design Pro Team
+ */
+
+/**
+ * 菜单类型
+ */
+export enum MenuTypeEnum {
+  /** 左侧菜单 */
+  LEFT = 'left',
+  /** 顶部菜单 */
+  TOP = 'top',
+  /** 顶部+左侧菜单 */
+  TOP_LEFT = 'top-left',
+  /** 双栏菜单 */
+  DUAL_MENU = 'dual-menu'
+}
+
+/**
+ * 系统主题
+ */
+export enum SystemThemeEnum {
+  /** 暗色主题 */
+  DARK = 'dark',
+  /** 亮色主题 */
+  LIGHT = 'light',
+  /** 自动主题（跟随系统） */
+  AUTO = 'auto'
+}
+
+/**
+ * 菜单主题
+ */
+export enum MenuThemeEnum {
+  /** 暗色主题 */
+  DARK = 'dark',
+  /** 亮色主题 */
+  LIGHT = 'light',
+  /** 设计主题 */
+  DESIGN = 'design'
+}
+
+/**
+ * 菜单宽度
+ */
+export enum MenuWidth {
+  /** 收起宽度 */
+  CLOSE = '64px'
+}
+
+/**
+ * 语言类型
+ */
+export enum LanguageEnum {
+  /** 中文 */
+  ZH = 'zh',
+  /** 英文 */
+  EN = 'en'
+}
+
+/**
+ * 容器宽度
+ */
+export enum ContainerWidthEnum {
+  /** 全屏宽度 */
+  FULL = '100%',
+  /** 固定宽度 */
+  BOXED = '1200px'
+}
diff --git a/web/src/enums/formEnum.ts b/web/src/enums/formEnum.ts
new file mode 100644
index 0000000..8e9b3b4
--- /dev/null
+++ b/web/src/enums/formEnum.ts
@@ -0,0 +1,24 @@
+/**
+ * 表单相关枚举定义模块
+ *
+ * ## 主要功能
+ *
+ * - 页面模式枚举（新增、编辑）
+ * - 表格尺寸枚举（默认、紧凑、宽松）
+ *
+ * @module enums/formEnum
+ * @author Art Design Pro Team
+ */
+
+// 页面类型
+export enum PageModeEnum {
+  Add, // 新增
+  Edit // 编辑
+}
+
+// 表格大小
+export enum TableSizeEnum {
+  DEFAULT = 'default',
+  SMALL = 'small',
+  LARGE = 'large'
+}
diff --git a/web/src/env.d.ts b/web/src/env.d.ts
new file mode 100755
index 0000000..4401f21
--- /dev/null
+++ b/web/src/env.d.ts
@@ -0,0 +1,34 @@
+/// <reference types="vite/client" />
+
+declare module 'nprogress'
+
+declare module 'crypto-js'
+
+declare module 'vue-img-cutter'
+
+declare module 'file-saver'
+
+declare module 'qrcode.vue' {
+  export type Level = 'L' | 'M' | 'Q' | 'H'
+  export type RenderAs = 'canvas' | 'svg'
+  export type GradientType = 'linear' | 'radial'
+  export interface ImageSettings {
+    src: string
+    height: number
+    width: number
+    excavate: boolean
+  }
+  export interface QRCodeProps {
+    value: string
+    size?: number
+    level?: Level
+    background?: string
+    foreground?: string
+    renderAs?: RenderAs
+  }
+  const QrcodeVue: any
+  export default QrcodeVue
+}
+
+// 全局变量声明
+declare const __APP_VERSION__: string // 版本号
diff --git a/web/src/hooks/core/useAppMode.ts b/web/src/hooks/core/useAppMode.ts
new file mode 100644
index 0000000..c39cd9e
--- /dev/null
+++ b/web/src/hooks/core/useAppMode.ts
@@ -0,0 +1,45 @@
+/**
+ * useAppMode - 应用模式管理
+ *
+ * 提供应用访问模式的判断和管理功能，支持前端和后端两种权限控制模式。
+ * 根据环境变量 VITE_ACCESS_MODE 自动识别当前运行模式。
+ *
+ * ## 主要功能
+ *
+ * 1. 模式识别 - 自动识别前端模式或后端模式
+ * 2. 前端模式 - 权限由前端路由配置控制，适合小型项目或演示环境
+ * 3. 后端模式 - 权限由后端接口返回的菜单数据控制，适合企业级应用
+ * 4. 响应式状态 - 提供响应式的模式判断，方便在组件中使用
+ *
+ * @module useAppMode
+ * @author Art Design Pro Team
+ */
+
+import { computed } from 'vue'
+
+export function useAppMode() {
+  // 获取访问模式配置
+  const accessMode = import.meta.env.VITE_ACCESS_MODE
+
+  /**
+   * 是否为前端控制模式
+   * 前端模式：权限由前端路由配置控制
+   */
+  const isFrontendMode = computed(() => accessMode === 'frontend')
+  /**
+   * 是否为后端控制模式
+   * 后端模式：权限由后端接口返回的菜单数据控制
+   */
+  const isBackendMode = computed(() => accessMode === 'backend')
+
+  /**
+   * 当前应用模式
+   */
+  const currentMode = computed(() => accessMode)
+
+  return {
+    isFrontendMode,
+    isBackendMode,
+    currentMode
+  }
+}
diff --git a/web/src/hooks/core/useAuth.ts b/web/src/hooks/core/useAuth.ts
new file mode 100644
index 0000000..65ad2b8
--- /dev/null
+++ b/web/src/hooks/core/useAuth.ts
@@ -0,0 +1,72 @@
+/**
+ * useAuth - 权限验证管理
+ *
+ * 提供统一的权限验证功能，支持前端和后端两种权限模式。
+ * 用于控制页面按钮、操作等功能的显示和访问权限。
+ *
+ * ## 主要功能
+ *
+ * 1. 权限检查 - 检查用户是否拥有指定的权限标识
+ * 2. 双模式支持 - 自动适配前端模式和后端模式的权限验证
+ * 3. 前端模式 - 从用户信息中获取按钮权限列表（如 ['add', 'edit', 'delete']）
+ * 4. 后端模式 - 从路由 meta 配置中获取权限列表（如 [{ authMark: 'add' }]）
+ *
+ * ## 使用示例
+ *
+ * ```typescript
+ * const { hasAuth } = useAuth()
+ *
+ * // 检查是否有新增权限
+ * if (hasAuth('add')) {
+ *   // 显示新增按钮
+ * }
+ *
+ * // 在模板中使用
+ * <el-button v-if="hasAuth('edit')">编辑</el-button>
+ * <el-button v-if="hasAuth('delete')">删除</el-button>
+ * ```
+ *
+ * @module useAuth
+ * @author Art Design Pro Team
+ */
+
+import { useRoute } from 'vue-router'
+import { computed } from 'vue'
+import { storeToRefs } from 'pinia'
+import { useUserStore } from '@/store/modules/user'
+import { useAppMode } from '@/hooks/core/useAppMode'
+import type { AppRouteRecord } from '@/types/router'
+
+type AuthItem = NonNullable<AppRouteRecord['meta']['authList']>[number]
+
+const userStore = useUserStore()
+
+export const useAuth = () => {
+  const route = useRoute()
+  const { isFrontendMode } = useAppMode()
+  const { info } = storeToRefs(userStore)
+
+  // 后端路由 meta 配置的权限列表（例如：[{ authMark: 'add' }]）
+  const backendAuthList = computed<AuthItem[]>(() =>
+    Array.isArray(route.meta.authList) ? (route.meta.authList as AuthItem[]) : []
+  )
+
+  /**
+   * 检查是否拥有某权限标识（前后端模式通用）
+   * @param auth 权限标识
+   * @returns 是否有权限
+   */
+  const hasAuth = (auth: string): boolean => {
+    // 前端模式
+    if (isFrontendMode.value) {
+      return (info.value?.buttons ?? []).includes(auth)
+    }
+
+    // 后端模式
+    return backendAuthList.value.some((item) => item?.authMark === auth)
+  }
+
+  return {
+    hasAuth
+  }
+}
diff --git a/web/src/hooks/core/useCeremony.ts b/web/src/hooks/core/useCeremony.ts
new file mode 100644
index 0000000..ead2630
--- /dev/null
+++ b/web/src/hooks/core/useCeremony.ts
@@ -0,0 +1,184 @@
+/**
+ * useCeremony - 节日庆祝管理
+ *
+ * 提供节日烟花效果和祝福文本展示功能，为系统增添节日氛围。
+ * 自动检测当前日期是否为节日，并在首次进入时播放烟花动画和显示祝福语。
+ *
+ * ## 主要功能
+ *
+ * 1. 节日检测 - 自动匹配当前日期与节日配置列表，支持单日和跨日期节日
+ * 2. 烟花动画 - 播放节日烟花特效，支持自定义图片和触发次数
+ * 3. 祝福文本 - 烟花结束后显示节日祝福文本
+ * 4. 状态管理 - 记录烟花播放状态，避免重复播放
+ * 5. 清理机制 - 提供清理方法，支持手动停止和重置
+ *
+ * ## 使用示例
+ *
+ * ```typescript
+ * // 在配置文件中定义节日
+ * // 单日节日
+ * {
+ *   date: '2024-12-25',
+ *   name: '圣诞节',
+ *   image: christmasImage,
+ *   count: 3 // 可选，不设置则使用默认值 3 次
+ *   scrollText: 'Merry Christmas!',
+ * }
+ *
+ * // 跨日期节日
+ * {
+ *   date: '2025-11-07',
+ *   endDate: '2025-11-10',
+ *   name: 'v3.0 测试阶段',
+ *   image: '',
+ *   count: 5 // 自定义烟花播放次数
+ *   scrollText: '系统 v3.0 测试阶段正式开启！',
+ * }
+ * ```
+ *
+ * @module useCeremony
+ * @author Art Design Pro Team
+ */
+
+import { useTimeoutFn, useIntervalFn, useDateFormat } from '@vueuse/core'
+import { storeToRefs } from 'pinia'
+import { computed } from 'vue'
+import { useSettingStore } from '@/store/modules/setting'
+import { mittBus } from '@/utils/sys'
+import { festivalConfigList } from '@/config/modules/festival'
+
+/**
+ * 节日庆祝配置常量
+ */
+const FESTIVAL_CONFIG = {
+  /** 初始延迟（毫秒） */
+  INITIAL_DELAY: 300,
+  /** 烟花播放间隔（毫秒） */
+  FIREWORK_INTERVAL: 1000,
+  /** 文本显示延迟（毫秒） */
+  TEXT_DELAY: 2000,
+  /** 默认烟花播放次数 */
+  DEFAULT_FIREWORKS_COUNT: 3
+} as const
+
+/**
+ * 节日庆祝功能
+ * 提供节日烟花效果和祝福文本展示
+ */
+export function useCeremony() {
+  const settingStore = useSettingStore()
+  const { holidayFireworksLoaded, isShowFireworks } = storeToRefs(settingStore)
+
+  let fireworksInterval: { pause: () => void } | null = null
+
+  /**
+   * 检查日期是否在节日范围内
+   * @param currentDate 当前日期
+   * @param festivalDate 节日开始日期
+   * @param festivalEndDate 节日结束日期（可选）
+   */
+  const isDateInRange = (
+    currentDate: string,
+    festivalDate: string,
+    festivalEndDate?: string
+  ): boolean => {
+    if (!festivalEndDate) {
+      // 单日节日
+      return currentDate === festivalDate
+    }
+
+    // 跨日期节日
+    const current = new Date(currentDate)
+    const start = new Date(festivalDate)
+    const end = new Date(festivalEndDate)
+
+    return current >= start && current <= end
+  }
+
+  /**
+   * 获取当前日期对应的节日数据
+   */
+  const currentFestivalData = computed(() => {
+    const currentDate = useDateFormat(new Date(), 'YYYY-MM-DD').value
+    return festivalConfigList.find((item) => isDateInRange(currentDate, item.date, item.endDate))
+  })
+
+  /**
+   * 更新节日日期到 store
+   */
+  const updateFestivalDate = () => {
+    settingStore.setFestivalDate(currentFestivalData.value?.date || '')
+  }
+
+  /**
+   * 触发烟花效果
+   */
+  const triggerFirework = () => {
+    mittBus.emit('triggerFireworks', currentFestivalData.value?.image)
+  }
+
+  /**
+   * 完成烟花效果后显示文本
+   */
+  const showFestivalText = () => {
+    settingStore.setholidayFireworksLoaded(true)
+
+    useTimeoutFn(() => {
+      settingStore.setShowFestivalText(true)
+      updateFestivalDate()
+    }, FESTIVAL_CONFIG.TEXT_DELAY)
+  }
+
+  /**
+   * 启动烟花循环
+   */
+  const startFireworksLoop = () => {
+    let playedCount = 0
+    // 使用节日配置的播放次数，如果没有则使用默认值
+    const count = currentFestivalData.value?.count ?? FESTIVAL_CONFIG.DEFAULT_FIREWORKS_COUNT
+
+    const { pause } = useIntervalFn(() => {
+      triggerFirework()
+      playedCount++
+
+      if (playedCount >= count) {
+        pause()
+        showFestivalText()
+      }
+    }, FESTIVAL_CONFIG.FIREWORK_INTERVAL)
+
+    fireworksInterval = { pause }
+  }
+
+  /**
+   * 开启节日庆祝
+   */
+  const openFestival = () => {
+    if (!currentFestivalData.value || !isShowFireworks.value) {
+      return
+    }
+
+    const { start } = useTimeoutFn(startFireworksLoop, FESTIVAL_CONFIG.INITIAL_DELAY)
+    start()
+  }
+
+  /**
+   * 清理烟花效果
+   */
+  const cleanup = () => {
+    if (fireworksInterval) {
+      fireworksInterval.pause()
+      fireworksInterval = null
+    }
+    settingStore.setShowFestivalText(false)
+    updateFestivalDate()
+  }
+
+  return {
+    openFestival,
+    cleanup,
+    holidayFireworksLoaded,
+    currentFestivalData,
+    isShowFireworks
+  }
+}
diff --git a/web/src/hooks/core/useChart.ts b/web/src/hooks/core/useChart.ts
new file mode 100644
index 0000000..7abb46d
--- /dev/null
+++ b/web/src/hooks/core/useChart.ts
@@ -0,0 +1,746 @@
+/**
+ * useChart - ECharts 图表管理
+ *
+ * 提供完整的 ECharts 图表生命周期管理和配置能力，简化图表开发流程。
+ * 自动处理图表初始化、更新、销毁、主题切换、响应式调整等复杂逻辑。
+ *
+ * ## 核心功能
+ *
+ * 1. 图表生命周期管理 - 自动处理初始化、更新、销毁，支持延迟加载和可见性检测
+ * 2. 主题自动适配 - 响应系统主题变化，自动更新图表样式和配色
+ * 3. 响应式调整 - 监听窗口大小、菜单展开等变化，自动调整图表尺寸
+ * 4. 空状态处理 - 优雅的空数据展示，自动显示"暂无数据"提示
+ * 5. 样式配置统一 - 提供坐标轴、图例、提示框等统一的样式配置方法
+ * 6. 性能优化 - 防抖处理、样式缓存、requestAnimationFrame 优化
+ * 7. 高级组件抽象 - useChartComponent 提供更高层次的图表组件封装
+ *
+ * ## 使用示例
+ *
+ * ```typescript
+ * // 基础用法
+ * const {
+ *   chartRef,
+ *   initChart,
+ *   updateChart,
+ *   getAxisLineStyle,
+ *   getTooltipStyle
+ * } = useChart()
+ *
+ * onMounted(() => {
+ *   initChart({
+ *     xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
+ *     yAxis: { type: 'value' },
+ *     series: [{ data: [120, 200, 150], type: 'bar' }]
+ *   })
+ * })
+ *
+ * // 高级用法 - 组件抽象
+ * const chart = useChartComponent({
+ *   props,
+ *   generateOptions: () => ({
+ *     // ECharts 配置
+ *   }),
+ *   checkEmpty: () => data.value.length === 0,
+ *   watchSources: [() => props.data]
+ * })
+ * ```
+ *
+ * @module useChart
+ * @author Art Design Pro Team
+ */
+
+import { echarts, type EChartsOption } from '@/plugins/echarts'
+import { storeToRefs } from 'pinia'
+import { useSettingStore } from '@/store/modules/setting'
+import { getCssVar } from '@/utils/ui'
+import { $t } from '@/locales'
+import type { BaseChartProps, ChartThemeConfig, UseChartOptions } from '@/types/component/chart'
+
+// 图表主题配置
+export const useChartOps = (): ChartThemeConfig => ({
+  /** */
+  chartHeight: '16rem',
+  /** 字体大小 */
+  fontSize: 13,
+  /** 字体颜色 */
+  fontColor: '#999',
+  /** 主题颜色 */
+  themeColor: getCssVar('--el-color-primary-light-1'),
+  /** 颜色组 */
+  colors: [
+    getCssVar('--el-color-primary-light-1'),
+    '#4ABEFF',
+    '#EDF2FF',
+    '#14DEBA',
+    '#FFAF20',
+    '#FA8A6C',
+    '#FFAF20'
+  ]
+})
+
+// 常量定义
+const RESIZE_DELAYS = [50, 100, 200, 350] as const
+const MENU_RESIZE_DELAYS = [50, 100, 200] as const
+const RESIZE_DEBOUNCE_DELAY = 100
+
+export function useChart(options: UseChartOptions = {}) {
+  const { initOptions, initDelay = 0, threshold = 0.1, autoTheme = true } = options
+
+  const settingStore = useSettingStore()
+  const { isDark, menuOpen, menuType } = storeToRefs(settingStore)
+
+  const chartRef = ref<HTMLElement>()
+  let chart: echarts.ECharts | null = null
+  let intersectionObserver: IntersectionObserver | null = null
+  let pendingOptions: EChartsOption | null = null
+  let resizeTimeoutId: number | null = null
+  let resizeFrameId: number | null = null
+  let isDestroyed = false
+  let emptyStateDiv: HTMLElement | null = null
+
+  // 清理定时器的统一方法
+  const clearTimers = () => {
+    if (resizeTimeoutId) {
+      clearTimeout(resizeTimeoutId)
+      resizeTimeoutId = null
+    }
+    if (resizeFrameId) {
+      cancelAnimationFrame(resizeFrameId)
+      resizeFrameId = null
+    }
+  }
+
+  // 使用 requestAnimationFrame 优化 resize 处理
+  const requestAnimationResize = () => {
+    if (resizeFrameId) {
+      cancelAnimationFrame(resizeFrameId)
+    }
+    resizeFrameId = requestAnimationFrame(() => {
+      handleResize()
+      resizeFrameId = null
+    })
+  }
+
+  // 防抖的resize处理（用于窗口resize事件）
+  const debouncedResize = () => {
+    if (resizeTimeoutId) {
+      clearTimeout(resizeTimeoutId)
+    }
+    resizeTimeoutId = window.setTimeout(() => {
+      requestAnimationResize()
+      resizeTimeoutId = null
+    }, RESIZE_DEBOUNCE_DELAY)
+  }
+
+  // 多延迟resize处理 - 统一方法
+  const multiDelayResize = (delays: readonly number[]) => {
+    // 立即调用一次，快速响应
+    nextTick(requestAnimationResize)
+
+    // 使用延迟时间，确保图表正确适应变化
+    delays.forEach((delay) => {
+      setTimeout(requestAnimationResize, delay)
+    })
+  }
+
+  // 收缩菜单时，重新计算图表大小（仅在图表存在时监听）
+  let menuOpenStopHandle: (() => void) | null = null
+  let menuTypeStopHandle: (() => void) | null = null
+
+  const setupMenuWatchers = () => {
+    menuOpenStopHandle = watch(menuOpen, () => multiDelayResize(RESIZE_DELAYS))
+    menuTypeStopHandle = watch(menuType, () => {
+      nextTick(requestAnimationResize)
+      setTimeout(() => multiDelayResize(MENU_RESIZE_DELAYS), 0)
+    })
+  }
+
+  const cleanupMenuWatchers = () => {
+    menuOpenStopHandle?.()
+    menuTypeStopHandle?.()
+    menuOpenStopHandle = null
+    menuTypeStopHandle = null
+  }
+
+  // 主题变化时重新设置图表选项
+  let themeStopHandle: (() => void) | null = null
+
+  const setupThemeWatcher = () => {
+    if (autoTheme) {
+      themeStopHandle = watch(isDark, () => {
+        // 更新空状态样式
+        emptyStateManager.updateStyle()
+
+        if (chart && !isDestroyed) {
+          // 使用 requestAnimationFrame 优化主题更新
+          requestAnimationFrame(() => {
+            if (chart && !isDestroyed) {
+              const currentOptions = chart.getOption()
+              if (currentOptions) {
+                updateChart(currentOptions as EChartsOption)
+              }
+            }
+          })
+        }
+      })
+    }
+  }
+
+  const cleanupThemeWatcher = () => {
+    themeStopHandle?.()
+    themeStopHandle = null
+  }
+
+  // 样式生成器 - 统一的样式配置
+  const createLineStyle = (color: string, width = 1, type?: 'solid' | 'dashed') => ({
+    color,
+    width,
+    ...(type && { type })
+  })
+
+  // 缓存样式配置以减少重复计算
+  const styleCache = {
+    axisLine: null as any,
+    splitLine: null as any,
+    axisLabel: null as any,
+    lastDarkValue: isDark.value
+  }
+
+  const clearStyleCache = () => {
+    styleCache.axisLine = null
+    styleCache.splitLine = null
+    styleCache.axisLabel = null
+    styleCache.lastDarkValue = isDark.value
+  }
+
+  // 坐标轴线样式
+  const getAxisLineStyle = (show: boolean = true) => {
+    if (styleCache.lastDarkValue !== isDark.value) {
+      clearStyleCache()
+    }
+    if (!styleCache.axisLine) {
+      styleCache.axisLine = {
+        show,
+        lineStyle: createLineStyle(isDark.value ? '#444' : '#EDEDED')
+      }
+    }
+    return styleCache.axisLine
+  }
+
+  // 分割线样式
+  const getSplitLineStyle = (show: boolean = true) => {
+    if (styleCache.lastDarkValue !== isDark.value) {
+      clearStyleCache()
+    }
+    if (!styleCache.splitLine) {
+      styleCache.splitLine = {
+        show,
+        lineStyle: createLineStyle(isDark.value ? '#444' : '#EDEDED', 1, 'dashed')
+      }
+    }
+    return styleCache.splitLine
+  }
+
+  // 坐标轴标签样式
+  const getAxisLabelStyle = (show: boolean = true) => {
+    if (styleCache.lastDarkValue !== isDark.value) {
+      clearStyleCache()
+    }
+    if (!styleCache.axisLabel) {
+      const { fontColor, fontSize } = useChartOps()
+      styleCache.axisLabel = {
+        show,
+        color: fontColor,
+        fontSize
+      }
+    }
+    return styleCache.axisLabel
+  }
+
+  // 坐标轴刻度样式（静态配置，无需缓存）
+  const getAxisTickStyle = () => ({
+    show: false
+  })
+
+  // 获取动画配置
+  const getAnimationConfig = (animationDelay: number = 50, animationDuration: number = 1500) => ({
+    animationDelay: (idx: number) => idx * animationDelay + 200,
+    animationDuration: (idx: number) => animationDuration - idx * 50,
+    animationEasing: 'quarticOut' as const
+  })
+
+  // 获取统一的 tooltip 配置
+  const getTooltipStyle = (trigger: 'item' | 'axis' = 'axis', customOptions: any = {}) => ({
+    trigger,
+    backgroundColor: isDark.value ? 'rgba(0, 0, 0, 0.8)' : 'rgba(255, 255, 255, 0.9)',
+    borderColor: isDark.value ? '#333' : '#ddd',
+    borderWidth: 1,
+    textStyle: {
+      color: isDark.value ? '#fff' : '#333'
+    },
+    ...customOptions
+  })
+
+  // 获取统一的图例配置
+  const getLegendStyle = (
+    position: 'bottom' | 'top' | 'left' | 'right' = 'bottom',
+    customOptions: any = {}
+  ) => {
+    const baseConfig = {
+      textStyle: {
+        color: isDark.value ? '#fff' : '#333'
+      },
+      itemWidth: 12,
+      itemHeight: 12,
+      itemGap: 20,
+      ...customOptions
+    }
+
+    // 根据位置设置不同的配置
+    switch (position) {
+      case 'bottom':
+        return {
+          ...baseConfig,
+          bottom: 0,
+          left: 'center',
+          orient: 'horizontal',
+          icon: 'roundRect'
+        }
+      case 'top':
+        return {
+          ...baseConfig,
+          top: 0,
+          left: 'center',
+          orient: 'horizontal',
+          icon: 'roundRect'
+        }
+      case 'left':
+        return {
+          ...baseConfig,
+          left: 0,
+          top: 'center',
+          orient: 'vertical',
+          icon: 'roundRect'
+        }
+      case 'right':
+        return {
+          ...baseConfig,
+          right: 0,
+          top: 'center',
+          orient: 'vertical',
+          icon: 'roundRect'
+        }
+      default:
+        return baseConfig
+    }
+  }
+
+  // 根据图例位置计算 grid 配置
+  const getGridWithLegend = (
+    showLegend: boolean,
+    legendPosition: 'bottom' | 'top' | 'left' | 'right' = 'bottom',
+    baseGrid: any = {}
+  ) => {
+    const defaultGrid = {
+      top: 15,
+      right: 15,
+      bottom: 8,
+      left: 0,
+      containLabel: true,
+      ...baseGrid
+    }
+
+    if (!showLegend) {
+      return defaultGrid
+    }
+
+    // 根据图例位置调整 grid
+    switch (legendPosition) {
+      case 'bottom':
+        return {
+          ...defaultGrid,
+          bottom: 40
+        }
+      case 'top':
+        return {
+          ...defaultGrid,
+          top: 40
+        }
+      case 'left':
+        return {
+          ...defaultGrid,
+          left: 120
+        }
+      case 'right':
+        return {
+          ...defaultGrid,
+          right: 120
+        }
+      default:
+        return defaultGrid
+    }
+  }
+
+  // 创建IntersectionObserver
+  const createIntersectionObserver = () => {
+    if (intersectionObserver || !chartRef.value) return
+
+    intersectionObserver = new IntersectionObserver(
+      (entries) => {
+        entries.forEach((entry) => {
+          if (entry.isIntersecting && pendingOptions && !isDestroyed) {
+            // 使用 requestAnimationFrame 确保在下一帧初始化图表
+            requestAnimationFrame(() => {
+              if (!isDestroyed && pendingOptions) {
+                try {
+                  // 元素变为可见，初始化图表
+                  if (!chart) {
+                    chart = echarts.init(entry.target as HTMLElement)
+                  }
+
+                  // 触发自定义事件，让组件处理动画逻辑
+                  const event = new CustomEvent('chartVisible', {
+                    detail: { options: pendingOptions }
+                  })
+                  entry.target.dispatchEvent(event)
+
+                  pendingOptions = null
+                  cleanupIntersectionObserver()
+                } catch (error) {
+                  console.error('图表初始化失败:', error)
+                }
+              }
+            })
+          }
+        })
+      },
+      { threshold }
+    )
+
+    intersectionObserver.observe(chartRef.value)
+  }
+
+  // 清理IntersectionObserver
+  const cleanupIntersectionObserver = () => {
+    if (intersectionObserver) {
+      intersectionObserver.disconnect()
+      intersectionObserver = null
+    }
+  }
+
+  // 检查容器是否可见
+  const isContainerVisible = (element: HTMLElement): boolean => {
+    const rect = element.getBoundingClientRect()
+    return rect.width > 0 && rect.height > 0 && rect.top < window.innerHeight && rect.bottom > 0
+  }
+
+  // 图表初始化核心逻辑
+  const performChartInit = (options: EChartsOption) => {
+    if (!chart && chartRef.value && !isDestroyed) {
+      chart = echarts.init(chartRef.value)
+      // 图表创建后立即设置监听器
+      setupMenuWatchers()
+      setupThemeWatcher()
+    }
+    if (chart && !isDestroyed) {
+      chart.setOption(options)
+      pendingOptions = null
+    }
+  }
+
+  // 空状态管理器
+  const emptyStateManager = {
+    create: () => {
+      if (!chartRef.value || emptyStateDiv) return
+
+      emptyStateDiv = document.createElement('div')
+      emptyStateDiv.style.cssText = `
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        font-size: 12px;
+        color: ${isDark.value ? '#555555' : '#B3B2B2'};
+        background: transparent;
+        z-index: 10;
+      `
+      emptyStateDiv.innerHTML = `<span>${$t('common.noData')}</span>`
+
+      // 确保父容器有相对定位
+      if (
+        chartRef.value.style.position !== 'relative' &&
+        chartRef.value.style.position !== 'absolute'
+      ) {
+        chartRef.value.style.position = 'relative'
+      }
+
+      chartRef.value.appendChild(emptyStateDiv)
+    },
+
+    remove: () => {
+      if (emptyStateDiv && chartRef.value) {
+        chartRef.value.removeChild(emptyStateDiv)
+        emptyStateDiv = null
+      }
+    },
+
+    updateStyle: () => {
+      if (emptyStateDiv) {
+        emptyStateDiv.style.color = isDark.value ? '#666' : '#999'
+      }
+    }
+  }
+
+  // 初始化图表
+  const initChart = (options: EChartsOption = {}, isEmpty: boolean = false) => {
+    if (!chartRef.value || isDestroyed) return
+
+    const mergedOptions = { ...initOptions, ...options }
+
+    try {
+      if (isEmpty) {
+        // 处理空数据情况 - 显示自定义空状态div
+        if (chart) {
+          chart.clear()
+        }
+        emptyStateManager.create()
+        return
+      } else {
+        // 有数据时移除空状态div
+        emptyStateManager.remove()
+      }
+
+      if (isContainerVisible(chartRef.value)) {
+        // 容器可见，正常初始化
+        if (initDelay > 0) {
+          setTimeout(() => performChartInit(mergedOptions), initDelay)
+        } else {
+          performChartInit(mergedOptions)
+        }
+      } else {
+        // 容器不可见，保存选项并设置监听器
+        pendingOptions = mergedOptions
+        createIntersectionObserver()
+      }
+    } catch (error) {
+      console.error('图表初始化失败:', error)
+    }
+  }
+
+  // 更新图表
+  const updateChart = (options: EChartsOption) => {
+    if (isDestroyed) return
+
+    try {
+      if (!chart) {
+        // 如果图表不存在，先初始化
+        initChart(options)
+        return
+      }
+      chart.setOption(options)
+    } catch (error) {
+      console.error('图表更新失败:', error)
+    }
+  }
+
+  // 处理窗口大小变化
+  const handleResize = () => {
+    if (chart && !isDestroyed) {
+      try {
+        chart.resize()
+      } catch (error) {
+        console.error('图表resize失败:', error)
+      }
+    }
+  }
+
+  // 销毁图表
+  const destroyChart = () => {
+    isDestroyed = true
+
+    if (chart) {
+      try {
+        chart.dispose()
+      } catch (error) {
+        console.error('图表销毁失败:', error)
+      } finally {
+        chart = null
+      }
+    }
+
+    // 清理所有监听器和资源
+    cleanupMenuWatchers()
+    cleanupThemeWatcher()
+    emptyStateManager.remove()
+    cleanupIntersectionObserver()
+    clearTimers()
+    clearStyleCache()
+    pendingOptions = null
+  }
+
+  // 获取图表实例
+  const getChartInstance = () => chart
+
+  // 获取图表是否已初始化
+  const isChartInitialized = () => chart !== null
+
+  onMounted(() => {
+    window.addEventListener('resize', debouncedResize)
+  })
+
+  onBeforeUnmount(() => {
+    window.removeEventListener('resize', debouncedResize)
+  })
+
+  onUnmounted(() => {
+    destroyChart()
+  })
+
+  return {
+    isDark,
+    chartRef,
+    initChart,
+    updateChart,
+    handleResize,
+    destroyChart,
+    getChartInstance,
+    isChartInitialized,
+    emptyStateManager,
+    getAxisLineStyle,
+    getSplitLineStyle,
+    getAxisLabelStyle,
+    getAxisTickStyle,
+    getAnimationConfig,
+    getTooltipStyle,
+    getLegendStyle,
+    useChartOps,
+    getGridWithLegend
+  }
+}
+
+// 高级图表组件抽象
+interface UseChartComponentOptions<T extends BaseChartProps> {
+  /** Props响应式对象 */
+  props: T
+  /** 图表配置生成函数 */
+  generateOptions: () => EChartsOption
+  /** 空数据检查函数 */
+  checkEmpty?: () => boolean
+  /** 自定义监听的响应式数据 */
+  watchSources?: (() => any)[]
+  /** 自定义可视事件处理 */
+  onVisible?: () => void
+  /** useChart选项 */
+  chartOptions?: UseChartOptions
+}
+
+export function useChartComponent<T extends BaseChartProps>(options: UseChartComponentOptions<T>) {
+  const {
+    props,
+    generateOptions,
+    checkEmpty,
+    watchSources = [],
+    onVisible,
+    chartOptions = {}
+  } = options
+
+  const chart = useChart(chartOptions)
+  const { chartRef, initChart, isDark, emptyStateManager } = chart
+
+  // 检查是否为空数据
+  const isEmpty = computed(() => {
+    if (props.isEmpty) return true
+    if (checkEmpty) return checkEmpty()
+    return false
+  })
+
+  // 更新图表
+  const updateChart = () => {
+    nextTick(() => {
+      if (isEmpty.value) {
+        // 处理空数据情况 - 显示自定义空状态div
+        if (chart.getChartInstance()) {
+          chart.getChartInstance()?.clear()
+        }
+        emptyStateManager.create()
+      } else {
+        // 有数据时移除空状态div并初始化图表
+        emptyStateManager.remove()
+        initChart(generateOptions())
+      }
+    })
+  }
+
+  // 处理图表进入可视区域时的逻辑
+  const handleChartVisible = () => {
+    if (onVisible) {
+      onVisible()
+    } else {
+      updateChart()
+    }
+  }
+
+  // 存储监听器停止函数
+  const stopHandles: (() => void)[] = []
+
+  // 设置数据监听
+  const setupWatchers = () => {
+    // 监听自定义数据源
+    if (watchSources.length > 0) {
+      const stopHandle = watch(watchSources, updateChart, { deep: true })
+      stopHandles.push(stopHandle)
+    }
+
+    // 监听主题变化
+    const themeStopHandle = watch(isDark, () => {
+      emptyStateManager.updateStyle()
+      updateChart()
+    })
+    stopHandles.push(themeStopHandle)
+  }
+
+  // 清理所有监听器
+  const cleanupWatchers = () => {
+    stopHandles.forEach((stop) => stop())
+    stopHandles.length = 0
+  }
+
+  // 设置生命周期
+  const setupLifecycle = () => {
+    onMounted(() => {
+      updateChart()
+
+      // 监听图表可见事件
+      if (chartRef.value) {
+        chartRef.value.addEventListener('chartVisible', handleChartVisible)
+      }
+    })
+
+    onBeforeUnmount(() => {
+      // 清理事件监听器
+      if (chartRef.value) {
+        chartRef.value.removeEventListener('chartVisible', handleChartVisible)
+      }
+      // 清理所有监听器
+      cleanupWatchers()
+      // 清理空状态div
+      emptyStateManager.remove()
+    })
+  }
+
+  // 初始化
+  setupWatchers()
+  setupLifecycle()
+
+  return {
+    ...chart,
+    isEmpty,
+    updateChart,
+    handleChartVisible
+  }
+}
diff --git a/web/src/hooks/core/useCommon.ts b/web/src/hooks/core/useCommon.ts
new file mode 100644
index 0000000..c936854
--- /dev/null
+++ b/web/src/hooks/core/useCommon.ts
@@ -0,0 +1,87 @@
+/**
+ * useCommon - 通用功能集合
+ *
+ * 提供常用的页面操作功能，包括页面刷新、滚动控制、路径获取等。
+ * 这些功能在多个页面和组件中都会用到，统一封装便于复用。
+ *
+ * ## 主要功能
+ *
+ * 1. 首页路径 - 获取系统配置的首页路径
+ * 2. 页面刷新 - 刷新当前页面内容
+ * 3. 滚动控制 - 提供多种滚动到顶部和指定位置的方法
+ * 4. 平滑滚动 - 支持平滑滚动动画效果
+ *
+ * @module useCommon
+ * @author Art Design Pro Team
+ */
+
+import { computed } from 'vue'
+import { useMenuStore } from '@/store/modules/menu'
+import { useSettingStore } from '@/store/modules/setting'
+
+export function useCommon() {
+  const menuStore = useMenuStore()
+  const settingStore = useSettingStore()
+
+  /**
+   * 首页路径
+   * 从菜单 store 中获取配置的首页路径
+   */
+  const homePath = computed(() => menuStore.getHomePath())
+
+  /**
+   * 刷新当前页面
+   * 通过切换 setting store 中的 refresh 状态触发页面重新渲染
+   */
+  const refresh = () => {
+    settingStore.reload()
+  }
+
+  /**
+   * 滚动到页面顶部
+   * 查找主内容区域并将其滚动位置重置为顶部
+   */
+  const scrollToTop = () => {
+    const scrollContainer = document.getElementById('app-main')
+    if (scrollContainer) {
+      scrollContainer.scrollTop = 0
+    }
+  }
+
+  /**
+   * 平滑滚动到页面顶部
+   * 使用 smooth 行为实现平滑滚动效果
+   */
+  const smoothScrollToTop = () => {
+    const scrollContainer = document.getElementById('app-main')
+    if (scrollContainer) {
+      scrollContainer.scrollTo({
+        top: 0,
+        behavior: 'smooth'
+      })
+    }
+  }
+
+  /**
+   * 滚动到指定位置
+   * @param top 目标滚动位置（像素）
+   * @param smooth 是否使用平滑滚动
+   */
+  const scrollTo = (top: number, smooth: boolean = false) => {
+    const scrollContainer = document.getElementById('app-main')
+    if (scrollContainer) {
+      scrollContainer.scrollTo({
+        top,
+        behavior: smooth ? 'smooth' : 'auto'
+      })
+    }
+  }
+
+  return {
+    homePath,
+    refresh,
+    scrollTo,
+    scrollToTop,
+    smoothScrollToTop
+  }
+}
diff --git a/web/src/hooks/core/useFastEnter.ts b/web/src/hooks/core/useFastEnter.ts
new file mode 100644
index 0000000..555eb65
--- /dev/null
+++ b/web/src/hooks/core/useFastEnter.ts
@@ -0,0 +1,55 @@
+/**
+ * useFastEnter - 快速入口管理
+ *
+ * 管理顶部栏的快速入口功能，提供应用列表和快速链接的配置和过滤。
+ * 支持动态启用/禁用、自定义排序、响应式宽度控制等功能。
+ *
+ * ## 主要功能
+ *
+ * 1. 应用列表管理 - 获取启用的应用列表，自动按排序权重排序
+ * 2. 快速链接管理 - 获取启用的快速链接，支持自定义排序
+ * 3. 响应式配置 - 所有配置自动响应变化，无需手动更新
+ * 4. 宽度控制 - 提供最小显示宽度配置，支持响应式布局
+ *
+ * @module useFastEnter
+ * @author Art Design Pro Team
+ */
+
+import { computed } from 'vue'
+import appConfig from '@/config'
+import type { FastEnterApplication, FastEnterQuickLink } from '@/types/config'
+
+export function useFastEnter() {
+  // 获取快速入口配置
+  const fastEnterConfig = computed(() => appConfig.fastEnter)
+
+  // 获取启用的应用列表（按排序权重排序）
+  const enabledApplications = computed<FastEnterApplication[]>(() => {
+    if (!fastEnterConfig.value?.applications) return []
+
+    return fastEnterConfig.value.applications
+      .filter((app) => app.enabled !== false)
+      .sort((a, b) => (a.order || 0) - (b.order || 0))
+  })
+
+  // 获取启用的快速链接（按排序权重排序）
+  const enabledQuickLinks = computed<FastEnterQuickLink[]>(() => {
+    if (!fastEnterConfig.value?.quickLinks) return []
+
+    return fastEnterConfig.value.quickLinks
+      .filter((link) => link.enabled !== false)
+      .sort((a, b) => (a.order || 0) - (b.order || 0))
+  })
+
+  // 获取最小显示宽度
+  const minWidth = computed(() => {
+    return fastEnterConfig.value?.minWidth || 1200
+  })
+
+  return {
+    fastEnterConfig,
+    enabledApplications,
+    enabledQuickLinks,
+    minWidth
+  }
+}
diff --git a/web/src/hooks/core/useHeaderBar.ts b/web/src/hooks/core/useHeaderBar.ts
new file mode 100644
index 0000000..be10712
--- /dev/null
+++ b/web/src/hooks/core/useHeaderBar.ts
@@ -0,0 +1,201 @@
+/**
+ * useHeaderBar - 顶部栏功能管理
+ *
+ * 统一管理顶部栏各个功能模块的显示状态和配置信息。
+ * 提供灵活的功能开关控制，支持动态显示/隐藏顶部栏的各个功能按钮。
+ *
+ * ## 主要功能
+ *
+ * 1. 功能开关控制 - 统一管理菜单按钮、刷新按钮、快速入口等功能的显示状态
+ * 2. 配置信息获取 - 获取各个功能模块的详细配置信息
+ * 3. 功能列表查询 - 快速获取所有启用或禁用的功能列表
+ * 4. 响应式状态 - 所有状态自动响应配置和 store 变化
+ *
+ * @module useHeaderBar
+ * @author Art Design Pro Team
+ */
+
+import { computed } from 'vue'
+import { storeToRefs } from 'pinia'
+import { useSettingStore } from '@/store/modules/setting'
+import { headerBarConfig } from '@/config/modules/headerBar'
+import { HeaderBarFeatureConfig } from '@/types'
+
+/**
+ * 顶部栏功能管理
+ * @returns 顶部栏功能相关的状态和方法
+ */
+export function useHeaderBar() {
+  const settingStore = useSettingStore()
+
+  // 获取顶部栏配置
+  const headerBarConfigRef = computed<HeaderBarFeatureConfig>(() => headerBarConfig)
+
+  // 从store中获取相关状态
+  const { showMenuButton, showFastEnter, showRefreshButton, showCrumbs, showLanguage } =
+    storeToRefs(settingStore)
+
+  /**
+   * 检查特定功能是否启用
+   * @param feature 功能名称
+   * @returns 是否启用
+   */
+  const isFeatureEnabled = (feature: keyof HeaderBarFeatureConfig): boolean => {
+    return headerBarConfigRef.value[feature]?.enabled ?? false
+  }
+
+  /**
+   * 获取功能配置信息
+   * @param feature 功能名称
+   * @returns 功能配置信息
+   */
+  const getFeatureConfig = (feature: keyof HeaderBarFeatureConfig) => {
+    return headerBarConfigRef.value[feature]
+  }
+
+  // 检查菜单按钮是否显示
+  const shouldShowMenuButton = computed(() => {
+    return isFeatureEnabled('menuButton') && showMenuButton.value
+  })
+
+  // 检查刷新按钮是否显示
+  const shouldShowRefreshButton = computed(() => {
+    return isFeatureEnabled('refreshButton') && showRefreshButton.value
+  })
+
+  // 检查快速入口是否显示
+  const shouldShowFastEnter = computed(() => {
+    return isFeatureEnabled('fastEnter') && showFastEnter.value
+  })
+
+  // 检查面包屑是否显示
+  const shouldShowBreadcrumb = computed(() => {
+    return isFeatureEnabled('breadcrumb') && showCrumbs.value
+  })
+
+  // 检查全局搜索是否显示
+  const shouldShowGlobalSearch = computed(() => {
+    return isFeatureEnabled('globalSearch')
+  })
+
+  // 检查全屏按钮是否显示
+  const shouldShowFullscreen = computed(() => {
+    return isFeatureEnabled('fullscreen')
+  })
+
+  // 检查通知中心是否显示
+  const shouldShowNotification = computed(() => {
+    return isFeatureEnabled('notification')
+  })
+
+  // 检查聊天功能是否显示
+  const shouldShowChat = computed(() => {
+    return isFeatureEnabled('chat')
+  })
+
+  // 检查语言切换是否显示
+  const shouldShowLanguage = computed(() => {
+    return isFeatureEnabled('language') && showLanguage.value
+  })
+
+  // 检查设置面板是否显示
+  const shouldShowSettings = computed(() => {
+    return isFeatureEnabled('settings')
+  })
+
+  // 检查主题切换是否显示
+  const shouldShowThemeToggle = computed(() => {
+    return isFeatureEnabled('themeToggle')
+  })
+
+  // 获取快速入口的最小宽度
+  const fastEnterMinWidth = computed(() => {
+    const config = getFeatureConfig('fastEnter')
+    return (config as any)?.minWidth || 1200
+  })
+
+  /**
+   * 检查功能是否启用（别名）
+   * @param feature 功能名称
+   * @returns 是否启用
+   */
+  const isFeatureActive = (feature: keyof HeaderBarFeatureConfig): boolean => {
+    return isFeatureEnabled(feature)
+  }
+
+  /**
+   * 获取功能配置（别名）
+   * @param feature 功能名称
+   * @returns 功能配置
+   */
+  const getFeatureInfo = (feature: keyof HeaderBarFeatureConfig) => {
+    return getFeatureConfig(feature)
+  }
+
+  /**
+   * 获取所有启用的功能列表
+   * @returns 启用的功能名称数组
+   */
+  const getEnabledFeatures = (): (keyof HeaderBarFeatureConfig)[] => {
+    return Object.keys(headerBarConfigRef.value).filter(
+      (key) => headerBarConfigRef.value[key as keyof HeaderBarFeatureConfig]?.enabled
+    ) as (keyof HeaderBarFeatureConfig)[]
+  }
+
+  /**
+   * 获取所有禁用的功能列表
+   * @returns 禁用的功能名称数组
+   */
+  const getDisabledFeatures = (): (keyof HeaderBarFeatureConfig)[] => {
+    return Object.keys(headerBarConfigRef.value).filter(
+      (key) => !headerBarConfigRef.value[key as keyof HeaderBarFeatureConfig]?.enabled
+    ) as (keyof HeaderBarFeatureConfig)[]
+  }
+
+  /**
+   * 获取所有启用的功能（别名）
+   * @returns 启用的功能列表
+   */
+  const getActiveFeatures = () => {
+    return getEnabledFeatures()
+  }
+
+  /**
+   * 获取所有禁用的功能（别名）
+   * @returns 禁用的功能列表
+   */
+  const getInactiveFeatures = () => {
+    return getDisabledFeatures()
+  }
+
+  return {
+    // 配置
+    headerBarConfig: headerBarConfigRef,
+
+    // 显示状态计算属性
+    shouldShowMenuButton, // 是否显示菜单按钮
+    shouldShowRefreshButton, // 是否显示刷新按钮
+    shouldShowFastEnter, // 是否显示快速入口
+    shouldShowBreadcrumb, // 是否显示面包屑
+    shouldShowGlobalSearch, // 是否显示全局搜索
+    shouldShowFullscreen, // 是否显示全屏按钮
+    shouldShowNotification, // 是否显示通知中心
+    shouldShowChat, // 是否显示聊天功能
+    shouldShowLanguage, // 是否显示语言切换
+    shouldShowSettings, // 是否显示设置面板
+    shouldShowThemeToggle, // 是否显示主题切换
+
+    // 配置相关
+    fastEnterMinWidth, // 快速入口最小宽度
+
+    // 方法
+    isFeatureEnabled, // 检查功能是否启用
+    isFeatureActive, // 检查功能是否启用（别名）
+    getFeatureConfig, // 获取功能配置
+    getFeatureInfo, // 获取功能配置（别名）
+    getEnabledFeatures, // 获取所有启用的功能
+    getDisabledFeatures, // 获取所有禁用的功能
+    getActiveFeatures, // 获取所有启用的功能（别名）
+    getInactiveFeatures // 获取所有禁用的功能（别名）
+  }
+}
diff --git a/web/src/hooks/core/useLayoutHeight.ts b/web/src/hooks/core/useLayoutHeight.ts
new file mode 100644
index 0000000..4b1171a
--- /dev/null
+++ b/web/src/hooks/core/useLayoutHeight.ts
@@ -0,0 +1,148 @@
+/**
+ * useLayoutHeight - 页面布局高度管理
+ *
+ * 自动计算和管理页面内容区域的高度，确保内容区域能够正确填充剩余空间。
+ * 监听头部元素高度变化，动态调整内容区域高度，避免出现滚动条或布局错乱。
+ *
+ * ## 主要功能
+ *
+ * 1. 动态高度计算 - 根据头部元素高度自动计算内容区域高度
+ * 2. 响应式监听 - 自动监听元素尺寸变化并更新高度
+ * 3. CSS 变量同步 - 自动更新 CSS 变量，方便全局使用
+ * 4. 灵活配置 - 支持自定义间距、CSS 变量名等
+ * 5. 自动查找模式 - 提供通过 ID 自动查找元素的便捷方式
+ *
+ * @module useLayoutHeight
+ * @author Art Design Pro Team
+ */
+
+import { ref, computed, watch, onMounted } from 'vue'
+import { useElementSize } from '@vueuse/core'
+
+/**
+ * 页面容器高度配置
+ */
+interface LayoutHeightOptions {
+  /** 额外的间距（默认 15px） */
+  extraSpacing?: number
+  /** 是否自动更新 CSS 变量（默认 true） */
+  updateCssVar?: boolean
+  /** CSS 变量名称（默认 '--art-full-height'） */
+  cssVarName?: string
+}
+
+export function useLayoutHeight(options: LayoutHeightOptions = {}) {
+  const { extraSpacing = 15, updateCssVar = true, cssVarName = '--art-full-height' } = options
+
+  // 元素引用
+  const headerRef = ref<HTMLElement>()
+  const contentHeaderRef = ref<HTMLElement>()
+
+  // 使用 VueUse 自动监听元素尺寸变化
+  const { height: headerHeight } = useElementSize(headerRef)
+  const { height: contentHeaderHeight } = useElementSize(contentHeaderRef)
+
+  // 计算容器最小高度（响应式）
+  const containerMinHeight = computed(() => {
+    const totalHeight = headerHeight.value + contentHeaderHeight.value + extraSpacing
+    return `calc(100vh - ${totalHeight}px)`
+  })
+
+  if (updateCssVar) {
+    watch(
+      containerMinHeight,
+      (newHeight) => {
+        requestAnimationFrame(() => {
+          document.documentElement.style.setProperty(cssVarName, newHeight)
+        })
+      },
+      { immediate: true }
+    )
+  }
+
+  return {
+    /** 容器最小高度（响应式） */
+    containerMinHeight,
+    /** 头部元素引用 */
+    headerRef,
+    /** 内容头部元素引用 */
+    contentHeaderRef,
+    /** 头部高度（响应式） */
+    headerHeight,
+    /** 内容头部高度（响应式） */
+    contentHeaderHeight
+  }
+}
+
+/**
+ * 通过 ID 自动查找元素的布局高度管理
+ * 适用于无法直接获取元素引用的场景
+ *
+ * @param headerIds 头部元素的 ID 数组
+ * @param options 配置选项
+ *
+ * ```
+ */
+export function useAutoLayoutHeight(
+  headerIds: string[] = ['app-header', 'app-content-header'],
+  options: LayoutHeightOptions = {}
+) {
+  const { extraSpacing = 15, updateCssVar = true, cssVarName = '--art-full-height' } = options
+
+  // 创建元素引用
+  const headerRef = ref<HTMLElement>()
+  const contentHeaderRef = ref<HTMLElement>()
+
+  // 使用 VueUse 自动监听元素尺寸变化
+  const { height: headerHeight } = useElementSize(headerRef)
+  const { height: contentHeaderHeight } = useElementSize(contentHeaderRef)
+
+  // 计算容器最小高度（响应式）
+  const containerMinHeight = computed(() => {
+    const totalHeight = headerHeight.value + contentHeaderHeight.value + extraSpacing
+    return `calc(100vh - ${totalHeight}px)`
+  })
+
+  if (updateCssVar) {
+    watch(
+      containerMinHeight,
+      (newHeight) => {
+        requestAnimationFrame(() => {
+          document.documentElement.style.setProperty(cssVarName, newHeight)
+        })
+      },
+      { immediate: true }
+    )
+  }
+
+  // 在 DOM 挂载后查找元素
+  onMounted(() => {
+    if (typeof document !== 'undefined') {
+      // 使用 nextTick 确保 DOM 完全渲染
+      requestAnimationFrame(() => {
+        const header = document.getElementById(headerIds[0])
+        const contentHeader = document.getElementById(headerIds[1])
+
+        if (header) {
+          headerRef.value = header
+        }
+        if (contentHeader) {
+          contentHeaderRef.value = contentHeader
+        }
+      })
+    }
+  })
+
+  return {
+    /** 容器最小高度（响应式） */
+    containerMinHeight,
+    /** 头部元素引用 */
+    headerRef,
+    /** 内容头部元素引用 */
+    contentHeaderRef,
+    /** 头部高度（响应式） */
+    headerHeight,
+    /** 内容头部高度（响应式） */
+    contentHeaderHeight
+  }
+}
diff --git a/web/src/hooks/core/useTable.ts b/web/src/hooks/core/useTable.ts
new file mode 100644
index 0000000..d9def4f
--- /dev/null
+++ b/web/src/hooks/core/useTable.ts
@@ -0,0 +1,762 @@
+/**
+ * useTable - 企业级表格数据管理方案
+ *
+ * 功能完整的表格数据管理解决方案，专为后台管理系统设计。
+ * 封装了表格开发中的所有常见需求，让你专注于业务逻辑。
+ *
+ * ## 主要功能
+ *
+ * 1. 数据管理 - 自动处理 API 请求、响应转换、加载状态和错误处理
+ * 2. 分页控制 - 自动同步分页状态、移动端适配、智能页码边界处理
+ * 3. 搜索功能 - 防抖搜索优化、参数管理、一键重置、参数过滤
+ * 4. 缓存系统 - 智能请求缓存、多种清理策略、自动过期管理、统计信息
+ * 5. 刷新策略 - 提供 5 种刷新方法适配不同业务场景（新增/更新/删除/手动/定时）
+ * 6. 列配置管理 - 动态显示/隐藏列、列排序、配置持久化、批量操作（可选）
+ *
+ * @module useTable
+ * @author Art Design Pro Team
+ */
+
+import { ref, reactive, computed, onMounted, onUnmounted, nextTick, readonly } from 'vue'
+import { useWindowSize } from '@vueuse/core'
+import { useTableColumns } from './useTableColumns'
+import type { ColumnOption } from '@/types/component'
+import {
+  TableCache,
+  CacheInvalidationStrategy,
+  type ApiResponse
+} from '../../utils/table/tableCache'
+import {
+  type TableError,
+  defaultResponseAdapter,
+  extractTableData,
+  updatePaginationFromResponse,
+  createSmartDebounce,
+  createErrorHandler
+} from '../../utils/table/tableUtils'
+import { tableConfig } from '../../utils/table/tableConfig'
+
+// 类型推导工具类型
+type InferApiParams<T> = T extends (params: infer P) => any ? P : never
+type InferApiResponse<T> = T extends (params: any) => Promise<infer R> ? R : never
+type InferRecordType<T> = T extends Api.Common.PaginatedResponse<infer U> ? U : never
+
+// 优化的配置接口 - 支持自动类型推导
+export interface UseTableConfig<
+  TApiFn extends (params: any) => Promise<any> = (params: any) => Promise<any>,
+  TRecord = InferRecordType<InferApiResponse<TApiFn>>,
+  TParams = InferApiParams<TApiFn>,
+  TResponse = InferApiResponse<TApiFn>
+> {
+  // 核心配置
+  core: {
+    /** API 请求函数 */
+    apiFn: TApiFn
+    /** 默认请求参数 */
+    apiParams?: Partial<TParams>
+    /** 排除 apiParams 中的属性 */
+    excludeParams?: string[]
+    /** 是否立即加载数据 */
+    immediate?: boolean
+    /** 列配置工厂函数 */
+    columnsFactory?: () => ColumnOption<TRecord>[]
+    /** 自定义分页字段映射 */
+    paginationKey?: {
+      /** 当前页码字段名，默认为 'current' */
+      current?: string
+      /** 每页条数字段名，默认为 'size' */
+      size?: string
+    }
+  }
+
+  // 数据处理
+  transform?: {
+    /** 数据转换函数 */
+    dataTransformer?: (data: TRecord[]) => TRecord[]
+    /** 响应数据适配器 */
+    responseAdapter?: (response: TResponse) => ApiResponse<TRecord>
+  }
+
+  // 性能优化
+  performance?: {
+    /** 是否启用缓存 */
+    enableCache?: boolean
+    /** 缓存时间（毫秒） */
+    cacheTime?: number
+    /** 防抖延迟时间（毫秒） */
+    debounceTime?: number
+    /** 最大缓存条数限制 */
+    maxCacheSize?: number
+  }
+
+  // 生命周期钩子
+  hooks?: {
+    /** 数据加载成功回调（仅网络请求成功时触发） */
+    onSuccess?: (data: TRecord[], response: ApiResponse<TRecord>) => void
+    /** 错误处理回调 */
+    onError?: (error: TableError) => void
+    /** 缓存命中回调（从缓存获取数据时触发） */
+    onCacheHit?: (data: TRecord[], response: ApiResponse<TRecord>) => void
+    /** 加载状态变化回调 */
+    onLoading?: (loading: boolean) => void
+    /** 重置表单回调函数 */
+    resetFormCallback?: () => void
+  }
+
+  // 调试配置
+  debug?: {
+    /** 是否启用日志输出 */
+    enableLog?: boolean
+    /** 日志级别 */
+    logLevel?: 'info' | 'warn' | 'error'
+  }
+}
+
+export function useTable<TApiFn extends (params: any) => Promise<any>>(
+  config: UseTableConfig<TApiFn>
+) {
+  return useTableImpl(config)
+}
+
+/**
+ * useTable 的核心实现 - 强大的表格数据管理 Hook
+ *
+ * 提供完整的表格解决方案，包括：
+ * - 数据获取与缓存
+ * - 分页控制
+ * - 搜索功能
+ * - 智能刷新策略
+ * - 错误处理
+ * - 列配置管理
+ */
+function useTableImpl<TApiFn extends (params: any) => Promise<any>>(
+  config: UseTableConfig<TApiFn>
+) {
+  type TRecord = InferRecordType<InferApiResponse<TApiFn>>
+  type TParams = InferApiParams<TApiFn>
+  const {
+    core: {
+      apiFn,
+      apiParams = {} as Partial<TParams>,
+      excludeParams = [],
+      immediate = true,
+      columnsFactory,
+      paginationKey
+    },
+    transform: { dataTransformer, responseAdapter = defaultResponseAdapter } = {},
+    performance: {
+      enableCache = false,
+      cacheTime = 5 * 60 * 1000,
+      debounceTime = 300,
+      maxCacheSize = 50
+    } = {},
+    hooks: { onSuccess, onError, onCacheHit, resetFormCallback } = {},
+    debug: { enableLog = false } = {}
+  } = config
+
+  // 分页字段名配置：优先使用传入的配置，否则使用全局配置
+  const pageKey = paginationKey?.current || tableConfig.paginationKey.current
+  const sizeKey = paginationKey?.size || tableConfig.paginationKey.size
+
+  // 响应式触发器，用于手动更新缓存统计信息
+  const cacheUpdateTrigger = ref(0)
+
+  // 日志工具函数
+  const logger = {
+    log: (message: string, ...args: unknown[]) => {
+      if (enableLog) {
+        console.log(`[useTable] ${message}`, ...args)
+      }
+    },
+    warn: (message: string, ...args: unknown[]) => {
+      if (enableLog) {
+        console.warn(`[useTable] ${message}`, ...args)
+      }
+    },
+    error: (message: string, ...args: unknown[]) => {
+      if (enableLog) {
+        console.error(`[useTable] ${message}`, ...args)
+      }
+    }
+  }
+
+  // 缓存实例
+  const cache = enableCache ? new TableCache<TRecord>(cacheTime, maxCacheSize, enableLog) : null
+
+  // 加载状态机
+  type LoadingState = 'idle' | 'loading' | 'success' | 'error'
+  const loadingState = ref<LoadingState>('idle')
+  const loading = computed(() => loadingState.value === 'loading')
+
+  // 错误状态
+  const error = ref<TableError | null>(null)
+
+  // 表格数据
+  const data = ref<TRecord[]>([])
+
+  // 请求取消控制器
+  let abortController: AbortController | null = null
+
+  // 缓存清理定时器
+  let cacheCleanupTimer: NodeJS.Timeout | null = null
+
+  // 搜索参数
+  const searchParams = reactive(
+    Object.assign(
+      {
+        [pageKey]: 1,
+        [sizeKey]: 10
+      },
+      apiParams || {}
+    ) as TParams
+  )
+
+  // 分页配置
+  const pagination = reactive<Api.Common.PaginationParams>({
+    current: ((searchParams as Record<string, unknown>)[pageKey] as number) || 1,
+    size: ((searchParams as Record<string, unknown>)[sizeKey] as number) || 10,
+    total: 0
+  })
+
+  // 移动端分页 (响应式)
+  const { width } = useWindowSize()
+  const mobilePagination = computed(() => ({
+    ...pagination,
+    small: width.value < 768
+  }))
+
+  // 列配置
+  const columnConfig = columnsFactory ? useTableColumns<TRecord>(columnsFactory) : null
+  const columns = columnConfig?.columns
+  const columnChecks = columnConfig?.columnChecks
+
+  // 是否有数据
+  const hasData = computed(() => data.value.length > 0)
+
+  // 缓存统计信息
+  const cacheInfo = computed(() => {
+    // 依赖触发器，确保缓存变化时重新计算
+    void cacheUpdateTrigger.value
+    if (!cache) return { total: 0, size: '0KB', hitRate: '0 avg hits' }
+    return cache.getStats()
+  })
+
+  // 错误处理函数
+  const handleError = createErrorHandler(onError, enableLog)
+
+  // 清理缓存，根据不同的业务场景选择性地清理缓存
+  const clearCache = (strategy: CacheInvalidationStrategy, context?: string): void => {
+    if (!cache) return
+
+    let clearedCount = 0
+
+    switch (strategy) {
+      case CacheInvalidationStrategy.CLEAR_ALL:
+        cache.clear()
+        logger.log(`清空所有缓存 - ${context || ''}`)
+        break
+
+      case CacheInvalidationStrategy.CLEAR_CURRENT:
+        clearedCount = cache.clearCurrentSearch(searchParams)
+        logger.log(`清空当前搜索缓存 ${clearedCount} 条 - ${context || ''}`)
+        break
+
+      case CacheInvalidationStrategy.CLEAR_PAGINATION:
+        clearedCount = cache.clearPagination()
+        logger.log(`清空分页缓存 ${clearedCount} 条 - ${context || ''}`)
+        break
+
+      case CacheInvalidationStrategy.KEEP_ALL:
+      default:
+        logger.log(`保持缓存不变 - ${context || ''}`)
+        break
+    }
+    // 手动触发缓存状态更新
+    cacheUpdateTrigger.value++
+  }
+
+  // 获取数据的核心方法
+  const fetchData = async (
+    params?: Partial<TParams>,
+    useCache = enableCache
+  ): Promise<ApiResponse<TRecord>> => {
+    // 取消上一个请求
+    if (abortController) {
+      abortController.abort()
+    }
+
+    // 创建新的取消控制器
+    const currentController = new AbortController()
+    abortController = currentController
+
+    // 状态机：进入 loading 状态
+    loadingState.value = 'loading'
+    error.value = null
+
+    try {
+      let requestParams = Object.assign(
+        {},
+        searchParams,
+        {
+          [pageKey]: pagination.current,
+          [sizeKey]: pagination.size
+        },
+        params || {}
+      ) as TParams
+
+      // 剔除不需要的参数
+      if (excludeParams.length > 0) {
+        const filteredParams = { ...requestParams }
+        excludeParams.forEach((key) => {
+          delete (filteredParams as Record<string, unknown>)[key]
+        })
+        requestParams = filteredParams as TParams
+      }
+
+      // 检查缓存
+      if (useCache && cache) {
+        const cachedItem = cache.get(requestParams)
+        if (cachedItem) {
+          data.value = cachedItem.data
+          updatePaginationFromResponse(pagination, cachedItem.response)
+
+          // 修复：避免重复设置相同的值，防止响应式循环更新
+          const paramsRecord = searchParams as Record<string, unknown>
+          if (paramsRecord[pageKey] !== pagination.current) {
+            paramsRecord[pageKey] = pagination.current
+          }
+          if (paramsRecord[sizeKey] !== pagination.size) {
+            paramsRecord[sizeKey] = pagination.size
+          }
+
+          // 状态机：缓存命中，进入 success 状态
+          loadingState.value = 'success'
+
+          // 缓存命中时触发专门的回调，而不是 onSuccess
+          if (onCacheHit) {
+            onCacheHit(cachedItem.data, cachedItem.response)
+          }
+
+          logger.log(`缓存命中`)
+          return cachedItem.response
+        }
+      }
+
+      const response = await apiFn(requestParams)
+
+      // 检查请求是否被取消
+      if (currentController.signal.aborted) {
+        throw new Error('请求已取消')
+      }
+
+      // 使用响应适配器转换为标准格式
+      const standardResponse = responseAdapter(response)
+
+      // 处理响应数据
+      let tableData = extractTableData(standardResponse)
+
+      // 应用数据转换函数
+      if (dataTransformer) {
+        tableData = dataTransformer(tableData)
+      }
+
+      // 更新状态
+      data.value = tableData
+      updatePaginationFromResponse(pagination, standardResponse)
+
+      // 修复：避免重复设置相同的值，防止响应式循环更新
+      const paramsRecord = searchParams as Record<string, unknown>
+      if (paramsRecord[pageKey] !== pagination.current) {
+        paramsRecord[pageKey] = pagination.current
+      }
+      if (paramsRecord[sizeKey] !== pagination.size) {
+        paramsRecord[sizeKey] = pagination.size
+      }
+
+      // 缓存数据
+      if (useCache && cache) {
+        cache.set(requestParams, tableData, standardResponse)
+        // 手动触发缓存状态更新
+        cacheUpdateTrigger.value++
+        logger.log(`数据已缓存`)
+      }
+
+      // 状态机：请求成功，进入 success 状态
+      loadingState.value = 'success'
+
+      // 成功回调
+      if (onSuccess) {
+        onSuccess(tableData, standardResponse)
+      }
+
+      return standardResponse
+    } catch (err) {
+      if (err instanceof Error && err.message === '请求已取消') {
+        // 请求被取消，回到 idle 状态
+        loadingState.value = 'idle'
+        return { records: [], total: 0, current: 1, size: 10 }
+      }
+
+      // 状态机：请求失败，进入 error 状态
+      loadingState.value = 'error'
+      data.value = []
+      const tableError = handleError(err, '获取表格数据失败')
+      throw tableError
+    } finally {
+      // 只有当前控制器是活跃的才清空
+      if (abortController === currentController) {
+        abortController = null
+      }
+    }
+  }
+
+  // 获取数据 (保持当前页)
+  const getData = async (params?: Partial<TParams>): Promise<ApiResponse<TRecord> | void> => {
+    try {
+      return await fetchData(params)
+    } catch {
+      // 错误已在 fetchData 中处理
+      return Promise.resolve()
+    }
+  }
+
+  // 分页获取数据 (重置到第一页) - 专门用于搜索场景
+  const getDataByPage = async (params?: Partial<TParams>): Promise<ApiResponse<TRecord> | void> => {
+    pagination.current = 1
+    ;(searchParams as Record<string, unknown>)[pageKey] = 1
+
+    // 搜索时清空当前搜索条件的缓存，确保获取最新数据
+    clearCache(CacheInvalidationStrategy.CLEAR_CURRENT, '搜索数据')
+
+    try {
+      return await fetchData(params, false) // 搜索时不使用缓存
+    } catch {
+      // 错误已在 fetchData 中处理
+      return Promise.resolve()
+    }
+  }
+
+  // 智能防抖搜索函数
+  const debouncedGetDataByPage = createSmartDebounce(getDataByPage, debounceTime)
+
+  // 重置搜索参数
+  const resetSearchParams = async (): Promise<void> => {
+    // 取消防抖的搜索
+    debouncedGetDataByPage.cancel()
+
+    // 保存分页相关的默认值
+    const paramsRecord = searchParams as Record<string, unknown>
+    const defaultPagination = {
+      [pageKey]: 1,
+      [sizeKey]: (paramsRecord[sizeKey] as number) || 10
+    }
+
+    // 清空所有搜索参数
+    Object.keys(searchParams).forEach((key) => {
+      delete paramsRecord[key]
+    })
+
+    // 重新设置默认参数
+    Object.assign(searchParams, apiParams || {}, defaultPagination)
+
+    // 重置分页
+    pagination.current = 1
+    pagination.size = defaultPagination[sizeKey] as number
+
+    // 清空错误状态
+    error.value = null
+
+    // 清空缓存
+    clearCache(CacheInvalidationStrategy.CLEAR_ALL, '重置搜索')
+
+    // 重新获取数据
+    await getData()
+
+    // 执行重置回调
+    if (resetFormCallback) {
+      await nextTick()
+      resetFormCallback()
+    }
+  }
+
+  // 替换搜索参数：适用于表单查询，避免旧字段残留
+  const replaceSearchParams = (params?: Partial<TParams>): void => {
+    const paramsRecord = searchParams as Record<string, unknown>
+    const currentSize = pagination.size || ((paramsRecord[sizeKey] as number) ?? 10)
+
+    Object.keys(searchParams).forEach((key) => {
+      if (key !== pageKey && key !== sizeKey) {
+        delete paramsRecord[key]
+      }
+    })
+
+    Object.assign(
+      searchParams,
+      {
+        [pageKey]: 1,
+        [sizeKey]: currentSize
+      },
+      params || {}
+    )
+
+    pagination.current = 1
+    pagination.size = currentSize
+  }
+
+  // 防重复调用的标志
+  let isCurrentChanging = false
+
+  // 处理分页大小变化
+  const handleSizeChange = async (newSize: number): Promise<void> => {
+    if (newSize <= 0) return
+
+    debouncedGetDataByPage.cancel()
+
+    const paramsRecord = searchParams as Record<string, unknown>
+    pagination.size = newSize
+    pagination.current = 1
+    paramsRecord[sizeKey] = newSize
+    paramsRecord[pageKey] = 1
+
+    clearCache(CacheInvalidationStrategy.CLEAR_CURRENT, '分页大小变化')
+
+    await getData()
+  }
+
+  // 处理当前页变化
+  const handleCurrentChange = async (newCurrent: number): Promise<void> => {
+    if (newCurrent <= 0) return
+
+    // 修复：防止重复调用
+    if (isCurrentChanging) {
+      return
+    }
+
+    // 修复：如果当前页没有变化，不需要重新请求
+    if (pagination.current === newCurrent) {
+      logger.log('分页页码未变化，跳过请求')
+      return
+    }
+
+    try {
+      isCurrentChanging = true
+
+      // 修复：只更新必要的状态
+      const paramsRecord = searchParams as Record<string, unknown>
+      pagination.current = newCurrent
+      // 只有当 searchParams 的分页字段与新值不同时才更新
+      if (paramsRecord[pageKey] !== newCurrent) {
+        paramsRecord[pageKey] = newCurrent
+      }
+
+      await getData()
+    } finally {
+      isCurrentChanging = false
+    }
+  }
+
+  // 针对不同业务场景的刷新方法
+
+  // 新增后刷新：回到第一页并清空分页缓存（适用于新增数据后）
+  const refreshCreate = async (): Promise<void> => {
+    debouncedGetDataByPage.cancel()
+    pagination.current = 1
+    ;(searchParams as Record<string, unknown>)[pageKey] = 1
+    clearCache(CacheInvalidationStrategy.CLEAR_PAGINATION, '新增数据')
+    await getData()
+  }
+
+  // 更新后刷新：保持当前页，仅清空当前搜索缓存（适用于更新数据后）
+  const refreshUpdate = async (): Promise<void> => {
+    clearCache(CacheInvalidationStrategy.CLEAR_CURRENT, '编辑数据')
+    await getData()
+  }
+
+  // 删除后刷新：智能处理页码，避免空页面（适用于删除数据后）
+  const refreshRemove = async (): Promise<void> => {
+    const { current } = pagination
+
+    // 清除缓存并获取最新数据
+    clearCache(CacheInvalidationStrategy.CLEAR_CURRENT, '删除数据')
+    await getData()
+
+    // 如果当前页为空且不是第一页，回到上一页
+    if (data.value.length === 0 && current > 1) {
+      pagination.current = current - 1
+      ;(searchParams as Record<string, unknown>)[pageKey] = current - 1
+      await getData()
+    }
+  }
+
+  // 全量刷新：清空所有缓存，重新获取数据（适用于手动刷新按钮）
+  const refreshData = async (): Promise<void> => {
+    debouncedGetDataByPage.cancel()
+    clearCache(CacheInvalidationStrategy.CLEAR_ALL, '手动刷新')
+    await getData()
+  }
+
+  // 轻量刷新：仅清空当前搜索条件的缓存，保持分页状态（适用于定时刷新）
+  const refreshSoft = async (): Promise<void> => {
+    clearCache(CacheInvalidationStrategy.CLEAR_CURRENT, '软刷新')
+    await getData()
+  }
+
+  // 取消当前请求
+  const cancelRequest = (): void => {
+    if (abortController) {
+      abortController.abort()
+    }
+    debouncedGetDataByPage.cancel()
+  }
+
+  // 清空数据
+  const clearData = (): void => {
+    data.value = []
+    error.value = null
+    clearCache(CacheInvalidationStrategy.CLEAR_ALL, '清空数据')
+  }
+
+  // 清理已过期的缓存条目，释放内存空间
+  const clearExpiredCache = (): number => {
+    if (!cache) return 0
+    const cleanedCount = cache.cleanupExpired()
+    if (cleanedCount > 0) {
+      // 手动触发缓存状态更新
+      cacheUpdateTrigger.value++
+    }
+    return cleanedCount
+  }
+
+  // 设置定期清理过期缓存
+  if (enableCache && cache) {
+    cacheCleanupTimer = setInterval(() => {
+      const cleanedCount = cache.cleanupExpired()
+      if (cleanedCount > 0) {
+        logger.log(`自动清理 ${cleanedCount} 条过期缓存`)
+        // 手动触发缓存状态更新
+        cacheUpdateTrigger.value++
+      }
+    }, cacheTime / 2) // 每半个缓存周期清理一次
+  }
+
+  // 挂载时自动加载数据
+  if (immediate) {
+    onMounted(async () => {
+      await getData()
+    })
+  }
+
+  // 组件卸载时彻底清理
+  onUnmounted(() => {
+    cancelRequest()
+    if (cache) {
+      cache.clear()
+    }
+    if (cacheCleanupTimer) {
+      clearInterval(cacheCleanupTimer)
+    }
+  })
+
+  // 优化的返回值结构
+  return {
+    // 数据相关
+    /** 表格数据 */
+    data,
+    /** 数据加载状态 */
+    loading: readonly(loading),
+    /** 错误状态 */
+    error: readonly(error),
+    /** 数据是否为空 */
+    isEmpty: computed(() => data.value.length === 0),
+    /** 是否有数据 */
+    hasData,
+
+    // 分页相关
+    /** 分页状态信息 */
+    pagination: readonly(pagination),
+    /** 移动端分页配置 */
+    paginationMobile: mobilePagination,
+    /** 页面大小变化处理 */
+    handleSizeChange,
+    /** 当前页变化处理 */
+    handleCurrentChange,
+
+    // 搜索相关 - 统一前缀
+    /** 搜索参数 */
+    searchParams,
+    /** 替换搜索参数（适用于表单查询，避免旧字段残留） */
+    replaceSearchParams,
+    /** 重置搜索参数 */
+    resetSearchParams,
+
+    // 数据操作 - 更明确的操作意图
+    /** 加载数据 */
+    fetchData: getData,
+    /** 获取数据 */
+    getData: getDataByPage,
+    /** 获取数据（防抖） */
+    getDataDebounced: debouncedGetDataByPage,
+    /** 清空数据 */
+    clearData,
+
+    // 刷新策略
+    /** 全量刷新：清空所有缓存，重新获取数据（适用于手动刷新按钮） */
+    refreshData,
+    /** 轻量刷新：仅清空当前搜索条件的缓存，保持分页状态（适用于定时刷新） */
+    refreshSoft,
+    /** 新增后刷新：回到第一页并清空分页缓存（适用于新增数据后） */
+    refreshCreate,
+    /** 更新后刷新：保持当前页，仅清空当前搜索缓存（适用于更新数据后） */
+    refreshUpdate,
+    /** 删除后刷新：智能处理页码，避免空页面（适用于删除数据后） */
+    refreshRemove,
+
+    // 缓存控制
+    /** 缓存统计信息 */
+    cacheInfo,
+    /** 清除缓存，根据不同的业务场景选择性地清理缓存： */
+    clearCache,
+    // 支持4种清理策略
+    // clearCache(CacheInvalidationStrategy.CLEAR_ALL, '手动刷新')     // 清空所有缓存
+    // clearCache(CacheInvalidationStrategy.CLEAR_CURRENT, '搜索数据') // 只清空当前搜索条件的缓存
+    // clearCache(CacheInvalidationStrategy.CLEAR_PAGINATION, '新增数据') // 清空分页相关缓存
+    // clearCache(CacheInvalidationStrategy.KEEP_ALL, '保持缓存')      // 不清理任何缓存
+    /** 清理已过期的缓存条目，释放内存空间 */
+    clearExpiredCache,
+
+    // 请求控制
+    /** 取消当前请求 */
+    cancelRequest,
+
+    // 列配置 (如果提供了 columnsFactory)
+    ...(columnConfig && {
+      /** 表格列配置 */
+      columns,
+      /** 列显示控制 */
+      columnChecks,
+      /** 新增列 */
+      addColumn: columnConfig.addColumn,
+      /** 删除列 */
+      removeColumn: columnConfig.removeColumn,
+      /** 切换列显示状态 */
+      toggleColumn: columnConfig.toggleColumn,
+      /** 更新列配置 */
+      updateColumn: columnConfig.updateColumn,
+      /** 批量更新列配置 */
+      batchUpdateColumns: columnConfig.batchUpdateColumns,
+      /** 重新排序列 */
+      reorderColumns: columnConfig.reorderColumns,
+      /** 获取指定列配置 */
+      getColumnConfig: columnConfig.getColumnConfig,
+      /** 获取所有列配置 */
+      getAllColumns: columnConfig.getAllColumns,
+      /** 重置所有列配置到默认状态 */
+      resetColumns: columnConfig.resetColumns
+    })
+  }
+}
+
+// 重新导出类型和枚举，方便使用
+export { CacheInvalidationStrategy } from '../../utils/table/tableCache'
+export type { ApiResponse, CacheItem } from '../../utils/table/tableCache'
+export type { BaseRequestParams, TableError } from '../../utils/table/tableUtils'
diff --git a/web/src/hooks/core/useTableColumns.ts b/web/src/hooks/core/useTableColumns.ts
new file mode 100644
index 0000000..84b6e13
--- /dev/null
+++ b/web/src/hooks/core/useTableColumns.ts
@@ -0,0 +1,312 @@
+/**
+ * useTableColumns - 表格列配置管理
+ *
+ * 提供动态的表格列配置管理能力，支持运行时灵活控制列的显示、隐藏、排序等操作。
+ * 通常与 useTable 配合使用，为表格提供完整的列管理功能。
+ *
+ * ## 主要功能
+ *
+ * 1. 列显示控制 - 动态显示/隐藏列，支持批量操作
+ * 2. 列排序 - 拖拽或编程方式重新排列列顺序
+ * 3. 列配置管理 - 新增、删除、更新列配置
+ * 4. 特殊列支持 - 自动处理 selection、expand、index 等特殊列
+ * 5. 状态持久化 - 保持列的显示状态，支持重置到初始状态
+ *
+ * ## 使用示例
+ *
+ * ```typescript
+ * const { columns, columnChecks, toggleColumn, reorderColumns } = useTableColumns(() => [
+ *   { prop: 'name', label: '姓名', visible: true },
+ *   { prop: 'email', label: '邮箱', visible: true },
+ *   { prop: 'status', label: '状态', visible: false }
+ * ])
+ *
+ * // 切换列显示
+ * toggleColumn('email', false)
+ *
+ * // 重新排序
+ * reorderColumns(0, 2)
+ * ```
+ *
+ * @module useTableColumns
+ * @author Art Design Pro Team
+ */
+
+import { ref, computed, watch } from 'vue'
+import { $t } from '@/locales'
+import type { ColumnOption } from '@/types/component'
+
+/**
+ * 特殊列类型
+ */
+const SPECIAL_COLUMNS: Record<string, { prop: string; label: string }> = {
+  selection: { prop: '__selection__', label: $t('table.column.selection') },
+  expand: { prop: '__expand__', label: $t('table.column.expand') },
+  index: { prop: '__index__', label: $t('table.column.index') }
+}
+
+/**
+ * 获取列的唯一标识
+ */
+export const getColumnKey = <T>(col: ColumnOption<T>) =>
+  SPECIAL_COLUMNS[col.type as keyof typeof SPECIAL_COLUMNS]?.prop ?? (col.prop as string)
+
+/**
+ * 获取列的显示状态
+ * 优先使用 visible 字段，如果不存在则使用 checked 字段
+ */
+export const getColumnVisibility = <T>(col: ColumnOption<T>): boolean => {
+  // visible 优先级高于 checked
+  if (col.visible !== undefined) {
+    return col.visible
+  }
+  // 如果 visible 未定义，使用 checked，默认为 true
+  return col.checked ?? true
+}
+
+/**
+ * 获取列的检查状态
+ */
+export const getColumnChecks = <T>(columns: ColumnOption<T>[]) =>
+  columns.map((col) => {
+    const special = col.type && SPECIAL_COLUMNS[col.type]
+    const visibility = getColumnVisibility(col)
+
+    if (special) {
+      return { ...col, prop: special.prop, label: special.label, checked: true, visible: true }
+    }
+    return { ...col, checked: visibility, visible: visibility }
+  })
+
+/**
+ * 动态列配置接口
+ */
+export interface DynamicColumnConfig<T = any> {
+  /**
+   * 新增列（支持单个或批量）
+   * @param column 列配置或列配置数组
+   * @param index 可选的插入位置，默认末尾（批量时为第一个列的位置）
+   */
+  addColumn: (column: ColumnOption<T> | ColumnOption<T>[], index?: number) => void
+  /**
+   * 删除列（支持单个或批量）
+   * @param prop 列的唯一标识或标识数组
+   */
+  removeColumn: (prop: string | string[]) => void
+  /**
+   * 切换列显示状态（支持单个或批量）
+   * @param prop 列的唯一标识或标识数组
+   * @param visible 可选的显示状态，默认取反
+   */
+  toggleColumn: (prop: string | string[], visible?: boolean) => void
+
+  /**
+   * 更新列（支持单个或批量）
+   * @param prop 列的唯一标识或更新配置数组
+   * @param updates 列配置更新（当 prop 为字符串时使用）
+   */
+  updateColumn: (
+    prop: string | Array<{ prop: string; updates: Partial<ColumnOption<T>> }>,
+    updates?: Partial<ColumnOption<T>>
+  ) => void
+  /**
+   * 批量更新列（兼容旧版本，推荐使用 updateColumn 的数组模式）
+   * @param updates 列更新配置
+   * @deprecated 推荐使用 updateColumn 的数组模式
+   */
+  batchUpdateColumns: (updates: Array<{ prop: string; updates: Partial<ColumnOption<T>> }>) => void
+  /**
+   * 重新排序列
+   * @param fromIndex 源索引
+   * @param toIndex 目标索引
+   */
+  reorderColumns: (fromIndex: number, toIndex: number) => void
+  /**
+   * 获取列配置
+   * @param prop 列的唯一标识
+   * @returns 列配置
+   */
+  getColumnConfig: (prop: string) => ColumnOption<T> | undefined
+  /**
+   * 获取所有列配置
+   * @returns 所有列配置
+   */
+  getAllColumns: () => ColumnOption<T>[]
+  /**
+   * 重置所有列
+   */
+  resetColumns: () => void
+}
+
+export function useTableColumns<T = any>(
+  columnsFactory: () => ColumnOption<T>[]
+): {
+  columns: any
+  columnChecks: any
+} & DynamicColumnConfig<T> {
+  const dynamicColumns = ref<ColumnOption<T>[]>(columnsFactory())
+  const columnChecks = ref<ColumnOption<T>[]>(getColumnChecks(dynamicColumns.value))
+
+  // 当 dynamicColumns 变动时，重新生成 columnChecks 且保留已存在的显示状态
+  watch(
+    dynamicColumns,
+    (newCols) => {
+      const visibilityMap = new Map(
+        columnChecks.value.map((c) => [getColumnKey(c), getColumnVisibility(c)])
+      )
+      const newChecks = getColumnChecks(newCols).map((c) => {
+        const key = getColumnKey(c)
+        const visibility = visibilityMap.has(key) ? visibilityMap.get(key) : getColumnVisibility(c)
+        return {
+          ...c,
+          checked: visibility,
+          visible: visibility
+        }
+      })
+      columnChecks.value = newChecks
+    },
+    { deep: true }
+  )
+
+  // 当前显示列（基于 columnChecks 的 checked 或 visible）
+  const columns = computed(() => {
+    const colMap = new Map(dynamicColumns.value.map((c) => [getColumnKey(c), c]))
+    return columnChecks.value
+      .filter((c) => getColumnVisibility(c))
+      .map((c) => colMap.get(getColumnKey(c)))
+      .filter(Boolean) as ColumnOption<T>[]
+  })
+
+  // 支持 updater 返回新数组或直接在传入数组上 mutate
+  const setDynamicColumns = (updater: (cols: ColumnOption<T>[]) => void | ColumnOption<T>[]) => {
+    const copy = [...dynamicColumns.value]
+    const result = updater(copy)
+    dynamicColumns.value = Array.isArray(result) ? result : copy
+  }
+
+  return {
+    columns,
+    columnChecks,
+
+    /**
+     * 新增列（支持单个或批量）
+     */
+    addColumn: (column: ColumnOption<T> | ColumnOption<T>[], index?: number) =>
+      setDynamicColumns((cols) => {
+        const next = [...cols]
+        const columnsToAdd = Array.isArray(column) ? column : [column]
+        const insertIndex =
+          typeof index === 'number' && index >= 0 && index <= next.length ? index : next.length
+
+        // 批量插入
+        next.splice(insertIndex, 0, ...columnsToAdd)
+        return next
+      }),
+
+    /**
+     * 删除列（支持单个或批量）
+     */
+    removeColumn: (prop: string | string[]) =>
+      setDynamicColumns((cols) => {
+        const propsToRemove = Array.isArray(prop) ? prop : [prop]
+        return cols.filter((c) => !propsToRemove.includes(getColumnKey(c)))
+      }),
+
+    /**
+     * 更新列（支持单个或批量）
+     */
+    updateColumn: (
+      prop: string | Array<{ prop: string; updates: Partial<ColumnOption<T>> }>,
+      updates?: Partial<ColumnOption<T>>
+    ) => {
+      // 批量模式：prop 是数组
+      if (Array.isArray(prop)) {
+        setDynamicColumns((cols) => {
+          const map = new Map(prop.map((u) => [u.prop, u.updates]))
+          return cols.map((c) => {
+            const key = getColumnKey(c)
+            const upd = map.get(key)
+            return upd ? { ...c, ...upd } : c
+          })
+        })
+      }
+      // 单个模式：prop 是字符串
+      else if (updates) {
+        setDynamicColumns((cols) =>
+          cols.map((c) => (getColumnKey(c) === prop ? { ...c, ...updates } : c))
+        )
+      }
+    },
+
+    /**
+     * 切换列显示状态（支持单个或批量）
+     */
+    toggleColumn: (prop: string | string[], visible?: boolean) => {
+      const propsToToggle = Array.isArray(prop) ? prop : [prop]
+      const next = [...columnChecks.value]
+
+      propsToToggle.forEach((p) => {
+        const i = next.findIndex((c) => getColumnKey(c) === p)
+        if (i > -1) {
+          const currentVisibility = getColumnVisibility(next[i])
+          const newVisibility = visible ?? !currentVisibility
+          // 同时更新 checked 和 visible 以保持兼容性
+          next[i] = { ...next[i], checked: newVisibility, visible: newVisibility }
+        }
+      })
+
+      columnChecks.value = next
+    },
+
+    /**
+     * 重置所有列
+     */
+    resetColumns: () => {
+      dynamicColumns.value = columnsFactory()
+    },
+
+    /**
+     * 批量更新列（兼容旧版本）
+     * @deprecated 推荐使用 updateColumn 的数组模式
+     */
+    batchUpdateColumns: (updates) =>
+      setDynamicColumns((cols) => {
+        const map = new Map(updates.map((u) => [u.prop, u.updates]))
+        return cols.map((c) => {
+          const key = getColumnKey(c)
+          const upd = map.get(key)
+          return upd ? { ...c, ...upd } : c
+        })
+      }),
+
+    /**
+     * 重新排序列
+     */
+    reorderColumns: (fromIndex: number, toIndex: number) =>
+      setDynamicColumns((cols) => {
+        if (
+          fromIndex < 0 ||
+          fromIndex >= cols.length ||
+          toIndex < 0 ||
+          toIndex >= cols.length ||
+          fromIndex === toIndex
+        ) {
+          return cols
+        }
+        const next = [...cols]
+        const [moved] = next.splice(fromIndex, 1)
+        next.splice(toIndex, 0, moved)
+        return next
+      }),
+
+    /**
+     * 获取列配置
+     */
+    getColumnConfig: (prop: string) => dynamicColumns.value.find((c) => getColumnKey(c) === prop),
+
+    /**
+     * 获取所有列配置
+     */
+    getAllColumns: () => [...dynamicColumns.value]
+  }
+}
diff --git a/web/src/hooks/core/useTableHeight.ts b/web/src/hooks/core/useTableHeight.ts
new file mode 100644
index 0000000..8fdf6da
--- /dev/null
+++ b/web/src/hooks/core/useTableHeight.ts
@@ -0,0 +1,105 @@
+/**
+ * useTableHeight - 表格高度自动计算
+ *
+ * 自动计算表格容器的最佳高度，确保表格在不同布局场景下都能正确显示。
+ * 根据表格头部、分页器等元素的高度动态调整容器高度，避免出现滚动条或布局错乱。
+ *
+ * ## 主要功能
+ *
+ * 1. 动态高度计算 - 根据表格头部、分页器高度自动计算容器高度
+ * 2. 响应式更新 - 配置变化时自动重新计算高度
+ * 3. 灵活配置 - 支持自定义各部分高度和间距
+ * 4. 智能适配 - 无额外元素时自动使用 100% 高度
+ *
+ * @module useTableHeight
+ * @author Art Design Pro Team
+ */
+
+import { computed, type Ref } from 'vue'
+
+/**
+ * 表格高度计算器配置接口
+ */
+interface TableHeightOptions {
+  /** 是否显示表格头部 */
+  showTableHeader: Ref<boolean>
+  /** 分页器高度 */
+  paginationHeight: Ref<number>
+  /** 表格头部高度 */
+  tableHeaderHeight: Ref<number>
+  /** 分页器间距 */
+  paginationSpacing: Ref<number>
+}
+
+/**
+ * 表格高度计算器类
+ */
+class TableHeightCalculator {
+  // 常量配置
+  private static readonly DEFAULT_TABLE_HEADER_HEIGHT = 44
+  private static readonly TABLE_HEADER_SPACING = 12
+
+  constructor(private options: TableHeightOptions) {}
+
+  /**
+   * 计算容器高度
+   */
+  calculate(): { height: string } {
+    const offset = this.calculateOffset()
+    return {
+      height: offset === 0 ? '100%' : `calc(100% - ${offset}px)`
+    }
+  }
+
+  /**
+   * 计算偏移量
+   */
+  private calculateOffset(): number {
+    if (!this.options.showTableHeader.value) {
+      return this.calculatePaginationOffset()
+    }
+
+    const headerHeight = this.getHeaderHeight()
+    const paginationOffset = this.calculatePaginationOffset()
+
+    return headerHeight + paginationOffset + TableHeightCalculator.TABLE_HEADER_SPACING
+  }
+
+  /**
+   * 获取表格头部高度
+   */
+  private getHeaderHeight(): number {
+    return this.options.tableHeaderHeight.value || TableHeightCalculator.DEFAULT_TABLE_HEADER_HEIGHT
+  }
+
+  /**
+   * 计算分页器偏移量
+   */
+  private calculatePaginationOffset(): number {
+    const { paginationHeight, paginationSpacing } = this.options
+    return paginationHeight.value === 0 ? 0 : paginationHeight.value + paginationSpacing.value
+  }
+}
+
+/**
+ * 表格高度计算 Hook
+ *
+ * 提供表格容器高度的自动计算功能，支持：
+ * - 表格头部高度
+ * - 分页器高度
+ * - 动态间距计算
+ *
+ * @param options 配置选项
+ * @returns 容器高度计算结果
+ */
+export function useTableHeight(options: TableHeightOptions) {
+  const containerHeight = computed(() => {
+    const calculator = new TableHeightCalculator(options)
+    return calculator.calculate()
+  })
+
+  return {
+    /** 容器高度样式对象 */
+    containerHeight
+  }
+}
diff --git a/web/src/hooks/core/useTheme.ts b/web/src/hooks/core/useTheme.ts
new file mode 100644
index 0000000..187c3e0
--- /dev/null
+++ b/web/src/hooks/core/useTheme.ts
@@ -0,0 +1,174 @@
+/**
+ * useTheme - 系统主题管理
+ *
+ * 提供完整的主题切换和管理功能，支持亮色、暗色和自动模式。
+ * 自动处理主题切换时的过渡效果，确保切换流畅无闪烁。
+ *
+ * ## 主要功能
+ *
+ * 1. 主题切换 - 支持亮色、暗色、自动三种主题模式
+ * 2. 自动模式 - 根据系统偏好自动切换主题
+ * 3. 颜色适配 - 自动调整主题色的明暗变体（9 个层级）
+ * 4. 过渡优化 - 切换时临时禁用过渡效果，避免闪烁
+ * 5. 状态持久化 - 主题设置自动保存到 store
+ *
+ * ## 使用示例
+ *
+ * ```typescript
+ * const { switchThemeStyles } = useTheme()
+ *
+ * // 切换到暗色主题
+ * switchThemeStyles(SystemThemeEnum.DARK)
+ *
+ * // 切换到亮色主题
+ * switchThemeStyles(SystemThemeEnum.LIGHT)
+ *
+ * // 切换到自动模式（跟随系统）
+ * switchThemeStyles(SystemThemeEnum.AUTO)
+ * ```
+ *
+ * @module useTheme
+ * @author Art Design Pro Team
+ */
+
+import { useSettingStore } from '@/store/modules/setting'
+import { SystemThemeEnum } from '@/enums/appEnum'
+import AppConfig from '@/config'
+import { SystemThemeTypes } from '@/types/store'
+import { getDarkColor, getLightColor, setElementThemeColor } from '@/utils/ui'
+import { usePreferredDark } from '@vueuse/core'
+import { watch } from 'vue'
+
+export function useTheme() {
+  const settingStore = useSettingStore()
+
+  // 禁用过渡效果
+  const disableTransitions = () => {
+    const style = document.createElement('style')
+    style.setAttribute('id', 'disable-transitions')
+    style.textContent = '* { transition: none !important; }'
+    document.head.appendChild(style)
+  }
+
+  // 启用过渡效果
+  const enableTransitions = () => {
+    const style = document.getElementById('disable-transitions')
+    if (style) {
+      style.remove()
+    }
+  }
+
+  // 设置系统主题
+  const setSystemTheme = (theme: SystemThemeEnum, themeMode?: SystemThemeEnum) => {
+    // 临时禁用过渡效果
+    disableTransitions()
+
+    const el = document.getElementsByTagName('html')[0]
+    const isDark = theme === SystemThemeEnum.DARK
+
+    if (!themeMode) {
+      themeMode = theme
+    }
+
+    const currentTheme = AppConfig.systemThemeStyles[theme as keyof SystemThemeTypes]
+
+    if (currentTheme) {
+      el.setAttribute('class', currentTheme.className)
+    }
+
+    // 设置按钮颜色加深或变浅
+    const primary = settingStore.systemThemeColor
+
+    for (let i = 1; i <= 9; i++) {
+      document.documentElement.style.setProperty(
+        `--el-color-primary-light-${i}`,
+        isDark ? `${getDarkColor(primary, i / 10)}` : `${getLightColor(primary, i / 10)}`
+      )
+    }
+
+    // 更新store中的主题设置
+    settingStore.setGlopTheme(theme, themeMode)
+
+    // 使用 requestAnimationFrame 确保在下一帧恢复过渡效果
+    requestAnimationFrame(() => {
+      requestAnimationFrame(() => {
+        enableTransitions()
+      })
+    })
+  }
+
+  // 使用 VueUse 的 usePreferredDark 检测系统主题偏好
+  const prefersDark = usePreferredDark()
+
+  // 自动设置系统主题
+  const setSystemAutoTheme = () => {
+    const theme = prefersDark.value ? SystemThemeEnum.DARK : SystemThemeEnum.LIGHT
+    setSystemTheme(theme, SystemThemeEnum.AUTO)
+  }
+
+  // 切换主题
+  const switchThemeStyles = (theme: SystemThemeEnum) => {
+    if (theme === SystemThemeEnum.AUTO) {
+      setSystemAutoTheme()
+    } else {
+      setSystemTheme(theme)
+    }
+  }
+
+  return {
+    setSystemTheme,
+    setSystemAutoTheme,
+    switchThemeStyles,
+    prefersDark
+  }
+}
+
+/**
+ * 初始化主题系统
+ */
+export function initializeTheme() {
+  const settingStore = useSettingStore()
+  const prefersDark = usePreferredDark()
+
+  // 根据系统偏好应用主题
+  const applyThemeByMode = () => {
+    const el = document.getElementsByTagName('html')[0]
+    let actualTheme = settingStore.systemThemeType
+
+    // 如果是 AUTO 模式，检测系统偏好
+    if (settingStore.systemThemeMode === SystemThemeEnum.AUTO) {
+      actualTheme = prefersDark.value ? SystemThemeEnum.DARK : SystemThemeEnum.LIGHT
+      // 更新实际应用的主题类型
+      settingStore.systemThemeType = actualTheme
+    }
+
+    // 设置主题 class
+    const currentTheme = AppConfig.systemThemeStyles[actualTheme as keyof SystemThemeTypes]
+    if (currentTheme) {
+      el.setAttribute('class', currentTheme.className)
+    }
+
+    // 设置主题颜色
+    setElementThemeColor(settingStore.systemThemeColor)
+
+    // 设置圆角
+    document.documentElement.style.setProperty('--custom-radius', `${settingStore.customRadius}rem`)
+  }
+
+  // 应用主题
+  applyThemeByMode()
+
+  // 如果是 AUTO 模式，监听系统主题变化（使用 VueUse 的响应式特性）
+  if (settingStore.systemThemeMode === SystemThemeEnum.AUTO) {
+    watch(
+      prefersDark,
+      () => {
+        // 只有在 AUTO 模式下才响应系统主题变化
+        if (settingStore.systemThemeMode === SystemThemeEnum.AUTO) {
+          applyThemeByMode()
+        }
+      },
+      { immediate: false }
+    )
+  }
+}
diff --git a/web/src/hooks/index.ts b/web/src/hooks/index.ts
new file mode 100644
index 0000000..472b09c
--- /dev/null
+++ b/web/src/hooks/index.ts
@@ -0,0 +1,32 @@
+// 通用功能集合
+export { useCommon } from './core/useCommon'
+
+// 应用模式
+export { useAppMode } from './core/useAppMode'
+
+// 权限控制
+export { useAuth } from './core/useAuth'
+
+// 表格数据管理方案
+export { useTable } from './core/useTable'
+
+// 表格列配置管理
+export { useTableColumns } from './core/useTableColumns'
+
+// 主题相关
+export { useTheme } from './core/useTheme'
+
+// 礼花+文字滚动
+export { useCeremony } from './core/useCeremony'
+
+// 顶栏快速入口
+export { useFastEnter } from './core/useFastEnter'
+
+// 顶栏功能管理
+export { useHeaderBar } from './core/useHeaderBar'
+
+// 图表相关
+export { useChart, useChartComponent, useChartOps } from './core/useChart'
+
+// 布局高度
+export { useLayoutHeight, useAutoLayoutHeight } from './core/useLayoutHeight'
diff --git a/web/src/locales/index.ts b/web/src/locales/index.ts
new file mode 100644
index 0000000..36c2648
--- /dev/null
+++ b/web/src/locales/index.ts
@@ -0,0 +1,123 @@
+/**
+ * 国际化配置
+ *
+ * 基于 vue-i18n 实现的多语言国际化解决方案。
+ * 支持中文和英文切换，自动从本地存储恢复用户的语言偏好。
+ *
+ * ## 主要功能
+ *
+ * - 多语言支持 - 支持中文（简体）和英文两种语言
+ * - 语言切换 - 运行时动态切换语言，无需刷新页面
+ * - 持久化存储 - 自动保存和恢复用户的语言偏好
+ * - 全局注入 - 在任何组件中都可以使用 $t 函数进行翻译
+ * - 类型安全 - 提供 TypeScript 类型支持
+ *
+ * ## 支持的语言
+ *
+ * - zh: 简体中文
+ * - en: English
+ *
+ * @module locales
+ * @author Art Design Pro Team
+ */
+
+import { createI18n } from 'vue-i18n'
+import type { I18n, I18nOptions } from 'vue-i18n'
+import { LanguageEnum } from '@/enums/appEnum'
+import { getSystemStorage } from '@/utils/storage'
+import { StorageKeyManager } from '@/utils/storage/storage-key-manager'
+
+// 同步导入语言文件
+import enMessages from './langs/en.json'
+import zhMessages from './langs/zh.json'
+
+/**
+ * 存储键管理器实例
+ */
+const storageKeyManager = new StorageKeyManager()
+
+/**
+ * 语言消息对象
+ */
+const messages = {
+  [LanguageEnum.EN]: enMessages,
+  [LanguageEnum.ZH]: zhMessages
+}
+
+/**
+ * 语言选项列表
+ * 用于语言切换下拉框
+ */
+export const languageOptions = [
+  { value: LanguageEnum.ZH, label: '简体中文' },
+  { value: LanguageEnum.EN, label: 'English' }
+]
+
+/**
+ * 从存储中获取语言设置
+ * @returns 语言设置，如果获取失败则返回默认语言
+ */
+const getDefaultLanguage = (): LanguageEnum => {
+  // 尝试从版本化的存储中获取语言设置
+  try {
+    const storageKey = storageKeyManager.getStorageKey('user')
+    const userStore = localStorage.getItem(storageKey)
+
+    if (userStore) {
+      const { language } = JSON.parse(userStore)
+      if (language && Object.values(LanguageEnum).includes(language)) {
+        return language
+      }
+    }
+  } catch (error) {
+    console.warn('[i18n] 从版本化存储获取语言设置失败:', error)
+  }
+
+  // 尝试从系统存储中获取语言设置
+  try {
+    const sys = getSystemStorage()
+    if (sys) {
+      const { user } = JSON.parse(sys)
+      if (user?.language && Object.values(LanguageEnum).includes(user.language)) {
+        return user.language
+      }
+    }
+  } catch (error) {
+    console.warn('[i18n] 从系统存储获取语言设置失败:', error)
+  }
+
+  // 返回默认语言
+  console.debug('[i18n] 使用默认语言:', LanguageEnum.ZH)
+  return LanguageEnum.ZH
+}
+
+/**
+ * i18n 配置选项
+ */
+const i18nOptions: I18nOptions = {
+  locale: getDefaultLanguage(),
+  legacy: false,
+  globalInjection: true,
+  fallbackLocale: LanguageEnum.ZH,
+  messages
+}
+
+/**
+ * i18n 实例
+ */
+const i18n: I18n = createI18n(i18nOptions)
+
+/**
+ * 翻译函数类型
+ */
+interface Translation {
+  (key: string): string
+}
+
+/**
+ * 全局翻译函数
+ * 可在任何地方使用，无需导入 useI18n
+ */
+export const $t = i18n.global.t as Translation
+
+export default i18n
diff --git a/web/src/locales/langs/en.json b/web/src/locales/langs/en.json
new file mode 100644
index 0000000..d912f68
--- /dev/null
+++ b/web/src/locales/langs/en.json
@@ -0,0 +1,702 @@
+{
+  "httpMsg": {
+    "unauthorized": "Unauthorized access, please login again",
+    "forbidden": "Access to this resource is forbidden",
+    "notFound": "The requested resource does not exist",
+    "methodNotAllowed": "Request method not allowed",
+    "requestTimeout": "Request timeout, please try again later",
+    "internalServerError": "Internal server error, please try again later",
+    "badGateway": "Bad gateway error, please try again later",
+    "serviceUnavailable": "Service temporarily unavailable, please try again later",
+    "gatewayTimeout": "Gateway timeout, please try again later",
+    "requestCancelled": "Request cancelled",
+    "networkError": "Network connection error, please check your connection",
+    "requestFailed": "Request failed",
+    "requestConfigError": "Request configuration error"
+  },
+  "topBar": {
+    "search": {
+      "title": "Search"
+    },
+    "user": {
+      "userCenter": "User center",
+      "docs": "Document",
+      "github": "Github",
+      "lockScreen": "Lock screen",
+      "logout": "Log out"
+    },
+    "guide": {
+      "title": "Click here to view",
+      "theme": "Theme style",
+      "menu": "Open top menu",
+      "description": "More configurations"
+    }
+  },
+  "common": {
+    "tips": "Prompt",
+    "cancel": "Cancel",
+    "confirm": "Confirm",
+    "logOutTips": "Do you want to log out?",
+    "save": "Save",
+    "edit": "Edit",
+    "add": "Add",
+    "delete": "Delete",
+    "view": "View",
+    "print": "Print",
+    "back": "Back",
+    "search": "Search",
+    "reset": "Reset",
+    "submit": "Submit",
+    "success": "Success",
+    "failed": "Failed",
+    "enabled": "Enabled",
+    "disabled": "Disabled",
+    "noData": "No data",
+    "all": "All",
+    "actions": "Actions",
+    "status": "Status",
+    "createTime": "Created At",
+    "unknown": "Unknown",
+    "unknownError": "Unknown error",
+    "storageError": "Local data looks invalid. Please log in again to restore the system.",
+    "systemUpgradedPrefix": "The system has been upgraded to",
+    "systemUpgradedSuffix": ". This update includes the following improvements:",
+    "upgradeReLogin": "Upgrade complete. Please log in again to continue.",
+    "invalidHexColor": "Invalid hex color value",
+    "invalidRgbColor": "Invalid RGB color value",
+    "selected": "{count} selected"
+  },
+  "search": {
+    "placeholder": "Search page",
+    "historyTitle": "Search history",
+    "switchKeydown": "Navigate",
+    "selectKeydown": "Select",
+    "exitKeydown": "Close"
+  },
+  "setting": {
+    "menuType": {
+      "title": "Menu Layout",
+      "list": ["Vertical", "Horizontal", "Mixed", "Dual"]
+    },
+    "theme": {
+      "title": "Theme Style",
+      "list": ["Light", "Dark", "System"]
+    },
+    "menu": {
+      "title": "Menu Style"
+    },
+    "color": {
+      "title": "Theme Color"
+    },
+    "box": {
+      "title": "Box Style",
+      "list": ["Border", "Shadow"]
+    },
+    "container": {
+      "title": "Container Width",
+      "list": ["Full", "Boxed"]
+    },
+    "basics": {
+      "title": "Basic Config",
+      "list": {
+        "multiTab": "Show work tab",
+        "accordion": "Sidebar opens accordion",
+        "collapseSidebar": "Show sidebar button",
+        "reloadPage": "Show reload page button",
+        "fastEnter": "Show fast enter",
+        "breadcrumb": "Show crumb navigation",
+        "language": "Show multilingual selection",
+        "progressBar": "Show top progress bar",
+        "weakMode": "Color Weakness Mode",
+        "watermark": "Global watermark",
+        "menuWidth": "Menu width",
+        "tabStyle": "Tab style",
+        "pageTransition": "Page animation",
+        "borderRadius": "Custom radius"
+      }
+    },
+    "tabStyle": {
+      "default": "Default",
+      "card": "Card",
+      "google": "Chrome"
+    },
+    "transition": {
+      "list": {
+        "none": "None",
+        "fade": "Fade",
+        "slideLeft": "Slide Left",
+        "slideBottom": "Slide Bottom",
+        "slideTop": "Slide Top"
+      }
+    },
+    "actions": {
+      "resetConfig": "Reset Config",
+      "copyConfig": "Copy Config",
+      "copySuccess": "Configuration copied to clipboard, paste it into src/config/setting.ts file",
+      "copyFailed": "Copy failed, please try again",
+      "resetFailed": "Reset failed, please refresh the page and try again"
+    }
+  },
+  "notice": {
+    "title": "Notice",
+    "btnRead": "Mark as read",
+    "bar": ["Notice", "Message", "Todo"],
+    "text": ["No"],
+    "viewAll": "View all"
+  },
+  "worktab": {
+    "btn": {
+      "refresh": "Refresh",
+      "fixed": "Fixed",
+      "unfixed": "Unfixed",
+      "closeLeft": "Close left",
+      "closeRight": "Close right",
+      "closeOther": "Close other",
+      "closeAll": "Close all"
+    }
+  },
+  "login": {
+    "leftView": {
+      "title": "A backend system of beauty and efficiency",
+      "subTitle": "A sleek and practical interface for a great user experience"
+    },
+    "title": "Welcome back",
+    "subTitle": "Please enter your account and password to login",
+    "roles": {
+      "super": "Super Admin",
+      "admin": "Admin",
+      "user": "User"
+    },
+    "placeholder": {
+      "username": "Please enter your account",
+      "password": "Please enter your password",
+      "slider": "Please slide to verify"
+    },
+    "sliderText": "Please slide to verify",
+    "sliderSuccessText": "Verification successful",
+    "rememberPwd": "Remember password",
+    "forgetPwd": "Forgot password",
+    "btnText": "Login",
+    "noAccount": "No account yet?",
+    "register": "Register",
+    "success": {
+      "title": "Login successful",
+      "message": "Welcome back"
+    }
+  },
+  "forgetPassword": {
+    "title": "Forgot password?",
+    "subTitle": "Enter your email to reset your password",
+    "placeholder": "Please enter your email",
+    "submitBtnText": "Submit",
+    "backBtnText": "Back",
+    "accountLabel": "Account"
+  },
+  "register": {
+    "title": "Create account",
+    "subTitle": "Welcome to join us, please fill in the following information to complete the registration",
+    "placeholder": {
+      "username": "Please enter your account",
+      "email": "Please enter your email",
+      "password": "Please enter your password",
+      "confirmPassword": "Please enter your password again"
+    },
+    "rule": {
+      "confirmPasswordRequired": "Please enter your password again",
+      "passwordMismatch": "The two passwords are inconsistent!",
+      "usernameLength": "The length is 3 to 20 characters",
+      "passwordLength": "The password length cannot be less than 6 digits",
+      "agreementRequired": "Please agree to the privacy policy"
+    },
+    "agreeText": "I agree",
+    "privacyPolicy": "Privacy policy",
+    "submitBtnText": "Register",
+    "hasAccount": "Already have an account?",
+    "toLogin": "To login",
+    "success": {
+      "message": "Registration successful"
+    }
+  },
+  "lockScreen": {
+    "pwdError": "Password error",
+    "lock": {
+      "inputPlaceholder": "Please input lock screen password",
+      "btnText": "Lock"
+    },
+    "unlock": {
+      "inputPlaceholder": "Please input unlock password",
+      "btnText": "Unlock",
+      "backBtnText": "Back to login"
+    }
+  },
+  "greeting": {
+    "dawn": "Good morning!",
+    "morning": "Good morning!",
+    "afternoon": "Good afternoon!",
+    "evening": "Good evening!"
+  },
+  "exceptionPage": {
+    "403": "Sorry, you do not have permission to access this page",
+    "404": "Sorry, the page you are trying to access does not exist",
+    "500": "Sorry, there was an error on the server",
+    "gohome": "Go Home"
+  },
+  "menus": {
+    "login": {
+      "title": "Login"
+    },
+    "register": {
+      "title": "Register"
+    },
+    "forgetPassword": {
+      "title": "Forget Password"
+    },
+    "outside": {
+      "title": "Outside"
+    },
+    "dashboard": {
+      "title": "Dashboard",
+      "console": "Console",
+      "overview": "Overview",
+      "timeline": "Timeline",
+      "search": "Search",
+      "contacts": "Contacts",
+      "imports": "Imports"
+    },
+    "result": {
+      "title": "Result Page",
+      "success": "Success",
+      "fail": "Fail"
+    },
+    "exception": {
+      "title": "Exception",
+      "forbidden": "403",
+      "notFound": "404",
+      "serverError": "500"
+    },
+    "system": {
+      "title": "System Settings",
+      "user": "User Manage",
+      "role": "Role Manage",
+      "userCenter": "User Center",
+      "menu": "Menu Manage"
+    },
+    "setup": {
+      "title": "System Setup"
+    }
+  },
+  "table": {
+    "form": {
+      "reset": "Reset",
+      "submit": "Submit"
+    },
+    "searchBar": {
+      "reset": "Reset",
+      "search": "Search",
+      "expand": "Expand",
+      "collapse": "Collapse",
+      "searchInputPlaceholder": "Please enter",
+      "searchSelectPlaceholder": "Please select"
+    },
+    "selection": "Select",
+    "sizeOptions": {
+      "small": "Compact",
+      "default": "Default",
+      "large": "Loose"
+    },
+    "column": {
+      "selection": "Select",
+      "expand": "Expand",
+      "index": "Index"
+    },
+    "zebra": "Zebra",
+    "border": "Border",
+    "headerBackground": "Header BG"
+  },
+  "setup": {
+    "brand": "Commory",
+    "title": "Initialize Commory",
+    "subtitle": "Complete the first-run setup for your local-first communication memory.",
+    "eyebrow": "Local-first · single-port deployment",
+    "panelTitle": "Setup Wizard",
+    "panelSubtitle": "Confirm storage, administrator credentials, and usage mode step by step.",
+    "loadingStatus": "Checking setup status...",
+    "apiUnavailable": "Setup API is temporarily unavailable. You can continue filling the form and submit later.",
+    "steps": {
+      "database": "Database",
+      "admin": "Administrator",
+      "mode": "Usage Mode",
+      "finish": "Finish"
+    },
+    "database": {
+      "title": "Database Check",
+      "desc": "Confirm current storage and connection status.",
+      "type": "SQLite Database",
+      "hint": "A lightweight file database for personal use and small deployments.",
+      "ready": "Storage is ready"
+    },
+    "admin": {
+      "title": "Administrator Account",
+      "desc": "Set the initial account used to manage Commory.",
+      "existsTitle": "Administrator already exists",
+      "existsDesc": "An administrator account already exists. You can continue to the next step.",
+      "userName": "Username",
+      "userNamePlaceholder": "Enter administrator username",
+      "password": "Password",
+      "passwordPlaceholder": "At least 8 characters",
+      "confirmPassword": "Confirm Password",
+      "confirmPasswordPlaceholder": "Enter password again",
+      "existing": "Exists",
+      "notSet": "Not set"
+    },
+    "mode": {
+      "title": "Usage Mode",
+      "desc": "Choose the default experience after setup.",
+      "personal": "Personal Mode",
+      "personalDesc": "For personal use, focused on backup, search, and timeline.",
+      "family": "Family Mode",
+      "familyDesc": "For family sharing, preserving room for multi-user expansion."
+    },
+    "finish": {
+      "title": "Finish Setup",
+      "desc": "Confirm settings and write the initialization state.",
+      "database": "Database",
+      "admin": "Administrator",
+      "usageMode": "Usage Mode"
+    },
+    "actions": {
+      "prev": "Previous",
+      "next": "Next",
+      "finish": "Finish Setup",
+      "login": "Go to Login"
+    },
+    "validation": {
+      "userNameRequired": "Please enter administrator username",
+      "passwordRequired": "Please enter password",
+      "passwordLength": "Password must be at least 8 characters",
+      "confirmPasswordRequired": "Please confirm password",
+      "passwordMismatch": "Passwords do not match"
+    },
+    "message": {
+      "success": "Setup completed. Redirecting to login."
+    }
+  },
+  "dashboardPage": {
+    "console": {
+      "title": "MsgLayer Archive Overview",
+      "subtitle": "Review imports, events, identities, and recent archive activity.",
+      "openImports": "Open Imports",
+      "recentImports": "Recent Imports",
+      "recentEvents": "Recent Events",
+      "viewTimeline": "View Timeline",
+      "emptyEvents": "No recent events",
+      "itemCount": "{count} items",
+      "cards": {
+        "imports": "Imports",
+        "events": "Events",
+        "identities": "Identities",
+        "lastActivity": "Last Activity"
+      },
+      "hints": {
+        "imports": "Validated MsgLayer payloads",
+        "events": "Timeline records indexed",
+        "identities": "Contacts and devices discovered",
+        "lastActivity": "Most recent event timestamp"
+      },
+      "noImports": "No imports yet"
+    },
+    "timeline": {
+      "searchPlaceholder": "Search timeline text",
+      "typePlaceholder": "Event type",
+      "apply": "Apply",
+      "eventTypes": {
+        "all": "All",
+        "sms": "SMS",
+        "call": "Call",
+        "voice": "Voice",
+        "contact_snapshot": "Contact Snapshot"
+      }
+    },
+    "search": {
+      "placeholder": "Search SMS text, transcript, or summary",
+      "title": "Results",
+      "matches": "{count} matches"
+    },
+    "contacts": {
+      "title": "Contacts",
+      "filterPlaceholder": "Filter contacts",
+      "loadActivity": "Load Activity",
+      "phones": "Phones",
+      "emails": "Emails",
+      "source": "Source",
+      "empty": "Select a contact to inspect its MsgLayer identity and recent activity."
+    },
+    "imports": {
+      "chooseFile": "Choose MsgLayer File",
+      "noFile": "No file selected",
+      "validate": "Validate",
+      "import": "Import",
+      "history": "Import History",
+      "count": "{count} imports",
+      "validationPassed": "Validation passed.",
+      "validationFailed": "Validation failed.",
+      "imported": "Imported {id} ({version}).",
+      "export": "Export"
+    },
+    "columns": {
+      "import": "Import",
+      "version": "Version",
+      "events": "Events",
+      "identities": "Identities",
+      "importedAt": "Imported At",
+      "timestamp": "Timestamp",
+      "type": "Type",
+      "direction": "Direction",
+      "summary": "Summary",
+      "participants": "Participants",
+      "source": "Source",
+      "action": "Action"
+    }
+  },
+  "resultPage": {
+    "success": {
+      "title": "Operation Successful",
+      "message": "The task is complete and the result has been written to Commory.",
+      "content": "You can review the result or return to adjust the configuration."
+    },
+    "fail": {
+      "title": "Operation Failed",
+      "message": "Check the following information and try again.",
+      "intro": "The operation was not completed:",
+      "accountFrozen": "Current account status is unavailable",
+      "notEligible": "Current role does not have the required permission"
+    },
+    "actions": {
+      "backEdit": "Back to Edit",
+      "view": "View",
+      "print": "Print"
+    }
+  },
+  "systemPage": {
+    "user": {
+      "add": "Add User",
+      "logoutTitle": "Disable User",
+      "logoutConfirm": "Are you sure you want to disable this user?",
+      "logoutSuccess": "User disabled",
+      "columns": {
+        "index": "Index",
+        "userName": "Username",
+        "gender": "Gender",
+        "phone": "Phone",
+        "status": "Status",
+        "createTime": "Created At",
+        "operation": "Actions"
+      },
+      "status": {
+        "online": "Online",
+        "offline": "Offline",
+        "abnormal": "Abnormal",
+        "cancelled": "Disabled",
+        "unknown": "Unknown"
+      },
+      "search": {
+        "userName": "Username",
+        "userNamePlaceholder": "Enter username",
+        "phone": "Phone",
+        "phonePlaceholder": "Enter phone number",
+        "email": "Email",
+        "emailPlaceholder": "Enter email",
+        "status": "Status",
+        "statusPlaceholder": "Select status",
+        "gender": "Gender"
+      },
+      "dialog": {
+        "addTitle": "Add User",
+        "editTitle": "Edit User",
+        "phoneInvalid": "Please enter a valid phone number",
+        "addSuccess": "Added successfully",
+        "updateSuccess": "Updated successfully",
+        "role": "Role"
+      }
+    },
+    "role": {
+      "add": "Add Role",
+      "deleteTitle": "Delete Confirmation",
+      "deleteConfirm": "Delete role “{name}”? This action cannot be undone.",
+      "deleteSuccess": "Deleted successfully",
+      "deleteCancel": "Delete cancelled",
+      "columns": {
+        "id": "Role ID",
+        "name": "Role Name",
+        "code": "Role Code",
+        "description": "Description",
+        "status": "Role Status",
+        "menuPermission": "Menu Permission",
+        "editRole": "Edit Role",
+        "deleteRole": "Delete Role"
+      },
+      "search": {
+        "name": "Role Name",
+        "namePlaceholder": "Enter role name",
+        "code": "Role Code",
+        "codePlaceholder": "Enter role code",
+        "description": "Description",
+        "descriptionPlaceholder": "Enter role description",
+        "status": "Role Status",
+        "statusPlaceholder": "Select status",
+        "date": "Created At",
+        "datePlaceholder": "Select date range",
+        "startDate": "Start date",
+        "endDate": "End date",
+        "rangeSeparator": "to",
+        "today": "Today",
+        "week": "Last 7 days",
+        "month": "Last 30 days"
+      },
+      "dialog": {
+        "addTitle": "Add Role",
+        "editTitle": "Edit Role",
+        "enabled": "Enabled",
+        "addSuccess": "Added successfully",
+        "editSuccess": "Updated successfully"
+      },
+      "permission": {
+        "title": "Menu Permission",
+        "output": "Output Selection",
+        "collapse": "Collapse All",
+        "expand": "Expand All",
+        "selectAll": "Select All",
+        "unselectAll": "Unselect All",
+        "save": "Save",
+        "saveSuccess": "Permissions saved",
+        "outputSuccess": "Selection output to console. {count} nodes selected."
+      }
+    },
+    "menu": {
+      "add": "Add Menu",
+      "collapse": "Collapse",
+      "expand": "Expand",
+      "filters": {
+        "name": "Menu Name",
+        "route": "Route Path"
+      },
+      "columns": {
+        "name": "Menu Name",
+        "type": "Menu Type",
+        "route": "Route",
+        "auth": "Permission Code",
+        "editTime": "Edited At",
+        "status": "Status",
+        "operation": "Actions"
+      },
+      "type": {
+        "button": "Button",
+        "directory": "Directory",
+        "iframe": "Iframe",
+        "menu": "Menu",
+        "external": "External",
+        "unknown": "Unknown"
+      },
+      "authCount": "{count} permission codes",
+      "addAuth": "Add Permission",
+      "deleteMenuConfirm": "Delete this menu? This action cannot be undone.",
+      "deleteAuthConfirm": "Delete this permission? This action cannot be undone.",
+      "deleteSuccess": "Deleted successfully",
+      "deleteFailed": "Delete failed",
+      "dialog": {
+        "menu": "Menu",
+        "button": "Button",
+        "newMenu": "New Menu",
+        "editMenu": "Edit Menu",
+        "newButton": "New Button",
+        "editButton": "Edit Button",
+        "menuType": "Menu Type",
+        "name": "Menu Name",
+        "namePlaceholder": "Menu name",
+        "path": "Route Path",
+        "pathTip": "Top-level menus use an absolute path starting with /, such as /dashboard. Nested menus use relative paths such as console or user.",
+        "pathPlaceholder": "e.g. /dashboard or console",
+        "label": "Permission Code",
+        "labelPlaceholder": "e.g. User",
+        "component": "Component Path",
+        "componentTip": "Top-level parent menu: /index/index. Page component: /system/user. Directory menu: leave empty.",
+        "componentPlaceholder": "e.g. /system/user or empty",
+        "icon": "Icon",
+        "iconPlaceholder": "e.g. ri:user-line",
+        "roles": "Role Access",
+        "rolesTip": "Frontend mode only: configure role codes such as R_SUPER or R_ADMIN. Backend mode does not require this.",
+        "rolesPlaceholder": "Enter role code and press Enter, e.g. R_SUPER",
+        "sort": "Menu Sort",
+        "link": "External Link",
+        "linkPlaceholder": "e.g. https://www.example.com",
+        "badge": "Text Badge",
+        "badgePlaceholder": "e.g. New or Hot",
+        "activePath": "Active Path",
+        "activePathTip": "Used by hidden detail pages to highlight a parent menu, such as highlighting User Management on a user detail page.",
+        "activePathPlaceholder": "e.g. /system/user",
+        "isEnable": "Enabled",
+        "keepAlive": "Keep Alive",
+        "isHide": "Hide Menu",
+        "isIframe": "Iframe",
+        "showBadge": "Show Badge",
+        "fixedTab": "Fixed Tab",
+        "isHideTab": "Hide Tab",
+        "isFullPage": "Full Page",
+        "authName": "Permission Name",
+        "authNamePlaceholder": "e.g. Add, Edit, Delete",
+        "authLabel": "Permission Code",
+        "authLabelPlaceholder": "e.g. add, edit, delete",
+        "authSort": "Permission Sort",
+        "submitSuccess": "{action} successfully",
+        "validateFailed": "Form validation failed. Please check your input."
+      }
+    }
+  },
+  "userCenter": {
+    "profile": "User Profile",
+    "tagline": "Focused on local-first communication memory management",
+    "role": "Commory Administrator",
+    "location": "Local deployment",
+    "team": "Commory Workspace",
+    "tags": "Tags",
+    "tagList": ["Local-first", "Archive", "Privacy", "MsgLayer", "Searchable", "Exportable"],
+    "basicSettings": "Basic Settings",
+    "changePassword": "Change Password",
+    "realName": "Name",
+    "gender": "Gender",
+    "nickname": "Nickname",
+    "email": "Email",
+    "mobile": "Phone",
+    "address": "Address",
+    "bio": "Bio",
+    "currentPassword": "Current Password",
+    "newPassword": "New Password",
+    "confirmPassword": "Confirm New Password",
+    "male": "Male",
+    "female": "Female",
+    "edit": "Edit",
+    "save": "Save",
+    "validation": {
+      "realName": "Please enter name",
+      "nickname": "Please enter nickname",
+      "length": "Length must be 2 to 50 characters",
+      "email": "Please enter email",
+      "mobile": "Please enter phone number",
+      "address": "Please enter address",
+      "gender": "Please select gender"
+    },
+    "greetings": {
+      "early": "It is late. Get some rest.",
+      "morning": "Good morning",
+      "lateMorning": "Good morning",
+      "noon": "Good noon",
+      "afternoon": "Good afternoon",
+      "evening": "Good evening"
+    }
+  },
+  "permission": {
+    "frontendMode": "Frontend permission mode",
+    "rolesHint": "Route roles control page access; user buttons control button visibility.",
+    "authHint": "v-auth is only for backend menu authList. In current frontend mode, prefer hasAuth."
+  }
+}
diff --git a/web/src/locales/langs/zh.json b/web/src/locales/langs/zh.json
new file mode 100644
index 0000000..939a42d
--- /dev/null
+++ b/web/src/locales/langs/zh.json
@@ -0,0 +1,702 @@
+{
+  "httpMsg": {
+    "unauthorized": "未授权访问，请重新登录",
+    "forbidden": "禁止访问该资源",
+    "notFound": "请求的资源不存在",
+    "methodNotAllowed": "请求方法不允许",
+    "requestTimeout": "请求超时，请稍后重试",
+    "internalServerError": "服务器内部错误，请稍后重试",
+    "badGateway": "网关错误，请稍后重试",
+    "serviceUnavailable": "服务暂时不可用，请稍后重试",
+    "gatewayTimeout": "网关超时，请稍后重试",
+    "requestCancelled": "请求已取消",
+    "networkError": "网络连接异常，请检查网络连接",
+    "requestFailed": "请求失败",
+    "requestConfigError": "请求配置错误"
+  },
+  "topBar": {
+    "search": {
+      "title": "搜索"
+    },
+    "user": {
+      "userCenter": "个人中心",
+      "docs": "使用文档",
+      "github": "Github",
+      "lockScreen": "锁定屏幕",
+      "logout": "退出登录"
+    },
+    "guide": {
+      "title": "点击这里查看",
+      "theme": "主题风格",
+      "menu": "开启顶栏菜单",
+      "description": "等更多配置"
+    }
+  },
+  "common": {
+    "tips": "提示",
+    "cancel": "取消",
+    "confirm": "确定",
+    "logOutTips": "您是否要退出登录?",
+    "save": "保存",
+    "edit": "编辑",
+    "add": "新增",
+    "delete": "删除",
+    "view": "查看",
+    "print": "打印",
+    "back": "返回",
+    "search": "搜索",
+    "reset": "重置",
+    "submit": "提交",
+    "success": "成功",
+    "failed": "失败",
+    "enabled": "启用",
+    "disabled": "禁用",
+    "noData": "暂无数据",
+    "all": "全部",
+    "actions": "操作",
+    "status": "状态",
+    "createTime": "创建日期",
+    "unknown": "未知",
+    "unknownError": "未知错误",
+    "storageError": "系统检测到本地数据异常，请重新登录系统恢复使用！",
+    "systemUpgradedPrefix": "系统已升级到",
+    "systemUpgradedSuffix": "版本，此次更新带来了以下改进：",
+    "upgradeReLogin": "升级完成，请重新登录后继续使用。",
+    "invalidHexColor": "输入错误的 hex 颜色值",
+    "invalidRgbColor": "输入错误的 RGB 颜色值",
+    "selected": "已选择 {count} 项"
+  },
+  "search": {
+    "placeholder": "搜索页面",
+    "historyTitle": "搜索历史",
+    "switchKeydown": "切换",
+    "selectKeydown": "选择",
+    "exitKeydown": "关闭"
+  },
+  "setting": {
+    "menuType": {
+      "title": "菜单布局",
+      "list": ["垂直", "水平", "混合", "双列"]
+    },
+    "theme": {
+      "title": "主题风格",
+      "list": ["浅色", "深色", "系统"]
+    },
+    "menu": {
+      "title": "菜单风格"
+    },
+    "color": {
+      "title": "系统主题色"
+    },
+    "box": {
+      "title": "盒子样式",
+      "list": ["边框", "阴影"]
+    },
+    "container": {
+      "title": "容器宽度",
+      "list": ["铺满", "定宽"]
+    },
+    "basics": {
+      "title": "基础配置",
+      "list": {
+        "multiTab": "开启多标签栏",
+        "accordion": "侧边栏开启手风琴模式",
+        "collapseSidebar": "显示折叠侧边栏按钮",
+        "fastEnter": "显示快速入口",
+        "reloadPage": "显示重载页面按钮",
+        "breadcrumb": "显示全局面包屑导航",
+        "language": "显示多语言选择",
+        "progressBar": "显示顶部进度条",
+        "weakMode": "色弱模式",
+        "watermark": "全局水印",
+        "menuWidth": "菜单宽度",
+        "tabStyle": "标签页风格",
+        "pageTransition": "页面切换动画",
+        "borderRadius": "自定义圆角"
+      }
+    },
+    "tabStyle": {
+      "default": "默认",
+      "card": "卡片",
+      "google": "谷歌"
+    },
+    "transition": {
+      "list": {
+        "none": "无动画",
+        "fade": "淡入淡出",
+        "slideLeft": "左侧滑入",
+        "slideBottom": "下方滑入",
+        "slideTop": "上方滑入"
+      }
+    },
+    "actions": {
+      "resetConfig": "重置配置",
+      "copyConfig": "复制配置",
+      "copySuccess": "配置已复制到剪贴板，可粘贴到 src/config/setting.ts 文件中",
+      "copyFailed": "复制失败，请重试",
+      "resetFailed": "重置失败，请刷新页面后重试"
+    }
+  },
+  "notice": {
+    "title": "通知",
+    "btnRead": "标为已读",
+    "bar": ["通知", "消息", "代办"],
+    "text": ["暂无"],
+    "viewAll": "查看全部"
+  },
+  "worktab": {
+    "btn": {
+      "refresh": "刷新",
+      "fixed": "固定",
+      "unfixed": "取消固定",
+      "closeLeft": "关闭左侧",
+      "closeRight": "关闭右侧",
+      "closeOther": "关闭其他",
+      "closeAll": "关闭全部"
+    }
+  },
+  "login": {
+    "leftView": {
+      "title": "一款兼具设计美学与高效开发的后台系统",
+      "subTitle": "美观实用的界面，经过视觉优化，确保卓越的用户体验"
+    },
+    "title": "欢迎回来",
+    "subTitle": "输入您的账号和密码登录",
+    "roles": {
+      "super": "超级管理员",
+      "admin": "管理员",
+      "user": "普通用户"
+    },
+    "placeholder": {
+      "username": "请输入账号",
+      "password": "请输入密码",
+      "slider": "请拖动滑块完成验证"
+    },
+    "sliderText": "按住滑块拖动",
+    "sliderSuccessText": "验证成功",
+    "rememberPwd": "记住密码",
+    "forgetPwd": "忘记密码",
+    "btnText": "登录",
+    "noAccount": "还没有账号？",
+    "register": "注册",
+    "success": {
+      "title": "登录成功",
+      "message": "欢迎回来"
+    }
+  },
+  "forgetPassword": {
+    "title": "忘记密码？",
+    "subTitle": "输入您的电子邮件来重置您的密码",
+    "placeholder": "请输入您的电子邮件",
+    "submitBtnText": "提交",
+    "backBtnText": "返回",
+    "accountLabel": "账号"
+  },
+  "register": {
+    "title": "创建账号",
+    "subTitle": "欢迎加入我们，请填写以下信息完成注册",
+    "placeholder": {
+      "username": "请输入账号",
+      "email": "请输入邮箱",
+      "password": "请输入密码",
+      "confirmPassword": "请再次输入密码"
+    },
+    "rule": {
+      "confirmPasswordRequired": "请再次输入密码",
+      "passwordMismatch": "两次输入密码不一致!",
+      "usernameLength": "长度在 3 到 20 个字符",
+      "passwordLength": "密码长度不能小于6位",
+      "agreementRequired": "请同意隐私协议"
+    },
+    "agreeText": "我同意",
+    "privacyPolicy": "《隐私政策》",
+    "submitBtnText": "注册",
+    "hasAccount": "已有账号？",
+    "toLogin": "去登录",
+    "success": {
+      "message": "注册成功"
+    }
+  },
+  "lockScreen": {
+    "pwdError": "密码错误",
+    "lock": {
+      "inputPlaceholder": "请输入锁屏密码",
+      "btnText": "锁定"
+    },
+    "unlock": {
+      "inputPlaceholder": "请输入解锁密码",
+      "btnText": "解锁",
+      "backBtnText": "返回登录"
+    }
+  },
+  "greeting": {
+    "dawn": "凌晨了！",
+    "morning": "上午好！",
+    "afternoon": "下午好！",
+    "evening": "晚上好！"
+  },
+  "exceptionPage": {
+    "403": "抱歉，您无权访问该页面",
+    "404": "抱歉，您访问的页面不存在",
+    "500": "抱歉，服务器出错了",
+    "gohome": "返回首页"
+  },
+  "menus": {
+    "login": {
+      "title": "登录"
+    },
+    "register": {
+      "title": "注册"
+    },
+    "forgetPassword": {
+      "title": "忘记密码"
+    },
+    "outside": {
+      "title": "内嵌页面"
+    },
+    "dashboard": {
+      "title": "仪表盘",
+      "console": "工作台",
+      "overview": "概览",
+      "timeline": "时间线",
+      "search": "检索",
+      "contacts": "联系人",
+      "imports": "导入"
+    },
+    "result": {
+      "title": "结果页面",
+      "success": "成功页",
+      "fail": "失败页"
+    },
+    "exception": {
+      "title": "异常页面",
+      "forbidden": "403",
+      "notFound": "404",
+      "serverError": "500"
+    },
+    "system": {
+      "title": "系统管理",
+      "user": "用户管理",
+      "role": "角色管理",
+      "userCenter": "个人中心",
+      "menu": "菜单管理"
+    },
+    "setup": {
+      "title": "系统初始化"
+    }
+  },
+  "table": {
+    "form": {
+      "reset": "重置",
+      "submit": "提交"
+    },
+    "searchBar": {
+      "reset": "重置",
+      "search": "查询",
+      "expand": "展开",
+      "collapse": "收起",
+      "searchInputPlaceholder": "请输入",
+      "searchSelectPlaceholder": "请选择"
+    },
+    "selection": "选择",
+    "sizeOptions": {
+      "small": "紧凑",
+      "default": "默认",
+      "large": "宽松"
+    },
+    "column": {
+      "selection": "勾选",
+      "expand": "展开",
+      "index": "序号"
+    },
+    "zebra": "斑马纹",
+    "border": "边框",
+    "headerBackground": "表头背景"
+  },
+  "setup": {
+    "brand": "Commory",
+    "title": "Commory 系统初始化",
+    "subtitle": "完成本地优先通信记忆系统的首次配置。",
+    "eyebrow": "本地优先 · 单端口部署",
+    "panelTitle": "初始化向导",
+    "panelSubtitle": "按步骤确认环境、管理员账号与使用模式。",
+    "loadingStatus": "正在检查初始化状态...",
+    "apiUnavailable": "暂时无法连接初始化接口，可继续填写并稍后提交。",
+    "steps": {
+      "database": "数据库检查",
+      "admin": "管理员账号",
+      "mode": "使用模式",
+      "finish": "完成初始化"
+    },
+    "database": {
+      "title": "数据库检查",
+      "desc": "确认当前存储与连接状态。",
+      "type": "SQLite 数据库",
+      "hint": "轻量级文件数据库，适合个人使用和小规模部署。",
+      "ready": "存储已就绪"
+    },
+    "admin": {
+      "title": "管理员账号",
+      "desc": "设置用于管理 Commory 的初始账号。",
+      "existsTitle": "管理员账号已存在",
+      "existsDesc": "系统中已有管理员用户，可直接进入下一步。",
+      "userName": "用户名",
+      "userNamePlaceholder": "请输入管理员用户名",
+      "password": "密码",
+      "passwordPlaceholder": "至少 8 个字符",
+      "confirmPassword": "确认密码",
+      "confirmPasswordPlaceholder": "再次输入密码",
+      "existing": "已存在",
+      "notSet": "未设置"
+    },
+    "mode": {
+      "title": "使用模式",
+      "desc": "选择初始化后默认启用的体验。",
+      "personal": "个人模式",
+      "personalDesc": "适合个人使用，界面更聚焦备份、检索和时间线。",
+      "family": "家庭模式",
+      "familyDesc": "适合家庭成员共享，保留后续多用户扩展空间。"
+    },
+    "finish": {
+      "title": "完成初始化",
+      "desc": "确认配置并写入初始化状态。",
+      "database": "数据库",
+      "admin": "管理员",
+      "usageMode": "使用模式"
+    },
+    "actions": {
+      "prev": "上一步",
+      "next": "下一步",
+      "finish": "完成初始化",
+      "login": "前往登录"
+    },
+    "validation": {
+      "userNameRequired": "请输入管理员用户名",
+      "passwordRequired": "请输入密码",
+      "passwordLength": "密码至少 8 个字符",
+      "confirmPasswordRequired": "请确认密码",
+      "passwordMismatch": "两次输入的密码不一致"
+    },
+    "message": {
+      "success": "系统初始化成功，即将跳转登录页"
+    }
+  },
+  "dashboardPage": {
+    "console": {
+      "title": "MsgLayer 归档概览",
+      "subtitle": "查看导入、事件、身份和最近活动。",
+      "openImports": "打开导入",
+      "recentImports": "最近导入",
+      "recentEvents": "最近事件",
+      "viewTimeline": "查看时间线",
+      "emptyEvents": "暂无最近事件",
+      "itemCount": "{count} 项",
+      "cards": {
+        "imports": "导入",
+        "events": "事件",
+        "identities": "身份",
+        "lastActivity": "最近活动"
+      },
+      "hints": {
+        "imports": "已验证的 MsgLayer 数据包",
+        "events": "已索引的时间线记录",
+        "identities": "已发现的联系人和设备",
+        "lastActivity": "最近事件时间戳"
+      },
+      "noImports": "暂无导入"
+    },
+    "timeline": {
+      "searchPlaceholder": "搜索时间线文本",
+      "typePlaceholder": "事件类型",
+      "apply": "应用",
+      "eventTypes": {
+        "all": "全部",
+        "sms": "短信",
+        "call": "通话",
+        "voice": "语音",
+        "contact_snapshot": "联系人快照"
+      }
+    },
+    "search": {
+      "placeholder": "搜索短信、转写或摘要",
+      "title": "搜索结果",
+      "matches": "{count} 条匹配"
+    },
+    "contacts": {
+      "title": "联系人",
+      "filterPlaceholder": "筛选联系人",
+      "loadActivity": "加载活动",
+      "phones": "电话",
+      "emails": "邮箱",
+      "source": "来源",
+      "empty": "选择一个联系人，查看其 MsgLayer 身份和最近活动。"
+    },
+    "imports": {
+      "chooseFile": "选择 MsgLayer 文件",
+      "noFile": "未选择文件",
+      "validate": "校验",
+      "import": "导入",
+      "history": "导入历史",
+      "count": "{count} 次导入",
+      "validationPassed": "校验通过。",
+      "validationFailed": "校验失败。",
+      "imported": "已导入 {id}（{version}）。",
+      "export": "导出"
+    },
+    "columns": {
+      "import": "导入",
+      "version": "版本",
+      "events": "事件",
+      "identities": "身份",
+      "importedAt": "导入时间",
+      "timestamp": "时间戳",
+      "type": "类型",
+      "direction": "方向",
+      "summary": "摘要",
+      "participants": "参与者",
+      "source": "来源",
+      "action": "操作"
+    }
+  },
+  "resultPage": {
+    "success": {
+      "title": "操作成功",
+      "message": "任务已完成，相关结果已写入 Commory。",
+      "content": "你可以继续查看结果，或返回上一步调整配置。"
+    },
+    "fail": {
+      "title": "操作失败",
+      "message": "请核对以下信息后重试。",
+      "intro": "当前操作未完成：",
+      "accountFrozen": "当前账户状态不可用",
+      "notEligible": "当前角色缺少所需权限"
+    },
+    "actions": {
+      "backEdit": "返回修改",
+      "view": "查看",
+      "print": "打印"
+    }
+  },
+  "systemPage": {
+    "user": {
+      "add": "新增用户",
+      "logoutTitle": "注销用户",
+      "logoutConfirm": "确定要注销该用户吗？",
+      "logoutSuccess": "注销成功",
+      "columns": {
+        "index": "序号",
+        "userName": "用户名",
+        "gender": "性别",
+        "phone": "手机号",
+        "status": "状态",
+        "createTime": "创建日期",
+        "operation": "操作"
+      },
+      "status": {
+        "online": "在线",
+        "offline": "离线",
+        "abnormal": "异常",
+        "cancelled": "注销",
+        "unknown": "未知"
+      },
+      "search": {
+        "userName": "用户名",
+        "userNamePlaceholder": "请输入用户名",
+        "phone": "手机号",
+        "phonePlaceholder": "请输入手机号",
+        "email": "邮箱",
+        "emailPlaceholder": "请输入邮箱",
+        "status": "状态",
+        "statusPlaceholder": "请选择状态",
+        "gender": "性别"
+      },
+      "dialog": {
+        "addTitle": "添加用户",
+        "editTitle": "编辑用户",
+        "phoneInvalid": "请输入正确的手机号格式",
+        "addSuccess": "添加成功",
+        "updateSuccess": "更新成功",
+        "role": "角色"
+      }
+    },
+    "role": {
+      "add": "新增角色",
+      "deleteTitle": "删除确认",
+      "deleteConfirm": "确定删除角色“{name}”吗？此操作不可恢复！",
+      "deleteSuccess": "删除成功",
+      "deleteCancel": "已取消删除",
+      "columns": {
+        "id": "角色ID",
+        "name": "角色名称",
+        "code": "角色编码",
+        "description": "角色描述",
+        "status": "角色状态",
+        "menuPermission": "菜单权限",
+        "editRole": "编辑角色",
+        "deleteRole": "删除角色"
+      },
+      "search": {
+        "name": "角色名称",
+        "namePlaceholder": "请输入角色名称",
+        "code": "角色编码",
+        "codePlaceholder": "请输入角色编码",
+        "description": "角色描述",
+        "descriptionPlaceholder": "请输入角色描述",
+        "status": "角色状态",
+        "statusPlaceholder": "请选择状态",
+        "date": "创建日期",
+        "datePlaceholder": "请选择日期范围",
+        "startDate": "开始日期",
+        "endDate": "结束日期",
+        "rangeSeparator": "至",
+        "today": "今日",
+        "week": "最近一周",
+        "month": "最近一个月"
+      },
+      "dialog": {
+        "addTitle": "新增角色",
+        "editTitle": "编辑角色",
+        "enabled": "启用",
+        "addSuccess": "新增成功",
+        "editSuccess": "修改成功"
+      },
+      "permission": {
+        "title": "菜单权限",
+        "output": "获取选中数据",
+        "collapse": "全部收起",
+        "expand": "全部展开",
+        "selectAll": "全部选择",
+        "unselectAll": "取消全选",
+        "save": "保存",
+        "saveSuccess": "权限保存成功",
+        "outputSuccess": "已输出选中数据到控制台，共选中 {count} 个节点"
+      }
+    },
+    "menu": {
+      "add": "添加菜单",
+      "collapse": "收起",
+      "expand": "展开",
+      "filters": {
+        "name": "菜单名称",
+        "route": "路由地址"
+      },
+      "columns": {
+        "name": "菜单名称",
+        "type": "菜单类型",
+        "route": "路由",
+        "auth": "权限标识",
+        "editTime": "编辑时间",
+        "status": "状态",
+        "operation": "操作"
+      },
+      "type": {
+        "button": "按钮",
+        "directory": "目录",
+        "iframe": "内嵌",
+        "menu": "菜单",
+        "external": "外链",
+        "unknown": "未知"
+      },
+      "authCount": "{count} 个权限标识",
+      "addAuth": "新增权限",
+      "deleteMenuConfirm": "确定要删除该菜单吗？删除后无法恢复",
+      "deleteAuthConfirm": "确定要删除该权限吗？删除后无法恢复",
+      "deleteSuccess": "删除成功",
+      "deleteFailed": "删除失败",
+      "dialog": {
+        "menu": "菜单",
+        "button": "按钮",
+        "newMenu": "新建菜单",
+        "editMenu": "编辑菜单",
+        "newButton": "新建按钮",
+        "editButton": "编辑按钮",
+        "menuType": "菜单类型",
+        "name": "菜单名称",
+        "namePlaceholder": "菜单名称",
+        "path": "路由地址",
+        "pathTip": "一级菜单：以 / 开头的绝对路径（如 /dashboard）\n二级及以下：相对路径（如 console、user）",
+        "pathPlaceholder": "如：/dashboard 或 console",
+        "label": "权限标识",
+        "labelPlaceholder": "如：User",
+        "component": "组件路径",
+        "componentTip": "一级父级菜单：填写 /index/index\n具体页面：填写组件路径（如 /system/user）\n目录菜单：留空",
+        "componentPlaceholder": "如：/system/user 或留空",
+        "icon": "图标",
+        "iconPlaceholder": "如：ri:user-line",
+        "roles": "角色权限",
+        "rolesTip": "仅用于前端权限模式：配置角色标识（如 R_SUPER、R_ADMIN）\n后端权限模式：无需配置",
+        "rolesPlaceholder": "输入角色标识后按回车，如：R_SUPER",
+        "sort": "菜单排序",
+        "link": "外部链接",
+        "linkPlaceholder": "如：https://www.example.com",
+        "badge": "文本徽章",
+        "badgePlaceholder": "如：New、Hot",
+        "activePath": "激活路径",
+        "activePathTip": "用于详情页等隐藏菜单，指定高亮显示的父级菜单路径\n例如：用户详情页高亮显示“用户管理”菜单",
+        "activePathPlaceholder": "如：/system/user",
+        "isEnable": "是否启用",
+        "keepAlive": "页面缓存",
+        "isHide": "隐藏菜单",
+        "isIframe": "是否内嵌",
+        "showBadge": "显示徽章",
+        "fixedTab": "固定标签",
+        "isHideTab": "标签隐藏",
+        "isFullPage": "全屏页面",
+        "authName": "权限名称",
+        "authNamePlaceholder": "如：新增、编辑、删除",
+        "authLabel": "权限标识",
+        "authLabelPlaceholder": "如：add、edit、delete",
+        "authSort": "权限排序",
+        "submitSuccess": "{action}成功",
+        "validateFailed": "表单校验失败，请检查输入"
+      }
+    }
+  },
+  "userCenter": {
+    "profile": "用户资料",
+    "tagline": "专注于本地优先的通信记忆管理",
+    "role": "Commory 管理员",
+    "location": "本地部署",
+    "team": "Commory 工作区",
+    "tags": "标签",
+    "tagList": ["本地优先", "通信归档", "隐私保护", "MsgLayer", "可检索", "可导出"],
+    "basicSettings": "基本设置",
+    "changePassword": "更改密码",
+    "realName": "姓名",
+    "gender": "性别",
+    "nickname": "昵称",
+    "email": "邮箱",
+    "mobile": "手机",
+    "address": "地址",
+    "bio": "个人介绍",
+    "currentPassword": "当前密码",
+    "newPassword": "新密码",
+    "confirmPassword": "确认新密码",
+    "male": "男",
+    "female": "女",
+    "edit": "编辑",
+    "save": "保存",
+    "validation": {
+      "realName": "请输入姓名",
+      "nickname": "请输入昵称",
+      "length": "长度在 2 到 50 个字符",
+      "email": "请输入邮箱",
+      "mobile": "请输入手机号码",
+      "address": "请输入地址",
+      "gender": "请选择性别"
+    },
+    "greetings": {
+      "early": "很晚了，早点休息",
+      "morning": "早上好",
+      "lateMorning": "上午好",
+      "noon": "中午好",
+      "afternoon": "下午好",
+      "evening": "晚上好"
+    }
+  },
+  "permission": {
+    "frontendMode": "前端权限模式",
+    "rolesHint": "路由 roles 控制页面访问，用户 buttons 控制按钮显示。",
+    "authHint": "v-auth 仅用于后端菜单 authList；当前前端模式请优先使用 hasAuth。"
+  }
+}
diff --git a/web/src/main.ts b/web/src/main.ts
new file mode 100755
index 0000000..97e9c5b
--- /dev/null
+++ b/web/src/main.ts
@@ -0,0 +1,21 @@
+import App from './App.vue'
+import { createApp } from 'vue'
+import { initStore } from './store' // Store
+import { initRouter } from './router' // Router
+import language from './locales' // 国际化
+import '@styles/core/tailwind.css' // tailwind
+import '@styles/index.scss' // 样式
+import '@utils/sys/console.ts' // 控制台输出内容
+import { setupGlobDirectives } from './directives'
+import { setupErrorHandle } from './utils/sys/error-handle'
+
+document.addEventListener('touchstart', function () {}, { passive: false })
+
+const app = createApp(App)
+initStore(app)
+initRouter(app)
+setupGlobDirectives(app)
+setupErrorHandle(app)
+
+app.use(language)
+app.mount('#app')
diff --git a/web/src/mock/temp/formData.ts b/web/src/mock/temp/formData.ts
new file mode 100755
index 0000000..8aa7ae5
--- /dev/null
+++ b/web/src/mock/temp/formData.ts
@@ -0,0 +1,273 @@
+import avatar1 from '@/assets/images/avatar/avatar1.webp'
+import avatar2 from '@/assets/images/avatar/avatar2.webp'
+import avatar3 from '@/assets/images/avatar/avatar3.webp'
+import avatar4 from '@/assets/images/avatar/avatar4.webp'
+import avatar5 from '@/assets/images/avatar/avatar5.webp'
+import avatar6 from '@/assets/images/avatar/avatar6.webp'
+import avatar7 from '@/assets/images/avatar/avatar7.webp'
+import avatar8 from '@/assets/images/avatar/avatar8.webp'
+import avatar9 from '@/assets/images/avatar/avatar9.webp'
+import avatar10 from '@/assets/images/avatar/avatar10.webp'
+
+export interface User {
+  id: number
+  username: string
+  gender: 1 | 0
+  mobile: string
+  email: string
+  dep: string
+  status: string
+  create_time: string
+  avatar: string
+}
+
+// 用户列表
+export const ACCOUNT_TABLE_DATA: User[] = [
+  {
+    id: 1,
+    username: 'alexmorgan',
+    gender: 1,
+    mobile: '18670001591',
+    email: 'alexmorgan@company.com',
+    dep: '研发部',
+    status: '1',
+    create_time: '2020-09-09 10:01:10',
+    avatar: avatar1
+  },
+  {
+    id: 2,
+    username: 'sophiabaker',
+    gender: 1,
+    mobile: '17766664444',
+    email: 'sophiabaker@company.com',
+    dep: '电商部',
+    status: '1',
+    create_time: '2020-10-10 13:01:12',
+    avatar: avatar2
+  },
+  {
+    id: 3,
+    username: 'liampark',
+    gender: 1,
+    mobile: '18670001597',
+    email: 'liampark@company.com',
+    dep: '人事部',
+    status: '1',
+    create_time: '2020-11-14 12:01:45',
+    avatar: avatar3
+  },
+  {
+    id: 4,
+    username: 'oliviagrant',
+    gender: 0,
+    mobile: '18670001596',
+    email: 'oliviagrant@company.com',
+    dep: '产品部',
+    status: '1',
+    create_time: '2020-11-14 09:01:20',
+    avatar: avatar4
+  },
+  {
+    id: 5,
+    username: 'emmawilson',
+    gender: 0,
+    mobile: '18670001595',
+    email: 'emmawilson@company.com',
+    dep: '财务部',
+    status: '1',
+    create_time: '2020-11-13 11:01:05',
+    avatar: avatar5
+  },
+  {
+    id: 6,
+    username: 'noahevan',
+    gender: 1,
+    mobile: '18670001594',
+    email: 'noahevan@company.com',
+    dep: '运营部',
+    status: '1',
+    create_time: '2020-10-11 13:10:26',
+    avatar: avatar6
+  },
+  {
+    id: 7,
+    username: 'avamartin',
+    gender: 1,
+    mobile: '18123820191',
+    email: 'avamartin@company.com',
+    dep: '客服部',
+    status: '2',
+    create_time: '2020-05-14 12:05:10',
+    avatar: avatar7
+  },
+  {
+    id: 8,
+    username: 'jacoblee',
+    gender: 1,
+    mobile: '18670001592',
+    email: 'jacoblee@company.com',
+    dep: '总经办',
+    status: '3',
+    create_time: '2020-11-12 07:22:25',
+    avatar: avatar8
+  },
+  {
+    id: 9,
+    username: 'miaclark',
+    gender: 0,
+    mobile: '18670001581',
+    email: 'miaclark@company.com',
+    dep: '研发部',
+    status: '4',
+    create_time: '2020-06-12 05:04:20',
+    avatar: avatar9
+  },
+  {
+    id: 10,
+    username: 'ethanharris',
+    gender: 1,
+    mobile: '13755554444',
+    email: 'ethanharris@company.com',
+    dep: '研发部',
+    status: '1',
+    create_time: '2020-11-12 16:01:10',
+    avatar: avatar10
+  },
+  {
+    id: 11,
+    username: 'isabellamoore',
+    gender: 1,
+    mobile: '13766660000',
+    email: 'isabellamoore@company.com',
+    dep: '研发部',
+    status: '1',
+    create_time: '2020-11-14 12:01:20',
+    avatar: avatar6
+  },
+  {
+    id: 12,
+    username: 'masonwhite',
+    gender: 1,
+    mobile: '18670001502',
+    email: 'masonwhite@company.com',
+    dep: '研发部',
+    status: '1',
+    create_time: '2020-11-14 12:01:20',
+    avatar: avatar7
+  },
+  {
+    id: 13,
+    username: 'charlottehall',
+    gender: 1,
+    mobile: '13006644977',
+    email: 'charlottehall@company.com',
+    dep: '研发部',
+    status: '1',
+    create_time: '2020-11-14 12:01:20',
+    avatar: avatar8
+  },
+  {
+    id: 14,
+    username: 'benjaminscott',
+    gender: 0,
+    mobile: '13599998888',
+    email: 'benjaminscott@company.com',
+    dep: '研发部',
+    status: '1',
+    create_time: '2020-11-14 12:01:20',
+    avatar: avatar9
+  },
+  {
+    id: 15,
+    username: 'ameliaking',
+    gender: 1,
+    mobile: '13799998888',
+    email: 'ameliaking@company.com',
+    dep: '研发部',
+    status: '1',
+    create_time: '2020-11-14 12:01:20',
+    avatar: avatar10
+  }
+]
+
+export interface Role {
+  roleName: string
+  roleCode: string
+  des: string
+  date: string
+  enable: boolean
+}
+
+// 角色列表
+export const ROLE_LIST_DATA: Role[] = [
+  {
+    roleName: '超级管理员',
+    roleCode: 'R_SUPER',
+    des: '拥有系统全部权限',
+    date: '2025-05-15 12:30:45',
+    enable: true
+  },
+  {
+    roleName: '管理员',
+    roleCode: 'R_ADMIN',
+    des: '拥有系统管理权限',
+    date: '2025-05-15 12:30:45',
+    enable: true
+  },
+  {
+    roleName: '普通用户',
+    roleCode: 'R_USER',
+    des: '拥有系统普通权限',
+    date: '2025-05-15 12:30:45',
+    enable: true
+  },
+  {
+    roleName: '财务管理员',
+    roleCode: 'R_FINANCE',
+    des: '管理财务相关权限',
+    date: '2025-05-16 09:15:30',
+    enable: true
+  },
+  {
+    roleName: '数据分析师',
+    roleCode: 'R_ANALYST',
+    des: '拥有数据分析权限',
+    date: '2025-05-16 11:45:00',
+    enable: false
+  },
+  {
+    roleName: '客服专员',
+    roleCode: 'R_SUPPORT',
+    des: '处理客户支持请求',
+    date: '2025-05-17 14:30:22',
+    enable: true
+  },
+  {
+    roleName: '营销经理',
+    roleCode: 'R_MARKETING',
+    des: '管理营销活动权限',
+    date: '2025-05-17 15:10:50',
+    enable: true
+  },
+  {
+    roleName: '访客用户',
+    roleCode: 'R_GUEST',
+    des: '仅限浏览权限',
+    date: '2025-05-18 08:25:40',
+    enable: false
+  },
+  {
+    roleName: '系统维护员',
+    roleCode: 'R_MAINTAINER',
+    des: '负责系统维护和更新',
+    date: '2025-05-18 09:50:12',
+    enable: true
+  },
+  {
+    roleName: '项目经理',
+    roleCode: 'R_PM',
+    des: '管理项目相关权限',
+    date: '2025-05-19 13:40:35',
+    enable: true
+  }
+]
diff --git a/web/src/mock/upgrade/changeLog.ts b/web/src/mock/upgrade/changeLog.ts
new file mode 100644
index 0000000..dd6b772
--- /dev/null
+++ b/web/src/mock/upgrade/changeLog.ts
@@ -0,0 +1,12 @@
+import { ref } from 'vue'
+
+interface UpgradeLog {
+  version: string // 版本号
+  title: string // 更新标题
+  date: string // 更新日期
+  detail?: string[] // 更新内容
+  requireReLogin?: boolean // 是否需要重新登录
+  remark?: string // 备注
+}
+
+export const upgradeLogList = ref<UpgradeLog[]>([])
diff --git a/web/src/plugins/echarts.ts b/web/src/plugins/echarts.ts
new file mode 100644
index 0000000..4f56d89
--- /dev/null
+++ b/web/src/plugins/echarts.ts
@@ -0,0 +1,76 @@
+/**
+ * ECharts 插件配置
+ *
+ * 按需导入 ECharts 图表和组件，减小打包体积。
+ * 只注册项目中实际使用的图表类型和组件。
+ *
+ * @module plugins/echarts
+ * @author Art Design Pro Team
+ */
+
+// ECharts 按需导入配置
+import * as echarts from 'echarts/core'
+
+// 导入图表类型
+import {
+  BarChart,
+  LineChart,
+  PieChart,
+  ScatterChart,
+  RadarChart,
+  MapChart,
+  CandlestickChart
+} from 'echarts/charts'
+
+// 导入组件
+import {
+  TitleComponent,
+  TooltipComponent,
+  GridComponent,
+  LegendComponent,
+  DataZoomComponent,
+  MarkPointComponent,
+  MarkLineComponent,
+  ToolboxComponent,
+  BrushComponent,
+  GeoComponent,
+  VisualMapComponent
+} from 'echarts/components'
+
+// 导入渲染器
+import { CanvasRenderer } from 'echarts/renderers'
+
+// 注册必要的组件
+echarts.use([
+  // 图表类型
+  BarChart,
+  LineChart,
+  PieChart,
+  ScatterChart,
+  RadarChart,
+  MapChart,
+  CandlestickChart,
+
+  // 组件
+  TitleComponent,
+  TooltipComponent,
+  GridComponent,
+  LegendComponent,
+  DataZoomComponent,
+  MarkPointComponent,
+  MarkLineComponent,
+  ToolboxComponent,
+  BrushComponent,
+  GeoComponent,
+  VisualMapComponent,
+
+  // 渲染器
+  CanvasRenderer
+])
+
+// 导出 echarts 实例和类型
+export { echarts }
+export type { EChartsOption, BarSeriesOption } from 'echarts'
+
+// 导出常用的图形工具
+export const graphic = echarts.graphic
diff --git a/web/src/plugins/index.ts b/web/src/plugins/index.ts
new file mode 100644
index 0000000..4536a86
--- /dev/null
+++ b/web/src/plugins/index.ts
@@ -0,0 +1,6 @@
+/**
+ * 插件统一导出
+ * 集中管理第三方库的封装和配置
+ */
+
+export * from './echarts'
diff --git a/web/src/router/core/ComponentLoader.ts b/web/src/router/core/ComponentLoader.ts
new file mode 100644
index 0000000..8af3ce3
--- /dev/null
+++ b/web/src/router/core/ComponentLoader.ts
@@ -0,0 +1,82 @@
+/**
+ * 组件加载器
+ *
+ * 负责动态加载 Vue 组件
+ *
+ * @module router/core/ComponentLoader
+ * @author Art Design Pro Team
+ */
+
+import { h } from 'vue'
+
+export class ComponentLoader {
+  private modules: Record<string, () => Promise<any>>
+
+  constructor() {
+    // 动态导入 views 目录下所有 .vue 组件
+    this.modules = import.meta.glob('../../views/**/*.vue')
+  }
+
+  /**
+   * 加载组件
+   */
+  load(componentPath: string): () => Promise<any> {
+    if (!componentPath) {
+      return this.createEmptyComponent()
+    }
+
+    // 构建可能的路径
+    const fullPath = `../../views${componentPath}.vue`
+    const fullPathWithIndex = `../../views${componentPath}/index.vue`
+
+    // 先尝试直接路径，再尝试添加/index的路径
+    const module = this.modules[fullPath] || this.modules[fullPathWithIndex]
+
+    if (!module) {
+      console.error(
+        `[ComponentLoader] 未找到组件: ${componentPath}，尝试过的路径: ${fullPath} 和 ${fullPathWithIndex}`
+      )
+      return this.createErrorComponent(componentPath)
+    }
+
+    return module
+  }
+
+  /**
+   * 加载布局组件
+   */
+  loadLayout(): () => Promise<any> {
+    return () => import('@/views/index/index.vue')
+  }
+
+  /**
+   * 加载 iframe 组件
+   */
+  loadIframe(): () => Promise<any> {
+    return () => import('@/views/outside/Iframe.vue')
+  }
+
+  /**
+   * 创建空组件
+   */
+  private createEmptyComponent(): () => Promise<any> {
+    return () =>
+      Promise.resolve({
+        render() {
+          return h('div', {})
+        }
+      })
+  }
+
+  /**
+   * 创建错误提示组件
+   */
+  private createErrorComponent(componentPath: string): () => Promise<any> {
+    return () =>
+      Promise.resolve({
+        render() {
+          return h('div', { class: 'route-error' }, `组件未找到: ${componentPath}`)
+        }
+      })
+  }
+}
diff --git a/web/src/router/core/IframeRouteManager.ts b/web/src/router/core/IframeRouteManager.ts
new file mode 100644
index 0000000..c054ca1
--- /dev/null
+++ b/web/src/router/core/IframeRouteManager.ts
@@ -0,0 +1,78 @@
+/**
+ * Iframe 路由管理器
+ *
+ * 负责管理 iframe 类型的路由
+ *
+ * @module router/core/IframeRouteManager
+ * @author Art Design Pro Team
+ */
+
+import type { AppRouteRecord } from '@/types/router'
+
+export class IframeRouteManager {
+  private static instance: IframeRouteManager
+  private iframeRoutes: AppRouteRecord[] = []
+
+  private constructor() {}
+
+  static getInstance(): IframeRouteManager {
+    if (!IframeRouteManager.instance) {
+      IframeRouteManager.instance = new IframeRouteManager()
+    }
+    return IframeRouteManager.instance
+  }
+
+  /**
+   * 添加 iframe 路由
+   */
+  add(route: AppRouteRecord): void {
+    if (!this.iframeRoutes.find((r) => r.path === route.path)) {
+      this.iframeRoutes.push(route)
+    }
+  }
+
+  /**
+   * 获取所有 iframe 路由
+   */
+  getAll(): AppRouteRecord[] {
+    return this.iframeRoutes
+  }
+
+  /**
+   * 根据路径查找 iframe 路由
+   */
+  findByPath(path: string): AppRouteRecord | undefined {
+    return this.iframeRoutes.find((route) => route.path === path)
+  }
+
+  /**
+   * 清空所有 iframe 路由
+   */
+  clear(): void {
+    this.iframeRoutes = []
+  }
+
+  /**
+   * 保存到 sessionStorage
+   */
+  save(): void {
+    if (this.iframeRoutes.length > 0) {
+      sessionStorage.setItem('iframeRoutes', JSON.stringify(this.iframeRoutes))
+    }
+  }
+
+  /**
+   * 从 sessionStorage 加载
+   */
+  load(): void {
+    try {
+      const data = sessionStorage.getItem('iframeRoutes')
+      if (data) {
+        this.iframeRoutes = JSON.parse(data)
+      }
+    } catch (error) {
+      console.error('[IframeRouteManager] 加载 iframe 路由失败:', error)
+      this.iframeRoutes = []
+    }
+  }
+}
diff --git a/web/src/router/core/MenuProcessor.ts b/web/src/router/core/MenuProcessor.ts
new file mode 100644
index 0000000..3f822d5
--- /dev/null
+++ b/web/src/router/core/MenuProcessor.ts
@@ -0,0 +1,280 @@
+/**
+ * 菜单处理器
+ *
+ * 负责菜单数据的获取、过滤和处理
+ *
+ * @module router/core/MenuProcessor
+ * @author Art Design Pro Team
+ */
+
+import type { AppRouteRecord } from '@/types/router'
+import { useUserStore } from '@/store/modules/user'
+import { useAppMode } from '@/hooks/core/useAppMode'
+import { fetchGetMenuList } from '@/api/system-manage'
+import { asyncRoutes } from '../routes/asyncRoutes'
+import { RoutesAlias } from '../routesAlias'
+import { formatMenuTitle } from '@/utils'
+
+export class MenuProcessor {
+  /**
+   * 获取菜单数据
+   */
+  async getMenuList(): Promise<AppRouteRecord[]> {
+    const { isFrontendMode } = useAppMode()
+
+    let menuList: AppRouteRecord[]
+    if (isFrontendMode.value) {
+      menuList = await this.processFrontendMenu()
+    } else {
+      menuList = await this.processBackendMenu()
+    }
+
+    // 在规范化路径之前，验证原始路径配置
+    this.validateMenuPaths(menuList)
+
+    // 规范化路径（将相对路径转换为完整路径）
+    return this.normalizeMenuPaths(menuList)
+  }
+
+  /**
+   * 处理前端控制模式的菜单
+   */
+  private async processFrontendMenu(): Promise<AppRouteRecord[]> {
+    const userStore = useUserStore()
+    const roles = userStore.info?.roles
+
+    let menuList = [...asyncRoutes]
+
+    // 根据角色过滤菜单
+    if (roles && roles.length > 0) {
+      menuList = this.filterMenuByRoles(menuList, roles)
+    }
+
+    return this.filterEmptyMenus(menuList)
+  }
+
+  /**
+   * 处理后端控制模式的菜单
+   */
+  private async processBackendMenu(): Promise<AppRouteRecord[]> {
+    const list = await fetchGetMenuList()
+    return this.filterEmptyMenus(list)
+  }
+
+  /**
+   * 根据角色过滤菜单
+   */
+  private filterMenuByRoles(menu: AppRouteRecord[], roles: string[]): AppRouteRecord[] {
+    return menu.reduce((acc: AppRouteRecord[], item) => {
+      const itemRoles = item.meta?.roles
+      const hasPermission = !itemRoles || itemRoles.some((role) => roles?.includes(role))
+
+      if (hasPermission) {
+        const filteredItem = { ...item }
+        if (filteredItem.children?.length) {
+          filteredItem.children = this.filterMenuByRoles(filteredItem.children, roles)
+        }
+        acc.push(filteredItem)
+      }
+
+      return acc
+    }, [])
+  }
+
+  /**
+   * 递归过滤空菜单项
+   */
+  private filterEmptyMenus(menuList: AppRouteRecord[]): AppRouteRecord[] {
+    return menuList
+      .map((item) => {
+        // 如果有子菜单，先递归过滤子菜单
+        if (item.children && item.children.length > 0) {
+          const filteredChildren = this.filterEmptyMenus(item.children)
+          return {
+            ...item,
+            children: filteredChildren
+          }
+        }
+        return item
+      })
+      .filter((item) => {
+        // 如果定义了 children 属性（即使是空数组），说明这是一个目录菜单，应该保留
+        if ('children' in item) {
+          return true
+        }
+
+        // 如果有外链或 iframe，保留
+        if (item.meta?.isIframe === true || item.meta?.link) {
+          return true
+        }
+
+        // 如果有有效的 component，保留
+        if (item.component && item.component !== '' && item.component !== RoutesAlias.Layout) {
+          return true
+        }
+
+        // 其他情况过滤掉
+        return false
+      })
+  }
+
+  /**
+   * 验证菜单列表是否有效
+   */
+  validateMenuList(menuList: AppRouteRecord[]): boolean {
+    return Array.isArray(menuList) && menuList.length > 0
+  }
+
+  /**
+   * 规范化菜单路径
+   * 将相对路径转换为完整路径，确保菜单跳转正确
+   */
+  private normalizeMenuPaths(menuList: AppRouteRecord[], parentPath = ''): AppRouteRecord[] {
+    return menuList.map((item) => {
+      // 构建完整路径
+      const fullPath = this.buildFullPath(item.path || '', parentPath)
+
+      // 递归处理子菜单
+      const children = item.children?.length
+        ? this.normalizeMenuPaths(item.children, fullPath)
+        : item.children
+
+      const redirect = item.redirect || this.resolveDefaultRedirect(children)
+
+      return {
+        ...item,
+        path: fullPath,
+        redirect,
+        children
+      }
+    })
+  }
+
+  /**
+   * 为目录型菜单推导默认跳转地址
+   */
+  private resolveDefaultRedirect(children?: AppRouteRecord[]): string | undefined {
+    if (!children?.length) {
+      return undefined
+    }
+
+    for (const child of children) {
+      if (this.isNavigableRoute(child)) {
+        return child.path
+      }
+
+      const nestedRedirect = this.resolveDefaultRedirect(child.children)
+      if (nestedRedirect) {
+        return nestedRedirect
+      }
+    }
+
+    return undefined
+  }
+
+  /**
+   * 判断子路由是否可以作为默认落点
+   */
+  private isNavigableRoute(route: AppRouteRecord): boolean {
+    return Boolean(
+      route.path &&
+        route.path !== '/' &&
+        !route.meta?.link &&
+        route.meta?.isIframe !== true &&
+        route.component &&
+        route.component !== ''
+    )
+  }
+
+  /**
+   * 验证菜单路径配置
+   * 检测非一级菜单是否错误使用了 / 开头的路径
+   */
+  /**
+   * 验证菜单路径配置
+   * 检测非一级菜单是否错误使用了 / 开头的路径
+   */
+  private validateMenuPaths(menuList: AppRouteRecord[], level = 1): void {
+    menuList.forEach((route) => {
+      if (!route.children?.length) return
+
+      const parentName = String(route.name || route.path || '未知路由')
+
+      route.children.forEach((child) => {
+        const childPath = child.path || ''
+
+        // 跳过合法的绝对路径：外部链接和 iframe 路由
+        if (this.isValidAbsolutePath(childPath)) return
+
+        // 检测非法的绝对路径
+        if (childPath.startsWith('/')) {
+          this.logPathError(child, childPath, parentName, level)
+        }
+      })
+
+      // 递归检查更深层级的子路由
+      this.validateMenuPaths(route.children, level + 1)
+    })
+  }
+
+  /**
+   * 判断是否为合法的绝对路径
+   */
+  private isValidAbsolutePath(path: string): boolean {
+    return (
+      path.startsWith('http://') ||
+      path.startsWith('https://') ||
+      path.startsWith('/outside/iframe/')
+    )
+  }
+
+  /**
+   * 输出路径配置错误日志
+   */
+  private logPathError(
+    route: AppRouteRecord,
+    path: string,
+    parentName: string,
+    level: number
+  ): void {
+    const routeName = String(route.name || path || '未知路由')
+    const menuTitle = route.meta?.title || routeName
+    const suggestedPath = path.split('/').pop() || path.slice(1)
+
+    console.error(
+      `[路由配置错误] 菜单 "${formatMenuTitle(menuTitle)}" (name: ${routeName}, path: ${path}) 配置错误\n` +
+        `  位置: ${parentName} > ${routeName}\n` +
+        `  问题: ${level + 1}级菜单的 path 不能以 / 开头\n` +
+        `  当前配置: path: '${path}'\n` +
+        `  应该改为: path: '${suggestedPath}'`
+    )
+  }
+
+  /**
+   * 构建完整路径
+   */
+  private buildFullPath(path: string, parentPath: string): string {
+    if (!path) return ''
+
+    // 外部链接直接返回
+    if (path.startsWith('http://') || path.startsWith('https://')) {
+      return path
+    }
+
+    // 如果已经是绝对路径，直接返回
+    if (path.startsWith('/')) {
+      return path
+    }
+
+    // 拼接父路径和当前路径
+    if (parentPath) {
+      // 移除父路径末尾的斜杠，移除子路径开头的斜杠，然后拼接
+      const cleanParent = parentPath.replace(/\/$/, '')
+      const cleanChild = path.replace(/^\//, '')
+      return `${cleanParent}/${cleanChild}`
+    }
+
+    // 没有父路径，添加前导斜杠
+    return `/${path}`
+  }
+}
diff --git a/web/src/router/core/RoutePermissionValidator.ts b/web/src/router/core/RoutePermissionValidator.ts
new file mode 100644
index 0000000..1e607e0
--- /dev/null
+++ b/web/src/router/core/RoutePermissionValidator.ts
@@ -0,0 +1,161 @@
+/**
+ * 路由权限验证模块
+ *
+ * 提供路由权限验证和路径检查功能
+ *
+ * ## 主要功能
+ *
+ * - 验证路径是否在用户菜单权限中
+ * - 构建菜单路径集合（扁平化处理）
+ * - 支持动态路由参数匹配
+ * - 路径前缀匹配
+ *
+ * ## 使用场景
+ *
+ * - 路由守卫中验证用户权限
+ * - 动态路由注册后的权限检查
+ * - 防止用户访问无权限的页面
+ *
+ * @module router/core/RoutePermissionValidator
+ * @author Art Design Pro Team
+ */
+
+import type { AppRouteRecord } from '@/types/router'
+
+/**
+ * 路由权限验证器
+ */
+export class RoutePermissionValidator {
+  /**
+   * 验证路径是否在用户菜单权限中
+   * @param targetPath 目标路径
+   * @param menuList 菜单列表
+   * @returns 是否有权限访问
+   */
+  static hasPermission(targetPath: string, menuList: AppRouteRecord[]): boolean {
+    // 根路径始终允许访问
+    if (targetPath === '/') {
+      return true
+    }
+
+    return this.matchRoute(targetPath, menuList)
+  }
+
+  /**
+   * 构建菜单路径集合（扁平化处理）
+   * @param menuList 菜单列表
+   * @param pathSet 路径集合
+   * @returns 路径集合
+   */
+  static buildMenuPathSet(
+    menuList: AppRouteRecord[],
+    pathSet: Set<string> = new Set()
+  ): Set<string> {
+    if (!Array.isArray(menuList) || menuList.length === 0) {
+      return pathSet
+    }
+
+    for (const menuItem of menuList) {
+      if (!menuItem.path) {
+        continue
+      }
+
+      // 标准化路径并添加到集合
+      const menuPath = menuItem.path.startsWith('/') ? menuItem.path : `/${menuItem.path}`
+      pathSet.add(menuPath)
+
+      // 递归处理子菜单
+      if (menuItem.children?.length) {
+        this.buildMenuPathSet(menuItem.children, pathSet)
+      }
+    }
+
+    return pathSet
+  }
+
+  /**
+   * 检查目标路径是否匹配集合中的某个路径前缀
+   * 用于支持动态路由参数匹配，如 /user/123 匹配 /user
+   * @param targetPath 目标路径
+   * @param pathSet 路径集合
+   * @returns 是否匹配
+   */
+  static checkPathPrefix(targetPath: string, pathSet: Set<string>): boolean {
+    // 遍历路径集合，检查是否有前缀匹配
+    for (const menuPath of pathSet) {
+      if (targetPath.startsWith(`${menuPath}/`)) {
+        return true
+      }
+    }
+    return false
+  }
+
+  /**
+   * 递归匹配路由配置，支持隐藏路由和动态参数路由
+   */
+  static matchRoute(targetPath: string, routes: AppRouteRecord[]): boolean {
+    if (!Array.isArray(routes) || routes.length === 0) {
+      return false
+    }
+
+    for (const route of routes) {
+      if (!route.path) {
+        continue
+      }
+
+      const routePath = route.path.startsWith('/') ? route.path : `/${route.path}`
+
+      if (
+        routePath === targetPath ||
+        this.isDynamicRouteMatch(targetPath, routePath) ||
+        targetPath.startsWith(`${routePath}/`)
+      ) {
+        return true
+      }
+
+      if (route.children?.length && this.matchRoute(targetPath, route.children)) {
+        return true
+      }
+    }
+
+    return false
+  }
+
+  /**
+   * 检查目标路径是否匹配动态参数路由，如 /demo/123 匹配 /demo/:id
+   */
+  static isDynamicRouteMatch(targetPath: string, routePath: string): boolean {
+    if (!routePath.includes(':')) {
+      return false
+    }
+
+    const pattern = routePath
+      .replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+      .replace(/:([^/]+)/g, '[^/]+')
+      .replace(/\\\*/g, '.*')
+
+    return new RegExp(`^${pattern}$`).test(targetPath)
+  }
+
+  /**
+   * 验证并返回有效的路径
+   * 如果目标路径无权限，返回首页路径
+   * @param targetPath 目标路径
+   * @param menuList 菜单列表
+   * @param homePath 首页路径
+   * @returns 验证后的路径
+   */
+  static validatePath(
+    targetPath: string,
+    menuList: AppRouteRecord[],
+    homePath: string = '/'
+  ): { path: string; hasPermission: boolean } {
+    const hasPermission = this.hasPermission(targetPath, menuList)
+
+    if (hasPermission) {
+      return { path: targetPath, hasPermission: true }
+    }
+
+    return { path: homePath, hasPermission: false }
+  }
+}
diff --git a/web/src/router/core/RouteRegistry.ts b/web/src/router/core/RouteRegistry.ts
new file mode 100644
index 0000000..e1acb9e
--- /dev/null
+++ b/web/src/router/core/RouteRegistry.ts
@@ -0,0 +1,90 @@
+/**
+ * 路由注册核心类
+ *
+ * 负责动态路由的注册、验证和管理
+ *
+ * @module router/core/RouteRegistry
+ * @author Art Design Pro Team
+ */
+
+import type { Router, RouteRecordRaw } from 'vue-router'
+import type { AppRouteRecord } from '@/types/router'
+import { ComponentLoader } from './ComponentLoader'
+import { RouteValidator } from './RouteValidator'
+import { RouteTransformer } from './RouteTransformer'
+
+export class RouteRegistry {
+  private router: Router
+  private componentLoader: ComponentLoader
+  private validator: RouteValidator
+  private transformer: RouteTransformer
+  private removeRouteFns: (() => void)[] = []
+  private registered = false
+
+  constructor(router: Router) {
+    this.router = router
+    this.componentLoader = new ComponentLoader()
+    this.validator = new RouteValidator()
+    this.transformer = new RouteTransformer(this.componentLoader)
+  }
+
+  /**
+   * 注册动态路由
+   */
+  register(menuList: AppRouteRecord[]): void {
+    if (this.registered) {
+      console.warn('[RouteRegistry] 路由已注册，跳过重复注册')
+      return
+    }
+
+    // 验证路由配置
+    const validationResult = this.validator.validate(menuList)
+    if (!validationResult.valid) {
+      throw new Error(`路由配置验证失败: ${validationResult.errors.join(', ')}`)
+    }
+
+    // 转换并注册路由
+    const removeRouteFns: (() => void)[] = []
+
+    menuList.forEach((route) => {
+      if (route.name && !this.router.hasRoute(route.name)) {
+        const routeConfig = this.transformer.transform(route)
+        const removeRouteFn = this.router.addRoute(routeConfig as RouteRecordRaw)
+        removeRouteFns.push(removeRouteFn)
+      }
+    })
+
+    this.removeRouteFns = removeRouteFns
+    this.registered = true
+  }
+
+  /**
+   * 移除所有动态路由
+   */
+  unregister(): void {
+    this.removeRouteFns.forEach((fn) => fn())
+    this.removeRouteFns = []
+    this.registered = false
+  }
+
+  /**
+   * 检查是否已注册
+   */
+  isRegistered(): boolean {
+    return this.registered
+  }
+
+  /**
+   * 获取移除函数列表（用于 store 管理）
+   */
+  getRemoveRouteFns(): (() => void)[] {
+    return this.removeRouteFns
+  }
+
+  /**
+   * 标记为已注册（用于错误处理场景，避免重复请求）
+   */
+  markAsRegistered(): void {
+    this.registered = true
+  }
+}
diff --git a/web/src/router/core/RouteTransformer.ts b/web/src/router/core/RouteTransformer.ts
new file mode 100644
index 0000000..0f6900c
--- /dev/null
+++ b/web/src/router/core/RouteTransformer.ts
@@ -0,0 +1,132 @@
+/**
+ * 路由转换器
+ *
+ * 负责将菜单数据转换为 Vue Router 路由配置
+ *
+ * @module router/core/RouteTransformer
+ * @author Art Design Pro Team
+ */
+
+import type { RouteRecordRaw } from 'vue-router'
+import type { AppRouteRecord } from '@/types/router'
+import { ComponentLoader } from './ComponentLoader'
+import { IframeRouteManager } from './IframeRouteManager'
+
+interface ConvertedRoute extends Omit<RouteRecordRaw, 'children'> {
+  id?: number
+  children?: ConvertedRoute[]
+  component?: RouteRecordRaw['component'] | (() => Promise<any>)
+}
+
+export class RouteTransformer {
+  private componentLoader: ComponentLoader
+  private iframeManager: IframeRouteManager
+
+  constructor(componentLoader: ComponentLoader) {
+    this.componentLoader = componentLoader
+    this.iframeManager = IframeRouteManager.getInstance()
+  }
+
+  /**
+   * 转换路由配置
+   */
+  transform(route: AppRouteRecord, depth = 0): ConvertedRoute {
+    const { component, children, ...routeConfig } = route
+
+    // 基础路由配置
+    const converted: ConvertedRoute = {
+      ...routeConfig,
+      component: undefined
+    }
+
+    // 处理不同类型的路由
+    if (route.meta.isIframe) {
+      this.handleIframeRoute(converted, route, depth)
+    } else if (this.isFirstLevelRoute(route, depth)) {
+      this.handleFirstLevelRoute(converted, route, component as string)
+    } else {
+      this.handleNormalRoute(converted, component as string)
+    }
+
+    // 递归处理子路由
+    if (children?.length) {
+      converted.children = children.map((child) => this.transform(child, depth + 1))
+    }
+
+    return converted
+  }
+
+  /**
+   * 判断是否为一级路由（需要 Layout 包裹）
+   */
+  private isFirstLevelRoute(route: AppRouteRecord, depth: number): boolean {
+    return depth === 0 && (!route.children || route.children.length === 0)
+  }
+
+  /**
+   * 处理 iframe 类型路由
+   */
+  private handleIframeRoute(
+    targetRoute: ConvertedRoute,
+    sourceRoute: AppRouteRecord,
+    depth: number
+  ): void {
+    if (depth === 0) {
+      // 顶级 iframe：用 Layout 包裹
+      targetRoute.component = this.componentLoader.loadLayout()
+      targetRoute.path = this.extractFirstSegment(sourceRoute.path || '')
+      targetRoute.name = ''
+
+      targetRoute.children = [
+        {
+          ...sourceRoute,
+          component: this.componentLoader.loadIframe()
+        } as ConvertedRoute
+      ]
+    } else {
+      // 非顶级（嵌套）iframe：直接使用 Iframe.vue
+      targetRoute.component = this.componentLoader.loadIframe()
+    }
+
+    // 记录 iframe 路由
+    this.iframeManager.add(sourceRoute)
+  }
+
+  /**
+   * 处理一级菜单路由
+   */
+  private handleFirstLevelRoute(
+    converted: ConvertedRoute,
+    route: AppRouteRecord,
+    component: string | undefined
+  ): void {
+    converted.component = this.componentLoader.loadLayout()
+    converted.path = this.extractFirstSegment(route.path || '')
+    converted.name = ''
+    route.meta.isFirstLevel = true
+
+    converted.children = [
+      {
+        ...route,
+        component: component ? this.componentLoader.load(component) : undefined
+      } as ConvertedRoute
+    ]
+  }
+
+  /**
+   * 处理普通路由
+   */
+  private handleNormalRoute(converted: ConvertedRoute, component: string | undefined): void {
+    if (component) {
+      converted.component = this.componentLoader.load(component)
+    }
+  }
+
+  /**
+   * 提取路径的第一段
+   */
+  private extractFirstSegment(path: string): string {
+    const segments = path.split('/').filter(Boolean)
+    return segments.length > 0 ? `/${segments[0]}` : '/'
+  }
+}
diff --git a/web/src/router/core/RouteValidator.ts b/web/src/router/core/RouteValidator.ts
new file mode 100644
index 0000000..f8e58fc
--- /dev/null
+++ b/web/src/router/core/RouteValidator.ts
@@ -0,0 +1,187 @@
+/**
+ * 路由验证器
+ *
+ * 负责验证路由配置的合法性
+ *
+ * @module router/core/RouteValidator
+ * @author Art Design Pro Team
+ */
+
+import type { AppRouteRecord } from '@/types/router'
+import { RoutesAlias } from '../routesAlias'
+
+export interface ValidationResult {
+  valid: boolean
+  errors: string[]
+  warnings: string[]
+}
+
+export class RouteValidator {
+  // 用于记录已经提示过的路由，避免重复提示
+  private warnedRoutes = new Set<string>()
+
+  /**
+   * 验证路由配置
+   */
+  validate(routes: AppRouteRecord[]): ValidationResult {
+    const errors: string[] = []
+    const warnings: string[] = []
+
+    // 检测重复路由
+    this.checkDuplicates(routes, errors, warnings)
+
+    // 检测组件配置
+    this.checkComponents(routes, errors, warnings)
+
+    // 检测嵌套菜单的 /index/index 配置
+    this.checkNestedIndexComponent(routes)
+
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings
+    }
+  }
+
+  /**
+   * 检测重复路由
+   */
+  private checkDuplicates(
+    routes: AppRouteRecord[],
+    errors: string[],
+    warnings: string[],
+    parentPath = ''
+  ): void {
+    const routeNameMap = new Map<string, string>()
+    const componentPathMap = new Map<string, string>()
+
+    const checkRoutes = (routes: AppRouteRecord[], parentPath = '') => {
+      routes.forEach((route) => {
+        const currentPath = route.path || ''
+        const fullPath = this.resolvePath(parentPath, currentPath)
+
+        // 名称重复检测
+        if (route.name) {
+          const routeName = String(route.name)
+          if (routeNameMap.has(routeName)) {
+            warnings.push(`路由名称重复: "${routeName}" (${fullPath})`)
+          } else {
+            routeNameMap.set(routeName, fullPath)
+          }
+        }
+
+        // 组件路径重复检测
+        if (route.component && typeof route.component === 'string') {
+          const componentPath = route.component
+          if (componentPath !== RoutesAlias.Layout) {
+            const componentKey = `${parentPath}:${componentPath}`
+            if (componentPathMap.has(componentKey)) {
+              warnings.push(`组件路径重复: "${componentPath}" (${fullPath})`)
+            } else {
+              componentPathMap.set(componentKey, fullPath)
+            }
+          }
+        }
+
+        // 递归处理子路由
+        if (route.children?.length) {
+          checkRoutes(route.children, fullPath)
+        }
+      })
+    }
+
+    checkRoutes(routes, parentPath)
+  }
+
+  /**
+   * 检测组件配置
+   */
+  private checkComponents(
+    routes: AppRouteRecord[],
+    errors: string[],
+    warnings: string[],
+    parentPath = ''
+  ): void {
+    routes.forEach((route) => {
+      const hasExternalLink = !!route.meta?.link?.trim()
+      const hasChildren = Array.isArray(route.children) && route.children.length > 0
+      const routePath = route.path || '[未定义路径]'
+      const isIframe = route.meta?.isIframe
+
+      // 如果配置了 component，则无需校验
+      if (route.component) {
+        // 递归检查子路由
+        if (route.children?.length) {
+          const fullPath = this.resolvePath(parentPath, route.path || '')
+          this.checkComponents(route.children, errors, warnings, fullPath)
+        }
+        return
+      }
+
+      // 一级菜单：必须指定 Layout，除非是外链或 iframe
+      if (parentPath === '' && !hasExternalLink && !isIframe) {
+        errors.push(`一级菜单(${routePath}) 缺少 component，必须指向 ${RoutesAlias.Layout}`)
+        return
+      }
+
+      // 非一级菜单：如果既不是外链、iframe，也没有子路由，则必须配置 component
+      if (!hasExternalLink && !isIframe && !hasChildren) {
+        errors.push(`路由(${routePath}) 缺少 component 配置`)
+      }
+
+      // 递归检查子路由
+      if (route.children?.length) {
+        const fullPath = this.resolvePath(parentPath, route.path || '')
+        this.checkComponents(route.children, errors, warnings, fullPath)
+      }
+    })
+  }
+
+  /**
+   * 检测嵌套菜单的 Layout 组件配置
+   * 只有一级菜单才能使用 Layout，二级及以下菜单不能使用
+   */
+  private checkNestedIndexComponent(routes: AppRouteRecord[], level = 1): void {
+    routes.forEach((route) => {
+      // 检查二级及以下菜单是否错误使用了 Layout
+      if (level > 1 && route.component === RoutesAlias.Layout) {
+        this.logLayoutError(route, level)
+      }
+
+      // 递归检查子路由
+      if (route.children?.length) {
+        this.checkNestedIndexComponent(route.children, level + 1)
+      }
+    })
+  }
+
+  /**
+   * 输出 Layout 组件配置错误日志
+   */
+  private logLayoutError(route: AppRouteRecord, level: number): void {
+    const routeName = String(route.name || route.path || '未知路由')
+    const routeKey = `${routeName}_${route.path}`
+
+    // 避免重复提示
+    if (this.warnedRoutes.has(routeKey)) return
+    this.warnedRoutes.add(routeKey)
+
+    const menuTitle = route.meta?.title || routeName
+    const routePath = route.path || '/'
+
+    console.error(
+      `[路由配置错误] 菜单 "${menuTitle}" (name: ${routeName}, path: ${routePath}) 配置错误\n` +
+        `  问题: ${level}级菜单不能使用 ${RoutesAlias.Layout} 作为 component\n` +
+        `  说明: 只有一级菜单才能使用 ${RoutesAlias.Layout}，二级及以下菜单应该指向具体的组件路径\n` +
+        `  当前配置: component: '${RoutesAlias.Layout}'\n` +
+        `  应该改为: component: '/your/component/path' 或留空 ''（如果是目录菜单）`
+    )
+  }
+
+  /**
+   * 路径解析
+   */
+  private resolvePath(parent: string, child: string): string {
+    return [parent.replace(/\/$/, ''), child.replace(/^\//, '')].filter(Boolean).join('/')
+  }
+}
diff --git a/web/src/router/core/index.ts b/web/src/router/core/index.ts
new file mode 100644
index 0000000..fcfecfc
--- /dev/null
+++ b/web/src/router/core/index.ts
@@ -0,0 +1,14 @@
+/**
+ * 路由核心模块导出
+ *
+ * @module router/core
+ * @author Art Design Pro Team
+ */
+
+export { RouteRegistry } from './RouteRegistry'
+export { ComponentLoader } from './ComponentLoader'
+export { RouteValidator } from './RouteValidator'
+export { RouteTransformer } from './RouteTransformer'
+export { IframeRouteManager } from './IframeRouteManager'
+export { MenuProcessor } from './MenuProcessor'
+export { RoutePermissionValidator } from './RoutePermissionValidator'
diff --git a/web/src/router/guards/afterEach.ts b/web/src/router/guards/afterEach.ts
new file mode 100644
index 0000000..d60572d
--- /dev/null
+++ b/web/src/router/guards/afterEach.ts
@@ -0,0 +1,34 @@
+import { nextTick } from 'vue'
+import { useSettingStore } from '@/store/modules/setting'
+import { Router } from 'vue-router'
+import NProgress from 'nprogress'
+import { useCommon } from '@/hooks/core/useCommon'
+import { loadingService } from '@/utils/ui'
+import { getPendingLoading, resetPendingLoading } from './beforeEach'
+
+/** 路由全局后置守卫 */
+export function setupAfterEachGuard(router: Router) {
+  const { scrollToTop } = useCommon()
+
+  router.afterEach(() => {
+    scrollToTop()
+
+    // 关闭进度条
+    const settingStore = useSettingStore()
+    if (settingStore.showNprogress) {
+      NProgress.done()
+      // 确保进度条完全移除，避免残影
+      setTimeout(() => {
+        NProgress.remove()
+      }, 600)
+    }
+
+    // 关闭 loading 效果
+    if (getPendingLoading()) {
+      nextTick(() => {
+        loadingService.hideLoading()
+        resetPendingLoading()
+      })
+    }
+  })
+}
diff --git a/web/src/router/guards/beforeEach.ts b/web/src/router/guards/beforeEach.ts
new file mode 100644
index 0000000..99e7d66
--- /dev/null
+++ b/web/src/router/guards/beforeEach.ts
@@ -0,0 +1,446 @@
+/**
+ * 路由全局前置守卫模块
+ *
+ * 提供完整的路由导航守卫功能
+ *
+ * ## 主要功能
+ *
+ * - 登录状态验证和重定向
+ * - 动态路由注册和权限控制
+ * - 菜单数据获取和处理（前端/后端模式）
+ * - 用户信息获取和缓存
+ * - 页面标题设置
+ * - 工作标签页管理
+ * - 进度条和加载动画控制
+ * - 静态路由识别和处理
+ * - 错误处理和异常跳转
+ *
+ * ## 使用场景
+ *
+ * - 路由跳转前的权限验证
+ * - 动态菜单加载和路由注册
+ * - 用户登录状态管理
+ * - 页面访问控制
+ * - 路由级别的加载状态管理
+ *
+ * ## 工作流程
+ *
+ * 1. 检查登录状态，未登录跳转到登录页
+ * 2. 首次访问时获取用户信息和菜单数据
+ * 3. 根据权限动态注册路由
+ * 4. 设置页面标题和工作标签页
+ * 5. 处理根路径重定向到首页
+ * 6. 未匹配路由跳转到 404 页面
+ *
+ * @module router/guards/beforeEach
+ * @author Art Design Pro Team
+ */
+import type { Router, RouteLocationNormalized, NavigationGuardNext } from 'vue-router'
+import { nextTick } from 'vue'
+import NProgress from 'nprogress'
+import { useSettingStore } from '@/store/modules/setting'
+import { useUserStore } from '@/store/modules/user'
+import { useMenuStore } from '@/store/modules/menu'
+import { setWorktab } from '@/utils/navigation'
+import { setPageTitle } from '@/utils/router'
+import { RoutesAlias } from '../routesAlias'
+import { staticRoutes } from '../routes/staticRoutes'
+import { loadingService } from '@/utils/ui'
+import { useCommon } from '@/hooks/core/useCommon'
+import { useWorktabStore } from '@/store/modules/worktab'
+import { fetchGetUserInfo } from '@/api/auth'
+import { fetchSetupStatus } from '@/api/setup'
+import { ApiStatus } from '@/utils/http/status'
+import { isHttpError } from '@/utils/http/error'
+import { RouteRegistry, MenuProcessor, IframeRouteManager, RoutePermissionValidator } from '../core'
+
+// 路由注册器实例
+let routeRegistry: RouteRegistry | null = null
+
+// 菜单处理器实例
+const menuProcessor = new MenuProcessor()
+
+// 跟踪是否需要关闭 loading
+let pendingLoading = false
+
+// 路由初始化失败标记，防止死循环
+// 一旦设置为 true，只有刷新页面或重新登录才能重置
+let routeInitFailed = false
+
+// 路由初始化进行中标记，防止并发请求
+let routeInitInProgress = false
+
+let setupStatusChecked = false
+
+/**
+ * 获取 pendingLoading 状态
+ */
+export function getPendingLoading(): boolean {
+  return pendingLoading
+}
+
+/**
+ * 重置 pendingLoading 状态
+ */
+export function resetPendingLoading(): void {
+  pendingLoading = false
+}
+
+/**
+ * 获取路由初始化失败状态
+ */
+export function getRouteInitFailed(): boolean {
+  return routeInitFailed
+}
+
+/**
+ * 重置路由初始化状态（用于重新登录场景）
+ */
+export function resetRouteInitState(): void {
+  routeInitFailed = false
+  routeInitInProgress = false
+}
+
+/**
+ * 设置路由全局前置守卫
+ */
+export function setupBeforeEachGuard(router: Router): void {
+  // 初始化路由注册器
+  routeRegistry = new RouteRegistry(router)
+
+  router.beforeEach(
+    async (
+      to: RouteLocationNormalized,
+      from: RouteLocationNormalized,
+      next: NavigationGuardNext
+    ) => {
+      try {
+        await handleRouteGuard(to, from, next, router)
+      } catch (error) {
+        console.error('[RouteGuard] 路由守卫处理失败:', error)
+        closeLoading()
+        next({ name: 'Exception500' })
+      }
+    }
+  )
+}
+
+/**
+ * 关闭 loading 效果
+ */
+function closeLoading(): void {
+  if (pendingLoading) {
+    nextTick(() => {
+      loadingService.hideLoading()
+      pendingLoading = false
+    })
+  }
+}
+
+/**
+ * 处理路由守卫逻辑
+ */
+async function handleRouteGuard(
+  to: RouteLocationNormalized,
+  from: RouteLocationNormalized,
+  next: NavigationGuardNext,
+  router: Router
+): Promise<void> {
+  const settingStore = useSettingStore()
+  const userStore = useUserStore()
+
+  // 启动进度条
+  if (settingStore.showNprogress) {
+    NProgress.start()
+  }
+
+  if (!setupStatusChecked && to.path !== '/setup') {
+    try {
+      const status = await fetchSetupStatus()
+      if (status && !status.status) {
+        next({ path: '/setup', replace: true })
+        return
+      }
+      setupStatusChecked = true
+    } catch {
+      setupStatusChecked = true
+    }
+  }
+
+  if (to.path === '/setup') {
+    try {
+      const status = await fetchSetupStatus()
+      if (status && status.status) {
+        next({ path: '/', replace: true })
+        return
+      }
+    } catch {
+      // Allow setup to proceed on API error
+    }
+  }
+
+  // 1. 检查登录状态
+  if (!handleLoginStatus(to, userStore, next)) {
+    return
+  }
+
+  // 2. 检查路由初始化是否已失败（防止死循环）
+  if (routeInitFailed) {
+    // 已经失败过，直接放行到错误页面，不再重试
+    if (to.matched.length > 0) {
+      next()
+    } else {
+      // 未匹配到路由，跳转到 500 页面
+      next({ name: 'Exception500', replace: true })
+    }
+    return
+  }
+
+  // 3. 处理动态路由注册
+  if (!routeRegistry?.isRegistered() && userStore.isLogin) {
+    // 防止并发请求（快速连续导航场景）
+    if (routeInitInProgress) {
+      // 正在初始化中，等待完成后重新导航
+      next(false)
+      return
+    }
+    await handleDynamicRoutes(to, next, router)
+    return
+  }
+
+  // 4. 处理根路径重定向
+  if (handleRootPathRedirect(to, next)) {
+    return
+  }
+
+  // 5. 处理已匹配的路由
+  if (to.matched.length > 0) {
+    setWorktab(to)
+    setPageTitle(to)
+    next()
+    return
+  }
+
+  // 6. 未匹配到路由，跳转到 404
+  next({ name: 'Exception404' })
+}
+
+/**
+ * 处理登录状态
+ * @returns true 表示可以继续，false 表示已处理跳转
+ */
+function handleLoginStatus(
+  to: RouteLocationNormalized,
+  userStore: ReturnType<typeof useUserStore>,
+  next: NavigationGuardNext
+): boolean {
+  // 已登录或访问登录页或静态路由，直接放行
+  if (userStore.isLogin || to.path === RoutesAlias.Login || isStaticRoute(to.path)) {
+    return true
+  }
+
+  // 未登录且访问需要权限的页面，跳转到登录页并携带 redirect 参数
+  userStore.logOut()
+  next({
+    name: 'Login',
+    query: { redirect: to.fullPath }
+  })
+  return false
+}
+
+/**
+ * 检查路由是否为静态路由
+ */
+function isStaticRoute(path: string): boolean {
+  const checkRoute = (routes: any[], targetPath: string): boolean => {
+    return routes.some((route) => {
+      // 404 catch-all 路由不应视为可匿名访问的静态页，
+      // 否则未登录时手动输入任意地址会直接落到 404，无法跳转登录页。
+      if (route.name === 'Exception404') {
+        return false
+      }
+
+      // 处理动态路由参数匹配
+      const routePath = route.path
+      const pattern = routePath.replace(/:[^/]+/g, '[^/]+').replace(/\*/g, '.*')
+      const regex = new RegExp(`^${pattern}$`)
+
+      if (regex.test(targetPath)) {
+        return true
+      }
+      if (route.children && route.children.length > 0) {
+        return checkRoute(route.children, targetPath)
+      }
+      return false
+    })
+  }
+
+  return checkRoute(staticRoutes, path)
+}
+
+/**
+ * 处理动态路由注册
+ */
+async function handleDynamicRoutes(
+  to: RouteLocationNormalized,
+  next: NavigationGuardNext,
+  router: Router
+): Promise<void> {
+  // 标记初始化进行中
+  routeInitInProgress = true
+
+  // 显示 loading
+  pendingLoading = true
+  loadingService.showLoading()
+
+  try {
+    // 1. 获取用户信息
+    await fetchUserInfo()
+
+    // 2. 获取菜单数据
+    const menuList = await menuProcessor.getMenuList()
+
+    // 3. 验证菜单数据
+    if (!menuProcessor.validateMenuList(menuList)) {
+      throw new Error('获取菜单列表失败，请重新登录')
+    }
+
+    // 4. 注册动态路由
+    routeRegistry?.register(menuList)
+
+    // 5. 保存菜单数据到 store
+    const menuStore = useMenuStore()
+    menuStore.setMenuList(menuList)
+    menuStore.addRemoveRouteFns(routeRegistry?.getRemoveRouteFns() || [])
+
+    // 6. 保存 iframe 路由
+    IframeRouteManager.getInstance().save()
+
+    // 7. 验证工作标签页
+    useWorktabStore().validateWorktabs(router)
+
+    // 8. 静态路由不依赖菜单权限，初始化后直接恢复目标地址。
+    if (isStaticRoute(to.path)) {
+      routeInitInProgress = false
+      next({
+        path: to.path,
+        query: to.query,
+        hash: to.hash,
+        replace: true
+      })
+      return
+    }
+
+    // 8. 验证目标路径权限
+    const { homePath } = useCommon()
+    const { path: validatedPath, hasPermission } = RoutePermissionValidator.validatePath(
+      to.path,
+      menuList,
+      homePath.value || '/'
+    )
+
+    // 初始化成功，重置进行中标记
+    routeInitInProgress = false
+
+    // 9. 重新导航到目标路由
+    if (!hasPermission) {
+      // 无权限访问，跳转到首页
+      closeLoading()
+
+      // 输出警告信息
+      console.warn(`[RouteGuard] 用户无权限访问路径: ${to.path}，已跳转到首页`)
+
+      // 直接跳转到首页
+      next({
+        path: validatedPath,
+        replace: true
+      })
+    } else {
+      // 有权限，正常导航
+      next({
+        path: to.path,
+        query: to.query,
+        hash: to.hash,
+        replace: true
+      })
+    }
+  } catch (error) {
+    console.error('[RouteGuard] 动态路由注册失败:', error)
+
+    // 关闭 loading
+    closeLoading()
+
+    // 401 错误：axios 拦截器已处理退出登录，取消当前导航
+    if (isUnauthorizedError(error)) {
+      // 重置状态，允许重新登录后再次初始化
+      routeInitInProgress = false
+      next(false)
+      return
+    }
+
+    // 标记初始化失败，防止死循环
+    routeInitFailed = true
+    routeInitInProgress = false
+
+    // 输出详细错误信息，便于排查
+    if (isHttpError(error)) {
+      console.error(`[RouteGuard] 错误码: ${error.code}, 消息: ${error.message}`)
+    }
+
+    // 跳转到 500 页面，使用 replace 避免产生历史记录
+    next({ name: 'Exception500', replace: true })
+  }
+}
+
+/**
+ * 获取用户信息
+ */
+async function fetchUserInfo(): Promise<void> {
+  const userStore = useUserStore()
+  const data = await fetchGetUserInfo()
+  userStore.setUserInfo(data)
+  // 检查并清理工作台标签页（如果是不同用户登录）
+  userStore.checkAndClearWorktabs()
+}
+
+/**
+ * 重置路由相关状态
+ */
+export function resetRouterState(delay: number): void {
+  setTimeout(() => {
+    routeRegistry?.unregister()
+    IframeRouteManager.getInstance().clear()
+
+    const menuStore = useMenuStore()
+    menuStore.removeAllDynamicRoutes()
+    menuStore.setMenuList([])
+
+    // 重置路由初始化状态，允许重新登录后再次初始化
+    resetRouteInitState()
+  }, delay)
+}
+
+/**
+ * 处理根路径重定向到首页
+ * @returns true 表示已处理跳转，false 表示无需跳转
+ */
+function handleRootPathRedirect(to: RouteLocationNormalized, next: NavigationGuardNext): boolean {
+  if (to.path !== '/') {
+    return false
+  }
+
+  const { homePath } = useCommon()
+  if (homePath.value && homePath.value !== '/') {
+    next({ path: homePath.value, replace: true })
+    return true
+  }
+
+  return false
+}
+
+/**
+ * 判断是否为未授权错误（401）
+ */
+function isUnauthorizedError(error: unknown): boolean {
+  return isHttpError(error) && error.code === ApiStatus.unauthorized
+}
diff --git a/web/src/router/index.ts b/web/src/router/index.ts
new file mode 100755
index 0000000..286ae58
--- /dev/null
+++ b/web/src/router/index.ts
@@ -0,0 +1,23 @@
+import type { App } from 'vue'
+import { createRouter, createWebHashHistory } from 'vue-router'
+import { staticRoutes } from './routes/staticRoutes'
+import { configureNProgress } from '@/utils/router'
+import { setupBeforeEachGuard } from './guards/beforeEach'
+import { setupAfterEachGuard } from './guards/afterEach'
+
+// 创建路由实例
+export const router = createRouter({
+  history: createWebHashHistory(),
+  routes: staticRoutes // 静态路由
+})
+
+// 初始化路由
+export function initRouter(app: App<Element>): void {
+  configureNProgress() // 顶部进度条
+  setupBeforeEachGuard(router) // 路由前置守卫
+  setupAfterEachGuard(router) // 路由后置守卫
+  app.use(router)
+}
+
+// 主页路径，默认使用菜单第一个有效路径，配置后使用此路径
+export const HOME_PAGE_PATH = ''
diff --git a/web/src/router/modules/dashboard.ts b/web/src/router/modules/dashboard.ts
new file mode 100644
index 0000000..1816240
--- /dev/null
+++ b/web/src/router/modules/dashboard.ts
@@ -0,0 +1,60 @@
+import { AppRouteRecord } from '@/types/router'
+
+export const dashboardRoutes: AppRouteRecord = {
+  name: 'Dashboard',
+  path: '/dashboard',
+  component: '/index/index',
+  meta: {
+    title: 'menus.dashboard.title',
+    icon: 'ri:pie-chart-line',
+    roles: ['R_SUPER', 'R_ADMIN']
+  },
+  children: [
+    {
+      path: 'console',
+      name: 'Console',
+      component: '/dashboard/console',
+      meta: {
+        title: 'menus.dashboard.overview',
+        keepAlive: false,
+        fixedTab: true
+      }
+    },
+    {
+      path: 'timeline',
+      name: 'Timeline',
+      component: '/dashboard/timeline',
+      meta: {
+        title: 'menus.dashboard.timeline',
+        keepAlive: true
+      }
+    },
+    {
+      path: 'search',
+      name: 'SearchRecords',
+      component: '/dashboard/search',
+      meta: {
+        title: 'menus.dashboard.search',
+        keepAlive: true
+      }
+    },
+    {
+      path: 'contacts',
+      name: 'Contacts',
+      component: '/dashboard/contacts',
+      meta: {
+        title: 'menus.dashboard.contacts',
+        keepAlive: true
+      }
+    },
+    {
+      path: 'imports',
+      name: 'Imports',
+      component: '/dashboard/imports',
+      meta: {
+        title: 'menus.dashboard.imports',
+        keepAlive: true
+      }
+    }
+  ]
+}
diff --git a/web/src/router/modules/exception.ts b/web/src/router/modules/exception.ts
new file mode 100644
index 0000000..07c5604
--- /dev/null
+++ b/web/src/router/modules/exception.ts
@@ -0,0 +1,46 @@
+import { AppRouteRecord } from '@/types/router'
+
+export const exceptionRoutes: AppRouteRecord = {
+  path: '/exception',
+  name: 'Exception',
+  component: '/index/index',
+  meta: {
+    title: 'menus.exception.title',
+    icon: 'ri:error-warning-line'
+  },
+  children: [
+    {
+      path: '403',
+      name: 'Exception403',
+      component: '/exception/403',
+      meta: {
+        title: 'menus.exception.forbidden',
+        keepAlive: true,
+        isHideTab: true,
+        isFullPage: true
+      }
+    },
+    {
+      path: '404',
+      name: 'Exception404',
+      component: '/exception/404',
+      meta: {
+        title: 'menus.exception.notFound',
+        keepAlive: true,
+        isHideTab: true,
+        isFullPage: true
+      }
+    },
+    {
+      path: '500',
+      name: 'Exception500',
+      component: '/exception/500',
+      meta: {
+        title: 'menus.exception.serverError',
+        keepAlive: true,
+        isHideTab: true,
+        isFullPage: true
+      }
+    }
+  ]
+}
diff --git a/web/src/router/modules/index.ts b/web/src/router/modules/index.ts
new file mode 100644
index 0000000..deff162
--- /dev/null
+++ b/web/src/router/modules/index.ts
@@ -0,0 +1,15 @@
+import { AppRouteRecord } from '@/types/router'
+import { dashboardRoutes } from './dashboard'
+import { systemRoutes } from './system'
+import { resultRoutes } from './result'
+import { exceptionRoutes } from './exception'
+
+/**
+ * 导出所有模块化路由
+ */
+export const routeModules: AppRouteRecord[] = [
+  dashboardRoutes,
+  systemRoutes,
+  resultRoutes,
+  exceptionRoutes
+]
diff --git a/web/src/router/modules/result.ts b/web/src/router/modules/result.ts
new file mode 100644
index 0000000..575a2f7
--- /dev/null
+++ b/web/src/router/modules/result.ts
@@ -0,0 +1,33 @@
+import { AppRouteRecord } from '@/types/router'
+
+export const resultRoutes: AppRouteRecord = {
+  path: '/result',
+  name: 'Result',
+  component: '/index/index',
+  meta: {
+    title: 'menus.result.title',
+    icon: 'ri:checkbox-circle-line'
+  },
+  children: [
+    {
+      path: 'success',
+      name: 'ResultSuccess',
+      component: '/result/success',
+      meta: {
+        title: 'menus.result.success',
+        icon: 'ri:checkbox-circle-line',
+        keepAlive: true
+      }
+    },
+    {
+      path: 'fail',
+      name: 'ResultFail',
+      component: '/result/fail',
+      meta: {
+        title: 'menus.result.fail',
+        icon: 'ri:close-circle-line',
+        keepAlive: true
+      }
+    }
+  ]
+}
diff --git a/web/src/router/modules/system.ts b/web/src/router/modules/system.ts
new file mode 100644
index 0000000..16df585
--- /dev/null
+++ b/web/src/router/modules/system.ts
@@ -0,0 +1,60 @@
+import { AppRouteRecord } from '@/types/router'
+
+export const systemRoutes: AppRouteRecord = {
+  path: '/system',
+  name: 'System',
+  component: '/index/index',
+  meta: {
+    title: 'menus.system.title',
+    icon: 'ri:user-3-line',
+    roles: ['R_SUPER', 'R_ADMIN']
+  },
+  children: [
+    {
+      path: 'user',
+      name: 'User',
+      component: '/system/user',
+      meta: {
+        title: 'menus.system.user',
+        keepAlive: true,
+        roles: ['R_SUPER', 'R_ADMIN']
+      }
+    },
+    {
+      path: 'role',
+      name: 'Role',
+      component: '/system/role',
+      meta: {
+        title: 'menus.system.role',
+        keepAlive: true,
+        roles: ['R_SUPER']
+      }
+    },
+    {
+      path: 'user-center',
+      name: 'UserCenter',
+      component: '/system/user-center',
+      meta: {
+        title: 'menus.system.userCenter',
+        isHide: true,
+        keepAlive: true,
+        isHideTab: true
+      }
+    },
+    {
+      path: 'menu',
+      name: 'Menus',
+      component: '/system/menu',
+      meta: {
+        title: 'menus.system.menu',
+        keepAlive: true,
+        roles: ['R_SUPER'],
+        authList: [
+          { title: '新增', authMark: 'add' },
+          { title: '编辑', authMark: 'edit' },
+          { title: '删除', authMark: 'delete' }
+        ]
+      }
+    }
+  ]
+}
diff --git a/web/src/router/routes/asyncRoutes.ts b/web/src/router/routes/asyncRoutes.ts
new file mode 100644
index 0000000..ccf1201
--- /dev/null
+++ b/web/src/router/routes/asyncRoutes.ts
@@ -0,0 +1,9 @@
+// 权限文档：https://www.artd.pro/docs/zh/guide/in-depth/permission.html
+import { AppRouteRecord } from '@/types/router'
+import { routeModules } from '../modules'
+
+/**
+ * 动态路由（需要权限才能访问的路由）
+ * 用于渲染菜单以及根据菜单权限动态加载路由，如果没有权限无法访问
+ */
+export const asyncRoutes: AppRouteRecord[] = routeModules
diff --git a/web/src/router/routes/staticRoutes.ts b/web/src/router/routes/staticRoutes.ts
new file mode 100644
index 0000000..8872fda
--- /dev/null
+++ b/web/src/router/routes/staticRoutes.ts
@@ -0,0 +1,78 @@
+import { AppRouteRecordRaw } from '@/utils/router'
+
+/**
+ * 静态路由配置（不需要权限就能访问的路由）
+ *
+ * 属性说明：
+ * isHideTab: true 表示不在标签页中显示
+ *
+ * 注意事项：
+ * 1、path、name 不要和动态路由冲突，否则会导致路由冲突无法访问
+ * 2、静态路由不管是否登录都可以访问
+ */
+export const staticRoutes: AppRouteRecordRaw[] = [
+  // 不需要登录就能访问的路由示例
+  // {
+  //   path: '/welcome',
+  //   name: 'WelcomeStatic',
+  //   component: () => import('@views/dashboard/console/index.vue'),
+  //   meta: { title: 'menus.dashboard.title' }
+  // },
+  {
+    path: '/setup',
+    name: 'Setup',
+    component: () => import('@views/setup/index.vue'),
+    meta: { title: 'menus.setup.title', isHideTab: true }
+  },
+  {
+    path: '/auth/login',
+    name: 'Login',
+    component: () => import('@views/auth/login/index.vue'),
+    meta: { title: 'menus.login.title', isHideTab: true }
+  },
+  {
+    path: '/auth/register',
+    name: 'Register',
+    component: () => import('@views/auth/register/index.vue'),
+    meta: { title: 'menus.register.title', isHideTab: true }
+  },
+  {
+    path: '/auth/forget-password',
+    name: 'ForgetPassword',
+    component: () => import('@views/auth/forget-password/index.vue'),
+    meta: { title: 'menus.forgetPassword.title', isHideTab: true }
+  },
+  {
+    path: '/403',
+    name: 'Exception403',
+    component: () => import('@views/exception/403/index.vue'),
+    meta: { title: '403', isHideTab: true }
+  },
+  {
+    path: '/:pathMatch(.*)*',
+    name: 'Exception404',
+    component: () => import('@views/exception/404/index.vue'),
+    meta: { title: '404', isHideTab: true }
+  },
+  {
+    path: '/500',
+    name: 'Exception500',
+    component: () => import('@views/exception/500/index.vue'),
+    meta: { title: '500', isHideTab: true }
+  },
+  {
+    path: '/outside',
+    component: () => import('@views/index/index.vue'),
+    name: 'Outside',
+    meta: { title: 'menus.outside.title' },
+    children: [
+      // iframe 内嵌页面
+      {
+        path: '/outside/iframe/:path',
+        name: 'Iframe',
+        component: () => import('@/views/outside/Iframe.vue'),
+        meta: { title: 'iframe' }
+      }
+    ]
+  }
+]
diff --git a/web/src/router/routesAlias.ts b/web/src/router/routesAlias.ts
new file mode 100644
index 0000000..2af1c68
--- /dev/null
+++ b/web/src/router/routesAlias.ts
@@ -0,0 +1,8 @@
+/**
+ * 公共路由别名
+ # 存放系统级公共路由路径，如布局容器、登录页等   
+ */
+export enum RoutesAlias {
+  Layout = '/index/index', // 布局容器
+  Login = '/auth/login' // 登录页
+}
diff --git a/web/src/store/index.ts b/web/src/store/index.ts
new file mode 100755
index 0000000..b485999
--- /dev/null
+++ b/web/src/store/index.ts
@@ -0,0 +1,52 @@
+/**
+ * Pinia Store 配置模块
+ *
+ * 提供全局状态管理的初始化和配置
+ *
+ * ## 主要功能
+ *
+ * - Pinia Store 实例创建
+ * - 持久化插件配置（pinia-plugin-persistedstate）
+ * - 版本化存储键管理
+ * - 自动数据迁移（跨版本）
+ * - LocalStorage 序列化配置
+ * - Store 初始化函数
+ *
+ * ## 持久化策略
+ *
+ * - 使用 StorageKeyManager 生成版本化的存储键
+ * - 格式：sys-v{version}-{storeId}
+ * - 自动迁移旧版本数据到当前版本
+ * - 使用 localStorage 作为存储介质
+ *
+ * @module store/index
+ * @author Art Design Pro Team
+ */
+import type { App } from 'vue'
+import { createPinia } from 'pinia'
+import { createPersistedState } from 'pinia-plugin-persistedstate'
+import { StorageKeyManager } from '@/utils/storage/storage-key-manager'
+
+export const store = createPinia()
+
+// 创建存储键管理器实例
+const storageKeyManager = new StorageKeyManager()
+
+// 配置持久化插件
+store.use(
+  createPersistedState({
+    key: (storeId: string) => storageKeyManager.getStorageKey(storeId),
+    storage: localStorage,
+    serializer: {
+      serialize: JSON.stringify,
+      deserialize: JSON.parse
+    }
+  })
+)
+
+/**
+ * 初始化 Store
+ */
+export function initStore(app: App<Element>): void {
+  app.use(store)
+}
diff --git a/web/src/store/modules/menu.ts b/web/src/store/modules/menu.ts
new file mode 100755
index 0000000..85d13da
--- /dev/null
+++ b/web/src/store/modules/menu.ts
@@ -0,0 +1,109 @@
+/**
+ * 菜单状态管理模块
+ *
+ * 提供菜单数据和动态路由的状态管理
+ *
+ * ## 主要功能
+ *
+ * - 菜单列表存储和管理
+ * - 首页路径配置
+ * - 动态路由注册和移除
+ * - 路由移除函数管理
+ * - 菜单宽度配置
+ *
+ * ## 使用场景
+ *
+ * - 动态菜单加载和渲染
+ * - 路由权限控制
+ * - 首页路径动态设置
+ * - 登出时清理动态路由
+ *
+ * ## 工作流程
+ *
+ * 1. 获取菜单数据（前端/后端模式）
+ * 2. 设置菜单列表和首页路径
+ * 3. 注册动态路由并保存移除函数
+ * 4. 登出时调用移除函数清理路由
+ *
+ * @module store/modules/menu
+ * @author Art Design Pro Team
+ */
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import { AppRouteRecord } from '@/types/router'
+import { getFirstMenuPath } from '@/utils'
+import { HOME_PAGE_PATH } from '@/router'
+
+/**
+ * 菜单状态管理
+ * 管理应用的菜单列表、首页路径、菜单宽度和动态路由移除函数
+ */
+export const useMenuStore = defineStore('menuStore', () => {
+  /** 首页路径 */
+  const homePath = ref(HOME_PAGE_PATH)
+  /** 菜单列表 */
+  const menuList = ref<AppRouteRecord[]>([])
+  /** 菜单宽度 */
+  const menuWidth = ref('')
+  /** 存储路由移除函数的数组 */
+  const removeRouteFns = ref<(() => void)[]>([])
+
+  /**
+   * 设置菜单列表
+   * @param list 菜单路由记录数组
+   */
+  const setMenuList = (list: AppRouteRecord[]) => {
+    menuList.value = list
+    setHomePath(HOME_PAGE_PATH || getFirstMenuPath(list))
+  }
+
+  /**
+   * 获取首页路径
+   * @returns 首页路径字符串
+   */
+  const getHomePath = () => homePath.value
+
+  /**
+   * 设置主页路径
+   * @param path 主页路径
+   */
+  const setHomePath = (path: string) => {
+    homePath.value = path
+  }
+
+  /**
+   * 添加路由移除函数
+   * @param fns 要添加的路由移除函数数组
+   */
+  const addRemoveRouteFns = (fns: (() => void)[]) => {
+    removeRouteFns.value.push(...fns)
+  }
+
+  /**
+   * 移除所有动态路由
+   * 执行所有存储的路由移除函数并清空数组
+   */
+  const removeAllDynamicRoutes = () => {
+    removeRouteFns.value.forEach((fn) => fn())
+    removeRouteFns.value = []
+  }
+
+  /**
+   * 清空路由移除函数数组
+   */
+  const clearRemoveRouteFns = () => {
+    removeRouteFns.value = []
+  }
+
+  return {
+    menuList,
+    menuWidth,
+    removeRouteFns,
+    setMenuList,
+    getHomePath,
+    setHomePath,
+    addRemoveRouteFns,
+    removeAllDynamicRoutes,
+    clearRemoveRouteFns
+  }
+})
diff --git a/web/src/store/modules/setting.ts b/web/src/store/modules/setting.ts
new file mode 100755
index 0000000..2878259
--- /dev/null
+++ b/web/src/store/modules/setting.ts
@@ -0,0 +1,450 @@
+/**
+ * 系统设置状态管理模块
+ *
+ * 提供完整的系统设置状态管理
+ *
+ * ## 主要功能
+ *
+ * - 菜单布局配置（左侧、顶部、混合、双栏）
+ * - 主题管理（亮色、暗色、自动）
+ * - 菜单主题样式配置
+ * - 界面显示开关（面包屑、标签页、语言切换等）
+ * - 功能开关（手风琴模式、色弱模式、水印等）
+ * - 样式配置（边框、圆角、容器宽度、页面过渡）
+ * - 节日功能配置
+ * - Element Plus 主题色动态设置
+ *
+ * ## 使用场景
+ *
+ * - 设置面板配置管理
+ * - 主题切换和样式定制
+ * - 界面功能开关控制
+ * - 用户偏好设置持久化
+ *
+ * ## 持久化
+ *
+ * - 使用 localStorage 存储
+ * - 存储键：sys-v{version}-setting
+ * - 支持跨版本数据迁移
+ *
+ * @module store/modules/setting
+ * @author Art Design Pro Team
+ */
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+import { MenuThemeType } from '@/types/store'
+import AppConfig from '@/config'
+import { SystemThemeEnum, MenuThemeEnum, MenuTypeEnum, ContainerWidthEnum } from '@/enums/appEnum'
+import { setElementThemeColor } from '@/utils/ui'
+import { useCeremony } from '@/hooks/core/useCeremony'
+import { StorageConfig } from '@/utils'
+import { SETTING_DEFAULT_CONFIG } from '@/config/setting'
+
+/**
+ * 系统设置状态管理
+ * 管理应用的菜单、主题、界面显示等各项设置
+ */
+export const useSettingStore = defineStore(
+  'settingStore',
+  () => {
+    // 菜单相关设置
+    /** 菜单类型 */
+    const menuType = ref(SETTING_DEFAULT_CONFIG.menuType)
+    /** 菜单展开宽度 */
+    const menuOpenWidth = ref(SETTING_DEFAULT_CONFIG.menuOpenWidth)
+    /** 菜单是否展开 */
+    const menuOpen = ref(SETTING_DEFAULT_CONFIG.menuOpen)
+    /** 双菜单是否显示文本 */
+    const dualMenuShowText = ref(SETTING_DEFAULT_CONFIG.dualMenuShowText)
+
+    // 主题相关设置
+    /** 系统主题类型 */
+    const systemThemeType = ref(SETTING_DEFAULT_CONFIG.systemThemeType)
+    /** 系统主题模式 */
+    const systemThemeMode = ref(SETTING_DEFAULT_CONFIG.systemThemeMode)
+    /** 菜单主题类型 */
+    const menuThemeType = ref(SETTING_DEFAULT_CONFIG.menuThemeType)
+    /** 系统主题颜色 */
+    const systemThemeColor = ref(SETTING_DEFAULT_CONFIG.systemThemeColor)
+
+    // 界面显示设置
+    /** 是否显示菜单按钮 */
+    const showMenuButton = ref(SETTING_DEFAULT_CONFIG.showMenuButton)
+    /** 是否显示快速入口 */
+    const showFastEnter = ref(SETTING_DEFAULT_CONFIG.showFastEnter)
+    /** 是否显示刷新按钮 */
+    const showRefreshButton = ref(SETTING_DEFAULT_CONFIG.showRefreshButton)
+    /** 是否显示面包屑 */
+    const showCrumbs = ref(SETTING_DEFAULT_CONFIG.showCrumbs)
+    /** 是否显示工作台标签 */
+    const showWorkTab = ref(SETTING_DEFAULT_CONFIG.showWorkTab)
+    /** 是否显示语言切换 */
+    const showLanguage = ref(SETTING_DEFAULT_CONFIG.showLanguage)
+    /** 是否显示进度条 */
+    const showNprogress = ref(SETTING_DEFAULT_CONFIG.showNprogress)
+    /** 是否显示设置引导 */
+    const showSettingGuide = ref(SETTING_DEFAULT_CONFIG.showSettingGuide)
+    /** 是否显示节日文本 */
+    const showFestivalText = ref(SETTING_DEFAULT_CONFIG.showFestivalText)
+    /** 是否显示水印 */
+    const watermarkVisible = ref(SETTING_DEFAULT_CONFIG.watermarkVisible)
+
+    // 功能设置
+    /** 是否自动关闭 */
+    const autoClose = ref(SETTING_DEFAULT_CONFIG.autoClose)
+    /** 是否唯一展开 */
+    const uniqueOpened = ref(SETTING_DEFAULT_CONFIG.uniqueOpened)
+    /** 是否色弱模式 */
+    const colorWeak = ref(SETTING_DEFAULT_CONFIG.colorWeak)
+    /** 是否刷新 */
+    const refresh = ref(SETTING_DEFAULT_CONFIG.refresh)
+    /** 是否加载节日烟花 */
+    const holidayFireworksLoaded = ref(SETTING_DEFAULT_CONFIG.holidayFireworksLoaded)
+
+    // 样式设置
+    /** 边框模式 */
+    const boxBorderMode = ref(SETTING_DEFAULT_CONFIG.boxBorderMode)
+    /** 页面过渡效果 */
+    const pageTransition = ref(SETTING_DEFAULT_CONFIG.pageTransition)
+    /** 标签页样式 */
+    const tabStyle = ref(SETTING_DEFAULT_CONFIG.tabStyle)
+    /** 自定义圆角 */
+    const customRadius = ref(SETTING_DEFAULT_CONFIG.customRadius)
+    /** 容器宽度 */
+    const containerWidth = ref(SETTING_DEFAULT_CONFIG.containerWidth)
+
+    // 节日相关
+    /** 节日日期 */
+    const festivalDate = ref('')
+
+    /**
+     * 获取菜单主题
+     * 根据当前主题类型和暗色模式返回对应的主题配置
+     */
+    const getMenuTheme = computed((): MenuThemeType => {
+      const list = AppConfig.themeList.filter((item) => item.theme === menuThemeType.value)
+      if (isDark.value) {
+        return AppConfig.darkMenuStyles[0]
+      } else {
+        return list[0]
+      }
+    })
+
+    /**
+     * 判断是否为暗色模式
+     */
+    const isDark = computed((): boolean => {
+      return systemThemeType.value === SystemThemeEnum.DARK
+    })
+
+    /**
+     * 获取菜单展开宽度
+     */
+    const getMenuOpenWidth = computed((): string => {
+      return menuOpenWidth.value + 'px' || SETTING_DEFAULT_CONFIG.menuOpenWidth + 'px'
+    })
+
+    /**
+     * 获取自定义圆角
+     */
+    const getCustomRadius = computed((): string => {
+      return customRadius.value + 'rem' || SETTING_DEFAULT_CONFIG.customRadius + 'rem'
+    })
+
+    /**
+     * 是否显示烟花
+     * 根据当前日期和节日日期判断是否显示烟花效果
+     */
+    const isShowFireworks = computed((): boolean => {
+      return festivalDate.value === useCeremony().currentFestivalData.value?.date ? false : true
+    })
+
+    /**
+     * 切换菜单布局
+     * @param type 菜单类型
+     */
+    const switchMenuLayouts = (type: MenuTypeEnum) => {
+      menuType.value = type
+    }
+
+    /**
+     * 设置菜单展开宽度
+     * @param width 宽度值
+     */
+    const setMenuOpenWidth = (width: number) => {
+      menuOpenWidth.value = width
+    }
+
+    /**
+     * 设置全局主题
+     * @param theme 主题类型
+     * @param themeMode 主题模式
+     */
+    const setGlopTheme = (theme: SystemThemeEnum, themeMode: SystemThemeEnum) => {
+      systemThemeType.value = theme
+      systemThemeMode.value = themeMode
+      localStorage.setItem(StorageConfig.THEME_KEY, theme)
+    }
+
+    /**
+     * 切换菜单样式
+     * @param theme 菜单主题
+     */
+    const switchMenuStyles = (theme: MenuThemeEnum) => {
+      menuThemeType.value = theme
+    }
+
+    /**
+     * 设置Element Plus主题颜色
+     * @param theme 主题颜色
+     */
+    const setElementTheme = (theme: string) => {
+      systemThemeColor.value = theme
+      setElementThemeColor(theme)
+    }
+
+    /**
+     * 切换边框模式
+     */
+    const setBorderMode = () => {
+      boxBorderMode.value = !boxBorderMode.value
+    }
+
+    /**
+     * 设置容器宽度
+     * @param width 容器宽度枚举值
+     */
+    const setContainerWidth = (width: ContainerWidthEnum) => {
+      containerWidth.value = width
+    }
+
+    /**
+     * 切换唯一展开模式
+     */
+    const setUniqueOpened = () => {
+      uniqueOpened.value = !uniqueOpened.value
+    }
+
+    /**
+     * 切换菜单按钮显示
+     */
+    const setButton = () => {
+      showMenuButton.value = !showMenuButton.value
+    }
+
+    /**
+     * 切换快速入口显示
+     */
+    const setFastEnter = () => {
+      showFastEnter.value = !showFastEnter.value
+    }
+
+    /**
+     * 切换自动关闭
+     */
+    const setAutoClose = () => {
+      autoClose.value = !autoClose.value
+    }
+
+    /**
+     * 切换刷新按钮显示
+     */
+    const setShowRefreshButton = () => {
+      showRefreshButton.value = !showRefreshButton.value
+    }
+
+    /**
+     * 切换面包屑显示
+     */
+    const setCrumbs = () => {
+      showCrumbs.value = !showCrumbs.value
+    }
+
+    /**
+     * 设置工作台标签显示
+     * @param show 是否显示
+     */
+    const setWorkTab = (show: boolean) => {
+      showWorkTab.value = show
+    }
+
+    /**
+     * 切换语言切换显示
+     */
+    const setLanguage = () => {
+      showLanguage.value = !showLanguage.value
+    }
+
+    /**
+     * 切换进度条显示
+     */
+    const setNprogress = () => {
+      showNprogress.value = !showNprogress.value
+    }
+
+    /**
+     * 切换色弱模式
+     */
+    const setColorWeak = () => {
+      colorWeak.value = !colorWeak.value
+    }
+
+    /**
+     * 隐藏设置引导
+     */
+    const hideSettingGuide = () => {
+      showSettingGuide.value = false
+    }
+
+    /**
+     * 显示设置引导
+     */
+    const openSettingGuide = () => {
+      showSettingGuide.value = true
+    }
+
+    /**
+     * 设置页面过渡效果
+     * @param transition 过渡效果名称
+     */
+    const setPageTransition = (transition: string) => {
+      pageTransition.value = transition
+    }
+
+    /**
+     * 设置标签页样式
+     * @param style 样式名称
+     */
+    const setTabStyle = (style: string) => {
+      tabStyle.value = style
+    }
+
+    /**
+     * 设置菜单展开状态
+     * @param open 是否展开
+     */
+    const setMenuOpen = (open: boolean) => {
+      menuOpen.value = open
+    }
+
+    /**
+     * 刷新页面
+     */
+    const reload = () => {
+      refresh.value = !refresh.value
+    }
+
+    /**
+     * 设置水印显示
+     * @param visible 是否显示
+     */
+    const setWatermarkVisible = (visible: boolean) => {
+      watermarkVisible.value = visible
+    }
+
+    /**
+     * 设置自定义圆角
+     * @param radius 圆角值
+     */
+    const setCustomRadius = (radius: string) => {
+      customRadius.value = radius
+      document.documentElement.style.setProperty('--custom-radius', `${radius}rem`)
+    }
+
+    /**
+     * 设置节日烟花加载状态
+     * @param isLoad 是否已加载
+     */
+    const setholidayFireworksLoaded = (isLoad: boolean) => {
+      holidayFireworksLoaded.value = isLoad
+    }
+
+    /**
+     * 设置节日文本显示
+     * @param show 是否显示
+     */
+    const setShowFestivalText = (show: boolean) => {
+      showFestivalText.value = show
+    }
+
+    const setFestivalDate = (date: string) => {
+      festivalDate.value = date
+    }
+
+    const setDualMenuShowText = (show: boolean) => {
+      dualMenuShowText.value = show
+    }
+
+    return {
+      menuType,
+      menuOpenWidth,
+      systemThemeType,
+      systemThemeMode,
+      menuThemeType,
+      systemThemeColor,
+      boxBorderMode,
+      uniqueOpened,
+      showMenuButton,
+      showFastEnter,
+      showRefreshButton,
+      showCrumbs,
+      autoClose,
+      showWorkTab,
+      showLanguage,
+      showNprogress,
+      colorWeak,
+      showSettingGuide,
+      pageTransition,
+      tabStyle,
+      menuOpen,
+      refresh,
+      watermarkVisible,
+      customRadius,
+      holidayFireworksLoaded,
+      showFestivalText,
+      festivalDate,
+      dualMenuShowText,
+      containerWidth,
+      getMenuTheme,
+      isDark,
+      getMenuOpenWidth,
+      getCustomRadius,
+      isShowFireworks,
+      switchMenuLayouts,
+      setMenuOpenWidth,
+      setGlopTheme,
+      switchMenuStyles,
+      setElementTheme,
+      setBorderMode,
+      setContainerWidth,
+      setUniqueOpened,
+      setButton,
+      setFastEnter,
+      setAutoClose,
+      setShowRefreshButton,
+      setCrumbs,
+      setWorkTab,
+      setLanguage,
+      setNprogress,
+      setColorWeak,
+      hideSettingGuide,
+      openSettingGuide,
+      setPageTransition,
+      setTabStyle,
+      setMenuOpen,
+      reload,
+      setWatermarkVisible,
+      setCustomRadius,
+      setholidayFireworksLoaded,
+      setShowFestivalText,
+      setFestivalDate,
+      setDualMenuShowText
+    }
+  },
+  {
+    persist: {
+      key: 'setting',
+      storage: localStorage
+    }
+  }
+)
diff --git a/web/src/store/modules/table.ts b/web/src/store/modules/table.ts
new file mode 100644
index 0000000..094c310
--- /dev/null
+++ b/web/src/store/modules/table.ts
@@ -0,0 +1,97 @@
+/**
+ * 表格状态管理模块
+ *
+ * 提供表格显示配置的状态管理
+ *
+ * ## 主要功能
+ *
+ * - 表格尺寸配置（紧凑、默认、宽松）
+ * - 斑马纹显示开关
+ * - 边框显示开关
+ * - 表头背景显示开关
+ * - 全屏模式开关
+ *
+ * ## 使用场景
+ * - 表格组件样式配置
+ * - 用户表格偏好设置
+ * - 表格工具栏功能控制
+ *
+ * ## 持久化
+ *
+ * - 使用 localStorage 存储
+ * - 存储键：sys-v{version}-table
+ * - 用户配置跨页面保持
+ *
+ * @module store/modules/table
+ * @author Art Design Pro Team
+ */
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import { TableSizeEnum } from '@/enums/formEnum'
+
+// 表格
+export const useTableStore = defineStore(
+  'tableStore',
+  () => {
+    // 表格大小
+    const tableSize = ref(TableSizeEnum.DEFAULT)
+    // 斑马纹
+    const isZebra = ref(false)
+    // 边框
+    const isBorder = ref(false)
+    // 表头背景
+    const isHeaderBackground = ref(false)
+
+    // 是否全屏
+    const isFullScreen = ref(false)
+
+    /**
+     * 设置表格大小
+     * @param size 表格大小枚举值
+     */
+    const setTableSize = (size: TableSizeEnum) => (tableSize.value = size)
+
+    /**
+     * 设置斑马纹显示状态
+     * @param value 是否显示斑马纹
+     */
+    const setIsZebra = (value: boolean) => (isZebra.value = value)
+
+    /**
+     * 设置表格边框显示状态
+     * @param value 是否显示边框
+     */
+    const setIsBorder = (value: boolean) => (isBorder.value = value)
+
+    /**
+     * 设置表头背景显示状态
+     * @param value 是否显示表头背景
+     */
+    const setIsHeaderBackground = (value: boolean) => (isHeaderBackground.value = value)
+
+    /**
+     * 设置是否全屏
+     * @param value 是否全屏
+     */
+    const setIsFullScreen = (value: boolean) => (isFullScreen.value = value)
+
+    return {
+      tableSize,
+      isZebra,
+      isBorder,
+      isHeaderBackground,
+      setTableSize,
+      setIsZebra,
+      setIsBorder,
+      setIsHeaderBackground,
+      isFullScreen,
+      setIsFullScreen
+    }
+  },
+  {
+    persist: {
+      key: 'table',
+      storage: localStorage
+    }
+  }
+)
diff --git a/web/src/store/modules/user.ts b/web/src/store/modules/user.ts
new file mode 100755
index 0000000..388b117
--- /dev/null
+++ b/web/src/store/modules/user.ts
@@ -0,0 +1,226 @@
+/**
+ * 用户状态管理模块
+ *
+ * 提供用户相关的状态管理
+ *
+ * ## 主要功能
+ *
+ * - 用户登录状态管理
+ * - 用户信息存储
+ * - 访问令牌和刷新令牌管理
+ * - 语言设置
+ * - 搜索历史记录
+ * - 锁屏状态和密码管理
+ * - 登出清理逻辑
+ *
+ * ## 使用场景
+ *
+ * - 用户登录和认证
+ * - 权限验证
+ * - 个人信息展示
+ * - 多语言切换
+ * - 锁屏功能
+ * - 搜索历史管理
+ *
+ * ## 持久化
+ *
+ * - 使用 localStorage 存储
+ * - 存储键：sys-v{version}-user
+ * - 登出时自动清理
+ *
+ * @module store/modules/user
+ * @author Art Design Pro Team
+ */
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+import { LanguageEnum } from '@/enums/appEnum'
+import { router } from '@/router'
+import { useSettingStore } from './setting'
+import { useWorktabStore } from './worktab'
+import { AppRouteRecord } from '@/types/router'
+import { setPageTitle } from '@/utils/router'
+import { resetRouterState } from '@/router/guards/beforeEach'
+import { useMenuStore } from './menu'
+import { StorageConfig } from '@/utils/storage/storage-config'
+
+/**
+ * 用户状态管理
+ * 管理用户登录状态、个人信息、语言设置、搜索历史、锁屏状态等
+ */
+export const useUserStore = defineStore(
+  'userStore',
+  () => {
+    // 语言设置
+    const language = ref(LanguageEnum.ZH)
+    // 登录状态
+    const isLogin = ref(false)
+    // 锁屏状态
+    const isLock = ref(false)
+    // 锁屏密码
+    const lockPassword = ref('')
+    // 用户信息
+    const info = ref<Partial<Api.Auth.UserInfo>>({})
+    // 搜索历史记录
+    const searchHistory = ref<AppRouteRecord[]>([])
+    // 访问令牌
+    const accessToken = ref('')
+    // 计算属性：获取用户信息
+    const getUserInfo = computed(() => info.value)
+    // 计算属性：获取设置状态
+    const getSettingState = computed(() => useSettingStore().$state)
+    // 计算属性：获取工作台状态
+    const getWorktabState = computed(() => useWorktabStore().$state)
+
+    /**
+     * 设置用户信息
+     * @param newInfo 新的用户信息
+     */
+    const setUserInfo = (newInfo: Api.Auth.UserInfo) => {
+      info.value = newInfo
+    }
+
+    /**
+     * 设置登录状态
+     * @param status 登录状态
+     */
+    const setLoginStatus = (status: boolean) => {
+      isLogin.value = status
+    }
+
+    /**
+     * 设置语言
+     * @param lang 语言枚举值
+     */
+    const setLanguage = (lang: LanguageEnum) => {
+      setPageTitle(router.currentRoute.value)
+      language.value = lang
+    }
+
+    /**
+     * 设置搜索历史
+     * @param list 搜索历史列表
+     */
+    const setSearchHistory = (list: AppRouteRecord[]) => {
+      searchHistory.value = list
+    }
+
+    /**
+     * 设置锁屏状态
+     * @param status 锁屏状态
+     */
+    const setLockStatus = (status: boolean) => {
+      isLock.value = status
+    }
+
+    /**
+     * 设置锁屏密码
+     * @param password 锁屏密码
+     */
+    const setLockPassword = (password: string) => {
+      lockPassword.value = password
+    }
+
+    /**
+     * 设置令牌
+     * @param newAccessToken 访问令牌
+     */
+    const setToken = (newAccessToken: string) => {
+      accessToken.value = newAccessToken
+      isLogin.value = Boolean(newAccessToken)
+    }
+
+    /**
+     * 退出登录
+     * 清空所有用户相关状态并跳转到登录页
+     * 如果是同一账号重新登录，保留工作台标签页
+     */
+    const logOut = () => {
+      // 保存当前用户 ID，用于下次登录时判断是否为同一用户
+      const currentUserId = info.value.userId
+      if (currentUserId) {
+        localStorage.setItem(StorageConfig.LAST_USER_ID_KEY, String(currentUserId))
+      }
+
+      // 清空用户信息
+      info.value = {}
+      // 重置登录状态
+      isLogin.value = false
+      // 重置锁屏状态
+      isLock.value = false
+      // 清空锁屏密码
+      lockPassword.value = ''
+      // 清空访问令牌
+      accessToken.value = ''
+      // 注意：不清空工作台标签页，等下次登录时根据用户判断
+      // 移除iframe路由缓存
+      sessionStorage.removeItem('iframeRoutes')
+      // 清空主页路径
+      useMenuStore().setHomePath('')
+      // 重置路由状态
+      resetRouterState(500)
+      // 跳转到登录页，携带当前路由作为 redirect 参数
+      const currentRoute = router.currentRoute.value
+      const redirect = currentRoute.path !== '/login' ? currentRoute.fullPath : undefined
+      router.push({
+        name: 'Login',
+        query: redirect ? { redirect } : undefined
+      })
+    }
+
+    /**
+     * 检查并清理工作台标签页
+     * 如果不是同一用户登录，清空工作台标签页
+     * 应在登录成功后调用
+     */
+    const checkAndClearWorktabs = () => {
+      const lastUserId = localStorage.getItem(StorageConfig.LAST_USER_ID_KEY)
+      const currentUserId = info.value.userId
+
+      // 无法获取当前用户 ID，跳过检查
+      if (!currentUserId) return
+
+      // 首次登录或缓存已清除，保留现有标签页
+      if (!lastUserId) {
+        return
+      }
+
+      // 不同用户登录，清空工作台标签页
+      if (String(currentUserId) !== lastUserId) {
+        const worktabStore = useWorktabStore()
+        worktabStore.opened = []
+        worktabStore.keepAliveExclude = []
+      }
+
+      // 清除临时存储
+      localStorage.removeItem(StorageConfig.LAST_USER_ID_KEY)
+    }
+
+    return {
+      language,
+      isLogin,
+      isLock,
+      lockPassword,
+      info,
+      searchHistory,
+      accessToken,
+      getUserInfo,
+      getSettingState,
+      getWorktabState,
+      setUserInfo,
+      setLoginStatus,
+      setLanguage,
+      setSearchHistory,
+      setLockStatus,
+      setLockPassword,
+      setToken,
+      logOut,
+      checkAndClearWorktabs
+    }
+  },
+  {
+    persist: {
+      key: 'user',
+      storage: localStorage
+    }
+  }
+)
diff --git a/web/src/store/modules/worktab.ts b/web/src/store/modules/worktab.ts
new file mode 100755
index 0000000..caa0d90
--- /dev/null
+++ b/web/src/store/modules/worktab.ts
@@ -0,0 +1,568 @@
+/**
+ * 工作标签页状态管理模块
+ *
+ * 提供多标签页功能的完整状态管理
+ *
+ * ## 主要功能
+ *
+ * - 标签页打开和关闭
+ * - 标签页固定和取消固定
+ * - 批量关闭（左侧、右侧、其他、全部）
+ * - 标签页缓存管理（KeepAlive）
+ * - 标签页标题自定义
+ * - 标签页路由验证
+ * - 动态路由参数处理
+ *
+ * ## 使用场景
+ *
+ * - 多标签页导航
+ * - 页面缓存控制
+ * - 标签页右键菜单
+ * - 固定常用页面
+ * - 批量关闭标签
+ *
+ * ## 核心特性
+ *
+ * - 智能标签页复用（同路由名称复用）
+ * - 固定标签页保护（不可关闭）
+ * - KeepAlive 缓存排除管理
+ * - 路由有效性验证
+ * - 首页自动保留
+ *
+ * ## 持久化
+ * - 使用 localStorage 存储
+ * - 存储键：sys-v{version}-worktab
+ * - 刷新页面保持标签状态
+ *
+ * @module store/modules/worktab
+ * @author Art Design Pro Team
+ */
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+import { router } from '@/router'
+import { LocationQueryRaw, Router } from 'vue-router'
+import { WorkTab } from '@/types'
+import { useCommon } from '@/hooks/core/useCommon'
+
+interface WorktabState {
+  current: Partial<WorkTab>
+  opened: WorkTab[]
+  keepAliveExclude: string[]
+}
+
+/**
+ * 工作台标签页管理 Store
+ */
+export const useWorktabStore = defineStore(
+  'worktabStore',
+  () => {
+    // 状态定义
+    const current = ref<Partial<WorkTab>>({})
+    const opened = ref<WorkTab[]>([])
+    const keepAliveExclude = ref<string[]>([])
+
+    // 计算属性
+    const hasOpenedTabs = computed(() => opened.value.length > 0)
+    const hasMultipleTabs = computed(() => opened.value.length > 1)
+    const currentTabIndex = computed(() =>
+      current.value.path ? opened.value.findIndex((tab) => tab.path === current.value.path) : -1
+    )
+
+    /**
+     * 查找标签页索引
+     */
+    const findTabIndex = (path: string): number => {
+      return opened.value.findIndex((tab) => tab.path === path)
+    }
+
+    /**
+     * 获取标签页
+     */
+    const getTab = (path: string): WorkTab | undefined => {
+      return opened.value.find((tab) => tab.path === path)
+    }
+
+    /**
+     * 检查标签页是否可关闭
+     */
+    const isTabClosable = (tab: WorkTab): boolean => {
+      return !tab.fixedTab
+    }
+
+    /**
+     * 安全的路由跳转
+     */
+    const safeRouterPush = (tab: Partial<WorkTab>): void => {
+      if (!tab.path) {
+        console.warn('尝试跳转到无效路径的标签页')
+        return
+      }
+
+      try {
+        router.push({
+          path: tab.path,
+          query: tab.query as LocationQueryRaw
+        })
+      } catch (error) {
+        console.error('路由跳转失败:', error)
+      }
+    }
+
+    /**
+     * 打开或激活一个选项卡
+     */
+    const openTab = (tab: WorkTab): void => {
+      if (!tab.path) {
+        console.warn('尝试打开无效的标签页')
+        return
+      }
+
+      // 从 keepAlive 排除列表中移除
+      if (tab.name) {
+        removeKeepAliveExclude(tab.name)
+      }
+
+      // 先根据路由名称查找（应对动态路由参数导致的多开问题），找不到再根据路径查找
+      let existingIndex = -1
+      if (tab.name) {
+        existingIndex = opened.value.findIndex((t) => t.name === tab.name)
+      }
+      if (existingIndex === -1) {
+        existingIndex = findTabIndex(tab.path)
+      }
+
+      if (existingIndex === -1) {
+        // 新增标签页
+        const insertIndex = tab.fixedTab ? findFixedTabInsertIndex() : opened.value.length
+        const newTab = { ...tab }
+
+        if (tab.fixedTab) {
+          opened.value.splice(insertIndex, 0, newTab)
+        } else {
+          opened.value.push(newTab)
+        }
+
+        current.value = newTab
+      } else {
+        // 更新现有标签页（当动态路由参数或查询变更时，复用同一标签）
+        const existingTab = opened.value[existingIndex]
+
+        opened.value[existingIndex] = {
+          ...existingTab,
+          path: tab.path,
+          params: tab.params,
+          query: tab.query,
+          title: tab.title || existingTab.title,
+          fixedTab: tab.fixedTab ?? existingTab.fixedTab,
+          keepAlive: tab.keepAlive ?? existingTab.keepAlive,
+          name: tab.name || existingTab.name,
+          icon: tab.icon || existingTab.icon
+        }
+
+        current.value = opened.value[existingIndex]
+      }
+    }
+
+    /**
+     * 查找固定标签页的插入位置
+     */
+    const findFixedTabInsertIndex = (): number => {
+      let insertIndex = 0
+      for (let i = 0; i < opened.value.length; i++) {
+        if (opened.value[i].fixedTab) {
+          insertIndex = i + 1
+        } else {
+          break
+        }
+      }
+      return insertIndex
+    }
+
+    /**
+     * 关闭指定的选项卡
+     */
+    const removeTab = (path: string): void => {
+      const targetTab = getTab(path)
+      const targetIndex = findTabIndex(path)
+
+      if (targetIndex === -1) {
+        console.warn(`尝试关闭不存在的标签页: ${path}`)
+        return
+      }
+
+      if (targetTab && !isTabClosable(targetTab)) {
+        console.warn(`尝试关闭固定标签页: ${path}`)
+        return
+      }
+
+      // 从标签页列表中移除
+      opened.value.splice(targetIndex, 1)
+
+      // 处理缓存排除
+      if (targetTab?.name) {
+        addKeepAliveExclude(targetTab)
+      }
+
+      const { homePath } = useCommon()
+
+      // 如果关闭后无标签页，跳转首页
+      if (!hasOpenedTabs.value) {
+        if (path !== homePath.value) {
+          current.value = {}
+          safeRouterPush({ path: homePath.value })
+        }
+        return
+      }
+
+      // 如果关闭的是当前激活标签，需要激活其他标签
+      if (current.value.path === path) {
+        const newIndex = targetIndex >= opened.value.length ? opened.value.length - 1 : targetIndex
+        current.value = opened.value[newIndex]
+        safeRouterPush(current.value)
+      }
+    }
+
+    /**
+     * 关闭左侧选项卡
+     */
+    const removeLeft = (path: string): void => {
+      const targetIndex = findTabIndex(path)
+
+      if (targetIndex === -1) {
+        console.warn(`尝试关闭左侧标签页，但目标标签页不存在: ${path}`)
+        return
+      }
+
+      // 获取左侧可关闭的标签页
+      const leftTabs = opened.value.slice(0, targetIndex)
+      const closableLeftTabs = leftTabs.filter(isTabClosable)
+
+      if (closableLeftTabs.length === 0) {
+        console.warn('左侧没有可关闭的标签页')
+        return
+      }
+
+      // 标记为缓存排除
+      markTabsToRemove(closableLeftTabs)
+
+      // 移除左侧可关闭的标签页
+      opened.value = opened.value.filter(
+        (tab, index) => index >= targetIndex || !isTabClosable(tab)
+      )
+
+      // 确保当前标签是激活状态
+      const targetTab = getTab(path)
+      if (targetTab) {
+        current.value = targetTab
+      }
+    }
+
+    /**
+     * 关闭右侧选项卡
+     */
+    const removeRight = (path: string): void => {
+      const targetIndex = findTabIndex(path)
+
+      if (targetIndex === -1) {
+        console.warn(`尝试关闭右侧标签页，但目标标签页不存在: ${path}`)
+        return
+      }
+
+      // 获取右侧可关闭的标签页
+      const rightTabs = opened.value.slice(targetIndex + 1)
+      const closableRightTabs = rightTabs.filter(isTabClosable)
+
+      if (closableRightTabs.length === 0) {
+        console.warn('右侧没有可关闭的标签页')
+        return
+      }
+
+      // 标记为缓存排除
+      markTabsToRemove(closableRightTabs)
+
+      // 移除右侧可关闭的标签页
+      opened.value = opened.value.filter(
+        (tab, index) => index <= targetIndex || !isTabClosable(tab)
+      )
+
+      // 确保当前标签是激活状态
+      const targetTab = getTab(path)
+      if (targetTab) {
+        current.value = targetTab
+      }
+    }
+
+    /**
+     * 关闭其他选项卡
+     */
+    const removeOthers = (path: string): void => {
+      const targetTab = getTab(path)
+
+      if (!targetTab) {
+        console.warn(`尝试关闭其他标签页，但目标标签页不存在: ${path}`)
+        return
+      }
+
+      // 获取其他可关闭的标签页
+      const otherTabs = opened.value.filter((tab) => tab.path !== path)
+      const closableTabs = otherTabs.filter(isTabClosable)
+
+      if (closableTabs.length === 0) {
+        console.warn('没有其他可关闭的标签页')
+        return
+      }
+
+      // 标记为缓存排除
+      markTabsToRemove(closableTabs)
+
+      // 只保留当前标签和固定标签
+      opened.value = opened.value.filter((tab) => tab.path === path || !isTabClosable(tab))
+
+      // 确保当前标签是激活状态
+      current.value = targetTab
+    }
+
+    /**
+     * 关闭所有可关闭的标签页
+     */
+    const removeAll = (): void => {
+      const { homePath } = useCommon()
+      const hasFixedTabs = opened.value.some((tab) => tab.fixedTab)
+
+      // 获取可关闭的标签页
+      const closableTabs = opened.value.filter((tab) => {
+        if (!isTabClosable(tab)) return false
+        // 如果有固定标签，则所有可关闭的都可以关闭；否则保留首页
+        return hasFixedTabs || tab.path !== homePath.value
+      })
+
+      if (closableTabs.length === 0) {
+        console.warn('没有可关闭的标签页')
+        return
+      }
+
+      // 标记为缓存排除
+      markTabsToRemove(closableTabs)
+
+      // 保留不可关闭的标签页和首页（当没有固定标签时）
+      opened.value = opened.value.filter((tab) => {
+        return !isTabClosable(tab) || (!hasFixedTabs && tab.path === homePath.value)
+      })
+
+      // 处理激活状态
+      if (!hasOpenedTabs.value) {
+        current.value = {}
+        safeRouterPush({ path: homePath.value })
+        return
+      }
+
+      // 选择激活的标签页：优先首页，其次第一个可用标签
+      const homeTab = opened.value.find((tab) => tab.path === homePath.value)
+      const targetTab = homeTab || opened.value[0]
+
+      current.value = targetTab
+      safeRouterPush(targetTab)
+    }
+
+    /**
+     * 将指定选项卡添加到 keepAlive 排除列表中
+     */
+    const addKeepAliveExclude = (tab: WorkTab): void => {
+      if (!tab.keepAlive || !tab.name) return
+
+      if (!keepAliveExclude.value.includes(tab.name)) {
+        keepAliveExclude.value.push(tab.name)
+      }
+    }
+
+    /**
+     * 从 keepAlive 排除列表中移除指定组件名称
+     */
+    const removeKeepAliveExclude = (name: string): void => {
+      if (!name) return
+
+      keepAliveExclude.value = keepAliveExclude.value.filter((item) => item !== name)
+    }
+
+    /**
+     * 将传入的一组选项卡的组件名称标记为排除缓存
+     */
+    const markTabsToRemove = (tabs: WorkTab[]): void => {
+      tabs.forEach((tab) => {
+        if (tab.name) {
+          addKeepAliveExclude(tab)
+        }
+      })
+    }
+
+    /**
+     * 切换指定标签页的固定状态
+     */
+    const toggleFixedTab = (path: string): void => {
+      const targetIndex = findTabIndex(path)
+
+      if (targetIndex === -1) {
+        console.warn(`尝试切换不存在标签页的固定状态: ${path}`)
+        return
+      }
+
+      const tab = { ...opened.value[targetIndex] }
+      tab.fixedTab = !tab.fixedTab
+
+      // 移除原位置
+      opened.value.splice(targetIndex, 1)
+
+      if (tab.fixedTab) {
+        // 固定标签插入到所有固定标签的末尾
+        const firstNonFixedIndex = opened.value.findIndex((t) => !t.fixedTab)
+        const insertIndex = firstNonFixedIndex === -1 ? opened.value.length : firstNonFixedIndex
+        opened.value.splice(insertIndex, 0, tab)
+      } else {
+        // 非固定标签插入到所有固定标签后
+        const fixedCount = opened.value.filter((t) => t.fixedTab).length
+        opened.value.splice(fixedCount, 0, tab)
+      }
+
+      // 更新当前标签引用
+      if (current.value.path === path) {
+        current.value = tab
+      }
+    }
+
+    /**
+     * 验证工作台标签页的路由有效性
+     */
+    const validateWorktabs = (routerInstance: Router): void => {
+      try {
+        // 动态路由校验：优先使用路由 name 判断有效性；否则用 resolve 匹配参数化路径
+        const isTabRouteValid = (tab: Partial<WorkTab>): boolean => {
+          try {
+            if (tab.name) {
+              const routes = routerInstance.getRoutes()
+              if (routes.some((r) => r.name === tab.name)) return true
+            }
+            if (tab.path) {
+              const resolved = routerInstance.resolve({
+                path: tab.path,
+                query: (tab.query as LocationQueryRaw) || undefined
+              })
+              return resolved.matched.length > 0
+            }
+            return false
+          } catch {
+            return false
+          }
+        }
+
+        // 过滤出有效的标签页
+        const validTabs = opened.value.filter((tab) => isTabRouteValid(tab))
+
+        if (validTabs.length !== opened.value.length) {
+          console.warn('发现无效的标签页路由，已自动清理')
+          opened.value = validTabs
+        }
+
+        // 验证当前激活标签的有效性
+        const isCurrentValid = current.value && isTabRouteValid(current.value)
+
+        if (!isCurrentValid && validTabs.length > 0) {
+          console.warn('当前激活标签无效，已自动切换')
+          current.value = validTabs[0]
+        } else if (!isCurrentValid) {
+          current.value = {}
+        }
+      } catch (error) {
+        console.error('验证工作台标签页失败:', error)
+      }
+    }
+
+    /**
+     * 清空所有状态（用于登出等场景）
+     */
+    const clearAll = (): void => {
+      current.value = {}
+      opened.value = []
+      keepAliveExclude.value = []
+    }
+
+    /**
+     * 获取状态快照（用于持久化存储）
+     */
+    const getStateSnapshot = (): WorktabState => {
+      return {
+        current: { ...current.value },
+        opened: [...opened.value],
+        keepAliveExclude: [...keepAliveExclude.value]
+      }
+    }
+
+    /**
+     * 获取标签页标题
+     */
+    const getTabTitle = (path: string): WorkTab | undefined => {
+      const tab = getTab(path)
+      return tab
+    }
+
+    /**
+     * 更新标签页标题
+     */
+    const updateTabTitle = (path: string, title: string): void => {
+      const tab = getTab(path)
+      if (tab) {
+        tab.customTitle = title
+      }
+    }
+
+    /**
+     * 重置标签页标题
+     */
+    const resetTabTitle = (path: string): void => {
+      const tab = getTab(path)
+      if (tab) {
+        tab.customTitle = ''
+      }
+    }
+
+    return {
+      // 状态
+      current,
+      opened,
+      keepAliveExclude,
+
+      // 计算属性
+      hasOpenedTabs,
+      hasMultipleTabs,
+      currentTabIndex,
+
+      // 方法
+      openTab,
+      removeTab,
+      removeLeft,
+      removeRight,
+      removeOthers,
+      removeAll,
+      toggleFixedTab,
+      validateWorktabs,
+      clearAll,
+      getStateSnapshot,
+
+      // 工具方法
+      findTabIndex,
+      getTab,
+      isTabClosable,
+      addKeepAliveExclude,
+      removeKeepAliveExclude,
+      markTabsToRemove,
+      getTabTitle,
+      updateTabTitle,
+      resetTabTitle
+    }
+  },
+  {
+    persist: {
+      key: 'worktab',
+      storage: localStorage
+    }
+  }
+)
diff --git a/web/src/types/api/api.d.ts b/web/src/types/api/api.d.ts
new file mode 100644
index 0000000..63df300
--- /dev/null
+++ b/web/src/types/api/api.d.ts
@@ -0,0 +1,217 @@
+/**
+ * API 接口类型定义模块
+ *
+ * 提供所有后端接口的类型定义
+ *
+ * ## 主要功能
+ *
+ * - 通用类型（分页参数、响应结构等）
+ * - 认证类型（登录、用户信息等）
+ * - 系统管理类型（用户、角色等）
+ * - 全局命名空间声明
+ *
+ * ## 使用场景
+ *
+ * - API 请求参数类型约束
+ * - API 响应数据类型定义
+ * - 接口文档类型同步
+ *
+ * ## 注意事项
+ *
+ * - 在 .vue 文件使用需要在 eslint.config.mjs 中配置 globals: { Api: 'readonly' }
+ * - 使用全局命名空间，无需导入即可使用
+ *
+ * ## 使用方式
+ *
+ * ```typescript
+ * const params: Api.Auth.LoginParams = { userName: 'admin', password: '123456' }
+ * const response: Api.Auth.UserInfo = await fetchUserInfo()
+ * ```
+ *
+ * @module types/api/api
+ * @author Art Design Pro Team
+ */
+
+declare namespace Api {
+  /** 通用类型 */
+  namespace Common {
+    /** 分页参数 */
+    interface PaginationParams {
+      /** 当前页码 */
+      current: number
+      /** 每页条数 */
+      size: number
+      /** 总条数 */
+      total: number
+    }
+
+    /** 通用搜索参数 */
+    type CommonSearchParams = Pick<PaginationParams, 'current' | 'size'>
+
+    /** 分页响应基础结构 */
+    interface PaginatedResponse<T = any> {
+      records: T[]
+      current: number
+      size: number
+      total: number
+    }
+
+    /** 启用状态 */
+    type EnableStatus = '1' | '2'
+  }
+
+  /** 认证类型 */
+  namespace Auth {
+    /** 登录参数 */
+    interface LoginParams {
+      userName: string
+      password: string
+    }
+
+    /** 登录响应 */
+    interface LoginResponse {
+      token: string
+      user?: UserInfo
+    }
+
+    interface RefreshResponse {
+      token: string
+    }
+
+    interface RegisterParams {
+      userName: string
+      email: string
+      password: string
+    }
+
+    /** 用户信息 */
+    interface UserInfo {
+      buttons: string[]
+      roles: string[]
+      userId: string
+      userName: string
+      email: string
+      avatar?: string
+    }
+  }
+
+  namespace Commory {
+    interface ImportSummary {
+      id: string
+      user_id: string
+      schema_version: string
+      imported_at: string
+      source_path: string
+      event_count: number
+      identity_count: number
+    }
+
+    interface TimelineItem {
+      event_id: string
+      type: string
+      timestamp: string
+      direction: string
+      content_summary: string
+      participants: string[]
+      meta?: Record<string, any>
+      schema_version: string
+    }
+
+    interface Identity {
+      id: string
+      type: string
+      display_name: string
+      phones: string[]
+      emails: string[]
+      avatar?: string | null
+      labels: string[]
+      meta: Record<string, any>
+    }
+
+    interface DashboardSummary {
+      importCount: number
+      identityCount: number
+      eventCount: number
+      lastActivity: string
+      recentImports: ImportSummary[]
+      recentEvents: TimelineItem[]
+    }
+
+    interface SearchParams {
+      q?: string
+      contact?: string
+      type?: string
+      participant?: string
+      from?: string
+      to?: string
+      limit?: number
+      offset?: number
+    }
+  }
+
+  namespace Setup {
+    interface SetupStatus {
+      status: boolean
+      database_type: string
+      root_init: boolean
+    }
+
+    interface SetupRequest {
+      userName: string
+      password: string
+      confirmPassword: string
+      usageMode: string
+    }
+  }
+
+  /** 系统管理类型 */
+  namespace SystemManage {
+    /** 用户列表 */
+    type UserList = Api.Common.PaginatedResponse<UserListItem>
+
+    /** 用户列表项 */
+    interface UserListItem {
+      id: number
+      avatar: string
+      status: string
+      userName: string
+      userGender: string
+      nickName: string
+      userPhone: string
+      userEmail: string
+      userRoles: string[]
+      createBy: string
+      createTime: string
+      updateBy: string
+      updateTime: string
+    }
+
+    /** 用户搜索参数 */
+    type UserSearchParams = Partial<
+      Pick<UserListItem, 'id' | 'userName' | 'userGender' | 'userPhone' | 'userEmail' | 'status'> &
+        Api.Common.CommonSearchParams
+    >
+
+    /** 角色列表 */
+    type RoleList = Api.Common.PaginatedResponse<RoleListItem>
+
+    /** 角色列表项 */
+    interface RoleListItem {
+      roleId: number
+      roleName: string
+      roleCode: string
+      description: string
+      enabled: boolean
+      createTime: string
+    }
+
+    /** 角色搜索参数 */
+    type RoleSearchParams = Partial<
+      Pick<RoleListItem, 'roleId' | 'roleName' | 'roleCode' | 'description' | 'enabled'> &
+        Api.Common.CommonSearchParams & {
+          startTime: string | null
+          endTime: string | null
+        }
+    >
+  }
+}
diff --git a/web/src/types/common/index.ts b/web/src/types/common/index.ts
new file mode 100644
index 0000000..7e751d1
--- /dev/null
+++ b/web/src/types/common/index.ts
@@ -0,0 +1,95 @@
+/**
+ * 通用类型定义模块
+ *
+ * 提供项目中常用的通用类型定义
+ *
+ * ## 主要功能
+ *
+ * - 状态类型（启用/禁用）
+ * - 性别类型
+ * - 排序方向类型
+ * - 操作类型（增删改查）
+ * - 记录类型（键值对）
+ * - 时间范围类型
+ * - 文件信息类型
+ * - 坐标和尺寸类型
+ * - 响应式断点类型
+ * - 主题和语言类型
+ * - 环境和弹窗类型
+ *
+ * ## 使用场景
+ *
+ * - 通用数据结构定义
+ * - 类型约束和提示
+ * - 减少重复类型定义
+ *
+ * @module types/common/index
+ * @author Art Design Pro Team
+ */
+
+// 导出响应类型
+export * from './response'
+
+// 状态类型
+export type Status = 0 | 1 // 0: 禁用, 1: 启用
+
+// 性别类型
+export type Gender = 'male' | 'female' | 'unknown'
+
+// 排序方向
+export type SortOrder = 'ascending' | 'descending'
+
+// 操作类型
+export type ActionType = 'create' | 'update' | 'delete' | 'view'
+
+// 可选的记录类型
+export type Recordable<T = any> = Record<string, T>
+
+// 键值对类型
+export type KeyValue<T = any> = {
+  key: string
+  value: T
+  label?: string
+}
+
+// 时间范围类型
+export interface TimeRange {
+  startTime: string
+  endTime: string
+}
+
+// 文件类型
+export interface FileInfo {
+  name: string
+  url: string
+  size: number
+  type: string
+  lastModified?: number
+}
+
+// 坐标类型
+export interface Position {
+  x: number
+  y: number
+}
+
+// 尺寸类型
+export interface Size {
+  width: number
+  height: number
+}
+
+// 响应式断点类型
+export type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl'
+
+// 主题类型
+export type ThemeMode = 'light' | 'dark' | 'auto'
+
+// 语言类型
+export type Language = 'zh-CN' | 'en-US'
+
+// 环境类型
+export type Environment = 'development' | 'production' | 'test'
+
+// 弹窗类型
+export type DialogType = 'add' | 'edit'
diff --git a/web/src/types/common/response.ts b/web/src/types/common/response.ts
new file mode 100644
index 0000000..4a5fdab
--- /dev/null
+++ b/web/src/types/common/response.ts
@@ -0,0 +1,30 @@
+/**
+ * API 响应类型定义模块
+ *
+ * 提供统一的 API 响应结构类型定义
+ *
+ * ## 主要功能
+ *
+ * - 基础响应结构定义
+ * - 泛型支持（适配不同数据类型）
+ * - 统一的响应格式约束
+ *
+ * ## 使用场景
+ *
+ * - API 请求响应类型约束
+ * - 接口数据类型定义
+ * - 响应数据解析
+ *
+ * @module types/common/response
+ * @author Art Design Pro Team
+ */
+
+/** 基础 API 响应结构 */
+export interface BaseResponse<T = unknown> {
+  /** 状态码 */
+  code: number
+  /** 消息 */
+  msg: string
+  /** 数据 */
+  data: T
+}
diff --git a/web/src/types/component/chart.ts b/web/src/types/component/chart.ts
new file mode 100644
index 0000000..c3225c9
--- /dev/null
+++ b/web/src/types/component/chart.ts
@@ -0,0 +1,324 @@
+/**
+ * 图表组件类型定义模块
+ *
+ * 提供 ECharts 图表组件的完整类型定义
+ *
+ * ## 主要功能
+ *
+ * - 基础图表配置类型
+ * - 柱状图类型定义
+ * - 折线图类型定义
+ * - 饼图/环形图类型定义
+ * - 雷达图类型定义
+ * - K线图类型定义
+ * - 散点图类型定义
+ * - 地图图表类型定义
+ * - 双向堆叠柱状图类型定义
+ * - 图表主题配置类型
+ * - 图表事件回调类型
+ *
+ * ## 使用场景
+ *
+ * - 图表组件 Props 类型约束
+ * - 图表配置类型定义
+ * - 图表数据结构定义
+ * - 图表事件处理
+ *
+ * @module types/component/chart
+ * @author Art Design Pro Team
+ */
+import type { EChartsOption } from '@/plugins/echarts'
+
+// 图例位置类型
+export type LegendPosition = 'bottom' | 'top' | 'left' | 'right'
+
+export type SymbolType =
+  | 'circle'
+  | 'rect'
+  | 'roundRect'
+  | 'triangle'
+  | 'diamond'
+  | 'pin'
+  | 'arrow'
+  | 'none'
+
+// 图表主题配置
+export interface ChartThemeConfig {
+  /** 图表高度 */
+  chartHeight: string
+  /** 字体大小 */
+  fontSize: number
+  /** 字体颜色 */
+  fontColor: string
+  /** 主题颜色 */
+  themeColor: string
+  /** 颜色组 */
+  colors: string[]
+}
+
+// 图表初始化选项
+export interface UseChartOptions {
+  /** 初始化选项 */
+  initOptions?: EChartsOption
+  /** 延迟初始化时间(ms) */
+  initDelay?: number
+  /** IntersectionObserver阈值 */
+  threshold?: number
+  /** 是否自动响应主题变化 */
+  autoTheme?: boolean
+}
+
+// 基础图表 Props 接口 - 统一所有图表的基础属性
+export interface BaseChartProps {
+  /** 图表高度 */
+  height?: string
+  /** 是否加载中 */
+  loading?: boolean
+  isEmpty?: boolean
+  /** 颜色配置 */
+  colors?: string[]
+}
+
+// 轴线显示控制接口 - 统一轴线相关配置
+export interface AxisDisplayProps {
+  /** 是否显示坐标轴标签 */
+  showAxisLabel?: boolean
+  /** 是否显示坐标轴线 */
+  showAxisLine?: boolean
+  /** 是否显示分割线 */
+  showSplitLine?: boolean
+}
+
+// 交互显示控制接口 - 统一交互相关配置
+export interface InteractionProps {
+  /** 是否显示提示框 */
+  showTooltip?: boolean
+  /** 是否显示图例 */
+  showLegend?: boolean
+  /** 图例位置 */
+  legendPosition?: LegendPosition
+}
+
+// 柱状图数据项接口
+export interface BarDataItem {
+  /** 系列名称 */
+  name: string
+  /** 数据值 */
+  data: number[]
+  /** 柱状图宽度 */
+  barWidth?: string | number
+  /** 堆叠分组名称 */
+  stack?: string
+}
+
+// 柱状图 Props 接口 - 统一柱状图配置
+export interface BarChartProps extends BaseChartProps, AxisDisplayProps, InteractionProps {
+  /** 图表数据 - 支持单组数据或多组数据 */
+  data: number[] | BarDataItem[]
+  /** X轴标签数据 */
+  xAxisData?: string[]
+  /** 柱状图宽度 */
+  barWidth?: string | number
+  /** 是否堆叠显示 */
+  stack?: boolean
+  /** 圆角 */
+  borderRadius?: number | number[]
+}
+
+// 折线图数据项接口
+export interface LineDataItem {
+  /** 系列名称 */
+  name: string
+  /** 数据值 */
+  data: number[]
+  /** 线条宽度 */
+  lineWidth?: number
+  /** 是否显示区域填充 */
+  showAreaColor?: boolean
+  /** 区域样式配置 */
+  areaStyle?: {
+    /** 渐变开始透明度 */
+    startOpacity?: number
+    /** 渐变结束透明度 */
+    endOpacity?: number
+    /** 自定义 ECharts areaStyle 配置 */
+    custom?: any
+  }
+  /** 是否平滑曲线 */
+  smooth?: boolean
+  /** 数据点符号 */
+  symbol?: SymbolType
+  /** 数据点大小 */
+  symbolSize?: number
+}
+
+// 折线图 Props 接口 - 统一折线图配置
+export interface LineChartProps extends BaseChartProps, AxisDisplayProps, InteractionProps {
+  /** 图表数据 - 支持单组数据或多组数据 */
+  data: number[] | LineDataItem[]
+  /** X轴标签数据 */
+  xAxisData?: string[]
+  /** 线条宽度 */
+  lineWidth?: number
+  /** 是否显示区域填充 */
+  showAreaColor?: boolean
+  /** 是否平滑曲线 */
+  smooth?: boolean
+  /** 数据点符号 */
+  symbol?: SymbolType
+  /** 数据点大小 */
+  symbolSize?: number
+  /** 多数据动画延迟间隔（毫秒） */
+  animationDelay?: number
+}
+
+// 雷达图数据项接口
+export interface RadarDataItem {
+  /** 系列名称 */
+  name: string
+  /** 数据值 */
+  value: number[]
+}
+
+// 雷达图 Props 接口 - 统一雷达图配置
+export interface RadarChartProps extends BaseChartProps, InteractionProps {
+  /** 雷达图指标配置 */
+  indicator?: Array<{ name: string; max: number }>
+  /** 图表数据 */
+  data?: RadarDataItem[]
+}
+
+// 饼图/环形图数据项接口
+export interface PieDataItem {
+  /** 数据值 */
+  value: number
+  /** 数据名称 */
+  name: string
+}
+
+// 环形图 Props 接口 - 统一环形图配置
+export interface RingChartProps extends BaseChartProps, InteractionProps {
+  /** 图表数据 */
+  data: PieDataItem[]
+  /** 内外半径 */
+  radius?: string[]
+  /** 边框圆角 */
+  borderRadius?: number
+  /** 中心文本 */
+  centerText?: string
+  /** 是否显示标签 */
+  showLabel?: boolean
+}
+
+// K线图数据项接口
+export interface KLineDataItem {
+  /** 时间标签 */
+  time: string
+  /** 开盘价 */
+  open: number
+  /** 收盘价 */
+  close: number
+  /** 最高价 */
+  high: number
+  /** 最低价 */
+  low: number
+}
+
+// K线图 Props 接口 - 统一K线图配置
+export interface KLineChartProps extends BaseChartProps {
+  /** 图表数据 */
+  data?: KLineDataItem[]
+  /** 是否显示数据缩放控件 */
+  showDataZoom?: boolean
+  /** 数据缩放初始开始位置 */
+  dataZoomStart?: number
+  /** 数据缩放初始结束位置 */
+  dataZoomEnd?: number
+}
+
+// 散点图数据项接口
+export interface ScatterDataItem {
+  /** 坐标值 [x, y] */
+  value: number[]
+}
+
+// 散点图 Props 接口 - 统一散点图配置
+export interface ScatterChartProps extends BaseChartProps, AxisDisplayProps, InteractionProps {
+  /** 图表数据 */
+  data?: ScatterDataItem[]
+  /** 散点大小 */
+  symbolSize?: number
+}
+
+// 双柱对比图 Props 接口 - 统一双柱对比图配置
+export interface DualBarCompareChartProps extends BaseChartProps {
+  /** 上方数据 */
+  topData: number[]
+  /** 下方数据 */
+  bottomData: number[]
+  /** X轴标签数据 */
+  xAxisData: string[]
+  /** 上方柱子颜色 */
+  topColor?: string
+  /** 下方柱子颜色 */
+  bottomColor?: string
+  /** 柱状图宽度 */
+  barWidth?: number
+}
+
+// 地图图表 Props 接口 - 统一地图图表配置
+export interface MapChartProps extends BaseChartProps {
+  /** 地图数据 */
+  mapData?: any[]
+  /** 选中区域 */
+  selectedRegion?: string
+  /** 是否显示标签 */
+  showLabels?: boolean
+  /** 是否显示散点 */
+  showScatter?: boolean
+}
+
+// 双向堆叠柱状图 Props 接口（人口金字塔样式）
+export interface BidirectionalBarChartProps
+  extends BaseChartProps,
+    AxisDisplayProps,
+    InteractionProps {
+  /** 正向数据（向上显示） */
+  positiveData: number[]
+  /** 负向数据（向下显示） */
+  negativeData: number[]
+  /** X轴标签数据 */
+  xAxisData?: string[]
+  /** 正向数据名称 */
+  positiveName?: string
+  /** 负向数据名称 */
+  negativeName?: string
+  /** 柱状图宽度 */
+  barWidth?: string | number
+  /** Y轴最小值 */
+  yAxisMin?: number
+  /** Y轴最大值 */
+  yAxisMax?: number
+  /** 是否显示数据标签 */
+  showDataLabel?: boolean
+  /** 正向数据圆角配置 */
+  positiveBorderRadius?: number | number[]
+  /** 负向数据圆角配置 */
+  negativeBorderRadius?: number | number[]
+}
+
+// 图表配置生成器函数类型
+export type ChartOptionGenerator = () => EChartsOption
+
+// 图表事件回调类型
+export type ChartEventCallback = (params: any) => void
+
+// 图表错误信息接口
+export interface ChartError {
+  /** 错误码 */
+  code: string
+  /** 错误信息 */
+  message: string
+  /** 错误详情 */
+  details?: any
+}
diff --git a/web/src/types/component/index.ts b/web/src/types/component/index.ts
new file mode 100644
index 0000000..b9e90c6
--- /dev/null
+++ b/web/src/types/component/index.ts
@@ -0,0 +1,145 @@
+/**
+ * 组件类型定义模块
+ *
+ * 提供项目组件的类型定义
+ *
+ * ## 主要功能
+ *
+ * - 搜索组件类型定义
+ * - 表格列配置类型
+ * - 分页配置类型
+ * - 表单规则类型
+ * - 对话框配置类型
+ *
+ * ## 使用场景
+ *
+ * - 组件 Props 类型约束
+ * - 组件配置类型定义
+ * - 组件事件参数类型
+ *
+ * @module types/component/index
+ * @author Art Design Pro Team
+ */
+
+// 搜索组件类型
+export type SearchComponentType =
+  | 'input'
+  | 'select'
+  | 'radio'
+  | 'checkbox'
+  | 'date'
+  | 'datetime'
+  | 'daterange'
+  | 'datetimerange'
+  | 'month'
+  | 'monthrange'
+  | 'year'
+  | 'yearrange'
+  | 'week'
+  | 'time'
+  | 'timerange'
+
+// 搜索框值变化参数
+export interface SearchChangeParams {
+  prop: string
+  val: unknown
+}
+
+// 表格列配置接口
+export interface ColumnOption<T = any> {
+  // 列类型
+  type?: 'selection' | 'expand' | 'index' | 'globalIndex'
+  // 列属性名
+  prop?: string
+  // 列标题
+  label?: string
+  // 列宽度
+  width?: string | number
+  // 最小列宽度
+  minWidth?: string | number
+  // 固定列
+  fixed?: boolean | 'left' | 'right'
+  // 是否可排序
+  sortable?: boolean | 'custom'
+  // 过滤器选项
+  filters?: any[]
+  // 过滤方法
+  filterMethod?: (value: any, row: any) => boolean
+  // 过滤器位置
+  filterPlacement?: string
+  // 是否禁用
+  disabled?: boolean
+  // 是否显示列
+  visible?: boolean
+  // 是否选中显示
+  checked?: boolean
+  // 自定义渲染函数
+  formatter?: (row: T) => any
+  // 插槽相关配置
+  // 是否使用插槽渲染内容
+  useSlot?: boolean
+  // 插槽名称（默认为 prop 值）
+  slotName?: string
+  // 是否使用表头插槽
+  useHeaderSlot?: boolean
+  // 表头插槽名称（默认为 `${prop}-header`）
+  headerSlotName?: string
+  // 其他属性
+  [key: string]: any
+}
+
+// 分页配置
+export interface PaginationConfig {
+  // 当前页
+  currentPage: number
+  // 每页条数
+  pageSize: number
+  // 总条数
+  total: number
+  // 每页显示个数选择器的选项
+  pageSizes?: number[]
+  // 组件布局
+  layout?: string
+  // 是否为小型分页
+  small?: boolean
+}
+
+// 表单规则
+export interface FormRule {
+  // 是否必填
+  required?: boolean
+  // 错误提示信息
+  message?: string
+  // 触发方式
+  trigger?: string | string[]
+  // 最小长度
+  min?: number
+  // 最大长度
+  max?: number
+  // 正则表达式
+  pattern?: RegExp
+  // 自定义验证函数
+  validator?: (rule: any, value: any, callback: any) => void
+}
+
+// 对话框配置
+export interface DialogConfig {
+  // 标题
+  title: string
+  // 是否显示
+  visible: boolean
+  // 宽度
+  width?: string | number
+  // 是否可以通过点击 modal 关闭
+  closeOnClickModal?: boolean
+  // 是否可以通过按下 ESC 关闭
+  closeOnPressEscape?: boolean
+  // 是否显示关闭按钮
+  showClose?: boolean
+  // 是否在 Dialog 出现时将 body 滚动锁定
+  lockScroll?: boolean
+  // 是否显示遮罩层
+  modal?: boolean
+  // 自定义类名
+  customClass?: string
+}
diff --git a/web/src/types/config/index.ts b/web/src/types/config/index.ts
new file mode 100644
index 0000000..dd144de
--- /dev/null
+++ b/web/src/types/config/index.ts
@@ -0,0 +1,211 @@
+/**
+ * 配置类型定义模块
+ *
+ * 提供系统配置相关的类型定义
+ *
+ * ## 主要功能
+ *
+ * - 主题设置类型
+ * - 菜单布局类型
+ * - 节日配置类型
+ * - 系统基础配置类型
+ * - 快速入口配置类型
+ * - 顶部栏功能配置类型
+ * - 环境配置类型
+ * - 应用配置类型
+ *
+ * ## 使用场景
+ *
+ * - 系统配置文件类型约束
+ * - 配置项类型定义
+ * - 配置数据验证
+ *
+ * @module types/config/index
+ * @author Art Design Pro Team
+ */
+
+import { MenuTypeEnum, SystemThemeEnum } from '@/enums/appEnum'
+import { MenuThemeType, SystemThemeTypes } from '@/types/store'
+
+// 主题设置
+export interface ThemeSetting {
+  /** 主题名称 */
+  name: string
+  /** 系统主题类型 */
+  theme: SystemThemeEnum
+  /** 主题颜色数组 */
+  color: string[]
+  /** 左侧线条颜色 */
+  leftLineColor: string
+  /** 右侧线条颜色 */
+  rightLineColor: string
+  /** 主题图片 */
+  img: string
+}
+
+// 菜单布局
+export interface MenuLayout {
+  /** 布局名称 */
+  name: string
+  /** 菜单类型值 */
+  value: MenuTypeEnum
+  /** 布局预览图 */
+  img: string
+  /** 布局描述 */
+  description?: string
+}
+
+// 节日配置
+export interface FestivalConfig {
+  /** 节日日期（单日）或开始日期（日期范围） */
+  date: string
+  /** 节日结束日期（可选，用于跨日期节日） */
+  endDate?: string
+  /** 节日名称 */
+  name: string
+  /** 烟花图片 */
+  image: string
+  /** 滚动文本 */
+  scrollText: string
+  /** 是否激活 */
+  isActive?: boolean
+  /** 烟花播放次数（可选，默认为 3 次） */
+  count?: number
+}
+
+// 系统基础配置
+export interface SystemBasicConfig {
+  // 系统名称
+  name: string
+  // 系统描述
+  description?: string
+  // 系统logo
+  logo?: string
+  // 系统favicon
+  favicon?: string
+  // 版权信息
+  copyright?: string
+}
+
+// 快速入口基础项
+export interface FastEnterBaseItem {
+  /** 名称 */
+  name: string
+  /** 是否启用 */
+  enabled?: boolean
+  /** 排序权重 */
+  order?: number
+  /** 路由名称 */
+  routeName?: string
+  /** 外部链接 */
+  link?: string
+}
+
+// 快速入口应用项
+export interface FastEnterApplication extends FastEnterBaseItem {
+  /** 应用描述 */
+  description: string
+  /** 图标代码 */
+  icon: string
+  /** 图标颜色 */
+  iconColor: string
+}
+
+// 快速链接项
+export type FastEnterQuickLink = FastEnterBaseItem
+
+// 快速入口配置
+export interface FastEnterConfig {
+  /** 应用列表 */
+  applications: FastEnterApplication[]
+  /** 快速链接 */
+  quickLinks: FastEnterQuickLink[]
+  /** 显示条件（屏幕宽度） */
+  minWidth?: number
+}
+
+// 系统配置
+export interface SystemConfig {
+  // 系统基础信息
+  systemInfo: SystemBasicConfig
+  // 系统主题样式
+  systemThemeStyles: SystemThemeTypes
+  // 设置主题列表
+  settingThemeList: ThemeSetting[]
+  // 菜单布局列表
+  menuLayoutList: MenuLayout[]
+  // 主题列表
+  themeList: MenuThemeType[]
+  // 暗色菜单样式
+  darkMenuStyles: MenuThemeType[]
+  // 系统主色调
+  systemMainColor: readonly string[]
+  // 快速入口配置
+  fastEnter?: FastEnterConfig
+  // 顶部栏功能配置
+  headerBar?: HeaderBarFeatureConfig
+}
+
+// 环境配置
+export interface EnvConfig {
+  // 环境名称
+  NODE_ENV: string
+  // 应用版本
+  VITE_VERSION: string
+  // 应用端口
+  VITE_PORT: string
+  // 应用基础路径
+  VITE_BASE_URL: string
+  // API 地址
+  VITE_API_URL: string
+  // 是否开启 Mock
+  VITE_USE_MOCK?: string
+  // 是否开启压缩
+  VITE_USE_GZIP?: string
+  // 是否开启 CDN
+  VITE_USE_CDN?: string
+}
+
+// 应用配置
+export interface AppConfig extends SystemConfig {
+  // 环境配置
+  env: EnvConfig
+  // 开发模式
+  isDev: boolean
+  // 生产模式
+  isProd: boolean
+  // 测试模式
+  isTest: boolean
+}
+
+// 功能配置项基础接口
+export interface FeatureConfigItem {
+  enabled: boolean
+  description: string
+}
+
+// 顶部栏功能配置接口
+export interface HeaderBarFeatureConfig {
+  /** 菜单按钮 */
+  menuButton: FeatureConfigItem
+  /** 刷新按钮 */
+  refreshButton: FeatureConfigItem
+  /** 快速入口 */
+  fastEnter: FeatureConfigItem
+  /** 面包屑导航 */
+  breadcrumb: FeatureConfigItem
+  /** 全局搜索 */
+  globalSearch: FeatureConfigItem
+  /** 全屏功能 */
+  fullscreen: FeatureConfigItem
+  /** 通知功能 */
+  notification: FeatureConfigItem
+  /** 聊天功能 */
+  chat: FeatureConfigItem
+  /** 多语言切换 */
+  language: FeatureConfigItem
+  /** 设置面板 */
+  settings: FeatureConfigItem
+  /** 主题切换 */
+  themeToggle: FeatureConfigItem
+}
diff --git a/web/src/types/directive/directive.d.ts b/web/src/types/directive/directive.d.ts
new file mode 100644
index 0000000..eb0154e
--- /dev/null
+++ b/web/src/types/directive/directive.d.ts
@@ -0,0 +1,15 @@
+import type {
+  AuthDirective,
+  RolesDirective,
+  RippleDirective,
+  HighlightDirective
+} from '@/directives'
+
+declare module 'vue' {
+  export interface GlobalDirectives {
+    vAuth: AuthDirective
+    vRoles: RolesDirective
+    vRipple: RippleDirective
+    vHighlight: HighlightDirective
+  }
+}
diff --git a/web/src/types/index.ts b/web/src/types/index.ts
new file mode 100644
index 0000000..9032fd2
--- /dev/null
+++ b/web/src/types/index.ts
@@ -0,0 +1,22 @@
+/**
+ * 类型定义统一导出模块
+ * 提供全局类型定义的统一导出入口
+ *
+ * @module types/index
+ * @author Art Design Pro Team
+ */
+
+/** 通用类型定义（基础类型、工具类型等） */
+export * from './common'
+
+/** 组件相关类型定义 */
+export * from './component'
+
+/** 状态管理相关类型定义 */
+export * from './store'
+
+/** 路由相关类型定义 */
+export * from './router'
+
+/** 配置相关类型定义 */
+export * from './config'
diff --git a/web/src/types/router/index.ts b/web/src/types/router/index.ts
new file mode 100644
index 0000000..d9ef012
--- /dev/null
+++ b/web/src/types/router/index.ts
@@ -0,0 +1,80 @@
+/**
+ * 路由类型定义模块
+ *
+ * 提供路由相关的类型定义
+ *
+ * ## 主要功能
+ *
+ * - 路由元数据类型（标题、图标、权限等）
+ * - 应用路由记录类型
+ * - 路由配置扩展
+ *
+ * ## 使用场景
+ *
+ * - 路由配置类型约束
+ * - 路由元数据定义
+ * - 菜单生成
+ * - 权限控制
+ *
+ * @module types/router/index
+ * @author Art Design Pro Team
+ */
+
+import { RouteRecordRaw } from 'vue-router'
+
+/**
+ * 路由元数据接口
+ * 定义路由的各种配置属性
+ */
+export interface RouteMeta extends Record<string | number | symbol, unknown> {
+  /** 路由标题 */
+  title: string
+  /** 路由图标 */
+  icon?: string
+  /** 是否显示徽章 */
+  showBadge?: boolean
+  /** 文本徽章 */
+  showTextBadge?: string
+  /** 是否在菜单中隐藏 */
+  isHide?: boolean
+  /** 是否在标签页中隐藏 */
+  isHideTab?: boolean
+  /** 外部链接 */
+  link?: string
+  /** 是否为iframe */
+  isIframe?: boolean
+  /** 是否缓存 */
+  keepAlive?: boolean
+  /** 操作权限 */
+  authList?: Array<{
+    title: string
+    authMark: string
+  }>
+  /** 是否为一级菜单 */
+  isFirstLevel?: boolean
+  /** 角色权限 */
+  roles?: string[]
+  /** 是否固定标签页 */
+  fixedTab?: boolean
+  /** 激活菜单路径 */
+  activePath?: string
+  /** 是否为全屏页面 */
+  isFullPage?: boolean
+  /** 是否为权限按钮行 */
+  isAuthButton?: boolean
+  /** 权限标识 */
+  authMark?: string
+  /** 父级路径 */
+  parentPath?: string
+}
+
+/**
+ * 应用路由记录接口
+ * 扩展 Vue Router 的路由记录类型
+ */
+export interface AppRouteRecord extends Omit<RouteRecordRaw, 'meta' | 'children' | 'component'> {
+  id?: number
+  meta: RouteMeta
+  children?: AppRouteRecord[]
+  component?: string | (() => Promise<any>)
+}
diff --git a/web/src/types/store/index.ts b/web/src/types/store/index.ts
new file mode 100644
index 0000000..019801e
--- /dev/null
+++ b/web/src/types/store/index.ts
@@ -0,0 +1,157 @@
+/**
+ * Store 状态类型定义模块
+ *
+ * 提供 Pinia Store 的状态类型定义
+ *
+ * ## 主要功能
+ *
+ * - 系统主题类型
+ * - 菜单主题类型
+ * - 设置状态类型
+ * - 工作标签页类型
+ * - 用户状态类型
+ * - 菜单状态类型
+ * - 根状态类型
+ *
+ * ## 使用场景
+ *
+ * - Store 状态类型约束
+ * - 状态数据结构定义
+ * - 类型提示和自动补全
+ *
+ * @module types/store/index
+ * @author Art Design Pro Team
+ */
+
+import { MenuThemeEnum, SystemThemeEnum } from '@/enums/appEnum'
+import { LocationQueryRaw } from 'vue-router'
+
+// 系统主题样式（light | dark）
+export interface SystemThemeType {
+  /** 主题类名 */
+  className: string
+}
+
+// 定义包含多个主题的类型
+export type SystemThemeTypes = {
+  [key in Exclude<SystemThemeEnum, SystemThemeEnum.AUTO>]: SystemThemeType
+}
+
+// 菜单主题样式
+export interface MenuThemeType {
+  /** 主题类型 */
+  theme: MenuThemeEnum
+  /** 背景颜色 */
+  background: string
+  /** 系统名称颜色 */
+  systemNameColor: string
+  /** 文本颜色 */
+  textColor: string
+  /** 图标颜色 */
+  iconColor: string
+  /** 背景图片 */
+  img?: string
+}
+
+// 设置中心
+export interface SettingState {
+  /** 主题 */
+  theme: string
+  /** 是否只保持一个子菜单的展开 */
+  uniqueOpened: boolean
+  /** 是否显示菜单按钮 */
+  menuButton: boolean
+  /** 是否显示刷新按钮 */
+  showRefreshButton: boolean
+  /** 是否显示面包屑 */
+  showCrumbs: boolean
+  /** 是否自动关闭 */
+  autoClose: boolean
+  /** 是否显示工作标签页 */
+  showWorkTab: boolean
+  /** 是否显示语言切换 */
+  showLanguage: boolean
+  /** 是否显示进度条 */
+  showNprogress: boolean
+  /** 主题模式 */
+  themeModel: string
+}
+
+// 多标签
+export interface WorkTab {
+  /** 标签标题 */
+  title: string
+  /** 自定义标题 */
+  customTitle?: string
+  /** 路由路径 */
+  path: string
+  /** 路由名称 */
+  name: string
+  /** 是否缓存 */
+  keepAlive: boolean
+  /** 是否固定标签 */
+  fixedTab?: boolean
+  /** 路由参数 */
+  params?: object
+  /** 路由查询参数 */
+  query?: LocationQueryRaw
+  /** 图标 */
+  icon?: string
+  /** 是否激活 */
+  isActive?: boolean
+}
+
+// 用户Store状态
+export interface UserState {
+  /** 用户信息 */
+  userInfo: Api.Auth.UserInfo | null
+  /** 认证令牌 */
+  token: string | null
+  /** 用户角色列表 */
+  roles: string[]
+  /** 用户权限列表 */
+  permissions: string[]
+}
+
+// 设置Store状态
+export interface SettingStoreState extends SettingState {
+  // 额外的设置状态
+  /** 菜单是否折叠 */
+  collapsed: boolean
+  /** 设备类型 */
+  device: 'desktop' | 'mobile'
+  /** 当前语言 */
+  language: string
+}
+
+// 工作标签页Store状态
+export interface WorkTabState {
+  /** 标签页列表 */
+  tabs: WorkTab[]
+  /** 当前激活的标签页 */
+  activeTab: string
+  /** 缓存的标签页列表 */
+  cachedTabs: string[]
+}
+
+// 菜单Store状态
+export interface MenuState {
+  /** 菜单列表 */
+  menuList: any[]
+  /** 菜单是否已加载 */
+  isLoaded: boolean
+  /** 菜单是否折叠 */
+  collapsed: boolean
+}
+
+// 根Store状态类型
+export interface RootState {
+  /** 用户状态 */
+  user: UserState
+  /** 设置状态 */
+  setting: SettingStoreState
+  /** 工作标签页状态 */
+  workTab: WorkTabState
+  /** 菜单状态 */
+  menu: MenuState
+}
diff --git a/web/src/utils/constants/index.ts b/web/src/utils/constants/index.ts
new file mode 100644
index 0000000..831be29
--- /dev/null
+++ b/web/src/utils/constants/index.ts
@@ -0,0 +1,8 @@
+/**
+ * 常量定义相关工具函数统一导出
+ *
+ * @module utils/constants/index
+ * @author Art Design Pro Team
+ */
+
+export * from './links'
diff --git a/web/src/utils/constants/links.ts b/web/src/utils/constants/links.ts
new file mode 100644
index 0000000..06d297e
--- /dev/null
+++ b/web/src/utils/constants/links.ts
@@ -0,0 +1,35 @@
+/**
+ * 网站链接常量配置
+ * 集中管理便于维护和更新链接地址
+ *
+ * @module utils/constants/links
+ * @author Art Design Pro Team
+ */
+export const WEB_LINKS = {
+  // Github 主页
+  GITHUB_HOME: 'https://github.com/Daymychen/art-design-pro',
+
+  // 项目 Github 主页
+  GITHUB: 'https://github.com/Daymychen/art-design-pro',
+
+  // 个人博客
+  BLOG: 'https://www.artd.pro',
+
+  // 项目文档
+  DOCS: 'https://www.artd.pro/docs/zh/',
+
+  // 精简版本
+  LiteVersion: 'https://www.artd.pro/docs/zh/guide/lite-version.html',
+
+  // v2.6.1版本
+  OldVersion: 'https://www.artd.pro/v2/',
+
+  // 项目社区
+  COMMUNITY: 'https://www.artd.pro/docs/zh/community/communicate.html',
+
+  // 个人 Bilibili 主页
+  BILIBILI: 'https://space.bilibili.com/425500936?spm_id_from=333.1007.0.0',
+
+  // 项目介绍
+  INTRODUCE: 'https://www.artd.pro/docs/zh/guide/introduce.html'
+}
diff --git a/web/src/utils/form/index.ts b/web/src/utils/form/index.ts
new file mode 100644
index 0000000..ed23a46
--- /dev/null
+++ b/web/src/utils/form/index.ts
@@ -0,0 +1,12 @@
+/**
+ * 表单工具函数统一导出
+ *
+ * @module utils/form
+ * @author Art Design Pro Team
+ */
+
+// 表单验证器
+export * from './validator'
+
+// 响应式布局
+export * from './responsive'
diff --git a/web/src/utils/form/responsive.ts b/web/src/utils/form/responsive.ts
new file mode 100644
index 0000000..c11df92
--- /dev/null
+++ b/web/src/utils/form/responsive.ts
@@ -0,0 +1,122 @@
+/**
+ * 表单响应式布局工具模块
+ *
+ * 提供表单项在不同屏幕尺寸下的智能布局计算
+ *
+ * ## 主要功能
+ *
+ * - 响应式断点管理（xs/sm/md/lg/xl）
+ * - 表单列宽自动降级（避免小屏幕压缩）
+ * - 基于阈值的智能 span 计算
+ * - 响应式计算器工厂函数
+ * - 可配置的断点规则
+ *
+ * ## 使用场景
+ *
+ * - 表单组件响应式布局
+ * - 搜索表单自适应
+ * - 移动端表单优化
+ * - 多列表单布局
+ *
+ * ## 断点说明（基于 Element Plus Grid 24 栅格系统）：
+ * - xs (手机): < 768px，小于 12 时降级为 24（满宽）
+ * - sm (平板): ≥ 768px，小于 12 时降级为 12（半宽）
+ * - md (中等屏幕): ≥ 992px，小于 8 时降级为 8（三分之一宽）
+ * - lg (大屏幕): ≥ 1200px，直接使用设置的 span
+ * - xl (超大屏幕): ≥ 1920px，直接使用设置的 span
+ *
+ * ## 核心功能
+ *
+ * - calculateResponsiveSpan: 计算响应式列宽
+ * - createResponsiveSpanCalculator: 创建 span 计算器（柯里化）
+ *
+ * @module utils/form/responsive
+ * @author Art Design Pro Team
+ */
+
+/**
+ * 响应式断点类型
+ */
+export type ResponsiveBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl'
+
+/**
+ * 断点配置映射
+ */
+interface BreakpointConfig {
+  /** 最小 span 阈值 */
+  threshold: number
+  /** 降级后的 span 值 */
+  fallback: number
+}
+
+/**
+ * 响应式断点配置
+ */
+const BREAKPOINT_CONFIG: Record<ResponsiveBreakpoint, BreakpointConfig | null> = {
+  xs: { threshold: 12, fallback: 24 }, // 手机：小于 12 时使用满宽
+  sm: { threshold: 12, fallback: 12 }, // 平板：小于 12 时使用半宽
+  md: { threshold: 8, fallback: 8 }, // 中等屏幕：小于 8 时使用三分之一宽
+  lg: null, // 大屏幕：直接使用设置的 span
+  xl: null // 超大屏幕：直接使用设置的 span
+}
+
+/**
+ * 计算响应式列宽
+ *
+ * 根据屏幕尺寸智能降级，避免小屏幕上表单项被压缩过小
+ *
+ * @param itemSpan 表单项自定义的 span 值
+ * @param defaultSpan 默认的 span 值
+ * @param breakpoint 当前断点
+ * @returns 计算后的 span 值
+ *
+ * @example
+ * ```ts
+ * // 在 xs 断点下，span 为 6 会降级为 24（满宽）
+ * calculateResponsiveSpan(6, 6, 'xs') // 24
+ *
+ * // 在 md 断点下，span 为 6 会降级为 8（三分之一宽）
+ * calculateResponsiveSpan(6, 6, 'md') // 8
+ *
+ * // 在 lg 断点下，直接使用原始 span
+ * calculateResponsiveSpan(6, 6, 'lg') // 6
+ * ```
+ */
+export function calculateResponsiveSpan(
+  itemSpan: number | undefined,
+  defaultSpan: number,
+  breakpoint: ResponsiveBreakpoint
+): number {
+  const finalSpan = itemSpan ?? defaultSpan
+  const config = BREAKPOINT_CONFIG[breakpoint]
+
+  // 如果没有配置（lg/xl），直接返回原始 span
+  if (!config) {
+    return finalSpan
+  }
+
+  // 如果 span 小于阈值，使用降级值
+  return finalSpan >= config.threshold ? finalSpan : config.fallback
+}
+
+/**
+ * 创建响应式 span 计算器
+ *
+ * 返回一个函数，用于计算指定断点下的 span 值
+ *
+ * @param defaultSpan 默认的 span 值
+ * @returns span 计算函数
+ *
+ * @example
+ * ```ts
+ * const getColSpan = createResponsiveSpanCalculator(6)
+ * getColSpan(undefined, 'xs') // 24
+ * getColSpan(8, 'md') // 8
+ * getColSpan(12, 'lg') // 12
+ * ```
+ */
+export function createResponsiveSpanCalculator(defaultSpan: number) {
+  return (itemSpan: number | undefined, breakpoint: ResponsiveBreakpoint): number => {
+    return calculateResponsiveSpan(itemSpan, defaultSpan, breakpoint)
+  }
+}
diff --git a/web/src/utils/form/validator.ts b/web/src/utils/form/validator.ts
new file mode 100644
index 0000000..3670763
--- /dev/null
+++ b/web/src/utils/form/validator.ts
@@ -0,0 +1,316 @@
+/**
+ * 表单验证工具模块
+ *
+ * 提供全面的表单字段验证功能
+ *
+ * ## 主要功能
+ *
+ * - 手机号码验证（中国大陆格式）
+ * - 固定电话验证（支持区号格式）
+ * - 用户账号验证（字母开头，支持数字和下划线）
+ * - 密码强度验证（普通密码、强密码）
+ * - 密码强度评估（弱、中、强）
+ * - IPv4 地址验证
+ * - 邮箱地址验证（RFC 5322 标准）
+ * - URL 地址验证
+ * - 身份证号码验证（18位，含校验码验证）
+ * - 银行卡号验证（Luhn 算法）
+ * - 字符串空格处理
+ *
+ * ## 验证规则
+ *
+ * - 手机号：1开头，第二位3-9，共11位
+ * - 账号：字母开头，5-20位，支持字母数字下划线
+ * - 普通密码：6-20位，必须包含字母和数字
+ * - 强密码：8-20位，必须包含大小写字母、数字和特殊字符
+ * - 身份证：18位，含出生日期和校验码验证
+ * - 银行卡：13-19位，通过 Luhn 算法验证
+ *
+ * @module utils/validation/formValidator
+ * @author Art Design Pro Team
+ */
+
+/**
+ * 密码强度级别枚举
+ */
+export enum PasswordStrength {
+  WEAK = '弱',
+  MEDIUM = '中',
+  STRONG = '强'
+}
+
+/**
+ * 去除字符串首尾空格
+ * @param value 待处理的字符串
+ * @returns 返回去除首尾空格后的字符串
+ */
+export function trimSpaces(value: string): string {
+  if (typeof value !== 'string') {
+    return ''
+  }
+  return value.trim()
+}
+
+/**
+ * 验证手机号码（中国大陆）
+ * @param value 手机号码字符串
+ * @returns 返回验证结果，true表示格式正确
+ */
+export function validatePhone(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  // 中国大陆手机号码：1开头，第二位为3-9，共11位数字
+  const phoneRegex = /^1[3-9]\d{9}$/
+  return phoneRegex.test(value.trim())
+}
+
+/**
+ * 验证固定电话号码（中国大陆）
+ * @param value 电话号码字符串
+ * @returns 返回验证结果，true表示格式正确
+ */
+export function validateTelPhone(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  // 支持格式：区号-号码，如：010-12345678、0755-1234567
+  const telRegex = /^0\d{2,3}-?\d{7,8}$/
+  return telRegex.test(value.trim().replace(/\s+/g, ''))
+}
+
+/**
+ * 验证用户账号
+ * @param value 账号字符串
+ * @returns 返回验证结果，true表示格式正确
+ * @description 规则：字母开头，5-20位，支持字母、数字、下划线
+ */
+export function validateAccount(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  // 字母开头，5-20位，支持字母、数字、下划线
+  const accountRegex = /^[a-zA-Z][a-zA-Z0-9_]{4,19}$/
+  return accountRegex.test(value.trim())
+}
+
+/**
+ * 验证密码
+ * @param value 密码字符串
+ * @returns 返回验证结果，true表示格式正确
+ * @description 规则：6-20位，必须包含字母和数字
+ */
+export function validatePassword(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  const trimmedValue = value.trim()
+
+  // 长度检查
+  if (trimmedValue.length < 6 || trimmedValue.length > 20) {
+    return false
+  }
+
+  // 必须包含字母和数字
+  const hasLetter = /[a-zA-Z]/.test(trimmedValue)
+  const hasNumber = /\d/.test(trimmedValue)
+
+  return hasLetter && hasNumber
+}
+
+/**
+ * 验证强密码
+ * @param value 密码字符串
+ * @returns 返回验证结果，true表示格式正确
+ * @description 规则：8-20位，必须包含大写字母、小写字母、数字和特殊字符
+ */
+export function validateStrongPassword(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  const trimmedValue = value.trim()
+
+  // 长度检查
+  if (trimmedValue.length < 8 || trimmedValue.length > 20) {
+    return false
+  }
+
+  // 必须包含：大写字母、小写字母、数字、特殊字符
+  const hasUpperCase = /[A-Z]/.test(trimmedValue)
+  const hasLowerCase = /[a-z]/.test(trimmedValue)
+  const hasNumber = /\d/.test(trimmedValue)
+  const hasSpecialChar = /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]/.test(trimmedValue)
+
+  return hasUpperCase && hasLowerCase && hasNumber && hasSpecialChar
+}
+
+/**
+ * 获取密码强度
+ * @param value 密码字符串
+ * @returns 返回密码强度：弱、中、强
+ * @description 弱：纯数字/纯字母/纯特殊字符；中：两种组合；强：三种或以上组合
+ */
+export function getPasswordStrength(value: string): PasswordStrength {
+  if (!value || typeof value !== 'string') {
+    return PasswordStrength.WEAK
+  }
+
+  const trimmedValue = value.trim()
+
+  if (trimmedValue.length < 6) {
+    return PasswordStrength.WEAK
+  }
+
+  const hasUpperCase = /[A-Z]/.test(trimmedValue)
+  const hasLowerCase = /[a-z]/.test(trimmedValue)
+  const hasNumber = /\d/.test(trimmedValue)
+  const hasSpecialChar = /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]/.test(trimmedValue)
+
+  const typeCount = [hasUpperCase, hasLowerCase, hasNumber, hasSpecialChar].filter(Boolean).length
+
+  if (typeCount >= 3) {
+    return PasswordStrength.STRONG
+  } else if (typeCount >= 2) {
+    return PasswordStrength.MEDIUM
+  } else {
+    return PasswordStrength.WEAK
+  }
+}
+
+/**
+ * 验证IPv4地址
+ * @param value IP地址字符串
+ * @returns 返回验证结果，true表示格式正确
+ */
+export function validateIPv4Address(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  const trimmedValue = value.trim()
+  const ipRegex = /^((25[0-5]|2[0-4]\d|[01]?\d{1,2})\.){3}(25[0-5]|2[0-4]\d|[01]?\d{1,2})$/
+
+  if (!ipRegex.test(trimmedValue)) {
+    return false
+  }
+
+  // 额外检查每个段是否在有效范围内
+  const segments = trimmedValue.split('.')
+  return segments.every((segment) => {
+    const num = parseInt(segment, 10)
+    return num >= 0 && num <= 255
+  })
+}
+
+/**
+ * 验证邮箱地址
+ * @param value 邮箱地址字符串
+ * @returns 返回验证结果，true表示格式正确
+ */
+export function validateEmail(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  const trimmedValue = value.trim()
+
+  // RFC 5322 标准的简化版邮箱正则
+  const emailRegex =
+    /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/
+
+  return emailRegex.test(trimmedValue) && trimmedValue.length <= 254
+}
+
+/**
+ * 验证URL地址
+ * @param value URL字符串
+ * @returns 返回验证结果，true表示格式正确
+ */
+export function validateURL(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  try {
+    new URL(value.trim())
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 验证身份证号码（中国大陆）
+ * @param value 身份证号码字符串
+ * @returns 返回验证结果，true表示格式正确
+ */
+export function validateChineseIDCard(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  const trimmedValue = value.trim()
+
+  // 18位身份证号码正则
+  const idCardRegex =
+    /^[1-9]\d{5}(18|19|20)\d{2}((0[1-9])|(1[0-2]))(([0-2][1-9])|10|20|30|31)\d{3}[0-9Xx]$/
+
+  if (!idCardRegex.test(trimmedValue)) {
+    return false
+  }
+
+  // 验证校验码
+  const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2]
+  const checkCodes = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2']
+
+  let sum = 0
+  for (let i = 0; i < 17; i++) {
+    sum += parseInt(trimmedValue[i]) * weights[i]
+  }
+
+  const checkCode = checkCodes[sum % 11]
+  return trimmedValue[17].toUpperCase() === checkCode
+}
+
+/**
+ * 验证银行卡号
+ * @param value 银行卡号字符串
+ * @returns 返回验证结果，true表示格式正确
+ */
+export function validateBankCard(value: string): boolean {
+  if (!value || typeof value !== 'string') {
+    return false
+  }
+
+  const trimmedValue = value.trim().replace(/\s+/g, '')
+
+  // 银行卡号通常为13-19位数字
+  if (!/^\d{13,19}$/.test(trimmedValue)) {
+    return false
+  }
+
+  // Luhn算法验证
+  let sum = 0
+  let shouldDouble = false
+
+  for (let i = trimmedValue.length - 1; i >= 0; i--) {
+    let digit = parseInt(trimmedValue[i])
+
+    if (shouldDouble) {
+      digit *= 2
+      if (digit > 9) {
+        digit = (digit % 10) + 1
+      }
+    }
+
+    sum += digit
+    shouldDouble = !shouldDouble
+  }
+
+  return sum % 10 === 0
+}
diff --git a/web/src/utils/http/error.ts b/web/src/utils/http/error.ts
new file mode 100644
index 0000000..0f2c1ae
--- /dev/null
+++ b/web/src/utils/http/error.ts
@@ -0,0 +1,182 @@
+/**
+ * HTTP 错误处理模块
+ *
+ * 提供统一的 HTTP 请求错误处理机制
+ *
+ * ## 主要功能
+ *
+ * - 自定义 HttpError 错误类，封装错误信息、状态码、时间戳等
+ * - 错误拦截和转换，将 Axios 错误转换为标准的 HttpError
+ * - 错误消息国际化处理，根据状态码返回对应的多语言错误提示
+ * - 错误日志记录，便于问题追踪和调试
+ * - 错误和成功消息的统一展示
+ * - 类型守卫函数，用于判断错误类型
+ *
+ * ## 使用场景
+ *
+ * - HTTP 请求拦截器中统一处理错误
+ * - 业务代码中捕获和处理特定错误
+ * - 错误日志收集和上报
+ *
+ * @module utils/http/error
+ * @author Art Design Pro Team
+ */
+import { AxiosError } from 'axios'
+import { ApiStatus } from './status'
+import { $t } from '@/locales'
+
+// 错误响应接口
+export interface ErrorResponse {
+  /** 错误状态码 */
+  code: number
+  /** 错误消息 */
+  msg: string
+  /** 错误附加数据 */
+  data?: unknown
+}
+
+// 错误日志数据接口
+export interface ErrorLogData {
+  /** 错误状态码 */
+  code: number
+  /** 错误消息 */
+  message: string
+  /** 错误附加数据 */
+  data?: unknown
+  /** 错误发生时间戳 */
+  timestamp: string
+  /** 请求 URL */
+  url?: string
+  /** 请求方法 */
+  method?: string
+  /** 错误堆栈信息 */
+  stack?: string
+}
+
+// 自定义 HttpError 类
+export class HttpError extends Error {
+  public readonly code: number
+  public readonly data?: unknown
+  public readonly timestamp: string
+  public readonly url?: string
+  public readonly method?: string
+
+  constructor(
+    message: string,
+    code: number,
+    options?: {
+      data?: unknown
+      url?: string
+      method?: string
+    }
+  ) {
+    super(message)
+    this.name = 'HttpError'
+    this.code = code
+    this.data = options?.data
+    this.timestamp = new Date().toISOString()
+    this.url = options?.url
+    this.method = options?.method
+  }
+
+  public toLogData(): ErrorLogData {
+    return {
+      code: this.code,
+      message: this.message,
+      data: this.data,
+      timestamp: this.timestamp,
+      url: this.url,
+      method: this.method,
+      stack: this.stack
+    }
+  }
+}
+
+/**
+ * 获取错误消息
+ * @param status 错误状态码
+ * @returns 错误消息
+ */
+const getErrorMessage = (status: number): string => {
+  const errorMap: Record<number, string> = {
+    [ApiStatus.unauthorized]: 'httpMsg.unauthorized',
+    [ApiStatus.forbidden]: 'httpMsg.forbidden',
+    [ApiStatus.notFound]: 'httpMsg.notFound',
+    [ApiStatus.methodNotAllowed]: 'httpMsg.methodNotAllowed',
+    [ApiStatus.requestTimeout]: 'httpMsg.requestTimeout',
+    [ApiStatus.internalServerError]: 'httpMsg.internalServerError',
+    [ApiStatus.badGateway]: 'httpMsg.badGateway',
+    [ApiStatus.serviceUnavailable]: 'httpMsg.serviceUnavailable',
+    [ApiStatus.gatewayTimeout]: 'httpMsg.gatewayTimeout'
+  }
+
+  return $t(errorMap[status] || 'httpMsg.internalServerError')
+}
+
+/**
+ * 处理错误
+ * @param error 错误对象
+ * @returns 错误对象
+ */
+export function handleError(error: AxiosError<ErrorResponse>): never {
+  // 处理取消的请求
+  if (error.code === 'ERR_CANCELED') {
+    console.warn('Request cancelled:', error.message)
+    throw new HttpError($t('httpMsg.requestCancelled'), ApiStatus.error)
+  }
+
+  const statusCode = error.response?.status
+  const errorMessage = error.response?.data?.msg || error.message
+  const requestConfig = error.config
+
+  // 处理网络错误
+  if (!error.response) {
+    throw new HttpError($t('httpMsg.networkError'), ApiStatus.error, {
+      url: requestConfig?.url,
+      method: requestConfig?.method?.toUpperCase()
+    })
+  }
+
+  // 处理 HTTP 状态码错误
+  const message = statusCode
+    ? getErrorMessage(statusCode)
+    : errorMessage || $t('httpMsg.requestFailed')
+  throw new HttpError(message, statusCode || ApiStatus.error, {
+    data: error.response.data,
+    url: requestConfig?.url,
+    method: requestConfig?.method?.toUpperCase()
+  })
+}
+
+/**
+ * 显示错误消息
+ * @param error 错误对象
+ * @param showMessage 是否显示错误消息
+ */
+export function showError(error: HttpError, showMessage: boolean = true): void {
+  if (showMessage) {
+    ElMessage.error(error.message)
+  }
+  // 记录错误日志
+  console.error('[HTTP Error]', error.toLogData())
+}
+
+/**
+ * 显示成功消息
+ * @param message 成功消息
+ * @param showMessage 是否显示消息
+ */
+export function showSuccess(message: string, showMessage: boolean = true): void {
+  if (showMessage) {
+    ElMessage.success(message)
+  }
+}
+
+/**
+ * 判断是否为 HttpError 类型
+ * @param error 错误对象
+ * @returns 是否为 HttpError 类型
+ */
+export const isHttpError = (error: unknown): error is HttpError => {
+  return error instanceof HttpError
+}
diff --git a/web/src/utils/http/index.ts b/web/src/utils/http/index.ts
new file mode 100644
index 0000000..b895899
--- /dev/null
+++ b/web/src/utils/http/index.ts
@@ -0,0 +1,237 @@
+import axios, {
+  AxiosError,
+  AxiosRequestConfig,
+  AxiosResponse,
+  InternalAxiosRequestConfig
+} from 'axios'
+import { useUserStore } from '@/store/modules/user'
+import { ApiStatus } from './status'
+import { HttpError, handleError, showError, showSuccess } from './error'
+import { $t } from '@/locales'
+import { BaseResponse } from '@/types'
+
+const REQUEST_TIMEOUT = 15000
+const MAX_RETRIES = 0
+const RETRY_DELAY = 1000
+
+interface ExtendedAxiosRequestConfig extends AxiosRequestConfig {
+  showErrorMessage?: boolean
+  showSuccessMessage?: boolean
+  _retry?: boolean
+}
+
+const { VITE_API_URL } = import.meta.env
+
+const axiosInstance = axios.create({
+  timeout: REQUEST_TIMEOUT,
+  baseURL: VITE_API_URL,
+  withCredentials: true
+})
+
+let refreshingPromise: Promise<Api.Auth.RefreshResponse> | null = null
+const REFRESH_RETRY_ERROR = 'ERR_REFRESH_TOKEN_RETRY'
+
+axiosInstance.interceptors.request.use(
+  (request: InternalAxiosRequestConfig) => {
+    const userStore = useUserStore()
+    if (userStore.accessToken) {
+      request.headers.set('Authorization', `Bearer ${userStore.accessToken}`)
+    }
+
+    if (request.data && !(request.data instanceof FormData) && !request.headers['Content-Type']) {
+      request.headers.set('Content-Type', 'application/json')
+    }
+
+    return request
+  },
+  (error) => {
+    showError(new HttpError($t('httpMsg.requestConfigError'), ApiStatus.error))
+    return Promise.reject(error)
+  }
+)
+
+axiosInstance.interceptors.response.use(
+  async (response: AxiosResponse<BaseResponse>) => {
+    const { code, msg } = response.data
+    if (code === ApiStatus.success || code === 201) {
+      return response
+    }
+    if (code === ApiStatus.unauthorized) {
+      throw new HttpError(msg || $t('httpMsg.unauthorized'), ApiStatus.unauthorized)
+    }
+    throw new HttpError(msg || $t('httpMsg.requestFailed'), code || ApiStatus.error, {
+      data: response.data,
+      url: response.config.url,
+      method: response.config.method?.toUpperCase()
+    })
+  },
+  async (
+    error: AxiosError<{
+      code?: number
+      msg?: string
+    }>
+  ) => {
+    const originalConfig = (error.config || {}) as ExtendedAxiosRequestConfig
+    const responseStatus = error.response?.status
+    const shouldTryRefresh =
+      responseStatus === ApiStatus.unauthorized &&
+      !originalConfig._retry &&
+      !String(originalConfig.url || '').includes('/api/auth/refresh')
+
+    if (shouldTryRefresh) {
+      originalConfig._retry = true
+      try {
+        const authData = await refreshAccessToken()
+        originalConfig.headers = {
+          ...(originalConfig.headers || {}),
+          Authorization: `Bearer ${authData.token}`
+        }
+        return axiosInstance.request(originalConfig)
+      } catch (refreshError) {
+        forceLogout()
+        return Promise.reject(refreshError)
+      }
+    }
+
+    if (responseStatus === ApiStatus.unauthorized) {
+      forceLogout()
+    }
+    return Promise.reject(handleError(error as AxiosError<any>))
+  }
+)
+
+function createHttpError(message: string, code: number) {
+  return new HttpError(message, code)
+}
+
+async function refreshAccessToken(): Promise<Api.Auth.RefreshResponse> {
+  if (refreshingPromise) {
+    return refreshingPromise
+  }
+
+  const userStore = useUserStore()
+  if (!userStore.isLogin) {
+    throw createHttpError($t('httpMsg.unauthorized'), ApiStatus.unauthorized)
+  }
+
+  refreshingPromise = requestRefreshToken()
+    .then((payload) => {
+      userStore.setToken(payload.token)
+      userStore.setLoginStatus(true)
+      return payload
+    })
+    .finally(() => {
+      refreshingPromise = null
+    })
+
+  return refreshingPromise
+}
+
+async function requestRefreshToken(): Promise<Api.Auth.RefreshResponse> {
+  try {
+    return await postRefreshToken()
+  } catch (error) {
+    if (isRefreshRetryError(error)) {
+      return postRefreshToken()
+    }
+    throw handleError(error as AxiosError<any>)
+  }
+}
+
+async function postRefreshToken(): Promise<Api.Auth.RefreshResponse> {
+  const response = await axios.post<BaseResponse<Api.Auth.RefreshResponse>>(
+    '/api/auth/refresh',
+    undefined,
+    {
+      baseURL: VITE_API_URL,
+      timeout: REQUEST_TIMEOUT,
+      withCredentials: true
+    }
+  )
+  return response.data.data
+}
+
+function isRefreshRetryError(error: unknown): boolean {
+  if (!axios.isAxiosError(error)) {
+    return false
+  }
+  return error.response?.status === 409 && error.response?.data?.msg === REFRESH_RETRY_ERROR
+}
+
+function forceLogout() {
+  useUserStore().logOut()
+}
+
+function shouldRetry(statusCode: number) {
+  return [
+    ApiStatus.requestTimeout,
+    ApiStatus.internalServerError,
+    ApiStatus.badGateway,
+    ApiStatus.serviceUnavailable,
+    ApiStatus.gatewayTimeout
+  ].includes(statusCode)
+}
+
+async function retryRequest<T>(
+  config: ExtendedAxiosRequestConfig,
+  retries: number = MAX_RETRIES
+): Promise<T> {
+  try {
+    return await request<T>(config)
+  } catch (error) {
+    if (retries > 0 && error instanceof HttpError && shouldRetry(error.code)) {
+      await delay(RETRY_DELAY)
+      return retryRequest<T>(config, retries - 1)
+    }
+    throw error
+  }
+}
+
+function delay(ms: number) {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+async function request<T = any>(config: ExtendedAxiosRequestConfig): Promise<T> {
+  if (
+    ['POST', 'PUT'].includes(config.method?.toUpperCase() || '') &&
+    config.params &&
+    !config.data
+  ) {
+    config.data = config.params
+    config.params = undefined
+  }
+
+  try {
+    const res = await axiosInstance.request<BaseResponse<T>>(config)
+    if (config.showSuccessMessage && res.data.msg) {
+      showSuccess(res.data.msg)
+    }
+    return res.data.data as T
+  } catch (error) {
+    if (error instanceof HttpError && error.code !== ApiStatus.unauthorized) {
+      showError(error, config.showErrorMessage !== false)
+    }
+    return Promise.reject(error)
+  }
+}
+
+const api = {
+  get<T>(config: ExtendedAxiosRequestConfig) {
+    return retryRequest<T>({ ...config, method: 'GET' })
+  },
+  post<T>(config: ExtendedAxiosRequestConfig) {
+    return retryRequest<T>({ ...config, method: 'POST' })
+  },
+  put<T>(config: ExtendedAxiosRequestConfig) {
+    return retryRequest<T>({ ...config, method: 'PUT' })
+  },
+  del<T>(config: ExtendedAxiosRequestConfig) {
+    return retryRequest<T>({ ...config, method: 'DELETE' })
+  },
+  request<T>(config: ExtendedAxiosRequestConfig) {
+    return retryRequest<T>(config)
+  }
+}
+
+export { axiosInstance }
+export default api
diff --git a/web/src/utils/http/status.ts b/web/src/utils/http/status.ts
new file mode 100755
index 0000000..989bb37
--- /dev/null
+++ b/web/src/utils/http/status.ts
@@ -0,0 +1,18 @@
+/**
+ * 接口状态码
+ */
+export enum ApiStatus {
+  success = 200, // 成功
+  error = 400, // 错误
+  unauthorized = 401, // 未授权
+  forbidden = 403, // 禁止访问
+  notFound = 404, // 未找到
+  methodNotAllowed = 405, // 方法不允许
+  requestTimeout = 408, // 请求超时
+  internalServerError = 500, // 服务器错误
+  notImplemented = 501, // 未实现
+  badGateway = 502, // 网关错误
+  serviceUnavailable = 503, // 服务不可用
+  gatewayTimeout = 504, // 网关超时
+  httpVersionNotSupported = 505 // HTTP版本不支持
+}
diff --git a/web/src/utils/index.ts b/web/src/utils/index.ts
new file mode 100644
index 0000000..f1e1b77
--- /dev/null
+++ b/web/src/utils/index.ts
@@ -0,0 +1,34 @@
+/**
+ * Utils 工具函数统一导出
+ * 提供向后兼容性和便捷导入
+ *
+ * @module utils/index
+ * @author Art Design Pro Team
+ */
+
+// UI 相关
+export * from './ui'
+
+// 路由相关
+export * from './router'
+
+// 路由导航相关
+export * from './navigation'
+
+// 系统管理相关
+export * from './sys'
+
+// 常量定义相关
+export * from './constants'
+
+// 存储相关
+export * from './storage'
+
+// HTTP 相关
+export * from './http'
+
+// 表单相关
+export * from './form'
+
+// socket 相关
+export * from './socket'
diff --git a/web/src/utils/navigation/index.ts b/web/src/utils/navigation/index.ts
new file mode 100644
index 0000000..0b84e78
--- /dev/null
+++ b/web/src/utils/navigation/index.ts
@@ -0,0 +1,10 @@
+/**
+ * 路由和导航相关工具函数统一导出
+ *
+ * @module utils/navigation/index
+ * @author Art Design Pro Team
+ */
+
+export * from './jump'
+export * from './worktab'
+export * from './route'
diff --git a/web/src/utils/navigation/jump.ts b/web/src/utils/navigation/jump.ts
new file mode 100644
index 0000000..320edb5
--- /dev/null
+++ b/web/src/utils/navigation/jump.ts
@@ -0,0 +1,68 @@
+/**
+ * 导航跳转工具模块
+ *
+ * 提供统一的页面跳转和导航功能
+ *
+ * ## 主要功能
+ *
+ * - 外部链接打开（新窗口）
+ * - 菜单项跳转处理（支持内部路由和外部链接）
+ * - iframe 页面跳转支持
+ * - 递归查找并跳转到第一个可见的子菜单
+ * - 智能判断跳转目标类型（外部链接/内部路由）
+ *
+ * @module utils/navigation/jump
+ * @author Art Design Pro Team
+ */
+import { AppRouteRecord } from '@/types/router'
+import { router } from '@/router'
+import { isNavigableMenuItem } from './route'
+
+// 打开外部链接
+export const openExternalLink = (link: string) => {
+  window.open(link, '_blank')
+}
+
+/**
+ * 菜单跳转
+ * @param item 菜单项
+ * @param jumpToFirst 是否跳转到第一个子菜单
+ * @returns
+ */
+export const handleMenuJump = (item: AppRouteRecord, jumpToFirst: boolean = false) => {
+  // 处理外部链接
+  const { link, isIframe } = item.meta
+  if (link && !isIframe) {
+    return openExternalLink(link)
+  }
+
+  // 如果不需要跳转到第一个子菜单，或者没有子菜单，直接跳转当前路径
+  if (!jumpToFirst || !item.children?.length) {
+    return router.push(item.path)
+  }
+
+  // 递归查找第一个可导航的叶子节点菜单
+  const findFirstLeafMenu = (items: AppRouteRecord[]): AppRouteRecord | undefined => {
+    for (const child of items) {
+      if (isNavigableMenuItem(child)) {
+        return child.children?.length ? findFirstLeafMenu(child.children) || child : child
+      }
+    }
+    return undefined
+  }
+
+  const firstChild = findFirstLeafMenu(item.children)
+
+  // 如果子菜单都不可见，则回退到父级页面自身。
+  if (!firstChild) {
+    return router.push(item.path)
+  }
+
+  // 如果第一个子菜单是外部链接则打开新窗口
+  if (firstChild.meta?.link) {
+    return openExternalLink(firstChild.meta.link)
+  }
+
+  // 跳转到子菜单路径
+  router.push(firstChild.path)
+}
diff --git a/web/src/utils/navigation/route.ts b/web/src/utils/navigation/route.ts
new file mode 100644
index 0000000..518bcb9
--- /dev/null
+++ b/web/src/utils/navigation/route.ts
@@ -0,0 +1,85 @@
+/**
+ * 路由工具模块
+ *
+ * 提供路由处理和菜单路径相关的工具函数
+ *
+ * ## 主要功能
+ *
+ * - iframe 路由检测，判断是否为外部嵌入页面
+ * - 菜单项有效性验证，过滤隐藏和无效菜单
+ * - 路径标准化处理，统一路径格式
+ * - 递归查找菜单树中第一个有效路径
+ * - 支持多级嵌套菜单的路径解析
+ *
+ * ## 使用场景
+ *
+ * - 系统初始化时获取默认跳转路径
+ * - 菜单权限过滤后获取首个可访问页面
+ * - 路由重定向逻辑处理
+ * - iframe 页面特殊处理
+ *
+ * @module utils/navigation/route
+ * @author Art Design Pro Team
+ */
+
+import { AppRouteRecord } from '@/types'
+
+// 检查是否为 iframe 路由
+export function isIframe(url: string): boolean {
+  return url.startsWith('/outside/iframe/')
+}
+
+/**
+ * 判断菜单项是否可作为默认导航落点
+ * 隐藏的全屏页面虽然不展示在菜单中，但仍然可能是合法首页。
+ */
+export const isNavigableMenuItem = (menuItem: AppRouteRecord): boolean => {
+  if (!menuItem.path || !menuItem.path.trim()) {
+    return false
+  }
+
+  if (!menuItem.meta?.isHide) {
+    return true
+  }
+
+  return menuItem.meta?.isFullPage === true
+}
+
+/**
+ * 标准化路径格式
+ * @param path 路径
+ * @returns 标准化后的路径
+ */
+const normalizePath = (path: string): string => {
+  return path.startsWith('/') ? path : `/${path}`
+}
+
+/**
+ * 递归获取菜单的第一个有效路径
+ * @param menuList 菜单列表
+ * @returns 第一个有效路径，如果没有找到则返回空字符串
+ */
+export const getFirstMenuPath = (menuList: AppRouteRecord[]): string => {
+  if (!Array.isArray(menuList) || menuList.length === 0) {
+    return ''
+  }
+
+  for (const menuItem of menuList) {
+    if (!isNavigableMenuItem(menuItem)) {
+      continue
+    }
+
+    // 如果有子菜单，优先查找子菜单
+    if (menuItem.children?.length) {
+      const childPath = getFirstMenuPath(menuItem.children)
+      if (childPath) {
+        return childPath
+      }
+    }
+
+    // 返回当前菜单项的标准化路径
+    return normalizePath(menuItem.path!)
+  }
+
+  return ''
+}
diff --git a/web/src/utils/navigation/worktab.ts b/web/src/utils/navigation/worktab.ts
new file mode 100644
index 0000000..6db6a77
--- /dev/null
+++ b/web/src/utils/navigation/worktab.ts
@@ -0,0 +1,67 @@
+/**
+ * 工作标签页管理模块
+ *
+ * 提供工作标签页（Worktab）的自动管理功能
+ *
+ * ## 主要功能
+ *
+ * - 根据路由导航自动创建和更新工作标签页
+ * - iframe 页面标签页特殊处理
+ * - 标签页信息提取（标题、路径、缓存状态等）
+ * - 固定标签页支持
+ * - 根据系统设置控制标签页显示
+ * - 首页标签页特殊处理
+ *
+ * ## 使用场景
+ *
+ * - 路由守卫中自动创建标签页
+ * - 页面切换时更新标签页状态
+ * - 多标签页导航系统
+ *
+ * @module utils/navigation/worktab
+ * @author Art Design Pro Team
+ */
+import { useWorktabStore } from '@/store/modules/worktab'
+import { RouteLocationNormalized } from 'vue-router'
+import { isIframe } from './route'
+import { useSettingStore } from '@/store/modules/setting'
+import { IframeRouteManager } from '@/router/core'
+import { useCommon } from '@/hooks/core/useCommon'
+
+/**
+ * 根据当前路由信息设置工作标签页（worktab）
+ * @param to 当前路由对象
+ */
+export const setWorktab = (to: RouteLocationNormalized): void => {
+  const worktabStore = useWorktabStore()
+  const { meta, path, name, params, query } = to
+  if (!meta.isHideTab) {
+    // 如果是 iframe 页面，则特殊处理工作标签页
+    if (isIframe(path)) {
+      const iframeRoute = IframeRouteManager.getInstance().findByPath(to.path)
+
+      if (iframeRoute?.meta) {
+        worktabStore.openTab({
+          title: iframeRoute.meta.title,
+          icon: meta.icon as string,
+          path,
+          name: name as string,
+          keepAlive: meta.keepAlive as boolean,
+          params,
+          query
+        })
+      }
+    } else if (useSettingStore().showWorkTab || path === useCommon().homePath.value) {
+      worktabStore.openTab({
+        title: meta.title as string,
+        icon: meta.icon as string,
+        path,
+        name: name as string,
+        keepAlive: meta.keepAlive as boolean,
+        params,
+        query,
+        fixedTab: meta.fixedTab as boolean
+      })
+    }
+  }
+}
diff --git a/web/src/utils/router.ts b/web/src/utils/router.ts
new file mode 100644
index 0000000..c55bd48
--- /dev/null
+++ b/web/src/utils/router.ts
@@ -0,0 +1,70 @@
+/**
+ * 路由工具函数
+ *
+ * 提供路由相关的工具函数
+ *
+ * @module utils/router
+ */
+import { RouteLocationNormalized, RouteRecordRaw } from 'vue-router'
+import AppConfig from '@/config'
+import NProgress from 'nprogress'
+import 'nprogress/nprogress.css'
+import i18n, { $t } from '@/locales'
+
+/** 扩展的路由配置类型 */
+export type AppRouteRecordRaw = RouteRecordRaw & {
+  hidden?: boolean
+}
+
+/** 顶部进度条配置 */
+export const configureNProgress = () => {
+  NProgress.configure({
+    easing: 'ease',
+    speed: 600,
+    showSpinner: false,
+    parent: 'body'
+  })
+}
+
+/**
+ * 设置页面标题，根据路由元信息和系统信息拼接标题
+ * @param to 当前路由对象
+ */
+export const setPageTitle = (to: RouteLocationNormalized): void => {
+  const { title } = to.meta
+  if (title) {
+    setTimeout(() => {
+      document.title = `${formatMenuTitle(String(title))} - ${AppConfig.systemInfo.name}`
+    }, 150)
+  }
+}
+
+/**
+ * 格式化菜单标题
+ * @param title 菜单标题，可以是 i18n 的 key，也可以是字符串
+ * @returns 格式化后的菜单标题
+ */
+export const formatMenuTitle = (title: string): string => {
+  if (!title) {
+    return ''
+  }
+
+  if (i18n.global.te(title)) {
+    return $t(title)
+  }
+
+  const looksLikeI18nKey = /^[a-z][\w-]*(\.[\w-]+)+(\[\d+\])?$/i.test(title)
+  if (looksLikeI18nKey) {
+    if (import.meta.env.DEV) {
+      console.warn(`[i18n] missing translation key: ${title}`)
+    }
+    return (
+      title
+        .split('.')
+        .pop()
+        ?.replace(/\[\d+\]$/, '') || title
+    )
+  }
+
+  return title
+}
diff --git a/web/src/utils/socket/index.ts b/web/src/utils/socket/index.ts
new file mode 100644
index 0000000..ac80da1
--- /dev/null
+++ b/web/src/utils/socket/index.ts
@@ -0,0 +1,423 @@
+interface WebSocketOptions {
+  url?: string
+  messageHandler: (event: MessageEvent) => void
+  reconnectInterval?: number // 重连间隔(ms)
+  heartbeatInterval?: number // 心跳检测间隔(ms)
+  pingInterval?: number // 发送ping间隔(ms)
+  reconnectTimeout?: number // 重连超时时间(ms)
+  maxReconnectAttempts?: number // 最大重连次数
+  connectionTimeout?: number // 连接建立超时时间(ms)
+}
+
+export default class WebSocketClient {
+  private static instance: WebSocketClient | null = null
+  private ws: WebSocket | null = null
+  private url: string
+  private messageHandler: (event: MessageEvent) => void
+  private reconnectInterval: number
+  private heartbeatInterval: number
+  private pingInterval: number
+  private reconnectTimeout: number
+  private maxReconnectAttempts: number
+  private connectionTimeout: number
+  private reconnectAttempts: number = 0 // 当前重连次数
+
+  // 消息队列 - 缓存连接建立前的消息
+  private messageQueue: Array<string | ArrayBufferLike | Blob | ArrayBufferView> = []
+
+  // 定时器
+  private detectionTimer: NodeJS.Timeout | null = null
+  private timeoutTimer: NodeJS.Timeout | null = null
+  private reconnectTimer: NodeJS.Timeout | null = null
+  private pingTimer: NodeJS.Timeout | null = null
+  private connectionTimer: NodeJS.Timeout | null = null // 连接超时定时器
+
+  // 状态标识
+  private isConnected: boolean = false
+  private isConnecting: boolean = false // 是否正在连接中
+  private stopReconnect: boolean = false
+  private isReconnecting: boolean = false
+
+  private constructor(options: WebSocketOptions) {
+    this.url = options.url || (process.env.VUE_APP_LOGIN_WEBSOCKET as string)
+    this.messageHandler = options.messageHandler
+    this.reconnectInterval = options.reconnectInterval ?? 20 * 1000 // 默认20秒
+    this.heartbeatInterval = options.heartbeatInterval ?? 5 * 1000 // 默认5秒
+    this.pingInterval = options.pingInterval ?? 10 * 1000 // 默认10秒
+    this.reconnectTimeout = options.reconnectTimeout ?? 30 * 1000 // 默认30秒
+    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 10 // 默认最多重连10次
+    this.connectionTimeout = options.connectionTimeout ?? 10 * 1000 // 连接超时10秒
+  }
+
+  // 单例模式获取实例
+  static getInstance(options: WebSocketOptions): WebSocketClient {
+    if (!WebSocketClient.instance) {
+      WebSocketClient.instance = new WebSocketClient(options)
+    } else {
+      // 更新消息处理器
+      WebSocketClient.instance.messageHandler = options.messageHandler
+      // 如果提供了新的URL，则更新并重新连接
+      if (options.url && WebSocketClient.instance.url !== options.url) {
+        WebSocketClient.instance.url = options.url
+        WebSocketClient.instance.reconnectAttempts = 0
+        WebSocketClient.instance.init()
+      }
+    }
+    return WebSocketClient.instance
+  }
+
+  // 初始化连接
+  init(): void {
+    this.connect(true)
+  }
+
+  private connect(resetReconnectAttempts: boolean = false): void {
+    // 如果正在连接中，不重复连接
+    if (this.isConnecting) {
+      console.log('正在建立WebSocket连接中...')
+      return
+    }
+
+    // 如果已连接，不重复连接
+    if (this.ws?.readyState === WebSocket.OPEN) {
+      console.warn('WebSocket连接已存在')
+      this.flushMessageQueue() // 确保队列中的消息被发送
+      return
+    }
+
+    try {
+      this.isConnecting = true
+      this.stopReconnect = false
+      if (resetReconnectAttempts) {
+        this.reconnectAttempts = 0
+        this.isReconnecting = false
+        this.clearTimer('reconnectTimer')
+      }
+      this.ws = new WebSocket(this.url)
+
+      // 设置连接超时检测
+      this.clearTimer('connectionTimer')
+      this.connectionTimer = setTimeout(() => {
+        console.error(`WebSocket连接超时 (${this.connectionTimeout}ms)：${this.url}`)
+        this.handleConnectionTimeout()
+      }, this.connectionTimeout)
+
+      this.ws.onopen = (event) => this.handleOpen(event)
+      this.ws.onmessage = (event) => this.handleMessage(event)
+      this.ws.onclose = (event) => this.handleClose(event)
+      this.ws.onerror = (event) => this.handleError(event)
+    } catch (error) {
+      console.error('WebSocket初始化失败:', error)
+      this.isConnecting = false
+      this.reconnect()
+    }
+  }
+
+  // 处理连接超时
+  private handleConnectionTimeout(): void {
+    if (this.ws?.readyState !== WebSocket.OPEN) {
+      console.error('WebSocket连接超时，强制关闭连接')
+      this.ws?.close(1000, 'Connection timeout')
+      this.isConnecting = false
+      this.reconnect()
+    }
+  }
+
+  // 关闭连接
+  close(force?: boolean): void {
+    this.clearAllTimers()
+    this.stopReconnect = true
+    this.isReconnecting = false
+    this.isConnecting = false
+
+    if (this.ws) {
+      // 1000 表示正常关闭
+      this.ws.close(force ? 1001 : 1000, force ? 'Force closed' : 'Normal close')
+      this.ws = null
+    }
+
+    this.isConnected = false
+  }
+
+  // 发送消息 - 增加消息队列
+  send(data: string | ArrayBufferLike | Blob | ArrayBufferView, immediate: boolean = false): void {
+    // 如果要求立即发送且未连接，则直接报错
+    if (immediate && (!this.ws || this.ws.readyState !== WebSocket.OPEN)) {
+      console.error('WebSocket未连接，无法立即发送消息')
+      return
+    }
+
+    // 如果未连接且不要求立即发送，则加入消息队列
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+      console.log('WebSocket未连接，消息已加入队列等待发送')
+      this.messageQueue.push(data)
+      // 如果未在重连中，则尝试重连
+      if (!this.isConnecting && !this.stopReconnect) {
+        this.init()
+      }
+      return
+    }
+
+    try {
+      this.ws.send(data)
+    } catch (error) {
+      console.error('WebSocket发送消息失败:', error)
+      // 发送失败时将消息加入队列，等待重连后重试
+      this.messageQueue.push(data)
+      this.reconnect()
+    }
+  }
+
+  // 发送队列中的消息
+  private flushMessageQueue(): void {
+    if (this.messageQueue.length > 0 && this.ws?.readyState === WebSocket.OPEN) {
+      console.log(`发送队列中的${this.messageQueue.length}条消息`)
+      while (this.messageQueue.length > 0) {
+        const data = this.messageQueue.shift()
+        if (data) {
+          try {
+            this.ws?.send(data)
+          } catch (error) {
+            console.error('发送队列消息失败:', error)
+            // 如果发送失败，将消息放回队列头部
+            if (data) this.messageQueue.unshift(data)
+            break
+          }
+        }
+      }
+    }
+  }
+
+  // 处理连接打开
+  private handleOpen(event: Event): void {
+    console.log('WebSocket连接成功', event)
+    this.clearTimer('connectionTimer') // 清除连接超时定时器
+    this.isConnected = true
+    this.isConnecting = false
+    this.isReconnecting = false
+    this.stopReconnect = false
+    this.reconnectAttempts = 0 // 重置重连次数
+    this.startHeartbeat()
+    this.startPing()
+    this.flushMessageQueue() // 发送队列中的消息
+  }
+
+  // 处理收到的消息
+  private handleMessage(event: MessageEvent): void {
+    console.log('收到WebSocket消息:', event)
+    this.resetHeartbeat()
+    this.messageHandler(event)
+  }
+
+  // 处理连接关闭
+  private handleClose(event: CloseEvent): void {
+    console.log(
+      `WebSocket断开: 代码=${event.code}, 原因=${event.reason}, 干净关闭=${event.wasClean}`
+    )
+
+    // 1000 是正常关闭代码
+    const isNormalClose = event.code === 1000
+
+    this.isConnected = false
+    this.isConnecting = false
+    this.clearConnectionTimers()
+    this.ws = null
+
+    if (!this.stopReconnect && !isNormalClose) {
+      this.reconnect()
+    }
+  }
+
+  // 处理错误 - 增加详细错误信息
+  private handleError(event: Event): void {
+    console.error('WebSocket连接错误:')
+    console.error('错误事件:', event)
+    console.error(
+      '当前连接状态:',
+      this.ws?.readyState ? this.getReadyStateText(this.ws.readyState) : '未初始化'
+    )
+
+    this.isConnected = false
+    this.isConnecting = false
+
+    // 只有在未停止重连的情况下才尝试重连
+    if (!this.stopReconnect) {
+      this.reconnect()
+    }
+  }
+
+  private closeCurrentSocketForReconnect(): void {
+    this.clearConnectionTimers()
+    this.isConnected = false
+    this.isConnecting = false
+
+    if (this.ws) {
+      this.ws.onopen = null
+      this.ws.onmessage = null
+      this.ws.onclose = null
+      this.ws.onerror = null
+
+      if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {
+        this.ws.close(1001, 'Reconnect')
+      }
+
+      this.ws = null
+    }
+  }
+
+  // 转换连接状态为文本描述
+  private getReadyStateText(state: number): string {
+    switch (state) {
+      case WebSocket.CONNECTING:
+        return 'CONNECTING (0) - 正在连接'
+      case WebSocket.OPEN:
+        return 'OPEN (1) - 已连接'
+      case WebSocket.CLOSING:
+        return 'CLOSING (2) - 正在关闭'
+      case WebSocket.CLOSED:
+        return 'CLOSED (3) - 已关闭'
+      default:
+        return `未知状态 (${state})`
+    }
+  }
+
+  // 开始心跳检测
+  private startHeartbeat(): void {
+    this.clearTimer('detectionTimer')
+    this.clearTimer('timeoutTimer')
+
+    this.detectionTimer = setTimeout(() => {
+      this.isConnected = this.ws?.readyState === WebSocket.OPEN
+
+      if (!this.isConnected) {
+        console.warn('WebSocket心跳检测失败，尝试重连')
+        this.reconnect()
+
+        this.timeoutTimer = setTimeout(() => {
+          console.warn('WebSocket重连超时')
+          this.close()
+        }, this.reconnectTimeout)
+      }
+    }, this.heartbeatInterval)
+  }
+
+  // 重置心跳检测
+  private resetHeartbeat(): void {
+    this.clearTimer('detectionTimer')
+    this.clearTimer('timeoutTimer')
+    this.startHeartbeat()
+  }
+
+  // 开始发送ping消息
+  private startPing(): void {
+    this.clearTimer('pingTimer')
+
+    this.pingTimer = setInterval(() => {
+      if (this.ws?.readyState !== WebSocket.OPEN) {
+        console.warn('WebSocket未连接，停止发送ping')
+        this.clearTimer('pingTimer')
+        this.reconnect()
+        return
+      }
+
+      try {
+        this.ws.send('ping')
+        console.log('发送ping消息')
+      } catch (error) {
+        console.error('发送ping消息失败:', error)
+        this.clearTimer('pingTimer')
+        this.reconnect()
+      }
+    }, this.pingInterval)
+  }
+
+  // 重连 - 增加重连次数限制
+  private reconnect(): void {
+    if (this.stopReconnect || this.isConnecting || this.reconnectInterval <= 0) {
+      return
+    }
+
+    // 检查是否超过最大重连次数
+    if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+      console.error(`已达到最大重连次数(${this.maxReconnectAttempts})，停止重连`)
+      this.close(true)
+      return
+    }
+
+    this.reconnectAttempts++
+    this.isReconnecting = true
+    this.closeCurrentSocketForReconnect()
+
+    const delay = this.calculateReconnectDelay()
+    console.log(
+      `将在${delay / 1000}秒后尝试重新连接（第${this.reconnectAttempts}/${this.maxReconnectAttempts}次）`
+    )
+
+    this.clearTimer('reconnectTimer')
+    this.reconnectTimer = setTimeout(() => {
+      console.log(`尝试重新连接WebSocket（第${this.reconnectAttempts}次）`)
+      this.connect(false)
+    }, delay)
+  }
+
+  // 计算重连延迟 - 指数退避策略
+  private calculateReconnectDelay(): number {
+    // 基础延迟 + 随机值，避免多个客户端同时重连
+    const jitter = Math.random() * 1000 // 0-1秒的随机延迟
+    const baseDelay = Math.min(
+      this.reconnectInterval * Math.pow(1.5, this.reconnectAttempts - 1),
+      this.reconnectInterval * 5
+    )
+    return baseDelay + jitter
+  }
+
+  // 清除指定定时器
+  private clearTimer(
+    timerName:
+      | 'detectionTimer'
+      | 'timeoutTimer'
+      | 'reconnectTimer'
+      | 'pingTimer'
+      | 'connectionTimer'
+  ): void {
+    if (this[timerName]) {
+      clearTimeout(this[timerName] as NodeJS.Timeout)
+      this[timerName] = null
+    }
+  }
+
+  // 清除所有定时器
+  private clearAllTimers(): void {
+    this.clearConnectionTimers()
+    this.clearTimer('reconnectTimer')
+  }
+
+  private clearConnectionTimers(): void {
+    this.clearTimer('detectionTimer')
+    this.clearTimer('timeoutTimer')
+    this.clearTimer('pingTimer')
+    this.clearTimer('connectionTimer')
+  }
+
+  // 获取当前连接状态
+  get isWebSocketConnected(): boolean {
+    return this.isConnected
+  }
+
+  // 获取当前连接状态文本
+  get connectionStatusText(): string {
+    if (this.isConnecting) return '正在连接'
+    if (this.isConnected) return '已连接'
+    if (this.isReconnecting && this.reconnectAttempts > 0)
+      return `重连中（${this.reconnectAttempts}/${this.maxReconnectAttempts}）`
+    return '已断开'
+  }
+
+  // 销毁实例
+  static destroyInstance(): void {
+    if (WebSocketClient.instance) {
+      WebSocketClient.instance.close()
+      WebSocketClient.instance = null
+    }
+  }
+}
diff --git a/web/src/utils/storage/index.ts b/web/src/utils/storage/index.ts
new file mode 100644
index 0000000..a4366f0
--- /dev/null
+++ b/web/src/utils/storage/index.ts
@@ -0,0 +1,7 @@
+/**
+ * 存储相关工具函数统一导出
+ */
+
+export * from './storage'
+export * from './storage-config'
+export * from './storage-key-manager'
diff --git a/web/src/utils/storage/storage-config.ts b/web/src/utils/storage/storage-config.ts
new file mode 100644
index 0000000..c53b489
--- /dev/null
+++ b/web/src/utils/storage/storage-config.ts
@@ -0,0 +1,125 @@
+/**
+ * 存储配置管理模块
+ *
+ * 提供统一的本地存储配置和工具方法
+ *
+ * ## 主要功能
+ *
+ * - 版本化存储键管理，支持多版本数据隔离
+ * - 存储键名生成和解析（带版本前缀）
+ * - 版本号提取和验证
+ * - 存储键匹配的正则表达式生成
+ * - 旧版本存储键兼容处理
+ * - 升级和登出延迟配置
+ * - 主题存储键配置
+ *
+ * ## 使用场景
+ *
+ * - Pinia Store 持久化存储
+ * - 应用版本升级时的数据迁移
+ * - 多版本数据清理
+ * - 存储键的统一管理和规范
+ *
+ * 存储键格式：sys-v{version}-{storeId}
+ * 例如：sys-v1.0.0-user, sys-v1.0.0-setting
+ *
+ * @module utils/storage/storage-config
+ * @author Art Design Pro Team
+ */
+export class StorageConfig {
+  /** 当前应用版本 */
+  static readonly CURRENT_VERSION = __APP_VERSION__
+
+  /** 存储键前缀 */
+  static readonly STORAGE_PREFIX = 'sys-v'
+
+  /** 版本键名 */
+  static readonly VERSION_KEY = 'sys-version'
+
+  /** 主题键名（index.html中使用了，如果修改，需要同步修改） */
+  static readonly THEME_KEY = 'sys-theme'
+
+  /** 上次登录用户ID键名（用于判断是否为同一用户登录） */
+  static readonly LAST_USER_ID_KEY = 'sys-last-user-id'
+
+  /** 响应式布局切换时暂存桌面端菜单类型 */
+  static readonly RESPONSIVE_MENU_TYPE_KEY = 'sys-responsive-menu-type'
+
+  /** 跳过升级检查的版本 */
+  static readonly SKIP_UPGRADE_VERSION = '1.0.0'
+
+  /** 升级处理延迟时间（毫秒） */
+  static readonly UPGRADE_DELAY = 1000
+
+  /** 登出延迟时间（毫秒） */
+  static readonly LOGOUT_DELAY = 1000
+
+  /**
+   * 生成版本化的存储键名
+   * @param storeId 存储ID
+   * @param version 版本号，默认使用当前版本
+   */
+  static generateStorageKey(storeId: string, version: string = this.CURRENT_VERSION): string {
+    return `${this.STORAGE_PREFIX}${version}-${storeId}`
+  }
+
+  /**
+   * 生成旧版本的存储键名（不带分隔符）
+   * @param version 版本号，默认使用当前版本
+   */
+  static generateLegacyKey(version: string = this.CURRENT_VERSION): string {
+    return `${this.STORAGE_PREFIX}${version}`
+  }
+
+  /**
+   * 创建存储键匹配的正则表达式
+   * @param storeId 存储ID
+   */
+  static createKeyPattern(storeId: string): RegExp {
+    return new RegExp(`^${this.STORAGE_PREFIX}[^-]+-${storeId}$`)
+  }
+
+  /**
+   * 创建当前版本存储键匹配的正则表达式
+   */
+  static createCurrentVersionPattern(): RegExp {
+    return new RegExp(`^${this.STORAGE_PREFIX}${this.CURRENT_VERSION}-`)
+  }
+
+  /**
+   * 创建任意版本存储键匹配的正则表达式
+   */
+  static createVersionPattern(): RegExp {
+    return new RegExp(`^${this.STORAGE_PREFIX}`)
+  }
+
+  /**
+   * 检查是否为当前版本的键
+   */
+  static isCurrentVersionKey(key: string): boolean {
+    return key.startsWith(`${this.STORAGE_PREFIX}${this.CURRENT_VERSION}`)
+  }
+
+  /**
+   * 检查是否为版本化的键
+   */
+  static isVersionedKey(key: string): boolean {
+    return key.startsWith(this.STORAGE_PREFIX)
+  }
+
+  /**
+   * 从存储键中提取版本号
+   */
+  static extractVersionFromKey(key: string): string | null {
+    const match = key.match(new RegExp(`^${this.STORAGE_PREFIX}([^-]+)`))
+    return match ? match[1] : null
+  }
+
+  /**
+   * 从存储键中提取存储ID
+   */
+  static extractStoreIdFromKey(key: string): string | null {
+    const match = key.match(new RegExp(`^${this.STORAGE_PREFIX}[^-]+-(.+)$`))
+    return match ? match[1] : null
+  }
+}
diff --git a/web/src/utils/storage/storage-key-manager.ts b/web/src/utils/storage/storage-key-manager.ts
new file mode 100644
index 0000000..ba14f65
--- /dev/null
+++ b/web/src/utils/storage/storage-key-manager.ts
@@ -0,0 +1,97 @@
+/**
+ * 存储键名管理器模块
+ *
+ * 提供智能的版本化存储键管理和数据迁移功能
+ *
+ * ## 主要功能
+ *
+ * - 自动生成当前版本的存储键名
+ * - 检测当前版本数据是否存在
+ * - 查找其他版本的同名存储数据
+ * - 自动将旧版本数据迁移到当前版本
+ * - 数据迁移日志记录
+ * - 迁移失败的错误处理
+ *
+ * ## 使用场景
+ *
+ * - Pinia Store 持久化插件中获取存储键
+ * - 应用版本升级时自动迁移用户数据
+ * - 避免版本升级导致的数据丢失
+ * - 实现平滑的版本过渡
+ *
+ * ## 工作流程
+ *
+ * 1. 优先使用当前版本的存储键
+ * 2. 如果当前版本无数据，查找其他版本的同名数据
+ * 3. 找到旧版本数据后自动迁移到当前版本
+ * 4. 返回当前版本的存储键供使用
+ *
+ * @module utils/storage/storage-key-manager
+ * @author Art Design Pro Team
+ */
+import { StorageConfig } from '@/utils/storage'
+
+/**
+ * 存储键名管理器
+ * 负责处理版本化的存储键名生成和数据迁移
+ */
+export class StorageKeyManager {
+  /**
+   * 获取当前版本的存储键名
+   */
+  private getCurrentVersionKey(storeId: string): string {
+    return StorageConfig.generateStorageKey(storeId)
+  }
+
+  /**
+   * 检查当前版本的数据是否存在
+   */
+  private hasCurrentVersionData(key: string): boolean {
+    return localStorage.getItem(key) !== null
+  }
+
+  /**
+   * 查找其他版本的同名存储键
+   */
+  private findExistingKey(storeId: string): string | null {
+    const storageKeys = Object.keys(localStorage)
+    const pattern = StorageConfig.createKeyPattern(storeId)
+
+    return storageKeys.find((key) => pattern.test(key) && localStorage.getItem(key)) || null
+  }
+
+  /**
+   * 将数据从旧版本迁移到当前版本
+   */
+  private migrateData(fromKey: string, toKey: string): void {
+    try {
+      const existingData = localStorage.getItem(fromKey)
+      if (existingData) {
+        localStorage.setItem(toKey, existingData)
+        console.info(`[Storage] 已迁移数据: ${fromKey} → ${toKey}`)
+      }
+    } catch (error) {
+      console.warn(`[Storage] 数据迁移失败: ${fromKey}`, error)
+    }
+  }
+
+  /**
+   * 获取持久化存储的键名（支持自动数据迁移）
+   */
+  getStorageKey(storeId: string): string {
+    const currentKey = this.getCurrentVersionKey(storeId)
+
+    // 优先使用当前版本的数据
+    if (this.hasCurrentVersionData(currentKey)) {
+      return currentKey
+    }
+
+    // 查找并迁移其他版本的数据
+    const existingKey = this.findExistingKey(storeId)
+    if (existingKey) {
+      this.migrateData(existingKey, currentKey)
+    }
+
+    return currentKey
+  }
+}
diff --git a/web/src/utils/storage/storage.ts b/web/src/utils/storage/storage.ts
new file mode 100644
index 0000000..9ad8835
--- /dev/null
+++ b/web/src/utils/storage/storage.ts
@@ -0,0 +1,251 @@
+/**
+ * 存储兼容性管理模块
+ *
+ * 提供完整的本地存储兼容性检查和数据验证功能
+ *
+ * 主要功能
+ *
+ * - 多版本存储数据检测和验证
+ * - 新旧存储格式兼容处理
+ * - 存储数据完整性校验
+ * - 存储异常自动恢复（清理+登出）
+ * - 登录状态验证
+ * - 存储为空检测
+ * - 版本号管理
+ *
+ * ## 使用场景
+ *
+ * - 应用启动时检查存储数据有效性
+ * - 路由守卫中验证登录状态
+ * - 版本升级时的数据兼容性检查
+ * - 存储异常时的自动恢复
+ * - 防止因存储数据损坏导致的系统异常
+ *
+ * ## 工作流程
+ *
+ * 1. 优先检查当前版本的存储数据
+ * 2. 检查其他版本的存储数据
+ * 3. 兼容旧格式的存储数据
+ * 4. 验证数据完整性
+ * 5. 异常时提示用户并执行登出
+ *
+ * @module utils/storage/storage
+ * @author Art Design Pro Team
+ */
+import { router } from '@/router'
+import { useUserStore } from '@/store/modules/user'
+import { StorageConfig } from '@/utils/storage/storage-config'
+import { $t } from '@/locales'
+
+/**
+ * 存储兼容性管理器
+ * 负责处理不同版本间的存储兼容性检查和数据验证
+ */
+class StorageCompatibilityManager {
+  /**
+   * 获取系统版本号
+   */
+  getSystemVersion(): string | null {
+    return localStorage.getItem(StorageConfig.VERSION_KEY)
+  }
+
+  /**
+   * 获取系统存储数据（兼容旧格式）
+   */
+  getSystemStorage(): any {
+    const version = this.getSystemVersion() || StorageConfig.CURRENT_VERSION
+    const legacyKey = StorageConfig.generateLegacyKey(version)
+    const data = localStorage.getItem(legacyKey)
+    return data ? JSON.parse(data) : null
+  }
+
+  /**
+   * 检查当前版本是否有存储数据
+   */
+  private hasCurrentVersionStorage(): boolean {
+    const storageKeys = Object.keys(localStorage)
+    const currentVersionPattern = StorageConfig.createCurrentVersionPattern()
+
+    return storageKeys.some(
+      (key) => currentVersionPattern.test(key) && localStorage.getItem(key) !== null
+    )
+  }
+
+  /**
+   * 检查是否存在任何版本的存储数据
+   */
+  private hasAnyVersionStorage(): boolean {
+    const storageKeys = Object.keys(localStorage)
+    const versionPattern = StorageConfig.createVersionPattern()
+
+    return storageKeys.some((key) => versionPattern.test(key) && localStorage.getItem(key) !== null)
+  }
+
+  /**
+   * 获取旧格式的本地存储数据
+   */
+  private getLegacyStorageData(): Record<string, any> {
+    try {
+      const systemStorage = this.getSystemStorage()
+      return systemStorage || {}
+    } catch (error) {
+      console.warn('[Storage] 解析旧格式存储数据失败:', error)
+      return {}
+    }
+  }
+
+  /**
+   * 显示存储错误消息
+   */
+  private showStorageError(): void {
+    ElMessage({
+      type: 'error',
+      offset: 40,
+      duration: 5000,
+      message: $t('common.storageError')
+    })
+  }
+
+  /**
+   * 执行系统登出
+   */
+  private performSystemLogout(): void {
+    setTimeout(() => {
+      try {
+        localStorage.clear()
+        useUserStore().logOut()
+        router.push({ name: 'Login' })
+        console.info('[Storage] 已执行系统登出')
+      } catch (error) {
+        console.error('[Storage] 系统登出失败:', error)
+      }
+    }, StorageConfig.LOGOUT_DELAY)
+  }
+
+  /**
+   * 处理存储异常
+   */
+  private handleStorageError(): void {
+    this.showStorageError()
+    this.performSystemLogout()
+  }
+
+  /**
+   * 验证存储数据完整性
+   * @param requireAuth 是否需要验证登录状态（默认 false）
+   */
+  validateStorageData(requireAuth: boolean = false): boolean {
+    try {
+      // 优先检查新版本存储结构
+      if (this.hasCurrentVersionStorage()) {
+        // console.debug('[Storage] 发现当前版本存储数据')
+        return true
+      }
+
+      // 检查是否有任何版本的存储数据
+      if (this.hasAnyVersionStorage()) {
+        // console.debug('[Storage] 发现其他版本存储数据，可能需要迁移')
+        return true
+      }
+
+      // 检查旧版本存储结构
+      const legacyData = this.getLegacyStorageData()
+      if (Object.keys(legacyData).length === 0) {
+        // 只有在需要验证登录状态时才执行登出操作
+        if (requireAuth) {
+          console.warn('[Storage] 未发现任何存储数据，需要重新登录')
+          this.performSystemLogout()
+          return false
+        }
+        // 首次访问或访问静态路由，不需要登出
+        // console.debug('[Storage] 未发现存储数据，首次访问或访问静态路由')
+        return true
+      }
+
+      console.debug('[Storage] 发现旧版本存储数据')
+      return true
+    } catch (error) {
+      console.error('[Storage] 存储数据验证失败:', error)
+      // 只有在需要验证登录状态时才处理错误
+      if (requireAuth) {
+        this.handleStorageError()
+        return false
+      }
+      return true
+    }
+  }
+
+  /**
+   * 检查存储是否为空
+   */
+  isStorageEmpty(): boolean {
+    // 检查新版本存储结构
+    if (this.hasCurrentVersionStorage()) {
+      return false
+    }
+
+    // 检查是否有任何版本的存储数据
+    if (this.hasAnyVersionStorage()) {
+      return false
+    }
+
+    // 检查旧版本存储结构
+    const legacyData = this.getLegacyStorageData()
+    return Object.keys(legacyData).length === 0
+  }
+
+  /**
+   * 检查存储兼容性
+   * @param requireAuth 是否需要验证登录状态（默认 false）
+   */
+  checkCompatibility(requireAuth: boolean = false): boolean {
+    try {
+      const isValid = this.validateStorageData(requireAuth)
+      const isEmpty = this.isStorageEmpty()
+
+      if (isValid || isEmpty) {
+        // console.debug('[Storage] 存储兼容性检查通过')
+        return true
+      }
+
+      console.warn('[Storage] 存储兼容性检查失败')
+      return false
+    } catch (error) {
+      console.error('[Storage] 兼容性检查异常:', error)
+      return false
+    }
+  }
+}
+
+// 创建存储兼容性管理器实例
+const storageManager = new StorageCompatibilityManager()
+
+/**
+ * 获取系统存储数据
+ */
+export function getSystemStorage(): any {
+  return storageManager.getSystemStorage()
+}
+
+/**
+ * 获取系统版本号
+ */
+export function getSysVersion(): string | null {
+  return storageManager.getSystemVersion()
+}
+
+/**
+ * 验证本地存储数据
+ * @param requireAuth 是否需要验证登录状态（默认 false）
+ */
+export function validateStorageData(requireAuth: boolean = false): boolean {
+  return storageManager.validateStorageData(requireAuth)
+}
+
+/**
+ * 检查存储兼容性
+ * @param requireAuth 是否需要验证登录状态（默认 false）
+ */
+export function checkStorageCompatibility(requireAuth: boolean = false): boolean {
+  return storageManager.checkCompatibility(requireAuth)
+}
diff --git a/web/src/utils/sys/console.ts b/web/src/utils/sys/console.ts
new file mode 100644
index 0000000..d631087
--- /dev/null
+++ b/web/src/utils/sys/console.ts
@@ -0,0 +1,13 @@
+// ANSI 转义码生成网站  https://patorjk.com/software/taag/#p=display&f=Big&t=ABB%0A
+const asciiArt = `
+\x1b[32m欢迎使用 Art Design Pro！
+\x1b[0m
+\x1b[36m哇！你居然在用我的项目～ 好用的话别忘了去 GitHub 点个 ★Star 呀，你的支持就是我更新的超强动力！祝使用体验满分💯
+\x1b[0m
+\x1b[33mGitHub: https://github.com/Daymychen/art-design-pro
+\x1b[0m
+\x1b[31m技术支持（QQ群）: 1038930070，和开发者一起交流～ 群里有小伙伴实时答疑，遇到问题不用慌！
+\x1b[0m
+`
+
+console.log(asciiArt)
diff --git a/web/src/utils/sys/error-handle.ts b/web/src/utils/sys/error-handle.ts
new file mode 100644
index 0000000..bc966c9
--- /dev/null
+++ b/web/src/utils/sys/error-handle.ts
@@ -0,0 +1,143 @@
+/**
+ * 全局错误处理模块
+ *
+ * 提供统一的错误捕获和处理机制
+ *
+ * ## 主要功能
+ *
+ * - Vue 运行时错误捕获（组件错误、生命周期错误等）
+ * - 全局脚本错误捕获（语法错误、运行时错误等）
+ * - Promise 未捕获错误处理（unhandledrejection）
+ * - 静态资源加载错误监控（图片、脚本、样式等）
+ * - 错误日志记录和上报
+ * - 统一的错误处理入口
+ *
+ * ## 使用场景
+ * - 应用启动时安装全局错误处理器
+ * - 捕获和记录所有类型的错误
+ * - 错误上报到监控平台
+ * - 提升应用稳定性和可维护性
+ * - 问题排查和调试
+ *
+ * ## 错误类型
+ *
+ * - VueError: Vue 组件相关错误
+ * - ScriptError: JavaScript 脚本错误
+ * - PromiseError: Promise 未捕获的 rejection
+ * - ResourceError: 静态资源加载失败
+ *
+ * @module utils/sys/error-handle
+ * @author Art Design Pro Team
+ */
+import type { App } from 'vue'
+
+const IGNORABLE_SCRIPT_ERRORS = [
+  'ResizeObserver loop completed with undelivered notifications.',
+  'ResizeObserver loop limit exceeded'
+]
+
+function normalizeErrorMessage(message: Event | string): string {
+  if (typeof message === 'string') {
+    return message
+  }
+
+  if ('message' in message && typeof message.message === 'string') {
+    return message.message
+  }
+
+  return ''
+}
+
+function isIgnorableScriptError(message: Event | string, source?: string): boolean {
+  const normalizedMessage = normalizeErrorMessage(message)
+
+  if (!normalizedMessage) {
+    return false
+  }
+
+  if (IGNORABLE_SCRIPT_ERRORS.some((item) => normalizedMessage.includes(item))) {
+    // 浏览器/扩展在布局抖动时常见的 ResizeObserver 噪声，不作为真实异常处理
+    return true
+  }
+
+  // 浏览器扩展注入脚本偶发的跨域 Script error 也没有排查价值
+  if (normalizedMessage === 'Script error.' && source === '') {
+    return true
+  }
+
+  return false
+}
+
+/**
+ * Vue 运行时错误处理
+ */
+export function vueErrorHandler(err: unknown, instance: any, info: string) {
+  console.error('[VueError]', err, info, instance)
+  // 这里可以上报到服务端，比如：
+  // reportError({ type: 'vue', err, info })
+}
+
+/**
+ * 全局脚本错误处理
+ */
+export function scriptErrorHandler(
+  message: Event | string,
+  source?: string,
+  lineno?: number,
+  colno?: number,
+  error?: Error
+): boolean {
+  if (isIgnorableScriptError(message, source)) {
+    return true
+  }
+
+  console.error('[ScriptError]', { message, source, lineno, colno, error })
+  // reportError({ type: 'script', message, source, lineno, colno, error })
+  return true // 阻止默认控制台报错，可根据需求改
+}
+
+/**
+ * Promise 未捕获错误处理
+ */
+export function registerPromiseErrorHandler() {
+  window.addEventListener('unhandledrejection', (event) => {
+    console.error('[PromiseError]', event.reason)
+    // reportError({ type: 'promise', reason: event.reason })
+  })
+}
+
+/**
+ * 资源加载错误处理 (img, script, css...)
+ */
+export function registerResourceErrorHandler() {
+  window.addEventListener(
+    'error',
+    (event: Event) => {
+      const target = event.target as HTMLElement
+      if (
+        target &&
+        (target.tagName === 'IMG' || target.tagName === 'SCRIPT' || target.tagName === 'LINK')
+      ) {
+        console.error('[ResourceError]', {
+          tagName: target.tagName,
+          src:
+            (target as HTMLImageElement).src ||
+            (target as HTMLScriptElement).src ||
+            (target as HTMLLinkElement).href
+        })
+        // reportError({ type: 'resource', target })
+      }
+    },
+    true // 捕获阶段才能监听到资源错误
+  )
+}
+
+/**
+ * 安装统一错误处理
+ */
+export function setupErrorHandle(app: App) {
+  app.config.errorHandler = vueErrorHandler
+  window.onerror = scriptErrorHandler
+  registerPromiseErrorHandler()
+  registerResourceErrorHandler()
+}
diff --git a/web/src/utils/sys/index.ts b/web/src/utils/sys/index.ts
new file mode 100644
index 0000000..a2e0729
--- /dev/null
+++ b/web/src/utils/sys/index.ts
@@ -0,0 +1,6 @@
+/**
+ * 系统管理相关工具函数统一导出
+ */
+
+export * from './upgrade'
+export { default as mittBus } from './mittBus'
diff --git a/web/src/utils/sys/mittBus.ts b/web/src/utils/sys/mittBus.ts
new file mode 100644
index 0000000..22f0108
--- /dev/null
+++ b/web/src/utils/sys/mittBus.ts
@@ -0,0 +1,63 @@
+/**
+ * 全局事件总线模块
+ *
+ * 基于 mitt 库实现的类型安全的事件总线
+ *
+ * ## 主要功能
+ *
+ * - 跨组件通信（发布/订阅模式）
+ * - 类型安全的事件定义和调用
+ * - 全局事件管理（烟花效果、设置面板、搜索对话框等）
+ * - 解耦组件间的直接依赖
+ *
+ * ## 使用场景
+ *
+ * - 跨层级组件通信
+ * - 全局功能触发（设置、搜索、聊天、锁屏等）
+ * - 特效触发（烟花效果）
+ * - 避免 props 层层传递
+ *
+ * ## 用法示例
+ *
+ * ```typescript
+ * // 订阅事件
+ * mittBus.on('openSetting', () => { ... })
+ *
+ * // 发布事件
+ * mittBus.emit('openSetting')
+ *
+ * // 带参数的事件
+ * mittBus.emit('triggerFireworks', 'image-url')
+ * ```
+ *
+ * ## 已定义的事件
+ *
+ * - triggerFireworks: 触发烟花效果（可选图片URL）
+ * - openSetting: 打开设置面板
+ * - openSearchDialog: 打开搜索对话框
+ * - openChat: 打开聊天窗口
+ * - openLockScreen: 打开锁屏
+ *
+ * @module utils/sys/mittBus
+ * @author Art Design Pro Team
+ */
+import mitt, { type Emitter } from 'mitt'
+
+// 定义事件类型映射
+type Events = {
+  // 烟花效果事件 - 可选的图片URL参数
+  triggerFireworks: string | undefined
+  // 打开设置面板事件 - 无参数
+  openSetting: void
+  // 打开搜索对话框事件 - 无参数
+  openSearchDialog: void
+  // 打开聊天窗口事件 - 无参数
+  openChat: void
+  // 打开锁屏事件 - 无参数
+  openLockScreen: void
+}
+
+// 创建类型安全的事件总线实例
+const mittBus: Emitter<Events> = mitt<Events>()
+
+export default mittBus
diff --git a/web/src/utils/sys/upgrade.ts b/web/src/utils/sys/upgrade.ts
new file mode 100644
index 0000000..16957ef
--- /dev/null
+++ b/web/src/utils/sys/upgrade.ts
@@ -0,0 +1,278 @@
+/**
+ * 系统版本升级管理模块
+ *
+ * 提供完整的应用版本升级检测和处理功能
+ *
+ * ## 主要功能
+ *
+ * - 版本号比较和升级检测
+ * - 首次访问识别和处理
+ * - 旧版本数据自动清理
+ * - 升级日志展示和通知
+ * - 强制重新登录控制（根据升级日志配置）
+ * - 版本号规范化处理
+ * - 旧存储结构迁移和清理
+ * - 升级流程延迟执行（确保应用完全加载）
+ *
+ * ## 使用场景
+ *
+ * - 应用启动时自动检测版本升级
+ * - 版本更新后清理旧数据
+ * - 向用户展示版本更新内容
+ * - 重大更新时要求用户重新登录
+ * - 防止旧版本数据污染新版本
+ *
+ * ## 工作流程
+ *
+ * 1. 检查本地存储的版本号
+ * 2. 与当前应用版本对比
+ * 3. 查找并清理旧版本数据
+ * 4. 展示升级通知（包含更新日志）
+ * 5. 根据配置决定是否强制重新登录
+ * 6. 更新本地版本号
+ *
+ * @module utils/sys/upgrade
+ * @author Art Design Pro Team
+ */
+import { upgradeLogList } from '@/mock/upgrade/changeLog'
+import { ElNotification } from 'element-plus'
+import { useUserStore } from '@/store/modules/user'
+import { StorageConfig } from '@/utils/storage/storage-config'
+import { $t } from '@/locales'
+
+/**
+ * 版本管理器
+ * 负责处理版本比较、升级检测和数据清理
+ */
+class VersionManager {
+  /**
+   * 规范化版本号字符串，移除前缀 'v'
+   */
+  private normalizeVersion(version: string): string {
+    return version.replace(/^v/, '')
+  }
+
+  /**
+   * 获取存储的版本号
+   */
+  private getStoredVersion(): string | null {
+    return localStorage.getItem(StorageConfig.VERSION_KEY)
+  }
+
+  /**
+   * 设置版本号到存储
+   */
+  private setStoredVersion(version: string): void {
+    localStorage.setItem(StorageConfig.VERSION_KEY, version)
+  }
+
+  /**
+   * 检查是否应该跳过升级处理
+   */
+  private shouldSkipUpgrade(): boolean {
+    return StorageConfig.CURRENT_VERSION === StorageConfig.SKIP_UPGRADE_VERSION
+  }
+
+  /**
+   * 检查是否为首次访问
+   */
+  private isFirstVisit(storedVersion: string | null): boolean {
+    return !storedVersion
+  }
+
+  /**
+   * 检查版本是否相同
+   */
+  private isSameVersion(storedVersion: string): boolean {
+    return storedVersion === StorageConfig.CURRENT_VERSION
+  }
+
+  /**
+   * 查找旧的存储结构
+   */
+  private findLegacyStorage(): { oldSysKey: string | null; oldVersionKeys: string[] } {
+    const storageKeys = Object.keys(localStorage)
+    const currentVersionPrefix = StorageConfig.generateStorageKey('').slice(0, -1) // 移除末尾的 '-'
+
+    // 查找旧的单一存储结构
+    const oldSysKey =
+      storageKeys.find(
+        (key) =>
+          StorageConfig.isVersionedKey(key) && key !== currentVersionPrefix && !key.includes('-')
+      ) || null
+
+    // 查找旧版本的分离存储键
+    const oldVersionKeys = storageKeys.filter(
+      (key) =>
+        StorageConfig.isVersionedKey(key) &&
+        !StorageConfig.isCurrentVersionKey(key) &&
+        key.includes('-')
+    )
+
+    return { oldSysKey, oldVersionKeys }
+  }
+
+  /**
+   * 检查是否需要重新登录
+   */
+  private shouldRequireReLogin(storedVersion: string): boolean {
+    const normalizedCurrent = this.normalizeVersion(StorageConfig.CURRENT_VERSION)
+    const normalizedStored = this.normalizeVersion(storedVersion)
+
+    return upgradeLogList.value.some((item) => {
+      const itemVersion = this.normalizeVersion(item.version)
+      return (
+        item.requireReLogin && itemVersion > normalizedStored && itemVersion <= normalizedCurrent
+      )
+    })
+  }
+
+  /**
+   * 构建升级通知消息
+   */
+  private buildUpgradeMessage(requireReLogin: boolean): string {
+    const { title: content } = upgradeLogList.value[0]
+
+    const messageParts = [
+      `<p style="color: var(--art-gray-800) !important; padding-bottom: 5px;">`,
+      `${$t('common.systemUpgradedPrefix')} ${StorageConfig.CURRENT_VERSION} ${$t('common.systemUpgradedSuffix')}`,
+      `</p>`,
+      content
+    ]
+
+    if (requireReLogin) {
+      messageParts.push(
+        `<p style="color: var(--theme-color); padding-top: 5px;">${$t('common.upgradeReLogin')}</p>`
+      )
+    }
+
+    return messageParts.join('')
+  }
+
+  /**
+   * 显示升级通知
+   */
+  private showUpgradeNotification(message: string): void {
+    ElNotification({
+      title: '系统升级公告',
+      message,
+      duration: 0,
+      type: 'success',
+      dangerouslyUseHTMLString: true
+    })
+  }
+
+  /**
+   * 清理旧版本数据
+   */
+  private cleanupLegacyData(oldSysKey: string | null, oldVersionKeys: string[]): void {
+    // 清理旧的单一存储结构
+    if (oldSysKey) {
+      localStorage.removeItem(oldSysKey)
+      console.info(`[Upgrade] 已清理旧存储: ${oldSysKey}`)
+    }
+
+    // 清理旧版本的分离存储
+    oldVersionKeys.forEach((key) => {
+      localStorage.removeItem(key)
+      console.info(`[Upgrade] 已清理旧存储: ${key}`)
+    })
+  }
+
+  /**
+   * 执行升级后的登出操作
+   */
+  private performLogout(): void {
+    try {
+      useUserStore().logOut()
+      console.info('[Upgrade] 已执行升级后登出')
+    } catch (error) {
+      console.error('[Upgrade] 升级后登出失败:', error)
+    }
+  }
+
+  /**
+   * 执行升级流程
+   */
+  private async executeUpgrade(
+    storedVersion: string,
+    legacyStorage: ReturnType<typeof this.findLegacyStorage>
+  ): Promise<void> {
+    try {
+      if (!upgradeLogList.value.length) {
+        console.warn('[Upgrade] 升级日志列表为空')
+        return
+      }
+
+      const requireReLogin = this.shouldRequireReLogin(storedVersion)
+      const message = this.buildUpgradeMessage(requireReLogin)
+
+      // 显示升级通知
+      this.showUpgradeNotification(message)
+
+      // 更新版本号
+      this.setStoredVersion(StorageConfig.CURRENT_VERSION)
+
+      // 清理旧数据
+      this.cleanupLegacyData(legacyStorage.oldSysKey, legacyStorage.oldVersionKeys)
+
+      // 执行登出（如果需要）
+      if (requireReLogin) {
+        this.performLogout()
+      }
+
+      console.info(`[Upgrade] 升级完成: ${storedVersion} → ${StorageConfig.CURRENT_VERSION}`)
+    } catch (error) {
+      console.error('[Upgrade] 系统升级处理失败:', error)
+    }
+  }
+
+  /**
+   * 系统升级处理主流程
+   */
+  async processUpgrade(): Promise<void> {
+    // 跳过特定版本
+    if (this.shouldSkipUpgrade()) {
+      console.debug('[Upgrade] 跳过版本升级检查')
+      return
+    }
+
+    const storedVersion = this.getStoredVersion()
+
+    // 首次访问处理
+    if (this.isFirstVisit(storedVersion)) {
+      this.setStoredVersion(StorageConfig.CURRENT_VERSION)
+      // console.info('[Upgrade] 首次访问，已设置当前版本')
+      return
+    }
+
+    // 版本相同，无需升级
+    if (this.isSameVersion(storedVersion!)) {
+      // console.debug('[Upgrade] 版本相同，无需升级')
+      return
+    }
+
+    // 检查是否有需要升级的旧数据
+    const legacyStorage = this.findLegacyStorage()
+    if (!legacyStorage.oldSysKey && legacyStorage.oldVersionKeys.length === 0) {
+      this.setStoredVersion(StorageConfig.CURRENT_VERSION)
+      console.info('[Upgrade] 无旧数据，已更新版本号')
+      return
+    }
+
+    // 延迟执行升级流程，确保应用已完全加载
+    setTimeout(() => {
+      this.executeUpgrade(storedVersion!, legacyStorage)
+    }, StorageConfig.UPGRADE_DELAY)
+  }
+}
+
+// 创建版本管理器实例
+const versionManager = new VersionManager()
+
+/**
+ * 系统升级处理入口函数
+ */
+export async function systemUpgrade(): Promise<void> {
+  await versionManager.processUpgrade()
+}
diff --git a/web/src/utils/table/tableCache.ts b/web/src/utils/table/tableCache.ts
new file mode 100644
index 0000000..045a7ce
--- /dev/null
+++ b/web/src/utils/table/tableCache.ts
@@ -0,0 +1,266 @@
+/**
+ * 表格缓存管理模块
+ *
+ * 提供高性能的表格数据缓存机制
+ *
+ * ## 主要功能
+ *
+ * - 基于参数的智能缓存键生成（使用 ohash）
+ * - LRU（最近最少使用）缓存淘汰策略
+ * - 缓存过期时间管理
+ * - 缓存大小限制和自动清理
+ * - 基于标签的缓存分组管理
+ * - 多种缓存失效策略（清空所有、清空当前、清空分页等）
+ * - 缓存访问统计和命中率分析
+ * - 缓存大小估算
+ *
+ * ## 使用场景
+ *
+ * - 表格数据的分页缓存
+ * - 减少重复的 API 请求
+ * - 提升表格切换和返回的响应速度
+ * - 搜索条件变化时的智能缓存管理
+ * - 数据更新后的缓存失效处理
+ *
+ * ## 缓存策略
+ *
+ * - CLEAR_ALL: 清空所有缓存（适用于全局数据更新）
+ * - CLEAR_CURRENT: 仅清空当前查询条件的缓存（适用于单条数据更新）
+ * - CLEAR_PAGINATION: 清空所有分页缓存但保留不同搜索条件（适用于批量操作）
+ * - KEEP_ALL: 不清除缓存（适用于只读操作）
+ *
+ * @module utils/table/tableCache
+ * @author Art Design Pro Team
+ */
+import { hash } from 'ohash'
+
+// 缓存失效策略枚举
+export enum CacheInvalidationStrategy {
+  /** 清空所有缓存 */
+  CLEAR_ALL = 'clear_all',
+  /** 仅清空当前查询条件的缓存 */
+  CLEAR_CURRENT = 'clear_current',
+  /** 清空所有分页缓存（保留不同搜索条件的缓存） */
+  CLEAR_PAGINATION = 'clear_pagination',
+  /** 不清除缓存 */
+  KEEP_ALL = 'keep_all'
+}
+
+// 通用 API 响应接口（兼容不同的后端响应格式）
+export interface ApiResponse<T = unknown> {
+  records?: T[]
+  data?: T[]
+  total?: number
+  current?: number
+  size?: number
+  [key: string]: unknown
+}
+
+// 缓存存储接口
+export interface CacheItem<T> {
+  data: T[]
+  response: ApiResponse<T>
+  timestamp: number
+  params: string
+  // 缓存标签，用于分组管理
+  tags: Set<string>
+  // 访问次数（用于 LRU 算法）
+  accessCount: number
+  // 最后访问时间
+  lastAccessTime: number
+}
+
+// 增强的缓存管理类
+export class TableCache<T> {
+  private cache = new Map<string, CacheItem<T>>()
+  private cacheTime: number
+  private maxSize: number
+  private enableLog: boolean
+
+  constructor(cacheTime = 5 * 60 * 1000, maxSize = 50, enableLog = false) {
+    // 默认5分钟，最多50条缓存
+    this.cacheTime = cacheTime
+    this.maxSize = maxSize
+    this.enableLog = enableLog
+  }
+
+  // 内部日志工具
+  private log(message: string, ...args: any[]) {
+    if (this.enableLog) {
+      console.log(`[TableCache] ${message}`, ...args)
+    }
+  }
+
+  // 生成稳定的缓存键
+  private generateKey(params: unknown): string {
+    return hash(params)
+  }
+
+  // 🔧 优化：增强类型安全性
+  private generateTags(params: Record<string, unknown>): Set<string> {
+    const tags = new Set<string>()
+
+    // 添加搜索条件标签
+    const searchKeys = Object.keys(params).filter(
+      (key) =>
+        !['current', 'size', 'total'].includes(key) &&
+        params[key] !== undefined &&
+        params[key] !== '' &&
+        params[key] !== null
+    )
+
+    if (searchKeys.length > 0) {
+      const searchTag = searchKeys.map((key) => `${key}:${String(params[key])}`).join('|')
+      tags.add(`search:${searchTag}`)
+    } else {
+      tags.add('search:default')
+    }
+
+    // 添加分页标签
+    tags.add(`pagination:${params.size || 10}`)
+    // 添加通用分页标签，用于清理所有分页缓存
+    tags.add('pagination')
+
+    return tags
+  }
+
+  // 🔧 优化：LRU 缓存清理
+  private evictLRU(): void {
+    if (this.cache.size <= this.maxSize) return
+
+    // 找到最少使用的缓存项
+    let lruKey = ''
+    let minAccessCount = Infinity
+    let oldestTime = Infinity
+
+    for (const [key, item] of this.cache.entries()) {
+      if (
+        item.accessCount < minAccessCount ||
+        (item.accessCount === minAccessCount && item.lastAccessTime < oldestTime)
+      ) {
+        lruKey = key
+        minAccessCount = item.accessCount
+        oldestTime = item.lastAccessTime
+      }
+    }
+
+    if (lruKey) {
+      this.cache.delete(lruKey)
+      this.log(`LRU 清理缓存: ${lruKey}`)
+    }
+  }
+
+  // 设置缓存
+  set(params: unknown, data: T[], response: ApiResponse<T>): void {
+    const key = this.generateKey(params)
+    const tags = this.generateTags(params as Record<string, unknown>)
+    const now = Date.now()
+
+    // 检查是否需要清理
+    this.evictLRU()
+
+    this.cache.set(key, {
+      data,
+      response,
+      timestamp: now,
+      params: key,
+      tags,
+      accessCount: 1,
+      lastAccessTime: now
+    })
+  }
+
+  // 获取缓存
+  get(params: unknown): CacheItem<T> | null {
+    const key = this.generateKey(params)
+    const item = this.cache.get(key)
+
+    if (!item) return null
+
+    // 检查是否过期
+    if (Date.now() - item.timestamp > this.cacheTime) {
+      this.cache.delete(key)
+      return null
+    }
+
+    // 更新访问统计
+    item.accessCount++
+    item.lastAccessTime = Date.now()
+
+    return item
+  }
+
+  // 根据标签清除缓存
+  clearByTags(tags: string[]): number {
+    let clearedCount = 0
+
+    for (const [key, item] of this.cache.entries()) {
+      // 检查是否包含任意一个标签
+      const hasMatchingTag = tags.some((tag) =>
+        Array.from(item.tags).some((itemTag) => itemTag.includes(tag))
+      )
+
+      if (hasMatchingTag) {
+        this.cache.delete(key)
+        clearedCount++
+      }
+    }
+
+    return clearedCount
+  }
+
+  // 清除当前搜索条件的缓存
+  clearCurrentSearch(params: unknown): number {
+    const key = this.generateKey(params)
+    const deleted = this.cache.delete(key)
+    return deleted ? 1 : 0
+  }
+
+  // 清除分页缓存
+  clearPagination(): number {
+    return this.clearByTags(['pagination'])
+  }
+
+  // 清空所有缓存
+  clear(): void {
+    this.cache.clear()
+  }
+
+  // 获取缓存统计信息
+  getStats(): { total: number; size: string; hitRate: string } {
+    const total = this.cache.size
+    let totalSize = 0
+    let totalAccess = 0
+
+    for (const item of this.cache.values()) {
+      // 粗略估算大小（JSON字符串长度）
+      totalSize += JSON.stringify(item.data).length
+      totalAccess += item.accessCount
+    }
+
+    // 转换为人类可读的大小
+    const sizeInKB = (totalSize / 1024).toFixed(2)
+    const avgHits = total > 0 ? (totalAccess / total).toFixed(1) : '0'
+
+    return {
+      total,
+      size: `${sizeInKB}KB`,
+      hitRate: `${avgHits} avg hits`
+    }
+  }
+
+  // 清理过期缓存
+  cleanupExpired(): number {
+    let cleanedCount = 0
+    const now = Date.now()
+
+    for (const [key, item] of this.cache.entries()) {
+      if (now - item.timestamp > this.cacheTime) {
+        this.cache.delete(key)
+        cleanedCount++
+      }
+    }
+
+    return cleanedCount
+  }
+}
diff --git a/web/src/utils/table/tableConfig.ts b/web/src/utils/table/tableConfig.ts
new file mode 100644
index 0000000..e464c89
--- /dev/null
+++ b/web/src/utils/table/tableConfig.ts
@@ -0,0 +1,55 @@
+/**
+ * 表格全局配置模块
+ *
+ * 提供表格与后端接口的字段映射配置
+ *
+ * ## 主要功能
+ *
+ * - 响应数据字段自动识别和映射
+ * - 支持多种常见的后端响应格式
+ * - 请求参数字段映射配置
+ * - 可扩展的字段配置机制
+ *
+ * ## 使用场景
+ *
+ * - 适配不同后端的分页接口格式
+ * - 统一前端表格组件的数据处理
+ * - 减少重复的数据转换代码
+ * - 支持多个后端服务的接口对接
+ *
+ * ## 配置说明
+ *
+ * - recordFields: 列表数据字段名（按优先级顺序查找）
+ * - totalFields: 总条数字段名
+ * - currentFields: 当前页码字段名
+ * - sizeFields: 每页大小字段名
+ * - paginationKey: 前端发送请求时使用的分页参数名
+ *
+ * ## 扩展方式
+ *
+ * 如果后端使用其他字段名，可以在对应数组中添加新的字段名
+ * 例如：recordFields: ['list', 'data', 'records', 'items', 'yourCustomField']
+ *
+ * @module utils/table/tableConfig
+ * @author Art Design Pro Team
+ */
+export const tableConfig = {
+  // 响应数据字段映射配置，系统会从接口返回数据中按顺序查找这些字段
+  // 列表数据
+  recordFields: ['list', 'data', 'records', 'items', 'result', 'rows'],
+  // 总条数
+  totalFields: ['total', 'count'],
+  // 当前页码
+  currentFields: ['current', 'page', 'pageNum'],
+  // 每页大小
+  sizeFields: ['size', 'pageSize', 'limit'],
+
+  // 请求参数映射配置，前端发送请求时使用的分页参数名
+  // useTable 组合式函数传递分页参数的时候 用 current 跟 size
+  paginationKey: {
+    // 当前页码
+    current: 'current',
+    // 每页大小
+    size: 'size'
+  }
+}
diff --git a/web/src/utils/table/tableUtils.ts b/web/src/utils/table/tableUtils.ts
new file mode 100644
index 0000000..e1ed197
--- /dev/null
+++ b/web/src/utils/table/tableUtils.ts
@@ -0,0 +1,298 @@
+/**
+ * 表格工具函数模块
+ *
+ * 提供表格数据处理和请求管理的核心工具函数
+ *
+ * ## 主要功能
+ *
+ * - 多格式 API 响应自动适配和标准化
+ * - 表格数据提取和转换
+ * - 分页信息自动更新和校验
+ * - 智能防抖函数（支持取消和立即执行）
+ * - 统一的错误处理机制
+ * - 嵌套数据结构解析
+ *
+ * ## 使用场景
+ *
+ * - useTable 组合式函数的底层工具
+ * - 适配各种后端接口响应格式
+ * - 表格数据的标准化处理
+ * - 请求防抖和性能优化
+ * - 错误统一处理和日志记录
+ *
+ * ## 支持的响应格式
+ *
+ * 1. 直接数组: [item1, item2, ...]
+ * 2. 标准对象: { records: [], total: 100 }
+ * 3. 嵌套data: { data: { list: [], total: 100 } }
+ * 4. 多种字段名: list/data/records/items/result/rows
+ *
+ * ## 核心功能
+ *
+ * - defaultResponseAdapter: 智能识别和转换响应格式
+ * - extractTableData: 提取表格数据数组
+ * - updatePaginationFromResponse: 更新分页信息
+ * - createSmartDebounce: 创建可控的防抖函数
+ * - createErrorHandler: 生成错误处理器
+ *
+ * @module utils/table/tableUtils
+ * @author Art Design Pro Team
+ */
+
+import type { ApiResponse } from './tableCache'
+import { tableConfig } from './tableConfig'
+import { $t } from '@/locales'
+
+// 请求参数基础接口，扩展分页参数
+export interface BaseRequestParams extends Api.Common.PaginationParams {
+  [key: string]: unknown
+}
+
+// 错误处理接口
+export interface TableError {
+  code: string
+  message: string
+  details?: unknown
+}
+
+// 辅助函数：从对象中提取记录数组
+function extractRecords<T>(obj: Record<string, unknown>, fields: string[]): T[] {
+  for (const field of fields) {
+    if (field in obj && Array.isArray(obj[field])) {
+      return obj[field] as T[]
+    }
+  }
+  return []
+}
+
+// 辅助函数：从对象中提取总数
+function extractTotal(obj: Record<string, unknown>, records: unknown[], fields: string[]): number {
+  for (const field of fields) {
+    if (field in obj && typeof obj[field] === 'number') {
+      return obj[field] as number
+    }
+  }
+  return records.length
+}
+
+// 辅助函数：提取分页参数
+function extractPagination(
+  obj: Record<string, unknown>,
+  data?: Record<string, unknown>
+): Pick<ApiResponse<unknown>, 'current' | 'size'> | undefined {
+  const result: Partial<Pick<ApiResponse<unknown>, 'current' | 'size'>> = {}
+  const sources = [obj, data ?? {}]
+
+  const currentFields = tableConfig.currentFields
+  for (const src of sources) {
+    for (const field of currentFields) {
+      if (field in src && typeof src[field] === 'number') {
+        result.current = src[field] as number
+        break
+      }
+    }
+    if (result.current !== undefined) break
+  }
+
+  const sizeFields = tableConfig.sizeFields
+  for (const src of sources) {
+    for (const field of sizeFields) {
+      if (field in src && typeof src[field] === 'number') {
+        result.size = src[field] as number
+        break
+      }
+    }
+    if (result.size !== undefined) break
+  }
+
+  if (result.current === undefined && result.size === undefined) return undefined
+  return result
+}
+
+/**
+ * 默认响应适配器 - 支持多种常见的API响应格式
+ */
+export const defaultResponseAdapter = <T>(response: unknown): ApiResponse<T> => {
+  // 定义支持的字段
+  const recordFields = tableConfig.recordFields
+
+  if (!response) {
+    return { records: [], total: 0 }
+  }
+
+  if (Array.isArray(response)) {
+    return { records: response, total: response.length }
+  }
+
+  if (typeof response !== 'object') {
+    console.warn(
+      '[tableUtils] 无法识别的响应格式，支持的格式包括: 数组、包含' +
+        recordFields.join('/') +
+        '字段的对象、嵌套data对象。当前格式:',
+      response
+    )
+    return { records: [], total: 0 }
+  }
+
+  const res = response as Record<string, unknown>
+  let records: T[] = []
+  let total = 0
+  let pagination: Pick<ApiResponse<unknown>, 'current' | 'size'> | undefined
+
+  // 处理标准格式或直接列表
+  records = extractRecords(res, recordFields)
+  total = extractTotal(res, records, tableConfig.totalFields)
+  pagination = extractPagination(res)
+
+  // 如果没有找到，检查嵌套data
+  if (records.length === 0 && 'data' in res && typeof res.data === 'object') {
+    const data = res.data as Record<string, unknown>
+    records = extractRecords(data, ['list', 'records', 'items'])
+    total = extractTotal(data, records, tableConfig.totalFields)
+    pagination = extractPagination(res, data)
+
+    if (Array.isArray(res.data)) {
+      records = res.data as T[]
+      total = records.length
+    }
+  }
+
+  if (!recordFields.some((field) => field in res) && records.length === 0) {
+    console.warn('[tableUtils] 无法识别的响应格式')
+    console.warn('支持的字段包括: ' + recordFields.join('、'), response)
+    console.warn('扩展字段请到 utils/table/tableConfig 文件配置')
+  }
+
+  const result: ApiResponse<T> = { records, total }
+  if (pagination) {
+    Object.assign(result, pagination)
+  }
+  return result
+}
+
+/**
+ * 从标准化的API响应中提取表格数据
+ */
+export const extractTableData = <T>(response: ApiResponse<T>): T[] => {
+  const data = response.records || response.data || []
+  return Array.isArray(data) ? data : []
+}
+
+/**
+ * 根据API响应更新分页信息
+ */
+export const updatePaginationFromResponse = <T>(
+  pagination: Api.Common.PaginationParams,
+  response: ApiResponse<T>
+): void => {
+  pagination.total = response.total ?? pagination.total ?? 0
+
+  if (response.current !== undefined) {
+    pagination.current = response.current
+  }
+
+  const maxPage = Math.max(1, Math.ceil(pagination.total / (pagination.size || 1)))
+  if (pagination.current > maxPage) {
+    pagination.current = maxPage
+  }
+}
+
+/**
+ * 创建智能防抖函数 - 支持取消和立即执行
+ */
+export const createSmartDebounce = <T extends (...args: any[]) => Promise<any>>(
+  fn: T,
+  delay: number
+): T & { cancel: () => void; flush: () => Promise<any> } => {
+  let timeoutId: NodeJS.Timeout | null = null
+  let lastArgs: Parameters<T> | null = null
+  let lastResolve: ((value: any) => void) | null = null
+  let lastReject: ((reason: any) => void) | null = null
+
+  const debouncedFn = (...args: Parameters<T>): Promise<any> => {
+    return new Promise((resolve, reject) => {
+      if (timeoutId) clearTimeout(timeoutId)
+      lastArgs = args
+      lastResolve = resolve
+      lastReject = reject
+      timeoutId = setTimeout(async () => {
+        try {
+          const result = await fn(...args)
+          resolve(result)
+        } catch (error) {
+          reject(error)
+        } finally {
+          timeoutId = null
+          lastArgs = null
+          lastResolve = null
+          lastReject = null
+        }
+      }, delay)
+    })
+  }
+
+  debouncedFn.cancel = () => {
+    if (timeoutId) clearTimeout(timeoutId)
+    timeoutId = null
+    lastArgs = null
+    lastResolve = null
+    lastReject = null
+  }
+
+  debouncedFn.flush = async () => {
+    if (timeoutId && lastArgs && lastResolve && lastReject) {
+      clearTimeout(timeoutId)
+      timeoutId = null
+      const args = lastArgs
+      const resolve = lastResolve
+      const reject = lastReject
+      lastArgs = null
+      lastResolve = null
+      lastReject = null
+      try {
+        const result = await fn(...args)
+        resolve(result)
+        return result
+      } catch (error) {
+        reject(error)
+        throw error
+      }
+    }
+    return Promise.resolve()
+  }
+
+  return debouncedFn as any
+}
+
+/**
+ * 生成错误处理函数
+ */
+export const createErrorHandler = (
+  onError?: (error: TableError) => void,
+  enableLog: boolean = false
+) => {
+  const logger = {
+    error: (message: string, ...args: any[]) => {
+      if (enableLog) console.error(`[useTable] ${message}`, ...args)
+    }
+  }
+
+  return (err: unknown, context: string): TableError => {
+    const tableError: TableError = {
+      code: 'UNKNOWN_ERROR',
+      message: $t('common.unknownError'),
+      details: err
+    }
+
+    if (err instanceof Error) {
+      tableError.message = err.message
+      tableError.code = err.name
+    } else if (typeof err === 'string') {
+      tableError.message = err
+    }
+
+    logger.error(`${context}:`, err)
+    onError?.(tableError)
+    return tableError
+  }
+}
diff --git a/web/src/utils/ui/animation.ts b/web/src/utils/ui/animation.ts
new file mode 100644
index 0000000..5efd02a
--- /dev/null
+++ b/web/src/utils/ui/animation.ts
@@ -0,0 +1,80 @@
+/**
+ * 主题动画工具模块
+ *
+ * 提供主题切换的视觉动画效果
+ *
+ * ## 主要功能
+ *
+ * - 基于鼠标点击位置的圆形扩散动画
+ * - View Transition API 支持（现代浏览器）
+ * - 降级处理（不支持动画的浏览器）
+ * - 暗黑主题切换过渡效果
+ * - 页面刷新时的主题过渡优化
+ *
+ * ## 使用场景
+ *
+ * - 明暗主题切换
+ * - 提升用户体验的视觉反馈
+ * - 页面刷新时的平滑过渡
+ *
+ * ## 技术实现
+ *
+ * - 使用 CSS 变量存储点击位置和半径
+ * - 利用 View Transition API 实现流畅动画
+ * - 通过 CSS class 控制过渡效果
+ * - 自动计算最大扩散半径
+ *
+ * @module utils/theme/animation
+ * @author Art Design Pro Team
+ */
+import { useCommon } from '@/hooks/core/useCommon'
+import { useTheme } from '@/hooks/core/useTheme'
+import { SystemThemeEnum } from '@/enums/appEnum'
+import { useSettingStore } from '@/store/modules/setting'
+const { LIGHT, DARK } = SystemThemeEnum
+
+/**
+ * 主题切换动画
+ * @param e 鼠标点击事件
+ */
+export const themeAnimation = (e: any) => {
+  const x = e.clientX
+  const y = e.clientY
+  // 计算鼠标点击位置距离视窗的最大圆半径
+  const endRadius = Math.hypot(Math.max(x, innerWidth - x), Math.max(y, innerHeight - y))
+
+  // 设置CSS变量
+  document.documentElement.style.setProperty('--x', x + 'px')
+  document.documentElement.style.setProperty('--y', y + 'px')
+  document.documentElement.style.setProperty('--r', endRadius + 'px')
+
+  if (document.startViewTransition) {
+    document.startViewTransition(() => toggleTheme())
+  } else {
+    toggleTheme()
+  }
+}
+
+/**
+ * 切换主题
+ */
+const toggleTheme = () => {
+  useTheme().switchThemeStyles(useSettingStore().systemThemeType === LIGHT ? DARK : LIGHT)
+  useCommon().refresh()
+}
+
+/**
+ * 切换主题过渡效果
+ * @param enable 是否启用过渡效果
+ */
+export const toggleTransition = (enable: boolean) => {
+  const body = document.body
+
+  if (enable) {
+    body.classList.add('theme-change')
+  } else {
+    setTimeout(() => {
+      body.classList.remove('theme-change')
+    }, 300)
+  }
+}
diff --git a/web/src/utils/ui/colors.ts b/web/src/utils/ui/colors.ts
new file mode 100755
index 0000000..56480c3
--- /dev/null
+++ b/web/src/utils/ui/colors.ts
@@ -0,0 +1,274 @@
+/**
+ * 颜色处理工具模块
+ *
+ * 提供完整的颜色格式转换和处理功能
+ *
+ * ## 主要功能
+ *
+ * - Hex 与 RGB/RGBA 格式互转
+ * - 颜色混合计算
+ * - 颜色变浅/变深处理
+ * - Element Plus 主题色自动生成
+ * - 颜色格式验证
+ * - CSS 变量读取
+ * - 暗黑模式颜色适配
+ *
+ * ## 使用场景
+ *
+ * - 主题色动态切换
+ * - Element Plus 组件主题定制
+ * - 颜色渐变生成
+ * - 明暗主题颜色计算
+ * - 颜色格式标准化
+ *
+ * ## 核心功能
+ *
+ * - hexToRgba: Hex 转 RGBA（支持透明度）
+ * - hexToRgb: Hex 转 RGB 数组
+ * - rgbToHex: RGB 转 Hex
+ * - colourBlend: 两种颜色混合
+ * - getLightColor: 生成变浅的颜色
+ * - getDarkColor: 生成变深的颜色
+ * - handleElementThemeColor: 处理 Element Plus 主题色
+ * - setElementThemeColor: 设置完整的主题色系统
+ *
+ * ## 支持格式
+ *
+ * - Hex: #FFF, #FFFFFF
+ * - RGB: rgb(255, 255, 255)
+ * - RGBA: rgba(255, 255, 255, 0.5)
+ *
+ * @module utils/ui/colors
+ * @author Art Design Pro Team
+ */
+import { useSettingStore } from '@/store/modules/setting'
+import { $t } from '@/locales'
+
+/**
+ * 颜色转换结果接口
+ */
+interface RgbaResult {
+  red: number
+  green: number
+  blue: number
+  rgba: string
+}
+
+/**
+ * 获取CSS变量值（别名函数）
+ * @param name CSS变量名
+ * @returns CSS变量值
+ */
+export function getCssVar(name: string): string {
+  return getComputedStyle(document.documentElement).getPropertyValue(name)
+}
+
+/**
+ * 验证hex颜色格式
+ * @param hex hex颜色值
+ * @returns 是否为有效的hex颜色
+ */
+function isValidHexColor(hex: string): boolean {
+  const cleanHex = hex.trim().replace(/^#/, '')
+  return /^[0-9A-Fa-f]{3}$|^[0-9A-Fa-f]{6}$/.test(cleanHex)
+}
+
+/**
+ * 验证RGB颜色值
+ * @param r 红色值
+ * @param g 绿色值
+ * @param b 蓝色值
+ * @returns 是否为有效的RGB值
+ */
+function isValidRgbValue(r: number, g: number, b: number): boolean {
+  const isValid = (value: number) => Number.isInteger(value) && value >= 0 && value <= 255
+  return isValid(r) && isValid(g) && isValid(b)
+}
+
+/**
+ * 将hex颜色转换为RGBA
+ * @param hex hex颜色值 (支持 #FFF 或 #FFFFFF 格式)
+ * @param opacity 透明度 (0-1)
+ * @returns 包含RGB值和RGBA字符串的对象
+ */
+export function hexToRgba(hex: string, opacity: number): RgbaResult {
+  if (!isValidHexColor(hex)) {
+    throw new Error('Invalid hex color format')
+  }
+
+  // 移除可能存在的 # 前缀并转换为大写
+  let cleanHex = hex.trim().replace(/^#/, '').toUpperCase()
+
+  // 如果是缩写形式（如 FFF），转换为完整形式
+  if (cleanHex.length === 3) {
+    cleanHex = cleanHex
+      .split('')
+      .map((char) => char.repeat(2))
+      .join('')
+  }
+
+  // 解析 RGB 值
+  const [red, green, blue] = cleanHex.match(/\w\w/g)!.map((x) => parseInt(x, 16))
+
+  // 确保 opacity 在有效范围内
+  const validOpacity = Math.max(0, Math.min(1, opacity))
+
+  // 构建 RGBA 字符串
+  const rgba = `rgba(${red}, ${green}, ${blue}, ${validOpacity.toFixed(2)})`
+
+  return { red, green, blue, rgba }
+}
+
+/**
+ * 将hex颜色转换为RGB数组
+ * @param hexColor hex颜色值
+ * @returns RGB数组 [r, g, b]
+ */
+export function hexToRgb(hexColor: string): number[] {
+  if (!isValidHexColor(hexColor)) {
+    ElMessage.warning($t('common.invalidHexColor'))
+    throw new Error('Invalid hex color format')
+  }
+
+  const cleanHex = hexColor.replace(/^#/, '')
+  let hex = cleanHex
+
+  // 处理缩写形式
+  if (hex.length === 3) {
+    hex = hex
+      .split('')
+      .map((char) => char.repeat(2))
+      .join('')
+  }
+
+  const hexPairs = hex.match(/../g)
+  if (!hexPairs) {
+    throw new Error('Invalid hex color format')
+  }
+
+  return hexPairs.map((hexPair) => parseInt(hexPair, 16))
+}
+
+/**
+ * 将RGB颜色转换为hex
+ * @param r 红色值 (0-255)
+ * @param g 绿色值 (0-255)
+ * @param b 蓝色值 (0-255)
+ * @returns hex颜色值
+ */
+export function rgbToHex(r: number, g: number, b: number): string {
+  if (!isValidRgbValue(r, g, b)) {
+    ElMessage.warning($t('common.invalidRgbColor'))
+    throw new Error('Invalid RGB color values')
+  }
+
+  const toHex = (value: number) => {
+    const hex = value.toString(16)
+    return hex.length === 1 ? `0${hex}` : hex
+  }
+
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`
+}
+
+/**
+ * 颜色混合
+ * @param color1 第一个颜色
+ * @param color2 第二个颜色
+ * @param ratio 混合比例 (0-1)
+ * @returns 混合后的颜色
+ */
+export function colourBlend(color1: string, color2: string, ratio: number): string {
+  const validRatio = Math.max(0, Math.min(1, Number(ratio)))
+
+  const rgb1 = hexToRgb(color1)
+  const rgb2 = hexToRgb(color2)
+
+  const blendedRgb = rgb1.map((value1, index) => {
+    const value2 = rgb2[index]
+    return Math.round(value1 * (1 - validRatio) + value2 * validRatio)
+  })
+
+  return rgbToHex(blendedRgb[0], blendedRgb[1], blendedRgb[2])
+}
+
+/**
+ * 获取变浅的颜色
+ * @param color 原始颜色
+ * @param level 变浅程度 (0-1)
+ * @param isDark 是否为暗色主题
+ * @returns 变浅后的颜色
+ */
+export function getLightColor(color: string, level: number, isDark: boolean = false): string {
+  if (!isValidHexColor(color)) {
+    ElMessage.warning($t('common.invalidHexColor'))
+    throw new Error('Invalid hex color format')
+  }
+
+  if (isDark) {
+    return getDarkColor(color, level)
+  }
+
+  const rgb = hexToRgb(color)
+  const lightRgb = rgb.map((value) => Math.floor((255 - value) * level + value))
+
+  return rgbToHex(lightRgb[0], lightRgb[1], lightRgb[2])
+}
+
+/**
+ * 获取变深的颜色
+ * @param color 原始颜色
+ * @param level 变深程度 (0-1)
+ * @returns 变深后的颜色
+ */
+export function getDarkColor(color: string, level: number): string {
+  if (!isValidHexColor(color)) {
+    ElMessage.warning($t('common.invalidHexColor'))
+    throw new Error('Invalid hex color format')
+  }
+
+  const rgb = hexToRgb(color)
+  const darkRgb = rgb.map((value) => Math.floor(value * (1 - level)))
+
+  return rgbToHex(darkRgb[0], darkRgb[1], darkRgb[2])
+}
+
+/**
+ * 处理 Element Plus 主题颜色
+ * @param theme 主题颜色
+ * @param isDark 是否为暗色主题
+ */
+export function handleElementThemeColor(theme: string, isDark: boolean = false): void {
+  document.documentElement.style.setProperty('--el-color-primary', theme)
+
+  for (let i = 1; i <= 9; i++) {
+    document.documentElement.style.setProperty(
+      `--el-color-primary-light-${i}`,
+      getLightColor(theme, i / 10, isDark)
+    )
+  }
+
+  for (let i = 1; i <= 9; i++) {
+    document.documentElement.style.setProperty(
+      `--el-color-primary-dark-${i}`,
+      getDarkColor(theme, i / 10)
+    )
+  }
+}
+
+/**
+ * 设置 Element Plus 主题颜色
+ * @param color 主题颜色
+ */
+export function setElementThemeColor(color: string): void {
+  const mixColor = '#ffffff'
+  const elStyle = document.documentElement.style
+
+  elStyle.setProperty('--el-color-primary', color)
+  handleElementThemeColor(color, useSettingStore().isDark)
+
+  // 生成更淡一点的颜色
+  for (let i = 1; i < 16; i++) {
+    const itemColor = colourBlend(color, mixColor, i / 16)
+    elStyle.setProperty(`--el-color-primary-custom-${i}`, itemColor)
+  }
+}
diff --git a/web/src/utils/ui/emojo.ts b/web/src/utils/ui/emojo.ts
new file mode 100644
index 0000000..cabad7d
--- /dev/null
+++ b/web/src/utils/ui/emojo.ts
@@ -0,0 +1,24 @@
+/**
+ * 表情
+ * 用于在消息提示的时候显示对应的表情
+ *
+ * 用法
+ * ElMessage.success(`${EmojiText[200]} 图片上传成功`)
+ * ElMessage.error(`${EmojiText[400]} 图片上传失败`)
+ * ElMessage.error(`${EmojiText[500]} 图片上传失败`)
+ *
+ * @module utils/ui/emojo
+ * @author Art Design Pro Team
+ */
+
+// macos 用户 按 shift + 6 可以唤出更多表情……
+const EmojiText: { [key: string]: string } = {
+  '0': 'O_O', // 空
+  '200': '^_^', // 成功
+  '400': 'T_T', // 错误请求
+  '500': 'X_X' // 服务器内部错误，无法完成请求
+}
+
+// const EmojiIcon = ['🟢', '🔴', '🟡 ', '🚀', '✨', '💡', '🛠️', '🔥', '🎉', '🌟', '🌈']
+
+export default EmojiText
diff --git a/web/src/utils/ui/iconify-loader.ts b/web/src/utils/ui/iconify-loader.ts
new file mode 100644
index 0000000..035de16
--- /dev/null
+++ b/web/src/utils/ui/iconify-loader.ts
@@ -0,0 +1,31 @@
+/**
+ * 离线图标加载器
+ *
+ * 用于在内网环境下支持 Iconify 图标的离线加载。
+ * 通过预加载图标集数据，避免运行时从 CDN 获取图标。
+ *
+ * 使用方式：
+ * 1. 安装所需图标集：pnpm add -D @iconify-json/[icon-set-name]
+ * 2. 在此文件中导入并注册图标集
+ * 3. 在组件中使用：<ArtSvgIcon icon="ri:home-line" />
+ *
+ * @module utils/ui/iconify-loader
+ * @author Art Design Pro Team
+ */
+
+// import { addCollection } from '@iconify/vue'
+
+// // 导入离线图标数据
+
+// // 系统必要图标库
+// import riIcons from '@iconify-json/ri/icons.json'
+
+// // 演示图标库（可选，生产环境可移除）
+// import svgSpinners from '@iconify-json/svg-spinners/icons.json'
+// import lineMd from '@iconify-json/line-md/icons.json'
+
+// // 注册离线图标集
+
+// addCollection(riIcons)
+// addCollection(svgSpinners)
+// addCollection(lineMd)
diff --git a/web/src/utils/ui/index.ts b/web/src/utils/ui/index.ts
new file mode 100644
index 0000000..9ca1049
--- /dev/null
+++ b/web/src/utils/ui/index.ts
@@ -0,0 +1,11 @@
+/**
+ * UI 相关工具函数统一导出
+ *
+ * @module utils/ui/index
+ * @author Art Design Pro Team
+ */
+
+export * from './colors'
+export * from './loading'
+export * from './tabs'
+export * from './emojo'
diff --git a/web/src/utils/ui/loading.ts b/web/src/utils/ui/loading.ts
new file mode 100644
index 0000000..6580e02
--- /dev/null
+++ b/web/src/utils/ui/loading.ts
@@ -0,0 +1,84 @@
+/**
+ * 全局 Loading 加载管理模块
+ *
+ * 提供统一的全屏加载动画管理
+ *
+ * ## 主要功能
+ *
+ * - 全屏 Loading 显示和隐藏
+ * - 自动适配明暗主题背景色
+ * - 自定义 SVG 加载动画
+ * - 单例模式防止重复创建
+ * - 锁定页面交互
+ *
+ * ## 使用场景
+ *
+ * - 页面初始化加载
+ * - 大量数据请求
+ * - 路由切换过渡
+ * - 异步操作等待
+ *
+ * ## 特性
+ *
+ * - 自动检测当前主题并应用对应背景色
+ * - 使用自定义 SVG 动画（四点旋转）
+ * - 单例模式确保同时只有一个 Loading
+ * - 提供便捷的显示/隐藏方法
+ *
+ * @module utils/ui/loading
+ * @author Art Design Pro Team
+ */
+import { fourDotsSpinnerSvg } from '@/assets/svg/loading'
+
+/**
+ * 获取当前主题对应的loading背景色
+ * @returns 背景色字符串
+ */
+const getLoadingBackground = (): string => {
+  const isDark = document.documentElement.classList.contains('dark')
+  return isDark ? 'rgba(7, 7, 7, 0.85)' : '#fff'
+}
+
+const DEFAULT_LOADING_CONFIG = {
+  lock: true,
+  get background() {
+    return getLoadingBackground()
+  },
+  svg: fourDotsSpinnerSvg,
+  svgViewBox: '0 0 40 40',
+  customClass: 'art-loading-fix'
+} as const
+
+interface LoadingInstance {
+  close: () => void
+}
+
+let loadingInstance: LoadingInstance | null = null
+
+export const loadingService = {
+  /**
+   * 显示 loading
+   * @returns 关闭 loading 的函数
+   */
+  showLoading(): () => void {
+    if (!loadingInstance) {
+      // 每次显示时获取最新的配置，确保背景色与当前主题同步
+      const config = {
+        ...DEFAULT_LOADING_CONFIG,
+        background: getLoadingBackground()
+      }
+      loadingInstance = ElLoading.service(config)
+    }
+    return () => this.hideLoading()
+  },
+
+  /**
+   * 隐藏 loading
+   */
+  hideLoading(): void {
+    if (loadingInstance) {
+      loadingInstance.close()
+      loadingInstance = null
+    }
+  }
+}
diff --git a/web/src/utils/ui/tabs.ts b/web/src/utils/ui/tabs.ts
new file mode 100644
index 0000000..5f53ea5
--- /dev/null
+++ b/web/src/utils/ui/tabs.ts
@@ -0,0 +1,60 @@
+/**
+ * 标签页布局配置模块
+ *
+ * 提供不同标签页样式的高度和间距配置
+ *
+ * ## 主要功能
+ *
+ * - 多种标签页样式配置（默认、卡片、谷歌风格）
+ * - 标签页打开/关闭状态的高度管理
+ * - 顶部间距自动计算
+ * - 配置获取和默认值处理
+ *
+ * ## 使用场景
+ *
+ * - 工作标签页（Worktab）布局计算
+ * - 页面内容区域高度调整
+ * - 标签页显示/隐藏时的动画
+ * - 响应式布局适配
+ *
+ * ## 配置项说明
+ *
+ * - openTop: 标签页显示时，内容区域距离顶部的距离
+ * - closeTop: 标签页隐藏时，内容区域距离顶部的距离
+ * - openHeight: 标签页显示时的总高度（包含标签栏）
+ * - closeHeight: 标签页隐藏时的总高度（仅头部）
+ *
+ * ## 支持的样式
+ *
+ * - tab-default: 默认标签页样式
+ * - tab-card: 卡片式标签页
+ * - tab-google: 谷歌浏览器风格标签页
+ *
+ * @module utils/ui/tabs
+ * @author Art Design Pro Team
+ */
+export const TAB_CONFIG = {
+  'tab-default': {
+    openTop: 106,
+    closeTop: 60,
+    openHeight: 121,
+    closeHeight: 75
+  },
+  'tab-card': {
+    openTop: 122,
+    closeTop: 78,
+    openHeight: 139,
+    closeHeight: 95
+  },
+  'tab-google': {
+    openTop: 122,
+    closeTop: 78,
+    openHeight: 139,
+    closeHeight: 95
+  }
+}
+
+// 获取当前 tab 样式配置，设置默认值
+export const getTabConfig = (style: string) => {
+  return TAB_CONFIG[style as keyof typeof TAB_CONFIG] || TAB_CONFIG['tab-card'] // 默认使用 tab-card 配置
+}
diff --git a/web/src/views/auth/forget-password/index.vue b/web/src/views/auth/forget-password/index.vue
new file mode 100644
index 0000000..cfb389e
--- /dev/null
+++ b/web/src/views/auth/forget-password/index.vue
@@ -0,0 +1,64 @@
+<template>
+  <div class="flex w-full h-screen">
+    <LoginLeftView />
+
+    <div class="relative flex-1">
+      <AuthTopBar />
+
+      <div class="auth-right-wrap">
+        <div class="form">
+          <h3 class="title">{{ $t('forgetPassword.title') }}</h3>
+          <p class="sub-title">{{ $t('forgetPassword.subTitle') }}</p>
+          <div class="mt-5">
+            <span class="input-label" v-if="showInputLabel">{{
+              $t('forgetPassword.accountLabel')
+            }}</span>
+            <ElInput
+              class="custom-height"
+              :placeholder="$t('forgetPassword.placeholder')"
+              v-model.trim="username"
+            />
+          </div>
+
+          <div style="margin-top: 15px">
+            <ElButton
+              class="w-full custom-height"
+              type="primary"
+              @click="register"
+              :loading="loading"
+              v-ripple
+            >
+              {{ $t('forgetPassword.submitBtnText') }}
+            </ElButton>
+          </div>
+
+          <div style="margin-top: 15px">
+            <ElButton class="w-full custom-height" plain @click="toLogin">
+              {{ $t('forgetPassword.backBtnText') }}
+            </ElButton>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'ForgetPassword' })
+
+  const router = useRouter()
+  const showInputLabel = ref(false)
+
+  const username = ref('')
+  const loading = ref(false)
+
+  const register = async () => {}
+
+  const toLogin = () => {
+    router.push({ name: 'Login' })
+  }
+</script>
+
+<style scoped>
+  @import '../login/style.css';
+</style>
diff --git a/web/src/views/auth/login/index.vue b/web/src/views/auth/login/index.vue
new file mode 100755
index 0000000..713a77e
--- /dev/null
+++ b/web/src/views/auth/login/index.vue
@@ -0,0 +1,226 @@
+<!-- 登录页面 -->
+<template>
+  <div class="flex w-full h-screen">
+    <LoginLeftView />
+
+    <div class="relative flex-1">
+      <AuthTopBar />
+
+      <div class="auth-right-wrap">
+        <div class="form">
+          <h3 class="title">{{ $t('login.title') }}</h3>
+          <p class="sub-title">{{ $t('login.subTitle') }}</p>
+          <ElForm
+            ref="formRef"
+            :model="formData"
+            :rules="rules"
+            :key="formKey"
+            @keyup.enter="handleSubmit"
+            style="margin-top: 25px"
+          >
+            <ElFormItem prop="username">
+              <ElInput
+                class="custom-height"
+                :placeholder="$t('login.placeholder.username')"
+                v-model.trim="formData.username"
+              />
+            </ElFormItem>
+            <ElFormItem prop="password">
+              <ElInput
+                class="custom-height"
+                :placeholder="$t('login.placeholder.password')"
+                v-model.trim="formData.password"
+                type="password"
+                autocomplete="off"
+                show-password
+              />
+            </ElFormItem>
+
+            <!-- 推拽验证 -->
+            <div class="relative pb-5 mt-6">
+              <div
+                class="relative z-[2] overflow-hidden select-none rounded-lg border border-transparent tad-300"
+                :class="{ '!border-[#FF4E4F]': !isPassing && isClickPass }"
+              >
+                <ArtDragVerify
+                  ref="dragVerify"
+                  v-model:value="isPassing"
+                  :text="$t('login.sliderText')"
+                  textColor="var(--art-gray-700)"
+                  :successText="$t('login.sliderSuccessText')"
+                  progressBarBg="var(--main-color)"
+                  :background="isDark ? '#26272F' : '#F1F1F4'"
+                  handlerBg="var(--default-box-color)"
+                />
+              </div>
+              <p
+                class="absolute top-0 z-[1] px-px mt-2 text-xs text-[#f56c6c] tad-300"
+                :class="{ 'translate-y-10': !isPassing && isClickPass }"
+              >
+                {{ $t('login.placeholder.slider') }}
+              </p>
+            </div>
+
+            <div class="flex-cb mt-2 text-sm">
+              <ElCheckbox v-model="formData.rememberPassword">{{
+                $t('login.rememberPwd')
+              }}</ElCheckbox>
+              <RouterLink class="text-theme" :to="{ name: 'ForgetPassword' }">{{
+                $t('login.forgetPwd')
+              }}</RouterLink>
+            </div>
+
+            <div style="margin-top: 30px">
+              <ElButton
+                class="w-full custom-height"
+                type="primary"
+                @click="handleSubmit"
+                :loading="loading"
+                v-ripple
+              >
+                {{ $t('login.btnText') }}
+              </ElButton>
+            </div>
+
+            <div class="mt-5 text-sm text-gray-600">
+              <span>{{ $t('login.noAccount') }}</span>
+              <RouterLink class="text-theme" :to="{ name: 'Register' }">{{
+                $t('login.register')
+              }}</RouterLink>
+            </div>
+          </ElForm>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useUserStore } from '@/store/modules/user'
+  import { useI18n } from 'vue-i18n'
+  import { HttpError } from '@/utils/http/error'
+  import { fetchLogin } from '@/api/auth'
+  import { ElNotification, type FormInstance, type FormRules } from 'element-plus'
+  import { useSettingStore } from '@/store/modules/setting'
+
+  defineOptions({ name: 'Login' })
+
+  const settingStore = useSettingStore()
+  const { isDark } = storeToRefs(settingStore)
+  const { t, locale } = useI18n()
+  const formKey = ref(0)
+
+  // 监听语言切换，重置表单
+  watch(locale, () => {
+    formKey.value++
+  })
+
+  const dragVerify = ref()
+
+  const userStore = useUserStore()
+  const router = useRouter()
+  const route = useRoute()
+  const isPassing = ref(false)
+  const isClickPass = ref(false)
+
+  const formRef = ref<FormInstance>()
+
+  const formData = reactive({
+    username: '',
+    password: '',
+    rememberPassword: true
+  })
+
+  const rules = computed<FormRules>(() => ({
+    username: [{ required: true, message: t('login.placeholder.username'), trigger: 'blur' }],
+    password: [{ required: true, message: t('login.placeholder.password'), trigger: 'blur' }]
+  }))
+
+  const loading = ref(false)
+
+  // 登录
+  const handleSubmit = async () => {
+    if (!formRef.value) return
+
+    try {
+      // 表单验证
+      const valid = await formRef.value.validate()
+      if (!valid) return
+
+      // 拖拽验证
+      if (!isPassing.value) {
+        isClickPass.value = true
+        return
+      }
+
+      loading.value = true
+
+      // 登录请求
+      const { username, password } = formData
+
+      const { token, user } = await fetchLogin({
+        userName: username,
+        password
+      })
+
+      // 验证token
+      if (!token) {
+        throw new Error('Login failed - no token received')
+      }
+
+      // 存储 token 和登录状态
+      userStore.setToken(token)
+      userStore.setLoginStatus(true)
+      if (user) {
+        userStore.setUserInfo(user)
+      }
+
+      // 登录成功处理
+      showLoginSuccessNotice()
+
+      // 获取 redirect 参数，如果存在则跳转到指定页面，否则跳转到首页
+      const redirect = route.query.redirect as string
+      router.push(redirect || '/')
+    } catch (error) {
+      // 处理 HttpError
+      if (error instanceof HttpError) {
+        // console.log(error.code)
+      } else {
+        // 处理非 HttpError
+        // ElMessage.error('登录失败，请稍后重试')
+        console.error('[Login] Unexpected error:', error)
+      }
+    } finally {
+      loading.value = false
+      resetDragVerify()
+    }
+  }
+
+  // 重置拖拽验证
+  const resetDragVerify = () => {
+    dragVerify.value.reset()
+  }
+
+  // 登录成功提示
+  const showLoginSuccessNotice = () => {
+    setTimeout(() => {
+      ElNotification({
+        title: t('login.success.title'),
+        type: 'success',
+        duration: 2500,
+        zIndex: 10000,
+        message: t('login.success.message')
+      })
+    }, 1000)
+  }
+</script>
+
+<style scoped>
+  @import './style.css';
+</style>
+
+<style lang="scss" scoped>
+  :deep(.el-select__wrapper) {
+    height: 40px !important;
+  }
+</style>
diff --git a/web/src/views/auth/login/style.css b/web/src/views/auth/login/style.css
new file mode 100644
index 0000000..bd8c3a9
--- /dev/null
+++ b/web/src/views/auth/login/style.css
@@ -0,0 +1,38 @@
+@reference '@styles/core/tailwind.css';
+
+/* 授权页右侧区域 */
+.auth-right-wrap {
+  @apply absolute inset-0 w-[440px] h-[650px] py-[5px] m-auto overflow-hidden
+    max-sm:px-7 max-sm:w-full
+    animate-[slideInRight_0.6s_cubic-bezier(0.25,0.46,0.45,0.94)_forwards]
+    max-md:animate-none;
+
+  .form {
+    @apply h-full py-[40px];
+  }
+
+  .title {
+    @apply text-g-900 text-4xl font-semibold max-md:text-3xl max-sm:pt-10;
+  }
+
+  .sub-title {
+    @apply mt-[10px] text-g-600 text-sm;
+  }
+
+  .custom-height {
+    @apply !h-[40px];
+  }
+}
+
+/* 滑入动画 */
+@keyframes slideInRight {
+  from {
+    opacity: 0;
+    transform: translateX(30px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
diff --git a/web/src/views/auth/register/index.vue b/web/src/views/auth/register/index.vue
new file mode 100644
index 0000000..83fe359
--- /dev/null
+++ b/web/src/views/auth/register/index.vue
@@ -0,0 +1,238 @@
+<!-- 注册页面 -->
+<template>
+  <div class="flex w-full h-screen">
+    <LoginLeftView />
+
+    <div class="relative flex-1">
+      <AuthTopBar />
+
+      <div class="auth-right-wrap">
+        <div class="form">
+          <h3 class="title">{{ $t('register.title') }}</h3>
+          <p class="sub-title">{{ $t('register.subTitle') }}</p>
+          <ElForm
+            class="mt-7.5"
+            ref="formRef"
+            :model="formData"
+            :rules="rules"
+            label-position="top"
+            :key="formKey"
+          >
+            <ElFormItem prop="username">
+              <ElInput
+                class="custom-height"
+                v-model.trim="formData.username"
+                :placeholder="$t('register.placeholder.username')"
+              />
+            </ElFormItem>
+
+            <ElFormItem prop="email">
+              <ElInput
+                class="custom-height"
+                v-model.trim="formData.email"
+                :placeholder="$t('register.placeholder.email')"
+              />
+            </ElFormItem>
+
+            <ElFormItem prop="password">
+              <ElInput
+                class="custom-height"
+                v-model.trim="formData.password"
+                :placeholder="$t('register.placeholder.password')"
+                type="password"
+                autocomplete="off"
+                show-password
+              />
+            </ElFormItem>
+
+            <ElFormItem prop="confirmPassword">
+              <ElInput
+                class="custom-height"
+                v-model.trim="formData.confirmPassword"
+                :placeholder="$t('register.placeholder.confirmPassword')"
+                type="password"
+                autocomplete="off"
+                @keyup.enter="register"
+                show-password
+              />
+            </ElFormItem>
+
+            <ElFormItem prop="agreement">
+              <ElCheckbox v-model="formData.agreement">
+                {{ $t('register.agreeText') }}
+                <RouterLink
+                  style="color: var(--theme-color); text-decoration: none"
+                  to="/privacy-policy"
+                  >{{ $t('register.privacyPolicy') }}</RouterLink
+                >
+              </ElCheckbox>
+            </ElFormItem>
+
+            <div style="margin-top: 15px">
+              <ElButton
+                class="w-full custom-height"
+                type="primary"
+                @click="register"
+                :loading="loading"
+                v-ripple
+              >
+                {{ $t('register.submitBtnText') }}
+              </ElButton>
+            </div>
+
+            <div class="mt-5 text-sm text-g-600">
+              <span>{{ $t('register.hasAccount') }}</span>
+              <RouterLink class="text-theme" :to="{ name: 'Login' }">{{
+                $t('register.toLogin')
+              }}</RouterLink>
+            </div>
+          </ElForm>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchRegister } from '@/api/auth'
+  import { useUserStore } from '@/store/modules/user'
+  import { useI18n } from 'vue-i18n'
+  import type { FormInstance, FormRules } from 'element-plus'
+
+  defineOptions({ name: 'Register' })
+
+  interface RegisterForm {
+    username: string
+    email: string
+    password: string
+    confirmPassword: string
+    agreement: boolean
+  }
+
+  const USERNAME_MIN_LENGTH = 3
+  const USERNAME_MAX_LENGTH = 20
+  const PASSWORD_MIN_LENGTH = 6
+  const { t, locale } = useI18n()
+  const router = useRouter()
+  const userStore = useUserStore()
+  const formRef = ref<FormInstance>()
+
+  const loading = ref(false)
+  const formKey = ref(0)
+
+  // 监听语言切换，重置表单
+  watch(locale, () => {
+    formKey.value++
+  })
+
+  const formData = reactive<RegisterForm>({
+    username: '',
+    email: '',
+    password: '',
+    confirmPassword: '',
+    agreement: false
+  })
+
+  /**
+   * 验证密码
+   * 当密码输入后，如果确认密码已填写，则触发确认密码的验证
+   */
+  const validatePassword = (_rule: any, value: string, callback: (error?: Error) => void) => {
+    if (!value) {
+      callback(new Error(t('register.placeholder.password')))
+      return
+    }
+
+    if (formData.confirmPassword) {
+      formRef.value?.validateField('confirmPassword')
+    }
+
+    callback()
+  }
+
+  /**
+   * 验证确认密码
+   * 检查确认密码是否与密码一致
+   */
+  const validateConfirmPassword = (
+    _rule: any,
+    value: string,
+    callback: (error?: Error) => void
+  ) => {
+    if (!value) {
+      callback(new Error(t('register.rule.confirmPasswordRequired')))
+      return
+    }
+
+    if (value !== formData.password) {
+      callback(new Error(t('register.rule.passwordMismatch')))
+      return
+    }
+
+    callback()
+  }
+
+  /**
+   * 验证用户协议
+   * 确保用户已勾选同意协议
+   */
+  const validateAgreement = (_rule: any, value: boolean, callback: (error?: Error) => void) => {
+    if (!value) {
+      callback(new Error(t('register.rule.agreementRequired')))
+      return
+    }
+    callback()
+  }
+
+  const rules = computed<FormRules<RegisterForm>>(() => ({
+    username: [
+      { required: true, message: t('register.placeholder.username'), trigger: 'blur' },
+      {
+        min: USERNAME_MIN_LENGTH,
+        max: USERNAME_MAX_LENGTH,
+        message: t('register.rule.usernameLength'),
+        trigger: 'blur'
+      }
+    ],
+    email: [{ required: true, message: t('register.placeholder.email'), trigger: 'blur' }],
+    password: [
+      { required: true, validator: validatePassword, trigger: 'blur' },
+      { min: PASSWORD_MIN_LENGTH, message: t('register.rule.passwordLength'), trigger: 'blur' }
+    ],
+    confirmPassword: [{ required: true, validator: validateConfirmPassword, trigger: 'blur' }],
+    agreement: [{ validator: validateAgreement, trigger: 'change' }]
+  }))
+
+  /**
+   * 注册用户
+   * 验证表单后提交注册请求
+   */
+  const register = async () => {
+    if (!formRef.value) return
+
+    try {
+      await formRef.value.validate()
+      loading.value = true
+
+      const { token, user } = await fetchRegister({
+        userName: formData.username,
+        email: formData.email,
+        password: formData.password
+      })
+      userStore.setToken(token)
+      userStore.setLoginStatus(true)
+      if (user) {
+        userStore.setUserInfo(user)
+      }
+      ElMessage.success(t('register.success.message'))
+      router.push('/')
+    } catch (error) {
+      console.error('[Register] form validation failed:', error)
+      loading.value = false
+    }
+  }
+</script>
+
+<style scoped>
+  @import '../login/style.css';
+</style>
diff --git a/web/src/views/dashboard/console/index.vue b/web/src/views/dashboard/console/index.vue
new file mode 100644
index 0000000..0c968b2
--- /dev/null
+++ b/web/src/views/dashboard/console/index.vue
@@ -0,0 +1,260 @@
+<template>
+  <div class="commory-page">
+    <ElCard class="overview-card" shadow="never">
+      <div class="overview-header">
+        <div>
+          <p class="eyebrow">Commory</p>
+          <h2>{{ t('dashboardPage.console.title') }}</h2>
+          <p>{{ t('dashboardPage.console.subtitle') }}</p>
+        </div>
+        <ElButton type="primary" @click="router.push('/dashboard/imports')" v-ripple>
+          {{ t('dashboardPage.console.openImports') }}
+        </ElButton>
+      </div>
+    </ElCard>
+
+    <section class="stats-grid">
+      <ElCard v-for="card in cards" :key="card.label" class="stat-card" shadow="never">
+        <span>{{ card.label }}</span>
+        <strong>{{ card.value }}</strong>
+        <p>{{ card.hint }}</p>
+      </ElCard>
+    </section>
+
+    <section class="content-grid">
+      <ElCard class="art-table-card" shadow="never">
+        <template #header>
+          <div class="panel-header">
+            <h3>{{ t('dashboardPage.console.recentImports') }}</h3>
+            <span>{{
+              t('dashboardPage.console.itemCount', { count: summary?.recentImports.length || 0 })
+            }}</span>
+          </div>
+        </template>
+        <ElTable :data="summary?.recentImports || []" size="large" v-loading="loading">
+          <ElTableColumn prop="id" :label="t('dashboardPage.columns.import')" min-width="180" />
+          <ElTableColumn
+            prop="schema_version"
+            :label="t('dashboardPage.columns.version')"
+            width="140"
+          />
+          <ElTableColumn
+            prop="event_count"
+            :label="t('dashboardPage.columns.events')"
+            width="100"
+          />
+          <ElTableColumn
+            prop="imported_at"
+            :label="t('dashboardPage.columns.importedAt')"
+            min-width="180"
+          />
+        </ElTable>
+      </ElCard>
+
+      <ElCard class="events-card" shadow="never">
+        <template #header>
+          <div class="panel-header">
+            <h3>{{ t('dashboardPage.console.recentEvents') }}</h3>
+            <ElButton link type="primary" @click="router.push('/dashboard/timeline')">
+              {{ t('dashboardPage.console.viewTimeline') }}
+            </ElButton>
+          </div>
+        </template>
+        <ElEmpty
+          v-if="!loading && !(summary?.recentEvents || []).length"
+          :description="t('dashboardPage.console.emptyEvents')"
+        />
+        <div v-else class="event-list" v-loading="loading">
+          <div v-for="event in summary?.recentEvents || []" :key="event.event_id" class="event-row">
+            <div>
+              <p class="event-title">{{ event.content_summary || event.type }}</p>
+              <p class="muted">{{ event.type }} · {{ event.direction }}</p>
+            </div>
+            <span class="muted">{{ event.timestamp }}</span>
+          </div>
+        </div>
+      </ElCard>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchDashboardSummary } from '@/api/commory'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'Console' })
+
+  const { t } = useI18n()
+  const router = useRouter()
+  const summary = ref<Api.Commory.DashboardSummary>()
+  const loading = ref(false)
+
+  const cards = computed(() => [
+    {
+      label: t('dashboardPage.console.cards.imports'),
+      value: summary.value?.importCount ?? 0,
+      hint: t('dashboardPage.console.hints.imports')
+    },
+    {
+      label: t('dashboardPage.console.cards.events'),
+      value: summary.value?.eventCount ?? 0,
+      hint: t('dashboardPage.console.hints.events')
+    },
+    {
+      label: t('dashboardPage.console.cards.identities'),
+      value: summary.value?.identityCount ?? 0,
+      hint: t('dashboardPage.console.hints.identities')
+    },
+    {
+      label: t('dashboardPage.console.cards.lastActivity'),
+      value: summary.value?.lastActivity || t('dashboardPage.console.noImports'),
+      hint: t('dashboardPage.console.hints.lastActivity')
+    }
+  ])
+
+  const load = async () => {
+    loading.value = true
+    try {
+      summary.value = await fetchDashboardSummary()
+    } finally {
+      loading.value = false
+    }
+  }
+
+  onMounted(load)
+  onActivated(load)
+</script>
+
+<style scoped lang="scss">
+  .commory-page {
+    display: grid;
+    gap: 16px;
+  }
+
+  .overview-card,
+  .stat-card,
+  .events-card {
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+  }
+
+  .overview-header {
+    display: flex;
+    gap: 16px;
+    align-items: flex-start;
+    justify-content: space-between;
+
+    h2,
+    p {
+      margin: 0;
+    }
+
+    h2 {
+      margin-top: 5px;
+      font-size: 24px;
+      font-weight: 600;
+      color: var(--art-gray-800);
+    }
+
+    p:not(.eyebrow) {
+      margin-top: 8px;
+      color: var(--art-gray-600);
+    }
+  }
+
+  .eyebrow {
+    margin: 0;
+    color: var(--main-color);
+    font-size: 13px;
+    font-weight: 600;
+  }
+
+  .stats-grid,
+  .content-grid {
+    display: grid;
+    gap: 16px;
+  }
+
+  .stats-grid {
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+  }
+
+  .content-grid {
+    grid-template-columns: minmax(0, 1.08fr) minmax(360px, 0.92fr);
+  }
+
+  .stat-card :deep(.el-card__body) {
+    display: grid;
+    gap: 10px;
+    min-height: 132px;
+  }
+
+  .stat-card {
+    span,
+    p {
+      margin: 0;
+      color: var(--art-gray-600);
+    }
+
+    strong {
+      font-size: 28px;
+      line-height: 1.1;
+      color: var(--art-gray-900);
+    }
+  }
+
+  .panel-header,
+  .event-row {
+    display: flex;
+    gap: 12px;
+    align-items: center;
+    justify-content: space-between;
+  }
+
+  .panel-header {
+    h3 {
+      margin: 0;
+      font-size: 16px;
+      font-weight: 600;
+    }
+
+    span {
+      color: var(--art-gray-600);
+    }
+  }
+
+  .event-list {
+    display: grid;
+    gap: 14px;
+  }
+
+  .event-row {
+    padding-bottom: 14px;
+    border-bottom: 1px solid var(--art-border-color);
+
+    &:last-child {
+      padding-bottom: 0;
+      border-bottom: 0;
+    }
+  }
+
+  .event-title {
+    margin: 0 0 4px;
+  }
+
+  .muted {
+    color: var(--art-gray-600);
+  }
+
+  @media (max-width: 1100px) {
+    .stats-grid,
+    .content-grid {
+      grid-template-columns: 1fr;
+    }
+
+    .overview-header {
+      flex-direction: column;
+      align-items: stretch;
+    }
+  }
+</style>
diff --git a/web/src/views/dashboard/contacts/index.vue b/web/src/views/dashboard/contacts/index.vue
new file mode 100644
index 0000000..ac8bc89
--- /dev/null
+++ b/web/src/views/dashboard/contacts/index.vue
@@ -0,0 +1,175 @@
+<template>
+  <div class="contacts-layout">
+    <ElCard class="list-panel" shadow="never">
+      <div class="panel-header">
+        <h3>{{ t('dashboardPage.contacts.title') }}</h3>
+        <span>{{ contacts.length }}</span>
+      </div>
+      <ElInput
+        v-model="keyword"
+        :placeholder="t('dashboardPage.contacts.filterPlaceholder')"
+        clearable
+      />
+      <div class="contact-list">
+        <button
+          v-for="item in filteredContacts"
+          :key="item.id"
+          class="contact-row"
+          :class="{ active: selected?.id === item.id }"
+          @click="selectContact(item)"
+        >
+          <strong>{{ item.display_name }}</strong>
+          <span>{{ item.phones[0] || item.emails[0] || item.id }}</span>
+        </button>
+      </div>
+    </ElCard>
+
+    <ElCard class="detail-panel" shadow="never">
+      <template v-if="selected">
+        <div class="panel-header">
+          <div>
+            <h3>{{ selected.display_name }}</h3>
+            <p class="detail-meta">{{ selected.type }} · {{ selected.labels.join(', ') }}</p>
+          </div>
+          <ElButton link type="primary" @click="loadTimeline">
+            {{ t('dashboardPage.contacts.loadActivity') }}
+          </ElButton>
+        </div>
+
+        <ElDescriptions :column="1" border>
+          <ElDescriptionsItem :label="t('dashboardPage.contacts.phones')">{{
+            selected.phones.join(', ') || '-'
+          }}</ElDescriptionsItem>
+          <ElDescriptionsItem :label="t('dashboardPage.contacts.emails')">{{
+            selected.emails.join(', ') || '-'
+          }}</ElDescriptionsItem>
+          <ElDescriptionsItem :label="t('dashboardPage.contacts.source')">{{
+            selected.meta?.source || '-'
+          }}</ElDescriptionsItem>
+        </ElDescriptions>
+
+        <div class="activity-list">
+          <div v-for="event in events" :key="event.event_id" class="activity-row">
+            <div>
+              <strong>{{ event.content_summary || event.type }}</strong>
+              <p class="detail-meta">{{ event.type }} · {{ event.direction }}</p>
+            </div>
+            <span class="detail-meta">{{ event.timestamp }}</span>
+          </div>
+        </div>
+      </template>
+      <ElEmpty v-else class="empty-state" :description="t('dashboardPage.contacts.empty')" />
+    </ElCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchIdentities, fetchTimeline } from '@/api/commory'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'Contacts' })
+
+  const { t } = useI18n()
+  const contacts = ref<Api.Commory.Identity[]>([])
+  const selected = ref<Api.Commory.Identity>()
+  const events = ref<Api.Commory.TimelineItem[]>([])
+  const keyword = ref('')
+
+  const filteredContacts = computed(() =>
+    contacts.value.filter((item) => {
+      const needle = keyword.value.trim().toLowerCase()
+      if (!needle) return true
+      return (
+        item.display_name.toLowerCase().includes(needle) ||
+        item.phones.some((phone) => phone.toLowerCase().includes(needle))
+      )
+    })
+  )
+
+  const selectContact = async (item: Api.Commory.Identity) => {
+    selected.value = item
+    await loadTimeline()
+  }
+
+  const loadTimeline = async () => {
+    if (!selected.value) return
+    events.value = await fetchTimeline({ participant: selected.value.id, limit: 50 })
+  }
+
+  const load = async () => {
+    contacts.value = await fetchIdentities()
+    selected.value = contacts.value[0]
+    await loadTimeline()
+  }
+
+  onMounted(load)
+</script>
+
+<style scoped lang="scss">
+  .contacts-layout {
+    display: grid;
+    grid-template-columns: 320px minmax(0, 1fr);
+    gap: 18px;
+  }
+
+  .list-panel,
+  .detail-panel {
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+  }
+
+  .list-panel :deep(.el-card__body),
+  .detail-panel :deep(.el-card__body) {
+    padding: 18px;
+  }
+
+  .panel-header,
+  .activity-row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 12px;
+  }
+
+  .contact-list,
+  .activity-list {
+    display: grid;
+    gap: 10px;
+    margin-top: 16px;
+  }
+
+  .contact-row {
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+    background: transparent;
+    padding: 12px;
+    text-align: left;
+  }
+
+  .contact-row.active {
+    border-color: var(--el-color-primary);
+    background: rgba(64, 158, 255, 0.08);
+  }
+
+  .contact-row span,
+  .detail-meta,
+  .empty-state {
+    color: var(--art-gray-600);
+  }
+
+  .activity-row {
+    padding-bottom: 12px;
+    border-bottom: 1px solid var(--art-border-color);
+  }
+
+  .activity-row:last-child {
+    border-bottom: 0;
+    padding-bottom: 0;
+  }
+
+  @media (max-width: 960px) {
+    .contacts-layout {
+      grid-template-columns: 1fr;
+    }
+  }
+</style>
diff --git a/web/src/views/dashboard/imports/index.vue b/web/src/views/dashboard/imports/index.vue
new file mode 100644
index 0000000..89f82be
--- /dev/null
+++ b/web/src/views/dashboard/imports/index.vue
@@ -0,0 +1,157 @@
+<template>
+  <div class="page-grid">
+    <section class="toolbar">
+      <ElUpload
+        :auto-upload="false"
+        :show-file-list="false"
+        :on-change="handleFileChange"
+        accept=".json"
+      >
+        <ElButton>{{ t('dashboardPage.imports.chooseFile') }}</ElButton>
+      </ElUpload>
+      <span class="file-name">{{ selectedFile?.name || t('dashboardPage.imports.noFile') }}</span>
+      <ElButton :disabled="!selectedFile" @click="runValidate">{{
+        t('dashboardPage.imports.validate')
+      }}</ElButton>
+      <ElButton type="primary" :disabled="!selectedFile" @click="runImport">{{
+        t('dashboardPage.imports.import')
+      }}</ElButton>
+    </section>
+
+    <ElCard class="panel art-table-card" shadow="never">
+      <div class="panel-header">
+        <h3>{{ t('dashboardPage.imports.history') }}</h3>
+        <span>{{ t('dashboardPage.imports.count', { count: items.length }) }}</span>
+      </div>
+      <p v-if="statusMessage" class="status">{{ statusMessage }}</p>
+      <ElTable :data="items" size="large" v-loading="loading">
+        <ElTableColumn prop="id" :label="t('dashboardPage.columns.import')" min-width="190" />
+        <ElTableColumn
+          prop="schema_version"
+          :label="t('dashboardPage.columns.version')"
+          width="140"
+        />
+        <ElTableColumn prop="event_count" :label="t('dashboardPage.columns.events')" width="100" />
+        <ElTableColumn
+          prop="identity_count"
+          :label="t('dashboardPage.columns.identities')"
+          width="110"
+        />
+        <ElTableColumn
+          prop="imported_at"
+          :label="t('dashboardPage.columns.importedAt')"
+          min-width="180"
+        />
+        <ElTableColumn
+          prop="source_path"
+          :label="t('dashboardPage.columns.source')"
+          min-width="220"
+        />
+        <ElTableColumn :label="t('dashboardPage.columns.action')" width="120">
+          <template #default="{ row }">
+            <ElButton link type="primary" @click="download(row.id)">{{
+              t('dashboardPage.imports.export')
+            }}</ElButton>
+          </template>
+        </ElTableColumn>
+      </ElTable>
+    </ElCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import type { UploadFile } from 'element-plus'
+  import { downloadImport, fetchImports, uploadImport, validateImport } from '@/api/commory'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'Imports' })
+
+  const { t } = useI18n()
+  const loading = ref(false)
+  const items = ref<Api.Commory.ImportSummary[]>([])
+  const selectedFile = ref<File | null>(null)
+  const statusMessage = ref('')
+
+  const load = async () => {
+    loading.value = true
+    try {
+      items.value = await fetchImports()
+    } finally {
+      loading.value = false
+    }
+  }
+
+  const handleFileChange = (uploadFile: UploadFile) => {
+    selectedFile.value = uploadFile.raw || null
+    statusMessage.value = ''
+  }
+
+  const runValidate = async () => {
+    if (!selectedFile.value) return
+    const result = await validateImport(selectedFile.value)
+    statusMessage.value = result.valid
+      ? t('dashboardPage.imports.validationPassed')
+      : t('dashboardPage.imports.validationFailed')
+  }
+
+  const runImport = async () => {
+    if (!selectedFile.value) return
+    const result = await uploadImport(selectedFile.value)
+    statusMessage.value = t('dashboardPage.imports.imported', {
+      id: result.import_id,
+      version: result.msglayer_version
+    })
+    await load()
+  }
+
+  const download = async (importId: string) => {
+    await downloadImport(importId)
+  }
+
+  onMounted(load)
+</script>
+
+<style scoped lang="scss">
+  .page-grid {
+    display: grid;
+    gap: 16px;
+  }
+
+  .toolbar,
+  .panel {
+    background: var(--art-main-bg-color);
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+  }
+
+  .toolbar {
+    display: grid;
+    grid-template-columns: auto minmax(0, 1fr) auto auto;
+    gap: 12px;
+    align-items: center;
+    padding: 16px;
+  }
+
+  .panel-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 12px;
+  }
+
+  .file-name,
+  .status,
+  .panel-header span {
+    color: var(--art-gray-600);
+  }
+
+  .status {
+    margin: 12px 0 0;
+  }
+
+  @media (max-width: 960px) {
+    .toolbar {
+      grid-template-columns: 1fr;
+    }
+  }
+</style>
diff --git a/web/src/views/dashboard/search/index.vue b/web/src/views/dashboard/search/index.vue
new file mode 100644
index 0000000..25fb10b
--- /dev/null
+++ b/web/src/views/dashboard/search/index.vue
@@ -0,0 +1,131 @@
+<template>
+  <div class="page-grid">
+    <section class="toolbar">
+      <ElInput
+        v-model="query"
+        :placeholder="t('dashboardPage.search.placeholder')"
+        clearable
+        @keyup.enter="load"
+      />
+      <ElButton type="primary" @click="load">{{ t('common.search') }}</ElButton>
+    </section>
+
+    <ElCard class="panel" shadow="never">
+      <div class="panel-header">
+        <h3>{{ t('dashboardPage.search.title') }}</h3>
+        <span>{{ t('dashboardPage.search.matches', { count: results.length }) }}</span>
+      </div>
+      <ElEmpty v-if="!loading && !results.length" :description="t('common.noData')" />
+      <div v-else class="result-list" v-loading="loading">
+        <article v-for="item in results" :key="item.event_id" class="result-item">
+          <div class="result-top">
+            <strong>{{ item.content_summary || item.type }}</strong>
+            <ElTag size="small">{{ item.type }}</ElTag>
+          </div>
+          <p class="meta">{{ item.timestamp }} · {{ item.direction }}</p>
+          <p class="participants">{{ item.participants.join(', ') }}</p>
+        </article>
+      </div>
+      <div class="pagination-wrapper" v-if="results.length > 0">
+        <ElPagination
+          v-model:current-page="currentPage"
+          :page-size="pageSize"
+          :total="total"
+          layout="prev, pager, next"
+          @current-change="handlePageChange"
+        />
+      </div>
+    </ElCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchSearch } from '@/api/commory'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'SearchRecords' })
+
+  const { t } = useI18n()
+  const query = ref('')
+  const loading = ref(false)
+  const results = ref<Api.Commory.TimelineItem[]>([])
+  const currentPage = ref(1)
+  const pageSize = 20
+  const total = ref(0)
+
+  const load = async () => {
+    loading.value = true
+    try {
+      const offset = (currentPage.value - 1) * pageSize
+      results.value = await fetchSearch({ q: query.value, limit: pageSize, offset })
+      total.value =
+        results.value.length === pageSize
+          ? currentPage.value * pageSize + pageSize
+          : offset + results.value.length
+    } finally {
+      loading.value = false
+    }
+  }
+
+  const handlePageChange = (page: number) => {
+    currentPage.value = page
+    load()
+  }
+</script>
+
+<style scoped lang="scss">
+  .page-grid {
+    display: grid;
+    gap: 16px;
+  }
+
+  .toolbar,
+  .panel {
+    background: var(--art-main-bg-color);
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+  }
+
+  .toolbar {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) 120px;
+    gap: 12px;
+    padding: 16px;
+  }
+
+  .panel-header,
+  .result-top {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 12px;
+  }
+
+  .result-list {
+    display: grid;
+    gap: 14px;
+    margin-top: 16px;
+  }
+
+  .result-item {
+    padding-bottom: 14px;
+    border-bottom: 1px solid var(--art-border-color);
+  }
+
+  .result-item:last-child {
+    border-bottom: 0;
+    padding-bottom: 0;
+  }
+
+  .meta,
+  .participants,
+  .panel-header span {
+    color: var(--art-gray-600);
+  }
+
+  .pagination-wrapper {
+    display: flex;
+    justify-content: center;
+    margin-top: 16px;
+  }
+</style>
diff --git a/web/src/views/dashboard/timeline/index.vue b/web/src/views/dashboard/timeline/index.vue
new file mode 100644
index 0000000..094a72e
--- /dev/null
+++ b/web/src/views/dashboard/timeline/index.vue
@@ -0,0 +1,129 @@
+<template>
+  <div class="page-grid">
+    <section class="toolbar">
+      <ElInput
+        v-model="filters.q"
+        :placeholder="t('dashboardPage.timeline.searchPlaceholder')"
+        clearable
+      />
+      <ElSelect
+        v-model="filters.type"
+        clearable
+        :placeholder="t('dashboardPage.timeline.typePlaceholder')"
+      >
+        <ElOption :label="t('dashboardPage.timeline.eventTypes.all')" value="" />
+        <ElOption :label="t('dashboardPage.timeline.eventTypes.sms')" value="sms" />
+        <ElOption :label="t('dashboardPage.timeline.eventTypes.call')" value="call" />
+        <ElOption :label="t('dashboardPage.timeline.eventTypes.voice')" value="voice" />
+        <ElOption
+          :label="t('dashboardPage.timeline.eventTypes.contact_snapshot')"
+          value="contact_snapshot"
+        />
+      </ElSelect>
+      <ElButton type="primary" @click="load">{{ t('dashboardPage.timeline.apply') }}</ElButton>
+    </section>
+
+    <ElCard class="panel art-table-card" shadow="never">
+      <ElTable :data="items" size="large" v-loading="loading">
+        <ElTableColumn
+          prop="timestamp"
+          :label="t('dashboardPage.columns.timestamp')"
+          min-width="190"
+        />
+        <ElTableColumn prop="type" :label="t('dashboardPage.columns.type')" width="130" />
+        <ElTableColumn prop="direction" :label="t('dashboardPage.columns.direction')" width="120" />
+        <ElTableColumn
+          prop="content_summary"
+          :label="t('dashboardPage.columns.summary')"
+          min-width="320"
+        />
+        <ElTableColumn :label="t('dashboardPage.columns.participants')" min-width="240">
+          <template #default="{ row }">{{ row.participants.join(', ') }}</template>
+        </ElTableColumn>
+      </ElTable>
+      <div class="pagination-wrapper" v-if="items.length > 0">
+        <ElPagination
+          v-model:current-page="currentPage"
+          :page-size="pageSize"
+          :total="total"
+          layout="prev, pager, next"
+          @current-change="handlePageChange"
+        />
+      </div>
+    </ElCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { fetchTimeline } from '@/api/commory'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'Timeline' })
+
+  const { t } = useI18n()
+  const loading = ref(false)
+  const items = ref<Api.Commory.TimelineItem[]>([])
+  const currentPage = ref(1)
+  const pageSize = 20
+  const total = ref(0)
+  const filters = reactive<Api.Commory.SearchParams>({
+    q: '',
+    type: '',
+    limit: 20
+  })
+
+  const load = async () => {
+    loading.value = true
+    try {
+      const offset = (currentPage.value - 1) * pageSize
+      filters.offset = offset
+      filters.limit = pageSize
+      items.value = await fetchTimeline(filters)
+      total.value =
+        items.value.length === pageSize
+          ? currentPage.value * pageSize + pageSize
+          : offset + items.value.length
+    } finally {
+      loading.value = false
+    }
+  }
+
+  const handlePageChange = (page: number) => {
+    currentPage.value = page
+    load()
+  }
+
+  onMounted(load)
+</script>
+
+<style scoped lang="scss">
+  .page-grid {
+    display: grid;
+    gap: 16px;
+  }
+
+  .toolbar {
+    background: var(--art-main-bg-color);
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+  }
+
+  .toolbar {
+    display: grid;
+    grid-template-columns: minmax(0, 1.4fr) 180px 120px;
+    gap: 12px;
+    padding: 16px;
+  }
+
+  .pagination-wrapper {
+    display: flex;
+    justify-content: center;
+    margin-top: 16px;
+  }
+
+  @media (max-width: 900px) {
+    .toolbar {
+      grid-template-columns: 1fr;
+    }
+  }
+</style>
diff --git a/web/src/views/exception/403/index.vue b/web/src/views/exception/403/index.vue
new file mode 100755
index 0000000..2756c42
--- /dev/null
+++ b/web/src/views/exception/403/index.vue
@@ -0,0 +1,16 @@
+<!-- 403页面 -->
+<template>
+  <ArtException
+    :data="{
+      title: '403',
+      desc: $t('exceptionPage.403'),
+      btnText: $t('exceptionPage.gohome'),
+      imgUrl
+    }"
+  />
+</template>
+
+<script setup lang="ts">
+  import imgUrl from '@imgs/svg/403.svg'
+  defineOptions({ name: 'Exception403' })
+</script>
diff --git a/web/src/views/exception/404/index.vue b/web/src/views/exception/404/index.vue
new file mode 100755
index 0000000..6b64f45
--- /dev/null
+++ b/web/src/views/exception/404/index.vue
@@ -0,0 +1,16 @@
+<!-- 404页面 -->
+<template>
+  <ArtException
+    :data="{
+      title: '404',
+      desc: $t('exceptionPage.404'),
+      btnText: $t('exceptionPage.gohome'),
+      imgUrl
+    }"
+  />
+</template>
+
+<script setup lang="ts">
+  import imgUrl from '@imgs/svg/404.svg'
+  defineOptions({ name: 'Exception404' })
+</script>
diff --git a/web/src/views/exception/500/index.vue b/web/src/views/exception/500/index.vue
new file mode 100755
index 0000000..1b26377
--- /dev/null
+++ b/web/src/views/exception/500/index.vue
@@ -0,0 +1,16 @@
+<!-- 500页面 -->
+<template>
+  <ArtException
+    :data="{
+      title: '500',
+      desc: $t('exceptionPage.500'),
+      btnText: $t('exceptionPage.gohome'),
+      imgUrl
+    }"
+  />
+</template>
+
+<script setup lang="ts">
+  import imgUrl from '@imgs/svg/500.svg'
+  defineOptions({ name: 'Exception500' })
+</script>
diff --git a/web/src/views/index/index.vue b/web/src/views/index/index.vue
new file mode 100755
index 0000000..415a436
--- /dev/null
+++ b/web/src/views/index/index.vue
@@ -0,0 +1,29 @@
+<!-- 布局容器 -->
+<template>
+  <div class="app-layout">
+    <aside id="app-sidebar">
+      <ArtSidebarMenu />
+    </aside>
+
+    <main id="app-main">
+      <div id="app-header">
+        <ArtHeaderBar />
+      </div>
+      <div id="app-content">
+        <ArtPageContent />
+      </div>
+    </main>
+
+    <div id="app-global">
+      <ArtGlobalComponent />
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  defineOptions({ name: 'AppLayout' })
+</script>
+
+<style lang="scss" scoped>
+  @use './style';
+</style>
diff --git a/web/src/views/index/style.scss b/web/src/views/index/style.scss
new file mode 100644
index 0000000..c89f354
--- /dev/null
+++ b/web/src/views/index/style.scss
@@ -0,0 +1,93 @@
+.app-layout {
+  display: flex;
+  width: 100%;
+  min-height: 100vh;
+  background: var(--default-bg-color);
+
+  #app-sidebar {
+    flex-shrink: 0;
+  }
+
+  #app-main {
+    display: flex;
+    flex: 1;
+    flex-direction: column;
+    min-width: 0;
+    height: 100vh;
+    overflow: auto;
+
+    #app-header {
+      position: sticky;
+      top: 0;
+      z-index: 50;
+      flex-shrink: 0;
+      width: 100%;
+    }
+
+    #app-content {
+      flex: 1;
+
+      :deep(.layout-content) {
+        box-sizing: border-box;
+        width: calc(100% - 40px);
+        margin: auto;
+
+        // 子页面默认 style
+        .page-content {
+          position: relative;
+          box-sizing: border-box;
+          padding: 20px;
+          overflow: hidden;
+          background: var(--default-box-color);
+          border-radius: calc(var(--custom-radius) / 2 + 2px) !important;
+        }
+      }
+    }
+  }
+}
+
+@media only screen and (width <= 1180px) {
+  .app-layout {
+    #app-main {
+      height: 100dvh;
+    }
+  }
+}
+
+@media only screen and (width <= 800px) {
+  .app-layout {
+    position: relative;
+
+    #app-sidebar {
+      position: fixed;
+      top: 0;
+      left: 0;
+      z-index: 300;
+      height: 100vh;
+    }
+
+    #app-main {
+      width: 100%;
+      height: auto;
+      overflow: visible;
+
+      #app-content {
+        :deep(.layout-content) {
+          width: calc(100% - 40px);
+        }
+      }
+    }
+  }
+}
+
+@media only screen and (width <= 640px) {
+  .app-layout {
+    #app-main {
+      #app-content {
+        :deep(.layout-content) {
+          width: calc(100% - 30px);
+        }
+      }
+    }
+  }
+}
diff --git a/web/src/views/outside/Iframe.vue b/web/src/views/outside/Iframe.vue
new file mode 100644
index 0000000..33ea0dc
--- /dev/null
+++ b/web/src/views/outside/Iframe.vue
@@ -0,0 +1,42 @@
+<template>
+  <div class="box-border w-full h-full" v-loading="isLoading">
+    <iframe
+      ref="iframeRef"
+      :src="iframeUrl"
+      frameborder="0"
+      class="w-full h-full min-h-[calc(100vh-120px)] border-none"
+      @load="handleIframeLoad"
+    ></iframe>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { IframeRouteManager } from '@/router/core'
+
+  defineOptions({ name: 'IframeView' })
+
+  const route = useRoute()
+  const isLoading = ref(true)
+  const iframeUrl = ref('')
+  const iframeRef = ref<HTMLIFrameElement | null>(null)
+
+  /**
+   * 初始化 iframe URL
+   * 从路由配置中获取对应的外部链接地址
+   */
+  onMounted(() => {
+    const iframeRoute = IframeRouteManager.getInstance().findByPath(route.path)
+
+    if (iframeRoute?.meta) {
+      iframeUrl.value = iframeRoute.meta.link || ''
+    }
+  })
+
+  /**
+   * 处理 iframe 加载完成事件
+   * 隐藏加载状态
+   */
+  const handleIframeLoad = (): void => {
+    isLoading.value = false
+  }
+</script>
diff --git a/web/src/views/result/fail/index.vue b/web/src/views/result/fail/index.vue
new file mode 100755
index 0000000..0cc6488
--- /dev/null
+++ b/web/src/views/result/fail/index.vue
@@ -0,0 +1,31 @@
+<template>
+  <ArtResultPage
+    type="fail"
+    :title="t('resultPage.fail.title')"
+    :message="t('resultPage.fail.message')"
+    iconCode="ri:close-fill"
+  >
+    <template #content>
+      <p>{{ t('resultPage.fail.intro') }}</p>
+      <p>
+        <ArtSvgIcon icon="ri:close-circle-line" class="text-red-500 mr-1" />
+        <span>{{ t('resultPage.fail.accountFrozen') }}</span>
+      </p>
+      <p>
+        <ArtSvgIcon icon="ri:close-circle-line" class="text-red-500 mr-1" />
+        <span>{{ t('resultPage.fail.notEligible') }}</span>
+      </p>
+    </template>
+    <template #buttons>
+      <ElButton type="primary" v-ripple>{{ t('resultPage.actions.backEdit') }}</ElButton>
+      <ElButton v-ripple>{{ t('resultPage.actions.view') }}</ElButton>
+    </template>
+  </ArtResultPage>
+</template>
+
+<script setup lang="ts">
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'ResultFail' })
+  const { t } = useI18n()
+</script>
diff --git a/web/src/views/result/success/index.vue b/web/src/views/result/success/index.vue
new file mode 100755
index 0000000..54ea6d0
--- /dev/null
+++ b/web/src/views/result/success/index.vue
@@ -0,0 +1,24 @@
+<template>
+  <ArtResultPage
+    type="success"
+    :title="t('resultPage.success.title')"
+    :message="t('resultPage.success.message')"
+    iconCode="ri:check-fill"
+  >
+    <template #content>
+      <p>{{ t('resultPage.success.content') }}</p>
+    </template>
+    <template #buttons>
+      <ElButton type="primary" v-ripple>{{ t('resultPage.actions.backEdit') }}</ElButton>
+      <ElButton v-ripple>{{ t('resultPage.actions.view') }}</ElButton>
+      <ElButton v-ripple>{{ t('resultPage.actions.print') }}</ElButton>
+    </template>
+  </ArtResultPage>
+</template>
+
+<script setup lang="ts">
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'ResultSuccess' })
+  const { t } = useI18n()
+</script>
diff --git a/web/src/views/setup/index.vue b/web/src/views/setup/index.vue
new file mode 100644
index 0000000..f8dda5a
--- /dev/null
+++ b/web/src/views/setup/index.vue
@@ -0,0 +1,524 @@
+<template>
+  <div class="setup-page">
+    <section class="setup-brand">
+      <p class="setup-eyebrow">{{ t('setup.eyebrow') }}</p>
+      <h1>{{ t('setup.title') }}</h1>
+      <p>{{ t('setup.subtitle') }}</p>
+
+      <div class="brand-status">
+        <div class="brand-status__icon">
+          <ElIcon><CircleCheckFilled /></ElIcon>
+        </div>
+        <div>
+          <strong>{{ t('setup.database.ready') }}</strong>
+          <span>{{ t('setup.database.hint') }}</span>
+        </div>
+      </div>
+    </section>
+
+    <ElCard class="setup-card" shadow="never" v-loading="loadingStatus">
+      <template #header>
+        <div class="card-header">
+          <div>
+            <h2>{{ t('setup.panelTitle') }}</h2>
+            <p>{{ t('setup.panelSubtitle') }}</p>
+          </div>
+          <ElTag type="success" effect="light">Commory</ElTag>
+        </div>
+      </template>
+
+      <ElAlert
+        v-if="statusWarning"
+        class="setup-alert"
+        :title="t('setup.apiUnavailable')"
+        type="warning"
+        :closable="false"
+        show-icon
+      />
+
+      <ElSteps :active="currentStep" finish-status="success" align-center>
+        <ElStep v-for="step in steps" :key="step" :title="step" />
+      </ElSteps>
+
+      <div class="setup-content">
+        <section v-show="currentStep === 0" class="step-panel">
+          <div class="step-heading">
+            <ElIcon><CircleCheckFilled /></ElIcon>
+            <div>
+              <h3>{{ t('setup.database.title') }}</h3>
+              <p>{{ t('setup.database.desc') }}</p>
+            </div>
+          </div>
+
+          <div class="info-row">
+            <span>{{ t('setup.finish.database') }}</span>
+            <strong>{{ setupStatus?.database_type || 'SQLite' }}</strong>
+          </div>
+          <p class="muted">{{ t('setup.database.hint') }}</p>
+        </section>
+
+        <section v-show="currentStep === 1" class="step-panel">
+          <div class="step-heading">
+            <ElIcon><UserFilled /></ElIcon>
+            <div>
+              <h3>{{ t('setup.admin.title') }}</h3>
+              <p>{{ t('setup.admin.desc') }}</p>
+            </div>
+          </div>
+
+          <ElAlert
+            v-if="setupStatus?.root_init"
+            :title="t('setup.admin.existsTitle')"
+            :description="t('setup.admin.existsDesc')"
+            type="info"
+            :closable="false"
+            show-icon
+          />
+
+          <ElForm
+            v-else
+            ref="adminFormRef"
+            :model="adminForm"
+            :rules="adminRules"
+            label-position="top"
+          >
+            <ElFormItem :label="t('setup.admin.userName')" prop="userName">
+              <ElInput
+                v-model="adminForm.userName"
+                :placeholder="t('setup.admin.userNamePlaceholder')"
+              />
+            </ElFormItem>
+            <ElFormItem :label="t('setup.admin.password')" prop="password">
+              <ElInput
+                v-model="adminForm.password"
+                type="password"
+                :placeholder="t('setup.admin.passwordPlaceholder')"
+                show-password
+              />
+            </ElFormItem>
+            <ElFormItem :label="t('setup.admin.confirmPassword')" prop="confirmPassword">
+              <ElInput
+                v-model="adminForm.confirmPassword"
+                type="password"
+                :placeholder="t('setup.admin.confirmPasswordPlaceholder')"
+                show-password
+              />
+            </ElFormItem>
+          </ElForm>
+        </section>
+
+        <section v-show="currentStep === 2" class="step-panel">
+          <div class="step-heading">
+            <ElIcon><Operation /></ElIcon>
+            <div>
+              <h3>{{ t('setup.mode.title') }}</h3>
+              <p>{{ t('setup.mode.desc') }}</p>
+            </div>
+          </div>
+
+          <ElRadioGroup v-model="usageMode" class="mode-grid">
+            <label class="mode-option" :class="{ selected: usageMode === 'personal' }">
+              <ElRadio value="personal">{{ t('setup.mode.personal') }}</ElRadio>
+              <span>{{ t('setup.mode.personalDesc') }}</span>
+            </label>
+            <label class="mode-option" :class="{ selected: usageMode === 'family' }">
+              <ElRadio value="family">{{ t('setup.mode.family') }}</ElRadio>
+              <span>{{ t('setup.mode.familyDesc') }}</span>
+            </label>
+          </ElRadioGroup>
+        </section>
+
+        <section v-show="currentStep === 3" class="step-panel">
+          <div class="step-heading">
+            <ElIcon><Select /></ElIcon>
+            <div>
+              <h3>{{ t('setup.finish.title') }}</h3>
+              <p>{{ t('setup.finish.desc') }}</p>
+            </div>
+          </div>
+
+          <div class="summary-list">
+            <div class="info-row">
+              <span>{{ t('setup.finish.database') }}</span>
+              <strong>{{ setupStatus?.database_type || 'SQLite' }}</strong>
+            </div>
+            <div class="info-row">
+              <span>{{ t('setup.finish.admin') }}</span>
+              <strong>{{ adminSummary }}</strong>
+            </div>
+            <div class="info-row">
+              <span>{{ t('setup.finish.usageMode') }}</span>
+              <strong>{{ usageModeLabel }}</strong>
+            </div>
+          </div>
+        </section>
+      </div>
+
+      <div class="setup-actions">
+        <ElButton v-if="currentStep > 0" @click="currentStep--">
+          {{ t('setup.actions.prev') }}
+        </ElButton>
+        <ElButton v-if="currentStep < lastStep" type="primary" @click="nextStep">
+          {{ t('setup.actions.next') }}
+        </ElButton>
+        <ElButton v-else type="primary" :loading="submitting" @click="handleInitialize">
+          {{ t('setup.actions.finish') }}
+        </ElButton>
+      </div>
+    </ElCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { CircleCheckFilled, Operation, Select, UserFilled } from '@element-plus/icons-vue'
+  import { fetchSetupStatus, postSetup } from '@/api/setup'
+  import { ElMessage, type FormInstance, type FormRules } from 'element-plus'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'SetupWizard' })
+
+  const { t } = useI18n()
+  const router = useRouter()
+  const currentStep = ref(0)
+  const loadingStatus = ref(true)
+  const submitting = ref(false)
+  const statusWarning = ref(false)
+  const setupStatus = ref<Api.Setup.SetupStatus>()
+  const lastStep = 3
+
+  const steps = computed(() => [
+    t('setup.steps.database'),
+    t('setup.steps.admin'),
+    t('setup.steps.mode'),
+    t('setup.steps.finish')
+  ])
+
+  const adminFormRef = ref<FormInstance>()
+  const adminForm = reactive({
+    userName: '',
+    password: '',
+    confirmPassword: ''
+  })
+
+  const adminRules = computed<FormRules>(() => ({
+    userName: [
+      { required: true, message: t('setup.validation.userNameRequired'), trigger: 'blur' }
+    ],
+    password: [
+      { required: true, message: t('setup.validation.passwordRequired'), trigger: 'blur' },
+      { min: 8, message: t('setup.validation.passwordLength'), trigger: 'blur' }
+    ],
+    confirmPassword: [
+      { required: true, message: t('setup.validation.confirmPasswordRequired'), trigger: 'blur' },
+      {
+        validator: (_rule: unknown, value: string, callback: (err?: Error) => void) => {
+          if (value !== adminForm.password) {
+            callback(new Error(t('setup.validation.passwordMismatch')))
+            return
+          }
+          callback()
+        },
+        trigger: 'blur'
+      }
+    ]
+  }))
+
+  const usageMode = ref<'personal' | 'family'>('personal')
+  const usageModeLabel = computed(() =>
+    usageMode.value === 'personal' ? t('setup.mode.personal') : t('setup.mode.family')
+  )
+  const adminSummary = computed(() => {
+    if (setupStatus.value?.root_init) return t('setup.admin.existing')
+    return adminForm.userName || t('setup.admin.notSet')
+  })
+
+  const loadStatus = async () => {
+    loadingStatus.value = true
+    statusWarning.value = false
+    try {
+      setupStatus.value = await fetchSetupStatus()
+      if (setupStatus.value?.status) {
+        router.replace('/')
+      }
+    } catch {
+      statusWarning.value = true
+    } finally {
+      loadingStatus.value = false
+    }
+  }
+
+  const nextStep = async () => {
+    if (currentStep.value === 1 && !setupStatus.value?.root_init) {
+      if (!adminFormRef.value) return
+      const valid = await adminFormRef.value.validate().catch(() => false)
+      if (!valid) return
+    }
+    currentStep.value = Math.min(currentStep.value + 1, lastStep)
+  }
+
+  const handleInitialize = async () => {
+    submitting.value = true
+    try {
+      await postSetup({
+        userName: adminForm.userName,
+        password: adminForm.password,
+        confirmPassword: adminForm.confirmPassword,
+        usageMode: usageMode.value
+      })
+      ElMessage.success(t('setup.message.success'))
+      window.setTimeout(() => {
+        router.replace('/auth/login')
+      }, 1200)
+    } catch {
+      // Error handled by http interceptor
+    } finally {
+      submitting.value = false
+    }
+  }
+
+  onMounted(loadStatus)
+</script>
+
+<style scoped lang="scss">
+  .setup-page {
+    display: grid;
+    grid-template-columns: minmax(280px, 0.8fr) minmax(420px, 560px);
+    gap: 28px;
+    align-items: center;
+    min-height: 100vh;
+    padding: 40px;
+    background: var(--art-main-bg-color);
+  }
+
+  .setup-brand {
+    display: grid;
+    gap: 18px;
+    max-width: 560px;
+
+    h1 {
+      margin: 0;
+      font-size: 38px;
+      line-height: 1.16;
+      color: var(--art-gray-800);
+    }
+
+    p {
+      max-width: 460px;
+      margin: 0;
+      color: var(--art-gray-600);
+      font-size: 16px;
+      line-height: 1.8;
+    }
+  }
+
+  .setup-eyebrow {
+    color: var(--main-color) !important;
+    font-size: 13px !important;
+    font-weight: 600;
+  }
+
+  .brand-status {
+    display: flex;
+    gap: 14px;
+    align-items: center;
+    width: min(100%, 420px);
+    padding: 16px;
+    margin-top: 12px;
+    background: var(--default-box-color);
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+
+    strong,
+    span {
+      display: block;
+    }
+
+    span {
+      margin-top: 3px;
+      color: var(--art-gray-600);
+      font-size: 13px;
+      line-height: 1.5;
+    }
+  }
+
+  .brand-status__icon,
+  .step-heading .el-icon {
+    display: inline-flex;
+    flex: 0 0 auto;
+    align-items: center;
+    justify-content: center;
+    width: 38px;
+    height: 38px;
+    color: var(--main-color);
+    background: color-mix(in srgb, var(--main-color) 10%, transparent);
+    border-radius: 8px;
+  }
+
+  .setup-card {
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+
+    :deep(.el-card__body) {
+      padding: 24px;
+    }
+  }
+
+  .card-header {
+    display: flex;
+    gap: 16px;
+    align-items: flex-start;
+    justify-content: space-between;
+
+    h2,
+    p {
+      margin: 0;
+    }
+
+    h2 {
+      font-size: 20px;
+      font-weight: 600;
+    }
+
+    p {
+      margin-top: 6px;
+      color: var(--art-gray-600);
+      font-size: 13px;
+    }
+  }
+
+  .setup-alert {
+    margin-bottom: 18px;
+  }
+
+  .setup-content {
+    min-height: 310px;
+    padding: 26px 0 8px;
+  }
+
+  .step-panel {
+    display: grid;
+    gap: 18px;
+  }
+
+  .step-heading {
+    display: flex;
+    gap: 12px;
+    align-items: flex-start;
+
+    h3,
+    p {
+      margin: 0;
+    }
+
+    h3 {
+      font-size: 18px;
+      font-weight: 600;
+    }
+
+    p {
+      margin-top: 5px;
+      color: var(--art-gray-600);
+      font-size: 13px;
+    }
+  }
+
+  .info-row {
+    display: flex;
+    gap: 16px;
+    align-items: center;
+    justify-content: space-between;
+    padding: 14px 16px;
+    background: var(--art-main-bg-color);
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+
+    span {
+      color: var(--art-gray-600);
+    }
+  }
+
+  .muted {
+    margin: 0;
+    color: var(--art-gray-600);
+    font-size: 13px;
+  }
+
+  .mode-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 14px;
+    width: 100%;
+  }
+
+  .mode-option {
+    display: grid;
+    gap: 8px;
+    min-height: 118px;
+    padding: 16px;
+    cursor: pointer;
+    border: 1px solid var(--art-border-color);
+    border-radius: 8px;
+    transition:
+      border-color 0.2s ease,
+      background 0.2s ease;
+
+    &.selected {
+      background: color-mix(in srgb, var(--main-color) 8%, transparent);
+      border-color: var(--main-color);
+    }
+
+    span {
+      color: var(--art-gray-600);
+      font-size: 13px;
+      line-height: 1.6;
+    }
+  }
+
+  .summary-list {
+    display: grid;
+    gap: 12px;
+  }
+
+  .setup-actions {
+    display: flex;
+    gap: 12px;
+    justify-content: flex-end;
+    padding-top: 18px;
+    border-top: 1px solid var(--art-border-color);
+  }
+
+  @media (max-width: 980px) {
+    .setup-page {
+      grid-template-columns: 1fr;
+      align-items: stretch;
+      padding: 24px;
+    }
+
+    .setup-brand {
+      max-width: none;
+
+      h1 {
+        font-size: 30px;
+      }
+    }
+  }
+
+  @media (max-width: 640px) {
+    .setup-page {
+      padding: 14px;
+    }
+
+    .mode-grid {
+      grid-template-columns: 1fr;
+    }
+
+    .setup-actions {
+      flex-direction: column-reverse;
+
+      .el-button {
+        width: 100%;
+        margin-left: 0;
+      }
+    }
+  }
+</style>
diff --git a/web/src/views/system/menu/index.vue b/web/src/views/system/menu/index.vue
new file mode 100644
index 0000000..24c84df
--- /dev/null
+++ b/web/src/views/system/menu/index.vue
@@ -0,0 +1,483 @@
+<!-- 菜单管理页面 -->
+<template>
+  <div class="menu-page art-full-height">
+    <!-- 搜索栏 -->
+    <ArtSearchBar
+      v-model="formFilters"
+      :items="formItems"
+      :showExpand="false"
+      @reset="handleReset"
+      @search="handleSearch"
+    />
+
+    <ElCard class="art-table-card">
+      <!-- 表格头部 -->
+      <ArtTableHeader
+        :showZebra="false"
+        :loading="loading"
+        v-model:columns="columnChecks"
+        @refresh="handleRefresh"
+      >
+        <template #left>
+          <ElButton v-auth="'add'" @click="handleAddMenu" v-ripple>
+            {{ t('systemPage.menu.add') }}
+          </ElButton>
+          <ElButton @click="toggleExpand" v-ripple>
+            {{ isExpanded ? t('systemPage.menu.collapse') : t('systemPage.menu.expand') }}
+          </ElButton>
+        </template>
+      </ArtTableHeader>
+
+      <ArtTable
+        ref="tableRef"
+        rowKey="path"
+        :loading="loading"
+        :columns="columns"
+        :data="filteredTableData"
+        :stripe="false"
+        :tree-props="{ children: 'children', hasChildren: 'hasChildren' }"
+        :default-expand-all="false"
+      />
+
+      <!-- 菜单弹窗 -->
+      <MenuDialog
+        v-model:visible="dialogVisible"
+        :type="dialogType"
+        :editData="editData"
+        :lockType="lockMenuType"
+        @submit="handleSubmit"
+      />
+    </ElCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { formatMenuTitle } from '@/utils/router'
+  import ArtButtonTable from '@/components/core/forms/art-button-table/index.vue'
+  import { useTableColumns } from '@/hooks/core/useTableColumns'
+  import type { AppRouteRecord } from '@/types/router'
+  import MenuDialog from './modules/menu-dialog.vue'
+  import { fetchGetMenuList } from '@/api/system-manage'
+  import { ElTag, ElMessageBox } from 'element-plus'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'Menus' })
+
+  const { t } = useI18n()
+  // 状态管理
+  const loading = ref(false)
+  const isExpanded = ref(false)
+  const tableRef = ref()
+
+  // 弹窗相关
+  const dialogVisible = ref(false)
+  const dialogType = ref<'menu' | 'button'>('menu')
+  const editData = ref<AppRouteRecord | any>(null)
+  const lockMenuType = ref(false)
+
+  // 搜索相关
+  const initialSearchState = {
+    name: '',
+    route: ''
+  }
+
+  const formFilters = reactive({ ...initialSearchState })
+  const appliedFilters = reactive({ ...initialSearchState })
+
+  const formItems = computed(() => [
+    {
+      label: t('systemPage.menu.filters.name'),
+      key: 'name',
+      type: 'input',
+      props: { clearable: true }
+    },
+    {
+      label: t('systemPage.menu.filters.route'),
+      key: 'route',
+      type: 'input',
+      props: { clearable: true }
+    }
+  ])
+
+  onMounted(() => {
+    getMenuList()
+  })
+
+  /**
+   * 获取菜单列表数据
+   */
+  const getMenuList = async (): Promise<void> => {
+    loading.value = true
+
+    try {
+      const list = await fetchGetMenuList()
+      tableData.value = list
+    } catch (error) {
+      throw error instanceof Error ? error : new Error(t('httpMsg.requestFailed'))
+    } finally {
+      loading.value = false
+    }
+  }
+
+  /**
+   * 获取菜单类型标签颜色
+   * @param row 菜单行数据
+   * @returns 标签颜色类型
+   */
+  const getMenuTypeTag = (
+    row: AppRouteRecord
+  ): 'primary' | 'success' | 'warning' | 'info' | 'danger' => {
+    if (row.meta?.isAuthButton) return 'danger'
+    if (row.children?.length) return 'info'
+    if (row.meta?.link && row.meta?.isIframe) return 'success'
+    if (row.path) return 'primary'
+    if (row.meta?.link) return 'warning'
+    return 'info'
+  }
+
+  /**
+   * 获取菜单类型文本
+   * @param row 菜单行数据
+   * @returns 菜单类型文本
+   */
+  const getMenuTypeText = (row: AppRouteRecord): string => {
+    if (row.meta?.isAuthButton) return t('systemPage.menu.type.button')
+    if (row.children?.length) return t('systemPage.menu.type.directory')
+    if (row.meta?.link && row.meta?.isIframe) return t('systemPage.menu.type.iframe')
+    if (row.path) return t('systemPage.menu.type.menu')
+    if (row.meta?.link) return t('systemPage.menu.type.external')
+    return t('systemPage.menu.type.unknown')
+  }
+
+  // 表格列配置
+  const { columnChecks, columns } = useTableColumns(() => [
+    {
+      prop: 'meta.title',
+      label: t('systemPage.menu.columns.name'),
+      minWidth: 120,
+      formatter: (row: AppRouteRecord) => formatMenuTitle(row.meta?.title)
+    },
+    {
+      prop: 'type',
+      label: t('systemPage.menu.columns.type'),
+      formatter: (row: AppRouteRecord) => {
+        return h(ElTag, { type: getMenuTypeTag(row) }, () => getMenuTypeText(row))
+      }
+    },
+    {
+      prop: 'path',
+      label: t('systemPage.menu.columns.route'),
+      formatter: (row: AppRouteRecord) => {
+        if (row.meta?.isAuthButton) return ''
+        return row.meta?.link || row.path || ''
+      }
+    },
+    {
+      prop: 'meta.authList',
+      label: t('systemPage.menu.columns.auth'),
+      formatter: (row: AppRouteRecord) => {
+        if (row.meta?.isAuthButton) {
+          return row.meta?.authMark || ''
+        }
+        if (!row.meta?.authList?.length) return ''
+        return t('systemPage.menu.authCount', { count: row.meta.authList.length })
+      }
+    },
+    {
+      prop: 'date',
+      label: t('systemPage.menu.columns.editTime'),
+      formatter: () => '2022-3-12 12:00:00'
+    },
+    {
+      prop: 'status',
+      label: t('systemPage.menu.columns.status'),
+      formatter: () => h(ElTag, { type: 'success' }, () => t('common.enabled'))
+    },
+    {
+      prop: 'operation',
+      label: t('systemPage.menu.columns.operation'),
+      width: 180,
+      align: 'right',
+      formatter: (row: AppRouteRecord) => {
+        const buttonStyle = { style: 'text-align: right' }
+
+        if (row.meta?.isAuthButton) {
+          return h('div', buttonStyle, [
+            h(ArtButtonTable, {
+              type: 'edit',
+              onClick: () => handleEditAuth(row)
+            }),
+            h(ArtButtonTable, {
+              type: 'delete',
+              onClick: () => handleDeleteAuth()
+            })
+          ])
+        }
+
+        return h('div', buttonStyle, [
+          h(ArtButtonTable, {
+            type: 'add',
+            onClick: () => handleAddAuth(),
+            title: t('systemPage.menu.addAuth')
+          }),
+          h(ArtButtonTable, {
+            type: 'edit',
+            onClick: () => handleEditMenu(row)
+          }),
+          h(ArtButtonTable, {
+            type: 'delete',
+            onClick: () => handleDeleteMenu()
+          })
+        ])
+      }
+    }
+  ])
+
+  // 数据相关
+  const tableData = ref<AppRouteRecord[]>([])
+
+  /**
+   * 重置搜索条件
+   */
+  const handleReset = (): void => {
+    Object.assign(formFilters, { ...initialSearchState })
+    Object.assign(appliedFilters, { ...initialSearchState })
+    getMenuList()
+  }
+
+  /**
+   * 执行搜索
+   */
+  const handleSearch = (): void => {
+    Object.assign(appliedFilters, { ...formFilters })
+    getMenuList()
+  }
+
+  /**
+   * 刷新菜单列表
+   */
+  const handleRefresh = (): void => {
+    getMenuList()
+  }
+
+  /**
+   * 深度克隆对象
+   * @param obj 要克隆的对象
+   * @returns 克隆后的对象
+   */
+  const deepClone = <T,>(obj: T): T => {
+    if (obj === null || typeof obj !== 'object') return obj
+    if (obj instanceof Date) return new Date(obj) as T
+    if (Array.isArray(obj)) return obj.map((item) => deepClone(item)) as T
+
+    const cloned = {} as T
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        cloned[key] = deepClone(obj[key])
+      }
+    }
+    return cloned
+  }
+
+  /**
+   * 将权限列表转换为子节点
+   * @param items 菜单项数组
+   * @returns 转换后的菜单项数组
+   */
+  const convertAuthListToChildren = (items: AppRouteRecord[]): AppRouteRecord[] => {
+    return items.map((item) => {
+      const clonedItem = deepClone(item)
+
+      if (clonedItem.children?.length) {
+        clonedItem.children = convertAuthListToChildren(clonedItem.children)
+      }
+
+      if (item.meta?.authList?.length) {
+        const authChildren: AppRouteRecord[] = item.meta.authList.map(
+          (auth: { title: string; authMark: string }) => ({
+            path: `${item.path}_auth_${auth.authMark}`,
+            name: `${String(item.name)}_auth_${auth.authMark}`,
+            meta: {
+              title: auth.title,
+              authMark: auth.authMark,
+              isAuthButton: true,
+              parentPath: item.path
+            }
+          })
+        )
+
+        clonedItem.children = clonedItem.children?.length
+          ? [...clonedItem.children, ...authChildren]
+          : authChildren
+      }
+
+      return clonedItem
+    })
+  }
+
+  /**
+   * 搜索菜单
+   * @param items 菜单项数组
+   * @returns 搜索结果数组
+   */
+  const searchMenu = (items: AppRouteRecord[]): AppRouteRecord[] => {
+    const results: AppRouteRecord[] = []
+
+    for (const item of items) {
+      const searchName = appliedFilters.name?.toLowerCase().trim() || ''
+      const searchRoute = appliedFilters.route?.toLowerCase().trim() || ''
+      const menuTitle = formatMenuTitle(item.meta?.title || '').toLowerCase()
+      const menuPath = (item.path || '').toLowerCase()
+      const nameMatch = !searchName || menuTitle.includes(searchName)
+      const routeMatch = !searchRoute || menuPath.includes(searchRoute)
+
+      if (item.children?.length) {
+        const matchedChildren = searchMenu(item.children)
+        if (matchedChildren.length > 0) {
+          const clonedItem = deepClone(item)
+          clonedItem.children = matchedChildren
+          results.push(clonedItem)
+          continue
+        }
+      }
+
+      if (nameMatch && routeMatch) {
+        results.push(deepClone(item))
+      }
+    }
+
+    return results
+  }
+
+  // 过滤后的表格数据
+  const filteredTableData = computed(() => {
+    const searchedData = searchMenu(tableData.value)
+    return convertAuthListToChildren(searchedData)
+  })
+
+  /**
+   * 添加菜单
+   */
+  const handleAddMenu = (): void => {
+    dialogType.value = 'menu'
+    editData.value = null
+    lockMenuType.value = true
+    dialogVisible.value = true
+  }
+
+  /**
+   * 添加权限按钮
+   */
+  const handleAddAuth = (): void => {
+    dialogType.value = 'menu'
+    editData.value = null
+    lockMenuType.value = false
+    dialogVisible.value = true
+  }
+
+  /**
+   * 编辑菜单
+   * @param row 菜单行数据
+   */
+  const handleEditMenu = (row: AppRouteRecord): void => {
+    dialogType.value = 'menu'
+    editData.value = row
+    lockMenuType.value = true
+    dialogVisible.value = true
+  }
+
+  /**
+   * 编辑权限按钮
+   * @param row 权限行数据
+   */
+  const handleEditAuth = (row: AppRouteRecord): void => {
+    dialogType.value = 'button'
+    editData.value = {
+      title: row.meta?.title,
+      authMark: row.meta?.authMark
+    }
+    lockMenuType.value = false
+    dialogVisible.value = true
+  }
+
+  /**
+   * 菜单表单数据类型
+   */
+  interface MenuFormData {
+    name: string
+    path: string
+    component?: string
+    icon?: string
+    roles?: string[]
+    sort?: number
+    [key: string]: any
+  }
+
+  /**
+   * 提交表单数据
+   * @param formData 表单数据
+   */
+  const handleSubmit = (formData: MenuFormData): void => {
+    console.log('提交数据:', formData)
+    // TODO: 调用API保存数据
+    getMenuList()
+  }
+
+  /**
+   * 删除菜单
+   */
+  const handleDeleteMenu = async (): Promise<void> => {
+    try {
+      await ElMessageBox.confirm(t('systemPage.menu.deleteMenuConfirm'), t('common.tips'), {
+        confirmButtonText: t('common.confirm'),
+        cancelButtonText: t('common.cancel'),
+        type: 'warning'
+      })
+      ElMessage.success(t('systemPage.menu.deleteSuccess'))
+      getMenuList()
+    } catch (error) {
+      if (error !== 'cancel') {
+        ElMessage.error(t('systemPage.menu.deleteFailed'))
+      }
+    }
+  }
+
+  /**
+   * 删除权限按钮
+   */
+  const handleDeleteAuth = async (): Promise<void> => {
+    try {
+      await ElMessageBox.confirm(t('systemPage.menu.deleteAuthConfirm'), t('common.tips'), {
+        confirmButtonText: t('common.confirm'),
+        cancelButtonText: t('common.cancel'),
+        type: 'warning'
+      })
+      ElMessage.success(t('systemPage.menu.deleteSuccess'))
+      getMenuList()
+    } catch (error) {
+      if (error !== 'cancel') {
+        ElMessage.error(t('systemPage.menu.deleteFailed'))
+      }
+    }
+  }
+
+  /**
+   * 切换展开/收起所有菜单
+   */
+  const toggleExpand = (): void => {
+    isExpanded.value = !isExpanded.value
+    nextTick(() => {
+      if (tableRef.value?.elTableRef && filteredTableData.value) {
+        const processRows = (rows: AppRouteRecord[]) => {
+          rows.forEach((row) => {
+            if (row.children?.length) {
+              tableRef.value.elTableRef.toggleRowExpansion(row, isExpanded.value)
+              processRows(row.children)
+            }
+          })
+        }
+        processRows(filteredTableData.value)
+      }
+    })
+  }
+</script>
diff --git a/web/src/views/system/menu/modules/menu-dialog.vue b/web/src/views/system/menu/modules/menu-dialog.vue
new file mode 100644
index 0000000..2babe9b
--- /dev/null
+++ b/web/src/views/system/menu/modules/menu-dialog.vue
@@ -0,0 +1,465 @@
+<template>
+  <ElDialog
+    :title="dialogTitle"
+    :model-value="visible"
+    @update:model-value="handleCancel"
+    width="860px"
+    align-center
+    class="menu-dialog"
+    @closed="handleClosed"
+  >
+    <ArtForm
+      ref="formRef"
+      v-model="form"
+      :items="formItems"
+      :rules="rules"
+      :span="width > 640 ? 12 : 24"
+      :gutter="20"
+      label-width="100px"
+      :show-reset="false"
+      :show-submit="false"
+    >
+      <template #menuType>
+        <ElRadioGroup v-model="form.menuType" :disabled="disableMenuType">
+          <ElRadioButton value="menu" label="menu">{{
+            t('systemPage.menu.dialog.menu')
+          }}</ElRadioButton>
+          <ElRadioButton value="button" label="button">{{
+            t('systemPage.menu.dialog.button')
+          }}</ElRadioButton>
+        </ElRadioGroup>
+      </template>
+    </ArtForm>
+
+    <template #footer>
+      <span class="dialog-footer">
+        <ElButton @click="handleCancel">{{ t('common.cancel') }}</ElButton>
+        <ElButton type="primary" @click="handleSubmit">{{ t('common.confirm') }}</ElButton>
+      </span>
+    </template>
+  </ElDialog>
+</template>
+
+<script setup lang="ts">
+  import type { FormRules } from 'element-plus'
+  import { ElIcon, ElTooltip } from 'element-plus'
+  import { QuestionFilled } from '@element-plus/icons-vue'
+  import { formatMenuTitle } from '@/utils/router'
+  import type { AppRouteRecord } from '@/types/router'
+  import type { FormItem } from '@/components/core/forms/art-form/index.vue'
+  import ArtForm from '@/components/core/forms/art-form/index.vue'
+  import { useWindowSize } from '@vueuse/core'
+  import { useI18n } from 'vue-i18n'
+
+  const { width } = useWindowSize()
+  const { t } = useI18n()
+
+  /**
+   * 创建带 tooltip 的表单标签
+   * @param label 标签文本
+   * @param tooltip 提示文本
+   * @returns 渲染函数
+   */
+  const createLabelTooltip = (label: string, tooltip: string) => {
+    return () =>
+      h('span', { class: 'flex items-center' }, [
+        h('span', label),
+        h(
+          ElTooltip,
+          {
+            content: tooltip,
+            placement: 'top'
+          },
+          () => h(ElIcon, { class: 'ml-0.5 cursor-help' }, () => h(QuestionFilled))
+        )
+      ])
+  }
+
+  interface MenuFormData {
+    id: number
+    name: string
+    path: string
+    label: string
+    component: string
+    icon: string
+    isEnable: boolean
+    sort: number
+    isMenu: boolean
+    keepAlive: boolean
+    isHide: boolean
+    isHideTab: boolean
+    link: string
+    isIframe: boolean
+    showBadge: boolean
+    showTextBadge: string
+    fixedTab: boolean
+    activePath: string
+    roles: string[]
+    isFullPage: boolean
+    authName: string
+    authLabel: string
+    authIcon: string
+    authSort: number
+  }
+
+  interface Props {
+    visible: boolean
+    editData?: AppRouteRecord | any
+    type?: 'menu' | 'button'
+    lockType?: boolean
+  }
+
+  interface Emits {
+    (e: 'update:visible', value: boolean): void
+    (e: 'submit', data: MenuFormData): void
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    visible: false,
+    type: 'menu',
+    lockType: false
+  })
+
+  const emit = defineEmits<Emits>()
+
+  const formRef = ref()
+  const isEdit = ref(false)
+
+  const form = reactive<MenuFormData & { menuType: 'menu' | 'button' }>({
+    menuType: 'menu',
+    id: 0,
+    name: '',
+    path: '',
+    label: '',
+    component: '',
+    icon: '',
+    isEnable: true,
+    sort: 1,
+    isMenu: true,
+    keepAlive: true,
+    isHide: false,
+    isHideTab: false,
+    link: '',
+    isIframe: false,
+    showBadge: false,
+    showTextBadge: '',
+    fixedTab: false,
+    activePath: '',
+    roles: [],
+    isFullPage: false,
+    authName: '',
+    authLabel: '',
+    authIcon: '',
+    authSort: 1
+  })
+
+  const rules = reactive<FormRules>({
+    name: [
+      { required: true, message: t('systemPage.menu.dialog.namePlaceholder'), trigger: 'blur' },
+      { min: 2, max: 20, message: t('userCenter.validation.length'), trigger: 'blur' }
+    ],
+    path: [
+      { required: true, message: t('systemPage.menu.dialog.pathPlaceholder'), trigger: 'blur' }
+    ],
+    label: [
+      { required: true, message: t('systemPage.menu.dialog.labelPlaceholder'), trigger: 'blur' }
+    ],
+    authName: [
+      { required: true, message: t('systemPage.menu.dialog.authNamePlaceholder'), trigger: 'blur' }
+    ],
+    authLabel: [
+      { required: true, message: t('systemPage.menu.dialog.authLabelPlaceholder'), trigger: 'blur' }
+    ]
+  })
+
+  /**
+   * 表单项配置
+   */
+  const formItems = computed<FormItem[]>(() => {
+    const baseItems: FormItem[] = [
+      { label: t('systemPage.menu.dialog.menuType'), key: 'menuType', span: 24 }
+    ]
+
+    // Switch 组件的 span：小屏幕 12，大屏幕 6
+    const switchSpan = width.value < 640 ? 12 : 6
+
+    if (form.menuType === 'menu') {
+      return [
+        ...baseItems,
+        {
+          label: t('systemPage.menu.dialog.name'),
+          key: 'name',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.namePlaceholder') }
+        },
+        {
+          label: createLabelTooltip(
+            t('systemPage.menu.dialog.path'),
+            t('systemPage.menu.dialog.pathTip')
+          ),
+          key: 'path',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.pathPlaceholder') }
+        },
+        {
+          label: t('systemPage.menu.dialog.label'),
+          key: 'label',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.labelPlaceholder') }
+        },
+        {
+          label: createLabelTooltip(
+            t('systemPage.menu.dialog.component'),
+            t('systemPage.menu.dialog.componentTip')
+          ),
+          key: 'component',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.componentPlaceholder') }
+        },
+        {
+          label: t('systemPage.menu.dialog.icon'),
+          key: 'icon',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.iconPlaceholder') }
+        },
+        {
+          label: createLabelTooltip(
+            t('systemPage.menu.dialog.roles'),
+            t('systemPage.menu.dialog.rolesTip')
+          ),
+          key: 'roles',
+          type: 'inputtag',
+          props: { placeholder: t('systemPage.menu.dialog.rolesPlaceholder') }
+        },
+        {
+          label: t('systemPage.menu.dialog.sort'),
+          key: 'sort',
+          type: 'number',
+          props: { min: 1, controlsPosition: 'right', style: { width: '100%' } }
+        },
+        {
+          label: t('systemPage.menu.dialog.link'),
+          key: 'link',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.linkPlaceholder') }
+        },
+        {
+          label: t('systemPage.menu.dialog.badge'),
+          key: 'showTextBadge',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.badgePlaceholder') }
+        },
+        {
+          label: createLabelTooltip(
+            t('systemPage.menu.dialog.activePath'),
+            t('systemPage.menu.dialog.activePathTip')
+          ),
+          key: 'activePath',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.activePathPlaceholder') }
+        },
+        {
+          label: t('systemPage.menu.dialog.isEnable'),
+          key: 'isEnable',
+          type: 'switch',
+          span: switchSpan
+        },
+        {
+          label: t('systemPage.menu.dialog.keepAlive'),
+          key: 'keepAlive',
+          type: 'switch',
+          span: switchSpan
+        },
+        {
+          label: t('systemPage.menu.dialog.isHide'),
+          key: 'isHide',
+          type: 'switch',
+          span: switchSpan
+        },
+        {
+          label: t('systemPage.menu.dialog.isIframe'),
+          key: 'isIframe',
+          type: 'switch',
+          span: switchSpan
+        },
+        {
+          label: t('systemPage.menu.dialog.showBadge'),
+          key: 'showBadge',
+          type: 'switch',
+          span: switchSpan
+        },
+        {
+          label: t('systemPage.menu.dialog.fixedTab'),
+          key: 'fixedTab',
+          type: 'switch',
+          span: switchSpan
+        },
+        {
+          label: t('systemPage.menu.dialog.isHideTab'),
+          key: 'isHideTab',
+          type: 'switch',
+          span: switchSpan
+        },
+        {
+          label: t('systemPage.menu.dialog.isFullPage'),
+          key: 'isFullPage',
+          type: 'switch',
+          span: switchSpan
+        }
+      ]
+    } else {
+      return [
+        ...baseItems,
+        {
+          label: t('systemPage.menu.dialog.authName'),
+          key: 'authName',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.authNamePlaceholder') }
+        },
+        {
+          label: t('systemPage.menu.dialog.authLabel'),
+          key: 'authLabel',
+          type: 'input',
+          props: { placeholder: t('systemPage.menu.dialog.authLabelPlaceholder') }
+        },
+        {
+          label: t('systemPage.menu.dialog.authSort'),
+          key: 'authSort',
+          type: 'number',
+          props: { min: 1, controlsPosition: 'right', style: { width: '100%' } }
+        }
+      ]
+    }
+  })
+
+  const dialogTitle = computed(() => {
+    if (form.menuType === 'menu') {
+      return isEdit.value
+        ? t('systemPage.menu.dialog.editMenu')
+        : t('systemPage.menu.dialog.newMenu')
+    }
+    return isEdit.value
+      ? t('systemPage.menu.dialog.editButton')
+      : t('systemPage.menu.dialog.newButton')
+  })
+
+  /**
+   * 是否禁用菜单类型切换
+   */
+  const disableMenuType = computed(() => {
+    if (isEdit.value) return true
+    if (!isEdit.value && form.menuType === 'menu' && props.lockType) return true
+    return false
+  })
+
+  /**
+   * 重置表单数据
+   */
+  const resetForm = (): void => {
+    formRef.value?.reset()
+    form.menuType = 'menu'
+  }
+
+  /**
+   * 加载表单数据（编辑模式）
+   */
+  const loadFormData = (): void => {
+    if (!props.editData) return
+
+    isEdit.value = true
+
+    if (form.menuType === 'menu') {
+      const row = props.editData
+      form.id = row.id || 0
+      form.name = formatMenuTitle(row.meta?.title || '')
+      form.path = row.path || ''
+      form.label = row.name || ''
+      form.component = row.component || ''
+      form.icon = row.meta?.icon || ''
+      form.sort = row.meta?.sort || 1
+      form.isMenu = row.meta?.isMenu ?? true
+      form.keepAlive = row.meta?.keepAlive ?? false
+      form.isHide = row.meta?.isHide ?? false
+      form.isHideTab = row.meta?.isHideTab ?? false
+      form.isEnable = row.meta?.isEnable ?? true
+      form.link = row.meta?.link || ''
+      form.isIframe = row.meta?.isIframe ?? false
+      form.showBadge = row.meta?.showBadge ?? false
+      form.showTextBadge = row.meta?.showTextBadge || ''
+      form.fixedTab = row.meta?.fixedTab ?? false
+      form.activePath = row.meta?.activePath || ''
+      form.roles = row.meta?.roles || []
+      form.isFullPage = row.meta?.isFullPage ?? false
+    } else {
+      const row = props.editData
+      form.authName = row.title || ''
+      form.authLabel = row.authMark || ''
+      form.authIcon = row.icon || ''
+      form.authSort = row.sort || 1
+    }
+  }
+
+  /**
+   * 提交表单
+   */
+  const handleSubmit = async (): Promise<void> => {
+    if (!formRef.value) return
+
+    try {
+      await formRef.value.validate()
+      emit('submit', { ...form })
+      ElMessage.success(
+        t('systemPage.menu.dialog.submitSuccess', {
+          action: isEdit.value ? t('common.edit') : t('common.add')
+        })
+      )
+      handleCancel()
+    } catch {
+      ElMessage.error(t('systemPage.menu.dialog.validateFailed'))
+    }
+  }
+
+  /**
+   * 取消操作
+   */
+  const handleCancel = (): void => {
+    emit('update:visible', false)
+  }
+
+  /**
+   * 对话框关闭后的回调
+   */
+  const handleClosed = (): void => {
+    resetForm()
+    isEdit.value = false
+  }
+
+  /**
+   * 监听对话框显示状态
+   */
+  watch(
+    () => props.visible,
+    (newVal) => {
+      if (newVal) {
+        form.menuType = props.type
+        nextTick(() => {
+          if (props.editData) {
+            loadFormData()
+          }
+        })
+      }
+    }
+  )
+
+  /**
+   * 监听菜单类型变化
+   */
+  watch(
+    () => props.type,
+    (newType) => {
+      if (props.visible) {
+        form.menuType = newType
+      }
+    }
+  )
+</script>
diff --git a/web/src/views/system/role/index.vue b/web/src/views/system/role/index.vue
new file mode 100755
index 0000000..020853d
--- /dev/null
+++ b/web/src/views/system/role/index.vue
@@ -0,0 +1,246 @@
+<!-- 角色管理页面 -->
+<template>
+  <div class="art-full-height">
+    <RoleSearch
+      v-show="showSearchBar"
+      v-model="searchForm"
+      @search="handleSearch"
+      @reset="resetSearchParams"
+    ></RoleSearch>
+
+    <ElCard class="art-table-card" :style="{ 'margin-top': showSearchBar ? '12px' : '0' }">
+      <ArtTableHeader
+        v-model:columns="columnChecks"
+        v-model:showSearchBar="showSearchBar"
+        :loading="loading"
+        @refresh="refreshData"
+      >
+        <template #left>
+          <ElSpace wrap>
+            <ElButton @click="showDialog('add')" v-ripple>{{ t('systemPage.role.add') }}</ElButton>
+          </ElSpace>
+        </template>
+      </ArtTableHeader>
+
+      <!-- 表格 -->
+      <ArtTable
+        :loading="loading"
+        :data="data"
+        :columns="columns"
+        :pagination="pagination"
+        @pagination:size-change="handleSizeChange"
+        @pagination:current-change="handleCurrentChange"
+      >
+      </ArtTable>
+    </ElCard>
+
+    <!-- 角色编辑弹窗 -->
+    <RoleEditDialog
+      v-model="dialogVisible"
+      :dialog-type="dialogType"
+      :role-data="currentRoleData"
+      @success="refreshData"
+    />
+
+    <!-- 菜单权限弹窗 -->
+    <RolePermissionDialog
+      v-model="permissionDialog"
+      :role-data="currentRoleData"
+      @success="refreshData"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { ButtonMoreItem } from '@/components/core/forms/art-button-more/index.vue'
+  import { useTable } from '@/hooks/core/useTable'
+  import { fetchGetRoleList } from '@/api/system-manage'
+  import ArtButtonMore from '@/components/core/forms/art-button-more/index.vue'
+  import RoleSearch from './modules/role-search.vue'
+  import RoleEditDialog from './modules/role-edit-dialog.vue'
+  import RolePermissionDialog from './modules/role-permission-dialog.vue'
+  import { ElTag, ElMessageBox } from 'element-plus'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'Role' })
+
+  const { t } = useI18n()
+  type RoleListItem = Api.SystemManage.RoleListItem
+  type RoleSearchFormParams = Api.SystemManage.RoleSearchParams & {
+    daterange?: string[]
+  }
+
+  // 搜索表单
+  const searchForm = ref<RoleSearchFormParams>({
+    roleName: undefined,
+    roleCode: undefined,
+    description: undefined,
+    enabled: undefined,
+    daterange: undefined
+  })
+
+  const showSearchBar = ref(false)
+
+  const dialogVisible = ref(false)
+  const permissionDialog = ref(false)
+  const currentRoleData = ref<RoleListItem | undefined>(undefined)
+
+  const {
+    columns,
+    columnChecks,
+    data,
+    loading,
+    pagination,
+    getData,
+    replaceSearchParams,
+    resetSearchParams,
+    handleSizeChange,
+    handleCurrentChange,
+    refreshData
+  } = useTable({
+    // 核心配置
+    core: {
+      apiFn: fetchGetRoleList,
+      apiParams: {
+        current: 1,
+        size: 20
+      },
+      // 排除 apiParams 中的属性
+      excludeParams: ['daterange'],
+      columnsFactory: () => [
+        {
+          prop: 'roleId',
+          label: t('systemPage.role.columns.id'),
+          width: 100
+        },
+        {
+          prop: 'roleName',
+          label: t('systemPage.role.columns.name'),
+          minWidth: 120
+        },
+        {
+          prop: 'roleCode',
+          label: t('systemPage.role.columns.code'),
+          minWidth: 120
+        },
+        {
+          prop: 'description',
+          label: t('systemPage.role.columns.description'),
+          minWidth: 150,
+          showOverflowTooltip: true
+        },
+        {
+          prop: 'enabled',
+          label: t('systemPage.role.columns.status'),
+          width: 100,
+          formatter: (row) => {
+            const statusConfig = row.enabled
+              ? { type: 'success', text: t('common.enabled') }
+              : { type: 'warning', text: t('common.disabled') }
+            return h(
+              ElTag,
+              { type: statusConfig.type as 'success' | 'warning' },
+              () => statusConfig.text
+            )
+          }
+        },
+        {
+          prop: 'createTime',
+          label: t('common.createTime'),
+          width: 180,
+          sortable: true
+        },
+        {
+          prop: 'operation',
+          label: t('common.actions'),
+          width: 80,
+          fixed: 'right',
+          formatter: (row) =>
+            h('div', [
+              h(ArtButtonMore, {
+                list: [
+                  {
+                    key: 'permission',
+                    label: t('systemPage.role.columns.menuPermission'),
+                    icon: 'ri:user-3-line'
+                  },
+                  {
+                    key: 'edit',
+                    label: t('systemPage.role.columns.editRole'),
+                    icon: 'ri:edit-2-line'
+                  },
+                  {
+                    key: 'delete',
+                    label: t('systemPage.role.columns.deleteRole'),
+                    icon: 'ri:delete-bin-4-line',
+                    color: '#f56c6c'
+                  }
+                ],
+                onClick: (item: ButtonMoreItem) => buttonMoreClick(item, row)
+              })
+            ])
+        }
+      ]
+    }
+  })
+
+  const dialogType = ref<'add' | 'edit'>('add')
+
+  const showDialog = (type: 'add' | 'edit', row?: RoleListItem) => {
+    dialogVisible.value = true
+    dialogType.value = type
+    currentRoleData.value = row
+  }
+
+  /**
+   * 搜索处理
+   * @param params 搜索参数
+   */
+  const handleSearch = (params: RoleSearchFormParams) => {
+    // 处理日期区间参数，把 daterange 转换为 startTime 和 endTime
+    const { daterange, ...filtersParams } = params
+    const [startTime, endTime] = Array.isArray(daterange) ? daterange : [null, null]
+
+    replaceSearchParams({ ...filtersParams, startTime, endTime })
+    getData()
+  }
+
+  const buttonMoreClick = (item: ButtonMoreItem, row: RoleListItem) => {
+    switch (item.key) {
+      case 'permission':
+        showPermissionDialog(row)
+        break
+      case 'edit':
+        showDialog('edit', row)
+        break
+      case 'delete':
+        deleteRole(row)
+        break
+    }
+  }
+
+  const showPermissionDialog = (row?: RoleListItem) => {
+    permissionDialog.value = true
+    currentRoleData.value = row
+  }
+
+  const deleteRole = (row: RoleListItem) => {
+    ElMessageBox.confirm(
+      t('systemPage.role.deleteConfirm', { name: row.roleName }),
+      t('systemPage.role.deleteTitle'),
+      {
+        confirmButtonText: t('common.confirm'),
+        cancelButtonText: t('common.cancel'),
+        type: 'warning'
+      }
+    )
+      .then(() => {
+        // TODO: 调用删除接口
+        ElMessage.success(t('systemPage.role.deleteSuccess'))
+        refreshData()
+      })
+      .catch(() => {
+        ElMessage.info(t('systemPage.role.deleteCancel'))
+      })
+  }
+</script>
diff --git a/web/src/views/system/role/modules/role-edit-dialog.vue b/web/src/views/system/role/modules/role-edit-dialog.vue
new file mode 100644
index 0000000..bfc2f85
--- /dev/null
+++ b/web/src/views/system/role/modules/role-edit-dialog.vue
@@ -0,0 +1,184 @@
+<template>
+  <ElDialog
+    v-model="visible"
+    :title="
+      dialogType === 'add'
+        ? t('systemPage.role.dialog.addTitle')
+        : t('systemPage.role.dialog.editTitle')
+    "
+    width="30%"
+    align-center
+    @close="handleClose"
+  >
+    <ElForm ref="formRef" :model="form" :rules="rules" label-width="120px">
+      <ElFormItem :label="t('systemPage.role.search.name')" prop="roleName">
+        <ElInput
+          v-model="form.roleName"
+          :placeholder="t('systemPage.role.search.namePlaceholder')"
+        />
+      </ElFormItem>
+      <ElFormItem :label="t('systemPage.role.search.code')" prop="roleCode">
+        <ElInput
+          v-model="form.roleCode"
+          :placeholder="t('systemPage.role.search.codePlaceholder')"
+        />
+      </ElFormItem>
+      <ElFormItem :label="t('systemPage.role.search.description')" prop="description">
+        <ElInput
+          v-model="form.description"
+          type="textarea"
+          :rows="3"
+          :placeholder="t('systemPage.role.search.descriptionPlaceholder')"
+        />
+      </ElFormItem>
+      <ElFormItem :label="t('systemPage.role.dialog.enabled')">
+        <ElSwitch v-model="form.enabled" />
+      </ElFormItem>
+    </ElForm>
+    <template #footer>
+      <ElButton @click="handleClose">{{ t('common.cancel') }}</ElButton>
+      <ElButton type="primary" @click="handleSubmit">{{ t('common.submit') }}</ElButton>
+    </template>
+  </ElDialog>
+</template>
+
+<script setup lang="ts">
+  import type { FormInstance, FormRules } from 'element-plus'
+  import { useI18n } from 'vue-i18n'
+
+  const { t } = useI18n()
+
+  type RoleListItem = Api.SystemManage.RoleListItem
+
+  interface Props {
+    modelValue: boolean
+    dialogType: 'add' | 'edit'
+    roleData?: RoleListItem
+  }
+
+  interface Emits {
+    (e: 'update:modelValue', value: boolean): void
+    (e: 'success'): void
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    modelValue: false,
+    dialogType: 'add',
+    roleData: undefined
+  })
+
+  const emit = defineEmits<Emits>()
+
+  const formRef = ref<FormInstance>()
+
+  /**
+   * 弹窗显示状态双向绑定
+   */
+  const visible = computed({
+    get: () => props.modelValue,
+    set: (value) => emit('update:modelValue', value)
+  })
+
+  /**
+   * 表单验证规则
+   */
+  const rules = reactive<FormRules>({
+    roleName: [
+      { required: true, message: t('systemPage.role.search.namePlaceholder'), trigger: 'blur' },
+      { min: 2, max: 20, message: t('userCenter.validation.length'), trigger: 'blur' }
+    ],
+    roleCode: [
+      { required: true, message: t('systemPage.role.search.codePlaceholder'), trigger: 'blur' },
+      { min: 2, max: 50, message: t('userCenter.validation.length'), trigger: 'blur' }
+    ],
+    description: [
+      {
+        required: true,
+        message: t('systemPage.role.search.descriptionPlaceholder'),
+        trigger: 'blur'
+      }
+    ]
+  })
+
+  /**
+   * 表单数据
+   */
+  const form = reactive<RoleListItem>({
+    roleId: 0,
+    roleName: '',
+    roleCode: '',
+    description: '',
+    createTime: '',
+    enabled: true
+  })
+
+  /**
+   * 监听弹窗打开，初始化表单数据
+   */
+  watch(
+    () => props.modelValue,
+    (newVal) => {
+      if (newVal) initForm()
+    }
+  )
+
+  /**
+   * 监听角色数据变化，更新表单
+   */
+  watch(
+    () => props.roleData,
+    (newData) => {
+      if (newData && props.modelValue) initForm()
+    },
+    { deep: true }
+  )
+
+  /**
+   * 初始化表单数据
+   * 根据弹窗类型填充表单或重置表单
+   */
+  const initForm = () => {
+    if (props.dialogType === 'edit' && props.roleData) {
+      Object.assign(form, props.roleData)
+    } else {
+      Object.assign(form, {
+        roleId: 0,
+        roleName: '',
+        roleCode: '',
+        description: '',
+        createTime: '',
+        enabled: true
+      })
+    }
+  }
+
+  /**
+   * 关闭弹窗并重置表单
+   */
+  const handleClose = () => {
+    visible.value = false
+    formRef.value?.resetFields()
+  }
+
+  /**
+   * 提交表单
+   * 验证通过后调用接口保存数据
+   */
+  const handleSubmit = async () => {
+    if (!formRef.value) return
+
+    try {
+      await formRef.value.validate()
+      // TODO: 调用新增/编辑接口
+      const message =
+        props.dialogType === 'add'
+          ? t('systemPage.role.dialog.addSuccess')
+          : t('systemPage.role.dialog.editSuccess')
+      ElMessage.success(message)
+      emit('success')
+      handleClose()
+    } catch (error) {
+      console.log('表单验证失败:', error)
+    }
+  }
+</script>
diff --git a/web/src/views/system/role/modules/role-permission-dialog.vue b/web/src/views/system/role/modules/role-permission-dialog.vue
new file mode 100644
index 0000000..7f0ce71
--- /dev/null
+++ b/web/src/views/system/role/modules/role-permission-dialog.vue
@@ -0,0 +1,268 @@
+<template>
+  <ElDialog
+    v-model="visible"
+    :title="t('systemPage.role.permission.title')"
+    width="520px"
+    align-center
+    class="el-dialog-border"
+    @close="handleClose"
+  >
+    <ElScrollbar height="70vh">
+      <ElTree
+        ref="treeRef"
+        :data="processedMenuList"
+        show-checkbox
+        node-key="name"
+        :default-expand-all="isExpandAll"
+        :default-checked-keys="[1, 2, 3]"
+        :props="defaultProps"
+        @check="handleTreeCheck"
+      >
+        <template #default="{ data }">
+          <div style="display: flex; align-items: center">
+            <span v-if="data.isAuth">
+              {{ data.label }}
+            </span>
+            <span v-else>{{ defaultProps.label(data) }}</span>
+          </div>
+        </template>
+      </ElTree>
+    </ElScrollbar>
+    <template #footer>
+      <ElButton @click="outputSelectedData" style="margin-left: 8px">
+        {{ t('systemPage.role.permission.output') }}
+      </ElButton>
+
+      <ElButton @click="toggleExpandAll">{{
+        isExpandAll
+          ? t('systemPage.role.permission.collapse')
+          : t('systemPage.role.permission.expand')
+      }}</ElButton>
+      <ElButton @click="toggleSelectAll" style="margin-left: 8px">{{
+        isSelectAll
+          ? t('systemPage.role.permission.unselectAll')
+          : t('systemPage.role.permission.selectAll')
+      }}</ElButton>
+      <ElButton type="primary" @click="savePermission">
+        {{ t('systemPage.role.permission.save') }}
+      </ElButton>
+    </template>
+  </ElDialog>
+</template>
+
+<script setup lang="ts">
+  import { useMenuStore } from '@/store/modules/menu'
+  import { formatMenuTitle } from '@/utils/router'
+  import { useI18n } from 'vue-i18n'
+
+  type RoleListItem = Api.SystemManage.RoleListItem
+  const { t } = useI18n()
+
+  interface Props {
+    modelValue: boolean
+    roleData?: RoleListItem
+  }
+
+  interface Emits {
+    (e: 'update:modelValue', value: boolean): void
+    (e: 'success'): void
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    modelValue: false,
+    roleData: undefined
+  })
+
+  const emit = defineEmits<Emits>()
+
+  const { menuList } = storeToRefs(useMenuStore())
+  const treeRef = ref()
+  const isExpandAll = ref(true)
+  const isSelectAll = ref(false)
+
+  /**
+   * 弹窗显示状态双向绑定
+   */
+  const visible = computed({
+    get: () => props.modelValue,
+    set: (value) => emit('update:modelValue', value)
+  })
+
+  /**
+   * 菜单节点类型
+   */
+  interface MenuNode {
+    id?: string | number
+    name?: string
+    label?: string
+    meta?: {
+      title?: string
+      authList?: Array<{
+        authMark: string
+        title: string
+        checked?: boolean
+      }>
+    }
+    children?: MenuNode[]
+    [key: string]: any
+  }
+
+  /**
+   * 处理菜单数据，将 authList 转换为树形子节点
+   * 递归处理菜单树，将权限列表展开为可选择的子节点
+   */
+  const processedMenuList = computed(() => {
+    const processNode = (node: MenuNode): MenuNode => {
+      const processed = { ...node }
+
+      // 如果有 authList，将其转换为子节点
+      if (node.meta?.authList?.length) {
+        const authNodes = node.meta.authList.map((auth) => ({
+          id: `${node.id}_${auth.authMark}`,
+          name: `${node.name}_${auth.authMark}`,
+          label: auth.title,
+          authMark: auth.authMark,
+          isAuth: true,
+          checked: auth.checked || false
+        }))
+
+        processed.children = processed.children ? [...processed.children, ...authNodes] : authNodes
+      }
+
+      // 递归处理子节点
+      if (processed.children) {
+        processed.children = processed.children.map(processNode)
+      }
+
+      return processed
+    }
+
+    return (menuList.value as any[]).map(processNode)
+  })
+
+  /**
+   * 树形组件配置
+   */
+  const defaultProps = {
+    children: 'children',
+    label: (data: any) => formatMenuTitle(data.meta?.title) || data.label || ''
+  }
+
+  /**
+   * 监听弹窗打开，初始化权限数据
+   */
+  watch(
+    () => props.modelValue,
+    (newVal) => {
+      if (newVal && props.roleData) {
+        // TODO: 根据角色加载对应的权限数据
+        console.log('设置权限:', props.roleData)
+      }
+    }
+  )
+
+  /**
+   * 关闭弹窗并清空选中状态
+   */
+  const handleClose = () => {
+    visible.value = false
+    treeRef.value?.setCheckedKeys([])
+  }
+
+  /**
+   * 保存权限配置
+   */
+  const savePermission = () => {
+    // TODO: 调用保存权限接口
+    ElMessage.success(t('systemPage.role.permission.saveSuccess'))
+    emit('success')
+    handleClose()
+  }
+
+  /**
+   * 切换全部展开/收起状态
+   */
+  const toggleExpandAll = () => {
+    const tree = treeRef.value
+    if (!tree) return
+
+    const nodes = tree.store.nodesMap
+    // 这里保留 any，因为 Element Plus 的内部节点类型较复杂
+    Object.values(nodes).forEach((node: any) => {
+      node.expanded = !isExpandAll.value
+    })
+
+    isExpandAll.value = !isExpandAll.value
+  }
+
+  /**
+   * 切换全选/取消全选状态
+   */
+  const toggleSelectAll = () => {
+    const tree = treeRef.value
+    if (!tree) return
+
+    if (!isSelectAll.value) {
+      const allKeys = getAllNodeKeys(processedMenuList.value)
+      tree.setCheckedKeys(allKeys)
+    } else {
+      tree.setCheckedKeys([])
+    }
+
+    isSelectAll.value = !isSelectAll.value
+  }
+
+  /**
+   * 递归获取所有节点的 key
+   * @param nodes 节点列表
+   * @returns 所有节点的 key 数组
+   */
+  const getAllNodeKeys = (nodes: MenuNode[]): string[] => {
+    const keys: string[] = []
+    const traverse = (nodeList: MenuNode[]): void => {
+      nodeList.forEach((node) => {
+        if (node.name) keys.push(node.name)
+        if (node.children?.length) traverse(node.children)
+      })
+    }
+    traverse(nodes)
+    return keys
+  }
+
+  /**
+   * 处理树节点选中状态变化
+   * 同步更新全选按钮状态
+   */
+  const handleTreeCheck = () => {
+    const tree = treeRef.value
+    if (!tree) return
+
+    const checkedKeys = tree.getCheckedKeys()
+    const allKeys = getAllNodeKeys(processedMenuList.value)
+
+    isSelectAll.value = checkedKeys.length === allKeys.length && allKeys.length > 0
+  }
+
+  /**
+   * 输出选中的权限数据到控制台
+   * 用于调试和查看当前选中的权限配置
+   */
+  const outputSelectedData = () => {
+    const tree = treeRef.value
+    if (!tree) return
+
+    const selectedData = {
+      checkedKeys: tree.getCheckedKeys(),
+      halfCheckedKeys: tree.getHalfCheckedKeys(),
+      checkedNodes: tree.getCheckedNodes(),
+      halfCheckedNodes: tree.getHalfCheckedNodes(),
+      totalChecked: tree.getCheckedKeys().length,
+      totalHalfChecked: tree.getHalfCheckedKeys().length
+    }
+
+    console.log('=== 选中的权限数据 ===', selectedData)
+    ElMessage.success(
+      t('systemPage.role.permission.outputSuccess', { count: selectedData.totalChecked })
+    )
+  }
+</script>
diff --git a/web/src/views/system/role/modules/role-search.vue b/web/src/views/system/role/modules/role-search.vue
new file mode 100644
index 0000000..f6e97c6
--- /dev/null
+++ b/web/src/views/system/role/modules/role-search.vue
@@ -0,0 +1,135 @@
+<template>
+  <ArtSearchBar
+    ref="searchBarRef"
+    v-model="formData"
+    :items="formItems"
+    :rules="rules"
+    @reset="handleReset"
+    @search="handleSearch"
+  >
+  </ArtSearchBar>
+</template>
+
+<script setup lang="ts">
+  import { useI18n } from 'vue-i18n'
+
+  const { t } = useI18n()
+
+  type RoleSearchFormParams = Api.SystemManage.RoleSearchParams & {
+    daterange?: string[]
+  }
+
+  interface Props {
+    modelValue: RoleSearchFormParams
+  }
+
+  interface Emits {
+    (e: 'update:modelValue', value: RoleSearchFormParams): void
+    (e: 'search', params: RoleSearchFormParams): void
+    (e: 'reset'): void
+  }
+
+  const props = defineProps<Props>()
+  const emit = defineEmits<Emits>()
+
+  const searchBarRef = ref()
+
+  /**
+   * 表单数据双向绑定
+   */
+  const formData = computed({
+    get: () => props.modelValue,
+    set: (val) => emit('update:modelValue', val)
+  })
+
+  /**
+   * 表单校验规则
+   */
+  const rules = {}
+
+  /**
+   * 角色状态选项
+   */
+  const statusOptions = ref([
+    { label: t('common.enabled'), value: true },
+    { label: t('common.disabled'), value: false }
+  ])
+
+  /**
+   * 搜索表单配置项
+   */
+  const formItems = computed(() => [
+    {
+      label: t('systemPage.role.search.name'),
+      key: 'roleName',
+      type: 'input',
+      placeholder: t('systemPage.role.search.namePlaceholder'),
+      clearable: true
+    },
+    {
+      label: t('systemPage.role.search.code'),
+      key: 'roleCode',
+      type: 'input',
+      placeholder: t('systemPage.role.search.codePlaceholder'),
+      clearable: true
+    },
+    {
+      label: t('systemPage.role.search.description'),
+      key: 'description',
+      type: 'input',
+      placeholder: t('systemPage.role.search.descriptionPlaceholder'),
+      clearable: true
+    },
+    {
+      label: t('systemPage.role.search.status'),
+      key: 'enabled',
+      type: 'select',
+      props: {
+        placeholder: t('systemPage.role.search.statusPlaceholder'),
+        options: statusOptions.value,
+        clearable: true
+      }
+    },
+    {
+      label: t('systemPage.role.search.date'),
+      key: 'daterange',
+      type: 'datetime',
+      props: {
+        style: { width: '100%' },
+        placeholder: t('systemPage.role.search.datePlaceholder'),
+        type: 'daterange',
+        rangeSeparator: t('systemPage.role.search.rangeSeparator'),
+        startPlaceholder: t('systemPage.role.search.startDate'),
+        endPlaceholder: t('systemPage.role.search.endDate'),
+        valueFormat: 'YYYY-MM-DD',
+        shortcuts: [
+          { text: t('systemPage.role.search.today'), value: [new Date(), new Date()] },
+          {
+            text: t('systemPage.role.search.week'),
+            value: [new Date(Date.now() - 604800000), new Date()]
+          },
+          {
+            text: t('systemPage.role.search.month'),
+            value: [new Date(Date.now() - 2592000000), new Date()]
+          }
+        ]
+      }
+    }
+  ])
+
+  /**
+   * 处理重置事件
+   */
+  const handleReset = () => {
+    emit('reset')
+  }
+
+  /**
+   * 处理搜索事件
+   * 验证表单后触发搜索
+   */
+  const handleSearch = async (params: RoleSearchFormParams) => {
+    await searchBarRef.value.validate()
+    emit('search', params)
+  }
+</script>
diff --git a/web/src/views/system/user-center/index.vue b/web/src/views/system/user-center/index.vue
new file mode 100755
index 0000000..a4f7422
--- /dev/null
+++ b/web/src/views/system/user-center/index.vue
@@ -0,0 +1,257 @@
+<!-- 个人中心页面 -->
+<template>
+  <div class="w-full h-full p-0 bg-transparent border-none shadow-none">
+    <div class="relative flex-b mt-2.5 max-md:block max-md:mt-1">
+      <div class="w-112 mr-5 max-md:w-full max-md:mr-0">
+        <div class="art-card-sm relative p-9 pb-6 overflow-hidden text-center">
+          <img class="absolute top-0 left-0 w-full h-50 object-cover" src="@imgs/user/bg.webp" />
+          <img
+            class="relative z-10 w-20 h-20 mt-30 mx-auto object-cover border-2 border-white rounded-full"
+            src="@imgs/user/avatar.webp"
+          />
+          <h2 class="mt-5 text-xl font-normal">{{ userInfo.userName }}</h2>
+          <p class="mt-5 text-sm">{{ t('userCenter.tagline') }}</p>
+
+          <div class="w-75 mx-auto mt-7.5 text-left">
+            <div class="mt-2.5">
+              <ArtSvgIcon icon="ri:mail-line" class="text-g-700" />
+              <span class="ml-2 text-sm">{{ userInfo.email || form.email }}</span>
+            </div>
+            <div class="mt-2.5">
+              <ArtSvgIcon icon="ri:user-3-line" class="text-g-700" />
+              <span class="ml-2 text-sm">{{ t('userCenter.role') }}</span>
+            </div>
+            <div class="mt-2.5">
+              <ArtSvgIcon icon="ri:map-pin-line" class="text-g-700" />
+              <span class="ml-2 text-sm">{{ t('userCenter.location') }}</span>
+            </div>
+            <div class="mt-2.5">
+              <ArtSvgIcon icon="ri:dribbble-fill" class="text-g-700" />
+              <span class="ml-2 text-sm">{{ t('userCenter.team') }}</span>
+            </div>
+          </div>
+
+          <div class="mt-10">
+            <h3 class="text-sm font-medium">{{ t('userCenter.tags') }}</h3>
+            <div class="flex flex-wrap justify-center mt-3.5">
+              <div
+                v-for="item in lableList"
+                :key="item"
+                class="py-1 px-1.5 mr-2.5 mb-2.5 text-xs border border-g-300 rounded"
+              >
+                {{ item }}
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="flex-1 overflow-hidden max-md:w-full max-md:mt-3.5">
+        <div class="art-card-sm">
+          <h1 class="p-4 text-xl font-normal border-b border-g-300">{{
+            t('userCenter.basicSettings')
+          }}</h1>
+
+          <ElForm
+            :model="form"
+            class="box-border p-5 [&>.el-row_.el-form-item]:w-[calc(50%-10px)] [&>.el-row_.el-input]:w-full [&>.el-row_.el-select]:w-full"
+            ref="ruleFormRef"
+            :rules="rules"
+            label-width="86px"
+            label-position="top"
+          >
+            <ElRow>
+              <ElFormItem :label="t('userCenter.realName')" prop="realName">
+                <ElInput v-model="form.realName" :disabled="!isEdit" />
+              </ElFormItem>
+              <ElFormItem :label="t('userCenter.gender')" prop="sex" class="ml-5">
+                <ElSelect
+                  v-model="form.sex"
+                  :placeholder="t('userCenter.gender')"
+                  :disabled="!isEdit"
+                >
+                  <ElOption
+                    v-for="item in options"
+                    :key="item.value"
+                    :label="item.label"
+                    :value="item.value"
+                  />
+                </ElSelect>
+              </ElFormItem>
+            </ElRow>
+
+            <ElRow>
+              <ElFormItem :label="t('userCenter.nickname')" prop="nikeName">
+                <ElInput v-model="form.nikeName" :disabled="!isEdit" />
+              </ElFormItem>
+              <ElFormItem :label="t('userCenter.email')" prop="email" class="ml-5">
+                <ElInput v-model="form.email" :disabled="!isEdit" />
+              </ElFormItem>
+            </ElRow>
+
+            <ElRow>
+              <ElFormItem :label="t('userCenter.mobile')" prop="mobile">
+                <ElInput v-model="form.mobile" :disabled="!isEdit" />
+              </ElFormItem>
+              <ElFormItem :label="t('userCenter.address')" prop="address" class="ml-5">
+                <ElInput v-model="form.address" :disabled="!isEdit" />
+              </ElFormItem>
+            </ElRow>
+
+            <ElFormItem :label="t('userCenter.bio')" prop="des" class="h-32">
+              <ElInput type="textarea" :rows="4" v-model="form.des" :disabled="!isEdit" />
+            </ElFormItem>
+
+            <div class="flex-c justify-end [&_.el-button]:!w-27.5">
+              <ElButton type="primary" class="w-22.5" v-ripple @click="edit">
+                {{ isEdit ? t('userCenter.save') : t('userCenter.edit') }}
+              </ElButton>
+            </div>
+          </ElForm>
+        </div>
+
+        <div class="art-card-sm my-5">
+          <h1 class="p-4 text-xl font-normal border-b border-g-300">{{
+            t('userCenter.changePassword')
+          }}</h1>
+
+          <ElForm :model="pwdForm" class="box-border p-5" label-width="86px" label-position="top">
+            <ElFormItem :label="t('userCenter.currentPassword')" prop="password">
+              <ElInput
+                v-model="pwdForm.password"
+                type="password"
+                :disabled="!isEditPwd"
+                show-password
+              />
+            </ElFormItem>
+
+            <ElFormItem :label="t('userCenter.newPassword')" prop="newPassword">
+              <ElInput
+                v-model="pwdForm.newPassword"
+                type="password"
+                :disabled="!isEditPwd"
+                show-password
+              />
+            </ElFormItem>
+
+            <ElFormItem :label="t('userCenter.confirmPassword')" prop="confirmPassword">
+              <ElInput
+                v-model="pwdForm.confirmPassword"
+                type="password"
+                :disabled="!isEditPwd"
+                show-password
+              />
+            </ElFormItem>
+
+            <div class="flex-c justify-end [&_.el-button]:!w-27.5">
+              <ElButton type="primary" class="w-22.5" v-ripple @click="editPwd">
+                {{ isEditPwd ? t('userCenter.save') : t('userCenter.edit') }}
+              </ElButton>
+            </div>
+          </ElForm>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { useUserStore } from '@/store/modules/user'
+  import type { FormInstance, FormRules } from 'element-plus'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'UserCenter' })
+
+  const { t, tm } = useI18n()
+  const userStore = useUserStore()
+  const userInfo = computed(() => userStore.getUserInfo)
+
+  const isEdit = ref(false)
+  const isEditPwd = ref(false)
+  const date = ref('')
+  const ruleFormRef = ref<FormInstance>()
+
+  /**
+   * 用户信息表单
+   */
+  const form = reactive({
+    realName: 'Commory Admin',
+    nikeName: 'Commory',
+    email: 'admin@commory.local',
+    mobile: '18888888888',
+    address: 'Local workspace',
+    sex: '2',
+    des: 'Commory keeps communication archives searchable, portable, and local-first.'
+  })
+
+  /**
+   * 密码修改表单
+   */
+  const pwdForm = reactive({
+    password: '123456',
+    newPassword: '123456',
+    confirmPassword: '123456'
+  })
+
+  /**
+   * 表单验证规则
+   */
+  const rules = reactive<FormRules>({
+    realName: [
+      { required: true, message: t('userCenter.validation.realName'), trigger: 'blur' },
+      { min: 2, max: 50, message: t('userCenter.validation.length'), trigger: 'blur' }
+    ],
+    nikeName: [
+      { required: true, message: t('userCenter.validation.nickname'), trigger: 'blur' },
+      { min: 2, max: 50, message: t('userCenter.validation.length'), trigger: 'blur' }
+    ],
+    email: [{ required: true, message: t('userCenter.validation.email'), trigger: 'blur' }],
+    mobile: [{ required: true, message: t('userCenter.validation.mobile'), trigger: 'blur' }],
+    address: [{ required: true, message: t('userCenter.validation.address'), trigger: 'blur' }],
+    sex: [{ required: true, message: t('userCenter.validation.gender'), trigger: 'blur' }]
+  })
+
+  /**
+   * 性别选项
+   */
+  const options = [
+    { value: '1', label: t('userCenter.male') },
+    { value: '2', label: t('userCenter.female') }
+  ]
+
+  /**
+   * 用户标签列表
+   */
+  const lableList = computed(() => tm('userCenter.tagList') as string[])
+
+  onMounted(() => {
+    getDate()
+  })
+
+  /**
+   * 根据当前时间获取问候语
+   */
+  const getDate = () => {
+    const h = new Date().getHours()
+
+    if (h >= 6 && h < 9) date.value = t('userCenter.greetings.morning')
+    else if (h >= 9 && h < 11) date.value = t('userCenter.greetings.lateMorning')
+    else if (h >= 11 && h < 13) date.value = t('userCenter.greetings.noon')
+    else if (h >= 13 && h < 18) date.value = t('userCenter.greetings.afternoon')
+    else if (h >= 18 && h < 24) date.value = t('userCenter.greetings.evening')
+    else date.value = t('userCenter.greetings.early')
+  }
+
+  /**
+   * 切换用户信息编辑状态
+   */
+  const edit = () => {
+    isEdit.value = !isEdit.value
+  }
+
+  /**
+   * 切换密码编辑状态
+   */
+  const editPwd = () => {
+    isEditPwd.value = !isEditPwd.value
+  }
+</script>
diff --git a/web/src/views/system/user/index.vue b/web/src/views/system/user/index.vue
new file mode 100644
index 0000000..6c38626
--- /dev/null
+++ b/web/src/views/system/user/index.vue
@@ -0,0 +1,263 @@
+<!-- 用户管理页面 -->
+<!-- art-full-height 自动计算出页面剩余高度 -->
+<!-- art-table-card 一个符合系统样式的 class，同时自动撑满剩余高度 -->
+<!-- 更多 useTable 使用示例请移步至 功能示例 下面的高级表格示例或者查看官方文档 -->
+<!-- useTable 文档：https://www.artd.pro/docs/zh/guide/hooks/use-table.html -->
+<template>
+  <div class="user-page art-full-height">
+    <!-- 搜索栏 -->
+    <UserSearch v-model="searchForm" @search="handleSearch" @reset="resetSearchParams"></UserSearch>
+
+    <ElCard class="art-table-card">
+      <!-- 表格头部 -->
+      <ArtTableHeader v-model:columns="columnChecks" :loading="loading" @refresh="refreshData">
+        <template #left>
+          <ElSpace wrap>
+            <ElButton @click="showDialog('add')" v-ripple>{{ t('systemPage.user.add') }}</ElButton>
+          </ElSpace>
+        </template>
+      </ArtTableHeader>
+
+      <!-- 表格 -->
+      <ArtTable
+        :loading="loading"
+        :data="data"
+        :columns="columns"
+        :pagination="pagination"
+        @selection-change="handleSelectionChange"
+        @pagination:size-change="handleSizeChange"
+        @pagination:current-change="handleCurrentChange"
+      >
+      </ArtTable>
+
+      <!-- 用户弹窗 -->
+      <UserDialog
+        v-model:visible="dialogVisible"
+        :type="dialogType"
+        :user-data="currentUserData"
+        @submit="handleDialogSubmit"
+      />
+    </ElCard>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import ArtButtonTable from '@/components/core/forms/art-button-table/index.vue'
+  import { ACCOUNT_TABLE_DATA } from '@/mock/temp/formData'
+  import { useTable } from '@/hooks/core/useTable'
+  import { fetchGetUserList } from '@/api/system-manage'
+  import UserSearch from './modules/user-search.vue'
+  import UserDialog from './modules/user-dialog.vue'
+  import { ElTag, ElMessageBox, ElImage } from 'element-plus'
+  import { DialogType } from '@/types'
+  import { useI18n } from 'vue-i18n'
+
+  defineOptions({ name: 'User' })
+
+  const { t } = useI18n()
+  type UserListItem = Api.SystemManage.UserListItem
+
+  // 弹窗相关
+  const dialogType = ref<DialogType>('add')
+  const dialogVisible = ref(false)
+  const currentUserData = ref<Partial<UserListItem>>({})
+
+  // 选中行
+  const selectedRows = ref<UserListItem[]>([])
+
+  // 搜索表单
+  const searchForm = ref({
+    userName: undefined,
+    userGender: undefined,
+    userPhone: undefined,
+    userEmail: undefined,
+    status: '1'
+  })
+
+  // 用户状态配置
+  const USER_STATUS_CONFIG = {
+    '1': { type: 'success' as const, key: 'online' },
+    '2': { type: 'info' as const, key: 'offline' },
+    '3': { type: 'warning' as const, key: 'abnormal' },
+    '4': { type: 'danger' as const, key: 'cancelled' }
+  } as const
+
+  /**
+   * 获取用户状态配置
+   */
+  const getUserStatusConfig = (status: string) => {
+    return (
+      USER_STATUS_CONFIG[status as keyof typeof USER_STATUS_CONFIG] || {
+        type: 'info' as const,
+        key: 'unknown'
+      }
+    )
+  }
+
+  const {
+    columns,
+    columnChecks,
+    data,
+    loading,
+    pagination,
+    getData,
+    replaceSearchParams,
+    resetSearchParams,
+    handleSizeChange,
+    handleCurrentChange,
+    refreshData
+  } = useTable({
+    // 核心配置
+    core: {
+      apiFn: fetchGetUserList,
+      apiParams: {
+        current: 1,
+        size: 20,
+        ...searchForm.value
+      },
+      // 自定义分页字段映射，未设置时将使用全局配置 tableConfig.ts 中的 paginationKey
+      // paginationKey: {
+      //   current: 'pageNum',
+      //   size: 'pageSize'
+      // },
+      columnsFactory: () => [
+        { type: 'selection' }, // 勾选列
+        { type: 'index', width: 60, label: t('systemPage.user.columns.index') },
+        {
+          prop: 'userInfo',
+          label: t('systemPage.user.columns.userName'),
+          width: 280,
+          // visible: false, // 默认是否显示列
+          formatter: (row) => {
+            return h('div', { class: 'user flex-c' }, [
+              h(ElImage, {
+                class: 'size-9.5 rounded-md',
+                src: row.avatar,
+                previewSrcList: [row.avatar],
+                // 图片预览是否插入至 body 元素上，用于解决表格内部图片预览样式异常
+                previewTeleported: true
+              }),
+              h('div', { class: 'ml-2' }, [
+                h('p', { class: 'user-name' }, row.userName),
+                h('p', { class: 'email' }, row.userEmail)
+              ])
+            ])
+          }
+        },
+        {
+          prop: 'userGender',
+          label: t('systemPage.user.columns.gender'),
+          sortable: true,
+          formatter: (row) => row.userGender
+        },
+        { prop: 'userPhone', label: t('systemPage.user.columns.phone') },
+        {
+          prop: 'status',
+          label: t('systemPage.user.columns.status'),
+          formatter: (row) => {
+            const statusConfig = getUserStatusConfig(row.status)
+            return h(ElTag, { type: statusConfig.type }, () =>
+              t(`systemPage.user.status.${statusConfig.key}`)
+            )
+          }
+        },
+        {
+          prop: 'createTime',
+          label: t('systemPage.user.columns.createTime'),
+          sortable: true
+        },
+        {
+          prop: 'operation',
+          label: t('systemPage.user.columns.operation'),
+          width: 120,
+          fixed: 'right', // 固定列
+          formatter: (row) =>
+            h('div', [
+              h(ArtButtonTable, {
+                type: 'edit',
+                onClick: () => showDialog('edit', row)
+              }),
+              h(ArtButtonTable, {
+                type: 'delete',
+                onClick: () => deleteUser(row)
+              })
+            ])
+        }
+      ]
+    },
+    // 数据处理
+    transform: {
+      // 数据转换器 - 替换头像
+      dataTransformer: (records) => {
+        // 类型守卫检查
+        if (!Array.isArray(records)) {
+          console.warn('数据转换器: 期望数组类型，实际收到:', typeof records)
+          return []
+        }
+
+        // 使用本地头像替换接口返回的头像
+        return records.map((item, index: number) => {
+          return {
+            ...item,
+            avatar: ACCOUNT_TABLE_DATA[index % ACCOUNT_TABLE_DATA.length].avatar
+          }
+        })
+      }
+    }
+  })
+
+  /**
+   * 搜索处理
+   * @param params 参数
+   */
+  const handleSearch = (params: Api.SystemManage.UserSearchParams) => {
+    replaceSearchParams(params)
+    getData()
+  }
+
+  /**
+   * 显示用户弹窗
+   */
+  const showDialog = (type: DialogType, row?: UserListItem): void => {
+    console.log('打开弹窗:', { type, row })
+    dialogType.value = type
+    currentUserData.value = row || {}
+    nextTick(() => {
+      dialogVisible.value = true
+    })
+  }
+
+  /**
+   * 删除用户
+   */
+  const deleteUser = (row: UserListItem): void => {
+    console.log('删除用户:', row)
+    ElMessageBox.confirm(t('systemPage.user.logoutConfirm'), t('systemPage.user.logoutTitle'), {
+      confirmButtonText: t('common.confirm'),
+      cancelButtonText: t('common.cancel'),
+      type: 'error'
+    }).then(() => {
+      ElMessage.success(t('systemPage.user.logoutSuccess'))
+    })
+  }
+
+  /**
+   * 处理弹窗提交事件
+   */
+  const handleDialogSubmit = async () => {
+    try {
+      dialogVisible.value = false
+      currentUserData.value = {}
+    } catch (error) {
+      console.error('提交失败:', error)
+    }
+  }
+
+  /**
+   * 处理表格行选择变化
+   */
+  const handleSelectionChange = (selection: UserListItem[]): void => {
+    selectedRows.value = selection
+    console.log('选中行数据:', selectedRows.value)
+  }
+</script>
diff --git a/web/src/views/system/user/modules/user-dialog.vue b/web/src/views/system/user/modules/user-dialog.vue
new file mode 100644
index 0000000..30b5659
--- /dev/null
+++ b/web/src/views/system/user/modules/user-dialog.vue
@@ -0,0 +1,164 @@
+<template>
+  <ElDialog
+    v-model="dialogVisible"
+    :title="
+      dialogType === 'add'
+        ? t('systemPage.user.dialog.addTitle')
+        : t('systemPage.user.dialog.editTitle')
+    "
+    width="30%"
+    align-center
+  >
+    <ElForm ref="formRef" :model="formData" :rules="rules" label-width="80px">
+      <ElFormItem :label="t('systemPage.user.search.userName')" prop="username">
+        <ElInput
+          v-model="formData.username"
+          :placeholder="t('systemPage.user.search.userNamePlaceholder')"
+        />
+      </ElFormItem>
+      <ElFormItem :label="t('systemPage.user.search.phone')" prop="phone">
+        <ElInput
+          v-model="formData.phone"
+          :placeholder="t('systemPage.user.search.phonePlaceholder')"
+        />
+      </ElFormItem>
+      <ElFormItem :label="t('systemPage.user.search.gender')" prop="gender">
+        <ElSelect v-model="formData.gender">
+          <ElOption :label="t('userCenter.male')" value="男" />
+          <ElOption :label="t('userCenter.female')" value="女" />
+        </ElSelect>
+      </ElFormItem>
+      <ElFormItem :label="t('systemPage.user.dialog.role')" prop="role">
+        <ElSelect v-model="formData.role" multiple>
+          <ElOption
+            v-for="role in roleList"
+            :key="role.roleCode"
+            :value="role.roleCode"
+            :label="role.roleName"
+          />
+        </ElSelect>
+      </ElFormItem>
+    </ElForm>
+    <template #footer>
+      <div class="dialog-footer">
+        <ElButton @click="dialogVisible = false">{{ t('common.cancel') }}</ElButton>
+        <ElButton type="primary" @click="handleSubmit">{{ t('common.submit') }}</ElButton>
+      </div>
+    </template>
+  </ElDialog>
+</template>
+
+<script setup lang="ts">
+  import { ROLE_LIST_DATA } from '@/mock/temp/formData'
+  import type { FormInstance, FormRules } from 'element-plus'
+  import { useI18n } from 'vue-i18n'
+
+  const { t } = useI18n()
+
+  interface Props {
+    visible: boolean
+    type: string
+    userData?: Partial<Api.SystemManage.UserListItem>
+  }
+
+  interface Emits {
+    (e: 'update:visible', value: boolean): void
+    (e: 'submit'): void
+  }
+
+  const props = defineProps<Props>()
+  const emit = defineEmits<Emits>()
+
+  // 角色列表数据
+  const roleList = ref(ROLE_LIST_DATA)
+
+  // 对话框显示控制
+  const dialogVisible = computed({
+    get: () => props.visible,
+    set: (value) => emit('update:visible', value)
+  })
+
+  const dialogType = computed(() => props.type)
+
+  // 表单实例
+  const formRef = ref<FormInstance>()
+
+  // 表单数据
+  const formData = reactive({
+    username: '',
+    phone: '',
+    gender: '男',
+    role: [] as string[]
+  })
+
+  // 表单验证规则
+  const rules: FormRules = {
+    username: [
+      { required: true, message: t('systemPage.user.search.userNamePlaceholder'), trigger: 'blur' },
+      { min: 2, max: 20, message: t('userCenter.validation.length'), trigger: 'blur' }
+    ],
+    phone: [
+      { required: true, message: t('systemPage.user.search.phonePlaceholder'), trigger: 'blur' },
+      {
+        pattern: /^1[3-9]\d{9}$/,
+        message: t('systemPage.user.dialog.phoneInvalid'),
+        trigger: 'blur'
+      }
+    ],
+    gender: [{ required: true, message: t('userCenter.validation.gender'), trigger: 'blur' }],
+    role: [{ required: true, message: t('systemPage.user.dialog.role'), trigger: 'blur' }]
+  }
+
+  /**
+   * 初始化表单数据
+   * 根据对话框类型（新增/编辑）填充表单
+   */
+  const initFormData = () => {
+    const isEdit = props.type === 'edit' && props.userData
+    const row = props.userData
+
+    Object.assign(formData, {
+      username: isEdit && row ? row.userName || '' : '',
+      phone: isEdit && row ? row.userPhone || '' : '',
+      gender: isEdit && row ? row.userGender || '男' : '男',
+      role: isEdit && row ? (Array.isArray(row.userRoles) ? row.userRoles : []) : []
+    })
+  }
+
+  /**
+   * 监听对话框状态变化
+   * 当对话框打开时初始化表单数据并清除验证状态
+   */
+  watch(
+    () => [props.visible, props.type, props.userData],
+    ([visible]) => {
+      if (visible) {
+        initFormData()
+        nextTick(() => {
+          formRef.value?.clearValidate()
+        })
+      }
+    },
+    { immediate: true }
+  )
+
+  /**
+   * 提交表单
+   * 验证通过后触发提交事件
+   */
+  const handleSubmit = async () => {
+    if (!formRef.value) return
+
+    await formRef.value.validate((valid) => {
+      if (valid) {
+        ElMessage.success(
+          dialogType.value === 'add'
+            ? t('systemPage.user.dialog.addSuccess')
+            : t('systemPage.user.dialog.updateSuccess')
+        )
+        dialogVisible.value = false
+        emit('submit')
+      }
+    })
+  }
+</script>
diff --git a/web/src/views/system/user/modules/user-search.vue b/web/src/views/system/user/modules/user-search.vue
new file mode 100644
index 0000000..62caf84
--- /dev/null
+++ b/web/src/views/system/user/modules/user-search.vue
@@ -0,0 +1,114 @@
+<template>
+  <ArtSearchBar
+    ref="searchBarRef"
+    v-model="formData"
+    :items="formItems"
+    :rules="rules"
+    @reset="handleReset"
+    @search="handleSearch"
+  >
+  </ArtSearchBar>
+</template>
+
+<script setup lang="ts">
+  import { useI18n } from 'vue-i18n'
+
+  const { t } = useI18n()
+
+  interface Props {
+    modelValue: Api.SystemManage.UserSearchParams
+  }
+  interface Emits {
+    (e: 'update:modelValue', value: Api.SystemManage.UserSearchParams): void
+    (e: 'search', params: Api.SystemManage.UserSearchParams): void
+    (e: 'reset'): void
+  }
+  const props = defineProps<Props>()
+  const emit = defineEmits<Emits>()
+
+  // 表单数据双向绑定
+  const searchBarRef = ref()
+  const formData = computed({
+    get: () => props.modelValue,
+    set: (val) => emit('update:modelValue', val)
+  })
+
+  // 校验规则
+  const rules = {
+    // userName: [{ required: true, message: '请输入用户名', trigger: 'blur' }]
+  }
+
+  // 动态 options
+  const statusOptions = ref<{ label: string; value: string; disabled?: boolean }[]>([])
+
+  // 模拟接口返回状态数据
+  function fetchStatusOptions(): Promise<typeof statusOptions.value> {
+    return new Promise((resolve) => {
+      setTimeout(() => {
+        resolve([
+          { label: t('systemPage.user.status.online'), value: '1' },
+          { label: t('systemPage.user.status.offline'), value: '2' },
+          { label: t('systemPage.user.status.abnormal'), value: '3' },
+          { label: t('systemPage.user.status.cancelled'), value: '4' }
+        ])
+      }, 1000)
+    })
+  }
+
+  onMounted(async () => {
+    statusOptions.value = await fetchStatusOptions()
+  })
+
+  // 表单配置
+  const formItems = computed(() => [
+    {
+      label: t('systemPage.user.search.userName'),
+      key: 'userName',
+      type: 'input',
+      placeholder: t('systemPage.user.search.userNamePlaceholder'),
+      clearable: true
+    },
+    {
+      label: t('systemPage.user.search.phone'),
+      key: 'userPhone',
+      type: 'input',
+      props: { placeholder: t('systemPage.user.search.phonePlaceholder'), maxlength: '11' }
+    },
+    {
+      label: t('systemPage.user.search.email'),
+      key: 'userEmail',
+      type: 'input',
+      props: { placeholder: t('systemPage.user.search.emailPlaceholder') }
+    },
+    {
+      label: t('systemPage.user.search.status'),
+      key: 'status',
+      type: 'select',
+      props: {
+        placeholder: t('systemPage.user.search.statusPlaceholder'),
+        options: statusOptions.value
+      }
+    },
+    {
+      label: t('systemPage.user.search.gender'),
+      key: 'userGender',
+      type: 'radiogroup',
+      props: {
+        options: [
+          { label: t('userCenter.male'), value: '1' },
+          { label: t('userCenter.female'), value: '2' }
+        ]
+      }
+    }
+  ])
+
+  // 事件
+  function handleReset() {
+    emit('reset')
+  }
+
+  async function handleSearch(params: Api.SystemManage.UserSearchParams) {
+    await searchBarRef.value.validate()
+    emit('search', params)
+  }
+</script>
diff --git a/web/tsconfig.json b/web/tsconfig.json
new file mode 100755
index 0000000..4331962
--- /dev/null
+++ b/web/tsconfig.json
@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "esnext",
+    "moduleResolution": "node",
+    "strict": true,
+    "jsx": "preserve",
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "lib": ["esnext", "dom"],
+    "types": ["vite/client", "node", "element-plus/global"],
+    "skipLibCheck": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"],
+      "@views/*": ["src/views/*"],
+      "@imgs/*": ["src/assets/images/*"],
+      "@icons/*": ["src/assets/icons/*"],
+      "@utils/*": ["src/utils/*"],
+      "@stores/*": ["src/store/*"],
+      "@plugins/*": ["src/plugins/*"],
+      "@styles/*": ["src/assets/styles/*"]
+    }
+  },
+  "include": ["src/**/*", "src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"],
+  "exclude": ["node_modules", "dist", "**/*.js"]
+}
diff --git a/web/vite.config.ts b/web/vite.config.ts
new file mode 100755
index 0000000..fd87c58
--- /dev/null
+++ b/web/vite.config.ts
@@ -0,0 +1,154 @@
+import { defineConfig, loadEnv } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import viteCompression from 'vite-plugin-compression'
+import Components from 'unplugin-vue-components/vite'
+import AutoImport from 'unplugin-auto-import/vite'
+import ElementPlus from 'unplugin-element-plus/vite'
+import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
+import tailwindcss from '@tailwindcss/vite'
+// import { visualizer } from 'rollup-plugin-visualizer'
+
+export default ({ mode }: { mode: string }) => {
+  const root = process.cwd()
+  const env = loadEnv(mode, root)
+  const { VITE_VERSION, VITE_PORT, VITE_BASE_URL, VITE_API_URL, VITE_API_PROXY_URL } = env
+
+  console.log(`🚀 API_URL = ${VITE_API_URL}`)
+  console.log(`🚀 VERSION = ${VITE_VERSION}`)
+
+  return defineConfig({
+    define: {
+      __APP_VERSION__: JSON.stringify(VITE_VERSION)
+    },
+    base: VITE_BASE_URL,
+    server: {
+      port: Number(VITE_PORT),
+      proxy: {
+        '/api': {
+          target: VITE_API_PROXY_URL,
+          changeOrigin: true
+        }
+      },
+      host: true
+    },
+    // 路径别名
+    resolve: {
+      alias: {
+        '@': fileURLToPath(new URL('./src', import.meta.url)),
+        '@views': resolvePath('src/views'),
+        '@imgs': resolvePath('src/assets/images'),
+        '@icons': resolvePath('src/assets/icons'),
+        '@utils': resolvePath('src/utils'),
+        '@stores': resolvePath('src/store'),
+        '@styles': resolvePath('src/assets/styles')
+      }
+    },
+    build: {
+      target: 'es2015',
+      outDir: 'dist',
+      chunkSizeWarningLimit: 2000,
+      minify: 'terser',
+      terserOptions: {
+        compress: {
+          // 生产环境去除 console
+          drop_console: true,
+          // 生产环境去除 debugger
+          drop_debugger: true
+        }
+      },
+      dynamicImportVarsOptions: {
+        warnOnError: true,
+        exclude: [],
+        include: ['src/views/**/*.vue']
+      }
+    },
+    plugins: [
+      vue(),
+      tailwindcss(),
+      // 自动按需导入 API
+      AutoImport({
+        imports: ['vue', 'vue-router', 'pinia', '@vueuse/core'],
+        dts: 'src/types/import/auto-imports.d.ts',
+        resolvers: [ElementPlusResolver()],
+        eslintrc: {
+          enabled: true,
+          filepath: './.auto-import.json',
+          globalsPropValue: true
+        }
+      }),
+      // 自动按需导入组件
+      Components({
+        dts: 'src/types/import/components.d.ts',
+        resolvers: [ElementPlusResolver()]
+      }),
+      // 按需定制主题配置
+      ElementPlus({
+        useSource: true
+      }),
+      // 压缩
+      viteCompression({
+        verbose: false, // 是否在控制台输出压缩结果
+        disable: false, // 是否禁用
+        algorithm: 'gzip', // 压缩算法
+        ext: '.gz', // 压缩后的文件名后缀
+        threshold: 10240, // 只有大小大于该值的资源会被处理 10240B = 10KB
+        deleteOriginFile: false // 压缩后是否删除原文件
+      })
+      // 打包分析
+      // visualizer({
+      //   open: true,
+      //   gzipSize: true,
+      //   brotliSize: true,
+      //   filename: 'dist/stats.html' // 分析图生成的文件名及路径
+      // }),
+    ],
+    // 依赖预构建：避免运行时重复请求与转换，提升首次加载速度
+    optimizeDeps: {
+      include: [
+        'echarts/core',
+        'echarts/charts',
+        'echarts/components',
+        'echarts/renderers',
+        'xlsx',
+        'xgplayer',
+        'crypto-js',
+        'file-saver',
+        'vue-img-cutter',
+        'element-plus/es',
+        'element-plus/es/components/*/style/css',
+        'element-plus/es/components/*/style/index'
+      ]
+    },
+    css: {
+      preprocessorOptions: {
+        // sass variable and mixin
+        scss: {
+          additionalData: `
+            @use "@styles/core/el-light.scss" as *; 
+            @use "@styles/core/mixin.scss" as *;
+          `
+        }
+      },
+      postcss: {
+        plugins: [
+          {
+            postcssPlugin: 'internal:charset-removal',
+            AtRule: {
+              charset: (atRule) => {
+                if (atRule.name === 'charset') {
+                  atRule.remove()
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  })
+}
+
+function resolvePath(paths: string) {
+  return path.resolve(__dirname, paths)
+}