Neon LawCall +1 510 800 2090
  • Navigator
  • Notations
  • Legal Aid
  • Sign in

Operating Neon Law Navigator

Our firm runs Neon Law Navigator on Google Cloud. This workshop is for admin users with a clone of the public source repository, neon-law/navigator: the people who own billing, secrets, OIDC, runtime configuration, and release verification. It stands up your own instance — the same Rust stack our attorneys use, on your own Google Cloud project, for your own community.

One command does most of the work: hudson ops gcp setup, a provisioner written in Rust that talks to Google's REST APIs directly and ships with a dry-run so you can read the whole plan before a single packet leaves your laptop.

Two things to hold up front. This provisions billable Google Cloud resources — a GKE Autopilot cluster and six core storage buckets, with optional archive and telemetry lanes — so it is not free, and you should set a budget alert before you begin. This is a deployment guide for admin users standing up infrastructure. With that said: you can run the same stack we run. Let's stand it up.

Bring your own typeface license. Neon Law Navigator source code is owned by Neon Law IP LLC. GORP Serif is proprietary font software licensed separately from TrashType and is not covered by the repository's code licenses. If your deployment serves GORP, obtain and maintain the appropriate TrashType license, keep its license notice with your font files, and follow the TrashType terms. Otherwise, replace GORP with a typeface you are licensed to serve before launch.

Start locally with an authorized checkout. You do not need a cloud account to see Neon Law Navigator run. cargo run -p hudson -- dev up brings the whole stack up locally in KIND (the store, OIDC, storage, the workflow broker, embedded Rego), then source .devx/env and cargo run -p neon serves it on localhost. Boot it locally, inspect the canonical seed, and only come back here when you want it on the public internet. The full local loop is in the checkout's AGENTS.md.

Set a budget alert before you provision. The alert notifies you at the configured thresholds. Charges continue while resources run.


gcloud billing budgets create --billing-account "$BILLING_ACCOUNT_ID" \
  --display-name "Neon Law Navigator" --budget-amount 200USD \
  --threshold-rule percent=0.5 --threshold-rule percent=0.9

Idle, the stack runs on the order of an Autopilot cluster's baseline plus six mostly empty buckets — budget for it, watch the first invoice, and size the cluster down if it is more than you need.

Start →View all slidesView as Markdown
1

Chapter 1

Intro

  1. 1Deploy your own
  2. 2Agenda
2

Chapter 2

Prepare Google Cloud

  1. 3Bring your own project
  2. 4Dry-run first
  3. 5Private assets and domain restricted sharing
  4. 6The Navigator deployment matrix
  5. 7The `/app` mount and HTTP route ownership
  6. 8`neon` — the whole brand seam
  7. 9Live rollout checkpoint
  8. 10Set one site to one version
3

Chapter 3

Provision the Infrastructure

  1. 11The APIs that light up
  2. 12Network and storage buckets
  3. 13How a matter's pages reach a client
  4. 14A document's bytes and authorization are separate
  5. 15A private image registry
  6. 16The cluster comes up
  7. 17What setup owns — and what follows it
4

Chapter 4

Operate Forgejo beside Navigator

  1. 18Deploy the forge before switching repositories
  2. 19Separate people, Git transport, and machine access
  3. 20Require the gate and protected-main policy
  4. 21Bind the workflow to one Project and one commit
  5. 22Notify failures even when the manifest is broken
  6. 23Restore the repository before cutting over
5

Chapter 5

Environment Matrix

  1. 24Three operating modes, two deployment profiles
  2. 25The deployment that says its matters are sample
  3. 26Deployment and release switches
  4. 27Workflow host and routing switches
  5. 28Capability and storage switches
  6. 29Configuration precedence: the first source wins
  7. 30Local dev controls: inputs read by `hudson dev`
  8. 31Local runtime: what `.devx/env` generates
  9. 32The store: SurrealDB
  10. 33Where SurrealDB authorization lives
  11. 34Deployed runtime: core web and worker wiring
  12. 35Deployed runtime: identity and access
  13. 36Deployed runtime: email, signatures, and billing
  14. 37Deployed runtime: repositories, content, AI, and scheduled work
  15. 38Provision and ship: variables read by the operator CLI
  16. 39Ancillary operations and opt-in test controls
  17. 40When sample data appears
6

Chapter 6

Configure the Trust Boundaries

  1. 41Secrets: the invariants that gate the boot
  2. 42Secret access, encryption, and audit
  3. 43Sign-in: bring an OIDC provider; passwords live there, not here
  4. 44Role rings: who can do what
  5. 45Provider setup and parity across deployment rows
  6. 46The external surface — every third party, in one place
  7. 47The two service deployments
  8. 48Security architecture
7

Chapter 7

Ship the Instance

  1. 49Ship and verify
  2. 50Point your domain at the instance (optional)
  3. 51Drive it from the CLI
  4. 52Make it yours — white-label under your own brand
  5. 53First-ship lessons
  6. 54Canonical references
Neon Law
  • X opens in a new tab
  • LinkedIn opens in a new tab
  • YouTube opens in a new tab
  • API
  • Blog
  • Contact
  • Design
  • Glossary
  • Navigator
  • Notations
  • Presentations
  • Privacy
  • Team opens in a new tab
  • Terms
  • Testimonials
  • contact@neonlaw.com
  • +1 510 800 2090
  • California
    1515 20th StreetBakersfield, CA 93301
  • Nevada
    5150 Mae Anne AveSte 405-9002Reno, NV 89523
  • New York
    12 E 49th St18th FloorNew York, NY 10017
  • Washington
    1111 Main StSTE 201EVancouver, WA 98660
  • Justice Technology AssociationMission-Aligned Partner opens in a new tab
  • Proud member of Greater Vancouver ChamberGVC opens in a new tab

Attorney advertisement. Nothing here is legal advice without a signed retainer for an active project. Past results do not guarantee future outcomes.

Everyone deserves access to justice.Made with ❤️ in 🗽.

© 2026 Guieb & Shook PC

Powered by neon-law/navigator opens in a new tab26.11.17-rc.1GitHub stars 5