Merge pull request #3125 from epam/deprecate-cra-tempate

chore: depreate cra template

Author: JuliaMV

.github/workflows/release.yml

@@ -72,15 +72,11 @@ jobs:
         # npm 11.x, which properly exchanges the GitHub OIDC token for a publish token.
         #
         # npm 11 ignores publishConfig.directory when called directly, so we pass ./build as
-        # the explicit directory argument. cra-template-uui has no build step and publishes from
-        # root — it is handled in a separate lerna exec call to avoid shell nesting issues.
+        # the explicit directory argument.
         run: |
           npx lerna exec --sort --stream \
             --ignore=@epam/app --ignore=@epam/uui-e2e-tests --ignore=@epam/cra-template-uui \
             -- npm stage publish ./build --provenance --access public --tag "$DIST_TAG" --ignore-scripts
-          npx lerna exec --sort --stream \
-            --scope=@epam/cra-template-uui \
-            -- npm stage publish --provenance --access public --tag "$DIST_TAG" --ignore-scripts
         env:
           DIST_TAG: ${{ inputs.dist_tag || 'latest' }}
 

AGENTS.md

@@ -23,7 +23,7 @@
 - `@epam/uui-docs` — Utilities for docs site (DocBuilder, demo data, Property Explorer contexts). Needed when working on documentation
 - `@epam/uui-build` — Build scripts, linting config, npm scripts
 - `@epam/uui-db` — Client-side relational state cache
-- `templates/` — Project templates (CRA, Next.js, Vite)
+- `templates/` — Project templates: `uui-vite-template` and `uui-nextjs-template`; `uui-cra-template` deprecated — kept only for the `trackBundleSize` CI pipeline
 - `next-demo/` — Next.js demo apps for integration testing
 
 ## 2) Development Environment

README.md

