binary-collections 2.0.11 → 2.0.13

package/readme.md

@@ -1,59 +1,94 @@
-# Binary Collections
-A comprehensive toolkit of Node.js CLI utilities for streamlining development workflows. Includes tools for git operations, dependency management, build processes, automation, and more.
+# 🚀 Binary Collections
 
-## Features
+A comprehensive toolkit of Node.js CLI utilities designed to streamline everyday development workflows.
 
-- 🧹 **Cleanup Tools**: Remove node_modules, yarn caches, gradle builds
-- 🔄 **Git Utilities**: Submodule management, repository purging, diff tools
-- 📦 **Build Tools**: NPM script runners, package management utilities
-- ⚡ **Development Helpers**: Process management, environment setup tools
+It provides fast, lightweight commands for common tasks like git operations, dependency management, submodule handling, and running npm scripts in sequence or parallel—helping you reduce repetitive work and improve terminal productivity.
+
+## ✨ Features
+
+* ⚡ **Git Workflow Utilities**
+  Streamline common Git tasks including diff enhancements, status automation, submodule management, and repository cleanup.
+
+* 🧹 **Cleanup Tools**
+  Quickly remove `node_modules`, clear package manager caches (npm/yarn), and clean build artifacts such as Gradle outputs.
+
+* 🔁 **Task Orchestration**
+  Run npm scripts sequentially or in parallel with improved control and execution clarity.
+
+* 📁 **Repository & Submodule Automation**
+  Simplify initialization, syncing, and maintenance of Git submodules and multi-repository setups.
+
+* 📦 **Build & Package Utilities**
+  Enhance NPM workflows with improved script execution, dependency handling, and resolution helpers.
+
+* 🛠️ **Development Helpers**
+  General-purpose utilities for process management, environment setup, and file system operations.
+
+* 🚀 **Performance-Focused CLI Design**
+  Lightweight, fast-executing commands designed to reduce friction and speed up everyday development tasks.
 
 ## Installation
 
-### Clone Repository
-```bash
-git clone -b master https://github.com/dimaslanjaka/bin bin
-```
+### Option 1: NPM Package
+Install locally to your project or globally for system-wide access.
 
-### NPM Installation
 ```bash
-# Install locally
+# Local installation
 npm install binary-collections
 
-# Install globally
+# Global installation
 npm install binary-collections -g
 
-# Install from release archive
+# Install from specific release archive
 npm install binary-collections@https://github.com/dimaslanjaka/bin/raw/master/releases/bin.tgz
 ```
 
-### Direct run
+### Option 2: Direct Execution
+Run without installing using `npx` or `yarn dlx`.
 
 ```bash
-# Yarn berry
+# Using Yarn Berry
 yarn dlx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz <command-name>
 
-# NPX
-npx -y binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz <command-name>
+# Using NPX
+npx --legacy-peer-deps -y binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz <command-name>
 ```
 
-## VSCode Setup
+### Option 3: Clone Repository
+For development or manual setup.
 
