Repository navigation
feat: docs on Mintlify (apps/docs) and the Trust Center as its own app (apps/trust) - #308
Conversation
…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
|
Merged with Axel's approval. Docs now come from Mintlify (
@Lin1er updated DNS request (replaces the ones in #306), all in the
@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. |
|
Live on the hosted demo:
|
|
@Lin1er the
Full list for you, in one place: the three above, plus |
|
@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
Vercel then issues the certificates itself. I will check both once they are changed. |
|
DNS is in, all in the
@Lexirieru over to you for your checks. |
|
@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
@AncungAulia your #311 to #313 are what these serve. The landing footer links now open. |
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/docsis a Mintlify project:docs.json+ 29.mdxpages (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 againsthttps://api.hellonear.xyz. OpenAPI source is the raw GitHub URL ofmain'sdocs/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. CIdocs.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.txtand.mdper page. Same content and rules (no badges, no "audit" claim, no names, every Yes linked to proof). CItrust.yml. Deploy: Vercel projecthellonear-trustwith the Vercel CLI.CLAUDE.md,apps/docs/CLAUDE.md,apps/trust/CLAUDE.md.Tests (local)
bun run test10 pass 0 fail (also from a fresh checkout), build ok, every route 200, unknown 404.bunx mint@4.2.1184 validatepassed,broken-links --check-anchorsnone.mint dev(:3333) Introduction, API reference, Endpoints; trust on :3400 Overview with the scope table.After merge
hellonear, branchmain, docs.json in subdirectory/apps/docs; Domain setupdocs.hellonear.xyz.apps/trustto Vercel, addtrust.hellonear.xyz, then the CNAMEs for James.hellonear-docs(old Next app) becomes stale.Not proven yet
Mintlify's hosted build from this repo, the
.mintlify.siteURL, and the two workflows on GitHub (they run on this PR).🤖 Generated with Claude Code
https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e