@genesisx/create-workspace
v4.0.4
Published
Generator package for Smart, Fast and Reusable Project Scaffolds
Downloads
13
Maintainers
Keywords
Readme
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.
- NX workspace
my-nx-workspace
├── apps/
├── libs/
├── tools/
├── .gitignore
├── .prettierrc
├── nx.json
├── package.json
├── README.md
├── tsconfig.base.json
└── workspace.json
- 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
- Run the above command where you want your workspace generated.
- Select the desired monorepo solution you want to use.
- Provide a name for your new workspace.
- 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
React Native
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.
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