Skip to content

A reusable template for Open Code Chicago projects — includes community standards, best practices, and starter structure.

License

Notifications You must be signed in to change notification settings

OpenCodeChicago/project-template

Project Template

GitHub last commit CI License: MIT Open Issues Pull Requests Contributors GitHub stars GitHub forks Prettier Bash Docker


Table of Contents


Description

A ready-to-use template repository for quickly starting new projects. Includes essential files, recommended structure, and documentation to streamline your workflow.


Who is this for?

This template is designed for:

  • Open Code Chicago contributors starting new community projects.
  • Open source developers who want a clean and consistent project structure.

Quick Start

  1. Click the "Use this template" button on the repository page to create a new repo.
  2. Clone your new repository:
    git clone https://github.com/your-username/your-new-repo.git
    cd your-new-repo
  3. (Optional) Run the setup script:
    bash setup.sh
  4. Customize your project and update documentation as needed.

See docs/setup.md for more details.


Features

  • Pre-configured documentation folder (docs/)
  • Example setup script (setup.sh)
  • Dockerfile and .dockerignore for containerization
  • Automated CI workflow with GitHub Actions (.github/workflows/ci.yml)
  • Code of conduct and contributing guidelines
  • Sample configuration files (.editorconfig, .prettierrc)
  • Starter changelog

Project Structure

project-template/                     # GitHub project-template
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   ├── workflow/
│   │   └── ci.yml
│   ├── CODEOWNERS
│   ├── dependabot.yml
│   └── PULL_REQUEST_TEMPLATE.md
│
├── docs/
│   ├── images/
│   ├── architecture.md
│   ├── faq.md
│   ├── setup.md
│   └── usage.md
│
├── .dockerignore
├── .gitignore
├── .prettierrc
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── Dockerfile
├── LICENSE
├── README.md
└── setup.sh

Contributing

We welcome contributions!

Please read the CONTRIBUTING.md before submitting pull requests.


License

This project is licensed under the MIT License.


Feedback

We welcome feedback and suggestions to improve the template’s functionality and usability.


Support

📧 Contact: Email.

If you find this template helpful, consider supporting us:

Buy Me a Coffee Donate via PayPal


Languages and Tools


Connect with us

About

A reusable template for Open Code Chicago projects — includes community standards, best practices, and starter structure.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published