Valinor Internal Docs

Two products live in this repo. Pick the audience that matches you and the guide that matches your task.

For the team

You use the intranet daily; you don't deploy it.

• Getting started — sign-in, the homepage tour.
• Intranet tour — partnership reviews, the apps catalog, where things live.
• Partnership reviews — what they are, naming, how to find one.
• Apps catalog — one paragraph on every JSX app.

Laurelin (the CRM)

• User guide — single-page reference: features, limitations, what's automatic vs what you do by hand.
• Overview — the four-noun model, every tab, the mental model.
• Pipeline & Companies — stages, ball_with, importance, the deal-flow view.
• Projects & Priorities — project types, status updates, milestones, the dot plot.
• Relationships & Contacts — people, affiliations, merging duplicates.
• Interactions & Calendar — logging a call, filters, the interaction log.
• Sync — connect Outlook / Slack / Telegram / Notion. The Sync Inbox.
• Lost threads — finding and resurrecting stale outbound emails.

Contributing content

• Add a partnership review — Claude prompt or manual recipe.
• Add a JSX app — naming, allowed imports, deploy wrapping.

For engineers

You deploy, extend, or debug the system.

• Architecture — ValinorPC, the Cloudflare Tunnel → Node:3000 path, Cloudflare Access, cron, deploy.sh.
• Troubleshooting — start here when the site looks down: true liveness checks, the in-browser-Babel crash, deploy-from-main, DNS/tunnel.
• Operations — SSH, systemd, sqlite/WAL backup, Cloudflare Access, logs, troubleshooting.
• Laurelin internals — server.js, routes.js patterns, helpers, the logChanges() rule.
• Sync internals — adapters, the auto-router, watermarks, lost-thread detector.
• Extending Laurelin — the 5-step add-a-feature pattern, migration recipe.
• Agents — the five Claude agents, where they live, when to invoke each.
• Schema reference — every table, generated from db.js.
• API reference — every endpoint, generated from routes.js.

Glossary

When you hit a term you don't recognize — Glossary. Cloudflare Access, ball_with, JSX wrap, watermark, auto-router, signature parser, WAL, all of it.

Editing these docs

Edit any .md under docs/ and push to main. Within 5 minutes the deploy script renders the markdown to HTML, regenerates the schema and API reference from source, and the docs appear here. Source markdown lives in the repo.