feat: create new handbook command + test setup for scripts (#46)

Implemented a new repository for handling scripts. In this new repo, a
script for creating a new handbook was also added!
Issue CHA-330
https://linear.app/defi-wonderland/issue/CHA-330/template-for-new-handbooks

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Added scripts to automate creating new handbook sites and copying
shared static assets.
* Introduced a dedicated scripts workspace with supporting configuration
and documentation.
  * Added automated tests and test setup utilities for scripts.
* Integrated a GitHub Actions workflow to run script tests on pull
requests.

* **Bug Fixes**
* Improved handling and validation of site creation and static asset
copying.

* **Documentation**
* Updated and expanded documentation for handbook site creation and
script usage.

* **Chores**
* Updated package and workspace configurations to reflect new package
naming and structure.
* Enhanced .gitignore files to exclude temporary test files and
directories.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: th0rOdinson

.github/workflows/test-scripts.yml

@@ -0,0 +1,33 @@
+name: Test Scripts
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    branches:
+      - dev
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 9
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        working-directory: scripts
+        run: pnpm test 

.gitignore

@@ -11,6 +11,9 @@
 .docusaurus
 .cache-loader
 
+# Test temporary files
+.tmp/
+
 # Misc
 .DS_Store
 .env

README.md

@@ -50,7 +50,30 @@ The static site will be generated in the `sites/[name]/build` directory.
 
 ## 🛠️ Creating a New Site
 
-TBD (CHA-330)
+To create a new handbook site from the template:
+
+```bash
+pnpm create-handbook <site-name>
+```
+
+This will:
+1. Create a new site in `sites/<site-name>` based on the template
+2. Update the package.json with the correct site name
+3. Set up all necessary configurations
+
+**Example:**
+```bash
+pnpm create-handbook my-new-handbook
+```
+
+After creation, you can build and start the new site:
+```bash
+cd sites/my-new-handbook
+pnpm build:assets
+pnpm start
+```
+
+**Note:** Site names can only contain letters, numbers, hyphens, and underscores.
 
 ## Contributing
 

package.json

@@ -3,13 +3,18 @@
   "private": true,
   "workspaces": [
     "packages/*",
-    "sites/*"
+    "sites/*",
+    "scripts"
   ],
+  "scripts": {
+    "create-handbook": "ts-node scripts/src/create-handbook.ts"
+  },
   "devDependencies": {
     "turbo": "1.11.0",
     "typescript": "5.6.2",
     "eslint": "9.28.0",
-    "prettier": "3.2.5"
+    "prettier": "3.2.5",
+    "ts-node": "10.9.2"
   },
   "engines": {
     "node": ">=18.0"

packages/common-config/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@common-config",
+  "name": "@handbook/common-config",
   "version": "1.0.0",
   "private": true,
   "main": "src/index.ts",
@@ -11,7 +11,10 @@
   "exports": {
     "./styles/global.css": "./static/common/styles/global.css",
     "./preset": "./dist/preset/index.js",
-    "./copy-static": "./dist/scripts/copyStaticTo.js"
+    "./preset/commonDocusaurusConfig": {
+      "types": "./preset/commonDocusaurusConfig.ts",
+      "default": "./dist/preset/commonDocusaurusConfig.js"
+    }
   },
   "scripts": {
     "build": "tsc"