← All docs

Getting started

Sign in, get a workspace, connect a repo, and ship — in minutes.

1. Sign in

  • Open the console and sign in with Google — there are no passwords.
  • Each account has a single workspace. If you don’t have one yet, click “Request a workspace” on your dashboard; it’s approved quickly.

2. Connect your repository

  • Open Repositories (under Settings) and connect GitHub, GitLab or Bitbucket — authorize access once.
  • GitHub and GitLab list every repo your account can access. For Bitbucket, enter your workspace ID (the part after bitbucket.org/) first, then pick the repo you want to deploy.

3. Create a project

  • Go to Projects → New project and pick your app type: Static, React, Node, or Python.
  • Auto-detection: when you choose a repo, Shipyard inspects it (package.json, lockfiles, framework configs, requirements.txt/pyproject) and suggests the app type + build/runtime defaults (and whether a React/Static app runs its own server). Accept the suggestion or override anything.
  • Projects start with production + staging environments, pre-filled with sensible build settings for that type.

4. Deploy

  • Open the project, pick an environment, and click Deploy. Your app goes live over HTTPS at a URL like myapp--staging--ab12cd.apps.<domain>.
  • Turn on auto-deploy for an environment to deploy automatically on every push to its branch.