Skip to content

Conversation

@danielroe
Copy link
Member

🔗 Linked issue

📚 Description

this simplifies the usage of nuxi/nuxt throughout the project, which should hopefully make things more straightforward for new users

@danielroe danielroe requested review from BobbieGoede and Copilot May 29, 2025 09:43
@bolt-new-by-stackblitz
Copy link

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates the documentation to consistently recommend using the nuxt command instead of nuxi throughout the project. The changes simplify usage instructions and examples for new users while ensuring consistent terminology.

Reviewed Changes

Copilot reviewed 67 out of 67 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/2.guide/3.going-further/3.modules.md Updated commands from “nuxi” to “nuxt” in module examples.
docs/2.guide/3.going-further/11.nightly-release-channel.md Replaced nightly command references from “nuxi-nightly” to “@nuxt/cli-nightly”.
docs/2.guide/3.going-further/10.runtime-config.md Changed “Nuxi CLI” to “Nuxt CLI” in runtime configuration notes.
docs/2.guide/3.going-further/1.internals.md Updated internal command references from “nuxi” to “nuxt”.
docs/2.guide/2.directory-structure/2.env.md Replaced “nuxi” with “nuxt” commands in environment file examples.
docs/2.guide/2.directory-structure/1.server.md Updated server documentation to use “nuxt” instead of “nuxi”.
docs/2.guide/2.directory-structure/1.content.md Changed command used to add content module from “nuxi” to “nuxt”.
docs/2.guide/2.directory-structure/1.composables.md Updated composables section with the proper “nuxt” commands.
docs/2.guide/1.concepts/9.code-style.md Replaced “nuxi” with “nuxt” when advising module installation for ESLint.
docs/2.guide/1.concepts/8.typescript.md Updated multiple TypeScript command examples from “nuxi” to “nuxt”.
docs/2.guide/1.concepts/5.modules.md Revised module system documentation to use “nuxt” commands consistently.
docs/2.guide/1.concepts/3.rendering.md Updated static site rendering instructions to refer to “nuxt” commands.
docs/1.getting-started/18.upgrade.md Replaced upgrade commands from “nuxi” to “nuxt” in upgrade instructions.
docs/1.getting-started/16.deployment.md Updated deployment instructions to use “nuxt” commands.
docs/1.getting-started/15.prerendering.md Revised prerendering examples to consistently reference “nuxt” commands.
docs/1.getting-started/11.state-management.md Updated installation instructions for Pinia module to use “nuxt” commands.
docs/1.getting-started/03.configuration.md Changed configuration examples from “nuxi” to “nuxt” commands.
docs/1.getting-started/01.introduction.md Modified introduction to reflect updated CLI naming conventions.
.github/workflows/semantic-pull-requests.yml Removed the “nuxi” scope in the PR workflow configuration.
.github/ISSUE_TEMPLATE/bug-report.yml Updated the bug report template to instruct using “nuxt info” instead of “nuxi info”.

@pkg-pr-new
Copy link

pkg-pr-new bot commented May 29, 2025

Open in StackBlitz

@nuxt/kit

npm i https://pkg.pr.new/@nuxt/kit@32237

nuxt

npm i https://pkg.pr.new/nuxt@32237

@nuxt/rspack-builder

npm i https://pkg.pr.new/@nuxt/rspack-builder@32237

@nuxt/schema

npm i https://pkg.pr.new/@nuxt/schema@32237

@nuxt/vite-builder

npm i https://pkg.pr.new/@nuxt/vite-builder@32237

@nuxt/webpack-builder

npm i https://pkg.pr.new/@nuxt/webpack-builder@32237

commit: 0e18cbe

Copy link
Member

@antfu antfu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this mean we are gradually deprecating the usage of nuxi (I agree it can be confusing two have two CLI)? If so should we have a section somewhere in our docs to explain the difference between nuxi and nuxt and tell users whether they should migrate/change over?

@coderabbitai
Copy link

coderabbitai bot commented May 29, 2025

Walkthrough

This update systematically replaces references to the "nuxi" CLI with "nuxt" or "@nuxt/cli" across documentation, error messages, comments, test scripts, and internal code. Documentation commands, examples, and explanations have been updated to use the "nuxt" CLI for consistency. Internal code comments and error messages now refer to "@nuxt/cli" instead of "nuxi". Test scripts and setup commands have been modified to invoke "nuxt" rather than "nuxi". Some documentation also updates package names and corrects command usage. No exported or public entity signatures have been altered.

✨ Finishing Touches
  • 📝 Generate Docstrings

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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (6)
docs/2.guide/2.directory-structure/1.composables.md (1)

53-53: Suggest improving phrasing for conciseness.
Consider replacing "in order to let Nuxt generate the types" with "to generate types" or "to let Nuxt generate types" for brevity.

