Skip to content

docs: reframe PRODUCT.md around the durable product identity#133

Merged
Zach Dunn (zachdunn) merged 4 commits into
mainfrom
docs/product-md-reframe
Jul 13, 2026
Merged

docs: reframe PRODUCT.md around the durable product identity#133
Zach Dunn (zachdunn) merged 4 commits into
mainfrom
docs/product-md-reframe

Conversation

@zachdunn

Copy link
Copy Markdown
Member

Feedback-driven rewrite of PRODUCT.md (introduced in #127). The first draft was too tied to the current state: it named the developer as the primary user, described access mechanics, and framed the project as an internal tool — wrong for a public open-source repo, and as design-strategy input it would steer future work toward single-user assumptions (no onboarding, no empty states, polish optional).

Reframed around what's durable:

  • Users: developers and their coding agents, with agents as first-class users reached via CLI/skill/MCP; web surfaces serve deciding (landing/docs) and managing (console/account/admin).
  • Purpose: purpose-built hosting for development workflows, open source, hosted, workspace-isolated. Success stated as a thesis (the default way agents attach visual evidence), not a sprint goal.
  • Anti-references: sharpened the dark+purple entry — the palette family is allowed; default-ness is the tell.
  • Fixed a formatter-mangled bullet and tightened the accessibility section into standing requirements.

No behavior changes; this file steers /impeccable and future design passes.

- favicon is now the pixel-grid chevron mark (crispEdges, #c27eff)
- invite page uses the brand mono stack instead of system mono
- GalleryTile thumbnails render as real <img loading=lazy> so long
  grids stop fetching offscreen thumbs
- signed-in surfaces consolidate onto 11/12/14px type steps
- homepage install footnote drops the docs/source links the site
  footer directly below already carries
Swap the smooth-stroke chevron in Brand.tsx and its Brand.astro mirror
for the crispEdges pixel-grid mark (token fills preserved), matching
the new favicon and the Geist Pixel wordmark. Drop the mark's CSS
border-radius: the pixel frame carries its own stepped corners.
- login h1 'Sign in to uploads.sh' -> 'Sign in' (lockup sits right above)
- compact footer drops the leading 'uploads.sh ·' on card pages
- install section: heading drops 'click to copy' (the buttons say so);
  skill row loses --skill uploads-cli (the package may ship more later);
  skill + mcp nest under 'uploads install', which runs both; footnote
  shrinks to the access note
The first draft described the current deployment moment (named the
developer as the primary user, framed access mechanics) rather than
the product. In a public repo that reads as an internal tool, and as
strategy it would steer design work toward single-user assumptions.
Reframed: developers + their agents as the user base, open-source
hosted service as the shape, success as a durable thesis. Also fixes
a formatter-mangled anti-references bullet.
@coderabbitai

coderabbitai Bot commented Jul 13, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (2)
  • coderabbit:review
  • review
🚫 Excluded labels (none allowed) (1)
  • wip

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 60ad57cc-c82b-4ae0-aa23-78ad4f0e0cb7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/product-md-reframe

Comment @coderabbitai help to get the list of available commands.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
uploads-auth 9b6981a Commit Preview URL

Branch Preview URL
Jul 13 2026, 04:24 PM

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
uploads-web 9b6981a Commit Preview URL

Branch Preview URL
Jul 13 2026, 04:24 PM

@zachdunn Zach Dunn (zachdunn) merged commit f20ca39 into main Jul 13, 2026
5 checks passed
@zachdunn Zach Dunn (zachdunn) deleted the docs/product-md-reframe branch July 13, 2026 16:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant