mirror of
https://github.com/shishantbiswas/bknd-examples.git
synced 2026-03-15 18:01:06 +00:00
Shishant Biswas
95a9a62704
All checks were successful
Build and Push to Gitea Registry / build-and-push (push) Successful in 6m40s
55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# bknd + Tanstack Start Example
|
|
|
|
This is a minimal example to shows how to integrate bknd with Tanstack Start.
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
bun install
|
|
bun run dev
|
|
```
|
|
|
|
## How it works
|
|
|
|
1. **`bknd.config.ts`** - bknd configuration with database connection, schema, and seed data
|
|
2. **`src/routes/api.$.ts`** - Handles `/api/*` requests for bknd
|
|
3. **`src/routes/index.tsx`** - Using `getApp()` to fetch data in loader
|
|
3. **`src/routes/ssr.tsx`** - Server Side example with `getApp()` to fetch data on server
|
|
|
|
## Directory Structure
|
|
|
|
```txt
|
|
├── bknd.config.ts
|
|
├── bun.lock
|
|
├── docker-compose.yml
|
|
├── Dockerfile
|
|
├── package.json
|
|
├── public
|
|
├── README.md
|
|
├── src
|
|
│ ├── bknd.ts # bknd singleton initialization
|
|
│ ├── logo.svg
|
|
│ ├── router.tsx
|
|
│ ├── routes
|
|
│ │ ├── api.$.ts # bknd API handler
|
|
│ │ ├── admin.$.tsx # Admin Dashboard
|
|
│ │ ├── index.tsx # Client Side Rendering example
|
|
│ │ └── ssr.tsx # Server Side Rendering example
|
|
│ │ ├── __root.tsx
|
|
│ ├── routeTree.gen.ts
|
|
│ └── styles.css
|
|
├── tsconfig.json
|
|
└── vite.config.ts
|
|
```
|
|
|
|
|
|
## API Endpoints
|
|
|
|
- `GET /admin` - for Admin Dashboard
|
|
- `GET /api/data/entity/todos` - List todos (requires auth)
|
|
- `POST /api/auth/password/login` - Login
|
|
|
|
## Test Credentials
|
|
|
|
- Email: `test@bknd.io`
|
|
- Password: `12345678` |