Fannu Foshi

Launch. Fund. Discover. Acquire.

A unified platform for entrepreneurs, investors, and creators. Launch products, crowdfund ideas, discover startups, and acquire businesses—all in one place.

👯‍♂️ Team

• Team Name: WaveMinds
• Project Title: Fannu Foshi

🌟 Overview

Fannu Foshi is a comprehensive startup ecosystem platform that brings together four key pillars of entrepreneurship:

• 🚀 Launchpad - Showcase and discover innovative product launches
• 🤝 Crowdfunding - Back innovative projects and bring ideas to life
• 📈 Startups - Discover and track promising startups by traction
• 💼 Marketplace - Buy and sell profitable digital businesses

Whether you're an entrepreneur launching your next product, a creator seeking funding, an investor looking for opportunities, or a business owner ready to exit, Fannu Foshi provides the tools and community you need.

✨ Key Features

🚀 Product Launchpad

• Submit and showcase your products to a community of makers and early adopters
• Get upvotes, views, and feedback on your launches
• Discover trending products across multiple categories
• Track your product's performance with detailed analytics

🤝 Crowdfunding Platform

• Create and manage crowdfunding campaigns
• Set funding goals and track progress in real-time
• Browse featured campaigns and staff picks
• Support innovative projects and ideas

📈 Startup Discovery

• Browse startups ranked by traction and growth metrics
• View detailed startup profiles with key metrics
• Track top-performing startups weekly
• Connect with founders and co-founders

💼 Business Marketplace

• List your business for acquisition with verified metrics
• Browse profitable businesses ready for new owners
• Filter by business type, revenue, and asking price
• Complete transactions with transparent pricing

👤 Social & Community

• User profiles with followers and following
• Activity feeds and notifications
• Engagement metrics (views, upvotes, sparks)
• Community interactions and networking

📊 Personal Dashboard

• Track all your projects, campaigns, startups, and listings
• View comprehensive statistics and analytics
• Manage upcoming events and deadlines
• Quick actions to launch new initiatives

🛠️ Dependencies

The project depends on these two systems for back-end and blockchain integration.

• Back-end API: Fannu Foshi API
• Blockchain API: Fannu Blockchain API

🛠️ Tech Stack

• Framework: Next.js 16 with App Router
• Language: TypeScript
• UI Library: React 19
• Styling: Tailwind CSS with custom theme
• UI Components: Radix UI primitives
• Animations: Framer Motion
• Authentication: Firebase Authentication
• Database: Firebase Admin SDK
• Icons: Lucide React
• Forms: React Hook Form with Zod
• PWA: Progressive Web App support with service workers

🚀 Getting Started

Prerequisites

• Node.js 18+ and npm/pnpm
• Firebase project with Authentication enabled
• Firebase Admin SDK credentials

Installation

1. Clone the repository:

git clone <repository-url>
cd startup-hack25

2. Install dependencies:

pnpm install

3. Set up environment variables:

# Create a .env.local file with your Firebase configuration
NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_auth_domain
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
# ... other Firebase config

4. Add your Firebase Admin service account key as serviceAccountKey.json in the root directory.

5. Run the development server:

pnpm dev

6. Open http://localhost:3001 in your browser.

📁 Project Structure

startup-hack25/
├── app/                    # Next.js app directory
│   ├── api/               # API routes
│   ├── dashboard/         # User dashboard
│   ├── launchpad/         # Product launchpad
│   ├── crowdfunding/      # Crowdfunding campaigns
│   ├── startups/          # Startup discovery
│   ├── marketplace/       # Business marketplace
│   ├── submit/            # Submission forms
│   └── data/              # Data layer
├── components/            # React components
│   ├── animated/         # Animated UI components
│   ├── layout/           # Layout components
│   ├── pwa/              # PWA components
│   └── ui/               # Reusable UI primitives
├── lib/                   # Utilities and helpers
│   ├── hooks/            # Custom React hooks
│   └── ...               # Auth, API, formatting utilities
└── public/               # Static assets

🔐 Authentication

The app uses Firebase Authentication with a custom backend sync system:

• Client-side: Firebase Auth handles sign-in/sign-up
• Backend: Custom API syncs users to database
• Cookies: Stores auth tokens and user IDs for quick access
• Custom Claims: Firebase tokens include database user IDs

See docs/authentication_flow.md for detailed documentation.

📱 Progressive Web App

Fannu Foshi is a PWA that can be installed on mobile and desktop devices:

• Offline support with service workers
• Install prompts for supported browsers
• App-like experience with standalone display mode
• Fast loading and smooth animations

🎨 Design System

The platform uses a cohesive design system with:

• Theme Colors: Sky (Launchpad), Purple (Crowdfunding), Indigo (Startups), Orange (Marketplace)
• Dark Mode: Full dark mode support with theme switching
• Responsive Design: Mobile-first approach with breakpoints
• Animations: Smooth transitions and micro-interactions
• Typography: Custom font stack (DM Sans, Space Mono, Source Serif 4)

📝 Available Scripts

• pnpm dev - Start development server on port 3001
• pnpm build - Build for production
• pnpm start - Start production server
• pnpm lint - Run ESLint

🤝 Contributing

This project is part of the Youth Hack Startup Hack 2025. Contributions and feedback are welcome!

📄 License

This project is private and proprietary.

---

Built with ❤️ for the startup community