Choosing the right framework for each island in Astro

Introduction

Using the right framework for each part of your website helps it run faster and feel smoother. It lets you pick the best tool for each small section, called an island.

When you want parts of your website to load quickly without waiting for everything.

When different sections need different features or styles.

When you want to mix simple static content with interactive parts.

When you want to improve user experience by loading only what is needed.

When you want to keep your website easy to update and maintain.

Syntax

Astro

---
import { FrameworkComponent } from 'framework-package';
---
<FrameworkComponent client:load />

Use client:load or similar directives to tell Astro when to load the island.

Each island can use a different framework like React, Vue, or Svelte.

Examples

This eagerly loads a React button, hydrating it immediately on mount.

Astro

---
import ReactButton from '../components/ReactButton.jsx';
---
<ReactButton client:load />

This loads a Vue counter when the browser is idle, saving resources.

Astro

---
import VueCounter from '../components/VueCounter.vue';
---
<VueCounter client:idle />

This loads a Svelte form only when it becomes visible on the screen.

Astro

---
import SvelteForm from '../components/SvelteForm.svelte';
---
<SvelteForm client:visible />

Sample Program

This example shows a page with static content and two islands. The React greeting loads right away, and the Vue timer loads only when visible. This keeps the page fast and interactive.

Astro

---
import ReactGreeting from '../components/ReactGreeting.jsx';
import VueTimer from '../components/VueTimer.vue';
---
<html lang="en">
  <head>
    <title>Island Framework Example</title>
  </head>
  <body>
    <h1>Welcome to My Site</h1>
    <ReactGreeting client:load />
    <p>This is static content that loads immediately.</p>
    <VueTimer client:visible />
  </body>
</html>

Important Notes

Islands let you mix static and interactive parts easily.

Loading islands only when needed improves speed and user experience.

Choose frameworks based on what fits each island's needs best.

Summary

Islands are small interactive parts of a page.

Use different frameworks for different islands to get the best results.

Load islands only when needed to keep your site fast.

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