App Listing

Apps are listed on the Bkper Automations Portal, populated from bkper.yaml fields. Sync metadata with bkper app sync, and by default limit installation to declared users until you publish more broadly.

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. Sync metadata changes with bkper app sync. Deploying code is a separate step.

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

By default, installation is limited to the users you’ve declared in bkper.yaml:

# Specific Bkper usernames
users: alice bob

# Your entire domain
users: *@yourcompany.com

Use Bkper usernames for individual access, not email addresses.

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