feat: create new handbook command + test setup for scripts

Author: th0rOdinson

.github/workflows/test-scripts.yml

@@ -0,0 +1,28 @@
+name: Test Scripts
+
+on:
+  push:
+    branches:
+      - '**'
+
+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
+          cache: 'pnpm'
+
+      - name: Install pnpm
+        run: npm install -g pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Run tests
+        run: cd scripts && 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

@@ -10,8 +10,7 @@
   ],
   "exports": {
     "./styles/global.css": "./static/common/styles/global.css",
-    "./preset": "./dist/preset/index.js",
-    "./copy-static": "./dist/scripts/copyStaticTo.js"
+    "./preset": "./dist/preset/index.js"
   },
   "scripts": {
     "build": "tsc"