Listr

January 18, 2026 ยท View on GitHub

A Nostr-based list management application built with SvelteKit. Create, manage, and discover various types of Nostr lists including Contact lists, Mute lists, Bookmarks, Communities, and more.

Prerequisites

Getting Started

# Install dependencies
bun install

# Start development server
bun run dev

# Or start and open in browser
bun run dev -- --open

Available Scripts

CommandDescription
bun run devStart development server
bun run buildBuild for production
bun run previewPreview production build
bun run checkRun svelte-check for type checking
bun run lintRun Biome linter
bun run formatFormat code with Biome
bun run testRun tests in watch mode
bun run test:runRun all tests once

Tech Stack

  • Framework: SvelteKit with Svelte 5
  • Styling: TailwindCSS, Flowbite Svelte
  • Nostr: @nostr-dev-kit/ndk
  • Testing: Vitest, @testing-library/svelte
  • Linting/Formatting: Biome

Deployment

This project uses @sveltejs/adapter-vercel for deployment to Vercel.