Velora

Velora is the ultimate platform for college and university students to discover who is free around them right now. Whether you're looking for a study buddy, want to grab a coffee, or just want to expand your campus network, Velora makes it easy to connect in real time.

🌟 Features

• Real-Time Availability Map: See exactly who is nearby and free to hang out.
• Intent-Based Connections: Let others know what you want to do (e.g., "Networking", "Coffee chat", "Study buddy").
• Secure Campus Authentication: Safe and restricted to verified students.
• Dynamic Profiles & Privacy: Full control over who sees you and when.
• Instant Messaging: Connect instantly with your new matches.

🚀 Getting Started

Prerequisites

Ensure you have the following installed:

• Flutter (>=3.3.0)
• Dart
• Xcode (for iOS)
• Android Studio (for Android)

Setup Instructions

1. Clone the repository

   git clone https://github.com/yourusername/campus-spark.git
   cd campus-spark

2. Configure Environment Variables The app uses .env files to manage sensitive API keys securely. Create a .env file in the root directory:

   touch .env

   Add your Supabase credentials to the .env file:

   SUPABASE_URL=your_supabase_project_url
   SUPABASE_ANON_KEY=your_supabase_anon_key

   (Note: The .env file is excluded from version control for security.)

3. Install Dependencies

   flutter pub get

4. Run the App

   flutter run

🛡 Security & Best Practices

• All API endpoints and Supabase configuration keys are hidden using the flutter_dotenv package.
• Ensure that you never commit your .env or Firebase google-services.json / GoogleService-Info.plist files.
• Role-Level Security (RLS) policies should be enforced on your Supabase backend to ensure user data remains secure.

📈 SEO & Discoverability

This application has been optimized for web deployments with correct Open Graph, Twitter cards, and Meta tags to ensure high visibility when sharing the web build.

📝 License

This project is licensed under the MIT License.