modern-web-app-architecture

Guide architects in designing modern web applications with rendering strategies and architecture trade-offs.

49|9|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/ratacat/claude-skills --skill modern-web-app-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: modern-web-app-architecture
Source: https://github.com/ratacat/claude-skills/tree/main/skills/modern-web-app-architecture
Command: npx skills add https://github.com/ratacat/claude-skills --skill modern-web-app-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance for designing and building modern web applications (SPA/SSR/SSG/ISR/RSC). It helps teams navigate architecture trade-offs, define state and data patterns, optimize performance, establish testing and delivery practices, and scale teams effectively.

Core Features & Use Cases

  • Trade-off driven architecture: Guides per-route rendering strategy decisions (CSR/SSR/SSG/ISR/RSC) and defines stable interfaces and boundaries.
  • State & data planning: Helps plan local, shared, global, server, and URL state, including caching and invalidation strategies.
  • Non-functional planning: Provides guidance on performance budgets, accessibility, security, observability, and delivery practices to ship resilient apps.
  • Reference patterns: Offers curated references on architecture decisions, patterns, and modularization to accelerate work.

Quick Start

  1. Clarify your app’s routing and rendering needs, then assign a rendering strategy per route.
  2. Create architecture decisions (ADRs) for major choices like SSR vs CSR per boundary and data fetching approaches.
  3. Produce artifacts (structure, ADRs, checklists) to guide implementation and align team ownership.

Frequently Asked Questions about modern-web-app-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between SPA, SSR, SSG, and ISR for my web app routes?

Rendering strategy selection depends on your route's content volatility, SEO needs, and performance targets. SPA suits interactive, user-specific content; SSR balances interactivity with SEO; SSG works for static content; ISR and RSC offer hybrid approaches. Assign a strategy per route based on these trade-offs, document the decision in an ADR, and define explicit boundaries to align team ownership.

What's the best way to plan state and data patterns for scalable web applications?

Distinguish between local, shared, global, server, and URL state, then define caching and invalidation strategies for each. Plan how data flows through routes and modules, establish fetch boundaries, and document patterns in architecture artifacts. This prevents state collisions and enables independent team scaling.

How do I structure architecture decisions for modern web apps?

Create Architecture Decision Records (ADRs) for major choices: rendering strategy per route, data fetching approaches, state boundaries, and module interfaces. Produce route maps and module diagrams as shared artifacts. This aligns teams, accelerates implementation, and makes trade-offs explicit and revisable.

What non-functional concerns should I plan into web app architecture?

Define performance budgets, accessibility standards, security posture, observability requirements, and delivery pipelines upfront. These concerns shape routing, state handling, and module boundaries. Document trade-offs between performance, user experience, and team velocity in your architecture artifacts.

Can I use these architecture patterns if my team is distributed or scaling?

Yes. Explicit module boundaries, ADRs, and artifact-driven ownership enable distributed teams to work independently. Clear state and data boundaries prevent coordination overhead. Define which team owns which route and module, then use checklists and evaluation criteria to maintain consistency as you scale.

How do CSR, SSR, SSG, ISR, and RSC differ in performance and SEO impact?

CSR maximizes interactivity but delays SEO; SSR ensures SEO and faster first paint but increases server load; SSG offers best performance for static content; ISR and RSC enable hybrid strategies. Trade-offs span Time to First Byte, Time to Interactive, server cost, and content freshness. Choose per route based on your performance budget and user profile.