🧰 Tools
🪛 LanguageTool

[style] ~53-~53: Consider a more concise word here.
Context: ...nuxt build](/docs/api/commands/build) in order to let Nuxt generate the types. ::note If...

(IN_ORDER_TO_PREMIUM)

docs/3.api/4.commands/init.md (1)

17-17: Suggest consistent command naming.
The description refers to the create-nuxt command (with a hyphen), whereas both the title and example use create nuxt (without a hyphen). For consistency, consider changing `create-nuxt` to `create nuxt`.

docs/3.api/4.commands/add.md (1)

100-100: Optional: Consider adding comma for clarity.

The static analysis tool suggests adding a comma after 'alternatively' for improved readability.

-* Modifier flags: `--method` (can accept `connect`, `delete`, `get`, `head`, `options`, `patch`, `post`, `put` or `trace`) or alternatively you can directly use `--get`, `--post`, etc.
+* Modifier flags: `--method` (can accept `connect`, `delete`, `get`, `head`, `options`, `patch`, `post`, `put` or `trace`) or alternatively, you can directly use `--get`, `--post`, etc.
🧰 Tools
🪛 LanguageTool

[typographical] ~100-~100: Consider adding a comma after ‘alternatively’ for more clarity.
Context: ..., patch, post, put or trace) or alternatively you can directly use --get, --post,...

(RB_LY_COMMA)

docs/3.api/4.commands/dev.md (1)

53-53: Nit: improve phrasing for clarity
Consider rephrasing "Additionally to the above options" to "In addition to the above options" for smoother readability.

docs/2.guide/3.going-further/3.modules.md (1)

62-62: Refine playground command phrasing
Consider replacing “used against” with “run on” for clearer phrasing:

-All other `nuxt` commands can be used against the `playground` directory...
+All other `nuxt` commands can be run on the `playground` directory...
🧰 Tools
🪛 LanguageTool

[style] ~62-~62: Consider using a less common alternative to make your writing sound more unique and professional.
Context: ...ory (e.g. nuxt <COMMAND> playground). Feel free to declare additional dev:* scripts with...

(FEEL_FREE_TO_STYLE_ME)


