Getting started (beginner)

This guide assumes you have never used a terminal. Follow it from top to bottom. The first time takes about an hour, almost all of it connecting your accounts. You do that once. Every product after that takes a few minutes of your time.

Nothing here can spend money without asking you. The only purchase is your domain name, and Shipyard shows the price and waits for you to type the word buy.

Step 1. Have these ready

Step 2. Open the terminal

The terminal is a window where you type a line of text and press Enter. Everything Shipyard does starts there.

To run a command from this page: press the copy button next to it, click inside the terminal window, press Ctrl+V (Cmd+V on a Mac), then press Enter. Wait until it stops printing text before you paste the next one.

Step 3. Install Node.js

Node.js is the free program Shipyard runs on. Check whether you have it:

node -v

Step 4. Install Shipyard

  1. Open your account page.
  2. Copy the install command shown there.
  3. Paste it into the terminal and press Enter. It takes about a minute.
  4. Check it worked:
shipyard

You should see a short status screen. If the terminal says it cannot find shipyard, close it, open it again and retry.

On Windows, if you see red text saying that running scripts is disabled on this system, run this line once, answer Y if it asks, then repeat the install:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Whenever you are lost, type shipyard on its own. It tells you where you are and which command comes next.

Step 5. Connect your accounts

Shipyard works inside your own accounts, so each one has to let it in. The pass it needs is called a token: a long password that an account makes for a program. You make one per account.

Go back to your account page and copy the second line, the one that starts with shipyard start. Paste it into the terminal and press Enter. It loads the stack you picked and your licence, then opens Shipyard. On later visits you only need:

shipyard setup

A page opens in your browser. It looks like a website, but it runs on your own computer: what you paste there goes into your computer’s password vault and is never sent to us. Leave the terminal window open while you use it.

The Shipyard setup page: accounts listed on the left, and the steps, permissions and paste box for GitHub on the right.
The setup page. Accounts on the left, the steps for the current one on the right.

The page takes you through your accounts one at a time. For each one:

  1. Tick off the short checklist of things that account needs switched on. Each has a link to the right page. Skip any you have already done.
  2. Press the button that opens the account’s token page. For GitHub and Cloudflare most of the form is already filled in. Follow the numbered steps next to it.
  3. The account shows you the token once. Copy it.
  4. Paste it into the box on the setup page and press Test and save. A green tick means it works. If it does not, the page says what to fix.
  5. Press Next.

When the counter at the top shows every account connected, you are done.

The dashboard

The first entry on the left, Dashboard, shows where everything stands: which accounts are connected, your stack, and every product you have launched with each of its steps. A box at the top always names the one thing to do next. Open it at any time with shipyard setup.

The overview: the next thing to do, three counters, the stack with a tick per connected provider, and a product with its launch steps.
The dashboard. A stopped launch shows the step it stopped at and why.

What you can skip

Some accounts are optional. The page marks them “optional” and gives each a Skip for now button. Your product launches without them, and you can add any of them later by running shipyard setup again.

Using Claude Code, Cursor or Codex instead

If Shipyard is connected to your coding tool, you can skip the terminal for this step. Say “set up Shipyard” and it opens the same page. The tool never sees your tokens.

Step 6. Describe your product

On the setup page, press Launch at the bottom of the list on the left. Fill in four things:

Press Save and review the launch. Nothing has been created yet.

Step 7. Review the launch

This screen lists everything Shipyard is about to set up in your own accounts, in order, and what those providers charge you for it: once, per month and per year. These are not Shipyard fees; your Shipyard licence is already paid. Check two things: the web address is spelled exactly as you want it, and the only purchase is that address. A domain purchase cannot be refunded.

Step 8. Do a practice run

Press Rehearse first. This walks through the whole launch with pretend accounts while you watch each step tick off. Nothing real is created and nothing is paid.

Step 9. Launch

Go back to the review and press Launch for real. Stay near your computer for the first few minutes. You will be asked for two things:

  1. A box appears with the price of your web address. Type the word buy in it and press Buy it. Nothing is bought until you do.
  2. Cloudflare sends an email to your inbox asking you to confirm mail forwarding. Click the link in it.

The rest runs by itself and takes 15 to 30 minutes, mostly waiting for the new address to start working. Leave the page and the terminal window open.

If it stops

Sometimes an account wants something first. The page shows the step it stopped at and why, in plain words. Do what the message says, then press Try again from this step. It carries on from where it stopped. It never does a step twice and never buys anything twice. If the message does not make sense to you, copy it into Claude or ChatGPT and ask what to do, or send it to us.

Step 10. Build your product

Your site is now live with a starter page. Shipyard has also written the instructions an AI coding tool needs to build your actual product on it. On the dashboard, press Get the build prompt next to your product, then Copy the prompt, and paste it into Claude Code or Cursor. Every change that tool saves goes live on your address by itself.

Those tools fetch your code with a free program called Git. Check whether you have it:

git --version

If that prints a version number, you are set. If it prints an error, download Git from git-scm.com, open the file and click Next until it finishes, then close the terminal and open it again. Installing and launching with Shipyard itself does not need Git.

Step 11. Take real payments

Your site starts with payments in practice mode, so you can try buying with the test card number 4242 4242 4242 4242. When Stripe has approved your business details, switch to real payments:

  1. Run shipyard setup and open Go live with Stripe at the bottom of the list on the left.
  2. Follow its steps to paste your live Stripe key.
  3. Back on the dashboard, press Switch to real payments next to your product. It asks you to confirm first.

Then buy your own product once with a real card, check that it arrives, and refund yourself in Stripe.

Your second product

Your accounts stay connected. Next time, run shipyard setup, press Launch, and repeat steps 6 to 9.

Prefer typing commands?

Everything on the page also exists as a command. See Getting started and Commands.

Words used on this page

Getting started (beginner) – Shipyard