Nostr Protocol specifications on Nostr https://nostrhub.io
  • TypeScript 98.1%
  • CSS 1.1%
  • HTML 0.6%
  • JavaScript 0.2%
Find a file
@s.roertgen 9bdfd8fab1
Some checks failed
Deploy to GitHub Pages / deploy (push) Failing after 3s
Test / test (push) Failing after 1m43s
Replace CLAUDE.md symlink with standalone Claude Code config
The symlink pointed to the MKStack generator's shared CONTEXT.md.
Replace with a concise, actionable file tailored for Claude Code
covering commands, architecture, conventions, and Nostr guidelines.
2026-02-04 10:54:02 +01:00
.github Stack: file:///home/alex/Projects/mkstack 2025-05-30 10:40:19 +02:00
.vscode npx -y 2025-04-21 13:47:22 -05:00
public Add improved og image 2025-06-09 11:00:38 -05:00
scripts Render 404.html separate from index.html 2025-12-30 20:28:53 -06:00
src Fix NIP-19 relay hints being ignored when resolving events 2026-02-04 10:53:13 +01:00
.cursorrules Stack: file:///home/alex/Projects/mkstack 2025-05-30 10:40:19 +02:00
.gitignore Add custom Nostr hooks, improve goosehints 2025-04-17 11:23:46 -05:00
.gitlab-ci.yml Refactor CommentsSection to handle root/reply (and i) of any range correctly 2025-07-13 18:16:28 -05:00
.goosehints Stack: file:///home/alex/Projects/mkstack 2025-05-30 10:40:19 +02:00
.gooseignore Add gooseignore comments 2025-04-17 16:44:31 -05:00
.mcp.json npx -y 2025-04-21 13:47:22 -05:00
.npmrc Create mkstack 2025-04-16 21:43:54 -05:00
404.html We need 404.html 2025-12-30 20:45:07 -06:00
agent.json Update agent.json 2025-07-06 19:06:32 -05:00
CLAUDE.md Replace CLAUDE.md symlink with standalone Claude Code config 2026-02-04 10:54:02 +01:00
codex.md Stack: file:///home/alex/Projects/mkstack 2025-05-30 10:40:19 +02:00
components.json Create mkstack 2025-04-16 21:43:54 -05:00
CONTEXT.md Remove sonner and next-themes 2025-09-23 13:48:39 -05:00
eslint.config.js Prevent the robot disabling eslint 2025-06-02 22:55:16 -05:00
index.html Add prerender routes 2025-06-10 21:22:26 -05:00
LICENSE Add new file 2025-05-30 20:10:56 +00:00
package-lock.json Upgrade Nostrify, npm audit fix 2026-02-02 13:24:11 -06:00
package.json Upgrade Nostrify, npm audit fix 2026-02-02 13:24:11 -06:00
postcss.config.js Create mkstack 2025-04-16 21:43:54 -05:00
README.md Use pure Markdown approach to Edit with Nostr button 2025-09-26 21:31:10 -05:00
recipe.yaml Slight instructions wording 2025-04-23 10:45:38 -05:00
stack.json Improve stack image 2025-05-07 11:19:08 -05:00
tailwind.config.ts Add eslint to ci 2025-05-23 12:39:21 +02:00
tsconfig.app.json Add custom Nostr hooks, improve goosehints 2025-04-17 11:23:46 -05:00
tsconfig.json Add custom Nostr hooks, improve goosehints 2025-04-17 11:23:46 -05:00
tsconfig.node.json Create mkstack 2025-04-16 21:43:54 -05:00
vite.config.ts Render 404.html separate from index.html 2025-12-30 20:28:53 -06:00

NostrHub

Edit with Shakespeare

A website for viewing official Nostr Implementation Possibilities (NIPs) and publishing custom NIPs on the Nostr network.

🌐 Live Site: https://nostrhub.io/

Features

Official NIPs

  • Browse and search through official NIPs from the nostr-protocol/nips repository
  • View NIPs with proper markdown rendering and syntax highlighting
  • Direct links to GitHub for each official NIP

Custom NIPs

  • Publish your own custom NIPs on the Nostr network using kind 30817 events
  • Edit and update your published NIPs
  • View recent custom NIPs from the community
  • Support for NIP-19 naddr identifiers

Features

  • Markdown Support: Full markdown rendering with syntax highlighting for code blocks
  • Nostr Integration: Built on the Nostr protocol for decentralized publishing
  • Responsive Design: Works on desktop and mobile devices
  • Search: Search through official NIPs by number or title
  • User Authentication: Login with Nostr extensions (NIP-07) or other methods

URL Structure

  • / - Home page with official NIPs and recent custom NIPs
  • /nip/01 - View official NIP-01
  • /nip/naddr1... - View custom NIP by naddr (NIP-19 identifier)
  • /create - Create a new custom NIP
  • /edit/naddr1... - Edit an existing custom NIP (owner only)
  • /my-nips - View your published NIPs

Custom NIP Format

Custom NIPs are published as kind 30817 events with the following structure:

  • content: The markdown content of the NIP
  • d tag: Unique identifier for the NIP
  • title tag: The title of the NIP
  • k tags: Event kinds that this NIP defines or relates to (optional)

Technology Stack

  • React 18 with TypeScript
  • TailwindCSS for styling
  • shadcn/ui for UI components
  • Nostrify for Nostr protocol integration
  • React Router for routing
  • TanStack Query for data fetching
  • React Markdown for markdown rendering
  • Vite for build tooling

Development

# Install dependencies and start development server
npm run dev

# Run tests
npm run test

# Build for production
npm run build

# Deploy
npm run deploy

Contributing

This project welcomes contributions! Feel free to:

  • Report bugs or suggest features via GitHub issues
  • Submit pull requests for improvements
  • Create and share your own custom NIPs

License

MIT License - see LICENSE file for details.