- Vite + React + TypeScript setup - Project filtering and search functionality - Dark theme with Tailwind CSS - Static JSON data structure for social protocols
···11+# React + TypeScript + Vite
22+33+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
44+55+Currently, two official plugins are available:
66+77+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) for Fast Refresh
88+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
99+1010+## Expanding the ESLint configuration
1111+1212+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
1313+1414+```js
1515+export default tseslint.config([
1616+ globalIgnores(['dist']),
1717+ {
1818+ files: ['**/*.{ts,tsx}'],
1919+ extends: [
2020+ // Other configs...
2121+2222+ // Remove tseslint.configs.recommended and replace with this
2323+ ...tseslint.configs.recommendedTypeChecked,
2424+ // Alternatively, use this for stricter rules
2525+ ...tseslint.configs.strictTypeChecked,
2626+ // Optionally, add this for stylistic rules
2727+ ...tseslint.configs.stylisticTypeChecked,
2828+2929+ // Other configs...
3030+ ],
3131+ languageOptions: {
3232+ parserOptions: {
3333+ project: ['./tsconfig.node.json', './tsconfig.app.json'],
3434+ tsconfigRootDir: import.meta.dirname,
3535+ },
3636+ // other options...
3737+ },
3838+ },
3939+])
4040+```
4141+4242+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
4343+4444+```js
4545+// eslint.config.js
4646+import reactX from 'eslint-plugin-react-x'
4747+import reactDom from 'eslint-plugin-react-dom'
4848+4949+export default tseslint.config([
5050+ globalIgnores(['dist']),
5151+ {
5252+ files: ['**/*.{ts,tsx}'],
5353+ extends: [
5454+ // Other configs...
5555+ // Enable lint rules for React
5656+ reactX.configs['recommended-typescript'],
5757+ // Enable lint rules for React DOM
5858+ reactDom.configs.recommended,
5959+ ],
6060+ languageOptions: {
6161+ parserOptions: {
6262+ project: ['./tsconfig.node.json', './tsconfig.app.json'],
6363+ tsconfigRootDir: import.meta.dirname,
6464+ },
6565+ // other options...
6666+ },
6767+ },
6868+])
6969+```
+59
claude.md
···11+22+Project: Social Meshes builder, you are a distinguished Staff engineer actively building social meshes, This project is a web-based explorer for open social networks. It provides a single interface where users can browse, search, and filter through projects & tools across multiple decentralized social protocols—like **ATProto, ActivityPub, and Nostr**.
33+44+55+66+## Builder Mindset
77+88+99+1010+- Ship working code today, refactor tomorrow
1111+1212+- Security is built-in, not bolted-on
1313+1414+- Test-driven: write the test, then make it pass
1515+1616+- When stuck, check Context7 for patterns and examples
1717+1818+- ASK QUESTIONS if you need context surrounding the product DONT ASSUME
1919+2020+2121+2222+#### Human & LLM Readability Guidelines:
2323+2424+- Descriptive Naming: Use full words over abbreviations (e.g., CommunityGovernance not CommGov)
2525+2626+2727+2828+## Tech Stack
2929+3030+- **Frontend**: **Vite + React + TypeScript** (simple SPA, no Next.js)
3131+- **Fuse.js** for client-side search
3232+- **Static JSON data** in `/data/projects.json` (split per network if desired)
3333+- **Tailwind CSS** for styling (dark theme)
3434+3535+3636+3737+3838+## Core Principles
3939+4040+1. **Type Safety** - TypeScript strict mode, no `any`
4141+4242+2. **Security by Default** - OWASP guidelines
4343+4444+3. **Clean Architecture** - Separation of concerns
4545+4646+4747+4848+## TypeScript Standards
4949+5050+- Strict mode enabled
5151+- Explicit return types
5252+- Proper error types
5353+- Use `unknown` over `any`
5454+- Interfaces for object shapes
5555+5656+## Key Reminders
5757+5858+- Validate all user inputs
5959+- Implement proper error handling