Guides

Domains

Keep the project Default URL, optionally add a Robodev URL, and serve the app on a valid custom subdomain.

Every project always keeps https://{projectId}.robodev.povio.dev (locally {id}.localhost:4000) as the Default URL. That host is the API URL the CLI and generated clients use. Org admins can add a Robodev URL and one custom subdomain from project Settings. The App URL prefers a valid custom domain, then the Robodev URL, then the project id host. Auth magic-link and forgot-password emails use the App URL.

Robodev URL

• Optional, globally unique, 3–63 characters: lowercase letters, digits, and hyphens.
• Serves the app at a host like https://acme.robodev.povio.dev. This is not a customer CNAME.
• Reserved names such as www, api, storage, and cname are rejected. Names starting with prj- are rejected.
• Remove the Robodev URL in Settings to drop that host.

Custom subdomain

Add a hostname such as www.example.com. Names like example.com are not supported yet — use a subdomain. Starbase does not serve or issue TLS for the hostname until DNS is valid.

• Create a CNAME whose name is the relative host (www for www.example.com) and whose value is cname.robodev.povio.dev. Some providers want the full hostname.
• Click Check DNS in Settings. Starbase follows the CNAME chain until it reaches cname.robodev.povio.dev or {projectId}.robodev.povio.dev.
• Replacing a valid domain is not live until Check DNS succeeds.
• Organization members can view addresses and DNS; only admins can change them.