Diffinery

codician/diffinerypublic

Open-source, agent-first GitHub and GitHub Actions alternative that runs on your own Cloudflare account: git hosting, pull requests, code review and drop-in GitHub Actions YAML on Workers, Durable Objects, R2 and Containers.

d77e9f6

Branches

claude/community-replies claude/connector-bad-gateway-doc claude/early-access-cta claude/github-discoverability claude/github-star-buttons claude/graphql-issues claude/mcp-links claude/merged-pr-diff claude/numeric-run-ids claude/readme-reorganize claude/readme-screenshots-up claude/showcase-agents-plugins community-replies lists-archived main marketplace-builds mcp-registry-auth mcp-registry-docs plugins-any-instance privacy-page

Tags

v0.1.0
diffinery/docs/PREFERENCES.md
24 lines · 1022 B
PreviewCode
Raw History

Team preferences

These are strong defaults from the project owners. Follow them where they fit, and use judgment where they don't.

Sign-in: passkeys first

  • People sign in with passkeys (WebAuthn). Don't add passwords.
  • New people create their passkey from their invite link.
  • Recovery goes through a one-time sign-in link from an admin, or email verification through Cloudflare Access at /auth/access. Access guards only that path.
  • Machines (git, the CLI, MCP clients, runners) use Diffinery tokens, never browser sessions.

UI: Kumo

  • The look follows Kumo, Cloudflare's design system: its color tokens (light and dark), radii, type and focus styles. The tokens live as CSS variables in apps/diffinery/src/web/assets.ts.
  • Kumo's components are React. Our pages are rendered on the server with hono/jsx, so for now we match Kumo's tokens and patterns rather than shipping its components. If a page grows into a client-side app, build it with Kumo components.