{"id":21508074,"url":"https://github.com/anarion80/astro-ghost-simply","last_synced_at":"2025-04-23T23:07:39.823Z","repository":{"id":160467586,"uuid":"634833110","full_name":"anarion80/astro-ghost-simply","owner":"anarion80","description":"A beautiful Astro theme for headless Ghost CMS sites, based on Ghost Simply theme","archived":false,"fork":false,"pushed_at":"2024-04-11T07:45:17.000Z","size":1354,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T23:07:04.066Z","etag":null,"topics":["astro","cms","ghost","headless","headless-cms","theme"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anarion80.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}},"created_at":"2023-05-01T10:16:48.000Z","updated_at":"2025-04-23T13:18:16.000Z","dependencies_parsed_at":"2024-02-01T21:57:08.501Z","dependency_job_id":"d7f3fcb3-4d36-49cb-9501-fa796a66dbc8","html_url":"https://github.com/anarion80/astro-ghost-simply","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anarion80%2Fastro-ghost-simply","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anarion80%2Fastro-ghost-simply/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anarion80%2Fastro-ghost-simply/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anarion80%2Fastro-ghost-simply/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anarion80","download_url":"https://codeload.github.com/anarion80/astro-ghost-simply/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250528731,"owners_count":21445516,"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":["astro","cms","ghost","headless","headless-cms","theme"],"created_at":"2024-11-23T20:45:35.775Z","updated_at":"2025-04-23T23:07:39.802Z","avatar_url":"https://github.com/anarion80.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Astro Starter Ghost with Simply Theme\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/eb5fb344-5cf0-4bbe-9a7d-1a5494684357/deploy-status)](https://app.netlify.com/sites/curious-cobbler-55f37b/deploys)\n\nA starter template to build lightning fast websites with [Ghost](https://ghost.org) (as headless CMS in this case) \u0026 [Astro](https://astro.build), using the excellent [Simply Ghost Theme](https://github.com/godofredoninja/simply).\nRewritten from Handlebars theme to Astro/React.\n\n**Demo:** [https://astro-ghost-simply.netlify.app/](https://astro-ghost-simply.netlify.app/)\n\n\u0026nbsp;\n\n![astro-ghost-simply](https://user-images.githubusercontent.com/2185791/133974213-7f41e2e5-427d-4a0b-8024-e0d2ac3c4dd0.png)\n\u0026nbsp;\n\n## 🚀 What is working\n\n- Basic posts\n- Related Articles\n- Social share buttons support for posts\n- Previous and next Post\n- Different Home Page variants and Post formats\n  - Post Format (:warning: use internal tags and not `custom_template` field!)\n    - [Post Default](https://godofredo.ninja/ghost-theme/simply/post-format/#post-default)\n    - [Post Full](https://godofredo.ninja/ghost-theme/simply/post-format/#post-full)\n    - [Post Wide](https://godofredo.ninja/ghost-theme/simply/post-format/#post-wide)\n    - [Post Header Image](https://godofredo.ninja/ghost-theme/simply/post-format/#post-header-image)\n    - [Post Image](https://godofredo.ninja/ghost-theme/simply/post-format/#post-image)\n    - [Post Image Right](https://godofredo.ninja/ghost-theme/simply/post-format/#post-image-right)\n    - [Post Sidebar](https://godofredo.ninja/ghost-theme/simply/post-format/#post-sidebar)\n    - [Post not Image](https://godofredo.ninja/ghost-theme/simply/post-format/#post-not-image)\n  - [Layouts Header](https://godofredo.ninja/ghost-theme/simply/layouts/#header)\n    - Header Default\n    - [Header with DropDown Menu](https://godofredo.ninja/ghost-theme/simply/layouts/#headerdefault)\n  - [Layouts Footer](https://godofredo.ninja/ghost-theme/simply/layouts/#footer)\n    - Footer Default\n    - Footer Dark\n    - Footer Not Menu Secondary\n- Responsive Video\n  - YouTube\n  - Vimeo\n  - kickstarter\n  - Dailymotion\n- New Ghost cards (GIF, buttons, NFT, callouts, toggles, quotes, products, audio, video, files, headers)\n- Archive (:warning: use internal tags and not `custom_template` field!)\n  - [Authors Page](https://godofredo.ninja/ghost-theme/simply/authors-and-tags-page/#authors-page)\n  - [Tags Page](https://godofredo.ninja/ghost-theme/simply/authors-and-tags-page/#tags-page)\n- Page\n  - 404\n  - [Contact](https://godofredo.ninja/ghost-theme/simply/contact-page/) (:warning: use internal tags and not `custom_template` field!)\n  - [Podcasts Page](https://godofredo.ninja/ghost-theme/simply/podcasts-page/) (:warning: no need to create the page, just use internal tags on the post)\n  - [Portfolio Page](https://godofredo.ninja/ghost-theme/simply/portfolio-page/) (:warning: no need to create the page, just use internal tags on the post)\n  - [Kusi Doc](https://godofredo.ninja/ghost-theme/simply/kusi-doc/) for the documentation of your project (:warning: use internal tags and not `custom_template` field!)\n- Hamburger navigation menu\n- Header Transparency\n- Support for [different Languages](https://godofredo.ninja/ghost-theme/simply/languages)\n- [Social accounts link](https://godofredo.ninja/ghost-theme/simply/settings/#socialmedia)\n- Lazy Loading for feature-images\n- Light Mode / Dark Mode\n- Fast search functionality\n- Medium style image zoom\n- Resize Image Galleries\n- [PrismJS syntax highlighting](https://prismjs.com/index.html#supported-languages) - basic only\n- [GDPR Cookie Consent](https://github.com/jop-software/astro-cookieconsent)\n\n## ❌ What is not yet working\n\n- Members subscribing via email\n- Pagination Infinite Scroll - not for static sites\n- Comments\n- All Membership features\n\n## ✏ What could be improved\n\n- Move videoResponsive and resizeImageGalleries to build time using some rehype plugin\n- Convert this from a starter to a proper theme\n\n## 🏗 Installing\n\nThe easiest way to run this project locally is to run the following command in your desired directory.\n\n```bash\n# npm 6.x\nnpm create astro@latest --template anarion80/astro-ghost-simply\n\n# npm 7+, extra double-dash is needed:\nnpm create astro@latest -- --template anarion80/astro-ghost-simply\n\n# yarn\nyarn create astro --template anarion80/astro-ghost-simply\n```\n\n\u0026nbsp;\n\n## 🏃‍♂️ Running\n\nStart the development server. You now have an Astro site pulling content from headless Ghost. You do not need to have original [Simply Ghost Theme](https://github.com/godofredoninja/simply) installed in your Ghost instance, nor have any additional Routes set up there.\n\n```bash\nnpm run dev\n```\n\nBy default, the starter will populate content from a default Ghost install located at \u003chttps://gatsby.ghost.io\u003e.\n\nTo use your own install, you will need to edit the `.env` config file with your credentials. Change the `GHOST_API_URL` 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 `GHOST_API_KEY` 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\n```shell\nGHOST_API_KEY=\"secret_api_key\"\nGHOST_API_URL=\"https://gatsby.ghost.io\"\n\n```\n\nFinally, configure your desired URL in `utils/siteConfig.js`, so links (e. g. canonical links) are generated correctly. You should also update other values in there needed for menu, social sharing and search.\n\n```js\n{\n    menuDropdown: [\n        {\n            label: `About`,\n            url: `/about`,\n        },\n        .\n        .\n        .\n    ],\n    followSocialMedia: [\n        {\n            service: `youtube`,\n            title: `YOUR_TITLE`,\n            url: `YOUR_URL`,\n        },\n        .\n        .\n        .\n    ],\n    searchSettings: {\n        key: `YOUR_GHOST_API_KEY`,\n        url: `YOUR_GHOST_URL`,\n        /* This is optional */\n        options: {\n            keys: [`title`, `plaintext`],\n            limit: 10,\n        },\n        /* This is optional to perform filtering of the ghost api */\n        api: {\n            resource: `posts`,\n            parameters: {\n                limit: `all`,\n                fields: [`title`, `slug`, `plaintext`],\n                filter: ``,\n                include: ``,\n                order: ``,\n                formats: ``,\n            },\n        },\n    },\n}\n```\n\nTo use custom post templates, add a particular internal tag to the post (i.e. `#custom-post-wide`, `#custom-kusi-doc`, etc).\n\nDemo and the repo is the \"maximum version\" with all possible types of Home Page variants, Post Templates, Portfolio, Docs, etc. Adjust/remove as needed.\n\n\u0026nbsp;\n\n## ✈ Deploying with Netlify\n\nClick this button and it will help you create a new repo, create a new Netlify project, and deploy!\n\n[![Deploy to Netlify Button](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/anarion80/astro-ghost-simply)\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 `.env` 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://docs.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 Astro 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\nnpm run build\n\n# Preview a production build, locally\nnpm run preview\n```\n\n\u0026nbsp;\n\n## 📝 Copyright \u0026 License\n\nCopyright (c) 2023-2024 anarion80 - Released under the [GPLv3 license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanarion80%2Fastro-ghost-simply","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanarion80%2Fastro-ghost-simply","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanarion80%2Fastro-ghost-simply/lists"}