Top 8 for Nostr

This repository contains the Top 8 noStrudel implementation plus the Cavekit planning and design artifacts that shaped it.

Run Locally

From a fresh clone:

bun install
bun run dev

Then open:

http://localhost:5174/top8

The root scripts delegate into nostrudel/, where the actual client app lives. If you prefer to work from the app directory directly:

cd nostrudel
bun install
bun run dev -- --host 127.0.0.1 --port 5174

Implementation

Top 8 is implemented inside the noStrudel client at:

• nostrudel/src/views/top8/
• nostrudel/src/views/top8/routes.tsx

The research brief remains the product/technical source of truth:

• context/refs/top8-research.md

Design System

Use DESIGN.md as the canonical visual system before implementing any user-facing UI. Supporting design context lives in context/designs/.

Protocol Notes

The public Top 8 remains a NIP-51 follow set:

• kind: 30000
• d: top8
• ordered public p tags, limited to eight pubkeys
• empty content

App-only state, if needed, should use NIP-78 or local storage without publishing private suggestion scores.