Skip to content

Get Started ​

Last updated View as Markdown

This guide walks you through creating a YouCan app from scratch and installing it on your development store.

Prerequisites ​

1. Create your app ​

Run the following command to scaffold a new YouCan app:

sh
pnpm create @youcan/app@latest

You'll be prompted to name your app. The command sets up everything — dependencies, configuration, and environment — automatically.

Tip

We recommend the Nuxt template as it comes pre-configured with authentication, session handling, and the full development stack.

2. Start the development server ​

sh
cd <your-app-name>
pnpm dev

The CLI will prompt you to log in to your YouCan store if you haven't already. Once authenticated, your app will be running locally and tunneled to a public URL.

3. Install the app on your development store ​

With the dev server running, press P in your terminal.

This opens an installation URL you can complete through the Seller Area. Once installed, your app will appear in the sidebar for testing.

Everything you build during youcan app dev only affects your development store. To take changes to installed stores, deploy a version.

Next steps ​