[uncategorized] ~62-~62: Loose punctuation mark.
Context: ...json` referencing them for convenience. :: #### How to Test The module starter ...

(UNLIKELY_OPENING_PUNCTUATION)

docs/2.guide/2.directory-structure/2.env.md (1)

60-60: Grammar refinement for production preview instruction
Consider pluralising “purpose” for smoother reading:

-For local production preview purpose, we recommend using [`nuxt preview`](...)
+For local production preview purposes, we recommend using [`nuxt preview`](...)
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 726ac60 and 0e18cbe.

⛔ Files ignored due to path filters (11)
  • package.json is excluded by !package.json, !**/package.json
  • playground/package.json is excluded by !**/package.json
  • test/fixtures/basic-types/package.json is excluded by !**/package.json
  • test/fixtures/basic/package.json is excluded by !**/package.json
  • test/fixtures/hmr/package.json is excluded by !**/package.json
  • test/fixtures/minimal-pages/package.json is excluded by !**/package.json
  • test/fixtures/minimal-types/package.json is excluded by !**/package.json
  • test/fixtures/minimal/package.json is excluded by !**/package.json
  • test/fixtures/runtime-compiler/package.json is excluded by !**/package.json
  • test/fixtures/spa-loader/package.json is excluded by !**/package.json
  • test/fixtures/suspense/package.json is excluded by !**/package.json
📒 Files selected for processing (56)
  • .github/ISSUE_TEMPLATE/bug-report.yml (1 hunks)
  • .github/workflows/semantic-pull-requests.yml (0 hunks)
  • docs/1.getting-started/01.introduction.md (1 hunks)
  • docs/1.getting-started/03.configuration.md (1 hunks)
  • docs/1.getting-started/11.state-management.md (1 hunks)
  • docs/1.getting-started/15.prerendering.md (2 hunks)
  • docs/1.getting-started/16.deployment.md (1 hunks)
  • docs/1.getting-started/18.upgrade.md (2 hunks)
  • docs/2.guide/1.concepts/3.rendering.md (1 hunks)
  • docs/2.guide/1.concepts/5.modules.md (1 hunks)
  • docs/2.guide/1.concepts/8.typescript.md (4 hunks)
  • docs/2.guide/1.concepts/9.code-style.md (1 hunks)
  • docs/2.guide/2.directory-structure/1.composables.md (1 hunks)
  • docs/2.guide/2.directory-structure/1.content.md (1 hunks)
  • docs/2.guide/2.directory-structure/1.server.md (1 hunks)
  • docs/2.guide/2.directory-structure/2.env.md (3 hunks)
  • docs/2.guide/3.going-further/1.internals.md (2 hunks)
  • docs/2.guide/3.going-further/10.runtime-config.md (1 hunks)
  • docs/2.guide/3.going-further/11.nightly-release-channel.md (1 hunks)
  • docs/2.guide/3.going-further/3.modules.md (2 hunks)
  • docs/2.guide/3.going-further/9.debugging.md (1 hunks)
  • docs/2.guide/4.recipes/4.sessions-and-authentication.md (1 hunks)
  • docs/3.api/1.components/10.nuxt-picture.md (1 hunks)
  • docs/3.api/1.components/9.nuxt-img.md (1 hunks)
  • docs/3.api/2.composables/use-preview-mode.md (2 hunks)
  • docs/3.api/4.commands/add.md (3 hunks)
  • docs/3.api/4.commands/analyze.md (2 hunks)
  • docs/3.api/4.commands/build-module.md (2 hunks)
  • docs/3.api/4.commands/build.md (2 hunks)
  • docs/3.api/4.commands/cleanup.md (2 hunks)
  • docs/3.api/4.commands/dev.md (3 hunks)
  • docs/3.api/4.commands/devtools.md (2 hunks)
  • docs/3.api/4.commands/generate.md (2 hunks)
  • docs/3.api/4.commands/info.md (2 hunks)
  • docs/3.api/4.commands/init.md (2 hunks)
  • docs/3.api/4.commands/module.md (4 hunks)
  • docs/3.api/4.commands/prepare.md (2 hunks)
  • docs/3.api/4.commands/preview.md (2 hunks)
  • docs/3.api/4.commands/typecheck.md (2 hunks)
  • docs/3.api/4.commands/upgrade.md (2 hunks)
  • docs/3.api/6.advanced/1.hooks.md (1 hunks)
  • docs/5.community/4.contribution.md (1 hunks)
  • docs/5.community/7.changelog.md (1 hunks)
  • docs/7.migration/2.configuration.md (2 hunks)
  • packages/kit/src/template.ts (1 hunks)
  • packages/nuxi/README.md (1 hunks)
  • packages/nuxt/src/app/components/nuxt-stubs.ts (1 hunks)
  • packages/nuxt/src/app/composables/script-stubs.ts (1 hunks)
  • packages/nuxt/src/components/plugins/loader.ts (1 hunks)
  • packages/nuxt/src/core/features.ts (1 hunks)
  • packages/nuxt/src/core/nuxt.ts (1 hunks)
  • packages/schema/src/types/hooks.ts (1 hunks)
  • scripts/bump-edge.ts (1 hunks)
  • test/bundle.test.ts (1 hunks)
  • test/prepare.ts (1 hunks)
  • test/typed-router.test.ts (1 hunks)
💤 Files with no reviewable changes (1)
  • .github/workflows/semantic-pull-requests.yml
🧰 Additional context used
🧠 Learnings (1)
packages/nuxt/src/components/plugins/loader.ts (1)
Learnt from: GalacticHypernova
PR: nuxt/nuxt#26468
File: packages/nuxt/src/components/plugins/loader.ts:24-24
Timestamp: 2024-11-05T15:22:54.759Z
Learning: In `packages/nuxt/src/components/plugins/loader.ts`, the references to `resolve` and `distDir` are legacy code from before Nuxt used the new unplugin VFS and will be removed.
🪛 LanguageTool
docs/1.getting-started/11.state-management.md

[uncategorized] ~87-~87: Loose punctuation mark.
Context: ....vuejs.org/ssr/nuxt.html#Installation). :: ::code-group ```ts [stores/website.ts...

(UNLIKELY_OPENING_PUNCTUATION)

docs/2.guide/3.going-further/10.runtime-config.md

[uncategorized] ~47-~47: Loose punctuation mark.
Context: ... your .env file will not be read. :read-more{to="/docs/guide/directory-stru...

(UNLIKELY_OPENING_PUNCTUATION)

docs/1.getting-started/15.prerendering.md

[uncategorized] ~16-~16: Loose punctuation mark.
Context: ... site's pages they link to, and so on. ::code-group{sync="pm"} ```bash [npm] np...

(UNLIKELY_OPENING_PUNCTUATION)


[uncategorized] ~49-~49: Loose punctuation mark.
Context: ...more about the nuxt generate command. :: ### Selective Pre-rendering You can ...

(UNLIKELY_OPENING_PUNCTUATION)

docs/1.getting-started/16.deployment.md

[uncategorized] ~75-~75: Loose punctuation mark.
Context: ...at cannot be server rendered (if any). :read-more{title="Nuxt prerendering" to="...

(UNLIKELY_OPENING_PUNCTUATION)

docs/2.guide/2.directory-structure/1.composables.md

[style] ~53-~53: Consider a more concise word here.
Context: ...nuxt build](/docs/api/commands/build) in order to let Nuxt generate the types. ::note If...

(IN_ORDER_TO_PREMIUM)

docs/3.api/2.composables/use-preview-mode.md

[uncategorized] ~117-~117: Loose punctuation mark.
Context: ...eview) is not related to preview mode.) ::

