1
0
mirror of https://github.com/Unleash/unleash.git synced 2025-10-04 11:17:02 +02:00
unleash.unleash/frontend
Thomas Heartman 8ade5b5dbb
feat: add tab switcher for change to json diff view in CR (#10179)
Updates the strategy change component used in change requests to have a
"tab"-like functionality, where you can switch between "Change" (the
rendered strategy) and "View diff" (the JSON diff). This is a tab
switcher, so you navigate it with arrow keys if on a keyboard, and I've
set selection to follow focus for now. This is my preference as it saves
you extra space/enter taps, but we can remove it later if we want.

Most of the changes in this PR is wrapping the existing strategy change
components/sections in tab panels and tab context providers.

Later changes in this project will remove the existing "view diff" hover
link in favor of this view.

There is some work to do on the design front (in terms of spacing,
borders, etc), but this covers the core functionality.

The pre-existing strategy change component has been moved into the
"LegacyStrategyChange" file with no changes beyond a deprecation
comment. The existing tests now test the new component instead with no
breakage. (I anticipate breaking when we remove the view diff link,
though)



Change with strategy variants:
<img width="991" alt="image"
src="https://github.com/user-attachments/assets/ac28912f-5b08-4a9c-96da-81bfd0b2e68e"
/>

<img width="1005" alt="image"
src="https://github.com/user-attachments/assets/4addaacc-101c-46cb-888f-95dc3b1cac25"
/>


## Edge case: deleted strat with no reference strategy

There is a case in the code where "reference strategy" can be undefined
for a deleted strategy. It is defined as follows:

```ts
    const referenceStrategy =
        changeRequestState === 'Applied'
            ? change.payload.snapshot
            : currentStrategy;

```

I've decided to still show the "(no changes)" json diff in that setting,
so that the tabs actually affect something. I don't know how often this
happens, though: probably not anymore unless your CR is _ancient_, as we
introduced the snapshot quite a while ago, and `currentStrategy`
shouldn't really be undefined here, I should think.

Deleted strategy with no reference strategy:

Change:
<img width="1013" alt="image"
src="https://github.com/user-attachments/assets/352eaec9-c0ef-4d5a-b765-11304daf4474"
/>

Diff:
<img width="1029" alt="image"
src="https://github.com/user-attachments/assets/e69c81a6-1ef7-47ff-853a-9fb900b26303"
/>
2025-06-30 11:04:44 +02:00
..
.yarn/releases chore: Bumped Yarn to 4.9.2 (#10126) 2025-06-12 12:01:43 +02:00
cypress chore!: removing userId strategy for new installations of Unleash (#9800) 2025-06-04 09:30:13 +02:00
public chore: simplify serving of static openapi assets (#10046) 2025-05-28 19:14:55 +02:00
scripts fix: orval for ESM (#10086) 2025-06-05 10:40:58 +00:00
src feat: add tab switcher for change to json diff view in CR (#10179) 2025-06-30 11:04:44 +02:00
.editorconfig
.gitignore
.npmignore
.nvmrc chore(deps): update node.js to v22 (#9487) 2025-05-14 10:31:18 +00:00
.yarnrc.yml chore: Bumped Yarn to 4.9.2 (#10126) 2025-06-12 12:01:43 +02:00
check-imports.rc
cypress.config.ts feat: Unleash v7 ESM migration (#9877) 2025-05-14 09:47:12 +02:00
cypress.d.ts
index.html feat: use Unleash React SDK in Admin UI (#9723) 2025-04-10 08:26:30 +02:00
index.js feat: Unleash v7 ESM migration (#9877) 2025-05-14 09:47:12 +02:00
mise.toml feat: Unleash v7 ESM migration (#9877) 2025-05-14 09:47:12 +02:00
orval.config.ts fix: orval for ESM (#10086) 2025-06-05 10:40:58 +00:00
package.json chore(deps): update react monorepo (#10221) 2025-06-27 02:51:07 +00:00
README.md
tsconfig.json feat: Unleash v7 ESM migration (#9877) 2025-05-14 09:47:12 +02:00
tsconfig.node.json feat: Unleash v7 ESM migration (#9877) 2025-05-14 09:47:12 +02:00
vercel.json
vite.config.mts
yarn.lock chore(deps): update dependency @types/node to v22.15.33 (#10223) 2025-06-27 07:58:41 +00:00

frontend

This directory contains the Unleash Admin UI frontend app.

Run with a local instance of the unleash-api

Refer to the Contributing to Unleash guide for instructions. The frontend dev server runs (in port 3000) simultaneously with the backend dev server (in port 4242):

yarn install
yarn dev

Run with a sandbox instance of the Unleash API

Alternatively, instead of running unleash-api on localhost, you can use a remote instance:

cd ./frontend
yarn install
yarn run start:sandbox

Running end-to-end tests

We have a set of Cypress tests that run on the build before a PR can be merged so it's important that you check these yourself before submitting a PR. On the server the tests will run against the deployed Heroku app so this is what you probably want to test against:

yarn run start:sandbox

In a different shell, you can run the tests themselves:

yarn run e2e:heroku

If you need to test against patches against a local server instance, you'll need to run that, and then run the end to end tests using:

yarn run e2e

You may also need to test that a feature works against the enterprise version of unleash. Assuming the Heroku instance is still running, this can be done by:

yarn run start:enterprise
yarn run e2e

Generating the OpenAPI client

The frontend uses an OpenAPI client generated from the backend's OpenAPI spec. Whenever there are changes to the backend API, the client should be regenerated:

For now we only use generated types (src/openapi/models). We will use methods (src/openapi/apis) for new features soon.

yarn gen:api
rm -rf src/openapi/apis

clean up src/openapi/index.ts imports, only keep first line export * from './models';

This script assumes that you have a running instance of the enterprise backend at http://localhost:4242. The new OpenAPI client will be generated from the runtime schema of this instance. The target URL can be changed by setting the UNLEASH_OPENAPI_URL env var.

Analyzing bundle size

npx vite-bundle-visualizer in the root of the frontend directory