{"id":22542001,"url":"https://github.com/t34-dev/node-ts-starter","last_synced_at":"2026-01-07T20:04:26.496Z","repository":{"id":249636567,"uuid":"832096838","full_name":"t34-dev/node-ts-starter","owner":"t34-dev","description":"A comprehensive starter template for TypeScript Node.js projects, equipped with essential tools and configurations to jumpstart your development process.","archived":false,"fork":false,"pushed_at":"2024-08-05T14:37:03.000Z","size":113,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T22:11:23.816Z","etag":null,"topics":["empty","init","nodejs","project","start","starter","typescript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/t34-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-22T10:50:30.000Z","updated_at":"2024-08-05T14:37:06.000Z","dependencies_parsed_at":"2024-07-22T11:56:16.086Z","dependency_job_id":"9fd7cf6d-459b-4254-91f0-2e2c94453694","html_url":"https://github.com/t34-dev/node-ts-starter","commit_stats":null,"previous_names":["well-do-it-too/typescript-node-starter","t34-dev/node-ts-starter","t34-developer/node-ts-starter","well-do-it-too/node-typescript-starter"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t34-dev%2Fnode-ts-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t34-dev%2Fnode-ts-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t34-dev%2Fnode-ts-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t34-dev%2Fnode-ts-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/t34-dev","download_url":"https://codeload.github.com/t34-dev/node-ts-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246049628,"owners_count":20715510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["empty","init","nodejs","project","start","starter","typescript"],"created_at":"2024-12-07T13:08:12.599Z","updated_at":"2026-01-07T20:04:26.428Z","avatar_url":"https://github.com/t34-dev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![ISC License](http://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)\n![TypeScript](https://img.shields.io/badge/TypeScript-5.3.x-blue?logo=typescript\u0026ver=1722868623)\n![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20.0.0-green?logo=node.js\u0026ver=1722868623)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/t34-dev/node-ts-starter?ver=1722868623)\n![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/t34-dev/node-ts-starter?sort=semver\u0026style=flat\u0026logo=git\u0026logoColor=white\u0026label=Latest%20Version\u0026color=blue\u0026ver=1722868623)\n\n# TypeScript Node.js Starter\n\nA comprehensive starter template for TypeScript Node.js projects, equipped with essential tools and configurations to jumpstart your development process.\n\n## Features\n\n- TypeScript configuration\n- ESLint for code linting\n- Prettier for code formatting\n- Husky for Git hooks\n- Nodemon for development\n- Automatic version updating\n- Automatic Git tag updating\n- Minification of distribution files\n- Pre-commit hooks\n- Make commands for easier project management\n\n## Prerequisites\n\n- Node.js (v20.0.0 or later)\n- pnpm (v8 or later)\n- GNU Make\n\n## Installation\n\n1. Clone the repository:\n\n   ```\n   git clone https://github.com/t34-dev/node-ts-starter.git\n   cd node-ts-starter\n   ```\n\n2. Install dependencies:\n   ```\n   pnpm install\n   ```\n\n## Usage\n\nYou can use either pnpm scripts or Make commands to manage the project.\n\n### Using pnpm scripts\n\nTo run tests:\n\n```\npnpm test\n```\n\nTo start the development server with hot-reloading:\n\n```\npnpm run dev\n```\n\nTo compile TypeScript to JavaScript:\n\n```\npnpm run build\n```\n\nFor production build with minification:\n\n```\npnpm run build:prod\n```\n\nTo lint your code:\n\n```\npnpm run lint\n```\n\nTo format your code:\n\n```\npnpm run format\n```\n\nTo start the compiled application:\n\n```\npnpm start\n```\n\n### Using Make commands\n\nRun these commands with `make \u003ccommand\u003e`:\n\n- `make` or `make help`: Shows all available Make commands.\n- `make rmdist`: Removes the dist folder.\n- `make build`: Builds the project (includes removing dist folder).\n- `make build-prod`: Builds the project for production (includes minification).\n- `make dev`: Starts the development server.\n- `make run`: Runs the compiled application.\n- `make test`: Runs the test suite.\n- `make version-up`: Updates the project version.\n- `make pre`: Runs pre-commit checks.\n\n#### Git Tag Management\n\nThe project includes additional commands for managing Git tags:\n\n- `make tag`: Displays the latest Git tag.\n- `make tag-new`: Displays the next Git tag that would be created.\n- `make tag-up`: Creates and pushes a new Git tag. Note: This command can only be run from the 'main' branch.\n\n## Scripts\n\n- `prepare`: Sets up Husky\n- `clean`: Removes dist folder, node_modules, and pnpm-lock.yaml\n- `build`: Compiles TypeScript to JavaScript\n- `build:prod`: Compiles and minifies for production\n- `dist:minify`: Minifies distribution files\n- `dev`: Starts development server with hot-reloading\n- `start`: Runs the compiled application\n- `test`: Runs the test suite\n- `lint`: Lints the codebase\n- `format`: Formats the codebase\n- `version-up`: Updates the project version\n- `pre-commit`: Runs linting and formatting before commit\n\n## Version Management\n\nThis project uses semantic versioning (SemVer) for its Git tags. The `tag.mk` file provides utilities to manage these tags:\n\n- Tags follow the format `vX.Y.Z` where X is the major version, Y is the minor version, and Z is the patch version.\n- The `make tag-up` command automatically increments the patch version when creating a new tag.\n- New tags can only be created from the 'main' branch to ensure version consistency.\n\nWhen contributing to the project, please be aware of these versioning practices and use the provided commands to manage tags and versions.\n\n## License\n\nThis project is licensed under the ISC License. See the [LICENSE](LICENSE) file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\nRemember to run `make pre` or `pnpm run pre-commit` before committing your changes to ensure code quality and consistency.\n\n## Acknowledgements\n\n- [TypeScript](https://www.typescriptlang.org/)\n- [Node.js](https://nodejs.org/)\n- [ESLint](https://eslint.org/)\n- [Prettier](https://prettier.io/)\n- [Husky](https://typicode.github.io/husky/#/)\n- [GNU Make](https://www.gnu.org/software/make/)\n\n---\n\nDeveloped with ❤️ by [T34](https://github.com/t34-dev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft34-dev%2Fnode-ts-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ft34-dev%2Fnode-ts-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft34-dev%2Fnode-ts-starter/lists"}