- This template can be used as a base layer for a GitHub profile page.
- Make the project easy to maintain with 7 issue templates.
- Quick-start documentation with an extraordinary README structure.
- Manage issues with 20 issue labels.
- Make community healthier with all the guides like code of conduct, contributing, support, security...
- Learn more with the official GitHub guide on creating repositories from a template.
- To start using it, click Use this template to create your new repository.
Getting-started guidance, feature details, and API reference documentation.
# Clone the repository
git clone https://github.com/IQKV/standard-docs-vitepress-project-layout.git my-docs
# Navigate to project directory
cd my-docs
# Install dependencies
pnpm install
# Start development server
pnpm docs:dev| Command | Description |
|---|---|
pnpm docs:dev |
Start development server |
pnpm docs:build |
Build for production |
pnpm docs:preview |
Preview production build |
pnpm prettier:write |
Run Prettier over the code |
pnpm lint |
Lint code |
| Variable | Description | Default |
|---|---|---|
NODE_ENV |
Defines nodejs environment | development |
Conventional changelog located here.
...
Please follow Contributing page.
Please follow Code of Conduct page.
...
This project is licensed under the MIT License. See the LICENSE file for more details.
- VitePress - Static site generator for documentation
- Vue - Frontend framework
- pnpm - Package manager with workspace support
| Command | Description |
|---|---|
pnpm docs:dev |
Start development server |
pnpm docs:build |
Build for production |
pnpm docs:preview |
Preview production build |
pnpm prettier:write |
Format code with Prettier |
pnpm lint |
Lint code (prettier check) |
pnpm release |
Create release with release-it |
- Prettier - Code formatting with packagejson plugin
- Lint-staged - Run linters on staged files
- EditorConfig - Consistent editor settings
- Husky - Git hooks management
- Commitlint - Enforce conventional commits
- Commitizen - Interactive commit message generator
- Pre-commit hooks - Automatic code formatting before commits
- Release-it - Automated release workflow
- Conventional Changelog - Generate changelog from commits
- Release-it-pnpm - pnpm integration for releases
- Build validation - Node.js project build checks
- PR title validation - Enforce conventional PR titles
- Commit message validation - Verify commit format
- Template cleanup - Post-template setup automation
- Dependabot - Automated dependency updates
- Issue templates (7 templates) - Standardized issue reporting
- Issue labels (20 labels) - Organized issue categorization
- Community health files - Contributing, CoC, Security, Support guides
- Dev container - Containerized development environment