Establishing an immutable Ant Design v5 design system and closed token architecture across 14 enterprise core products at a 250-engineer insurtech company—transitioning from speculative outsourced agency mockups to an enforceable, zero-override software control architecture.
| Ref | Mimari Düğüm | DTCG Token Sözleşmesi | Geometrik Invariant | Masadan Kaldırılan Karar (Eliminated Decision) |
|---|---|---|---|---|
| 1 | TopBar Header | metrics.headerHeight = 48 | Height: 48px · Sabit Başlık | 14 farklı üründeki keyfi başlık yükseklikleri kaldırıldı; platform genelinde tek tip kumanda paneli dayatıldı. |
| 2 | Filter Composite Bar | Input.controlHeight = 40 | Height: 40px · 8px Grid Base | Arayüz geliştiricilerinin formlara keyfi padding vermesi engellendi; 40px floating-label arama standardı bağlandı. |
| 3 | Master Table Row | Table.cellPaddingBlock = 8 | Height: 38px · Regular 400 | Tablo içi satır kayması (CLS) sıfırlandı; 18 kolonluk aktüeryal verinin 100vh ekranda dikey taşma olmadan sığması sağlandı. |
| 4 | Frozen Action Column | Table.column.fixed = 'right' | Pinned Right · 0.5px Hairline | Yatay kaydırmada aksiyon butonlarının ekran dışına kaçması çözüldü; onay mekanizması sağ kenara kilitlendi. |
| 5 | Status Pill Indicator | color.status.success.subtle | Radius: 9999px · WCAG 4.5:1 | Bileşen bazlı renk tercihi yasaklandı; MASAK/KVKK mevzuatına tam uyumlu semantik durum tokenları bağlandı. |
Agito powers core transactional infrastructure for 35% of Turkey’s private life, pension, and property insurance market. An operational audit conducted during the architectural intake revealed a systemic governance dilemma: the organization had committed its year-end design budget to a third consecutive outsourced agency engagement, perpetuating unconstrained visual production without architectural validation.
The 90-day intake audit diagnosed three structural breakdowns in the delivery model:
The resulting executive memorandum diagnosed the primary organizational bottleneck: “Visual output production speed has surpassed validated decision production speed.” The organization was funding high-velocity cosmetic mockups while accumulating compounding architectural debt across 14 enterprise core products.
Accustomed to treating design as cosmetic skinning, leadership initially responded with a familiar reductionist mandate: “Just generate a component list for frontend developers. What the agency delivered works for us anyway; we never had a design culture here to begin with.”
Rather than engaging in subjective aesthetic debates, the design systems architecture function converted the requested component list into an architectural Figma-Deep vs. Code-Deep Technical Debt Risk Model. By evaluating each component against Ant Design v5’s native React API, the model proved that implementing unconstrained agency mockups would impose a 3x engineering drag—projecting over 1,200 hours of bespoke CSS overrides and perpetuating an ongoing $180,000 annual expenditure in third-party agency retainers.
| Ref | Mimari Boyut | Ajans Teslimatı (Figma) | Agito Sistem Sözleşmesi (Kod) | Sapma & Risk | Masadan Kaldırılan Karar (Eliminated Decision) |
|---|---|---|---|---|---|
| 1 | Input Yüksekliği | 38px (Göz Kararı) | 40px (controlHeight: 40) | ▲ +2px CLS Kayması | Keyfi form yüksekliği tartışmaları bitirildi; platformdaki tüm arama girdileri 40px standart kilitlendi. |
| 2 | İç Boşluk (Padding) | 13px (Bağlantısız Değer) | 8px (--space-2 · 8px Grid) | ▲ 5px Hizalama Sapması | Yazılımcıların CSS ile buton ve input içine rastgele piksel yazması yasaklandı; katı 8px ızgara bağlandı. |
| 3 | Köşe Yarıçapı | 9px (Token Dışı) | 4px (borderRadius: 4) | ▲ Tutarsız Geometri | Her ekran için ayrı köşe yuvarlama pazarlığı kaldırıldı; Ant Design v5 köşe tokenı 4px'e sabitlendi. |
| 4 | Marka Rengi | #7B3FE4 (Hardcoded Hex) | colorPrimary: #5D2BC7 | ▲ WCAG AA Başarısız | Renk kodlarının CSS dosyalarına elle yazılması durduruldu; DTCG Style Dictionary derleyicisine bağlandı. |
| 5 | Mühendislik Hızı | 14h / Ekran (Spaghetti CSS) | 2.5h / Ekran (0 Override) | ✓ 5.6× Hızlanma | İlk 40 ekranda 460 saatlik frontend CSS boğuşması kurtarıldı; ekran başı teslimat 2.5 saatin altına indi. |
| Ref | Mimari Karar (Node) | Öncesi / Fatal Flaw | Ant Design v5 Sözleşmesi | Geometrik Invariant | Masadan Kaldırılan Karar (Eliminated Decision) |
|---|---|---|---|---|---|
| 01 | 100vh Viewport Fitting | 5. 100vh İflası | overflow-y: auto | height: 100vh strict | 1920×1080 ekranda sayfa düzeyinde scroll tamamen yasaklandı; filtre barı ve pagination her an ekranda sabitlendi. |
| 02 | 38px Hücre Standardı | 55px Hantal Padding | cellPaddingBlock: 8 | th: 600 · td: 400 | Her ekran için ayrı satır dolgusu tartışması elendi; 14/22px tipografi + 8px dolgu ile tam 38px hücre yüksekliğine kilitlendi. |
| 03 | Cross-Page Batch Selection | 1. Sayfalama Kaybı | preserveSelectedRowKeys | 32px Floating Batch Bar | Sayfa değişiminde seçimlerin silinmesi durduruldu; alt 32px Toplu İşlem Barı ile çoklu sayfa kümülatif onay güvenceye alındı. |
| 04 | Tabular-Nums Para Birimi | 2. Ham Float Tutar | font-variant-numeric | Zero ₺ Symbol · Sağa Hizalı | Tablo sütunlarında dikey basamak zikzakları ve ₺ ikonunun yarattığı görsel gürültü kaldırıldı; tüm tutarlar sağa hizalandı. |
| 05 | 592px Drawer İzolasyonu | 4. Inline Edit İsteği | <Drawer width={592} /> | Template 02 Mutation | Tablo satırlarında doğrudan hücre içi düzenleme yasaklandı; tüm veri güncellemeleri MASAK denetim izi için sağ Drawer'a bağlandı. |
| 06 | Zero-Override Disiplini | 14h Spaghetti CSS | <ConfigProvider /> | 0 Custom CSS Overrides | Yazılımcıların CSS dosyalarına rastgele stil veya !important yamaları yazması durduruldu; DTCG tokenları doğrudan AntD v5'e derlendi. |
Following executive alignment on the architectural risk model, the transition from agency engagement to internal systems architecture exposed the structural gap between static Figma files and production software engineering.
A joint codebase audit conducted alongside frontend engineering mapped the approved agency files directly against production constraints:
| Structural Dimension | The Agency Figma Deliverable | The Frontend Reality in Code |
|---|---|---|
| Component Tokens | Arbitrary hex colors, bespoke padding (13px, 19px), disconnected fonts | Impossible to tokenize; required bespoke styling overrides for every single screen element |
| Framework Feasibility | Bespoke decorative widgets disconnected from Ant Design v5 | Frontend had zero component matches; would require rewriting basic inputs from scratch |
| Responsive Dynamics | Fixed 1440px desktop artboards with no responsive rules or scroll constraints | Collapsed entirely on standard 1920x1080 enterprise workstations with high data volumes |
| Actuarial State Machines | Drew happy-path cards; ignored 18-column tables, partial allocations, edge errors | Failed on first real policy dataset; developers were left to guess error and loading states |
.custom-btn {
height: 38px !important;
padding: 13px 21px !important;
background: #7B3FE4 !important;
border-radius: 9px !important;
}
<Button type="primary">
Submit Policy Application
</Button>
// Handled by ConfigProvider theme={agitoTheme}
The audit exposed a systemic delivery challenge: years of disconnected agency handoffs had forced frontend teams into reactive CSS patching, creating fragmented stylesheets without shared reusability or token standards.
Frontend engineering leadership recognized the technical bottleneck: continuing to implement ad-hoc drawings across 14 enterprise products would accumulate exponential maintenance debt, causing regressions with every release cycle.
Agito established an immutable system baseline: strict behavioral tokens, data density, and Ant Design v5 zero-override contracts took precedence over decorative mockups. The platform transitioned from drawing unconstrained pictures to engineering an enforceable software control architecture.
Resolving legacy design debt required establishing structural governance within active release cycles. In high-density enterprise environments, stakeholders naturally prioritize delivery velocity, often requesting rapid visual outputs to demonstrate sprint progress.
Operating under continuous delivery pressure precluded the luxury of an isolated design system laboratory. The design system had to prove its architectural utility directly within live production sprints.
“In a 250-engineer software house, you cannot stop the production line to build a pristine design system. You must build the tracks directly in front of the moving locomotive. The design system had to earn its right to exist on the sprint battlefield every single week.”
To defend the architecture against ad-hoc churn and arbitrary screen proliferation, the platform enforced the UX Readiness Gate. Before any view enters design ingestion, three mandatory invariants must be locked:
By speaking the language of engineering invariants rather than cosmetic preferences, the gate eliminated over 70% of speculative, un-governed backlog requests prior to design ingestion.
For years, enterprise delivery survived on unwritten tribal knowledge: Product Owners sketched rough wireframes, and veteran engineers bridged the visual gaps using implicit institutional memory. When the organization scaled and onboarded new engineering squads, this tribal model collapsed. New developers had no historical context. They implemented wireframe sketches literally, introducing arbitrary margins, truncated tables, and severe UI drift into production.
Management initially proposed a typical organizational fallacy: training Product Owners to design interfaces. Expecting actuarial analysts to master grid alignments, spacing tokens, and component states diluted their business focus and produced unmaintainable design debt.
The architecture resolved this by removing visual layout decisions from the Product Owner role entirely. POs build functional Figma prototypes solely to articulate business logic and actuarial formulas. The design systems function then runs these inputs through an automated normalization rail:
core.json tokens, generating a zero-override specification for frontend implementation.In high-density enterprise environments, classical design theater is ineffective. Prolonged discovery workshops and superficial empathy maps provide little value to complex actuarial transactions.
Software organizations frequently exhibit an automation asymmetry: while engineering squads operate automated compilers, continuous integration pipelines, and code generators, design is often treated as manual drafting—a single practitioner hand-drawing static frames one by one.
Rather than accepting manual visual drafting as the delivery bottleneck, the design function operates as an industrial software compiler:
Enterprise software for underwriters, claims adjusters, and actuaries cannot be designed with the consumer SaaS playbook—abundant whitespace, decorative cards, endless vertical scroll, and nested modal overlays cause severe operational fatigue. An operator processing 200 policies during an 8-hour shift cannot afford cognitive friction. Every required mouse switch, missing tabular indicator, or jarring layout jump translates directly into operational latency and catastrophic actuarial error risk.
Drawing on empirical research from my Master’s thesis on Interface Trust Architecture and Cognitive Friction in High-Stakes Financial Transactions (Yaşar University), the craft of design at Agito enforces four operational ergonomics invariants before any view reaches code:
Tab sequencing; primary transaction commits trigger via Cmd/Ctrl + Enter; side-sheet inspectors toggle via Esc. Power operators complete high-volume policy endorsements without ever lifting their hands from the home row.
Ergonomic Rule: 100% of core transaction paths executable without mouse movement.
This program is an active, living enterprise transformation. Across the initial baseline inventory of 68 foundational screens, exactly 40 screens (59%) have been delivered to production, with floorplans and reusable patterns being forged in real-time inside live sprints:
The economic leverage of this architecture is direct: by standardizing on the 4 Universal Floorplans and zero-override Ant Design tokens, frontend implementation time dropped from an average of 14 hours per bespoke screen down to under 2.5 hours. Across the 40 screens shipped in Wave 1, this unlocked over 460 engineering hours previously lost to cosmetic debates and CSS wrestling.
| Module Category | Total Scope | Delivered to Code (Done) | Active Pipeline | Architectural Responsibilities |
|---|---|---|---|---|
| Platform Infrastructure | 36 Screens | 17 Delivered | 19 In Progress | Banks, Currencies, System Parameters, Value Lists, Locales, Global Dictionaries. |
| Core Insurance Products | 32 Screens | 23 Delivered | 9 In Progress | Policy Administration, Claims Handlers, Collections Ledgers, Workpool Queues. |
| Wave 1 Foundation | 68 Screens | 40 Delivered (59%) | 28 In Progress | Stress-tested baseline kernel designed to absorb upcoming 350+ screen roadmap. |
Conventional design systems literature promotes a sequential fallacy: "Design and ship all foundational views first, then document your pattern library."
In a 250-engineer organization operating on continuous sprint releases, sequential delivery guarantees architectural drift. When faced with aggressive delivery timelines, the architecture team rejected fragile, compressed visual drafting that yields approval theater and subsequent engineering rework. Instead, Agito established an enforceable 5+2 Week Dual-Track Operating Model:
To eliminate subjective handoff debates, a 4-point Definition of Ready (DoR) governs every screen entering an engineering sprint:
core.json / agitoTheme tokens. Zero arbitrary hex, zero bespoke geometry overrides.@agito/ui.
When standardizing an enterprise software house powering 35% of a national insurance sector, design cannot be an exercise in aesthetic guesswork or copying trendy consumer apps. Heavy transactional software collapses under consumer SaaS patterns; conversely, default enterprise software is notoriously archaic, visually neglected, and hostile to operate.
To resolve this tension, the design systems architecture established the Dual-Benchmark Architecture: anchoring the structural skeleton in battle-tested enterprise frameworks, and calibrating the interaction muscle against modern developer-grade SaaS leaders.
“A modern enterprise platform borrows its structural skeleton from battle-tested enterprise frameworks and its UI/UX muscle from modern SaaS leaders—stability from the giants of the past, execution to the standard of the leaders of the future.”
Within the enterprise skeleton tier, page geometry is the primary invariant. Inventing bespoke layouts per screen breeds unmaintainable frontend debt. To eliminate subjective layout debates across 14 insurance products, Agito adapted SAP Fiori’s battle-tested floorplan taxonomy into native Ant Design v5 React primitives, strictly locked to 1920x1080 100vh workstations:
| DOSSIER NO | INSURED ENTITY | POLICY TYPE | PREMIUM | STATUS |
|---|---|---|---|---|
| #CLM-8910 | Anadolu Lojistik A.Ş. | Marine Cargo All-Risk | ₺ 142,500.00 | INSPECTION |
| #CLM-8911 | Borusan Lojistik | Commercial Fleet Excess | ₺ 89,200.00 | APPROVED |
| #CLM-8912 | Eczacıbaşı Holding | Property Catastrophe | ₺ 320,000.00 | PENDING |
| #CLM-8913 | Kordsa Teknik Tekstil | Industrial Fire & Loss | ₺ 215,400.00 | APPROVED |
| #CLM-8914 | Koç Sistem A.Ş. | Cyber Risk Retention | ₺ 94,000.00 | INSPECTION |
| #CLM-8915 | Migros Ticaret A.Ş. | Warehouse Stock Floater | ₺ 410,000.00 | PENDING |
| CURRENCY | ENTITY IDENTIFIER | ACTUARIAL SHARE | REINSURANCE TREATY | LIMIT (MAX) | EFFECTIVE DATE | STATUS | ACTIONS |
|---|---|---|---|---|---|---|---|
| TRY | Turkish Lira (Base Portfolio) | 100.00% | Consortium Net Retention | ₺ 500,000,000 | 2026-01-01 | LOCKED | |
| USD | US Dollar (Treaty Cross Rate) | 40.00% | SwissRe Quota Share 2026 | $ 85,000,000 | 2026-01-15 | LOCKED | |
| EUR | Euro (Continental Commercial) | 25.00% | MunichRe Excess of Loss | € 40,000,000 | 2026-02-01 | LOCKED | |
| GBP | British Pound (Lloyd's Syndicate) | 15.00% | Catastrophe Fac Obligatory | £ 15,000,000 | 2026-03-01 | AUDIT | |
| CHF | Swiss Franc (Zurich Hedging) | 10.00% | Direct Settlement Slip | CHF 12,000,000 | 2026-03-15 | INSPECTION |
(Allocated Claim × Excess Rate) − Policy Deductible
The single source of truth is a pure JSON schema (core.json) adhering to Design Tokens Community Group (DTCG) standards. Compiled via Style Dictionary directly into agitoTheme, brand tokens propagate across all 14 products with zero custom CSS.
core.json adhering to DTCG standards.core.json automatically compiles and propagates across all 14 platforms via CI/CD with zero manual CSS refactoring.
To maintain rapid delivery speed without sacrificing structural discipline, Agito deployed an autonomous subagent compilation pipeline. Feeding actuarial rule tables and floorplan blueprints directly to subagents compiles code-ready Ant Design v5 specifications in minutes—enabling single-architect operational leverage while maintaining strict design system governance.
“Design systems in enterprise companies fail when they are treated as artistic libraries. They succeed when they are built as engineering contracts. By aligning with frontend reality on Day 14, locking 4 floorplans under live sprint fire, and enforcing zero custom CSS, Agito transformed design from an expensive organizational bottleneck into a deterministic scaling engine.”
An enterprise control system is an evolving infrastructure asset. The platform's roadmap is tracked across distinct operational waves, expanding governance incrementally without introducing architectural regressions:
| Milestone Phase | Lifecycle State | Scope & Coverage | Architectural Outcomes |
|---|---|---|---|
| Wave 1.0 (Baseline Kernel) | SHIPPED | 40 / 68 Screens (59%) | Ant Design v5 zero-override theme locked; 4 Floorplans deployed; 0 custom CSS overrides. |
| Wave 1.1 (Dual-Track Extraction) | CURRENT SPRINT | Central Pattern Library | Federated self-serve UI assembly kit for Product Owners; real-time pattern hardening. |
| Wave 1.2 (Platform Completion) | ACTIVE PIPELINE | Remaining 28 Screens | Bank payment gateways, currency exchange matrices, custom error topologies. |
| Wave 2.0 (Enterprise Expansion) | HORIZON ROADMAP | 180+ Enterprise Views | Zero-marginal-cost scaling: Reinsurance treaty modeling, broker & agency distribution mesh. |
The ultimate transformation at Agito was not merely technical; it was an organizational and mental model shift. Navigating 14 monolithic enterprise products under live sprint deadlines forced a structural paradigm shift: moving from the fragile, decorative handoff pipelines of consumer apps to an immutable, code-governed control architecture:
| Strategic Dimension | 01 · The Visual Screen Producer | 02 · The Control Systems Architect |
|---|---|---|
| Value Metric | Screen volume delivered (drawing 60+ static pictures in Figma). | Decisions removed from the table (0 ad-hoc layouts, 0 arbitrary hex). |
| Engineering Drag | Bespoke CSS debt per view; developers guess missing edge states. | Zero styling overrides; implementation drops from 14h to 2.5h (-82%). |
| Cost of Change | Compounding frontend debt; requires constant agency retainers. | Flat marginal cost; token changes propagate globally in seconds. |
| Boundary Governance | Fragile wall handoff; zero framework or viewport awareness. | Ant Design v5 contracts; locked to 100vh runtime constraints. |
| Long-Term Outcome | Three failed agency handovers over five years. | Autonomous software factory operated directly by dev squads. |
The core failure of the three external agencies was not that they made bad components; it was that Agito outsourced visual production without establishing decision ownership and validation mechanisms.
“A high-tier design systems architect is not paid to produce three times as many screens. They are paid to operate where the cost of architectural decisions is high: turning ambiguity into structure, preventing multi-year engineering debt, and establishing code-governed systems that an entire enterprise can operate autonomously.”
Currently leading core platform modernization at Agito. Available for select Staff / Principal Design Systems Architect advisory and high-stakes global remote opportunities.