You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## What does this change?
There was somthing wrong with the metadata for "API for custom styling"
ADR, where vscode and storybook was unable to recognise it.
I've somehow managed to fix the issue, despite not knowing what the
issue was, and apply formatting.
Copy file name to clipboardExpand all lines: docs/decision-records/2026-02-custom-styling.md
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,24 +12,24 @@ We are confident Stand users will want to customise Stand components to some deg
12
12
13
13
## Options
14
14
15
-
1. No APIs. Stand consumers all use the same visual presentation.
16
-
- Stand consumers cannot easily adapt colours to match existing tooling
17
-
- Stand consumers cannot easily apply layout styling to components
18
-
- If users apply arbitrary theming, there’s no API contract that guarantees compatibility with future updates
19
-
2. Theming API. Stand consumers can apply some styling options via a typesafe API, determined by the component, as an easy way to override anticipated or commonly used styling features, e.g. colors.
20
-
- Stand consumers can adapt commonly used styling to match existing tooling
21
-
- Stand consumers cannot easily apply layout styling to components
22
-
- Users can update Stand with confidence that breaking changes will be caught by the compiler
23
-
3. CSS overrides API
24
-
- Stand consumers can adapt commonly used styling to match existing tooling — but we’d prefer them to use a typesafe API for that, where possible
25
-
- Stand consumers can apply arbitrary styling to components, targeting that specific component. An example use-case would be adding \`margin-left: auto\` to ensure that a particular element is right-aligned in a flex context
26
-
- There’s no guarantee the library can make to prevent breaking changes across any semantic version — patch changes could refactor component structure, for example
27
-
4. Classname overrides API
28
-
- Stand consumers can apply a classname to component instances, and style accordingly by adding stylesheets to the document
29
-
- There’s no guarantee the library can make to prevent breaking changes across any semantic version, as with CSS overrides
30
-
5. Static classnames for components
31
-
- Stand consumers can style components by targeting the classname owned by that component
32
-
- There’s no guarantee the library can make to prevent breaking changes across any semantic version, as with CSS overrides
15
+
1. No APIs. Stand consumers all use the same visual presentation.
16
+
- Stand consumers cannot easily adapt colours to match existing tooling
17
+
- Stand consumers cannot easily apply layout styling to components
18
+
- If users apply arbitrary theming, there’s no API contract that guarantees compatibility with future updates
19
+
2. Theming API. Stand consumers can apply some styling options via a typesafe API, determined by the component, as an easy way to override anticipated or commonly used styling features, e.g. colors.
20
+
- Stand consumers can adapt commonly used styling to match existing tooling
21
+
- Stand consumers cannot easily apply layout styling to components
22
+
- Users can update Stand with confidence that breaking changes will be caught by the compiler
23
+
3. CSS overrides API
24
+
- Stand consumers can adapt commonly used styling to match existing tooling — but we’d prefer them to use a typesafe API for that, where possible
25
+
- Stand consumers can apply arbitrary styling to components, targeting that specific component. An example use-case would be adding \`margin-left: auto\` to ensure that a particular element is right-aligned in a flex context
26
+
- There’s no guarantee the library can make to prevent breaking changes across any semantic version — patch changes could refactor component structure, for example
27
+
4. Classname overrides API
28
+
- Stand consumers can apply a classname to component instances, and style accordingly by adding stylesheets to the document
29
+
- There’s no guarantee the library can make to prevent breaking changes across any semantic version, as with CSS overrides
30
+
5. Static classnames for components
31
+
- Stand consumers can style components by targeting the classname owned by that component
32
+
- There’s no guarantee the library can make to prevent breaking changes across any semantic version, as with CSS overrides
33
33
- There’s no way to target a particular instance of a component with this API
34
34
35
35
## Decision
@@ -46,5 +46,5 @@ Unlike in source, we think the less stringent styling requirements in our toolin
46
46
47
47
## Consequences
48
48
49
-
- We should adopt 2.) and 3.)
49
+
- We should adopt 2.) and 3.)
50
50
- We should document the use-cases for each API, with a warning about usage that might expose the user to breaking changes
0 commit comments