Changelog
Every release
What changed in each version, newest first. Pulled from GitHub Releases.
-
feat(orders): refund part of an order without cancelling it #336
feat(orders): a printable invoice per order, with the business details it needs #337
feat(customers): export and erase a customer's personal data #339
feat(storefront): a cookie banner that holds back analytics and marketing scripts until the visitor agrees #340
perf(admin-ui): lists draw the right thing before their rows load #412
docs: npx-first README and quickstart, new docs home #319
refactor(admin-ui): one page layout for lists, themes and apps #410
- feat(db): guard the embedded database against queries that freeze it, and fix the two it found #322
- feat(log): a logger with the shape of pino, used by payments and email #329
- feat(orders): cancel unpaid orders nobody is paying after a time limit the shop sets #231
- feat(auth): share login-code limits through the database, add a per-visitor cap and limit code checks #233
- feat(cli): shopnex migrate-db moves a shop from the embedded database to PostgreSQL #351
- feat(rpc): errors made with defineError answer with their own status #374
- fix(payments): ordering with a payments app froze the shop on the embedded database #320
- fix(security): close five CodeQL alerts (slug regex, sort dropdown redirect, test assertion) #332
- fix(stripe): end the order's older open Checkout Sessions when a new payment starts #333
- fix(db): the guard also refuses a new transaction opened on the shared handle inside a transaction #326
- fix(money): keep amounts in the currency's smallest unit (#341) #344
- fix(admin): reload when a deploy removed the JS chunk a tab asks for #382
- docs: keep one copy of the Storefront API and Webhooks docs, on the docs site #335
- test: embedded-database checkout regression, and Stripe app payment and refund tests #321
- chore(lint): strict rules and no shared db for modules/drafts, a module at a time #323
- chore(lint): strict rules and no shared db for modules/custom-fields, with tests #325
- test(e2e): a payload contract test for every webhook topic #314
- refactor(app): serve app icons from the SDK, from real SVG files #215
- chore(lint): strict rules for modules/auth, with sign-up and setup tests #328
- test: two lines of one variant, refunds left pending, order paid twice; invariants updated #334
- refactor(create-shopnex): move shared code into @shopnex/cli-core #349
- ci(cli): run shopnex migrate-db against a real PostgreSQL #352
- ci(api): fail pull requests that break the public API #353
- ci(lint): apps import only the public packages #357
- refactor: log with @shopnex/log instead of console, and lint for it #358
- chore: typecheck at most four workspaces at a time #362
- refactor(custom-fields): the module owns its table #359
- refactor(custom-fields): the module owns its admin routes (stacked on #359) #361
- refactor(modules): defineError, and custom-fields uses it (stacked on #361) #364
- ci: the admin UI's browser bundles stay free of server code #366
- refactor(pricing): the table of a discount's use is orders', and pricing takes the connection #367
- refactor(pricing): the module owns its tables, errors, contract, routes and manifest #368
- refactor(files): tests first, then the module owns its tables, errors, contract, routes and manifest #369
- refactor(rpc): rpc no longer depends on auth, apps or tenancy #370
- refactor(drafts): the module owns its table and error, with a manifest #371
- refactor(theme): tests first, then the module owns its tables, contract, routes and manifest #372
- chore: harden the module conversions (error mapping, test guard, module check, tooling) #373
- test(payments): pin the payment sessions, the app's methods and refunds #375
- refactor(payments): the module owns its tables, contract, routes and manifest #376
- test(webhooks): pin the signing, emit, endpoints and the delivery worker #379
- test(ai): pin the providers, running a capability, feedback and the settings #377
- refactor(webhooks): the module owns its tables, contract, routes and manifest #380
- refactor(ai): the module owns its tables, contract, routes and manifest #378
- test(auth): pin the sign-up policy, open sign-up caps, the sign-in code gate and rate limits #381
- ci: run the unit tests and the browser tests as their own jobs, in parallel #383
- refactor(auth): the module owns its tables and has a manifest #384
- test(tenancy, channels): pin shops, members, tokens, keys, staff, domains and the sales channels #385
- refactor(tenancy, channels): the modules own their tables, contract, routes and manifest #386
- test(apps): pin the OAuth flows, installs and uninstalls, session tokens, app data and the instance key #387
- refactor(apps): the module owns its tables, contract, routes and manifest #388
- ci: run a test shard once more when a test process died inside V8 #389
- test(content): pin the pages and menus #390
- refactor(content): the module owns its tables, contract, routes and manifest #391
- refactor(core): the tables every module points at move into @shopnex/core #392
- refactor(core): scope helpers move to core, and two hooks become direct calls #393
- refactor(core): import the foundation tables from @shopnex/core, and drop db's re-export #394
- test(catalog): pin products, variants and collections #395
- refactor(catalog): the module owns its tables, contract, routes and manifest #397
- refactor: break the cycles that keep the commerce group from becoming modules #398
- refactor(email): the module owns its tables, contract, routes and manifest #401
- refactor(cart): the module owns its tables, contract, routes and manifest #402
- refactor(orders, customers): the modules own their tables, contracts, routes and manifests #403
- refactor: the last tables leave db, the shims go, and modules:check enforces the structure #404
- refactor(storefront): the public Storefront API is a module #405
- chore(lint): eight more modules join the strict set #407
- refactor: content, customers and privacy take the connection from their caller #408
- refactor: catalog, orders, cart and email take the connection from their caller #409
- chore(admin-ui): drop 'use client' from every file #411
- test(e2e): the order confirmation check does not depend on which worker sent it first #413
- test(e2e): rounding to the cent, and staff refused on owner screens in the admin #396
- chore: release 0.16.0 #415
-
feat(email): abandoned cart emails #249
feat: custom fields on products, orders and customers #251
feat: create-shopnex, one command to start ShopNex on the embedded database #282
feat: make ks-bootshop the default storefront theme, in the Forest style #287
feat: add sample products from the empty Products page instead of seeding at signup #286
docs: generate API scopes and webhook reference from the code #252
docs: smaller storefront screenshot for the README #297
- feat(admin): session replay on the public demo only #271
- feat(themes): show the storefront custom fields on the product page #276
- feat(db): embedded PGlite database (DATABASE_URL=pglite:<folder>) #278
- feat(create-shopnex): a shop folder (default ./shopnex) and --with stripe,cj,shippo #289
- feat(create-shopnex): the shop's settings in <shop>/.env, so DATABASE_URL can point at PostgreSQL #290
- feat(admin): noindex login, signup and admin pages #292
- feat(docs): show the ShopNex version in the sidebar footer #295
- feat(apps): keep app data in Postgres with Drizzle instead of SQLite #302
- feat(webhooks): inventory.updated when a tracked variant's stock changes #272
- feat(create-shopnex): a new shop folder gets a .gitignore and a docker-compose.yml #315
- fix(release): rebuild the landing from the release workflow #246
- fix(admin): save custom fields with the product's own Save #275
- fix(admin): keep the table's select column from shrinking #277
- fix: HEALTHCHECK on the shopnex image (502 during redeploy) #288
- fix(docs): add Stripe and CJ Dropshipping app pages, redirect the old plugin URLs #293
- fix(docs): 301 /getting-started to /docs/quickstart, clear docs home title #294
- fix(admin): load the sidebar's installed apps with the layout #296
- fix(apps): embedded apps follow the admin's theme and colours #301
- fix(admin): install apps without a full page load #300
- fix(install): the installer makes the Stripe app's private key #303
- fix(signup): Google and GitHub sign-up create the shop like the email form #305
- fix(auth): provider buttons work again after cancelling at the provider #308
- fix(signup): create the shop when the account is created, for every sign-up path #306
- fix(admin): sign-in and sign-out no longer flash a blank page or drop the loading state #307
- fix(admin): the welcome step no longer renders inside the sidebar layout #312
- fix(ci): the upgrade test builds deploy/Dockerfile #313
- fix(ci): browser tests no longer wait on the internet #316
- docs: generate the modules list and quoted numbers from the code #253
- docs: typecheck the TypeScript samples #254
- docs: add a short 'Why I built this' section to the README #273
- docs: npx create-shopnex@latest in the quick start, and why you can trust it #285
- docs: replace the PRs welcome badge with a Discord badge #299
- ci: upgrade test from the previous release keeps all seeded data #247
- refactor: APP_URL and SHOPNEX_SECRET replace BETTER_AUTH_URL and BETTER_AUTH_SECRET #248
- chore: roadmap now lives in the GitHub project, drop roadmap.yml #255
- ci: publish the e2e results and Playwright report from main #269
- ci: run the demo deploy in the Production environment #274
- ci: publish create-shopnex with npm trusted publishing instead of a token #284
- ci: give the workflows names that say what they do #283
- chore: make the repo root more compact #291
- ci: don't let an unreachable apt mirror fail the browser tests #309
- chore: release v0.15.0 #317
- Revert "feat(db): an embedded PGlite database (#278)" #280
- Reapply "feat(db): an embedded PGlite database (#278)" #281
-
feat(admin): platform page listing every shop and user (super admins) #221
feat(checkout): simpler checkout: full summary beside the form, optional fields collapsed #222
feat: Shippo shipping app and carrier install card in Settings → Shipping #188
feat: default banner images for the themes #197
feat: real photos for the sample products #198
feat: a calmer default banner photo for the Maison theme #199
feat(admin): ShopNex logo loader while a theme preview loads #208
- feat(app): typed Admin API client from generated types #214
- feat(admin): brand chart colors, readable empty chart axis, simpler header #223
- fix(apps): report a marketplace app's install before telling the app #218
- fix(cj): make the paid-order subscription setup safe to run twice at once #219
- fix(deploy): keep X-Forwarded-Proto from the TLS-terminating proxy (mixed-content cart error) #220
- fix(stripe): refuse a paid event whose amount or currency differs from what was asked #229
- fix(catalog): stock and variant helpers take shopId first and filter by shop #241
- docs: move the roadmap to a data file that feeds shopnex.ai/roadmap #210
- docs(roadmap): add the gradual-adoption items #224
- docs: list the rules that must always hold, and which of them a test would notice #235
- docs: show the real module dependency graph in architecture.md #240
- refactor(admin): make server functions authorize by default #212
- ci: rebuild the landing site when the roadmap or a release changes #213
- test(e2e): cross-shop access by id, with a route coverage check #230
- chore: pnpm roadmap:publish, publish a roadmap edit as a self-merging PR #228
- style: run prettier on the 14 tracked files that failed format:check #239
- test(e2e): every Admin API route refuses a caller who has not proved who they are #232
- chore: release v0.14.0 #244
- chore: point demo at demo.shopnex.ai #192
- feat: fulfilledBy on products, sent to carrier apps #189
- chore: trigger the demo deploy through the Dokploy webhook #193
- feat: declare the responses of the admin routes #194
- feat: publish the Shippo app image and add it to the deploy compose files #195
- feat: derive the storefront URL from a shop's domains in multi-tenant mode #196
- feat(admin): PostHog autocapture for opted-in elements only #200
- fix: disable the managed Storefront URL field #201
- docs: add a 512px PNG of the logo #203
- fix(deploy): serve /admin only on the main host in multi mode #205
- perf(storefront): cache the preview script and unversioned theme assets #207
- ci: group release notes by label and label PRs from the title prefix #209
- fix(deploy): ADMIN_HOST names the admin's host, so the /admin redirect works behind a proxy #206
-
A smoother first run: the setup wizard now asks for your shop name and currency, and the dashboard shows a Getting started checklist.
New shops come with a main and footer menu, sample products that have images, and in multi-shop mode a random subdomain, with sign-ups rate-limited. The self-hosting docs were reworked, with a Dokploy template.
New features and improvements 11
Create a default main menu for new shops #155
First-run: shop name and currency step, plus a Getting started checklist #154
Name the shop in the welcome step for multi-shop sign-up too #184
Give new shops a random subdomain handle and start sign-ups as My Shop #187
- Print a ready banner with the URLs to open after startup #152
- Move the API reference link from the sidebar to Settings → Developers #159
- Seed a footer menu for new shops #163
- Pass TENANCY_MODE, OPEN_SIGNUP and ROOT_DOMAIN through the deploy compose files #175
- Rate limit open sign-up per address and for everyone #177
- Route multi-shop hosts to ShopNex from the Dokploy compose, and document it #176
- Send the admin host's front page to /admin in multi mode #178
Fixes 11
- Count carrier services as shipping set up, and show CJ's real on/off state #158
- Fix PostHog dropping every admin event (respect_dnt: false) #160
- Point one-click deploys at main instead of the removed v2 branch #167
- Publish a new shop's sample products on its Online Store #171
- Answer 404 for a host no shop is served on #172
- Hide bundled apps that can't run from the installed apps list #173
- Attach the Dokploy compose services to dokploy-network #174
- Give the sample products an image #182
- Don't make up a shipping rate and payment method for new shops #185
- Say what went wrong when an OAuth sign-in fails #181
Documentation 7 Show
- Refresh README: positioning, demo link, storefront screenshot #151
- Compress README storefront screenshot #153
- Document the release cadence #156
- Rework self-hosting docs and add a Dokploy template #166
- Show verification status and an issue link on every page #168
- List the bundled apps' real ports in the local ports table #179
- Point the README live demo link at app.shopnex.ai #183
Under the hood 3 Show
Older releases 8 Show
-
Built-in AI for product descriptions and SEO text, using your own API key.
Each shop is now served at its own subdomain in multi-shop mode. Stripe payments that arrive late are accepted and card declines are recorded, and stored secrets and preview tokens use a new SHOPNEXSECRET.
New features and improvements 5
Fixes 4
-
Customer accounts (sign in with an emailed code, order history) and product search and filters on the storefront.
Multi-shop gets self-serve sign-up, a shop switcher and a domains page with DNS verification. The admin has a ⌘K search, and the project now runs Playwright browser tests in CI.
New features and improvements 14
- Add View store link to admin header #110
- More visible Delete button in settings edit dialogs #108
- Domains page with DNS verification #118
- Self-serve signup and shop provisioning (multi-tenant) #119
- Shop switcher in the admin sidebar #120
- Global search palette (⌘K) #117
- Dokploy compose file without published ports #123
- Turn on Caddy automatic HTTPS when DOMAIN is set #125
- Serve the bundled Stripe and CJ apps over HTTPS when DOMAIN is set #126
- Send apps an app.installed event; Stripe registers its payment method on install #128
- Add Google and GitHub sign-up buttons to the admin signup page #130
- Add customer accounts: sign in with an emailed code, order history #127
- Storefront API: product search, filters and facets #131
- Search and filters #132
Fixes 3
Documentation 1 Show
- E2e testing plan and roadmap #111
Under the hood 6 Show
- Playwright browser tests (phase 1 of the e2e plan) #112
- Unit tests for pricing, orders and payments modules #114
- More money helper cases (follow-up to #76) #78
- Push :edge images for the Stripe and CJ apps #121
- Use a fixed internal database password in deploy compose #124
- Orders: add --wipe to clear all orders before seeding #129
-
- fix(cj): read CJ stock, which imported as 0 for every variant #91
- fix(deploy): point the admin at the bundled storefront by default #89
- feat(admin): collections edit on a page instead of a modal #94
- fix(cj): open the settings page before My Products loads #96
- feat(admin): one app catalog, installed apps in the sidebar, marketplace in settings #98
- style(admin-ui): format with prettier #99
- feat(stripe): copy button for the stripe listen command #92
- fix(apps): bundled apps are their own source, not 'custom' #100
- feat(apps): list payments apps (Stripe) in Discover #102
- fix(admin): install page layout and button flicker #101
- chore: release v0.11.0 #103
-
- Bump package versions to 0.9.1 #42
- Center the no-access message for settings and apps #43
- test(marketplace-sdk): add unit tests for key handling #53
- test(marketplace-sdk): add unit tests for session tokens #54
- docs: add storefront SDK README #55
- Run workspace typecheck in parallel #56
- CI: run unit tests, cancel superseded runs, skip heavy jobs for docs-only PRs #57
- Add ks-bootshop theme (Bootstrap 5) #58
- Fix MenuGroupContext error in the account menu #59
- CI: dependency review, Dependabot, format check on changed files #60
- Add a README for @shopnex/app #68
- Add carrier services: apps quote live shipping rates at checkout #72
- docs: add marketplace SDK README #74
- test(storefront-sdk): add unit tests for cart helpers (#50) #75
- test(storefront-sdk): add unit tests for money helpers (#49) #76
- test(storefront-sdk): cover more cart failure paths (follow-up to #75) #77
- Add CJ Dropshipping app, @shopnex/cj-sdk, and an Available apps card #71
- docs(app-bridge): add README with usage example and docs link (#46) #80
- feat(deploy): make docker compose up work with no setup #81
- ci(release): publish multi-arch images (amd64 + arm64) #82
-
- Tag releases as latest and attach image archives #41
-
- Per-app containers: Dockerfile.app, compose, and a local SQLite store for apps #29
- Improve theme editor page previews #30
- Keep rich editor sizing consistent across modes #31
- Add generic entity drafts; move theme code onto them #35
- Add sales channels with per-channel publishing #36
- Publish versioned Shopnex and Stripe images #34
- Update notice, Compose installer and one-click updates #37
- Harden the installer and updater #38
- Fix API reference failing to load behind a TLS-terminating proxy #40