Installation

Create a project#

pnpm create shiso-app@latest my-docs

Replace my-docs with your project directory. The directory must be empty if it already exists. The generator:

• Copies a minimal Shiso starter site
• Installs Shiso as a regular project dependency
• Sets the package name from the project directory
• Installs dependencies with the package manager that invoked it
• Initializes a fresh Git repository on the main branch
• Adds no Git remote, so the project is not tied to the Shiso repository

Start the site#

Move into the generated project and start the development server:

cd my-docs
pnpm dev

Open the local URL shown in your terminal. Edit content/docs/index.mdx to change the first page and docs.json to configure the site and navigation.

Upgrade Shiso#

The generator is only used to create the project. Upgrade the framework later through your package manager:

pnpm update @umami/shiso

Your content, docs.json, styles.css, and files under public remain in your project; rendering and build internals update with the dependency.

CLI options#

Run create-shiso-app --help to see every option.

Next step#

Continue to Configuration to customize docs.json, or Writing content to add pages and components.

Back to Introduction.