Home/Docs/Get started

Quickstart

Your first deploy in about a minute, by upload, from Git, from the terminal, or from an AI chat.

Before you start

Sign in at app.wrenship.com with GitHub, Google, an email link or a passkey. The Free plan needs no payment method.

Upload a folder or a zip

  1. Open New project and drop your project folder or a .zip of it.
  2. Wrenship shows what it found, for example Vite + React · static site, and any warnings, such as secrets in a .env.example.
  3. Pick a name and press Deploy. The build log streams live.
  4. When it's done, your site is at https://<name>.wrenship.site. You can pick .wrenship.space instead before deploying.

Uploads can be up to 100 MB. Leave node_modules and build output out: Wrenship installs dependencies and builds for you.

Deploy from Git

  1. In New project, choose Import from Git and connect GitHub or GitLab.
  2. Pick the repository, the branch to deploy, and the root folder if the app lives in a subfolder.
  3. Press Deploy.

After that:

  • Every push to the production branch builds and goes live. You can turn auto-deploy off in the project settings.
  • On Edge Pro, every pull request gets a preview at its own address, and Wrenship comments the link on the pull request. See Previews.

Deploy from the terminal

npx wrenship login
npx wrenship deploy

The CLI builds on your machine the way Wrenship would and publishes the result, so it uses no build minutes. See Deploy from the terminal, which also covers CI and GitHub Actions.

Deploy from an AI app

Connect your AI app once (see Connect an AI app), then ask in plain words:

Deploy this site to Wrenship and give me the link.

The AI uploads the files, follows the build and replies with the live URL. Production deploys can wait for your approval in the dashboard if you turn that on.

Next steps