Architecture & Decisions

BeyondtheCode

After this book, you'll Stop blaming
the framework — and start seeing what's really breaking the system.

Explore Chapters
ArchitectureFrontend SystemsDecision-MakingTrade-offsTechnical DebtSeniorityCode ExamplesDecision Worksheet

The Core Insight

The Problem
Isn't Technical

When a frontend system becomes hard to evolve, everyone points at the framework. But frameworks don't make decisions — they offer abstractions.

Most serious problems stem from decisions made without explicit criteria — decisions that carried invisible costs, visible only when someone tries to change something.

Core Insight · Frameworks Don't Decide
Switching frameworks changes the surface of the problem. The novelty creates temporary relief. But the decisional structure remains intact. The same implicit choices keep being made — just with a different syntax.

The ebook includes 3 real TypeScript examples — wrong approach vs. conscious structural decision, with documented trade-offs.

What You'll Learn

10 Chapters +
Bonus Case Study

Each chapter builds on the last — from the core mindset shift to a practical decision tool you can use on your team today.

The Problem Isn't Technical
The problem isn't technical. It's decisional.
Frontend Is a System Too
Ignoring systemic nature doesn't reduce complexity — it hides it.
Structural Decisions
Not all decisions carry the same weight.
The Cost of Time
When decisions become constraints.
Trade-offs
What you gain and what you lose.
The Decision Framework
A structured way to decide — the 5 Lenses.
Layers and Responsibilities
Where each decision belongs.
Architecture as Social Contract
Architecture as a shared team agreement.
Seniority and Judgment
What really defines seniority.
What Remains When the Framework Changes
What stays when the technology changes.
In the PDF
Bonus — Real Case Study
340 support tickets. One unnamed decision. A real story with a real cost.
In the PDF
Decision Worksheet
The 5 Lenses in Practice — a scored decision tool for real decisions.

The Decision Framework

The Five
Lenses

Without an explicit model, architectural decisions get guided by intuition, personal preference, or urgency. The 5 Lenses create shared criteria — so different people, at different moments, can evaluate similar choices with comparable references.

Principle
The lenses don't exist to arrive at a single answer. They exist to create productive tension — and make the conflict visible.
5–7
Low Risk
8–11
Moderate
12–15
High Risk

Score your decisions before committing — not after

Coupling
Evolution Over Time
People & Team Scale
Testability
Tech Independence

Bonus Chapter

The Rule That
Nobody Owned

A mid-size e-commerce team. A checkout eligibility rule. No one ever named where it should live.

8%
Users affected
340
Support tickets
11
Days in production

How a single unnamed decision turned into 4 days of engineering — with the full timeline and 5 Lenses breakdown in the ebook.

Principle
The real risk isn't making mistakes. It's making mistakes without knowing why — so they can't be defended, reversed, or learned from.

Everything in the Book

What's Inside

3 Layered Code Examples
Real TypeScript examples showing the wrong approach vs. the conscious structural decision — with documented business impact.
The Decision Worksheet
A printable scoring tool for the 5 Lenses — use it in team reviews before committing to structural decisions.
Temporal Architecture
How to recognize architectural inflection points before crossing them — and what signals to watch for.
Architecture as Social Contract
How architecture creates shared language — and what happens to teams when the agreement was never established.
Seniority Redefined
Why seniority isn't a level — it's a way of relating to uncertainty. The three dimensions that actually matter under pressure.
Reflection Questions
Every chapter ends with exercises designed to surface invisible decisions in your current codebase — today.

"Frameworks pass.
Decisions remain.
And everything that truly matters in architecture begins beyond the code."

— Rodrigo Paixao, Frontend Society

Frontend Society · Free Ebook

Stop blaming
the framework

35 pages. 10 chapters. 3 code examples. 1 real case study. A decision worksheet you can use on your team today. Free.

Follow @frontendsociety
35 pagesArchitecture & DecisionsReal code examplesPrintable worksheet