The Labs SPA generator will create a basic cra react app with configuration and components in place based on answers to the prompts. Common elements found in all configurations are:

• Labs opinionated project structure
• example page/common components
• Working tests for components using jest and React Testing Library
• Labs defined eslint and pretter config
• github ci/actions workflow config
• git hook enforced linting using Husky

Create a SPA app for the labs 27 gigantic product

labs @lambdalabs/spa labs27-gigantic

Create a SPA app for the Labs 26 gigantic product with the labs program option

labs @lambdalabs/spa labs26-gigantic --program=labs

When only the project name argument is provided then you will be prompted for more info.

This is the default generator that will create the entire project.

Usage:
  labs @lambdalabs/spa <name> [options]

Options:
  -h,   --help           # Print the generator's options and usage
        --skip-cache     # Do not remember prompt answers                                                                     Default: false
        --skip-install   # Do not automatically install dependencies                                                          Default: false
        --force-install  # Fail on install dependencies error                                                                 Default: false
        --ask-answered   # Show prompts for already configured options                                                        Default: false
  -p,   --program        # Which program will this be used for: "bw" or "labs"
  -r,   --repoUrl        # The Github repo HTTPS git url. eg, https://github.com/lambda-school-labs/labsNN-productA-teamB-fe
  -d,   --hasDS          # project has DS team members

Arguments:
  name  # Name of Project  Type: String  Required: true

The following prompts will provide additional configuration and examples

--hasDS or -d - passing false to the option will turn it off. (--hasDS=false)

If the answer is Y then the following items will be added to the project:

• modules plotly.js and react-plotly.js
• an example data visualization page component ExampleDataViz using a DS API.

--program or -p - pass labs or bw

The program choices are BW and Labs

• BW will generate the base configuration.
• Labs will add the following elements
  • Okta identity management service
  • Secure routes using Okta library
  • Secure BE API example using Okta JWT
  • Ant Design configuration and theme
  • Storybook documentation
  • AWS Amplify config file

--repoUrl or -r - leave empty (-r) to turn off

This is the git https url (eg https://github.com/Lambda-School-Labs/gen-test-git.git)

When this value is provided then the generator will do the following:

• init the git repo with this URL as the remote
• create a main branch
• stage and commit the generated files
• push the branch to github

This will create a new page component.

Usage:
  labs @lambdalabs/spa:page <name> [options]

Options:
  -h,   --help           # Print the generator's options and usage
        --skip-cache     # Do not remember prompt answers               Default: false
        --skip-install   # Do not automatically install dependencies    Default: false
        --force-install  # Fail on install dependencies error           Default: false
        --ask-answered   # Show prompts for already configured options  Default: false
  -o,   --useOkta        # include the okta auth state for user info

Arguments:
  name  # Name of Page  Type: String  Required: true

The following prompts/options will provide additional configuration and examples

--useOkta or -o - passing false to the option will turn it off. (--useOkta=false)

When this value is provided then the generator will do the following:

• include the @okta/okta-react library
• setup authState and authService
• get and memoize user info
• add a loading component