create-hedhop 1.0.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,52 @@
+# create-hedhop
+
+A modern CLI tool for scaffolding [Hedhop](https://www.npmjs.com/package/hedhop) projects quickly.
+
+## Usage
+
+The fastest way to start is by running:
+
+```bash
+npm create hedhop@latest
+```
+
+Follow the interactive prompts to configure your new project.
+
+### Arguments
+
+You can pass the project name directly:
+
+```bash
+npm create hedhop@latest my-project
+```
+
+Available options:
+- `--no-install`: Skip automatic dependency installation.
+
+## Local Development
+
+If you want to contribute or test changes locally on the CLI:
+
+1. Clone the repository.
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Build the project in watch mode:
+   ```bash
+   npm run dev
+   ```
+4. Test the CLI in another directory pointing to the built binary:
+   ```bash
+   node path/to/create-hedhop/dist/index.js test-project-name
+   ```
+
+## Project Structure
+
+- `src/`: CLI source code.
+- `templates/`: Templates that will be copied when generating a new project.
+  - `default/`: Default template with basic Vite and React configuration.
+
+## License
+
+MIT © [qgave]

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import o from"fs-extra";import t from"path";import{spawn as j}from"child_process";import w from"prompts";import{fileURLToPath as S}from"url";import{red as r,green as s,bold as v}from"kolorist";async function N(){let l="hedhop-project",c=process.argv.slice(2).find(f=>!f.startsWith("-")),a=process.argv.includes("--no-install"),p=await w([{type:c?null:"text",name:"projectName",message:"Project name:",initial:l},{type:a?null:"toggle",name:"install",message:"Install dependencies?",initial:!0,active:"yes",inactive:"no"}],{onCancel:()=>{throw new Error(r("\u2716")+" Operation cancelled")}}),n=c||p.projectName,u=a?!1:p.install,e=t.join(process.cwd(),n);o.existsSync(e)&&(console.error(r(`
+Error: Target directory "${n}" already exists.`)),process.exit(1)),console.log(`
+Scaffolding project in ${v(e)}...`);let y=t.dirname(S(import.meta.url)),i=t.resolve(y,"../templates/default");o.existsSync(i)||(console.error(r(`
+Error: Template directory not found at ${i}`)),process.exit(1)),o.copySync(i,e);let d=t.join(e,"package.json"),m=JSON.parse(o.readFileSync(d,"utf-8"));m.name=n,o.writeFileSync(d,JSON.stringify(m,null,2));let g=t.join(e,"_gitignore");o.existsSync(g)&&o.moveSync(g,t.join(e,".gitignore")),console.log(s(`
+Done. Now run:
+`)),console.log(`  cd ${n}`),u?(console.log(s(`
+Installing dependencies...`)),j("npm",["install"],{cwd:e,stdio:"inherit",shell:!0}).on("close",h=>{if(h!==0){console.error(r(`
+Failed to install dependencies.`));return}console.log(s(`
+Done. Now run:
+`)),console.log(`  cd ${n}`),console.log("  npm run dev")})):(console.log(s(`
+Done. Now run:
+`)),console.log(`  cd ${n}`),console.log("  npm install"),console.log("  npm run dev"))}N().catch(l=>{console.error(l)});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\r\n\r\nimport fs from 'fs-extra';\r\nimport path from 'path';\r\nimport { spawn } from 'child_process';\r\nimport prompts from 'prompts';\r\nimport { fileURLToPath } from 'url';\r\nimport { red, green, bold } from 'kolorist';\r\n\r\nasync function init() {\r\n    const defaultTargetDir = 'hedhop-project';\r\n    const targetDir = process.argv.slice(2).find(arg => !arg.startsWith('-'));\r\n    const skipInstall = process.argv.includes('--no-install');\r\n\r\n    const result = await prompts([\r\n        {\r\n            type: targetDir ? null : 'text',\r\n            name: 'projectName',\r\n            message: 'Project name:',\r\n            initial: defaultTargetDir,\r\n        },\r\n        {\r\n            type: skipInstall ? null : 'toggle',\r\n            name: 'install',\r\n            message: 'Install dependencies?',\r\n            initial: true,\r\n            active: 'yes',\r\n            inactive: 'no',\r\n        },\r\n    ], {\r\n        onCancel: () => {\r\n            throw new Error(red('✖') + ' Operation cancelled');\r\n        },\r\n    });\r\n\r\n    const projectName = targetDir || result.projectName;\r\n\r\n    const install = skipInstall ? false : result.install;\r\n    const root = path.join(process.cwd(), projectName);\r\n\r\n    if (fs.existsSync(root)) {\r\n        console.error(red(`\\nError: Target directory \"${projectName}\" already exists.`));\r\n        process.exit(1);\r\n    }\r\n\r\n    console.log(`\\nScaffolding project in ${bold(root)}...`);\r\n\r\n\r\n    const __dirname = path.dirname(fileURLToPath(import.meta.url));\r\n    // templates are copied to dist/templates during build or we assume structure relative to this file\r\n    // In dev/src structure it's ../templates\r\n    // In dist it's ../templates\r\n    const templateDir = path.resolve(__dirname, '../templates/default');\r\n\r\n    if (!fs.existsSync(templateDir)) {\r\n        console.error(red(`\\nError: Template directory not found at ${templateDir}`));\r\n        process.exit(1);\r\n    }\r\n\r\n\r\n    fs.copySync(templateDir, root);\r\n\r\n\r\n    const pkgPath = path.join(root, 'package.json');\r\n    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\r\n    pkg.name = projectName;\r\n    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));\r\n\r\n    // Rename _gitignore to .gitignore (npm publish renames .gitignore to .npmignore otherwise)\r\n    const gitignorePath = path.join(root, '_gitignore');\r\n    if (fs.existsSync(gitignorePath)) {\r\n        fs.moveSync(gitignorePath, path.join(root, '.gitignore'));\r\n    }\r\n\r\n    console.log(green(`\\nDone. Now run:\\n`));\r\n    console.log(`  cd ${projectName}`);\r\n    if (install) {\r\n        console.log(green(`\\nInstalling dependencies...`));\r\n        const child = spawn('npm', ['install'], {\r\n            cwd: root,\r\n            stdio: 'inherit',\r\n            shell: true\r\n        });\r\n\r\n        child.on('close', (code) => {\r\n            if (code !== 0) {\r\n                console.error(red(`\\nFailed to install dependencies.`));\r\n                return;\r\n            }\r\n            console.log(green(`\\nDone. Now run:\\n`));\r\n            console.log(`  cd ${projectName}`);\r\n            console.log(`  npm run dev`);\r\n        });\r\n    } else {\r\n        console.log(green(`\\nDone. Now run:\\n`));\r\n        console.log(`  cd ${projectName}`);\r\n        console.log(`  npm install`);\r\n        console.log(`  npm run dev`);\r\n    }\r\n}\r\n\r\ninit().catch((e) => {\r\n    console.error(e);\r\n});\r\n"],"mappings":";AAEA,OAAOA,MAAQ,WACf,OAAOC,MAAU,OACjB,OAAS,SAAAC,MAAa,gBACtB,OAAOC,MAAa,UACpB,OAAS,iBAAAC,MAAqB,MAC9B,OAAS,OAAAC,EAAK,SAAAC,EAAO,QAAAC,MAAY,WAEjC,eAAeC,GAAO,CAClB,IAAMC,EAAmB,iBACnBC,EAAY,QAAQ,KAAK,MAAM,CAAC,EAAE,KAAKC,GAAO,CAACA,EAAI,WAAW,GAAG,CAAC,EAClEC,EAAc,QAAQ,KAAK,SAAS,cAAc,EAElDC,EAAS,MAAMV,EAAQ,CACzB,CACI,KAAMO,EAAY,KAAO,OACzB,KAAM,cACN,QAAS,gBACT,QAASD,CACb,EACA,CACI,KAAMG,EAAc,KAAO,SAC3B,KAAM,UACN,QAAS,wBACT,QAAS,GACT,OAAQ,MACR,SAAU,IACd,CACJ,EAAG,CACC,SAAU,IAAM,CACZ,MAAM,IAAI,MAAMP,EAAI,QAAG,EAAI,sBAAsB,CACrD,CACJ,CAAC,EAEKS,EAAcJ,GAAaG,EAAO,YAElCE,EAAUH,EAAc,GAAQC,EAAO,QACvCG,EAAOf,EAAK,KAAK,QAAQ,IAAI,EAAGa,CAAW,EAE7Cd,EAAG,WAAWgB,CAAI,IAClB,QAAQ,MAAMX,EAAI;AAAA,2BAA8BS,CAAW,mBAAmB,CAAC,EAC/E,QAAQ,KAAK,CAAC,GAGlB,QAAQ,IAAI;AAAA,yBAA4BP,EAAKS,CAAI,CAAC,KAAK,EAGvD,IAAMC,EAAYhB,EAAK,QAAQG,EAAc,YAAY,GAAG,CAAC,EAIvDc,EAAcjB,EAAK,QAAQgB,EAAW,sBAAsB,EAE7DjB,EAAG,WAAWkB,CAAW,IAC1B,QAAQ,MAAMb,EAAI;AAAA,yCAA4Ca,CAAW,EAAE,CAAC,EAC5E,QAAQ,KAAK,CAAC,GAIlBlB,EAAG,SAASkB,EAAaF,CAAI,EAG7B,IAAMG,EAAUlB,EAAK,KAAKe,EAAM,cAAc,EACxCI,EAAM,KAAK,MAAMpB,EAAG,aAAamB,EAAS,OAAO,CAAC,EACxDC,EAAI,KAAON,EACXd,EAAG,cAAcmB,EAAS,KAAK,UAAUC,EAAK,KAAM,CAAC,CAAC,EAGtD,IAAMC,EAAgBpB,EAAK,KAAKe,EAAM,YAAY,EAC9ChB,EAAG,WAAWqB,CAAa,GAC3BrB,EAAG,SAASqB,EAAepB,EAAK,KAAKe,EAAM,YAAY,CAAC,EAG5D,QAAQ,IAAIV,EAAM;AAAA;AAAA,CAAoB,CAAC,EACvC,QAAQ,IAAI,QAAQQ,CAAW,EAAE,EAC7BC,GACA,QAAQ,IAAIT,EAAM;AAAA,2BAA8B,CAAC,EACnCJ,EAAM,MAAO,CAAC,SAAS,EAAG,CACpC,IAAKc,EACL,MAAO,UACP,MAAO,EACX,CAAC,EAEK,GAAG,QAAUM,GAAS,CACxB,GAAIA,IAAS,EAAG,CACZ,QAAQ,MAAMjB,EAAI;AAAA,gCAAmC,CAAC,EACtD,MACJ,CACA,QAAQ,IAAIC,EAAM;AAAA;AAAA,CAAoB,CAAC,EACvC,QAAQ,IAAI,QAAQQ,CAAW,EAAE,EACjC,QAAQ,IAAI,eAAe,CAC/B,CAAC,IAED,QAAQ,IAAIR,EAAM;AAAA;AAAA,CAAoB,CAAC,EACvC,QAAQ,IAAI,QAAQQ,CAAW,EAAE,EACjC,QAAQ,IAAI,eAAe,EAC3B,QAAQ,IAAI,eAAe,EAEnC,CAEAN,EAAK,EAAE,MAAOe,GAAM,CAChB,QAAQ,MAAMA,CAAC,CACnB,CAAC","names":["fs","path","spawn","prompts","fileURLToPath","red","green","bold","init","defaultTargetDir","targetDir","arg","skipInstall","result","projectName","install","root","__dirname","templateDir","pkgPath","pkg","gitignorePath","code","e"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "create-hedhop",
+    "version": "1.0.0",
+    "description": "Scaffolding tool for Hedhop projects",
+    "author": "qgave",
+    "license": "MIT",
+    "keywords": [
+        "hedhop",
+        "cli",
+        "scaffold",
+        "create",
+        "vite",
+        "react"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/qgave/create-hedhop"
+    },
+    "type": "module",
+    "bin": {
+        "create-hedhop": "dist/index.js"
+    },
+    "files": [
+        "dist",
+        "templates"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "start": "node dist/index.js"
+    },
+    "dependencies": {
+        "prompts": "^2.4.2",
+        "kolorist": "^1.8.0",
+        "fs-extra": "^11.2.0"
+    },
+    "devDependencies": {
+        "tsup": "^8.0.0",
+        "typescript": "^5.0.0",
+        "@types/node": "^20.0.0",
+        "@types/prompts": "^2.4.0",
+        "@types/fs-extra": "^11.0.0"
+    }
+}

package/templates/default/_gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+.env

package/templates/default/hedhop.config.ts

@@ -0,0 +1,11 @@
+import type { HedhopConfig } from 'hedhop';
+
+const config: HedhopConfig = {
+    debug: false,
+    hmr: true,
+    routing: {
+        trailingSlash: false,
+    },
+};
+
+export default config;

package/templates/default/package.json

@@ -0,0 +1,23 @@
+{
+    "name": "hedhop-app",
+    "version": "0.0.0",
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "hedhop build",
+        "start": "hedhop start"
+    },
+    "dependencies": {
+        "react": "^19.0.0",
+        "react-dom": "^19.0.0",
+        "hedhop": "^1.0.0"
+    },
+    "devDependencies": {
+        "vite": "^6.0.0",
+        "@vitejs/plugin-react-swc": "^3.5.0",
+        "@types/react": "^19.0.0",
+        "@types/react-dom": "^19.0.0",
+        "typescript": "^5.0.0"
+    }
+}

