Neon

Pull Neon database metrics into a dedicated dashboard widget. Read-only — Produl never writes to your Neon database.

What it does

The Neon integration connects Produl to your Neon account so you can display database health metrics alongside your web analytics data. After connecting, add the Neon Metrics widget to any dashboard to see storage size, compute hours consumed this month, and a branch summary for a selected Neon project.

The integration is strictly read-only. Produl never performs write operations against your Neon account.

Setup

1. 1

   Open Settings → Integrations

   Navigate to Settings → Integrations and click Connect Neon.
2. 2

   Authorize via Neon OAuth

   You will be redirected to Neon's OAuth authorization page. Sign in to your Neon account and approve the requested permissions.
3. 3

   Select a project

   After the OAuth flow completes, Produl redirects you back to the Integrations page. Open the Neon card and use the project picker to select which Neon project the widget should display. You can change the selected project at any time without reconnecting.
4. 4

   Add the Neon Metrics widget to a dashboard

   Open any dashboard in edit mode, click Add Widget, and choose Neon Metrics from the widget library. The widget displays metrics for the project you selected in step 3.

What data is synced

Produl fetches live data from Neon whenever the widget renders — there's no background sync. The Neon Metrics widget surfaces:

• Storage used (displayed in MB or GB)
• Compute hours consumed this month (summed across all branches)
• Branch list: name and whether each branch is the primary (up to 5 branches shown)
• Project name and ID for reference

OAuth scopes

Produl requests the following Neon OAuth scopes:

• openid — standard OpenID Connect scope for user identity.
• offline_access — provides a refresh token so Produl can renew access without requiring you to re-authorize.
• urn:neoncloud:projects:read — grants read access to your Neon projects via the Console API. Write operations are not permitted under this scope.

Troubleshooting

Widget shows "Neon API error"

The most common cause is an expired or revoked access token. Produl stores a refresh token and will attempt to renew automatically, but if the refresh also fails, go to Settings → Integrations, disconnect Neon, and reconnect to obtain a fresh token pair.

Wrong project data displayed

Open the Neon Metrics widget settings (click the gear icon on the widget in edit mode) and confirm the correct project is selected. The picker lists every project accessible to your connected Neon account.

No projects visible in the picker

If the project picker is empty, your Neon account may have no projects, or the connection may be missing the required read scope. Disconnect and reconnect to re-authorize.