> ## Documentation Index
> Fetch the complete documentation index at: https://juo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Scaffold a blocks package with create-juo and start defining store-specific blocks for the Juo Editor.

The recommended starting point for `@juo/blocks` is publishing **store-owned blocks** — the "store" group in the [block picker](https://juo.dev/docs/blocks/concepts/blocks.md#block-groups) — using the [`create-juo`](https://www.npmjs.com/package/create-juo) CLI. It scaffolds a package with `defineBlock`, `registerBlock`, schema/preset/locale conventions, and a build configured for publishing against the merchant's storefront portal hosted by Juo.

> [!NOTE]
>
> Building a host application (a custom page shell, services, and routes) is a separate path — see [Building a custom portal](https://juo.dev/docs/blocks/guides/custom-portal.md).

## Scaffold a package

```sh npm theme={null}
npm create juo@latest
```

```sh pnpm theme={null}
pnpm create juo@latest
```

```sh yarn theme={null}
yarn create juo
```

```sh bun theme={null}
bun create juo
```

Follow the prompts to name the package and choose a framework (plain DOM, Vue, React, or Preact). Then:

```sh theme={null}
cd my-blocks
npm install
npm run dev
```

## Add to an existing project

To add `@juo/blocks` to an existing package:

```sh npm theme={null}
npm install @juo/blocks
```

```sh pnpm theme={null}
pnpm add @juo/blocks
```

```sh yarn theme={null}
yarn add @juo/blocks
```

```sh bun theme={null}
bun add @juo/blocks
```

`@juo/blocks` lists `vue`, `react`, and `preact` as **optional peer dependencies**. Install only the one the host application already runs on — or none, if rendering with plain DOM.

From here, see [Blocks](https://juo.dev/docs/blocks/concepts/blocks.md) to start defining blocks.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.