Get started
Getting access
Copy page
How an app is added to Lia today, what the Lia team sets up for it, and how you get its test key, live key and webhook signing secret.
#How to get started
- Talk to the Lia teamTell us what you're building, from the Builders page. Include your Lia username and your app's https address.
- You become a developerThe team makes your Lia account a developer, with the name shown under your apps.
- Your app is added, in testThe team adds your app in test mode, with you and your testers able to open it.
- You get your keysA test key, a live key and a webhook signing secret, shown once.
- You go liveWhen you're ready, the team switches your app to live and it shows in everyone's Apps Center.
#What the Lia team sets up
Everything about your app lives in Lia's records, not in your page. Ask the team for any of these, and to change them later.
| Setting | What it is |
|---|---|
| App id | Its public identifier, in your invite links and webhooks. 2 to 40 characters: lowercase letters, digits and -, starting with a letter or digit. It doesn't change. |
| Name and tagline | Up to 40 and 80 characters, shown in the Apps Center and on Lia's pay sheet. |
| Address | Your page's https address. Lia only loads pages from this origin. |
| Icon and banner | https images for the Apps Center and its featured card. |
| Look | sheet, full or fullscreen: how your app opens. See How apps run in Lia. |
| Category | One of the Apps Center's categories (games, utilities and others). |
| Status | test, live or paused. See Test and live. |
| Testers | Lia usernames who can open your app while it's in test. |
| Products | What your app sells: an id, a name and a price in $LIA. See Payments. |
| Your share | The part of each sale held for you by Lia Labs. 70% unless agreed otherwise. |
| Webhook address | Where Lia sends signed webhooks (https). See Webhooks. |
| Reward pool | $LIA the Lia team funds for your app to pay players, and the most one player can get from it a day. See Reward pools. |
| Notifications a day | How many notifications your app may send one person a day. 3 unless changed; 0 turns them off. |
| Minimum streak | A check-in streak people need before they can open your app (0 for none). |
#Your keys
Each app has three secrets. The team makes them together and they're shown once: Lia keeps only a hash of each key, so nobody can show them to you again.
| Secret | Looks like | Use |
|---|---|---|
| Test key | lia_test_… | Your server's key while you build. Only sees test charges, test players and test mode. |
| Live key | lia_live_… | Your server's key in production. Works only while your app is live. |
| Webhook signing secret | whsec_… | Checks that a webhook really came from Lia. |
Your app id is public and safe to put in your page. The three secrets are not: keep them on your server only, never in your page, your app's code on GitHub or a message.
#Getting paid
- Your share of sales. Lia Labs holds your share of each sale for you (70% unless agreed otherwise) and pays it out monthly, into your own Lia balance.
- Ad earnings. You get 50% of what the ads in your app earn. Lia counts every ad your app shows and what it earns, and pays your part monthly with your share of sales.
- Withdrawing. From $LIA mainnet in Q1 2028, when payments move on chain, you can withdraw your balance to your own wallet.
#Review
The Lia team reviews every app before it goes live. Test it well with your testers first; Testing your app has a checklist.