aa45ebc769
Fresha-style booking: shops sign up, add services/therapists/hours, and get a public booking page they can drop into their Google Business Profile so customers book from Maps. Deposits via Stripe stop no-shows. Stack: Hono + Cloudflare Workers + D1 + Stripe, server-rendered HTML. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
77 lines
2.8 KiB
Markdown
77 lines
2.8 KiB
Markdown
# 💆 Kneadly
|
|
|
|
Online booking for massage & bodywork shops — a lightweight Fresha alternative.
|
|
Each shop gets a public booking page they can drop straight into their **Google
|
|
Business Profile** so customers book them from Google Maps.
|
|
|
|
Live: https://kneadly.theradicalparty.com
|
|
|
|
## What it does
|
|
|
|
- **Shop owners** sign up → instantly get a booking page at `/<shop-slug>`
|
|
- Add **services** (duration + price), **therapists**, and per-therapist **weekly hours**
|
|
- **Customers** browse → pick service → pick therapist (or "anyone available") →
|
|
pick a time → pay a deposit → booked
|
|
- **Deposits** (a configurable % of price) are taken via Stripe Checkout to stop no-shows;
|
|
cancelling refunds automatically
|
|
- **Owner dashboard**: bookings list, mark complete / no-show / cancel+refund, edit
|
|
services / staff / hours / settings
|
|
- **Google Maps ready**: every shop page emits `schema.org` `HealthAndBeautyBusiness`
|
|
+ `ReserveAction` JSON-LD, and the dashboard hands owners the exact URL to paste into
|
|
their Google Business Profile "Appointment links" field
|
|
|
|
## Stack
|
|
|
|
Hono · Cloudflare Workers · D1 (SQLite) · Stripe · zero client framework (server-rendered HTML)
|
|
|
|
## Layout
|
|
|
|
```
|
|
src/
|
|
index.js router, session middleware, favicon/OG/robots/sitemap
|
|
lib/
|
|
auth.js PBKDF2 password hashing, sessions
|
|
stripe.js tiny Stripe REST client (checkout, refunds, webhook verify)
|
|
slots.js timezone-aware slot generation
|
|
booking.js eligible-staff + availability logic (shared by API & booking)
|
|
views.js layout + design system (spa aesthetic)
|
|
routes/
|
|
auth.js signup (creates owner + shop + default therapist) / login / logout
|
|
public.js landing page, shop pages, booking flow, confirmation
|
|
dashboard.js owner dashboard (overview, bookings, services, staff, settings)
|
|
api.js /api/slots — available dates & times
|
|
webhooks.js /webhooks/stripe — confirm booking on payment
|
|
schema.sql D1 schema
|
|
```
|
|
|
|
## Develop
|
|
|
|
```bash
|
|
npm install
|
|
npm run db:migrate:local # apply schema to local D1
|
|
npm run dev # wrangler dev
|
|
```
|
|
|
|
## Deploy
|
|
|
|
```bash
|
|
npm run db:migrate # apply schema to remote D1
|
|
npm run deploy # wrangler deploy
|
|
```
|
|
|
|
### Stripe (deposits)
|
|
|
|
Deposits are optional — with no Stripe key set, bookings confirm instantly (no payment).
|
|
To enable deposits, set the platform Stripe secrets:
|
|
|
|
```bash
|
|
npx wrangler secret put STRIPE_SECRET_KEY
|
|
npx wrangler secret put STRIPE_WEBHOOK_SECRET
|
|
```
|
|
|
|
Then add a webhook endpoint in Stripe pointing at
|
|
`https://kneadly.theradicalparty.com/webhooks/stripe` for the
|
|
`checkout.session.completed` and `checkout.session.expired` events.
|
|
|
|
> Deposits currently settle to the platform Stripe account. Per-shop payouts via
|
|
> Stripe Connect is the natural next step.
|