Getting started

The Studiolo — system overview

A living map of how everything connects. Click any node in the diagrams to learn more. Use the sidebar to navigate sections.

What this is

This documentation site is a dual-native reference — readable by humans and agents alike. It maps the full technical and creative architecture of The Studiolo: how the sites are built, how files flow, how emails are sent, how ideas form into published work.

Every diagram is interactive. Every concept links to a detail panel. This is a living document — it updates as the system evolves.

System overview
Full system map INTERACTIVE
INPUTS ──────── morning raw voice · text files R2 bucket memo JSON · md THE DAILY daily.thestudiolo.com Cloudflare Pages EMAIL ──────────────────── Subscribe Worker POST /subscribe/* Broadcast Worker POST /broadcast/* Resend audiences + send subscriber inbox welcome · digest JSON SITES ──────────────── thestudiolo.com main site lexicon ~105 terms library ~6,700 files commonplace planned live site Worker Resend storage / archive Click any node to learn more.

Dual-native principle: Every file, document, and data structure is readable by both humans and AI agents. Naming conventions, JSON schemas, and folder structures all follow this rule.

Infrastructure

Subdomain map

All DNS managed at Cloudflare. Each subdomain is a Cloudflare Pages project or Worker route.

Current
SubdomainTypeStatusNotes
thestudiolo.comPagesliveMain site
daily.thestudiolo.comPagesliveOpen studio / file browser
subscribe.thestudiolo.comWorkerpendingCustom domain config needed
mail.thestudiolo.comResendliveEmail sending domain, verified
lexicon.thestudiolo.comPageslive~105 terms
library.thestudiolo.comPagesliveDigital library system
docs.thestudiolo.comPagespending deployThis site
Planned
SubdomainPurpose
letters.thestudiolo.comStudiolo Letters archive
commonplace.thestudiolo.comPublic commonplace book
astrology.thestudiolo.comAstrology product
subscribe.nickdecker.netPersonal email flows
DNS + routing architecture INTERACTIVE
Cloudflare DNS thestudiolo.com Pages main + daily Pages lexicon + library Pages docs (this site) Workers subscribe · broadcast Resend MX mail.thestudiolo.com R2 bucket: daily pub-[id].r2.dev Click any node to learn more.

The Daily

Publishing flow

The end-to-end process from memo to published site to email in subscriber inboxes. Every night, 8:30–10pm.

Nightly publish flow · 8:30–10pm EST INTERACTIVE
8:30pm 9:00pm 9:15pm 9:25pm 10:00pm Finalize memo + .docx Organize + upload files R2 bucket Update JSON YYYY-MM-DD.json + index.json Deploy site zip → Pages upload Trigger broadcast → inbox DAILY FILE STRUCTURE YYYY-MM-DD/ astrology/ claude/ morning-raw.md actively-building.md memo-NNN.docx pdfs/ screenshots/ music/ notebook-lm/ → R2: pub-[id].r2.dev/YYYY-MM-DD/ data/YYYY-MM-DD.json { date: "2026-03-13" status: "published" memo: { number: "003" title: "..." body: [...] } featured_files: [...] files: [...] }

Email

How email works

The full email pipeline — from React template to subscriber inbox. Built on Resend + Cloudflare Workers.

Email pipeline · template → inbox INTERACTIVE
TEMPLATE LAYER RENDER LAYER RUNTIME LAYER welcome.tsx React Email component src/emails/ render-emails.tsx JSX → static HTML npm run render-emails welcome-html.ts pre-compiled HTML string auto-generated · never edit deploy index.tsx Cloudflare Worker subscribe + broadcast Resend API sends to audience mail.thestudiolo.com subscriber inbox welcome · daily digest Why pre-render? Workers runtime can't run react-dom/server streaming APIs. HTML is compiled at deploy time.
Key files
worker/ ├── src/ │ ├── index.tsx ← Worker logic. Add new routes here. │ └── emails/ │ ├── welcome.tsx ← EDIT THIS to change email content. │ └── welcome-html.ts ← auto-generated. never touch. ├── scripts/ │ └── render-emails.tsx ← add new templates here. ├── wrangler.toml ← Worker config + env vars └── package.json ← npm run deploy runs render first
Deploy sequence
# Edit email content: $ edit src/emails/welcome.tsx # Compile + deploy (runs render-emails automatically via predeploy): $ npm run deploy # Or step by step: $ npm run render-emails # regenerates welcome-html.ts $ wrangler deploy # pushes Worker to Cloudflare

Email

Email anatomy

The structure of every daily digest email. Consistent sections, generated from the day's JSON.

Daily digest — section map INTERACTIVE
wordmark + date the daily · Mar 13, 2026 · No. 003 AUTHENTICITY IS NOT ENOUGH In the pursuit of skilled authenticity Most of us were trained to choose between two bad options: swallow what you really think, or say it without mercy... Today's files → Vignelli Canon.pdf → actively-building.md → what-good-shall-i-do.jpg (3–5 curated · links to R2) ~ signature image ~ Nick Decker Cincinnati, Ohio The Studiolo · The Daily · nickdecker.net Unsubscribe · daily@mail.thestudiolo.com ① HEADER ② MEMO TITLE ③ BODY ④ FILE HIGHLIGHTS ⑤ SIGNATURE ⑥ FOOTER Click any section to learn more.
Design invariants
PropertyValue
FontMenlo, Monaco, Consolas, 'Courier New', monospace
Font size13px body · 18px headline · 11px footer
Brand red#c0392b
Max width560px
Card padding36px 32px
Send time10pm EST daily
From addressdaily@mail.thestudiolo.com

Email

subscribe.thestudiolo.com

A landing page for all Studiolo email flows. Each flow is a separate Resend audience with its own subscribe path, welcome email, and cadence.

subscribe.thestudiolo.com · flow tree INTERACTIVE
subscribe.thestudiolo.com all available flows The Daily /daily Welcome instant Daily digest 10pm EST · nightly Milestone occasional Studiolo Letters /letters Welcome instant · sets frame Evergreen seq. 5 emails · days 2–14 Regular letter weekly or biweekly Astrology /astrology Welcome orients reader Orientation seq. what to expect Transit updates weekly or event-driven Future flows /[theme] Welcome templated pattern Evergreen seq. 3–5 emails Broadcast cadence TBD Resend free tier: 1,000 contacts total across all audiences. Click to learn more. Each flow = 1 Resend Audience + 1 Worker route + 1 welcome template + broadcast capability. Click any node to learn more.

Email

subscribe.nickdecker.net

Personal email flows — distinct voice from The Studiolo. Same infrastructure pattern, different audiences and framing.

Dual-native framing: Personal and professional are not competing — they're the same person at different angles of expression. nickdecker.net is personal voice. thestudiolo.com is professional practice.

subscribe.nickdecker.net · flow tree INTERACTIVE
subscribe.nickdecker.net personal hub — all personal flows Personal letter /letter Welcome who Nick is, why here Intro seq. 3 emails · days 2–10 Personal letter sporadic, honest Making + building /building Welcome what you'll receive Foundations seq. stack + philosophy Build dispatches as shipped, irregular Music + process /music Welcome musical context Listen notes releases + field notes Process update irregular, honest Expand as needed /[theme] Welcome reusable pattern Evergreen seq. your best thinking Broadcast cadence TBD Click any node to learn more. Same infrastructure as thestudiolo.com — separate Resend audiences per flow.

Creative process

Morning capture

The first signal of the day — raw, unfiltered, associative. This is where everything starts.

Morning raw → synthesis chain INTERACTIVE
Voice memo iPhone Transcript Whisper / manual morning-raw.md YYYY-MM-DD/claude/ PDF export → NotebookLM NLM podcast → transcript.md seeds Daily memo crystallized from raw signal + day's research Published JSON → site → email Click any node to learn more.
Files produced each morning
FileLocationPurpose
YYYY-MM-DD-morning-raw.mdclaude/Unfiltered capture. Seeds the day's memo.
YYYY-MM-DD-morning-synthesis.mdclaude/Structured distillation. Key ideas extracted.
YYYY-MM-DD-teachable-concepts.mdclaude/Concepts worth developing into letters or content.
astrology-transits-YYYY-MM-DD.pngastrology/Daily chart. Context for the day.

Getting started

The full stack

Complete technical inventory — every service, tool, and infrastructure component.

Coming soon. This page is being built. Check back as the docs evolve.

thestudiolo.com

Site configuration

How thestudiolo.com is built, deployed, and updated.

Coming soon.

thestudiolo.com

Brand + identity guidelines

Typography, color system, voice, and visual identity for The Studiolo.

Coming soon.

The Daily

Overview

What The Daily is, how it works, and why it exists.

Navigate to Publishing flow in the sidebar to see the full nightly process.

The Daily

JSON schema

The data structure that drives the site and email.

Coming soon. See Email → How email works for the current schema overview.

The Daily

File storage (R2)

How files are organized, uploaded, and served from Cloudflare R2.

Coming soon.

Email

Building new emails

Step-by-step guide to adding new email templates and flows.

Coming soon. Reference the email-build-guide.md in your claude/ folder for the full process.

Creative process

Memo formation

Coming soon.

Creative process

Letters formation

Coming soon.

Creative process

Social → owned archive

Coming soon.

Subdomains

lexicon.thestudiolo.com

Coming soon.

Subdomains

library.thestudiolo.com

Coming soon.

Subdomains

commonplace.thestudiolo.com

Planned. A public-facing commonplace book — curated highlights from the Library and Daily archives.

Subdomains

letters.thestudiolo.com

Planned. Archive of published Studiolo Letters.