A modern Flutter platform bridging the gap between visionary entrepreneurs and forward-thinking investors.
Features • Demo • Getting Started • Architecture • Contributing
- About The Project
- Key Features
- Tech Stack
- Screenshots
- Getting Started
- Project Structure
- Supabase Configuration
- Dependencies
- Architecture
- Roadmap
- Contributing
- Author
- License
Shark Space (also known as VentureBridge) is a cross-platform mobile application inspired by global investment programs like Shark Tank. It creates an intelligent digital ecosystem where:
- 💼 Entrepreneurs can pitch their projects, showcase their vision, and reach serious investors.
- 💰 Investors can discover, evaluate, and connect with promising ventures aligned with their interests.
By combining a smart matching algorithm, real-time communication, and a trust-driven rating system, Shark Space removes friction from the investment journey — making the path from idea to funding faster, more transparent, and more efficient.
🎯 Mission: To democratize access to investment opportunities and empower the next generation of entrepreneurs across the region and beyond.
|
Tailored dashboards for Entrepreneurs and Investors, each with role-specific tools and workflows. Explore projects and investor profiles through clean, performant UI with detailed views and rich media. Mutual-interest matching system — when both sides show interest, a connection is automatically created. Instant messaging powered by Supabase Realtime, enabling seamless conversations between matched users. |
Build credibility and trust through a transparent feedback system between users. Powerful filters to discover the right projects or investors based on specific criteria. Upload avatars, manage pitch decks, and customize your professional presence. Email-based sign-up with confirmation, persistent sessions, and Row Level Security at the database layer. |
| Layer | Technology |
|---|---|
| Frontend | Flutter (Dart) |
| Backend | Supabase (BaaS) |
| Database | PostgreSQL |
| State Management | Riverpod |
| Navigation | GoRouter |
| Real-time | Supabase Realtime |
| Storage | Supabase Storage |
| Security | Row Level Security (RLS) |
Screenshots coming soon — stay tuned!
Follow these steps to get Shark Space running locally in just a few minutes.
- Flutter SDK (3.x or later)
- Dart SDK (3.x or later)
- A free Supabase account
- Android Studio / VS Code with Flutter extensions
git clone https://github.com/OsamaALHajj/Shark-Space.git
cd Shark-Space- Visit supabase.com → New Project
- Navigate to Settings → API
- Copy your:
- 🔗 Project URL
- 🔑 anon public key
Open lib/core/constants/supabase_constants.dart and update the two lines below:
static const String supabaseUrl = 'https://xxxx.supabase.co'; // ← your Project URL
static const String supabaseAnonKey = 'eyJ...'; // ← your anon key- Open Supabase Dashboard → SQL Editor → New query
- Paste the entire contents of
supabase_schema.sql - Click RUN ✅
flutter pub get
flutter run🎉 That's it! The app should now be running on your emulator or connected device.
lib/
├── main.dart # 🚪 Entry point + Supabase initialization
├── app.dart # 🎨 MaterialApp + Router setup
│
├── core/ # 🧠 Core utilities & shared services
│ ├── constants/
│ │ ├── supabase_constants.dart # 🔑 Supabase URL & AnonKey
│ │ └── app_constants.dart # App-wide constants
│ ├── supabase/
│ │ ├── supabase_service.dart # All DB operations
│ │ └── supabase_client_provider.dart
│ ├── router/
│ │ └── app_router.dart # Navigation + route guards
│ └── theme/
│ └── app_theme.dart # App theming
│
├── models/ # 📦 Data models (User, Project, Investor…)
│
├── providers/ # 🔄 Riverpod state management
│ ├── auth_provider.dart
│ ├── project_provider.dart
│ ├── investor_provider.dart
│ ├── match_provider.dart
│ ├── likes_provider.dart
│ ├── ratings_provider.dart
│ ├── search_provider.dart
│ └── messaging_provider.dart # ⚡ Realtime chat
│
├── features/ # 🧩 Feature-based modules
│ ├── auth/ # Login, Register, Splash
│ ├── dashboard/ # Entrepreneur & Investor dashboards
│ ├── browse/ # Projects, Investors, Detail, Profile
│ ├── messaging/ # Conversations & Real-time Chat
│ ├── search/ # Advanced search
│ └── likes/ # My Likes
│
└── widgets/ # 🧱 Reusable UI components
├── cards/ # ProjectCard, InvestorCard, MatchCard
└── common/ # AppDrawer, RatingDisplay, …
| Feature | Purpose |
|---|---|
| Auth | Sign up / Sign in with email + automatic session persistence |
| Database | All application data tables |
| Row Level Security | Per-user data isolation and protection |
| Realtime | Instant messaging in the chat module |
| Storage | Profile pictures and pitch deck file uploads |
In Authentication → URL Configuration, add:
io.supabase.venturebridge://login-callback
In Storage, create the following buckets:
| Bucket | Visibility | Purpose |
|---|---|---|
avatars |
🌍 Public | User profile pictures |
pitch-decks |
🔒 Private | Confidential pitch documents |
dependencies:
supabase_flutter: ^2.5.6 # Complete backend solution
flutter_riverpod: ^2.5.1 # State management
go_router: ^14.2.0 # Declarative navigation
equatable: ^2.0.5 # Value equality for models
flutter_rating_bar: ^4.0.1 # Star rating widget
cached_network_image: ^3.3.1 # Image caching & loading
intl: ^0.19.0 # Date formatting & i18n
image_picker: ^1.1.2 # Image selection & uploadShark Space follows a clean, feature-based architecture with strict separation of concerns:
┌─────────────────────────────────────────────────────────┐
│ Presentation Layer │
│ (Features, Widgets, Screens) │
└──────────────────────────┬──────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────┐
│ State Management Layer │
│ (Riverpod Providers) │
└──────────────────────────┬──────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────┐
│ Service Layer │
│ (Supabase Service & Models) │
└──────────────────────────┬──────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────┐
│ Backend (Supabase) │
│ Auth • Database • Realtime • Storage │
└─────────────────────────────────────────────────────────┘
Core Principles:
- 🧩 Modular — Each feature is self-contained and independently maintainable.
- 🔄 Reactive — Riverpod ensures predictable, reactive state across the app.
- 🔐 Secure by Design — RLS policies enforce data security at the database level.
- 📈 Scalable — Easy to add new features without touching existing code.
- 🧪 Testable — Clear separation between UI, state, and business logic.
- User authentication & dual role system
- Project & investor browsing
- Likes & matching system
- Real-time chat
- Ratings system
- Push notifications
- Video pitch uploads
- AI-powered project recommendations
- Multi-language support (Arabic / English)
- Investment tracking dashboard
- Web version
See open issues for a full list of proposed features and known issues.
Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Osama AL Hajj & KoKO
Crafted with passion and clean code.
Distributed under the MIT License. See LICENSE for more information.