home / skills / openclaw / skills / next-config-gen

next-config-gen skill

safe

This skill generates optimized Next.js config by analyzing your project and applying best practices, image domains, rewrites, and security headers.

npx playbooks add skill openclaw/skills --skill next-config-gen

Review the files below or copy the command above to add this skill to your agents.

Files (8)

SKILL.md

1.8 KB

---
name: next-config-gen
description: Generate Next.js config with best practices. Use when configuring Next.js.
---

# Next Config Generator

next.config.js has a million options. This tool reads your project and generates a config with sensible defaults and the features you actually need.

**One command. Zero config. Just works.**

## Quick Start

```bash
npx ai-next-config
```

## What It Does

- Analyzes your Next.js project
- Generates optimized next.config.mjs
- Includes image domains, rewrites, and headers
- Sets up best practice defaults

## Usage Examples

```bash
# Generate from current project
npx ai-next-config

# Output as CommonJS
npx ai-next-config -o next.config.js
```

## Best Practices

- **Enable strict mode** - catch issues early
- **Configure image domains** - external images need allowlisting
- **Set security headers** - HTTPS, CSP, etc.
- **Use rewrites carefully** - they can affect caching

## When to Use This

- Starting a new Next.js project
- Upgrading to latest Next.js version
- Adding features like image optimization
- Cleaning up messy config

## Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

**Find more:**
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgicstudios.com

## Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

```bash
npx ai-next-config --help
```

## How It Works

Reads your package.json and project structure to understand what features you're using. Then generates a next.config with appropriate settings for images, headers, redirects, and experimental features.

## License

MIT. Free forever. Use it however you want.

Overview

This skill generates a production-ready Next.js configuration tailored to your project. It analyzes your codebase and outputs a next.config file with sensible defaults, image domains, rewrites, and security headers. One command produces a config that follows best practices and reduces manual setup.

How this skill works

The tool scans package.json and your project structure to detect features like image usage, API routes, and frameworks. It then synthesizes an optimized next.config.mjs (or CommonJS output) with configured image domains, redirects/rewrites, security headers, and recommended flags. The generator favors safe, modern defaults and includes options for overriding or exporting different formats.

When to use it

Starting a new Next.js project and you want a solid default config.
Upgrading Next.js versions and needing an updated, compatible config.
Adding image optimization, custom headers, or rewrites and want them configured correctly.
Cleaning up a large or messy next.config and consolidating settings.
Quickly producing a config for CI, hosting, or review before deployment.

Best practices

Enable React strict mode and other safety flags to catch issues early.
Allowlist external image domains explicitly to keep image optimization secure.
Add security headers (HSTS, CSP basics, X-Frame-Options) to responses.
Use rewrites and redirects sparingly and document their cache behavior.
Prefer module (mjs) output for modern toolchains, offer CommonJS if required.

Example use cases

Run npx ai-next-config in a starter repo to generate next.config.mjs with image domains and headers.
Upgrade a legacy app: regenerate the config to apply modern Next.js recommended flags.
Switch hosting providers: export CommonJS next.config.js for a platform that requires it.
Audit and normalize multiple projects by generating consistent configs across repos.
Add image optimization to a project and automatically populate external domain allowlists.

FAQ

Do I need to install anything to run this?

No installation is required; run it with npx. Node.js 18+ is recommended and an OPENAI_API_KEY environment variable may be needed for analysis features.

Can I customize the generated config?

Yes. The tool outputs a ready-to-edit file and supports flags to choose output format. You can modify the generated settings to fit edge cases or special hosting needs.