{"id":14971019,"url":"https://github.com/kontent-ai/gatsby-packages","last_synced_at":"2025-08-19T22:32:39.168Z","repository":{"id":37472453,"uuid":"149598627","full_name":"kontent-ai/gatsby-packages","owner":"kontent-ai","description":"Monorepo with Gatsby Kontent packages.","archived":false,"fork":false,"pushed_at":"2023-11-16T19:29:49.000Z","size":20699,"stargazers_count":33,"open_issues_count":14,"forks_count":24,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-12-09T05:39:55.431Z","etag":null,"topics":["caas","delivery-api","gatsby","gatsby-plugin","gatsbyjs","hacktoberfest","headless-cms","kentico","kentico-kontent","kontent-ai","kontent-ai-sample","kontent-ai-tool","lerna-monorepo","monorepo","react-commponent","source-plugin"],"latest_commit_sha":null,"homepage":"https://www.gatsbyjs.org/plugins/?=%40kentico%2Fkontent-","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kontent-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-20T11:27:43.000Z","updated_at":"2024-05-02T14:12:36.000Z","dependencies_parsed_at":"2024-06-18T20:01:27.848Z","dependency_job_id":"bbc2c431-ea04-4725-a6e3-94edab0b5d69","html_url":"https://github.com/kontent-ai/gatsby-packages","commit_stats":{"total_commits":752,"total_committers":28,"mean_commits":"26.857142857142858","dds":0.6928191489361701,"last_synced_commit":"c98e8bee53b7f934cdea344a18ddeca92090bc63"},"previous_names":["kentico/gatsby-source-kontent","kentico/gatsby-source-kentico-cloud","kentico/kontent-gatsby-packages"],"tags_count":113,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fgatsby-packages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fgatsby-packages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fgatsby-packages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fgatsby-packages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kontent-ai","download_url":"https://codeload.github.com/kontent-ai/gatsby-packages/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230374126,"owners_count":18216042,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["caas","delivery-api","gatsby","gatsby-plugin","gatsbyjs","hacktoberfest","headless-cms","kentico","kentico-kontent","kontent-ai","kontent-ai-sample","kontent-ai-tool","lerna-monorepo","monorepo","react-commponent","source-plugin"],"created_at":"2024-09-24T13:44:30.706Z","updated_at":"2024-12-19T04:07:37.344Z","avatar_url":"https://github.com/kontent-ai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gatsby Kontent.ai Packages\n\n![build](https://github.com/kontent-ai/gatsby-packages/actions/workflows/build.yml/badge.svg)\n[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lerna.js.org/)\n\n[![Stack Overflow](https://img.shields.io/badge/Stack%20Overflow-ASK%20NOW-FE7A16.svg?logo=stackoverflow\u0026logoColor=white)](https://stackoverflow.com/tags/kontent-ai)\n[![Kontent.ai Discord](https://img.shields.io/discord/821885171984891914?color=%237289DA\u0026label=Kontent.ai%20Discord\u0026logo=discord)](https://discord.gg/SKCxwPtevJ)\n\nMonorepo with Gatsby Kontent.ai packages.\n\nThe repository contains the development site (`/site`) that could automatically load packages (`packages`) thanks to [npm workspaces](https://docs.npmjs.com/cli/using-npm/workspaces).\n\n## Content\n\n### Packages\n\n|                                 Package                                 | Summary                                                                         |                                                                        Version                                                                         |\n| :---------------------------------------------------------------------: | :------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------: |\n| [Gatsby Source Kontent.ai Plugin](/packages/gatsby-source#readme)  | plugin providing data from Kontent.ai REST API to Gatsby GraphQL model     |     [![npm version](https://badge.fury.io/js/@kontent-ai%2Fgatsby-source.svg)](https://badge.fury.io/js/@kontent-ai%2Fgatsby-source)     |\n| [Gatsby Kontent.ai Components](/packages/gatsby-components#readme) | package containing React components useful when processing Kontent.ai data to site | [![npm version](https://badge.fury.io/js/@kontent-ai%2Fgatsby-components.svg)](https://badge.fury.io/js/@kontent-ai%2Fgatsby-components) |\n\n### Site\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/6cd10788-de09-4275-b0c9-daad29733bc9/deploy-status)](https://app.netlify.com/sites/kontent-ai-gatsby-packages/deploys)\n\n- [Development Site](/site#readme) - Site using for development purposes and code examples showcasing packages possibilities\n\n### Examples\n\n#### Navigation showcase\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/5129d2e5-dc9f-4519-b18a-ad617e6225d5/deploy-status)](https://app.netlify.com/sites/kontent-ai-gatsby-example-navigation/deploys)\n\n- [Navigation showcase](/examples/navigation#readme) - Showcase including the navigation best practices. Description, how to do the content modeling with all benefits of the modular content as well as have tree-based menu structure.\n\n#### Resolution showcase\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/2f5f005f-1c66-4022-8c78-382f0a06a2a7/deploy-status)](https://app.netlify.com/sites/kontent-ai-gatsby-example-resolution/deploys)\n\n- [Resolution showcase](/examples/resolution#readme) - Demonstration how to resolve the Rich Text element and it's inline images, inline content items, and content components.\n\n#### Relationships showcase\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/27d162a0-612b-4d8f-8382-40eee4f6b5d9/deploy-status)](https://app.netlify.com/sites/kontent-ai-gatsby-example-relationships/deploys)\n\n- [Relationships showcase](/examples/relationships#readme) - Schema customization examples demonstrating relationship possibilities among Kontent.ai GraphQL nodes.\n\n#### DSG and SSR showcase\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/b71c750d-4c9f-4a8f-9484-bafa7c2ce019/deploy-status)](https://app.netlify.com/sites/kontent-ai-gatsby-example-dsg-ssr/deploys)\n\n- [DSG and SSR showcase](/examples/dsg-ssr#readme) - Example showcasing Deferred Static Generation and Server side Rendering features with Kontent.ai.\n\n## Development\n\n### Prerequisites\n\n- [Nodejs](https://nodejs.org/en/)\n\n### Install\n\n1. Install packages\n\n   ```sh\n   npm install # install all npm dependencies in the repository\n   ```\n\n2. Start watch mode packages\n\n   ```sh\n   npm run watch # run watch mode through all packages source code\n   ```\n\n3. Run development site\n\n   ```sh\n   npm run develop:site # run `gatsby develop` command in the development site\n   ```\n\nNow you are good to go. You could start browsing \u003chttp://localhost:8000\u003e for development site and \u003chttp://localhost:8000/___graphql\u003e for [GraphiQL explorer](https://github.com/graphql/graphiql/blob/master/packages/graphiql/README.md).\n\n### Tests\n\nTo run all tests, there is npm script prepared.\n\n```sh\nnpm run test # run test script in all packages as well as in the development site\n```\n\n- Packages are using [Jest](http://jest.org/) framework for testing.\n\n### Build\n\nTo build all of the packages as well as a development site, you could use one command.\n\n```sh\nnpm run build # run build script in all packages as well as in the development site\n```\n\n### Lint\n\nTo lint all of the packages as well as a development site, you could use one command.\n\n```sh\nnpm run lint # run lint script in all packages as well as in the development site\n```\n\n- Packages are using [ESLint](https://eslint.org/) with Typescript plugins for linting.\n\n## Publishing\n\nAs a publishing framework, there is a [Lerna](https://github.com/lerna/lerna) framework set up. This package is using [Fixed/Locked mode](https://github.com/lerna/lerna#fixedlocked-mode-default). All minor and major changes should publish all packages, in case of patch version, it is up to developer decision.\n\n### How to publish new version\n\nIf you have the rights to publish packages, just use [`lerna`](https://github.com/lerna/lerna/tree/master/commands/publish#readme) and specify the version when prompted. All the changes made by lerna are automatically committed.\n\nA typical scenario is when everything is ready and you want to publish the version, just use command.\n\n```sh\nnpx lerna publish --tag-version-prefix=''\n```\n\nThat should summarize the publish information and prompt you to define the version number and acknowledge the publish. Once everything is OK and you acknowledge the publish:\n\n- the new version is published to npm\n- `\u003cYOUR VERSION\u003e` is set to [`lerna.json`'s `version`](lerna.json)\n- commit with this change (and package.json files version changes) is pushed to the repository\n  - commit also contains tag `\u003cYOUR VERSION\u003e` that could be used for creating GitHub release if you want\n\n:bulb: If you want to test out the beta version first (which is recommended) use following command and if everything is OK, release another patch version as the final version.\n\n```sh\nnpx lerna publish --tag-version-prefix='' --dist-tag=beta\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkontent-ai%2Fgatsby-packages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkontent-ai%2Fgatsby-packages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkontent-ai%2Fgatsby-packages/lists"}