---

name: create-from-template description: Create a new app or package from an existing template in the monorepo. Use when adding new apps or packages to the repository.

Create a New App or Package From a Template

Overview

Create a new app or package in the monorepo using an existing template.

Workflow

1. Identify the template to use from dev/templates and the target location in the monorepo (dev/apps or dev/packages).
2. Copy the template directory to the target location and rename it appropriately. Skip copying coverage, dist, node_modules, and .react-router directories.
3. Update any necessary configuration files (e.g., package.json) to reflect the new app or package name.
4. The template apps and packages are located one level deeper in the directory structure (e.g., dev/templates/apps/react vs. dev/apps/some-app).
   1. Some configuration files referring to shared paths will need to be adjusted. For example, in .stylelintrc.json the path ../../../config/stylelint/.stylelintrc.json => ../../config/stylelint/.stylelintrc.json
   2. Same is true for tsconfig.json, tsconfig.build.json, and postcss.config.cjs among others.
5. Update the README.md file to reflect what you know about the new app or package.
6. Install dependencies and verify the new app or package builds and runs correctly.