SEO optimized readme doc

[ashutoshkhainar33-star]

FastPix Resumable Uploads SDK - Documentation PR

Documentation Changes

What Changed

• New documentation added
• Existing documentation updated
• Documentation errors fixed
• Code examples updated
• Links and references updated
• Other

Files Modified

• README.md
• docs/ files
• USAGE.md
• CONTRIBUTING.md
• Other: _______________

Summary

Brief description of changes:

Rewrote README.md as an SEO/AEO-optimized landing page to improve discoverability in
Google and AI assistants, without changing any code.

Added:
- Badges (npm version, downloads, bundle size, license, Built with TypeScript)
- A benefit-led H1 and a plain-language value proposition + "Works with" line
- A "Why this SDK?" section and a search-friendly "Install the large-file upload SDK" heading
- A "Before you start" prerequisites section
- An FAQ (how to upload large files, pause/resume, retries, chunk size, progress, TypeScript, CDN)
- A Troubleshooting section
- A "Which FastPix upload SDK for your platform" interlink table (all sibling repos verified to exist)

Kept intact: every code example (byte-for-byte), the parameters table, and the References
section. Wording was grounded in real keyword demand (e.g. "upload large files",
"large file upload").

Note for reviewers: the intro's TypeScript line ("publishing only the JavaScript output...
types in a later version") appears stale vs package.json, which declares/builds/exports
types. This PR does not change that line - flagging for a maintainer to confirm and update.

Code Examples (if Applicable)

// If you added/updated code examples, include them here
import { Uploader } from "@fastpix/resumable-uploads";

const fileUploader = Uploader.init({
  endpoint: "https://example.com/signed-url",
  file: mediaFile,
  chunkSize: 5 * 1024, // 5MB (5120 KB)
});

Testing

• All code examples tested
• Links verified
• Grammar checked
• Formatting consistent

Review Checklist

• Content is accurate
• Code examples work
• Links are working
• Grammar is correct
• Formatting is consistent

SEO/AEO eval

Score: 7/8 (baseline 1/8). All correctness gates pass; developer code blocks unchanged (8/8 byte-for-byte, 0 added).

#	Criterion	Result
1	Repo name optimized	❌ still web-uploads-sdk (not renamed to resumable-file-upload-js)
2	About keywords	✅
3	Badges (npm, downloads, bundle, license, TypeScript)	✅
4	README descriptive (landing page)	✅
5	GitHub topics (12, no brand-only)	✅
6	Interlinks (6 verified sibling upload SDKs)	✅
7	Releases + package	✅
8	FAQ	✅

Gates: correct package name, no code edited/added, no fabricated repos, accurate TypeScript claim, links resolve — all pass.

Only gap: repo still named web-uploads-sdk. Renaming to resumable-file-upload-js gets it to 8/8 (repo-settings change, not part of this PR).

---

Ready for review!