History

Gabriel F 9870faf789 Fix export function name on docs/routing/layouts-and-templates (#65240 ) ### What? Fix export function name on docs/routing/layouts-and-templates ### Why? The way it is, it will return an error to the user following the tutorial: `Unsupported Server Component type: undefined / next js 13` ### How? - Change `Links()` function export to `NavLinks()` --------- Co-authored-by: JJ Kasper <jj@jjsweb.site>		2024-05-01 11:20:45 -07:00
..
app
lib
.env.example
.gitignore
next.config.mjs
package.json
postcss.config.js
README.md
tailwind.config.ts
tsconfig.json

README.md

Turso

Turso is a SQLite-compatible database built on libSQL, the Open Contribution fork of SQLite. It enables scaling to hundreds of thousands of databases per organization and supports replication to any location, including your own servers, for microsecond-latency access.

Features

Uses SQLite dev.db locally
App Router
Server Actions

How to use

You can run this example locally using SQLite. The example will automatically create a todos table using the file dev.db.

Create a new Next app using the with-turso example:

npx create-next-app --example with-turso with-turso-app

yarn create next-app --example with-turso with-turso-app

pnpm create next-app --example with-turso with-turso-app

Then install the dependencies and run the Next.js development server:

npm install
npm run dev

# or

yarn install
yarn dev

# or
#
pnpm install
pnpm dev

You should now be able to go to http://localhost:3000.

Deploy to Vercel

You can deploy this app to Vercel in a few simple steps:

Signup to Turso

Install the Turso CLI and login using GitHub:

# macOS
brew install tursodatabase/tap/turso

# Windows (WSL) & Linux:
# curl -sSfL https://get.tur.so/install.sh | bash

Create a database

Begin by creating your first database:
```
turso db create [database-name]
```

Create a table

Connect to the turso shell and create your first table:

turso db shell <database-name>

CREATE TABLE todos(id INTEGER PRIMARY KEY AUTOINCREMENT, description TEXT NOT NULL)

Retrieve database URL

You'll need to fetch your database URL and assign it to TURSO_DB_URL on deployment:
```
turso db show <database-name> --url
```
Create database auth token

Now create an access token and assign it to TURSO_DB_TOKEN on deployment:
```
turso db tokens create <database-name>
```
Deploy to Vercel