Learn

Videos

Short captioned videos that show how Shipvo works: over-the-air updates, signing, staged rollout and rollback, in plain words.

Edit on GitHub

Short videos for people who are new to Shipvo. Each one has captions and a written transcript.

Watch the story

S1 · E1 · From a chat to an app

1 minute 40 seconds. Mara runs a small shop and nobody comes in. Jun asks an assistant to make the shop an app. Dana's assistant finds it and orders. Then three orders arrive in a row. Every Shipvo screen in the film is a real recording of the Tide & Tackle sample app on the Shipvo simulator: order TT-1001 is 2 800 FCFA, TT-1002 is 3 900 FCFA and TT-1003 is 4 200 FCFA.

Captions (.vtt)

ⓘ Copyright creditsMusic: "Awakening" by Celestial Aeon Project (Jamendo, CC BY-NC-SA 2.5). Source: https://www.jamendo.com/track/26436

Short cut for phones (9:16)

38 seconds, 1080 by 1920, cut from the main film for phone feeds: the shop with no customers, the ask in a chat, the assistant's order on the real app, the orders list and the busy shop at sunset.

Captions (.vtt)

ⓘ Copyright creditsMusic: "Something Sacred" by Kellee Maize (Jamendo, CC BY-NC-ND 3.0). Source: https://www.jamendo.com/track/521021
Transcript (short cut)

Mara: Nobody comes in.

Jun: Wait, I can fix that.

Pip: Found it. Ordering now.

Mara: Another one?

Mara: Three orders!

Every assistant can use your app. shipvo.dev

Transcript

Mara: Nobody comes in.

Jun: Wait, I can fix that.

Pip: Found it. Ordering now.

Dana: Whoa, that was quick.

Mara: Another one?

Mara: Three orders!

Pip: All done.

Every assistant can use your app. shipvo.dev

Try Shipvo in your browser

Try Shipvo in your browser: a phone, device features and a rollback

1 minute 32 seconds. Open the playground and tap a shop on a phone that runs in your browser. Switch between Android and iOS, turn on dark mode and large text, choose a location, a payment result and airplane mode, then publish a signed update, crash it and watch the phone go back to version 1 by itself. You install nothing and make no account. It follows the Try Shipvo in your browser tutorial.

Captions (.vtt)

ⓘ Copyright creditsMusic: "Revelation" by Giac & Juan (Jamendo, CC BY-NC-SA 2.0). Source: https://www.jamendo.com/track/116970
Transcript

This phone runs in your browser. You installed nothing. By the end, you will have tapped a shop on Android and iOS, tested a payment, and watched a bad update roll back.

Open shipvo.dev/playground. A shop called Tide and Tackle appears. Tap Add on two products. The cart says two items.

Select iOS, and the same app shows on an iPhone. Select Android to go back. Now try dark mode and large text. The app stays readable.

Real phones know where they are, and can pay. You choose the answer. Pick Lisbon for the location. Approve the payment. Turn airplane mode on. The app shows each choice.

Now the hard part. Publish a signed update. Shipvo checks the signature. It goes to a tenth of cohorts, then to all of them. Now crash it. Three starts in a row fail. On the fourth, the phone goes back to version one, by itself.

Last, add more phones. Pick up to twelve, Android, iOS or both. Copy the link, and whoever opens it sees your setup.

That is a phone, a payment and a rollback, with no install. Try it at shipvo.dev/playground. Next, see your own app on a phone with shipvo run.

Make an app by describing it

Describe an app and watch it appear on a phone

1 minute 44 seconds. Start the simulator, connect your assistant, and say what you want in plain words. Shipvo checks the description, the app opens on a phone with its own icon, and you use it. Ask for a change and what you typed stays in the list. Ask again with the iOS look and you have an Android app and an iOS app from one description. It follows the Describe an app tutorial.

Captions (.vtt)

ⓘ Copyright creditsMusic: "Calling for the Blue Dusk" by Régis V. Gronoff (Jamendo, CC BY-NC-SA 3.0). Source: https://www.jamendo.com/track/343780
Transcript

