A complete, coherent design choice from a brief alone (every field optional)
post/hosting/design-library/design
A complete, coherent design choice from a brief alone (every field optional): palette, type pairing, spacing and shape, sections, flow, closest template, and for apps shell, screens and component style; plus alternatives with a reason each. A brand kit (colours, fonts, voice) acts as constraints: the palette is built from the brand colours with every contrast correction reported, brand fonts without a web licence are replaced by the nearest open pairing. Deterministic and versioned (selectionVersion).
Before you call
- Credential
Authorization: Bearer $KEY- Scope
hosting:write- Mcp
rivier_design_library_design- Graphql
Mutation.hostingLibraryDesign- Sdk
hosting.library.design- Cli
hosting library design
Request bodyapplication/json, required
- textstringAt most 1500 characters.
- surfacestringOne of: website, app, both.
- siteTypestringAt most 40 characters.
- appTypestringOne of: customer-portal, guest-app, member-area, staff-dashboard, booking-app, shop-app, internal-tool, community-app.
- businessTypestringAt most 40 characters.
- purposelist of string
- moodlist of string
- densitystringOne of: airy, balanced, compact.
- languageslist of string
- rtlboolean
- a11ystringOne of: AA, AAA.
- brandobject
- draftboolean
- namestringAt most 60 characters.
- colorslist of stringrequired
- fontslist of object
- familystringrequiredAt most 60 characters.
- rolestringOne of: heading, body, both.
- stylestringOne of: sans, serif, mono, display.
- webLicenceboolean or unknownrequired
- familystringrequired
- imagerystringAt most 200 characters.
- voicelist of string
- logoTextstringAt most 40 characters.
- useStoredBrandboolean
- darkboolean
Responses
- 200application/jsonSuccess
- 400application/jsonThe request was malformed
- errorstringrequired
- messagestring
- 401application/jsonNo valid credential
- errorstringrequired
- messagestring
- 403application/jsonThe credential lacks the scope, origin or address
- errorstringrequired
- messagestring
- 429application/jsonOver the key's rate limit; see Retry-After
- errorstringrequired
- messagestring