Easily migrate your Ghost Site to Astro, an Astro Integration that turns your Ghost server into a Headless CMS https://astro-ghostcms.xyz/
Go to file
Adam Matthiesen 74a618cab9 fix 2024-01-20 14:31:49 -08:00
.github/workflows Update publish.yml 2024-01-16 01:06:27 -08:00
src fix 2024-01-20 14:31:49 -08:00
.env.demo ready for realease... 2024-01-17 02:29:47 -08:00
.gitignore Working.... local only not ready for prod 2024-01-17 01:42:28 -08:00
LICENSE Add License 2024-01-14 05:53:06 -08:00
README.md Update README.md 2024-01-19 11:28:18 -08:00
index.ts TSDocs! 2024-01-20 14:12:24 -08:00
package.json fix 2024-01-20 14:31:49 -08:00

README.md

Welcome to Astro-GhostCMS

Need help but don't have Github? Email us at issues@astro-ghostcms.xyz to create an issue here on github!

Astro minimum Version: Astro v4.0

This Integration is 2 parts. Firstly, there is the API portion that uses the @tryghost/content-api to create the link between astro and GhostCMS. From there we move to the Second Part, which is a theme pre-programmed to pull ALL of its data from GhostCMS iteself instead of storing any data locally outside of Build.

  • This package contains a independent copy of the tryghost content-api.js that is used to establish the connection so this package dose not depend on @tryghost/content-api package.
  • If you are looking for a more Customizable option please check astro-ghostcms-basetheme
  • This project is not setup for SSR in Integration mode. As such is will most likely not function properly in that mode. You will need to build your own project around the API or customize the basetheme linked above.

Astro Integration Mode

In this mode, the addon will not be just an API, but will be a full Route takeover, there is plans to add more themes in time, but for now there is only the base Casper theme based on Ghost's main Theme.

Astro Add Installation

# For fresh Install
npm create astro@latest
# Create Empty Install with standard typescript
# Then Delete entire `pages` folder under `/src/`
npx astro add @matthiesenxyz/astro-ghostcms

Dont forget to set your environment Variables!

You must also create 2 environment variables in a .env file with the following:

CONTENT_API_KEY=a33da3965a3a9fb2c6b3f63b48
CONTENT_API_URL=https://ghostdemo.matthiesen.xyz

Manual Installation

npm i @matthiesenxyz/astro-ghostcms

Then set your astro.config.ts to look like this:

import { defineConfig } from "astro/config";
import sitemap from "@astrojs/sitemap"; //optional but recommended
import GhostCMS from '@matthiesenxyz/astro-ghostcms';

// https://astro.build/config
export default defineConfig({
  site: "https://YOUR-DOMAIN-HERE.com"
  integrations: [sitemap(), GhostCMS()],
});

Dont forget to set your environment Variables!

You must also create 2 environment variables in a .env file with the following:

CONTENT_API_KEY=a33da3965a3a9fb2c6b3f63b48
CONTENT_API_URL=https://ghostdemo.matthiesen.xyz

When you deploy your install dont forget to set the above ENVIRONMENT VARIABLES!

Created Routes

The routes are the same as a standard Ghost Blog so you can migrate to Astro easily.

Route Content
/ Homepage with recents/features Blog Posts
/[slug] Post or Page
/author/[slug] Author page with related posts
/authors All the authors
/tag[slug] Tag page with related posts
/tags All the tags
/archives/[...page] All the posts, paginated

Manual Function Mode (DIY MODE)

In this mode the integration will not deploy routes at all. you will have to build your own website to utilize the exported functions listed below.

npm i @matthiesenxyz/astro-ghostcms

You must also create 2 environment variables in a .env file with the following:

CONTENT_API_KEY=a33da3965a3a9fb2c6b3f63b48
CONTENT_API_URL=https://ghostdemo.matthiesen.xyz

When you deploy your install dont forget to set the above ENVIRONMENT VARIABLES!

For more information please check our website: Astro-GhostCMS.xyz