Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/eworx-org/drupal-js

Best practices to integrate a Drupal 8.x+ backend with a JavaScript framework frontend
https://github.com/eworx-org/drupal-js
List: drupal-js
awesome-list backend best-practices decoupled decoupled-drupal drupal drupal-8 drupal-9 frameworks hacktoberfest headless headless-cms javascript json-api nextjs react
Last synced: about 1 month ago
JSON representation
Best practices to integrate a Drupal 8.x+ backend with a JavaScript framework frontend
Host: GitHub
URL: https://github.com/eworx-org/drupal-js
Owner: eworx-org
License: mit
Created: 2022-02-10T17:28:10.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-03-26T16:22:45.000Z (6 months ago)
Last Synced: 2024-05-23T07:27:32.110Z (4 months ago)
Topics: awesome-list, backend, best-practices, decoupled, decoupled-drupal, drupal, drupal-8, drupal-9, frameworks, hacktoberfest, headless, headless-cms, javascript, json-api, nextjs, react
Homepage:
Size: 283 KB
Stars: 29
Watchers: 6
Forks: 7
Open Issues: 1
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project

ultimate-awesome - drupal-js - Best practices to integrate a Drupal 8.x+ backend with a JavaScript framework frontend. (Other Lists / PowerShell Lists)
README

        # Drupal decoupled backend with JS frontend

Best practices, basic steps, lists of tools and tips to help you integrate a Drupal 8.x+ backend with a JavaScript frontend.

_Note: Some examples below refer only to React development and are not JS agnostic. See also the [Start with React](start_with_react.md) short guide._

---

**Table of Contents**

