Update architecture docs (#1709)

Author: j-paterson

.github/workflows/deploy-docs.yml

@@ -0,0 +1,56 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches: [main, canary]
+    paths:
+      - 'docs-site/**'
+      - 'docs/**'
+  workflow_dispatch: # Allow manual trigger
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: yarn
+          cache-dependency-path: docs-site/yarn.lock
+      
+      - name: Install dependencies
+        working-directory: docs-site
+        run: yarn install --frozen-lockfile
+      
+      - name: Build docs
+        working-directory: docs-site
+        run: yarn build
+      
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs-site/build
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

README.md

@@ -6,7 +6,28 @@
 Forked from [herocast](https://github.com/hellno/herocast/) in April 2024.
 
 # Docs
-Documentation is available in the [docs/](docs/) directory. For online documentation, set `NEXT_PUBLIC_DOCS_URL` environment variable.
+
+Full documentation is available in the [`docs/`](docs/) directory:
+
+- **[Getting Started](docs/GETTING_STARTED.md)** - Quick start guide
+- **[Project Structure](docs/PROJECT_STRUCTURE.md)** - Codebase organization
+- **[Contributing](docs/CONTRIBUTING.MD)** - How to contribute
+
+### Architecture
+- [Overview](docs/ARCHITECTURE/OVERVIEW.md) - System architecture overview
+- [Authentication](docs/ARCHITECTURE/AUTHENTICATION.md) - Auth system design
+- [State Management](docs/ARCHITECTURE/STATE_MANAGEMENT.md) - Zustand stores
+
+### Systems
+- [Configuration](docs/SYSTEMS/CONFIGURATION/ARCHITECTURE_OVERVIEW.md) - Multi-tenant config system
+- [Spaces](docs/SYSTEMS/SPACES/OVERVIEW.md) - Space architecture (profile, token, channel, navPage)
+- [Fidgets](docs/SYSTEMS/FIDGETS/OVERVIEW.md) - Fidget system and registry
+- [Navigation](docs/SYSTEMS/NAVIGATION/OVERVIEW.md) - Navigation system
+- [Themes](docs/SYSTEMS/THEMES/OVERVIEW.md) - Theming system
+
+### Integrations
+- [Supabase](docs/INTEGRATIONS/SUPABASE.md) - Database schema and storage
+- [Farcaster](docs/INTEGRATIONS/FARCASTER.md) - Farcaster integration
 
 ## What is Farcaster?
 a protocol for decentralized social apps: https://www.farcaster.xyz

docs-site/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

docs-site/.yarn/install-state.gz

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```bash
+yarn
+```
+
+## Local Development
+
+```bash
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```bash
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

docs-site/README.md

@@ -0,0 +1,36 @@
+# Blankspace Documentation
+
+Blankspace is a highly customizable Farcaster client funded by Nouns DAO. Build personalized spaces with themes, tabs, and fidgets.
+
+## Quick Start
+
+- [Getting Started](./getting-started.md) - Local development setup
+- [Project Structure](./project-structure.md) - Codebase organization
+- [Contributing](./contributing.md) - How to contribute
+
+## Architecture
+
+- [Overview](./architecture/overview.md) - System architecture
+- [Authentication](./architecture/authentication.md) - Privy + Farcaster auth
+- [State Management](./architecture/state-management.md) - Zustand stores
+
+## Systems
+
+- [Spaces](./systems/spaces.md) - Space architecture
+- [Public Spaces](./systems/spaces-public.md) - Public space patterns
+- [Fidgets](./systems/fidgets.md) - Fidget system
+- [Configuration](./systems/configuration.md) - Multi-tenant config
+- [Navigation](./systems/navigation.md) - Navigation system
+- [Themes](./systems/themes.md) - Theme system
+- [Discovery](./systems/discovery.md) - Mini-app discovery
+
+## Integrations
+
+- [Supabase](./integrations/supabase.md) - Database & storage
+- [Farcaster](./integrations/farcaster.md) - Protocol integration
+
+## Development
+
+- [Development Guide](./development/guide.md) - Comprehensive guide
+- [Coding Standards](./development/coding-standards.md) - Code style
+- [Testing](./development/testing.md) - Testing strategies