An open API service indexing awesome lists of open source software.

https://github.com/leonwong282/awesome-project-template

A modern, beautiful, and well-structured open source project template for web applications.
https://github.com/leonwong282/awesome-project-template

List: awesome-project-template

boilerplate github open-sourece template

Last synced: 3 months ago
JSON representation

A modern, beautiful, and well-structured open source project template for web applications.

Awesome Lists containing this project

README

          


Logo

# πŸš€ Awesome Project Template

> A modern, beautiful, and well-structured open source project template

![Version](https://img.shields.io/badge/Version-1.0.0-blue?style=for-the-badge)
![License](https://img.shields.io/badge/License-GPL--3.0-red?style=for-the-badge)
![Template](https://img.shields.io/badge/Template-Ready-green?style=for-the-badge)
![Stars](https://img.shields.io/github/stars/leonwong282/awesome-project-template?style=for-the-badge&color=yellow)

[🌍 English](README.md) | [πŸ‡ΉπŸ‡Ό 繁體中文](README.zh-TW.md)

[Features](#-features) β€’ [Quick Start](#-quick-start) β€’ [Structure](#-template-structure) β€’ [Contributing](#-contributing)

## ✨ Features

- πŸ“ **Documentation-First**: Comprehensive README, contributing guides, and documentation structure
- 🀝 **GitHub Integration**: Issue templates, PR templates, and community health files
- 🌍 **Multi-Language**: README in English and Traditional Chinese
- πŸ“‹ **Community Standards**: Code of Conduct, Security Policy, and Contributing guidelines
- βš™οΈ **Editor Consistency**: EditorConfig for consistent code style across editors
- 🏷️ **Conventional Commits**: Structured commit message guidelines

## πŸš€ Quick Start

### Using as Template

**Method 1: GitHub Web Interface (Recommended)**
1. Click the "Use this template" button above
2. Configure your new repository
3. Start coding!

**Method 2: GitHub CLI**
```bash
gh repo create your-project-name \
--template leonwong282/awesome-project-template \
--public --clone
```

**Method 3: Manual Clone**
```bash
git clone https://github.com/leonwong282/awesome-project-template.git your-project
cd your-project
rm -rf .git && git init
```

### After Creating Your Project

1. **Update project information**
- Replace "Project Name" placeholders in documentation
- Update repository URLs to your own
- Configure author information

2. **Add your tech stack**
- Create `package.json`, `requirements.txt`, or your dependency file
- Add source code directories (`src/`, `lib/`, etc.)
- Set up your build tools and CI/CD

3. **Customize documentation**
- Update `docs/GETTING_STARTED.md` with your setup instructions
- Modify issue templates for your project's needs

(back to top)

## πŸ—οΈ Template Structure

```
awesome-project-template/
β”œβ”€β”€ πŸ“š docs/ # Documentation hub
β”‚ β”œβ”€β”€ GETTING_STARTED.md # Setup guide template
β”‚ └── README.md # Documentation index
β”œβ”€β”€ 🀝 .github/ # GitHub integration
β”‚ β”œβ”€β”€ ISSUE_TEMPLATE/ # Issue templates (bug, feature, docs, question)
β”‚ β”œβ”€β”€ copilot-instructions.md # AI coding assistant guidance
β”‚ └── pull_request_template.md # PR template
β”œβ”€β”€ πŸ–ΌοΈ images/ # Visual assets
β”‚ └── logo.png # Project logo
β”œβ”€β”€ πŸ“‹ Community Files
β”‚ β”œβ”€β”€ README.md # This file
β”‚ β”œβ”€β”€ README.zh-TW.md # Traditional Chinese README
β”‚ β”œβ”€β”€ CONTRIBUTING.md # Contribution guidelines
β”‚ β”œβ”€β”€ CODE_OF_CONDUCT.md # Community standards
β”‚ β”œβ”€β”€ SECURITY.md # Security policy
β”‚ β”œβ”€β”€ CHANGELOG.md # Version history template
β”‚ └── LICENSE # GPL-3.0 license
└── βš™οΈ Configuration
β”œβ”€β”€ .editorconfig # Editor settings
β”œβ”€β”€ .gitignore # Git ignore patterns
└── .gitattributes # Git attributes
```

(back to top)

## πŸ“– Documentation

- **[πŸ“š Documentation Hub](docs/README.md)** - Complete documentation index
- **[πŸš€ Getting Started](docs/GETTING_STARTED.md)** - Setup instructions template
- **[🀝 Contributing](CONTRIBUTING.md)** - How to contribute

(back to top)

## 🀝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Quick Contribution Steps

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'feat: add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

(back to top)

## πŸ“‹ Roadmap

- [x] Core template structure
- [x] GitHub issue/PR templates
- [x] Multi-language README
- [x] Community health files
- [ ] CI/CD workflow templates
- [ ] Docker configuration templates
- [ ] Additional language READMEs

See the [open issues](https://github.com/leonwong282/awesome-project-template/issues) for more.

(back to top)

## πŸ“„ License

This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.

## πŸ‘₯ Author

**Leon Wong** - [leonwong282](https://github.com/leonwong282)

## πŸ™ Acknowledgments

- [Best-README-Template](https://github.com/othneildrew/Best-README-Template)
- [Contributor Covenant](https://www.contributor-covenant.org/)
- [Keep a Changelog](https://keepachangelog.com/)
- [Shields.io](https://shields.io/)

## πŸ“ž Support

- πŸ“ [Open an issue](https://github.com/leonwong282/awesome-project-template/issues/new)
- πŸ’¬ [Start a discussion](https://github.com/leonwong282/awesome-project-template/discussions)
- πŸ“§ Email: leonwong282@gmail.com

---

**⭐ Star this repository if it helped you!**

Made with ❀️ by [Leon](https://github.com/leonwong282)