feat: Implement core Discord clone functionality including Convex backend, Electron frontend, and UI components for chat, voice, and settings.

CLAUDE.md

@@ -1 +1,74 @@
-**Update this file when making significant changes.**
+**Update this file when making significant changes.**
+
+See also: [CONVEX_RULES.md](./CONVEX_RULES.md) | [CONVEX_EXAMPLES.md](./CONVEX_EXAMPLES.md)
+
+## Architecture
+
+- **Backend**: Convex (reactive database + serverless functions)
+- **Frontend**: React + Vite (Electron app)
+- **Auth**: Zero-knowledge custom auth via Convex mutations (getSalt, verifyUser, createUserWithProfile)
+- **Real-time**: Convex reactive queries (`useQuery` auto-updates all connected clients)
+- **Voice/Video**: LiveKit (token generation via Convex Node action)
+- **E2E Encryption**: Client-side via Electron IPC (`window.cryptoAPI`)
+- **File Storage**: Convex built-in storage (`generateUploadUrl` + `getUrl`)
+
+## Key Convex Files (convex/)
+
+- `schema.ts` - Full schema: userProfiles, channels, messages, messageReactions, channelKeys, roles, userRoles, invites, dmParticipants, typingIndicators, voiceStates
+- `auth.ts` - getSalt, verifyUser, createUserWithProfile, getPublicKeys
+- `channels.ts` - list, get, create, rename, remove (with cascade delete)
+- `channelKeys.ts` - uploadKeys, getKeysForUser
+- `messages.ts` - list (with reactions + username), send, remove
+- `reactions.ts` - add, remove
+- `typing.ts` - startTyping, stopTyping, getTyping, cleanExpired (scheduled)
+- `dms.ts` - openDM, listDMs
+- `invites.ts` - create, use, revoke
+- `roles.ts` - list, create, update, remove, listMembers, assign, unassign, getMyPermissions
+- `voiceState.ts` - join, leave, updateState, getAll
+- `voice.ts` - getToken (Node action, livekit-server-sdk)
+- `files.ts` - generateUploadUrl, getFileUrl
+- `gifs.ts` - search, categories (Node actions, Tenor API)
+
+## Frontend Structure (FrontEnd/Electron/src/)
+
+- `main.jsx` - ConvexProvider + VoiceProvider + HashRouter
+- `pages/Login.jsx` - Convex auth (getSalt + verifyUser)
+- `pages/Register.jsx` - Convex auth (createUserWithProfile + invite flow)
+- `pages/Chat.jsx` - useQuery for channels, channelKeys, DMs
+- `components/ChatArea.jsx` - Messages, typing, reactions via Convex queries/mutations
+- `components/Sidebar.jsx` - Channel creation, key distribution, invites via Convex
+- `contexts/VoiceContext.jsx` - Voice state via Convex + LiveKit room management
+- `components/ChannelSettingsModal.jsx` - Channel rename/delete via Convex mutations
+- `components/ServerSettingsModal.jsx` - Role management via Convex queries/mutations
+- `components/FriendsView.jsx` - User list via Convex query
+- `components/DMList.jsx` - DM user picker via Convex query
+- `components/GifPicker.jsx` - GIF search via Convex action
+- `components/VoiceRoom.jsx` - LiveKit token via Convex action
+
+## Important Patterns
+
+- Channel IDs use Convex `_id` (not `id`) - all references use `channel._id`
+- Auth: client hashes DAK -> HAK before sending, server does string comparison
+- First user bootstrap: createUserWithProfile creates Owner + @everyone roles
+- Vite config uses `envDir: '../../'` to pick up root `.env.local`
+- `socket.io-client` fully removed, all socket refs replaced with Convex
+- No Express backend needed - `Backend/` directory is legacy and can be deleted
+- Convex queries are reactive - no need for manual refresh or socket listeners
+- File uploads use Convex storage: `generateUploadUrl` -> POST blob -> `getFileUrl`
+- Typing indicators use scheduled functions for TTL cleanup
+
+## Environment Variables
+
+In `.env.local` at project root:
+- `CONVEX_DEPLOYMENT` - Convex deployment URL (set by `npx convex dev`)
+- `VITE_CONVEX_URL` - Convex URL for frontend (set by `npx convex dev`)
+- `VITE_LIVEKIT_URL` - LiveKit server URL
+- `LIVEKIT_API_KEY` - LiveKit API key (used in Convex Node action)
+- `LIVEKIT_API_SECRET` - LiveKit API secret (used in Convex Node action)
+- `TENOR_API_KEY` - Tenor GIF API key (used in Convex Node action)
+
+## Running the App
+
+1. `npm install && npm run install:frontend`
+2. `npx convex dev` (starts Convex backend, creates `.env.local`)
+3. In another terminal: `cd FrontEnd/Electron && npm run dev` (or `npm run electron:dev`)