Skip to content

Quick Start

To get started, run:

bash
npm create sidebase@latest
bash
pnpm create sidebase@latest
bash
# Note: Due to a known problem with `yarn`, it is not possible to force yarn to always use `@latest`: https://github.com/yarnpkg/yarn/issues/6587
yarn create sidebase

That's it! The CLI will guide you through the process.

First Steps

After running:

bash
npm create sidebase@latest
bash
pnpm create sidebase@latest
bash
# Note: Due to a known problem with `yarn`, it is not possible to force yarn to always use `@latest`: https://github.com/yarnpkg/yarn/issues/6587
yarn create sidebase

your app is already ready to go! We suggest that you just try it out to get started:

bash
npm run dev
bash
pnpm run dev
bash
yarn run dev

After making sure that everything runs by opening localhost:3000 you can get started: Remove the minimal sidebase-starter pages/index.vue content and replace it with your own logic.

With Prisma

If you've added Prisma ORM by selecting it as a module for the Merino-stack or by selecting the Cheviot-stack, you should:

  1. Adapt the prisma/schema.prisma to your liking,
  2. Generate the Prisma client by running:
bash
npx prisma generate
bash
pnpx prisma generate
bash
npx prisma generate
  1. Push your prisma-schema to the database (optional for sqlite3):
bash
npx prisma db push
bash
pnpx prisma db push
bash
npx prisma db push

Per default the prisma/schema.prisma file will only contain an Example-table:

prisma
model Example {
  id          String @id @default(uuid())
  details     String
}
// < other content removed for brevity >

Per default sqlite is configured as the target database, so you can start with development right away. For deployment you may want to switch to another database provider. See the Prisma ORM introduction for further information

CLI Options

The CLI offers some options. These are experimental at the moment and will change and expand over the coming months:

  • --quick: Quicker flow through CLI, mostly by skipping 🐑 Diamond the friendly sheep-helper

Released under the MIT License.