Keia Atlas

Vendor access

This part is for Aigna staff

Vendors see their own installation and the device reference they need to build it: device types, setup guides and models. Everything else stays with Aigna.

Go to your installation

About Keia Atlas

About Keia Atlas

A made-up demo of 344 spaces and 1,631 units · 30 decisions recorded

The problem

AV and IT teams look after hundreds of meeting rooms, desks and shared spaces. The standard for each kind of space usually lives in a document or a slide deck. What is actually installed lives in a spreadsheet, an asset system and the vendor's cloud portals. Nothing connects them, so simple questions are hard to answer:

  • Is this space built the way our standard says it should be?
  • Which cable goes into which port, and do we have enough outlets behind the display?
  • What is being replaced right now, and what is due next year?

The approach

  1. Write the standard as data. Each space type lists its build options, the device each option needs, the outlets it needs, and a wiring template that says which port connects to which. Most are based on public industry guidance: AVIXA's display sizing, the Microsoft Teams Rooms and Zoom room sizes, TIA-568 cabling and the manufacturers' own space sizes, with every house assumption marked. The rest are a small house standard for home offices, comms rooms and IT stores.
  2. Describe devices from the vendor's own documents. Every one of the 66 models has its size, power and every port, taken from datasheets and manuals. Each was read twice, independently, and the two readings compared field by field. Where a vendor is silent, the model says so under "gaps" rather than guessing.
  3. Check it all at build time. Every file is checked against a schema, then cross-checked: does every cable fit the connector at both ends, is any port used twice, are there enough outlets, does every installed unit have a unique serial and asset tag? A mistake stops the build.
  4. Show it as a console. The site leads with what to review, then lets you drill from a site to a space to a device and its ports.

