Skip to content
Verified

Publish your app

Build a release in Studio, then deploy it as a PWA or SPA with a free Xuda subdomain.

Studio is where an app gets built. Deploying it, so it has a URL someone else can open, happens next door, in the project's dashboard. This tutorial takes whatever you built in the CRM or the order intake app and ships it as an installable PWA or a plain SPA URL, on a free Xuda subdomain. Budget about 15 minutes.

What you'll do

  • Build a release of your project in Studio.
  • Open the project's Deploy flow in the dashboard and choose SPA or PWA.
  • Point the deployment at the Route you already built.
  • Pick your own free *.xuda.app subdomain instead of the default one.
SPA or PWA, what's the difference

SPA gives your project a standalone URL, the plainest way to share it or embed it as a link or an iframe. PWA does the same, plus an installable app: a short name, an icon theme, and a display mode (full screen, standalone, minimal UI, or plain browser) so it can be added to a phone or desktop home screen.

Step 1: Build a release in Studio

Open the build pill

In Studio's top bar, next to your app's name, find the build pill. Before a first build it reads Not built.

Start a new build

Open it and select New Build. Choose Major, Minor, or Patch, or type an exact version number.

Write release notes and confirm

Add release notes by hand, or select Draft notes with AI to generate them from what changed. Confirm on the next screen, restating the version, to actually Publish Build.

The pill now shows the build's version and number, and turns into a progress indicator while the build runs. See Version control for the release list this same build lands in.

Step 2: Open Deploy and choose SPA or PWA

Go to the dashboard

Open the Xuda logo menu at the top-left of Studio's top bar and choose Back to Dashboard. This opens your project's page in the dashboard, where deployment lives.

Open Deploy

Select Deploy. This opens the Deploy Type screen, the same picker every deployment starts from.

Choose your type

Find SPA or PWA among the deployment cards and select it. This opens the deployment wizard for that type. See Your first deploy for the same screen used to create a quick Preview link.

Step 3: Walk the wizard

Configuration, PWA only

If you chose PWA, fill in its Setup: a Short name, a Description (a sentence or two explaining what your app does), Displayed (Full screen, Standalone, Minimal UI, or Browser), and a Theme color and Background color. SPA skips this step.

Launch Settings

Choose what opens when someone uses the URL: pick the Route you built, CRM or Orders, depending on which tutorial you're publishing.

Datacenter

Choose an existing datacenter, or create a new one.

Performance Tier

Pick a tier sized to how many people will use it at once. A small one is enough for testing.

Finalize Details

Name the deployment and check the price shown at the bottom of the wizard.

Create it

Select Create SPA or Create PWA. Xuda opens the new deployment's Overview tab, where you can confirm it's active.

Step 4: Pick your own subdomain

A new deployment gets a free *.xuda.app address right away, you don't have to do anything for that part to work.

Open the Domain tab

On the deployment, open Domain. If you haven't customized it yet, you'll see a Customize your domain prompt.

Choose Subdomain

Pick the subdomain option and type a label, for example my-crm for my-crm.xuda.app. Xuda checks the label is available as you type.

Add it

Confirm with Add. The deployment now answers on your chosen *.xuda.app address instead of the default one.

See Domains for attaching a domain you already own instead of a free subdomain.

Check it

Open the deployment's address in a new tab. Confirm the Route you picked in Launch Settings loads, and for a PWA, confirm the browser offers to install it.