# Farcaster Mini App

Using tip.md within Warpcast for seamless social tipping, developer discovery, and dev stats sharing.

## Overview

The tip.md Farcaster mini app brings crypto tipping directly into your social feed on Warpcast. Discover developers based on their GitHub activity, share your coding stats, and tip creators without leaving the social platform.

## Getting Started

1. **Find the Mini App**: Search for "tip.md" in Warpcast or visit the tip.md profile
2. **Connect Your Account**: Link your GitHub profile to showcase your developer activity
3. **Start Tipping**: Discover and tip developers directly from their social profiles

## Key Features

### Developer Discovery
- **GitHub Activity Feed**: See real coding activity from developers in the Farcaster ecosystem
- **Smart Filtering**: Discover developers based on languages, project types, and contribution patterns
- **Social Context**: View tipping history and social interactions alongside code contributions

### Social Tipping
- **Direct Tipping**: Tip any Farcaster user with crypto (ETH, SOL, BTC Lightning, Base)
- **Cross-Platform**: Tips work whether the recipient has a tip.md account or not
- **Social Sharing**: Share successful tips and celebrate developer contributions

### Developer Stats Sharing
- **GitHub Integration**: Automatically sync and display your coding statistics
- **Achievement Sharing**: Share milestones, contributions, and project highlights
- **Community Building**: Connect with other developers based on shared interests and technologies

## Using the Mini App

### Tipping a Developer
1. Browse the developer feed or search for a specific user
2. Click on their profile to view their activity and tip.md stats
3. Select tip amount and cryptocurrency
4. Confirm the transaction in your wallet
5. Share your tip to celebrate their work

### Sharing Your Stats
1. Connect your GitHub account in the mini app settings
2. Your recent activity will automatically appear in your profile
3. Share interesting commits, releases, or project updates
4. Engage with the developer community through tips and comments

### Discovery Features
- **Trending Developers**: See who's actively coding and receiving community support
- **Language Filters**: Find developers working with your favorite technologies
- **Project Highlights**: Discover interesting open source projects and their maintainers

## Benefits

### For Tippers
- **Social Context**: See real developer activity before tipping
- **Community Building**: Connect with developers who share your interests
- **Easy Discovery**: Find new projects and developers to support

### For Recipients
- **Increased Visibility**: Showcase your work to the crypto-native Farcaster community
- **Social Proof**: Build reputation through code contributions and community tips
- **Direct Monetization**: Receive instant tips without leaving your social workflow

## Privacy and Security

- **Optional Integration**: GitHub connection is optional and can be disconnected anytime
- **Public Data Only**: Only public GitHub activity is displayed
- **Wallet Security**: All transactions require your wallet confirmation
- **Data Control**: Manage what stats and information you share publicly

## Getting Help

- **Mini App Support**: Use the feedback option within the mini app
- **Community**: Join discussions in the tip.md Farcaster channel
- **Documentation**: Visit tip.md/documentation for detailed guides
- **GitHub**: Report issues on the tip.md GitHub repository

## Tips for Success

### For New Users
- Complete your profile with GitHub connection for better discovery
- Start by exploring the developer feed to understand the community
- Begin with small tips to build relationships and trust

### For Active Developers
- Keep your GitHub activity public to maximize visibility
- Share interesting commits and project updates
- Engage with other developers' work through tips and comments
- Use the platform to discover collaboration opportunities

The Farcaster mini app transforms how developers connect, discover, and support each other's work within the social crypto ecosystem.