docs: use cleaner imports in examples and add read more links to config

[RihanArfan]

🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation, readme, or JSdoc annotations)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Switches imports to import { defineConfig } from 'nitro' rather than import { defineNitroConfig } from 'nitro/config', and adds read more links in the config page to link to the dedicated docs pages.

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
nitro.build	Ready	Preview, Comment	Apr 10, 2026 4:28pm

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR updates documentation and example files across the Nitro project to reflect API naming changes. It replaces defineNitroConfig with defineConfig, defineNitroErrorHandler with defineErrorHandler, defineCachedEventHandler with defineCachedHandler, and eventHandler with defineHandler throughout code snippets and configuration examples.

Changes

Cohort / File(s)	Summary
Quick Start & Routing Docs docs/1.docs/2.quick-start.md, docs/1.docs/5.routing.md	Updated imports and config function names; also corrected caching wrapper reference from defineCachedEventHandler to defineCachedHandler.
Configuration Examples docs/1.docs/4.renderer.md, docs/1.docs/6.server-entry.md, docs/1.docs/7.cache.md, docs/1.docs/8.storage.md, docs/1.docs/50.assets.md, docs/1.docs/50.configuration.md, docs/1.docs/50.database.md, docs/1.docs/50.lifecycle.md, docs/1.docs/50.plugins.md, docs/1.docs/50.tasks.md	Consistently replaced defineNitroConfig from nitro/config with defineConfig from nitro in all configuration example snippets.
Migration & Deployment Docs docs/1.docs/99.migration.md, docs/2.deploy/0.index.md, docs/2.deploy/20.providers/aws-amplify.md, docs/2.deploy/20.providers/aws.md, docs/2.deploy/20.providers/cloudflare.md, docs/2.deploy/20.providers/iis.md, docs/2.deploy/20.providers/vercel.md, docs/2.deploy/20.providers/zephyr.md	Updated import sources and config helper function names across all deployment and migration guide examples.
API Reference & Examples docs/3.config/0.index.md	Updated configuration examples to use defineConfig and defineErrorHandler; adjusted documentation links and route rule caching description.
Example Code & Documentation docs/4.examples/plugins.md, examples/plugins/README.md, examples/plugins/server.ts	Replaced eventHandler from h3 with defineHandler from nitro in handler definitions.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• docs: prepare for v3 beta #4091: Makes identical API documentation updates across examples (defineNitroConfig → defineConfig, defineNitroErrorHandler → defineErrorHandler, and related renames)
• docs(cloudflare): remove invalid docs and add note about wrangler env #3978: Modifies Cloudflare deployment documentation and updates nitro.config.ts examples with similar import/function name changes
• feat: export http utils from nitro #4097: Updates public handler API re-exports and documentation to include defineHandler from nitro package

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title follows conventional commits format with 'docs:' prefix and clearly describes the documentation changes made.
Description check	✅ Passed	The description is directly related to the changeset, explaining the switch from 'defineNitroConfig' to 'defineConfig' imports and the addition of read-more links.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ 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/improvements

---

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.}

[pi0]

thnx!