generator-pninja

Generate a full Laravel + React + Vite application from a single JDL model. Backend + Frontend + Docker + Database — ready in seconds ⚡

License

This project is licensed under the Apache License 2.0 — see the LICENSE.txt file for details.

What is PNinja?

PNinja is a Yeoman generator that allows you to build an entire stack application:

• Backend: Laravel (API)
• Frontend: React + Vite (SPA)
• Database: SQL (SQLite/MySQL/PostgreSQL/MariaDB)
• Search engine: Database, Algolia, Elasticsearch, Meilisearch, Typesense, Solr
• Docker Compose

All based on a single JDL file describing your domain!

Installation

Install Yeoman and PNinja:

npm install -g yo generator-pninja

Usage

Create your entity definition file using JDL:

touch entities.jdl # or any other name of your choice

and edit it using this guide: https://www.jhipster.tech/jdl/intro/

Run the generator:

yo pninja

Answer a few prompts ... and you're ready ⚡

What you get

my-app/
├── client/ # React + Vite app
├── docker/ # Docker compose
├── server/ # Laravel project
├── package.json # With commands
└── README.md

Fully wired together: auth, routing, forms, CRUD, migrations.

Supported Technologies and Limitations

Server Framework (PHP)

• Laravel

Client Frameworks

• React + Vite

Databases

• SQLite, MySQL, MariaDB, PostgreSQL

Authentication

• Keycloak

Search Engines

• Algolia, Elasticsearch, Meilisearch, Typesense, Solr, Database

Roadmap

• Vue & Angular support
• SQL Server & Oracle support
• Authentication improvements (Laravel Sanctum / OAuth2)
• GitHub CI

GitHub Repository

The source code for generator-pninja is hosted on GitHub. You can access the official repository at the following link:

Generator PNinja GitHub Repository