docs: [WIP] add npmx deployment instructions for self hosting

[serhalp]

WIP — opening this to track remaining blockers and start drafting docs

Blockers

• chore: use getEnv environment abstraction in lunaria module #1146
• chore: use getEnv in oauth module for platform agnosticity #1148
• can we avoid needing pnpm remove @vercel/kv && pnpm add @netlify/blobs?
  fix: migrate to upstash unstorage driver in prod #1169
• hardcoded vercel-kv (uses fallback to filesystem caching, but that doesn't work in serverless/short-lived/diskless environments)
  fix: migrate to upstash unstorage driver in prod #1169
• deal with hardcoded vercel-runtime-cache (uses fallback to filesystem caching, but that doesn't work in serverless/short-lived/diskless environments)
• what to do about modules/isr-fallback.ts?
• what to do about redirects in vercel.json
• what to do about Vercel analytics stuff?

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
npmx.dev	Ignored		Feb 7, 2026 5:22pm

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[okineadev]

This would be useful ✌️

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🚫 Review skipped — only excluded labels are configured. (1)

• release

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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 8db3737e-ca1f-498e-bfc5-88547bf56754

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/deploy

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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