🎙️ Yapp — Voice-First Social Media

Say what you actually think. Nobody knows it's you.

Overview

Yapp is a voice-first social media app built with Flutter. It focuses on audio-based posts, discovery, and engagement using Supabase for backend services.

Key Features

• Voice recording and playback
• Supabase authentication, database, storage, and realtime updates
• Feed, explore, profile, and notification screens
• State management with Riverpod
• Navigation with GoRouter

Tech Stack

• Flutter
• Supabase
• Riverpod
• GoRouter
• just_audio
• record
• ffmpeg_kit

Project Structure

lib/
├── core/
│   ├── constants/     # Colors, app constants, text styles
│   ├── router/        # GoRouter configuration
│   ├── theme/         # App theme
│   └── utils/         # Helper utilities
├── features/
│   ├── auth/          # Splash, onboarding, login
│   ├── feed/          # Home feed
│   ├── record/        # Voice recording and filters
│   ├── explore/       # Trending and circles
│   ├── profile/       # User profile
│   └── notifications/ # Alerts and updates
└── shared/
    ├── models/        # Data models
    └── widgets/       # Shared UI components

Prerequisites

• Flutter SDK installed
• Git installed
• A Supabase project with URL and anon key

Install from Git

1. Clone the repository:

git clone https://github.com/<your-username>/yapp.git
cd yapp

2. Install dependencies:

flutter pub get

3. Configure Supabase:

• Open lib/core/constants/app_constants.dart
• Add your Supabase URL and anon key

4. Run the app:

flutter run

Install from a local copy

If you already have the source code locally, run:

cd /path/to/yapp
flutter pub get

Then configure Supabase and run the app.

Configure Supabase

1. Create a project at https://supabase.com
2. Copy the project URL and anon key
3. Paste them into lib/core/constants/app_constants.dart

Run the App

flutter run

Notes

• This repo is a standalone Flutter app, not a published package.
• Make sure the asset folders at assets/images/, assets/animations/, and assets/audio/ are present.