#Admin Console — Dashboard & Management
The bridge of the starship, if you will. One web page to monitor everything happening across your ambientChat deployment — users, beacons, errors, and the general state of the universe.
#What It Does
The Admin Console is a web-based management interface for superusers and organization administrators. It provides a centralized dashboard with real-time statistics, error monitoring, and access to every administrative function in the system. If the mobile app is where users interact with their data, the admin console is where you make sure everything is working properly for everyone.
The dashboard is your landing page — a quick-glance summary of platform health, user activity, and system status. From there, you can drill into any area that needs attention.
#How to Use It
#Admin Web
Accessing the console:
- Navigate to your admin console URL in any modern web browser
- Dev environment:
admin-ambientchat-dev.web.app - Production:
app.ambientchat.ai
- Dev environment:
- Sign in with your admin credentials (same login as the mobile app, but your account must have admin or superuser role)
- You'll land on the Dashboard — the home screen for all admin activity
Dashboard overview:
The dashboard presents key metrics in a widget layout:
| Widget | What It Shows |
|---|---|
| User Statistics | Total registered users, active users, new signups |
| Partner Counts | Number of partner organizations and their users |
| Beacon Statistics | Total beacons registered, active regions, recent detections |
| Error Monitoring (24h) | Error count and rate over the last 24 hours — the number you want to keep at zero |
| Search Fallback Events | When semantic search falls back to keyword search — indicates embedding gaps |
| Login Analytics | Recent login activity, sign-in methods, failed attempts |
Navigation:
The sidebar gives you access to every section of the admin console:
| Section | What You'll Find |
|---|---|
| Dashboard | The overview you're looking at right now |
| Users | Search, browse, and manage user accounts |
| Billing | Revenue tracking, tier breakdowns, usage analytics |
| Chat | Conversation audit, message search |
| Scans | Processing queue status, failed jobs, retry controls |
| My Things | Inventory overview across users |
| Beacons | Beacon registry, region management, alert configuration |
| Partners | Partner organization management |
| Configuration | System settings, feature flags, tier definitions |
| Diagnostics | Function health, Firestore inspection, storage stats |
| Audit Log | Complete trail of every admin action with timestamps |
| Settings | Admin console preferences |
| Profile | Your admin profile |
| Delete Account | Account deletion management (with confirmation workflow) |
Role-based access:
Not everyone sees everything. Access is scoped by role:
- Superusers see the full console — every section, every user, every setting
- Brand admins see their organization's users and data, but not system-wide configuration or other organizations' data
- Regular users cannot access the admin console at all — they'll be redirected to sign-in
#Tips & Tricks
- Check the error monitoring widget daily. A spike in errors is the earliest signal that something needs attention. The 24-hour window keeps the view current without overwhelming you with historical noise.
- Search fallback events matter. When the system falls back from semantic search to keyword search, it means some items or documents are missing embeddings. This affects search quality for users. If the count is climbing, investigate the embedding generation pipeline.
- Bookmark the dashboard. It's the fastest way to get a pulse on platform health. Most admin sessions should start here before diving into specific sections.
#Options
| Setting | What It Does | Default |
|---|---|---|
| Dashboard refresh | How often dashboard widgets refresh their data | On page load |
| Theme | Light or dark mode for the admin console | System default |
| Timezone | Display times in your local timezone | Browser timezone |
#Known Limitations
- The admin console is web-only. There is no mobile admin app — use a desktop or tablet browser for the best experience.
- Some operations require superuser role. Configuration changes, system diagnostics, and cross-organization data access are restricted to superusers. Brand admins will see these sections grayed out or hidden.
- Dashboard data is not real-time streaming. Widgets update when the page loads or when you manually refresh. For real-time monitoring of specific events, use the Diagnostics section.
- Browser compatibility. The console works best in Chrome, Safari, Firefox, and Edge. Older browsers may not render all dashboard widgets correctly.
#Version History
| Version | Date | What Changed |
|---|---|---|
| 1 | 2026-03-01 | Initial guide |