Corporate Design

Description

CSS styles the user-facing surfaces of web applications across the deployment. This role registers design as a canonical service in the deployment’s service registry so consumer roles can declare the corporate design as a runtime dependency.

Overview

This role owns the design service flag and the corporate design configuration (services.design.colors, services.design.font), and declares web-svc-cdn as the upstream that serves the actual CSS bytes. Consumer roles gate design-dependent surfaces on 'web-svc-design' in group_names via their own meta/services.yml. An enabled design flag injects the shared CSS and activates the JavaScript injection of the consumer; javascript stays independently switchable. The role’s canonical domain 301-redirects to the CDN’s canonical domain so health probes against the design hostname return a valid response.

Override the base color per inventory:

applications:
  web-svc-design:
    services:
      design:
        colors:
          base: "#FFA500"

Architecture

ARCHITECTURE.md draws Corporate Design from its own metadata: the containers it runs under compose, what changes under swarm, how each volume is backed, and every role it depends on or is depended upon by.

Section	Drawn from
Compose	meta/services.yml
Swarm	meta/services.yml replicas and placement
Volumes	meta/volumes.yml against the NFS decision chain
Dependencies	meta/services.yml and meta/main.yml of every role

Features

• Service flag ownership: Owns the design entry in the central service registry.

• Design SPOT: Holds the base color and font configuration every injected stylesheet derives from.

• CDN-backed delivery: Declares web-svc-cdn as the upstream that serves the actual CSS bytes.

• Health-probe friendly: Redirects the canonical CSS hostname to the CDN so HTTP probes return a valid response.

• Variant-matrix coverage: Ships meta/variants.yml exercising both polarities of the cdn dependency.

Quick Setup

Development

Clone, set up the workstation, and deploy Corporate Design onto the local stack:

git clone https://github.com/infinito-nexus/core.git
cd core
make onboard
make compose-deploy mode=reinstall apps=web-svc-design full_cycle=false

Production

Install Corporate Design directly onto the target machine: clone the repository, install the OS prerequisites and the repository toolchain, then deploy against localhost over a local connection (no SSH, no container):

git clone https://github.com/infinito-nexus/core.git
cd core
bash scripts/install/package.sh
make install
source scripts/meta/env/load.sh

APP=web-svc-design
DOMAIN="<your-domain>"
TLS_MODE=self_signed
SSH_PUBLIC_KEY="<your-ssh-public-key>"
INVENTORY=inventories/production
infinito administration inventory provision "$INVENTORY" \
  --inventory-file "$INVENTORY/devices.yml" \
  --host localhost \
  --include "$APP" \
  --vars "{\"TLS_MODE\": \"$TLS_MODE\", \"DOMAIN_PRIMARY\": \"$DOMAIN\", \"users\": {\"administrator\": {\"authorized_keys\": [\"$SSH_PUBLIC_KEY\"]}}}"
infinito administration deploy dedicated "$INVENTORY/devices.yml" \
  --password-file "$INVENTORY/.password" \
  --diff -vv

Further Resources

• CSS on MDN

• Corporate design galleries: overview of the review of every designed role

Credits

Kevin Veen-Birkenbach

Part of the Infinito.Nexus Project and maintained by Kevin Veen-Birkenbach. Licensed under the Infinito.Nexus Community License (Non-Commercial).

This role deploys no third-party application, so the licence above is the only one that applies.