(UNLIKELY_OPENING_PUNCTUATION)

docs/2.guide/1.concepts/3.rendering.md

[uncategorized] ~100-~100: Loose punctuation mark.
Context: ...y page as a separate static HTML file. ::warning If you prerender your app with ...

(UNLIKELY_OPENING_PUNCTUATION)


[uncategorized] ~102-~102: Loose punctuation mark.
Context: ...unctionality, use nuxt build instead. :: If you are using purely client-side r...

(UNLIKELY_OPENING_PUNCTUATION)

docs/2.guide/1.concepts/8.typescript.md

[uncategorized] ~56-~56: A comma might be missing here.
Context: ...ed within your buildDir (.nuxt) and therefore for full typings, you will need to run ...

(AI_EN_LECTOR_MISSING_PUNCTUATION_COMMA)


[uncategorized] ~80-~80: You might be missing the article “the” here.
Context: ...zed. :br :br In case you need to extend options provided by ./.nuxt/tsconfig.json fur...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)


[uncategorized] ~80-~80: Loose punctuation mark.
Context: ...nd ./.nuxt/tsconfig.json accordingly. :: ## Strict Checks TypeScript comes wi...

(UNLIKELY_OPENING_PUNCTUATION)

docs/3.api/4.commands/add.md

[typographical] ~100-~100: Consider adding a comma after ‘alternatively’ for more clarity.
Context: ..., patch, post, put or trace) or alternatively you can directly use --get, --post,...

(RB_LY_COMMA)

docs/7.migration/2.configuration.md

[uncategorized] ~150-~150: Loose punctuation mark.
Context: ...ges/tsc) with nuxt typecheck command. :: ### Migration 1. Create a `tsconfig....

(UNLIKELY_OPENING_PUNCTUATION)

docs/1.getting-started/18.upgrade.md

[uncategorized] ~12-~12: Loose punctuation mark.
Context: ...ases), use the nuxt upgrade command. ::code-group{sync="pm"} ```bash [npm] np...

(UNLIKELY_OPENING_PUNCTUATION)

docs/2.guide/3.going-further/3.modules.md

[style] ~62-~62: Consider using a less common alternative to make your writing sound more unique and professional.
Context: ...ory (e.g. nuxt <COMMAND> playground). Feel free to declare additional dev:* scripts with...

(FEEL_FREE_TO_STYLE_ME)


[uncategorized] ~62-~62: Loose punctuation mark.
Context: ...json` referencing them for convenience. :: #### How to Test The module starter ...

(UNLIKELY_OPENING_PUNCTUATION)

🪛 GitHub Actions: docs
docs/1.getting-started/11.state-management.md

