Instant full-stack boilerplate for the Zenuxs ecosystem

Scaffold modern apps in seconds.

create-zenuxs-app is a CLI to generate production-ready projects using the Zenuxs ecosystem — React, Next.js, Express, Fastify, TypeScript, Tailwind, MongoDB, MySQL, PostgreSQL & opinionated auth presets.

Get Started
Single CLI · Multiple stacks TypeScript & Tailwind optional Zenuxs ecosystem native

What is create-zenuxs-app?

Zero-config · Opinionated · Extensible

create-zenuxs-app is a command-line generator that bootstraps modern web applications with best-practice folder structure, sensible defaults, and tight integration with the Zenuxs ecosystem.

Use it to quickly create:

  • Pure frontend apps with React + Vite or Next.js
  • Backend APIs using Express or Fastify
  • Full-stack projects with separate frontend/ and backend/ workspaces

Frontend ready

Ships with routing-friendly structure for React and Next.js, plus optional TailwindCSS.

React + Vite Next.js Tailwind optional

API first backend

Express or Fastify with clean separation of routes, controllers and middlewares.

Express Fastify REST APIs

Database flexibility

Choose MongoDB, MySQL or PostgreSQL. Optional Easy-Mongoo integration for rapid MongoDB schemas.

MongoDB MySQL PostgreSQL

Auth & DX

JWT-based authentication templates with optional TypeScript for safer, stricter code.

JWT Auth TypeScript optional Developer focus

Installation

Node.js & npm required

You can run create-zenuxs-app via npx (recommended) or install it globally during development of the CLI itself.

Using npx (recommended)

Global-free · latest version
# Create a new project in ./my-project
npx create-zenuxs-app my-project

Local dev (for contributing)

Clone + link bash
git clone https://github.com/developer-rs5/zenuxs-cli
cd zenuxs-cli
npm install
npm link   # exposes `create-zenuxs-app` globally

Requirements

  • Node.js 18 or newer
  • npm or compatible package manager
  • Internet connection (for dependency installation)

Test the CLI

Verify everything works bash
# Once linked or via npx
create-zenuxs-app test-project

CLI usage & flow

Interactive prompts

After running the command, the CLI asks a series of questions to build the correct starter template.

Basic command

CLI entrypoint bash
create-zenuxs-app <project-name>

Interactive options

  • Project type: Frontend / Backend / Full-Stack
  • Frontend: React + Vite, Next.js
  • Backend: Express, Fastify
  • Database: MongoDB, MySQL, PostgreSQL
  • Features: TypeScript, TailwindCSS, JWT Auth

Example session

Full-stack example bash
npx create-zenuxs-app my-stack

? Project type     Full-Stack
? Frontend stack   Next.js
? Backend stack    Fastify
? Database         MongoDB (with Easy-Mongoo)
? Extras           TypeScript · TailwindCSS · JWT auth

✔ Scaffolding frontend...
✔ Scaffolding backend...
✔ Installing dependencies...

Next steps:
cd my-stack
cd frontend # start your UI
cd backend  # run your API

Project structure

Frontend · Backend · Full-stack

Depending on your choices, create-zenuxs-app generates a different folder layout. Below are the typical structures.

Frontend (React + Vite)

my-project/
├── src/
│   ├── components/
│   ├── pages/
│   │   ├── Home.jsx
│   │   └── ZenuxsPage.jsx
│   └── styles/
├── public/
├── package.json
└── vite.config.js

Backend (Express)

my-project/
├── src/
│   ├── routes/
│   ├── controllers/
│   ├── middlewares/
│   └── config/
├── server.js
├── package.json
└── .env

Full-stack layout

my-project/
├── frontend/   # React or Next.js
├── backend/    # Express or Fastify
└── README.md

Integrations & related tools

Official Zenuxs stack

create-zenuxs-app is designed to play nicely with other Zenuxs projects and tooling.

You can wire these packages into the generated backend easily for authentication, database management, and security flows.

FAQ & troubleshooting

Common questions
Do I have to use every feature?
No. TypeScript, TailwindCSS, authentication, and database integrations are all optional. You can keep the setup minimal and add features later.
Which Node.js version is supported?
The CLI targets Node.js 18+. Older versions might work but are not officially supported.
Can I customize the generated structure?
Absolutely. Generated projects are plain React/Next/Express/Fastify apps. You can move files, rename folders, add packages, or integrate your own tooling without restrictions.
Is this tied to Zenuxs auth only?
No. The scaffold ships with generic JWT-based authentication templates. You can integrate Zenuxs Accounts or any other auth provider on top.
Where can I report issues or suggest features?
Open an issue in the GitHub repository for bugs, feature requests, or questions. Contributions are welcome — feel free to send a PR.