Publishing Your App
Register your app on Proma and make it available in the marketplace.
Every app on Proma starts as an OAuth application. Once registered, your app can authenticate users, spend credits, and optionally appear in the Proma marketplace.
Registering Your App
- Sign in to Proma and go to the Developer Dashboard
- Click Create App
- Fill in the required details:
| Field | Description |
|---|---|
| App Name | Displayed to users during login and in the marketplace |
| Redirect URI | Where users return after authorizing (e.g. https://yourapp.com/callback) |
| Description | What your app does — shown in the marketplace listing |
| Logo | Your app icon (recommended: 256x256 PNG) |
- Save and copy your Client ID
Testing Your App
During development, use http://localhost:3000/callback as your redirect URI. Proma allows localhost redirects for registered apps.
Create a test user account on Proma, top up some credits, and test the full flow:
- Login with Proma
- Authorize scopes
- Spend credits
- Verify transactions in the user's dashboard
Going Live
When your app is ready:
- Update your redirect URI to your production URL
- Add a description and logo for the marketplace
- Mark your app as Public in the developer dashboard
Once public, your app appears in the Proma marketplace and any Proma user can discover and use it.
App Visibility
| Status | Who can use it |
|---|---|
| Private | Only you (the developer) — useful for development and testing |
| Public | Any Proma user — listed in the marketplace |
Updating Your App
You can update your app's name, description, logo, and redirect URIs at any time from the Developer Dashboard. Changes take effect immediately.