23aneessss/jo3t-app

Discover restaurants, cafés, and hidden gems across Algeria through community reviews, real photos, maps, and a community-backed score for every place. JO3T Find places worth eating at in Algeria — ranked by the people who actually ate there. A Flutter app for discovering restaurants, cafés and street food across the 48 wilayas. --- ## Download **There is no published build yet** — no APK, no App Store or Play listing, no tagged release. To try JO3T you build it from source, which takes two commands: ```bash flutter pub get flutter run ``` The app boots on in-memory sample data, so that is enough to reach every screen. No Firebase project, no API keys, no account. See Run locally for the backed-by-Firebase setup. > Screenshots and a product tour live on the site in `website/` — a static page you > can serve locally or deploy to Vercel. --- ## What JO3T does **Discovery** — a *For You* feed with category chips, a daily featured pick, wilaya shortcuts, a *Following* activity tab, and pull-to-refresh. Search adds a category grid, trending shortcuts, a people tab, and filters for price, minimum score and open-now. **The JO3T Score** — one number, 1 to 10, per place. A weighted review average adjusted for recency and damped by confidence, so three glowing reviews cannot outrank three hundred. It is computed in a Firestore-triggered Cloud Function (`functions/src/index.ts`). **Places** — hero gallery with pinch-to-zoom, the score ring, open/closed state from a 7-day hours table, price range, attribute chips, directions, similar places, and the full review list with sorting and a score distribution. **Reviews** — an animated 1–10 score picker, photo attachments, expandable text and photo strips, sorted newest / highest / lowest. **Map** — a Google Map with custom category pins and tap-to-preview cards. With no API key configured it falls back to a hand-drawn illustrated map carrying the same pins. **Contributing places** — a multi-step submission form (category, wilaya, neighbourhood, photos) that lands in a `places_pending` moderation queue. **Social** — follow people, an activity feed, mutua …