next-utils-cli

Next Utils CLI

Next Utils CLI is a command-line tool exclusively designed for the new Next.js App router, streamlining the creation of routes, pages, components, and server actions in your Next.js application. It now detects your Next.js version at runtime, unlocking App Router niceties introduced in v15 and v16 such as cache-aware templates and Partial Prerendering helpers.

Features

• Quickly generate Next.js routes, pages, components, and server actions.
• Create routes with various HTTP methods (GET, POST, PUT, PATCH, DELETE, OPTIONS).
• Choose between different function types for components.
• Opt in to client rendering for components and pages or enable caching for server-only output.
• Automatically surface 'use cache' directives and cacheLife presets when the project is running Next.js 16 with Cache Components enabled.
• Generate route and page templates that align with the latest Next.js 15+ App Router expectations (promise-based params, typed bodies, and Partial Prerendering patterns).
• Easily customize the path and name for your files and rely on recursive directory creation for an organized codebase.
• Initialize a project-specific configuration file with the init command and optionally toggle cacheComponents / the React Compiler.
• Clean up the boilerplate code from the home page with the clean-home-page command.
• Server action generation for enhanced server-side capabilities.

Installation

You can install Next Utils CLI globally using npm:

npm install -g next-utils-cli

Usage

To use Next Utils CLI, simply run the desired command:

next-utils page

next-utils route

next-utils component

next-utils clean-home-page

next-utils init

next-utils action

On Next.js 16 projects, prompts will offer optional cache directives ('use cache') and cacheLife presets once cacheComponents is enabled. Layouts remain cache-free by default so you can opt in manually when appropriate.

Available Commands

page

Generate a new page in the App router.

route

Generate a new route in the App router. Allows selecting multiple HTTP methods.

component

Generate a new component with options to customize the type and rendering mode.

clean-home-page

Removes boilerplate code from the default Next.js home page.

init

Creates a next-utils-cli.json configuration file in the root of your project. This file will store your project-specific preferences for page, route, and component commands. When the detected Next.js version is 16 or later, the command can also enable cacheComponents and the React Compiler by patching your next.config.* file.

action

Generate a new server action file to handle server-side logic seamlessly.

Additional Information

• Configuration: Run the init command to generate a next-utils-cli.json file, which stores your project preferences, making subsequent commands faster and more consistent.
• Cache Components: During init, opt into Cache Components and the React Compiler so page/component prompts expose cache directives.
• Component & Page Options: Choose between arrow function and function declaration styles.
• Route Flexibility: Specify HTTP methods when creating a route.
• Conflict Handling: Prompts you before overwriting existing directories or files.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributions

Contributions are welcome! If you have ideas for improvements or encounter issues, please open an issue or submit a pull request.

How to Contribute

• Fork the Repository: Click the "Fork" button on the GitHub page to create your copy of the project.

• Clone Your Fork: In your terminal, run the following command, replacing [your-username] with your GitHub username:

  git clone https://github.com/[your-username]/next-utils-cli.git
  

• Install Dependencies:

  npm install
  

• Make Changes: Create a new branch for your changes, make improvements or fixes, and commit your work:

  git checkout -b my-fix
  # or
  git switch -c my-fix
  

• Run the Project:

Run the following command to make sure project is running properly:

npm run next-utils -- -h

If you want to test in another directory:

npm run build -- test

npm link

# In your test directory
npm link next-utils-cli

# Then run the command
next-utils [command]

Need a sandbox app? The repository ignores /tester, so you can scaffold a Next.js project locally for experiments:

mkdir tester
cd tester
npx create-next-app@latest test --ts --app --src-dir --use-npm --no-git
cd test
npm link next-utils-cli

• Add Tests (if necessary) and Run Them:

  npm run test
  

• Push Your Changes to GitHub: Commit your changes and push them to GitHub. Then, open a pull request against the main branch.

  git add .
  git commit -m "Fix: Describe your fix or feature"
  

Links

• Report Issues
• npm Package

TODO

• Add examples to README.md