Routstr Frontend

Overview

Routstr is a decentralized LLM routing marketplace powered by Nostr and Bitcoin. This repository contains the Next.js app (App Router) that provides the UI for browsing providers/models, interacting with models via an OpenAI-compatible API, and handling Cashu/Lightning flows.

Tech Stack

• Framework: Next.js 15 (App Router), React 19, TypeScript
• Styling: Tailwind CSS v4, tailwind-merge
• UI Primitives: Radix UI, Lucide icons
• Protocols: nostr-tools (NIP-07, signing, relays)
• Payments: @cashu/cashu-ts
• Data Viz: react-globe.gl, three, cobe

Getting Started

Requirements

• Node.js ≥ 18.18 (20 LTS recommended)
• npm ≥ 9

Quickstart

npm install
npm run dev
# open http://localhost:3000

Scripts

• npm run dev — Start the dev server (Turbopack)
• npm run build — Build for production
• npm run start — Start the production server
• npm run lint — Run ESLint

Project Structure

app/                 # App Router pages and routes
  models/            # Model listing and detail routes
  providers/         # Provider listing and detail routes
  roadmap/           # Roadmap page
components/          # UI and feature components (incl. ui/ primitives)
lib/                 # Helpers (nostr, utils, filters)
utils/               # Domain utilities (cashu, nip60, storage)
context/             # React contexts (e.g., NostrContext)

Configuration & Environment

• No required environment variables for local development are currently used by the app.
• Images from Twitter domains are allowed via next.config.ts (pbs.twimg.com). If you fetch images from other domains, add them there.

Styling

• Tailwind CSS v4 using @tailwindcss/postcss config. Global styles live in app/globals.css.

Deployment

Build and run:

npm run build
npm run start

Vercel is recommended for zero-config deployments of Next.js apps.

Contributing

Please check the Issues tab and coordinate work via the project board: github.com/orgs/Routstr/projects/1. Happy contributing!

License

MIT — see LICENSE.