Skip to content
v1
Feedback

Quickstart: launch your first project

Go from sign-up to a live URL in about five minutes: create a project, connect a repository and deploy.

You are reading the v1 docs of Acme Cloud. Go to the latest version (v2) →

On this page

This guide walks you through the fastest path to a live app on Acme Cloud. You need an Acme Cloud account and a Git repository with a web app in it — any framework that builds to static files or runs on Node.js 20 works.

Create a project#

  1. Open the dashboard#

    Sign in at app.acme.example.

  2. Click New project#

    You find it in the top-right corner of every page.

  3. Name it#

    The name becomes part of your preview URL, so keep it short.

  4. Pick a region#

    Choose the region closest to most of your users — US East (Virginia) is the default.

Good to know

You can rename a project later; its preview URL keeps working.

Connect your repository#

Acme Cloud deploys every push to your default branch and creates a preview for every pull request.

GitHub and GitLab#

Pick your provider, authorize the Acme Cloud app and select the repository. We only request access to the repositories you choose.

Any other Git host#

Use the CLI instead and deploy from your machine or CI:

Shell
npm install -g @acme/cli
acme login
acme deploy --prod

Check your build settings#

We detect most frameworks automatically. If your app needs something different, set it under Settings → Build.

SettingDefaultExample
Build commandnpm run buildpnpm build
Output folderdist.next
Node.js version2022

Deploy and share#

Click Deploy. The first build usually takes one to two minutes; later builds reuse the cache and are faster. When it finishes, you get a URL like my-app.acme.app that you can share right away.

Tip

add a custom domain any time under Settings → Domains. HTTPS certificates are issued and renewed automatically.

Was this article helpful?

79% found this helpful