-Create `.vscode/settings.json` to add binary tools to your PATH:
+```bash
+git clone -b master https://github.com/dimaslanjaka/bin bin
+```
+
+## VSCode Integration
+
+To make these tools available directly in your VSCode terminal, create or update `.vscode/settings.json`:
 
 ```jsonc
 {
   "terminal.integrated.env.linux": {
-    "PATH": "${env:PATH}:${workspaceFolder}/node_modules/.bin:${workspaceFolder}/bin"
+    "PATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/usr/lib/wsl/lib:${workspaceFolder}/bin:${workspaceFolder}/node_modules/.bin:${workspaceFolder}/vendor/bin",
+    "PUPPETEER_SKIP_DOWNLOAD": "true"
   },
   "terminal.integrated.env.windows": {
-    "PATH": "${env:PATH};${workspaceFolder}\\node_modules\\.bin;${workspaceFolder}\\bin"
+    "PATH": "${env:LOCALAPPDATA}\\nvm;C:\\nvm4w\\nodejs;C:\\Program Files\\Git\\cmd;C:\\Program Files\\Git\\usr\\bin;${env:PATH};${workspaceFolder}\\node_modules\\.bin;${workspaceFolder}\\bin;${workspaceFolder}\\vendor\\bin;C:\\laragon\\bin\\mysql\\mysql-8.4.3-winx64\\bin;C:\\Users\\Dell\\AppData\\Local\\Programs\\Ollama",
+    "PUPPETEER_SKIP_DOWNLOAD": "true"
   },
   "terminal.integrated.profiles.windows": {
     "PowerShell": {
       "source": "PowerShell",
       "icon": "terminal-powershell"
     },
+    "Short PowerShell": {
+      "source": "PowerShell",
+      "args": [
+        "-NoExit",
+        "-Command",
+        "function prompt { \"[$((Get-Item .).Name)]> \" }"
+      ],
+      "icon": "terminal-powershell"
+    },
     "Command Prompt": {
       "path": [
         "${env:windir}\\Sysnative\\cmd.exe",
@@ -62,12 +97,25 @@ Create `.vscode/settings.json` to add binary tools to your PATH:
       "args": [],
       "icon": "terminal-cmd"
     },
+    "Short Command Prompt": {
+      "path": [
+        "${env:windir}\\System32\\cmd.exe"
+      ],
+      "args": [
+        "/k",
+        "prompt $p$_$g"
+      ],
+      "icon": "terminal-cmd"
+    },
     "Git Bash": {
       "source": "Git Bash"
     },
     "Cygwin": {
       "path": "C:\\cygwin64\\bin\\bash.exe",
-      "args": ["--login", "-i"],
+      "args": [
+        "--login",
+        "-i"
+      ],
       "env": {
         "CHERE_INVOKING": "1"
       }
@@ -79,203 +127,42 @@ Create `.vscode/settings.json` to add binary tools to your PATH:
 
 ## Available Tools
 
-### Quick Reference
-
-| Category | Commands | Description |
-|---|---|---|
-| **Git** | `git-purge`, `git-diff`, `git-fix`, `git-reduce-size` | Git repository management and optimization |
-| **Submodules** | `submodule`, `submodule-install`, `submodule-remove`, `submodule-token` | Git submodule operations |
-| **NPM Scripts** | `nrs`, `run-s`, `run-series`, `npm-run-series` | Run npm scripts in series with pattern matching |
-| **Package Mgmt** | `yarn-reinstall`, `pkg-resolutions-updater`, `pkg-res-updater` | Yarn/package resolutions management utilities |
-| **Node.js Dev** | `find-node-modules`, `find-nodemodules`, `dev`, `prod`, `empty` | Node.js development helpers |
-| **Process Mgmt** | `kill-process`, `nodekill`, `javakill`, `del-ps` | Process management and termination |
-| **File System** | `rmfind`, `rmpath`, `rmx`, `print-tree`, `dir-tree` | File system operations |
-| **Cleanup** | `del-nodemodules`, `del-yarncaches`, `del-gradle` | Cache and build directory cleanup |
-| **GitHub Actions** | `clean-github-actions-caches`, `clean-github-actions-cache`, `clear-github-actions-cache`, `clear-github-actions-caches`, `clear-gh-caches` | Remove old GitHub Actions caches, keep only latest |
-
-### Git Tools
-
-#### Git Repository Purge
-Clean and optimize git repositories by pruning reflogs:
-```bash
-git-purge
-```
-![Git purge screenshot](https://github.com/dimaslanjaka/bin/assets/12471057/2805c54e-28a7-491d-b381-de2593a854b3)
-
-#### Git Diff Utility
-Enhanced git diff functionality:
-```bash
-git-diff
-```
-
-#### Git Fix Utility
-Comprehensive Git configuration fixer for cross-platform development (replaces `git-fix-encoding`):
+To view a complete list of available binaries, run:
 ```bash
-git-fix                          # Apply all fixes
-git-fix --lf-only                # Force LF line endings only
-git-fix --permissions            # Ignore file permissions only
-git-fix --normalize              # Normalize existing files only
-git-fix --user                   # Configure Git user from environment
-git-fix --user NAME EMAIL        # Configure Git user with specific values
-git-fix --user --update-remote   # Also update remote URL to match user
-git-fix --user NAME EMAIL --update-remote  # Configure user and update remote URL
+binary-collections list
 ```
-Features:
-- Forces LF line endings (`core.autocrlf = false`)
-- Ignores file permission changes (`core.filemode = false`)
-- Sets pull strategy to false (prevents auto-rebase)
-- Normalizes existing line endings
-- Creates/updates `.gitattributes` with proper line ending rules
-- Configures Git user from environment variables or CLI arguments
-- **Non-interactive:** All configuration is now argument-driven; no interactive prompts
-- `--update-remote` flag: Update remote URL to match the configured user (for HTTPS remotes)
-
-User Configuration:
-- Environment variables: `GITHUB_USER`, `GITHUB_EMAIL`
-- CLI arguments take precedence over environment variables
-- Use `--update-remote` to update the remote URL with the configured user
-- Examples:
-  ```bash
-  git-fix --user "John Doe" "john@example.com"  # Use CLI args
-  git-fix --user --update-remote                 # Use env vars and update remote
-  git-fix --user "Jane" "jane@example.com" --update-remote  # CLI args and update remote
-  GITHUB_USER="Jane" GITHUB_EMAIL="jane@example.com" git-fix --user  # Use env vars
-  ```
-
-#### Git Repository Size Reducer
-Reduce git repository size by cleaning up history:
-```bash
-git-reduce-size
-```
-
-#### Submodule Management
-- **`submodule`** - General submodule operations
-- **`submodule-install`** - Install and setup submodules
-- **`submodule-remove`** - Remove git submodules with interactive selection
-- **`submodule-token`** - Manage submodule tokens
-
-![Submodule remover screenshot](https://github.com/user-attachments/assets/659c2fa3-f12f-45cb-a66f-aed3807e0023)
-
 
-### NPM Script Runner
+### Quick Reference & Command Documentation
 
-**Binaries**: `nrs`, `run-s`, `run-series`, `npm-run-series`
+| Category | Commands | Description | Docs |
+|---|---|---|---|
+| **Git** | `git-purge`, `git-diff`, `git-fix`, `git-reduce-size`, `git-undo` | Git repository management and optimization | [`git-purge.md`](./docs-src/git-purge.md), [`git-diff.md`](./docs-src/git-diff.md), [`git-fix.md`](./docs-src/git-fix.md), [`git-reduce-size.md`](./docs-src/git-reduce-size.md), [`git-undo.md`](./docs-src/git-undo.md) |
+| **Submodules** | `submodule`, `submodule-install`, `submodule-remove`, `submodule-token` | Git submodule operations | [`submodule-install.md`](./docs-src/submodule-install.md), [`submodule-remove.md`](./docs-src/submodule-remove.md), [`submodule-token.md`](./docs-src/submodule-token.md) |
+| **NPM Scripts** | `nrs`, `run-s`, `run-series`, `npm-run-series` | Run npm scripts in series with pattern matching | [`npm-run-series.md`](./docs-src/npm-run-series.md) |
+| **Package Mgmt** | `yarn-reinstall`, `pkg-resolutions-updater`, `pkg-res-updater`, `yarn-install`, `yarn-clean` | Yarn/package resolutions management utilities | [`yarn-reinstall.md`](./docs-src/yarn-reinstall.md), [`yarn-install.md`](./docs-src/yarn-install.md), [`node-cache-cleaner.md`](./docs-src/node-cache-cleaner.md), [`package-resolutions-updater.md`](./docs-src/package-resolutions-updater.md) |
+| **Node.js Dev** | `find-node-modules`, `find-nodemodules`, `dev`, `prod`, `empty`, `node-cache-cleaner`, `node-executor`, `py` | Node.js development helpers | [`find-node-modules.md`](./docs-src/find-node-modules.md), [`env-helpers.md`](./docs-src/env-helpers.md), [`node-cache-cleaner.md`](./docs-src/node-cache-cleaner.md), [`node-executor.md`](./docs-src/node-executor.md), [`py.md`](./docs-src/py.md) |
+| **Process Mgmt** | `kill-process`, `nodekill`, `javakill`, `del-ps`, `kill-night-crows` | Process management and termination | [`del-ps.md`](./docs-src/del-ps.md), [`kill-night-crows.md`](./docs-src/kill-night-crows.md) |
+| **File System** | `rmfind`, `rmpath`, `rmx`, `print-tree`, `dir-tree`, `copy`, `move`, `remove-module` | File system operations | [`copy-move-file.md`](./docs-src/copy-move-file.md), [`rmpath.md`](./docs-src/rmpath.md), [`rmfind-rmx.md`](./docs-src/rmfind-rmx.md), [`print-directory-tree.md`](./docs-src/print-directory-tree.md), [`remove-module.md`](./docs-src/remove-module.md) |
+| **Cleanup** | `del-nodemodules`, `del-yarncaches`, `del-gradle`, `del-yarn-caches`, `yarn-clean` | Cache and build directory cleanup | [`node-cache-cleaner.md`](./docs-src/node-cache-cleaner.md), [`del-gradle.md`](./docs-src/del-gradle.md) |
+| **GitHub Actions** | `clean-github-actions-caches`, `clean-github-actions-cache`, `clear-github-actions-cache`, `clear-github-actions-caches`, `clear-gh-caches` | Remove old GitHub Actions caches, keep only latest | [`clean-github-actions-caches.md`](./docs-src/clean-github-actions-caches.md) |
+| **Other** | `binary-collections`, `changelog`, `php-cs-fixer-staged`, `free-chatgpt`, `test-runners` | Miscellaneous utilities and documentation | [`binary-collections.md`](./docs-src/binary-collections.md), [`changelog.md`](./docs-src/changelog.md), [`php-cs-fixer-staged.md`](./docs-src/php-cs-fixer-staged.md), [`free-chatgpt.md`](./docs-src/free-chatgpt.md), [`test-runners.md`](./docs-src/test-runners.md) |
 
-Run multiple npm scripts in series with pattern matching support.
-
-#### Options
-| Flag                | Description                                 |
-|---------------------|---------------------------------------------|
-| `--yarn`            | Use `yarn run <script-name>` instead of npm |
-| `--verbose`, `-v`   | Enable verbose output                       |
-
-#### Example
-Execute all scripts matching the pattern `namescript:**`:
-```json
-{
-  "name": "package-name",
-  "version": "0.0.0",
-  "private": true,
-  "scripts": {
-    "namescript:xx": "echo xx",
-    "namescript:xxx": "echo xxx",
-    "namescript:xxxx": "echo xxxx",
-    "namescript:xxxxx": "echo xxxxx",
-    "namescript": "nrs --yarn=true --verbose=true \"namescript:**\""
-  },
-  "license": "ISC"
-}
-```
-
-### Package Management Tools
-
-#### Yarn Package Reinstaller
-Reinstall yarn packages with dependency type flags:
-```bash
-yarn-reinstall <packageName> [--dev|-D|--peer|-P|--optional|-O]
-```
-
-#### Package Resolutions Manager
-Manage package resolutions in package.json (aliases: `pkg-resolutions-updater`, `pkg-res-updater`):
-```bash
-pkg-resolutions-updater
-pkg-res-updater
-```
-
-### Node.js Development Tools
-
-#### Node Modules Finder
-Find all node_modules directories in a project:
-```bash
-find-node-modules      # Library function
-find-node-modules-cli  # CLI tool
-find-nodemodules       # Alias
-```
-
-#### Development Environment Helpers
-- **`dev`** - Development environment setup
-- **`prod`** - Production environment setup
-- **`empty`** - Empty utility tool
-
-### Process Management Tools
-
-#### Process Killers
-Kill processes by name or pattern:
-```bash
-kill-process    # General process killer
-nodekill        # Kill Node.js processes
-javakill        # Kill Java processes (Windows)
-del-ps          # Kill processes by command name
-```
-
-#### File System Tools
-- **`rmfind`** - Find and remove files
-- **`rmpath`** - Remove from PATH
-- **`rmx`** - Remove executable files
-
-### Cleanup Tools
-
-#### GitHub Actions Cache Cleaner
-[See full documentation](./docs-src/clean-github-actions-caches.md).
-
-#### Node Modules Cleaner
-Remove node_modules directories recursively:
-```bash
-del-nodemodules        # Primary command
-del-node-modules       # Alternative
-clean-nodemodule       # Legacy
-clean-nodemodules      # Legacy
-```
-![Node modules cleaner screenshot](https://github.com/dimaslanjaka/bin/assets/12471057/f03e5b51-1808-4e82-a474-0dd3c7eab5fe)
-
-#### Yarn Cache Cleaner
-Clear yarn cache directories:
-```bash
-del-yarncaches         # Primary command
-del-yarn-caches        # Alternative
-```
-
-#### Gradle Build Cleaner
-Delete gradle build folders:
-```bash
-del-gradle
-```
-
-#### Free ChatGPT automation tool
-
-[See full documentation](./docs-src/free-chatgpt.md)
+---
 
 ## Troubleshooting
 
 ### Submodule Installation Issues
-If you encounter the following error:
+
+**Error:**
 ```log
 fatal: 'origin/<branch>' is not a commit and a branch '<branch>' cannot be created from it
 fatal: unable to checkout submodule '<folder>/<submodule>'
 ```
-**Solution**: Delete `.git/modules` directory before running `submodule-install`.
 
-#### Complete Submodule Setup Example
+**Solution:**
+Delete the `.git/modules` directory before running `submodule-install`.
+
+**Complete Reset & Install:**
 ```bash
 echo "Initializing submodules..."
 git submodule init
@@ -290,25 +177,26 @@ npx --yes rimraf .git/modules
 npx --yes binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz submodule-install
 ```
 
-## Binary List Generation & Source Code (Development)
+## Development
+
+### Test Local Command Executor
+
+When developing locally, to test the bundled executor run `bc <commandName>` (use `bin/bc` on Unix or `bin/bc.cmd` on Windows). Its usage is the same as `binary-collections <commandName>` but intended only for development and testing.
 
-The list of available binaries and utilities is auto-generated by the build script ([`build.mjs`](./build.mjs)).
-- All CLI tools and binaries are collected from the `bin/`, `lib/`, and other relevant folders.
-- The build process updates the `bin` field in `package.json` to reflect all available executables.
-- Source code for utilities is located in the `src/` folder.
+### Command List Generation
+The list of available binaries is auto-generated by [`build.mjs`](./build.mjs). This script scans `bin/`, `lib/`, and updates the `bin` field in `package.json`.
 
-To update the binary list, run:
+To update the binary list:
 ```bash
 yarn run build
 # or
 node build.mjs
 ```
-This scans the project and updates `package.json` with all available binaries. The list may change as files are added or removed.
 
-See also:
-- [Binary executables](https://github.com/dimaslanjaka/bin/tree/master/bin)
-- [Library modules](https://github.com/dimaslanjaka/bin/tree/master/lib)
-- [Package configuration](https://github.com/dimaslanjaka/bin/blob/master/package.json)
+### Project Structure
+- **Source Code**: Located in the `src/` folder.
+- **Binaries**: Executable scripts located in `bin/`.
+- **Libraries**: Reusable modules in `lib/`.
 
 ## Contributing
 
@@ -316,4 +204,4 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## License
 
-This project is licensed under the terms specified in the LICENSE file.
+This project is licensed under the terms specified in the [LICENSE](./LICENSE) file.

package/releases/readme.md

@@ -2,7 +2,7 @@
 ## Releases
 | version | tarball url |
 | :--- | :--- |
-| latest | https://github.com/dimaslanjaka/bin/raw/6b683c8/releases/bin.tgz |
+| latest | https://github.com/dimaslanjaka/bin/raw/f9d6d4b/releases/bin.tgz |
 | latest | https://github.com/dimaslanjaka/bin/raw/master/releases/bin.tgz |
 
 use this tarball with `resolutions`:
@@ -16,7 +16,9 @@ use this tarball with `resolutions`:
 
 ## Releases
 
-    ## Get URL of `binary-collections` Release Tarball
+    
+
+## Get URL of `binary-collections` Release Tarball
 - select tarball file
 ![gambar](https://user-images.githubusercontent.com/12471057/203216375-8af4b5d9-00c2-40fb-8d3d-d220beaabd46.png)
 - copy raw url
@@ -24,6 +26,7 @@ use this tarball with `resolutions`:
 - or copy download url
 ![gambar](https://user-images.githubusercontent.com/12471057/203216541-3807d2c3-5213-49f3-b93d-c626dbae3b2e.png)
 - then run installation from command line
+
 ```bash
 npm i https://....url-tgz
 ```
@@ -33,4 +36,4 @@ npm i https://github.com/dimaslanjaka/nodejs-package-types/raw/main/release/node
 ```
 
 ## URL Parts Explanations
-> https://github.com/github-username/github-repo-name/raw/github-branch-name/path-to-file-with-extension
+> https://github.com/github-username/github-repo-name/raw/github-branch-name/path-to-file-with-extension

package/test/README.md

@@ -66,10 +66,10 @@ yarn test git-user-config.test.js
 yarn test git-fix-integration.test.js
 
 # Run with coverage
-yarn test:coverage
+yarn test-coverage
 
 # Run in watch mode
-yarn test:watch
+yarn test-watch
 ```
 
 ## Test Coverage

package/test-project/workspaces/workspace-a/readme.md

@@ -0,0 +1,20 @@
+# Determine hexo instance
+
+> Where is you now ? page ? archive ? whatever
+
+this plugin can be used to determine where you are from plugin hexo
+
+# Usage
+
+- full test: https://github.com/dimaslanjaka/hexo-is/tree/master/test
+
+```js
+const { hexoIs } = require('hexo-is');
+function where(content, data){
+  console.log(hexoIs(data));
+}
+hexo.extend.filter.register("after_render:js", where);
+hexo.extend.filter.register("after_render:css", where);
+hexo.extend.filter.register("after_render:html", where);
+where.call(hexo, {/* any mock object data */});
+```

package/test-project/workspaces/workspace-a/release/readme.md

@@ -0,0 +1,42 @@
+# Release `hexo-is` tarball
+## Releases
+| version | tarball url |
+| :--- | :--- |
+| 1.0.4 | https://github.com/dimaslanjaka/hexo-is/raw/6c39e7d/release/hexo-is-1.0.4.tgz |
+| 1.0.5 | https://github.com/dimaslanjaka/hexo-is/raw/be69f8d/release/hexo-is-1.0.5.tgz |
+| 2.0.0 | https://github.com/dimaslanjaka/hexo-is/raw/d7dfef5/release/hexo-is-2.0.0.tgz |
+| 2.0.1 | https://github.com/dimaslanjaka/hexo-is/raw/8c5c917/release/hexo-is-2.0.1.tgz |
+| 2.0.2 | https://github.com/dimaslanjaka/hexo-is/raw/47d81d2/release/hexo-is-2.0.2.tgz |
+| 2.0.3 | https://github.com/dimaslanjaka/hexo-is/raw/47d81d2/release/hexo-is-2.0.3.tgz |
+| latest | https://github.com/dimaslanjaka/hexo-is/raw/47d81d2/release/hexo-is.tgz |
+| latest | https://github.com/dimaslanjaka/hexo-is/raw/master/release/hexo-is.tgz |
+
+use this tarball with `resolutions`:
+```json
+{
+  "resolutions": {
+    "hexo-is": "<url of tarball>"
+  }
+}
+```
+
+## Releases
+
+    ## Get URL of `hexo-is` Release Tarball
+- select tarball file
+![gambar](https://user-images.githubusercontent.com/12471057/203216375-8af4b5d9-00c2-40fb-8d3d-d220beaabd46.png)
+- copy raw url
+![gambar](https://user-images.githubusercontent.com/12471057/203216508-7590cbb9-a1ce-47d6-96ca-8d82149f0762.png)
+- or copy download url
+![gambar](https://user-images.githubusercontent.com/12471057/203216541-3807d2c3-5213-49f3-b93d-c626dbae3b2e.png)
+- then run installation from command line
+```bash
+npm i https://....url-tgz
+```
+for example
+```bash
+npm i https://github.com/dimaslanjaka/nodejs-package-types/raw/main/release/nodejs-package-types.tgz
+```
+
+## URL Parts Explanations
+> https://github.com/github-username/github-repo-name/raw/github-branch-name/path-to-file-with-extension

package/test-project/workspaces/workspace-a/test/readme.md

@@ -0,0 +1,12 @@
+# test
+
+site test
+```bash
+git clone https://github.com/dimaslanjaka/site.git demo
+cd demo && npm install
+```
+
+theme test
+```bash
+git clone https://github.com/hexojs/hexo-theme-unit-test
+```

package/test-project/workspaces/workspace-b/readme.md

@@ -0,0 +1,94 @@
+# hexo-themes
+My HexoJS Theme Collections
+
+| package | description
+| :--- | :--- |
+| [hexo-theme-flowbite](./themes/hexo-theme-flowbite/) | Hexo theme build using **tailwind** and **flowbite** |
+
+### How to install this repo locally
+
+```bash
+touch yarn.lock
+yarn install
+yarn serve
+```
+
+### How to install Theme
+
+- download `tgz` file from [Relase Folder](./releases/)
+- extract `<tgz>/package/<all files here>` file to `<hexo project>/themes/hexo-theme-name/<here>`
+- install dependencies eg: `npm install hexo-theme-flowbite` or `yarn add hexo-theme-flowbite` (change theme name)
+
+> for enable dynamic build on-fly like **hexo-theme-flowbite** add as **dev dependencies** (`yarn add -D hexo-theme-flowbite`)
+
+#### How to update markdown-it to latest for Hexo
+
+- install customized `markdown-it` [see why](https://github.com/dimaslanjaka/hexo-renderers/tree/esm#requirements)
+
+```bash
+yarn add markdown-it@https://github.com/dimaslanjaka/markdown-it/raw/2000d25dec653f6e62a545b30f6d58fad20e6d1f/release/markdown-it.tgz
+```
+
+> OR just using `hexo-renderers` to using built-in `markdown-it`
+
+#### How to enable auto SEO
+
+- install `hexo-seo`
+
+```bash
+yarn add hexo-seo
+```
+
+[Read how to configure hexo-seo](https://github.com/dimaslanjaka/hexo-seo#readme)
+
+#### How to update
+
+To update theme, just call `npx hexo-theme-name` on cwd hexo project. Sample:
+
+![image](https://github.com/user-attachments/assets/b62da4d0-8db1-4dc8-ae3d-b0b5e2640ad1)
+
+### Features
+
+> [more detailed config here](./themes/hexo-theme-flowbite/_config.yml)
+
+#### Search data
+
+All post metadata on `{{ config.root }}/hexo-search.json` with contents
+
+```jsonc
+[
+  {
+    "url": "url relative post",
+    "title": "post title",
+    "description": "post excerpt or description"
+  }
+]
+```
+
+### Contribute
+
+Step to contribute
+
+#### Setup
+
+```bash
+git submodule update -i -r
+touch yarn.lock
+yarn install
+yarn build
+```
+
+#### Live testing
+
+```bash
+yarn run start
+```
+
+Test responsive screenshoot at https://ui.dev/amiresponsive
+
+#### Bundle
+
+```bash
+yarn run build
+yarn run pack
+```

package/test-project/workspaces/workspace-b/requirements.txt

@@ -0,0 +1 @@
+djlint