TODO: one-line description of this project.
This repo is a GitHub template repository: clicking Use this template copies these files as-is into a new repo, there is no variable substitution. After generating a new repo from it, go through this checklist:
- Replace
project-nameeverywhere (badges above,package.jsonname/repository/homepage/bugs, this heading) with the real repo name. - Fill in
package.jsondescriptionand this README's one-line description. - Set
package.jsonversionto wherever this project's versioning actually starts. - Drop
package.jsonprivate: trueonly if this project will actually be published somewhere. - Configure branch protection (or a ruleset) on
main: require pull requests, require theContinuous Integrationstatus check frompull-request.yml, and set the merge method to merge commits only (disable squash and rebase merging in Settings → General → Pull Requests). Thecommitlintstep inpull-request.ymlis a CI backstop for the local Husky hook, not redundant with it, and it only stays meaningful if commits land inmain's history unmodified; squash/rebase merging defeats that. See dnd-mapp/tsconfig's ADR 0001 for the full reasoning. This has to be set per repo, GitHub org-wide rulesets require GitHub Enterprise. - Delete this "Using this template" section once the checklist is done.
Depending on what this repo is actually for, add:
- A publishable npm package: reinstate a
release.ymlrelease workflow (see dnd-mapp/tsconfig for a working example that publishes to GitHub Package Registry), and dropprivate: truefrompackage.json. - A JavaScript/TypeScript GitHub Action: add
typescriptand@types/nodeas devDependencies, a build step (e.g.@vercel/ncc) to bundle todist/, anaction.ymlmanifest at the repo root, and a release workflow that tags (and moves a major-version tag likev1). - A composite (YAML-only) GitHub Action: just add an
action.ymlmanifest at the repo root, no other changes needed. - An Angular, NestJS, or plain TypeScript/Node project: add
typescript,@types/node, and atsconfig.jsonextending the matching@dnd-mapp/tsconfigpreset.
See the org-wide CONTRIBUTING.md for how to propose changes, and DEVELOPMENT.md for how to work in this repository day-to-day. This project follows the Code of Conduct.
See SECURITY.md for how to report a vulnerability.
See SUPPORT.md for how to get help.
See CHANGELOG.md for release history.