diff --git a/packages/app/package.json b/packages/app/package.json
index 56b5178692..56e619e65a 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -46,6 +46,7 @@
"@backstage/integration-react": "workspace:^",
"@backstage/plugin-api-docs": "workspace:^",
"@backstage/plugin-auth-react": "workspace:^",
+ "@backstage/plugin-bui-themer": "workspace:^",
"@backstage/plugin-catalog": "workspace:^",
"@backstage/plugin-catalog-common": "workspace:^",
"@backstage/plugin-catalog-graph": "workspace:^",
diff --git a/packages/app/src/App.tsx b/packages/app/src/App.tsx
index ad525420a7..bd64dc504f 100644
--- a/packages/app/src/App.tsx
+++ b/packages/app/src/App.tsx
@@ -73,6 +73,7 @@ import {
} from '@backstage/plugin-notifications';
import { CustomizableHomePage } from './components/home/CustomizableHomePage';
import { HomePage } from './components/home/HomePage';
+import { BuiThemerPage } from '@backstage/plugin-bui-themer';
const app = createApp({
apis,
@@ -208,6 +209,7 @@ const routes = (
{customDevToolsPage}
} />
+ } />
);
diff --git a/plugins/bui-themer/.eslintrc.js b/plugins/bui-themer/.eslintrc.js
new file mode 100644
index 0000000000..e2a53a6ad2
--- /dev/null
+++ b/plugins/bui-themer/.eslintrc.js
@@ -0,0 +1 @@
+module.exports = require('@backstage/cli/config/eslint-factory')(__dirname);
diff --git a/plugins/bui-themer/README.md b/plugins/bui-themer/README.md
new file mode 100644
index 0000000000..f73dd7875e
--- /dev/null
+++ b/plugins/bui-themer/README.md
@@ -0,0 +1,13 @@
+# bui-themer
+
+Welcome to the bui-themer plugin!
+
+_This plugin was created through the Backstage CLI_
+
+## Getting started
+
+Your plugin has been added to the example app in this repository, meaning you'll be able to access it by running `yarn start` in the root directory, and then navigating to [/bui-themer](http://localhost:3000/bui-themer).
+
+You can also serve the plugin in isolation by running `yarn start` in the plugin directory.
+This method of serving the plugin provides quicker iteration speed and a faster startup and hot reloads.
+It is only meant for local development, and the setup for it can be found inside the [/dev](./dev) directory.
diff --git a/plugins/bui-themer/catalog-info.yaml b/plugins/bui-themer/catalog-info.yaml
new file mode 100644
index 0000000000..15e907a0ac
--- /dev/null
+++ b/plugins/bui-themer/catalog-info.yaml
@@ -0,0 +1,9 @@
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+ name: backstage-plugin-bui-themer
+ title: '@backstage/plugin-bui-themer'
+spec:
+ lifecycle: experimental
+ type: backstage-frontend-plugin
+ owner: maintainers
diff --git a/plugins/bui-themer/dev/index.tsx b/plugins/bui-themer/dev/index.tsx
new file mode 100644
index 0000000000..ce3986f7da
--- /dev/null
+++ b/plugins/bui-themer/dev/index.tsx
@@ -0,0 +1,26 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { createDevApp } from '@backstage/dev-utils';
+import { buiThemerPlugin, BuiThemerPage } from '../src/plugin';
+
+createDevApp()
+ .registerPlugin(buiThemerPlugin)
+ .addPage({
+ element: ,
+ title: 'Root Page',
+ path: '/bui-themer',
+ })
+ .render();
diff --git a/plugins/bui-themer/package.json b/plugins/bui-themer/package.json
new file mode 100644
index 0000000000..c0d49b0879
--- /dev/null
+++ b/plugins/bui-themer/package.json
@@ -0,0 +1,53 @@
+{
+ "name": "@backstage/plugin-bui-themer",
+ "version": "0.1.0",
+ "license": "Apache-2.0",
+ "private": true,
+ "main": "src/index.ts",
+ "types": "src/index.ts",
+ "publishConfig": {
+ "access": "public",
+ "main": "dist/index.esm.js",
+ "types": "dist/index.d.ts"
+ },
+ "backstage": {
+ "role": "frontend-plugin",
+ "pluginId": "bui-themer"
+ },
+ "sideEffects": false,
+ "scripts": {
+ "start": "backstage-cli package start",
+ "build": "backstage-cli package build",
+ "lint": "backstage-cli package lint",
+ "test": "backstage-cli package test",
+ "clean": "backstage-cli package clean",
+ "prepack": "backstage-cli package prepack",
+ "postpack": "backstage-cli package postpack"
+ },
+ "dependencies": {
+ "@backstage/core-components": "workspace:^",
+ "@backstage/core-plugin-api": "workspace:^",
+ "@backstage/theme": "workspace:^",
+ "@material-ui/core": "^4.9.13",
+ "@material-ui/icons": "^4.9.1",
+ "@material-ui/lab": "^4.0.0-alpha.61",
+ "react-use": "^17.2.4"
+ },
+ "peerDependencies": {
+ "react": "^16.13.1 || ^17.0.0 || ^18.0.0"
+ },
+ "devDependencies": {
+ "@backstage/cli": "workspace:^",
+ "@backstage/core-app-api": "workspace:^",
+ "@backstage/dev-utils": "workspace:^",
+ "@backstage/test-utils": "workspace:^",
+ "@testing-library/jest-dom": "^6.0.0",
+ "@testing-library/react": "^14.0.0",
+ "@testing-library/user-event": "^14.0.0",
+ "msw": "^1.0.0",
+ "react": "^16.13.1 || ^17.0.0 || ^18.0.0"
+ },
+ "files": [
+ "dist"
+ ]
+}
diff --git a/plugins/bui-themer/src/components/ExampleComponent/ExampleComponent.test.tsx b/plugins/bui-themer/src/components/ExampleComponent/ExampleComponent.test.tsx
new file mode 100644
index 0000000000..f5f7f185c5
--- /dev/null
+++ b/plugins/bui-themer/src/components/ExampleComponent/ExampleComponent.test.tsx
@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ExampleComponent } from './ExampleComponent';
+import { rest } from 'msw';
+import { setupServer } from 'msw/node';
+import { screen } from '@testing-library/react';
+import { registerMswTestHooks, renderInTestApp } from '@backstage/test-utils';
+
+describe('ExampleComponent', () => {
+ const server = setupServer();
+ // Enable sane handlers for network requests
+ registerMswTestHooks(server);
+
+ // setup mock response
+ beforeEach(() => {
+ server.use(
+ rest.get('/*', (_, res, ctx) => res(ctx.status(200), ctx.json({}))),
+ );
+ });
+
+ it('should render', async () => {
+ await renderInTestApp();
+ expect(screen.getByText('Welcome to bui-themer!')).toBeInTheDocument();
+ });
+});
diff --git a/plugins/bui-themer/src/components/ExampleComponent/ExampleComponent.tsx b/plugins/bui-themer/src/components/ExampleComponent/ExampleComponent.tsx
new file mode 100644
index 0000000000..3a04bd7562
--- /dev/null
+++ b/plugins/bui-themer/src/components/ExampleComponent/ExampleComponent.tsx
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Typography, Grid } from '@material-ui/core';
+import {
+ InfoCard,
+ Header,
+ Page,
+ Content,
+ ContentHeader,
+ HeaderLabel,
+ SupportButton,
+} from '@backstage/core-components';
+import { ExampleFetchComponent } from '../ExampleFetchComponent';
+
+export const ExampleComponent = () => (
+
+
+
+
+ A description of your plugin goes here.
+
+
+
+
+
+ All content should be wrapped in a card like this.
+
+
+
+
+
+
+
+
+
+);
diff --git a/plugins/bui-themer/src/components/ExampleComponent/index.ts b/plugins/bui-themer/src/components/ExampleComponent/index.ts
new file mode 100644
index 0000000000..66b3fc6c97
--- /dev/null
+++ b/plugins/bui-themer/src/components/ExampleComponent/index.ts
@@ -0,0 +1,16 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { ExampleComponent } from './ExampleComponent';
diff --git a/plugins/bui-themer/src/components/ExampleFetchComponent/ExampleFetchComponent.test.tsx b/plugins/bui-themer/src/components/ExampleFetchComponent/ExampleFetchComponent.test.tsx
new file mode 100644
index 0000000000..a3085e3dcb
--- /dev/null
+++ b/plugins/bui-themer/src/components/ExampleFetchComponent/ExampleFetchComponent.test.tsx
@@ -0,0 +1,34 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { renderInTestApp } from '@backstage/test-utils';
+import { ExampleFetchComponent } from './ExampleFetchComponent';
+
+describe('ExampleFetchComponent', () => {
+ it('renders the user table', async () => {
+ const { getAllByText, getByAltText, getByText, findByRole } =
+ await renderInTestApp();
+
+ // Wait for the table to render
+ const table = await findByRole('table');
+ const nationality = getAllByText('GB');
+ // Assert that the table contains the expected user data
+ expect(table).toBeInTheDocument();
+ expect(getByAltText('Carolyn')).toBeInTheDocument();
+ expect(getByText('Carolyn Moore')).toBeInTheDocument();
+ expect(getByText('carolyn.moore@example.com')).toBeInTheDocument();
+ expect(nationality[0]).toBeInTheDocument();
+ });
+});
diff --git a/plugins/bui-themer/src/components/ExampleFetchComponent/ExampleFetchComponent.tsx b/plugins/bui-themer/src/components/ExampleFetchComponent/ExampleFetchComponent.tsx
new file mode 100644
index 0000000000..6c9e77094d
--- /dev/null
+++ b/plugins/bui-themer/src/components/ExampleFetchComponent/ExampleFetchComponent.tsx
@@ -0,0 +1,322 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { makeStyles } from '@material-ui/core/styles';
+import {
+ Table,
+ TableColumn,
+ Progress,
+ ResponseErrorPanel,
+} from '@backstage/core-components';
+import useAsync from 'react-use/lib/useAsync';
+
+export const exampleUsers = {
+ results: [
+ {
+ gender: 'female',
+ name: {
+ title: 'Miss',
+ first: 'Carolyn',
+ last: 'Moore',
+ },
+ email: 'carolyn.moore@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Carolyn',
+ nat: 'GB',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Ms',
+ first: 'Esma',
+ last: 'Berberoğlu',
+ },
+ email: 'esma.berberoglu@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Esma',
+ nat: 'TR',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Ms',
+ first: 'Isabella',
+ last: 'Rhodes',
+ },
+ email: 'isabella.rhodes@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Isabella',
+ nat: 'GB',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Derrick',
+ last: 'Carter',
+ },
+ email: 'derrick.carter@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Derrick',
+ nat: 'IE',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Miss',
+ first: 'Mattie',
+ last: 'Lambert',
+ },
+ email: 'mattie.lambert@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Mattie',
+ nat: 'AU',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Mijat',
+ last: 'Rakić',
+ },
+ email: 'mijat.rakic@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Mijat',
+ nat: 'RS',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Javier',
+ last: 'Reid',
+ },
+ email: 'javier.reid@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Javier',
+ nat: 'US',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Ms',
+ first: 'Isabella',
+ last: 'Li',
+ },
+ email: 'isabella.li@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Isabella',
+ nat: 'CA',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Mrs',
+ first: 'Stephanie',
+ last: 'Garrett',
+ },
+ email: 'stephanie.garrett@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Stephanie',
+ nat: 'AU',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Ms',
+ first: 'Antonia',
+ last: 'Núñez',
+ },
+ email: 'antonia.nunez@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Antonia',
+ nat: 'ES',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Donald',
+ last: 'Young',
+ },
+ email: 'donald.young@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Donald',
+ nat: 'US',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Iegor',
+ last: 'Holodovskiy',
+ },
+ email: 'iegor.holodovskiy@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Iegor',
+ nat: 'UA',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Madame',
+ first: 'Jessica',
+ last: 'David',
+ },
+ email: 'jessica.david@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Jessica',
+ nat: 'CH',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Ms',
+ first: 'Eve',
+ last: 'Martinez',
+ },
+ email: 'eve.martinez@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Eve',
+ nat: 'FR',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Caleb',
+ last: 'Silva',
+ },
+ email: 'caleb.silva@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Caleb',
+ nat: 'US',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Miss',
+ first: 'Marcia',
+ last: 'Jenkins',
+ },
+ email: 'marcia.jenkins@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Marcia',
+ nat: 'US',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Mrs',
+ first: 'Mackenzie',
+ last: 'Jones',
+ },
+ email: 'mackenzie.jones@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Mackenzie',
+ nat: 'NZ',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Jeremiah',
+ last: 'Gutierrez',
+ },
+ email: 'jeremiah.gutierrez@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Jeremiah',
+ nat: 'AU',
+ },
+ {
+ gender: 'female',
+ name: {
+ title: 'Ms',
+ first: 'Luciara',
+ last: 'Souza',
+ },
+ email: 'luciara.souza@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Luciara',
+ nat: 'BR',
+ },
+ {
+ gender: 'male',
+ name: {
+ title: 'Mr',
+ first: 'Valgi',
+ last: 'da Cunha',
+ },
+ email: 'valgi.dacunha@example.com',
+ picture: 'https://api.dicebear.com/6.x/open-peeps/svg?seed=Valgi',
+ nat: 'BR',
+ },
+ ],
+};
+
+const useStyles = makeStyles({
+ avatar: {
+ height: 32,
+ width: 32,
+ borderRadius: '50%',
+ },
+});
+
+type User = {
+ gender: string; // "male"
+ name: {
+ title: string; // "Mr",
+ first: string; // "Duane",
+ last: string; // "Reed"
+ };
+ email: string; // "duane.reed@example.com"
+ picture: string; // "https://api.dicebear.com/6.x/open-peeps/svg?seed=Duane"
+ nat: string; // "AU"
+};
+
+type DenseTableProps = {
+ users: User[];
+};
+
+export const DenseTable = ({ users }: DenseTableProps) => {
+ const classes = useStyles();
+
+ const columns: TableColumn[] = [
+ { title: 'Avatar', field: 'avatar' },
+ { title: 'Name', field: 'name' },
+ { title: 'Email', field: 'email' },
+ { title: 'Nationality', field: 'nationality' },
+ ];
+
+ const data = users.map(user => {
+ return {
+ avatar: (
+
+ ),
+ name: `${user.name.first} ${user.name.last}`,
+ email: user.email,
+ nationality: user.nat,
+ };
+ });
+
+ return (
+
+ );
+};
+
+export const ExampleFetchComponent = () => {
+ const { value, loading, error } = useAsync(async (): Promise => {
+ // Would use fetch in a real world example
+ return exampleUsers.results;
+ }, []);
+
+ if (loading) {
+ return ;
+ } else if (error) {
+ return ;
+ }
+
+ return ;
+};
diff --git a/plugins/bui-themer/src/components/ExampleFetchComponent/index.ts b/plugins/bui-themer/src/components/ExampleFetchComponent/index.ts
new file mode 100644
index 0000000000..b0be0a2a71
--- /dev/null
+++ b/plugins/bui-themer/src/components/ExampleFetchComponent/index.ts
@@ -0,0 +1,16 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { ExampleFetchComponent } from './ExampleFetchComponent';
diff --git a/plugins/bui-themer/src/index.ts b/plugins/bui-themer/src/index.ts
new file mode 100644
index 0000000000..26bc35ebb1
--- /dev/null
+++ b/plugins/bui-themer/src/index.ts
@@ -0,0 +1,16 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { buiThemerPlugin, BuiThemerPage } from './plugin';
diff --git a/plugins/bui-themer/src/plugin.test.ts b/plugins/bui-themer/src/plugin.test.ts
new file mode 100644
index 0000000000..b19adaf007
--- /dev/null
+++ b/plugins/bui-themer/src/plugin.test.ts
@@ -0,0 +1,22 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { buiThemerPlugin } from './plugin';
+
+describe('bui-themer', () => {
+ it('should export plugin', () => {
+ expect(buiThemerPlugin).toBeDefined();
+ });
+});
diff --git a/plugins/bui-themer/src/plugin.ts b/plugins/bui-themer/src/plugin.ts
new file mode 100644
index 0000000000..d87d035b12
--- /dev/null
+++ b/plugins/bui-themer/src/plugin.ts
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import {
+ createPlugin,
+ createRoutableExtension,
+} from '@backstage/core-plugin-api';
+
+import { rootRouteRef } from './routes';
+
+export const buiThemerPlugin = createPlugin({
+ id: 'bui-themer',
+ routes: {
+ root: rootRouteRef,
+ },
+});
+
+export const BuiThemerPage = buiThemerPlugin.provide(
+ createRoutableExtension({
+ name: 'BuiThemerPage',
+ component: () =>
+ import('./components/ExampleComponent').then(m => m.ExampleComponent),
+ mountPoint: rootRouteRef,
+ }),
+);
diff --git a/plugins/bui-themer/src/routes.ts b/plugins/bui-themer/src/routes.ts
new file mode 100644
index 0000000000..efd79e62be
--- /dev/null
+++ b/plugins/bui-themer/src/routes.ts
@@ -0,0 +1,20 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { createRouteRef } from '@backstage/core-plugin-api';
+
+export const rootRouteRef = createRouteRef({
+ id: 'bui-themer',
+});
diff --git a/plugins/bui-themer/src/setupTests.ts b/plugins/bui-themer/src/setupTests.ts
new file mode 100644
index 0000000000..b57590b525
--- /dev/null
+++ b/plugins/bui-themer/src/setupTests.ts
@@ -0,0 +1,16 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import '@testing-library/jest-dom';
diff --git a/yarn.lock b/yarn.lock
index c1a352407c..cb9a75fa61 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -4323,6 +4323,31 @@ __metadata:
languageName: unknown
linkType: soft
+"@backstage/plugin-bui-themer@workspace:^, @backstage/plugin-bui-themer@workspace:plugins/bui-themer":
+ version: 0.0.0-use.local
+ resolution: "@backstage/plugin-bui-themer@workspace:plugins/bui-themer"
+ dependencies:
+ "@backstage/cli": "workspace:^"
+ "@backstage/core-app-api": "workspace:^"
+ "@backstage/core-components": "workspace:^"
+ "@backstage/core-plugin-api": "workspace:^"
+ "@backstage/dev-utils": "workspace:^"
+ "@backstage/test-utils": "workspace:^"
+ "@backstage/theme": "workspace:^"
+ "@material-ui/core": "npm:^4.9.13"
+ "@material-ui/icons": "npm:^4.9.1"
+ "@material-ui/lab": "npm:^4.0.0-alpha.61"
+ "@testing-library/jest-dom": "npm:^6.0.0"
+ "@testing-library/react": "npm:^14.0.0"
+ "@testing-library/user-event": "npm:^14.0.0"
+ msw: "npm:^1.0.0"
+ react: "npm:^16.13.1 || ^17.0.0 || ^18.0.0"
+ react-use: "npm:^17.2.4"
+ peerDependencies:
+ react: ^16.13.1 || ^17.0.0 || ^18.0.0
+ languageName: unknown
+ linkType: soft
+
"@backstage/plugin-catalog-backend-module-aws@workspace:plugins/catalog-backend-module-aws":
version: 0.0.0-use.local
resolution: "@backstage/plugin-catalog-backend-module-aws@workspace:plugins/catalog-backend-module-aws"
@@ -19238,6 +19263,22 @@ __metadata:
languageName: node
linkType: hard
+"@testing-library/dom@npm:^9.0.0":
+ version: 9.3.4
+ resolution: "@testing-library/dom@npm:9.3.4"
+ dependencies:
+ "@babel/code-frame": "npm:^7.10.4"
+ "@babel/runtime": "npm:^7.12.5"
+ "@types/aria-query": "npm:^5.0.1"
+ aria-query: "npm:5.1.3"
+ chalk: "npm:^4.1.0"
+ dom-accessibility-api: "npm:^0.5.9"
+ lz-string: "npm:^1.5.0"
+ pretty-format: "npm:^27.0.2"
+ checksum: 10/510da752ea76f4a10a0a4e3a77917b0302cf03effe576cd3534cab7e796533ee2b0e9fb6fb11b911a1ebd7c70a0bb6f235bf4f816c9b82b95b8fe0cddfd10975
+ languageName: node
+ linkType: hard
+
"@testing-library/jest-dom@npm:^6.0.0, @testing-library/jest-dom@npm:^6.6.3":
version: 6.8.0
resolution: "@testing-library/jest-dom@npm:6.8.0"
@@ -19274,6 +19315,20 @@ __metadata:
languageName: node
linkType: hard
+"@testing-library/react@npm:^14.0.0":
+ version: 14.3.1
+ resolution: "@testing-library/react@npm:14.3.1"
+ dependencies:
+ "@babel/runtime": "npm:^7.12.5"
+ "@testing-library/dom": "npm:^9.0.0"
+ "@types/react-dom": "npm:^18.0.0"
+ peerDependencies:
+ react: ^18.0.0
+ react-dom: ^18.0.0
+ checksum: 10/83359dcdf9eaf067839f34604e1a181cbc14fc09f3a07672403700fcc6a900c4b8054ad1114fc24b4b9f89d84e2a09e1b7c9afce2306b1d4b4c9e30eb1cb12de
+ languageName: node
+ linkType: hard
+
"@testing-library/react@npm:^16.0.0":
version: 16.3.0
resolution: "@testing-library/react@npm:16.3.0"
@@ -23624,6 +23679,15 @@ __metadata:
languageName: node
linkType: hard
+"aria-query@npm:5.1.3":
+ version: 5.1.3
+ resolution: "aria-query@npm:5.1.3"
+ dependencies:
+ deep-equal: "npm:^2.0.5"
+ checksum: 10/e5da608a7c4954bfece2d879342b6c218b6b207e2d9e5af270b5e38ef8418f02d122afdc948b68e32649b849a38377785252059090d66fa8081da95d1609c0d2
+ languageName: node
+ linkType: hard
+
"aria-query@npm:5.3.0":
version: 5.3.0
resolution: "aria-query@npm:5.3.0"
@@ -23640,7 +23704,7 @@ __metadata:
languageName: node
linkType: hard
-"array-buffer-byte-length@npm:^1.0.1, array-buffer-byte-length@npm:^1.0.2":
+"array-buffer-byte-length@npm:^1.0.0, array-buffer-byte-length@npm:^1.0.1, array-buffer-byte-length@npm:^1.0.2":
version: 1.0.2
resolution: "array-buffer-byte-length@npm:1.0.2"
dependencies:
@@ -27393,6 +27457,32 @@ __metadata:
languageName: node
linkType: hard
+"deep-equal@npm:^2.0.5":
+ version: 2.2.3
+ resolution: "deep-equal@npm:2.2.3"
+ dependencies:
+ array-buffer-byte-length: "npm:^1.0.0"
+ call-bind: "npm:^1.0.5"
+ es-get-iterator: "npm:^1.1.3"
+ get-intrinsic: "npm:^1.2.2"
+ is-arguments: "npm:^1.1.1"
+ is-array-buffer: "npm:^3.0.2"
+ is-date-object: "npm:^1.0.5"
+ is-regex: "npm:^1.1.4"
+ is-shared-array-buffer: "npm:^1.0.2"
+ isarray: "npm:^2.0.5"
+ object-is: "npm:^1.1.5"
+ object-keys: "npm:^1.1.1"
+ object.assign: "npm:^4.1.4"
+ regexp.prototype.flags: "npm:^1.5.1"
+ side-channel: "npm:^1.0.4"
+ which-boxed-primitive: "npm:^1.0.2"
+ which-collection: "npm:^1.0.1"
+ which-typed-array: "npm:^1.1.13"
+ checksum: 10/1ce49d0b71d0f14d8ef991a742665eccd488dfc9b3cada069d4d7a86291e591c92d2589c832811dea182b4015736b210acaaebce6184be356c1060d176f5a05f
+ languageName: node
+ linkType: hard
+
"deep-equal@npm:~1.0.1":
version: 1.0.1
resolution: "deep-equal@npm:1.0.1"
@@ -28611,7 +28701,7 @@ __metadata:
languageName: node
linkType: hard
-"es-get-iterator@npm:^1.0.2":
+"es-get-iterator@npm:^1.0.2, es-get-iterator@npm:^1.1.3":
version: 1.1.3
resolution: "es-get-iterator@npm:1.1.3"
dependencies:
@@ -29663,6 +29753,7 @@ __metadata:
"@backstage/integration-react": "workspace:^"
"@backstage/plugin-api-docs": "workspace:^"
"@backstage/plugin-auth-react": "workspace:^"
+ "@backstage/plugin-bui-themer": "workspace:^"
"@backstage/plugin-catalog": "workspace:^"
"@backstage/plugin-catalog-common": "workspace:^"
"@backstage/plugin-catalog-graph": "workspace:^"
@@ -31215,7 +31306,7 @@ __metadata:
languageName: node
linkType: hard
-"get-intrinsic@npm:^1.1.3, get-intrinsic@npm:^1.2.1, get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.5, get-intrinsic@npm:^1.2.6, get-intrinsic@npm:^1.3.0":
+"get-intrinsic@npm:^1.1.3, get-intrinsic@npm:^1.2.1, get-intrinsic@npm:^1.2.2, get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.5, get-intrinsic@npm:^1.2.6, get-intrinsic@npm:^1.3.0":
version: 1.3.0
resolution: "get-intrinsic@npm:1.3.0"
dependencies:
@@ -33148,7 +33239,7 @@ __metadata:
languageName: node
linkType: hard
-"is-array-buffer@npm:^3.0.4, is-array-buffer@npm:^3.0.5":
+"is-array-buffer@npm:^3.0.2, is-array-buffer@npm:^3.0.4, is-array-buffer@npm:^3.0.5":
version: 3.0.5
resolution: "is-array-buffer@npm:3.0.5"
dependencies:
@@ -33621,7 +33712,7 @@ __metadata:
languageName: node
linkType: hard
-"is-regex@npm:^1.2.1":
+"is-regex@npm:^1.1.4, is-regex@npm:^1.2.1":
version: 1.2.1
resolution: "is-regex@npm:1.2.1"
dependencies:
@@ -33670,7 +33761,7 @@ __metadata:
languageName: node
linkType: hard
-"is-shared-array-buffer@npm:^1.0.4":
+"is-shared-array-buffer@npm:^1.0.2, is-shared-array-buffer@npm:^1.0.4":
version: 1.0.4
resolution: "is-shared-array-buffer@npm:1.0.4"
dependencies:
@@ -43096,6 +43187,15 @@ __metadata:
languageName: node
linkType: hard
+"react@npm:^16.13.1 || ^17.0.0 || ^18.0.0, react@npm:^18.0.2":
+ version: 18.3.1
+ resolution: "react@npm:18.3.1"
+ dependencies:
+ loose-envify: "npm:^1.1.0"
+ checksum: 10/261137d3f3993eaa2368a83110466fc0e558bc2c7f7ae7ca52d94f03aac945f45146bd85e5f481044db1758a1dbb57879e2fcdd33924e2dde1bdc550ce73f7bf
+ languageName: node
+ linkType: hard
+
"react@npm:^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0":
version: 19.1.1
resolution: "react@npm:19.1.1"
@@ -43113,15 +43213,6 @@ __metadata:
languageName: node
linkType: hard
-"react@npm:^18.0.2":
- version: 18.3.1
- resolution: "react@npm:18.3.1"
- dependencies:
- loose-envify: "npm:^1.1.0"
- checksum: 10/261137d3f3993eaa2368a83110466fc0e558bc2c7f7ae7ca52d94f03aac945f45146bd85e5f481044db1758a1dbb57879e2fcdd33924e2dde1bdc550ce73f7bf
- languageName: node
- linkType: hard
-
"read-cmd-shim@npm:^2.0.0":
version: 2.0.0
resolution: "read-cmd-shim@npm:2.0.0"
@@ -43396,7 +43487,7 @@ __metadata:
languageName: node
linkType: hard
-"regexp.prototype.flags@npm:^1.5.3":
+"regexp.prototype.flags@npm:^1.5.1, regexp.prototype.flags@npm:^1.5.3":
version: 1.5.4
resolution: "regexp.prototype.flags@npm:1.5.4"
dependencies:
@@ -44905,7 +44996,7 @@ __metadata:
languageName: node
linkType: hard
-"side-channel@npm:^1.0.6, side-channel@npm:^1.1.0":
+"side-channel@npm:^1.0.4, side-channel@npm:^1.0.6, side-channel@npm:^1.1.0":
version: 1.1.0
resolution: "side-channel@npm:1.1.0"
dependencies:
@@ -49105,7 +49196,7 @@ __metadata:
languageName: node
linkType: hard
-"which-boxed-primitive@npm:^1.1.0, which-boxed-primitive@npm:^1.1.1":
+"which-boxed-primitive@npm:^1.0.2, which-boxed-primitive@npm:^1.1.0, which-boxed-primitive@npm:^1.1.1":
version: 1.1.1
resolution: "which-boxed-primitive@npm:1.1.1"
dependencies:
@@ -49139,7 +49230,7 @@ __metadata:
languageName: node
linkType: hard
-"which-collection@npm:^1.0.2":
+"which-collection@npm:^1.0.1, which-collection@npm:^1.0.2":
version: 1.0.2
resolution: "which-collection@npm:1.0.2"
dependencies:
@@ -49161,7 +49252,7 @@ __metadata:
languageName: node
linkType: hard
-"which-typed-array@npm:^1.1.16, which-typed-array@npm:^1.1.18, which-typed-array@npm:^1.1.2":
+"which-typed-array@npm:^1.1.13, which-typed-array@npm:^1.1.16, which-typed-array@npm:^1.1.18, which-typed-array@npm:^1.1.2":
version: 1.1.19
resolution: "which-typed-array@npm:1.1.19"
dependencies: