01101 components de producció
De les primitives a composicions de pàgina completes: 101 components, cadascun extret d'un producte que lliurem, no dissenyat de manera aïllada. Si un component és a PDS, ja ha fet feina real: aquest web, les demos dels productes i els panells dels nostres clients s'hi renderitzen.
02Design tokens
Color, tipografia, espai i moviment es resolen des d'una única capa de tokens. Canvia un token i tots els components el segueixen: sense sobreescriptures per component, sense desviacions entre productes.
03Dos temes, cinc accents
Un tema fosc i un de clar, cinc colors d'accent, tots governats pels mateixos tokens. La variació de marca és un canvi de tokens, no un fork: tots els productes de la família es renderitzen des del mateix sistema.
04Primer, el mode fosc
Contrast, elevació i color es treballen primer sobre el tema fosc; el tema clar es deriva dels mateixos tokens. El resultat és un mode fosc que se sent natiu, no invertit.
Botons, camps d'entrada, selectors, interruptors, lliscadors i l'estructura dels camps: etiquetes, ajudes i errors inclosos. Els estats ja estan dissenyats: focus, desactivat, no vàlid i càrrega es comporten igual a tots els productes.
06Maquetació i composició
Stacks, graelles, separadors i estructures de pàgina permeten compondre pantalles sense CSS ad hoc. Els components més grans són composicions de pàgina completes: patrons de hero, secció i peu de pàgina extrets de pàgines que lliurem.
07Navegació
Capçaleres, pestanyes, fils d'Ariadna i menús amb el comportament responsiu i de teclat ja integrat. La navegació d'aquest web és el component, no una imitació.
08Superposicions
Modals, sheets, calaixos, popovers i tooltips sobre un únic model de capes: captura del focus, tancament i apilament resolts una sola vegada, de manera centralitzada. Cap producte porta la seva pròpia aritmètica de z-index.
09Visualització de dades
Taules, llistes, targetes d'estadístiques, insígnies i cronologies per a productes que viuen de números. Les consoles d'operador de tota la família hi troben la seva densitat.
10Feedback i estat
Toasts, banners, estats buits, progrés i skeletons: els estats poc lluïts, dissenyats des del principi. Un producte construït sobre PDS té una resposta meditada per a la càrrega, el buit i l'error.
11Tipografia
Una escala tipogràfica editorial amb etiquetes monoespaiades per al registre tècnic: la veu que es veu a totes les superfícies de Protocore. L'escala són tokens, de manera que els productes l'ajusten sense sortir del sistema.
12Moviment
Les durades i les corbes d'acceleració s'ofereixen com a tokens, amb els components que ja les fan servir. Les interfícies es mouen de manera coherent entre productes perquè ningú no reajusta una animació a mà.
13Accessible de sèrie
El contrast, els estats de focus i el comportament de teclat van integrats als components, no es deixen com a exercici. Utilitza els valors per defecte i l'accessibilitat hi ve inclosa.
14CSS sense runtime
L'estil és CSS estàtic resolt en temps de compilació: sense runtime de CSS-in-JS, sense res calculat al navegador. La capa d'estils afegeix zero JavaScript a la pàgina.
15Capa CSS independent del framework
El sistema també es lliura com a paquet de CSS pur: tokens i classes d'utilitat sense necessitat de React. Les pàgines renderitzades al servidor, els correus i els stacks sense React beuen de la mateixa font de veritat.
16Exportació de tokens per stack
Els tokens s'exporten per al web com a variables CSS, com a preset de Tailwind i en formats natius per a plataformes mòbils. Una sola definició de la marca, consumida allà on s'executa el producte.
17Theme provider i hooks
La capa de React embolcalla les apps en un provider i exposa els tokens mitjançant hooks: els components llegeixen el tema i l'accent actius en lloc de codificar els valors. Canviar de tema és estat, no una recompilació.
18Temes whitelabel
El mateix mecanisme que dona cinc accents a PDS dona la seva marca a un producte whitelabel: canvia els valors dels tokens i conserva els components. Cada aplicació whitelabel de la família n'és la prova que funciona.
19Mapa llms.txt
Un mapa llegible per màquines de tot el sistema —components, tokens, patrons— publicat com a llms.txt. Apunta-hi un LLM i el codi generat fa servir components reals de PDS en lloc d'inventar-ne de versemblants.
20Servidor MCP
Un servidor MCP exposa el sistema directament als agents de programació: components, props i tokens, consultables mentre l'agent construeix. El sistema de disseny respon preguntes en lloc de ser enganxat als prompts.
21Documentat de dalt a baix
Cada component viu a pds.protocore.io amb exemples en directe, props i codi per copiar i enganxar. La documentació es renderitza amb el mateix PDS: el que llegeixes és el que lliures.
22Versions publicades
PDS es lliura en paquets versionats, amb versions semàntiques i registres de canvis. Les actualitzacions són deliberades: un equip s'hi mou quan vol, i el changelog diu exactament què ha canviat.
23Registre privat
Els paquets s'instal·len des del registre npm privat de Protocore amb un token per equip a .npmrc: el flux estàndard de npm, limitat als equips amb llicència. Sense fitxers zip inclosos al repositori, sense instal·lacions per còpia i enganxa.
24Claus de llicència fora de línia
Una clau de llicència signada es verifica en local: sense phone-home, sense cap comprovació de xarxa al build. Els problemes de llicència apareixen com a avisos en desenvolupament i mai no trenquen una aplicació en producció.
25Llicència per equip
PDS és propietari i es llicencia per equip. Sol·licita accés i ho configurem tot —paquets, documentació i fonts dels tokens— perquè un equip pugui adoptar-lo en una tarda.