qortal-web-builder/qortal-web-app/CHANGELOG.md

Qortal Web — Changelog

v0.0.29 — 2026-05-18

Fixes

• Changelog modal — solid panel background (--qw-bg-elev); no longer transparent
• Read article — embed opens the selected article (expanded card), not the full articles grid; republish QWB for visitor handler

v0.0.28 — 2026-05-18

Embed theme sync

• Forum / poll / article / website embeds follow Qortal Web light/dark — published site theme no longer overrides the shell when opened from Qortal Web
• QORTAL_WEB_EMBED_THEME postMessage from Qortal Web; published visitor applies data-site-theme (republish QWB for handler on older sites)

Avatars

• Masthead + top publishers — wallet address included in avatar lookup; Hub bridge fetch tried first when qortalRequest is available
• Site logos on top publishers resolve via the same media path helpers as browse cards

Footer

• Click v0.0.28 (version label) to open the changelog modal

v0.0.27 — 2026-05-18

Published-site block previews (forum / poll / article)

• Hybrid embed architecture — hidden iframe warms the full published WEBSITE + masthead auth; visible iframe shows only the target block (site chrome hidden via block-focus CSS)
• Real visitor runtime — posts, votes, and comments load inside the published site iframe (same as Hub), not stripped native panels
• Publisher resolution — prefers qortal://WEBSITE/… href from index entries and website index row before display titles
• Republish QWB for in-iframe block-focus handler (QORTAL_WEB_EMBED_BLOCK_FOCUS)

v0.0.26 — 2026-05-18

Fast native forum / poll / article opens

• Correct WEBSITE publish name — index sitePublisher and per-entry publisher win over DOCUMENT search hit and display titles (fixes 404s like Biohackers Corner)
• Instant block UI — panel renders as soon as site config resolves; peer data loads in background (5s cap)
• No whole-site peer prefetch on every open — removed storm of JSON/APP index shard fetches
• Masthead auth → native blocks — signed-in masthead session sets inQortal so forum/poll gates recognize you without re-authenticating

QWB index (republish to apply)

• Index entries now include meta.peerPublisher — explicit QDN name for forum/poll/article peer JSON

v0.0.25 — 2026-05-18

Single-block native viewers (forum / poll / article)

• Forum, poll, and article open as native blocks again — only the target block UI, not the full website iframe
• Targeted peer preload — loads QDN data for that one block before rendering (posts, votes, article comments)
• Website entries still use the full-site embed preview

v0.0.24 — 2026-05-18

Forum, poll, and article → published WEBSITE embed

• Interactive blocks open the real published site in an iframe (same visitor runtime as the Hub) instead of stripped-down native panels — auth, forum posts, and poll votes use the site’s own QDN peer loading
• Correct publisher URL — resolves registered QDN name via site config before building /render/WEBSITE/ URL (not index display title)
• Masthead auth passthrough — repeated postMessage auth sync + hidden per-site warmup iframe
• Scroll-to-block after embed ready handshake (QORTAL_WEB_EMBED_READY from published visitor)

v0.0.23 — 2026-05-26

Published site session (your architecture)

• Load full WEBSITE once per site — config merged like the published visitor, all blocks in visitor store, masthead auth applied (same as opening the site in the background)
• Shared session cache — open poll first, then forum/article on the same site reuses the warmed session (fast second open)
• Background peer prefetch — forum, poll, and article discussion data for every interactive block on the site loads after the first open

v0.0.22 — 2026-05-26

Native viewer speed + auth

• Removed heavy peer rescan during publisher resolution (was loading full forum/poll search on every open)
• Removed cache bust on panel mount that forced full QDN rescan every time
• Reject website display titles as peer publishers (fixes 404s like Biohackers Corner)
• Negative cache for missing site-config fetches (stops Simon James / display-title retry storms)
• Session sync — masthead wallet passed into native panels via syncNativeViewerSession before forum/poll/article gates render

v0.0.21 — 2026-05-26

Startup crash fix

• Cross-origin bridge probe — reading parent.qortalRequest in the Hub iframe threw SecurityError and prevented Qortal Web from loading (v0.0.20 regression). All parent/top bridge checks are now wrapped in try/catch; the local postMessage stub is used when parent is not readable.

