servora

Scaffold a production-ready Node.js Express backend with TypeScript or JavaScript, MongoDB, ESLint, Docker, and more — in one command.

No install required. Use npx so anyone can create a project without installing the CLI.

Quick start

npx servora my-app

Answer the prompts; you get a full project (package.json, app entry, routes, .env, README, etc.) and optional auto-install of dependencies.

That’s it. Do not run npm install -g servora — use npx servora every time.

Optional global install:

npm install -g servora
# or: pnpm add -g servora | yarn global add servora | bun add -g servora
servora my-app

Options

| Option | Description | |--------|-------------| | -y, --yes | Skip all prompts; use defaults (TypeScript, no MongoDB, no auto-install). | | -v, --version | Print version. | | -h, --help | Print help. |

Examples:

npx servora api -y
npx servora --help
npx servora --version

What you get

• Language: TypeScript or JavaScript (ES modules)
• Server: Express with express.json(), express.urlencoded()
• Database: Optional MongoDB with Mongoose and a sample User model
• Middleware: CORS, global error handler, custom logger, Morgan
• Config: .env and .env.example, path aliases (@/) for TypeScript
• Quality: ESLint (flat config)
• DevOps: Optional Dockerfile and .dockerignore
• Install: Choose npm, pnpm, yarn, or bun for installing dependencies

Generated structure (TypeScript):

my-app/
├── src/
│   ├── app.ts
│   ├── routes/
│   │   └── index.ts
│   ├── lib/db.ts
│   ├── models/
│   ├── middlewares/
│   ├── utils/
│   └── controllers/
├── package.json
├── tsconfig.json
├── eslint.config.js
├── .env
├── .env.example
├── .gitignore
├── README.md
└── (optional) Dockerfile, .dockerignore

Requirements

• Node.js >= 18
• Network access (to fetch latest dependency versions and run install)

Building from source

pnpm install
pnpm run build

If you use pnpm and the build fails with Could not resolve "...", run once:
pnpm install --node-linker=hoisted then pnpm run build. (Do not commit the generated .npmrc if you want to avoid the npm warning about unknown config.)

Publishing this package to npm

1. Create an npm account at npmjs.com and log in:

   npm login

2. Choose a package name

   • If servora is taken, use a scoped name in package.json:

     "name": "@your-username/servora"

   • Then users run: npx @your-username/servora my-app

3. Set repository URLs in package.json (replace your-username with your GitHub username):

   • repository.url
   • homepage
   • bugs.url

4. Build and publish:

   pnpm run build
   npm publish

   For a scoped package (e.g. @your-username/servora), the first publish must be:

   npm publish --access public

5. After publishing, anyone can run:

   npx servora my-app
   # or
   npx @your-username/servora my-app

License

ISC