Modern-project-generator NPM

modern-project-generator

Project Generator - Micro-generator framework that makes it easy for an entire team to create web project files with a level of uniformity.

Prerequisites

NodeJS LTS

Getting Started

Install modern-project-generator

npm i -g modern-project-generator

Create a sym link so you can use the cli command:

npm link modern-project-generator

Usage with custom cli command

plop-project - For example:

➜  modern-project-generator git:(master) ✗ plop-project
? workspace: (Use arrow keys)
  component-lib
❯ create-react-app
  cypress-e2e
  gatsby
  gatsby-contentful
  next
  node-backend-service
(Move up and down to reveal more choices)

Usage without custom cli command

// package.json
{
  "scripts": {
    "plop": "./node_modules/modern-project-generator/bin/cli.js"
  },
  ...
}

NPM Example: npm run plop

This command will scaffold/bootstrap the selected project using the template files in the plop generator repo.

Generators

NAME	Description	Status
`CREATE-REACT-APP`	NPX CRA with some flavor(structure), CI/CD Build Pipelines	NOT STARTED
`COMPONENT-LIB`	React Component Library with Storybook and CI/CD Build Pipelines	IN PROGRESS
`CYPRESS E2E`	Cypress Headless Browser Functional/Integration/E2E Test Suite	READY
`GATSBY`	React-based open source framework for creating websites and apps. CI/CD Build Pipelines	IN REVIEW
`GATSBY-CONTENTFUL`	Gatsby/Contentful CMS Project Template with CI/CD Build Pipelines	READY
`NEXT`	React framework with Storybook, CI/CD Build Pipelines and some flavor	NOT STARTED
`NODE-BACKEND-SERVICE`	Non-REST Internal NodeJS/Typescript Service with CI/CD Pipelines	READY
`NODE-EXPRESS`	NodesJS/Express HTTP REST Server with middleware, utils, and CI/CD pipelines	READY
`NODE-FASTIFY`	NodesJS/Fastify HTTP REST API Server with middleware, utils, and CI/CD pipelines	IN PROGRESS
`NODE-GQL`	NodesJS Apollo GraphQL Server with middleware, utils, and CI/CD pipelines	READY
`SERVERLESS-CLOUD-FUNCTIONS`	Google/Firebase Cloud Functions with CI/CD pipelines	READY
`SERVERLESS-AZURE-FUNCTIONS`	Azure SAM Functions with CI/CD pipelines	NOT STARTED
`SERVERLESS-LAMBDA-FUNCTIONS`	AWS SAM Lambda Functions with CI/CD pipelines	NOT STARTED
`SHARED-LIB`	Shared/Common Util Workspace	IN PROGRESS

Full Example

> plop

? workspace: (Use arrow keys)
❯ create-react-app
  gatsby
  next
  node-backend-service
  node-express
  node-fastify
  node-gql
(Move up and down to reveal more choices)
? organization name test-org
? workspace name test-app
⠋ Install Dependencies
✔  ++ /test-app/.env
✔  ++ /test-app/Dockerfile
✔  ++ /test-app/codegen.yml
✔  ++ /test-app/docker-compose.yaml
✔  ++ /test-app/package.json
✔  ++ /test-app/src/app.ts
-  --SKIPPED /test-app/src/middleware/limiter.middleware.ts
✔  ++ /test-app/src/middleware/token.middleware.ts
✔  ++ /test-app/src/server.ts
...
... npm install
...