🌍 Web Page | 💻 Source Code | 🚀 Releases

🏗️ brepo

A base template repository to quickly bootstrap new projects with preconfigured structure, essential files, and common workflows.

📌 About

This is a foundational template repository designed to accelerate the setup of new projects by providing a thoughtfully organized structure, essential configuration files, and prebuilt workflows. It is developed for personal use but also ideal for other developers as well who want to start coding immediately without spending time on repetitive project scaffolding or boilerplate setup.

🧠 Philosophy

The goal is to minimize setup friction and maximize productivity by automating the repetitive aspects of project initialization.

🔑 Key Features

• Comprehensive Project Structure: Organized directories for automation: .github/, documentation: docs/, and GitHub Pages: docs/pages/, supporting scalable and maintainable projects.
• Ready-to-Use Essential Files: Provides the following essential files out-of-the-box to enforce best practices from the start.
  • .cspell.yaml
  • .editorconfig
  • .gitignore
  • .prettierrc.yaml
  • LICENSE.md
  • README.md
  • docs/CHANGELOG.md
  • docs/CODE-OF-CONDUCT.md
  • docs/CONTRIBUTING.md
  • docs/ROADMAP.md
  • docs/SECURITY.md
  • docs/TODO.md
• Documentation-First Workflow: Markdown templates making it easy to maintain high-quality documentation.
• Jekyll Documentation Site: The docs/pages/ directory is preconfigured for Jekyll, enabling instant publishing of project docs to GitHub Pages.
• Automated CI/CD: Includes reusable GitHub Actions workflows for CI/CD, automated documentation deployment, streamlining development and release processes.
• Copilot Guidance: Instructions for Copilot and VS Code integration, including both commit message and pull request description guidelines to ensure consistency with Conventional Commits.
• Customization Friendly: All configuration files and templates are easy to modify for specific needs and workflows.
• VS Code Workspace Support: Predefined workspace and editor settings for a consistent development experience.

🏆 Use Cases

• Rapid Prototyping: Quickly spin up new repositories for experiments, prototypes, or MVPs with a solid foundation.
• Standardize Projects: Standardize project structure and workflows to reduce initialization time and improve productivity.
• Open Source Projects: Ensure new open source repositories follow best practices for documentation, licensing, and automation from day one.

🗂️ Directory Structure

The repository is organized for rapid bootstrapping, automation, and documentation-driven development.

Terminal

.
├── .cspell.yaml
├── .editorconfig
├── .gitignore
├── .prettierrc.yaml
├── brepo.code-workspace
├── LICENSE.md
├── README.md
├── .github/
│   ├── copilot/
│   │   ├── commit-message-instructions.md
│   │   └── pull-request-description-instructions.md
│   └── workflows/
│       └── pages.yaml
└── docs/
    ├── CHANGELOG.md
    ├── CODE-OF-CONDUCT.md
    ├── CONTRIBUTING.md
    ├── ROADMAP.md
    ├── SECURITY.md
    ├── TODO.md
    └── pages/
        ├── _config.yaml
        ├── index.md
        ├── _includes/
        │   ├── head-custom-google-analytics.html
        │   └── head-custom.html
        ├── _pages/
        │   └── .gitkeep
        └── assets/
            ├── icons/
            │   └── favicon.svg
            └── images/
                ├── banner-standard.svg
                ├── social-media-preview.png
                └── social-media-preview.svg

📄 Important Documents

• Changelog: Changelog of all notable changes.
• Code of Conduct: Code of Conduct for contributors.
• Commit Message Instructions: Commit message guidelines for contributors and Copilot.
• Contribution Guidelines: How to contribute to this project.
• License: License text.
• Pull Request Description Instructions: Pull request guidelines for contributors and Copilot.
• Roadmap: High-level strategic plan, long-term goals, milestones, and overall project vision.
• Security Policy: Security policy and reporting instructions.
• Todo: Day-to-day task tracking and immediate execution.

📜 License

This project is licensed under the MIT License, allowing anyone to use, modify, and distribute it freely for personal or commercial purposes.