Skip to content

Nuxt module that exposes an elegant api for building headless Drupal sites (including static).

Notifications You must be signed in to change notification settings

wearebraid/nuxt-drupal-jsonapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nuxt Drupal JSON:API

⚠️ Update: In version 1.0.0-alpha.1 and later the extractor is removed from this project with the expectation you'll use Nuxt >= 2.14 which includes it's own extractor.

Nuxt Drupal JSON:API is a module for the Nuxt framework that allows for full static generation of a drupal site leveraging (primarily) the now core Drupal implementation of the JSON:API specification. We'll describe how it performs this magic later on, but for now what is important to understand is what problems this module solves.

Static generation of a dynamic content management system is quite challenging because the static generator needs to know every single route to generate. Furthermore, once those static pages have been created hydration of the data required for the front end to function properly typically requires the framework to make HTTP requests back to the original server when navigating to pages that are were not the initial page load.

This package solves these issues by downloading a static copy of every node and it's relationships to nuxt dist directory so when your site.

Live Mode

When viewing a Drupal site in live mode requests are made directly to the Drupal json:api and not a local static version. However, due to limitations of Drupal's json:api, the following modules must be enabled:

Configuration

To configure the nuxt module, provide the drupalUrl.

modules: [
  ['nuxt-drupal-jsonapi', {
    drupalUrl: 'https://example.drupal.org'
  }]
]

You can also pass an aliasPrefix option which will prefix every slug request to drupal with it's value, this is not typically needed.

About

Nuxt module that exposes an elegant api for building headless Drupal sites (including static).

Resources

Stars

Watchers

Forks

Packages

No packages published