Repository files navigation

Gridsome is aVue-powered static site generator for building CDN-ready websites for any headless CMS, local files or APIs

This project is under active development. Any feedback or contributions would be appreciated.

Build websites with modern tools like Vue.js, webpack and Node.js. Get hot-reloading and access to any packages from npm and write CSS in your favorite preprocessor like Sass or Less with auto-prefixing.

Use any CMS or data source for content. Pull data from WordPress, Contentful, local Markdown, or any other headless CMS or APIs and access it with GraphQL in your pages and components.

Only critical HTML, CSS, and JavaScript get loaded first. The next pages are then prefetched so users can click around incredibly fast without page reloads, even when offline.

Gridsome automatically optimizes your frontend to load and perform blazing fast. You get code-splitting, image optimization, lazy-loading, and almost perfect lighthouse scores out-of-the-box.

The future of the web is JavaScript, API's, and Markup - theJamstack. Gridsome uses the power of blazing-fast static site generator, JavaScript and APIs to create stunning dynamic web experiences.

Gridsome sites are usually not connected to any database and can be hosted entirely on a global CDN. It can handle thousands to millions of hits without breaking - and no expensive server costs.

• npm install --global @gridsome/cli
• yarn global add @gridsome/cli
• pnpm install --global @gridsome/cli

1. gridsome create my-gridsome-site to create a new project
2. cd my-gridsome-site to open the folder
3. gridsome develop to start a local dev server athttp://localhost:8080
4. Happy coding 🎉🙌

1. Create.vue components in the./src/pages directory to create pages
2. Usegridsome build to generate static files in a./dist folder

• How it works
• How to deploy

InstallNode.js ^12.13.0 || ^14.0.0 || >=16.0.0 or higher andYarn classic.

1. Clone this repository.
2. Create a new Gridsome project inside the./projects folder.
3. Enter the new project folder and runyarn install.
4. The project will now use the local packages when you rungridsome develop.

Make sure your test project has a version number in itspackage.json if you use an existing project.

To use the local version of@gridsome/cli as the global command, enter the./packages/cli folder and runnpm link.

Yarn will add dependencies from your test projects to the rootyarn.lock file. So you should not commit changes in that file unless you have added dependencies to any of the core packages. If you need to commit it, remove your projects from the./projects folder temporary and runyarn install in the root folder. Yarn will then clean up the lock file with only necessary dependencies. Commit the file and move your projects back and runyarn install again to start developing.

In the interest of fostering an open and welcoming environment please read and follow ourCode of Conduct.

Licensed under theMIT License.

Visit theGridsome Roadmap to keep track of which features we are currently working on.