VitePress Post-V2 Documentation Update Report

Date: 2026-07-13
Repository: /Users/stel/Projects/qrcompose-docs
Product repository reviewed: /Users/stel/Projects/qrcompose

1. Git range, branches, tags, and merge history reviewed

Anchors

Anchor	Value
V2 product baseline	`35135c51` — Merged in designer-v2 (PR #5), 2025-09-26
Management V2 baseline	`0df399ce` — Merged in designer-v2-management-v2 (PR #4), 2025-09-25
Semver baseline	Tag `2.5.0` (`5ba0a851`), 2025-12-07
Product HEAD reviewed	`5aba9fdd` on `develop`, 2026-07-12
Master tip	`63714baf`, 2026-07-08
Commit span	`2.5.0..HEAD` — 486 commits

Tags reviewed

Stable: 2.4.1, 2.5.0, 2.5.1, 2.6.1, 3.1.2
RC train through 4.0.0-rc.4 (latest at review time)

Branches

develop — primary feature integration branch
master — periodic merges from develop

Key merge commits (grouped by capability wave)

Period	PRs	Theme
2025-09–12	#4–#25	V2 designer/management, autosave, onboarding, legacy designer removal, media manager
2026-01–03	#26–#38	OTP auth, QR export gating, tenant users, subscription downgrader, DB schema split
2026-03–04	#39–#68	Org platform, analytics, events remake (v3 umbrella)
2026-04+	#69–#71	Org invite emails, submission delivery, page-config AI agent
2026-06–07	#72–#83	Pay later, advanced booking, flow→app merger, events phase 2, subscription V2, event licences, portal v4, Designer V3, AI agent, v4 umbrella

Internal docs translated

docs/subscription-v2-release-qa-and-migration-checklist.md
docs/checklists/guest-portal-release.md
docs/checklists/event-licence-release.md
docs/ai-builder/production-release-qa.md

2. Grouped summary of major capabilities discovered

Subscription & billing (Subscription V2)

Permanent Free tier replaces automatic 14-day trial expiry
Preview Trial — card-backed 7-day Advanced preview from subscription settings
Feature-based publish gates (menus→Starter, bookings/payments→Advanced, API/white-label→Pro)
Entitlement reconciliation on downgrade/payment failure (selective pause/restore)
Organisation self-service vs platform-managed billing modes
Removed: Trial Upgrade API/UI

Designer V3

Canvas workspace: left panel (type picker + sections), centre preview, right inspector
Type picker groups: Popular, Business, Media & Content, Utilities
Autosave, publish targets (QR/page/both), beta chip, mobile V2 fallback

AI

AI Copilot — page-aware assistant in Designer V3 toolbar
AI Builder — /designer/build workspace with Build, Drafts, Business Memory, Experience Health, Tools
AI credits by plan (100/500/2,000/custom)

Apps (formerly Flows)

UI renamed to Apps (/apps/view, /apps/builder)
Flow→app merger (PR #74); validation rules preserved

Events platform

Event manager tabs: Overview, Programme, Attendees, Registration Desk
Attendee import/export, badge printing, QR check-in
Programme: sessions, speakers, sponsors, venue, tracks

Event licensing

Per-event Stripe licences: Essential (100), Professional (500), Business (1,000), Enterprise (custom)
Publish gated on active licence; capacity enforcement modes

Guest portal

New portal client app — OTP auth, dashboard, My Events, Connections, Profile
Digital pass, event-scoped profiles, public profile sharing (/p/:token)
Auto-provision guests on attendee create; no automated invite email at launch

Organisation admin

Org dashboard, tenants, invitations, tenant types, branding, media, templates, import

Other

OTP auth, advanced booking system, pay-later payments, org delete, submission delivery

3. Pages added (16)

File	Title
`guide/plans-and-billing.md`	Plans & Billing
`guide/designer-v3.md`	Designer V3
`guide/publish-and-draft.md`	Publish & Draft
`guide/ai-copilot.md`	AI Copilot
`guide/apps.md`	Apps
`guide/page-library.md`	Page Library
`guide/event-management.md`	Event Management
`guide/event-attendees.md`	Attendees & Registration Desk
`guide/event-licensing.md`	Event Licensing
`guide/guest-portal.md`	Guest Portal
`guide/digital-pass-and-profiles.md`	Digital Pass & Profiles
`guide/connections.md`	Connections
`guide/ai-builder.md`	AI Builder
`guide/organisation.md`	Organisation Administration
`guide/booking-system.md`	Booking System
`guide/conditional-redirects.md`	Conditional Redirects

Total markdown pages: 25 → 41

4. Pages substantially rewritten

File	Changes
`index.md`	Feature grid: Designer V3, Events platform, AI Builder; removed API/Enterprise Ready promises
`guide/introduction.md`	Product map aligned to current sidebar and capabilities
`guide/getting-started.md`	Designer V3 walkthrough, permanent Free signup
`guide/pages.md`	Designer vs Page Library vs Apps; plan requirements
`guide/qr-codes.md`	Updated paths; redirects moved to dedicated page
`guide/analytics.md`	Apps terminology; org analytics note
`guide/faq.md`	Full subscription, events, portal, AI sections
`guide/submissions.md`	Apps terminology
`components/events.md`	Scoped to event page component; cross-links to event platform
All 12 `components/*.md`	Designer V3 creation paths, Apps terminology
`customization/themes.md`	Apps cross-links; Flow→App references

5. Pages removed or deprecated

Action	Item
Deprecated stub	`guide/flows.md` — redirect page to Apps (formerly full Flows doc)
Removed	`.vitepress/config.js` — stale duplicate config
Not created	`/advanced/integrations` — API reference deferred per product-owner decision
Documented as removed	Trial Upgrade flow, legacy designer, automatic 14-day trial

Top nav (`.vitepress/config.mts`)

Added: Designer, Plans, Events, Portal

Unified sidebar constant (no duplication between /guide/ and /components/)
New sections: Designer, Plans & Billing, Apps, Events Platform, Guest Portal, AI Builder, Organisation
Customization promoted into main sidebar (collapsed)
Broken /advanced/ section removed; content distributed to Management (Booking System, Conditional Redirects)
QR Codes section expanded with Conditional Redirects child

Config cleanup

Deleted legacy config.js
All routes use single config.mts

7. Screenshots added or replaced

New screenshot files (16)

File	Intended source	Actual status
`designer-v3-workspace.png`	`/designer`	Placeholder — copied from `create-qr.png`
`designer-v3-type-picker.png`	Type picker	Placeholder — copied from `page-types.png`
`designer-v3-ai-copilot.png`	AI Copilot panel	Placeholder — copied from `configure-page-linktree.png`
`subscription-free.png`	`/settings/subscription`	Placeholder — copied from `main-dashboard.png`
`subscription-plans.png`	Plan options	Placeholder — copied from `main-dashboard.png`
`apps-builder.png`	`/apps/builder`	Placeholder — copied from `flows.png`
`page-library.png`	`/page/view`	Placeholder — copied from `page-types.png`
`event-overview.png`	Event manager	Placeholder — copied from `event-conf-page.png`
`event-attendees.png`	Attendees tab	Placeholder — copied from `event-conf-page.png`
`event-desk.png`	Registration desk	Placeholder — copied from `event-conf-page.png`
`event-licence.png`	Licence purchase	Placeholder — copied from `event-conf-page.png`
`portal-dashboard.png`	Portal `/app`	Placeholder — copied from `main-dashboard.png`
`portal-digital-pass.png`	Digital pass	Placeholder — copied from `event-conf-page.png`
`portal-profile.png`	Portal profile	Placeholder — copied from `event-conf-page.png`
`ai-builder.png`	`/designer/build`	Placeholder — copied from `create-qr.png`
`org-tenants.png`	`/org/tenants`	Placeholder — copied from `main-dashboard.png`

Total screenshots: 24 → 40

Screenshot infrastructure added

scripts/capture-screenshots.mjs — Playwright capture script (1440×900 viewport)
package.json — playwright devDependency, pnpm run screenshots script

Blocker

Management app (http://localhost:3002) was not running during this update. Playwright capture could not execute. Placeholders prevent broken image links; fresh captures require:

bash

# Terminal 1 — start QRCompose local stack (see qrcompose/scripts/run-e2e-tests-local.sh)
./scripts/run-e2e-tests-local.sh --health

# Terminal 2 — capture docs screenshots
cd qrcompose-docs
pnpm install
MANAGEMENT_URL=http://localhost:3002 PORTAL_URL=http://localhost:3003 pnpm run screenshots

8. Important implementation details verified from code

Topic	Source file	Verified detail
Plan matrix	`planCommercialFeatures.ts`	Free: 1 published app, pages/forms included, menus+ locked; Starter: menus+reviews; Advanced: +bookings+payments; Pro: +API+white label
Event licence tiers	`EventLicences.ts`, `eventLicenceMessaging.test.ts`	Essential=100, Professional=500, Business=1000 attendees
Designer V3 types	`configuratorManifest.ts`	Popular/Business/Media/Utilities groups; 15+ design types
Management nav	`dashboardItems.tsx`	Apps, Events, Designer, Build with AI paths
Portal nav	`portal/src/App.tsx`	Dashboard, My Events, Connections, Profile; `/p/:token` public profiles
Event manager nav	`eventManagerNav.ts`	Overview, Programme, Attendees, Registration Desk
Portal limitation	`guest-portal-release.md`	No automated invite email at launch
Billing modes	`OrganisationBillingPolicy.cs`	self_service vs platform_managed

9. Features intentionally excluded and why

Topic	Reason
Full API reference	Product-owner decision to defer
Super-admin internals	Redis cache, background jobs, demo seeder — not end-user docs
Security audit findings	Internal ops documentation
Crypto/Web3 payments	Not shipped; removed from FAQ promises
Enterprise custom pricing	Contact-sales only; no public matrix
`/advanced/integrations`	Replaced by deferred API decision

10. Remaining blockers and product-owner confirmation needed

Screenshots — All 16 new screenshots are placeholders from pre-V2 assets. Fresh Playwright captures needed when local stack is available.
Portal screenshots — Require seeded event + guest account with portal access.
Event licence screenshot — May require Stripe test mode or E2E licence simulation.
AI Builder/Copilot screenshots — May require AIFeatures:Enabled and AI credits on test tenant.
Org tenants screenshot — Requires org-admin role on test account.
Automated portal invite email — Documented as not shipped; confirm if/when to update docs.
Customization Pro features — Some claims in customization/ pages (animated QR, batch generation, theme sharing) may be roadmap; not fully audited against entitlements in this pass.
API documentation — Deferred; homepage/FAQ no longer promise API docs.

11. Commands executed and validation results

bash

# Git history review
cd /Users/stel/Projects/qrcompose
git log 2.5.0..HEAD --merges --first-parent --format='%h %s'
git rev-parse HEAD develop master
git tag -l '2.*' '3.*' '4.*'
git rev-list --count 2.5.0..HEAD

# Screenshot placeholders
cd /Users/stel/Projects/qrcompose-docs/public/assets/screenshots
# cp commands creating 16 placeholder files from existing assets

# Dependencies and build
cd /Users/stel/Projects/qrcompose-docs
pnpm install
pnpm docs:build

# Stale terminology grep
rg -i "flow designer|14-day free|trial upgrade|create page →" --glob "*.md" .
# No matches (except intentional historical mention in plans-and-billing.md)

# Stack availability check
curl -s -o /dev/null -w "%{http_code}" http://localhost:3002/auth/sign-in
# Result: unreachable (000)

Stale reference search results

Term	Result
Flow Designer	Not found
14-day free trial (unqualified)	Not found
Trial Upgrade	Not found
Create Page →	Not found
/guide/flows (broken links)	Replaced with stub redirect page

12. Final VitePress build result

vitepress v2.0.0-alpha.12

✓ building client + server bundles...
✓ rendering pages...
✓ generating sitemap...
build complete in 2.45s.

Exit code: 0
Output: .vitepress/dist/
Page count: 41 markdown sources → all routes built successfully including guide/flows.html redirect stub

Summary

The VitePress documentation was modernised from a 25-page V2-era site to a 41-page structure covering Designer V3, Subscription V2, Apps, the full Events platform, Guest Portal, AI Builder/Copilot, and Organisation administration. Navigation was restructured with a unified sidebar and expanded top nav. Sixteen new screenshot assets were added as placeholders pending local stack availability. The build completes cleanly with no errors or warnings.

Recommended follow-up: Run pnpm run screenshots against a live local stack to replace placeholder images with current UI captures.

VitePress Post-V2 Documentation Update Report

1. Git range, branches, tags, and merge history reviewed

Anchors

Tags reviewed

Branches

Key merge commits (grouped by capability wave)

Internal docs translated

2. Grouped summary of major capabilities discovered

Subscription & billing (Subscription V2)

Designer V3

AI

Apps (formerly Flows)

Events platform

Event licensing

Guest portal

Organisation admin

Other

3. Pages added (16)

4. Pages substantially rewritten

5. Pages removed or deprecated

6. Navigation changes

Top nav (`.vitepress/config.mts`)

Sidebar restructure

Config cleanup

7. Screenshots added or replaced

New screenshot files (16)

Screenshot infrastructure added

Blocker

8. Important implementation details verified from code

9. Features intentionally excluded and why

10. Remaining blockers and product-owner confirmation needed

11. Commands executed and validation results

Stale reference search results

12. Final VitePress build result

Summary

VitePress Post-V2 Documentation Update Report ​

1. Git range, branches, tags, and merge history reviewed ​

Anchors ​

Tags reviewed ​

Branches ​

Key merge commits (grouped by capability wave) ​

Internal docs translated ​

2. Grouped summary of major capabilities discovered ​

Subscription & billing (Subscription V2) ​

Designer V3 ​

AI ​

Apps (formerly Flows) ​

Events platform ​

Event licensing ​

Guest portal ​

Organisation admin ​

Other ​

3. Pages added (16) ​

4. Pages substantially rewritten ​

5. Pages removed or deprecated ​

6. Navigation changes ​

Top nav (.vitepress/config.mts) ​

Sidebar restructure ​

Config cleanup ​

7. Screenshots added or replaced ​

New screenshot files (16) ​

Screenshot infrastructure added ​

Blocker ​

8. Important implementation details verified from code ​

9. Features intentionally excluded and why ​

10. Remaining blockers and product-owner confirmation needed ​

11. Commands executed and validation results ​

Stale reference search results ​

12. Final VitePress build result ​

Summary ​

VitePress Post-V2 Documentation Update Report

1. Git range, branches, tags, and merge history reviewed

Anchors

Tags reviewed

Branches

Key merge commits (grouped by capability wave)

Internal docs translated

2. Grouped summary of major capabilities discovered

Subscription & billing (Subscription V2)

Designer V3

AI

Apps (formerly Flows)

Events platform

Event licensing

Guest portal

Organisation admin

Other

3. Pages added (16)

4. Pages substantially rewritten

5. Pages removed or deprecated

6. Navigation changes

Top nav (`.vitepress/config.mts`)

Sidebar restructure

Config cleanup

7. Screenshots added or replaced

New screenshot files (16)

Screenshot infrastructure added

Blocker

8. Important implementation details verified from code

9. Features intentionally excluded and why

10. Remaining blockers and product-owner confirmation needed

11. Commands executed and validation results

Stale reference search results

12. Final VitePress build result

Summary