How do I apply my brand style to generated documents?

​

Steps

1. Store your API key in DOCONDA_API_KEY and install the SDK (pip install doconda or npm install @doconda/sdk).
2. Upload a file with your design (a Word file, a presentation, an Excel file, a PDF or an image).
3. Create the document with quality: "standard" and say in the request that it should use that design.

from pathlib import Path
from doconda import Doconda

doconda = Doconda()  # reads the key from DOCONDA_API_KEY
template = doconda.files.upload("brand-template.docx")
doc = doconda.documents.create(
    format="docx",
    prompt="Sales proposal for a logistics client, with our template's design",
    sources=[template["id"]],
    quality="standard",
)
Path("proposal.docx").write_bytes(doconda.documents.download(doc["id"], "docx"))

import { readFile, writeFile } from "node:fs/promises"
import { Doconda } from "@doconda/sdk"

const doconda = new Doconda()
const template = await doconda.files.upload(await readFile("brand-template.docx"), "brand-template.docx")
const doc = await doconda.documents.create({
  format: "docx",
  prompt: "Sales proposal for a logistics client, with our template's design",
  sources: [template.id],
  quality: "standard",
})
await writeFile("proposal.docx", await doconda.documents.download(doc.id, "docx"))

​

What you can ask for in style

• Font: any Google Fonts family, plus Calibri, Cambria, Arial, Times New Roman and Courier New.
• Colors of the title, the headings, the text or the accent, by name or in hex.
• Alignment, size, line spacing, margins and orientation.
• Cover page, table of contents, page numbers, header and footer.

​

What you get back

• An editable file: the look lives in the document’s styles (Normal, Heading 1…), plus its PDF with the font embedded.
• style_applied: how the style was understood, and style_unsupported: what couldn’t be applied.
• The design.chosen event says which file was used as the design.

​

Limits

• Copying the design of a file needs standard or best. In fast the document comes out with its own design and the report says so (design.not_copied).
• The Word file uses the font by name: if whoever opens it doesn’t have it installed, Word uses a similar one. The PDF has it embedded.

​

FAQ

​

Keep reading

• Style and Copy the design of a file.
• Quickstart.