BinaryKernel

operator guides

Deploy & wire-up

Step-by-step flows — templates on dev.binarykernel.xyz, live on www.binarykernel.xyz, plus subdomains and Hugging Face Spaces.

Dev → live workflow

  1. Build and preview templates on dev.binarykernel.xyz.
  2. When pages are ready, promote the same project to www.binarykernel.xyz.
  3. Keep dev for staging — never push untested templates straight to production.

First landing deploy (live)

  1. Push binarykernel-site to GitHub and connect in Vercel.
  2. Add www.binarykernel.xyz as the primary domain (canonical).
  3. Add binarykernel.xyz with a 308 redirect → www (Vercel CDN recommendation).
  4. Set NEXT_PUBLIC_* env vars for Jira, Slack, and HF URLs when ready.

Dev & templates (dev.binarykernel.xyz)

  1. Add dev.binarykernel.xyz in Vercel → Domains on the staging project.
  2. In DNS: CNAME dev → cname.vercel-dns.com.
  3. Scaffold templates locally, deploy to dev, review animations and copy.
  4. Promote to www.binarykernel.xyz only after sign-off.

Wire a subdomain

  1. Add CNAME in DNS: e.g. hermes.binarykernel.xyz → your target.
  2. In Vercel, add the subdomain only on the project that serves that surface.
  3. Match the subdomain to the HF Space or app listed in /spaces.

Observability (Sentry)

  1. Connect GitHub at binarykernel.sentry.io → Settings → Integrations → SCM.
  2. Set NEXT_PUBLIC_SENTRY_DSN, SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT in Vercel.
  3. staging tag on dev.binarykernel.xyz · production on www.binarykernel.xyz.

Hermes on Hugging Face

  1. Read binarydoc-hermes-space README for secrets list.
  2. Duplicate HermesFace or use BinaryKernel Hermes Space template.
  3. Enable HF dataset sync for persistent memory across restarts.

Domain map

  • apexbinarykernel.xyz
  • wwwwww.binarykernel.xyz
  • devdev.binarykernel.xyz
  • hermeshermes.binarykernel.xyz
  • hfhf.binarykernel.xyz
  • vercelvercel.binarykernel.xyz
  • slackslack.binarykernel.xyz
  • tanstacktanstack.binarykernel.xyz
  • figmafigma.binarykernel.xyz
  • gitgit.binarykernel.xyz
  • hubhub.binarykernel.xyz
  • docsdocs.binarykernel.xyz
  • spacesspaces.binarykernel.xyz