Public directory for static assets in Astro

Introduction

The public directory holds files like images, fonts, or icons that your website needs to show directly. It makes these files easy to use without extra setup.

You want to add a logo image that appears on every page.

You need to include a custom font file for your website text.

You want to add a favicon that shows in the browser tab.

You have PDF or downloadable files for visitors.

You want to serve static files without processing or bundling.

Syntax

Astro

public/
  logo.png
  favicon.ico
  fonts/
    custom-font.woff2
  docs/
    guide.pdf

Files inside the public folder are copied as-is to the final website.

You can access these files in your code using a root-relative URL starting with /.

Examples

Use the image from the public folder directly with a root path.

Astro

<img src="/logo.png" alt="Site Logo" />

Set the favicon using the file in the public directory.

Astro

<link rel="icon" href="/favicon.ico" />

Load a font file from the public folder in your CSS.

Astro

@font-face {
  font-family: 'CustomFont';
  src: url('/fonts/custom-font.woff2') format('woff2');
}

Sample Program

This Astro component shows how to use files from the public directory. The logo image, favicon, and a downloadable PDF are all served directly from public/.

Astro

---
// No special code needed in Astro component
---
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Public Directory Example</title>
    <link rel="icon" href="/favicon.ico" />
  </head>
  <body>
    <h1>Welcome to My Site</h1>
    <img src="/logo.png" alt="Site Logo" width="200" />
    <p>Here is a downloadable guide:</p>
    <a href="/docs/guide.pdf" download>Download Guide</a>
  </body>
</html>

Important Notes

Do not put sensitive or private files in the public directory because anyone can access them.

Use the public folder only for files that do not need processing or bundling by Astro.

Summary

The public directory stores static files served as-is.

Access files with root-relative URLs starting with /.

Good for images, fonts, icons, and downloadable files.

Practice

1. What is the main purpose of the public directory in an Astro project?

easy

A. To store static files that are served directly without processing

B. To write server-side code for API routes

C. To keep component files for UI rendering

D. To store configuration files for the project

Solution

1. Step 1: Understand the role of the public directory

   The public directory is designed to hold static assets like images, fonts, and icons that do not need processing.

2. Step 2: Differentiate from other directories

   Unlike source or config folders, public files are served as-is with root-relative URLs.

3. Final Answer:

   To store static files that are served directly without processing -> Option A

4. Quick Check:

   Public directory = static files served as-is [OK]

Hint: Public folder holds files served directly at root URL [OK]

Common Mistakes:

• Confusing public with source code folders
• Thinking public is for server code
• Assuming public files are processed or compiled

2. Which of the following is the correct way to reference an image named logo.png stored in the public directory inside an Astro component?

easy

A. <img src="./logo.png" alt="Logo" />

B. <img src="/logo.png" alt="Logo" />

C. <img src="public/logo.png" alt="Logo" />

D. <img src="../logo.png" alt="Logo" />

Solution

1. Step 1: Understand URL referencing for public assets

   Files in the public directory are accessed with root-relative URLs starting with a slash (/).

2. Step 2: Apply correct path for image source

   Using /logo.png correctly points to the file in the public folder.

3. Final Answer:

   <img src="/logo.png" alt="Logo" /> -> Option B

4. Quick Check:

   Public assets use root-relative paths starting with / [OK]

Hint: Use root-relative path starting with / for public files [OK]

Common Mistakes:

• Using relative paths like ./ or ../ for public assets
• Including 'public/' in the URL path
• Forgetting the leading slash in the path

3. Given a file icon.svg inside the public/icons folder, what will be the URL to access it in the browser?

medium

A. /src/icons/icon.svg

B. /public/icons/icon.svg

C. ./icons/icon.svg

D. /icons/icon.svg

Solution

1. Step 1: Identify the public folder URL mapping

   Files inside the public folder are served at the root URL, so the folder name after public is part of the URL.

2. Step 2: Construct the URL path

   The file inside public/icons is accessed as /icons/icon.svg.

3. Final Answer:

   /icons/icon.svg -> Option D

4. Quick Check:

   Public folder maps to root URL, so path = /icons/icon.svg [OK]

Hint: Public subfolders appear directly after root slash in URL [OK]

Common Mistakes:

• Including 'public' in the URL path
• Using relative paths like ./icons/icon.svg
• Referencing source folders instead of public

4. You placed a font file custom-font.woff2 inside the public/fonts folder but your CSS @font-face rule is not loading it. Which of the following is the most likely cause?

medium

A. The font file should be inside the src folder, not public

B. Astro does not support font files in the public directory

C. The CSS URL is missing the leading slash, e.g., url('fonts/custom-font.woff2')

D. The font file must be imported in the component script

Solution

1. Step 1: Check CSS URL path for public assets

   URLs for files in public must start with a slash to be root-relative.

2. Step 2: Identify the missing slash issue

   Using url('fonts/custom-font.woff2') is relative and incorrect; it should be url('/fonts/custom-font.woff2').

3. Final Answer:

   The CSS URL is missing the leading slash, e.g., url('fonts/custom-font.woff2') -> Option C

4. Quick Check:

   Public assets need root-relative URLs starting with / [OK]

Hint: Always start public asset URLs with / in CSS [OK]

Common Mistakes:

• Omitting the leading slash in CSS URLs
• Moving static assets to wrong folders
• Expecting Astro to process font files automatically

5. You want to add a downloadable PDF named guide.pdf to your Astro site. You placed it inside the public/docs folder. How should you create a link in your component so users can download it when clicked?

hard

A. <a href="/docs/guide.pdf" download>Download Guide</a>

B. <a href="docs/guide.pdf" download>Download Guide</a>

C. <a href="/public/docs/guide.pdf" download>Download Guide</a>

D. <a href="./docs/guide.pdf" download>Download Guide</a>

Solution

1. Step 1: Understand public folder URL mapping

   Files inside public are served at root URL, so the path must start with a slash and exclude 'public'.

2. Step 2: Use correct href with download attribute

   The link should use /docs/guide.pdf as href and include the download attribute for direct download.

3. Final Answer:

   <a href="/docs/guide.pdf" download>Download Guide</a> -> Option A

4. Quick Check:

   Public files use root-relative URLs with leading / and download attribute triggers download [OK]

Hint: Use root-relative URL with download attribute for static files [OK]

Common Mistakes:

• Omitting the leading slash in href
• Including 'public' in the URL path
• Using relative paths like ./docs/guide.pdf