TheVent

Speak freely. Anonymously.

TheVent is an open-source anonymous social app where users can post feelings and thoughts, like posts, and reply to others.

Current Tech Stack

Layer	Technology
Frontend	Flutter + Material UI
Language	Dart
Backend Services	Firebase
Authentication	Firebase Authentication (Email/Password)
Database	Cloud Firestore
Media Storage	Firebase Storage
Navigation	Flutter Navigator (named routes + onGenerateRoute)
Image Picker	image_picker

Features

• Anonymous username-based login flow
• Create vents (posts), like vents, and reply
• Profile with optional profile picture
• Dark themed UI
• Android, iOS, and Web support from one codebase

Getting Started

1. Prerequisites

• Flutter SDK (3.x)
• Android Studio / Xcode (for mobile)
• A Firebase project

2. Clone and Install

git clone https://github.com/mclovin22117/theventapp
cd theventapp
flutter pub get

3. Firebase Setup

1. Create a Firebase project.
2. Enable Authentication:
   • Sign-in method: Email/Password
3. Create Firestore Database.
4. Create Firebase Storage bucket (if your region supports it).
5. Configure FlutterFire:

flutterfire configure

This generates lib/firebase_options.dart and updates platform config files.

4. Android Config

• Ensure android/app/google-services.json exists.
• The app already includes Google Services Gradle plugin setup.

5. Run

flutter run

To target a specific device:

flutter devices
flutter run -d <device_id>

Build

Android release APK:

flutter build apk --release

Web:

flutter build web

Important Notes

• If firebase_options.dart or google-services.json keys are rotated, rerun flutterfire configure and rebuild.
• Profile picture upload requires Firebase Storage to be available for your selected Firebase project region.

Project Structure

theventapp/
├── lib/
│   ├── main.dart
│   ├── firebase_options.dart
│   ├── models/
│   ├── screens/
│   └── services/
├── android/
├── ios/
├── web/
└── pubspec.yaml

Contributing

1. Fork the repository
2. Create a branch
3. Commit your changes
4. Push and open a pull request

Command to directly install release apk on USB debugging device

flutter build apk --release && adb install -r build/app/outputs/flutter-apk/app-release.apk

License

This project is licensed under the MIT License. See LICENSE.