One sentence, and an app appears on a phone. By the end, you will have made one, changed it, and seen it on Android and iOS. You write no code.

First, start the simulator. It is a phone that runs in your browser. Type npm run sim, and leave it open.

Next, connect your assistant. Type npx shipvo agents setup, then restart the assistant. Now it has Shipvo tools, like create_app and update_app.

Now ask, in your own words. Make a gift ideas app. I want to write who each idea is for, and the idea. Shipvo checks the description first. Then the app opens, with its own icon.

Use it. Ask the assistant to add an idea, Mum, garden gloves. It shows in the list. Keep an eye on this idea. It matters in a moment.

Now ask for a change. Add an About screen, and a button to open it. The app changes at once. And Mum's idea is still there. Shipvo keeps what people typed.

Want the iPhone look? Ask again with the iOS look. The same description gives you an Android app and an iOS app, side by side.

That is an app from one sentence. Try it in your own folder. The step by step guide is at shipvo.dev/learn. Next, see your own app on a phone with shipvo run.

Test your app

Have Lumi test your app while you watch

2 minutes 7 seconds. Run npx shipvo lumi, type test my app, read the findings, press Replay to watch a problem happen again, try bad input, and use --seed 1 to check a fix. No AI account and no code. It follows Have Lumi test your app while you watch and Lumi on Shipvo Phone.

Captions (.vtt)

ⓘ Copyright creditsMusic: "and then its all gone" by Williamson (Jamendo, CC BY-SA 3.0). Source: https://www.jamendo.com/track/124446
Transcript

Your app is on a phone, and something is wrong. A button does nothing. You did not find it. Lumi did, while you watched.

By the end, Lumi has tested your app, and you have replayed one problem. You need no AI account, and you write no code.

Open a terminal in your app folder. Type npx shipvo lumi, and press Enter. Shipvo builds a web copy of your app. For an iPhone, add ios. Android and iOS work the same way.

Your browser opens. The phone is on the left. Lumi's sidebar is on the right. Findings starts at zero. Now, give Lumi a job.

Type, test my app, and press Enter. Lumi taps through your app, from the start screen. A caption names each step, like, Tapping Checkout. The sidebar lists every action.

Now look at Findings. Each one is something Lumi reported. A button that does nothing. A screen that stays blank. A network call that fails. Each problem is listed once. Coverage shows how many screens and controls Lumi tried.

Here is the part that matters. Press Replay next to a finding. The phone repeats the steps that led to it. You watch the problem happen again, with your own eyes.

Want a harder test? Type, try checkout with bad input. Lumi runs the same path with invalid values. A finding here means your app accepted what it should refuse.

Fixed it? Prove it. Stop Lumi with Ctrl+C. Start it again with --seed 1. The same seed gives the same walk, so you can check that the fix worked. And Save as test turns a finding into a test file that fails while the bug is there.

That is it. Lumi tests your app while you watch. Try npx shipvo lumi in your app folder. The guide is at shipvo.dev/learn.

Put your app in the stores

From working app to Google Play and the App Store

2 minutes 4 seconds. The store path in four steps: shipvo store setup for your plan, shipvo store status for one timeline per store, shipvo store details --dry-run for draft data safety answers and a privacy policy, and shipvo store screenshots for checked store sizes. It ends on the Google Play tester rule and shipvo store testers, with a link to the testers video. It follows Store details.

Captions (.vtt)

ⓘ Copyright creditsMusic: "chanson à la marié2012" by Adragante (Jamendo, CC BY 3.0). Source: https://www.jamendo.com/track/941485
Transcript

Your app works. Now you need Google Play and the App Store. By the end, you have a plan for both stores, draft answers, and screenshots. And one rule on Google Play, that catches most founders.

Step one. Make your plan. Type shipvo store setup. It asks if you have a registered company. With a company, you get organization accounts, and no tester rule on Google Play. Without one, you get a personal account, and the tester rule applies.

