Backend administration setup using Decap CMS.

File Structure

project-root/
├── public/
│   └── admin/
│       └── config.yml        # Decap CMS configuration
├── astro.config.mjs          # Includes Decap CMS integration
└── .env                      # Environment variables

Setup Steps

1. Create a GitHub OAuth App

0. Edit astro.config.mjs and make sure oauthDisabled is false:

   export default defineConfig({
       integrations: [
           decapCmsOauth({
               decapCMSVersion: "3.9.0",
               oauthDisabled: false,
           }),
       ],
   })

1. Go to GitHub Developer Settings.
2. Click New OAuth App and fill in:
   • Application name: e.g. "Twilight Blog CMS"
   • Homepage URL: your-site-URL (e.g. "https://blog.spr-aachen.com")
   • Authorization callback URL: your-site-URL/oauth/callback (e.g. "https://blog.spr-aachen.com/oauth/callback")
3. Click Register application.
4. Generate a Client Secret.
5. Create a local .env file with:

   OAUTH_GITHUB_CLIENT_ID=your-github-client-id
   OAUTH_GITHUB_CLIENT_SECRET=your-github-client-secret

2. Update the CMS Config

Edit public/admin/config.yml:

backend:
    name: github
    repo: your-username/your-repo-name  # Replace with your GitHub repo
    branch: main                    # Replace with your branch name
    site_domain: your-domain        # Replace with your domain
    base_url: https://your-domain   # Replace with your production URL
    auth_endpoint: oauth

3. Deploy and Access

1. Push changes to your GitHub repository.
2. Choose an SSR-capable platform for deployment, inject the .env values into environment variables, then start deploying.
3. Open https://your-domain/admin to access the CMS dashboard.

Troubleshooting

Common Issues

1. OAuth authentication fails
   • Confirm the Client ID/Secret are correct.
   • Double-check the callback URL.
2. Cannot access the admin panel
   • Ensure environment variables are imported before deployment.
   • Confirm the hosting platform supports SSR.
3. Content fails to save
   • Verify GitHub repository permissions.
   • Confirm the branch name matches the config.
4. Dev server fails to start
   • Check for missing environment variables.
   • Reinstall dependencies if needed.

Getting Help

Open an Issue in the project repository if you need assistance.