Skip to content

Align /llms.txt and / content#38

Merged
jancurn merged 2 commits into
version-1from
claude/consistent-api-output-tWuNK
May 26, 2026
Merged

Align /llms.txt and / content#38
jancurn merged 2 commits into
version-1from
claude/consistent-api-output-tWuNK

Conversation

@jancurn
Copy link
Copy Markdown
Member

@jancurn jancurn commented May 21, 2026

Summary

Make the sandbox's / (HTML landing page) and /llms.txt (Markdown for LLMs) cover the same content in the same order.

Both endpoints now share these top-level sections:

  1. Quick links
  2. Connect with MCP
  3. Code execution (bash, Python, TypeScript)
  4. Filesystem endpoints (read, write, mkdir, append, delete, metadata)
  5. Proxy Mappings
  6. Response format
  7. Working directories
  8. Configuration

Changes

  • sandbox/src/templates/llms.md — added the Proxy Mappings section that was previously only on the landing page; switched the code-execution snippets to the same curl examples the landing page uses (instead of mixing TS-fetch / Python-requests snippets).
  • sandbox/src/templates/landing.ejs — added three new collapsible cards after Proxy Mappings: Response format, Working directories, Configuration (previously only in llms.txt).

Test plan

  • npm run build succeeds
  • No new lint errors in changed files
  • Started the sandbox locally and fetched both endpoints — same nine top-level headings appear in the same order on both
  • Manual visual check of the landing page (couldn't run a headless browser in the dev environment)

https://claude.ai/code/session_01Ey8UdUPzR4ZbcLssnoZKis


Generated by Claude Code

claude added 2 commits May 20, 2026 21:05
Both endpoints now cover the same sections in the same order:
Quick links, MCP, Code execution, Filesystem, Proxy Mappings,
Response format, Working directories, Configuration.

- llms.txt: add Proxy Mappings section; replace SDK code examples
  with curl commands matching the landing page
- landing page: add collapsible Response format, Working directories,
  and Configuration cards

https://claude.ai/code/session_01Ey8UdUPzR4ZbcLssnoZKis
Replace the standalone llms.md template with HTML-to-Markdown
conversion of the rendered landing page. The landing page is now
the single source of truth for the content of both endpoints.

- Use node-html-markdown + node-html-parser to convert landing HTML to MD
- Custom <pre> translator reads data-lang for fenced code language
- Strip script/style and elements marked data-no-md, plus copy/collapse
  buttons and status badge before conversion
- Hero h1 becomes "Apify AI Sandbox" (the eyebrow + "Landing page" h1 are
  collapsed into a single proper title)
- Quick Links card now contains a visible endpoint list rendered in both
  HTML and MD; action buttons are kept for HTML and marked data-no-md
- Card titles unified at h2 and example labels at h3 (with CSS to keep
  the previous visual sizing) so the heading hierarchy is consistent in MD
- Pre blocks have a data-lang attribute so fences render with proper
  language tags

https://claude.ai/code/session_01Ey8UdUPzR4ZbcLssnoZKis
@jancurn jancurn marked this pull request as ready for review May 26, 2026 09:15
@jancurn jancurn merged commit 330ebc0 into version-1 May 26, 2026
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.

3 participants