Skip to content

query-store-links/qsl-worker

Repository files navigation

Query Store Links

Query Store Links

A web UI + Cloudflare Worker that resolves Microsoft Store identifiers (Product ID, Package Family Name, Xbox Title ID, legacy CategoryId / URL) into direct download URLs for the underlying MSIX/APPX bundles, block maps, and companion files.

  • Frontend — React 19 + Vite + Fluent UI v9 (src/)
  • Backend — Cloudflare Worker wrapping the storelib_rs resolver (worker/)
  • Hosting — Cloudflare Workers Assets, deployed via Wrangler

Scripts

Script What it does
bun run dev Vite dev server with HMR
bun run build Type-check then build the SPA into dist/client
bun run preview Build, then run vite preview against the production output
bun run deploy Build, then wrangler deploy the Worker + assets
bun run lint ESLint over the workspace
bun run cf-typegen Regenerate worker-configuration.d.ts from wrangler.jsonc
bun run assets Regenerate derived icons / OG image from sources in public/

Site assets

All public-facing images live in public/ and are served as-is by the Worker.

Sources (commit these directly)

File Size Purpose
favicon.svg vector Browser favicon, in-app brand mark
qsl.png 512×512 Master for square icon variants
qsl-banner.png 1920×1200 Master for the Open Graph / social card

Generated (run bun run assets to refresh)

File Size Wired into
apple-touch-icon.png 180×180 <link rel="apple-touch-icon">
icon-192.png 192×192 <link rel="icon">, webmanifest
icon-512.png 512×512 <link rel="icon">, webmanifest
og-image.png 1200×630 og:image, twitter:image
site.webmanifest <link rel="manifest"> (hand-authored)

The generator is scripts/generate-assets.mjs (uses sharp). All metadata tags are declared in index.html.

Project layout

.
├── index.html                  # SPA shell + site metadata
├── public/                     # Static assets served at site root
├── scripts/
│   └── generate-assets.mjs     # Derives icons / OG image from public/ sources
├── src/                        # React app
│   ├── App.tsx
│   ├── api.ts                  # Worker client (NDJSON streaming)
│   ├── components/
│   ├── shared.ts               # Types + identifier detection shared with worker
│   └── styles.css
├── worker/
│   └── index.ts                # Cloudflare Worker entrypoint
│                               # (resolver: @query-store-links/storelib_rs)
├── wrangler.jsonc
└── package.json

License

See LICENSE.

About

A web UI + Cloudflare Worker that resolves Microsoft Store identifiers (Product ID, Package Family Name, Xbox Title ID, legacy CategoryId / URL) into direct download URLs for the underlying MSIX/APPX bundles, block maps, and companion files.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages