Submit Your Project
Guidelines for submitting your project to the Community Showcase
Submit Your Project
Welcome to the Community Showcase! We feature projects from developers around the world. Here's how to submit yours.
Eligibility Criteria
Before submitting, ensure your project meets these requirements:
- Original Work: Project must be your own creation, not copied from others
- Valid GitHub Username: Required for author attribution
- Description: Minimum 100 characters
- At Least One Skill Tag: Help others find your project (see approved list below)
- Media: Optional - supports PNG, JPG, GIF. Place local files in
static/img/community/or use an external image URL (YouTube/video links not supported)
By submitting your project, you consent to its promotion on this website.
Step-by-Step Process
- Fork the repository on GitHub
- Create a new file in
content/community/(e.g.,my-project.md) with frontmatter and description - Add media (optional) - place in
static/img/community/or use an external URL - Submit a Pull Request with your changes
- Wait for CI checks to validate your submission
- Maintainer review - we'll review your submission as soon as possible
Approved Skills
Choose skills from this list. If your skill isn't listed, use Other:
Submission Template
Create a new file in content/community/ (e.g., my-project.md) with the following format:
Frontmatter Fields
| Field | Required | Description |
|---|---|---|
title | Yes | Your project name |
description | Yes | Project description (minimum 100 characters) |
date | Yes | Submission date (e.g., 2026-03-16) |
draft | Yes | Set to false for publication |
skills | Yes | At least one skill from the approved list |
Extra Fields
| Field | Required | Description |
|---|---|---|
lang | Yes | Language code (e.g., "en") |
github_user | Yes | Your GitHub username |
github_repo | No | Full GitHub repository URL |
demo_url | No | Live demo URL (optional) |
img | No | Image: use local path like /img/community/your-image.png OR external URL like https://example.com/image.png |
Example File
+++
= "My Awesome Project"
= "This is a detailed description of my project that explains what it does, why it's useful, and what makes it unique. It needs to be at least 100 characters long."
= 2026-03-16
= false
[]
= ["Python", "Web Development", "Open Source"]
[]
= "en"
= "your-username"
= "https://github.com/your-username/my-awesome-project"
= "https://my-awesome-project.demo.com"
= "/img/community/my-project.png"
= false
= false
+++
## About My Awesome Project
Approval Status
After review, your submission will receive one of these statuses:
- Approved: Your project will be published on the showcase
- Needs Revision: Specific feedback will be provided in PR comments
- Rejected: Reason will be given (e.g., copied content, invalid data)
Need Help?
If you have questions about the submission process, please open an issue on GitHub.