A mobile-first job marketplace connecting daily wage workers (construction, cleaning, delivery) with employers offering short-term or urgent work.
Built for the people usually left out by mainstream job apps:
- 📱 Low-end Android devices — APK target < 15 MB, lazy-loaded images, paginated feeds
- 🌐 Slow / unreliable internet — local Hive cache with a stale-data banner when offline
- 🔤 Low-literacy users — icon-driven UX, colour-coded status badges, large tap targets (≥ 48 dp)
- Phone OTP auth — no passwords; short-lived JWT (15 min) + rotating 30-day refresh token
- Role-based flows — workers browse & apply, employers post & hire; roles enforced server-side
- Location-aware job feed — nearby jobs via PostGIS
ST_DWithingeo queries - Application lifecycle — apply → accept / reject / withdraw, one application per worker per job
- Bidirectional reviews — workers and employers rate each other after a job completes
- Guest browsing — explore jobs before signing up; login prompted only on apply
- In-app notifications — written synchronously on relevant events
| Layer | Technology |
|---|---|
| Frontend | Flutter (Dart), Android-first |
| State | Riverpod |
| Backend | FastAPI (Python 3.11+), async REST |
| Database | Supabase — PostgreSQL 15 + PostGIS |
| Auth | Phone OTP (Supabase Auth) + JWT (JWKS RS256/ES256) |
| Maps | OpenStreetMap tiles (flutter_map) + Nominatim geocoding |
| Rate limit | slowapi (60 req/min global, 10/min on /auth/*) |
Key Flutter packages: flutter_riverpod, dio, hive_flutter, go_router, geolocator, flutter_map, cached_network_image, flutter_secure_storage, intl.
graph TD
A[Flutter App] --> B[FastAPI Backend]
B --> C[Supabase PostgreSQL + PostGIS]
B --> D[Supabase Auth - Phone OTP]
A --> E[OpenStreetMap / Nominatim]
flowchart TD
OPEN[Open App] --> SPLASH{Token found?}
SPLASH -- no --> BROWSE[Browse Jobs - Guest mode]
SPLASH -- yes --> ROLE
BROWSE -- tap Login --> LOGIN[Phone + OTP - Pick role]
BROWSE -- try to apply --> LOGIN
LOGIN -- verified --> ROLE{Role?}
LOGIN -- skip --> BROWSE
ROLE -- worker --> W[Worker Home - Job Feed]
ROLE -- employer --> E[Employer Home - My Jobs]
W --> WD[View Job] --> WA[Apply]
WA -- accepted --> WC[Complete Job] --> WR[Rate Employer] --> W
WA -- rejected --> W
E --> EP[Post Job]
E --> ED[View Applications]
ED -- accept --> EC[Complete Job] --> ER[Rate Worker] --> E
ED -- reject --> E
W -- logout --> BROWSE
E -- logout --> BROWSE
backend/app/
routers/ # auth, users, workers, employers, jobs,
# applications, reviews, notifications, categories
schemas/ # Pydantic models per domain
services/ # auth, job, application, notification services
config.py # Settings (pydantic-settings)
dependencies.py # get_current_user — JWT + JWKS decode
main.py # FastAPI app factory
backend/supabase/migrations/ # SQL schema, indexes, triggers, seed
dailywork/lib/
core/ # api config, dio client, router, theme
models/ # user, job, category models
providers/ # Riverpod state
repositories/ # abstract data access (jobs, users, auth, reviews)
screens/ # auth/, worker/, employer/, browse/, shared/
users, worker_profiles, employer_profiles, jobs, applications, reviews, notifications, categories.
Location stored as GEOGRAPHY with a GIST index; jobs feed indexed on (status, created_at); one-application-per-job enforced by a unique constraint.
cd backend
pip install -r requirements.txt
cp .env.example .env # fill in Supabase keys
uvicorn app.main:app --reload --port 8000API docs at http://localhost:8000/docs (development only).
# Apply migrations from backend/supabase/migrations/ to your Supabase project.# PostGIS is required: CREATE EXTENSION postgis;cd dailywork
flutter pub get
flutter run # point api_config.dart at your backend URLcd backend && pytest -v
cd dailywork && flutter test&& flutter analyzeAll routes prefixed /api/v1; auth via Authorization: Bearer <jwt>.
| Router | Key endpoints |
|---|---|
/auth | send-otp, verify-otp, refresh, setup-profile |
/users | GET /me, PATCH /me, GET /{id}/reviews |
/workers · /employers | GET/PATCH /me/profile, GET /{user_id}/profile |
/jobs | feed, create, detail, update, delete, apply, applications, status |
/reviews · /notifications · /categories | rate, list/read, list |
See LICENSE.