Skip to content

feat: docs on Mintlify (apps/docs) and the Trust Center as its own app (apps/trust) - #308

Merged
Lexirieru merged 4 commits into
mainfrom
feat/mintlify-trust
Nov 12, 2026
Merged

Lexirieru merged 4 commits into
mainfrom
feat/mintlify-trust

Conversation

@Lexirieru

Copy link
Copy Markdown
Contributor

Axel's call (13 Nov): docs on Mintlify, and the Trust Center in its own folder instead of inside docs. Replaces the Next.js docs app from #306.

What

  • apps/docs is a Mintlify project: docs.json + 29 .mdx pages (same text and order as feat(docs): docs.hellonear.xyz with Swagger, llms.txt and MCP, and the Trust Center at trust.hellonear.xyz #306), Endpoints tab with all 63 operations and a playground against https://api.hellonear.xyz. OpenAPI source is the raw GitHub URL of main's docs/openapi.json (Mintlify forbids ../ paths; a copy would drift). Mintlify itself serves llms.txt, Markdown export, skill.md and search MCP, so that code is removed. Navbar: Trust, Status, GitHub. CI docs.yml: mint validate + mint broken-links (pinned).
  • apps/trust (trust.hellonear.xyz): the Trust Center as its own Next.js app at /, /resources, /subprocessors, /faq, /updates, plus /llms.txt and .md per page. Same content and rules (no badges, no "audit" claim, no names, every Yes linked to proof). CI trust.yml. Deploy: Vercel project hellonear-trust with the Vercel CLI.
  • Root CLAUDE.md, apps/docs/CLAUDE.md, apps/trust/CLAUDE.md.

Tests (local)

  • trust: typecheck ok, bun run test 10 pass 0 fail (also from a fresh checkout), build ok, every route 200, unknown 404.
  • docs: bunx mint@4.2.1184 validate passed, broken-links --check-anchors none.
  • Chrome: docs on mint dev (:3333) Introduction, API reference, Endpoints; trust on :3400 Overview with the scope table.
  • Load test: not run; static sites, no shared backend path changed.

After merge

  • Mintlify Git settings: repo hellonear, branch main, docs.json in subdirectory /apps/docs; Domain setup docs.hellonear.xyz.
  • Deploy apps/trust to Vercel, add trust.hellonear.xyz, then the CNAMEs for James.
  • The Vercel project hellonear-docs (old Next app) becomes stale.

Not proven yet

Mintlify's hosted build from this repo, the .mintlify.site URL, and the two workflows on GitHub (they run on this PR).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e

Lexirieru and others added 4 commits November 13, 2026 04:59
…near.xyz

Axel wants the Trust Center in its own folder, not inside the docs (which
move to Mintlify next). Same content and rules as /trust in apps/docs,
now at the root: / (Overview), /resources, /subprocessors, /faq,
/updates, plus /llms.txt and every page as Markdown (/<path>.md or
Accept: text/markdown). Links to product pages now point at
https://docs.hellonear.xyz/<page>; the OpenAPI link points at the spec on
GitHub. Own CLAUDE.md (Vercel project hellonear-trust, prebuilt deploys)
and CI (trust.yml).

Tests: bun run typecheck ok; bun run test 10 pass, 0 fail (tabs, no
dashes or emoji, no badges or audit claim, links, every Yes linked,
llms.txt, markdown, proxy); bun run build ok; dev on :3400 answers 200
for the five tabs, /faq.md, /index.md, Accept: text/markdown and
/llms.txt, 404 for an unknown path.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
…p and its /trust are removed

Axel set up a Mintlify project (Starter) connected to this repo. apps/docs
is now that project: the 29 docs pages as .mdx with the same text and the
same sidebar order, docs.json (Stone & Lime colors, HelloNear logo and
favicon from design/logo, navbar Trust / Status / GitHub), and an
Endpoints tab Mintlify generates from docs/openapi.json on main through
its raw GitHub URL (Mintlify refuses ../ paths, and a copy would drift).
Links to the old app's own files (/openapi.json, /trust, /llms.txt,
/skill.md, /mcp) now point at GitHub, trust.hellonear.xyz and Mintlify's
generated equivalents. The Next.js app, Swagger UI and our MCP server are
gone; Mintlify serves llms.txt, Markdown per page, skill.md and a search
MCP. The Trust Center lives in apps/trust (previous commit). CI docs.yml
now runs mint validate and broken-links --check-anchors (mint 4.2.1184).

