Building one
You build an app with thedip CLI’s dip app new command, which scaffolds a working app with the
Altimate SDK already vendored in. Four runtimes are available:
See Build a data app and the
dip app commands for
the full walkthrough. For your first app, start with
Build and share your first app, which goes from one request to your agent
to a colleague opening the link.
If your tenant has no live apps yet, the Live Apps page itself walks you through the same three
commands: install dip and sign in, scaffold with dip app new, then dip app build && dip app push.
The app registers itself and appears on the page within seconds of a successful push.
The lifecycle
- Scaffold the app (
dip app new). - Check it locally: manifest validity, drift, and a scan that refuses a bundled database driver
(
dip app check). - Develop against your own real query engine, as yourself, before you ever build an image
(
dip app dev). - Ship it: either push a built image to your tenant’s registry, where it registers itself
automatically, or bring your own image hosted elsewhere and register it by hand. Every push that
completes shows up in the Publish history tab on the Live Apps page, with the outcome next to
it; a push that fails before the image lands has no row there — its error prints in the terminal
where you ran
dip app push. See Registry troubleshooting. - Install. The owner or an app administrator reviews what the app asks to access and consents to it, or leaves some of it unchecked, which keeps the app from running at all until every requested capability is granted.
- Active. Once consent is complete, the app starts and appears at its own URL and inside the console’s embedded viewer.
- Use it. Anyone in your tenant with access to the Live Apps page can open it. It suspends after a period of inactivity and wakes again on the next request.
Who does what
An administrator can turn off Publish own apps and Manage own apps per role in
Settings → Roles & permissions. Denies apply through role inheritance and across a member’s
roles. Turning them off also prevents narrow delete, park and uninstall actions; broad administration
remains available. Preview has its own independent permission.
Console controls use your permissions and the app’s owner to show available actions. Every action
checks current permissions again when submitted. See Own-app role settings.
Static apps
A static app is one you build withdip app new --runtime frontend. Its pages are files that Dippr
serves for you, so the app’s own code never runs on a server, and it only reads data. Every
version a member publishes, installs or moves to must be static:
- Each component declares
staticRootin the manifest, the folder of built files inside your image. - No data capability asks for
writeaccess.
What an app’s URL looks like
An installed app gets its own address: a subdomain scoped to that specific installation, not to the app’s name. Because the address is tied to the installation rather than the name, renaming an app later never breaks a bookmark or an embed. On the Live Apps page, opening an app takes you to that address inside an embedded viewer at/apps/<app-name>/view; the app also has its detail page at
/apps/<app-name> for installing, reviewing consent and managing its lifecycle. For a static app,
Open in new tab opens /apps/<app-name>/full, where the app fills the whole tab with no console
menu around it.
In a current browser, a static app is shown only inside the console’s viewer. Opening its own address in a browser
tab takes you to /apps/<app-name>/full for that app, so the address still works as a link to share. An app that
runs its own server opens on its own at its address, and Open in new tab takes you there.
What data apps don’t do yet
A few things are deliberately out of scope for now, reserved for later rather than silently missing:- No unattended or scheduled apps. Every app query runs as a specific person opening it in their browser. There’s no mode today for an app to run on its own, on a schedule, with no one watching.
- One process per app. An app’s manifest can describe more than one container, but only one is accepted when you register or install it. An app runs as a single pod.
- No embedding outside your own tenant’s console. You can open an app inside Dippr’s console today; embedding it in a page you host yourself, outside Dippr, is proposed but not built.
Related
Build a data app
Scaffold an app, read who’s calling it, and test it against your real data.
Write the app manifest
Every field a data app declares, and what the platform validates.