From 1ff3fe165cc284a3254d1eb3c8c926a375b2b0f7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 8 Sep 2020 00:13:15 +0200
Subject: [PATCH 001/110] feat(core): add single select component

---
 .../src/components/Select/Select.stories.tsx  |  42 ++++++
 .../core/src/components/Select/Select.tsx     | 137 ++++++++++++++++++
 packages/core/src/components/Select/index.tsx |  17 +++
 .../Select/static/ClosedDropdown.tsx          |  42 ++++++
 .../Select/static/OpenedDropdown.tsx          |  42 ++++++
 5 files changed, 280 insertions(+)
 create mode 100644 packages/core/src/components/Select/Select.stories.tsx
 create mode 100644 packages/core/src/components/Select/Select.tsx
 create mode 100644 packages/core/src/components/Select/index.tsx
 create mode 100644 packages/core/src/components/Select/static/ClosedDropdown.tsx
 create mode 100644 packages/core/src/components/Select/static/OpenedDropdown.tsx

diff --git a/packages/core/src/components/Select/Select.stories.tsx b/packages/core/src/components/Select/Select.stories.tsx
new file mode 100644
index 0000000000..5102947207
--- /dev/null
+++ b/packages/core/src/components/Select/Select.stories.tsx
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { Select } from '.';
+
+export default {
+  title: 'Select',
+  component: Select,
+};
+
+const SELECT_ITEMS = [
+  {
+    label: "test 1",
+    value: "test_1"
+  },
+  {
+    label: "test 2",
+    value: "test_2"
+  },
+  {
+    label: "test 3",
+    value: "test_3"
+  }
+]
+
+export const Default = () => (
+  <Select label="Default" items={SELECT_ITEMS} />
+);
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
new file mode 100644
index 0000000000..55b5f7aebd
--- /dev/null
+++ b/packages/core/src/components/Select/Select.tsx
@@ -0,0 +1,137 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React, { useState } from 'react';
+import {
+  createStyles,
+  makeStyles,
+  withStyles,
+  Theme,
+} from '@material-ui/core/styles';
+
+import {
+  FormControl,
+  InputLabel,
+  Select,
+  MenuItem,
+  InputBase,
+} from '@material-ui/core';
+
+import ClosedDropdown from './static/ClosedDropdown';
+import OpenedDropdown from './static/OpenedDropdown';
+
+const BootstrapInput = withStyles((theme: Theme) =>
+  createStyles({
+    root: {
+      'label + &': {
+        marginTop: theme.spacing(3),
+      },
+    },
+    input: {
+      borderRadius: 4,
+      position: 'relative',
+      backgroundColor: theme.palette.background.paper,
+      border: '1px solid #ced4da',
+      fontSize: 16,
+      padding: '10px 26px 10px 12px',
+      transition: theme.transitions.create(['border-color', 'box-shadow']),
+      fontFamily: 'Helvetica Neue',
+      '&:focus': {
+        background: theme.palette.background.paper,
+        borderRadius: 4,
+      },
+    },
+  }),
+)(InputBase);
+
+const useStyles = makeStyles((theme: Theme) =>
+  createStyles({
+    formControl: {
+      margin: theme.spacing(1),
+      minWidth: 315,
+    },
+    label: {
+      transform: 'initial',
+      fontWeight: 'bold',
+      fontSize: 14,
+      fontFamily: theme.typography.fontFamily,
+      color: theme.palette.text.primary,
+      '&.Mui-focused': {
+        color: theme.palette.text.primary,
+      },
+    },
+  }),
+);
+
+type Item = {
+  label: string;
+  value: string | number;
+};
+
+type Props = {
+  multiple?: boolean;
+  items: Item[];
+  label: string;
+};
+
+export const SelectComponent = (props: Props) => {
+  const { multiple, items, label } = props;
+  const classes = useStyles();
+  const [value, setValue] = useState('');
+  const [isOpen, setOpening] = useState(true);
+
+  const handleChange = (event: React.ChangeEvent<{ value: unknown }>) => {
+    setValue(event.target.value as string);
+  };
+
+  return (
+    <FormControl className={classes.formControl}>
+      <InputLabel className={classes.label} disableAnimation id="select-label">
+        {label}
+      </InputLabel>
+      <Select
+        id="select"
+        value={value}
+        multiple={multiple}
+        onChange={handleChange}
+        onOpen={() => setOpening(false)}
+        onClose={() => setOpening(true)}
+        input={<BootstrapInput />}
+        IconComponent={() => (
+            isOpen ? <ClosedDropdown /> : <OpenedDropdown />
+        )}
+        MenuProps={{
+          anchorOrigin: {
+            vertical: 'bottom',
+            horizontal: 'left',
+          },
+          transformOrigin: {
+            vertical: 'top',
+            horizontal: 'left',
+          },
+          getContentAnchorEl: null,
+        }}
+      >
+        {items &&
+          items.map(item => (
+            <MenuItem key={item.value} value={item.value}>
+              {item.label}
+            </MenuItem>
+          ))}
+      </Select>
+    </FormControl>
+  );
+};
diff --git a/packages/core/src/components/Select/index.tsx b/packages/core/src/components/Select/index.tsx
new file mode 100644
index 0000000000..977ebc88eb
--- /dev/null
+++ b/packages/core/src/components/Select/index.tsx
@@ -0,0 +1,17 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { SelectComponent as Select } from './Select';
diff --git a/packages/core/src/components/Select/static/ClosedDropdown.tsx b/packages/core/src/components/Select/static/ClosedDropdown.tsx
new file mode 100644
index 0000000000..25ef5aaca5
--- /dev/null
+++ b/packages/core/src/components/Select/static/ClosedDropdown.tsx
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { SvgIcon, makeStyles, createStyles } from '@material-ui/core';
+
+const useStyles = makeStyles(() =>
+  createStyles({
+    icon: {
+      position: 'absolute',
+      right: '4px',
+      pointerEvents: "none"
+    },
+  }),
+);
+
+const ClosedDropdown = () => {
+  const classes = useStyles();
+  return (
+    <SvgIcon
+      className={classes.icon}
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path d="M7.5 8L6 9.5L12.0703 15.5703L18.1406 9.5L16.6406 8L12.0703 12.5703L7.5 8Z" fill="#616161"/>
+    </SvgIcon>
+  );
+};
+
+export default ClosedDropdown;
diff --git a/packages/core/src/components/Select/static/OpenedDropdown.tsx b/packages/core/src/components/Select/static/OpenedDropdown.tsx
new file mode 100644
index 0000000000..b6205a6e44
--- /dev/null
+++ b/packages/core/src/components/Select/static/OpenedDropdown.tsx
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { SvgIcon, makeStyles, createStyles } from '@material-ui/core';
+
+const useStyles = makeStyles(() =>
+  createStyles({
+    icon: {
+      position: 'absolute',
+      right: '4px',
+      pointerEvents: 'none',
+    },
+  }),
+);
+
+const OpenedDropdown = () => {
+  const classes = useStyles();
+  return (
+    <SvgIcon
+    className={classes.icon}
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path d="M16.5 16L18 14.5L11.9297 8.42969L5.85938 14.5L7.35938 16L11.9297 11.4297L16.5 16Z" fill="#616161"/>
+    </SvgIcon>
+  );
+};
+
+export default OpenedDropdown;

From 5f2e659bea5647d6f0d8394cf7d768ba3f2d4a34 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 8 Sep 2020 00:14:08 +0200
Subject: [PATCH 002/110] fix(core): prettier on select component

---
 .../src/components/Select/Select.stories.tsx  | 20 +++++++++----------
 .../core/src/components/Select/Select.tsx     |  4 +---
 .../Select/static/ClosedDropdown.tsx          |  7 +++++--
 .../Select/static/OpenedDropdown.tsx          |  7 +++++--
 4 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/packages/core/src/components/Select/Select.stories.tsx b/packages/core/src/components/Select/Select.stories.tsx
index 5102947207..d26f689d34 100644
--- a/packages/core/src/components/Select/Select.stories.tsx
+++ b/packages/core/src/components/Select/Select.stories.tsx
@@ -24,19 +24,17 @@ export default {
 
 const SELECT_ITEMS = [
   {
-    label: "test 1",
-    value: "test_1"
+    label: 'test 1',
+    value: 'test_1',
   },
   {
-    label: "test 2",
-    value: "test_2"
+    label: 'test 2',
+    value: 'test_2',
   },
   {
-    label: "test 3",
-    value: "test_3"
-  }
-]
+    label: 'test 3',
+    value: 'test_3',
+  },
+];
 
-export const Default = () => (
-  <Select label="Default" items={SELECT_ITEMS} />
-);
+export const Default = () => <Select label="Default" items={SELECT_ITEMS} />;
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index 55b5f7aebd..be07ee6010 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -110,9 +110,7 @@ export const SelectComponent = (props: Props) => {
         onOpen={() => setOpening(false)}
         onClose={() => setOpening(true)}
         input={<BootstrapInput />}
-        IconComponent={() => (
-            isOpen ? <ClosedDropdown /> : <OpenedDropdown />
-        )}
+        IconComponent={() => (isOpen ? <ClosedDropdown /> : <OpenedDropdown />)}
         MenuProps={{
           anchorOrigin: {
             vertical: 'bottom',
diff --git a/packages/core/src/components/Select/static/ClosedDropdown.tsx b/packages/core/src/components/Select/static/ClosedDropdown.tsx
index 25ef5aaca5..235a91963b 100644
--- a/packages/core/src/components/Select/static/ClosedDropdown.tsx
+++ b/packages/core/src/components/Select/static/ClosedDropdown.tsx
@@ -21,7 +21,7 @@ const useStyles = makeStyles(() =>
     icon: {
       position: 'absolute',
       right: '4px',
-      pointerEvents: "none"
+      pointerEvents: 'none',
     },
   }),
 );
@@ -34,7 +34,10 @@ const ClosedDropdown = () => {
       fill="none"
       xmlns="http://www.w3.org/2000/svg"
     >
-      <path d="M7.5 8L6 9.5L12.0703 15.5703L18.1406 9.5L16.6406 8L12.0703 12.5703L7.5 8Z" fill="#616161"/>
+      <path
+        d="M7.5 8L6 9.5L12.0703 15.5703L18.1406 9.5L16.6406 8L12.0703 12.5703L7.5 8Z"
+        fill="#616161"
+      />
     </SvgIcon>
   );
 };
diff --git a/packages/core/src/components/Select/static/OpenedDropdown.tsx b/packages/core/src/components/Select/static/OpenedDropdown.tsx
index b6205a6e44..e4a8021017 100644
--- a/packages/core/src/components/Select/static/OpenedDropdown.tsx
+++ b/packages/core/src/components/Select/static/OpenedDropdown.tsx
@@ -30,11 +30,14 @@ const OpenedDropdown = () => {
   const classes = useStyles();
   return (
     <SvgIcon
-    className={classes.icon}
+      className={classes.icon}
       fill="none"
       xmlns="http://www.w3.org/2000/svg"
     >
-      <path d="M16.5 16L18 14.5L11.9297 8.42969L5.85938 14.5L7.35938 16L11.9297 11.4297L16.5 16Z" fill="#616161"/>
+      <path
+        d="M16.5 16L18 14.5L11.9297 8.42969L5.85938 14.5L7.35938 16L11.9297 11.4297L16.5 16Z"
+        fill="#616161"
+      />
     </SvgIcon>
   );
 };

From 834e5573b044e46571534311b4321ee63bf70f1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 8 Sep 2020 16:01:45 +0200
Subject: [PATCH 003/110] feat(core): add multiple select component

---
 .../src/components/Select/Select.stories.tsx  | 13 +++-
 .../core/src/components/Select/Select.tsx     | 70 +++++++++++++++++--
 2 files changed, 76 insertions(+), 7 deletions(-)

diff --git a/packages/core/src/components/Select/Select.stories.tsx b/packages/core/src/components/Select/Select.stories.tsx
index d26f689d34..38acb46c10 100644
--- a/packages/core/src/components/Select/Select.stories.tsx
+++ b/packages/core/src/components/Select/Select.stories.tsx
@@ -37,4 +37,15 @@ const SELECT_ITEMS = [
   },
 ];
 
-export const Default = () => <Select label="Default" items={SELECT_ITEMS} />;
+export const Default = () => (
+  <Select placeholder="All results" label="Default" items={SELECT_ITEMS} />
+);
+
+export const Multiple = () => (
+  <Select
+    placeholder="All results"
+    label="Multiple"
+    items={SELECT_ITEMS}
+    multiple
+  />
+);
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index be07ee6010..80422bb998 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -28,6 +28,9 @@ import {
   Select,
   MenuItem,
   InputBase,
+  Chip,
+  Typography,
+  Checkbox,
 } from '@material-ui/core';
 
 import ClosedDropdown from './static/ClosedDropdown';
@@ -73,6 +76,14 @@ const useStyles = makeStyles((theme: Theme) =>
         color: theme.palette.text.primary,
       },
     },
+    chips: {
+      display: 'flex',
+      flexWrap: 'wrap',
+    },
+    chip: {
+      margin: 2,
+    },
+    checkbox: {},
   }),
 );
 
@@ -85,18 +96,29 @@ type Props = {
   multiple?: boolean;
   items: Item[];
   label: string;
+  placeholder?: string;
 };
 
 export const SelectComponent = (props: Props) => {
-  const { multiple, items, label } = props;
+  const { multiple, items, label, placeholder } = props;
   const classes = useStyles();
-  const [value, setValue] = useState('');
-  const [isOpen, setOpening] = useState(true);
+  const [value, setValue] = useState<any[] | string | number>(
+    multiple ? [] : '',
+  );
+  const [canOpen, setCanOpen] = React.useState(false);
 
   const handleChange = (event: React.ChangeEvent<{ value: unknown }>) => {
     setValue(event.target.value as string);
   };
 
+  const selectHandleOnOpen = () => {
+    setCanOpen(!canOpen);
+  };
+
+  const handleDelete = (selectedValue: string | number) => () => {
+    setValue(chips => (chips as any[]).filter(chip => chip !== selectedValue));
+  };
+
   return (
     <FormControl className={classes.formControl}>
       <InputLabel className={classes.label} disableAnimation id="select-label">
@@ -105,12 +127,36 @@ export const SelectComponent = (props: Props) => {
       <Select
         id="select"
         value={value}
+        displayEmpty
         multiple={multiple}
         onChange={handleChange}
-        onOpen={() => setOpening(false)}
-        onClose={() => setOpening(true)}
+        onClick={selectHandleOnOpen}
+        open={canOpen}
         input={<BootstrapInput />}
-        IconComponent={() => (isOpen ? <ClosedDropdown /> : <OpenedDropdown />)}
+        renderValue={selected =>
+          multiple && (value as any[]).length !== 0 ? (
+            <div className={classes.chips}>
+              {(selected as string[]).map(selectedValue => (
+                <Chip
+                  key={items.find(el => el.value === selectedValue)?.label}
+                  label={items.find(el => el.value === selectedValue)?.label}
+                  clickable
+                  onDelete={handleDelete(selectedValue)}
+                  className={classes.chip}
+                />
+              ))}
+            </div>
+          ) : (
+            <Typography>
+              {(value as any[]).length === 0
+                ? placeholder || ''
+                : items.find(el => el.value === selected)?.label}
+            </Typography>
+          )
+        }
+        IconComponent={() =>
+          !canOpen ? <ClosedDropdown /> : <OpenedDropdown />
+        }
         MenuProps={{
           anchorOrigin: {
             vertical: 'bottom',
@@ -123,9 +169,21 @@ export const SelectComponent = (props: Props) => {
           getContentAnchorEl: null,
         }}
       >
+        {placeholder && (
+          <MenuItem value="" disabled>
+            {placeholder}
+          </MenuItem>
+        )}
         {items &&
           items.map(item => (
             <MenuItem key={item.value} value={item.value}>
+              {multiple && (
+                <Checkbox
+                  color="primary"
+                  checked={(value as any[]).includes(item.value) || false}
+                  className={classes.checkbox}
+                />
+              )}
               {item.label}
             </MenuItem>
           ))}

From 039c743d2c93b1f4cc8b9e3c1b8dd576ba73204f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Fri, 11 Sep 2020 23:54:19 +0200
Subject: [PATCH 004/110] feat(core): add CheckboxTree component

---
 .../CheckboxTree/CheckboxTree.stories.tsx     |  69 +++++
 .../components/CheckboxTree/CheckboxTree.tsx  | 252 ++++++++++++++++++
 .../src/components/CheckboxTree/index.tsx     |  17 ++
 3 files changed, 338 insertions(+)
 create mode 100644 packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
 create mode 100644 packages/core/src/components/CheckboxTree/CheckboxTree.tsx
 create mode 100644 packages/core/src/components/CheckboxTree/index.tsx

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
new file mode 100644
index 0000000000..04d4c41451
--- /dev/null
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
@@ -0,0 +1,69 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { CheckboxTree } from '.';
+
+const CHECKBOX_TREE_ITEMS = [
+  {
+    label: 'Genereic subcategory name 1',
+    options: [
+      {
+        label: 'Option 1',
+        value: 1,
+      },
+      {
+        label: 'Option 2',
+        value: 2,
+      },
+    ],
+  },
+  {
+    label: 'Genereic subcategory name 2',
+    options: [
+      {
+        label: 'Option 1',
+        value: 1,
+      },
+      {
+        label: 'Option 2',
+        value: 2,
+      },
+    ],
+  },
+  {
+    label: 'Genereic subcategory name 3',
+    options: [
+      {
+        label: 'Option 1',
+        value: 1,
+      },
+      {
+        label: 'Option 2',
+        value: 2,
+      },
+    ],
+  },
+];
+
+export default {
+  title: 'CheckboxTree',
+  component: CheckboxTree,
+};
+
+export const Default = () => (
+  <CheckboxTree subCategories={CHECKBOX_TREE_ITEMS} />
+);
diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
new file mode 100644
index 0000000000..386b02053a
--- /dev/null
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -0,0 +1,252 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React, { useReducer } from 'react';
+import { createStyles, makeStyles, Theme } from '@material-ui/core/styles';
+import {
+  List,
+  ListItem,
+  ListItemIcon,
+  Checkbox,
+  ListItemText,
+  Collapse,
+} from '@material-ui/core';
+import ExpandLess from '@material-ui/icons/ExpandLess';
+import ExpandMore from '@material-ui/icons/ExpandMore';
+
+type IndexedObject<T> = {
+  [key: string]: T;
+};
+
+const useStyles = makeStyles((theme: Theme) =>
+  createStyles({
+    root: {
+      width: '100%',
+      maxWidth: 360,
+      backgroundColor: theme.palette.background.paper,
+    },
+    nested: {
+      paddingLeft: theme.spacing(4),
+    },
+  }),
+);
+
+/* SUB_CATEGORY */
+
+type SubCategory = {
+  label: string;
+  isChecked?: boolean;
+  isOpen?: boolean;
+  options?: Option[];
+};
+
+type SubCategoryWithIndexedOptions = {
+  label: string;
+  isChecked?: boolean;
+  isOpen?: boolean;
+  options: IndexedObject<Option>;
+};
+
+/* OPTION */
+
+type Option = {
+  label: string;
+  value: string | number;
+  isChecked?: boolean;
+};
+
+type Props = {
+  subCategories: SubCategory[];
+};
+
+/* REDUCER */
+
+type checkOptionPayload = {
+  subCategoryLabel: string;
+  optionLabel: string;
+};
+
+type Action =
+  | { type: 'checkOption'; payload: checkOptionPayload }
+  | { type: 'checkCategory'; payload: string }
+  | { type: 'openCategory'; payload: string };
+
+const checkAllOptions = (
+  arr: Option[],
+  isChecked: boolean,
+): IndexedObject<Option> =>
+  arr.reduce((accumulator, el) => {
+    return {
+      ...accumulator,
+      [el.label]: { ...el, isChecked },
+    };
+  }, {});
+
+const reducer = (
+  state: IndexedObject<SubCategoryWithIndexedOptions>,
+  action: Action,
+) => {
+  switch (action.type) {
+    case 'checkOption': {
+      const newOptions = {
+        ...state[action.payload.subCategoryLabel].options,
+        [action.payload.optionLabel]: {
+          ...state[action.payload.subCategoryLabel].options[
+            action.payload.optionLabel
+          ],
+          isChecked: !state[action.payload.subCategoryLabel].options[
+            action.payload.optionLabel
+          ].isChecked,
+        },
+      };
+
+      return {
+        ...state,
+        [action.payload.subCategoryLabel]: {
+          ...state[action.payload.subCategoryLabel],
+          isChecked: Object.values(newOptions).every(
+            option => option.isChecked,
+          ),
+          options: newOptions,
+        },
+      };
+    }
+    case 'checkCategory':
+      return {
+        ...state,
+        [action.payload]: {
+          ...state[action.payload],
+          isChecked: !state[action.payload].isChecked,
+          options: checkAllOptions(
+            Object.values(state[action.payload].options),
+            !state[action.payload].isChecked,
+          ),
+        },
+      };
+    case 'openCategory':
+      return {
+        ...state,
+        [action.payload]: {
+          ...state[action.payload],
+          isOpen: !state[action.payload].isOpen,
+        },
+      };
+    default:
+      return state;
+  }
+};
+
+const indexer = (
+  arr: SubCategory[],
+): IndexedObject<SubCategoryWithIndexedOptions> =>
+  arr.reduce((accumulator, el) => {
+    if (el.options) {
+      return {
+        ...accumulator,
+        [el.label]: {
+          label: el.label,
+          isChecked: el.isChecked || false,
+          isOpen: true,
+          options: indexer(el.options),
+        },
+      };
+    }
+    return {
+      ...accumulator,
+      [el.label]: { ...el, isChecked: el.isChecked || false },
+    };
+  }, {});
+
+export const CheckboxTree = (props: Props) => {
+  const classes = useStyles();
+
+  const [state, dispatch] = useReducer(reducer, indexer(props.subCategories));
+
+  const handleOpen = (event: any, value: any) => {
+    event.stopPropagation();
+    dispatch({ type: 'openCategory', payload: value });
+  };
+  return (
+    <List className={classes.root}>
+      {Object.values(state).map(item => {
+        const labelId = `checkbox-list-label-${item?.label}`;
+
+        return (
+          <div key={item.label}>
+            <ListItem
+              dense
+              button
+              onClick={() =>
+                dispatch({
+                  type: 'checkCategory',
+                  payload: item.label,
+                })
+              }
+            >
+              <ListItemIcon>
+                <Checkbox
+                  color="primary"
+                  edge="start"
+                  checked={item.isChecked}
+                  tabIndex={-1}
+                  disableRipple
+                  inputProps={{ 'aria-labelledby': labelId }}
+                />
+              </ListItemIcon>
+              <ListItemText id={labelId} primary={item.label} />
+              {item.options?.length ? (
+                <ExpandLess onClick={event => handleOpen(event, item.label)} />
+              ) : (
+                <ExpandMore onClick={event => handleOpen(event, item.label)} />
+              )}
+            </ListItem>
+            <Collapse in={item.isOpen} timeout="auto" unmountOnExit>
+              <List component="div" disablePadding>
+                {Object.values(item.options).map(option => (
+                  <ListItem
+                    button
+                    key={option.label}
+                    className={classes.nested}
+                    onClick={() =>
+                      dispatch({
+                        type: 'checkOption',
+                        payload: {
+                          subCategoryLabel: item.label,
+                          optionLabel: option.label,
+                        },
+                      })
+                    }
+                  >
+                    <ListItemIcon>
+                      <Checkbox
+                        color="primary"
+                        edge="start"
+                        checked={option.isChecked}
+                        tabIndex={-1}
+                        disableRipple
+                        inputProps={{ 'aria-labelledby': labelId }}
+                      />
+                    </ListItemIcon>
+                    <ListItemText primary={option.label} />
+                  </ListItem>
+                ))}
+              </List>
+            </Collapse>
+          </div>
+        );
+      })}
+    </List>
+  );
+};
diff --git a/packages/core/src/components/CheckboxTree/index.tsx b/packages/core/src/components/CheckboxTree/index.tsx
new file mode 100644
index 0000000000..d8e62460ab
--- /dev/null
+++ b/packages/core/src/components/CheckboxTree/index.tsx
@@ -0,0 +1,17 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { CheckboxTree } from './CheckboxTree';

From 2d7dd797ecf992e09db3e084e308dc88ca55e90e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Sat, 12 Sep 2020 15:14:15 +0200
Subject: [PATCH 005/110] feat(core): add table filters tab toggle logic

---
 .../src/components/Table/Table.stories.tsx    | 35 +++++++++++
 packages/core/src/components/Table/Table.tsx  | 58 +++++++++++++++++--
 2 files changed, 87 insertions(+), 6 deletions(-)

diff --git a/packages/core/src/components/Table/Table.stories.tsx b/packages/core/src/components/Table/Table.stories.tsx
index 11fa0c44dc..2a176e50a8 100644
--- a/packages/core/src/components/Table/Table.stories.tsx
+++ b/packages/core/src/components/Table/Table.stories.tsx
@@ -220,3 +220,38 @@ export const DenseTable = () => {
     </div>
   );
 };
+
+export const FilterTable = () => {
+  const columns: TableColumn[] = [
+    {
+      title: 'Column 1',
+      field: 'col1',
+      highlight: true,
+    },
+    {
+      title: 'Column 2',
+      field: 'col2',
+    },
+    {
+      title: 'Numeric value',
+      field: 'number',
+      type: 'numeric',
+    },
+    {
+      title: 'A Date',
+      field: 'date',
+      type: 'date',
+    },
+  ];
+
+  return (
+    <div style={containerStyle}>
+      <Table
+        options={{ paging: false, padding: 'dense' }}
+        data={testData10}
+        columns={columns}
+        filters={["test"]}
+      />
+    </div>
+  );
+};
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index 882272cb43..08b1994246 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -1,3 +1,4 @@
+import classes from '*.css';
 /*
  * Copyright 2020 Spotify AB
  *
@@ -15,7 +16,12 @@
  */
 
 import { BackstageTheme } from '@backstage/theme';
-import { makeStyles, Typography, useTheme } from '@material-ui/core';
+import {
+  makeStyles,
+  Typography,
+  useTheme,
+  IconButton,
+} from '@material-ui/core';
 // Material-table is not using the standard icons available in in material-ui. https://github.com/mbrn/material-table/issues/51
 import AddBox from '@material-ui/icons/AddBox';
 import ArrowUpward from '@material-ui/icons/ArrowUpward';
@@ -39,7 +45,7 @@ import MTable, {
   MTableToolbar,
   Options,
 } from 'material-table';
-import React, { forwardRef } from 'react';
+import React, { forwardRef, useState } from 'react';
 
 const tableIcons = {
   Add: forwardRef((props, ref: React.Ref<SVGSVGElement>) => (
@@ -107,7 +113,7 @@ const useHeaderStyles = makeStyles<BackstageTheme>(theme => ({
   },
 }));
 
-const useToolbarStyles = makeStyles<BackstageTheme>(theme => ({
+const useToolbarStyles = makeStyles<BackstageTheme>((theme) => ({
   root: {
     padding: theme.spacing(3, 0, 2.5, 2.5),
   },
@@ -121,6 +127,25 @@ const useToolbarStyles = makeStyles<BackstageTheme>(theme => ({
   },
 }));
 
+const useFilterStyles = makeStyles<BackstageTheme>(() => ({
+  root: {
+    display: 'flex',
+    alignItems: 'center',
+    justifyContent: 'space-between',
+  },
+}));
+
+const useTableStyles = makeStyles<BackstageTheme>(() => ({
+  root: {
+    display: 'flex',
+    alignItems: 'center',
+  },
+  filters: {
+    height: '100%',
+    width: '250px',
+  }
+}));
+
 function convertColumns<T extends object>(
   columns: TableColumn<T>[],
   theme: BackstageTheme,
@@ -152,6 +177,7 @@ export interface TableProps<T extends object = {}>
   extends MaterialTableProps<T> {
   columns: TableColumn<T>[];
   subtitle?: string;
+  filters?: any[];
 }
 
 export function Table<T extends object = {}>({
@@ -159,12 +185,18 @@ export function Table<T extends object = {}>({
   options,
   title,
   subtitle,
+  filters,
   ...props
 }: TableProps<T>) {
   const headerClasses = useHeaderStyles();
   const toolbarClasses = useToolbarStyles();
+  const tableClasses = useTableStyles();
+  const filtersClasses = useFilterStyles();
+
   const theme = useTheme<BackstageTheme>();
 
+  const [filtersOpen, toggleFilters] = useState(false);
+
   const MTColumns = convertColumns(columns, theme);
 
   const defaultOptions: Options<T> = {
@@ -174,14 +206,27 @@ export function Table<T extends object = {}>({
   };
 
   return (
+    <div className={tableClasses.root}>
+      {filtersOpen && <div className={tableClasses.filters}>Filters</div>}
     <MTable<T>
       components={{
         Header: headerProps => (
           <MTableHeader classes={headerClasses} {...headerProps} />
         ),
-        Toolbar: toolbarProps => (
-          <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
-        ),
+        Toolbar: toolbarProps =>
+          filters?.length ? (
+            <div className={filtersClasses.root}>
+              <div className={filtersClasses.root}>
+                <IconButton onClick={() => toggleFilters(el => !el)} aria-label="filter list">
+                  <FilterList />
+                </IconButton>
+                <Typography variant="h6">Filters</Typography>
+              </div>
+              <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
+            </div>
+          ) : (
+            <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
+          ),
       }}
       options={{ ...defaultOptions, ...options }}
       columns={MTColumns}
@@ -198,5 +243,6 @@ export function Table<T extends object = {}>({
       }
       {...props}
     />
+    </div>
   );
 }

From 10304d03036d5bd89d2a220b013f4e9e045225a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Sun, 13 Sep 2020 23:48:48 +0200
Subject: [PATCH 006/110] style(core): update CheckBoxTree styles

---
 .../CheckboxTree/CheckboxTree.stories.tsx     |  2 +-
 .../components/CheckboxTree/CheckboxTree.tsx  | 21 +++++++++++++++----
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
index 04d4c41451..58abb4af0f 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
@@ -65,5 +65,5 @@ export default {
 };
 
 export const Default = () => (
-  <CheckboxTree subCategories={CHECKBOX_TREE_ITEMS} />
+  <CheckboxTree label="default" subCategories={CHECKBOX_TREE_ITEMS} />
 );
diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index 386b02053a..dc962ea0b5 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -22,6 +22,7 @@ import {
   Checkbox,
   ListItemText,
   Collapse,
+  Typography
 } from '@material-ui/core';
 import ExpandLess from '@material-ui/icons/ExpandLess';
 import ExpandMore from '@material-ui/icons/ExpandMore';
@@ -34,12 +35,20 @@ const useStyles = makeStyles((theme: Theme) =>
   createStyles({
     root: {
       width: '100%',
+      minWidth: 10,
       maxWidth: 360,
-      backgroundColor: theme.palette.background.paper,
+      backgroundColor: 'transparent',
+      "&:hover": {
+        backgroundColor: "transparent"
+    }
     },
     nested: {
-      paddingLeft: theme.spacing(4),
+      paddingLeft: theme.spacing(5),
+      height: '32px'
     },
+    listItemIcon: {
+      minWidth: 10
+    }
   }),
 );
 
@@ -69,6 +78,7 @@ type Option = {
 
 type Props = {
   subCategories: SubCategory[];
+  label: string;
 };
 
 /* REDUCER */
@@ -179,6 +189,8 @@ export const CheckboxTree = (props: Props) => {
     dispatch({ type: 'openCategory', payload: value });
   };
   return (
+    <div>
+    <Typography variant="button">{props.label}</Typography>
     <List className={classes.root}>
       {Object.values(state).map(item => {
         const labelId = `checkbox-list-label-${item?.label}`;
@@ -195,7 +207,7 @@ export const CheckboxTree = (props: Props) => {
                 })
               }
             >
-              <ListItemIcon>
+              <ListItemIcon className={classes.listItemIcon}>
                 <Checkbox
                   color="primary"
                   edge="start"
@@ -229,7 +241,7 @@ export const CheckboxTree = (props: Props) => {
                       })
                     }
                   >
-                    <ListItemIcon>
+                    <ListItemIcon className={classes.listItemIcon}>
                       <Checkbox
                         color="primary"
                         edge="start"
@@ -248,5 +260,6 @@ export const CheckboxTree = (props: Props) => {
         );
       })}
     </List>
+    </div>
   );
 };

From b565c93537de032010dea39533e77e88884d3a5f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Mon, 14 Sep 2020 23:26:32 +0200
Subject: [PATCH 007/110] feat(core): update Table filter logic

---
 .../core/src/components/Table/Filters.tsx     | 131 ++++++++++++++++
 .../src/components/Table/Table.stories.tsx    |  18 ++-
 packages/core/src/components/Table/Table.tsx  | 140 ++++++++++++------
 3 files changed, 245 insertions(+), 44 deletions(-)
 create mode 100644 packages/core/src/components/Table/Filters.tsx

diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
new file mode 100644
index 0000000000..db8a3a9af2
--- /dev/null
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -0,0 +1,131 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React, { useEffect, useState } from 'react';
+import { BackstageTheme } from '@backstage/theme';
+import { Button, makeStyles } from '@material-ui/core';
+import { Select } from '../Select';
+import { CheckboxTree } from '../CheckboxTree';
+import { CheckboxTreeProps } from '../CheckboxTree/CheckboxTree';
+import { SelectProps } from '../Select/Select';
+
+const useSubvalueCellStyles = makeStyles<BackstageTheme>(theme => ({
+  root: {
+    height: '100%',
+    width: '315px',
+    display: 'flex',
+    flexDirection: 'column',
+    marginRight: theme.spacing(3),
+  },
+  value: {},
+  header: {
+    display: 'flex',
+    alignItems: 'center',
+    height: '60px',
+    justifyContent: 'space-between',
+    borderBottom: `1px solid ${theme.palette.grey[500]}`,
+  },
+  filters: {
+    display: 'flex',
+    flexDirection: 'column',
+    '& > *': {
+      marginTop: theme.spacing(2),
+    },
+  },
+  clear: {
+    textTransform: 'none',
+  },
+}));
+
+type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
+
+export type Filter = {
+  type: 'select' | 'checkbox-tree' | 'multiple-select';
+  element:
+    | Without<CheckboxTreeProps, 'onChange'>
+    | Without<SelectProps, 'onChange'>;
+};
+
+type Props = {
+  filters: Filter[];
+  onChangeFilters: (arg: any) => any;
+};
+
+export const Filters = (props: Props) => {
+  const classes = useSubvalueCellStyles();
+
+  const { onChangeFilters } = props;
+
+  const [filters, setFilters] = useState(props.filters);
+  const [selectedFilters, setSelectedFilters] = useState({});
+
+  // Trigger re-rendering
+  const handleClick = () => {
+    setSelectedFilters({});
+    setFilters([
+      ...props.filters.map(el => ({
+        type: el.type,
+        element: { ...el.element },
+      })),
+    ]);
+  };
+
+  useEffect(() => {
+    onChangeFilters(selectedFilters);
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [selectedFilters]);
+
+  // As material table doesn't provide a way to add a column filter tab we will make our own filter logic
+  return (
+    <div className={classes.root}>
+      <div className={classes.header}>
+        <div className={classes.value}>Filters</div>
+        <Button className={classes.clear} color="primary" onClick={handleClick}>
+          Clear all
+        </Button>
+      </div>
+      <div className={classes.filters}>
+        {filters?.length &&
+          filters.map(filter =>
+            filter.type === 'checkbox-tree' ? (
+              <CheckboxTree
+                key={filter.element.label}
+                {...(filter.element as CheckboxTreeProps)}
+                onChange={
+                  el => ({})
+                  // setSelectedFilters({
+                  //   ...selectedFilters,
+                  //   [filter.element.label]: el,
+                  // })
+                }
+              />
+            ) : (
+              <Select
+                key={filter.element.label}
+                {...(filter.element as SelectProps)}
+                onChange={el =>
+                  setSelectedFilters({
+                    ...selectedFilters,
+                    [filter.element.label]: el,
+                  })
+                }
+              />
+            ),
+          )}
+      </div>
+    </div>
+  );
+};
diff --git a/packages/core/src/components/Table/Table.stories.tsx b/packages/core/src/components/Table/Table.stories.tsx
index 2a176e50a8..1ec896fd43 100644
--- a/packages/core/src/components/Table/Table.stories.tsx
+++ b/packages/core/src/components/Table/Table.stories.tsx
@@ -16,6 +16,7 @@
 
 import React from 'react';
 import { Table, SubvalueCell, TableColumn } from './';
+import { TableFilter } from './Table';
 
 export default {
   title: 'Table',
@@ -244,13 +245,28 @@ export const FilterTable = () => {
     },
   ];
 
+  const filters: TableFilter[] = [
+    {
+      column: 'Column 1',
+      type: 'select',
+    },
+    {
+      column: 'Column 2',
+      type: 'multiple-select',
+    },
+    {
+      column: 'Numeric value',
+      type: 'checkbox-tree',
+    },
+  ];
+
   return (
     <div style={containerStyle}>
       <Table
         options={{ paging: false, padding: 'dense' }}
         data={testData10}
         columns={columns}
-        filters={["test"]}
+        filters={filters}
       />
     </div>
   );
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index 08b1994246..212e80fcd2 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -45,7 +45,8 @@ import MTable, {
   MTableToolbar,
   Options,
 } from 'material-table';
-import React, { forwardRef, useState } from 'react';
+import React, { forwardRef, useEffect, useState } from 'react';
+import { Filters } from './Filters';
 
 const tableIcons = {
   Add: forwardRef((props, ref: React.Ref<SVGSVGElement>) => (
@@ -113,7 +114,7 @@ const useHeaderStyles = makeStyles<BackstageTheme>(theme => ({
   },
 }));
 
-const useToolbarStyles = makeStyles<BackstageTheme>((theme) => ({
+const useToolbarStyles = makeStyles<BackstageTheme>(theme => ({
   root: {
     padding: theme.spacing(3, 0, 2.5, 2.5),
   },
@@ -138,12 +139,7 @@ const useFilterStyles = makeStyles<BackstageTheme>(() => ({
 const useTableStyles = makeStyles<BackstageTheme>(() => ({
   root: {
     display: 'flex',
-    alignItems: 'center',
   },
-  filters: {
-    height: '100%',
-    width: '250px',
-  }
 }));
 
 function convertColumns<T extends object>(
@@ -173,11 +169,16 @@ export interface TableColumn<T extends object = {}> extends Column<T> {
   width?: string;
 }
 
+export type TableFilter = {
+  column: string;
+  type: 'select' | 'multiple-select' | 'checkbox-tree';
+};
+
 export interface TableProps<T extends object = {}>
   extends MaterialTableProps<T> {
   columns: TableColumn<T>[];
   subtitle?: string;
-  filters?: any[];
+  filters?: TableFilter[];
 }
 
 export function Table<T extends object = {}>({
@@ -193,9 +194,12 @@ export function Table<T extends object = {}>({
   const tableClasses = useTableStyles();
   const filtersClasses = useFilterStyles();
 
+  const { data, ...propsWithoutData } = props;
+
   const theme = useTheme<BackstageTheme>();
 
   const [filtersOpen, toggleFilters] = useState(false);
+  const [tableData, setTableData] = useState(data as any[]);
 
   const MTColumns = convertColumns(columns, theme);
 
@@ -205,44 +209,94 @@ export function Table<T extends object = {}>({
     },
   };
 
+  const getFieldByTitle = (titleValue: string | keyof T) =>
+    columns.find(el => el.title === titleValue)?.field;
+
+  const onChangeFilters = (selectedFilters: any) => {
+    if (Object.values(selectedFilters).length) {
+      const newData = (props.data as any[]).filter(
+        el =>
+          !!Object.entries(selectedFilters).find(
+            ([key, value]) => el[getFieldByTitle(key)] === value,
+          ),
+      );
+      setTableData(newData);
+    }
+  };
+
+  const constructFilters = (filterConfig: TableFilter[], dataValue: any[]) => {
+    const extractColumnData = (column: string | keyof T) =>
+      dataValue.map(el => ({ label: el[column], options: [] }));
+
+    return filterConfig.map(filter => ({
+      type: filter.type,
+      element:
+        filter.type === 'checkbox-tree'
+          ? {
+              label: filter.column,
+              subCategories: extractColumnData(
+                getFieldByTitle(filter.column) || '',
+              ),
+            }
+          : {
+              placeholder: 'All results',
+              label: filter.column,
+              multiple: filter.type === 'multiple-select',
+              items: dataValue.map(el => ({
+                label: el[getFieldByTitle(filter.column) || ''],
+                value: el[getFieldByTitle(filter.column) || ''],
+              })),
+            },
+    }));
+  };
+
   return (
     <div className={tableClasses.root}>
-      {filtersOpen && <div className={tableClasses.filters}>Filters</div>}
-    <MTable<T>
-      components={{
-        Header: headerProps => (
-          <MTableHeader classes={headerClasses} {...headerProps} />
-        ),
-        Toolbar: toolbarProps =>
-          filters?.length ? (
-            <div className={filtersClasses.root}>
-              <div className={filtersClasses.root}>
-                <IconButton onClick={() => toggleFilters(el => !el)} aria-label="filter list">
-                  <FilterList />
-                </IconButton>
-                <Typography variant="h6">Filters</Typography>
-              </div>
-              <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
-            </div>
-          ) : (
-            <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
+      {filtersOpen && filters?.length && (
+        <Filters
+          filters={constructFilters(filters, props.data as any[])}
+          onChangeFilters={onChangeFilters}
+        />
+      )}
+      <MTable<T>
+        components={{
+          Header: headerProps => (
+            <MTableHeader classes={headerClasses} {...headerProps} />
           ),
-      }}
-      options={{ ...defaultOptions, ...options }}
-      columns={MTColumns}
-      icons={tableIcons}
-      title={
-        <>
-          <Typography variant="h5">{title}</Typography>
-          {subtitle && (
-            <Typography color="textSecondary" variant="body1">
-              {subtitle}
-            </Typography>
-          )}
-        </>
-      }
-      {...props}
-    />
+          Toolbar: toolbarProps =>
+            filters?.length ? (
+              <div className={filtersClasses.root}>
+                <div className={filtersClasses.root}>
+                  <IconButton
+                    onClick={() => toggleFilters(el => !el)}
+                    aria-label="filter list"
+                  >
+                    <FilterList />
+                  </IconButton>
+                  <Typography variant="h6">Filters</Typography>
+                </div>
+                <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
+              </div>
+            ) : (
+              <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
+            ),
+        }}
+        options={{ ...defaultOptions, ...options }}
+        columns={MTColumns}
+        icons={tableIcons}
+        title={
+          <>
+            <Typography variant="h5">{title}</Typography>
+            {subtitle && (
+              <Typography color="textSecondary" variant="body1">
+                {subtitle}
+              </Typography>
+            )}
+          </>
+        }
+        data={tableData}
+        {...propsWithoutData}
+      />
     </div>
   );
 }

From a87d622a24a6b368cad41e96095ee5d67fb0bb62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Mon, 14 Sep 2020 23:27:22 +0200
Subject: [PATCH 008/110] feat(core): select + checkboxtree style - handle
 changes

---
 .../CheckboxTree/CheckboxTree.stories.tsx     |   6 +-
 .../components/CheckboxTree/CheckboxTree.tsx  | 181 ++++++++++--------
 .../src/components/Select/Select.stories.tsx  |   8 +-
 .../core/src/components/Select/Select.tsx     | 154 ++++++++-------
 4 files changed, 194 insertions(+), 155 deletions(-)

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
index 58abb4af0f..0da4c1b7b7 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
@@ -65,5 +65,9 @@ export default {
 };
 
 export const Default = () => (
-  <CheckboxTree label="default" subCategories={CHECKBOX_TREE_ITEMS} />
+  <CheckboxTree
+    onChange={el => {}}
+    label="default"
+    subCategories={CHECKBOX_TREE_ITEMS}
+  />
 );
diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index dc962ea0b5..f1dae684c7 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import React, { useReducer } from 'react';
+import React, { useEffect, useReducer } from 'react';
 import { createStyles, makeStyles, Theme } from '@material-ui/core/styles';
 import {
   List,
@@ -22,7 +22,7 @@ import {
   Checkbox,
   ListItemText,
   Collapse,
-  Typography
+  Typography,
 } from '@material-ui/core';
 import ExpandLess from '@material-ui/icons/ExpandLess';
 import ExpandMore from '@material-ui/icons/ExpandMore';
@@ -38,17 +38,17 @@ const useStyles = makeStyles((theme: Theme) =>
       minWidth: 10,
       maxWidth: 360,
       backgroundColor: 'transparent',
-      "&:hover": {
-        backgroundColor: "transparent"
-    }
+      '&:hover': {
+        backgroundColor: 'transparent',
+      },
     },
     nested: {
       paddingLeft: theme.spacing(5),
-      height: '32px'
+      height: '32px',
     },
     listItemIcon: {
-      minWidth: 10
-    }
+      minWidth: 10,
+    },
   }),
 );
 
@@ -76,9 +76,10 @@ type Option = {
   isChecked?: boolean;
 };
 
-type Props = {
+export type CheckboxTreeProps = {
   subCategories: SubCategory[];
   label: string;
+  onChange: (arg: any) => any;
 };
 
 /* REDUCER */
@@ -168,7 +169,7 @@ const indexer = (
         [el.label]: {
           label: el.label,
           isChecked: el.isChecked || false,
-          isOpen: true,
+          isOpen: false,
           options: indexer(el.options),
         },
       };
@@ -179,7 +180,8 @@ const indexer = (
     };
   }, {});
 
-export const CheckboxTree = (props: Props) => {
+export const CheckboxTree = (props: CheckboxTreeProps) => {
+  const { onChange } = props;
   const classes = useStyles();
 
   const [state, dispatch] = useReducer(reducer, indexer(props.subCategories));
@@ -188,78 +190,99 @@ export const CheckboxTree = (props: Props) => {
     event.stopPropagation();
     dispatch({ type: 'openCategory', payload: value });
   };
+
+  const handleChange = () => {
+    const values = Object.values(state).map(category => ({
+      category: category.label,
+      selected: Object.values(category.options)
+        .filter(option => option.isChecked)
+        .map(option => option.value),
+    }));
+    onChange(values);
+  };
+
   return (
     <div>
-    <Typography variant="button">{props.label}</Typography>
-    <List className={classes.root}>
-      {Object.values(state).map(item => {
-        const labelId = `checkbox-list-label-${item?.label}`;
+      <Typography variant="button">{props.label}</Typography>
+      <List className={classes.root}>
+        {Object.values(state).map(item => {
+          const labelId = `checkbox-list-label-${item?.label}`;
 
-        return (
-          <div key={item.label}>
-            <ListItem
-              dense
-              button
-              onClick={() =>
-                dispatch({
-                  type: 'checkCategory',
-                  payload: item.label,
-                })
-              }
-            >
-              <ListItemIcon className={classes.listItemIcon}>
-                <Checkbox
-                  color="primary"
-                  edge="start"
-                  checked={item.isChecked}
-                  tabIndex={-1}
-                  disableRipple
-                  inputProps={{ 'aria-labelledby': labelId }}
-                />
-              </ListItemIcon>
-              <ListItemText id={labelId} primary={item.label} />
-              {item.options?.length ? (
-                <ExpandLess onClick={event => handleOpen(event, item.label)} />
-              ) : (
-                <ExpandMore onClick={event => handleOpen(event, item.label)} />
-              )}
-            </ListItem>
-            <Collapse in={item.isOpen} timeout="auto" unmountOnExit>
-              <List component="div" disablePadding>
-                {Object.values(item.options).map(option => (
-                  <ListItem
-                    button
-                    key={option.label}
-                    className={classes.nested}
-                    onClick={() =>
-                      dispatch({
-                        type: 'checkOption',
-                        payload: {
-                          subCategoryLabel: item.label,
-                          optionLabel: option.label,
-                        },
-                      })
-                    }
-                  >
-                    <ListItemIcon className={classes.listItemIcon}>
-                      <Checkbox
-                        color="primary"
-                        edge="start"
-                        checked={option.isChecked}
-                        tabIndex={-1}
-                        disableRipple
-                        inputProps={{ 'aria-labelledby': labelId }}
+          return (
+            <div key={item.label}>
+              <ListItem
+                dense
+                button
+                onClick={async () => {
+                  await dispatch({
+                    type: 'checkCategory',
+                    payload: item.label,
+                  });
+                  handleChange();
+                }}
+              >
+                <ListItemIcon className={classes.listItemIcon}>
+                  <Checkbox
+                    color="primary"
+                    edge="start"
+                    checked={item.isChecked}
+                    tabIndex={-1}
+                    disableRipple
+                    inputProps={{ 'aria-labelledby': labelId }}
+                  />
+                </ListItemIcon>
+                <ListItemText id={labelId} primary={item.label} />
+                {Object.values(item.options).length ? (
+                  <>
+                    {item.isOpen ? (
+                      <ExpandLess
+                        onClick={event => handleOpen(event, item.label)}
                       />
-                    </ListItemIcon>
-                    <ListItemText primary={option.label} />
-                  </ListItem>
-                ))}
-              </List>
-            </Collapse>
-          </div>
-        );
-      })}
-    </List>
+                    ) : (
+                      <ExpandMore
+                        onClick={event => handleOpen(event, item.label)}
+                      />
+                    )}
+                  </>
+                ) : null}
+              </ListItem>
+              <Collapse in={item.isOpen} timeout="auto" unmountOnExit>
+                <List component="div" disablePadding>
+                  {Object.values(item.options).map(option => (
+                    <ListItem
+                      button
+                      key={option.label}
+                      className={classes.nested}
+                      onClick={async () => {
+                        await dispatch({
+                          type: 'checkOption',
+                          payload: {
+                            subCategoryLabel: item.label,
+                            optionLabel: option.label,
+                          },
+                        });
+                        handleChange();
+                      }}
+                    >
+                      <ListItemIcon className={classes.listItemIcon}>
+                        <Checkbox
+                          color="primary"
+                          edge="start"
+                          checked={option.isChecked}
+                          tabIndex={-1}
+                          disableRipple
+                          inputProps={{ 'aria-labelledby': labelId }}
+                        />
+                      </ListItemIcon>
+                      <ListItemText primary={option.label} />
+                    </ListItem>
+                  ))}
+                </List>
+              </Collapse>
+            </div>
+          );
+        })}
+      </List>
     </div>
   );
 };
diff --git a/packages/core/src/components/Select/Select.stories.tsx b/packages/core/src/components/Select/Select.stories.tsx
index 38acb46c10..acb6f8afc8 100644
--- a/packages/core/src/components/Select/Select.stories.tsx
+++ b/packages/core/src/components/Select/Select.stories.tsx
@@ -38,7 +38,12 @@ const SELECT_ITEMS = [
 ];
 
 export const Default = () => (
-  <Select placeholder="All results" label="Default" items={SELECT_ITEMS} />
+  <Select
+    onChange={el => {}}
+    placeholder="All results"
+    label="Default"
+    items={SELECT_ITEMS}
+  />
 );
 
 export const Multiple = () => (
@@ -47,5 +52,6 @@ export const Multiple = () => (
     label="Multiple"
     items={SELECT_ITEMS}
     multiple
+    onChange={el => {}}
   />
 );
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index 80422bb998..b518b37d6c 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -63,8 +63,8 @@ const BootstrapInput = withStyles((theme: Theme) =>
 const useStyles = makeStyles((theme: Theme) =>
   createStyles({
     formControl: {
-      margin: theme.spacing(1),
-      minWidth: 315,
+      margin: `${theme.spacing(1)} 0px`,
+      maxWidth: 300,
     },
     label: {
       transform: 'initial',
@@ -84,6 +84,10 @@ const useStyles = makeStyles((theme: Theme) =>
       margin: 2,
     },
     checkbox: {},
+    root: {
+      display: 'flex',
+      flexDirection: 'column',
+    },
   }),
 );
 
@@ -92,15 +96,16 @@ type Item = {
   value: string | number;
 };
 
-type Props = {
+export type SelectProps = {
   multiple?: boolean;
   items: Item[];
   label: string;
   placeholder?: string;
+  onChange: (arg: any) => any;
 };
 
-export const SelectComponent = (props: Props) => {
-  const { multiple, items, label, placeholder } = props;
+export const SelectComponent = (props: SelectProps) => {
+  const { multiple, items, label, placeholder, onChange } = props;
   const classes = useStyles();
   const [value, setValue] = useState<any[] | string | number>(
     multiple ? [] : '',
@@ -108,7 +113,8 @@ export const SelectComponent = (props: Props) => {
   const [canOpen, setCanOpen] = React.useState(false);
 
   const handleChange = (event: React.ChangeEvent<{ value: unknown }>) => {
-    setValue(event.target.value as string);
+    setValue(event.target.value as any);
+    onChange(event.target.value);
   };
 
   const selectHandleOnOpen = () => {
@@ -120,74 +126,74 @@ export const SelectComponent = (props: Props) => {
   };
 
   return (
-    <FormControl className={classes.formControl}>
-      <InputLabel className={classes.label} disableAnimation id="select-label">
-        {label}
-      </InputLabel>
-      <Select
-        id="select"
-        value={value}
-        displayEmpty
-        multiple={multiple}
-        onChange={handleChange}
-        onClick={selectHandleOnOpen}
-        open={canOpen}
-        input={<BootstrapInput />}
-        renderValue={selected =>
-          multiple && (value as any[]).length !== 0 ? (
-            <div className={classes.chips}>
-              {(selected as string[]).map(selectedValue => (
-                <Chip
-                  key={items.find(el => el.value === selectedValue)?.label}
-                  label={items.find(el => el.value === selectedValue)?.label}
-                  clickable
-                  onDelete={handleDelete(selectedValue)}
-                  className={classes.chip}
-                />
-              ))}
-            </div>
-          ) : (
-            <Typography>
-              {(value as any[]).length === 0
-                ? placeholder || ''
-                : items.find(el => el.value === selected)?.label}
-            </Typography>
-          )
-        }
-        IconComponent={() =>
-          !canOpen ? <ClosedDropdown /> : <OpenedDropdown />
-        }
-        MenuProps={{
-          anchorOrigin: {
-            vertical: 'bottom',
-            horizontal: 'left',
-          },
-          transformOrigin: {
-            vertical: 'top',
-            horizontal: 'left',
-          },
-          getContentAnchorEl: null,
-        }}
-      >
-        {placeholder && (
-          <MenuItem value="" disabled>
-            {placeholder}
-          </MenuItem>
-        )}
-        {items &&
-          items.map(item => (
-            <MenuItem key={item.value} value={item.value}>
-              {multiple && (
-                <Checkbox
-                  color="primary"
-                  checked={(value as any[]).includes(item.value) || false}
-                  className={classes.checkbox}
-                />
-              )}
-              {item.label}
+    <div className={classes.root}>
+      <Typography variant="button">{label}</Typography>
+      <FormControl className={classes.formControl}>
+        <Select
+          id="select"
+          value={value}
+          displayEmpty
+          multiple={multiple}
+          onChange={handleChange}
+          onClick={selectHandleOnOpen}
+          open={canOpen}
+          input={<BootstrapInput />}
+          renderValue={selected =>
+            multiple && (value as any[]).length !== 0 ? (
+              <div className={classes.chips}>
+                {(selected as string[]).map(selectedValue => (
+                  <Chip
+                    key={items.find(el => el.value === selectedValue)?.value}
+                    label={items.find(el => el.value === selectedValue)?.label}
+                    clickable
+                    onDelete={handleDelete(selectedValue)}
+                    className={classes.chip}
+                  />
+                ))}
+              </div>
+            ) : (
+              <Typography>
+                {(value as any[]).length === 0
+                  ? placeholder || ''
+                  : items.find(el => el.value === selected)?.label}
+              </Typography>
+            )
+          }
+          IconComponent={() =>
+            !canOpen ? <ClosedDropdown /> : <OpenedDropdown />
+          }
+          MenuProps={{
+            anchorOrigin: {
+              vertical: 'bottom',
+              horizontal: 'left',
+            },
+            transformOrigin: {
+              vertical: 'top',
+              horizontal: 'left',
+            },
+            getContentAnchorEl: null,
+          }}
+        >
+          {placeholder && (
+            <MenuItem value="" disabled>
+              {placeholder}
             </MenuItem>
-          ))}
-      </Select>
-    </FormControl>
+          )}
+          {items &&
+            items.map(item => (
+              <MenuItem key={item.value} value={item.value}>
+                {multiple && (
+                  <Checkbox
+                    color="primary"
+                    checked={(value as any[]).includes(item.value) || false}
+                    className={classes.checkbox}
+                  />
+                )}
+                {item.label}
+              </MenuItem>
+            ))}
+        </Select>
+      </FormControl>
+    </div>
   );
 };

From 4872ea2c7a6925c034e5a260d86eb73dc3115c06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 15 Sep 2020 10:42:04 +0200
Subject: [PATCH 009/110] feat(core): add table filters count

---
 .../core/src/components/Select/Select.tsx     |  4 +++-
 .../core/src/components/Table/Filters.tsx     |  7 +-----
 packages/core/src/components/Table/Table.tsx  | 22 ++++++++++++++-----
 3 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index b518b37d6c..0f2bda94ba 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -122,7 +122,9 @@ export const SelectComponent = (props: SelectProps) => {
   };
 
   const handleDelete = (selectedValue: string | number) => () => {
-    setValue(chips => (chips as any[]).filter(chip => chip !== selectedValue));
+    const newValue = (value as any[]).filter(chip => chip !== selectedValue)
+    setValue(newValue);
+    onChange(newValue);
   };
 
   return (
diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index db8a3a9af2..ad6c8628bb 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -75,12 +75,7 @@ export const Filters = (props: Props) => {
   // Trigger re-rendering
   const handleClick = () => {
     setSelectedFilters({});
-    setFilters([
-      ...props.filters.map(el => ({
-        type: el.type,
-        element: { ...el.element },
-      })),
-    ]);
+    setFilters([...props.filters]);
   };
 
   useEffect(() => {
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index 212e80fcd2..b728db900b 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -1,4 +1,3 @@
-import classes from '*.css';
 /*
  * Copyright 2020 Spotify AB
  *
@@ -45,7 +44,7 @@ import MTable, {
   MTableToolbar,
   Options,
 } from 'material-table';
-import React, { forwardRef, useEffect, useState } from 'react';
+import React, { forwardRef, useState } from 'react';
 import { Filters } from './Filters';
 
 const tableIcons = {
@@ -199,6 +198,7 @@ export function Table<T extends object = {}>({
   const theme = useTheme<BackstageTheme>();
 
   const [filtersOpen, toggleFilters] = useState(false);
+  const [selectedFiltersLength, setSelectedFiltersLength] = useState(0);
   const [tableData, setTableData] = useState(data as any[]);
 
   const MTColumns = convertColumns(columns, theme);
@@ -212,15 +212,25 @@ export function Table<T extends object = {}>({
   const getFieldByTitle = (titleValue: string | keyof T) =>
     columns.find(el => el.title === titleValue)?.field;
 
-  const onChangeFilters = (selectedFilters: any) => {
-    if (Object.values(selectedFilters).length) {
+    
+    const onChangeFilters = (selectedFilters: any) => {
+    const selectedFiltersArray = Object.values(selectedFilters);
+    if (selectedFiltersArray.flat().length) {
       const newData = (props.data as any[]).filter(
         el =>
           !!Object.entries(selectedFilters).find(
-            ([key, value]) => el[getFieldByTitle(key)] === value,
+            ([key, value]) => {
+              if (Array.isArray(value)) {
+                return value.includes(el[getFieldByTitle(key)])
+              }
+              return el[getFieldByTitle(key)] === value
+            },
           ),
       );
       setTableData(newData);
+      setSelectedFiltersLength(selectedFiltersArray.flat().length)
+    } else {
+      setTableData(props.data as any[]);
     }
   };
 
@@ -273,7 +283,7 @@ export function Table<T extends object = {}>({
                   >
                     <FilterList />
                   </IconButton>
-                  <Typography variant="h6">Filters</Typography>
+            <Typography variant="h6">Filters ({ selectedFiltersLength })</Typography>
                 </div>
                 <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
               </div>

From 1db357cdaa617bb56d54def9ba1d45cbc7e11761 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 15 Sep 2020 13:58:33 +0200
Subject: [PATCH 010/110] fix(core): filters edge cases

---
 .../components/CheckboxTree/CheckboxTree.tsx  | 27 +++++++++----------
 .../core/src/components/Select/Select.tsx     | 23 ++++++++++++----
 .../core/src/components/Table/Filters.tsx     | 27 ++++++++++++++-----
 packages/core/src/components/Table/Table.tsx  | 24 ++++++++---------
 4 files changed, 63 insertions(+), 38 deletions(-)

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index f1dae684c7..243abd4f5a 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -191,15 +191,16 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
     dispatch({ type: 'openCategory', payload: value });
   };
 
-  const handleChange = () => {
+  useEffect(() => {
     const values = Object.values(state).map(category => ({
-      category: category.label,
-      selected: Object.values(category.options)
+      category: category.isChecked ? category.label : null,
+      selectedChilds: Object.values(category.options)
         .filter(option => option.isChecked)
         .map(option => option.value),
     }));
     onChange(values);
-  };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [state]);
 
   return (
     <div>
@@ -213,13 +214,12 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
               <ListItem
                 dense
                 button
-                onClick={async () => {
-                  await dispatch({
+                onClick={() =>
+                  dispatch({
                     type: 'checkCategory',
                     payload: item.label,
-                  });
-                  handleChange();
-                }}
+                  })
+                }
               >
                 <ListItemIcon className={classes.listItemIcon}>
                   <Checkbox
@@ -253,16 +253,15 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
                       button
                       key={option.label}
                       className={classes.nested}
-                      onClick={async () => {
-                        await dispatch({
+                      onClick={() =>
+                        dispatch({
                           type: 'checkOption',
                           payload: {
                             subCategoryLabel: item.label,
                             optionLabel: option.label,
                           },
-                        });
-                        handleChange();
-                      }}
+                        })
+                      }
                     >
                       <ListItemIcon className={classes.listItemIcon}>
                         <Checkbox
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index 0f2bda94ba..c1f393f151 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -24,17 +24,18 @@ import {
 
 import {
   FormControl,
-  InputLabel,
   Select,
   MenuItem,
   InputBase,
   Chip,
   Typography,
   Checkbox,
+  ClickAwayListener
 } from '@material-ui/core';
 
 import ClosedDropdown from './static/ClosedDropdown';
 import OpenedDropdown from './static/OpenedDropdown';
+import { idea } from 'react-syntax-highlighter/dist/cjs/styles/hljs';
 
 const BootstrapInput = withStyles((theme: Theme) =>
   createStyles({
@@ -118,9 +119,20 @@ export const SelectComponent = (props: SelectProps) => {
   };
 
   const selectHandleOnOpen = () => {
-    setCanOpen(!canOpen);
+    setCanOpen(previous => {
+      if (multiple) {
+        return true
+      }
+      return !previous
+    });
   };
 
+  const handleClickAway = (event: React.ChangeEvent<any>) => {
+    if (event.target.id !== "menu-item") {
+      setCanOpen(false);
+    }
+  }
+
   const handleDelete = (selectedValue: string | number) => () => {
     const newValue = (value as any[]).filter(chip => chip !== selectedValue)
     setValue(newValue);
@@ -130,9 +142,9 @@ export const SelectComponent = (props: SelectProps) => {
   return (
     <div className={classes.root}>
       <Typography variant="button">{label}</Typography>
+      <ClickAwayListener onClickAway={handleClickAway}>
       <FormControl className={classes.formControl}>
         <Select
-          id="select"
           value={value}
           displayEmpty
           multiple={multiple}
@@ -177,13 +189,13 @@ export const SelectComponent = (props: SelectProps) => {
           }}
         >
           {placeholder && (
-            <MenuItem value="" disabled>
+            <MenuItem value={[]}>
               {placeholder}
             </MenuItem>
           )}
           {items &&
             items.map(item => (
-              <MenuItem key={item.value} value={item.value}>
+              <MenuItem id="menu-item" key={item.value} value={item.value}>
                 {multiple && (
                   <Checkbox
                     color="primary"
@@ -196,6 +208,7 @@ export const SelectComponent = (props: SelectProps) => {
             ))}
         </Select>
       </FormControl>
+      </ClickAwayListener>
     </div>
   );
 };
diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index ad6c8628bb..e8192b1a90 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -80,7 +80,7 @@ export const Filters = (props: Props) => {
 
   useEffect(() => {
     onChangeFilters(selectedFilters);
-  // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [selectedFilters]);
 
   // As material table doesn't provide a way to add a column filter tab we will make our own filter logic
@@ -99,12 +99,25 @@ export const Filters = (props: Props) => {
               <CheckboxTree
                 key={filter.element.label}
                 {...(filter.element as CheckboxTreeProps)}
-                onChange={
-                  el => ({})
-                  // setSelectedFilters({
-                  //   ...selectedFilters,
-                  //   [filter.element.label]: el,
-                  // })
+                onChange={el =>
+                  setSelectedFilters({
+                    ...selectedFilters,
+                    [filter.element.label]: el
+                      .filter(
+                        (checkboxFilter: any) =>
+                          checkboxFilter.category ||
+                          checkboxFilter.selectedChilds.length,
+                      )
+                      .map((checkboxFilter: any) =>
+                        checkboxFilter.category
+                          ? [
+                              ...checkboxFilter.selectedChilds,
+                              checkboxFilter.category,
+                            ]
+                          : checkboxFilter.selectedChilds,
+                      )
+                      .flat(),
+                  })
                 }
               />
             ) : (
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index b728db900b..3605bc8e00 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -138,6 +138,7 @@ const useFilterStyles = makeStyles<BackstageTheme>(() => ({
 const useTableStyles = makeStyles<BackstageTheme>(() => ({
   root: {
     display: 'flex',
+    alignItems: 'start',
   },
 }));
 
@@ -212,23 +213,20 @@ export function Table<T extends object = {}>({
   const getFieldByTitle = (titleValue: string | keyof T) =>
     columns.find(el => el.title === titleValue)?.field;
 
-    
-    const onChangeFilters = (selectedFilters: any) => {
+  const onChangeFilters = (selectedFilters: any) => {
     const selectedFiltersArray = Object.values(selectedFilters);
     if (selectedFiltersArray.flat().length) {
       const newData = (props.data as any[]).filter(
         el =>
-          !!Object.entries(selectedFilters).find(
-            ([key, value]) => {
-              if (Array.isArray(value)) {
-                return value.includes(el[getFieldByTitle(key)])
-              }
-              return el[getFieldByTitle(key)] === value
-            },
-          ),
+          !!Object.entries(selectedFilters).find(([key, value]) => {
+            if (Array.isArray(value)) {
+              return value.includes(el[getFieldByTitle(key)]);
+            }
+            return el[getFieldByTitle(key)] === value;
+          }),
       );
       setTableData(newData);
-      setSelectedFiltersLength(selectedFiltersArray.flat().length)
+      setSelectedFiltersLength(selectedFiltersArray.flat().length);
     } else {
       setTableData(props.data as any[]);
     }
@@ -283,7 +281,9 @@ export function Table<T extends object = {}>({
                   >
                     <FilterList />
                   </IconButton>
-            <Typography variant="h6">Filters ({ selectedFiltersLength })</Typography>
+                  <Typography variant="h6">
+                    Filters ({selectedFiltersLength})
+                  </Typography>
                 </div>
                 <MTableToolbar classes={toolbarClasses} {...toolbarProps} />
               </div>

From 4b0df9553b8f3c09c2067e3db209923f6459996a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 15 Sep 2020 16:46:39 +0200
Subject: [PATCH 011/110] feat(core): styling updates

---
 .../components/CheckboxTree/CheckboxTree.tsx  | 36 +++++++++++++------
 .../core/src/components/Table/Filters.tsx     | 10 +++---
 packages/core/src/components/Table/Table.tsx  |  6 +++-
 3 files changed, 35 insertions(+), 17 deletions(-)

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index 243abd4f5a..f0d1135918 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -41,14 +41,32 @@ const useStyles = makeStyles((theme: Theme) =>
       '&:hover': {
         backgroundColor: 'transparent',
       },
+      '&:active' : {
+        animation: 'none',
+        transform: 'none'
+      },
     },
     nested: {
       paddingLeft: theme.spacing(5),
       height: '32px',
+      '&:hover' : {
+        backgroundColor: 'transparent',
+      },
     },
     listItemIcon: {
       minWidth: 10,
     },
+    listItem: {
+      '&:hover' : {
+        backgroundColor: 'transparent',
+      },
+    },
+    text: {
+      '& span, & svg': {
+        fontWeight: 'normal',
+        fontSize: 14
+      }
+    }
   }),
 );
 
@@ -180,6 +198,7 @@ const indexer = (
     };
   }, {});
 
+
 export const CheckboxTree = (props: CheckboxTreeProps) => {
   const { onChange } = props;
   const classes = useStyles();
@@ -206,15 +225,13 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
     <div>
       <Typography variant="button">{props.label}</Typography>
       <List className={classes.root}>
-        {Object.values(state).map(item => {
-          const labelId = `checkbox-list-label-${item?.label}`;
-
-          return (
+        {Object.values(state).map(item => 
             <div key={item.label}>
               <ListItem
+                className={classes.listItem}
                 dense
                 button
-                onClick={() =>
+                onClick={() => 
                   dispatch({
                     type: 'checkCategory',
                     payload: item.label,
@@ -228,10 +245,9 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
                     checked={item.isChecked}
                     tabIndex={-1}
                     disableRipple
-                    inputProps={{ 'aria-labelledby': labelId }}
                   />
                 </ListItemIcon>
-                <ListItemText id={labelId} primary={item.label} />
+                <ListItemText className={classes.text} primary={item.label} />
                 {Object.values(item.options).length ? (
                   <>
                     {item.isOpen ? (
@@ -270,17 +286,15 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
                           checked={option.isChecked}
                           tabIndex={-1}
                           disableRipple
-                          inputProps={{ 'aria-labelledby': labelId }}
                         />
                       </ListItemIcon>
-                      <ListItemText primary={option.label} />
+                      <ListItemText className={classes.text} primary={option.label} />
                     </ListItem>
                   ))}
                 </List>
               </Collapse>
             </div>
-          );
-        })}
+        )}
       </List>
     </div>
   );
diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index e8192b1a90..84663a4467 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -30,7 +30,10 @@ const useSubvalueCellStyles = makeStyles<BackstageTheme>(theme => ({
     flexDirection: 'column',
     marginRight: theme.spacing(3),
   },
-  value: {},
+  value: {
+    fontWeight: 'bold',
+    fontSize: 18
+  },
   header: {
     display: 'flex',
     alignItems: 'center',
@@ -45,9 +48,6 @@ const useSubvalueCellStyles = makeStyles<BackstageTheme>(theme => ({
       marginTop: theme.spacing(2),
     },
   },
-  clear: {
-    textTransform: 'none',
-  },
 }));
 
 type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
@@ -88,7 +88,7 @@ export const Filters = (props: Props) => {
     <div className={classes.root}>
       <div className={classes.header}>
         <div className={classes.value}>Filters</div>
-        <Button className={classes.clear} color="primary" onClick={handleClick}>
+        <Button color="primary" onClick={handleClick}>
           Clear all
         </Button>
       </div>
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index 3605bc8e00..0886d8e177 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -133,6 +133,10 @@ const useFilterStyles = makeStyles<BackstageTheme>(() => ({
     alignItems: 'center',
     justifyContent: 'space-between',
   },
+  title: {
+    fontWeight: 'bold',
+    fontSize: 18
+  }
 }));
 
 const useTableStyles = makeStyles<BackstageTheme>(() => ({
@@ -281,7 +285,7 @@ export function Table<T extends object = {}>({
                   >
                     <FilterList />
                   </IconButton>
-                  <Typography variant="h6">
+                  <Typography className={filtersClasses.title}>
                     Filters ({selectedFiltersLength})
                   </Typography>
                 </div>

From 184cfecbb3ff48d65dadf4d038c90e0bd15e0b79 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 15 Sep 2020 18:17:35 +0200
Subject: [PATCH 012/110] fix(core): filter count + nullable category label

---
 packages/core/src/components/Table/Filters.tsx | 4 ++--
 packages/core/src/components/Table/Table.tsx   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index 84663a4467..e11736604b 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -105,11 +105,11 @@ export const Filters = (props: Props) => {
                     [filter.element.label]: el
                       .filter(
                         (checkboxFilter: any) =>
-                          checkboxFilter.category ||
+                          checkboxFilter.category !== null ||
                           checkboxFilter.selectedChilds.length,
                       )
                       .map((checkboxFilter: any) =>
-                        checkboxFilter.category
+                        checkboxFilter.category !== null
                           ? [
                               ...checkboxFilter.selectedChilds,
                               checkboxFilter.category,
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index 0886d8e177..ace5aa3fac 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -230,10 +230,10 @@ export function Table<T extends object = {}>({
           }),
       );
       setTableData(newData);
-      setSelectedFiltersLength(selectedFiltersArray.flat().length);
     } else {
       setTableData(props.data as any[]);
     }
+    setSelectedFiltersLength(selectedFiltersArray.flat().length);
   };
 
   const constructFilters = (filterConfig: TableFilter[], dataValue: any[]) => {

From 240c09159c18edbb7c51a726186c5c612956d7ba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 15 Sep 2020 19:08:25 +0200
Subject: [PATCH 013/110] fix(core): run prettier

---
 .../components/CheckboxTree/CheckboxTree.tsx  | 156 +++++++++---------
 .../core/src/components/Select/Select.tsx     | 140 ++++++++--------
 .../core/src/components/Table/Filters.tsx     |   2 +-
 packages/core/src/components/Table/Table.tsx  |   4 +-
 4 files changed, 151 insertions(+), 151 deletions(-)

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index f0d1135918..31fefda204 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -41,15 +41,15 @@ const useStyles = makeStyles((theme: Theme) =>
       '&:hover': {
         backgroundColor: 'transparent',
       },
-      '&:active' : {
+      '&:active': {
         animation: 'none',
-        transform: 'none'
+        transform: 'none',
       },
     },
     nested: {
       paddingLeft: theme.spacing(5),
       height: '32px',
-      '&:hover' : {
+      '&:hover': {
         backgroundColor: 'transparent',
       },
     },
@@ -57,16 +57,16 @@ const useStyles = makeStyles((theme: Theme) =>
       minWidth: 10,
     },
     listItem: {
-      '&:hover' : {
+      '&:hover': {
         backgroundColor: 'transparent',
       },
     },
     text: {
       '& span, & svg': {
         fontWeight: 'normal',
-        fontSize: 14
-      }
-    }
+        fontSize: 14,
+      },
+    },
   }),
 );
 
@@ -198,7 +198,6 @@ const indexer = (
     };
   }, {});
 
-
 export const CheckboxTree = (props: CheckboxTreeProps) => {
   const { onChange } = props;
   const classes = useStyles();
@@ -225,76 +224,79 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
     <div>
       <Typography variant="button">{props.label}</Typography>
       <List className={classes.root}>
-        {Object.values(state).map(item => 
-            <div key={item.label}>
-              <ListItem
-                className={classes.listItem}
-                dense
-                button
-                onClick={() => 
-                  dispatch({
-                    type: 'checkCategory',
-                    payload: item.label,
-                  })
-                }
-              >
-                <ListItemIcon className={classes.listItemIcon}>
-                  <Checkbox
-                    color="primary"
-                    edge="start"
-                    checked={item.isChecked}
-                    tabIndex={-1}
-                    disableRipple
-                  />
-                </ListItemIcon>
-                <ListItemText className={classes.text} primary={item.label} />
-                {Object.values(item.options).length ? (
-                  <>
-                    {item.isOpen ? (
-                      <ExpandLess
-                        onClick={event => handleOpen(event, item.label)}
+        {Object.values(state).map(item => (
+          <div key={item.label}>
+            <ListItem
+              className={classes.listItem}
+              dense
+              button
+              onClick={() =>
+                dispatch({
+                  type: 'checkCategory',
+                  payload: item.label,
+                })
+              }
+            >
+              <ListItemIcon className={classes.listItemIcon}>
+                <Checkbox
+                  color="primary"
+                  edge="start"
+                  checked={item.isChecked}
+                  tabIndex={-1}
+                  disableRipple
+                />
+              </ListItemIcon>
+              <ListItemText className={classes.text} primary={item.label} />
+              {Object.values(item.options).length ? (
+                <>
+                  {item.isOpen ? (
+                    <ExpandLess
+                      onClick={event => handleOpen(event, item.label)}
+                    />
+                  ) : (
+                    <ExpandMore
+                      onClick={event => handleOpen(event, item.label)}
+                    />
+                  )}
+                </>
+              ) : null}
+            </ListItem>
+            <Collapse in={item.isOpen} timeout="auto" unmountOnExit>
+              <List component="div" disablePadding>
+                {Object.values(item.options).map(option => (
+                  <ListItem
+                    button
+                    key={option.label}
+                    className={classes.nested}
+                    onClick={() =>
+                      dispatch({
+                        type: 'checkOption',
+                        payload: {
+                          subCategoryLabel: item.label,
+                          optionLabel: option.label,
+                        },
+                      })
+                    }
+                  >
+                    <ListItemIcon className={classes.listItemIcon}>
+                      <Checkbox
+                        color="primary"
+                        edge="start"
+                        checked={option.isChecked}
+                        tabIndex={-1}
+                        disableRipple
                       />
-                    ) : (
-                      <ExpandMore
-                        onClick={event => handleOpen(event, item.label)}
-                      />
-                    )}
-                  </>
-                ) : null}
-              </ListItem>
-              <Collapse in={item.isOpen} timeout="auto" unmountOnExit>
-                <List component="div" disablePadding>
-                  {Object.values(item.options).map(option => (
-                    <ListItem
-                      button
-                      key={option.label}
-                      className={classes.nested}
-                      onClick={() =>
-                        dispatch({
-                          type: 'checkOption',
-                          payload: {
-                            subCategoryLabel: item.label,
-                            optionLabel: option.label,
-                          },
-                        })
-                      }
-                    >
-                      <ListItemIcon className={classes.listItemIcon}>
-                        <Checkbox
-                          color="primary"
-                          edge="start"
-                          checked={option.isChecked}
-                          tabIndex={-1}
-                          disableRipple
-                        />
-                      </ListItemIcon>
-                      <ListItemText className={classes.text} primary={option.label} />
-                    </ListItem>
-                  ))}
-                </List>
-              </Collapse>
-            </div>
-        )}
+                    </ListItemIcon>
+                    <ListItemText
+                      className={classes.text}
+                      primary={option.label}
+                    />
+                  </ListItem>
+                ))}
+              </List>
+            </Collapse>
+          </div>
+        ))}
       </List>
     </div>
   );
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index c1f393f151..a04c616a7c 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -30,7 +30,7 @@ import {
   Chip,
   Typography,
   Checkbox,
-  ClickAwayListener
+  ClickAwayListener,
 } from '@material-ui/core';
 
 import ClosedDropdown from './static/ClosedDropdown';
@@ -121,20 +121,20 @@ export const SelectComponent = (props: SelectProps) => {
   const selectHandleOnOpen = () => {
     setCanOpen(previous => {
       if (multiple) {
-        return true
+        return true;
       }
-      return !previous
+      return !previous;
     });
   };
 
   const handleClickAway = (event: React.ChangeEvent<any>) => {
-    if (event.target.id !== "menu-item") {
+    if (event.target.id !== 'menu-item') {
       setCanOpen(false);
     }
-  }
+  };
 
   const handleDelete = (selectedValue: string | number) => () => {
-    const newValue = (value as any[]).filter(chip => chip !== selectedValue)
+    const newValue = (value as any[]).filter(chip => chip !== selectedValue);
     setValue(newValue);
     onChange(newValue);
   };
@@ -143,71 +143,69 @@ export const SelectComponent = (props: SelectProps) => {
     <div className={classes.root}>
       <Typography variant="button">{label}</Typography>
       <ClickAwayListener onClickAway={handleClickAway}>
-      <FormControl className={classes.formControl}>
-        <Select
-          value={value}
-          displayEmpty
-          multiple={multiple}
-          onChange={handleChange}
-          onClick={selectHandleOnOpen}
-          open={canOpen}
-          input={<BootstrapInput />}
-          renderValue={selected =>
-            multiple && (value as any[]).length !== 0 ? (
-              <div className={classes.chips}>
-                {(selected as string[]).map(selectedValue => (
-                  <Chip
-                    key={items.find(el => el.value === selectedValue)?.value}
-                    label={items.find(el => el.value === selectedValue)?.label}
-                    clickable
-                    onDelete={handleDelete(selectedValue)}
-                    className={classes.chip}
-                  />
-                ))}
-              </div>
-            ) : (
-              <Typography>
-                {(value as any[]).length === 0
-                  ? placeholder || ''
-                  : items.find(el => el.value === selected)?.label}
-              </Typography>
-            )
-          }
-          IconComponent={() =>
-            !canOpen ? <ClosedDropdown /> : <OpenedDropdown />
-          }
-          MenuProps={{
-            anchorOrigin: {
-              vertical: 'bottom',
-              horizontal: 'left',
-            },
-            transformOrigin: {
-              vertical: 'top',
-              horizontal: 'left',
-            },
-            getContentAnchorEl: null,
-          }}
-        >
-          {placeholder && (
-            <MenuItem value={[]}>
-              {placeholder}
-            </MenuItem>
-          )}
-          {items &&
-            items.map(item => (
-              <MenuItem id="menu-item" key={item.value} value={item.value}>
-                {multiple && (
-                  <Checkbox
-                    color="primary"
-                    checked={(value as any[]).includes(item.value) || false}
-                    className={classes.checkbox}
-                  />
-                )}
-                {item.label}
-              </MenuItem>
-            ))}
-        </Select>
-      </FormControl>
+        <FormControl className={classes.formControl}>
+          <Select
+            value={value}
+            displayEmpty
+            multiple={multiple}
+            onChange={handleChange}
+            onClick={selectHandleOnOpen}
+            open={canOpen}
+            input={<BootstrapInput />}
+            renderValue={selected =>
+              multiple && (value as any[]).length !== 0 ? (
+                <div className={classes.chips}>
+                  {(selected as string[]).map(selectedValue => (
+                    <Chip
+                      key={items.find(el => el.value === selectedValue)?.value}
+                      label={
+                        items.find(el => el.value === selectedValue)?.label
+                      }
+                      clickable
+                      onDelete={handleDelete(selectedValue)}
+                      className={classes.chip}
+                    />
+                  ))}
+                </div>
+              ) : (
+                <Typography>
+                  {(value as any[]).length === 0
+                    ? placeholder || ''
+                    : items.find(el => el.value === selected)?.label}
+                </Typography>
+              )
+            }
+            IconComponent={() =>
+              !canOpen ? <ClosedDropdown /> : <OpenedDropdown />
+            }
+            MenuProps={{
+              anchorOrigin: {
+                vertical: 'bottom',
+                horizontal: 'left',
+              },
+              transformOrigin: {
+                vertical: 'top',
+                horizontal: 'left',
+              },
+              getContentAnchorEl: null,
+            }}
+          >
+            {placeholder && <MenuItem value={[]}>{placeholder}</MenuItem>}
+            {items &&
+              items.map(item => (
+                <MenuItem id="menu-item" key={item.value} value={item.value}>
+                  {multiple && (
+                    <Checkbox
+                      color="primary"
+                      checked={(value as any[]).includes(item.value) || false}
+                      className={classes.checkbox}
+                    />
+                  )}
+                  {item.label}
+                </MenuItem>
+              ))}
+          </Select>
+        </FormControl>
       </ClickAwayListener>
     </div>
   );
diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index e11736604b..b797783857 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -32,7 +32,7 @@ const useSubvalueCellStyles = makeStyles<BackstageTheme>(theme => ({
   },
   value: {
     fontWeight: 'bold',
-    fontSize: 18
+    fontSize: 18,
   },
   header: {
     display: 'flex',
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index ace5aa3fac..4ab5dcd6f5 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -135,8 +135,8 @@ const useFilterStyles = makeStyles<BackstageTheme>(() => ({
   },
   title: {
     fontWeight: 'bold',
-    fontSize: 18
-  }
+    fontSize: 18,
+  },
 }));
 
 const useTableStyles = makeStyles<BackstageTheme>(() => ({

From 3db5fc94d91e96d31479d78c91e1751670346a2a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Tue, 15 Sep 2020 19:15:21 +0200
Subject: [PATCH 014/110] fix(core): tsc errors

---
 .../core/src/components/CheckboxTree/CheckboxTree.stories.tsx | 2 +-
 packages/core/src/components/Select/Select.stories.tsx        | 4 ++--
 packages/core/src/components/Select/Select.tsx                | 1 -
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
index 0da4c1b7b7..12f19b17a1 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.stories.tsx
@@ -66,7 +66,7 @@ export default {
 
 export const Default = () => (
   <CheckboxTree
-    onChange={el => {}}
+    onChange={() => {}}
     label="default"
     subCategories={CHECKBOX_TREE_ITEMS}
   />
diff --git a/packages/core/src/components/Select/Select.stories.tsx b/packages/core/src/components/Select/Select.stories.tsx
index acb6f8afc8..feb5c1cffb 100644
--- a/packages/core/src/components/Select/Select.stories.tsx
+++ b/packages/core/src/components/Select/Select.stories.tsx
@@ -39,7 +39,7 @@ const SELECT_ITEMS = [
 
 export const Default = () => (
   <Select
-    onChange={el => {}}
+    onChange={() => {}}
     placeholder="All results"
     label="Default"
     items={SELECT_ITEMS}
@@ -52,6 +52,6 @@ export const Multiple = () => (
     label="Multiple"
     items={SELECT_ITEMS}
     multiple
-    onChange={el => {}}
+    onChange={() => {}}
   />
 );
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index a04c616a7c..5771786f18 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -35,7 +35,6 @@ import {
 
 import ClosedDropdown from './static/ClosedDropdown';
 import OpenedDropdown from './static/OpenedDropdown';
-import { idea } from 'react-syntax-highlighter/dist/cjs/styles/hljs';
 
 const BootstrapInput = withStyles((theme: Theme) =>
   createStyles({

From cc0af155e0f159a11f8fd5793d46bba09790bd83 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Wed, 16 Sep 2020 16:28:41 +0200
Subject: [PATCH 015/110] refactor(core): add immer + action renaming

---
 packages/core/package.json                    |  1 +
 .../components/CheckboxTree/CheckboxTree.tsx  | 79 ++++++-------------
 yarn.lock                                     |  5 ++
 3 files changed, 31 insertions(+), 54 deletions(-)

diff --git a/packages/core/package.json b/packages/core/package.json
index 7e9932bdc1..b2d55bc6fe 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -39,6 +39,7 @@
     "@types/react-sparklines": "^1.7.0",
     "classnames": "^2.2.6",
     "clsx": "^1.1.0",
+    "immer": "^7.0.9",
     "lodash": "^4.17.15",
     "material-table": "1.68.0",
     "prop-types": "^15.7.2",
diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index 31fefda204..ed0da051c5 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -26,6 +26,7 @@ import {
 } from '@material-ui/core';
 import ExpandLess from '@material-ui/icons/ExpandLess';
 import ExpandMore from '@material-ui/icons/ExpandMore';
+import produce from 'immer';
 
 type IndexedObject<T> = {
   [key: string]: T;
@@ -110,18 +111,7 @@ type checkOptionPayload = {
 type Action =
   | { type: 'checkOption'; payload: checkOptionPayload }
   | { type: 'checkCategory'; payload: string }
-  | { type: 'openCategory'; payload: string };
-
-const checkAllOptions = (
-  arr: Option[],
-  isChecked: boolean,
-): IndexedObject<Option> =>
-  arr.reduce((accumulator, el) => {
-    return {
-      ...accumulator,
-      [el.label]: { ...el, isChecked },
-    };
-  }, {});
+  | { type: 'toggleCategory'; payload: string };
 
 const reducer = (
   state: IndexedObject<SubCategoryWithIndexedOptions>,
@@ -129,49 +119,30 @@ const reducer = (
 ) => {
   switch (action.type) {
     case 'checkOption': {
-      const newOptions = {
-        ...state[action.payload.subCategoryLabel].options,
-        [action.payload.optionLabel]: {
-          ...state[action.payload.subCategoryLabel].options[
-            action.payload.optionLabel
-          ],
-          isChecked: !state[action.payload.subCategoryLabel].options[
-            action.payload.optionLabel
-          ].isChecked,
-        },
-      };
-
-      return {
-        ...state,
-        [action.payload.subCategoryLabel]: {
-          ...state[action.payload.subCategoryLabel],
-          isChecked: Object.values(newOptions).every(
-            option => option.isChecked,
-          ),
-          options: newOptions,
-        },
-      };
+      return produce(state, newState => {
+        const category = newState[action.payload.subCategoryLabel];
+        const option = category.options[action.payload.optionLabel];
+        option.isChecked = !option.isChecked;
+        category.isChecked = Object.values(category.options).every(
+          o => o.isChecked,
+        );
+      });
     }
     case 'checkCategory':
-      return {
-        ...state,
-        [action.payload]: {
-          ...state[action.payload],
-          isChecked: !state[action.payload].isChecked,
-          options: checkAllOptions(
-            Object.values(state[action.payload].options),
-            !state[action.payload].isChecked,
-          ),
-        },
-      };
-    case 'openCategory':
-      return {
-        ...state,
-        [action.payload]: {
-          ...state[action.payload],
-          isOpen: !state[action.payload].isOpen,
-        },
-      };
+      return produce(state, newState => {
+        const category = newState[action.payload];
+        const options = category.options;
+        category.isChecked = !category.isChecked;
+        // eslint-disable-next-line guard-for-in
+        for (const option in options) {
+          options[option].isChecked = category.isChecked;
+        }
+      });
+    case 'toggleCategory':
+      return produce(state, newState => {
+        const category = newState[action.payload];
+        category.isOpen = !category.isOpen;
+      });
     default:
       return state;
   }
@@ -206,7 +177,7 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
 
   const handleOpen = (event: any, value: any) => {
     event.stopPropagation();
-    dispatch({ type: 'openCategory', payload: value });
+    dispatch({ type: 'toggleCategory', payload: value });
   };
 
   useEffect(() => {
diff --git a/yarn.lock b/yarn.lock
index 449148e487..8d06ce3096 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -11749,6 +11749,11 @@ immer@1.10.0:
   resolved "https://registry.npmjs.org/immer/-/immer-1.10.0.tgz#bad67605ba9c810275d91e1c2a47d4582e98286d"
   integrity sha512-O3sR1/opvCDGLEVcvrGTMtLac8GJ5IwZC4puPrLuRj3l7ICKvkmA0vGuU9OW8mV9WIBRnaxp5GJh9IEAaNOoYg==
 
+immer@^7.0.9:
+  version "7.0.9"
+  resolved "https://registry.npmjs.org/immer/-/immer-7.0.9.tgz#28e7552c21d39dd76feccd2b800b7bc86ee4a62e"
+  integrity sha512-Vs/gxoM4DqNAYR7pugIxi0Xc8XAun/uy7AQu4fLLqaTBHxjOP9pJ266Q9MWA/ly4z6rAFZbvViOtihxUZ7O28A==
+
 immutable@>=3.8.2, immutable@^3.8.1, immutable@^3.8.2, immutable@^3.x.x:
   version "3.8.2"
   resolved "https://registry.npmjs.org/immutable/-/immutable-3.8.2.tgz#c2439951455bb39913daf281376f1530e104adf3"

From 864d44396b3b268ea656bbb033091661080f46e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Wed, 16 Sep 2020 16:53:30 +0200
Subject: [PATCH 016/110] fix(core): AND logic between group of filters

---
 packages/core/src/components/Table/Filters.tsx |  6 +++++-
 packages/core/src/components/Table/Table.tsx   | 18 ++++++++++--------
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index b797783857..d7b0d682be 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -59,6 +59,10 @@ export type Filter = {
     | Without<SelectProps, 'onChange'>;
 };
 
+export type SelectedFilters = {
+  [key: string]: string | string[];
+};
+
 type Props = {
   filters: Filter[];
   onChangeFilters: (arg: any) => any;
@@ -70,7 +74,7 @@ export const Filters = (props: Props) => {
   const { onChangeFilters } = props;
 
   const [filters, setFilters] = useState(props.filters);
-  const [selectedFilters, setSelectedFilters] = useState({});
+  const [selectedFilters, setSelectedFilters] = useState<SelectedFilters>({});
 
   // Trigger re-rendering
   const handleClick = () => {
diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index 4ab5dcd6f5..c2e91109de 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -45,7 +45,7 @@ import MTable, {
   Options,
 } from 'material-table';
 import React, { forwardRef, useState } from 'react';
-import { Filters } from './Filters';
+import { Filters, SelectedFilters } from './Filters';
 
 const tableIcons = {
   Add: forwardRef((props, ref: React.Ref<SVGSVGElement>) => (
@@ -217,17 +217,19 @@ export function Table<T extends object = {}>({
   const getFieldByTitle = (titleValue: string | keyof T) =>
     columns.find(el => el.title === titleValue)?.field;
 
-  const onChangeFilters = (selectedFilters: any) => {
+  const onChangeFilters = (selectedFilters: SelectedFilters) => {
     const selectedFiltersArray = Object.values(selectedFilters);
     if (selectedFiltersArray.flat().length) {
       const newData = (props.data as any[]).filter(
         el =>
-          !!Object.entries(selectedFilters).find(([key, value]) => {
-            if (Array.isArray(value)) {
-              return value.includes(el[getFieldByTitle(key)]);
-            }
-            return el[getFieldByTitle(key)] === value;
-          }),
+          !!Object.entries(selectedFilters)
+            .filter(([, value]) => !!value.length)
+            .every(([key, value]) => {
+              if (Array.isArray(value)) {
+                return value.includes(el[getFieldByTitle(key)]);
+              }
+              return el[getFieldByTitle(key)] === value;
+            }),
       );
       setTableData(newData);
     } else {

From e5a461375fad432a3007e1983e68744a6e0c0db9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Fri, 18 Sep 2020 15:40:05 +0200
Subject: [PATCH 017/110] feat(core): add filters clear

---
 .../components/CheckboxTree/CheckboxTree.tsx  | 24 ++++++++++++++++---
 .../core/src/components/Select/Select.tsx     |  7 +++++-
 .../core/src/components/Table/Filters.tsx     |  4 ++++
 3 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index ed0da051c5..dcc75eb7d4 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/* eslint-disable guard-for-in */
 import React, { useEffect, useReducer } from 'react';
 import { createStyles, makeStyles, Theme } from '@material-ui/core/styles';
 import {
@@ -98,6 +99,7 @@ type Option = {
 export type CheckboxTreeProps = {
   subCategories: SubCategory[];
   label: string;
+  triggerReset?: boolean;
   onChange: (arg: any) => any;
 };
 
@@ -111,7 +113,8 @@ type checkOptionPayload = {
 type Action =
   | { type: 'checkOption'; payload: checkOptionPayload }
   | { type: 'checkCategory'; payload: string }
-  | { type: 'toggleCategory'; payload: string };
+  | { type: 'toggleCategory'; payload: string }
+  | { type: 'triggerReset' };
 
 const reducer = (
   state: IndexedObject<SubCategoryWithIndexedOptions>,
@@ -128,21 +131,32 @@ const reducer = (
         );
       });
     }
-    case 'checkCategory':
+    case 'checkCategory': {
       return produce(state, newState => {
         const category = newState[action.payload];
         const options = category.options;
         category.isChecked = !category.isChecked;
-        // eslint-disable-next-line guard-for-in
         for (const option in options) {
           options[option].isChecked = category.isChecked;
         }
       });
+    }
     case 'toggleCategory':
       return produce(state, newState => {
         const category = newState[action.payload];
         category.isOpen = !category.isOpen;
       });
+    case 'triggerReset': {
+      return produce(state, newState => {
+        for (const category in newState) {
+          newState[category].isChecked = false;
+          for (const option in newState[category].options) {
+            newState[category].options[option].isChecked =
+              newState[category].isChecked;
+          }
+        }
+      });
+    }
     default:
       return state;
   }
@@ -191,6 +205,10 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [state]);
 
+  useEffect(() => {
+    dispatch({ type: 'triggerReset' });
+  }, [props.triggerReset]);
+
   return (
     <div>
       <Typography variant="button">{props.label}</Typography>
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index 5771786f18..9ee3e69a30 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import React, { useState } from 'react';
+import React, { useEffect, useState } from 'react';
 import {
   createStyles,
   makeStyles,
@@ -102,6 +102,7 @@ export type SelectProps = {
   label: string;
   placeholder?: string;
   onChange: (arg: any) => any;
+  triggerReset?: boolean;
 };
 
 export const SelectComponent = (props: SelectProps) => {
@@ -112,6 +113,10 @@ export const SelectComponent = (props: SelectProps) => {
   );
   const [canOpen, setCanOpen] = React.useState(false);
 
+  useEffect(() => {
+    setValue(multiple ? [] : "")
+  }, [props.triggerReset, multiple])
+
   const handleChange = (event: React.ChangeEvent<{ value: unknown }>) => {
     setValue(event.target.value as any);
     onChange(event.target.value);
diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index d7b0d682be..12727643bb 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -75,11 +75,13 @@ export const Filters = (props: Props) => {
 
   const [filters, setFilters] = useState(props.filters);
   const [selectedFilters, setSelectedFilters] = useState<SelectedFilters>({});
+  const [reset, triggerReset] = useState(false);
 
   // Trigger re-rendering
   const handleClick = () => {
     setSelectedFilters({});
     setFilters([...props.filters]);
+    triggerReset(el => !el)
   };
 
   useEffect(() => {
@@ -101,6 +103,7 @@ export const Filters = (props: Props) => {
           filters.map(filter =>
             filter.type === 'checkbox-tree' ? (
               <CheckboxTree
+                triggerReset={reset}
                 key={filter.element.label}
                 {...(filter.element as CheckboxTreeProps)}
                 onChange={el =>
@@ -126,6 +129,7 @@ export const Filters = (props: Props) => {
               />
             ) : (
               <Select
+                triggerReset={reset}
                 key={filter.element.label}
                 {...(filter.element as SelectProps)}
                 onChange={el =>

From 4cb7af0037089bea607da5d417fb3492d2e9f944 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Fri, 18 Sep 2020 15:52:16 +0200
Subject: [PATCH 018/110] fix(core): prettier

---
 packages/core/src/components/Select/Select.tsx | 4 ++--
 packages/core/src/components/Table/Filters.tsx | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index 9ee3e69a30..4d6ec40ce6 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -114,8 +114,8 @@ export const SelectComponent = (props: SelectProps) => {
   const [canOpen, setCanOpen] = React.useState(false);
 
   useEffect(() => {
-    setValue(multiple ? [] : "")
-  }, [props.triggerReset, multiple])
+    setValue(multiple ? [] : '');
+  }, [props.triggerReset, multiple]);
 
   const handleChange = (event: React.ChangeEvent<{ value: unknown }>) => {
     setValue(event.target.value as any);
diff --git a/packages/core/src/components/Table/Filters.tsx b/packages/core/src/components/Table/Filters.tsx
index 12727643bb..c8f468559a 100644
--- a/packages/core/src/components/Table/Filters.tsx
+++ b/packages/core/src/components/Table/Filters.tsx
@@ -81,7 +81,7 @@ export const Filters = (props: Props) => {
   const handleClick = () => {
     setSelectedFilters({});
     setFilters([...props.filters]);
-    triggerReset(el => !el)
+    triggerReset(el => !el);
   };
 
   useEffect(() => {

From b1209950e1bfd034a88aa7f93d8a7a36b24ba5aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Sun, 20 Sep 2020 14:48:06 +0200
Subject: [PATCH 019/110] feat(core): add missing tests

---
 .../CheckboxTree/CheckboxTree.test.tsx        | 60 +++++++++++++++++++
 .../components/CheckboxTree/CheckboxTree.tsx  |  2 +
 .../src/components/Select/Select.test.tsx     | 58 ++++++++++++++++++
 .../core/src/components/Select/Select.tsx     |  1 +
 4 files changed, 121 insertions(+)
 create mode 100644 packages/core/src/components/CheckboxTree/CheckboxTree.test.tsx
 create mode 100644 packages/core/src/components/Select/Select.test.tsx

diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.test.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.test.tsx
new file mode 100644
index 0000000000..f5eaa0e58b
--- /dev/null
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.test.tsx
@@ -0,0 +1,60 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { render, fireEvent } from '@testing-library/react';
+
+import { CheckboxTree } from '.';
+
+const CHECKBOX_TREE_ITEMS = [
+  {
+    label: 'Genereic subcategory name 1',
+    options: [
+      {
+        label: 'Option 1',
+        value: 1,
+      },
+      {
+        label: 'Option 2',
+        value: 2,
+      },
+    ],
+  },
+];
+
+const minProps = {
+  onChange: jest.fn(),
+  label: 'Default',
+  subCategories: CHECKBOX_TREE_ITEMS,
+};
+
+describe('<CheckboxTree />', () => {
+  it('renders without exploding', async () => {
+    const { getByText, getByTestId } = render(<CheckboxTree {...minProps} />);
+
+    expect(getByText('Genereic subcategory name 1')).toBeInTheDocument();
+    const checkbox = await getByTestId('expandable');
+
+    // Simulate click on expandable arrow
+    fireEvent.click(checkbox);
+
+    // Simulate click on option
+    const option = getByText('Option 1');
+    expect(getByText('Option 1')).toBeInTheDocument();
+    fireEvent.click(option);
+    expect(minProps.onChange).toHaveBeenCalled();
+  });
+});
diff --git a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
index dcc75eb7d4..6825704971 100644
--- a/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
+++ b/packages/core/src/components/CheckboxTree/CheckboxTree.tsx
@@ -240,10 +240,12 @@ export const CheckboxTree = (props: CheckboxTreeProps) => {
                 <>
                   {item.isOpen ? (
                     <ExpandLess
+                      data-testid="expandable"
                       onClick={event => handleOpen(event, item.label)}
                     />
                   ) : (
                     <ExpandMore
+                      data-testid="expandable"
                       onClick={event => handleOpen(event, item.label)}
                     />
                   )}
diff --git a/packages/core/src/components/Select/Select.test.tsx b/packages/core/src/components/Select/Select.test.tsx
new file mode 100644
index 0000000000..9063804573
--- /dev/null
+++ b/packages/core/src/components/Select/Select.test.tsx
@@ -0,0 +1,58 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { render, fireEvent } from '@testing-library/react';
+
+import { Select } from '.';
+
+const SELECT_ITEMS = [
+  {
+    label: 'test 1',
+    value: 'test_1',
+  },
+  {
+    label: 'test 2',
+    value: 'test_2',
+  },
+];
+
+const minProps = {
+  onChange: jest.fn(),
+  label: 'Default',
+  placeholder: 'All results',
+  items: SELECT_ITEMS,
+};
+
+describe('<Select />', () => {
+  it('renders without exploding', async () => {
+    const { getByText, getByTestId } = render(<Select {...minProps} />);
+
+    expect(getByText('Default')).toBeInTheDocument();
+    const input = await getByTestId('select');
+    expect(input.textContent).toBe('All results');
+
+    // Simulate click on input
+    fireEvent.click(input);
+
+    expect(getByText('test 1')).toBeInTheDocument();
+    const option = getByText('test 1');
+
+    // Simulate click on option
+    fireEvent.click(option);
+    expect(input.textContent).toBe('test 1');
+  });
+});
diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index 4d6ec40ce6..995e33f489 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -150,6 +150,7 @@ export const SelectComponent = (props: SelectProps) => {
         <FormControl className={classes.formControl}>
           <Select
             value={value}
+            data-testid="select"
             displayEmpty
             multiple={multiple}
             onChange={handleChange}

From 2c2f1ad86b9b4fdcfa9ff08bfeb3b3e51ce8a907 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Mon, 21 Sep 2020 16:32:51 +0200
Subject: [PATCH 020/110] fix(core): table styling

---
 packages/core/src/components/Table/Table.tsx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index c2e91109de..a92ce7f15e 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -136,6 +136,7 @@ const useFilterStyles = makeStyles<BackstageTheme>(() => ({
   title: {
     fontWeight: 'bold',
     fontSize: 18,
+    whiteSpace: 'nowrap',
   },
 }));
 
@@ -311,6 +312,7 @@ export function Table<T extends object = {}>({
           </>
         }
         data={tableData}
+        style={{ width: '100%' }}
         {...propsWithoutData}
       />
     </div>

From ea4ebc58b3517869d02e315d0005f2f890b37169 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20DOREAU?= <remi.d45@gmail.com>
Date: Thu, 24 Sep 2020 12:10:37 +0200
Subject: [PATCH 021/110] fix(core): remove multi-select all results option

---
 packages/core/src/components/Select/Select.tsx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/core/src/components/Select/Select.tsx b/packages/core/src/components/Select/Select.tsx
index 995e33f489..a2efcc7725 100644
--- a/packages/core/src/components/Select/Select.tsx
+++ b/packages/core/src/components/Select/Select.tsx
@@ -195,7 +195,9 @@ export const SelectComponent = (props: SelectProps) => {
               getContentAnchorEl: null,
             }}
           >
-            {placeholder && <MenuItem value={[]}>{placeholder}</MenuItem>}
+            {placeholder && !multiple && (
+              <MenuItem value={[]}>{placeholder}</MenuItem>
+            )}
             {items &&
               items.map(item => (
                 <MenuItem id="menu-item" key={item.value} value={item.value}>

From c2cb5a038b5ec9defbcafa9b91da8ab12c22b3ce Mon Sep 17 00:00:00 2001
From: Navaneeth Suresh <navaneeths1998@gmail.com>
Date: Sat, 3 Oct 2020 23:14:01 +0530
Subject: [PATCH 022/110] Prompt about enabling auth providers when creating
 new app

---
 packages/create-app/src/createApp.ts                          | 4 ++++
 packages/create-app/templates/default-app/app-config.yaml.hbs | 1 +
 2 files changed, 5 insertions(+)

diff --git a/packages/create-app/src/createApp.ts b/packages/create-app/src/createApp.ts
index 28e3805ce8..681bdb44f3 100644
--- a/packages/create-app/src/createApp.ts
+++ b/packages/create-app/src/createApp.ts
@@ -148,6 +148,10 @@ export default async (cmd: Command): Promise<void> => {
       chalk.green(`🥇  Successfully created ${chalk.cyan(answers.name)}`),
     );
     Task.log();
+    Task.log(
+      'See https://backstage.io/docs/tutorials/quickstart-app-auth to know more about enabling auth providers',
+    );
+    Task.log();
     Task.exit();
   } catch (error) {
     Task.error(error.message);
diff --git a/packages/create-app/templates/default-app/app-config.yaml.hbs b/packages/create-app/templates/default-app/app-config.yaml.hbs
index f1278bd3c3..6ae2185628 100644
--- a/packages/create-app/templates/default-app/app-config.yaml.hbs
+++ b/packages/create-app/templates/default-app/app-config.yaml.hbs
@@ -55,6 +55,7 @@ lighthouse:
   baseUrl: http://localhost:3003
 
 auth:
+  # see https://backstage.io/docs/tutorials/quickstart-app-auth to know more about enabling auth providers
   providers: {}
 
 scaffolder:

From fba3d513f528720eb314f20ca764b9733a6ab1af Mon Sep 17 00:00:00 2001
From: Iain Billett <iain@roadie.io>
Date: Fri, 25 Sep 2020 10:45:51 +0100
Subject: [PATCH 023/110] Add Lighthouse card & tab

* Add a lighthouse card to be displayed on the website overview
* Add a lighthouse tab and embed lighthouse content
---
 .../app/src/components/catalog/EntityPage.tsx |  15 ++
 plugins/backstage-plugin-travis-ci            |   1 +
 plugins/catalog/src/index.ts                  |   2 +-
 plugins/lighthouse/constants.ts               |  16 ++
 plugins/lighthouse/package.json               |   4 +
 plugins/lighthouse/src/Router.tsx             |  26 ++-
 plugins/lighthouse/src/api.ts                 |   7 +
 .../AuditList/AuditListForEntity.test.tsx     | 144 +++++++++++++++
 .../AuditList/AuditListForEntity.tsx          |  31 ++++
 .../src/components/AuditView/index.tsx        |  51 +++---
 .../Cards/LastLighthouseAuditCard.test.tsx    | 172 ++++++++++++++++++
 .../Cards/LastLighthouseAuditCard.tsx         | 102 +++++++++++
 .../lighthouse/src/components/Cards/index.ts  |  16 ++
 .../src/components/CreateAudit/index.tsx      | 163 +++++++++--------
 .../src/hooks/useWebsiteForEntity.test.tsx    | 100 ++++++++++
 .../src/hooks/useWebsiteForEntity.ts          |  37 ++++
 plugins/lighthouse/src/index.ts               |   3 +-
 yarn.lock                                     |  15 ++
 18 files changed, 795 insertions(+), 110 deletions(-)
 create mode 160000 plugins/backstage-plugin-travis-ci
 create mode 100644 plugins/lighthouse/constants.ts
 create mode 100644 plugins/lighthouse/src/components/AuditList/AuditListForEntity.test.tsx
 create mode 100644 plugins/lighthouse/src/components/AuditList/AuditListForEntity.tsx
 create mode 100644 plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.test.tsx
 create mode 100644 plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx
 create mode 100644 plugins/lighthouse/src/components/Cards/index.ts
 create mode 100644 plugins/lighthouse/src/hooks/useWebsiteForEntity.test.tsx
 create mode 100644 plugins/lighthouse/src/hooks/useWebsiteForEntity.ts

diff --git a/packages/app/src/components/catalog/EntityPage.tsx b/packages/app/src/components/catalog/EntityPage.tsx
index c2483b40ee..393ffe2631 100644
--- a/packages/app/src/components/catalog/EntityPage.tsx
+++ b/packages/app/src/components/catalog/EntityPage.tsx
@@ -49,6 +49,11 @@ import {
 import { Entity } from '@backstage/catalog-model';
 import { Button, Grid } from '@material-ui/core';
 import { EmptyState } from '@backstage/core';
+import {
+  EmbeddedRouter as LighthouseRouter,
+  LastLighthouseAuditCard,
+  isPluginApplicableToEntity as isLighthouseAvailable,
+} from '@backstage/plugin-lighthouse/';
 
 const CICDSwitcher = ({ entity }: { entity: Entity }) => {
   // This component is just an example of how you can implement your company's logic in entity page.
@@ -115,6 +120,11 @@ const OverviewContent = ({ entity }: { entity: Entity }) => (
       <AboutCard entity={entity} />
     </Grid>
     <RecentCICDRunsSwitcher entity={entity} />
+    {isLighthouseAvailable(entity) && (
+      <Grid item sm={4}>
+        <LastLighthouseAuditCard />
+      </Grid>
+    )}
   </Grid>
 );
 
@@ -165,6 +175,11 @@ const WebsiteEntityPage = ({ entity }: { entity: Entity }) => (
       title="CI/CD"
       element={<CICDSwitcher entity={entity} />}
     />
+    <EntityPageLayout.Content
+      path="/lighthouse/*"
+      title="Lighthouse"
+      element={<LighthouseRouter entity={entity} />}
+    />
     <EntityPageLayout.Content
       path="/sentry"
       title="Sentry"
diff --git a/plugins/backstage-plugin-travis-ci b/plugins/backstage-plugin-travis-ci
new file mode 160000
index 0000000000..b70556a6e5
--- /dev/null
+++ b/plugins/backstage-plugin-travis-ci
@@ -0,0 +1 @@
+Subproject commit b70556a6e5476cb64ff5c23123052c79ee926269
diff --git a/plugins/catalog/src/index.ts b/plugins/catalog/src/index.ts
index a6d86e8102..762f4924c0 100644
--- a/plugins/catalog/src/index.ts
+++ b/plugins/catalog/src/index.ts
@@ -20,6 +20,6 @@ export * from './api/types';
 export * from './routes';
 export { useEntityCompoundName } from './components/useEntityCompoundName';
 export { Router } from './components/Router';
-export { useEntity } from './hooks/useEntity';
+export { useEntity, EntityContext } from './hooks/useEntity';
 export { AboutCard } from './components/AboutCard';
 export { EntityPageLayout } from './components/EntityPageLayout';
diff --git a/plugins/lighthouse/constants.ts b/plugins/lighthouse/constants.ts
new file mode 100644
index 0000000000..7a60e2be67
--- /dev/null
+++ b/plugins/lighthouse/constants.ts
@@ -0,0 +1,16 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 const LIGHTHOUSE_WEBSITE_URL_ANNOTATION = 'lighthouse.com/website-url';
diff --git a/plugins/lighthouse/package.json b/plugins/lighthouse/package.json
index 0b30e48689..32e11d71fd 100644
--- a/plugins/lighthouse/package.json
+++ b/plugins/lighthouse/package.json
@@ -21,12 +21,16 @@
     "start": "backstage-cli plugin:serve"
   },
   "dependencies": {
+    "@backstage/catalog-model": "^0.1.1-alpha.24",
     "@backstage/config": "^0.1.1-alpha.24",
     "@backstage/core": "^0.1.1-alpha.24",
+    "@backstage/core-api": "^0.1.1-alpha.24",
+    "@backstage/plugin-catalog": "^0.1.1-alpha.24",
     "@backstage/theme": "^0.1.1-alpha.24",
     "@material-ui/core": "^4.11.0",
     "@material-ui/icons": "^4.9.1",
     "@material-ui/lab": "4.0.0-alpha.45",
+    "@testing-library/react-hooks": "^3.4.2",
     "react": "^16.13.1",
     "react-dom": "^16.13.1",
     "react-markdown": "^4.3.1",
diff --git a/plugins/lighthouse/src/Router.tsx b/plugins/lighthouse/src/Router.tsx
index 46843504fd..576bbf82e1 100644
--- a/plugins/lighthouse/src/Router.tsx
+++ b/plugins/lighthouse/src/Router.tsx
@@ -15,11 +15,18 @@
  */
 
 import React from 'react';
-import { Routes, Route } from 'react-router-dom';
-import { rootRouteRef, viewAuditRouteRef, createAuditRouteRef } from './plugin';
+import { Route, Routes } from 'react-router-dom';
+import { createAuditRouteRef, rootRouteRef, viewAuditRouteRef } from './plugin';
 import AuditList from './components/AuditList';
-import AuditView from './components/AuditView';
-import CreateAudit from './components/CreateAudit';
+import AuditView, { AuditViewContent } from './components/AuditView';
+import CreateAudit, { CreateAuditContent } from './components/CreateAudit';
+import { Entity } from '@backstage/catalog-model';
+import { LIGHTHOUSE_WEBSITE_URL_ANNOTATION } from '../constants';
+import { AuditListForEntity } from './components/AuditList/AuditListForEntity';
+
+export const isPluginApplicableToEntity = (entity: Entity) =>
+  Boolean(entity.metadata.annotations?.[LIGHTHOUSE_WEBSITE_URL_ANNOTATION]) ||
+  entity.metadata.name === 'marketing-site';
 
 export const Router = () => (
   <Routes>
@@ -28,3 +35,14 @@ export const Router = () => (
     <Route path={`/${createAuditRouteRef.path}`} element={<CreateAudit />} />
   </Routes>
 );
+
+export const EmbeddedRouter = () => (
+  <Routes>
+    <Route path={`/${rootRouteRef.path}`} element={<AuditListForEntity />} />
+    <Route path={`/${viewAuditRouteRef.path}`} element={<AuditViewContent />} />
+    <Route
+      path={`/${createAuditRouteRef.path}`}
+      element={<CreateAuditContent />}
+    />
+  </Routes>
+);
diff --git a/plugins/lighthouse/src/api.ts b/plugins/lighthouse/src/api.ts
index 5b6cd9aae7..03b42a38b9 100644
--- a/plugins/lighthouse/src/api.ts
+++ b/plugins/lighthouse/src/api.ts
@@ -104,6 +104,7 @@ export type LighthouseApi = {
   getWebsiteList: (listOptions: LASListRequest) => Promise<WebsiteListResponse>;
   getWebsiteForAuditId: (auditId: string) => Promise<Website>;
   triggerAudit: (payload: TriggerAuditPayload) => Promise<Audit>;
+  getWebsiteByUrl: (websiteUrl: string) => Promise<Website>;
 };
 
 export const lighthouseApiRef = createApiRef<LighthouseApi>({
@@ -150,4 +151,10 @@ export class LighthouseRestApi implements LighthouseApi {
       },
     });
   }
+
+  async getWebsiteByUrl(websiteUrl: string): Promise<Website> {
+    return this.fetch<Website>(
+      `/v1/websites/${encodeURIComponent(websiteUrl)}`,
+    );
+  }
 }
diff --git a/plugins/lighthouse/src/components/AuditList/AuditListForEntity.test.tsx b/plugins/lighthouse/src/components/AuditList/AuditListForEntity.test.tsx
new file mode 100644
index 0000000000..7f10914d9c
--- /dev/null
+++ b/plugins/lighthouse/src/components/AuditList/AuditListForEntity.test.tsx
@@ -0,0 +1,144 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { render } from '@testing-library/react';
+import { ApiProvider, ApiRegistry, errorApiRef } from '@backstage/core';
+import {
+  lighthouseApiRef,
+  LighthouseRestApi,
+  WebsiteListResponse,
+} from '../../api';
+import mockFetch from 'jest-fetch-mock';
+
+import * as data from '../../__fixtures__/website-list-response.json';
+import { EntityContext } from '@backstage/plugin-catalog';
+import { Entity } from '@backstage/catalog-model';
+import { AuditListForEntity } from './AuditListForEntity';
+import { lightTheme } from '@backstage/theme';
+import { ThemeProvider } from '@material-ui/core';
+import { MemoryRouter } from 'react-router-dom';
+import { useWebsiteForEntity } from '../../hooks/useWebsiteForEntity';
+
+jest.mock('../../hooks/useWebsiteForEntity', () => ({
+  useWebsiteForEntity: jest.fn(),
+}));
+
+const websiteListResponse = data as WebsiteListResponse;
+const entityWebsite = websiteListResponse.items[0];
+
+describe('<AuditListTableForEntity />', () => {
+  let apis: ApiRegistry;
+
+  const mockErrorApi: jest.Mocked<typeof errorApiRef.T> = {
+    post: jest.fn(),
+    error$: jest.fn(),
+  };
+
+  beforeEach(() => {
+    apis = ApiRegistry.from([
+      [lighthouseApiRef, new LighthouseRestApi('http://lighthouse')],
+      [errorApiRef, mockErrorApi],
+    ]);
+    mockFetch.mockResponse(JSON.stringify(entityWebsite));
+    (useWebsiteForEntity as jest.Mock).mockReturnValue({
+      value: entityWebsite,
+      loading: false,
+      error: null,
+    });
+  });
+
+  const entity: Entity = {
+    apiVersion: 'v1',
+    kind: 'Component',
+    metadata: {
+      name: 'software',
+      annotations: {
+        'lighthouse.com/website-url': entityWebsite.url,
+      },
+    },
+    spec: {
+      owner: 'guest',
+      type: 'Website',
+      lifecycle: 'development',
+    },
+  };
+
+  const subject = (value = {}) =>
+    render(
+      <ThemeProvider theme={lightTheme}>
+        <MemoryRouter>
+          <ApiProvider apis={apis}>
+            <EntityContext.Provider
+              value={{ entity: entity, loading: false, ...value }}
+            >
+              <AuditListForEntity />
+            </EntityContext.Provider>
+          </ApiProvider>
+        </MemoryRouter>
+      </ThemeProvider>,
+    );
+
+  it('renders the audit list for the entity', async () => {
+    const { findByText } = subject();
+    expect(await findByText(entityWebsite.url)).toBeInTheDocument();
+  });
+
+  describe('where the data is loading', () => {
+    beforeEach(() => {
+      (useWebsiteForEntity as jest.Mock).mockReturnValue({
+        value: null,
+        loading: true,
+        error: null,
+      });
+    });
+
+    it('renders a Progress element', async () => {
+      const { findByTestId } = subject();
+      expect(await findByTestId('progress')).toBeInTheDocument();
+    });
+  });
+
+  describe('where there is an error loading data', () => {
+    beforeEach(() => {
+      (useWebsiteForEntity as jest.Mock).mockReturnValue({
+        value: null,
+        loading: false,
+        error: 'error',
+      });
+    });
+
+    it('renders nothing', async () => {
+      const { queryByTestId } = subject();
+      expect(await queryByTestId('AuditListTable')).toBeNull();
+    });
+  });
+
+  describe('where there is not data', () => {
+    beforeEach(() => {
+      (useWebsiteForEntity as jest.Mock).mockReturnValue({
+        value: null,
+        loading: false,
+        error: null,
+      });
+    });
+
+    it('renders nothing', async () => {
+      const { queryByTestId } = subject();
+      expect(await queryByTestId('AuditListTable')).toBeNull();
+    });
+  });
+});
diff --git a/plugins/lighthouse/src/components/AuditList/AuditListForEntity.tsx b/plugins/lighthouse/src/components/AuditList/AuditListForEntity.tsx
new file mode 100644
index 0000000000..616fd0fa8a
--- /dev/null
+++ b/plugins/lighthouse/src/components/AuditList/AuditListForEntity.tsx
@@ -0,0 +1,31 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { AuditListTable } from './AuditListTable';
+import { Progress } from '@backstage/core';
+import { useWebsiteForEntity } from '../../hooks/useWebsiteForEntity';
+
+export const AuditListForEntity = () => {
+  const { value, loading, error } = useWebsiteForEntity();
+  if (loading) {
+    return <Progress />;
+  }
+  if (error || !value) {
+    return null;
+  }
+
+  return <AuditListTable data-test-id="AuditListTable" items={[value]} />;
+};
diff --git a/plugins/lighthouse/src/components/AuditView/index.tsx b/plugins/lighthouse/src/components/AuditView/index.tsx
index d0e743a77f..54bd179418 100644
--- a/plugins/lighthouse/src/components/AuditView/index.tsx
+++ b/plugins/lighthouse/src/components/AuditView/index.tsx
@@ -124,7 +124,7 @@ const AuditView: FC<{ audit?: Audit }> = ({ audit }: { audit?: Audit }) => {
   );
 };
 
-const ConnectedAuditView: FC<{}> = () => {
+export const AuditViewContent: FC<{}> = () => {
   const lighthouseApi = useApi(lighthouseApiRef);
   const params = useParams() as { id: string };
   const classes = useStyles();
@@ -173,32 +173,35 @@ const ConnectedAuditView: FC<{}> = () => {
   }
 
   return (
-    <Page theme={pageTheme.tool}>
-      <Header
-        title="Lighthouse"
-        subtitle="Website audits powered by Lighthouse"
+    <>
+      <ContentHeader
+        title={value?.url || 'Audit'}
+        description="See a history of all Lighthouse audits for your website run through Backstage."
       >
-        <HeaderLabel label="Owner" value="Spotify" />
-        <HeaderLabel label="Lifecycle" value="Alpha" />
-      </Header>
-      <Content stretch>
-        <ContentHeader
-          title={value?.url || 'Audit'}
-          description="See a history of all Lighthouse audits for your website run through Backstage."
+        <Button
+          variant="contained"
+          color="primary"
+          onClick={() => navigate(`../../${createAuditButtonUrl}`)}
         >
-          <Button
-            variant="contained"
-            color="primary"
-            onClick={() => navigate(`../../${createAuditButtonUrl}`)}
-          >
-            Create New Audit
-          </Button>
-          <LighthouseSupportButton />
-        </ContentHeader>
-        {content}
-      </Content>
-    </Page>
+          Create New Audit
+        </Button>
+        <LighthouseSupportButton />
+      </ContentHeader>
+      {content}
+    </>
   );
 };
 
+const ConnectedAuditView = () => (
+  <Page theme={pageTheme.tool}>
+    <Header title="Lighthouse" subtitle="Website audits powered by Lighthouse">
+      <HeaderLabel label="Owner" value="Spotify" />
+      <HeaderLabel label="Lifecycle" value="Alpha" />
+    </Header>
+    <Content stretch>
+      <AuditViewContent />
+    </Content>
+  </Page>
+);
+
 export default ConnectedAuditView;
diff --git a/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.test.tsx b/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.test.tsx
new file mode 100644
index 0000000000..20b3b9c072
--- /dev/null
+++ b/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.test.tsx
@@ -0,0 +1,172 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { render } from '@testing-library/react';
+import {
+  AuditCompleted,
+  LighthouseCategoryId,
+  WebsiteListResponse,
+} from '../../api';
+import { EntityContext } from '@backstage/plugin-catalog';
+import { Entity } from '@backstage/catalog-model';
+import { LastLighthouseAuditCard } from './LastLighthouseAuditCard';
+import { lightTheme } from '@backstage/theme';
+import { ThemeProvider } from '@material-ui/core';
+import { useWebsiteForEntity } from '../../hooks/useWebsiteForEntity';
+import { MemoryRouter } from 'react-router-dom';
+import * as data from '../../__fixtures__/website-list-response.json';
+
+jest.mock('../../hooks/useWebsiteForEntity', () => ({
+  useWebsiteForEntity: jest.fn(),
+}));
+
+const websiteListResponse = data as WebsiteListResponse;
+let entityWebsite = websiteListResponse.items[2];
+
+describe('<LastLighthouseAuditCard />', () => {
+  const asPercentage = (fraction: number) => `${fraction * 100}%`;
+
+  beforeEach(() => {
+    (useWebsiteForEntity as jest.Mock).mockReturnValue({
+      value: entityWebsite,
+      loading: false,
+      error: null,
+    });
+  });
+
+  const entity: Entity = {
+    apiVersion: 'v1',
+    kind: 'Component',
+    metadata: {
+      name: 'software',
+      annotations: {
+        'lighthouse.com/website-url': entityWebsite.url,
+      },
+    },
+    spec: {
+      owner: 'guest',
+      type: 'Website',
+      lifecycle: 'development',
+    },
+  };
+
+  const subject = (value = {}) =>
+    render(
+      <ThemeProvider theme={lightTheme}>
+        <MemoryRouter>
+          <EntityContext.Provider
+            value={{ entity: entity, loading: false, ...value }}
+          >
+            <LastLighthouseAuditCard />
+          </EntityContext.Provider>
+        </MemoryRouter>
+      </ThemeProvider>,
+    );
+
+  describe('where the last audit completed successfully', () => {
+    const audit = entityWebsite.lastAudit as AuditCompleted;
+
+    it('renders the performance data for the audit', async () => {
+      const { findByText } = subject();
+      expect(await findByText(audit.url)).toBeInTheDocument();
+      expect(await findByText(audit.status)).toBeInTheDocument();
+      for (const category of Object.keys(audit.categories)) {
+        const { score } = audit.categories[category as LighthouseCategoryId];
+        expect(await findByText(asPercentage(score))).toBeInTheDocument();
+      }
+    });
+
+    describe('where a category score is not a number', () => {
+      beforeEach(() => {
+        entityWebsite = { ...entityWebsite };
+        (entityWebsite.lastAudit as AuditCompleted).categories.accessibility.score = NaN;
+      });
+
+      afterEach(() => {
+        entityWebsite = websiteListResponse.items[2];
+      });
+
+      it('renders the performance data for the audit', async () => {
+        const { findByText } = subject();
+        expect(await findByText('N/A')).toBeInTheDocument();
+      });
+    });
+  });
+
+  describe('where the last audit is in running', () => {
+    const audit = websiteListResponse.items[0].lastAudit as AuditCompleted;
+
+    beforeEach(() => {
+      (useWebsiteForEntity as jest.Mock).mockReturnValue({
+        value: websiteListResponse.items[0],
+        loading: false,
+        error: null,
+      });
+    });
+
+    it('renders the url and status of the audit', async () => {
+      const { findByText } = subject();
+      expect(await findByText(audit.url)).toBeInTheDocument();
+      expect(await findByText(audit.status)).toBeInTheDocument();
+    });
+  });
+
+  describe('where the data is loading', () => {
+    beforeEach(() => {
+      (useWebsiteForEntity as jest.Mock).mockReturnValue({
+        value: null,
+        loading: true,
+        error: null,
+      });
+    });
+
+    it('renders a Progress element', async () => {
+      const { findByTestId } = subject();
+      expect(await findByTestId('progress')).toBeInTheDocument();
+    });
+  });
+
+  describe('where there is an error loading data', () => {
+    beforeEach(() => {
+      (useWebsiteForEntity as jest.Mock).mockReturnValue({
+        value: null,
+        loading: false,
+        error: 'error',
+      });
+    });
+
+    it('renders nothing', async () => {
+      const { queryByTestId } = subject();
+      expect(await queryByTestId('AuditListTable')).toBeNull();
+    });
+  });
+  //
+  describe('where there is no data', () => {
+    beforeEach(() => {
+      (useWebsiteForEntity as jest.Mock).mockReturnValue({
+        value: null,
+        loading: false,
+        error: null,
+      });
+    });
+
+    it('renders nothing', async () => {
+      const { queryByTestId } = subject();
+      expect(await queryByTestId('AuditListTable')).toBeNull();
+    });
+  });
+});
diff --git a/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx b/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx
new file mode 100644
index 0000000000..d82e6c5c6c
--- /dev/null
+++ b/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx
@@ -0,0 +1,102 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React, { FC } from 'react';
+import { Audit, AuditCompleted, LighthouseCategoryId } from '../../api';
+import {
+  InfoCard,
+  Progress,
+  StatusError,
+  StatusOK,
+  StatusWarning,
+  StructuredMetadataTable,
+} from '@backstage/core';
+import { useWebsiteForEntity } from '../../hooks/useWebsiteForEntity';
+import AuditStatusIcon from '../AuditStatusIcon';
+
+const LighthouseCategoryScoreStatus: FC<{ score: number }> = ({ score }) => {
+  const scoreAsPercentage = score * 100;
+  switch (true) {
+    case scoreAsPercentage >= 90:
+      return (
+        <>
+          <StatusOK />
+          {scoreAsPercentage}%
+        </>
+      );
+    case scoreAsPercentage >= 50 && scoreAsPercentage < 90:
+      return (
+        <>
+          <StatusWarning />
+          {scoreAsPercentage}%
+        </>
+      );
+    case scoreAsPercentage < 50:
+      return (
+        <>
+          <StatusError />
+          {scoreAsPercentage}%
+        </>
+      );
+    default:
+      return <span>N/A</span>;
+  }
+};
+
+const LighthouseAuditStatus: FC<{ audit: Audit }> = ({ audit }) => (
+  <>
+    <AuditStatusIcon audit={audit} />
+    {audit.status.toUpperCase()}
+  </>
+);
+
+const LighthouseAuditSummary: FC<{ audit: Audit }> = ({ audit }) => {
+  const { url } = audit;
+  const flattenedCategoryData: Record<string, React.ReactNode> = {};
+  if (audit.status === 'COMPLETED') {
+    const categories = (audit as AuditCompleted).categories;
+    const categoryIds = Object.keys(categories) as LighthouseCategoryId[];
+    categoryIds.forEach((id: LighthouseCategoryId) => {
+      const { title, score } = categories[id];
+
+      flattenedCategoryData[title] = (
+        <LighthouseCategoryScoreStatus score={score} />
+      );
+    });
+  }
+  const tableData = {
+    url,
+    status: <LighthouseAuditStatus audit={audit} />,
+    ...flattenedCategoryData,
+  };
+
+  return <StructuredMetadataTable metadata={tableData} />;
+};
+
+export const LastLighthouseAuditCard: FC<{}> = () => {
+  const { value: website, loading, error } = useWebsiteForEntity();
+
+  let content;
+  if (loading) {
+    content = <Progress />;
+  }
+  if (error) {
+    content = null;
+  }
+  if (website) {
+    content = <LighthouseAuditSummary audit={website.lastAudit} />;
+  }
+  return <InfoCard title="Lighthouse Audit">{content}</InfoCard>;
+};
diff --git a/plugins/lighthouse/src/components/Cards/index.ts b/plugins/lighthouse/src/components/Cards/index.ts
new file mode 100644
index 0000000000..7595619808
--- /dev/null
+++ b/plugins/lighthouse/src/components/Cards/index.ts
@@ -0,0 +1,16 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { LastLighthouseAuditCard } from './LastLighthouseAuditCard';
diff --git a/plugins/lighthouse/src/components/CreateAudit/index.tsx b/plugins/lighthouse/src/components/CreateAudit/index.tsx
index 36bd97485a..ad46b06020 100644
--- a/plugins/lighthouse/src/components/CreateAudit/index.tsx
+++ b/plugins/lighthouse/src/components/CreateAudit/index.tsx
@@ -53,7 +53,7 @@ const useStyles = makeStyles(theme => ({
   },
 }));
 
-const CreateAudit: FC<{}> = () => {
+export const CreateAuditContent: FC<{}> = () => {
   const errorApi = useApi(errorApiRef);
   const lighthouseApi = useApi(lighthouseApiRef);
   const classes = useStyles();
@@ -94,88 +94,91 @@ const CreateAudit: FC<{}> = () => {
   ]);
 
   return (
-    <Page theme={pageTheme.tool}>
-      <Header
-        title="Lighthouse"
-        subtitle="Website audits powered by Lighthouse"
+    <>
+      <ContentHeader
+        title="Trigger a new audit"
+        description="Submitting this form will immediately trigger and store a new Lighthouse audit. Trigger audits to track your website's accessibility, performance, SEO, and best practices over time."
       >
-        <HeaderLabel label="Owner" value="Spotify" />
-        <HeaderLabel label="Lifecycle" value="Alpha" />
-      </Header>
-      <Content>
-        <ContentHeader
-          title="Trigger a new audit"
-          description="Submitting this form will immediately trigger and store a new Lighthouse audit. Trigger audits to track your website's accessibility, performance, SEO, and best practices over time."
-        >
-          <LighthouseSupportButton />
-        </ContentHeader>
-        <Grid container direction="column">
-          <Grid item xs={12} sm={6}>
-            <InfoCard>
-              <form
-                onSubmit={ev => {
-                  ev.preventDefault();
-                  triggerAudit();
-                }}
-              >
-                <List>
-                  <ListItem>
-                    <TextField
-                      name="lighthouse-create-audit-url-tf"
-                      className={classes.input}
-                      label="URL"
-                      placeholder="https://spotify.com"
-                      helperText="The target URL for Lighthouse to use."
-                      required
-                      disabled={submitting}
-                      onChange={ev => setUrl(ev.target.value)}
-                      value={url}
-                      inputProps={{ 'aria-label': 'URL' }}
-                    />
-                  </ListItem>
-                  <ListItem>
-                    <TextField
-                      name="lighthouse-create-audit-emulated-form-factor-tf"
-                      className={classes.input}
-                      label="Emulated Form Factor"
-                      helperText="Device to simulate when auditing"
-                      select
-                      required
-                      disabled={submitting}
-                      onChange={ev => setEmulatedFormFactor(ev.target.value)}
-                      value={emulatedFormFactor}
-                      inputProps={{ 'aria-label': 'Emulated form factor' }}
-                    >
-                      <MenuItem value="mobile">Mobile</MenuItem>
-                      <MenuItem value="desktop">Desktop</MenuItem>
-                    </TextField>
-                  </ListItem>
-                  <ListItem className={classes.buttonList}>
-                    <Button
-                      variant="outlined"
-                      color="primary"
-                      onClick={() => navigate('..')}
-                      disabled={submitting}
-                    >
-                      Cancel
-                    </Button>
-                    <Button
-                      variant="contained"
-                      color="primary"
-                      type="submit"
-                      disabled={submitting}
-                    >
-                      Create Audit
-                    </Button>
-                  </ListItem>
-                </List>
-              </form>
-            </InfoCard>
-          </Grid>
+        <LighthouseSupportButton />
+      </ContentHeader>
+      <Grid container direction="column">
+        <Grid item xs={12} sm={6}>
+          <InfoCard>
+            <form
+              onSubmit={ev => {
+                ev.preventDefault();
+                triggerAudit();
+              }}
+            >
+              <List>
+                <ListItem>
+                  <TextField
+                    name="lighthouse-create-audit-url-tf"
+                    className={classes.input}
+                    label="URL"
+                    placeholder="https://spotify.com"
+                    helperText="The target URL for Lighthouse to use."
+                    required
+                    disabled={submitting}
+                    onChange={ev => setUrl(ev.target.value)}
+                    value={url}
+                    inputProps={{ 'aria-label': 'URL' }}
+                  />
+                </ListItem>
+                <ListItem>
+                  <TextField
+                    name="lighthouse-create-audit-emulated-form-factor-tf"
+                    className={classes.input}
+                    label="Emulated Form Factor"
+                    helperText="Device to simulate when auditing"
+                    select
+                    required
+                    disabled={submitting}
+                    onChange={ev => setEmulatedFormFactor(ev.target.value)}
+                    value={emulatedFormFactor}
+                    inputProps={{ 'aria-label': 'Emulated form factor' }}
+                  >
+                    <MenuItem value="mobile">Mobile</MenuItem>
+                    <MenuItem value="desktop">Desktop</MenuItem>
+                  </TextField>
+                </ListItem>
+                <ListItem className={classes.buttonList}>
+                  <Button
+                    variant="outlined"
+                    color="primary"
+                    onClick={() => navigate('..')}
+                    disabled={submitting}
+                  >
+                    Cancel
+                  </Button>
+                  <Button
+                    variant="contained"
+                    color="primary"
+                    type="submit"
+                    disabled={submitting}
+                  >
+                    Create Audit
+                  </Button>
+                </ListItem>
+              </List>
+            </form>
+          </InfoCard>
         </Grid>
-      </Content>
-    </Page>
+      </Grid>
+    </>
   );
 };
 
+const CreateAudit = () => (
+  <Page theme={pageTheme.tool}>
+    <Header title="Lighthouse" subtitle="Website audits powered by Lighthouse">
+      <HeaderLabel label="Owner" value="Spotify" />
+      <HeaderLabel label="Lifecycle" value="Alpha" />
+    </Header>
+    <Content>
+      <CreateAuditContent />
+    </Content>
+  </Page>
+);
+
 export default CreateAudit;
diff --git a/plugins/lighthouse/src/hooks/useWebsiteForEntity.test.tsx b/plugins/lighthouse/src/hooks/useWebsiteForEntity.test.tsx
new file mode 100644
index 0000000000..868e26f04c
--- /dev/null
+++ b/plugins/lighthouse/src/hooks/useWebsiteForEntity.test.tsx
@@ -0,0 +1,100 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { renderHook } from '@testing-library/react-hooks';
+import { ApiProvider, ApiRegistry, errorApiRef } from '@backstage/core-api';
+import { lighthouseApiRef, WebsiteListResponse } from '../api';
+import { useWebsiteForEntity } from './useWebsiteForEntity';
+import { EntityContext } from '@backstage/plugin-catalog';
+import { Entity } from '@backstage/catalog-model';
+import * as data from '../__fixtures__/website-list-response.json';
+
+const websiteListResponse = data as WebsiteListResponse;
+const website = websiteListResponse.items[0];
+
+const mockErrorApi: jest.Mocked<typeof errorApiRef.T> = {
+  post: jest.fn(),
+  error$: jest.fn(),
+};
+
+const mockLighthouseApi: jest.Mocked<Partial<typeof lighthouseApiRef.T>> = {
+  getWebsiteByUrl: jest.fn(),
+};
+
+describe('useWebsiteForEntity', () => {
+  const entity: Entity = {
+    apiVersion: 'v1',
+    kind: 'Component',
+    metadata: {
+      name: 'software',
+      annotations: {
+        'lighthouse.com/website-url': website.url,
+      },
+    },
+    spec: {
+      owner: 'guest',
+      type: 'Website',
+      lifecycle: 'development',
+    },
+  };
+
+  const wrapper: React.FC<{}> = ({ children }) => {
+    return (
+      <ApiProvider
+        apis={ApiRegistry.with(errorApiRef, mockErrorApi).with(
+          lighthouseApiRef,
+          mockLighthouseApi,
+        )}
+      >
+        <EntityContext.Provider value={{ entity: entity, loading: false }}>
+          {children}
+        </EntityContext.Provider>
+      </ApiProvider>
+    );
+  };
+
+  const subject = () =>
+    renderHook(useWebsiteForEntity, {
+      wrapper,
+    });
+
+  beforeEach(() => {
+    (mockLighthouseApi.getWebsiteByUrl as jest.Mock).mockResolvedValue(website);
+  });
+
+  it('returns the lighthouse information for the website url in annotations ', async () => {
+    const { result, waitForNextUpdate } = subject();
+    await waitForNextUpdate();
+    expect(result.current?.value).toBe(website);
+  });
+
+  describe('where there is an error', () => {
+    const error = new Error('useWebsiteForEntity unit test');
+
+    beforeEach(() => {
+      (mockLighthouseApi.getWebsiteByUrl as jest.Mock).mockRejectedValueOnce(
+        error,
+      );
+    });
+
+    it('posts the error to the error api and returns the error to the caller', async () => {
+      const { result, waitForNextUpdate } = subject();
+      await waitForNextUpdate();
+      expect(result.current?.error).toBe(error);
+      expect(mockErrorApi.post).toHaveBeenCalledWith(error);
+    });
+  });
+});
diff --git a/plugins/lighthouse/src/hooks/useWebsiteForEntity.ts b/plugins/lighthouse/src/hooks/useWebsiteForEntity.ts
new file mode 100644
index 0000000000..c52e38f473
--- /dev/null
+++ b/plugins/lighthouse/src/hooks/useWebsiteForEntity.ts
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { useEntity } from '@backstage/plugin-catalog';
+import { LIGHTHOUSE_WEBSITE_URL_ANNOTATION } from '../../constants';
+import { errorApiRef, useApi } from '@backstage/core-api';
+import { lighthouseApiRef } from '../api';
+import { useAsync } from 'react-use';
+
+// For the sake of simplicity we assume that an entity has only one website url. This is to avoid encoding a list
+// type in an annotation which is a plain string.
+export const useWebsiteForEntity = () => {
+  const { entity } = useEntity();
+  const websiteUrl =
+    entity.metadata.annotations?.[LIGHTHOUSE_WEBSITE_URL_ANNOTATION] ?? '';
+  const lighthouseApi = useApi(lighthouseApiRef);
+  const errorApi = useApi(errorApiRef);
+  const response = useAsync(() => lighthouseApi.getWebsiteByUrl(websiteUrl), [
+    websiteUrl,
+  ]);
+  if (response.error) {
+    errorApi.post(response.error);
+  }
+  return response;
+};
diff --git a/plugins/lighthouse/src/index.ts b/plugins/lighthouse/src/index.ts
index bebdaaf713..64fe2f8cc0 100644
--- a/plugins/lighthouse/src/index.ts
+++ b/plugins/lighthouse/src/index.ts
@@ -15,5 +15,6 @@
  */
 
 export { plugin } from './plugin';
-export { Router } from './Router';
+export { Router, isPluginApplicableToEntity, EmbeddedRouter } from './Router';
 export * from './api';
+export * from './components/Cards';
diff --git a/yarn.lock b/yarn.lock
index a3b64f0650..832a5afc86 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -4510,6 +4510,14 @@
     "@babel/runtime" "^7.5.4"
     "@types/testing-library__react-hooks" "^3.3.0"
 
+"@testing-library/react-hooks@^3.4.2":
+  version "3.4.2"
+  resolved "https://registry.npmjs.org/@testing-library/react-hooks/-/react-hooks-3.4.2.tgz#8deb94f7684e0d896edd84a4c90e5b79a0810bc2"
+  integrity sha512-RfPG0ckOzUIVeIqlOc1YztKgFW+ON8Y5xaSPbiBkfj9nMkkiLhLeBXT5icfPX65oJV/zCZu4z8EVnUc6GY9C5A==
+  dependencies:
+    "@babel/runtime" "^7.5.4"
+    "@types/testing-library__react-hooks" "^3.4.0"
+
 "@testing-library/react@^10.4.1":
   version "10.4.3"
   resolved "https://registry.npmjs.org/@testing-library/react/-/react-10.4.3.tgz#c6f356688cffc51f6b35385583d664bb11a161f4"
@@ -5622,6 +5630,13 @@
   dependencies:
     "@types/react-test-renderer" "*"
 
+"@types/testing-library__react-hooks@^3.4.0":
+  version "3.4.1"
+  resolved "https://registry.npmjs.org/@types/testing-library__react-hooks/-/testing-library__react-hooks-3.4.1.tgz#b8d7311c6c1f7db3103e94095fe901f8fef6e433"
+  integrity sha512-G4JdzEcq61fUyV6wVW9ebHWEiLK2iQvaBuCHHn9eMSbZzVh4Z4wHnUGIvQOYCCYeu5DnUtFyNYuAAgbSaO/43Q==
+  dependencies:
+    "@types/react-test-renderer" "*"
+
 "@types/through@*":
   version "0.0.30"
   resolved "https://registry.npmjs.org/@types/through/-/through-0.0.30.tgz#e0e42ce77e897bd6aead6f6ea62aeb135b8a3895"

From 4758e62c26f2882d34992b89a2cb48ab36ba40d8 Mon Sep 17 00:00:00 2001
From: Iain Billett <iain@roadie.io>
Date: Sat, 3 Oct 2020 17:23:29 +0100
Subject: [PATCH 024/110] Add EmptyState to Lighthouse Router

---
 plugins/lighthouse/package.json   |  3 ++-
 plugins/lighthouse/src/Router.tsx | 29 ++++++++++++++++++++---------
 yarn.lock                         | 13 +++++++++++++
 3 files changed, 35 insertions(+), 10 deletions(-)

diff --git a/plugins/lighthouse/package.json b/plugins/lighthouse/package.json
index 32e11d71fd..fb3a6bcf30 100644
--- a/plugins/lighthouse/package.json
+++ b/plugins/lighthouse/package.json
@@ -35,7 +35,8 @@
     "react-dom": "^16.13.1",
     "react-markdown": "^4.3.1",
     "react-router-dom": "6.0.0-beta.0",
-    "react-use": "^15.3.3"
+    "react-use": "^15.3.3",
+    "@types/react": "^16.9.50"
   },
   "devDependencies": {
     "@backstage/cli": "^0.1.1-alpha.24",
diff --git a/plugins/lighthouse/src/Router.tsx b/plugins/lighthouse/src/Router.tsx
index 576bbf82e1..6036d9954d 100644
--- a/plugins/lighthouse/src/Router.tsx
+++ b/plugins/lighthouse/src/Router.tsx
@@ -23,6 +23,7 @@ import CreateAudit, { CreateAuditContent } from './components/CreateAudit';
 import { Entity } from '@backstage/catalog-model';
 import { LIGHTHOUSE_WEBSITE_URL_ANNOTATION } from '../constants';
 import { AuditListForEntity } from './components/AuditList/AuditListForEntity';
+import { EmptyState } from '@backstage/core';
 
 export const isPluginApplicableToEntity = (entity: Entity) =>
   Boolean(entity.metadata.annotations?.[LIGHTHOUSE_WEBSITE_URL_ANNOTATION]) ||
@@ -36,13 +37,23 @@ export const Router = () => (
   </Routes>
 );
 
-export const EmbeddedRouter = () => (
-  <Routes>
-    <Route path={`/${rootRouteRef.path}`} element={<AuditListForEntity />} />
-    <Route path={`/${viewAuditRouteRef.path}`} element={<AuditViewContent />} />
-    <Route
-      path={`/${createAuditRouteRef.path}`}
-      element={<CreateAuditContent />}
+export const EmbeddedRouter = ({ entity }: { entity: Entity }) =>
+  !isPluginApplicableToEntity(entity) ? (
+    <EmptyState
+      missing="field"
+      title="Your plugin is missing an annotation"
+      description={`Please add the ${LIGHTHOUSE_WEBSITE_URL_ANNOTATION} annotation`}
     />
-  </Routes>
-);
+  ) : (
+    <Routes>
+      <Route path={`/${rootRouteRef.path}`} element={<AuditListForEntity />} />
+      <Route
+        path={`/${viewAuditRouteRef.path}`}
+        element={<AuditViewContent />}
+      />
+      <Route
+        path={`/${createAuditRouteRef.path}`}
+        element={<CreateAuditContent />}
+      />
+    </Routes>
+  );
diff --git a/yarn.lock b/yarn.lock
index 832a5afc86..d11ca34aec 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -5430,6 +5430,14 @@
   dependencies:
     csstype "^2.2.0"
 
+"@types/react@^16.9.50":
+  version "16.9.50"
+  resolved "https://registry.npmjs.org/@types/react/-/react-16.9.50.tgz#cb5f2c22d42de33ca1f5efc6a0959feb784a3a2d"
+  integrity sha512-kPx5YsNnKDJejTk1P+lqThwxN2PczrocwsvqXnjvVvKpFescoY62ZiM3TV7dH1T8lFhlHZF+PE5xUyimUwqEGA==
+  dependencies:
+    "@types/prop-types" "*"
+    csstype "^3.0.2"
+
 "@types/reactcss@*":
   version "1.2.3"
   resolved "https://registry.npmjs.org/@types/reactcss/-/reactcss-1.2.3.tgz#af28ae11bbb277978b99d04d1eedfd068ca71834"
@@ -9316,6 +9324,11 @@ csstype@^2.2.0, csstype@^2.5.2, csstype@^2.5.5, csstype@^2.5.7, csstype@^2.6.5,
   resolved "https://registry.npmjs.org/csstype/-/csstype-2.6.9.tgz#05141d0cd557a56b8891394c1911c40c8a98d098"
   integrity sha512-xz39Sb4+OaTsULgUERcCk+TJj8ylkL4aSVDQiX/ksxbELSqwkgt4d4RD7fovIdgJGSuNYqwZEiVjYY5l0ask+Q==
 
+csstype@^3.0.2:
+  version "3.0.3"
+  resolved "https://registry.npmjs.org/csstype/-/csstype-3.0.3.tgz#2b410bbeba38ba9633353aff34b05d9755d065f8"
+  integrity sha512-jPl+wbWPOWJ7SXsWyqGRk3lGecbar0Cb0OvZF/r/ZU011R4YqiRehgkQ9p4eQfo9DSDLqLL3wHwfxeJiuIsNag==
+
 csv-generate@^3.2.4:
   version "3.2.4"
   resolved "https://registry.npmjs.org/csv-generate/-/csv-generate-3.2.4.tgz#440dab9177339ee0676c9e5c16f50e2b3463c019"

From 5b52d983e32c9124990ca0b5ce13164da1cac095 Mon Sep 17 00:00:00 2001
From: Iain Billett <iain@roadie.io>
Date: Sat, 3 Oct 2020 19:30:12 +0100
Subject: [PATCH 025/110] Fix @types/react dependency version

---
 plugins/lighthouse/package.json |  2 +-
 yarn.lock                       | 13 -------------
 2 files changed, 1 insertion(+), 14 deletions(-)

diff --git a/plugins/lighthouse/package.json b/plugins/lighthouse/package.json
index fb3a6bcf30..7446f09ed4 100644
--- a/plugins/lighthouse/package.json
+++ b/plugins/lighthouse/package.json
@@ -36,7 +36,7 @@
     "react-markdown": "^4.3.1",
     "react-router-dom": "6.0.0-beta.0",
     "react-use": "^15.3.3",
-    "@types/react": "^16.9.50"
+    "@types/react": "^16.9"
   },
   "devDependencies": {
     "@backstage/cli": "^0.1.1-alpha.24",
diff --git a/yarn.lock b/yarn.lock
index d11ca34aec..832a5afc86 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -5430,14 +5430,6 @@
   dependencies:
     csstype "^2.2.0"
 
-"@types/react@^16.9.50":
-  version "16.9.50"
-  resolved "https://registry.npmjs.org/@types/react/-/react-16.9.50.tgz#cb5f2c22d42de33ca1f5efc6a0959feb784a3a2d"
-  integrity sha512-kPx5YsNnKDJejTk1P+lqThwxN2PczrocwsvqXnjvVvKpFescoY62ZiM3TV7dH1T8lFhlHZF+PE5xUyimUwqEGA==
-  dependencies:
-    "@types/prop-types" "*"
-    csstype "^3.0.2"
-
 "@types/reactcss@*":
   version "1.2.3"
   resolved "https://registry.npmjs.org/@types/reactcss/-/reactcss-1.2.3.tgz#af28ae11bbb277978b99d04d1eedfd068ca71834"
@@ -9324,11 +9316,6 @@ csstype@^2.2.0, csstype@^2.5.2, csstype@^2.5.5, csstype@^2.5.7, csstype@^2.6.5,
   resolved "https://registry.npmjs.org/csstype/-/csstype-2.6.9.tgz#05141d0cd557a56b8891394c1911c40c8a98d098"
   integrity sha512-xz39Sb4+OaTsULgUERcCk+TJj8ylkL4aSVDQiX/ksxbELSqwkgt4d4RD7fovIdgJGSuNYqwZEiVjYY5l0ask+Q==
 
-csstype@^3.0.2:
-  version "3.0.3"
-  resolved "https://registry.npmjs.org/csstype/-/csstype-3.0.3.tgz#2b410bbeba38ba9633353aff34b05d9755d065f8"
-  integrity sha512-jPl+wbWPOWJ7SXsWyqGRk3lGecbar0Cb0OvZF/r/ZU011R4YqiRehgkQ9p4eQfo9DSDLqLL3wHwfxeJiuIsNag==
-
 csv-generate@^3.2.4:
   version "3.2.4"
   resolved "https://registry.npmjs.org/csv-generate/-/csv-generate-3.2.4.tgz#440dab9177339ee0676c9e5c16f50e2b3463c019"

From 79379097f7ce3167d937809bf58058f71ccd0b7a Mon Sep 17 00:00:00 2001
From: Iain Billett <iain@roadie.io>
Date: Sun, 4 Oct 2020 13:49:58 +0100
Subject: [PATCH 026/110] Update Lighthouse plugin README

Add instructions for integration with the catalog.
---
 plugins/lighthouse/README.md                  | 63 +++++++++++++++++++
 .../Cards/LastLighthouseAuditCard.tsx         | 15 +++--
 2 files changed, 74 insertions(+), 4 deletions(-)

diff --git a/plugins/lighthouse/README.md b/plugins/lighthouse/README.md
index b5fecb85f8..19244f3cf0 100644
--- a/plugins/lighthouse/README.md
+++ b/plugins/lighthouse/README.md
@@ -57,3 +57,66 @@ Then configure the lighthouse service url in your [`app-config.yaml`](https://gi
 lighthouse:
   baseUrl: http://your-service-url
 ```
+
+### Integration with the Catalog
+
+The lighthouse plugin can be integrated into the catalog so that lighthouse audit information relating to a component
+can be displayed within that component's entity page. In order to link an Entity to its lighthouse audits the entity
+must be annotated as follows:
+
+```yaml
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  # ...
+  annotations:
+    # ...
+    lighthouse.com/website-url: # A single website url e.g. https://backstage.io/
+```
+
+> NOTE: The lighthouse plugin only supports one website url per component at this time.
+
+Add a lighthouse tab to the EntityPage:
+
+```tsx
+// packages/app/src/components/catalog/EntityPage.tsx
+import { EmbeddedRouter as LighthouseRouter } from '@backstage/plugin-lighthouse';
+
+// ...
+const WebsiteEntityPage = ({ entity }: { entity: Entity }) => (
+  <EntityPageLayout>
+    // ...
+    <EntityPageLayout.Content
+      path="/lighthouse"
+      title="Lighthouse"
+      element={<LighthouseRouter entity={entity} />}
+    />
+  </EntityPageLayout>
+);
+```
+
+> NOTE: The embedded router renders page content without a header section allowing it to be rendered within a
+> catalog plugin page.
+
+Add a Lighthouse card to the overview tab on the EntityPage:
+
+```tsx
+// packages/app/src/components/catalog/EntityPage.tsx
+import {
+  LastLighthouseAuditCard,
+  isPluginApplicableToEntity as isLighthouseAvailable,
+} from '@backstage/plugin-lighthouse';
+
+// ...
+
+const OverviewContent = ({ entity }: { entity: Entity }) => (
+  <Grid container spacing={3}>
+    // ...
+    {isLighthouseAvailable(entity) && (
+      <Grid item sm={4}>
+        <LastLighthouseAuditCard />
+      </Grid>
+    )}
+  </Grid>
+);
+```
diff --git a/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx b/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx
index d82e6c5c6c..d3bc362877 100644
--- a/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx
+++ b/plugins/lighthouse/src/components/Cards/LastLighthouseAuditCard.tsx
@@ -62,7 +62,10 @@ const LighthouseAuditStatus: FC<{ audit: Audit }> = ({ audit }) => (
   </>
 );
 
-const LighthouseAuditSummary: FC<{ audit: Audit }> = ({ audit }) => {
+const LighthouseAuditSummary: FC<{ audit: Audit; dense?: boolean }> = ({
+  audit,
+  dense = false,
+}) => {
   const { url } = audit;
   const flattenedCategoryData: Record<string, React.ReactNode> = {};
   if (audit.status === 'COMPLETED') {
@@ -82,10 +85,12 @@ const LighthouseAuditSummary: FC<{ audit: Audit }> = ({ audit }) => {
     ...flattenedCategoryData,
   };
 
-  return <StructuredMetadataTable metadata={tableData} />;
+  return <StructuredMetadataTable metadata={tableData} dense={dense} />;
 };
 
-export const LastLighthouseAuditCard: FC<{}> = () => {
+export const LastLighthouseAuditCard: FC<{ dense?: boolean }> = ({
+  dense = false,
+}) => {
   const { value: website, loading, error } = useWebsiteForEntity();
 
   let content;
@@ -96,7 +101,9 @@ export const LastLighthouseAuditCard: FC<{}> = () => {
     content = null;
   }
   if (website) {
-    content = <LighthouseAuditSummary audit={website.lastAudit} />;
+    content = (
+      <LighthouseAuditSummary audit={website.lastAudit} dense={dense} />
+    );
   }
   return <InfoCard title="Lighthouse Audit">{content}</InfoCard>;
 };

From 4e76fea2699f91ee47bbf5fdfbd99ee2df19fd15 Mon Sep 17 00:00:00 2001
From: Iain Billett <iain@roadie.io>
Date: Tue, 6 Oct 2020 08:34:04 +0100
Subject: [PATCH 027/110] Fixes for Lighthouse widgets

---
 plugins/backstage-plugin-travis-ci | 1 -
 plugins/lighthouse/src/Router.tsx  | 3 +--
 2 files changed, 1 insertion(+), 3 deletions(-)
 delete mode 160000 plugins/backstage-plugin-travis-ci

diff --git a/plugins/backstage-plugin-travis-ci b/plugins/backstage-plugin-travis-ci
deleted file mode 160000
index b70556a6e5..0000000000
--- a/plugins/backstage-plugin-travis-ci
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit b70556a6e5476cb64ff5c23123052c79ee926269
diff --git a/plugins/lighthouse/src/Router.tsx b/plugins/lighthouse/src/Router.tsx
index 6036d9954d..df481483c3 100644
--- a/plugins/lighthouse/src/Router.tsx
+++ b/plugins/lighthouse/src/Router.tsx
@@ -26,8 +26,7 @@ import { AuditListForEntity } from './components/AuditList/AuditListForEntity';
 import { EmptyState } from '@backstage/core';
 
 export const isPluginApplicableToEntity = (entity: Entity) =>
-  Boolean(entity.metadata.annotations?.[LIGHTHOUSE_WEBSITE_URL_ANNOTATION]) ||
-  entity.metadata.name === 'marketing-site';
+  Boolean(entity.metadata.annotations?.[LIGHTHOUSE_WEBSITE_URL_ANNOTATION]);
 
 export const Router = () => (
   <Routes>

From 07e08834a549d537f88134a7e4039591ba454d2c Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 18 Sep 2020 11:19:05 +0200
Subject: [PATCH 028/110] Move <UserSettings/> to a user-settings plugin

---
 packages/app/package.json                     |  2 +-
 packages/app/src/components/Root/Root.tsx     |  5 +-
 packages/app/src/plugins.ts                   |  1 +
 packages/core/src/layout/Sidebar/index.ts     |  2 -
 plugins/user-settings/.eslintrc.js            |  3 +
 plugins/user-settings/README.md               | 13 +++
 plugins/user-settings/dev/index.tsx           | 19 +++++
 plugins/user-settings/package.json            | 46 +++++++++++
 .../src/components}/AppSettingsList.tsx       |  0
 .../src/components}/AuthProviderList.tsx      |  3 +-
 .../components}/DefaultProviderSettings.tsx   |  5 +-
 .../src/components}/FeatureFlagsItem.tsx      |  6 +-
 .../src/components}/FeatureFlagsList.tsx      |  0
 .../src/components/OAuthProviderSettings.tsx  | 80 ++++++++++++++++++
 .../src/components/OIDCProviderSettings.tsx   | 81 +++++++++++++++++++
 .../src/components}/PinButton.tsx             |  2 +-
 .../src/components}/ProviderSettingsItem.tsx  |  3 +-
 .../src/components}/SettingsDialog.tsx        |  2 +-
 .../src/components}/SignInAvatar.tsx          |  2 +-
 .../src/components}/ThemeToggle.tsx           |  2 +-
 .../src/components}/UserSettings.tsx          |  5 +-
 .../src/components}/UserSettingsMenu.tsx      |  2 +-
 .../user-settings/src/components}/index.ts    |  3 +-
 .../src/components}/useUserProfileInfo.ts     |  2 +-
 plugins/user-settings/src/index.ts            | 17 ++++
 plugins/user-settings/src/plugin.test.ts      | 22 +++++
 plugins/user-settings/src/plugin.ts           | 30 +++++++
 plugins/user-settings/src/setupTests.ts       | 18 +++++
 28 files changed, 349 insertions(+), 27 deletions(-)
 create mode 100644 plugins/user-settings/.eslintrc.js
 create mode 100644 plugins/user-settings/README.md
 create mode 100644 plugins/user-settings/dev/index.tsx
 create mode 100644 plugins/user-settings/package.json
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/AppSettingsList.tsx (100%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/AuthProviderList.tsx (89%)
 rename {packages/core/src/layout/Sidebar => plugins/user-settings/src/components}/DefaultProviderSettings.tsx (93%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/FeatureFlagsItem.tsx (95%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/FeatureFlagsList.tsx (100%)
 create mode 100644 plugins/user-settings/src/components/OAuthProviderSettings.tsx
 create mode 100644 plugins/user-settings/src/components/OIDCProviderSettings.tsx
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/PinButton.tsx (96%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/ProviderSettingsItem.tsx (95%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/SettingsDialog.tsx (96%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/SignInAvatar.tsx (96%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/ThemeToggle.tsx (97%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/UserSettings.tsx (93%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/UserSettingsMenu.tsx (96%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/index.ts (83%)
 rename {packages/core/src/layout/Sidebar/Settings => plugins/user-settings/src/components}/useUserProfileInfo.ts (93%)
 create mode 100644 plugins/user-settings/src/index.ts
 create mode 100644 plugins/user-settings/src/plugin.test.ts
 create mode 100644 plugins/user-settings/src/plugin.ts
 create mode 100644 plugins/user-settings/src/setupTests.ts

diff --git a/packages/app/package.json b/packages/app/package.json
index e8dfb94046..07814cdb0d 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -10,7 +10,6 @@
     "@backstage/plugin-api-docs": "^0.1.1-alpha.24",
     "@backstage/plugin-catalog": "^0.1.1-alpha.24",
     "@backstage/plugin-circleci": "^0.1.1-alpha.24",
-    "@backstage/plugin-cloudbuild": "^0.1.1-alpha.24",
     "@backstage/plugin-cost-insights": "^0.1.1-alpha.24",
     "@backstage/plugin-explore": "^0.1.1-alpha.24",
     "@backstage/plugin-gcp-projects": "^0.1.1-alpha.24",
@@ -28,6 +27,7 @@
     "@backstage/plugin-tech-radar": "^0.1.1-alpha.24",
     "@backstage/plugin-techdocs": "^0.1.1-alpha.24",
     "@backstage/plugin-welcome": "^0.1.1-alpha.24",
+    "@backstage/plugin-user-settings": "^0.1.1-alpha.24",
     "@backstage/test-utils": "^0.1.1-alpha.24",
     "@backstage/theme": "^0.1.1-alpha.24",
     "@material-ui/core": "^4.11.0",
diff --git a/packages/app/src/components/Root/Root.tsx b/packages/app/src/components/Root/Root.tsx
index 45ffca7801..9f5387cea8 100644
--- a/packages/app/src/components/Root/Root.tsx
+++ b/packages/app/src/components/Root/Root.tsx
@@ -35,11 +35,10 @@ import {
   SidebarDivider,
   SidebarSearchField,
   SidebarSpace,
-  SidebarUserSettings,
-  DefaultProviderSettings,
 } from '@backstage/core';
 import { NavLink } from 'react-router-dom';
 import { graphiQLRouteRef } from '@backstage/plugin-graphiql';
+import { UserSettings } from '@backstage/plugin-user-settings';
 
 const useSidebarLogoStyles = makeStyles({
   root: {
@@ -103,7 +102,7 @@ const Root: FC<{}> = ({ children }) => (
       />
       <SidebarSpace />
       <SidebarDivider />
-      <SidebarUserSettings providerSettings={<DefaultProviderSettings />} />
+      <UserSettings />
     </Sidebar>
     {children}
   </SidebarPage>
diff --git a/packages/app/src/plugins.ts b/packages/app/src/plugins.ts
index 85c4977d67..57dc8a3443 100644
--- a/packages/app/src/plugins.ts
+++ b/packages/app/src/plugins.ts
@@ -36,3 +36,4 @@ export { plugin as GcpProjects } from '@backstage/plugin-gcp-projects';
 export { plugin as Kubernetes } from '@backstage/plugin-kubernetes';
 export { plugin as Cloudbuild } from '@backstage/plugin-cloudbuild';
 export { plugin as CostInsights } from '@backstage/plugin-cost-insights';
+export { plugin as UserSettings } from '@backstage/plugin-user-settings';
diff --git a/packages/core/src/layout/Sidebar/index.ts b/packages/core/src/layout/Sidebar/index.ts
index a644c06e14..803306478d 100644
--- a/packages/core/src/layout/Sidebar/index.ts
+++ b/packages/core/src/layout/Sidebar/index.ts
@@ -31,5 +31,3 @@ export {
   sidebarConfig,
 } from './config';
 export type { SidebarContextType } from './config';
-export { DefaultProviderSettings } from './DefaultProviderSettings';
-export * from './Settings';
diff --git a/plugins/user-settings/.eslintrc.js b/plugins/user-settings/.eslintrc.js
new file mode 100644
index 0000000000..13573efa9c
--- /dev/null
+++ b/plugins/user-settings/.eslintrc.js
@@ -0,0 +1,3 @@
+module.exports = {
+  extends: [require.resolve('@backstage/cli/config/eslint')],
+};
diff --git a/plugins/user-settings/README.md b/plugins/user-settings/README.md
new file mode 100644
index 0000000000..23d3e48fee
--- /dev/null
+++ b/plugins/user-settings/README.md
@@ -0,0 +1,13 @@
+# user-settings
+
+Welcome to the user-settings 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 [/user-settings](http://localhost:3000/user-settings).
+
+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/user-settings/dev/index.tsx b/plugins/user-settings/dev/index.tsx
new file mode 100644
index 0000000000..264d6f801f
--- /dev/null
+++ b/plugins/user-settings/dev/index.tsx
@@ -0,0 +1,19 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { plugin } from '../src/plugin';
+
+createDevApp().registerPlugin(plugin).render();
diff --git a/plugins/user-settings/package.json b/plugins/user-settings/package.json
new file mode 100644
index 0000000000..97fbb23301
--- /dev/null
+++ b/plugins/user-settings/package.json
@@ -0,0 +1,46 @@
+{
+  "name": "@backstage/plugin-user-settings",
+  "version": "0.1.1-alpha.21",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "license": "Apache-2.0",
+  "private": true,
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.esm.js",
+    "types": "dist/index.d.ts"
+  },
+  "scripts": {
+    "build": "backstage-cli plugin:build",
+    "start": "backstage-cli plugin:serve",
+    "lint": "backstage-cli lint",
+    "test": "backstage-cli test",
+    "diff": "backstage-cli plugin:diff",
+    "prepack": "backstage-cli prepack",
+    "postpack": "backstage-cli postpack",
+    "clean": "backstage-cli clean"
+  },
+  "dependencies": {
+    "@backstage/core": "^0.1.1-alpha.21",
+    "@backstage/theme": "^0.1.1-alpha.21",
+    "@material-ui/core": "^4.11.0",
+    "@material-ui/icons": "^4.9.1",
+    "@material-ui/lab": "4.0.0-alpha.45",
+    "react": "^16.13.1",
+    "react-dom": "^16.13.1",
+    "react-use": "^15.3.3"
+  },
+  "devDependencies": {
+    "@backstage/cli": "^0.1.1-alpha.21",
+    "@backstage/dev-utils": "^0.1.1-alpha.21",
+    "@testing-library/jest-dom": "^5.10.1",
+    "@testing-library/react": "^10.4.1",
+    "@testing-library/user-event": "^12.0.7",
+    "@types/jest": "^26.0.7",
+    "@types/node": "^12.0.0",
+    "jest-fetch-mock": "^3.0.3"
+  },
+  "files": [
+    "dist"
+  ]
+}
diff --git a/packages/core/src/layout/Sidebar/Settings/AppSettingsList.tsx b/plugins/user-settings/src/components/AppSettingsList.tsx
similarity index 100%
rename from packages/core/src/layout/Sidebar/Settings/AppSettingsList.tsx
rename to plugins/user-settings/src/components/AppSettingsList.tsx
diff --git a/packages/core/src/layout/Sidebar/Settings/AuthProviderList.tsx b/plugins/user-settings/src/components/AuthProviderList.tsx
similarity index 89%
rename from packages/core/src/layout/Sidebar/Settings/AuthProviderList.tsx
rename to plugins/user-settings/src/components/AuthProviderList.tsx
index 34cf6fb837..659af7cf19 100644
--- a/packages/core/src/layout/Sidebar/Settings/AuthProviderList.tsx
+++ b/plugins/user-settings/src/components/AuthProviderList.tsx
@@ -15,8 +15,7 @@
  */
 
 import React from 'react';
-import List from '@material-ui/core/List';
-import ListSubheader from '@material-ui/core/ListSubheader';
+import { List, ListSubheader } from '@material-ui/core';
 
 type Props = {
   providerSettings: React.ReactNode;
diff --git a/packages/core/src/layout/Sidebar/DefaultProviderSettings.tsx b/plugins/user-settings/src/components/DefaultProviderSettings.tsx
similarity index 93%
rename from packages/core/src/layout/Sidebar/DefaultProviderSettings.tsx
rename to plugins/user-settings/src/components/DefaultProviderSettings.tsx
index 99c5225c83..646bbb0603 100644
--- a/packages/core/src/layout/Sidebar/DefaultProviderSettings.tsx
+++ b/plugins/user-settings/src/components/DefaultProviderSettings.tsx
@@ -23,10 +23,11 @@ import {
   microsoftAuthApiRef,
   samlAuthApiRef,
   useApi,
-} from '@backstage/core-api';
+} from '@backstage/core';
 import Star from '@material-ui/icons/Star';
 import React from 'react';
-import { ProviderSettingsItem } from './Settings';
+import { OAuthProviderSettings } from './OAuthProviderSettings';
+import { OIDCProviderSettings } from './OIDCProviderSettings';
 
 export const DefaultProviderSettings = () => {
   const configApi = useApi(configApiRef);
diff --git a/packages/core/src/layout/Sidebar/Settings/FeatureFlagsItem.tsx b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
similarity index 95%
rename from packages/core/src/layout/Sidebar/Settings/FeatureFlagsItem.tsx
rename to plugins/user-settings/src/components/FeatureFlagsItem.tsx
index 3e40ce69cc..bc327061ef 100644
--- a/packages/core/src/layout/Sidebar/Settings/FeatureFlagsItem.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
@@ -15,11 +15,7 @@
  */
 
 import React from 'react';
-import {
-  FeatureFlagName,
-  useApi,
-  featureFlagsApiRef,
-} from '@backstage/core-api';
+import { FeatureFlagName, useApi, featureFlagsApiRef } from '@backstage/core';
 import {
   ListItem,
   ListItemSecondaryAction,
diff --git a/packages/core/src/layout/Sidebar/Settings/FeatureFlagsList.tsx b/plugins/user-settings/src/components/FeatureFlagsList.tsx
similarity index 100%
rename from packages/core/src/layout/Sidebar/Settings/FeatureFlagsList.tsx
rename to plugins/user-settings/src/components/FeatureFlagsList.tsx
diff --git a/plugins/user-settings/src/components/OAuthProviderSettings.tsx b/plugins/user-settings/src/components/OAuthProviderSettings.tsx
new file mode 100644
index 0000000000..2ecc5536ea
--- /dev/null
+++ b/plugins/user-settings/src/components/OAuthProviderSettings.tsx
@@ -0,0 +1,80 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 {
+  ApiRef,
+  OAuthApi,
+  SessionStateApi,
+  useApi,
+  Subscription,
+  IconComponent,
+  SessionState,
+} from '@backstage/core';
+import React, { FC, useState, useEffect } from 'react';
+import { ProviderSettingsItem } from './ProviderSettingsItem';
+
+type OAuthProviderSidebarProps = {
+  title: string;
+  icon: IconComponent;
+  apiRef: ApiRef<OAuthApi & SessionStateApi>;
+};
+
+export const OAuthProviderSettings: FC<OAuthProviderSidebarProps> = ({
+  title,
+  icon,
+  apiRef,
+}) => {
+  const api = useApi(apiRef);
+  const [signedIn, setSignedIn] = useState(false);
+
+  useEffect(() => {
+    let didCancel = false;
+
+    const checkSession = async () => {
+      const session = await api.getAccessToken('', { optional: true });
+      if (!didCancel) {
+        setSignedIn(!!session);
+      }
+    };
+    let subscription: Subscription;
+    const observeSession = () => {
+      subscription = api
+        .sessionState$()
+        .subscribe((sessionState: SessionState) => {
+          if (!didCancel) {
+            setSignedIn(sessionState === SessionState.SignedIn);
+          }
+        });
+    };
+
+    checkSession();
+    observeSession();
+    return () => {
+      didCancel = true;
+      subscription.unsubscribe();
+    };
+  }, [api]);
+
+  return (
+    <ProviderSettingsItem
+      title={title}
+      icon={icon}
+      signedIn={signedIn}
+      api={api}
+      signInHandler={() => api.getAccessToken()}
+    />
+  );
+};
diff --git a/plugins/user-settings/src/components/OIDCProviderSettings.tsx b/plugins/user-settings/src/components/OIDCProviderSettings.tsx
new file mode 100644
index 0000000000..1516b3514d
--- /dev/null
+++ b/plugins/user-settings/src/components/OIDCProviderSettings.tsx
@@ -0,0 +1,81 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 {
+  ApiRef,
+  OpenIdConnectApi,
+  SessionStateApi,
+  useApi,
+  Subscription,
+  IconComponent,
+  SessionState,
+} from '@backstage/core';
+import React, { FC, useState, useEffect } from 'react';
+import { ProviderSettingsItem } from './ProviderSettingsItem';
+
+export type OIDCProviderSidebarProps = {
+  title: string;
+  icon: IconComponent;
+  apiRef: ApiRef<OpenIdConnectApi & SessionStateApi>;
+};
+
+export const OIDCProviderSettings: FC<OIDCProviderSidebarProps> = ({
+  title,
+  icon,
+  apiRef,
+}) => {
+  const api = useApi(apiRef);
+  const [signedIn, setSignedIn] = useState(false);
+
+  useEffect(() => {
+    let didCancel = false;
+
+    const checkSession = async () => {
+      const session = await api.getIdToken({ optional: true });
+      if (!didCancel) {
+        setSignedIn(!!session);
+      }
+    };
+
+    let subscription: Subscription;
+    const observeSession = () => {
+      subscription = api
+        .sessionState$()
+        .subscribe((sessionState: SessionState) => {
+          if (!didCancel) {
+            setSignedIn(sessionState === SessionState.SignedIn);
+          }
+        });
+    };
+
+    checkSession();
+    observeSession();
+    return () => {
+      didCancel = true;
+      subscription.unsubscribe();
+    };
+  }, [api]);
+
+  return (
+    <ProviderSettingsItem
+      title={title}
+      icon={icon}
+      signedIn={signedIn}
+      api={api}
+      signInHandler={() => api.getIdToken()}
+    />
+  );
+};
diff --git a/packages/core/src/layout/Sidebar/Settings/PinButton.tsx b/plugins/user-settings/src/components/PinButton.tsx
similarity index 96%
rename from packages/core/src/layout/Sidebar/Settings/PinButton.tsx
rename to plugins/user-settings/src/components/PinButton.tsx
index 2727313ede..0858e9d4fb 100644
--- a/packages/core/src/layout/Sidebar/Settings/PinButton.tsx
+++ b/plugins/user-settings/src/components/PinButton.tsx
@@ -24,7 +24,7 @@ import {
 import LockIcon from '@material-ui/icons/Lock';
 import LockOpenIcon from '@material-ui/icons/LockOpen';
 import { ToggleButton } from '@material-ui/lab';
-import { SidebarPinStateContext } from '../Page';
+import { SidebarPinStateContext } from '@backstage/core';
 
 export const SidebarPinButton = () => {
   const { isPinned, toggleSidebarPinState } = useContext(
diff --git a/packages/core/src/layout/Sidebar/Settings/ProviderSettingsItem.tsx b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
similarity index 95%
rename from packages/core/src/layout/Sidebar/Settings/ProviderSettingsItem.tsx
rename to plugins/user-settings/src/components/ProviderSettingsItem.tsx
index 4db7ea0823..e4a3900919 100644
--- a/packages/core/src/layout/Sidebar/Settings/ProviderSettingsItem.tsx
+++ b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
@@ -14,7 +14,8 @@
  * limitations under the License.
  */
 
-import React, { FC, useState, useEffect } from 'react';
+import React from 'react';
+import { IconComponent, OAuthApi, OpenIdConnectApi } from '@backstage/core';
 import {
   ListItem,
   ListItemIcon,
diff --git a/packages/core/src/layout/Sidebar/Settings/SettingsDialog.tsx b/plugins/user-settings/src/components/SettingsDialog.tsx
similarity index 96%
rename from packages/core/src/layout/Sidebar/Settings/SettingsDialog.tsx
rename to plugins/user-settings/src/components/SettingsDialog.tsx
index 71c4899862..c121a0b9cb 100644
--- a/packages/core/src/layout/Sidebar/Settings/SettingsDialog.tsx
+++ b/plugins/user-settings/src/components/SettingsDialog.tsx
@@ -28,7 +28,7 @@ import { FeatureFlagsList } from './FeatureFlagsList';
 import { SignInAvatar } from './SignInAvatar';
 import { UserSettingsMenu } from './UserSettingsMenu';
 import { useUserProfile } from './useUserProfileInfo';
-import { useApi, featureFlagsApiRef } from '@backstage/core-api';
+import { useApi, featureFlagsApiRef } from '@backstage/core';
 
 const useStyles = makeStyles({
   root: {
diff --git a/packages/core/src/layout/Sidebar/Settings/SignInAvatar.tsx b/plugins/user-settings/src/components/SignInAvatar.tsx
similarity index 96%
rename from packages/core/src/layout/Sidebar/Settings/SignInAvatar.tsx
rename to plugins/user-settings/src/components/SignInAvatar.tsx
index f0430edfcf..11a5e6ed99 100644
--- a/packages/core/src/layout/Sidebar/Settings/SignInAvatar.tsx
+++ b/plugins/user-settings/src/components/SignInAvatar.tsx
@@ -18,7 +18,7 @@ import React from 'react';
 import { BackstageTheme } from '@backstage/theme';
 import { makeStyles, Avatar } from '@material-ui/core';
 import { useUserProfile } from './useUserProfileInfo';
-import { sidebarConfig } from '../config';
+import { sidebarConfig } from '@backstage/core';
 
 const useStyles = makeStyles<BackstageTheme, { size: number }>({
   avatar: {
diff --git a/packages/core/src/layout/Sidebar/Settings/ThemeToggle.tsx b/plugins/user-settings/src/components/ThemeToggle.tsx
similarity index 97%
rename from packages/core/src/layout/Sidebar/Settings/ThemeToggle.tsx
rename to plugins/user-settings/src/components/ThemeToggle.tsx
index a5e703089c..400a918d32 100644
--- a/packages/core/src/layout/Sidebar/Settings/ThemeToggle.tsx
+++ b/plugins/user-settings/src/components/ThemeToggle.tsx
@@ -19,7 +19,7 @@ import { useObservable } from 'react-use';
 import LightIcon from '@material-ui/icons/WbSunny';
 import DarkIcon from '@material-ui/icons/Brightness2';
 import AutoIcon from '@material-ui/icons/BrightnessAuto';
-import { appThemeApiRef, useApi } from '@backstage/core-api';
+import { appThemeApiRef, useApi } from '@backstage/core';
 import ToggleButton from '@material-ui/lab/ToggleButton';
 import ToggleButtonGroup from '@material-ui/lab/ToggleButtonGroup';
 import {
diff --git a/packages/core/src/layout/Sidebar/Settings/UserSettings.tsx b/plugins/user-settings/src/components/UserSettings.tsx
similarity index 93%
rename from packages/core/src/layout/Sidebar/Settings/UserSettings.tsx
rename to plugins/user-settings/src/components/UserSettings.tsx
index 85dbefff9b..a5d9bd7778 100644
--- a/packages/core/src/layout/Sidebar/Settings/UserSettings.tsx
+++ b/plugins/user-settings/src/components/UserSettings.tsx
@@ -18,15 +18,14 @@ import React, { useEffect, useContext } from 'react';
 import { Popover } from '@material-ui/core';
 import { SignInAvatar } from './SignInAvatar';
 import { SettingsDialog } from './SettingsDialog';
-import { SidebarItem } from '../Items';
+import { SidebarItem, SidebarContext } from '@backstage/core';
 import { useUserProfile } from './useUserProfileInfo';
-import { SidebarContext } from '../config';
 
 type Props = {
   providerSettings?: React.ReactNode;
 };
 
-export const SidebarUserSettings = ({ providerSettings }: Props) => {
+export const UserSettings = ({ providerSettings }: Props) => {
   const { isOpen: sidebarOpen } = useContext(SidebarContext);
   const { displayName } = useUserProfile();
   const [open, setOpen] = React.useState(false);
diff --git a/packages/core/src/layout/Sidebar/Settings/UserSettingsMenu.tsx b/plugins/user-settings/src/components/UserSettingsMenu.tsx
similarity index 96%
rename from packages/core/src/layout/Sidebar/Settings/UserSettingsMenu.tsx
rename to plugins/user-settings/src/components/UserSettingsMenu.tsx
index 151ddb6e75..40b101fe4d 100644
--- a/packages/core/src/layout/Sidebar/Settings/UserSettingsMenu.tsx
+++ b/plugins/user-settings/src/components/UserSettingsMenu.tsx
@@ -15,7 +15,7 @@
  */
 
 import React from 'react';
-import { identityApiRef, useApi } from '@backstage/core-api';
+import { identityApiRef, useApi } from '@backstage/core';
 import { IconButton, ListItemIcon, Menu, MenuItem } from '@material-ui/core';
 import SignOutIcon from '@material-ui/icons/MeetingRoom';
 import MoreVertIcon from '@material-ui/icons/MoreVert';
diff --git a/packages/core/src/layout/Sidebar/Settings/index.ts b/plugins/user-settings/src/components/index.ts
similarity index 83%
rename from packages/core/src/layout/Sidebar/Settings/index.ts
rename to plugins/user-settings/src/components/index.ts
index 15042dc85d..59a8b425e4 100644
--- a/packages/core/src/layout/Sidebar/Settings/index.ts
+++ b/plugins/user-settings/src/components/index.ts
@@ -14,5 +14,4 @@
  * limitations under the License.
  */
 
-export { ProviderSettingsItem } from './ProviderSettingsItem';
-export { SidebarUserSettings } from './UserSettings';
+export { UserSettings } from './UserSettings';
diff --git a/packages/core/src/layout/Sidebar/Settings/useUserProfileInfo.ts b/plugins/user-settings/src/components/useUserProfileInfo.ts
similarity index 93%
rename from packages/core/src/layout/Sidebar/Settings/useUserProfileInfo.ts
rename to plugins/user-settings/src/components/useUserProfileInfo.ts
index 60dae294a5..428719160d 100644
--- a/packages/core/src/layout/Sidebar/Settings/useUserProfileInfo.ts
+++ b/plugins/user-settings/src/components/useUserProfileInfo.ts
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { useApi, identityApiRef } from '@backstage/core-api';
+import { useApi, identityApiRef } from '@backstage/core';
 
 export const useUserProfile = () => {
   const identityApi = useApi(identityApiRef);
diff --git a/plugins/user-settings/src/index.ts b/plugins/user-settings/src/index.ts
new file mode 100644
index 0000000000..311ae69a51
--- /dev/null
+++ b/plugins/user-settings/src/index.ts
@@ -0,0 +1,17 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { plugin } from './plugin';
+export { UserSettings } from './components/UserSettings';
diff --git a/plugins/user-settings/src/plugin.test.ts b/plugins/user-settings/src/plugin.test.ts
new file mode 100644
index 0000000000..810a2cda12
--- /dev/null
+++ b/plugins/user-settings/src/plugin.test.ts
@@ -0,0 +1,22 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { plugin } from './plugin';
+
+describe('user-settings', () => {
+  it('should export plugin', () => {
+    expect(plugin).toBeDefined();
+  });
+});
diff --git a/plugins/user-settings/src/plugin.ts b/plugins/user-settings/src/plugin.ts
new file mode 100644
index 0000000000..5e5461f3b1
--- /dev/null
+++ b/plugins/user-settings/src/plugin.ts
@@ -0,0 +1,30 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 } from '@backstage/core';
+// import ExampleComponent from './components/ExampleComponent';
+
+// export const rootRouteRef = createRouteRef({
+//   path: '/user-settings',
+//   title: 'user-settings',
+// });
+
+export const plugin = createPlugin({
+  id: 'user-settings',
+  // apis: [createApiFactory(GCPApiRef, new GCPClient())],
+  // register({ router }) {
+  //   router.addRoute(rootRouteRef, ExampleComponent);
+  // },
+});
diff --git a/plugins/user-settings/src/setupTests.ts b/plugins/user-settings/src/setupTests.ts
new file mode 100644
index 0000000000..4b4cdbdaaf
--- /dev/null
+++ b/plugins/user-settings/src/setupTests.ts
@@ -0,0 +1,18 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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';
+
+require('jest-fetch-mock').enableMocks();

From 5d8e058e4d275425d0337306cdb7f268ef4b2871 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 18 Sep 2020 14:05:59 +0200
Subject: [PATCH 029/110] Display list of providers from config as default

---
 .../src/components/AuthProviderList.tsx            |  6 +++---
 ...Settings.tsx => ConfiguredProviderSettings.tsx} |  2 +-
 .../src/components/SettingsDialog.tsx              | 14 +++++++-------
 .../user-settings/src/components/UserSettings.tsx  | 11 ++++++++++-
 4 files changed, 21 insertions(+), 12 deletions(-)
 rename plugins/user-settings/src/components/{DefaultProviderSettings.tsx => ConfiguredProviderSettings.tsx} (97%)

diff --git a/plugins/user-settings/src/components/AuthProviderList.tsx b/plugins/user-settings/src/components/AuthProviderList.tsx
index 659af7cf19..8f4d41319c 100644
--- a/plugins/user-settings/src/components/AuthProviderList.tsx
+++ b/plugins/user-settings/src/components/AuthProviderList.tsx
@@ -18,11 +18,11 @@ import React from 'react';
 import { List, ListSubheader } from '@material-ui/core';
 
 type Props = {
-  providerSettings: React.ReactNode;
+  providers: React.ReactNode;
 };
 
-export const AuthProvidersList = ({ providerSettings }: Props) => (
+export const AuthProvidersList = ({ providers }: Props) => (
   <List subheader={<ListSubheader>Available Auth Providers</ListSubheader>}>
-    {providerSettings}
+    {providers}
   </List>
 );
diff --git a/plugins/user-settings/src/components/DefaultProviderSettings.tsx b/plugins/user-settings/src/components/ConfiguredProviderSettings.tsx
similarity index 97%
rename from plugins/user-settings/src/components/DefaultProviderSettings.tsx
rename to plugins/user-settings/src/components/ConfiguredProviderSettings.tsx
index 646bbb0603..99351e2984 100644
--- a/plugins/user-settings/src/components/DefaultProviderSettings.tsx
+++ b/plugins/user-settings/src/components/ConfiguredProviderSettings.tsx
@@ -29,7 +29,7 @@ import React from 'react';
 import { OAuthProviderSettings } from './OAuthProviderSettings';
 import { OIDCProviderSettings } from './OIDCProviderSettings';
 
-export const DefaultProviderSettings = () => {
+export const ConfiguredProviderSettings = () => {
   const configApi = useApi(configApiRef);
   const providersConfig = configApi.getOptionalConfig('auth.providers');
   const providers = providersConfig?.keys() ?? [];
diff --git a/plugins/user-settings/src/components/SettingsDialog.tsx b/plugins/user-settings/src/components/SettingsDialog.tsx
index c121a0b9cb..69ec4fb8ee 100644
--- a/plugins/user-settings/src/components/SettingsDialog.tsx
+++ b/plugins/user-settings/src/components/SettingsDialog.tsx
@@ -29,6 +29,8 @@ import { SignInAvatar } from './SignInAvatar';
 import { UserSettingsMenu } from './UserSettingsMenu';
 import { useUserProfile } from './useUserProfileInfo';
 import { useApi, featureFlagsApiRef } from '@backstage/core';
+import { ConfiguredProviderSettings } from './ConfiguredProviderSettings';
+import { ProviderSettings } from './UserSettings';
 
 const useStyles = makeStyles({
   root: {
@@ -37,7 +39,7 @@ const useStyles = makeStyles({
 });
 
 type Props = {
-  providerSettings?: React.ReactNode;
+  providerSettings?: ProviderSettings;
 };
 
 export const SettingsDialog = ({ providerSettings }: Props) => {
@@ -46,6 +48,8 @@ export const SettingsDialog = ({ providerSettings }: Props) => {
   const featureFlagsApi = useApi(featureFlagsApiRef);
   const featureFlags = featureFlagsApi.getRegisteredFlags();
 
+  const providers = providerSettings ?? <ConfiguredProviderSettings />;
+
   return (
     <Card className={classes.root}>
       <CardHeader
@@ -56,12 +60,8 @@ export const SettingsDialog = ({ providerSettings }: Props) => {
       />
       <CardContent>
         <AppSettingsList />
-        {providerSettings && (
-          <>
-            <Divider />
-            <AuthProvidersList providerSettings={providerSettings} />
-          </>
-        )}
+        <Divider />
+        <AuthProvidersList providers={providers} />
         {featureFlags.length > 0 && (
           <>
             <Divider />
diff --git a/plugins/user-settings/src/components/UserSettings.tsx b/plugins/user-settings/src/components/UserSettings.tsx
index a5d9bd7778..c91002d7d7 100644
--- a/plugins/user-settings/src/components/UserSettings.tsx
+++ b/plugins/user-settings/src/components/UserSettings.tsx
@@ -21,8 +21,17 @@ import { SettingsDialog } from './SettingsDialog';
 import { SidebarItem, SidebarContext } from '@backstage/core';
 import { useUserProfile } from './useUserProfileInfo';
 
+export type ProviderSettings = JSX.Element;
+
 type Props = {
-  providerSettings?: React.ReactNode;
+  /**
+   * Available auth providers. Providers will be rendered as children
+   * of a MUI List.
+   *
+   * If undefined, providers that are configured in app-config.yaml
+   * will be displayed instead.
+   */
+  providerSettings?: ProviderSettings;
 };
 
 export const UserSettings = ({ providerSettings }: Props) => {

From a1ec4786391c10e635726933d2ce8c5ed9122614 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 18 Sep 2020 14:54:59 +0200
Subject: [PATCH 030/110] Add icon to theme and use in ThemeToggle

---
 packages/core-api/src/apis/definitions/AppThemeApi.ts | 6 ++++++
 packages/core-api/src/app/types.ts                    | 2 ++
 packages/core/src/api-wrappers/createApp.tsx          | 5 ++++-
 plugins/user-settings/src/components/ThemeToggle.tsx  | 9 +--------
 4 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/packages/core-api/src/apis/definitions/AppThemeApi.ts b/packages/core-api/src/apis/definitions/AppThemeApi.ts
index de70adabd9..3f580450f0 100644
--- a/packages/core-api/src/apis/definitions/AppThemeApi.ts
+++ b/packages/core-api/src/apis/definitions/AppThemeApi.ts
@@ -17,6 +17,7 @@
 import { createApiRef } from '../ApiRef';
 import { BackstageTheme } from '@backstage/theme';
 import { Observable } from '../../types';
+import { SvgIconProps } from '@material-ui/core';
 
 /**
  * Describes a theme provided by the app.
@@ -41,6 +42,11 @@ export type AppTheme = {
    * The specialized MaterialUI theme instance.
    */
   theme: BackstageTheme;
+
+  /**
+   * An Icon for the theme mode setting.
+   */
+  icon?: React.ReactElement<SvgIconProps>;
 };
 
 /**
diff --git a/packages/core-api/src/app/types.ts b/packages/core-api/src/app/types.ts
index 882ecd3d8b..8a1eb92e8e 100644
--- a/packages/core-api/src/app/types.ts
+++ b/packages/core-api/src/app/types.ts
@@ -112,11 +112,13 @@ export type AppOptions = {
    *   title: 'Light Theme',
    *   variant: 'light',
    *   theme: lightTheme,
+   *   icon: <LightIcon />,
    * }, {
    *   id: 'dark',
    *   title: 'Dark Theme',
    *   variant: 'dark',
    *   theme: darkTheme,
+   *   icon: <DarkIcon />,
    * }]
    * ```
    */
diff --git a/packages/core/src/api-wrappers/createApp.tsx b/packages/core/src/api-wrappers/createApp.tsx
index 7fe77423e2..c7d0f5ce01 100644
--- a/packages/core/src/api-wrappers/createApp.tsx
+++ b/packages/core/src/api-wrappers/createApp.tsx
@@ -22,7 +22,8 @@ import privateExports, {
   AppConfigLoader,
 } from '@backstage/core-api';
 import { BrowserRouter, MemoryRouter } from 'react-router-dom';
-
+import LightIcon from '@material-ui/icons/WbSunny';
+import DarkIcon from '@material-ui/icons/Brightness2';
 import { ErrorPage } from '../layout/ErrorPage';
 import { Progress } from '../components/Progress';
 import { defaultApis } from './defaultApis';
@@ -110,12 +111,14 @@ export function createApp(options?: AppOptions) {
       title: 'Light Theme',
       variant: 'light',
       theme: lightTheme,
+      icon: <LightIcon />,
     },
     {
       id: 'dark',
       title: 'Dark Theme',
       variant: 'dark',
       theme: darkTheme,
+      icon: <DarkIcon />,
     },
   ];
   const configLoader = options?.configLoader ?? defaultConfigLoader;
diff --git a/plugins/user-settings/src/components/ThemeToggle.tsx b/plugins/user-settings/src/components/ThemeToggle.tsx
index 400a918d32..88eee3c6bf 100644
--- a/plugins/user-settings/src/components/ThemeToggle.tsx
+++ b/plugins/user-settings/src/components/ThemeToggle.tsx
@@ -16,8 +16,6 @@
 
 import React from 'react';
 import { useObservable } from 'react-use';
-import LightIcon from '@material-ui/icons/WbSunny';
-import DarkIcon from '@material-ui/icons/Brightness2';
 import AutoIcon from '@material-ui/icons/BrightnessAuto';
 import { appThemeApiRef, useApi } from '@backstage/core';
 import ToggleButton from '@material-ui/lab/ToggleButton';
@@ -37,11 +35,6 @@ export const SidebarThemeToggle = () => {
   );
 
   const themeIds = appThemeApi.getInstalledThemes();
-  // TODO(marcuseide): can these be put on the theme itself?
-  const themeIcons = {
-    dark: <DarkIcon />,
-    light: <LightIcon />,
-  };
 
   const handleSetTheme = (
     _event: React.MouseEvent<HTMLElement>,
@@ -71,7 +64,7 @@ export const SidebarThemeToggle = () => {
                 arrow
                 title={`Select ${theme.variant} theme`}
               >
-                {themeIcons[theme.variant]}
+                {themeIds.find(t => t.id === theme.id)!.icon ?? <AutoIcon />}
               </Tooltip>
             </ToggleButton>
           ))}

From a942d42008be8dfb05e36a3b022ab7b2f3fe8e8f Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 22 Sep 2020 13:24:03 +0200
Subject: [PATCH 031/110] Refactor toggling of featureFlags

---
 .../src/apis/definitions/FeatureFlagsApi.ts   | 12 ++--
 packages/core-api/src/app/App.tsx             |  2 +-
 packages/core-api/src/app/FeatureFlags.tsx    | 10 +--
 .../src/components/FeatureFlagsItem.tsx       | 64 +++++++------------
 .../src/components/FeatureFlagsList.tsx       | 64 +++++++++++++++----
 5 files changed, 89 insertions(+), 63 deletions(-)

diff --git a/packages/core-api/src/apis/definitions/FeatureFlagsApi.ts b/packages/core-api/src/apis/definitions/FeatureFlagsApi.ts
index b6aac75620..dd9657d7d8 100644
--- a/packages/core-api/src/apis/definitions/FeatureFlagsApi.ts
+++ b/packages/core-api/src/apis/definitions/FeatureFlagsApi.ts
@@ -15,11 +15,8 @@
  */
 
 import { createApiRef } from '../ApiRef';
-import {
-  UserFlags,
-  FeatureFlagsRegistry,
-  FeatureFlagsRegistryItem,
-} from '../../app/FeatureFlags';
+import { UserFlags, FeatureFlagsRegistry } from '../../app/FeatureFlags';
+import { FeatureFlagName } from '../../plugin';
 
 /**
  * The feature flags API is used to toggle functionality to users across plugins and Backstage.
@@ -55,6 +52,11 @@ export interface FeatureFlagsApi {
   getRegisteredFlags(): FeatureFlagsRegistry;
 }
 
+export interface FeatureFlagsRegistryItem {
+  pluginId: string;
+  name: FeatureFlagName;
+}
+
 export const featureFlagsApiRef = createApiRef<FeatureFlagsApi>({
   id: 'core.featureflags',
   description: 'Used to toggle functionality in features across Backstage',
diff --git a/packages/core-api/src/app/App.tsx b/packages/core-api/src/app/App.tsx
index 9dd2fb138f..c222c3c420 100644
--- a/packages/core-api/src/app/App.tsx
+++ b/packages/core-api/src/app/App.tsx
@@ -30,12 +30,12 @@ import {
   SignInPageProps,
 } from './types';
 import { BackstagePlugin } from '../plugin';
-import { FeatureFlagsRegistryItem } from './FeatureFlags';
 import {
   featureFlagsApiRef,
   AppThemeApi,
   ConfigApi,
   identityApiRef,
+  FeatureFlagsRegistryItem,
 } from '../apis/definitions';
 import { AppThemeProvider } from './AppThemeProvider';
 
diff --git a/packages/core-api/src/app/FeatureFlags.tsx b/packages/core-api/src/app/FeatureFlags.tsx
index 3db2a18a02..7a69fa5456 100644
--- a/packages/core-api/src/app/FeatureFlags.tsx
+++ b/packages/core-api/src/app/FeatureFlags.tsx
@@ -15,7 +15,11 @@
  */
 
 import { FeatureFlagName } from '../plugin/types';
-import { FeatureFlagState, FeatureFlagsApi } from '../apis/definitions';
+import {
+  FeatureFlagState,
+  FeatureFlagsApi,
+  FeatureFlagsRegistryItem,
+} from '../apis/definitions';
 
 /**
  * Helper method for validating compatibility and flag name.
@@ -129,10 +133,6 @@ export class UserFlags extends Map<FeatureFlagName, FeatureFlagState> {
  * This acts as a holding data structure for feature flags
  * that plugins wish to register for use in Backstage.
  */
-export interface FeatureFlagsRegistryItem {
-  pluginId: string;
-  name: FeatureFlagName;
-}
 
 export class FeatureFlagsRegistry extends Array<FeatureFlagsRegistryItem> {
   static from(entries: FeatureFlagsRegistryItem[]) {
diff --git a/plugins/user-settings/src/components/FeatureFlagsItem.tsx b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
index bc327061ef..760aa25a34 100644
--- a/plugins/user-settings/src/components/FeatureFlagsItem.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
@@ -15,7 +15,6 @@
  */
 
 import React from 'react';
-import { FeatureFlagName, useApi, featureFlagsApiRef } from '@backstage/core';
 import {
   ListItem,
   ListItemSecondaryAction,
@@ -24,46 +23,31 @@ import {
 } from '@material-ui/core';
 import CheckIcon from '@material-ui/icons/CheckCircle';
 import { ToggleButton } from '@material-ui/lab';
-
-export type Item = {
-  name: FeatureFlagName;
-  pluginId: string;
-};
+import { FeatureFlagsRegistryItem } from '@backstage/core';
 
 type Props = {
-  featureFlag: Item;
+  flag: FeatureFlagsRegistryItem;
+  enabled: boolean;
+  toggleHandler: Function;
 };
 
-export const FlagItem = ({ featureFlag }: Props) => {
-  const api = useApi(featureFlagsApiRef);
-
-  const [enabled, setEnabled] = React.useState(
-    Boolean(api.getFlags().get(featureFlag.name)),
-  );
-
-  const toggleFlag = () => {
-    const newState = api.getFlags().toggle(featureFlag.name);
-    setEnabled(Boolean(newState));
-  };
-
-  return (
-    <ListItem>
-      <ListItemText
-        primary={featureFlag.name}
-        secondary={`Registered in ${featureFlag.pluginId} plugin`}
-      />
-      <ListItemSecondaryAction>
-        <ToggleButton
-          size="small"
-          value="flag"
-          selected={enabled}
-          onChange={toggleFlag}
-        >
-          <Tooltip placement="top" arrow title={enabled ? 'Disable' : 'Enable'}>
-            <CheckIcon />
-          </Tooltip>
-        </ToggleButton>
-      </ListItemSecondaryAction>
-    </ListItem>
-  );
-};
+export const FlagItem = ({ flag, enabled, toggleHandler }: Props) => (
+  <ListItem>
+    <ListItemText
+      primary={flag.name}
+      secondary={`Registered in ${flag.pluginId} plugin`}
+    />
+    <ListItemSecondaryAction>
+      <ToggleButton
+        size="small"
+        value="flag"
+        selected={enabled}
+        onChange={() => toggleHandler(flag.name)}
+      >
+        <Tooltip placement="top" arrow title={enabled ? 'Disable' : 'Enable'}>
+          <CheckIcon />
+        </Tooltip>
+      </ToggleButton>
+    </ListItemSecondaryAction>
+  </ListItem>
+);
diff --git a/plugins/user-settings/src/components/FeatureFlagsList.tsx b/plugins/user-settings/src/components/FeatureFlagsList.tsx
index 5687446511..0d7404c6fd 100644
--- a/plugins/user-settings/src/components/FeatureFlagsList.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsList.tsx
@@ -14,19 +14,59 @@
  * limitations under the License.
  */
 
-import React from 'react';
-import List from '@material-ui/core/List';
-import ListSubheader from '@material-ui/core/ListSubheader';
-import { FlagItem, Item } from './FeatureFlagsItem';
+import React, { useState, useEffect } from 'react';
+import { List, ListSubheader } from '@material-ui/core';
+import {
+  useApi,
+  featureFlagsApiRef,
+  FeatureFlagName,
+  FeatureFlagState,
+  FeatureFlagsRegistryItem,
+} from '@backstage/core';
+import { FlagItem } from './FeatureFlagsItem';
 
 type Props = {
-  featureFlags: Item[];
+  featureFlags: FeatureFlagsRegistryItem[];
 };
 
-export const FeatureFlagsList = ({ featureFlags }: Props) => (
-  <List dense subheader={<ListSubheader>Feature Flags</ListSubheader>}>
-    {featureFlags.map(featureFlag => (
-      <FlagItem key={featureFlag.name} featureFlag={featureFlag} />
-    ))}
-  </List>
-);
+export const FeatureFlagsList = ({ featureFlags }: Props) => {
+  const featureFlagApi = useApi(featureFlagsApiRef);
+  const [state, setState] = useState<Record<FeatureFlagName, FeatureFlagState>>(
+    {},
+  );
+
+  useEffect(() => {
+    featureFlags.map(featureFlag => {
+      setState({
+        [featureFlag.name]: featureFlagApi.getFlags().get(featureFlag.name),
+      });
+    });
+  }, [featureFlagApi, featureFlags]);
+
+  const toggleFlag = (flagName: FeatureFlagName) => {
+    const newState = featureFlagApi.getFlags().toggle(flagName);
+
+    setState(prevState => ({
+      ...prevState,
+      [flagName]: newState,
+    }));
+    featureFlagApi.getFlags().save();
+  };
+
+  return (
+    <List dense subheader={<ListSubheader>Feature Flags</ListSubheader>}>
+      {featureFlags.map(featureFlag => {
+        const enabled = Boolean(state[featureFlag.name]);
+
+        return (
+          <FlagItem
+            key={featureFlag.name}
+            flag={featureFlag}
+            enabled={enabled}
+            toggleHandler={toggleFlag}
+          />
+        );
+      })}
+    </List>
+  );
+};

From cea6c4604ec1e434be3cf6989aa10eb476135dbf Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Thu, 24 Sep 2020 10:45:13 +0200
Subject: [PATCH 032/110] Add primary color to buttons that are active/selected

---
 .../src/components/FeatureFlagsItem.tsx       |  2 +-
 .../src/components/PinButton.tsx              |  2 +-
 .../src/components/ProviderSettingsItem.tsx   | 18 ++++-------
 .../src/components/ThemeToggle.tsx            | 31 +++++++++++++------
 4 files changed, 29 insertions(+), 24 deletions(-)

diff --git a/plugins/user-settings/src/components/FeatureFlagsItem.tsx b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
index 760aa25a34..7f7f990e48 100644
--- a/plugins/user-settings/src/components/FeatureFlagsItem.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
@@ -45,7 +45,7 @@ export const FlagItem = ({ flag, enabled, toggleHandler }: Props) => (
         onChange={() => toggleHandler(flag.name)}
       >
         <Tooltip placement="top" arrow title={enabled ? 'Disable' : 'Enable'}>
-          <CheckIcon />
+          <CheckIcon color={enabled ? 'primary' : undefined} />
         </Tooltip>
       </ToggleButton>
     </ListItemSecondaryAction>
diff --git a/plugins/user-settings/src/components/PinButton.tsx b/plugins/user-settings/src/components/PinButton.tsx
index 0858e9d4fb..be4024f954 100644
--- a/plugins/user-settings/src/components/PinButton.tsx
+++ b/plugins/user-settings/src/components/PinButton.tsx
@@ -37,7 +37,7 @@ export const SidebarPinButton = () => {
       arrow
       title={`${isPinned ? 'Unpin' : 'Pin'} Sidebar`}
     >
-      {isPinned ? <LockIcon /> : <LockOpenIcon />}
+      {isPinned ? <LockIcon color="primary" /> : <LockOpenIcon />}
     </Tooltip>
   );
 
diff --git a/plugins/user-settings/src/components/ProviderSettingsItem.tsx b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
index e4a3900919..018e6a1326 100644
--- a/plugins/user-settings/src/components/ProviderSettingsItem.tsx
+++ b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
@@ -77,15 +77,9 @@ export const ProviderSettingsItem: FC<OAuthProviderSidebarProps> = ({
           selected={signedIn}
           onChange={() => (signedIn ? api.signOut() : api.signIn())}
         >
-          <Tooltip
-            placement="top"
-            arrow
-            title={signedIn ? `Sign out from ${title}` : `Sign in to ${title}`}
-          >
-            <PowerButton />
-          </Tooltip>
-        </ToggleButton>
-      </ListItemSecondaryAction>
-    </ListItem>
-  );
-};
+          <PowerButton color={signedIn ? 'primary' : undefined} />
+        </Tooltip>
+      </ToggleButton>
+    </ListItemSecondaryAction>
+  </ListItem>
+);
diff --git a/plugins/user-settings/src/components/ThemeToggle.tsx b/plugins/user-settings/src/components/ThemeToggle.tsx
index 88eee3c6bf..9acfc3407f 100644
--- a/plugins/user-settings/src/components/ThemeToggle.tsx
+++ b/plugins/user-settings/src/components/ThemeToggle.tsx
@@ -14,10 +14,10 @@
  * limitations under the License.
  */
 
-import React from 'react';
+import React, { cloneElement } from 'react';
 import { useObservable } from 'react-use';
 import AutoIcon from '@material-ui/icons/BrightnessAuto';
-import { appThemeApiRef, useApi } from '@backstage/core';
+import { AppTheme, appThemeApiRef, useApi } from '@backstage/core';
 import ToggleButton from '@material-ui/lab/ToggleButton';
 import ToggleButtonGroup from '@material-ui/lab/ToggleButtonGroup';
 import {
@@ -47,6 +47,23 @@ export const SidebarThemeToggle = () => {
     }
   };
 
+  const ThemeIcon = ({ theme }: { theme: AppTheme }) => {
+    const themeIcon = themeIds.find(t => t.id === theme.id)?.icon;
+    const icon = themeIcon ? (
+      cloneElement(themeIcon, {
+        color: themeId === theme.id ? 'primary' : undefined,
+      })
+    ) : (
+      <AutoIcon color={themeId === theme.id ? 'primary' : undefined} />
+    );
+
+    return (
+      <Tooltip placement="top" arrow title={`Select ${theme.variant} theme`}>
+        {icon}
+      </Tooltip>
+    );
+  };
+
   return (
     <ListItem>
       <ListItemText primary="Theme" secondary="Change the theme mode" />
@@ -59,18 +76,12 @@ export const SidebarThemeToggle = () => {
         >
           {themeIds.map(theme => (
             <ToggleButton key={theme.id} value={theme.variant}>
-              <Tooltip
-                placement="top"
-                arrow
-                title={`Select ${theme.variant} theme`}
-              >
-                {themeIds.find(t => t.id === theme.id)!.icon ?? <AutoIcon />}
-              </Tooltip>
+              <ThemeIcon theme={theme} />
             </ToggleButton>
           ))}
           <ToggleButton value="auto">
             <Tooltip placement="top" arrow title="Select auto theme">
-              <AutoIcon />
+              <AutoIcon color={themeId === undefined ? 'primary' : undefined} />
             </Tooltip>
           </ToggleButton>
         </ToggleButtonGroup>

From 94fa82b741eea20f1935ac6ec8bd7de885bc8f50 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 25 Sep 2020 09:58:18 +0200
Subject: [PATCH 033/110] Move variant style handling for Infocard to seperate
 file and use some of it for TabbedCard

---
 .../core/src/layout/InfoCard/InfoCard.tsx     | 74 +---------------
 packages/core/src/layout/InfoCard/variants.ts | 86 +++++++++++++++++++
 .../layout/TabbedCard/TabbedCard.stories.tsx  | 19 ++++
 .../core/src/layout/TabbedCard/TabbedCard.tsx | 62 +++++++++----
 4 files changed, 156 insertions(+), 85 deletions(-)
 create mode 100644 packages/core/src/layout/InfoCard/variants.ts

diff --git a/packages/core/src/layout/InfoCard/InfoCard.tsx b/packages/core/src/layout/InfoCard/InfoCard.tsx
index 09d31735cd..6665023b9e 100644
--- a/packages/core/src/layout/InfoCard/InfoCard.tsx
+++ b/packages/core/src/layout/InfoCard/InfoCard.tsx
@@ -28,6 +28,7 @@ import {
 import classNames from 'classnames';
 import { ErrorBoundary } from '../ErrorBoundary';
 import { BottomLink, BottomLinkProps } from '../BottomLink';
+import { getVariantStyles } from './variants';
 
 const useStyles = makeStyles(theme => ({
   noPadding: {
@@ -59,51 +60,6 @@ const CardActionsTopRight = withStyles(theme => ({
   },
 }))(CardActions);
 
-const VARIANT_STYLES = {
-  card: {
-    flex: {
-      display: 'flex',
-      flexDirection: 'column',
-    },
-    fullHeight: {
-      display: 'flex',
-      flexDirection: 'column',
-      height: '100%',
-    },
-    height100: {
-      display: 'flex',
-      flexDirection: 'column',
-      height: 'calc(100% - 10px)', // for pages without content header
-      marginBottom: '10px',
-    },
-    contentheader: {
-      height: 'calc(100% - 40px)', // for pages with content header
-    },
-    contentheadertabs: {
-      height: 'calc(100% - 97px)', // for pages with content header and tabs (Tingle)
-    },
-    noShrink: {
-      flexShrink: 0,
-    },
-    minheight300: {
-      minHeight: 300,
-      overflow: 'initial',
-    },
-  },
-  cardContent: {
-    fullHeight: {
-      flex: 1,
-    },
-    height100: {
-      flex: 1,
-    },
-    contentRow: {
-      display: 'flex',
-      flexDirection: 'row',
-    },
-  },
-};
-
 /**
  * InfoCard is used to display a paper-styled block on the screen, similar to a panel.
  *
@@ -163,32 +119,10 @@ export const InfoCard = ({
   noPadding,
 }: Props): JSX.Element => {
   const classes = useStyles();
-
-  /**
-   * If variant is specified, we build up styles for that particular variant for both
-   * the Card and the CardContent (since these need to be synced)
-   */
-  let calculatedStyle = {};
-  let calculatedCardStyle = {};
-
-  if (variant) {
-    const variants = variant.split(/[\s]+/g);
-    variants.forEach(name => {
-      calculatedStyle = {
-        ...calculatedStyle,
-        ...VARIANT_STYLES.card[name as keyof typeof VARIANT_STYLES['card']],
-      };
-      calculatedCardStyle = {
-        ...calculatedCardStyle,
-        ...VARIANT_STYLES.cardContent[
-          name as keyof typeof VARIANT_STYLES['cardContent']
-        ],
-      };
-    });
-  }
+  const { cardStyle, contentStyle } = getVariantStyles(variant);
 
   return (
-    <Card style={calculatedStyle} className={className}>
+    <Card style={cardStyle} className={className}>
       <ErrorBoundary slackChannel={slackChannel}>
         {title && (
           <>
@@ -217,7 +151,7 @@ export const InfoCard = ({
           className={classNames(cardClassName, {
             [classes.noPadding]: noPadding,
           })}
-          style={calculatedCardStyle}
+          style={contentStyle}
         >
           {children}
         </CardContent>
diff --git a/packages/core/src/layout/InfoCard/variants.ts b/packages/core/src/layout/InfoCard/variants.ts
new file mode 100644
index 0000000000..cc40bb372f
--- /dev/null
+++ b/packages/core/src/layout/InfoCard/variants.ts
@@ -0,0 +1,86 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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.
+ */
+
+const VARIANT_STYLES = {
+  card: {
+    flex: {
+      display: 'flex',
+      flexDirection: 'column',
+    },
+    fullHeight: {
+      display: 'flex',
+      flexDirection: 'column',
+      height: '100%',
+    },
+    height100: {
+      display: 'flex',
+      flexDirection: 'column',
+      height: 'calc(100% - 10px)', // for pages without content header
+      marginBottom: '10px',
+    },
+    contentheader: {
+      height: 'calc(100% - 40px)', // for pages with content header
+    },
+    contentheadertabs: {
+      height: 'calc(100% - 97px)', // for pages with content header and tabs (Tingle)
+    },
+    noShrink: {
+      flexShrink: 0,
+    },
+    minheight300: {
+      minHeight: 300,
+      overflow: 'initial',
+    },
+    flat: {
+      boxShadow: 'none',
+    },
+  },
+  cardContent: {
+    fullHeight: {
+      flex: 1,
+    },
+    height100: {
+      flex: 1,
+    },
+    contentRow: {
+      display: 'flex',
+      flexDirection: 'row',
+    },
+  },
+};
+
+export const getVariantStyles = (variant?: string): Record<string, object> => {
+  const cardStyle = {};
+  const contentStyle = {};
+
+  if (variant) {
+    const variants = variant.split(/[\s]+/g);
+    variants.forEach(name => {
+      Object.assign(
+        cardStyle,
+        VARIANT_STYLES.card[name as keyof typeof VARIANT_STYLES['card']],
+      );
+      Object.assign(
+        contentStyle,
+        VARIANT_STYLES.cardContent[
+          name as keyof typeof VARIANT_STYLES['cardContent']
+        ],
+      );
+    });
+  }
+
+  return { cardStyle, contentStyle };
+};
diff --git a/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx b/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
index 23c2ab5b49..ba5399dad9 100644
--- a/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
+++ b/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
@@ -50,6 +50,25 @@ export const Default = () => {
   );
 };
 
+export const WithSubheader = () => {
+  return (
+    <TabbedCard title="Default Example Header" subheader="Subheader">
+      <CardTab label="Option 1">
+        <div style={cardContentStyle}>Some content</div>
+      </CardTab>
+      <CardTab label="Option 2">
+        <div style={cardContentStyle}>Some content 2</div>
+      </CardTab>
+      <CardTab label="Option 3">
+        <div style={cardContentStyle}>Some content 3</div>
+      </CardTab>
+      <CardTab label="Option 4">
+        <div style={cardContentStyle}>Some content 4</div>
+      </CardTab>
+    </TabbedCard>
+  );
+};
+
 const linkInfo = { title: 'Go to XYZ Location', link: '#' };
 
 export const WithFooterLink = () => {
diff --git a/packages/core/src/layout/TabbedCard/TabbedCard.tsx b/packages/core/src/layout/TabbedCard/TabbedCard.tsx
index e1967b8533..7735d7eb8f 100644
--- a/packages/core/src/layout/TabbedCard/TabbedCard.tsx
+++ b/packages/core/src/layout/TabbedCard/TabbedCard.tsx
@@ -14,13 +14,12 @@
  * limitations under the License.
  */
 
-import React, { FC, useState, ReactElement, ReactNode } from 'react';
+import React, { useState, ReactElement, ReactNode } from 'react';
 import {
   Card,
   CardContent,
   CardHeader,
   Divider,
-  withStyles,
   makeStyles,
   Tabs,
   Tab,
@@ -28,6 +27,7 @@ import {
 } from '@material-ui/core';
 import { BottomLink, BottomLinkProps } from '../BottomLink';
 import { ErrorBoundary } from '../ErrorBoundary';
+import { getVariantStyles } from '../InfoCard/variants';
 
 const useTabsStyles = makeStyles(theme => ({
   root: {
@@ -38,31 +38,46 @@ const useTabsStyles = makeStyles(theme => ({
     backgroundColor: theme.palette.info.main,
     height: theme.spacing(0.3),
   },
+  header: {
+    padding: theme.spacing(2, 2, 2, 2.5),
+  },
+  headerTitle: {
+    fontWeight: 700,
+  },
+  headerSubheader: {
+    paddingTop: theme.spacing(1),
+  },
+  noPadding: {
+    padding: 0,
+    '&:last-child': {
+      paddingBottom: 0,
+    },
+  },
 }));
 
-const BoldHeader = withStyles(theme => ({
-  root: { padding: theme.spacing(2, 2, 2, 2.5), display: 'inline-block' },
-  title: { fontWeight: 700 },
-  subheader: { paddingTop: theme.spacing(1) },
-}))(CardHeader);
-
 type Props = {
   slackChannel?: string;
   children?: ReactElement<TabProps>[];
   onChange?: (event: React.ChangeEvent<{}>, value: number | string) => void;
   title?: string;
+  subheader?: string;
   value?: number | string;
   deepLink?: BottomLinkProps;
+  variant?: string;
+  noPadding?: boolean;
 };
 
-const TabbedCard: FC<Props> = ({
+const TabbedCard = ({
   slackChannel = '#backstage',
   children,
   title,
+  subheader,
   deepLink,
   value,
   onChange,
-}) => {
+  variant,
+  noPadding,
+}: Props) => {
   const tabsClasses = useTabsStyles();
   const [selectedIndex, selectIndex] = useState(0);
 
@@ -82,19 +97,36 @@ const TabbedCard: FC<Props> = ({
     });
   }
 
+  const { cardStyle, contentStyle } = getVariantStyles(variant);
+
   return (
-    <Card>
+    <Card style={cardStyle}>
       <ErrorBoundary slackChannel={slackChannel}>
-        {title && <BoldHeader title={title} />}
+        {title && (
+          <CardHeader
+            classes={{
+              root: tabsClasses.header,
+              title: tabsClasses.headerTitle,
+              subheader: tabsClasses.headerSubheader,
+            }}
+            title={title}
+            subheader={subheader}
+          />
+        )}
         <Tabs
-          classes={tabsClasses}
+          classes={{ root: tabsClasses.root, indicator: tabsClasses.indicator }}
           value={value || selectedIndex}
           onChange={handleChange}
         >
           {children}
         </Tabs>
         <Divider />
-        <CardContent>{selectedTabContent}</CardContent>
+        <CardContent
+          className={noPadding ? tabsClasses.noPadding : undefined}
+          style={contentStyle}
+        >
+          {selectedTabContent}
+        </CardContent>
         {deepLink && <BottomLink {...deepLink} />}
       </ErrorBoundary>
     </Card>
@@ -118,7 +150,7 @@ type CardTabProps = TabProps & {
   children: ReactNode;
 };
 
-const CardTab: FC<CardTabProps> = ({ children, ...props }) => {
+const CardTab = ({ children, ...props }: CardTabProps) => {
   const classes = useCardTabStyles();
 
   return <Tab disableRipple classes={classes} {...props} />;

From 940398336160737aefa7b0ae49c77b757aeb5e56 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 25 Sep 2020 10:21:36 +0200
Subject: [PATCH 034/110] Use TabbedCard to tab between different setting
 categories

---
 .../src/components/AppSettingsList.tsx        |  4 +-
 .../src/components/AuthProviderList.tsx       |  6 +-
 .../src/components/FeatureFlagsList.tsx       |  4 +-
 .../src/components/SettingsDialog.tsx         | 70 +++++++++++++++----
 .../src/components/UserSettings.tsx           |  9 ++-
 5 files changed, 70 insertions(+), 23 deletions(-)

diff --git a/plugins/user-settings/src/components/AppSettingsList.tsx b/plugins/user-settings/src/components/AppSettingsList.tsx
index 5dad178ccd..ab106cf28e 100644
--- a/plugins/user-settings/src/components/AppSettingsList.tsx
+++ b/plugins/user-settings/src/components/AppSettingsList.tsx
@@ -14,12 +14,12 @@
  * limitations under the License.
  */
 import React from 'react';
-import { List, ListSubheader } from '@material-ui/core';
+import { List } from '@material-ui/core';
 import { SidebarThemeToggle } from './ThemeToggle';
 import { SidebarPinButton } from './PinButton';
 
 export const AppSettingsList = () => (
-  <List dense subheader={<ListSubheader>App Settings</ListSubheader>}>
+  <List dense>
     <SidebarThemeToggle />
     <SidebarPinButton />
   </List>
diff --git a/plugins/user-settings/src/components/AuthProviderList.tsx b/plugins/user-settings/src/components/AuthProviderList.tsx
index 8f4d41319c..9a2096212d 100644
--- a/plugins/user-settings/src/components/AuthProviderList.tsx
+++ b/plugins/user-settings/src/components/AuthProviderList.tsx
@@ -15,14 +15,12 @@
  */
 
 import React from 'react';
-import { List, ListSubheader } from '@material-ui/core';
+import { List } from '@material-ui/core';
 
 type Props = {
   providers: React.ReactNode;
 };
 
 export const AuthProvidersList = ({ providers }: Props) => (
-  <List subheader={<ListSubheader>Available Auth Providers</ListSubheader>}>
-    {providers}
-  </List>
+  <List dense>{providers}</List>
 );
diff --git a/plugins/user-settings/src/components/FeatureFlagsList.tsx b/plugins/user-settings/src/components/FeatureFlagsList.tsx
index 0d7404c6fd..20c91f3e9a 100644
--- a/plugins/user-settings/src/components/FeatureFlagsList.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsList.tsx
@@ -15,7 +15,7 @@
  */
 
 import React, { useState, useEffect } from 'react';
-import { List, ListSubheader } from '@material-ui/core';
+import { List } from '@material-ui/core';
 import {
   useApi,
   featureFlagsApiRef,
@@ -54,7 +54,7 @@ export const FeatureFlagsList = ({ featureFlags }: Props) => {
   };
 
   return (
-    <List dense subheader={<ListSubheader>Feature Flags</ListSubheader>}>
+    <List dense>
       {featureFlags.map(featureFlag => {
         const enabled = Boolean(state[featureFlag.name]);
 
diff --git a/plugins/user-settings/src/components/SettingsDialog.tsx b/plugins/user-settings/src/components/SettingsDialog.tsx
index 69ec4fb8ee..5aa13d90e4 100644
--- a/plugins/user-settings/src/components/SettingsDialog.tsx
+++ b/plugins/user-settings/src/components/SettingsDialog.tsx
@@ -14,13 +14,13 @@
  * limitations under the License.
  */
 
-import React from 'react';
+import React, { ChangeEvent, RefObject, useEffect, useState } from 'react';
 import {
   Card,
   CardContent,
   CardHeader,
   makeStyles,
-  Divider,
+  PopoverActions,
 } from '@material-ui/core';
 import { AppSettingsList } from './AppSettingsList';
 import { AuthProvidersList } from './AuthProviderList';
@@ -28,28 +28,53 @@ import { FeatureFlagsList } from './FeatureFlagsList';
 import { SignInAvatar } from './SignInAvatar';
 import { UserSettingsMenu } from './UserSettingsMenu';
 import { useUserProfile } from './useUserProfileInfo';
-import { useApi, featureFlagsApiRef } from '@backstage/core';
+import {
+  useApi,
+  featureFlagsApiRef,
+  TabbedCard,
+  CardTab,
+  InfoCard,
+} from '@backstage/core';
 import { ConfiguredProviderSettings } from './ConfiguredProviderSettings';
 import { ProviderSettings } from './UserSettings';
+import { Alert } from '@material-ui/lab';
 
 const useStyles = makeStyles({
   root: {
     minWidth: 400,
+    maxWidth: 500,
   },
 });
 
 type Props = {
+  popoverActionRef: RefObject<PopoverActions | null>;
   providerSettings?: ProviderSettings;
 };
 
-export const SettingsDialog = ({ providerSettings }: Props) => {
+export const SettingsDialog = ({
+  popoverActionRef,
+  providerSettings,
+}: Props) => {
   const classes = useStyles();
   const { profile, displayName } = useUserProfile();
   const featureFlagsApi = useApi(featureFlagsApiRef);
   const featureFlags = featureFlagsApi.getRegisteredFlags();
+  const [selectedTab, setSelectedTab] = useState<string | number>('auth');
 
   const providers = providerSettings ?? <ConfiguredProviderSettings />;
 
+  const handleChange = (
+    _ev: ChangeEvent<{}>,
+    newSelectedTab: string | number,
+  ) => {
+    setSelectedTab(newSelectedTab);
+  };
+
+  // Update the position of the popover to handle different heights
+  useEffect(() => {
+    popoverActionRef?.current?.updatePosition();
+  }, [selectedTab, popoverActionRef]);
+
   return (
     <Card className={classes.root}>
       <CardHeader
@@ -59,15 +84,34 @@ export const SettingsDialog = ({ providerSettings }: Props) => {
         subheader={profile.email}
       />
       <CardContent>
-        <AppSettingsList />
-        <Divider />
-        <AuthProvidersList providers={providers} />
-        {featureFlags.length > 0 && (
-          <>
-            <Divider />
-            <FeatureFlagsList featureFlags={featureFlags} />
-          </>
-        )}
+        <InfoCard
+          title="App Settings"
+          subheader="General settings related to how the app feels and looks"
+          variant="flat"
+          noPadding
+        >
+          <AppSettingsList />
+        </InfoCard>
+        <TabbedCard
+          title="Additional Settings"
+          subheader="Settings that are specific to a plugin, or feature of the app"
+          variant="flat"
+          value={selectedTab}
+          onChange={handleChange}
+          noPadding
+        >
+          <CardTab value="auth" label="Auth Providers">
+            <AuthProvidersList providers={providers} />
+          </CardTab>
+          <CardTab value="flags" label="Feature Flags">
+            {featureFlags.length > 0 ? (
+              <FeatureFlagsList featureFlags={featureFlags} />
+            ) : (
+              // TODO(marcuseide): Replace with empty state component
+              <Alert severity="info">No registered Feature Flags found</Alert>
+            )}
+          </CardTab>
+        </TabbedCard>
       </CardContent>
     </Card>
   );
diff --git a/plugins/user-settings/src/components/UserSettings.tsx b/plugins/user-settings/src/components/UserSettings.tsx
index c91002d7d7..b117d40acb 100644
--- a/plugins/user-settings/src/components/UserSettings.tsx
+++ b/plugins/user-settings/src/components/UserSettings.tsx
@@ -15,7 +15,7 @@
  */
 
 import React, { useEffect, useContext } from 'react';
-import { Popover } from '@material-ui/core';
+import { Popover, PopoverActions } from '@material-ui/core';
 import { SignInAvatar } from './SignInAvatar';
 import { SettingsDialog } from './SettingsDialog';
 import { SidebarItem, SidebarContext } from '@backstage/core';
@@ -41,6 +41,7 @@ export const UserSettings = ({ providerSettings }: Props) => {
   const [anchorEl, setAnchorEl] = React.useState<HTMLButtonElement | undefined>(
     undefined,
   );
+  const popoverActionRef = React.useRef<PopoverActions | null>(null);
 
   const handleOpen = (event?: React.MouseEvent<HTMLButtonElement>) => {
     setAnchorEl(event?.currentTarget ?? undefined);
@@ -66,6 +67,7 @@ export const UserSettings = ({ providerSettings }: Props) => {
         icon={SidebarAvatar}
       />
       <Popover
+        action={popoverActionRef}
         open={open}
         anchorEl={anchorEl}
         onClose={handleClose}
@@ -78,7 +80,10 @@ export const UserSettings = ({ providerSettings }: Props) => {
           horizontal: 'left',
         }}
       >
-        <SettingsDialog providerSettings={providerSettings} />
+        <SettingsDialog
+          popoverActionRef={popoverActionRef}
+          providerSettings={providerSettings}
+        />
       </Popover>
     </>
   );

From c09145da0f138d398e079ed09c9fb75287941cc9 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 25 Sep 2020 10:23:17 +0200
Subject: [PATCH 035/110] Refactor tooltip placements

---
 .../src/components/FeatureFlagsItem.tsx       | 18 +++---
 .../src/components/OAuthProviderSettings.tsx  |  1 +
 .../src/components/OIDCProviderSettings.tsx   |  1 +
 .../src/components/PinButton.tsx              | 35 ++++++-----
 .../src/components/ProviderSettingsItem.tsx   | 60 +++++++++----------
 .../src/components/ThemeToggle.tsx            | 34 ++++++++---
 6 files changed, 81 insertions(+), 68 deletions(-)

diff --git a/plugins/user-settings/src/components/FeatureFlagsItem.tsx b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
index 7f7f990e48..92065f2ed6 100644
--- a/plugins/user-settings/src/components/FeatureFlagsItem.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsItem.tsx
@@ -38,16 +38,16 @@ export const FlagItem = ({ flag, enabled, toggleHandler }: Props) => (
       secondary={`Registered in ${flag.pluginId} plugin`}
     />
     <ListItemSecondaryAction>
-      <ToggleButton
-        size="small"
-        value="flag"
-        selected={enabled}
-        onChange={() => toggleHandler(flag.name)}
-      >
-        <Tooltip placement="top" arrow title={enabled ? 'Disable' : 'Enable'}>
+      <Tooltip placement="top" arrow title={enabled ? 'Disable' : 'Enable'}>
+        <ToggleButton
+          size="small"
+          value="flag"
+          selected={enabled}
+          onChange={() => toggleHandler(flag.name)}
+        >
           <CheckIcon color={enabled ? 'primary' : undefined} />
-        </Tooltip>
-      </ToggleButton>
+        </ToggleButton>
+      </Tooltip>
     </ListItemSecondaryAction>
   </ListItem>
 );
diff --git a/plugins/user-settings/src/components/OAuthProviderSettings.tsx b/plugins/user-settings/src/components/OAuthProviderSettings.tsx
index 2ecc5536ea..669dd89822 100644
--- a/plugins/user-settings/src/components/OAuthProviderSettings.tsx
+++ b/plugins/user-settings/src/components/OAuthProviderSettings.tsx
@@ -71,6 +71,7 @@ export const OAuthProviderSettings: FC<OAuthProviderSidebarProps> = ({
   return (
     <ProviderSettingsItem
       title={title}
+      description={apiRef.description}
       icon={icon}
       signedIn={signedIn}
       api={api}
diff --git a/plugins/user-settings/src/components/OIDCProviderSettings.tsx b/plugins/user-settings/src/components/OIDCProviderSettings.tsx
index 1516b3514d..1e6005cb82 100644
--- a/plugins/user-settings/src/components/OIDCProviderSettings.tsx
+++ b/plugins/user-settings/src/components/OIDCProviderSettings.tsx
@@ -72,6 +72,7 @@ export const OIDCProviderSettings: FC<OIDCProviderSidebarProps> = ({
   return (
     <ProviderSettingsItem
       title={title}
+      description={apiRef.description}
       icon={icon}
       signedIn={signedIn}
       api={api}
diff --git a/plugins/user-settings/src/components/PinButton.tsx b/plugins/user-settings/src/components/PinButton.tsx
index be4024f954..8e50eae9d4 100644
--- a/plugins/user-settings/src/components/PinButton.tsx
+++ b/plugins/user-settings/src/components/PinButton.tsx
@@ -31,15 +31,8 @@ export const SidebarPinButton = () => {
     SidebarPinStateContext,
   );
 
-  const PinIcon = () => (
-    <Tooltip
-      placement="top"
-      arrow
-      title={`${isPinned ? 'Unpin' : 'Pin'} Sidebar`}
-    >
-      {isPinned ? <LockIcon color="primary" /> : <LockOpenIcon />}
-    </Tooltip>
-  );
+  const PinIcon = () =>
+    isPinned ? <LockIcon color="primary" /> : <LockOpenIcon />;
 
   return (
     <ListItem>
@@ -48,16 +41,22 @@ export const SidebarPinButton = () => {
         secondary="Prevent the sidebar from collapsing"
       />
       <ListItemSecondaryAction>
-        <ToggleButton
-          size="small"
-          value="pin"
-          selected={isPinned}
-          onChange={() => {
-            toggleSidebarPinState();
-          }}
+        <Tooltip
+          placement="top"
+          arrow
+          title={`${isPinned ? 'Unpin' : 'Pin'} Sidebar`}
         >
-          <PinIcon />
-        </ToggleButton>
+          <ToggleButton
+            size="small"
+            value="pin"
+            selected={isPinned}
+            onChange={() => {
+              toggleSidebarPinState();
+            }}
+          >
+            <PinIcon />
+          </ToggleButton>
+        </Tooltip>
       </ListItemSecondaryAction>
     </ListItem>
   );
diff --git a/plugins/user-settings/src/components/ProviderSettingsItem.tsx b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
index 018e6a1326..0fb3d3e97d 100644
--- a/plugins/user-settings/src/components/ProviderSettingsItem.tsx
+++ b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
@@ -35,51 +35,47 @@ import {
 
 type OAuthProviderSidebarProps = {
   title: string;
+  description: string;
   icon: IconComponent;
   apiRef: ApiRef<SessionApi>;
 };
 
 export const ProviderSettingsItem: FC<OAuthProviderSidebarProps> = ({
   title,
+  description,
   icon: Icon,
-  apiRef,
-}) => {
-  const api = useApi(apiRef);
-  const [signedIn, setSignedIn] = useState(false);
-
-  useEffect(() => {
-    let didCancel = false;
-
-    const subscription = api
-      .sessionState$()
-      .subscribe((sessionState: SessionState) => {
-        if (!didCancel) {
-          setSignedIn(sessionState === SessionState.SignedIn);
-        }
-      });
-
-    return () => {
-      didCancel = true;
-      subscription.unsubscribe();
-    };
-  }, [api]);
-
-  return (
-    <ListItem>
-      <ListItemIcon>
-        <Icon />
-      </ListItemIcon>
-      <ListItemText primary={title} />
-      <ListItemSecondaryAction>
+  signedIn,
+  api,
+  signInHandler,
+}: Props) => (
+  <ListItem>
+    <ListItemIcon>
+      <Icon />
+    </ListItemIcon>
+    <ListItemText
+      primary={title}
+      secondary={
+        <Tooltip placement="top" arrow title={description}>
+          <span>{description}</span>
+        </Tooltip>
+      }
+      secondaryTypographyProps={{ noWrap: true, style: { width: '80%' } }}
+    />
+    <ListItemSecondaryAction>
+      <Tooltip
+        placement="top"
+        arrow
+        title={signedIn ? `Sign out from ${title}` : `Sign in to ${title}`}
+      >
         <ToggleButton
           size="small"
           value={title}
           selected={signedIn}
-          onChange={() => (signedIn ? api.signOut() : api.signIn())}
+          onChange={() => (signedIn ? api.logout() : signInHandler())}
         >
           <PowerButton color={signedIn ? 'primary' : undefined} />
-        </Tooltip>
-      </ToggleButton>
+        </ToggleButton>
+      </Tooltip>
     </ListItemSecondaryAction>
   </ListItem>
 );
diff --git a/plugins/user-settings/src/components/ThemeToggle.tsx b/plugins/user-settings/src/components/ThemeToggle.tsx
index 9acfc3407f..166d0454c5 100644
--- a/plugins/user-settings/src/components/ThemeToggle.tsx
+++ b/plugins/user-settings/src/components/ThemeToggle.tsx
@@ -47,21 +47,34 @@ export const SidebarThemeToggle = () => {
     }
   };
 
+  // ToggleButtonGroup uses React.children.map instead of context
+  // so wrapping with Tooltip breaks ToggleButton functionality.
+  const TooltipToggleButton = ({
+    children,
+    title,
+    value,
+    ...props
+  }: {
+    children: JSX.Element;
+    title: string;
+    value: string;
+  }) => (
+    <Tooltip placement="top" arrow title={title}>
+      <ToggleButton value={value} {...props}>
+        {children}
+      </ToggleButton>
+    </Tooltip>
+  );
+
   const ThemeIcon = ({ theme }: { theme: AppTheme }) => {
     const themeIcon = themeIds.find(t => t.id === theme.id)?.icon;
-    const icon = themeIcon ? (
+    return themeIcon ? (
       cloneElement(themeIcon, {
         color: themeId === theme.id ? 'primary' : undefined,
       })
     ) : (
       <AutoIcon color={themeId === theme.id ? 'primary' : undefined} />
     );
-
-    return (
-      <Tooltip placement="top" arrow title={`Select ${theme.variant} theme`}>
-        {icon}
-      </Tooltip>
-    );
   };
 
   return (
@@ -75,9 +88,12 @@ export const SidebarThemeToggle = () => {
           onChange={handleSetTheme}
         >
           {themeIds.map(theme => (
-            <ToggleButton key={theme.id} value={theme.variant}>
+            <TooltipToggleButton
+              title={`Select ${theme.variant} theme`}
+              value={theme.variant}
+            >
               <ThemeIcon theme={theme} />
-            </ToggleButton>
+            </TooltipToggleButton>
           ))}
           <ToggleButton value="auto">
             <Tooltip placement="top" arrow title="Select auto theme">

From 74d3579f49cc7ea5b008a4be483c19e304f514be Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Mon, 28 Sep 2020 09:16:27 +0200
Subject: [PATCH 036/110] Add tests

---
 plugins/user-settings/package.json            |  1 +
 .../src/components/AppSettingsList.tsx        |  8 +-
 .../ConfiguredProviderSettings.test.tsx       | 80 +++++++++++++++++++
 .../src/components/PinButton.test.tsx         | 42 ++++++++++
 .../src/components/PinButton.tsx              |  2 +-
 .../src/components/SettingsDialog.test.tsx    | 50 ++++++++++++
 .../src/components/ThemeToggle.test.tsx       | 58 ++++++++++++++
 .../src/components/ThemeToggle.tsx            |  5 +-
 .../src/components/UserSettings.test.tsx      | 26 ++++++
 .../src/components/UserSettingsMenu.test.tsx  | 33 ++++++++
 .../src/components/UserSettingsMenu.tsx       |  2 +-
 plugins/user-settings/src/plugin.ts           | 10 ---
 12 files changed, 299 insertions(+), 18 deletions(-)
 create mode 100644 plugins/user-settings/src/components/ConfiguredProviderSettings.test.tsx
 create mode 100644 plugins/user-settings/src/components/PinButton.test.tsx
 create mode 100644 plugins/user-settings/src/components/SettingsDialog.test.tsx
 create mode 100644 plugins/user-settings/src/components/ThemeToggle.test.tsx
 create mode 100644 plugins/user-settings/src/components/UserSettings.test.tsx
 create mode 100644 plugins/user-settings/src/components/UserSettingsMenu.test.tsx

diff --git a/plugins/user-settings/package.json b/plugins/user-settings/package.json
index 97fbb23301..a6bc784942 100644
--- a/plugins/user-settings/package.json
+++ b/plugins/user-settings/package.json
@@ -33,6 +33,7 @@
   "devDependencies": {
     "@backstage/cli": "^0.1.1-alpha.21",
     "@backstage/dev-utils": "^0.1.1-alpha.21",
+    "@backstage/test-utils": "^0.1.1-alpha.21",
     "@testing-library/jest-dom": "^5.10.1",
     "@testing-library/react": "^10.4.1",
     "@testing-library/user-event": "^12.0.7",
diff --git a/plugins/user-settings/src/components/AppSettingsList.tsx b/plugins/user-settings/src/components/AppSettingsList.tsx
index ab106cf28e..3f2b455520 100644
--- a/plugins/user-settings/src/components/AppSettingsList.tsx
+++ b/plugins/user-settings/src/components/AppSettingsList.tsx
@@ -15,12 +15,12 @@
  */
 import React from 'react';
 import { List } from '@material-ui/core';
-import { SidebarThemeToggle } from './ThemeToggle';
-import { SidebarPinButton } from './PinButton';
+import { ThemeToggle } from './ThemeToggle';
+import { PinButton } from './PinButton';
 
 export const AppSettingsList = () => (
   <List dense>
-    <SidebarThemeToggle />
-    <SidebarPinButton />
+    <ThemeToggle />
+    <PinButton />
   </List>
 );
diff --git a/plugins/user-settings/src/components/ConfiguredProviderSettings.test.tsx b/plugins/user-settings/src/components/ConfiguredProviderSettings.test.tsx
new file mode 100644
index 0000000000..d4d8c1cbc2
--- /dev/null
+++ b/plugins/user-settings/src/components/ConfiguredProviderSettings.test.tsx
@@ -0,0 +1,80 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 {
+  ApiProvider,
+  ApiRegistry,
+  configApiRef,
+  ConfigReader,
+  googleAuthApiRef,
+} from '@backstage/core';
+import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
+import { fireEvent } from '@testing-library/react';
+import * as React from 'react';
+import { ConfiguredProviderSettings } from './ConfiguredProviderSettings';
+
+const mockSignInHandler = jest.fn().mockReturnValue('');
+const mockGoogleAuth = {
+  sessionState$: () => ({
+    subscribe: () => ({
+      unsubscribe: () => null,
+    }),
+  }),
+  getIdToken: mockSignInHandler,
+};
+
+const createConfig = () =>
+  ConfigReader.fromConfigs([
+    {
+      context: '',
+      data: {
+        auth: {
+          providers: {
+            google: { development: {} },
+          },
+        },
+      },
+    },
+  ]);
+
+const config = createConfig();
+
+const apiRegistry = ApiRegistry.from([
+  [configApiRef, config],
+  [googleAuthApiRef, mockGoogleAuth],
+]);
+
+describe('<ConfiguredProviderSettings />', () => {
+  it('displays a provider and calls its sign-in handler on click', async () => {
+    const rendered = await renderWithEffects(
+      wrapInTestApp(
+        <ApiProvider apis={apiRegistry}>
+          <ConfiguredProviderSettings />
+        </ApiProvider>,
+      ),
+    );
+
+    expect(rendered.getByText('Google')).toBeInTheDocument();
+    expect(
+      rendered.getByText(googleAuthApiRef.description),
+    ).toBeInTheDocument();
+
+    const button = rendered.getByTitle('Sign in to Google');
+    expect(mockSignInHandler).toHaveBeenCalledTimes(1);
+    fireEvent.click(button);
+    expect(mockSignInHandler).toHaveBeenCalledTimes(2);
+  });
+});
diff --git a/plugins/user-settings/src/components/PinButton.test.tsx b/plugins/user-settings/src/components/PinButton.test.tsx
new file mode 100644
index 0000000000..a800193c06
--- /dev/null
+++ b/plugins/user-settings/src/components/PinButton.test.tsx
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { SidebarPinStateContext } from '@backstage/core';
+import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
+import { fireEvent } from '@testing-library/react';
+import * as React from 'react';
+import { PinButton } from './PinButton';
+
+describe('<PinButton />', () => {
+  it('toggles the pin sidebar button', async () => {
+    const mockToggleFn = jest.fn();
+    const rendered = await renderWithEffects(
+      wrapInTestApp(
+        <SidebarPinStateContext.Provider
+          value={{ isPinned: false, toggleSidebarPinState: mockToggleFn }}
+        >
+          <PinButton />
+        </SidebarPinStateContext.Provider>,
+      ),
+    );
+
+    expect(rendered.getByText('Pin Sidebar')).toBeInTheDocument();
+
+    const pinButton = rendered.getByTitle('Pin Sidebar');
+    fireEvent.click(pinButton);
+    expect(mockToggleFn).toHaveBeenCalled();
+  });
+});
diff --git a/plugins/user-settings/src/components/PinButton.tsx b/plugins/user-settings/src/components/PinButton.tsx
index 8e50eae9d4..f8017ef215 100644
--- a/plugins/user-settings/src/components/PinButton.tsx
+++ b/plugins/user-settings/src/components/PinButton.tsx
@@ -26,7 +26,7 @@ import LockOpenIcon from '@material-ui/icons/LockOpen';
 import { ToggleButton } from '@material-ui/lab';
 import { SidebarPinStateContext } from '@backstage/core';
 
-export const SidebarPinButton = () => {
+export const PinButton = () => {
   const { isPinned, toggleSidebarPinState } = useContext(
     SidebarPinStateContext,
   );
diff --git a/plugins/user-settings/src/components/SettingsDialog.test.tsx b/plugins/user-settings/src/components/SettingsDialog.test.tsx
new file mode 100644
index 0000000000..d738c2ece0
--- /dev/null
+++ b/plugins/user-settings/src/components/SettingsDialog.test.tsx
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 {
+  ApiProvider,
+  ApiRegistry,
+  FeatureFlags,
+  featureFlagsApiRef,
+} from '@backstage/core';
+import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
+import * as React from 'react';
+import { SettingsDialog } from './SettingsDialog';
+
+const apiRegistry = ApiRegistry.from([
+  [featureFlagsApiRef, new FeatureFlags()],
+]);
+
+describe('<SettingsDialog />', () => {
+  const mockRef = { current: null };
+
+  it('displays the users name and email, and the tabs and titles', async () => {
+    const rendered = await renderWithEffects(
+      wrapInTestApp(
+        <ApiProvider apis={apiRegistry}>
+          <SettingsDialog popoverActionRef={mockRef} />
+        </ApiProvider>,
+      ),
+    );
+
+    expect(rendered.getByText('Guest')).toBeInTheDocument();
+    expect(rendered.getByText('guest@example.com')).toBeInTheDocument();
+    expect(rendered.getByText('App Settings')).toBeInTheDocument();
+    expect(rendered.getByText('Additional Settings')).toBeInTheDocument();
+    expect(rendered.getByText('Auth Providers')).toBeInTheDocument();
+    expect(rendered.getByText('Feature Flags')).toBeInTheDocument();
+  });
+});
diff --git a/plugins/user-settings/src/components/ThemeToggle.test.tsx b/plugins/user-settings/src/components/ThemeToggle.test.tsx
new file mode 100644
index 0000000000..df36a985f6
--- /dev/null
+++ b/plugins/user-settings/src/components/ThemeToggle.test.tsx
@@ -0,0 +1,58 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 {
+  ApiProvider,
+  ApiRegistry,
+  appThemeApiRef,
+  AppThemeSelector,
+} from '@backstage/core';
+import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
+import { lightTheme } from '@backstage/theme';
+import { fireEvent } from '@testing-library/react';
+import * as React from 'react';
+import { ThemeToggle } from './ThemeToggle';
+
+const mockTheme = {
+  id: 'light',
+  title: 'Mock Theme',
+  variant: 'light' as 'light', // wut?
+  theme: lightTheme,
+};
+
+const apiRegistry = ApiRegistry.from([
+  [appThemeApiRef, AppThemeSelector.createWithStorage([mockTheme])],
+]);
+
+describe('<ThemeToggle />', () => {
+  it('toggles the theme select button', async () => {
+    const themeApi = apiRegistry.get(appThemeApiRef);
+    const rendered = await renderWithEffects(
+      wrapInTestApp(
+        <ApiProvider apis={apiRegistry}>
+          <ThemeToggle />
+        </ApiProvider>,
+      ),
+    );
+
+    expect(rendered.getByText('Theme')).toBeInTheDocument();
+
+    const themeButton = rendered.getByTitle('Select Mock Theme');
+    expect(themeApi?.getActiveThemeId()).toBe(undefined);
+    fireEvent.click(themeButton);
+    expect(themeApi?.getActiveThemeId()).toBe('light');
+  });
+});
diff --git a/plugins/user-settings/src/components/ThemeToggle.tsx b/plugins/user-settings/src/components/ThemeToggle.tsx
index 166d0454c5..b041e1f76b 100644
--- a/plugins/user-settings/src/components/ThemeToggle.tsx
+++ b/plugins/user-settings/src/components/ThemeToggle.tsx
@@ -27,7 +27,7 @@ import {
   Tooltip,
 } from '@material-ui/core';
 
-export const SidebarThemeToggle = () => {
+export const ThemeToggle = () => {
   const appThemeApi = useApi(appThemeApiRef);
   const themeId = useObservable(
     appThemeApi.activeThemeId$(),
@@ -89,7 +89,8 @@ export const SidebarThemeToggle = () => {
         >
           {themeIds.map(theme => (
             <TooltipToggleButton
-              title={`Select ${theme.variant} theme`}
+              key={theme.id}
+              title={`Select ${theme.title}`}
               value={theme.variant}
             >
               <ThemeIcon theme={theme} />
diff --git a/plugins/user-settings/src/components/UserSettings.test.tsx b/plugins/user-settings/src/components/UserSettings.test.tsx
new file mode 100644
index 0000000000..1d43f4093e
--- /dev/null
+++ b/plugins/user-settings/src/components/UserSettings.test.tsx
@@ -0,0 +1,26 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 * as React from 'react';
+import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
+import { UserSettings } from './UserSettings';
+
+describe('<UserSettings />', () => {
+  it('renders', async () => {
+    const rendered = await renderWithEffects(wrapInTestApp(<UserSettings />));
+    expect(rendered.getByText('G')).toBeInTheDocument();
+  });
+});
diff --git a/plugins/user-settings/src/components/UserSettingsMenu.test.tsx b/plugins/user-settings/src/components/UserSettingsMenu.test.tsx
new file mode 100644
index 0000000000..b1ad059611
--- /dev/null
+++ b/plugins/user-settings/src/components/UserSettingsMenu.test.tsx
@@ -0,0 +1,33 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
+import { fireEvent } from '@testing-library/react';
+import * as React from 'react';
+import { UserSettingsMenu } from './UserSettingsMenu';
+
+describe('<UserSettingsMenu />', () => {
+  it('displays a menu button with a sign-out option', async () => {
+    const rendered = await renderWithEffects(
+      wrapInTestApp(<UserSettingsMenu />),
+    );
+
+    const menuButton = rendered.getByLabelText('more');
+    fireEvent.click(menuButton);
+
+    expect(rendered.getByText('Sign Out')).toBeInTheDocument();
+  });
+});
diff --git a/plugins/user-settings/src/components/UserSettingsMenu.tsx b/plugins/user-settings/src/components/UserSettingsMenu.tsx
index 40b101fe4d..19c3ee4e2d 100644
--- a/plugins/user-settings/src/components/UserSettingsMenu.tsx
+++ b/plugins/user-settings/src/components/UserSettingsMenu.tsx
@@ -39,7 +39,7 @@ export const UserSettingsMenu = () => {
 
   return (
     <>
-      <IconButton onClick={handleOpen}>
+      <IconButton aria-label="more" onClick={handleOpen}>
         <MoreVertIcon />
       </IconButton>
       <Menu anchorEl={anchorEl} open={open} onClose={handleClose}>
diff --git a/plugins/user-settings/src/plugin.ts b/plugins/user-settings/src/plugin.ts
index 5e5461f3b1..4b556180f2 100644
--- a/plugins/user-settings/src/plugin.ts
+++ b/plugins/user-settings/src/plugin.ts
@@ -14,17 +14,7 @@
  * limitations under the License.
  */
 import { createPlugin } from '@backstage/core';
-// import ExampleComponent from './components/ExampleComponent';
-
-// export const rootRouteRef = createRouteRef({
-//   path: '/user-settings',
-//   title: 'user-settings',
-// });
 
 export const plugin = createPlugin({
   id: 'user-settings',
-  // apis: [createApiFactory(GCPApiRef, new GCPClient())],
-  // register({ router }) {
-  //   router.addRoute(rootRouteRef, ExampleComponent);
-  // },
 });

From 9c9031b7888052830ccbf21039a919acb3872d46 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Mon, 28 Sep 2020 09:21:03 +0200
Subject: [PATCH 037/110] Add instructions to readme

---
 plugins/user-settings/README.md | 41 +++++++++++++++++++++++++++++----
 1 file changed, 36 insertions(+), 5 deletions(-)

diff --git a/plugins/user-settings/README.md b/plugins/user-settings/README.md
index 23d3e48fee..72da278b1e 100644
--- a/plugins/user-settings/README.md
+++ b/plugins/user-settings/README.md
@@ -4,10 +4,41 @@ Welcome to the user-settings plugin!
 
 _This plugin was created through the Backstage CLI_
 
-## Getting started
+## About the plugin
 
-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 [/user-settings](http://localhost:3000/user-settings).
+This plugin is intended to be used within the [`<Sidebar>`](https://backstage.io/storybook/?path=/story/sidebar--sample-sidebar). It provides an item to the sidebar that will render an Avatar of the current signed in user, and when clicked display a settings UI where the user can control different settings across the App.
 
-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.
+## Usage
+
+Add the component to the sidebar:
+
+```ts
+import { UserSettings } from '@backstage/plugin-user-settings';
+
+<SidebarPage>
+  <Sidebar>
+    <UserSettings />
+  </Sidebar>
+</SidebarPage>;
+```
+
+### Props
+
+**Auth Providers**
+
+By default, the plugin provides a list of configured authentication providers is fetched from `app-config.yaml` and displayed in the "Auth Providers" tab.
+
+If you want to supply your own custom list of Authentication Providers, use the `providerSettings` prop:
+
+```ts
+const MyAuthProviders = () => (
+  <ListItem>
+    <ListItemText primary="example" />
+    <ListItemSecondaryAction={someAction}>
+  </ListItem>
+);
+
+<UserSettings providerSettings={<MyAuthProviders />} />
+```
+
+> **Note that the list of providers expects to be rendered within a MUI [`<List>`](https://material-ui.com/components/lists/)**

From 790cd5ac4943b13a3cc7b84bfc69abf26c8dd207 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Mon, 28 Sep 2020 10:26:42 +0200
Subject: [PATCH 038/110] Update storybook for Sidebar

---
 .../src/layout/Sidebar/Sidebar.stories.tsx    | 67 +++++++++++++++----
 1 file changed, 55 insertions(+), 12 deletions(-)

diff --git a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
index 61975a728a..1b646fab8a 100644
--- a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
+++ b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
@@ -22,14 +22,27 @@ import {
   SidebarDivider,
   SidebarSearchField,
   SidebarSpace,
+<<<<<<< HEAD
   SidebarUserSettings,
   ProviderSettingsItem,
+=======
+>>>>>>> a4e66bae0... Update storybook for Sidebar
 } from '.';
 import HomeOutlinedIcon from '@material-ui/icons/HomeOutlined';
 import AddCircleOutlineIcon from '@material-ui/icons/AddCircleOutline';
-import Star from '@material-ui/icons/Star';
 import { MemoryRouter } from 'react-router-dom';
-import { githubAuthApiRef } from '@backstage/core-api';
+import {
+  ApiProvider,
+  ApiRegistry,
+  appThemeApiRef,
+  AppThemeSelector,
+  configApiRef,
+  ConfigReader,
+  FeatureFlags,
+  featureFlagsApiRef,
+} from '@backstage/core-api';
+// eslint-disable-next-line import/no-extraneous-dependencies
+import { UserSettings } from '@backstage/plugin-user-settings';
 
 export default {
   title: 'Sidebar',
@@ -57,15 +70,45 @@ export const SampleSidebar = () => (
     <SidebarDivider />
     <SidebarIntro />
     <SidebarSpace />
-    <SidebarDivider />
-    <SidebarUserSettings
-      providerSettings={
-        <ProviderSettingsItem
-          title="Github"
-          apiRef={githubAuthApiRef}
-          icon={Star}
-        />
-      }
-    />
+  </Sidebar>
+);
+
+const createConfig = () =>
+  ConfigReader.fromConfigs([
+    {
+      context: '',
+      data: {
+        auth: {
+          providers: {
+            google: { development: {} },
+          },
+        },
+      },
+    },
+  ]);
+
+const config = createConfig();
+
+const apis = ApiRegistry.from([
+  [configApiRef, config],
+  [featureFlagsApiRef, new FeatureFlags()],
+  [appThemeApiRef, AppThemeSelector.createWithStorage([])],
+]);
+
+export const WithUserSettingsPlugin = () => (
+  <Sidebar>
+    {/* <SidebarLogo /> */}
+    <SidebarSearchField onSearch={handleSearch} />
+    <SidebarDivider />
+    <SidebarItem icon={HomeOutlinedIcon} to="#" text="Home" />
+    <SidebarItem icon={HomeOutlinedIcon} to="#" text="Plugins" />
+    <SidebarItem icon={AddCircleOutlineIcon} to="#" text="Create..." />
+    <SidebarDivider />
+    <SidebarIntro />
+    <SidebarSpace />
+    <SidebarDivider />
+    <ApiProvider apis={apis}>
+      <UserSettings />
+    </ApiProvider>
   </Sidebar>
 );

From d33fa314cd96fe6b815bc1ab223f5e950757dd2a Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 29 Sep 2020 09:26:57 +0200
Subject: [PATCH 039/110] Fix merge conflicts

---
 .../src/layout/Sidebar/Sidebar.stories.tsx    |   5 -
 plugins/user-settings/package.json            |   2 +-
 ...t.tsx => DefaultProviderSettings.test.tsx} |   9 +-
 ...ttings.tsx => DefaultProviderSettings.tsx} |  19 ++-
 .../src/components/OAuthProviderSettings.tsx  |  81 -------------
 .../src/components/OIDCProviderSettings.tsx   |  82 -------------
 .../src/components/ProviderSettingsItem.tsx   | 110 ++++++++++--------
 .../src/components/SettingsDialog.tsx         |   6 +-
 8 files changed, 80 insertions(+), 234 deletions(-)
 rename plugins/user-settings/src/components/{ConfiguredProviderSettings.test.tsx => DefaultProviderSettings.test.tsx} (90%)
 rename plugins/user-settings/src/components/{ConfiguredProviderSettings.tsx => DefaultProviderSettings.tsx} (83%)
 delete mode 100644 plugins/user-settings/src/components/OAuthProviderSettings.tsx
 delete mode 100644 plugins/user-settings/src/components/OIDCProviderSettings.tsx

diff --git a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
index 1b646fab8a..14bf6e69ed 100644
--- a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
+++ b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
@@ -22,11 +22,6 @@ import {
   SidebarDivider,
   SidebarSearchField,
   SidebarSpace,
-<<<<<<< HEAD
-  SidebarUserSettings,
-  ProviderSettingsItem,
-=======
->>>>>>> a4e66bae0... Update storybook for Sidebar
 } from '.';
 import HomeOutlinedIcon from '@material-ui/icons/HomeOutlined';
 import AddCircleOutlineIcon from '@material-ui/icons/AddCircleOutline';
diff --git a/plugins/user-settings/package.json b/plugins/user-settings/package.json
index a6bc784942..ad2c2b0dbd 100644
--- a/plugins/user-settings/package.json
+++ b/plugins/user-settings/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-user-settings",
-  "version": "0.1.1-alpha.21",
+  "version": "0.1.1-alpha.23",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "license": "Apache-2.0",
diff --git a/plugins/user-settings/src/components/ConfiguredProviderSettings.test.tsx b/plugins/user-settings/src/components/DefaultProviderSettings.test.tsx
similarity index 90%
rename from plugins/user-settings/src/components/ConfiguredProviderSettings.test.tsx
rename to plugins/user-settings/src/components/DefaultProviderSettings.test.tsx
index d4d8c1cbc2..8f6e4b72dc 100644
--- a/plugins/user-settings/src/components/ConfiguredProviderSettings.test.tsx
+++ b/plugins/user-settings/src/components/DefaultProviderSettings.test.tsx
@@ -24,7 +24,7 @@ import {
 import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
 import { fireEvent } from '@testing-library/react';
 import * as React from 'react';
-import { ConfiguredProviderSettings } from './ConfiguredProviderSettings';
+import { DefaultProviderSettings } from './DefaultProviderSettings';
 
 const mockSignInHandler = jest.fn().mockReturnValue('');
 const mockGoogleAuth = {
@@ -33,7 +33,7 @@ const mockGoogleAuth = {
       unsubscribe: () => null,
     }),
   }),
-  getIdToken: mockSignInHandler,
+  signIn: mockSignInHandler,
 };
 
 const createConfig = () =>
@@ -62,7 +62,7 @@ describe('<ConfiguredProviderSettings />', () => {
     const rendered = await renderWithEffects(
       wrapInTestApp(
         <ApiProvider apis={apiRegistry}>
-          <ConfiguredProviderSettings />
+          <DefaultProviderSettings />
         </ApiProvider>,
       ),
     );
@@ -73,8 +73,7 @@ describe('<ConfiguredProviderSettings />', () => {
     ).toBeInTheDocument();
 
     const button = rendered.getByTitle('Sign in to Google');
-    expect(mockSignInHandler).toHaveBeenCalledTimes(1);
     fireEvent.click(button);
-    expect(mockSignInHandler).toHaveBeenCalledTimes(2);
+    expect(mockSignInHandler).toHaveBeenCalledTimes(1);
   });
 });
diff --git a/plugins/user-settings/src/components/ConfiguredProviderSettings.tsx b/plugins/user-settings/src/components/DefaultProviderSettings.tsx
similarity index 83%
rename from plugins/user-settings/src/components/ConfiguredProviderSettings.tsx
rename to plugins/user-settings/src/components/DefaultProviderSettings.tsx
index 99351e2984..e6e5c21d86 100644
--- a/plugins/user-settings/src/components/ConfiguredProviderSettings.tsx
+++ b/plugins/user-settings/src/components/DefaultProviderSettings.tsx
@@ -21,15 +21,13 @@ import {
   oauth2ApiRef,
   oktaAuthApiRef,
   microsoftAuthApiRef,
-  samlAuthApiRef,
   useApi,
 } from '@backstage/core';
 import Star from '@material-ui/icons/Star';
 import React from 'react';
-import { OAuthProviderSettings } from './OAuthProviderSettings';
-import { OIDCProviderSettings } from './OIDCProviderSettings';
+import { ProviderSettingsItem } from './ProviderSettingsItem';
 
-export const ConfiguredProviderSettings = () => {
+export const DefaultProviderSettings = () => {
   const configApi = useApi(configApiRef);
   const providersConfig = configApi.getOptionalConfig('auth.providers');
   const providers = providersConfig?.keys() ?? [];
@@ -39,6 +37,7 @@ export const ConfiguredProviderSettings = () => {
       {providers.includes('google') && (
         <ProviderSettingsItem
           title="Google"
+          description={googleAuthApiRef.description}
           apiRef={googleAuthApiRef}
           icon={Star}
         />
@@ -46,6 +45,7 @@ export const ConfiguredProviderSettings = () => {
       {providers.includes('microsoft') && (
         <ProviderSettingsItem
           title="Microsoft"
+          description={microsoftAuthApiRef.description}
           apiRef={microsoftAuthApiRef}
           icon={Star}
         />
@@ -53,6 +53,7 @@ export const ConfiguredProviderSettings = () => {
       {providers.includes('github') && (
         <ProviderSettingsItem
           title="Github"
+          description={githubAuthApiRef.description}
           apiRef={githubAuthApiRef}
           icon={Star}
         />
@@ -60,6 +61,7 @@ export const ConfiguredProviderSettings = () => {
       {providers.includes('gitlab') && (
         <ProviderSettingsItem
           title="Gitlab"
+          description={gitlabAuthApiRef.description}
           apiRef={gitlabAuthApiRef}
           icon={Star}
         />
@@ -67,20 +69,15 @@ export const ConfiguredProviderSettings = () => {
       {providers.includes('okta') && (
         <ProviderSettingsItem
           title="Okta"
+          description={oktaAuthApiRef.description}
           apiRef={oktaAuthApiRef}
           icon={Star}
         />
       )}
-      {providers.includes('saml') && (
-        <ProviderSettingsItem
-          title="SAML"
-          apiRef={samlAuthApiRef}
-          icon={Star}
-        />
-      )}
       {providers.includes('oauth2') && (
         <ProviderSettingsItem
           title="YourOrg"
+          description={oauth2ApiRef.description}
           apiRef={oauth2ApiRef}
           icon={Star}
         />
diff --git a/plugins/user-settings/src/components/OAuthProviderSettings.tsx b/plugins/user-settings/src/components/OAuthProviderSettings.tsx
deleted file mode 100644
index 669dd89822..0000000000
--- a/plugins/user-settings/src/components/OAuthProviderSettings.tsx
+++ /dev/null
@@ -1,81 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 {
-  ApiRef,
-  OAuthApi,
-  SessionStateApi,
-  useApi,
-  Subscription,
-  IconComponent,
-  SessionState,
-} from '@backstage/core';
-import React, { FC, useState, useEffect } from 'react';
-import { ProviderSettingsItem } from './ProviderSettingsItem';
-
-type OAuthProviderSidebarProps = {
-  title: string;
-  icon: IconComponent;
-  apiRef: ApiRef<OAuthApi & SessionStateApi>;
-};
-
-export const OAuthProviderSettings: FC<OAuthProviderSidebarProps> = ({
-  title,
-  icon,
-  apiRef,
-}) => {
-  const api = useApi(apiRef);
-  const [signedIn, setSignedIn] = useState(false);
-
-  useEffect(() => {
-    let didCancel = false;
-
-    const checkSession = async () => {
-      const session = await api.getAccessToken('', { optional: true });
-      if (!didCancel) {
-        setSignedIn(!!session);
-      }
-    };
-    let subscription: Subscription;
-    const observeSession = () => {
-      subscription = api
-        .sessionState$()
-        .subscribe((sessionState: SessionState) => {
-          if (!didCancel) {
-            setSignedIn(sessionState === SessionState.SignedIn);
-          }
-        });
-    };
-
-    checkSession();
-    observeSession();
-    return () => {
-      didCancel = true;
-      subscription.unsubscribe();
-    };
-  }, [api]);
-
-  return (
-    <ProviderSettingsItem
-      title={title}
-      description={apiRef.description}
-      icon={icon}
-      signedIn={signedIn}
-      api={api}
-      signInHandler={() => api.getAccessToken()}
-    />
-  );
-};
diff --git a/plugins/user-settings/src/components/OIDCProviderSettings.tsx b/plugins/user-settings/src/components/OIDCProviderSettings.tsx
deleted file mode 100644
index 1e6005cb82..0000000000
--- a/plugins/user-settings/src/components/OIDCProviderSettings.tsx
+++ /dev/null
@@ -1,82 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 {
-  ApiRef,
-  OpenIdConnectApi,
-  SessionStateApi,
-  useApi,
-  Subscription,
-  IconComponent,
-  SessionState,
-} from '@backstage/core';
-import React, { FC, useState, useEffect } from 'react';
-import { ProviderSettingsItem } from './ProviderSettingsItem';
-
-export type OIDCProviderSidebarProps = {
-  title: string;
-  icon: IconComponent;
-  apiRef: ApiRef<OpenIdConnectApi & SessionStateApi>;
-};
-
-export const OIDCProviderSettings: FC<OIDCProviderSidebarProps> = ({
-  title,
-  icon,
-  apiRef,
-}) => {
-  const api = useApi(apiRef);
-  const [signedIn, setSignedIn] = useState(false);
-
-  useEffect(() => {
-    let didCancel = false;
-
-    const checkSession = async () => {
-      const session = await api.getIdToken({ optional: true });
-      if (!didCancel) {
-        setSignedIn(!!session);
-      }
-    };
-
-    let subscription: Subscription;
-    const observeSession = () => {
-      subscription = api
-        .sessionState$()
-        .subscribe((sessionState: SessionState) => {
-          if (!didCancel) {
-            setSignedIn(sessionState === SessionState.SignedIn);
-          }
-        });
-    };
-
-    checkSession();
-    observeSession();
-    return () => {
-      didCancel = true;
-      subscription.unsubscribe();
-    };
-  }, [api]);
-
-  return (
-    <ProviderSettingsItem
-      title={title}
-      description={apiRef.description}
-      icon={icon}
-      signedIn={signedIn}
-      api={api}
-      signInHandler={() => api.getIdToken()}
-    />
-  );
-};
diff --git a/plugins/user-settings/src/components/ProviderSettingsItem.tsx b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
index 0fb3d3e97d..7213ee2b83 100644
--- a/plugins/user-settings/src/components/ProviderSettingsItem.tsx
+++ b/plugins/user-settings/src/components/ProviderSettingsItem.tsx
@@ -13,9 +13,14 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
-import React from 'react';
-import { IconComponent, OAuthApi, OpenIdConnectApi } from '@backstage/core';
+import React, { useEffect, useState } from 'react';
+import {
+  ApiRef,
+  SessionApi,
+  useApi,
+  IconComponent,
+  SessionState,
+} from '@backstage/core';
 import {
   ListItem,
   ListItemIcon,
@@ -25,57 +30,70 @@ import {
 } from '@material-ui/core';
 import PowerButton from '@material-ui/icons/PowerSettingsNew';
 import { ToggleButton } from '@material-ui/lab';
-import {
-  ApiRef,
-  SessionApi,
-  useApi,
-  IconComponent,
-  SessionState,
-} from '@backstage/core-api';
 
-type OAuthProviderSidebarProps = {
+type Props = {
   title: string;
   description: string;
   icon: IconComponent;
   apiRef: ApiRef<SessionApi>;
 };
 
-export const ProviderSettingsItem: FC<OAuthProviderSidebarProps> = ({
+export const ProviderSettingsItem = ({
   title,
   description,
   icon: Icon,
-  signedIn,
-  api,
-  signInHandler,
-}: Props) => (
-  <ListItem>
-    <ListItemIcon>
-      <Icon />
-    </ListItemIcon>
-    <ListItemText
-      primary={title}
-      secondary={
-        <Tooltip placement="top" arrow title={description}>
-          <span>{description}</span>
-        </Tooltip>
-      }
-      secondaryTypographyProps={{ noWrap: true, style: { width: '80%' } }}
-    />
-    <ListItemSecondaryAction>
-      <Tooltip
-        placement="top"
-        arrow
-        title={signedIn ? `Sign out from ${title}` : `Sign in to ${title}`}
-      >
-        <ToggleButton
-          size="small"
-          value={title}
-          selected={signedIn}
-          onChange={() => (signedIn ? api.logout() : signInHandler())}
+  apiRef,
+}: Props) => {
+  const api = useApi(apiRef);
+  const [signedIn, setSignedIn] = useState(false);
+
+  useEffect(() => {
+    let didCancel = false;
+
+    const subscription = api
+      .sessionState$()
+      .subscribe((sessionState: SessionState) => {
+        if (!didCancel) {
+          setSignedIn(sessionState === SessionState.SignedIn);
+        }
+      });
+
+    return () => {
+      didCancel = true;
+      subscription.unsubscribe();
+    };
+  }, [api]);
+
+  return (
+    <ListItem>
+      <ListItemIcon>
+        <Icon />
+      </ListItemIcon>
+      <ListItemText
+        primary={title}
+        secondary={
+          <Tooltip placement="top" arrow title={description}>
+            <span>{description}</span>
+          </Tooltip>
+        }
+        secondaryTypographyProps={{ noWrap: true, style: { width: '80%' } }}
+      />
+      <ListItemSecondaryAction>
+        <Tooltip
+          placement="top"
+          arrow
+          title={signedIn ? `Sign out from ${title}` : `Sign in to ${title}`}
         >
-          <PowerButton color={signedIn ? 'primary' : undefined} />
-        </ToggleButton>
-      </Tooltip>
-    </ListItemSecondaryAction>
-  </ListItem>
-);
+          <ToggleButton
+            size="small"
+            value={title}
+            selected={signedIn}
+            onChange={() => (signedIn ? api.signOut() : api.signIn())}
+          >
+            <PowerButton color={signedIn ? 'primary' : undefined} />
+          </ToggleButton>
+        </Tooltip>
+      </ListItemSecondaryAction>
+    </ListItem>
+  );
+};
diff --git a/plugins/user-settings/src/components/SettingsDialog.tsx b/plugins/user-settings/src/components/SettingsDialog.tsx
index 5aa13d90e4..82e744bec1 100644
--- a/plugins/user-settings/src/components/SettingsDialog.tsx
+++ b/plugins/user-settings/src/components/SettingsDialog.tsx
@@ -35,7 +35,7 @@ import {
   CardTab,
   InfoCard,
 } from '@backstage/core';
-import { ConfiguredProviderSettings } from './ConfiguredProviderSettings';
+import { DefaultProviderSettings } from './DefaultProviderSettings';
 import { ProviderSettings } from './UserSettings';
 import { Alert } from '@material-ui/lab';
 
@@ -61,7 +61,7 @@ export const SettingsDialog = ({
   const featureFlags = featureFlagsApi.getRegisteredFlags();
   const [selectedTab, setSelectedTab] = useState<string | number>('auth');
 
-  const providers = providerSettings ?? <ConfiguredProviderSettings />;
+  const providers = providerSettings ?? <DefaultProviderSettings />;
 
   const handleChange = (
     _ev: ChangeEvent<{}>,
@@ -107,7 +107,7 @@ export const SettingsDialog = ({
             {featureFlags.length > 0 ? (
               <FeatureFlagsList featureFlags={featureFlags} />
             ) : (
-              // TODO(marcuseide): Replace with empty state component
+              // TODO(marcuseide): Replace with empty state component?
               <Alert severity="info">No registered Feature Flags found</Alert>
             )}
           </CardTab>

From dbe126f75e094249871adc94d894195893ec06c6 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 29 Sep 2020 14:03:55 +0200
Subject: [PATCH 040/110] Update dependencies

---
 plugins/user-settings/package.json | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/plugins/user-settings/package.json b/plugins/user-settings/package.json
index ad2c2b0dbd..1c5d489747 100644
--- a/plugins/user-settings/package.json
+++ b/plugins/user-settings/package.json
@@ -21,8 +21,8 @@
     "clean": "backstage-cli clean"
   },
   "dependencies": {
-    "@backstage/core": "^0.1.1-alpha.21",
-    "@backstage/theme": "^0.1.1-alpha.21",
+    "@backstage/core": "^0.1.1-alpha.23",
+    "@backstage/theme": "^0.1.1-alpha.23",
     "@material-ui/core": "^4.11.0",
     "@material-ui/icons": "^4.9.1",
     "@material-ui/lab": "4.0.0-alpha.45",
@@ -31,15 +31,16 @@
     "react-use": "^15.3.3"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.1.1-alpha.21",
-    "@backstage/dev-utils": "^0.1.1-alpha.21",
-    "@backstage/test-utils": "^0.1.1-alpha.21",
+    "@backstage/cli": "^0.1.1-alpha.23",
+    "@backstage/dev-utils": "^0.1.1-alpha.23",
+    "@backstage/test-utils": "^0.1.1-alpha.23",
     "@testing-library/jest-dom": "^5.10.1",
     "@testing-library/react": "^10.4.1",
     "@testing-library/user-event": "^12.0.7",
     "@types/jest": "^26.0.7",
     "@types/node": "^12.0.0",
-    "jest-fetch-mock": "^3.0.3"
+    "msw": "^0.20.5",
+    "node-fetch": "^2.6.1"
   },
   "files": [
     "dist"

From b7e41a556524ec849c46ac17fb3d4a8a4d21a7f0 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 29 Sep 2020 14:45:09 +0200
Subject: [PATCH 041/110] Remove jest-fetch-mock

---
 plugins/user-settings/src/setupTests.ts | 2 --
 1 file changed, 2 deletions(-)

diff --git a/plugins/user-settings/src/setupTests.ts b/plugins/user-settings/src/setupTests.ts
index 4b4cdbdaaf..0bfa67b49a 100644
--- a/plugins/user-settings/src/setupTests.ts
+++ b/plugins/user-settings/src/setupTests.ts
@@ -14,5 +14,3 @@
  * limitations under the License.
  */
 import '@testing-library/jest-dom';
-
-require('jest-fetch-mock').enableMocks();

From 44c8696e8fd69bc72b0aa9ce4d638105de3c252c Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 29 Sep 2020 16:47:17 +0200
Subject: [PATCH 042/110] Update app-template

---
 .../templates/default-app/packages/app/package.json.hbs      | 1 +
 .../templates/default-app/packages/app/src/sidebar.tsx       | 5 ++---
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/create-app/templates/default-app/packages/app/package.json.hbs b/packages/create-app/templates/default-app/packages/app/package.json.hbs
index a057826ba4..103e75f6e0 100644
--- a/packages/create-app/templates/default-app/packages/app/package.json.hbs
+++ b/packages/create-app/templates/default-app/packages/app/package.json.hbs
@@ -19,6 +19,7 @@
     "@backstage/plugin-lighthouse": "^{{version}}",
     "@backstage/plugin-tech-radar": "^{{version}}",
     "@backstage/plugin-github-actions": "^{{version}}",
+    "@backstage/plugin-user-settings": "^{{version}}",
     "@backstage/test-utils": "^{{version}}",
     "@backstage/theme": "^{{version}}",
     "history": "^5.0.0",
diff --git a/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx b/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx
index 9dd9ea64c3..8ffd042543 100644
--- a/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx
+++ b/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx
@@ -9,6 +9,7 @@ import { Link, makeStyles } from '@material-ui/core';
 import { NavLink } from 'react-router-dom';
 import LogoFull from './LogoFull';
 import LogoIcon from './LogoIcon';
+import { UserSettings } from '@backstage/plugin-user-settings'
 
 import {
   Sidebar,
@@ -17,8 +18,6 @@ import {
   sidebarConfig,
   SidebarContext,
   SidebarSpace,
-  SidebarUserSettings,
-  DefaultProviderSettings,
 } from '@backstage/core';
 
 export const AppSidebar = () => (
@@ -37,7 +36,7 @@ export const AppSidebar = () => (
     <SidebarDivider />
     <SidebarSpace />
     <SidebarDivider />
-    <SidebarUserSettings providerSettings={<DefaultProviderSettings />} />
+    <UserSettings />
   </Sidebar>
 );
 

From 9ce6e44fdd3740d028b1d727cc4bef151ac2d54b Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 2 Oct 2020 08:57:56 +0200
Subject: [PATCH 043/110] Optimize featureflags handling

---
 .../src/components/FeatureFlagsList.tsx       | 41 +++++++++++--------
 1 file changed, 23 insertions(+), 18 deletions(-)

diff --git a/plugins/user-settings/src/components/FeatureFlagsList.tsx b/plugins/user-settings/src/components/FeatureFlagsList.tsx
index 20c91f3e9a..ec4ad51457 100644
--- a/plugins/user-settings/src/components/FeatureFlagsList.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsList.tsx
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import React, { useState, useEffect } from 'react';
+import React, { useState, useCallback } from 'react';
 import { List } from '@material-ui/core';
 import {
   useApi,
@@ -31,27 +31,32 @@ type Props = {
 
 export const FeatureFlagsList = ({ featureFlags }: Props) => {
   const featureFlagApi = useApi(featureFlagsApiRef);
-  const [state, setState] = useState<Record<FeatureFlagName, FeatureFlagState>>(
-    {},
+  const initialFlagState = featureFlags.reduce(
+    (result, featureFlag: FeatureFlagsRegistryItem) => {
+      const state = featureFlagApi.getFlags().get(featureFlag.name);
+
+      result[featureFlag.name] = state;
+      return result;
+    },
+    {} as Record<FeatureFlagName, FeatureFlagState>,
   );
 
-  useEffect(() => {
-    featureFlags.map(featureFlag => {
-      setState({
-        [featureFlag.name]: featureFlagApi.getFlags().get(featureFlag.name),
-      });
-    });
-  }, [featureFlagApi, featureFlags]);
+  const [state, setState] = useState<Record<FeatureFlagName, FeatureFlagState>>(
+    initialFlagState,
+  );
 
-  const toggleFlag = (flagName: FeatureFlagName) => {
-    const newState = featureFlagApi.getFlags().toggle(flagName);
+  const toggleFlag = useCallback(
+    (flagName: FeatureFlagName) => {
+      const newState = featureFlagApi.getFlags().toggle(flagName);
 
-    setState(prevState => ({
-      ...prevState,
-      [flagName]: newState,
-    }));
-    featureFlagApi.getFlags().save();
-  };
+      setState(prevState => ({
+        ...prevState,
+        [flagName]: newState,
+      }));
+      featureFlagApi.getFlags().save();
+    },
+    [featureFlagApi],
+  );
 
   return (
     <List dense>

From 90b7d218212b882f123ed1065af314ff6a06ef67 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 2 Oct 2020 09:16:25 +0200
Subject: [PATCH 044/110] Refactor the updatePosition logic

---
 .../src/components/SettingsDialog.test.tsx    | 14 ++++++++----
 .../src/components/SettingsDialog.tsx         | 22 ++++++-------------
 .../src/components/UserSettings.tsx           |  8 +++++--
 3 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/plugins/user-settings/src/components/SettingsDialog.test.tsx b/plugins/user-settings/src/components/SettingsDialog.test.tsx
index d738c2ece0..fb32e9cfdb 100644
--- a/plugins/user-settings/src/components/SettingsDialog.test.tsx
+++ b/plugins/user-settings/src/components/SettingsDialog.test.tsx
@@ -21,7 +21,8 @@ import {
   featureFlagsApiRef,
 } from '@backstage/core';
 import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
-import * as React from 'react';
+import { fireEvent } from '@testing-library/react';
+import React from 'react';
 import { SettingsDialog } from './SettingsDialog';
 
 const apiRegistry = ApiRegistry.from([
@@ -29,13 +30,13 @@ const apiRegistry = ApiRegistry.from([
 ]);
 
 describe('<SettingsDialog />', () => {
-  const mockRef = { current: null };
+  const mockFn = jest.fn();
 
-  it('displays the users name and email, and the tabs and titles', async () => {
+  it('displays the users name and email, and the tabs and titles and updates the position', async () => {
     const rendered = await renderWithEffects(
       wrapInTestApp(
         <ApiProvider apis={apiRegistry}>
-          <SettingsDialog popoverActionRef={mockRef} />
+          <SettingsDialog updatePosition={mockFn} />
         </ApiProvider>,
       ),
     );
@@ -46,5 +47,10 @@ describe('<SettingsDialog />', () => {
     expect(rendered.getByText('Additional Settings')).toBeInTheDocument();
     expect(rendered.getByText('Auth Providers')).toBeInTheDocument();
     expect(rendered.getByText('Feature Flags')).toBeInTheDocument();
+
+    const flagButton = rendered.getByText('Feature Flags');
+    expect(mockFn).toBeCalledTimes(1);
+    fireEvent.click(flagButton);
+    expect(mockFn).toBeCalledTimes(2);
   });
 });
diff --git a/plugins/user-settings/src/components/SettingsDialog.tsx b/plugins/user-settings/src/components/SettingsDialog.tsx
index 82e744bec1..c6d9cfa8c5 100644
--- a/plugins/user-settings/src/components/SettingsDialog.tsx
+++ b/plugins/user-settings/src/components/SettingsDialog.tsx
@@ -14,14 +14,8 @@
  * limitations under the License.
  */
 
-import React, { ChangeEvent, RefObject, useEffect, useState } from 'react';
-import {
-  Card,
-  CardContent,
-  CardHeader,
-  makeStyles,
-  PopoverActions,
-} from '@material-ui/core';
+import React, { ChangeEvent, useEffect, useState } from 'react';
+import { Card, CardContent, CardHeader, makeStyles } from '@material-ui/core';
 import { AppSettingsList } from './AppSettingsList';
 import { AuthProvidersList } from './AuthProviderList';
 import { FeatureFlagsList } from './FeatureFlagsList';
@@ -47,14 +41,11 @@ const useStyles = makeStyles({
 });
 
 type Props = {
-  popoverActionRef: RefObject<PopoverActions | null>;
   providerSettings?: ProviderSettings;
+  updatePosition: () => void;
 };
 
-export const SettingsDialog = ({
-  popoverActionRef,
-  providerSettings,
-}: Props) => {
+export const SettingsDialog = ({ providerSettings, updatePosition }: Props) => {
   const classes = useStyles();
   const { profile, displayName } = useUserProfile();
   const featureFlagsApi = useApi(featureFlagsApiRef);
@@ -62,6 +53,7 @@ export const SettingsDialog = ({
   const [selectedTab, setSelectedTab] = useState<string | number>('auth');
 
   const providers = providerSettings ?? <DefaultProviderSettings />;
+  const ref = React.useRef(updatePosition);
 
   const handleChange = (
     _ev: ChangeEvent<{}>,
@@ -72,8 +64,8 @@ export const SettingsDialog = ({
 
   // Update the position of the popover to handle different heights
   useEffect(() => {
-    popoverActionRef?.current?.updatePosition();
-  }, [selectedTab, popoverActionRef]);
+    ref.current?.();
+  }, [selectedTab]);
 
   return (
     <Card className={classes.root}>
diff --git a/plugins/user-settings/src/components/UserSettings.tsx b/plugins/user-settings/src/components/UserSettings.tsx
index b117d40acb..34d7fa02be 100644
--- a/plugins/user-settings/src/components/UserSettings.tsx
+++ b/plugins/user-settings/src/components/UserSettings.tsx
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import React, { useEffect, useContext } from 'react';
+import React, { useEffect, useContext, useCallback } from 'react';
 import { Popover, PopoverActions } from '@material-ui/core';
 import { SignInAvatar } from './SignInAvatar';
 import { SettingsDialog } from './SettingsDialog';
@@ -43,6 +43,10 @@ export const UserSettings = ({ providerSettings }: Props) => {
   );
   const popoverActionRef = React.useRef<PopoverActions | null>(null);
 
+  const updatePosition = useCallback(() => {
+    popoverActionRef?.current?.updatePosition();
+  }, []);
+
   const handleOpen = (event?: React.MouseEvent<HTMLButtonElement>) => {
     setAnchorEl(event?.currentTarget ?? undefined);
     setOpen(true);
@@ -81,7 +85,7 @@ export const UserSettings = ({ providerSettings }: Props) => {
         }}
       >
         <SettingsDialog
-          popoverActionRef={popoverActionRef}
+          updatePosition={updatePosition}
           providerSettings={providerSettings}
         />
       </Popover>

From fdd976a15ab3922065137b1ffad72321b0ccaef1 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Fri, 2 Oct 2020 10:35:16 +0200
Subject: [PATCH 045/110] Move small components out

---
 .../src/components/FeatureFlagsList.tsx       |  4 +-
 .../src/components/PinButton.tsx              | 10 +-
 .../src/components/ThemeToggle.tsx            | 98 ++++++++++---------
 3 files changed, 61 insertions(+), 51 deletions(-)

diff --git a/plugins/user-settings/src/components/FeatureFlagsList.tsx b/plugins/user-settings/src/components/FeatureFlagsList.tsx
index ec4ad51457..2636d0e66f 100644
--- a/plugins/user-settings/src/components/FeatureFlagsList.tsx
+++ b/plugins/user-settings/src/components/FeatureFlagsList.tsx
@@ -25,9 +25,7 @@ import {
 } from '@backstage/core';
 import { FlagItem } from './FeatureFlagsItem';
 
-type Props = {
-  featureFlags: FeatureFlagsRegistryItem[];
-};
+type Props = { featureFlags: FeatureFlagsRegistryItem[] };
 
 export const FeatureFlagsList = ({ featureFlags }: Props) => {
   const featureFlagApi = useApi(featureFlagsApiRef);
diff --git a/plugins/user-settings/src/components/PinButton.tsx b/plugins/user-settings/src/components/PinButton.tsx
index f8017ef215..e36fc365f8 100644
--- a/plugins/user-settings/src/components/PinButton.tsx
+++ b/plugins/user-settings/src/components/PinButton.tsx
@@ -26,14 +26,16 @@ import LockOpenIcon from '@material-ui/icons/LockOpen';
 import { ToggleButton } from '@material-ui/lab';
 import { SidebarPinStateContext } from '@backstage/core';
 
+type PinIconProps = { isPinned: boolean };
+
+const PinIcon = ({ isPinned }: PinIconProps) =>
+  isPinned ? <LockIcon color="primary" /> : <LockOpenIcon />;
+
 export const PinButton = () => {
   const { isPinned, toggleSidebarPinState } = useContext(
     SidebarPinStateContext,
   );
 
-  const PinIcon = () =>
-    isPinned ? <LockIcon color="primary" /> : <LockOpenIcon />;
-
   return (
     <ListItem>
       <ListItemText
@@ -54,7 +56,7 @@ export const PinButton = () => {
               toggleSidebarPinState();
             }}
           >
-            <PinIcon />
+            <PinIcon isPinned={isPinned} />
           </ToggleButton>
         </Tooltip>
       </ListItemSecondaryAction>
diff --git a/plugins/user-settings/src/components/ThemeToggle.tsx b/plugins/user-settings/src/components/ThemeToggle.tsx
index b041e1f76b..111bd838a8 100644
--- a/plugins/user-settings/src/components/ThemeToggle.tsx
+++ b/plugins/user-settings/src/components/ThemeToggle.tsx
@@ -17,7 +17,7 @@
 import React, { cloneElement } from 'react';
 import { useObservable } from 'react-use';
 import AutoIcon from '@material-ui/icons/BrightnessAuto';
-import { AppTheme, appThemeApiRef, useApi } from '@backstage/core';
+import { appThemeApiRef, useApi } from '@backstage/core';
 import ToggleButton from '@material-ui/lab/ToggleButton';
 import ToggleButtonGroup from '@material-ui/lab/ToggleButtonGroup';
 import {
@@ -27,6 +27,42 @@ import {
   Tooltip,
 } from '@material-ui/core';
 
+type ThemeIconProps = {
+  id: string;
+  activeId: string | undefined;
+  icon: JSX.Element | undefined;
+};
+
+const ThemeIcon = ({ id, activeId, icon }: ThemeIconProps) =>
+  icon ? (
+    cloneElement(icon, {
+      color: activeId === id ? 'primary' : undefined,
+    })
+  ) : (
+    <AutoIcon color={activeId === id ? 'primary' : undefined} />
+  );
+
+type TooltipToggleButtonProps = {
+  children: JSX.Element;
+  title: string;
+  value: string;
+};
+
+// ToggleButtonGroup uses React.children.map instead of context
+// so wrapping with Tooltip breaks ToggleButton functionality.
+const TooltipToggleButton = ({
+  children,
+  title,
+  value,
+  ...props
+}: TooltipToggleButtonProps) => (
+  <Tooltip placement="top" arrow title={title}>
+    <ToggleButton value={value} {...props}>
+      {children}
+    </ToggleButton>
+  </Tooltip>
+);
+
 export const ThemeToggle = () => {
   const appThemeApi = useApi(appThemeApiRef);
   const themeId = useObservable(
@@ -47,36 +83,6 @@ export const ThemeToggle = () => {
     }
   };
 
-  // ToggleButtonGroup uses React.children.map instead of context
-  // so wrapping with Tooltip breaks ToggleButton functionality.
-  const TooltipToggleButton = ({
-    children,
-    title,
-    value,
-    ...props
-  }: {
-    children: JSX.Element;
-    title: string;
-    value: string;
-  }) => (
-    <Tooltip placement="top" arrow title={title}>
-      <ToggleButton value={value} {...props}>
-        {children}
-      </ToggleButton>
-    </Tooltip>
-  );
-
-  const ThemeIcon = ({ theme }: { theme: AppTheme }) => {
-    const themeIcon = themeIds.find(t => t.id === theme.id)?.icon;
-    return themeIcon ? (
-      cloneElement(themeIcon, {
-        color: themeId === theme.id ? 'primary' : undefined,
-      })
-    ) : (
-      <AutoIcon color={themeId === theme.id ? 'primary' : undefined} />
-    );
-  };
-
   return (
     <ListItem>
       <ListItemText primary="Theme" secondary="Change the theme mode" />
@@ -87,20 +93,24 @@ export const ThemeToggle = () => {
           value={themeId ?? 'auto'}
           onChange={handleSetTheme}
         >
-          {themeIds.map(theme => (
-            <TooltipToggleButton
-              key={theme.id}
-              title={`Select ${theme.title}`}
-              value={theme.variant}
-            >
-              <ThemeIcon theme={theme} />
-            </TooltipToggleButton>
-          ))}
-          <ToggleButton value="auto">
-            <Tooltip placement="top" arrow title="Select auto theme">
+          {themeIds.map(theme => {
+            const themeIcon = themeIds.find(t => t.id === theme.id)?.icon;
+
+            return (
+              <TooltipToggleButton
+                key={theme.id}
+                title={`Select ${theme.title}`}
+                value={theme.variant}
+              >
+                <ThemeIcon id={theme.id} icon={themeIcon} activeId={themeId} />
+              </TooltipToggleButton>
+            );
+          })}
+          <Tooltip placement="top" arrow title="Select auto theme">
+            <ToggleButton value="auto">
               <AutoIcon color={themeId === undefined ? 'primary' : undefined} />
-            </Tooltip>
-          </ToggleButton>
+            </ToggleButton>
+          </Tooltip>
         </ToggleButtonGroup>
       </ListItemSecondaryAction>
     </ListItem>

From 8d68c6652a06e159422cd3322a1ffb1197cf5922 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 13:06:58 +0200
Subject: [PATCH 046/110] Add settings page and remove popup

---
 packages/app/src/App.tsx                      |   2 +
 packages/app/src/components/Root/Root.tsx     |   4 +-
 .../src/layout/Sidebar/Sidebar.stories.tsx    |   2 -
 plugins/user-settings/package.json            |   1 +
 ...AuthProviderList.tsx => AuthProviders.tsx} |   7 +-
 .../DefaultProviderSettings.test.tsx          |   2 +-
 ...{FeatureFlagsList.tsx => FeatureFlags.tsx} |  31 ++---
 .../{AppSettingsList.tsx => General.tsx}      |  25 ++--
 .../src/components/PinButton.test.tsx         |   2 +-
 .../user-settings/src/components/Profile.tsx  |  54 +++++++++
 .../{UserSettings.test.tsx => Settings.tsx}   |  26 +++--
 .../src/components/SettingsDialog.test.tsx    |  56 ---------
 .../src/components/SettingsDialog.tsx         | 110 ------------------
 .../src/components/SettingsPage.tsx           |  64 ++++++++++
 .../src/components/SignInAvatar.tsx           |  14 +--
 .../src/components/ThemeToggle.test.tsx       |   2 +-
 .../src/components/UserSettings.tsx           |  94 ---------------
 .../src/components/UserSettingsMenu.test.tsx  |   2 +-
 plugins/user-settings/src/index.ts            |   3 +-
 plugins/user-settings/src/plugin.ts           |   7 +-
 20 files changed, 198 insertions(+), 310 deletions(-)
 rename plugins/user-settings/src/components/{AuthProviderList.tsx => AuthProviders.tsx} (81%)
 rename plugins/user-settings/src/components/{FeatureFlagsList.tsx => FeatureFlags.tsx} (78%)
 rename plugins/user-settings/src/components/{AppSettingsList.tsx => General.tsx} (63%)
 create mode 100644 plugins/user-settings/src/components/Profile.tsx
 rename plugins/user-settings/src/components/{UserSettings.test.tsx => Settings.tsx} (55%)
 delete mode 100644 plugins/user-settings/src/components/SettingsDialog.test.tsx
 delete mode 100644 plugins/user-settings/src/components/SettingsDialog.tsx
 create mode 100644 plugins/user-settings/src/components/SettingsPage.tsx
 delete mode 100644 plugins/user-settings/src/components/UserSettings.tsx

diff --git a/packages/app/src/App.tsx b/packages/app/src/App.tsx
index 667b14366f..81d08f58a9 100644
--- a/packages/app/src/App.tsx
+++ b/packages/app/src/App.tsx
@@ -33,6 +33,7 @@ import { Router as GraphiQLRouter } from '@backstage/plugin-graphiql';
 import { Router as TechRadarRouter } from '@backstage/plugin-tech-radar';
 import { Router as LighthouseRouter } from '@backstage/plugin-lighthouse';
 import { Router as RegisterComponentRouter } from '@backstage/plugin-register-component';
+import { Router as SettingsRouter } from '@backstage/plugin-user-settings';
 import { Route, Routes, Navigate } from 'react-router';
 
 import { EntityPage } from './components/catalog/EntityPage';
@@ -81,6 +82,7 @@ const AppRoutes = () => (
       path="/register-component"
       element={<RegisterComponentRouter catalogRouteRef={catalogRouteRef} />}
     />
+    <Route path="/settings" element={<SettingsRouter />} />
     {...deprecatedAppRoutes}
   </Routes>
 );
diff --git a/packages/app/src/components/Root/Root.tsx b/packages/app/src/components/Root/Root.tsx
index 9f5387cea8..e947e5c91d 100644
--- a/packages/app/src/components/Root/Root.tsx
+++ b/packages/app/src/components/Root/Root.tsx
@@ -38,7 +38,7 @@ import {
 } from '@backstage/core';
 import { NavLink } from 'react-router-dom';
 import { graphiQLRouteRef } from '@backstage/plugin-graphiql';
-import { UserSettings } from '@backstage/plugin-user-settings';
+import { Settings as SidebarSettings } from '@backstage/plugin-user-settings';
 
 const useSidebarLogoStyles = makeStyles({
   root: {
@@ -102,7 +102,7 @@ const Root: FC<{}> = ({ children }) => (
       />
       <SidebarSpace />
       <SidebarDivider />
-      <UserSettings />
+      <SidebarSettings />
     </Sidebar>
     {children}
   </SidebarPage>
diff --git a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
index 14bf6e69ed..ec5746d428 100644
--- a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
+++ b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
@@ -56,7 +56,6 @@ const handleSearch = (input: string) => {
 
 export const SampleSidebar = () => (
   <Sidebar>
-    {/* <SidebarLogo /> */}
     <SidebarSearchField onSearch={handleSearch} />
     <SidebarDivider />
     <SidebarItem icon={HomeOutlinedIcon} to="#" text="Home" />
@@ -92,7 +91,6 @@ const apis = ApiRegistry.from([
 
 export const WithUserSettingsPlugin = () => (
   <Sidebar>
-    {/* <SidebarLogo /> */}
     <SidebarSearchField onSearch={handleSearch} />
     <SidebarDivider />
     <SidebarItem icon={HomeOutlinedIcon} to="#" text="Home" />
diff --git a/plugins/user-settings/package.json b/plugins/user-settings/package.json
index 1c5d489747..c744f757c5 100644
--- a/plugins/user-settings/package.json
+++ b/plugins/user-settings/package.json
@@ -28,6 +28,7 @@
     "@material-ui/lab": "4.0.0-alpha.45",
     "react": "^16.13.1",
     "react-dom": "^16.13.1",
+    "react-router": "6.0.0-beta.0",
     "react-use": "^15.3.3"
   },
   "devDependencies": {
diff --git a/plugins/user-settings/src/components/AuthProviderList.tsx b/plugins/user-settings/src/components/AuthProviders.tsx
similarity index 81%
rename from plugins/user-settings/src/components/AuthProviderList.tsx
rename to plugins/user-settings/src/components/AuthProviders.tsx
index 9a2096212d..917e70b067 100644
--- a/plugins/user-settings/src/components/AuthProviderList.tsx
+++ b/plugins/user-settings/src/components/AuthProviders.tsx
@@ -16,11 +16,14 @@
 
 import React from 'react';
 import { List } from '@material-ui/core';
+import { InfoCard } from '@backstage/core';
 
 type Props = {
   providers: React.ReactNode;
 };
 
-export const AuthProvidersList = ({ providers }: Props) => (
-  <List dense>{providers}</List>
+export const AuthProviders = ({ providers }: Props) => (
+  <InfoCard>
+    <List dense>{providers}</List>
+  </InfoCard>
 );
diff --git a/plugins/user-settings/src/components/DefaultProviderSettings.test.tsx b/plugins/user-settings/src/components/DefaultProviderSettings.test.tsx
index 8f6e4b72dc..bc4e0da363 100644
--- a/plugins/user-settings/src/components/DefaultProviderSettings.test.tsx
+++ b/plugins/user-settings/src/components/DefaultProviderSettings.test.tsx
@@ -23,7 +23,7 @@ import {
 } from '@backstage/core';
 import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
 import { fireEvent } from '@testing-library/react';
-import * as React from 'react';
+import React from 'react';
 import { DefaultProviderSettings } from './DefaultProviderSettings';
 
 const mockSignInHandler = jest.fn().mockReturnValue('');
diff --git a/plugins/user-settings/src/components/FeatureFlagsList.tsx b/plugins/user-settings/src/components/FeatureFlags.tsx
similarity index 78%
rename from plugins/user-settings/src/components/FeatureFlagsList.tsx
rename to plugins/user-settings/src/components/FeatureFlags.tsx
index 2636d0e66f..d3f21a7c6e 100644
--- a/plugins/user-settings/src/components/FeatureFlagsList.tsx
+++ b/plugins/user-settings/src/components/FeatureFlags.tsx
@@ -22,12 +22,13 @@ import {
   FeatureFlagName,
   FeatureFlagState,
   FeatureFlagsRegistryItem,
+  InfoCard,
 } from '@backstage/core';
 import { FlagItem } from './FeatureFlagsItem';
 
 type Props = { featureFlags: FeatureFlagsRegistryItem[] };
 
-export const FeatureFlagsList = ({ featureFlags }: Props) => {
+export const FeatureFlags = ({ featureFlags }: Props) => {
   const featureFlagApi = useApi(featureFlagsApiRef);
   const initialFlagState = featureFlags.reduce(
     (result, featureFlag: FeatureFlagsRegistryItem) => {
@@ -57,19 +58,21 @@ export const FeatureFlagsList = ({ featureFlags }: Props) => {
   );
 
   return (
-    <List dense>
-      {featureFlags.map(featureFlag => {
-        const enabled = Boolean(state[featureFlag.name]);
+    <InfoCard>
+      <List dense>
+        {featureFlags.map(featureFlag => {
+          const enabled = Boolean(state[featureFlag.name]);
 
-        return (
-          <FlagItem
-            key={featureFlag.name}
-            flag={featureFlag}
-            enabled={enabled}
-            toggleHandler={toggleFlag}
-          />
-        );
-      })}
-    </List>
+          return (
+            <FlagItem
+              key={featureFlag.name}
+              flag={featureFlag}
+              enabled={enabled}
+              toggleHandler={toggleFlag}
+            />
+          );
+        })}
+      </List>
+    </InfoCard>
   );
 };
diff --git a/plugins/user-settings/src/components/AppSettingsList.tsx b/plugins/user-settings/src/components/General.tsx
similarity index 63%
rename from plugins/user-settings/src/components/AppSettingsList.tsx
rename to plugins/user-settings/src/components/General.tsx
index 3f2b455520..00ac17dfe1 100644
--- a/plugins/user-settings/src/components/AppSettingsList.tsx
+++ b/plugins/user-settings/src/components/General.tsx
@@ -13,14 +13,25 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { InfoCard } from '@backstage/core';
+import { Grid, List } from '@material-ui/core';
 import React from 'react';
-import { List } from '@material-ui/core';
-import { ThemeToggle } from './ThemeToggle';
 import { PinButton } from './PinButton';
+import { Profile } from './Profile';
+import { ThemeToggle } from './ThemeToggle';
 
-export const AppSettingsList = () => (
-  <List dense>
-    <ThemeToggle />
-    <PinButton />
-  </List>
+export const General = () => (
+  <Grid container spacing={3}>
+    <Grid item md={12}>
+      <Profile />
+    </Grid>
+    <Grid item md={12}>
+      <InfoCard>
+        <List dense>
+          <ThemeToggle />
+          <PinButton />
+        </List>
+      </InfoCard>
+    </Grid>
+  </Grid>
 );
diff --git a/plugins/user-settings/src/components/PinButton.test.tsx b/plugins/user-settings/src/components/PinButton.test.tsx
index a800193c06..76af8ce8d4 100644
--- a/plugins/user-settings/src/components/PinButton.test.tsx
+++ b/plugins/user-settings/src/components/PinButton.test.tsx
@@ -17,7 +17,7 @@
 import { SidebarPinStateContext } from '@backstage/core';
 import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
 import { fireEvent } from '@testing-library/react';
-import * as React from 'react';
+import React from 'react';
 import { PinButton } from './PinButton';
 
 describe('<PinButton />', () => {
diff --git a/plugins/user-settings/src/components/Profile.tsx b/plugins/user-settings/src/components/Profile.tsx
new file mode 100644
index 0000000000..5bb9485f8d
--- /dev/null
+++ b/plugins/user-settings/src/components/Profile.tsx
@@ -0,0 +1,54 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { InfoCard } from '@backstage/core';
+import { Grid, Typography } from '@material-ui/core';
+import React from 'react';
+import { SignInAvatar } from './SignInAvatar';
+import { UserSettingsMenu } from './UserSettingsMenu';
+import { useUserProfile } from './useUserProfileInfo';
+
+export const Profile = () => {
+  const { profile, displayName } = useUserProfile();
+
+  return (
+    <Grid container spacing={3}>
+      <Grid item md={12}>
+        <InfoCard title="Profile">
+          <Grid container spacing={6}>
+            <Grid item>
+              <SignInAvatar size={96} />
+            </Grid>
+            <Grid item xs={12} sm container>
+              <Grid item xs container direction="column" spacing={2}>
+                <Grid item xs>
+                  <Typography variant="subtitle1" gutterBottom>
+                    {displayName}
+                  </Typography>
+                  <Typography variant="body2" color="textSecondary">
+                    {profile.email}
+                  </Typography>
+                </Grid>
+              </Grid>
+              <Grid item>
+                <UserSettingsMenu />
+              </Grid>
+            </Grid>
+          </Grid>
+        </InfoCard>
+      </Grid>
+    </Grid>
+  );
+};
diff --git a/plugins/user-settings/src/components/UserSettings.test.tsx b/plugins/user-settings/src/components/Settings.tsx
similarity index 55%
rename from plugins/user-settings/src/components/UserSettings.test.tsx
rename to plugins/user-settings/src/components/Settings.tsx
index 1d43f4093e..ae141457df 100644
--- a/plugins/user-settings/src/components/UserSettings.test.tsx
+++ b/plugins/user-settings/src/components/Settings.tsx
@@ -14,13 +14,21 @@
  * limitations under the License.
  */
 
-import * as React from 'react';
-import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
-import { UserSettings } from './UserSettings';
+import React from 'react';
+import { SidebarItem } from '@backstage/core';
+import { SignInAvatar } from './SignInAvatar';
+import { useUserProfile } from './useUserProfileInfo';
+import { settingsRouteRef } from '../plugin';
 
-describe('<UserSettings />', () => {
-  it('renders', async () => {
-    const rendered = await renderWithEffects(wrapInTestApp(<UserSettings />));
-    expect(rendered.getByText('G')).toBeInTheDocument();
-  });
-});
+export const Settings = () => {
+  const { displayName } = useUserProfile();
+  const SidebarAvatar = () => <SignInAvatar />;
+
+  return (
+    <SidebarItem
+      text={displayName}
+      to={settingsRouteRef.path}
+      icon={SidebarAvatar}
+    />
+  );
+};
diff --git a/plugins/user-settings/src/components/SettingsDialog.test.tsx b/plugins/user-settings/src/components/SettingsDialog.test.tsx
deleted file mode 100644
index fb32e9cfdb..0000000000
--- a/plugins/user-settings/src/components/SettingsDialog.test.tsx
+++ /dev/null
@@ -1,56 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 {
-  ApiProvider,
-  ApiRegistry,
-  FeatureFlags,
-  featureFlagsApiRef,
-} from '@backstage/core';
-import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
-import { fireEvent } from '@testing-library/react';
-import React from 'react';
-import { SettingsDialog } from './SettingsDialog';
-
-const apiRegistry = ApiRegistry.from([
-  [featureFlagsApiRef, new FeatureFlags()],
-]);
-
-describe('<SettingsDialog />', () => {
-  const mockFn = jest.fn();
-
-  it('displays the users name and email, and the tabs and titles and updates the position', async () => {
-    const rendered = await renderWithEffects(
-      wrapInTestApp(
-        <ApiProvider apis={apiRegistry}>
-          <SettingsDialog updatePosition={mockFn} />
-        </ApiProvider>,
-      ),
-    );
-
-    expect(rendered.getByText('Guest')).toBeInTheDocument();
-    expect(rendered.getByText('guest@example.com')).toBeInTheDocument();
-    expect(rendered.getByText('App Settings')).toBeInTheDocument();
-    expect(rendered.getByText('Additional Settings')).toBeInTheDocument();
-    expect(rendered.getByText('Auth Providers')).toBeInTheDocument();
-    expect(rendered.getByText('Feature Flags')).toBeInTheDocument();
-
-    const flagButton = rendered.getByText('Feature Flags');
-    expect(mockFn).toBeCalledTimes(1);
-    fireEvent.click(flagButton);
-    expect(mockFn).toBeCalledTimes(2);
-  });
-});
diff --git a/plugins/user-settings/src/components/SettingsDialog.tsx b/plugins/user-settings/src/components/SettingsDialog.tsx
deleted file mode 100644
index c6d9cfa8c5..0000000000
--- a/plugins/user-settings/src/components/SettingsDialog.tsx
+++ /dev/null
@@ -1,110 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 React, { ChangeEvent, useEffect, useState } from 'react';
-import { Card, CardContent, CardHeader, makeStyles } from '@material-ui/core';
-import { AppSettingsList } from './AppSettingsList';
-import { AuthProvidersList } from './AuthProviderList';
-import { FeatureFlagsList } from './FeatureFlagsList';
-import { SignInAvatar } from './SignInAvatar';
-import { UserSettingsMenu } from './UserSettingsMenu';
-import { useUserProfile } from './useUserProfileInfo';
-import {
-  useApi,
-  featureFlagsApiRef,
-  TabbedCard,
-  CardTab,
-  InfoCard,
-} from '@backstage/core';
-import { DefaultProviderSettings } from './DefaultProviderSettings';
-import { ProviderSettings } from './UserSettings';
-import { Alert } from '@material-ui/lab';
-
-const useStyles = makeStyles({
-  root: {
-    minWidth: 400,
-    maxWidth: 500,
-  },
-});
-
-type Props = {
-  providerSettings?: ProviderSettings;
-  updatePosition: () => void;
-};
-
-export const SettingsDialog = ({ providerSettings, updatePosition }: Props) => {
-  const classes = useStyles();
-  const { profile, displayName } = useUserProfile();
-  const featureFlagsApi = useApi(featureFlagsApiRef);
-  const featureFlags = featureFlagsApi.getRegisteredFlags();
-  const [selectedTab, setSelectedTab] = useState<string | number>('auth');
-
-  const providers = providerSettings ?? <DefaultProviderSettings />;
-  const ref = React.useRef(updatePosition);
-
-  const handleChange = (
-    _ev: ChangeEvent<{}>,
-    newSelectedTab: string | number,
-  ) => {
-    setSelectedTab(newSelectedTab);
-  };
-
-  // Update the position of the popover to handle different heights
-  useEffect(() => {
-    ref.current?.();
-  }, [selectedTab]);
-
-  return (
-    <Card className={classes.root}>
-      <CardHeader
-        avatar={<SignInAvatar size={48} />}
-        action={<UserSettingsMenu />}
-        title={displayName}
-        subheader={profile.email}
-      />
-      <CardContent>
-        <InfoCard
-          title="App Settings"
-          subheader="General settings related to how the app feels and looks"
-          variant="flat"
-          noPadding
-        >
-          <AppSettingsList />
-        </InfoCard>
-        <TabbedCard
-          title="Additional Settings"
-          subheader="Settings that are specific to a plugin, or feature of the app"
-          variant="flat"
-          value={selectedTab}
-          onChange={handleChange}
-          noPadding
-        >
-          <CardTab value="auth" label="Auth Providers">
-            <AuthProvidersList providers={providers} />
-          </CardTab>
-          <CardTab value="flags" label="Feature Flags">
-            {featureFlags.length > 0 ? (
-              <FeatureFlagsList featureFlags={featureFlags} />
-            ) : (
-              // TODO(marcuseide): Replace with empty state component?
-              <Alert severity="info">No registered Feature Flags found</Alert>
-            )}
-          </CardTab>
-        </TabbedCard>
-      </CardContent>
-    </Card>
-  );
-};
diff --git a/plugins/user-settings/src/components/SettingsPage.tsx b/plugins/user-settings/src/components/SettingsPage.tsx
new file mode 100644
index 0000000000..de76866653
--- /dev/null
+++ b/plugins/user-settings/src/components/SettingsPage.tsx
@@ -0,0 +1,64 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React, { useState } from 'react';
+import {
+  Content,
+  featureFlagsApiRef,
+  Header,
+  HeaderTabs,
+  Page,
+  pageTheme,
+  useApi,
+} from '@backstage/core';
+import { General } from './General';
+import { AuthProviders } from './AuthProviders';
+import { DefaultProviderSettings } from './DefaultProviderSettings';
+import { FeatureFlags } from './FeatureFlags';
+
+type Props = {
+  providerSettings?: JSX.Element;
+};
+
+export const SettingsPage = ({ providerSettings }: Props) => {
+  const [activeTab, setActiveTab] = useState<number>(0);
+  const onTabChange = (index: number) => {
+    setActiveTab(index);
+  };
+  const featureFlagsApi = useApi(featureFlagsApiRef);
+  const featureFlags = featureFlagsApi.getRegisteredFlags();
+  const providers = providerSettings ?? <DefaultProviderSettings />;
+
+  const tabs = [
+    { id: 'general', label: 'General' },
+    { id: 'auth-providers', label: 'Authentication Providers' },
+    { id: 'feature-flags', label: 'Feature Flags' },
+  ];
+
+  const content = [
+    <General />,
+    <AuthProviders providers={providers} />,
+    <FeatureFlags featureFlags={featureFlags} />,
+  ];
+
+  return (
+    <Page theme={pageTheme.home}>
+      <Header title="Settings" />
+      <HeaderTabs tabs={tabs} onChange={onTabChange} />
+      <Content>{content[activeTab]}</Content>
+    </Page>
+  );
+};
diff --git a/plugins/user-settings/src/components/SignInAvatar.tsx b/plugins/user-settings/src/components/SignInAvatar.tsx
index 11a5e6ed99..72c636ffe7 100644
--- a/plugins/user-settings/src/components/SignInAvatar.tsx
+++ b/plugins/user-settings/src/components/SignInAvatar.tsx
@@ -20,23 +20,21 @@ import { makeStyles, Avatar } from '@material-ui/core';
 import { useUserProfile } from './useUserProfileInfo';
 import { sidebarConfig } from '@backstage/core';
 
-const useStyles = makeStyles<BackstageTheme, { size: number }>({
+const useStyles = makeStyles<BackstageTheme, { size: number }>(theme => ({
   avatar: {
     width: ({ size }) => size,
     height: ({ size }) => size,
+    fontSize: ({ size }) => size * 0.7,
+    border: `1px solid ${theme.palette.textSubtle}`,
   },
-});
+}));
 
 type Props = { size?: number };
 
 export const SignInAvatar = ({ size }: Props) => {
   const { iconSize } = sidebarConfig;
   const classes = useStyles(size ? { size } : { size: iconSize });
-  const { profile, displayName } = useUserProfile();
+  const { profile } = useUserProfile();
 
-  return (
-    <Avatar src={profile.picture} className={classes.avatar}>
-      {displayName[0]}
-    </Avatar>
-  );
+  return <Avatar src={profile.picture} className={classes.avatar} />;
 };
diff --git a/plugins/user-settings/src/components/ThemeToggle.test.tsx b/plugins/user-settings/src/components/ThemeToggle.test.tsx
index df36a985f6..79d9210826 100644
--- a/plugins/user-settings/src/components/ThemeToggle.test.tsx
+++ b/plugins/user-settings/src/components/ThemeToggle.test.tsx
@@ -23,7 +23,7 @@ import {
 import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
 import { lightTheme } from '@backstage/theme';
 import { fireEvent } from '@testing-library/react';
-import * as React from 'react';
+import React from 'react';
 import { ThemeToggle } from './ThemeToggle';
 
 const mockTheme = {
diff --git a/plugins/user-settings/src/components/UserSettings.tsx b/plugins/user-settings/src/components/UserSettings.tsx
deleted file mode 100644
index 34d7fa02be..0000000000
--- a/plugins/user-settings/src/components/UserSettings.tsx
+++ /dev/null
@@ -1,94 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 React, { useEffect, useContext, useCallback } from 'react';
-import { Popover, PopoverActions } from '@material-ui/core';
-import { SignInAvatar } from './SignInAvatar';
-import { SettingsDialog } from './SettingsDialog';
-import { SidebarItem, SidebarContext } from '@backstage/core';
-import { useUserProfile } from './useUserProfileInfo';
-
-export type ProviderSettings = JSX.Element;
-
-type Props = {
-  /**
-   * Available auth providers. Providers will be rendered as children
-   * of a MUI List.
-   *
-   * If undefined, providers that are configured in app-config.yaml
-   * will be displayed instead.
-   */
-  providerSettings?: ProviderSettings;
-};
-
-export const UserSettings = ({ providerSettings }: Props) => {
-  const { isOpen: sidebarOpen } = useContext(SidebarContext);
-  const { displayName } = useUserProfile();
-  const [open, setOpen] = React.useState(false);
-  const [anchorEl, setAnchorEl] = React.useState<HTMLButtonElement | undefined>(
-    undefined,
-  );
-  const popoverActionRef = React.useRef<PopoverActions | null>(null);
-
-  const updatePosition = useCallback(() => {
-    popoverActionRef?.current?.updatePosition();
-  }, []);
-
-  const handleOpen = (event?: React.MouseEvent<HTMLButtonElement>) => {
-    setAnchorEl(event?.currentTarget ?? undefined);
-    setOpen(true);
-  };
-
-  const handleClose = () => {
-    setAnchorEl(undefined);
-    setOpen(false);
-  };
-
-  useEffect(() => {
-    if (!sidebarOpen && open) setOpen(false);
-  }, [open, sidebarOpen]);
-
-  const SidebarAvatar = () => <SignInAvatar />;
-
-  return (
-    <>
-      <SidebarItem
-        text={displayName}
-        onClick={handleOpen}
-        icon={SidebarAvatar}
-      />
-      <Popover
-        action={popoverActionRef}
-        open={open}
-        anchorEl={anchorEl}
-        onClose={handleClose}
-        anchorOrigin={{
-          vertical: 'center',
-          horizontal: 'center',
-        }}
-        transformOrigin={{
-          vertical: 'bottom',
-          horizontal: 'left',
-        }}
-      >
-        <SettingsDialog
-          updatePosition={updatePosition}
-          providerSettings={providerSettings}
-        />
-      </Popover>
-    </>
-  );
-};
diff --git a/plugins/user-settings/src/components/UserSettingsMenu.test.tsx b/plugins/user-settings/src/components/UserSettingsMenu.test.tsx
index b1ad059611..c86d702e30 100644
--- a/plugins/user-settings/src/components/UserSettingsMenu.test.tsx
+++ b/plugins/user-settings/src/components/UserSettingsMenu.test.tsx
@@ -16,7 +16,7 @@
 
 import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
 import { fireEvent } from '@testing-library/react';
-import * as React from 'react';
+import React from 'react';
 import { UserSettingsMenu } from './UserSettingsMenu';
 
 describe('<UserSettingsMenu />', () => {
diff --git a/plugins/user-settings/src/index.ts b/plugins/user-settings/src/index.ts
index 311ae69a51..113930902a 100644
--- a/plugins/user-settings/src/index.ts
+++ b/plugins/user-settings/src/index.ts
@@ -14,4 +14,5 @@
  * limitations under the License.
  */
 export { plugin } from './plugin';
-export { UserSettings } from './components/UserSettings';
+export { Settings } from './components/Settings';
+export { SettingsPage as Router } from './components/SettingsPage';
diff --git a/plugins/user-settings/src/plugin.ts b/plugins/user-settings/src/plugin.ts
index 4b556180f2..2f896c8197 100644
--- a/plugins/user-settings/src/plugin.ts
+++ b/plugins/user-settings/src/plugin.ts
@@ -13,7 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { createPlugin } from '@backstage/core';
+import { createPlugin, createRouteRef } from '@backstage/core';
+
+export const settingsRouteRef = createRouteRef({
+  path: '/settings',
+  title: 'Settings',
+});
 
 export const plugin = createPlugin({
   id: 'user-settings',

From 11b9c82ac94dd2b73dcff7a8e5075edfd5eb6abf Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 13:22:04 +0200
Subject: [PATCH 047/110] Move components into seperate folders

---
 plugins/user-settings/package.json             |  2 +-
 .../{ => AuthProviders}/AuthProviders.tsx      |  0
 .../DefaultProviderSettings.test.tsx           |  0
 .../DefaultProviderSettings.tsx                |  0
 .../ProviderSettingsItem.tsx                   |  0
 .../src/components/AuthProviders/index.ts      | 18 ++++++++++++++++++
 .../{ => FeatureFlags}/FeatureFlags.tsx        |  0
 .../{ => FeatureFlags}/FeatureFlagsItem.tsx    |  0
 .../src/components/{ => FeatureFlags}/index.ts |  2 +-
 .../src/components/{ => General}/General.tsx   |  0
 .../{ => General}/PinButton.test.tsx           |  0
 .../src/components/{ => General}/PinButton.tsx |  0
 .../src/components/{ => General}/Profile.tsx   |  2 +-
 .../components/{ => General}/SignInAvatar.tsx  |  2 +-
 .../{ => General}/ThemeToggle.test.tsx         |  0
 .../components/{ => General}/ThemeToggle.tsx   |  0
 .../{ => General}/UserSettingsMenu.test.tsx    |  0
 .../{ => General}/UserSettingsMenu.tsx         |  0
 .../src/components/General/index.ts            | 18 ++++++++++++++++++
 .../user-settings/src/components/Settings.tsx  |  2 +-
 .../src/components/SettingsPage.tsx            |  3 +--
 21 files changed, 42 insertions(+), 7 deletions(-)
 rename plugins/user-settings/src/components/{ => AuthProviders}/AuthProviders.tsx (100%)
 rename plugins/user-settings/src/components/{ => AuthProviders}/DefaultProviderSettings.test.tsx (100%)
 rename plugins/user-settings/src/components/{ => AuthProviders}/DefaultProviderSettings.tsx (100%)
 rename plugins/user-settings/src/components/{ => AuthProviders}/ProviderSettingsItem.tsx (100%)
 create mode 100644 plugins/user-settings/src/components/AuthProviders/index.ts
 rename plugins/user-settings/src/components/{ => FeatureFlags}/FeatureFlags.tsx (100%)
 rename plugins/user-settings/src/components/{ => FeatureFlags}/FeatureFlagsItem.tsx (100%)
 rename plugins/user-settings/src/components/{ => FeatureFlags}/index.ts (92%)
 rename plugins/user-settings/src/components/{ => General}/General.tsx (100%)
 rename plugins/user-settings/src/components/{ => General}/PinButton.test.tsx (100%)
 rename plugins/user-settings/src/components/{ => General}/PinButton.tsx (100%)
 rename plugins/user-settings/src/components/{ => General}/Profile.tsx (96%)
 rename plugins/user-settings/src/components/{ => General}/SignInAvatar.tsx (95%)
 rename plugins/user-settings/src/components/{ => General}/ThemeToggle.test.tsx (100%)
 rename plugins/user-settings/src/components/{ => General}/ThemeToggle.tsx (100%)
 rename plugins/user-settings/src/components/{ => General}/UserSettingsMenu.test.tsx (100%)
 rename plugins/user-settings/src/components/{ => General}/UserSettingsMenu.tsx (100%)
 create mode 100644 plugins/user-settings/src/components/General/index.ts

diff --git a/plugins/user-settings/package.json b/plugins/user-settings/package.json
index c744f757c5..b811213f13 100644
--- a/plugins/user-settings/package.json
+++ b/plugins/user-settings/package.json
@@ -4,7 +4,7 @@
   "main": "src/index.ts",
   "types": "src/index.ts",
   "license": "Apache-2.0",
-  "private": true,
+  "private": false,
   "publishConfig": {
     "access": "public",
     "main": "dist/index.esm.js",
diff --git a/plugins/user-settings/src/components/AuthProviders.tsx b/plugins/user-settings/src/components/AuthProviders/AuthProviders.tsx
similarity index 100%
rename from plugins/user-settings/src/components/AuthProviders.tsx
rename to plugins/user-settings/src/components/AuthProviders/AuthProviders.tsx
diff --git a/plugins/user-settings/src/components/DefaultProviderSettings.test.tsx b/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.test.tsx
similarity index 100%
rename from plugins/user-settings/src/components/DefaultProviderSettings.test.tsx
rename to plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.test.tsx
diff --git a/plugins/user-settings/src/components/DefaultProviderSettings.tsx b/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.tsx
similarity index 100%
rename from plugins/user-settings/src/components/DefaultProviderSettings.tsx
rename to plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.tsx
diff --git a/plugins/user-settings/src/components/ProviderSettingsItem.tsx b/plugins/user-settings/src/components/AuthProviders/ProviderSettingsItem.tsx
similarity index 100%
rename from plugins/user-settings/src/components/ProviderSettingsItem.tsx
rename to plugins/user-settings/src/components/AuthProviders/ProviderSettingsItem.tsx
diff --git a/plugins/user-settings/src/components/AuthProviders/index.ts b/plugins/user-settings/src/components/AuthProviders/index.ts
new file mode 100644
index 0000000000..2f6a2b5ab1
--- /dev/null
+++ b/plugins/user-settings/src/components/AuthProviders/index.ts
@@ -0,0 +1,18 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { AuthProviders } from './AuthProviders';
+export { DefaultProviderSettings } from './DefaultProviderSettings';
diff --git a/plugins/user-settings/src/components/FeatureFlags.tsx b/plugins/user-settings/src/components/FeatureFlags/FeatureFlags.tsx
similarity index 100%
rename from plugins/user-settings/src/components/FeatureFlags.tsx
rename to plugins/user-settings/src/components/FeatureFlags/FeatureFlags.tsx
diff --git a/plugins/user-settings/src/components/FeatureFlagsItem.tsx b/plugins/user-settings/src/components/FeatureFlags/FeatureFlagsItem.tsx
similarity index 100%
rename from plugins/user-settings/src/components/FeatureFlagsItem.tsx
rename to plugins/user-settings/src/components/FeatureFlags/FeatureFlagsItem.tsx
diff --git a/plugins/user-settings/src/components/index.ts b/plugins/user-settings/src/components/FeatureFlags/index.ts
similarity index 92%
rename from plugins/user-settings/src/components/index.ts
rename to plugins/user-settings/src/components/FeatureFlags/index.ts
index 59a8b425e4..37c9fd1fd2 100644
--- a/plugins/user-settings/src/components/index.ts
+++ b/plugins/user-settings/src/components/FeatureFlags/index.ts
@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 
-export { UserSettings } from './UserSettings';
+export { FeatureFlags } from './FeatureFlags';
diff --git a/plugins/user-settings/src/components/General.tsx b/plugins/user-settings/src/components/General/General.tsx
similarity index 100%
rename from plugins/user-settings/src/components/General.tsx
rename to plugins/user-settings/src/components/General/General.tsx
diff --git a/plugins/user-settings/src/components/PinButton.test.tsx b/plugins/user-settings/src/components/General/PinButton.test.tsx
similarity index 100%
rename from plugins/user-settings/src/components/PinButton.test.tsx
rename to plugins/user-settings/src/components/General/PinButton.test.tsx
diff --git a/plugins/user-settings/src/components/PinButton.tsx b/plugins/user-settings/src/components/General/PinButton.tsx
similarity index 100%
rename from plugins/user-settings/src/components/PinButton.tsx
rename to plugins/user-settings/src/components/General/PinButton.tsx
diff --git a/plugins/user-settings/src/components/Profile.tsx b/plugins/user-settings/src/components/General/Profile.tsx
similarity index 96%
rename from plugins/user-settings/src/components/Profile.tsx
rename to plugins/user-settings/src/components/General/Profile.tsx
index 5bb9485f8d..b0231d95b6 100644
--- a/plugins/user-settings/src/components/Profile.tsx
+++ b/plugins/user-settings/src/components/General/Profile.tsx
@@ -18,7 +18,7 @@ import { Grid, Typography } from '@material-ui/core';
 import React from 'react';
 import { SignInAvatar } from './SignInAvatar';
 import { UserSettingsMenu } from './UserSettingsMenu';
-import { useUserProfile } from './useUserProfileInfo';
+import { useUserProfile } from '../useUserProfileInfo';
 
 export const Profile = () => {
   const { profile, displayName } = useUserProfile();
diff --git a/plugins/user-settings/src/components/SignInAvatar.tsx b/plugins/user-settings/src/components/General/SignInAvatar.tsx
similarity index 95%
rename from plugins/user-settings/src/components/SignInAvatar.tsx
rename to plugins/user-settings/src/components/General/SignInAvatar.tsx
index 72c636ffe7..8a5bbd75bf 100644
--- a/plugins/user-settings/src/components/SignInAvatar.tsx
+++ b/plugins/user-settings/src/components/General/SignInAvatar.tsx
@@ -17,7 +17,7 @@
 import React from 'react';
 import { BackstageTheme } from '@backstage/theme';
 import { makeStyles, Avatar } from '@material-ui/core';
-import { useUserProfile } from './useUserProfileInfo';
+import { useUserProfile } from '../useUserProfileInfo';
 import { sidebarConfig } from '@backstage/core';
 
 const useStyles = makeStyles<BackstageTheme, { size: number }>(theme => ({
diff --git a/plugins/user-settings/src/components/ThemeToggle.test.tsx b/plugins/user-settings/src/components/General/ThemeToggle.test.tsx
similarity index 100%
rename from plugins/user-settings/src/components/ThemeToggle.test.tsx
rename to plugins/user-settings/src/components/General/ThemeToggle.test.tsx
diff --git a/plugins/user-settings/src/components/ThemeToggle.tsx b/plugins/user-settings/src/components/General/ThemeToggle.tsx
similarity index 100%
rename from plugins/user-settings/src/components/ThemeToggle.tsx
rename to plugins/user-settings/src/components/General/ThemeToggle.tsx
diff --git a/plugins/user-settings/src/components/UserSettingsMenu.test.tsx b/plugins/user-settings/src/components/General/UserSettingsMenu.test.tsx
similarity index 100%
rename from plugins/user-settings/src/components/UserSettingsMenu.test.tsx
rename to plugins/user-settings/src/components/General/UserSettingsMenu.test.tsx
diff --git a/plugins/user-settings/src/components/UserSettingsMenu.tsx b/plugins/user-settings/src/components/General/UserSettingsMenu.tsx
similarity index 100%
rename from plugins/user-settings/src/components/UserSettingsMenu.tsx
rename to plugins/user-settings/src/components/General/UserSettingsMenu.tsx
diff --git a/plugins/user-settings/src/components/General/index.ts b/plugins/user-settings/src/components/General/index.ts
new file mode 100644
index 0000000000..2015d345fe
--- /dev/null
+++ b/plugins/user-settings/src/components/General/index.ts
@@ -0,0 +1,18 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { General } from './General';
+export { SignInAvatar } from './SignInAvatar';
diff --git a/plugins/user-settings/src/components/Settings.tsx b/plugins/user-settings/src/components/Settings.tsx
index ae141457df..f754f1e7c3 100644
--- a/plugins/user-settings/src/components/Settings.tsx
+++ b/plugins/user-settings/src/components/Settings.tsx
@@ -16,7 +16,7 @@
 
 import React from 'react';
 import { SidebarItem } from '@backstage/core';
-import { SignInAvatar } from './SignInAvatar';
+import { SignInAvatar } from './General';
 import { useUserProfile } from './useUserProfileInfo';
 import { settingsRouteRef } from '../plugin';
 
diff --git a/plugins/user-settings/src/components/SettingsPage.tsx b/plugins/user-settings/src/components/SettingsPage.tsx
index de76866653..6ed8e33670 100644
--- a/plugins/user-settings/src/components/SettingsPage.tsx
+++ b/plugins/user-settings/src/components/SettingsPage.tsx
@@ -25,8 +25,7 @@ import {
   useApi,
 } from '@backstage/core';
 import { General } from './General';
-import { AuthProviders } from './AuthProviders';
-import { DefaultProviderSettings } from './DefaultProviderSettings';
+import { AuthProviders, DefaultProviderSettings } from './AuthProviders';
 import { FeatureFlags } from './FeatureFlags';
 
 type Props = {

From 346857e9c6607c8299896164272b22b7bbe47f8d Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 13:22:30 +0200
Subject: [PATCH 048/110] Fix sidebar add app template

---
 .../src/layout/Sidebar/Sidebar.stories.tsx    | 38 +------------------
 .../default-app/packages/app/src/sidebar.tsx  |  4 +-
 2 files changed, 4 insertions(+), 38 deletions(-)

diff --git a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
index ec5746d428..0710be4566 100644
--- a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
+++ b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
@@ -26,18 +26,8 @@ import {
 import HomeOutlinedIcon from '@material-ui/icons/HomeOutlined';
 import AddCircleOutlineIcon from '@material-ui/icons/AddCircleOutline';
 import { MemoryRouter } from 'react-router-dom';
-import {
-  ApiProvider,
-  ApiRegistry,
-  appThemeApiRef,
-  AppThemeSelector,
-  configApiRef,
-  ConfigReader,
-  FeatureFlags,
-  featureFlagsApiRef,
-} from '@backstage/core-api';
 // eslint-disable-next-line import/no-extraneous-dependencies
-import { UserSettings } from '@backstage/plugin-user-settings';
+import { Settings as SidebarSettings } from '@backstage/plugin-user-settings';
 
 export default {
   title: 'Sidebar',
@@ -67,28 +57,6 @@ export const SampleSidebar = () => (
   </Sidebar>
 );
 
-const createConfig = () =>
-  ConfigReader.fromConfigs([
-    {
-      context: '',
-      data: {
-        auth: {
-          providers: {
-            google: { development: {} },
-          },
-        },
-      },
-    },
-  ]);
-
-const config = createConfig();
-
-const apis = ApiRegistry.from([
-  [configApiRef, config],
-  [featureFlagsApiRef, new FeatureFlags()],
-  [appThemeApiRef, AppThemeSelector.createWithStorage([])],
-]);
-
 export const WithUserSettingsPlugin = () => (
   <Sidebar>
     <SidebarSearchField onSearch={handleSearch} />
@@ -100,8 +68,6 @@ export const WithUserSettingsPlugin = () => (
     <SidebarIntro />
     <SidebarSpace />
     <SidebarDivider />
-    <ApiProvider apis={apis}>
-      <UserSettings />
-    </ApiProvider>
+    <SidebarSettings />
   </Sidebar>
 );
diff --git a/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx b/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx
index 8ffd042543..901347645e 100644
--- a/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx
+++ b/packages/create-app/templates/default-app/packages/app/src/sidebar.tsx
@@ -9,7 +9,7 @@ import { Link, makeStyles } from '@material-ui/core';
 import { NavLink } from 'react-router-dom';
 import LogoFull from './LogoFull';
 import LogoIcon from './LogoIcon';
-import { UserSettings } from '@backstage/plugin-user-settings'
+import { Settings as SidebarSettings } from '@backstage/plugin-user-settings';
 
 import {
   Sidebar,
@@ -36,7 +36,7 @@ export const AppSidebar = () => (
     <SidebarDivider />
     <SidebarSpace />
     <SidebarDivider />
-    <UserSettings />
+    <SidebarSettings />
   </Sidebar>
 );
 

From ae0de366896d8d2459c0718e8942429a556ad8d1 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 13:24:39 +0200
Subject: [PATCH 049/110] bump version

---
 plugins/user-settings/package.json | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/plugins/user-settings/package.json b/plugins/user-settings/package.json
index b811213f13..29f86c774b 100644
--- a/plugins/user-settings/package.json
+++ b/plugins/user-settings/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-user-settings",
-  "version": "0.1.1-alpha.23",
+  "version": "0.1.1-alpha.24",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "license": "Apache-2.0",
@@ -21,8 +21,8 @@
     "clean": "backstage-cli clean"
   },
   "dependencies": {
-    "@backstage/core": "^0.1.1-alpha.23",
-    "@backstage/theme": "^0.1.1-alpha.23",
+    "@backstage/core": "^0.1.1-alpha.24",
+    "@backstage/theme": "^0.1.1-alpha.24",
     "@material-ui/core": "^4.11.0",
     "@material-ui/icons": "^4.9.1",
     "@material-ui/lab": "4.0.0-alpha.45",
@@ -32,9 +32,9 @@
     "react-use": "^15.3.3"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.1.1-alpha.23",
-    "@backstage/dev-utils": "^0.1.1-alpha.23",
-    "@backstage/test-utils": "^0.1.1-alpha.23",
+    "@backstage/cli": "^0.1.1-alpha.24",
+    "@backstage/dev-utils": "^0.1.1-alpha.24",
+    "@backstage/test-utils": "^0.1.1-alpha.24",
     "@testing-library/jest-dom": "^5.10.1",
     "@testing-library/react": "^10.4.1",
     "@testing-library/user-event": "^12.0.7",

From d03a7646f575cf6d8905e92b652067f82d98393f Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 15:00:41 +0200
Subject: [PATCH 050/110] Handle empties

---
 packages/app/package.json                     |   1 +
 .../AuthProviders/AuthProviders.tsx           |  29 +++--
 .../AuthProviders/DefaultProviderSettings.tsx | 114 +++++++++---------
 .../AuthProviders/EmptyProviders.tsx          |  59 +++++++++
 .../components/FeatureFlags/EmptyFlags.tsx    |  59 +++++++++
 .../components/FeatureFlags/FeatureFlags.tsx  |  30 +++--
 .../src/components/SettingsPage.tsx           |  19 +--
 7 files changed, 217 insertions(+), 94 deletions(-)
 create mode 100644 plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx
 create mode 100644 plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx

diff --git a/packages/app/package.json b/packages/app/package.json
index 07814cdb0d..0815f00e3a 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -10,6 +10,7 @@
     "@backstage/plugin-api-docs": "^0.1.1-alpha.24",
     "@backstage/plugin-catalog": "^0.1.1-alpha.24",
     "@backstage/plugin-circleci": "^0.1.1-alpha.24",
+    "@backstage/plugin-cloudbuild": "^0.1.1-alpha.24",
     "@backstage/plugin-cost-insights": "^0.1.1-alpha.24",
     "@backstage/plugin-explore": "^0.1.1-alpha.24",
     "@backstage/plugin-gcp-projects": "^0.1.1-alpha.24",
diff --git a/plugins/user-settings/src/components/AuthProviders/AuthProviders.tsx b/plugins/user-settings/src/components/AuthProviders/AuthProviders.tsx
index 917e70b067..563bf44150 100644
--- a/plugins/user-settings/src/components/AuthProviders/AuthProviders.tsx
+++ b/plugins/user-settings/src/components/AuthProviders/AuthProviders.tsx
@@ -16,14 +16,29 @@
 
 import React from 'react';
 import { List } from '@material-ui/core';
-import { InfoCard } from '@backstage/core';
+import { configApiRef, InfoCard, useApi } from '@backstage/core';
+import { EmptyProviders } from './EmptyProviders';
+import { DefaultProviderSettings } from './DefaultProviderSettings';
 
 type Props = {
-  providers: React.ReactNode;
+  providerSettings?: JSX.Element;
 };
 
-export const AuthProviders = ({ providers }: Props) => (
-  <InfoCard>
-    <List dense>{providers}</List>
-  </InfoCard>
-);
+export const AuthProviders = ({ providerSettings }: Props) => {
+  const configApi = useApi(configApiRef);
+  const providersConfig = configApi.getOptionalConfig('auth.providers');
+  const configuredProviders = providersConfig?.keys() || [];
+  const providers = providerSettings ?? (
+    <DefaultProviderSettings configuredProviders={configuredProviders} />
+  );
+
+  if (!providerSettings && !configuredProviders?.length) {
+    return <EmptyProviders />;
+  }
+
+  return (
+    <InfoCard>
+      <List dense>{providers}</List>
+    </InfoCard>
+  );
+};
diff --git a/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.tsx b/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.tsx
index e6e5c21d86..a1dab1e7d4 100644
--- a/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.tsx
+++ b/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.tsx
@@ -14,74 +14,70 @@
  * limitations under the License.
  */
 import {
-  configApiRef,
   githubAuthApiRef,
   gitlabAuthApiRef,
   googleAuthApiRef,
   oauth2ApiRef,
   oktaAuthApiRef,
   microsoftAuthApiRef,
-  useApi,
 } from '@backstage/core';
 import Star from '@material-ui/icons/Star';
 import React from 'react';
 import { ProviderSettingsItem } from './ProviderSettingsItem';
 
-export const DefaultProviderSettings = () => {
-  const configApi = useApi(configApiRef);
-  const providersConfig = configApi.getOptionalConfig('auth.providers');
-  const providers = providersConfig?.keys() ?? [];
-
-  return (
-    <>
-      {providers.includes('google') && (
-        <ProviderSettingsItem
-          title="Google"
-          description={googleAuthApiRef.description}
-          apiRef={googleAuthApiRef}
-          icon={Star}
-        />
-      )}
-      {providers.includes('microsoft') && (
-        <ProviderSettingsItem
-          title="Microsoft"
-          description={microsoftAuthApiRef.description}
-          apiRef={microsoftAuthApiRef}
-          icon={Star}
-        />
-      )}
-      {providers.includes('github') && (
-        <ProviderSettingsItem
-          title="Github"
-          description={githubAuthApiRef.description}
-          apiRef={githubAuthApiRef}
-          icon={Star}
-        />
-      )}
-      {providers.includes('gitlab') && (
-        <ProviderSettingsItem
-          title="Gitlab"
-          description={gitlabAuthApiRef.description}
-          apiRef={gitlabAuthApiRef}
-          icon={Star}
-        />
-      )}
-      {providers.includes('okta') && (
-        <ProviderSettingsItem
-          title="Okta"
-          description={oktaAuthApiRef.description}
-          apiRef={oktaAuthApiRef}
-          icon={Star}
-        />
-      )}
-      {providers.includes('oauth2') && (
-        <ProviderSettingsItem
-          title="YourOrg"
-          description={oauth2ApiRef.description}
-          apiRef={oauth2ApiRef}
-          icon={Star}
-        />
-      )}
-    </>
-  );
+type Props = {
+  configuredProviders: string[];
 };
+
+export const DefaultProviderSettings = ({ configuredProviders }: Props) => (
+  <>
+    {configuredProviders.includes('google') && (
+      <ProviderSettingsItem
+        title="Google"
+        description={googleAuthApiRef.description}
+        apiRef={googleAuthApiRef}
+        icon={Star}
+      />
+    )}
+    {configuredProviders.includes('microsoft') && (
+      <ProviderSettingsItem
+        title="Microsoft"
+        description={microsoftAuthApiRef.description}
+        apiRef={microsoftAuthApiRef}
+        icon={Star}
+      />
+    )}
+    {configuredProviders.includes('github') && (
+      <ProviderSettingsItem
+        title="Github"
+        description={githubAuthApiRef.description}
+        apiRef={githubAuthApiRef}
+        icon={Star}
+      />
+    )}
+    {configuredProviders.includes('gitlab') && (
+      <ProviderSettingsItem
+        title="Gitlab"
+        description={gitlabAuthApiRef.description}
+        apiRef={gitlabAuthApiRef}
+        icon={Star}
+      />
+    )}
+    {configuredProviders.includes('okta') && (
+      <ProviderSettingsItem
+        title="Okta"
+        description={oktaAuthApiRef.description}
+        apiRef={oktaAuthApiRef}
+        icon={Star}
+      />
+    )}
+    {configuredProviders.includes('oauth2') && (
+      <ProviderSettingsItem
+        title="YourOrg"
+        description={oauth2ApiRef.description}
+        apiRef={oauth2ApiRef}
+        icon={Star}
+      />
+    )}
+  </>
+);
diff --git a/plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx b/plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx
new file mode 100644
index 0000000000..864efb9cd5
--- /dev/null
+++ b/plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx
@@ -0,0 +1,59 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { CodeSnippet, EmptyState } from '@backstage/core';
+import { Button, Typography } from '@material-ui/core';
+
+const EXAMPLE = `
+import { createPlugin } from '@backstage/core';
+
+export default createPlugin({
+  id: 'welcome',
+  register({ router, featureFlags }) {
+    featureFlags.register('enable-example-feature');
+  },
+});
+`;
+
+export const EmptyProviders = () => (
+  <EmptyState
+    missing="content"
+    title="No Authentication Providers"
+    description=""
+    action={
+      <>
+        <Typography variant="body1">
+          An example how how to add a feature flags is highlighted below:
+        </Typography>
+        <CodeSnippet
+          text={EXAMPLE}
+          language="typescript"
+          showLineNumbers
+          highlightedNumbers={[7]}
+          customStyle={{ background: 'inherit', fontSize: '115%' }}
+        />
+        <Button
+          variant="contained"
+          color="primary"
+          href="https://backstage.io/docs/api/utility-apis"
+        >
+          Read More
+        </Button>
+      </>
+    }
+  />
+);
diff --git a/plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx b/plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx
new file mode 100644
index 0000000000..438cb8b2a2
--- /dev/null
+++ b/plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx
@@ -0,0 +1,59 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import { CodeSnippet, EmptyState } from '@backstage/core';
+import { Button, Typography } from '@material-ui/core';
+
+const EXAMPLE = `
+import { createPlugin } from '@backstage/core';
+
+export default createPlugin({
+  id: 'welcome',
+  register({ router, featureFlags }) {
+    featureFlags.register('enable-example-feature');
+  },
+});
+`;
+
+export const EmptyFlags = () => (
+  <EmptyState
+    missing="content"
+    title="No Feature Flags"
+    description="Feature Flags makes it possible for plugins to register features in Backstage for users to opt into. You      can use this to split out logic in your code for manual A/B testing, etc."
+    action={
+      <>
+        <Typography variant="body1">
+          An example how how to add a feature flags is highlighted below:
+        </Typography>
+        <CodeSnippet
+          text={EXAMPLE}
+          language="typescript"
+          showLineNumbers
+          highlightedNumbers={[7]}
+          customStyle={{ background: 'inherit', fontSize: '115%' }}
+        />
+        <Button
+          variant="contained"
+          color="primary"
+          href="https://backstage.io/docs/api/utility-apis"
+        >
+          Read More
+        </Button>
+      </>
+    }
+  />
+);
diff --git a/plugins/user-settings/src/components/FeatureFlags/FeatureFlags.tsx b/plugins/user-settings/src/components/FeatureFlags/FeatureFlags.tsx
index d3f21a7c6e..71f59c52b8 100644
--- a/plugins/user-settings/src/components/FeatureFlags/FeatureFlags.tsx
+++ b/plugins/user-settings/src/components/FeatureFlags/FeatureFlags.tsx
@@ -14,25 +14,25 @@
  * limitations under the License.
  */
 
-import React, { useState, useCallback } from 'react';
-import { List } from '@material-ui/core';
+import React, { useCallback, useState } from 'react';
 import {
-  useApi,
-  featureFlagsApiRef,
   FeatureFlagName,
-  FeatureFlagState,
+  featureFlagsApiRef,
   FeatureFlagsRegistryItem,
+  FeatureFlagState,
   InfoCard,
+  useApi,
 } from '@backstage/core';
+import { List } from '@material-ui/core';
+import { EmptyFlags } from './EmptyFlags';
 import { FlagItem } from './FeatureFlagsItem';
 
-type Props = { featureFlags: FeatureFlagsRegistryItem[] };
-
-export const FeatureFlags = ({ featureFlags }: Props) => {
-  const featureFlagApi = useApi(featureFlagsApiRef);
+export const FeatureFlags = () => {
+  const featureFlagsApi = useApi(featureFlagsApiRef);
+  const featureFlags = featureFlagsApi.getRegisteredFlags();
   const initialFlagState = featureFlags.reduce(
     (result, featureFlag: FeatureFlagsRegistryItem) => {
-      const state = featureFlagApi.getFlags().get(featureFlag.name);
+      const state = featureFlagsApi.getFlags().get(featureFlag.name);
 
       result[featureFlag.name] = state;
       return result;
@@ -46,17 +46,21 @@ export const FeatureFlags = ({ featureFlags }: Props) => {
 
   const toggleFlag = useCallback(
     (flagName: FeatureFlagName) => {
-      const newState = featureFlagApi.getFlags().toggle(flagName);
+      const newState = featureFlagsApi.getFlags().toggle(flagName);
 
       setState(prevState => ({
         ...prevState,
         [flagName]: newState,
       }));
-      featureFlagApi.getFlags().save();
+      featureFlagsApi.getFlags().save();
     },
-    [featureFlagApi],
+    [featureFlagsApi],
   );
 
+  if (!featureFlags.length) {
+    return <EmptyFlags />;
+  }
+
   return (
     <InfoCard>
       <List dense>
diff --git a/plugins/user-settings/src/components/SettingsPage.tsx b/plugins/user-settings/src/components/SettingsPage.tsx
index 6ed8e33670..86096e9a1f 100644
--- a/plugins/user-settings/src/components/SettingsPage.tsx
+++ b/plugins/user-settings/src/components/SettingsPage.tsx
@@ -15,17 +15,9 @@
  */
 
 import React, { useState } from 'react';
-import {
-  Content,
-  featureFlagsApiRef,
-  Header,
-  HeaderTabs,
-  Page,
-  pageTheme,
-  useApi,
-} from '@backstage/core';
+import { Content, Header, HeaderTabs, Page, pageTheme } from '@backstage/core';
 import { General } from './General';
-import { AuthProviders, DefaultProviderSettings } from './AuthProviders';
+import { AuthProviders } from './AuthProviders';
 import { FeatureFlags } from './FeatureFlags';
 
 type Props = {
@@ -37,9 +29,6 @@ export const SettingsPage = ({ providerSettings }: Props) => {
   const onTabChange = (index: number) => {
     setActiveTab(index);
   };
-  const featureFlagsApi = useApi(featureFlagsApiRef);
-  const featureFlags = featureFlagsApi.getRegisteredFlags();
-  const providers = providerSettings ?? <DefaultProviderSettings />;
 
   const tabs = [
     { id: 'general', label: 'General' },
@@ -49,8 +38,8 @@ export const SettingsPage = ({ providerSettings }: Props) => {
 
   const content = [
     <General />,
-    <AuthProviders providers={providers} />,
-    <FeatureFlags featureFlags={featureFlags} />,
+    <AuthProviders providerSettings={providerSettings} />,
+    <FeatureFlags />,
   ];
 
   return (

From 28f2d1e0307749fb26ddfbfd5d7484b9ad3bfe11 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 15:02:23 +0200
Subject: [PATCH 051/110] Move story into this plugin

---
 .../src/layout/Sidebar/Sidebar.stories.tsx    | 17 ----
 packages/storybook/.storybook/main.js         |  1 +
 .../SidebarWithSettings.stories.tsx           | 81 +++++++++++++++++++
 3 files changed, 82 insertions(+), 17 deletions(-)
 create mode 100644 plugins/user-settings/src/components/SidebarWithSettings.stories.tsx

diff --git a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
index 0710be4566..908fbba75c 100644
--- a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
+++ b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
@@ -26,8 +26,6 @@ import {
 import HomeOutlinedIcon from '@material-ui/icons/HomeOutlined';
 import AddCircleOutlineIcon from '@material-ui/icons/AddCircleOutline';
 import { MemoryRouter } from 'react-router-dom';
-// eslint-disable-next-line import/no-extraneous-dependencies
-import { Settings as SidebarSettings } from '@backstage/plugin-user-settings';
 
 export default {
   title: 'Sidebar',
@@ -56,18 +54,3 @@ export const SampleSidebar = () => (
     <SidebarSpace />
   </Sidebar>
 );
-
-export const WithUserSettingsPlugin = () => (
-  <Sidebar>
-    <SidebarSearchField onSearch={handleSearch} />
-    <SidebarDivider />
-    <SidebarItem icon={HomeOutlinedIcon} to="#" text="Home" />
-    <SidebarItem icon={HomeOutlinedIcon} to="#" text="Plugins" />
-    <SidebarItem icon={AddCircleOutlineIcon} to="#" text="Create..." />
-    <SidebarDivider />
-    <SidebarIntro />
-    <SidebarSpace />
-    <SidebarDivider />
-    <SidebarSettings />
-  </Sidebar>
-);
diff --git a/packages/storybook/.storybook/main.js b/packages/storybook/.storybook/main.js
index c83bb221be..2c58144acc 100644
--- a/packages/storybook/.storybook/main.js
+++ b/packages/storybook/.storybook/main.js
@@ -5,6 +5,7 @@ module.exports = {
   stories: [
     '../../core/src/layout/**/*.stories.tsx',
     '../../core/src/components/**/*.stories.tsx',
+    '../../../plugins/**/src/**/*.stories.tsx',
   ],
   addons: [
     '@storybook/addon-actions',
diff --git a/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx b/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
new file mode 100644
index 0000000000..c3053e6851
--- /dev/null
+++ b/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
@@ -0,0 +1,81 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 React from 'react';
+import {
+  ApiProvider,
+  ApiRegistry,
+  appThemeApiRef,
+  AppThemeSelector,
+  configApiRef,
+  ConfigReader,
+  FeatureFlags,
+  featureFlagsApiRef,
+  Sidebar,
+  SidebarDivider,
+  SidebarSpace,
+} from '@backstage/core';
+import { MemoryRouter } from 'react-router';
+import { Settings } from './Settings';
+import { SettingsPage } from './SettingsPage';
+
+export default {
+  title: 'Settings',
+  component: Settings,
+  decorators: [
+    (storyFn: () => JSX.Element) => (
+      <MemoryRouter initialEntries={['/']}>{storyFn()}</MemoryRouter>
+    ),
+  ],
+};
+
+export const SidebarItem = () => (
+  <Sidebar>
+    <SidebarSpace />
+    <SidebarDivider />
+    <Settings />
+  </Sidebar>
+);
+
+const createConfig = () =>
+  ConfigReader.fromConfigs([
+    {
+      context: '',
+      data: {
+        auth: {
+          providers: {
+            // google: { development: {} },
+          },
+        },
+      },
+    },
+  ]);
+
+const config = createConfig();
+
+const apis = ApiRegistry.from([
+  [configApiRef, config],
+  [featureFlagsApiRef, new FeatureFlags()],
+  [appThemeApiRef, AppThemeSelector.createWithStorage([])],
+]);
+
+export const TheSettingsPage = () => (
+  <div style={{ border: '1px solid #ddd' }}>
+    <ApiProvider apis={apis}>
+      <SettingsPage />
+    </ApiProvider>
+  </div>
+);

From b47299806e5753c904d9ddd546fbce29d9c15ad7 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 15:19:56 +0200
Subject: [PATCH 052/110] Fix test

---
 ...ttings.test.tsx => AuthProviders.test.tsx} |  6 ++--
 .../AuthProviders/EmptyProviders.tsx          | 28 +++++++++----------
 .../components/FeatureFlags/EmptyFlags.tsx    |  5 ++--
 .../SidebarWithSettings.stories.tsx           |  4 +--
 4 files changed, 20 insertions(+), 23 deletions(-)
 rename plugins/user-settings/src/components/AuthProviders/{DefaultProviderSettings.test.tsx => AuthProviders.test.tsx} (92%)

diff --git a/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.test.tsx b/plugins/user-settings/src/components/AuthProviders/AuthProviders.test.tsx
similarity index 92%
rename from plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.test.tsx
rename to plugins/user-settings/src/components/AuthProviders/AuthProviders.test.tsx
index bc4e0da363..4399b6bd3e 100644
--- a/plugins/user-settings/src/components/AuthProviders/DefaultProviderSettings.test.tsx
+++ b/plugins/user-settings/src/components/AuthProviders/AuthProviders.test.tsx
@@ -24,7 +24,7 @@ import {
 import { renderWithEffects, wrapInTestApp } from '@backstage/test-utils';
 import { fireEvent } from '@testing-library/react';
 import React from 'react';
-import { DefaultProviderSettings } from './DefaultProviderSettings';
+import { AuthProviders } from './AuthProviders';
 
 const mockSignInHandler = jest.fn().mockReturnValue('');
 const mockGoogleAuth = {
@@ -57,12 +57,12 @@ const apiRegistry = ApiRegistry.from([
   [googleAuthApiRef, mockGoogleAuth],
 ]);
 
-describe('<ConfiguredProviderSettings />', () => {
+describe('<AuthProviders />', () => {
   it('displays a provider and calls its sign-in handler on click', async () => {
     const rendered = await renderWithEffects(
       wrapInTestApp(
         <ApiProvider apis={apiRegistry}>
-          <DefaultProviderSettings />
+          <AuthProviders />
         </ApiProvider>,
       ),
     );
diff --git a/plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx b/plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx
index 864efb9cd5..653f449e92 100644
--- a/plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx
+++ b/plugins/user-settings/src/components/AuthProviders/EmptyProviders.tsx
@@ -18,38 +18,38 @@ import React from 'react';
 import { CodeSnippet, EmptyState } from '@backstage/core';
 import { Button, Typography } from '@material-ui/core';
 
-const EXAMPLE = `
-import { createPlugin } from '@backstage/core';
-
-export default createPlugin({
-  id: 'welcome',
-  register({ router, featureFlags }) {
-    featureFlags.register('enable-example-feature');
-  },
-});
+const EXAMPLE = `auth:
+  providers:
+    google:
+      development:
+        clientId:
+          $env: AUTH_GOOGLE_CLIENT_ID
+        clientSecret:
+          $env: AUTH_GOOGLE_CLIENT_SECRET
 `;
 
 export const EmptyProviders = () => (
   <EmptyState
     missing="content"
     title="No Authentication Providers"
-    description=""
+    description="You can add Authentication Providers to Backstage which allows you to use these providers to authenticate yourself."
     action={
       <>
         <Typography variant="body1">
-          An example how how to add a feature flags is highlighted below:
+          Open <code>app-config.yaml</code> and make the changes as highlighted
+          below:
         </Typography>
         <CodeSnippet
           text={EXAMPLE}
-          language="typescript"
+          language="yaml"
           showLineNumbers
-          highlightedNumbers={[7]}
+          highlightedNumbers={[3, 4, 5, 6, 7, 8]}
           customStyle={{ background: 'inherit', fontSize: '115%' }}
         />
         <Button
           variant="contained"
           color="primary"
-          href="https://backstage.io/docs/api/utility-apis"
+          href="https://backstage.io/docs/auth/add-auth-provider"
         >
           Read More
         </Button>
diff --git a/plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx b/plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx
index 438cb8b2a2..5df4df4450 100644
--- a/plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx
+++ b/plugins/user-settings/src/components/FeatureFlags/EmptyFlags.tsx
@@ -18,8 +18,7 @@ import React from 'react';
 import { CodeSnippet, EmptyState } from '@backstage/core';
 import { Button, Typography } from '@material-ui/core';
 
-const EXAMPLE = `
-import { createPlugin } from '@backstage/core';
+const EXAMPLE = `import { createPlugin } from '@backstage/core';
 
 export default createPlugin({
   id: 'welcome',
@@ -43,7 +42,7 @@ export const EmptyFlags = () => (
           text={EXAMPLE}
           language="typescript"
           showLineNumbers
-          highlightedNumbers={[7]}
+          highlightedNumbers={[6]}
           customStyle={{ background: 'inherit', fontSize: '115%' }}
         />
         <Button
diff --git a/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx b/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
index c3053e6851..579f2de640 100644
--- a/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
+++ b/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
@@ -56,9 +56,7 @@ const createConfig = () =>
       context: '',
       data: {
         auth: {
-          providers: {
-            // google: { development: {} },
-          },
+          providers: {},
         },
       },
     },

From 7857e564e4a1d499017207f00e10ebdbada03789 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Tue, 6 Oct 2020 15:24:29 +0200
Subject: [PATCH 053/110] Revert "Move variant style handling for Infocard to
 seperate file and use some of it for TabbedCard"

This reverts commit 94fa82b741eea20f1935ac6ec8bd7de885bc8f50.
---
 .../core/src/layout/InfoCard/InfoCard.tsx     | 74 +++++++++++++++-
 packages/core/src/layout/InfoCard/variants.ts | 86 -------------------
 .../layout/TabbedCard/TabbedCard.stories.tsx  | 19 ----
 .../core/src/layout/TabbedCard/TabbedCard.tsx | 62 ++++---------
 4 files changed, 85 insertions(+), 156 deletions(-)
 delete mode 100644 packages/core/src/layout/InfoCard/variants.ts

diff --git a/packages/core/src/layout/InfoCard/InfoCard.tsx b/packages/core/src/layout/InfoCard/InfoCard.tsx
index 6665023b9e..09d31735cd 100644
--- a/packages/core/src/layout/InfoCard/InfoCard.tsx
+++ b/packages/core/src/layout/InfoCard/InfoCard.tsx
@@ -28,7 +28,6 @@ import {
 import classNames from 'classnames';
 import { ErrorBoundary } from '../ErrorBoundary';
 import { BottomLink, BottomLinkProps } from '../BottomLink';
-import { getVariantStyles } from './variants';
 
 const useStyles = makeStyles(theme => ({
   noPadding: {
@@ -60,6 +59,51 @@ const CardActionsTopRight = withStyles(theme => ({
   },
 }))(CardActions);
 
+const VARIANT_STYLES = {
+  card: {
+    flex: {
+      display: 'flex',
+      flexDirection: 'column',
+    },
+    fullHeight: {
+      display: 'flex',
+      flexDirection: 'column',
+      height: '100%',
+    },
+    height100: {
+      display: 'flex',
+      flexDirection: 'column',
+      height: 'calc(100% - 10px)', // for pages without content header
+      marginBottom: '10px',
+    },
+    contentheader: {
+      height: 'calc(100% - 40px)', // for pages with content header
+    },
+    contentheadertabs: {
+      height: 'calc(100% - 97px)', // for pages with content header and tabs (Tingle)
+    },
+    noShrink: {
+      flexShrink: 0,
+    },
+    minheight300: {
+      minHeight: 300,
+      overflow: 'initial',
+    },
+  },
+  cardContent: {
+    fullHeight: {
+      flex: 1,
+    },
+    height100: {
+      flex: 1,
+    },
+    contentRow: {
+      display: 'flex',
+      flexDirection: 'row',
+    },
+  },
+};
+
 /**
  * InfoCard is used to display a paper-styled block on the screen, similar to a panel.
  *
@@ -119,10 +163,32 @@ export const InfoCard = ({
   noPadding,
 }: Props): JSX.Element => {
   const classes = useStyles();
-  const { cardStyle, contentStyle } = getVariantStyles(variant);
+
+  /**
+   * If variant is specified, we build up styles for that particular variant for both
+   * the Card and the CardContent (since these need to be synced)
+   */
+  let calculatedStyle = {};
+  let calculatedCardStyle = {};
+
+  if (variant) {
+    const variants = variant.split(/[\s]+/g);
+    variants.forEach(name => {
+      calculatedStyle = {
+        ...calculatedStyle,
+        ...VARIANT_STYLES.card[name as keyof typeof VARIANT_STYLES['card']],
+      };
+      calculatedCardStyle = {
+        ...calculatedCardStyle,
+        ...VARIANT_STYLES.cardContent[
+          name as keyof typeof VARIANT_STYLES['cardContent']
+        ],
+      };
+    });
+  }
 
   return (
-    <Card style={cardStyle} className={className}>
+    <Card style={calculatedStyle} className={className}>
       <ErrorBoundary slackChannel={slackChannel}>
         {title && (
           <>
@@ -151,7 +217,7 @@ export const InfoCard = ({
           className={classNames(cardClassName, {
             [classes.noPadding]: noPadding,
           })}
-          style={contentStyle}
+          style={calculatedCardStyle}
         >
           {children}
         </CardContent>
diff --git a/packages/core/src/layout/InfoCard/variants.ts b/packages/core/src/layout/InfoCard/variants.ts
deleted file mode 100644
index cc40bb372f..0000000000
--- a/packages/core/src/layout/InfoCard/variants.ts
+++ /dev/null
@@ -1,86 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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.
- */
-
-const VARIANT_STYLES = {
-  card: {
-    flex: {
-      display: 'flex',
-      flexDirection: 'column',
-    },
-    fullHeight: {
-      display: 'flex',
-      flexDirection: 'column',
-      height: '100%',
-    },
-    height100: {
-      display: 'flex',
-      flexDirection: 'column',
-      height: 'calc(100% - 10px)', // for pages without content header
-      marginBottom: '10px',
-    },
-    contentheader: {
-      height: 'calc(100% - 40px)', // for pages with content header
-    },
-    contentheadertabs: {
-      height: 'calc(100% - 97px)', // for pages with content header and tabs (Tingle)
-    },
-    noShrink: {
-      flexShrink: 0,
-    },
-    minheight300: {
-      minHeight: 300,
-      overflow: 'initial',
-    },
-    flat: {
-      boxShadow: 'none',
-    },
-  },
-  cardContent: {
-    fullHeight: {
-      flex: 1,
-    },
-    height100: {
-      flex: 1,
-    },
-    contentRow: {
-      display: 'flex',
-      flexDirection: 'row',
-    },
-  },
-};
-
-export const getVariantStyles = (variant?: string): Record<string, object> => {
-  const cardStyle = {};
-  const contentStyle = {};
-
-  if (variant) {
-    const variants = variant.split(/[\s]+/g);
-    variants.forEach(name => {
-      Object.assign(
-        cardStyle,
-        VARIANT_STYLES.card[name as keyof typeof VARIANT_STYLES['card']],
-      );
-      Object.assign(
-        contentStyle,
-        VARIANT_STYLES.cardContent[
-          name as keyof typeof VARIANT_STYLES['cardContent']
-        ],
-      );
-    });
-  }
-
-  return { cardStyle, contentStyle };
-};
diff --git a/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx b/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
index ba5399dad9..23c2ab5b49 100644
--- a/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
+++ b/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
@@ -50,25 +50,6 @@ export const Default = () => {
   );
 };
 
-export const WithSubheader = () => {
-  return (
-    <TabbedCard title="Default Example Header" subheader="Subheader">
-      <CardTab label="Option 1">
-        <div style={cardContentStyle}>Some content</div>
-      </CardTab>
-      <CardTab label="Option 2">
-        <div style={cardContentStyle}>Some content 2</div>
-      </CardTab>
-      <CardTab label="Option 3">
-        <div style={cardContentStyle}>Some content 3</div>
-      </CardTab>
-      <CardTab label="Option 4">
-        <div style={cardContentStyle}>Some content 4</div>
-      </CardTab>
-    </TabbedCard>
-  );
-};
-
 const linkInfo = { title: 'Go to XYZ Location', link: '#' };
 
 export const WithFooterLink = () => {
diff --git a/packages/core/src/layout/TabbedCard/TabbedCard.tsx b/packages/core/src/layout/TabbedCard/TabbedCard.tsx
index 7735d7eb8f..e1967b8533 100644
--- a/packages/core/src/layout/TabbedCard/TabbedCard.tsx
+++ b/packages/core/src/layout/TabbedCard/TabbedCard.tsx
@@ -14,12 +14,13 @@
  * limitations under the License.
  */
 
-import React, { useState, ReactElement, ReactNode } from 'react';
+import React, { FC, useState, ReactElement, ReactNode } from 'react';
 import {
   Card,
   CardContent,
   CardHeader,
   Divider,
+  withStyles,
   makeStyles,
   Tabs,
   Tab,
@@ -27,7 +28,6 @@ import {
 } from '@material-ui/core';
 import { BottomLink, BottomLinkProps } from '../BottomLink';
 import { ErrorBoundary } from '../ErrorBoundary';
-import { getVariantStyles } from '../InfoCard/variants';
 
 const useTabsStyles = makeStyles(theme => ({
   root: {
@@ -38,46 +38,31 @@ const useTabsStyles = makeStyles(theme => ({
     backgroundColor: theme.palette.info.main,
     height: theme.spacing(0.3),
   },
-  header: {
-    padding: theme.spacing(2, 2, 2, 2.5),
-  },
-  headerTitle: {
-    fontWeight: 700,
-  },
-  headerSubheader: {
-    paddingTop: theme.spacing(1),
-  },
-  noPadding: {
-    padding: 0,
-    '&:last-child': {
-      paddingBottom: 0,
-    },
-  },
 }));
 
+const BoldHeader = withStyles(theme => ({
+  root: { padding: theme.spacing(2, 2, 2, 2.5), display: 'inline-block' },
+  title: { fontWeight: 700 },
+  subheader: { paddingTop: theme.spacing(1) },
+}))(CardHeader);
+
 type Props = {
   slackChannel?: string;
   children?: ReactElement<TabProps>[];
   onChange?: (event: React.ChangeEvent<{}>, value: number | string) => void;
   title?: string;
-  subheader?: string;
   value?: number | string;
   deepLink?: BottomLinkProps;
-  variant?: string;
-  noPadding?: boolean;
 };
 
-const TabbedCard = ({
+const TabbedCard: FC<Props> = ({
   slackChannel = '#backstage',
   children,
   title,
-  subheader,
   deepLink,
   value,
   onChange,
-  variant,
-  noPadding,
-}: Props) => {
+}) => {
   const tabsClasses = useTabsStyles();
   const [selectedIndex, selectIndex] = useState(0);
 
@@ -97,36 +82,19 @@ const TabbedCard = ({
     });
   }
 
-  const { cardStyle, contentStyle } = getVariantStyles(variant);
-
   return (
-    <Card style={cardStyle}>
+    <Card>
       <ErrorBoundary slackChannel={slackChannel}>
-        {title && (
-          <CardHeader
-            classes={{
-              root: tabsClasses.header,
-              title: tabsClasses.headerTitle,
-              subheader: tabsClasses.headerSubheader,
-            }}
-            title={title}
-            subheader={subheader}
-          />
-        )}
+        {title && <BoldHeader title={title} />}
         <Tabs
-          classes={{ root: tabsClasses.root, indicator: tabsClasses.indicator }}
+          classes={tabsClasses}
           value={value || selectedIndex}
           onChange={handleChange}
         >
           {children}
         </Tabs>
         <Divider />
-        <CardContent
-          className={noPadding ? tabsClasses.noPadding : undefined}
-          style={contentStyle}
-        >
-          {selectedTabContent}
-        </CardContent>
+        <CardContent>{selectedTabContent}</CardContent>
         {deepLink && <BottomLink {...deepLink} />}
       </ErrorBoundary>
     </Card>
@@ -150,7 +118,7 @@ type CardTabProps = TabProps & {
   children: ReactNode;
 };
 
-const CardTab = ({ children, ...props }: CardTabProps) => {
+const CardTab: FC<CardTabProps> = ({ children, ...props }) => {
   const classes = useCardTabStyles();
 
   return <Tab disableRipple classes={classes} {...props} />;

From dd7764675084ab6254065b18278899a6f3e9845c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stefan=20=C3=85lund?= <alund@spotify.com>
Date: Tue, 6 Oct 2020 15:34:34 +0200
Subject: [PATCH 054/110] emptystates: add transparent versions

---
 .../EmptyState/EmptyState.stories.tsx         | 14 +-----
 .../src/components/EmptyState/EmptyState.tsx  |  5 ---
 .../EmptyState/assets/createComponent.svg     | 37 ++++++++++++++-
 .../EmptyState/assets/missingAnnotation.svg   | 43 +++++++++++++++++-
 .../components/EmptyState/assets/noBuild.svg  | 45 ++++++++++++++++++-
 .../EmptyState/assets/noInformation.svg       | 11 ++++-
 6 files changed, 134 insertions(+), 21 deletions(-)

diff --git a/packages/core/src/components/EmptyState/EmptyState.stories.tsx b/packages/core/src/components/EmptyState/EmptyState.stories.tsx
index 15d61f14c0..9d507091d2 100644
--- a/packages/core/src/components/EmptyState/EmptyState.stories.tsx
+++ b/packages/core/src/components/EmptyState/EmptyState.stories.tsx
@@ -26,13 +26,9 @@ export default {
 
 const containerStyle = { width: '100%', height: '100vh' };
 
-export const Field = () => (
+export const MissingAnnotation = () => (
   <div style={containerStyle}>
-    <EmptyState
-      missing="field"
-      title="Your plugin is missing an annotation"
-      description="Add a description here."
-    />
+    <MissingAnnotationEmptyState annotation="backstage.io/example" />
   </div>
 );
 
@@ -80,9 +76,3 @@ export const WithAction = () => (
     />
   </div>
 );
-
-export const MissingAnnotation = () => (
-  <div style={containerStyle}>
-    <MissingAnnotationEmptyState annotation="backstage.io/example" />
-  </div>
-);
diff --git a/packages/core/src/components/EmptyState/EmptyState.tsx b/packages/core/src/components/EmptyState/EmptyState.tsx
index 4469c3ce86..3a56fc6cb3 100644
--- a/packages/core/src/components/EmptyState/EmptyState.tsx
+++ b/packages/core/src/components/EmptyState/EmptyState.tsx
@@ -66,11 +66,6 @@ export const EmptyState = ({ title, description, missing, action }: Props) => {
         </Grid>
       </Grid>
       <Grid item xs={12} md={6} className={classes.imageContainer}>
-        <img
-          src={Background}
-          className={classes.backgroundImage}
-          alt="background"
-        />
         <EmptyStateImage missing={missing} />
       </Grid>
     </Grid>
diff --git a/packages/core/src/components/EmptyState/assets/createComponent.svg b/packages/core/src/components/EmptyState/assets/createComponent.svg
index bb8b50e1ef..2634bb7f23 100644
--- a/packages/core/src/components/EmptyState/assets/createComponent.svg
+++ b/packages/core/src/components/EmptyState/assets/createComponent.svg
@@ -1 +1,36 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="282" height="186" fill="none" viewBox="0 0 282 186"><g filter="url(#filter0_d)"><path fill="#9E9E9E" d="M254.494 16.3785H23.3728C20.6336 16.3785 18.4131 18.5995 18.4131 21.3392V36.221C18.4131 38.9607 20.6336 41.1816 23.3728 41.1816H254.494C257.233 41.1816 259.454 38.9607 259.454 36.221V21.3392C259.454 18.5995 257.233 16.3785 254.494 16.3785Z"/><mask id="mask0" width="242" height="146" x="18" y="16" mask-type="alpha" maskUnits="userSpaceOnUse"><path fill="#404040" d="M254.494 16.3785H23.3728C20.6336 16.3785 18.4131 18.5995 18.4131 21.3392V156.268C18.4131 159.008 20.6336 161.228 23.3728 161.228H254.494C257.233 161.228 259.454 159.008 259.454 156.268V21.3392C259.454 18.5995 257.233 16.3785 254.494 16.3785Z"/></mask><g mask="url(#mask0)"><path fill="#EEE" d="M259.495 30.2683H18.4131V161.432H259.495V30.2683Z"/><path fill="#D9D9D9" d="M25.3567 25.306C26.4524 25.306 27.3406 24.418 27.3406 23.3226C27.3406 22.2272 26.4524 21.3392 25.3567 21.3392C24.261 21.3392 23.3728 22.2272 23.3728 23.3226C23.3728 24.418 24.261 25.306 25.3567 25.306Z" opacity=".4"/><path fill="#D9D9D9" d="M32.4084 25.306C33.5041 25.306 34.3923 24.418 34.3923 23.3226C34.3923 22.2272 33.5041 21.3392 32.4084 21.3392C31.3127 21.3392 30.4246 22.2272 30.4246 23.3226C30.4246 24.418 31.3127 25.306 32.4084 25.306Z" opacity=".4"/><path fill="#D9D9D9" d="M39.2439 25.306C40.3395 25.306 41.2278 24.418 41.2278 23.3226C41.2278 22.2272 40.3395 21.3392 39.2439 21.3392C38.1482 21.3392 37.26 22.2272 37.26 23.3226C37.26 24.418 38.1482 25.306 39.2439 25.306Z" opacity=".3"/><path fill="#616161" d="M32.5328 29.9937H18.4131V161.432H32.5328V29.9937Z"/><path fill="#D9D9D9" d="M259.495 29.9937H32.533V46.2271H259.495V29.9937Z"/><path fill="#fff" d="M67.3094 50.94H39.5928C38.5819 50.94 37.7625 51.7606 37.7625 52.7729C37.7625 53.7851 38.5819 54.6057 39.5928 54.6057H67.3094C68.3202 54.6057 69.1397 53.7851 69.1397 52.7729C69.1397 51.7606 68.3202 50.94 67.3094 50.94Z"/><path fill="#fff" d="M97.6407 57.224H39.5928C38.5819 57.224 37.7625 58.0445 37.7625 59.0568C37.7625 60.069 38.5819 60.8896 39.5928 60.8896H97.6407C98.6516 60.8896 99.471 60.069 99.471 59.0568C99.471 58.0445 98.6516 57.224 97.6407 57.224Z"/><path fill="#BDBDBD" d="M253.219 50.9401H228.118C227.54 50.9401 227.072 51.409 227.072 51.9874V58.2713C227.072 58.8497 227.54 59.3186 228.118 59.3186H253.219C253.797 59.3186 254.265 58.8497 254.265 58.2713V51.9874C254.265 51.409 253.797 50.9401 253.219 50.9401Z"/><path stroke="#D9D9D9" stroke-dasharray="5 5" stroke-width="2" d="M99.994 66.9117H40.3772C39.3663 66.9117 38.5469 67.7322 38.5469 68.7445V114.303C38.5469 115.315 39.3663 116.136 40.3772 116.136H99.994C101.005 116.136 101.824 115.315 101.824 114.303V68.7445C101.824 67.7322 101.005 66.9117 99.994 66.9117Z"/><path stroke="#D9D9D9" stroke-dasharray="5 5" stroke-width="2" d="M175.822 66.9117H112.545C111.534 66.9117 110.714 67.7322 110.714 68.7445V114.303C110.714 115.315 111.534 116.136 112.545 116.136H175.822C176.833 116.136 177.652 115.315 177.652 114.303V68.7445C177.652 67.7322 176.833 66.9117 175.822 66.9117Z"/><path stroke="#D9D9D9" stroke-dasharray="5 5" stroke-width="2" d="M251.65 66.9117H188.373C187.362 66.9117 186.543 67.7322 186.543 68.7445V114.303C186.543 115.315 187.362 116.136 188.373 116.136H251.65C252.661 116.136 253.481 115.315 253.481 114.303V68.7445C253.481 67.7322 252.661 66.9117 251.65 66.9117Z"/><path stroke="#D9D9D9" stroke-dasharray="5 5" stroke-width="2" d="M139.739 124.514H40.3772C39.3663 124.514 38.5469 125.335 38.5469 126.347V163.527C38.5469 164.539 39.3663 165.36 40.3772 165.36H139.739C140.749 165.36 141.569 164.539 141.569 163.527V126.347C141.569 125.335 140.749 124.514 139.739 124.514Z"/><path stroke="#D9D9D9" stroke-dasharray="5 5" stroke-width="2" d="M251.651 124.514H152.289C151.278 124.514 150.459 125.335 150.459 126.347V163.527C150.459 164.539 151.278 165.36 152.289 165.36H251.651C252.661 165.36 253.481 164.539 253.481 163.527V126.347C253.481 125.335 252.661 124.514 251.651 124.514Z"/></g></g><defs><filter id="filter0_d" width="281.041" height="184.85" x=".413" y=".379" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dx="2" dy="4"/><feGaussianBlur stdDeviation="10"/><feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="BackgroundImageFix" mode="normal" result="effect1_dropShadow"/><feBlend in="SourceGraphic" in2="effect1_dropShadow" mode="normal" result="shape"/></filter></defs></svg>
\ No newline at end of file
+<svg width="693" height="425" viewBox="0 0 693 425" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M40.4387 110.977C27.1556 113.452 18.3941 126.227 20.8693 139.51C23.3445 152.793 36.1192 161.555 49.4023 159.079L67.7036 155.669C62.6078 161.153 60.0854 168.896 61.562 176.82C64.0372 190.103 76.8118 198.865 90.0949 196.39L220.39 172.11C220.416 172.267 220.444 172.425 220.473 172.582C221.95 180.507 227.092 186.822 233.821 190.102L225.826 191.592C212.542 194.067 203.781 206.841 206.256 220.125C208.731 233.408 221.506 242.169 234.789 239.694L614.544 168.929C627.827 166.454 636.588 153.679 634.113 140.396C632.636 132.472 627.494 126.157 620.765 122.877L633.556 120.493C646.839 118.018 655.601 105.244 653.126 91.9604C650.65 78.6773 637.876 69.9158 624.593 72.3911L396.82 114.835C396.794 114.678 396.766 114.52 396.737 114.363C395.26 106.438 390.118 100.123 383.389 96.8431L405.503 92.7224C418.786 90.2471 427.547 77.4725 425.072 64.1894C422.597 50.9063 409.822 42.1448 396.539 44.62L40.4387 110.977ZM59.718 301.107C57.2428 287.824 66.0043 275.05 79.2874 272.574L468.975 199.959C482.258 197.484 495.032 206.245 497.508 219.528C499.983 232.811 491.221 245.586 477.938 248.061L466.779 250.141C468.082 250.776 469.325 251.524 470.493 252.376L605.53 227.213C618.813 224.738 631.588 233.499 634.063 246.782C635.54 254.707 633.017 262.45 627.922 267.934L630.641 267.427C643.924 264.952 656.699 273.713 659.174 286.996C661.649 300.279 652.888 313.054 639.604 315.529L234.809 390.96C221.526 393.435 208.751 384.674 206.276 371.391C203.801 358.108 212.563 345.333 225.846 342.858L255.404 337.35C254.101 336.715 252.858 335.966 251.69 335.114L71.5053 368.69C58.2222 371.165 45.4476 362.404 42.9723 349.121C40.4971 335.838 49.2586 323.063 62.5417 320.588L73.0655 318.627C66.3367 315.347 61.1946 309.032 59.718 301.107Z" fill="black" fill-opacity="0.05"/>
+<g filter="url(#filter0_d)">
+<path d="M567.437 70H125.484C120.246 70 116 74.2412 116 79.473V107.892C116 113.124 120.246 117.365 125.484 117.365H567.437C572.675 117.365 576.921 113.124 576.921 107.892V79.473C576.921 74.2412 572.675 70 567.437 70Z" fill="#9E9E9E"/>
+<mask id="mask0" mask-type="alpha" maskUnits="userSpaceOnUse" x="116" y="70" width="461" height="277">
+<path d="M567.437 70H125.484C120.246 70 116 74.2412 116 79.473V337.138C116 342.37 120.246 346.611 125.484 346.611H567.437C572.675 346.611 576.921 342.37 576.921 337.138V79.473C576.921 74.2412 572.675 70 567.437 70Z" fill="#404040"/>
+</mask>
+<g mask="url(#mask0)">
+<path d="M577 96.5244H116V347H577V96.5244Z" fill="#EEEEEE"/>
+<path opacity="0.4" d="M129.278 87.0483C131.373 87.0483 133.071 85.3525 133.071 83.2606C133.071 81.1687 131.373 79.4729 129.278 79.4729C127.182 79.4729 125.484 81.1687 125.484 83.2606C125.484 85.3525 127.182 87.0483 129.278 87.0483Z" fill="#D9D9D9"/>
+<path opacity="0.4" d="M142.762 87.0483C144.857 87.0483 146.555 85.3525 146.555 83.2606C146.555 81.1687 144.857 79.4729 142.762 79.4729C140.667 79.4729 138.968 81.1687 138.968 83.2606C138.968 85.3525 140.667 87.0483 142.762 87.0483Z" fill="#D9D9D9"/>
+<path opacity="0.3" d="M155.833 87.0483C157.928 87.0483 159.626 85.3525 159.626 83.2606C159.626 81.1687 157.928 79.4729 155.833 79.4729C153.738 79.4729 152.039 81.1687 152.039 83.2606C152.039 85.3525 153.738 87.0483 155.833 87.0483Z" fill="#D9D9D9"/>
+<rect x="116" y="96" width="27" height="251" fill="#616161"/>
+<rect x="143" y="96" width="434" height="31" fill="#D9D9D9"/>
+<rect x="153" y="136" width="60" height="7" rx="3.5" fill="white"/>
+<rect x="153" y="148" width="118" height="7" rx="3.5" fill="white"/>
+<rect x="515" y="136" width="52" height="16" rx="2" fill="#BDBDBD"/>
+<rect x="154.5" y="166.5" width="121" height="94" rx="3.5" stroke="#D9D9D9" stroke-width="3" stroke-dasharray="5 5"/>
+<rect x="292.5" y="166.5" width="128" height="94" rx="3.5" stroke="#D9D9D9" stroke-width="3" stroke-dasharray="5 5"/>
+<rect x="437.5" y="166.5" width="128" height="94" rx="3.5" stroke="#D9D9D9" stroke-width="3" stroke-dasharray="5 5"/>
+<rect x="154.5" y="276.5" width="197" height="78" rx="3.5" stroke="#D9D9D9" stroke-width="3" stroke-dasharray="5 5"/>
+<rect x="368.5" y="276.5" width="197" height="78" rx="3.5" stroke="#D9D9D9" stroke-width="3" stroke-dasharray="5 5"/>
+</g>
+</g>
+<defs>
+<filter id="filter0_d" x="98" y="54" width="500.921" height="316.611" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset dx="2" dy="4"/>
+<feGaussianBlur stdDeviation="10"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+</defs>
+</svg>
diff --git a/packages/core/src/components/EmptyState/assets/missingAnnotation.svg b/packages/core/src/components/EmptyState/assets/missingAnnotation.svg
index 39534656fa..4f69605e6a 100644
--- a/packages/core/src/components/EmptyState/assets/missingAnnotation.svg
+++ b/packages/core/src/components/EmptyState/assets/missingAnnotation.svg
@@ -1 +1,42 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="259" height="162" fill="none" viewBox="0 0 259 162"><g filter="url(#filter0_d)"><rect width="243" height="25" x="6" y="4" fill="#9E9E9E" rx="5"/><mask id="mask0" width="243" height="146" x="6" y="4" mask-type="alpha" maskUnits="userSpaceOnUse"><rect width="243" height="146" x="6" y="4" fill="#404040" rx="5"/></mask><g mask="url(#mask0)"><rect width="247" height="139" x="6" y="18" fill="#EEE"/><rect width="181" height="4" x="42" y="61" fill="#fff" rx="2"/><rect width="113" height="4" x="42" y="70" fill="#fff" rx="2"/><rect width="50" height="4" x="42" y="43" fill="#fff" rx="2"/><rect width="36" height="4" x="22" y="25" fill="#fff" rx="2"/><rect width="4" height="4" x="11" y="25" fill="#F8F8F8" rx="2"/><rect width="4" height="4" x="11" y="34" fill="#F8F8F8" rx="2"/><rect width="4" height="4" x="11" y="43" fill="#F8F8F8" rx="2"/><rect width="4" height="4" x="11" y="52" fill="#F8F8F8" rx="2"/><rect width="4" height="4" x="11" y="62" fill="#F8F8F8" rx="2"/><rect width="4" height="4" x="11" y="70" fill="#F8F8F8" rx="2"/><rect width="4" height="4" x="11" y="79" fill="#F8F8F8" rx="2"/><rect width="4" height="4" x="11" y="88" fill="#F8F8F8" rx="2"/><rect width="181" height="4" x="42" y="52" fill="#fff" rx="2"/><rect width="35" height="4" x="22" y="88" fill="#fff" rx="2"/><rect width="92" height="4" x="32" y="79" fill="#fff" rx="2"/><rect width="45" height="4" x="32" y="34" fill="#fff" rx="2"/></g><ellipse cx="13" cy="10.999" fill="#D9D9D9" opacity=".4" rx="2" ry="1.999"/><ellipse cx="20.109" cy="10.999" fill="#D9D9D9" opacity=".4" rx="2" ry="1.999"/><ellipse cx="27" cy="10.999" fill="#D9D9D9" opacity=".3" rx="2" ry="1.999"/></g><defs><filter id="filter0_d" width="259" height="162" x="0" y="0" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dx="2" dy="4"/><feGaussianBlur stdDeviation="4"/><feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="BackgroundImageFix" mode="normal" result="effect1_dropShadow"/><feBlend in="SourceGraphic" in2="effect1_dropShadow" mode="normal" result="shape"/></filter></defs></svg>
\ No newline at end of file
+<svg width="687" height="421" viewBox="0 0 687 421" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M40.0514 109.914C26.8955 112.366 18.2179 125.018 20.6695 138.174C23.121 151.33 35.7733 160.007 48.9292 157.556L67.0549 154.178C62.008 159.609 59.5097 167.278 60.9722 175.127C63.4237 188.283 76.076 196.96 89.2319 194.509L218.279 170.462C218.305 170.617 218.333 170.773 218.362 170.929C219.824 178.778 224.917 185.032 231.582 188.281L223.663 189.757C210.507 192.208 201.83 204.861 204.281 218.016C206.733 231.172 219.385 239.85 232.541 237.398L608.658 167.311C621.814 164.86 630.492 152.208 628.04 139.052C626.578 131.203 621.485 124.949 614.821 121.7L627.489 119.339C640.645 116.888 649.322 104.236 646.871 91.0797C644.419 77.9238 631.767 69.2462 618.611 71.6977L393.02 113.735C392.994 113.579 392.966 113.423 392.937 113.267C391.475 105.419 386.382 99.1643 379.717 95.9156L401.619 91.8343C414.775 89.3828 423.453 76.7305 421.001 63.5746C418.55 50.4187 405.897 41.7411 392.742 44.1927L40.0514 109.914ZM59.146 298.224C56.6945 285.068 65.3721 272.416 78.528 269.964L464.483 198.044C477.639 195.592 490.292 204.27 492.743 217.426C495.195 230.582 486.517 243.234 473.361 245.685L462.309 247.745C463.599 248.374 464.83 249.115 465.987 249.959L599.731 225.037C612.887 222.585 625.539 231.263 627.991 244.419C629.453 252.267 626.955 259.937 621.908 265.368L624.601 264.866C637.757 262.414 650.41 271.092 652.861 284.248C655.313 297.404 646.635 310.056 633.479 312.507L232.561 387.216C219.405 389.667 206.752 380.99 204.301 367.834C201.849 354.678 210.527 342.026 223.683 339.574L252.958 334.119C251.668 333.49 250.437 332.749 249.279 331.905L70.8205 365.159C57.6646 367.611 45.0123 358.933 42.5608 345.777C40.1093 332.621 48.7869 319.969 61.9428 317.518L72.3657 315.575C65.7014 312.327 60.6085 306.072 59.146 298.224Z" fill="black" fill-opacity="0.05"/>
+<g filter="url(#filter0_d)">
+<path d="M566.795 76.0288H124.842C119.604 76.0288 115.358 80.27 115.358 85.5018V113.921C115.358 119.153 119.604 123.394 124.842 123.394H566.795C572.033 123.394 576.279 119.153 576.279 113.921V85.5018C576.279 80.27 572.033 76.0288 566.795 76.0288Z" fill="#9E9E9E"/>
+<mask id="mask0" mask-type="alpha" maskUnits="userSpaceOnUse" x="115" y="76" width="462" height="277">
+<path d="M566.795 76.0288H124.842C119.604 76.0288 115.358 80.27 115.358 85.5018V343.167C115.358 348.399 119.604 352.64 124.842 352.64H566.795C572.033 352.64 576.279 348.399 576.279 343.167V85.5018C576.279 80.27 572.033 76.0288 566.795 76.0288Z" fill="#404040"/>
+</mask>
+<g mask="url(#mask0)">
+<path d="M583.866 102.553H115.358V365.902H583.866V102.553Z" fill="#EEEEEE"/>
+<path d="M523.169 184.021H187.436C185.341 184.021 183.643 185.717 183.643 187.81C183.643 189.903 185.341 191.599 187.436 191.599H523.169C525.264 191.599 526.962 189.903 526.962 187.81C526.962 185.717 525.264 184.021 523.169 184.021Z" fill="white"/>
+<path d="M394.187 201.072H187.436C185.341 201.072 183.643 202.769 183.643 204.861C183.643 206.954 185.341 208.651 187.436 208.651H394.187C396.282 208.651 397.98 206.954 397.98 204.861C397.98 202.769 396.282 201.072 394.187 201.072Z" fill="white"/>
+<path d="M274.689 149.918H187.436C185.341 149.918 183.643 151.615 183.643 153.707C183.643 155.8 185.341 157.497 187.436 157.497H274.689C276.784 157.497 278.482 155.8 278.482 153.707C278.482 151.615 276.784 149.918 274.689 149.918Z" fill="white"/>
+<path d="M210.198 115.815H149.5C147.405 115.815 145.707 117.512 145.707 119.605C145.707 121.697 147.405 123.394 149.5 123.394H210.198C212.293 123.394 213.991 121.697 213.991 119.605C213.991 117.512 212.293 115.815 210.198 115.815Z" fill="white"/>
+<path d="M132.429 119.605C132.429 117.512 130.731 115.815 128.636 115.815C126.54 115.815 124.842 117.512 124.842 119.605C124.842 121.697 126.54 123.394 128.636 123.394C130.731 123.394 132.429 121.697 132.429 119.605Z" fill="#F8F8F8"/>
+<path d="M132.429 136.656C132.429 134.563 130.731 132.867 128.636 132.867C126.54 132.867 124.842 134.563 124.842 136.656C124.842 138.749 126.54 140.445 128.636 140.445C130.731 140.445 132.429 138.749 132.429 136.656Z" fill="#F8F8F8"/>
+<path d="M132.429 153.707C132.429 151.615 130.731 149.918 128.636 149.918C126.54 149.918 124.842 151.615 124.842 153.707C124.842 155.8 126.54 157.497 128.636 157.497C130.731 157.497 132.429 155.8 132.429 153.707Z" fill="#F8F8F8"/>
+<path d="M132.429 170.759C132.429 168.666 130.731 166.969 128.636 166.969C126.54 166.969 124.842 168.666 124.842 170.759C124.842 172.851 126.54 174.548 128.636 174.548C130.731 174.548 132.429 172.851 132.429 170.759Z" fill="#F8F8F8"/>
+<path d="M132.429 189.705C132.429 187.612 130.731 185.916 128.636 185.916C126.54 185.916 124.842 187.612 124.842 189.705C124.842 191.797 126.54 193.494 128.636 193.494C130.731 193.494 132.429 191.797 132.429 189.705Z" fill="#F8F8F8"/>
+<path d="M132.429 204.861C132.429 202.769 130.731 201.072 128.636 201.072C126.54 201.072 124.842 202.769 124.842 204.861C124.842 206.954 126.54 208.651 128.636 208.651C130.731 208.651 132.429 206.954 132.429 204.861Z" fill="#F8F8F8"/>
+<path d="M132.429 221.913C132.429 219.82 130.731 218.124 128.636 218.124C126.54 218.124 124.842 219.82 124.842 221.913C124.842 224.005 126.54 225.702 128.636 225.702C130.731 225.702 132.429 224.005 132.429 221.913Z" fill="#F8F8F8"/>
+<path d="M132.429 238.964C132.429 236.872 130.731 235.175 128.636 235.175C126.54 235.175 124.842 236.872 124.842 238.964C124.842 241.057 126.54 242.753 128.636 242.753C130.731 242.753 132.429 241.057 132.429 238.964Z" fill="#F8F8F8"/>
+<path d="M523.169 166.969H187.436C185.341 166.969 183.643 168.666 183.643 170.759C183.643 172.851 185.341 174.548 187.436 174.548H523.169C525.264 174.548 526.962 172.851 526.962 170.759C526.962 168.666 525.264 166.969 523.169 166.969Z" fill="white"/>
+<path d="M208.301 235.175H149.5C147.405 235.175 145.707 236.872 145.707 238.964C145.707 241.057 147.405 242.753 149.5 242.753H208.301C210.396 242.753 212.094 241.057 212.094 238.964C212.094 236.872 210.396 235.175 208.301 235.175Z" fill="white"/>
+<path d="M335.386 218.124H168.468C166.373 218.124 164.675 219.82 164.675 221.913C164.675 224.005 166.373 225.702 168.468 225.702H335.386C337.481 225.702 339.18 224.005 339.18 221.913C339.18 219.82 337.481 218.124 335.386 218.124Z" fill="white"/>
+<path d="M246.237 132.867H168.468C166.373 132.867 164.675 134.563 164.675 136.656C164.675 138.749 166.373 140.445 168.468 140.445H246.237C248.332 140.445 250.03 138.749 250.03 136.656C250.03 134.563 248.332 132.867 246.237 132.867Z" fill="white"/>
+<path opacity="0.4" d="M128.636 93.0771C130.731 93.0771 132.429 91.3813 132.429 89.2894C132.429 87.1975 130.731 85.5017 128.636 85.5017C126.54 85.5017 124.842 87.1975 124.842 89.2894C124.842 91.3813 126.54 93.0771 128.636 93.0771Z" fill="#D9D9D9"/>
+<path opacity="0.4" d="M142.12 93.0771C144.215 93.0771 145.913 91.3813 145.913 89.2894C145.913 87.1975 144.215 85.5017 142.12 85.5017C140.025 85.5017 138.326 87.1975 138.326 89.2894C138.326 91.3813 140.025 93.0771 142.12 93.0771Z" fill="#D9D9D9"/>
+<path opacity="0.3" d="M155.191 93.0771C157.286 93.0771 158.984 91.3813 158.984 89.2894C158.984 87.1975 157.286 85.5017 155.191 85.5017C153.096 85.5017 151.397 87.1975 151.397 89.2894C151.397 91.3813 153.096 93.0771 155.191 93.0771Z" fill="#D9D9D9"/>
+</g>
+</g>
+<defs>
+<filter id="filter0_d" x="97.3579" y="60.0288" width="500.921" height="316.611" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset dx="2" dy="4"/>
+<feGaussianBlur stdDeviation="10"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+</defs>
+</svg>
diff --git a/packages/core/src/components/EmptyState/assets/noBuild.svg b/packages/core/src/components/EmptyState/assets/noBuild.svg
index ef45e1c736..d84f36af30 100644
--- a/packages/core/src/components/EmptyState/assets/noBuild.svg
+++ b/packages/core/src/components/EmptyState/assets/noBuild.svg
@@ -1 +1,44 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="270" height="177" fill="none" viewBox="0 0 270 177"><g filter="url(#filter0_d)"><path fill="#F8F8F8" d="M250.664 8H15.3362C12.3891 8 10 10.3891 10 13.3362V155.28C10 158.227 12.3891 160.616 15.3362 160.616H250.664C253.611 160.616 256 158.227 256 155.28V13.3362C256 10.3891 253.611 8 250.664 8Z"/><path fill="#D9D9D9" d="M52.423 21.8742H26.8091C25.7776 21.8742 24.9414 22.7104 24.9414 23.7419C24.9414 24.7734 25.7776 25.6095 26.8091 25.6095H52.423C53.4545 25.6095 54.2906 24.7734 54.2906 23.7419C54.2906 22.7104 53.4545 21.8742 52.423 21.8742Z"/><path fill="#BDBDBD" d="M45.4859 42.6855H26.8091C25.7776 42.6855 24.9414 43.5217 24.9414 44.5531C24.9414 45.5846 25.7776 46.4208 26.8091 46.4208H45.4859C46.5174 46.4208 47.3536 45.5846 47.3536 44.5531C47.3536 43.5217 46.5174 42.6855 45.4859 42.6855Z"/><path fill="#BDBDBD" d="M57.7592 63.4967H26.8091C25.7776 63.4967 24.9414 64.3329 24.9414 65.3644C24.9414 66.3959 25.7776 67.2321 26.8091 67.2321H57.7592C58.7907 67.2321 59.6269 66.3959 59.6269 65.3644C59.6269 64.3329 58.7907 63.4967 57.7592 63.4967Z"/><path fill="#BDBDBD" d="M55.0911 84.308H26.8091C25.7776 84.308 24.9414 85.1442 24.9414 86.1757C24.9414 87.2072 25.7776 88.0434 26.8091 88.0434H55.0911C56.1226 88.0434 56.9588 87.2072 56.9588 86.1757C56.9588 85.1442 56.1226 84.308 55.0911 84.308Z"/><path fill="#BDBDBD" d="M67.898 105.119H26.8091C25.7776 105.119 24.9414 105.955 24.9414 106.987C24.9414 108.018 25.7776 108.855 26.8091 108.855H67.898C68.9295 108.855 69.7657 108.018 69.7657 106.987C69.7657 105.955 68.9295 105.119 67.898 105.119Z"/><path fill="#BDBDBD" d="M45.4859 125.931H26.8091C25.7776 125.931 24.9414 126.767 24.9414 127.798C24.9414 128.83 25.7776 129.666 26.8091 129.666H45.4859C46.5174 129.666 47.3536 128.83 47.3536 127.798C47.3536 126.767 46.5174 125.931 45.4859 125.931Z"/><path fill="#BDBDBD" d="M57.7592 146.742H26.8091C25.7776 146.742 24.9414 147.578 24.9414 148.61C24.9414 149.641 25.7776 150.477 26.8091 150.477H57.7592C58.7907 150.477 59.6269 149.641 59.6269 148.61C59.6269 147.578 58.7907 146.742 57.7592 146.742Z"/><path fill="#D9D9D9" d="M112.189 21.8742H97.2473C96.2158 21.8742 95.3796 22.7104 95.3796 23.7419C95.3796 24.7734 96.2158 25.6095 97.2473 25.6095H112.189C113.22 25.6095 114.056 24.7734 114.056 23.7419C114.056 22.7104 113.22 21.8742 112.189 21.8742Z"/><path fill="#BDBDBD" d="M147.941 42.6855H97.2473C96.2158 42.6855 95.3796 43.5217 95.3796 44.5531C95.3796 45.5846 96.2158 46.4208 97.2473 46.4208H147.941C148.973 46.4208 149.809 45.5846 149.809 44.5531C149.809 43.5217 148.973 42.6855 147.941 42.6855Z"/><path fill="#BDBDBD" d="M134.601 63.4967H97.2473C96.2158 63.4967 95.3796 64.3329 95.3796 65.3644C95.3796 66.3959 96.2158 67.2321 97.2473 67.2321H134.601C135.632 67.2321 136.469 66.3959 136.469 65.3644C136.469 64.3329 135.632 63.4967 134.601 63.4967Z"/><path fill="#BDBDBD" d="M143.139 84.308H97.2473C96.2158 84.308 95.3796 85.1442 95.3796 86.1757C95.3796 87.2072 96.2158 88.0434 97.2473 88.0434H143.139C144.17 88.0434 145.007 87.2072 145.007 86.1757C145.007 85.1442 144.17 84.308 143.139 84.308Z"/><path fill="#BDBDBD" d="M115.924 105.119H97.2473C96.2158 105.119 95.3796 105.955 95.3796 106.987C95.3796 108.018 96.2158 108.855 97.2473 108.855H115.924C116.956 108.855 117.792 108.018 117.792 106.987C117.792 105.955 116.956 105.119 115.924 105.119Z"/><path fill="#BDBDBD" d="M130.332 125.931H97.2473C96.2158 125.931 95.3796 126.767 95.3796 127.798C95.3796 128.83 96.2158 129.666 97.2473 129.666H130.332C131.363 129.666 132.2 128.83 132.2 127.798C132.2 126.767 131.363 125.931 130.332 125.931Z"/><path fill="#BDBDBD" d="M145.273 146.742H97.2473C96.2158 146.742 95.3796 147.578 95.3796 148.61C95.3796 149.641 96.2158 150.477 97.2473 150.477H145.273C146.305 150.477 147.141 149.641 147.141 148.61C147.141 147.578 146.305 146.742 145.273 146.742Z"/><path fill="#D9D9D9" d="M217.313 21.8742H171.955C170.923 21.8742 170.087 22.7104 170.087 23.7419C170.087 24.7734 170.923 25.6095 171.955 25.6095H217.313C218.344 25.6095 219.18 24.7734 219.18 23.7419C219.18 22.7104 218.344 21.8742 217.313 21.8742Z"/><path fill="#BDBDBD" d="M201.304 42.6855H171.955C170.923 42.6855 170.087 43.5217 170.087 44.5531C170.087 45.5846 170.923 46.4208 171.955 46.4208H201.304C202.335 46.4208 203.172 45.5846 203.172 44.5531C203.172 43.5217 202.335 42.6855 201.304 42.6855Z"/><path fill="#BDBDBD" d="M179.425 63.4967H171.955C170.923 63.4967 170.087 64.3329 170.087 65.3644C170.087 66.3959 170.923 67.2321 171.955 67.2321H179.425C180.457 67.2321 181.293 66.3959 181.293 65.3644C181.293 64.3329 180.457 63.4967 179.425 63.4967Z"/><path fill="#BDBDBD" d="M189.031 84.308H171.955C170.923 84.308 170.087 85.1442 170.087 86.1757C170.087 87.2072 170.923 88.0434 171.955 88.0434H189.031C190.062 88.0434 190.898 87.2072 190.898 86.1757C190.898 85.1442 190.062 84.308 189.031 84.308Z"/><path fill="#BDBDBD" d="M227.985 105.119H171.955C170.923 105.119 170.087 105.955 170.087 106.987C170.087 108.018 170.923 108.855 171.955 108.855H227.985C229.016 108.855 229.853 108.018 229.853 106.987C229.853 105.955 229.016 105.119 227.985 105.119Z"/><path fill="#BDBDBD" d="M202.905 125.931H171.955C170.923 125.931 170.087 126.767 170.087 127.798C170.087 128.83 170.923 129.666 171.955 129.666H202.905C203.936 129.666 204.772 128.83 204.772 127.798C204.772 126.767 203.936 125.931 202.905 125.931Z"/><path fill="#BDBDBD" d="M184.228 146.742H171.955C170.923 146.742 170.087 147.578 170.087 148.61C170.087 149.641 170.923 150.477 171.955 150.477H184.228C185.259 150.477 186.096 149.641 186.096 148.61C186.096 147.578 185.259 146.742 184.228 146.742Z"/><path stroke="#EEE" d="M18.5381 33.8807H247.462"/><path stroke="#EEE" d="M18.5381 54.692H247.462"/><path stroke="#EEE" d="M18.5381 75.5032H247.462"/><path stroke="#EEE" d="M18.5381 96.3145H247.462"/><path stroke="#EEE" d="M18.5381 117.126H247.462"/><path stroke="#EEE" d="M18.5381 137.937H247.462"/></g><defs><filter id="filter0_d" width="270" height="176.616" x="0" y="0" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dx="2" dy="4"/><feGaussianBlur stdDeviation="6"/><feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="BackgroundImageFix" mode="normal" result="effect1_dropShadow"/><feBlend in="SourceGraphic" in2="effect1_dropShadow" mode="normal" result="shape"/></filter></defs></svg>
\ No newline at end of file
+<svg width="693" height="425" viewBox="0 0 693 425" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M40.4387 110.977C27.1556 113.452 18.3941 126.227 20.8693 139.51C23.3445 152.793 36.1192 161.555 49.4023 159.079L67.7036 155.669C62.6078 161.153 60.0854 168.896 61.562 176.82C64.0372 190.103 76.8118 198.865 90.0949 196.39L220.39 172.11C220.416 172.267 220.444 172.425 220.473 172.582C221.95 180.507 227.092 186.822 233.821 190.102L225.826 191.592C212.542 194.067 203.781 206.841 206.256 220.125C208.731 233.408 221.506 242.169 234.789 239.694L614.544 168.929C627.827 166.454 636.588 153.679 634.113 140.396C632.636 132.472 627.494 126.157 620.765 122.877L633.556 120.493C646.839 118.018 655.601 105.244 653.126 91.9604C650.65 78.6773 637.876 69.9158 624.593 72.3911L396.82 114.835C396.794 114.678 396.766 114.52 396.737 114.363C395.26 106.438 390.118 100.123 383.389 96.8431L405.503 92.7224C418.786 90.2471 427.547 77.4725 425.072 64.1894C422.597 50.9063 409.822 42.1448 396.539 44.62L40.4387 110.977ZM59.718 301.107C57.2428 287.824 66.0043 275.05 79.2874 272.574L468.975 199.959C482.258 197.484 495.032 206.245 497.508 219.528C499.983 232.811 491.221 245.586 477.938 248.061L466.779 250.141C468.082 250.776 469.325 251.524 470.493 252.376L605.53 227.213C618.813 224.738 631.588 233.499 634.063 246.782C635.54 254.707 633.017 262.45 627.922 267.934L630.641 267.427C643.924 264.952 656.699 273.713 659.174 286.996C661.649 300.279 652.888 313.054 639.604 315.529L234.809 390.96C221.526 393.435 208.751 384.674 206.276 371.391C203.801 358.108 212.563 345.333 225.846 342.858L255.404 337.35C254.101 336.715 252.858 335.966 251.69 335.114L71.5053 368.69C58.2222 371.165 45.4476 362.404 42.9723 349.121C40.4971 335.838 49.2586 323.063 62.5417 320.588L73.0655 318.627C66.3367 315.347 61.1946 309.032 59.718 301.107Z" fill="black" fill-opacity="0.05"/>
+<g filter="url(#filter0_d)">
+<rect x="122" y="70" width="461" height="286" rx="10" fill="#F8F8F8"/>
+<rect x="150" y="96" width="55" height="7" rx="3.5" fill="#D9D9D9"/>
+<rect x="150" y="135" width="42" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="150" y="174" width="65" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="150" y="213" width="60" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="150" y="252" width="84" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="150" y="291" width="42" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="150" y="330" width="65" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="282" y="96" width="35" height="7" rx="3.5" fill="#D9D9D9"/>
+<rect x="282" y="135" width="102" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="282" y="174" width="77" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="282" y="213" width="93" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="282" y="252" width="42" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="282" y="291" width="69" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="282" y="330" width="97" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="422" y="96" width="92" height="7" rx="3.5" fill="#D9D9D9"/>
+<rect x="422" y="135" width="62" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="422" y="174" width="21" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="422" y="213" width="39" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="422" y="252" width="112" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="422" y="291" width="65" height="7" rx="3.5" fill="#BDBDBD"/>
+<rect x="422" y="330" width="30" height="7" rx="3.5" fill="#BDBDBD"/>
+<line x1="138" y1="118.5" x2="567" y2="118.5" stroke="#EEEEEE"/>
+<line x1="138" y1="157.5" x2="567" y2="157.5" stroke="#EEEEEE"/>
+<line x1="138" y1="196.5" x2="567" y2="196.5" stroke="#EEEEEE"/>
+<line x1="138" y1="235.5" x2="567" y2="235.5" stroke="#EEEEEE"/>
+<line x1="138" y1="274.5" x2="567" y2="274.5" stroke="#EEEEEE"/>
+<line x1="138" y1="313.5" x2="567" y2="313.5" stroke="#EEEEEE"/>
+</g>
+<defs>
+<filter id="filter0_d" x="112" y="62" width="485" height="310" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset dx="2" dy="4"/>
+<feGaussianBlur stdDeviation="6"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
+<feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+</defs>
+</svg>
diff --git a/packages/core/src/components/EmptyState/assets/noInformation.svg b/packages/core/src/components/EmptyState/assets/noInformation.svg
index 9a1c230e97..a36ce59d32 100644
--- a/packages/core/src/components/EmptyState/assets/noInformation.svg
+++ b/packages/core/src/components/EmptyState/assets/noInformation.svg
@@ -1 +1,10 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="267" height="172" fill="none" viewBox="0 0 267 172"><g filter="url(#filter0_d)"><rect width="139" height="104.906" x="10" y="50.165" fill="#EEE" rx="5"/></g><mask id="mask0" width="121" height="98" x="19" y="58" mask-type="alpha" maskUnits="userSpaceOnUse"><rect width="9.179" height="70.156" x="19.835" y="85.571" fill="#fff" rx="4.59"/><rect width="9.179" height="78.679" x="38.194" y="77.047" fill="#fff" rx="4.59"/><rect width="9.179" height="97.693" x="56.552" y="58.033" fill="#fff" rx="4.59"/><rect width="9.179" height="81.957" x="74.91" y="73.769" fill="#fff" rx="4.59"/><rect width="9.179" height="60.321" x="93.269" y="95.406" fill="#fff" rx="4.59"/><rect width="9.179" height="74.09" x="111.627" y="81.637" fill="#fff" rx="4.59"/><rect width="9.179" height="93.104" x="129.986" y="62.623" fill="#fff" rx="4.59"/></mask><g mask="url(#mask0)"><rect width="139" height="100.316" x="10.656" y="50.165" fill="#C4C4C4"/></g><g filter="url(#filter1_d)"><rect width="144" height="108.679" x="109" y="8" fill="#EEE" rx="5"/></g><path fill="#D9D9D9" d="M173.85 62.1192C144.607 37.3215 129.993 65.1991 120.077 80.5984V106.585H241.923V25.7384C208.172 24.5834 212.569 94.9538 173.85 62.1192Z"/><path stroke="#9E9E9E" stroke-linecap="round" stroke-linejoin="round" d="M120.077 80.5984C129.993 65.1991 144.607 37.3215 173.85 62.1192C212.569 94.9539 208.172 24.5834 241.923 25.7384"/><defs><filter id="filter0_d" width="163" height="128.906" x="0" y="42.165" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dx="2" dy="4"/><feGaussianBlur stdDeviation="6"/><feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="BackgroundImageFix" mode="normal" result="effect1_dropShadow"/><feBlend in="SourceGraphic" in2="effect1_dropShadow" mode="normal" result="shape"/></filter><filter id="filter1_d" width="168" height="132.679" x="99" y="0" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dx="2" dy="4"/><feGaussianBlur stdDeviation="6"/><feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="BackgroundImageFix" mode="normal" result="effect1_dropShadow"/><feBlend in="SourceGraphic" in2="effect1_dropShadow" mode="normal" result="shape"/></filter></defs></svg>
\ No newline at end of file
+<svg width="677" height="503" viewBox="0 0 677 503" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M52.0998 178.88C39.4837 181.231 31.1621 193.364 33.513 205.98C35.864 218.596 47.9972 226.918 60.6133 224.567L77.9953 221.328C73.1555 226.536 70.7597 233.89 72.1622 241.417C74.5131 254.033 86.6463 262.354 99.2624 260.003L223.015 236.943C223.026 237.007 223.037 237.072 223.048 237.136C223.063 237.221 223.078 237.306 223.094 237.392C224.497 244.918 229.381 250.916 235.772 254.031L228.178 255.446C215.562 257.797 207.24 269.931 209.591 282.547C211.942 295.163 224.075 303.484 236.691 301.133L597.377 233.922C609.993 231.571 618.315 219.438 615.964 206.822C614.561 199.295 609.677 193.298 603.287 190.182L615.435 187.918C628.051 185.567 636.373 173.434 634.022 160.818C631.671 148.202 619.537 139.88 606.921 142.231L390.586 182.544C390.561 182.395 390.535 182.245 390.507 182.095C389.104 174.569 384.22 168.571 377.829 165.456L398.833 161.542C411.449 159.191 419.77 147.058 417.42 134.442C415.069 121.825 402.935 113.504 390.319 115.855L52.0998 178.88ZM70.4109 359.463C68.06 346.847 76.3816 334.714 88.9977 332.363L459.118 263.393C471.734 261.043 483.867 269.364 486.218 281.98C488.569 294.596 480.247 306.73 467.631 309.08L457.032 311.055C458.269 311.659 459.45 312.37 460.56 313.179L588.816 289.279C601.432 286.928 613.565 295.25 615.916 307.866C617.319 315.392 614.923 322.747 610.083 327.955L612.666 327.474C625.282 325.123 637.415 333.444 639.766 346.061C642.117 358.677 633.796 370.81 621.18 373.161L236.71 444.804C224.094 447.155 211.961 438.833 209.61 426.217C207.259 413.601 215.581 401.468 228.197 399.117L256.271 393.886C255.034 393.283 253.853 392.571 252.743 391.762L81.6065 423.652C68.9904 426.003 56.8571 417.682 54.5062 405.066C52.1553 392.45 60.4769 380.316 73.093 377.965L83.0883 376.103C76.6973 372.987 71.8134 366.989 70.4109 359.463Z" fill="black" fill-opacity="0.05"/>
+<rect x="91.6917" y="95.4753" width="488" height="313" fill="url(#pattern0)"/>
+<defs>
+<pattern id="pattern0" patternContentUnits="objectBoundingBox" width="1" height="1">
+<use xlink:href="#image0" transform="translate(0 -0.000237323) scale(0.00124844 0.00194645)"/>
+</pattern>
+<image id="image0" width="801" height="514" xlink:href="data:image/png;base64,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"/>
+</defs>
+</svg>

From a385c27eeb8bf9befafcb3880b40a86f35686f4d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stefan=20=C3=85lund?= <alund@spotify.com>
Date: Tue, 6 Oct 2020 15:35:29 +0200
Subject: [PATCH 055/110] rm background

---
 packages/core/src/components/EmptyState/EmptyState.tsx        | 1 -
 packages/core/src/components/EmptyState/assets/Background.svg | 1 -
 2 files changed, 2 deletions(-)
 delete mode 100644 packages/core/src/components/EmptyState/assets/Background.svg

diff --git a/packages/core/src/components/EmptyState/EmptyState.tsx b/packages/core/src/components/EmptyState/EmptyState.tsx
index 3a56fc6cb3..523f4b467d 100644
--- a/packages/core/src/components/EmptyState/EmptyState.tsx
+++ b/packages/core/src/components/EmptyState/EmptyState.tsx
@@ -17,7 +17,6 @@
 import React from 'react';
 import { makeStyles, Typography, Grid } from '@material-ui/core';
 import { EmptyStateImage } from './EmptyStateImage';
-import Background from './assets/Background.svg';
 
 const useStyles = makeStyles(theme => ({
   root: {
diff --git a/packages/core/src/components/EmptyState/assets/Background.svg b/packages/core/src/components/EmptyState/assets/Background.svg
deleted file mode 100644
index ce9aae6739..0000000000
--- a/packages/core/src/components/EmptyState/assets/Background.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="641" height="393" fill="none" viewBox="0 0 641 393"><rect width="380.051" height="45.228" x="15.148" y="106.723" fill="#EEE" rx="22.614" transform="rotate(-10.5556 15.1477 106.723)"/><rect width="315.147" height="45.228" x="52.761" y="141.21" fill="#EEE" rx="22.614" transform="rotate(-10.5556 52.761 141.21)"/><rect width="411.631" height="45.228" x="51.057" y="256.093" fill="#EEE" rx="22.614" transform="rotate(-10.5556 51.0568 256.093)"/><rect width="411.033" height="45.228" x="35.578" y="300.474" fill="#EEE" rx="22.614" transform="rotate(-10.5556 35.5782 300.474)"/><rect width="406.8" height="45.228" x="199.649" y="137.293" fill="#EEE" rx="22.614" transform="rotate(-10.5556 199.649 137.293)"/><rect width="402.291" height="45.228" x="186.507" y="181.238" fill="#EEE" rx="22.614" transform="rotate(-10.5556 186.507 181.238)"/><rect width="368.583" height="45.228" x="219.599" y="273.399" fill="#EEE" rx="22.614" transform="rotate(-10.5556 219.599 273.399)"/><rect width="425.836" height="45.228" x="186.526" y="321.058" fill="#EEE" rx="22.614" transform="rotate(-10.5556 186.526 321.058)"/></svg>
\ No newline at end of file

From 7db0ffb6e5c4217ecbcc2cc586e7ee8685cbbd7a Mon Sep 17 00:00:00 2001
From: Marvin9 <marvinduff97@gmail.com>
Date: Tue, 6 Oct 2020 21:19:31 +0530
Subject: [PATCH 056/110] feat: add rel to <a> & few <Link> tags

---
 .../core/src/layout/ErrorPage/ErrorPage.tsx   |  7 ++++++-
 .../reader/components/TechDocsPageHeader.tsx  |  6 +++++-
 .../components/WelcomePage/WelcomePage.tsx    | 20 +++++++++++++++----
 3 files changed, 27 insertions(+), 6 deletions(-)

diff --git a/packages/core/src/layout/ErrorPage/ErrorPage.tsx b/packages/core/src/layout/ErrorPage/ErrorPage.tsx
index 71a24652ba..3d80955cc9 100644
--- a/packages/core/src/layout/ErrorPage/ErrorPage.tsx
+++ b/packages/core/src/layout/ErrorPage/ErrorPage.tsx
@@ -65,7 +65,12 @@ export const ErrorPage = ({
             Go back
           </Link>
           ... or if you think this is a bug, please file an{' '}
-          <Link href="https://github.com/spotify/backstage/issues">issue.</Link>
+          <Link
+            href="https://github.com/spotify/backstage/issues"
+            rel="noopener noreferrer"
+          >
+            issue.
+          </Link>
         </Typography>
       </Grid>
     </Grid>
diff --git a/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx b/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx
index b01ace4994..8084378ca1 100644
--- a/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx
+++ b/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx
@@ -66,7 +66,11 @@ export const TechDocsPageHeader = ({
         <HeaderLabel
           label=""
           value={
-            <a href={locationMetadata.target} target="_blank">
+            <a
+              href={locationMetadata.target}
+              target="_blank"
+              rel="noopener noreferrer"
+            >
               <GitHubIcon style={{ marginTop: '-25px', fill: '#fff' }} />
             </a>
           }
diff --git a/plugins/welcome/src/components/WelcomePage/WelcomePage.tsx b/plugins/welcome/src/components/WelcomePage/WelcomePage.tsx
index 3ceb0af58d..1afdb53ad4 100644
--- a/plugins/welcome/src/components/WelcomePage/WelcomePage.tsx
+++ b/plugins/welcome/src/components/WelcomePage/WelcomePage.tsx
@@ -69,7 +69,10 @@ const WelcomePage = () => {
                   the project and we have already begun work on various aspects
                   of these phases. The best way to keep track of the progress is
                   through the&nbsp;
-                  <Link href="https://github.com/spotify/backstage/milestones">
+                  <Link
+                    href="https://github.com/spotify/backstage/milestones"
+                    rel="noopener noreferrer"
+                  >
                     Milestones
                   </Link>
                   .
@@ -113,7 +116,10 @@ const WelcomePage = () => {
               </Typography>
               <Typography variant="body1" paragraph>
                 We suggest you either check out the documentation for{' '}
-                <Link href="https://github.com/spotify/backstage/blob/master/docs/plugins/create-a-plugin.md">
+                <Link
+                  href="https://github.com/spotify/backstage/blob/master/docs/plugins/create-a-plugin.md"
+                  rel="noopener noreferrer"
+                >
                   creating a plugin
                 </Link>{' '}
                 or have a look in the code for the{' '}
@@ -121,7 +127,10 @@ const WelcomePage = () => {
                   existing plugins
                 </Link>{' '}
                 in the directory{' '}
-                <Link href="https://github.com/spotify/backstage/tree/master/plugins">
+                <Link
+                  href="https://github.com/spotify/backstage/tree/master/plugins"
+                  rel="noopener noreferrer"
+                >
                   <code>plugins/</code>
                 </Link>
                 .
@@ -135,7 +144,10 @@ const WelcomePage = () => {
                   <Link href="https://backstage.io">backstage.io</Link>
                 </ListItem>
                 <ListItem>
-                  <Link href="https://github.com/spotify/backstage/blob/master/docs/plugins/create-a-plugin.md">
+                  <Link
+                    href="https://github.com/spotify/backstage/blob/master/docs/plugins/create-a-plugin.md"
+                    rel="noopener noreferrer"
+                  >
                     Create a plugin
                   </Link>
                 </ListItem>

From 5aeb0024b90f4d99b3867c19f2b3c3e45e535814 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20Adel=C3=B6w?= <freben@gmail.com>
Date: Tue, 6 Oct 2020 19:40:34 +0200
Subject: [PATCH 057/110] feat(catalog-backend): temporary named test db
 support to aid in debugging

Fully aware that this isn't pretty. But since I am in the process of debugging migrations and catalog stuff and want to easily run manually against several databases while waiting for proper testcontainers and e2e tests, this at least lets me gain some confidence short term.
---
 .../src/database/CommonDatabase.test.ts       | 40 ++++++++++---------
 .../src/database/DatabaseManager.ts           | 28 ++++++++++++-
 2 files changed, 47 insertions(+), 21 deletions(-)

diff --git a/plugins/catalog-backend/src/database/CommonDatabase.test.ts b/plugins/catalog-backend/src/database/CommonDatabase.test.ts
index 8a42b39cc5..2bacec4026 100644
--- a/plugins/catalog-backend/src/database/CommonDatabase.test.ts
+++ b/plugins/catalog-backend/src/database/CommonDatabase.test.ts
@@ -124,7 +124,7 @@ describe('CommonDatabase', () => {
         {
           ...output,
           status: DatabaseLocationUpdateLogStatus.FAIL,
-          timestamp: expect.any(String),
+          timestamp: expect.anything(),
         },
       ]),
     );
@@ -191,24 +191,26 @@ describe('CommonDatabase', () => {
       const result = await db.locationHistory(
         'dd12620d-0436-422f-93bd-929aa0788123',
       );
-      expect(result).toEqual([
-        {
-          created_at: expect.anything(),
-          entity_name: null,
-          id: expect.anything(),
-          location_id: 'dd12620d-0436-422f-93bd-929aa0788123',
-          message: null,
-          status: DatabaseLocationUpdateLogStatus.SUCCESS,
-        },
-        {
-          created_at: expect.anything(),
-          entity_name: null,
-          id: expect.anything(),
-          location_id: 'dd12620d-0436-422f-93bd-929aa0788123',
-          message: 'Something went wrong',
-          status: DatabaseLocationUpdateLogStatus.FAIL,
-        },
-      ]);
+      expect(result).toEqual(
+        expect.arrayContaining([
+          {
+            created_at: expect.anything(),
+            entity_name: null,
+            id: expect.anything(),
+            location_id: 'dd12620d-0436-422f-93bd-929aa0788123',
+            message: null,
+            status: DatabaseLocationUpdateLogStatus.SUCCESS,
+          },
+          {
+            created_at: expect.anything(),
+            entity_name: null,
+            id: expect.anything(),
+            location_id: 'dd12620d-0436-422f-93bd-929aa0788123',
+            message: 'Something went wrong',
+            status: DatabaseLocationUpdateLogStatus.FAIL,
+          },
+        ]),
+      );
     });
   });
 
diff --git a/plugins/catalog-backend/src/database/DatabaseManager.ts b/plugins/catalog-backend/src/database/DatabaseManager.ts
index afff254097..eb307c9478 100644
--- a/plugins/catalog-backend/src/database/DatabaseManager.ts
+++ b/plugins/catalog-backend/src/database/DatabaseManager.ts
@@ -19,6 +19,7 @@ import Knex from 'knex';
 import { Logger } from 'winston';
 import { CommonDatabase } from './CommonDatabase';
 import { Database } from './types';
+import { v4 as uuidv4 } from 'uuid';
 
 const migrationsDir = resolvePackagePath(
   '@backstage/plugin-catalog-backend',
@@ -60,17 +61,40 @@ export class DatabaseManager {
   }
 
   public static async createTestDatabase(): Promise<Database> {
-    const knex = Knex({
+    const config: Knex.Config<any> = {
+      /*
+      client: 'pg',
+      connection: {
+        host: 'localhost',
+        user: 'postgres',
+        password: 'postgres',
+      },
+      */
       client: 'sqlite3',
       connection: ':memory:',
       useNullAsDefault: true,
-    });
+    };
+
+    let knex = Knex(config);
+    if (typeof config.connection !== 'string') {
+      const tempDbName = `d${uuidv4().replace(/-/g, '')}`;
+      await knex.raw(`CREATE DATABASE ${tempDbName};`);
+      knex = Knex({
+        ...config,
+        connection: {
+          ...config.connection,
+          database: tempDbName,
+        },
+      });
+    }
+
     knex.client.pool.on('createSuccess', (_eventId: any, resource: any) => {
       resource.run('PRAGMA foreign_keys = ON', () => {});
     });
     await knex.migrate.latest({
       directory: migrationsDir,
     });
+
     const { logger } = defaultOptions;
     return new CommonDatabase(knex, logger);
   }

From a9e7685a48decd1e82278e7514d12cbbf2d487c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20Adel=C3=B6w?= <freben@gmail.com>
Date: Tue, 6 Oct 2020 16:31:23 +0200
Subject: [PATCH 058/110] feat(catalog-backend): store entity json in data
 column, not separate metadata+spec

part of #2749
---
 .../20201006130744_entity_data_column.js      | 79 +++++++++++++++++++
 .../src/database/CommonDatabase.ts            | 30 +++----
 plugins/catalog-backend/src/database/types.ts |  3 +-
 .../src/ingestion/HigherOrderOperations.ts    |  2 +-
 .../ingestion/processors/ldap/constants.ts    |  6 +-
 5 files changed, 94 insertions(+), 26 deletions(-)
 create mode 100644 plugins/catalog-backend/migrations/20201006130744_entity_data_column.js

diff --git a/plugins/catalog-backend/migrations/20201006130744_entity_data_column.js b/plugins/catalog-backend/migrations/20201006130744_entity_data_column.js
new file mode 100644
index 0000000000..fdabf72fce
--- /dev/null
+++ b/plugins/catalog-backend/migrations/20201006130744_entity_data_column.js
@@ -0,0 +1,79 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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.
+ */
+
+// @ts-check
+
+/**
+ * @param {import('knex')} knex
+ */
+exports.up = async function up(knex) {
+  await knex.schema.alterTable('entities', table => {
+    table
+      .text('data')
+      .nullable()
+      .comment('The entire JSON data blob of the entity');
+  });
+
+  await knex('entities').update({
+    // apiVersion and kind should not contain any JSON unsafe chars, and both
+    // metadata and spec are already valid serialized JSON
+    data: knex.raw(
+      `'{"apiVersion":"' || api_version || '","kind":"' || kind || '","metadata":' || metadata || COALESCE(',"spec":' || spec, '') || '}'`,
+    ),
+  });
+
+  await knex.schema.alterTable('entities', table => {
+    table.dropColumn('metadata');
+    table.dropColumn('spec');
+  });
+
+  // SQLite does not support ALTER COLUMN. Note that we do not use the try/
+  // catch method as in other migrations, because if the transaction is
+  // partially failed, it will further mess up the already messed-up
+  // statement below this.
+  if (knex.client.config.client !== 'sqlite3') {
+    await knex.schema.alterTable('entities', table => {
+      table.text('data').notNullable().alter();
+    });
+  }
+
+  // NOTE(freben): For some reason, specifically sqlite3 in-mem just drops some
+  // subset of constraints sometimes, when a table column is dropped - even if
+  // the column had no relation at all to the constraint. We therefore recreate
+  // the constraint here as a stupid fix.
+  if (knex.client.config.client === 'sqlite3') {
+    await knex.schema.alterTable('entities', table => {
+      table.unique(['full_name'], 'entities_unique_full_name');
+    });
+  }
+};
+
+/**
+ * @param {import('knex')} knex
+ */
+exports.down = async function down(knex) {
+  await knex.schema.alterTable('entities', table => {
+    table
+      .text('metadata')
+      .notNullable()
+      .comment('The entire metadata JSON blob of the entity');
+    table
+      .text('spec')
+      .nullable()
+      .comment('The entire spec JSON blob of the entity');
+    table.dropColumn('data');
+  });
+};
diff --git a/plugins/catalog-backend/src/database/CommonDatabase.ts b/plugins/catalog-backend/src/database/CommonDatabase.ts
index 5327384593..628b9dfb97 100644
--- a/plugins/catalog-backend/src/database/CommonDatabase.ts
+++ b/plugins/catalog-backend/src/database/CommonDatabase.ts
@@ -21,7 +21,6 @@ import {
 } from '@backstage/backend-common';
 import {
   Entity,
-  EntityMeta,
   EntityName,
   ENTITY_DEFAULT_NAMESPACE,
   ENTITY_META_GENERATED_FIELDS,
@@ -389,6 +388,11 @@ export class CommonDatabase implements Database {
     ).toLowerCase();
     const lowerName = entity.metadata.name.toLowerCase();
 
+    const data = {
+      ...entity,
+      metadata: lodash.omit(entity.metadata, ...ENTITY_META_GENERATED_FIELDS),
+    };
+
     return {
       id: entity.metadata.uid!,
       location_id: locationId || null,
@@ -399,29 +403,15 @@ export class CommonDatabase implements Database {
       kind: entity.kind,
       name: entity.metadata.name,
       namespace: entity.metadata.namespace || ENTITY_DEFAULT_NAMESPACE,
-      metadata: JSON.stringify(
-        lodash.omit(entity.metadata, ...ENTITY_META_GENERATED_FIELDS),
-      ),
-      spec: entity.spec ? JSON.stringify(entity.spec) : null,
+      data: JSON.stringify(data),
     };
   }
 
   private toEntityResponse(row: DbEntitiesRow): DbEntityResponse {
-    const entity: Entity = {
-      apiVersion: row.api_version,
-      kind: row.kind,
-      metadata: {
-        ...(JSON.parse(row.metadata) as EntityMeta),
-        uid: row.id,
-        etag: row.etag,
-        generation: Number(row.generation), // cast because of sqlite
-      },
-    };
-
-    if (row.spec) {
-      const spec = JSON.parse(row.spec);
-      entity.spec = spec;
-    }
+    const entity = JSON.parse(row.data) as Entity;
+    entity.metadata.uid = row.id;
+    entity.metadata.etag = row.etag;
+    entity.metadata.generation = Number(row.generation); // cast due to sqlite
 
     return {
       locationId: row.location_id || undefined,
diff --git a/plugins/catalog-backend/src/database/types.ts b/plugins/catalog-backend/src/database/types.ts
index c0f5777743..162bc3507f 100644
--- a/plugins/catalog-backend/src/database/types.ts
+++ b/plugins/catalog-backend/src/database/types.ts
@@ -26,8 +26,7 @@ export type DbEntitiesRow = {
   etag: string;
   generation: number;
   full_name: string;
-  metadata: string;
-  spec: string | null;
+  data: string;
 };
 
 export type DbEntityRequest = {
diff --git a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
index 571602b966..7232b876c7 100644
--- a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
+++ b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
@@ -197,7 +197,7 @@ export class HigherOrderOperations implements HigherOrderOperation {
     }
 
     const delta = process.hrtime(startTimestamp);
-    const durationMs = ((delta[0] * 1e9 + delta[1]) / 1e6).toFixed(1);
+    const durationMs = ((delta[0] * 1e9 + delta[1]) / 1e9).toFixed(1);
     this.logger.info(
       `Wrote ${readerOutput.entities.length} entities from location ${location.type} ${location.target} in ${durationMs} seconds`,
     );
diff --git a/plugins/catalog-backend/src/ingestion/processors/ldap/constants.ts b/plugins/catalog-backend/src/ingestion/processors/ldap/constants.ts
index 3f32a34da4..507da37b39 100644
--- a/plugins/catalog-backend/src/ingestion/processors/ldap/constants.ts
+++ b/plugins/catalog-backend/src/ingestion/processors/ldap/constants.ts
@@ -21,7 +21,7 @@
  * The RDN is the name of the leftmost attribute that identifies the item; for
  * example, for an item with the fully qualified DN
  * uid=john,ou=people,ou=spotify,dc=spotify,dc=net the generated entity would
- * have this attribute, with the value "john".
+ * have this annotation, with the value "john".
  */
 export const LDAP_RDN_ANNOTATION = 'backstage.io/ldap-rdn';
 
@@ -31,7 +31,7 @@ export const LDAP_RDN_ANNOTATION = 'backstage.io/ldap-rdn';
  *
  * The DN is the fully qualified name that identifies the item; for example,
  * for an item with the DN uid=john,ou=people,ou=spotify,dc=spotify,dc=net the
- * generated entity would have this attribute, with that full string as its
+ * generated entity would have this annotation, with that full string as its
  * value.
  */
 export const LDAP_DN_ANNOTATION = 'backstage.io/ldap-dn';
@@ -42,7 +42,7 @@ export const LDAP_DN_ANNOTATION = 'backstage.io/ldap-dn';
  *
  * The UUID is the globally unique ID that identifies the item; for example,
  * for an item with the UUID 76ef928a-b251-1037-9840-d78227f36a7e, the
- * generated entity would have this attribute, with that full string as its
+ * generated entity would have this annotation, with that full string as its
  * value.
  */
 export const LDAP_UUID_ANNOTATION = 'backstage.io/ldap-uuid';

From c2e2d92000a32396cf835cf3148609933e189d77 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20Adel=C3=B6w?= <freben@gmail.com>
Date: Tue, 6 Oct 2020 20:53:44 +0200
Subject: [PATCH 059/110] feat(catalog-backend): remove redundant columns in
 entities

---
 ...6203131_entity_remove_redundant_columns.js | 60 +++++++++++++++++++
 .../src/database/CommonDatabase.ts            | 17 ++----
 plugins/catalog-backend/src/database/types.ts |  4 --
 3 files changed, 64 insertions(+), 17 deletions(-)
 create mode 100644 plugins/catalog-backend/migrations/20201006203131_entity_remove_redundant_columns.js

diff --git a/plugins/catalog-backend/migrations/20201006203131_entity_remove_redundant_columns.js b/plugins/catalog-backend/migrations/20201006203131_entity_remove_redundant_columns.js
new file mode 100644
index 0000000000..7bacc67338
--- /dev/null
+++ b/plugins/catalog-backend/migrations/20201006203131_entity_remove_redundant_columns.js
@@ -0,0 +1,60 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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.
+ */
+
+// @ts-check
+
+/**
+ * @param {import('knex')} knex
+ */
+exports.up = async function up(knex) {
+  await knex.schema.alterTable('entities', table => {
+    table.dropColumn('api_version');
+    table.dropColumn('kind');
+    table.dropColumn('name');
+    table.dropColumn('namespace');
+  });
+
+  // NOTE(freben): For some reason, specifically sqlite3 in-mem just drops some
+  // subset of constraints sometimes, when a table column is dropped - even if
+  // the column had no relation at all to the constraint. We therefore recreate
+  // the constraint here as a stupid fix.
+  if (knex.client.config.client === 'sqlite3') {
+    await knex.schema.alterTable('entities', table => {
+      table.unique(['full_name'], 'entities_unique_full_name');
+    });
+  }
+};
+
+/**
+ * @param {import('knex')} knex
+ */
+exports.down = async function down(knex) {
+  await knex.schema.alterTable('entities', table => {
+    table
+      .string('api_version')
+      .notNullable()
+      .comment('The apiVersion field of the entity');
+    table.string('kind').notNullable().comment('The kind field of the entity');
+    table
+      .string('name')
+      .nullable()
+      .comment('The metadata.name field of the entity');
+    table
+      .string('namespace')
+      .nullable()
+      .comment('The metadata.namespace field of the entity');
+  });
+};
diff --git a/plugins/catalog-backend/src/database/CommonDatabase.ts b/plugins/catalog-backend/src/database/CommonDatabase.ts
index 628b9dfb97..890a64781a 100644
--- a/plugins/catalog-backend/src/database/CommonDatabase.ts
+++ b/plugins/catalog-backend/src/database/CommonDatabase.ts
@@ -207,9 +207,7 @@ export class CommonDatabase implements Database {
 
     const rows = await builder
       .select('entities.*')
-      .orderBy('kind', 'asc')
-      .orderBy('namespace', 'asc')
-      .orderBy('name', 'asc')
+      .orderBy('full_name', 'asc')
       .groupBy('id');
 
     return rows.map(row => this.toEntityResponse(row));
@@ -222,12 +220,9 @@ export class CommonDatabase implements Database {
     const tx = txOpaque as Knex.Transaction<any, any>;
 
     const rows = await tx<DbEntitiesRow>('entities')
-      .whereRaw(
-        tx.raw(
-          'LOWER(kind) = LOWER(?) AND LOWER(namespace) = LOWER(?) AND LOWER(name) = LOWER(?)',
-          [name.kind, name.namespace, name.name],
-        ),
-      )
+      .where({
+        full_name: `${name.kind}:${name.namespace}/${name.name}`.toLowerCase(),
+      })
       .select();
 
     if (rows.length !== 1) {
@@ -399,10 +394,6 @@ export class CommonDatabase implements Database {
       etag: entity.metadata.etag!,
       generation: entity.metadata.generation!,
       full_name: `${lowerKind}:${lowerNamespace}/${lowerName}`,
-      api_version: entity.apiVersion,
-      kind: entity.kind,
-      name: entity.metadata.name,
-      namespace: entity.metadata.namespace || ENTITY_DEFAULT_NAMESPACE,
       data: JSON.stringify(data),
     };
   }
diff --git a/plugins/catalog-backend/src/database/types.ts b/plugins/catalog-backend/src/database/types.ts
index 162bc3507f..5a577f2223 100644
--- a/plugins/catalog-backend/src/database/types.ts
+++ b/plugins/catalog-backend/src/database/types.ts
@@ -19,10 +19,6 @@ import type { Entity, EntityName, Location } from '@backstage/catalog-model';
 export type DbEntitiesRow = {
   id: string;
   location_id: string | null;
-  api_version: string;
-  kind: string;
-  name: string | null;
-  namespace: string | null;
   etag: string;
   generation: number;
   full_name: string;

From e277c5dfa587134672ac3ba81351dee03deb8022 Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Thu, 1 Oct 2020 17:38:12 +0800
Subject: [PATCH 060/110] Expose types to handle Database management

This implements several types to own and manage databases on a database
server. The current SimpleDatabase* classes preserve the present
behaviour; future implementations can segregate databases to be owned by
different roles.
---
 .../src/database/SingleDatabase.ts            | 96 +++++++++++++++++++
 packages/backend-common/src/database/index.ts |  2 +
 .../backend-common/src/database/postgres.ts   |  3 +-
 packages/backend-common/src/database/types.ts | 59 ++++++++++++
 packages/backend/src/index.ts                 | 32 +++----
 packages/backend/src/plugins/catalog.ts       |  5 +-
 packages/backend/src/types.ts                 |  9 +-
 .../default-app/packages/backend/src/index.ts | 26 +++--
 plugins/auth-backend/src/service/router.ts    |  8 +-
 .../src/service/standaloneServer.ts           |  6 +-
 10 files changed, 203 insertions(+), 43 deletions(-)
 create mode 100644 packages/backend-common/src/database/SingleDatabase.ts
 create mode 100644 packages/backend-common/src/database/types.ts

diff --git a/packages/backend-common/src/database/SingleDatabase.ts b/packages/backend-common/src/database/SingleDatabase.ts
new file mode 100644
index 0000000000..b599232ee8
--- /dev/null
+++ b/packages/backend-common/src/database/SingleDatabase.ts
@@ -0,0 +1,96 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 Knex from 'knex';
+import { Config } from '@backstage/config';
+import { createDatabaseClient, ensureDatabaseExists } from './connection';
+import {
+  DatabaseConfiguration,
+  PluginDatabaseFactory,
+  PluginDatabaseManager,
+} from './types';
+
+export class SingleDatabaseConfiguration implements DatabaseConfiguration {
+  private readonly config: Config;
+
+  constructor(config: Config) {
+    this.config = config;
+  }
+
+  getDatabaseConfig(_pluginId: string): Config {
+    return this.config;
+  }
+
+  getAdminConfig(): Config {
+    return this.config;
+  }
+}
+
+export class SingleDatabaseManager implements PluginDatabaseManager {
+  private readonly config: DatabaseConfiguration;
+
+  constructor(config: DatabaseConfiguration) {
+    this.config = config;
+  }
+
+  getDatabaseFactory(pluginId: string): PluginDatabaseFactory {
+    // eslint-disable-next-line no-use-before-define
+    return new SinglePluginDatabaseFactory(this, pluginId);
+  }
+
+  async getDatabase(pluginId: string, suffix?: string): Promise<Knex> {
+    const config = this.config.getDatabaseConfig(pluginId);
+    const overrides = SingleDatabaseManager.getDatabaseOverrides(
+      pluginId,
+      suffix,
+    );
+    const overrideConfig = overrides.connection as Knex.ConnectionConfig;
+    await this.ensureDatabase(overrideConfig.database);
+
+    return createDatabaseClient(config, overrides);
+  }
+
+  private static getDatabaseOverrides(
+    pluginId: string,
+    suffix?: string,
+  ): Knex.Config {
+    const dbSuffix = suffix ? `_${suffix}` : '';
+    return {
+      connection: {
+        database: `backstage_plugin_${pluginId}${dbSuffix}`,
+      },
+    };
+  }
+
+  private async ensureDatabase(database: string) {
+    const config = this.config.getAdminConfig();
+    await ensureDatabaseExists(config, database);
+  }
+}
+
+export class SinglePluginDatabaseFactory implements PluginDatabaseFactory {
+  private manager: SingleDatabaseManager;
+  private readonly pluginId: string;
+
+  constructor(manager: SingleDatabaseManager, pluginId: string) {
+    this.manager = manager;
+    this.pluginId = pluginId;
+  }
+
+  getDatabase(database?: string): Promise<Knex> {
+    return this.manager.getDatabase(this.pluginId, database);
+  }
+}
diff --git a/packages/backend-common/src/database/index.ts b/packages/backend-common/src/database/index.ts
index 38d3d6224b..c667edc659 100644
--- a/packages/backend-common/src/database/index.ts
+++ b/packages/backend-common/src/database/index.ts
@@ -15,3 +15,5 @@
  */
 
 export * from './connection';
+export * from './types';
+export * from './SingleDatabase';
diff --git a/packages/backend-common/src/database/postgres.ts b/packages/backend-common/src/database/postgres.ts
index 82e971f081..9972377de8 100644
--- a/packages/backend-common/src/database/postgres.ts
+++ b/packages/backend-common/src/database/postgres.ts
@@ -15,6 +15,7 @@
  */
 
 import knex, { PgConnectionConfig } from 'knex';
+import { cloneDeep } from 'lodash';
 import { Config } from '@backstage/config';
 import { mergeDatabaseConfig } from './config';
 
@@ -44,7 +45,7 @@ export function buildPgDatabaseConfig(
   overrides?: knex.Config,
 ) {
   return mergeDatabaseConfig(
-    dbConfig.get(),
+    cloneDeep(dbConfig.get()),
     {
       connection: getPgConnectionConfig(dbConfig, !!overrides),
       useNullAsDefault: true,
diff --git a/packages/backend-common/src/database/types.ts b/packages/backend-common/src/database/types.ts
new file mode 100644
index 0000000000..00ee82f22a
--- /dev/null
+++ b/packages/backend-common/src/database/types.ts
@@ -0,0 +1,59 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 knex from 'knex';
+import { Config } from '@backstage/config';
+
+/**
+ * DatabaseConfiguration exposes the Application configuration to PluginDatabaseManager instances.
+ */
+export interface DatabaseConfiguration {
+  /**
+   * Returns the database configuration for the given Plugin.
+   */
+  getDatabaseConfig(pluginId: string): Config;
+
+  /**
+   * Returns the database configuration for administrating the database server.
+   */
+  getAdminConfig(): Config;
+}
+
+/**
+ * The PluginDatabaseManager produces PluginDatabaseFactory objects for plugins to consume and store their data.
+ */
+export type PluginDatabaseManager = {
+  /**
+   * getDatabaseFactory returns the database factory object for plugins to obtain database connections.
+   */
+  getDatabaseFactory(pluginId: string): PluginDatabaseFactory;
+};
+
+/**
+ * The PluginDatabaseFactory is used to provide a mechanism for backend plugins to obtain database connections for
+ * itself.
+ *
+ * The purpose of this factory is to allow plugins to get isolated data stores so that plugins are discouraged from database integration.
+ */
+export type PluginDatabaseFactory = {
+  /**
+   * Returns a database connection. Plugins can omit the `database` parameter to get the default plugin database, or
+   * provide an identifier that will be used to identify a separate database from the default.
+   *
+   * Plugins completely own and manage the state of the database (including schema/migrations/data.)
+   */
+  getDatabase(database?: String): Promise<knex>;
+};
diff --git a/packages/backend/src/index.ts b/packages/backend/src/index.ts
index 959af71427..192ceb95a2 100644
--- a/packages/backend/src/index.ts
+++ b/packages/backend/src/index.ts
@@ -24,17 +24,17 @@
 
 import Router from 'express-promise-router';
 import {
-  ensureDatabaseExists,
-  createDatabaseClient,
   createServiceBuilder,
   loadBackendConfig,
   getRootLogger,
   useHotMemoize,
   notFoundHandler,
+  SingleDatabaseConfiguration,
+  SingleDatabaseManager,
   SingleHostDiscovery,
   UrlReaders,
 } from '@backstage/backend-common';
-import { ConfigReader, AppConfig } from '@backstage/config';
+import { ConfigReader } from '@backstage/config';
 import healthcheck from './plugins/healthcheck';
 import auth from './plugins/auth';
 import catalog from './plugins/catalog';
@@ -48,37 +48,29 @@ import graphql from './plugins/graphql';
 import app from './plugins/app';
 import { PluginEnvironment } from './types';
 
-function makeCreateEnv(loadedConfigs: AppConfig[]) {
-  const config = ConfigReader.fromConfigs(loadedConfigs);
+function makeCreateEnv(config: ConfigReader) {
   const root = getRootLogger();
   const reader = UrlReaders.default({ logger: root, config });
   const discovery = SingleHostDiscovery.fromConfig(config);
 
   root.info(`Created UrlReader ${reader}`);
 
+  const databaseConfig = new SingleDatabaseConfiguration(
+    config.getConfig('backend.database'),
+  );
+  const databaseManager = new SingleDatabaseManager(databaseConfig);
+
   return (plugin: string): PluginEnvironment => {
     const logger = root.child({ type: 'plugin', plugin });
-    const database = createDatabaseClient(
-      config.getConfig('backend.database'),
-      {
-        connection: {
-          database: `backstage_plugin_${plugin}`,
-        },
-      },
-    );
-    return { logger, database, config, reader, discovery };
+    const databaseFactory = databaseManager.getDatabaseFactory(plugin);
+    return { logger, database: databaseFactory, config, reader, discovery };
   };
 }
 
 async function main() {
   const configs = await loadBackendConfig();
   const configReader = ConfigReader.fromConfigs(configs);
-  const createEnv = makeCreateEnv(configs);
-  await ensureDatabaseExists(
-    configReader.getConfig('backend.database'),
-    'backstage_plugin_catalog',
-    'backstage_plugin_auth',
-  );
+  const createEnv = makeCreateEnv(configReader);
 
   const healthcheckEnv = useHotMemoize(module, () => createEnv('healthcheck'));
   const catalogEnv = useHotMemoize(module, () => createEnv('catalog'));
diff --git a/packages/backend/src/plugins/catalog.ts b/packages/backend/src/plugins/catalog.ts
index c1d390f8cc..9ab2203ca2 100644
--- a/packages/backend/src/plugins/catalog.ts
+++ b/packages/backend/src/plugins/catalog.ts
@@ -34,7 +34,10 @@ export default async function createPlugin({
 }: PluginEnvironment) {
   const locationReader = new LocationReaders({ logger, reader, config });
 
-  const db = await DatabaseManager.createDatabase(database, { logger });
+  const db = await DatabaseManager.createDatabase(
+    await database.getDatabase(),
+    { logger },
+  );
   const entitiesCatalog = new DatabaseEntitiesCatalog(db);
   const locationsCatalog = new DatabaseLocationsCatalog(db);
   const higherOrderOperation = new HigherOrderOperations(
diff --git a/packages/backend/src/types.ts b/packages/backend/src/types.ts
index 9257fcc9cf..98797eddf9 100644
--- a/packages/backend/src/types.ts
+++ b/packages/backend/src/types.ts
@@ -14,14 +14,17 @@
  * limitations under the License.
  */
 
-import Knex from 'knex';
 import { Logger } from 'winston';
 import { Config } from '@backstage/config';
-import { PluginEndpointDiscovery, UrlReader } from '@backstage/backend-common';
+import {
+  PluginDatabaseFactory,
+  PluginEndpointDiscovery,
+  UrlReader
+} from '@backstage/backend-common';
 
 export type PluginEnvironment = {
   logger: Logger;
-  database: Knex;
+  database: PluginDatabaseFactory;
   config: Config;
   reader: UrlReader;
   discovery: PluginEndpointDiscovery;
diff --git a/packages/create-app/templates/default-app/packages/backend/src/index.ts b/packages/create-app/templates/default-app/packages/backend/src/index.ts
index 684db8aab8..437ef5afcd 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/index.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/index.ts
@@ -9,16 +9,17 @@
 import Router from 'express-promise-router';
 import {
   ensureDatabaseExists,
-  createDatabaseClient,
   createServiceBuilder,
   loadBackendConfig,
   getRootLogger,
   useHotMemoize,
   notFoundHandler,
+  SingleDatabaseConfiguration,
+  SingleDatabaseManager,
   SingleHostDiscovery,
   UrlReaders,
 } from '@backstage/backend-common';
-import { ConfigReader, AppConfig } from '@backstage/config';
+import { ConfigReader } from '@backstage/config';
 import auth from './plugins/auth';
 import catalog from './plugins/catalog';
 import scaffolder from './plugins/scaffolder';
@@ -26,32 +27,29 @@ import proxy from './plugins/proxy';
 import techdocs from './plugins/techdocs';
 import { PluginEnvironment } from './types';
 
-function makeCreateEnv(loadedConfigs: AppConfig[]) {
-  const config = ConfigReader.fromConfigs(loadedConfigs);
+function makeCreateEnv(config: ConfigReader) {
   const root = getRootLogger();
   const reader = UrlReaders.default({ logger: root, config });
   const discovery = SingleHostDiscovery.fromConfig(config);
 
   root.info(`Created UrlReader ${reader}`);
 
+  const databaseConfig = new SingleDatabaseConfiguration(
+    config.getConfig('backend.database'),
+  )
+  const databaseManager = new SingleDatabaseManager(databaseConfig);
+
   return (plugin: string): PluginEnvironment => {
     const logger = root.child({ type: 'plugin', plugin });
-    const database = createDatabaseClient(
-      config.getConfig('backend.database'),
-      {
-        connection: {
-          database: `backstage_plugin_${plugin}`,
-        },
-      },
-    );
-    return { logger, database, config, reader, discovery };
+    const databaseFactory = databaseManager.getDatabaseFactory(plugin);
+    return { logger, database: databaseFactory, config, reader, discovery };
   };
 }
 
 async function main() {
   const configs = await loadBackendConfig();
   const configReader = ConfigReader.fromConfigs(configs);
-  const createEnv = makeCreateEnv(configs);
+  const createEnv = makeCreateEnv(configReader);
   await ensureDatabaseExists(
     configReader.getConfig('backend.database'),
     'backstage_plugin_catalog',
diff --git a/plugins/auth-backend/src/service/router.ts b/plugins/auth-backend/src/service/router.ts
index bcd1fc1794..d514586ec9 100644
--- a/plugins/auth-backend/src/service/router.ts
+++ b/plugins/auth-backend/src/service/router.ts
@@ -17,7 +17,6 @@
 import express from 'express';
 import Router from 'express-promise-router';
 import cookieParser from 'cookie-parser';
-import Knex from 'knex';
 import { Logger } from 'winston';
 import { createAuthProvider } from '../providers';
 import { Config } from '@backstage/config';
@@ -25,11 +24,12 @@ import { DatabaseKeyStore, TokenFactory, createOidcRouter } from '../identity';
 import {
   NotFoundError,
   PluginEndpointDiscovery,
+  PluginDatabaseFactory,
 } from '@backstage/backend-common';
 
 export interface RouterOptions {
   logger: Logger;
-  database: Knex;
+  database: PluginDatabaseFactory;
   config: Config;
   discovery: PluginEndpointDiscovery;
 }
@@ -47,7 +47,9 @@ export async function createRouter({
 
   const keyDurationSeconds = 3600;
 
-  const keyStore = await DatabaseKeyStore.create({ database });
+  const keyStore = await DatabaseKeyStore.create({
+    database: await database.getDatabase(),
+  });
   const tokenIssuer = new TokenFactory({
     issuer: authUrl,
     keyStore,
diff --git a/plugins/auth-backend/src/service/standaloneServer.ts b/plugins/auth-backend/src/service/standaloneServer.ts
index 71771340a5..e51b959188 100644
--- a/plugins/auth-backend/src/service/standaloneServer.ts
+++ b/plugins/auth-backend/src/service/standaloneServer.ts
@@ -53,7 +53,11 @@ export async function startStandaloneServer(
   const router = await createRouter({
     logger,
     config,
-    database,
+    database: {
+      async getDatabase(_database?: string) {
+        return database;
+      },
+    },
     discovery,
   });
 

From 8c78b4e9dd78b7525372fe9584fa7e8db5e91b99 Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Fri, 2 Oct 2020 12:35:40 +0800
Subject: [PATCH 061/110] Fix review comments

- Combine the various exported types; the only API surface is now the
  `PluginDatabaseClientFactory` which is a free function.
- Rename to the SingleConnectionManager class.
- Refactor the PluginEnvironment type to use databaseClientFactory for
  clarity.
- Fix mergeDatabaseConfig to not override the input dictionary.
---
 ...{SingleDatabase.ts => SingleConnection.ts} | 56 +++++++------------
 .../backend-common/src/database/config.ts     |  2 +-
 packages/backend-common/src/database/index.ts |  2 +-
 .../backend-common/src/database/postgres.ts   |  3 +-
 packages/backend-common/src/database/types.ts | 44 ++-------------
 packages/backend/src/index.ts                 | 10 ++--
 packages/backend/src/plugins/auth.ts          |  9 ++-
 packages/backend/src/plugins/catalog.ts       |  4 +-
 packages/backend/src/types.ts                 |  4 +-
 .../default-app/packages/backend/src/index.ts | 26 ++++-----
 .../packages/backend/src/plugins/auth.ts      |  9 ++-
 .../packages/backend/src/plugins/catalog.ts   |  7 ++-
 .../default-app/packages/backend/src/types.ts |  9 ++-
 plugins/auth-backend/src/service/router.ts    |  6 +-
 .../src/service/standaloneServer.ts           |  6 +-
 15 files changed, 78 insertions(+), 119 deletions(-)
 rename packages/backend-common/src/database/{SingleDatabase.ts => SingleConnection.ts} (53%)

diff --git a/packages/backend-common/src/database/SingleDatabase.ts b/packages/backend-common/src/database/SingleConnection.ts
similarity index 53%
rename from packages/backend-common/src/database/SingleDatabase.ts
rename to packages/backend-common/src/database/SingleConnection.ts
index b599232ee8..8ed93166cf 100644
--- a/packages/backend-common/src/database/SingleDatabase.ts
+++ b/packages/backend-common/src/database/SingleConnection.ts
@@ -17,43 +17,39 @@
 import Knex from 'knex';
 import { Config } from '@backstage/config';
 import { createDatabaseClient, ensureDatabaseExists } from './connection';
-import {
-  DatabaseConfiguration,
-  PluginDatabaseFactory,
-  PluginDatabaseManager,
-} from './types';
+import { PluginDatabaseClientFactory } from './types';
 
-export class SingleDatabaseConfiguration implements DatabaseConfiguration {
+/**
+ * Implements a Database Manager which will automatically create new databases for plugins when requested. All
+ * requested databases are created with the credentials provided.
+ */
+export class SingleConnectionManager {
   private readonly config: Config;
 
   constructor(config: Config) {
     this.config = config;
   }
 
-  getDatabaseConfig(_pluginId: string): Config {
+  private getDatabaseConfig(): Config {
     return this.config;
   }
 
-  getAdminConfig(): Config {
+  private getAdminConfig(): Config {
     return this.config;
   }
-}
 
-export class SingleDatabaseManager implements PluginDatabaseManager {
-  private readonly config: DatabaseConfiguration;
-
-  constructor(config: DatabaseConfiguration) {
-    this.config = config;
+  /**
+   * Generates a PluginDatabaseClientFactory for consumption by plugins.
+   */
+  getDatabaseClientFactory(pluginId: string): PluginDatabaseClientFactory {
+    return (database?: string): Promise<Knex> => {
+      return this.getDatabase(pluginId, database);
+    };
   }
 
-  getDatabaseFactory(pluginId: string): PluginDatabaseFactory {
-    // eslint-disable-next-line no-use-before-define
-    return new SinglePluginDatabaseFactory(this, pluginId);
-  }
-
-  async getDatabase(pluginId: string, suffix?: string): Promise<Knex> {
-    const config = this.config.getDatabaseConfig(pluginId);
-    const overrides = SingleDatabaseManager.getDatabaseOverrides(
+  private async getDatabase(pluginId: string, suffix?: string): Promise<Knex> {
+    const config = this.getDatabaseConfig();
+    const overrides = SingleConnectionManager.getDatabaseOverrides(
       pluginId,
       suffix,
     );
@@ -76,21 +72,7 @@ export class SingleDatabaseManager implements PluginDatabaseManager {
   }
 
   private async ensureDatabase(database: string) {
-    const config = this.config.getAdminConfig();
+    const config = this.getAdminConfig();
     await ensureDatabaseExists(config, database);
   }
 }
-
-export class SinglePluginDatabaseFactory implements PluginDatabaseFactory {
-  private manager: SingleDatabaseManager;
-  private readonly pluginId: string;
-
-  constructor(manager: SingleDatabaseManager, pluginId: string) {
-    this.manager = manager;
-    this.pluginId = pluginId;
-  }
-
-  getDatabase(database?: string): Promise<Knex> {
-    return this.manager.getDatabase(this.pluginId, database);
-  }
-}
diff --git a/packages/backend-common/src/database/config.ts b/packages/backend-common/src/database/config.ts
index 80abc06aa2..a16cf6cbee 100644
--- a/packages/backend-common/src/database/config.ts
+++ b/packages/backend-common/src/database/config.ts
@@ -23,5 +23,5 @@ import { merge } from 'lodash';
  * @param overrides Any additional overrides
  */
 export function mergeDatabaseConfig(config: any, ...overrides: any[]) {
-  return merge(config, ...overrides);
+  return merge({}, config, ...overrides);
 }
diff --git a/packages/backend-common/src/database/index.ts b/packages/backend-common/src/database/index.ts
index c667edc659..c81153aa62 100644
--- a/packages/backend-common/src/database/index.ts
+++ b/packages/backend-common/src/database/index.ts
@@ -16,4 +16,4 @@
 
 export * from './connection';
 export * from './types';
-export * from './SingleDatabase';
+export * from './SingleConnection';
diff --git a/packages/backend-common/src/database/postgres.ts b/packages/backend-common/src/database/postgres.ts
index 9972377de8..82e971f081 100644
--- a/packages/backend-common/src/database/postgres.ts
+++ b/packages/backend-common/src/database/postgres.ts
@@ -15,7 +15,6 @@
  */
 
 import knex, { PgConnectionConfig } from 'knex';
-import { cloneDeep } from 'lodash';
 import { Config } from '@backstage/config';
 import { mergeDatabaseConfig } from './config';
 
@@ -45,7 +44,7 @@ export function buildPgDatabaseConfig(
   overrides?: knex.Config,
 ) {
   return mergeDatabaseConfig(
-    cloneDeep(dbConfig.get()),
+    dbConfig.get(),
     {
       connection: getPgConnectionConfig(dbConfig, !!overrides),
       useNullAsDefault: true,
diff --git a/packages/backend-common/src/database/types.ts b/packages/backend-common/src/database/types.ts
index 00ee82f22a..b616ca848a 100644
--- a/packages/backend-common/src/database/types.ts
+++ b/packages/backend-common/src/database/types.ts
@@ -15,45 +15,13 @@
  */
 
 import knex from 'knex';
-import { Config } from '@backstage/config';
 
 /**
- * DatabaseConfiguration exposes the Application configuration to PluginDatabaseManager instances.
- */
-export interface DatabaseConfiguration {
-  /**
-   * Returns the database configuration for the given Plugin.
-   */
-  getDatabaseConfig(pluginId: string): Config;
-
-  /**
-   * Returns the database configuration for administrating the database server.
-   */
-  getAdminConfig(): Config;
-}
-
-/**
- * The PluginDatabaseManager produces PluginDatabaseFactory objects for plugins to consume and store their data.
- */
-export type PluginDatabaseManager = {
-  /**
-   * getDatabaseFactory returns the database factory object for plugins to obtain database connections.
-   */
-  getDatabaseFactory(pluginId: string): PluginDatabaseFactory;
-};
-
-/**
- * The PluginDatabaseFactory is used to provide a mechanism for backend plugins to obtain database connections for
- * itself.
+ * The PluginDatabaseClientFactory is used to provide a mechanism for backend plugins to obtain database connections
+ * for itself.
  *
- * The purpose of this factory is to allow plugins to get isolated data stores so that plugins are discouraged from database integration.
+ * The purpose of this factory is to allow plugins to get isolated data stores so that plugins are discouraged from
+ * database integration. Plugins can omit the `database` parameter to get the default plugin database, or
+ * provide an identifier that will be used to identify a separate database from the default.
  */
-export type PluginDatabaseFactory = {
-  /**
-   * Returns a database connection. Plugins can omit the `database` parameter to get the default plugin database, or
-   * provide an identifier that will be used to identify a separate database from the default.
-   *
-   * Plugins completely own and manage the state of the database (including schema/migrations/data.)
-   */
-  getDatabase(database?: String): Promise<knex>;
-};
+export type PluginDatabaseClientFactory = (database?: string) => Promise<knex>;
diff --git a/packages/backend/src/index.ts b/packages/backend/src/index.ts
index 192ceb95a2..a3b700de46 100644
--- a/packages/backend/src/index.ts
+++ b/packages/backend/src/index.ts
@@ -29,8 +29,7 @@ import {
   getRootLogger,
   useHotMemoize,
   notFoundHandler,
-  SingleDatabaseConfiguration,
-  SingleDatabaseManager,
+  SingleConnectionManager,
   SingleHostDiscovery,
   UrlReaders,
 } from '@backstage/backend-common';
@@ -55,15 +54,14 @@ function makeCreateEnv(config: ConfigReader) {
 
   root.info(`Created UrlReader ${reader}`);
 
-  const databaseConfig = new SingleDatabaseConfiguration(
+  const databaseManager = new SingleConnectionManager(
     config.getConfig('backend.database'),
   );
-  const databaseManager = new SingleDatabaseManager(databaseConfig);
 
   return (plugin: string): PluginEnvironment => {
     const logger = root.child({ type: 'plugin', plugin });
-    const databaseFactory = databaseManager.getDatabaseFactory(plugin);
-    return { logger, database: databaseFactory, config, reader, discovery };
+    const databaseFactory = databaseManager.getDatabaseClientFactory(plugin);
+    return { logger, databaseClientFactory: databaseFactory, config, reader, discovery };
   };
 }
 
diff --git a/packages/backend/src/plugins/auth.ts b/packages/backend/src/plugins/auth.ts
index 913c8b783d..1e933fb398 100644
--- a/packages/backend/src/plugins/auth.ts
+++ b/packages/backend/src/plugins/auth.ts
@@ -19,9 +19,14 @@ import { PluginEnvironment } from '../types';
 
 export default async function createPlugin({
   logger,
-  database,
+  databaseClientFactory,
   config,
   discovery,
 }: PluginEnvironment) {
-  return await createRouter({ logger, config, database, discovery });
+  return await createRouter({
+    logger,
+    config,
+    database: databaseClientFactory,
+    discovery,
+  });
 }
diff --git a/packages/backend/src/plugins/catalog.ts b/packages/backend/src/plugins/catalog.ts
index 9ab2203ca2..04e3304f0c 100644
--- a/packages/backend/src/plugins/catalog.ts
+++ b/packages/backend/src/plugins/catalog.ts
@@ -30,12 +30,12 @@ export default async function createPlugin({
   logger,
   config,
   reader,
-  database,
+  databaseClientFactory,
 }: PluginEnvironment) {
   const locationReader = new LocationReaders({ logger, reader, config });
 
   const db = await DatabaseManager.createDatabase(
-    await database.getDatabase(),
+    await databaseClientFactory(),
     { logger },
   );
   const entitiesCatalog = new DatabaseEntitiesCatalog(db);
diff --git a/packages/backend/src/types.ts b/packages/backend/src/types.ts
index 98797eddf9..b032917f1d 100644
--- a/packages/backend/src/types.ts
+++ b/packages/backend/src/types.ts
@@ -17,14 +17,14 @@
 import { Logger } from 'winston';
 import { Config } from '@backstage/config';
 import {
-  PluginDatabaseFactory,
+  PluginDatabaseClientFactory,
   PluginEndpointDiscovery,
   UrlReader
 } from '@backstage/backend-common';
 
 export type PluginEnvironment = {
   logger: Logger;
-  database: PluginDatabaseFactory;
+  databaseClientFactory: PluginDatabaseClientFactory;
   config: Config;
   reader: UrlReader;
   discovery: PluginEndpointDiscovery;
diff --git a/packages/create-app/templates/default-app/packages/backend/src/index.ts b/packages/create-app/templates/default-app/packages/backend/src/index.ts
index 437ef5afcd..b35f21c5e9 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/index.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/index.ts
@@ -8,14 +8,12 @@
 
 import Router from 'express-promise-router';
 import {
-  ensureDatabaseExists,
   createServiceBuilder,
   loadBackendConfig,
   getRootLogger,
   useHotMemoize,
   notFoundHandler,
-  SingleDatabaseConfiguration,
-  SingleDatabaseManager,
+  SingleConnectionManager,
   SingleHostDiscovery,
   UrlReaders,
 } from '@backstage/backend-common';
@@ -34,15 +32,20 @@ function makeCreateEnv(config: ConfigReader) {
 
   root.info(`Created UrlReader ${reader}`);
 
-  const databaseConfig = new SingleDatabaseConfiguration(
-    config.getConfig('backend.database'),
-  )
-  const databaseManager = new SingleDatabaseManager(databaseConfig);
+  const databaseManager = new SingleConnectionManager(
+    config.getConfig('backend.database')
+  );
 
   return (plugin: string): PluginEnvironment => {
     const logger = root.child({ type: 'plugin', plugin });
-    const databaseFactory = databaseManager.getDatabaseFactory(plugin);
-    return { logger, database: databaseFactory, config, reader, discovery };
+    const databaseFactory = databaseManager.getDatabaseClientFactory(plugin);
+    return {
+      logger,
+      databaseClientFactory: databaseFactory,
+      config,
+      reader,
+      discovery
+    };
   };
 }
 
@@ -50,11 +53,6 @@ async function main() {
   const configs = await loadBackendConfig();
   const configReader = ConfigReader.fromConfigs(configs);
   const createEnv = makeCreateEnv(configReader);
-  await ensureDatabaseExists(
-    configReader.getConfig('backend.database'),
-    'backstage_plugin_catalog',
-    'backstage_plugin_auth',
-  );
 
   const catalogEnv = useHotMemoize(module, () => createEnv('catalog'));
   const scaffolderEnv = useHotMemoize(module, () => createEnv('scaffolder'));
diff --git a/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts b/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts
index fe19855d5d..0f8cc21dec 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts
@@ -3,9 +3,14 @@ import { PluginEnvironment } from '../types';
 
 export default async function createPlugin({
   logger,
-  database,
+  databaseClientFactory,
   config,
   discovery,
 }: PluginEnvironment) {
-  return await createRouter({ logger, config, database, discovery });
+  return await createRouter({
+    logger,
+    config,
+    database: databaseClientFactory,
+    discovery
+  });
 }
diff --git a/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts b/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts
index 345ac4c23d..a0ff556ed0 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts
@@ -14,11 +14,14 @@ export default async function createPlugin({
   logger,
   config,
   reader,
-  database,
+  databaseClientFactory,
 }: PluginEnvironment) {
   const locationReader = new LocationReaders({ logger, reader, config });
 
-  const db = await DatabaseManager.createDatabase(database, { logger });
+  const db = await DatabaseManager.createDatabase(
+    await databaseClientFactory(),
+    { logger },
+  );
   const entitiesCatalog = new DatabaseEntitiesCatalog(db);
   const locationsCatalog = new DatabaseLocationsCatalog(db);
   const higherOrderOperation = new HigherOrderOperations(
diff --git a/packages/create-app/templates/default-app/packages/backend/src/types.ts b/packages/create-app/templates/default-app/packages/backend/src/types.ts
index aa003f63a5..c2b7b5fa8e 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/types.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/types.ts
@@ -1,11 +1,14 @@
-import Knex from 'knex';
 import { Logger } from 'winston';
 import { Config } from '@backstage/config';
-import { PluginEndpointDiscovery, UrlReader } from '@backstage/backend-common';
+import {
+  PluginDatabaseClientFactory,
+  PluginEndpointDiscovery,
+  UrlReader
+} from '@backstage/backend-common';
 
 export type PluginEnvironment = {
   logger: Logger;
-  database: Knex;
+  databaseClientFactory: PluginDatabaseClientFactory;
   config: Config;
   reader: UrlReader
   discovery: PluginEndpointDiscovery;
diff --git a/plugins/auth-backend/src/service/router.ts b/plugins/auth-backend/src/service/router.ts
index d514586ec9..f21b2d58fc 100644
--- a/plugins/auth-backend/src/service/router.ts
+++ b/plugins/auth-backend/src/service/router.ts
@@ -24,12 +24,12 @@ import { DatabaseKeyStore, TokenFactory, createOidcRouter } from '../identity';
 import {
   NotFoundError,
   PluginEndpointDiscovery,
-  PluginDatabaseFactory,
+  PluginDatabaseClientFactory,
 } from '@backstage/backend-common';
 
 export interface RouterOptions {
   logger: Logger;
-  database: PluginDatabaseFactory;
+  database: PluginDatabaseClientFactory;
   config: Config;
   discovery: PluginEndpointDiscovery;
 }
@@ -48,7 +48,7 @@ export async function createRouter({
   const keyDurationSeconds = 3600;
 
   const keyStore = await DatabaseKeyStore.create({
-    database: await database.getDatabase(),
+    database: await database(),
   });
   const tokenIssuer = new TokenFactory({
     issuer: authUrl,
diff --git a/plugins/auth-backend/src/service/standaloneServer.ts b/plugins/auth-backend/src/service/standaloneServer.ts
index e51b959188..b5c15b3704 100644
--- a/plugins/auth-backend/src/service/standaloneServer.ts
+++ b/plugins/auth-backend/src/service/standaloneServer.ts
@@ -53,10 +53,8 @@ export async function startStandaloneServer(
   const router = await createRouter({
     logger,
     config,
-    database: {
-      async getDatabase(_database?: string) {
-        return database;
-      },
+    database: async () => {
+      return database;
     },
     discovery,
   });

From b083c97f8459ab9275091e24f26646df4de4f830 Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Mon, 5 Oct 2020 10:03:10 +0800
Subject: [PATCH 062/110] Replace PluginDatabaseClientFactory with
 PluginDatabaseManager

---
 CHANGELOG.md                                  |  1 +
 .../src/database/SingleConnection.ts          | 36 +++++++++++++------
 packages/backend-common/src/database/types.ts | 20 +++++++----
 packages/backend/src/index.ts                 | 10 +++---
 packages/backend/src/plugins/auth.ts          |  9 ++---
 packages/backend/src/plugins/catalog.ts       |  9 +++--
 packages/backend/src/types.ts                 |  6 ++--
 .../default-app/packages/backend/src/index.ts | 16 +++------
 .../packages/backend/src/plugins/auth.ts      |  9 ++---
 .../packages/backend/src/plugins/catalog.ts   |  5 ++-
 .../default-app/packages/backend/src/types.ts |  6 ++--
 plugins/auth-backend/src/service/router.ts    |  6 ++--
 .../src/service/standaloneServer.ts           |  6 ++--
 13 files changed, 71 insertions(+), 68 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1860a4de6f..c5229a6794 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@ If you encounter issues while upgrading to a newer version, don't hesitate to re
 
 - The default mount point for backend plugins have been changed to `/api`. These changes are done in the backend package itself, so it is recommended that you sync up existing backend packages with this new pattern. [#2562](https://github.com/spotify/backstage/pull/2562)
 - A service discovery mechanism for backend plugins has been added, and is now a requirement for several backend plugins. See [packages/backend/src/index.ts](./packages/backend/src/index.ts) for how to set it up using `SingleHostDiscovery` from `@backstage/backend-common`. Note that the default base path for plugins is set to `/api` to that change, but it can be set to use the old behavior via the `basePath` option. [#2600](https://github.com/spotify/backstage/pull/2600)
+- A plugin database manager has been created, and plugins can now accept that interface as an argument during initialisation. Notably, the `auth` plugin has a [`createRouter` signature change](./plugins/auth-backend/src/service/router.ts). See [packages/backend/src/index.ts](./packages/backend/src/index.ts) on how to set it up. [#2697](https://github.com/spotify/backstage/pull/2697)
 
 ### @backstage/auth-backend
 
diff --git a/packages/backend-common/src/database/SingleConnection.ts b/packages/backend-common/src/database/SingleConnection.ts
index 8ed93166cf..c34c3a8310 100644
--- a/packages/backend-common/src/database/SingleConnection.ts
+++ b/packages/backend-common/src/database/SingleConnection.ts
@@ -17,16 +17,28 @@
 import Knex from 'knex';
 import { Config } from '@backstage/config';
 import { createDatabaseClient, ensureDatabaseExists } from './connection';
-import { PluginDatabaseClientFactory } from './types';
+import { PluginDatabaseManager } from './types';
 
 /**
- * Implements a Database Manager which will automatically create new databases for plugins when requested. All
- * requested databases are created with the credentials provided.
+ * Implements a Database Manager which will automatically create new databases
+ * for plugins when requested. All requested databases are created with the
+ * credentials provided.
  */
-export class SingleConnectionManager {
+export class SingleConnectionDatabaseManager {
   private readonly config: Config;
 
-  constructor(config: Config) {
+  /**
+   * Creates a new SingleConnectionDatabaseManager instance by reading from the `backend`
+   * config section, specifically the `.database` key for discovering the management
+   * database configuration.
+   */
+  static fromConfig(config: Config): SingleConnectionDatabaseManager {
+    return new SingleConnectionDatabaseManager(
+      config.getConfig('backend.database'),
+    );
+  }
+
+  private constructor(config: Config) {
     this.config = config;
   }
 
@@ -39,17 +51,21 @@ export class SingleConnectionManager {
   }
 
   /**
-   * Generates a PluginDatabaseClientFactory for consumption by plugins.
+   * Generates a PluginDatabaseManager for consumption by plugins.
    */
-  getDatabaseClientFactory(pluginId: string): PluginDatabaseClientFactory {
-    return (database?: string): Promise<Knex> => {
-      return this.getDatabase(pluginId, database);
+  forPlugin(pluginId: string): PluginDatabaseManager {
+    const _this = this;
+
+    return {
+      getClient(database?: string): Promise<Knex> {
+        return _this.getDatabase(pluginId, database);
+      },
     };
   }
 
   private async getDatabase(pluginId: string, suffix?: string): Promise<Knex> {
     const config = this.getDatabaseConfig();
-    const overrides = SingleConnectionManager.getDatabaseOverrides(
+    const overrides = SingleConnectionDatabaseManager.getDatabaseOverrides(
       pluginId,
       suffix,
     );
diff --git a/packages/backend-common/src/database/types.ts b/packages/backend-common/src/database/types.ts
index b616ca848a..915a12a24e 100644
--- a/packages/backend-common/src/database/types.ts
+++ b/packages/backend-common/src/database/types.ts
@@ -17,11 +17,17 @@
 import knex from 'knex';
 
 /**
- * The PluginDatabaseClientFactory is used to provide a mechanism for backend plugins to obtain database connections
- * for itself.
- *
- * The purpose of this factory is to allow plugins to get isolated data stores so that plugins are discouraged from
- * database integration. Plugins can omit the `database` parameter to get the default plugin database, or
- * provide an identifier that will be used to identify a separate database from the default.
+ * The PluginDatabaseManager manages access to databases that Plugins get.
  */
-export type PluginDatabaseClientFactory = (database?: string) => Promise<knex>;
+export interface PluginDatabaseManager {
+  /**
+   * getClient provides backend plugins database connections for itself.
+   *
+   * The purpose of this method is to allow plugins to get isolated data
+   * stores so that plugins are discouraged from database integration. Plugins
+   * can omit the `database` parameter to get the default plugin database, or
+   * provide an identifier that will be used to identify a separate database
+   * from the default.
+   */
+  getClient(database?: string): Promise<knex>;
+}
diff --git a/packages/backend/src/index.ts b/packages/backend/src/index.ts
index a3b700de46..18fd44f089 100644
--- a/packages/backend/src/index.ts
+++ b/packages/backend/src/index.ts
@@ -29,7 +29,7 @@ import {
   getRootLogger,
   useHotMemoize,
   notFoundHandler,
-  SingleConnectionManager,
+  SingleConnectionDatabaseManager,
   SingleHostDiscovery,
   UrlReaders,
 } from '@backstage/backend-common';
@@ -54,14 +54,12 @@ function makeCreateEnv(config: ConfigReader) {
 
   root.info(`Created UrlReader ${reader}`);
 
-  const databaseManager = new SingleConnectionManager(
-    config.getConfig('backend.database'),
-  );
+  const databaseManager = SingleConnectionDatabaseManager.fromConfig(config);
 
   return (plugin: string): PluginEnvironment => {
     const logger = root.child({ type: 'plugin', plugin });
-    const databaseFactory = databaseManager.getDatabaseClientFactory(plugin);
-    return { logger, databaseClientFactory: databaseFactory, config, reader, discovery };
+    const database = databaseManager.forPlugin(plugin);
+    return { logger, database, config, reader, discovery };
   };
 }
 
diff --git a/packages/backend/src/plugins/auth.ts b/packages/backend/src/plugins/auth.ts
index 1e933fb398..913c8b783d 100644
--- a/packages/backend/src/plugins/auth.ts
+++ b/packages/backend/src/plugins/auth.ts
@@ -19,14 +19,9 @@ import { PluginEnvironment } from '../types';
 
 export default async function createPlugin({
   logger,
-  databaseClientFactory,
+  database,
   config,
   discovery,
 }: PluginEnvironment) {
-  return await createRouter({
-    logger,
-    config,
-    database: databaseClientFactory,
-    discovery,
-  });
+  return await createRouter({ logger, config, database, discovery });
 }
diff --git a/packages/backend/src/plugins/catalog.ts b/packages/backend/src/plugins/catalog.ts
index 04e3304f0c..b8e99e6398 100644
--- a/packages/backend/src/plugins/catalog.ts
+++ b/packages/backend/src/plugins/catalog.ts
@@ -30,14 +30,13 @@ export default async function createPlugin({
   logger,
   config,
   reader,
-  databaseClientFactory,
+  database,
 }: PluginEnvironment) {
   const locationReader = new LocationReaders({ logger, reader, config });
 
-  const db = await DatabaseManager.createDatabase(
-    await databaseClientFactory(),
-    { logger },
-  );
+  const db = await DatabaseManager.createDatabase(await database.getClient(), {
+    logger,
+  });
   const entitiesCatalog = new DatabaseEntitiesCatalog(db);
   const locationsCatalog = new DatabaseLocationsCatalog(db);
   const higherOrderOperation = new HigherOrderOperations(
diff --git a/packages/backend/src/types.ts b/packages/backend/src/types.ts
index b032917f1d..f63b9dd780 100644
--- a/packages/backend/src/types.ts
+++ b/packages/backend/src/types.ts
@@ -17,14 +17,14 @@
 import { Logger } from 'winston';
 import { Config } from '@backstage/config';
 import {
-  PluginDatabaseClientFactory,
+  PluginDatabaseManager,
   PluginEndpointDiscovery,
-  UrlReader
+  UrlReader,
 } from '@backstage/backend-common';
 
 export type PluginEnvironment = {
   logger: Logger;
-  databaseClientFactory: PluginDatabaseClientFactory;
+  database: PluginDatabaseManager;
   config: Config;
   reader: UrlReader;
   discovery: PluginEndpointDiscovery;
diff --git a/packages/create-app/templates/default-app/packages/backend/src/index.ts b/packages/create-app/templates/default-app/packages/backend/src/index.ts
index b35f21c5e9..d58ebe4e42 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/index.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/index.ts
@@ -13,7 +13,7 @@ import {
   getRootLogger,
   useHotMemoize,
   notFoundHandler,
-  SingleConnectionManager,
+  SingleConnectionDatabaseManager,
   SingleHostDiscovery,
   UrlReaders,
 } from '@backstage/backend-common';
@@ -32,20 +32,12 @@ function makeCreateEnv(config: ConfigReader) {
 
   root.info(`Created UrlReader ${reader}`);
 
-  const databaseManager = new SingleConnectionManager(
-    config.getConfig('backend.database')
-  );
+  const databaseManager = SingleConnectionDatabaseManager.fromConfig(config);
 
   return (plugin: string): PluginEnvironment => {
     const logger = root.child({ type: 'plugin', plugin });
-    const databaseFactory = databaseManager.getDatabaseClientFactory(plugin);
-    return {
-      logger,
-      databaseClientFactory: databaseFactory,
-      config,
-      reader,
-      discovery
-    };
+    const database = databaseManager.forPlugin(plugin);
+    return { logger, database, config, reader, discovery };
   };
 }
 
diff --git a/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts b/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts
index 0f8cc21dec..fe19855d5d 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/plugins/auth.ts
@@ -3,14 +3,9 @@ import { PluginEnvironment } from '../types';
 
 export default async function createPlugin({
   logger,
-  databaseClientFactory,
+  database,
   config,
   discovery,
 }: PluginEnvironment) {
-  return await createRouter({
-    logger,
-    config,
-    database: databaseClientFactory,
-    discovery
-  });
+  return await createRouter({ logger, config, database, discovery });
 }
diff --git a/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts b/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts
index a0ff556ed0..aee38a5fa0 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts
@@ -14,12 +14,11 @@ export default async function createPlugin({
   logger,
   config,
   reader,
-  databaseClientFactory,
+  database,
 }: PluginEnvironment) {
   const locationReader = new LocationReaders({ logger, reader, config });
 
-  const db = await DatabaseManager.createDatabase(
-    await databaseClientFactory(),
+  const db = await DatabaseManager.createDatabase(await database.getClient(),
     { logger },
   );
   const entitiesCatalog = new DatabaseEntitiesCatalog(db);
diff --git a/packages/create-app/templates/default-app/packages/backend/src/types.ts b/packages/create-app/templates/default-app/packages/backend/src/types.ts
index c2b7b5fa8e..757a0e5acf 100644
--- a/packages/create-app/templates/default-app/packages/backend/src/types.ts
+++ b/packages/create-app/templates/default-app/packages/backend/src/types.ts
@@ -1,14 +1,14 @@
 import { Logger } from 'winston';
 import { Config } from '@backstage/config';
 import {
-  PluginDatabaseClientFactory,
+  PluginDatabaseManager,
   PluginEndpointDiscovery,
-  UrlReader
+  UrlReader,
 } from '@backstage/backend-common';
 
 export type PluginEnvironment = {
   logger: Logger;
-  databaseClientFactory: PluginDatabaseClientFactory;
+  database: PluginDatabaseManager;
   config: Config;
   reader: UrlReader
   discovery: PluginEndpointDiscovery;
diff --git a/plugins/auth-backend/src/service/router.ts b/plugins/auth-backend/src/service/router.ts
index f21b2d58fc..6bb100de6b 100644
--- a/plugins/auth-backend/src/service/router.ts
+++ b/plugins/auth-backend/src/service/router.ts
@@ -24,12 +24,12 @@ import { DatabaseKeyStore, TokenFactory, createOidcRouter } from '../identity';
 import {
   NotFoundError,
   PluginEndpointDiscovery,
-  PluginDatabaseClientFactory,
+  PluginDatabaseManager,
 } from '@backstage/backend-common';
 
 export interface RouterOptions {
   logger: Logger;
-  database: PluginDatabaseClientFactory;
+  database: PluginDatabaseManager;
   config: Config;
   discovery: PluginEndpointDiscovery;
 }
@@ -48,7 +48,7 @@ export async function createRouter({
   const keyDurationSeconds = 3600;
 
   const keyStore = await DatabaseKeyStore.create({
-    database: await database(),
+    database: await database.getClient(),
   });
   const tokenIssuer = new TokenFactory({
     issuer: authUrl,
diff --git a/plugins/auth-backend/src/service/standaloneServer.ts b/plugins/auth-backend/src/service/standaloneServer.ts
index b5c15b3704..d00e7d523d 100644
--- a/plugins/auth-backend/src/service/standaloneServer.ts
+++ b/plugins/auth-backend/src/service/standaloneServer.ts
@@ -53,8 +53,10 @@ export async function startStandaloneServer(
   const router = await createRouter({
     logger,
     config,
-    database: async () => {
-      return database;
+    database: {
+      async getClient() {
+        return database;
+      },
     },
     discovery,
   });

From 906e593a54b2c103e4b90ac4ba0f94cba7c96ddd Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Mon, 5 Oct 2020 11:58:34 +0800
Subject: [PATCH 063/110] Implement tests

---
 .../src/database/SingleConnection.test.ts     | 116 ++++++++++++++++++
 .../src/database/config.test.ts               |  12 ++
 2 files changed, 128 insertions(+)
 create mode 100644 packages/backend-common/src/database/SingleConnection.test.ts

diff --git a/packages/backend-common/src/database/SingleConnection.test.ts b/packages/backend-common/src/database/SingleConnection.test.ts
new file mode 100644
index 0000000000..9da256a2c3
--- /dev/null
+++ b/packages/backend-common/src/database/SingleConnection.test.ts
@@ -0,0 +1,116 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { ConfigReader } from '@backstage/config';
+import { createDatabaseClient } from './connection';
+import { SingleConnectionDatabaseManager } from './SingleConnection';
+
+jest.mock('./connection');
+
+describe('SingleConnectionDatabaseManager', () => {
+  const createConfig = (data: any) =>
+    ConfigReader.fromConfigs([
+      {
+        context: '',
+        data,
+      },
+    ]);
+
+  const defaultConfigOptions = {
+    backend: {
+      database: {
+        client: 'pg',
+        connection: {
+          host: 'localhost',
+          user: 'foo',
+          password: 'bar',
+          database: 'foodb',
+        },
+      },
+    },
+  };
+  const defaultConfig = () => createConfig(defaultConfigOptions);
+
+  // This is similar to the ts-jest `mocked` helper.
+  const mocked = (f: Function) => f as jest.Mock;
+
+  describe('SingleConnectionDatabaseManager.fromConfig', () => {
+    it('accesses the backend.database key', () => {
+      const getConfig = jest.fn();
+      const config = defaultConfig();
+      config.getConfig = getConfig;
+
+      SingleConnectionDatabaseManager.fromConfig(config);
+
+      expect(getConfig.mock.calls[0][0]).toEqual('backend.database');
+    });
+  });
+
+  describe('SingleConnectionDatabaseManager.forPlugin', () => {
+    const manager = SingleConnectionDatabaseManager.fromConfig(defaultConfig());
+
+    it('connects to a database scoped to the plugin', async () => {
+      const pluginId = 'test1';
+      await manager.forPlugin(pluginId).getClient();
+
+      expect(mocked(createDatabaseClient).mock.calls).toHaveLength(1);
+      const mockCalls = mocked(createDatabaseClient).mock.calls.splice(-1);
+
+      const callArgs = mockCalls[0];
+      expect(callArgs[0].get()).toEqual(defaultConfigOptions.backend.database);
+      expect(callArgs[1].connection.database).toEqual(
+        `backstage_plugin_${pluginId}`,
+      );
+    });
+
+    it('allows plugins to get alternative databases', async () => {
+      const pluginId = 'test1';
+      const pluginManager = manager.forPlugin(pluginId);
+      await pluginManager.getClient();
+
+      const secondaryDatabase = 'extra';
+      await pluginManager.getClient(secondaryDatabase);
+
+      expect(mocked(createDatabaseClient).mock.calls).toHaveLength(2);
+      const mockCalls = mocked(createDatabaseClient).mock.calls.splice(-2);
+
+      const mainCallArgs = mockCalls[0];
+      const secondaryCallArgs = mockCalls[1];
+      expect(secondaryCallArgs[1].connection.database).toEqual(
+        `backstage_plugin_${pluginId}_${secondaryDatabase}`,
+      );
+      expect(mainCallArgs[1].connection.database).not.toEqual(
+        secondaryCallArgs[1].connection.database,
+      );
+    });
+
+    it('provides different plugins different databases', async () => {
+      const plugin1Id = 'test1';
+      const plugin2Id = 'test2';
+      await manager.forPlugin(plugin1Id).getClient();
+      await manager.forPlugin(plugin2Id).getClient();
+
+      expect(mocked(createDatabaseClient).mock.calls).toHaveLength(2);
+      const mockCalls = mocked(createDatabaseClient).mock.calls.splice(-2);
+
+      const plugin1CallArgs = mockCalls[0];
+      const plugin2CallArgs = mockCalls[1];
+      expect(plugin1CallArgs[1].connection.database).not.toEqual(
+        plugin2CallArgs[1].connection.database,
+      );
+    });
+  });
+});
diff --git a/packages/backend-common/src/database/config.test.ts b/packages/backend-common/src/database/config.test.ts
index ab29bc19ba..c9a4107686 100644
--- a/packages/backend-common/src/database/config.test.ts
+++ b/packages/backend-common/src/database/config.test.ts
@@ -18,6 +18,18 @@ import { mergeDatabaseConfig } from './config';
 
 describe('config', () => {
   describe(mergeDatabaseConfig, () => {
+    it('does not mutate the input object', () => {
+      const input = {
+        original: 'key',
+      };
+      const override = {
+        added: 'value',
+      };
+
+      mergeDatabaseConfig(input, override);
+      expect(input).not.toHaveProperty('added');
+    });
+
     it('does not require overrides', () => {
       expect(
         mergeDatabaseConfig({

From f88cc8846b2f25a66335a346a8aa330c69fa120f Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Tue, 6 Oct 2020 09:04:05 +0800
Subject: [PATCH 064/110] Add missing @param declarations in API docs

---
 .../backend-common/src/database/SingleConnection.ts    |  4 ++++
 packages/backend-common/src/database/config.ts         |  2 +-
 packages/backend-common/src/database/types.ts          | 10 ++++++----
 3 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/packages/backend-common/src/database/SingleConnection.ts b/packages/backend-common/src/database/SingleConnection.ts
index c34c3a8310..aa2e2186b5 100644
--- a/packages/backend-common/src/database/SingleConnection.ts
+++ b/packages/backend-common/src/database/SingleConnection.ts
@@ -31,6 +31,8 @@ export class SingleConnectionDatabaseManager {
    * Creates a new SingleConnectionDatabaseManager instance by reading from the `backend`
    * config section, specifically the `.database` key for discovering the management
    * database configuration.
+   *
+   * @param config The loaded application configuration.
    */
   static fromConfig(config: Config): SingleConnectionDatabaseManager {
     return new SingleConnectionDatabaseManager(
@@ -52,6 +54,8 @@ export class SingleConnectionDatabaseManager {
 
   /**
    * Generates a PluginDatabaseManager for consumption by plugins.
+   *
+   * @param pluginId The plugin that the database manager should be created for. Plugin names should be unique.
    */
   forPlugin(pluginId: string): PluginDatabaseManager {
     const _this = this;
diff --git a/packages/backend-common/src/database/config.ts b/packages/backend-common/src/database/config.ts
index a16cf6cbee..af32556c28 100644
--- a/packages/backend-common/src/database/config.ts
+++ b/packages/backend-common/src/database/config.ts
@@ -19,7 +19,7 @@ import { merge } from 'lodash';
 /**
  * Merges database objects together
  *
- * @param config The base config
+ * @param config The base config. The input is not modified
  * @param overrides Any additional overrides
  */
 export function mergeDatabaseConfig(config: any, ...overrides: any[]) {
diff --git a/packages/backend-common/src/database/types.ts b/packages/backend-common/src/database/types.ts
index 915a12a24e..5705d8ae5f 100644
--- a/packages/backend-common/src/database/types.ts
+++ b/packages/backend-common/src/database/types.ts
@@ -24,10 +24,12 @@ export interface PluginDatabaseManager {
    * getClient provides backend plugins database connections for itself.
    *
    * The purpose of this method is to allow plugins to get isolated data
-   * stores so that plugins are discouraged from database integration. Plugins
-   * can omit the `database` parameter to get the default plugin database, or
-   * provide an identifier that will be used to identify a separate database
-   * from the default.
+   * stores so that plugins are discouraged from database integration.
+   *
+   * @param database This parameter can be omitted to get the default plugin
+   * database, or provide an identifier that will be used to identify a
+   * separate database from the default to connect to. This can be used for
+   * application-level sharding.
    */
   getClient(database?: string): Promise<knex>;
 }

From c990535157f1ccfa6222c00a5dc14a0b64656801 Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Tue, 6 Oct 2020 18:16:13 +0800
Subject: [PATCH 065/110] Remove support for alternative plugin databases

---
 .../src/database/SingleConnection.test.ts     | 21 -------------------
 .../src/database/SingleConnection.ts          | 15 +++++--------
 packages/backend-common/src/database/types.ts |  7 +------
 3 files changed, 6 insertions(+), 37 deletions(-)

diff --git a/packages/backend-common/src/database/SingleConnection.test.ts b/packages/backend-common/src/database/SingleConnection.test.ts
index 9da256a2c3..bc68e02bf4 100644
--- a/packages/backend-common/src/database/SingleConnection.test.ts
+++ b/packages/backend-common/src/database/SingleConnection.test.ts
@@ -76,27 +76,6 @@ describe('SingleConnectionDatabaseManager', () => {
       );
     });
 
-    it('allows plugins to get alternative databases', async () => {
-      const pluginId = 'test1';
-      const pluginManager = manager.forPlugin(pluginId);
-      await pluginManager.getClient();
-
-      const secondaryDatabase = 'extra';
-      await pluginManager.getClient(secondaryDatabase);
-
-      expect(mocked(createDatabaseClient).mock.calls).toHaveLength(2);
-      const mockCalls = mocked(createDatabaseClient).mock.calls.splice(-2);
-
-      const mainCallArgs = mockCalls[0];
-      const secondaryCallArgs = mockCalls[1];
-      expect(secondaryCallArgs[1].connection.database).toEqual(
-        `backstage_plugin_${pluginId}_${secondaryDatabase}`,
-      );
-      expect(mainCallArgs[1].connection.database).not.toEqual(
-        secondaryCallArgs[1].connection.database,
-      );
-    });
-
     it('provides different plugins different databases', async () => {
       const plugin1Id = 'test1';
       const plugin2Id = 'test2';
diff --git a/packages/backend-common/src/database/SingleConnection.ts b/packages/backend-common/src/database/SingleConnection.ts
index aa2e2186b5..f8c86838a1 100644
--- a/packages/backend-common/src/database/SingleConnection.ts
+++ b/packages/backend-common/src/database/SingleConnection.ts
@@ -61,17 +61,16 @@ export class SingleConnectionDatabaseManager {
     const _this = this;
 
     return {
-      getClient(database?: string): Promise<Knex> {
-        return _this.getDatabase(pluginId, database);
+      getClient(): Promise<Knex> {
+        return _this.getDatabase(pluginId);
       },
     };
   }
 
-  private async getDatabase(pluginId: string, suffix?: string): Promise<Knex> {
+  private async getDatabase(pluginId: string): Promise<Knex> {
     const config = this.getDatabaseConfig();
     const overrides = SingleConnectionDatabaseManager.getDatabaseOverrides(
       pluginId,
-      suffix,
     );
     const overrideConfig = overrides.connection as Knex.ConnectionConfig;
     await this.ensureDatabase(overrideConfig.database);
@@ -79,14 +78,10 @@ export class SingleConnectionDatabaseManager {
     return createDatabaseClient(config, overrides);
   }
 
-  private static getDatabaseOverrides(
-    pluginId: string,
-    suffix?: string,
-  ): Knex.Config {
-    const dbSuffix = suffix ? `_${suffix}` : '';
+  private static getDatabaseOverrides(pluginId: string): Knex.Config {
     return {
       connection: {
-        database: `backstage_plugin_${pluginId}${dbSuffix}`,
+        database: `backstage_plugin_${pluginId}`,
       },
     };
   }
diff --git a/packages/backend-common/src/database/types.ts b/packages/backend-common/src/database/types.ts
index 5705d8ae5f..7eaa05f173 100644
--- a/packages/backend-common/src/database/types.ts
+++ b/packages/backend-common/src/database/types.ts
@@ -25,11 +25,6 @@ export interface PluginDatabaseManager {
    *
    * The purpose of this method is to allow plugins to get isolated data
    * stores so that plugins are discouraged from database integration.
-   *
-   * @param database This parameter can be omitted to get the default plugin
-   * database, or provide an identifier that will be used to identify a
-   * separate database from the default to connect to. This can be used for
-   * application-level sharding.
    */
-  getClient(database?: string): Promise<knex>;
+  getClient(): Promise<knex>;
 }

From 7151da64e050b0d5f3607888a978dde81458f7b0 Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Tue, 6 Oct 2020 18:18:45 +0800
Subject: [PATCH 066/110] No longer any need to create databases, but drop them
 for consistency

---
 packages/e2e-test/src/e2e-test.ts | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/packages/e2e-test/src/e2e-test.ts b/packages/e2e-test/src/e2e-test.ts
index c7f6137ff1..c839454426 100644
--- a/packages/e2e-test/src/e2e-test.ts
+++ b/packages/e2e-test/src/e2e-test.ts
@@ -328,8 +328,8 @@ async function testAppServe(pluginName: string, appDir: string) {
   }
 }
 
-/** Creates PG databases (drops if exists before) */
-async function createDB(database: string) {
+/** Drops PG databases */
+async function dropDB(database: string) {
   const config = {
     host: process.env.POSTGRES_HOST,
     port: process.env.POSTGRES_PORT,
@@ -342,7 +342,6 @@ async function createDB(database: string) {
   } catch (_) {
     /* do nothing*/
   }
-  return pgtools.createdb(config, database);
 }
 
 /**
@@ -350,7 +349,7 @@ async function createDB(database: string) {
  */
 async function testBackendStart(appDir: string, isPostgres: boolean) {
   if (isPostgres) {
-    print('Creating DBs');
+    print('Dropping old DBs');
     await Promise.all(
       [
         'catalog',
@@ -359,7 +358,7 @@ async function testBackendStart(appDir: string, isPostgres: boolean) {
         'identity',
         'proxy',
         'techdocs',
-      ].map(name => createDB(`backstage_plugin_${name}`)),
+      ].map(name => dropDB(`backstage_plugin_${name}`)),
     );
     print('Created DBs');
   }

From 0bc45e0d3a4133ce6d6a4bda2d4625d961921c41 Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Wed, 7 Oct 2020 09:36:25 +0800
Subject: [PATCH 067/110] Fix additional review comments

---
 CHANGELOG.md                                  |  5 ++++-
 .../src/database/SingleConnection.ts          | 21 +++++--------------
 2 files changed, 9 insertions(+), 17 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c5229a6794..487b94a39d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,13 +8,16 @@ If you encounter issues while upgrading to a newer version, don't hesitate to re
 
 > Collect changes for the next release below
 
+### Backend (example-backend, or backends created with @backstage/create-app)
+
+- A plugin database manager has been created, and plugins can now accept that interface as an argument during initialisation. Notably, the `auth` plugin has a [`createRouter` signature change](./plugins/auth-backend/src/service/router.ts). See [packages/backend/src/index.ts](./packages/backend/src/index.ts) on how to set it up. [#2697](https://github.com/spotify/backstage/pull/2697)
+
 ## v0.1.1-alpha.24
 
 ### Backend (example-backend, or backends created with @backstage/create-app)
 
 - The default mount point for backend plugins have been changed to `/api`. These changes are done in the backend package itself, so it is recommended that you sync up existing backend packages with this new pattern. [#2562](https://github.com/spotify/backstage/pull/2562)
 - A service discovery mechanism for backend plugins has been added, and is now a requirement for several backend plugins. See [packages/backend/src/index.ts](./packages/backend/src/index.ts) for how to set it up using `SingleHostDiscovery` from `@backstage/backend-common`. Note that the default base path for plugins is set to `/api` to that change, but it can be set to use the old behavior via the `basePath` option. [#2600](https://github.com/spotify/backstage/pull/2600)
-- A plugin database manager has been created, and plugins can now accept that interface as an argument during initialisation. Notably, the `auth` plugin has a [`createRouter` signature change](./plugins/auth-backend/src/service/router.ts). See [packages/backend/src/index.ts](./packages/backend/src/index.ts) on how to set it up. [#2697](https://github.com/spotify/backstage/pull/2697)
 
 ### @backstage/auth-backend
 
diff --git a/packages/backend-common/src/database/SingleConnection.ts b/packages/backend-common/src/database/SingleConnection.ts
index f8c86838a1..777ced54a0 100644
--- a/packages/backend-common/src/database/SingleConnection.ts
+++ b/packages/backend-common/src/database/SingleConnection.ts
@@ -22,11 +22,10 @@ import { PluginDatabaseManager } from './types';
 /**
  * Implements a Database Manager which will automatically create new databases
  * for plugins when requested. All requested databases are created with the
- * credentials provided.
+ * credentials provided; if the database already exists no attempt to create
+ * the database will be made.
  */
 export class SingleConnectionDatabaseManager {
-  private readonly config: Config;
-
   /**
    * Creates a new SingleConnectionDatabaseManager instance by reading from the `backend`
    * config section, specifically the `.database` key for discovering the management
@@ -40,17 +39,7 @@ export class SingleConnectionDatabaseManager {
     );
   }
 
-  private constructor(config: Config) {
-    this.config = config;
-  }
-
-  private getDatabaseConfig(): Config {
-    return this.config;
-  }
-
-  private getAdminConfig(): Config {
-    return this.config;
-  }
+  private constructor(private readonly config: Config) {}
 
   /**
    * Generates a PluginDatabaseManager for consumption by plugins.
@@ -68,7 +57,7 @@ export class SingleConnectionDatabaseManager {
   }
 
   private async getDatabase(pluginId: string): Promise<Knex> {
-    const config = this.getDatabaseConfig();
+    const config = this.config;
     const overrides = SingleConnectionDatabaseManager.getDatabaseOverrides(
       pluginId,
     );
@@ -87,7 +76,7 @@ export class SingleConnectionDatabaseManager {
   }
 
   private async ensureDatabase(database: string) {
-    const config = this.getAdminConfig();
+    const config = this.config;
     await ensureDatabaseExists(config, database);
   }
 }

From 04af2d7af4dd5507047e6f0a4efd929988eaa8aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stefan=20=C3=85lund?= <alund@spotify.com>
Date: Wed, 7 Oct 2020 08:40:57 +0200
Subject: [PATCH 068/110] rm non-used css

---
 packages/core/src/components/EmptyState/EmptyState.tsx | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/core/src/components/EmptyState/EmptyState.tsx b/packages/core/src/components/EmptyState/EmptyState.tsx
index 523f4b467d..1af5ff6dd5 100644
--- a/packages/core/src/components/EmptyState/EmptyState.tsx
+++ b/packages/core/src/components/EmptyState/EmptyState.tsx
@@ -29,10 +29,6 @@ const useStyles = makeStyles(theme => ({
   imageContainer: {
     position: 'relative',
   },
-  backgroundImage: {
-    position: 'absolute',
-    width: '100%',
-  },
 }));
 
 type Props = {

From 758729cc3d66a765195335ffc68e723c93893a9d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stefan=20=C3=85lund?= <alund@spotify.com>
Date: Wed, 7 Oct 2020 08:45:00 +0200
Subject: [PATCH 069/110] Update EmptyStateImage.tsx

---
 packages/core/src/components/EmptyState/EmptyStateImage.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/src/components/EmptyState/EmptyStateImage.tsx b/packages/core/src/components/EmptyState/EmptyStateImage.tsx
index 49598ae6db..d52a0f7dcf 100644
--- a/packages/core/src/components/EmptyState/EmptyStateImage.tsx
+++ b/packages/core/src/components/EmptyState/EmptyStateImage.tsx
@@ -27,7 +27,7 @@ type Props = {
 
 const useStyles = makeStyles({
   generalImg: {
-    width: '75%',
+    width: '95%',
     zIndex: 2,
     position: 'absolute',
     left: '50%',

From 7471a46d270004355fb87afdd0f10c83651b8a0d Mon Sep 17 00:00:00 2001
From: Joel Low <joel.low@grabtaxi.com>
Date: Wed, 7 Oct 2020 14:59:09 +0800
Subject: [PATCH 070/110] Use `resetAllMocks` and `toHaveBeenCalledTimes`

---
 .../src/database/SingleConnection.test.ts              | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/backend-common/src/database/SingleConnection.test.ts b/packages/backend-common/src/database/SingleConnection.test.ts
index bc68e02bf4..6278e4ecad 100644
--- a/packages/backend-common/src/database/SingleConnection.test.ts
+++ b/packages/backend-common/src/database/SingleConnection.test.ts
@@ -47,6 +47,8 @@ describe('SingleConnectionDatabaseManager', () => {
   // This is similar to the ts-jest `mocked` helper.
   const mocked = (f: Function) => f as jest.Mock;
 
+  afterEach(() => jest.resetAllMocks());
+
   describe('SingleConnectionDatabaseManager.fromConfig', () => {
     it('accesses the backend.database key', () => {
       const getConfig = jest.fn();
@@ -66,9 +68,9 @@ describe('SingleConnectionDatabaseManager', () => {
       const pluginId = 'test1';
       await manager.forPlugin(pluginId).getClient();
 
-      expect(mocked(createDatabaseClient).mock.calls).toHaveLength(1);
-      const mockCalls = mocked(createDatabaseClient).mock.calls.splice(-1);
+      expect(mocked(createDatabaseClient)).toHaveBeenCalledTimes(1);
 
+      const mockCalls = mocked(createDatabaseClient).mock.calls.splice(-1);
       const callArgs = mockCalls[0];
       expect(callArgs[0].get()).toEqual(defaultConfigOptions.backend.database);
       expect(callArgs[1].connection.database).toEqual(
@@ -82,9 +84,9 @@ describe('SingleConnectionDatabaseManager', () => {
       await manager.forPlugin(plugin1Id).getClient();
       await manager.forPlugin(plugin2Id).getClient();
 
-      expect(mocked(createDatabaseClient).mock.calls).toHaveLength(2);
-      const mockCalls = mocked(createDatabaseClient).mock.calls.splice(-2);
+      expect(mocked(createDatabaseClient)).toHaveBeenCalledTimes(2);
 
+      const mockCalls = mocked(createDatabaseClient).mock.calls;
       const plugin1CallArgs = mockCalls[0];
       const plugin2CallArgs = mockCalls[1];
       expect(plugin1CallArgs[1].connection.database).not.toEqual(

From 85f4d83551840f66b9533d79cdfa6458f6cfc8cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20Adel=C3=B6w?= <freben@gmail.com>
Date: Wed, 7 Oct 2020 14:26:51 +0200
Subject: [PATCH 071/110] fix(deps): finally a material-table release - no more
 vulnerable jsdom

---
 packages/core/package.json |   2 +-
 yarn.lock                  | 230 ++++++++++++-------------------------
 2 files changed, 73 insertions(+), 159 deletions(-)

diff --git a/packages/core/package.json b/packages/core/package.json
index 0a0dc7576c..3022aa29c4 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -40,7 +40,7 @@
     "classnames": "^2.2.6",
     "clsx": "^1.1.0",
     "lodash": "^4.17.15",
-    "material-table": "1.68.0",
+    "material-table": "^1.69.1",
     "prop-types": "^15.7.2",
     "rc-progress": "^3.0.0",
     "react": "^16.12.0",
diff --git a/yarn.lock b/yarn.lock
index b9f5733acd..3dcd8003b5 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1194,7 +1194,7 @@
     core-js-pure "^3.0.0"
     regenerator-runtime "^0.13.4"
 
-"@babel/runtime@^7.0.0", "@babel/runtime@^7.1.2", "@babel/runtime@^7.10.0", "@babel/runtime@^7.10.2", "@babel/runtime@^7.10.3", "@babel/runtime@^7.10.4", "@babel/runtime@^7.10.5", "@babel/runtime@^7.11.2", "@babel/runtime@^7.3.1", "@babel/runtime@^7.3.4", "@babel/runtime@^7.4.4", "@babel/runtime@^7.4.5", "@babel/runtime@^7.5.0", "@babel/runtime@^7.5.4", "@babel/runtime@^7.5.5", "@babel/runtime@^7.6.0", "@babel/runtime@^7.6.2", "@babel/runtime@^7.7.2", "@babel/runtime@^7.7.6", "@babel/runtime@^7.8.4", "@babel/runtime@^7.8.7", "@babel/runtime@^7.9.2":
+"@babel/runtime@^7.0.0", "@babel/runtime@^7.1.2", "@babel/runtime@^7.10.0", "@babel/runtime@^7.10.2", "@babel/runtime@^7.10.3", "@babel/runtime@^7.10.4", "@babel/runtime@^7.10.5", "@babel/runtime@^7.11.2", "@babel/runtime@^7.3.1", "@babel/runtime@^7.3.4", "@babel/runtime@^7.4.4", "@babel/runtime@^7.4.5", "@babel/runtime@^7.5.0", "@babel/runtime@^7.5.4", "@babel/runtime@^7.5.5", "@babel/runtime@^7.6.0", "@babel/runtime@^7.6.2", "@babel/runtime@^7.6.3", "@babel/runtime@^7.7.2", "@babel/runtime@^7.7.6", "@babel/runtime@^7.8.4", "@babel/runtime@^7.8.7", "@babel/runtime@^7.9.2":
   version "7.11.2"
   resolved "https://registry.npmjs.org/@babel/runtime/-/runtime-7.11.2.tgz#f549c13c754cc40b87644b9fa9f09a6a95fe0736"
   integrity sha512-TeWkU52so0mPtDcaCTxNBI/IHiz0pZgr8VEFqXFtZWpYD08ZB6FaSwVAS8MKRQAP3bYKiVjwysOJgMFY28o6Tw==
@@ -5328,6 +5328,11 @@
   resolved "https://registry.npmjs.org/@types/qs/-/qs-6.9.4.tgz#a59e851c1ba16c0513ea123830dd639a0a15cb6a"
   integrity sha512-+wYo+L6ZF6BMoEjtf8zB2esQsqdV6WsjRK/GP9WOgLPrq87PbNWgIxS76dS5uvl/QXtHGakZmwTznIfcPXcKlQ==
 
+"@types/raf@^3.4.0":
+  version "3.4.0"
+  resolved "https://registry.npmjs.org/@types/raf/-/raf-3.4.0.tgz#2b72cbd55405e071f1c4d29992638e022b20acc2"
+  integrity sha512-taW5/WYqo36N7V39oYyHP9Ipfd5pNFvGTIQsNGj86xV88YQ7GnI30/yMfKDF7Zgin0m3e+ikX88FvImnK4RjGw==
+
 "@types/range-parser@*":
   version "1.2.3"
   resolved "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.3.tgz#7ee330ba7caafb98090bece86a5ee44115904c2c"
@@ -5999,11 +6004,6 @@ JSONStream@^1.0.4, JSONStream@^1.3.4:
     jsonparse "^1.2.0"
     through ">=2.2.7 <3"
 
-abab@^1.0.0:
-  version "1.0.4"
-  resolved "https://registry.npmjs.org/abab/-/abab-1.0.4.tgz#5faad9c2c07f60dd76770f71cf025b62a63cfd4e"
-  integrity sha1-X6rZwsB/YN12dw9xzwJbYqY8/U4=
-
 abab@^2.0.0, abab@^2.0.3:
   version "2.0.3"
   resolved "https://registry.npmjs.org/abab/-/abab-2.0.3.tgz#623e2075e02eb2d3f2475e49f99c91846467907a"
@@ -6027,13 +6027,6 @@ accepts@^1.3.5, accepts@~1.3.4, accepts@~1.3.5, accepts@~1.3.7:
     mime-types "~2.1.24"
     negotiator "0.6.2"
 
-acorn-globals@^1.0.4:
-  version "1.0.9"
-  resolved "https://registry.npmjs.org/acorn-globals/-/acorn-globals-1.0.9.tgz#55bb5e98691507b74579d0513413217c380c54cf"
-  integrity sha1-VbtemGkVB7dFedBRNBMhfDgMVM8=
-  dependencies:
-    acorn "^2.1.0"
-
 acorn-globals@^4.1.0:
   version "4.3.4"
   resolved "https://registry.npmjs.org/acorn-globals/-/acorn-globals-4.3.4.tgz#9fa1926addc11c97308c4e66d7add0d40c3272e7"
@@ -6065,11 +6058,6 @@ acorn-walk@^7.1.1:
   resolved "https://registry.npmjs.org/acorn-walk/-/acorn-walk-7.1.1.tgz#345f0dffad5c735e7373d2fec9a1023e6a44b83e"
   integrity sha512-wdlPY2tm/9XBr7QkKlq0WQVgiuGTX6YWPyRyBviSoScBuLfTVQhvwg6wJ369GJ/1nPfTLMfnrFIfjqVg6d+jQQ==
 
-acorn@^2.1.0, acorn@^2.4.0:
-  version "2.7.0"
-  resolved "https://registry.npmjs.org/acorn/-/acorn-2.7.0.tgz#ab6e7d9d886aaca8b085bc3312b79a198433f0e7"
-  integrity sha1-q259nYhqrKiwhbwzEreaGYQz8Oc=
-
 acorn@^5.5.3:
   version "5.7.4"
   resolved "https://registry.npmjs.org/acorn/-/acorn-5.7.4.tgz#3e8d8a9947d0599a1796d10225d7432f4a4acf5e"
@@ -7288,10 +7276,10 @@ balanced-match@^1.0.0:
   resolved "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz#89b4d199ab2bee49de164ea02b89ce462d71b767"
   integrity sha1-ibTRmasr7kneFk6gK4nORi1xt2c=
 
-base64-arraybuffer@^0.1.5:
-  version "0.1.5"
-  resolved "https://registry.npmjs.org/base64-arraybuffer/-/base64-arraybuffer-0.1.5.tgz#73926771923b5a19747ad666aa5cd4bf9c6e9ce8"
-  integrity sha1-c5JncZI7Whl0etZmqlzUv5xunOg=
+base64-arraybuffer@^0.2.0:
+  version "0.2.0"
+  resolved "https://registry.npmjs.org/base64-arraybuffer/-/base64-arraybuffer-0.2.0.tgz#4b944fac0191aa5907afe2d8c999ccc57ce80f45"
+  integrity sha512-7emyCsu1/xiBXgQZrscw/8KPRT44I4Yq9Pe6EGs3aPRTsWuggML1/1DTuZUuIaJPIm1FTDUVXl4x/yW8s0kQDQ==
 
 base64-js@^1.0.2, base64-js@^1.2.0:
   version "1.3.1"
@@ -7980,15 +7968,17 @@ canvas@^2.6.1:
     node-pre-gyp "^0.11.0"
     simple-get "^3.0.3"
 
-canvg@1.5.3:
-  version "1.5.3"
-  resolved "https://registry.npmjs.org/canvg/-/canvg-1.5.3.tgz#aad17915f33368bf8eb80b25d129e3ae922ddc5f"
-  integrity sha512-7Gn2IuQzvUQWPIuZuFHrzsTM0gkPz2RRT9OcbdmA03jeKk8kltrD8gqUzNX15ghY/4PV5bbe5lmD6yDLDY6Ybg==
+canvg@^3.0.6:
+  version "3.0.6"
+  resolved "https://registry.npmjs.org/canvg/-/canvg-3.0.6.tgz#4f82a34acc433daa06c494fc255420cbbb05f903"
+  integrity sha512-eFUy8R/4DgocR93LF8lr+YUxW4PYblUe/Q1gz2osk/cI5n8AsYdassvln0D9QPhLXQ6Lx7l8hwtT8FLvOn2Ihg==
   dependencies:
-    jsdom "^8.1.0"
+    "@babel/runtime" "^7.6.3"
+    "@types/raf" "^3.4.0"
+    core-js "3"
+    raf "^3.4.1"
     rgbcolor "^1.0.1"
-    stackblur-canvas "^1.4.1"
-    xmldom "^0.1.22"
+    stackblur-canvas "^2.0.0"
 
 capture-exit@^2.0.0:
   version "2.0.0"
@@ -8866,16 +8856,16 @@ core-js-pure@^3.0.0, core-js-pure@^3.0.1:
   resolved "https://registry.npmjs.org/core-js-pure/-/core-js-pure-3.6.4.tgz#4bf1ba866e25814f149d4e9aaa08c36173506e3a"
   integrity sha512-epIhRLkXdgv32xIUFaaAry2wdxZYBi6bgM7cB136dzzXXa+dFyRLTZeLUJxnd8ShrmyVXBub63n2NHo2JAt8Cw==
 
+core-js@3, core-js@^3.0.1, core-js@^3.0.4, core-js@^3.5.0, core-js@^3.6.0, core-js@^3.6.5:
+  version "3.6.5"
+  resolved "https://registry.npmjs.org/core-js/-/core-js-3.6.5.tgz#7395dc273af37fb2e50e9bd3d9fe841285231d1a"
+  integrity sha512-vZVEEwZoIsI+vPEuoF9Iqf5H7/M3eeQqWlQnYa8FSKKePuYTf5MWnxb5SDAzCa60b3JBRS5g9b+Dq7b1y/RCrA==
+
 core-js@^2.4.0, core-js@^2.4.1, core-js@^2.5.7, core-js@^2.6.10, core-js@^2.6.11, core-js@^2.6.5:
   version "2.6.11"
   resolved "https://registry.npmjs.org/core-js/-/core-js-2.6.11.tgz#38831469f9922bded8ee21c9dc46985e0399308c"
   integrity sha512-5wjnpaT/3dV+XB4borEsnAYQchn00XSgTAWKDkEqv+K8KevjbzmofK6hfJ9TZIlpj2N0xQpazy7PiRQiWHqzWg==
 
-core-js@^3.0.1, core-js@^3.0.4, core-js@^3.5.0, core-js@^3.6.5:
-  version "3.6.5"
-  resolved "https://registry.npmjs.org/core-js/-/core-js-3.6.5.tgz#7395dc273af37fb2e50e9bd3d9fe841285231d1a"
-  integrity sha512-vZVEEwZoIsI+vPEuoF9Iqf5H7/M3eeQqWlQnYa8FSKKePuYTf5MWnxb5SDAzCa60b3JBRS5g9b+Dq7b1y/RCrA==
-
 core-util-is@1.0.2, core-util-is@~1.0.0:
   version "1.0.2"
   resolved "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz#b5fd54220aa2bc5ab57aab7140c940754503c1a7"
@@ -9062,12 +9052,12 @@ css-in-js-utils@^2.0.0:
     hyphenate-style-name "^1.0.2"
     isobject "^3.0.1"
 
-css-line-break@1.0.1:
-  version "1.0.1"
-  resolved "https://registry.npmjs.org/css-line-break/-/css-line-break-1.0.1.tgz#19f2063a33e95fb2831b86446c0b80c188af450a"
-  integrity sha1-GfIGOjPpX7KDG4ZEbAuAwYivRQo=
+css-line-break@1.1.1:
+  version "1.1.1"
+  resolved "https://registry.npmjs.org/css-line-break/-/css-line-break-1.1.1.tgz#d5e9bdd297840099eb0503c7310fd34927a026ef"
+  integrity sha512-1feNVaM4Fyzdj4mKPIQNL2n70MmuYzAXZ1aytlROFX1JsOo070OsugwGjj7nl6jnDJWHDM8zRZswkmeYVWZJQA==
   dependencies:
-    base64-arraybuffer "^0.1.5"
+    base64-arraybuffer "^0.2.0"
 
 css-loader@^3.5.3:
   version "3.6.0"
@@ -9268,7 +9258,7 @@ csso@^4.0.2:
   dependencies:
     css-tree "1.0.0-alpha.37"
 
-cssom@0.3.x, "cssom@>= 0.3.0 < 0.4.0", "cssom@>= 0.3.2 < 0.4.0", cssom@~0.3.6:
+cssom@0.3.x, "cssom@>= 0.3.2 < 0.4.0", cssom@~0.3.6:
   version "0.3.8"
   resolved "https://registry.npmjs.org/cssom/-/cssom-0.3.8.tgz#9f1276f5b2b463f2114d3f2c75250af8c1a36f4a"
   integrity sha512-b0tGHbfegbhPJpxpiBPU2sCkigAqtM9O121le6bbOlgyV+NyGyCmVfJ6QW9eRjz8CpNfWEOYBIMIGRYkLwsIYg==
@@ -9278,13 +9268,6 @@ cssom@^0.4.4:
   resolved "https://registry.npmjs.org/cssom/-/cssom-0.4.4.tgz#5a66cf93d2d0b661d80bf6a44fb65f5c2e4e0a10"
   integrity sha512-p3pvU7r1MyyqbTk+WbNJIgJjG2VmTIaB10rI93LzVPrmDJKkzKYMtxxyAvQXR/NS6otuzveI7+7BBq3SjBS2mw==
 
-"cssstyle@>= 0.2.34 < 0.3.0":
-  version "0.2.37"
-  resolved "https://registry.npmjs.org/cssstyle/-/cssstyle-0.2.37.tgz#541097234cb2513c83ceed3acddc27ff27987d54"
-  integrity sha1-VBCXI0yyUTyDzu06zdwn/yeYfVQ=
-  dependencies:
-    cssom "0.3.x"
-
 cssstyle@^1.0.0:
   version "1.4.0"
   resolved "https://registry.npmjs.org/cssstyle/-/cssstyle-1.4.0.tgz#9d31328229d3c565c61e586b02041a28fccdccf1"
@@ -10092,6 +10075,11 @@ dompurify@^1.0.11:
   resolved "https://registry.npmjs.org/dompurify/-/dompurify-1.0.11.tgz#fe0f4a40d147f7cebbe31a50a1357539cfc1eb4d"
   integrity sha512-XywCTXZtc/qCX3iprD1pIklRVk/uhl8BKpkTxr+ZyMVUzSUg7wkQXRBp/euJ5J5moa1QvfpvaPQVP71z1O59dQ==
 
+dompurify@^2.0.12:
+  version "2.1.1"
+  resolved "https://registry.npmjs.org/dompurify/-/dompurify-2.1.1.tgz#b5aa988676b093a9c836d8b855680a8598af25fe"
+  integrity sha512-NijiNVkS/OL8mdQL1hUbCD6uty/cgFpmNiuFxrmJ5YPH2cXrPKIewoixoji56rbZ6XBPmtM8GA8/sf9unlSuwg==
+
 dompurify@^2.0.7:
   version "2.0.12"
   resolved "https://registry.npmjs.org/dompurify/-/dompurify-2.0.12.tgz#284a2b041e1c60b8e72d7b4d2fadad36141254ae"
@@ -10552,7 +10540,7 @@ escape-string-regexp@^1.0.2, escape-string-regexp@^1.0.5:
   resolved "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz#1b61c0562190a8dff6ae3bb2cf0200ca130b86d4"
   integrity sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=
 
-escodegen@^1.14.1, escodegen@^1.6.1, escodegen@^1.9.1:
+escodegen@^1.14.1, escodegen@^1.9.1:
   version "1.14.3"
   resolved "https://registry.npmjs.org/escodegen/-/escodegen-1.14.3.tgz#4e7b81fba61581dc97582ed78cab7f0e8d63f503"
   integrity sha512-qFcX0XJkdg+PB3xjZZG/wKSuT1PnQWx57+TVSjIMmILd2yC/6ByYElPwJnslDsuWuSAp4AwJGumarAAmJch5Kw==
@@ -11347,10 +11335,6 @@ file-loader@^6.0.0:
     loader-utils "^2.0.0"
     schema-utils "^2.7.1"
 
-file-saver@eligrey/FileSaver.js#1.3.8:
-  version "1.3.8"
-  resolved "https://codeload.github.com/eligrey/FileSaver.js/tar.gz/e865e37af9f9947ddcced76b549e27dc45c1cb2e"
-
 file-system-cache@^1.0.5:
   version "1.0.5"
   resolved "https://registry.npmjs.org/file-system-cache/-/file-system-cache-1.0.5.tgz#84259b36a2bbb8d3d6eb1021d3132ffe64cfff4f"
@@ -12795,12 +12779,12 @@ html-webpack-plugin@^4.2.1, html-webpack-plugin@^4.3.0:
     tapable "^1.1.3"
     util.promisify "1.0.0"
 
-html2canvas@1.0.0-alpha.12:
-  version "1.0.0-alpha.12"
-  resolved "https://registry.npmjs.org/html2canvas/-/html2canvas-1.0.0-alpha.12.tgz#3b1992e3c9b3f56063c35fd620494f37eba88513"
-  integrity sha1-OxmS48mz9WBjw1/WIElPN+uohRM=
+html2canvas@^1.0.0-rc.5:
+  version "1.0.0-rc.7"
+  resolved "https://registry.npmjs.org/html2canvas/-/html2canvas-1.0.0-rc.7.tgz#70c159ce0e63954a91169531894d08ad5627ac98"
+  integrity sha512-yvPNZGejB2KOyKleZspjK/NruXVQuowu8NnV2HYG7gW7ytzl+umffbtUI62v2dCHQLDdsK6HIDtyJZ0W3neerA==
   dependencies:
-    css-line-break "1.0.1"
+    css-line-break "1.1.1"
 
 htmlparser2@^3.3.0:
   version "3.10.1"
@@ -13009,7 +12993,7 @@ hyphenate-style-name@^1.0.2, hyphenate-style-name@^1.0.3:
   resolved "https://registry.npmjs.org/hyphenate-style-name/-/hyphenate-style-name-1.0.3.tgz#097bb7fa0b8f1a9cf0bd5c734cf95899981a9b48"
   integrity sha512-EcuixamT82oplpoJ2XU4pDtKGWQ7b00CD9f1ug9IaQ3p1bkHMiKCZ9ut9QDI6qsa6cpUuB+A/I+zLtdNK4n2DQ==
 
-iconv-lite@0.4.24, iconv-lite@^0.4.13, iconv-lite@^0.4.21, iconv-lite@^0.4.24, iconv-lite@^0.4.4, iconv-lite@~0.4.13:
+iconv-lite@0.4.24, iconv-lite@^0.4.21, iconv-lite@^0.4.24, iconv-lite@^0.4.4, iconv-lite@~0.4.13:
   version "0.4.24"
   resolved "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz#2022b4b25fbddc21d2f524974a474aafe733908b"
   integrity sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==
@@ -14538,29 +14522,6 @@ jsdom@^16.2.2:
     ws "^7.2.3"
     xml-name-validator "^3.0.0"
 
-jsdom@^8.1.0:
-  version "8.5.0"
-  resolved "https://registry.npmjs.org/jsdom/-/jsdom-8.5.0.tgz#d4d8f5dbf2768635b62a62823b947cf7071ebc98"
-  integrity sha1-1Nj12/J2hjW2KmKCO5R89wcevJg=
-  dependencies:
-    abab "^1.0.0"
-    acorn "^2.4.0"
-    acorn-globals "^1.0.4"
-    array-equal "^1.0.0"
-    cssom ">= 0.3.0 < 0.4.0"
-    cssstyle ">= 0.2.34 < 0.3.0"
-    escodegen "^1.6.1"
-    iconv-lite "^0.4.13"
-    nwmatcher ">= 1.3.7 < 2.0.0"
-    parse5 "^1.5.1"
-    request "^2.55.0"
-    sax "^1.1.4"
-    symbol-tree ">= 3.1.0 < 4.0.0"
-    tough-cookie "^2.2.0"
-    webidl-conversions "^3.0.1"
-    whatwg-url "^2.0.1"
-    xml-name-validator ">= 2.0.1 < 3.0.0"
-
 jsesc@^2.5.1:
   version "2.5.2"
   resolved "https://registry.npmjs.org/jsesc/-/jsesc-2.5.2.tgz#80564d2e483dacf6e8ef209650a67df3f0c283a4"
@@ -14759,22 +14720,23 @@ jsonwebtoken@^8.5.1:
     ms "^2.1.1"
     semver "^5.6.0"
 
-jspdf-autotable@3.5.3:
-  version "3.5.3"
-  resolved "https://registry.npmjs.org/jspdf-autotable/-/jspdf-autotable-3.5.3.tgz#2f73adb07f340e7dbf22950e3e6c8bf853991479"
-  integrity sha512-K+cNWW3x6w0R/1B5m6PYOm6v8CTTDXy/g32lZouc7SuC6zhvzMN2dauhk6dDYxPD0pky0oyPIJFwSJ/tV8PAeg==
+jspdf-autotable@3.5.9:
+  version "3.5.9"
+  resolved "https://registry.npmjs.org/jspdf-autotable/-/jspdf-autotable-3.5.9.tgz#8a625ef2aead44271da95e9f649843c401536925"
+  integrity sha512-ZRfiI5P7leJuWmvC0jGVXu227m68C2Jfz1dkDckshmDYDeVFCGxwIBYdCUXJ8Eb2CyFQC2ok82fEWO+xRDovDQ==
 
-jspdf@1.5.3:
-  version "1.5.3"
-  resolved "https://registry.npmjs.org/jspdf/-/jspdf-1.5.3.tgz#5a12c011479defabef5735de55c913060ed219f2"
-  integrity sha512-J9X76xnncMw+wIqb15HeWfPMqPwYxSpPY8yWPJ7rAZN/ZDzFkjCSZObryCyUe8zbrVRNiuCnIeQteCzMn7GnWw==
+jspdf@2.1.0:
+  version "2.1.0"
+  resolved "https://registry.npmjs.org/jspdf/-/jspdf-2.1.0.tgz#2322f8644bc41845b3abe20db4c3ca0adeadb84c"
+  integrity sha512-NQygqZEKhSw+nExySJxB72Ge/027YEyIM450Vh/hgay/H9cgZNnkXXOQPRspe9EuCW4sq92zg8hpAXyyBdnaIQ==
   dependencies:
-    canvg "1.5.3"
-    file-saver eligrey/FileSaver.js#1.3.8
-    html2canvas "1.0.0-alpha.12"
-    omggif "1.0.7"
-    promise-polyfill "8.1.0"
-    stackblur-canvas "2.2.0"
+    atob "^2.1.2"
+    btoa "^1.2.1"
+  optionalDependencies:
+    canvg "^3.0.6"
+    core-js "^3.6.0"
+    dompurify "^2.0.12"
+    html2canvas "^1.0.0-rc.5"
 
 jsprim@^1.2.2:
   version "1.4.1"
@@ -15762,10 +15724,10 @@ material-colors@^1.2.1:
   resolved "https://registry.npmjs.org/material-colors/-/material-colors-1.2.6.tgz#6d1958871126992ceecc72f4bcc4d8f010865f46"
   integrity sha512-6qE4B9deFBIa9YSpOc9O0Sgc43zTeVYbgDT5veRKSlB2+ZuHNoVVxA1L/ckMUayV9Ay9y7Z/SZCLcGteW9i7bg==
 
-material-table@1.68.0:
-  version "1.68.0"
-  resolved "https://registry.npmjs.org/material-table/-/material-table-1.68.0.tgz#275c3d9a885c40ae4bc5a7461c00e877f92397b9"
-  integrity sha512-dyJJaVsS3m+i6sn71AvYcVdA1P9X1XiUOM2PekfvEeeMtkdQb66oChGkk77ndYi3Ja6j4DovGVNrgeVLwXLZiw==
+material-table@^1.69.1:
+  version "1.69.1"
+  resolved "https://registry.npmjs.org/material-table/-/material-table-1.69.1.tgz#8d1c8b23207f18bd3328cae1b5775ede284682e6"
+  integrity sha512-7MA8kMtr8ToPE6gNUbOGIb4g+RGOLWK8s9gXZYNwFtg6fGAjWEJ+iqBrMmdq7fkMmTRcyOd7/sC/5OPPY8CNGg==
   dependencies:
     "@date-io/date-fns" "^1.1.0"
     "@material-ui/pickers" "^3.2.2"
@@ -15774,8 +15736,8 @@ material-table@1.68.0:
     debounce "^1.2.0"
     fast-deep-equal "2.0.1"
     filefy "0.1.10"
-    jspdf "1.5.3"
-    jspdf-autotable "3.5.3"
+    jspdf "2.1.0"
+    jspdf-autotable "3.5.9"
     prop-types "^15.6.2"
     react-beautiful-dnd "^13.0.0"
     react-double-scrollbar "0.0.15"
@@ -16836,11 +16798,6 @@ number-is-nan@^1.0.0:
   resolved "https://registry.npmjs.org/number-is-nan/-/number-is-nan-1.0.1.tgz#097b602b53422a522c1afb8790318336941a011d"
   integrity sha1-CXtgK1NCKlIsGvuHkDGDNpQaAR0=
 
-"nwmatcher@>= 1.3.7 < 2.0.0":
-  version "1.4.4"
-  resolved "https://registry.npmjs.org/nwmatcher/-/nwmatcher-1.4.4.tgz#2285631f34a95f0d0395cd900c96ed39b58f346e"
-  integrity sha512-3iuY4N5dhgMpCUrOVnuAdGrgxVqV2cJpM+XNccjR2DKOB1RUP0aA+wGXEiNziG/UKboFyGBIoKOaNlJxx8bciQ==
-
 nwsapi@^2.0.7, nwsapi@^2.2.0:
   version "2.2.0"
   resolved "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.0.tgz#204879a9e3d068ff2a55139c2c772780681a38b7"
@@ -17000,11 +16957,6 @@ oidc-token-hash@^5.0.0:
   resolved "https://registry.npmjs.org/oidc-token-hash/-/oidc-token-hash-5.0.0.tgz#acdfb1f4310f58e64d5d74a4e8671a426986e888"
   integrity sha512-8Yr4CZSv+Tn8ZkN3iN2i2w2G92mUKClp4z7EGUfdsERiYSbj7P4i/NHm72ft+aUdsiFx9UdIPSTwbyzQ6C4URg==
 
-omggif@1.0.7:
-  version "1.0.7"
-  resolved "https://registry.npmjs.org/omggif/-/omggif-1.0.7.tgz#59d2eecb0263de84635b3feb887c0c9973f1e49d"
-  integrity sha1-WdLuywJj3oRjWz/riHwMmXPx5J0=
-
 on-finished@^2.3.0, on-finished@~2.3.0:
   version "2.3.0"
   resolved "https://registry.npmjs.org/on-finished/-/on-finished-2.3.0.tgz#20f1336481b083cd75337992a16971aa2d906947"
@@ -17540,11 +17492,6 @@ parse5@5.1.1:
   resolved "https://registry.npmjs.org/parse5/-/parse5-5.1.1.tgz#f68e4e5ba1852ac2cadc00f4555fff6c2abb6178"
   integrity sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug==
 
-parse5@^1.5.1:
-  version "1.5.1"
-  resolved "https://registry.npmjs.org/parse5/-/parse5-1.5.1.tgz#9b7f3b0de32be78dc2401b17573ccaf0f6f59d94"
-  integrity sha1-m387DeMr543CQBsXVzzK8Pb1nZQ=
-
 parseurl@^1.3.2, parseurl@~1.3.2, parseurl@~1.3.3:
   version "1.3.3"
   resolved "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz#9da19e7bee8d12dff0513ed5b76957793bc2e8d4"
@@ -18597,11 +18544,6 @@ promise-inflight@^1.0.1:
   resolved "https://registry.npmjs.org/promise-inflight/-/promise-inflight-1.0.1.tgz#98472870bf228132fcbdd868129bad12c3c029e3"
   integrity sha1-mEcocL8igTL8vdhoEputEsPAKeM=
 
-promise-polyfill@8.1.0:
-  version "8.1.0"
-  resolved "https://registry.npmjs.org/promise-polyfill/-/promise-polyfill-8.1.0.tgz#30059da54d1358ce905ac581f287e184aedf995d"
-  integrity sha512-OzSf6gcCUQ01byV4BgwyUCswlaQQ6gzXc23aLQWhicvfX9kfsUiUhgt3CCQej8jDnl8/PhGF31JdHX2/MzF3WA==
-
 promise-polyfill@^8.1.3:
   version "8.1.3"
   resolved "https://registry.npmjs.org/promise-polyfill/-/promise-polyfill-8.1.3.tgz#8c99b3cf53f3a91c68226ffde7bde81d7f904116"
@@ -20074,7 +20016,7 @@ request-promise-native@^1.0.5, request-promise-native@^1.0.8:
     stealthy-require "^1.1.1"
     tough-cookie "^2.3.3"
 
-request@^2.55.0, request@^2.85.0, request@^2.87.0, request@^2.88.0, request@^2.88.2:
+request@^2.85.0, request@^2.87.0, request@^2.88.0, request@^2.88.2:
   version "2.88.2"
   resolved "https://registry.npmjs.org/request/-/request-2.88.2.tgz#d73c918731cb5a87da047e207234146f664d12b3"
   integrity sha512-MsvtOrfG9ZcrOwAW+Qi+F6HbD0CWXEh9ou77uOb7FM2WPhwT7smM833PzanhJLsgXjN89Ir6V2PczXNnMpwKhw==
@@ -20472,7 +20414,7 @@ sanitize-html@^1.27.0:
     srcset "^2.0.1"
     xtend "^4.0.1"
 
-sax@>=0.6.0, sax@^1.1.4, sax@^1.2.4, sax@~1.2.4:
+sax@>=0.6.0, sax@^1.2.4, sax@~1.2.4:
   version "1.2.4"
   resolved "https://registry.npmjs.org/sax/-/sax-1.2.4.tgz#2816234e2378bddc4e5354fab5caa895df7100d9"
   integrity sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw==
@@ -21238,15 +21180,10 @@ stack-utils@^2.0.2:
   dependencies:
     escape-string-regexp "^2.0.0"
 
-stackblur-canvas@2.2.0:
-  version "2.2.0"
-  resolved "https://registry.npmjs.org/stackblur-canvas/-/stackblur-canvas-2.2.0.tgz#cacc5924a0744b3e183eb2e6c1d8559c1a17c26e"
-  integrity sha512-5Gf8dtlf8k6NbLzuly2NkGrkS/Ahh+I5VUjO7TnFizdJtgpfpLLEdQlLe9umbcnZlitU84kfYjXE67xlSXfhfQ==
-
-stackblur-canvas@^1.4.1:
-  version "1.4.1"
-  resolved "https://registry.npmjs.org/stackblur-canvas/-/stackblur-canvas-1.4.1.tgz#849aa6f94b272ff26f6471fa4130ed1f7e47955b"
-  integrity sha1-hJqm+UsnL/JvZHH6QTDtH35HlVs=
+stackblur-canvas@^2.0.0:
+  version "2.4.0"
+  resolved "https://registry.npmjs.org/stackblur-canvas/-/stackblur-canvas-2.4.0.tgz#2b2eba910cb46f6feae918e1c402f863d602c01b"
+  integrity sha512-Z+HixfgYV0ss3C342DxPwc+UvN1SYWqoz7Wsi3xEDWEnaBkSCL3Ey21gF4io+WlLm8/RIrSnCrDBIEcH4O+q5Q==
 
 stackframe@^1.1.1:
   version "1.1.1"
@@ -21868,7 +21805,7 @@ symbol-observable@^1.0.4, symbol-observable@^1.1.0, symbol-observable@^1.2.0:
   resolved "https://registry.npmjs.org/symbol-observable/-/symbol-observable-1.2.0.tgz#c22688aed4eab3cdc2dfeacbb561660560a00804"
   integrity sha512-e900nM8RRtGhlV36KGEU9k65K3mPb1WV70OdjfxlG2EAuM1noi/E/BaW/uMhL7bPEssK8QV57vN3esixjUvcXQ==
 
-"symbol-tree@>= 3.1.0 < 4.0.0", symbol-tree@^3.2.2, symbol-tree@^3.2.4:
+symbol-tree@^3.2.2, symbol-tree@^3.2.4:
   version "3.2.4"
   resolved "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz#430637d248ba77e078883951fb9aa0eed7c63fa2"
   integrity sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==
@@ -22348,7 +22285,7 @@ touch@^3.1.0:
   dependencies:
     nopt "~1.0.10"
 
-tough-cookie@^2.2.0, tough-cookie@^2.3.3, tough-cookie@^2.3.4, tough-cookie@~2.5.0:
+tough-cookie@^2.3.3, tough-cookie@^2.3.4, tough-cookie@~2.5.0:
   version "2.5.0"
   resolved "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.5.0.tgz#cd9fb2a0aa1d5a12b473bd9fb96fa3dcff65ade2"
   integrity sha512-nlLsUzgm1kfLXSXfRZMc1KLAugd4hqJHDTvc2hDIwS3mZAfMEuMbc03SujMF+GEcpaX/qboeycw6iO8JwVv2+g==
@@ -22379,11 +22316,6 @@ tr46@^2.0.2:
   dependencies:
     punycode "^2.1.1"
 
-tr46@~0.0.3:
-  version "0.0.3"
-  resolved "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz#8184fd347dac9cdc185992f3a6622e14b9d9ab6a"
-  integrity sha1-gYT9NH2snNwYWZLzpmIuFLnZq2o=
-
 traverse@~0.6.6:
   version "0.6.6"
   resolved "https://registry.npmjs.org/traverse/-/traverse-0.6.6.tgz#cbdf560fd7b9af632502fed40f918c157ea97137"
@@ -23317,11 +23249,6 @@ webapi-parser@^0.5.0:
   dependencies:
     ajv "6.5.2"
 
-webidl-conversions@^3.0.0, webidl-conversions@^3.0.1:
-  version "3.0.1"
-  resolved "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz#24534275e2a7bc6be7bc86611cc16ae0a5654871"
-  integrity sha1-JFNCdeKnvGvnvIZhHMFq4KVlSHE=
-
 webidl-conversions@^4.0.2:
   version "4.0.2"
   resolved "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-4.0.2.tgz#a855980b1f0b6b359ba1d5d9fb39ae941faa63ad"
@@ -23524,14 +23451,6 @@ whatwg-mimetype@^2.1.0, whatwg-mimetype@^2.2.0, whatwg-mimetype@^2.3.0:
   resolved "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-2.3.0.tgz#3d4b1e0312d2079879f826aff18dbeeca5960fbf"
   integrity sha512-M4yMwr6mAnQz76TbJm914+gPpB/nCwvZbJU28cUD6dR004SAxDLOOSUaB1JDRqLtaOV/vi0IC5lEAGFgrjGv/g==
 
-whatwg-url@^2.0.1:
-  version "2.0.1"
-  resolved "https://registry.npmjs.org/whatwg-url/-/whatwg-url-2.0.1.tgz#5396b2043f020ee6f704d9c45ea8519e724de659"
-  integrity sha1-U5ayBD8CDub3BNnEXqhRnnJN5lk=
-  dependencies:
-    tr46 "~0.0.3"
-    webidl-conversions "^3.0.0"
-
 whatwg-url@^6.4.1:
   version "6.5.0"
   resolved "https://registry.npmjs.org/whatwg-url/-/whatwg-url-6.5.0.tgz#f2df02bff176fd65070df74ad5ccbb5a199965a8"
@@ -23846,11 +23765,6 @@ xml-encryption@^1.0.0:
     xmldom "~0.1.15"
     xpath "0.0.27"
 
-"xml-name-validator@>= 2.0.1 < 3.0.0":
-  version "2.0.1"
-  resolved "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-2.0.1.tgz#4d8b8f1eccd3419aa362061becef515e1e559635"
-  integrity sha1-TYuPHszTQZqjYgYb7O9RXh5VljU=
-
 xml-name-validator@^3.0.0:
   version "3.0.0"
   resolved "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-3.0.0.tgz#6ae73e06de4d8c6e47f9fb181f78d648ad457c6a"
@@ -23879,7 +23793,7 @@ xmldom@0.1.27:
   resolved "https://registry.npmjs.org/xmldom/-/xmldom-0.1.27.tgz#d501f97b3bdb403af8ef9ecc20573187aadac0e9"
   integrity sha1-1QH5ezvbQDr4757MIFcxh6rawOk=
 
-xmldom@0.1.x, xmldom@^0.1.22, xmldom@~0.1.15:
+xmldom@0.1.x, xmldom@~0.1.15:
   version "0.1.31"
   resolved "https://registry.npmjs.org/xmldom/-/xmldom-0.1.31.tgz#b76c9a1bd9f0a9737e5a72dc37231cf38375e2ff"
   integrity sha512-yS2uJflVQs6n+CyjHoaBmVSqIDevTAWrzMmjG1Gc7h1qQ7uVozNhEPJAwZXWyGQ/Gafo3fCwrcaokezLPupVyQ==

From c1de0de4bd63f2fdb96f3507f6d721ec946cf712 Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Wed, 7 Oct 2020 15:54:18 +0200
Subject: [PATCH 072/110] Delete backstage_overview.png (#2783)

---
 backstage_overview.png | Bin 254842 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 backstage_overview.png

diff --git a/backstage_overview.png b/backstage_overview.png
deleted file mode 100644
index ae32ae66282b8120a6dc7b8283af8d0a30e885f3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 254842
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


From 108ce379493e8a7a805b1501a696dd79ebe1dadd Mon Sep 17 00:00:00 2001
From: James Wen <jameswen@spotify.com>
Date: Wed, 7 Oct 2020 10:21:40 -0400
Subject: [PATCH 073/110] Allow for Kubernetes cluster authentication via
 google auth (#2691)

* Allow for Kubernetes cluster authentication via google auth

- For the kubernetes and kubernetes-backend plugins
  - The kubernetes (front-end) plugin uses the googleAuthApi and goes
    through oauth flow to fetch a Google auth token for the current user
    and pass that in a request to the kubernetes-backend plugin, which
    uses this token as the service account token (and hence as the
    authentication token for making K8s API requests).
- Related to https://github.com/spotify/backstage/issues/2552

* Use KubernetesAuthProvider and KubernetesAuthTranslator interfaces for K8s auth

- Implementations of KubernetesAuthProvider decorate the bodies of requests (for
  Kubernetes resources) sent from the kubernetes plugin (frontend) to the
  kubernetes-backend plugin (backend) with whatever information is
  needed for K8s authentication
- Implementations of KubernetesAuthTranslator take the contents of these request
  bodies sent from the kubernetes plugin (frontend) to the kubernetes-backend plugin
  (backend) and use specific values in the bodies to properly set up tokens for K8s auth
- Start with KubernetesAuthProvider + KubernetesAuthTranslator
  implementations for 'serviceAccount' and 'google' as auth providers
- Implementation of what was proposed at https://github.com/spotify/backstage/issues/2552#issuecomment-702545382
- Load in and prepare KubernetesAuthProvider implementations at plugin
  startup time via KubernetesAuthProviders API (that essentially stores
  or wraps these KubernetesAuthProvider instances)
- Related to https://github.com/spotify/backstage/issues/2552
---
 .../MultiTenantConfigClusterLocator.test.ts   | 11 +++-
 .../MultiTenantConfigClusterLocator.ts        |  3 +
 .../src/cluster-locator/types.ts              |  1 +
 .../GoogleKubernetesAuthTranslator.ts         | 41 +++++++++++++
 .../KubernetesAuthTranslatorGenerator.test.ts | 46 +++++++++++++++
 .../KubernetesAuthTranslatorGenerator.ts      | 39 +++++++++++++
 .../ServiceAccountKubernetesAuthTranslator.ts | 31 ++++++++++
 .../src/kubernetes-auth-translator/types.ts   | 24 ++++++++
 .../service/KubernetesClientProvider.test.ts  |  6 ++
 .../src/service/KubernetesFetcher.test.ts     |  9 ++-
 ...ubernetesObjectsByServiceIdHandler.test.ts |  9 +++
 .../getKubernetesObjectsByServiceIdHandler.ts | 30 ++++++++--
 .../src/service/router.test.ts                | 35 ++++++++++--
 .../kubernetes-backend/src/service/router.ts  | 11 +++-
 plugins/kubernetes-backend/src/types/types.ts | 10 +++-
 plugins/kubernetes/package.json               |  1 +
 .../src/api/KubernetesBackendClient.ts        | 21 +++++--
 plugins/kubernetes/src/api/types.ts           | 10 +++-
 .../KubernetesContent/KubernetesContent.tsx   | 46 ++++++++++++---
 .../GoogleKubernetesAuthProvider.ts           | 41 +++++++++++++
 .../KubernetesAuthProviders.ts                | 57 +++++++++++++++++++
 .../ServiceAccountKubernetesAuthProvider.ts   | 28 +++++++++
 .../src/kubernetes-auth-provider/types.ts     | 38 +++++++++++++
 plugins/kubernetes/src/plugin.ts              | 10 ++++
 24 files changed, 524 insertions(+), 34 deletions(-)
 create mode 100644 plugins/kubernetes-backend/src/kubernetes-auth-translator/GoogleKubernetesAuthTranslator.ts
 create mode 100644 plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.test.ts
 create mode 100644 plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.ts
 create mode 100644 plugins/kubernetes-backend/src/kubernetes-auth-translator/ServiceAccountKubernetesAuthTranslator.ts
 create mode 100644 plugins/kubernetes-backend/src/kubernetes-auth-translator/types.ts
 create mode 100644 plugins/kubernetes/src/kubernetes-auth-provider/GoogleKubernetesAuthProvider.ts
 create mode 100644 plugins/kubernetes/src/kubernetes-auth-provider/KubernetesAuthProviders.ts
 create mode 100644 plugins/kubernetes/src/kubernetes-auth-provider/ServiceAccountKubernetesAuthProvider.ts
 create mode 100644 plugins/kubernetes/src/kubernetes-auth-provider/types.ts

diff --git a/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.test.ts b/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.test.ts
index 34788d16cb..dd77a11bae 100644
--- a/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.test.ts
+++ b/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.test.ts
@@ -43,6 +43,7 @@ describe('MultiTenantConfigClusterLocator', () => {
           {
             name: 'cluster1',
             url: 'http://localhost:8080',
+            authProvider: 'serviceAccount',
           },
         ],
       },
@@ -60,6 +61,7 @@ describe('MultiTenantConfigClusterLocator', () => {
         name: 'cluster1',
         serviceAccountToken: undefined,
         url: 'http://localhost:8080',
+        authProvider: 'serviceAccount',
       },
     ]);
   });
@@ -70,13 +72,14 @@ describe('MultiTenantConfigClusterLocator', () => {
         clusters: [
           {
             name: 'cluster1',
-            serviceAccountToken: undefined,
+            serviceAccountToken: 'token',
             url: 'http://localhost:8080',
+            authProvider: 'serviceAccount',
           },
           {
             name: 'cluster2',
-            serviceAccountToken: undefined,
             url: 'http://localhost:8081',
+            authProvider: 'google',
           },
         ],
       },
@@ -92,13 +95,15 @@ describe('MultiTenantConfigClusterLocator', () => {
     expect(result).toStrictEqual([
       {
         name: 'cluster1',
-        serviceAccountToken: undefined,
+        serviceAccountToken: 'token',
         url: 'http://localhost:8080',
+        authProvider: 'serviceAccount',
       },
       {
         name: 'cluster2',
         serviceAccountToken: undefined,
         url: 'http://localhost:8081',
+        authProvider: 'google',
       },
     ]);
   });
diff --git a/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.ts b/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.ts
index 3d9e2dd8b4..5a1f0f3839 100644
--- a/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.ts
+++ b/plugins/kubernetes-backend/src/cluster-locator/MultiTenantConfigClusterLocator.ts
@@ -28,12 +28,15 @@ export class MultiTenantConfigClusterLocator
   }
 
   static fromConfig(config: Config[]): MultiTenantConfigClusterLocator {
+    // TODO: Add validation that authProvider is required and serviceAccountToken
+    // is required if authProvider is serviceAccount
     return new MultiTenantConfigClusterLocator(
       config.map(c => {
         return {
           name: c.getString('name'),
           url: c.getString('url'),
           serviceAccountToken: c.getOptionalString('serviceAccountToken'),
+          authProvider: c.getString('authProvider'),
         };
       }),
     );
diff --git a/plugins/kubernetes-backend/src/cluster-locator/types.ts b/plugins/kubernetes-backend/src/cluster-locator/types.ts
index 9b793da558..dae8eb6d60 100644
--- a/plugins/kubernetes-backend/src/cluster-locator/types.ts
+++ b/plugins/kubernetes-backend/src/cluster-locator/types.ts
@@ -15,3 +15,4 @@
  */
 
 export type ClusterLocatorMethod = 'configMultiTenant' | 'http';
+export type AuthProviderType = 'google' | 'serviceAccount';
diff --git a/plugins/kubernetes-backend/src/kubernetes-auth-translator/GoogleKubernetesAuthTranslator.ts b/plugins/kubernetes-backend/src/kubernetes-auth-translator/GoogleKubernetesAuthTranslator.ts
new file mode 100644
index 0000000000..7f9b2f0bae
--- /dev/null
+++ b/plugins/kubernetes-backend/src/kubernetes-auth-translator/GoogleKubernetesAuthTranslator.ts
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { KubernetesAuthTranslator } from './types';
+import { AuthRequestBody, ClusterDetails } from '../types/types';
+
+export class GoogleKubernetesAuthTranslator
+  implements KubernetesAuthTranslator {
+  async decorateClusterDetailsWithAuth(
+    clusterDetails: ClusterDetails,
+    requestBody: AuthRequestBody,
+  ): Promise<ClusterDetails> {
+    const clusterDetailsWithAuthToken: ClusterDetails = Object.assign(
+      {},
+      clusterDetails,
+    );
+    const authToken: string | undefined = requestBody.auth?.google;
+
+    if (authToken) {
+      clusterDetailsWithAuthToken.serviceAccountToken = authToken;
+    } else {
+      throw new Error(
+        'Google token not found under auth.google in request body',
+      );
+    }
+    return clusterDetailsWithAuthToken;
+  }
+}
diff --git a/plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.test.ts b/plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.test.ts
new file mode 100644
index 0000000000..3b27eb012a
--- /dev/null
+++ b/plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.test.ts
@@ -0,0 +1,46 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { KubernetesAuthTranslator } from './types';
+import { GoogleKubernetesAuthTranslator } from './GoogleKubernetesAuthTranslator';
+import { KubernetesAuthTranslatorGenerator } from './KubernetesAuthTranslatorGenerator';
+import { ServiceAccountKubernetesAuthTranslator } from './ServiceAccountKubernetesAuthTranslator';
+
+describe('getKubernetesAuthTranslatorInstance', () => {
+  const sut = KubernetesAuthTranslatorGenerator;
+
+  it('can return an auth translator for google auth', () => {
+    const authTranslator: KubernetesAuthTranslator = sut.getKubernetesAuthTranslatorInstance(
+      'google',
+    );
+    expect(authTranslator instanceof GoogleKubernetesAuthTranslator).toBe(true);
+  });
+
+  it('can return an auth translator for serviceAccount auth', () => {
+    const authTranslator: KubernetesAuthTranslator = sut.getKubernetesAuthTranslatorInstance(
+      'serviceAccount',
+    );
+    expect(
+      authTranslator instanceof ServiceAccountKubernetesAuthTranslator,
+    ).toBe(true);
+  });
+
+  it('throws an error when asked for an auth translator for an unsupported auth type', () => {
+    expect(() => sut.getKubernetesAuthTranslatorInstance('linode')).toThrow(
+      'authProvider "linode" has no KubernetesAuthTranslator associated with it',
+    );
+  });
+});
diff --git a/plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.ts b/plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.ts
new file mode 100644
index 0000000000..f7cfc92112
--- /dev/null
+++ b/plugins/kubernetes-backend/src/kubernetes-auth-translator/KubernetesAuthTranslatorGenerator.ts
@@ -0,0 +1,39 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { KubernetesAuthTranslator } from './types';
+import { GoogleKubernetesAuthTranslator } from './GoogleKubernetesAuthTranslator';
+import { ServiceAccountKubernetesAuthTranslator } from './ServiceAccountKubernetesAuthTranslator';
+
+export class KubernetesAuthTranslatorGenerator {
+  static getKubernetesAuthTranslatorInstance(
+    authProvider: String,
+  ): KubernetesAuthTranslator {
+    switch (authProvider) {
+      case 'google': {
+        return new GoogleKubernetesAuthTranslator();
+      }
+      case 'serviceAccount': {
+        return new ServiceAccountKubernetesAuthTranslator();
+      }
+      default: {
+        throw new Error(
+          `authProvider "${authProvider}" has no KubernetesAuthTranslator associated with it`,
+        );
+      }
+    }
+  }
+}
diff --git a/plugins/kubernetes-backend/src/kubernetes-auth-translator/ServiceAccountKubernetesAuthTranslator.ts b/plugins/kubernetes-backend/src/kubernetes-auth-translator/ServiceAccountKubernetesAuthTranslator.ts
new file mode 100644
index 0000000000..ecf2f12b72
--- /dev/null
+++ b/plugins/kubernetes-backend/src/kubernetes-auth-translator/ServiceAccountKubernetesAuthTranslator.ts
@@ -0,0 +1,31 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { KubernetesAuthTranslator } from './types';
+import { AuthRequestBody, ClusterDetails } from '../types/types';
+
+export class ServiceAccountKubernetesAuthTranslator
+  implements KubernetesAuthTranslator {
+  async decorateClusterDetailsWithAuth(
+    clusterDetails: ClusterDetails,
+    // To ignore TS6133 linting error where it detects 'requestBody' is declared but its value is never read.
+    // @ts-ignore-start
+    requestBody: AuthRequestBody, // eslint-disable-line @typescript-eslint/no-unused-vars
+    // @ts-ignore-end
+  ): Promise<ClusterDetails> {
+    return clusterDetails;
+  }
+}
diff --git a/plugins/kubernetes-backend/src/kubernetes-auth-translator/types.ts b/plugins/kubernetes-backend/src/kubernetes-auth-translator/types.ts
new file mode 100644
index 0000000000..f89e04456f
--- /dev/null
+++ b/plugins/kubernetes-backend/src/kubernetes-auth-translator/types.ts
@@ -0,0 +1,24 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { AuthRequestBody, ClusterDetails } from '../types/types';
+
+export interface KubernetesAuthTranslator {
+  decorateClusterDetailsWithAuth(
+    clusterDetails: ClusterDetails,
+    requestBody: AuthRequestBody,
+  ): Promise<ClusterDetails>;
+}
diff --git a/plugins/kubernetes-backend/src/service/KubernetesClientProvider.test.ts b/plugins/kubernetes-backend/src/service/KubernetesClientProvider.test.ts
index a3dc67716a..409d41b783 100644
--- a/plugins/kubernetes-backend/src/service/KubernetesClientProvider.test.ts
+++ b/plugins/kubernetes-backend/src/service/KubernetesClientProvider.test.ts
@@ -33,6 +33,7 @@ describe('KubernetesClientProvider', () => {
       name: 'cluster-name',
       url: 'http://localhost:9999',
       serviceAccountToken: 'TOKEN',
+      authProvider: 'serviceAccount',
     });
 
     expect(result.basePath).toBe('http://localhost:9999');
@@ -55,12 +56,14 @@ describe('KubernetesClientProvider', () => {
       name: 'cluster-name',
       url: 'http://localhost:9999',
       serviceAccountToken: 'TOKEN',
+      authProvider: 'serviceAccount',
     });
 
     const result2 = sut.getCoreClientByClusterDetails({
       name: 'cluster-name',
       url: 'http://localhost:9999',
       serviceAccountToken: 'TOKEN',
+      authProvider: 'serviceAccount',
     });
 
     expect(result1.basePath).toBe('http://localhost:9999');
@@ -89,6 +92,7 @@ describe('KubernetesClientProvider', () => {
       name: 'cluster-name',
       url: 'http://localhost:9999',
       serviceAccountToken: 'TOKEN',
+      authProvider: 'serviceAccount',
     });
 
     expect(result.basePath).toBe('http://localhost:9999');
@@ -111,12 +115,14 @@ describe('KubernetesClientProvider', () => {
       name: 'cluster-name',
       url: 'http://localhost:9999',
       serviceAccountToken: 'TOKEN',
+      authProvider: 'serviceAccount',
     });
 
     const result2 = sut.getAppsClientByClusterDetails({
       name: 'cluster-name',
       url: 'http://localhost:9999',
       serviceAccountToken: 'TOKEN',
+      authProvider: 'serviceAccount',
     });
 
     expect(result1.basePath).toBe('http://localhost:9999');
diff --git a/plugins/kubernetes-backend/src/service/KubernetesFetcher.test.ts b/plugins/kubernetes-backend/src/service/KubernetesFetcher.test.ts
index 8f390f309b..6294b3a7ed 100644
--- a/plugins/kubernetes-backend/src/service/KubernetesFetcher.test.ts
+++ b/plugins/kubernetes-backend/src/service/KubernetesFetcher.test.ts
@@ -62,7 +62,8 @@ describe('KubernetesClientProvider', () => {
       {
         name: 'cluster1',
         url: 'http://localhost:9999',
-        serviceAccountToken: undefined,
+        serviceAccountToken: 'token',
+        authProvider: 'serviceAccount',
       },
       new Set(['pods', 'services']),
     );
@@ -124,7 +125,8 @@ describe('KubernetesClientProvider', () => {
       {
         name: 'cluster1',
         url: 'http://localhost:9999',
-        serviceAccountToken: undefined,
+        serviceAccountToken: 'token',
+        authProvider: 'serviceAccount',
       },
       new Set(['pods', 'services']),
     );
@@ -172,7 +174,8 @@ describe('KubernetesClientProvider', () => {
         {
           name: 'cluster1',
           url: 'http://localhost:9999',
-          serviceAccountToken: undefined,
+          serviceAccountToken: 'token',
+          authProvider: 'serviceAccount',
         },
         new Set<any>(['foo']),
       ),
diff --git a/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.test.ts b/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.test.ts
index 56da3235cc..4218c64e80 100644
--- a/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.test.ts
+++ b/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.test.ts
@@ -74,6 +74,7 @@ describe('handleGetKubernetesObjectsByServiceId', () => {
       Promise.resolve([
         {
           name: 'test-cluster',
+          authProvider: 'serviceAccount',
         },
       ]),
     );
@@ -89,6 +90,7 @@ describe('handleGetKubernetesObjectsByServiceId', () => {
         getClusterByServiceId,
       },
       getVoidLogger(),
+      {},
     );
 
     expect(getClusterByServiceId.mock.calls.length).toBe(1);
@@ -142,9 +144,11 @@ describe('handleGetKubernetesObjectsByServiceId', () => {
       Promise.resolve([
         {
           name: 'test-cluster',
+          authProvider: 'serviceAccount',
         },
         {
           name: 'other-cluster',
+          authProvider: 'google',
         },
       ]),
     );
@@ -160,6 +164,11 @@ describe('handleGetKubernetesObjectsByServiceId', () => {
         getClusterByServiceId,
       },
       getVoidLogger(),
+      {
+        auth: {
+          google: 'google_token_123',
+        },
+      },
     );
 
     expect(getClusterByServiceId.mock.calls.length).toBe(1);
diff --git a/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.ts b/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.ts
index 1690b8be40..f0b21cbc0c 100644
--- a/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.ts
+++ b/plugins/kubernetes-backend/src/service/getKubernetesObjectsByServiceIdHandler.ts
@@ -16,17 +16,22 @@
 
 import { Logger } from 'winston';
 import {
+  AuthRequestBody,
+  ClusterDetails,
   KubernetesClusterLocator,
   KubernetesFetcher,
   KubernetesObjectTypes,
   ObjectsByServiceIdResponse,
-} from '..';
+} from '../types/types';
+import { KubernetesAuthTranslator } from '../kubernetes-auth-translator/types';
+import { KubernetesAuthTranslatorGenerator } from '../kubernetes-auth-translator/KubernetesAuthTranslatorGenerator';
 
 export type GetKubernetesObjectsByServiceIdHandler = (
   serviceId: string,
   fetcher: KubernetesFetcher,
   clusterLocator: KubernetesClusterLocator,
   logger: Logger,
+  requestBody: AuthRequestBody,
   objectsToFetch?: Set<KubernetesObjectTypes>,
 ) => Promise<ObjectsByServiceIdResponse>;
 
@@ -46,18 +51,35 @@ export const handleGetKubernetesObjectsByServiceId: GetKubernetesObjectsByServic
   fetcher,
   clusterLocator,
   logger,
+  requestBody,
   objectsToFetch = DEFAULT_OBJECTS,
 ) => {
-  const clusterDetails = await clusterLocator.getClusterByServiceId(serviceId);
+  const clusterDetails: ClusterDetails[] = await clusterLocator.getClusterByServiceId(
+    serviceId,
+  );
+
+  // Execute all of these async actions simultaneously/without blocking sequentially as no common object is modified by them
+  const promises: Promise<ClusterDetails>[] = clusterDetails.map(cd => {
+    const kubernetesAuthTranslator: KubernetesAuthTranslator = KubernetesAuthTranslatorGenerator.getKubernetesAuthTranslatorInstance(
+      cd.authProvider,
+    );
+    return kubernetesAuthTranslator.decorateClusterDetailsWithAuth(
+      cd,
+      requestBody,
+    );
+  });
+  const clusterDetailsDecoratedForAuth: ClusterDetails[] = await Promise.all(
+    promises,
+  );
 
   logger.info(
-    `serviceId=${serviceId} clusterDetails=[${clusterDetails
+    `serviceId=${serviceId} clusterDetails=[${clusterDetailsDecoratedForAuth
       .map(c => c.name)
       .join(', ')}]`,
   );
 
   return Promise.all(
-    clusterDetails.map(cd => {
+    clusterDetailsDecoratedForAuth.map(cd => {
       return fetcher
         .fetchObjectsByServiceId(serviceId, cd, objectsToFetch)
         .then(result => {
diff --git a/plugins/kubernetes-backend/src/service/router.test.ts b/plugins/kubernetes-backend/src/service/router.test.ts
index 7731fe9abb..4e9a206eb4 100644
--- a/plugins/kubernetes-backend/src/service/router.test.ts
+++ b/plugins/kubernetes-backend/src/service/router.test.ts
@@ -54,8 +54,8 @@ describe('router', () => {
     jest.resetAllMocks();
   });
 
-  describe('GET /services/:serviceId', () => {
-    it('happy path: lists kubernetes objects', async () => {
+  describe('post /services/:serviceId', () => {
+    it('happy path: lists kubernetes objects without auth in request body', async () => {
       const result = {
         clusterOne: {
           pods: [
@@ -69,7 +69,34 @@ describe('router', () => {
       } as any;
       handleGetByServiceId.mockReturnValueOnce(Promise.resolve(result));
 
-      const response = await request(app).get('/services/test-service');
+      const response = await request(app).post('/services/test-service');
+
+      expect(response.status).toEqual(200);
+      expect(response.body).toEqual(result);
+    });
+
+    it('happy path: lists kubernetes objects with auth in request body', async () => {
+      const result = {
+        clusterOne: {
+          pods: [
+            {
+              metadata: {
+                name: 'pod1',
+              },
+            },
+          ],
+        },
+      } as any;
+      handleGetByServiceId.mockReturnValueOnce(Promise.resolve(result));
+
+      const response = await request(app)
+        .post('/services/test-service')
+        .send({
+          auth: {
+            google: 'google_token_123',
+          },
+        })
+        .set('Content-Type', 'application/json');
 
       expect(response.status).toEqual(200);
       expect(response.body).toEqual(result);
@@ -78,7 +105,7 @@ describe('router', () => {
     it('internal error: lists kubernetes objects', async () => {
       handleGetByServiceId.mockRejectedValue(Error('some internal error'));
 
-      const response = await request(app).get('/services/test-service');
+      const response = await request(app).post('/services/test-service');
 
       expect(response.status).toEqual(500);
       expect(response.body).toEqual({ error: 'some internal error' });
diff --git a/plugins/kubernetes-backend/src/service/router.ts b/plugins/kubernetes-backend/src/service/router.ts
index bdb14bb74d..9e9b4ab2f5 100644
--- a/plugins/kubernetes-backend/src/service/router.ts
+++ b/plugins/kubernetes-backend/src/service/router.ts
@@ -26,7 +26,11 @@ import {
   GetKubernetesObjectsByServiceIdHandler,
   handleGetKubernetesObjectsByServiceId,
 } from './getKubernetesObjectsByServiceIdHandler';
-import { KubernetesClusterLocator, KubernetesFetcher } from '..';
+import {
+  AuthRequestBody,
+  KubernetesClusterLocator,
+  KubernetesFetcher,
+} from '../types/types';
 
 export interface RouterOptions {
   logger: Logger;
@@ -62,15 +66,16 @@ export const makeRouter = (
   router.use(express.json());
 
   // TODO error handling
-  router.get('/services/:serviceId', async (req, res) => {
+  router.post('/services/:serviceId', async (req, res) => {
     const serviceId = req.params.serviceId;
-
+    const requestBody: AuthRequestBody = req.body;
     try {
       const response = await handleGetByServiceId(
         serviceId,
         fetcher,
         clusterLocator,
         logger,
+        requestBody,
       );
       res.send(response);
     } catch (e) {
diff --git a/plugins/kubernetes-backend/src/types/types.ts b/plugins/kubernetes-backend/src/types/types.ts
index 0cb42eec1a..eb2817f268 100644
--- a/plugins/kubernetes-backend/src/types/types.ts
+++ b/plugins/kubernetes-backend/src/types/types.ts
@@ -27,8 +27,14 @@ import {
 export interface ClusterDetails {
   name: string;
   url: string;
-  // TODO this will eventually be configured by the auth translation work
-  serviceAccountToken: string | undefined;
+  authProvider: string;
+  serviceAccountToken?: string | undefined;
+}
+
+export interface AuthRequestBody {
+  auth?: {
+    google?: string;
+  };
 }
 
 export interface ClusterObjects {
diff --git a/plugins/kubernetes/package.json b/plugins/kubernetes/package.json
index 5dc9231c2a..2adefebbd6 100644
--- a/plugins/kubernetes/package.json
+++ b/plugins/kubernetes/package.json
@@ -21,6 +21,7 @@
   },
   "dependencies": {
     "@backstage/catalog-model": "^0.1.1-alpha.24",
+    "@backstage/config": "^0.1.1-alpha.24",
     "@backstage/core": "^0.1.1-alpha.24",
     "@backstage/plugin-kubernetes-backend": "^0.1.1-alpha.24",
     "@backstage/theme": "^0.1.1-alpha.24",
diff --git a/plugins/kubernetes/src/api/KubernetesBackendClient.ts b/plugins/kubernetes/src/api/KubernetesBackendClient.ts
index cbb3b03a38..86bb830046 100644
--- a/plugins/kubernetes/src/api/KubernetesBackendClient.ts
+++ b/plugins/kubernetes/src/api/KubernetesBackendClient.ts
@@ -16,7 +16,10 @@
 
 import { DiscoveryApi } from '@backstage/core';
 import { KubernetesApi } from './types';
-import { ObjectsByServiceIdResponse } from '@backstage/plugin-kubernetes-backend';
+import {
+  AuthRequestBody,
+  ObjectsByServiceIdResponse,
+} from '@backstage/plugin-kubernetes-backend';
 
 export class KubernetesBackendClient implements KubernetesApi {
   private readonly discoveryApi: DiscoveryApi;
@@ -25,9 +28,18 @@ export class KubernetesBackendClient implements KubernetesApi {
     this.discoveryApi = options.discoveryApi;
   }
 
-  private async getRequired(path: string): Promise<any> {
+  private async getRequired(
+    path: string,
+    requestBody: AuthRequestBody,
+  ): Promise<any> {
     const url = `${await this.discoveryApi.getBaseUrl('kubernetes')}${path}`;
-    const response = await fetch(url);
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(requestBody),
+    });
 
     if (!response.ok) {
       const payload = await response.text();
@@ -40,7 +52,8 @@ export class KubernetesBackendClient implements KubernetesApi {
 
   async getObjectsByServiceId(
     serviceId: String,
+    requestBody: AuthRequestBody,
   ): Promise<ObjectsByServiceIdResponse> {
-    return await this.getRequired(`/services/${serviceId}`);
+    return await this.getRequired(`/services/${serviceId}`, requestBody);
   }
 }
diff --git a/plugins/kubernetes/src/api/types.ts b/plugins/kubernetes/src/api/types.ts
index 5ec3cda6f8..8e44d58e6a 100644
--- a/plugins/kubernetes/src/api/types.ts
+++ b/plugins/kubernetes/src/api/types.ts
@@ -15,7 +15,10 @@
  */
 
 import { createApiRef } from '@backstage/core';
-import { ObjectsByServiceIdResponse } from '@backstage/plugin-kubernetes-backend';
+import {
+  AuthRequestBody,
+  ObjectsByServiceIdResponse,
+} from '@backstage/plugin-kubernetes-backend';
 
 export const kubernetesApiRef = createApiRef<KubernetesApi>({
   id: 'plugin.kubernetes.service',
@@ -24,5 +27,8 @@ export const kubernetesApiRef = createApiRef<KubernetesApi>({
 });
 
 export interface KubernetesApi {
-  getObjectsByServiceId(serviceId: String): Promise<ObjectsByServiceIdResponse>;
+  getObjectsByServiceId(
+    serviceId: String,
+    requestBody: AuthRequestBody,
+  ): Promise<ObjectsByServiceIdResponse>;
 }
diff --git a/plugins/kubernetes/src/components/KubernetesContent/KubernetesContent.tsx b/plugins/kubernetes/src/components/KubernetesContent/KubernetesContent.tsx
index 6119884c43..013c7ad002 100644
--- a/plugins/kubernetes/src/components/KubernetesContent/KubernetesContent.tsx
+++ b/plugins/kubernetes/src/components/KubernetesContent/KubernetesContent.tsx
@@ -16,8 +16,10 @@
 
 import React, { ReactElement, useEffect, useState } from 'react';
 import { Grid, TabProps } from '@material-ui/core';
+import { Config } from '@backstage/config';
 import {
   CardTab,
+  configApiRef,
   Content,
   Page,
   pageTheme,
@@ -28,10 +30,12 @@ import {
 import { Entity } from '@backstage/catalog-model';
 import { kubernetesApiRef } from '../../api/types';
 import {
+  AuthRequestBody,
   ClusterObjects,
   FetchResponse,
   ObjectsByServiceIdResponse,
 } from '@backstage/plugin-kubernetes-backend';
+import { kubernetesAuthProvidersApiRef } from '../../kubernetes-auth-provider/types';
 import { DeploymentTables } from '../DeploymentTables';
 import { DeploymentTriple } from '../../types/types';
 import {
@@ -105,16 +109,40 @@ export const KubernetesContent = ({ entity }: KubernetesContentProps) => {
   >(undefined);
   const [error, setError] = useState<string | undefined>(undefined);
 
+  const configApi = useApi(configApiRef);
+  const clusters: Config[] = configApi.getConfigArray('kubernetes.clusters');
+  const allAuthProviders: string[] = clusters.map(c =>
+    c.getString('authProvider'),
+  );
+  const authProviders: string[] = [...new Set(allAuthProviders)];
+
+  const kubernetesAuthProvidersApi = useApi(kubernetesAuthProvidersApiRef);
+
   useEffect(() => {
-    kubernetesApi
-      .getObjectsByServiceId(entity.metadata.name)
-      .then(result => {
-        setKubernetesObjects(result);
-      })
-      .catch(e => {
-        setError(e.message);
-      });
-  }, [entity.metadata.name, kubernetesApi]);
+    (async () => {
+      // For each auth type, invoke decorateRequestBodyForAuth on corresponding KubernetesAuthProvider
+      let requestBody: AuthRequestBody = {};
+      for (const authProviderStr of authProviders) {
+        // Multiple asyncs done sequentially instead of all at once to prevent same requestBody from being modified simultaneously
+        requestBody = await kubernetesAuthProvidersApi.decorateRequestBodyForAuth(
+          authProviderStr,
+          requestBody,
+        );
+      }
+
+      // TODO: Add validation on contents/format of requestBody
+      kubernetesApi
+        .getObjectsByServiceId(entity.metadata.name, requestBody)
+        .then(result => {
+          setKubernetesObjects(result);
+        })
+        .catch(e => {
+          setError(e.message);
+        });
+    })();
+    /* eslint-disable react-hooks/exhaustive-deps */
+  }, [entity.metadata.name, kubernetesApi, kubernetesAuthProvidersApi]);
+  /* eslint-enable react-hooks/exhaustive-deps */
 
   const clustersWithErrors =
     kubernetesObjects?.items.filter(r => r.errors.length > 0) ?? [];
diff --git a/plugins/kubernetes/src/kubernetes-auth-provider/GoogleKubernetesAuthProvider.ts b/plugins/kubernetes/src/kubernetes-auth-provider/GoogleKubernetesAuthProvider.ts
new file mode 100644
index 0000000000..7de5c7c0a9
--- /dev/null
+++ b/plugins/kubernetes/src/kubernetes-auth-provider/GoogleKubernetesAuthProvider.ts
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { OAuthApi } from '@backstage/core';
+import { KubernetesAuthProvider } from './types';
+import { AuthRequestBody } from '@backstage/plugin-kubernetes-backend';
+
+export class GoogleKubernetesAuthProvider implements KubernetesAuthProvider {
+  authProvider: OAuthApi;
+
+  constructor(authProvider: OAuthApi) {
+    this.authProvider = authProvider;
+  }
+
+  async decorateRequestBodyForAuth(
+    requestBody: AuthRequestBody,
+  ): Promise<AuthRequestBody> {
+    const googleAuthToken: string = await this.authProvider.getAccessToken(
+      'https://www.googleapis.com/auth/cloud-platform',
+    );
+    if ('auth' in requestBody) {
+      requestBody.auth!.google = googleAuthToken;
+    } else {
+      requestBody.auth = { google: googleAuthToken };
+    }
+    return requestBody;
+  }
+}
diff --git a/plugins/kubernetes/src/kubernetes-auth-provider/KubernetesAuthProviders.ts b/plugins/kubernetes/src/kubernetes-auth-provider/KubernetesAuthProviders.ts
new file mode 100644
index 0000000000..ac909d6695
--- /dev/null
+++ b/plugins/kubernetes/src/kubernetes-auth-provider/KubernetesAuthProviders.ts
@@ -0,0 +1,57 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { OAuthApi } from '@backstage/core';
+import { AuthRequestBody } from '@backstage/plugin-kubernetes-backend';
+import { KubernetesAuthProvider, KubernetesAuthProvidersApi } from './types';
+import { GoogleKubernetesAuthProvider } from './GoogleKubernetesAuthProvider';
+import { ServiceAccountKubernetesAuthProvider } from './ServiceAccountKubernetesAuthProvider';
+
+export class KubernetesAuthProviders implements KubernetesAuthProvidersApi {
+  private readonly kubernetesAuthProviderMap: Map<
+    string,
+    KubernetesAuthProvider
+  >;
+
+  constructor(options: { googleAuthApi: OAuthApi }) {
+    this.kubernetesAuthProviderMap = new Map<string, KubernetesAuthProvider>();
+    this.kubernetesAuthProviderMap.set(
+      'google',
+      new GoogleKubernetesAuthProvider(options.googleAuthApi),
+    );
+    this.kubernetesAuthProviderMap.set(
+      'serviceAccount',
+      new ServiceAccountKubernetesAuthProvider(),
+    );
+  }
+
+  async decorateRequestBodyForAuth(
+    authProvider: string,
+    requestBody: AuthRequestBody,
+  ): Promise<AuthRequestBody> {
+    const kubernetesAuthProvider:
+      | KubernetesAuthProvider
+      | undefined = this.kubernetesAuthProviderMap.get(authProvider);
+    if (kubernetesAuthProvider) {
+      return await kubernetesAuthProvider.decorateRequestBodyForAuth(
+        requestBody,
+      );
+    }
+    throw new Error(
+      `authProvider "${authProvider}" has no KubernetesAuthProvider defined for it`,
+    );
+  }
+}
diff --git a/plugins/kubernetes/src/kubernetes-auth-provider/ServiceAccountKubernetesAuthProvider.ts b/plugins/kubernetes/src/kubernetes-auth-provider/ServiceAccountKubernetesAuthProvider.ts
new file mode 100644
index 0000000000..3ac5a9494b
--- /dev/null
+++ b/plugins/kubernetes/src/kubernetes-auth-provider/ServiceAccountKubernetesAuthProvider.ts
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { KubernetesAuthProvider } from './types';
+import { AuthRequestBody } from '@backstage/plugin-kubernetes-backend';
+
+export class ServiceAccountKubernetesAuthProvider
+  implements KubernetesAuthProvider {
+  async decorateRequestBodyForAuth(
+    requestBody: AuthRequestBody,
+  ): Promise<AuthRequestBody> {
+    // No-op, with service account for auth, cluster config/details should already have serviceAccountToken
+    return requestBody;
+  }
+}
diff --git a/plugins/kubernetes/src/kubernetes-auth-provider/types.ts b/plugins/kubernetes/src/kubernetes-auth-provider/types.ts
new file mode 100644
index 0000000000..24fee0f94c
--- /dev/null
+++ b/plugins/kubernetes/src/kubernetes-auth-provider/types.ts
@@ -0,0 +1,38 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { createApiRef } from '@backstage/core';
+import { AuthRequestBody } from '@backstage/plugin-kubernetes-backend';
+
+export interface KubernetesAuthProvider {
+  decorateRequestBodyForAuth(
+    requestBody: AuthRequestBody,
+  ): Promise<AuthRequestBody>;
+}
+
+export const kubernetesAuthProvidersApiRef = createApiRef<
+  KubernetesAuthProvidersApi
+>({
+  id: 'plugin.kubernetes-auth-providers.service',
+  description: 'Used by the Kubernetes plugin to fetch KubernetesAuthProviders',
+});
+
+export interface KubernetesAuthProvidersApi {
+  decorateRequestBodyForAuth(
+    authProvider: string,
+    requestBody: AuthRequestBody,
+  ): Promise<AuthRequestBody>;
+}
diff --git a/plugins/kubernetes/src/plugin.ts b/plugins/kubernetes/src/plugin.ts
index b7ad9615f5..cff9e1468b 100644
--- a/plugins/kubernetes/src/plugin.ts
+++ b/plugins/kubernetes/src/plugin.ts
@@ -18,9 +18,12 @@ import {
   createPlugin,
   createRouteRef,
   discoveryApiRef,
+  googleAuthApiRef,
 } from '@backstage/core';
 import { KubernetesBackendClient } from './api/KubernetesBackendClient';
 import { kubernetesApiRef } from './api/types';
+import { kubernetesAuthProvidersApiRef } from './kubernetes-auth-provider/types';
+import { KubernetesAuthProviders } from './kubernetes-auth-provider/KubernetesAuthProviders';
 
 export const rootCatalogKubernetesRouteRef = createRouteRef({
   path: '*',
@@ -36,5 +39,12 @@ export const plugin = createPlugin({
       factory: ({ discoveryApi }) =>
         new KubernetesBackendClient({ discoveryApi }),
     }),
+    createApiFactory({
+      api: kubernetesAuthProvidersApiRef,
+      deps: { googleAuthApi: googleAuthApiRef },
+      factory: ({ googleAuthApi }) => {
+        return new KubernetesAuthProviders({ googleAuthApi });
+      },
+    }),
   ],
 });

From 52c4cfc257ae25c04056427db4c84fefc2362aff Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Wed, 7 Oct 2020 11:30:43 +0200
Subject: [PATCH 074/110] Update Readme

---
 plugins/user-settings/README.md | 35 ++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/plugins/user-settings/README.md b/plugins/user-settings/README.md
index 72da278b1e..db0b01681f 100644
--- a/plugins/user-settings/README.md
+++ b/plugins/user-settings/README.md
@@ -6,27 +6,41 @@ _This plugin was created through the Backstage CLI_
 
 ## About the plugin
 
-This plugin is intended to be used within the [`<Sidebar>`](https://backstage.io/storybook/?path=/story/sidebar--sample-sidebar). It provides an item to the sidebar that will render an Avatar of the current signed in user, and when clicked display a settings UI where the user can control different settings across the App.
+This plugin provides two components, `<UserSettings />` is intended to be used within the [`<Sidebar>`](https://backstage.io/storybook/?path=/story/sidebar--sample-sidebar) and displays the signed-in users profile picture and name.
+
+The second component is a settings page where the user can control different settings across the App.
 
 ## Usage
 
-Add the component to the sidebar:
+Add the item to the Sidebar:
 
 ```ts
-import { UserSettings } from '@backstage/plugin-user-settings';
+import { Settings as SidebarSettings } from '@backstage/plugin-user-settings';
 
 <SidebarPage>
   <Sidebar>
-    <UserSettings />
+    <SidebarSettings />
   </Sidebar>
 </SidebarPage>;
 ```
 
+Add the page to the App routing:
+
+```ts
+import { Router as SettingsRouter } from '@backstage/plugin-user-settings';
+
+const AppRoutes = () => (
+  <Routes>
+    <Route path="/settings" element={<SettingsRouter />} />
+  </Routes>
+);
+```
+
 ### Props
 
 **Auth Providers**
 
-By default, the plugin provides a list of configured authentication providers is fetched from `app-config.yaml` and displayed in the "Auth Providers" tab.
+By default, the plugin provides a list of configured authentication providers fetched from `app-config.yaml` and displayed in the "Authentication Providers" tab.
 
 If you want to supply your own custom list of Authentication Providers, use the `providerSettings` prop:
 
@@ -34,11 +48,18 @@ If you want to supply your own custom list of Authentication Providers, use the
 const MyAuthProviders = () => (
   <ListItem>
     <ListItemText primary="example" />
-    <ListItemSecondaryAction={someAction}>
+    <ListItemSecondaryAction>{someAction}</ListItemSecondaryAction>
   </ListItem>
 );
 
-<UserSettings providerSettings={<MyAuthProviders />} />
+const AppRoutes = () => (
+  <Routes>
+    <Route
+      path="/settings"
+      element={<SettingsRouter providerSettings={<MyAuthProviders />} />}
+    />
+  </Routes>
+);
 ```
 
 > **Note that the list of providers expects to be rendered within a MUI [`<List>`](https://material-ui.com/components/lists/)**

From eaa5275ac2bf828e52ce068377e6f85bb2514676 Mon Sep 17 00:00:00 2001
From: Matthew Clarke <matthewclarke47@gmail.com>
Date: Wed, 7 Oct 2020 15:49:49 +0100
Subject: [PATCH 075/110] update kubernetes readmes (#2781)

---
 .github/styles/vocab.txt                      |  3 +
 plugins/kubernetes-backend/README.md          | 64 ++++++++++++++++++-
 .../examples/dice-roller/README.md            | 12 ++--
 plugins/kubernetes/README.md                  | 21 ++++++
 4 files changed, 93 insertions(+), 7 deletions(-)

diff --git a/.github/styles/vocab.txt b/.github/styles/vocab.txt
index 21045f04dd..c9774ae237 100644
--- a/.github/styles/vocab.txt
+++ b/.github/styles/vocab.txt
@@ -32,6 +32,7 @@ Codehilite
 codeowners
 config
 Config
+configmaps
 configs
 const
 cookiecutter
@@ -67,6 +68,7 @@ graphviz
 Hackathons
 haproxy
 heroku
+horizontalpodautoscalers
 Hostname
 http
 https
@@ -140,6 +142,7 @@ rankdir
 readme
 Readme
 Redash
+replicasets
 repo
 Repo
 repos
diff --git a/plugins/kubernetes-backend/README.md b/plugins/kubernetes-backend/README.md
index 0246da24ed..fbbde1fe65 100644
--- a/plugins/kubernetes-backend/README.md
+++ b/plugins/kubernetes-backend/README.md
@@ -6,6 +6,66 @@ This is the backend part of the Kubernetes plugin.
 
 It responds to Kubernetes requests from the frontend.
 
-## Links
+## Configuration
 
-- [The Backstage homepage](https://backstage.io)
+### clusterLocatorMethod
+
+This configures how to determine which clusters a component is running in.
+
+Currently, the only valid locator method is:
+
+#### configMultiTenant
+
+This configuration assumes that all components run on all the provided clusters.
+
+Example:
+
+```yaml
+kubernetes:
+  clusterLocatorMethod: 'configMultiTenant'
+  clusters:
+    - url: http://127.0.0.1:9999
+      name: minikube
+      serviceAccountToken: <TOKEN FROM STEP 4>
+      authProvider: 'serviceAccount'
+    - url: http://127.0.0.2:9999
+      name: gke-cluster-1
+      authProvider: 'google'
+```
+
+##### clusters
+
+Used by the `configMultiTenant` `clusterLocatorMethod` to construct Kubernetes clients.
+
+###### url
+
+The base url to the Kubernetes control plane. Can be found by using the `Kubernetes master` result from running the `kubectl cluster-info` command.
+
+###### name
+
+A name to represent this cluster, this must be unique within the `clusters` array. Users will see this value in the Service Catalog Kubernetes plugin.
+
+###### authProvider
+
+This determines how the Kubernetes client authenticate with the Kubernetes cluster. Valid values are:
+
+| Value            | Description                                                                                                                                                                                                                       |
+| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `serviceAccount` | This will use a Kubernetes [service account](https://kubernetes.io/docs/reference/access-authn-authz/service-accounts-admin/) to access the Kubernetes API. When this is used the `serviceAccountToken` field should also be set. |
+| `google`         | This will use a user's google auth token from the [google auth plugin](https://backstage.io/docs/auth/) to access the Kubernetes API.                                                                                             |
+
+###### serviceAccount (optional)
+
+The service account token to be used when using the `authProvider`, `serviceAccount`.
+
+## RBAC
+
+The current RBAC permissions required are read-only cluster wide, for the following objects:
+
+- pods
+- services
+- configmaps
+- deployments
+- replicasets
+- horizontalpodautoscalers
+- ingresses
diff --git a/plugins/kubernetes-backend/examples/dice-roller/README.md b/plugins/kubernetes-backend/examples/dice-roller/README.md
index 47fc345c73..f97f760c9f 100644
--- a/plugins/kubernetes-backend/examples/dice-roller/README.md
+++ b/plugins/kubernetes-backend/examples/dice-roller/README.md
@@ -1,6 +1,6 @@
 # Dice roller
 
-An app to roll dice (it doesn't actually do that).
+This can be used to run the kubernetes plugin locally against a mock service.
 
 # Viewing in local Minikube running Backstage locally
 
@@ -23,22 +23,24 @@ An app to roll dice (it doesn't actually do that).
 6. Register existing component in Backstage
    - https://github.com/mclarke47/dice-roller/blob/master/catalog-info.yaml
 
-Update `app-config.yaml` as follows.
+Update `app-config.development.yaml` as follows.
 
 ```yaml
----
 kubernetes:
   clusterLocatorMethod: 'configMultiTenant'
   clusters:
     - url: <KUBERNETES MASTER BASE URL FROM STEP 2>
       name: minikube
       serviceAccountToken: <TOKEN FROM STEP 4>
+      authProvider: 'serviceAccount'
 ```
 
 ### Getting the service account token
 
+Mac copy to clipboard:
+
 ```
-kubectl get secret DICE_ROLLER_TOKEN_NAME -o=json | jq -r '.data["token"]' | base64 --decode | pbcopy
+kubectl get secret $(kubectl get sa dice-roller -o=json | jq -r .secrets[0].name) -o=json | jq -r '.data["token"]' | base64 --decode | pbcopy
 ```
 
-Paste into `app-config.yaml` `kubernetes.clusters[].serviceAccountToken`
+Paste into `app-config.development.yaml` `kubernetes.clusters[0].serviceAccountToken`
diff --git a/plugins/kubernetes/README.md b/plugins/kubernetes/README.md
index 678c9a96a6..1ad478bd89 100644
--- a/plugins/kubernetes/README.md
+++ b/plugins/kubernetes/README.md
@@ -11,3 +11,24 @@ Your plugin has been added to the example app in this repository, meaning you'll
 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.
+
+## Surfacing your Kubernetes components as part of an entity
+
+### Adding the entity annotation
+
+In order for Backstage to detect that an entity has Kubernetes components,
+the following annotation should be added to the entity.
+
+```yaml
+annotations:
+  'backstage.io/kubernetes-id': dice-roller
+```
+
+### Labeling Kubernetes components
+
+In order for Kubernetes components to show up in the service catalog
+as a part of an entity, Kubernetes components must be labeled with the following label:
+
+```yaml
+'backstage.io/kubernetes-id': <ENTITY_NAME>
+```

From 8ca12579875e5bd3df21e8920e6e423ac4f02ef0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Stefan=20=C3=85lund?= <alund@spotify.com>
Date: Wed, 7 Oct 2020 19:14:45 +0200
Subject: [PATCH 076/110] Update noInformation.svg

---
 .../components/EmptyState/assets/noInformation.svg    | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/packages/core/src/components/EmptyState/assets/noInformation.svg b/packages/core/src/components/EmptyState/assets/noInformation.svg
index a36ce59d32..c199cf8b13 100644
--- a/packages/core/src/components/EmptyState/assets/noInformation.svg
+++ b/packages/core/src/components/EmptyState/assets/noInformation.svg
@@ -1,10 +1 @@
-<svg width="677" height="503" viewBox="0 0 677 503" fill="none" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-<path fill-rule="evenodd" clip-rule="evenodd" d="M52.0998 178.88C39.4837 181.231 31.1621 193.364 33.513 205.98C35.864 218.596 47.9972 226.918 60.6133 224.567L77.9953 221.328C73.1555 226.536 70.7597 233.89 72.1622 241.417C74.5131 254.033 86.6463 262.354 99.2624 260.003L223.015 236.943C223.026 237.007 223.037 237.072 223.048 237.136C223.063 237.221 223.078 237.306 223.094 237.392C224.497 244.918 229.381 250.916 235.772 254.031L228.178 255.446C215.562 257.797 207.24 269.931 209.591 282.547C211.942 295.163 224.075 303.484 236.691 301.133L597.377 233.922C609.993 231.571 618.315 219.438 615.964 206.822C614.561 199.295 609.677 193.298 603.287 190.182L615.435 187.918C628.051 185.567 636.373 173.434 634.022 160.818C631.671 148.202 619.537 139.88 606.921 142.231L390.586 182.544C390.561 182.395 390.535 182.245 390.507 182.095C389.104 174.569 384.22 168.571 377.829 165.456L398.833 161.542C411.449 159.191 419.77 147.058 417.42 134.442C415.069 121.825 402.935 113.504 390.319 115.855L52.0998 178.88ZM70.4109 359.463C68.06 346.847 76.3816 334.714 88.9977 332.363L459.118 263.393C471.734 261.043 483.867 269.364 486.218 281.98C488.569 294.596 480.247 306.73 467.631 309.08L457.032 311.055C458.269 311.659 459.45 312.37 460.56 313.179L588.816 289.279C601.432 286.928 613.565 295.25 615.916 307.866C617.319 315.392 614.923 322.747 610.083 327.955L612.666 327.474C625.282 325.123 637.415 333.444 639.766 346.061C642.117 358.677 633.796 370.81 621.18 373.161L236.71 444.804C224.094 447.155 211.961 438.833 209.61 426.217C207.259 413.601 215.581 401.468 228.197 399.117L256.271 393.886C255.034 393.283 253.853 392.571 252.743 391.762L81.6065 423.652C68.9904 426.003 56.8571 417.682 54.5062 405.066C52.1553 392.45 60.4769 380.316 73.093 377.965L83.0883 376.103C76.6973 372.987 71.8134 366.989 70.4109 359.463Z" fill="black" fill-opacity="0.05"/>
-<rect x="91.6917" y="95.4753" width="488" height="313" fill="url(#pattern0)"/>
-<defs>
-<pattern id="pattern0" patternContentUnits="objectBoundingBox" width="1" height="1">
-<use xlink:href="#image0" transform="translate(0 -0.000237323) scale(0.00124844 0.00194645)"/>
-</pattern>
-<image id="image0" width="801" height="514" xlink:href="data:image/png;base64,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"/>
-</defs>
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="267" height="172" fill="none" viewBox="0 0 267 172"><g filter="url(#filter0_d)"><rect width="139" height="104.906" x="10" y="50.165" fill="#EEE" rx="5"/></g><mask id="mask0" width="121" height="98" x="19" y="58" mask-type="alpha" maskUnits="userSpaceOnUse"><rect width="9.179" height="70.156" x="19.835" y="85.571" fill="#fff" rx="4.59"/><rect width="9.179" height="78.679" x="38.194" y="77.047" fill="#fff" rx="4.59"/><rect width="9.179" height="97.693" x="56.552" y="58.033" fill="#fff" rx="4.59"/><rect width="9.179" height="81.957" x="74.91" y="73.769" fill="#fff" rx="4.59"/><rect width="9.179" height="60.321" x="93.269" y="95.406" fill="#fff" rx="4.59"/><rect width="9.179" height="74.09" x="111.627" y="81.637" fill="#fff" rx="4.59"/><rect width="9.179" height="93.104" x="129.986" y="62.623" fill="#fff" rx="4.59"/></mask><g mask="url(#mask0)"><rect width="139" height="100.316" x="10.656" y="50.165" fill="#C4C4C4"/></g><g filter="url(#filter1_d)"><rect width="144" height="108.679" x="109" y="8" fill="#EEE" rx="5"/></g><path fill="#D9D9D9" d="M173.85 62.1192C144.607 37.3215 129.993 65.1991 120.077 80.5984V106.585H241.923V25.7384C208.172 24.5834 212.569 94.9538 173.85 62.1192Z"/><path stroke="#9E9E9E" stroke-linecap="round" stroke-linejoin="round" d="M120.077 80.5984C129.993 65.1991 144.607 37.3215 173.85 62.1192C212.569 94.9539 208.172 24.5834 241.923 25.7384"/><defs><filter id="filter0_d" width="163" height="128.906" x="0" y="42.165" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dx="2" dy="4"/><feGaussianBlur stdDeviation="6"/><feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="BackgroundImageFix" mode="normal" result="effect1_dropShadow"/><feBlend in="SourceGraphic" in2="effect1_dropShadow" mode="normal" result="shape"/></filter><filter id="filter1_d" width="168" height="132.679" x="99" y="0" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/><feOffset dx="2" dy="4"/><feGaussianBlur stdDeviation="6"/><feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/><feBlend in2="BackgroundImageFix" mode="normal" result="effect1_dropShadow"/><feBlend in="SourceGraphic" in2="effect1_dropShadow" mode="normal" result="shape"/></filter></defs></svg>

From 2220c3f801618a4c4e4b356cae90f95394a75903 Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Wed, 7 Oct 2020 14:47:12 -0400
Subject: [PATCH 077/110] Configure builder config to include sourcemaps

---
 packages/cli/src/lib/builder/config.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/cli/src/lib/builder/config.ts b/packages/cli/src/lib/builder/config.ts
index 2566460494..2e7847fdb1 100644
--- a/packages/cli/src/lib/builder/config.ts
+++ b/packages/cli/src/lib/builder/config.ts
@@ -64,6 +64,7 @@ export const makeConfigs = async (
         entryFileNames: 'index.cjs.js',
         chunkFileNames: 'cjs/[name]-[hash].js',
         format: 'commonjs',
+        sourcemap: true,
       });
     }
     if (options.outputs.has(Output.esm)) {
@@ -72,6 +73,7 @@ export const makeConfigs = async (
         entryFileNames: 'index.esm.js',
         chunkFileNames: 'esm/[name]-[hash].js',
         format: 'module',
+        sourcemap: true,
       });
       // Assume we're building for the browser if ESM output is included
       mainFields.unshift('browser');

From cba4e4d970224ec45211c1f682971548423e5204 Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Wed, 7 Oct 2020 14:51:25 -0400
Subject: [PATCH 078/110] Add changeset

---
 .changeset/loud-lamps-visit.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/loud-lamps-visit.md

diff --git a/.changeset/loud-lamps-visit.md b/.changeset/loud-lamps-visit.md
new file mode 100644
index 0000000000..73618e18f9
--- /dev/null
+++ b/.changeset/loud-lamps-visit.md
@@ -0,0 +1,5 @@
+---
+'@backstage/cli': minor
+---
+
+Including source maps with all packages

From f05e4b96086e7761fb9c0bb071abefd4e1536b09 Mon Sep 17 00:00:00 2001
From: Marvin9 <marvinduff97@gmail.com>
Date: Thu, 8 Oct 2020 10:34:06 +0530
Subject: [PATCH 079/110] re: make consistent environment variables
 GITHUB_PRIVATE_TOKEN & GITHUB_ACCESS_TOKEN => GITHUB_TOKEN
 GITLAB_PRIVATE_TOKEN, GITLAB_ACCESS_TOKEN & SCAFFOLDER_GITLAB_PRIVATE_TOKEN
 => GITLAB_TOKEN AZURE_PRIVATE_TOKEN => AZURE_TOKEN GHE_PRIVATE_TOKEN =>
 GHE_TOKEN

---
 app-config.yaml                               | 20 +++++++++----------
 .../extending/create-your-own-publisher.md    |  2 +-
 .../software-templates/installation.md        |  8 ++++----
 .../templates/default-app/app-config.yaml.hbs |  6 +++---
 packages/e2e-test/src/e2e-test.ts             |  4 ++--
 .../techdocs-backend/src/default-branch.ts    |  4 ++--
 plugins/techdocs-backend/src/helpers.ts       |  4 +---
 7 files changed, 23 insertions(+), 25 deletions(-)

diff --git a/app-config.yaml b/app-config.yaml
index d670771a31..228eafc588 100644
--- a/app-config.yaml
+++ b/app-config.yaml
@@ -67,21 +67,21 @@ integrations:
   github:
     - host: github.com
       token:
-        $env: GITHUB_PRIVATE_TOKEN
+        $env: GITHUB_TOKEN
     ### Example for how to add your GitHub Enterprise instance using the API:
     # - host: ghe.example.net
     #   apiBaseUrl: https://ghe.example.net/api/v3
     #   token:
-    #     $env: GHE_PRIVATE_TOKEN
+    #     $env: GHE_TOKEN
     ### Example for how to add your GitHub Enterprise instance using raw HTTP fetches (token is optional):
     # - host: ghe.example.net
     #   rawBaseUrl: https://ghe.example.net/raw
     #   token:
-    #     $env: GHE_PRIVATE_TOKEN
+    #     $env: GHE_TOKEN
   gitlab:
     - host: gitlab.com
       token:
-        $env: GITLAB_PRIVATE_TOKEN
+        $env: GITLAB_TOKEN
   bitbucket:
     - host: bitbucket.org
       username:
@@ -91,7 +91,7 @@ integrations:
   azure:
     - host: dev.azure.com
       token:
-        $env: AZURE_PRIVATE_TOKEN
+        $env: AZURE_TOKEN
 
 catalog:
   rules:
@@ -102,12 +102,12 @@ catalog:
       providers:
         - target: https://github.com
           token:
-            $env: GITHUB_PRIVATE_TOKEN
+            $env: GITHUB_TOKEN
         #### Example for how to add your GitHub Enterprise instance using the API:
         # - target: https://ghe.example.net
         #   apiBaseUrl: https://ghe.example.net/api/v3
         #   token:
-        #     $env: GHE_PRIVATE_TOKEN
+        #     $env: GHE_TOKEN
     ldapOrg:
       ### Example for how to add your enterprise LDAP server
       # providers:
@@ -146,18 +146,18 @@ catalog:
 scaffolder:
   github:
     token:
-      $env: GITHUB_ACCESS_TOKEN
+      $env: GITHUB_TOKEN
     visibility: public # or 'internal' or 'private'
   gitlab:
     api:
       baseUrl: https://gitlab.com
       token:
-        $env: GITLAB_ACCESS_TOKEN
+        $env: GITLAB_TOKEN
   azure:
     baseUrl: https://dev.azure.com/{your-organization}
     api:
       token:
-        $env: AZURE_PRIVATE_TOKEN
+        $env: AZURE_TOKEN
 
 auth:
   providers:
diff --git a/docs/features/software-templates/extending/create-your-own-publisher.md b/docs/features/software-templates/extending/create-your-own-publisher.md
index ecb097f9d9..546980f033 100644
--- a/docs/features/software-templates/extending/create-your-own-publisher.md
+++ b/docs/features/software-templates/extending/create-your-own-publisher.md
@@ -34,7 +34,7 @@ import { Octokit } from '@octokit/rest';
 import type { PluginEnvironment } from '../types';
 
 export default async function createPlugin({ logger }: PluginEnvironment) {
-  const githubClient = new Octokit({ auth: process.env.GITHUB_ACCESS_TOKEN });
+  const githubClient = new Octokit({ auth: process.env.GITHUB_TOKEN });
   const publisher = new GithubPublisher({ client: githubClient });
 
   return await createRouter({
diff --git a/docs/features/software-templates/installation.md b/docs/features/software-templates/installation.md
index 60f73ad0c3..838c5e2d11 100644
--- a/docs/features/software-templates/installation.md
+++ b/docs/features/software-templates/installation.md
@@ -232,13 +232,13 @@ instance:
 scaffolder:
   github:
     token:
-      $env: GITHUB_ACCESS_TOKEN
+      $env: GITHUB_TOKEN
     visibility: public # or 'internal' or 'private'
   gitlab:
     api:
       baseUrl: https://gitlab.com
       token:
-        $env: SCAFFOLDER_GITLAB_PRIVATE_TOKEN
+        $env: GITLAB_TOKEN
 ```
 
 #### Azure DevOps
@@ -255,7 +255,7 @@ scaffolder:
     baseUrl: https://dev.azure.com/{your-organization}
     api:
       token:
-        $env: AZURE_PRIVATE_TOKEN
+        $env: AZURE_TOKEN
 ```
 
 ### Running the Backend
@@ -265,7 +265,7 @@ backend with the new configuration:
 
 ```bash
 cd packages/backend
-GITHUB_ACCESS_TOKEN=<token> yarn start
+GITHUB_TOKEN=<token> yarn start
 ```
 
 If you've also set up the frontend plugin, so you should be ready to go browse
diff --git a/packages/create-app/templates/default-app/app-config.yaml.hbs b/packages/create-app/templates/default-app/app-config.yaml.hbs
index fb6185d51b..04e2e8f5fc 100644
--- a/packages/create-app/templates/default-app/app-config.yaml.hbs
+++ b/packages/create-app/templates/default-app/app-config.yaml.hbs
@@ -55,7 +55,7 @@ auth:
 scaffolder:
   github:
     token:
-      $env: GITHUB_ACCESS_TOKEN
+      $env: GITHUB_TOKEN
     visibility: public # or 'internal' or 'private'
 
 catalog:
@@ -66,12 +66,12 @@ catalog:
       providers:
         - target: https://github.com
           token:
-            $env: GITHUB_PRIVATE_TOKEN
+            $env: GITHUB_TOKEN
         # Example for how to add your GitHub Enterprise instance:
         # - target: https://ghe.example.net
         #   apiBaseUrl: https://ghe.example.net/api/v3
         #   token:
-        #     $env: GHE_PRIVATE_TOKEN
+        #     $env: GHE_TOKEN
   locations:
     # Backstage example components
     - type: url
diff --git a/packages/e2e-test/src/e2e-test.ts b/packages/e2e-test/src/e2e-test.ts
index c7f6137ff1..6fbdbf3c88 100644
--- a/packages/e2e-test/src/e2e-test.ts
+++ b/packages/e2e-test/src/e2e-test.ts
@@ -285,7 +285,7 @@ async function testAppServe(pluginName: string, appDir: string) {
     cwd: appDir,
     env: {
       ...process.env,
-      GITHUB_ACCESS_TOKEN: 'abc',
+      GITHUB_TOKEN: 'abc',
     },
   });
   Browser.localhost('localhost', 3000);
@@ -368,7 +368,7 @@ async function testBackendStart(appDir: string, isPostgres: boolean) {
     cwd: appDir,
     env: {
       ...process.env,
-      GITHUB_ACCESS_TOKEN: 'abc',
+      GITHUB_TOKEN: 'abc',
     },
   });
 
diff --git a/plugins/techdocs-backend/src/default-branch.ts b/plugins/techdocs-backend/src/default-branch.ts
index 05a8f666ce..a903b780d8 100644
--- a/plugins/techdocs-backend/src/default-branch.ts
+++ b/plugins/techdocs-backend/src/default-branch.ts
@@ -69,7 +69,7 @@ function getGithubRequestOptions(config: Config): RequestInit {
   const token =
     config.getOptionalString('catalog.processors.github.privateToken') ??
     config.getOptionalString('catalog.processors.githubApi.privateToken') ??
-    process.env.GITHUB_PRIVATE_TOKEN;
+    process.env.GITHUB_TOKEN;
 
   if (token) {
     headers.Authorization = `token ${token}`;
@@ -88,7 +88,7 @@ function getGitlabRequestOptions(config: Config): RequestInit {
   const token =
     config.getOptionalString('catalog.processors.gitlab.privateToken') ??
     config.getOptionalString('catalog.processors.gitlabApi.privateToken') ??
-    process.env.GITLAB_ACCESS_TOKEN;
+    process.env.GITLAB_TOKEN;
 
   if (token) {
     headers['PRIVATE-TOKEN'] = token;
diff --git a/plugins/techdocs-backend/src/helpers.ts b/plugins/techdocs-backend/src/helpers.ts
index d6a275f183..e79df12365 100644
--- a/plugins/techdocs-backend/src/helpers.ts
+++ b/plugins/techdocs-backend/src/helpers.ts
@@ -126,9 +126,7 @@ export const checkoutGitRepository = async (
     process.env.GITLAB_PRIVATE_TOKEN_USER ||
     '';
   const token =
-    process.env.GITHUB_PRIVATE_TOKEN ||
-    process.env.GITLAB_PRIVATE_TOKEN_USER ||
-    '';
+    process.env.GITHUB_TOKEN || process.env.GITLAB_PRIVATE_TOKEN_USER || '';
 
   if (fs.existsSync(repositoryTmpPath)) {
     try {

From 5a920c6e4f6cd21e657f23557748fb5e0a45edaf Mon Sep 17 00:00:00 2001
From: Marvin9 <marvinduff97@gmail.com>
Date: Thu, 8 Oct 2020 10:41:13 +0530
Subject: [PATCH 080/110] version: run changeset

---
 .changeset/long-ways-count.md | 57 +++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 .changeset/long-ways-count.md

diff --git a/.changeset/long-ways-count.md b/.changeset/long-ways-count.md
new file mode 100644
index 0000000000..e04c1225cc
--- /dev/null
+++ b/.changeset/long-ways-count.md
@@ -0,0 +1,57 @@
+---
+'@backstage/plugin-techdocs-backend': minor
+'@backstage/create-app': patch
+---
+
+Updated naming of environment variables. New pattern [NAME]\_TOKEN for Github, Gitlab, Azure & Github enterprise access tokens.
+
+### Detail:
+
+- Previously we have to export same token for both, catalog & scaffolder
+
+```bash
+export GITHUB_ACCESS_TOKEN=foo
+export GITHUB_PRIVATE_TOKEN=foo
+```
+
+with latest changes, only single export is sufficient.
+
+```bash
+export GITHUB_TOKEN=foo
+export GITLAB_TOKEN=foo
+export GHE_TOKEN=foo
+export AZURE_TOKEN=foo
+```
+
+### list:
+
+<table>
+  <tr>
+    <th>Old name</th>
+    <th>New name</th>
+  </tr>
+  <tr>
+    <td>GITHUB_ACCESS_TOKEN</td>
+    <td>GITHUB_TOKEN</td>
+  </tr>
+  <tr>
+    <td>GITHUB_PRIVATE_TOKEN</td>
+    <td>GITHUB_TOKEN</td>
+  </tr>
+  <tr>
+    <td>GITLAB_ACCESS_TOKEN</td>
+    <td>GITLAB_TOKEN</td>
+  </tr>
+  <tr>
+    <td>GITLAB_PRIVATE_TOKEN</td>
+    <td>GITLAB_TOKEN</td>
+  </tr>
+  <tr>
+    <td>AZURE_PRIVATE_TOKEN</td>
+    <td>AZURE_TOKEN</td>
+  </tr>
+  <tr>
+    <td>GHE_PRIVATE_TOKEN</td>
+    <td>GHE_TOKEN</td>
+  </tr>
+</table>

From 78e7202b19480efdabd414bc28c2a875535aface Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 8 Oct 2020 09:48:18 +0200
Subject: [PATCH 081/110] chore(deps): bump circleci-api from 4.0.0 to 4.1.3
 (#2793)

Bumps [circleci-api](https://github.com/worldturtlemedia/circleci-api) from 4.0.0 to 4.1.3.
- [Release notes](https://github.com/worldturtlemedia/circleci-api/releases)
- [Commits](https://github.com/worldturtlemedia/circleci-api/compare/v4.0.0...v4.1.3)

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 yarn.lock | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/yarn.lock b/yarn.lock
index 8b9b16ebe7..26cd660d73 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -6855,7 +6855,7 @@ aws4@^1.8.0:
   resolved "https://registry.npmjs.org/aws4/-/aws4-1.9.1.tgz#7e33d8f7d449b3f673cd72deb9abdc552dbe528e"
   integrity sha512-wMHVg2EOHaMRxbzgFJ9gtjOOCrI80OHLG14rxi28XwOW8ux6IiEbRCGGGqCtdAIg4FQCbW20k9RsT4y3gJlFug==
 
-axios@^0.19.0, axios@^0.19.2:
+axios@^0.19.2:
   version "0.19.2"
   resolved "https://registry.npmjs.org/axios/-/axios-0.19.2.tgz#3ea36c5d8818d0d5f8a8a97a6d36b86cdc00cb27"
   integrity sha512-fjgm5MvRHLhx+osE2xoekY70AhARk3a6hkN+3Io1jc00jtquGvxYlKlsFUhmUET0V5te6CcZI7lcv2Ym61mjHA==
@@ -8148,11 +8148,11 @@ cipher-base@^1.0.0, cipher-base@^1.0.1, cipher-base@^1.0.3:
     safe-buffer "^5.0.1"
 
 circleci-api@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.npmjs.org/circleci-api/-/circleci-api-4.0.0.tgz#d773fe68f4a59e1968881269883a23b0805b3546"
-  integrity sha512-D/THFyhOv6THSkYXJhrOLIOmV7fmyDqgs1+pBFMAqDR+ywXszxa2Dqx1Zw+YD3O2zD2y5LQOifCDT96VidRG7Q==
+  version "4.1.3"
+  resolved "https://registry.npmjs.org/circleci-api/-/circleci-api-4.1.3.tgz#cafd80bc1905c6064724636741b4b5b231ed34d0"
+  integrity sha512-Km6H8LB3nNbFUjErhI+sNQrcHcU7dCBnQEi4ckBtQMkCXh+2gDvaYchfkeuIaA1hkakQT5sLmdPbYzhKbvsOMg==
   dependencies:
-    axios "^0.19.0"
+    axios "^0.20.0"
 
 class-utils@^0.3.5:
   version "0.3.6"

From 5ea40dce6b77d9280cf504cf0fc8f0592d082866 Mon Sep 17 00:00:00 2001
From: Marcus Eide <eide@spotify.com>
Date: Thu, 8 Oct 2020 09:52:06 +0200
Subject: [PATCH 082/110] Add categories to stories

---
 packages/core/src/components/Button/Button.stories.tsx          | 2 +-
 .../core/src/components/CodeSnippet/CodeSnippet.stories.tsx     | 2 +-
 .../src/components/CopyTextButton/CopyTextButton.stories.tsx    | 2 +-
 .../components/DismissableBanner/DismissableBanner.stories.tsx  | 2 +-
 packages/core/src/components/EmptyState/EmptyState.stories.tsx  | 2 +-
 .../HorizontalScrollGrid/HorizontalScrollGrid.stories.tsx       | 2 +-
 packages/core/src/components/Lifecycle/Lifecycle.stories.tsx    | 2 +-
 packages/core/src/components/Link/Link.stories.tsx              | 2 +-
 packages/core/src/components/Progress/Progress.stories.tsx      | 2 +-
 packages/core/src/components/ProgressBars/Gauge.stories.tsx     | 2 +-
 packages/core/src/components/ProgressBars/GaugeCard.stories.tsx | 2 +-
 .../core/src/components/ProgressBars/LinearGauge.stories.tsx    | 2 +-
 .../core/src/components/SimpleStepper/SimpleStepper.stories.tsx | 2 +-
 packages/core/src/components/Status/Status.stories.tsx          | 2 +-
 .../StructuredMetadataTable/StructuredMetadataTable.stories.tsx | 2 +-
 packages/core/src/components/Table/Table.stories.tsx            | 2 +-
 packages/core/src/components/Tabs/Tabs.stories.tsx              | 2 +-
 packages/core/src/components/TrendLine/TrendLine.stories.tsx    | 2 +-
 .../core/src/components/WarningPanel/WarningPanel.stories.tsx   | 2 +-
 packages/core/src/components/stories/Chip.stories.tsx           | 2 +-
 packages/core/src/layout/Header/Header.stories.tsx              | 2 +-
 packages/core/src/layout/InfoCard/InfoCard.stories.tsx          | 2 +-
 packages/core/src/layout/ItemCard/ItemCard.stories.tsx          | 2 +-
 packages/core/src/layout/Page/Page.stories.tsx                  | 2 +-
 packages/core/src/layout/Sidebar/Sidebar.stories.tsx            | 2 +-
 packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx      | 2 +-
 .../src/components/SidebarWithSettings.stories.tsx              | 2 +-
 27 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/packages/core/src/components/Button/Button.stories.tsx b/packages/core/src/components/Button/Button.stories.tsx
index aaca389f82..a5005574fe 100644
--- a/packages/core/src/components/Button/Button.stories.tsx
+++ b/packages/core/src/components/Button/Button.stories.tsx
@@ -24,7 +24,7 @@ const Location = () => {
 };
 
 export default {
-  title: 'Button',
+  title: 'Inputs/Button',
   component: Button,
   decorators: [
     (storyFn: FunctionComponentFactory<{}>) => (
diff --git a/packages/core/src/components/CodeSnippet/CodeSnippet.stories.tsx b/packages/core/src/components/CodeSnippet/CodeSnippet.stories.tsx
index 77f3ca51cc..6df7e5bb6d 100644
--- a/packages/core/src/components/CodeSnippet/CodeSnippet.stories.tsx
+++ b/packages/core/src/components/CodeSnippet/CodeSnippet.stories.tsx
@@ -19,7 +19,7 @@ import { CodeSnippet } from './CodeSnippet';
 import { InfoCard } from '../../layout/InfoCard';
 
 export default {
-  title: 'CodeSnippet',
+  title: 'Data Display/CodeSnippet',
   component: CodeSnippet,
 };
 
diff --git a/packages/core/src/components/CopyTextButton/CopyTextButton.stories.tsx b/packages/core/src/components/CopyTextButton/CopyTextButton.stories.tsx
index 1894574df2..e6f5f8cece 100644
--- a/packages/core/src/components/CopyTextButton/CopyTextButton.stories.tsx
+++ b/packages/core/src/components/CopyTextButton/CopyTextButton.stories.tsx
@@ -18,7 +18,7 @@ import React from 'react';
 import { CopyTextButton } from '.';
 
 export default {
-  title: 'CopyTextButton',
+  title: 'Inputs/CopyTextButton',
   component: CopyTextButton,
 };
 
diff --git a/packages/core/src/components/DismissableBanner/DismissableBanner.stories.tsx b/packages/core/src/components/DismissableBanner/DismissableBanner.stories.tsx
index 148e7b6803..d77a713b34 100644
--- a/packages/core/src/components/DismissableBanner/DismissableBanner.stories.tsx
+++ b/packages/core/src/components/DismissableBanner/DismissableBanner.stories.tsx
@@ -28,7 +28,7 @@ import {
 } from '@backstage/core-api';
 
 export default {
-  title: 'DismissableBanner',
+  title: 'Feedback/DismissableBanner',
   component: DismissableBanner,
 };
 
diff --git a/packages/core/src/components/EmptyState/EmptyState.stories.tsx b/packages/core/src/components/EmptyState/EmptyState.stories.tsx
index 15d61f14c0..8f846797a1 100644
--- a/packages/core/src/components/EmptyState/EmptyState.stories.tsx
+++ b/packages/core/src/components/EmptyState/EmptyState.stories.tsx
@@ -20,7 +20,7 @@ import { Button } from '@material-ui/core';
 import { MissingAnnotationEmptyState } from './MissingAnnotationEmptyState';
 
 export default {
-  title: 'EmptyState',
+  title: 'Feedback/EmptyState',
   component: EmptyState,
 };
 
diff --git a/packages/core/src/components/HorizontalScrollGrid/HorizontalScrollGrid.stories.tsx b/packages/core/src/components/HorizontalScrollGrid/HorizontalScrollGrid.stories.tsx
index b65c5bff5d..9718393427 100644
--- a/packages/core/src/components/HorizontalScrollGrid/HorizontalScrollGrid.stories.tsx
+++ b/packages/core/src/components/HorizontalScrollGrid/HorizontalScrollGrid.stories.tsx
@@ -21,7 +21,7 @@ const containerStyle = { width: 800, height: 400, margin: 20 };
 const opacityArray = [0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0];
 
 export default {
-  title: 'HorizontalScrollGrid',
+  title: 'Layout/HorizontalScrollGrid',
   component: HorizontalScrollGrid,
 };
 
diff --git a/packages/core/src/components/Lifecycle/Lifecycle.stories.tsx b/packages/core/src/components/Lifecycle/Lifecycle.stories.tsx
index c29eb8a02f..ccce7fba25 100644
--- a/packages/core/src/components/Lifecycle/Lifecycle.stories.tsx
+++ b/packages/core/src/components/Lifecycle/Lifecycle.stories.tsx
@@ -17,7 +17,7 @@ import React from 'react';
 import { Lifecycle } from './Lifecycle';
 
 export default {
-  title: 'Lifecycle',
+  title: 'Feedback/Lifecycle',
   component: Lifecycle,
 };
 
diff --git a/packages/core/src/components/Link/Link.stories.tsx b/packages/core/src/components/Link/Link.stories.tsx
index 2bd499fa33..852d51970f 100644
--- a/packages/core/src/components/Link/Link.stories.tsx
+++ b/packages/core/src/components/Link/Link.stories.tsx
@@ -29,7 +29,7 @@ const Location = () => {
 };
 
 export default {
-  title: 'Link',
+  title: 'Navigation/Link',
   component: Link,
   decorators: [
     (storyFn: FunctionComponentFactory<{}>) => (
diff --git a/packages/core/src/components/Progress/Progress.stories.tsx b/packages/core/src/components/Progress/Progress.stories.tsx
index b935f60695..cd17dce8b4 100644
--- a/packages/core/src/components/Progress/Progress.stories.tsx
+++ b/packages/core/src/components/Progress/Progress.stories.tsx
@@ -18,7 +18,7 @@ import React from 'react';
 import { Progress } from '.';
 
 export default {
-  title: 'Progress',
+  title: 'Feedback/Progress',
   component: Progress,
 };
 
diff --git a/packages/core/src/components/ProgressBars/Gauge.stories.tsx b/packages/core/src/components/ProgressBars/Gauge.stories.tsx
index 6599b0f768..7882714529 100644
--- a/packages/core/src/components/ProgressBars/Gauge.stories.tsx
+++ b/packages/core/src/components/ProgressBars/Gauge.stories.tsx
@@ -20,7 +20,7 @@ import { Gauge } from './Gauge';
 const containerStyle = { width: 300 };
 
 export default {
-  title: 'Gauge',
+  title: 'Feedback/Gauge',
   component: Gauge,
 };
 
diff --git a/packages/core/src/components/ProgressBars/GaugeCard.stories.tsx b/packages/core/src/components/ProgressBars/GaugeCard.stories.tsx
index 922bb63b2f..45de49cd2d 100644
--- a/packages/core/src/components/ProgressBars/GaugeCard.stories.tsx
+++ b/packages/core/src/components/ProgressBars/GaugeCard.stories.tsx
@@ -21,7 +21,7 @@ import { Grid } from '@material-ui/core';
 const linkInfo = { title: 'Go to XYZ Location', link: '#' };
 
 export default {
-  title: 'Progress Card',
+  title: 'Data Display/Progress Card',
   component: GaugeCard,
 };
 
diff --git a/packages/core/src/components/ProgressBars/LinearGauge.stories.tsx b/packages/core/src/components/ProgressBars/LinearGauge.stories.tsx
index c4492986b6..a745d210b4 100644
--- a/packages/core/src/components/ProgressBars/LinearGauge.stories.tsx
+++ b/packages/core/src/components/ProgressBars/LinearGauge.stories.tsx
@@ -20,7 +20,7 @@ import { LinearGauge } from './LinearGauge';
 const containerStyle = { width: 300 };
 
 export default {
-  title: 'LinearGauge',
+  title: 'Feedback/LinearGauge',
   component: LinearGauge,
 };
 
diff --git a/packages/core/src/components/SimpleStepper/SimpleStepper.stories.tsx b/packages/core/src/components/SimpleStepper/SimpleStepper.stories.tsx
index 52710ffeaf..e7163ea533 100644
--- a/packages/core/src/components/SimpleStepper/SimpleStepper.stories.tsx
+++ b/packages/core/src/components/SimpleStepper/SimpleStepper.stories.tsx
@@ -19,7 +19,7 @@ import { TextField } from '@material-ui/core';
 import { SimpleStepper, SimpleStepperStep } from '.';
 
 export default {
-  title: 'SimpleStepper',
+  title: 'Navigation/SimpleStepper',
   component: SimpleStepper,
 };
 
diff --git a/packages/core/src/components/Status/Status.stories.tsx b/packages/core/src/components/Status/Status.stories.tsx
index 01e2876524..560d07ad87 100644
--- a/packages/core/src/components/Status/Status.stories.tsx
+++ b/packages/core/src/components/Status/Status.stories.tsx
@@ -27,7 +27,7 @@ import { Table } from '../Table';
 import { InfoCard } from '../../layout/InfoCard';
 
 export default {
-  title: 'Status',
+  title: 'Feedback/Status',
   component: StatusOK,
 };
 
diff --git a/packages/core/src/components/StructuredMetadataTable/StructuredMetadataTable.stories.tsx b/packages/core/src/components/StructuredMetadataTable/StructuredMetadataTable.stories.tsx
index 9db7385872..97591ebab3 100644
--- a/packages/core/src/components/StructuredMetadataTable/StructuredMetadataTable.stories.tsx
+++ b/packages/core/src/components/StructuredMetadataTable/StructuredMetadataTable.stories.tsx
@@ -37,7 +37,7 @@ const metadata = {
 };
 
 export default {
-  title: 'Structured Metadata Table',
+  title: 'Data Display/Structured Metadata Table',
   component: StructuredMetadataTable,
 };
 
diff --git a/packages/core/src/components/Table/Table.stories.tsx b/packages/core/src/components/Table/Table.stories.tsx
index 11fa0c44dc..40fce4bb95 100644
--- a/packages/core/src/components/Table/Table.stories.tsx
+++ b/packages/core/src/components/Table/Table.stories.tsx
@@ -18,7 +18,7 @@ import React from 'react';
 import { Table, SubvalueCell, TableColumn } from './';
 
 export default {
-  title: 'Table',
+  title: 'Data Display/Table',
   component: Table,
 };
 
diff --git a/packages/core/src/components/Tabs/Tabs.stories.tsx b/packages/core/src/components/Tabs/Tabs.stories.tsx
index 930a825392..00819c44f1 100644
--- a/packages/core/src/components/Tabs/Tabs.stories.tsx
+++ b/packages/core/src/components/Tabs/Tabs.stories.tsx
@@ -19,7 +19,7 @@ import { Tabs } from './Tabs';
 import AccessAlarmIcon from '@material-ui/icons/AccessAlarm';
 
 export default {
-  title: 'Tabs',
+  title: 'Navigation/Tabs',
   component: Tabs,
 };
 
diff --git a/packages/core/src/components/TrendLine/TrendLine.stories.tsx b/packages/core/src/components/TrendLine/TrendLine.stories.tsx
index cc2fdda052..4eb74b2f17 100644
--- a/packages/core/src/components/TrendLine/TrendLine.stories.tsx
+++ b/packages/core/src/components/TrendLine/TrendLine.stories.tsx
@@ -20,7 +20,7 @@ import { TrendLine } from './TrendLine';
 import { InfoCard } from '../../layout/InfoCard';
 
 export default {
-  title: 'TrendLine',
+  title: 'Data Display/TrendLine',
   component: TrendLine,
 };
 
diff --git a/packages/core/src/components/WarningPanel/WarningPanel.stories.tsx b/packages/core/src/components/WarningPanel/WarningPanel.stories.tsx
index 92487ed8c5..5098f0aa31 100644
--- a/packages/core/src/components/WarningPanel/WarningPanel.stories.tsx
+++ b/packages/core/src/components/WarningPanel/WarningPanel.stories.tsx
@@ -19,7 +19,7 @@ import { WarningPanel } from './WarningPanel';
 import { Link, Button } from '@material-ui/core';
 
 export default {
-  title: 'Warning Panel',
+  title: 'Feedback/Warning Panel',
   component: WarningPanel,
 };
 
diff --git a/packages/core/src/components/stories/Chip.stories.tsx b/packages/core/src/components/stories/Chip.stories.tsx
index c0e644fcc5..a605666482 100644
--- a/packages/core/src/components/stories/Chip.stories.tsx
+++ b/packages/core/src/components/stories/Chip.stories.tsx
@@ -18,7 +18,7 @@ import React from 'react';
 import { Chip } from '@material-ui/core';
 
 export default {
-  title: 'Chip',
+  title: 'Data Display/Chip',
   component: Chip,
 };
 
diff --git a/packages/core/src/layout/Header/Header.stories.tsx b/packages/core/src/layout/Header/Header.stories.tsx
index 39b9133c0a..91045d4bb4 100644
--- a/packages/core/src/layout/Header/Header.stories.tsx
+++ b/packages/core/src/layout/Header/Header.stories.tsx
@@ -19,7 +19,7 @@ import { HeaderLabel } from '../HeaderLabel';
 import { Page, pageTheme } from '../Page';
 
 export default {
-  title: 'Header',
+  title: 'Layout/Header',
   component: Header,
 };
 
diff --git a/packages/core/src/layout/InfoCard/InfoCard.stories.tsx b/packages/core/src/layout/InfoCard/InfoCard.stories.tsx
index 3e476c5480..4886a38b0f 100644
--- a/packages/core/src/layout/InfoCard/InfoCard.stories.tsx
+++ b/packages/core/src/layout/InfoCard/InfoCard.stories.tsx
@@ -20,7 +20,7 @@ import { Grid, Typography } from '@material-ui/core';
 const linkInfo = { title: 'Go to XYZ Location', link: '#' };
 
 export default {
-  title: 'Information Card',
+  title: 'Layout/Information Card',
   component: InfoCard,
 };
 
diff --git a/packages/core/src/layout/ItemCard/ItemCard.stories.tsx b/packages/core/src/layout/ItemCard/ItemCard.stories.tsx
index 46b93da370..998856e041 100644
--- a/packages/core/src/layout/ItemCard/ItemCard.stories.tsx
+++ b/packages/core/src/layout/ItemCard/ItemCard.stories.tsx
@@ -18,7 +18,7 @@ import { ItemCard } from '.';
 import { Grid } from '@material-ui/core';
 
 export default {
-  title: 'Item Card',
+  title: 'Layout/Item Card',
   component: ItemCard,
 };
 
diff --git a/packages/core/src/layout/Page/Page.stories.tsx b/packages/core/src/layout/Page/Page.stories.tsx
index 8fd779196d..2a60f182a1 100644
--- a/packages/core/src/layout/Page/Page.stories.tsx
+++ b/packages/core/src/layout/Page/Page.stories.tsx
@@ -36,7 +36,7 @@ import {
 import { Box, Typography, Link, Chip, Grid } from '@material-ui/core';
 
 export default {
-  title: 'Example Plugin',
+  title: 'Layout/Example Plugin',
   component: Page,
 };
 
diff --git a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
index 908fbba75c..d6a01fea33 100644
--- a/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
+++ b/packages/core/src/layout/Sidebar/Sidebar.stories.tsx
@@ -28,7 +28,7 @@ import AddCircleOutlineIcon from '@material-ui/icons/AddCircleOutline';
 import { MemoryRouter } from 'react-router-dom';
 
 export default {
-  title: 'Sidebar',
+  title: 'Layout/Sidebar',
   component: Sidebar,
   decorators: [
     (storyFn: () => JSX.Element) => (
diff --git a/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx b/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
index 23c2ab5b49..f4af6dcf9f 100644
--- a/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
+++ b/packages/core/src/layout/TabbedCard/TabbedCard.stories.tsx
@@ -20,7 +20,7 @@ import { Grid } from '@material-ui/core';
 const cardContentStyle = { height: 200, width: 500 };
 
 export default {
-  title: 'Tabbed Card',
+  title: 'Layout/Tabbed Card',
   component: TabbedCard,
   decorators: [
     (storyFn: () => JSX.Element) => (
diff --git a/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx b/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
index 579f2de640..fd3d6ce0f0 100644
--- a/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
+++ b/plugins/user-settings/src/components/SidebarWithSettings.stories.tsx
@@ -33,7 +33,7 @@ import { Settings } from './Settings';
 import { SettingsPage } from './SettingsPage';
 
 export default {
-  title: 'Settings',
+  title: 'Plugins/user-settings/Settings',
   component: Settings,
   decorators: [
     (storyFn: () => JSX.Element) => (

From 99b26cff875a90f0f3cac27994f59351311b96ec Mon Sep 17 00:00:00 2001
From: mclarke47 <matthewclarke47@gmail.com>
Date: Thu, 8 Oct 2020 10:26:09 +0100
Subject: [PATCH 083/110] show response status code from k8s API in UI

---
 .../src/components/KubernetesContent/ErrorPanel.test.tsx        | 2 +-
 .../kubernetes/src/components/KubernetesContent/ErrorPanel.tsx  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.test.tsx b/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.test.tsx
index 6985423a10..6fa6b3114c 100644
--- a/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.test.tsx
+++ b/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.test.tsx
@@ -76,7 +76,7 @@ describe('ErrorPanel', () => {
     expect(getByText('Cluster: THIS_CLUSTER')).toBeInTheDocument();
     expect(
       getByText(
-        "Error fetching Kubernetes resource: 'some/resource', error: SYSTEM_ERROR",
+        "Error fetching Kubernetes resource: 'some/resource', error: SYSTEM_ERROR, status code: 500",
       ),
     ).toBeInTheDocument();
   });
diff --git a/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.tsx b/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.tsx
index 1fe5714b09..1b8336dd72 100644
--- a/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.tsx
+++ b/plugins/kubernetes/src/components/KubernetesContent/ErrorPanel.tsx
@@ -29,7 +29,7 @@ const clustersWithErrorsToErrorMessage = (
         {c.errors.map((e, j) => {
           return (
             <Typography variant="body2" key={j}>
-              {`Error fetching Kubernetes resource: '${e.resourcePath}', error: ${e.errorType}`}
+              {`Error fetching Kubernetes resource: '${e.resourcePath}', error: ${e.errorType}, status code: ${e.statusCode}`}
             </Typography>
           );
         })}

From 29ec8c2f096d396365a61518fcc0de45136ad6c4 Mon Sep 17 00:00:00 2001
From: Sebastian Qvarfordt <s.qvarfordt@gmail.com>
Date: Thu, 8 Oct 2020 11:26:46 +0200
Subject: [PATCH 084/110] TechDocs: Fix reload when clicking internal docs
 pages (#2784)

* Check to see if links start with window.location.origin to see if we should handle it as a internal docs link

* Fixed failing test

* Fix lint issues
---
 .../techdocs/src/reader/components/Reader.tsx |  1 +
 .../transformers/addLinkClickListener.test.ts | 56 ++++++++++++++++---
 .../transformers/addLinkClickListener.ts      |  5 +-
 3 files changed, 52 insertions(+), 10 deletions(-)

diff --git a/plugins/techdocs/src/reader/components/Reader.tsx b/plugins/techdocs/src/reader/components/Reader.tsx
index 550b8df923..01299b8fe6 100644
--- a/plugins/techdocs/src/reader/components/Reader.tsx
+++ b/plugins/techdocs/src/reader/components/Reader.tsx
@@ -116,6 +116,7 @@ export const Reader = ({ entityId, onReady }: Props) => {
         return dom;
       },
       addLinkClickListener({
+        baseUrl: window.location.origin,
         onClick: (_: MouseEvent, url: string) => {
           const parsedUrl = new URL(url);
           navigate(`${parsedUrl.pathname}${parsedUrl.hash}`);
diff --git a/plugins/techdocs/src/reader/transformers/addLinkClickListener.test.ts b/plugins/techdocs/src/reader/transformers/addLinkClickListener.test.ts
index 8e942b8be1..775780fe4d 100644
--- a/plugins/techdocs/src/reader/transformers/addLinkClickListener.test.ts
+++ b/plugins/techdocs/src/reader/transformers/addLinkClickListener.test.ts
@@ -14,23 +14,61 @@
  * limitations under the License.
  */
 
-import { createTestShadowDom, FIXTURES } from '../../test-utils';
+import { createTestShadowDom } from '../../test-utils';
 import { addLinkClickListener } from '.';
 
 describe('addLinkClickListener', () => {
   it('calls onClick when a link has been clicked', () => {
     const fn = jest.fn();
-    const shadowDom = createTestShadowDom(FIXTURES.FIXTURE_STANDARD_PAGE, {
-      preTransformers: [],
-      postTransformers: [
-        addLinkClickListener({
-          onClick: fn,
-        }),
-      ],
-    });
+    const shadowDom = createTestShadowDom(
+      `
+      <!DOCTYPE html>
+      <html>
+        <body>
+          <a href="http://localhost:3000/docs/test">Link</a>
+        </body>
+      </html>
+    `,
+      {
+        preTransformers: [],
+        postTransformers: [
+          addLinkClickListener({
+            baseUrl: 'http://localhost:3000',
+            onClick: fn,
+          }),
+        ],
+      },
+    );
 
     shadowDom.querySelector('a')?.click();
 
     expect(fn).toHaveBeenCalledTimes(1);
   });
+
+  it('does not call onClick when a link links to another baseUrl', () => {
+    const fn = jest.fn();
+    const shadowDom = createTestShadowDom(
+      `
+      <!DOCTYPE html>
+      <html>
+        <body>
+          <a href="http://example.com/docs/test">Link</a>
+        </body>
+      </html>
+    `,
+      {
+        preTransformers: [],
+        postTransformers: [
+          addLinkClickListener({
+            baseUrl: 'http://localhost:3000',
+            onClick: fn,
+          }),
+        ],
+      },
+    );
+
+    shadowDom.querySelector('a')?.click();
+
+    expect(fn).toHaveBeenCalledTimes(0);
+  });
 });
diff --git a/plugins/techdocs/src/reader/transformers/addLinkClickListener.ts b/plugins/techdocs/src/reader/transformers/addLinkClickListener.ts
index 3566b403a2..b6a6509550 100644
--- a/plugins/techdocs/src/reader/transformers/addLinkClickListener.ts
+++ b/plugins/techdocs/src/reader/transformers/addLinkClickListener.ts
@@ -17,10 +17,12 @@
 import type { Transformer } from './index';
 
 type AddLinkClickListenerOptions = {
+  baseUrl: string;
   onClick: (e: MouseEvent, newUrl: string) => void;
 };
 
 export const addLinkClickListener = ({
+  baseUrl,
   onClick,
 }: AddLinkClickListenerOptions): Transformer => {
   return dom => {
@@ -28,8 +30,9 @@ export const addLinkClickListener = ({
       elem.addEventListener('click', (e: MouseEvent) => {
         const target = e.target as HTMLAnchorElement;
         const href = target?.getAttribute('href');
+
         if (!href) return;
-        if (!href.match(/^https?:\/\//i)) {
+        if (href.startsWith(baseUrl)) {
           e.preventDefault();
           onClick(e, target.getAttribute('href')!);
         }

From 00b5b877b40d1770be43655f00d862cc9ef4814c Mon Sep 17 00:00:00 2001
From: Oliver Sand <oliver.sand@sda-se.com>
Date: Thu, 8 Oct 2020 11:53:16 +0200
Subject: [PATCH 085/110] fix(techdocs-cli): make techdocs-cli work on Windows
 (#2779)

$(pwd) won't work outside a Unix shell, so I replaced it with process.cwd(). Then it's not important anymore in which directory the docker command is executed.
---
 packages/techdocs-cli/src/index.ts | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/packages/techdocs-cli/src/index.ts b/packages/techdocs-cli/src/index.ts
index b48f03d35b..da196d10b8 100644
--- a/packages/techdocs-cli/src/index.ts
+++ b/packages/techdocs-cli/src/index.ts
@@ -20,11 +20,7 @@ import path from 'path';
 import HTTPServer from './lib/httpServer';
 import openBrowser from 'react-dev-utils/openBrowser';
 
-const run = (
-  workingDirectory: string,
-  name: string,
-  args: string[] = [],
-): ChildProcess => {
+const run = (name: string, args: string[] = []): ChildProcess => {
   const [stdin, stdout, stderr] = [
     'inherit' as const,
     'pipe' as const,
@@ -32,7 +28,6 @@ const run = (
   ];
 
   const childProcess = spawn(name, args, {
-    cwd: workingDirectory,
     stdio: [stdin, stdout, stderr],
     shell: true,
     env: {
@@ -59,13 +54,13 @@ const runMkdocsServer = (options?: {
   const devAddr = options?.devAddr ?? '0.0.0.0:8000';
 
   return new Promise(resolve => {
-    const childProcess = run(process.env.PWD!, 'docker', [
+    const childProcess = run('docker', [
       'run',
       '-it',
       '-w',
       '/content',
       '-v',
-      '$(pwd):/content',
+      `${process.cwd()}:/content`,
       '-p',
       '8000:8000',
       'spotify/techdocs',

From 4df660e37f58188217889bb269f509ee57daf940 Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Thu, 8 Oct 2020 07:27:49 -0400
Subject: [PATCH 086/110] Add authentication to GitHub preparer

---
 packages/backend/src/plugins/scaffolder.ts      |  7 +++++--
 .../src/scaffolder/stages/prepare/github.ts     | 17 +++++++++++++++--
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/packages/backend/src/plugins/scaffolder.ts b/packages/backend/src/plugins/scaffolder.ts
index c5b36ab8da..90667bfb16 100644
--- a/packages/backend/src/plugins/scaffolder.ts
+++ b/packages/backend/src/plugins/scaffolder.ts
@@ -47,13 +47,12 @@ export default async function createPlugin({
   templaters.register('cra', craTemplater);
 
   const filePreparer = new FilePreparer();
-  const githubPreparer = new GithubPreparer();
+
   const gitlabPreparer = new GitlabPreparer(config);
   const azurePreparer = new AzurePreparer(config);
   const preparers = new Preparers();
 
   preparers.register('file', filePreparer);
-  preparers.register('github', githubPreparer);
   preparers.register('gitlab', gitlabPreparer);
   preparers.register('gitlab/api', gitlabPreparer);
   preparers.register('azure/api', azurePreparer);
@@ -75,6 +74,10 @@ export default async function createPlugin({
         token: githubToken,
         repoVisibility,
       });
+
+      const githubPreparer = new GithubPreparer({ token: githubToken });
+
+      preparers.register('github', githubPreparer);
       publishers.register('file', githubPublisher);
       publishers.register('github', githubPublisher);
     } catch (e) {
diff --git a/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts b/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts
index ba4adcabd9..54265736f3 100644
--- a/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts
+++ b/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts
@@ -21,11 +21,18 @@ import { parseLocationAnnotation } from '../helpers';
 import { InputError } from '@backstage/backend-common';
 import { PreparerBase } from './types';
 import GitUriParser from 'git-url-parse';
-import { Clone } from 'nodegit';
+import { Clone, Cred } from 'nodegit';
 
 export class GithubPreparer implements PreparerBase {
+  token: string;
+
+  constructor(params: { token: string }) {
+    this.token = params.token;
+  }
+
   async prepare(template: TemplateEntityV1alpha1): Promise<string> {
     const { protocol, location } = parseLocationAnnotation(template);
+    const { token } = this;
 
     if (protocol !== 'github') {
       throw new InputError(
@@ -46,7 +53,13 @@ export class GithubPreparer implements PreparerBase {
     );
 
     await Clone.clone(repositoryCheckoutUrl, tempDir, {
-      // TODO(blam): Maybe need some auth here?
+      fetchOpts: {
+        callbacks: {
+          credentials() {
+            return Cred.userpassPlaintextNew(token, 'x-oauth-basic');
+          },
+        },
+      },
     });
 
     return path.resolve(tempDir, templateDirectory);

From 4837a166c2fbb34b77896cbd962c92f62c25bb75 Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Thu, 8 Oct 2020 07:45:29 -0400
Subject: [PATCH 087/110] Make token optional

---
 .../src/scaffolder/stages/prepare/github.ts   | 24 +++++++++++--------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts b/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts
index 54265736f3..49703c5616 100644
--- a/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts
+++ b/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.ts
@@ -24,9 +24,9 @@ import GitUriParser from 'git-url-parse';
 import { Clone, Cred } from 'nodegit';
 
 export class GithubPreparer implements PreparerBase {
-  token: string;
+  token?: string;
 
-  constructor(params: { token: string }) {
+  constructor(params: { token?: string } = {}) {
     this.token = params.token;
   }
 
@@ -52,15 +52,19 @@ export class GithubPreparer implements PreparerBase {
       template.spec.path ?? '.',
     );
 
-    await Clone.clone(repositoryCheckoutUrl, tempDir, {
-      fetchOpts: {
-        callbacks: {
-          credentials() {
-            return Cred.userpassPlaintextNew(token, 'x-oauth-basic');
+    const cloneOptions = token
+      ? {
+          fetchOpts: {
+            callbacks: {
+              credentials() {
+                return Cred.userpassPlaintextNew(token, 'x-oauth-basic');
+              },
+            },
           },
-        },
-      },
-    });
+        }
+      : {};
+
+    await Clone.clone(repositoryCheckoutUrl, tempDir, cloneOptions);
 
     return path.resolve(tempDir, templateDirectory);
   }

From d69da85a270e9c19351699b722e35b33eda407af Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Thu, 8 Oct 2020 08:02:21 -0400
Subject: [PATCH 088/110] Add a test for when token is passed in

---
 .../scaffolder/stages/prepare/github.test.ts    | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.test.ts b/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.test.ts
index 4409d815b5..babdd65c04 100644
--- a/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.test.ts
+++ b/plugins/scaffolder-backend/src/scaffolder/stages/prepare/github.test.ts
@@ -90,7 +90,6 @@ describe('GitHubPreparer', () => {
       {},
     );
   });
-
   it('return the temp directory with the path to the folder if it is specified', async () => {
     const preparer = new GithubPreparer();
     mockEntity.spec.path = './template/test/1/2/3';
@@ -100,4 +99,20 @@ describe('GitHubPreparer', () => {
       /\/template\/test\/1\/2\/3$/,
     );
   });
+  it('calls the clone command with the token when provided', async () => {
+    const preparer = new GithubPreparer({ token: 'abc' });
+    await preparer.prepare(mockEntity);
+    expect(mocks.Clone.clone).toHaveBeenNthCalledWith(
+      1,
+      'https://github.com/benjdlambert/backstage-graphql-template',
+      expect.any(String),
+      {
+        fetchOpts: {
+          callbacks: {
+            credentials: expect.any(Function),
+          },
+        },
+      },
+    );
+  });
 });

From 6840a68df9986bd7336a622b013356dcb2e3b885 Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Thu, 8 Oct 2020 08:02:39 -0400
Subject: [PATCH 089/110] Added changesets

---
 .changeset/cyan-plants-dress.md | 5 +++++
 .changeset/pretty-cups-joke.md  | 5 +++++
 2 files changed, 10 insertions(+)
 create mode 100644 .changeset/cyan-plants-dress.md
 create mode 100644 .changeset/pretty-cups-joke.md

diff --git a/.changeset/cyan-plants-dress.md b/.changeset/cyan-plants-dress.md
new file mode 100644
index 0000000000..19ebc63e53
--- /dev/null
+++ b/.changeset/cyan-plants-dress.md
@@ -0,0 +1,5 @@
+---
+'example-backend': patch
+---
+
+Pass GitHub token into Scaffolder GitHub Preparer
diff --git a/.changeset/pretty-cups-joke.md b/.changeset/pretty-cups-joke.md
new file mode 100644
index 0000000000..49a1db2a75
--- /dev/null
+++ b/.changeset/pretty-cups-joke.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-scaffolder-backend': patch
+---
+
+Add authentication token to Scaffolder GitHub Preparer

From 901cb6ec2d1bd470cf088fbcce9a9f5e5e54e434 Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Thu, 8 Oct 2020 08:05:10 -0400
Subject: [PATCH 090/110] Include "Added a changeset" in PR checklist

---
 .github/PULL_REQUEST_TEMPLATE.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 0437698301..01fc8e70c3 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -13,3 +13,4 @@
 - [ ] Prettier run on changed files
 - [ ] Tests added for new functionality
 - [ ] Regression tests added for bug fixes
+- [ ] Added a changeset ([more info](https://github.com/spotify/backstage/blob/master/CONTRIBUTING.md#creating-changesets))

From 9226c2aaa015dd72f1714879f1199b0b3de0330b Mon Sep 17 00:00:00 2001
From: Dominik Henneke <dominik.henneke@sda-se.com>
Date: Thu, 8 Oct 2020 14:12:23 +0200
Subject: [PATCH 091/110] feat(proxy-backend): limit the forwarded http headers
 to a safe set

---
 .changeset/2804.md                            |  15 ++
 docs/plugins/proxying.md                      |   9 +
 plugins/proxy-backend/package.json            |   2 +-
 plugins/proxy-backend/src/index.ts            |   2 +-
 plugins/proxy-backend/src/service/index.ts    |  17 ++
 .../proxy-backend/src/service/router.test.ts  | 167 +++++++++++++++++-
 plugins/proxy-backend/src/service/router.ts   |  48 ++++-
 7 files changed, 256 insertions(+), 4 deletions(-)
 create mode 100644 .changeset/2804.md
 create mode 100644 plugins/proxy-backend/src/service/index.ts

diff --git a/.changeset/2804.md b/.changeset/2804.md
new file mode 100644
index 0000000000..5223a24791
--- /dev/null
+++ b/.changeset/2804.md
@@ -0,0 +1,15 @@
+---
+'@backstage/plugin-proxy-backend': minor
+---
+
+Limit the http headers that are forwarded from the request to a safe set of defaults.
+A user can configure additional headers that should be forwarded if the specific applications needs that.
+
+```yaml
+proxy:
+  '/my-api':
+    target: 'https://my-api.com/get'
+    allowedHeaders:
+      # We need to forward the Authorization header that was provided by the caller
+      - Authorization
+```
diff --git a/docs/plugins/proxying.md b/docs/plugins/proxying.md
index 3d9aa90447..f55b4d9229 100644
--- a/docs/plugins/proxying.md
+++ b/docs/plugins/proxying.md
@@ -57,6 +57,15 @@ is also possible to limit the forwarded HTTP methods with the configuration
 `allowedMethods`, for example `allowedMethods: ['GET']` to enforce read-only
 access.
 
+By default, the proxy will only forward safe HTTP request headers to the target.
+Those are based on the headers that are considered safe for CORS and includes
+headers like `content-type` or `last-modified`, as well as all headers that are
+set by the proxy. If the proxy should forward other headers like
+`authorization`, this must be enabled by the `allowedHeaders` config, for
+example `allowedHeaders: ['Authorization']`. This should help to not
+accidentally forward confidential headers (`cookie`, `X-Auth-Request-User`) to
+third-parties.
+
 If the value is a string, it is assumed to correspond to:
 
 ```yaml
diff --git a/plugins/proxy-backend/package.json b/plugins/proxy-backend/package.json
index 723c3e395e..11f18287f0 100644
--- a/plugins/proxy-backend/package.json
+++ b/plugins/proxy-backend/package.json
@@ -22,7 +22,6 @@
     "@backstage/backend-common": "^0.1.1-alpha.24",
     "@backstage/config": "^0.1.1-alpha.24",
     "@types/express": "^4.17.6",
-    "@types/http-proxy-middleware": "^0.19.3",
     "express": "^4.17.1",
     "express-promise-router": "^3.0.3",
     "http-proxy-middleware": "^0.19.1",
@@ -36,6 +35,7 @@
   },
   "devDependencies": {
     "@backstage/cli": "^0.1.1-alpha.24",
+    "@types/http-proxy-middleware": "^0.19.3",
     "@types/node-fetch": "^2.5.7",
     "@types/supertest": "^2.0.8",
     "@types/uuid": "^8.0.0",
diff --git a/plugins/proxy-backend/src/index.ts b/plugins/proxy-backend/src/index.ts
index 7612c392a2..de2be19b6d 100644
--- a/plugins/proxy-backend/src/index.ts
+++ b/plugins/proxy-backend/src/index.ts
@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 
-export * from './service/router';
+export * from './service';
diff --git a/plugins/proxy-backend/src/service/index.ts b/plugins/proxy-backend/src/service/index.ts
new file mode 100644
index 0000000000..38fbb697c4
--- /dev/null
+++ b/plugins/proxy-backend/src/service/index.ts
@@ -0,0 +1,17 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { createRouter } from './router';
diff --git a/plugins/proxy-backend/src/service/router.test.ts b/plugins/proxy-backend/src/service/router.test.ts
index 07737e9ea8..012adaed93 100644
--- a/plugins/proxy-backend/src/service/router.test.ts
+++ b/plugins/proxy-backend/src/service/router.test.ts
@@ -14,13 +14,30 @@
  * limitations under the License.
  */
 
-import { createRouter } from './router';
+import { buildMiddleware, createRouter } from './router';
 import * as winston from 'winston';
 import { ConfigReader } from '@backstage/config';
 import {
   loadBackendConfig,
   SingleHostDiscovery,
 } from '@backstage/backend-common';
+import createProxyMiddleware, {
+  Config as ProxyMiddlewareConfig,
+  Proxy,
+} from 'http-proxy-middleware';
+import * as http from 'http';
+
+jest.mock('http-proxy-middleware', () => {
+  return jest.fn().mockImplementation(
+    (): Proxy => {
+      return () => undefined;
+    },
+  );
+});
+
+const mockCreateProxyMiddleware = createProxyMiddleware as jest.MockedFunction<
+  typeof createProxyMiddleware
+>;
 
 describe('createRouter', () => {
   it('works', async () => {
@@ -35,3 +52,151 @@ describe('createRouter', () => {
     expect(router).toBeDefined();
   });
 });
+
+describe('buildMiddleware', () => {
+  const logger = winston.createLogger();
+
+  beforeEach(() => {
+    mockCreateProxyMiddleware.mockClear();
+  });
+
+  it('accepts strings', async () => {
+    buildMiddleware('/api/', logger, 'test', 'http://mocked');
+
+    expect(createProxyMiddleware).toHaveBeenCalledTimes(1);
+
+    const [filter, fullConfig] = mockCreateProxyMiddleware.mock.calls[0] as [
+      (pathname: string, req: Partial<http.IncomingMessage>) => boolean,
+      ProxyMiddlewareConfig,
+    ];
+    expect(filter('', { method: 'GET' })).toBe(true);
+    expect(filter('', { method: 'POST' })).toBe(true);
+    expect(filter('', { method: 'PUT' })).toBe(true);
+    expect(filter('', { method: 'PATCH' })).toBe(true);
+    expect(filter('', { method: 'DELETE' })).toBe(true);
+
+    expect(fullConfig.pathRewrite).toEqual({ '^/api/test/': '/' });
+    expect(fullConfig.changeOrigin).toBe(true);
+    expect(fullConfig.logProvider!(logger)).toBe(logger);
+  });
+
+  it('limits allowedMethods', async () => {
+    buildMiddleware('/api/', logger, 'test', {
+      target: 'http://mocked',
+      allowedMethods: ['GET', 'DELETE'],
+    });
+
+    expect(createProxyMiddleware).toHaveBeenCalledTimes(1);
+
+    const [filter, fullConfig] = mockCreateProxyMiddleware.mock.calls[0] as [
+      (pathname: string, req: Partial<http.IncomingMessage>) => boolean,
+      ProxyMiddlewareConfig,
+    ];
+    expect(filter('', { method: 'GET' })).toBe(true);
+    expect(filter('', { method: 'POST' })).toBe(false);
+    expect(filter('', { method: 'PUT' })).toBe(false);
+    expect(filter('', { method: 'PATCH' })).toBe(false);
+    expect(filter('', { method: 'DELETE' })).toBe(true);
+
+    expect(fullConfig.pathRewrite).toEqual({ '^/api/test/': '/' });
+    expect(fullConfig.changeOrigin).toBe(true);
+    expect(fullConfig.logProvider!(logger)).toBe(logger);
+  });
+
+  it('permits default headers', async () => {
+    buildMiddleware('/api/', logger, 'test', {
+      target: 'http://mocked',
+    });
+
+    expect(createProxyMiddleware).toHaveBeenCalledTimes(1);
+
+    const config = mockCreateProxyMiddleware.mock
+      .calls[0][1] as ProxyMiddlewareConfig;
+
+    const testClientRequest = {
+      getHeaderNames: () => [
+        'cache-control',
+        'content-language',
+        'content-length',
+        'content-type',
+        'expires',
+        'last-modified',
+        'pragma',
+        'host',
+        'accept',
+        'accept-language',
+        'user-agent',
+        'cookie',
+      ],
+      removeHeader: jest.fn(),
+    } as Partial<http.ClientRequest>;
+
+    expect(config).toBeDefined();
+    expect(config.onProxyReq).toBeDefined();
+
+    config.onProxyReq!(
+      testClientRequest as http.ClientRequest,
+      {} as http.IncomingMessage,
+      {} as http.ServerResponse,
+    );
+
+    expect(testClientRequest.removeHeader).toHaveBeenCalledTimes(1);
+    expect(testClientRequest.removeHeader).toHaveBeenCalledWith('cookie');
+  });
+
+  it('permits default and configured headers', async () => {
+    buildMiddleware('/api/', logger, 'test', {
+      target: 'http://mocked',
+      headers: {
+        Authorization: 'my-token',
+      },
+    });
+
+    expect(createProxyMiddleware).toHaveBeenCalledTimes(1);
+
+    const config = mockCreateProxyMiddleware.mock
+      .calls[0][1] as ProxyMiddlewareConfig;
+
+    const testClientRequest = {
+      getHeaderNames: () => ['authorization', 'Cookie'],
+      removeHeader: jest.fn(),
+    } as Partial<http.ClientRequest>;
+
+    config.onProxyReq!(
+      testClientRequest as http.ClientRequest,
+      {} as http.IncomingMessage,
+      {} as http.ServerResponse,
+    );
+
+    expect(testClientRequest.removeHeader).toHaveBeenCalledTimes(1);
+    expect(testClientRequest.removeHeader).toHaveBeenCalledWith('Cookie');
+  });
+
+  it('permits configured headers', async () => {
+    buildMiddleware('/api/', logger, 'test', {
+      target: 'http://mocked',
+      allowedHeaders: ['authorization', 'cookie'],
+    });
+
+    expect(createProxyMiddleware).toHaveBeenCalledTimes(1);
+
+    const config = mockCreateProxyMiddleware.mock
+      .calls[0][1] as ProxyMiddlewareConfig;
+
+    const testClientRequest = {
+      getHeaderNames: () => ['authorization', 'Cookie', 'X-Auth-Request-User'],
+      removeHeader: jest.fn(),
+    } as Partial<http.ClientRequest>;
+
+    config.onProxyReq!(
+      testClientRequest as http.ClientRequest,
+      {} as http.IncomingMessage,
+      {} as http.ServerResponse,
+    );
+
+    expect(testClientRequest.removeHeader).toHaveBeenCalledTimes(1);
+    expect(testClientRequest.removeHeader).toHaveBeenCalledWith(
+      'X-Auth-Request-User',
+    );
+  });
+});
diff --git a/plugins/proxy-backend/src/service/router.ts b/plugins/proxy-backend/src/service/router.ts
index 8cec31719c..75eab029b5 100644
--- a/plugins/proxy-backend/src/service/router.ts
+++ b/plugins/proxy-backend/src/service/router.ts
@@ -25,6 +25,27 @@ import { Logger } from 'winston';
 import http from 'http';
 import { PluginEndpointDiscovery } from '@backstage/backend-common';
 
+// A list of headers that are always forwarded to the proxy targets.
+const safeForwardHeaders = [
+  // https://fetch.spec.whatwg.org/#cors-safelisted-request-header
+  'cache-control',
+  'content-language',
+  'content-length',
+  'content-type',
+  'expires',
+  'last-modified',
+  'pragma',
+
+  // host is overridden by default. if changeOrigin is configured to false,
+  // we assume this is a intentional and should also be forwarded.
+  'host',
+
+  // other headers that we assume to be ok
+  'accept',
+  'accept-language',
+  'user-agent',
+];
+
 export interface RouterOptions {
   logger: Logger;
   config: Config;
@@ -33,11 +54,12 @@ export interface RouterOptions {
 
 export interface ProxyConfig extends ProxyMiddlewareConfig {
   allowedMethods?: string[];
+  allowedHeaders?: string[];
 }
 
 // Creates a proxy middleware, possibly with defaults added on top of the
 // given config.
-function buildMiddleware(
+export function buildMiddleware(
   pathPrefix: string,
   logger: Logger,
   route: string,
@@ -68,6 +90,30 @@ function buildMiddleware(
     return fullConfig?.allowedMethods?.includes(req.method!) ?? true;
   };
 
+  // Only forward the allowed HTTP headers to not forward unwanted secret headers
+  const headerAllowList = new Set<string>(
+    [
+      // allow all safe headers
+      ...safeForwardHeaders,
+
+      // allow all headers that are set by the proxy
+      ...((fullConfig.headers && Object.keys(fullConfig.headers)) || []),
+
+      // allow all configured headers
+      ...(fullConfig.allowedHeaders || []),
+    ].map(h => h.toLocaleLowerCase()),
+  );
+
+  fullConfig.onProxyReq = (proxyReq: http.ClientRequest) => {
+    const headerNames = proxyReq.getHeaderNames();
+
+    headerNames.forEach(h => {
+      if (!headerAllowList.has(h.toLocaleLowerCase())) {
+        proxyReq.removeHeader(h);
+      }
+    });
+  };
+
   return createProxyMiddleware(filter, fullConfig);
 }
 

From 2896a6f02d8033b84780612e6513598320caa4fc Mon Sep 17 00:00:00 2001
From: Taras Mankovski <tarasm@gmail.com>
Date: Thu, 8 Oct 2020 09:20:30 -0400
Subject: [PATCH 092/110] Update loud-lamps-visit.md

---
 .changeset/loud-lamps-visit.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.changeset/loud-lamps-visit.md b/.changeset/loud-lamps-visit.md
index 73618e18f9..9023061643 100644
--- a/.changeset/loud-lamps-visit.md
+++ b/.changeset/loud-lamps-visit.md
@@ -1,5 +1,5 @@
 ---
-'@backstage/cli': minor
+'@backstage/cli': patch
 ---
 
 Including source maps with all packages

From e6b00e3af9ddd7352a37bc4214fe8df1c6dde9b2 Mon Sep 17 00:00:00 2001
From: Oliver Sand <oliver.sand@sda-se.com>
Date: Thu, 8 Oct 2020 14:03:21 +0200
Subject: [PATCH 093/110] feat: remove the backstage.io/definition-at-location
 annotation

The annotation was superseded by the placeholder processor.
---
 .changeset/2803.md                            | 26 ++++++
 .../well-known-annotations.md                 | 40 ++++----
 .../src/ingestion/LocationReaders.ts          |  2 -
 .../ApiDefinitionAtLocationProcessor.test.ts  | 93 -------------------
 .../ApiDefinitionAtLocationProcessor.ts       | 59 ------------
 .../src/ingestion/processors/index.ts         |  1 -
 6 files changed, 45 insertions(+), 176 deletions(-)
 create mode 100644 .changeset/2803.md
 delete mode 100644 plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.test.ts
 delete mode 100644 plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.ts

diff --git a/.changeset/2803.md b/.changeset/2803.md
new file mode 100644
index 0000000000..3a4773757f
--- /dev/null
+++ b/.changeset/2803.md
@@ -0,0 +1,26 @@
+---
+'@backstage/plugin-catalog-backend': minor
+---
+
+Remove the backstage.io/definition-at-location annotation.
+The annotation was superseded by the placeholder processor.
+
+```yaml
+apiVersion: backstage.io/v1alpha1
+kind: API
+metadata:
+  name: spotify
+  description: The Spotify web API
+  tags:
+    - spotify
+    - rest
+  annotations:
+    # Don't use this annotation, but the placeholder $text instead (see below).
+    backstage.io/definition-at-location: 'url:https://raw.githubusercontent.com/APIs-guru/openapi-directory/master/APIs/spotify.com/v1/swagger.yaml'
+spec:
+  type: openapi
+  lifecycle: production
+  owner: spotify@example.com
+  definition:
+    $text: https://raw.githubusercontent.com/APIs-guru/openapi-directory/master/APIs/spotify.com/v1/swagger.yaml
+```
diff --git a/docs/features/software-catalog/well-known-annotations.md b/docs/features/software-catalog/well-known-annotations.md
index 757e0461a9..40a4ca3ea1 100644
--- a/docs/features/software-catalog/well-known-annotations.md
+++ b/docs/features/software-catalog/well-known-annotations.md
@@ -41,27 +41,6 @@ expecting a two-item array out of it. The format of the target part is
 type-dependent and could conceivably even be an empty string, but the separator
 colon is always present.
 
-### backstage.io/definition-at-location
-
-```yaml
-# Example
-apiVersion: backstage.io/v1alpha1
-kind: API
-metadata:
-  name: petstore
-  annotations:
-    backstage.io/definition-at-location: 'url:https://petstore.swagger.io/v2/swagger.json'
-spec:
-  type: openapi
-```
-
-This annotation allows to fetch an API definition from another location, instead
-of wrapping the API definition inside the definition field. This allows to
-easily consume existing API definition. The definition is fetched during
-ingestion by a processor and included in the entity. It is updated on every
-refresh. The annotation contains a location reference string that contains the
-location processor type and the target.
-
 ### backstage.io/techdocs-ref
 
 ```yaml
@@ -205,6 +184,25 @@ This annotation was used for a while to enable the GitHub Actions feature. This
 is now instead using the [github.com/project-slug](#github-com-project-slug)
 annotation, with the same value format.
 
+### backstage.io/definition-at-location
+
+This annotation allowed to load the API definition from another location. Now
+placeholders can be used instead:
+
+```
+apiVersion: backstage.io/v1alpha1
+kind: API
+metadata:
+  name: petstore
+  description: The Petstore API
+spec:
+  type: openapi
+  lifecycle: production
+  owner: petstore@example.com
+  definition:
+    $text: https://petstore.swagger.io/v2/swagger.json
+```
+
 ## Links
 
 - [Descriptor Format: annotations](descriptor-format.md#annotations-optional)
diff --git a/plugins/catalog-backend/src/ingestion/LocationReaders.ts b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
index fcc608eb51..c3f0989a68 100644
--- a/plugins/catalog-backend/src/ingestion/LocationReaders.ts
+++ b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
@@ -26,7 +26,6 @@ import { Config, ConfigReader } from '@backstage/config';
 import { Logger } from 'winston';
 import { CatalogRulesEnforcer } from './CatalogRules';
 import { AnnotateLocationEntityProcessor } from './processors/AnnotateLocationEntityProcessor';
-import { ApiDefinitionAtLocationProcessor } from './processors/ApiDefinitionAtLocationProcessor';
 import { AzureApiReaderProcessor } from './processors/AzureApiReaderProcessor';
 import { BitbucketApiReaderProcessor } from './processors/BitbucketApiReaderProcessor';
 import { CodeOwnersProcessor } from './processors/CodeOwnersProcessor';
@@ -127,7 +126,6 @@ export class LocationReaders implements LocationReader {
       new YamlProcessor(),
       PlaceholderProcessor.default(),
       new CodeOwnersProcessor(),
-      new ApiDefinitionAtLocationProcessor(),
       new EntityPolicyProcessor(entityPolicy),
       new LocationRefProcessor(),
       new AnnotateLocationEntityProcessor(),
diff --git a/plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.test.ts b/plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.test.ts
deleted file mode 100644
index 6ae6562339..0000000000
--- a/plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.test.ts
+++ /dev/null
@@ -1,93 +0,0 @@
-import { ApiEntity, Entity, LocationSpec } from '@backstage/catalog-model';
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 { ApiDefinitionAtLocationProcessor } from './ApiDefinitionAtLocationProcessor';
-
-describe('ApiDefinitionAtLocationProcessor', () => {
-  let processor: ApiDefinitionAtLocationProcessor;
-  let entity: Entity;
-  let location: LocationSpec;
-
-  beforeEach(() => {
-    processor = new ApiDefinitionAtLocationProcessor();
-    entity = {
-      apiVersion: 'backstage.io/v1alpha1',
-      kind: 'API',
-      metadata: {
-        name: 'test',
-      },
-      spec: {
-        lifecycle: 'production',
-        owner: 'info@example.com',
-        type: 'openapi',
-        definition: 'Hello',
-      },
-    };
-    location = {
-      type: 'url',
-      target: `http://example.com/api.yaml`,
-    };
-  });
-
-  it('should skip entities without annotation', async () => {
-    const read = jest.fn().mockRejectedValue(new Error('boo'));
-
-    const generated = (await processor.processEntity(
-      entity,
-      location,
-      () => {},
-      read,
-    )) as ApiEntity;
-
-    expect(generated.spec.definition).toBe('Hello');
-  });
-
-  it('should load from location', async () => {
-    entity.metadata.annotations = {
-      'backstage.io/definition-at-location':
-        'url:http://example.com/openapi.yaml',
-    };
-
-    const read = jest.fn().mockResolvedValue(Buffer.from('Hello'));
-
-    const generated = (await processor.processEntity(
-      entity,
-      location,
-      () => {},
-      read,
-    )) as ApiEntity;
-
-    expect(generated.spec.definition).toBe('Hello');
-    expect(read.mock.calls[0][0]).toStrictEqual({
-      type: 'url',
-      target: 'http://example.com/openapi.yaml',
-    });
-  });
-
-  it('should throw errors while loading', async () => {
-    entity.metadata.annotations = {
-      'backstage.io/definition-at-location': 'missing',
-    };
-
-    const read = jest
-      .fn()
-      .mockRejectedValue(new Error('Failed to load location'));
-
-    await expect(
-      processor.processEntity(entity, location, () => {}, read),
-    ).rejects.toThrow('Failed to load location');
-  });
-});
diff --git a/plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.ts b/plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.ts
deleted file mode 100644
index e64d112e9c..0000000000
--- a/plugins/catalog-backend/src/ingestion/processors/ApiDefinitionAtLocationProcessor.ts
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 { ApiEntity, Entity, LocationSpec } from '@backstage/catalog-model';
-import {
-  LocationProcessor,
-  LocationProcessorEmit,
-  LocationProcessorRead,
-} from './types';
-
-const DEFINITION_AT_LOCATION_ANNOTATION = 'backstage.io/definition-at-location';
-
-export class ApiDefinitionAtLocationProcessor implements LocationProcessor {
-  async processEntity(
-    entity: Entity,
-    _location: LocationSpec,
-    _emit: LocationProcessorEmit,
-    read: LocationProcessorRead,
-  ): Promise<Entity> {
-    if (
-      entity.kind !== 'API' ||
-      !entity.metadata.annotations ||
-      !entity.metadata.annotations[DEFINITION_AT_LOCATION_ANNOTATION]
-    ) {
-      return entity;
-    }
-
-    const reference =
-      entity.metadata.annotations[DEFINITION_AT_LOCATION_ANNOTATION];
-    const { type, target } = extractReference(reference);
-    const data = await read({ type, target });
-    const definition = data.toString();
-    const apiEntity = entity as ApiEntity;
-    apiEntity.spec.definition = definition;
-
-    return entity;
-  }
-}
-
-function extractReference(reference: string): { type: string; target: string } {
-  const delimiterIndex = reference.indexOf(':');
-  const type = reference.slice(0, delimiterIndex);
-  const target = reference.slice(delimiterIndex + 1);
-
-  return { type, target };
-}
diff --git a/plugins/catalog-backend/src/ingestion/processors/index.ts b/plugins/catalog-backend/src/ingestion/processors/index.ts
index 0ce7f11a5f..c9453d0247 100644
--- a/plugins/catalog-backend/src/ingestion/processors/index.ts
+++ b/plugins/catalog-backend/src/ingestion/processors/index.ts
@@ -20,7 +20,6 @@ export { results };
 export * from './types';
 
 export { AnnotateLocationEntityProcessor } from './AnnotateLocationEntityProcessor';
-export { ApiDefinitionAtLocationProcessor } from './ApiDefinitionAtLocationProcessor';
 export { AzureApiReaderProcessor } from './AzureApiReaderProcessor';
 export { BitbucketApiReaderProcessor } from './BitbucketApiReaderProcessor';
 export { CodeOwnersProcessor } from './CodeOwnersProcessor';

From ce1f5539818c87498572edf8aa1b24908c54cfeb Mon Sep 17 00:00:00 2001
From: Oliver Sand <oliver.sand@sda-se.com>
Date: Thu, 8 Oct 2020 11:51:23 +0200
Subject: [PATCH 094/110] feat: use new UrlReader in PlaceholderProcessor

---
 .changeset/2798.md                            |   7 +
 .../catalog-model/examples/spotify-api.yaml   |   3 +
 .../src/ingestion/LocationReaders.ts          |   2 +-
 .../processors/PlaceholderProcessor.test.ts   | 133 +++++++-----------
 .../processors/PlaceholderProcessor.ts        |  65 ++++-----
 5 files changed, 94 insertions(+), 116 deletions(-)
 create mode 100644 .changeset/2798.md

diff --git a/.changeset/2798.md b/.changeset/2798.md
new file mode 100644
index 0000000000..2b202142ef
--- /dev/null
+++ b/.changeset/2798.md
@@ -0,0 +1,7 @@
+---
+'@backstage/plugin-catalog-backend': minor
+---
+
+Use the new `UrlReader` in `PlaceholderProcessor`.
+This allows to use the placeholder processor to include API definitions in API entities.
+Previously it was only possible to do this if the definition comes from the same location type as the entity itself.
diff --git a/packages/catalog-model/examples/spotify-api.yaml b/packages/catalog-model/examples/spotify-api.yaml
index 30524dfdd4..14deb17abe 100644
--- a/packages/catalog-model/examples/spotify-api.yaml
+++ b/packages/catalog-model/examples/spotify-api.yaml
@@ -7,8 +7,11 @@ metadata:
     - spotify
     - rest
   annotations:
+    # The annotation is deprecated, we use placeholders (see below) instead, remove it later.
     backstage.io/definition-at-location: 'url:https://raw.githubusercontent.com/APIs-guru/openapi-directory/master/APIs/spotify.com/v1/swagger.yaml'
 spec:
   type: openapi
   lifecycle: production
   owner: spotify@example.com
+  definition:
+    $text: https://github.com/APIs-guru/openapi-directory/blob/master/APIs/spotify.com/v1/swagger.yaml
diff --git a/plugins/catalog-backend/src/ingestion/LocationReaders.ts b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
index fcc608eb51..45822f0ae6 100644
--- a/plugins/catalog-backend/src/ingestion/LocationReaders.ts
+++ b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
@@ -125,7 +125,7 @@ export class LocationReaders implements LocationReader {
       LdapOrgReaderProcessor.fromConfig(config, { logger }),
       new UrlReaderProcessor(options),
       new YamlProcessor(),
-      PlaceholderProcessor.default(),
+      PlaceholderProcessor.default({ reader: options.reader }),
       new CodeOwnersProcessor(),
       new ApiDefinitionAtLocationProcessor(),
       new EntityPolicyProcessor(entityPolicy),
diff --git a/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.test.ts b/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.test.ts
index 6893cae0e7..c196458e2a 100644
--- a/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.test.ts
+++ b/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.test.ts
@@ -13,20 +13,20 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
+import { UrlReader } from '@backstage/backend-common';
 import { Entity } from '@backstage/catalog-model';
 import {
   jsonPlaceholderResolver,
   PlaceholderProcessor,
   PlaceholderResolver,
   ResolverParams,
+  ResolverRead,
   yamlPlaceholderResolver,
 } from './PlaceholderProcessor';
-import { LocationProcessorEmit, LocationProcessorRead } from './types';
 
 describe('PlaceholderProcessor', () => {
-  const emit: LocationProcessorEmit = jest.fn();
-  const read: jest.MockedFunction<LocationProcessorRead> = jest.fn();
+  const read: jest.MockedFunction<ResolverRead> = jest.fn();
+  const reader: UrlReader = { read };
 
   beforeEach(() => {
     jest.resetAllMocks();
@@ -39,10 +39,13 @@ describe('PlaceholderProcessor', () => {
       metadata: { name: 'n' },
     };
     const processor = new PlaceholderProcessor({
-      foo: async () => 'replaced',
+      resolvers: {
+        foo: async () => 'replaced',
+      },
+      reader,
     });
     await expect(
-      processor.processEntity(input, { type: 't', target: 'l' }, emit, read),
+      processor.processEntity(input, { type: 't', target: 'l' }),
     ).resolves.toBe(input);
   });
 
@@ -51,7 +54,10 @@ describe('PlaceholderProcessor', () => {
       value!.toString().toUpperCase(),
     );
     const processor = new PlaceholderProcessor({
-      upper: upperResolver,
+      resolvers: {
+        upper: upperResolver,
+      },
+      reader,
     });
 
     await expect(
@@ -63,8 +69,6 @@ describe('PlaceholderProcessor', () => {
           spec: { a: [{ b: { $upper: 'text' } }] },
         },
         { type: 'fake', target: 'http://example.com' },
-        emit,
-        read,
       ),
     ).resolves.toEqual({
       apiVersion: 'a',
@@ -73,20 +77,23 @@ describe('PlaceholderProcessor', () => {
       spec: { a: [{ b: 'TEXT' }] },
     });
 
-    expect(emit).not.toBeCalled();
     expect(read).not.toBeCalled();
-    expect(upperResolver).toBeCalledWith({
-      key: 'upper',
-      value: 'text',
-      location: { type: 'fake', target: 'http://example.com' },
-      read,
-    });
+    expect(upperResolver).toBeCalledWith(
+      expect.objectContaining({
+        key: 'upper',
+        value: 'text',
+        baseUrl: 'http://example.com',
+      }),
+    );
   });
 
   it('rejects multiple placeholders', async () => {
     const processor = new PlaceholderProcessor({
-      foo: jest.fn(),
-      bar: jest.fn(),
+      resolvers: {
+        foo: jest.fn(),
+        bar: jest.fn(),
+      },
+      reader,
     });
 
     await expect(
@@ -97,20 +104,20 @@ describe('PlaceholderProcessor', () => {
           metadata: { name: 'n', x: { $foo: 'a', $bar: 'b' } },
         },
         { type: 'a', target: 'b' },
-        emit,
-        read,
       ),
     ).rejects.toThrow(
       'Placeholders have to be on the form of a single $-prefixed key in an object',
     );
 
-    expect(emit).not.toBeCalled();
     expect(read).not.toBeCalled();
   });
 
   it('rejects unknown placeholders', async () => {
     const processor = new PlaceholderProcessor({
-      bar: jest.fn(),
+      resolvers: {
+        bar: jest.fn(),
+      },
+      reader,
     });
 
     await expect(
@@ -121,18 +128,15 @@ describe('PlaceholderProcessor', () => {
           metadata: { name: 'n', x: { $foo: 'a' } },
         },
         { type: 'a', target: 'b' },
-        emit,
-        read,
       ),
     ).rejects.toThrow('Encountered unknown placeholder $foo');
 
-    expect(emit).not.toBeCalled();
     expect(read).not.toBeCalled();
   });
 
   it('has builtin text support', async () => {
     read.mockResolvedValue(Buffer.from('TEXT', 'utf-8'));
-    const processor = PlaceholderProcessor.default();
+    const processor = PlaceholderProcessor.default({ reader });
 
     await expect(
       processor.processEntity(
@@ -146,8 +150,6 @@ describe('PlaceholderProcessor', () => {
           type: 'github',
           target: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
         },
-        emit,
-        read,
       ),
     ).resolves.toEqual({
       apiVersion: 'a',
@@ -156,18 +158,16 @@ describe('PlaceholderProcessor', () => {
       spec: { data: 'TEXT' },
     });
 
-    expect(emit).not.toBeCalled();
-    expect(read).toBeCalledWith({
-      type: 'github',
-      target: 'https://github.com/spotify/backstage/a/file.txt',
-    });
+    expect(read).toBeCalledWith(
+      'https://github.com/spotify/backstage/a/file.txt',
+    );
   });
 
   it('has builtin json support', async () => {
     read.mockResolvedValue(
       Buffer.from(JSON.stringify({ a: ['b', 7] }), 'utf-8'),
     );
-    const processor = PlaceholderProcessor.default();
+    const processor = PlaceholderProcessor.default({ reader });
 
     await expect(
       processor.processEntity(
@@ -181,8 +181,6 @@ describe('PlaceholderProcessor', () => {
           type: 'github',
           target: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
         },
-        emit,
-        read,
       ),
     ).resolves.toEqual({
       apiVersion: 'a',
@@ -191,16 +189,14 @@ describe('PlaceholderProcessor', () => {
       spec: { data: { a: ['b', 7] } },
     });
 
-    expect(emit).not.toBeCalled();
-    expect(read).toBeCalledWith({
-      type: 'github',
-      target: 'https://github.com/spotify/backstage/a/b/file.json',
-    });
+    expect(read).toBeCalledWith(
+      'https://github.com/spotify/backstage/a/b/file.json',
+    );
   });
 
   it('has builtin yaml support', async () => {
     read.mockResolvedValue(Buffer.from('foo:\n  - bar: 7', 'utf-8'));
-    const processor = PlaceholderProcessor.default();
+    const processor = PlaceholderProcessor.default({ reader });
 
     await expect(
       processor.processEntity(
@@ -214,8 +210,6 @@ describe('PlaceholderProcessor', () => {
           type: 'github',
           target: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
         },
-        emit,
-        read,
       ),
     ).resolves.toEqual({
       apiVersion: 'a',
@@ -224,16 +218,14 @@ describe('PlaceholderProcessor', () => {
       spec: { data: { foo: [{ bar: 7 }] } },
     });
 
-    expect(emit).not.toBeCalled();
-    expect(read).toBeCalledWith({
-      type: 'github',
-      target: 'https://github.com/spotify/backstage/a/file.yaml',
-    });
+    expect(read).toBeCalledWith(
+      'https://github.com/spotify/backstage/a/file.yaml',
+    );
   });
 
   it('resolves absolute path for absolute location', async () => {
     read.mockResolvedValue(Buffer.from('TEXT', 'utf-8'));
-    const processor = PlaceholderProcessor.default();
+    const processor = PlaceholderProcessor.default({ reader });
 
     await expect(
       processor.processEntity(
@@ -251,8 +243,6 @@ describe('PlaceholderProcessor', () => {
           type: 'github',
           target: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
         },
-        emit,
-        read,
       ),
     ).resolves.toEqual({
       apiVersion: 'a',
@@ -261,16 +251,14 @@ describe('PlaceholderProcessor', () => {
       spec: { data: 'TEXT' },
     });
 
-    expect(emit).not.toBeCalled();
-    expect(read).toBeCalledWith({
-      type: 'github',
-      target: 'https://github.com/spotify/backstage/catalog-info.yaml',
-    });
+    expect(read).toBeCalledWith(
+      'https://github.com/spotify/backstage/catalog-info.yaml',
+    );
   });
 
   it('resolves absolute path for relative file location', async () => {
     read.mockResolvedValue(Buffer.from('TEXT', 'utf-8'));
-    const processor = PlaceholderProcessor.default();
+    const processor = PlaceholderProcessor.default({ reader });
 
     await expect(
       processor.processEntity(
@@ -288,8 +276,6 @@ describe('PlaceholderProcessor', () => {
           type: 'github',
           target: './a/b/catalog-info.yaml',
         },
-        emit,
-        read,
       ),
     ).resolves.toEqual({
       apiVersion: 'a',
@@ -298,11 +284,9 @@ describe('PlaceholderProcessor', () => {
       spec: { data: 'TEXT' },
     });
 
-    expect(emit).not.toBeCalled();
-    expect(read).toBeCalledWith({
-      type: 'github',
-      target: 'https://github.com/spotify/backstage/catalog-info.yaml',
-    });
+    expect(read).toBeCalledWith(
+      'https://github.com/spotify/backstage/catalog-info.yaml',
+    );
   });
 
   it('not resolves relative file path for relative file location', async () => {
@@ -310,7 +294,7 @@ describe('PlaceholderProcessor', () => {
     // traversel attacks. If we want to implement this, we need to have additional
     // security measures in place!
     read.mockResolvedValue(Buffer.from('TEXT', 'utf-8'));
-    const processor = PlaceholderProcessor.default();
+    const processor = PlaceholderProcessor.default({ reader });
 
     await expect(
       processor.processEntity(
@@ -328,27 +312,21 @@ describe('PlaceholderProcessor', () => {
           type: 'github',
           target: './a/b/catalog-info.yaml',
         },
-        emit,
-        read,
       ),
     ).rejects.toThrow(
       'Placeholder $text could not form an URL out of ./a/b/catalog-info.yaml and ../c/catalog-info.yaml',
     );
 
-    expect(emit).not.toBeCalled();
     expect(read).not.toBeCalled();
   });
 });
 
 describe('yamlPlaceholderResolver', () => {
-  const read: jest.MockedFunction<LocationProcessorRead> = jest.fn();
+  const read: jest.MockedFunction<ResolverRead> = jest.fn();
   const params: ResolverParams = {
     key: 'a',
     value: './file.yaml',
-    location: {
-      type: 'github',
-      target: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
-    },
+    baseUrl: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
     read,
   };
 
@@ -388,14 +366,11 @@ describe('yamlPlaceholderResolver', () => {
 });
 
 describe('jsonPlaceholderResolver', () => {
-  const read: jest.MockedFunction<LocationProcessorRead> = jest.fn();
+  const read: jest.MockedFunction<ResolverRead> = jest.fn();
   const params: ResolverParams = {
     key: 'a',
     value: './file.json',
-    location: {
-      type: 'github',
-      target: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
-    },
+    baseUrl: 'https://github.com/spotify/backstage/a/b/catalog-info.yaml',
     read,
   };
 
diff --git a/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.ts b/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.ts
index b811d217d5..91257b68a4 100644
--- a/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.ts
+++ b/plugins/catalog-backend/src/ingestion/processors/PlaceholderProcessor.ts
@@ -14,49 +14,49 @@
  * limitations under the License.
  */
 
+import { UrlReader } from '@backstage/backend-common';
 import { Entity, LocationSpec } from '@backstage/catalog-model';
 import { JsonValue } from '@backstage/config';
 import yaml from 'yaml';
-import {
-  LocationProcessor,
-  LocationProcessorEmit,
-  LocationProcessorRead,
-} from './types';
+import { LocationProcessor } from './types';
+
+export type ResolverRead = (url: string) => Promise<Buffer>;
 
 export type ResolverParams = {
   key: string;
   value: JsonValue;
-  location: LocationSpec;
-  read: LocationProcessorRead;
+  baseUrl: string;
+  read: ResolverRead;
 };
 
 export type PlaceholderResolver = (
   params: ResolverParams,
 ) => Promise<JsonValue>;
 
+type Options = {
+  resolvers: Record<string, PlaceholderResolver>;
+  reader: UrlReader;
+};
+
 /**
  * Traverses raw entity JSON looking for occurrences of $-prefixed placeholders
  * that it then fills in with actual data.
  */
 export class PlaceholderProcessor implements LocationProcessor {
-  static default() {
+  static default({ reader }: { reader: UrlReader }) {
     return new PlaceholderProcessor({
-      json: jsonPlaceholderResolver,
-      yaml: yamlPlaceholderResolver,
-      text: textPlaceholderResolver,
+      resolvers: {
+        json: jsonPlaceholderResolver,
+        yaml: yamlPlaceholderResolver,
+        text: textPlaceholderResolver,
+      },
+      reader,
     });
   }
 
-  constructor(
-    private readonly resolvers: Record<string, PlaceholderResolver>,
-  ) {}
+  constructor(private readonly options: Options) {}
 
-  async processEntity(
-    entity: Entity,
-    location: LocationSpec,
-    _emit: LocationProcessorEmit,
-    read: LocationProcessorRead,
-  ): Promise<Entity> {
+  async processEntity(entity: Entity, location: LocationSpec): Promise<Entity> {
     const process = async (data: any): Promise<[any, boolean]> => {
       if (!data || !(data instanceof Object)) {
         // Scalars can't have placeholders
@@ -90,7 +90,7 @@ export class PlaceholderProcessor implements LocationProcessor {
       }
 
       const resolverKey = keys[0].substr(1);
-      const resolver = this.resolvers[resolverKey];
+      const resolver = this.options.resolvers[resolverKey];
       if (!resolver) {
         throw new Error(`Encountered unknown placeholder \$${resolverKey}`);
       }
@@ -99,8 +99,8 @@ export class PlaceholderProcessor implements LocationProcessor {
         await resolver({
           key: resolverKey,
           value: data[keys[0]],
-          location,
-          read,
+          baseUrl: location.target,
+          read: this.options.reader.read.bind(this.options.reader),
         }),
         true,
       ];
@@ -171,10 +171,10 @@ export async function textPlaceholderResolver(
  */
 
 async function readTextLocation(params: ResolverParams): Promise<string> {
-  const newLocation = relativeLocation(params);
+  const newUrl = relativeUrl(params);
 
   try {
-    const data = await params.read(newLocation);
+    const data = await params.read(newUrl);
     return data.toString('utf-8');
   } catch (e) {
     throw new Error(
@@ -183,11 +183,7 @@ async function readTextLocation(params: ResolverParams): Promise<string> {
   }
 }
 
-function relativeLocation({
-  key,
-  value,
-  location,
-}: ResolverParams): LocationSpec {
+function relativeUrl({ key, value, baseUrl }: ResolverParams): string {
   if (typeof value !== 'string') {
     throw new Error(
       `Placeholder \$${key} expected a string value parameter, in the form of an absolute URL or a relative path`,
@@ -197,7 +193,7 @@ function relativeLocation({
   let url: URL;
   try {
     // The two-value form of the URL constructor handles relative paths for us
-    url = new URL(value, location.target);
+    url = new URL(value, baseUrl);
   } catch {
     try {
       // Check whether value is a valid absolute URL on it's own, if not fail.
@@ -208,13 +204,10 @@ function relativeLocation({
       // path traversal attacks and access to any file on the host system. Implementing this
       // would require additional security measures.
       throw new Error(
-        `Placeholder \$${key} could not form an URL out of ${location.target} and ${value}`,
+        `Placeholder \$${key} could not form an URL out of ${baseUrl} and ${value}`,
       );
     }
   }
 
-  return {
-    type: location.type,
-    target: url.toString(),
-  };
+  return url.toString();
 }

From 512d709736cdf046045a6190e9fde98e1a65bb58 Mon Sep 17 00:00:00 2001
From: Oliver Sand <oliver.sand@sda-se.com>
Date: Thu, 8 Oct 2020 14:36:22 +0200
Subject: [PATCH 095/110] feat: use the new UrlReader in the
 CodeOwnersProcessor

---
 .changeset/codeowner-processor-url-reader.md  |  5 ++
 .../src/ingestion/LocationReaders.ts          |  2 +-
 .../processors/CodeOwnersProcessor.test.ts    | 70 ++++++++-----------
 .../processors/CodeOwnersProcessor.ts         | 51 ++++++--------
 4 files changed, 60 insertions(+), 68 deletions(-)
 create mode 100644 .changeset/codeowner-processor-url-reader.md

diff --git a/.changeset/codeowner-processor-url-reader.md b/.changeset/codeowner-processor-url-reader.md
new file mode 100644
index 0000000000..af4eb0997f
--- /dev/null
+++ b/.changeset/codeowner-processor-url-reader.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-catalog-backend': minor
+---
+
+Use the new `UrlReader` in the `CodeOwnersProcessor`.
diff --git a/plugins/catalog-backend/src/ingestion/LocationReaders.ts b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
index 5ee6e38b28..8cbaaa3e8e 100644
--- a/plugins/catalog-backend/src/ingestion/LocationReaders.ts
+++ b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
@@ -125,7 +125,7 @@ export class LocationReaders implements LocationReader {
       new UrlReaderProcessor(options),
       new YamlProcessor(),
       PlaceholderProcessor.default({ reader: options.reader }),
-      new CodeOwnersProcessor(),
+      new CodeOwnersProcessor({ reader: options.reader }),
       new EntityPolicyProcessor(entityPolicy),
       new LocationRefProcessor(),
       new AnnotateLocationEntityProcessor(),
diff --git a/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.test.ts b/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.test.ts
index 29f94dd0d7..c1c83b7c6c 100644
--- a/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.test.ts
+++ b/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.test.ts
@@ -17,7 +17,7 @@
 import { LocationSpec } from '@backstage/catalog-model';
 import { CodeOwnersEntry } from 'codeowners-utils';
 import {
-  buildCodeOwnerLocation,
+  buildCodeOwnerUrl,
   buildUrl,
   CodeOwnersProcessor,
   findPrimaryCodeOwner,
@@ -28,18 +28,18 @@ import {
 } from './CodeOwnersProcessor';
 
 describe(CodeOwnersProcessor, () => {
+  const mockUrl = ({ basePath = '' } = {}): string =>
+    `https://github.com/spotify/backstage/blob/master/${basePath}catalog-info.yaml`;
   const mockLocation = ({
     basePath = '',
     type = 'github',
   } = {}): LocationSpec => ({
     type,
-    target: `https://github.com/spotify/backstage/blob/master/${basePath}catalog-info.yaml`,
+    target: mockUrl({ basePath }),
   });
 
-  const mockReadLocation = (basePath = '') => ({
-    type: 'github',
-    target: `https://github.com/spotify/backstage/blob/master/${basePath}CODEOWNERS`,
-  });
+  const mockReadUrl = (basePath = '') =>
+    `https://github.com/spotify/backstage/blob/master/${basePath}CODEOWNERS`;
 
   const mockGitUri = (codeOwnersPath: string = '') => {
     return {
@@ -99,27 +99,20 @@ describe(CodeOwnersProcessor, () => {
     });
   });
 
-  describe(buildCodeOwnerLocation, () => {
-    it('should builds a location spec to the codeowners', () => {
-      expect(
-        buildCodeOwnerLocation(mockLocation(), '/docs/CODEOWNERS'),
-      ).toEqual({
-        type: 'github',
-        target:
-          'https://github.com/spotify/backstage/blob/master/docs/CODEOWNERS',
-      });
+  describe(buildCodeOwnerUrl, () => {
+    it('should build a location spec to the codeowners', () => {
+      expect(buildCodeOwnerUrl(mockUrl(), '/docs/CODEOWNERS')).toEqual(
+        'https://github.com/spotify/backstage/blob/master/docs/CODEOWNERS',
+      );
     });
 
     it('should handle nested paths from original location spec', () => {
       expect(
-        buildCodeOwnerLocation(
-          mockLocation({ basePath: 'packages/foo/' }),
+        buildCodeOwnerUrl(
+          mockUrl({ basePath: 'packages/foo/' }),
           '/CODEOWNERS',
         ),
-      ).toEqual({
-        type: 'github',
-        target: 'https://github.com/spotify/backstage/blob/master/CODEOWNERS',
-      });
+      ).toEqual('https://github.com/spotify/backstage/blob/master/CODEOWNERS');
     });
   });
 
@@ -158,15 +151,17 @@ describe(CodeOwnersProcessor, () => {
       const read = jest
         .fn()
         .mockResolvedValue(mockReadResult({ data: ownersText }));
-      const result = await findRawCodeOwners(mockLocation(), read);
+      const reader = { read };
+      const result = await findRawCodeOwners(mockLocation(), reader);
       expect(result).toEqual(ownersText);
     });
 
     it('should raise error when no codeowner', async () => {
       const read = jest.fn().mockRejectedValue(mockReadResult());
+      const reader = { read };
 
       await expect(
-        findRawCodeOwners(mockLocation(), read),
+        findRawCodeOwners(mockLocation(), reader),
       ).rejects.toBeInstanceOf(Error);
     });
 
@@ -177,13 +172,14 @@ describe(CodeOwnersProcessor, () => {
         .mockImplementationOnce(() => mockReadResult({ error: 'foo' }))
         .mockImplementationOnce(() => mockReadResult({ error: 'bar' }))
         .mockResolvedValue(mockReadResult({ data: ownersText }));
+      const reader = { read };
 
-      const result = await findRawCodeOwners(mockLocation(), read);
+      const result = await findRawCodeOwners(mockLocation(), reader);
 
       expect(read.mock.calls.length).toBe(3);
-      expect(read.mock.calls[0]).toEqual([mockReadLocation('.github/')]);
-      expect(read.mock.calls[1]).toEqual([mockReadLocation('')]);
-      expect(read.mock.calls[2]).toEqual([mockReadLocation('docs/')]);
+      expect(read.mock.calls[0]).toEqual([mockReadUrl('.github/')]);
+      expect(read.mock.calls[1]).toEqual([mockReadUrl('')]);
+      expect(read.mock.calls[2]).toEqual([mockReadUrl('docs/')]);
       expect(result).toEqual(ownersText);
     });
   });
@@ -193,7 +189,9 @@ describe(CodeOwnersProcessor, () => {
       const read = jest
         .fn()
         .mockResolvedValue(mockReadResult({ data: mockCodeOwnersText() }));
-      const owner = await resolveCodeOwner(mockLocation(), read);
+      const reader = { read };
+
+      const owner = await resolveCodeOwner(mockLocation(), reader);
       expect(owner).toBe('backstage-core');
     });
 
@@ -201,9 +199,10 @@ describe(CodeOwnersProcessor, () => {
       const read = jest
         .fn()
         .mockImplementation(() => mockReadResult({ error: 'error: foo' }));
+      const reader = { read };
 
       await expect(
-        resolveCodeOwner(mockLocation(), read),
+        resolveCodeOwner(mockLocation(), reader),
       ).rejects.toBeInstanceOf(Error);
     });
   });
@@ -211,10 +210,11 @@ describe(CodeOwnersProcessor, () => {
   describe(CodeOwnersProcessor, () => {
     const setupTest = ({ kind = 'Component', spec = {} } = {}) => {
       const entity = { kind, spec };
-      const processor = new CodeOwnersProcessor();
       const read = jest
         .fn()
         .mockResolvedValue(mockReadResult({ data: mockCodeOwnersText() }));
+      const reader = { read };
+      const processor = new CodeOwnersProcessor({ reader });
 
       return { entity, processor, read };
     };
@@ -227,8 +227,6 @@ describe(CodeOwnersProcessor, () => {
       const result = await processor.processEntity(
         entity as any,
         mockLocation(),
-        null as any,
-        null as any,
       );
 
       expect(result).toEqual(entity);
@@ -240,8 +238,6 @@ describe(CodeOwnersProcessor, () => {
       const result = await processor.processEntity(
         entity as any,
         mockLocation({ type: 'url' }),
-        null as any,
-        null as any,
       );
 
       expect(result).toEqual(entity);
@@ -253,21 +249,17 @@ describe(CodeOwnersProcessor, () => {
       const result = await processor.processEntity(
         entity as any,
         mockLocation(),
-        null as any,
-        null as any,
       );
 
       expect(result).toEqual(entity);
     });
 
     it('should set owner from codeowner', async () => {
-      const { entity, processor, read } = setupTest();
+      const { entity, processor } = setupTest();
 
       const result = await processor.processEntity(
         entity as any,
         mockLocation(),
-        null as any,
-        read,
       );
 
       expect(result).toEqual({
diff --git a/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.ts b/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.ts
index c875bdc799..e624af91ee 100644
--- a/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.ts
+++ b/plugins/catalog-backend/src/ingestion/processors/CodeOwnersProcessor.ts
@@ -14,12 +14,9 @@
  * limitations under the License.
  */
 
+import { UrlReader } from '@backstage/backend-common';
 import { Entity, LocationSpec } from '@backstage/catalog-model';
-import {
-  LocationProcessor,
-  LocationProcessorEmit,
-  LocationProcessorRead,
-} from './types';
+import { LocationProcessor } from './types';
 import * as codeowners from 'codeowners-utils';
 import { CodeOwnersEntry } from 'codeowners-utils';
 import parseGitUri from 'git-url-parse';
@@ -37,13 +34,14 @@ const ALLOWED_LOCATION_TYPES = [
   'gitlab/api',
 ];
 
+type Options = {
+  reader: UrlReader;
+};
+
 export class CodeOwnersProcessor implements LocationProcessor {
-  async processEntity(
-    entity: Entity,
-    location: LocationSpec,
-    _emit: LocationProcessorEmit,
-    read: LocationProcessorRead,
-  ): Promise<Entity> {
+  constructor(private readonly options: Options) {}
+
+  async processEntity(entity: Entity, location: LocationSpec): Promise<Entity> {
     // Only continue if the owner is not set
     if (
       !entity ||
@@ -54,7 +52,7 @@ export class CodeOwnersProcessor implements LocationProcessor {
       return entity;
     }
 
-    const owner = await resolveCodeOwner(location, read);
+    const owner = await resolveCodeOwner(location, this.options.reader);
 
     return {
       ...entity,
@@ -65,9 +63,9 @@ export class CodeOwnersProcessor implements LocationProcessor {
 
 export async function resolveCodeOwner(
   location: LocationSpec,
-  read: LocationProcessorRead,
+  reader: UrlReader,
 ): Promise<string | undefined> {
-  const ownersText = await findRawCodeOwners(location, read);
+  const ownersText = await findRawCodeOwners(location, reader);
 
   if (!ownersText) {
     throw Error(`Unable to find codeowners file for: ${location.target}`);
@@ -80,15 +78,14 @@ export async function resolveCodeOwner(
 
 export async function findRawCodeOwners(
   location: LocationSpec,
-  read: LocationProcessorRead,
+  reader: UrlReader,
 ): Promise<string | undefined> {
   const readOwnerLocation = async (basePath: string): Promise<string> => {
-    const ownerLocation = buildCodeOwnerLocation(
-      location,
+    const ownerUrl = buildCodeOwnerUrl(
+      location.target,
       `${basePath}/CODEOWNERS`,
     );
-
-    const data = await read(ownerLocation);
+    const data = await reader.read(ownerUrl);
     return data.toString();
   };
 
@@ -101,6 +98,13 @@ export async function findRawCodeOwners(
   ]);
 }
 
+export function buildCodeOwnerUrl(
+  basePath: string,
+  codeOwnersPath: string,
+): string {
+  return buildUrl({ ...parseGitUri(basePath), codeOwnersPath });
+}
+
 export function parseCodeOwners(ownersText: string) {
   return codeowners.parse(ownersText);
 }
@@ -128,15 +132,6 @@ export function normalizeCodeOwner(owner: string) {
   return owner;
 }
 
-export function buildCodeOwnerLocation(
-  location: LocationSpec,
-  codeOwnersPath: string,
-): LocationSpec {
-  const { type, target } = location;
-
-  return { type, target: buildUrl({ ...parseGitUri(target), codeOwnersPath }) };
-}
-
 export function buildUrl({
   protocol = 'https',
   source = 'github.com',

From 2476e3fa2572a726d92022b0ec9be46af8166567 Mon Sep 17 00:00:00 2001
From: Iain Billett <iain@roadie.io>
Date: Mon, 5 Oct 2020 16:55:34 +0100
Subject: [PATCH 096/110] Add Dockerfile for helm chart

Add a Dockerfile which can be used to build an image that the helm
charts will use as default. These images require mkdocs and cookiecutter
to be installed (for now) in order to work around the docker requirement
in kubernetes.
---
 .../kubernetes-example-backend/Dockerfile     | 35 +++++++++++++++++++
 .../kubernetes-example-backend/README.md      | 13 +++++++
 2 files changed, 48 insertions(+)
 create mode 100644 contrib/docker/kubernetes-example-backend/Dockerfile
 create mode 100644 contrib/docker/kubernetes-example-backend/README.md

diff --git a/contrib/docker/kubernetes-example-backend/Dockerfile b/contrib/docker/kubernetes-example-backend/Dockerfile
new file mode 100644
index 0000000000..df617decf5
--- /dev/null
+++ b/contrib/docker/kubernetes-example-backend/Dockerfile
@@ -0,0 +1,35 @@
+FROM node:12-buster
+
+WORKDIR /usr/src/app
+
+# (workaround) Install cookiecutter and mkdocs to avoid the need to run docker in docker
+RUN cd /tmp && curl -O https://www.python.org/ftp/python/3.8.2/Python-3.8.2.tar.xz && \
+    tar -xvf Python-3.8.2.tar.xz && \
+    cd Python-3.8.2 && \
+    ./configure --enable-optimizations && \
+    make -j 4 && \
+    make altinstall
+
+RUN apt update
+RUN apt install -y mkdocs
+
+RUN pip3.8 install mkdocs-techdocs-core
+
+RUN pip3.8 install cookiecutter && \
+    apt remove -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev libreadline-dev libffi-dev libbz2-dev g++ python-pip python-dev && \
+    rm -rf /var/cache/apt/* /tmp/Python-3.8.2
+
+# Copy repo skeleton first, to avoid unnecessary docker cache invalidation.
+# The skeleton contains the package.json of each package in the monorepo,
+# and along with yarn.lock and the root package.json, that's enough to run yarn install.
+ADD yarn.lock package.json skeleton.tar ./
+
+RUN yarn install --frozen-lockfile --production
+
+# This will copy the contents of the dist-workspace when running the build-image command.
+# Do not use this Dockerfile outside of that command, as it will copy in the source code instead.
+COPY . .
+
+CMD ["node", "packages/backend"]
+
+
diff --git a/contrib/docker/kubernetes-example-backend/README.md b/contrib/docker/kubernetes-example-backend/README.md
new file mode 100644
index 0000000000..d0f9d57022
--- /dev/null
+++ b/contrib/docker/kubernetes-example-backend/README.md
@@ -0,0 +1,13 @@
+# Example backend Dockerfile
+
+This Dockerfile will build the example backend with certain additional binaries needed to workaround
+the docker requirement in the scaffolder and techdocs.
+
+# Usage
+
+```bash
+yarn docker-build -f <absolute_path_to_the_dockerfile> --tag <your_tag>
+```
+
+> The absolute path is necessary as this directory is not copied to the build workspace when building
+> the docker image.

From 49d70ccab1da55c7a0fb9adcbbdcfc405c480081 Mon Sep 17 00:00:00 2001
From: Oliver Sand <oliver.sand@sda-se.com>
Date: Thu, 8 Oct 2020 15:04:53 +0200
Subject: [PATCH 097/110] feat: remove LocationProcessor.processEntity

Instead, pass the `UrlReader` into the constructor of your `LocationProcessor`.
---
 .changeset/remove-location-processor-read.md  |  6 +++
 .../src/ingestion/LocationReaders.ts          | 43 +------------------
 .../src/ingestion/processors/types.ts         |  3 --
 3 files changed, 7 insertions(+), 45 deletions(-)
 create mode 100644 .changeset/remove-location-processor-read.md

diff --git a/.changeset/remove-location-processor-read.md b/.changeset/remove-location-processor-read.md
new file mode 100644
index 0000000000..78aea6d820
--- /dev/null
+++ b/.changeset/remove-location-processor-read.md
@@ -0,0 +1,6 @@
+---
+'@backstage/plugin-catalog-backend': minor
+---
+
+Remove the `read` argument of `LocationProcessor.processEntity`.
+Instead, pass the `UrlReader` into the constructor of your `LocationProcessor`.
diff --git a/plugins/catalog-backend/src/ingestion/LocationReaders.ts b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
index 8cbaaa3e8e..87c75e21e5 100644
--- a/plugins/catalog-backend/src/ingestion/LocationReaders.ts
+++ b/plugins/catalog-backend/src/ingestion/LocationReaders.ts
@@ -251,12 +251,7 @@ export class LocationReaders implements LocationReader {
     for (const processor of this.processors) {
       if (processor.processEntity) {
         try {
-          current = await processor.processEntity(
-            current,
-            item.location,
-            emit,
-            this.readLocation.bind(this),
-          );
+          current = await processor.processEntity(current, item.location, emit);
         } catch (e) {
           // Construct the name carefully, if we got validation errors we do
           // not want to crash here due to missing metadata or so
@@ -294,40 +289,4 @@ export class LocationReaders implements LocationReader {
       }
     }
   }
-
-  private async readLocation(location: LocationSpec): Promise<Buffer> {
-    let data: Buffer | undefined = undefined;
-    let error: Error | undefined = undefined;
-
-    await this.handleLocation(
-      {
-        type: 'location',
-        location,
-        optional: false,
-      },
-      output => {
-        if (output.type === 'error' && !error) {
-          error = output.error;
-        } else if (output.type === 'data') {
-          if (data) {
-            if (!error) {
-              error = new Error(
-                'More than one piece of data loaded unexpectedly',
-              );
-            }
-          } else {
-            data = output.data;
-          }
-        }
-      },
-    );
-
-    if (error) {
-      throw error;
-    } else if (!data) {
-      throw new Error('No data loaded');
-    }
-
-    return data;
-  }
 }
diff --git a/plugins/catalog-backend/src/ingestion/processors/types.ts b/plugins/catalog-backend/src/ingestion/processors/types.ts
index 66359b328b..cd2c423423 100644
--- a/plugins/catalog-backend/src/ingestion/processors/types.ts
+++ b/plugins/catalog-backend/src/ingestion/processors/types.ts
@@ -58,7 +58,6 @@ export type LocationProcessor = {
     entity: Entity,
     location: LocationSpec,
     emit: LocationProcessorEmit,
-    read: LocationProcessorRead,
   ): Promise<Entity>;
 
   /**
@@ -109,5 +108,3 @@ export type LocationProcessorResult =
   | LocationProcessorDataResult
   | LocationProcessorEntityResult
   | LocationProcessorErrorResult;
-
-export type LocationProcessorRead = (location: LocationSpec) => Promise<Buffer>;

From ae499a55ff7a1c7d2edf7f6b8ac3feeb37ee0e6d Mon Sep 17 00:00:00 2001
From: Sebastian Qvarfordt <s.qvarfordt@gmail.com>
Date: Thu, 8 Oct 2020 16:59:30 +0200
Subject: [PATCH 098/110] Use new url scheme for techdocs

---
 plugins/techdocs-backend/src/service/router.ts       |  4 ++--
 .../src/techdocs/stages/publish/local.test.ts        |  2 +-
 .../src/techdocs/stages/publish/local.ts             |  2 +-
 plugins/techdocs/src/EntityPageDocs.tsx              |  2 +-
 plugins/techdocs/src/api.test.ts                     |  4 ++--
 plugins/techdocs/src/api.ts                          | 12 +++---------
 plugins/techdocs/src/plugin.ts                       |  2 +-
 .../techdocs/src/reader/components/TechDocsHome.tsx  |  6 +++---
 .../techdocs/src/reader/components/TechDocsPage.tsx  |  3 +--
 9 files changed, 15 insertions(+), 22 deletions(-)

diff --git a/plugins/techdocs-backend/src/service/router.ts b/plugins/techdocs-backend/src/service/router.ts
index 365534b9d0..f2317f749e 100644
--- a/plugins/techdocs-backend/src/service/router.ts
+++ b/plugins/techdocs-backend/src/service/router.ts
@@ -78,7 +78,7 @@ export async function createRouter({
     }
   });
 
-  router.get('/metadata/entity/:kind/:namespace/:name', async (req, res) => {
+  router.get('/metadata/entity/:namespace/:kind/:name', async (req, res) => {
     const baseUrl = config.getString('backend.baseUrl');
     const { kind, namespace, name } = req.params;
 
@@ -101,7 +101,7 @@ export async function createRouter({
     }
   });
 
-  router.get('/docs/:kind/:namespace/:name/*', async (req, res) => {
+  router.get('/docs/:namespace/:kind/:name/*', async (req, res) => {
     const storageUrl = config.getString('techdocs.storageUrl');
 
     const { kind, namespace, name } = req.params;
diff --git a/plugins/techdocs-backend/src/techdocs/stages/publish/local.test.ts b/plugins/techdocs-backend/src/techdocs/stages/publish/local.test.ts
index 55e0a547e9..64edc5c294 100644
--- a/plugins/techdocs-backend/src/techdocs/stages/publish/local.test.ts
+++ b/plugins/techdocs-backend/src/techdocs/stages/publish/local.test.ts
@@ -53,7 +53,7 @@ describe('local publisher', () => {
 
     const resultDir = path.resolve(
       __dirname,
-      `../../../../static/docs/${mockEntity.kind}/default/${mockEntity.metadata.name}`,
+      `../../../../static/docs/default/${mockEntity.kind}/${mockEntity.metadata.name}`,
     );
 
     expect(fs.existsSync(resultDir)).toBeTruthy();
diff --git a/plugins/techdocs-backend/src/techdocs/stages/publish/local.ts b/plugins/techdocs-backend/src/techdocs/stages/publish/local.ts
index f328443965..6d655d4632 100644
--- a/plugins/techdocs-backend/src/techdocs/stages/publish/local.ts
+++ b/plugins/techdocs-backend/src/techdocs/stages/publish/local.ts
@@ -42,8 +42,8 @@ export class LocalPublish implements PublisherBase {
     const publishDir = resolvePackagePath(
       '@backstage/plugin-techdocs-backend',
       'static/docs',
-      entity.kind,
       entityNamespace,
+      entity.kind,
       entity.metadata.name,
     );
 
diff --git a/plugins/techdocs/src/EntityPageDocs.tsx b/plugins/techdocs/src/EntityPageDocs.tsx
index d10c7a5932..544c2cdadd 100644
--- a/plugins/techdocs/src/EntityPageDocs.tsx
+++ b/plugins/techdocs/src/EntityPageDocs.tsx
@@ -23,7 +23,7 @@ export const EntityPageDocs = ({ entity }: { entity: Entity }) => {
     <Reader
       entityId={{
         kind: entity.kind,
-        namespace: entity.metadata.namespace,
+        namespace: entity.metadata.namespace ?? 'default',
         name: entity.metadata.name,
       }}
     />
diff --git a/plugins/techdocs/src/api.test.ts b/plugins/techdocs/src/api.test.ts
index f7c52f8a7d..132976e280 100644
--- a/plugins/techdocs/src/api.test.ts
+++ b/plugins/techdocs/src/api.test.ts
@@ -28,7 +28,7 @@ describe('TechDocsStorageApi', () => {
     const storageApi = new TechDocsStorageApi({ apiOrigin: DOC_STORAGE_URL });
 
     expect(storageApi.getBaseUrl('test.js', mockEntity, '')).toEqual(
-      `${DOC_STORAGE_URL}/docs/${mockEntity.kind}/${mockEntity.namespace}/${mockEntity.name}/test.js`,
+      `${DOC_STORAGE_URL}/docs/${mockEntity.namespace}/${mockEntity.kind}/${mockEntity.name}/test.js`,
     );
   });
 
@@ -36,7 +36,7 @@ describe('TechDocsStorageApi', () => {
     const storageApi = new TechDocsStorageApi({ apiOrigin: DOC_STORAGE_URL });
 
     expect(storageApi.getBaseUrl('test/', mockEntity, '')).toEqual(
-      `${DOC_STORAGE_URL}/docs/${mockEntity.kind}/${mockEntity.namespace}/${mockEntity.name}/test/`,
+      `${DOC_STORAGE_URL}/docs/${mockEntity.namespace}/${mockEntity.kind}/${mockEntity.name}/test/`,
     );
   });
 });
diff --git a/plugins/techdocs/src/api.ts b/plugins/techdocs/src/api.ts
index 87a0a56a01..31e4a10e4c 100644
--- a/plugins/techdocs/src/api.ts
+++ b/plugins/techdocs/src/api.ts
@@ -51,9 +51,7 @@ export class TechDocsApi implements TechDocs {
   async getMetadata(metadataType: string, entityId: ParsedEntityId) {
     const { kind, namespace, name } = entityId;
 
-    const requestUrl = `${this.apiOrigin}/metadata/${metadataType}/${kind}/${
-      namespace ? namespace : 'default'
-    }/${name}`;
+    const requestUrl = `${this.apiOrigin}/metadata/${metadataType}/${namespace}/${kind}/${name}`;
 
     const request = await fetch(`${requestUrl}`);
     const res = await request.json();
@@ -72,9 +70,7 @@ export class TechDocsStorageApi implements TechDocsStorage {
   async getEntityDocs(entityId: ParsedEntityId, path: string) {
     const { kind, namespace, name } = entityId;
 
-    const url = `${this.apiOrigin}/docs/${kind}/${
-      namespace ? namespace : 'default'
-    }/${name}/${path}`;
+    const url = `${this.apiOrigin}/docs/${namespace}/${kind}/${name}/${path}`;
 
     const request = await fetch(
       `${url.endsWith('/') ? url : `${url}/`}index.html`,
@@ -96,9 +92,7 @@ export class TechDocsStorageApi implements TechDocsStorage {
 
     return new URL(
       oldBaseUrl,
-      `${this.apiOrigin}/docs/${kind}/${
-        namespace ? namespace : 'default'
-      }/${name}/${path}`,
+      `${this.apiOrigin}/docs/${namespace}/${kind}/${name}/${path}`,
     ).toString();
   }
 }
diff --git a/plugins/techdocs/src/plugin.ts b/plugins/techdocs/src/plugin.ts
index b197bdfb76..ee2cab60fa 100644
--- a/plugins/techdocs/src/plugin.ts
+++ b/plugins/techdocs/src/plugin.ts
@@ -48,7 +48,7 @@ export const rootRouteRef = createRouteRef({
 });
 
 export const rootDocsRouteRef = createRouteRef({
-  path: ':entityId/*',
+  path: ':namespace/:kind/:name/*',
   title: 'Docs',
 });
 
diff --git a/plugins/techdocs/src/reader/components/TechDocsHome.tsx b/plugins/techdocs/src/reader/components/TechDocsHome.tsx
index c478a52127..cbef46f6c1 100644
--- a/plugins/techdocs/src/reader/components/TechDocsHome.tsx
+++ b/plugins/techdocs/src/reader/components/TechDocsHome.tsx
@@ -84,9 +84,9 @@ export const TechDocsHome = () => {
                     onClick={() =>
                       navigate(
                         generatePath(rootDocsRouteRef.path, {
-                          entityId: `${entity.kind}:${
-                            entity.metadata.namespace ?? ''
-                          }:${entity.metadata.name}`,
+                          namespace: entity.metadata.namespace ?? 'default',
+                          kind: entity.kind,
+                          name: entity.metadata.name,
                         }),
                       )
                     }
diff --git a/plugins/techdocs/src/reader/components/TechDocsPage.tsx b/plugins/techdocs/src/reader/components/TechDocsPage.tsx
index a70ce76191..3c4005762e 100644
--- a/plugins/techdocs/src/reader/components/TechDocsPage.tsx
+++ b/plugins/techdocs/src/reader/components/TechDocsPage.tsx
@@ -24,8 +24,7 @@ import { techdocsApiRef } from '../../api';
 
 export const TechDocsPage = () => {
   const [documentReady, setDocumentReady] = useState<boolean>(false);
-  const { entityId } = useParams();
-  const [kind, namespace, name] = entityId.split(':');
+  const { namespace, kind, name } = useParams();
 
   const techDocsApi = useApi(techdocsApiRef);
 

From 8c9afb91d3d4bbb97880df1abd74579e667e5482 Mon Sep 17 00:00:00 2001
From: Dominik Henneke <dominik.henneke@sda-se.com>
Date: Thu, 8 Oct 2020 16:49:27 +0200
Subject: [PATCH 099/110] fix: make catalog filter work again

---
 packages/core/src/components/Table/Table.tsx | 27 +++++++++++++-------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/packages/core/src/components/Table/Table.tsx b/packages/core/src/components/Table/Table.tsx
index a92ce7f15e..5d0b7d8344 100644
--- a/packages/core/src/components/Table/Table.tsx
+++ b/packages/core/src/components/Table/Table.tsx
@@ -44,7 +44,7 @@ import MTable, {
   MTableToolbar,
   Options,
 } from 'material-table';
-import React, { forwardRef, useState } from 'react';
+import React, { forwardRef, useCallback, useEffect, useState } from 'react';
 import { Filters, SelectedFilters } from './Filters';
 
 const tableIcons = {
@@ -206,6 +206,7 @@ export function Table<T extends object = {}>({
   const [filtersOpen, toggleFilters] = useState(false);
   const [selectedFiltersLength, setSelectedFiltersLength] = useState(0);
   const [tableData, setTableData] = useState(data as any[]);
+  const [selectedFilters, setSelectedFilters] = useState<SelectedFilters>();
 
   const MTColumns = convertColumns(columns, theme);
 
@@ -215,13 +216,21 @@ export function Table<T extends object = {}>({
     },
   };
 
-  const getFieldByTitle = (titleValue: string | keyof T) =>
-    columns.find(el => el.title === titleValue)?.field;
+  const getFieldByTitle = useCallback(
+    (titleValue: string | keyof T) =>
+      columns.find(el => el.title === titleValue)?.field,
+    [columns],
+  );
+
+  useEffect(() => {
+    if (!selectedFilters) {
+      setTableData(data as any[]);
+      return;
+    }
 
-  const onChangeFilters = (selectedFilters: SelectedFilters) => {
     const selectedFiltersArray = Object.values(selectedFilters);
     if (selectedFiltersArray.flat().length) {
-      const newData = (props.data as any[]).filter(
+      const newData = (data as any[]).filter(
         el =>
           !!Object.entries(selectedFilters)
             .filter(([, value]) => !!value.length)
@@ -234,10 +243,10 @@ export function Table<T extends object = {}>({
       );
       setTableData(newData);
     } else {
-      setTableData(props.data as any[]);
+      setTableData(data as any[]);
     }
     setSelectedFiltersLength(selectedFiltersArray.flat().length);
-  };
+  }, [data, selectedFilters, getFieldByTitle]);
 
   const constructFilters = (filterConfig: TableFilter[], dataValue: any[]) => {
     const extractColumnData = (column: string | keyof T) =>
@@ -269,8 +278,8 @@ export function Table<T extends object = {}>({
     <div className={tableClasses.root}>
       {filtersOpen && filters?.length && (
         <Filters
-          filters={constructFilters(filters, props.data as any[])}
-          onChangeFilters={onChangeFilters}
+          filters={constructFilters(filters, data as any[])}
+          onChangeFilters={setSelectedFilters}
         />
       )}
       <MTable<T>

From 84200425293025ec2ee0600855580c7ac943c1fd Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Thu, 8 Oct 2020 19:17:43 +0200
Subject: [PATCH 100/110] create-app: revert to github location type for
 example templates

---
 .../templates/default-app/app-config.yaml.hbs          | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/create-app/templates/default-app/app-config.yaml.hbs b/packages/create-app/templates/default-app/app-config.yaml.hbs
index f9df561668..7175ea0e4f 100644
--- a/packages/create-app/templates/default-app/app-config.yaml.hbs
+++ b/packages/create-app/templates/default-app/app-config.yaml.hbs
@@ -83,23 +83,23 @@ catalog:
       target: https://github.com/spotify/backstage/blob/master/packages/catalog-model/examples/all-apis.yaml
 
     # Backstage example templates
-    - type: url
+    - type: github
       target: https://github.com/spotify/backstage/blob/master/plugins/scaffolder-backend/sample-templates/react-ssr-template/template.yaml
       rules:
         - allow: [Template]
-    - type: url
+    - type: github
       target: https://github.com/spotify/backstage/blob/master/plugins/scaffolder-backend/sample-templates/springboot-grpc-template/template.yaml
       rules:
         - allow: [Template]
-    - type: url
+    - type: github
       target: https://github.com/spotify/backstage/blob/master/plugins/scaffolder-backend/sample-templates/create-react-app/template.yaml
       rules:
         - allow: [Template]
-    - type: url
+    - type: github
       target: https://github.com/spotify/cookiecutter-golang/blob/master/template.yaml
       rules:
         - allow: [Template]
-    - type: url
+    - type: github
       target: https://github.com/spotify/backstage/blob/master/plugins/scaffolder-backend/sample-templates/docs-template/template.yaml
       rules:
         - allow: [Template]

From 67d76b4197f48698c163e91c48e86971e4609a77 Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Thu, 8 Oct 2020 19:21:28 +0200
Subject: [PATCH 101/110] changesets: add entry for create-app template
 location fix

---
 .changeset/ninety-pens-poke.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/ninety-pens-poke.md

diff --git a/.changeset/ninety-pens-poke.md b/.changeset/ninety-pens-poke.md
new file mode 100644
index 0000000000..94bcb06749
--- /dev/null
+++ b/.changeset/ninety-pens-poke.md
@@ -0,0 +1,5 @@
+---
+'@backstage/create-app': patch
+---
+
+Fix for configured templates using 'url' locations even though it's not supported yet

From 4295a248e901520002fea93f81e90bc5574c8043 Mon Sep 17 00:00:00 2001
From: Mahmood Hosseini <mahmoodhosseini93@gmail.com>
Date: Thu, 8 Oct 2020 17:26:41 -0400
Subject: [PATCH 102/110] feat(techdocs-header): Show breadcrumbs on docs page
 (#2786)

---
 .../core/src/layout/Header/Header.test.tsx    |  7 +++
 packages/core/src/layout/Header/Header.tsx    | 56 ++++++++++++++++---
 .../components/TechDocsPageHeader.test.tsx    |  2 +-
 .../reader/components/TechDocsPageHeader.tsx  |  6 +-
 4 files changed, 62 insertions(+), 9 deletions(-)

diff --git a/packages/core/src/layout/Header/Header.test.tsx b/packages/core/src/layout/Header/Header.test.tsx
index 5d28c6633f..320592c218 100644
--- a/packages/core/src/layout/Header/Header.test.tsx
+++ b/packages/core/src/layout/Header/Header.test.tsx
@@ -58,4 +58,11 @@ describe('<Header/>', () => {
     );
     rendered.getByText('tool');
   });
+
+  it('should have breadcrumb rendered', () => {
+    const rendered = render(
+      wrapInTestApp(<Header title="Title" type="tool" typeLink="/tool" />),
+    );
+    rendered.getAllByText('Title');
+  });
 });
diff --git a/packages/core/src/layout/Header/Header.tsx b/packages/core/src/layout/Header/Header.tsx
index 6b9ea05245..3bd95d0ef3 100644
--- a/packages/core/src/layout/Header/Header.tsx
+++ b/packages/core/src/layout/Header/Header.tsx
@@ -16,9 +16,15 @@
 
 import React, { ReactNode, CSSProperties, FC, useContext } from 'react';
 import { Helmet } from 'react-helmet';
-import { Typography, Tooltip, makeStyles } from '@material-ui/core';
+import {
+  Link,
+  Typography,
+  Tooltip,
+  makeStyles,
+  Breadcrumbs,
+} from '@material-ui/core';
+import ChevronRightIcon from '@material-ui/icons/ChevronRight';
 import { BackstageTheme } from '@backstage/theme';
-
 import { PageThemeContext } from '../Page/Page';
 
 const useStyles = makeStyles<BackstageTheme, { backgroundImage: string }>(
@@ -69,6 +75,21 @@ const useStyles = makeStyles<BackstageTheme, { backgroundImage: string }>(
       marginBottom: theme.spacing(1),
       color: theme.palette.bursts.fontColor,
     },
+    breadcrumb: {
+      fontSize: 'calc(15px + 1 * ((100vw - 320px) / 680))',
+      color: theme.palette.bursts.fontColor,
+    },
+    breadcrumbType: {
+      fontSize: 'inherit',
+      opacity: 0.7,
+      marginRight: -theme.spacing(0.3),
+      marginBottom: theme.spacing(0.3),
+    },
+    breadcrumbTitle: {
+      fontSize: 'inherit',
+      marginLeft: -theme.spacing(0.3),
+      marginBottom: theme.spacing(0.3),
+    },
   }),
 );
 
@@ -87,7 +108,8 @@ type Props = {
 
 type TypeFragmentProps = {
   classes: HeaderStyles;
-  type?: Props['title'];
+  pageTitle: string | ReactNode;
+  type?: Props['type'];
   typeLink?: Props['typeLink'];
 };
 
@@ -102,17 +124,32 @@ type SubtitleFragmentProps = {
   subtitle?: Props['subtitle'];
 };
 
-const TypeFragment: FC<TypeFragmentProps> = ({ type, typeLink, classes }) => {
+const TypeFragment: FC<TypeFragmentProps> = ({
+  type,
+  typeLink,
+  classes,
+  pageTitle,
+}) => {
   if (!type) {
     return null;
   }
 
   if (!typeLink) {
-    // TODO: Add breadcrumbs.
     return <Typography className={classes.type}>{type}</Typography>;
   }
 
-  return <Typography className={classes.type}>{type}</Typography>;
+  return (
+    <Breadcrumbs
+      aria-label="breadcrumb"
+      separator={<ChevronRightIcon fontSize="small" />}
+      className={classes.breadcrumb}
+    >
+      <Link href={typeLink} color="inherit">
+        <Typography className={classes.breadcrumbType}> {type}</Typography>
+      </Link>
+      <Typography className={classes.breadcrumbTitle}>{pageTitle}</Typography>
+    </Breadcrumbs>
+  );
 };
 
 const TitleFragment: FC<TitleFragmentProps> = ({
@@ -175,7 +212,12 @@ export const Header: FC<Props> = ({
       <Helmet titleTemplate={titleTemplate} defaultTitle={defaultTitle} />
       <header style={style} className={classes.header}>
         <div className={classes.leftItemsBox}>
-          <TypeFragment classes={classes} type={type} typeLink={typeLink} />
+          <TypeFragment
+            classes={classes}
+            type={type}
+            typeLink={typeLink}
+            pageTitle={pageTitle}
+          />
           <TitleFragment
             classes={classes}
             pageTitle={pageTitle}
diff --git a/plugins/techdocs/src/reader/components/TechDocsPageHeader.test.tsx b/plugins/techdocs/src/reader/components/TechDocsPageHeader.test.tsx
index 70388e81c2..0d8fe9cabb 100644
--- a/plugins/techdocs/src/reader/components/TechDocsPageHeader.test.tsx
+++ b/plugins/techdocs/src/reader/components/TechDocsPageHeader.test.tsx
@@ -54,7 +54,7 @@ describe('<TechDocsPageHeader />', () => {
         ),
       );
       expect(rendered.container.innerHTML).toContain('header');
-      expect(rendered.getByText('test-site-name')).toBeDefined();
+      expect(rendered.getAllByText('test-site-name')).toHaveLength(2);
       expect(rendered.getByText('test-site-desc')).toBeDefined();
     });
   });
diff --git a/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx b/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx
index 8084378ca1..c59cce2b11 100644
--- a/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx
+++ b/plugins/techdocs/src/reader/components/TechDocsPageHeader.tsx
@@ -48,12 +48,14 @@ export const TechDocsPageHeader = ({
     spec: { owner, lifecycle },
   } = entityMetadataValues || { spec: {} };
 
+  const componentLink = `/catalog/${kind}/${name}`;
+
   const labels = (
     <>
       <HeaderLabel
         label="Component"
         value={
-          <Link style={{ color: '#fff' }} to={`/catalog/${kind}/${name}`}>
+          <Link style={{ color: '#fff' }} to={componentLink}>
             {name}
           </Link>
         }
@@ -85,6 +87,8 @@ export const TechDocsPageHeader = ({
       subtitle={
         siteDescription && siteDescription !== 'None' ? siteDescription : ''
       }
+      type={name}
+      typeLink={componentLink}
     >
       {labels}
     </Header>

From b46863b88b933b79ec74af2550a0b4d6e473a9a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mattias=20Frinnstr=C3=B6m?= <matte84@gmail.com>
Date: Fri, 9 Oct 2020 09:37:20 +0200
Subject: [PATCH 103/110] Techdocs: add Azure DevOps prepare support (#2748)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Update to latest git-url-parse

* Add Azure DevOps preparer to techdocs

* Upgraded git-url-parse in backend-common

* Switch to AZURE_TOKEN

Co-authored-by: Mattias Frinnström <mattias.frinnstrom@husqvarnagroup.com>
---
 packages/backend-common/package.json          |  2 +-
 packages/backend/src/plugins/techdocs.ts      |  3 +
 plugins/catalog-backend/package.json          |  2 +-
 plugins/scaffolder-backend/package.json       |  2 +-
 plugins/techdocs-backend/package.json         |  2 +-
 .../techdocs-backend/src/default-branch.ts    | 69 +++++++++++++++++++
 plugins/techdocs-backend/src/helpers.ts       |  7 +-
 .../src/techdocs/stages/prepare/azure.test.ts | 63 +++++++++++++++++
 .../src/techdocs/stages/prepare/azure.ts      | 55 +++++++++++++++
 .../src/techdocs/stages/prepare/dir.ts        |  3 +-
 .../src/techdocs/stages/prepare/index.ts      |  1 +
 .../src/techdocs/stages/prepare/types.ts      |  2 +-
 yarn.lock                                     |  8 +--
 13 files changed, 208 insertions(+), 11 deletions(-)
 create mode 100644 plugins/techdocs-backend/src/techdocs/stages/prepare/azure.test.ts
 create mode 100644 plugins/techdocs-backend/src/techdocs/stages/prepare/azure.ts

diff --git a/packages/backend-common/package.json b/packages/backend-common/package.json
index 1c888ab8fe..b012b5205b 100644
--- a/packages/backend-common/package.json
+++ b/packages/backend-common/package.json
@@ -39,7 +39,7 @@
     "express": "^4.17.1",
     "express-prom-bundle": "^6.1.0",
     "express-promise-router": "^3.0.3",
-    "git-url-parse": "^11.2.0",
+    "git-url-parse": "^11.3.0",
     "helmet": "^4.0.0",
     "knex": "^0.21.1",
     "lodash": "^4.17.15",
diff --git a/packages/backend/src/plugins/techdocs.ts b/packages/backend/src/plugins/techdocs.ts
index e04d2a2732..6e36c26f39 100644
--- a/packages/backend/src/plugins/techdocs.ts
+++ b/packages/backend/src/plugins/techdocs.ts
@@ -23,6 +23,7 @@ import {
   TechdocsGenerator,
   GithubPreparer,
   GitlabPreparer,
+  AzurePreparer,
 } from '@backstage/plugin-techdocs-backend';
 import { PluginEnvironment } from '../types';
 import Docker from 'dockerode';
@@ -39,10 +40,12 @@ export default async function createPlugin({
   const preparers = new Preparers();
   const githubPreparer = new GithubPreparer(logger);
   const gitlabPreparer = new GitlabPreparer(logger);
+  const azurePreparer = new AzurePreparer(logger);
   const directoryPreparer = new DirectoryPreparer(logger);
   preparers.register('dir', directoryPreparer);
   preparers.register('github', githubPreparer);
   preparers.register('gitlab', gitlabPreparer);
+  preparers.register('azure/api', azurePreparer);
 
   const publisher = new LocalPublish(logger);
 
diff --git a/plugins/catalog-backend/package.json b/plugins/catalog-backend/package.json
index f16f629c44..f2392571ce 100644
--- a/plugins/catalog-backend/package.json
+++ b/plugins/catalog-backend/package.json
@@ -31,7 +31,7 @@
     "express": "^4.17.1",
     "express-promise-router": "^3.0.3",
     "fs-extra": "^9.0.0",
-    "git-url-parse": "^11.2.0",
+    "git-url-parse": "^11.3.0",
     "knex": "^0.21.1",
     "ldapjs": "^2.2.0",
     "lodash": "^4.17.15",
diff --git a/plugins/scaffolder-backend/package.json b/plugins/scaffolder-backend/package.json
index ff584e7374..b146609d8d 100644
--- a/plugins/scaffolder-backend/package.json
+++ b/plugins/scaffolder-backend/package.json
@@ -36,7 +36,7 @@
     "express": "^4.17.1",
     "express-promise-router": "^3.0.3",
     "fs-extra": "^9.0.0",
-    "git-url-parse": "^11.2.0",
+    "git-url-parse": "^11.3.0",
     "globby": "^11.0.0",
     "helmet": "^4.0.0",
     "jsonschema": "^1.2.6",
diff --git a/plugins/techdocs-backend/package.json b/plugins/techdocs-backend/package.json
index 75f6071464..a9b6621a20 100644
--- a/plugins/techdocs-backend/package.json
+++ b/plugins/techdocs-backend/package.json
@@ -31,7 +31,7 @@
     "express": "^4.17.1",
     "express-promise-router": "^3.0.3",
     "fs-extra": "^9.0.1",
-    "git-url-parse": "^11.2.0",
+    "git-url-parse": "^11.3.0",
     "knex": "^0.21.1",
     "node-fetch": "^2.6.0",
     "nodegit": "^0.27.0",
diff --git a/plugins/techdocs-backend/src/default-branch.ts b/plugins/techdocs-backend/src/default-branch.ts
index a903b780d8..487f343d93 100644
--- a/plugins/techdocs-backend/src/default-branch.ts
+++ b/plugins/techdocs-backend/src/default-branch.ts
@@ -61,6 +61,16 @@ function getGitlabApiUrl(url: string): URL {
   );
 }
 
+function getAzureApiUrl(url: string): URL {
+  const { protocol, resource, organization, owner, name } = parseGitUrl(url);
+  const apiRepoPath = '_apis/git/repositories';
+  const apiVersion = 'api-version=6.0';
+
+  return new URL(
+    `${protocol}://${resource}/${organization}/${owner}/${apiRepoPath}/${name}?${apiVersion}`,
+  );
+}
+
 function getGithubRequestOptions(config: Config): RequestInit {
   const headers: HeadersInit = {
     Accept: 'application/vnd.github.v3.raw',
@@ -99,6 +109,26 @@ function getGitlabRequestOptions(config: Config): RequestInit {
   };
 }
 
+function getAzureRequestOptions(config: Config): RequestInit {
+  const headers: HeadersInit = {};
+
+  const token =
+    config.getOptionalString('catalog.processors.azureApi.privateToken') ??
+    process.env.AZURE_TOKEN;
+
+  if (token !== '') {
+    headers.Authorization = `Basic ${Buffer.from(`:${token}`, 'utf8').toString(
+      'base64',
+    )}`;
+  }
+
+  const requestOptions: RequestInit = {
+    headers,
+  };
+
+  return requestOptions;
+}
+
 async function getGithubDefaultBranch(
   repositoryUrl: string,
   config: Config,
@@ -159,6 +189,42 @@ async function getGitlabDefaultBranch(
   }
 }
 
+async function getAzureDefaultBranch(
+  repositoryUrl: string,
+  config: Config,
+): Promise<string> {
+  const path = getAzureApiUrl(repositoryUrl).toString();
+
+  const options = getAzureRequestOptions(config);
+
+  try {
+    const urlResponse = await fetch(path, options);
+    if (!urlResponse.ok) {
+      throw new Error(
+        `Failed to load url: ${urlResponse.status} ${urlResponse.statusText}. Make sure you have permission to repository: ${repositoryUrl}`,
+      );
+    }
+    const urlResult = await urlResponse.json();
+
+    const idResponse = await fetch(urlResult.url, options);
+    if (!idResponse.ok) {
+      throw new Error(
+        `Failed to load url: ${idResponse.status} ${idResponse.statusText}. Make sure you have permission to repository: ${urlResult.repository.url}`,
+      );
+    }
+    const idResult = await idResponse.json();
+    const name = idResult.defaultBranch;
+
+    if (!name) {
+      throw new Error('Not found Azure DevOps default branch');
+    }
+
+    return name;
+  } catch (error) {
+    throw new Error(`Failed to get Azure DevOps default branch: ${error}`);
+  }
+}
+
 export const getDefaultBranch = async (
   repositoryUrl: string,
 ): Promise<string> => {
@@ -166,6 +232,7 @@ export const getDefaultBranch = async (
   const typeMapping = [
     { url: /github*/g, type: 'github' },
     { url: /gitlab*/g, type: 'gitlab' },
+    { url: /azure*/g, type: 'azure/api' },
   ];
 
   const type = typeMapping.filter(item => item.url.test(repositoryUrl))[0]
@@ -177,6 +244,8 @@ export const getDefaultBranch = async (
         return await getGithubDefaultBranch(repositoryUrl, config);
       case 'gitlab':
         return await getGitlabDefaultBranch(repositoryUrl, config);
+      case 'azure/api':
+        return await getAzureDefaultBranch(repositoryUrl, config);
 
       default:
         throw new Error('Failed to get repository type');
diff --git a/plugins/techdocs-backend/src/helpers.ts b/plugins/techdocs-backend/src/helpers.ts
index e79df12365..b2dcd1e8e8 100644
--- a/plugins/techdocs-backend/src/helpers.ts
+++ b/plugins/techdocs-backend/src/helpers.ts
@@ -76,6 +76,7 @@ export const getLocationForEntity = (
   switch (type) {
     case 'github':
     case 'gitlab':
+    case 'azure/api':
       return { type, target };
     case 'dir':
       if (path.isAbsolute(target)) return { type, target };
@@ -124,9 +125,13 @@ export const checkoutGitRepository = async (
   const user =
     process.env.GITHUB_PRIVATE_TOKEN_USER ||
     process.env.GITLAB_PRIVATE_TOKEN_USER ||
+    process.env.AZURE_PRIVATE_TOKEN_USER ||
     '';
   const token =
-    process.env.GITHUB_TOKEN || process.env.GITLAB_PRIVATE_TOKEN_USER || '';
+    process.env.GITHUB_TOKEN ||
+    process.env.GITLAB_PRIVATE_TOKEN_USER ||
+    process.env.AZURE_TOKEN ||
+    '';
 
   if (fs.existsSync(repositoryTmpPath)) {
     try {
diff --git a/plugins/techdocs-backend/src/techdocs/stages/prepare/azure.test.ts b/plugins/techdocs-backend/src/techdocs/stages/prepare/azure.test.ts
new file mode 100644
index 0000000000..39a3d5c7fa
--- /dev/null
+++ b/plugins/techdocs-backend/src/techdocs/stages/prepare/azure.test.ts
@@ -0,0 +1,63 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 { getVoidLogger } from '@backstage/backend-common';
+import { AzurePreparer } from './azure';
+import { checkoutGitRepository } from '../../../helpers';
+
+function normalizePath(path: string) {
+  return path
+    .replace(/^[a-z]:/i, '')
+    .split('\\')
+    .join('/');
+}
+
+jest.mock('../../../helpers', () => ({
+  ...jest.requireActual<{}>('../../../helpers'),
+  checkoutGitRepository: jest.fn(() => '/tmp/backstage-repo/org/name/branch'),
+}));
+
+const createMockEntity = (annotations = {}) => {
+  return {
+    apiVersion: 'version',
+    kind: 'TestKind',
+    metadata: {
+      name: 'test-component-name',
+      annotations: {
+        ...annotations,
+      },
+    },
+  };
+};
+
+const logger = getVoidLogger();
+
+describe('Azure DevOps preparer', () => {
+  it('should prepare temp docs path from Azure DevOps repo', async () => {
+    const preparer = new AzurePreparer(logger);
+
+    const mockEntity = createMockEntity({
+      'backstage.io/techdocs-ref':
+        'azure/api:https://dev.azure.com/backstage-org/backstage-project/_git/template-repo?path=%2Ftemplate.yaml',
+    });
+
+    const tempDocsPath = await preparer.prepare(mockEntity);
+    expect(checkoutGitRepository).toHaveBeenCalledTimes(1);
+    expect(normalizePath(tempDocsPath)).toEqual(
+      '/tmp/backstage-repo/org/name/branch/template.yaml',
+    );
+  });
+});
diff --git a/plugins/techdocs-backend/src/techdocs/stages/prepare/azure.ts b/plugins/techdocs-backend/src/techdocs/stages/prepare/azure.ts
new file mode 100644
index 0000000000..18e6c3c755
--- /dev/null
+++ b/plugins/techdocs-backend/src/techdocs/stages/prepare/azure.ts
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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 path from 'path';
+import { Entity } from '@backstage/catalog-model';
+import { InputError } from '@backstage/backend-common';
+import { PreparerBase } from './types';
+import parseGitUrl from 'git-url-parse';
+import {
+  parseReferenceAnnotation,
+  checkoutGitRepository,
+} from '../../../helpers';
+
+import { Logger } from 'winston';
+
+export class AzurePreparer implements PreparerBase {
+  private readonly logger: Logger;
+
+  constructor(logger: Logger) {
+    this.logger = logger;
+  }
+
+  async prepare(entity: Entity): Promise<string> {
+    const { type, target } = parseReferenceAnnotation(
+      'backstage.io/techdocs-ref',
+      entity,
+    );
+
+    if (type !== 'azure/api') {
+      throw new InputError(`Wrong target type: ${type}, should be 'azure/api'`);
+    }
+
+    try {
+      const repoPath = await checkoutGitRepository(target, this.logger);
+      const parsedGitLocation = parseGitUrl(target);
+
+      return path.join(repoPath, parsedGitLocation.filepath);
+    } catch (error) {
+      this.logger.debug(`Repo checkout failed with error ${error.message}`);
+      throw error;
+    }
+  }
+}
diff --git a/plugins/techdocs-backend/src/techdocs/stages/prepare/dir.ts b/plugins/techdocs-backend/src/techdocs/stages/prepare/dir.ts
index cad8a7effa..d76aee25bd 100644
--- a/plugins/techdocs-backend/src/techdocs/stages/prepare/dir.ts
+++ b/plugins/techdocs-backend/src/techdocs/stages/prepare/dir.ts
@@ -42,7 +42,8 @@ export class DirectoryPreparer implements PreparerBase {
     );
     switch (type) {
       case 'github':
-      case 'gitlab': {
+      case 'gitlab':
+      case 'azure/api': {
         const parsedGitLocation = parseGitUrl(target);
         const repoLocation = await checkoutGitRepository(target, this.logger);
 
diff --git a/plugins/techdocs-backend/src/techdocs/stages/prepare/index.ts b/plugins/techdocs-backend/src/techdocs/stages/prepare/index.ts
index 9e91958bd7..249854f7ee 100644
--- a/plugins/techdocs-backend/src/techdocs/stages/prepare/index.ts
+++ b/plugins/techdocs-backend/src/techdocs/stages/prepare/index.ts
@@ -16,5 +16,6 @@
 export { DirectoryPreparer } from './dir';
 export { GithubPreparer } from './github';
 export { GitlabPreparer } from './gitlab';
+export { AzurePreparer } from './azure';
 export { Preparers } from './preparers';
 export type { PreparerBuilder, PreparerBase } from './types';
diff --git a/plugins/techdocs-backend/src/techdocs/stages/prepare/types.ts b/plugins/techdocs-backend/src/techdocs/stages/prepare/types.ts
index 4cb1e1e006..1dd091e107 100644
--- a/plugins/techdocs-backend/src/techdocs/stages/prepare/types.ts
+++ b/plugins/techdocs-backend/src/techdocs/stages/prepare/types.ts
@@ -30,4 +30,4 @@ export type PreparerBuilder = {
   get(entity: Entity): PreparerBase;
 };
 
-export type RemoteProtocol = 'dir' | 'github' | 'gitlab' | 'file';
+export type RemoteProtocol = 'dir' | 'github' | 'gitlab' | 'file' | 'azure/api';
diff --git a/yarn.lock b/yarn.lock
index f84330cc78..28f6f57cca 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -11985,10 +11985,10 @@ git-url-parse@^11.1.2:
   dependencies:
     git-up "^4.0.0"
 
-git-url-parse@^11.2.0:
-  version "11.2.0"
-  resolved "https://registry.npmjs.org/git-url-parse/-/git-url-parse-11.2.0.tgz#2955fd51befd6d96ea1389bbe2ef57e8e6042b04"
-  integrity sha512-KPoHZg8v+plarZvto4ruIzzJLFQoRx+sUs5DQSr07By9IBKguVd+e6jwrFR6/TP6xrCJlNV1tPqLO1aREc7O2g==
+git-url-parse@^11.3.0:
+  version "11.3.0"
+  resolved "https://registry.npmjs.org/git-url-parse/-/git-url-parse-11.3.0.tgz#1515b4574c4eb2efda7d25cc50b29ce8beaefaae"
+  integrity sha512-i3XNa8IKmqnUqWBcdWBjOcnyZYfN3C1WRvnKI6ouFWwsXCZEnlgbwbm55ZpJ3OJMhfEP/ryFhqW8bBhej3C5Ug==
   dependencies:
     git-up "^4.0.0"
 

From a1540e72866b3b9b83aff57e32ef2a72ab8b71a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20Adel=C3=B6w?= <freben@gmail.com>
Date: Wed, 7 Oct 2020 14:21:00 +0200
Subject: [PATCH 104/110] feat(catalog-backend): introduce batching, speed up
 reading and writing of large datasets

---
 .../20201007201501_index_entity_search.js     |  37 +++
 .../catalog/CoalescedEntitiesCatalog.test.ts  |   2 +
 .../src/catalog/CoalescedEntitiesCatalog.ts   |   4 +
 .../catalog/DatabaseEntitiesCatalog.test.ts   |   1 +
 .../src/catalog/DatabaseEntitiesCatalog.ts    |   9 +
 .../src/catalog/StaticEntitiesCatalog.ts      |   4 +
 plugins/catalog-backend/src/catalog/types.ts  |   1 +
 .../src/database/CommonDatabase.test.ts       |  73 ++++++
 .../src/database/CommonDatabase.ts            | 114 ++++++++--
 plugins/catalog-backend/src/database/types.ts |   8 +
 .../ingestion/HigherOrderOperations.test.ts   |  32 +--
 .../src/ingestion/HigherOrderOperations.ts    | 210 ++++++++++++++----
 .../src/service/router.test.ts                |   1 +
 plugins/catalog-backend/src/util/timing.ts    |  31 +++
 14 files changed, 448 insertions(+), 79 deletions(-)
 create mode 100644 plugins/catalog-backend/migrations/20201007201501_index_entity_search.js
 create mode 100644 plugins/catalog-backend/src/util/timing.ts

diff --git a/plugins/catalog-backend/migrations/20201007201501_index_entity_search.js b/plugins/catalog-backend/migrations/20201007201501_index_entity_search.js
new file mode 100644
index 0000000000..b902073e64
--- /dev/null
+++ b/plugins/catalog-backend/migrations/20201007201501_index_entity_search.js
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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.
+ */
+
+// @ts-check
+
+/**
+ * @param {import('knex')} knex
+ */
+exports.up = async function up(knex) {
+  await knex.schema.alterTable('entities_search', table => {
+    table.index(['key'], 'entities_search_key');
+    table.index(['value'], 'entities_search_value');
+  });
+};
+
+/**
+ * @param {import('knex')} knex
+ */
+exports.down = async function down(knex) {
+  await knex.schema.alterTable('entities_search', table => {
+    table.dropIndex('', 'entities_search_key');
+    table.dropIndex('', 'entities_search_value');
+  });
+};
diff --git a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts b/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts
index 1cfea23e43..f127c2e0bd 100644
--- a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts
+++ b/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts
@@ -37,6 +37,7 @@ describe('CoalescedEntitiesCatalog', () => {
     entityByUid: jest.fn(),
     entityByName: jest.fn(),
     addOrUpdateEntity: jest.fn(),
+    addEntities: jest.fn(),
     removeEntityByUid: jest.fn(),
   };
 
@@ -45,6 +46,7 @@ describe('CoalescedEntitiesCatalog', () => {
     entityByUid: jest.fn(),
     entityByName: jest.fn(),
     addOrUpdateEntity: jest.fn(),
+    addEntities: jest.fn(),
     removeEntityByUid: jest.fn(),
   };
 
diff --git a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts b/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts
index 7eaf1868cb..705a210f60 100644
--- a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts
+++ b/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts
@@ -90,6 +90,10 @@ export class CoalescedEntitiesCatalog implements EntitiesCatalog {
     throw new Error('Method not implemented.');
   }
 
+  addEntities(): Promise<void> {
+    throw new Error('Method not implemented.');
+  }
+
   removeEntityByUid(): Promise<void> {
     throw new Error('Method not implemented.');
   }
diff --git a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts
index b94365a9ba..a9444af0f9 100644
--- a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts
+++ b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts
@@ -25,6 +25,7 @@ describe('DatabaseEntitiesCatalog', () => {
     db = {
       transaction: jest.fn(),
       addEntity: jest.fn(),
+      addEntities: jest.fn(),
       updateEntity: jest.fn(),
       entities: jest.fn(),
       entityByName: jest.fn(),
diff --git a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts
index 750d728c67..82ef680b09 100644
--- a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts
+++ b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts
@@ -79,6 +79,15 @@ export class DatabaseEntitiesCatalog implements EntitiesCatalog {
     });
   }
 
+  async addEntities(entities: Entity[], locationId?: string): Promise<void> {
+    await this.database.transaction(async tx => {
+      await this.database.addEntities(
+        tx,
+        entities.map(entity => ({ locationId, entity })),
+      );
+    });
+  }
+
   async removeEntityByUid(uid: string): Promise<void> {
     return await this.database.transaction(async tx => {
       const entityResponse = await this.database.entityByUid(tx, uid);
diff --git a/plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts b/plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts
index 65fbfb9071..b9d50cfc62 100644
--- a/plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts
+++ b/plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts
@@ -50,6 +50,10 @@ export class StaticEntitiesCatalog implements EntitiesCatalog {
     throw new Error('Not supported');
   }
 
+  async addEntities(): Promise<void> {
+    throw new Error('Not supported');
+  }
+
   async removeEntityByUid(): Promise<void> {
     throw new Error('Not supported');
   }
diff --git a/plugins/catalog-backend/src/catalog/types.ts b/plugins/catalog-backend/src/catalog/types.ts
index 37618a2440..5d84cbcebc 100644
--- a/plugins/catalog-backend/src/catalog/types.ts
+++ b/plugins/catalog-backend/src/catalog/types.ts
@@ -26,6 +26,7 @@ export type EntitiesCatalog = {
   entityByUid(uid: string): Promise<Entity | undefined>;
   entityByName(name: EntityName): Promise<Entity | undefined>;
   addOrUpdateEntity(entity: Entity, locationId?: string): Promise<Entity>;
+  addEntities(entities: Entity[], locationId?: string): Promise<void>;
   removeEntityByUid(uid: string): Promise<void>;
 };
 
diff --git a/plugins/catalog-backend/src/database/CommonDatabase.test.ts b/plugins/catalog-backend/src/database/CommonDatabase.test.ts
index 2bacec4026..2883d81b3d 100644
--- a/plugins/catalog-backend/src/database/CommonDatabase.test.ts
+++ b/plugins/catalog-backend/src/database/CommonDatabase.test.ts
@@ -168,6 +168,79 @@ describe('CommonDatabase', () => {
     });
   });
 
+  describe('addEntities', () => {
+    it('happy path: adds entities to empty database', async () => {
+      await db.transaction(tx => db.addEntities(tx, [entityRequest]));
+      expect(true).toBeTruthy();
+    });
+
+    it('rejects adding the same-named entity twice', async () => {
+      const req: DbEntityRequest[] = [
+        {
+          entity: {
+            apiVersion: 'av1',
+            kind: 'k1',
+            metadata: { name: 'n1', namespace: 'ns1' },
+          },
+        },
+        {
+          entity: {
+            apiVersion: 'av1',
+            kind: 'k1',
+            metadata: { name: 'n1', namespace: 'ns1' },
+          },
+        },
+      ];
+      await expect(
+        db.transaction(tx => db.addEntities(tx, req)),
+      ).rejects.toThrow(ConflictError);
+    });
+
+    it('rejects adding the almost-same-namespace entity twice', async () => {
+      const req: DbEntityRequest[] = [
+        {
+          entity: {
+            apiVersion: 'av1',
+            kind: 'k1',
+            metadata: { name: 'n1', namespace: 'ns1' },
+          },
+        },
+        {
+          entity: {
+            apiVersion: 'av1',
+            kind: 'k1',
+            metadata: { name: 'n1', namespace: 'nS1' },
+          },
+        },
+      ];
+      await expect(
+        db.transaction(tx => db.addEntities(tx, req)),
+      ).rejects.toThrow(ConflictError);
+    });
+
+    it('accepts adding the same-named entity twice if on different namespaces', async () => {
+      const req: DbEntityRequest[] = [
+        {
+          entity: {
+            apiVersion: 'av1',
+            kind: 'k1',
+            metadata: { name: 'n1', namespace: 'ns1' },
+          },
+        },
+        {
+          entity: {
+            apiVersion: 'av1',
+            kind: 'k1',
+            metadata: { name: 'n1', namespace: 'ns2' },
+          },
+        },
+      ];
+      await expect(
+        db.transaction(tx => db.addEntities(tx, req)),
+      ).resolves.toBeUndefined();
+    });
+  });
+
   describe('locationHistory', () => {
     it('outputs the history correctly', async () => {
       const location: Location = {
diff --git a/plugins/catalog-backend/src/database/CommonDatabase.ts b/plugins/catalog-backend/src/database/CommonDatabase.ts
index 890a64781a..c583217711 100644
--- a/plugins/catalog-backend/src/database/CommonDatabase.ts
+++ b/plugins/catalog-backend/src/database/CommonDatabase.ts
@@ -45,6 +45,12 @@ import type {
   EntityFilters,
 } from './types';
 
+// The number of items that are sent per batch to the database layer, when
+// doing .batchInsert calls to knex. This needs to be low enough to not cause
+// errors in the underlying engine due to exceeding query limits, but large
+// enough to get the speed benefits.
+const BATCH_SIZE = 50;
+
 /**
  * The core database implementation.
  */
@@ -100,6 +106,48 @@ export class CommonDatabase implements Database {
     return { locationId: request.locationId, entity: newEntity };
   }
 
+  async addEntities(
+    txOpaque: unknown,
+    request: DbEntityRequest[],
+  ): Promise<void> {
+    const tx = txOpaque as Knex.Transaction<any, any>;
+
+    const entityRows: DbEntitiesRow[] = [];
+    const searchRows: DbEntitiesSearchRow[] = [];
+
+    for (const { entity, locationId } of request) {
+      if (entity.metadata.uid !== undefined) {
+        throw new InputError('May not specify uid for new entities');
+      } else if (entity.metadata.etag !== undefined) {
+        throw new InputError('May not specify etag for new entities');
+      } else if (entity.metadata.generation !== undefined) {
+        throw new InputError('May not specify generation for new entities');
+      }
+
+      const newEntity = {
+        ...entity,
+        metadata: {
+          ...entity.metadata,
+          uid: generateEntityUid(),
+          etag: generateEntityEtag(),
+          generation: 1,
+        },
+      };
+
+      entityRows.push(this.toEntityRow(locationId, newEntity));
+      searchRows.push(...buildEntitySearch(newEntity.metadata.uid, newEntity));
+    }
+
+    await tx.batchInsert('entities', entityRows, BATCH_SIZE);
+    await tx<DbEntitiesSearchRow>('entities_search')
+      .whereIn(
+        'entity_id',
+        entityRows.map(r => r.id),
+      )
+      .del();
+    await tx.batchInsert('entities_search', searchRows, BATCH_SIZE);
+  }
+
   async updateEntity(
     txOpaque: unknown,
     request: DbEntityRequest,
@@ -165,10 +213,10 @@ export class CommonDatabase implements Database {
   ): Promise<DbEntityResponse[]> {
     const tx = txOpaque as Knex.Transaction<any, any>;
 
-    let builder = tx<DbEntitiesRow>('entities');
-    for (const [indexU, filter] of (filters ?? []).entries()) {
-      const index = Number(indexU);
-      const key = filter.key.toLowerCase().replace(/\*/g, '%');
+    let entitiesQuery = tx<DbEntitiesRow>('entities');
+
+    for (const filter of filters || []) {
+      const key = filter.key.toLowerCase().replace(/[*]/g, '%');
       const keyOp = filter.key.includes('*') ? 'like' : '=';
 
       let matchNulls = false;
@@ -179,36 +227,54 @@ export class CommonDatabase implements Database {
         if (!value) {
           matchNulls = true;
         } else if (value.includes('*')) {
-          matchLike.push(value.toLowerCase().replace(/\*/g, '%'));
+          matchLike.push(value.toLowerCase().replace(/[*]/g, '%'));
         } else {
           matchIn.push(value.toLowerCase());
         }
       }
 
-      builder = builder
-        .leftOuterJoin(`entities_search as t${index}`, function joins() {
-          this.on('entities.id', '=', `t${index}.entity_id`);
-          this.andOn(`t${index}.key`, keyOp, tx.raw('?', [key]));
-        })
-        .where(function rules() {
-          if (matchIn.length) {
-            this.orWhereIn(`t${index}.value`, matchIn);
-          }
-          if (matchLike.length) {
-            for (const x of matchLike) {
-              this.orWhere(`t${index}.value`, 'like', tx.raw('?', [x]));
+      // NOTE(freben): This used to be a set of OUTER JOIN, which may seem to
+      // make a lot of sense. However, it had abysmal performance on sqlite
+      // when datasets grew large, so we're using IN instead.
+      const matchQuery = tx<DbEntitiesSearchRow>('entities_search')
+        .select('entity_id')
+        .where(function keyFilter() {
+          this.andWhere('key', keyOp, key);
+          this.andWhere(function valueFilter() {
+            if (matchIn.length === 1) {
+              this.orWhere({ value: matchIn[0] });
+            } else if (matchIn.length > 1) {
+              this.orWhereIn('value', matchIn);
             }
-          }
-          if (matchNulls) {
-            this.orWhereNull(`t${index}.value`);
-          }
+            if (matchLike.length) {
+              for (const x of matchLike) {
+                this.orWhere('value', 'like', tx.raw('?', [x]));
+              }
+            }
+            if (matchNulls) {
+              // Match explicit nulls, and then handle absence separately below
+              this.orWhereNull('value');
+            }
+          });
         });
+
+      // Handle absence as nulls as well
+      entitiesQuery = entitiesQuery.andWhere(function match() {
+        this.whereIn('id', matchQuery);
+        if (matchNulls) {
+          this.orWhereNotIn(
+            'id',
+            tx<DbEntitiesSearchRow>('entities_search')
+              .select('entity_id')
+              .where('key', keyOp, key),
+          );
+        }
+      });
     }
 
-    const rows = await builder
+    const rows = await entitiesQuery
       .select('entities.*')
-      .orderBy('full_name', 'asc')
-      .groupBy('id');
+      .orderBy('full_name', 'asc');
 
     return rows.map(row => this.toEntityResponse(row));
   }
diff --git a/plugins/catalog-backend/src/database/types.ts b/plugins/catalog-backend/src/database/types.ts
index 5a577f2223..36de5c2152 100644
--- a/plugins/catalog-backend/src/database/types.ts
+++ b/plugins/catalog-backend/src/database/types.ts
@@ -97,6 +97,14 @@ export type Database = {
    */
   addEntity(tx: unknown, request: DbEntityRequest): Promise<DbEntityResponse>;
 
+  /**
+   * Adds a set of new entities to the catalog.
+   *
+   * @param tx An ongoing transaction
+   * @param request The entities being added
+   */
+  addEntities(tx: unknown, request: DbEntityRequest[]): Promise<void>;
+
   /**
    * Updates an existing entity in the catalog.
    *
diff --git a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.test.ts b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.test.ts
index 32fcc27909..15d9168732 100644
--- a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.test.ts
+++ b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.test.ts
@@ -39,6 +39,7 @@ describe('HigherOrderOperations', () => {
       entityByUid: jest.fn(),
       entityByName: jest.fn(),
       addOrUpdateEntity: jest.fn(),
+      addEntities: jest.fn(),
       removeEntityByUid: jest.fn(),
     };
     locationsCatalog = {
@@ -191,8 +192,8 @@ describe('HigherOrderOperations', () => {
         entities: [{ entity: desc, location }],
         errors: [],
       });
-      entitiesCatalog.entityByName.mockResolvedValue(undefined);
-      entitiesCatalog.addOrUpdateEntity.mockResolvedValue(desc);
+      entitiesCatalog.entities.mockResolvedValue([]);
+      entitiesCatalog.addEntities.mockResolvedValue(undefined);
 
       await expect(
         higherOrderOperation.refreshAllLocations(),
@@ -204,18 +205,19 @@ describe('HigherOrderOperations', () => {
         type: 'some',
         target: 'thing',
       });
-      expect(entitiesCatalog.entityByName).toHaveBeenCalledTimes(1);
-      expect(entitiesCatalog.entityByName).toHaveBeenNthCalledWith(1, {
-        kind: 'Component',
-        namespace: ENTITY_DEFAULT_NAMESPACE,
-        name: 'c1',
-      });
-      expect(entitiesCatalog.addOrUpdateEntity).toHaveBeenCalledTimes(1);
-      expect(entitiesCatalog.addOrUpdateEntity).toHaveBeenNthCalledWith(
+      expect(entitiesCatalog.entities).toHaveBeenCalledTimes(1);
+      expect(entitiesCatalog.entities).toHaveBeenNthCalledWith(
         1,
-        expect.objectContaining({
-          metadata: expect.objectContaining({ name: 'c1' }),
-        }),
+        expect.arrayContaining([
+          { key: 'kind', values: ['Component'] },
+          { key: 'metadata.namespace', values: [ENTITY_DEFAULT_NAMESPACE] },
+          { key: 'metadata.name', values: ['c1'] },
+        ]),
+      );
+      expect(entitiesCatalog.addEntities).toHaveBeenCalledTimes(1);
+      expect(entitiesCatalog.addEntities).toHaveBeenNthCalledWith(
+        1,
+        [expect.objectContaining({ metadata: { name: 'c1' } })],
         '123',
       );
     });
@@ -245,8 +247,8 @@ describe('HigherOrderOperations', () => {
         entities: [{ entity: desc, location }],
         errors: [],
       });
-      entitiesCatalog.entityByName.mockResolvedValue(undefined);
-      entitiesCatalog.addOrUpdateEntity.mockResolvedValue(desc);
+      entitiesCatalog.entities.mockResolvedValue([]);
+      entitiesCatalog.addEntities.mockResolvedValue(undefined);
 
       await expect(
         higherOrderOperation.refreshAllLocations(),
diff --git a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
index 7232b876c7..a9ad03302f 100644
--- a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
+++ b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { InputError } from '@backstage/backend-common';
+import { ConflictError, InputError } from '@backstage/backend-common';
 import {
   Entity,
   entityHasChanges,
@@ -23,15 +23,33 @@ import {
   LocationSpec,
   serializeEntityRef,
 } from '@backstage/catalog-model';
+import { chunk, groupBy } from 'lodash';
 import { v4 as uuidv4 } from 'uuid';
 import { Logger } from 'winston';
 import { EntitiesCatalog, LocationsCatalog } from '../catalog';
+import { durationText } from '../util/timing';
 import {
   AddLocationResult,
   HigherOrderOperation,
   LocationReader,
 } from './types';
 
+type BatchContext = {
+  kind: string;
+  namespace: string;
+  location: Location;
+};
+
+// Some locations return tens or hundreds of thousands of entities. To make
+// those payloads more manageable, we break work apart in batches of this
+// many entities and write them to storage per batch.
+const BATCH_SIZE = 100;
+
+// When writing large batches, there's an increasing chance of contention in
+// the form of conflicts where we compete with other writes. Each batch gets
+// this many attempts at being written before giving up.
+const BATCH_ATTEMPTS = 3;
+
 /**
  * Placeholder for operations that span several catalogs and/or stretches out
  * in time.
@@ -88,7 +106,7 @@ export class HigherOrderOperations implements HigherOrderOperation {
     if (readerOutput.errors.length) {
       const item = readerOutput.errors[0];
       throw new InputError(
-        `Failed to read location ${item.location.type} ${item.location.target}, ${item.error}`,
+        `Failed to read location ${item.location.type}:${item.location.target}, ${item.error}`,
       );
     }
 
@@ -121,85 +139,197 @@ export class HigherOrderOperations implements HigherOrderOperation {
    * without changes.
    */
   async refreshAllLocations(): Promise<void> {
-    const startTimestamp = new Date().valueOf();
+    const startTimestamp = process.hrtime();
     this.logger.info('Beginning locations refresh');
 
     const locations = await this.locationsCatalog.locations();
     this.logger.info(`Visiting ${locations.length} locations`);
 
     for (const { data: location } of locations) {
-      this.logger.debug(
-        `Refreshing location id="${location.id}" type="${location.type}" target="${location.target}"`,
+      this.logger.info(
+        `Refreshing location ${location.type}:${location.target}`,
       );
       try {
         await this.refreshSingleLocation(location);
         await this.locationsCatalog.logUpdateSuccess(location.id, undefined);
       } catch (e) {
-        this.logger.debug(
-          `Failed to refresh location id="${location.id}" type="${location.type}" target="${location.target}", ${e}`,
+        this.logger.warn(
+          `Failed to refresh location ${location.type}:${location.target}, ${e}`,
         );
         await this.locationsCatalog.logUpdateFailure(location.id, e);
       }
     }
 
-    const endTimestamp = new Date().valueOf();
-    const duration = ((endTimestamp - startTimestamp) / 1000).toFixed(1);
-    this.logger.debug(`Completed locations refresh in ${duration} seconds`);
+    this.logger.info(
+      `Completed locations refresh in ${durationText(startTimestamp)}`,
+    );
   }
 
   // Performs a full refresh of a single location
   private async refreshSingleLocation(location: Location) {
+    let startTimestamp = process.hrtime();
+
     const readerOutput = await this.locationReader.read({
       type: location.type,
       target: location.target,
     });
 
     for (const item of readerOutput.errors) {
-      this.logger.debug(
-        `Failed item in location type="${item.location.type}" target="${item.location.target}", ${item.error}`,
+      this.logger.warn(
+        `Failed item in location ${item.location.type}:${item.location.target}, ${item.error}`,
       );
     }
 
     this.logger.info(
-      `Read ${readerOutput.entities.length} entities from location ${location.type} ${location.target}`,
+      `Read ${readerOutput.entities.length} entities from location ${
+        location.type
+      }:${location.target} in ${durationText(startTimestamp)}`,
     );
 
-    const startTimestamp = process.hrtime();
-    for (const item of readerOutput.entities) {
-      const { entity } = item;
+    startTimestamp = process.hrtime();
 
-      try {
-        const previous = await this.entitiesCatalog.entityByName(
-          getEntityName(entity),
+    await this.batchAddOrUpdateEntities(
+      readerOutput.entities.map(e => e.entity),
+      location,
+    );
+
+    this.logger.info(
+      `Wrote ${readerOutput.entities.length} entities from location ${
+        location.type
+      }:${location.target} in ${durationText(startTimestamp)}`,
+    );
+  }
+
+  /**
+   * Writes a number of entities efficiently to storage.
+   *
+   * @param entities Some entities
+   * @param location The location that they all belong to
+   */
+  async batchAddOrUpdateEntities(entities: Entity[], location: Location) {
+    // Group the entities by unique kind+namespace combinations
+    const entitiesByKindAndNamespace = groupBy(entities, entity => {
+      const name = getEntityName(entity);
+      return `${name.kind}:${name.namespace}`.toLowerCase();
+    });
+
+    for (const groupEntities of Object.values(entitiesByKindAndNamespace)) {
+      const { kind, namespace } = getEntityName(groupEntities[0]);
+
+      // Go through the new entities in reasonable chunk sizes (sometimes,
+      // sources produce tens of thousands of entities, and those are too large
+      // batch sizes to reasonably send to the database)
+      for (const batch of chunk(groupEntities, BATCH_SIZE)) {
+        const first = serializeEntityRef(batch[0]);
+        const last = serializeEntityRef(batch[batch.length - 1]);
+        this.logger.debug(
+          `Considering batch ${first}-${last} (${batch.length} entries)`,
         );
 
-        if (!previous) {
-          await this.entitiesCatalog.addOrUpdateEntity(entity, location.id);
-        } else if (entityHasChanges(previous, entity)) {
-          await this.entitiesCatalog.addOrUpdateEntity(entity, location.id);
+        // Retry the batch write a few times to deal with contention
+        const context = { kind, namespace, location };
+        for (let attempt = 1; attempt <= BATCH_ATTEMPTS; ++attempt) {
+          try {
+            const { toAdd, toUpdate } = await this.analyzeBatch(batch, context);
+            if (toAdd.length) await this.batchAdd(toAdd, context);
+            if (toUpdate.length) await this.batchUpdate(toUpdate, context);
+            break;
+          } catch (e) {
+            if (e instanceof ConflictError && attempt < BATCH_ATTEMPTS) {
+              this.logger.warn(
+                `Failed to write batch at attempt ${attempt}/${BATCH_ATTEMPTS}, ${e}`,
+              );
+            } else {
+              throw e;
+            }
+          }
         }
+      }
+    }
+  }
 
-        await this.locationsCatalog.logUpdateSuccess(
-          location.id,
-          entity.metadata.name,
-        );
-      } catch (error) {
-        this.logger.info(
-          `Failed refresh of entity ${serializeEntityRef(entity)}, ${error}`,
-        );
+  // Given a batch of entities that were just read from a location, take them
+  // into consideration by comparing against the existing catalog entities and
+  // produce the list of entities to be added, and the list of entities to be
+  // updated
+  private async analyzeBatch(
+    newEntities: Entity[],
+    { kind, namespace }: BatchContext,
+  ): Promise<{
+    toAdd: Entity[];
+    toUpdate: Entity[];
+  }> {
+    const markTimestamp = process.hrtime();
 
-        await this.locationsCatalog.logUpdateFailure(
-          location.id,
-          error,
-          entity.metadata.name,
-        );
+    const names = newEntities.map(e => e.metadata.name);
+    const oldEntities = await this.entitiesCatalog.entities([
+      { key: 'kind', values: [kind] },
+      { key: 'metadata.namespace', values: [namespace] },
+      { key: 'metadata.name', values: names },
+    ]);
+
+    const oldEntitiesByName = new Map(
+      oldEntities.map(e => [e.metadata.name, e]),
+    );
+
+    const toAdd: Entity[] = [];
+    const toUpdate: Entity[] = [];
+
+    for (const newEntity of newEntities) {
+      const oldEntity = oldEntitiesByName.get(newEntity.metadata.name);
+      if (!oldEntity) {
+        toAdd.push(newEntity);
+      } else if (entityHasChanges(oldEntity, newEntity)) {
+        toUpdate.push(newEntity);
       }
     }
 
-    const delta = process.hrtime(startTimestamp);
-    const durationMs = ((delta[0] * 1e9 + delta[1]) / 1e9).toFixed(1);
-    this.logger.info(
-      `Wrote ${readerOutput.entities.length} entities from location ${location.type} ${location.target} in ${durationMs} seconds`,
+    this.logger.debug(
+      `Found ${toAdd.length} entities to add, ${
+        toUpdate.length
+      } entities to update in ${durationText(markTimestamp)}`,
+    );
+
+    return { toAdd, toUpdate };
+  }
+
+  // Efficiently adds the given entities to storage, under the assumption that
+  // they do not conflict with any existing entities
+  private async batchAdd(entities: Entity[], { location }: BatchContext) {
+    const markTimestamp = process.hrtime();
+
+    await this.entitiesCatalog.addEntities(entities, location.id);
+
+    // TODO(freben): Still not batched
+    for (const entity of entities) {
+      await this.locationsCatalog.logUpdateSuccess(
+        location.id,
+        entity.metadata.name,
+      );
+    }
+
+    this.logger.debug(
+      `Added ${entities.length} entities in ${durationText(markTimestamp)}`,
+    );
+  }
+
+  // Efficiently updates the given entities into storage, under the assumption
+  // that there already exist entities with the same names
+  private async batchUpdate(entities: Entity[], { location }: BatchContext) {
+    const markTimestamp = process.hrtime();
+
+    // TODO(freben): Still not batched
+    for (const entity of entities) {
+      await this.entitiesCatalog.addOrUpdateEntity(entity);
+
+      await this.locationsCatalog.logUpdateSuccess(
+        location.id,
+        entity.metadata.name,
+      );
+    }
+
+    this.logger.debug(
+      `Updated ${entities.length} entities in ${durationText(markTimestamp)}`,
     );
   }
 }
diff --git a/plugins/catalog-backend/src/service/router.test.ts b/plugins/catalog-backend/src/service/router.test.ts
index 32d7b6aa63..ecf4b0e614 100644
--- a/plugins/catalog-backend/src/service/router.test.ts
+++ b/plugins/catalog-backend/src/service/router.test.ts
@@ -35,6 +35,7 @@ describe('createRouter', () => {
       entityByUid: jest.fn(),
       entityByName: jest.fn(),
       addOrUpdateEntity: jest.fn(),
+      addEntities: jest.fn(),
       removeEntityByUid: jest.fn(),
     };
     locationsCatalog = {
diff --git a/plugins/catalog-backend/src/util/timing.ts b/plugins/catalog-backend/src/util/timing.ts
new file mode 100644
index 0000000000..1abc446ab4
--- /dev/null
+++ b/plugins/catalog-backend/src/util/timing.ts
@@ -0,0 +1,31 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * 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.
+ */
+
+/**
+ * Returns a string with the elapsed time since the start of an operation,
+ * with some human friendly precision, e.g. "133ms" or "14.5s".
+ *
+ * @param startTimestamp The timestamp (from process.hrtime()) at the start ot
+ *                       the operation
+ */
+export function durationText(startTimestamp: [number, number]): string {
+  const delta = process.hrtime(startTimestamp);
+  const seconds = delta[0] + delta[1] / 1e9;
+  if (seconds > 1) {
+    return `${seconds.toFixed(1)}s`;
+  }
+  return `${(seconds * 1000).toFixed(0)}ms`;
+}

From f9c42befc6e9db78bd659de3b376c94589b4b75b Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Fri, 9 Oct 2020 10:47:26 +0200
Subject: [PATCH 105/110] cli: simplify jest transform ignore regex

---
 packages/cli/config/jest.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/cli/config/jest.js b/packages/cli/config/jest.js
index f69e18190d..b9f709241c 100644
--- a/packages/cli/config/jest.js
+++ b/packages/cli/config/jest.js
@@ -96,7 +96,7 @@ async function getConfig() {
     // Default behaviour is to not apply transforms for node_modules, but we still want
     // to apply the esm-transformer to .esm.js files, since that's what we use in backstage packages.
     transformIgnorePatterns: [
-      `/node_modules/${transformModulePattern}(?:(?!\\.esm).)*\\.(?:js|json)$`,
+      `/node_modules/${transformModulePattern}.*\\.(?:(?<!esm\\.)js|json)$`,
     ],
   };
 

From bd785fff17b726c5ea8a59ea08f9a948fc8a8301 Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Fri, 9 Oct 2020 11:00:02 +0200
Subject: [PATCH 106/110] create-app: remove build step

---
 packages/create-app/src/createApp.ts | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/create-app/src/createApp.ts b/packages/create-app/src/createApp.ts
index 28e3805ce8..ee8855334b 100644
--- a/packages/create-app/src/createApp.ts
+++ b/packages/create-app/src/createApp.ts
@@ -74,7 +74,6 @@ async function buildApp(appDir: string) {
 
   await runCmd('yarn install');
   await runCmd('yarn tsc');
-  await runCmd('yarn build');
 }
 
 async function moveApp(tempDir: string, destination: string, id: string) {

From 6d5e0d90de868ac3cd134b207d449fb5e51238ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20Adel=C3=B6w?= <freben@gmail.com>
Date: Fri, 9 Oct 2020 11:13:17 +0200
Subject: [PATCH 107/110] feat(catalog-backend): add batch concurrency

---
 plugins/catalog-backend/package.json          |  1 +
 .../src/ingestion/HigherOrderOperations.ts    | 60 ++++++++++++-------
 2 files changed, 39 insertions(+), 22 deletions(-)

diff --git a/plugins/catalog-backend/package.json b/plugins/catalog-backend/package.json
index f2392571ce..3d14563524 100644
--- a/plugins/catalog-backend/package.json
+++ b/plugins/catalog-backend/package.json
@@ -37,6 +37,7 @@
     "lodash": "^4.17.15",
     "morgan": "^1.10.0",
     "node-fetch": "^2.6.0",
+    "p-limit": "^3.0.2",
     "sqlite3": "^5.0.0",
     "uuid": "^8.0.0",
     "winston": "^3.2.1",
diff --git a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
index a9ad03302f..737166436c 100644
--- a/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
+++ b/plugins/catalog-backend/src/ingestion/HigherOrderOperations.ts
@@ -24,6 +24,7 @@ import {
   serializeEntityRef,
 } from '@backstage/catalog-model';
 import { chunk, groupBy } from 'lodash';
+import limiterFactory from 'p-limit';
 import { v4 as uuidv4 } from 'uuid';
 import { Logger } from 'winston';
 import { EntitiesCatalog, LocationsCatalog } from '../catalog';
@@ -50,6 +51,9 @@ const BATCH_SIZE = 100;
 // this many attempts at being written before giving up.
 const BATCH_ATTEMPTS = 3;
 
+// The number of batches that may be ongoing at the same time.
+const BATCH_CONCURRENCY = 3;
+
 /**
  * Placeholder for operations that span several catalogs and/or stretches out
  * in time.
@@ -213,6 +217,9 @@ export class HigherOrderOperations implements HigherOrderOperation {
       return `${name.kind}:${name.namespace}`.toLowerCase();
     });
 
+    const limiter = limiterFactory(BATCH_CONCURRENCY);
+    const tasks: Promise<void>[] = [];
+
     for (const groupEntities of Object.values(entitiesByKindAndNamespace)) {
       const { kind, namespace } = getEntityName(groupEntities[0]);
 
@@ -220,32 +227,41 @@ export class HigherOrderOperations implements HigherOrderOperation {
       // sources produce tens of thousands of entities, and those are too large
       // batch sizes to reasonably send to the database)
       for (const batch of chunk(groupEntities, BATCH_SIZE)) {
-        const first = serializeEntityRef(batch[0]);
-        const last = serializeEntityRef(batch[batch.length - 1]);
-        this.logger.debug(
-          `Considering batch ${first}-${last} (${batch.length} entries)`,
-        );
+        tasks.push(
+          limiter(async () => {
+            const first = serializeEntityRef(batch[0]);
+            const last = serializeEntityRef(batch[batch.length - 1]);
+            this.logger.debug(
+              `Considering batch ${first}-${last} (${batch.length} entries)`,
+            );
 
-        // Retry the batch write a few times to deal with contention
-        const context = { kind, namespace, location };
-        for (let attempt = 1; attempt <= BATCH_ATTEMPTS; ++attempt) {
-          try {
-            const { toAdd, toUpdate } = await this.analyzeBatch(batch, context);
-            if (toAdd.length) await this.batchAdd(toAdd, context);
-            if (toUpdate.length) await this.batchUpdate(toUpdate, context);
-            break;
-          } catch (e) {
-            if (e instanceof ConflictError && attempt < BATCH_ATTEMPTS) {
-              this.logger.warn(
-                `Failed to write batch at attempt ${attempt}/${BATCH_ATTEMPTS}, ${e}`,
-              );
-            } else {
-              throw e;
+            // Retry the batch write a few times to deal with contention
+            const context = { kind, namespace, location };
+            for (let attempt = 1; attempt <= BATCH_ATTEMPTS; ++attempt) {
+              try {
+                const { toAdd, toUpdate } = await this.analyzeBatch(
+                  batch,
+                  context,
+                );
+                if (toAdd.length) await this.batchAdd(toAdd, context);
+                if (toUpdate.length) await this.batchUpdate(toUpdate, context);
+                break;
+              } catch (e) {
+                if (e instanceof ConflictError && attempt < BATCH_ATTEMPTS) {
+                  this.logger.warn(
+                    `Failed to write batch at attempt ${attempt}/${BATCH_ATTEMPTS}, ${e}`,
+                  );
+                } else {
+                  throw e;
+                }
+              }
             }
-          }
-        }
+          }),
+        );
       }
     }
+
+    await Promise.all(tasks);
   }
 
   // Given a batch of entities that were just read from a location, take them

From 5ea7400ea52ba054f0c7a8769e635fb8899d036b Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Fri, 9 Oct 2020 11:31:04 +0200
Subject: [PATCH 108/110] move codecov.yml to .github

---
 .codecov.yml => .github/codecov.yml | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename .codecov.yml => .github/codecov.yml (100%)

diff --git a/.codecov.yml b/.github/codecov.yml
similarity index 100%
rename from .codecov.yml
rename to .github/codecov.yml

From 7818d6bb9f3dfe1d708321609a22738d697f6d6c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 9 Oct 2020 11:41:28 +0200
Subject: [PATCH 109/110] chore(deps-dev): bump @types/webpack from 4.41.21 to
 4.41.22 (#2765)

Bumps [@types/webpack](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/webpack) from 4.41.21 to 4.41.22.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/webpack)

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 yarn.lock | 20 +++++---------------
 1 file changed, 5 insertions(+), 15 deletions(-)

diff --git a/yarn.lock b/yarn.lock
index 28f6f57cca..6e32ed4e94 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -5201,22 +5201,12 @@
   resolved "https://registry.npmjs.org/@types/node/-/node-14.0.26.tgz#22a3b8a46510da8944b67bfc27df02c34a35331c"
   integrity sha512-W+fpe5s91FBGE0pEa0lnqGLL4USgpLgs4nokw16SrBBco/gQxuua7KnArSEOd5iaMqbbSHV10vUDkJYJJqpXKA==
 
-"@types/node@^10.1.0":
-  version "10.17.28"
-  resolved "https://registry.npmjs.org/@types/node/-/node-10.17.28.tgz#0e36d718a29355ee51cec83b42d921299200f6d9"
-  integrity sha512-dzjES1Egb4c1a89C7lKwQh8pwjYmlOAG9dW1pBgxEk57tMrLnssOfEthz8kdkNaBd7lIqQx7APm5+mZ619IiCQ==
-
-"@types/node@^10.12.0":
+"@types/node@^10.1.0", "@types/node@^10.12.0":
   version "10.17.35"
   resolved "https://registry.npmjs.org/@types/node/-/node-10.17.35.tgz#58058f29b870e6ae57b20e4f6e928f02b7129f56"
   integrity sha512-gXx7jAWpMddu0f7a+L+txMplp3FnHl53OhQIF9puXKq3hDGY/GjH+MF04oWnV/adPSCrbtHumDCFwzq2VhltWA==
 
-"@types/node@^12.0.0":
-  version "12.12.53"
-  resolved "https://registry.npmjs.org/@types/node/-/node-12.12.53.tgz#be0d375933c3d15ef2380dafb3b0350ea7021129"
-  integrity sha512-51MYTDTyCziHb70wtGNFRwB4l+5JNvdqzFSkbDvpbftEgVUBEE+T5f7pROhWMp/fxp07oNIEQZd5bbfAH22ohQ==
-
-"@types/node@^12.7.1":
+"@types/node@^12.0.0", "@types/node@^12.7.1":
   version "12.12.58"
   resolved "https://registry.npmjs.org/@types/node/-/node-12.12.58.tgz#46dae9b2b9ee5992818c8f7cee01ff4ce03ab44c"
   integrity sha512-Be46CNIHWAagEfINOjmriSxuv7IVcqbGe+sDSg2SYCEz/0CRBy7LRASGfRbD8KZkqoePU73Wsx3UvOSFcq/9hA==
@@ -5714,9 +5704,9 @@
     source-map "^0.6.1"
 
 "@types/webpack@*", "@types/webpack@^4.41.7", "@types/webpack@^4.41.8":
-  version "4.41.21"
-  resolved "https://registry.npmjs.org/@types/webpack/-/webpack-4.41.21.tgz#cc685b332c33f153bb2f5fc1fa3ac8adeb592dee"
-  integrity sha512-2j9WVnNrr/8PLAB5csW44xzQSJwS26aOnICsP3pSGCEdsu6KYtfQ6QJsVUKHWRnm1bL7HziJsfh5fHqth87yKA==
+  version "4.41.22"
+  resolved "https://registry.npmjs.org/@types/webpack/-/webpack-4.41.22.tgz#ff9758a17c6bd499e459b91e78539848c32d0731"
+  integrity sha512-JQDJK6pj8OMV9gWOnN1dcLCyU9Hzs6lux0wBO4lr1+gyEhIBR9U3FMrz12t2GPkg110XAxEAw2WHF6g7nZIbRQ==
   dependencies:
     "@types/anymatch" "*"
     "@types/node" "*"

From 84a22ed475550bd9ed64c2a35964c2945838e6f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fredrik=20Adel=C3=B6w?= <freben@gmail.com>
Date: Fri, 9 Oct 2020 12:15:20 +0200
Subject: [PATCH 110/110] chore(catalog-backend): removing redudant classes and
 some functions

---
 .../catalog/CoalescedEntitiesCatalog.test.ts  | 162 ------------------
 .../src/catalog/CoalescedEntitiesCatalog.ts   | 100 -----------
 .../catalog/DatabaseEntitiesCatalog.test.ts   |   7 +-
 .../src/catalog/DatabaseEntitiesCatalog.ts    |  10 +-
 .../src/catalog/StaticEntitiesCatalog.ts      |  60 -------
 plugins/catalog-backend/src/catalog/index.ts  |   1 -
 .../src/database/CommonDatabase.test.ts       | 111 ++++++------
 .../src/database/CommonDatabase.ts            |   8 +-
 plugins/catalog-backend/src/database/types.ts |  16 +-
 9 files changed, 78 insertions(+), 397 deletions(-)
 delete mode 100644 plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts
 delete mode 100644 plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts
 delete mode 100644 plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts

diff --git a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts b/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts
deleted file mode 100644
index f127c2e0bd..0000000000
--- a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.test.ts
+++ /dev/null
@@ -1,162 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 { Entity, ENTITY_DEFAULT_NAMESPACE } from '@backstage/catalog-model';
-import { Logger } from 'winston';
-import { CoalescedEntitiesCatalog } from './CoalescedEntitiesCatalog';
-import { EntitiesCatalog } from './types';
-
-describe('CoalescedEntitiesCatalog', () => {
-  const e1: Entity = {
-    apiVersion: 'a',
-    kind: 'k',
-    metadata: { name: 'n1' },
-  };
-
-  const e2: Entity = {
-    apiVersion: 'a',
-    kind: 'k',
-    metadata: { name: 'n2' },
-  };
-
-  const c1: jest.Mocked<EntitiesCatalog> = {
-    entities: jest.fn(),
-    entityByUid: jest.fn(),
-    entityByName: jest.fn(),
-    addOrUpdateEntity: jest.fn(),
-    addEntities: jest.fn(),
-    removeEntityByUid: jest.fn(),
-  };
-
-  const c2: jest.Mocked<EntitiesCatalog> = {
-    entities: jest.fn(),
-    entityByUid: jest.fn(),
-    entityByName: jest.fn(),
-    addOrUpdateEntity: jest.fn(),
-    addEntities: jest.fn(),
-    removeEntityByUid: jest.fn(),
-  };
-
-  const mockLogger = {
-    warn: jest.fn(),
-  };
-  const logger = (mockLogger as unknown) as Logger;
-
-  beforeEach(() => {
-    jest.resetAllMocks();
-  });
-
-  describe('entities', () => {
-    it('flattens results from multiple sources', async () => {
-      c1.entities.mockResolvedValueOnce([e1]);
-      c2.entities.mockResolvedValueOnce([e2]);
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(catalog.entities()).resolves.toEqual(
-        expect.arrayContaining([e1, e2]),
-      );
-      expect(c1.entities).toBeCalledTimes(1);
-      expect(c2.entities).toBeCalledTimes(1);
-    });
-
-    it('logs an error if any source throws', async () => {
-      c1.entities.mockResolvedValueOnce([e1]);
-      c2.entities.mockRejectedValueOnce(new Error('boo'));
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(catalog.entities()).resolves.toEqual([e1]);
-      expect(c1.entities).toBeCalledTimes(1);
-      expect(c2.entities).toBeCalledTimes(1);
-      expect(mockLogger.warn).toBeCalledWith(expect.stringMatching(/boo/));
-    });
-  });
-
-  describe('entityByUid', () => {
-    it('returns the first non-undefined result', async () => {
-      c1.entityByUid.mockResolvedValueOnce(undefined);
-      c2.entityByUid.mockResolvedValueOnce(e2);
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(catalog.entityByUid('e2')).resolves.toBe(e2);
-      expect(c1.entityByUid).toBeCalledTimes(1);
-      expect(c2.entityByUid).toBeCalledTimes(1);
-    });
-
-    it('returns undefined if all results were undefined', async () => {
-      c1.entityByUid.mockResolvedValueOnce(undefined);
-      c2.entityByUid.mockResolvedValueOnce(undefined);
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(catalog.entityByUid('e2')).resolves.toBeUndefined();
-      expect(c1.entityByUid).toBeCalledTimes(1);
-      expect(c2.entityByUid).toBeCalledTimes(1);
-    });
-
-    it('logs an error if any source throws', async () => {
-      c1.entityByUid.mockResolvedValueOnce(e1);
-      c2.entityByUid.mockRejectedValueOnce(new Error('boo'));
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(catalog.entityByUid('e2')).resolves.toBe(e1);
-      expect(c1.entityByUid).toBeCalledTimes(1);
-      expect(c2.entityByUid).toBeCalledTimes(1);
-      expect(mockLogger.warn).toBeCalledWith(expect.stringMatching(/boo/));
-    });
-  });
-
-  describe('entityByName', () => {
-    it('returns the first non-undefined result', async () => {
-      c1.entityByName.mockResolvedValueOnce(undefined);
-      c2.entityByName.mockResolvedValueOnce(e2);
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(
-        catalog.entityByName({
-          kind: 'k',
-          namespace: ENTITY_DEFAULT_NAMESPACE,
-          name: 'n2',
-        }),
-      ).resolves.toBe(e2);
-      expect(c1.entityByName).toBeCalledTimes(1);
-      expect(c2.entityByName).toBeCalledTimes(1);
-    });
-
-    it('returns undefined if all results were undefined', async () => {
-      c1.entityByName.mockResolvedValueOnce(undefined);
-      c2.entityByName.mockResolvedValueOnce(undefined);
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(
-        catalog.entityByName({
-          kind: 'k',
-          namespace: ENTITY_DEFAULT_NAMESPACE,
-          name: 'n2',
-        }),
-      ).resolves.toBeUndefined();
-      expect(c1.entityByName).toBeCalledTimes(1);
-      expect(c2.entityByName).toBeCalledTimes(1);
-    });
-
-    it('logs an error if any source throws', async () => {
-      c1.entityByName.mockResolvedValueOnce(e1);
-      c2.entityByName.mockRejectedValueOnce(new Error('boo'));
-      const catalog = new CoalescedEntitiesCatalog([c1, c2], logger);
-      await expect(
-        catalog.entityByName({
-          kind: 'k',
-          namespace: ENTITY_DEFAULT_NAMESPACE,
-          name: 'n2',
-        }),
-      ).resolves.toBe(e1);
-      expect(c1.entityByName).toBeCalledTimes(1);
-      expect(c2.entityByName).toBeCalledTimes(1);
-      expect(mockLogger.warn).toBeCalledWith(expect.stringMatching(/boo/));
-    });
-  });
-});
diff --git a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts b/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts
deleted file mode 100644
index 705a210f60..0000000000
--- a/plugins/catalog-backend/src/catalog/CoalescedEntitiesCatalog.ts
+++ /dev/null
@@ -1,100 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 { Entity, EntityName } from '@backstage/catalog-model';
-import { Logger } from 'winston';
-import { EntityFilters } from '../database';
-import { EntitiesCatalog } from './types';
-
-/**
- * A simple coalescing catalog wrapper, that acts as a front for collecting
- * catalog data from multiple sources.
- *
- * One possible usage could be to have this as a front to both a
- * DatabaseEntitiesCatalog that holds Component kinds, and another company-
- * specific catalog that is a thin wrapper on top of LDAP that supplies Group
- * and User entities. That way you'll get a coherent view of two very different
- * entity sources.
- *
- * This is mainly meant as a functional example, and you may want to provide
- * your own more specialized collector if you have this distinct need. This
- * one does not support adding/updating entities through the API for example.
- * A more competent implementation may direct the writes to different catalogs
- * based on entity kind or similar.
- */
-export class CoalescedEntitiesCatalog implements EntitiesCatalog {
-  private inner: EntitiesCatalog[];
-  private logger: Logger;
-
-  constructor(inner: EntitiesCatalog[], logger: Logger) {
-    this.inner = inner;
-    this.logger = logger;
-  }
-
-  async entities(filters?: EntityFilters): Promise<Entity[]> {
-    const ops = this.inner.map(async catalog => {
-      try {
-        return await catalog.entities(filters);
-      } catch (e) {
-        this.logger.warn(`Inner entities call failed, ${e}`);
-        return [];
-      }
-    });
-
-    const results = await Promise.all(ops);
-    return results.flat();
-  }
-
-  async entityByUid(uid: string): Promise<Entity | undefined> {
-    const ops = this.inner.map(async catalog => {
-      try {
-        return await catalog.entityByUid(uid);
-      } catch (e) {
-        this.logger.warn(`Inner entityByUid call failed, ${e}`);
-        return undefined;
-      }
-    });
-
-    const results = await Promise.all(ops);
-    return results.find(Boolean);
-  }
-
-  async entityByName(name: EntityName): Promise<Entity | undefined> {
-    const ops = this.inner.map(async catalog => {
-      try {
-        return await catalog.entityByName(name);
-      } catch (e) {
-        this.logger.warn(`Inner entityByName call failed, ${e}`);
-        return undefined;
-      }
-    });
-
-    const results = await Promise.all(ops);
-    return results.find(Boolean);
-  }
-
-  addOrUpdateEntity(): Promise<Entity> {
-    throw new Error('Method not implemented.');
-  }
-
-  addEntities(): Promise<void> {
-    throw new Error('Method not implemented.');
-  }
-
-  removeEntityByUid(): Promise<void> {
-    throw new Error('Method not implemented.');
-  }
-}
diff --git a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts
index a9444af0f9..8ef685e6b0 100644
--- a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts
+++ b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.test.ts
@@ -24,13 +24,12 @@ describe('DatabaseEntitiesCatalog', () => {
   beforeAll(() => {
     db = {
       transaction: jest.fn(),
-      addEntity: jest.fn(),
       addEntities: jest.fn(),
       updateEntity: jest.fn(),
       entities: jest.fn(),
       entityByName: jest.fn(),
       entityByUid: jest.fn(),
-      removeEntity: jest.fn(),
+      removeEntityByUid: jest.fn(),
       addLocation: jest.fn(),
       removeLocation: jest.fn(),
       location: jest.fn(),
@@ -57,7 +56,7 @@ describe('DatabaseEntitiesCatalog', () => {
       };
 
       db.entities.mockResolvedValue([]);
-      db.addEntity.mockResolvedValue({ entity });
+      db.addEntities.mockResolvedValue([{ entity }]);
 
       const catalog = new DatabaseEntitiesCatalog(db);
       const result = await catalog.addOrUpdateEntity(entity);
@@ -68,7 +67,7 @@ describe('DatabaseEntitiesCatalog', () => {
         namespace: 'd',
         name: 'c',
       });
-      expect(db.addEntity).toHaveBeenCalledTimes(1);
+      expect(db.addEntities).toHaveBeenCalledTimes(1);
       expect(result).toBe(entity);
     });
 
diff --git a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts
index 82ef680b09..2575411e7c 100644
--- a/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts
+++ b/plugins/catalog-backend/src/catalog/DatabaseEntitiesCatalog.ts
@@ -72,7 +72,10 @@ export class DatabaseEntitiesCatalog implements EntitiesCatalog {
           existing.entity.metadata.generation,
         );
       } else {
-        response = await this.database.addEntity(tx, { locationId, entity });
+        const added = await this.database.addEntities(tx, [
+          { locationId, entity },
+        ]);
+        response = added[0];
       }
 
       return response.entity;
@@ -105,7 +108,10 @@ export class DatabaseEntitiesCatalog implements EntitiesCatalog {
           ])
         : [entityResponse];
       for (const dbResponse of colocatedEntities) {
-        await this.database.removeEntity(tx, dbResponse?.entity.metadata.uid!);
+        await this.database.removeEntityByUid(
+          tx,
+          dbResponse?.entity.metadata.uid!,
+        );
       }
 
       if (entityResponse.locationId) {
diff --git a/plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts b/plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts
deleted file mode 100644
index b9d50cfc62..0000000000
--- a/plugins/catalog-backend/src/catalog/StaticEntitiesCatalog.ts
+++ /dev/null
@@ -1,60 +0,0 @@
-/*
- * Copyright 2020 Spotify AB
- *
- * 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 { Entity, EntityName, getEntityName } from '@backstage/catalog-model';
-import lodash from 'lodash';
-import type { EntitiesCatalog } from './types';
-
-export class StaticEntitiesCatalog implements EntitiesCatalog {
-  private _entities: Entity[];
-
-  constructor(entities: Entity[]) {
-    this._entities = entities;
-  }
-
-  async entities(): Promise<Entity[]> {
-    return lodash.cloneDeep(this._entities);
-  }
-
-  async entityByUid(uid: string): Promise<Entity | undefined> {
-    const item = this._entities.find(e => uid === e.metadata.uid);
-    return item ? lodash.cloneDeep(item) : undefined;
-  }
-
-  async entityByName(name: EntityName): Promise<Entity | undefined> {
-    const item = this._entities.find(e => {
-      const candidate = getEntityName(e);
-      return (
-        name.kind.toLowerCase() === candidate.kind.toLowerCase() &&
-        name.namespace.toLowerCase() === candidate.namespace.toLowerCase() &&
-        name.name.toLowerCase() === candidate.name.toLowerCase()
-      );
-    });
-    return item ? lodash.cloneDeep(item) : undefined;
-  }
-
-  async addOrUpdateEntity(): Promise<Entity> {
-    throw new Error('Not supported');
-  }
-
-  async addEntities(): Promise<void> {
-    throw new Error('Not supported');
-  }
-
-  async removeEntityByUid(): Promise<void> {
-    throw new Error('Not supported');
-  }
-}
diff --git a/plugins/catalog-backend/src/catalog/index.ts b/plugins/catalog-backend/src/catalog/index.ts
index 308078b1fc..ce429327a0 100644
--- a/plugins/catalog-backend/src/catalog/index.ts
+++ b/plugins/catalog-backend/src/catalog/index.ts
@@ -16,5 +16,4 @@
 
 export { DatabaseEntitiesCatalog } from './DatabaseEntitiesCatalog';
 export { DatabaseLocationsCatalog } from './DatabaseLocationsCatalog';
-export { StaticEntitiesCatalog } from './StaticEntitiesCatalog';
 export type { EntitiesCatalog, LocationsCatalog } from './types';
diff --git a/plugins/catalog-backend/src/database/CommonDatabase.test.ts b/plugins/catalog-backend/src/database/CommonDatabase.test.ts
index 2883d81b3d..840af74825 100644
--- a/plugins/catalog-backend/src/database/CommonDatabase.test.ts
+++ b/plugins/catalog-backend/src/database/CommonDatabase.test.ts
@@ -17,12 +17,12 @@
 import { ConflictError } from '@backstage/backend-common';
 import type { Entity, Location } from '@backstage/catalog-model';
 import { DatabaseManager } from './DatabaseManager';
-import { Database, DatabaseLocationUpdateLogStatus } from './types';
 import type {
   DbEntityRequest,
   DbEntityResponse,
   DbLocationsRowWithStatus,
 } from './types';
+import { Database, DatabaseLocationUpdateLogStatus } from './types';
 
 const bootstrapLocation = {
   id: expect.any(String),
@@ -135,43 +135,12 @@ describe('CommonDatabase', () => {
     await expect(db.location(location.id)).rejects.toThrow(/Found no location/);
   });
 
-  describe('addEntity', () => {
-    it('happy path: adds entity to empty database', async () => {
-      const added = await db.transaction(tx => db.addEntity(tx, entityRequest));
-      expect(added).toStrictEqual(entityResponse);
-      expect(added.entity.metadata.generation).toBe(1);
-    });
-
-    it('rejects adding the same-named entity twice', async () => {
-      await db.transaction(tx => db.addEntity(tx, entityRequest));
-      await expect(
-        db.transaction(tx => db.addEntity(tx, entityRequest)),
-      ).rejects.toThrow(ConflictError);
-    });
-
-    it('rejects adding the almost-same-namespace entity twice', async () => {
-      entityRequest.entity.metadata.namespace = undefined;
-      await db.transaction(tx => db.addEntity(tx, entityRequest));
-      entityRequest.entity.metadata.namespace = '';
-      await expect(
-        db.transaction(tx => db.addEntity(tx, entityRequest)),
-      ).rejects.toThrow(ConflictError);
-    });
-
-    it('accepts adding the same-named entity twice if on different namespaces', async () => {
-      entityRequest.entity.metadata.namespace = 'namespace1';
-      await db.transaction(tx => db.addEntity(tx, entityRequest));
-      entityRequest.entity.metadata.namespace = 'namespace2';
-      await expect(
-        db.transaction(tx => db.addEntity(tx, entityRequest)),
-      ).resolves.toBeDefined();
-    });
-  });
-
   describe('addEntities', () => {
     it('happy path: adds entities to empty database', async () => {
-      await db.transaction(tx => db.addEntities(tx, [entityRequest]));
-      expect(true).toBeTruthy();
+      const result = await db.transaction(tx =>
+        db.addEntities(tx, [entityRequest]),
+      );
+      expect(result).toEqual([entityResponse]);
     });
 
     it('rejects adding the same-named entity twice', async () => {
@@ -237,7 +206,28 @@ describe('CommonDatabase', () => {
       ];
       await expect(
         db.transaction(tx => db.addEntities(tx, req)),
-      ).resolves.toBeUndefined();
+      ).resolves.toEqual([
+        {
+          entity: expect.objectContaining({
+            metadata: expect.objectContaining({
+              namespace: 'ns1',
+              uid: expect.any(String),
+              etag: expect.any(String),
+              generation: expect.any(Number),
+            }),
+          }),
+        },
+        {
+          entity: expect.objectContaining({
+            metadata: expect.objectContaining({
+              namespace: 'ns2',
+              uid: expect.any(String),
+              etag: expect.any(String),
+              generation: expect.any(Number),
+            }),
+          }),
+        },
+      ]);
     });
   });
 
@@ -289,7 +279,9 @@ describe('CommonDatabase', () => {
 
   describe('updateEntity', () => {
     it('can read and no-op-update an entity', async () => {
-      const added = await db.transaction(tx => db.addEntity(tx, entityRequest));
+      const [added] = await db.transaction(tx =>
+        db.addEntities(tx, [entityRequest]),
+      );
       const updated = await db.transaction(tx =>
         db.updateEntity(tx, { entity: added.entity }),
       );
@@ -306,7 +298,9 @@ describe('CommonDatabase', () => {
     });
 
     it('can update name if uid matches', async () => {
-      const added = await db.transaction(tx => db.addEntity(tx, entityRequest));
+      const [added] = await db.transaction(tx =>
+        db.addEntities(tx, [entityRequest]),
+      );
       added.entity.metadata.name! = 'new!';
       const updated = await db.transaction(tx =>
         db.updateEntity(tx, { entity: added.entity }),
@@ -315,7 +309,9 @@ describe('CommonDatabase', () => {
     });
 
     it('fails to update an entity if etag does not match', async () => {
-      const added = await db.transaction(tx => db.addEntity(tx, entityRequest));
+      const [added] = await db.transaction(tx =>
+        db.addEntities(tx, [entityRequest]),
+      );
       await expect(
         db.transaction(tx =>
           db.updateEntity(tx, { entity: added.entity }, 'garbage'),
@@ -324,7 +320,9 @@ describe('CommonDatabase', () => {
     });
 
     it('fails to update an entity if generation does not match', async () => {
-      const added = await db.transaction(tx => db.addEntity(tx, entityRequest));
+      const [added] = await db.transaction(tx =>
+        db.addEntities(tx, [entityRequest]),
+      );
       await expect(
         db.transaction(tx =>
           db.updateEntity(tx, { entity: added.entity }, undefined, 1e20),
@@ -347,8 +345,7 @@ describe('CommonDatabase', () => {
         spec: { c: null },
       };
       await db.transaction(async tx => {
-        await db.addEntity(tx, { entity: e1 });
-        await db.addEntity(tx, { entity: e2 });
+        await db.addEntities(tx, [{ entity: e1 }, { entity: e2 }]);
       });
       const result = await db.transaction(async tx => db.entities(tx, []));
       expect(result.length).toEqual(2);
@@ -384,9 +381,10 @@ describe('CommonDatabase', () => {
       ];
 
       await db.transaction(async tx => {
-        for (const entity of entities) {
-          await db.addEntity(tx, { entity });
-        }
+        await db.addEntities(
+          tx,
+          entities.map(entity => ({ entity })),
+        );
       });
 
       await expect(
@@ -422,9 +420,10 @@ describe('CommonDatabase', () => {
       ];
 
       await db.transaction(async tx => {
-        for (const entity of entities) {
-          await db.addEntity(tx, { entity });
-        }
+        await db.addEntities(
+          tx,
+          entities.map(entity => ({ entity })),
+        );
       });
 
       const rows = await db.transaction(async tx =>
@@ -471,9 +470,10 @@ describe('CommonDatabase', () => {
       ];
 
       await db.transaction(async tx => {
-        for (const entity of entities) {
-          await db.addEntity(tx, { entity });
-        }
+        await db.addEntities(
+          tx,
+          entities.map(entity => ({ entity })),
+        );
       });
 
       const rows = await db.transaction(async tx =>
@@ -519,9 +519,10 @@ describe('CommonDatabase', () => {
       ];
 
       await db.transaction(async tx => {
-        for (const entity of entities) {
-          await db.addEntity(tx, { entity });
-        }
+        await db.addEntities(
+          tx,
+          entities.map(entity => ({ entity })),
+        );
       });
 
       const e1 = await db.transaction(async tx =>
diff --git a/plugins/catalog-backend/src/database/CommonDatabase.ts b/plugins/catalog-backend/src/database/CommonDatabase.ts
index c583217711..49b36e0933 100644
--- a/plugins/catalog-backend/src/database/CommonDatabase.ts
+++ b/plugins/catalog-backend/src/database/CommonDatabase.ts
@@ -109,9 +109,10 @@ export class CommonDatabase implements Database {
   async addEntities(
     txOpaque: unknown,
     request: DbEntityRequest[],
-  ): Promise<void> {
+  ): Promise<DbEntityResponse[]> {
     const tx = txOpaque as Knex.Transaction<any, any>;
 
+    const result: DbEntityResponse[] = [];
     const entityRows: DbEntitiesRow[] = [];
     const searchRows: DbEntitiesSearchRow[] = [];
 
@@ -134,6 +135,7 @@ export class CommonDatabase implements Database {
         },
       };
 
+      result.push({ entity: newEntity, locationId });
       entityRows.push(this.toEntityRow(locationId, newEntity));
       searchRows.push(...buildEntitySearch(newEntity.metadata.uid, newEntity));
     }
@@ -146,6 +148,8 @@ export class CommonDatabase implements Database {
       )
       .del();
     await tx.batchInsert('entities_search', searchRows, BATCH_SIZE);
+
+    return result;
   }
 
   async updateEntity(
@@ -315,7 +319,7 @@ export class CommonDatabase implements Database {
     return this.toEntityResponse(rows[0]);
   }
 
-  async removeEntity(txOpaque: unknown, uid: string): Promise<void> {
+  async removeEntityByUid(txOpaque: unknown, uid: string): Promise<void> {
     const tx = txOpaque as Knex.Transaction<any, any>;
 
     const result = await tx<DbEntitiesRow>('entities').where({ id: uid }).del();
diff --git a/plugins/catalog-backend/src/database/types.ts b/plugins/catalog-backend/src/database/types.ts
index 36de5c2152..20cc123c0a 100644
--- a/plugins/catalog-backend/src/database/types.ts
+++ b/plugins/catalog-backend/src/database/types.ts
@@ -88,22 +88,16 @@ export type Database = {
    */
   transaction<T>(fn: (tx: unknown) => Promise<T>): Promise<T>;
 
-  /**
-   * Adds a new entity to the catalog.
-   *
-   * @param tx An ongoing transaction
-   * @param request The entity being added
-   * @returns The added entity, with uid, etag and generation set
-   */
-  addEntity(tx: unknown, request: DbEntityRequest): Promise<DbEntityResponse>;
-
   /**
    * Adds a set of new entities to the catalog.
    *
    * @param tx An ongoing transaction
    * @param request The entities being added
    */
-  addEntities(tx: unknown, request: DbEntityRequest[]): Promise<void>;
+  addEntities(
+    tx: unknown,
+    request: DbEntityRequest[],
+  ): Promise<DbEntityResponse[]>;
 
   /**
    * Updates an existing entity in the catalog.
@@ -140,7 +134,7 @@ export type Database = {
 
   entityByUid(tx: unknown, uid: string): Promise<DbEntityResponse | undefined>;
 
-  removeEntity(tx: unknown, uid: string): Promise<void>;
+  removeEntityByUid(tx: unknown, uid: string): Promise<void>;
 
   addLocation(location: Location): Promise<DbLocationsRow>;