BITe-Box

BITe Box

BIT Mesra Campus Food Ordering

BITe Box is a campus food‑ordering app that brings BIT Mesra food stalls into one clean Android app — browse stalls, explore menus with prices, build a cart, and place an order straight to the stall on WhatsApp in one tap.

Ordering is locked to the campus boundary: every order is delivered to a hostel, block or campus landmark inside BIT Mesra, and there is no outside‑campus address option.

• Single language codebase: Java (AndroidX, Material Components)
• Auth: Google Sign‑In via Firebase, gated to @bitmesra.ac.in campus accounts
• Monetization: Google AdMob adaptive banner ad
• Permissions: INTERNET only
• Min SDK 24 · Target SDK 36

Disclaimer & Independence: BITe Box is an independent project by ForTheEase and is not affiliated with, endorsed by, or sponsored by Birla Institute of Technology (BIT) Mesra or any campus food stall. All stall names, dish names, prices, timings, and menu data belong to their respective stall owners and may change without notice; please verify availability and pricing directly with the stall on WhatsApp before payment. Stall owners can request menu corrections or listing removal at any time by emailing fortheease@gmail.com.

---

Build & run

# 1. Configure Firebase (see FIREBASE_SETUP.md)
cp /path/to/google-services.json app/google-services.json

# 2. Configure AdMob IDs in local.properties (see ADMOB_SETUP.md)
cat >> local.properties <<'EOF'
admob.appId=ca-app-pub-XXXXXXXXXXXXXXXX~XXXXXXXXXX
admob.bannerAdUnitId=ca-app-pub-XXXXXXXXXXXXXXXX/XXXXXXXXXX
EOF

# 3. Build & install on a connected device/emulator
./gradlew installDebug

Without google-services.json and AdMob IDs, the build still compiles and uses Google’s official test IDs (never ship a release with test ad IDs — see ADMOB_SETUP.md).

Project layout

app/
  src/main/
    java/info/fortheease/bitebox/        MainActivity + ui/, data/, model/, ads/ packages
    assets/                     stalls.json + per-stall menu JSON
    res/                        themes, colors, drawables, layouts, launcher
docs/                           Store listing, privacy policy, data safety, content rating
store/                          Play Store graphics (icon, feature graphic, screenshots)
scripts/generate-keystore.sh    One-time release signing-key generator
privacy-policy.html             Hosted privacy policy (GitHub Pages)
PUBLISHING_GUIDE.md             End-to-end Play Store release playbook

Releasing to Google Play

See PUBLISHING_GUIDE.md for the complete, step‑by‑step release process (account setup, signing, building the .aab, store listing, Data safety, content rating, and rollout). The store‑ready assets and policy copy live in docs/ and store/.

License

MIT — see LICENSE. © 2026 ForTheEase.