Skip to content

Commit f453840

Browse files
Update from Copier (2026-09-06T09-24-54Z)
Signed-off-by: python-templates-copier-update[bot] <python-templates-copier-update[bot]@users.noreply.github.com>
1 parent 13a997f commit f453840

7 files changed

Lines changed: 97 additions & 40 deletions

File tree

‎.copier-answers.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Changes here will be overwritten by Copier
2-
_commit: dcfbd4b
2+
_commit: 552b2de
33
_src_path: https://github.com/python-project-templates/base.git
44
add_extension: uitk-webawesome
55
brand_name: Example

‎BRAND.md‎

Lines changed: 28 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,42 @@
11
# Example Brand Guide
22

3-
Canonical source for the Example identity. Replace each placeholder before publishing the first consumer.
3+
Canonical source for the Example identity. Every section below is a
4+
placeholder — fill it in before publishing the first consumer.
45

56
## Identity
67

7-
Describe what Example is, who it serves, and what it must not be confused with.
8+
Describe what Example is, who it serves, and what it must not be
9+
confused with.
810

911
## Mark
1012

11-
Document primary mark, clear space, minimum size, and approved variants.
13+
Document the primary mark, clear space, minimum size, and approved variants.
1214

1315
## Color
1416

15-
| Role | Light | Dark | Usage |
16-
| ------ | --------- | --------- | ------------------ |
17-
| Paper | `#f5f5f0` | `#151515` | Page surfaces |
18-
| Ink | `#151515` | `#f5f5f0` | Primary content |
19-
| Muted | `#666660` | `#aaa9a0` | Supporting content |
20-
| Line | `#d0d0c8` | `#3a3a36` | Borders and rules |
21-
| Accent | `#6cff8f` | `#6cff8f` | Focus and emphasis |
17+
The shipped tokens are neutral greys plus a functional focus color. They exist
18+
so the toolkit renders legibly out of the box, not because they are the brand.
19+
Replace the values in `tokens.css`, then record them here.
20+
21+
| Token | Light | Dark | Usage |
22+
| ----------- | ----- | ---- | ----------------- |
23+
| `bg` | | | Page background |
24+
| `bg-raised` | | | Raised surfaces |
25+
| `fg` | | | Primary text |
26+
| `fg-muted` | | | Supporting text |
27+
| `border` | | | Borders and rules |
28+
| `focus` | | | Focus rings |
29+
30+
Two rules worth keeping whatever the palette becomes:
31+
32+
- Name tokens for the role a color plays, not a material it imitates. Roles
33+
survive a redesign; metaphors have to be renamed or quietly start lying.
34+
- Give every color a job. A single decorative accent applied wherever a page
35+
looks flat is how unrelated products end up looking identical.
36+
37+
Verify each foreground against the surfaces behind it — WCAG AA is 4.5:1 for
38+
normal text, and a focus ring needs 3:1. Assert it in a test so the palette
39+
cannot drift.
2240

2341
## Typography
2442

‎index.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@
1919
</head>
2020
<body>
2121
<main>
22-
<p class="eyebrow">Brand toolkit</p>
2322
<example-brand-mark></example-brand-mark>
23+
<h1>Example</h1>
2424
<p>Shared brand identity, design tokens, and reusable Lit and Web Awesome components.</p>
2525
<example-theme-toggle data-testid="theme-toggle"></example-theme-toggle>
2626
</main>

‎package.json‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@
4444
"lit": "^3.3.3"
4545
},
4646
"devDependencies": {
47+
<<<<<<< before updating
4748
"@axe-core/playwright": "^4.12.1",
4849
"@playwright/test": "^1.60.0",
4950
"@awesome.me/webawesome": "^3.12.0",
@@ -54,6 +55,18 @@
5455
"oxlint": "^1.80.0",
5556
"publint": "^0.3.24",
5657
"typescript": "^7.0.2",
58+
=======
59+
"@axe-core/playwright": "^4.13.0",
60+
"@playwright/test": "^1.62.1",
61+
"@awesome.me/webawesome": "^3.12.0",
62+
"lit": "^3.3.3",
63+
"@types/node": "^26.4.0",
64+
"jsdom": "^30.0.1",
65+
"oxfmt": "^0.66.0",
66+
"oxlint": "^1.81.0",
67+
"publint": "^0.3.24",
68+
"typescript": "^5.9.3",
69+
>>>>>>> after updating
5770
"vite": "^8.2.2",
5871
"vitest": "^4.1.11"
5972
}

