https://github.com/yusukebe/cloudflare-d1-drizzle-honox-starter
cloudflare-d1-drizzle-honox-starter
https://github.com/yusukebe/cloudflare-d1-drizzle-honox-starter
cloudflare-d1 cloudflare-pages cloudflare-workers drizzle-orm hono honox zod
Last synced: 6 months ago
JSON representation
cloudflare-d1-drizzle-honox-starter
- Host: GitHub
- URL: https://github.com/yusukebe/cloudflare-d1-drizzle-honox-starter
- Owner: yusukebe
- Created: 2024-04-18T16:23:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-18T16:48:24.000Z (over 1 year ago)
- Last Synced: 2025-03-29T06:43:04.644Z (6 months ago)
- Topics: cloudflare-d1, cloudflare-pages, cloudflare-workers, drizzle-orm, hono, honox, zod
- Language: TypeScript
- Homepage:
- Size: 5.86 KB
- Stars: 54
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# cloudflare-d1-drizzle-honox-starter
A starter project showing how you can integrate [Drizzle ORM](https://orm.drizzle.team) 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_
> - Drizzle ORM provides an _ORM wrapper_ around D1, to allow data models and querying using a straightforward syntax
## Installation
### 0. Clone the template and install all dependencies
```sh
git clone git@github.com:yusukebe/cloudflare-d1-drizzle-honox-starter.git starter
cd starter
npm install
```
### 1. Create a new D1 database using Wrangler
```sh
npx wrangler@latest d1 create d1-todo
```
_Note that if you haven't yet used Wrangler, you will be prompted to login to Cloudflare._
Copy the output of this command, which is structured TOML configuration, into your `wrangler.toml`.
### 2. Create a new migration file
```sh
npm run migration:generate
```
### 3. Apply the migration to your local database
```sh
npm run migration:apply:local
```
### 4. When you're ready, deploy your application
```sh
npm run deploy
```
### 5. Once you've deployed your application, you can apply the migrations to your remote (production) D1 database
```sh
npm run migration:apply:remote
```
## Prisma Version
You can see the starter using [Prisma](https://www.prisma.io) instead of Drizzle ORM:
- https://github.com/kristianfreeman/cloudflare-d1-prisma-honox-starter
## Author
Yusuke Wada
## License
MIT