cli-tool

CLI Tool

This example demonstrates how to implement a data store with Prisma for a CLI tool (In this case a simple todo list).

Get started

Note: prisma is listed as a development dependency and script in this project's package.json. This means you can invoke the Prisma CLI without having it globally installed on your machine (by prefixing it with yarn), e.g. yarn prisma deploy or yarn prisma playground. If you have the Prisma CLI installed globally (which you can do with npm install -g prisma), you can omit the yarn prefix.

1. Download the example & install dependencies

Clone the Prisma monorepo and navigate to this directory or download only this example with the following command:

curl https://codeload.github.com/graphcool/prisma/tar.gz/master | tar -xz --strip=2 prisma-master/examples/cli-tool

Next, navigate into the downloaded folder and install the NPM dependencies:

cd cli-tool
yarn install

2. Deploy the Prisma database service

You can now deploy the Prisma service (note that this requires you to have Docker installed on your machine - if that's not the case, follow the collapsed instructions below the code block):

yarn prisma deploy

I don't have Docker installed on my machine

To deploy your service to a public cluster (rather than locally with Docker), you need to perform the following steps:

1. Remove the cluster property from prisma.yml
2. Run yarn prisma deploy
3. When prompted by the CLI, select a public cluster (e.g. prisma-eu1 or prisma-us1)
4. Replace the endpoint in index.js with the HTTP endpoint that was printed after the previous command

3. Explore the CLI Tool

The Prisma database service that's backing your GraphQL server is now available. This means you can now start to test the CLI Tool:

Add a Todo item

node index.js add First todo item

List all Todo items

node index.js list

Delete a Todo item

node index.js delete First todo item