‎src/lit/components/brand-mark.ts‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ export class BrandMark extends LitElement {
1919
height: 2rem;
2020
place-items: center;
2121
border-radius: 50%;
22-
color: var(--example-color-paper);
23-
background: var(--example-color-ink);
24-
box-shadow: 3px 3px 0 var(--example-color-accent);
22+
color: var(--example-bg);
23+
background: var(--example-fg);
24+
box-shadow: 3px 3px 0 var(--example-focus);
2525
}
2626
`;
2727

‎src/lit/components/theme-toggle.ts‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@ export class ThemeToggle extends LitElement {
99

1010
static styles = css`
1111
wa-button::part(base) {
12-
border-color: var(--example-color-line);
13-
color: var(--example-color-ink);
14-
background: var(--example-color-paper);
12+
border-color: var(--example-border);
13+
color: var(--example-fg);
14+
background: var(--example-bg);
1515
}
1616
`;
1717

‎src/lit/styles/tokens.css‎

Lines changed: 48 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,71 @@
1+
/* Design tokens for Example.
2+
*
3+
* These are deliberately neutral placeholders, not a finished palette. Replace
4+
* the values with the brand's own before shipping; the names are the contract
5+
* consumers depend on, so prefer changing values over renaming.
6+
*
7+
* Names describe the role a color plays, not a material it imitates.
8+
*/
9+
110
:root {
2-
--example-color-paper: #f5f5f0;
3-
--example-color-ink: #151515;
4-
--example-color-muted: #666660;
5-
--example-color-line: #d0d0c8;
6-
--example-color-accent: #6cff8f;
11+
/* surfaces */
12+
--example-bg: #ffffff;
13+
--example-bg-raised: #f6f6f6;
14+
15+
/* text */
16+
--example-fg: #171717;
17+
--example-fg-muted: #5c5c5c;
18+
19+
/* structure */
20+
--example-border: #e0e0e0;
21+
22+
/* Focus is a functional requirement, not decoration. It needs at least 3:1
23+
* against both surfaces above; check it whenever the palette changes. */
24+
--example-focus: #1a56c4;
25+
726
--example-font-sans: ui-sans-serif, system-ui, sans-serif;
827
--example-font-mono: ui-monospace, monospace;
9-
--wa-color-surface-default: var(--example-color-paper);
10-
--wa-color-text-normal: var(--example-color-ink);
11-
--wa-color-brand-fill-loud: var(--example-color-accent);
28+
29+
/* Bridge into Web Awesome. Only surfaces, text, and borders are mapped:
30+
* Web Awesome's brand color is the consumer's to choose, so it is left at
31+
* the library default rather than pointed at a placeholder. */
32+
--wa-color-surface-default: var(--example-bg);
33+
--wa-color-surface-raised: var(--example-bg-raised);
34+
--wa-color-text-normal: var(--example-fg);
35+
--wa-color-text-quiet: var(--example-fg-muted);
36+
1237
color-scheme: light;
1338
}
1439

1540
:root[data-theme='dark'] {
16-
--example-color-paper: #151515;
17-
--example-color-ink: #f5f5f0;
18-
--example-color-muted: #aaa9a0;
19-
--example-color-line: #3a3a36;
41+
--example-bg: #121212;
42+
--example-bg-raised: #1c1c1c;
43+
--example-fg: #ededed;
44+
--example-fg-muted: #a6a6a6;
45+
--example-border: #333333;
46+
--example-focus: #8ab4ff;
47+
2048
color-scheme: dark;
2149
}
2250

2351
:root {
24-
color: var(--example-color-ink);
52+
color: var(--example-fg);
2553
font-family: var(--example-font-sans);
26-
background: var(--example-color-paper);
54+
background: var(--example-bg);
2755
}
2856

2957
body {
3058
margin: 0;
3159
}
3260

3361
main {
34-
width: min(calc(100% - 3rem), 72rem);
62+
width: min(calc(100% - 3rem), 64rem);
3563
margin: 0 auto;
36-
padding: 6rem 0;
64+
padding: 3rem 0 6rem;
3765
}
3866

39-
.eyebrow {
40-
color: var(--example-color-muted);
41-
font-family: var(--example-font-mono);
42-
font-size: 0.75rem;
43-
letter-spacing: 0.14em;
44-
text-transform: uppercase;
67+
button:focus-visible,
68+
a:focus-visible {
69+
outline: 2px solid var(--example-focus);
70+
outline-offset: 4px;
4571
}

0 commit comments

Comments
 (0)