Repository navigation
Adoption kit: one-click deploy, read-only demo, setup screen, README and 0.2.0 changelog - #59
Merged
Merged
Conversation
Demo: `pnpm build:demo` (VITE_DEMO=true) builds the SPA as a static site
on the sample workspace, with no server. Reads answer from the board
(task detail gets a description and, on the handoff, an agent exchange),
writes are turned away as a 403 the store toasts ("this is a read-only
demo"), the welcome dialog and the early WebSocket are skipped, and a
badge links to deploying a real copy (`?embed` hides it). `pnpm
deploy:demo` hosts it as an assets-only Worker (demo/wrangler.jsonc).
The sample data now has delegated tasks and named subtasks, so My Work's
assigned-out rail and subtask rows look real.
Setup screen: a fresh deploy has no Access configured, so every request
401s and the app used to redirect to an Access login that doesn't exist
on that hostname. The public GET /api/setup now reports whether sign-in
is configured ("access", "dev" or "unconfigured"); on a 401 the app asks
it once and, when unconfigured, shows the remaining steps instead, and
stops retrying the socket.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The root wrangler.jsonc is what the Deploy to Cloudflare button reads: it serves the Worker and SPA from a *.workers.dev address with the Durable Object, R2 bucket and queues, keeps dashboard-set variables across redeploys (keep_vars), and leaves out the send_email binding until Email Sending is onboarded. The root `pnpm deploy` now runs scripts/deploy-worker.mjs, which uses apps/api/wrangler.jsonc when a self-hoster has one and the root config otherwise, so existing setups deploy exactly as before. package.json describes the variables the button's setup page shows. CI builds the demo and dry-runs the one-click config alongside the example one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README gains the Deploy to Cloudflare button, a link to the read-only demo, a light/dark board screenshot, the handoff panel and My Work, and a one-click path at the top of the quickstart. CHANGELOG.md records 0.2.0, the first tagged release, covering everything since the initial publish, and package.json moves to 0.2.0. docs/assets also holds a 1280x640 social preview image for the repository settings. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
COMPARISON.md and CONTRIBUTING.md still counted the original 15; the three handoff tools brought it to 18 everywhere else. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README's demo link now points at the hosted read-only demo. ROADMAP.md lists what's next (docs catch-up, an importer resend flag, @-mentions, member management, more importers, directory listings) and what's deliberately out of scope, and the README links it. The MCP server reports 0.2.0 to match package.json and the changelog. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
joelborch
marked this pull request as ready for review
October 20, 2026 16:27
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Makes Flow quick to try and easy to judge from the README. Draft until the demo is hosted: the README's demo link is still the placeholder
DEMO_URL.What's in it
wrangler.jsoncis what the button reads: Worker, SPA, Durable Object, R2 and queues on a*.workers.devaddress.keep_varskeeps dashboard-set variables across redeploys.send_emailbinding is left out until Email Sending is onboarded, so a first deploy can't fail on it.pnpm deploynow runsscripts/deploy-worker.mjs. It uses a self-hoster'sapps/api/wrangler.jsoncwhen present and the root config otherwise, so existing setups are unchanged.package.jsondescribes the variables for the button's setup page.GET /api/setupreportsaccess,devorunconfigured, and the app shows the three remaining steps with a link to the guide.pnpm build:demobuilds a static SPA on the sample workspace, andpnpm deploy:demohosts it as an assets-only Worker (demo/wrangler.jsonc).?embedhides the badge.CHANGELOG.md: 0.2.0, the first tagged release, covering everything since the July publish.package.jsonmoves to 0.2.0.docs/assets/social-preview.png: 1280×640, for the repo's social preview setting.Checks
pnpm typecheckclean.pnpm test: api 476, core 415, web 107, importer 63, all passing. The web and demo builds are ok.deploy-worker.mjspicks each correctly) and the demo config./api/setupreturnsunconfigured, and the app shows the setup screen instead of redirecting.Before merging (needs the maintainer)
pnpm deploy:demoon the maintainer's Cloudflare account, then replaceDEMO_URLin the README.workers.devhostname is documented but untested here, so only a real run proves it.🤖 Generated with Claude Code