[error] 1-1: Network error: error sending request for url (https://vuejs.org/api/reactivity-core.html#ref) Maybe a certificate error.

⏰ Context from checks skipped due to timeout of 90000ms (20)
  • GitHub Check: test-fixtures (windows-latest, built, vite, default, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, webpack, default, manifest-on, json, 20)
  • GitHub Check: test-fixtures (windows-latest, built, rspack, async, manifest-on, json, 20)
  • GitHub Check: test-fixtures (windows-latest, built, vite, async, manifest-on, json, 20)
  • GitHub Check: test-fixtures (windows-latest, dev, vite, async, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, vite, async, manifest-on, js, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, rspack, default, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, rspack, async, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, vite, async, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, dev, vite, default, manifest-off, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, dev, vite, async, manifest-off, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, vite, default, manifest-off, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, vite, default, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, dev, vite, default, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, webpack, async, manifest-on, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, built, vite, async, manifest-off, json, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, dev, vite, async, manifest-on, js, 20)
  • GitHub Check: test-fixtures (ubuntu-latest, dev, vite, async, manifest-on, json, 20)
  • GitHub Check: test-benchmark
  • GitHub Check: typecheck (windows-latest, bundler)
🔇 Additional comments (83)
.github/ISSUE_TEMPLATE/bug-report.yml (1)

18-18: LGTM! Command update improves consistency.

The change from npx nuxi info to npx nuxt info aligns perfectly with the PR objective of consistently recommending the nuxt command. This ensures users see consistent command syntax when reporting bugs.

packages/nuxt/src/core/features.ts (1)

51-51: LGTM! Internal comment update maintains consistency.

The TODO comment update from "Nuxi" to "@nuxt/cli" aligns with the project's naming convention changes and maintains consistency in internal documentation.

packages/nuxi/README.md (1)

1-1: LGTM! Title simplification improves clarity.

Removing "(nuxi)" from the README title makes it cleaner and aligns with the consistent use of "nuxt" command throughout the project. The simplified "Nuxt CLI" title is more straightforward for users.

test/typed-router.test.ts (1)

11-11:

Details

❓ Verification inconclusive

LGTM! Test command update maintains consistency.

The change from nuxi prepare to nuxt prepare aligns with the PR objective of consistently using the nuxt command. This ensures tests demonstrate the recommended command usage.

Please verify that the nuxt prepare command works correctly in the test environment:


🏁 Script executed:

#!/bin/bash
# Description: Verify that the nuxt command is available and functional in the test environment
# Expected: The nuxt command should be available and provide the same functionality as nuxi

# Test: Check if nuxt command is available
which nuxt

# Test: Check nuxt command help to verify prepare subcommand exists  
nuxt --help | grep -A 5 -B 5 "prepare"

Length of output: 242


Please verify that the nuxt CLI is available where tests run

Before merging, ensure that switching from nuxi prepare to nuxt prepare won’t break test executions:

• Confirm nuxt is installed (or aliased) in your devDependencies and linked into node_modules/.bin.
• Update CI-and-local setup to install the nuxt package so the binary is present.
• Run the full test suite locally and in CI to validate nuxt prepare executes as expected.

docs/2.guide/2.directory-structure/1.server.md (1)

147-147: Consistent CLI command reference
The updated reference to nuxt typecheck aligns with the project-wide shift from nuxi to nuxt. This ensures users see the correct command for type checking.

docs/3.api/1.components/10.nuxt-picture.md (1)

22-22: Corrected module installation command
Changing the CLI invocation to npx nuxt module add image keeps it consistent with the new nuxt-first approach and matches other module installation instructions.

docs/1.getting-started/11.state-management.md (1)

87-87: Unified CLI command usage
The installation snippet now uses npx nuxt module add pinia, in line with the renaming of all nuxi references to nuxt.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~87-~87: Loose punctuation mark.
Context: ....vuejs.org/ssr/nuxt.html#Installation). :: ::code-group ```ts [stores/website.ts...

(UNLIKELY_OPENING_PUNCTUATION)

packages/nuxt/src/components/plugins/loader.ts (1)

57-57: Non-functional comment update
This change only revises an internal TODO comment to reference @nuxt/cli and has no impact on the plugin’s logic.

docs/2.guide/3.going-further/9.debugging.md (1)

25-25: Updated debug command
Switching to nuxt dev --inspect ensures the correct CLI is invoked for debugging, matching the broader documentation changes.

docs/2.guide/2.directory-structure/1.content.md (1)

24-24: CLI command consistency
The installation command has been correctly updated from npx nuxi module add content to npx nuxt module add content, aligning with the standardised Nuxt CLI naming.

docs/1.getting-started/03.configuration.md (1)

53-53: Use the Nuxt CLI for environment overrides
The example has been correctly updated to use nuxt build --envName staging instead of the old nuxi command, ensuring consistency with the current CLI.

docs/3.api/4.commands/build.md (2)

2-2: Update documentation title to Nuxt
The title field has been updated to nuxt build, reflecting the renamed CLI entry.


13-13: Revise build command invocation
The build command example now correctly uses npx nuxt build in place of npx nuxi build.

docs/3.api/4.commands/prepare.md (2)

2-2: Align title with Nuxt CLI
The title has been updated to nuxt prepare, matching the renamed CLI tool.


13-13: Correct prepare command example
The command invocation has been updated to npx nuxt prepare, ensuring consistency across the CLI docs.

docs/5.community/4.contribution.md (1)

55-55: Adjust commit scope example for monorepo
The example commit scope has been updated to feat(kit): add 'addMagicStuff' utility, removing the outdated nuxi reference and reflecting current project structure.

docs/2.guide/1.concepts/9.code-style.md (1)

17-17: LGTM! Consistent command naming update.

The change from nuxi to nuxt for the module installation command aligns perfectly with the PR objective to recommend the nuxt command consistently throughout the documentation.

docs/3.api/4.commands/build-module.md (2)

2-2: LGTM! Title updated for consistency.

The title change from nuxi build-module to nuxt build-module ensures the documentation header aligns with the standardised command naming.


13-13: LGTM! Command example updated correctly.

The command example has been properly updated from npx nuxi build-module to npx nuxt build-module, maintaining the same functionality whilst using the recommended command name.

docs/3.api/1.components/9.nuxt-img.md (1)

24-24: LGTM! Module installation command updated consistently.

The change from npx nuxi module add image to npx nuxt module add image maintains functionality whilst using the recommended command syntax, improving consistency for users installing the Nuxt Image module.

test/prepare.ts (1)

22-22: LGTM! Test script updated to match documented commands.

The change from 'nuxi', 'prepare' to 'nuxt', 'prepare' ensures the test preparation script uses the same command syntax that's now recommended in the documentation, maintaining consistency between tooling and documentation.

docs/3.api/4.commands/upgrade.md (2)

2-2: Standardised CLI command name in title
The title has been updated from "nuxi upgrade" to "nuxt upgrade", aligning with the project-wide CLI naming convention.


13-13: Updated CLI usage example
The command example now correctly uses npx nuxt upgrade instead of npx nuxi upgrade.

scripts/bump-edge.ts (1)

9-10: Include @nuxt/cli in nightly packages mapping
The nightlyPackages object now consistently quotes keys and adds the @nuxt/cli entry, ensuring the new CLI package is handled in nightly bumps.

docs/5.community/7.changelog.md (1)

26-26: Updated CLI release card reference
Changed the release card description to "Nuxt CLI (@nuxt/cli)" to reflect the new package naming.

docs/3.api/4.commands/typecheck.md (2)

2-2: Standardised CLI command name in title
The documentation title now reads "nuxt typecheck" instead of "nuxi typecheck".


13-13: Updated CLI usage example
The example has been updated to npx nuxt typecheck, aligning with the unified CLI naming.

docs/2.guide/3.going-further/10.runtime-config.md (1)

47-47: Standardised term to Nuxt CLI in note
The note now refers to "Nuxt CLI" instead of "Nuxi CLI", consistent with project-wide documentation updates.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~47-~47: Loose punctuation mark.
Context: ... your .env file will not be read. :read-more{to="/docs/guide/directory-stru...

(UNLIKELY_OPENING_PUNCTUATION)

docs/3.api/4.commands/analyze.md (2)

2-2: Consistent CLI command naming in title. Title updated to use nuxt analyze instead of nuxi analyze, ensuring consistency across documentation.


13-14: Update example usage to use nuxt CLI. The command example now correctly uses npx nuxt analyze, replacing nuxi.

docs/2.guide/1.concepts/5.modules.md (1)

10-10: Standardise CLI command references. Replaced references to nuxi dev and nuxi build with nuxt dev and nuxt build, aligning with the updated CLI naming convention.

docs/3.api/4.commands/devtools.md (3)

2-2: Update title to use nuxt CLI. Title now reads "nuxt devtools", matching the new command naming scheme.


13-13: Align devtools example with new CLI name. Example command updated to npx nuxt devtools <COMMAND>, replacing nuxi devtools.


17-17: Reflect CLI rename in descriptive text. Updated guidance to refer to nuxt devtools commands, ensuring consistency.

docs/3.api/4.commands/preview.md (2)

2-2: Update preview command title. Changed title from "nuxi preview" to "nuxt preview".


13-13: Use nuxt CLI in example. Example command updated to npx nuxt preview, replacing nuxi.

packages/nuxt/src/core/nuxt.ts (1)

529-529: Align internal refactor comment with CLI rename. The TODO now correctly references @nuxt/cli instead of nuxi, matching project-wide CLI naming.

docs/3.api/4.commands/info.md (2)

2-2: Consistent CLI naming in title
The frontmatter title has been correctly updated from “nuxi info” to “nuxt info”, aligning with the rest of the documentation.


13-13: Updated CLI invocation
The example usage now correctly shows npx nuxt info, replacing the former npx nuxi info. This aligns with the PR objective to standardise on nuxt.

docs/3.api/4.commands/cleanup.md (2)

2-2: Consistent CLI naming in title
The title has been updated from “nuxi cleanup” to “nuxt cleanup”, matching the new CLI naming convention.


13-13: Updated CLI invocation
The usage example now reads npx nuxt cleanup, correctly replacing npx nuxi cleanup as intended.

docs/1.getting-started/16.deployment.md (2)

73-73: Updated CLI command in SSG description
The static site generation section now references nuxt generate instead of nuxi generate, ensuring the documentation is consistent with the current CLI.


80-80: Updated CLI command in client-side rendering description
The client-side only rendering note now correctly points to nuxt generate, replacing the old nuxi generate.

docs/2.guide/4.recipes/4.sessions-and-authentication.md (2)

14-14: Updated module installation instruction
The prose has been updated to instruct users to use the nuxt CLI for adding the nuxt-auth-utils module, replacing references to nuxi.


17-17: Updated CLI invocation for module add
The command example now correctly shows npx nuxt module add auth-utils instead of the previous npx nuxi@latest module add auth-utils.

docs/3.api/2.composables/use-preview-mode.md (2)

106-107: Updated upstream CLI commands
Both lines in the example now invoke npx nuxt generate and npx nuxt preview, replacing the prior npx nuxi commands. This aligns with the unified CLI branding.


117-117: Ensured correct CLI commands in note
The follow-up note has been updated to reference nuxt generate and nuxt preview instead of nuxt dev where appropriate.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~117-~117: Loose punctuation mark.
Context: ...eview) is not related to preview mode.) ::

