Hello!

I'm the creator of Greening, a lightweight CLI that automates launching new open source projects. It handles everything from scaffolding your folder structure to setting up a GitHub repo and deploying a GitHub Pages site all from a single greening.yaml config.

🌱 TL;DR: It's a dev automation tool designed to help you ship beautiful software fast.

Text editor with user typing commands from Greening tool to scaffold a project

🧩 What is Greening?

Greening is for folks who build lots of small tools, libraries, or creative experiments and want to avoid the tedious boilerplate every time. It's especially useful for beginners, solo devs, makers, and people who love polished projects but hate setup tasks.

Here's what it can do:

greening init    # create greening.yaml with intelligent defaults
greening new     # scaffold your project, venv, and GitHub repo
greening deploy  # auto-generate a GitHub Pages site

GitHub logo chris-greening / greening

greening is an opinionated, lightweight project automation tool for solo developers and creative coders. With just a few commands, you can scaffold a production-ready Python package — complete with docs, tests, GitHub Actions workflows, PyPI packaging, and an auto-deployed GitHub Pages site. No boilerplate. No setup hell. Just instant polish.

🌱 Greening

greening is an opinionated, full-stack project automation tool for solo developers and creative coders.

With just a few commands, you can scaffold a production-ready Python package — complete with docs, tests, GitHub Actions workflows, PyPI packaging, and an auto-deployed GitHub Pages site No boilerplate. No setup hell. Just instant polish.

Downloads Issues License Version

Table of Contents

🍃 Why greening?

Most devs never ship their tools — not because the code isn’t good, but because the surrounding friction is too high:

  • How do I structure the project?
  • How do I set up CI/CD, tests, and linting?
  • How do I make it look legit?
  • How do I talk about it?

greening answers all of that in one opinionated workflow.

User typing in commands greening init, greening new, and greening deploy and rapidly deploying a project

🌿 Key features

greening automates your project creation pipeline:

✅ greening init…


View on GitHub


🌿 I'm Looking for Beginner-Friendly Contributors!

Whether you're new to open source or just looking for a welcoming project to contribute to, I’d love to have you on board.

There are:

  • 🟢 Labeled issues for first-time contributors
  • 📦 Opportunities to improve CLI help output, flags, and structure
  • 🧪 Testing-related tasks (unit tests, GitHub Actions)
  • 🌍 Docs, blog posts, and site improvements

You don’t need to be a senior dev. If you:

  • Know a bit of Python
  • Are curious about open source
  • Want to build something real that helps other developers

You’re in the right place.

🔗 How to Get Started

  1. Head to the issues tab and look for good first issue
  2. Drop a comment and say hi! Or open a discussion if you want to pitch ideas
  3. Feel free to fork + start exploring

If you need help setting up your environment or getting comfortable with the code, I’m happy to walk through it with you!

🙌 Why Contribute?

  • You'll learn how to structure CLI tools, package Python projects, and automate real dev workflows.
  • You'll get real GitHub contribution experience.
  • You'll see your name in the README and commits of a growing tool and community

Plus, the tool you help build will help other devs build faster and better.

💬 Drop a comment below if you’re interested, or jump into the GitHub issues and claim one!

Let’s build something cool together 🌱

Chris Greening - Software Developer

Hey! My name's Chris Greening and I'm a software developer from the New York metro area with a diverse range of engineering experience - beam me a message and let's build something great!

favicon christophergreening.com