🚀 Supercharge your web development workflow with pzr - the CLI based templates generator tool for Next.js, Express.js, and Vite React projects!

pzr simplifies the process of creating new pages, routes, and components, allowing developers to focus on writing business logic rather than boilerplate code.

• 🔮 Smart Project Config Detection: Automatically identifies your project type and configuration
• ⚡ Lightning-Fast Setup: Initialize new projects or add pzr to existing ones with a single command
• 🏗️ Effortless Scaffolding: Generate pages, routes, and components tailored to your project structure
• 🔧 Flexible and Customizable: Easily adjust detected settings to match your specific needs
• 🌟 Framework Agnostic: Supports Next.js, Express.js, and Vite React out of the box

Whether you're a seasoned developer or just starting out, pzr helps you focus on what matters most - writing great code and building amazing applications!

• Installation
• Usage
  • Initializing a Project
  • Generating Files
• Project-Specific Usage
• Features
• Configuration
• Support
• License

Install pzr globally using npm or yarn:

npm install -g pzr
# or
yarn global add pzr

💡 Tip: Global installation allows you to use pzr from any directory on your system.

To initialize a new project or configure pzr for an existing project:

pzr init

This command will:

1. 🔍 Automatically detect your project type and configuration
2. 🖥️ Display the detected settings
3. ✅ Prompt you to confirm or modify these settings

Create new pages, routes, or components using the create command or its shorthand -c:

pzr create [pages...]
# or
pzr -c [pages...]

Create multiple pages:

pzr create home about contact
# or
pzr -c home about contact

Generate files in a specific directory:

pzr create -d dashboard/settings profile
# or
pzr -c -d dashboard/settings profile

💡Tip: You can create multiple pages/routes at once by listing them after the create command or -c flag.

If you prefer not to install pzr globally, use it on a per-project basis:

1. Install as a dev dependency:

   npm install --save-dev pzr
   # or
   yarn add --dev pzr

2. Run pzr commands using npx:

   npx pzr init
   npx pzr -c home about

3. Alternatively, add scripts to your package.json:

   {
     "scripts": {
       "pzr:init": "pzr init",
       "pzr:create": "pzr -c"
     }
   }

   Then use npm or yarn to run the commands:

   npm run pzr:init
   npm run pzr:create home about
   # or with yarn
   yarn pzr:init
   yarn pzr:create home about

Use pzr without installation via npx:

npx pzr init
npx pzr -c home about
npx pzr -c -d dashboard/settings profile

⚠️ Note: Using npx without installation may result in slower execution times as it downloads the package each time.

pzr intelligently detects:

• Project Type: Next.js, Express.js, or Vite React
• Language: TypeScript or JavaScript
• Source Directory: Whether you're using a src directory
• Next.js Routing: Page Router or App Router (for Next.js projects)

After detection, pzr will display the detected settings and prompt you to confirm or customize them, ensuring accuracy and flexibility.

pzr file generation based on the project type:

• Next.js:

  • Generates layout.tsx, page.tsx, and loader.tsx in created routes in /app or /src/app dir.
  • Supports both Page Router and App Router structures and both tsx and jsx components.

• Express.js:

  • Creates models, controllers, and routes for js or ts apps.
  • Automatically adds app.use(routeMiddleware) in app.ts

• Vite React:

  • Generates .jsx or .tsx components in the /components directory

🚀 Coming Soon: We're actively working on adding support for more project types!

pzr stores its configuration in a .pzr-config.json file in your project root. This file is created when you run pzr init and contains information about your project type, language preference, and other settings.

⚠️ Warning: It's recommended to use the pzr init command to modify your configuration. Manual edits to .pzr-config.json may lead to unexpected behavior.

For bug reports and feature requests, please open an issue on our GitHub repository.

🤝 Contribute: We welcome contributions! Feel free to submit pull requests to help improve pzr.

pzr is released under the MIT License. See the LICENSE file for more details.