From c2bd44a2e9a3ed53879833609787ccb3e5207a1b Mon Sep 17 00:00:00 2001 From: Hugo Dias Date: Fri, 27 Oct 2023 10:54:21 +0100 Subject: [PATCH] chore: add readme --- README.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++- readme copy.md | 73 ------------------------------------------------- 2 files changed, 73 insertions(+), 74 deletions(-) delete mode 100644 readme copy.md diff --git a/README.md b/README.md index d5af9b4..8184423 100644 --- a/README.md +++ b/README.md @@ -1 +1,73 @@ -# js-template +# Monorepo template + +Monorepo template for Javascript projects. + +## Usage (remove this section) + +### Features + +- Github workflows, templates, Code of Conduct, Contributing guidelines, Security Policy, Dependabot config, Codeowners and license. +- Dev container for Github Codespaces +- JS setup with ESLint, prettier, depcheck, typescript, typedoc, mocha and playwright-test. +- Documentation generated with typedoc and published with Github pages. +- Changelog, versioning and release management with [Release Please](https://github.com/googleapis/release-please). +- Optional pre-commit hooks with lint-staged and simple-git-hooks. +- VS Code settings and extensions. +- Examples and packages setup with pnpm workspaces. +- Codesandbox setup for examples. + +### Instructions + +- Add `GH_TOKEN` and `NPM_TOKEN` to secrets for CI workflows. +- Select _Github Actions_ for Github pages publishing. [Docs](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow) +- You may need to change workflow permissions to read/write to be able to publish pages with github actions. Go to Settings > Actions > General > Workflow permissions. +- You should enable on the repo + +#### Typescript + +Override the `tsconfig.json` in the package with the following: + +```json +{ + "compilerOptions": { + "noEmit": true, // for apps or anything that is not published to npm + "emitDeclarationOnly": true, // for TS with JSDocs + "module": "NodeNext", // for TS packages + "moduleResolution": "NodeNext" // for TS packages + } +} +``` + +## Packages + +- [package1](https://github.com/hugomrdias/hd-template/tree/master/packages/package1) - description +- [package2](https://github.com/hugomrdias/hd-template/tree/master/packages/package2) - description + +## Examples + +- [`demo`](https://github.com/hugomrdias/hd-template/tree/master/examples/demo) - description + +### Checkout examples + +You can use [Codesandbox](https://githubbox.com/hugomrdias/hd-template/tree/master/examples/demo) and start hacking right away. + +To clone it locally: + +```bash +npx tiged hugomrdias/hd-template/examples/demo demo +cd demo +pnpm install +pnpm dev +``` + +You can try any of the examples by replacing `demo` with the name of the example you want to try. + +## Contributing + +Read contributing guidelines [here](.github/CONTRIBUTING.md). + +[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/hd-template/examples) + +## License + +[MIT](./license) © [Hugo Dias](http://hugodias.me) diff --git a/readme copy.md b/readme copy.md deleted file mode 100644 index 8184423..0000000 --- a/readme copy.md +++ /dev/null @@ -1,73 +0,0 @@ -# Monorepo template - -Monorepo template for Javascript projects. - -## Usage (remove this section) - -### Features - -- Github workflows, templates, Code of Conduct, Contributing guidelines, Security Policy, Dependabot config, Codeowners and license. -- Dev container for Github Codespaces -- JS setup with ESLint, prettier, depcheck, typescript, typedoc, mocha and playwright-test. -- Documentation generated with typedoc and published with Github pages. -- Changelog, versioning and release management with [Release Please](https://github.com/googleapis/release-please). -- Optional pre-commit hooks with lint-staged and simple-git-hooks. -- VS Code settings and extensions. -- Examples and packages setup with pnpm workspaces. -- Codesandbox setup for examples. - -### Instructions - -- Add `GH_TOKEN` and `NPM_TOKEN` to secrets for CI workflows. -- Select _Github Actions_ for Github pages publishing. [Docs](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow) -- You may need to change workflow permissions to read/write to be able to publish pages with github actions. Go to Settings > Actions > General > Workflow permissions. -- You should enable on the repo - -#### Typescript - -Override the `tsconfig.json` in the package with the following: - -```json -{ - "compilerOptions": { - "noEmit": true, // for apps or anything that is not published to npm - "emitDeclarationOnly": true, // for TS with JSDocs - "module": "NodeNext", // for TS packages - "moduleResolution": "NodeNext" // for TS packages - } -} -``` - -## Packages - -- [package1](https://github.com/hugomrdias/hd-template/tree/master/packages/package1) - description -- [package2](https://github.com/hugomrdias/hd-template/tree/master/packages/package2) - description - -## Examples - -- [`demo`](https://github.com/hugomrdias/hd-template/tree/master/examples/demo) - description - -### Checkout examples - -You can use [Codesandbox](https://githubbox.com/hugomrdias/hd-template/tree/master/examples/demo) and start hacking right away. - -To clone it locally: - -```bash -npx tiged hugomrdias/hd-template/examples/demo demo -cd demo -pnpm install -pnpm dev -``` - -You can try any of the examples by replacing `demo` with the name of the example you want to try. - -## Contributing - -Read contributing guidelines [here](.github/CONTRIBUTING.md). - -[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/hd-template/examples) - -## License - -[MIT](./license) © [Hugo Dias](http://hugodias.me)