Uh oh!
There was an error while loading. Please reload this page.
feat: homepage onboarding flow and AI-native software templates - #96
Merged
Conversation
#87: reorient homepage around first-use orientation - replace one-line Getting Started alert with a Start here panel (create first service, browse docs, register existing repo) - surface onboarding/getting-started tagged docs as homepage cards with skeleton loaders and an empty state - replace Quick Links sidebar with Support & Reference (docs, API reference, notifications, get help) with entity-driven help link - drop the duplicate Getting Started sidebar card - add aria-labels to new navigation affordances - ship portal-docs TechDocs entity (getting started + support/FAQ) tagged onboarding/getting-started/support #88: curate template inventory around three families - tag existing templates with family:repo/docs and provider:github/gitlab - homepage Popular Templates now filters to recommended and shows a family chip on each card - add ai-hub-service template (provider-agnostic LLM gateway skeleton) - add answer-engine-worker template (queue consumer + indexer + query API, AI Hub backed, cited answers) - add mcp-server template (stdio MCP server with example tools) - every new template ships AGENTS.md, TechDocs site, Dockerfile, and catalog registration per the AI-native repo pattern Co-authored-by: opencode-agent[bot] <219766164+opencode-agent[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes#87
Closes#88
#87 — Homepage onboarding flow
Reorients the homepage around first-use orientation without removing catalog surfaces:
/self-service), browse the docs (/docs), register an existing repo (/catalog-import). Replaces both the one-lineGetting Started?alert and the near-identical Quick Actions grid (consolidated rather than duplicated; API Explorer moved to the sidebar).onboardingorgetting-startedas cards linking to their TechDocs pages. Skeleton loaders while loading, graceful empty state explaining theonboardingtag when none exist.support-tagged entity when one exists, falling back to/docs.aria-labels; cards stack vertically at ≤600px via the existing Grid breakpoints; no hard-coded hex, all colours viatheme.palette.*.portal-docsTechDocs entity (examples/portal-docs/) with Getting Started and Support & FAQ pages, taggedonboarding/getting-started/support, so the new sections have real content on first boot.#88 — Reusable software templates
family:repo,family:docs,provider:github,provider:gitlab; the two docs-site templates now carryrecommendedtoo.recommended-tagged templates and renders a family chip on each card; the action button reads "See All Templates".AGENTS.md, TechDocs site, Dockerfile, and catalog registration):ai-hub-service— provider-agnostic LLM gateway (/healthz,/v1/answerstub,src/providers/interface)answer-engine-worker— queue consumer + document indexer + query API (/v1/ask,/v1/index), delegates inference to an AI Hub viaAI_HUB_URL, answers always carry citationsmcp-server— stdio MCP server withping/echoexample tools (@modelcontextprotocol/sdk)Template consolidation/renames from the PRD were deliberately skipped to avoid scope creep (PRD note: "leave them as-is").
Verification
yarn lint— cleanmise run test— 9 passed, 1 skipped (pre-existing suite)template.yaml/ catalog YAML parse cleantsc --noEmit) with their declared depsManual QA checklist
/with no onboarding-tagged entities → Onboarding Docs shows empty state/withportal-docsregistered → card renders, links to/docs/default/component/portal-docs/self-service→ Recommended group shows all 7 templates; family tags visibleai-hub-serviceend-to-end → repo created, entity in catalog, TechDocs buildsNotes
tscerrors (cli tsconfig lib entry, permission module type annotation) are unrelated to this change.