(UNLIKELY_OPENING_PUNCTUATION)

docs/3.api/6.advanced/1.hooks.md (1)

71-71: Verified renaming consistency.
The hook description correctly replaces "Nuxi" with "@nuxt/cli", matching the updated CLI naming convention. No further changes needed.

docs/3.api/4.commands/init.md (2)

2-2: Approve updated title.
The document title has been correctly updated from "nuxi init" to "create nuxt", aligning with the new command usage.


13-13: Approve command example update.
The code snippet now correctly uses npm create nuxt@latest, replacing the old npx nuxi init. This aligns with the updated project scaffolding convention.

test/bundle.test.ts (1)

14-16: Approve CLI command replacement in tests.
The build commands in beforeAll have been correctly updated from pnpm nuxi build to pnpm nuxt build, matching the new CLI usage. All test logic remains unaffected.

packages/nuxt/src/app/components/nuxt-stubs.ts (1)

7-7: Verified stub message update.
The error message now suggests npx nuxt module add @nuxt/image instead of using npx nuxi, aligning with the standardized CLI naming. Looks good.

docs/1.getting-started/15.prerendering.md (1)

13-13: LGTM: Consistent CLI command updates

The documentation has been systematically updated to use nuxt generate instead of nuxi generate across all package managers and references. The changes maintain functionality while aligning with the PR objective to recommend the nuxt command consistently.

