🚰 FaucetHub - Your Gateway to Testnet Tokens

A comprehensive directory and tracking platform for Base Sepolia and Ethereum Sepolia testnet faucets.

🎯 Overview

FaucetHub is a modern, privacy-first web application that aggregates 13+ verified testnet faucets in one beautiful interface. Built specifically for Web3 developers, it eliminates the hassle of bookmarking multiple faucet sites and tracking cooldown periods.

🌟 Why FaucetHub?

🎨 Beautiful Web3 Design - Glassmorphism effects, gradient overlays, and smooth animations
🔍 Smart Filtering - Filter by network, search by name/tags, and find the perfect faucet instantly
⏱️ Claim Tracking - Monitor your claim history and cooldown timers across all faucets
🔒 Privacy First - All data stored locally in your browser - zero server-side tracking
📱 Fully Responsive - Works seamlessly on desktop, tablet, and mobile devices
✅ Verified Faucets - Every faucet is tested and actively maintained

✨ Features

🎯 Core Features

Feature	Description
13+ Verified Faucets	Curated list of Base Sepolia & Ethereum Sepolia faucets
Multi-Address Tracking	Track claim history for multiple wallet addresses
Smart Search & Filters	Advanced filtering by network, name, tags, and requirements
Cooldown Timers	Visual countdown for when you can claim again
Status Indicators	Real-time status for each faucet (active, slow, unknown)
Educational Resources	Comprehensive guides on wallets, faucets, and Web3 basics
Ecosystem Integration	Connected with MintLab and Smart Contract Templates

🎨 UI/UX Features

Glassmorphism Design - Modern frosted glass effects with backdrop blur
Animated Gradients - Dynamic color transitions and floating orb animations
Dark Theme - Eye-friendly dark mode optimized for long coding sessions
Mobile Optimized - Touch-friendly interface with responsive layouts
Accessibility - WCAG compliant with proper ARIA labels and semantic HTML

🛠️ Tech Stack

Frontend

Next.js 15.3.4 - React framework with App Router
React 19.1.0 - UI library with concurrent features
TypeScript 5.8.3 - Type-safe development
Tailwind CSS 3.4.1 - Utility-first styling
Radix UI - Accessible component primitives
Lucide React - Beautiful icon library

Web3 Integration

viem 2.38.0 - TypeScript Ethereum library
wagmi 2.15.5 - React Hooks for Ethereum
@coinbase/onchainkit - Coinbase SDK
@farcaster/miniapp-sdk - Farcaster integration

Developer Tools

Framer Motion - Animation library
React Hook Form - Form validation
Zod - Schema validation
Date-fns - Date utilities

📁 Project Structure

faucethub/
├── src/
│   ├── app/
│   │   ├── about/                 # About page with educational tabs
│   │   │   └── page.tsx
│   │   ├── api/                   # API routes
│   │   │   ├── health/            # Health check endpoint
│   │   │   ├── logger/            # Logging service
│   │   │   └── proxy/             # External API proxy
│   │   ├── layout.tsx             # Root layout with metadata
│   │   ├── page.tsx               # Homepage with directory
│   │   ├── providers.tsx          # React Context providers
│   │   ├── globals.css            # Global styles and animations
│   │   └── types/                 # TypeScript type definitions
│   │
│   ├── components/
│   │   ├── ui/                    # Shadcn/Radix UI components
│   │   ├── AddressInput.tsx       # Wallet address input with validation
│   │   ├── ClaimHistory.tsx       # Claim history tracker
│   │   ├── ClaimStatus.tsx        # Individual claim status
│   │   ├── FaucetCard.tsx         # Faucet display card
│   │   ├── FaucetDirectory.tsx    # Main directory component
│   │   ├── Navigation.tsx         # Top navigation bar
│   │   └── Farcaster*.tsx         # Farcaster integration components
│   │
│   ├── lib/
│   │   ├── faucets.ts             # Faucet data and utilities
│   │   ├── claim-tracker.ts       # Claim tracking logic
│   │   ├── storage.ts             # LocalStorage utilities
│   │   ├── validation.ts          # Input validation helpers
│   │   └── utils.ts               # General utilities
│   │
│   └── hooks/
│       ├── use-mobile.tsx         # Mobile detection hook
│       └── useManifestStatus.ts   # Farcaster manifest hook
│
├── public/
│   └── .well-known/
│       └── farcaster.json         # Farcaster configuration
│
├── package.json                   # Dependencies and scripts
├── tsconfig.json                  # TypeScript configuration
├── tailwind.config.ts             # Tailwind configuration
├── next.config.js                 # Next.js configuration
└── README.md                      # This file

🚀 Getting Started

Prerequisites

Node.js 18.x or higher
npm or yarn package manager
A modern web browser (Chrome, Firefox, Safari, Edge)

Installation

Clone the repository

git clone https://github.com/mrbrightsides/faucethub.git
cd faucethub

