Admin Dashboard

Before building custom analytics, you need basic visibility into your platform. The admin dashboard gives you this from day one -- a single screen that answers the questions every SaaS founder asks daily: How many users do we have? Are they growing? Is anything broken? Who are our biggest customers?

Why This Matters

In the early stages of a SaaS, you do not need a full analytics suite. But you do need to know if signups are trending up or down, whether your email verification flow is working, and if anyone is abusing the platform. The dashboard provides this without requiring any third-party analytics tools or database queries. As you scale, it becomes the first screen your operations team checks every morning.

Endpoint

GET /api/admin/dashboard

Returns a comprehensive snapshot of the platform in a single API request. The frontend renders this data using the AdminOverviewPage.tsx component, which displays cards for key metrics, line charts for growth trends, a table for recent audit events, and a ranked list of top organizations.

Platform Totals

Total Users

The overall count of registered users on your platform. This is your primary growth metric. Track it daily to understand whether your marketing and product efforts are driving signups. A sudden spike might indicate a successful campaign or a viral moment; a plateau might signal it is time to revisit your acquisition strategy.

Verified Users

Users who have confirmed their email address. Compare this to total users to gauge your email verification rate. If you have 1,000 users but only 600 are verified, something is wrong -- your verification emails might be landing in spam, the flow might be confusing, or bots might be creating accounts. A healthy SaaS typically sees 80-95% verification rates. This metric helps you catch deliverability issues early.

Suspended Users

Users currently suspended by an admin. A small number here is normal (abuse handling, ToS violations). If this number is growing fast, you might have an abuse problem that needs a systemic solution like better signup validation or CAPTCHA. If it is zero and you have thousands of users, you might not be enforcing your terms of service actively enough.

Total Organizations

The number of active organizations (workspaces) on your platform. In a B2B SaaS, this is often more meaningful than user count because each organization represents a paying customer or potential paying customer. Compare organizations to users to understand your average team size.

Signup Rates

The dashboard calculates user signup velocity across three time windows, giving you both immediate and trend-level visibility:

• Daily -- new registrations today. Useful for spotting the immediate impact of a launch, a Product Hunt feature, or a marketing campaign you pushed this morning.
• Weekly -- new registrations in the last 7 days. Smooths out daily noise. If your weekly number is consistently growing, your acquisition engine is working.
• Monthly -- new registrations in the last 30 days. The number you report to investors, use in board decks, and compare month-over-month. A declining monthly number is an early warning sign.

When to Use This

Check daily signups the day after launching a campaign to measure immediate impact. Use weekly signups to compare the effectiveness of different acquisition channels. Use monthly signups for investor updates, board meetings, and strategic planning.

Growth Charts

A 30-day growth dataset is included for rendering line charts on the frontend. Each data point contains the date and the cumulative user and organization count for that day. This gives you a visual trend line that is immediately understandable -- is growth accelerating, linear, or flattening?

When to Use This

Growth charts are essential for investor reporting -- they want to see a curve, not just a number. They are also useful for internal retrospectives: you can visually correlate growth inflection points with product launches, pricing changes, or marketing campaigns.

Recent Audit Events

The latest 10 audit log entries are returned, giving admins a quick view of recent activity across the platform. Events include user logins, setting changes, role assignments, user suspensions, organization deletions, and more.

Why This Matters

This is your security monitoring at a glance. If someone made an unexpected change -- a setting was modified, a user was suspended, a role was assigned -- you will see it here immediately without having to navigate to the full audit log. It is also useful for shift handoffs: the next admin on duty can quickly see what the previous admin did.

Top Organizations

The top 5 organizations by member count are listed, helping admins identify the most active workspaces at a glance.

Why This Matters

Your largest organizations are your most important customers. They are the ones most likely to upgrade to higher plans, provide valuable feedback, and cause the most impact if they churn. Knowing who they are helps you prioritize support, reach out proactively for feedback, and ensure their experience is excellent. If a top organization suddenly shrinks in member count, that could be an early churn signal worth investigating.

Response Example

{
    "totals": {
        "users": 1284,
        "verified_users": 1100,
        "suspended_users": 12,
        "organizations": 340
    },
    "signups": {
        "daily": 8,
        "weekly": 47,
        "monthly": 192
    },
    "growth": [
        { "date": "2026-02-19", "users": 1092, "organizations": 298 },
        { "date": "2026-02-20", "users": 1098, "organizations": 300 }
    ],
    "recent_audit": [
        { "event": "user.login", "user_email": "admin@example.com", "created_at": "2026-03-21T10:15:00Z" }
    ],
    "top_organizations": [
        { "id": 1, "name": "Acme Corp", "member_count": 85 }
    ]
}