Also applies to: 20-20, 24-24, 28-28, 32-32, 48-50

docs/7.migration/2.configuration.md (1)

150-150: LGTM: Migration documentation updated correctly

The TypeScript-related commands have been properly updated from nuxi to nuxt, maintaining the same functionality while following the consistent CLI naming convention.

Also applies to: 163-163

🧰 Tools
🪛 LanguageTool

[uncategorized] ~150-~150: Loose punctuation mark.
Context: ...ges/tsc) with nuxt typecheck command. :: ### Migration 1. Create a `tsconfig....

(UNLIKELY_OPENING_PUNCTUATION)

docs/3.api/4.commands/generate.md (1)

2-2: LGTM: API documentation updated consistently

The generate command documentation has been properly updated to use nuxt instead of nuxi in the title, usage example, and description text. All changes maintain accuracy while following the consistent CLI naming convention.

Also applies to: 13-13, 17-17

packages/nuxt/src/app/composables/script-stubs.ts (1)

5-5: LGTM: Error message updated with correct CLI command

The installation command suggestion in the error message has been properly updated from npx nuxi@latest module add @nuxt/scripts to npx nuxt module add @nuxt/scripts, maintaining helpful user guidance while following the consistent CLI naming convention.

packages/kit/src/template.ts (1)

387-387: LGTM: Removed outdated CLI branding from generated files

The removal of the "Generated by nuxi" comment from the generated tsconfig.json and nuxt.d.ts files is appropriate and aligns with the PR objective to standardise CLI references. The files are now generated cleanly without the outdated branding comment whilst maintaining the same functionality.

Also applies to: 390-390

docs/3.api/4.commands/add.md (1)

2-2: LGTM! Consistent command naming throughout documentation.

All instances of nuxi add have been correctly updated to nuxt add throughout the documentation, maintaining consistency with the PR objective.

Also applies to: 13-13, 42-42, 45-45, 51-51, 54-54, 58-58, 61-61, 65-65, 68-68, 74-74, 77-77, 81-81, 86-86, 89-89, 95-95, 98-98, 104-104, 107-107, 111-111

packages/schema/src/types/hooks.ts (1)

298-298: LGTM! Appropriate internal reference updates.

The comments have been correctly updated from "Nuxi" to "@nuxt/cli", which is appropriate for internal code documentation. This maintains consistency with the package naming while distinguishing from user-facing command references.

Also applies to: 306-306

docs/2.guide/1.concepts/3.rendering.md (1)

99-99: LGTM! Command references updated consistently.

The commands nuxi generate and nuxi build --prerender have been correctly updated to nuxt generate and nuxt build --prerender, maintaining consistency with the PR objective.

Also applies to: 102-102

docs/2.guide/3.going-further/1.internals.md (1)

10-10: LGTM! Development and build command references updated correctly.

The commands nuxi dev and nuxi build have been properly updated to nuxt dev and nuxt build respectively, aligning with the consistent CLI naming objective.

Also applies to: 81-81

docs/3.api/4.commands/dev.md (2)

2-2: Consistent command title update
The title has been correctly updated to nuxt dev, aligning with the unified CLI naming convention throughout the documentation.


13-13: CLI invocation updated
The example now correctly uses npx nuxt dev with both short (-p, -h) and long option flags included for clarity.

docs/3.api/4.commands/module.md (5)

2-2: Command title updated
The title has been updated to nuxt module, reflecting the new CLI command name.


