@genesisx/create-workspace

create-workspace

This package offers the opportunity to effortlessly establish a fresh workspace, harnessing the potent presets of GenesisX in combination with selectable plugins for the accelerated inception of your upcoming application or project. The package caters to both NX and Turbo workspaces.

Directory Structure

Below is a typical directory structure for a workspace generated using the Genesis create-workspace CLI.

1. NX workspace

  my-nx-workspace
  ├── apps/
  ├── libs/
  ├── tools/
  ├── .gitignore
  ├── .prettierrc
  ├── nx.json
  ├── package.json
  ├── README.md
  ├── tsconfig.base.json
  └── workspace.json

2. TURBO workspace

  my-turbo-workspace
  ├── apps/
  |   ├── docs/
  |   └── web/
  ├── packages
  |   ├── eslint-config-custom/
  |   ├── tsconfig/
  |   └── ui/
  ├── .gitignore
  ├── .eslintrc
  ├── .npmrc
  ├── package.json
  ├── README.md
  └── turbo.json

The NX folder structure is well-suited for most of our NX based packages that rely on shared libraries and features used across multiple applications.

To generate files and apply the "App" preset, the GenesisX CLI uses the create-nx-workspace command. One of the benefits of using create-workspace is that you can select which GenesisX plugins to install automatically. Additionally, it builds the project using the latest supported version of NX that has been tested with GenesisX plugins.

Note: If you are opting for the Turbo based workspace, you will not have the option to select the GenesisX plugins which are currently NX based. We are working on making the existing plugins NX agnostic and thus will be available for Turbo based workspaces as well in the near future.

Usage

The CLI runs as an NPX script and will prompt you for more input as required. Open a terminal in the folder where you would like to create your project. It will prompt you for a project name and will create files in a directory by that name (in snake case).

Interactive Mode

  npx @genesisx/create-workspace@latest

1. Run the above command where you want your workspace generated.
2. Select the desired monorepo solution you want to use.
3. Provide a name for your new workspace.
4. • If NX, select the NX based GenesisX application generators to be installed along with the workspace initialization.
   • If Turbo, select the package manager to be used for the workspace initialization.

Non-interactive Mode

• NX workspace

npx @genesisx/create-workspace@latest --nx <workspace-name>

• TURBO workspace

npx @genesisx/create-workspace@latest --turbo <workspace-name>

Generators & Plugins

Nx provides a large number of generators and executors that can be used by installing plugins. There are a huge number of communitiy maintained plugins which can be found in the Nx Plugin Directory and officially supported plugins for all major frameworks:

React

• Overview
• Application Generator
• Component Generator
• Library Generator
• Hook Generator
• Stories Generator
• Redux Generator

Angular

• Overview
• Application Generator
• Library Generator
• Stories Generator
• ngRx Generator

React Native

• Overview
• Application Generator
• Component Generator
• Library Generator
• Stories Generator

Genesis Plugins

The goal of the Genesis project is to accelerate development and increase quality by providing templates that encapsulate best practices through generators that can be run against your project. Genesis plugins are installed into the node_modules directory and can be run from the command line or from the Nx console in Visual Studio Code. You can also "eject" a plugin which will convert it into a workspace generator which you can customize as required.

• JenkinsFile Template
• GraphQL Federation

Contributing

Build Commands

To build the CLI run this command in the terminal:

nx run create-workspace:build To execute lint checks run: nx run create-workspace:lint To execute unit test cases run: nx run create-workspace:test

Publishing

To publish the package you must first be logged into NPM (npm login) then run this command from the root of the project.

• Make sure the package name in package.json should start with @genesisx/
• Also use the correct version number in package.json same will be used for the published package.
• Use your NPM js credentials (Publicis Sapient) with publish rights
• Verify the package at https://www.npmjs.com/settings/genesisx/packages

npm publish dist/packages/create-workspace --access public