https://github.com/oliverspeir/astro-decap-ssg-netlify-identity

https://github.com/oliverspeir/astro-decap-ssg-netlify-identity

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/oliverspeir/astro-decap-ssg-netlify-identity
• Owner: OliverSpeir
• License: mit
• Created: 2023-12-02T02:34:24.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-07-31T06:41:47.000Z (5 months ago)
• Last Synced: 2024-07-31T08:05:09.899Z (5 months ago)
• Language: Astro
• Size: 1.56 MB
• Stars: 6
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Decap Starter

1. Set up Netlify Identity

- Deploy site

- `Site configuration --> Identity --> Enable Identity --> Enable Git Gateway ( In Services Section of Identity )`

  - You can allow Registration or Invite Only

  - For Invite Only: `Integrations --> Identity --> Invite Users --> Send invite email`

## How it works

- SSG on Netlify

- Git Gateway backend of Decap

- Requires Netlify Identity

- Local Backend works

  - Preview styles and templates won't be applied in dev server, but the cms will work

  - For actual use / local testing it's best to `pnpm run build && pnpm run preview`

  - If you are using windows you will need to edit the [package.json](./package.json)'s `dev` and `preview` commands to `"dev": "start decap-server & start astro dev"` and `"preview: "start decap-server & start astro preview"`

- Netlify Identity widget must be on root page ( is in `src/layouts/PageLayout.astro` but only needs to be on root page ) and `/admin`

- The decap admin board is preconfigured with preview styles built from the tailwind of our project and to only show the body in the preview ( personal preference of mine can be removed by removing the scripts in `/pages/admin.astro`)

- Tailwind typography for styling the blogs

  - Personally not a fan but I figured it was easy to use and remove

## Decap with oAuth Routes in Astro

https://github.com/OliverSpeir/astro-decap-starter-ssr