chore: public sync (squashed snapshot; exclude apps/api, packages/indexer)

Author: Public Sync Bot

.cursorrules

@@ -0,0 +1,94 @@
+You are a Senior Front-End Developer working on a social media platform. You are an expert in the technologies listed below. Your answers should be accurate, thoughtful, and well reasoned.
+
+- Follow the user's requirements exactly.
+- Plan your solution step by step and describe it in detailed pseudocode.
+- Confirm the approach and then write the code.
+- Produce correct, bug-free code that follows the Code Implementation Guidelines.
+- Prioritize clarity and readability over micro-optimizations.
+- Implement all requested features completely.
+- Do not leave TODOs, placeholders, or incomplete sections.
+- Verify the code is finished before delivering it.
+- Include all required imports and use descriptive names for key components.
+- Be concise and minimize extra prose.
+- If a correct answer is unclear, state that there may not be one.
+- If you do not know the answer, say so rather than guessing.
+- Avoid code comments unless a function needs additional explanation.
+
+### Tech Stack
+
+The user may ask about any of these technologies:
+
+- ReactJS
+- Vite
+- JavaScript
+- TypeScript
+- HeadlessUI
+- TailwindCSS
+- HTML
+- CSS
+- Apollo GraphQL
+- Radix
+- Hono
+- Prisma with Postgres
+- Zod
+- Zustand
+- Prosekit
+- Remark and Rehype
+
+### Code Implementation Guidelines
+
+Follow these rules when writing code:
+
+- Use early returns whenever possible to improve readability.
+- In React, always export the default component at the end of the file.
+- Style elements only with Tailwind classes; do not use CSS or style tags.
+- Use descriptive names for variables and functions. Event handlers should start with `handle`, such as `handleClick` or `handleKeyDown`.
+- Add accessibility attributes to interactive elements. For example, a tag should include `tabindex="0"`, `aria-label`, `onClick`, and `onKeyDown`.
+- Prefer arrow functions to function declarations and define types when possible.
+
+### Monorepo Management
+
+- Use pnpm workspaces for managing the monorepo.
+- Keep packages isolated and manage dependencies carefully.
+- Share configurations and scripts where appropriate.
+- Follow the workspace structure defined in the root `package.json`.
+
+### Error Handling and Validation
+
+- Handle errors and edge cases first.
+- Use early returns for error conditions to avoid nesting.
+- Apply guard clauses to manage invalid states early.
+- Provide clear error logging and user-friendly messages.
+- Use custom error types or factories for consistency.
+
+### State Management and Data Fetching
+
+- Use Zustand for state management.
+- Use TanStack React Query for data fetching, caching, and synchronization.
+- Use Apollo Client for GraphQL operations.
+- Minimize `useEffect` and `setState`; prefer derived state and memoization when possible.
+
+### TypeScript and Zod Usage
+
+- Use TypeScript throughout the codebase; prefer interfaces for object shapes.
+- Name interfaces after their component. For example, `Account` should use `AccountProps`.
+- Use Zod for schema validation and type inference.
+- Avoid enums; prefer literal types or maps.
+- Write functional components with TypeScript interfaces for props.
+
+### Code Style and Structure
+
+- Write concise TypeScript code with accurate examples.
+- Use functional and declarative patterns; avoid classes.
+- Prefer iteration and modularization to avoid duplication.
+- Use camelCase for variables and functions.
+- Use uppercase for environment variables.
+- Start function names with a verb, such as `handleClick`, `handleKeyDown`, or `handleChange`.
+- Use verbs for boolean variables, for example `isLoading`, `hasError`, or `canDelete`.
+- Spell out words fully and use correct spelling.
+- Structure files with exported components, subcomponents, helpers, static content, and types.
+
+### References
+
+- [Lens Protocol Docs](https://lens.xyz/docs/protocol)
+- [Grove Storage Docs](https://lens.xyz/docs/storage)

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @bigint

.github/workflows/remove-codex.yml

@@ -0,0 +1,52 @@
+name: Remove Codex Label
+
+on:
+  pull_request:
+    types: [opened, reopened, labeled, synchronize]
+
+permissions:
+  pull-requests: write
+
+jobs:
+  cleanup:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const labels = pr.labels.map(label => label.name);
+            core.info(`Found labels on PR: ${JSON.stringify(labels)}`);
+
+            const codexLabels = labels.filter(name => name.toLowerCase().includes('codex'));
+            core.info(`Codex labels detected: ${JSON.stringify(codexLabels)}`);
+
+            if (codexLabels.length > 0) {
+              for (const label of codexLabels) {
+                try {
+                  await github.rest.issues.removeLabel({
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    issue_number: pr.number,
+                    name: label,
+                  });
+                  core.info(`✅ Removed label: ${label}`);
+                } catch (err) {
+                  core.warning(`❌ Failed to remove label "${label}": ${err.message}`);
+                }
+              }
+
+              try {
+                await github.rest.pulls.update({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  pull_number: pr.number,
+                  body: '',
+                });
+                core.info('🧹 Cleared PR description.');
+              } catch (err) {
+                core.warning(`❌ Failed to clear PR description: ${err.message}`);
+              }
+            } else {
+              core.info('No codex label found. Skipping description clear.');
+            }

.github/workflows/test.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 10.4.1
+          run_install: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm test

.gitignore

@@ -0,0 +1,44 @@
+# dependencies
+node_modules
+.pnp
+.pnp.js
+
+# testing
+coverage
+
+# expo
+.expo/
+expo-env.d.ts
+credentials.json
+ios/
+android/
+*.ipa
+*.apk
+
+# misc
+.DS_Store
+*.pem
+.eslintcache
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+.env
+
+# typescript
+*.tsbuildinfo
+
+# JetBrains IDE
+.idea
+
+# Node build artifacts
+dist
+node-compile-cache/

.husky/pre-commit

@@ -0,0 +1,2 @@
+pnpm run biome:check
+pnpm typecheck

.nvmrc

@@ -0,0 +1 @@
+20

.vscode/extensions.json

@@ -0,0 +1,15 @@
+{
+  "recommendations": [
+    "formulahendry.auto-close-tag",
+    "mikestead.dotenv",
+    "biomejs.biome",
+    "GitHub.github-vscode-theme",
+    "mquandalle.graphql",
+    "PKief.material-icon-theme",
+    "Prisma.prisma",
+    "christian-kohler.npm-intellisense",
+    "bradlc.vscode-tailwindcss",
+    "yzhang.markdown-all-in-one",
+    "yoavbls.pretty-ts-errors"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,37 @@
+{
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
+  },
+  "[solidity]": {
+    "editor.defaultFormatter": "NomicFoundation.hardhat-solidity",
+    "editor.tabSize": 1
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "editor.codeActionsOnSave": {
+    "source.fixAll.biome": "explicit"
+  },
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.fontFamily": "MonoLisa, Menlo, Monaco, 'Courier New', monospace",
+  "editor.fontSize": 12,
+  "editor.formatOnSave": true,
+  "editor.insertSpaces": true,
+  "editor.lineHeight": 2.3,
+  "editor.tabSize": 2,
+  "git.autofetch": true,
+  "git.confirmSync": false,
+  "git.enableSmartCommit": true,
+  "search.exclude": {
+    "**/node_modules": true
+  }
+}

AGENTS.md

@@ -0,0 +1,57 @@
+# Repository Agent Guidelines
+
+This project uses the coding and collaboration rules defined in `.cursorrules`.
+
+## General Principles
+
+- Implement requests thoroughly and adhere strictly to the requirements.
+- Plan solutions carefully before writing any code.
+- Produce clean, functional code that follows best practices.
+- Prioritize readability over performance and avoid duplication.
+- Include all required imports and use clear, descriptive names.
+- Remove placeholders or incomplete sections before committing.
+
+## Tech Stack
+
+- React with Vite and TypeScript
+- HeadlessUI, Tailwind CSS, and Radix
+- Apollo GraphQL with Hono
+- Prisma with Postgres
+- Zustand and TanStack React Query
+- Zod for validation
+- Prosekit with Remark and Rehype
+
+## Implementation Guidelines
+
+- Use early returns and guard clauses.
+- Export default React components at the end of each file.
+- Style elements exclusively with Tailwind classes.
+- Name event handlers with a `handle` prefix (e.g., `handleClick`).
+- Add accessibility attributes like `tabIndex`, `aria-label`, and keyboard handlers.
+- Prefer arrow functions and define types or interfaces for props.
+- Place files in pnpm workspaces and keep packages isolated.
+- Handle errors early with custom error types when appropriate.
+- Favor derived state and memoization over excessive `useEffect`.
+- Use interfaces for props and avoid enums, preferring literal types.
+- Follow camelCase naming and use verbs for boolean flags.
+- Organize exports, subcomponents, helpers, static content, and types within files.
+
+## References
+
+- [Lens Protocol Documentation](https://lens.xyz/docs/protocol)
+- [Grove Storage Documentation](https://lens.xyz/docs/storage)
+
+## Required Commands
+
+Run these commands before committing:
+
+- `pnpm biome:check`
+- `pnpm typecheck`
+- `pnpm build`
+- `pnpm test`
+
+## PR Instructions
+
+- Use a conventional commit message for the title.
+- Example: `feat: allow provided config object to extend other configs`.
+- Keep the title under 50 characters.