11-11: Introduction paragraph aligned
The opening line now consistently refers to Nuxt modules, removing any legacy nuxi mentions.


17-17: Module add invocation updated
Example command correctly uses npx nuxt module add instead of the old nuxi prefix.


53-53: Module search header updated
The section header now reads nuxt module search, matching the updated command.


57-57: Module search invocation updated
The search example now correctly uses npx nuxt module search.

docs/1.getting-started/01.introduction.md (1)

75-77: Updated core package list
The core packages section now lowercases "core engine", adds @nuxt/rspack-builder to the bundlers list, and updates the CLI package to @nuxt/cli.

docs/2.guide/1.concepts/8.typescript.md (4)

8-8: Updated CLI reference in type-checking instructions
The example now correctly uses nuxt dev instead of nuxi dev, aligning with the standardised CLI naming.


32-32: Type-check command updated
The command example has been updated to npx nuxt typecheck, reflecting the CLI rename.


50-50: Generation instructions aligned
The description now correctly mentions running nuxt dev or nuxt build for IDE type support generation.


80-80: Alias extension note updated
The guidance for extending options via the alias property in nuxt.config has been updated to reference the new CLI context.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~80-~80: You might be missing the article “the” here.
Context: ...zed. :br :br In case you need to extend options provided by ./.nuxt/tsconfig.json fur...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)


[uncategorized] ~80-~80: Loose punctuation mark.
Context: ...nd ./.nuxt/tsconfig.json accordingly. :: ## Strict Checks TypeScript comes wi...

(UNLIKELY_OPENING_PUNCTUATION)

docs/1.getting-started/18.upgrade.md (2)

11-11: CLI command updated for upgrade
The upgrade guide now instructs users to run nuxt upgrade instead of nuxi upgrade.


16-16: Upgrade command example updated
The code example uses npx nuxt upgrade, ensuring consistency across package managers.

docs/2.guide/3.going-further/11.nightly-release-channel.md (4)

26-33: Ensure nightly opt-in instructions reflect correct package syntax
The diff correctly shows replacing the stable Nuxt package with the nightly tag in package.json. This aligns with the goal to opt in to nightly releases.


41-48: Ensure nightly opt-out instructions revert to the stable package
The reverse diff for opting out correctly restores the stable nuxt version. This matches the documented workflow.


52-52: Add “Using Nightly @nuxt/cli” section header
The new heading clearly introduces how to use the nightly CLI package. Naming is consistent with the updated branding.


57-57: Update example command to @nuxt/cli-nightly
The example now invokes the correct scoped package (@nuxt/cli-nightly). Confirm that this package name is published and boxed into CI tests.

docs/2.guide/3.going-further/3.modules.md (1)

9-9: Switch CLI command references from nuxi to nuxt
The description now correctly uses nuxt dev and nuxt build, aligning with the renamed CLI.

docs/2.guide/2.directory-structure/2.env.md (3)

14-14: Update dotenv support commands to use nuxt
The description now correctly refers to nuxt build and nuxt generate, matching the rebranded CLI.


28-28: Clarify custom dotenv file invocation via Nuxt CLI
The note now generically references “the Nuxt CLI”, which covers both npx nuxt and global installs.


31-31: Correct example for custom dotenv flag usage
The npx nuxt dev --dotenv .env.local command is correctly updated.

@danielroe
Copy link
Member Author

danielroe commented May 29, 2025

Exactly.

So users will use pnpm create nuxt@latest for new projects and nuxt within a nuxt project, which I think keeps things simple. Under the hood that uses create-nuxt and @nuxt/cli.

We can start avoiding 'nuxi' which might be confusing, and instead talk about 'the Nuxt CLI' or even just 'nuxt'.

(and yes, we should certainly have an explainer - what is nuxi, @nuxt/cli, and create-nuxt - and how does the Nuxt CLI work under the hood)

@codspeed-hq
Copy link

codspeed-hq bot commented May 29, 2025

CodSpeed Performance Report

Merging #32237 will not alter performance

Comparing docs/nuxi (0e18cbe) with main (726ac60)

Summary

✅ 10 untouched benchmarks

@blouflashdb
Copy link

Will there be a migration script?

@OrbisK
Copy link
Member

OrbisK commented Jun 2, 2025

Will there be a migration script?

nuxi will still work. It's just to avoid confusing new users.

@cjpearson
Copy link
Contributor

@danielroe Is there any chance we can get a "nuxi vs nuxt" sequel? 😀 https://www.youtube.com/watch?v=R1YLXgCVSec

I was searching for a quick explainer, but I think this recommendation is now out of date?

@cjpearson
Copy link
Contributor

One more follow-up question: For programmatic usage, is it preferable to import runCommand from @nuxt/cli (example) or nuxi (example)?

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants