Create Tigris App

The simplest way to get started with Tigris is by using create-tigris-app. This CLI tool lets you quickly start building a new application with Tigris as the backend. You can create a new app using one of the templates.

Interactive

You can create a new project interactively by running:

npx create-tigris-app@latest

You will be asked for the name of your project, and the clientID and clientSecret to connect with Tigris.

✔ What is your project named? … myapp
✔ What is the clientId? … my_client_id
✔ What is the clientSecret? … *********
✔ Pick the template › nextjs-api-routes
Creating a new app in /Users/ovaistariq/projects/myapp.

Downloading files for example nextjs-api-routes. This might take a moment.


Initializing project with template: nextjs-api-routes

Using npm.

Installing dependencies:
- @next/font: ^13.0.6
- @tigrisdata/core: latest
- next: ^13.0.6
- react: ^18.2.0
- react-dom: ^18.2.0
- reflect-metadata: ^0.1.13


added 314 packages, and audited 315 packages in 6s

91 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities
Initialized a git repository.


Success! Created myapp at /Users/ovaistariq/projects/myapp

Inside that directory, you can run several commands:

  npm run dev
    Starts the development server.

  npm run build
    Builds the app for production.

  npm start
    Runs the built app in production mode.

We suggest that you begin by typing:

  cd myapp
  npm run dev

Non-interactive

You can also pass command line arguments to set up a new project non-interactively. See create-tigris-app --help:

Usage: create-tigris-app [options]

Options:
  -V, --version                 output the version number
  --use-npm
    Explicitly tell the CLI to bootstrap the app using npm

  --use-pnpm
    Explicitly tell the CLI to bootstrap the app using pnpm

  -e, --example [default, nextjs-api-routes, rest-express]
    An example to bootstrap the app with. You can use one of the
    templates from the create-tigris-app repo

  -p, --project [name]
    The name of the project. This will be used to derive the
    project directory name and the package name

  -i, --client-id [id]
    The clientID project will use to connect to Tigris

  -s, --client-secret [secret]
    The clientSecret project will use to connect to Tigris

  -h, --help                    display help for command