Nuxt + IPFS Starter Kit Template

Gonzalo Antonicelli
Gonzalo Antonicelli
  • Updated

 

preview

 

πŸ’» GitHub Repo

You can find the template here.

 

πŸš€ Project Structure

Inside of your Nuxt project, you'll see the following folders and files:

/
β”œβ”€β”€ assets/
β”œβ”€β”€ public/
β”œβ”€β”€ components/
β”œβ”€β”€ app.vue
β”œβ”€β”€ nuxt.config.js
└── package.json

If you want to learn more about Nuxt, you can checkout the official Nuxt Documentation.

🧞 Commands

All commands are run from the root of the project, from a terminal:

Command Action
pnpm install Installs dependencies
pnpm run dev Starts local dev server at localhost:3000
pnpm run build Build your production site to .out/public
pnpm run start Start your production site locally
pnpm run generate Generate static project ready for deployment

⚑ How to deploy to Fleek (IPFS)

1. Create a fleek.json config file:

You can configure this site deployment using Fleek CLI and running:

 > fleek sites init
   WARN! Fleek CLI is in beta phase, use it under your own responsibility
   ? Choose one of the existing sites or create a new one. β€Ί 
   ❯ Create a new site

It will prompt you for a namedist directory location & build command

  • name: How you want to name the site
  • dist: The output directory where the site is located, for this template it's .output/public
  • build command: Command to build your site, this will be used to deploy the latest version either by CLI or Github Actions

2. Deploy the site

After configuring your fleek.json file, you can deploy the site by running

fleek sites deploy

After running it you will get an output like this:

 WARN! Fleek CLI is in beta, use it at your own discretion
 > Success! Deployed!
 > Site IPFS CID: QmeMeqXPbcW6mdwMrZtZcmzntn7Di28LYxdFWj7SZchASp

 > You can visit through the gateway:
 > https://ipfs.io/ipfs/QmeMeqXPbcW6mdwMrZtZcmzntn7Di28LYxdFWj7SZchASp

Extra features

Keep in mind:

This template has been configured to produce a static output. This means you can deploy it directly to IPFS without needing a server. Make sure to generate your static site before deploying using pnpm run generate.

In order to make the routing compatible with IPFS, we've set the cdnURL to:

// nuxt.config.js

// https://nuxt.com/docs/api/configuration/nuxt-config
export default defineNuxtConfig({
  app: {
    cdnURL: "./",
  }
}

This ensures our site can be rendered when accessed from a public gateway. Please test this thoroughly.

πŸ‘€ Want to learn more?

Feel free to check Fleek Documentation & Nuxt Documentation.

Was this article helpful?

Comments

0 comments

Article is closed for comments.