How To Deploy An Astro App To A Step-by-Step Guide for Developers

How To Deploy An Astro App To A Step-by-Step Guide for Developers

The platform empowers developers to build lightning-fast web apps, and services that are edge optimized for performance. In this detailed guide, you’ll learn how to deploy a Astro web app onto Fleek using the Fleek CLI.

What is Astro?

Astro is a web framework designed for creating content-driven websites, such as blogs, marketing sites, and e-commerce platforms. It stands out for its innovative frontend architecture, which minimizes JavaScript overhead and complexity compared to other frameworks. If you’re looking for a fast-loading website with excellent SEO, Astro is the ideal choice.


Let’s get started:

Create A New Astro Project

The first thing we’ll do will be to set up our Astro project.

To create a new Astro project open your terminal, cd into the directory of your choice, and run the following command:

git clone

💡 This code takes the Astro template from the template library and automatically kickstarts your project. You can access an expanding library of other application and framework templates, including Lens, React, and more here.

Start Up Your Dev Server

After cloning, we’ll need to cd into the directory we created and start our dev server. To do that while still in our terminal, run the following command:

cd astro-template && npm i && npm run dev

This will start up the Astro web app. We can visit it by opening http://localhost:3000 on our web browser.

Now that we have a fully functional Astro web app we can proceed to the next step — getting configurations ready for our Fleek deployment.

Fleek Deployment Preparation

To successfully deploy our project on we must ensure that we are able to produce static files and add the appropriate configuration to the app.

Next, run the npm run build command. This will compile our Astro project, and produce the corresponding html code into a folder called dist.

Once we’ve successfully built our app, we can start the deployment process.

Fleek Deployment

Fleek Account Creation

The first thing we’ll need to do is create a Fleek account: head over to, and click on the Create a Free Account button.

💡 Feel free to skip this step if you already have an account on!

You’ll be prompted to create an account with your wallet or an email address. For the sake of this tutorial, we’ll be making an account using our MetaMask account.

Click on the Metamask option from the wallet list and you’ll be presented with a sign-in request in your browser extension. This is to verify ownership of your account.

Once you click on the Sign-In button, you’ll be redirected to the Fleek Dashboard.

Fleek CLI Installation

As we are deploying the website using the fleek-cli, our next step will be to install the fleek-cli on our computer.

Open up your terminal and run:

npm install -g @fleek-platform/cli

This will globally install the fleek-cli onto your machine. Once installed, open the astro-template project in VSCode, and log into your Fleek account via the CLI. This will enable us to run CLI-related commands directly from our terminal.

To login, open your terminal and run:

fleek login

Click on the link displayed to log into your Fleek account. You should see a Success! Logged in.


Now that we’ve successfully logged in, it’s time to get our app ready for deployment on Fleek.

To do that, you’ll need to open up your terminal and run:

fleek sites init

You’ll get a few prompts, populate them as you wish:

You should see:

> Success! Fleek config file has been saved.

And a fleek.config.js file should appear in your root dir.


We’re close to the finish line — the next step here will be to deploy our Svelte app to Fleek.

We’ll do that by running:

fleek sites deploy

Fleek will begin uploading the files in our dist folder to IPFS. You should get a response that looks like this:

> Success! Deployed!> Site IPFS CID: QmVgNN84eJMPoxznUEFmjAhkbhiKS8ic39zucNkWfux3ft> You can visit through the gateway:>

Your site has been successfully deployed!

Now head over to the dashboard, and ensure you are on the right project (open the drop-down menu on the top left of the homepage and select the current project).