@adbayb/stack 0.0.0-next-798693b → 0.0.0-next-2a0b6a2

package/README.md

@@ -13,7 +13,7 @@
 - Support for several application templates (for now, only a default template is available, but others can be added later)
 - Standardized file structure including optional folder creation such as `examples`, `packages`, ...
 - Enable all project lifecycle steps with commands from the setup, check, fix, build, and test to the versioning and release
-- Built-in configuration preset setup (including Node/NPM runtime, Git ignore/hooks, TypeScript, ESLint, Prettier, EditorConfig, Renovate, Changesets, and VSCode)
+- Built-in configuration preset setup (including Node/NPM runtime, Git ignore/hooks, [TypeScript](./config/typescript/), [ESLint](./config/eslint), [Prettier](./config/prettier/), EditorConfig, Renovate, Changesets, and VSCode)
 - A welcoming environment for users and contributors with the continuous integration setup, and the creation of `README.md`, `CONTRIBUTING.md`, and GitHub template files (including issue and pull request ones), ...
 - An optimized development environment with command caching (no build needed if nothing changes)
 
@@ -85,7 +85,7 @@ flowchart TD
 
 - [Commits](https://www.conventionalcommits.org/)
 - [Scripts](https://conventionalscripts.org/)
-- [File Structure](https://nx.dev/concepts/more-concepts/folder-structure)
+- [File Structure](https://nx.dev/concepts/decisions/folder-structure)
   - Monorepo-first structure to:
     - Keep a consistent file structure pattern across templates (ease template familiarity and onboarding)
     - Ease examples setup

package/dist/index.mjs

@@ -1,7 +1,8 @@
 import { helpers, termost } from 'termost';
 import { existsSync, readdirSync, cpSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { resolve } from 'node:path';
+import { resolve, join } from 'node:path';
+import process from 'node:process';
 import { fdir } from 'fdir';
 import { mkdir, symlink, writeFile, chmod } from 'node:fs/promises';
 
@@ -51,7 +52,7 @@ ${input.body}
  * @example
  * resolveFromStackDirectory("./templates");
  */ const resolveFromStackDirectory = (path)=>{
-    return resolve(__dirname, "../", path);
+    return resolve(import.meta.dirname, "../", path);
 };
 const getNpmVersion = async ()=>{
     try {
@@ -326,7 +327,7 @@ const PRESERVE_FILES = [
     ".turbo"
 ];
 
-var version = "0.0.0-next-798693b";
+var version = "0.0.0-next-2a0b6a2";
 
 const VERSION = version;
 
@@ -354,7 +355,17 @@ const createCreateCommand = (program)=>{
     }).input({
         key: "inputUrl",
         label: "Where will it be stored? (Git remote URL)",
+        defaultValue: "git@github.com:adbayb/stack.git",
         type: "text"
+    }).input({
+        key: "inputTemplate",
+        label: "Which template you would like to apply?",
+        defaultValue: "single-project",
+        options: [
+            "single-project",
+            "multi-projects"
+        ],
+        type: "select"
     }).task({
         label: label$2("Checking pre-requisites"),
         async handler () {
@@ -398,8 +409,8 @@ const createCreateCommand = (program)=>{
         }
     }).task({
         label: label$2("Applying template"),
-        handler ({ data }) {
-            applyTemplate(data);
+        handler ({ data, inputTemplate }) {
+            applyTemplate(inputTemplate, data);
         }
     }).task({
         label: label$2("Installing dependencies"),
@@ -461,14 +472,15 @@ const createCreateCommand = (program)=>{
 const label$2 = (message)=>`${message} 🔨`;
 /**
  * A simple template engine to evaluate dynamic expressions and apply side effets (such as hydrating a content with values from an input object) on impacted template files.
+ * @param template - The selected template.
  * @param dataModel - Data model mapping the template expression key with its corresponding value.
  * @example
  * applyTemplate(
  * 	{ toReplace: "value" },
  * );
- */ const applyTemplate = (dataModel)=>{
+ */ const applyTemplate = (template, dataModel)=>{
     const templateExtension = ".tmpl";
-    const templateRootPath = resolveFromStackDirectory("./template");
+    const templateRootPath = resolveFromStackDirectory(join("./templates", template));
     const projectRootPath = resolveFromProjectDirectory("./");
     const templateExpressionRegExp = /{{(.*?)}}/g;
     const evaluate = (content)=>{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adbayb/stack",
-  "version": "0.0.0-next-798693b",
+  "version": "0.0.0-next-2a0b6a2",
   "description": "My opinionated JavaScript-based toolchain",
   "publishConfig": {
     "access": "public"
@@ -9,7 +9,7 @@
     "bin",
     "config",
     "dist",
-    "template"
+    "templates"
   ],
   "bin": {
     "stack": "./bin/index.mjs"
@@ -76,7 +76,7 @@
     "typescript": "^5.6.3"
   },
   "scripts": {
-    "prestart": "echo 'prestart'",
+    "prestart": "pnpm build",
     "start": "./bin/index.mjs",
     "build": "quickbundle build",
     "watch": "quickbundle watch"

package/{template → templates/multi-projects}/.editorconfig

@@ -1,4 +1,4 @@
 root = true
 
 [*]
-indent_size = 4
+indent_size = 2

package/templates/multi-projects/applications/README.md

@@ -0,0 +1,6 @@
+# Applications
+
+> [!note]
+> Optional folder that can be removed if there is no planned use case.
+
+A collection of application-like projects. An application is a runnable program (a command-line interface, a mobile/web application, ...).

package/{template → templates/multi-projects}/libraries/README.md

@@ -1,9 +1,3 @@
 # Libraries
 
-> [!note]
-> Optional folder that can be either:
->
-> - Kept if the root package needs to be moved into it (when several package types (applications, libraries, ...) need to be created and the root package is by its nature a library)
-> - Otherwise, removed if no planned use case
-
 A collection of internal and/or publishable libraries (referred to as packages in the Node ecosystem) that are leveraged during software development to implement/share a specific aspect/functionality. A library generally encapsulates highly cohesive modules together.

package/templates/multi-projects/libraries/{{projectName}}/package.json.tmpl

@@ -0,0 +1,39 @@
+{
+	"name": "{{projectName}}",
+	"description": "{{projectDescription}}",
+	"version": "0.0.0",
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist"
+	],
+	"sideEffects": false,
+	"type": "module",
+	"exports": {
+		".": {
+			"source": "./src/index.ts",
+			"types": "./dist/index.d.ts",
+			"require": "./dist/index.cjs",
+			"import": "./dist/index.mjs",
+			"default": "./dist/index.mjs"
+		}
+	},
+	"license": "MIT",
+	"author": "Ayoub Adib <adbayb@gmail.com> (https://twitter.com/adbayb)",
+	"bugs": "https://github.com/{{repoId}}/issues",
+	"homepage": "https://github.com/{{repoId}}/tree/main/{{projectName}}#readme",
+	"repository": {
+		"type": "git",
+		"url": "{{projectUrl}}",
+		"directory": "libraries/{{projectName}}"
+	},
+	"scripts": {
+		"prepublishOnly": "pnpm build",
+		"clean": "rm -rf dist",
+		"start": "pnpm watch",
+		"build": "pnpm clean && quickbundle build",
+		"watch": "quickbundle watch",
+		"test": "vitest"
+	}
+}

package/templates/multi-projects/libraries/{{projectName}}/tsconfig.json

@@ -0,0 +1,5 @@
+{
+	"extends": "../../tsconfig.json",
+	"include": ["src"],
+	"exclude": ["node_modules", "dist"]
+}

package/{template → templates/multi-projects}/pnpm-workspace.yaml.tmpl

@@ -3,4 +3,3 @@ packages:
     - "examples/*"
     - "libraries/*"
     - "tools/*"
-    - "{{projectName}}"

package/{template → templates/multi-projects}/tools/README.md

@@ -1,6 +1,6 @@
 # Tools
 
 > [!note]
-> Optional folder that can be removed if no internal scripts or packages for development purposes
+> Optional folder that can be removed if no internal scripts or packages for development purposes.
 
 A collection of internal packages and scripts that act locally on the repository codebase.

package/templates/single-project/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/templates/single-project/.changeset/config.json.tmpl

@@ -0,0 +1,13 @@
+{
+	"$schema": "https://raw.githubusercontent.com/changesets/changesets/main/packages/config/schema.json",
+	"access": "public",
+	"baseBranch": "main",
+	"changelog": ["@changesets/changelog-github", { "repo": "{{repoId}}" }],
+	"commit": false,
+	"ignore": ["@examples/*"],
+	"updateInternalDependencies": "patch",
+	"___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
+		"onlyUpdatePeerDependentsWhenOutOfRange": true,
+		"updateInternalDependents": "out-of-range"
+	}
+}

package/templates/single-project/.changeset/welcome.md.tmpl

@@ -0,0 +1,5 @@
+---
+"{{projectName}}": minor
+---
+
+v0.1.0 release 🚀

package/templates/single-project/.commitlintrc.json

@@ -0,0 +1,3 @@
+{
+	"extends": ["@commitlint/config-conventional"]
+}

package/templates/single-project/.editorconfig

@@ -0,0 +1,4 @@
+root = true
+
+[*]
+indent_size = 2

package/templates/single-project/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: "🐛 Bug Report"
+about: Report a reproducible bug or regression.
+title: "Bug: "
+labels: ["bug", "triage"]
+---
+
+## Description
+
+<!--
+  Please provide a clear and concise description of what the bug is with the current and expected behavior(s). Include
+  screenshots if needed. Please test using the latest version of the relevant package to make sure your issue has not already been fixed.
+-->
+
+## Reproduction
+
+<!--
+  Issues without reproduction steps or code examples may be immediately closed as not actionable. Your bug will get fixed much faster if we can run your code. You may provide a screenshot of the application if you think it is relevant to your bug report. Here are some tips for providing a minimal example: https://stackoverflow.com/help/mcve.
+-->
+
+## Environment
+
+<!--
+  Please provide the environment you discovered this bug in.
+  It must include following informations:
+    - OS [eg. Android, iOS, mac OS, Windows, ...]
+    - Browser [eg. Chrome@110, Safari@16, ...]
+-->
+
+## Additional context
+
+<!--
+  Add any other context about the problem (eg. issue URL, related issues, documentation, etc...)
+-->

package/templates/single-project/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,4 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 🤔 Questions and Help
+    about: Issues are dedicated to bugs, if you have any question, please use the dedicated GitHub discussion category.

package/templates/single-project/.github/PULL_REQUEST_TEMPLATE.md.tmpl

@@ -0,0 +1,29 @@
+<!--
+  Thanks for submitting a pull request!
+  We appreciate you spending the time to work on these changes. Before requesting reviews, please make sure that:
+
+  1. Your contribution follows coding conventions
+  2. Some valuable tests have been added
+  3. For non-internal change, a changelog entry is added
+
+  Learn more about contributing [here](https://github.com/{{repoId}}/blob/main/CONTRIBUTING.md)
+-->
+
+## Description
+
+Please include a concise summary of the change with the relevant context and main highlights:
+
+-   [ ] What I've done 1
+-   [ ] What I've done 2...
+
+## Screenshots
+
+| Before | After |
+| ------ | ----- |
+| Image  | Image |
+
+## Resources
+
+-   Issue (GitHub, ...)
+-   Specification (ADRs, RFCs, ...)
+-   ...

package/templates/single-project/.github/renovate.json

@@ -0,0 +1,69 @@
+{
+	"$schema": "https://docs.renovatebot.com/renovate-schema.json",
+	"extends": [
+		":automergeAll",
+		":automergePr",
+		":automergeRequireAllStatusChecks",
+		":enableVulnerabilityAlerts",
+		":label(dependencies)",
+		":maintainLockFilesMonthly",
+		":prConcurrentLimit10",
+		":rebaseStalePrs",
+		":semanticCommits",
+		":semanticCommitScopeDisabled",
+		":semanticPrefixFixDepsChoreOthers",
+		":timezone(Europe/Paris)",
+		"npm:unpublishSafe",
+		"replacements:all",
+		"schedule:monthly",
+		"workarounds:all"
+	],
+	"commitBodyTable": true,
+	"platformAutomerge": false,
+	"ignoreDeps": [],
+	"packageRules": [
+		{
+			"matchPackagePatterns": ["*"],
+			"rangeStrategy": "auto"
+		},
+		{
+			"matchDepTypes": ["devDependencies"],
+			"rangeStrategy": "pin"
+		},
+		{
+			"matchDepTypes": ["dependencies"],
+			"rangeStrategy": "bump"
+		},
+		{
+			"description": "Synchronize CircleCI Docker image version with the Node.js one",
+			"matchPackageNames": ["cimg/node"],
+			"versioning": "node"
+		},
+		{
+			"groupName": "package dependencies",
+			"matchManagers": ["npm"],
+			"matchDepTypes": [
+				"dependencies",
+				"devDependencies",
+				"optionalDependencies",
+				"peerDependencies"
+			]
+		},
+		{
+			"groupName": "infrastructure dependencies",
+			"matchManagers": [
+				"circleci",
+				"github-actions",
+				"dockerfile",
+				"terraform",
+				"terraform-version",
+				"docker-compose",
+				"kubernetes"
+			]
+		},
+		{
+			"groupName": "engine dependencies",
+			"matchPackagePatterns": ["node", "pnpm"]
+		}
+	]
+}

package/templates/single-project/.github/workflows/continuous_delivery.yml

@@ -0,0 +1,53 @@
+name: Continous delivery
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  integrate:
+    uses: ./.github/workflows/workflow.yml
+  release:
+    timeout-minutes: 5
+    needs: integrate
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - name: Get node version
+        run: echo "version=$(cat .nvmrc)" >> $GITHUB_OUTPUT
+        id: node
+      - name: Setup node ${{ steps.node.outputs.version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ steps.node.outputs.version }}
+          cache: pnpm
+      - name: Setup .npmrc
+        run: |
+          cat << EOF > "$HOME/.npmrc"
+            //registry.npmjs.org/:_authToken=$NPM_TOKEN
+          EOF
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Publish pre-release version(s)
+        run: |
+          pnpm --recursive exec pnpm version "$(pnpm show ./ version)-next-${GITHUB_SHA::7}"
+          pnpm --recursive exec pnpm publish --tag next --no-git-checks
+      - name: Prepare or Publish stable version(s)
+        uses: changesets/action@v1
+        with:
+          commit: "chore: release package(s)"
+          title: "chore: release package(s)"
+          version: pnpm release:version
+          publish: pnpm release:publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/templates/single-project/.github/workflows/continuous_integration.yml

@@ -0,0 +1,9 @@
+name: Continuous integration
+
+on:
+  push:
+    branches-ignore: main
+
+jobs:
+  main:
+    uses: ./.github/workflows/workflow.yml

package/templates/single-project/.github/workflows/conventional_commit.yml

@@ -0,0 +1,48 @@
+name: Conventional commit
+
+on:
+  pull_request:
+    types: [opened, edited]
+
+jobs:
+  main:
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        id: check_pr_rule
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            build
+            chore
+            ci
+            docs
+            feat
+            fix
+            perf
+            refactor
+            revert
+            style
+            test
+          requireScope: false
+          subjectPattern: ^(?![A-Z]).+$
+          subjectPatternError: The subject must start with a lowercase character
+      # Create a sticky comment to display the detailed error
+      - uses: marocchino/sticky-pull-request-comment@v2
+        if: always() && (steps.check_pr_rule.outputs.error_message != null)
+        with:
+          header: check_pr_comment
+          message: |
+            Pull request titles must follow the [Conventional Commits specification](https://www.conventionalcommits.org/).
+            Please adjust your title following:
+            ```
+            ${{ steps.check_pr_rule.outputs.error_message }}
+            ```
+      # Delete a previous comment when the issue has been resolved
+      - if: ${{ steps.check_pr_rule.outputs.error_message == null }}
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          header: check_pr_comment
+          delete: true

package/templates/single-project/.github/workflows/dependency_changelog.yml

@@ -0,0 +1,117 @@
+name: Dependency changelog
+
+on:
+  pull_request_target:
+    paths:
+      - "**/pnpm-lock.yaml"
+
+jobs:
+  main:
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    if: github.actor == 'renovate[bot]'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+          ref: ${{ github.head_ref }}
+      - name: Configure Git
+        run: |
+          git config --global user.email adbayb@gmail.com
+          git config --global user.name 'Ayoub Adib'
+      - name: Create changelog entry
+        uses: actions/github-script@v7
+        # Credits to https://github.com/backstage/backstage/blob/bcc11651add5a2589898dfb9d665ebb9d412201b/.github/workflows/sync_renovate-changesets.yml
+        with:
+          script: |
+            const { promises: fs } = require("fs");
+
+            async function getPackagesNames(files) {
+              const names = [];
+
+              for (const file of files) {
+                const data = JSON.parse(await fs.readFile(file, "utf8"));
+                
+                if (!data.private) {
+                  names.push(data.name);
+                }
+              }
+
+              return names;
+            }
+
+            async function createChangeset(fileName, packageBumps, packages) {
+              let message = "";
+
+              for (const [pkg, bump] of packageBumps) {
+                message = message + `Updated dependency \`${pkg}\` to \`${bump}\`.\n`;
+              }
+
+              const pkgs = packages.map((pkg) => `"${pkg}": minor`).join("\n");
+              const body = `---\n${pkgs}\n---\n\n${message.trim()}\n`;
+              
+              await fs.writeFile(fileName, body);
+            }
+
+            async function getBumps(files) {
+              const bumps = new Map();
+
+              for (const file of files) {
+                const { stdout: changes } = await exec.getExecOutput("git", [
+                  "show",
+                  file,
+                ]);
+
+                for (const change of changes.split("\n")) {
+                  if (!change.match(/^\+\s/)) {
+                    continue;
+                  }
+
+                  const match = change.match(/"(.*?)"/g);
+
+                  bumps.set(match[0].replace(/"/g, ""), match[1].replace(/"/g, ""));
+                }
+              }
+
+              return bumps;
+            }
+
+            const branch = await exec.getExecOutput("git branch --show-current");
+
+            if (!branch.stdout.startsWith("renovate/")) {
+              console.log("Not a renovate branch, skipping");
+
+              return;
+            }
+
+            const diffOutput = await exec.getExecOutput("git diff --name-only HEAD~1");
+            const diffFiles = diffOutput.stdout.split("\n");
+
+            if (diffFiles.find((f) => f.startsWith(".changeset"))) {
+              console.log("Changeset already exists, skipping");
+
+              return;
+            }
+
+            const files = diffFiles
+              .filter((file) => file !== "package.json") // skip root package.json
+              .filter((file) => file.includes("package.json"));
+            const packageNames = await getPackagesNames(files);
+
+            if (!packageNames.length) {
+              console.log("No package.json changes to published packages, skipping");
+
+              return;
+            }
+
+            const { stdout: shortHash } = await exec.getExecOutput(
+              "git rev-parse --short HEAD"
+            );
+            const fileName = `.changeset/renovate-${shortHash.trim()}.md`;
+            const packageBumps = await getBumps(files);
+
+            await createChangeset(fileName, packageBumps, packageNames);
+            await exec.exec("git", ["add", fileName]);
+            await exec.exec("git commit -C HEAD --amend --no-edit");
+            await exec.exec("git push --force");

package/templates/single-project/.github/workflows/workflow.yml

@@ -0,0 +1,96 @@
+name: Main shareable workflow
+
+on:
+  workflow_call:
+
+jobs:
+  install:
+    timeout-minutes: 5
+    name: Install
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the code
+        uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - name: Get node version
+        run: echo "version=$(cat .nvmrc)" >> $GITHUB_OUTPUT
+        id: node
+      - name: Setup node ${{ steps.node.outputs.version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ steps.node.outputs.version }}
+          cache: pnpm
+      - name: Setup cache
+        id: cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ./node_modules
+            ./turbo
+          key: ${{ runner.os }}-cache-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-cache-
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+  build:
+    timeout-minutes: 5
+    needs: install
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - name: Get node version
+        run: echo "version=$(cat .nvmrc)" >> $GITHUB_OUTPUT
+        id: node
+      - name: Setup node ${{ steps.node.outputs.version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ steps.node.outputs.version }}
+          cache: pnpm
+      - name: Setup cache
+        id: cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ./node_modules
+            ./turbo
+          key: ${{ runner.os }}-cache-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-cache-
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Build
+        run: pnpm build
+  check:
+    timeout-minutes: 5
+    needs: build
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the code
+        uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - name: Get node version
+        run: echo "version=$(cat .nvmrc)" >> $GITHUB_OUTPUT
+        id: node
+      - name: Setup node ${{ steps.node.outputs.version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ steps.node.outputs.version }}
+          cache: pnpm
+      - name: Setup cache
+        id: cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ./node_modules
+            ./turbo
+          key: ${{ runner.os }}-cache-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-cache-
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Check (static analysis including linters, types, and commit message)
+        run: pnpm check

package/templates/single-project/.gitignore.tmpl

@@ -0,0 +1,134 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Others
+.DS_Store
+.turbo

package/templates/single-project/.npmrc.tmpl

@@ -0,0 +1,8 @@
+save-exact=true
+public-hoist-pattern[]=*changesets*
+public-hoist-pattern[]=*commitlint*
+public-hoist-pattern[]=*eslint*
+public-hoist-pattern[]=*prettier*
+public-hoist-pattern[]=*turbo*
+public-hoist-pattern[]=*typescript*
+public-hoist-pattern[]=*types*

package/templates/single-project/.nvmrc.tmpl

@@ -0,0 +1 @@
+{{nodeVersion}}

package/templates/single-project/.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+	"recommendations": [
+		"dbaeumer.vscode-eslint",
+		"unifiedjs.vscode-mdx",
+		"yoavbls.pretty-ts-errors",
+		"znck.grammarly"
+	]
+}

package/templates/single-project/.vscode/settings.json

@@ -0,0 +1,27 @@
+{
+	"eslint.validate": [
+		"javascript",
+		"javascriptreact",
+		"typescript",
+		"typescriptreact",
+		"markdown",
+		"mdx",
+		"astro"
+	],
+	"editor.codeActionsOnSave": {
+		"source.fixAll.eslint": "explicit"
+	},
+	"workbench.editor.labelFormat": "short",
+	"typescript.tsdk": "node_modules/typescript/lib",
+	"typescript.enablePromptUseWorkspaceTsdk": true,
+	"grammarly.selectors": [
+		{
+			"language": "mdx",
+			"scheme": "file"
+		},
+		{
+			"language": "md",
+			"scheme": "file"
+		}
+	]
+}

package/templates/single-project/CONTRIBUTING.md.tmpl

@@ -0,0 +1,21 @@
+# Contributing
+
+Thanks for showing interest to contribute to `{{projectName}}` 🥳.
+We are open to contributions, we look forward to improving it with your help!
+
+Here you will find guidelines that will help you to know how to contribute to this repository.
+It can be about reporting an issue, proposing a bug fix, adding some features, and even more...
+
+## 🥇 Your first contribution
+
+TODO
+
+## 🗂️ Conventions
+
+TODO
+
+## 👨‍🍳 Recipes
+
+### How to XXX?
+
+TODO

package/templates/single-project/LICENSE.tmpl

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{licenseYear}} Ayoub Adib
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/single-project/eslint.config.js.tmpl

@@ -0,0 +1 @@
+export { default } from "@adbayb/stack/eslint";

package/templates/single-project/examples/README.md

@@ -0,0 +1,6 @@
+# Examples
+
+A collection of examples to:
+
+- Showcase the artifacts' usage (mainly for libraries)
+- Source some scenarios for testing purposes (test cases)

package/templates/single-project/examples/default/package.json.tmpl

@@ -0,0 +1,14 @@
+{
+	"private": true,
+	"name": "@examples/default",
+	"version": "0.0.0",
+	"scripts": {
+		"start": "tsx ./src/index.ts"
+	},
+	"dependencies": {
+		"{{projectName}}": "workspace:^"
+	},
+	"devDependencies": {
+		"tsx": "4.19.1"
+	}
+}

package/templates/single-project/examples/default/src/index.ts.tmpl

@@ -0,0 +1,3 @@
+import { HELLO_WORLD } from "{{projectName}}";
+
+console.log(HELLO_WORLD);

package/templates/single-project/examples/default/tsconfig.json

@@ -0,0 +1,5 @@
+{
+	"extends": "../../tsconfig.json",
+	"include": ["src"],
+	"exclude": ["node_modules", "dist"]
+}

package/templates/single-project/package.json.tmpl

@@ -0,0 +1,27 @@
+{
+	"name": "root",
+	"private": true,
+	"version": "0.0.0",
+	"type": "module",
+	"scripts": {
+		"prepare": "stack install",
+		"clean": "stack clean",
+		"check": "stack check",
+		"fix": "stack fix",
+		"start": "stack start",
+		"build": "stack build",
+		"watch": "stack watch",
+		"test": "stack test",
+		"release:log": "stack release --log",
+		"release:version": "stack release --tag",
+		"release:publish": "stack release --publish"
+	},
+	"prettier": "@adbayb/stack/prettier",
+	"packageManager": "pnpm@{{npmVersion}}",
+	"engines": {
+		"node": ">=20.0.0",
+		"pnpm": ">=9.0.0",
+		"npm": "please-use-pnpm",
+		"yarn": "please-use-pnpm"
+	}
+}

package/templates/single-project/pnpm-workspace.yaml.tmpl

@@ -0,0 +1,4 @@
+packages:
+    - "examples/*"
+    - "tools/*"
+    - "{{projectName}}"

package/templates/single-project/tools/README.md

@@ -0,0 +1,6 @@
+# Tools
+
+> [!note]
+> Optional folder that can be removed if no internal scripts or packages for development purposes.
+
+A collection of internal packages and scripts that act locally on the repository codebase.

package/templates/single-project/tsconfig.json

@@ -0,0 +1,4 @@
+{
+	"extends": "@adbayb/stack/typescript",
+	"exclude": ["node_modules", "**/node_modules", "**/dist"]
+}

package/templates/single-project/turbo.json

@@ -0,0 +1,24 @@
+{
+	"$schema": "https://turborepo.org/schema.json",
+	"pipeline": {
+		"build": {
+			"dependsOn": ["^build"],
+			"outputs": ["dist/**"]
+		},
+		"start": {
+			"dependsOn": ["build"],
+			"cache": false,
+			"persistent": true
+		},
+		"watch": {
+			"dependsOn": ["^build"],
+			"cache": false,
+			"persistent": true
+		},
+		"test": {
+			"dependsOn": ["build"],
+			"cache": false,
+			"persistent": true
+		}
+	}
+}

package/templates/single-project/{{projectName}}/README.md.tmpl

@@ -0,0 +1,42 @@
+<br>
+<div align="center">
+    <h1>📦 {{projectName}}</h1>
+    <strong>{{projectDescription}}</strong>
+</div>
+<br>
+<br>
+
+## ✨ Features
+
+TODO
+
+<br>
+
+## 🚀 Usage
+
+This section introduces the `{{projectName}}` essentials by walking through its main commands:
+
+0️⃣ ...
+1️⃣ ...
+2️⃣ ...
+3️⃣ ...
+
+<br>
+
+## 🏗️ Architecture
+
+TODO
+
+<br>
+
+## ✍️ Contribution
+
+We're open to new contributions, you can find more details [here](https://github.com/{{repoId}}/blob/main/CONTRIBUTING.md).
+
+<br>
+
+## 📖 License
+
+[MIT](https://github.com/{{repoId}}/blob/main/LICENSE "License MIT")
+
+<br>

package/templates/single-project/{{projectName}}/src/index.test.ts.tmpl

@@ -0,0 +1,5 @@
+import { describe, test } from "vitest";
+
+describe.todo("xxx", () => {
+	test.todo("should xxx");
+});

package/templates/single-project/{{projectName}}/src/index.ts

@@ -0,0 +1 @@
+export const HELLO_WORLD = "Hello 👋, please replace me!";

package/template/applications/README.md

@@ -1,9 +0,0 @@
-# Applications
-
-> [!note]
-> Optional folder that can be either:
->
-> - Kept if the root package needs to be moved into it (when several package types (applications, libraries, ...) need to be created and the root package is by its nature an application)
-> - Otherwise, removed if no planned use case
-
-A collection of application-like projects. An application is a runnable program (a command-line interface, a mobile/web application, ...).