- [JS](#js)

  - [Popular JS frontend frameworks](#popular-js-frontend-frameworks)

  - [Compare JS frameworks](#compare-js-frameworks)

  - [Things to consider when selecting a frontend framework (in no particular order)](#things-to-consider-when-selecting-a-frontend-framework-in-no-particular-order)

  - [Tools for JS development](#tools-for-js-development)

  - [JS terminology](#js-terminology)

  - [Learn JS frameworks basics](#learn-js-frameworks-basics)

  - [JS app structure](#js-app-structure)

  - [Styling a JS app](#styling-a-js-app)

- [Drupal](#drupal)

  - [About Drupal decoupled solutions](#about-drupal-decoupled-solutions)

  - [Drupal slack channels](#drupal-slack-channels)

  - [Drupal modules](#drupal-modules)

    - [JSON API (core)](#json-api-core)

    - [GraphQL](#graphql)

    - [Other](#other)

  - [Drupal Distributions](#drupal-distributions)

  - [Drupal starter-kits with JS frameworks](#drupal-starter-kits-with-js-frameworks)

  - [npm packages for Drupal](#npm-packages-for-drupal)

  - [Drupal common issues with decoupled](#drupal-common-issues-with-decoupled)

  - [Implementation matrix](#implementation-matrix)

- [Framework: React](#framework-react)

  - [Learn React](#learn-react)

  - [Drupal + React](#drupal--react)

  - [Articles for React](#articles-for-react)

- [Framework: NextJS](#framework-nextjs)

  - [Why choose NextJS](#why-choose-nextjs)

  - [Learn NextJS](#learn-nextjs)

  - [Drupal + NextJS](#drupal--nextjs)

  - [NextJS popular tools](#nextjs-popular-tools)

  - [Articles for NextJS](#articles-for-nextjs)

- [Framework: Nuxt.js](#framework-nuxtjs)

  - [Why choose Nuxt.js](#why-choose-nuxtjs)

  - [Drupal + Nuxt.js = Druxt](#drupal--nuxtjs--druxt)

  - [Druxt Quick-start templates](#druxt-quick-start-templates)

- [Final tips](#final-tips)

- [Similar resources](#similar-resources)

- [CONTRIBUTING](#contributing)

- [LICENSE](#license)

## JS

### Popular JS frontend frameworks

- [React](https://reactjs.org)

  - [Gatsby](https://www.gatsbyjs.com)

  - [Next](https://nextjs.org)

  - [Remix](https://remix.run)

  - [Blitz](https://blitzjs.com)

  - [Inferno](https://www.infernojs.org)

- [Angular](https://angular.io)

- [Vue](https://vuejs.org)

  - [Nuxt](https://nuxtjs.org) 

- [WebComponents](https://www.webcomponents.org) (not a pure JS solution)

### Compare JS frameworks

Online services to use when comparing frameworks (trends, popularity, usage, downloads, benchmarks etc).

- **Questionnaires**

  - https://2021.stateofjs.com/en-US/libraries/front-end-frameworks

  - https://www.jetbrains.com/lp/devecosystem-2021/javascript

  - https://insights.stackoverflow.com/survey/2021#section-most-popular-technologies-web-frameworks

- **Trends**

  - https://trends.google.com/trends/explore?cat=733&date=today%205-y&q=React,Vue,Angular,Next

  - https://insights.stackoverflow.com/trends?tags=reactjs%2Cvue.js%2Csvelte%2Cvuejs3%2Cangular

  - https://www.npmtrends.com/next-vs-react-vs-svelte-vs-vue

- **Popularity**

  - https://www.githubcompare.com/vercel/next.js+facebook/react+angular/angular.js+vuejs/vue

  - https://star-history.com/#facebook/react&vuejs/vue&angular/angular&vercel/next.js&Timeline

  - https://www.hntrends.com/2020/dec-year-unlike-any-other-tech-tools-didnt-change-much.html?compare=AngularJS&compare=Ember&compare=React&compare=Vue

  - https://frontpagemetrics.com/r/reactjs#compare=vuejs+angular2+sveltejs+nextjs

- **Usage**

  - https://trends.builtwith.com/javascript/javascript-library

  - https://www.wappalyzer.com/technologies/javascript-libraries/react/

  - https://www.datanyze.com/market-share/frameworks-and-libraries--66/react-market-share

  - https://www.similartech.com/technologies/react-js

- **Analysis & dependencies**

  - https://npmgraph.js.org

  - https://bundlephobia.com

  - https://packagephobia.com

- **Benchmarks**

  - https://krausest.github.io/js-framework-benchmark

- **Browser Support**

  - https://kangax.github.io/compat-table/es6

  - https://caniuse.com

### Things to consider when selecting a frontend framework (in no particular order)

- Performance

- Stability

- Development experience

- Documentation and support

- Vendors behind

- Complexity and learning curve

- CRUD requirements

- Serving multiple platforms and consumers

- Existing in-house knowledge

### Tools for JS development

Note: Before using these tools try to use the built-in, bundled tools you get from each framework.

- [VSCode](https://code.visualstudio.com)

- [nvm](https://github.com/nvm-sh/nvm), [npm](https://www.npmjs.com) (no need to use `yarn` over `npm` in 2022)

- [Typescript](https://www.typescriptlang.org)

- [Storybook](https://storybook.js.org)

- [Babel](https://babeljs.io)

- [PostCSS](https://postcss.org)

- [husky](https://github.com/typicode/husky)

- [JSX](https://reactjs.org/docs/introducing-jsx.html)

- [JSON](https://www.json.org/json-en.html), [JSON API](https://jsonapi.org)

- Bundlers: [Webpack](https://webpack.js.org), [esbuild](https://esbuild.github.io)

- Code linting etc: [EditorConfig](http://editorconfig.org), [ESLint](https://eslint.org), [Prettier](https://prettier.io), [JSLint](https://www.jslint.com)

- Code generators: [Hygen](https://www.hygen.io), [nx](https://nx.dev), [ReexJs CLI](https://codingcodax.github.io/reexjs-cli), [generact](https://github.com/diegohaz/generact)

- Testing: [Jest](https://jestjs.io), [Cypress](https://cypress.io), [testing-library](https://testing-library.com), [nightwatchjs](https://nightwatchjs.org), [playwright](https://playwright.dev)

- Data fetch: [axios](https://axios-http.com), [react-query](https://react-query.tanstack.com), [SWR](https://swr.vercel.app), [node-fetch](https://www.npmjs.com/package/node-fetch)

- Data parser: [qs](https://www.npmjs.com/package/qs), [html-react-parser](https://github.com/remarkablemark/html-react-parser)

- Routing: [React Router](https://reactrouter.com), [TanStack Router](https://tanstack.com/router)

- Quality:  [danger](https://www.npmjs.com/package/danger)

- Logging: [pino](https://getpino.io)

- Documentation: [jsdoc](https://www.npmjs.com/package/jsdoc)

- Performance: [next-boost](https://github.com/next-boost/next-boost), [react-lazy-load-image-component](https://www.npmjs.com/package/react-lazy-load-image-component), [node-cache](https://www.npmjs.com/package/node-cache), [webpack-bundle-analyzer](https://www.npmjs.com/package/webpack-bundle-analyzer)

- Security: (npm built-in: `npm-audit, npm-outdated, npm-doctor` [npm-check](https://www.npmjs.com/package/npm-check), [snyk](https://snyk.io), [npm-check-updates](https://www.npmjs.com/package/npm-check-updates)

- State management: [redux](https://redux.js.org), [zustand](https://github.com/pmndrs/zustand), [recoil](https://recoiljs.org), [jotai](https://jotai.org)

- Translations, i18n: [lingui](https://github.com/lingui/js-lingui), [polyglot](https://www.npmjs.com/package/node-polyglot)

- Mocks, faker: [sinon](https://sinonjs.org), [faker](https://fakerjs.dev), [JSON Server fake API](https://www.npmjs.com/package/json-server)

### JS terminology

In order to start with JS you sould be familiar with the basic terms below. Note that some of them may refer to a specific JS framework.

- CORS

- Cache

- Code splitting

- Components

- Composition

- DOM

- Data fetch

- HMR (Hot Module Reload)

- HOC (Higher Order Components)

- Hook events

- Injection

- Invalidation

- Isomorphic

- PWA

- Props

- Routing

- SEO

- [SSR](https://vuejs.org/guide/scaling-up/ssr.html), [SSG](https://blog.logrocket.com/ssg-vs-ssr-in-next-js), [ISR](https://blog.logrocket.com/incremental-static-regeneration-with-next-js), [DSG](https://www.gatsbyjs.com/docs/how-to/rendering-options/using-deferred-static-generation), [CSR](https://frontend-digest.com/client-side-rendering-vs-server-side-rendering-vs-static-site-generation-2a0702cbb08d)

- SWA

- SideEffect

- State

- Web Vitals (LCP, FID, CLS)

- a11y

- es6/es7 etc

- hydration

- i18n

- library

- module

- node daemon

- package

- virtual DOM

### Learn JS frameworks basics

- https://github.com/sorrycc/awesome-javascript

- https://www.patterns.dev

### JS app structure

- [Move files around until it feels right](https://react-file-structure.surge.sh/)

- Group by file type

- Avoid too much nesting

- Keep with the trends (e.g. use common names like "`src, public, pages, __tests__, docs`" etc

```

ToDo: Add some example structure here..

```

Sources: [1](https://gist.github.com/literat/4f7c8a4a9b9d113886df77fa34228623), [2](https://hackernoon.com/react-project-structure-best-practices-kh20323x), [3](https://blog.usejournal.com/folder-structure-in-react-apps-c2ae8974d21f), [4](https://hackernoon.com/structuring-projects-and-naming-components-in-react-1261b6e18d76), [5](https://reactjs.org/docs/faq-structure.html)

### Styling a JS app

- Prefer "CSS in files" approach except if there are specific requirements.

- For inline styles you can use utility CSS libraries like [tailwindcss](https://tailwindcss.com) and [Windi CSS](https://windicss.org).

- For UI building isolation and sandboxing use [Storybook](https://storybook.js.org), [React Styleguidist](https://react-styleguidist.js.org), [React Cosmos](https://reactcosmos.org), [React Preview](https://reactpreview.com) etc.

---

## Drupal

### About Drupal decoupled solutions

- https://www.drupal.org/docs/develop/decoupled-drupal

- [Drupal core ideas: Drupal JavaScript Client Initiative](https://www.drupal.org/node/3277222)

- https://dri.es/headless-cms-rest-vs-jsonapi-vs-graphql

- https://dri.es/how-to-decouple-drupal-in-2019

- https://dri.es/drupal-looking-to-adopt-react

- https://dri.es/advancing-drupal-web-services

- https://www.drupal.org/industries/decoupled

- https://www.lullabot.com/articles/should-you-decouple

- https://www.softescu.com/en/blog/fully-decoupled-or-progressively-decoupled

- https://medium.com/analytics-vidhya/decoupled-drupal-as-a-solution-bd0ec25f39cf

- https://opensenselabs.com/blog/articles/different-options-decoupling-drupal

- https://www.lullabot.com/articles/decoupled-hard-problems-routing

- https://noti.st/brianperry/2Fvgeu/drupal-state-and-the-need-for-a-javascript-sdk

- [My Headless/Decoupled CMS Comparison Matrix, 2017, krynsky.com](https://krynsky.com/my-headless-decoupled-content-management-software-and-services-comparison-matrix)

### Drupal slack channels

- [#decoupled](https://app.slack.com/client/T06GX3JTS/C1AKSFBEW)

- [#headless](https://app.slack.com/client/T06GX3JTS/C8ZK4VDMW)

- [#graphql](https://app.slack.com/client/T06GX3JTS/C6LMJ0ZAT)

- [#contenta](https://app.slack.com/client/T06GX3JTS/C5A70F7D1)

- [#react](https://app.slack.com/client/T06GX3JTS/CUW94TUBX)

- [#nextjs](https://app.slack.com/client/T06GX3JTS/C01E36BMU72)

- [#gatsby](https://app.slack.com/client/T06GX3JTS/CDQC1MDU6)

- [#druxt (NuxtJS)](https://app.slack.com/client/T06GX3JTS/C01ALFZ8459)

- [#vue](https://app.slack.com/client/T06GX3JTS/C9SR65F6K)

- [#custom-elements](https://app.slack.com/client/T06GX3JTS/C01G23CS86Q)

- [#api-client](https://app.slack.com/client/T06GX3JTS/C05BP6659U0)

### Drupal modules

Note: Modules in emphasis are the most used across the Drupal universe.

#### JSON API (core)

[jsonapi.org](https://jsonapi.org), [JSON API: Drupal core module documentation](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module), [Ecosystem modules for JSON:API](https://www.drupal.org/project/jsonapi/ecosystem)

- **Basic**

  - **[decoupled_kit](https://drupal.org/project/decoupled_kit)**

  - **[decoupled_menus](https://drupal.org/project/decoupled_menus)**

  - **[drupal_jsonapi_params](https://drupal.org/project/drupal_jsonapi_params)**

  - [entity_view_mode_normalize](https://drupal.org/project/entity_view_mode_normalize)

  - [fieldable_path](https://drupal.org/project/fieldable_path)

  - [jsonapi_aliases](https://drupal.org/project/jsonapi_aliases)

  - [jsonapi_comment](https://drupal.org/project/jsonapi_comment)

  - [jsonapi_embed](https://drupal.org/project/jsonapi_embed)

  - **[jsonapi_extras](https://drupal.org/project/jsonapi_extras)**

  - **[jsonapi_menu_items](https://drupal.org/project/jsonapi_menu_items)**

  - **[jsonapi_views](https://drupal.org/project/jsonapi_views)**

  - [jsonapi_pathauto_breadcrumbs](https://www.drupal.org/project/jsonapi_pathauto_breadcrumbs)

  - [jsonrpc](https://drupal.org/project/jsonrpc)

  - [pager_serializer](https://drupal.org/project/pager_serializer)

  - [rest_absolute_urls](https://drupal.org/project/rest_absolute_urls)

  - [rest_menu_detail](https://drupal.org/project/rest_menu_detail)

  - [rest_menu_items](https://drupal.org/project/rest_menu_items)

  - [rest_normalizer](https://drupal.org/project/rest_normalizer)

  - [jsonapi_hypermedia](https://www.drupal.org/project/jsonapi_hypermedia)

  - [jsonapi_bulk_exclude](https://www.drupal.org/project/jsonapi_bulk_exclude)

  - [jsonapi_example](https://www.drupal.org/project/jsonapi_example)

  - [transform_api](https://www.drupal.org/project/transform_api)

  - [contextual_aliases](https://github.com/pmelab/contextual_aliases)

- **Data**

  - [config_pages](https://drupal.org/project/config_pages) 

- **Subrequests, nesting**

  - [jsonapi_include](https://drupal.org/project/jsonapi_include)

  - [rest_entity_recursive](https://drupal.org/project/rest_entity_recursive)

  - [rest_export_nested](https://drupal.org/project/rest_export_nested)

  - **[subrequests](https://drupal.org/project/subrequests)**

- **Routing**

  - **[decoupled_router](https://drupal.org/project/decoupled_router)**

  - [entity_router](https://drupal.org/project/entity_router)

- **Collections**

  - [jsonapi_cross_bundles](https://drupal.org/project/jsonapi_cross_bundles)

  - [decoupled_pages](https://drupal.org/project/decoupled_pages)

  - [jsonapi_resources](https://drupal.org/project/jsonapi_resources)

  - [jsonapi_field_formatter](https://www.drupal.org/project/jsonapi_field_formatter)

  - [page_manager](https://drupal.org/project/page_manager)

  - [jsonapi_user_resources](https://drupal.org/project/jsonapi_user_resources)

- **Search**

  - **[jsonapi_search_api](https://www.drupal.org/project/jsonapi_search_api)**

- **Preview**

  - **[decoupled_preview](https://www.drupal.org/project/decoupled_preview)**

  - **[dpl](https://drupal.org/project/dpl)**

  - **[jsonapi_node_preview](https://drupal.org/project/jsonapi_node_preview)**

  - **[jsonapi_node_preview_tab](https://drupal.org/project/jsonapi_node_preview_tab)**

- **Performance**

  - [jsonapi_earlyrendering_workaround](https://drupal.org/project/jsonapi_earlyrendering_workaround)

  - **[jsonapi_boost](https://drupal.org/project/jsonapi_boost)**

  - **[warmer](https://drupal.org/project/warmer)**

- **Images/Files**

  - **[jsonapi_image_styles](https://drupal.org/project/jsonapi_image_styles)**

  - **[consumer_image_styles](https://drupal.org/project/consumer_image_styles)**

  - [image_derivatives_selection](https://drupal.org/project/image_derivatives_selection)

  - [image_derivatives_base64_representation](https://drupal.org/project/image_derivatives_base64_representation)

  - [filefield_sources_jsonapi](https://www.drupal.org/project/filefield_sources_jsonapi)

  - [jsonapi_flysystem_uploader](https://www.drupal.org/project/jsonapi_flysystem_uploader)

  - [nplowman/jsonapi-reusable-images](https://github.com/nplowman/jsonapi-reusable-images)

- **Rate limits**

  - [rate_limiter](https://drupal.org/project/rate_limiter)

  - **[rate_limits](https://drupal.org/project/rate_limits)**

- **API Documentation**

  - [schemata](https://drupal.org/project/schemata)

  - [openapi_ui_swagger](https://drupal.org/project/openapi_ui_swagger)

  - **[openapi](https://drupal.org/project/openapi)**

  - [openapi_ui](https://drupal.org/project/openapi_ui)

  - **[openapi_jsonapi](https://drupal.org/project/openapi_jsonapi)**

  - [openapi_rest](https://drupal.org/project/openapi_rest)

  - **[openapi_ui_redoc](https://drupal.org/project/openapi_ui_redoc)**

  - [swagger_ui_formatter](https://drupal.org/project/swagger_ui_formatter)

  - [jsonapi_schema](https://drupal.org/project/jsonapi_schema)

  - [social_json_api](https://drupal.org/project/social_json_api)

- **Authentication**

  - [api_proxy](https://drupal.org/project/api_proxy)

  - **[simple_oauth](https://drupal.org/project/simple_oauth)**

  - **[consumers](https://drupal.org/project/consumers)**

  - **[cors_ui](https://drupal.org/project/cors_ui)**

  - [rest_api_authentication](https://drupal.org/project/rest_api_authentication)

  - [key_auth](https://drupal.org/project/key_auth)

  - [api_key_manager](https://drupal.org/project/api_key_manager)

  - [access_filter](https://drupal.org/project/access_filter)

  - [jsonapi_access](https://drupal.org/project/jsonapi_access)

  - [rest_password](https://drupal.org/project/rest_password)

  - [jsonapi_role_access](https://drupal.org/project/jsonapi_role_access)

  - [simonbaese/consumer_permissions](https://github.com/simonbaese/consumer_permissions)

- **Administration**

  - **[restui](https://drupal.org/project/restui)**

  - [jsonapi_explorer](https://drupal.org/project/jsonapi_explorer)

  - [jsonapi_node_preview_tab](https://drupal.org/project/jsonapi_node_preview_tab)

  - [restuiextention](https://drupal.org/project/restuiextention)

  - [api_proxy](https://drupal.org/project/api_proxy)

  - [decoupled_toolbox](https://drupal.org/project/decoupled_toolbox)

- **Forms**

  - **[webform_rest](https://drupal.org/project/webform_rest)**

  - [webform_jsonschema](https://drupal.org/project/webform_jsonschema)

  - [rjsf](https://drupal.org/project/rjsf)

  - [next_webform](https://www.drupal.org/project/next_webform)

- **Logging**

  - **[http_client_log](https://drupal.org/project/http_client_log)**

  - [request_logger](https://drupal.org/project/request_logger)

  - [rest_log](https://drupal.org/project/rest_log)

  - [restfullogger](https://drupal.org/project/restfullogger)

- **Translations**

  - [decoupled_interface_translations](https://www.drupal.org/project/decoupled_interface_translations)

#### GraphQL

- **[graphql](https://drupal.org/project/graphql)**

- [graphql_compose](https://www.drupal.org/project/graphql_compose)

- [graphql_directives](https://github.com/AmazeeLabs/graphql_directives)

- [graphql_entity_by_object](https://drupal.org/project/graphql_entity_by_object)

- [graphql_entity_definitions](https://drupal.org/project/graphql_entity_definitions)

- [graphql_extras](https://drupal.org/project/graphql_extras)

- [graphql_formatters](https://drupal.org/project/graphql_formatters)

- [graphql_menu](https://drupal.org/project/graphql_menu)

- [graphql_metatag](https://drupal.org/project/graphql_metatag)

- [graphql_node_preview](https://drupal.org/project/graphql_node_preview)

- [graphql_redirect](https://drupal.org/project/graphql_redirect)

- [graphql_redirect_entity](https://drupal.org/project/graphql_redirect_entity)

- [graphql_search_api](https://drupal.org/project/graphql_search_api)

- [graphql_views](https://drupal.org/project/graphql_views)

- [graphql_webform](https://drupal.org/project/graphql_webform)

- [preview_graphql](https://drupal.org/project/preview_graphql)

#### Other

- [api_client](https://www.drupal.org/project/api_client)

- [services](https://www.drupal.org/project/services)

- [pdb](https://drupal.org/project/pdb)

- **[relaxed](https://drupal.org/project/relaxed)**

- [jdrupal](https://drupal.org/project/jdrupal)

- [js_component](https://drupal.org/project/js_component)

- [gdwc](https://www.drupal.org/project/gdwc)

- [api_toolkit](https://www.drupal.org/project/api_toolkit)

- [decoupled](https://www.drupal.org/project/decoupled)

### Drupal Distributions

- https://www.contentacms.org

- https://www.drupal.org/project/tide

- https://github.com/systemseed/falcon

- https://github.com/codingsasi/acephalous

- https://www.drupal.org/project/ezcontent (using REST, not a decoupled example)

### Drupal starter-kits with JS frameworks

- https://next-drupal.org (Next)

- https://druxtjs.org (Nuxt)

- https://stack.lupus.digital (Nuxt)

- https://github.com/acquia/next-acms (Next)

- https://github.com/octahedroid/drupal-remix (Remix)

- https://github.com/rbeach/drupal-remix (Remix example)

### npm packages for Drupal

- [d8-jsonapi-querystring](https://www.npmjs.com/package/d8-jsonapi-querystring)

- [d8-subrequests](https://www.npmjs.com/package/d8-subrequests)

- [drupal-jsonapi-extractor](https://www.npmjs.com/package/drupal-jsonapi-extractor)

- [drupal-jsonapi-params](https://www.npmjs.com/package/drupal-jsonapi-params)

- [drupal-sdk](https://www.npmjs.com/package/drupal-sdk)

- [drupal-state](https://www.npmjs.com/package/@gdwc/drupal-state) (see docs at [drupalcode.org/drupal_state](https://project.pages.drupalcode.org/drupal_state)

- [jsonapi-parse](https://www.npmjs.com/package/jsonapi-parse)

- [react-drupal-json-api](https://www.npmjs.com/package/react-drupal-json-api)

- [drupal-kit](https://www.npmjs.com/package/@pantheon-systems/drupal-kit)

- [drupal-js-sdk](https://www.npmjs.com/package/drupal-js-sdk)

### Drupal common issues with decoupled

- Displaying embedded entities on CKEditor (eg Media) inside JS components

- Multilingual

- Subrequets and relationships in data

- Customizing of responses like filtering, quering and altering

- Routing and path aliases

- Non entities data (e.g. metatags, redirects, path aliases, image styles)

- Workflows (Content Moderation) and revisions

- Node preview

- Authentication

- Invalidate partial cache

- Forms

### Implementation matrix

An **example matrix for common requirements** of a decoupled Drupal backend with JS frontend. 

The table show which part of the app should take care of each functionality. 

For example, we could get the site logo from Drupal but we could also use a static image on the JS side as a logo.

Notice that, in some cases, there may be a combination of the two parts or a 3rd party solution (eg an external CDN for image assets).

| Requirement | Drupal backend | JS frontend |

| --- | :---: | :---: | 

| access and permissions | ⬜ |⬜|

| authentication | ⬜ | ⬜ |

| basic site settings (eg logo, site name, site slogan etc) | ⬜ | ⬜ |

| breadcrumbs | ⬜ | ⬜ |

| caching | ⬜ | ⬜ |

| collections (views VS JSON API entity queries) | ⬜ | ⬜ |

| CORS | ⬜ | ⬜ |

| CRUD requirements | ⬜ | ⬜ |

| embedded HTML on CKEditor | ⬜ | ⬜ |

| file attachments | ⬜ | ⬜ |

| forms | ⬜ | ⬜ |

| image styles | ⬜ | ⬜ |

| menus | ⬜ | ⬜ |

| metatags | ⬜ | ⬜ |

| mocking data | ⬜ | ⬜ |

| modifying JSON response | ⬜ | ⬜ |

| multilingual | ⬜ | ⬜ |

| multisite | ⬜ | ⬜ |

| partial cache invalidation | ⬜ | ⬜ |

| path aliases | ⬜ | ⬜ |

| preview | ⬜ | ⬜ |

| redirects | ⬜ | ⬜ |

| relationships and field references | ⬜ | ⬜ |

| revisions | ⬜ | ⬜ |

| routing | ⬜ | ⬜ |

| search_api | ⬜ | ⬜ |

| sub-requests | ⬜ | ⬜ |

| third party scripts (eg gtag) | ⬜ | ⬜ |

| UI translations | ⬜ | ⬜ |

| workflows (content moderation) | ⬜ | ⬜ |

| xml sitemap | ⬜ | ⬜ |

---

## Framework: React

- https://reactjs.org

- https://github.com/enaqx/awesome-react

- https://github.com/brillout/awesome-react-components

### Learn React

- [Thinking in React - reactjs.org](https://reactjs.org/docs/thinking-in-react.html)

- [Complete guide React + Drupal - drupalize.me](https://drupalize.me/series/drupal-8-and-reactjs)

- [React in patterns](https://krasimir.gitbooks.io/react-in-patterns)

- [30 Days of React - GitHub](https://github.com/Asabeneh/30-Days-Of-React)

- [Functional Components](https://programmingwithmosh.com/react/react-functional-components)

- React Components: https://reactjs.org/docs/react-component.html, https://github.com/brillout/awesome-react-components

- React Hooks: https://reactjs.org/docs/hooks-intro.html, https://usehooks.com

- React Props: https://akd3257.medium.com/what-are-props-in-react-2f822330e3a7

### Drupal + React

- Guide: https://reactfordrupal.com

- Starter: https://github.com/systemseed/drupal_reactjs_boilerplate

- Example: https://github.com/DrupalizeMe/react-and-drupal-examples

### Articles for React

- https://www.smashingmagazine.com/2021/11/maintain-large-nextjs-application

---

## Framework: NextJS

- https://nextjs.org

- https://github.com/unicodeveloper/awesome-nextjs

### Why choose NextJS

- Better SEO. Supports SSR, SSG, ISR.

- Built in solutions for common requirements (routing, head/metatags, images, links, font optimization, data fetching, injected scripts, i18n, AMP)

- Built in tools (Typescript, Sass, ESLint, Webpack, env variables, preview mode, polyfills)

- Better Development Experience (DX) (zero config, built in tools, fast refresh)

- Based on React (can use all the React goodies)

### Learn NextJS

- [nextjs.org/learn/basics/create-nextjs-app](https://nextjs.org/learn/basics/create-nextjs-app)

- [nextjstips.com](https://nextjstips.com)

### Drupal + NextJS

- [next-drupal.org](https://next-drupal.org)

- [TallerWebSolutions/next-on-drupal](https://github.com/TallerWebSolutions/next-on-drupal)

- [About Drupal, Gatsby and Next](https://gist.github.com/colorfield/22b1a451d90b2a159c7d3d679197812f)

- [Next.js and Headless CMS - GitHub issue](https://github.com/vercel/next.js/discussions/33087)

### NextJS popular tools

- https://swr.vercel.app (React Hooks for Data Fetching)

- https://next-auth.js.org (Authentication for Next.js)

- https://github.com/atilafassina/next-g11n (Translate and localize your Next.js app smoothly)

- https://github.com/next-boost/next-boost (Adds a cache layer to your SSR applications)

### Articles for NextJS

- https://www.smashingmagazine.com/2021/11/maintain-large-nextjs-application

- https://stackabuse.com/guide-to-getting-started-with-nextjs-create-a-nextjs-app

---

## Framework: Nuxt.js

- https://druxtjs.org

- https://nuxtjs.org

- https://github.com/nuxt-community/awesome-nuxt

### Why choose Nuxt.js

- Better SEO. Suppports SSR and SSG.

- Built in solutions for common requirements (routing, head/metatags, images, links, font optimization, data fetching, injected scripts, i18n, AMP)

- Built in tools (Typescript, Sass, ESLint, Webpack, env variables, preview mode, polyfills)

- Better Development Experience (DX) (zero config, built in tools, fast refresh)

- Based on Vue (can use all the Vue goodies)

### Drupal + Nuxt.js = Druxt

> Druxt = DRUpal + nuXT

- [druxtjs.org](https://druxtjs.org)

- Fully Decoupled Drupal, with Nuxt.js in the frontend.

- Drupal JSON:API Client with Vuex caching.

- Modular Vue.js component library system.

- Slot and Wrapper theming system.

- API and File proxy.

### Druxt Quick-start templates

- [DruxtSite](https://github.com/druxt/quickstart-druxt-site)

- [DruxtSite w/tome sync](https://github.com/druxt/quickstart-druxt-site-tome)

- [Serverless Druxt](https://github.com/druxt/quickstart-druxt-serverless)

- [DruxtModule (template)](https://github.com/druxt/module-template)

---

## Final tips

- Make it really "decoupled" (except if other requirements)

- Keep it simple. Use the basic tools and extend when needed.

- Less JS packages and less Drupal modules is prefferable.

- Work only with NodeJS LTS versions.

- Think in Components

- Create enough Components

- Modify the state directly

- Add keys on the lists (inside JS Components)

- Declare types, validate functions

- Always test your Components and app

- Dockerize your JS app

- For security updates of npm packages prefer to update the main JS library used (eg Next, React etc) and not the several npm packages independently.

- Drupal: Prefer Drupal modules from core (e.g. JSON API instead of GraphQL)

- Drupal: Do not override the default Drupal field machine names on JSON

- Drupal: prefer quering the `search_api` to get search results on the JS App when using 3rd party search engines like SOLR.

- Start with the official starter kits (e.g [create-react-app](https://create-react-app.dev/))

---

## Similar resources

- [d34dman/awesome-drupal-jsonapi](https://github.com/d34dman/awesome-drupal-jsonapi)

---

## CONTRIBUTING

[Contribution guide](CONTRIBUTING.md)

---

## LICENSE

[MIT](LICENSE) - Copyright (c) 2022 [EWORX S.A.](https://github.com/eworx-org)