Step two. Type shipvo store status. You see one timeline for each store. Every step is to do, waiting, or done. It tells you what to do next. When you finish a step, mark it done.

Step three. The stores ask what data your app collects. Type shipvo store details, --dry-run. Shipvo reads the features your app uses, and drafts the data safety answers and a privacy policy. Some questions only you can answer, like third party tools and a contact address.

Step four. Screenshots. Type shipvo store screenshots. Shipvo shows your app in the simulator, and saves files in the sizes the stores ask for. It checks each one.

Now, the rule. On Google Play with a personal account, you need twelve testers for fourteen days in a row. Type shipvo store testers for the steps. Shipvo Testers is a group of founders who test each other's apps. We have a video about it.

So here is what you have. A plan for each store, in order. Data safety answers, and a privacy policy draft. Screenshots in every store size, checked. And the tester steps. You press submit.

Start with your plan. Type shipvo store setup in your app folder. Next, get your twelve testers. The guide is at shipvo.dev/learn.

Run your app

See your app on a phone in your browser with shipvo run

1 minute 33 seconds. One command, npx shipvo run android, opens a simulated phone in your browser with no account and no Android Studio or Xcode. It covers the iPhone look, the dark frame, how your AI assistant drives the same phone with open_app, and the --port and --native options. It follows Run your app on a phone in your browser.

Captions (.vtt)

ⓘ Copyright creditsMusic: "Princess of my heart" by Zero-project (Jamendo, CC BY 3.0). Source: https://www.jamendo.com/track/633200
Transcript

Want to see your app on a phone? You do not need a phone. You do not need Android Studio, or Xcode. One command opens a phone in your browser.

Open a terminal in your app folder. Type npx shipvo run android, and press Enter. Shipvo builds a web copy of your app. It needs no account.

Your browser opens on a page with a phone in the middle. A label says Simulated, because this is a copy of a phone, not a real one. Click it like you would tap.

Want an iPhone instead? Type ios. You get the iPhone look, with its Dynamic Island. The page scales the phone to your window. Add ?dark=1 to the address for the dark frame.

Now the best part. Your AI assistant can drive the same phone while you watch. While shipvo run is up, the assistant calls open_app, and finds your live phone. It taps, types and scrolls. You see every move.

Need another port? Add --port. Want a real emulator later? Add --native. When you are done, press Ctrl+C in the terminal.

That is it. A phone in your browser, in seconds. Try npx shipvo run android in your app folder. The guide is at shipvo.dev/learn.

Get your app on Google Play

Get your 12 Google Play testers with Shipvo Testers

1 minute 42 seconds. The Google Play rule for new personal accounts (12 testers, 14 days in a row), how to join Shipvo Testers, set up a closed test, let shipvo store testers add the group, share your opt-in link and test other founders' apps. It follows Get your 12 testers.

Captions (.vtt)

ⓘ Copyright creditsMusic: "Beyond time" by InternalEye (Jamendo, CC BY-SA 3.0). Source: https://www.jamendo.com/track/1178100
Transcript

Want your app on Google Play? New personal accounts have a rule. You need twelve testers, for fourteen days in a row. Here is how to find them.

Google asks for twelve people to opt in to a closed test. They must stay opted in for fourteen days in a row. If the count drops below twelve, the clock starts again. Company accounts skip this rule. So do personal accounts made before 13 November 2023.

Step one. Join Shipvo Testers. It is a group of founders who test each other's apps. Anyone can join. Members cannot see each other's emails.

Step two. In Play Console, make a closed test track. Upload your first build by hand. Play does not allow that step through the API. Then add the Shipvo Testers group to the track.

Or let Shipvo do it. Run shipvo store testers. It prints the steps for your app. Add your Play key, and it adds the group for you. It never removes a group.

Step three. Share your opt-in link with your own people. They open it, opt in, and install your app.

Step four. Test other apps. The community works because everyone tests. Keep them installed for the fourteen days.

We cannot promise how many people will opt in. But now you have a plan. Join at shipvo.dev/testers.

