try-prisma icon indicating copy to clipboard operation
try-prisma copied to clipboard

readme-try-prisma

Tests Linting

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.

CleanShot 2022-08-31 at 13 05 29@2x

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 String (optional) false
--name -n Name of the selected template Defines the name of the resulting directory.
--path -p . Path to the directory where the new folder should be created.
--template -t n/a Specifies which example project you would like to start off with.
--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 typescript/grpc, and install packages automatically:

npx try-prisma -t typescript/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 directory and folder name

Below, you would create a new project at ../../projects/new_folder:

npx try-prisma -p ../../projects -n new_folder

All of the options!

Interactive terminal who?? Use all the options!

npx try-prisma -t typescript/grpc -i pnpm -n my_project -p ./projects