Prologue

Introduction Core concepts Fast by default Deployment

Basic Gridsome

Directory structure Project configuration Pages Collections Templates Layouts Components Linking Dynamic Routing Image processing Populating <head> Environment Variables

Working with data

GraphQL data layer Importing data Querying data Filtering data Taxonomy pages Paginate data Global metadata Client-side data

Styles and Assets

Use CSS in Gridsome Add custom fonts Add external scripts Add SVG icons

Guides

Add a form Add a search * Add comments Add Netlify CMS Overriding index.html Overriding App.vue Page transitions body & html attributes

API Reference

Gridsome CLI Server API Data store API Schema API Pages API Client API Transformer API

Deploy

Netlify AWS Amplify ZEIT Now Amazon S3 GitLab Pages Github Pages Google Cloud Platform

Contribute

How to contribute How to create a plugin Code of conduct

Help

Prerequisites How to upgrade Troubleshooting Dev tools FAQ

Deployment

To deploy a Gridsome site you need a static web host.

Git-based deploying

The best practice when working with Gridsome sites is to have your project hosted on a Git-service like GitHub and connect a deploy service that builds your site from a selected repository.

These services are great for Git-based deploying:

Deploy from terminal

Many services let you deploy your static Gridsome site from the terminal. Here are some:

FTP deploying

To host your site on traditional hosting via FTP you need to manually build your project from the terminal.

  • Run gridsome build in your project folder.
  • This will generate a dist folder where your generated site is located.
  • Upload the content of this folder to any FTP to get started.

Drag & drop deploying

Netlify Drop lets you deploy a website with simply drag & drop.

  • Run gridsome build in your project folder.
  • This will generate a dist folder where your generated site is located.
  • Visit Netlify Drop and drop the dist folder there.

Edit this page on GitHub

On this page