Choosing the right framework for each island in Astro - Performance & Optimization

Performance: Choosing the right framework for each island

HIGH IMPACT

This affects page load speed and interaction responsiveness by optimizing how much JavaScript is sent and run on the client.

Rendering multiple interactive UI islands on a page

Astro

Choose lightweight frameworks like Preact or Solid for small islands and React only for complex ones, loading only needed runtimes.

Reduces JavaScript size and parsing time, speeding up initial paint and interaction readiness.

📈 Performance GainSaves 150-250kb per island, reduces blocking time to under 50ms, improves LCP and INP

Rendering multiple interactive UI islands on a page

Astro

Use a heavy framework like React for every island regardless of complexity, importing full React runtime for each.

This loads large JavaScript bundles multiple times, increasing page load and blocking rendering.

📉 Performance CostAdds 200-300kb per island, blocks rendering for 200+ ms, increases LCP and INP

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Heavy framework for all islands	High (many nodes with framework wrappers)	Multiple reflows per island	High paint cost due to large JS	[X] Bad
Lightweight framework per island	Minimal DOM overhead	Single reflow per island	Low paint cost with small JS bundles	[OK] Good

Rendering Pipeline

Choosing the right framework affects how much JavaScript is parsed and executed, impacting style calculation, layout, and paint.

→JavaScript Parsing

→Style Calculation

→Layout

→Paint

→Composite

⚠️ BottleneckJavaScript Parsing and Execution

Core Web Vital Affected

LCP, INP

This affects page load speed and interaction responsiveness by optimizing how much JavaScript is sent and run on the client.

Optimization Tips

1Use lightweight frameworks for small interactive islands to reduce JavaScript size.

2Avoid loading heavy frameworks multiple times on the same page.

3Load framework runtimes only when needed to minimize blocking time.

Performance Quiz - 3 Questions

What is the main performance benefit of choosing a lightweight framework for small islands?

A Smaller JavaScript bundles reduce load and parsing time

B More DOM nodes are created for better structure

C More CSS styles are applied for better visuals

D More reflows happen to update layout faster

DevTools: Performance

How to check: Record a page load and interaction, then analyze scripting time and main thread blocking.

What to look for: Look for long scripting tasks and large JS bundles causing delays in first paint and input responsiveness.

Practice

1. What is the main reason to choose different frameworks for different islands in Astro?

easy

A. To optimize performance by loading only needed code for each island

B. To make the entire page load all frameworks at once

C. To force all islands to use the same framework

D. To avoid using any JavaScript on the page

Solution

1. Step 1: Understand what islands are in Astro

   Islands are small interactive parts of a page that can use different frameworks.

2. Step 2: Reason why different frameworks are chosen per island

   Choosing different frameworks lets you load only the code needed for each island, improving performance.

3. Final Answer:

   To optimize performance by loading only needed code for each island -> Option A

4. Quick Check:

   Performance optimization = B [OK]

Hint: Islands load only needed code to keep pages fast [OK]

Common Mistakes:

• Thinking all islands load all frameworks at once
• Believing islands must share the same framework
• Assuming no JavaScript is used at all

2. Which of the following is the correct way to specify a React island in Astro?

easy

A. <MyComponent client:react />

B. <MyComponent client:only='react' />

C. <MyComponent client:load />

D. <MyComponent client:hydrate />

Solution

1. Step 1: Recall Astro syntax for framework islands

   Astro uses client:only='react' to specify that the component should only load the React framework.

2. Step 2: Match the correct syntax for React island

   The correct syntax to specify a React island is client:only='react'.

3. Final Answer:

   <MyComponent client:only='react' /> -> Option B

4. Quick Check:

   Astro island syntax for React = A [OK]

Hint: Use client:only='react' to specify React islands [OK]

Common Mistakes:

• Using client:load without specifying framework
• Using client:react which is invalid
• Using client:hydrate which is invalid directive

3. Given this Astro island code:

<Counter client:load />

What happens when the page loads?

medium

A. The Counter component loads and runs JavaScript immediately on page load

B. The Counter component never loads JavaScript

C. The Counter component loads JavaScript only when visible on screen

D. The Counter component loads JavaScript only on user interaction

Solution

1. Step 1: Understand client:load behavior

   client:load means the island's JavaScript loads and runs as soon as the page loads.

2. Step 2: Apply this to the Counter component

   The Counter component will load and run its JavaScript immediately when the page loads.

3. Final Answer:

   The Counter component loads and runs JavaScript immediately on page load -> Option A

4. Quick Check:

   client:load = immediate JS load [OK]

Hint: client:load runs JS immediately on page load [OK]

Common Mistakes:

• Confusing client:load with client:visible or client:idle
• Thinking JS loads only on interaction
• Assuming no JS loads at all

4. You wrote this Astro island:

<MyWidget client:only='vue' />

But the widget does not load. What is the likely problem?

medium

A. Astro does not support Vue islands

B. client:only='vue' is invalid syntax

C. You must use client:load instead of client:only

D. You forgot to install the Vue integration in Astro

Solution

1. Step 1: Check if Vue integration is installed

   If the widget does not load, the most likely cause is forgetting to install the Vue integration in Astro.

2. Step 2: Confirm syntax

   client:only='vue' is valid syntax to specify Vue islands.

3. Final Answer:

   You forgot to install the Vue integration in Astro -> Option D

4. Quick Check:

   Missing integration = A [OK]

Hint: Install framework integrations to enable client:only usage [OK]

Common Mistakes:

• Forgetting to install Vue integration
• Thinking Astro doesn't support Vue
• Confusing client:load with client:only

5. You want to create a page with three islands: a React form, a Svelte chart, and a Vue button. How should you configure these islands in Astro for best performance?

hard

A. Load all frameworks globally in the main layout and use islands without client directives

B. Use client:load on all islands without specifying frameworks

C. Use React component with client:load, Svelte component with client:load, and Vue component with client:load on each island and install all three integrations

D. Use only one framework for all islands to avoid multiple integrations

Solution

1. Step 1: Identify the best practice for multiple frameworks

   Astro allows multiple frameworks per page by using components from each framework with client:load (or other) on each island and installing needed integrations.

2. Step 2: Avoid loading all frameworks globally or using client:load without framework

   Loading all globally wastes resources; use per-island components.

3. Step 3: Choose the correct approach

   Configure React form with client:load, Svelte chart with client:load, Vue button with client:load, with integrations for best performance.

4. Final Answer:

   Use React component with client:load, Svelte component with client:load, and Vue component with client:load on each island and install all three integrations -> Option C

5. Quick Check:

   Multiple frameworks per island = D [OK]

Hint: Use client:load with all needed integrations for multiple islands [OK]

Common Mistakes:

• Loading all frameworks globally wasting resources
• Using client:load without specifying framework
• Trying to use only one framework for all islands