Test your app

Have an AI assistant test your shop before every release

1 minute 30 seconds. Connect an assistant such as Claude or Cursor to your shop in the simulator, ask it to shop like a customer, check what really happened with the device log, turn its run into a test and run that test before a release. It follows Have an AI assistant test your shop.

Captions (.vtt)

Music: "Thrilled hands holding" by Tymphony (Jamendo, CC BY-SA 3.0) https://www.jamendo.com/track/341563

Transcript

Who tests your app before you ship it? You can ask an AI assistant to do it. It taps every button, like a customer. And it needs no phone.

Step one. Start your shop in the simulator. Then give your assistant one setting. It tells Claude, or Cursor, to start the Shipvo tools. That plug is called MCP.

Step two. Ask it to shop like a customer. Buy the tote. Make the payment fail, then make it work. The assistant taps through the app and tells you what the screen said.

Step three. Ask for proof. The device log lists everything the app asked the phone to do. In our run, the log showed the payment going to "My Shop". But this shop is called Sandbar. The assistant caught a real mistake.

Step four. Turn its run into a test. Ask for export test, and save the file. Then write the words that should appear on each screen. Now the check repeats by itself, in seconds.

Step five. Make it a habit. Run your tests, and then a practice release. If a test fails, the line stops. Nothing is sent to your users.

That is a safety check you can run before every release. The full guide is at shipvo.dev/docs/test-with-an-assistant.

Get started

Create your first app on a simulated phone

1 minute 39 seconds. Make an app, open it on a simulated phone in your browser, tap a button, change the words on the front page and check a release with a dry run. It follows Create your first app.

Captions (.vtt)

Music: "Thrilled hands holding" by Tymphony (Jamendo, CC BY-SA 3.0) https://www.jamendo.com/track/341563

This video, including its soundtrack, is shared under CC BY-SA 3.0.

Transcript

You do not need a phone, or Android Studio, or Xcode. In a few minutes, you can have a real app running on a simulated phone, in your browser.

Step one. Open a terminal and make your app. Type npx -y @shipvo/cli init, then a name. Shipvo also makes a signing key. Keep it safe, and never share it.

Step two. Go into the new folder. Run npm install, and then install the small browser the simulator uses. The second one takes the longest.

Step three. Run npm run sim. Wait for the line that says Simulator on localhost:4545. Then open your browser at localhost:4545/app/. Your app is on the screen.

Click Send a notification. The log says it was sent. Nothing really went out. The simulator labels everything it pretends to do.

Step four. Change the words. Open src/release.ts, and edit the headline. Save the file, wait for "rebuilt", and reload the page. Your new words are on the screen.

Step five. Check a release. Run shipvo publish --dry-run. Shipvo builds and signs your app, but sends nothing. So it is safe to try.

That is your first app. The full guide, with every command, is at shipvo.dev/docs/first-app.

Ship updates

Ship an update to phones in minutes

1 minute 30 seconds. What an over-the-air (OTA) update is, and what happens when you run shipvo publish: build, small patches, signing, three rollout groups and rollback. It follows step 5 of Build your first app.

Captions (.vtt)

Transcript

You found a bug. Your app is already on people's phones. Do you wait days to fix it? With Shipvo, you fix it in minutes.

This is called an OTA update. OTA means over the air. The phone gets the new version straight from you, like a web page.

Step one. Edit your app. In a Shipvo app, the first file to change is src/release.ts.

Step two. Run one command. shipvo publish.

Shipvo builds your new bundle and takes its fingerprint. Then it builds small patches, so phones download only what changed.

Then it signs the release with your private key. That key stays on your machine. Phones check the signature before they apply anything. So a stolen publish token cannot ship code to your users.

Releases go out in three groups. One percent of users. Then ten percent. Then everyone.

If a release fails to start three times on a phone, that phone throws it away. And if you need to go back, one command, shipvo rollback, sends an older release to everyone.

Back up your signing seed first. Then try it yourself. The full guide is at shipvo.dev/docs/getting-started.