Add landing page at nest-native.dev/reference-app#14
Merged
Conversation
Mirrors the org landing site's visual language (dark theme, radial
gradients, hero + panel, pill buttons) so that
nest-native.dev/reference-app/ feels like it belongs next to
nest-native.dev/nest-drizzle-native/ and
nest-native.dev/nest-trpc-native/.
Page structure:
- Hero: tagline, primary CTA to the GitHub repo, secondary CTA to
the architecture doc, stack-at-a-glance panel.
- "What it is" split section restating the reference-vs-product
boundary from the brief.
- Eight-milestone status grid (numbered, all "done").
- Link-out section to source, architecture, getting started,
CHANGELOG, v0.1.0 release, both library doc sites.
Architecture doc is published alongside (Jekyll renders the markdown).
Its previously-relative file links (../src/…) are rewritten to absolute
github.com/.../blob/main/… URLs so they work in both the Pages render
and the GitHub blob view.
The handover file for the nest-trpc-native bug (now fixed in 0.4.3) is
removed; it was archival-only.
After merge, enable Pages from main:/docs:
gh api -X POST repos/nest-native/reference-app/pages \
-f source[branch]=main -f source[path]=/docs
The org's verified custom domain on nest-native.github.io
auto-routes nest-native.dev/<repo>/ to each Pages-enabled repo, so no
CNAME file is required here.
…al package The previous wording led with the name nest-outbox-native and read as if that package existed today. Reword so the bullet is unambiguously a not-built non-goal: the outbox pattern lives here as an in-app module, and a future extraction would only be considered after three+ apps independently rewrite the same shape.
rodrigobnogueira
added a commit
that referenced
this pull request
May 25, 2026
Add landing page at nest-native.dev/reference-app
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 free
to 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.
Summary
https://nest-native.dev/reference-app/resolve, the same way/nest-drizzle-native/and/nest-trpc-native/already do, by enabling GitHub Pages on this repo.nest-trpc-handover.mdarchival file.Changes
docs/index.html— landing page. Hero with tagline + GitHub CTA + architecture-doc CTA + a "stack at a glance" panel. "What it is" section restating the reference-vs-product boundary. Eight-milestone status grid (all done). Link-out section to source, architecture, getting started, CHANGELOG, v0.1.0 release, both library doc sites.docs/styles.css— copied fromnest-native/nest-native.github.ioand extended with.milestones/.links-listblocks for the two new sections. Same dark theme, same radial gradients, same accent/teal palette so the page feels native next to the other org pages.docs/_config.yml— minimal Jekyll config (baseurl: /reference-app, no theme, excludes top-level project metadata files from publishing).docs/architecture.md— in-repo relative links (](../src/…)) rewritten to absolutehttps://github.com/nest-native/reference-app/blob/main/…URLs so the doc renders correctly both fromnest-native.dev/reference-app/architecture.htmland from the GitHub blob view.nest-trpc-handover.md— its content (root cause + TDD plan for the missing-awaitbug innest-trpc-native) was archival; the fix shipped in0.4.3and the repo is on it.Modules Touched
Public Surface (libraries)
Security Review
javascript:, no inline event handlers).Dependency Review
Migrations
Validation
npm run ci— passes locally (45/45 tests, 91.43% statements / 95.55% functions). The docs path is not exercised by CI but adding nothing to the JS path shouldn't affect it.docs/architecture.mdno longer contains any](../relative links:grep -oE '\]\(\.\./'returns empty.Validation Notes
github-pagesRuby gem, which is heavier than the change warrants. If the server build fails on push, Actions will surface it.Pages enablement (one-time, post-merge)
After this PR merges, run once:
The verified custom domain on
nest-native.github.ioauto-routesnest-native.dev/<repo>/to each Pages-enabled repo, so noCNAMEfile is required here. After ~1 minute,
https://nest-native.dev/reference-app/should serve the new landing page.Release Notes
CHANGELOG.mdupdated under[Unreleased]with this landing-page section + the one-time Pages-enablement note.