Turso Per User Starter

A Next.js application that demonstrates how to use the Turso Platforms API to create a database per user.

Demo

The app below uses a database per user, and is powered by Turso.

https://turso-platforms-starter.vercel.app

Prerequisites

Vercel account
Clerk account
Turso account & CLI

Get Started

Start building your Turso powered platform in a few simple steps...

Clone this repository

Begin by cloning this repository to your machine:

git clone https://github.com/notrab/turso-per-user-starter.git
cd turso-per-user-starter

Install dependencies and initialize .env

Run the following:
```
cp .env.example .env
npm install
```
Create a new SQLite schema database with Turso

Follow the instructions to install the Turso CLI, and then run the following:
```
turso db create <database-name> --type schema
```
Alternatively, you can sign up on the web, and create a new schema database from there.

Now update .env to include your organization, and schema database name:
```
TURSO_ORG_NAME=
TURSO_SCHEMA_DATABASE_NAME=
```
The TURSO_ORG_NAME can be your personal username, or the name of any organization you have with other users.
Create a new group token

Run the following:
```
turso group tokens create <database-name>
```
Now update .env to include the group token:
```
TURSO_DATABASE_GROUP_AUTH_TOKEN=
```
If you didn't already have one, a new group will be created for you with the name default.
Run database migrations

Run the following:
```
npm run db:migrate
```
If you make changes to db/schema.ts, make sure to run npm run db:generate to create the migrations, and npm run db:migrate to apply them.
Create a new Turso API Token

Run the following:
```
turso auth api-tokens mint clerk
```
Then set the API token in the .env file:
```
TURSO_USER_API_TOKEN=
```

Configure Clerk

Sign up to Clerk and create a new application.

Add your Clerk public key and secret key to the .env file:
```
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
```
Run the application

Run the following:
```
npm run dev
```
Now open http://localhost:3000 with your browser to try out the app!

Optional: Webhook setup

You can automate the creation of databases per user in the background with webhooks.

Read the wiki for more information on how to set up webhooks with Clerk during development, and production.

Deploy to Production

Make sure you have a database setup (following the steps above), the database has been migrated, and you have the environment variables available.

If you're using webhooks, make sure to update Clerk with the production URL. You will need to know the Vercel production deployment ahead of time, or re-deploy once you have it.

Read the wiki

Tech Stack

Turso for multi-tenant databases
Next.js for powerful full stack apps
Tailwind CSS for utility-first CSS
Drizzle for database migrations and ORM
Clerk for authentication
Vercel for hosting

Need help?

Join us on Discord

notrab / turso-per-user-starter