{"id":13622836,"url":"https://github.com/TryGhost/gatsby-starter-ghost","last_synced_at":"2025-04-15T10:31:39.106Z","repository":{"id":34373341,"uuid":"157323155","full_name":"TryGhost/gatsby-starter-ghost","owner":"TryGhost","description":"A starter template to build lightning fast websites with Ghost \u0026 Gatsby","archived":false,"fork":false,"pushed_at":"2025-04-09T08:49:51.000Z","size":18135,"stargazers_count":1092,"open_issues_count":28,"forks_count":873,"subscribers_count":22,"default_branch":"main","last_synced_at":"2025-04-11T02:51:54.619Z","etag":null,"topics":["gatsby","gatsby-starter","gatsbyjs","ghost","netlify","react","static-site","static-site-generator"],"latest_commit_sha":null,"homepage":"https://gatsby.ghost.org","language":"JavaScript","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/TryGhost.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"tryghost","open_collective":"ghost"}},"created_at":"2018-11-13T05:04:05.000Z","updated_at":"2025-04-06T12:01:31.000Z","dependencies_parsed_at":"2023-12-22T13:37:30.197Z","dependency_job_id":"16cc2866-5d5a-4e38-b223-660e0e6df194","html_url":"https://github.com/TryGhost/gatsby-starter-ghost","commit_stats":{"total_commits":790,"total_committers":36,"mean_commits":"21.944444444444443","dds":0.6088607594936709,"last_synced_commit":"4a1f9618eb50ad83dc89854c53dd565af6fed55b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TryGhost%2Fgatsby-starter-ghost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TryGhost%2Fgatsby-starter-ghost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TryGhost%2Fgatsby-starter-ghost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TryGhost%2Fgatsby-starter-ghost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TryGhost","download_url":"https://codeload.github.com/TryGhost/gatsby-starter-ghost/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248894992,"owners_count":21179163,"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":["gatsby","gatsby-starter","gatsbyjs","ghost","netlify","react","static-site","static-site-generator"],"created_at":"2024-08-01T21:01:24.726Z","updated_at":"2025-04-15T10:31:39.100Z","avatar_url":"https://github.com/TryGhost.png","language":"JavaScript","funding_links":["https://github.com/sponsors/tryghost","https://opencollective.com/ghost"],"categories":["JavaScript","CMS Starters \u0026 Frameworks"],"sub_categories":[],"readme":"# Gatsby Starter Ghost\n\nA starter template to build lightning fast websites with [Ghost](https://ghost.org/) \u0026 [Gatsby](https://gatsbyjs.org)\n\n**Demo:** https://gatsby.ghost.org/\n\n\u0026nbsp;\n\n![gatsby-starter-ghost](https://user-images.githubusercontent.com/120485/50913567-8ab8e380-142c-11e9-9e78-de02ded12fc6.jpg)\n\n\u0026nbsp;\n\n\n# Installing\n\n```bash\n# With Gatsby CLI\ngatsby new gatsby-starter-ghost https://github.com/TryGhost/gatsby-starter-ghost.git\n```\n\n```bash\n# From Source\ngit clone https://github.com/TryGhost/gatsby-starter-ghost.git\ncd gatsby-starter-ghost\n```\n\nThen install dependencies\n\n```bash\nyarn\n```\n\n\u0026nbsp;\n\n# Running\n\nStart the development server. You now have a Gatsby site pulling content from headless Ghost.\n\n```bash\ngatsby develop\n```\n\nBy default, the starter will populate content from a default Ghost install located at https://gatsby.ghost.io.\n\nTo use your own install, you will need to edit the `.ghost.json` config file with your credentials. Change the `apiUrl` value to the URL of your Ghost site. For Ghost(Pro) customers, this is the Ghost URL ending in `.ghost.io`, and for people using the self-hosted version of Ghost, it's the same URL used to access your site.\n\nNext, update the `contentApiKey` value to a key associated with the Ghost site. A key can be provided by creating an integration within Ghost Admin. Navigate to Integrations and click \"Add new integration\". Name the integration appropriately and click create.\n\nFinally, configure your desired URL in `siteConfig.js`, so links (e. g. canonical links) are generated correctly. You can also update other default values, such as `postsPerPage` in this file.\n\nTo use this starter without issues, your Ghost installation needs to be at least on version `2.10.0`.\n\nThe default Ghost version that is used for this starter is `5.x`. If your Ghost installation is on a lower version, you will need to pass in a `version` property in your `.ghost.json` settings:\n\n**Ghost \u003e=2.10.0 \u003c5.0.0**\n```json\n{\n    \"apiUrl\": \"https://gatsby.ghost.io\",\n    \"contentApiKey\": \"9cc5c67c358edfdd81455149d0\",\n    \"version\": \"v4.0\"\n}\n```\n\n**Ghost \u003e=5.0.0**\n```json\n{\n    \"apiUrl\": \"https://gatsby.ghost.io\",\n    \"contentApiKey\": \"9cc5c67c358edfdd81455149d0\"\n}\n```\n\n\u0026nbsp;\n\n# Deploying with Netlify\n\nThe starter contains three config files specifically for deploying with Netlify. A `netlify.toml` file for build settings, a `/static/_headers` file with default security headers set for all routes, and `/static/_redirects` to set Netlify custom domain redirects.\n\nTo deploy to your Netlify account, hit the button below.\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/TryGhost/gatsby-starter-ghost)\n\nContent API Keys are generally not considered to be sensitive information, they exist so that they can be changed in the event of abuse; so most people commit it directly to their `.ghost.json` config file. If you prefer to keep this information out of your repository you can remove this config and set [Netlify ENV variables](https://www.netlify.com/docs/continuous-deployment/#build-environment-variables) for production builds instead.\n\nOnce deployed, you can set up a [Ghost + Netlify Integration](https://ghost.org/integrations/netlify/) to use deploy hooks from Ghost to trigger Netlify rebuilds. That way, any time data changes in Ghost, your site will rebuild on Netlify.\n\n\u0026nbsp;\n\n# Optimising\n\nYou can disable the default Ghost Handlebars Theme front-end by enabling the `Make this site private` flag within your Ghost settings. This enables password protection in front of the Ghost install and sets `\u003cmeta name=\"robots\" content=\"noindex\" /\u003e` so your Gatsby front-end becomes the source of truth for SEO.\n\n\u0026nbsp;\n\n# Extra options\n\n```bash\n# Run a production build, locally\ngatsby build\n\n# Serve a production build, locally\ngatsby serve\n```\n\nGatsby `develop` uses the `development` config in `.ghost.json` - while Gatsby `build` uses the `production` config.\n\n\u0026nbsp;\n\n# Copyright \u0026 License\n\nCopyright (c) 2013-2025 Ghost Foundation - Released under the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTryGhost%2Fgatsby-starter-ghost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTryGhost%2Fgatsby-starter-ghost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTryGhost%2Fgatsby-starter-ghost/lists"}