Skip to content

fix(site): standardize headers for Admin Settings page #16911

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 20 commits into from
Apr 1, 2025
Merged

fix(site): standardize headers for Admin Settings page #16911

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
de69ee3
fix: migrate deployment workspace proxies page to new header style
Parkreiner Mar 11, 2025
a1da1c1
fix: update other proxy page to use proper render key values
Parkreiner Mar 11, 2025
e5d581b
fix: make secondary styling more obvious
Parkreiner Mar 11, 2025
9b4928b
refactor: move SettingsHeader to Tailwind
Parkreiner Mar 11, 2025
a35a9ae
fix: resolve header level bugs
Parkreiner Mar 11, 2025
9872c5d
fix: constrain max width
Parkreiner Mar 11, 2025
1fe0022
fix: apply formatting
Parkreiner Mar 13, 2025
7d0903a
fix: update HTML semantics
Parkreiner Mar 13, 2025
a512bf5
fix: flush semantics fix
Parkreiner Mar 13, 2025
734f59d
fix: update leading
Parkreiner Mar 13, 2025
49b9dfe
fix: resolve styling edge case for beta badge
Parkreiner Mar 13, 2025
840d6df
fix: set correct font size
Parkreiner Mar 13, 2025
f169c4e
fix: remove redundant class
Parkreiner Mar 17, 2025
2325982
Merge branch 'main' into mes/headers-fix-b
Parkreiner Mar 28, 2025
99c2dbc
refactor: switch to CVA
Parkreiner Mar 28, 2025
50eddd0
refactor: update API design of SettingsHeader
Parkreiner Mar 28, 2025
2b77784
chore: add first-ever stories for SettingsHeader
Parkreiner Mar 28, 2025
e2523cb
fix: make header more responsive
Parkreiner Mar 28, 2025
7f53666
fix: format
Parkreiner Mar 28, 2025
daf6da9
fix: update beta badge styling for Notifications page
Parkreiner Mar 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
fix: make secondary styling more obvious
  • Loading branch information
@Parkreiner
Parkreiner committed Mar 11, 2025
commit e5d581b1832d61c21f9be0048c58c1402af6fb81
13 changes: 7 additions & 6 deletions site/src/components/SettingsHeader/SettingsHeader.tsx
View file
Open in desktop
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we add a storybook for it covering the new variants?

Original file line number Diff line number Diff line change
Expand Up @@ -4,20 +4,22 @@ import { Stack } from "components/Stack/Stack";
import { SquareArrowOutUpRightIcon } from "lucide-react";
import type { FC, ReactNode } from "react";

interface HeaderProps {
type HeaderHierarchy = "primary" | "secondary";
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Made it like this so that we can add additional variants over time

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For creating variants, I would recommend you to use class-variance-authority package. You can see how it is used in the Button component.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I've used CVA before – I actually used it in the take-home that got me into Coder. I thought it was a bit too much overhead here, but if we're switching to CVA as a go-to, I can swap that in

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because of shadcn, our base components are using CVA so I think it would be nice to use it but it is up to you.


type HeaderProps = Readonly<{
title: ReactNode;
description?: ReactNode;
secondary?: boolean;
hierarchy?: HeaderHierarchy;
docsHref?: string;
tooltip?: ReactNode;
}
}>;

export const SettingsHeader: FC<HeaderProps> = ({
title,
description,
docsHref,
secondary,
tooltip,
hierarchy = "primary",
}) => {
const theme = useTheme();

Expand All @@ -37,7 +39,7 @@ export const SettingsHeader: FC<HeaderProps> = ({
marginBottom: 4,
gap: 8,
},
secondary && {
hierarchy === "secondary" && {
fontSize: 24,
fontWeight: 500,
},
Expand All @@ -60,7 +62,6 @@ export const SettingsHeader: FC<HeaderProps> = ({
</span>
)}
</div>

{docsHref && (
<Button asChild variant="outline">
<a href={docsHref} target="_blank" rel="noreferrer">
Expand Down
2 changes: 1 addition & 1 deletion site/src/pages/DeploymentSettingsPage/NetworkSettingsPage/NetworkSettingsPageView.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ export const NetworkSettingsPageView: FC<NetworkSettingsPageViewProps> = ({
<div>
<SettingsHeader
title="Port Forwarding"
secondary
hierarchy="secondary"
description="Port forwarding lets developers securely access processes on their Coder workspace from a local machine."
docsHref={docs("/admin/networking/port-forwarding")}
/>
Expand Down
4 changes: 2 additions & 2 deletions .../pages/DeploymentSettingsPage/ObservabilitySettingsPage/ObservabilitySettingsPageView.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ export const ObservabilitySettingsPageView: FC<
<SettingsHeader title="Observability" />
<SettingsHeader
title="Audit Logging"
secondary
hierarchy="secondary"
description="Allow auditors to monitor user operations in your deployment."
docsHref={docs("/admin/security/audit-logs")}
/>
Expand Down Expand Up @@ -64,7 +64,7 @@ export const ObservabilitySettingsPageView: FC<
<div>
<SettingsHeader
title="Monitoring"
secondary
hierarchy="secondary"
description="Monitoring your Coder application with logs and metrics."
/>

Expand Down
4 changes: 2 additions & 2 deletions site/src/pages/DeploymentSettingsPage/SecuritySettingsPage/SecuritySettingsPageView.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ export const SecuritySettingsPageView: FC<SecuritySettingsPageViewProps> = ({
<div>
<SettingsHeader
title="Browser Only Connections"
secondary
hierarchy="secondary"
description="Block all workspace access via SSH, port forward, and other non-browser connections."
docsHref={docs("/admin/networking#browser-only-connections")}
/>
Expand All @@ -64,7 +64,7 @@ export const SecuritySettingsPageView: FC<SecuritySettingsPageViewProps> = ({
<div>
<SettingsHeader
title="TLS"
secondary
hierarchy="secondary"
description="Ensure TLS is properly configured for your Coder deployment."
/>

Expand Down
4 changes: 2 additions & 2 deletions site/src/pages/DeploymentSettingsPage/UserAuthSettingsPage/UserAuthSettingsPageView.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ export const UserAuthSettingsPageView = ({

<SettingsHeader
title="Login with OpenID Connect"
secondary
hierarchy="secondary"
description="Set up authentication to login with OpenID Connect."
docsHref={docs("/admin/users/oidc-auth#openid-connect")}
/>
Expand All @@ -50,7 +50,7 @@ export const UserAuthSettingsPageView = ({
<div>
<SettingsHeader
title="Login with GitHub"
secondary
hierarchy="secondary"
description="Set up authentication to login with GitHub."
docsHref={docs("/admin/users/github-auth")}
/>
Expand Down