{"id":30232414,"url":"https://github.com/whisperrnote/chats","last_synced_at":"2025-08-15T00:00:50.769Z","repository":{"id":303502167,"uuid":"1015573534","full_name":"whisperrnote/chats","owner":"whisperrnote","description":"open source, secure chat application","archived":false,"fork":false,"pushed_at":"2025-08-07T23:22:13.000Z","size":1206,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-07T23:26:04.612Z","etag":null,"topics":["chat","privacy","security","signal","telegram","whatsapp"],"latest_commit_sha":null,"homepage":"https://chat.whisperrnote.space","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whisperrnote.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-07T17:52:22.000Z","updated_at":"2025-08-07T23:22:16.000Z","dependencies_parsed_at":"2025-08-07T23:16:44.607Z","dependency_job_id":"e2f4a9aa-cfb6-4d34-9ef1-bd276aeb782b","html_url":"https://github.com/whisperrnote/chats","commit_stats":null,"previous_names":["whisperrnote/chats"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/whisperrnote/chats","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whisperrnote%2Fchats","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whisperrnote%2Fchats/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whisperrnote%2Fchats/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whisperrnote%2Fchats/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whisperrnote","download_url":"https://codeload.github.com/whisperrnote/chats/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whisperrnote%2Fchats/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270500676,"owners_count":24595163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-14T02:00:10.309Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat","privacy","security","signal","telegram","whatsapp"],"created_at":"2025-08-15T00:00:46.643Z","updated_at":"2025-08-15T00:00:50.614Z","avatar_url":"https://github.com/whisperrnote.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# whisperrchat\n\n**Next-Gen Secure, Modular, Open-Source Chat Platform**\n\n---\n\n## 🚀 Overview\n\nwhisperrchat is a modern, privacy-first chat application built with Next.js, Appwrite, and RxDB.  \nIt features end-to-end encryption, mnemonic-based authentication, modular theming, and extensible architecture for bots, web3, and more.\n\n---\n\n## ✨ Features\n\n- **Mnemonic-Based Authentication:**  \n  - Users sign up and log in using a unique username and a 12/24-word recovery phrase.\n  - The phrase serves as both password and encryption key for true E2E security.\n\n- **End-to-End Encryption:**  \n  - All messages and sensitive data are encrypted client-side.\n  - Private keys are encrypted with the user's mnemonic-derived key.\n\n- **User Profiles \u0026 Credibility:**  \n  - Rich profiles with avatars, bios, status, and credibility tiers.\n  - Username history and credibility scoring for trust and transparency.\n\n- **Chats \u0026 Messaging:**  \n  - Group, channel, private, bot, and extension chats.\n  - Real-time messaging, reactions, replies, and media sharing.\n  - Modular chat extensions and bots.\n\n- **Patterned \u0026 Animated Backgrounds:**  \n  - Customizable SVG motif backgrounds, theme-aware and animated.\n  - User-selectable themes, animation levels, and live previews.\n\n- **Offline Sync:**  \n  - RxDB integration for seamless offline-first experience.\n  - Automatic sync with Appwrite backend when online.\n\n- **Modular Extensions:**  \n  - Bots, web3 wallets, integrations, and more via the extensions database.\n\n- **Accessibility \u0026 Responsiveness:**  \n  - Full keyboard navigation, screen reader support, and high-contrast mode.\n  - Mobile, tablet, and desktop layouts.\n\n---\n\n## 🛠️ Tech Stack\n\n- **Frontend:** Next.js 15+, React 19, MUI, Framer Motion\n- **Backend:** Appwrite Cloud (Databases, Auth, Storage, Functions)\n- **Offline:** RxDB (client-side sync)\n- **State:** Zustand\n- **Crypto:** BIP39, PBKDF2, AES-GCM (client-side)\n- **Testing:** Storybook, Vitest\n\n---\n\n## 📦 Project Structure\n\n- `/app` — Next.js app routes\n- `/components` — UI and app components\n- `/store` — Zustand state stores\n- `/lib` — Appwrite and crypto utilities\n- `/types` — Appwrite TypeScript types\n- `/public/images` — Logo and assets\n- `/stories` — Storybook stories and docs\n\n---\n\n## 📝 Getting Started\n\n1. **Clone the repo:**\n   ```bash\n   git clone https://github.com/whisperrnote/chats.git\n   cd whisperrchat\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   npm install\n   ```\n\n3. **Configure environment:**\n   - Copy `.env.sample` to `.env.local` and fill in your Appwrite project details.\n\n4. **Run the app:**\n   ```bash\n   npm run dev\n   ```\n\n5. **Open [http://localhost:3000](http://localhost:3000) in your browser.**\n\n---\n\n## 🔒 Security \u0026 Privacy\n\n- **Zero Knowledge:** Recovery phrase is never stored or transmitted.\n- **E2E Encryption:** All chat data is encrypted before leaving the device.\n- **Appwrite Auth:** Secure, scalable authentication and session management.\n\n---\n\n## 🧩 Extensibility\n\n- **Bots \u0026 Integrations:** Easily add bots, web3 wallets, and custom extensions.\n- **Themes \u0026 Patterns:** Users can create, import, and share custom themes and backgrounds.\n- **Animation Packs:** Modular animation system for UI delight.\n\n---\n\n## 📚 Documentation\n\n- [Database Schema](./docxed/whisperrote/chats/database.md)\n- [Authentication](./docxed/docs/appwrite/emailpassword.md)\n- [UI/UX System](./docxed/whisperrote/chats/ui.md)\n- [Animation System](./docxed/whisperrote/chats/animations.md)\n- [Offline Sync](./docxed/docs/appwrite/offline-sync.md)\n\n---\n\n## 💡 Contributing\n\nWe welcome contributions!  \nPlease see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n---\n\n---\n\n## 🏷️ License\n\nMIT © whisperrchat contributors\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhisperrnote%2Fchats","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhisperrnote%2Fchats","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhisperrnote%2Fchats/lists"}