lemon
7ccff2fbad
The home page used to be the canonical browse view for campaigns: hero plus featured row, then the full community grid, then moderator-only Pending/Hidden sections, then a per-viewer 'Your campaigns' shelf. With /campaigns/all, /groups, and /pledges all now hosting their own dedicated browse views (featured + search + sort + country in one unified section), the home page no longer needs to duplicate the campaigns browse experience. Rebuild / as a three-section launchpad: Hero -> unchanged (HeroLightningMap, Bebas Neue tagline, brand CTAs). Featured campaigns -> capped at 4, links to /campaigns/all. Featured groups -> capped at 8, links to /groups. Featured pledges -> capped at 8, links to /pledges. Each section pulls its featured set from the same moderation labels that drive the dedicated page, so what surfaces here matches what surfaces there — just truncated. Sections with no featured items collapse silently (no empty card) so the page degrades gracefully if moderators only curate one or two surfaces. Each section's skeleton respects the dependency chain that gates its underlying query: campaigns wait on useCampaignModeration, groups on useOrganizationModeration (because useFeaturedOrganizations is internally gated on it), pledges on usePledgeModeration. While those are still resolving the section renders skeleton cards rather than flashing an empty state. Drop the unmoderated community grid, the Pending/Hidden moderator sections, the 'Your campaigns' shelf, and the campaign-search toolbar from the home page. All of that now lives on /campaigns/all where viewers actually expect to browse and filter. Add browseAllGroups and browseAllPledges to campaigns.home in all 16 locales so each section can link out with locale-appropriate copy.
Agora
Power to the people.
Agora is a Nostr client focused on community ownership, expressive identity, and censorship resistance. This repository (agora-3) is the Agora-branded app built from the Ditto codebase.
What This Repo Is
- Agora product identity (name, theme, assets, native IDs)
- Ditto-derived implementation with broad Nostr feature coverage
- Configurable deployment defaults via
agora.json
Features
- Community-first social client: notes, articles, comments, reposts, reactions, and rich event rendering
- Theming system: built-in presets + custom color/font/background themes that can be shared as events
- Lightning support: zaps with Nostr Wallet Connect and WebLN
- Private messaging: NIP-04 and NIP-17 direct messages
- Mobile app shell: Capacitor-powered Android/iOS wrappers
- Self-hostable: static web build + configurable relay and upload infrastructure
Getting Started
Prerequisites
- Node.js 22+
- npm 10.9.4+
Development
git clone https://gitlab.com/soapbox-pub/agora-3.git
cd agora-3
npm install
npm run dev
Development server: http://localhost:8080
Docker Getting Started
Use Docker Compose when you want the nginx reverse-proxy stack (necessary if you want decryptable media in messages - kind 15s of NIP 17):
git clone https://gitlab.com/soapbox-pub/agora-3.git
cd agora-3
cp .env.example .env
docker compose up --build
Proxy URL: http://localhost:8083
This starts:
viteservice on the internal Docker network (vite:8080)webservice (nginx) on host port8082, proxying to Vite with websocket support
Stop stack:
docker compose down
Production-style container build:
docker compose -f docker-compose.prod.yml up --build
Build
npm run build
Build output: dist/
Validate
npm test
This runs type-checking, linting, unit tests, and production build checks.
Configuration
Build-time config is read from agora.json (gitignored by default so each deployment can provide its own values).
{
"theme": "dark",
"relayMetadata": {
"relays": [
{ "url": "wss://relay.ditto.pub", "read": true, "write": true },
{ "url": "wss://relay.primal.net", "read": true, "write": true },
{ "url": "wss://relay.damus.io", "read": true, "write": true }
]
},
"blossomServers": [
"https://blossom.ditto.pub",
"https://blossom.primal.net/"
]
}
Configuration priority (highest first):
- User settings (local storage)
- Build config (
agora.json) - Hardcoded app defaults
Use a custom config path:
CONFIG_FILE=./my-config.json npm run build
Deployment
Agora builds to static files and can be deployed to any static host.
- GitLab/GitHub Pages
- Netlify/Vercel
- VPS or any web server with SPA routing fallback
For Android:
npm run build
npx cap sync
npx cap open android
Tech Stack
| Layer | Technology |
|---|---|
| Framework | React 18 |
| Build | Vite |
| Language | TypeScript |
| Styling | TailwindCSS 3 + shadcn/ui |
| Routing | React Router |
| Data | TanStack Query |
| Nostr | Nostrify + nostr-tools |
| Mobile | Capacitor |
| Testing | Vitest + React Testing Library |
Contributing
Read CONTRIBUTING.md before opening a merge request.