# Store Locator Admin Panel This is the Next.js TypeScript admin panel for the `storeLocator` React Native app. Use it to launch and operate the mobile app with Firebase-backed users, content, media, campaigns, support, audit logs, roles, and app-specific workflows. ## Requirements - Node.js 20.9 or newer - Corepack enabled - Yarn 4 through Corepack - Firebase project used by the matching React Native app - Owner admin account configured in Firebase Auth or Firestore ## Install ```bash corepack enable corepack yarn install --immutable ``` ## Configure Firebase Copy the example environment file: ```bash cp .env.example .env.local ``` Fill the Firebase web config and server-only Firebase Admin SDK values. Keep real secrets out of Git. Required Firebase setup: - `NEXT_PUBLIC_FIREBASE_API_KEY` - `NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN` - `NEXT_PUBLIC_FIREBASE_PROJECT_ID` - `NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET` - `NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID` - `NEXT_PUBLIC_FIREBASE_APP_ID` - `FIREBASE_PROJECT_ID` - `FIREBASE_CLIENT_EMAIL` - `FIREBASE_PRIVATE_KEY` - `FIREBASE_SERVICE_ACCOUNT_PATH` - `FIREBASE_STORAGE_BUCKET` ## Run Locally ```bash corepack yarn dev ``` Open the local URL printed by Next.js and sign in with an owner admin account. ## Validate Before Launch ```bash corepack yarn typecheck corepack yarn build ``` Then open the admin panel and complete: - Dashboard - Launch Checklist - App Settings - Admin Roles - Audit Log - Support Cockpit - Media Library - Campaigns - Listings Operations (/admin/listings-operations) - Messaging Operations (/admin/messaging) ## Included Admin Areas - Dashboard - Launch Checklist - App Settings - Admin Roles - Audit Log - Support Cockpit - Email campaigns - Push campaigns - Media Library - Messaging operations ## Managed Data | Entity | Key | Firestore collection | Access | | --- | --- | --- | --- | | Users | `users` | `users` | readWrite | | Chats | `channels` | `channels` | readOnly | | Email Templates | `emailTemplates` | `email_templates` | readWrite | | Categories | `categories` | `store_locator_categories` | readWrite | | Filters | `filters` | `store_locator_filters` | readWrite | | Listings | `listings` | `store_locator_listings` | readWrite | | Reviews | `reviews` | `store_locator_reviews` | readWrite | | Saved Listings | `savedListings` | `store_locator_saved_listings` | readWrite | ## App-Specific Workflows - Complete Launch Checklist - Update App Settings - Invite team members in Admin Roles - Review Audit Log after critical actions - Search and support users in Support Cockpit - Export CSV for operational review - Upload and reuse media assets - Prepare email campaign segments - Prepare push campaign segments - Run Listings Operations - Run Messaging Operations ## Production Launch Pack Read these files before deploying the admin panel or giving production access: - [Launch Pack](docs/LAUNCH_PACK.md) - [QA Checklist](docs/QA_CHECKLIST.md) - [Operations Checklist](docs/OPERATIONS_CHECKLIST.md) ## Public Docs - Admin Panels: https://instamobile.io/docs/admin-panels - Firebase Integration: https://instamobile.io/docs/admin-panel-documentation/firebase-integration - React Native setup: https://instamobile.io/docs/getting-started-with-react-native # admin-panel