v0.0.20 — 2026-05-26

Native forum, poll, and article interaction

• Correct peer publisher — uses publisherName from loaded site config (and index sitePublisher) for forum/poll/article QDN fetches, not just the index document owner
• Article comment publisher probe — resolves the QDN name that actually holds article discussion JSON
• Hub bridge priority — prefers Hub-injected qortalRequest on parent/top over the local postMessage stub (fixes publish/search when both exist)
• Fresh peer load — busts bundle + session caches when opening native forum/poll/article viewers
• Auth sync — masthead session + inQortal stay aligned with the live bridge for compose/vote gates

v0.0.15 — 2026-05-25

Forum / poll loading

• Skip Your Name placeholder — never used for QDN fetches (root cause of empty forums in log)
• Publisher from index owner — site config publisherName no longer overrides the QDN document owner
• Parallel bundle probe — faster publisher detection (bridge + HTTP in parallel per candidate)
• Eager publisher — visitor store gets correct QDN name before site config finishes loading

Open website

• New tab — opens /render/WEBSITE/{publisher} in a new Hub tab (was broken qortal:// navigation)
• Button label — Open + site avatar + website title

Auth avatars

• Direct img load — same fast path as site avatars; bridge fallback only on error
• Registered name lookup — uses Hub primaryName + /names/address list, not truncated address label

v0.0.14 — 2026-05-25

Avatars

• Robust QDN avatar fetch — tries /arbitrary/THUMBNAIL/{name}/qortal_avatar and /arbitrary/THUMBNAIL/{name}, then Hub FETCH_QDN_RESOURCE; proper path encoding for names with apostrophes
• Authenticated user — no longer uses truncated address as avatar lookup key; resolves registered name from Hub + /names/address
• Top publishers — site logo from index used as avatar fallback when QDN name avatar is missing

Search

• Result thumbnails — search results show entry thumb when index has thumbHref (library, images, articles, etc.)

v0.0.13 — 2026-05-25

Forum / poll / article data

• Deep QDN search on first open — empty cache now triggers rescan (dual search pass) so live posts/votes load even when publish-time bundles were empty
• Publisher probe — bridge-first, no stale HTTP cache; articles also probe forum bundle owner
• Forum/Poll panels — sync probed sitePublisher into visitor store before block views mount

Article comments

• Auth gate CSS — hide “Authenticate” prompt only when bridge + wallet are both ready (data-qw-can-auth)
• Bridge-not-ready message — signed-in users see guidance instead of a silent dead zone
• ContentViewer — no longer clobbers publisher name from stale store on open

Library thumbnails

• Configured thumbs first — Folders block thumbnailHref wins over PDF page-1 preview
• Separate PDF cache key — prefetched PDF blobs no longer overwrite custom thumbs
• Index: folder default thumbs — defaultThumbnailHref on folders inherited into library index entries (requires QWB republish for folder-level thumbs)

v0.0.12 — 2026-05-25

Auth

• setSessionUser implemented — visitor store now keeps masthead session; article comments / forum / poll gates unlock when authenticated
• Logout (×) works — explicit sign-out sets opt-out flag so auto GET_USER_ACCOUNT no longer re-logs you in
• applyRuntimeContext null fix — passing user: null clears session instead of preserving stale auth

Data loading

• QDN publisher from index owner — fetches use DOCUMENT search name (not website display title); fixes 404s on Biohackers Corner / The People of Qortal
• Bridge-first site config — FETCH_QDN_RESOURCE before HTTP for qwb-site-config.json
• Forum/poll probe — tries bridge + all publisher candidates per block
• Safe base64 decode — avoids InvalidCharacterError: atob on malformed QDN payloads

v0.0.11 — 2026-05-25

Auth & interactive blocks

• sessionUser bridge — masthead wallet synced to native forum/poll/article gates (fixes false “Authenticate to join”)
• Peer publisher probe — tries QDN names until forum/poll JSON bundle loads
• Index publisher — document owner preferred over website display title in cached index

Browse & index (QWB)

• Folders tab search — Q-Tube / playlist imports mirrored as folder-scoped entries (searchable in Folders + global search on Folders view)
• Library/PDF thumbs — FILE href resolution for PDF page-1 previews; QDN thumb hrefs via resolveMediaHref
• Folder publisher avatars — site logo from index when available
• Folder viewer — dialog grows vertically when expanding folder tree
• Primary names — authenticate resolves registered name; viewer chip shows name not address

v0.0.10 — 2026-05-25

Interactive blocks (auth, forum, poll)

• Forum / poll / article auth — canAuth / canVote use reactive useQortalApiPresent() (fixes “Authenticate to join” while signed in)
• Publisher for peer fetches — site config publisherName used after load; better fallback when index title ≠ QDN name
• Visitor store — inQortal stays true once Hub bridge is detected (avoids auth flicker)

Browse UX

• Folders — publisher list only (removed tree/grid toggles)
• Library thumbs — resolve QDN thumbnail hrefs via shared resolveMediaHref (Folders block publish previews)
• Top publishers — horizontal bar chart with count at bar end

v0.0.9 — 2026-05-18

UX & reliability

• Websites tab — scrollable Discover preview screenshots (same QWB qwb_discover_preview_v1 images)
• Folders tab — default By publisher list with folder/file counts; click opens the share-folders block
• Library — PDF page-1 thumbnails rendered for browse cards; PDF.js worker bundled (fixes Hub 503 on lazy worker chunk)
• Top publishers — denser compact rows on home
• Network stats — “Folders” renamed to Folder files
• Avatars — try registered names from wallet before address; fallback image when QDN thumbnail missing
• Articles — forum auth reacts to Hub bridge; wallet synced into native blocks when the viewer opens
• Publisher fix — prefer QDN SEARCH document owner over website display titles in index

v0.0.8 — 2026-05-18

Hub runtime fixes (forums, polls, articles, library)

• No lazy-loaded panel chunks — Hub returned 503 on /render/APP/Qortal Web/assets/*.js; all native panels ship in the main bundle so forums, polls, and articles load reliably
• Qortal bridge shim — native blocks use the same parent-window qortalRequest bridge as the masthead so posting, voting, and comments work after Authenticate
• Publisher resolution — prefers qortal://WEBSITE/… href from the index over website display titles (fixes site-config 404s)
• Avatars — wallet address used for authenticated user thumbnail; initials hidden once image loads; bundled default avatar fallback
• Library thumbnails — broader thumb href resolution (preview meta, image/video file hrefs)

v0.0.7 — 2026-05-18

Content viewer fixes

• Close (×) button — always visible top-right on the detail overlay; Escape also closes
• Full-screen overlay — sits above the sticky masthead so nothing overlaps the viewer
• Authenticate in viewer header — sign in without closing the detail view; session restores on Hub load
• Publisher name fix — index entries use the QDN document owner (not website title) for site-config and peer fetches, fixing 404s like Biohackers Corner/qwb-site-config.json
• Hide duplicate auth banners inside native forum/poll blocks when opened from Qortal Web

v0.0.6 — 2026-05-18

Browse UX & auth

• Avatar in masthead — larger profile avatar top-right when signed in; compact × sign-out button
• Sticky masthead — Authenticate stays reachable while the content viewer is open; session applies to all native forums, polls, shops, and comments
• Grid / list / tree views — every category tab has view toggles; folders default to an aggregated tree across all publishers
• Library thumbnails — browse cards prefetch index thumbnail metadata and image fallbacks
• Thumbnail hover — cards pop forward slightly on hover across grid, list, discover, and folder tree

v0.0.5 — 2026-05-25

Full native block runtime (no iframe except websites)

• Articles — ArticleContentView + ArticleForumSection with live QDN comment threads
• Music — full MusicBlockView (albums, shuffle, playback rate); deep-links to indexed track
• Images — AlbumsBlockView lightbox or native photo block viewer
• Videos — native player or Q-Tube embed from block config
• Library / Folders — full ShareFoldersBlockView (PDF preview, gallery, audio, download); opens indexed file on load
• Q-Shops — native QShopStorefront (cart, checkout, auctions) via extended visitor store
• Code-split bundles — forum, poll, qshop, folders, music, article load on demand (~50 KB initial JS)

QWB publish sync

• MusicBlockView, AlbumsBlockView, ShareFoldersBlockView accept deep-link props for Qortal Web index entries

v0.0.4 — 2026-05-25

Native forum & poll (no iframe)

• packages/qwb-visitor — shared visitor runtime with slim Zustand store replacing builderStore for block views
• Forum and Poll open natively inside Qortal Web using real QWB ForumBlockView / PollBlockView + QDN peer stack
• Single Authenticate in the Qortal Web masthead drives posting, replies, and voting
• Vite aliases bundle @qwb/core (QWB source) with a builderStore shim → @qwb/visitor
• Websites and Q-Shops still use site embed until native Q-Shop storefront is ported

QWB index (write side)

• Index entries include pageSlug, contentRef, requiresAuth for native block resolution

v0.0.3 — 2026-05-25

In-app reading & interaction

• Content viewer modal — opening any indexed item stays inside the Qortal Web Q-App instead of leaving via qortal:// deep links
• Articles — loads qwb-site-config.json from QDN and renders article HTML in-app
• Videos, music, images — native <video>, <audio>, and <img> players via Hub /arbitrary/… URLs
• Library & folders — PDF/text inline preview with download; other files offer direct download
• Forums, polls, Q-Shops, full websites — embedded published site iframe (/render/WEBSITE/…) with scroll-to-block via postMessage; use the site’s own Authenticate bar to post, vote, or checkout
• Auth banner in viewer when interactive content needs a wallet (masthead auth still applies globally)
• Open in Hub fallback on every viewer

Index (QWB write side)

• Index entries now include pageSlug and contentRef metadata for faster in-app resolution
• Fixed block id indexing for non-peer blocks (articles, media, folders)

Visitor sites (QWB)

• Published websites listen for qwb-qortal-web-scroll postMessage from Qortal Web embeds to scroll to the target block

v0.0.2 — 2026-05-18

Navigation & browse pages

• Category nav bar — Home + each content type (Websites, Articles, Forums, Polls, Q-Shops, Library, Folders, Videos, Music, Images) as dedicated browse pages
• Each category page aggregates all items of that type from every indexed QWB site, with Open forum / Read article / Browse shop actions plus View site
• Compact Authenticate moved to masthead (right of Refresh index); signed-in state shows avatar + name pill
• Search engine stays centered; when on a category page, search scopes to that type
• Home retains stats, What's new, and a quick discover websites strip

v0.0.1 — 2026-05-24

First release of the Qortal Web Q-App — a decentralized directory and search engine for content published through Qortal Web Builder (QWB).

Qortal Web Q-App

• Qortal Web Engine — large centered search bar indexing all QWB-published content client-side
• Home dashboard when not searching:
  • Network statistics (total indexed items, websites, content-type breakdown)
  • Top publishers with QDN avatars
  • What's new — latest indexed publishes
  • Discover websites grid with homepage preview snapshots (from QWB Discover Templates)
• Content types indexed: websites, forums, polls, articles, Q-Shops (links to Q-Shops Q-App), folders, library documents (PDFs etc.), videos, music, images
• Light / dark themes — styled to match published QWB sites (Paper / Slate palette)
• Authentication — Hub wallet sign-in with avatar and registered name
• IndexedDB cache — index files cached by publisher + modified timestamp; only changed sites re-fetched
• No custom backend — all data via qortalRequest / QDN SEARCH + FETCH

Qortal Web Builder (write side)

• On Publish Website, QWB now emits a qwb-qortal-web-index-v1 DOCUMENT at .__qwb__/qortal-web-index.json
• Index includes structured entries for all supported blocks on the site
• WEBSITE description tagged with index schema marker for QDN search discoverability
• Publish batch fingerprint skip when index content unchanged

Packaging

• Flat Hub zip: Qortal-Web-v0.0.1-YYYYMMDD.zip
• Build: npm run zip:qortalweb from repo root

Notes

• Republish existing QWB websites once to populate the Qortal Web index on QDN
• Q-Shops product catalogs continue to use the dedicated Q-Shops Q-App; Qortal Web indexes Q-Shop blocks and deep-links to Q-Shops