Skip to content

VibeTrack is a Farcaster Mini App that lets you analyze your Arbitrum wallet's onchain vibe, get a theme song, and share your results to Farcaster.

License

Notifications You must be signed in to change notification settings

hummusonrails/v1b3

Repository files navigation

VibeTrack Splash

🎵 VibeTrack – Arbitrum Wallet Vibes for Farcaster

Vite Farcaster Arbitrum PRs Welcome License

Analyze your Arbitrum wallet's onchain vibe, get a theme song, and share your results to Farcaster!


✨ Live Demo

🚀 Try it now: VibeTrack Mini App

Demo


🎯 Features

  • 🔗 Connect your wallet (Warpcast-native or browser wallets)
  • 🧙‍♂️ Analyze your Arbitrum wallet's onchain vibe
  • 🎶 Get a theme song and fun description
  • 🟣 Share your results to Farcaster via ComposeCast
  • 🎨 Modern UI with Tailwind CSS and Arbitrum branding

🛠️ Quick Start

# 1. Clone the repo
$ git clone https://github.com/hummusonrails/v1b3.git
$ cd vibe-track

# 2. Install dependencies
$ npm install

# 3. Run locally
$ npm run dev

💡 Tip: Update your public/.well-known/farcaster.json and <meta name="fc:frame"> in index.html with your production URL before deploying!


🧩 Farcaster Mini App Integration

📄 Manifest (farcaster.json)

  • Served from public/.well-known/farcaster.json
  • Fields: name, description, icon, appUrl, splashBackgroundImageUrl, requiredCapabilities
  • Update appUrl to your deployed app URL before launch
  • Serve a static image for splashBackgroundImageUrl (e.g., /splash.png)

🖼️ Frame Embed (fc:frame)

Add this to your index.html to make your app shareable in Farcaster feeds:

<head>
  <!-- other tags -->
  <meta name="fc:frame" content='{"version":"next","imageUrl":"/splash.png","button":{"title":"Open","action":{"type":"launch_frame","name":"VibeTrack","url":"https://your-app-url.xyz"}}}' />
</head>

💻 Tech Stack


🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page or submit a pull request.

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a pull request

🌐 Community & Support


Arbitrum Logo VibeTrack Icon


Made with ❤️ for the Farcaster & Arbitrum community

About

VibeTrack is a Farcaster Mini App that lets you analyze your Arbitrum wallet's onchain vibe, get a theme song, and share your results to Farcaster.

Topics

Resources

License

Stars

Watchers

Forks