Skip to content

Update LLMs.txt files with current docs and features#92

Merged
steve8708 merged 1 commit intomainfrom
ai_main_5f17f0392528
Mar 25, 2026
Merged

Update LLMs.txt files with current docs and features#92
steve8708 merged 1 commit intomainfrom
ai_main_5f17f0392528

Conversation

@steve8708
Copy link
Contributor

@steve8708 steve8708 commented Mar 25, 2026

Summary

Updates both llms.txt and llms-full.txt in the agent-native docs site to reflect the current state of the framework, including the backend change from Express to Nitro, new templates, updated CLI harness info, and deployment/file sync documentation.

Problem

The existing llms.txt and llms-full.txt files were outdated — they referenced Express backends, an incomplete template list, and missing sections on deployment, file sync, and routing. The CLI harness table and install flow also did not match the current Builder CLI naming and available options.

Solution

Replaced the stale content in both LLM context files with accurate, up-to-date documentation reflecting the current framework architecture, templates, and install flow. Changes were kept minimal and targeted to avoid unnecessary churn.

Key Changes

  • Backend reference: Updated from Express to Nitro in both files
  • New templates added: Mail and Calendar templates added to both llms.txt and llms-full.txt
  • CLI harness table: Added Builder.io (fusion) as a supported CLI alongside Claude Code, Codex, Gemini CLI, and OpenCode
  • Install flow: Simplified quick-start snippet; added --template flag example
  • New doc links: Added Routing and Deployment pages to the markdown docs index in llms.txt
  • Deployment section (llms-full.txt): Added full deployment docs covering Node.js, Cloudflare Workers, SQLite/Turso/Neon/D1 database options, and environment variables
  • File sync section (llms-full.txt): Added createFileSync() docs covering Firestore, Supabase, and Convex adapters
  • Project structure (llms-full.txt): Updated to reflect the current React Router / Nitro-based file layout

Edit in Builder  Preview


To clone this PR locally use the Github CLI with command gh pr checkout 92

You can tag me at @BuilderIO for anything you want me to fix or change

@netlify
Copy link

netlify bot commented Mar 25, 2026

Deploy Preview for agent-native-fw ready!

Name Link
🔨 Latest commit 42e6851
🔍 Latest deploy log https://app.netlify.com/projects/agent-native-fw/deploys/69c3d55fa82cb10008997941
😎 Deploy Preview https://deploy-preview-92--agent-native-fw.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@steve8708 steve8708 enabled auto-merge (squash) March 25, 2026 12:30
@builder-io-integration builder-io-integration bot changed the title Update from the Builder.io agent Update LLMs.txt files with current docs and features Mar 25, 2026
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Mar 25, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
agent-native-calendar 42e6851 Commit Preview URL

Branch Preview URL
Mar 25 2026, 12:31 PM

@steve8708 steve8708 merged commit 4c1f098 into main Mar 25, 2026
12 checks passed
@steve8708 steve8708 deleted the ai_main_5f17f0392528 branch March 25, 2026 12:32
Copy link

@builder-io-integration builder-io-integration bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Builder has reviewed your changes and found 2 potential issues.

Review Details

Code Review Summary

PR #92 updates llms.txt and llms-full.txt to reflect current framework state: Nitro backend, new Mail/Calendar templates, updated CLI harness table, new Deployment and File Sync sections, and corrected project structure. The intent is solid and the new content is significantly more accurate than what it replaces.

Risk: 🟢 Low — documentation-only changes, no runtime code affected.

Key Findings

Critical (Broken Rendering):

  • 🔴 Two missing opening code fences — both llms-full.txt (Installation) and llms.txt (Quick Start) have dangling closing ``` with no matching opening ```bash. The install commands render as plain prose, and the stray fences corrupt subsequent code blocks. Found independently by both review passes.

Other Issues:

  • 🟡 Harnesses doc link is the only entry in llms.txt without a .md suffix, contradicting the sentence immediately above it that says to "append .md to any docs URL"
  • 🟡 Architecture description mismatch — both files still describe the framework as "Files as database / All state lives in files" when the actual framework (AGENTS.md) now uses SQL (SQLite/libsql with application_state, settings, oauth_tokens tables). LLMs consuming these files will be directed to build against JSON files instead of the SQL stores the framework provides.
  • 🟡 Missing closing code fence at EOF in llms-full.txt — the Video template's ```bash block is opened but never closed before the file ends.

Found by running 2 parallel code-review agents with randomized file ordering.


View in Builder.io

Code review by Builder.io

Comment on lines +13 to +17
Create a new project:


npx @agent-native/core create my-app
```

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 Missing opening code fence — install command renders as prose

The npx @agent-native/core create my-app block has a closing ``` but no opening ```bash. The command renders as plain text, and the stray closing fence corrupts the "Or fork a specific template" block immediately after it.


How did I do? React with 👍 or 👎 to help me improve.

Comment on lines +20 to +26
cd my-app
pnpm install
pnpm dev
```

## Templates

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 Missing opening code fence — Quick Start commands render as prose

The four install commands (npx … cd … pnpm install … pnpm dev) have a closing ``` but no opening ```bash. This is the first code example a reader sees in llms.txt and it will appear as unformatted text in every Markdown renderer.


How did I do? React with 👍 or 👎 to help me improve.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants