chore(release): 1.9.0 [skip ci]

# [1.9.0](https://github.com/chenasraf/simple-scaffold/compare/v1.8.0...v1.9.0) (2024-01-02) ### Features * add --recurse-submodules to git clone ([cbaf130](cbaf130a0c))
ci: fix actions
2026-05-18 01:29:09 +00:00 · 2024-01-02 00:20:20 +00:00 · 2024-01-02 02:19:46 +02:00 · 2024-01-02 02:19:46 +02:00 · 2024-01-02 02:19:46 +02:00 · 2024-01-02 02:19:46 +02:00
33 changed files with 6298 additions and 7044 deletions
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -1,4 +1,4 @@
-name: Build Documentation
+name: Documentation

 on:
  push:
@@ -6,15 +6,24 @@ on:
 jobs:
  docs:
    runs-on: ubuntu-latest
-    if: "!contains(github.event.head_commit.message, '[skip ci]') && !contains(github.event.head_commit.message, '[skip docs]')"
+    if: "contains(github.event.head_commit.message, 'chore(release)')"
    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
        with:
          node-version: "18.x"
-      - run: yarn install --frozen-lockfile
-      - run: yarn build-docs
-      - uses: peaceiris/actions-gh-pages@v3
+      - name: Install PNPM
+        run: npm i -g pnpm
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Build Docs
+        run: pnpm build-docs
+      - name: Deploy on GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./docs
--- a/.github/workflows/pull_requests.yml
+++ b/.github/workflows/pull_requests.yml
@@ -2,16 +2,24 @@ name: Pull Requests

 on:
  pull_request:
-    branches: [master, develop]
+    branches: [master, pre, develop]
 jobs:
  build:
    runs-on: ubuntu-latest
-    if: "!contains(github.event.head_commit.message, '[skip ci]')"
    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
        with:
          node-version: "18.x"
-      - run: yarn install --frozen-lockfile
-      - run: yarn build
-      - run: yarn test
+      - name: Install PNPM
+        run: npm i -g pnpm
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Run Tests
+        run: pnpm test
+      - name: Build Package
+        run: pnpm build
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,22 +1,40 @@
-name: Semantic Release
+name: Release

 on:
  push:
