Skip to content

chore: update package description, keywords and size badge - #15

Merged
milamer merged 1 commit into
mainfrom
chore/package-metadata
Nov 9, 2026
Merged

milamer merged 1 commit into
mainfrom
chore/package-metadata

Conversation

@milamer

@milamer milamer commented Nov 9, 2026

Copy link
Copy Markdown
Owner

Makes the package easier to find on npm and GitHub. Should merge before the 1.1.0 release: npm only updates the description and keywords with a published version. chore: doesn't release by itself.

Changes

  • Description: "A tiny node module for parsing FormData…" → "Tiny (under 2 kB), dependency-free parser that turns FormData into nested objects and arrays, based on the field names. Works in browsers, Node.js, Deno, Bun and edge runtimes." It matches the README and drops "node module".
  • Keywords: added form-data, lightweight, multipart, nextjs, no-dependencies, parser, react-router, remix, server-actions, tiny, typescript, urlsearchparams, zero-dependency. qs is deliberately not a keyword.
  • README:
    • A size badge "min+brotli < 2 kB", linked to .size-limit.json.
    • One sentence in the intro about the size.
    • The license and code-of-conduct links now point to main instead of master.

Why a static size badge

The claim is "under 2 kB" and not today's size (ESM 1.33 kB, umd.min 1.50 kB). That way 1.2, which must raise the umd.min limit, doesn't make it false. The limit in .size-limit.json should stay at or below 2 kB to keep the claim true.

The dynamic badges don't work well:

  • Bundlephobia (shields.io and badgen) currently returns 429 "rate limited".
  • bundlejs didn't respond.
  • npm's "unpacked size" shows 109 kB, because it counts source maps and all four builds.

The static badge links to the CI-enforced limit instead.

npm run validate passes.

- Description: drop "node module", say it's under 2 kB, dependency-free
  and works in all modern runtimes. npm search weighs the description and
  keywords most.
- Keywords: add the terms people search for (form-data, multipart,
  urlsearchparams, remix, react-router, nextjs, server-actions, tiny,
  zero-dependency, ...).
- README: a static "< 2 kB" size badge linked to .size-limit.json (CI
  enforces the limit; Bundlephobia badges are rate-limited), the size in
  the intro, and blob/master links changed to main.
@milamer
milamer merged commit f491c89 into main Nov 9, 2026
7 checks passed
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (1ece858) to head (570066f).
⚠️ Report is 1 commits behind head on main.
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@            Coverage Diff            @@
##              main       #15   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            4         4           
  Lines          125       125           
  Branches        44        44           
=========================================
  Hits           125       125           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@github-actions

github-actions Bot commented Nov 9, 2026

Copy link
Copy Markdown

🎉 This PR is included in version 1.1.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants