your personal website on atproto - mirror
blento.app
1# Contributing Guidelines
2
3For new cards see [CustomCards](CustomCards.md) and [CardIdeas](CardIdeas.md).
4
5## Setup
6
7```sh
8git clone https://github.com/flo-bit/blento.git
9cd blento
10pnpm install
11pnpm dev
12```
13
14No `.env` file required — dev uses the loopback OAuth public client, a fallback cookie secret, and `blento.app` as the default handle for `/`.
15
16Note: if cloudflare authorization website opens when running `pnpm dev` flip the `DB` binding's `"remote": true` to `false` in `wrangler.jsonc` and re-run.
17
18Individual `/handle` pages load directly from each user's PDS — no backfill needed.
19
20## Before opening a PR
21
22- `pnpm check` — must complete with 0 errors and 0 warnings (existing baseline excepted).
23- `pnpm format` — runs eslint --fix + prettier --write across the project.
24
25## Subpages
26
27In-progress changes go on a subpage so your live profile stays clean: `/your.handle/p/<page>/edit` (any `<page>` other than `edit` or `api`). Login redirects to the main page — navigate to the subpage URL manually.
28
29## AI-assisted PRs
30
31AI-assisted PRs are accepted, especially if you just create a new card, but please:
32
33- Keep diffs minimal; no unrelated cleanup or verbose code
34- Test light/dark, colored cards, edit/view, desktop and both mobile modes (screen-size and `pointer: coarse`)