How it's built

  • The Keia framework underneath. The core vocabulary (space types, device classes, lifecycle stages, the split between a device's role and the physical box) comes from the Keia framework, an open way of describing environments. This console pins one version of it and never edits it; its own ideas sit in extension schemas.
  • Data first. Plain YAML files, readable in any editor and reviewable in a pull request, checked by JSON Schema.
  • A static site. Astro turns the data into plain HTML at build time. There is no server and no database to run.
  • Design tokens. Every colour, size and radius is a token, so the five looks in Settings change tokens only, never components. Studio is the default; Enterprise uses PatternFly token values (MIT).
  • Motion with purpose. Pages move by direction with the browser's View Transitions API, drawings and ports morph as you step between models, and switching tabs never moves the page. All of it switches off if your system asks for reduced motion.

The rule book

How Keia Atlas moves, lays out pages, draws devices and spaces, and words things, written down as short numbered rules so anyone adding to it gets the same result.

Read the rule bookMotion, layout, devices, spaces, platform pages, words, looks and data, with live examples

What's real and what isn't

Device models and their ports are real and public, and the space types rest on public industry guidance, with sources on every page and house assumptions marked. Aigna, its buildings, spaces, people and serial numbers are made up. Buildings are named after native Irish trees and spaces after Irish birds.

Demo dates move with today; the story stays the same. Real facts, such as firmware release dates and when a manufacturer ends support, never move.

What Keia logs about users

What Keia Atlas keeps about the people who use it, what it never keeps, and what the cameras and microphones in Aigna's rooms pick up.

What Keia logs about usersNothing about you in this demo; what a real deployment keeps; privacy records for every sensing device

Accessibility

What works with a keyboard, a screen reader, larger text or less motion, how to change it in Settings, and what does not work yet.

AccessibilityThe settings, what is supported, the known gaps and how to report a problem

Decision records

Why things are the way they are
0001Record design decisionsKeia Atlas is being rebuilt from a working prototype. A lot of the value is in the reasoning: why the data looks the way it does, why one tool over another.…0002Build on Keia as a pinned submodule[Keia](https://github.com/kb35/keia) already defines how to describe an environment and the things in it: composite profiles (what a correctly built space…0003YAML data, checked by JSON SchemaThe data (device models, spaces, wiring) lives as YAML files in the repo, where people can read and review it.0004A static site built with AstroThe prototype is one hand-assembled HTML file. The rebuild needs a page per device model, space type, site and space, generated from the YAML, and it should…0005Own components on design tokensKeia Atlas has five themes: Enterprise (a neutral, dense look in slate and blue), Classic, High contrast, Drawing set and Control room. They differ in…0006Space types on public industry guidanceThe prototype called its templates "room types". Keia's composite profile has a `space_type` field, and some spaces with technology aren't rooms at all:…0007Space types before device modelsThe first plan built one device model end to end (step 2), then the space types (step 3). That gives an early drawing, but it means choosing which devices…0008Device models from vendor documents, read twiceStep 3 needs the physical facts of 27 device models: size, weight, power, and every port with its connector, signals, direction and side. These come from…0009Two standards: industry guidance and a house standardMost of Keia Atlas's space types are based on public industry guidance (decision 0006). Some things the project needs aren't in that guidance: remote…0010Eight made-up sites for a made-up companyThe space types and device models describe what a space should contain. To show the rest of the lifecycle (what is installed where, how it is wired, when it…0011Wiring templates and installed devicesEach space type option says what equipment a space holds and which power and data outlets it needs. To show wiring and lifecycle, Keia Atlas also needs to…0012A task-first console siteThe data is complete enough to show: 20 space types, 40 device models, 8 sites, 176 spaces and 1,164 installed devices. An early preview listed it all as…0013Five looks, one set of componentsThe prototype had five visual looks: the original warm-paper Classic, a neutral, dense Enterprise look, a high contrast variant, a Drawing set styled like an…0014Wiring diagrams and a refresh plan from the dataEach space type option already has a checked wiring template, and each installed unit has an install date. Two questions follow naturally: what does the…0015Device profiles with the model morphThe first version of the console site (0012) had device model pages but no device profiles, and drew ports as generic shapes. The brief asks for device…0016Studio becomes the default lookThe project wanted a new default look, Studio: Linear in style and UniFi in spirit, where every device is a picture of the product with its ports on its…0017The playful look is the default, and one motion rule bookOn review of Studio, the owner preferred the v3 prototype's playful design: ink outlines, hard offset shadows, graph paper, bold display type and the yellow…0018Grouped navigation, demo controls in Settings, and projectsThe owner asked for the sidebar to follow the location and device structure: region, site, space; device profile, configuration, device and device unit. He…0019Rooms, not spaces; generic roles; stages that build on each otherThe product is called Keia Atlas, and the people who use it talk about rooms and room types. The first version chose "space" so that desks, pantries and home…0020Team, playbooks, the year plan, the Lab, incidents and a vendor viewOn review the owner asked for the delivery side of the work to be visible, not just the device side: playbooks for each kind of project (with a new office…0021Device pages, comms rooms, editing, vendors, and a leaner sidebarThe owner asked for: room visuals (including MDF and IDF comms rooms with racks and the path to the internet); a page per device, as NetBox has; a leaner…0022Seven places, one Report button, and pages that use their first screenThe sidebar had 18 items in 7 groups; Changes was its own section; the top bar carried a "name · Stages 1 to 6" pill nobody understood. Pages spent 170 to…0023The product is called Keia AtlasThe product was first called Keia, then Console, then Roomstate. Keia is the framework underneath, and its licence names a different copyright holder, so…0024Incidents get a page each, a subject and a lifecycleReview found the incidents page really poor. It was one long list of five cards. A ticket could not be linked to, it did not say which unit it was about, and…0025The Integrate phase, home offices, one shape for work, and live changesInstalling a device and getting it working were two phases, Install and Commission, with provisioning and configuring filed under one or the other. The owner…0026One page anatomy: the page scrolls, and every page is built from the same partsReview feedback asked for uniform pages (filters, band, key numbers and tabs in the same place on every page, with motion and continuity between pages) and…0027Help mode: point at anything to see what it is and what to doOn Learn, the owner said it would be good to have training, but there should be a mode on each page that you can switch on, and when you point at something…0028UniFi for the IT network, and a rack you can read without hoveringFeedback: comms room pages have a terrible experience; every hover over the rack "gets really bad". Could it just show what each device is, as a drawn…0029Known issues from makers, matched to the fleet, and maker casesThe request: makers such as HP Poly (in Poly Lens and their release notes) publish known issues with their firmware. When Keia Atlas fetches firmware…0030An interactive 3D office: one building model, shown two waysThe owner asked for "a 3D model of a whole office, including the MDF and all the cable in and everything, so everything can be seen, it all makes sense and…

View as

See Keia Atlas the way someone else does. A demo: nobody signs in.

Viewing asAnna ByrneAV and IT delivery engineer · EMEA

Suggested

Delivery

  • Delivery engineerDesigns and commissions spaces, from survey to handover
  • Project managerRuns projects day to day: dates, suppliers and who does what
  • On-site technicianInstalls and fixes kit in the offices
  • Programme managerPlans the year of projects across every region
  • Engineering managerLeads the delivery engineers
  • Project management leadLeads the project managers
  • On-site services managerLeads the on-site technicians
  • Delivery managerThe whole delivery team, every region

Support and service

  • Service desk analystTakes incidents as they arrive and routes them
  • Network engineerPorts, VLANs and patching
  • Service manager, AVOwns the AV standard and its service
  • Service manager, networkOwns the network standard and its service

The Lab

  • Innovation engineerTests new kit before it ships

Leadership

  • Head of AV and ITThe whole service, every region

Partners

  • Integration vendorSees their own installations only
  • Service vendorRepairs under the service contract

Overview

  • EveryoneEvery role's first screen at once, to see the whole picture

Settings

Appearance
LookStudio
Text size
Default

Report

Tell the team

About About this project

Goes to Sofia Reyes, Service manager, AV. Reviewed within five working days.