Tend your corner of the atmosphere. spores.garden turns your AT Protocol records into a personal site with unique themes. Your data never leaves your PDS. Grow something that's truly yours.
spores.garden
Contributing#
Setup#
npm install
npm run dev
Optional local config:
cp .env.example .env.local
Quality Gates#
Before opening a PR:
npm run typecheck:strict
npm run test:run
npm run build
Optional browser smoke tests:
npm run test:e2e
If Playwright is not installed yet, run:
npm install --save-dev @playwright/test
npm run e2e:install-browsers
Or run everything at once:
npm run check
Branch + PR Workflow#
- Branch from
main. - Keep each branch focused to one change set.
- Use clear, imperative commit messages.
- Open PRs against
mainand request review before merge. - Use
.github/pull_request_template.mdwhen opening PRs.
Code Style#
- TypeScript ES modules.
- 2-space indentation and semicolons.
- Kebab-case filenames in
src/. - Keep UI behavior changes covered by tests where practical.
Documentation#
Update docs together with behavior changes:
readme.mdfor user-facing behavior and commands.docs/for implementation details and migration plans.docs/architecture.mdfor module and system-boundary changes.SECURITY.mdwhen vulnerability process or security contact changes.CODE_OF_CONDUCT.mdwhen community/reporting process changes.