docs: lead with react-dropzone versus framing, surface skills + registry install by vasanth-rb · Pull Request #25 · autorender/react-mediadrop

vasanth-rb · 2026-07-22T06:54:07Z

Summary

README + docs Introduction lead with the react-dropzone comparison up front (was buried in README's "Why" section, absent from docs entirely).
Adds a shadcn GitHub-registry install path (npx shadcn@latest add autorender/react-mediadrop/dropzone) for the four registry blocks, documented in README, docs, and the agent skill (skills/mediadrop/references/registry-blocks.md). Holds off on the @mediadrop/dropzone namespace form until shadcn-ui/ui#11239 merges.
Surfaces npx skills add autorender/react-mediadrop and Context7 indexing next to npm install on the README's first screen instead of only on its own docs page.
Agent skill now points agents at the registry blocks before hand-rolling markup, and states the shadcn init prerequisite next to the install-form explanation.

Test plan

Diffed all files — prose-only changes, no JSX/component edits
Docs site preview build (CF Pages / Blume)

changeset-bot · 2026-07-22T06:54:13Z

⚠️ No Changeset found

Latest commit: 72595c6

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

coderabbitai · 2026-07-22T06:54:43Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

📝 Walkthrough

Walkthrough

The documentation positions mediadrop as a headless, react-dropzone-compatible, hooks-first uploader and adds Agent Skill, Context7, and shadcn registry guidance.

Changes

Documentation updates

Layer / File(s)	Summary
Product positioning `README.md`, `apps/docs/docs/index.mdx`	Describes mediadrop as a headless, hooks-first react-dropzone alternative with compatible prop shapes and `useMediaDrop` upload behavior.
Agent access guidance `README.md`, `apps/docs/docs/getting-started/agent-skill.mdx`	Adds Agent Skill installation and Context7 access information.
Registry blocks guidance `README.md`, `skills/mediadrop/SKILL.md`, `skills/mediadrop/references/registry-blocks.md`	Documents shadcn registry blocks, installation commands, prerequisites, and guidance for using blocks or `useMediaDrop` directly.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

autorender/react-mediadrop#21: Adds the dropzone shadcn registry block implementation described by these documentation updates.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the docs-focused shift to react-dropzone framing plus the added skills and registry install guidance.

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch docs/react-dropzone-alternative-framing

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

cloudflare-workers-and-pages · 2026-07-22T06:55:07Z

Deploying react-mediadrop with Cloudflare Pages

Latest commit:	`72595c6`
Status:	✅ Deploy successful!
Preview URL:	https://5bd4ad6d.react-mediadrop.pages.dev
Branch Preview URL:	https://docs-react-dropzone-alternat.react-mediadrop.pages.dev

View logs

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/docs/docs/index.mdx`:
- Around line 6-9: Update the introductory description of react-mediadrop to
explicitly state that the upload engine is opt-in via the transport option,
keeping the existing claims and useMediaDrop contract accurate.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c5332149-f251-4dce-a3a6-525c58e5904a

📥 Commits

Reviewing files that changed from the base of the PR and between f4aebc9 and 57b59e9.

📒 Files selected for processing (2)

README.md
apps/docs/docs/index.mdx

coderabbitai

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/mediadrop/references/registry-blocks.md`:
- Around line 24-27: Update the GitHub-registry address explanation near the
`owner/repo/item` form to state that it requires an existing shadcn/ui project
initialized with `shadcn init`, while clarifying that no additional registry
setup is needed. Keep the pending `@mediadrop/<item-name>` namespace warning
unchanged.
- Around line 18-21: Pin the registry item references in the install examples by
appending the appropriate tag or commit after # in
skills/mediadrop/references/registry-blocks.md lines 18-21 and
skills/mediadrop/SKILL.md lines 105-109; apply the same update to the
corresponding examples in README.md lines 106-110, preserving the existing item
names.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 973df114-8dbd-401c-89bf-fe520240b24d

📥 Commits

Reviewing files that changed from the base of the PR and between ae6faf0 and 2f80a8c.

📒 Files selected for processing (3)

apps/docs/docs/getting-started/agent-skill.mdx
skills/mediadrop/SKILL.md
skills/mediadrop/references/registry-blocks.md

…try install README and docs Introduction now state the react-dropzone comparison up front instead of burying it in the Why section. Also adds the AI-agent skill install command next to npm install, and a shadcn GitHub-registry install path for the four registry blocks.

…olling markup Adds references/registry-blocks.md documenting the four blocks and the GitHub-registry install command, wires it into SKILL.md's quickstarts + hard rules, and links it from the agent-skill docs page.

…tion

coderabbitai Bot reviewed Jul 22, 2026

View reviewed changes

Comment thread apps/docs/docs/index.mdx Outdated

vasanth-rb force-pushed the docs/react-dropzone-alternative-framing branch from 57b59e9 to 73dd00e Compare July 22, 2026 07:00

coderabbitai Bot reviewed Jul 22, 2026

View reviewed changes

Comment thread skills/mediadrop/references/registry-blocks.md

Comment thread skills/mediadrop/references/registry-blocks.md Outdated

vasanth-rb added 4 commits July 22, 2026 12:58

docs: surface Context7 indexing next to the skills install

33bf06b

docs: co-locate shadcn init prerequisite with owner/repo/item explana…

72595c6

…tion

vasanth-rb force-pushed the docs/react-dropzone-alternative-framing branch from 2f80a8c to 72595c6 Compare July 22, 2026 07:29

vasanth-rb merged commit 99578a4 into main Jul 22, 2026
10 checks passed

vasanth-rb deleted the docs/react-dropzone-alternative-framing branch July 22, 2026 07:35

coderabbitai Bot mentioned this pull request Jul 25, 2026

docs: sync README Why/Comparison sections, zero-dependency positioning #27

Merged

2 tasks

Navigation Menu

Uh oh!

docs: lead with react-dropzone versus framing, surface skills + registry install - #25

docs: lead with react-dropzone versus framing, surface skills + registry install#25
vasanth-rb merged 4 commits into
mainfrom
docs/react-dropzone-alternative-framing

vasanth-rb commented Jul 22, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Jul 22, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 22, 2026 •

edited

Loading

Reviews paused

Walkthrough

Changes

Uh oh!

cloudflare-workers-and-pages Bot commented Jul 22, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot left a comment

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

vasanth-rb commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

changeset-bot Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

coderabbitai Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Changes

Uh oh!

cloudflare-workers-and-pages Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying react-mediadrop with Cloudflare Pages

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

vasanth-rb commented Jul 22, 2026 •

edited

Loading

changeset-bot Bot commented Jul 22, 2026 •

edited

Loading

coderabbitai Bot commented Jul 22, 2026 •

edited

Loading

cloudflare-workers-and-pages Bot commented Jul 22, 2026 •

edited

Loading