App Listing

Apps are listed on the Bkper Automations Portal, populated from bkper.yaml fields. By default visible only to declared users — submit a request to Bkper to publish your app to all users in the directory.

All Bkper apps are listed on the Automations Portal at app.bkper.com > Automations > Apps. Each app has its own page with logo, description, and details:

App listings are populated from the fields you declare in bkper.yaml. App metadata is synced to Bkper via bkper app sync or bkper app deploy.

Listing fields

Make sure your bkper.yaml has the following fields populated for a complete listing:

id: your-app-id
name: Your App Name
description: A clear description of what your app does

logoUrl: https://your-app.bkper.app/images/logo.svg
logoUrlDark: https://your-app.bkper.app/images/logo-dark.svg

ownerName: Your Name or Organization
ownerWebsite: https://yourwebsite.com

website: https://your-app.bkper.app

See App Configuration for the full bkper.yaml reference.

Default visibility

When you deploy an app, it’s visible only to the accounts you’ve declared in bkper.yaml:

# Specific users
users: alice@example.com bob@example.com

# Your entire domain
users: *@yourcompany.com

Your team can install and use the app, but it doesn’t appear in the public Bkper app directory for other users.

Publishing to all users

To make your app available to all Bkper users, contact us at support@bkper.com. We’ll review your app and, once approved, publish it.

What the review involves

Functionality check — The app works correctly and handles errors gracefully
Security review — Event handlers are idempotent and include loop prevention
Listing quality — The app has a clear name, description, and logo

Where published apps appear

Once published, your app appears in:

bkper.com/apps — The public app directory
Automations Portal — Inside every Bkper book, users can find and install your app