Skip to content

fix: 🔥 add package.json sections #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jul 4, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
File renamed without changes.
52 changes: 22 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# js-quality-starter
# {{PROJECT_NAME}}

[![CI](https://github.com/your-username/your-new-repo/actions/workflows/ci.yml/badge.svg)](https://github.com/your-username/your-new-repo/actions/workflows/ci.yml)
[![codecov](https://codecov.io/gh/your-username/your-new-repo/graph/badge.svg?token=YOUR_CODECOV_TOKEN)](https://codecov.io/gh/your-username/your-new-repo)
Expand All @@ -9,31 +9,19 @@ A template repository for modern JavaScript projects with pre-configured linting

This template provides a solid foundation for any new JavaScript project, ensuring code quality and consistency from the start.

## Table of Contents <!-- omit in toc -->

- [Quick Start](#quick-start)
- [Why Choose `js-quality-started`?](#why-choose-js-quality-started)
- [What's Inside?](#whats-inside)
- [Getting Started](#getting-started)
- [Using as a Template](#using-as-a-template)
- [Manual Setup](#manual-setup)
- [Post-Template Setup](#post-template-setup)
- [Available Scripts](#available-scripts)
- [How It Works](#how-it-works)
- [Pre-commit Hooks](#pre-commit-hooks)
- [CI/CD Pipelines](#cicd-pipelines)
- [Customization](#customization)
- [Code Coverage](#code-coverage)
- [Contributing](#contributing)
- [License](#license)
## Table of Contents

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
<!-- END doctoc generated TOC please keep comment here to allow auto update -->

## Quick Start

```bash
npx degit your-github-username/js-quality-started my-new-project
cd my-new-project
git clone https://github.com/{{GITHUB_USERNAME}}/{{PROJECT_NAME}}.git
cd {{PROJECT_NAME}}
npm install
npm test
npm run setup # Clearly state to run your setup script!
# Start building!
```

Expand Down Expand Up @@ -97,8 +85,8 @@ This template comes pre-configured with a suite of modern, industry-standard too
1. Clone the repository:

```bash
git clone https://github.com/your-username/your-new-repo.git # Replace with your actual repository URL
cd your-new-repo
git clone https://github.com/{{GITHUB_USERNAME}}/{{PROJECT_NAME}}.git # Replace with your actual repository URL
cd {{PROJECT_NAME}}
```

2. Install dependencies:
Expand All @@ -113,16 +101,18 @@ This template comes pre-configured with a suite of modern, industry-standard too

### Post-Template Setup

After creating your repository from this template, be sure to:
After creating your repository from this template and cloning it locally, personalize your project by running the setup script:

1. **Update `package.json`**: Change the `name`, `description`, and `author` fields.
2. **Update `LICENSE`**: Modify the `[year]` and `[fullname]` to reflect your project's ownership.
3. **Update `CODE_OF_CONDUCT.md` and `CONTRIBUTING.md`**: Replace the `[YOUR_PROJECT_CONTACT_EMAIL]` placeholder with a valid project contact email.
```bash
npm install # Ensure dependencies are installed, including 'inquirer'
npm run setup
```

## Available Scripts

In the project directory, you can run:

````bash
- `npm test`: Runs the tests using Jest.
- `npm run lint`: Lints all `.js` files in the project.
- `npm run lint:fix`: Lints and automatically fixes fixable issues.
Expand All @@ -132,6 +122,8 @@ In the project directory, you can run:
- `npm run lint:md:fix`: Lints and automatically fixes fixable issues in Markdown files.
- `npm run format:md`: Checks for formatting issues with Prettier for Markdown files.
- `npm run format:md:fix`: Formats all Markdown files with Prettier.
- `npm run toc`: Generates a Table of Contents for the `README.md` file.
- `npm run fix:all`: Runs all fixable scripts in one command.

## How It Works

Expand Down Expand Up @@ -185,8 +177,7 @@ To get a dynamic code coverage badge like the one at the top of this `README.md`
uses: codecov/codecov-action@v4
with:
token: ${{ secrets.CODECOV_TOKEN }}
```

```
5. Update the badge URL in `README.md` with your specific repository details and token (if required by Codecov for public repos, though often not for public repos).

## Contributing
Expand All @@ -195,4 +186,5 @@ We welcome contributions! Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for

## License

This project is licensed under the [LICENSE](LICENSE.md) file for details.
This project is licensed under the [LICENSE](LICENSE) file for details.
````
Loading