How youssef-emad347/cs303-project works
Project Type and Purpose
• BooXtore is a full-stack, cross-platform (iOS, Android, Web) bookstore application built with Expo/React Native (using the new file-based routing in /app) and backed by Firebase services.
• Its goal is to allow end‐users to browse, search, and purchase books, while administrators can manage inventory, orders, and customers—all through the same codebase.
File-Structure Analysis
• Top-Level Configuration
• .expo/, app.json, eas.json: Expo project and build settings.
• tsconfig.json, package.json, global.d.ts: TypeScript and dependency config.
• Frontend Code (app/, components/, assets/)
• app/: Expo Router pages (tabs, layouts, auth, screens, dynamic routes for books/authors).
• components/: Reusable UI blocks (cards, lists, buttons, header, map, search bar).
• assets/: Fonts, images for UI.
• Service Layer (services/)
• Abstractions for calls: authServices.ts, bookService.ts, cartServices.ts, wishlistServices.ts.
• Firebase Integration (firebase/)
• Configuration (firebaseConfig.js), initialization (firebase.js, firebaseBooks.js), custom logic (creditService.ts).
• Data-Seeding Scripts (src/)
• Node scripts using axios.js to fetch or seed authors & books into Firebase—used offline for initial data population.
• Utilities (utils/)
• Shared constants, TypeScript models, types.
README Insights
• Core features: user browsing, detailed book pages, cart & checkout, wishlist, user profiles, admin panel.
• Tech stack: Expo/React Native, Firebase (Auth + Firestore), TypeScript.
Detailed Capture of Architectural Elements
• Include:
• File-based routing structure (tab navigator, stack screens)
• Reusable component blocks & their dependencies on services
• Auth flow: login/signup screens → authServices.ts → Firebase Auth
• Book data flow: home/categories → bookService.ts → Firestore (books)
• Cart & wishlist flows via cartServices.ts and wishlistServices.ts
• Payment/credit logic in creditService.ts (if actual gateway integrated)
• Data seeding scripts as a separate pipeline
• Build pipeline: EAS → app store/web