Skip to content

prisma/try-prisma

Repository files navigation

readme-try-prisma

Tests Linting Commitizen friendly

try-prisma is a CLI tool that helps you easily get up and running with any project from the prisma/prisma-examples repository.

These projects are meant to be playgrounds for you to test integrations and features, not production-ready boilerplates or templates.

Do you have feedback about a specific example template? Submit it here!

Usage

The easiest way to set up a project using try-prisma is to run the following command:

npx try-prisma

This will walk you through a set of interactive options (detailed below) to help you set up your project.

Arguments

You can optionally provide arguments to the npx try-prisma command as an alternative to (or in combination with) the interactive experience.

The options are as follows:

Option Alias Arguments Default Description
--install -i Boolean false Specifies if you would like to install npm packages automatically after creating the project. You can also specify which package manager to use: npm, yarn, or pnpm.
--name -n Name of the selected template Defines the name of the resulting directory.
--template -t n/a Specifies which example project you would like to start off with.
--database-url -d n/a Specifies the database URL you would like to use for the project.
--vscode -v Boolean (optional) false Adds a .vscode folder with an extensions.json file suggesting the Prisma VS Code extension.

Examples

Selecting a template and installing packages

You would like to use the template named orm/grpc, and install packages automatically:

npx try-prisma -t orm/grpc --install

In this scenario, you will still be prompted to input values for your preferred package manager and the name of the resulting folder.

Selecting a package manager

If you wanted to use yarn to install the packages automatically:

npx try-prisma -i yarn

Selecting a folder name

You can create a new project in the current directory by executing the following:

npx try-prisma -n new_folder

All of the options!

Interactive terminal who?? Use all the options!

npx try-prisma -t orm/grpc -i pnpm -n my_project