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

  1. Fork the repository on GitHub
  2. Create a new file in content/community/ (e.g., my-project.md) with frontmatter and description
  3. Add media (optional) - place in static/img/community/ or use an external URL
  4. Submit a Pull Request with your changes
  5. Wait for CI checks to validate your submission
  6. 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:

Languages:
Python, JavaScript, TypeScript, Rust, Go, Java, C++, C, Swift, Kotlin, Ruby, PHP, SQL, R, MATLAB, Julia, Scala, Dart, Elixir, Haskell

Categories:
Web Development, Mobile Development, Backend Development, DevOps, Machine Learning, Data Science, Artificial Intelligence, Blockchain, Game Development, IoT, Cybersecurity, Cloud Computing, Embedded Systems, Computer Vision, NLP, LLM, Open Source

Other: Use "Other" for skills not in this list

Submission Template

Create a new file in content/community/ (e.g., my-project.md) with the following format:

Frontmatter Fields

FieldRequiredDescription
titleYesYour project name
descriptionYesProject description (minimum 100 characters)
dateYesSubmission date (e.g., 2026-03-16)
draftYesSet to false for publication
skillsYesAt least one skill from the approved list

Extra Fields

FieldRequiredDescription
langYesLanguage code (e.g., "en")
github_userYesYour GitHub username
github_repoNoFull GitHub repository URL
demo_urlNoLive demo URL (optional)
imgNoImage: use local path like /img/community/your-image.png OR external URL like https://example.com/image.png

Example File

+++
title = "My Awesome Project"
description = "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."
date = 2026-03-16
draft = false

[taxonomies]
skills = ["Python", "Web Development", "Open Source"]

[extra]
lang = "en"
github_user = "your-username"
github_repo = "https://github.com/your-username/my-awesome-project"
demo_url = "https://my-awesome-project.demo.com"
img = "/img/community/my-project.png"
comment = false
reaction = false
+++

## About My Awesome Project

Write a detailed description of your project here. This content will appear on the project detail page. Include information about:
- What problem your project solves
- Key features
- How to get started
- Any other relevant details

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.