Install dependencies
```
npm install
# or
yarn install
```
Run the development server
```
npm run dev
# or
yarn dev
```
Open your browser Navigate to http://localhost:3000

Build for Production

# Build the application
npm run build

# Start the production server
npm run start

📚 Documentation

🚰 Available Faucets

FaucetHub currently aggregates 13+ verified faucets across two networks:

Base Sepolia Faucets (6)

Ponzifun Faucet - 1 Base ETH every 48h (fastest, no signup)
QuickNode Base - 1 drip every 12h (multi-chain)
LearnWeb3 Base - 1 drip every 24h (educational)
Base Sepolia PoW - 0.5 Base ETH every 24h (proof-of-work)
Coinbase Base - 0.05-0.1 Base ETH every 24h (official)
Chainstack Base - 0.5 Base ETH every 24h (requires account)

Ethereum Sepolia Faucets (7)

Chainlink Sepolia - Multi-asset support (popular)
Alchemy Sepolia - 0.5 ETH every 24h (requires account)
Infura Sepolia - 0.5 ETH every 24h (requires account)
Google Cloud Sepolia - Simple and reliable
QuickNode Sepolia - 1 drip every 12h (fast)
Sepolia PoW - 0.5 ETH every 24h (proof-of-work)
LearnWeb3 Sepolia - Educational platform

🔧 How It Works

1. Address Tracking

Enter any Ethereum address to track claims
Addresses are stored locally in browser localStorage
Multiple addresses can be tracked simultaneously
Recent addresses are saved for quick access

2. Claim Management

Click "Claim Now" to visit a faucet's website
Click "Mark as Claimed" to start tracking cooldown
Visual countdown timer shows when you can claim again
Claim history is preserved across browser sessions

3. Search & Filter

Network Filter: Show all, Base Sepolia only, or Ethereum Sepolia only
Search: Find faucets by name, description, or tags
Smart Tags: Filter by tags like "fast", "no-signup", "official"

4. Privacy

All data is stored in localStorage (client-side only)
No server-side tracking or data collection
No cookies, analytics, or third-party trackers
Clear data anytime by clearing browser storage

🎨 Customization

Adding New Faucets

Edit src/lib/faucets.ts to add new faucets:

{
  id: 'unique-id',
  name: 'Faucet Name',
  network: 'Base Sepolia' | 'Ethereum Sepolia' | 'Both',
  amount: '1 ETH',
  frequency: 'Every 24 hours',
  url: 'https://faucet-url.com',
  requiresAuth: false,
  authType?: 'Service Name', // Optional
  description: 'Brief description',
  status: 'active' | 'slow' | 'unknown',
  tags: ['tag1', 'tag2'],
  logo?: 'https://logo-url.com/logo.png' // Optional
}

Styling

FaucetHub uses Tailwind CSS with custom animations defined in src/app/globals.css:

Gradients: Animated background gradients with animate-gradient
Float: Floating orb animations with animate-float
Glow: Pulsing glow effects with animate-glow
Glassmorphism: Custom .glass-card utility class

To customize colors, edit tailwind.config.ts.

🌐 Deployment

Vercel (Recommended)

Push your code to GitHub
Import project in Vercel
Deploy with one click
Custom domain setup (optional)

Other Platforms

FaucetHub is a standard Next.js app and can be deployed to:

Netlify - Full Next.js support
Railway - Easy container deployment
AWS Amplify - Scalable hosting
Self-hosted - Docker or PM2

🔗 Ecosystem

FaucetHub is part of a broader Web3 development ecosystem:

🪙 MintLab

Generate ERC-20, ERC-721, and ERC-1155 tokens with no coding required. Deploy custom tokens instantly on Base and Ethereum networks.

📜 Smart Contract Templates

Browse and deploy production-ready smart contract templates. From DeFi to NFTs, find audited contracts for your next project.

🤝 Contributing

Contributions are welcome! Whether it's:

🐛 Bug reports
💡 Feature suggestions
📝 Documentation improvements
🚰 New faucet additions
🎨 UI/UX enhancements

How to Contribute

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Reporting Bugs

If you find a bug, please open an issue with:

Clear description of the problem
Steps to reproduce
Expected vs actual behavior
Screenshots (if applicable)
Browser and OS information

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

Base - For building an incredible L2 ecosystem
Ethereum - For the foundational blockchain infrastructure
Faucet Operators - For providing free testnet tokens to developers
Coinbase - For OnchainKit and Base support
Vercel - For seamless Next.js hosting

👤 Author

elpeef

🌐 Website: elpeef.com
🐙 GitHub: @mrbrightsides
💼 Portfolio: MintLab | Smart Contract Templates

💡 Support

If you find FaucetHub useful, consider:

⭐ Starring the repository
🐦 Sharing on Twitter/Farcaster
🔗 Adding to your bookmarks
💙 Building on Base

Built with 💙 for the Base ecosystem

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
LICENSE		LICENSE
README.md		README.md

License

mrbrightsides/faucethub

Folders and files

Latest commit

History

Repository files navigation