@@ -27,18 +27,14 @@ Check out [UUI website](https://uui.epam.com) for [demo](https://uui.epam.com/de
 ## Getting started
 To add UUI into an existing project, check out our [Getting Started](https://uui.epam.com/documents?id=gettingStarted&theme=electric) guide.
 
-For the new projects we recommend to use our custom [CRA](https://github.com/epam/UUI/tree/main/templates/uui-cra-template), [Vite](https://github.com/epam/UUI/tree/main/templates/uui-vite-template) or [Next.js](https://github.com/epam/UUI/tree/main/templates/uui-nextjs-template) app templates for quick start
-
+For new projects we recommend our [Vite](https://github.com/epam/UUI/tree/main/templates/uui-vite-template) or [Next.js](https://github.com/epam/UUI/tree/main/templates/uui-nextjs-template) app templates for quick start
 
 ```sh
-#CRA 
-npx create-react-app my-app --template @epam/uui
-
 # Vite
 npx -- degit@latest https://github.com/epam/UUI/templates/uui-vite-template my-app
 
 # Next.js
-npx create-next-app --example "https://github.com/epam/UUI/tree/main/templates/uui-nextjs-template/template" my-app
+npx -- degit@latest https://github.com/epam/UUI/templates/uui-nextjs-template/template my-app
 ```
 ## Quick Try
 

app/src/docs/pages/gettingStarted.json

@@ -4,7 +4,6 @@
     "examples": [
         { "descriptionPath": "gettingStarted-intro" },
         { "name": "Starting a new Vite project", "descriptionPath": "gettingStarted-configuring from scratch vite" },
-        { "name": "Starting a new CRA-based project", "descriptionPath": "gettingStarted-configuring from scratch" },
         { "name": "Starting a new Next.js project", "descriptionPath": "gettingStarted-configuring from scratch nextjs" },
         { "name": "Adding UUI to existing project", "descriptionPath": "Configuring-into-existing-project" }
     ]

changelog.md

@@ -1,5 +1,6 @@
 # 6.5.xx - xx.xx.2026
 **What's New**
+* Remove support of deprecated `@epam/cra-template-uui` package. Create React App has been [officially deprecated](https://react.dev/blog/2025/02/14/sunsetting-create-react-app) by the React team. The package will no longer receive new updates or releases. Use the [Vite](https://github.com/epam/UUI/tree/main/templates/uui-vite-template) or [Next.js](https://github.com/epam/UUI/tree/main/templates/uui-nextjs-template) templates instead.
 
 **What's Fixed**
 * [RadioInput]: fixed the checked-state dot rendering off-center and with fractional pixel sizes at fractional browser/OS zoom levels.

dev-docs/overview.md

@@ -13,7 +13,7 @@ However, for building modules for release and for production environments, each
 ├── epam-electric    # @epam/electric package. Skin for Electric theme.
 ├── public    # static files for uui.epam.com site (example contents, images, doc gen artifacts). Usually this folder is used by the UUI server.
 ├── server    # Node.js server for uui.epam.com site. Serves docs content, demo API, UUI MCP.
-├── templates    # templates of uui project for CRA, Next.js and Vite
+├── templates    # project templates: uui-vite-template and uui-nextjs-template; uui-cra-template is deprecated — kept only for the trackBundleSize CI pipeline
 ├── test-utils    # @epam/uui-test-utils package. Common utils for writing tests with UUI components.
 ├── uui    # @epam/uui package. Ready-to-use, themeable UUI components for default and custom themes.
 ├── uui-build    # epam/uui-build package. Utils and scripts to build UUI repo and packages, linting configuration and some npm scripts.

dev-docs/release-workflow-setup.md

@@ -17,11 +17,11 @@ For each of the 13 published packages, add a Trusted Publisher on npmjs.org:
 
   CI will run the full publish cycle (OIDC auth, build, lerna publish from-git), but packages will land in a staged state and won't be visible to consumers until a maintainer promotes them on npmjs.com. This provides an extra review gate after the automated publish.
 
-Packages to configure (15 total):
+Packages to configure (14 total):
 
-`@epam/uui`, `@epam/uui-core`, `@epam/uui-components`, `@epam/loveship`, `@epam/promo`, `@epam/electric`, `@epam/assets`, `@epam/uui-editor`, `@epam/uui-timeline`, `@epam/uui-docs`, `@epam/uui-db`, `@epam/uui-test-utils`, `@epam/uui-build`, `@epam/uui-extra`, `@epam/cra-template-uui`
+`@epam/uui`, `@epam/uui-core`, `@epam/uui-components`, `@epam/loveship`, `@epam/promo`, `@epam/electric`, `@epam/assets`, `@epam/uui-editor`, `@epam/uui-timeline`, `@epam/uui-docs`, `@epam/uui-db`, `@epam/uui-test-utils`, `@epam/uui-build`, `@epam/uui-extra`
 
-**Deprecated packages** — these names exist on npmjs.com but are no longer published from this repository and should be ignored: `@epam/edu-core-routing`, `@epam/internal`, `@epam/draft-rte`.
+**Deprecated packages** — these names exist on npmjs.com but are no longer published from this repository and should be ignored: `@epam/edu-core-routing`, `@epam/internal`, `@epam/draft-rte`, `@epam/cra-template-uui`.
 
 #### 2. Create a GitHub Environment
 

package.json

@@ -63,8 +63,7 @@
       "uui-db",
       "uui-docs",
       "uui-editor",
-      "uui-timeline",
-      "templates/uui-cra-template"
+      "uui-timeline"
     ]
   },
   "author": "",

public/docs/content/coreConcepts.json

@@ -799,10 +799,10 @@
       },
       {
         "data": {
-          "url": "https://github.com/epam/UUI/blob/main/templates/uui-cra-template/template/src/index.tsx#L19"
+          "url": "https://github.com/epam/UUI/blob/main/templates/uui-vite-template/src/index.tsx#L25"
         },
         "type": "link",
-        "url": "https://github.com/epam/UUI/blob/main/templates/uui-cra-template/template/src/index.tsx#L19",
+        "url": "https://github.com/epam/UUI/blob/main/templates/uui-vite-template/src/index.tsx#L25",
         "children": [
           {
             "text": "template"

templates/uui-cra-template/README.md

@@ -1,21 +1,15 @@
 # cra-template-uui
 
-This is the official [UUI](https://uui.epam.com/) template for [Create React App](https://github.com/facebook/create-react-app).
-
-To use this template, add `--template @epam/uui` when creating a new app.
-
-For example:
-
-```sh
-npx create-react-app my-app --template @epam/uui
-
-# or
-
-yarn create react-app my-app --template @epam/uui
-```
-
-For more information, please refer to:
-
-- [Getting Started](https://create-react-app.dev/docs/getting-started) – How to create a new app.
-- [User Guide](https://create-react-app.dev) – How to develop apps bootstrapped with Create React App.
-- [UUI docs](https://uui.epam.com/) – UUI library official documentation.
+> **Deprecated**: This package is no longer published to npm and is not recommended for new projects.
+> It is kept in the repository solely for use by the internal `trackBundleSize` CI pipeline.
+>
+> For new projects, use the [Vite template](../uui-vite-template) or [Next.js template](../uui-nextjs-template) instead:
+> ```sh
+> # Vite
+> npx -- degit@latest https://github.com/epam/UUI/templates/uui-vite-template my-app
+>
+> # Next.js
+> npx -- degit@latest https://github.com/epam/UUI/templates/uui-nextjs-template/template my-app
+> ```
+
+This was the official [UUI](https://uui.epam.com/) template for [Create React App](https://github.com/facebook/create-react-app).