@nadicodeai/design-system 12.1.84 → 12.1.86
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/DESIGN.md +6 -4
- package/package.json +1 -1
package/DESIGN.md
CHANGED
|
@@ -571,7 +571,7 @@ Content stays solid: cards, KPIs, tables, chat, forms, and dialog, sheet and dra
|
|
|
571
571
|
|
|
572
572
|
Related membership collections share one tabbed workspace: Members, Invitations and, where supported, Teams. One collection is visible at a time and its selection is retained in the URL.
|
|
573
573
|
|
|
574
|
-
**Product views on the website**
|
|
574
|
+
**Product views on the website** preserve the real interface. Nadia uses captures of the running application, with demonstration content labelled and the unchanged full-size image linked, following the founder's 12 October correction of invented UI. Portal and Alveare may use inert scenes built from real components with labelled example data. Never invent interface controls or frame a view in a device mockup. A product window takes the raised height on its ground; a card that overlaps it floats. Live components use dark mode in a black section; captures preserve the application's captured theme.
|
|
575
575
|
|
|
576
576
|
Absence follows its container. The Portal uses plain operational empty states throughout: no collection illustrations, a solid boundary for a page or region, and the same spacing and typography for first use, no data, and no results. Other products may use the illustrated register with a dashed boundary. In every product, an empty state inside a card is unframed, because the card already owns the edge. `EmptyState` (`@nadicodeai/ui/components/empty-state`) is the only owner of an absence: nothing else draws one, and its `scope` (`page`, `region` or `card`) sets that frame. A collection's `DataTable` takes the same props as `empty`. Its kind determines the message and recovery; presentation determines whether first-use artwork is present:
|
|
577
577
|
|
|
@@ -594,6 +594,8 @@ UI text stays static: no shimmer, typing, scrambling, pulsing or animated dots.
|
|
|
594
594
|
|
|
595
595
|
Only Agents move on their own. The interface answers a person's action, briefly, and stops: motion follows the action, grows from the element that was pressed, and settles, within 300 ms; sheets and drawers that follow the pointer take their own durations. Keyboard actions and anything used a hundred times a day are instant. While a person waits for something they asked for, one waiting line moves and nothing else ("System activity"). On the website three things move: Agents, the product at work, and the shader objects. A product scene runs the real components through their states in beats while it is half in view, rests on the finished work, loops, stops off-screen, and holds the finished work under reduced motion; a part of a scene arrives with `.nc-arrive`: it holds its place from the start and comes into focus there on the message-arrival timing, so a playing scene never shifts the page. The threads, the hive and the card's foil move at their own slow pace; each stops off-screen and holds one frame under reduced motion. Words never move, and there is no parallax, scroll reveal of text, marquee or shimmer. Ruled by the founder on 26 September 2026: a Stripe-grade product site, with shaders adjusted to the art direction and the products shown working.
|
|
596
596
|
|
|
597
|
+
The homepage figures have one owner-requested exception: a slight lean in response to a fine pointer, with no autonomous loop and no movement under reduced motion. Architecture and words stay still. Other illustrative pictures remain still.
|
|
598
|
+
|
|
597
599
|
The default transition in every product is `confirm`, 180 ms, `out-strong`. Under reduced motion, movement stops and paint continues: transforms and keyframed movement go to their end state, and opacity and colour transitions stay, because a fade or a colour change is the state change itself. A component never answers reduced motion by turning every transition off.
|
|
598
600
|
|
|
599
601
|
| Token | Use |
|
|
@@ -865,7 +867,7 @@ A recognised app, platform or model maker is drawn with its genuine mark beside
|
|
|
865
867
|
|
|
866
868
|
### Product views
|
|
867
869
|
|
|
868
|
-
|
|
870
|
+
Website product views follow "Product views on the website" in [Elevation & Depth](#elevation--depth): authentic captures or real-component scenes, with demonstration content identified. Preserve the product's register and interface. Crop to the detail being explained; retain an original-image link for captures and never frame a view in a device.
|
|
869
871
|
|
|
870
872
|
### CSS components
|
|
871
873
|
|
|
@@ -918,11 +920,11 @@ The clear space is one stroke width of the rendered logo on every side. The mini
|
|
|
918
920
|
|
|
919
921
|
## Do's and Don'ts
|
|
920
922
|
|
|
921
|
-
- Do keep the brand still: only Agents, the product at work and the website's shader objects move. Don't animate sections, pictures or scrolling.
|
|
923
|
+
- Do keep the brand still: only Agents, the product at work and the website's shader objects move. Don't animate sections, pictures or scrolling, apart from the bounded homepage figure response in Motion.
|
|
922
924
|
- Do use the identity hues at full strength in the places "Colour as stage" lists, with the text pole that clears AA. Don't tint them, grade them, or paint a control, chrome or a status with them.
|
|
923
925
|
- Do choose a surface's height by its physical role, and let its edge and faint shadow show it in both modes. Don't add a border, ring or second shadow to an elevated surface.
|
|
924
926
|
- Do put glass on floating chrome over content that scrolls or moves under it. Don't make content glass, or put glass over a plain ground.
|
|
925
|
-
- Do show the
|
|
927
|
+
- Do show authentic captures or real-component scenes as "Product views on the website" specifies, with demonstration content identified. Don't use device frames or invented interfaces.
|
|
926
928
|
- Do give each thing the corner its role takes on the scale ("Shapes"). Don't give a higher surface a bigger corner.
|
|
927
929
|
- Do give every line one owner, and draw focus only with the focus outline.
|
|
928
930
|
- Do say a status with a Badge tone, a mark and a word. Don't use colour alone or a bare dot.
|