Your Campus Marketplace
Connecting campus hustlers with customers through trust, convenience, and innovation
- 1. Executive Summary
- 2. Product Overview
- 3. Features & Requirements
- 4. Technical Architecture
- 5. UI/UX Requirements
- 6. Development Plan
- 7. Testing & Deployment
- 8. Risks & Mitigation
- 9. Success Metrics
- 10. Team & Resources
Transform the informal peer-to-peer service economy at Meru University into a structured, trustworthy, and engaging marketplace where students can discover services, build reputations, and connect safely.
Students at Meru University offer diverse services—laundry, salon, tutoring, graphic design, photography, food, tailoring, and more. Today, this vibrant economy operates entirely through:
- WhatsApp groups: Chaotic, unsearchable, messages get buried
- Word of mouth: Limits provider reach to small circles
- No trust layer: Customers can't assess quality before committing
- Privacy risks: Students must share personal phone numbers
- No organization: Past transactions and conversations are lost
HustleHub is a native Android application that organizes this economy through:
| Feature | Benefit |
|---|---|
| 🔍 AI-Powered Search | "braids near Gate B under 500" → instant matches |
| 💬 In-App Messaging | Chat without sharing phone numbers |
| 🗺️ Campus Map | See available providers in real-time |
| ⭐ Reputation System | Ratings, reviews, and Hustle Score |
| 🎓 Student-Only Access | Verified via @must.ac.ke email |
| 📸 Service Portfolios | Showcase work with before/after images |
Connect, don't control. Providers set their own prices, schedules, and terms. We handle discovery, communication, and trust.
| Problem | Impact | HustleHub Solution |
|---|---|---|
| Services shared via WhatsApp groups | Impossible to search, messages buried | Categorized discovery feed + AI search |
| Word of mouth only | Limited provider reach | Campus-wide visibility for all providers |
| No reputation system | Cannot assess quality or reliability | Ratings, reviews, and Hustle Score |
| No dedicated platform | General marketplaces ignore campus niche | Campus-specific features (map, student verification) |
| Privacy risk | Must share personal phone numbers | In-app messaging, no number sharing required |
| No organization | Lost transactions & conversations | Persistent chat history, profile portfolios |
Students offering services (laundry, salon, tutoring, design, food, etc.)
- Demographics: Age 18–26, tech-savvy smartphone users
- Characteristics: Budget-conscious, entrepreneurial mindset
- Motivations:
- Earn income while studying
- Build a client base on campus
- Gain visibility beyond immediate friends
- Establish reputation for future opportunities
Students seeking affordable, convenient services from peers
- Demographics: Age 18–26, mobile-first generation
- Characteristics: Value trust and convenience
- Motivations:
- Find reliable providers quickly
- Avoid scams and low-quality services
- Access affordable campus-specific services
- Support fellow students
University officials interested in student welfare
- Use Case: Aggregate data for entrepreneurship programs
- Privacy: Only anonymized, aggregate statistics shared
✅ Professional presence without website costs ✅ Campus-wide discovery beyond friend circles ✅ Build trust through ratings and reviews ✅ Safe communication without sharing personal contact ✅ Portfolio showcase to attract quality clients
✅ Easy discovery of services they need ✅ Quality assurance through ratings and reviews ✅ Safe transactions with verified students only ✅ Convenient communication all in one app ✅ Location-based search to find nearby providers
- Student email signup (@must.ac.ke domain)
- Email OTP verification (6-digit code)
- Google Sign-In (restricted to @must.ac.ke)
- Profile creation: name, photo, course, year, residence
- Role selection: Provider / Customer / Both
User Story: "As a student, I want to sign up with my university email so that only verified students can access the platform."
- Create/edit service listings — title, category, description, price range, tags
- Portfolio upload (multiple images, before/after)
- Availability toggle: Available / Busy / Offline
- Service categories: Salon & Beauty, Laundry, Tutoring, Food & Catering, Tech Services, Fashion & Tailoring, Photography & Videography, Graphic Design, Other
User Story: "As a provider, I want to create a service listing with photos and pricing so customers can find me."
- Browse by category with horizontal chips
- Text search with instant results
- AI-powered natural language search — "braids near Gate B under 500"
- Filters: Category, Rating, Availability, Distance, Price range
- Sort options: Relevance, Highest rated, Newest, Nearest
User Story: "As a customer, I want to search using natural language so I can find the best match quickly."
- 1-on-1 real-time chat (text, timestamps, read receipts)
- Voice notes (record/playback with waveform, max 2 min)
- Image sharing (gallery, camera, fullscreen preview)
- Service Request Cards (auto-generated from listing)
- Location sharing (one-tap, map preview in chat)
- Quick replies for providers ("Available now", "Busy, try later", etc.)
- Presence indicators (online/offline, typing, read receipts)
- Unread badges on chat list
User Story: "As a user, I want to send voice notes so I can communicate faster than typing."
- Google Maps integration (Meru University campus, custom styling)
- Provider location pins (color-coded by category, clustered)
- User location (blue dot)
- Filter pins by category
- Tap pin → bottom sheet preview (name, photo, rating, distance, quick actions)
- Distance calculation and display
User Story: "As a customer, I want to see available providers on a map so I can find someone nearby."
- 1–5 star rating with optional comment
- Anonymous or named review
- Auto-prompt after service completion
- Reviews displayed on profile (newest first, average rating badge)
- Report inappropriate reviews
User Story: "As a customer, I want to rate and review a provider so others can benefit from my experience."
- Push notifications via FCM (new message, review, inquiry)
- In-app notification center (activity feed, mark as read)
- Deep linking (tap notification → relevant screen)
- Notification preferences (toggle types, quiet hours)
User Story: "As a provider, I want to receive notifications when someone contacts me so I don't miss opportunities."
| Feature | Phase | Description | Priority |
|---|---|---|---|
| 📞 Voice/Video Calls | Phase 2 | WebRTC peer-to-peer calling in-app | High |
| 💰 M-Pesa Integration | Phase 2 | Send/request payments directly in chat | High |
| 🏆 Hustle Score & Badges | Phase 2 | Gamified reputation: Top Rated, Fast Responder, etc. | Medium |
| 📊 Leaderboards | Phase 2 | Weekly/monthly top providers per category | Medium |
| 🔄 Service Swap (Barter) | Phase 3 | Match providers willing to trade services | Low |
| 🚨 Emergency Requests | Phase 3 | Broadcast urgent needs to nearby providers | Medium |
| 🏫 Multi-Campus Support | Phase 3 | Expand to Kenyatta, UoN, etc. | High |
| 📈 Provider Analytics | Phase 3 | Dashboard: views, bookings, ratings trends | Medium |
| 🌐 Admin Panel (Web) | Phase 4 | Content moderation, user management | High |
| 🎓 Skill Verification | Phase 4 | Verify tutors, designers with credentials | Low |
| Layer | Technology | Purpose |
|---|---|---|
| Language | Kotlin 2.x | Primary development language |
| UI Framework | Jetpack Compose (Material 3 Expressive) | Declarative, modern UI toolkit |
| Architecture | MVVM + Clean Architecture (feature-based) | Separation of concerns, testability |
| Navigation | Navigation 3 (androidx.navigation3) |
Type-safe, serializable NavKey-based routing |
| Dependency Injection | Hilt (Dagger) | Compile-time DI |
| Networking | Retrofit 3.0.0 + OkHttp 5.x | REST API client with interceptors |
| Real-time Chat | OkHttp WebSocket client | STOMP over WebSocket → Spring Boot |
| Local Database | Room 2.8.4 + DataStore Preferences | Offline cache, user preferences |
| Image Loading | Coil 2.7.0 | Compose-native, coroutine-based |
| State Management | Kotlin Flow + StateFlow | Reactive, lifecycle-aware streams |
| Code Quality | ktlint + detekt | Linting and static analysis |
| Service | Technology | Purpose |
|---|---|---|
| REST API | Spring Boot (Kotlin) | All data operations (/api/v1/) |
| Real-time | Spring WebSocket / STOMP | Live chat messages and presence |
| File Storage | Backend-managed (GCS/S3) | Photos, portfolios, voice notes uploaded via /api/v1/media/upload |
| Authentication | Firebase Auth | Email/password + Google Sign-In (ID tokens) |
| Push Notifications | Firebase Cloud Messaging (FCM) | Push alerts via token sent to backend |
| AI Search | Gemini API (called from backend) | Natural language service matching |
| Crash Reporting | Firebase Crashlytics | Android client crash analytics |
⚠️ There is no Firestore, no Firebase Realtime Database, and no Supabase. All data is stored and served by the Spring Boot backend. Firebase is used exclusively for Auth and FCM.
| Service | Purpose |
|---|---|
| Gemini API | Natural language search (invoked server-side) |
| Google Maps SDK | Campus map and location services (Android client) |
graph TB
subgraph "Android Client"
UI[Jetpack Compose UI]
VM[ViewModels]
UC[Use Cases]
REPO[Repository Impls]
ROOM[Room Cache]
WS[WebSocket Client]
end
subgraph "Firebase (Auth + FCM only)"
FA[Firebase Auth]
FCM[Cloud Messaging]
end
subgraph "Spring Boot Backend"
REST[REST API /api/v1/]
WSRV[WebSocket Server]
AI[Gemini AI Service]
DB[(Database)]
FS[File Storage]
end
UI --> VM --> UC --> REPO
REPO --> ROOM
REPO --> REST
REPO --> WS
WS --> WSRV
REST --> DB
REST --> FS
REST --> AI
FA -->|ID Token| REPO
REST -->|FCM Push| FCM
style UI fill:#6C5CE7,color:#fff
style VM fill:#6C5CE7,color:#fff
style REST fill:#00B894,color:#fff
style WSRV fill:#00B894,color:#fff
must.kdroiders.hustlehub/
├── 📁 activities/ # Single entry point
│ └── MainActivity.kt
├── 📁 appHilt/
│ └── HustleHubApp.kt # @HiltAndroidApp, Firebase init, FCM channels
├── 📁 core/
│ ├── 📁 api/
│ │ ├── ApiClient.kt # Retrofit + OkHttp singleton
│ │ ├── AuthInterceptor.kt # Attaches Firebase ID token to every request
│ │ ├── TokenAuthenticator.kt # Auto-refreshes token on 401
│ │ └── ApiResponse.kt # Sealed: Success / HttpError / NetworkError
│ ├── 📁 ui/ # Shared composables (design system)
│ ├── 📁 theme/
│ └── 📁 util/
├── 📁 di/
│ ├── AppModule.kt
│ ├── NetworkModule.kt # Retrofit, OkHttp, ApiService instances
│ ├── FirebaseModule.kt # FirebaseAuth, FirebaseMessaging
│ └── RepositoryModule.kt
├── 📁 navigation/
├── 📁 datastore/
│ └── UserPreferences.kt
├── 📁 local/ # Room offline cache
│ ├── HustleDatabase.kt
│ ├── dao/ (ServiceDao, MessageDao, ConversationDao)
│ └── entity/ (CachedService, CachedMessage, CachedConversation)
└── 📁 feature/
├── 📁 auth/ (data / domain / presentation)
├── 📁 splash/
├── 📁 onboarding/
├── 📁 profile/ (data / domain / presentation)
├── 📁 services/ (data / domain / presentation)
├── 📁 discovery/ (data / domain / presentation)
├── 📁 chat/ (data: REST + WebSocket / domain / presentation)
├── 📁 map/ (data / domain / presentation)
├── 📁 reviews/ (data / domain / presentation)
├── 📁 notifications/ (HustleFcmService + presentation)
└── 📁 media/ (MediaApiService, MediaUploadRepository)
All data is owned by the Spring Boot backend. The Android client mirrors these as Kotlin data classes.
data class UserDto(
val userId: String,
val name: String,
val email: String,
val studentId: String,
val campus: String,
val course: String,
val yearOfStudy: Int,
val hostel: String,
val role: String, // "PROVIDER" | "CUSTOMER" | "BOTH"
val profilePhotoUrl: String,
val bio: String,
val hustleScore: Float,
val badges: List<String>,
val isVerified: Boolean,
val isOnline: Boolean,
val createdAt: String,
val lastSeen: String
)data class ServiceDto(
val serviceId: String,
val providerId: String,
val providerName: String,
val providerPhotoUrl: String,
val title: String,
val category: String,
val description: String,
val minPrice: Int,
val maxPrice: Int,
val priceRange: String,
val portfolioImages: List<String>,
val availability: String, // "AVAILABLE" | "BUSY" | "OFFLINE"
val averageRating: Float,
val reviewCount: Int,
val tags: List<String>,
val location: LocationDto,
val openToBarter: Boolean,
val createdAt: String
)data class MessageDto(
val messageId: String,
val conversationId: String,
val senderId: String,
val type: String, // "TEXT" | "VOICE" | "IMAGE" | "LOCATION" | "SERVICE_CARD"
val content: String?,
val mediaUrl: String?,
val thumbnailUrl: String?,
val metadata: Map<String, Any>?,
val timestamp: String,
val deliveredAt: String?,
val readAt: String?
)@Entity(tableName = "cached_services")
data class CachedService(
@PrimaryKey val id: String,
val providerId: String,
val title: String,
val category: String,
val priceRange: String,
val averageRating: Float,
val reviewCount: Int,
val availability: String,
val portfolioJson: String, // JSON array of image URLs
val fetchedAt: Long // For cache expiry (10 min TTL)
)
@Entity(tableName = "cached_messages")
data class CachedMessage(
@PrimaryKey val id: String,
val conversationId: String,
val senderId: String,
val type: String,
val content: String?,
val mediaUrl: String?,
val timestamp: Long,
val isSynced: Boolean = false
)
@Entity(tableName = "cached_conversations")
data class CachedConversation(
@PrimaryKey val id: String,
val otherUserId: String,
val otherUserName: String,
val otherUserPhotoUrl: String,
val lastMessage: String,
val lastMessageAt: Long,
val unreadCount: Int
)All endpoints under /api/v1/. Authentication via Authorization: Bearer <firebase_id_token>.
| Group | Endpoints |
|---|---|
| Auth | POST /auth/register, PUT /users/fcm-token |
| Users | GET /users/me, PUT /users/me, GET /users/{id} |
| Services | GET/POST /services, GET/PUT/DELETE /services/{id}, PUT /services/{id}/availability |
| Discovery | GET /discovery/services, GET /discovery/search, POST /discovery/ai-search, GET /discovery/map-pins |
| Conversations | GET /conversations, POST /conversations, GET /conversations/{id}/messages, PUT /conversations/{id}/read |
| Reviews | POST /reviews, GET /services/{id}/reviews, POST /reviews/{id}/report |
| Media | POST /media/upload, POST /media/upload/voice |
| Notifications | GET /notifications, PUT /notifications/{id}/read, PUT /notifications/read-all |
Real-time Chat: WebSocket at ws://host/ws?token=<firebase_id_token>
- Send:
/app/chat.send - Subscribe:
/topic/conversation/{conversationId}
See API.md for full request/response schemas.
- 🎯 Clarity: Every screen has one primary action
- ⚡ Speed: Optimistic UI updates, perceived performance < 100ms
- 🔒 Safety: Visual indicators for verified users, safe interactions
- 🎨 Consistency: Unified design language across all screens
- 📱 Mobile-First: Thumb-friendly zones, one-handed operation
- ♿ Accessibility: Content descriptions, sufficient contrast ratios
| # | Screen | Description | Priority |
|---|---|---|---|
| 1 | Splash | App logo with fade-in animation | MVP |
| 2 | Onboarding | 3 swipeable slides: Welcome, Features, Get Started | MVP |
| 3 | Sign Up | Email, password, student verification | MVP |
| 4 | Login | Email/password + Google sign-in | MVP |
| 5 | Email Verification | 6-digit OTP input | MVP |
| 6 | Profile Setup | Name, photo, course, year, role | MVP |
| 7 | Home / Discovery | Category chips, service cards, search bar | MVP |
| 8 | Search Results | Filtered/sorted service listings | MVP |
| 9 | AI Search | Natural language input + match results | MVP |
| 10 | Service Detail | Full provider profile, portfolio gallery, reviews | MVP |
| 11 | Chat List | All conversations with previews | MVP |
| 12 | Chat Screen | Messages, voice notes, images, service cards | MVP |
| 13 | Campus Map | Map with provider pins, filters | MVP |
| 14 | Create/Edit Service | Form to create/update service listing | MVP |
| 15 | My Profile | View/edit own profile and services | MVP |
| 16 | Write Review | Star rating + comment | MVP |
| 17 | Notifications | Activity feed | MVP |
| 18 | Settings | Account, privacy, help | MVP |
// HustleHub Dark Palette
val HustlePrimary = Color(0xFF7C4DFF) // Vibrant purple
val HustlePrimaryVariant = Color(0xFF9C7CFF) // Lighter purple
val HustleTertiary = Color(0xFF6C63FF) // Indigo accent
val HustleBackground = Color(0xFF0D0D1A) // Deep navy
val HustleSurface = Color(0xFF1A1A2E) // Card surface
val HustleActiveGreen = Color(0xFF4CAF50) // Online / available
val HustleWarningAmber = Color(0xFFFFB300) // Busy / warning
val HustleError = Color(0xFFCF6679) // Error statesobject Spacing {
val xs = 4.dp // Tight spacing
val sm = 8.dp // Small gaps
val md = 12.dp // Default item spacing
val lg = 16.dp // Section spacing
val xl = 24.dp // Screen padding
val xxl = 32.dp // Large sections
val xxxl = 48.dp // Hero sections
}Corner Radius: Small 8dp · Medium 12dp · Large 16dp · Extra Large 24dp
┌──────────────────────────────────┐
│ 🔍 Search services... 🔔 │
├──────────────────────────────────┤
│ [All] [Salon] [Laundry] [Food] │ ← Horizontal chips
├──────────────────────────────────┤
│ ┌──────────┐ ┌──────────┐ │
│ │ 📷 │ │ 📷 │ │
│ │ Jane K. │ │ Mike O. │ │
│ │ Braiding │ │ Laundry │ │
│ │ ⭐ 4.8 │ │ ⭐ 4.5 │ │
│ │ KSh 300+ │ │ KSh 200+ │ │
│ │ 🟢 Avail │ │ 🔴 Busy │ │
│ └──────────┘ └──────────┘ │
├──────────────────────────────────┤
│ 🏠 🔍 🗺️ 💬 👤 │
└──────────────────────────────────┘
┌──────────────────────────────────┐
│ ← Jane Kamau 🟢 Online │
├──────────────────────────────────┤
│ ┌──────────────────────┐ │
│ │ SERVICE REQUEST │ │
│ │ Braiding - KSh 500 │ │
│ │ [View Service] │ │
│ └──────────────────────┘ │
│ Hi! I'd like to │
│ book for Saturday●● │
│ Sure! What style do you want?●● │
│ [📷 Photo] │
│ 🎤 0:12 seconds │
│ 📍 Meet at Hostel B │
├──────────────────────────────────┤
│ [📷] [🎤] [📍] Type message... │
└──────────────────────────────────┘
Duration: 12 weeks (3 months) Sprint Length: 2 weeks · Total Sprints: 6
- Project setup, Hilt, Compose, Navigation 3, Firebase Auth
- Design system, shared composables, Splash, Onboarding
- Sign Up / Login screens, Profile Setup
NetworkModule(Retrofit + AuthInterceptor),FirebaseModule
ServiceApiService,DiscoveryApiService(Retrofit)- Create/Edit Service screen, portfolio upload via
MediaApiService - Home discovery feed, text search, filters
- AI Search screen →
POST /api/v1/discovery/ai-search
ConversationApiService(REST history),ChatWebSocketService- Chat List screen, Chat Screen with all message types
- Voice recording (MediaRecorder), voice playback (ExoPlayer)
- Image sharing, location sharing, service cards
- FCM push notifications
- Google Maps SDK, map pins from
GET /api/v1/discovery/map-pins - User location, category filters, bottom sheet preview
- Write Review screen, review display on provider profile
HustleFcmService(deep linking from notifications)- In-app notification center, preferences screen
- Settings screen, block/report, edit profile, dark mode
- Animations, loading/error/empty states, image compression
- Unit + UI tests, Maestro E2E flows
- Beta distribution (Firebase App Distribution → 20+ testers)
- Play Store listing preparation
| Week | Milestone |
|---|---|
| 2 | Auth complete (sign up → profile setup → home) |
| 4 | Discovery live (services browsable, AI search working) |
| 6 | Chat active (real-time messages, voice, images) |
| 8 | Map & reviews functional |
| 10 | All MVP features implemented |
| 12 | Beta launch to 20+ testers |
Framework: JUnit 5 + MockK · Coverage Target: 70%+ (domain + data layers)
class CreateServiceUseCaseTest {
@Test
fun `create service with valid data returns success`() = runTest {
val fakeRepo = FakeServiceRepository()
val useCase = CreateServiceUseCase(fakeRepo)
val result = useCase(validServiceData)
assertTrue(result is Result.Success)
}
}Framework: Compose Testing · Focus: auth flows, chat, search, map interactions
Approach: MockWebServer (OkHttp) for Retrofit calls, Firebase Auth emulator for sign-in.
# Firebase Auth emulator only (no Firestore/RTDB needed)
firebase emulators:start --only auth
./gradlew connectedAndroidTestFramework: Maestro
# maestro/signup-to-chat.yaml
appId: must.kdroiders.hustlehub
---
- launchApp
- tapOn: "Sign Up"
- inputText: "test@must.ac.ke"
- tapOn: "Continue"
- assertVisible: "Profile Setup"
- assertVisible: "Discover Services"- All critical user flows tested on physical devices
- App tested on API levels 26, 30, 34
- Dark mode tested across all screens
- Offline mode: messages queue (Room), services cache
- Poor network: timeouts, retries, error states
- Accessibility: TalkBack navigation works
- Cold start < 2 seconds
- Message send/receive latency < 200ms
- APK size < 50 MB
Code Push → GitHub Actions → Build & Test → APK/AAB
→ Firebase App Distribution (beta) → Play Store (staged rollout)
- Target SDK: 36 (Android 15) · Min SDK: 26 (Android 8.0)
- App Size: < 50 MB
- Permissions: Camera, Microphone, Location, Notifications, Internet
- Privacy Policy: Required (hosted URL)
| Risk | Severity | Mitigation |
|---|---|---|
| Low initial adoption | 🔴 Critical | Provider-first launch; seed with 20+ listings before marketing |
| WhatsApp preference | 🟡 Medium | Emphasize unique features: organized chats, no number sharing, reputation |
| Safety/harassment | 🔴 Critical | Block/report features, student verification, content moderation |
| Backend downtime | 🟡 Medium | Offline-first Room cache; graceful error states |
| AI search inaccuracy | 🟡 Medium | Fallback to keyword search; user feedback loop |
| Scope creep | 🟡 Medium | Strict sprint scope; defer Phase 2+ features |
| Poor campus internet | 🟢 Low | Offline-first: Room cache, message queue, image compression |
| Play Store rejection | 🟡 Medium | Follow Play policies, prepare privacy policy early |
| Metric | Target (3 Months) |
|---|---|
| Total Registered Users | 500+ |
| Active Providers | 100+ |
| Services Listed | 200+ |
| Conversations Initiated | 1,000+ |
| Messages Sent | 10,000+ |
| Daily Active Users (DAU) | 150+ (30%) |
| Monthly Active Users (MAU) | 300+ (60%) |
| Day 7 Retention | 40%+ |
| Average Provider Rating | 4.0+ ⭐ |
| Crash-Free Rate | 99%+ |
| App Store Rating | 4.2+ ⭐ |
Solo Developer — Android app development, backend coordination, UI/UX implementation, testing, deployment.
Recommended Schedule: 6 hours/day, 6 days/week (Monday–Saturday development, Sunday rest + planning).
| Category | Resource |
|---|---|
| Design | Material Design 3, Material Icons, unDraw (illustrations), Unsplash |
| Learning | Jetpack Compose Docs, Firebase Android Docs, Philipp Lackner YouTube |
| Tools | Android Studio Ladybug, GitHub, Figma (free tier), Discord (beta feedback) |
| Item | Monthly | Annual | Notes |
|---|---|---|---|
| Backend hosting (VPS/Cloud Run) | $10–20 | $120–240 | Spring Boot app + DB |
| Google Maps API | $0 | $0 | Free: 28,000 map loads/month |
| Gemini API (server-side) | $5 | $60 | ~1,000 AI searches/month |
| Firebase (Auth + FCM only) | $0 | $0 | Free tier more than sufficient |
| Play Store | — | $25 | One-time developer fee |
| Domain (privacy policy) | $1 | $12 | Optional |
| Total | ~$16–26 | ~$217–337 |
Given the student demographic, HustleHub employs a "Freemium" Model to ensure rapid adoption while sustaining server storage costs.
- Total Consumers (Buyers): ~5,000 students
- Total Providers (Sellers): ~1,000 students
All images are compressed client-side to ~150KB - 300KB via Android ImageCompressor before uploading.
| Feature | Free Tier (Starter) | HustleHub Pro (Power Seller) |
|---|---|---|
| Cost | Free forever | ~150 KES / month (M-Pesa) |
| Target Users | Casual providers (~800 users) | Top-earning providers (~200 users) |
| Service Limit | Up to 2 active services | Unlimited services |
| Portfolio Images | Max 3 images per service | Max 15 images per service |
| Video Pitch | ❌ Not supported | ✅ 1 short video allowed |
| Visibility | Standard ranking | "Pro" badge + search boost |
| Storage per User | ~2 MB (Total: ~1.6 GB) | ~15 MB (Total: ~3 GB) |
Total Estimated Platform Storage:
- Consumers (Profile pics only): 5,000 × 200KB = ~1 GB
- Providers (Free + Pro): ~4.6 GB
- Total requirement: ~6 GB (Easily fits within standard cloud hosting $5-$10/mo tiers).
| Term | Definition |
|---|---|
| Hustle Score | Gamified reputation metric (Phase 2) — ratings, response time, bookings |
| Service Card | Rich message in chat auto-generated from a service listing |
| AI Search | Natural language search powered by Gemini API (server-side) |
| Provider | Student offering a service |
| Customer | Student seeking a service |
| Campus Map | Google Maps view of Meru University with real-time provider pins |
| Portfolio | Images showcasing a provider's work, uploaded via backend |
- Firebase Documentation
- Jetpack Compose Guidelines
- Material Design 3
- Google Maps Platform
- Gemini API Docs
- Clean Architecture — Uncle Bob
- Spring Boot Documentation
| Version | Date | Changes | Author |
|---|---|---|---|
| 1.1 | Apr 2026 | Backend migrated from Firebase/Supabase to Spring Boot (Kotlin) | HustleHub Team |
| 1.0 | Feb 14, 2026 | Initial PRD release | HustleHub Team |
🚀 Let's Build Something Amazing Together
HustleHub - Empowering Campus Entrepreneurs
