https://github.com/kristianfreeman/cloudflare-d1-prisma-honox-starter
cloudflare-d1-prisma-honox-starter
https://github.com/kristianfreeman/cloudflare-d1-prisma-honox-starter
cloudflare-d1 cloudflare-workers cloudflare-wrangler hono honox prisma zod
Last synced: 6 months ago
JSON representation
cloudflare-d1-prisma-honox-starter
- Host: GitHub
- URL: https://github.com/kristianfreeman/cloudflare-d1-prisma-honox-starter
- Owner: kristianfreeman
- Created: 2024-04-12T14:19:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-25T19:25:19.000Z (12 months ago)
- Last Synced: 2025-04-20T01:12:29.894Z (6 months ago)
- Topics: cloudflare-d1, cloudflare-workers, cloudflare-wrangler, hono, honox, prisma, zod
- Language: TypeScript
- Homepage:
- Size: 202 KB
- Stars: 89
- Watchers: 5
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# cloudflare-d1-prisma-honox-starter
A starter project showing how you can integrate [Prisma](https://www.prisma.io) and [Cloudflare D1](https://developers.cloudflare.com/d1) with a [HonoX](https://github.com/honojs/honox) application to build awesome full-stack apps.
> [!TIP]
> If the above paragraph was a bunch of buzzwords that seem confusing, here's the simple version:
>
> - HonoX is a _full-stack framework_ combining _backend API endpoints_ with the ability to render _frontend applications with React_
> - Cloudflare D1 is a _SQL database_
> - Prisma provides an _ORM wrapper_ around D1, to allow data models and querying using a straightforward syntax
## Installation
0. Clone the database and install all dependencies:
```sh
$ git clone https://github.com/kristianfreeman/cloudflare-d1-prisma-honox-starter starter
$ cd starter
$ npm install
```
1. Copy the `wrangler.toml.example` file to `wrangler.toml` and fill in the necessary values:
```sh
$ cp wrangler.toml.example wrangler.toml
```
- Replace `$APP_NAME` with your Cloudflare Workers application name
- Replace `$CURRENT_DATE` with the current date like this `2022-01-01`
2. Create a new D1 database using Wrangler:
```sh
$ npx wrangler d1 create
```
_Note that if you haven't yet used Wrangler, you will be prompted to log in to Cloudflare._
Copy the output of this command, which is structured TOML configuration, into your `wrangler.toml`.
3. Create a new migration file using the `d1 migrations` subcommand:
```sh
$ npx wrangler d1 migrations create create_tables
```
4. Using Prisma's CLI, generate a SQL file based on your Prisma schema in the empty migration file you just created:
```sh
$ npx prisma migrate diff \
--from-empty \
--to-schema-datamodel ./prisma/schema.prisma \
--script \
--output migrations/0001_create_tables.sql
```
5. Generate the necessary Prisma files for Zod validations and any other configured Prisma outputs:
```sh
$ npx prisma generate
```
6. Apply the migration to your local database:
```sh
$ npx wrangler d1 migrations apply
```
7. When you're ready, deploy your application:
```sh
$ npm run deploy
```
8. Once you've deployed your application, you can apply the migrations to your remote (production) D1 database:
```sh
$ npx wrangler d1 migrations apply --remote
```