CodyTseng/jumble
CodyTseng/jumble has 222 GitHub stars and 109 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-15 23:57 UTC. Last push 2026-11-15.
Measured star growth
- in 24h
- +1
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A user-friendly Nostr client for exploring relay feeds
Web & AppsREADME.md
Originallogo designed by Daniel David
Jumble
A user-friendly Nostr client for exploring relay feeds
Experience Jumble at https://jumble.social
Forks
Some interesting forks of Jumble.
- https://fevela.me/ - by @daniele
- https://x21.com/ - by @Karnage
- https://jumble.imwald.eu/ Repo: Silberengel/jumble - by @Silberengel
- https://jumble.thecaptain.dev/ by @Vibe Captain
Run Locally
# Clone this repository
git clone https://github.com/CodyTseng/jumble.git
# Go into the repository
cd jumble
# Install dependencies
npm install
# Run the app
npm run dev
Builds use the TypeScript 7 native compiler (tsc), installed as @typescript/native. The typescript dependency aliases the official TypeScript 6 compatibility package so ESLint can continue using its compiler API. Keep both dependencies when updating the toolchain. See the official side-by-side setup.
The dependency overrides move minimatch 10.x consumers to 11.0.3+ and Workbox's glob to 14.0.3+ to address pattern amplification and cancellation handling advisories. Older minimatch consumers retain their declared versions because their APIs differ. Remove these overrides when the upstream tools adopt compatible patched releases.
For a web-only build on a system that cannot download the Electron binary, skip that download while keeping platform-specific build dependencies such as Rolldown and TypeScript:
ELECTRON_SKIP_BINARY_DOWNLOAD=1 npm install
npm run build
Capacitor packages (@capacitor/*) are optional and are only needed for Android.
Web and Electron builds use a local substitute and can build without those packages
installed. Android builds resolve and type-check the actual Capacitor packages.
A normal npm install still includes optional dependencies. Avoid globally omitting
all optional dependencies unless you also provide the platform binaries required
by build tools such as Rolldown.
Run Docker
# Clone this repository
git clone https://github.com/CodyTseng/jumble.git
# Go into the repository
cd jumble
# Run the docker compose
docker compose up --build -d
After finishing, access: http://localhost:8089
Run as Android App (Capacitor)
Android reuses the web UI and business logic, with native encrypted storage, back navigation, deep links, and local notifications. Requires Android SDK 36 and JDK 21.
npm run android:run # Build and launch on an emulator or connected device
npm run android:apk # Build a debug APK
See Android development and release notes for setup, architecture, signing, and the initial integration's limitations.
Run as Desktop App (Electron)
Jumble can also run as a native desktop app via Electron. The desktop build runs all relay WebSockets in the main process (bypassing Chrome's per-origin connection cap) and stores secrets in the OS keychain via Electron's safeStorage.
# Clone and install (same as above)
git clone https://github.com/CodyTseng/jumble.git
cd jumble
npm install
# Start in dev mode (vite dev server + auto-launch Electron)
npm run electron:dev
# Build a distributable for the current platform
# Output goes to release/<version>/
npm run electron:build
# Preview a production build without packaging
npm run electron:preview
Unpackaged Electron runs (electron:dev and electron:preview) use a separate
jumble-dev data directory so they can run alongside the installed app.
Development sessions start with their own accounts and settings.
The web build (npm run dev, npm run build) is unaffected and never loads any Electron-only code.
Continuous integration
Branch pushes and pull requests run lint, the test suite, and a web/PWA build. Windows x64 and Linux x64/arm64 jobs then build installers and launch the unpacked applications. The smoke test checks packaged runtime files, the preload IPC bridge, initial rendering, and Settings navigation. On Linux without a keychain it also exercises password setup on the fresh CI runner. Screenshots and logs are uploaded and downloaded again to verify artifact handling.
scripts/electron-smoke.mjs <unpacked-app-directory> requires a disposable CI runner because it may initialize application storage. To check package contents locally without starting the application, append --verify-only.
Community mode (Optional)
If you want to run Jumble in community mode (with pre-configured relay sets and relays), you can set the following environment variables in a .env file at the root of the project:
VITE_COMMUNITY_RELAY_SETS: Environment variable. Set the default relay sets for Jumble. Multiple relay sets can be configured. If configured, the first preset group will be displayed to visitors by default upon opening. Visitors cannot delete relay sets preset by administrators. This is ideal for communities wishing to host their own Jumble instances or for setting default feeds for family members. Examples:
VITE_COMMUNITY_RELAY_SETS=[{"id": "example.com", "name": "The Example Feed", "relayUrls": ["wss://relay.example.com/", "wss://relay.example.org/"]},{"id": "dailynews", "name": "News", "relayUrls": ["wss://news.example.com/", "wss://news.example.org/"]}]
VITE_COMMUNITY_RELAYS: Environment variable. Set additional default relays for Jumble. Multiple relays can be configured, separated by commas. These relays will be added to the preset relay sets and cannot be removed by visitors. Examples:
VITE_COMMUNITY_RELAYS="wss://relay.example.com/,wss://relay.example.org/"
Sponsors
Donate
If you like this project, you can buy me a coffee :)
- Lightning: [email protected]
- Bitcoin: bc1qwp2uqjd2dy32qfe39kehnlgx3hyey0h502fvht
- Geyser: https://geyser.fund/project/jumble
License
MIT