Skip to content

Instantly share code, notes, and snippets.

@pizofreude
Created April 18, 2025 11:42
Show Gist options
  • Save pizofreude/03426b35057a72dcebf96ee0aa69e2df to your computer and use it in GitHub Desktop.
Save pizofreude/03426b35057a72dcebf96ee0aa69e2df to your computer and use it in GitHub Desktop.
How to indicate project status in GitHub README

Indicating the project status in your README is a great way to communicate the current state of your project to potential collaborators, recruiters, or users. You can use a "Project Status" section near the top of your README to make this clear. Here’s how you can do it:

Examples for Indicating Project Status

1. Use a Badge (Preferred for Clear Visuals)

Including a badge is a common way to display project status. You can generate badges using services like shields.io. Here’s an example:

![Project Status](https://img.shields.io/badge/status-in--progress-yellow)

For different statuses:

  • Work-in-progress: https://img.shields.io/badge/status-in--progress-yellow
  • Completed: https://img.shields.io/badge/status-completed-brightgreen
  • Maintenance Mode: https://img.shields.io/badge/status-maintenance-blue
  • Archived: https://img.shields.io/badge/status-archived-lightgrey

2. Add a "Project Status" Section

If you prefer a more text-based approach, you can include a dedicated section in your README:

### Project Status
🚧 **Work in Progress**: This project is currently under development. New features and updates are being added regularly.

OR

✅ **Completed**: This project is fully implemented, but improvements may still be made in the future.

OR

🛠️ **Maintenance Mode**: This project is complete and is only receiving critical updates or bug fixes.

OR

🏁 **Archived**: This project is no longer actively maintained.

3. Combine Both Badges and Text

You can combine a badge with a descriptive "Project Status" section for clarity:

![Project Status](https://img.shields.io/badge/status-in--progress-yellow)

### Project Status
🚧 **Work in Progress**: This project is currently under development. Expect frequent changes and updates.

Where to Place It?

  • Place the "Project Status" section at the top of your README, below the project title and description.
  • If using only a badge, you can add it next to or below the project title.

Let me know if you'd like me to help you create a README structure or include this in your project!

@pizofreude
Copy link
Author

Example: Combine Both Badges and Text

Project Status

Project Status

🚧 Work in Progress: This project is currently under development. Expect frequent changes and updates.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment