A page of a portal's brand book
const url = 'http://localhost:3000/api/v1/portal/example/site';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url http://localhost:3000/api/v1/portal/example/siteA page of one of the portal’s brands, from its latest publish (never the draft), as this visitor may read it, behind the same door as the portal. path is what follows /p/{slug}: nothing for the first brand’s first page, {page} for a page of the first brand (else another brand’s first page), {brand}/{page}. Pages above the visitor (portal.level) are listed with a lock and carry nothing; sections above them and hidden ones are left out. Every asset URL comes signed. redirect: the path was an old slug or a long form, so send the reader to canonical. A portal showing no brand answers view: null.
No key needed.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The portal’s address
Query Parameters
Section titled “Query Parameters”The portal path, e.g. logo or other-brand/logo
The context the reader starts in, e.g. dark-background
The reader’s language, a lowercase tag: ar, en-gb
A collection section’s id, whose assets find narrows
Words a reader searches that collection section for
Responses
Section titled “Responses”The page
object
object
object
The portal’s own look, for its header: pages wear their brand’s
object
A URL on this host: the portal’s, else its first brand’s mark, else its organization’s
The portal’s, else its first brand’s color, else its organization’s
The organization’s, for the browser tab
What the organization calls the product
Footer, quick grab and terms; an asset in quick grab comes with href, signed to download
object
object
Markdown
object
A URL or mailto:
Quick grab: pinned links in the header
object
With page: a brand the portal carries; the first when left out
Markdown readers accept once before their first download
Search engines may index it; public portals only
It shows collections: its Assets view
Its pages carry “Powered by Artbucket”: a public portal whose organization’s plan has no white-label
Who the visitor is to it: everyone, partners (its password or an approved request) or members
The page’s path on the portal, what links use; null with no page
The path asked was an old slug or a long form: send the reader to canonical
object
object
Every context some rule is scoped to
The look, derived and graded, and the settings it came from
object
The accent, lifted for light and dark pages, and the faces, as before W3
object
A hex color
A hex color
A hex color
A hex color
A hex color
A hex color
The fill, as the brand has it: bands and buttons
The accent where it is text (links), at 4.5:1 on the surface
A hex color
A hex color
object
object
The font file for its weight
Every font file of the rule, one @font-face each
object
From Google Fonts, with no files here yet: set in its fallback until they are imported
object
The font file for its weight
Every font file of the rule, one @font-face each
object
From Google Fonts, with no files here yet: set in its fallback until they are imported
object
The font file for its weight
Every font file of the rule, one @font-face each
object
From Google Fonts, with no files here yet: set in its fallback until they are imported
In em
Header is band
On this page: a side column, a list under the page header, or none
Contrast of each pair in the look: one that fails falls back to a color that reads, and says which
object
Which color on which, e.g. ink on surface
The contrast it must reach: 4.5 for text, 3 for marks
The color used: fg when it passes, else its fallback
object
Hairline: the accent draws rules and marks, never fills
Corner radius in px
Heading size ratio; 1.25 when left out
Every page opens on a band of the brand color; header band says the same
A page’s opening: on the page, on a band of the brand color, or beside its cover
Between two sections on the page’s own ground: space alone, or a hairline too
Number chapters and pages: 01, 01.2
Subtle: sections reveal as they scroll in; never with reduced motion
On this page: a side column, a list under the page header, or hidden
Section titles: headings (medium), or headlines (large, huge); a section’s own size wins
Alternate: every other section on the page’s own ground sits on the panel, so a long page has rhythm; canvas: under its header the page sits on the panel, dotted like a whiteboard, its section titles centered
The languages readers pick from; the first is the one the pages are written in
object
From the language when left out
Links beside search and print on the brand’s pages: its repository, its Figma library, its site
object
Http or https; a link to GitHub, Figma, npm and the like shows its icon
Every page the reader is listed, in order
object
The page it sits under; null at the top
On portals: who may read it
Its child pages show as tabs across its top
The first page, opening on a cover: never numbered
Above the reader: listed by title with a lock, nothing more
object
The page it sits under; null at the top
On portals: who may read it
Its child pages show as tabs across its top
The first page, opening on a cover: never numbered
What the reader gets: hidden ones for editors only
object
GET /api/v1/brand/templates lists them
Markdown
Its ground: plain, tint, brand, panel, dark, color, image or pattern
The rules it shows, by key, in order
Its template’s own settings
object
Markdown
Sections sharing a tab name show under one tab
object
A thing a template lists: a do or a don’t with its picture, a picture in a gallery
object
A rule it shows
Markdown
False: for reference, never offered as a download
A tab per context, its rules resolved for each
Shown only in this context
Landing: a front with no nav column, on-this-page or pager; book: a chapter
An old slug was asked for: the page’s slug now
Every context version of the rules the page binds, the theme’s, and those their specs name
object
Dotted, e.g. color.primary
The heading readers see; null: the key, in words
Null: the default
object
Pixels
400 regular, 700 bold
Its assets readers may see, in order; one that may not be used is left out
object
The assets it names that may be used, by id
object
object
A URL on this host
Larger, for a closer look
object
The file as uploaded
A collection section’s assets, by section id
object
object
object
A URL on this host
Larger, for a closer look
object
The file as uploaded
Why it shows nothing; editors only
With an updates section: the latest publishes, newest first, as many as its largest limit
object
What changed, in the publisher’s words
What it changed for readers since the publish before it
object
By key
object
Pages readers can reach: a hidden one is left out
object
object
object
object
Signatures by asset id, for visitors; empty for members
object
Editors only: what a reader would trip on, assets they won’t see, and theme pairs that fell back
Editors only: keys a section binds with no rule
Example
{ "data": { "portal": { "level": "everyone" }, "view": { "theme": { "accentUse": "fill", "faces": { "head": { "google": true }, "body": { "google": true }, "label": { "google": true } }, "width": "narrow", "density": "compact", "nav": "sidebar", "header": "plain", "separation": "space", "motion": "none", "toc": "side", "settings": { "accentUse": "fill", "width": "narrow", "density": "compact", "nav": "sidebar", "header": "plain", "separation": "space", "motion": "none", "toc": "side", "titles": "medium", "grounds": "plain", "languages": [ { "dir": "ltr" } ] } }, "nav": [ { "audience": "everyone" } ], "page": { "audience": "everyone", "sections": [ { "width": "text", "items": [ { "verdict": "do" } ], "audience": "everyone" } ], "layout": "book" }, "rules": [ { "type": "color" } ], "media": { "additionalProperty": { "downloads": [ { "preset": "web" } ] } }, "collections": { "additionalProperty": { "items": [ { "downloads": [ { "preset": "web" } ] } ] } } } }}Not in yet: how to get in
object
object
object
object
A URL on this host: the portal’s, else its first brand’s mark, else its organization’s
The portal’s, else its first brand’s color, else its organization’s
The organization’s, for the browser tab
What the organization calls the product
Example
{ "error": { "code": "password", "detail": { "access": "password" } }}default
Section titled “default”An error
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": "example" }}