This React TypeScript template is designed for a quick start in new projects. It comes pre-configured with essential tools and libraries to streamline the development process. The template includes:
- React ⚛️ for building user interfaces.
- Babel 🐵
- TypeScript 🔵
- ESLint 🛠️
- Prettier 🖋️
- Jest 🃏
- Husky 🐶
First, install the project dependencies:
npm installIf you're having trouble making a commit, it might be due to the precommit hook, which runs the lint and test scripts before each commit. If these scripts find any errors, the commit will be blocked. Check the output for any lint or test errors and fix them before trying to commit again.
To run these scripts, use npm run <script-name>:
start: 🚀 Builds the TypeScript code and starts the application.build: 🔨 Compiles the TypeScript code using the TypeScript compiler (tsc).test: 🧪 Runs tests using Jest and generates a coverage report.format: 🖋️ Formats the code using Prettier.lint: 🧹 Lints all JavaScript and TypeScript files in the project using ESLint.precommit: 🔒 Runs thelintandtestscripts before each commit to ensure code quality. This is managed by Husky 🐶.pretest: 🔍 Lints the code before running tests.watch: 👀 Runs tests in watch mode using Jest.debug: 🐞 Starts the application in debug mode usingnodemon.clean: 🧽 Removes thenode_modulesdirectory andpackage-lock.jsonfile.prepare: 🐾 Sets up Husky for managing git hooks.
This template includes several GitHub Actions workflows that automate various tasks:
ci.yml: Runs your project's continuous integration (CI) tasks.close-merged-pull-requests.yml: Automatically closes pull requests that have been merged.close-stale-issues-and-prs.yml: Closes stale issues and pull requests.label-new-pull-requests.yml: Automatically adds labels to new pull requests.thank-contributors-on-issue-close.yml: Thanks contributors when an issue they commented on is closed.welcome-new-pull-requests.yml: Posts a welcome message on new pull requests.welcome.yml: Posts a welcome message on new issues.
These workflows use the secrets.GITHUB_TOKEN secret, which GitHub automatically creates for every repository. You can create a personal access token and add it as a secret in your repository. For more information, see Creating and storing encrypted secrets.
This project includes a .devcontainer.json file which allows you to work on this project in a Docker container using GitHub Codespaces. This helps to maintain a consistent development environment, making it easier for you to collaborate with others without having to worry about individual setup.
GitHub Codespaces configures your development environment based on your project's needs using this file. When you create a new codespace for this project, the Codespaces environment is automatically configured as per the settings defined in .devcontainer.json.
To use GitHub Codespaces:
- Navigate to the main page of the repository.
- Click the Code button and then click "Open with Codespaces".
- Click "+ New codespace".
Your development environment is now set up and running in a Docker container in the cloud. All commands you run in the Codespaces terminal will be executed inside the container. Any changes you make to the project will be reflected in the container and vice versa.
If you appreciate my work and would like to support me, consider sponsoring me on GitHub Sponsors. Your support is greatly appreciated and helps me continue my contributions to open source and volunteer work.
Contributions are welcome! Please read the Contributing Guide. for details on our code of conduct and the process for submitting pull requests.
Please read our Code of Conduct to keep our community approachable and respectable.
This project is licensed under the terms of the Commercial License Agreement. For more details, see the LICENSE file.
© 2024 Jagoda11