Thomas Camlong
1fb7e16d42
Adds a PocketBase-backed marketplace where users can share custom widgets and CSS themes. Includes a Docusaurus storefront with GitHub OAuth login, submission/voting/comments, and a PocketBase SQL view that computes author names, vote counts, and comment counts without fragile hooks. The Next.js app gets a modal browser for one-click install from the marketplace plus clipboard paste-to-import on the custom widgets pages.
Homarr Store (PocketBase)
Self-hosted backend for the Homarr community store of custom CSS and custom widgets.
It handles GitHub OAuth, submissions, upvotes/downvotes, abuse reports, and screenshot
uploads. The browse/submit UI lives in the docs app at /store; Homarr installs entries
in-app by reading PocketBase's public REST API.
Run locally
cd apps/store
docker compose up
- API + dashboard: http://localhost:8090 (admin UI at
/_/) - Collections and rules are created automatically by
pb_migrations/. - Vote counters and ownership enforcement live in
pb_hooks/.
GitHub OAuth setup
- Create a GitHub OAuth app: https://github.com/settings/developers
- Homepage URL:
https://store.homarr.dev(orhttp://localhost:8090in dev) - Authorization callback URL:
https://store.homarr.dev/api/oauth2-redirect(dev:http://localhost:8090/api/oauth2-redirect)
- Homepage URL:
- Provide the credentials before the first run so the init migration wires them up:
GITHUB_CLIENT_ID=xxx GITHUB_CLIENT_SECRET=yyy docker compose up
If you start without them, GitHub OAuth is left disabled — enable it later from the admin UI under Collections -> users -> Options -> OAuth2.
Collections
| Collection | Purpose |
|---|---|
users |
Built-in auth collection, GitHub OAuth2 enabled |
submissions |
type (css/widget), title, description, content, screenshot, counters, version, changelog |
votes |
One row per (submission, user); value is 1 or -1 |
reports |
Abuse flags, moderation-only (not publicly readable) |
Submissions are auto-published. Moderate reported entries from the admin UI.
Schema versions
- Custom widgets store Homarr's
homarr-custom-widget-v2JSON incontent. - Custom CSS stores the raw stylesheet in
content, taggedhomarr-custom-css-v1.
content is validated client-side against these schemas before submission and before
install (see apps/docs/src/lib/store-schema.ts).