Cotomy Design Notes

Design background, problem notes, and development backstory for long-lived business UI systems.

Cotomy  Documentation 

Start Here

Start with the problem framing, architecture notes, and development backstory behind Cotomy.

Problem Notes

Structural problems in long-lived business UI systems, state drift, and runtime safety.

Architecture Notes

Why Cotomy's boundaries, lifecycle coordination, and type structure took their current form.

Development Backstory

Implementation memories and turning points that explain why the structure exists.

Design Notes

Long-lived notes on business UI structure, runtime boundaries, and operational stability.

Why I Avoided a SPA for a Large Internal System

A practical reflection on why a large CRUD-heavy internal business system with many screens was easier to build and maintain without making SPA architecture the default.

Small-Team Development Without Losing Continuity

In teams of one to three people, continuity depends less on role separation and more on shared understanding, document granularity, and records that let the work be handed over when necessary.

The Birth of the Form Abstraction

Why Cotomy ended up with multiple form layers, and how that structure came from the gap between desktop application habits and web runtime reality.

Where State Actually Changes

In CRUD screens, the core problem is often not where state is stored, but whether the mutation path is defined. Once load, input, save, and reload are allowed to diverge, the screen becomes difficult to reason about.

Synchronizing UI and Server State

Server-side postback screens were limited, but they kept one execution path. Once Ajax became the main update mechanism, keeping display, input state, and server truth aligned became a structural problem.

Screen State Consistency in Long-Lived UIs

State failures in business UIs are usually not isolated bugs. They appear when DOM state, in-memory state, and server state have no explicit ownership and synchronization rules.

Series

Explore the public design note series. View all series →

Problem Series

Problem notes about long-lived business UI, state drift, runtime boundaries, and operational safety.

Design Series

Architecture notes explaining why Cotomy uses its current boundaries, lifecycle model, and type structure.

Development Backstory

Development memories and turning points behind Cotomy's UI runtime and form abstractions.

Misc

Field notes on AI-assisted development, solo work, small-team continuity, and practical design pressure.