Planter Content

This repository contains blog posts, documentation, and other content for the Planter website.

Structure

planter_content/
├── blog/           # Blog posts
├── docs/           # Documentation pages
├── series/         # Series landing pages
├── author/         # Author bio pages
├── affiliate.md    # Affiliate page
├── podcast.md      # Podcast page
└── .github/
    └── workflows/
        └── trigger-jaspr-build.yml  # Triggers website rebuild

Content Format

All content is written in Markdown with YAML frontmatter:

---
title: "Post Title"
description: "Brief description for SEO"
date: 2025-01-15
author: ["author-slug"]
cover:
  image: "https://ucarecdn.com/..."
  alt: "Image description"
draft: false
---

Content goes here...

Publishing

When you push changes to the main branch:

  1. This repo's workflow triggers a rebuild of the Planter website
  2. Only the Jaspr static site is rebuilt (Flutter app is cached)
  3. Changes appear on planter.garden within a few minutes

Local Development

For local development with the main Planter repo:

# Clone this repo as a sibling to planter
cd ~/development
git clone git@github.com:planterApp/planter_content.git

# In the planter repo, symlink the content
cd planter/web_jaspr
rm -rf content  # Remove if exists
ln -s ../../planter_content content

# Run Jaspr locally
cd ..
jaspr serve

Contributing

  1. Create a new branch for your changes
  2. Add or edit content files
  3. Preview locally if possible
  4. Create a PR for review
  5. Merge to main to publish