Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dorayx/template-typescript-app

(opinionated) Vite-TypeScript Boilerplate
https://github.com/dorayx/template-typescript-app

boilerplate commitlint eslint github-action husky lint-staged plop prettier semantic-release template typescript typescript-application vite vitest yarn

Last synced: 26 days ago
JSON representation

(opinionated) Vite-TypeScript Boilerplate

Host: GitHub
URL: https://github.com/dorayx/template-typescript-app
Owner: dorayx
License: mit
Created: 2023-09-01T02:03:50.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-09-08T15:55:51.000Z (over 1 year ago)
Last Synced: 2024-11-08T08:49:33.435Z (3 months ago)
Topics: boilerplate, commitlint, eslint, github-action, husky, lint-staged, plop, prettier, semantic-release, template, typescript, typescript-application, vite, vitest, yarn
Language: JavaScript
Homepage:
Size: 1.23 MB
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # _opinionated_ Vite-TypeScript Template

This template is opinionated, and it is not meant to be a one-size-fits-all solution.

It is meant to be a starting point for my personal projects to bootstrap development, as I like to create minimal viable products from time to time.

## User Cases

- ✅ TypeScript Application

- ❌ TypeScript Library _(use [dorayx/template-typescript-library](https://github.com/dorayx/template-typescript-library) instead)_

- ❌ UI Component Library

## Features

- ✅ TypeScript v5

- ✅ Vite + Vitest

- ✅ Linters

- ✅ Code Generator

- ✅ Semantic Release

- ✅ GitHub Actions

- ❌ Monorepo

## Tooling

This template is configured with the following tools:

**Compiler & Bundler**

- [TypeScript](https://www.typescriptlang.org/) _(v5)_

- [Vite](https://vitejs.dev/) _(v4)_

  - Plugin: [vite-tsconfig-paths](https://www.npmjs.com/package/vite-tsconfig-paths)

  - Plugin: [vite-plugin-dts](https://www.npmjs.com/package/vite-plugin-dts)

**Package Manager**

- [Yarn](https://yarnpkg.com/) _(v3)_

  - Doc: [Zero-installs](https://yarnpkg.com/features/caching#zero-installs)

**Testing**

- [Vitest](https://vitest.dev/)

  - Convention: Unit tests for user cases are stored in the `tests/units` directory

  - Convention: Unit tests for individual functions are placed alongside their respective implementations ([In-source testing](https://vitest.dev/guide/in-source.html))

  - Convention: The file `tests/setup.ts` is executed before each test file

  - Convention: The `tests/tsconfig.json` file configures TypeScript for testing

- GitHub Action: `.github/workflows/test.yml`

**Linters**

- [ESLint](https://eslint.org/)

- [Prettier](https://prettier.io/)

- [Commitlint](https://commitlint.js.org/#/)

- [Husky](https://typicode.github.io/husky/#/)

- [LintStaged](https://github.com/okonet/lint-staged)

**Code Generator**

- [Plop](https://plopjs.com/): A micro-generator framework that makes it easy for an entire team to create files with a level of uniformity

**Publish**

- [semantic-release](https://semantic-release.gitbook.io/): Fully automated version management and package publishing

  - GitHub Action: `.github/workflows/release-package.yml`

  - Env Variables: `NPM_TOKEN` is required to publish a package to the npm registry

  - Additional Plugin: [semantic-release-yarn](https://github.com/hongaar/semantic-release-yarn)

  - Additional Plugin: [@semantic-release/changelog](https://github.com/semantic-release/changelog)

## Development Conventions

### Branches

- `main`: Used for stable features & production releases

- `dev`: Used for features under development

- `next`: Used for experimental features