// APP STORE — ENGINEERING REPORT 🔥

Catalog (live)

These three counters are populated by store.js from the live PRODUCTS catalog, the same code path the storefront uses — so they never go stale.

Composition by category // snapshot

Paid products are licensed per major version. Free products download from GitHub releases/latest, or the repo's /tags page when no release exists.

Paid roster & tiers // snapshot

39 paid products — 17 Desktop Apps, 3 Audio Plugins, and 19 Publications — each with one or two license tiers. The first tier is the default selection and sets the card price; every tier licenses the current major version.

Tier data lives in each product's tiers array in store.js. The detail page renders the tier picker; the card shows the first tier's price plus a per major version label.

Free families // snapshot

85 free / OSS products (one Open Source tier at $0; mostly MIT, with a few MPL-2.0). Three construction styles keep the catalog DRY:

This table groups by how the catalog object is built (object literal vs strykePkg() vs metaProduct()), not by display category — so its rows are orthogonal to the composition-by-category table above. Sum: 18 + 30 + 37 = 85 free / OSS.

Published documentation sites // snapshot

59 products list a GitHub Pages docs site (the DOC_REPOS array in store.js). Each detail page renders doc-cards from these entries:

• Documentation — menketechnologies.github.io/<id>/, for all 59.
• Engineering Report — <base>/report.html, for all 59.
• API Reference — <base>/reference.html, only for the ids in DOC_REFERENCE: strykelang and zshrs.

Proprietary products (audio-haxor, traderview, ztranslator, zpwr-daw) and the Pages-disabled audio plugins (zpwr-fx, zpwr-synth, zpwr-midi-fx) are intentionally absent so no Docs link 404s. The three audio plugins instead ship docs[] entries pointing at a per-plugin block catalog PDF (only the blocks that plugin ships) plus the shared full zpwr-patch-core-block-catalog.pdf, which render alongside the HTML doc-cards.

Checkout & discounts // snapshot

The checkout reads the cart from localStorage (appstore-cart) and computes subtotal, discount, and total client-side. Two discount codes ship in the DISCOUNTS map:

A discount never exceeds the subtotal (discountAmount() clamps with Math.min). completeOrder() simulates a confirmed order — no real charge happens; the integration points are marked INTEGRATION HOOKS: in wireCheckoutPage().

Source metrics // snapshot

No frameworks, no build step, no runtime dependencies — vanilla HTML/CSS/JS served statically.

Test coverage

A dependency-free node:test suite (20 tests in test/store.test.js) loads store.js into a minimal DOM/localStorage shim and asserts on the rendered HTML — the same surface a browser would paint. Coverage areas:

• Parse & render — store.js parses and renders the grid into #productGrid.
• Catalog size and uniqueness — product count matches the live hero stat, all ids unique.
• Free-vs-paid wiring — free cards expose a well-formed GitHub download URL (releases/latest or /tags); paid cards expose add-to-cart.
• Pricing copy — every paid surface shows "per major version"; no stale "one-time" / "lifetime" wording remains.
• Detail completeness — every product page renders an overview and rich features, with no template leaks.
• Paid vs free detail — paid pages have the tier picker, add-to-cart, and the per-major-version note; free pages have the download CTA and neither.
• Private-repo products do not render a public "Source" link.
• Published doc sites — only listed ids link GitHub Pages, and an API Reference appears only where DOC_REFERENCE declares it.
• Checkout — line items and per-major-version totals compute correctly from a seeded cart.
• Screenshots — every referenced asset resolves on disk, is WebP, is size-budgeted, has no orphans; galleries use sequential indices with one caption + alt each.
• GUI vs non-GUI — screenshot hero/grid/gallery appear on exactly the GUI products; others keep the glyph thumbnail.
• Hero stats match the rendered grid (category and free counts), and the detail hero shows the full screenshot (no cover-crop).
• Lightbox keyboard navigation is wired in source; every grid card exposes name, category, tagline, and a price.
• HTML pages reference the shared assets and expose the expected mount points.

Run locally with node --test.

Continuous integration

.github/workflows/ci.yml runs on every push and pull request:

• node --check on store.js and hud-theme.js.
• The full node --test storefront suite.
• An HTML sanity check — doctype present and balanced <script> tags on every page.

Runs free on GitHub Actions because the storefront repo is public.

Engineering decisions

• One catalog, derived UI. PRODUCTS is the single source of truth; grid, filters, stats, detail pages, and downloads are all derived — no hardcoded counts.
• Generated families. The 30 stryke packages and the zsh-plugin family are generated from compact tables (strykePkg, metaProduct) instead of repeated objects.
• Long-form copy in DETAILS. Overviews and feature lists are ported from each repo's README / source and merged in at load, keeping identity and copy separated but unified.
• Per-major-version pricing replaces one-time licensing across all paid products.
• Forks excluded. Third-party projects mirrored in the org are not storefronted, to avoid misattribution.
• Private-repo safety. Proprietary paid products omit the public "Source" link so visitors never hit a 404.
• Tag-download fallback. Repos without a release link to their /tags page rather than a dead release URL.