Skip to content

0x4543/farcaster-coin-clicker

Repository files navigation

🪙 Farcaster Coin Clicker

Farcaster Coin Clicker is a playful Farcaster Mini App where users grow their virtual portfolio and mint an NFT on the Base network. Built for fun, engagement, and to explore the creative potential of Farcaster Mini Apps.

Preview

▶️ Open Coin Clicker


✨ Overview

Coin Clicker lets you tap to grow your portfolio, share progress to Farcaster, and mint your portfolio NFT directly on Base. Designed for smooth mobile experience inside the Farcaster app and works standalone on web.


⚙️ Features

  • Farcaster Mini App integration via @farcaster/miniapp-sdk
  • Wallet authentication using Privy
  • On-chain NFT minting on Base Mainnet
  • Animated tap interaction and coin burst effect
  • Seamless UI for both standalone and embedded modes

🧩 Tech Stack

  • React + Vite frontend
  • Ethers.js v6 for blockchain interactions
  • Privy for wallet and Farcaster login
  • Farcaster Mini App SDK for in-app actions
  • Base network for NFT minting

🚀 Getting Started

1. Clone the repo

git clone https://github.com/0x4543/farcaster-coin-clicker.git
cd farcaster-coin-clicker

2. Install dependencies

npm install

3. Set up environment variables

Create a .env file based on the provided example:

cp .env.example .env

Edit .env with your Privy app ID:

VITE_PRIVY_APP_ID=your_privy_app_id

4. Run locally

npm run dev

5. Build for production

npm run build

☁️ Deployment

The project is optimized for Vercel deployment.

  1. Push your repo to GitHub.
  2. Connect it to Vercel.
  3. Add your environment variables in Vercel settings.
  4. Deploy 🚀

Live demo: https://farcaster-coin-clicker.vercel.app/


🔗 Useful Links


🧠 Future Plans

  • Community search integration inside Farcaster app
  • Portfolio-based NFT metadata
  • Extended miniapp features (leaderboard, rewards)

📄 License

MIT License


🧑‍💻 Author

0x4543
Farcaster: @0x4543
GitHub: https://github.com/0x4543

Releases

No releases published

Packages

No packages published