Why Astro ships zero JavaScript by default

Introduction

Astro sends no JavaScript to the browser unless you ask for it. This makes websites faster and simpler because less code runs on your visitor's device.

Building a simple blog or content site where you want fast loading and no extra scripts.

Creating a marketing page that mostly shows text and images without interactive parts.

Making a portfolio site where you want to keep things lightweight and quick.

Developing a documentation site that mostly shows static content.

Launching a landing page that should load instantly on any device.

Syntax

Astro

No special syntax is needed to ship zero JavaScript. Just write your Astro components normally without adding client-side scripts.

Astro components render to static HTML by default.

You add JavaScript only when you use directives like .

Examples

This Astro component ships zero JavaScript because it has no client directives.

Astro

---
// No client directives here
---
<h1>Hello, world!</h1>

This component ships JavaScript because of client:load, which tells Astro to send the Counter script to the browser.

Astro

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

Sample Program

This simple Astro page renders static HTML with no JavaScript sent to the browser. It loads very fast and works everywhere.

Astro

---
// src/pages/index.astro
---
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Astro Zero JS Example</title>
  </head>
  <body>
    <h1>Welcome to Astro!</h1>
    <p>This page ships zero JavaScript by default.</p>
  </body>
</html>

Important Notes

Astro's default behavior helps improve website speed and reduces data usage.

You can add JavaScript only where needed, keeping the rest of your site lightweight.

Summary

Astro sends no JavaScript to the browser unless you explicitly add it.

This approach makes sites faster and simpler.

You add JavaScript only with special client directives.

Practice

1. Why does Astro ship zero JavaScript by default to the browser?

easy

A. Because Astro does not support JavaScript at all

B. To make websites faster by sending only necessary code

C. To force developers to write all code in CSS

D. Because JavaScript is not supported in modern browsers

Solution

1. Step 1: Understand Astro's default behavior

   Astro sends no JavaScript to the browser unless explicitly added.

2. Step 2: Reason why this is beneficial

   Sending less JavaScript makes websites load faster and simpler.

3. Final Answer:

   To make websites faster by sending only necessary code -> Option B

4. Quick Check:

   Astro ships zero JS by default to improve speed [OK]

Hint: Astro avoids sending JS unless needed to speed up sites [OK]

Common Mistakes:

• Thinking Astro doesn't support JavaScript at all
• Believing JavaScript is disabled in browsers
• Assuming Astro forces CSS-only coding

2. Which syntax correctly adds JavaScript to an Astro component using client directives?

easy

A. <MyComponent client-load />

B. <MyComponent load:client />

C. <MyComponent client:load />

D. <MyComponent loadClient />

Solution

1. Step 1: Recall Astro client directive syntax

   Astro uses client:load to add JavaScript loading behavior.

2. Step 2: Compare options to correct syntax

   Only <MyComponent client:load /> uses the correct client:load syntax.

3. Final Answer:

   <MyComponent client:load /> -> Option C

4. Quick Check:

   Correct client directive syntax is client:load [OK]

Hint: Look for colon between 'client' and 'event name' [OK]

Common Mistakes:

• Swapping order of 'client' and 'load'
• Using hyphens instead of colon
• Omitting the colon entirely

3. Given this Astro component snippet:

<MyWidget client:idle />

What happens when the page loads?

medium

A. JavaScript for MyWidget loads after a user click

B. JavaScript for MyWidget loads immediately on page load

C. JavaScript for MyWidget never loads

D. JavaScript for MyWidget loads only when the browser is idle

Solution

1. Step 1: Understand the client:idle directive

   The client:idle directive loads JavaScript when the browser is idle.

2. Step 2: Determine behavior on page load

   JavaScript does not load immediately but waits until the browser is idle.

3. Final Answer:

   JavaScript for MyWidget loads only when the browser is idle -> Option D

4. Quick Check:

   client:idle delays JS load until idle [OK]

Hint: client:idle means load JS when browser is idle [OK]

Common Mistakes:

• Assuming JS loads immediately on page load
• Confusing client:idle with client:load
• Thinking JS never loads

4. You wrote this Astro code:

<MyButton client:load>Click</MyButton>

But the JavaScript is not loading. What is the likely error?

medium

A. You used client:load on a component that does not export JavaScript

B. You forgot the self-closing slash /> in the component tag

C. Astro does not support client directives on components

D. You need to import JavaScript separately in a script tag

Solution

1. Step 1: Check client directive usage

   Using client:load requires the component to have JavaScript to load.

2. Step 2: Identify if component exports JS

   If MyButton has no JavaScript, the directive does nothing.

3. Final Answer:

   You used client:load on a component that does not export JavaScript -> Option A

4. Quick Check:

   client:load needs JS in component to work [OK]

Hint: Ensure component has JS before using client directives [OK]

Common Mistakes:

• Thinking self-closing slash is mandatory for client directives
• Believing Astro disallows client directives
• Assuming separate script import is always needed

5. You want to add interactive JavaScript only to a button that appears inside a large Astro page. Which approach best follows Astro's zero JavaScript philosophy?

hard

A. Add client:load only to the button component and keep the rest JS-free

B. Add JavaScript globally to the whole page to ensure button works

C. Write all JavaScript inline in the page without client directives

D. Use client:visible on the entire page component

Solution

1. Step 1: Understand Astro's zero JS principle

   Astro sends no JS unless explicitly added to components needing it.

2. Step 2: Choose minimal JS loading

   Adding client:load only to the button loads JS just where needed.

3. Step 3: Avoid global or unnecessary JS

   Global JS or inline scripts increase bundle size and slow page.

4. Final Answer:

   Add client:load only to the button component and keep the rest JS-free -> Option A

5. Quick Check:

   Minimal JS on needed components fits Astro philosophy [OK]

Hint: Add JS only to interactive parts, not whole page [OK]

Common Mistakes:

• Adding JS globally instead of per component
• Using inline scripts without directives
• Applying client:visible to entire page unnecessarily