🚀 Metamafia CLI

Metamafia CLI automates the addition of AI-generated metadata, manifest.json, and robots.txt to Next.js 15 apps.
Easily optimize SEO and improve performance with zero hassle.

🎯 Features

✅ Fetches metadata automatically from Metamafia API using documentId.
✅ Inserts AI-generated metadata into app/layout.js or src/app/layout.js.
✅ Generates manifest.json and robots.txt in the public/ directory.
✅ Compatible with Next.js 15 and modern web apps.

📦 Installation

You don't need to install it globally. Simply run the command using npx:

npx metamafia <documentId>

Note:

• documentId is the ID returned after generating metadata from Metamafia.
• Your Next.js project should be open in the terminal where the command is run.

📝 Usage

Basic Command:

npx metamafia <documentId>

Example:

npx metamafia 67e8f17694a073819a301914

What Happens After Running the Command:

1. 🎯 Metadata: Adds export const metadata = {...} to app/layout.js or src/app/layout.js.
2. 📄 manifest.json: Creates public/manifest.json with app name, icons, and display settings.
3. 🤖 robots.txt: Generates public/robots.txt with crawl directives and sitemap.

📚 Folder Structure After Execution

/my-nextjs-app
├── /app
│   └── /layout.js (Updated with metadata)
├── /public
│   ├── manifest.json (Created/Updated)
│   └── robots.txt (Created/Updated)
└── /src
    └── /app
        └── /layout.js (Updated with metadata if layout found here)

⚡️ How It Works

1. 🎯 Fetch Metadata
   Retrieves metadata from the Metamafia API using the documentId provided.

2. 📄 Add Metadata to Layout
   Inserts export const metadata at the top of layout.js in the app/ or src/app/ directory.

3. 🤖 Generate Manifest & Robots

   • manifest.json is created with basic PWA information.
   • robots.txt is configured with appropriate crawl settings.

📚 Advanced Options

Re-run with a New documentId

To update the metadata, manifest, and robots with a new document:

npx metamafia 67e8f17694a073819a301914

🚩 Troubleshooting

1. Error: No layout.js found

• Ensure that layout.js exists in either /app or /src/app directory.

2. Error: Failed to fetch metadata

• Check if the API URL in api.js is correct and that the API server is running.

3. Permission Denied

• Ensure you have write access to the project directory.

📜 License

MIT © 2025 Webrizen