Skip to content

Commit 89da322

Browse files
committed
fix(adr): custom styling adr name
1 parent 0286552 commit 89da322

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

docs/decision-records/2026-02-custom-styling.md‎ renamed to docs/decision-records/2026-02-custom-styling.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -12,24 +12,24 @@ We are confident Stand users will want to customise Stand components to some deg
1212

1313
## Options
1414

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
3333
- There’s no way to target a particular instance of a component with this API
3434

3535
## Decision
@@ -46,5 +46,5 @@ Unlike in source, we think the less stringent styling requirements in our toolin
4646

4747
## Consequences
4848

49-
- We should adopt 2.) and 3.)
49+
- We should adopt 2.) and 3.)
5050
- 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

Comments
 (0)