Tests: bunx mint@4.2.1184 validate: build passed, validation passed;
broken-links --check-anchors: no broken links; mint dev on :3333: all
docs pages 200, Endpoints tab lists 63 operations, an endpoint page shows
its playground against https://api.hellonear.xyz (checked in Chrome).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
Layout and CI tables: apps/docs is the Mintlify docs site (CI: mint
validate and broken-links), apps/trust is the Trust Center on Vercel
(CI: typecheck, unit tests, next build).

Tests: none needed for a table change; the folders' own checks ran in
the two commits before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
…ject

The hellonear-trust project was made with `vercel project add`, which has
no framework preset, so `vercel build` looked for a public/ output folder
and failed. With the preset it built and deployed: hellonear-trust.vercel.app
answers 200 on /, /resources, /subprocessors, /faq, /updates, /llms.txt and
/faq.md, 404 on an unknown path. CLAUDE.md names the CNAME target.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
@Lexirieru
Lexirieru merged commit c10c88f into main Nov 12, 2026
2 checks passed
@Lexirieru

Copy link
Copy Markdown
Contributor Author

Merged with Axel's approval. Docs now come from Mintlify (apps/docs), the Trust Center is its own app (apps/trust).

  • Trust Center is live on Vercel: https://hellonear-trust.vercel.app (/, /resources, /subprocessors, /faq, /updates, /llms.txt checked 200).
  • Docs: the Mintlify site builds once Axel points the Mintlify project at this repo (apps/docs); I'll post its URL here.

@Lin1er updated DNS request (replaces the ones in #306), all in the hellonear.xyz Cloudflare zone, DNS only (not proxied):

Type Name Target
CNAME trust 0d1d4df456d2b41a.vercel-dns-017.com (new: its own Vercel project now)
CNAME status e658d8fd4c40ebb3.vercel-dns-017.com (from #303)
CNAME docs hold: Mintlify gives the target, I'll post it here

@AncungAulia please review the UI at the trust URL above (and the docs once the Mintlify URL is up); changes in a PR mentioning Axel, he merges. The footer links are in #307.

@Lin1er

Lin1er commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Live on the hosted demo: main c10c88f (automatic deploy after the merge).

  • Before: 879764b, and the box matched git at that revision. CI: passed: mintlify,build.
  • GET /v1/health → {"ok":true,"engine":true,"revision":"c10c88f"}. No rollback.
  • Rollback target: 879764b (/opt/hellonear/release-old).

@Lexirieru

Copy link
Copy Markdown
Contributor Author

@Lin1er the docs records from Mintlify (the project is now connected to this repo, apps/docs on main; the site already runs at https://hellonear.mintlify.site). Mintlify wants the two TXT records first, then the CNAME, all in the hellonear.xyz zone, DNS only (not proxied):

Type Name Value
TXT _acme-challenge.docs AyI0K-oTye-yQIDLhwWUEIBomti5bMrFp2TdSjRPCKA
TXT _cf-custom-hostname.docs e0eb8ef7-fa0b-4a16-825c-28412202f8d5
CNAME docs cname.mintlify.builders

Full list for you, in one place: the three above, plus trust CNAME 0d1d4df456d2b41a.vercel-dns-017.com and status CNAME e658d8fd4c40ebb3.vercel-dns-017.com. Thanks!

@Lexirieru

Copy link
Copy Markdown
Contributor Author

@Lin1er Thanks, docs.hellonear.xyz is live (200, /llms.txt 200). trust.hellonear.xyz and status.hellonear.xyz return Cloudflare 525: both records are proxied (orange cloud), so dig shows Cloudflare IPs instead of the Vercel CNAME. Vercel has both domains verified. Could you change them to CNAME, DNS only (grey cloud), with Axel's approval:

Name Type Target Proxy
trust CNAME 0d1d4df456d2b41a.vercel-dns-017.com DNS only
status CNAME e658d8fd4c40ebb3.vercel-dns-017.com DNS only

Vercel then issues the certificates itself. I will check both once they are changed.

@Lin1er

Lin1er commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

DNS is in, all in the hellonear.xyz zone, DNS only: TXT _acme-challenge.docs, TXT _cf-custom-hostname.docs, CNAME docs → cname.mintlify.builders, CNAME trust → 0d1d4df456d2b41a.vercel-dns-017.com, CNAME status → e658d8fd4c40ebb3.vercel-dns-017.com. Checked just now, each with a valid certificate:

@Lexirieru over to you for your checks.

@Lin1er Lin1er mentioned this pull request Nov 13, 2026
5 tasks
@Lexirieru

Copy link
Copy Markdown
Contributor Author

@Lin1er Thanks, all three are live now. After the records went DNS only, Vercel had not issued certificates yet (TLS handshake reset), so I issued them with vercel certs issue.

@AncungAulia your #311 to #313 are what these serve. The landing footer links now open.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants