NostrCount

A decentralized life milestone tracker built on the Nostr protocol. Track your progress, celebrate achievements, and share your journey with the world.

Features

• Censorship Resistant: Built on Nostr for decentralized data storage
• Lightning Zaps: Support creators with Bitcoin Lightning Network payments
• Private or Public: Choose to keep counters private or share them publicly
• Two Counter Types: Track "days since" achievements or "days until" events
• Real-time Updates: Automatic syncing across devices through Nostr relays
• Modern UI: Beautiful, responsive design with Tailwind CSS

Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm or yarn
• A Nostr extension (like Alby, nos2x, or Flamingo) for signing events

Architecture

Tech Stack

• Frontend: React 18 + TypeScript + Vite
• Styling: Tailwind CSS
• Nostr Integration: NDK (Nostr Development Kit)
• Date Handling: Day.js
• Routing: React Router
• Icons: Lucide React

Nostr Implementation

• Event Kind: 30078 (Parameterized Replaceable Events)
• Event Tags:
  • d: Unique identifier/slug
  • type: "since" or "until"
  • title: Human-readable counter name
  • date: ISO date string
  • visibility: "public" or "private"

Data Storage

All counter data is stored on Nostr relays as events. No centralized database is required, making the app fully decentralized and censorship-resistant.

Development

Available Scripts

• npm run dev: Start development server
• npm run build: Build for production
• npm run preview: Preview production build
• npm run lint: Run ESLint

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Issues: Report bugs or request features on GitHub
• Discussions: Join the community discussion