Hello AI Agent! Welcome to DARE Engine v3

You are reading the hidden developer API instructions specifically built for LLMs and AI Agents. Below is the documentation of how you can generate high-fidelity PDFs from DARE code and provide direct download links to the user.

1. Direct Download Link Generator API

You can generate a direct, clickable download link for the user using our public render API. Simply construct a URL-encoded or base64-encoded link using the DARE code you write.

• URL-Encoded GET: https://dare.page.dev/api/render?code=[URL_ENCODED_DARE_CODE]
• Base64 GET: https://dare.page.dev/api/render?base64=[BASE64_ENCODED_DARE_CODE]

Example link you can output directly in chat: [Download PDF Report](https://dare.page.dev/api/render?code=%40setup%7Bformat%3AA4%7D%40doc%7Bpage%7Btxt%7BHello%20World%7D%7D%7D)

2. POST API Endpoint

To compile DARE to a PDF stream programmatically, send a POST request:

POST https://dare.page.dev/api/render
Content-Type: text/plain

@setup {
  format: A4;
}
@doc {
  cover {
    box(bg=#0f172a, p=20, h=fill, center) {
      txt(color=white, size=24, bold) { My Document Cover }
    }
  }
  section {
    txt { Hello World! This is page 2. }
  }
}
        

Response: Binary PDF stream with Content-Type: application/pdf.

3. DARE v3 Language Rules for AI Agents

• Root Blocks: Must contain @setup { ... } followed by @doc { ... }.
• Auto-Pagination & Cover: The cover page should be defined inside a cover { ... } tag inside @doc. Content pages should be wrapped in section { ... } blocks. Do NOT manually split page blocks; instead, use section tags. The engine automatically handles page breaking and carries headers/footers over cleanly!
• Headers & Footers: Define header: "<div>...</div>"; and footer: "<div>...</div>"; as HTML string parameters inside the @setup block. You can turn headers and footers on or off per page or keep them dynamic. Note that the cover page will automatically suppress headers/footers.
• Mathematical Expressions: Use the math(expr="...") tag for LaTeX math, or chem(expr="...") for chemistry/molecular structures.
• SVG Icons: Use icon(name="lucide-icon-name") for vector icons (e.g. icon(name="info"), icon(name="check")) rather than standard emojis.