Skip to content

Repository files navigation

Nostr Run Club

Nostr Run Club is a simple running app built on the Nostr protocol.

About

I created Nostr Run Club because I was using Nike Run app and wanted to be more "nostr only." When I didn't see a run tracking app on nostr, I decided to build one myself. It's pretty basic right now, but it works!

Features

Current

  • Login with Nostr
  • Track your runs
  • Post runs to Nostr
  • Interact with global running feed

Coming Soon

  • Wavlake integration
  • E-cash features
  • Level system

Future Roadmap

  • Team features
  • Virtual races
  • Merch store
  • Custom themes
  • Nostr banner integration
  • Standardized run data format

Development Stages

Stage 1: Core Functionality

  • Bug fixes
  • Performance optimization
  • Code cleanup

Stage 2: Feature Enhancement

  • Wavlake integration
  • Level system
  • Reward system

Stage 3: Community Features

  • Nostr group integration
  • Merchandise
  • Virtual races

Tech Stack

  • Next.js
  • TailwindCSS
  • Nostr Protocol

Getting Started

# Clone the repository
git clone https://github.com/TheWildHustle/Nostr-Run-Club.git

# Install dependencies
npm install

# Build the react app
npm run dev

# sync the react build with android
npx cap sync android

# This launches Android Studio.
# Select Run on Emulator or Connect a real device.
npx cap open android


Contributing

Contributions are welcome! While current focus is on core functionality and bug fixes, feel free to:

  1. Fork the repo
  2. Create a feature branch
  3. Submit a pull request

Vision

The ultimate goal is to create a seamless running experience where users can:

  • Connect with running teams on nostr
  • Stream Wavlake playlists during runs
  • Participate in virtual training sessions
  • Compete in virtual 5k events
  • Earn rewards and experience points
  • Share achievements easily
  • Purchase NRC merchandise
  • Interact with the running community

License

MIT License

Contact

Nostr - TheWildHustle@primal.net

About

A Nostr Run App

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages