Lockpickers-United/lpu-belt-explorer
Lockpickers-United/lpu-belt-explorer has 44 GitHub stars and 11 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-22 00:30 UTC. Last push 2026-11-20.
Measured star growth
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
An interactive web app for exploring the Lockpickers United belt ranking system.
Web & AppsREADME.md
Originallpu-belt-explorer
An interactive web app for exploring the Lockpickers United belt ranking system.
Table of Contents
How To Contribute
- Data contributions
- Photos of Locks
- Submit Locks not on the site
- For other data contributions, ask in LPU Discord
- Code/Feature contributions
One of the following- Submit an issue and discuss first
- Discuss in LPU Discord #belt-explorer Channel
Getting Started (Local Setup)
- Install Node.js 24 LTS. The tested release is recorded in
.nvmrc; with nvm, runnvm installandnvm use. - Clone repo
Run locally
- On initial setup and package.json changes
- Run
npm cifrom the repository root; this installs theapps/webandapps/apiworkspaces plus root tooling. Functions retains its separate installation.
- Run
- To stand up locally
- Run
npm run dev
- Run
Package layout
apps/web: React/Vite source, public assets, tests, scripts and app config. Common root npm commands delegate here; build output isapps/web/dist.apps/api: API npm workspace. Web/API share the root lockfile, Node 24.21.0 and npm 11.19.0; runnpm ciat root. Nested installs preserve standalone API packaging. Follow itsAGENTS.md.firebase: unchanged CLI configs, rules and separately installedfirebase/functionspackage.- Web
.env.dev,.env.local,.env.productionand synthetic.env.testlive inapps/web. Vite and Vitest load that directory whether npm is invoked from root or the workspace. For local development, the owner privately supplies ignoredapps/web/.env.keys; it is excluded in test mode. Shell variables retain precedence, followed by the existing Vite mode/local-file precedence. API local configuration stays inapps/api/.env.local; production API settings remain in the host's protectedshareddirectory.
The monorepo is the sole web/API release source. The owner marked the last old API publication final and archived explore-lpubelts-com-node on GitHub (authenticated archived=true verified). Preserve that repository as history; direct API fixes and dependency changes here. Neal Bayless coordinates release/settings changes. API CI and root Dependabot cover the API workspace through the shared lockfile; retain existing GitHub protection policy. See the Phase 5 ledger for release identities, retained recovery artifacts and remaining manual-workflow gates.
Existing ignored files under the former root public/, src/ or scripts/ are left untouched and remain ignored. Clean checkout tests use tracked synthetic fixtures; review local generated data before relocating it into app-owned paths. Do not copy live exports into test fixtures.
The root keeps common development and verification shortcuts plus API/combined checks. Specialized web commands live only in apps/web/package.json: run npm run <script> --workspace=apps/web -- <args> from root, or enter apps/web and use npm run <script> -- <args>.
npm test starts both web and API Vitest suites concurrently in watch mode; npm test -- --run runs both once and fails if either suite fails. Arguments are forwarded to both suites, with file filters relative to each app. Use npm run test --workspace=apps/web or npm run test:api to watch only one app. The test:run, test:ci, and test:coverage root shortcuts remain web-only.
Focused commands from root: npm run test:run -- tests/vitest/SomeRoute.test.jsx, npm run test:api -- --run src/api/services/discordBeltRequestService.test.js, and npm run e2e -- tests/e2e/viteBundle.spec.js. For direct tool commands, enter the relevant workspace first. Browser tests build and serve the relocated app with existing loopback-only restrictions.
Github Hooks
- Web - Build & Deploy
- Enabled by Phase 5: scoped main push, successful same-repository main Import completion or manual main dispatch. A merge matching its path filters publishes Pages and uploads seven catalogs to both API environments; obtain approval for those effects.
- Action(s): Builds application from
apps/webwithnpm run ci-buildthen kicks off gh page action to deploy
- Web - Import
- Manual dispatch on main only, restored under question 23. Obtain separate approval before a live import; its successful completion triggers the existing Pages/catalog release.
- Action(s): Runs
npm run importfromapps/web, which updates the data then auto commits back to repository
- Web - PR Check
- Trigger: On Pull Request
- Action(s): Gets PR ready with
npm run ci-prwhich lints and builds application
Build/Deploy
Production publication is approval-gated. Web publication is enabled; API production deployment is manual, confirmed and main-only through .github/workflows/api-deploy-production.yml and the api-production environment. Web - Import is manual-only/main-only; each actual dispatch still requires separate approval. The development-only catalog uploader workflow has been removed. The release-only command below generates/exports artifacts and is not a validation shortcut:
npm run ci-build --workspace=apps/web
Import/Export data
Live imports/exports and administrative jobs require separate explicit approval. Web workspace npm jobs execute from apps/web; standalone legacy routines retain their existing subdirectory/CWD assumptions and require inspection before use. App-owned files use apps/web/scripts and apps/web/src/data. Preparing this move does not authorize running them. Once approved:
npm run import --workspace=apps/web
For export, run one of the following:
npm run exportCsv --workspace=apps/webnpm run exportMd --workspace=apps/webnpm run exportHtml --workspace=apps/web
There's also a Dan import
npm run import-dan --workspace=apps/web
Links
Explore related projects
Loading…