Skip to content
/ app-ts-template Public template
generated from d3p1/client-ts-template

A template to build apps using TypeScript

License

Notifications You must be signed in to change notification settings

d3p1/app-ts-template

Repository files navigation

[APP TS TEMPLATE]

code style: prettier Build Release semantic-release: angular

Introduction

A repository aimed at serving as a template to implement projects using TypeScript on the client side, providing basic configurations for using Conventional Commits, Prettier, ESLint, and Jest. It also includes a setup for use within a Dev Container, featuring optimized VSCode configurations for working with these technologies. Lastly, it incorporates GitHub Actions that automate the project build and release.

Note This template repository extends from this one. It adds webpack with Sass to be able to create a more robust application

Usage

In order to proceed with using this template, you need to:

  1. Create a repository from this template
  2. Adjust the following values in the default package.json:
    • name
    • version (it's recommended to use 0.0.0 so that the release workflow can adjust it)
    • description
    • private
    • repository.url
    • keywords
    • bugs.url
    • homepage
    • license (if necessary)
  3. Remove the CHANGELOG.md
  4. Modify the LICENSE file (if necessary)
  5. Edit the README.md. Update texts and create new badges for build workflow and release workflow since they currently point to the template repository
  6. Run npm install to install the dependencies
  7. You can now start working in ./src using the files there as templates and/or creating new ones

Note Enable code scanning with CodeQL and add the status badge to the README.md

Warning The release workflow uses a bot that needs to have write access to the repository to create new releases, tags, and the CHANGELOG.md. If you are using a personal repository, to allow the bot to work smoothly, you shouldn't protect the branch. If you are using an organization's repository, you can protect the branch and add the bot as an owner to enable it to perform its tasks)

Changelog

Detailed changes for each release are documented in CHANGELOG.md.

License

This work is published under MIT License.

Author

Always happy to receive a greeting on: