Crypto Fantasy League

A Farcaster Mini App for daily fantasy sports with crypto integration. Draft memecoins, traders, and athletes for crypto events and real sports. Compete in daily fantasy leagues with USDC entry fees, big prize pools, and live leaderboards.

Features • Getting Started • Documentation • Contributing

Contact

Platform	Link
📱 Telegram	t.me/novustch
📲 WhatsApp	wa.me/14105015750
💬 Discord	discordapp.com/users/985432160498491473

Feel free to reach out for implementation assistance or integration support.

Overview

Crypto Fantasy League is a web-based mini application built for the Farcaster ecosystem. It runs seamlessly within Farcaster clients (such as Warpcast) on both mobile and desktop platforms, providing users with an engaging fantasy sports experience that combines traditional sports with cryptocurrency markets.

Features

• 🎮 Daily Fantasy Leagues - Compete in daily fantasy competitions
• 💰 Crypto Integration - USDC entry fees and prize pools
• 📊 Live Leaderboards - Real-time competition tracking
• 🎯 Multi-Asset Drafting - Draft memecoins, traders, and athletes
• 📱 Cross-Platform - Works on iOS, Android, and Web via Farcaster clients
• 🎨 Modern UI - Built with shadcn/ui and Tailwind CSS

Tech Stack

Frontend

• Framework: Next.js 15.5.4
• React: 19.2.0
• TypeScript: 5.x
• Styling: Tailwind CSS 4.x
• UI Components: shadcn/ui (Radix UI primitives)
• Form Handling: React Hook Form + Zod validation

Platform Integration

• Farcaster SDK: @farcaster/miniapp-sdk v0.1.10
• Deployment: Xnode (OpenxAI infrastructure)
• Build System: Nix Flakes

Prerequisites

• Node.js 18+ (or Bun)
• npm, yarn, or pnpm
• Git
• Nix (for Nix-based builds, optional)

Getting Started

Installation

1. Clone the repository

   git clone https://github.com/NovusTechLLC/Fanduel-Sports.git
   cd Fanduel-Sports

2. Install dependencies

   cd mini-app
   npm install

3. Set up environment variables Create a .env.local file in the mini-app directory (see .env.example for reference):

   NEXT_PUBLIC_URL=https://your-domain.com
   ACCOUNT_ASSOCIATION={"header":"","payload":"","signature":""}
   BASE_BUILDER={"allowedAddresses":[]}

Development

From the root directory (Nix build):

nix run

From the mini-app directory:

# Start development server
npm run dev

# Build for production
npm run build

# Start production server
npm run start

# Run linter
npm run lint

The development server will start at http://localhost:3000.

Project Structure

Fanduel-Sports/
├── .github/
│   └── workflows/            # GitHub Actions CI/CD workflows
├── mini-app/                 # Next.js application
│   ├── app/                  # Next.js app directory
│   │   ├── layout.tsx        # Root layout
│   │   ├── page.tsx          # Home page
│   │   └── .well-known/      # Farcaster manifest routes
│   ├── components/           # React components
│   │   ├── ui/               # shadcn/ui components
│   │   └── context/          # React context providers
│   ├── lib/                  # Utility functions and configs
│   └── public/               # Static assets
├── documentation/            # Project documentation
├── nix/                      # Nix package definitions
├── .editorconfig             # Editor configuration
├── .gitignore                # Git ignore rules
├── CHANGELOG.md              # Version history
├── CODE_OF_CONDUCT.md        # Community guidelines
├── CONTRIBUTING.md           # Contribution guidelines
├── flake.nix                 # Nix flake configuration
├── LICENSE                   # MIT License
├── README.md                 # This file
└── SECURITY.md               # Security policy

Farcaster Integration

This app is configured as a Farcaster Mini App, which means:

• It can be discovered and launched within Farcaster clients
• Users can authenticate using their Farcaster identity
• The app can send notifications to users
• Pages can be shared as rich cards in Farcaster feeds

The Farcaster manifest is served at /.well-known/farcaster.json and includes app metadata, icons, and configuration.

Deployment

This project is configured for deployment on Xnode (OpenxAI's infrastructure). The Nix-based build system ensures reproducible builds across different environments.

Build for Production

# Using Nix
nix build

# Using npm
cd mini-app
npm run build

Development Guidelines

• All component files should start with "use client"; directive
• Use existing shadcn/ui components when possible
• Follow TypeScript best practices with explicit type annotations
• Maintain the Farcaster metadata export on the home page
• Use Tailwind CSS for styling (configured in globals.css)

Contributing

We welcome contributions! Please read our Contributing Guide and Code of Conduct before submitting pull requests.

Key guidelines:

1. Code follows the existing style and conventions
2. All components include proper TypeScript types
3. The Farcaster manifest remains properly configured
4. UI components maintain consistency with the design system
5. All tests pass and linting checks succeed

See CONTRIBUTING.md for detailed information.

Documentation

• Farcaster Integration - Farcaster Mini App setup and configuration
• Next.js Guide - Next.js specific documentation
• shadcn/ui Components - UI component library documentation
• Tailwind CSS - Styling guidelines

Security

For security concerns, please see SECURITY.md. We take security seriously and appreciate responsible disclosure of vulnerabilities.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built using the OpenxAI Mini App Factory template
• UI components from shadcn/ui
• Powered by Farcaster and Xnode

---

For more information about Farcaster Mini Apps, see the documentation.