diff --git a/website/README.md b/website/README.md
new file mode 100644
index 0000000..ec12c43
--- /dev/null
+++ b/website/README.md
@@ -0,0 +1,29 @@
+# Main website source
+
+`squarespace-home.html` is the maintained HTML code block for
+[www.fullbleed.dev](https://www.fullbleed.dev/). Squarespace owns the surrounding
+navigation, footer and page metadata. This directory is not deployed by MkDocs.
+
+The homepage leads with component authoring, includes a runnable stable Python
+example, and links to the component alpha notebook, paired Northstar/Common
+Ground sources, and the accessible showcase with its retained validation reports.
+The alpha is explicitly labeled; an ordinary install still selects the stable API.
+
+`homepage-example.py` is the exact copyable example. With Python 3.10–3.14:
+
+```sh
+python -m pip install fullbleed
+python website/homepage-example.py
+```
+
+It writes `order.pdf` in the current directory and registers the bundled Inter
+font explicitly. The example was verified with the published 2.5.31 wheel:
+one page, the expected text, embedded fonts, and identical PDF bytes on repeat
+rendering. It does not claim PDF/UA conformance.
+
+To update Squarespace, back up the current homepage code block and global code
+injection, review the candidate in the existing public page shell, and replace
+only the homepage block. Verify the saved page anonymously at desktop and mobile
+widths, including real clipboard contents and linked PDF downloads. Do not paste
+this block into global code injection. Keep the copyable example synchronized
+with `homepage-example.py`.
diff --git a/website/homepage-example.py b/website/homepage-example.py
new file mode 100644
index 0000000..d86af1b
--- /dev/null
+++ b/website/homepage-example.py
@@ -0,0 +1,22 @@
+from importlib.resources import files
+from pathlib import Path
+import fullbleed
+from fullbleed.ui import Document, Heading, Paragraph, Stack, Strong
+
+@Document(title="Order summary", styles={
+ "@page": {"size": "A4", "margin": "18mm"},
+ "body": {"font_family": "Inter", "color": "#18372e"},
+ "h1": {"font_size": "32pt", "margin": 0},
+ "p": {"margin": 0},
+})
+def OrderSummary(customer):
+ return Stack(
+ Heading("Made for you", level=1),
+ Paragraph("Prepared for ", Strong(customer)),
+ gap="12pt",
+ )
+
+font = files("fullbleed_assets").joinpath("fonts/Inter-Variable.ttf")
+engine = fullbleed.PdfEngine(font_files=[str(font)])
+order = OrderSummary("Moss & Fern")
+Path("order.pdf").write_bytes(order.render_pdf(engine))
diff --git a/website/squarespace-home.html b/website/squarespace-home.html
new file mode 100644
index 0000000..3ed67ae
--- /dev/null
+++ b/website/squarespace-home.html
@@ -0,0 +1,193 @@
+
+
+
+
Components + HTML/CSS → PDF
From code to paper.
Invoices, statements, and reports. Compose with Python, JavaScript, or C# components. Bring your own HTML/CSS, too.
Static HTML/CSS, pagination, and typography. A dedicated engine for print documents.
Repeatable by design.
Pin your engine, inputs, assets, and metadata. Compare the resulting PDF bytes.
Yours to build with.
Open source under MIT. Free for personal projects and commercial applications.
+
+
01 / The authoring
A document. Made of components.
+
Write a function. Pass it data. Compose headings, rich text, and layouts with ordinary Python. Styles belong to your document; fonts are bundled with the engine.
+
This example uses the stable Python API and the install command above. Reuse OrderSummary for each customer.
Northstar and Common Ground: one design, two authoring paths. Compare the Python components and HTML/CSS, with matching-output checks on the pinned 2.6.0a5 alpha. Explore both sources ↗
+
+
A report with a point of view.
Editorial type, vector illustration, gradient charts, and clear allocations.
Give order summaries and packing slips the same care as your storefront. Start with a designed template, edit visually or paste HTML/CSS, and preview the actual PDF.
+
Design it once.The free WooCommerce editor runs in your browser. No account, watermark or document quota.
Connect it to the order.Evaluate Pro email attachments and customer account downloads in WooCommerce, or document links in Shopify Flow.
