Skip to content

Cloud Staging API

The easiest way to test that your trivial-ui install is working correctly is to use the hosted staging API server.

Using the Staging API Server

To run trivial-ui locally against the cloud staging API:

  1. Register for an account on the cloud staging site. This is the user and password you'll use locally. Password reset and invitations emails work on staging, making it preferable to use the cloud staging site instead of your local install for account management.

  2. Download the trivial-ui repository and follow the instructions in the readme.

  3. In your .env file in trivial-ui, add or uncomment the following:

YAML

VITE_TRIVIAL_API_URL = https://trivial-api-staging.herokuapp.com
  1. Start your local trivial-ui by running npm run dev. For more about the env file, please refer to the trivial-ui repository.

  2. Trivial UI should now be running against the staging API at http://localhost:5173/

The staging API accepts CORS requests from common Vite ports 5173 and 4173, but blocks browser requests from other ports.

[0] Assuming manual invoices are sent on the 4th of each month, delivering on the 1st is 3 out of 4 days faster-- a 75% speed improvement.