-    branches: [master, develop, feat/*, fix/*]
+    branches: [master, pre, develop]
+permissions:
+  contents: read # for checkout
 jobs:
-  build:
+  release:
+    name: Release
    runs-on: ubuntu-latest
-    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    permissions:
+      contents: write # to be able to publish a GitHub release
+      issues: write # to be able to comment on released issues
+      pull-requests: write # to be able to comment on released pull requests
+      id-token: write # to enable use of OIDC for npm provenance
    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
        with:
          node-version: "18.x"
-      - run: yarn install --frozen-lockfile
-      - run: yarn test
-      - run: yarn build
-      - run: yarn semantic-release
-        if: "!contains(github.event.head_commit.message, '[skip publish]')"
+      - name: Install PNPM
+        run: npm i -g pnpm
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Run Tests
+        run: pnpm test
+      - name: Build Package
+        run: pnpm build
+      - name: Pack
+        run: cd ./dist && pnpm pack --pack-destination=../
+      - name: Semantic Release
+        run: npx semantic-release
        env:
          NPM_TOKEN: "${{ secrets.NPM_TOKEN }}"
          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -14,9 +14,6 @@
    "variabletoken"
  ],
  "[markdown]": {
-    "editor.rulers": [
-      87,
-      100
-    ],
-  },
+    "editor.rulers": [87, 100]
+  }
 }
--- a/.vscode/tasks.json
+++ b/.vscode/tasks.json
@@ -14,7 +14,7 @@
      "problemMatcher": []
    },
    {
-      "command": "yarn typedoc --watch",
+      "command": "pnpm typedoc --watch",
      "label": "typedoc --watch",
      "type": "shell",
      "problemMatcher": []
@@ -32,8 +32,8 @@
      "problemMatcher": []
    },
    {
-      "command": "yarn test --watchAll",
-      "label": "yarn test --watchAll",
+      "command": "pnpm test --watchAll",
+      "label": "pnpm test --watchAll",
      "type": "shell",
      "problemMatcher": []
    },
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,17 +1,131 @@
 # Change Log

-## [1.3.0](https://github.com/chenasraf/simple-scaffold/compare/v1.2.0...v1.3.0) (2023-04-25)
+# [1.9.0](https://github.com/chenasraf/simple-scaffold/compare/v1.8.0...v1.9.0) (2024-01-02)


 ### Features

-* load scaffold config from files ([c398976](https://github.com/chenasraf/simple-scaffold/commit/c3989769fee445c9183ff5e5b3892c4e9fb66a9e))
+* add --recurse-submodules to git clone ([cbaf130](https://github.com/chenasraf/simple-scaffold/commit/cbaf130a0cce45a2d20a3c2d132ac98e2f105b4f))
+
+## [1.8.0](https://github.com/chenasraf/simple-scaffold/compare/v1.7.2...v1.8.0) (2023-11-29)


 ### Bug Fixes

-* config option should not be mandatory ([3db6a91](https://github.com/chenasraf/simple-scaffold/commit/3db6a918f13d9300efa2fcb4a356d004475ab91c))
-* export config file type ([4302eb5](https://github.com/chenasraf/simple-scaffold/commit/4302eb5ce35ed6cf1dc80dfb92790c3fdd96f963))
+* **config:** fn config load ([457c904](https://github.com/chenasraf/simple-scaffold/commit/457c90470b0f138862469ff878c7e061c7afd18a)), closes [#63](https://github.com/chenasraf/simple-scaffold/issues/63)
+
+## [1.8.0-pre.1](https://github.com/chenasraf/simple-scaffold/compare/v1.7.2...v1.8.0-pre.1) (2023-11-27)
+
+
+### Bug Fixes
+
+* **config:** fn config load ([457c904](https://github.com/chenasraf/simple-scaffold/commit/457c90470b0f138862469ff878c7e061c7afd18a)), closes [#63](https://github.com/chenasraf/simple-scaffold/issues/63)
+
+## [1.7.2](https://github.com/chenasraf/simple-scaffold/compare/v1.7.1...v1.7.2) (2023-08-20)
+
+
+### Bug Fixes
+
+* windows path resolution ([98ee000](https://github.com/chenasraf/simple-scaffold/commit/98ee00031fc1ad67a53797a9e28e5c4759bc8bce))
+
+## [1.7.2-pre.1](https://github.com/chenasraf/simple-scaffold/compare/v1.7.1...v1.7.2-pre.1) (2023-08-15)
+
+
+### Bug Fixes
+
+* windows path resolution ([98ee000](https://github.com/chenasraf/simple-scaffold/commit/98ee00031fc1ad67a53797a9e28e5c4759bc8bce))
+
+## [1.7.1](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0...v1.7.1) (2023-06-07)
+
+### Bug Fixes
+
+- local config file load error
+  ([2b74239](https://github.com/chenasraf/simple-scaffold/commit/2b7423993be06b2375631642455c801ae2acf75f))
+
+## [1.7.0](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.5...v1.7.0) (2023-05-17)
+
+## [1.7.0-develop.7](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.6...v1.7.0-develop.7) (2023-06-07)
+
+### Bug Fixes
+
+- local config file load error
+  ([2b74239](https://github.com/chenasraf/simple-scaffold/commit/2b7423993be06b2375631642455c801ae2acf75f))
+
+## [1.7.0-develop.1](https://github.com/chenasraf/simple-scaffold/compare/v1.6.0...v1.7.0-develop.1) (2023-05-09)
+
+### Features
+
+- function config file
+  ([02a8ba1](https://github.com/chenasraf/simple-scaffold/commit/02a8ba16cd6ee31806532845cb5ddbe0f5abf7de))
+
+### Bug Fixes
+
+- use path.normalize
+  ([565090a](https://github.com/chenasraf/simple-scaffold/commit/565090a951e13dd222f2f802df717e7cb6ca0a73))
+
+## [1.6.0](https://github.com/chenasraf/simple-scaffold/compare/v1.6.0-develop.1...v1.6.0) (2023-05-05)
+
+## [1.6.0-develop.1](https://github.com/chenasraf/simple-scaffold/compare/v1.5.0...v1.6.0-develop.1) (2023-05-04)
+
+### Features
+
+- node.js function for remote configs
+  ([ce5adbe](https://github.com/chenasraf/simple-scaffold/commit/ce5adbe0f898a86db6046d7f66d83dfcaa519ad2))
+
+### Bug Fixes
+
+- move dependency to dev dependency
+  ([d916d88](https://github.com/chenasraf/simple-scaffold/commit/d916d88384054e6c6b40e6299073f1d1acb4d29d))
+
+## [1.5.0](https://github.com/chenasraf/simple-scaffold/compare/v1.5.0-develop.1...v1.5.0) (2023-05-02)
+
+## [1.5.0-develop.1](https://github.com/chenasraf/simple-scaffold/compare/v1.4.0...v1.5.0-develop.1) (2023-05-02)
+
+### Features
+
+- add github remote templates
+  ([f961c13](https://github.com/chenasraf/simple-scaffold/commit/f961c13da15320b42540773ed958cdc3f97e4502))
+- support for remote template configs
+  ([05487f4](https://github.com/chenasraf/simple-scaffold/commit/05487f4d1e3b05f1d695242bb54427ee2fbdf247))
+
+## [1.4.0](https://github.com/chenasraf/simple-scaffold/compare/v1.3.2...v1.4.0) (2023-04-28)
+
+### Features
+
+- add `--key` | `-k` to config loader
+  ([6c5ba0b](https://github.com/chenasraf/simple-scaffold/commit/6c5ba0bc916fb1d59240d2eaa1abedc74527a974))
+
+## [1.3.2](https://github.com/chenasraf/simple-scaffold/compare/v1.3.1...v1.3.2) (2023-04-28)
+
+### Bug Fixes
+
+- release build
+  ([2c23fa9](https://github.com/chenasraf/simple-scaffold/commit/2c23fa9dbb310cd0a31f09606798f96b95d66779))
+- release build asset
+  ([0bef2df](https://github.com/chenasraf/simple-scaffold/commit/0bef2df5f3aa800ad5f1094c0996108db9acce51))
+
+## [1.3.1](https://github.com/chenasraf/simple-scaffold/compare/v1.3.0...v1.3.1) (2023-04-28)
+
+### Bug Fixes
+
+- docs
+  ([6e19a86](https://github.com/chenasraf/simple-scaffold/commit/6e19a86190dd924058a48448aa6463569ef1125f))
+- remove old peer-dep
+  ([c7e2ef8](https://github.com/chenasraf/simple-scaffold/commit/c7e2ef862cb658feb1071ac120b185d8b34d6dd3))
+
+## [1.3.0](https://github.com/chenasraf/simple-scaffold/compare/v1.2.0...v1.3.0) (2023-04-25)
+
+### Features
+
+- load scaffold config from files
+  ([c398976](https://github.com/chenasraf/simple-scaffold/commit/c3989769fee445c9183ff5e5b3892c4e9fb66a9e))
+
+### Bug Fixes
+
+- config option should not be mandatory
+  ([3db6a91](https://github.com/chenasraf/simple-scaffold/commit/3db6a918f13d9300efa2fcb4a356d004475ab91c))
+- export config file type
+  ([4302eb5](https://github.com/chenasraf/simple-scaffold/commit/4302eb5ce35ed6cf1dc80dfb92790c3fdd96f963))

 ## [1.2.0](https://github.com/chenasraf/simple-scaffold/compare/v1.1.4...v1.2.0) (2023-04-24)

@@ -24,28 +138,14 @@

 - ci node version
  ([767d34c](https://github.com/chenasraf/simple-scaffold/commit/767d34c684516d4cea865b25e87c27c779bb79ce))
- semantic-release build dir
-  ([f7956dd](https://github.com/chenasraf/simple-scaffold/commit/f7956ddc786018905c48ccf1f21a3bb4657c3d75))
- support quote wrapping in append-data
-  ([4fecca8](https://github.com/chenasraf/simple-scaffold/commit/4fecca848347312d45d704f82f2bcb3822da9b06))
-
-## [1.1.4](https://github.com/chenasraf/simple-scaffold/compare/v1.1.3...v1.1.4) (2023-03-13)
-
-### Bug Fixes
-
 - github action node version
  ([7c19c53](https://github.com/chenasraf/simple-scaffold/commit/7c19c533376dc6904231e5cc51c7a4b2658c66e0))
 - github action node version
  ([94fec76](https://github.com/chenasraf/simple-scaffold/commit/94fec766165f7540c578dbf2d0aeeb6ea3969ad8))
-
-### Misc
-
- update typedoc version
-  ([c334396](https://github.com/chenasraf/simple-scaffold/commit/c334396d74414cbe0aba305c66dfad7fdeb88669))
- update dependencies
-  ([20400bd](https://github.com/chenasraf/simple-scaffold/commit/20400bd81dd43d457427675286c9964a8bc0d5f6))
- bump version number
-  ([8e432bf](https://github.com/chenasraf/simple-scaffold/commit/8e432bfb0b410dc0655c3924031bea2648a42ad0))
+- semantic-release build dir
+  ([f7956dd](https://github.com/chenasraf/simple-scaffold/commit/f7956ddc786018905c48ccf1f21a3bb4657c3d75))
+- support quote wrapping in append-data
+  ([4fecca8](https://github.com/chenasraf/simple-scaffold/commit/4fecca848347312d45d704f82f2bcb3822da9b06))

 ## [1.1.3](https://github.com/chenasraf/simple-scaffold/compare/v1.1.2...v1.1.3) (2023-03-11)

--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 <h2 align="center">

 [GitHub](https://github.com/chenasraf/simple-scaffold) |
-[Documentation](https://casraf.dev/simple-scaffold) |
+[Documentation](https://chenasraf.github.io/simple-scaffold) |
 [NPM](https://npmjs.com/package/simple-scaffold) | [casraf.dev](https://casraf.dev)

 ![version](https://img.shields.io/github/package-json/v/chenasraf/simple-scaffold/master?label=version)
@@ -33,15 +33,19 @@ lifting for you and start building your projects faster and more efficiently tod

 ## Quick Start

+### Local Templates
+
 The fastest way to get started is to use `npx` to immediately start a scaffold process.

 Prepare any templates you want to use - for example, in the directory `templates/component`; and use
 that in the CLI args. Here is a simple example file:

+Simple Scaffold will maintain any file and directory structure you try to generate.
+
 `templates/component/{{ pascalName name }}.tsx`

 ```tsx
-// Created: {{ now | 'yyyy-MM-dd' }}
+// Created: {{ now 'yyyy-MM-dd' }}
 import React from 'react'

 export default {{pascalCase name}}: React.FC = (props) => {
@@ -55,14 +59,14 @@ To generate the template output, run:

 ```shell
 # generate single component
-npx simple-scaffold@latest \
+$ npx simple-scaffold@latest \
  -t templates/component -o src/components PageWrapper
 ```

 This will immediately create the following file: `src/components/PageWrapper.tsx`

 ```tsx
-// Created: 2077/01/01
+// Created: 2077-01-01
 import React from 'react'

 export default PageWrapper: React.FC = (props) => {
@@ -72,6 +76,74 @@ export default PageWrapper: React.FC = (props) => {
 }
 ```

+### Configuration Files
+
+You can also use a config file to more easily maintain all your scaffold definitions.
+
+`scaffold.config.js`
+
+```js
+module.exports = {
+  // use "default" to avoid needing to specify key
+  // in this case the key is "component"
+  component: {
+    templates: ["templates/component"],
+    output: "src/components",
+    data: {
+      // ...
+    },
+  },
+}
+```
+
+Then call your scaffold like this:
+
+```shell
+$ npx simple-scaffold@latest -c scaffold.config.js PageWrapper
+```
+
+This will allow you to avoid needing to remember which configs are needed or to store them in a
+1-liner in `packqge.json` which can get pretty long and messy, which is harder to maintain.
+
+Also, this allows you to define more complex scaffolds with logic without having to use the Node.js
+API directly. (Of course you always have the option to still do so if you wish)
+
+See more at the [CLI documentation](https://chenasraf.github.io/simple-scaffold/pages/cli.html) and
+[Configuration Files](https://chenasraf.github.io/simple-scaffold/pages/configuration_files.html).
+
+### Remote Configurations
+
+Another quick way to start is to re-use someone else's (or your own) work using a template
+repository.
+
+A remote config can be loaded in one of these ways:
+
+- If it's on GitHub, you can use `-gh user/repository_name`
+- If it's on another git server (such as GitLab), you can use
+  `-c https://example.com/user/repository_name.git`
+
+Configurations can hold multiple scaffold groups. Each group can be accessed using its key by
+supplying the `--key` or `-k` argument, or by appending a hash and then the key name, like so:
+`-gh user/repository_name#key_name` - this also works for the `-c` flag.
+
+Here is an example for loading the example component templates in this very repository:
+
+```shell
+$ npx simple-scaffold@latest \
+  -gh chenasraf/simple-scaffold#scaffold.config.js:component \
+  PageWrapper
+
+# equivalent to:
+$ npx simple-scaffold@latest \
+  -c https://github.com/chenasraf/simple-scaffold.git#scaffold.config.js:component \
+  PageWrapper
+```
+
+When template name (`:component`) is omitted, `default` is used.
+
+See more at the [CLI documentation](https://chenasraf.github.io/simple-scaffold/pages/cli.html) and
+[Configuration Files](https://chenasraf.github.io/simple-scaffold/pages/configuration_files.html).
+
 ## Documentation

 See full documentation [here](https://chenasraf.github.io/simple-scaffold).
--- a/examples/.dotdir/README.md
+++ b/examples/.dotdir/README.md
@@ -0,0 +1,5 @@
+# {{ name }} Readme
+
+TO DO:
+
+- [ ] ...
--- a/examples/test-input/scaffold.config.js
+++ b/examples/test-input/scaffold.config.js
@@ -1,13 +0,0 @@
-/** @type {import('simple-scaffold').ScaffoldConfigFile} */
-module.exports = {
-  default: {
-    templates: ["examples/test-input/Component"],
-    output: "examples/test-output",
-    data: { property: "myProp", value: "10" },
-  },
-  component: {
-    templates: ["examples/test-input/Component"],
-    output: "examples/test-output",
-    data: { property: "myProp", value: "10" },
-  },
-}
--- a/jest.config.ts
+++ b/jest.config.ts
@@ -195,7 +195,7 @@ export default {
  // unmockedModulePathPatterns: undefined,

  // Indicates whether each individual test should be reported during the run
-  // verbose: undefined,
+  verbose: true,

  // An array of regexp patterns that are matched against all source file paths before re-running tests in watch mode
  // watchPathIgnorePatterns: [],
--- a/nodemon.json
+++ b/nodemon.json
@@ -0,0 +1,6 @@
+{
+  "ignore": ["**/*.test.ts", "**/*.spec.ts", ".git", "node_modules"],
+  "watch": ["src"],
+  "exec": "node -r tsconfig-paths/register -r ts-node/register ./src/index.ts",
+  "ext": "ts, js"
+}
--- a/package.json
+++ b/package.json
@@ -1,13 +1,14 @@
 {
  "name": "simple-scaffold",
-  "version": "1.3.0",
-  "description": "A simple command to generate any file structure, from single components to entire app boilerplates.",
-  "homepage": "https://casraf.dev/simple-scaffold",
+  "version": "1.9.0",
+  "description": "Generate any file structure - from single components to entire app boilerplates, with a single command.",
+  "homepage": "https://chenasraf.github.io/simple-scaffold",
  "repository": "https://github.com/chenasraf/simple-scaffold.git",
-  "author": "Chen Asraf <inbox@casraf.com>",
+  "author": "Chen Asraf <contact@casraf.dev>",
  "license": "MIT",
  "main": "index.js",
  "bin": "cmd.js",
+  "packageManager": "pnpm@8.6.2",
  "keywords": [
    "javascript",
    "cli",
@@ -20,51 +21,46 @@
    "scaffolding"
  ],
  "scripts": {
-    "clean": "rimraf dist/",
-    "build": "yarn clean && tsc && chmod -R +x ./dist && cp ./package.json ./README.md ./dist/",
+    "clean": "rm -rf dist/",
+    "build": "pnpm clean && tsc && chmod -R +x ./dist && cp ./package.json ./README.md ./dist/",
    "dev": "tsc --watch",
    "start": "node dist/scaffold.js",
    "test": "jest",
    "cmd": "node --trace-warnings dist/cmd.js",
-    "build-test": "yarn build && yarn test",
-    "build-cmd": "yarn build && yarn cmd",
+    "build-test": "pnpm build && pnpm test",
+    "build-cmd": "pnpm build && pnpm cmd",
    "build-docs": "typedoc",
-    "watch-docs": "yarn typedoc --watch",
-    "audit-fix": "npm_config_yes=true npx yarn-audit-fix --flow=convert",
-    "changelog": "conventional-changelog -p conventionalcommits -i CHANGELOG.md -s -r 0"
+    "watch-docs": "pnpm typedoc --watch",
+    "audit-fix": "pnpm audit --fix",
+    "changelog": "conventional-changelog -p conventionalcommits -i CHANGELOG.md -s -r 0; echo \"# Change Log\n\n$(cat CHANGELOG.md)\" > CHANGELOG.md"
  },
  "dependencies": {
    "chalk": "^4.1.2",
-    "date-fns": "^2.29.3",
-    "glob": "^9.2.1",
+    "date-fns": "^2.30.0",
+    "glob": "^10.3.3",
    "handlebars": "^4.7.7",
-    "lodash": "^4.17.21",
-    "massarg": "^1.0.7-pre.1",
-    "semantic-release-conventional-commits": "^3.0.0",
-    "util.promisify": "^1.1.1"
+    "massarg": "^1.0.7-pre.1"
  },
  "devDependencies": {
    "@knodes/typedoc-plugin-pages": "^0.23.4",
    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^6.0.3",
    "@semantic-release/git": "^10.0.1",
    "@semantic-release/release-notes-generator": "^10.0.3",
    "@types/jest": "^29.5.1",
-    "@types/lodash": "^4.14.171",
    "@types/mock-fs": "^4.13.1",
    "@types/node": "^18.16.0",
+    "@types/semantic-release": "^20.0.1",
    "conventional-changelog": "^3.1.25",
    "conventional-changelog-cli": "^2.2.2",
    "conventional-changelog-conventionalcommits": "^5.0.0",
    "jest": "^29.5.0",
    "mock-fs": "^5.2.0",
-    "rimraf": "^5.0.0",
    "semantic-release": "^21.0.1",
+    "semantic-release-conventional-commits": "^3.0.0",
    "ts-jest": "^29.1.0",
    "ts-node": "^10.9.1",
-    "typedoc": "^0.24.6",
+    "typedoc": "^0.24.7",
    "typescript": "^5.0.4"
-  },
-  "peerDependencies": {
-    "doc-theme": "file:./doc-theme"
  }
 }
--- a/pages/cli.md
+++ b/pages/cli.md
@@ -1,68 +1,73 @@
 ## Available flags

-The following is the help text from the `simple-scaffold` binary. To see this and more information
-anytime, add the `-h` or `--help` flag to your call, e.g. `npx simple-scaffold@latest -h`.
-
 ```text
 Usage: simple-scaffold [options]
-
-Create structured files based on templates.
-
-Options:
-
-  --help|-h                       Display help information
-
-  --name|-n                       Name to be passed to the generated files. {{name}} and
-                                  {{Name}} inside contents and file names will be replaced
-                                  accordingly.
-
-  --config|-c                     Filename to load config from instead of passing
-                                  arguments to CLI or using a Node.js script. You may pass a
-                                  JSON or JS file, with a relative or absolute path.
-
-  --output|-o                     Path to output to. If --create-sub-folder is enabled,
-                                  the subfolder will be created inside this path.
-                                  (default: current dir)
-
-  --templates|-t                  Template files to use as input. You may provide multiple
-                                  files, each of which can be a relative or absolute path, or a
-                                  glob pattern for multiple file matching easily.
-
-  --overwrite|-w                  Enable to override output files, even if they already
-                                  exist. (default: false)
-
-  --data|-d                       Add custom data to the templates. By default, only your
-                                  app name is included.
-
-  --append-data|-D                Append additional custom data to the templates, which
-                                  will overwrite --data, using an alternate syntax, which is
-                                  easier to use with CLI: -D key1=string -D key2:=raw
-
-  --create-sub-folder|-s          Create subfolder with the input name
-                                  (default: false)
-
-  --sub-folder-name-helper|-sh    Default helper to apply to subfolder name when using
-                                  `--create-sub-folder true`.
-
-  --quiet|-q                      Suppress output logs (Same as --verbose 0)
-                                  (default: false)
-
-  --verbose|-v                    Determine amount of logs to display. The values are:
-                                  0 (none) | 1 (debug) | 2 (info) | 3 (warn) | 4
-                                  (error). The provided level will display messages of
-                                  the same level or higher. (default:
-                                  2)
-
-  --dry-run|-dr                   Don't emit files. This is good for testing your
-                                  scaffolds and making sure they don't fail, without having to
-                                  write actual file contents or create directories.
-                                  (default: false)
 ```

+To see this and more information anytime, add the `-h` or `--help` flag to your call, e.g.
+`npx simple-scaffold@latest -h`.
+
+| Command \| alias                  |                                                                                                                                                                                                     |
+| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--help`\|`-h`                    | Display help information                                                                                                                                                                            |
+| `--name`\|`-n`                    | Name to be passed to the generated files. {{name}} and {{Name}} inside contents and file names will be replaced accordingly.                                                                        |
+| `--config`\|`-c`                  | Filename or HTTPS git URL to load config from instead of passing arguments to CLI or using a Node.js script.                                                                                        |
+| `--github`\|`-gh`                 | GitHub path to load config from instead of passing arguments to CLI or using a Node.js script.                                                                                                      |
+| `--key`\|`-k`                     | Key to load inside the config file. This overwrites the config key provided after the colon in --config (e.g. --config scaffold.cmd.js:component)                                                   |
+| `--output`\|`-o`                  | Path to output to. If --create-sub-folder is enabled, the subfolder will be created inside this path. (default: current dir)                                                                        |
+| `--templates`\|`-t`               | Template files to use as input. You may provide multiple files, each of which can be a relative or absolute path, or a glob pattern for multiple file matching easily.                              |
+| `--overwrite`\|`-w`               | Enable to override output files, even if they already exist. (default: false)                                                                                                                       |
+| `--data`\|`-d`                    | Add custom data to the templates. By default, only your app name is included.                                                                                                                       |
+| `--append-data`\|`-D`             | Append additional custom data to the templates, which will overwrite --data, using an alternate syntax, which is easier to use with CLI: -D key1=string -D key2:=raw                                |
+| `--create-sub-folder`\|`-s`       | Create subfolder with the input name (default: false)                                                                                                                                               |
+| `--sub-folder-name-helper`\|`-sh` | Default helper to apply to subfolder name when using `--create-sub-folder true`.                                                                                                                    |
+| `--quiet`\|`-q`                   | Suppress output logs (Same as --verbose 0) (default: false)                                                                                                                                         |
+| `--verbose`\|`-v`                 | Determine amount of logs to display. The values are: 0 (none) \| 1 (debug) \| 2 (info) \| 3 (warn) \| 4 (error). The provided level will display messages of the same level or higher. (default: 2) |
+| `--dry-run`\|`-dr`                | Don't emit files. This is good for testing your scaffolds and making sure they don't fail, without having to write actual file contents or create directories. (default: false)                     |
+
+## Examples:
+
 > See
-> [Configuration Files](https://chenasraf.githun.io/simple-scaffold/pages/docs/docs/configuration_files.md)
+> [Configuration Files](https://chenasraf.github.io/simple-scaffold/pages/docs/configuration_files.md)
 > for organizing multiple scaffold types into easy-to-maintain files

+Usage with config file
+
+```shell
+$ simple-scaffold -c scaffold.cmd.js --key component
+```
+
+Usage with GitHub config file
+
+```shell
+$ simple-scaffold -gh chenasraf/simple-scaffold --key component
+```
+
+Usage with https git URL (for non-GitHub)
+
+```shell
+$ simple-scaffold -c \
+      https://example.com/user/template.git#scaffold.cmd.js --key component
+```
+
+Full syntax with config path and template key (applicable to all above methods)
+
+```shell
+$ simple-scaffold -c scaffold.cmd.js:component MyComponent
+```
+
+Excluded template key, assumes 'default' key
+
+```shell
+$ simple-scaffold -c scaffold.cmd.js MyComponent
+```
+
+Shortest syntax for GitHub, assumes file 'scaffold.cmd.js' and template key 'default'
+
+```shell
+$ simple-scaffold -gh chenasraf/simple-scaffold MyComponent
+```
+
 You can also add this as a script in your `package.json`:

 ```json
--- a/pages/configuration_files.md
+++ b/pages/configuration_files.md
@@ -19,7 +19,7 @@ example:
 ```

 The configuration contents are identical to the
-[Node.js configuration structure](https://chenasraf.githun.io/simple-scaffold/pages/docs/node.md):
+[Node.js configuration structure](https://chenasraf.github.io/simple-scaffold/pages/node.md):

 ```ts
 interface ScaffoldConfig {
@@ -45,7 +45,7 @@ interface ScaffoldConfig {
 If you want to supply functions inside the configurations, you must use a `.js` file as JSON does
 not support non-primitives.

-A `.js` file is just like a `.json` file, make sure to export the final configuration:
+A `.js` file can be just like a `.json` file, make sure to export the final configuration:

 ```js
 /** @type {import('simple-scaffold').ScaffoldConfigFile} */
@@ -57,10 +57,33 @@ module.exports = {
 }
 ```

+Another feature of using a JS file is you can export a function which will be loaded with the CMD
+config provided to Simple Scaffold. The `extras` key contains any values not consumed by built-in
+flags, so you can pre-process your args before outputting a config:
+
+```js
+/** @type {import('simple-scaffold').ScaffoldConfigFile} */
+module.exports = (config) => {
+  console.log("Config:", config)
+  return {
+    component: {
+      templates: ["templates/component"],
+      output: "src/components",
+    },
+  }
+}
+```
+
 ## Using a config file

 Once your config is created, you can use it by providing the file name to the `--config` (or `-c`
-for brevity), followed by a colon, then your scaffold config name. For example:
+for brevity), optionally followed by a colon, then your scaffold config name.
+
+```shell
+simple-scaffold -c <file>[:<template_key>]
+```
+
+For example:

 ```shell
 simple-scaffold -c scaffold.json:component MyComponentName
@@ -84,3 +107,66 @@ And then:
 # will use 'default' template
 simple-scaffold -c scaffold.json MyComponentName
 ```
+
+## Remote Templates
+
+You can load template groups remotely, similar to how you would pass a config normally.
+
+The main difference is the templates will be hosted on a remote location such as a git server, and
+not locally in your project. This can be done to easily share & reuse templates.
+
+When passing a git URL to `--config`, you will clone that repo and use the files there as template.
+
+The syntax is as follows:
+
+```shell
+simple-scaffold -c <git_url>[#<git_file>][:<template_key>]
+```
+
+For example, to use this repository's example as base:
+
+```shell
+simple-scaffold -c https://github.com/chenasraf/simple-scaffold.git#scaffold.config.js:component
+```
+
+When the `filename` is omitted, `/scaffold.config.js` will be used as default.
+
+When the `template_key` is ommitted, `default` will be used as default.
+
+### GitHub Templates
+
+As a shorter alternative to the above example, you can use `--github` or `-gh` to reference a GitHub
+URL without specifying the whole path.
+
+The syntax is as follows:
+
+```shell
+simple-scaffold -gh <username>/<project_name>[#<git_file>][:<template_key>]
+```
+
+This example is equivalent to the above, just shorter to write:
+
+```shell
+simple-scaffold -c chenasraf/simple-scaffold#scaffold.config.js:component
+```
+
+## Use In Node.js
+
+You can also start a scaffold from Node.js with a remote file or URL config.
+
+Just use the `Scaffold.fromConfig` function:
+
+```ts
+Scaffold.fromConfig(
+  "scaffold.config.js", // file or HTTPS git URL
+  {
+    // name of the generated component
+    name: "My Component",
+    // key to load from the config
+    key: "component",
+  },
+  {
+    // other config overrides
+  },
+)
+```
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
--- a/release.config.js
+++ b/release.config.js
@@ -1,52 +1,12 @@
-const releaseRules = [
-  { type: "feat", section: "Features", release: "minor" },
-  { type: "docs", section: "Misc", release: "patch" },
-  { type: "fix", section: "Bug Fixes", release: "patch" },
-  { type: "refactor", section: "Misc", release: "patch" },
-  { type: "docs", section: "Build", release: "patch" },
-  { type: "perf", section: "Misc", release: "patch" },
-  { type: "build", section: "Build", release: "patch" },
-  { type: "chore", section: "Misc", release: "patch" },
-  { type: "test", section: "Misc", release: "patch" },
-]
-
 /** @type {import('semantic-release').Options} */
 module.exports = {
-  branches: [
-    "+([0-9])?(.{+([0-9]),x}).x",
-    "master",
-    "next",
-    "next-major",
-    { name: "beta", prerelease: true },
-    { name: "alpha", prerelease: true },
-  ],
+  branches: ["master", { name: "pre", prerelease: true }],
  analyzeCommits: {
    path: "semantic-release-conventional-commits",
-    majorTypes: ["major", "breaking"],
-    minorTypes: ["minor", "feat", "feature"],
-    patchTypes: ["patch", "fix", "bugfix", "refactor", "perf", "revert"],
  },
  plugins: [
-    [
-      "@semantic-release/commit-analyzer",
-      {
-        preset: "conventionalcommits",
-        parserOpts: {
-          noteKeywords: ["breaking:", "breaking-fix:", "breaking-feat:"],
-        },
-        releaseRules: releaseRules,
-      },
-    ],
-    [
-      "@semantic-release/release-notes-generator",
-      {
-        preset: "conventionalcommits",
-        parserOpts: {
-          noteKeywords: ["breaking"],
-          types: releaseRules,
-        },
-      },
-    ],
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
    [
      "@semantic-release/changelog",
      {
@@ -57,13 +17,14 @@ module.exports = {
    [
      "@semantic-release/npm",
      {
-        packageRoot: "dist",
+        npmPublish: false,
      },
    ],
    [
-      "@semantic-release/github",
+      "@semantic-release/npm",
      {
-        assets: ["package.tgz"],
+        npmPublish: true,
+        pkgRoot: "dist",
      },
    ],
    [
@@ -72,5 +33,11 @@ module.exports = {
        assets: ["CHANGELOG.md", "package.json"],
      },
    ],
+    [
+      "@semantic-release/github",
+      {
+        assets: ["*.tgz"],
+      },
+    ],
  ],
 }
--- a/scaffold.config.js
+++ b/scaffold.config.js
@@ -0,0 +1,16 @@
+/** @type {import('simple-scaffold').ScaffoldConfigFile} */
+module.exports = (conf) => {
+  console.log("Config:", conf)
+  return {
+    default: {
+      templates: ["examples/test-input/Component"],
+      output: "examples/test-output",
+      data: { property: "myProp", value: "10" },
+    },
+    component: {
+      templates: ["examples/test-input/Component"],
+      output: "examples/test-output/component",
+      data: { property: "myProp", value: "10" },
+    },
+  }
+}
--- a/src/cmd.ts
+++ b/src/cmd.ts
@@ -1,21 +1,22 @@
 #!/usr/bin/env node
 import massarg from "massarg"
 import chalk from "chalk"
-import { LogLevel, ScaffoldCmdConfig, ScaffoldConfig } from "./types"
+import { LogLevel, ScaffoldCmdConfig } from "./types"
 import { Scaffold } from "./scaffold"
-import path from "path"
-import fs from "fs/promises"
-import { parseAppendData, parseConfig } from "./utils"
-import { OptionsBase } from "massarg/types"
+import path from "node:path"
+import fs from "node:fs/promises"
+import { parseAppendData, parseConfigFile } from "./config"

 export async function parseCliArgs(args = process.argv.slice(2)) {
-  const pkg = JSON.parse((await fs.readFile(path.join(__dirname, "package.json"))).toString())
-  const isConfig = args.includes("--config") || args.includes("-c")
+  const pkgFile = await fs.readFile(path.join(__dirname, "package.json"))
+  const pkg = JSON.parse(pkgFile.toString())
+  const isConfigProvided =
+    args.includes("--config") || args.includes("-c") || args.includes("--github") || args.includes("-gh")

  return (
    massarg<ScaffoldCmdConfig>()
-      .main((config) => {
-        const _config = parseConfig(config)
+      .main(async (config) => {
+        const _config = await parseConfigFile(config)
        return Scaffold(_config)
      })
      .option({
@@ -30,13 +31,25 @@ export async function parseCliArgs(args = process.argv.slice(2)) {
        name: "config",
        aliases: ["c"],
        description:
-          "Filename to load config from instead of passing arguments to CLI or using a Node.js script. You may pass a JSON or JS file, with a relative or absolute path.",
+          "Filename or https git URL to load config from instead of passing arguments to CLI or using a Node.js script. See examples for syntax.",
+      })
+      .option({
+        name: "github",
+        aliases: ["gh"],
+        description:
+          "GitHub path to load config from instead of passing arguments to CLI or using a Node.js script. See examples for syntax.",
+      })
+      .option({
+        name: "key",
+        aliases: ["k"],
+        description:
+          "Key to load inside the config file. This overwrites the config key provided after the colon in --config (e.g. --config scaffold.cmd.js:component)",
      })
      .option({
        name: "output",
        aliases: ["o"],
        description: `Path to output to. If --create-sub-folder is enabled, the subfolder will be created inside this path. ${chalk.reset`${chalk.white`(default: current dir)`}`}`,
-        required: !isConfig,
+        required: !isConfigProvided,
      })
      .option({
        name: "templates",
@@ -45,7 +58,7 @@ export async function parseCliArgs(args = process.argv.slice(2)) {
        description:
          "Template files to use as input. You may provide multiple files, each of which can be a relative or absolute path, " +
          "or a glob pattern for multiple file matching easily.",
-        required: !isConfig,
+        required: !isConfigProvided,
      })
      .option({
        name: "overwrite",
@@ -110,16 +123,41 @@ export async function parseCliArgs(args = process.argv.slice(2)) {
      //   description: "Usage",
      //   output: "",
      // })
+      .example({
+        description: "Usage with config file",
+        input: "simple-scaffold -c scaffold.cmd.js --key component",
+      })
+      .example({
+        description: "Usage with GitHub config file",
+        input: "simple-scaffold -gh chenasraf/simple-scaffold --key component",
+      })
+      .example({
+        description: "Usage with https git URL (for non-GitHub)",
+        input: "simple-scaffold -c https://example.com/user/template.git#scaffold.cmd.js --key component",
+      })
+      .example({
+        description: "Full syntax with config path and template key (applicable to all above methods)",
+        input: "simple-scaffold -c scaffold.cmd.js:component MyComponent",
+      })
+      .example({
+        description: "Excluded template key, assumes 'default' key",
+        input: "simple-scaffold -c scaffold.cmd.js MyComponent",
+      })
+      .example({
+        description: "Shortest syntax for GitHub, assumes file 'scaffold.cmd.js' and template key 'default'",
+        input: "simple-scaffold -gh chenasraf/simple-scaffold MyComponent",
+      })
      .help({
        binName: "simple-scaffold",
        useGlobalColumns: true,
        usageExample: "[options]",
+        printWidth: 100,
        header: [`Create structured files based on templates.`].join("\n"),
        footer: [
          `Version:  ${pkg.version}`,
          `Copyright © Chen Asraf 2017-${new Date().getFullYear()}`,
          ``,
-          `Documentation: ${chalk.underline`https://casraf.dev/simple-scaffold`}`,
+          `Documentation: ${chalk.underline`https://chenasraf.github.io/simple-scaffold`}`,
          `NPM: ${chalk.underline`https://npmjs.com/package/simple-scaffold`}`,
          `GitHub: ${chalk.underline`https://github.com/chenasraf/simple-scaffold`}`,
        ].join("\n"),
--- a/src/config.ts
+++ b/src/config.ts
@@ -0,0 +1,136 @@
+import path from "node:path"
+import {
+  ConfigLoadConfig,
+  FileResponse,
+  FileResponseHandler,
+  LogLevel,
+  ScaffoldCmdConfig,
+  ScaffoldConfig,
+  ScaffoldConfigFile,
+} from "./types"
+import { handlebarsParse } from "./parser"
+import { log } from "./logger"
+import { resolve, wrapNoopResolver } from "./utils"
+import { getGitConfig } from "./git"
+
+export function getOptionValueForFile<T>(
+  config: ScaffoldConfig,
+  filePath: string,
+  fn: FileResponse<T>,
+  defaultValue?: T,
+): T {
+  if (typeof fn !== "function") {
+    return defaultValue ?? (fn as T)
+  }
+  return (fn as FileResponseHandler<T>)(
+    filePath,
+    path.dirname(handlebarsParse(config, filePath, { isPath: true }).toString()),
+    path.basename(handlebarsParse(config, filePath, { isPath: true }).toString()),
+  )
+}
+
+export function parseAppendData(value: string, options: ScaffoldCmdConfig): unknown {
+  const data = options.data ?? {}
+  const [key, val] = value.split(/\:?=/)
+  // raw
+  if (value.includes(":=") && !val.includes(":=")) {
+    return { ...data, [key]: JSON.parse(val) }
+  }
+  return { ...data, [key]: isWrappedWithQuotes(val) ? val.substring(1, val.length - 1) : val }
+}
+
+function isWrappedWithQuotes(string: string): boolean {
+  return (string.startsWith('"') && string.endsWith('"')) || (string.startsWith("'") && string.endsWith("'"))
+}
+
+/** @internal */
+export async function parseConfigFile(config: ScaffoldCmdConfig): Promise<ScaffoldConfig> {
+  let c: ScaffoldConfig = config
+  if (config.github) {
+    log(config, LogLevel.Info, `Loading config from github ${config.github}`)
+    config.config = githubPartToUrl(config.github)
+  }
+
+  if (config.config) {
+    const { configFile, key, isRemote } = parseConfigSelection(config.config, config.key)
+    log(config, LogLevel.Info, `Loading config from ${configFile} with key ${key}`)
+    const configPromise = await getConfig({
+      config: configFile,
+      isRemote,
+      quiet: config.quiet,
+      verbose: config.verbose,
+    })
+    let configImport = await resolve(configPromise, config)
+    if (typeof configImport.default === "function" || configImport.default instanceof Promise) {
+      configImport = await resolve(configImport.default, config)
+    }
+    if (!configImport[key]) {
+      throw new Error(`Template "${key}" not found in ${configFile}`)
+    }
+    const importedKey = configImport[key]
+    c = {
+      ...config,
+      ...importedKey,
+      data: {
+        ...(importedKey as any).data,
+        ...config.data,
+      },
+    }
+  }
+
+  c.data = { ...c.data, ...config.appendData }
+  delete config.appendData
+  return c
+}
+
+export function parseConfigSelection(
+  config: string,
+  key?: string,
+): { configFile: string; key: string; isRemote: boolean } {
+  const isUrl = config.includes("://")
+
+  const hasColonToken = (!isUrl && config.includes(":")) || (isUrl && count(config, ":") > 1)
+  const colonIndex = config.lastIndexOf(":")
+  const [configFile, templateKey = "default"] = hasColonToken
+    ? [config.substring(0, colonIndex), config.substring(colonIndex + 1)]
+    : [config, undefined]
+  const _key = (key ?? templateKey) || "default"
+  return { configFile, key: _key, isRemote: isUrl }
+}
+
+export function githubPartToUrl(part: string): string {
+  const gitUrl = new URL(`https://github.com/${part}`)
+  if (!gitUrl.pathname.endsWith(".git")) {
+    gitUrl.pathname += ".git"
+  }
+  return gitUrl.toString()
+}
+
+/** @internal */
+export async function getConfig(config: ConfigLoadConfig): Promise<ScaffoldConfigFile> {
+  const { config: configFile, isRemote, ...logConfig } = config as Required<typeof config>
+
+  if (!isRemote) {
+    log(logConfig, LogLevel.Info, `Loading config from file ${configFile}`)
+    const absolutePath = path.resolve(process.cwd(), configFile)
+    return wrapNoopResolver(import(absolutePath))
+  }
+
+  const url = new URL(configFile)
+  const isHttp = url.protocol === "http:" || url.protocol === "https:"
+  const isGit = url.protocol === "git:" || (isHttp && url.pathname.endsWith(".git"))
+
+  if (isGit) {
+    return getGitConfig(url, logConfig)
+  }
+
+  if (!isHttp) {
+    throw new Error(`Unsupported protocol ${url.protocol}`)
+  }
+
+  return wrapNoopResolver(import(path.resolve(process.cwd(), configFile)))
+}
+
+function count(string: string, substring: string): number {
+  return string.split(substring).length - 1
+}
--- a/src/file.ts
+++ b/src/file.ts
@@ -0,0 +1,212 @@
+import path from "node:path"
+import { F_OK } from "node:constants"
+import { LogLevel, ScaffoldConfig } from "./types"
+import fs from "node:fs/promises"
+import { glob, hasMagic } from "glob"
+import { log } from "./logger"
+import { getOptionValueForFile } from "./config"
+import { handlebarsParse } from "./parser"
+import { handleErr } from "./utils"
+
+const { stat, access, mkdir, readFile, writeFile } = fs
+
+export async function createDirIfNotExists(dir: string, config: ScaffoldConfig): Promise<void> {
+  if (config.dryRun) {
+    log(config, LogLevel.Info, `Dry Run. Not creating dir ${dir}`)
+    return
+  }
+  const parentDir = path.dirname(dir)
+
+  if (!(await pathExists(parentDir))) {
+    await createDirIfNotExists(parentDir, config)
+  }
+
+  if (!(await pathExists(dir))) {
+    try {
+      log(config, LogLevel.Debug, `Creating dir ${dir}`)
+      await mkdir(dir)
+      return
+    } catch (e: any) {
+      if (e.code !== "EEXIST") {
+        throw e
+      }
+      return
+    }
+  }
+}
+
+export async function pathExists(filePath: string): Promise<boolean> {
+  try {
+    await access(filePath, F_OK)
+    return true
+  } catch (e: any) {
+    if (e.code === "ENOENT") {
+      return false
+    }
+    throw e
+  }
+}
+
+export async function isDir(path: string): Promise<boolean> {
+  const tplStat = await stat(path)
+  return tplStat.isDirectory()
+}
+
+export function removeGlob(template: string): string {
+  return path.normalize(template.replace(/\*/g, ""))
+}
+
+export function makeRelativePath(str: string): string {
+  return str.startsWith(path.sep) ? str.slice(1) : str
+}
+
+export function getBasePath(relPath: string): string {
+  return path
+    .resolve(process.cwd(), relPath)
+    .replace(process.cwd() + path.sep, "")
+    .replace(process.cwd(), "")
+}
+
+export async function getFileList(_config: ScaffoldConfig, template: string): Promise<string[]> {
+  template = template.replaceAll(/[\\]+/g, "/")
+  log(_config, LogLevel.Debug, `Getting file list for ${template}`)
+  return (
+    await glob(template, {
+      dot: true,
+      nodir: true,
+      // debug: config.verbose === LogLevel.Debug,
+    })
+  ).map(path.normalize)
+}
+
+export interface GlobInfo {
+  nonGlobTemplate: string
+  origTemplate: string
+  isDirOrGlob: boolean
+  isGlob: boolean
+  template: string
+}
+
+export async function getTemplateGlobInfo(config: ScaffoldConfig, template: string): Promise<GlobInfo> {
+  const isGlob = hasMagic(template)
+  log(config, LogLevel.Debug, "before isDir", "isGlob:", isGlob, template)
+  let _template = template
+  let nonGlobTemplate = isGlob ? removeGlob(template) : template
+  nonGlobTemplate = path.normalize(nonGlobTemplate)
+  const isDirOrGlob = isGlob ? true : await isDir(template)
+  const _shouldAddGlob = !isGlob && isDirOrGlob
+  log(config, LogLevel.Debug, "after", { isDirOrGlob, _shouldAddGlob })
+  const origTemplate = template
+  if (_shouldAddGlob) {
+    _template = path.join(template, "**", "*")
+  }
+  return { nonGlobTemplate, origTemplate, isDirOrGlob, isGlob, template: _template }
+}
+
+export interface OutputFileInfo {
+  inputPath: string
+  outputPathOpt: string
+  outputDir: string
+  outputPath: string
+  exists: boolean
+}
+
+export async function getTemplateFileInfo(
+  config: ScaffoldConfig,
+  { templatePath, basePath }: { templatePath: string; basePath: string },
+): Promise<OutputFileInfo> {
+  const inputPath = path.resolve(process.cwd(), templatePath)
+  const outputPathOpt = getOptionValueForFile(config, inputPath, config.output)
+  const outputDir = getOutputDir(config, outputPathOpt, basePath)
+  const outputPath = handlebarsParse(config, path.join(outputDir, path.basename(inputPath)), {
+    isPath: true,
+  }).toString()
+  const exists = await pathExists(outputPath)
+  return { inputPath, outputPathOpt, outputDir, outputPath, exists }
+}
+
+export async function copyFileTransformed(
+  config: ScaffoldConfig,
+  {
+    exists,
+    overwrite,
+    outputPath,
+    inputPath,
+  }: {
+    exists: boolean
+    overwrite: boolean
+    outputPath: string
+    inputPath: string
+  },
+): Promise<void> {
+  if (!exists || overwrite) {
+    if (exists && overwrite) {
+      log(config, LogLevel.Info, `File ${outputPath} exists, overwriting`)
+    }
+    const templateBuffer = await readFile(inputPath)
+    const unprocessedOutputContents = handlebarsParse(config, templateBuffer)
+    const finalOutputContents =
+      (await config.beforeWrite?.(unprocessedOutputContents, templateBuffer, outputPath)) ?? unprocessedOutputContents
+
+    if (!config.dryRun) {
+      await writeFile(outputPath, finalOutputContents)
+      log(config, LogLevel.Info, "Done.")
+    } else {
+      log(config, LogLevel.Info, "Dry Run. Output should be:")
+      log(config, LogLevel.Info, finalOutputContents.toString())
+    }
+  } else if (exists) {
+    log(config, LogLevel.Info, `File ${outputPath} already exists, skipping`)
+  }
+}
+
+export function getOutputDir(config: ScaffoldConfig, outputPathOpt: string, basePath: string): string {
+  return path.resolve(
+    process.cwd(),
+    ...([
+      outputPathOpt,
+      basePath,
+      config.createSubFolder
+        ? config.subFolderNameHelper
+          ? handlebarsParse(config, `{{ ${config.subFolderNameHelper} name }}`).toString()
+          : config.name
+        : undefined,
+    ].filter(Boolean) as string[]),
+  )
+}
+
+export async function handleTemplateFile(
+  config: ScaffoldConfig,
+  { templatePath, basePath }: { templatePath: string; basePath: string },
+): Promise<void> {
+  return new Promise(async (resolve, reject) => {
+    try {
+      const { inputPath, outputPathOpt, outputDir, outputPath, exists } = await getTemplateFileInfo(config, {
+        templatePath,
+        basePath,
+      })
+      const overwrite = getOptionValueForFile(config, inputPath, config.overwrite ?? false)
+
+      log(
+        config,
+        LogLevel.Debug,
+        `\nParsing ${templatePath}`,
+        `\nBase path: ${basePath}`,
+        `\nFull input path: ${inputPath}`,
+        `\nOutput Path Opt: ${outputPathOpt}`,
+        `\nFull output dir: ${outputDir}`,
+        `\nFull output path: ${outputPath}`,
+        `\n`,
+      )
+
+      await createDirIfNotExists(path.dirname(outputPath), config)
+
+      log(config, LogLevel.Info, `Writing to ${outputPath}`)
+      await copyFileTransformed(config, { exists, overwrite, outputPath, inputPath })
+      resolve()
+    } catch (e: any) {
+      handleErr(e)
+      reject(e)
+    }
+  })
+}
--- a/src/git.ts
+++ b/src/git.ts
@@ -0,0 +1,48 @@
+import path from "node:path"
+import os from "node:os"
+import { log } from "./logger"
+import { AsyncResolver, LogConfig, LogLevel, ScaffoldCmdConfig, ScaffoldConfig, ScaffoldConfigMap } from "./types"
+import { spawn } from "node:child_process"
+import { resolve, wrapNoopResolver } from "./utils"
+
+export async function getGitConfig(
+  url: URL,
+  logConfig: LogConfig,
+): Promise<AsyncResolver<ScaffoldCmdConfig, ScaffoldConfigMap>> {
+  const repoUrl = `${url.protocol}//${url.host}${url.pathname}`
+
+  log(logConfig, LogLevel.Info, `Cloning git repo ${repoUrl}`)
+
+  const tmpPath = path.resolve(os.tmpdir(), `scaffold-config-${Date.now()}`)
+
+  return new Promise((res, reject) => {
+    const clone = spawn("git", ["clone", "--recurse-submodules", "--depth", "1", repoUrl, tmpPath])
+
+    clone.on("error", reject)
+    clone.on("close", async (code) => {
+      if (code === 0) {
+        log(logConfig, LogLevel.Info, `Loading config from git repo: ${repoUrl}`)
+        const hashPath = url.hash?.replace("#", "") || "scaffold.config.js"
+        const absolutePath = path.resolve(tmpPath, hashPath)
+        const loadedConfig = await resolve(
+          async () => (await import(absolutePath)).default as ScaffoldConfigMap,
+          logConfig,
+        )
+
+        log(logConfig, LogLevel.Info, `Loaded config from git`)
+        log(logConfig, LogLevel.Debug, `Raw config:`, loadedConfig)
+        const fixedConfig: ScaffoldConfigMap = {}
+        for (const [k, v] of Object.entries(loadedConfig)) {
+          fixedConfig[k] = {
+            ...v,
+            templates: v.templates.map((t) => path.resolve(tmpPath, t)),
+          }
+        }
+        res(wrapNoopResolver(fixedConfig))
+        return
+      }
+
+      reject(new Error(`Git clone failed with code ${code}`))
+    })
+  })
+}
--- a/src/logger.ts
+++ b/src/logger.ts
@@ -0,0 +1,65 @@
+import { LogConfig, LogLevel, ScaffoldConfig } from "./types"
+import chalk from "chalk"
+
+export function log(config: LogConfig, level: LogLevel, ...obj: any[]): void {
+  if (config.quiet || config.verbose === LogLevel.None || level < (config.verbose ?? LogLevel.Info)) {
+    return
+  }
+
+  const levelColor: Record<LogLevel, keyof typeof chalk> = {
+    [LogLevel.None]: "reset",
+    [LogLevel.Debug]: "blue",
+    [LogLevel.Info]: "dim",
+    [LogLevel.Warning]: "yellow",
+    [LogLevel.Error]: "red",
+  }
+
+  const chalkFn: any = chalk[levelColor[level]]
+  const key: "log" | "warn" | "error" = level === LogLevel.Error ? "error" : level === LogLevel.Warning ? "warn" : "log"
+  const logFn: any = console[key]
+  logFn(
+    ...obj.map((i) =>
+      i instanceof Error
+        ? chalkFn(i, JSON.stringify(i, undefined, 1), i.stack)
+        : typeof i === "object"
+        ? chalkFn(JSON.stringify(i, undefined, 1))
+        : chalkFn(i),
+    ),
+  )
+}
+
+export function logInputFile(
+  config: ScaffoldConfig,
+  data: {
+    originalTemplate: string
+    relativePath: string
+    parsedTemplate: string
+    inputFilePath: string
+    nonGlobTemplate: string
+    basePath: string
+    isDirOrGlob: boolean
+    isGlob: boolean
+  },
+): void {
+  log(config, LogLevel.Debug, data)
+}
+
+export function logInitStep(config: ScaffoldConfig): void {
+  log(config, LogLevel.Debug, "Full config:", {
+    name: config.name,
+    templates: config.templates,
+    output: config.output,
+    createSubFolder: config.createSubFolder,
+    data: config.data,
+    overwrite: config.overwrite,
+    quiet: config.quiet,
+    subFolderNameHelper: config.subFolderNameHelper,
+    helpers: Object.keys(config.helpers ?? {}),
+    verbose: `${config.verbose} (${Object.keys(LogLevel).find(
+      (k) => (LogLevel[k as any] as unknown as number) === config.verbose!,
+    )})`,
+    dryRun: config.dryRun,
+    beforeWrite: config.beforeWrite,
+  } as Record<keyof ScaffoldConfig, unknown>)
+  log(config, LogLevel.Info, "Data:", config.data)
+}
--- a/src/parser.ts
+++ b/src/parser.ts
@@ -0,0 +1,126 @@
+import path from "node:path"
+import { DefaultHelpers, Helper, LogLevel, ScaffoldConfig } from "./types"
+import Handlebars from "handlebars"
+import dtAdd from "date-fns/add"
+import dtFormat from "date-fns/format"
+import dtParseISO from "date-fns/parseISO"
+import { log } from "./logger"
+
+const dateFns = {
+  add: dtAdd,
+  format: dtFormat,
+  parseISO: dtParseISO,
+}
+
+export const defaultHelpers: Record<DefaultHelpers, Helper> = {
+  camelCase,
+  snakeCase,
+  startCase,
+  kebabCase,
+  hyphenCase: kebabCase,
+  pascalCase,
+  lowerCase: (text) => text.toLowerCase(),
+  upperCase: (text) => text.toUpperCase(),
+  now: nowHelper,
+  date: dateHelper,
+}
+
+function _dateHelper(date: Date, formatString: string): string
+function _dateHelper(date: Date, formatString: string, durationDifference: number, durationType: keyof Duration): string
+function _dateHelper(
+  date: Date,
+  formatString: string,
+  durationDifference?: number,
+  durationType?: keyof Duration,
+): string {
+  if (durationType && durationDifference !== undefined) {
+    return dateFns.format(dateFns.add(date, { [durationType]: durationDifference }), formatString)
+  }
+  return dateFns.format(date, formatString)
+}
+
+export function nowHelper(formatString: string): string
+export function nowHelper(formatString: string, durationDifference: number, durationType: keyof Duration): string
+export function nowHelper(formatString: string, durationDifference?: number, durationType?: keyof Duration): string {
+  return _dateHelper(new Date(), formatString, durationDifference!, durationType!)
+}
+
+export function dateHelper(date: string, formatString: string): string
+export function dateHelper(
+  date: string,
+  formatString: string,
+  durationDifference: number,
+  durationType: keyof Duration,
+): string
+export function dateHelper(
+  date: string,
+  formatString: string,
+  durationDifference?: number,
+  durationType?: keyof Duration,
+): string {
+  return _dateHelper(dateFns.parseISO(date), formatString, durationDifference!, durationType!)
+}
+
+// splits by either non-alpha character or capital letter
+function toWordParts(string: string): string[] {
+  return string.split(/(?=[A-Z])|[^a-zA-Z]/).filter((s) => s.length > 0)
+}
+
+function camelCase(s: string): string {
+  return toWordParts(s).reduce((acc, part, i) => {
+    if (i === 0) {
+      return part.toLowerCase()
+    }
+    return acc + part[0].toUpperCase() + part.slice(1).toLowerCase()
+  }, "")
+}
+
+function snakeCase(s: string): string {
+  return toWordParts(s).join("_").toLowerCase()
+}
+
+function kebabCase(s: string): string {
+  return toWordParts(s).join("-").toLowerCase()
+}
+
+function startCase(s: string): string {
+  return toWordParts(s)
+    .map((part) => part[0].toUpperCase() + part.slice(1).toLowerCase())
+    .join(" ")
+}
+
+function pascalCase(s: string): string {
+  return startCase(s).replace(/\s+/g, "")
+}
+
+export function registerHelpers(config: ScaffoldConfig): void {
+  const _helpers = { ...defaultHelpers, ...config.helpers }
+  for (const helperName in _helpers) {
+    log(config, LogLevel.Debug, `Registering helper: ${helperName}`)
+    Handlebars.registerHelper(helperName, _helpers[helperName as keyof typeof _helpers])
+  }
+}
+
+export function handlebarsParse(
+  config: ScaffoldConfig,
+  templateBuffer: Buffer | string,
+  { isPath = false }: { isPath?: boolean } = {},
+): Buffer {
+  const { data } = config
+  try {
+    let str = templateBuffer.toString()
+    if (isPath) {
+      str = str.replace(/\\/g, "/")
+    }
+    const parser = Handlebars.compile(str, { noEscape: true })
+    let outputContents = parser(data)
+    if (isPath && path.sep !== "/") {
+      outputContents = outputContents.replace(/\//g, "\\")
+    }
+    return Buffer.from(outputContents)
+  } catch (e) {
+    log(config, LogLevel.Debug, e)
+    log(config, LogLevel.Warning, "Couldn't parse file with handlebars, returning original content")
+    return Buffer.from(templateBuffer)
+  }
+}
--- a/src/scaffold.ts
+++ b/src/scaffold.ts
@@ -4,27 +4,21 @@
 *
 * See [readme](README.md)
 */
-import path from "path"
-
+import path from "node:path"
+import { handleErr, resolve } from "./utils"
 import {
-  createDirIfNotExists,
-  getOptionValueForFile,
-  handleErr,
-  log,
-  pascalCase,
  isDir,
  removeGlob,
  makeRelativePath,
-  registerHelpers,
  getTemplateGlobInfo,
  getFileList,
  getBasePath,
-  copyFileTransformed,
-  getTemplateFileInfo,
-  logInitStep,
-  logInputFile,
-} from "./utils"
-import { LogLevel, ScaffoldConfig } from "./types"
+  handleTemplateFile,
+} from "./file"
+import { LogLevel, MinimalConfig, Resolver, ScaffoldCmdConfig, ScaffoldConfig } from "./types"
+import { defaultHelpers, registerHelpers } from "./parser"
+import { log, logInitStep, logInputFile } from "./logger"
+import { parseConfigFile } from "./config"

 /**
 * Create a scaffold using given `options`.
@@ -50,6 +44,7 @@ import { LogLevel, ScaffoldConfig } from "./types"
 * For available default values, see {@link DefaultHelpers}.
 *
 * @param {ScaffoldConfig} config The main configuration object
+ * @return {Promise<void>} A promise that resolves when the scaffold is complete
 *
 * @see {@link DefaultHelpers}
 * @see {@link CaseHelpers}
@@ -62,7 +57,7 @@ export async function Scaffold(config: ScaffoldConfig): Promise<void> {

  registerHelpers(config)
  try {
-    config.data = { name: config.name, Name: pascalCase(config.name), ...config.data }
+    config.data = { name: config.name, Name: defaultHelpers.pascalCase(config.name), ...config.data }
    logInitStep(config)
    for (let _template of config.templates) {
      try {
@@ -71,6 +66,7 @@ export async function Scaffold(config: ScaffoldConfig): Promise<void> {
          _template,
        )
        const files = await getFileList(config, template)
+        log(config, LogLevel.Debug, "Iterating files", { files, template })
        for (const inputFilePath of files) {
          if (await isDir(inputFilePath)) {
            continue
@@ -78,9 +74,9 @@ export async function Scaffold(config: ScaffoldConfig): Promise<void> {
          const relPath = makeRelativePath(path.dirname(removeGlob(inputFilePath).replace(nonGlobTemplate, "")))
          const basePath = getBasePath(relPath)
          logInputFile(config, {
-            origTemplate,
-            relPath,
-            template,
+            originalTemplate: origTemplate,
+            relativePath: relPath,
+            parsedTemplate: template,
            inputFilePath,
            nonGlobTemplate,
            basePath,
@@ -101,40 +97,40 @@ export async function Scaffold(config: ScaffoldConfig): Promise<void> {
    throw e
  }
 }
-async function handleTemplateFile(
-  config: ScaffoldConfig,
-  { templatePath, basePath }: { templatePath: string; basePath: string },
+
+/**
+ * Create a scaffold based on a config file or URL.
+ *
+ * @param {string} pathOrUrl The path or URL to the config file
+ * @param {Record<string, string>} config Information needed before loading the config
+ * @param {Partial<Omit<ScaffoldConfig, 'name'>>} overrides Any overrides to the loaded config
+ *
+ * @see {@link Scaffold}
+ * @category Main
+ * @return {Promise<void>} A promise that resolves when the scaffold is complete
+ */
+Scaffold.fromConfig = async function(
+  /** The path or URL to the config file */
+  pathOrUrl: string,
+  /** Information needed before loading the config */
+  config: MinimalConfig,
+  /** Any overrides to the loaded config */
+  overrides?: Resolver<ScaffoldCmdConfig, Partial<Omit<ScaffoldConfig, "name">>>,
 ): Promise<void> {
-  return new Promise(async (resolve, reject) => {
-    try {
-      const { inputPath, outputPathOpt, outputDir, outputPath, exists } = await getTemplateFileInfo(config, {
-        templatePath,
-        basePath,
-      })
-      const overwrite = getOptionValueForFile(config, inputPath, config.overwrite ?? false)
-
-      log(
-        config,
-        LogLevel.Debug,
-        `\nParsing ${templatePath}`,
-        `\nBase path: ${basePath}`,
-        `\nFull input path: ${inputPath}`,
-        `\nOutput Path Opt: ${outputPathOpt}`,
-        `\nFull output dir: ${outputDir}`,
-        `\nFull output path: ${outputPath}`,
-        `\n`,
-      )
-
-      await createDirIfNotExists(path.dirname(outputPath), config)
-
-      log(config, LogLevel.Info, `Writing to ${outputPath}`)
-      await copyFileTransformed(config, { exists, overwrite, outputPath, inputPath })
-      resolve()
-    } catch (e: any) {
-      handleErr(e)
-      reject(e)
-    }
-  })
+  const _cmdConfig: ScaffoldCmdConfig = {
+    dryRun: false,
+    output: process.cwd(),
+    verbose: LogLevel.Info,
+    overwrite: false,
+    templates: [],
+    createSubFolder: false,
+    quiet: false,
+    config: pathOrUrl,
+    ...config,
+  }
+  const _overrides = resolve(overrides, _cmdConfig)
+  const _config = await parseConfigFile(_cmdConfig)
+  return Scaffold({ ..._config, ..._overrides })
 }

 export default Scaffold
--- a/src/types.ts
+++ b/src/types.ts
@@ -3,7 +3,8 @@ import { HelperDelegate } from "handlebars/runtime"
 /**
 * The config object for defining a scaffolding group.
 *
- * @see https://github.com/chenasraf/simple-scaffold#readme
+ * @see {@link https://chenasraf.github.io/simple-scaffold/pages/node.html | Node.js usage}
+ * @see {@link https://chenasraf.github.io/simple-scaffold/pages/cli.html | CLI usage}
 * @see {@link DefaultHelpers}
 * @see {@link CaseHelpers}
 * @see {@link DateHelpers}
@@ -56,7 +57,7 @@ export interface ScaffoldConfig {
   * Enable to override output files, even if they already exist.
   *
   * You may supply a function to this option, which can take the arguments `(fullPath, baseDir, baseName)` and returns
-   * a string, to return a dynamic path for each file.
+   * a boolean for each file.
   *
   * May also be a {@link FileResponseHandler} which returns a boolean value per file.
   *
@@ -131,10 +132,8 @@ export interface ScaffoldConfig {
   * @see {@link DefaultHelpers}
   * @see {@link CaseHelpers}
   * @see {@link DateHelpers}
-   * @see https://casraf.dev/simple-scaffold#helpers
-   * @see https://casraf.dev/simple-scaffold#built-in-helpers
-   * @see https://handlebarsjs.com/guide/#custom-helpers
-   */
+   * @see {@link https://chenasraf.github.io/simple-scaffold/pages/templates.html | Templates}
+   * */
  helpers?: Record<string, Helper>

  /**
@@ -326,6 +325,10 @@ export type FileResponse<T> = T | FileResponseHandler<T>

 /** @internal */
 export interface ScaffoldCmdConfig {
+  /**
+   * Name to be passed to the generated files. `{{name}}` and `{{Name}}` inside contents and file names will be replaced
+   * accordingly.
+   */
  name: string
  templates: string[]
  output: string
@@ -337,6 +340,43 @@ export interface ScaffoldCmdConfig {
  verbose: LogLevel
  dryRun: boolean
  config?: string
+  /** The key to use for the file which contains the template configurations. */
+  key?: string
+  github?: string
 }

-export type ScaffoldConfigFile = Record<string, ScaffoldConfig>
+/**
+ * A mapping of scaffold template keys to their configurations.
+ *
+ * Each configuration is a {@link ScaffoldConfig} object.
+ *
+ * The key is the name of the template, and the value is the configuration for that template.
+ *
+ * When no template key is provided to the scaffold command, the "default" template is used.
+ *
+ * @see {@link ScaffoldConfig}
+ */
+export type ScaffoldConfigMap = Record<string, ScaffoldConfig>
+
+/** The scaffold config file is either:
+ * - A {@link ScaffoldConfigMap} object
+ * - A function that returns a {@link ScaffoldConfigMap} object
+ * - A promise that resolves to a {@link ScaffoldConfigMap} object
+ * - A function that returns a promise that resolves to a {@link ScaffoldConfigMap} object
+ */
+export type ScaffoldConfigFile = AsyncResolver<ScaffoldCmdConfig, ScaffoldConfigMap>
+
+/** @internal */
+export type Resolver<T, R = T> = R | ((value: T) => R)
+
+/** @internal */
+export type AsyncResolver<T, R = T> = Resolver<T, Promise<R> | R>
+
+/** @internal */
+export type LogConfig = Pick<ScaffoldConfig, "quiet" | "verbose">
+
+/** @internal */
+export type ConfigLoadConfig = LogConfig & Pick<ScaffoldCmdConfig, "config"> & { isRemote: boolean }
+
+/** @internal */
+export type MinimalConfig = Pick<ScaffoldCmdConfig, "name" | "key">
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -1,423 +1,17 @@
-import path from "path"
-import { F_OK } from "constants"
-import {
-  DefaultHelpers,
-  FileResponse,
-  FileResponseHandler,
-  Helper,
-  LogLevel,
-  ScaffoldCmdConfig,
-  ScaffoldConfig,
-  ScaffoldConfigFile,
-} from "./types"
-import camelCase from "lodash/camelCase"
-import snakeCase from "lodash/snakeCase"
-import kebabCase from "lodash/kebabCase"
-import startCase from "lodash/startCase"
-import Handlebars from "handlebars"
-import { promises as fsPromises } from "fs"
-import chalk from "chalk"
-const { stat, access, mkdir } = fsPromises
-import dtAdd from "date-fns/add"
-import dtFormat from "date-fns/format"
-import dtParseISO from "date-fns/parseISO"
-import { glob, hasMagic } from "glob"
-import { OptionsBase } from "massarg/types"
-
-const dateFns = {
-  add: dtAdd,
-  format: dtFormat,
-  parseISO: dtParseISO,
-}
-
-const { readFile, writeFile } = fsPromises
-
-export const defaultHelpers: Record<DefaultHelpers, Helper> = {
-  camelCase,
-  snakeCase,
-  startCase,
-  kebabCase,
-  hyphenCase: kebabCase,
-  pascalCase,
-  lowerCase: (text) => text.toLowerCase(),
-  upperCase: (text) => text.toUpperCase(),
-  now: nowHelper,
-  date: dateHelper,
-}
-
-export function _dateHelper(date: Date, formatString: string): string
-export function _dateHelper(
-  date: Date,
-  formatString: string,
-  durationDifference: number,
-  durationType: keyof Duration,
-): string
-export function _dateHelper(
-  date: Date,
-  formatString: string,
-  durationDifference?: number,
-  durationType?: keyof Duration,
-): string {
-  if (durationType && durationDifference !== undefined) {
-    return dateFns.format(dateFns.add(date, { [durationType]: durationDifference }), formatString)
-  }
-  return dateFns.format(date, formatString)
-}
-
-export function nowHelper(formatString: string): string
-export function nowHelper(formatString: string, durationDifference: number, durationType: keyof Duration): string
-export function nowHelper(formatString: string, durationDifference?: number, durationType?: keyof Duration): string {
-  return _dateHelper(new Date(), formatString, durationDifference!, durationType!)
-}
-
-export function dateHelper(date: string, formatString: string): string
-export function dateHelper(
-  date: string,
-  formatString: string,
-  durationDifference: number,
-  durationType: keyof Duration,
-): string
-
-export function dateHelper(
-  date: string,
-  formatString: string,
-  durationDifference?: number,
-  durationType?: keyof Duration,
-): string {
-  return _dateHelper(dateFns.parseISO(date), formatString, durationDifference!, durationType!)
-}
-
-export function registerHelpers(config: ScaffoldConfig): void {
-  const _helpers = { ...defaultHelpers, ...config.helpers }
-  for (const helperName in _helpers) {
-    log(config, LogLevel.Debug, `Registering helper: ${helperName}`)
-    Handlebars.registerHelper(helperName, _helpers[helperName as keyof typeof _helpers])
-  }
-}
+import { Resolver } from "./types"

 export function handleErr(err: NodeJS.ErrnoException | null): void {
  if (err) throw err
 }

-export function log(config: ScaffoldConfig, level: LogLevel, ...obj: any[]): void {
-  if (config.quiet || config.verbose === LogLevel.None || level < (config.verbose ?? LogLevel.Info)) {
-    return
-  }
-  const levelColor: Record<LogLevel, keyof typeof chalk> = {
-    [LogLevel.None]: "reset",
-    [LogLevel.Debug]: "blue",
-    [LogLevel.Info]: "dim",
-    [LogLevel.Warning]: "yellow",
-    [LogLevel.Error]: "red",
-  }
-  const chalkFn: any = chalk[levelColor[level]]
-  const key: "log" | "warn" | "error" = level === LogLevel.Error ? "error" : level === LogLevel.Warning ? "warn" : "log"
-  const logFn: any = console[key]
-  logFn(
-    ...obj.map((i) =>
-      i instanceof Error
-        ? chalkFn(i, JSON.stringify(i, undefined, 1), i.stack)
-        : typeof i === "object"
-        ? chalkFn(JSON.stringify(i, undefined, 1))
-        : chalkFn(i),
-    ),
-  )
+export function resolve<T, R = T>(resolver: Resolver<T, R>, arg: T): R {
+  return typeof resolver === "function" ? (resolver as (value: T) => R)(arg) : (resolver as R)
 }

-export async function createDirIfNotExists(dir: string, config: ScaffoldConfig): Promise<void> {
-  const parentDir = path.dirname(dir)
-
-  if (!(await pathExists(parentDir))) {
-    await createDirIfNotExists(parentDir, config)
+export function wrapNoopResolver<T, R = T>(value: Resolver<T, R>): Resolver<T, R> {
+  if (typeof value === "function") {
+    return value
  }

-  if (!(await pathExists(dir))) {
-    try {
-      log(config, LogLevel.Debug, `Creating dir ${dir}`)
-      await mkdir(dir)
-      return
-    } catch (e: any) {
-      if (e.code !== "EEXIST") {
-        throw e
-      }
-      return
-    }
-  }
-}
-
-export function getOptionValueForFile<T>(
-  config: ScaffoldConfig,
-  filePath: string,
-  fn: FileResponse<T>,
-  defaultValue?: T,
-): T {
-  if (typeof fn !== "function") {
-    return defaultValue ?? (fn as T)
-  }
-  return (fn as FileResponseHandler<T>)(
-    filePath,
-    path.dirname(handlebarsParse(config, filePath, { isPath: true }).toString()),
-    path.basename(handlebarsParse(config, filePath, { isPath: true }).toString()),
-  )
-}
-
-export function handlebarsParse(
-  config: ScaffoldConfig,
-  templateBuffer: Buffer | string,
-  { isPath = false }: { isPath?: boolean } = {},
-): Buffer {
-  const { data } = config
-  try {
-    let str = templateBuffer.toString()
-    if (isPath) {
-      str = str.replace(/\\/g, "/")
-    }
-    const parser = Handlebars.compile(str, { noEscape: true })
-    let outputContents = parser(data)
-    if (isPath && path.sep !== "/") {
-      outputContents = outputContents.replace(/\//g, "\\")
-    }
-    return Buffer.from(outputContents)
-  } catch (e) {
-    log(config, LogLevel.Debug, e)
-    log(config, LogLevel.Warning, "Couldn't parse file with handlebars, returning original content")
-    return Buffer.from(templateBuffer)
-  }
-}
-
-export async function pathExists(filePath: string): Promise<boolean> {
-  try {
-    await access(filePath, F_OK)
-    return true
-  } catch (e: any) {
-    if (e.code === "ENOENT") {
-      return false
-    }
-    throw e
-  }
-}
-
-export function pascalCase(s: string): string {
-  return startCase(s).replace(/\s+/g, "")
-}
-
-export async function isDir(path: string): Promise<boolean> {
-  const tplStat = await stat(path)
-  return tplStat.isDirectory()
-}
-
-export function removeGlob(template: string): string {
-  return template.replace(/\*/g, "").replace(/(\/\/|\\\\)/g, path.sep)
-}
-
-export function makeRelativePath(str: string): string {
-  return str.startsWith(path.sep) ? str.slice(1) : str
-}
-
-export function getBasePath(relPath: string): string {
-  return path
-    .resolve(process.cwd(), relPath)
-    .replace(process.cwd() + path.sep, "")
-    .replace(process.cwd(), "")
-}
-
-export async function getFileList(config: ScaffoldConfig, template: string): Promise<string[]> {
-  return (
-    await glob(template, {
-      dot: true,
-      nodir: true,
-      // debug: config.verbose === LogLevel.Debug,
-    })
-  ).map((f) => f.replace(/\//g, path.sep))
-}
-
-export interface GlobInfo {
-  nonGlobTemplate: string
-  origTemplate: string
-  isDirOrGlob: boolean
-  isGlob: boolean
-  template: string
-}
-
-export async function getTemplateGlobInfo(config: ScaffoldConfig, template: string): Promise<GlobInfo> {
-  const isGlob = hasMagic(template)
-  log(config, LogLevel.Debug, "before isDir", "isGlob:", isGlob, template)
-  let _template = template
-  let nonGlobTemplate = isGlob ? removeGlob(template) : template
-  nonGlobTemplate = path.normalize(nonGlobTemplate)
-  const isDirOrGlob = isGlob ? true : await isDir(template)
-  log(config, LogLevel.Debug, "after isDir", isDirOrGlob)
-  const _shouldAddGlob = !isGlob && isDirOrGlob
-  const origTemplate = template
-  if (_shouldAddGlob) {
-    _template = path.join(template, "**", "*")
-  }
-  return { nonGlobTemplate, origTemplate, isDirOrGlob, isGlob, template: _template }
-}
-
-export interface OutputFileInfo {
-  inputPath: string
-  outputPathOpt: string
-  outputDir: string
-  outputPath: string
-  exists: boolean
-}
-
-export async function getTemplateFileInfo(
-  config: ScaffoldConfig,
-  { templatePath, basePath }: { templatePath: string; basePath: string },
-): Promise<OutputFileInfo> {
-  const inputPath = path.resolve(process.cwd(), templatePath)
-  const outputPathOpt = getOptionValueForFile(config, inputPath, config.output)
-  const outputDir = getOutputDir(config, outputPathOpt, basePath)
-  const outputPath = handlebarsParse(config, path.join(outputDir, path.basename(inputPath)), {
-    isPath: true,
-  }).toString()
-  const exists = await pathExists(outputPath)
-  return { inputPath, outputPathOpt, outputDir, outputPath, exists }
-}
-
-export async function copyFileTransformed(
-  config: ScaffoldConfig,
-  {
-    exists,
-    overwrite,
-    outputPath,
-    inputPath,
-  }: {
-    exists: boolean
-    overwrite: boolean
-    outputPath: string
-    inputPath: string
-  },
-): Promise<void> {
-  if (!exists || overwrite) {
-    if (exists && overwrite) {
-      log(config, LogLevel.Info, `File ${outputPath} exists, overwriting`)
-    }
-    const templateBuffer = await readFile(inputPath)
-    const unprocessedOutputContents = handlebarsParse(config, templateBuffer)
-    const finalOutputContents =
-      (await config.beforeWrite?.(unprocessedOutputContents, templateBuffer, outputPath)) ?? unprocessedOutputContents
-
-    if (!config.dryRun) {
-      await writeFile(outputPath, finalOutputContents)
-      log(config, LogLevel.Info, "Done.")
-    } else {
-      log(config, LogLevel.Info, "Content output:")
-      log(config, LogLevel.Info, finalOutputContents)
-    }
-  } else if (exists) {
-    log(config, LogLevel.Info, `File ${outputPath} already exists, skipping`)
-  }
-}
-
-export function getOutputDir(config: ScaffoldConfig, outputPathOpt: string, basePath: string): string {
-  return path.resolve(
-    process.cwd(),
-    ...([
-      outputPathOpt,
-      basePath,
-      config.createSubFolder
-        ? config.subFolderNameHelper
-          ? handlebarsParse(config, `{{ ${config.subFolderNameHelper} name }}`).toString()
-          : config.name
-        : undefined,
-    ].filter(Boolean) as string[]),
-  )
-}
-
-export function logInputFile(
-  config: ScaffoldConfig,
-  {
-    origTemplate,
-    relPath,
-    template,
-    inputFilePath,
-    nonGlobTemplate,
-    basePath,
-    isDirOrGlob,
-    isGlob,
-  }: {
-    origTemplate: string
-    relPath: string
-    template: string
-    inputFilePath: string
-    nonGlobTemplate: string
-    basePath: string
-    isDirOrGlob: boolean
-    isGlob: boolean
-  },
-): void {
-  log(
-    config,
-    LogLevel.Debug,
-    `\nprocess.cwd(): ${process.cwd()}`,
-    `\norigTemplate: ${origTemplate}`,
-    `\nrelPath: ${relPath}`,
-    `\ntemplate: ${template}`,
-    `\ninputFilePath: ${inputFilePath}`,
-    `\nnonGlobTemplate: ${nonGlobTemplate}`,
-    `\nbasePath: ${basePath}`,
-    `\nisDirOrGlob: ${isDirOrGlob}`,
-    `\nisGlob: ${isGlob}`,
-    `\n`,
-  )
-}
-
-export function logInitStep(config: ScaffoldConfig): void {
-  log(config, LogLevel.Debug, "Full config:", {
-    name: config.name,
-    templates: config.templates,
-    output: config.output,
-    createSubfolder: config.createSubFolder,
-    data: config.data,
-    overwrite: config.overwrite,
-    quiet: config.quiet,
-    subFolderTransformHelper: config.subFolderNameHelper,
-    helpers: Object.keys(config.helpers ?? {}),
-    verbose: `${config.verbose} (${Object.keys(LogLevel).find(
-      (k) => (LogLevel[k as any] as unknown as number) === config.verbose!,
-    )})`,
-  })
-  log(config, LogLevel.Info, "Data:", config.data)
-}
-
-export function parseAppendData(value: string, options: ScaffoldCmdConfig & OptionsBase): unknown {
-  const data = options.data ?? {}
-  const [key, val] = value.split(/\:?=/)
-  // raw
-  if (value.includes(":=") && !val.includes(":=")) {
-    return { ...data, [key]: JSON.parse(val) }
-  }
-  return { ...data, [key]: isWrappedWithQuotes(val) ? val.substring(1, val.length - 1) : val }
-}
-
-function isWrappedWithQuotes(string: string): boolean {
-  return (string.startsWith('"') && string.endsWith('"')) || (string.startsWith("'") && string.endsWith("'"))
-}
-
-/** @internal */
-export function parseConfig(config: ScaffoldCmdConfig & OptionsBase): ScaffoldConfig {
-  let c: ScaffoldConfig = config
-
-  if (config.config) {
-    const [configFile, template = "default"] = config.config.split(":")
-    const configImport: ScaffoldConfigFile = require(path.resolve(process.cwd(), configFile))
-    if (!configImport[template]) {
-      throw new Error(`Template "${template}" not found in ${configFile}`)
-    }
-    c = {
-      ...config,
-      ...configImport[template],
-      data: {
-        ...configImport[template].data,
-        ...config.data,
-      },
-    }
-  }
-
-  c.data = { ...c.data, ...config.appendData }
-  delete config.appendData
-  return c
+  return (_) => value
 }
--- a/tests/config.test.ts
+++ b/tests/config.test.ts
@@ -0,0 +1,149 @@
+import { ScaffoldCmdConfig } from "../src/types"
+import * as config from "../src/config"
+import { resolve } from "../src/utils"
+// @ts-ignore
+import * as configFile from "../scaffold.config"
+
+jest.mock("../src/git", () => {
+  return {
+    __esModule: true,
+    ...jest.requireActual("../src/git"),
+    getGitConfig: () => {
+      return Promise.resolve(blankCliConf)
+    },
+  }
+})
+
+const { githubPartToUrl, parseAppendData, parseConfigFile, parseConfigSelection } = config
+
+const blankCliConf: ScaffoldCmdConfig = {
+  verbose: 0,
+  name: "",
+  output: "",
+  templates: [],
+  data: { name: "test" },
+  overwrite: false,
+  createSubFolder: false,
+  dryRun: false,
+  quiet: false,
+}
+
+describe("config", () => {
+  describe("parseAppendData", () => {
+    test('works for "key=value"', () => {
+      expect(parseAppendData("key=value", blankCliConf)).toEqual({ key: "value", name: "test" })
+    })
+
+    test('works for "key:=value"', () => {
+      expect(parseAppendData("key:=123", blankCliConf)).toEqual({ key: 123, name: "test" })
+    })
+
+    test("overwrites existing value", () => {
+      expect(parseAppendData("name:=123", blankCliConf)).toEqual({ name: 123 })
+    })
+
+    test("works with quotes", () => {
+      expect(parseAppendData('key="value test"', blankCliConf)).toEqual({ key: "value test", name: "test" })
+    })
+  })
+
+  describe("githubPartToUrl", () => {
+    test("works", () => {
+      expect(githubPartToUrl("chenasraf/simple-scaffold")).toEqual("https://github.com/chenasraf/simple-scaffold.git")
+      expect(githubPartToUrl("chenasraf/simple-scaffold.git")).toEqual(
+        "https://github.com/chenasraf/simple-scaffold.git",
+      )
+    })
+  })
+
+  describe("parseConfigSelection", () => {
+    test("no key", () => {
+      expect(parseConfigSelection("scaffold.config.js")).toEqual({
+        configFile: "scaffold.config.js",
+        key: "default",
+        isRemote: false,
+      })
+    })
+    test("separate key", () => {
+      expect(parseConfigSelection("scaffold.config.js", "component")).toEqual({
+        configFile: "scaffold.config.js",
+        key: "component",
+        isRemote: false,
+      })
+    })
+    test("key override", () => {
+      expect(parseConfigSelection("scaffold.config.js:component", "main")).toEqual({
+        configFile: "scaffold.config.js",
+        key: "main",
+        isRemote: false,
+      })
+    })
+    test("isRemote: false", () => {
+      expect(parseConfigSelection("scaffold.config.js", "main")).toEqual({
+        configFile: "scaffold.config.js",
+        key: "main",
+        isRemote: false,
+      })
+    })
+    test("isRemote: true", () => {
+      expect(
+        parseConfigSelection("https://github.com/chenasraf/simple-scaffold.git#scaffold.config.js:component", "main"),
+      ).toEqual({
+        configFile: "https://github.com/chenasraf/simple-scaffold.git#scaffold.config.js",
+        key: "main",
+        isRemote: true,
+      })
+    })
+  })
+
+  describe("parseConfigFile", () => {
+    test("normal config does not change", async () => {
+      expect(
+        await parseConfigFile({
+          ...blankCliConf,
+        }),
+      ).toEqual(blankCliConf)
+    })
+    describe("appendData", () => {
+      test("appends", async () => {
+        const result = await parseConfigFile({
+          ...blankCliConf,
+          appendData: { key: "value" },
+        })
+        expect(result?.data?.key).toEqual("value")
+      })
+      test("overwrites existing value", async () => {
+        const result = await parseConfigFile({
+          ...blankCliConf,
+          data: { num: "123" },
+          appendData: { num: "1234" },
+        })
+        expect(result?.data?.num).toEqual("1234")
+      })
+    })
+  })
+
+  describe("getConfig", () => {
+    test("gets git config", async () => {
+      const resultFn = await config.getConfig({
+        config: "https://github.com/chenasraf/simple-scaffold.git",
+        isRemote: true,
+        quiet: true,
+        verbose: 0,
+      })
+      const result = await resolve(resultFn, blankCliConf)
+      expect(result).toEqual(blankCliConf)
+    })
+
+    test("gets local file config", async () => {
+      const resultFn = await config.getConfig({
+        config: "scaffold.config.js",
+        isRemote: false,
+        quiet: true,
+        verbose: 0,
+      })
+      const result = await resolve(resultFn, {} as any)
+      expect(result).toEqual(configFile)
+    })
+  })
+})
--- a/tests/parser.test.ts
+++ b/tests/parser.test.ts
@@ -0,0 +1,148 @@
+import { ScaffoldCmdConfig, ScaffoldConfig } from "../src/types"
+import path from "node:path"
+import * as dateFns from "date-fns"
+import { OptionsBase } from "massarg/types"
+import { dateHelper, defaultHelpers, handlebarsParse, nowHelper } from "../src/parser"
+
+const blankConf: ScaffoldConfig = {
+  verbose: 0,
+  name: "",
+  output: "",
+  templates: [],
+  data: { name: "test" },
+}
+
+const blankCliConf: ScaffoldCmdConfig & OptionsBase = {
+  verbose: 0,
+  name: "",
+  output: "",
+  templates: [],
+  data: { name: "test" },
+  overwrite: false,
+  createSubFolder: false,
+  dryRun: false,
+  quiet: false,
+  extras: [],
+  help: false,
+}
+
+describe("parser", () => {
+  describe("handlebarsParse", () => {
+    let origSep: any
+    describe("windows paths", () => {
+      beforeAll(() => {
+        origSep = path.sep
+        Object.defineProperty(path, "sep", { value: "\\" })
+      })
+      afterAll(() => {
+        Object.defineProperty(path, "sep", { value: origSep })
+      })
+      test("should work for windows paths", async () => {
+        expect(handlebarsParse(blankConf, "C:\\exports\\{{name}}.txt", { isPath: true }).toString()).toEqual(
+          "C:\\exports\\test.txt",
+        )
+      })
+    })
+    describe("non-windows paths", () => {
+      beforeAll(() => {
+        origSep = path.sep
+        Object.defineProperty(path, "sep", { value: "/" })
+      })
+      afterAll(() => {
+        Object.defineProperty(path, "sep", { value: origSep })
+      })
+      test("should work for non-windows paths", async () => {
+        expect(handlebarsParse(blankConf, "/home/test/{{name}}.txt", { isPath: true })).toEqual(
+          Buffer.from("/home/test/test.txt"),
+        )
+      })
+    })
+    test("should not do path escaping on non-path compiles", async () => {
+      expect(
+        handlebarsParse(
+          { ...blankConf, data: { ...blankConf.data, escaped: "value" } },
+          "/home/test/{{name}} \\{{escaped}}.txt",
+          {
+            isPath: false,
+          },
+        ),
+      ).toEqual(Buffer.from("/home/test/test {{escaped}}.txt"))
+    })
+  })
+
+  describe("Helpers", () => {
+    describe("string helpers", () => {
+      test("camelCase", () => {
+        expect(defaultHelpers.camelCase("test string")).toEqual("testString")
+        expect(defaultHelpers.camelCase("test_string")).toEqual("testString")
+        expect(defaultHelpers.camelCase("test-string")).toEqual("testString")
+        expect(defaultHelpers.camelCase("testString")).toEqual("testString")
+        expect(defaultHelpers.camelCase("TestString")).toEqual("testString")
+        expect(defaultHelpers.camelCase("Test____String")).toEqual("testString")
+      })
+      test("pascalCase", () => {
+        expect(defaultHelpers.pascalCase("test string")).toEqual("TestString")
+        expect(defaultHelpers.pascalCase("test_string")).toEqual("TestString")
+        expect(defaultHelpers.pascalCase("test-string")).toEqual("TestString")
+        expect(defaultHelpers.pascalCase("testString")).toEqual("TestString")
+        expect(defaultHelpers.pascalCase("TestString")).toEqual("TestString")
+        expect(defaultHelpers.pascalCase("Test____String")).toEqual("TestString")
+      })
+      test("snakeCase", () => {
+        expect(defaultHelpers.snakeCase("test string")).toEqual("test_string")
+        expect(defaultHelpers.snakeCase("test_string")).toEqual("test_string")
+        expect(defaultHelpers.snakeCase("test-string")).toEqual("test_string")
+        expect(defaultHelpers.snakeCase("testString")).toEqual("test_string")
+        expect(defaultHelpers.snakeCase("TestString")).toEqual("test_string")
+        expect(defaultHelpers.snakeCase("Test____String")).toEqual("test_string")
+      })
+      test("kebabCase", () => {
+        expect(defaultHelpers.kebabCase("test string")).toEqual("test-string")
+        expect(defaultHelpers.kebabCase("test_string")).toEqual("test-string")
+        expect(defaultHelpers.kebabCase("test-string")).toEqual("test-string")
+        expect(defaultHelpers.kebabCase("testString")).toEqual("test-string")
+        expect(defaultHelpers.kebabCase("TestString")).toEqual("test-string")
+        expect(defaultHelpers.kebabCase("Test____String")).toEqual("test-string")
+      })
+      test("startCase", () => {
+        expect(defaultHelpers.startCase("test string")).toEqual("Test String")
+        expect(defaultHelpers.startCase("test_string")).toEqual("Test String")
+        expect(defaultHelpers.startCase("test-string")).toEqual("Test String")
+        expect(defaultHelpers.startCase("testString")).toEqual("Test String")
+        expect(defaultHelpers.startCase("TestString")).toEqual("Test String")
+        expect(defaultHelpers.startCase("Test____String")).toEqual("Test String")
+      })
+    })
+    describe("date helpers", () => {
+      describe("now", () => {
+        test("should work without extra params", () => {
+          const now = new Date()
+          const fmt = "yyyy-MM-dd HH:mm"
+
+          expect(nowHelper(fmt)).toEqual(dateFns.format(now, fmt))
+        })
+      })
+
+      describe("date", () => {
+        test("should work with no offset params", () => {
+          const now = new Date()
+          const fmt = "yyyy-MM-dd HH:mm"
+
+          expect(dateHelper(now.toISOString(), fmt)).toEqual(dateFns.format(now, fmt))
+        })
+
+        test("should work with offset params", () => {
+          const now = new Date()
+          const fmt = "yyyy-MM-dd HH:mm"
+
+          expect(dateHelper(now.toISOString(), fmt, -1, "days")).toEqual(
+            dateFns.format(dateFns.add(now, { days: -1 }), fmt),
+          )
+          expect(dateHelper(now.toISOString(), fmt, 1, "months")).toEqual(
+            dateFns.format(dateFns.add(now, { months: 1 }), fmt),
+          )
+        })
+      })
+    })
+  })
+})
--- a/tests/scaffold.test.ts
+++ b/tests/scaffold.test.ts
@@ -3,7 +3,7 @@ import FileSystem from "mock-fs/lib/filesystem"
 import Scaffold from "../src/scaffold"
 import { readdirSync, readFileSync } from "fs"
 import { Console } from "console"
-import { defaultHelpers } from "../src/utils"
+import { defaultHelpers } from "../src/parser"
 import { join } from "path"
 import * as dateFns from "date-fns"
 import crypto from "crypto"
--- a/tests/utils.test.ts
+++ b/tests/utils.test.ts
@@ -1,124 +1,21 @@
-import { dateHelper, handlebarsParse, nowHelper, parseAppendData } from "../src/utils"
-import { ScaffoldCmdConfig, ScaffoldConfig } from "../src/types"
-import path from "path"
-import * as dateFns from "date-fns"
-import { OptionsBase } from "massarg/types"
+import { handleErr, resolve } from "../src/utils"

-const blankConf: ScaffoldConfig = {
-  verbose: 0,
-  name: "",
-  output: "",
-  templates: [],
-  data: { name: "test" },
-}
-
-const blankCliConf: ScaffoldCmdConfig & OptionsBase = {
-  verbose: 0,
-  name: "",
-  output: "",
-  templates: [],
-  data: { name: "test" },
-  overwrite: false,
-  createSubFolder: false,
-  dryRun: false,
-  quiet: false,
-  extras: [],
-  help: false,
-}
-
-describe("Utils", () => {
-  describe("handlebarsParse", () => {
-    let origSep: any
-    describe("windows paths", () => {
-      beforeAll(() => {
-        origSep = path.sep
-        Object.defineProperty(path, "sep", { value: "\\" })
-      })
-      afterAll(() => {
-        Object.defineProperty(path, "sep", { value: origSep })
-      })
-      test("should work for windows paths", async () => {
-        expect(handlebarsParse(blankConf, "C:\\exports\\{{name}}.txt", { isPath: true })).toEqual(
-          Buffer.from("C:\\exports\\test.txt"),
-        )
-      })
+describe("utils", () => {
+  describe("resolve", () => {
+    test("should resolve function", () => {
+      expect(resolve(() => 1, null)).toBe(1)
+      expect(resolve((x) => x, 2)).toBe(2)
    })
-    describe("non-windows paths", () => {
-      beforeAll(() => {
-        origSep = path.sep
-        Object.defineProperty(path, "sep", { value: "/" })
-      })
-      afterAll(() => {
-        Object.defineProperty(path, "sep", { value: origSep })
-      })
-      test("should work for non-windows paths", async () => {
-        expect(handlebarsParse(blankConf, "/home/test/{{name}}.txt", { isPath: true })).toEqual(
-          Buffer.from("/home/test/test.txt"),
-        )
-      })
-    })
-    test("should not do path escaping on non-path compiles", async () => {
-      expect(
-        handlebarsParse(
-          { ...blankConf, data: { ...blankConf.data, escaped: "value" } },
-          "/home/test/{{name}} \\{{escaped}}.txt",
-          {
-            isPath: false,
-          },
-        ),
-      ).toEqual(Buffer.from("/home/test/test {{escaped}}.txt"))
+    test("should resolve value", () => {
+      expect(resolve(1, null)).toBe(1)
+      expect(resolve(2, 1)).toBe(2)
    })
  })

-  describe("Helpers", () => {
-    describe("date helpers", () => {
-      describe("now", () => {
-        test("should work without extra params", () => {
-          const now = new Date()
-          const fmt = "yyyy-MM-dd HH:mm"
-
-          expect(nowHelper(fmt)).toEqual(dateFns.format(now, fmt))
-        })
-      })
-
-      describe("date", () => {
-        test("should work with no offset params", () => {
-          const now = new Date()
-          const fmt = "yyyy-MM-dd HH:mm"
-
-          expect(dateHelper(now.toISOString(), fmt)).toEqual(dateFns.format(now, fmt))
-        })
-
-        test("should work with offset params", () => {
-          const now = new Date()
-          const fmt = "yyyy-MM-dd HH:mm"
-
-          expect(dateHelper(now.toISOString(), fmt, -1, "days")).toEqual(
-            dateFns.format(dateFns.add(now, { days: -1 }), fmt),
-          )
-          expect(dateHelper(now.toISOString(), fmt, 1, "months")).toEqual(
-            dateFns.format(dateFns.add(now, { months: 1 }), fmt),
-          )
-        })
-      })
-    })
-  })
-
-  describe("parseAppendData", () => {
-    test('works for "key=value"', () => {
-      expect(parseAppendData("key=value", blankCliConf)).toEqual({ key: "value", name: "test" })
-    })
-
-    test('works for "key:=value"', () => {
-      expect(parseAppendData("key:=123", blankCliConf)).toEqual({ key: 123, name: "test" })
-    })
-
-    test("overwrites existing value", () => {
-      expect(parseAppendData("name:=123", blankCliConf)).toEqual({ name: 123 })
-    })
-
-    test("works with quotes", () => {
-      expect(parseAppendData('key="value test"', blankCliConf)).toEqual({ key: "value test", name: "test" })
+  describe("handleErr", () => {
+    test("should throw error", () => {
+      expect(() => handleErr({ name: "test", message: "test" })).toThrow()
+      expect(() => handleErr(null as never)).not.toThrow()
    })
  })
 })
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,15 +1,19 @@
 {
+  "$schema": "https://json.schemastore.org/tsconfig",
  "compilerOptions": {
-    "target": "ES2019",
+    "target": "ES2022",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
-    "lib": ["ES2019"],
+    "lib": ["ES2022"],
    "declaration": true,
    "outDir": "dist",
    "strict": true,
    "sourceMap": true,
-    "removeComments": false
+    "removeComments": false,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
  },
  "include": ["src/index.ts", "src/cmd.ts"],
  "exclude": ["tests/*"]
--- a/typedoc.config.js
+++ b/typedoc.config.js
@@ -1,4 +1,4 @@
-const path = require("path")
+const path = require("node:path")

 /** @type {import('typedoc').TypeDocOptions} */
 module.exports = {
--- a/yarn.lock
+++ b/yarn.lock
Author	SHA1	Message	Date
semantic-release-bot	4d1a6e1f0d	chore(release): 1.9.0 [skip ci] # [1.9.0](https://github.com/chenasraf/simple-scaffold/compare/v1.8.0...v1.9.0) (2024-01-02) ### Features * add --recurse-submodules to git clone ([`cbaf130`](`cbaf130a0c`))	2024-01-02 00:20:20 +00:00
Chen Asraf	daae9c10f9	ci: fix actions	2024-01-02 02:19:46 +02:00
Chen Asraf	758719de5d	chore: update dependencies	2024-01-02 02:19:46 +02:00
Chen Asraf	1903055d46	ci: update build steps	2024-01-02 02:19:46 +02:00
Claudio Barca	cbaf130a0c	feat: add --recurse-submodules to git clone	2024-01-02 02:19:46 +02:00
Chen Asraf	e26fe2a3d4	ci: update build process	2024-01-02 02:19:46 +02:00
Chen Asraf	7e1acf0607	ci: update docs build, semantic release docs: update config files entry	2024-01-02 02:19:46 +02:00
semantic-release-bot	f666c357f4	chore(release): 1.8.0 [skip ci] ## [1.8.0](https://github.com/chenasraf/simple-scaffold/compare/v1.7.2...v1.8.0) (2023-11-29) ### Bug Fixes * config: fn config load ([`457c904`](`457c90470b`)), closes [#63](https://github.com/chenasraf/simple-scaffold/issues/63)	2023-11-29 22:16:52 +00:00
Chen Asraf	f5d55f234a	docs: update configuration files docs	2023-11-30 00:12:11 +02:00
semantic-release-bot	746f924a22	chore(release): 1.8.0-pre.1 [skip ci] ## [1.8.0-pre.1](https://github.com/chenasraf/simple-scaffold/compare/v1.7.2...v1.8.0-pre.1) (2023-11-27) ### Bug Fixes * config: fn config load ([`457c904`](`457c90470b`)), closes [#63](https://github.com/chenasraf/simple-scaffold/issues/63)	2023-11-30 00:12:11 +02:00
Chen Asraf	807c3e27e2	ci: update release config	2023-11-28 00:49:28 +02:00
Chen Asraf	b048841dac	chore: update dependencies	2023-11-28 00:49:28 +02:00
Chen Asraf	457c90470b	fix(config): fn config load closes #63	2023-11-28 00:49:28 +02:00
dependabot[bot]	0fa1ad4db7	build(deps-dev): bump @babel/traverse from 7.21.5 to 7.23.2 Bumps [@babel/traverse](https://github.com/babel/babel/tree/HEAD/packages/babel-traverse) from 7.21.5 to 7.23.2. - [Release notes](https://github.com/babel/babel/releases) - [Changelog](https://github.com/babel/babel/blob/main/CHANGELOG.md) - [Commits](https://github.com/babel/babel/commits/v7.23.2/packages/babel-traverse) --- updated-dependencies: - dependency-name: "@babel/traverse" dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com>	2023-11-28 00:49:28 +02:00
semantic-release-bot	d62eeeb8e4	chore(release): 1.7.2 [skip ci] ## [1.7.2](https://github.com/chenasraf/simple-scaffold/compare/v1.7.1...v1.7.2) (2023-08-20) ### Bug Fixes * windows path resolution ([`98ee000`](`98ee00031f`))	2023-08-20 10:09:48 +00:00
Chen Asraf	565d1f33aa	Merge pull request #61 from chenasraf/pre v1.7.2	2023-08-20 13:08:25 +03:00
semantic-release-bot	9f58fff2cf	chore(release): 1.7.2-pre.1 [skip ci] ## [1.7.2-pre.1](https://github.com/chenasraf/simple-scaffold/compare/v1.7.1...v1.7.2-pre.1) (2023-08-15) ### Bug Fixes * windows path resolution ([`98ee000`](`98ee00031f`))	2023-08-15 19:34:02 +00:00
Chen Asraf	dbba81d053	ci: trigger on pre branch	2023-08-15 22:32:25 +03:00
Chen Asraf	9f5716e1b9	chore: bump version number	2023-08-15 22:31:38 +03:00
Chen Asraf	4cbb79bb3b	Merge pull request #60 from chenasraf/fix/windows [BUGFIX] Windows path resolution	2023-08-15 22:28:04 +03:00
Chen Asraf	98ee00031f	fix: windows path resolution	2023-08-14 00:19:50 +03:00
Chen Asraf	8c3369a00d	chore: formatting	2023-08-14 00:19:36 +03:00
Chen Asraf	20ef0cea9b	chore: update logs	2023-08-14 00:08:16 +03:00
Chen Asraf	3413151358	test: add tests chore: use node:* modules for builtins	2023-06-12 23:26:25 +03:00
Chen Asraf	d2a2fda1b1	chore: update dependencies	2023-06-12 23:18:50 +03:00
Chen Asraf	486c07a55b	Merge branch 'master' into develop	2023-06-08 08:13:52 +03:00
semantic-release-bot	de05bca546	chore(release): 1.7.1 [skip ci] ## [1.7.1](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0...v1.7.1) (2023-06-07) ### Bug Fixes * local config file load error ([`2b74239`](`2b7423993b`))	2023-06-07 23:56:29 +00:00
Chen Asraf	72d4cf58c5	Merge pull request #58 from chenasraf/develop v1.7.1	2023-06-08 02:55:06 +03:00
Chen Asraf	2cf31e827e	build: fix tsconfig	2023-06-08 02:52:45 +03:00
Chen Asraf	3714e8b3bd	build: update release rules, add tests	2023-06-08 02:50:50 +03:00
semantic-release-bot	77be7c09d5	chore(release): 1.7.1-develop.1 [skip ci] ## [1.7.1-develop.1](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0...v1.7.1-develop.1) (2023-06-07) ### Bug Fixes * local config file load error ([`2b74239`](`2b7423993b`))	2023-06-07 21:51:53 +00:00
Chen Asraf	1246b51cda	Merge branch 'master' into develop # Conflicts: # CHANGELOG.md # package.json	2023-06-08 00:50:24 +03:00
semantic-release-bot	fea6c0fb16	chore(release): 1.7.0-develop.7 [skip ci] ## [1.7.0-develop.7](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.6...v1.7.0-develop.7) (2023-06-07) ### Bug Fixes * local config file load error ([`2b74239`](`2b7423993b`))	2023-06-07 20:22:57 +00:00
Chen Asraf	2b7423993b	fix: local config file load error	2023-06-07 23:21:12 +03:00
semantic-release-bot	a47ba1186c	chore(release): 1.7.0-develop.6 [skip ci] ## [1.7.0-develop.6](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.5...v1.7.0-develop.6) (2023-05-27)	2023-05-27 23:16:21 +00:00
Chen Asraf	06b1552dca	docs: update README.md	2023-05-28 02:14:36 +03:00
semantic-release-bot	4868925511	chore(release): 1.7.0 [skip ci] ## [1.7.0](https://github.com/chenasraf/simple-scaffold/compare/v1.6.0...v1.7.0) (2023-05-17) ### Features * function config file ([`02a8ba1`](`02a8ba16cd`)) ### Bug Fixes * use path.normalize ([`565090a`](`565090a951`))	2023-05-17 17:30:07 +00:00
Chen Asraf	79cfdbed38	Merge pull request #57 from chenasraf/develop release	2023-05-17 20:28:02 +03:00
Chen Asraf	4f27b7b934	test: add tests	2023-05-13 02:36:26 +03:00
semantic-release-bot	bee430a40d	chore(release): 1.7.0-develop.5 [skip ci] ## [1.7.0-develop.5](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.4...v1.7.0-develop.5) (2023-05-12)	2023-05-12 22:59:55 +00:00
Chen Asraf	3dfc920455	test: fix + add tests	2023-05-13 01:58:21 +03:00
Chen Asraf	68307d1378	refactor: remove lodash dependency	2023-05-13 01:29:59 +03:00
Chen Asraf	33e1d569a3	build: update workflows	2023-05-13 01:29:40 +03:00
semantic-release-bot	c446439b1a	chore(release): 1.7.0-develop.4 [skip ci] ## [1.7.0-develop.4](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.3...v1.7.0-develop.4) (2023-05-11)	2023-05-11 21:03:55 +00:00
Chen Asraf	773fd00674	build: update package asset name	2023-05-12 00:02:36 +03:00
semantic-release-bot	22763f655e	chore(release): 1.7.0-develop.3 [skip ci] ## [1.7.0-develop.3](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.2...v1.7.0-develop.3) (2023-05-11)	2023-05-11 20:28:22 +00:00
Chen Asraf	a54b1f9fa7	build: update package link	2023-05-11 23:26:59 +03:00
Chen Asraf	dac5527173	build: add packageManager key to package.json	2023-05-11 22:59:36 +03:00
Chen Asraf	339459cad8	build: update workflows	2023-05-11 22:55:52 +03:00
Chen Asraf	62b4a1cd2f	build: update workflows	2023-05-11 22:52:36 +03:00
Chen Asraf	5844c080ec	build: use pnpm	2023-05-11 22:35:59 +03:00
Chen Asraf	9393c546aa	chore: cleanup	2023-05-11 22:35:48 +03:00
semantic-release-bot	263bf0bf36	chore(release): 1.7.0-develop.2 [skip ci] ## [1.7.0-develop.2](https://github.com/chenasraf/simple-scaffold/compare/v1.7.0-develop.1...v1.7.0-develop.2) (2023-05-10)	2023-05-10 21:03:34 +00:00
Chen Asraf	e0ed371adb	build: update release.config.js	2023-05-10 22:18:07 +03:00
semantic-release-bot	87934fb3d1	chore(release): 1.7.0-develop.1 [skip ci] ## [1.7.0-develop.1](https://github.com/chenasraf/simple-scaffold/compare/v1.6.0...v1.7.0-develop.1) (2023-05-09) ### Features * function config file ([`02a8ba1`](`02a8ba16cd`)) ### Bug Fixes * use path.normalize ([`565090a`](`565090a951`))	2023-05-09 21:15:15 +00:00
Chen Asraf	19b7ed5f06	build: fix build	2023-05-10 00:13:10 +03:00
Chen Asraf	c027e37d9a	chore: cleanups	2023-05-10 00:10:21 +03:00
Chen Asraf	2251a9c727	chore: cleanups	2023-05-10 00:08:45 +03:00
Chen Asraf	02a8ba16cd	feat: function config file	2023-05-09 22:51:40 +03:00
Chen Asraf	565090a951	fix: use path.normalize	2023-05-08 00:28:47 +03:00
Chen Asraf	943aad1564	docs: update docs	2023-05-06 02:23:03 +03:00
Chen Asraf	9fb4762c7b	test: move scaffold.config.js	2023-05-06 02:22:42 +03:00
Chen Asraf	be92047d65	docs: update readme + author	2023-05-06 01:38:23 +03:00
semantic-release-bot	0940e843ac	chore(release): 1.6.0 [skip ci] ## [1.6.0](https://github.com/chenasraf/simple-scaffold/compare/v1.5.0...v1.6.0) (2023-05-05) ### Features * node.js function for remote configs ([`ce5adbe`](`ce5adbe0f8`)) ### Bug Fixes * move dependency to dev dependency ([`d916d88`](`d916d88384`))	2023-05-05 22:33:58 +00:00
Chen Asraf	a880bc9445	Merge pull request #56 from chenasraf/develop Release 1.6.0	2023-05-06 01:32:25 +03:00
Chen Asraf	6c8eb02cbb	build: fix package.json version update	2023-05-04 23:21:16 +03:00
Chen Asraf	08b048845f	build: use pnpm instead of yarn	2023-05-04 23:00:24 +03:00
Chen Asraf	77e477e07f	chore(release): bump version number	2023-05-04 22:16:48 +03:00
Chen Asraf	5ba6034b2f	docs: fix changelog title	2023-05-04 22:12:35 +03:00
Chen Asraf	95dafdf839	docs: update docs	2023-05-04 22:08:39 +03:00
semantic-release-bot	4c3f1c97d1	chore(release): 1.6.0-develop.1 [skip ci] ## [1.6.0-develop.1](https://github.com/chenasraf/simple-scaffold/compare/v1.5.0...v1.6.0-develop.1) (2023-05-04) ### Features * node.js function for remote configs ([`ce5adbe`](`ce5adbe0f8`)) ### Bug Fixes * move dependency to dev dependency ([`d916d88`](`d916d88384`))	2023-05-04 19:04:57 +00:00
Chen Asraf	1799971949	docs: update package description	2023-05-04 22:03:08 +03:00
semantic-release-bot	4bf96742b3	chore(release): 1.5.0-develop.3 [skip ci] ## [1.5.0-develop.3](https://github.com/chenasraf/simple-scaffold/compare/v1.5.0-develop.2...v1.5.0-develop.3) (2023-05-04) ### Features * node.js function for remote configs ([`7e9022f`](`7e9022f433`))	2023-05-04 22:00:38 +03:00
Chen Asraf	ce5adbe0f8	feat: node.js function for remote configs	2023-05-04 22:00:38 +03:00
Chen Asraf	9489f14db2	build: separate test & build	2023-05-04 22:00:38 +03:00
Chen Asraf	99318f7654	build: remove unnecessary dependency	2023-05-04 22:00:38 +03:00
semantic-release-bot	81743f1fff	chore(release): 1.5.0-develop.2 [skip ci] ## [1.5.0-develop.2](https://github.com/chenasraf/simple-scaffold/compare/v1.5.0-develop.1...v1.5.0-develop.2) (2023-05-03) ### Bug Fixes * move dependency to dev dependency ([`408a940`](`408a940853`))	2023-05-04 22:00:38 +03:00
Chen Asraf	d916d88384	fix: move dependency to dev dependency	2023-05-04 22:00:07 +03:00
Chen Asraf	260ce6a8f3	docs: update docs	2023-05-04 22:00:07 +03:00
Chen Asraf	ba984b6621	docs: fix link	2023-05-04 22:00:07 +03:00
Chen Asraf	7b6260caf8	docs: update docs	2023-05-04 22:00:07 +03:00
Chen Asraf	2ca91a7109	docs: fix cli.md page	2023-05-04 22:00:07 +03:00
semantic-release-bot	7be79fdcaf	chore(release): 1.5.0 [skip ci] ## [1.5.0](https://github.com/chenasraf/simple-scaffold/compare/v1.4.0...v1.5.0) (2023-05-02) ### Features * add github remote templates ([`f961c13`](`f961c13da1`)) * support for remote template configs ([`05487f4`](`05487f4d1e`))	2023-05-02 07:28:17 +00:00
Chen Asraf	6afbcdc258	Merge pull request #55 from chenasraf/develop v1.5.0	2023-05-02 10:27:11 +03:00
Chen Asraf	1a3fd3d610	docs: update help text	2023-05-02 10:23:50 +03:00
Chen Asraf	7f10db0d6e	chore: bump version number	2023-05-02 10:16:47 +03:00
semantic-release-bot	93f5b4a004	chore(release): 1.5.0-develop.1 [skip ci] ## [1.5.0-develop.1](https://github.com/chenasraf/simple-scaffold/compare/v1.4.0...v1.5.0-develop.1) (2023-05-02) ### Features * add github remote templates ([`f961c13`](`f961c13da1`)) * support for remote template configs ([`05487f4`](`05487f4d1e`))	2023-05-02 07:12:11 +00:00
Chen Asraf	b74411ddb8	docs: add docs for remote templates	2023-05-02 10:10:50 +03:00
Chen Asraf	f961c13da1	feat: add github remote templates	2023-05-02 09:46:53 +03:00
Chen Asraf	05487f4d1e	feat: support for remote template configs	2023-05-02 09:33:54 +03:00
Chen Asraf	c50518a19c	build: fix git/github step order	2023-04-29 17:17:15 +03:00
Chen Asraf	10ea6b4132	chore: fix package version	2023-04-29 17:11:18 +03:00
Chen Asraf	ce399181ab	build: always build docs	2023-04-29 17:05:50 +03:00
semantic-release-bot	83d38073f3	chore(release): 1.4.0 [skip ci] ## [1.4.0](https://github.com/chenasraf/simple-scaffold/compare/v1.3.2...v1.4.0) (2023-04-28) ### Features * add `--key` \| `-k` to config loader ([`6c5ba0b`](`6c5ba0bc91`))	2023-04-28 23:01:48 +00:00
Chen Asraf	6c5ba0bc91	feat: add `--key` \| `-k` to config loader	2023-04-29 01:59:39 +03:00
semantic-release-bot	2c4eccd800	chore(release): 1.3.2 [skip ci] ## [1.3.2](https://github.com/chenasraf/simple-scaffold/compare/v1.3.1...v1.3.2) (2023-04-28) ### Bug Fixes * release build ([`2c23fa9`](`2c23fa9dbb`)) * release build asset ([`0bef2df`](`0bef2df5f3`))	2023-04-28 22:08:51 +00:00
Chen Asraf	2c23fa9dbb	fix: release build	2023-04-29 01:04:01 +03:00
Chen Asraf	0bef2df5f3	fix: release build asset	2023-04-29 00:59:54 +03:00
semantic-release-bot	398a5d723b	chore(release): 1.3.1 [skip ci] ## [1.3.1](https://github.com/chenasraf/simple-scaffold/compare/v1.3.0...v1.3.1) (2023-04-28) ### Bug Fixes * docs ([`6e19a86`](`6e19a86190`)) * remove old peer-dep ([`c7e2ef8`](`c7e2ef862c`))	2023-04-28 21:50:36 +00:00
Chen Asraf	c7e2ef862c	fix: remove old peer-dep	2023-04-29 00:44:49 +03:00
Chen Asraf	36dd27e480	docs: fix doc links	2023-04-29 00:44:49 +03:00
Chen Asraf	6e19a86190	fix: docs	2023-04-29 00:44:49 +03:00
Chen Asraf	eba7897f84	chore: bump version number + fix changelog	2023-04-29 00:44:38 +03:00