package/templates/default/src/app.tsx

@@ -0,0 +1,26 @@
+import { type ReactNode } from 'react';
+import { Head, type RouterConfig } from 'hedhop';
+import './index.css';
+
+const routes = [
+    { path: '/', page: '@/pages/home' }
+];
+
+export const router: RouterConfig = {
+    routes,
+    debug: true,
+};
+
+export const RootLayout = ({ children }: { children: ReactNode }) => {
+    return (
+        <html lang="en">
+            <head>
+                <Head />
+                <title>Hedhop App</title>
+            </head>
+            <body>
+                <div id="app-root">{children}</div>
+            </body>
+        </html>
+    );
+};

package/templates/default/src/index.css

@@ -0,0 +1,6 @@
+body {
+    font-family: system-ui, -apple-system, sans-serif;
+    margin: 0;
+    padding: 0;
+    line-height: 1.5;
+}

package/templates/default/src/pages/home.tsx

@@ -0,0 +1,17 @@
+import type { PageConfig } from 'hedhop';
+
+export default function HomePage() {
+    return (
+        <div style={{ padding: '2rem', maxWidth: '800px', margin: '0 auto' }}>
+            <h1>Welcome to Hedhop</h1>
+            <p>This is a starter template with React Server Components.</p>
+        </div>
+    );
+}
+
+export const config: PageConfig = {
+    meta: {
+        title: 'Home - Hedhop App',
+        description: 'Generated by create-hedhop'
+    }
+};

package/templates/default/tsconfig.json

@@ -0,0 +1,34 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "useDefineForClassFields": true,
+        "lib": [
+            "ES2020",
+            "DOM",
+            "DOM.Iterable"
+        ],
+        "module": "ESNext",
+        "skipLibCheck": true,
+        "moduleResolution": "bundler",
+        "allowImportingTsExtensions": true,
+        "resolveJsonModule": true,
+        "isolatedModules": true,
+        "noEmit": true,
+        "jsx": "react-jsx",
+        "strict": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true,
+        "baseUrl": ".",
+        "paths": {
+            "@/*": [
+                "./src/*"
+            ]
+        }
+    },
+    "include": [
+        "src",
+        "vite.config.ts",
+        "hedhop.config.ts"
+    ]
+}

package/templates/default/vite.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite';
+import { hedhop } from 'hedhop/vite';
+import path from 'path';
+
+export default defineConfig({
+    plugins: [hedhop()],
+    resolve: {
+        alias: {
+            '@': path.resolve(__dirname, 'src'),
+        }
+    }
+});