verso-cms 0.0.0-stage → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +168 -2
- package/bin/verso.js +16 -0
- package/editor/door.js +139 -0
- package/editor/editor.js +1880 -0
- package/editor/elevate.css +2158 -0
- package/editor/ext-attrs.js +87 -0
- package/editor/ext-blocks.js +422 -0
- package/editor/ext-builder.js +819 -0
- package/editor/ext-channels.js +574 -0
- package/editor/ext-components.js +160 -0
- package/editor/ext-history.js +242 -0
- package/editor/ext-palette.js +307 -0
- package/editor/ext-people.js +345 -0
- package/editor/ext-repeaters.js +143 -0
- package/editor/ext-screens.js +94 -0
- package/editor/ext-site-settings.js +318 -0
- package/editor/ext-site-view.js +632 -0
- package/editor/ext-tokens.js +1195 -0
- package/editor/new-page.js +252 -0
- package/editor/rich.js +23 -0
- package/package.json +69 -4
- package/src/blocks.js +269 -0
- package/src/box.js +339 -0
- package/src/build.js +210 -0
- package/src/cli.js +161 -0
- package/src/color.js +137 -0
- package/src/components.js +223 -0
- package/src/elevate.js +74 -0
- package/src/errors.js +46 -0
- package/src/extensions/README.md +70 -0
- package/src/extensions/blocks.js +294 -0
- package/src/extensions/builder.js +734 -0
- package/src/extensions/channels.js +341 -0
- package/src/extensions/components.js +141 -0
- package/src/extensions/history.js +169 -0
- package/src/extensions/palette.js +31 -0
- package/src/extensions/people.js +113 -0
- package/src/extensions/site-settings.js +251 -0
- package/src/extensions/site-view.js +381 -0
- package/src/extensions/tags.js +15 -0
- package/src/extensions/tokens.js +587 -0
- package/src/fonts.js +139 -0
- package/src/git.js +419 -0
- package/src/html-edit.js +942 -0
- package/src/images.js +116 -0
- package/src/people.js +286 -0
- package/src/rich.js +124 -0
- package/src/scaffold.js +185 -0
- package/src/screens.js +65 -0
- package/src/server.js +693 -0
- package/src/site.js +618 -0
- package/src/template.js +915 -0
- package/src/video.js +29 -0
- package/starter/Dockerfile +20 -0
- package/starter/README.md +49 -0
- package/starter/blocks/call-to-action.html +6 -0
- package/starter/blocks/features.html +15 -0
- package/starter/blocks/hero.html +8 -0
- package/starter/blocks/image-and-text.html +8 -0
- package/starter/blocks/latest-posts.html +20 -0
- package/starter/blocks/post-index.html +30 -0
- package/starter/blocks/quote.html +9 -0
- package/starter/blocks/site-footer.html +8 -0
- package/starter/blocks/site-nav.html +8 -0
- package/starter/blocks/tag-list.html +10 -0
- package/starter/blocks/tagged-posts.html +19 -0
- package/starter/blocks/team.html +15 -0
- package/starter/blocks/text.html +4 -0
- package/starter/content/404/page.json +21 -0
- package/starter/content/about/page.json +65 -0
- package/starter/content/journal/designing-for-the-morning-shift/body.html +22 -0
- package/starter/content/journal/designing-for-the-morning-shift/checklist.jpg +0 -0
- package/starter/content/journal/designing-for-the-morning-shift/cover.jpg +0 -0
- package/starter/content/journal/designing-for-the-morning-shift/page.json +17 -0
- package/starter/content/journal/page.json +19 -0
- package/starter/content/journal/the-first-week/body.html +17 -0
- package/starter/content/journal/the-first-week/cover.jpg +0 -0
- package/starter/content/journal/the-first-week/page.json +17 -0
- package/starter/content/journal/the-first-week/wall-of-cards.jpg +0 -0
- package/starter/content/page.json +94 -0
- package/starter/content/site.json +88 -0
- package/starter/content/studio-table.jpg +0 -0
- package/starter/content/topics/page.json +27 -0
- package/starter/dockerignore +5 -0
- package/starter/elevate/config/design.ts +30 -0
- package/starter/elevate/config/elevate.ts +16 -0
- package/starter/elevate/config/syntax.ts +6 -0
- package/starter/elevate/design/site.ts +9 -0
- package/starter/elevate/design/tokens.json +20 -0
- package/starter/elevate/extend/fonts.css +1 -0
- package/starter/gitignore +6 -0
- package/starter/netlify.toml +5 -0
- package/starter/parts/.gitkeep +0 -0
- package/starter/public/favicon.svg +1 -0
- package/starter/templates/page.html +20 -0
- package/starter/templates/page.layout.json +23 -0
- package/starter/templates/post.html +65 -0
- package/starter/verso.defaults.json +33 -0
- package/starter-blank/blocks/site-footer.html +3 -0
- package/starter-blank/blocks/site-nav.html +8 -0
- package/starter-blank/blocks/text.html +4 -0
- package/starter-blank/content/404/page.json +18 -0
- package/starter-blank/content/page.json +18 -0
- package/starter-blank/content/site.json +36 -0
- package/starter-blank/elevate/design/tokens.json +10 -0
- package/starter-blank/templates/page.html +17 -0
- package/starter-blank/verso.defaults.json +26 -0
package/src/video.js
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
// Shared by the server and the editor's rich text bundle, so it has no
|
|
2
|
+
// dependencies.
|
|
3
|
+
|
|
4
|
+
// Embedded video: YouTube (privacy-enhanced) and Vimeo only. Any link to a
|
|
5
|
+
// video on either becomes one of these two exact addresses.
|
|
6
|
+
export const EMBED_SRC = /^https:\/\/(www\.youtube-nocookie\.com\/embed\/[A-Za-z0-9_-]{11}|player\.vimeo\.com\/video\/\d{1,12})$/;
|
|
7
|
+
|
|
8
|
+
export function videoEmbedUrl(url) {
|
|
9
|
+
let u;
|
|
10
|
+
try {
|
|
11
|
+
u = new URL(String(url || '').trim());
|
|
12
|
+
} catch {
|
|
13
|
+
return null;
|
|
14
|
+
}
|
|
15
|
+
if (!/^https?:$/.test(u.protocol)) return null;
|
|
16
|
+
const host = u.hostname.replace(/^(www\.|m\.)/, '');
|
|
17
|
+
const yt = (id) => (/^[A-Za-z0-9_-]{11}$/.test(id || '') ? `https://www.youtube-nocookie.com/embed/${id}` : null);
|
|
18
|
+
if (host === 'youtu.be') return yt(u.pathname.slice(1).split('/')[0]);
|
|
19
|
+
if (host === 'youtube.com' || host === 'youtube-nocookie.com' || host === 'music.youtube.com') {
|
|
20
|
+
if (u.pathname === '/watch') return yt(u.searchParams.get('v'));
|
|
21
|
+
const m = /^\/(embed|shorts|live|v)\/([^/?#]+)/.exec(u.pathname);
|
|
22
|
+
return m ? yt(m[2]) : null;
|
|
23
|
+
}
|
|
24
|
+
if (host === 'vimeo.com' || host === 'player.vimeo.com') {
|
|
25
|
+
const m = /^\/(?:video\/)?(\d{1,12})(?:\/|$)/.exec(u.pathname);
|
|
26
|
+
return m ? `https://player.vimeo.com/video/${m[1]}` : null;
|
|
27
|
+
}
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Runs this site as a box: the site and its editor at one address, with
|
|
2
|
+
# people signing in at /edit to change it.
|
|
3
|
+
#
|
|
4
|
+
# docker build -t my-site .
|
|
5
|
+
# docker run -p 8080:8080 -v my-site-data:/data my-site
|
|
6
|
+
#
|
|
7
|
+
# /data must be a disk that's kept between restarts. The site moves onto it
|
|
8
|
+
# the first time it starts, and every edit, the history and the list of
|
|
9
|
+
# people live there from then on.
|
|
10
|
+
|
|
11
|
+
FROM node:22-slim
|
|
12
|
+
RUN apt-get update && apt-get install -y --no-install-recommends git ca-certificates && rm -rf /var/lib/apt/lists/*
|
|
13
|
+
WORKDIR /site
|
|
14
|
+
COPY package*.json ./
|
|
15
|
+
RUN npm install --omit=dev
|
|
16
|
+
COPY . .
|
|
17
|
+
ENV PORT=8080 VERSO_DATA=/data
|
|
18
|
+
EXPOSE 8080
|
|
19
|
+
VOLUME /data
|
|
20
|
+
CMD ["npx", "verso", "serve"]
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Your Verso site
|
|
2
|
+
|
|
3
|
+
## Edit it in the browser
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
npm run dev
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
Your site opens in the browser with the editor on it. Everything is edited right on the page:
|
|
10
|
+
|
|
11
|
+
- **Words and images:** click any text to change it, or an image to replace it. Changes save as you type.
|
|
12
|
+
- **Sections:** open **Blocks** to add a hero, text, features, a team, a quote, the latest posts and more. Drag them into place, copy or remove them.
|
|
13
|
+
- **Lists:** in blocks like Features, Team and the menu, use **Add** to add another item, and the handles to move or remove one.
|
|
14
|
+
- **The header and footer** are shared: change them on any page and every page follows.
|
|
15
|
+
- **New blocks:** **Build a block** makes your own from the site's colours, sizes and fonts.
|
|
16
|
+
- **Posts:** open **Channels** and press **New post**. Give it tags in **Page settings**, and the Topics page lists them.
|
|
17
|
+
- **Pages:** **New page** adds one; **Site view** moves them around.
|
|
18
|
+
|
|
19
|
+
When you're happy, press **Publish**. **History** has every earlier version.
|
|
20
|
+
|
|
21
|
+
## Put it online
|
|
22
|
+
|
|
23
|
+
Push this folder to a GitHub repository, then connect the repository to a static host:
|
|
24
|
+
|
|
25
|
+
- **Cloudflare Pages:** build command `npm run build`, output directory `dist`.
|
|
26
|
+
- **Netlify:** nothing to set; `netlify.toml` already says it.
|
|
27
|
+
|
|
28
|
+
After that, every Publish updates the live site. Set the site's address in **Site settings** to get a sitemap and an RSS feed at `/journal/feed.xml`.
|
|
29
|
+
|
|
30
|
+
## Or run it as one box, and edit it from anywhere
|
|
31
|
+
|
|
32
|
+
Instead of a static host, the site can run as a single program that serves the pages and the editor at the same address. People sign in at `/edit` and change the live site from any browser; Publish is live in about a second.
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npm start
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Any host that runs a program and keeps a disk works. The `Dockerfile` here is ready for those that build from one: give the container a disk at `/data`. The first time it starts, the log shows a link that makes you the site's owner. After that, invite people from **People** in the bar.
|
|
39
|
+
|
|
40
|
+
## For developers
|
|
41
|
+
|
|
42
|
+
- `templates/` holds the page types: `page` (header, blocks, footer) and `post`.
|
|
43
|
+
- `blocks/` holds the sections, as plain HTML with fields like `{{ heading:text }}`.
|
|
44
|
+
- `content/` holds the words and images; each folder is a page. `content/site.json` holds the shared header and footer.
|
|
45
|
+
- `parts/` is for HTML shared by page types, written as `{{ part:name }}`. It starts empty.
|
|
46
|
+
- `elevate/design/tokens.json` holds the colours, fonts and sizes the Design panel edits. The styles are [Elevate](https://elevate-docs.pages.dev) classes.
|
|
47
|
+
- `templates/page.layout.json` is the starting layout for new pages.
|
|
48
|
+
|
|
49
|
+
The template language is explained in [Verso's documentation](https://github.com/DesignInTheBlack/verso#building-a-site-by-hand).
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
<section class="bg-color:accent text:paper">
|
|
2
|
+
<div class="contain max-w:s11 col gap:d8 pd-y:c3 /md/ row:y-end:x-between gap:d10 pd-y:c6">
|
|
3
|
+
<h2 class="font:instrument:statement:regular:tight text:paper:hug max-w:s9">{{ heading:text:required }}</h2>
|
|
4
|
+
<a href="{{ button-address:text }}" class="row:y-center gap:d3 w:fit-content pd:d6:d4 bd:round-c13 bg-color:paper text:ink font:small:semibold @hover:[bg-color:ink_text:paper] transition:medium /md/ child:no-shrink">{{ button:text }} <span aria-hidden="true">→</span></a>
|
|
5
|
+
</div>
|
|
6
|
+
</section>
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
<section class="contain max-w:s11 col gap:d10 pd-y:c2 bd-t:width-px:solid:line /md/ pd-y:c5">
|
|
2
|
+
<div class="col gap:d4 /md/ row:y-end:x-between gap:d10">
|
|
3
|
+
<h2 class="font:instrument:h2:regular:tight text:ink:none">{{ heading:text }}</h2>
|
|
4
|
+
<p class="text:ink-2:relaxed:brief">{{ intro:text }}</p>
|
|
5
|
+
</div>
|
|
6
|
+
<ul class="list-style-type:none grid:cols-1-fr:gap-d10 /md/ grid:cols-3-fr:gap-d8">
|
|
7
|
+
{{ list:features }}
|
|
8
|
+
<li class="col gap:d4 pd-t:d6 bd-t:width-px:solid:ink">
|
|
9
|
+
{{ if:image }}<img src="{{ image:image }}" class="block w:full h:auto aspect:landscape fit:cover bd:round-d2 bg-color:paper-2">{{ /if }}
|
|
10
|
+
<h3 class="font:h5:semibold text:ink:snug">{{ title:text:required }}</h3>
|
|
11
|
+
<p class="text:ink-2:relaxed">{{ text:text }}</p>
|
|
12
|
+
</li>
|
|
13
|
+
{{ /list }}
|
|
14
|
+
</ul>
|
|
15
|
+
</section>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
<section class="contain max-w:s11 col gap:d8 pd-t:c1 pd-b:c3 /md/ pd-t:c5 pd-b:c8">
|
|
2
|
+
<p class="row:y-center gap:d3 font:eyebrow:semibold:widest format:uppercase text:accent"><span class="w:d8 h:px bg-color:accent"></span><span>{{ eyebrow:text }}</span></p>
|
|
3
|
+
<h1 class="font:instrument:hero:regular:tight text:ink:none max-w:s12">{{ headline:text:required }}</h1>
|
|
4
|
+
<div class="col gap:d8 /md/ row:y-end:x-between gap:d10">
|
|
5
|
+
<p class="font:h6:normal text:ink-2:relaxed:brief /md/ font:h5">{{ intro:text }}</p>
|
|
6
|
+
{{ if:button }}<a href="{{ button-address:text }}" class="row:y-center gap:d3 w:fit-content pd:d6:d4 bd:round-c13 bg-color:ink text:paper font:small:semibold @hover:[bg-color:accent] transition:medium /md/ child:no-shrink">{{ button:text }} <span aria-hidden="true">→</span></a>{{ /if }}
|
|
7
|
+
</div>
|
|
8
|
+
</section>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
<section class="contain max-w:s11 grid:cols-1-fr:gap-d8 pd-y:c2 bd-t:width-px:solid:line /md/ grid:cols-2-fr:gap-c1 pd-y:c5">
|
|
2
|
+
<img src="{{ image:image }}" class="block w:full h:auto aspect:landscape fit:cover bd:round-d2 bg-color:paper-2">
|
|
3
|
+
<div class="col gap:d5 pd-t:d2 /md/ pd-t:d6">
|
|
4
|
+
<p class="font:eyebrow:semibold:widest format:uppercase text:accent">{{ eyebrow:text }}</p>
|
|
5
|
+
<h2 class="font:instrument:h2:regular:tight text:ink:none">{{ heading:text:required }}</h2>
|
|
6
|
+
<p class="font:h6:normal text:ink-2:relaxed">{{ text:text }}</p>
|
|
7
|
+
</div>
|
|
8
|
+
</section>
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<section class="contain max-w:s11 col gap:d10 pd-y:c2 bd-t:width-px:solid:line /md/ pd-y:c5">
|
|
2
|
+
<div class="row:y-end:x-between gap:d6">
|
|
3
|
+
<h2 class="font:instrument:h2:regular:tight text:ink:none">{{ heading:text }}</h2>
|
|
4
|
+
<a href="/journal/" class="row:y-center gap:d2 font:small:semibold text:accent @hover:[text:accent-2] transition:fast">All posts <span aria-hidden="true">→</span></a>
|
|
5
|
+
</div>
|
|
6
|
+
<ul class="list-style-type:none grid:cols-1-fr:gap-d10 /md/ grid:cols-3-fr:gap-d8">
|
|
7
|
+
{{ each:journal:newest:3 }}
|
|
8
|
+
<li>
|
|
9
|
+
<a href="{{ item.url }}" class="col gap:d4 text:ink @hover:[text:accent] transition:fast">
|
|
10
|
+
{{ if:item.cover }}<img src="{{ item.cover }}" class="block w:full h:auto aspect:landscape fit:cover bd:round-d2 bg-color:paper-2">{{ /if }}
|
|
11
|
+
<time datetime="{{ item.date-iso }}" class="font:eyebrow:semibold:widest format:uppercase text:ink-3">{{ item.date:short }}</time>
|
|
12
|
+
<span class="font:instrument:h4:regular:tight">{{ if:item.heading }}{{ item.heading }}{{ else }}{{ item.title }}{{ /if }}</span>
|
|
13
|
+
<span class="text:ink-2:relaxed">{{ item.description:words-24 }}</span>
|
|
14
|
+
</a>
|
|
15
|
+
</li>
|
|
16
|
+
{{ else }}
|
|
17
|
+
<li class="text:ink-3">No posts yet. Add one from Channels.</li>
|
|
18
|
+
{{ /each }}
|
|
19
|
+
</ul>
|
|
20
|
+
</section>
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
<section class="contain max-w:s11 pd-t:c1 pd-b:c5 /md/ pd-t:c5 pd-b:c8">
|
|
2
|
+
<div class="col gap:d6 pd-b:c1 /md/ pd-b:c3">
|
|
3
|
+
<p class="font:eyebrow:semibold:widest format:uppercase text:accent">{{ eyebrow:text }}</p>
|
|
4
|
+
<div class="col gap:d6 /lg/ row:y-end:x-between gap:d10">
|
|
5
|
+
<h1 class="font:instrument:h1:regular:tight text:ink:none">{{ heading:text:required }}</h1>
|
|
6
|
+
<p class="font:h6:normal text:ink-2:relaxed:brief">{{ intro:text }}</p>
|
|
7
|
+
</div>
|
|
8
|
+
</div>
|
|
9
|
+
<ol class="list-style-type:none col bd-t:width-px:solid:line">
|
|
10
|
+
{{ each:children:newest }}
|
|
11
|
+
<li class="bd-b:width-px:solid:line">
|
|
12
|
+
<a href="{{ item.url }}" class="grid:cols-1-fr:gap-d6 pd-y:d10 text:ink @hover:[text:accent] transition:fast /md/ grid:cols-12-fr:gap-d8 pd-y:c1">
|
|
13
|
+
<div class="col gap:d4 /md/ col-spans:from-1:to-7 pd-t:d2">
|
|
14
|
+
<time datetime="{{ item.date-iso }}" class="font:eyebrow:semibold:widest format:uppercase text:ink-3">{{ item.date }}</time>
|
|
15
|
+
<h2 class="font:instrument:h3:regular:tight text:ink:hug">{{ if:item.heading }}{{ item.heading }}{{ else }}{{ item.title }}{{ /if }}</h2>
|
|
16
|
+
<p class="text:ink-2:relaxed:brief">{{ item.description }}</p>
|
|
17
|
+
<span class="row:y-center gap:d2 pd-t:d2 font:small:semibold text:accent">Read it <span aria-hidden="true">→</span></span>
|
|
18
|
+
</div>
|
|
19
|
+
{{ if:item.cover }}
|
|
20
|
+
<div class="child:order--1 /md/ col-spans:from-8:to-13 child:order-0">
|
|
21
|
+
<img src="{{ item.cover }}" class="block w:full h:auto aspect:landscape fit:cover bd:round-d2 bg-color:paper-2">
|
|
22
|
+
</div>
|
|
23
|
+
{{ /if }}
|
|
24
|
+
</a>
|
|
25
|
+
</li>
|
|
26
|
+
{{ else }}
|
|
27
|
+
<li class="pd-y:d10 text:ink-3">No posts yet. Add one from Channels.</li>
|
|
28
|
+
{{ /each }}
|
|
29
|
+
</ol>
|
|
30
|
+
</section>
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
<section class="bg-color:ink text:paper">
|
|
2
|
+
<figure class="contain max-w:s11 col gap:d8 pd-y:c3 /md/ pd-y:c8">
|
|
3
|
+
<blockquote class="font:instrument:statement:regular:tight text:paper:hug max-w:s11">“{{ quote:text:required }}”</blockquote>
|
|
4
|
+
<figcaption class="row:y-center gap:d3 font:small text:line">
|
|
5
|
+
<span class="w:d8 h:px bg-color:accent"></span>
|
|
6
|
+
{{ by:text }}
|
|
7
|
+
</figcaption>
|
|
8
|
+
</figure>
|
|
9
|
+
</section>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
<div class="contain max-w:s11 col gap:d6 pd-y:d10 bd-t:width-px:solid:line font:small text:ink-3 /md/ row:y-center:x-between">
|
|
2
|
+
<p>{{ note:text }}</p>
|
|
3
|
+
<ul class="list-style-type:none row:wrap gap:d5">
|
|
4
|
+
{{ list:links }}
|
|
5
|
+
<li><a href="{{ address:text }}" class="text:ink-3 @hover:[text:ink] transition:fast">{{ label:text }}</a></li>
|
|
6
|
+
{{ /list }}
|
|
7
|
+
</ul>
|
|
8
|
+
</div>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
<nav class="contain max-w:s11 col gap:d4 pd-y:d6 /sm/ row:y-center:x-between /md/ pd-y:d8" aria-label="Main">
|
|
2
|
+
<a href="/" class="row:y-center gap:d3 w:fit-content font:instrument:h5 text:ink @hover:[text:accent] transition:fast"><span class="w:d4 h:d4 bd:round-full bg-color:accent"></span>{{ name:text:required }}</a>
|
|
3
|
+
<ul class="list-style-type:none row:wrap gap:d5 font:small:medium /md/ gap:d6">
|
|
4
|
+
{{ list:links }}
|
|
5
|
+
<li><a href="{{ address:text }}" class="text:ink-2 @hover:[text:ink] @current:[text:ink] transition:fast">{{ label:text }}</a></li>
|
|
6
|
+
{{ /list }}
|
|
7
|
+
</ul>
|
|
8
|
+
</nav>
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
<section class="contain max-w:s11 col gap:d8 pd-y:c2 bd-t:width-px:solid:line /md/ pd-y:c3">
|
|
2
|
+
<h2 class="font:instrument:h3:regular:tight text:ink:none">{{ heading:text }}</h2>
|
|
3
|
+
<ul class="list-style-type:none row:wrap gap:d3">
|
|
4
|
+
{{ each:all-tags:most }}
|
|
5
|
+
<li><a href="{{ item.url }}" class="row:y-center gap:d2 pd:d4:d2 bd:width-px:solid:line bd:round-c10 font:small:medium text:ink @hover:[bd:accent_text:accent] transition:fast">{{ item.title }} <span class="text:ink-3">{{ item.count }}</span></a></li>
|
|
6
|
+
{{ else }}
|
|
7
|
+
<li class="text:ink-3">No tags yet. Add them to posts in Page settings.</li>
|
|
8
|
+
{{ /each }}
|
|
9
|
+
</ul>
|
|
10
|
+
</section>
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
<section class="contain max-w:s11 pd-t:c1 pd-b:c3 /md/ pd-t:c5 pd-b:c5">
|
|
2
|
+
<div class="col gap:d6 pd-b:c1 /md/ pd-b:c3">
|
|
3
|
+
<p class="font:eyebrow:semibold:widest format:uppercase text:accent">{{ eyebrow:text }}</p>
|
|
4
|
+
<h1 class="font:instrument:h1:regular:tight text:ink:none">{{ if:page.tag }}{{ page.tag }}{{ else }}{{ heading:text }}{{ /if }}</h1>
|
|
5
|
+
<p class="font:h6:normal text:ink-2:relaxed:brief">{{ intro:text }}</p>
|
|
6
|
+
</div>
|
|
7
|
+
<ol class="list-style-type:none col bd-t:width-px:solid:line">
|
|
8
|
+
{{ each:tagged:newest }}
|
|
9
|
+
<li class="bd-b:width-px:solid:line">
|
|
10
|
+
<a href="{{ item.url }}" class="col gap:d3 pd-y:d8 text:ink @hover:[text:accent] transition:fast /md/ row:y-baseline:x-between gap:d10">
|
|
11
|
+
<span class="font:instrument:h4:regular:tight">{{ if:item.heading }}{{ item.heading }}{{ else }}{{ item.title }}{{ /if }}</span>
|
|
12
|
+
<time datetime="{{ item.date-iso }}" class="font:small text:ink-3 /md/ child:no-shrink">{{ item.date }}</time>
|
|
13
|
+
</a>
|
|
14
|
+
</li>
|
|
15
|
+
{{ else }}
|
|
16
|
+
<li class="pd-y:d8 text:ink-3">Nothing here yet.</li>
|
|
17
|
+
{{ /each }}
|
|
18
|
+
</ol>
|
|
19
|
+
</section>
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
<section class="contain max-w:s11 col gap:d10 pd-y:c2 bd-t:width-px:solid:line /md/ pd-y:c5">
|
|
2
|
+
<h2 class="font:instrument:h2:regular:tight text:ink:none">{{ heading:text }}</h2>
|
|
3
|
+
<ul class="list-style-type:none grid:cols-1-fr:gap-d10 /sm/ grid:cols-2-fr:gap-d8 /lg/ grid:cols-3-fr">
|
|
4
|
+
{{ list:people }}
|
|
5
|
+
<li class="col gap:d4">
|
|
6
|
+
{{ if:photo }}<img src="{{ photo:image }}" class="block w:full h:auto aspect:square fit:cover bd:round-d2 bg-color:paper-2">{{ /if }}
|
|
7
|
+
<div class="col gap:d1">
|
|
8
|
+
<h3 class="font:instrument:h4:regular:tight text:ink">{{ name:text:required }}</h3>
|
|
9
|
+
<p class="font:small text:accent">{{ role:text }}</p>
|
|
10
|
+
</div>
|
|
11
|
+
<p class="text:ink-2:relaxed">{{ about:text }}</p>
|
|
12
|
+
</li>
|
|
13
|
+
{{ /list }}
|
|
14
|
+
</ul>
|
|
15
|
+
</section>
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
<section class="contain max-w:s11 grid:cols-1-fr:gap-d8 pd-y:c2 bd-t:width-px:solid:line /lg/ grid:cols-12-fr:gap-d8 pd-y:c5">
|
|
2
|
+
<h2 class="font:instrument:h2:regular:tight text:ink:none /lg/ col-spans:from-1:to-6">{{ heading:text }}</h2>
|
|
3
|
+
<div class="font:inter:h6 text:ink-2:loose /lg/ col-spans:from-7:to-13">{{ body:rich:headings:lists:links:quotes }}</div>
|
|
4
|
+
</section>
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
{
|
|
2
|
+
"template": "page",
|
|
3
|
+
"title": "Page not found",
|
|
4
|
+
"description": "There's nothing at this address.",
|
|
5
|
+
"fields": {},
|
|
6
|
+
"blocks": {
|
|
7
|
+
"content": [
|
|
8
|
+
{
|
|
9
|
+
"id": "nf-hero",
|
|
10
|
+
"block": "hero",
|
|
11
|
+
"fields": {
|
|
12
|
+
"eyebrow": "404",
|
|
13
|
+
"headline": "There's nothing here.",
|
|
14
|
+
"intro": "The page may have moved, or the address may have a typo.",
|
|
15
|
+
"button": "Go to the home page",
|
|
16
|
+
"button-address": "/"
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
]
|
|
20
|
+
}
|
|
21
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
{
|
|
2
|
+
"template": "page",
|
|
3
|
+
"title": "About",
|
|
4
|
+
"description": "Two designers, one long table, and a habit of finishing things. How Northlight works and who it works with.",
|
|
5
|
+
"fields": {},
|
|
6
|
+
"blocks": {
|
|
7
|
+
"content": [
|
|
8
|
+
{
|
|
9
|
+
"id": "b-c7835c",
|
|
10
|
+
"block": "hero",
|
|
11
|
+
"fields": {
|
|
12
|
+
"eyebrow": "About the studio",
|
|
13
|
+
"headline": "Two people, one long table, and a habit of finishing things.",
|
|
14
|
+
"intro": "We started Northlight because we wanted to do fewer projects, better, and to stay with each one long enough to see it work."
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"id": "b-10cf36",
|
|
19
|
+
"block": "team",
|
|
20
|
+
"fields": {
|
|
21
|
+
"heading": "Who you'll work with"
|
|
22
|
+
},
|
|
23
|
+
"blocks": {
|
|
24
|
+
"people": [
|
|
25
|
+
{
|
|
26
|
+
"id": "b-4b8fc1",
|
|
27
|
+
"block": "team--people",
|
|
28
|
+
"fields": {
|
|
29
|
+
"name": "Ada Moreno",
|
|
30
|
+
"role": "Design lead",
|
|
31
|
+
"about": "Ada leads the design: research, type, layout and the hundred small decisions in between. Before Northlight she drew wayfinding for hospitals."
|
|
32
|
+
}
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"id": "b-83c455",
|
|
36
|
+
"block": "team--people",
|
|
37
|
+
"fields": {
|
|
38
|
+
"name": "Lin Okafor",
|
|
39
|
+
"role": "Build lead",
|
|
40
|
+
"about": "Lin leads the build and keeps it simple enough to change. She's happiest when a client edits their own site without calling."
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
]
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"id": "b-5ba557",
|
|
48
|
+
"block": "text",
|
|
49
|
+
"fields": {
|
|
50
|
+
"heading": "How a project runs",
|
|
51
|
+
"body": "<p>Every project gets both of us. One leads the design, the other leads the build, and we swap notes all day. There are no account managers and no hand-offs, so the person you talk to on day one is the person who ships the work.</p><p>We work with independent businesses, non-profits and the occasional brave team inside a bigger company. Most projects run eight to twelve weeks, and we take on three or four a year.</p>"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"id": "b-6e0b3d",
|
|
56
|
+
"block": "call-to-action",
|
|
57
|
+
"fields": {
|
|
58
|
+
"heading": "If that sounds like you, we'd like to hear what you're making.",
|
|
59
|
+
"button": "Write to us",
|
|
60
|
+
"button-address": "mailto:hello@northlight.studio"
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
]
|
|
64
|
+
}
|
|
65
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
<p>Field & Fold bakes for eleven cafés across the city. Their opening crew starts at four, and the first thing each baker does is open a checklist app on a shared tablet by the ovens. The app worked. People hated it. We were asked to find out why.</p>
|
|
2
|
+
<h2>Three mornings by the ovens</h2>
|
|
3
|
+
<p>We asked to watch before we asked anything else, so we spent three mornings standing out of the way with notebooks. A few things were obvious within an hour:</p>
|
|
4
|
+
<ul>
|
|
5
|
+
<li>Hands are floury or gloved. Small buttons get pressed with a knuckle, or not at all.</li>
|
|
6
|
+
<li>The tablet sits at waist height, so most people read it from a metre and a half away.</li>
|
|
7
|
+
<li>The order of the list was the order someone typed it, not the order the work happens.</li>
|
|
8
|
+
<li>Nobody reads instructions at 4:10 in the morning. They read the first three words.</li>
|
|
9
|
+
</ul>
|
|
10
|
+
<figure><img src="checklist.jpg" alt="A clipboard holding a checklist with five items ticked in orange and three still open."><figcaption>The new list, in the order the kitchen actually works, with every item short enough to read from the ovens.</figcaption></figure>
|
|
11
|
+
<h2>What changed</h2>
|
|
12
|
+
<p>Most of the redesign came down to size and order. We didn't add a single feature.</p>
|
|
13
|
+
<table>
|
|
14
|
+
<tr><th>Before</th><th>After</th><th>Why</th></tr>
|
|
15
|
+
<tr><td>32 items, one long scroll</td><td>4 stages of 6–9 items</td><td>Matches how the shift moves from ovens to counter</td></tr>
|
|
16
|
+
<tr><td>44 px tap targets</td><td>Full-width rows, 88 px tall</td><td>Gloves and knuckles</td></tr>
|
|
17
|
+
<tr><td>Full sentences</td><td>Three words, then details</td><td>Read from a metre and a half</td></tr>
|
|
18
|
+
<tr><td>Ticks reset at midnight</td><td>Ticks reset when the shift starts</td><td>Night bakes were vanishing</td></tr>
|
|
19
|
+
</table>
|
|
20
|
+
<blockquote><p>The best compliment we got was a baker who said she'd stopped noticing the app was there.</p></blockquote>
|
|
21
|
+
<aside><p><strong>A small rule we now use everywhere:</strong> if a screen will be read from more than an arm's length away, design it at that distance. Stand back from your monitor and look.</p></aside>
|
|
22
|
+
<p>Three months on, missed steps on the opening shift are down by more than half, and the crew asked for the same treatment for closing. You can read more about how we work on our <a href="/about/">about page</a>.</p>
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"template": "post",
|
|
3
|
+
"title": "Designing for the morning shift",
|
|
4
|
+
"description": "We spent three early mornings with a bakery's opening crew before redesigning the checklist app they use every day. What we saw changed almost everything.",
|
|
5
|
+
"date": "2026-11-09",
|
|
6
|
+
"tags": [
|
|
7
|
+
"Case notes",
|
|
8
|
+
"Research"
|
|
9
|
+
],
|
|
10
|
+
"fields": {
|
|
11
|
+
"heading": "Designing for the morning shift.",
|
|
12
|
+
"cover": {
|
|
13
|
+
"file": "cover.jpg",
|
|
14
|
+
"alt": "A dark building at dawn with a scattering of lit orange windows."
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"template": "page",
|
|
3
|
+
"title": "Journal",
|
|
4
|
+
"description": "Notes from the studio on process, tools and the small decisions that make work hold up.",
|
|
5
|
+
"fields": {},
|
|
6
|
+
"blocks": {
|
|
7
|
+
"content": [
|
|
8
|
+
{
|
|
9
|
+
"id": "b-3dafca",
|
|
10
|
+
"block": "post-index",
|
|
11
|
+
"fields": {
|
|
12
|
+
"eyebrow": "Journal",
|
|
13
|
+
"heading": "Notes from the long table.",
|
|
14
|
+
"intro": "How we work, what we're learning, and the small decisions that make a project hold up after we've gone home."
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
]
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<p>Every project starts the same way: with a week in which we make nothing you could put on a screen. Clients sometimes find this strange. They've hired designers, and for five days the designers mostly ask questions, read old emails and stick index cards to a wall.</p>
|
|
2
|
+
<p>We'd skip it if we could. We can't, because every project that went wrong for us went wrong in that first week, by guessing at something we could have asked.</p>
|
|
3
|
+
<h2>Five days, five questions</h2>
|
|
4
|
+
<p>Each day of the week has one job. We don't move to the next until the current one has a written answer that everyone on both sides has read.</p>
|
|
5
|
+
<ol>
|
|
6
|
+
<li><strong>Who is this for?</strong> Not a persona: three real people, by name, and what they're trying to get done.</li>
|
|
7
|
+
<li><strong>What happens today?</strong> We watch the current way of doing things, however clumsy, before we judge it.</li>
|
|
8
|
+
<li><strong>What must not break?</strong> The habits, links and phone numbers people rely on without thinking.</li>
|
|
9
|
+
<li><strong>What would be enough?</strong> The smallest version that would still be worth launching.</li>
|
|
10
|
+
<li><strong>How will we know?</strong> One or two measures we'll check a month after launch.</li>
|
|
11
|
+
</ol>
|
|
12
|
+
<figure><img src="wall-of-cards.jpg" alt="Twenty index cards pinned to a wall in five neat columns, a few marked in orange."><figcaption>By Friday the wall usually looks like this. Orange cards are the decisions we've agreed not to revisit.</figcaption></figure>
|
|
13
|
+
<h2>Writing it down</h2>
|
|
14
|
+
<p>At the end of the week we send a short document, rarely more than four pages, that says what we heard and what we're going to do about it. It's the most useful thing we make. We refer back to it in every meeting, and when someone asks "why is it like this?" six months later, the answer is usually in there.</p>
|
|
15
|
+
<blockquote><p>The brief you're given is a guess. The first week is how you find out which parts of the guess are right.</p></blockquote>
|
|
16
|
+
<aside><p><strong>If you're hiring a studio,</strong> ask what their first week looks like. If the answer is "we start on concepts," ask who those concepts are for.</p></aside>
|
|
17
|
+
<p>None of this is new. It's just easy to skip when there's a deadline and a team that's itching to design. We've found that the week pays for itself by the end of the month, every time. If you'd like to see an example of the document, <a href="mailto:hello@northlight.studio">write to us</a> and we'll send one, with the client's blessing.</p>
|
|
Binary file
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"template": "post",
|
|
3
|
+
"title": "What we do in the first week",
|
|
4
|
+
"description": "Before we draw anything, we spend five days listening, sorting and writing things down. Here's what that week looks like, and why we won't skip it.",
|
|
5
|
+
"date": "2026-10-02",
|
|
6
|
+
"tags": [
|
|
7
|
+
"Process",
|
|
8
|
+
"Research"
|
|
9
|
+
],
|
|
10
|
+
"fields": {
|
|
11
|
+
"heading": "What we do in the first week, before we draw anything.",
|
|
12
|
+
"cover": {
|
|
13
|
+
"file": "cover.jpg",
|
|
14
|
+
"alt": "An orange sun rising behind a long table with five cups on it."
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
}
|
|
Binary file
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
{
|
|
2
|
+
"template": "page",
|
|
3
|
+
"title": "Northlight — a small studio for useful, beautiful things",
|
|
4
|
+
"description": "Northlight is a two-person design studio. We make websites, identities and tools for people who care how things are made.",
|
|
5
|
+
"fields": {},
|
|
6
|
+
"blocks": {
|
|
7
|
+
"content": [
|
|
8
|
+
{
|
|
9
|
+
"id": "b-9722a3",
|
|
10
|
+
"block": "hero",
|
|
11
|
+
"fields": {
|
|
12
|
+
"eyebrow": "Independent design studio",
|
|
13
|
+
"headline": "We make quiet, useful things for loud, busy places.",
|
|
14
|
+
"intro": "Northlight is a two-person studio. We design websites, identities and small tools for people who care how things are made, and we stay close to the work from the first sketch to the last line of code.",
|
|
15
|
+
"button": "Start a project",
|
|
16
|
+
"button-address": "mailto:hello@northlight.studio"
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"id": "b-f024c0",
|
|
21
|
+
"block": "features",
|
|
22
|
+
"fields": {
|
|
23
|
+
"heading": "What we make",
|
|
24
|
+
"intro": "Three kinds of work, done by the same two people from start to finish."
|
|
25
|
+
},
|
|
26
|
+
"blocks": {
|
|
27
|
+
"features": [
|
|
28
|
+
{
|
|
29
|
+
"id": "b-f5f52f",
|
|
30
|
+
"block": "features--features",
|
|
31
|
+
"fields": {
|
|
32
|
+
"title": "Websites that hold up",
|
|
33
|
+
"text": "Fast, accessible sites that are easy to change long after we've handed them over. You edit the real page, not a form that describes it."
|
|
34
|
+
}
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"id": "b-a60902",
|
|
38
|
+
"block": "features--features",
|
|
39
|
+
"fields": {
|
|
40
|
+
"title": "Identities with a point of view",
|
|
41
|
+
"text": "Names, marks and type systems that say one clear thing and keep saying it, from a business card to a billboard."
|
|
42
|
+
}
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"id": "b-42d103",
|
|
46
|
+
"block": "features--features",
|
|
47
|
+
"fields": {
|
|
48
|
+
"title": "Tools for the people inside",
|
|
49
|
+
"text": "Dashboards, checklists and small internal apps, designed with the people who'll use them every morning."
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
]
|
|
53
|
+
}
|
|
54
|
+
},
|
|
55
|
+
{
|
|
56
|
+
"id": "b-94289b",
|
|
57
|
+
"block": "image-and-text",
|
|
58
|
+
"fields": {
|
|
59
|
+
"eyebrow": "How we work",
|
|
60
|
+
"heading": "Small team, whole project.",
|
|
61
|
+
"text": "The two people you meet on the first call are the two people who design it, build it and answer the phone when something breaks a year later.",
|
|
62
|
+
"image": {
|
|
63
|
+
"file": "studio-table.jpg",
|
|
64
|
+
"alt": "A long table with two chairs, lit from the window"
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"id": "b-4bae0b",
|
|
70
|
+
"block": "latest-posts",
|
|
71
|
+
"fields": {
|
|
72
|
+
"heading": "From the journal"
|
|
73
|
+
}
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
"id": "b-1ef76b",
|
|
77
|
+
"block": "quote",
|
|
78
|
+
"fields": {
|
|
79
|
+
"quote": "They asked better questions in a week than we'd asked ourselves in a year, and the site still feels new.",
|
|
80
|
+
"by": "Mara Ellison, Field & Fold"
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"id": "b-05764b",
|
|
85
|
+
"block": "call-to-action",
|
|
86
|
+
"fields": {
|
|
87
|
+
"heading": "Got something that needs to work every morning?",
|
|
88
|
+
"button": "Write to us",
|
|
89
|
+
"button-address": "mailto:hello@northlight.studio"
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
]
|
|
93
|
+
}
|
|
94
|
+
}
|