shipone
v0.1.2
Published
Ship your full-stack project in under 1 minute — with one command. Deploys into your own Vercel, Netlify, Render or Railway accounts, wired together.
Maintainers
Readme
ShipOne
Ship your full-stack project in under 1 minute — with one command.
Free & open source. Works with your own Vercel, Netlify, Render and Railway accounts.
The problem every developer knows
You just finished building your app. The code is done. But the app is not live — and going live is the annoying part:
- Open 3 different websites and create the same project twice (frontend here, backend there)
- Copy the frontend's web address, paste it into the backend's settings
- Copy the backend's web address, paste it into the frontend's code
- Hit the scary browser security error because the two halves can't talk to each other
- Google the fix, change a setting, redeploy, hope it works
30–60 minutes of clicking, every single project. And you'll do it all again tomorrow.
The solution
shiponeThat's it. ShipOne looks at your project, understands what it's made of, and takes it live — while you watch.
- It figures everything out by itself — which folder is your website, which is your server, how to build and start each one. 10+ frontend stacks and 6+ backend stacks supported.
- It introduces your frontend and backend to each other — addresses exchanged both ways, and the browser security wall configured before anything goes live. No errors on the first visit. Ever.
- It asks only for what it can't know — like your database password. Everything else is filled in for you.
- It watches the build for you — and if something fails, it shows you exactly the lines that broke.
- Run it again anytime — it finds your existing project instead of creating a second one. Two runs, same app.
What makes it different
Most deploy tools do one half of your app and leave the hard part to you.
| | Other tools | ShipOne | |---|---|---| | Deploys your frontend | Yes | Yes | | Deploys your backend | Yes | Yes | | Wires them together (API address + security) | You do it manually | Automatic, before launch | | Your own accounts — no vendor lock-in, no markup | Some take a cut or lock you in | Deploys into your Vercel / Netlify / Render / Railway | | Catches mistakes before they go live (hardcoded localhost, missing port, forgotten secrets) | No | Warns you before deploying | | Multiple hosts, your pick per project | No | Connect all four, choose per project |
Nobody else connects your full-stack app end-to-end in one command. That's the whole point of ShipOne.
Quick start (under 60 seconds)
1. Install it
npm install -g shiponepnpm add -g shiponeyarn global add shiponebun add -g shiponeNo install at all? Run it directly:
npx shiponeYou need Node.js 22+ and git on your machine.
2. Connect your account (one time ever)
ShipOne opens your browser, you paste a token from your hosting dashboard — done. It's stored only on your machine, readable only by you.
3. Go live
shiponePick Deploy this project, confirm, and watch your app go live.
What you can do day-to-day
| Type this | What happens |
|---|---|
| shipone | Opens the menu — deploy, preview, status, logs, connect more hosts |
| shipone status | Is my app live? Is GitHub ahead of what's deployed? |
| shipone logs | See what your app is saying (or why a build failed) |
| shipone env set KEY=value | Add a setting to the live app (like an API key), then run the menu to apply it |
| shipone account | See who you're signed in as on each host |
| shipone uninstall | Make ShipOne forget everything it stored on this machine |
Which hosts can I use?
| Your website lives on | Your server lives on | |---|---| | Vercel · Netlify | Render · Railway |
Connect one of each — or all four. If several are connected, ShipOne simply asks which one you want for this project, remembers your choice, and never asks again for that project.
It plays nice with your project
On the first deploy, ShipOne saves a tiny shipone.yml file in your repo — your project's memory. Commit it, and anyone on your team gets the exact same one-command experience.
Want to fine-tune it? Open the file — folder names, host choice, custom build commands. It's 6 lines of plain settings.
Uninstall
Two steps — first make ShipOne forget your data, then remove the tool:
shipone uninstall # forgets tokens, settings and project historyThen remove the CLI itself:
npm uninstall -g shiponepnpm remove -g shiponeyarn global remove shiponebun remove -g shiponeYour live apps are never touched. They keep running in your Vercel / Netlify / Render / Railway accounts — uninstalling only cleans your machine.
Good to know
- Does pushing code auto-deploy? No. Your app only changes when you run
shipone. No surprise deploys. - Does it touch my code? It adds one small settings file. That's all.
- Where do my tokens live? In a private file on your machine (
~/.shipone). Never in your code, never sent anywhere but the host you chose. - What does it cost? Nothing. ShipOne is free and open source — you deploy into your own accounts, on their free tiers.
Built for developers who'd rather ship than click.
