Feature Owner (original Hand-Off): James Derick Billate
Updated by / current owner: Patrick Babala
Reviewers: @clydetims (Clyde Ador), @cdnzn (Christian Denzon), @ybcole (Cole)
Module: Dashboards
Priority: Should
Status: Handoff — Updated (v2.0), live on production
Date (original): July 9, 2026
Last Updated: 2026-10-01
Issue: GitHub Issue #77 — [5.3] Creator Hub (closed 2026-08-27)
Sub-issues: #661 — [5.3.1] Creator View Mode (closed 2026-08-19); #662 — [5.3.2] Creator Hub Search Functionality (closed 2026-08-19)
PRs covered: #759 (search + view mode, merged 2026-08-11), #767 (status-filter fix, merged 2026-08-14), #690 (thumbnail ratio, list scroll, cache-busting, merged 2026-07-22), #780 (typed-confirm destructive modal, merged 2026-08-20)
Companion doc: Internal Technical Guide — Internal-Technical-Guide-Creator-Hub.md (architecture, DB schema, API specs, helpers, ops, testing, troubleshooting). This Hand-Off stays product-facing; where engineering depth is needed it cross-references the ITG instead of duplicating it.
Executive Summary
What is this feature?
The Creator Hub dashboard is the Creator's central workspace for viewing projects, quests, adventures, and content status in one place. It gives a quick overview of active work, published content, drafts, and project collections, and provides direct access to continue editing or managing each item. Since the original hand-off it has grown beyond a read-only list into the primary content-management surface: search, grid/list view modes, status and skills filters, bulk actions, and the full Archive → Restore → Permanent Delete lifecycle.
Why does it matter?
Creators need a clear and reliable starting point for managing their learning content. Without a dashboard, Creators may lose track of which projects are drafts, published, under review, or archived. The Creator Hub reduces confusion, improves workflow visibility, and supports faster decisions on what content needs action next.
Shipped scope (v2.0):
Summary cards for total quests, published quests, draft quests, and adventures.
My Content area with Quests, Adventures, and Archive tabs (the third tab is labeled Archive; the historical "Trash" wording is stale).
Real-time search across title, introduction, tags, and skills (Issue #662, PR #759).
Grid and list view modes with a per-device remembered preference (Issue #661, PR #759).
Status filter (all / draft / published / submitted / in_review / changes_requested / approved) and a skills filter (OR logic) (PR #767 for the non-locking filter fix).
Bulk selection — shift-click ranges, Select all / Deselect all, bulk Archive, bulk Restore, bulk Delete.
Archive lifecycle: archive items show a 120-day countdown, can be restored (returning to Draft at Root), or permanently deleted with a typed
DELETEconfirmation (PR #780).16:9 thumbnail treatment and a fallback cover image, with session-stable cache-busting (PR #690).
Navigation from dashboard cards into the correct editor, plus a View Library entry point.
Still deferred (v1.1+): CSV export, custom dashboard widgets, real-time collaborative status, reviewer-queue management, and advanced project-timeline visualization.
1. User Pain Point & Solution
John is creating multiple learning projects in WyzQuests but has difficulty keeping track of which quests are still drafts, which ones are published, and which content needs continued work. He wants one dashboard where he can see his projects and their status without opening each project one by one.
Pain Points
Emotional: Overwhelmed, unsure, and concerned about losing track of ongoing work.
Functional: No single overview of project status, content type, publishing state, quick access to editing, or a fast way to find a specific item in a large library.
Business: Better project visibility increases content completion, improves publishing readiness, and reduces creator workflow delays.
Resolved by v2.0: the dashboard now also provides search, view modes, status/skills filters, and a self-serve archive/restore/permanent-delete lifecycle, so Creators can find and manage content without leaving the Hub.
2. 4D Framework Mapping
Diagnose:
Provides a clear dashboard overview of a Creator's current projects, quests, adventures, and publishing statuses, and surfaces where items are stuck (drafts, in review, archived).
Design:
Gives Creators a structured view of content groupings and progress — tabs by content type plus an Archive, filters by status and skills, and grid/list layouts — so they can plan next actions.
Develop:
Supports active production by letting Creators search, filter, bulk-select, and quickly continue editing drafts, inspect published content, and manage projects, and by moving stale items into a 120-day Archive instead of losing them.
Deliver:
Helps ensure content is ready for learners by exposing status at a glance and guiding Creators toward publish-ready output.
3. USER FLOWS
Entry Points:
Creator logs in and navigates to the Creator Dashboard, or is routed to /creator from role-based navigation.
Success Criteria:
Creator can find, view, and manage their projects/content, understand status at a glance, and open the correct item for continued work.
Main Path (Happy Path)
Creator opens the Creator Hub dashboard.
System loads the creator analytics summary cards.
Creator views total quests, published quests, drafts, and adventures.
Creator opens the My Content area; the Quests tab is shown by default.
Creator switches between Quests, Adventures, and Archive tabs, and toggles grid/list view.
Creator types in the search box or applies status/skills filters to narrow the list.
Cards/rows show title, thumbnail, tags, skills, folder, and publishing status.
Creator clicks a quest or adventure to open the correct editor, or uses card actions (edit / archive / delete).
Creator can select multiple items to archive, restore (Archive tab), or permanently delete.
Creator continues work with project context preserved.
No Data: Display "No current content" when there are no quests or adventures; the Archive tab shows "Archive is empty."
Filtered empty: Display "No content matches the selected filters" when filters/search return nothing.
API Error: Display an error state (with Retry) if analytics or a content list cannot be loaded.
Permission Denied: Only authenticated Creators and authorized agency-scoped users can view content within their ownership scope; folder managers may manage items in folders they administer.
Decision Points:
IF Creator opens the dashboard THEN load analytics and the content list ELSE keep the dashboard empty.
IF a content-type tab is selected THEN fetch that tab's list ELSE keep the current list.
IF a search term or filter is applied THEN show matching content ELSE show the full list; if nothing matches, show the filtered empty state.
IF a content card is clicked (not in selection mode) THEN route to the quest editor or adventure editor ELSE toggle selection.
IF content is archived THEN show it only in the Archive tab ELSE exclude it from active lists.
IF the Creator requests permanent delete THEN require typing
DELETEbefore the action is allowed ELSE block the action.IF multiple items are selected THEN show the bulk action bar ELSE hide it.
4. Information Architecture
Primary Information (always visible)
Creator dashboard header.
Creator analytics summary cards.
Content/project list (grid cards or list rows).
Quest or adventure title.
Publishing status.
Content type: Quest or Adventure.
Secondary Information
Thumbnail image.
Introduction or description preview.
Tags and skills.
Duration and enrollment fee /
total_quest_fee.Quest mode.
Folder/project location (folder badge).
Created / updated dates (list view;
created_at,updated_at).
Tertiary Information
Recent activity.
AI suggestions.
Archive state and 120-day countdown (
archived_at).Archived-item controls.
Actions
Primary CTA: "Create Content" (or "AI Assistant") from the Creator Header; open a quest/adventure from its card.
Secondary actions: switch tabs (Quests / Adventures / Archive); toggle grid/list view; search; filter by status; filter by skills; clear skills; bulk select; View Library; Archive; Restore; Permanent Delete (typed
DELETE).
5. Data Requirements
Frontend Needs
Creator-scoped analytics counts.
Quest list with title, introduction, tags, skills, thumbnail,
publishing_status, duration, fee,quest_mode, folder metadata, andcreated_at/updated_attimestamps.Adventure list with title, introduction, tags, skills, thumbnail,
publishing_status, duration, fee,total_quest_fee, folder metadata, andcreated_at/updated_attimestamps.Archived content list (quests + adventures) including
archived_atfor the countdown.Authentication, agency-ownership context, and folder role context.
API Calls the Frontend Will Make
GET /api/creator/analytics— summary card counts.GET /api/creator/list-quests— Quests tab (supportsquest_mode,editable_only).GET /api/creator/list-adventures— Adventures tab (includestotal_quest_fee).GET /api/creator/list-archived— Archive tab (quests + adventures).PATCH /api/creator/archive-content— archive one or many items.PATCH /api/creator/restore-content— restore one or many items.DELETE /api/creator/permanent-delete— permanently delete (requiresconfirm_text: "DELETE").GET /api/creator/quest-status?quest_id={questId}— review-lock status polling.
Notes
Search, status/skills filtering, sorting, and grid/list view mode are client-side; they make no additional API calls.
In some docs the archived list URL appears as
/api/creator/(content)/list-archived;(content)is a Next.js route group and is not part of the URL.Full request/response shapes and validation live in the Internal Technical Guide, API Specification section.
6. Performance Considerations
Database Optimization
Use Creator/agency ownership filters on dashboard queries.
Use count-only queries for dashboard metric cards.
Order active content by
updated_at(thencreated_at) so recently changed work appears first.Exclude archived content from active quest and adventure lists.
Use indexes on ownership fields,
publishing_status,skills,archived_at, andupdated_atfor dashboard list speed.
Frontend Optimization
Show loading skeletons for analytics and content cards/rows.
Avoid loading Archive content until the Archive tab is selected.
Keep search, status, and skills filtering client-side after the active list is loaded.
Limit card content display so long titles, tags, and descriptions do not break the layout.
Remember the grid/list view mode per device (
localStorage), not per account.
7. Security & Authorization
Who Can Access This Feature?
Administrator: No direct Creator Hub access as a Creator; admins are gated through the creator role check / View-As.
Reviewer: No access.
Creator: Full access to owned or agency-scoped creator content.
Learner: No access.
Agency Admin: Limited access only where agency-scoped ownership rules (and folder permissions) allow dashboard/content visibility.
Authorization Logic
Route guard requires an authenticated CREATOR or ADMIN (
app/creator/layout.tsx).Every list/mutation is scoped by
agencyResourceFilter(creator id or agency id set).Mutations additionally verify per-item ownership, with a folder-manager fallback (
canManageItemsInFolders).
8. Error Handling
Current Existing Error Handling
Invalid credentials → 401 Unauthorized.
Expired session → 401 Unauthorized with redirect to login.
Non-creator attempting to access the Creator Dashboard → blocked by layout/auth checks.
User attempting to view content outside their ownership scope → filtered out or denied.
Quest not found → 404 Not Found or access denied.
Invalid quest ID for status polling → 400 Bad Request.
Invalid permanent-delete confirmation token → 400 Bad Request (and an
audit_logsPERMANENT_DELETE_FAILEDentry).Archive/restore/delete on an item the caller cannot manage → 403 Forbidden.
Archiving an already-archived item → 400 Bad Request ("Content is already archived").
Analytics fetch failure → error state in the analytics card area.
Content list fetch failure → error state (with Retry) in the My Content area.
Database connection failure → 500 Internal Server Error.
9. Testing Checklist
Happy Path
Creator navigates to the Creator Hub dashboard.
Analytics cards load totals for quests, published quests, drafts, and adventures.
Creator views the Quests tab by default.
Quest cards display title, image, tags, skills, folder, and publishing status.
Creator switches to the Adventures tab; adventure cards display correct details and status.
Search matches title, introduction, tags, and skills (case-insensitive).
Status filter and skills filter narrow the list correctly; clearing them restores the full list.
Grid/list toggle switches layout and persists across reloads.
Creator clicks a quest card and is routed to
/quest-editor/{id}.Creator clicks an adventure card and is routed to
/creator/edit-adventure/{id}.Creator opens View Library and is routed to
/creator/content-library.Creator selects multiple items (including shift-click range) and performs bulk archive / restore / delete.
Edge Cases
Creator with no quests sees the empty state.
Creator with no adventures sees the empty state.
Creator with selected filters/search but no matching content sees the filtered empty state.
Archived content does not appear in active Quests or Adventures tabs.
Archive tab loads archived content separately and shows the
Nd leftcountdown (destructive styling at ≤ 3 days).Restoring an archived item returns it to Draft at Root (folder cleared).
Permanent delete is blocked until
DELETEis typed; the item is removed from the Archive on success.API timeout or failed fetch displays a clear error state with Retry.
Unauthorized user cannot access the dashboard.
Creator cannot view another Creator's private content (outside agency scope).
10. OPEN QUESTIONS
Should Creator Hub separate projects from quests/adventures more explicitly, or is "My Content" sufficient for MVP?Resolved (v2.0): "My Content" with Quests / Adventures / Archive tabs is the shipped information architecture; no separate Projects surface.Should archived items also be available as a filter chip inside the Quests tab, or remain isolated in Trash?Resolved (v2.0): archived items remain isolated in the Archive tab (renamed from "Trash").Should publishing statuses include reviewer workflow labels such as submitted, in review, changes requested, and approved on the dashboard cards?Resolved (v2.0): yes — these are available in thestatusFilter(submitted,in_review,changes_requested,approved), and review states surface via the review-lock flow.Should the dashboard support sorting by status, last updated, or project folder?Partially resolved (v2.0): the Archive tab supports sorting; active tabs are ordered server-side byupdated_at/created_at. Interactive sort on the active tabs (by status/folder) remains a possible follow-up.Should dashboard counts include agency-shared content or only content directly created by the logged-in Creator?Resolved (v2.0): counts use the agency-scoped filter (agencyResourceFilter), so they include agency-shared content the caller may see.
11. OUT OF SCOPE
Confirmed still out of scope (v2.0):
Advanced project timeline visualization.
Bulk publishing controls (note: bulk archive / restore / delete did ship).
Reviewer queue management.
Learner performance analytics (the
LearnerGroupAnalyticssummary widget is the only analytics surface here; deeper analytics remain out).CSV export of creator dashboard data.
Custom dashboard widgets.
Real-time collaborative status updates.
Why: the v2.0 scope focuses on findability, status visibility, and a safe archive lifecycle.
12. SUCCESS METRICS
Creator can view project/content status from the Creator Hub.
Creator can identify draft and published content without opening each item.
Creator can find a specific item quickly using search and filters.
Creator can choose a preferred grid or list view and have it remembered.
Creator can navigate from dashboard to the correct editor.
Creator can manage content in bulk (archive / restore / delete).
Creator can recover or permanently remove archived content through the Archive tab.
18. DEPENDENCIES
This feature depends on:
Supabase Auth (corrected from the original "Clerk Authentication" — the platform migrated to Supabase Auth).
Supabase Database.
Creator role authorization.
Agency ownership and resource filtering.
Quest and Adventure content APIs.
Content card UI components.
These features depend on this:
Quest Editor.
Adventure Editor.
Creator Content Library.
Archive Content Management (formerly "Trash Content Management").
Publishing Status Workflow.
19. TIMELINE & OWNERSHIP
Original owner / Hand-Off author: James Derick Billate (Hand-Off v1.0, July 9, 2026).
Implementation & current owner (v2.0 update): Patrick Babala.
Reviewers: @clydetims, @cdnzn; @ybcole.
QA: Internal development testing.
Shipped: #690 (2026-07-22), #759 (2026-08-11), #767 (2026-08-14), #780 (2026-08-20); issue closed 2026-08-27.
Estimated Completion: Feature completed for v2.0 scope; remaining items are the Out-of-Scope list above.
Note: API endpoints and schema are documented in the Internal Technical Guide (
Internal-Technical-Guide-Creator-Hub.md).
References
Issue: wyzlab/WyzQuests #77 — [5.3] Creator Hub (closed 2026-08-27).
Sub-issues: #661 — [5.3.1] Creator View Mode; #662 — [5.3.2] Creator Hub Search Functionality (both closed 2026-08-19).
PRs: #759 (search + view mode), #767 (status-filter fix), #690 (thumbnail ratio, list scroll, cache-busting), #780 (typed-confirm destructive modal).
Dependencies: #70 — [1.1] Project Creation; #71 — [2.1] Form Editor.
Companion ITG:
Internal-Technical-Guide-Creator-Hub.md.
Version History
2.0 — 2026-10-01 — Patrick Babala. Hand-Off overhaul. Updated the original v1.0 outline in place: renamed the third tab to Archive, and documented search, grid/list view modes, status/skills filters, bulk selection and bulk actions, the 120-day archive retention with restore/permanent-delete (typed
DELETE), thumbnail/caching fixes, and Supabase Auth. Resolved the Open Questions and confirmed the Out-of-Scope list. PRs: #759, #767, #690, #780.1.0 — 2026-07-09 — James Derick Billate. Original Hand-Off (dashboard overview, summary cards, quests/adventures/trash tabs, skills filter, navigation to editors).