Building your first app

Apps in rumahl are self-contained containers with a web UI that access the platform through the API gateway. The reference example is the Notes app — use it as your template.

The skeleton of an app

• An app manifest (manifest.json) with name, permissions and lifecycle hooks
• Your own Docker container with a health check
• A web UI reachable from the launcher
• Platform access through the API gateway with an app token

The first step

1. 1Copy the example: apps/examples/apps/rumahl-notes from the repository.
2. 2Adjust manifest and name — define the permissions your app really needs.
3. 3Build and start the container locally (managed by rumahl-supervisor).
4. 4Register the app in the developer dashboard and answer the review.

Choosing permissions

Only request the permissions your app really needs — this speeds up the review and builds trust with users. Missing permissions can be requested at runtime.